@sigx/lynx-navigation 0.2.0 → 0.4.0

package/dist/url/index.js

@@ -1,13 +0,0 @@
-/**
- * URL bridge — internal barrel.
- *
- * Not re-exported from the package root. Public surface is `hrefFor` /
- * `parseHref` in ../href.ts plus `_setRouteRegistry` for tests/bootstrap.
- */
-export { compilePath } from './compile.js';
-export { buildUrl } from './build.js';
-export { parseHrefImpl } from './parse.js';
-export { formatSearch, parseSearch } from './format.js';
-export { _setRouteRegistry, _clearRouteRegistry, getRouteRegistry, getCompiledPath, } from './registry.js';
-export { validateSync } from './validate.js';
-//# sourceMappingURL=index.js.map

package/dist/url/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAqB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAwB,MAAM,eAAe,CAAC"}

package/dist/url/parse.js

@@ -1,94 +0,0 @@
-/**
- * URL → typed Href parser.
- *
- * Walks every registered route with a `path`, tries to match its compiled
- * regex against the URL's pathname, and on a hit validates the extracted
- * params + search through the route's Standard Schema. First match wins;
- * iteration order follows `Object.keys` of the registered routes map.
- *
- * Validation failures return `null` rather than throwing — deep-link handlers
- * fall back to the initial route on a bad URL instead of crashing the app.
- */
-import { parse as parseUrl } from '@sigx/lynx-linking';
-import { parseSearch } from './format.js';
-import { getCompiledPath, getRouteRegistry } from './registry.js';
-import { validateSync } from './validate.js';
-/**
- * Parse a URL string against the active route registry.
- *
- * Accepts both absolute URLs (`myapp://host/users/42?tab=about`) and
- * pathname-only forms (`/users/42?tab=about`). Returns `null` if no route's
- * `path` matches the URL or if schema validation rejects the extracted bits.
- */
-export function parseHrefImpl(url) {
-    if (typeof url !== 'string' || url.length === 0)
-        return null;
-    // Use lynx-linking's parser for the scheme/host split — but accept paths
-    // that don't have a scheme too (raw `/users/42` is the common case from
-    // in-app routing).
-    const { pathname, query } = splitPathAndQuery(url);
-    if (!pathname)
-        return null;
-    const registry = getRouteRegistry();
-    const rawSearch = parseSearch(query);
-    for (const name of Object.keys(registry.routes)) {
-        const compiled = getCompiledPath(registry, name);
-        if (!compiled)
-            continue;
-        const match = compiled.regex.exec(pathname);
-        if (!match)
-            continue;
-        const rawParams = extractParams(compiled, match);
-        const def = registry.routes[name];
-        const paramsOutcome = validateSync(def.params, rawParams);
-        if (!paramsOutcome.ok)
-            continue;
-        const searchOutcome = validateSync(def.search, rawSearch);
-        if (!searchOutcome.ok)
-            continue;
-        return {
-            route: name,
-            params: paramsOutcome.value,
-            search: searchOutcome.value,
-            url,
-        };
-    }
-    return null;
-}
-function extractParams(compiled, match) {
-    const out = {};
-    for (let i = 0; i < compiled.paramNames.length; i++) {
-        const raw = match[i + 1];
-        try {
-            out[compiled.paramNames[i]] = decodeURIComponent(raw);
-        }
-        catch {
-            out[compiled.paramNames[i]] = raw;
-        }
-    }
-    return out;
-}
-function splitPathAndQuery(url) {
-    // Drop the fragment before any path/query work — `#…` is a client-side
-    // anchor that must not leak into the route pathname or query values.
-    const hashIdx = url.indexOf('#');
-    const noHash = hashIdx >= 0 ? url.slice(0, hashIdx) : url;
-    // If the URL has a scheme, defer to lynx-linking's parser — handles
-    // `myapp://host/path?q` correctly. Otherwise treat the whole thing as
-    // pathname+query.
-    const hasScheme = /^[a-zA-Z][a-zA-Z0-9+.\-]*:/.test(noHash);
-    if (hasScheme) {
-        const parsed = parseUrl(noHash);
-        // Reconstruct the query string from the already-parsed bag. We have
-        // to do this because parseUrl decoded keys/values, but parseSearch
-        // expects encoded form. Simpler: split the original ourselves.
-        const qIdx = noHash.indexOf('?');
-        const query = qIdx >= 0 ? noHash.slice(qIdx + 1) : '';
-        return { pathname: parsed.path, query };
-    }
-    const qIdx = noHash.indexOf('?');
-    if (qIdx === -1)
-        return { pathname: noHash, query: '' };
-    return { pathname: noHash.slice(0, qIdx), query: noHash.slice(qIdx + 1) };
-}
-//# sourceMappingURL=parse.js.map

