@geometra/router 1.0.1

package/README.md

@@ -0,0 +1,47 @@
+# @geometra/router
+
+Routing primitives for Geometra.
+
+Current scope (foundation): route matching and nested branch composition utilities.
+
+## Install
+
+```bash
+npm install @geometra/router
+```
+
+## Key Exports
+
+- `matchPath` -- matches path patterns with static, dynamic, optional, and splat segments
+- `buildPath` -- reverse routing helper with typed params
+- `parseQuery` / `stringifyQuery` -- query parse/stringify helpers with deterministic key ordering
+- `createMemoryHistory` -- history adapter for non-browser runtimes and tests
+- `createBrowserHistory` -- browser adapter using pushState/replaceState/popstate
+- `createRouter` -- router lifecycle (`start`, `navigate`, `subscribe`, `dispose`)
+- route `loader` support -- params/query/requestContext-aware data loading for matched routes
+- `state.loaderData` -- per-route loader results keyed by route `id`
+- route `action` support -- write/mutation handlers with submission payloads
+- `router.submitAction(routeId, submission)` + `state.actionData` -- mutation workflow primitives
+- `submitAction(..., { optimistic })` -- optimistic mutation hooks with rollback on failure
+- automatic loader revalidation after actions + explicit `router.revalidate()` support
+- `redirect()` / `response()` / `json()` -- loader/action helpers for redirects and structured results
+- loader/action contexts include `signal` for AbortController-driven cancellation
+- router state exposes `pending` / `submitting` / `loading` flags for transition-aware UI
+- router state exposes structured `error` payloads for loader/action/navigation failures
+- `router.isActive(to)` / `router.isPending(to)` -- route state helpers for active and transition states
+- `router.addBlocker(fn)` -- guards transitions for unsaved-state and confirmation flows
+- `restoration` policy + per-navigation options -- scroll/focus restoration control on transitions
+- `link` -- declarative link element with click + keyboard activation semantics
+- `scorePathPattern` -- computes route specificity score for deterministic ranking
+- `comparePatternSpecificity` -- compares two patterns by ranking
+- `matchRouteTree` -- matches nested route trees with layout routes
+- `renderMatchedOutlet` -- composes matched branch render output from leaf to root
+
+## Usage
+
+```ts
+import { matchPath } from '@geometra/router'
+
+const match = matchPath('/users/:id?', '/users/42')
+// { params: { id: '42' } }
+```

package/dist/history.d.ts

@@ -0,0 +1,28 @@
+export type RouterLocation = {
+    pathname: string;
+    search: string;
+    hash: string;
+};
+export type HistoryUpdate = {
+    location: RouterLocation;
+    action: 'push' | 'replace' | 'pop';
+};
+export type Unsubscribe = () => void;
+export interface HistoryAdapter {
+    readonly location: RouterLocation;
+    push(to: string): void;
+    replace(to: string): void;
+    go(delta: number): void;
+    listen(listener: (update: HistoryUpdate) => void): Unsubscribe;
+}
+export type BrowserHistoryOptions = {
+    window?: Pick<Window, 'location' | 'history' | 'addEventListener' | 'removeEventListener'>;
+};
+type MemoryHistoryOptions = {
+    initialEntries?: string[];
+    initialIndex?: number;
+};
+export declare function createMemoryHistory(options?: MemoryHistoryOptions): HistoryAdapter;
+export declare function createBrowserHistory(options?: BrowserHistoryOptions): HistoryAdapter;
+export {};
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,cAAc,CAAA;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAA;AAEpC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,WAAW,CAAA;CAC/D;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,kBAAkB,GAAG,qBAAqB,CAAC,CAAA;CAC3F,CAAA;AAmBD,KAAK,oBAAoB,GAAG;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,cAAc,CA6CtF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAsDxF"}

package/dist/history.js

