@sigx/lynx-navigation 0.4.0 → 0.4.2

package/dist/register.d.ts

@@ -1,4 +1,4 @@
-import type { ParamsOf, RouteMap, SearchOf } from './types';
+import type { ParamsOf, RouteMap, SearchOf } from './types.js';
 /**
  * Module-augmentation surface for the user's typed route map.
  *

package/dist/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,QAAQ;CAExB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,QAAQ,CAAC;AAEnF,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3E,+CAA+C;AAC/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,QAAQ;CAExB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,QAAQ,CAAC;AAEnF,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3E,+CAA+C;AAC/C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/register.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":""}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Core types for @sigx/lynx-navigation.
+ *
+ * The type machinery here is the differentiating DX: route names, params, and
+ * search are all inferred end-to-end from the user's `defineRoutes` call so
+ * `nav.push('profile', { id: 42 })` is a TS error if `id` is typed as string.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/url/build.js

@@ -0,0 +1,30 @@
+/**
+ * Typed → URL: build the `url` field of an Href from a route's params/search.
+ *
+ * Mirror of parse.ts. Used by `hrefFor()` after schema validation succeeds.
+ */
+import { formatSearch } from './format.js';
+import { getCompiledPath, getRouteRegistry } from './registry.js';
+/**
+ * Build the URL form of a route + params + search, or `null` if the route
+ * declares no `path` template (typed navigation still works — only deep-link
+ * serialization is unavailable).
+ *
+ * Params must already be valid for the route's schema (callers run this after
+ * `validateSync`). Search values are stringified as-is — schema-validated
+ * inputs survive round-tripping because `parseHref` re-runs the same schema.
+ */
+export function buildUrl(routeName, params, search) {
+    const registry = getRouteRegistry();
+    const compiled = getCompiledPath(registry, routeName);
+    if (!compiled)
+        return null;
+    const formatted = compiled.format(
+    // The compiler accepts string|number; we widen to unknown and let it
+    // String()-coerce. Booleans/null get filtered by the missing-param
+    // check, which is what we want — boolean path params don't exist.
+    (params ?? {}));
+    const querystring = formatSearch(search);
+    return querystring.length > 0 ? `${formatted}?${querystring}` : formatted;
+}
+//# sourceMappingURL=build.js.map

package/dist/url/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/url/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACpB,SAAiB,EACjB,MAA2C,EAC3C,MAA2C;IAE3C,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM;IAC7B,qEAAqE;IACrE,mEAAmE;IACnE,kEAAkE;IAClE,CAAC,MAAM,IAAI,EAAE,CAAoC,CACpD,CAAC;IACF,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC"}

package/dist/url/compile.js

