@sigx/lynx-navigation 0.1.0 → 0.1.2

package/dist/hooks/use-hardware-back.js

@@ -0,0 +1,50 @@
+import { onMounted } from '@sigx/lynx';
+import { BackHandler } from '@sigx/lynx-linking';
+import { useNav } from './use-nav.js';
+/**
+ * Wire the Android hardware back button to the active navigator.
+ *
+ * Listens for `hardwareBackPress` events from `@sigx/lynx-linking`'s
+ * `BackHandler` (which the native side dispatches from
+ * `MainActivity.onBackPressed`). On press:
+ *
+ *   - If `nav.canGoBack` → `nav.pop()`.
+ *   - Otherwise → `BackHandler.exitApp()` (Android: `moveTaskToBack(true)`,
+ *     keeps the bundle warm; iOS: rejects, since iOS doesn't permit
+ *     programmatic termination).
+ *
+ * Call this once in any component under `<NavigationRoot>` (typically a
+ * thin wrapper sibling to `<Stack />`). iOS doesn't fire the event so the
+ * hook is a no-op there.
+ *
+ * @example
+ * ```tsx
+ * const BackHandlerWiring = component(() => {
+ *     useHardwareBack();
+ *     return () => null;
+ * });
+ *
+ * <NavigationRoot routes={routes}>
+ *     <BackHandlerWiring />
+ *     <Stack />
+ * </NavigationRoot>
+ * ```
+ */
+export function useHardwareBack() {
+    const nav = useNav();
+    onMounted(() => {
+        const sub = BackHandler.addEventListener(() => {
+            if (nav.canGoBack) {
+                nav.pop();
+                return true;
+            }
+            // At the root — leave the app. Promise is fire-and-forget; we
+            // don't await because we want the back press to feel instant
+            // (Android starts the move-to-back transition immediately).
+            void BackHandler.exitApp();
+            return true;
+        });
+        return () => sub.remove();
+    });
+}
+//# sourceMappingURL=use-hardware-back.js.map

package/dist/hooks/use-hardware-back.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hardware-back.js","sourceRoot":"","sources":["../../src/hooks/use-hardware-back.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,eAAe;IAC3B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,GAAG,GAAG,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE;YAC1C,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBAChB,GAAG,CAAC,GAAG,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,8DAA8D;YAC9D,6DAA6D;YAC7D,4DAA4D;YAC5D,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,92 @@
+import { type Href } from '../href.js';
+import { type Nav } from './use-nav.js';
+import type { RouteMap } from '../types.js';
+export interface UseLinkingNavOptions {
+    /**
+     * Schemes/prefixes to strip before parsing. Matched in order; the first
+     * match wins. Example: `['myapp://', 'https://myapp.com']` lets
+     * `https://myapp.com/users/42` parse against the same routes as
+     * `/users/42`.
+     *
+     * After stripping, a leading `/` is added if missing so the result is a
+     * valid pathname.
+     */
+    prefixes?: string[];
+    /**
+     * Custom handler invoked instead of the default dispatch. Use this when
+     * you need to intercept (e.g. for auth callbacks, analytics) before
+     * routing. If you call `nav.push` / `nav.replace` from here, the default
+     * dispatch is skipped — return `void`.
+     */
+    onURL?: (url: string, nav: Nav) => void;
+    /**
+     * Called when an incoming URL doesn't match any registered route's `path`
+     * template (or fails schema validation). Defaults to a no-op so unknown
+     * URLs are dropped silently. Use this to surface "page not found" UX or
+     * to forward to a catch-all route.
+     */
+    onUnmatched?: (url: string) => void;
+    /**
+     * Whether to use `nav.replace` instead of `nav.push` for the cold-start
+     * initial URL. Defaults to `true` — restoring an app into a deep link
+     * shouldn't leave a stray "initial route" entry beneath it that the back
+     * button can return to.
+     *
+     * Runtime URLs (from `addEventListener`) always `push`.
+     */
+    replaceInitial?: boolean;
+}
+/**
+ * Bridge `@sigx/lynx-linking` URL events into a `@sigx/lynx-navigation`
+ * navigator. Call once inside a `<NavigationRoot>` subtree.
+ *
+ * Handles both delivery modes:
+ *   - **cold start** — `Linking.getInitialURL()` is read on mount and, if
+ *     present, dispatched (replacing the initial route by default).
+ *   - **warm start** — `Linking.addEventListener('url', ...)` subscribes for
+ *     URLs delivered while the app is already running; each one is pushed.
+ *
+ * URL → route dispatch goes through `parseHref`, which matches the URL's
+ * pathname against the route registry seeded by `<NavigationRoot>`. Routes
+ * without a `path` template are never matched by deep links — only typed
+ * `<Link>` / `nav.push` calls reach them.
+ *
+ * @example
+ * ```tsx
+ * import { useLinkingNav } from '@sigx/lynx-navigation';
+ *
+ * const DeepLinks = component(() => {
+ *     useLinkingNav({
+ *         prefixes: ['myapp://', 'https://myapp.com'],
+ *         onUnmatched: (url) => console.warn('Unknown deep link:', url),
+ *     });
+ *     return () => null;
+ * });
+ *
+ * <NavigationRoot routes={routes}>
+ *     <DeepLinks />
+ *     <Stack />
+ * </NavigationRoot>
+ * ```
+ */
+export declare function useLinkingNav(opts?: UseLinkingNavOptions): void;
+/**
+ * Strip the first matching prefix from `url`, returning a pathname-like
+ * string. If no prefixes are provided, or none match, the original URL is
+ * returned unchanged so `parseHref` can still handle scheme-prefixed forms
+ * via `@sigx/lynx-linking`'s `parse`.
+ *
+ * Exported for unit testing — not part of the package public API.
+ */
+export declare function _stripPrefix(url: string, prefixes?: string[]): string;
+/**
+ * Call the right `nav.push` / `nav.replace` overload for `href`. The
+ * overloads differ in positional layout: routes with a params schema take
+ * `(name, params, search?, options?)`; routes without take `(name, search?,
+ * options?)`. Calling the wrong shape silently shifts `search` into the
+ * `options` slot, so we look the route up in the registry and branch.
+ *
+ * Exported for unit testing — not part of the package public API.
+ */
+export declare function _navigateToHref(nav: Nav, routes: RouteMap, href: Href, kind: 'push' | 'replace'): void;
+//# sourceMappingURL=use-linking-nav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-linking-nav.d.ts","sourceRoot":"","sources":["../../src/hooks/use-linking-nav.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAU,KAAK,GAAG,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAExC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,IAAI,CA0BnE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CASrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC3B,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,GAAG,SAAS,GACzB,IAAI,CAkBN"}

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

