@sigx/lynx-navigation 0.4.0 → 0.4.2

package/dist/components/Drawer.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@sigx/lynx/jsx-runtime";
+/**
+ * `<Drawer>` — minimal off-canvas drawer navigator.
+ *
+ * Usage:
+ *
+ * ```tsx
+ * <NavigationRoot routes={routes}>
+ *   <Drawer slots={{ sidebar: () => <view><text>Menu</text></view> }}>
+ *     <Stack />
+ *   </Drawer>
+ * </NavigationRoot>
+ * ```
+ *
+ * `useDrawer()` from inside any descendant gives `{ isOpen, open(), close(),
+ * toggle() }`. The sidebar is laid out absolutely on the left and is
+ * visible whenever `isOpen` is true.
+ *
+ * Scope: this slice ships the state primitive + the bare-bones layout.
+ * Gesture-driven open (edge swipe from the left) and MTS slide-in are out
+ * of scope — the app shell can wrap its sidebar JSX in its own transition.
+ *
+ * Design note: the sidebar lives in a named slot (`sidebar`) rather than
+ * a render-prop or a `<Drawer.Sidebar>` child. Mixing
+ * "register-yourself-as-a-fill" children with the parent's own visible
+ * layout creates a feedback loop in sigx's reactive scope (the parent's
+ * render reads the fill, child's setup writes it, parent re-renders,
+ * child re-mounts, …). A scoped slot avoids that entirely and keeps the
+ * call site declarative.
+ *
+ * `default` slot is the main content (almost always a `<Stack>`).
+ */
+import { component, defineInjectable, defineProvide, signal, } from '@sigx/lynx';
+/**
+ * Access the enclosing Drawer navigator. Throws when called outside
+ * `<Drawer>`.
+ */
+export const useDrawer = defineInjectable(() => {
+    throw new Error('[lynx-navigation] useDrawer() called outside of a <Drawer> component.');
+});
+export const Drawer = component(({ props, slots }) => {
+    // `isOpenSig` uses the `{value}` wrapper pattern — sigx's `signal()` of
+    // a primitive returns a proxy that requires `.value` reads; wrapping in
+    // an object makes the proxy carry a mutable boolean.
+    const isOpenSig = signal({
+        value: props.initialOpen === true,
+    });
+    const nav = {
+        get isOpen() {
+            return isOpenSig.value;
+        },
+        open() {
+            isOpenSig.value = true;
+        },
+        close() {
+            isOpenSig.value = false;
+        },
+        toggle() {
+            isOpenSig.value = !isOpenSig.value;
+        },
+    };
+    defineProvide(useDrawer, () => nav);
+    return () => {
+        const open = isOpenSig.value;
+        return (_jsxs("view", { style: { width: '100%', height: '100%' }, children: [_jsx("view", { style: { width: '100%', height: '100%' }, children: slots.default?.() }), _jsx("view", { style: {
+                        position: 'absolute',
+                        left: 0,
+                        top: 0,
+                        bottom: 0,
+                        display: open ? 'flex' : 'none',
+                    }, children: slots.sidebar?.() })] }));
+    };
+});
+//# sourceMappingURL=Drawer.js.map

package/dist/components/Drawer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Drawer.js","sourceRoot":"","sources":["../../src/components/Drawer.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EACH,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,MAAM,GAGT,MAAM,YAAY,CAAC;AAcpB;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAY,GAAG,EAAE;IACtD,MAAM,IAAI,KAAK,CACX,uEAAuE,CAC1E,CAAC;AACN,CAAC,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAc,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;IAC9D,wEAAwE;IACxE,wEAAwE;IACxE,qDAAqD;IACrD,MAAM,SAAS,GAA+B,MAAM,CAAC;QACjD,KAAK,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI;KACpC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAc;QACnB,IAAI,MAAM;YACN,OAAO,SAAS,CAAC,KAAK,CAAC;QAC3B,CAAC;QACD,IAAI;YACA,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,KAAK;YACD,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,MAAM;YACF,SAAS,CAAC,KAAK,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC;QACvC,CAAC;KACJ,CAAC;IAEF,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IAEpC,OAAO,GAAG,EAAE;QACR,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC;QAC7B,OAAO,CACH,gBAAM,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAE1C,eAAM,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YACzC,KAAK,CAAC,OAAO,EAAE,EAAE,GACf,EAKP,eACI,KAAK,EAAE;wBACH,QAAQ,EAAE,UAAU;wBACpB,IAAI,EAAE,CAAC;wBACP,GAAG,EAAE,CAAC;wBACN,MAAM,EAAE,CAAC;wBACT,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;qBAClC,YAEA,KAAK,CAAC,OAAO,EAAE,EAAE,GACf,IACJ,CACV,CAAC;IACN,CAAC,CAAC;AACN,CAAC,CAAC,CAAC"}

