@nifrajs/web 0.1.0-alpha.1

package/dist/manifest.js

@@ -0,0 +1,213 @@
+/**
+ * Route manifest — the fs-free heart of file-based routing. Maps route file paths to nifra
+ * router patterns + their nested layout chain. `discoverRoutes` (in `@nifrajs/web/fs`) scans
+ * the filesystem and feeds `buildManifest`; everything here is pure logic, so it stays
+ * portable (no fs, no DOM) and fully unit-testable. Edge deploys pre-build the manifest.
+ */
+// `.svelte` and `.vue` routes are supported too: their `default` export is the component and
+// `loader`/`action`/`meta` come from a module-level script block (Svelte `<script module>`, Vue's plain
+// `<script>`) as named ESM exports — the same RouteModule shape as `.tsx`. Both compile via their
+// package's Bun plugin (`@nifrajs/web-svelte/plugin`, `@nifrajs/web-vue/plugin`).
+const ROUTE_EXT = /\.(tsx|jsx|svelte|vue|mdx)$/;
+const PARAM = /^\[([A-Za-z_][A-Za-z0-9_]*)\]$/;
+const CATCH_ALL = /^\[\.\.\.([A-Za-z_][A-Za-z0-9_]*)\]$/;
+// An optional dynamic segment: `[[lang]]` matches with OR without the segment. It expands a file into
+// two patterns (`:lang` present / absent), so `[[lang]]/about` serves both `/about` and `/en/about`.
+const OPTIONAL = /^\[\[([A-Za-z_][A-Za-z0-9_]*)\]\]$/;
+// A route group: a `(name)` folder organizes routes (and can hold its own `_layout`) without
+// contributing a URL segment — mirrors Next/Remix. Requires content between the parens.
+const GROUP = /^\(.+\)$/;
+const stripExt = (file) => file.replace(ROUTE_EXT, "");
+const baseName = (file) => file.slice(file.lastIndexOf("/") + 1);
+const dirOf = (file) => file.includes("/") ? file.slice(0, file.lastIndexOf("/")) : "";
+const layoutIdFor = (dir) => (dir === "" ? "_layout" : `${dir}/_layout`);
+const errorIdFor = (dir) => (dir === "" ? "_error" : `${dir}/_error`);
+/**
+ * Derive **every** nifra router pattern a route file maps to (relative to the routes dir):
+ * `index` → the parent path, `[id]` → `:id`, `[...slug]` → `*slug` (catch-all, captures the rest of
+ * the path into one param), `(group)` folders are dropped from the URL (organization only), and an
+ * optional `[[lang]]` expands the set — once with the segment present (`:lang`) and once absent. A file
+ * with no optionals yields exactly one pattern. Throws on an invalid param or a catch-all that isn't
+ * the last segment.
+ */
+export function filePathToPatterns(file) {
+    // Each combo is a list of URL segments built so far; an optional segment doubles the set.
+    let combos = [[]];
+    const segments = stripExt(file).split("/");
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (seg === "index")
+            continue;
+        if (GROUP.test(seg))
+            continue; // route group — no URL segment (its `_layout` still applies, keyed by dir)
+        if (seg.startsWith("[")) {
+            const catchAll = CATCH_ALL.exec(seg);
+            if (catchAll !== null) {
+                // The core router requires the wildcard to be the final segment. Enforce it at the file level
+                // (ignoring trailing `index`/`(group)`) so the error names the file, not a generated pattern.
+                const after = segments.slice(i + 1).filter((s) => s !== "index" && !GROUP.test(s));
+                if (after.length > 0) {
+                    throw new Error(`[nifra/web] catch-all "${seg}" must be the last segment in "${file}" (found "${after.join("/")}" after it)`);
+                }
+                combos = combos.map((c) => [...c, `*${catchAll[1]}`]);
+                continue;
+            }
+            const optional = OPTIONAL.exec(seg);
+            if (optional !== null) {
+                // Optional segment: keep each existing combo (absent) AND a copy with `:name` appended (present).
+                combos = combos.flatMap((c) => [c, [...c, `:${optional[1]}`]]);
+                continue;
+            }
+            const match = PARAM.exec(seg);
+            if (match === null) {
+                throw new Error(`[nifra/web] invalid route param in "${file}": "${seg}" must be [name], [[name]], [...name], or a (group) folder`);
+            }
+            combos = combos.map((c) => [...c, `:${match[1]}`]);
+        }
+        else {
+            combos = combos.map((c) => [...c, seg]);
+        }
+    }
+    return combos.map((c) => `/${c.join("/")}`);
+}
+/**
+ * The **canonical** single pattern for a route file — all optional segments present. A file with no
+ * optionals yields its one pattern. Use {@link filePathToPatterns} to get every pattern (optionals
+ * expand the set).
+ */
+export function filePathToPattern(file) {
+    const patterns = filePathToPatterns(file);
+    return patterns[patterns.length - 1];
+}
+/** The dir chain from root → the file's own dir, e.g. "a/b/p.tsx" → ["", "a", "a/b"]. */
+const ancestorDirs = (file) => {
+    const dirs = [""];
+    const dir = dirOf(file);
+    if (dir === "")
+        return dirs;
+    let acc = "";
+    for (const part of dir.split("/")) {
+        acc = acc === "" ? part : `${acc}/${part}`;
+        dirs.push(acc);
+    }
+    return dirs;
+};
+/**
+ * Build a manifest from route file paths (relative to the routes dir) + an `importer` that
+ * turns a path into a lazy module loader. Pure — no fs. Throws at boot (the loud-and-early
+ * RouteConfigError ethos) on duplicate patterns. `_layout`/`_404`/`_error` files are special; other
+ * `_`-prefixed files are ignored (private/colocated, never routed).
+ */
+export function buildManifest(files, importer) {
+    const layoutDirs = new Set();
+    const layouts = {};
+    const errorDirs = new Set();
+    const errors = {};
+    let notFound;
+    const routeFiles = [];
+    for (const file of files) {
+        const stem = stripExt(baseName(file));
+        if (stem === "_layout") {
+            const dir = dirOf(file);
+            layoutDirs.add(dir);
+            layouts[layoutIdFor(dir)] = { file, load: importer(file) };
+        }
+        else if (stem === "_error") {
+            const dir = dirOf(file);
+            errorDirs.add(dir);
+            errors[errorIdFor(dir)] = { file, load: importer(file) };
+        }
+        else if (stem === "_404") {
+            notFound = { file, load: importer(file) };
+        }
+        else if (!stem.startsWith("_")) {
+            routeFiles.push(file);
+        }
+    }
+    const byPattern = new Map();
+    const routes = [];
+    for (const file of routeFiles) {
+        const dirs = ancestorDirs(file);
+        const layoutIds = dirs.filter((dir) => layoutDirs.has(dir)).map(layoutIdFor);
+        const errorIds = dirs.filter((dir) => errorDirs.has(dir)).map(errorIdFor);
+        const id = stripExt(file);
+        const load = importer(file); // one lazy loader per file, shared by its (possibly expanded) patterns
+        // An optional `[[x]]` segment expands a file into multiple patterns, all pointing at the same
+        // module (same id/load/layout chain). Distinct patterns ⇒ no match ambiguity (different lengths).
+        for (const pattern of filePathToPatterns(file)) {
+            const existing = byPattern.get(pattern);
+            if (existing !== undefined) {
+                throw new Error(`[nifra/web] duplicate route: "${file}" and "${existing}" both map to "${pattern}"`);
+            }
+            byPattern.set(pattern, file);
+            routes.push({ id, pattern, layoutIds, errorIds, file, load });
+        }
+    }
+    const base = { routes, layouts, errors };
+    return notFound === undefined ? base : { ...base, notFound };
+}
+const FILL_PARAM = /:([A-Za-z_][A-Za-z0-9_]*)/g;
+const encodeRouteParam = (value) => {
+    const encoded = encodeURIComponent(value);
+    // `encodeURIComponent(".")` and `encodeURIComponent("..")` intentionally leave dots alone, but those
+    // are filesystem path segments during prerender output. Keep them URL-equivalent while making them
+    // inert as path components.
+    return encoded === "." || encoded === ".." ? encoded.replace(/\./g, "%2E") : encoded;
+};
+/**
+ * Substitute a route pattern's `:param` segments with concrete values: `/users/:id` + `{id:"7"}` →
+ * `/users/7`. Returns the filled path plus any params that had no value (a `getStaticPaths` bug) so
+ * the caller can skip rather than emit a path with a literal `:name`. Shared by the SSG driver and
+ * {@link enumeratePrerenderedPaths}.
+ */
+export function fillRoutePattern(pattern, params) {
+    const missing = [];
+    const path = pattern.replace(FILL_PARAM, (_m, name) => {
+        const value = params[name];
+        if (value === undefined) {
+            missing.push(name);
+            return `:${name}`;
+        }
+        return encodeRouteParam(value);
+    });
+    return { path, missing };
+}
+/**
+ * Enumerate the static-routing facts `prerenderRoutes` would produce — static routes opted in via
+ * `export const prerender = true`, each `getStaticPaths` entry of a dynamic route, and each dynamic
+ * route's `fallback` policy. Pure (no rendering), so a server can compute what to hand `createWebApp`
+ * (the prerendered set for the client's static-`_data.json` soft-nav + the fallback map for
+ * `"404"` enforcement). A production server may instead read the build's `prerendered.json` to avoid
+ * loading every route module at startup. Catch-all/wildcard routes and dynamic routes without
+ * `getStaticPaths` are omitted from `paths`.
+ */
+export async function enumerateStaticRoutes(routes) {
+    const paths = [];
+    const fallbacks = {};
+    for (const route of routes) {
+        if (route.pattern.includes("*"))
+            continue;
+        const mod = await route.load();
+        if (route.pattern.includes(":")) {
+            if (mod.getStaticPaths === undefined)
+                continue;
+            const { paths: staticPaths, fallback = "ssr" } = await mod.getStaticPaths();
+            fallbacks[route.pattern] = fallback;
+            for (const { params } of staticPaths) {
+                const { path, missing } = fillRoutePattern(route.pattern, params);
+                if (missing.length === 0)
+                    paths.push(path);
+            }
+        }
+        else if (mod.prerender === true) {
+            paths.push(route.pattern);
+        }
+    }
+    return { paths, fallbacks };
+}
+/** The prerendered-path subset of {@link enumerateStaticRoutes} — kept for callers that only need the
+ * paths (e.g. injecting `window.__NIFRA_PRERENDERED__`). */
+export async function enumeratePrerenderedPaths(routes) {
+    return (await enumerateStaticRoutes(routes)).paths;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/plugins/css-modules.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `@nifrajs/web/plugins/css-modules` — a dependency-free CSS Modules (`*.module.css`) Bun plugin, in its
+ * OWN module so the SSR preload registers it BEFORE any `.module.css` file loads. Mirrors the
+ * `@nifrajs/web-vue/plugin` seam exactly: pass `"dom"` for the client bundle
+ * (`buildClient({ plugins: [...] })`) and preload `"ssr"` for the server (`bun --preload`).
+ *
+ * Each `import styles from "./x.module.css"` becomes a JS module whose **default export** is the
+ * `{ originalClassName: scopedClassName }` map; the rewritten (scoped) CSS is emitted into the client
+ * stylesheet via the `?nifra-css-module` virtual-module idiom (the same trick the Vue plugin uses for
+ * `?vue-css`). The `"ssr"` form emits **no** CSS — the stylesheet ships from the client build — but
+ * produces the **identical** class map, so SSR markup's `class={styles.foo}` matches the bundled
+ * selectors (scoped names are a pure function of file path + class name, so both builds agree).
+ *
+ * Scoping is deterministic (a stable 8-hex hash of the package-relative `filePath + className`, no
+ * `Date.now`/`Math.random`/cwd), so builds are reproducible across machines and working directories.
+ * Supported (the 95% case): class selectors (`.a`, `.a .b`, `.a.b`), combinators,
+ * pseudo-classes/`:not(...)`, native nesting, at-rules (`@media`/`@supports`/`@container`/`@layer`),
+ * `:global(...)`/`:local(...)` (function form), and **`@keyframes` names + their `animation`/
+ * `animation-name` references** (scoped together, so two modules' same-named keyframes don't clash).
+ * Not handled: the bare `:global`/`:local` *switch* form and `composes:` — out of scope by design.
+ */
+import type { BunPlugin } from "bun";
+/** The transform result: the `{ original: scoped }` export map + the rewritten (scoped) stylesheet. */
+export interface CssModuleResult {
+    readonly exports: Readonly<Record<string, string>>;
+    readonly css: string;
+}
+/**
+ * Pure core (no I/O): scope a CSS-module source. Same `(source, filePath)` in → byte-identical out, so
+ * the `"dom"` and `"ssr"` plugin forms produce the same class map. Exposed for direct testing.
+ */
+export declare function transformCssModule(source: string, filePath: string): CssModuleResult;
+/**
+ * The CSS Modules Bun plugin. `"dom"` → the `.module.css` import becomes the class map AND emits the
+ * scoped stylesheet as a virtual `?nifra-css-module` module that `Bun.build`'s CSS bundler folds into
+ * the app stylesheet. `"ssr"` → the class map only (no CSS; the scoped names match the client build).
+ * Tolerates a trailing `?query` on the path (dev servers append one to bust Bun's import cache).
+ */
+export declare function cssModulesBunPlugin(generate: "dom" | "ssr"): BunPlugin;
+//# sourceMappingURL=css-modules.d.ts.map

package/dist/plugins/css-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-modules.d.ts","sourceRoot":"","sources":["../../src/plugins/css-modules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAqWpC,uGAAuG;AACvG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAOpF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAmBtE"}

package/dist/plugins/css-modules.js.map

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

package/dist/plugins/kit.d.ts

@@ -0,0 +1,44 @@
+import type { BunPlugin } from "bun";
+/** The argument Bun passes to a plugin's `setup` — Bun doesn't export the type, so derive it. */
+export type PluginBuilder = Parameters<BunPlugin["setup"]>[0];
+/**
+ * A **package-root-relative**, forward-slashed form of an absolute path — the input to {@link hash8} for
+ * any build-stable identifier (e.g. CSS-module scoped names). Anchoring on the file's nearest
+ * `package.json` (not the absolute path, not `process.cwd()`) makes the result independent of BOTH the
+ * machine's directory layout AND the working directory: the dom build and the ssr runtime — even on
+ * different machines or from different cwds — derive the SAME relative path for a given file, so their
+ * scoped class maps always agree. (Hashing the absolute path would differ across CI/host; a
+ * cwd-relative path would silently desync if the SSR server started from a non-project-root cwd.)
+ */
+export declare function reproduciblePath(absolutePath: string): string;
+/**
+ * Deterministic 8-hex hash (djb2/xor). Stable across builds — no `Date.now`/`Math.random` — so build
+ * output is reproducible. The single hash implementation behind CSS-module scoped names (and a drop-in
+ * for any SFC scope id).
+ */
+export declare function hash8(input: string): string;
+/**
+ * Records compiled CSS and wires it into the client bundle through a virtual `?<namespace>` module —
+ * the idiom the Vue plugin established (`?vue-css`). Register one per plugin `setup`; call `emit` per
+ * file to stash its CSS and get back the `import` line to append to the JS module.
+ */
+export interface StylesheetEmitter {
+    /** Store `css` for `path`, returning the `import "<path>?<namespace>"` line for the JS module. */
+    emit(path: string, css: string): string;
+}
+/**
+ * Wire the virtual-CSS-module handlers onto `build` for `namespace`, returning an {@link StylesheetEmitter}.
+ * The `namespace` must be a plain identifier (letters/`-`); it's used verbatim as the import suffix and
+ * the Bun namespace. Only the `"dom"` build should emit CSS — the `"ssr"` build ships no stylesheet.
+ */
+export declare function createStylesheetEmitter(build: PluginBuilder, namespace: string): StylesheetEmitter;
+/**
+ * Load an optional peer compiler at build time, throwing a consistent, actionable install-hint error if
+ * it's absent — the `@vue/compiler-sfc` peer pattern, centralized. Build-time only, so the dynamic
+ * `import` (which keeps the peer out of the package's hard dependencies) is correct here.
+ */
+export declare function requirePeer<T>(specifier: string, hint: {
+    readonly feature: string;
+    readonly install: string;
+}): Promise<T>;
+//# sourceMappingURL=kit.d.ts.map

package/dist/plugins/kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../src/plugins/kit.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEpC,iGAAiG;AACjG,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAuB7D;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,kGAAkG;IAClG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACxC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAkBnB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/plugins/kit.js

@@ -0,0 +1,105 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * `@nifrajs/web/plugins` shared kit — the small infrastructure every CSS-bearing asset plugin reuses, so
+ * P1 (CSS Modules), P2 (SCSS), and any future P4 (LESS/Stylus/PostCSS) don't each re-implement the
+ * CSS→client-bundle wiring, the deterministic hash, or the optional-peer guard. Internal to
+ * `@nifrajs/web` (imported by the sibling plugin modules); not a public subpath.
+ */
+import { existsSync } from "node:fs";
+import { dirname, relative } from "node:path";
+const packageRootCache = new Map();
+/** The nearest ancestor directory of `startDir` that holds a `package.json` (the file's package root),
+ * cached. Falls back to `startDir` if none is found, so it never throws. */
+function packageRootOf(startDir) {
+    const cached = packageRootCache.get(startDir);
+    if (cached !== undefined)
+        return cached;
+    let dir = startDir;
+    for (;;) {
+        if (existsSync(`${dir}/package.json`))
+            break;
+        const parent = dirname(dir);
+        if (parent === dir) {
+            dir = startDir; // reached the filesystem root with no package.json — anchor on the file's own dir
+            break;
+        }
+        dir = parent;
+    }
+    packageRootCache.set(startDir, dir);
+    return dir;
+}
+/**
+ * A **package-root-relative**, forward-slashed form of an absolute path — the input to {@link hash8} for
+ * any build-stable identifier (e.g. CSS-module scoped names). Anchoring on the file's nearest
+ * `package.json` (not the absolute path, not `process.cwd()`) makes the result independent of BOTH the
+ * machine's directory layout AND the working directory: the dom build and the ssr runtime — even on
+ * different machines or from different cwds — derive the SAME relative path for a given file, so their
+ * scoped class maps always agree. (Hashing the absolute path would differ across CI/host; a
+ * cwd-relative path would silently desync if the SSR server started from a non-project-root cwd.)
+ */
+export function reproduciblePath(absolutePath) {
+    const root = packageRootOf(dirname(absolutePath));
+    return relative(root, absolutePath).replaceAll("\\", "/");
+}
+/**
+ * Deterministic 8-hex hash (djb2/xor). Stable across builds — no `Date.now`/`Math.random` — so build
+ * output is reproducible. The single hash implementation behind CSS-module scoped names (and a drop-in
+ * for any SFC scope id).
+ */
+export function hash8(input) {
+    let h = 5381;
+    for (let i = 0; i < input.length; i++)
+        h = (Math.imul(h, 33) ^ input.charCodeAt(i)) >>> 0;
+    return h.toString(16).padStart(8, "0");
+}
+/**
+ * Wire the virtual-CSS-module handlers onto `build` for `namespace`, returning an {@link StylesheetEmitter}.
+ * The `namespace` must be a plain identifier (letters/`-`); it's used verbatim as the import suffix and
+ * the Bun namespace. Only the `"dom"` build should emit CSS — the `"ssr"` build ships no stylesheet.
+ */
+export function createStylesheetEmitter(build, namespace) {
+    const suffix = `?${namespace}`;
+    const cssByPath = new Map();
+    // `\?${namespace}$`: namespaces are plain identifiers, so no regex metachars to escape.
+    build.onResolve({ filter: new RegExp(`\\?${namespace}$`) }, (args) => ({
+        path: args.path,
+        namespace,
+    }));
+    build.onLoad({ filter: /.*/, namespace }, (args) => ({
+        contents: cssByPath.get(args.path.slice(0, -suffix.length)) ?? "",
+        loader: "css",
+    }));
+    return {
+        emit(path, css) {
+            cssByPath.set(path, css);
+            return `import ${JSON.stringify(path + suffix)}\n`;
+        },
+    };
+}
+/**
+ * Load an optional peer compiler at build time, throwing a consistent, actionable install-hint error if
+ * it's absent — the `@vue/compiler-sfc` peer pattern, centralized. Build-time only, so the dynamic
+ * `import` (which keeps the peer out of the package's hard dependencies) is correct here.
+ */
+export async function requirePeer(specifier, hint) {
+    try {
+        return (await import(__rewriteRelativeImportExtension(specifier)));
+    }
+    catch (err) {
+        // Only a genuine resolution failure means "not installed" — surface anything else (a corrupt
+        // install, a native-binding error, a throw at module top-level) as the real error rather than
+        // masking it behind a misleading "please install it" hint.
+        if (err.code === "ERR_MODULE_NOT_FOUND") {
+            throw new Error(`[nifra/web] ${hint.feature} requires the optional peer "${specifier}". Install it: ${hint.install}`);
+        }
+        throw new Error(`[nifra/web] ${hint.feature}: the optional peer "${specifier}" is installed but failed to load.`, { cause: err });
+    }
+}
+//# sourceMappingURL=kit.js.map

package/dist/plugins/kit.js.map

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

package/dist/plugins/scss.d.ts

@@ -0,0 +1,27 @@
+import type { BunPlugin } from "bun";
+/** The subset of the `sass` / `sass-embedded` API this plugin uses. Both packages satisfy it. */
+export interface SassCompiler {
+    compileString(source: string, options?: {
+        readonly syntax?: "scss" | "indented";
+        readonly style?: "expanded" | "compressed";
+        readonly loadPaths?: readonly string[];
+        readonly url?: URL;
+    }): {
+        readonly css: string;
+    };
+}
+export interface ScssPluginOptions {
+    /** Inject the compiler (default: the `sass` optional peer, loaded lazily). Pass `sass-embedded` or a stub. */
+    readonly compiler?: SassCompiler;
+    /** Output style handed to Sass. Default `"expanded"` (Bun minifies the final CSS bundle anyway). */
+    readonly style?: "expanded" | "compressed";
+    /** Extra import search paths for `@use`/`@import`, in addition to the source file's own directory. */
+    readonly loadPaths?: readonly string[];
+}
+/**
+ * The SASS/SCSS Bun plugin. `"dom"` → bundles the compiled CSS (and, for `*.module.scss`, exports the
+ * scoped class map); `"ssr"` → the class map only for `*.module.scss`, an empty module for plain Sass.
+ * Tolerates a trailing `?query` (dev servers append one to bust Bun's import cache).
+ */
+export declare function scssBunPlugin(generate: "dom" | "ssr", options?: ScssPluginOptions): BunPlugin;
+//# sourceMappingURL=scss.d.ts.map

package/dist/plugins/scss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scss.d.ts","sourceRoot":"","sources":["../../src/plugins/scss.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAMpC,iGAAiG;AACjG,MAAM,WAAW,YAAY;IAC3B,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;QACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;QAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;QACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KACnB,GACA;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,8GAA8G;IAC9G,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;IAChC,oGAAoG;IACpG,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;IAC1C,sGAAsG;IACtG,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,EAAE,OAAO,GAAE,iBAAsB,GAAG,SAAS,CAuDjG"}

package/dist/plugins/scss.js

@@ -0,0 +1,78 @@
+/**
+ * `@nifrajs/web/plugins/scss` — a SASS/SCSS (`*.scss`, `*.sass`) Bun plugin, in its OWN module so the SSR
+ * preload registers it BEFORE any Sass file loads. Mirrors the `@nifrajs/web-vue/plugin` seam: pass
+ * `"dom"` for the client bundle (`buildClient({ plugins: [...] })`) and preload `"ssr"` for the server
+ * (`bun --preload`).
+ *
+ * The Dart Sass compiler is an **optional peer** (`sass`, or the faster `sass-embedded` — same API), not
+ * a hard dependency: it's loaded on first Sass file and fails loud with an install hint if absent. Pass
+ * your own `compiler` to override (e.g. `sass-embedded`, or a stub in tests).
+ *
+ * Composes with CSS Modules: a `*.module.scss` / `*.module.sass` file is compiled to CSS and then run
+ * through the same scoped-class transform as `@nifrajs/web/plugins/css-modules`, so its `import styles`
+ * yields the `{ original: scoped }` map (SSR/dom class-map parity included). A plain `*.scss` is a
+ * side-effect import — its CSS is bundled (dom) and it resolves to an empty module (ssr).
+ */
+import { dirname } from "node:path";
+import { pathToFileURL } from "node:url";
+import { transformCssModule } from "./css-modules.js";
+import { createStylesheetEmitter, reproduciblePath, requirePeer } from "./kit.js";
+const STYLE_NS = "nifra-scss";
+const isModuleRequest = (cleanPath) => /\.module\.s[ac]ss$/.test(cleanPath);
+/**
+ * The SASS/SCSS Bun plugin. `"dom"` → bundles the compiled CSS (and, for `*.module.scss`, exports the
+ * scoped class map); `"ssr"` → the class map only for `*.module.scss`, an empty module for plain Sass.
+ * Tolerates a trailing `?query` (dev servers append one to bust Bun's import cache).
+ */
+export function scssBunPlugin(generate, options = {}) {
+    return {
+        name: `nifra-scss-${generate}`,
+        setup(build) {
+            const stylesheet = createStylesheetEmitter(build, STYLE_NS);
+            let compiler = options.compiler;
+            const getCompiler = async () => {
+                compiler ??= await requirePeer("sass", {
+                    feature: "SASS/SCSS support",
+                    install: "bun add -d sass",
+                });
+                return compiler;
+            };
+            build.onLoad({ filter: /\.s[ac]ss(\?|$)/ }, async (args) => {
+                const path = args.path.split("?")[0] ?? args.path;
+                const source = await Bun.file(path).text();
+                const sass = await getCompiler();
+                let css;
+                try {
+                    css = sass.compileString(source, {
+                        syntax: path.endsWith(".sass") ? "indented" : "scss",
+                        style: options.style ?? "expanded",
+                        loadPaths: [dirname(path), ...(options.loadPaths ?? [])],
+                        url: pathToFileURL(path),
+                    }).css;
+                }
+                catch (err) {
+                    // Attribute the Sass compile error to the file + package (Dart Sass errors carry line info).
+                    throw new Error(`[nifra/web] failed to compile ${path}: ${err?.message ?? err}`, {
+                        cause: err,
+                    });
+                }
+                if (isModuleRequest(path)) {
+                    // *.module.scss → compile, then scope class names through the shared CSS-modules transform.
+                    // Scope off the cwd-relative path so names are reproducible across machines/CI.
+                    const { exports, css: scopedCss } = transformCssModule(css, reproduciblePath(path));
+                    const js = `export default ${JSON.stringify(exports)}\n`;
+                    return {
+                        contents: generate === "dom" ? js + stylesheet.emit(path, scopedCss) : js,
+                        loader: "js",
+                    };
+                }
+                // Plain *.scss → side-effect import: bundle the CSS on dom, an empty module on ssr.
+                return {
+                    contents: generate === "dom" ? stylesheet.emit(path, css) : "",
+                    loader: "js",
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=scss.js.map

package/dist/plugins/scss.js.map

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