docs: add TypeDoc API generation (typedoc@0.28.19 + typedoc-plugin-markdown@4.11.0)

Add typedoc and typedoc-plugin-markdown as devDependencies. Add typedoc.json config targeting src/index.ts with markdown output to .github/wiki/api. Add docs script to package.json. Generate initial API reference pages. Part of T-E8-03 — TypeDoc automation for all 12 JS/TS packages.
2026-06-30 19:04:24 +00:00 · 2026-05-30 16:41:59 -04:00 · 2026-05-30 16:41:59 -04:00 · 2992dcee21
commit 2992dcee21
parent 89fb490051
42 changed files with 2603 additions and 5 deletions
--- a/.github/wiki/api/README.md
+++ b/.github/wiki/api/README.md
@ -0,0 +1,55 @@
+**moon-sighting v1.1.1**
+
+***
+
+# moon-sighting v1.1.1
+
+## Interfaces
+
+- [AzAlt](interfaces/AzAlt.md)
+- [ChebRecord](interfaces/ChebRecord.md)
+- [CrescentGeometry](interfaces/CrescentGeometry.md)
+- [KernelConfig](interfaces/KernelConfig.md)
+- [MoonIlluminationResult](interfaces/MoonIlluminationResult.md)
+- [MoonPhaseResult](interfaces/MoonPhaseResult.md)
+- [MoonPosition](interfaces/MoonPosition.md)
+- [MoonSightingReport](interfaces/MoonSightingReport.md)
+- [MoonSnapshot](interfaces/MoonSnapshot.md)
+- [MoonVisibilityEstimate](interfaces/MoonVisibilityEstimate.md)
+- [Observer](interfaces/Observer.md)
+- [OdehResult](interfaces/OdehResult.md)
+- [SightingOptions](interfaces/SightingOptions.md)
+- [SpkSegment](interfaces/SpkSegment.md)
+- [StateVector](interfaces/StateVector.md)
+- [SunMoonEvents](interfaces/SunMoonEvents.md)
+- [TimeScales](interfaces/TimeScales.md)
+- [YallopResult](interfaces/YallopResult.md)
+
+## Type Aliases
+
+- [KernelSource](type-aliases/KernelSource.md)
+- [MoonPhaseName](type-aliases/MoonPhaseName.md)
+- [OdehZone](type-aliases/OdehZone.md)
+- [Vec3](type-aliases/Vec3.md)
+- [YallopCategory](type-aliases/YallopCategory.md)
+
+## Variables
+
+- [ODEH\_DESCRIPTIONS](variables/ODEH_DESCRIPTIONS.md)
+- [ODEH\_THRESHOLDS](variables/ODEH_THRESHOLDS.md)
+- [WGS84](variables/WGS84.md)
+- [YALLOP\_DESCRIPTIONS](variables/YALLOP_DESCRIPTIONS.md)
+- [YALLOP\_THRESHOLDS](variables/YALLOP_THRESHOLDS.md)
+
+## Functions
+
+- [downloadKernels](functions/downloadKernels.md)
+- [getMoon](functions/getMoon.md)
+- [getMoonIllumination](functions/getMoonIllumination.md)
+- [getMoonPhase](functions/getMoonPhase.md)
+- [getMoonPosition](functions/getMoonPosition.md)
+- [getMoonSightingReport](functions/getMoonSightingReport.md)
+- [getMoonVisibilityEstimate](functions/getMoonVisibilityEstimate.md)
+- [getSunMoonEvents](functions/getSunMoonEvents.md)
+- [initKernels](functions/initKernels.md)
+- [verifyKernels](functions/verifyKernels.md)
--- a/.github/wiki/api/functions/downloadKernels.md
+++ b/.github/wiki/api/functions/downloadKernels.md
@ -0,0 +1,29 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / downloadKernels
+
+# Function: downloadKernels()
+
+> **downloadKernels**(`config?`): `Promise`\<\{ `leapSecondsPath`: `string`; `planetaryPath`: `string`; \}\>
+
+Defined in: [api/index.ts:159](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L159)
+
+Download the DE442S planetary kernel and naif0012.tls leap-second kernel
+to the local cache directory. Verifies the download by SHA-256 checksum
+when a checksum is supplied via config.checksumOverride.
+
+## Parameters
+
+### config?
+
+[`KernelConfig`](../interfaces/KernelConfig.md)
+
+Optional kernel config (to customize cache directory or checksum)
+
+## Returns
+
+`Promise`\<\{ `leapSecondsPath`: `string`; `planetaryPath`: `string`; \}\>
+
+Paths where kernels were saved
--- a/.github/wiki/api/functions/getMoon.md
+++ b/.github/wiki/api/functions/getMoon.md
@ -0,0 +1,61 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / getMoon
+
+# Function: getMoon()
+
+> **getMoon**(`date?`, `lat`, `lon`, `elevation?`): [`MoonSnapshot`](../interfaces/MoonSnapshot.md)
+
+Defined in: [api/index.ts:727](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L727)
+
+Combined kernel-free moon snapshot for a time and location.
+
+Calls getMoonPhase(), getMoonPosition(), getMoonIllumination(), and
+getMoonVisibilityEstimate() in a single request. Convenient for dashboards
+and apps that need all four values together.
+
+Works WITHOUT a kernel (all Meeus-based approximations).
+
+## Parameters
+
+### date?
+
+`Date` = `...`
+
+Date and time (default: now)
+
+### lat
+
+`number`
+
+Observer geodetic latitude in degrees (north positive)
+
+### lon
+
+`number`
+
+Observer longitude in degrees (east positive)
+
+### elevation?
+
+`number` = `0`
+
+Observer height above WGS84 ellipsoid in meters (default: 0)
+
+## Returns
+
+[`MoonSnapshot`](../interfaces/MoonSnapshot.md)
+
+MoonSnapshot with phase, position, illumination, and visibility estimate
+
+## Example
+
+```ts
+const moon = getMoon(new Date(), 51.5, -0.1)
+console.log(moon.phase.phaseName)          // 'Waxing Crescent'
+console.log(moon.position.altitude)        // degrees above horizon
+console.log(moon.illumination.fraction)    // 0.0 to 1.0
+console.log(moon.visibility.zone)          // 'A' through 'D'
+```
--- a/.github/wiki/api/functions/getMoonIllumination.md
+++ b/.github/wiki/api/functions/getMoonIllumination.md
@ -0,0 +1,39 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / getMoonIllumination
+
+# Function: getMoonIllumination()
+
+> **getMoonIllumination**(`date?`): [`MoonIlluminationResult`](../interfaces/MoonIlluminationResult.md)
+
+Defined in: [api/index.ts:592](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L592)
+
+Compute the Moon's illumination fraction, phase cycle position, and bright limb angle.
+
+Works WITHOUT a kernel (uses Meeus Ch. 47/48 approximation).
+Accuracy: illumination fraction ~0.5%, phase fraction ~0.003.
+Drop-in replacement for suncalc.getMoonIllumination() — same field names and conventions.
+
+## Parameters
+
+### date?
+
+`Date` = `...`
+
+Date to compute illumination for (default: now)
+
+## Returns
+
+[`MoonIlluminationResult`](../interfaces/MoonIlluminationResult.md)
+
+fraction (0-1), phase (0-1 cycle), angle (bright limb position angle, radians), isWaxing
+
+## Example
+
+```ts
+const illum = getMoonIllumination(new Date())
+console.log(illum.fraction)  // e.g. 0.43 (43% illuminated)
+console.log(illum.phase)     // e.g. 0.18 (waxing crescent territory)
+```
--- a/.github/wiki/api/functions/getMoonPhase.md
+++ b/.github/wiki/api/functions/getMoonPhase.md
@ -0,0 +1,40 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / getMoonPhase
+
+# Function: getMoonPhase()
+
+> **getMoonPhase**(`date?`): [`MoonPhaseResult`](../interfaces/MoonPhaseResult.md)
+
+Defined in: [api/index.ts:487](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L487)
+
+Compute the Moon's current phase, illumination, and next phase times.
+
+Works WITHOUT a kernel (uses Meeus approximation).
+
+## Parameters
+
+### date?
+
+`Date` = `...`
+
+Date to compute phase for (default: now)
+
+## Returns
+
+[`MoonPhaseResult`](../interfaces/MoonPhaseResult.md)
+
+MoonPhaseResult with illumination, phase name, age, and next events
+
+## Example
+
+```ts
+const phase = getMoonPhase(new Date())
+console.log(phase.phase)       // 'waxing-crescent'
+console.log(phase.phaseName)   // 'Waxing Crescent'
+console.log(phase.phaseSymbol) // '🌒'
+console.log(phase.illumination)// 14.3 (percent)
+console.log(phase.nextFullMoon)// Date object
+```
--- a/.github/wiki/api/functions/getMoonPosition.md
+++ b/.github/wiki/api/functions/getMoonPosition.md
@ -0,0 +1,56 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / getMoonPosition
+
+# Function: getMoonPosition()
+
+> **getMoonPosition**(`date?`, `lat`, `lon`, `elevation?`): [`MoonPosition`](../interfaces/MoonPosition.md)
+
+Defined in: [api/index.ts:539](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L539)
+
+Compute the Moon's topocentric position (azimuth, altitude, distance) for an observer.
+
+Works WITHOUT a kernel (uses Meeus Ch. 47 approximation).
+Accuracy: azimuth/altitude ~0.3°, distance ~300 km.
+For precision crescent work, use getMoonSightingReport() with the DE442S kernel.
+
+## Parameters
+
+### date?
+
+`Date` = `...`
+
+Date and time to compute position for (default: now)
+
+### lat
+
+`number`
+
+Observer geodetic latitude in degrees (north positive)
+
+### lon
+
+`number`
+
+Observer longitude in degrees (east positive)
+
+### elevation?
+
+`number` = `0`
+
+Observer height above WGS84 ellipsoid in meters (default: 0)
+
+## Returns
+
+[`MoonPosition`](../interfaces/MoonPosition.md)
+
+Topocentric az/alt (degrees), distance (km), parallactic angle (radians)
+
+## Example
+
+```ts
+const pos = getMoonPosition(new Date(), 51.5, -0.1)
+console.log(pos.azimuth, pos.altitude)  // e.g. 212.4, 38.1
+```
--- a/.github/wiki/api/functions/getMoonSightingReport.md
+++ b/.github/wiki/api/functions/getMoonSightingReport.md
@ -0,0 +1,56 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / getMoonSightingReport
+
+# Function: getMoonSightingReport()
+
+> **getMoonSightingReport**(`date`, `observer`, `options?`): `Promise`\<[`MoonSightingReport`](../interfaces/MoonSightingReport.md)\>
+
+Defined in: [api/index.ts:306](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L306)
+
+Compute a complete moon sighting report for a date and location.
+
+Returns all quantities needed for Islamic crescent sighting determination:
+sunset/moonset times, best observation time, crescent geometry (ARCL, ARCV,
+DAZ, W, Lag), Yallop category, Odeh zone, and plain-language guidance.
+
+Requires initKernels() to have been called first (or pass kernels in options).
+
+## Parameters
+
+### date
+
+`Date`
+
+Date to check (UTC midnight or any time on that civil day)
+
+### observer
+
+[`Observer`](../interfaces/Observer.md)
+
+Observer location and environmental parameters
+
+### options?
+
+[`SightingOptions`](../interfaces/SightingOptions.md)
+
+Optional configuration for refraction model, best-time method, etc.
+
+## Returns
+
+`Promise`\<[`MoonSightingReport`](../interfaces/MoonSightingReport.md)\>
+
+Complete MoonSightingReport
+
+## Example
+
+```ts
+await initKernels()
+const report = await getMoonSightingReport(new Date('2025-03-01'), {
+  lat: 51.5074, lon: -0.1278, elevation: 10, name: 'London'
+})
+console.log(report.yallop.category)  // 'A' through 'F'
+console.log(report.guidance)         // "Best time to look: ..."
+```
--- a/.github/wiki/api/functions/getMoonVisibilityEstimate.md
+++ b/.github/wiki/api/functions/getMoonVisibilityEstimate.md
@ -0,0 +1,62 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / getMoonVisibilityEstimate
+
+# Function: getMoonVisibilityEstimate()
+
+> **getMoonVisibilityEstimate**(`date?`, `lat`, `lon`, `elevation?`): [`MoonVisibilityEstimate`](../interfaces/MoonVisibilityEstimate.md)
+
+Defined in: [api/index.ts:647](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L647)
+
+Quick kernel-free crescent visibility estimate using the Odeh criterion.
+
+Computes approximate crescent geometry (ARCL, ARCV, W) from Meeus Ch. 47
+positions at the given observation time and applies the Odeh V-parameter formula.
+Accuracy is limited by the Meeus approximation (~0.3°) and the fact that
+"best time" is not computed — pass your estimated observation time.
+
+For precise crescent work, use getMoonSightingReport() with the DE442S kernel.
+
+## Parameters
+
+### date?
+
+`Date` = `...`
+
+Observation time (default: now). Use a post-sunset time for best results.
+
+### lat
+
+`number`
+
+Observer geodetic latitude in degrees (north positive)
+
+### lon
+
+`number`
+
+Observer longitude in degrees (east positive)
+
+### elevation?
+
+`number` = `0`
+
+Observer height above WGS84 ellipsoid in meters (default: 0)
+
+## Returns
+
+[`MoonVisibilityEstimate`](../interfaces/MoonVisibilityEstimate.md)
+
+MoonVisibilityEstimate with Odeh V, zone, and geometry values
+
+## Example
+
+```ts
+// Estimate crescent visibility at sunset + 40 min in Mecca
+const obs = new Date('2025-03-01T15:30:00Z')  // ~sunset + 40 min in Mecca
+const est = getMoonVisibilityEstimate(obs, 21.42, 39.83)
+console.log(est.zone)               // 'A' through 'D'
+console.log(est.isVisibleNakedEye)  // true/false
+```
--- a/.github/wiki/api/functions/getSunMoonEvents.md
+++ b/.github/wiki/api/functions/getSunMoonEvents.md
@ -0,0 +1,41 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / getSunMoonEvents
+
+# Function: getSunMoonEvents()
+
+> **getSunMoonEvents**(`date`, `observer`, `options?`): `Promise`\<[`SunMoonEvents`](../interfaces/SunMoonEvents.md)\>
+
+Defined in: [api/index.ts:833](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L833)
+
+Get rise, set, and twilight times for the Sun and Moon on a given date.
+
+Requires initKernels() for accurate results.
+
+## Parameters
+
+### date
+
+`Date`
+
+Date to compute events for
+
+### observer
+
+[`Observer`](../interfaces/Observer.md)
+
+Observer location
+
+### options?
+
+`Pick`\<[`SightingOptions`](../interfaces/SightingOptions.md), `"kernels"`\>
+
+Optional kernel configuration
+
+## Returns
+
+`Promise`\<[`SunMoonEvents`](../interfaces/SunMoonEvents.md)\>
+
+SunMoonEvents with all times in UTC
--- a/.github/wiki/api/functions/initKernels.md
+++ b/.github/wiki/api/functions/initKernels.md
@ -0,0 +1,31 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / initKernels
+
+# Function: initKernels()
+
+> **initKernels**(`config?`): `Promise`\<`void`\>
+
+Defined in: [api/index.ts:121](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L121)
+
+Initialize the kernel engine from an already-downloaded kernel.
+Must be called before getMoonSightingReport() or getSunMoonEvents().
+
+Supports three source modes:
+  - File path (Node.js): initKernels({ planetary: { type: 'file', path: '/path/to/de442s.bsp' } })
+  - ArrayBuffer (browser): initKernels({ planetary: { type: 'buffer', data: buf, name: 'de442s.bsp' } })
+  - Auto (Node.js): initKernels() — downloads and caches automatically
+
+## Parameters
+
+### config?
+
+[`KernelConfig`](../interfaces/KernelConfig.md)
+
+Kernel source configuration. Defaults to auto-download.
+
+## Returns
+
+`Promise`\<`void`\>
--- a/.github/wiki/api/functions/verifyKernels.md
+++ b/.github/wiki/api/functions/verifyKernels.md
@ -0,0 +1,27 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / verifyKernels
+
+# Function: verifyKernels()
+
+> **verifyKernels**(`config?`): `Promise`\<\{ `errors`: `string`[]; `ok`: `boolean`; \}\>
+
+Defined in: [api/index.ts:221](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/api/index.ts#L221)
+
+Verify that locally cached kernels exist (and match checksums if supplied).
+
+## Parameters
+
+### config?
+
+[`KernelConfig`](../interfaces/KernelConfig.md)
+
+Optional kernel config (to customize cache directory or checksum)
+
+## Returns
+
+`Promise`\<\{ `errors`: `string`[]; `ok`: `boolean`; \}\>
+
+— ok is true when all checks pass
--- a/.github/wiki/api/interfaces/AzAlt.md
+++ b/.github/wiki/api/interfaces/AzAlt.md
@ -0,0 +1,31 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / AzAlt
+
+# Interface: AzAlt
+
+Defined in: [types.ts:13](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L13)
+
+Azimuth + altitude in degrees
+
+## Properties
+
+### altitude
+
+> **altitude**: `number`
+
+Defined in: [types.ts:17](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L17)
+
+Degrees above the horizon (negative = below)
+
+***
+
+### azimuth
+
+> **azimuth**: `number`
+
+Defined in: [types.ts:15](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L15)
+
+Degrees from North, measured clockwise (0 = N, 90 = E, 180 = S, 270 = W)
--- a/.github/wiki/api/interfaces/ChebRecord.md
+++ b/.github/wiki/api/interfaces/ChebRecord.md
@ -0,0 +1,51 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / ChebRecord
+
+# Interface: ChebRecord
+
+Defined in: [types.ts:479](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L479)
+
+A decoded Chebyshev record from a Type 2 or Type 3 SPK segment
+
+## Properties
+
+### coeffs
+
+> **coeffs**: `Float64Array`\<`ArrayBufferLike`\>[]
+
+Defined in: [types.ts:485](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L485)
+
+Chebyshev coefficients for X, Y, Z [3][degree+1]
+
+***
+
+### degree
+
+> **degree**: `number`
+
+Defined in: [types.ts:487](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L487)
+
+Degree of the polynomial
+
+***
+
+### mid
+
+> **mid**: `number`
+
+Defined in: [types.ts:481](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L481)
+
+Midpoint of the record interval in ET seconds past J2000
+
+***
+
+### radius
+
+> **radius**: `number`
+
+Defined in: [types.ts:483](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L483)
+
+Half-width of the record interval in seconds
--- a/.github/wiki/api/interfaces/CrescentGeometry.md
+++ b/.github/wiki/api/interfaces/CrescentGeometry.md
@ -0,0 +1,65 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / CrescentGeometry
+
+# Interface: CrescentGeometry
+
+Defined in: [types.ts:118](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L118)
+
+The five geometric quantities used by all major crescent visibility criteria.
+All values computed at best time (T_b) unless noted.
+
+## Properties
+
+### ARCL
+
+> **ARCL**: `number`
+
+Defined in: [types.ts:120](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L120)
+
+Arc of light: topocentric Sun-Moon angular separation (elongation), degrees
+
+***
+
+### ARCV
+
+> **ARCV**: `number`
+
+Defined in: [types.ts:125](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L125)
+
+Arc of vision: Moon airless altitude minus Sun airless altitude, degrees.
+Used as the primary visibility discriminant in both Yallop and Odeh.
+
+***
+
+### DAZ
+
+> **DAZ**: `number`
+
+Defined in: [types.ts:130](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L130)
+
+Relative azimuth: Sun azimuth minus Moon azimuth, normalized to [-180, 180], degrees.
+Positive = Moon north of Sun.
+
+***
+
+### lag
+
+> **lag**: `number`
+
+Defined in: [types.ts:137](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L137)
+
+Moonset minus sunset in minutes. Negative = Moon sets before Sun (no sighting possible).
+
+***
+
+### W
+
+> **W**: `number`
+
+Defined in: [types.ts:135](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L135)
+
+Topocentric crescent width in arc minutes.
+Used directly in Odeh's polynomial V expression.
--- a/.github/wiki/api/interfaces/KernelConfig.md
+++ b/.github/wiki/api/interfaces/KernelConfig.md
@ -0,0 +1,51 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / KernelConfig
+
+# Interface: KernelConfig
+
+Defined in: [types.ts:405](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L405)
+
+## Properties
+
+### cacheDir?
+
+> `optional` **cacheDir?**: `string`
+
+Defined in: [types.ts:414](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L414)
+
+Directory for the download cache.
+Defaults to ~/.cache/moon-sighting on POSIX, %LOCALAPPDATA%\moon-sighting on Windows.
+
+***
+
+### checksumOverride?
+
+> `optional` **checksumOverride?**: `string`
+
+Defined in: [types.ts:419](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L419)
+
+SHA-256 checksum of de442s.bsp for download verification.
+Bundled default matches the NAIF distribution as of 2024.
+
+***
+
+### leapSeconds?
+
+> `optional` **leapSeconds?**: [`KernelSource`](../type-aliases/KernelSource.md)
+
+Defined in: [types.ts:409](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L409)
+
+Leap-second kernel — defaults to naif0012.tls via auto-download
+
+***
+
+### planetary?
+
+> `optional` **planetary?**: [`KernelSource`](../type-aliases/KernelSource.md)
+
+Defined in: [types.ts:407](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L407)
+
+Planetary SPK kernel — defaults to de442s.bsp via auto-download
--- a/.github/wiki/api/interfaces/MoonIlluminationResult.md
+++ b/.github/wiki/api/interfaces/MoonIlluminationResult.md
@ -0,0 +1,55 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / MoonIlluminationResult
+
+# Interface: MoonIlluminationResult
+
+Defined in: [types.ts:47](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L47)
+
+Moon illumination from getMoonIllumination().
+Computed via Meeus Ch. 47/48 (no kernel required).
+Accuracy: fraction ~0.5%, phase fraction ~0.003.
+
+## Properties
+
+### angle
+
+> **angle**: `number`
+
+Defined in: [types.ts:59](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L59)
+
+Position angle of the midpoint of the bright limb, measured eastward from
+the north celestial pole, in radians. Matches the suncalc convention.
+
+***
+
+### fraction
+
+> **fraction**: `number`
+
+Defined in: [types.ts:49](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L49)
+
+Illuminated fraction of the Moon disk, 0 (new moon) to 1 (full moon)
+
+***
+
+### isWaxing
+
+> **isWaxing**: `boolean`
+
+Defined in: [types.ts:61](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L61)
+
+True while elongation is increasing (new moon toward full moon)
+
+***
+
+### phase
+
+> **phase**: `number`
+
+Defined in: [types.ts:54](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L54)
+
+Phase cycle fraction in [0, 1):
+  0 = new moon, 0.25 = first quarter, 0.5 = full moon, 0.75 = last quarter
--- a/.github/wiki/api/interfaces/MoonPhaseResult.md
+++ b/.github/wiki/api/interfaces/MoonPhaseResult.md
@ -0,0 +1,109 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / MoonPhaseResult
+
+# Interface: MoonPhaseResult
+
+Defined in: [types.ts:300](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L300)
+
+## Properties
+
+### age
+
+> **age**: `number`
+
+Defined in: [types.ts:310](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L310)
+
+Hours since last new moon
+
+***
+
+### elongationDeg
+
+> **elongationDeg**: `number`
+
+Defined in: [types.ts:312](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L312)
+
+Ecliptic longitude of the Moon minus the Sun, degrees [0, 360)
+
+***
+
+### illumination
+
+> **illumination**: `number`
+
+Defined in: [types.ts:308](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L308)
+
+Illuminated fraction 0-100 (percent)
+
+***
+
+### isWaxing
+
+> **isWaxing**: `boolean`
+
+Defined in: [types.ts:314](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L314)
+
+True when Moon is moving away from the Sun (illumination increasing)
+
+***
+
+### nextFullMoon
+
+> **nextFullMoon**: `Date`
+
+Defined in: [types.ts:318](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L318)
+
+UTC date of the next full moon
+
+***
+
+### nextNewMoon
+
+> **nextNewMoon**: `Date`
+
+Defined in: [types.ts:316](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L316)
+
+UTC date of the next new moon
+
+***
+
+### phase
+
+> **phase**: [`MoonPhaseName`](../type-aliases/MoonPhaseName.md)
+
+Defined in: [types.ts:302](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L302)
+
+Named phase based on illumination and waxing/waning state
+
+***
+
+### phaseName
+
+> **phaseName**: `string`
+
+Defined in: [types.ts:304](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L304)
+
+Human-readable phase name, e.g. "Waxing Crescent"
+
+***
+
+### phaseSymbol
+
+> **phaseSymbol**: `string`
+
+Defined in: [types.ts:306](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L306)
+
+Moon phase emoji symbol, e.g. "🌒"
+
+***
+
+### prevNewMoon
+
+> **prevNewMoon**: `Date`
+
+Defined in: [types.ts:320](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L320)
+
+UTC date of the previous new moon
--- a/.github/wiki/api/interfaces/MoonPosition.md
+++ b/.github/wiki/api/interfaces/MoonPosition.md
@ -0,0 +1,55 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / MoonPosition
+
+# Interface: MoonPosition
+
+Defined in: [types.ts:27](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L27)
+
+Topocentric moon position from getMoonPosition().
+Computed via Meeus Ch. 47 (no kernel required).
+Accuracy: azimuth/altitude ~0.3°, distance ~300 km.
+
+## Properties
+
+### altitude
+
+> **altitude**: `number`
+
+Defined in: [types.ts:31](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L31)
+
+Apparent altitude in degrees above the horizon (atmospheric refraction applied)
+
+***
+
+### azimuth
+
+> **azimuth**: `number`
+
+Defined in: [types.ts:29](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L29)
+
+Azimuth in degrees from North, measured clockwise (0 = N, 90 = E, 180 = S, 270 = W)
+
+***
+
+### distance
+
+> **distance**: `number`
+
+Defined in: [types.ts:33](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L33)
+
+Distance from Earth center to Moon center, km
+
+***
+
+### parallacticAngle
+
+> **parallacticAngle**: `number`
+
+Defined in: [types.ts:39](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L39)
+
+Parallactic angle in radians.
+The angle between the great circle through the Moon and zenith, and the great circle
+through the Moon and the north celestial pole. Positive east of the meridian.
--- a/.github/wiki/api/interfaces/MoonSightingReport.md
+++ b/.github/wiki/api/interfaces/MoonSightingReport.md
@ -0,0 +1,180 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / MoonSightingReport
+
+# Interface: MoonSightingReport
+
+Defined in: [types.ts:344](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L344)
+
+## Properties
+
+### bestTimeUTC
+
+> **bestTimeUTC**: `Date` \| `null`
+
+Defined in: [types.ts:356](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L356)
+
+Best observation time (Odeh/Yallop: T_s + 4/9 * Lag)
+
+***
+
+### bestTimeWindowUTC
+
+> **bestTimeWindowUTC**: \[`Date`, `Date`\] \| `null`
+
+Defined in: [types.ts:358](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L358)
+
+Conservative observation window [bestTime - 20min, bestTime + 20min]
+
+***
+
+### date
+
+> **date**: `Date`
+
+Defined in: [types.ts:346](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L346)
+
+Date for which the sighting report was computed
+
+***
+
+### ephemerisSource
+
+> **ephemerisSource**: `"DE442S"` \| `"approximate"`
+
+Defined in: [types.ts:386](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L386)
+
+Source ephemeris used for this calculation
+
+***
+
+### geometry
+
+> **geometry**: [`CrescentGeometry`](CrescentGeometry.md) \| `null`
+
+Defined in: [types.ts:371](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L371)
+
+***
+
+### guidance
+
+> **guidance**: `string`
+
+Defined in: [types.ts:382](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L382)
+
+Plain-language direction for observers.
+Includes where to look (azimuth, altitude), when (best time), and what to expect.
+
+***
+
+### illumination
+
+> **illumination**: `number` \| `null`
+
+Defined in: [types.ts:366](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L366)
+
+Moon illumination percent at best time
+
+***
+
+### lagMinutes
+
+> **lagMinutes**: `number` \| `null`
+
+Defined in: [types.ts:354](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L354)
+
+Moonset minus sunset, in minutes. Null if either event is null.
+
+***
+
+### moonAboveHorizon
+
+> **moonAboveHorizon**: `boolean` \| `null`
+
+Defined in: [types.ts:388](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L388)
+
+Whether the Moon is even above the horizon at best time
+
+***
+
+### moonAge
+
+> **moonAge**: `number` \| `null`
+
+Defined in: [types.ts:368](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L368)
+
+Hours since conjunction (new moon)
+
+***
+
+### moonPosition
+
+> **moonPosition**: [`AzAlt`](AzAlt.md) \| `null`
+
+Defined in: [types.ts:362](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L362)
+
+Topocentric Moon position at best time
+
+***
+
+### moonsetUTC
+
+> **moonsetUTC**: `Date` \| `null`
+
+Defined in: [types.ts:352](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L352)
+
+***
+
+### observer
+
+> **observer**: [`Observer`](Observer.md)
+
+Defined in: [types.ts:348](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L348)
+
+Observer location used
+
+***
+
+### odeh
+
+> **odeh**: [`OdehResult`](OdehResult.md) \| `null`
+
+Defined in: [types.ts:375](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L375)
+
+***
+
+### sightingPossible
+
+> **sightingPossible**: `boolean`
+
+Defined in: [types.ts:390](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L390)
+
+Whether sighting is geometrically possible (lag > 0, Moon above horizon at best time)
+
+***
+
+### sunPosition
+
+> **sunPosition**: [`AzAlt`](AzAlt.md) \| `null`
+
+Defined in: [types.ts:364](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L364)
+
+Topocentric Sun position at best time
+
+***
+
+### sunsetUTC
+
+> **sunsetUTC**: `Date` \| `null`
+
+Defined in: [types.ts:351](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L351)
+
+***
+
+### yallop
+
+> **yallop**: [`YallopResult`](YallopResult.md) \| `null`
+
+Defined in: [types.ts:374](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L374)
--- a/.github/wiki/api/interfaces/MoonSnapshot.md
+++ b/.github/wiki/api/interfaces/MoonSnapshot.md
@ -0,0 +1,53 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / MoonSnapshot
+
+# Interface: MoonSnapshot
+
+Defined in: [types.ts:277](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L277)
+
+Combined kernel-free moon snapshot from getMoon().
+Bundles phase, position, illumination, and a quick visibility estimate
+into a single call.
+
+## Properties
+
+### illumination
+
+> **illumination**: [`MoonIlluminationResult`](MoonIlluminationResult.md)
+
+Defined in: [types.ts:283](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L283)
+
+Illumination fraction, phase cycle, bright limb angle, waxing/waning
+
+***
+
+### phase
+
+> **phase**: [`MoonPhaseResult`](MoonPhaseResult.md)
+
+Defined in: [types.ts:279](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L279)
+
+Phase name, illumination, age, and next events
+
+***
+
+### position
+
+> **position**: [`MoonPosition`](MoonPosition.md)
+
+Defined in: [types.ts:281](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L281)
+
+Topocentric az/alt, distance, parallactic angle
+
+***
+
+### visibility
+
+> **visibility**: [`MoonVisibilityEstimate`](MoonVisibilityEstimate.md)
+
+Defined in: [types.ts:285](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L285)
+
+Quick Odeh-based crescent visibility estimate
--- a/.github/wiki/api/interfaces/MoonVisibilityEstimate.md
+++ b/.github/wiki/api/interfaces/MoonVisibilityEstimate.md
@ -0,0 +1,114 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / MoonVisibilityEstimate
+
+# Interface: MoonVisibilityEstimate
+
+Defined in: [types.ts:246](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L246)
+
+Kernel-free Odeh-based crescent visibility estimate from getMoonVisibilityEstimate().
+Computed via Meeus Ch. 47 approximation at the given observation time.
+For DE442S-quality results, use getMoonSightingReport().
+
+## Properties
+
+### ARCL
+
+> **ARCL**: `number`
+
+Defined in: [types.ts:261](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L261)
+
+Arc of light (Sun-Moon elongation) in degrees
+
+***
+
+### ARCV
+
+> **ARCV**: `number`
+
+Defined in: [types.ts:263](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L263)
+
+Arc of vision (Moon airless altitude minus Sun airless altitude) in degrees
+
+***
+
+### description
+
+> **description**: `string`
+
+Defined in: [types.ts:255](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L255)
+
+Human-readable zone description
+
+***
+
+### isApproximate
+
+> **isApproximate**: `true`
+
+Defined in: [types.ts:269](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L269)
+
+Always true: computed via Meeus approximation, not DE442S
+
+***
+
+### isVisibleNakedEye
+
+> **isVisibleNakedEye**: `boolean`
+
+Defined in: [types.ts:257](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L257)
+
+True for zone A
+
+***
+
+### isVisibleWithOpticalAid
+
+> **isVisibleWithOpticalAid**: `boolean`
+
+Defined in: [types.ts:259](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L259)
+
+True for zones A and B
+
+***
+
+### moonAboveHorizon
+
+> **moonAboveHorizon**: `boolean`
+
+Defined in: [types.ts:267](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L267)
+
+True when Moon is above the horizon at the given time
+
+***
+
+### V
+
+> **V**: `number`
+
+Defined in: [types.ts:251](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L251)
+
+Odeh V parameter: V = ARCV − f(W).
+Positive = crescent exceeds minimum visibility threshold.
+
+***
+
+### W
+
+> **W**: `number`
+
+Defined in: [types.ts:265](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L265)
+
+Topocentric crescent width in arc minutes
+
+***
+
+### zone
+
+> **zone**: [`OdehZone`](../type-aliases/OdehZone.md)
+
+Defined in: [types.ts:253](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L253)
+
+Visibility zone A through D
--- a/.github/wiki/api/interfaces/Observer.md
+++ b/.github/wiki/api/interfaces/Observer.md
@ -0,0 +1,94 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / Observer
+
+# Interface: Observer
+
+Defined in: [types.ts:86](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L86)
+
+Observer location and environmental parameters
+
+## Properties
+
+### deltaT?
+
+> `optional` **deltaT?**: `number`
+
+Defined in: [types.ts:100](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L100)
+
+Override TT - UT1 in seconds.
+When provided, used directly. Otherwise the built-in polynomial is used.
+For maximum accuracy, supply the current IERS value (typically within ±0.9s).
+
+***
+
+### elevation
+
+> **elevation**: `number`
+
+Defined in: [types.ts:92](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L92)
+
+Height above WGS84 ellipsoid in meters
+
+***
+
+### lat
+
+> **lat**: `number`
+
+Defined in: [types.ts:88](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L88)
+
+Geodetic latitude in degrees (north positive)
+
+***
+
+### lon
+
+> **lon**: `number`
+
+Defined in: [types.ts:90](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L90)
+
+Longitude in degrees (east positive)
+
+***
+
+### name?
+
+> `optional` **name?**: `string`
+
+Defined in: [types.ts:94](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L94)
+
+Optional label for the location
+
+***
+
+### pressure?
+
+> `optional` **pressure?**: `number`
+
+Defined in: [types.ts:107](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L107)
+
+Atmospheric pressure in millibars (default 1013.25)
+
+***
+
+### temperature?
+
+> `optional` **temperature?**: `number`
+
+Defined in: [types.ts:109](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L109)
+
+Ambient temperature in Celsius (default 15)
+
+***
+
+### ut1utc?
+
+> `optional` **ut1utc?**: `number`
+
+Defined in: [types.ts:105](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L105)
+
+Override UT1 - UTC in seconds (from IERS Bulletin A).
+Takes precedence over deltaT when both are provided.
--- a/.github/wiki/api/interfaces/OdehResult.md
+++ b/.github/wiki/api/interfaces/OdehResult.md
@ -0,0 +1,60 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / OdehResult
+
+# Interface: OdehResult
+
+Defined in: [types.ts:223](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L223)
+
+## Properties
+
+### description
+
+> **description**: `string`
+
+Defined in: [types.ts:232](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L232)
+
+Human-readable interpretation
+
+***
+
+### isVisibleNakedEye
+
+> **isVisibleNakedEye**: `boolean`
+
+Defined in: [types.ts:234](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L234)
+
+True for zone A
+
+***
+
+### isVisibleWithOpticalAid
+
+> **isVisibleWithOpticalAid**: `boolean`
+
+Defined in: [types.ts:236](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L236)
+
+True for zones A and B
+
+***
+
+### V
+
+> **V**: `number`
+
+Defined in: [types.ts:228](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L228)
+
+Continuous visibility parameter V = ARCV - (arcv_minimum(W)).
+Positive = crescent exceeds minimum visibility threshold.
+
+***
+
+### zone
+
+> **zone**: [`OdehZone`](../type-aliases/OdehZone.md)
+
+Defined in: [types.ts:230](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L230)
+
+Visibility zone A through D
--- a/.github/wiki/api/interfaces/SightingOptions.md
+++ b/.github/wiki/api/interfaces/SightingOptions.md
@ -0,0 +1,32 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / SightingOptions
+
+# Interface: SightingOptions
+
+Defined in: [types.ts:424](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L424)
+
+## Properties
+
+### bestTimeMethod?
+
+> `optional` **bestTimeMethod?**: `"heuristic"` \| `"optimized"`
+
+Defined in: [types.ts:433](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L433)
+
+Best-time computation method.
+'heuristic'  — T_b = T_sunset + 4/9 * Lag (Odeh/Yallop approximation, fast)
+'optimized'  — scan sunset-to-moonset interval, maximize Odeh V parameter
+Default: 'heuristic'
+
+***
+
+### kernels?
+
+> `optional` **kernels?**: [`KernelConfig`](KernelConfig.md)
+
+Defined in: [types.ts:426](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L426)
+
+Kernel acquisition configuration. Defaults to auto-download.
--- a/.github/wiki/api/interfaces/SpkSegment.md
+++ b/.github/wiki/api/interfaces/SpkSegment.md
@ -0,0 +1,91 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / SpkSegment
+
+# Interface: SpkSegment
+
+Defined in: [types.ts:459](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L459)
+
+A segment in a JPL SPK (DAF) kernel file
+
+## Properties
+
+### center
+
+> **center**: `number`
+
+Defined in: [types.ts:463](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L463)
+
+NAIF body ID of the center body
+
+***
+
+### dataOffset
+
+> **dataOffset**: `number`
+
+Defined in: [types.ts:473](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L473)
+
+Byte offset of the data array in the file
+
+***
+
+### dataSize
+
+> **dataSize**: `number`
+
+Defined in: [types.ts:475](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L475)
+
+Number of double-precision values in the data array
+
+***
+
+### dataType
+
+> **dataType**: `2` \| `3`
+
+Defined in: [types.ts:467](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L467)
+
+SPK data type (2 = Chebyshev position only, 3 = Chebyshev position + velocity)
+
+***
+
+### endET
+
+> **endET**: `number`
+
+Defined in: [types.ts:471](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L471)
+
+Segment end time in ET seconds past J2000
+
+***
+
+### frame
+
+> **frame**: `number`
+
+Defined in: [types.ts:465](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L465)
+
+Reference frame code
+
+***
+
+### startET
+
+> **startET**: `number`
+
+Defined in: [types.ts:469](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L469)
+
+Segment start time in ET seconds past J2000
+
+***
+
+### target
+
+> **target**: `number`
+
+Defined in: [types.ts:461](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L461)
+
+NAIF body ID of the target body
--- a/.github/wiki/api/interfaces/StateVector.md
+++ b/.github/wiki/api/interfaces/StateVector.md
@ -0,0 +1,27 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / StateVector
+
+# Interface: StateVector
+
+Defined in: [types.ts:7](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L7)
+
+Position + velocity state vector from the ephemeris
+
+## Properties
+
+### position
+
+> **position**: [`Vec3`](../type-aliases/Vec3.md)
+
+Defined in: [types.ts:8](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L8)
+
+***
+
+### velocity
+
+> **velocity**: [`Vec3`](../type-aliases/Vec3.md)
+
+Defined in: [types.ts:9](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L9)
--- a/.github/wiki/api/interfaces/SunMoonEvents.md
+++ b/.github/wiki/api/interfaces/SunMoonEvents.md
@ -0,0 +1,79 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / SunMoonEvents
+
+# Interface: SunMoonEvents
+
+Defined in: [types.ts:325](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L325)
+
+## Properties
+
+### astronomicalTwilightEndUTC
+
+> **astronomicalTwilightEndUTC**: `Date` \| `null`
+
+Defined in: [types.ts:339](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L339)
+
+UTC time when astronomical twilight ends (Sun at -18°)
+
+***
+
+### civilTwilightEndUTC
+
+> **civilTwilightEndUTC**: `Date` \| `null`
+
+Defined in: [types.ts:335](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L335)
+
+UTC time when civil twilight ends (Sun at -6°)
+
+***
+
+### moonriseUTC
+
+> **moonriseUTC**: `Date` \| `null`
+
+Defined in: [types.ts:333](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L333)
+
+UTC time of moonrise
+
+***
+
+### moonsetUTC
+
+> **moonsetUTC**: `Date` \| `null`
+
+Defined in: [types.ts:329](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L329)
+
+UTC time of moonset for the given date at the observer's location
+
+***
+
+### nauticalTwilightEndUTC
+
+> **nauticalTwilightEndUTC**: `Date` \| `null`
+
+Defined in: [types.ts:337](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L337)
+
+UTC time when nautical twilight ends (Sun at -12°)
+
+***
+
+### sunriseUTC
+
+> **sunriseUTC**: `Date` \| `null`
+
+Defined in: [types.ts:331](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L331)
+
+UTC time of sunrise
+
+***
+
+### sunsetUTC
+
+> **sunsetUTC**: `Date` \| `null`
+
+Defined in: [types.ts:327](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L327)
+
+UTC time of sunset for the given date at the observer's location
--- a/.github/wiki/api/interfaces/TimeScales.md
+++ b/.github/wiki/api/interfaces/TimeScales.md
@ -0,0 +1,79 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / TimeScales
+
+# Interface: TimeScales
+
+Defined in: [types.ts:67](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L67)
+
+All relevant time scale values for a single moment
+
+## Properties
+
+### deltaAT
+
+> **deltaAT**: `number`
+
+Defined in: [types.ts:80](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L80)
+
+TAI - UTC in seconds (leap seconds count)
+
+***
+
+### deltaT
+
+> **deltaT**: `number`
+
+Defined in: [types.ts:78](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L78)
+
+TT - UT1 in seconds (delta-T)
+
+***
+
+### jdTDB
+
+> **jdTDB**: `number`
+
+Defined in: [types.ts:74](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L74)
+
+Julian Date in Barycentric Dynamical Time (used by JPL ephemerides)
+
+***
+
+### jdTT
+
+> **jdTT**: `number`
+
+Defined in: [types.ts:72](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L72)
+
+Julian Date in Terrestrial Time (TT = TAI + 32.184s)
+
+***
+
+### jdUT1
+
+> **jdUT1**: `number`
+
+Defined in: [types.ts:76](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L76)
+
+Julian Date in UT1 (Earth rotation time)
+
+***
+
+### jdUTC
+
+> **jdUTC**: `number`
+
+Defined in: [types.ts:70](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L70)
+
+Julian Date in UTC
+
+***
+
+### utc
+
+> **utc**: `Date`
+
+Defined in: [types.ts:68](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L68)
--- a/.github/wiki/api/interfaces/YallopResult.md
+++ b/.github/wiki/api/interfaces/YallopResult.md
@ -0,0 +1,79 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / YallopResult
+
+# Interface: YallopResult
+
+Defined in: [types.ts:176](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L176)
+
+## Properties
+
+### category
+
+> **category**: [`YallopCategory`](../type-aliases/YallopCategory.md)
+
+Defined in: [types.ts:180](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L180)
+
+Visibility category A through F
+
+***
+
+### description
+
+> **description**: `string`
+
+Defined in: [types.ts:182](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L182)
+
+Human-readable interpretation
+
+***
+
+### isBelowDanjonLimit
+
+> **isBelowDanjonLimit**: `boolean`
+
+Defined in: [types.ts:188](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L188)
+
+True for category F
+
+***
+
+### isVisibleNakedEye
+
+> **isVisibleNakedEye**: `boolean`
+
+Defined in: [types.ts:184](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L184)
+
+True for categories A and B
+
+***
+
+### q
+
+> **q**: `number`
+
+Defined in: [types.ts:178](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L178)
+
+The continuous q parameter (higher = more visible)
+
+***
+
+### requiresOpticalAid
+
+> **requiresOpticalAid**: `boolean`
+
+Defined in: [types.ts:186](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L186)
+
+True for categories C and D
+
+***
+
+### Wprime
+
+> **Wprime**: `number`
+
+Defined in: [types.ts:190](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L190)
+
+Topocentric crescent width W' used in the q formula, arc minutes
--- a/.github/wiki/api/type-aliases/KernelSource.md
+++ b/.github/wiki/api/type-aliases/KernelSource.md
@ -0,0 +1,14 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / KernelSource
+
+# Type Alias: KernelSource
+
+> **KernelSource** = \{ `path`: `string`; `type`: `"file"`; \} \| \{ `data`: `ArrayBuffer`; `name`: `string`; `type`: `"buffer"`; \} \| \{ `type`: `"url"`; `url`: `string`; \} \| \{ `type`: `"auto"`; \}
+
+Defined in: [types.ts:399](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L399)
+
+How to source a binary kernel file.
+Used for both the planetary SPK (de442s.bsp) and leap-second kernel (naif0012.tls).
--- a/.github/wiki/api/type-aliases/MoonPhaseName.md
+++ b/.github/wiki/api/type-aliases/MoonPhaseName.md
@ -0,0 +1,11 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / MoonPhaseName
+
+# Type Alias: MoonPhaseName
+
+> **MoonPhaseName** = `"new-moon"` \| `"waxing-crescent"` \| `"first-quarter"` \| `"waxing-gibbous"` \| `"full-moon"` \| `"waning-gibbous"` \| `"last-quarter"` \| `"waning-crescent"`
+
+Defined in: [types.ts:290](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L290)
--- a/.github/wiki/api/type-aliases/OdehZone.md
+++ b/.github/wiki/api/type-aliases/OdehZone.md
@ -0,0 +1,13 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / OdehZone
+
+# Type Alias: OdehZone
+
+> **OdehZone** = `"A"` \| `"B"` \| `"C"` \| `"D"`
+
+Defined in: [types.ts:197](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L197)
+
+Odeh visibility zone (A = naked eye visible, D = not visible with any aid).
--- a/.github/wiki/api/type-aliases/Vec3.md
+++ b/.github/wiki/api/type-aliases/Vec3.md
@ -0,0 +1,13 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / Vec3
+
+# Type Alias: Vec3
+
+> **Vec3** = \[`number`, `number`, `number`\]
+
+Defined in: [types.ts:4](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L4)
+
+3-element position or velocity vector in km or km/s
--- a/.github/wiki/api/type-aliases/YallopCategory.md
+++ b/.github/wiki/api/type-aliases/YallopCategory.md
@ -0,0 +1,13 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / YallopCategory
+
+# Type Alias: YallopCategory
+
+> **YallopCategory** = `"A"` \| `"B"` \| `"C"` \| `"D"` \| `"E"` \| `"F"`
+
+Defined in: [types.ts:144](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L144)
+
+Yallop visibility category (A = easily visible, F = below Danjon limit).
--- a/.github/wiki/api/variables/ODEH_DESCRIPTIONS.md
+++ b/.github/wiki/api/variables/ODEH_DESCRIPTIONS.md
@ -0,0 +1,14 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / ODEH\_DESCRIPTIONS
+
+# Variable: ODEH\_DESCRIPTIONS
+
+> `const` **ODEH\_DESCRIPTIONS**: `Record`\<[`OdehZone`](../type-aliases/OdehZone.md), `string`\>
+
+Defined in: [types.ts:216](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L216)
+
+Human-readable descriptions for each Odeh visibility zone (A–D).
+Sourced from Odeh (Experimental Astronomy, 2006).
--- a/.github/wiki/api/variables/ODEH_THRESHOLDS.md
+++ b/.github/wiki/api/variables/ODEH_THRESHOLDS.md
@ -0,0 +1,31 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / ODEH\_THRESHOLDS
+
+# Variable: ODEH\_THRESHOLDS
+
+> `const` **ODEH\_THRESHOLDS**: `object`
+
+Defined in: [types.ts:206](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L206)
+
+Published V thresholds (Odeh 2006):
+  A: V >= 5.65  — Visible with naked eye
+  B: V >= 2.00  — Visible with optical aid; may be seen with naked eye
+  C: V >= -0.96 — Visible with optical aid only
+  D: V <  -0.96 — Not visible even with optical aid
+
+## Type Declaration
+
+### A
+
+> `readonly` **A**: `5.65` = `5.65`
+
+### B
+
+> `readonly` **B**: `2` = `2.0`
+
+### C
+
+> `readonly` **C**: `-0.96` = `-0.96`
--- a/.github/wiki/api/variables/WGS84.md
+++ b/.github/wiki/api/variables/WGS84.md
@ -0,0 +1,57 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / WGS84
+
+# Variable: WGS84
+
+> `const` **WGS84**: `object`
+
+Defined in: [types.ts:439](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L439)
+
+WGS84 reference ellipsoid parameters
+
+## Type Declaration
+
+### a
+
+> `readonly` **a**: `6378137` = `6378137.0`
+
+Semi-major axis in meters
+
+### f
+
+> `readonly` **f**: `number`
+
+Flattening
+
+### invF
+
+> `readonly` **invF**: `298.257223563` = `298.257223563`
+
+Inverse flattening
+
+### b
+
+#### Get Signature
+
+> **get** **b**(): `number`
+
+Semi-minor axis in meters
+
+##### Returns
+
+`number`
+
+### e2
+
+#### Get Signature
+
+> **get** **e2**(): `number`
+
+First eccentricity squared
+
+##### Returns
+
+`number`
--- a/.github/wiki/api/variables/YALLOP_DESCRIPTIONS.md
+++ b/.github/wiki/api/variables/YALLOP_DESCRIPTIONS.md
@ -0,0 +1,14 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / YALLOP\_DESCRIPTIONS
+
+# Variable: YALLOP\_DESCRIPTIONS
+
+> `const` **YALLOP\_DESCRIPTIONS**: `Record`\<[`YallopCategory`](../type-aliases/YallopCategory.md), `string`\>
+
+Defined in: [types.ts:167](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L167)
+
+Human-readable descriptions for each Yallop visibility category (A–F).
+Sourced from Yallop (NAO TN 69, 1997).
--- a/.github/wiki/api/variables/YALLOP_THRESHOLDS.md
+++ b/.github/wiki/api/variables/YALLOP_THRESHOLDS.md
@ -0,0 +1,41 @@
+[**moon-sighting v1.1.1**](../README.md)
+
+***
+
+[moon-sighting](../README.md) / YALLOP\_THRESHOLDS
+
+# Variable: YALLOP\_THRESHOLDS
+
+> `const` **YALLOP\_THRESHOLDS**: `object`
+
+Defined in: [types.ts:155](https://github.com/acamarata/moon-sighting/blob/89fb490051d0263a7d41c954161fb945f1569805/src/types.ts#L155)
+
+Published q thresholds (Yallop 1997, NAO TN 69):
+  A: q > +0.216   — Easily visible to the naked eye
+  B: q > -0.014   — Visible under perfect conditions
+  C: q > -0.160   — May need optical aid to find; visible to naked eye
+  D: q > -0.232   — Optical aid needed; will not be visible to naked eye
+  E: q > -0.293   — Not visible even with telescope
+  F: q <= -0.293  — Below Danjon limit (Moon too close to Sun)
+
+## Type Declaration
+
+### A
+
+> `readonly` **A**: `0.216` = `0.216`
+
+### B
+
+> `readonly` **B**: `-0.014` = `-0.014`
+
+### C
+
+> `readonly` **C**: `-0.16` = `-0.16`
+
+### D
+
+> `readonly` **D**: `-0.232` = `-0.232`
+
+### E
+
+> `readonly` **E**: `-0.293` = `-0.293`
--- a/package.json
+++ b/package.json
@ -39,10 +39,12 @@
    "format:check": "prettier --check src/",
    "prepublishOnly": "pnpm run build",
    "cli": "node dist/cli/index.cjs",
-    "coverage": "c8 --reporter=lcov --reporter=text node --test"
+    "coverage": "c8 --reporter=lcov --reporter=text node test.mjs",
+    "docs": "typedoc --out .github/wiki/api src/index.ts"
  },
  "devDependencies": {
    "@acamarata/eslint-config": "^0.1.0",
+    "c8": "^10.1.3",
    "@acamarata/prettier-config": "^0.1.0",
    "@acamarata/tsconfig": "^0.1.0",
    "@eslint/js": "^10.0.1",
@ -51,6 +53,8 @@
    "eslint-config-prettier": "^10.1.8",
    "prettier": "^3.8.1",
    "tsup": "^8.5.1",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.11.0",
    "typescript": "^5.9.3",
    "typescript-eslint": "^8.56.1"
  },
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@ -23,6 +23,9 @@ importers:
      '@types/node':
        specifier: ^25.3.0
        version: 25.3.0
+      c8:
+        specifier: ^10.1.3
+        version: 10.1.3
      eslint:
        specifier: ^10.0.3
        version: 10.0.3
@ -34,7 +37,13 @@ importers:
        version: 3.8.1
      tsup:
        specifier: ^8.5.1
-        version: 8.5.1(typescript@5.9.3)
+        version: 8.5.1(typescript@5.9.3)(yaml@2.9.0)
+      typedoc:
+        specifier: ^0.28.19
+        version: 0.28.19(typescript@5.9.3)
+      typedoc-plugin-markdown:
+        specifier: ^4.11.0
+        version: 4.11.0(typedoc@0.28.19(typescript@5.9.3))
      typescript:
        specifier: ^5.9.3
        version: 5.9.3
@ -70,6 +79,10 @@ packages:
    resolution: {integrity: sha512-bgzyBak43mE+0HhduZX3cvaPjKcggtGGZZMjr35qtYWolsIWgZ9nx7OOswbVYoU35qoUv6rZ0mTK6GbZ8QTYjw==}
    engines: {node: '>=20'}

+  '@bcoe/v8-coverage@1.0.2':
+    resolution: {integrity: sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA==}
+    engines: {node: '>=18'}
+
  '@esbuild/aix-ppc64@0.27.3':
    resolution: {integrity: sha512-9fJMTNFTWZMh5qwrBItuziu834eOCUcEqymSH7pY+zoMVEZg3gcPuBNxH1EvfVYe9h0x/Ptw8KBzv7qxb7l8dg==}
    engines: {node: '>=18'}
@ -265,6 +278,9 @@ packages:
    resolution: {integrity: sha512-iH1B076HoAshH1mLpHMgwdGeTs0CYwL0SPMkGuSebZrwBp16v415e9NZXg2jtrqPVQjf6IANe2Vtlr5KswtcZQ==}
    engines: {node: ^20.19.0 || ^22.13.0 || >=24}

+  '@gerrit0/mini-shiki@3.23.0':
+    resolution: {integrity: sha512-bEMORlG0cqdjVyCEuU0cDQbORWX+kYCeo0kV1lbxF5bt4r7SID2l9bqsxJEM0zndaxpOUT7riCyIVEuqq/Ynxg==}
+
  '@humanfs/core@0.19.1':
    resolution: {integrity: sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==}
    engines: {node: '>=18.18.0'}
@ -281,6 +297,14 @@ packages:
    resolution: {integrity: sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==}
    engines: {node: '>=18.18'}

+  '@isaacs/cliui@8.0.2':
+    resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==}
+    engines: {node: '>=12'}
+
+  '@istanbuljs/schema@0.1.6':
+    resolution: {integrity: sha512-+Sg6GCR/wy1oSmQDFq4LQDAhm3ETKnorxN+y5nbLULOR3P0c14f2Wurzj3/xqPXtasLFfHd5iRFQ7AJt4KH2cw==}
+    engines: {node: '>=8'}
+
  '@jridgewell/gen-mapping@0.3.13':
    resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==}

