@takazudo/zfb-runtime 0.1.0-next.2

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,8DAA8D;AAC9D,uEAAuE;AACvE,EAAE;AACF,8DAA8D;AAC9D,EAAE;AACF,sCAAsC;AACtC,oBAAoB;AACpB,4EAA4E;AAC5E,iFAAiF;AACjF,QAAQ;AACR,EAAE;AACF,sCAAsC;AACtC,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAU/C,OAAO,EAAE,eAAe,EAA+B,MAAM,uBAAuB,CAAC;AAErF,2FAA2F;AAC3F,2CAA2C;AAC3C,OAAO,EAAE,YAAY,EAA0B,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,kCAAkC;AAClC,8EAA8E;AAC9E,4BAA4B;AAC5B,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAM7E,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,97 @@
+import type { FrameworkAdapter } from "./framework.js";
+import type { ContentSnapshot } from "./snapshot.js";
+/**
+ * Heading metadata emitted by the MDX `headings` export (T4). Cross-ref:
+ * `crates/zfb-content/src/mdx_jsx_emit.rs`. Optional on the page-module
+ * shape — non-MDX pages won't carry it.
+ */
+export interface PageHeading {
+    readonly depth: number;
+    readonly slug: string;
+    readonly text: string;
+}
+/**
+ * The shape every page module must export.
+ *
+ * - `default`: the JSX page component. Called with the props returned by
+ *   `getStaticProps` (if exported) or the `props` from the matching
+ *   `paths()` entry (for dynamic routes). The return value is fed straight
+ *   to the framework adapter's `renderToString`.
+ * - `prerender`: literal `false` opts a route OUT of build-time SSG (T5
+ *   contract). The page router still serves it under the embedded V8 host
+ *   so dev mode behaves identically; SSG callers filter the route list before
+ *   driving the renderer.
+ * - `contentType`: optional override for non-HTML routes (e.g.
+ *   `application/xml` for `rss.xml.tsx`). Default is
+ *   `text/html; charset=utf-8`. Cross-ref shipped #49.
+ * - `headings`: optional list emitted by MDX (T4).
+ * - `paths`: optional dynamic-route enumerator. Called at build time by
+ *   the `__paths__` synthetic endpoint to produce the concrete URL list
+ *   for this route template. May be async. Returns an array of
+ *   `{ params, props? }` objects identical in shape to the Astro/zfb
+ *   `paths()` contract.
+ * - `getStaticProps`: optional async function for static routes that need
+ *   to fetch data at build/render time. Called once per request (before
+ *   `default`). Must return `{ props: Record<string, unknown> }`. The
+ *   returned `props` are spread into the `default` component's props.
+ */
+export interface PageModule {
+    readonly default: (props: Record<string, unknown>) => unknown;
+    readonly prerender?: boolean;
+    readonly contentType?: string;
+    readonly headings?: readonly PageHeading[];
+    readonly paths?: () => unknown[] | Promise<unknown[]>;
+    readonly getStaticProps?: () => Promise<{
+        props: Record<string, unknown>;
+    }>;
+}
+/**
+ * One page registered with the router.
+ *
+ * `route` is a Hono path pattern (e.g. `/`, `/blog/:slug`,
+ * `/blog/page/:page`). `module` is a thunk so the bundle can use code
+ * splitting if it wants to — today the bundler emits everything as one
+ * ESM file and the thunk simply returns the already-loaded module.
+ */
+export interface PageDefinition {
+    readonly route: string;
+    readonly module: () => Promise<PageModule>;
+}
+/** Options accepted by [`createPageRouter`]. */
+export interface CreatePageRouterOptions {
+    /** Pages to register. Order does not affect routing — Hono dispatches by path. */
+    readonly pages: readonly PageDefinition[];
+    /**
+     * In-memory content snapshot. Embedded into the bundle by T3; the
+     * router hands it to `zfb/content` so user pages reading content via
+     * `getCollection(...)` resolve synchronously from memory.
+     */
+    readonly contentSnapshot: ContentSnapshot;
+    /** Framework adapter pinning the SSR call. */
+    readonly framework: FrameworkAdapter;
+}
+/**
+ * Fetch-handler shape returned by [`createPageRouter`]. Shaped as a plain
+ * function (not a Hono `app`) so the consumer's contract is exactly
+ * "Worker-style fetch handler" with no leaked framework types.
+ */
+export type PageRouter = (request: Request) => Promise<Response>;
+/**
+ * Build a page router for the SSG-first architecture (ADR-005).
+ *
+ * Side effects:
+ *   1. Registers `opts.contentSnapshot` with the `zfb/content` module so
+ *      `getCollection(name)` resolves from memory. Idempotent across
+ *      calls — the latest snapshot wins (matches the documented dev-mode
+ *      live-reload contract).
+ *   2. Constructs an internal Hono app and registers a GET handler per
+ *      `pages[i].route`. The handler imports the page module, calls
+ *      `framework.renderToString(module.default({}))`, and returns the
+ *      string in a `Response` with the appropriate `Content-Type`.
+ *
+ * The returned function is a plain `(request) => Promise<Response>` so a
+ * Worker entry point can `export default { fetch: createPageRouter(...) }`
+ * directly.
+ */
+export declare function createPageRouter(opts: CreatePageRouterOptions): PageRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAMrD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CAC7E;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5C;AAED,gDAAgD;AAChD,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAejE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,UAAU,CA0P1E"}