package/dist/components/EdgeBackHandle.js

@@ -0,0 +1,144 @@
+import { jsx as _jsx } from "@sigx/lynx/jsx-runtime";
+import { component, Gesture, runOnBackground, useGestureDetector, useMainThreadRef, } from '@sigx/lynx';
+import { withTiming } from '@sigx/lynx-motion';
+import { useNavInternals } from '../hooks/use-nav-internal.js';
+import { SCREEN_WIDTH } from '../internal/screen-width.js';
+/**
+ * Edge-pan recognizer for iOS-style swipe-back. Mounts as an absolutely-
+ * positioned 20px-wide strip on the left edge of the active screen; only
+ * exists when `nav.canGoBack && !transition`.
+ *
+ * `Gesture.Pan().minDistance(MIN_DISTANCE)` lets quick taps pass through to
+ * whatever's behind the strip (back button, screen header, etc.). Only
+ * horizontal drags past the threshold activate the gesture.
+ *
+ * MT/BG split:
+ *   - All gesture handlers run on MT. They write `progress.current.value`
+ *     directly per frame (no per-frame bridge crossing) and dispatch
+ *     `runOnBackground(...)` only at start/commit/cancel — three BG hops
+ *     per gesture max.
+ *   - The transition state machine on BG mounts the underneath
+ *     `<ScreenContainer>` once `beginBackGesture` lands; the gesture's
+ *     in-flight progress writes are picked up the moment the binding
+ *     registers (Phase 0.5 polish: pre-mount underneath when canGoBack to
+ *     eliminate the brief pre-mount latency).
+ *
+ * Implementation notes (matching `<Draggable>`):
+ *   - Single `useMainThreadRef` holding an object — primitive refs don't
+ *     survive worklet capture cleanly in some Lynx versions, while object
+ *     refs do (the worklet runtime resolves the ref via the
+ *     `_workletRefMap`).
+ *   - `e: any` rather than `e: unknown` — type annotations are erased, but
+ *     SWC's worklet transform has been observed to behave better with the
+ *     looser annotation. Keeps us aligned with Draggable verbatim.
+ *   - Empty `onBegin`: load-bearing on iOS — without a registered onBegin
+ *     callback, `LynxPanGestureHandler` skips the begin path and onStart/
+ *     onEnd never fire (per Draggable's notes).
+ */
+/** Fraction of screen width past which a release commits the back nav. */
+const COMMIT_TRANSLATION = 0.33;
+/** px/sec horizontal speed past which a release commits, regardless of distance. */
+const COMMIT_VELOCITY = 300;
+/** Width of the touchable strip on the left edge of every screen. */
+const EDGE_ZONE_WIDTH = 20;
+/** Minimum movement before the gesture activates (lets taps pass through). */
+const MIN_DISTANCE = 8;
+const SNAP_DURATION_SEC = 0.18;
+/**
+ * Pre-computed milliseconds for the BG-side `setTimeout`. Module-level so
+ * it's in scope for both the MT worklet (`withTiming` argument) and the BG
+ * callback wrapped by `runOnBackground` (`setTimeout` argument). Locals
+ * declared inside an MT worklet body are MT-only — the BG callback's
+ * closure can't see them, hence "ReferenceError: snapMs is not defined".
+ */
+const SNAP_DURATION_MS = Math.round(SNAP_DURATION_SEC * 1000);
+export const EdgeBackHandle = component(() => {
+    const ref = useMainThreadRef(null);
+    // Per-gesture transient state — captured as a plain closure object
+    // rather than a `useMainThreadRef`. Lynx's SWC worklet transform deep-
+    // copies plain objects into `_c` once at register time; mutations on MT
+    // persist across calls because the same `_c` is bound for the lifetime
+    // of the gesture registration. Using a `useMainThreadRef` here was
+    // crashing on iOS with `cannot read property 'current' of undefined`
+    // — the resolved-ref capture path looked up an empty
+    // `_workletRefMap` entry under a race I haven't fully tracked down.
+    // Plain object avoids that path entirely.
+    const state = {
+        startPageX: 0,
+        prevPageX: 0,
+        prevTime: 0,
+        velocity: 0,
+    };
+    const internals = useNavInternals();
+    const progress = internals.progress;
+    const beginBackGesture = internals.beginBackGesture;
+    const commitBackGesture = internals.commitBackGesture;
+    const cancelBackGesture = internals.cancelBackGesture;
+    const pan = Gesture.Pan()
+        .minDistance(MIN_DISTANCE)
+        .onBegin(() => {
+        'main thread';
+    })
+        .onStart((e) => {
+        'main thread';
+        const p = e && e.params;
+        const pageX = (p && p.pageX) || 0;
+        state.startPageX = pageX;
+        state.prevPageX = pageX;
+        state.prevTime = Date.now();
+        state.velocity = 0;
+        runOnBackground(() => {
+            beginBackGesture();
+        })();
+    })
+        .onUpdate((e) => {
+        'main thread';
+        if (!progress)
+            return;
+        const p = e && e.params;
+        const pageX = (p && p.pageX) || 0;
+        const dx = pageX - state.startPageX;
+        const prog = Math.max(0, Math.min(1, dx / SCREEN_WIDTH));
+        progress.current.value = prog;
+        const now = Date.now();
+        const dt = now - state.prevTime;
+        if (dt > 0) {
+            state.velocity =
+                ((pageX - state.prevPageX) / dt) * 1000;
+        }
+        state.prevPageX = pageX;
+        state.prevTime = now;
+    })
+        .onEnd((e) => {
+        'main thread';
+        if (!progress)
+            return;
+        const p = e && e.params;
+        const pageX = (p && p.pageX) || 0;
+        const dx = pageX - state.startPageX;
+        const fraction = dx / SCREEN_WIDTH;
+        const commit = fraction > COMMIT_TRANSLATION ||
+            state.velocity > COMMIT_VELOCITY;
+        if (commit) {
+            withTiming(progress, 1, { duration: SNAP_DURATION_SEC });
+            runOnBackground(() => {
+                setTimeout(() => commitBackGesture(), SNAP_DURATION_MS);
+            })();
+        }
+        else {
+            withTiming(progress, 0, { duration: SNAP_DURATION_SEC });
+            runOnBackground(() => {
+                setTimeout(() => cancelBackGesture(), SNAP_DURATION_MS);
+            })();
+        }
+    });
+    useGestureDetector(ref, pan);
+    return () => (_jsx("view", { "main-thread:ref": ref, style: {
+            position: 'absolute',
+            top: '0',
+            left: '0',
+            width: `${EDGE_ZONE_WIDTH}px`,
+            bottom: '0',
+        } }));
+});
+//# sourceMappingURL=EdgeBackHandle.js.map