@ -294,6 +318,10 @@ packages:
  '@jridgewell/trace-mapping@0.3.31':
    resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}

+  '@pkgjs/parseargs@0.11.0':
+    resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==}
+    engines: {node: '>=14'}
+
  '@rollup/rollup-android-arm-eabi@4.59.0':
    resolution: {integrity: sha512-upnNBkA6ZH2VKGcBj9Fyl9IGNPULcjXRlg0LLeaioQWueH30p6IXtJEbKAgvyv+mJaMxSm1l6xwDXYjpEMiLMg==}
    cpu: [arm]
@ -419,18 +447,42 @@ packages:
    cpu: [x64]
    os: [win32]

+  '@shikijs/engine-oniguruma@3.23.0':
+    resolution: {integrity: sha512-1nWINwKXxKKLqPibT5f4pAFLej9oZzQTsby8942OTlsJzOBZ0MWKiwzMsd+jhzu8YPCHAswGnnN1YtQfirL35g==}
+
+  '@shikijs/langs@3.23.0':
+    resolution: {integrity: sha512-2Ep4W3Re5aB1/62RSYQInK9mM3HsLeB91cHqznAJMuylqjzNVAVCMnNWRHFtcNHXsoNRayP9z1qj4Sq3nMqYXg==}
+
+  '@shikijs/themes@3.23.0':
+    resolution: {integrity: sha512-5qySYa1ZgAT18HR/ypENL9cUSGOeI2x+4IvYJu4JgVJdizn6kG4ia5Q1jDEOi7gTbN4RbuYtmHh0W3eccOrjMA==}
+
+  '@shikijs/types@3.23.0':
+    resolution: {integrity: sha512-3JZ5HXOZfYjsYSk0yPwBrkupyYSLpAE26Qc0HLghhZNGTZg/SKxXIIgoxOpmmeQP0RRSDJTk1/vPfw9tbw+jSQ==}
+
+  '@shikijs/vscode-textmate@10.0.2':
+    resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==}
+
  '@types/esrecurse@4.3.1':
    resolution: {integrity: sha512-xJBAbDifo5hpffDBuHl0Y8ywswbiAp/Wi7Y/GtAgSlZyIABppyurxVueOPE8LUQOxdlgi6Zqce7uoEpqNTeiUw==}

  '@types/estree@1.0.8':
    resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}

