----------------------------------------------------------------------
This is the API documentation for the gdtest_code_cells library.
----------------------------------------------------------------------


## Functions

Utility functions


add(a: int, b: int) -> int

Add two numbers.

This function uses an executable code cell that should be
run by Quarto during the build.

Parameters
----------
a
    First number.
b
    Second number.

Returns
-------
int
    The sum of a and b.

Examples
--------
```{python}
from gdtest_code_cells import add

add(2, 3)
```

fibonacci(n: int) -> list[int]

Generate the first n Fibonacci numbers.

This function demonstrates multiple code blocks: one
executable and one with ``#| eval: false``.

Parameters
----------
n
    How many Fibonacci numbers to generate.

Returns
-------
list[int]
    The first n Fibonacci numbers.

Examples
--------
An executed cell showing output:

```{python}
from gdtest_code_cells import fibonacci

fibonacci(8)
```

A non-executed cell with multiple hash-pipe options:

```{python}
#| eval: false
#| echo: true
# Generate a large sequence
big = fibonacci(100)
print(f"The 100th Fibonacci number is {big[-1]}")
```

greet(name: str) -> str

Greet someone by name.

This function uses a static code block (no curly braces)
that should NOT be executed by Quarto.

Parameters
----------
name
    The name of the person to greet.

Returns
-------
str
    A greeting string.

Examples
--------
```python
from gdtest_code_cells import greet

greet("World")
```

multiply(a: int, b: int) -> int

Multiply two numbers.

This function uses an executable code cell with
``#| eval: false`` so the code is displayed but not run.

Parameters
----------
a
    First number.
b
    Second number.

Returns
-------
int
    The product of a and b.

Examples
--------
```{python}
#| eval: false
from gdtest_code_cells import multiply

result = multiply(4, 5)
print(f"4 x 5 = {result}")
```