package/dist/components/EdgeBackHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeBackHandle.js","sourceRoot":"","sources":["../../src/components/EdgeBackHandle.tsx"],"names":[],"mappings":"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"}

package/dist/components/EntryScope.d.ts

@@ -1,5 +1,5 @@
 import { type Define } from '@sigx/lynx';
-import type { StackEntry } from '../types';
+import type { StackEntry } from '../types.js';
 type EntryScopeProps = Define.Prop<'entry', StackEntry, true> & Define.Slot<'default'>;
 /**
  * Provider wrapper for a single screen mount.

package/dist/components/EntryScope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntryScope.d.ts","sourceRoot":"","sources":["../../src/components/EntryScope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAQhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,KAAK,eAAe,GACd,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GACtC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAE7B;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU;;EAgBrB,CAAC"}
+{"version":3,"file":"EntryScope.d.ts","sourceRoot":"","sources":["../../src/components/EntryScope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAQhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,eAAe,GACd,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GACtC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAE7B;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU;;EAgBrB,CAAC"}

package/dist/components/EntryScope.js

@@ -0,0 +1,39 @@
+import { component, defineProvide, onUnmounted } from '@sigx/lynx';
+import { useCurrentEntry, useCurrentEntryOptional, useNavInternals, useScreenRegistry, } from '../hooks/use-nav-internal.js';
+import { createScreenRegistry } from '../internal/screen-registry.js';
+/**
+ * Provider wrapper for a single screen mount.
+ *
+ * `<Stack>` and `<ScreenContainer>` instantiate this around each route
+ * component so calls to `useIsFocused()` / `useFocusEffect()` /
+ * `<Screen>` inside that screen resolve through `useCurrentEntry()` and
+ * `useScreenRegistry()` to the entry it was rendered for. Without this
+ * wrapper there'd be no per-screen way to know "which stack entry am I?"
+ * — the navigator only knows what's currently on top.
+ *
+ * Also allocates a fresh `ScreenRegistry` per entry and publishes it to
+ * the navigator's cross-entry registry map, so persistent chrome (HeaderBar
+ * / TabBar — later slices) can read the focused entry's options + slot
+ * fills without remounting itself.
+ *
+ * Renders the default slot directly; no extra layout element is inserted,
+ * so this is layout-neutral for the screen it wraps.
+ */
+export const EntryScope = component(({ props, slots }) => {
+    const internals = useNavInternals();
+    const registry = createScreenRegistry(props.entry);
+    internals.screens.register(registry);
+    onUnmounted(() => {
+        // Pass the registry instance — `unregister` is identity-checked,
+        // so this is a no-op when a newer EntryScope has already taken
+        // over the same entry key (e.g. at the transition→idle handoff
+        // where the reconciler mounts the new EntryScope before
+        // unmounting the old).
+        internals.screens.unregister(registry);
+    });
+    defineProvide(useCurrentEntry, () => props.entry);
+    defineProvide(useCurrentEntryOptional, () => props.entry);
+    defineProvide(useScreenRegistry, () => registry);
+    return () => slots.default?.();
+});
+//# sourceMappingURL=EntryScope.js.map

