@weave-framework/router 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aidas Josas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/files.d.ts

@@ -0,0 +1,38 @@
+/**
+ * File-based routing — turn a directory of page files into a `Route[]` tree
+ * (the Next/Nuxt/SvelteKit convention). Pure + zero-dep so it is fully testable:
+ * {@link fileToRoutes} maps a list of file specifiers to a manifest, and
+ * {@link emitRoutesModule} serialises that manifest into an importable module.
+ * The CLI supplies the actual directory scan; everything here is string work.
+ *
+ * Convention (per directory level):
+ *  - `index.*`        → the index route (`path: ''`)
+ *  - `about.*`        → `path: 'about'`
+ *  - `[id].*`         → `path: ':id'` (dynamic segment)
+ *  - `[...rest].*`    → `path: '*'` (catch-all; honoured at the top level)
+ *  - `_layout.*`      → the folder's layout component; its folder becomes a nested
+ *                       route whose `children` are that folder's routes
+ *  - a folder WITHOUT a `_layout` is flattened: its routes get the folder name
+ *    prefixed onto their paths (no wrapper route)
+ */
+/** A route in the generated manifest. `file` is the page's source specifier. */
+export interface FileRoute {
+    path: string;
+    /** Page/layout source specifier (the emitter turns this into a component import). */
+    file?: string;
+    children?: FileRoute[];
+}
+/** Map a flat list of page-file specifiers to a nested {@link FileRoute} manifest. */
+export declare function fileToRoutes(files: string[]): FileRoute[];
+/** Options for {@link emitRoutesModule}. */
+export interface EmitRoutesOptions {
+    /** Code-split every page via `lazy(() => import(...))` instead of a static import. */
+    lazy?: boolean;
+    /** Where `lazy` is imported from (default `@weave-framework/runtime/dom`). */
+    runtimeImport?: string;
+    /** Prefix prepended to each `file` to form the import specifier (default `./`). */
+    importPrefix?: string;
+}
+/** Serialise a manifest into an importable ES module exporting `const routes: Route[]`. */
+export declare function emitRoutesModule(routes: FileRoute[], opts?: EmitRoutesOptions): string;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB;AAoFD,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAYzD;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAqC1F"}

package/dist/files.js

