@sigx/lynx-navigation 0.1.0 → 0.1.2

package/dist/url/format.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Format helpers: typed params/search → URL string.
+ *
+ * Used by `hrefFor()` to render the `url` field of an Href.
+ */
+/**
+ * Serialize an object as a `key=value&key=value` querystring.
+ *
+ * Keys are sorted to make the output deterministic (useful for tests and
+ * persistence diffs). `undefined`/`null` values are skipped. Non-primitive
+ * values are JSON-stringified on the way out — `parseSearch` returns the
+ * raw string and leaves any JSON decoding to the route's `search` schema
+ * (e.g. a Zod `transform`), so the round-trip is intentionally one-way at
+ * this layer.
+ *
+ * Returns `''` (empty string) when there are no entries — callers join with
+ * `?` only when the result is non-empty.
+ */
+export declare function formatSearch(search: Record<string, unknown> | undefined): string;
+/**
+ * Parse a `key=value&key=value` querystring into a string-keyed bag. Values
+ * are decoded but kept as strings — typed coercion happens in the route's
+ * `search` schema (e.g. Zod's `z.coerce.number()`).
+ *
+ * Multiple occurrences of the same key produce an array. Schemas that don't
+ * expect arrays will reject this — that's the right failure mode.
+ */
+export declare function parseSearch(query: string): Record<string, string | string[]>;
+//# sourceMappingURL=format.d.ts.map

package/dist/url/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/url/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAkBhF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAwB5E"}

package/dist/url/format.js

@@ -0,0 +1,102 @@
+/**
+ * Format helpers: typed params/search → URL string.
+ *
+ * Used by `hrefFor()` to render the `url` field of an Href.
+ */
+/**
+ * Serialize an object as a `key=value&key=value` querystring.
+ *
+ * Keys are sorted to make the output deterministic (useful for tests and
+ * persistence diffs). `undefined`/`null` values are skipped. Non-primitive
+ * values are JSON-stringified on the way out — `parseSearch` returns the
+ * raw string and leaves any JSON decoding to the route's `search` schema
+ * (e.g. a Zod `transform`), so the round-trip is intentionally one-way at
+ * this layer.
+ *
+ * Returns `''` (empty string) when there are no entries — callers join with
+ * `?` only when the result is non-empty.
+ */
+export function formatSearch(search) {
+    if (!search)
+        return '';
+    const keys = Object.keys(search).sort();
+    const parts = [];
+    for (const key of keys) {
+        const value = search[key];
+        if (value === undefined || value === null)
+            continue;
+        const encoded = encodeURIComponent(key);
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                parts.push(`${encoded}=${encodeURIComponent(serializeScalar(item))}`);
+            }
+        }
+        else {
+            parts.push(`${encoded}=${encodeURIComponent(serializeScalar(value))}`);
+        }
+    }
+    return parts.join('&');
+}
+/**
+ * Parse a `key=value&key=value` querystring into a string-keyed bag. Values
+ * are decoded but kept as strings — typed coercion happens in the route's
+ * `search` schema (e.g. Zod's `z.coerce.number()`).
+ *
+ * Multiple occurrences of the same key produce an array. Schemas that don't
+ * expect arrays will reject this — that's the right failure mode.
+ */
+export function parseSearch(query) {
+    const result = {};
+    if (!query)
+        return result;
+    // Strip leading `?` if present (formatHref doesn't include it but callers
+    // sometimes pass `?a=1`).
+    const cleaned = query.startsWith('?') ? query.slice(1) : query;
+    if (!cleaned)
+        return result;
+    for (const pair of cleaned.split('&')) {
+        if (!pair)
+            continue;
+        const eqIdx = pair.indexOf('=');
+        const rawKey = eqIdx === -1 ? pair : pair.slice(0, eqIdx);
+        const rawValue = eqIdx === -1 ? '' : pair.slice(eqIdx + 1);
+        const key = safeDecode(rawKey);
+        const value = safeDecode(rawValue);
+        const existing = result[key];
+        if (existing === undefined) {
+            result[key] = value;
+        }
+        else if (Array.isArray(existing)) {
+            existing.push(value);
+        }
+        else {
+            result[key] = [existing, value];
+        }
+    }
+    return result;
+}
+function serializeScalar(v) {
+    switch (typeof v) {
+        case 'string': return v;
+        case 'number':
+        case 'boolean':
+        case 'bigint':
+            return String(v);
+        default:
+            // Objects/arrays/etc — JSON. Schemas can decide how to interpret.
+            return JSON.stringify(v);
+    }
+}
+function safeDecode(s) {
+    try {
+        return decodeURIComponent(s.replace(/\+/g, ' '));
+    }
+    catch {
+        // Malformed % escape — fall back to the raw text rather than throwing
+        // from a navigation hot path. The schema will reject if it matters.
+        return s;
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/url/format.js.map

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

package/dist/url/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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, type CompiledPath } 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, type ValidateOutcome } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/url/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,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,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/url/index.js

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

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