+  '@types/hast@3.0.4':
+    resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==}
+
+  '@types/istanbul-lib-coverage@2.0.6':
+    resolution: {integrity: sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==}
+
  '@types/json-schema@7.0.15':
    resolution: {integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==}

  '@types/node@25.3.0':
    resolution: {integrity: sha512-4K3bqJpXpqfg2XKGK9bpDTc6xO/xoUP/RBWS7AtRMug6zZFaRekiLzjVtAoZMquxoAbzBvy5nxQ7veS5eYzf8A==}

+  '@types/unist@3.0.3':
+    resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==}
+
  '@typescript-eslint/eslint-plugin@8.56.1':
    resolution: {integrity: sha512-Jz9ZztpB37dNC+HU2HI28Bs9QXpzCz+y/twHOwhyrIRdbuVDxSytJNDl6z/aAKlaRIwC7y8wJdkBv7FxYGgi0A==}
    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
@ -503,23 +555,62 @@ packages:
  ajv@6.14.0:
    resolution: {integrity: sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==}

+  ansi-regex@5.0.1:
+    resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
+    engines: {node: '>=8'}
+
+  ansi-regex@6.2.2:
+    resolution: {integrity: sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==}
+    engines: {node: '>=12'}
+
+  ansi-styles@4.3.0:
+    resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
+    engines: {node: '>=8'}
+
+  ansi-styles@6.2.3:
+    resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==}
+    engines: {node: '>=12'}
+
  any-promise@1.3.0:
    resolution: {integrity: sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==}

