@sigx/lynx-navigation 0.1.0 → 0.1.1

package/dist/components/EntryScope.d.ts

@@ -0,0 +1,26 @@
+import { type Define } from '@sigx/lynx';
+import type { StackEntry } from '../types.js';
+type EntryScopeProps = Define.Prop<'entry', StackEntry, true> & Define.Slot<'default'>;
+/**
+ * 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 declare const EntryScope: import("@sigx/runtime-core").ComponentFactory<EntryScopeProps, void, {
+    default: () => import("@sigx/runtime-core").JSXElement | import("@sigx/runtime-core").JSXElement[] | null;
+}>;
+export {};
+//# sourceMappingURL=EntryScope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntryScope.d.ts","sourceRoot":"","sources":["../../src/components/EntryScope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAGhF,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;;EAUrB,CAAC"}

package/dist/components/EntryScope.js

@@ -0,0 +1,33 @@
+import { component, defineProvide, onUnmounted } from '@sigx/lynx';
+import { useCurrentEntry, 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(() => {
+        internals.screens.unregister(props.entry.key);
+    });
+    defineProvide(useCurrentEntry, () => 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,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACnG,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,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,aAAa,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,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.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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 declare const Header: import("@sigx/runtime-core").ComponentFactory<{}, void, unknown>;
+//# sourceMappingURL=Header.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../src/components/Header.tsx"],"names":[],"mappings":"AA6DA;;;;GAIG;AACH,eAAO,MAAM,MAAM,kEAyDjB,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(), 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/Link.js

@@ -29,10 +29,7 @@ const LinkImpl = component(({ props, slots }) => {
             action(route, props.search);
         }
     };
-    return () => (
-    // `bindtap` is correct here because the underlying element is a Lynx
-    // native `<view>` — sigx component-level events would use `onPress`.
-    _jsx("view", { bindtap: handlePress, children: slots.default?.() }));
+    return () => (_jsx("view", { bindtap: handlePress, children: slots.default?.() }));
 }, { name: 'Link' });
 /**
  * Declarative navigation. Same typing as `nav.push` — pass `params` only when

package/dist/components/Link.js.map

@@ -1 +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;IACT,qEAAqE;IACrE,qEAAqE;IACrE,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"}
+{"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

@@ -4,7 +4,7 @@ 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.
- * Tests against `@sigx/testing-lynx` (which doesn't have an MT runtime)
+ * Tests against `@sigx/lynx-testing` (which doesn't have an MT runtime)
  * should pass `animated={false}` so navigations commit synchronously.
  */
  & Define.Prop<'animated', boolean>

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,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAgB,QAAQ,EAAc,MAAM,aAAa,CAAC;AAEtE,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;;EA0CzB,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"}

package/dist/components/NavigationRoot.js

@@ -1,7 +1,8 @@
-import { component, defineProvide } from '@sigx/lynx';
+import { component, defineProvide, useSharedValue } from '@sigx/lynx';
 import { createNavigatorState } from '../navigator/core.js';
 import { useNav } from '../hooks/use-nav.js';
