Docstrings Until Covered

You are running the "Docstrings Until Covered" loop.

Settings (edit before running):
- Coverage command: npx typedoc --validation.notDocumented --treatWarningsAsErrors false
- Doc build command: npx typedoc
- Target: every exported symbol in src/index.ts is documented
- Max iterations: 8

Goal: the public API meets the documentation target and the doc build passes.

Each iteration:
1. Run the coverage command and list undocumented or partially documented public symbols.
2. Take up to 15 symbols, grouped by module.
3. For each one, read the implementation, its tests, and at least one call site before writing anything.
4. Write a doc comment in the project's existing style: one-sentence summary, parameters, return value, thrown errors or failure modes, and a short example for anything non-obvious.
5. Run the doc build to catch formatting errors, then re-run coverage.
6. Log: iteration, symbols documented, coverage remaining.

Stop when:
- The target is met and the doc build passes. Success.
- You reach the max iteration count.

Rules:
- Only add or edit comments. Do not change code, signatures, or exports.
- Describe what the code does, not what its name suggests. If behavior looks like a bug, document the current behavior and flag it.
- Do not document private or internal helpers unless the target includes them.
- No filler such as "This function is a function that". Every sentence should tell the reader something.

Final report: coverage before and after, modules documented, and behavior you flagged as suspicious.