@@ -0,0 +1,109 @@
+import { onMounted } from '@sigx/lynx';
+import { Linking } from '@sigx/lynx-linking';
+import { parseHref } from '../href.js';
+import { useNav } from './use-nav.js';
+import { useNavRoutes } from './use-nav-internal.js';
+/**
+ * Bridge `@sigx/lynx-linking` URL events into a `@sigx/lynx-navigation`
+ * navigator. Call once inside a `<NavigationRoot>` subtree.
+ *
+ * Handles both delivery modes:
+ *   - **cold start** — `Linking.getInitialURL()` is read on mount and, if
+ *     present, dispatched (replacing the initial route by default).
+ *   - **warm start** — `Linking.addEventListener('url', ...)` subscribes for
+ *     URLs delivered while the app is already running; each one is pushed.
+ *
+ * URL → route dispatch goes through `parseHref`, which matches the URL's
+ * pathname against the route registry seeded by `<NavigationRoot>`. Routes
+ * without a `path` template are never matched by deep links — only typed
+ * `<Link>` / `nav.push` calls reach them.
+ *
+ * @example
+ * ```tsx
+ * import { useLinkingNav } from '@sigx/lynx-navigation';
+ *
+ * const DeepLinks = component(() => {
+ *     useLinkingNav({
+ *         prefixes: ['myapp://', 'https://myapp.com'],
+ *         onUnmatched: (url) => console.warn('Unknown deep link:', url),
+ *     });
+ *     return () => null;
+ * });
+ *
+ * <NavigationRoot routes={routes}>
+ *     <DeepLinks />
+ *     <Stack />
+ * </NavigationRoot>
+ * ```
+ */
+export function useLinkingNav(opts = {}) {
+    const nav = useNav();
+    const routes = useNavRoutes();
+    const dispatch = (url, kind) => {
+        if (opts.onURL) {
+            opts.onURL(url, nav);
+            return;
+        }
+        const stripped = _stripPrefix(url, opts.prefixes);
+        const href = parseHref(stripped);
+        if (!href) {
+            opts.onUnmatched?.(url);
+            return;
+        }
+        _navigateToHref(nav, routes, href, kind);
+    };
+    onMounted(() => {
+        const initial = Linking.getInitialURL();
+        if (initial) {
+            dispatch(initial, opts.replaceInitial === false ? 'push' : 'replace');
+        }
+        const sub = Linking.addEventListener('url', (e) => dispatch(e.url, 'push'));
+        return () => sub.remove();
+    });
+}
+/**
+ * Strip the first matching prefix from `url`, returning a pathname-like
+ * string. If no prefixes are provided, or none match, the original URL is
+ * returned unchanged so `parseHref` can still handle scheme-prefixed forms
+ * via `@sigx/lynx-linking`'s `parse`.
+ *
+ * Exported for unit testing — not part of the package public API.
+ */
+export function _stripPrefix(url, prefixes) {
+    if (!prefixes || prefixes.length === 0)
+        return url;
+    for (const prefix of prefixes) {
+        if (url.startsWith(prefix)) {
+            const rest = url.slice(prefix.length);
+            return rest.startsWith('/') ? rest : `/${rest}`;
+        }
+    }
+    return url;
+}
+/**
+ * Call the right `nav.push` / `nav.replace` overload for `href`. The
+ * overloads differ in positional layout: routes with a params schema take
+ * `(name, params, search?, options?)`; routes without take `(name, search?,
+ * options?)`. Calling the wrong shape silently shifts `search` into the
+ * `options` slot, so we look the route up in the registry and branch.
+ *
+ * Exported for unit testing — not part of the package public API.
+ */
+export function _navigateToHref(nav, routes, href, kind) {
+    const def = routes[href.route];
+    // Defensive: `parseHref` already validated against the registry, so this
+    // really shouldn't happen — but if the registry was cleared between
+    // parse and dispatch (multi-NavigationRoot scenarios), bail rather than
+    // throw.
+    if (!def)
+        return;
+    const hasParams = !!def.params;
+    const action = kind === 'replace' ? nav.replace : nav.push;
+    if (hasParams) {
+        action(href.route, href.params, href.search);
+    }
+    else {
+        action(href.route, href.search);
+    }
+}
+//# sourceMappingURL=use-linking-nav.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-linking-nav.js","sourceRoot":"","sources":["../../src/hooks/use-linking-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,MAAM,EAAY,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA0CrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B,EAAE;IACzD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,IAAwB,EAAQ,EAAE;QAC7D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACrB,OAAO;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO;QACX,CAAC;QACD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACV,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5E,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,QAAmB;IACzD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACpD,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC3B,GAAQ,EACR,MAAgB,EAChB,IAAU,EACV,IAAwB;IAExB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,yEAAyE;IACzE,oEAAoE;IACpE,wEAAwE;IACxE,SAAS;IACT,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACX,MAAuD,CACpD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,CACd,CAAC;IACN,CAAC;SAAM,CAAC;QACH,MAA2C,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;AACL,CAAC"}

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