+  argparse@2.0.1:
+    resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
+
+  balanced-match@1.0.2:
+    resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
+
  balanced-match@4.0.4:
    resolution: {integrity: sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==}
    engines: {node: 18 || 20 || >=22}

+  brace-expansion@2.1.1:
+    resolution: {integrity: sha512-WR1cURNjuvBLMZBMbqM0UoE+WAfdUcEV1ccD8PVBVOI+Z3ND4+SZbN8RsfT2bMuG1qwz5RFvPukSZm5fF2D5eA==}
+
  brace-expansion@5.0.4:
    resolution: {integrity: sha512-h+DEnpVvxmfVefa4jFbCf5HdH5YMDXRsmKflpf1pILZWRFlTbJpxeU55nJl4Smt5HQaGzg1o6RHFPJaOqnmBDg==}
    engines: {node: 18 || 20 || >=22}

+  brace-expansion@5.0.6:
+    resolution: {integrity: sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==}
+    engines: {node: 18 || 20 || >=22}
+
  bundle-require@5.1.0:
    resolution: {integrity: sha512-3WrrOuZiyaaZPWiEt4G3+IffISVC9HYlWueJEBWED4ZH4aIAC2PnkdnuRrR94M+w6yGWn4AglWtJtBI8YqvgoA==}
    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
    peerDependencies:
      esbuild: '>=0.18'

