@sigx/lynx-navigation 0.2.0 → 0.4.0

package/dist/components/Stack.js

@@ -1,221 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "@sigx/lynx/jsx-runtime";
-import { component, defineProvide, effect, onUnmounted, untrack, useSharedValue, } from '@sigx/lynx';
-import { Suspense, isLazyComponent } from '@sigx/lynx';
-import { createNavigatorState } from '../navigator/core.js';
-import { useNav } from '../hooks/use-nav.js';
-import { useCurrentEntry, useNavInternals, useNavRoutes, } from '../hooks/use-nav-internal.js';
-import { ScreenContainer } from './ScreenContainer.js';
-import { EdgeBackHandle } from './EdgeBackHandle.js';
-import { EntryScope } from './EntryScope.js';
-import { useTabScreenName, useTabs } from './Tabs.js';
-let _nestedKeyCounter = 0;
-/**
- * Stack navigator — renders the topmost stack entry's component at rest, or
- * the top + underneath entries during a transition.
- *
- * Two modes:
- *
- * **Bound** (no `initialRoute`): renders the enclosing navigator's stack.
- * This is the shape used directly under `<NavigationRoot>` and is what
- * single-stack apps want.
- *
- * **Nested-owner** (`initialRoute="…"`): mints a fresh `NavigatorState` with
- * its own progress `SharedValue` and edge-back gesture, and provides
- * `useNav` / `useNavInternals` / `useNavRoutes` to its subtree. `useNav()`
- * inside this stack returns the nested nav; `nav.parent` points to the
- * enclosing one. Per-tab stacks are the canonical use case:
- *
- * ```tsx
- * <Tabs initialTab="trips">
- *   <Tabs.Screen name="trips"><Stack initialRoute="tripsHome" /></Tabs.Screen>
- *   <Tabs.Screen name="map"><Stack initialRoute="mapHome" /></Tabs.Screen>
- * </Tabs>
- * ```
- *
- * Modal/fullScreen pushes escalate up the parent chain automatically — so
- * `nav.push('newTrip')` from inside Trips (where `newTrip` is `modal`)
- * walks to root and overlays the whole UI. `replace` stays strictly local
- * (asymmetric with `push`) so a modal `replace` never wipes the root stack.
- *
- * **Render strategy** (same in both modes):
- *  - **Idle**: just the top entry, full-bleed, no transform. The screen
- *    component mounts directly so it can use its own layout (no extra
- *    absolute positioning that would break percentage heights).
- *  - **Transitioning**: two `<ScreenContainer>` instances stacked
- *    absolutely, each with an MT-driven `translateX` that reads from the
- *    navigator's progress `SharedValue`. The host's BG thread doesn't tick
- *    per frame — `useAnimatedStyle` runs the interpolation entirely on MT.
- *
- * `key={top.key}` keeps the idle render's component instance stable across
- * unrelated re-renders. During transitions, composite keys
- * (`${entry.key}-${role}-${kind}`) ensure a fresh mount per role/kind pair
- * so the `useAnimatedStyle` binding is set with the right input/output
- * ranges.
- */
-export const Stack = component(({ props }) => {
-    // Capture enclosing scope's nav + routes + internals BEFORE any of the
-    // defineProvide calls below override them for descendants. These are
-    // always the "outer" values regardless of whether this Stack is bound
-    // or nested-owner.
-    const parentNav = useNav();
-    const routes = useNavRoutes();
-    const parentInternals = useNavInternals();
-    // Decide mode at setup. `props.initialRoute` is captured once — the
-    // alternative (reactive switch between bound and nested-owner) would
-    // need to dispose and recreate the inner nav, which would lose all
-    // pushed state. Reasonable to pin it.
-    const initialName = props.initialRoute;
-    const isNested = typeof initialName === 'string' && initialName.length > 0;
-    let nav;
-    let internals;
-    if (isNested) {
-        if (!routes[initialName]) {
-            throw new Error(`[lynx-navigation] <Stack initialRoute='${initialName}'>: ` +
-                `route is not registered. Known routes: ` +
-                `${Object.keys(routes).join(', ') || '(none)'}`);
-        }
-        // Host entry — the parent's current top *when this Stack mounts*.
-        // Used by the focus chain so the nested nav is only "locally
-        // focused" while its host entry is still the top of the parent.
-        // Wrapped in try/catch because `<Stack initialRoute>` *may* be
-        // placed outside an EntryScope (e.g. directly under
-        // `<NavigationRoot>`); in that case there's no host-entry gate to
-        // apply and we just rely on `parent.isLocallyFocused`.
-        let hostEntryKey = null;
-        try {
-            hostEntryKey = useCurrentEntry().key;
-        }
-        catch {
-            hostEntryKey = null;
-        }
-        // Enclosing tab name (if any). Lets the focus chain gate on tab
-        // active state — Trips' inner stack reports `isLocallyFocused: false`
-        // while the user is on the Map tab, even though it's the top of
-        // its own stack.
-        let tabName = null;
-        let tabsHandle = null;
-        try {
-            tabName = useTabScreenName();
-            tabsHandle = useTabs();
-        }
-        catch {
-            tabName = null;
-            tabsHandle = null;
-        }
-        // Inherit animation enablement from the parent — if the root was
-        // created with `animated={false}` (tests), nested stacks should
-        // also commit instantly so test assertions don't have to wait on
-        // a SharedValue that won't tick.
-        const animationsEnabled = parentInternals.progress !== null;
-        const progressSv = useSharedValue(0);
-        const presentation = (routes[initialName].presentation ?? 'card');
-        // Counter-derived suffix keeps base-entry keys unique across
-        // concurrent nested stacks in a tab app. Plain `Math.random` would
-        // do but a counter is deterministic for test snapshots.
-        _nestedKeyCounter += 1;
-        const initial = {
-            key: `nested-${initialName}-${_nestedKeyCounter}`,
-            route: initialName,
-            params: props.initialParams ?? {},
-            search: props.initialSearch ?? {},
-            state: undefined,
-            presentation,
-        };
-        const navState = createNavigatorState({
-            routes,
-            initial,
-            progress: animationsEnabled ? progressSv : undefined,
-            parent: parentNav,
-            // Start un-focused; the effect below flips this once we observe
-            // the parent's current entry / tab-active state.
-            initialLocallyFocused: false,
-        });
-        nav = navState.nav;
-        internals = {
-            progress: animationsEnabled ? progressSv : null,
-            beginBackGesture: navState._gesture.beginBackGesture,
-            commitBackGesture: navState._gesture.commitBackGesture,
-            cancelBackGesture: navState._gesture.cancelBackGesture,
-            edgeSwipeEnabled: 
-            // Gate on animationsEnabled too — if there's no progress
-            // SharedValue (e.g. parent is `animated={false}`), the edge
-            // swipe gesture would call `beginBackGesture()` with a null
-            // progress and leave the stack in an inconsistent state.
-            animationsEnabled && parentInternals.edgeSwipeEnabled,
-            screens: navState._screens,
-        };
-        // Reactive focus chain: this nav is locally focused iff
-        //   1. (no host entry captured) OR parent.current.key === hostEntryKey
-        //   2. parent.isLocallyFocused
-        //   3. (no enclosing tab) OR tabs.active === tabName
-        // Effect re-runs on any of those changing — parent's stack
-        // mutating, parent's own focus flipping, or the tab switching.
-        const focusRunner = effect(() => {
-            const hostMatch = hostEntryKey === null || parentNav.current.key === hostEntryKey;
-            const parentFocused = parentNav.isLocallyFocused;
-            const tabActive = tabName === null || tabsHandle === null
-                ? true
-                : tabsHandle.active === tabName;
-            const focused = hostMatch && parentFocused && tabActive;
-            // Write outside the read-tracking window — `_setLocallyFocused`
-            // bumps a signal that no consumer in *this* setup reads, but
-            // it's good hygiene anyway.
-            untrack(() => navState._setLocallyFocused(focused));
-        });
-        onUnmounted(() => {
-            focusRunner.stop();
-            parentNav._children.delete(nav);
-        });
-        defineProvide(useNav, () => nav);
-        defineProvide(useNavRoutes, () => routes);
-        defineProvide(useNavInternals, () => internals);
-    }
-    else {
-        nav = parentNav;
-        internals = parentInternals;
-    }
-    return () => {
-        const transition = nav.transition;
-        const top = nav.current;
-        if (!transition) {
-            const route = routes[top.route];
-            if (!route)
-                return null;
-            const Comp = route.component;
-            if (typeof Comp !== 'function')
-                return null;
-            const params = top.params;
-            // Wrap lazy routes that declare a `fallback` in <Suspense> so the
-            // chunk-load shows the user-provided spinner instead of throwing
-            // up to the nearest outer boundary (which may be wrong layer or
-            // missing entirely).
-            const body = isLazyComponent(Comp) && route.fallback
-                ? (_jsx(Suspense, { fallback: route.fallback, children: _jsx(Comp, { ...params }) }))
-                : _jsx(Comp, { ...params });
-            // When canGoBack and edge-swipe is enabled, overlay the gesture
-            // handle so the user can pan from the left edge to start a back
-            // transition. `position: absolute` doesn't disturb the screen's
-            // own layout — the handle only intercepts touches in the leftmost
-            // 20px, and only when they pan rightward past `MIN_DISTANCE`.
-            if (nav.canGoBack && internals.edgeSwipeEnabled) {
-                return (_jsxs("view", { style: {
-                        position: 'relative',
-                        width: '100%',
-                        height: '100%',
-                    }, children: [_jsx(EntryScope, { entry: top, children: body }, top.key), _jsx(EdgeBackHandle, {}, "edge-back")] }));
-            }
-            return (_jsx(EntryScope, { entry: top, children: body }, top.key));
-        }
-        // Cast progress: TransitionState carries it as `unknown` to avoid
-        // pinning the contract to `@sigx/lynx`'s SharedValue at the type
-        // level; here at the runtime boundary we know it's a SharedValue<number>.
-        const progress = transition.progress;
-        return (_jsxs("view", { style: {
-                position: 'relative',
-                width: '100%',
-                height: '100%',
-                overflow: 'hidden',
-            }, children: [_jsx(ScreenContainer, { entry: transition.underneathEntry, routes: routes, role: "underneath", kind: transition.kind, progress: progress }, `${transition.underneathEntry.key}-underneath-${transition.kind}`), _jsx(ScreenContainer, { entry: transition.topEntry, routes: routes, role: "top", kind: transition.kind, progress: progress }, `${transition.topEntry.key}-top-${transition.kind}`)] }));
-    };
-});
-//# sourceMappingURL=Stack.js.map