@@ -1,5 +1,18 @@
 import { type SharedValue } from '@sigx/lynx';
-import type { RouteMap } from '../types.js';
+import type { ScreenRegistry } from '../internal/screen-registry.js';
+import type { RouteMap, StackEntry } from '../types.js';
+/**
+ * Internal injectable: the `StackEntry` the calling screen was rendered for.
+ *
+ * Provided by `<EntryScope>` which `<Stack>` and `<ScreenContainer>` wrap
+ * around each screen component mount. Screens use this to derive their own
+ * focus state (`useIsFocused`, `useFocusEffect`) without having to track
+ * `entry.key` themselves.
+ *
+ * Default throws so calling `useIsFocused()` outside a screen mounted by a
+ * navigator surfaces a clear error rather than silently returning `false`.
+ */
+export declare const useCurrentEntry: import("@sigx/runtime-core").InjectableFunction<StackEntry<string, unknown, unknown>>;
 /**
  * Internal injectable: the route registry passed into `<NavigationRoot>`.
  * Components (Stack, Screen) read this to look up route definitions by name.
@@ -32,6 +45,30 @@ export interface NavInternals {
     cancelBackGesture(): void;
     /** Whether the user opted into the edge-swipe-back gesture. */
     readonly edgeSwipeEnabled: boolean;
+    /**
+     * Cross-entry screen registry controller. `<EntryScope>` calls
+     * `register` on mount and `unregister` on unmount. Persistent chrome
+     * (HeaderBar / TabBar — later slices) calls `get(entryKey)` to read
+     * the focused screen's options + slot fills without remounting itself.
+     */
+    readonly screens: {
+        register(registry: ScreenRegistry): void;
+        unregister(entryKey: string): void;
+        get(entryKey: string): ScreenRegistry | undefined;
+    };
 }
 export declare const useNavInternals: import("@sigx/runtime-core").InjectableFunction<NavInternals>;