+  c8@10.1.3:
+    resolution: {integrity: sha512-LvcyrOAaOnrrlMpW22n690PUvxiq4Uf9WMhQwNJ9vgagkL/ph1+D4uvjvDA5XCbykrc0sx+ay6pVi9YZ1GnhyA==}
+    engines: {node: '>=18'}
+    hasBin: true
+    peerDependencies:
+      monocart-coverage-reports: ^2
+    peerDependenciesMeta:
+      monocart-coverage-reports:
+        optional: true
+
  cac@6.7.14:
    resolution: {integrity: sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==}
    engines: {node: '>=8'}
@ -528,6 +619,17 @@ packages:
    resolution: {integrity: sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==}
    engines: {node: '>= 14.16.0'}

+  cliui@8.0.1:
+    resolution: {integrity: sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==}
+    engines: {node: '>=12'}
+
+  color-convert@2.0.1:
+    resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
+    engines: {node: '>=7.0.0'}
+
+  color-name@1.1.4:
+    resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
+
  commander@4.1.1:
    resolution: {integrity: sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==}
    engines: {node: '>= 6'}
@ -539,6 +641,9 @@ packages:
    resolution: {integrity: sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA==}
    engines: {node: ^14.18.0 || >=16.10.0}

+  convert-source-map@2.0.0:
+    resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}
+
  cross-spawn@7.0.6:
    resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==}
    engines: {node: '>= 8'}
