@sigx/lynx-navigation 0.1.0 → 0.1.2

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

@@ -0,0 +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,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/href.d.ts

@@ -23,6 +23,15 @@ export interface Href<K extends RouteId = RouteId> {
  * params schema, one for routes that require params. See `RoutesWithParams`
  * in `./hooks/use-nav.js` for why this isn't expressed as a single conditional.
  *
+ * Requires a `<NavigationRoot>` (or an explicit `_setRouteRegistry` call) to
+ * have run — the URL form is built against the active route registry. The
+ * typed pieces (`route`, `params`, `search`) are returned regardless; `url`
+ * is `null` when the route declares no `path` template.
+ *
+ * Schema validation errors throw — pass already-validated values from
+ * `useParams` / `useSearch` to round-trip safely, or wrap in try/catch when
+ * building hrefs from external input.
+ *
  * @example
  * ```ts
  * hrefFor('profile', { id: '42' });               // → { route, params, search: {}, url: '/users/42' }
@@ -34,7 +43,13 @@ export declare function hrefFor<K extends RoutesWithoutParams>(name: K, search?:
 export declare function hrefFor<K extends RoutesWithParams>(name: K, params: RouteParams<K>, search?: RouteSearch<K>): Href<K>;
 /**
  * Parse a URL string into a typed Href against the registered routes.
- * Returns `null` if no route's `path` template matches.
+ * 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 declare function parseHref(url: string): Href | null;
 //# sourceMappingURL=href.d.ts.map

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,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEhF;;;;;;;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;;;;;;;;;;;;;;GAcG;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;AASX;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAKlD"}
+{"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

@@ -1,14 +1,57 @@
-export function hrefFor(name, ..._args) {
-    void name;
-    void _args;
-    throw new Error('hrefFor() runtime is not implemented yet — this is the type spike.');
+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.
+ * 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) {
-    void url;
-    throw new Error('parseHref() runtime is not implemented yet — this is the type spike.');
+    return parseHrefImpl(url);
 }
 //# sourceMappingURL=href.js.map

package/dist/href.js.map

@@ -1 +1 @@
-{"version":3,"file":"href.js","sourceRoot":"","sources":["../src/href.ts"],"names":[],"mappings":"AAwCA,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,GAAG,KAAgB;IACrD,KAAK,IAAI,CAAC;IACV,KAAK,KAAK,CAAC;IACX,MAAM,IAAI,KAAK,CACX,oEAAoE,CACvE,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACjC,KAAK,GAAG,CAAC;IACT,MAAM,IAAI,KAAK,CACX,sEAAsE,CACzE,CAAC;AACN,CAAC"}
+{"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

@@ -11,11 +11,28 @@ export type { Nav, RoutesWithoutParams, RoutesWithParams } from './hooks/use-nav
 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 { 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, SearchOf, StackEntry, StandardSchemaV1, TransitionKind, TransitionRole, TransitionState, } from './types.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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,GAAG,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,QAAQ,EACR,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,GAAG,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACH,gBAAgB,EAChB,oBAAoB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACR,WAAW,EACX,iBAAiB,EACjB,uBAAuB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAItC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,QAAQ,EACR,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -8,8 +8,23 @@ export { defineRoutes } from './define-routes.js';
 export { useNav } 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 { useIsFocused, useFocusEffect } from './hooks/use-focus.js';
+export { useScreenOptions } from './hooks/use-screen-options.js';
+export { useNavSerializer, NAV_SNAPSHOT_VERSION, } from './hooks/use-nav-serializer.js';
 export { hrefFor, parseHref } from './href.js';
+// URL bridge internals: `_setRouteRegistry` is a leading-underscore export —
+// intended for tests, deep-link bootstrap before a NavigationRoot mounts, and
+// any other integration that needs to seed the registry imperatively.
+export { _setRouteRegistry, _clearRouteRegistry } from './url/registry.js';
+export { compilePath } 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 { TabBar } from './components/TabBar.js';
+export { Drawer, useDrawer } from './components/Drawer.js';
 export { Link } from './components/Link.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACH,gBAAgB,EAChB,oBAAoB,GACvB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE/C,6EAA6E;AAC7E,8EAA8E;AAC9E,sEAAsE;AACtE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/internal/screen-registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Per-entry registry of `<Screen>` options + slot fills.
+ *
+ * Each `<EntryScope>` allocates one of these on mount and provides it to
+ * descendants via `defineProvide(useScreenRegistry, ...)`. The Screen
+ * component and its sub-components (`<Screen.Header>`, `<Screen.HeaderLeft>`,
+ * `<Screen.HeaderRight>`, `<Screen.TabBarItem>`) write into the registry as
+ * they mount.
+ *
+ * Reads track because options/slots are stored in signals — when a child
+ * re-renders and registers a new slot fill, the navigator-side consumer
+ * (HeaderBar / TabBar, shipped in later slices) reactively updates.
+ *
+ * Cross-entry lookup is exposed via the navigator's `getScreenRegistry(key)`
+ * so a persistent HeaderBar can read slots from the currently-focused entry
+ * without needing to be itself remounted on each navigation.
+ */
+import { type Signal } from '@sigx/lynx';
+import type { ScreenOptions, ScreenSlotFills, StackEntry } from '../types.js';
+/**
+ * Reactive container for one screen's options and slot fills.
+ *
+ * `options` and `slots` are deeply-reactive object signals (sigx's `signal()`
+ * of an object returns a Proxy that tracks per-key reads and notifies
+ * per-key writes). Writers assign individual keys; readers subscribe to the
+ * keys they actually use — no whole-object reads, no read/write cycles in
+ * setup.
+ */
+export interface ScreenRegistry {
+    readonly entry: StackEntry;
+    /** Reactive ScreenOptions — written per-key by `<Screen>`. */
+    readonly options: Signal<ScreenOptions>;
+    /** Reactive ScreenSlotFills — written per-key by `<Screen.Header>` et al. */
+    readonly slots: Signal<ScreenSlotFills>;
+}
+/** Create a fresh registry for an entry. Options and slots start empty. */
+export declare function createScreenRegistry(entry: StackEntry): ScreenRegistry;
+/**
+ * Set a single slot fill on a registry. Pass `undefined` to clear.
+ * Per-key write on the proxy — does not read other keys, so it can't loop
+ * with effects that read different slot keys.
+ */
+export declare function setSlot<K extends keyof ScreenSlotFills>(registry: ScreenRegistry, name: K, fill: ScreenSlotFills[K] | undefined): void;
+/**
+ * Merge partial options into a registry. Each option key is written
+ * independently on the proxy — `undefined` keys clear that option.
+ */
+export declare function mergeOptions(registry: ScreenRegistry, patch: ScreenOptions): void;
+//# sourceMappingURL=screen-registry.d.ts.map

package/dist/internal/screen-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-registry.d.ts","sourceRoot":"","sources":["../../src/internal/screen-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACR,aAAa,EACb,eAAe,EACf,UAAU,EACb,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;CAC3C;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,eAAe,EACnD,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,GACrC,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CACxB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,aAAa,GACrB,IAAI,CAYN"}

package/dist/internal/screen-registry.js

@@ -0,0 +1,59 @@
+/**
+ * Per-entry registry of `<Screen>` options + slot fills.
+ *
+ * Each `<EntryScope>` allocates one of these on mount and provides it to
+ * descendants via `defineProvide(useScreenRegistry, ...)`. The Screen
+ * component and its sub-components (`<Screen.Header>`, `<Screen.HeaderLeft>`,
+ * `<Screen.HeaderRight>`, `<Screen.TabBarItem>`) write into the registry as
+ * they mount.
+ *
+ * Reads track because options/slots are stored in signals — when a child
+ * re-renders and registers a new slot fill, the navigator-side consumer
+ * (HeaderBar / TabBar, shipped in later slices) reactively updates.
+ *
+ * Cross-entry lookup is exposed via the navigator's `getScreenRegistry(key)`
+ * so a persistent HeaderBar can read slots from the currently-focused entry
+ * without needing to be itself remounted on each navigation.
+ */
+import { signal } from '@sigx/lynx';
+/** Create a fresh registry for an entry. Options and slots start empty. */
+export function createScreenRegistry(entry) {
+    return {
+        entry,
+        options: signal({}),
+        slots: signal({}),
+    };
+}
+/**
+ * Set a single slot fill on a registry. Pass `undefined` to clear.
+ * Per-key write on the proxy — does not read other keys, so it can't loop
+ * with effects that read different slot keys.
+ */
+export function setSlot(registry, name, fill) {
+    if (fill === undefined) {
+        // Assigning undefined keeps the key around in the proxy; explicit
+        // delete is what consumers checking `name in slots` expect.
+        delete registry.slots[name];
+        return;
+    }
+    registry.slots[name] = fill;
+}
+/**
+ * Merge partial options into a registry. Each option key is written
+ * independently on the proxy — `undefined` keys clear that option.
+ */
+export function mergeOptions(registry, patch) {
+    for (const key of Object.keys(patch)) {
+        const v = patch[key];
+        if (v === undefined) {
+            delete registry.options[key];
+        }
+        else {
+            // Property-level assignment on a deeply-reactive proxy: notifies
+            // only subscribers of this specific key, never reads the whole
+            // options object, so it can't trigger the setup that wrote it.
+            registry.options[key] = v;
+        }
+    }
+}
+//# sourceMappingURL=screen-registry.js.map

package/dist/internal/screen-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-registry.js","sourceRoot":"","sources":["../../src/internal/screen-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAe,MAAM,YAAY,CAAC;AAwBjD,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IAClD,OAAO;QACH,KAAK;QACL,OAAO,EAAE,MAAM,CAAgB,EAAE,CAAC;QAClC,KAAK,EAAE,MAAM,CAAkB,EAAE,CAAC;KACrC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACnB,QAAwB,EACxB,IAAO,EACP,IAAoC;IAEpC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,kEAAkE;QAClE,4DAA4D;QAC5D,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO;IACX,CAAC;IACA,QAAQ,CAAC,KAAyB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CACxB,QAAwB,EACxB,KAAoB;IAEpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAA4B,EAAE,CAAC;QAC9D,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAClB,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACJ,iEAAiE;YACjE,+DAA+D;YAC/D,+DAA+D;YAC9D,QAAQ,CAAC,OAA8C,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtE,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/internal/screen-width.js

@@ -0,0 +1,30 @@
+/**
+ * Logical screen width (in dp) read from `lynx.SystemInfo` at module load.
+ * Falls back to 400 (typical phone) if SystemInfo isn't available — module
+ * load happens BG-side after the bundle initializes, by which time
+ * `lynx.SystemInfo` is populated, so the fallback only fires in tests / SSR /
+ * non-Lynx hosts.
+ *
+ * Used by:
+ *   - `<ScreenContainer>` for the slide-from-right transform output range.
+ *   - `<EdgeBackHandle>` for the gesture commit threshold (`dx / width`).
+ *
+ * Both must agree, otherwise the commit threshold and the animation
+ * geometry won't line up. Single shared constant avoids drift.
+ */
+function readScreenWidth() {
+    try {
+        const info = typeof lynx !== 'undefined' ? lynx?.SystemInfo : undefined;
+        const pw = info?.pixelWidth;
+        const pr = info?.pixelRatio || 1;
+        if (typeof pw === 'number' && pw > 0) {
+            return Math.round(pw / pr);
+        }
+    }
+    catch {
+        // Lynx globals not present (test env / SSR) — use fallback.
+    }
+    return 400;
+}
+export const SCREEN_WIDTH = readScreenWidth();
+//# sourceMappingURL=screen-width.js.map

package/dist/internal/screen-width.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-width.js","sourceRoot":"","sources":["../../src/internal/screen-width.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,SAAS,eAAe;IACpB,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,MAAM,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC;QAC5B,MAAM,EAAE,GAAG,IAAI,EAAE,UAAU,IAAI,CAAC,CAAC;QACjC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,4DAA4D;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC"}

package/dist/navigator/core.d.ts

@@ -1,5 +1,6 @@
 import { type SharedValue } from '@sigx/lynx';
 import type { Nav } from '../hooks/use-nav.js';
+import type { ScreenRegistry } from '../internal/screen-registry.js';
 import type { RouteMap, StackEntry } from '../types.js';
 /**
  * The reactive backing state for one navigator instance.
@@ -29,6 +30,24 @@ export interface NavigatorState {
         commitBackGesture(): void;
         cancelBackGesture(): void;
     };
+    /**
+     * Internal: cross-entry `<Screen>` registry lookup.
+     *
+     * Each `<EntryScope>` registers its `ScreenRegistry` here on mount and
+     * removes it on unmount. The navigator's persistent chrome (HeaderBar /
+     * TabBar, shipped in later slices) calls `getScreenRegistry(entry.key)`
+     * to read the currently-focused screen's options/slot fills without
+     * being itself remounted on each navigation.
+     *
+     * Returns `undefined` when no screen for that key has mounted yet (or
+     * after it has unmounted) — consumers must tolerate this and render
+     * defaults.
+     */
+    readonly _screens: {
+        register(registry: ScreenRegistry): void;
+        unregister(entryKey: string): void;
+        get(entryKey: string): ScreenRegistry | undefined;
+    };
 }
 export interface CreateNavigatorOptions {
     routes: RouteMap;
@@ -37,7 +56,7 @@ export interface CreateNavigatorOptions {
      * SharedValue driving push/pop transition progress. Created in
      * `<NavigationRoot>` setup via `useSharedValue(0)` so the bridge
      * plumbing is wired (SharedValue is an MT-bridged ref). When undefined,
-     * navigations are instant — used by tests against `@sigx/testing-lynx`
+     * navigations are instant — used by tests against `@sigx/lynx-testing`
      * that don't have an MT runtime.
      */
     progress?: SharedValue<number>;

package/dist/navigator/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/navigator/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,WAAW,EACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAIR,QAAQ,EACR,UAAU,EAEb,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE;QACf,gBAAgB,IAAI,IAAI,CAAC;QACzB,iBAAiB,IAAI,IAAI,CAAC;QAC1B,iBAAiB,IAAI,IAAI,CAAC;KAC7B,CAAC;CACL;AAsDD,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,sBAAsB,GAAG,cAAc,CA4QjF"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/navigator/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,KAAK,WAAW,EACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAIR,QAAQ,EACR,UAAU,EAEb,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE;QACf,gBAAgB,IAAI,IAAI,CAAC;QACzB,iBAAiB,IAAI,IAAI,CAAC;QAC1B,iBAAiB,IAAI,IAAI,CAAC;KAC7B,CAAC;IACF;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,EAAE;QACf,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;AAuED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,sBAAsB,GAAG,cAAc,CA+QjF"}