@@ -0,0 +1,145 @@
+/**
+ * File-based routing — turn a directory of page files into a `Route[]` tree
+ * (the Next/Nuxt/SvelteKit convention). Pure + zero-dep so it is fully testable:
+ * {@link fileToRoutes} maps a list of file specifiers to a manifest, and
+ * {@link emitRoutesModule} serialises that manifest into an importable module.
+ * The CLI supplies the actual directory scan; everything here is string work.
+ *
+ * Convention (per directory level):
+ *  - `index.*`        → the index route (`path: ''`)
+ *  - `about.*`        → `path: 'about'`
+ *  - `[id].*`         → `path: ':id'` (dynamic segment)
+ *  - `[...rest].*`    → `path: '*'` (catch-all; honoured at the top level)
+ *  - `_layout.*`      → the folder's layout component; its folder becomes a nested
+ *                       route whose `children` are that folder's routes
+ *  - a folder WITHOUT a `_layout` is flattened: its routes get the folder name
+ *    prefixed onto their paths (no wrapper route)
+ */
+const EXT = /\.(weave|tsx?|jsx?)$/;
+const baseName = (file) => {
+    const slash = file.lastIndexOf('/');
+    return file.slice(slash + 1).replace(EXT, '');
+};
+/** Filename (no extension) → a route path segment. */
+function segment(name) {
+    if (name === 'index')
+        return '';
+    const catchAll = /^\[\.\.\.(.+)]$/.exec(name);
+    if (catchAll)
+        return '*';
+    const dynamic = /^\[(.+)]$/.exec(name);
+    if (dynamic)
+        return `:${dynamic[1]}`;
+    return name;
+}
+const emptyTree = () => ({ files: {}, dirs: {} });
+/** Per-segment specificity: a static segment (0) wins over `:param` (1) over `*` (2). */
+function segSpecificity(seg) {
+    if (seg === '*' || seg.startsWith('*'))
+        return 2;
+    if (seg.startsWith(':'))
+        return 1;
+    return 0;
+}
+/**
+ * Compare two route paths so the more specific one sorts first — segment by segment,
+ * static before dynamic before catch-all. This must be segment-aware (not first-char)
+ * because routes are flattened into one list with full multi-segment paths: e.g.
+ * `reference/config` must precede `reference/:pkg` even though ':' < 'c' lexically.
+ */
+function compareRoutes(a, b) {
+    const as = a.split('/');
+    const bs = b.split('/');
+    const len = Math.max(as.length, bs.length);
+    for (let i = 0; i < len; i++) {
+        const sa = as[i] ?? '';
+        const sb = bs[i] ?? '';
+        const da = segSpecificity(sa);
+        const db = segSpecificity(sb);
+        if (da !== db)
+            return da - db; // more static segment wins at the first divergence
+        if (sa !== sb)
+            return sa.localeCompare(sb);
+    }
+    return 0;
+}
+function joinPath(dir, child) {
+    return child === '' ? dir : `${dir}/${child}`;
+}
+function convert(tree) {
+    const routes = [];
+    for (const [name, file] of Object.entries(tree.files)) {
+        if (name === '_layout')
+            continue; // a layout is consumed by its folder, not a route here
+        routes.push({ path: segment(name), file });
+    }
+    for (const [dir, sub] of Object.entries(tree.dirs)) {
+        const childRoutes = convert(sub);
+        const layout = sub.files['_layout'];
+        if (layout) {
+            routes.push({ path: dir, file: layout, children: sortRoutes(childRoutes) });
+        }
+        else {
+            // no layout → flatten, prefixing the folder name onto each child path
+            for (const r of childRoutes)
+                routes.push({ ...r, path: joinPath(dir, r.path) });
+        }
+    }
+    return sortRoutes(routes);
+}
+function sortRoutes(routes) {
+    return routes.sort((a, b) => compareRoutes(a.path, b.path));
+}
+/** Map a flat list of page-file specifiers to a nested {@link FileRoute} manifest. */
+export function fileToRoutes(files) {
+    const root = emptyTree();
+    for (const file of files) {
+        const parts = file.split('/');
+        let node = root;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const dir = parts[i];
+            node = node.dirs[dir] ??= emptyTree();
+        }
+        node.files[baseName(parts[parts.length - 1])] = file;
+    }
+    return convert(root);
+}
+/** Serialise a manifest into an importable ES module exporting `const routes: Route[]`. */
+export function emitRoutesModule(routes, opts = {}) {
+    const imports = [];
+    let n = 0;
+    const prefix = opts.importPrefix ?? './';
+    const spec = (file) => {
+        const withPrefix = /^[./]/.test(file) ? file : prefix + file;
+        // Drop a TS/JS extension so the import resolves under both esbuild and `tsc`
+        // (importing a literal `.ts` errors without `allowImportingTsExtensions`).
+        // Keep `.weave` — the SFC loader needs the explicit extension to resolve.
+        return JSON.stringify(withPrefix.replace(/\.[mc]?[jt]sx?$/, ''));
+    };
+    const componentField = (file) => {
+        if (opts.lazy)
+            return `component: lazy(() => import(${spec(file)}))`;
+        const id = `Page${n++}`;
+        imports.push(`import ${id} from ${spec(file)};`);
+        return `component: ${id}`;
+    };
+    const serialize = (list, indent) => {
+        const inner = indent + '  ';
+        const items = list.map((r) => {
+            const fields = [`path: ${JSON.stringify(r.path)}`];
+            if (r.file)
+                fields.push(componentField(r.file));
+            if (r.children && r.children.length) {
+                fields.push(`children: ${serialize(r.children, inner)}`);
+            }
+            return `${inner}{ ${fields.join(', ')} }`;
+        });
+        return `[\n${items.join(',\n')}\n${indent}]`;
+    };
+    const body = serialize(routes, '');
+    const header = opts.lazy
+        ? `import { lazy } from ${JSON.stringify(opts.runtimeImport ?? '@weave-framework/runtime/dom')};\n`
+        : '';
+    return `${header}${imports.join('\n')}${imports.length ? '\n' : ''}\nexport const routes = ${body};\n`;
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @weave-framework/router — the official client router. Built in, not a third-party bolt-on.
+ * Zero third-party dependencies (only `@weave-framework/runtime`).
+ *
+ * History-based and signal-driven: the current path and query are signals, so any
+ * view that reads them updates surgically on navigation. Routes are an ordered tree
+ * of `{ path, component?, guard?, redirect?, children? }` objects (`'*'` = catch-all
+ * fallback), supporting path params (`/user/:id`), query parsing (`?tab=x`), **sync
+ * guards** (read auth signals; return `true`/`false`/a redirect path), static
+ * `redirect`s, and **nested routes** (a parent layout renders a nested `<RouterView>`).
+ *
+ * Matching produces a *chain* of matches (layout → … → leaf). The top `<RouterView>`
+ * renders the chain's first component; each nested `<RouterView>` renders the next,
+ * discovering its depth + the router through **provide/inject** (no prop drilling).
+ *
+ * Guards are synchronous by design: they run inside the reactive resolution and read
+ * signals (e.g. `isAuthed()`), so a route re-resolves automatically when auth changes.
+ * Async data loading belongs in the component via `@weave-framework/data`.
+ */
+import { type Component } from '@weave-framework/runtime/dom';
+export type RouteParams = Record<string, string>;
+/** Context handed to a guard: the resolved path, accumulated path params, and query. */
+export interface RouteContext {
+    path: string;
+    params: RouteParams;
+    query: RouteParams;
+}
+/**
+ * A route guard. Runs synchronously during matching and may read signals.
+ * Return `true` to allow, `false` to block (→ fallback), or a path string to redirect.
+ */
+export type Guard = (ctx: RouteContext) => boolean | string;
+/** A single route definition. `path: '*'` is the catch-all (404) fallback. */
+export interface Route {
+    /** Path pattern: `/`, `/users`, `/user/:id`, `''` (index child), or `'*'` (fallback). */
+    path: string;
+    /** Component to render when matched (a layout, if it has `children`). */
+    component?: Component;
+    /** Sync guard: `true` allows, `false` blocks (→ fallback), a string redirects. */
+    guard?: Guard;
+    /** Static redirect target (pathname). When matched, resolve to this path instead. */
+    redirect?: string;
+    /** Nested routes, matched against the path remainder under this route. */
+    children?: Route[];
+}
+/**
+ * Set the base path the app is served under (e.g. `/weave` for a project page at
+ * `user.github.io/weave/`). Call once before the first render. Default is root.
+ */
+export declare function setBasename(base: string): void;
+/** What a navigation was: a `navigate()` push, a back/forward `pop`, or a `replace`. */
+export type NavType = 'push' | 'pop' | 'replace';
+/** Payload handed to every {@link afterEach} hook after a navigation settles. */
+export interface NavInfo {
+    path: string;
+    search: string;
+    hash: string;
+    type: NavType;
+}
+type AfterHook = (nav: NavInfo) => void;
+/**
+ * Register a callback that runs after every navigation (push / pop / replace) —
+ * the place for document-title updates, analytics, focus management, etc. Returns
+ * an unsubscribe function.
+ */
+export declare function afterEach(fn: AfterHook): () => void;
+/** Toggle Weave's built-in scroll handling (top-on-push, `#fragment`, restore-on-pop). */
+export declare function setScrollHandling(on: boolean): void;
+/** The reactive current pathname (read-only). */
+export declare const currentPath: () => string;
+/** The reactive current query params (read-only). */
+export declare const currentQuery: () => RouteParams;
+/** Programmatic navigation (pushes history). Resilient if the env blocks pushState. */
+export declare function navigate(to: string): void;
+/** Go back one history entry (the `popstate` listener syncs the path). */
+export declare function back(): void;
+/** A reactive match: a component + the path params accumulated down to its depth. */
+export interface Match {
+    view: Component;
+    params: RouteParams;
+}
+export interface Router {
+    /** The match at `depth` in the resolved chain (default 0 — the top component), or null. */
+    matched: (depth?: number) => Match | null;
+    /** The full resolved chain (layout → … → leaf). */
+    chain: () => Match[];
+    /** Accumulated path params at `depth` (default: the leaf — i.e. all params). */
+    params: (depth?: number) => RouteParams;
+    /** The current query params (reactive). */
+    query: () => RouteParams;
+    /** Canonical pathname the URL should sync to after a guard/redirect, or null. */
+    redirectTo: () => string | null;
+    /** Warm a path's lazy route chunk(s) ahead of navigation (Link prefetch). */
+    preload: (to: string) => void;
+}
+/**
+ * Build a router from an ordered `Route[]` tree (`path: '*'` = catch-all fallback).
+ * Resolution is a single reactive computation producing a match *chain*; redirect and
+ * guard-redirect hops are followed (capped at 16 to break loops). Place the output with
+ * a top `<RouterView router={r}/>` and a nested `<RouterView/>` inside each layout.
+ */
+export declare function createRouter(routes: Route[], options?: {
+    basename?: string;
+}): Router;
+/** Warm a path's lazy route chunk(s) via the active router (no-op if none / not lazy). */
+export declare function prefetch(to: string): void;
+/**
+ * Router outlet: renders the matched component at its depth in the chain. The top
+ * outlet takes `router` as a prop and renders depth 0; a nested `<RouterView/>` written
+ * inside a layout discovers the router + its depth via context. A `display:contents`
+ * host keeps it layout-neutral. A stable render thunk per component means a param-only
+ * change updates `params` in place instead of remounting; switching routes swaps the
+ * component. The top outlet also syncs the address bar after a guard/redirect.
+ *
+ * Pass `transition` (a `TransitionFn`, e.g. `fade`) to animate route changes: the
+ * entering view is wrapped in a real host element that plays the intro on swap — so
+ * it works even for `lazy()` routes (whose own host is `display:contents`). Author a
+ * page-root `out:` if you also want a leave animation.
+ *
+ * Usage: `<RouterView router={r}/>` at the top, `<RouterView/>` inside each layout.
+ */
+export declare const RouterView: Component;
+/**
+ * Client-side anchor: navigates instead of reloading (plain clicks only — lets
+ * ctrl/cmd/middle-click open a new tab as usual).
+ *
+ * Active state (reactive on the current path): when the link's target matches the
+ * URL it gets `aria-current="page"` automatically, and — if you name one via
+ * `activeClass` — an active CSS class. Matching is prefix-by-segment so a parent
+ * link (`/users`) stays active on a child (`/users/42`); pass `exact` to require an
+ * exact match. A link to `/` is only ever active at exactly `/`.
+ *
+ * Usage in a template: `<Link to="/about" activeClass="active">About</Link>`.
+ */
+export declare const Link: Component;
+export { fileToRoutes, emitRoutesModule, type FileRoute, type EmitRoutesOptions, } from './files.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":"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"}

package/dist/index.js

@@ -0,0 +1,445 @@
+/**
+ * @weave-framework/router — the official client router. Built in, not a third-party bolt-on.
+ * Zero third-party dependencies (only `@weave-framework/runtime`).
+ *
+ * History-based and signal-driven: the current path and query are signals, so any
+ * view that reads them updates surgically on navigation. Routes are an ordered tree
+ * of `{ path, component?, guard?, redirect?, children? }` objects (`'*'` = catch-all
+ * fallback), supporting path params (`/user/:id`), query parsing (`?tab=x`), **sync
+ * guards** (read auth signals; return `true`/`false`/a redirect path), static
+ * `redirect`s, and **nested routes** (a parent layout renders a nested `<RouterView>`).
+ *
+ * Matching produces a *chain* of matches (layout → … → leaf). The top `<RouterView>`
+ * renders the chain's first component; each nested `<RouterView>` renders the next,
+ * discovering its depth + the router through **provide/inject** (no prop drilling).
+ *
+ * Guards are synchronous by design: they run inside the reactive resolution and read
+ * signals (e.g. `isAuthed()`), so a route re-resolves automatically when auth changes.
+ * Async data loading belongs in the component via `@weave-framework/data`.
+ */
+import { signal, computed, effect, batch, getOwner, createContext, provide, inject } from '@weave-framework/runtime';
+import { ifBlock, transition } from '@weave-framework/runtime/dom';
+/* ──────────── base path (for hosting under a sub-path, e.g. GitHub Pages) ──────────── */
+// All public paths (route patterns, navigate(), Link `to`, currentPath()) are
+// "internal" — written as if the app were at the origin root. `basename` is the
+// prefix the app is actually served under (default '' = root). It's stripped when
+// reading location and re-added when writing history, so nothing else changes.
+let basename = '';
+/** Normalize a base: strip a trailing slash; treat '' / '/' as "no base". */
+function normalizeBase(b) {
+    const t = b.replace(/\/+$/, '');
+    return t === '' || t === '/' ? '' : t;
+}
+/** location.pathname → internal path (drop the basename prefix). */
+function stripBase(pathname) {
+    if (basename && (pathname === basename || pathname.startsWith(basename + '/'))) {
+        const rest = pathname.slice(basename.length);
+        return rest === '' ? '/' : rest;
+    }
+    return pathname || '/';
+}
+/** Internal path → external URL path (prepend the basename). */
+function withBase(p) {
+    if (!basename)
+        return p;
+    return basename + (p.startsWith('/') ? p : '/' + p);
+}
+/**
+ * Set the base path the app is served under (e.g. `/weave` for a project page at
+ * `user.github.io/weave/`). Call once before the first render. Default is root.
+ */
+export function setBasename(base) {
+    basename = normalizeBase(base);
+    if (typeof location !== 'undefined')
+        path.set(stripBase(location.pathname));
+}
+const path = signal(typeof location !== 'undefined' ? stripBase(location.pathname) : '/');
+const search = signal(typeof location !== 'undefined' ? location.search : '');
+const afterHooks = new Set();
+/**
+ * Register a callback that runs after every navigation (push / pop / replace) —
+ * the place for document-title updates, analytics, focus management, etc. Returns
+ * an unsubscribe function.
+ */
+export function afterEach(fn) {
+    afterHooks.add(fn);
+    return () => void afterHooks.delete(fn);
+}
+// Built-in scroll handling (on by default in the browser): scroll to top on a new
+// navigation, to a `#fragment` element if the URL has one, and restore the saved
+// position on back/forward. Apps that manage scroll themselves opt out.
+let scrollManaged = typeof window !== 'undefined';
+/** Toggle Weave's built-in scroll handling (top-on-push, `#fragment`, restore-on-pop). */
+export function setScrollHandling(on) {
+    scrollManaged = on;
+}
+const scrollPositions = new Map();
+let posSeq = 0;
+let curPos = 0;
+// Own scroll restoration so the browser's native one doesn't fight ours.
+if (typeof history !== 'undefined' && 'scrollRestoration' in history) {
+    try {
+        history.scrollRestoration = 'manual';
+    }
+    catch {
+        /* some embedded contexts disallow it */
+    }
+}
+/** Fire the after-hooks, then apply built-in scroll (in a microtask, after the swap). */
+function runAfter(nav) {
+    for (const fn of afterHooks)
+        fn(nav);
+    if (!scrollManaged || typeof window === 'undefined')
+        return;
+    const { type, hash } = nav;
+    queueMicrotask(() => {
+        if (type === 'pop') {
+            window.scrollTo(0, scrollPositions.get(curPos) ?? 0);
+            return;
+        }
+        if (hash) {
+            const el = document.getElementById(hash.slice(1));
+            if (el) {
+                el.scrollIntoView();
+                return;
+            }
+        }
+        window.scrollTo(0, 0);
+    });
+}
+if (typeof window !== 'undefined') {
+    window.addEventListener('popstate', (e) => {
+        const st = e.state;
+        curPos = st && typeof st.__wpos === 'number' ? st.__wpos : 0;
+        const internal = stripBase(location.pathname);
+        batch(() => {
+            path.set(internal);
+            search.set(location.search);
+        });
+        runAfter({ path: internal, search: location.search, hash: location.hash, type: 'pop' });
+    });
+}
+/** The reactive current pathname (read-only). */
+export const currentPath = () => path();
+/** Parsed query string as a reactive `{ key: value }` map (last value wins on repeats). */
+const queryMap = computed(() => {
+    const out = {};
+    const s = search();
+    if (s)
+        new URLSearchParams(s).forEach((v, k) => (out[k] = v));
+    return out;
+});
+/** The reactive current query params (read-only). */
+export const currentQuery = () => queryMap();
+/** Programmatic navigation (pushes history). Resilient if the env blocks pushState. */
+export function navigate(to) {
+    const hash = to.includes('#') ? to.slice(to.indexOf('#')) : '';
+    const noHash = to.split('#')[0];
+    const qI = noHash.indexOf('?');
+    const nextPath = qI === -1 ? noHash : noHash.slice(0, qI);
+    const nextSearch = qI === -1 ? '' : noHash.slice(qI);
+    // A bare same-URL navigation is a no-op — unless there's a `#fragment` to scroll to.
+    if (nextPath === path.peek() && nextSearch === search.peek() && !hash)
+        return;
+    // Remember where we are before leaving, so back/forward can restore it.
+    if (typeof window !== 'undefined')
+        scrollPositions.set(curPos, window.scrollY);
+    const nextPos = ++posSeq;
+    try {
+        // Write the externally-visible URL (basename-prefixed); signals stay internal.
+        history.pushState({ __wpos: nextPos }, '', withBase(nextPath) + nextSearch + hash);
+        curPos = nextPos;
+    }
+    catch {
+        /* non-navigable environment (tests, sandboxes) — the signals stay authoritative */
+    }
+    batch(() => {
+        path.set(nextPath);
+        search.set(nextSearch);
+    });
+    runAfter({ path: nextPath, search: nextSearch, hash, type: 'push' });
+}
+/** Go back one history entry (the `popstate` listener syncs the path). */
+export function back() {
+    history.back();
+}
+const splitSegs = (s) => s.split('/').filter(Boolean);
+function parsePattern(pattern) {
+    return splitSegs(pattern).map((s) => s.startsWith(':') ? { param: s.slice(1) } : { literal: s });
+}
+function compileRoutes(routes) {
+    return routes
+        .filter((r) => r.path !== '*')
+        .map((r) => ({
+        route: r,
+        segs: parsePattern(r.path),
+        children: r.children ? compileRoutes(r.children) : [],
+    }));
+}
+/** Match a pattern's segments against a leading run of the path; return params + remainder. */
+function matchPrefix(segs, pathSegs) {
+    if (segs.length > pathSegs.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < segs.length; i++) {
+        const s = segs[i];
+        if ('param' in s)
+            params[s.param] = decodeURIComponent(pathSegs[i]);
+        else if (s.literal !== pathSegs[i])
+            return null;
+    }
+    return { params, rest: pathSegs.slice(segs.length) };
+}
+/** Resolve one sibling level: first matching route → redirect / guard / descend / leaf. */
+function resolveLevel(routes, pathSegs, query, fullPath, inherited) {
+    for (const c of routes) {
+        const m = matchPrefix(c.segs, pathSegs);
+        if (!m)
+            continue;
+        const params = { ...inherited, ...m.params };
+        if (c.route.redirect)
+            return { redirect: c.route.redirect };
+        const verdict = c.route.guard ? c.route.guard({ path: fullPath, params, query }) : true;
+        if (verdict === false)
+            return null; // blocked → caller falls back
+        if (typeof verdict === 'string')
+            return { redirect: verdict };
+        const here = { view: c.route.component, params };
+        if (m.rest.length === 0) {
+            // Path fully consumed: include an index child (`path: ''`) if one matches.
+            if (c.children.length) {
+                const idx = resolveLevel(c.children, [], query, fullPath, params);
+                if (idx && 'redirect' in idx)
+                    return idx;
+                if (idx && 'chain' in idx)
+                    return { chain: [here, ...idx.chain] };
+            }
+            return { chain: [here] };
+        }
+        // Segments remain: this route only matches if a child consumes the rest.
+        if (c.children.length) {
+            const sub = resolveLevel(c.children, m.rest, query, fullPath, params);
+            if (sub && 'redirect' in sub)
+                return sub;
+            if (sub && 'chain' in sub)
+                return { chain: [here, ...sub.chain] };
+        }
+        // No child matched the remainder → not a full match; try the next sibling.
+    }
+    return null;
+}
+/** The most recently created router — the target of the module-level {@link prefetch}. */
+let activeRouter = null;
+/**
+ * Build a router from an ordered `Route[]` tree (`path: '*'` = catch-all fallback).
+ * Resolution is a single reactive computation producing a match *chain*; redirect and
+ * guard-redirect hops are followed (capped at 16 to break loops). Place the output with
+ * a top `<RouterView router={r}/>` and a nested `<RouterView/>` inside each layout.
+ */
+export function createRouter(routes, options) {
+    if (options?.basename !== undefined)
+        setBasename(options.basename);
+    const compiled = compileRoutes(routes);
+    const fallback = routes.find((r) => r.path === '*');
+    const fallbackChain = () => fallback?.component ? [{ view: fallback.component, params: {} }] : [];
+    const resolution = computed(() => {
+        const q = queryMap();
+        const start = path();
+        let p = start;
+        for (let hops = 0; hops < 16; hops++) {
+            const res = resolveLevel(compiled, splitSegs(p), q, p, {});
+            const synced = p !== start ? p : null;
+            if (res && 'redirect' in res) {
+                p = res.redirect.split('#')[0].split('?')[0];
+                continue;
+            }
+            if (res && 'chain' in res)
+                return { chain: res.chain, redirectTo: synced };
+            return { chain: fallbackChain(), redirectTo: synced };
+        }
+        return { chain: [], redirectTo: null }; // redirect loop — give up rather than spin
+    });
+    const chain = () => resolution().chain;
+    /** Non-reactive resolve of an arbitrary path → preload each chunk in its chain. */
+    const preload = (to) => {
+        let p = to.split('#')[0].split('?')[0];
+        for (let hops = 0; hops < 16; hops++) {
+            const res = resolveLevel(compiled, splitSegs(p), {}, p, {});
+            if (res && 'redirect' in res) {
+                p = res.redirect.split('#')[0].split('?')[0];
+                continue;
+            }
+            const ch = res && 'chain' in res ? res.chain : fallbackChain();
+            for (const m of ch)
+                m.view.preload?.();
+            return;
+        }
+    };
+    const router = {
+        chain,
+        matched: (depth = 0) => chain()[depth] ?? null,
+        params: (depth) => {
+            const ch = chain();
+            const i = depth ?? ch.length - 1;
+            return ch[i]?.params ?? {};
+        },
+        query: () => queryMap(),
+        redirectTo: () => resolution().redirectTo,
+        preload,
+    };
+    activeRouter = router; // most-recent router answers the module-level prefetch()
+    return router;
+}
+/** Warm a path's lazy route chunk(s) via the active router (no-op if none / not lazy). */
+export function prefetch(to) {
+    activeRouter?.preload(to);
+}
+/** Carries the router + the next outlet's depth down the tree (set by each RouterView). */
+const OutletContext = createContext(null);
+/**
+ * Router outlet: renders the matched component at its depth in the chain. The top
+ * outlet takes `router` as a prop and renders depth 0; a nested `<RouterView/>` written
+ * inside a layout discovers the router + its depth via context. A `display:contents`
+ * host keeps it layout-neutral. A stable render thunk per component means a param-only
+ * change updates `params` in place instead of remounting; switching routes swaps the
+ * component. The top outlet also syncs the address bar after a guard/redirect.
+ *
+ * Pass `transition` (a `TransitionFn`, e.g. `fade`) to animate route changes: the
+ * entering view is wrapped in a real host element that plays the intro on swap — so
+ * it works even for `lazy()` routes (whose own host is `display:contents`). Author a
+ * page-root `out:` if you also want a leave animation.
+ *
+ * Usage: `<RouterView router={r}/>` at the top, `<RouterView/>` inside each layout.
+ */
+export const RouterView = (props = {}) => {
+    const parentCtx = inject(OutletContext);
+    const router = props.router ?? parentCtx?.router;
+    const depth = parentCtx ? parentCtx.depth : 0;
+    const txFn = props.transition;
+    const txParams = props.transitionParams;
+    // Hand the router + the next depth to any nested outlet below us. Only when an owner
+    // scope exists (a directly-invoked RouterView in a test has none — and won't nest).
+    if (router && getOwner())
+        provide(OutletContext, { router, depth: depth + 1 });
+    const host = document.createElement('div');
+    host.style.display = 'contents';
+    const anchorNode = document.createComment('router');
+    host.appendChild(anchorNode);
+    // Only the top outlet syncs the URL on a guard/redirect (redirects bubble to the
+    // chain root regardless of depth). Owned by this outlet's scope; converges after
+    // navigating (resolution then lands on the target → redirectTo() is null).
+    if (router && depth === 0) {
+        effect(() => {
+            const to = router.redirectTo();
+            if (to !== null && to !== path.peek())
+                navigate(to);
+        });
+    }
+    const thunks = new Map();
+    ifBlock(anchorNode, () => {
+        const m = router?.matched(depth) ?? null;
+        if (!m)
+            return null;
+        let thunk = thunks.get(m.view);
+        if (!thunk) {
+            const view = m.view;
+            thunk = () => {
+                const node = view({
+                    get params() {
+                        return router.params(depth);
+                    },
+                });
+                if (!txFn)
+                    return node;
+                // Wrap in a real element so the intro plays even when the view's own root is
+                // `display:contents` (lazy host) or a fragment (multi-root template).
+                const wrap = document.createElement('div');
+                wrap.appendChild(node);
+                transition(wrap, txFn, txParams, 'in');
+                return wrap;
+            };
+            thunks.set(view, thunk);
+        }
+        return thunk;
+    });
+    return host;
+};
+/**
+ * Client-side anchor: navigates instead of reloading (plain clicks only — lets
+ * ctrl/cmd/middle-click open a new tab as usual).
+ *
+ * Active state (reactive on the current path): when the link's target matches the
+ * URL it gets `aria-current="page"` automatically, and — if you name one via
+ * `activeClass` — an active CSS class. Matching is prefix-by-segment so a parent
+ * link (`/users`) stays active on a child (`/users/42`); pass `exact` to require an
+ * exact match. A link to `/` is only ever active at exactly `/`.
+ *
+ * Usage in a template: `<Link to="/about" activeClass="active">About</Link>`.
+ */
+export const Link = (props = {}, slots = {}) => {
+    const to = String(props.to ?? '/');
+    // prefetch defaults on: warm the target's lazy chunk on first hover/focus.
+    const wantsPrefetch = props.prefetch !== false;
+    const exact = props.exact === true;
+    const activeClass = typeof props.activeClass === 'string'
+        ? props.activeClass
+        : null;
+    const a = document.createElement('a');
+    // The visible href is basename-prefixed (so middle/ctrl-click + SSR are correct);
+    // navigation + active-matching use the internal `to`.
+    a.setAttribute('href', withBase(to));
+    // Forward any other props (class, id, aria-*, title, …) to the anchor, so a
+    // `<Link class="nav" aria-label="Home">` actually styles/labels its <a>. The
+    // router-owned props and any function/event props are skipped; read once.
+    for (const key in props) {
+        if (key === 'to' || key === 'prefetch' || key === 'exact' || key === 'activeClass')
+            continue;
+        const val = props[key];
+        if (val == null || val === false || typeof val === 'function')
+            continue;
+        a.setAttribute(key, val === true ? '' : String(val));
+    }
+    const kids = slots.default?.();
+    if (kids)
+        a.appendChild(kids);
+    // Reactive active state. The target is compared without query/hash; `/` is
+    // exact-only (else its prefix would match every path).
+    const target = to.split('#')[0].split('?')[0];
+    const isActive = (cur) => {
+        if (exact || target === '/')
+            return cur === target;
+        if (cur === target)
+            return true;
+        return cur.startsWith(target.endsWith('/') ? target : target + '/');
+    };
+    effect(() => {
+        const on = isActive(currentPath());
+        if (on)
+            a.setAttribute('aria-current', 'page');
+        else
+            a.removeAttribute('aria-current');
+        if (activeClass)
+            a.classList.toggle(activeClass, on);
+    });
+    a.addEventListener('click', (e) => {
+        const me = e;
+        if (me.metaKey || me.ctrlKey || me.shiftKey || me.button !== 0)
+            return;
+        e.preventDefault();
+        navigate(to);
+    });
+    if (wantsPrefetch) {
+        let warmed = false;
+        const warm = () => {
+            if (warmed)
+                return;
+            warmed = true;
+            prefetch(to);
+        };
+        a.addEventListener('pointerenter', warm);
+        a.addEventListener('focusin', warm);
+    }
+    return a;
+};
+export { fileToRoutes, emitRoutesModule, } from './files.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":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@weave-framework/router",
+  "version": "0.2.0",
+  "description": "Weave official client router — signal-driven, history-based, with RouterView + Link. Zero third-party deps.",
+  "type": "module",
+  "sideEffects": [
+    "./src/index.ts",
+    "./dist/index.js"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./files": {
+      "types": "./dist/files.d.ts",
+      "import": "./dist/files.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weave-framework/weave.git",
+    "directory": "packages/router"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@weave-framework/runtime": "0.2.0"
+  },
+  "license": "MIT"
+}