package/dist/components/EntryScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntryScope.js","sourceRoot":"","sources":["../../src/components/EntryScope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AAChF,OAAO,EACH,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,iBAAiB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAOtE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAkB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;IACtE,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,CAAC,GAAG,EAAE;QACb,iEAAiE;QACjE,+DAA+D;QAC/D,+DAA+D;QAC/D,wDAAwD;QACxD,uBAAuB;QACvB,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,aAAa,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,aAAa,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1D,aAAa,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/components/Header.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@sigx/lynx/jsx-runtime";
+/**
+ * `<Header>` — default navigator header chrome.
+ *
+ * Reads from the currently-focused entry's `ScreenRegistry`:
+ *
+ *   - If `slots.header` is set, render that (full override).
+ *   - Else render the default layout: headerLeft (back button when
+ *     `nav.canGoBack`), title (from `options.title`, or the route name as
+ *     a fallback), headerRight.
+ *
+ * Persistent: the Header component itself is mounted once near the root and
+ * stays mounted across navigations — it reactively switches its content
+ * when `nav.current` changes, rather than being remounted per screen. That
+ * matters because mounting cost adds to perceived transition latency.
+ *
+ * Header chrome is opt-in. Consumers place `<Header />` inside
+ * `<NavigationRoot>` above `<Stack />`. We don't auto-inject because:
+ *   - app shells vary (some want the header inside a `<SafeArea>`, some
+ *     want a custom toolbar, some want no header at all in tabs).
+ *   - making it opt-in keeps `<Stack>`'s contract narrow.
+ */
+import { component, computed } from '@sigx/lynx';
+import { useNav } from '../hooks/use-nav.js';
+import { useNavInternals } from '../hooks/use-nav-internal.js';
+/**
+ * Resolve a title (string or getter) to a plain string.
+ *
+ * Getter is the more general case; the `<Screen title={() => state.value}>`
+ * call site is how reactive titles work. A plain string is wrapped in a
+ * trivial closure so consumers always handle one shape.
+ */
+function resolveTitle(t, routeName) {
+    if (typeof t === 'function')
+        return t();
+    if (typeof t === 'string')
+        return t;
+    return routeName;
+}
+/**
+ * Default back-button rendering. Plain `<text>` with a tap handler — apps
+ * that want an icon or a custom design override via
+ * `<Screen.HeaderLeft>`. Kept minimal because there's no shared icon
+ * primitive at the navigation layer.
+ */
+const DefaultBackButton = component(({ props }) => {
+    return () => (_jsx("view", { bindtap: () => props.onPress(), "accessibility-element": true, "accessibility-label": "Back", "accessibility-trait": "button", children: _jsx("text", { children: "\u2039 Back" }) }));
+});
+const DefaultTitle = component(({ props }) => {
+    return () => (_jsx("view", { children: _jsx("text", { children: props.text }) }));
+});
+/**
+ * Persistent header chrome. Mount once above `<Stack>`; reactively follows
+ * the focused entry. No props in v1 — styling is a host-app concern,
+ * arrived at through the slot fills.
+ */
+export const Header = component(() => {
+    const nav = useNav();
+    const internals = useNavInternals();
+    // Snapshot computeds — each one reads only what it needs so the header
+    // doesn't re-run wholesale on every signal touch. The slot-fill thunks
+    // captured by `<Screen.Header>` etc. are themselves reactive (they
+    // execute on every render of the consumer's tree), so re-running the
+    // outer template is enough to pick up downstream updates.
+    const currentEntry = computed(() => nav.current);
+    const headerSlot = computed(() => {
+        const reg = internals.screens.get(currentEntry.value.key);
+        return reg?.slots.header;
+    });
+    const headerLeftSlot = computed(() => {
+        const reg = internals.screens.get(currentEntry.value.key);
+        return reg?.slots.headerLeft;
+    });
+    const headerRightSlot = computed(() => {
+        const reg = internals.screens.get(currentEntry.value.key);
+        return reg?.slots.headerRight;
+    });
+    const headerShown = computed(() => {
+        const reg = internals.screens.get(currentEntry.value.key);
+        // Default true — most screens want a header. Opting out is one prop
+        // on `<Screen>`.
+        return reg?.options.headerShown !== false;
+    });
+    const titleText = computed(() => {
+        const reg = internals.screens.get(currentEntry.value.key);
+        return resolveTitle(reg?.options.title, currentEntry.value.route);
+    });
+    return () => {
+        if (!headerShown.value)
+            return null;
+        // Full-override path: `<Screen.Header>` supplied its own content,
+        // we render that and skip the default layout entirely.
+        const override = headerSlot.value;
+        if (override)
+            return override();
+        return (_jsxs("view", { children: [_jsx("view", { children: headerLeftSlot.value
+                        ? headerLeftSlot.value()
+                        : nav.canGoBack
+                            ? _jsx(DefaultBackButton, { onPress: () => nav.pop() })
+                            : null }), _jsx(DefaultTitle, { text: titleText.value }), _jsx("view", { children: headerRightSlot.value ? headerRightSlot.value() : null })] }));
+    };
+});
+//# sourceMappingURL=Header.js.map