+/**
+ * Internal injectable: the calling screen's `ScreenRegistry`.
+ *
+ * Provided by `<EntryScope>` alongside `useCurrentEntry`. The `<Screen>`
+ * component and its slot-filling sub-components write options and slot
+ * fills here; the navigator's persistent chrome (HeaderBar, TabBar — later
+ * slices) reads from this registry via `getScreenRegistry(key)` on the
+ * navigator state, which keys into a cross-entry map.
+ *
+ * Throws when used outside an EntryScope so calling `<Screen>` at the app
+ * root surfaces a clear error rather than silently no-op'ing.
+ */
+export declare const useScreenRegistry: import("@sigx/runtime-core").InjectableFunction<ScreenRegistry>;
 //# sourceMappingURL=use-nav-internal.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-nav-internal.d.ts","sourceRoot":"","sources":["../../src/hooks/use-nav-internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,2DAIvB,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IACzB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C;;;;OAIG;IACH,gBAAgB,IAAI,IAAI,CAAC;IACzB,iEAAiE;IACjE,iBAAiB,IAAI,IAAI,CAAC;IAC1B,iEAAiE;IACjE,iBAAiB,IAAI,IAAI,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACtC;AAED,eAAO,MAAM,eAAe,+DAI1B,CAAC"}