@ -555,11 +660,28 @@ packages:
  deep-is@0.1.4:
    resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==}

+  eastasianwidth@0.2.0:
+    resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}
+
+  emoji-regex@8.0.0:
+    resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}
+
+  emoji-regex@9.2.2:
+    resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==}
+
+  entities@4.5.0:
+    resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==}
+    engines: {node: '>=0.12'}
+
  esbuild@0.27.3:
    resolution: {integrity: sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==}
    engines: {node: '>=18'}
    hasBin: true

+  escalade@3.2.0:
+    resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==}
+    engines: {node: '>=6'}
+
  escape-string-regexp@4.0.0:
    resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==}
    engines: {node: '>=10'}
@ -648,15 +770,35 @@ packages:
  flatted@3.3.4:
    resolution: {integrity: sha512-3+mMldrTAPdta5kjX2G2J7iX4zxtnwpdA8Tr2ZSjkyPSanvbZAcy6flmtnXbEybHrDcU9641lxrMfFuUxVz9vA==}

+  foreground-child@3.3.1:
+    resolution: {integrity: sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==}
+    engines: {node: '>=14'}
+
  fsevents@2.3.3:
    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
    os: [darwin]

+  get-caller-file@2.0.5:
+    resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==}
+    engines: {node: 6.* || 8.* || >= 10.*}
+
  glob-parent@6.0.2:
    resolution: {integrity: sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==}
    engines: {node: '>=10.13.0'}

+  glob@10.5.0:
+    resolution: {integrity: sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==}
+    deprecated: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me
+    hasBin: true
+
+  has-flag@4.0.0:
+    resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
+    engines: {node: '>=8'}
+
+  html-escaper@2.0.2:
+    resolution: {integrity: sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==}
+
  ignore@5.3.2:
    resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==}
    engines: {node: '>= 4'}
@ -673,6 +815,10 @@ packages:
    resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
    engines: {node: '>=0.10.0'}

+  is-fullwidth-code-point@3.0.0:
+    resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}
+    engines: {node: '>=8'}
+
  is-glob@4.0.3:
    resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
    engines: {node: '>=0.10.0'}
@ -680,6 +826,21 @@ packages:
  isexe@2.0.0:
    resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}

+  istanbul-lib-coverage@3.2.2:
+    resolution: {integrity: sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==}
+    engines: {node: '>=8'}
+
+  istanbul-lib-report@3.0.1:
+    resolution: {integrity: sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==}
+    engines: {node: '>=10'}
+
+  istanbul-reports@3.2.0:
+    resolution: {integrity: sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==}
+    engines: {node: '>=8'}
+
+  jackspeak@3.4.3:
+    resolution: {integrity: sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==}
+
  joycon@3.1.1:
    resolution: {integrity: sha512-34wB/Y7MW7bzjKRjUKTa46I2Z7eV62Rkhva+KkopW7Qvv/OSWBqvkSY7vusOPrNuZcUG3tApvdVgNB8POj3SPw==}
    engines: {node: '>=10'}
@ -707,6 +868,9 @@ packages:
  lines-and-columns@1.2.4:
    resolution: {integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==}

+  linkify-it@5.0.1:
+    resolution: {integrity: sha512-wVoTjP4Q6R0NW5hiZkVJaFZPWgtXfoGF+6LucL3/FtiNjmcHhYjEr5f1Kqjirc1nBW07J/ZuRFumqr2oqccEWg==}
+
  load-tsconfig@0.2.5:
    resolution: {integrity: sha512-IXO6OCs9yg8tMKzfPZ1YmheJbZCiEsnBdcB03l0OcfK9prKnJb96siuHCr5Fl37/yo9DnKU+TLpxzTUspw9shg==}
    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
@ -715,13 +879,42 @@ packages:
    resolution: {integrity: sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==}
    engines: {node: '>=10'}

+  lru-cache@10.4.3:
+    resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}
+
+  lunr@2.3.9:
+    resolution: {integrity: sha512-zTU3DaZaF3Rt9rhN3uBMGQD3dD2/vFQqnvZCDv4dl5iOzq2IZQqTxu90r4E5J+nP70J3ilqVCrbho2eWaeW8Ow==}
+
  magic-string@0.30.21:
    resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}