package/dist/components/Header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.js","sourceRoot":"","sources":["../../src/components/Header.tsx"],"names":[],"mappings":"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"}

package/dist/components/Layer.d.ts

@@ -25,8 +25,8 @@
  *    via a daisy `bg-base-*` class on the screen body).
  */
 import { type ComponentFactory, type Define } from '@sigx/lynx';
-import type { LayerAnimation } from '../internal/layer-plan';
-import type { RouteMap, StackEntry } from '../types';
+import type { LayerAnimation } from '../internal/layer-plan.js';
+import type { RouteMap, StackEntry } from '../types.js';
 export type LayerProps = Define.Prop<'entry', StackEntry, true> & Define.Prop<'routes', RouteMap, true>
 /** When set, the host view animates per the transform spec. */
  & Define.Prop<'animation', LayerAnimation | null, false>;

package/dist/components/Layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Layer.d.ts","sourceRoot":"","sources":["../../src/components/Layer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAIH,KAAK,gBAAgB,EACrB,KAAK,MAAM,EAEd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGrD,MAAM,MAAM,UAAU,GAChB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GACtC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC;AACvC,+DAA+D;GAC7D,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;AAE7D,eAAO,MAAM,KAAK,wCAkDhB,CAAC"}
+{"version":3,"file":"Layer.d.ts","sourceRoot":"","sources":["../../src/components/Layer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAIH,KAAK,gBAAgB,EACrB,KAAK,MAAM,EAEd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGxD,MAAM,MAAM,UAAU,GAChB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GACtC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC;AACvC,+DAA+D;GAC7D,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;AAE7D,eAAO,MAAM,KAAK,wCAkDhB,CAAC"}

package/dist/components/Layer.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx } from "@sigx/lynx/jsx-runtime";
+/**
+ * `<Layer>` — one row in `<Stack>`'s layered render. Absolutely-
+ * positioned host view that fills the Stack's relative wrapper, with
+ * an optional MT-bound `translateX` / `translateY` animation driven
+ * by a `SharedValue<number>` from the navigator's transition state.
+ *
+ * `<Stack>` emits one `<Layer>` per entry returned by
+ * `computeLayers(...)`. Layer.key in the parent is
+ * `layer-${entry.key}-${animationVariant(animation)}` so that:
+ *
+ *  - The same entry under the same animation state is preserved across
+ *    renders (modal underneath stays mounted through the modal
+ *    lifecycle; per-tab Stack state survives).
+ *  - An entry transitioning between animated and static (e.g. a card
+ *    top after its push transition completes) remounts so the
+ *    `useAnimatedStyle` binding can be rebound — the underlying
+ *    `useAnimatedStyle` is set-once at setup and can't switch its
+ *    mapper at runtime.
+ *
+ * Layouts:
+ *  - Host view is `position: absolute; top/right/bottom/left: 0;
+ *    display: flex; flexDirection: column` so descendants that
+ *    flex-fill (SafeAreaView, daisyui screens) get a sized parent.
+ *  - No background. Screens own their own surface colour (typically
+ *    via a daisy `bg-base-*` class on the screen body).
+ */
+import { component, useMainThreadRef, useAnimatedStyle, } from '@sigx/lynx';
+import { Suspense, isLazyComponent } from '@sigx/lynx';
+import { EntryScope } from './EntryScope.js';
+export const Layer = component(({ props }) => {
+    const ref = useMainThreadRef(null);
+    // `useAnimatedStyle` binds once at setup. Calling it conditionally
+    // is safe because setup runs once per mount and props.animation
+    // never changes for a given Layer instance — animation changes
+    // re-key the Layer at the parent, forcing a fresh mount.
+    if (props.animation) {
+        const a = props.animation;
+        useAnimatedStyle(ref, a.progress, a.axis, {
+            inputRange: [a.inputRange[0], a.inputRange[1]],
+            outputRange: [a.outputRange[0], a.outputRange[1]],
+        });
+    }
+    return () => {
+        const route = props.routes[props.entry.route];
+        if (!route)
+            return null;
+        const Comp = route.component;
+        if (typeof Comp !== 'function')
+            return null;
+        const entryParams = props.entry.params;
+        const body = isLazyComponent(Comp) && route.fallback
+            ? (_jsx(Suspense, { fallback: route.fallback, children: _jsx(Comp, { ...entryParams }) }))
+            : _jsx(Comp, { ...entryParams });
+        return (_jsx("view", { "main-thread:ref": ref, style: {
+                position: 'absolute',
+                top: '0',
+                left: '0',
+                right: '0',
+                bottom: '0',
+                display: 'flex',
+                flexDirection: 'column',
+            }, children: _jsx(EntryScope, { entry: props.entry, children: body }, props.entry.key) }));
+    };
+});
+//# sourceMappingURL=Layer.js.map