package/dist/router.js

@@ -0,0 +1,318 @@
+// `@takazudo/zfb-runtime` — Hono-based page router.
+//
+// `createPageRouter` is the JS-side entry point for ADR-007's SSG-first
+// architecture. The pipeline goes:
+//
+//   user pages/ + content/ + layouts/ + components/
+//     → esbuild bundle (T3)            // single ESM file
+//     → embedded V8 host (T6)          // same WinterCG surface as CF Workers
+//     → createPageRouter({ pages, contentSnapshot, framework })
+//     → (request) => Promise<Response>
+//
+// The bundle's Worker entry point shape is documented in the package
+// README. The contract is intentionally minimal: one factory call returns
+// one fetch handler. Hono is an implementation detail — callers should
+// not depend on the Hono types leaking through. The exposed surface is
+// the four types here plus the `createPageRouter` function.
+//
+// Side effect on init: registers the supplied `ContentSnapshot` with
+// `zfb/content`'s module-level snapshot bridge so any page module
+// importing `getCollection("...")` resolves from memory rather than
+// touching the Node `fs` API (the Worker runtime has no `fs`).
+//
+// ## Synthetic `__paths__` endpoint
+//
+// The Rust build pipeline needs to evaluate non-literal `paths()` exports
+// (e.g. those that `await import("@takazudo/zfb/content")` and call `getCollection`)
+// at runtime against the running embedded host. The router exposes a
+// synthetic internal endpoint:
+//
+//   GET /__paths__/<percent-encoded-route-key>
+//
+// When a page registered at `route` has a `paths` export, the handler calls
+// it and returns the JSON-serialized array as `application/json`. If the
+// `paths` export is missing or throws, the response is a descriptive 500.
+// This endpoint is only meant for the build pipeline — it is safe to leave
+// registered in production because no user-authored route should start with
+// `/__paths__/` (the build pipeline rejects any route that conflicts).
+import { Hono } from "hono";
+import { setContentSnapshot } from "@takazudo/zfb/content";
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Default content-type when a page module does not override.
+ *
+ * Aligned with #49's per-page `contentType` convention: the default
+ * served for HTML pages is `text/html; charset=utf-8`. Tests pin this
+ * verbatim because the embedded V8 host does NOT auto-set a charset.
+ */
+const DEFAULT_CONTENT_TYPE = "text/html; charset=utf-8";
+/**
+ * Build a page router for the SSG-first architecture (ADR-005).
+ *
+ * Side effects:
+ *   1. Registers `opts.contentSnapshot` with the `zfb/content` module so
+ *      `getCollection(name)` resolves from memory. Idempotent across
+ *      calls — the latest snapshot wins (matches the documented dev-mode
+ *      live-reload contract).
+ *   2. Constructs an internal Hono app and registers a GET handler per
+ *      `pages[i].route`. The handler imports the page module, calls
+ *      `framework.renderToString(module.default({}))`, and returns the
+ *      string in a `Response` with the appropriate `Content-Type`.
+ *
+ * The returned function is a plain `(request) => Promise<Response>` so a
+ * Worker entry point can `export default { fetch: createPageRouter(...) }`
+ * directly.
+ */
+export function createPageRouter(opts) {
+    setContentSnapshot(opts.contentSnapshot);
+    const app = new Hono();
+    // Build a lookup map: Hono route pattern → PageDefinition, for the
+    // `__paths__` synthetic endpoint below. The map is keyed on the `route`
+    // string exactly as the caller supplied it (e.g. "/blog/:slug").
+    const pagesByRoute = new Map();
+    for (const page of opts.pages) {
+        pagesByRoute.set(page.route, page);
+    }
+    // Sanity check: a user-authored route that happens to start with
+    // `/__paths__` (or a top-level catchall like `/:slug{.+}`) would
+    // shadow the synthetic endpoint registered below if Hono dispatched
+    // by registration order. We register `/__paths__/:routeKey{.+}` first
+    // (see directly below) but still warn on collisions so users do not
+    // ship a page that conflicts with the build pipeline's wire format.
+    for (const page of opts.pages) {
+        if (routeShadowsPathsEndpoint(page.route)) {
+            // Use console.warn so the message reaches the host's tail logs
+            // without bringing down the worker. The build pipeline's
+            // /__paths__ requests still resolve correctly because the
+            // synthetic handler is registered first.
+            // eslint-disable-next-line no-console
+            console.warn(`[zfb-runtime] route "${page.route}" may shadow the synthetic /__paths__ endpoint; rename the page or use a more specific pattern`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Synthetic `/__paths__/<encoded-route-key>` endpoint.
+    //
+    // Called by the Rust build pipeline (crates/zfb/src/render_pipeline.rs)
+    // to evaluate non-literal `paths()` exports at runtime. The route key is
+    // the Hono pattern for the page (e.g. `/blog/:slug`) percent-encoded so
+    // it survives in the URL path segment. The response is a JSON array of
+    // `{ params, props? }` objects identical to the `paths()` contract.
+    //
+    // Pattern: `/__paths__/:routeKey{.+}` — the `{.+}` quantifier (Hono's
+    // regex-segment syntax) allows slashes inside the route key so
+    // `/blog/:slug` decodes correctly from `/__paths__/%2Fblog%2F%3Aslug`.
+    //
+    // IMPORTANT: this handler is registered BEFORE user routes so a
+    // user-authored top-level catchall (e.g. `/:wildcard{.+}`) cannot
+    // shadow it — Hono dispatches in registration order.
+    // -------------------------------------------------------------------------
+    app.get("/__paths__/:routeKey{.+}", async (c) => {
+        // Hono's `c.req.param("routeKey")` already URL-decodes the captured
+        // segment when it contains a `%`, so a single decode is correct
+        // here — no explicit `decodeURIComponent` (that would be a
+        // double-decode and break literal `%` characters in route keys).
+        const routeKey = c.req.param("routeKey");
+        const page = pagesByRoute.get(routeKey);
+        if (!page) {
+            return c.body(`[zfb-runtime] /__paths__: no page registered for route key "${routeKey}"`, 404, { "Content-Type": "text/plain; charset=utf-8" });
+        }
+        const mod = await page.module();
+        if (typeof mod.paths !== "function") {
+            return c.body(`[zfb-runtime] /__paths__: page module for "${routeKey}" has no paths() export`, 404, { "Content-Type": "text/plain; charset=utf-8" });
+        }
+        let result;
+        try {
+            result = await mod.paths();
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return c.body(`[zfb-runtime] /__paths__: paths() threw for "${routeKey}": ${msg}`, 500, {
+                "Content-Type": "text/plain; charset=utf-8",
+            });
+        }
+        return c.body(JSON.stringify(result), 200, {
+            "Content-Type": "application/json; charset=utf-8",
+        });
+    });
+    for (const page of opts.pages) {
+        // `app.all` (vs `app.get`) so SSR routes whose page handler dispatches
+        // by `request.method` (e.g. POST API endpoints like
+        // `pages/api/*.tsx`) actually reach the handler. The handler is then
+        // responsible for returning a method-appropriate status (e.g. 405 for
+        // an unsupported verb). With `app.get` the inner router would 404
+        // before the handler ever ran, leaving e.g. `POST /api/foo` looking
+        // identical to a missing route.
+        app.all(page.route, async (c) => {
+            const mod = await page.module();
+            if (typeof mod.default !== "function") {
+                // Surface as a 500 with a well-known message rather than letting
+                // Hono swallow the error into a generic body. T6's embedded V8
+                // host log-tail / source-map plumbing is what eventually projects
+                // page-side errors back to the user's TSX line; until then the
+                // pinned message is the contract this layer ships.
+                return c.body(`[zfb-runtime] page module for "${page.route}" did not export a default component`, 500, { "Content-Type": "text/plain; charset=utf-8" });
+            }
+            // For dynamic routes that export `paths()`, look up the concrete
+            // entry for this URL by matching the URL params against the
+            // paths() results. This implements the ADR-002 contract:
+            //   paths() → [{ params, props? }]
+            //   render(url) → find matching entry → pass { params, props } to default()
+            //
+            // For static routes (no `paths()` export, no URL params), we pass
+            // an empty object — the component signature has no required props.
+            // For dynamic routes whose URL params do not match any paths()
+            // entry, we return a 404 rather than rendering with empty props.
+            const rawUrlParams = c.req.param();
+            const urlParams = (rawUrlParams ?? {});
+            const hasDynamicParams = Object.keys(urlParams).length > 0;
+            let componentInput = {};
+            if (hasDynamicParams && typeof mod.paths === "function") {
+                let pathsResult;
+                try {
+                    pathsResult = await mod.paths();
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return c.body(`[zfb-runtime] paths() threw for "${page.route}": ${msg}`, 500, {
+                        "Content-Type": "text/plain; charset=utf-8",
+                    });
+                }
+                if (!Array.isArray(pathsResult)) {
+                    return c.body(`[zfb-runtime] paths() for "${page.route}" did not return an array`, 500, {
+                        "Content-Type": "text/plain; charset=utf-8",
+                    });
+                }
+                // Validate each entry's shape per-entry rather than using a bare
+                // cast — matches the strictness the Rust pipeline applies on the
+                // same wire format. Any malformed entry surfaces as a 500.
+                for (const entry of pathsResult) {
+                    if (!isPathsEntry(entry)) {
+                        return c.body(`[zfb-runtime] paths() for "${page.route}" returned an entry without a valid params object`, 500, { "Content-Type": "text/plain; charset=utf-8" });
+                    }
+                }
+                // Find the entry whose params match the URL params for this
+                // request. For catchall params (e.g. slug for
+                // /docs/[...slug]), Hono returns a slash-joined string (e.g.
+                // "guides/install"), so we compare against the paths() entry's
+                // params.slug joined with "/".
+                const match = pathsResult.find((entry) => {
+                    return Object.entries(urlParams).every(([k, v]) => {
+                        const paramVal = entry.params[k];
+                        if (Array.isArray(paramVal)) {
+                            // catchall: paths() emits slug as string[] but Hono
+                            // provides it as a "/"-joined string
+                            return paramVal.join("/") === v;
+                        }
+                        return String(paramVal) === v;
+                    });
+                });
+                if (!match) {
+                    // The URL params do not correspond to any paths() entry —
+                    // this is the dev-mode equivalent of a build-time miss.
+                    // Hono's `c.notFound()` returns the framework's default 404,
+                    // which is cleaner than fabricating an empty-props render.
+                    return c.notFound();
+                }
+                // Pass the paths() entry's props directly as component props
+                // (spread to top level, matching the Astro/zfb convention).
+                // Also include `params` so components can access URL params if
+                // needed, but individual prop keys from `props` win on collision.
+                componentInput = {
+                    params: match.params,
+                    ...(match.props ?? {}),
+                };
+            }
+            else if (!hasDynamicParams && typeof mod.getStaticProps === "function") {
+                // Static route with `getStaticProps`: call it to fetch build-time
+                // data and pass the returned props to the default component. This
+                // supports the `export async function getStaticProps()` pattern
+                // used by static pages that need to query content collections (e.g.
+                // a homepage listing all blog posts via `getCollection("blog")`).
+                let staticPropsResult;
+                try {
+                    staticPropsResult = await mod.getStaticProps();
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return c.body(`[zfb-runtime] getStaticProps() threw for "${page.route}": ${msg}`, 500, {
+                        "Content-Type": "text/plain; charset=utf-8",
+                    });
+                }
+                if (typeof staticPropsResult !== "object" ||
+                    staticPropsResult === null ||
+                    !("props" in staticPropsResult)) {
+                    return c.body(`[zfb-runtime] getStaticProps() for "${page.route}" must return { props: {...} }`, 500, { "Content-Type": "text/plain; charset=utf-8" });
+                }
+                componentInput = staticPropsResult.props;
+            }
+            // `await` so async page modules (e.g. API routes typed as
+            // `(): Promise<Response>`) resolve before we inspect the value.
+            // For sync pages that return a VNode/string the await is a no-op.
+            const result = await mod.default(componentInput);
+            // API route short-circuit: a page module that returns a Response
+            // directly (e.g. `pages/api/*.tsx` handlers that use Web Fetch
+            // primitives instead of returning JSX) is responsible for its own
+            // status, headers, and body — return it as-is rather than running
+            // it through the framework SSR path.
+            if (result instanceof Response) {
+                return result;
+            }
+            // Non-HTML routes (e.g. `sitemap.xml.tsx`, `feed.xml.tsx`) commonly
+            // return their body as a pre-serialised `string` instead of a
+            // VNode. Routing those through `framework.renderToString` would
+            // HTML-escape the angle brackets and ampersands, producing
+            // garbage XML. Pass strings through verbatim; only wrap actual
+            // VNodes.
+            const html = typeof result === "string" ? result : opts.framework.renderToString(result);
+            const contentType = mod.contentType ?? DEFAULT_CONTENT_TYPE;
+            return c.body(html, 200, { "Content-Type": contentType });
+        });
+    }
+    // Hono's `app.fetch` returns `Response | Promise<Response>`. The
+    // public router contract is unconditionally async; using an `async`
+    // wrapper (rather than `Promise.resolve(...)`) ensures any
+    // synchronous throw inside `app.fetch` is converted to a rejected
+    // promise instead of escaping the caller's `await`.
+    return async (request) => await app.fetch(request);
+}
+/**
+ * Type guard for one `paths()` entry. Mirrors the strictness of the
+ * Rust pipeline's `paths()` resolver — every entry must be a non-null
+ * object whose `params` is itself a non-null object.
+ */
+function isPathsEntry(x) {
+    if (typeof x !== "object" || x === null)
+        return false;
+    const params = x.params;
+    return typeof params === "object" && params !== null;
+}
+/**
+ * Heuristic check for user-authored routes that may shadow the
+ * synthetic `/__paths__/<encoded-route-key>` endpoint.
+ *
+ * Returns true when the route literal contains `/__paths__` (an
+ * obvious collision) or when its first segment is a Hono catchall
+ * (`:name{.+}`) or a file-system catchall (`[...name]`) at the root —
+ * those would match `/__paths__/...` once Hono dispatches to them.
+ */
+function routeShadowsPathsEndpoint(route) {
+    if (route.includes("/__paths__")) {
+        return true;
+    }
+    // Strip the leading slash and look at the first segment only —
+    // anything deeper cannot match `/__paths__` because the literal
+    // first segment differs.
+    const firstSeg = route.replace(/^\/+/, "").split("/")[0] ?? "";
+    // Hono regex-quantifier catchall: `:name{.+}`.
+    if (/^:[A-Za-z_][\w]*\{\.[+*]\}$/.test(firstSeg)) {
+        return true;
+    }
+    // File-system catchall (pre-bracket-to-hono): `[...name]`.
+    if (/^\[\.\.\.[A-Za-z_][\w]*\]$/.test(firstSeg)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/snapshot.d.ts

@@ -0,0 +1,38 @@
+/**
+ * One entry in a content collection, in the shape the JS bridge sees.
+ *
+ * Mirrors `crates/zfb-content/src/content_bridge.rs::EntrySnapshot`.
+ *
+ * - `slug`: filename stem (no extension).
+ * - `frontmatter`: parsed frontmatter — `null` when the source had none.
+ *   Type-erased to `unknown` here; user pages narrow via the generic on
+ *   `getCollection<T>()`.
+ * - `body`: markdown body for `.md` / `.mdx` entries; empty string for
+ *   `.tsx` entries (TSX has no separate markdown body).
+ * - `module_specifier`: stable specifier addressing the compiled module
+ *   (`mdx://collection/slug#hash` / `tsx://collection/slug#hash`). The
+ *   bridge resolver matches either the full-with-hash form or the
+ *   no-hash form `mdx://collection/slug`.
+ * - `rel_path`: path relative to the collection root, normalized to
+ *   forward slashes so JSON is platform-stable.
+ */
+export interface EntrySnapshot {
+    readonly slug: string;
+    readonly frontmatter: unknown;
+    readonly body: string;
+    readonly module_specifier: string;
+    readonly rel_path: string;
+}
+/**
+ * Point-in-time snapshot of every configured collection.
+ *
+ * Mirrors `crates/zfb-content/src/content_bridge.rs::ContentSnapshot`.
+ *
+ * Iteration order is documented as deterministic on the Rust side
+ * (collections sorted by name, entries sorted by slug). The snapshot
+ * delivered to JS preserves that order via stable JSON serialization.
+ */
+export interface ContentSnapshot {
+    readonly collections: Readonly<Record<string, readonly EntrySnapshot[]>>;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC,CAAC,CAAC;CAC1E"}

package/dist/snapshot.js

@@ -0,0 +1,16 @@
+// `@takazudo/zfb-runtime/snapshot` — TypeScript mirror of the Rust
+// `ContentSnapshot` contract.
+//
+// The canonical shape lives in Rust at `crates/zfb-content/src/content_bridge.rs`
+// (see `ContentSnapshot` and `EntrySnapshot`). The build-time pipeline
+// constructs the snapshot, serializes it to JSON, and embeds it in the
+// Worker bundle that the embedded V8 host loads. At Worker boot the embedded value
+// is handed to [`createPageRouter`] (re-exported from the package root),
+// which registers it with the `zfb/content` module so user pages calling
+// `getCollection("blog")` resolve from memory rather than from the
+// filesystem.
+//
+// Keep this in sync with the Rust struct. Field names are snake_case to
+// match the JSON serialization (`module_specifier`, `rel_path`).
+export {};
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,8BAA8B;AAC9B,EAAE;AACF,kFAAkF;AAClF,uEAAuE;AACvE,uEAAuE;AACvE,mFAAmF;AACnF,yEAAyE;AACzE,yEAAyE;AACzE,mEAAmE;AACnE,cAAc;AACd,EAAE;AACF,wEAAwE;AACxE,iEAAiE"}

package/dist/view-transitions.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Public element shape — kept structural so consumers don't infer through
+ * either framework's internal VNode type. Matches the shape `Island`
+ * returns from `@takazudo/zfb`.
+ */
+export type ViewTransitionsElement = {
+    readonly type: string;
+    readonly props: Readonly<Record<string, unknown>>;
+    readonly key: unknown;
+};
+/**
+ * `<ViewTransitions />` — DEPRECATED: this component is now a typed
+ * no-op. Cross-document View Transitions are opted in via the
+ * `@view-transition { navigation: auto; }` CSS at-rule, NOT via this
+ * component. Add the at-rule to your top-level stylesheet (outside
+ * any `@layer` block — see https://developer.mozilla.org/en-US/docs/Web/CSS/@view-transition).
+ *
+ * The export is kept so consumers' existing `<ViewTransitions />`
+ * mounts compile unchanged.
+ *
+ * The previous implementation injected an inline router IIFE that
+ * called `event.preventDefault()` and `document.startViewTransition`
+ * around `window.location.href = url`. That pattern is INCOMPATIBLE
+ * with cross-document VT: Chromium treats the script reload as
+ * excluded from `auto`, so no `::view-transition-*` pseudo-elements
+ * ever materialize. See
+ * https://developer.chrome.com/docs/web-platform/view-transitions/cross-document.
+ *
+ * @deprecated The runtime injection is removed. Use the
+ * `@view-transition` CSS at-rule on both source and destination
+ * documents.
+ */
+export declare function ViewTransitions(): readonly ViewTransitionsElement[];
+//# sourceMappingURL=view-transitions.d.ts.map

package/dist/view-transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-transitions.d.ts","sourceRoot":"","sources":["../src/view-transitions.ts"],"names":[],"mappings":"AA6BA;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,IAAI,SAAS,sBAAsB,EAAE,CAEnE"}

package/dist/view-transitions.js

@@ -0,0 +1,54 @@
+// `@takazudo/zfb-runtime` — `<ViewTransitions />` component (typed no-op).
+//
+// For SPA soft-swap navigation with view-transition animation, use `<ClientRouter />`
+// from this package — see `./client-router.ts`.
+//
+// Originally mirrored Astro's `<ViewTransitions />` integration by injecting
+// (a) a `<meta name="view-transition" content="same-origin">` opt-in tag and
+// (b) an inline client-router IIFE that intercepted same-origin `<a>` clicks
+// and ran navigations through `document.startViewTransition`.
+//
+// Both pieces have since been deleted. The browser story moved on:
+//
+//   - The meta-tag opt-in was a temporary experiment during Chromium's
+//     cross-document VT spec development. It has been superseded by the
+//     `@view-transition { navigation: auto; }` CSS at-rule (per MDN and
+//     https://developer.chrome.com/docs/web-platform/view-transitions/cross-document)
+//     and is no longer honoured by browsers that ship cross-document VT.
+//   - The click-intercept IIFE was actively harmful: it called
+//     `event.preventDefault()` and ran `window.location.href = url` inside
+//     `document.startViewTransition`. Chromium treats that script reload as
+//     EXCLUDED from the `auto` navigation type, so no `::view-transition-*`
+//     pseudo-elements ever materialise. The "router" prevented the very
+//     feature it claimed to enable.
+//
+// Cross-document View Transitions are now opted in via the
+// `@view-transition { navigation: auto; }` CSS at-rule on both the source
+// and destination documents. This component is a typed no-op kept so that
+// existing `<ViewTransitions />` mounts compile unchanged.
+/**
+ * `<ViewTransitions />` — DEPRECATED: this component is now a typed
+ * no-op. Cross-document View Transitions are opted in via the
+ * `@view-transition { navigation: auto; }` CSS at-rule, NOT via this
+ * component. Add the at-rule to your top-level stylesheet (outside
+ * any `@layer` block — see https://developer.mozilla.org/en-US/docs/Web/CSS/@view-transition).
+ *
+ * The export is kept so consumers' existing `<ViewTransitions />`
+ * mounts compile unchanged.
+ *
+ * The previous implementation injected an inline router IIFE that
+ * called `event.preventDefault()` and `document.startViewTransition`
+ * around `window.location.href = url`. That pattern is INCOMPATIBLE
+ * with cross-document VT: Chromium treats the script reload as
+ * excluded from `auto`, so no `::view-transition-*` pseudo-elements
+ * ever materialize. See
+ * https://developer.chrome.com/docs/web-platform/view-transitions/cross-document.
+ *
+ * @deprecated The runtime injection is removed. Use the
+ * `@view-transition` CSS at-rule on both source and destination
+ * documents.
+ */
+export function ViewTransitions() {
+    return [];
+}
+//# sourceMappingURL=view-transitions.js.map

package/dist/view-transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-transitions.js","sourceRoot":"","sources":["../src/view-transitions.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,sFAAsF;AACtF,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,EAAE;AACF,mEAAmE;AACnE,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,sFAAsF;AACtF,yEAAyE;AACzE,+DAA+D;AAC/D,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,wEAAwE;AACxE,oCAAoC;AACpC,EAAE;AACF,2DAA2D;AAC3D,0EAA0E;AAC1E,0EAA0E;AAC1E,2DAA2D;AAa3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,CAAC;AACZ,CAAC"}