-import { useNavRoutes } from '../hooks/use-nav-internal.js';
+import { useNavInternals, useNavRoutes } from '../hooks/use-nav-internal.js';
+import { _setRouteRegistry } from '../url/registry.js';
 /**
  * Root of a navigator subtree.
  *
@@ -24,6 +25,12 @@ export const NavigationRoot = component(({ props, slots }) => {
     if (!routes[initialName]) {
         throw new Error(`[lynx-navigation] <NavigationRoot> initialRoute='${initialName}' is not in the routes registry.`);
     }
+    // Publish the active route registry to the URL bridge so module-level
+    // `hrefFor` / `parseHref` callers (deep-link handlers, anything outside
+    // the component tree) resolve against this navigator's routes. Last
+    // mount wins — multi-root apps that need isolation should call the
+    // URL helpers with explicit context (TBD post-1.0).
+    _setRouteRegistry(routes);
     const initialPresentation = routes[initialName].presentation ?? 'card';
     const initial = {
         key: 'root',
@@ -33,9 +40,28 @@ export const NavigationRoot = component(({ props, slots }) => {
         state: undefined,
         presentation: initialPresentation,
     };
-    const navState = createNavigatorState(routes, initial);
+    // SharedValue driving the slide-from-right push/pop transition. Created
+    // unconditionally (hooks must be) but only forwarded into the navigator
+    // when animations are enabled — `createNavigatorState` falls back to
+    // instant swaps when `progress` is undefined.
+    const progressSv = useSharedValue(0);
+    const animationsEnabled = props.animated !== false;
+    const navState = createNavigatorState({
+        routes,
+        initial,
+        progress: animationsEnabled ? progressSv : undefined,
+    });
     defineProvide(useNav, () => navState.nav);
     defineProvide(useNavRoutes, () => navState.routes);
+    const edgeSwipeEnabled = props.edgeSwipeEnabled !== false;
+    defineProvide(useNavInternals, () => ({
+        progress: animationsEnabled ? progressSv : null,
+        beginBackGesture: navState._gesture.beginBackGesture,
+        commitBackGesture: navState._gesture.commitBackGesture,
+        cancelBackGesture: navState._gesture.cancelBackGesture,
+        edgeSwipeEnabled,
+        screens: navState._screens,
+    }));
     return () => slots.default?.();
 });
 //# sourceMappingURL=NavigationRoot.js.map

package/dist/components/NavigationRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationRoot.js","sourceRoot":"","sources":["../../src/components/NavigationRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAe,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAW5D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAsB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;IAC9E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,WAAW,GAAW,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACX,oDAAoD,WAAW,kCAAkC,CACpG,CAAC;IACN,CAAC;IACD,MAAM,mBAAmB,GAAiB,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC;IACrF,MAAM,OAAO,GAAe;QACxB,GAAG,EAAE,MAAM;QACX,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;QACjC,MAAM,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;QACjC,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,mBAAmB;KACpC,CAAC;IAEF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvD,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1C,aAAa,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEnD,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;AACnC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"NavigationRoot.js","sourceRoot":"","sources":["../../src/components/NavigationRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAqBvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAsB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;IAC9E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,WAAW,GAAW,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACX,oDAAoD,WAAW,kCAAkC,CACpG,CAAC;IACN,CAAC;IACD,sEAAsE;IACtE,wEAAwE;IACxE,oEAAoE;IACpE,mEAAmE;IACnE,oDAAoD;IACpD,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,mBAAmB,GAAiB,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC;IACrF,MAAM,OAAO,GAAe;QACxB,GAAG,EAAE,MAAM;QACX,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;QACjC,MAAM,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;QACjC,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,mBAAmB;KACpC,CAAC;IAEF,wEAAwE;IACxE,wEAAwE;IACxE,qEAAqE;IACrE,8CAA8C;IAC9C,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,iBAAiB,GAAG,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC;IACnD,MAAM,QAAQ,GAAG,oBAAoB,CAAC;QAClC,MAAM;QACN,OAAO;QACP,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;KACvD,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1C,aAAa,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,KAAK,KAAK,CAAC;IAC1D,aAAa,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;QAClC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;QAC/C,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,gBAAgB;QACpD,iBAAiB,EAAE,QAAQ,CAAC,QAAQ,CAAC,iBAAiB;QACtD,iBAAiB,EAAE,QAAQ,CAAC,QAAQ,CAAC,iBAAiB;QACtD,gBAAgB;QAChB,OAAO,EAAE,QAAQ,CAAC,QAAQ;KAC7B,CAAC,CAAC,CAAC;IAEJ,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/components/Screen.d.ts

@@ -0,0 +1,98 @@
+/**
+ * `<Screen>` — declarative per-screen options + slot fills.
+ *
+ * Usage:
+ *
+ * ```tsx
+ * const ProfileScreen = component(() => () => (
+ *   <Screen title="Profile" headerShown gestureEnabled>
+ *     <Screen.HeaderRight>
+ *       <text bindtap={onEdit}>Edit</text>
+ *     </Screen.HeaderRight>
+ *     <Screen.TabBarItem>
+ *       {({ active }) => (
+ *         <text style={{ color: active ? '#007aff' : '#888' }}>Me</text>
+ *       )}
+ *     </Screen.TabBarItem>
+ *     <view>body…</view>
+ *   </Screen>
+ * ));
+ * ```
+ *
+ * `<Screen>` itself renders its `default` slot inline — so the body lives
+ * where you'd expect with no extra layout wrapper. The sub-components
+ * (`Screen.Header`, `Screen.HeaderLeft`, `Screen.HeaderRight`,
+ * `Screen.TabBarItem`) render `null` and write into the entry's
+ * `ScreenRegistry`. The navigator's persistent chrome reads from there.
+ *
+ * Sub-component placement inside `<Screen>` is conventional — sigx scopes
+ * are by component tree, so they work anywhere under the same EntryScope.
+ * Placing them as direct children of `<Screen>` keeps the call site
+ * declarative and grep-friendly.
+ */
+import { type Define } from '@sigx/lynx';
+type ScreenProps = Define.Prop<'title', string | (() => string)> & Define.Prop<'headerShown', boolean> & Define.Prop<'gestureEnabled', boolean> & Define.Slot<'default'>;
+type SimpleSlotProps = Define.Slot<'default'>;
+/**
+ * `<Screen.TabBarItem>` — scoped slot. The default slot is a function that
+ * receives `{ active }`; whatever it returns is the tab-bar item content.
+ *
+ * Sigx's `Define.Slot<'default', { active: boolean }>` would express this
+ * directly on the component, but since `<Screen.TabBarItem>`'s parent
+ * (the user's tree, not the navigator) doesn't actually pass `active`, we
+ * accept a plain default slot whose body is itself a function. The
+ * navigator's TabBar invokes that function with the active flag.
+ */
+type TabBarItemProps = Define.Slot<'default'>;
+/**
+ * Compound export. `Screen` is callable as a JSX element and exposes the
+ * sub-components as properties (`Screen.Header`, etc.) for the declarative
+ * call site shown in the file header.
+ */
+export declare const Screen: ((props: {
+    title?: string | (() => string) | undefined;
+    headerShown?: boolean | undefined;
+    gestureEnabled?: boolean | undefined;
+} & {} & {
+    slots?: Partial<{
+        default: () => import("@sigx/runtime-core").JSXElement | import("@sigx/runtime-core").JSXElement[] | null;
+    }> | undefined;
+} & {} & JSX.IntrinsicAttributes & import("@sigx/runtime-core").ComponentAttributeExtensions & {
+    ref?: import("@sigx/runtime-core").Ref<void> | undefined;
+    children?: any;
+}) => import("@sigx/runtime-core").JSXElement) & {
+    __setup: import("@sigx/runtime-core").SetupFn<{
+        title?: string | (() => string) | undefined;
+        headerShown?: boolean | undefined;
+        gestureEnabled?: boolean | undefined;
+    }, ScreenProps, void, {
+        default: () => import("@sigx/runtime-core").JSXElement | import("@sigx/runtime-core").JSXElement[] | null;
+    }>;
+    __name?: string;
+    __islandId?: string;
+    __props: {
+        title?: string | (() => string) | undefined;
+        headerShown?: boolean | undefined;
+        gestureEnabled?: boolean | undefined;
+    };
+    __events: ScreenProps;
+    __ref: void;
+    __slots: {
+        default: () => import("@sigx/runtime-core").JSXElement | import("@sigx/runtime-core").JSXElement[] | null;
+    };
+} & {
+    Header: import("@sigx/runtime-core").ComponentFactory<SimpleSlotProps, void, {
+        default: () => import("@sigx/runtime-core").JSXElement | import("@sigx/runtime-core").JSXElement[] | null;
+    }>;
+    HeaderLeft: import("@sigx/runtime-core").ComponentFactory<SimpleSlotProps, void, {
+        default: () => import("@sigx/runtime-core").JSXElement | import("@sigx/runtime-core").JSXElement[] | null;
+    }>;
+    HeaderRight: import("@sigx/runtime-core").ComponentFactory<SimpleSlotProps, void, {
+        default: () => import("@sigx/runtime-core").JSXElement | import("@sigx/runtime-core").JSXElement[] | null;
+    }>;
+    TabBarItem: import("@sigx/runtime-core").ComponentFactory<TabBarItemProps, void, {
+        default: () => import("@sigx/runtime-core").JSXElement | import("@sigx/runtime-core").JSXElement[] | null;
+    }>;
+};
+export {};
+//# sourceMappingURL=Screen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Screen.d.ts","sourceRoot":"","sources":["../../src/components/Screen.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAA0B,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAIjE,KAAK,WAAW,GACV,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC,GAC7C,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GACnC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GACtC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAgB7B,KAAK,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAoB9C;;;;;;;;;GASG;AACH,KAAK,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAmB9C;;;;GAIG;AACH,eAAO,MAAM,MAAM;4BAzEwB,MAAM;;;;;;;;;;;;gCAAN,MAAM;;;;;;;;;gCAAN,MAAM;;;;;;;;;;;;;;;;;;;;;;CA8E/C,CAAC"}