package/dist/components/Stack.js.map

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

package/dist/components/TabBar.js

@@ -1,63 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "@sigx/lynx/jsx-runtime";
-/**
- * `<TabBar>` — default chrome for `<Tabs>`.
- *
- * Renders a row of tab buttons reading from the enclosing `useTabs()`
- * navigator. Active tab is highlighted via the `active` prop on each
- * default button (consumers can re-style via `renderTab`).
- *
- * Customization knobs:
- *   - `renderTab`: a function `(info, ctx) => JSX` that fully replaces the
- *     default button rendering for each tab. `ctx.active` tells the
- *     consumer whether this tab is currently focused; `ctx.onPress`
- *     activates the tab.
- *
- * Accessibility:
- *   - Each default button gets `accessibility-label` from
- *     `info.accessibilityLabel ?? info.label ?? info.name`.
- *   - Each default button gets `accessibility-element="true"` so screen
- *     readers see the whole pill, not just the inner `<text>`.
- *   - Each default button gets `accessibility-trait="button"` and a
- *     `selected` flag on the active one so VoiceOver/TalkBack announces
- *     focus state on tab switch.
- *
- * Placement: mount inside `<Tabs>` alongside the `<Tabs.Screen>`s. Order
- * matters visually (place above or below the screen bodies depending on
- * the layout), and `<Tabs.Screen>` bodies all stack with `display:flex` so
- * the TabBar should be at a deterministic position in the JSX.
- */
-import { component, } from '@sigx/lynx';
-import { useTabs } from './Tabs.js';
-/**
- * Default per-tab button. Plain `<view>` with a `<text>` inside, an
- * `accessibility-*` cluster for screen readers, and a tap handler. No
- * styling beyond a minimal active-state marker — consumers that want
- * branded chrome pass `renderTab`.
- */
-const DefaultTabButton = component(({ props }) => {
-    return () => {
-        const label = props.info.label ?? props.info.name;
-        const a11y = props.info.accessibilityLabel ?? label;
-        return (_jsxs("view", { bindtap: () => props.onPress(), "accessibility-element": true, "accessibility-label": a11y, "accessibility-trait": "button", "accessibility-status": props.active ? 'selected' : undefined, style: { opacity: props.active ? 1 : 0.6 }, children: [props.info.icon ?? null, _jsx("text", { children: label })] }));
-    };
-});
-export const TabBar = component(({ props }) => {
-    const nav = useTabs();
-    return () => {
-        // Reading `nav.tabs` and `nav.active` here ties this render to both
-        // the registration list and the active signal — switching active or
-        // adding/removing a `<Tabs.Screen>` updates the bar reactively.
-        const tabs = nav.tabs;
-        const active = nav.active;
-        const renderer = props.renderTab;
-        return (_jsx("view", { "accessibility-element": false, children: tabs.map((info) => {
-                const isActive = info.name === active;
-                const onPress = () => nav.setActive(info.name);
-                if (renderer) {
-                    return renderer(info, { active: isActive, onPress });
-                }
-                return (_jsx(DefaultTabButton, { info: info, active: isActive, onPress: onPress }));
-            }) }));
-    };
-});
-//# sourceMappingURL=TabBar.js.map

