@rybosome/tspice 0.0.7 → 0.0.8

package/dist/kernels/kernels.d.ts

@@ -0,0 +1,98 @@
+import type { KernelPack } from "./kernelPack.js";
+import type { NaifKernelId } from "./naifKernelId.js";
+export type KernelsNaifOptions = {
+    /**
+     * Kernel URL prefix. This is a *build-time* prefix that is concatenated with
+     * each leaf-path kernel id.
+     *
+     * Examples:
+     * - `https://naif.jpl.nasa.gov/pub/naif/generic_kernels/`
+     * - `kernels/naif/` (relative; resolved at load time using `baseUrl`)
+     *
+     * Defaults to NAIF's canonical `generic_kernels` host.
+     */
+    origin?: string;
+    /**
+     * Optional directory-style base used at *load time* to resolve relative
+     * kernel URLs.
+     *
+     * This becomes `KernelPack.baseUrl`.
+     */
+    baseUrl?: string;
+    /**
+     * Base virtual path used when loading kernels into tspice.
+     *
+     * Defaults to `""` so leaf ids map directly to paths like
+     * `"lsk/naif0012.tls"`.
+     */
+    pathBase?: string;
+};
+export type NaifKernelCatalog = {
+    pick(id: NaifKernelId): KernelPack;
+    pick(ids: readonly [NaifKernelId, ...NaifKernelId[]]): KernelPack;
+    pick(first: NaifKernelId, ...rest: readonly NaifKernelId[]): KernelPack;
+};
+export declare const TSPICE_KERNEL_IDS: readonly ["lsk/naif0012.tls", "pck/pck00011.tpc", "spk/planets/de432s.bsp"];
+export type TspiceKernelId = (typeof TSPICE_KERNEL_IDS)[number];
+export type TspiceKernelCatalog = {
+    pick(id: TspiceKernelId): KernelPack;
+    pick(ids: readonly [TspiceKernelId, ...TspiceKernelId[]]): KernelPack;
+    pick(first: TspiceKernelId, ...rest: readonly TspiceKernelId[]): KernelPack;
+};
+export type KernelsCustomOptions = {
+    /** Kernel URL prefix used for string ids (see `pick(...)`). */
+    origin: string;
+    /** Optional base URL used when resolving relative kernel URLs. */
+    baseUrl?: string;
+    /** Virtual path prefix used when mapping string ids to `kernel.path`. */
+    pathBase: string;
+};
+export type CustomKernelEntry = {
+    /** Explicit URL (or URL path) for a kernel. */
+    url: string;
+    /** Explicit virtual path for the kernel (defaults to a stable hashed path). */
+    path?: string;
+};
+export type CustomKernelPick = string | CustomKernelEntry;
+export type CustomKernelCatalogUrlOnly = {
+    pick(entry: CustomKernelEntry): KernelPack;
+    pick(entries: readonly [CustomKernelEntry, ...CustomKernelEntry[]]): KernelPack;
+    pick(first: CustomKernelEntry, ...rest: readonly CustomKernelEntry[]): KernelPack;
+};
+export type CustomKernelCatalog = {
+    pick(id: string): KernelPack;
+    pick(ids: readonly [string, ...string[]]): KernelPack;
+    pick(entries: readonly [CustomKernelPick, ...CustomKernelPick[]]): KernelPack;
+    pick(first: CustomKernelPick, ...rest: readonly CustomKernelPick[]): KernelPack;
+};
+export declare const kernels: {
+    /**
+     * Typed NAIF `generic_kernels` catalog.
+     *
+     * Notes:
+     * - IDs are NAIF leaf paths like `"lsk/naif0012.tls"`.
+     * - `pick(...)` preserves caller-provided ordering.
+     */
+    readonly naif: (opts?: KernelsNaifOptions) => NaifKernelCatalog;
+    /**
+     * Zero-config, browser-friendly curated kernel catalog.
+     *
+     * This is intended for quickstarts/demos and is **not recommended for
+     * production**. For production, self-host kernels (or proxy) and use
+     * `kernels.naif()`/`kernels.naif({ origin?, pathBase?, baseUrl? })` or
+     * `kernels.custom(...)`.
+     */
+    readonly tspice: () => TspiceKernelCatalog;
+    /**
+     * Configurable catalog for application/mission-specific kernels.
+     *
+     * - String ids are mapped as `{ url: origin + id, path: pathBase + id }`.
+     * - Explicit `{ url, path? }` entries are passed through; when `path` is
+     *   omitted it defaults to a stable hashed path.
+     */
+    readonly custom: {
+        (): CustomKernelCatalogUrlOnly;
+        (opts: KernelsCustomOptions): CustomKernelCatalog;
+    };
+};
+//# sourceMappingURL=kernels.d.ts.map

package/dist/kernels/kernels.js