package/dist/components/Screen.js

@@ -0,0 +1,94 @@
+/**
+ * `<Screen>` — declarative per-screen options + slot fills.
+ *
+ * Usage:
+ *
+ * ```tsx
+ * const ProfileScreen = component(() => () => (
+ *   <Screen title="Profile" headerShown gestureEnabled>
+ *     <Screen.HeaderRight>
+ *       <text bindtap={onEdit}>Edit</text>
+ *     </Screen.HeaderRight>
+ *     <Screen.TabBarItem>
+ *       {({ active }) => (
+ *         <text style={{ color: active ? '#007aff' : '#888' }}>Me</text>
+ *       )}
+ *     </Screen.TabBarItem>
+ *     <view>body…</view>
+ *   </Screen>
+ * ));
+ * ```
+ *
+ * `<Screen>` itself renders its `default` slot inline — so the body lives
+ * where you'd expect with no extra layout wrapper. The sub-components
+ * (`Screen.Header`, `Screen.HeaderLeft`, `Screen.HeaderRight`,
+ * `Screen.TabBarItem`) render `null` and write into the entry's
+ * `ScreenRegistry`. The navigator's persistent chrome reads from there.
+ *
+ * Sub-component placement inside `<Screen>` is conventional — sigx scopes
+ * are by component tree, so they work anywhere under the same EntryScope.
+ * Placing them as direct children of `<Screen>` keeps the call site
+ * declarative and grep-friendly.
+ */
+import { component, onUnmounted } from '@sigx/lynx';
+import { useScreenRegistry } from '../hooks/use-nav-internal.js';
+import { mergeOptions, setSlot } from '../internal/screen-registry.js';
+const ScreenRoot = component(({ props, slots }) => {
+    const registry = useScreenRegistry();
+    // Apply options whenever the component sets up. Options are reactive
+    // through the registry's `options` signal — chrome consumers re-render
+    // on the next merge. We don't bother diffing here: the patch is small
+    // and writes only happen during setup + explicit prop changes upstream.
+    mergeOptions(registry, {
+        title: props.title,
+        headerShown: props.headerShown,
+        gestureEnabled: props.gestureEnabled,
+    });
+    return () => slots.default?.();
+});
+/**
+ * Build a sub-component that registers its `default` slot under `name` on
+ * the current screen's registry. Unmount removes the fill so navigating
+ * away from a screen with a `<Screen.HeaderRight>` clears that action.
+ */
+function makeSlotFiller(name) {
+    return component(({ slots }) => {
+        const registry = useScreenRegistry();
+        setSlot(registry, name, () => slots.default?.());
+        onUnmounted(() => setSlot(registry, name, undefined));
+        return () => null;
+    });
+}
+const Header = makeSlotFiller('header');
+const HeaderLeft = makeSlotFiller('headerLeft');
+const HeaderRight = makeSlotFiller('headerRight');
+const TabBarItem = component(({ slots }) => {
+    const registry = useScreenRegistry();
+    setSlot(registry, 'tabBarItem', (ctx) => {
+        const out = slots.default?.();
+        // Children may be a render function `({active}) => JSX` or plain
+        // JSX (in which case `active` is ignored). Normalise to a value.
+        if (typeof out === 'function')
+            return out(ctx);
+        if (Array.isArray(out)) {
+            const first = out[0];
+            if (typeof first === 'function')
+                return first(ctx);
+        }
+        return out;
+    });
+    onUnmounted(() => setSlot(registry, 'tabBarItem', undefined));
+    return () => null;
+});
+/**
+ * Compound export. `Screen` is callable as a JSX element and exposes the
+ * sub-components as properties (`Screen.Header`, etc.) for the declarative
+ * call site shown in the file header.
+ */
+export const Screen = Object.assign(ScreenRoot, {
+    Header,
+    HeaderLeft,
+    HeaderRight,
+    TabBarItem,
+});
+//# sourceMappingURL=Screen.js.map

