@takazudo/zfb-runtime 0.1.0-next.2

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0-next.1
+
+Initial public prerelease on npm.
+
+- JavaScript runtime for zfb static sites: Hono-backed page router, content snapshots, client-side hydration.
+- Subpath exports: `snapshot`, `client-router`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Takeshi Takatsudo
+
+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/README.md

@@ -0,0 +1,237 @@
+# @takazudo/zfb-runtime
+
+> Rust-built static-site engine for Astro and Next.js users — millisecond rebuilds, single binary.
+
+The JS-side runtime for [zfb][zfb-site]'s SSG-first build pipeline. It
+exposes `createPageRouter`, a Hono-backed page router whose returned
+fetch handler is shape-compatible with the Cloudflare Workers
+`(request) => Promise<Response>` model. The Rust build host drives this
+router at build time to emit static HTML; the same handler also serves
+SSR requests at the edge.
+
+Full documentation: <https://takazudomodular.com/pj/zudo-front-builder/>.
+Source: <https://github.com/Takazudo/zudo-front-builder>.
+
+[zfb-site]: https://takazudomodular.com/pj/zudo-front-builder/
+
+## Install
+
+```sh
+npm install @takazudo/zfb-runtime @takazudo/zfb
+# or: pnpm add @takazudo/zfb-runtime @takazudo/zfb
+```
+
+`@takazudo/zfb` is a peer dependency — `createPageRouter` shares
+module-level state (`ContentSnapshot`) with `@takazudo/zfb/content`, so
+both packages must resolve to the same instance.
+
+## What this package does
+
+zfb's render pipeline goes:
+
+```
+user pages/ + content/ + layouts/ + components/
+  → esbuild bundle                     // single ESM file, Worker entry
+  → embedded V8 host                   // same WinterCG surface as CF Workers
+  → @takazudo/zfb-runtime              // <-- this package
+  → (request) => Promise<Response>     // Worker fetch handler
+```
+
+This package supplies the page-router factory the Worker entry calls. It
+is built on [Hono][hono] but does not leak Hono types through the public
+surface — consumers only see the four types in `src/index.ts`.
+
+[hono]: https://hono.dev/
+
+The runtime is **JSX-runtime-agnostic**. It never imports preact or
+react. The caller passes a `FrameworkAdapter` that pins `renderToString`
+to the chosen JSX runtime; both `preact-render-to-string` and
+`react-dom/server` slot in.
+
+## Public API
+
+```ts
+import { createPageRouter } from "@takazudo/zfb-runtime";
+import type {
+  CreatePageRouterOptions,
+  PageDefinition,
+  PageModule,
+  PageHeading,
+  PageRouter,
+  FrameworkAdapter,
+  ContentSnapshot,
+  EntrySnapshot,
+} from "@takazudo/zfb-runtime";
+```
+
+### `createPageRouter(options) → PageRouter`
+
+Build a fetch-handler that serves the supplied pages. The returned
+function is shape-compatible with a Worker `default.fetch`.
+
+```ts
+const router = createPageRouter({
+  pages,            // PageDefinition[]
+  contentSnapshot,  // ContentSnapshot embedded by the bundler
+  framework,        // FrameworkAdapter
+});
+
+export default { fetch: router };
+```
+
+**Side effects.**
+
+1. Calls `setContentSnapshot(contentSnapshot)` on the `zfb/content`
+   module so any user page importing `getCollection(name)` resolves
+   from memory rather than the Node `fs` API. Workers have no `fs`,
+   so this branch is the production path. Idempotent; subsequent
+   calls overwrite (matches the dev-mode live-reload contract).
+2. Constructs an internal Hono app and registers `app.get(page.route, …)`
+   for every entry in `pages`. The handler imports the page module,
+   calls `framework.renderToString(module.default({}))`, and returns
+   the string in a `Response`.
+
+### `PageDefinition`
+
+```ts
+interface PageDefinition {
+  readonly route: string;                            // Hono path pattern
+  readonly module: () => Promise<PageModule>;        // thunk for code-split friendliness
+}
+```
+
+### `PageModule`
+
+The shape every page module must export:
+
+```ts
+interface PageModule {
+  readonly default: (props: Record<string, unknown>) => unknown;
+  readonly prerender?: boolean;          // literal `false` excludes from SSG
+  readonly content_type?: string;        // overrides Content-Type (e.g. "application/xml")
+  readonly headings?: readonly PageHeading[]; // MDX-emitted TOC data
+}
+
+interface PageHeading {
+  readonly depth: number;
+  readonly slug: string;
+  readonly text: string;
+}
+```
+
+Default `Content-Type` is `text/html; charset=utf-8`.
+
+### `FrameworkAdapter`
+
+```ts
+interface FrameworkAdapter {
+  renderToString: (vnode: unknown) => string;
+  hydrate?: (...args: unknown[]) => unknown;  // reserved for follow-up SSR-with-hydration
+}
+```
+
+`hydrate` is reserved — the page router does not call it today.
+
+### `ContentSnapshot` / `EntrySnapshot`
+
+Direct TypeScript mirror of the Rust contract in
+`crates/zfb-content/src/content_bridge.rs`. Field names are snake_case
+(`module_specifier`, `rel_path`) to match the JSON serialization.
+
+```ts
+interface EntrySnapshot {
+  readonly slug: string;
+  readonly frontmatter: unknown;        // null when source had none; getCollection normalises to {}
+  readonly body: string;                // empty for .tsx entries
+  readonly module_specifier: string;
+  readonly rel_path: string;
+}
+
+interface ContentSnapshot {
+  readonly collections: Readonly<Record<string, readonly EntrySnapshot[]>>;
+}
+```
+
+The Rust side guarantees deterministic order (collections sorted by
+name, entries sorted by slug). The TS side does **not** re-sort — it
+preserves the order the bundle delivers, so the determinism story is
+"identical Rust input → identical bundle bytes → identical render
+output" without an extra sort step.
+
+## Bundle shape consumed by the embedded V8 host
+
+zfb's embedded V8 host loads a single ESM Worker bundle produced by the
+esbuild step. The bundle's entry point must look like this:
+
+```ts
+// dist/worker.mjs (shape — generated by the bundler, not committed)
+import { createPageRouter } from "@takazudo/zfb-runtime";
+import * as preactRender from "preact-render-to-string";
+
+import HomePage from "./pages/index.tsx";
+import BlogPost from "./pages/blog/[slug].tsx";
+// ... user content + layouts + components, bundled flat
+
+const router = createPageRouter({
+  pages: [
+    { route: "/",            module: () => Promise.resolve({ default: HomePage }) },
+    { route: "/blog/:slug",  module: () => Promise.resolve({ default: BlogPost }) },
+    // ... one entry per route, expanded from `paths()` static evaluation
+  ],
+  contentSnapshot: {
+    // Embedded JSON literal — the Rust bundler injects the snapshot via
+    // an `import.meta.env`-style replacement or a top-level inline.
+    collections: { /* ... */ },
+  },
+  framework: {
+    renderToString: (vnode) => preactRender.renderToString(vnode as unknown as preactRender.ComponentChild),
+  },
+});
+
+export default { fetch: router };
+```
+
+The host then drives the Worker by sending `GET` requests for each
+enumerated route and writing the response body to `dist/{route}/index.html`.
+
+### Contract this package commits to
+
+- `createPageRouter` is the single export the build host wires to.
+- The returned function is **always** `(request: Request) => Promise<Response>`,
+  even if the underlying Hono path returns synchronously.
+- `Content-Type` defaults to `text/html; charset=utf-8`. Page modules
+  with a `content_type` field override it.
+- Errors in page evaluation surface as 500 responses with a diagnostic
+  text body; the host's source-map plumbing projects those back to the
+  user's TSX line.
+- The `ContentSnapshot` registration is idempotent and observable via
+  `getContentSnapshot()` re-exported from `zfb/content`. Dev-mode hosts
+  can call `setContentSnapshot(undefined)` to clear between rebuilds if
+  needed (today the runtime overwrites on each `createPageRouter` call,
+  which is the documented happy path).
+
+## Local development
+
+```sh
+pnpm --filter @takazudo/zfb-runtime test
+pnpm --filter @takazudo/zfb-runtime typecheck
+```
+
+Tests run in `vitest` under Node's `node` environment (no jsdom — the
+runtime targets the Workers `fetch` model, which Node implements
+natively). The framework adapter is stubbed so tests do not pull in
+preact-render-to-string. Determinism is asserted by rendering twice
+from independently-constructed routers and comparing byte-equal.
+
+The embedded V8 host is **not** booted from this package's tests — that
+integration belongs to the Rust-side build host. The end-to-end
+acceptance criterion ("Worker bundle returns correct HTML for each
+route") is exercised by the host crate's test suite, not here.
+
+## Why a peer dependency on `zfb`
+
+`createPageRouter` calls `setContentSnapshot` from `zfb/content`. The
+two modules share module-level state, so they must resolve to the same
+instance — pinning `zfb` as a peer dep makes that explicit and lets pnpm
+hoist a single shared copy. Workspace-internal usage today resolves via
+`workspace:*`; an external publish would change to a SemVer range.

package/dist/client-router/cssesc.d.ts

@@ -0,0 +1,9 @@
+interface Options {
+    escapeEverything: boolean;
+    isIdentifier: boolean;
+    quotes: "single" | "double";
+    wrap: boolean;
+}
+export default function cssesc(string: string, options?: Partial<Options>): string;
+export {};
+//# sourceMappingURL=cssesc.d.ts.map

package/dist/client-router/cssesc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssesc.d.ts","sourceRoot":"","sources":["../../src/client-router/cssesc.ts"],"names":[],"mappings":"AAYA,UAAU,OAAO;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf;AASD,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,OAAO,CAAM,UA4E5E"}

package/dist/client-router/cssesc.js

@@ -0,0 +1,95 @@
+/* eslint-disable regexp/control-character-escape */
+/* eslint-disable no-control-regex */
+/* eslint-disable regexp/no-optional-assertion */
+/* eslint-disable regexp/no-useless-escape */
+/* eslint-disable regexp/no-obscure-range */
+// ESM vendored version of cssesc: https://github.com/mathiasbynens/cssesc/blob/cb894eb42f27c8d3cd793f16afe35b3ab38000a1/cssesc.js
+// See https://github.com/withastro/astro/pull/15669
+const regexAnySingleEscape = /[ -,\.\/:-@\[-\^`\{-~]/;
+const regexSingleEscape = /[ -,\.\/:-@\[\]\^`\{-~]/;
+const regexExcessiveSpaces = /(^|\\+)?(\\[A-F0-9]{1,6})\x20(?![a-fA-F0-9\x20])/g;
+const DEFAULT_OPTIONS = {
+    escapeEverything: false,
+    isIdentifier: false,
+    quotes: "single",
+    wrap: false,
+};
+export default function cssesc(string, options = {}) {
+    options = { ...DEFAULT_OPTIONS, ...options };
+    const quote = options.quotes === "double" ? '"' : "'";
+    const { isIdentifier } = options;
+    const firstChar = string.charAt(0);
+    let output = "";
+    let counter = 0;
+    const length = string.length;
+    while (counter < length) {
+        const character = string.charAt(counter++);
+        let codePoint = character.charCodeAt(0);
+        let value;
+        // If it's not a printable ASCII character…
+        if (codePoint < 0x20 || codePoint > 0x7e) {
+            if (codePoint >= 0xd800 && codePoint <= 0xdbff && counter < length) {
+                // It's a high surrogate, and there is a next character.
+                const extra = string.charCodeAt(counter++);
+                if ((extra & 0xfc00) === 0xdc00) {
+                    // next character is low surrogate
+                    codePoint = ((codePoint & 0x3ff) << 10) + (extra & 0x3ff) + 0x10000;
+                }
+                else {
+                    // It's an unmatched surrogate; only append this code unit, in case
+                    // the next code unit is the high surrogate of a surrogate pair.
+                    counter--;
+                }
+            }
+            value = "\\" + codePoint.toString(16).toUpperCase() + " ";
+        }
+        else {
+            if (options.escapeEverything) {
+                if (regexAnySingleEscape.test(character)) {
+                    value = "\\" + character;
+                }
+                else {
+                    value = "\\" + codePoint.toString(16).toUpperCase() + " ";
+                }
+            }
+            else if (/[\t\n\f\r\x0B]/.test(character)) {
+                value = "\\" + codePoint.toString(16).toUpperCase() + " ";
+            }
+            else if (character === "\\" ||
+                (!isIdentifier &&
+                    ((character === '"' && quote === character) ||
+                        (character === "'" && quote === character))) ||
+                (isIdentifier && regexSingleEscape.test(character))) {
+                value = "\\" + character;
+            }
+            else {
+                value = character;
+            }
+        }
+        output += value;
+    }
+    if (isIdentifier) {
+        if (/^-[-\d]/.test(output)) {
+            output = "\\-" + output.slice(1);
+        }
+        else if (/\d/.test(firstChar)) {
+            output = "\\3" + firstChar + " " + output.slice(1);
+        }
+    }
+    // Remove spaces after `\HEX` escapes that are not followed by a hex digit,
+    // since they're redundant. Note that this is only possible if the escape
+    // sequence isn't preceded by an odd number of backslashes.
+    output = output.replace(regexExcessiveSpaces, function ($0, $1, $2) {
+        if ($1 && $1.length % 2) {
+            // It's not safe to remove the space, so don't.
+            return $0;
+        }
+        // Strip the space.
+        return ($1 || "") + $2;
+    });
+    if (!isIdentifier && options.wrap) {
+        return quote + output + quote;
+    }
+    return output;
+}
+//# sourceMappingURL=cssesc.js.map

package/dist/client-router/cssesc.js.map

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

package/dist/client-router/events.d.ts

@@ -0,0 +1,42 @@
+import type { Direction, NavigationTypeString } from "./types.js";
+export declare const TRANSITION_BEFORE_PREPARATION = "zfb:before-preparation";
+export declare const TRANSITION_AFTER_PREPARATION = "zfb:after-preparation";
+export declare const TRANSITION_BEFORE_SWAP = "zfb:before-swap";
+export declare const TRANSITION_AFTER_SWAP = "zfb:after-swap";
+export declare const TRANSITION_PAGE_LOAD = "zfb:page-load";
+export declare const TRANSITION_NAVIGATION_ABORTED = "zfb:navigation-aborted";
+type Events = "zfb:after-preparation" | "zfb:after-swap" | "zfb:page-load" | "zfb:navigation-aborted";
+export declare const triggerEvent: (name: Events) => boolean;
+export declare const onPageLoad: () => boolean;
+declare class BeforeEvent extends Event {
+    readonly from: URL;
+    to: URL;
+    direction: Direction | string;
+    readonly navigationType: NavigationTypeString;
+    readonly sourceElement: Element | undefined;
+    readonly info: any;
+    newDocument: Document;
+    readonly signal: AbortSignal;
+    constructor(type: string, eventInitDict: EventInit | undefined, from: URL, to: URL, direction: Direction | string, navigationType: NavigationTypeString, sourceElement: Element | undefined, info: any, newDocument: Document, signal: AbortSignal);
+}
+export declare const isTransitionBeforePreparationEvent: (value: any) => value is TransitionBeforePreparationEvent;
+export declare class TransitionBeforePreparationEvent extends BeforeEvent {
+    formData: FormData | undefined;
+    loader: () => Promise<void>;
+    constructor(from: URL, to: URL, direction: Direction | string, navigationType: NavigationTypeString, sourceElement: Element | undefined, info: any, newDocument: Document, signal: AbortSignal, formData: FormData | undefined, loader: (event: TransitionBeforePreparationEvent) => Promise<void>);
+}
+export declare const isTransitionBeforeSwapEvent: (value: any) => value is TransitionBeforeSwapEvent;
+export declare class TransitionBeforeSwapEvent extends BeforeEvent {
+    readonly direction: Direction | string;
+    readonly viewTransition: ViewTransition;
+    swap: () => void;
+    constructor(afterPreparation: BeforeEvent, viewTransition: ViewTransition);
+}
+export declare function doPreparation(from: URL, to: URL, direction: Direction | string, navigationType: NavigationTypeString, sourceElement: Element | undefined, info: any, signal: AbortSignal, formData: FormData | undefined, defaultLoader: (event: TransitionBeforePreparationEvent) => Promise<void>): Promise<TransitionBeforePreparationEvent>;
+export declare const updateScrollPosition: (positions: {
+    scrollX: number;
+    scrollY: number;
+}) => void;
+export declare function doSwap(afterPreparation: BeforeEvent, viewTransition: ViewTransition, afterDispatch?: () => Promise<void>): Promise<TransitionBeforeSwapEvent>;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/client-router/events.d.ts.map

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

package/dist/client-router/events.js

@@ -0,0 +1,114 @@
+/// <reference lib="dom" />
+import { swap } from "./swap-functions.js";
+export const TRANSITION_BEFORE_PREPARATION = "zfb:before-preparation";
+export const TRANSITION_AFTER_PREPARATION = "zfb:after-preparation";
+export const TRANSITION_BEFORE_SWAP = "zfb:before-swap";
+export const TRANSITION_AFTER_SWAP = "zfb:after-swap";
+export const TRANSITION_PAGE_LOAD = "zfb:page-load";
+export const TRANSITION_NAVIGATION_ABORTED = "zfb:navigation-aborted";
+export const triggerEvent = (name) => document.dispatchEvent(new Event(name));
+export const onPageLoad = () => triggerEvent("zfb:page-load");
+/*
+ * Common stuff
+ */
+class BeforeEvent extends Event {
+    from;
+    to;
+    direction;
+    navigationType;
+    sourceElement;
+    info;
+    newDocument;
+    signal;
+    constructor(type, eventInitDict, from, to, direction, navigationType, sourceElement, info, newDocument, signal) {
+        super(type, eventInitDict);
+        this.from = from;
+        this.to = to;
+        this.direction = direction;
+        this.navigationType = navigationType;
+        this.sourceElement = sourceElement;
+        this.info = info;
+        this.newDocument = newDocument;
+        this.signal = signal;
+        Object.defineProperties(this, {
+            from: { enumerable: true },
+            to: { enumerable: true, writable: true },
+            direction: { enumerable: true, writable: true },
+            navigationType: { enumerable: true },
+            sourceElement: { enumerable: true },
+            info: { enumerable: true },
+            newDocument: { enumerable: true, writable: true },
+            signal: { enumerable: true },
+        });
+    }
+}
+/*
+ * TransitionBeforePreparationEvent
+
+ */
+export const isTransitionBeforePreparationEvent = (value) => value.type === TRANSITION_BEFORE_PREPARATION;
+export class TransitionBeforePreparationEvent extends BeforeEvent {
+    formData;
+    loader;
+    constructor(from, to, direction, navigationType, sourceElement, info, newDocument, signal, formData, loader) {
+        super(TRANSITION_BEFORE_PREPARATION, { cancelable: true }, from, to, direction, navigationType, sourceElement, info, newDocument, signal);
+        this.formData = formData;
+        this.loader = loader.bind(this, this);
+        Object.defineProperties(this, {
+            formData: { enumerable: true },
+            loader: { enumerable: true, writable: true },
+        });
+    }
+}
+/*
+ * TransitionBeforeSwapEvent
+ */
+export const isTransitionBeforeSwapEvent = (value) => value.type === TRANSITION_BEFORE_SWAP;
+export class TransitionBeforeSwapEvent extends BeforeEvent {
+    direction;
+    viewTransition;
+    swap;
+    constructor(afterPreparation, viewTransition) {
+        super(TRANSITION_BEFORE_SWAP, undefined, afterPreparation.from, afterPreparation.to, afterPreparation.direction, afterPreparation.navigationType, afterPreparation.sourceElement, afterPreparation.info, afterPreparation.newDocument, afterPreparation.signal);
+        this.direction = afterPreparation.direction;
+        this.viewTransition = viewTransition;
+        this.swap = () => swap(this.newDocument);
+        Object.defineProperties(this, {
+            direction: { enumerable: true },
+            viewTransition: { enumerable: true },
+            swap: { enumerable: true, writable: true },
+        });
+    }
+}
+export async function doPreparation(from, to, direction, navigationType, sourceElement, info, signal, formData, defaultLoader) {
+    const event = new TransitionBeforePreparationEvent(from, to, direction, navigationType, sourceElement, info, window.document, signal, formData, defaultLoader);
+    if (document.dispatchEvent(event)) {
+        await event.loader();
+        if (!event.defaultPrevented) {
+            triggerEvent("zfb:after-preparation");
+            if (event.navigationType !== "traverse") {
+                // save the current scroll position before we change the DOM and transition to the new page
+                updateScrollPosition({ scrollX, scrollY });
+            }
+        }
+    }
+    return event;
+}
+// only update history entries that are managed by us
+// leave other entries alone and do not accidentally add state.
+export const updateScrollPosition = (positions) => {
+    if (history.state) {
+        history.scrollRestoration = "manual";
+        history.replaceState({ ...history.state, ...positions }, "");
+    }
+};
+export async function doSwap(afterPreparation, viewTransition, afterDispatch) {
+    const event = new TransitionBeforeSwapEvent(afterPreparation, viewTransition);
+    document.dispatchEvent(event);
+    if (afterDispatch) {
+        await afterDispatch();
+    }
+    event.swap();
+    return event;
+}
+//# sourceMappingURL=events.js.map

package/dist/client-router/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/client-router/events.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAG3C,MAAM,CAAC,MAAM,6BAA6B,GAAG,wBAAwB,CAAC;AACtE,MAAM,CAAC,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AACpD,MAAM,CAAC,MAAM,6BAA6B,GAAG,wBAAwB,CAAC;AAOtE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAY,SAAQ,KAAK;IACpB,IAAI,CAAM;IACnB,EAAE,CAAM;IACR,SAAS,CAAqB;IACrB,cAAc,CAAuB;IACrC,aAAa,CAAsB;IACnC,IAAI,CAAM;IACnB,WAAW,CAAW;IACb,MAAM,CAAc;IAE7B,YACE,IAAY,EACZ,aAAoC,EACpC,IAAS,EACT,EAAO,EACP,SAA6B,EAC7B,cAAoC,EACpC,aAAkC,EAClC,IAAS,EACT,WAAqB,EACrB,MAAmB;QAEnB,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;YAC5B,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YAC1B,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YACxC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/C,cAAc,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YACpC,aAAa,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YACnC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YAC1B,WAAW,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YACjD,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,KAAU,EACiC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,6BAA6B,CAAC;AAC7F,MAAM,OAAO,gCAAiC,SAAQ,WAAW;IAC/D,QAAQ,CAAuB;IAC/B,MAAM,CAAsB;IAC5B,YACE,IAAS,EACT,EAAO,EACP,SAA6B,EAC7B,cAAoC,EACpC,aAAkC,EAClC,IAAS,EACT,WAAqB,EACrB,MAAmB,EACnB,QAA8B,EAC9B,MAAkE;QAElE,KAAK,CACH,6BAA6B,EAC7B,EAAE,UAAU,EAAE,IAAI,EAAE,EACpB,IAAI,EACJ,EAAE,EACF,SAAS,EACT,cAAc,EACd,aAAa,EACb,IAAI,EACJ,WAAW,EACX,MAAM,CACP,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;YAC5B,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YAC9B,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC7C,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,KAAU,EAAsC,EAAE,CAC5F,KAAK,CAAC,IAAI,KAAK,sBAAsB,CAAC;AACxC,MAAM,OAAO,yBAA0B,SAAQ,WAAW;IACtC,SAAS,CAAqB;IACvC,cAAc,CAAiB;IACxC,IAAI,CAAa;IAEjB,YAAY,gBAA6B,EAAE,cAA8B;QACvE,KAAK,CACH,sBAAsB,EACtB,SAAS,EACT,gBAAgB,CAAC,IAAI,EACrB,gBAAgB,CAAC,EAAE,EACnB,gBAAgB,CAAC,SAAS,EAC1B,gBAAgB,CAAC,cAAc,EAC/B,gBAAgB,CAAC,aAAa,EAC9B,gBAAgB,CAAC,IAAI,EACrB,gBAAgB,CAAC,WAAW,EAC5B,gBAAgB,CAAC,MAAM,CACxB,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC;QAC5C,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEzC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;YAC5B,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YAC/B,cAAc,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YACpC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC3C,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAS,EACT,EAAO,EACP,SAA6B,EAC7B,cAAoC,EACpC,aAAkC,EAClC,IAAS,EACT,MAAmB,EACnB,QAA8B,EAC9B,aAAyE;IAEzE,MAAM,KAAK,GAAG,IAAI,gCAAgC,CAChD,IAAI,EACJ,EAAE,EACF,SAAS,EACT,cAAc,EACd,aAAa,EACb,IAAI,EACJ,MAAM,CAAC,QAAQ,EACf,MAAM,EACN,QAAQ,EACR,aAAa,CACd,CAAC;IACF,IAAI,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC5B,YAAY,CAAC,uBAAuB,CAAC,CAAC;YACtC,IAAI,KAAK,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;gBACxC,2FAA2F;gBAC3F,oBAAoB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qDAAqD;AACrD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAA+C,EAAE,EAAE;IACtF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,iBAAiB,GAAG,QAAQ,CAAC;QACrC,OAAO,CAAC,YAAY,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,gBAA6B,EAC7B,cAA8B,EAC9B,aAAmC;IAEnC,MAAM,KAAK,GAAG,IAAI,yBAAyB,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IAC9E,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,aAAa,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,IAAI,EAAE,CAAC;IACb,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/client-router/index.d.ts

@@ -0,0 +1,9 @@
+export { ClientRouter, type ClientRouterProps } from "../client-router.js";
+export { TRANSITION_BEFORE_PREPARATION, TRANSITION_AFTER_PREPARATION, TRANSITION_BEFORE_SWAP, TRANSITION_AFTER_SWAP, TRANSITION_PAGE_LOAD, TRANSITION_NAVIGATION_ABORTED, TransitionBeforePreparationEvent, TransitionBeforeSwapEvent, isTransitionBeforePreparationEvent, isTransitionBeforeSwapEvent, } from "./events.js";
+export type { Direction, Fallback, NavigationTypeString, Options } from "./types.js";
+export { swapFunctions, swap } from "./swap-functions.js";
+export { navigate, supportsViewTransitions, transitionEnabledOnThisPage, init } from "./router.js";
+export type { InitOptions } from "./router.js";
+export { prefetch, init as prefetchInit } from "./prefetch.js";
+export type { PrefetchStrategy, PrefetchInitOptions, PrefetchOptions } from "./prefetch.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client-router/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAM1D,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnG,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/client-router/index.js

@@ -0,0 +1,18 @@
+// Public API surface for the client-router module.
+// This file is the barrel for @takazudo/zfb-runtime's client-router export.
+// W3D adds the <ClientRouter /> component and ClientRouterProps re-exports.
+// Component (W3D).
+export { ClientRouter } from "../client-router.js";
+export { TRANSITION_BEFORE_PREPARATION, TRANSITION_AFTER_PREPARATION, TRANSITION_BEFORE_SWAP, TRANSITION_AFTER_SWAP, TRANSITION_PAGE_LOAD, TRANSITION_NAVIGATION_ABORTED, TransitionBeforePreparationEvent, TransitionBeforeSwapEvent, isTransitionBeforePreparationEvent, isTransitionBeforeSwapEvent, } from "./events.js";
+export { swapFunctions, swap } from "./swap-functions.js";
+// Router public surface.
+//   - W3C1: `supportsViewTransitions`, `transitionEnabledOnThisPage`.
+//   - W3C2: `navigate()` (public navigation entry).
+//   - W3C3: `init()` (idempotent bootstrap: registers click + form intercept listeners).
+export { navigate, supportsViewTransitions, transitionEnabledOnThisPage, init } from "./router.js";
+// Prefetch public surface (#276).
+// `init` from prefetch.ts is re-exported as `prefetchInit` to avoid colliding
+// with the router's `init` above.
+export { prefetch, init as prefetchInit } from "./prefetch.js";
+// (cssesc is an internal helper, not part of the public surface — not re-exported.)
+//# sourceMappingURL=index.js.map

package/dist/client-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client-router/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,4EAA4E;AAC5E,4EAA4E;AAE5E,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAA0B,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE1D,yBAAyB;AACzB,sEAAsE;AACtE,oDAAoD;AACpD,yFAAyF;AACzF,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGnG,kCAAkC;AAClC,8EAA8E;AAC9E,kCAAkC;AAClC,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AAG/D,oFAAoF"}

package/dist/client-router/prefetch.d.ts

@@ -0,0 +1,29 @@
+export type PrefetchStrategy = "hover" | "viewport" | "load" | "tap";
+export interface PrefetchInitOptions {
+    prefetchAll?: boolean;
+    defaultStrategy?: PrefetchStrategy;
+}
+export interface PrefetchOptions {
+    ignoreSlowConnection?: boolean;
+    with?: "link" | "fetch";
+}
+/**
+ * Reset all module-level state. Exported for test isolation only — not part of
+ * the public API and not re-exported from any barrel.
+ */
+export declare function __resetForTests(): void;
+/**
+ * Public prefetch function. Idempotent per href.
+ */
+export declare function prefetch(url: string, opts?: PrefetchOptions): void;
+/**
+ * Initialize the prefetch module.
+ *
+ * Idempotent — multiple calls are safe. The module-level `initialized` flag
+ * ensures listeners are registered exactly once.
+ *
+ * DISABLED-FLAG CONTRACT: if `<meta name="zfb-prefetch-disabled" content="true">`
+ * is present in the document at init() time, this function is a no-op.
+ */
+export declare function init(options?: PrefetchInitOptions): void;
+//# sourceMappingURL=prefetch.d.ts.map

package/dist/client-router/prefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.d.ts","sourceRoot":"","sources":["../../src/client-router/prefetch.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAoBD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAWtC;AAqED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,IAAI,CAStE;AAyJD;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAgCxD"}