package/dist/components/TabBar.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TabBar.js","sourceRoot":"","sources":["../../src/components/TabBar.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EACH,SAAS,GAGZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAgB,MAAM,WAAW,CAAC;AAalD;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,SAAS,CAIhC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IACZ,OAAO,GAAG,EAAE;QACR,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC;QACpD,OAAO,CACH,gBACI,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,2BACP,IAAI,yBACN,IAAI,yBACL,QAAQ,0BACN,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAC3D,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,aAEzC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,EACxB,yBAAO,KAAK,GAAQ,IACjB,CACV,CAAC;IACN,CAAC,CAAC;AACN,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAc,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IACvD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,OAAO,GAAG,EAAE;QACR,oEAAoE;QACpE,oEAAoE;QACpE,gEAAgE;QAChE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACtB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;QACjC,OAAO,CACH,wCAA6B,KAAK,YAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;gBACtC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,QAAQ,EAAE,CAAC;oBACX,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzD,CAAC;gBACD,OAAO,CACH,KAAC,gBAAgB,IACb,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,OAAO,GAClB,CACL,CAAC;YACN,CAAC,CAAC,GACC,CACV,CAAC;IACN,CAAC,CAAC;AACN,CAAC,CAAC,CAAC"}

package/dist/components/Tabs.js