package/dist/components/Layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layer.js","sourceRoot":"","sources":["../../src/components/Layer.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACH,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GAInB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQ7C,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAa,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IACrD,MAAM,GAAG,GAAG,gBAAgB,CAA4B,IAAI,CAAC,CAAC;IAC9D,mEAAmE;IACnE,gEAAgE;IAChE,+DAA+D;IAC/D,yDAAyD;IACzD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QAC1B,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE;YACtC,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC9C,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;SACpD,CAAC,CAAC;IACP,CAAC;IAED,OAAO,GAAG,EAAE;QACR,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,SAIlB,CAAC;QACF,IAAI,OAAO,IAAI,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAiC,CAAC;QAClE,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ;YAChD,CAAC,CAAC,CACE,KAAC,QAAQ,IAAC,QAAQ,EAAE,KAAK,CAAC,QAAiB,YACvC,KAAC,IAAI,OAAK,WAAW,GAAI,GAClB,CACd;YACD,CAAC,CAAC,KAAC,IAAI,OAAK,WAAW,GAAI,CAAC;QAChC,OAAO,CACH,kCACqB,GAAG,EACpB,KAAK,EAAE;gBACH,QAAQ,EAAE,UAAU;gBACpB,GAAG,EAAE,GAAG;gBACR,IAAI,EAAE,GAAG;gBACT,KAAK,EAAE,GAAG;gBACV,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,MAAM;gBACf,aAAa,EAAE,QAAQ;aAC1B,YAED,KAAC,UAAU,IAAuB,KAAK,EAAE,KAAK,CAAC,KAAK,YAC/C,IAAI,IADQ,KAAK,CAAC,KAAK,CAAC,GAAG,CAEnB,GACV,CACV,CAAC;IACN,CAAC,CAAC;AACN,CAAC,CAAC,CAAC"}