@@ -0,0 +1,83 @@
+/**
+ * Path template compiler.
+ *
+ * Turns a route's `path` (e.g. `/users/:id/posts/:postId`) into a compiled
+ * object that can both match a URL pathname against it and format a typed
+ * params object back into a URL.
+ *
+ * Supported syntax (intentionally minimal for v1):
+ *   - Literal segments:  `/users`, `/users/me`
+ *   - Named params:      `:id` (matches `[^/]+`)
+ *   - Trailing slashes tolerated on match
+ *
+ * Out of scope for v1 (future-compatible — additions won't break v1 paths):
+ *   - Wildcards `*`
+ *   - Optional params `:id?`
+ *   - Typed/constrained params `:id<number>` or `:id(\\d+)`
+ */
+const PARAM_RE = /:([A-Za-z_][A-Za-z0-9_]*)/g;
+/**
+ * Compile a path template. Throws on malformed input (duplicate param names,
+ * unexpected `:` syntax). Pure — safe to memoize.
+ */
+export function compilePath(template) {
+    if (typeof template !== 'string') {
+        throw new TypeError(`compilePath: expected string, got ${typeof template}`);
+    }
+    if (template.length === 0) {
+        throw new Error('compilePath: path template must not be empty');
+    }
+    // Normalize: ensure leading `/`. Trailing slashes are tolerated on match,
+    // but the canonical formatted output preserves the template's trailing
+    // slash policy.
+    const normalized = template.startsWith('/') ? template : `/${template}`;
+    const paramNames = [];
+    // Build the regex by replacing :name with a capture group. We escape the
+    // surrounding literal text so paths with regex-special chars (`.`, `+`)
+    // match literally — only `:name` is treated as a placeholder.
+    let lastIndex = 0;
+    let pattern = '';
+    PARAM_RE.lastIndex = 0;
+    for (let m = PARAM_RE.exec(normalized); m !== null; m = PARAM_RE.exec(normalized)) {
+        const name = m[1];
+        if (paramNames.includes(name)) {
+            throw new Error(`compilePath: duplicate param name ':${name}' in '${template}'`);
+        }
+        paramNames.push(name);
+        pattern += escapeRegex(normalized.slice(lastIndex, m.index));
+        pattern += '([^/]+)';
+        lastIndex = m.index + m[0].length;
+    }
+    pattern += escapeRegex(normalized.slice(lastIndex));
+    // Trim a trailing slash from the pattern so `/users/` and `/users` both
+    // match `/users/:?`. We keep the formatter's output as-templated.
+    const matchPattern = pattern.endsWith('/') ? pattern.slice(0, -1) : pattern;
+    const regex = new RegExp(`^${matchPattern}/?$`);
+    return {
+        source: template,
+        paramNames,
+        regex,
+        format(params) {
+            let out = '';
+            let i = 0;
+            PARAM_RE.lastIndex = 0;
+            for (let m = PARAM_RE.exec(normalized); m !== null; m = PARAM_RE.exec(normalized)) {
+                const name = m[1];
+                const value = params[name];
+                if (value === undefined || value === null) {
+                    throw new Error(`compilePath.format: missing required param ':${name}' for '${template}'`);
+                }
+                out += normalized.slice(i, m.index);
+                out += encodeURIComponent(String(value));
+                i = m.index + m[0].length;
+            }
+            out += normalized.slice(i);
+            return out;
+        },
+    };
+}
+const REGEX_SPECIALS = /[.*+?^${}()|[\]\\]/g;
+function escapeRegex(s) {
+    return s.replace(REGEX_SPECIALS, '\\$&');
+}
+//# sourceMappingURL=compile.js.map

package/dist/url/compile.js.map

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

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

@@ -4,10 +4,10 @@
  * 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';
-export { buildUrl } from './build';
-export { parseHrefImpl } from './parse';
-export { formatSearch, parseSearch } from './format';
-export { _setRouteRegistry, _clearRouteRegistry, getRouteRegistry, getCompiledPath, } from './registry';
-export { validateSync, type ValidateOutcome } from './validate';
+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

@@ -1 +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,WAAW,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"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

@@ -9,7 +9,7 @@
  * 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';
+import type { Href } from '../href.js';
 /**
  * Parse a URL string against the active route registry.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/url/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAQpC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkCtD"}
+{"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

@@ -11,8 +11,8 @@
  * directly. The leading underscore is a convention: not part of the supported
  * public API (test/integration use only).
  */