@@ -1,154 +0,0 @@
-import { jsx as _jsx } from "@sigx/lynx/jsx-runtime";
-/**
- * `<Tabs>` — Lynx tab navigator.
- *
- * Usage:
- *
- * ```tsx
- * <NavigationRoot routes={routes} initialRoute="root">
- *   <Stack />
- * </NavigationRoot>
- *
- * // The route "root" component renders:
- * <Tabs initialTab="feed">
- *   <Tabs.Screen name="feed" icon={<FeedIcon />} label="Feed">
- *     <Stack initialRoute="feedHome" />
- *   </Tabs.Screen>
- *   <Tabs.Screen name="me" icon={<MeIcon />} label="Profile">
- *     <Stack initialRoute="profileHome" />
- *   </Tabs.Screen>
- *   <TabBar />
- * </Tabs>
- * ```
- *
- * Tab bodies stay mounted across switches (the inactive ones render with
- * `display: 'none'`), so each tab's nested `<Stack>` keeps its history when
- * the user flips back to it. The active tab is reactive via `useTabs()`.
- *
- * Per-tab stacks: each `<Tabs.Screen>` can host a `<Stack initialRoute="…">`
- * which mints its own navigator. `useNav()` inside that subtree resolves to
- * the tab's stack, so `nav.push('card-route', …)` stays inside the tab.
- * Routes presented as `modal` / `fullScreen` / `transparent-modal` escalate
- * up `nav.parent` to the root navigator automatically — they overlay the
- * tabs UI (TabBar included) and dismiss back into the originating tab.
- */
-import { component, compound, defineInjectable, defineProvide, onUnmounted, signal, untrack, } from '@sigx/lynx';
-/**
- * Access the enclosing Tabs navigator. Throws when called outside `<Tabs>`.
- */
-export const useTabs = defineInjectable(() => {
-    throw new Error('[lynx-navigation] useTabs() called outside of a <Tabs> component.');
-});
-const useTabsRegistrar = defineInjectable(() => {
-    throw new Error('[lynx-navigation] <Tabs.Screen> rendered outside a <Tabs> component.');
-});
-/**
- * @internal
- * Provided by each `<Tabs.Screen>` so a nested `<Stack initialRoute>` can
- * discover *which* tab it's hosted by, and gate its focus state on that
- * tab being active. Throws when called outside a `<Tabs.Screen>` body so
- * the gate degrades to "always active" via the caller's try/catch.
- */
-export const useTabScreenName = defineInjectable(() => {
-    throw new Error('[lynx-navigation] useTabScreenName() called outside a <Tabs.Screen> body.');
-});
-const _Tabs = component(({ props, slots }) => {
-    // Tabs are stored as a deeply-reactive proxy signal so `tabs` consumers
-    // re-render when registration changes. `activeSignal` uses the wrapped
-    // `{value}` pattern so we can write a `string | null` without the
-    // proxy treating the inner string as an object.
-    const tabs = signal([]);
-    const activeSignal = signal({
-        value: props.initialTab ?? null,
-    });
-    const registrar = {
-        register(info) {
-            // Wrap in untrack so registration writes inside `<Tabs.Screen>`'s
-            // setup phase don't notify the same setup effect that issued them
-            // — sigx's setup runs in a tracked scope by default.
-            untrack(() => {
-                const idx = tabs.findIndex((t) => t.name === info.name);
-                if (idx === -1)
-                    tabs.push(info);
-                else
-                    tabs[idx] = info;
-                if (activeSignal.value === null) {
-                    activeSignal.value = info.name;
-                }
-            });
-        },
-        unregister(name) {
-            untrack(() => {
-                const idx = tabs.findIndex((t) => t.name === name);
-                if (idx !== -1)
-                    tabs.splice(idx, 1);
-                if (activeSignal.value === name) {
-                    activeSignal.value = tabs[0]?.name ?? null;
-                }
-            });
-        },
-        tabs,
-        activeSignal,
-    };
-    const nav = {
-        get active() {
-            // Empty-tabs state is rare in practice (no <Tabs.Screen> yet) but
-            // possible during initial render; expose '' rather than null so
-            // consumers can compare strings without narrowing.
-            return activeSignal.value ?? '';
-        },
-        setActive(name) {
-            // Silently ignore unknown names rather than writing them and
-            // hiding every tab body. Surfacing as a no-op gives consumers a
-            // predictable failure mode for typos / dynamic name sources.
-            if (!tabs.some((t) => t.name === name))
-                return;
-            activeSignal.value = name;
-        },
-        get tabs() {
-            return tabs;
-        },
-    };
-    defineProvide(useTabs, () => nav);
-    defineProvide(useTabsRegistrar, () => registrar);
-    return () => slots.default?.();
-});
-const TabsScreen = component(({ props, slots }) => {
-    const registrar = useTabsRegistrar();
-    // Capture `name` once at setup. Props is reactive in sigx, but using a
-    // changing `name` for an already-registered screen would be ambiguous
-    // (rename vs re-register?) — pin it and require callers to remount on
-    // identity change. This matches React Navigation's contract.
-    const name = props.name;
-    registrar.register({
-        name,
-        icon: props.icon,
-        label: props.label,
-        accessibilityLabel: props.accessibilityLabel,
-    });
-    onUnmounted(() => registrar.unregister(name));
-    // Expose this screen's tab name so a nested `<Stack initialRoute>` body
-    // can gate its locally-focused state on `tabs.active === name`.
-    defineProvide(useTabScreenName, () => name);
-    return () => {
-        // `display: none` keeps the body mounted so per-tab state survives
-        // tab switches. Read activeSignal here so re-activating triggers a
-        // re-render with display restored.
-        const active = registrar.activeSignal.value === name;
-        return (_jsx("view", { style: {
-                display: active ? 'flex' : 'none',
-                width: '100%',
-                height: '100%',
-            }, children: slots.default?.() }));
-    };
-});
-/**
- * Compound export. `Tabs` is the parent component; `Tabs.Screen` registers
- * an individual tab. Matches the `Screen` / `Screen.Header` shape used
- * elsewhere in this package and the daisyui `Modal` / `Modal.Header`
- * convention.
- */
-export const Tabs = compound(_Tabs, {
-    Screen: TabsScreen,
-});
-//# sourceMappingURL=Tabs.js.map