package/dist/components/Link.d.ts

@@ -1,5 +1,5 @@
-import type { RouteId, RouteParams, RouteSearch } from '../register';
-import type { RoutesWithParams } from '../hooks/use-nav';
+import type { RouteId, RouteParams, RouteSearch } from '../register.js';
+import type { RoutesWithParams } from '../hooks/use-nav.js';
 /**
  * Per-route conditional props for `<Link>`.
  *

package/dist/components/Link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,KAAK,gBAAgB,GAAG;KACnB,CAAC,IAAI,OAAO,GAAG,CAAC,SAAS,gBAAgB,GACpC;QAAE,EAAE,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;KAAE,GAC1D;QAAE,EAAE,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;KAAE;CAC/D,CAAC,OAAO,CAAC,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG;IACvC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAwDF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI,EAA0B,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC"}
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,KAAK,gBAAgB,GAAG;KACnB,CAAC,IAAI,OAAO,GAAG,CAAC,SAAS,gBAAgB,GACpC;QAAE,EAAE,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;KAAE,GAC1D;QAAE,EAAE,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;KAAE;CAC/D,CAAC,OAAO,CAAC,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG;IACvC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAwDF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI,EAA0B,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC"}

package/dist/components/Link.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx } from "@sigx/lynx/jsx-runtime";
+import { component } from '@sigx/lynx';
+import { useNav } from '../hooks/use-nav.js';
+import { useNavRoutes } from '../hooks/use-nav-internal.js';
+const LinkImpl = component(({ props, slots }) => {
+    const nav = useNav();
+    const routes = useNavRoutes();
+    const handlePress = () => {
+        const route = props.to;
+        const routeDef = routes[route];
+        if (!routeDef) {
+            // Defensive: prop was typed against the registry, so this shouldn't
+            // happen at runtime — but if it does (e.g. a stale Link survived a
+            // route removal), surface a clear error rather than crashing on
+            // the navigator's lookup.
+            throw new Error(`[lynx-navigation] <Link to='${route}'>: route is not registered.`);
+        }
+        const hasParams = !!routeDef.params;
+        const action = props.replace ? nav.replace : nav.push;
+        // Branch on whether the route declares a params schema so positional
+        // args land correctly: routes-with-params shift everything one slot
+        // (push/replace overload signatures `(name, params, search?, options?)`
+        // vs `(name, search?, options?)`). Calling the wrong shape silently
+        // puts `search` into the `options` slot.
+        if (hasParams) {
+            action(route, props.params, props.search);
+        }
+        else {
+            action(route, props.search);
+        }
+    };
+    return () => (_jsx("view", { bindtap: handlePress, children: slots.default?.() }));
+}, { name: 'Link' });
+/**
+ * Declarative navigation. Same typing as `nav.push` — pass `params` only when
+ * the route declares a schema. Wraps a `<view>` that fires `nav.push` (or
+ * `nav.replace` if `replace` is set) on tap.
+ *
+ * @example
+ * ```tsx
+ * <Link to="home">Home</Link>
+ * <Link to="profile" params={{ id: '42' }}>View profile</Link>
+ * <Link to="profile" params={{ id: '42' }} search={{ tab: 'about' }}>About</Link>
+ * <Link to="settings" replace>Settings (no back)</Link>
+ * ```
+ *
+ * The cast widens the inferred prop type from the loose impl to the strict
+ * `LinkProps` so JSX usage gets per-route discrimination. Runtime is identical.
+ */
+export const Link = LinkImpl;
+//# sourceMappingURL=Link.js.map

