@sigx/lynx-navigation 0.2.0 → 0.4.0

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/hooks/use-nav.js

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

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

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

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

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

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

@@ -1,43 +0,0 @@
-/**
- * `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

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

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

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

package/dist/href.js

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

package/dist/href.js.map

@@ -1 +0,0 @@
-{"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/internal/screen-registry.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,30 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}