package/dist/components/Tabs.js.map

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

package/dist/define-routes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"define-routes.js","sourceRoot":"","sources":["../src/define-routes.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,YAAY,CAA2B,MAAS;IAC5D,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/hooks/use-focus.js

@@ -1,87 +0,0 @@
-import { computed, effect, onUnmounted, untrack, } from '@sigx/lynx';
-import { useNav } from './use-nav.js';
-import { useCurrentEntry } from './use-nav-internal.js';
-/**
- * Reactive "is this screen the focused entry?" signal.
- *
- * Must be called from inside a component rendered as a route by `<Stack>` (or
- * any other navigator that uses `<EntryScope>`); throws otherwise. The
- * returned `Computed` reads `nav.current.key` and compares it to the entry
- * the calling screen was mounted for, so any nav mutation that changes the
- * top entry flips the value.
- *
- * Note: screens stay mounted when something is pushed on top of them — they
- * just lose focus. Pop the new top off and they regain focus.
- *
- * @example
- * ```tsx
- * const Profile = component(() => {
- *     const isFocused = useIsFocused();
- *     return () => <text>{isFocused.value ? 'visible' : 'hidden'}</text>;
- * });
- * ```
- */
-export function useIsFocused() {
-    const nav = useNav();
-    // Capture the entry's key once at setup. The entry object provided
-    // through `defineProvide` may carry reactive dependencies; we only care
-    // about the immutable key of the entry this screen was mounted for.
-    const myKey = useCurrentEntry().key;
-    // AND in `nav.isLocallyFocused` so a screen in a nested stack (e.g. a
-    // per-tab `<Stack>`) reports unfocused when its enclosing tab is
-    // inactive, or when a modal on the root nav covers everything — even
-    // though it's still the top of its own (paused) stack. Root nav's
-    // `isLocallyFocused` is permanently true, so this reduces to the
-    // previous behavior for un-nested apps.
-    return computed(() => nav.current.key === myKey && nav.isLocallyFocused);
-}
-/**
- * Run `cb` whenever this screen gains focus; run the returned cleanup when it
- * loses focus or unmounts. Mirrors React Navigation's `useFocusEffect`.
- *
- * Lifecycle:
- *  - cb runs immediately if the screen is already focused at mount.
- *  - When the screen loses focus (something pushed on top), cleanup runs.
- *  - When focus returns (the cover is popped), `cb` runs again — yielding a
- *    fresh cleanup for the next blur.
- *  - On unmount, cleanup runs once if still focused.
- *
- * Common uses: subscribe to a data source while visible, track an analytics
- * "screen view" event, start/stop a polling loop.
- *
- * @example
- * ```tsx
- * useFocusEffect(() => {
- *     const id = setInterval(refresh, 5000);
- *     return () => clearInterval(id);
- * });
- * ```
- */
-export function useFocusEffect(cb) {
-    const isFocused = useIsFocused();
-    let cleanup;
-    const runner = effect(() => {
-        const focused = isFocused.value;
-        // Always tear down any previous focus session before starting a new
-        // one (or before going dormant on blur). Wrap `cb` in `untrack` so
-        // signals read inside the user-provided callback can't retrigger the
-        // outer effect and stack subscriptions.
-        if (typeof cleanup === 'function') {
-            const fn = cleanup;
-            cleanup = undefined;
-            fn();
-        }
-        if (focused) {
-            cleanup = untrack(() => cb());
-        }
-    });
-    onUnmounted(() => {
-        if (typeof cleanup === 'function') {
-            const fn = cleanup;
-            cleanup = undefined;
-            fn();
-        }
-        runner.stop();
-    });
-}
-//# sourceMappingURL=use-focus.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"use-focus.js","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,QAAQ,EACR,MAAM,EACN,WAAW,EACX,OAAO,GAEV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY;IACxB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,mEAAmE;IACnE,wEAAwE;IACxE,oEAAoE;IACpE,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC,GAAG,CAAC;IACpC,sEAAsE;IACtE,iEAAiE;IACjE,qEAAqE;IACrE,kEAAkE;IAClE,iEAAiE;IACjE,wCAAwC;IACxC,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,cAAc,CAAC,EAA6B;IACxD,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,OAA4B,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE;QACvB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC;QAChC,oEAAoE;QACpE,mEAAmE;QACnE,qEAAqE;QACrE,wCAAwC;QACxC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,EAAE,GAAG,OAAO,CAAC;YACnB,OAAO,GAAG,SAAS,CAAC;YACpB,EAAE,EAAE,CAAC;QACT,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,WAAW,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,EAAE,GAAG,OAAO,CAAC;YACnB,OAAO,GAAG,SAAS,CAAC;YACpB,EAAE,EAAE,CAAC;QACT,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -1,84 +0,0 @@
-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 the handler walks to the
- * deepest currently-focused navigator (per-tab `<Stack>`s register with
- * their parent), then walks back up the `parent` chain looking for the
- * first nav that `canGoBack`:
- *
- *   - If any nav in the chain can go back → `nav.pop()` on that nav.
- *   - Otherwise → `BackHandler.exitApp()` (Android: `moveTaskToBack(true)`,
- *     keeps the bundle warm; iOS: rejects, since iOS doesn't permit
- *     programmatic termination).
- *
- * The traversal means you only need to call this once at the root — a
- * back press from inside a tab pops that tab's nested stack first, only
- * exiting the app once every level is at its base entry.
- *
- * 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(() => {
-            // Walk down to the deepest focused nav. Per-tab `<Stack>`s
-            // register themselves via `parent._children.add(nav)`; only one
-            // child per level is `isLocallyFocused` at a time, so the
-            // traversal is unambiguous. Falls back to the starting nav if
-            // no nested stacks are wired up.
-            let active = nav;
-            // Loop instead of recursion so a deeply-nested tree doesn't blow
-            // the stack on a synchronous back press.
-            outer: while (active._children.size > 0) {
-                for (const child of active._children) {
-                    if (child.isLocallyFocused) {
-                        active = child;
-                        continue outer;
-                    }
-                }
-                // No focused child at this level — stop drilling.
-                break;
-            }
-            // Walk back up the chain looking for the first nav that has
-            // something to pop. This is what makes "back press in trips
-            // tab with empty inner stack" fall through to root (which might
-            // have a modal on top) before exiting.
-            let cur = active;
-            while (cur) {
-                if (cur.canGoBack) {
-                    cur.pop();
-                    return true;
-                }
-                cur = cur.parent;
-            }
-            // At the root with nothing to pop — 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

@@ -1 +0,0 @@
-{"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,EAAY,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;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,2DAA2D;YAC3D,gEAAgE;YAChE,0DAA0D;YAC1D,8DAA8D;YAC9D,iCAAiC;YACjC,IAAI,MAAM,GAAQ,GAAG,CAAC;YACtB,iEAAiE;YACjE,yCAAyC;YACzC,KAAK,EAAE,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACtC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;oBACnC,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;wBACzB,MAAM,GAAG,KAAK,CAAC;wBACf,SAAS,KAAK,CAAC;oBACnB,CAAC;gBACL,CAAC;gBACD,kDAAkD;gBAClD,MAAM;YACV,CAAC;YACD,4DAA4D;YAC5D,4DAA4D;YAC5D,gEAAgE;YAChE,uCAAuC;YACvC,IAAI,GAAG,GAAe,MAAM,CAAC;YAC7B,OAAO,GAAG,EAAE,CAAC;gBACT,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;oBAChB,GAAG,CAAC,GAAG,EAAE,CAAC;oBACV,OAAO,IAAI,CAAC;gBAChB,CAAC;gBACD,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;YACrB,CAAC;YACD,8DAA8D;YAC9D,2DAA2D;YAC3D,yDAAyD;YACzD,2BAA2B;YAC3B,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"}