@sigx/lynx-navigation 0.4.0 → 0.4.1

package/dist/hooks/use-nav-serializer.js

@@ -0,0 +1,181 @@
+import { effect, onMounted, onUnmounted } from '@sigx/lynx';
+import { useNav } from './use-nav.js';
+import { useNavRoutes } from './use-nav-internal.js';
+export const NAV_SNAPSHOT_VERSION = 1;
+/**
+ * Wire a navigator's stack to a storage adapter.
+ *
+ * On mount:
+ *   1. Call `storage.load()`.
+ *   2. Validate the snapshot (version match, every entry's route still
+ *      registered).
+ *   3. On success, `nav.reset({ stack })` to apply.
+ *   4. On any failure, leave the stack alone (initial route remains).
+ *
+ * Then subscribe to `nav.stack` and call `storage.save(snapshot)` debounced.
+ *
+ * Why we don't validate `params` / `search` against schemas here: schemas
+ * are part of the route definition, and re-running them across all entries
+ * on every launch costs more than it's worth. The contract is "entries were
+ * validated when they were pushed; if the schema has since changed in a
+ * breaking way, bump `version` to reject old snapshots wholesale." Callers
+ * who want a stricter check can run their own validation in
+ * `storage.load()` and return `null` on mismatch.
+ */
+export function useNavSerializer(options) {
+    const nav = useNav();
+    const routes = useNavRoutes();
+    const debounceMs = options.debounceMs ?? 250;
+    const onRestored = options.onRestored;
+    const onErr = options.onRestoreError;
+    // Mutable mount/state flags. Plain closure vars (no signals) — we don't
+    // want any of this driving a render and we don't want it tracked by the
+    // save-effect below.
+    let mounted = true;
+    let restoreDone = false;
+    let pendingTimer = null;
+    let stopEffect = null;
+    onMounted(() => {
+        // Kick off the load synchronously — adapters that return a value
+        // immediately (sync stores, test doubles) hit the resolve branch on
+        // the same tick. Promise adapters resolve on the microtask queue;
+        // the `mounted` guard catches teardown races.
+        Promise.resolve()
+            .then(() => options.storage.load())
+            .then((snap) => {
+            if (!mounted)
+                return;
+            if (snap == null) {
+                restoreDone = true;
+                startSaveEffect();
+                return;
+            }
+            if (!isValidShape(snap)) {
+                onErr?.('shape');
+                restoreDone = true;
+                startSaveEffect();
+                return;
+            }
+            if (snap.version !== NAV_SNAPSHOT_VERSION) {
+                onErr?.('version');
+                restoreDone = true;
+                startSaveEffect();
+                return;
+            }
+            // Drop the snapshot if any entry references a route the app
+            // no longer knows about — partial restoration is worse than
+            // no restoration (could leave the user stranded on a screen
+            // whose params won't validate when read by `useParams`).
+            for (const entry of snap.stack) {
+                if (!routes[entry.route]) {
+                    onErr?.('unknown-route');
+                    restoreDone = true;
+                    startSaveEffect();
+                    return;
+                }
+            }
+            if (snap.stack.length === 0) {
+                onErr?.('shape');
+                restoreDone = true;
+                startSaveEffect();
+                return;
+            }
+            nav.reset({ stack: snap.stack });
+            onRestored?.(snap);
+            restoreDone = true;
+            startSaveEffect();
+        })
+            .catch((err) => {
+            if (!mounted)
+                return;
+            onErr?.('load-threw', err);
+            restoreDone = true;
+            startSaveEffect();
+        });
+    });
+    function startSaveEffect() {
+        if (!mounted || stopEffect)
+            return;
+        // The first effect run is just the initial subscription read — it
+        // happens immediately when `effect()` is called, before any user
+        // navigation, and represents the stack-as-restored (or the initial
+        // route when there was nothing to restore). Either way, we don't
+        // want to persist it: in the restore case it would race with the
+        // adapter that just supplied this state, and in the fresh case
+        // it's redundant.
+        let firstRun = true;
+        const runner = effect(() => {
+            const stack = nav.stack;
+            const snapshot = {
+                version: NAV_SNAPSHOT_VERSION,
+                stack: stack.map((e) => ({
+                    key: e.key,
+                    route: e.route,
+                    params: e.params,
+                    search: e.search,
+                    state: e.state,
+                    presentation: e.presentation,
+                })),
+            };
+            if (firstRun) {
+                firstRun = false;
+                return;
+            }
+            schedule(snapshot);
+        });
+        stopEffect = () => runner.stop();
+    }
+    function schedule(snapshot) {
+        if (pendingTimer != null)
+            clearTimeout(pendingTimer);
+        pendingTimer = setTimeout(() => {
+            pendingTimer = null;
+            try {
+                const r = options.storage.save(snapshot);
+                if (r && typeof r.catch === 'function') {
+                    r.catch(() => {
+                        // Save errors are intentionally swallowed — see the
+                        // hook doc-comment. Hosts that need visibility can
+                        // wrap their adapter.
+                    });
+                }
+            }
+            catch {
+                // Same rationale.
+            }
+        }, debounceMs);
+    }
+    onUnmounted(() => {
+        mounted = false;
+        if (pendingTimer != null) {
+            clearTimeout(pendingTimer);
+            pendingTimer = null;
+        }
+        if (stopEffect) {
+            stopEffect();
+            stopEffect = null;
+        }
+    });
+}
+function isValidShape(s) {
+    if (!s || typeof s !== 'object')
+        return false;
+    const obj = s;
+    if (typeof obj.version !== 'number')
+        return false;
+    if (!Array.isArray(obj.stack))
+        return false;
+    for (const entry of obj.stack) {
+        if (!entry || typeof entry !== 'object')
+            return false;
+        const e = entry;
+        if (typeof e.key !== 'string')
+            return false;
+        if (typeof e.route !== 'string')
+            return false;
+        if (typeof e.presentation !== 'string')
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=use-nav-serializer.js.map

package/dist/hooks/use-nav-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nav-serializer.js","sourceRoot":"","sources":["../../src/hooks/use-nav-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA0BrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAyCtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC7D,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC;IAErC,wEAAwE;IACxE,wEAAwE;IACxE,qBAAqB;IACrB,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,YAAY,GAAyC,IAAI,CAAC;IAC9D,IAAI,UAAU,GAAwB,IAAI,CAAC;IAE3C,SAAS,CAAC,GAAG,EAAE;QACX,iEAAiE;QACjE,oEAAoE;QACpE,kEAAkE;QAClE,8CAA8C;QAC9C,OAAO,CAAC,OAAO,EAAE;aACZ,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aAClC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACX,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACf,WAAW,GAAG,IAAI,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;gBACxC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC;gBACnB,WAAW,GAAG,IAAI,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,4DAA4D;YAC5D,4DAA4D;YAC5D,4DAA4D;YAC5D,yDAAyD;YACzD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvB,KAAK,EAAE,CAAC,eAAe,CAAC,CAAC;oBACzB,WAAW,GAAG,IAAI,CAAC;oBACnB,eAAe,EAAE,CAAC;oBAClB,OAAO;gBACX,CAAC;YACL,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACjC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;YACnB,WAAW,GAAG,IAAI,CAAC;YACnB,eAAe,EAAE,CAAC;QACtB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,KAAK,EAAE,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;YAC3B,WAAW,GAAG,IAAI,CAAC;YACnB,eAAe,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,SAAS,eAAe;QACpB,IAAI,CAAC,OAAO,IAAI,UAAU;YAAE,OAAO;QACnC,kEAAkE;QAClE,iEAAiE;QACjE,mEAAmE;QACnE,iEAAiE;QACjE,iEAAiE;QACjE,+DAA+D;QAC/D,kBAAkB;QAClB,IAAI,QAAQ,GAAG,IAAI,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE;YACvB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACxB,MAAM,QAAQ,GAAgB;gBAC1B,OAAO,EAAE,oBAAoB;gBAC7B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACrB,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,YAAY,EAAE,CAAC,CAAC,YAAY;iBAC/B,CAAC,CAAC;aACN,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACX,QAAQ,GAAG,KAAK,CAAC;gBACjB,OAAO;YACX,CAAC;YACD,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,UAAU,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,SAAS,QAAQ,CAAC,QAAqB;QACnC,IAAI,YAAY,IAAI,IAAI;YAAE,YAAY,CAAC,YAAY,CAAC,CAAC;QACrD,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,YAAY,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC;gBACD,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzC,IAAI,CAAC,IAAI,OAAQ,CAAmB,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;oBACvD,CAAmB,CAAC,KAAK,CAAC,GAAG,EAAE;wBAC5B,oDAAoD;wBACpD,mDAAmD;wBACnD,sBAAsB;oBAC1B,CAAC,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,kBAAkB;YACtB,CAAC;QACL,CAAC,EAAE,UAAU,CAAC,CAAC;IACnB,CAAC;IAED,WAAW,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,KAAK,CAAC;QAChB,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,YAAY,CAAC,CAAC;YAC3B,YAAY,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;YACb,UAAU,GAAG,IAAI,CAAC;QACtB,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,CAAU;IAC5B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,GAAG,GAAG,CAA2C,CAAC;IACxD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;QAC3C,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/hooks/use-nav.d.ts

@@ -1,5 +1,5 @@
-import type { RegisteredRoutes, RouteId, RouteParams, RouteSearch } from '../register';
-import type { PopOptions, PushOptions, RouteRequiresParams, StackEntry, TransitionState } from '../types';
+import type { RegisteredRoutes, RouteId, RouteParams, RouteSearch } from '../register.js';
+import type { PopOptions, PushOptions, RouteRequiresParams, StackEntry, TransitionState } from '../types.js';
 /**
  * Subset of registered route names that declare a `params` schema (and so
  * require a `params` argument when navigating).

package/dist/hooks/use-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-nav.d.ts","sourceRoot":"","sources":["../../src/hooks/use-nav.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EACR,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,eAAe,EAClB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG;KAC1B,CAAC,IAAI,OAAO,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK;CACpF,CAAC,OAAO,CAAC,CAAC;AAEX,mDAAmD;AACnD,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,GAAG;IAChB,8CAA8C;IAC9C,IAAI,CAAC,CAAC,SAAS,mBAAmB,EAC9B,IAAI,EAAE,CAAC,EACP,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,GACtB,IAAI,CAAC;IACR,yCAAyC;IACzC,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAC3B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,GACtB,IAAI,CAAC;IAER,6DAA6D;IAC7D,OAAO,CAAC,CAAC,SAAS,mBAAmB,EACjC,IAAI,EAAE,CAAC,EACP,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,GACtB,IAAI,CAAC;IACR,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAC9B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,GACtB,IAAI,CAAC;IAER,wDAAwD;IACxD,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEhD,uDAAuD;IACvD,KAAK,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAExC,yCAAyC;IACzC,SAAS,IAAI,IAAI,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAEzD,8DAA8D;IAC9D,OAAO,IAAI,IAAI,CAAC;IAEhB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAE1C,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;OASG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,sDAIjB,CAAC"}
+{"version":3,"file":"use-nav.d.ts","sourceRoot":"","sources":["../../src/hooks/use-nav.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,KAAK,EACR,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,eAAe,EAClB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG;KAC1B,CAAC,IAAI,OAAO,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK;CACpF,CAAC,OAAO,CAAC,CAAC;AAEX,mDAAmD;AACnD,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,GAAG;IAChB,8CAA8C;IAC9C,IAAI,CAAC,CAAC,SAAS,mBAAmB,EAC9B,IAAI,EAAE,CAAC,EACP,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,GACtB,IAAI,CAAC;IACR,yCAAyC;IACzC,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAC3B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,GACtB,IAAI,CAAC;IAER,6DAA6D;IAC7D,OAAO,CAAC,CAAC,SAAS,mBAAmB,EACjC,IAAI,EAAE,CAAC,EACP,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,GACtB,IAAI,CAAC;IACR,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAC9B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,GACtB,IAAI,CAAC;IAER,wDAAwD;IACxD,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEhD,uDAAuD;IACvD,KAAK,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAExC,yCAAyC;IACzC,SAAS,IAAI,IAAI,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAEzD,8DAA8D;IAC9D,OAAO,IAAI,IAAI,CAAC;IAEhB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAE1C,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;OASG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,sDAIjB,CAAC"}

package/dist/hooks/use-nav.js

@@ -0,0 +1,11 @@
+import { defineInjectable } from '@sigx/lynx';
+/**
+ * Access the innermost navigator. Provided by `<NavigationRoot>` via
+ * `defineProvide`. Throws when called outside a NavigationRoot subtree.
+ *
+ * Mirrors `@sigx/router`'s `useRouter` pattern (`packages/router/src/router.ts:30`).
+ */
+export const useNav = defineInjectable(() => {
+    throw new Error('[lynx-navigation] useNav() called but no <NavigationRoot> is mounted in the component tree.');
+});
+//# sourceMappingURL=use-nav.js.map

package/dist/hooks/use-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nav.js","sourceRoot":"","sources":["../../src/hooks/use-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgJ9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAM,GAAG,EAAE;IAC7C,MAAM,IAAI,KAAK,CACX,6FAA6F,CAChG,CAAC;AACN,CAAC,CAAC,CAAC"}

package/dist/hooks/use-params.d.ts

@@ -1,4 +1,4 @@
-import type { RouteId, RouteParams } from '../register';
+import type { RouteId, RouteParams } from '../register.js';
 /**
  * Read the typed params for the current screen, asserted against the named
  * route from the registry.

package/dist/hooks/use-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-params.d.ts","sourceRoot":"","sources":["../../src/hooks/use-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGxD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAGrE"}
+{"version":3,"file":"use-params.d.ts","sourceRoot":"","sources":["../../src/hooks/use-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAGrE"}

package/{src/hooks/use-params.d.ts → dist/hooks/use-params.js}

@@ -1,4 +1,4 @@
-import type { RouteId, RouteParams } from '../register';
+import { useNav } from './use-nav.js';
 /**
  * Read the typed params for the current screen, asserted against the named
  * route from the registry.
@@ -15,4 +15,8 @@ import type { RouteId, RouteParams } from '../register';
  * update for the same mounted screen" path in v0.1, so a snapshot at setup
  * time is correct.
  */
-export declare function useParams<K extends RouteId>(_name: K): RouteParams<K>;
+export function useParams(_name) {
+    const nav = useNav();
+    return nav.current.params;
+}
+//# sourceMappingURL=use-params.js.map

package/dist/hooks/use-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-params.js","sourceRoot":"","sources":["../../src/hooks/use-params.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS,CAAoB,KAAQ;IACjD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,OAAO,GAAG,CAAC,OAAO,CAAC,MAAwB,CAAC;AAChD,CAAC"}

package/dist/hooks/use-screen-chrome.d.ts

@@ -1,4 +1,4 @@
-import type { ScreenSlotFills } from '../types';
+import type { ScreenSlotFills } from '../types.js';
 export interface ScreenChrome {
     /** Resolved screen title — `options.title` (string or getter) or the route name as fallback. Reactive. */
     readonly title: string;

package/dist/hooks/use-screen-chrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-screen-chrome.d.ts","sourceRoot":"","sources":["../../src/hooks/use-screen-chrome.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,UAAU,CAAC;AAE5D,MAAM,WAAW,YAAY;IACzB,0GAA0G;IAC1G,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+GAA+G;IAC/G,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,6GAA6G;IAC7G,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,GAAG,IAAI,IAAI,CAAC;IACZ,uHAAuH;IACvH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IACvD,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAC/D,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;CACpE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAuE9C"}
+{"version":3,"file":"use-screen-chrome.d.ts","sourceRoot":"","sources":["../../src/hooks/use-screen-chrome.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,YAAY;IACzB,0GAA0G;IAC1G,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+GAA+G;IAC/G,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,6GAA6G;IAC7G,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,GAAG,IAAI,IAAI,CAAC;IACZ,uHAAuH;IACvH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IACvD,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAC/D,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;CACpE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAuE9C"}

package/dist/hooks/use-screen-chrome.js

@@ -0,0 +1,102 @@
+/**
+ * `useScreenChrome` — reactive read of the currently-focused screen's
+ * options + slot fills, plus navigation helpers a header would need
+ * (canGoBack, pop).
+ *
+ * The built-in `<Header />` reads this same data via internal hooks.
+ * `useScreenChrome` exposes it as a public API so theme packages
+ * (`@sigx/lynx-daisyui`, custom designs) can build their own header
+ * components without depending on internal modules.
+ *
+ * Resolution rules:
+ *
+ *  - **Inside a screen body** (i.e. inside an EntryScope whose entry is
+ *    on the nearest `useNav()`'s stack), bind to **this entry's**
+ *    registry. Useful for modal screens that render their own
+ *    NavHeader inside — the chrome slides with the sheet.
+ *  - **Outside any matching EntryScope** (slot of `<Stack>`, persistent
+ *    root-level Header, etc.), bind to the *destination* entry of the
+ *    current nav state — what the navigator is settling on once the
+ *    in-flight transition completes. Push: the new top (already at
+ *    nav.current). Pop: the entry being revealed
+ *    (`transition.underneathEntry`), *not* the one being animated off.
+ *    Using the destination means the bar reflects what the user is
+ *    navigating *to*, immediately, with no end-of-animation snap.
+ *
+ * Every property is a getter — reading inside a render / `computed`
+ * subscribes to the underlying signal, so consumers re-render when
+ * title / slots change.
+ */
+import { useNav } from './use-nav.js';
+import { useCurrentEntryOptional, useNavInternals } from './use-nav-internal.js';
+export function useScreenChrome() {
+    const nav = useNav();
+    const internals = useNavInternals();
+    // The candidate "scoped" entry, if we happen to be rendered inside
+    // an EntryScope. May belong to a DIFFERENT nav than `nav` — e.g.
+    // when NavHeader is placed in a per-tab `<Stack>`'s chrome slot,
+    // it sees the outer (root) EntryScope's entry but its `useNav()`
+    // returns the inner per-tab nav. We only honor the pin when the
+    // entry is actually on this nav's stack; otherwise we're crossing
+    // scopes and the destination-entry path is correct.
+    //
+    // `useCurrentEntryOptional` is the soft companion to
+    // `useCurrentEntry` — it returns `null` outside any EntryScope
+    // rather than throwing, which is the right semantic for a chrome
+    // consumer that *might* be a Stack slot.
+    const candidate = useCurrentEntryOptional();
+    const getDestinationEntry = () => {
+        const t = nav.transition;
+        if (t) {
+            return t.kind === 'pop' ? t.underneathEntry : t.topEntry;
+        }
+        return nav.current;
+    };
+    const getEntry = () => {
+        if (candidate) {
+            const stack = nav.stack;
+            if (stack.some((e) => e.key === candidate.key)) {
+                return candidate;
+            }
+        }
+        return getDestinationEntry();
+    };
+    return {
+        get title() {
+            const entry = getEntry();
+            const reg = internals.screens.get(entry.key);
+            const t = reg?.options.title;
+            if (typeof t === 'function')
+                return t();
+            if (typeof t === 'string')
+                return t;
+            return entry.route;
+        },
+        get headerShown() {
+            const reg = internals.screens.get(getEntry().key);
+            return reg?.options.headerShown !== false;
+        },
+        get canGoBack() {
+            const entry = getEntry();
+            const stack = nav.stack;
+            const idx = stack.findIndex((e) => e.key === entry.key);
+            return idx > 0;
+        },
+        pop() {
+            nav.pop();
+        },
+        get header() {
+            const reg = internals.screens.get(getEntry().key);
+            return reg?.slots.header;
+        },
+        get headerLeft() {
+            const reg = internals.screens.get(getEntry().key);
+            return reg?.slots.headerLeft;
+        },
+        get headerRight() {
+            const reg = internals.screens.get(getEntry().key);
+            return reg?.slots.headerRight;
+        },
+    };
+}
+//# sourceMappingURL=use-screen-chrome.js.map

package/dist/hooks/use-screen-chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-screen-chrome.js","sourceRoot":"","sources":["../../src/hooks/use-screen-chrome.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-screen-options.d.ts

@@ -1,3 +1,3 @@
-import type { ScreenOptions } from '../types';
+import type { ScreenOptions } from '../types.js';
 export declare function useScreenOptions(optionsOrFn: ScreenOptions | (() => ScreenOptions)): void;
 //# sourceMappingURL=use-screen-options.d.ts.map

package/dist/hooks/use-screen-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-screen-options.d.ts","sourceRoot":"","sources":["../../src/hooks/use-screen-options.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,gBAAgB,CAC5B,WAAW,EAAE,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,GACnD,IAAI,CAiBN"}
+{"version":3,"file":"use-screen-options.d.ts","sourceRoot":"","sources":["../../src/hooks/use-screen-options.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,gBAAgB,CAC5B,WAAW,EAAE,aAAa,GAAG,CAAC,MAAM,aAAa,CAAC,GACnD,IAAI,CAiBN"}

package/dist/hooks/use-screen-options.js

@@ -0,0 +1,43 @@
+/**
+ * `useScreenOptions` — imperative merge into the current entry's options.
+ *
+ * Use this when options need to be set from an effect rather than declared
+ * statically via `<Screen title=…>`. The canonical case is "title becomes
+ * known after a fetch":
+ *
+ * ```ts
+ * const user = useFetchUser(id);
+ * useScreenOptions(() => ({
+ *     title: user.value?.displayName ?? 'Loading…',
+ * }));
+ * ```
+ *
+ * The callback runs in a tracked `effect` — any signals it reads cause it
+ * to re-run and re-merge. This is strictly additive: returning a partial
+ * options object only touches the keys it sets, and returning `undefined`
+ * for a key clears it.
+ *
+ * Static usage where the options never change can pass a plain object and
+ * skip the effect — internally we detect that and merge once. Hosts that
+ * pass a getter pay for the subscription; hosts that pass an object don't.
+ */
+import { effect, onUnmounted } from '@sigx/lynx';
+import { useScreenRegistry } from './use-nav-internal.js';
+import { mergeOptions } from '../internal/screen-registry.js';
+export function useScreenOptions(optionsOrFn) {
+    const registry = useScreenRegistry();
+    if (typeof optionsOrFn !== 'function') {
+        mergeOptions(registry, optionsOrFn);
+        return;
+    }
+    // Reactive path: every signal touched inside the getter is tracked, so
+    // the merge re-runs when any of them change. `mergeOptions` does per-key
+    // writes on a deeply-reactive proxy, so consumers (HeaderBar) only
+    // re-render the parts they actually read.
+    const runner = effect(() => {
+        const next = optionsOrFn();
+        mergeOptions(registry, next);
+    });
+    onUnmounted(() => runner.stop());
+}
+//# sourceMappingURL=use-screen-options.js.map

package/dist/hooks/use-screen-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-screen-options.js","sourceRoot":"","sources":["../../src/hooks/use-screen-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D,MAAM,UAAU,gBAAgB,CAC5B,WAAkD;IAElD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IAErC,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QACpC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACpC,OAAO;IACX,CAAC;IAED,uEAAuE;IACvE,yEAAyE;IACzE,mEAAmE;IACnE,0CAA0C;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE;QACvB,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/hooks/use-search.d.ts

@@ -1,4 +1,4 @@
-import type { RouteId, RouteSearch } from '../register';
+import type { RouteId, RouteSearch } from '../register.js';
 /**
  * Read the typed search/query params for the current screen, asserted against
  * the named route from the registry.

package/dist/hooks/use-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-search.d.ts","sourceRoot":"","sources":["../../src/hooks/use-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGxD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAGrE"}
+{"version":3,"file":"use-search.d.ts","sourceRoot":"","sources":["../../src/hooks/use-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG3D;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAGrE"}

package/{src/hooks/use-search.d.ts → dist/hooks/use-search.js}

@@ -1,4 +1,4 @@
-import type { RouteId, RouteSearch } from '../register';
+import { useNav } from './use-nav.js';
 /**
  * Read the typed search/query params for the current screen, asserted against
  * the named route from the registry.
@@ -7,4 +7,8 @@ import type { RouteId, RouteSearch } from '../register';
  * reactivity story — each navigation triggers a remount via the entry-keyed
  * Stack, so a setup-time snapshot is sufficient.
  */
-export declare function useSearch<K extends RouteId>(_name: K): RouteSearch<K>;
+export function useSearch(_name) {
+    const nav = useNav();
+    return nav.current.search;
+}
+//# sourceMappingURL=use-search.js.map

package/dist/hooks/use-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-search.js","sourceRoot":"","sources":["../../src/hooks/use-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAoB,KAAQ;IACjD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,OAAO,GAAG,CAAC,OAAO,CAAC,MAAwB,CAAC;AAChD,CAAC"}

package/dist/href.d.ts

@@ -1,5 +1,5 @@
-import type { RouteId, RouteParams, RouteSearch } from './register';
-import type { RoutesWithoutParams, RoutesWithParams } from './hooks/use-nav';
+import type { RouteId, RouteParams, RouteSearch } from './register.js';
+import type { RoutesWithoutParams, RoutesWithParams } from './hooks/use-nav.js';
 /**
  * A typed reference to a navigation target — what `<Link to={...}>` consumes
  * and what `hrefFor()` produces.

package/dist/href.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"href.d.ts","sourceRoot":"","sources":["../src/href.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAM7E;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAC7C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAClG,wBAAgB,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAC9C,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACxB,IAAI,CAAC,CAAC,CAAC,CAAC;AAkDX;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAElD"}
+{"version":3,"file":"href.d.ts","sourceRoot":"","sources":["../src/href.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAMhF;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAC7C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAClG,wBAAgB,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAC9C,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACxB,IAAI,CAAC,CAAC,CAAC,CAAC;AAkDX;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAElD"}

package/dist/href.js

@@ -0,0 +1,57 @@
+import { buildUrl } from './url/build.js';
+import { parseHrefImpl } from './url/parse.js';
+import { getRouteRegistry } from './url/registry.js';
+import { validateSync } from './url/validate.js';
+export function hrefFor(name, ...args) {
+    const registry = getRouteRegistry();
+    const def = registry.routes[name];
+    if (!def) {
+        throw new Error(`[lynx-navigation] hrefFor('${name}'): route is not in the active registry.`);
+    }
+    // Disambiguate the overloads: routes with a params schema get
+    // (name, params, search?); routes without get (name, search?). The
+    // typed overloads enforce this at compile time, but at runtime we need
+    // to peek at the schema presence to know how to interpret `args`.
+    const hasParamsSchema = !!def.params;
+    let rawParams;
+    let rawSearch;
+    if (hasParamsSchema) {
+        rawParams = args[0];
+        rawSearch = args[1];
+    }
+    else {
+        rawParams = undefined;
+        rawSearch = args[0];
+    }
+    const paramsOutcome = validateSync(def.params, rawParams ?? {});
+    if (!paramsOutcome.ok) {
+        throw new Error(`[lynx-navigation] hrefFor('${name}'): params validation failed — ${paramsOutcome.issues.join('; ')}`);
+    }
+    const searchOutcome = validateSync(def.search, rawSearch ?? {});
+    if (!searchOutcome.ok) {
+        throw new Error(`[lynx-navigation] hrefFor('${name}'): search validation failed — ${searchOutcome.issues.join('; ')}`);
+    }
+    const params = paramsOutcome.value;
+    const search = searchOutcome.value;
+    const url = buildUrl(name, params, search);
+    return {
+        route: name,
+        params: params,
+        search: search,
+        url,
+    };
+}
+/**
+ * Parse a URL string into a typed Href against the registered routes.
+ * Returns `null` if no route's `path` template matches the URL or if the
+ * extracted params/search fail the route's schema validation.
+ *
+ * Accepts both absolute (`myapp://host/path?q`) and pathname-only
+ * (`/path?q`) forms — the pathname is matched against each route's
+ * compiled template. Iteration order is the registration order; first match
+ * wins.
+ */
+export function parseHref(url) {
+    return parseHrefImpl(url);
+}
+//# sourceMappingURL=href.js.map

package/dist/href.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"href.js","sourceRoot":"","sources":["../src/href.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgDjD,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,GAAG,IAAe;IACpD,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACX,8BAA8B,IAAI,0CAA0C,CAC/E,CAAC;IACN,CAAC;IAED,8DAA8D;IAC9D,mEAAmE;IACnE,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IACrC,IAAI,SAA8C,CAAC;IACnD,IAAI,SAA8C,CAAC;IACnD,IAAI,eAAe,EAAE,CAAC;QAClB,SAAS,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAC;QAC3D,SAAS,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACJ,SAAS,GAAG,SAAS,CAAC;QACtB,SAAS,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAC;IAC/D,CAAC;IAED,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACX,8BAA8B,IAAI,kCAAkC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;IACN,CAAC;IACD,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACX,8BAA8B,IAAI,kCAAkC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,KAAgC,CAAC;IAC9D,MAAM,MAAM,GAAG,aAAa,CAAC,KAAgC,CAAC;IAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3C,OAAO;QACH,KAAK,EAAE,IAAe;QACtB,MAAM,EAAE,MAAe;QACvB,MAAM,EAAE,MAAe;QACvB,GAAG;KACN,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACjC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -4,37 +4,37 @@
  * Phase 0.1 (current): typed registry, stack runtime, NavigationRoot + Stack.
  * Coming next: Screen with slot-based header API, MTS transitions, Tabs.
  */
-export { defineRoutes } from './define-routes';
-export type { Register, RegisteredRoutes, RouteId, RouteParams, RouteSearch } from './register';
-export { useNav } from './hooks/use-nav';
-export type { Nav, RoutesWithoutParams, RoutesWithParams } from './hooks/use-nav';
-export { useParams } from './hooks/use-params';
-export { useSearch } from './hooks/use-search';
-export { useHardwareBack } from './hooks/use-hardware-back';
-export { useLinkingNav } from './hooks/use-linking-nav';
-export type { UseLinkingNavOptions } from './hooks/use-linking-nav';
-export { useIsFocused, useFocusEffect } from './hooks/use-focus';
-export { useScreenOptions } from './hooks/use-screen-options';
-export { useScreenChrome } from './hooks/use-screen-chrome';
-export type { ScreenChrome } from './hooks/use-screen-chrome';
-export { useNavSerializer, NAV_SNAPSHOT_VERSION, } from './hooks/use-nav-serializer';
-export type { NavSnapshot, NavStorageAdapter, UseNavSerializerOptions, } from './hooks/use-nav-serializer';
-export { hrefFor, parseHref } from './href';
-export type { Href } from './href';
-export { _setRouteRegistry, _clearRouteRegistry } from './url/registry';
-export { compilePath } from './url/compile';
-export type { CompiledPath } from './url/compile';
-export { NavigationRoot } from './components/NavigationRoot';
-export { Stack } from './components/Stack';
-export { Screen } from './components/Screen';
-export { Header } from './components/Header';
-export { Tabs, useTabs } from './components/Tabs';
-export type { TabInfo, TabsNav } from './components/Tabs';
-export { TabBar } from './components/TabBar';
-export type { TabRenderContext } from './components/TabBar';
-export { Drawer, useDrawer } from './components/Drawer';
-export type { DrawerNav } from './components/Drawer';
-export { Link } from './components/Link';
-export type { LinkProps } from './components/Link';
-export type { ComponentLike, EmptyParams, InferOutput, ParamsOf, PopOptions, Presentation, PushOptions, RouteDefinition, RouteMap, RouteRequiresParams, ScreenOptions, ScreenSlotFills, SearchOf, StackEntry, StandardSchemaV1, TransitionKind, TransitionRole, TransitionState, } from './types';
+export { defineRoutes } from './define-routes.js';
+export type { Register, RegisteredRoutes, RouteId, RouteParams, RouteSearch } from './register.js';
+export { useNav } from './hooks/use-nav.js';
+export type { Nav, RoutesWithoutParams, RoutesWithParams } from './hooks/use-nav.js';
+export { useParams } from './hooks/use-params.js';
+export { useSearch } from './hooks/use-search.js';
+export { useHardwareBack } from './hooks/use-hardware-back.js';
+export { useLinkingNav } from './hooks/use-linking-nav.js';
+export type { UseLinkingNavOptions } from './hooks/use-linking-nav.js';
+export { useIsFocused, useFocusEffect } from './hooks/use-focus.js';
+export { useScreenOptions } from './hooks/use-screen-options.js';
+export { useScreenChrome } from './hooks/use-screen-chrome.js';
+export type { ScreenChrome } from './hooks/use-screen-chrome.js';
+export { useNavSerializer, NAV_SNAPSHOT_VERSION, } from './hooks/use-nav-serializer.js';
+export type { NavSnapshot, NavStorageAdapter, UseNavSerializerOptions, } from './hooks/use-nav-serializer.js';
+export { hrefFor, parseHref } from './href.js';
+export type { Href } from './href.js';
+export { _setRouteRegistry, _clearRouteRegistry } from './url/registry.js';
+export { compilePath } from './url/compile.js';
+export type { CompiledPath } from './url/compile.js';
+export { NavigationRoot } from './components/NavigationRoot.js';
+export { Stack } from './components/Stack.js';
+export { Screen } from './components/Screen.js';
+export { Header } from './components/Header.js';
+export { Tabs, useTabs } from './components/Tabs.js';
+export type { TabInfo, TabsNav } from './components/Tabs.js';
+export { TabBar } from './components/TabBar.js';
+export type { TabRenderContext } from './components/TabBar.js';
+export { Drawer, useDrawer } from './components/Drawer.js';
+export type { DrawerNav } from './components/Drawer.js';
+export { Link } from './components/Link.js';
+export type { LinkProps } from './components/Link.js';
+export type { ComponentLike, EmptyParams, InferOutput, ParamsOf, PopOptions, Presentation, PushOptions, RouteDefinition, RouteMap, RouteRequiresParams, ScreenOptions, ScreenSlotFills, SearchOf, StackEntry, StandardSchemaV1, TransitionKind, TransitionRole, TransitionState, } from './types.js';
 //# sourceMappingURL=index.d.ts.map