@@ -0,0 +1,21 @@
+/**
+ * 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 type { Href } from '../href.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 declare function parseHrefImpl(url: string): Href | null;
+//# sourceMappingURL=parse.d.ts.map

package/dist/url/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/url/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAQvC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkCtD"}

package/dist/url/parse.js

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

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

package/dist/url/registry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Module-level route registry for the URL bridge.
+ *
+ * `hrefFor()` and `parseHref()` are designed to be callable from anywhere —
+ * including outside the component tree (e.g. deep-link bootstrapping in
+ * native bridge code). They can't reach the in-tree `useNavRoutes` injectable
+ * directly, so we mirror the active routes here.
+ *
+ * `<NavigationRoot>` sets this synchronously during setup. Tests that exercise
+ * the URL helpers without a NavigationRoot can call `_setRouteRegistry`
+ * directly. The leading underscore is a convention: not part of the supported
+ * public API (test/integration use only).
+ */
+import type { CompiledPath } from './compile.js';
+import type { RouteMap } from '../types.js';
+interface RegistryState {
+    readonly routes: RouteMap;
+    /** Lazy-compiled paths keyed by route name. */
+    readonly compiled: Map<string, CompiledPath>;
+}
+/**
+ * Set the active route registry. Called by `<NavigationRoot>` on setup and
+ * available to tests/bootstrap code as `_setRouteRegistry`.
+ *
+ * Last write wins — multi-root apps and rapid mount/unmount cycles in tests
+ * always see the most recent `<NavigationRoot>`'s routes. If you need a
+ * specific registry for a one-off call, pass it explicitly to the helper
+ * (parseHrefWithRoutes / hrefForWithRoutes — currently internal).
+ */
+export declare function _setRouteRegistry(routes: RouteMap): void;
+/** Clear the registry. Mainly for tests that want to assert the unset path. */
+export declare function _clearRouteRegistry(): void;
+/** Get the active registry or throw a friendly error if none is set. */
+export declare function getRouteRegistry(): RegistryState;
+/**
+ * Look up (or lazily compile) the path template for a route name. Returns
+ * `null` when the route exists but declares no `path`.
+ */
+export declare function getCompiledPath(registry: RegistryState, name: string): CompiledPath | null;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/url/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/url/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,UAAU,aAAa;IACnB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAChD;AAID;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAExD;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAU1F"}

package/dist/url/registry.js