-import type { CompiledPath } from './compile';
-import type { RouteMap } from '../types';
+import type { CompiledPath } from './compile.js';
+import type { RouteMap } from '../types.js';
 interface RegistryState {
     readonly routes: RouteMap;
     /** Lazy-compiled paths keyed by route name. */

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/url/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,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"}
+{"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/{src/url/registry.d.ts → dist/url/registry.js}

@@ -11,13 +11,8 @@
  * directly. The leading underscore is a convention: not part of the supported
  * public API (test/integration use only).
  */
-import type { CompiledPath } from './compile';
-import type { RouteMap } from '../types';
-interface RegistryState {
-    readonly routes: RouteMap;
-    /** Lazy-compiled paths keyed by route name. */
-    readonly compiled: Map<string, CompiledPath>;
-}
+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`.
@@ -27,14 +22,35 @@ interface RegistryState {
  * specific registry for a one-off call, pass it explicitly to the helper
  * (parseHrefWithRoutes / hrefForWithRoutes — currently internal).
  */
-export declare function _setRouteRegistry(routes: RouteMap): void;
+export function _setRouteRegistry(routes) {
+    current = { routes, compiled: new Map() };
+}
 /** Clear the registry. Mainly for tests that want to assert the unset path. */
-export declare function _clearRouteRegistry(): void;
+export function _clearRouteRegistry() {
+    current = null;
+}
 /** Get the active registry or throw a friendly error if none is set. */
-export declare function getRouteRegistry(): RegistryState;
+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 declare function getCompiledPath(registry: RegistryState, name: string): CompiledPath | null;
-export {};
+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

@@ -5,7 +5,7 @@
  * 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';
+import type { StandardSchemaV1 } from '../types.js';
 /** Outcome of a sync validation call — discriminated for explicit handling. */
 export type ValidateOutcome = {
     readonly ok: true;

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

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/url/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAmBjD,+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"}
+{"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,6 +1,6 @@
 {
   "name": "@sigx/lynx-navigation",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Type-first native navigator for sigx-lynx — Stack, Tabs, Drawer, modals, lazy routes, deep links",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,9 +16,10 @@
     "dist"
   ],
   "peerDependencies": {
-    "@sigx/lynx-linking": "^0.4.0",
-    "@sigx/lynx": "^0.4.0",
-    "@sigx/lynx-motion": "^0.4.0"
+    "@sigx/lynx": "^0.4.2",
+    "@sigx/lynx-linking": "^0.4.2",
+    "@sigx/lynx-icons": "^0.4.2",
+    "@sigx/lynx-motion": "^0.4.2"
   },
   "peerDependenciesMeta": {
     "@sigx/lynx-linking": {
@@ -26,13 +27,14 @@
     }
   },
   "devDependencies": {
+    "@typescript/native-preview": "7.0.0-dev.20260521.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6",
-    "@sigx/vite": "^0.4.3",
-    "@sigx/lynx": "^0.4.0",
-    "@sigx/lynx-linking": "^0.4.0",
-    "@sigx/lynx-testing": "^0.4.0",
-    "@sigx/lynx-motion": "^0.4.0"
+    "vitest": "^4.1.7",
+    "@sigx/lynx": "^0.4.2",
+    "@sigx/lynx-linking": "^0.4.2",
+    "@sigx/lynx-icons": "^0.4.2",
+    "@sigx/lynx-motion": "^0.4.2",
+    "@sigx/lynx-testing": "^0.4.2"
   },
   "keywords": [
     "sigx",
@@ -60,10 +62,11 @@
     "access": "public"
   },
   "scripts": {
-    "build": "vite build && tsgo --emitDeclarationOnly",
-    "dev": "vite build --watch",
+    "build": "node ../../scripts/clean.mjs dist && tsgo",
+    "dev": "tsgo --watch",
     "test": "vitest run",
     "test:types": "tsc --noEmit",
-    "bench": "vitest bench --run"
+    "bench": "vitest bench --run",
+    "clean": "node ../../scripts/clean.mjs dist .turbo"
   }
 }

package/src/components/EdgeBackHandle.tsx

@@ -7,8 +7,8 @@ import {
     type MainThread,
 } from '@sigx/lynx';
 import { withTiming } from '@sigx/lynx-motion';
-import { useNavInternals } from '../hooks/use-nav-internal';
-import { SCREEN_WIDTH } from '../internal/screen-width';
+import { useNavInternals } from '../hooks/use-nav-internal.js';
+import { SCREEN_WIDTH } from '../internal/screen-width.js';
 
 /**
  * Edge-pan recognizer for iOS-style swipe-back. Mounts as an absolutely-