@sigx/lynx-navigation 0.2.0 → 0.4.0

package/dist/navigator/core.js

@@ -1,383 +0,0 @@
-import { runOnMainThread, signal, untrack, } from '@sigx/lynx';
-import { isLazyComponent } from '@sigx/lynx';
-import { withTiming } from '@sigx/lynx-motion';
-/**
- * Slide-from-right transition timing. Kept as constants so screen options
- * can override per-screen later (Phase 0.5). Duration is in seconds — that's
- * what `@sigx/lynx-motion`'s `withTiming` expects (per `with-timing.ts`).
- */
-const TRANSITION_DURATION_SEC = 0.28;
-/**
- * Kick off a lazy component's chunk fetch when its route is navigated to.
- *
- * Lazy routes (`component: lazy(() => import('./Heavy.js'))`) start loading
- * the moment `push`/`replace` is called rather than waiting until render
- * tries to instantiate them — by the time `<Stack>` swaps screens the chunk
- * is usually already resolved, so the user sees the screen instead of the
- * `<Suspense fallback>`. Fire-and-forget: errors here surface through
- * `<Suspense>` at render time.
- */
-function preloadRouteComponent(component) {
-    if (isLazyComponent(component)) {
-        // eslint-disable-next-line @typescript-eslint/no-empty-function
-        component.preload().catch(() => { });
-    }
-}
-let entryKeyCounter = 0;
-function nextEntryKey() {
-    entryKeyCounter += 1;
-    return `entry-${entryKeyCounter}-${Math.random().toString(36).slice(2, 8)}`;
-}
-function makeEntry(name, params, search, options, routes) {
-    const route = routes[name];
-    const presentation = options?.presentation ?? route?.presentation ?? 'card';
-    return {
-        key: nextEntryKey(),
-        route: name,
-        params: (params ?? {}),
-        search: (search ?? {}),
-        state: options?.state,
-        presentation,
-    };
-}
-function unpackArgs(name, args, routes) {
-    const route = routes[name];
-    const requiresParams = !!route?.params;
-    if (requiresParams) {
-        const [params, search, options] = args;
-        return { params, search, options };
-    }
-    const [search, options] = args;
-    return { params: undefined, search, options };
-}
-/**
- * Create a navigator. Returns the public `nav` handle plus the routes map.
- * The transition signal lives on `nav` (via `nav.transition`) so `<Stack>`
- * can subscribe to it.
- */
-export function createNavigatorState(opts) {
-    const { routes, initial, progress, parent = null } = opts;
-    const stackSignal = signal([initial]);
-    const focusedBox = signal({
-        value: opts.initialLocallyFocused ?? true,
-    });
-    const children = new Set();
-    // `signal(null)` would wrap as a primitive (no `$set`), so wrap in an
-    // object to get the standard `{ value }`-style API. Reading `.value`
-    // tracks; writing triggers re-render of `<Stack>`.
-    const transitionBox = signal({ value: null });
-    function getStack() {
-        return stackSignal;
-    }
-    function setStack(next) {
-        stackSignal.$set(next);
-    }
-    function setTransition(next) {
-        transitionBox.value = next;
-    }
-    /**
-     * Whether a transition is currently in flight. Used to no-op concurrent
-     * navigation calls — keeps the state machine simple. A queued/aborted
-     * model is a v0.3 polish item.
-     */
-    function isTransitioning() {
-        return transitionBox.value !== null;
-    }
-    /**
-     * Run the slide animation by hopping a worklet onto the main thread that
-     * resets `progress` to 0 and starts a `withTiming` to the target. Then
-     * wait the animation duration on BG so we can fire the completion
-     * callback (clear transition / commit the popped entry) when the visual
-     * animation is done.
-     *
-     * Why the SV reset lives *inside* the worklet (not on BG before the call):
-     * the BG-side render ops (Stack re-render mounting the two
-     * `ScreenContainer`s with their `useAnimatedStyle` bindings) and a BG-side
-     * SV write (`progress.value = 0`) travel different bridge channels. On
-     * subsequent navigations, MT can register the new bindings before the
-     * BG-side reset arrives — the bindings snapshot sv at its previous
-     * end-state (`1`), and `withTiming(sv, 1, ...)` then animates from 1→1
-     * (no visible motion). Resetting inside the worklet guarantees the order
-     * `bindings register → sv resets → withTiming starts` happens atomically
-     * on MT.
-     *
-     * Why we don't `await` the worklet's Promise: `withTiming` returns a
-     * Promise on MT, but Promises don't serialize across the BG/MT bridge —
-     * `runOnMainThread`'s callback fires the moment the worklet *returns*
-     * (synchronously, with `undefined` since the Promise can't cross), not
-     * when the underlying animation finishes. We time the BG-side wait
-     * against the duration we passed to MT instead.
-     */
-    async function animateProgress(target, durationSec) {
-        if (!progress)
-            return;
-        const sv = progress;
-        const runner = runOnMainThread((t, d) => {
-            'main thread';
-            // MT-side direct write — `sv.value` is a BG-side getter/setter
-            // that emits a "read-only on BG" warning when set; the actual
-            // MT field (which `withTiming`'s animate() reads as the start
-            // value) is `sv.current.value`. See `packages/lynx-runtime/src/
-            // animated/shared-value.ts:14-44`.
-            sv.current.value = 0;
-            withTiming(sv, t, { duration: d });
-        });
-        runner(target, durationSec);
-        await new Promise((resolve) => {
-            setTimeout(resolve, Math.round(durationSec * 1000));
-        });
-    }
-    const push = ((name, ...args) => {
-        if (!routes[name]) {
-            throw new Error(`[lynx-navigation] push('${name}'): route is not registered. ` +
-                `Known routes: ${Object.keys(routes).join(', ') || '(none)'}`);
-        }
-        const { params, search, options } = unpackArgs(name, args, routes);
-        // Escalate non-card presentations up the parent chain. Modals,
-        // fullScreen, and transparent-modal routes belong on the root
-        // navigator so they overlay tab UI and persistent chrome. We resolve
-        // the presentation the same way `makeEntry` does so the escalation
-        // decision matches what would actually be shown.
-        const resolvedPresentation = (options?.presentation ?? routes[name].presentation ?? 'card');
-        if (resolvedPresentation !== 'card' && parent) {
-            // Walk straight to the root — every navigator with a parent
-            // delegates non-card pushes upward, so a chain of any depth
-            // collapses to a single push on the topmost nav.
-            // Forward original args verbatim so overloads (`push(name)`,
-            // `push(name, params)`, `push(name, params, search)`,
-            // `push(name, params, search, options)`) keep their meaning.
-            parent.push(name, ...args);
-            return;
-        }
-        if (isTransitioning())
-            return;
-        preloadRouteComponent(routes[name].component);
-        const newEntry = makeEntry(name, params, search, options, routes);
-        const cur = getStack();
-        const prevTop = cur[cur.length - 1];
-        // Append eagerly — UX-wise the user just initiated a forward nav, so
-        // the new entry should be queryable immediately (`nav.current` =
-        // newEntry). The slide animation overlays the visual transition.
-        setStack([...cur, newEntry]);
-        const animated = options?.animated !== false && !!progress;
-        if (!animated)
-            return;
-        setTransition({
-            kind: 'push',
-            topEntry: newEntry,
-            underneathEntry: prevTop,
-            progress,
-        });
-        animateProgress(1, TRANSITION_DURATION_SEC).then(() => setTransition(null), () => setTransition(null));
-    });
-    const replace = ((name, ...args) => {
-        if (isTransitioning())
-            return;
-        const { params, search, options } = unpackArgs(name, args, routes);
-        if (!routes[name]) {
-            throw new Error(`[lynx-navigation] replace('${name}'): route is not registered.`);
-        }
-        preloadRouteComponent(routes[name].component);
-        const entry = makeEntry(name, params, search, options, routes);
-        const cur = getStack();
-        // Replace doesn't animate in v1 — it's a swap, not a forward/back nav.
-        // Adding a fade-or-slide variant is a screen-option in Phase 0.5.
-        setStack([...cur.slice(0, cur.length - 1), entry]);
-    });
-    function pop(count = 1, options) {
-        if (isTransitioning())
-            return;
-        const cur = getStack();
-        const target = Math.max(1, cur.length - Math.max(1, count));
-        if (target === cur.length)
-            return;
-        const animated = options?.animated !== false && !!progress && count === 1 && cur.length >= 2;
-        if (!animated) {
-            setStack(cur.slice(0, target));
-            return;
-        }
-        // Single-step animated pop: keep the popped entry on the stack until
-        // the slide finishes, so `<Stack>` can render both screens during the
-        // animation. The stack mutation happens on completion.
-        const popping = cur[cur.length - 1];
-        const next = cur[cur.length - 2];
-        setTransition({
-            kind: 'pop',
-            topEntry: popping,
-            underneathEntry: next,
-            progress,
-        });
-        animateProgress(1, TRANSITION_DURATION_SEC).then(() => {
-            setStack(cur.slice(0, cur.length - 1));
-            setTransition(null);
-        }, () => {
-            // On animation failure, snap to the destination state anyway —
-            // leaving the popped entry rendered would be more confusing
-            // than skipping the animation.
-            setStack(cur.slice(0, cur.length - 1));
-            setTransition(null);
-        });
-    }
-    function popTo(name) {
-        if (isTransitioning())
-            return;
-        const cur = getStack();
-        for (let i = cur.length - 1; i >= 0; i--) {
-            if (cur[i].route === name) {
-                if (i === cur.length - 1)
-                    return;
-                setStack(cur.slice(0, i + 1));
-                return;
-            }
-        }
-    }
-    function popToRoot() {
-        if (isTransitioning())
-            return;
-        const cur = getStack();
-        if (cur.length <= 1)
-            return;
-        setStack([cur[0]]);
-    }
-    function reset(state) {
-        if (state.stack.length === 0) {
-            throw new Error('[lynx-navigation] reset() called with empty stack.');
-        }
-        setStack([...state.stack]);
-        setTransition(null);
-    }
-    function dismiss() {
-        if (isTransitioning())
-            return;
-        const cur = getStack();
-        let i = cur.length - 1;
-        while (i > 0 && cur[i].presentation !== 'card') {
-            i--;
-        }
-        if (i < cur.length - 1) {
-            setStack(cur.slice(0, i + 1));
-        }
-    }
-    /**
-     * Set up a gesture-driven pop transition. Same shape as `pop()` sets but
-     * does NOT call `animateProgress` — the gesture worklet writes the
-     * progress SV directly per frame, then animates to commit/cancel
-     * endpoints on release before invoking `commitBackGesture` or
-     * `cancelBackGesture` via `runOnBackground`.
-     */
-    function beginBackGesture() {
-        if (isTransitioning())
-            return;
-        const cur = getStack();
-        if (cur.length < 2)
-            return;
-        const popping = cur[cur.length - 1];
-        const next = cur[cur.length - 2];
-        setTransition({
-            kind: 'pop',
-            topEntry: popping,
-            underneathEntry: next,
-            progress: progress,
-        });
-    }
-    function commitBackGesture() {
-        const cur = getStack();
-        if (cur.length >= 2) {
-            setStack(cur.slice(0, cur.length - 1));
-        }
-        setTransition(null);
-    }
-    function cancelBackGesture() {
-        setTransition(null);
-    }
-    const nav = {
-        push,
-        replace,
-        pop,
-        popTo,
-        popToRoot,
-        reset,
-        dismiss,
-        get current() {
-            return stackSignal[stackSignal.length - 1];
-        },
-        get stack() {
-            return stackSignal;
-        },
-        get canGoBack() {
-            return stackSignal.length > 1;
-        },
-        get parent() {
-            return parent;
-        },
-        get isLocallyFocused() {
-            return focusedBox.value;
-        },
-        get _children() {
-            return children;
-        },
-        get transition() {
-            return transitionBox.value;
-        },
-    };
-    if (parent) {
-        // Register with parent so root-level traversals (hardware back,
-        // future deepest-focused queries) can reach this nav. The matching
-        // `_children.delete(nav)` happens when the owning `<Stack>` unmounts;
-        // see Stack.tsx.
-        parent._children.add(nav);
-    }
-    function setLocallyFocused(focused) {
-        if (focusedBox.value === focused)
-            return;
-        focusedBox.value = focused;
-    }
-    return {
-        nav,
-        routes,
-        _gesture: { beginBackGesture, commitBackGesture, cancelBackGesture },
-        _screens: createScreenRegistries(),
-        _setLocallyFocused: setLocallyFocused,
-    };
-}
-/**
- * Map-backed `_screens` controller. Pulled out as a tiny factory so test
- * tooling can call it directly when asserting registry behaviour without
- * standing up an entire navigator.
- *
- * Not reactive — `<EntryScope>` registers once at setup and unregisters at
- * unmount, so reads from the navigator's chrome are point-in-time lookups,
- * and the registry's own internal signals carry the reactive payload.
- */
-function createScreenRegistries() {
-    const byKey = new Map();
-    // Reactive version tick — bumped on every register/unregister so consumers
-    // (HeaderBar's computeds) re-evaluate their lookups when entries come and
-    // go. `Map.get` itself isn't tracked, so without this a chrome component
-    // that renders before its target entry mounts would never see the late
-    // arrival of the registry.
-    const version = signal({ v: 0 });
-    return {
-        register(reg) {
-            byKey.set(reg.entry.key, reg);
-            // `register` is called from `<EntryScope>` setup, which itself
-            // runs inside a tracked scope. Read-then-write on `version`
-            // would self-loop, so we untrack the bump.
-            untrack(() => { version.v = version.v + 1; });
-        },
-        unregister(key) {
-            byKey.delete(key);
-            untrack(() => { version.v = version.v + 1; });
-        },
-        get(key) {
-            // Touch the version signal so the caller's reactive scope
-            // re-runs on the next register/unregister. The actual returned
-            // value still comes from the plain Map — registries themselves
-            // are signal-backed, so once a caller has one in hand they
-            // track the bits they care about (options/slots) directly.
-            void version.v;
-            return byKey.get(key);
-        },
-    };
-}
-//# sourceMappingURL=core.js.map

package/dist/navigator/core.js.map

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

package/dist/register.js

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

package/dist/register.js.map

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

package/dist/types.js

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

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

package/dist/url/build.js

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

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

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

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

package/dist/url/format.js

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

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