package/dist/url/parse.js.map

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

package/dist/url/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/url/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAS3C,IAAI,OAAO,GAAyB,IAAI,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAgB;IAC9C,OAAO,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB;IAC/B,OAAO,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACX,mHAAmH,CACtH,CAAC;IACN,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAuB,EAAE,IAAY;IACjE,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/url/validate.js

@@ -1,37 +0,0 @@
-/**
- * Standard Schema validation helper (sync only).
- *
- * `hrefFor` and `parseHref` run on hot paths (link rendering, deep-link
- * resolution) so we restrict to sync validators. Zod/Valibot/ArkType are all
- * sync, which covers the common case. Async validators throw a clear error.
- */
-/**
- * Run a Standard Schema's `validate` synchronously. When the schema lacks a
- * `validate` function (e.g. our test `fakeSchema`), passthrough — assume the
- * input is already in the correct shape. This is a deliberate ergonomic
- * choice so the type-spike fixtures stay terse.
- */
-export function validateSync(schema, input) {
-    if (!schema)
-        return { ok: true, value: input };
-    const validate = schema['~standard']?.validate;
-    if (!validate)
-        return { ok: true, value: input };
-    const result = validate(input);
-    if (isPromiseLike(result)) {
-        throw new Error('[lynx-navigation] Async schema validation is not supported on the URL bridge — use a sync validator (Zod/Valibot/ArkType are all sync).');
-    }
-    if (result.issues !== undefined && result.issues.length > 0) {
-        return {
-            ok: false,
-            issues: result.issues.map((i) => i.message),
-        };
-    }
-    return { ok: true, value: result.value };
-}
-function isPromiseLike(v) {
-    return (v !== null
-        && typeof v === 'object'
-        && typeof v.then === 'function');
-}
-//# sourceMappingURL=validate.js.map

package/dist/url/validate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/url/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CACxB,MAAoC,EACpC,KAAc;IAEd,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAI,MAAgC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;IAC1E,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACX,yIAAyI,CAC5I,CAAC;IACN,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO;YACH,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SAC9C,CAAC;IACN,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAG,MAA6B,CAAC,KAAK,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,aAAa,CAAI,CAAU;IAChC,OAAO,CACH,CAAC,KAAK,IAAI;WACP,OAAO,CAAC,KAAK,QAAQ;WACrB,OAAQ,CAAwB,CAAC,IAAI,KAAK,UAAU,CAC1D,CAAC;AACN,CAAC"}

package/src/components/ScreenContainer.tsx

@@ -1,114 +0,0 @@
-import {
-    component,
-    useMainThreadRef,
-    useAnimatedStyle,
-    type ComponentFactory,
-    type Define,
-    type MainThread,
-    type SharedValue,
-} from '@sigx/lynx';
-import { Suspense, isLazyComponent } from '@sigx/lynx';
-import type { MapperParams } from '@sigx/lynx';
-import { SCREEN_WIDTH } from '../internal/screen-width.js';
-import type { RouteMap, StackEntry, TransitionKind, TransitionRole } from '../types.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: TransitionRole,
-    kind: TransitionKind,
-): MapperParams['translateX'] {
-    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] };
-}
-
-type ScreenContainerProps =
-    & Define.Prop<'entry', StackEntry, true>
-    & Define.Prop<'routes', RouteMap, true>
-    & Define.Prop<'role', TransitionRole, true>
-    & Define.Prop<'kind', TransitionKind, true>
-    & Define.Prop<'progress', SharedValue<number>, true>;
-
-/**
- * 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<ScreenContainerProps>(({ props }) => {
-    const ref = useMainThreadRef<MainThread.Element | null>(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 as unknown as ComponentFactory<
-            Record<string, unknown>,
-            unknown,
-            unknown
-        >;
-        if (typeof Comp !== 'function') return null;
-        const entryParams = props.entry.params as Record<string, unknown>;
-        // Wrap lazy screens that declare a fallback in Suspense — see Stack.tsx
-        // for rationale.
-        const body = isLazyComponent(Comp) && route.fallback
-            ? (
-                <Suspense fallback={route.fallback as never}>
-                    <Comp {...entryParams} />
-                </Suspense>
-            )
-            : <Comp {...entryParams} />;
-        return (
-            <view
-                main-thread:ref={ref}
-                style={{
-                    position: 'absolute',
-                    top: '0',
-                    left: '0',
-                    right: '0',
-                    bottom: '0',
-                    backgroundColor: '#0f172a',
-                }}
-            >
-                <EntryScope key={props.entry.key} entry={props.entry}>
-                    {body}
-                </EntryScope>
-            </view>
-        );
-    };
-});