@@ -0,0 +1,56 @@
+/**
+ * Module-level route registry for the URL bridge.
+ *
+ * `hrefFor()` and `parseHref()` are designed to be callable from anywhere —
+ * including outside the component tree (e.g. deep-link bootstrapping in
+ * native bridge code). They can't reach the in-tree `useNavRoutes` injectable
+ * directly, so we mirror the active routes here.
+ *
+ * `<NavigationRoot>` sets this synchronously during setup. Tests that exercise
+ * the URL helpers without a NavigationRoot can call `_setRouteRegistry`
+ * directly. The leading underscore is a convention: not part of the supported
+ * public API (test/integration use only).
+ */
+import { compilePath } from './compile.js';
+let current = null;
+/**
+ * Set the active route registry. Called by `<NavigationRoot>` on setup and
+ * available to tests/bootstrap code as `_setRouteRegistry`.
+ *
+ * Last write wins — multi-root apps and rapid mount/unmount cycles in tests
+ * always see the most recent `<NavigationRoot>`'s routes. If you need a
+ * specific registry for a one-off call, pass it explicitly to the helper
+ * (parseHrefWithRoutes / hrefForWithRoutes — currently internal).
+ */
+export function _setRouteRegistry(routes) {
+    current = { routes, compiled: new Map() };
+}
+/** Clear the registry. Mainly for tests that want to assert the unset path. */
+export function _clearRouteRegistry() {
+    current = null;
+}
+/** Get the active registry or throw a friendly error if none is set. */
+export function getRouteRegistry() {
+    if (!current) {
+        throw new Error('[lynx-navigation] No route registry set — render a <NavigationRoot> first, or call _setRouteRegistry() for tests.');
+    }
+    return current;
+}
+/**
+ * Look up (or lazily compile) the path template for a route name. Returns
+ * `null` when the route exists but declares no `path`.
+ */
+export function getCompiledPath(registry, name) {
+    const def = registry.routes[name];
+    if (!def)
+        return null;
+    if (!def.path)
+        return null;
+    let compiled = registry.compiled.get(name);
+    if (!compiled) {
+        compiled = compilePath(def.path);
+        registry.compiled.set(name, compiled);
+    }
+    return compiled;
+}
+//# sourceMappingURL=registry.js.map

package/dist/url/registry.js.map

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

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+import type { StandardSchemaV1 } from '../types.js';
+/** Outcome of a sync validation call — discriminated for explicit handling. */
+export type ValidateOutcome = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly issues: ReadonlyArray<string>;
+};
+/**
+ * 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 declare function validateSync(schema: StandardSchemaV1 | undefined, input: unknown): ValidateOutcome;
+//# sourceMappingURL=validate.d.ts.map

package/dist/url/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/url/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAmBpD,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,YAAY,CACxB,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,KAAK,EAAE,OAAO,GACf,eAAe,CAiBjB"}

package/dist/url/validate.js

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

@@ -0,0 +1 @@
+{"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/package.json

@@ -1,20 +1,24 @@
 {
   "name": "@sigx/lynx-navigation",
-  "version": "0.1.0",
-  "description": "Type-first native stack router for sigx-lynx",
+  "version": "0.1.2",
+  "description": "Type-first native navigator for sigx-lynx — Stack, Tabs, Drawer, modals, lazy routes, deep links",
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
   },
   "files": [
     "src",
     "dist"
   ],
   "peerDependencies": {
-    "@sigx/lynx": "^0.1.0",
-    "@sigx/lynx-linking": "^0.1.0"
+    "@sigx/lynx-motion": "^0.1.1",
+    "@sigx/lynx": "^0.1.4",
+    "@sigx/lynx-linking": "^0.1.2"
   },
   "peerDependenciesMeta": {
     "@sigx/lynx-linking": {
@@ -22,18 +26,43 @@
     }
   },
   "devDependencies": {
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.4",
-    "@sigx/lynx": "^0.1.0",
-    "@sigx/lynx-linking": "^0.1.0",
-    "@sigx/testing-lynx": "^0.2.4"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6",
+    "@sigx/lynx": "^0.1.4",
+    "@sigx/lynx-linking": "^0.1.2",
+    "@sigx/lynx-testing": "^0.2.6",
+    "@sigx/lynx-motion": "^0.1.1"
   },
+  "keywords": [
+    "sigx",
+    "lynx",
+    "navigation",
+    "router",
+    "stack",
+    "tabs",
+    "drawer",
+    "deep-linking",
+    "type-safe"
+  ],
   "author": "Andreas Ekdahl",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/signalxjs/lynx.git",
+    "directory": "packages/lynx-navigation"
+  },
+  "homepage": "https://github.com/signalxjs/lynx/tree/main/packages/lynx-navigation",
+  "bugs": {
+    "url": "https://github.com/signalxjs/lynx/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
-    "build": "tsc --emitDeclarationOnly",
-    "dev": "tsc --emitDeclarationOnly --watch",
+    "build": "tsc",
+    "dev": "tsc --watch",
     "test": "vitest run",
-    "test:types": "tsc --noEmit"
+    "test:types": "tsc --noEmit",
+    "bench": "vitest bench --run"
   }
 }