@@ -0,0 +1,111 @@
+function parseToLocation(to) {
+    const url = new URL(to, 'https://geometra.local');
+    return {
+        pathname: url.pathname || '/',
+        search: url.search,
+        hash: url.hash,
+    };
+}
+function locationFromWindow(windowLike) {
+    return {
+        pathname: windowLike.location.pathname || '/',
+        search: windowLike.location.search || '',
+        hash: windowLike.location.hash || '',
+    };
+}
+export function createMemoryHistory(options = {}) {
+    const entries = (options.initialEntries ?? ['/']).map(parseToLocation);
+    let index = Math.min(Math.max(options.initialIndex ?? entries.length - 1, 0), Math.max(entries.length - 1, 0));
+    if (entries.length === 0) {
+        entries.push(parseToLocation('/'));
+        index = 0;
+    }
+    const listeners = new Set();
+    const notify = (action) => {
+        const location = entries[index];
+        if (!location)
+            return;
+        const update = { location, action };
+        for (const listener of listeners)
+            listener(update);
+    };
+    return {
+        get location() {
+            return entries[index] ?? parseToLocation('/');
+        },
+        push(to) {
+            const next = parseToLocation(to);
+            entries.splice(index + 1);
+            entries.push(next);
+            index = entries.length - 1;
+            notify('push');
+        },
+        replace(to) {
+            entries[index] = parseToLocation(to);
+            notify('replace');
+        },
+        go(delta) {
+            const nextIndex = Math.max(0, Math.min(index + delta, entries.length - 1));
+            if (nextIndex === index)
+                return;
+            index = nextIndex;
+            notify('pop');
+        },
+        listen(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+export function createBrowserHistory(options = {}) {
+    const windowLike = options.window ??
+        (typeof window !== 'undefined'
+            ? window
+            : null);
+    if (!windowLike) {
+        throw new Error('createBrowserHistory requires a browser window');
+    }
+    const listeners = new Set();
+    const notify = (action) => {
+        const update = {
+            location: locationFromWindow(windowLike),
+            action,
+        };
+        for (const listener of listeners)
+            listener(update);
+    };
+    const onPopState = () => notify('pop');
+    return {
+        get location() {
+            return locationFromWindow(windowLike);
+        },
+        push(to) {
+            const next = parseToLocation(to);
+            const href = `${next.pathname}${next.search}${next.hash}`;
+            windowLike.history.pushState(null, '', href);
+            notify('push');
+        },
+        replace(to) {
+            const next = parseToLocation(to);
+            const href = `${next.pathname}${next.search}${next.hash}`;
+            windowLike.history.replaceState(null, '', href);
+            notify('replace');
+        },
+        go(delta) {
+            windowLike.history.go(delta);
+        },
+        listen(listener) {
+            if (listeners.size === 0) {
+                windowLike.addEventListener('popstate', onPopState);
+            }
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+                if (listeners.size === 0) {
+                    windowLike.removeEventListener('popstate', onPopState);
+                }
+            };
+        },
+    };
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { matchPath } from './matcher.js';
+export type { RouteMatch } from './matcher.js';
+export { buildPath } from './path.js';
+export type { PathParams } from './path.js';
+export { parseQuery, stringifyQuery } from './query.js';
+export type { QueryInput, QueryValue, ParsedQuery } from './query.js';
+export { createMemoryHistory } from './history.js';
+export { createBrowserHistory } from './history.js';
+export type { RouterLocation, HistoryUpdate, HistoryAdapter, BrowserHistoryOptions } from './history.js';
+export { link } from './link.js';
+export type { LinkProps } from './link.js';
+export { redirect, response, json } from './responses.js';
+export type { RedirectResult, ResponseResult } from './responses.js';
+export { scorePathPattern, comparePatternSpecificity } from './ranking.js';
+export { createRouter } from './router.js';
+export type { Router, RouterState, RouterSubscriber, RouterNavigationState, CreateRouterOptions, NavigationOptions, NavigationBlocker, RouterRestorationPolicy, NavigationRestorationContext, OptimisticMutation, SubmitActionOptions, RouterErrorPayload, RouterErrorPhase, } from './router.js';
+export { matchRouteTree, renderMatchedOutlet } from './tree.js';
+export type { RouteNode, RouteBranchMatch } from './tree.js';
+export type { RouteLoaderContext, RouteActionContext, RouteActionSubmission } from './tree.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AACvD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACxG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACzD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EACV,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/D,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { matchPath } from './matcher.js';
+export { buildPath } from './path.js';
+export { parseQuery, stringifyQuery } from './query.js';
+export { createMemoryHistory } from './history.js';
+export { createBrowserHistory } from './history.js';
+export { link } from './link.js';
+export { redirect, response, json } from './responses.js';
+export { scorePathPattern, comparePatternSpecificity } from './ranking.js';
+export { createRouter } from './router.js';
+export { matchRouteTree, renderMatchedOutlet } from './tree.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAgB1C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA"}

package/dist/link.d.ts

@@ -0,0 +1,14 @@
+import { type BoxElement, type HitEvent, type KeyboardHitEvent, type SemanticProps, type StyleProps, type UIElement } from '@geometra/core';
+import type { FlexProps } from 'textura';
+import type { Router } from './router.js';
+export type LinkProps = FlexProps & StyleProps & {
+    to: string;
+    router: Pick<Router, 'navigate'>;
+    replace?: boolean;
+    key?: string;
+    semantic?: SemanticProps;
+    onClick?: (event: HitEvent) => void;
+    onKeyDown?: (event: KeyboardHitEvent) => void;
+};
+export declare function link(props: LinkProps, children?: UIElement[]): BoxElement;
+//# sourceMappingURL=link.d.ts.map

package/dist/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAChJ,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,SAAS,GAAG,SAAS,GAC/B,UAAU,GAAG;IACX,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAC9C,CAAA;AAMH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,GAAE,SAAS,EAAO,GAAG,UAAU,CAoC7E"}

package/dist/link.js

@@ -0,0 +1,28 @@
+import { box } from '@geometra/core';
+function isActivationKey(key) {
+    return key === 'Enter' || key === ' ' || key === 'Spacebar';
+}
+export function link(props, children = []) {
+    const { to, router, replace, key, semantic, onClick, onKeyDown, cursor, ...styleAndLayout } = props;
+    return box({
+        ...styleAndLayout,
+        cursor: cursor ?? 'pointer',
+        key,
+        semantic: {
+            ...semantic,
+            tag: semantic?.tag ?? 'a',
+            role: semantic?.role ?? 'link',
+        },
+        onClick: (event) => {
+            onClick?.(event);
+            router.navigate(to, { replace });
+        },
+        onKeyDown: (event) => {
+            onKeyDown?.(event);
+            if (isActivationKey(event.key)) {
+                router.navigate(to, { replace });
+            }
+        },
+    }, children);
+}
+//# sourceMappingURL=link.js.map

package/dist/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAA8G,MAAM,gBAAgB,CAAA;AAehJ,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,UAAU,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAgB,EAAE,WAAwB,EAAE;IAC/D,MAAM,EACJ,EAAE,EACF,MAAM,EACN,OAAO,EACP,GAAG,EACH,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,EACN,GAAG,cAAc,EAClB,GAAG,KAAK,CAAA;IAET,OAAO,GAAG,CACR;QACE,GAAG,cAAc;QACjB,MAAM,EAAE,MAAM,IAAI,SAAS;QAC3B,GAAG;QACH,QAAQ,EAAE;YACR,GAAG,QAAQ;YACX,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG;YACzB,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,MAAM;SAC/B;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;YAChB,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;QAClC,CAAC;QACD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACnB,SAAS,EAAE,CAAC,KAAK,CAAC,CAAA;YAClB,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;YAClC,CAAC;QACH,CAAC;KACF,EACD,QAAQ,CACT,CAAA;AACH,CAAC"}

package/dist/matcher.d.ts

@@ -0,0 +1,5 @@
+export type RouteMatch = {
+    params: Record<string, string>;
+};
+export declare function matchPath(pattern: string, pathname: string): RouteMatch | null;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B,CAAA;AA6GD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAS9E"}

package/dist/matcher.js

@@ -0,0 +1,96 @@
+function normalizePath(path, stripSearchHash) {
+    if (path === '')
+        return '/';
+    const pathnameOnly = stripSearchHash ? (path.split(/[?#]/, 1)[0] ?? '') : path;
+    const withLeading = pathnameOnly.startsWith('/') ? pathnameOnly : `/${pathnameOnly}`;
+    if (withLeading.length > 1 && withLeading.endsWith('/')) {
+        return withLeading.replace(/\/+$/, '');
+    }
+    return withLeading;
+}
+function trimSlashes(value) {
+    return value.replace(/^\/+|\/+$/g, '');
+}
+function parseSegments(pattern) {
+    const normalized = normalizePath(pattern, false);
+    const trimmed = trimSlashes(normalized);
+    if (trimmed === '')
+        return [];
+    const parts = trimmed.split('/');
+    return parts.map((part) => {
+        if (part.startsWith('*')) {
+            return { kind: 'splat', name: part.slice(1) || '*' };
+        }
+        const optional = part.endsWith('?');
+        const raw = optional ? part.slice(0, -1) : part;
+        if (raw.startsWith(':')) {
+            return { kind: 'param', name: raw.slice(1), optional };
+        }
+        return { kind: 'static', value: raw, optional };
+    });
+}
+function decodeSegment(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+function matchRecursive(segments, pathnameSegments, segmentIndex, pathIndex, params) {
+    if (segmentIndex >= segments.length) {
+        return pathIndex === pathnameSegments.length ? params : null;
+    }
+    const segment = segments[segmentIndex];
+    if (!segment)
+        return null;
+    switch (segment.kind) {
+        case 'splat': {
+            const rest = pathnameSegments.slice(pathIndex).map(decodeSegment).join('/');
+            return { ...params, [segment.name]: rest };
+        }
+        case 'static': {
+            const current = pathnameSegments[pathIndex];
+            if (current == null) {
+                if (segment.optional) {
+                    return matchRecursive(segments, pathnameSegments, segmentIndex + 1, pathIndex, params);
+                }
+                return null;
+            }
+            if (current === segment.value) {
+                return matchRecursive(segments, pathnameSegments, segmentIndex + 1, pathIndex + 1, params);
+            }
+            if (segment.optional) {
+                return matchRecursive(segments, pathnameSegments, segmentIndex + 1, pathIndex, params);
+            }
+            return null;
+        }
+        case 'param': {
+            const current = pathnameSegments[pathIndex];
+            if (current == null) {
+                if (segment.optional) {
+                    return matchRecursive(segments, pathnameSegments, segmentIndex + 1, pathIndex, params);
+                }
+                return null;
+            }
+            const withValue = matchRecursive(segments, pathnameSegments, segmentIndex + 1, pathIndex + 1, { ...params, [segment.name]: decodeSegment(current) });
+            if (withValue)
+                return withValue;
+            if (segment.optional) {
+                return matchRecursive(segments, pathnameSegments, segmentIndex + 1, pathIndex, params);
+            }
+            return null;
+        }
+    }
+}
+export function matchPath(pattern, pathname) {
+    const segments = parseSegments(pattern);
+    const normalizedPath = normalizePath(pathname, true);
+    const trimmedPath = trimSlashes(normalizedPath);
+    const pathSegments = trimmedPath === '' ? [] : trimmedPath.split('/');
+    const params = matchRecursive(segments, pathSegments, 0, 0, {});
+    if (!params)
+        return null;
+    return { params };
+}
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

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

package/dist/path.d.ts

@@ -0,0 +1,22 @@
+type SegmentParamKeys<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? SegmentParamKeys<Head> | SegmentParamKeys<Tail> : Path extends `:${infer Param}?` ? Param : Path extends `:${infer Param}` ? Param : Path extends `*${infer Param}` ? (Param extends '' ? '*' : Param) : never;
+type SegmentRequiredParamKeys<Path extends string> = Path extends `${infer Head}/${infer Tail}` ? SegmentRequiredParamKeys<Head> | SegmentRequiredParamKeys<Tail> : Path extends `:${infer Param}` ? (Param extends `${string}?` ? never : Param) : Path extends `*${infer Param}` ? (Param extends '' ? '*' : Param) : never;
+type SegmentOptionalParamKeys<Path extends string> = Exclude<SegmentParamKeys<Path>, SegmentRequiredParamKeys<Path>>;
+/**
+ * Path parameters inferred from a pattern string (static segments, `:param`, optional `:param?`,
+ * and splat `*name` or anonymous `*`). Use with {@link buildPath}.
+ */
+export type PathParams<Path extends string> = {
+    [K in SegmentRequiredParamKeys<Path>]: string | number;
+} & {
+    [K in SegmentOptionalParamKeys<Path>]?: string | number;
+};
+/**
+ * Build a pathname from a route pattern and {@link PathParams}. Static segments are copied as-is;
+ * dynamic `:id` and optional `:id?` are filled from `params`; splat `*rest` (or a lone `*`, key `'*'`)
+ * inserts the remainder with internal slashes preserved. For optional segments, `null`, `undefined`,
+ * or empty string omits the segment (same as leaving the key unset). Required dynamic and splat
+ * params throw when missing or empty. Leading and trailing slashes on `pattern` are trimmed before building.
+ */
+export declare function buildPath<Path extends string>(pattern: Path, params: PathParams<Path>): string;
+export {};
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,CAAC,IAAI,SAAS,MAAM,IACvC,IAAI,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GACtC,gBAAgB,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAC/C,IAAI,SAAS,IAAI,MAAM,KAAK,GAAG,GAC7B,KAAK,GACL,IAAI,SAAS,IAAI,MAAM,KAAK,EAAE,GAC5B,KAAK,GACL,IAAI,SAAS,IAAI,MAAM,KAAK,EAAE,GAC5B,CAAC,KAAK,SAAS,EAAE,GAAG,GAAG,GAAG,KAAK,CAAC,GAChC,KAAK,CAAA;AAEjB,KAAK,wBAAwB,CAAC,IAAI,SAAS,MAAM,IAC/C,IAAI,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GACtC,wBAAwB,CAAC,IAAI,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAC/D,IAAI,SAAS,IAAI,MAAM,KAAK,EAAE,GAC5B,CAAC,KAAK,SAAS,GAAG,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,GAC5C,IAAI,SAAS,IAAI,MAAM,KAAK,EAAE,GAC5B,CAAC,KAAK,SAAS,EAAE,GAAG,GAAG,GAAG,KAAK,CAAC,GAChC,KAAK,CAAA;AAEf,KAAK,wBAAwB,CAAC,IAAI,SAAS,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAA;AAEpH;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,IAAI,SAAS,MAAM,IAAI;KAC3C,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM;CACvD,GAAG;KACD,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CACxD,CAAA;AAUD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAkC9F"}

package/dist/path.js

@@ -0,0 +1,46 @@
+function trimSlashes(value) {
+    return value.replace(/^\/+|\/+$/g, '');
+}
+function stringifyParam(value) {
+    return encodeURIComponent(String(value));
+}
+/**
+ * Build a pathname from a route pattern and {@link PathParams}. Static segments are copied as-is;
+ * dynamic `:id` and optional `:id?` are filled from `params`; splat `*rest` (or a lone `*`, key `'*'`)
+ * inserts the remainder with internal slashes preserved. For optional segments, `null`, `undefined`,
+ * or empty string omits the segment (same as leaving the key unset). Required dynamic and splat
+ * params throw when missing or empty. Leading and trailing slashes on `pattern` are trimmed before building.
+ */
+export function buildPath(pattern, params) {
+    const trimmed = trimSlashes(pattern);
+    if (trimmed === '')
+        return '/';
+    const parts = trimmed.split('/');
+    const out = [];
+    for (const part of parts) {
+        if (part.startsWith('*')) {
+            const key = part.slice(1) || '*';
+            const value = params[key];
+            if (value == null || value === '') {
+                throw new Error(`Missing required splat param: ${key}`);
+            }
+            out.push(trimSlashes(String(value)));
+            continue;
+        }
+        if (part.startsWith(':')) {
+            const optional = part.endsWith('?');
+            const key = optional ? part.slice(1, -1) : part.slice(1);
+            const value = params[key];
+            if (value == null || value === '') {
+                if (optional)
+                    continue;
+                throw new Error(`Missing required path param: ${key}`);
+            }
+            out.push(stringifyParam(value));
+            continue;
+        }
+        out.push(part.endsWith('?') ? part.slice(0, -1) : part);
+    }
+    return `/${out.join('/')}`;
+}
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAgCA,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,cAAc,CAAC,KAAsB;IAC5C,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAsB,OAAa,EAAE,MAAwB;IACpF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IACpC,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,GAAG,CAAA;IAE9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChC,MAAM,GAAG,GAAa,EAAE,CAAA;IAExB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;YAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAA6B,CAAC,CAAA;YACnD,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAA;YACzD,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACpC,SAAQ;QACV,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,GAA6B,CAAC,CAAA;YACnD,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBAClC,IAAI,QAAQ;oBAAE,SAAQ;gBACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAA;YACxD,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;YAC/B,SAAQ;QACV,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;AAC5B,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,23 @@
+export type QueryValue = string | number | boolean | null | undefined;
+export type QueryInput = Record<string, QueryValue | QueryValue[]>;
+/**
+ * Result of {@link parseQuery}: each key maps to one value or, when repeated in the input,
+ * an array of values (order preserved). Instances use a null prototype so query keys such as
+ * `__proto__` are stored as ordinary string keys and cannot mutate `Object.prototype`.
+ */
+export type ParsedQuery = Record<string, string | string[]>;
+/**
+ * Parse a URL query string (optional leading `?`). Keys and values are percent-decoded;
+ * `+` in values is treated as space. Duplicate keys collapse to `string[]` in encounter order.
+ * If decoding a segment throws, that segment is left as the raw string (see malformed `%` escapes).
+ * The returned object has a null prototype (see {@link ParsedQuery}).
+ */
+export declare function parseQuery(search: string): ParsedQuery;
+/**
+ * Serialize a shallow query object to `?a=1&b=2`. Keys are sorted lexicographically for stable output.
+ * Skips `null` and `undefined`; array values become repeated keys. Booleans become `"true"` / `"false"`.
+ * Skips non-finite numbers (`NaN`, `±Infinity`) so accidental numeric garbage does not produce query pairs.
+ * Returns `""` when there are no pairs to emit.
+ */
+export declare function stringifyQuery(query: QueryInput): string;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;AACrE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC,CAAA;AAClE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;AAc3D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAqBtD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAkBxD"}

package/dist/query.js

@@ -0,0 +1,68 @@
+function decode(value) {
+    try {
+        return decodeURIComponent(value.replace(/\+/g, ' '));
+    }
+    catch {
+        return value;
+    }
+}
+function encode(value) {
+    return encodeURIComponent(value);
+}
+/**
+ * Parse a URL query string (optional leading `?`). Keys and values are percent-decoded;
+ * `+` in values is treated as space. Duplicate keys collapse to `string[]` in encounter order.
+ * If decoding a segment throws, that segment is left as the raw string (see malformed `%` escapes).
+ * The returned object has a null prototype (see {@link ParsedQuery}).
+ */
+export function parseQuery(search) {
+    const input = search.startsWith('?') ? search.slice(1) : search;
+    if (input === '')
+        return Object.create(null);
+    const result = Object.create(null);
+    for (const pair of input.split('&')) {
+        if (pair === '')
+            continue;
+        const [rawKey, ...rest] = pair.split('=');
+        const key = decode(rawKey ?? '');
+        const value = decode(rest.join('='));
+        const current = result[key];
+        if (current == null) {
+            result[key] = value;
+        }
+        else if (Array.isArray(current)) {
+            current.push(value);
+        }
+        else {
+            result[key] = [current, value];
+        }
+    }
+    return result;
+}
+/**
+ * Serialize a shallow query object to `?a=1&b=2`. Keys are sorted lexicographically for stable output.
+ * Skips `null` and `undefined`; array values become repeated keys. Booleans become `"true"` / `"false"`.
+ * Skips non-finite numbers (`NaN`, `±Infinity`) so accidental numeric garbage does not produce query pairs.
+ * Returns `""` when there are no pairs to emit.
+ */
+export function stringifyQuery(query) {
+    const keys = Object.keys(query).sort((a, b) => a.localeCompare(b));
+    const pairs = [];
+    for (const key of keys) {
+        const raw = query[key];
+        if (raw == null)
+            continue;
+        const values = Array.isArray(raw) ? raw : [raw];
+        for (const value of values) {
+            if (value == null)
+                continue;
+            if (typeof value === 'number' && !Number.isFinite(value))
+                continue;
+            pairs.push(`${encode(key)}=${encode(String(value))}`);
+        }
+    }
+    if (pairs.length === 0)
+        return '';
+    return `?${pairs.join('&')}`;
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

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

package/dist/ranking.d.ts

@@ -0,0 +1,3 @@
+export declare function scorePathPattern(pattern: string): number;
+export declare function comparePatternSpecificity(a: string, b: string): number;
+//# sourceMappingURL=ranking.d.ts.map

package/dist/ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../src/ranking.ts"],"names":[],"mappings":"AAuCA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAUtE"}