+{"version":3,"file":"use-nav-internal.d.ts","sourceRoot":"","sources":["../../src/hooks/use-nav-internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,uFAI1B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,2DAIvB,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IACzB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C;;;;OAIG;IACH,gBAAgB,IAAI,IAAI,CAAC;IACzB,iEAAiE;IACjE,iBAAiB,IAAI,IAAI,CAAC;IAC1B,iEAAiE;IACjE,iBAAiB,IAAI,IAAI,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE;QACd,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;QACzC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;KACrD,CAAC;CACL;AAED,eAAO,MAAM,eAAe,+DAI1B,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,iEAI5B,CAAC"}

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

@@ -1,4 +1,18 @@
 import { defineInjectable } from '@sigx/lynx';
+/**
+ * Internal injectable: the `StackEntry` the calling screen was rendered for.
+ *
+ * Provided by `<EntryScope>` which `<Stack>` and `<ScreenContainer>` wrap
+ * around each screen component mount. Screens use this to derive their own
+ * focus state (`useIsFocused`, `useFocusEffect`) without having to track
+ * `entry.key` themselves.
+ *
+ * Default throws so calling `useIsFocused()` outside a screen mounted by a
+ * navigator surfaces a clear error rather than silently returning `false`.
+ */
+export const useCurrentEntry = defineInjectable(() => {
+    throw new Error('[lynx-navigation] No screen entry in scope. `useIsFocused` / `useFocusEffect` must be called from a component rendered as a route by <Stack>.');
+});
 /**
  * Internal injectable: the route registry passed into `<NavigationRoot>`.
  * Components (Stack, Screen) read this to look up route definitions by name.
@@ -9,4 +23,22 @@ import { defineInjectable } from '@sigx/lynx';
 export const useNavRoutes = defineInjectable(() => {
     throw new Error('[lynx-navigation] No <NavigationRoot> found in the component tree.');
 });
+export const useNavInternals = defineInjectable(() => {
+    throw new Error('[lynx-navigation] No <NavigationRoot> found in the component tree.');
+});
+/**
+ * Internal injectable: the calling screen's `ScreenRegistry`.
+ *
+ * Provided by `<EntryScope>` alongside `useCurrentEntry`. The `<Screen>`
+ * component and its slot-filling sub-components write options and slot
+ * fills here; the navigator's persistent chrome (HeaderBar, TabBar — later
+ * slices) reads from this registry via `getScreenRegistry(key)` on the
+ * navigator state, which keys into a cross-entry map.
+ *
+ * Throws when used outside an EntryScope so calling `<Screen>` at the app
+ * root surfaces a clear error rather than silently no-op'ing.
+ */
+export const useScreenRegistry = defineInjectable(() => {
+    throw new Error('[lynx-navigation] No screen registry in scope. `<Screen>` (and `<Screen.Header>`, etc.) must be used inside a route component rendered by `<Stack>`.');
+});
 //# sourceMappingURL=use-nav-internal.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-nav-internal.js","sourceRoot":"","sources":["../../src/hooks/use-nav-internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAW,GAAG,EAAE;IACxD,MAAM,IAAI,KAAK,CACX,oEAAoE,CACvE,CAAC;AACN,CAAC,CAAC,CAAC"}
+{"version":3,"file":"use-nav-internal.js","sourceRoot":"","sources":["../../src/hooks/use-nav-internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAIhE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAa,GAAG,EAAE;IAC7D,MAAM,IAAI,KAAK,CACX,+IAA+I,CAClJ,CAAC;AACN,CAAC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAW,GAAG,EAAE;IACxD,MAAM,IAAI,KAAK,CACX,oEAAoE,CACvE,CAAC;AACN,CAAC,CAAC,CAAC;AAuCH,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAe,GAAG,EAAE;IAC/D,MAAM,IAAI,KAAK,CACX,oEAAoE,CACvE,CAAC;AACN,CAAC,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAiB,GAAG,EAAE;IACnE,MAAM,IAAI,KAAK,CACX,sJAAsJ,CACzJ,CAAC;AACN,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,83 @@
+import type { StackEntry } from '../types.js';
+/**
+ * Plain JSON snapshot of a navigator. The whole point of holding navigation
+ * state in signals is that this is a one-liner — `JSON.stringify(nav.stack)`.
+ *
+ * Shape is deliberately minimal:
+ *
+ *   {
+ *     version: 1,
+ *     stack: [ { key, route, params, search, state, presentation }, ... ],
+ *   }
+ *
+ * `version` lets future schema migrations (or hard breakage) reject old
+ * snapshots cleanly rather than restoring incompatible state.
+ *
+ * Per spec resolved-decisions: only the root navigator is persisted in v1.
+ * Per-tab / nested-navigator stacks are deferred until the nested-navigators
+ * follow-up slice lands.
+ */
+export interface NavSnapshot {
+    version: number;
+    stack: StackEntry[];
+}
+export declare const NAV_SNAPSHOT_VERSION = 1;
+/**
+ * Adapter contract for `useNavSerializer`. Implementations bridge to whatever
+ * storage backend the host app uses — `@sigx/lynx-storage`, `localStorage`,
+ * an MMKV bridge, etc. Both methods may be async; the hook awaits load before
+ * applying anything to the stack and fires save in a debounced manner.
+ *
+ *   - `load()` returns `null` (or rejects) when no snapshot exists, when the
+ *     stored payload is malformed, or when the host opts not to restore on
+ *     this launch.
+ *   - `save(snapshot)` persists the latest stack. The hook drops save errors
+ *     on the floor — losing a write is preferable to crashing the navigator.
+ */
+export interface NavStorageAdapter {
+    load(): Promise<NavSnapshot | null> | NavSnapshot | null;
+    save(snapshot: NavSnapshot): Promise<void> | void;
+}
+export interface UseNavSerializerOptions {
+    storage: NavStorageAdapter;
+    /**
+     * Trailing-edge debounce in ms before pushing a stack change to storage.
+     * Defaults to 250ms — quick enough that a force-quit one tick after a
+     * push is recoverable, slow enough that rapid `pop/push` flurries
+     * coalesce into one write.
+     */
+    debounceMs?: number;
+    /**
+     * Optional callback after a successful restore — lets the host run
+     * post-restore wiring (analytics, focus shifts, etc.) only when we
+     * actually applied state, not on every mount.
+     */
+    onRestored?: (snapshot: NavSnapshot) => void;
+    /**
+     * Optional callback when a snapshot is rejected (validation failed or
+     * load threw). Defaults to silent. Useful for logging during migration.
+     */
+    onRestoreError?: (reason: 'version' | 'shape' | 'unknown-route' | 'load-threw', err?: unknown) => void;
+}
+/**
+ * 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 declare function useNavSerializer(options: UseNavSerializerOptions): void;
+//# sourceMappingURL=use-nav-serializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-nav-serializer.d.ts","sourceRoot":"","sources":["../../src/hooks/use-nav-serializer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,iBAAiB,CAAC;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,YAAY,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1G;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAsIvE"}

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":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-nav.js","sourceRoot":"","sources":["../../src/hooks/use-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA6F9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAM,GAAG,EAAE;IAC7C,MAAM,IAAI,KAAK,CACX,6FAA6F,CAChG,CAAC;AACN,CAAC,CAAC,CAAC"}
+{"version":3,"file":"use-nav.js","sourceRoot":"","sources":["../../src/hooks/use-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2G9C;;;;;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-screen-options.d.ts

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