@@ -0,0 +1,217 @@
+import { defaultKernelPathFromUrl } from "./defaultKernelPathFromUrl.js";
+function ensureTrailingSlash(base) {
+    if (base === "")
+        return "";
+    return base.endsWith("/") ? base : `${base}/`;
+}
+const ABSOLUTE_URL_RE = /^[A-Za-z][A-Za-z\d+.-]*:/;
+function isAbsoluteKernelUrlPrefix(kernelUrlPrefix) {
+    if (kernelUrlPrefix.startsWith("//")) {
+        throw new Error(`kernels.*(): protocol-relative URLs (\"//...\") are not supported in Node. ` +
+            `Node requires scheme-based URLs like \"https://...\". Got: ${kernelUrlPrefix}`);
+    }
+    return ABSOLUTE_URL_RE.test(kernelUrlPrefix);
+}
+function normalizeOrigin(origin) {
+    // Allow empty string (caller may want to provide fully-qualified IDs), but
+    // reject whitespace-only values which are almost always mistakes.
+    if (origin === "")
+        return "";
+    const trimmed = origin.trim();
+    if (!trimmed) {
+        throw new Error("kernels.*(): origin cannot be blank/whitespace");
+    }
+    return ensureTrailingSlash(trimmed);
+}
+function normalizePathBase(pathBase) {
+    // Allow empty string (no virtual path prefix), but reject whitespace-only.
+    if (pathBase === "")
+        return "";
+    const trimmed = pathBase.trim();
+    if (!trimmed) {
+        throw new Error("kernels.*(): pathBase cannot be blank/whitespace");
+    }
+    return ensureTrailingSlash(trimmed);
+}
+function normalizeOptionalBaseUrl(baseUrl) {
+    const trimmed = baseUrl?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function assertDirectoryStyleBaseUrl(baseUrl) {
+    const isProtocolRelative = baseUrl.startsWith("//");
+    const hasScheme = ABSOLUTE_URL_RE.test(baseUrl);
+    if (hasScheme || isProtocolRelative) {
+        const base = hasScheme ? new URL(baseUrl) : new URL(baseUrl, "https://tspice.invalid");
+        if (!base.pathname.endsWith("/")) {
+            throw new Error(`kernels.*(): absolute baseUrl must be directory-style (pathname must end with "/"): ${baseUrl}`);
+        }
+        return;
+    }
+    if (baseUrl.startsWith("/")) {
+        const base = new URL(baseUrl, "https://tspice.invalid");
+        if (!base.pathname.endsWith("/")) {
+            throw new Error(`kernels.*(): path-absolute baseUrl must be directory-style (pathname must end with "/"): ${baseUrl}`);
+        }
+        return;
+    }
+    if (!baseUrl.endsWith("/")) {
+        throw new Error(`kernels.*(): baseUrl must be directory-style (end with "/"): ${baseUrl}`);
+    }
+}
+function normalizePickArgs(first, rest) {
+    if (first === undefined) {
+        throw new Error("pick(): expected at least one id/entry");
+    }
+    if (Array.isArray(first)) {
+        if (rest.length) {
+            throw new Error("pick(): when passing an array, do not pass additional arguments");
+        }
+        if (first.length === 0) {
+            throw new Error("pick(): expected at least one id/entry");
+        }
+        // Defensive copy to avoid time-of-check/time-of-use surprises if the caller
+        // mutates their input array while `pick()` is processing.
+        return [...first];
+    }
+    // TS can't fully narrow `first` to `T` here because `T` itself could be an
+    // array type. In practice our `pick` ids/entries are never arrays.
+    return [first, ...rest];
+}
+function dedupePreserveOrder(items, key) {
+    const out = [];
+    const seen = new Set();
+    for (const item of items) {
+        const k = key(item);
+        if (seen.has(k))
+            continue;
+        seen.add(k);
+        out.push(item);
+    }
+    return out;
+}
+const DEFAULT_NAIF_ORIGIN = "https://naif.jpl.nasa.gov/pub/naif/generic_kernels/";
+const DEFAULT_NAIF_PATH_BASE = "";
+// --- tspice (curated) ---
+const DEFAULT_TSPICE_ORIGIN = "https://tspice-viewer.ryboso.me/kernels/naif/";
+const DEFAULT_TSPICE_PATH_BASE = "naif/";
+export const TSPICE_KERNEL_IDS = [
+    // Load order matters (LSK -> PCK -> SPK), but we do **not** reorder; callers
+    // can intentionally change ordering if they need to.
+    "lsk/naif0012.tls",
+    "pck/pck00011.tpc",
+    "spk/planets/de432s.bsp",
+];
+function buildLeafPathKernel(id, opts) {
+    return {
+        url: `${opts.origin}${id}`,
+        path: `${opts.pathBase}${id}`,
+    };
+}
+export const kernels = {
+    /**
+     * Typed NAIF `generic_kernels` catalog.
+     *
+     * Notes:
+     * - IDs are NAIF leaf paths like `"lsk/naif0012.tls"`.
+     * - `pick(...)` preserves caller-provided ordering.
+     */
+    naif: (opts) => {
+        const origin = normalizeOrigin(opts?.origin ?? DEFAULT_NAIF_ORIGIN);
+        const pathBase = normalizePathBase(opts?.pathBase ?? DEFAULT_NAIF_PATH_BASE);
+        const rawBaseUrl = normalizeOptionalBaseUrl(opts?.baseUrl);
+        const baseUrl = isAbsoluteKernelUrlPrefix(origin) ? undefined : rawBaseUrl;
+        if (baseUrl !== undefined) {
+            assertDirectoryStyleBaseUrl(baseUrl);
+        }
+        const pickImpl = (first, rest) => {
+            const ids = dedupePreserveOrder(normalizePickArgs(first, rest), (id) => id);
+            return {
+                ...(baseUrl === undefined ? {} : { baseUrl }),
+                kernels: ids.map((id) => buildLeafPathKernel(id, { origin, pathBase })),
+            };
+        };
+        return {
+            pick: ((first, ...rest) => pickImpl(first, rest)),
+        };
+    },
+    /**
+     * Zero-config, browser-friendly curated kernel catalog.
+     *
+     * This is intended for quickstarts/demos and is **not recommended for
+     * production**. For production, self-host kernels (or proxy) and use
+     * `kernels.naif()`/`kernels.naif({ origin?, pathBase?, baseUrl? })` or
+     * `kernels.custom(...)`.
+     */
+    tspice: () => {
+        const origin = ensureTrailingSlash(DEFAULT_TSPICE_ORIGIN);
+        const pathBase = ensureTrailingSlash(DEFAULT_TSPICE_PATH_BASE);
+        const allowed = new Set(TSPICE_KERNEL_IDS);
+        const pickImpl = (first, rest) => {
+            const ids = dedupePreserveOrder(normalizePickArgs(first, rest), (id) => id);
+            for (const id of ids) {
+                if (!allowed.has(id)) {
+                    throw new Error(`kernels.tspice().pick(): unknown id ${JSON.stringify(id)}. ` +
+                        `This catalog is intentionally small. For the full NAIF inventory, use kernels.naif().pick(...).`);
+                }
+            }
+            return {
+                kernels: ids.map((id) => buildLeafPathKernel(id, { origin, pathBase })),
+            };
+        };
+        return {
+            pick: ((first, ...rest) => pickImpl(first, rest)),
+        };
+    },
+    /**
+     * Configurable catalog for application/mission-specific kernels.
+     *
+     * - String ids are mapped as `{ url: origin + id, path: pathBase + id }`.
+     * - Explicit `{ url, path? }` entries are passed through; when `path` is
+     *   omitted it defaults to a stable hashed path.
+     */
+    custom: (() => {
+        function custom(opts) {
+            const origin = opts === undefined ? undefined : normalizeOrigin(opts.origin);
+            const pathBase = opts === undefined ? undefined : normalizePathBase(opts.pathBase);
+            const rawBaseUrl = opts === undefined ? undefined : normalizeOptionalBaseUrl(opts.baseUrl);
+            const pickImplWithOpts = (first, rest) => {
+                const entries = dedupePreserveOrder(normalizePickArgs(first, rest), (entry) => (typeof entry === "string" ? `id:${entry}` : `url:${entry.url}`));
+                const kernelsOut = entries.map((entry) => {
+                    if (typeof entry === "string") {
+                        // Safety guard: callers can always bypass TS.
+                        if (origin === undefined || pathBase === undefined) {
+                            throw new Error("kernels.custom().pick(): string ids require kernels.custom({ origin, pathBase, baseUrl? })");
+                        }
+                        return buildLeafPathKernel(entry, { origin, pathBase });
+                    }
+                    return {
+                        url: entry.url,
+                        path: entry.path ?? defaultKernelPathFromUrl(entry.url),
+                    };
+                });
+                // If the pack contains any relative-ish kernel URLs (including root-relative
+                // `/...`), include the configured baseUrl so load-time resolution works.
+                const baseUrl = rawBaseUrl !== undefined && kernelsOut.some((k) => !isAbsoluteKernelUrlPrefix(k.url))
+                    ? rawBaseUrl
+                    : undefined;
+                if (baseUrl !== undefined) {
+                    assertDirectoryStyleBaseUrl(baseUrl);
+                }
+                return {
+                    ...(baseUrl === undefined ? {} : { baseUrl }),
+                    kernels: kernelsOut,
+                };
+            };
+            if (opts === undefined) {
+                return {
+                    pick: ((first, ...rest) => pickImplWithOpts(first, rest)),
+                };
+            }
+            return {
+                pick: ((first, ...rest) => pickImplWithOpts(first, rest)),
+            };
+        }
+        return custom;
+    })(),
+};
+//# sourceMappingURL=kernels.js.map

package/dist/kernels/naifKernelId.d.ts

@@ -0,0 +1,2 @@
+export type NaifKernelId = "dsk/asteroids/eros/near-a-msi-5-erosshape-v1_0_512q.bds" | "dsk/asteroids/eros/near-a-msi-5-erosshape-v1_0_64q.bds" | "dsk/asteroids/itokawa/hay_a_amica_5_itokawashape_v1_0_512q.bds" | "dsk/asteroids/itokawa/hay_a_amica_5_itokawashape_v1_0_64q.bds" | "dsk/asteroids/lutetia/a_old_versions/ro-a-osinac_osiwac-5-lutetia-shape-v1_0_002m.bds" | "dsk/asteroids/lutetia/a_old_versions/ro-a-osinac_osiwac-5-lutetia-shape-v1_0_006k.bds" | "dsk/asteroids/lutetia/a_old_versions/ro-a-osinac_osiwac-5-lutetia-shape-v1_0_780k.bds" | "dsk/asteroids/steins/a_old_versions/ro-a-osinac_osiwac-5-steins-shape-v1_0_20k.bds" | "dsk/asteroids/steins/a_old_versions/steins_0.7_4.bds" | "dsk/asteroids/vesta/vesta_gaskell_256.bds" | "dsk/asteroids/vesta/vesta_thomas_1997.bds" | "dsk/comets/churyumov-gerasimenko/a_old_versions/churyumov-gerasimenko_512.bds" | "dsk/satellites/phobos_2014_09_22.bds" | "dsk/satellites/phobos_3_3.bds" | "dsk/satellites/phobos512.bds" | "fk/planets/earth_assoc_itrf93.tf" | "fk/satellites/a_old_versions/jup344_nameid.tf" | "fk/satellites/a_old_versions/jup344-s2003_j24_nameid.tf" | "fk/satellites/a_old_versions/jup346_nameid.tf" | "fk/satellites/a_old_versions/moon_060721.tf" | "fk/satellites/a_old_versions/moon_071218.tf" | "fk/satellites/a_old_versions/moon_de440_200625.tf" | "fk/satellites/a_old_versions/moon_de440_220930.tf" | "fk/satellites/a_old_versions/nep103_nameid.tf" | "fk/satellites/a_old_versions/sat452_nameid.tf" | "fk/satellites/a_old_versions/sat453_nameid.tf" | "fk/satellites/a_old_versions/sat454_nameid.tf" | "fk/satellites/jup347_nameid.tf" | "fk/satellites/moon_080317.tf" | "fk/satellites/moon_assoc_me.tf" | "fk/satellites/moon_assoc_pa.tf" | "fk/satellites/moon_de440_250416.tf" | "fk/satellites/nep095_nameid.tf" | "fk/satellites/nep104_nameid.tf" | "fk/satellites/sat455_nameid.tf" | "fk/satellites/sat456_nameid.tf" | "fk/satellites/sat457_nameid.tf" | "fk/satellites/ura117_nameid.tf" | "fk/stations/a_old_versions/dss_35_36_prelim_itrf93_140604.tf" | "fk/stations/a_old_versions/dss_35_36_prelim_itrf93_140620.tf" | "fk/stations/a_old_versions/dss_53_prelim_itrf93_201018.tf" | "fk/stations/a_old_versions/dss_56_prelim_itrf93_201018.tf" | "fk/stations/a_old_versions/earth_topo_040916.tf" | "fk/stations/a_old_versions/earth_topo_050714_v2.tf" | "fk/stations/a_old_versions/earth_topo_050714.tf" | "fk/stations/a_old_versions/misasa_54m_itrf93_210121.tf" | "fk/stations/dss_17_prelim_itrf93_161110.tf" | "fk/stations/dss_17_prelim_itrf93_190814.tf" | "fk/stations/dss_23_placeholder_itrf93_201017.tf" | "fk/stations/dss_30_itrf93_210201.tf" | "fk/stations/dss_59_prelim_itrf93_220921.tf" | "fk/stations/dss_69_prelim_itrf93_201215.tf" | "fk/stations/earth_topo_201023.tf" | "fk/stations/ndosl_140530_v01.tf" | "fk/stations/ndosl_190716_v01.tf" | "fk/stations/ndosl_190716_v02.tf" | "lsk/a_old_versions/naif0007.tls" | "lsk/a_old_versions/naif0008.tls" | "lsk/a_old_versions/naif0009.tls" | "lsk/a_old_versions/naif0010.tls" | "lsk/a_old_versions/naif0011.tls" | "lsk/latest_leapseconds.tls" | "lsk/naif0011.tls" | "lsk/naif0012.tls" | "pck/a_old_versions/earth_031228_231229_predict.bpc" | "pck/a_old_versions/earth_060526_370526_predict.bpc" | "pck/a_old_versions/earth_070425_370426_predict.bpc" | "pck/a_old_versions/earth_1962_240827_2124_combined.bpc" | "pck/a_old_versions/earth_200101_990628_predict.bpc" | "pck/a_old_versions/earth_200101_990825_predict.bpc" | "pck/a_old_versions/earth_200101_990827_predict.bpc" | "pck/a_old_versions/earth_620120_240827.bpc" | "pck/a_old_versions/earth_720101_031229.bpc" | "pck/a_old_versions/earth_720101_070426.bpc" | "pck/a_old_versions/earth_720101_070527.bpc" | "pck/a_old_versions/earth_720101_230601.bpc" | "pck/a_old_versions/lunar_de403s_pa_v0.bpc" | "pck/a_old_versions/pck00003.tpc" | "pck/a_old_versions/pck00005.tpc" | "pck/a_old_versions/pck00006.tpc" | "pck/a_old_versions/pck00007.tpc" | "pck/a_old_versions/pck00008.tpc" | "pck/a_old_versions/pck00009.tpc" | "pck/a_old_versions/preliminary_pck00004.tpc" | "pck/de-403-masses.tpc" | "pck/earth_000101_260514_260215.bpc" | "pck/earth_1962_250826_2125_combined.bpc" | "pck/earth_2025_250826_2125_predict.bpc" | "pck/earth_620120_250826.bpc" | "pck/earth_fixed.tf" | "pck/earth_latest_high_prec.bpc" | "pck/gm_de431.tpc" | "pck/gm_de440.tpc" | "pck/Gravity.tpc" | "pck/mars_iau2000_v1.tpc" | "pck/moon_pa_de403_1950-2198.bpc" | "pck/moon_pa_de418_1950-2050.bpc" | "pck/moon_pa_de421_1900-2050.bpc" | "pck/moon_pa_de440_200625.bpc" | "pck/pck00010.tpc" | "pck/pck00011_n0066.tpc" | "pck/pck00011.tpc" | "spk/asteroids/a_old_versions/ceres_1900_2100.bsp" | "spk/asteroids/a_old_versions/ceres-2003-2016.bsp" | "spk/asteroids/a_old_versions/codes_300ast_20061020.bsp" | "spk/asteroids/a_old_versions/codes_300ast_20061020.tf" | "spk/asteroids/a_old_versions/eros_1900_2100.bsp" | "spk/asteroids/a_old_versions/eros9633.bsp" | "spk/asteroids/a_old_versions/erosToJan2005.bsp" | "spk/asteroids/a_old_versions/kleopatra_1900_2100.bsp" | "spk/asteroids/a_old_versions/kleopatra_2000_2010.bsp" | "spk/asteroids/a_old_versions/minoriso.bsp" | "spk/asteroids/a_old_versions/mn4_2000-2100.bsp" | "spk/asteroids/a_old_versions/pallas_1900_2100.bsp" | "spk/asteroids/a_old_versions/pallas-2003-2015.bsp" | "spk/asteroids/a_old_versions/vesta_1900_2100.bsp" | "spk/asteroids/a_old_versions/vesta_for_ds1.bsp" | "spk/asteroids/a_old_versions/vesta-2003-2013.bsp" | "spk/asteroids/a_old_versions/vestlute.bsp" | "spk/asteroids/codes_300ast_20100725.bsp" | "spk/asteroids/codes_300ast_20100725.tf" | "spk/comets/a_old_versions/borrelly.bsp" | "spk/comets/a_old_versions/linear1999s4_Jul31.bsp" | "spk/comets/a_old_versions/minoriso.bsp" | "spk/comets/a_old_versions/pcomets_v1_ieee.bsp" | "spk/comets/a_old_versions/siding_spring_v1.bsp" | "spk/comets/a_old_versions/siding_spring_v2.bsp" | "spk/comets/a_old_versions/swift-tuttle_1730-2010.bsp" | "spk/comets/a_old_versions/tempel1_2000_2020.bsp" | "spk/comets/C_G_1000012_2012_2017.bsp" | "spk/comets/c2013a1_s105_merged.bsp" | "spk/comets/ison.bsp" | "spk/comets/siding_spring_8-19-14.bsp" | "spk/comets/siding_spring_s46.bsp" | "spk/lagrange_point/a_old_versions/L1_de431.bsp" | "spk/lagrange_point/a_old_versions/L2_de431.bsp" | "spk/lagrange_point/a_old_versions/L4_de431.bsp" | "spk/lagrange_point/a_old_versions/L5_de431.bsp" | "spk/lagrange_point/L1_de441.bsp" | "spk/lagrange_point/L2_de441.bsp" | "spk/lagrange_point/L4_de441.bsp" | "spk/lagrange_point/L5_de441.bsp" | "spk/planets/a_old_versions/de118.bsp" | "spk/planets/a_old_versions/de125.bsp" | "spk/planets/a_old_versions/de130.bsp" | "spk/planets/a_old_versions/de200.bsp" | "spk/planets/a_old_versions/de245_1960_1980.bsp" | "spk/planets/a_old_versions/de245_1990_2010.bsp" | "spk/planets/a_old_versions/de403_2000-2020.bsp" | "spk/planets/a_old_versions/de403.bsp" | "spk/planets/a_old_versions/de403s.bsp" | "spk/planets/a_old_versions/de405.bsp" | "spk/planets/a_old_versions/de405s.bsp" | "spk/planets/a_old_versions/de406s.bsp" | "spk/planets/a_old_versions/de408.bsp" | "spk/planets/a_old_versions/de410.bsp" | "spk/planets/a_old_versions/de410mini.bsp" | "spk/planets/a_old_versions/de410s.bsp" | "spk/planets/a_old_versions/de413.bsp" | "spk/planets/a_old_versions/de414.bsp" | "spk/planets/a_old_versions/de418.bsp" | "spk/planets/a_old_versions/de421.bsp" | "spk/planets/a_old_versions/de423.bsp" | "spk/planets/a_old_versions/de721_full.bsp" | "spk/planets/de430.bsp" | "spk/planets/de431_part-1.bsp" | "spk/planets/de431_part-2.bsp" | "spk/planets/de432s.bsp" | "spk/planets/de435.bsp" | "spk/planets/de438.bsp" | "spk/planets/de440.bsp" | "spk/planets/de440s.bsp" | "spk/planets/de441_part-1.bsp" | "spk/planets/de441_part-2.bsp" | "spk/planets/de442.bsp" | "spk/planets/de442s.bsp" | "spk/satellites/a_old_versions/jup068.bsp" | "spk/satellites/a_old_versions/jup069.bsp" | "spk/satellites/a_old_versions/jup073-hst.bsp" | "spk/satellites/a_old_versions/jup073s.bsp" | "spk/satellites/a_old_versions/jup100.bsp" | "spk/satellites/a_old_versions/jup104.bsp" | "spk/satellites/a_old_versions/jup120_1996-2010.bsp" | "spk/satellites/a_old_versions/jup147s.bsp" | "spk/satellites/a_old_versions/jup164_20year.bsp" | "spk/satellites/a_old_versions/jup166.bsp" | "spk/satellites/a_old_versions/jup172.bsp" | "spk/satellites/a_old_versions/jup202_2000_2010.bsp" | "spk/satellites/a_old_versions/jup204.bsp" | "spk/satellites/a_old_versions/jup214.bsp" | "spk/satellites/a_old_versions/jup215.bsp" | "spk/satellites/a_old_versions/jup219.bsp" | "spk/satellites/a_old_versions/jup230-rocks.bsp" | "spk/satellites/a_old_versions/jup230-short.bsp" | "spk/satellites/a_old_versions/jup230.bsp" | "spk/satellites/a_old_versions/jup230l.bsp" | "spk/satellites/a_old_versions/jup251.bsp" | "spk/satellites/a_old_versions/jup252.bsp" | "spk/satellites/a_old_versions/jup253.bsp" | "spk/satellites/a_old_versions/jup254.bsp" | "spk/satellites/a_old_versions/jup255.bsp" | "spk/satellites/a_old_versions/jup256.bsp" | "spk/satellites/a_old_versions/jup261.bsp" | "spk/satellites/a_old_versions/jup262.bsp" | "spk/satellites/a_old_versions/jup263.bsp" | "spk/satellites/a_old_versions/jup266.bsp" | "spk/satellites/a_old_versions/jup267.bsp" | "spk/satellites/a_old_versions/jup268.bsp" | "spk/satellites/a_old_versions/jup269.bsp" | "spk/satellites/a_old_versions/jup270.bsp" | "spk/satellites/a_old_versions/jup282-1.bsp" | "spk/satellites/a_old_versions/jup282.bsp" | "spk/satellites/a_old_versions/jup291.bsp" | "spk/satellites/a_old_versions/jup293.bsp" | "spk/satellites/a_old_versions/jup294.bsp" | "spk/satellites/a_old_versions/jup300.bsp" | "spk/satellites/a_old_versions/jup309.bsp" | "spk/satellites/a_old_versions/jup310_2004.bsp" | "spk/satellites/a_old_versions/jup310_2018.bsp" | "spk/satellites/a_old_versions/jup310_2021.bsp" | "spk/satellites/a_old_versions/jup310_2023.bsp" | "spk/satellites/a_old_versions/jup310.bsp" | "spk/satellites/a_old_versions/jup329.bsp" | "spk/satellites/a_old_versions/jup341.bsp" | "spk/satellites/a_old_versions/jup343.bsp" | "spk/satellites/a_old_versions/jup344-s2003_j24.bsp" | "spk/satellites/a_old_versions/jup344.bsp" | "spk/satellites/a_old_versions/jup345.bsp" | "spk/satellites/a_old_versions/jup346.bsp" | "spk/satellites/a_old_versions/jup365_2027.bsp" | "spk/satellites/a_old_versions/mar022-1.bsp" | "spk/satellites/a_old_versions/mar022-LONG.bsp" | "spk/satellites/a_old_versions/mar033_2000-2025.bsp" | "spk/satellites/a_old_versions/mar033-7.bsp" | "spk/satellites/a_old_versions/mar063.bsp" | "spk/satellites/a_old_versions/mar080.bsp" | "spk/satellites/a_old_versions/mar085.bsp" | "spk/satellites/a_old_versions/mar097.bsp" | "spk/satellites/a_old_versions/nep016-6.bsp" | "spk/satellites/a_old_versions/nep016-95-05.bsp" | "spk/satellites/a_old_versions/nep016.bsp" | "spk/satellites/a_old_versions/nep022.bsp" | "spk/satellites/a_old_versions/nep022m.bsp" | "spk/satellites/a_old_versions/nep029.bsp" | "spk/satellites/a_old_versions/nep050_old.bsp" | "spk/satellites/a_old_versions/nep050.bsp" | "spk/satellites/a_old_versions/nep055.bsp" | "spk/satellites/a_old_versions/nep056.bsp" | "spk/satellites/a_old_versions/nep057.bsp" | "spk/satellites/a_old_versions/nep076-long.bsp" | "spk/satellites/a_old_versions/nep076.bsp" | "spk/satellites/a_old_versions/nep077.bsp" | "spk/satellites/a_old_versions/nep078.bsp" | "spk/satellites/a_old_versions/nep081.bsp" | "spk/satellites/a_old_versions/nep085.bsp" | "spk/satellites/a_old_versions/nep086.bsp" | "spk/satellites/a_old_versions/nep087.bsp" | "spk/satellites/a_old_versions/nep088.bsp" | "spk/satellites/a_old_versions/nep090.bsp" | "spk/satellites/a_old_versions/nep101.bsp" | "spk/satellites/a_old_versions/nep102.bsp" | "spk/satellites/a_old_versions/nep103.bsp" | "spk/satellites/a_old_versions/pan_1998-2010.bsp" | "spk/satellites/a_old_versions/plu006-4.bsp" | "spk/satellites/a_old_versions/plu006-5.bsp" | "spk/satellites/a_old_versions/plu008_special.bsp" | "spk/satellites/a_old_versions/plu013.bsp" | "spk/satellites/a_old_versions/plu017.bsp" | "spk/satellites/a_old_versions/plu017xl.bsp" | "spk/satellites/a_old_versions/plu020.bsp" | "spk/satellites/a_old_versions/plu021.bsp" | "spk/satellites/a_old_versions/plu022.bsp" | "spk/satellites/a_old_versions/plu031.bsp" | "spk/satellites/a_old_versions/plu042.bsp" | "spk/satellites/a_old_versions/plu043.bsp" | "spk/satellites/a_old_versions/plu055.bsp" | "spk/satellites/a_old_versions/plu058.bsp" | "spk/satellites/a_old_versions/sat060.bsp" | "spk/satellites/a_old_versions/sat077_2000-2025.bsp" | "spk/satellites/a_old_versions/sat077-95-05.bsp" | "spk/satellites/a_old_versions/sat077s.bsp" | "spk/satellites/a_old_versions/sat080.bsp" | "spk/satellites/a_old_versions/sat081-4.bsp" | "spk/satellites/a_old_versions/sat081-98-05_2.bsp" | "spk/satellites/a_old_versions/sat086.bsp" | "spk/satellites/a_old_versions/sat098-s.bsp" | "spk/satellites/a_old_versions/sat101_9-71_8-11.bsp" | "spk/satellites/a_old_versions/sat101.bsp" | "spk/satellites/a_old_versions/sat124.bsp" | "spk/satellites/a_old_versions/sat132.bsp" | "spk/satellites/a_old_versions/sat133.bsp" | "spk/satellites/a_old_versions/sat134.bsp" | "spk/satellites/a_old_versions/sat143.bsp" | "spk/satellites/a_old_versions/sat185.bsp" | "spk/satellites/a_old_versions/sat186.bsp" | "spk/satellites/a_old_versions/sat192.bsp" | "spk/satellites/a_old_versions/sat196.bsp" | "spk/satellites/a_old_versions/sat199.bsp" | "spk/satellites/a_old_versions/sat207.bsp" | "spk/satellites/a_old_versions/sat215.bsp" | "spk/satellites/a_old_versions/sat227.bsp" | "spk/satellites/a_old_versions/sat238.bsp" | "spk/satellites/a_old_versions/sat240.bsp" | "spk/satellites/a_old_versions/sat242.bsp" | "spk/satellites/a_old_versions/sat245.bsp" | "spk/satellites/a_old_versions/sat246.bsp" | "spk/satellites/a_old_versions/sat247.bsp" | "spk/satellites/a_old_versions/sat248.bsp" | "spk/satellites/a_old_versions/sat251.bsp" | "spk/satellites/a_old_versions/sat252.bsp" | "spk/satellites/a_old_versions/sat252s.bsp" | "spk/satellites/a_old_versions/sat254.bsp" | "spk/satellites/a_old_versions/sat270.bsp" | "spk/satellites/a_old_versions/sat271.bsp" | "spk/satellites/a_old_versions/sat272.bsp" | "spk/satellites/a_old_versions/sat273.bsp" | "spk/satellites/a_old_versions/sat275.bsp" | "spk/satellites/a_old_versions/sat276.bsp" | "spk/satellites/a_old_versions/sat281.bsp" | "spk/satellites/a_old_versions/sat286.bsp" | "spk/satellites/a_old_versions/sat288.bsp" | "spk/satellites/a_old_versions/sat291.bsp" | "spk/satellites/a_old_versions/sat295.bsp" | "spk/satellites/a_old_versions/sat296.bsp" | "spk/satellites/a_old_versions/sat297.bsp" | "spk/satellites/a_old_versions/sat298.bsp" | "spk/satellites/a_old_versions/sat299.bsp" | "spk/satellites/a_old_versions/sat317.bsp" | "spk/satellites/a_old_versions/sat319.bsp" | "spk/satellites/a_old_versions/sat341.bsp" | "spk/satellites/a_old_versions/sat342-rocks.bsp" | "spk/satellites/a_old_versions/sat342.bsp" | "spk/satellites/a_old_versions/sat351.bsp" | "spk/satellites/a_old_versions/sat353-rocks-extended.bsp" | "spk/satellites/a_old_versions/sat353-rocks.bsp" | "spk/satellites/a_old_versions/sat353.bsp" | "spk/satellites/a_old_versions/sat354.bsp" | "spk/satellites/a_old_versions/sat357-rocks-merge.bsp" | "spk/satellites/a_old_versions/sat357.bsp" | "spk/satellites/a_old_versions/sat359l.bsp" | "spk/satellites/a_old_versions/sat360.bsp" | "spk/satellites/a_old_versions/sat361.bsp" | "spk/satellites/a_old_versions/sat362.bsp" | "spk/satellites/a_old_versions/sat363-rocks-merge.bsp" | "spk/satellites/a_old_versions/sat363.bsp" | "spk/satellites/a_old_versions/sat365.bsp" | "spk/satellites/a_old_versions/sat368-named_only.bsp" | "spk/satellites/a_old_versions/sat368.bsp" | "spk/satellites/a_old_versions/sat375.bsp" | "spk/satellites/a_old_versions/sat378.bsp" | "spk/satellites/a_old_versions/sat382-rocks-merge.bsp" | "spk/satellites/a_old_versions/sat382.bsp" | "spk/satellites/a_old_versions/sat393-rocks_pan.bsp" | "spk/satellites/a_old_versions/sat393.bsp" | "spk/satellites/a_old_versions/sat425.bsp" | "spk/satellites/a_old_versions/sat427.bsp" | "spk/satellites/a_old_versions/sat428.bsp" | "spk/satellites/a_old_versions/sat450.bsp" | "spk/satellites/a_old_versions/sat452.bsp" | "spk/satellites/a_old_versions/sat453.bsp" | "spk/satellites/a_old_versions/sat454.bsp" | "spk/satellites/a_old_versions/ura027-3.bsp" | "spk/satellites/a_old_versions/ura031.bsp" | "spk/satellites/a_old_versions/ura032.bsp" | "spk/satellites/a_old_versions/ura033.bsp" | "spk/satellites/a_old_versions/ura039.bsp" | "spk/satellites/a_old_versions/ura039m.bsp" | "spk/satellites/a_old_versions/ura042.bsp" | "spk/satellites/a_old_versions/ura045.bsp" | "spk/satellites/a_old_versions/ura063.bsp" | "spk/satellites/a_old_versions/ura064.bsp" | "spk/satellites/a_old_versions/ura071.bsp" | "spk/satellites/a_old_versions/ura072.bsp" | "spk/satellites/a_old_versions/ura074.bsp" | "spk/satellites/a_old_versions/ura083.bsp" | "spk/satellites/a_old_versions/ura086.bsp" | "spk/satellites/a_old_versions/ura090_1.bsp" | "spk/satellites/a_old_versions/ura090.bsp" | "spk/satellites/a_old_versions/ura091-rocks-merge.bsp" | "spk/satellites/a_old_versions/ura095.bsp" | "spk/satellites/a_old_versions/ura111.bsp" | "spk/satellites/a_old_versions/ura111l.bsp" | "spk/satellites/a_old_versions/ura112.bsp" | "spk/satellites/a_old_versions/ura115.bsp" | "spk/satellites/a_old_versions/ura116.bsp" | "spk/satellites/a_old_versions/ura117.bsp" | "spk/satellites/a_old_versions/ura182.bsp" | "spk/satellites/jup347.bsp" | "spk/satellites/jup365.bsp" | "spk/satellites/mar099.bsp" | "spk/satellites/mar099s.bsp" | "spk/satellites/nep095.bsp" | "spk/satellites/nep097.bsp" | "spk/satellites/nep097xl-801.bsp" | "spk/satellites/nep097xl-899.bsp" | "spk/satellites/nep101xl-802.bsp" | "spk/satellites/nep101xl.bsp" | "spk/satellites/nep104.bsp" | "spk/satellites/nep105.bsp" | "spk/satellites/plu060.bsp" | "spk/satellites/sat393_daphnis.bsp" | "spk/satellites/sat415.bsp" | "spk/satellites/sat441.bsp" | "spk/satellites/sat441xl_part-1.bsp" | "spk/satellites/sat441xl_part-2.bsp" | "spk/satellites/sat455.bsp" | "spk/satellites/sat456.bsp" | "spk/satellites/sat457.bsp" | "spk/satellites/ura111xl-701.bsp" | "spk/satellites/ura111xl-702.bsp" | "spk/satellites/ura111xl-703.bsp" | "spk/satellites/ura111xl-704.bsp" | "spk/satellites/ura111xl-705.bsp" | "spk/satellites/ura111xl-799.bsp" | "spk/satellites/ura116xl.bsp" | "spk/satellites/ura184_part-1.bsp" | "spk/satellites/ura184_part-2.bsp" | "spk/satellites/ura184_part-3.bsp" | "spk/stations/a_old_versions/dsnstns.bsp" | "spk/stations/a_old_versions/dss_17_prelim_itrf93_161110.bsp" | "spk/stations/a_old_versions/dss_35_36_prelim_itrf93_140604.bsp" | "spk/stations/a_old_versions/dss_35_36_prelim_itrf93_140620.bsp" | "spk/stations/a_old_versions/dss_53_prelim_itrf93_201018.bsp" | "spk/stations/a_old_versions/dss_56_prelim_itrf93_201018.bsp" | "spk/stations/a_old_versions/earthstn.bsp" | "spk/stations/a_old_versions/earthstns_fx_040916.bsp" | "spk/stations/a_old_versions/earthstns_fx_050714.bsp" | "spk/stations/a_old_versions/earthstns_itrf93_040916.bsp" | "spk/stations/a_old_versions/earthstns_itrf93_050714.bsp" | "spk/stations/a_old_versions/misasa_54m_itrf93_210121.bsp" | "spk/stations/a_old_versions/stations.bsp" | "spk/stations/dss_17_prelim_itrf93_190814.bsp" | "spk/stations/dss_23_placeholder_itrf93_201017.bsp" | "spk/stations/dss_30_itrf93_210201.bsp" | "spk/stations/dss_59_prelim_itrf93_220921.bsp" | "spk/stations/dss_69_prelim_itrf93_201215.bsp" | "spk/stations/earthstns_fx_201023.bsp" | "spk/stations/earthstns_itrf93_201023.bsp" | "spk/stations/ndosl_140530_v01.bsp" | "spk/stations/ndosl_190716_v01.bsp" | "spk/stations/ndosl_190716_v02.bsp" | "spk/tno/a_old_versions/tnosat_v001_20136108_jpl110_20220908.bsp" | "spk/tno/tnosat_v001_20000617_jpl082_20230601.bsp" | "spk/tno/tnosat_v001_20050000_jpl043_20220908.bsp" | "spk/tno/tnosat_v001_20090482_jpl043_20220908.bsp" | "spk/tno/tnosat_v001_20120347_jpl025_20220908.bsp" | "spk/tno/tnosat_v001_20136199_jpl080_20220908.bsp" | "spk/tno/tnosat_v001_20469705_jpl009_20220908.bsp" | "spk/tno/tnosat_v001_20612095_jpl006_20220908.bsp" | "spk/tno/tnosat_v001_20612687_jpl008_20220908.bsp" | "spk/tno/tnosat_v001_53031823_jpl010_20220908.bsp" | "spk/tno/tnosat_v001_53092511_jpl005_20220908.bsp" | "spk/tno/tnosat_v001b_20136108_jpl110_20221014.bsp" | "stars/hipparcos.xdb.Z" | "stars/ppm.xdb.Z" | "stars/tycho2.xdb.Z";
+//# sourceMappingURL=naifKernelId.d.ts.map

package/dist/kernels/naifKernelId.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=naifKernelId.js.map

package/dist/kit/math/mat3.d.ts

@@ -7,17 +7,25 @@ import type { Mat3ColMajor, Mat3RowMajor } from "#backend-contract";
  * Implementation notes:
  * - We store a single canonical (row-major) layout.
  * - The column-major layout is derived lazily and cached.
-* - Returned layout arrays are frozen in dev builds to help catch invariant-breaking mutation.
+ * - Returned layout arrays are frozen in dev builds to help catch invariant-breaking mutation.
  */
 export declare class Mat3 {
     #private;
+    /** Create a Mat3 from cached row/col-major representations. Prefer the static constructors. */
     private constructor();
+    /** Create a {@link Mat3} from a row-major 3x3 array (input is cloned). */
     static fromRowMajor(m: Readonly<Mat3RowMajor>): Mat3;
+    /** Create a {@link Mat3} from a column-major 3x3 array (input is cloned). */
     static fromColMajor(m: Readonly<Mat3ColMajor>): Mat3;
+    /** Create an identity 3x3 matrix. */
     static identity(): Mat3;
+    /** Row-major representation (as a cached branded tuple). */
     get rowMajor(): Readonly<Mat3RowMajor>;
+    /** Column-major representation (computed lazily and cached). */
     get colMajor(): Readonly<Mat3ColMajor>;
+    /** Alias for {@link rowMajor}. */
     toRowMajor(): Readonly<Mat3RowMajor>;
+    /** Alias for {@link colMajor}. */
     toColMajor(): Readonly<Mat3ColMajor>;
 }
 //# sourceMappingURL=mat3.d.ts.map

package/dist/kit/math/mat3.js

@@ -31,31 +31,37 @@ function colMajorToRowMajor(m) {
  * Implementation notes:
  * - We store a single canonical (row-major) layout.
  * - The column-major layout is derived lazily and cached.
-* - Returned layout arrays are frozen in dev builds to help catch invariant-breaking mutation.
+ * - Returned layout arrays are frozen in dev builds to help catch invariant-breaking mutation.
  */
 export class Mat3 {
     #rowMajor;
     #colMajor;
+    /** Create a Mat3 from cached row/col-major representations. Prefer the static constructors. */
     constructor(rowMajor, colMajor) {
         this.#rowMajor = rowMajor;
         this.#colMajor = colMajor;
     }
+    /** Create a {@link Mat3} from a row-major 3x3 array (input is cloned). */
     static fromRowMajor(m) {
         return new Mat3(cloneRowMajor(m));
     }
+    /** Create a {@link Mat3} from a column-major 3x3 array (input is cloned). */
     static fromColMajor(m) {
         const colMajor = cloneColMajor(m);
         const rowMajor = colMajorToRowMajor(colMajor);
         return new Mat3(rowMajor, colMajor);
     }
+    /** Create an identity 3x3 matrix. */
     static identity() {
         return Mat3.fromRowMajor(brandMat3RowMajor([1, 0, 0, 0, 1, 0, 0, 0, 1], {
             label: "Mat3.identity",
         }));
     }
+    /** Row-major representation (as a cached branded tuple). */
     get rowMajor() {
         return this.#rowMajor;
     }
+    /** Column-major representation (computed lazily and cached). */
     get colMajor() {
         let colMajor = this.#colMajor;
         if (!colMajor) {
@@ -64,9 +70,11 @@ export class Mat3 {
         }
         return colMajor;
     }
+    /** Alias for {@link rowMajor}. */
     toRowMajor() {
         return this.rowMajor;
     }
+    /** Alias for {@link colMajor}. */
     toColMajor() {
         return this.colMajor;
     }

package/dist/kit/spice/create-kit.d.ts

@@ -7,5 +7,6 @@ export type CreateKitOptions = {
      */
     byteBackedKernelPaths?: Set<string>;
 };
+/** Create a high-level {@link SpiceKit} wrapper around a low-level {@link SpiceBackend}. */
 export declare function createKit(cspice: SpiceBackend, options?: CreateKitOptions): SpiceKit;
 //# sourceMappingURL=create-kit.d.ts.map

package/dist/kit/spice/create-kit.js

@@ -3,6 +3,7 @@ import { createFramesKit } from "./frames.js";
 import { createKernelKit } from "./kernels.js";
 import { createStateKit } from "./state.js";
 import { createTimeKit } from "./time.js";
+/** Create a high-level {@link SpiceKit} wrapper around a low-level {@link SpiceBackend}. */
 export function createKit(cspice, options = {}) {
     return {
         ...createKernelKit(cspice, options.byteBackedKernelPaths ? { byteBackedKernelPaths: options.byteBackedKernelPaths } : {}),

package/dist/kit/spice/frames.d.ts

@@ -1,6 +1,7 @@
 import type { SpiceBackend } from "#backend-contract";
 import type { FrameName, SpiceTime } from "../../types.js";
 import { Mat3 } from "../math/mat3.js";
+/** Create frame helpers (pxform wrappers) for a given backend. */
 export declare function createFramesKit(cspice: SpiceBackend): {
     frameTransform(from: FrameName, to: FrameName, et: SpiceTime): Mat3;
 };

package/dist/kit/spice/frames.js

@@ -1,5 +1,6 @@
 import { wrapSpiceError } from "../../errors.js";
 import { Mat3 } from "../math/mat3.js";
+/** Create frame helpers (pxform wrappers) for a given backend. */
 export function createFramesKit(cspice) {
     return {
         frameTransform: (from, to, et) => {

package/dist/kit/spice/kernels.d.ts

@@ -6,6 +6,7 @@ export type CreateKernelKitOptions = {
      */
     byteBackedKernelPaths?: Set<string>;
 };
+/** Create kernel load/unload helpers for a given backend (with virtual-path normalization). */
 export declare function createKernelKit(cspice: SpiceBackend, options?: CreateKernelKitOptions): {
     loadKernel(kernel: KernelSource): void;
     unloadKernel(path: string): void;

package/dist/kit/spice/kernels.js

@@ -1,5 +1,6 @@
 import { normalizeVirtualKernelPath } from "#core";
 import { wrapSpiceError } from "../../errors.js";
+/** Create kernel load/unload helpers for a given backend (with virtual-path normalization). */
 export function createKernelKit(cspice, options = {}) {
     const byteBackedKernelPaths = options.byteBackedKernelPaths;
     return {

package/dist/kit/spice/state.d.ts

@@ -1,5 +1,6 @@
 import type { SpiceBackend } from "#backend-contract";
-import type { GetStateArgs, StateVector } from "../../types.js";
+import { type GetStateArgs, type StateVector } from "../../types.js";
+/** Create state-vector helpers (`spkezr` wrapper) for a given backend. */
 export declare function createStateKit(cspice: SpiceBackend): {
     getState(args: GetStateArgs): StateVector;
 };

package/dist/kit/spice/state.js

@@ -1,22 +1,26 @@
 import { wrapSpiceError } from "../../errors.js";
-const DEFAULT_FRAME = "J2000";
+import { J2000, } from "../../types.js";
+const DEFAULT_FRAME = J2000;
 const DEFAULT_ABERRATION = "NONE";
 function splitState(state) {
     const position = [state[0], state[1], state[2]];
     const velocity = [state[3], state[4], state[5]];
     return { position, velocity };
 }
+/** Create state-vector helpers (`spkezr` wrapper) for a given backend. */
 export function createStateKit(cspice) {
     return {
         getState: ({ target, observer, at, frame = DEFAULT_FRAME, aberration = DEFAULT_ABERRATION }) => {
             try {
-                const { state, lt } = cspice.spkezr(target, at, frame, aberration, observer);
+                const targetStr = String(target);
+                const observerStr = String(observer);
+                const { state, lt } = cspice.spkezr(targetStr, at, frame, aberration, observerStr);
                 const { position, velocity } = splitState(state);
                 return {
                     et: at,
                     frame,
-                    target,
-                    observer,
+                    target: targetStr,
+                    observer: observerStr,
                     aberration,
                     position,
                     velocity,

package/dist/kit/spice/time.d.ts

@@ -1,5 +1,6 @@
 import type { SpiceBackend } from "#backend-contract";
 import type { SpiceTime } from "../../types.js";
+/** Create time conversion helpers (`str2et`/`et2utc` wrappers) for a given backend. */
 export declare function createTimeKit(cspice: SpiceBackend): {
     toolkitVersion(): string;
     utcToEt(utc: string): SpiceTime;

package/dist/kit/spice/time.js

@@ -1,4 +1,5 @@
 import { wrapSpiceError } from "../../errors.js";
+/** Create time conversion helpers (`str2et`/`et2utc` wrappers) for a given backend. */
 export function createTimeKit(cspice) {
     return {
         toolkitVersion: () => {

package/dist/kit/types/spice-types.d.ts

@@ -22,8 +22,12 @@ export type SpiceKit = {
     /** Convenience wrapper around `spkezr` that returns a structured state vector. */
     getState(args: GetStateArgs): StateVector;
 };
+export type PromisifyFn<T> = T extends (...args: infer A) => infer R ? (...args: A) => Promise<Awaited<R>> : T;
+export type PromisifyObject<T extends object> = {
+    [K in keyof T]: PromisifyFn<T[K]>;
+};
 /**
- * Top-level `createSpice()` return type.
+ * Top-level sync-ish client type (returned by `spiceClients.toSync()`).
  */
 export type Spice = {
     /** Raw backend primitives (verbatim). */
@@ -31,4 +35,17 @@ export type Spice = {
     /** Higher-level helpers and typed conveniences. */
     kit: SpiceKit;
 };
+/**
+ * Sync-ish client returned by `spiceClients.toSync()`.
+ */
+export type SpiceSync = Spice;
+/**
+ * Async client returned by `spiceClients.toAsync()` / `spiceClients.toWebWorker()`.
+ *
+ * Mirrors the sync surface area, but wraps every function in a `Promise`.
+ */
+export type SpiceAsync = {
+    raw: PromisifyObject<SpiceBackend>;
+    kit: PromisifyObject<SpiceKit>;
+};
 //# sourceMappingURL=spice-types.d.ts.map

package/dist/spice.d.ts

@@ -1,6 +1,6 @@
 import type { SpiceBackend } from "#backend-contract";
 import type { CreateBackendOptions } from "./backend.js";
-import type { Spice } from "./kit/types/spice-types.js";
+import type { Spice, SpiceAsync } from "./kit/types/spice-types.js";
 export type CreateSpiceOptions = CreateBackendOptions & {
     /**
      * If provided, `createSpice()` will wrap this backend instead of creating a new one.
@@ -9,5 +9,14 @@ export type CreateSpiceOptions = CreateBackendOptions & {
      */
     backendInstance?: SpiceBackend;
 };
+export type CreateSpiceAsyncOptions = CreateSpiceOptions;
+/**
+ * Create a sync {@link Spice} client backed by the requested backend/transport.
+ */
 export declare function createSpice(options: CreateSpiceOptions): Promise<Spice>;
+/**
+ * Create an async client with the same surface area as `createSpice()`, but
+ * with all methods returning `Promise`s.
+ */
+export declare function createSpiceAsync(options: CreateSpiceAsyncOptions): Promise<SpiceAsync>;
 //# sourceMappingURL=spice.d.ts.map