package/dist/components/Link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.js","sourceRoot":"","sources":["../../src/components/Link.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAqD5D,MAAM,QAAQ,GAAG,SAAS,CAAiB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;IAC5D,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,MAAM,WAAW,GAAG,GAAS,EAAE;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,oEAAoE;YACpE,mEAAmE;YACnE,gEAAgE;YAChE,0BAA0B;YAC1B,MAAM,IAAI,KAAK,CACX,+BAA+B,KAAK,8BAA8B,CACrE,CAAC;QACN,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;QACtD,qEAAqE;QACrE,oEAAoE;QACpE,wEAAwE;QACxE,oEAAoE;QACpE,yCAAyC;QACzC,IAAI,SAAS,EAAE,CAAC;YACX,MAAuD,CACpD,KAAK,EACL,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,CACf,CAAC;QACN,CAAC;aAAM,CAAC;YACH,MAA2C,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACtE,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,GAAG,EAAE,CAAC,CAGT,eAAM,OAAO,EAAE,WAAW,YAAG,KAAK,CAAC,OAAO,EAAE,EAAE,GAAQ,CACzD,CAAC;AACN,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AAErB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,QAAoD,CAAC"}

package/dist/components/NavigationRoot.d.ts

@@ -1,6 +1,6 @@
 import { type Define } from '@sigx/lynx';
-import type { RouteId } from '../register';
-import type { RouteMap } from '../types';
+import type { RouteId } from '../register.js';
+import type { RouteMap } from '../types.js';
 type NavigationRootProps = Define.Prop<'routes', RouteMap, true> & Define.Prop<'initialRoute', RouteId> & Define.Prop<'initialParams', Record<string, unknown>> & Define.Prop<'initialSearch', Record<string, unknown>>
 /**
  * Enable slide-from-right transitions on push/pop. Defaults to true.

package/dist/components/NavigationRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationRoot.d.ts","sourceRoot":"","sources":["../../src/components/NavigationRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAInF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAgB,QAAQ,EAAc,MAAM,UAAU,CAAC;AAGnE,KAAK,mBAAmB,GAClB,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GACrC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GACpC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACrD,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvD;;;;GAIG;GACD,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC;AAClC;;;;GAIG;GACD,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,GACxC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAE7B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc;;EAiDzB,CAAC"}
+{"version":3,"file":"NavigationRoot.d.ts","sourceRoot":"","sources":["../../src/components/NavigationRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAInF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAgB,QAAQ,EAAc,MAAM,aAAa,CAAC;AAGtE,KAAK,mBAAmB,GAClB,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GACrC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GACpC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACrD,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvD;;;;GAIG;GACD,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC;AAClC;;;;GAIG;GACD,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,GACxC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAE7B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc;;EAiDzB,CAAC"}