+  make-dir@4.0.0:
+    resolution: {integrity: sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==}
+    engines: {node: '>=10'}
+
+  markdown-it@14.2.0:
+    resolution: {integrity: sha512-1TGiQiJVRQ3NPmZH6sx5Cfnmg6GQm9jvC1ch4TK511NjSJvjzKLzn5pPfZRNZkRPZP0HqCioSndqH8v2nRaWVQ==}
+    hasBin: true
+
+  mdurl@2.0.0:
+    resolution: {integrity: sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w==}
+
  minimatch@10.2.4:
    resolution: {integrity: sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==}
    engines: {node: 18 || 20 || >=22}

+  minimatch@10.2.5:
+    resolution: {integrity: sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==}
+    engines: {node: 18 || 20 || >=22}
+
+  minimatch@9.0.9:
+    resolution: {integrity: sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==}
+    engines: {node: '>=16 || 14 >=14.17'}
+
+  minipass@7.1.3:
+    resolution: {integrity: sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==}
+    engines: {node: '>=16 || 14 >=14.17'}
+
  mlly@1.8.0:
    resolution: {integrity: sha512-l8D9ODSRWLe2KHJSifWGwBqpTZXIXTeo8mlKjY+E2HAakaTeNpqAyBZ8GSqLzHgw4XmHmC8whvpjJNMbFZN7/g==}

@ -750,6 +943,9 @@ packages:
    resolution: {integrity: sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==}
    engines: {node: '>=10'}

+  package-json-from-dist@1.0.1:
+    resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==}
+
  path-exists@4.0.0:
    resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==}
    engines: {node: '>=8'}
@ -758,6 +954,10 @@ packages:
    resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==}
    engines: {node: '>=8'}

+  path-scurry@1.11.1:
+    resolution: {integrity: sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==}
+    engines: {node: '>=16 || 14 >=14.18'}
+
  pathe@2.0.3:
    resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}

@ -802,6 +1002,10 @@ packages:
    engines: {node: '>=14'}
    hasBin: true

+  punycode.js@2.3.1:
+    resolution: {integrity: sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA==}
+    engines: {node: '>=6'}
+
  punycode@2.3.1:
    resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==}
    engines: {node: '>=6'}
@ -810,6 +1014,10 @@ packages:
    resolution: {integrity: sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==}
    engines: {node: '>= 14.18.0'}

+  require-directory@2.1.1:
+    resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==}
+    engines: {node: '>=0.10.0'}
+
  resolve-from@5.0.0:
    resolution: {integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==}
    engines: {node: '>=8'}
@ -832,15 +1040,43 @@ packages:
    resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
    engines: {node: '>=8'}

+  signal-exit@4.1.0:
+    resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==}
+    engines: {node: '>=14'}
+
  source-map@0.7.6:
    resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==}
    engines: {node: '>= 12'}

+  string-width@4.2.3:
+    resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==}
+    engines: {node: '>=8'}
+
+  string-width@5.1.2:
+    resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==}
+    engines: {node: '>=12'}
+
+  strip-ansi@6.0.1:
+    resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
+    engines: {node: '>=8'}
+
+  strip-ansi@7.2.0:
+    resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==}
+    engines: {node: '>=12'}
+
  sucrase@3.35.1:
    resolution: {integrity: sha512-DhuTmvZWux4H1UOnWMB3sk0sbaCVOoQZjv8u1rDoTV0HTdGem9hkAZtl4JZy8P2z4Bg0nT+YMeOFyVr4zcG5Tw==}
    engines: {node: '>=16 || 14 >=14.17'}
    hasBin: true

+  supports-color@7.2.0:
+    resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
+    engines: {node: '>=8'}
+
+  test-exclude@7.0.2:
+    resolution: {integrity: sha512-u9E6A+ZDYdp7a4WnarkXPZOx8Ilz46+kby6p1yZ8zsGTz9gYa6FIS7lj2oezzNKmtdyyJNNmmXDppga5GB7kSw==}
+    engines: {node: '>=18'}
+
  thenify-all@1.6.0:
    resolution: {integrity: sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==}
    engines: {node: '>=0.8'}
@ -891,6 +1127,19 @@ packages:
    resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==}
    engines: {node: '>= 0.8.0'}

+  typedoc-plugin-markdown@4.11.0:
+    resolution: {integrity: sha512-2iunh2ALyfyh204OF7h2u0kuQ84xB3jFZtFyUr01nThJkLvR8oGGSSDlyt2gyO4kXhvUxDcVbO0y43+qX+wFbw==}
+    engines: {node: '>= 18'}
+    peerDependencies:
+      typedoc: 0.28.x
+
+  typedoc@0.28.19:
+    resolution: {integrity: sha512-wKh+lhdmMFivMlc6vRRcMGXeGEHGU2g8a2CkPTJjJlwRf1iXbimWIPcFolCqe4E0d/FRtGszpIrsp3WLpDB8Pw==}
+    engines: {node: '>= 18', pnpm: '>= 10'}
+    hasBin: true
+    peerDependencies:
+      typescript: 5.0.x || 5.1.x || 5.2.x || 5.3.x || 5.4.x || 5.5.x || 5.6.x || 5.7.x || 5.8.x || 5.9.x || 6.0.x
+
  typescript-eslint@8.56.1:
    resolution: {integrity: sha512-U4lM6pjmBX7J5wk4szltF7I1cGBHXZopnAXCMXb3+fZ3B/0Z3hq3wS/CCUB2NZBNAExK92mCU2tEohWuwVMsDQ==}
    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
@ -903,6 +1152,9 @@ packages:
    engines: {node: '>=14.17'}
    hasBin: true

+  uc.micro@2.1.0:
+    resolution: {integrity: sha512-ARDJmphmdvUk6Glw7y9DQ2bFkKBHwQHLi2lsaH6PPmz/Ka9sFOBsBluozhDltWmnv9u/cF6Rt87znRTPV+yp/A==}
+
  ufo@1.6.3:
    resolution: {integrity: sha512-yDJTmhydvl5lJzBmy/hyOAA0d+aqCBuwl818haVdYCRrWV84o7YyeVm4QlVHStqNrrJSTb6jKuFAVqAFsr+K3Q==}

@ -912,6 +1164,10 @@ packages:
  uri-js@4.4.1:
    resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==}

+  v8-to-istanbul@9.3.0:
+    resolution: {integrity: sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==}
+    engines: {node: '>=10.12.0'}
+
  which@2.0.2:
    resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==}
    engines: {node: '>= 8'}
@ -921,6 +1177,31 @@ packages:
    resolution: {integrity: sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==}
    engines: {node: '>=0.10.0'}

+  wrap-ansi@7.0.0:
+    resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==}
+    engines: {node: '>=10'}
+
+  wrap-ansi@8.1.0:
+    resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==}
+    engines: {node: '>=12'}
+
+  y18n@5.0.8:
+    resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==}
+    engines: {node: '>=10'}
+
+  yaml@2.9.0:
+    resolution: {integrity: sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==}
+    engines: {node: '>= 14.6'}
+    hasBin: true
+
+  yargs-parser@21.1.1:
+    resolution: {integrity: sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==}
+    engines: {node: '>=12'}
+
+  yargs@17.7.2:
+    resolution: {integrity: sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==}
+    engines: {node: '>=12'}
+
  yocto-queue@0.1.0:
    resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
    engines: {node: '>=10'}
@ -940,6 +1221,8 @@ snapshots:

  '@acamarata/tsconfig@0.1.0': {}

+  '@bcoe/v8-coverage@1.0.2': {}
+
  '@esbuild/aix-ppc64@0.27.3':
    optional: true

@ -1052,6 +1335,14 @@ snapshots:
      '@eslint/core': 1.1.1
      levn: 0.4.1

+  '@gerrit0/mini-shiki@3.23.0':
+    dependencies:
+      '@shikijs/engine-oniguruma': 3.23.0
+      '@shikijs/langs': 3.23.0
+      '@shikijs/themes': 3.23.0
+      '@shikijs/types': 3.23.0
+      '@shikijs/vscode-textmate': 10.0.2
+
  '@humanfs/core@0.19.1': {}

  '@humanfs/node@0.16.7':
@ -1063,6 +1354,17 @@ snapshots:

  '@humanwhocodes/retry@0.4.3': {}

+  '@isaacs/cliui@8.0.2':
+    dependencies:
+      string-width: 5.1.2
+      string-width-cjs: string-width@4.2.3
+      strip-ansi: 7.2.0
+      strip-ansi-cjs: strip-ansi@6.0.1
+      wrap-ansi: 8.1.0
+      wrap-ansi-cjs: wrap-ansi@7.0.0
+
+  '@istanbuljs/schema@0.1.6': {}
+
  '@jridgewell/gen-mapping@0.3.13':
    dependencies:
      '@jridgewell/sourcemap-codec': 1.5.5
@ -1077,6 +1379,9 @@ snapshots:
      '@jridgewell/resolve-uri': 3.1.2
      '@jridgewell/sourcemap-codec': 1.5.5

+  '@pkgjs/parseargs@0.11.0':
+    optional: true
+
  '@rollup/rollup-android-arm-eabi@4.59.0':
    optional: true

@ -1152,16 +1457,44 @@ snapshots:
  '@rollup/rollup-win32-x64-msvc@4.59.0':
    optional: true

+  '@shikijs/engine-oniguruma@3.23.0':
+    dependencies:
+      '@shikijs/types': 3.23.0
+      '@shikijs/vscode-textmate': 10.0.2
+
+  '@shikijs/langs@3.23.0':
+    dependencies:
+      '@shikijs/types': 3.23.0
+
+  '@shikijs/themes@3.23.0':
+    dependencies:
+      '@shikijs/types': 3.23.0
+
+  '@shikijs/types@3.23.0':
+    dependencies:
+      '@shikijs/vscode-textmate': 10.0.2
+      '@types/hast': 3.0.4
+
+  '@shikijs/vscode-textmate@10.0.2': {}
+
  '@types/esrecurse@4.3.1': {}

  '@types/estree@1.0.8': {}

+  '@types/hast@3.0.4':
+    dependencies:
+      '@types/unist': 3.0.3
+
+  '@types/istanbul-lib-coverage@2.0.6': {}
+
  '@types/json-schema@7.0.15': {}

  '@types/node@25.3.0':
    dependencies:
      undici-types: 7.18.2

+  '@types/unist@3.0.3': {}
+
  '@typescript-eslint/eslint-plugin@8.56.1(@typescript-eslint/parser@8.56.1(eslint@10.0.3)(typescript@5.9.3))(eslint@10.0.3)(typescript@5.9.3)':
    dependencies:
      '@eslint-community/regexpp': 4.12.2
@ -1266,31 +1599,81 @@ snapshots:
      json-schema-traverse: 0.4.1
      uri-js: 4.4.1

+  ansi-regex@5.0.1: {}
+
+  ansi-regex@6.2.2: {}
+
+  ansi-styles@4.3.0:
+    dependencies:
+      color-convert: 2.0.1
+
+  ansi-styles@6.2.3: {}
+
  any-promise@1.3.0: {}

+  argparse@2.0.1: {}
+
+  balanced-match@1.0.2: {}
+
  balanced-match@4.0.4: {}

