@nifrajs/web 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nifra Authors
+
+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,18 @@
+# @nifrajs/web
+
+Framework-agnostic SSR core for nifra — the render seam + HTML document orchestration.
+
+Part of the **[nifra](https://nifra.dev)** full-stack TypeScript framework — one core, five UI libraries, every runtime. Scaffold a new app with `bun create nifra`.
+
+## Install
+
+```sh
+bun add @nifrajs/web
+```
+
+## Docs
+
+- Reference: <https://nifra.dev/docs>
+- AI-readable: <https://nifra.dev/llms.txt>
+
+MIT

package/css-modules.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Ambient types for CSS asset imports handled by the `@nifrajs/web/plugins/*` Bun plugins
+ * (`css-modules` + `scss`).
+ *
+ * Add to your app so the imports below are typed. Either reference it from a `.d.ts` in your project:
+ *
+ * ```ts
+ * /// <reference types="@nifrajs/web/css-modules" />
+ * ```
+ *
+ * or list it in `tsconfig.json` → `compilerOptions.types: ["@nifrajs/web/css-modules"]`.
+ */
+
+/** CSS Modules (`*.module.css`) → the scoped `{ originalClassName: scopedClassName }` map. */
+declare module "*.module.css" {
+  /** Keys are the source class names (asIs convention). */
+  const classes: Readonly<Record<string, string>>
+  export default classes
+}
+
+/** SCSS/SASS Modules (`*.module.scss` / `*.module.sass`) → the scoped class map (same as above). */
+declare module "*.module.scss" {
+  const classes: Readonly<Record<string, string>>
+  export default classes
+}
+declare module "*.module.sass" {
+  const classes: Readonly<Record<string, string>>
+  export default classes
+}
+
+// Plain stylesheet imports are side-effect only (`import "./styles.scss"`); they bundle the CSS and
+// expose no bindings. Declared so the import resolves under TypeScript.
+declare module "*.scss" {}
+declare module "*.sass" {}

package/dist/build.d.ts

@@ -0,0 +1,110 @@
+import type { BunPlugin } from "bun";
+export { type CloudflarePagesRoutes, type CloudflarePagesRoutesOptions, cloudflarePagesRoutes, dataFileFor, htmlFileFor, type PrerenderApp, type PrerenderEntry, type PrerenderOptions, type PrerenderResult, prerenderRoutes, } from "./prerender.js";
+export interface BuildClientOptions {
+    /** The `routes/` directory to discover (absolute path). */
+    readonly routesDir: string;
+    /** Output directory for the bundle + `manifest.json` (absolute path). */
+    readonly outDir: string;
+    /** The adapter's client runtime (exports `mountRouter`), e.g. `"@nifrajs/web-solid/client"`. */
+    readonly clientModule: string;
+    /** Route/layout file → import specifier (default: `${routesDir}/${file}`). */
+    readonly resolve?: (file: string) => string;
+    /** Adapter build plugins (e.g. `solidBunPlugin("dom")`). */
+    readonly plugins?: readonly BunPlugin[];
+    /** `Bun.build` export conditions (e.g. `["bun", "solid", "browser"]`). */
+    readonly conditions?: readonly string[];
+    /** Compile-time replacements (e.g. `{ "process.env.NODE_ENV": '"production"' }`). */
+    readonly define?: Readonly<Record<string, string>>;
+    /** Minify the output (default `true`). */
+    readonly minify?: boolean;
+    /** URL prefix the assets are served under (default `"/assets/"`); also Bun's chunk `publicPath`. */
+    readonly publicPath?: string;
+}
+/** The built asset map — the server reads `entry` for the client script + serves `assets`. */
+export interface BuildManifest {
+    /** URL of the client entry module (content-hashed). */
+    readonly entry: string;
+    /** URLs of every emitted asset (entry + chunks) — for serving + preloading. */
+    readonly assets: readonly string[];
+    /** `routeId → [layout chunk URLs…, own chunk URL]` — the chunks a route needs, for `createWebApp`'s
+     * `routePreload` (`<link rel="modulepreload">` the matched route alongside the entry). Each route +
+     * layout is also a build entrypoint, so it gets a named chunk the bootstrap's lazy import dedupes to. */
+    readonly routes: Readonly<Record<string, readonly string[]>>;
+    /** The app's bundled, content-hashed stylesheet(s) — the bootstrap's **aggregate** CSS (every
+     * `import './x.css'` reachable from the app). The complete stylesheet regardless of which file
+     * imported the CSS; the always-safe fallback `createWebApp` links when a route has no per-route entry
+     * in {@link routeStyles}. Omitted when the app imports no CSS. */
+    readonly css?: readonly string[];
+    /** `routeId → [chain CSS URLs]` — only the stylesheets the matched route's layout chain + own file
+     * actually use (Bun emits a per-entrypoint CSS bundle per route/layout, with shared-component CSS
+     * inlined into each consumer). `createWebApp` links these instead of the aggregate, so a page ships
+     * only its own CSS. A route is omitted (→ aggregate fallback) when its `[name]` collides with another
+     * route's basename (ambiguous CSS↔route) or the build emitted orphan shared-chunk CSS — correctness
+     * over minimality. Absent entirely when the app imports no CSS. */
+    readonly routeStyles?: Readonly<Record<string, readonly string[]>>;
+}
+/**
+ * Build the client bundle for a file-routed app. Writes the hashed assets + `manifest.json` to
+ * `outDir` and returns the manifest. Throws (with the bundler logs) on build failure — never
+ * silently ships a broken bundle.
+ */
+export declare function buildClient(options: BuildClientOptions): Promise<BuildManifest>;
+export interface BuildServerOptions {
+    /** The `routes/` directory to discover (absolute path). */
+    readonly routesDir: string;
+    /** The worker entry module (absolute path) — your `worker.ts`. It imports `{ manifest, clientEntry }`
+     * from the generated `./server-manifest`, builds `createWebApp`, and `export default toFetchHandler(app)`. */
+    readonly serverEntry: string;
+    /** Output directory for the bundled worker (absolute path). */
+    readonly outDir: string;
+    /** The content-hashed client entry URL (from `buildClient`'s manifest) — **baked** into the generated
+     * server manifest, since a disk-less worker can't read `manifest.json` at runtime. */
+    readonly clientEntry: string;
+    /** Route/layout file → import specifier in the generated manifest (default: a relative path from the
+     * manifest's location — written next to `serverEntry` — to `routesDir`). */
+    readonly resolve?: (file: string) => string;
+    /** Filename for the generated server-manifest module, written next to `serverEntry` (default
+     * `"server-manifest.ts"`); your `serverEntry` imports it as `./server-manifest`. */
+    readonly manifestFile?: string;
+    /** Adapter build plugins (e.g. `solidBunPlugin("ssr")` — Solid routes need their SSR transform at
+     * build time; React's JSX is Bun-native and needs none). */
+    readonly plugins?: readonly BunPlugin[];
+    /** `Bun.build` resolution conditions (default `["workerd", "edge-light", "browser"]`) — selects each
+     * dependency's edge build. */
+    readonly conditions?: readonly string[];
+    /** Compile-time replacements (default `{ "process.env.NODE_ENV": '"production"' }` → production
+     * React/Solid on the edge). Pass an explicit object to override (e.g. `{}` to opt out). */
+    readonly define?: Readonly<Record<string, string>>;
+    /** Minify the output (default `true`). */
+    readonly minify?: boolean;
+    /** `Bun.build` target (default `"browser"` — the right shape for edge runtimes: Cloudflare Workers,
+     * Vercel Edge, Deno, Deno Deploy). Use `"node"` for a `@nifrajs/node` server (so `node:*` built-ins
+     * stay external), or `"bun"` for a Bun server. The default `conditions` + the edge resolve shims
+     * only apply to the `"browser"` target; `"node"`/`"bun"` resolve their own renderer builds via the
+     * matching condition. */
+    readonly target?: "browser" | "node" | "bun";
+    /** **Lazy/code-split routes** (default `false`): emit `() => import(route)` loaders + bundle with
+     * `splitting`, so each route is its own chunk loaded on first request (smaller cold-start parse)
+     * instead of all parsed at boot. The output becomes the worker entry **+ chunk files** in `outDir`
+     * — on Cloudflare, ship them with wrangler's `no_bundle` + `find_additional_modules` + an ESModule
+     * `rule` (Node/Deno import the chunks natively). Eager (one self-contained file) stays the default. */
+    readonly lazy?: boolean;
+}
+/** The built worker bundle — point your `wrangler.toml`'s `main` at `worker`. */
+export interface ServerBuild {
+    /** Path to the bundled, self-contained worker entry. */
+    readonly worker: string;
+    /** Paths of every emitted output (entry + any code-split chunks) — what to ship to the platform. */
+    readonly outputs: readonly string[];
+}
+/**
+ * Build a self-contained **worker bundle** for a file-routed app on a disk-less edge (Cloudflare
+ * Workers / workerd). Discovers routes (build-time fs), codegens the static-import server manifest
+ * (`generateServerManifest`, written next to `serverEntry`), then bundles `serverEntry` with
+ * `Bun.build` using **edge conditions** + the adapter's SSR plugins. The output imports no `node:fs`
+ * and does no dynamic-path import, so it runs on workerd: point `wrangler.toml`'s `main` at it and
+ * serve the client assets via Workers Assets. Throws (with the bundler logs) on failure — never
+ * silently ships a broken worker.
+ */
+export declare function buildServer(options: BuildServerOptions): Promise<ServerBuild>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

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

package/dist/build.js

@@ -0,0 +1,238 @@
+/**
+ * `@nifrajs/web/build` — the production build (Bun-only, build-time). `buildClient` codegens + bundles
+ * the client entry (content-hashed, code-split); `buildServer` codegens the static-import server
+ * manifest + bundles a self-contained **worker** for the disk-less edge (Cloudflare Workers). Both
+ * are Bun-specific and never on the request path (own subpath, like `@nifrajs/web/fs`); the *output*
+ * runs on any runtime.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, relative, resolve as resolvePath } from "node:path";
+import { discoverRoutes } from "./fs.js";
+import { generateClientEntry, generateServerManifest } from "./index.js";
+// Build-time SSG: prerender opted-in static + dynamic routes to `index.html` (+ static `_data.json`),
+// run after `buildClient`.
+export { cloudflarePagesRoutes, dataFileFor, htmlFileFor, prerenderRoutes, } from "./prerender.js";
+const basename = (path) => path.slice(path.lastIndexOf("/") + 1);
+/** `[name]` Bun derives for an entrypoint: basename without extension (`users/[id].tsx` → `[id]`). */
+const entryName = (file) => {
+    const base = basename(file);
+    const dot = base.lastIndexOf(".");
+    return dot === -1 ? base : base.slice(0, dot);
+};
+/**
+ * Build the client bundle for a file-routed app. Writes the hashed assets + `manifest.json` to
+ * `outDir` and returns the manifest. Throws (with the bundler logs) on build failure — never
+ * silently ships a broken bundle.
+ */
+export async function buildClient(options) {
+    const { routesDir, outDir, clientModule } = options;
+    const resolve = options.resolve ?? ((file) => `${routesDir}/${file}`);
+    const publicPath = options.publicPath ?? "/assets/";
+    mkdirSync(outDir, { recursive: true });
+    const routeManifest = discoverRoutes(routesDir);
+    // The bootstrap's filename is `_velo`-namespaced (not `entry.ts`) so its `[name]` can't collide with
+    // a user route named `entry.tsx` when the CSS mapping below excludes the bootstrap's aggregate CSS.
+    const entryFile = `${outDir}/_nifra-entry.ts`;
+    writeFileSync(entryFile, generateClientEntry(routeManifest, { clientModule, resolve }));
+    // Every unique route/layout/`_404` file (sorted, stable), as ADDITIONAL entrypoints — Bun emits a
+    // named chunk per file that the bootstrap's lazy `import()` dedupes to (verified), so the manifest
+    // can map each route to its chunk URLs for matched-route preload. `resolve(file)` is the same
+    // specifier the bootstrap imports, so the entrypoint + lazy import are the same module (dedup).
+    const routeFiles = [
+        ...new Set([
+            ...routeManifest.routes.map((r) => r.file),
+            ...Object.values(routeManifest.layouts).map((l) => l.file),
+            ...(routeManifest.notFound ? [routeManifest.notFound.file] : []),
+        ]),
+    ].sort();
+    // `metafile: true` asks Bun for the input/output graph — specifically `outputs[js].entryPoint`
+    // (the source file) + `outputs[js].cssBundle` (that entry's emitted stylesheet). It's the robust
+    // entry→CSS link for per-route splitting: keyed by the unique source path, so it survives
+    // same-basename collisions (`index.tsx` + `blog/index.tsx`) that a filename match can't. Not yet in
+    // `@types/bun`'s `BuildConfig`, so spread it in (spread props skip the excess-property check).
+    const buildExtras = { metafile: true };
+    const result = await Bun.build({
+        entrypoints: [entryFile, ...routeFiles.map(resolve)],
+        outdir: outDir,
+        target: "browser",
+        naming: "[name]-[hash].[ext]",
+        publicPath,
+        splitting: true, // one chunk per lazily-imported route; shared deps deduped into shared chunks
+        // `import "./x.css"` in a route/component → bundled, minified, content-hashed `.css` asset (Bun
+        // strips the import from the JS; CSS bundling is on by default since Bun 1.2). Mapped to routes
+        // below — both the aggregate and per-route — via the metafile, for `<link>` injection.
+        ...buildExtras,
+        minify: options.minify ?? true,
+        plugins: [...(options.plugins ?? [])],
+        ...(options.conditions ? { conditions: [...options.conditions] } : {}),
+        ...(options.define ? { define: { ...options.define } } : {}),
+    });
+    if (!result.success) {
+        throw new Error(`[nifra/web] client build failed:\n${result.logs.map((l) => String(l)).join("\n")}`);
+    }
+    const toUrl = (path) => `${publicPath}${basename(path)}`;
+    // Entry-point outputs come back in entrypoint order: [bootstrap, ...routeFiles]. Map each route file
+    // to its chunk URL by that order (guarded against drift), then a route's chunks = its layout chain +
+    // own file.
+    const entryPoints = result.outputs.filter((o) => o.kind === "entry-point");
+    const bootstrap = entryPoints[0];
+    if (bootstrap === undefined)
+        throw new Error("[nifra/web] build produced no entry-point output");
+    if (entryPoints.length !== routeFiles.length + 1) {
+        throw new Error(`[nifra/web] expected ${routeFiles.length + 1} entry-point outputs (bootstrap + ${routeFiles.length} routes), got ${entryPoints.length}`);
+    }
+    const fileToChunk = new Map();
+    routeFiles.forEach((file, i) => {
+        const out = entryPoints[i + 1]; // in range — length checked above
+        if (out !== undefined)
+            fileToChunk.set(file, toUrl(out.path));
+    });
+    const chunksFor = (chainFiles) => chainFiles.map((f) => fileToChunk.get(f)).filter((u) => u !== undefined);
+    const routes = {};
+    for (const route of routeManifest.routes) {
+        routes[route.id] = chunksFor([
+            ...route.layoutIds.map((id) => routeManifest.layouts[id]?.file ?? ""),
+            route.file,
+        ]);
+    }
+    if (routeManifest.notFound)
+        routes._404 = chunksFor([routeManifest.notFound.file]);
+    // CSS — aggregate: an `import "./x.css"` anywhere → a content-hashed `.css` asset (Bun strips the
+    // import from the JS). The bootstrap lazily imports every route, so its **aggregate** stylesheet is
+    // the whole app's CSS — the always-safe fallback `createWebApp` links when a route has no per-route
+    // entry below. Fallback to all CSS assets if Bun emitted no distinct aggregate.
+    const bootstrapName = entryName(entryFile); // `_nifra-entry`
+    const cssNameOf = (path) => {
+        const base = basename(path);
+        return base.slice(0, base.lastIndexOf("-")); // strip `-${hash}.css`
+    };
+    const cssAssets = result.outputs.filter((o) => o.kind === "asset" && o.path.endsWith(".css"));
+    const aggregate = cssAssets
+        .filter((o) => cssNameOf(o.path) === bootstrapName)
+        .map((o) => toUrl(o.path));
+    const css = aggregate.length > 0 ? aggregate : cssAssets.map((o) => toUrl(o.path));
+    // CSS — per-route: each route/layout file is its own entrypoint, so the build metafile records its
+    // `cssBundle` — exactly the CSS that file's subtree uses (shared-component CSS is inlined into each
+    // consumer; verified). Keyed by the metafile's unique source `entryPoint`, so it survives
+    // same-basename collisions (`index.tsx` + `blog/index.tsx`) that a filename match can't. A page then
+    // links only its layout chain + own CSS (deduped); an empty array means the page needs no CSS at all.
+    // Absent (→ aggregate fallback) only if Bun emits no metafile/cssBundle — never silently incomplete.
+    const meta = result.metafile;
+    const cwd = process.cwd();
+    const cssByEntry = new Map();
+    for (const out of Object.values(meta?.outputs ?? {})) {
+        if (out.entryPoint !== undefined && out.cssBundle !== undefined) {
+            cssByEntry.set(resolvePath(cwd, out.entryPoint), toUrl(out.cssBundle));
+        }
+    }
+    const stylesFor = (chainFiles) => {
+        const urls = chainFiles
+            .map((f) => (f ? cssByEntry.get(resolvePath(resolve(f))) : undefined))
+            .filter((u) => u !== undefined);
+        return [...new Set(urls)];
+    };
+    const routeStyles = {};
+    if (css.length > 0 && cssByEntry.size > 0) {
+        for (const route of routeManifest.routes) {
+            routeStyles[route.id] = stylesFor([
+                ...route.layoutIds.map((id) => routeManifest.layouts[id]?.file ?? ""),
+                route.file,
+            ]);
+        }
+        if (routeManifest.notFound)
+            routeStyles._404 = stylesFor([routeManifest.notFound.file]);
+    }
+    const manifest = {
+        entry: toUrl(bootstrap.path),
+        assets: result.outputs.map((o) => toUrl(o.path)),
+        routes,
+        ...(css.length > 0 ? { css } : {}),
+        ...(Object.keys(routeStyles).length > 0 ? { routeStyles } : {}),
+    };
+    writeFileSync(`${outDir}/manifest.json`, JSON.stringify(manifest, null, 2));
+    return manifest;
+}
+/**
+ * react-dom's `exports["./server"]` maps the `bun` condition to a Bun-API server build that crashes
+ * on workerd, and `Bun.build` always applies the `bun` condition (it wins over `workerd`/`edge-light`),
+ * so conditions alone can't select the edge build. This shim pins `react-dom/server` to its edge build
+ * (`server.edge.js`, which exports `renderToReadableStream`). A no-op when nothing imports react-dom
+ * (e.g. a Solid worker) — the resolver only runs on a match.
+ */
+const reactDomEdgePlugin = (from) => ({
+    name: "nifra-react-dom-edge",
+    setup(build) {
+        build.onResolve({ filter: /^react-dom\/server$/ }, () => ({
+            path: Bun.resolveSync("react-dom/server.edge", from),
+        }));
+    },
+});
+/**
+ * `solid-js/web` selects its **server** runtime (`renderToStream`) via the `worker` condition, but
+ * `Bun.build` 1.3.14 **segfaults** when the `worker` condition is active (https://bun.report). And
+ * without `worker`, `browser` (which precedes the other server conditions in solid's exports map)
+ * wins → the *dom* runtime, which can't SSR. So this shim pins `solid-js/web` straight to its server
+ * build, sidestepping the crashing condition. Lazy (resolved on match) + a no-op when nothing imports
+ * `solid-js/web` (e.g. a React worker). Drop it (and use the `worker` condition) once Bun is fixed.
+ */
+const solidWebServerPlugin = (from) => ({
+    name: "nifra-solid-web-server",
+    setup(build) {
+        build.onResolve({ filter: /^solid-js\/web$/ }, () => {
+            // solid's `worker`/`node`/`deno` conditions all map to ./web/dist/server.js (its server build).
+            const pkg = Bun.resolveSync("solid-js/package.json", from);
+            return { path: pkg.replace(/package\.json$/, "web/dist/server.js") };
+        });
+    },
+});
+/**
+ * Build a self-contained **worker bundle** for a file-routed app on a disk-less edge (Cloudflare
+ * Workers / workerd). Discovers routes (build-time fs), codegens the static-import server manifest
+ * (`generateServerManifest`, written next to `serverEntry`), then bundles `serverEntry` with
+ * `Bun.build` using **edge conditions** + the adapter's SSR plugins. The output imports no `node:fs`
+ * and does no dynamic-path import, so it runs on workerd: point `wrangler.toml`'s `main` at it and
+ * serve the client assets via Workers Assets. Throws (with the bundler logs) on failure — never
+ * silently ships a broken worker.
+ */
+export async function buildServer(options) {
+    const { routesDir, serverEntry, outDir, clientEntry } = options;
+    const entryDir = dirname(serverEntry);
+    const manifestFile = options.manifestFile ?? "server-manifest.ts";
+    // Default: import routes relative from the generated manifest (next to serverEntry) to routesDir.
+    const rel = relative(entryDir, routesDir).replaceAll("\\", "/");
+    const resolve = options.resolve ?? ((file) => `./${rel}/${file}`);
+    mkdirSync(outDir, { recursive: true });
+    const lazy = options.lazy ?? false;
+    const target = options.target ?? "browser";
+    // Edge (browser) target: Bun's `bun` condition contaminates react-dom's server build + the `worker`
+    // condition segfaults Bun.build on solid, so force the edge/server builds via shims. The `node`/`bun`
+    // targets resolve those correctly via their own condition, so the shims (and edge conditions) don't
+    // apply — defaults become `[target]` (e.g. react-dom → server.node.js under `node`).
+    const edge = target === "browser";
+    const conditions = options.conditions ?? (edge ? ["workerd", "edge-light", "browser"] : [target]);
+    const manifest = discoverRoutes(routesDir);
+    writeFileSync(`${entryDir}/${manifestFile}`, generateServerManifest(manifest, { resolve, clientEntry, lazy }));
+    const result = await Bun.build({
+        entrypoints: [serverEntry],
+        outdir: outDir,
+        target,
+        conditions: [...conditions],
+        define: { ...(options.define ?? { "process.env.NODE_ENV": '"production"' }) },
+        minify: options.minify ?? true,
+        // Lazy → one chunk per route (loaded on first request); eager → a single self-contained file.
+        splitting: lazy,
+        plugins: [
+            ...(edge ? [reactDomEdgePlugin(entryDir), solidWebServerPlugin(entryDir)] : []),
+            ...(options.plugins ?? []),
+        ],
+    });
+    if (!result.success) {
+        throw new Error(`[nifra/web] server build failed:\n${result.logs.map((l) => String(l)).join("\n")}`);
+    }
+    const entryOutput = result.outputs.find((o) => o.kind === "entry-point");
+    if (entryOutput === undefined) {
+        throw new Error("[nifra/web] server build produced no entry-point output");
+    }
+    return { worker: entryOutput.path, outputs: result.outputs.map((o) => o.path) };
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `@nifrajs/web/client` — the agnostic browser layer for client-side navigation. It wires the pure
+ * router store ({@link ClientRouter}) to the browser: `pushState` on navigate, `popstate` →
+ * navigate, and delegated interception of same-origin `<a>` clicks (client transition instead of
+ * a full page load). DOM-only — never imported on the server, so the store stays SSR-safe.
+ */
+import type { Meta } from "./manifest.js";
+import type { ClientRouter } from "./router.js";
+export interface InstallHistoryOptions {
+    /** Full-page fallback when a client navigation can't proceed (default: `location.assign`). */
+    readonly fallback?: (path: string) => void;
+}
+/**
+ * Attach history + link interception to a router. Returns a teardown function that removes the
+ * listeners. A data-fetch failure during a client navigation falls back to a full-page load, so
+ * navigation degrades gracefully rather than leaving the user stuck.
+ */
+export declare function installHistory(router: ClientRouter, options?: InstallHistoryOptions): () => void;
+/**
+ * Intercept submissions of same-origin `<form method="post">` whose action targets an app route:
+ * submit via the router (no full reload — POST the action, then revalidate the active loader). On
+ * failure it falls back to a native submit, so the form still works. Returns a teardown function.
+ */
+/**
+ * Sync the document head to a route's resolved {@link Meta} on client navigation. Sets the title
+ * (when provided) and replaces the **managed** (`data-nifra`) `<meta>`/`<link>` tags — static head
+ * content (charset, hand-written tags) is never touched. SSR injects the same `data-nifra` tags, so
+ * the first navigation cleanly takes over from the server-rendered head.
+ */
+export declare function applyHead(head: Meta): void;
+export declare function installForms(router: ClientRouter): () => void;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,WAAW,qBAAqB;IACpC,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,qBAA0B,GAClC,MAAM,IAAI,CAsJZ;AAED;;;;GAIG;AACH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAW1C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,CAmB7D"}