package/dist/components/Screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Screen.js","sourceRoot":"","sources":["../../src/components/Screen.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAQvE,MAAM,UAAU,GAAG,SAAS,CAAc,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;IAC3D,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;IACtE,wEAAwE;IACxE,YAAY,CAAC,QAAQ,EAAE;QACnB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;KACvC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;AACnC,CAAC,CAAC,CAAC;AAIH;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAA6C;IACjE,OAAO,SAAS,CAAkB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5C,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjD,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QACtD,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;IACtB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;AACxC,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;AAChD,MAAM,WAAW,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAclD,MAAM,UAAU,GAAG,SAAS,CAAkB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IACxD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9B,iEAAiE;QACjE,iEAAiE;QACjE,IAAI,OAAO,GAAG,KAAK,UAAU;YAAE,OAAQ,GAAkC,CAAC,GAAG,CAAC,CAAC;QAC/E,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,OAAO,KAAK,KAAK,UAAU;gBAAE,OAAQ,KAAoC,CAAC,GAAG,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC,CAAC,CAAC;IACH,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9D,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;AACtB,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE;IAC5C,MAAM;IACN,UAAU;IACV,WAAW;IACX,UAAU;CACb,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"ScreenContainer.d.ts","sourceRoot":"","sources":["../../src/components/ScreenContainer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,gBAAgB,EACrB,KAAK,MAAM,EAEX,KAAK,WAAW,EACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAuCxF,KAAK,oBAAoB,GACnB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GACtC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GACrC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,GACzC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,GACzC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,kDA+B1B,CAAC"}
+{"version":3,"file":"ScreenContainer.d.ts","sourceRoot":"","sources":["../../src/components/ScreenContainer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,gBAAgB,EACrB,KAAK,MAAM,EAEX,KAAK,WAAW,EACnB,MAAM,YAAY,CAAC;AAIpB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAwCxF,KAAK,oBAAoB,GACnB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GACtC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GACrC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,GACzC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,GACzC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,kDA0C1B,CAAC"}

package/dist/components/ScreenContainer.js

@@ -0,0 +1,77 @@
+import { jsx as _jsx } from "@sigx/lynx/jsx-runtime";
+import { component, useMainThreadRef, useAnimatedStyle, } from '@sigx/lynx';
+import { Suspense, isLazyComponent } from '@sigx/lynx';
+import { SCREEN_WIDTH } from '../internal/screen-width.js';
+import { EntryScope } from './EntryScope.js';
+/**
+ * Slide-from-right transition geometry. `SCREEN_WIDTH` is read from
+ * `lynx.SystemInfo` at module load so the animation lands the screen at
+ * exactly translateX=0 (centered) at progress=1, rather than overshooting
+ * into the parent's clip region. `<EdgeBackHandle>` reads the same
+ * constant — they have to agree, otherwise the gesture commit threshold
+ * and the animation geometry don't line up.
+ */
+const PARALLAX_FACTOR = 0.3;
+/**
+ * Compute the `translateX` range for a given (role, kind) pair. Progress
+ * always runs 0 → 1; the role and kind decide what visual state each end of
+ * the progress represents.
+ *
+ * Slide-from-right semantics:
+ *  - PUSH: new top slides in from the right; old top parallaxes left.
+ *  - POP:  current top slides out to the right; underneath returns from the
+ *    parallax-left position.
+ */
+function getRangeParams(role, kind) {
+    if (kind === 'push') {
+        if (role === 'top') {
+            return { inputRange: [0, 1], outputRange: [SCREEN_WIDTH, 0] };
+        }
+        return { inputRange: [0, 1], outputRange: [0, -PARALLAX_FACTOR * SCREEN_WIDTH] };
+    }
+    // pop
+    if (role === 'top') {
+        return { inputRange: [0, 1], outputRange: [0, SCREEN_WIDTH] };
+    }
+    return { inputRange: [0, 1], outputRange: [-PARALLAX_FACTOR * SCREEN_WIDTH, 0] };
+}
+/**
+ * Animated screen slot — absolutely positioned, MT-bound translateX driven by
+ * the navigator's progress SharedValue. Used during transitions to render the
+ * top + underneath entries together.
+ *
+ * Each instance is keyed by `${entry.key}-${role}-${kind}` in the parent so a
+ * role/kind change forces a fresh mount with a fresh `useAnimatedStyle`
+ * binding (the binding is set at setup and can't be re-keyed mid-life). State
+ * loss across transition boundaries is accepted in v0.2; persistent screen
+ * state (scroll position, input fields surviving navigations) is a polish
+ * item for Phase 0.5+.
+ */
+export const ScreenContainer = component(({ props }) => {
+    const ref = useMainThreadRef(null);
+    const params = getRangeParams(props.role, props.kind);
+    useAnimatedStyle(ref, props.progress, 'translateX', params);
+    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;
+        // Wrap lazy screens that declare a fallback in Suspense — see Stack.tsx
+        // for rationale.
+        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',
+                backgroundColor: '#0f172a',
+            }, children: _jsx(EntryScope, { entry: props.entry, children: body }, props.entry.key) }));
+    };
+});
+//# sourceMappingURL=ScreenContainer.js.map

package/dist/components/ScreenContainer.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"Stack.d.ts","sourceRoot":"","sources":["../../src/components/Stack.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAMhF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,KAAK,qCA0EhB,CAAC"}
+{"version":3,"file":"Stack.d.ts","sourceRoot":"","sources":["../../src/components/Stack.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAQhF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,KAAK,qCA2FhB,CAAC"}