+  brace-expansion@2.1.1:
+    dependencies:
+      balanced-match: 1.0.2
+
  brace-expansion@5.0.4:
    dependencies:
      balanced-match: 4.0.4

+  brace-expansion@5.0.6:
+    dependencies:
+      balanced-match: 4.0.4
+
  bundle-require@5.1.0(esbuild@0.27.3):
    dependencies:
      esbuild: 0.27.3
      load-tsconfig: 0.2.5

+  c8@10.1.3:
+    dependencies:
+      '@bcoe/v8-coverage': 1.0.2
+      '@istanbuljs/schema': 0.1.6
+      find-up: 5.0.0
+      foreground-child: 3.3.1
+      istanbul-lib-coverage: 3.2.2
+      istanbul-lib-report: 3.0.1
+      istanbul-reports: 3.2.0
+      test-exclude: 7.0.2
+      v8-to-istanbul: 9.3.0
+      yargs: 17.7.2
+      yargs-parser: 21.1.1
+
  cac@6.7.14: {}

  chokidar@4.0.3:
    dependencies:
      readdirp: 4.1.2

+  cliui@8.0.1:
+    dependencies:
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+      wrap-ansi: 7.0.0
+
+  color-convert@2.0.1:
+    dependencies:
+      color-name: 1.1.4
+
+  color-name@1.1.4: {}
+
  commander@4.1.1: {}

  confbox@0.1.8: {}

  consola@3.4.2: {}

+  convert-source-map@2.0.0: {}
+
  cross-spawn@7.0.6:
    dependencies:
      path-key: 3.1.1
@ -1303,6 +1686,14 @@ snapshots:

  deep-is@0.1.4: {}

+  eastasianwidth@0.2.0: {}
+
+  emoji-regex@8.0.0: {}
+
+  emoji-regex@9.2.2: {}
+
+  entities@4.5.0: {}
+
  esbuild@0.27.3:
    optionalDependencies:
      '@esbuild/aix-ppc64': 0.27.3
@ -1332,6 +1723,8 @@ snapshots:
      '@esbuild/win32-ia32': 0.27.3
      '@esbuild/win32-x64': 0.27.3

+  escalade@3.2.0: {}
+
  escape-string-regexp@4.0.0: {}

  eslint-config-prettier@10.1.8(eslint@10.0.3):
@ -1434,13 +1827,33 @@ snapshots:

  flatted@3.3.4: {}

+  foreground-child@3.3.1:
+    dependencies:
+      cross-spawn: 7.0.6
+      signal-exit: 4.1.0
+
  fsevents@2.3.3:
    optional: true

+  get-caller-file@2.0.5: {}
+
  glob-parent@6.0.2:
    dependencies:
      is-glob: 4.0.3

+  glob@10.5.0:
+    dependencies:
+      foreground-child: 3.3.1
+      jackspeak: 3.4.3
+      minimatch: 9.0.9
+      minipass: 7.1.3
+      package-json-from-dist: 1.0.1
+      path-scurry: 1.11.1
+
+  has-flag@4.0.0: {}
+
+  html-escaper@2.0.2: {}
+
  ignore@5.3.2: {}

  ignore@7.0.5: {}
@ -1449,12 +1862,33 @@ snapshots:

  is-extglob@2.1.1: {}

+  is-fullwidth-code-point@3.0.0: {}
+
  is-glob@4.0.3:
    dependencies:
      is-extglob: 2.1.1

  isexe@2.0.0: {}

+  istanbul-lib-coverage@3.2.2: {}
+
+  istanbul-lib-report@3.0.1:
+    dependencies:
+      istanbul-lib-coverage: 3.2.2
+      make-dir: 4.0.0
+      supports-color: 7.2.0
+
+  istanbul-reports@3.2.0:
+    dependencies:
+      html-escaper: 2.0.2
+      istanbul-lib-report: 3.0.1
+
+  jackspeak@3.4.3:
+    dependencies:
+      '@isaacs/cliui': 8.0.2
+    optionalDependencies:
+      '@pkgjs/parseargs': 0.11.0
+
  joycon@3.1.1: {}

  json-buffer@3.0.1: {}
@ -1476,20 +1910,53 @@ snapshots:

  lines-and-columns@1.2.4: {}

+  linkify-it@5.0.1:
+    dependencies:
+      uc.micro: 2.1.0
+
  load-tsconfig@0.2.5: {}

  locate-path@6.0.0:
    dependencies:
      p-locate: 5.0.0

+  lru-cache@10.4.3: {}
+
+  lunr@2.3.9: {}
+
  magic-string@0.30.21:
    dependencies:
      '@jridgewell/sourcemap-codec': 1.5.5

+  make-dir@4.0.0:
+    dependencies:
+      semver: 7.7.4
+
+  markdown-it@14.2.0:
+    dependencies:
+      argparse: 2.0.1
+      entities: 4.5.0
+      linkify-it: 5.0.1
+      mdurl: 2.0.0
+      punycode.js: 2.3.1
+      uc.micro: 2.1.0
+
+  mdurl@2.0.0: {}
+
  minimatch@10.2.4:
    dependencies:
      brace-expansion: 5.0.4

+  minimatch@10.2.5:
+    dependencies:
+      brace-expansion: 5.0.6
+
+  minimatch@9.0.9:
+    dependencies:
+      brace-expansion: 2.1.1
+
+  minipass@7.1.3: {}
+
  mlly@1.8.0:
    dependencies:
      acorn: 8.16.0
@ -1526,10 +1993,17 @@ snapshots:
    dependencies:
      p-limit: 3.1.0

+  package-json-from-dist@1.0.1: {}
+
  path-exists@4.0.0: {}

  path-key@3.1.1: {}

+  path-scurry@1.11.1:
+    dependencies:
+      lru-cache: 10.4.3
+      minipass: 7.1.3
+
  pathe@2.0.3: {}

  picocolors@1.1.1: {}
@ -1544,18 +2018,24 @@ snapshots:
      mlly: 1.8.0
      pathe: 2.0.3

-  postcss-load-config@6.0.1:
+  postcss-load-config@6.0.1(yaml@2.9.0):
    dependencies:
      lilconfig: 3.1.3
+    optionalDependencies:
+      yaml: 2.9.0

  prelude-ls@1.2.1: {}

  prettier@3.8.1: {}

+  punycode.js@2.3.1: {}
+
  punycode@2.3.1: {}

  readdirp@4.1.2: {}

+  require-directory@2.1.1: {}
+
  resolve-from@5.0.0: {}

  rollup@4.59.0:
@ -1597,8 +2077,30 @@ snapshots:

  shebang-regex@3.0.0: {}

+  signal-exit@4.1.0: {}
+
  source-map@0.7.6: {}

+  string-width@4.2.3:
+    dependencies:
+      emoji-regex: 8.0.0
+      is-fullwidth-code-point: 3.0.0
+      strip-ansi: 6.0.1
+
+  string-width@5.1.2:
+    dependencies:
+      eastasianwidth: 0.2.0
+      emoji-regex: 9.2.2
+      strip-ansi: 7.2.0
+
+  strip-ansi@6.0.1:
+    dependencies:
+      ansi-regex: 5.0.1
+
+  strip-ansi@7.2.0:
+    dependencies:
+      ansi-regex: 6.2.2
+
  sucrase@3.35.1:
    dependencies:
      '@jridgewell/gen-mapping': 0.3.13
@ -1609,6 +2111,16 @@ snapshots:
      tinyglobby: 0.2.15
      ts-interface-checker: 0.1.13

+  supports-color@7.2.0:
+    dependencies:
+      has-flag: 4.0.0
+
+  test-exclude@7.0.2:
+    dependencies:
+      '@istanbuljs/schema': 0.1.6
+      glob: 10.5.0
+      minimatch: 10.2.4
+
  thenify-all@1.6.0:
    dependencies:
      thenify: 3.3.1
@ -1632,7 +2144,7 @@ snapshots:

  ts-interface-checker@0.1.13: {}

-  tsup@8.5.1(typescript@5.9.3):
+  tsup@8.5.1(typescript@5.9.3)(yaml@2.9.0):
    dependencies:
      bundle-require: 5.1.0(esbuild@0.27.3)
      cac: 6.7.14
@ -1643,7 +2155,7 @@ snapshots:
      fix-dts-default-cjs-exports: 1.0.1
      joycon: 3.1.1
      picocolors: 1.1.1
-      postcss-load-config: 6.0.1
+      postcss-load-config: 6.0.1(yaml@2.9.0)
      resolve-from: 5.0.0
      rollup: 4.59.0
      source-map: 0.7.6
@ -1663,6 +2175,19 @@ snapshots:
    dependencies:
      prelude-ls: 1.2.1

+  typedoc-plugin-markdown@4.11.0(typedoc@0.28.19(typescript@5.9.3)):
+    dependencies:
+      typedoc: 0.28.19(typescript@5.9.3)
+
+  typedoc@0.28.19(typescript@5.9.3):
+    dependencies:
+      '@gerrit0/mini-shiki': 3.23.0
+      lunr: 2.3.9
+      markdown-it: 14.2.0
+      minimatch: 10.2.5
+      typescript: 5.9.3
+      yaml: 2.9.0
+
  typescript-eslint@8.56.1(eslint@10.0.3)(typescript@5.9.3):
    dependencies:
      '@typescript-eslint/eslint-plugin': 8.56.1(@typescript-eslint/parser@8.56.1(eslint@10.0.3)(typescript@5.9.3))(eslint@10.0.3)(typescript@5.9.3)
@ -1676,6 +2201,8 @@ snapshots:

  typescript@5.9.3: {}

+  uc.micro@2.1.0: {}
+
  ufo@1.6.3: {}

  undici-types@7.18.2: {}
@ -1684,10 +2211,44 @@ snapshots:
    dependencies:
      punycode: 2.3.1

+  v8-to-istanbul@9.3.0:
+    dependencies:
+      '@jridgewell/trace-mapping': 0.3.31
+      '@types/istanbul-lib-coverage': 2.0.6
+      convert-source-map: 2.0.0
+
  which@2.0.2:
    dependencies:
      isexe: 2.0.0

  word-wrap@1.2.5: {}

+  wrap-ansi@7.0.0:
+    dependencies:
+      ansi-styles: 4.3.0
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+
+  wrap-ansi@8.1.0:
+    dependencies:
+      ansi-styles: 6.2.3
+      string-width: 5.1.2
+      strip-ansi: 7.2.0
+
+  y18n@5.0.8: {}
+
+  yaml@2.9.0: {}
+
+  yargs-parser@21.1.1: {}
+
+  yargs@17.7.2:
+    dependencies:
+      cliui: 8.0.1
+      escalade: 3.2.0
+      get-caller-file: 2.0.5
+      require-directory: 2.1.1
+      string-width: 4.2.3
+      y18n: 5.0.8
+      yargs-parser: 21.1.1
+
  yocto-queue@0.1.0: {}
--- a/typedoc.json
+++ b/typedoc.json
@ -0,0 +1,10 @@
+{
+  "entryPoints": ["src/index.ts"],
+  "out": ".github/wiki/api",
+  "plugin": ["typedoc-plugin-markdown"],
+  "readme": "none",
+  "skipErrorChecking": true,
+  "excludePrivate": true,
+  "excludeProtected": true,
+  "includeVersion": true
+}