create-nifra 2.2.0 → 2.4.0

package/dist/scaffold/frameworks.js

@@ -0,0 +1,100 @@
+/**
+ * What a frontend framework contributes to a site scaffold.
+ *
+ * The five site templates were five directories of 26 files each, and 13 of those 26 were
+ * byte-identical in all five - the Dockerfile, every server entry, the worker, the assurance config.
+ * Editing the runtime story meant editing it five times and hoping. This session made the same
+ * one-line `package.json` edit in eight files, which is the whole argument.
+ *
+ * So the runtime knowledge lives once (see `site.ts`), and a framework contributes only what is
+ * genuinely its own: an adapter, a bundler plugin, the resolve conditions and defines its compiler
+ * needs, and its dependency set. The prose a framework needs to explain ITSELF - why Solid wants a
+ * `"solid"` resolve condition, what `@preact/preset-vite` is - stays in a real file next to it. That
+ * is the line: mechanical differences are modelled, explanations are written.
+ */
+/**
+ * The `@nifrajs/*` range a scaffolded site installs.
+ *
+ * One constant, because it used to be a regex sweep over eight `package.json` files in the release
+ * script with nothing checking the result - and the script's own comment warns that a missed bump
+ * ships templates installing the PREVIOUS release. `scaffold-version.test.ts` now fails when this
+ * drifts from what core is publishing, so the footgun is a red test rather than a silent regression.
+ */
+export const NIFRA_DEP_RANGE = "^2.4.0";
+/**
+ * React is first because it is the default (`--framework` omitted scaffolds it), and because the
+ * other four are most easily read as deltas from it.
+ */
+export const FRAMEWORK_SPECS = {
+    react: {
+        id: "react",
+        adapter: "reactAdapter",
+        package: "@nifrajs/web-react",
+        runtimeDependencies: { react: "^19.0.0", "react-dom": "^19.0.0" },
+        devDependencies: {
+            "@types/react": "^19.0.0",
+            "@types/react-dom": "^19.0.0",
+            "@vitejs/plugin-react": "^4.3.0",
+        },
+        typescript: { jsx: "react-jsx", types: ["react", "react-dom"] },
+    },
+    preact: {
+        id: "preact",
+        adapter: "preactAdapter",
+        package: "@nifrajs/web-preact",
+        runtimeDependencies: { preact: "^10.25.0" },
+        devDependencies: { "@preact/preset-vite": "^2.9.0" },
+        typescript: { jsx: "react-jsx", jsxImportSource: "preact" },
+    },
+    solid: {
+        id: "solid",
+        adapter: "solidAdapter",
+        package: "@nifrajs/web-solid",
+        runtimeDependencies: { "solid-js": "^1.9.0" },
+        devDependencies: { "vite-plugin-solid": "^2.10.0" },
+        typescript: { jsx: "preserve", jsxImportSource: "solid-js" },
+        bunPlugin: { specifier: "@nifrajs/web-solid", name: "solidBunPlugin" },
+        // Solid publishes a `solid` export condition that routes `solid-js` to its JSX source; without it
+        // the bundler takes the pre-compiled build and hydration has nothing to attach to.
+        conditions: { client: ["solid"], ssr: ["solid"] },
+    },
+    svelte: {
+        id: "svelte",
+        adapter: "svelteAdapter",
+        package: "@nifrajs/web-svelte",
+        runtimeDependencies: { svelte: "^5.3.0" },
+        devDependencies: { "@sveltejs/vite-plugin-svelte": "^5.0.0" },
+        typescript: { types: ["svelte"], includeTsx: false },
+        bunPlugin: { specifier: "@nifrajs/web-svelte/plugin", name: "svelteBunPlugin" },
+    },
+    vue: {
+        id: "vue",
+        adapter: "vueAdapter",
+        package: "@nifrajs/web-vue",
+        runtimeDependencies: { vue: "^3.5.0" },
+        devDependencies: { "@vitejs/plugin-vue": "^5.2.0", "@vue/compiler-sfc": "^3.5.0" },
+        typescript: { jsx: "preserve" },
+        bunPlugin: {
+            specifier: "@nifrajs/web-vue/plugin",
+            name: "vueBunPlugin",
+            note: { dom: " // compile .vue SFCs → client bundle", ssr: " // compile .vue SFCs → SSR" },
+        },
+        // Vue reads these at build time to drop dev-only branches; leaving them undefined ships the
+        // development runtime and warns about it on every boot.
+        defineNote: '// Vue feature flags: silence "feature flag not explicitly defined" warnings + trim dev-only code.',
+        define: {
+            __VUE_OPTIONS_API__: '"true"',
+            __VUE_PROD_DEVTOOLS__: '"false"',
+            __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: '"false"',
+        },
+    },
+};
+export const FRAMEWORK_IDS = Object.keys(FRAMEWORK_SPECS);
+export function frameworkSpec(id) {
+    const spec = FRAMEWORK_SPECS[id];
+    if (spec === undefined) {
+        throw new Error(`unknown framework "${id}". options: ${FRAMEWORK_IDS.join(", ")}`);
+    }
+    return spec;
+}
+//# sourceMappingURL=frameworks.js.map

package/dist/scaffold/frameworks.js.map

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

package/dist/scaffold/site-build.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The five build entries a site scaffold ships, emitted from one shape.
+ *
+ * These were 25 files - five deploy targets copied across five framework directories - and the
+ * difference between any two of them is mechanical: which runtime it targets, and which compiler
+ * plugin, resolve conditions and defines the framework needs. Nothing else. So the target owns its
+ * own prose (what it emits, how to run it) and the framework contributes its injections, and the 25
+ * files come out of one function.
+ *
+ * The emitted text is asserted byte-for-byte against the templates that used to be checked in, so
+ * this is a refactor whose correctness is decided by a test rather than by reading.
+ */
+import type { FrameworkSpec } from "./frameworks.js";
+/**
+ * Where the framework's own resolve conditions sit inside a target's server list.
+ *
+ * The edge targets end theirs with `browser` (the worker has no Node builtins, so packages must be
+ * asked for their browser build); Bun and Node do not. The framework's conditions go in the middle,
+ * which is the order every checked-in template used.
+ */
+export interface ServerConditionSlots {
+    readonly before: readonly string[];
+    readonly after: readonly string[];
+}
+export interface BuildTarget {
+    /** File name, e.g. `build-bun.ts`. */
+    readonly file: string;
+    /** Leading comment block, without the trailing newline. */
+    readonly header: string;
+    /**
+     * Frameworks whose header says something extra here - what their plugin does, or how to run the
+     * output once their compiler is in the picture.
+     *
+     * These are the one genuinely non-mechanical part of a build entry, and they are the reason this
+     * table exists rather than a pure `{framework, runtime}` function: the prose a framework needs to
+     * explain itself is written, not derived. Keeping them beside the target they belong to is the
+     * closest thing to having them in the file without having five copies of the file.
+     */
+    readonly headerOverrides?: Readonly<Record<string, string>>;
+    /** Runtime conditions this target's SERVER build resolves with. */
+    readonly serverConditions: ServerConditionSlots;
+    /** Extra `node:fs` named imports beyond `cpSync, mkdirSync, rmSync`. */
+    readonly extraFsImports?: readonly string[];
+    /** Lines between the imports and the first build call, `dir` already declared. */
+    readonly setup: string;
+    /** Where `buildClient` writes assets, as a template expression. */
+    readonly clientOutDir: string;
+    /** The server entry this target boots from. */
+    readonly serverEntry: string;
+    /** Scratch directory for the server build. */
+    readonly serverOutDir: string;
+    /** `target:` line for `buildServer`, or empty for the default (workerd). */
+    readonly serverTarget: string;
+    /** Everything after the `buildServer` call. */
+    readonly tail: string;
+}
+export declare const BUILD_TARGETS: readonly BuildTarget[];
+/** Emit one target's build entry for one framework. */
+export declare function renderBuildFile(target: BuildTarget, framework: FrameworkSpec): string;
+//# sourceMappingURL=site-build.d.ts.map

package/dist/scaffold/site-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-build.d.ts","sourceRoot":"","sources":["../../src/scaffold/site-build.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAgEpD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC3D,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAA;IAC/C,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,mEAAmE;IACnE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EA2H/C,CAAA;AAeD,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CAsBrF"}

package/dist/scaffold/site-build.js

@@ -0,0 +1,198 @@
+const NODE_ENV_DEFINE = `"process.env.NODE_ENV": '"production"'`;
+/**
+ * A framework with no compiler plugin keeps the define inline in the client call, exactly as the
+ * React and Preact templates had it: nothing is shared, so hoisting it would name a constant used
+ * once. A framework WITH a plugin needs the same defines in both calls, so it hoists.
+ */
+function injectionsFor(framework, target) {
+    const extraDefines = Object.entries(framework.define ?? {}).map(([k, v]) => `${k}: ${v}`);
+    const hoist = framework.bunPlugin !== undefined;
+    const defineEntries = [NODE_ENV_DEFINE, ...extraDefines];
+    const defineLiteral = defineEntries.length === 1
+        ? `{ ${defineEntries[0]} }`
+        : `{\n${defineEntries.map((e) => `  ${e},`).join("\n")}\n}`;
+    const plugin = framework.bunPlugin;
+    const call = (mode) => {
+        if (plugin === undefined)
+            return "";
+        return `  plugins: [${plugin.name}("${mode}")],${plugin.note?.[mode] ?? ""}\n`;
+    };
+    const list = (values) => `  conditions: [${values.map((c) => `"${c}"`).join(", ")}],\n`;
+    // The client call always names its conditions (`bun`, then anything the framework adds, then
+    // `browser`). The server call names them ONLY when the framework contributes one - otherwise the
+    // build's own default is right and spelling it out would be noise.
+    const clientConditions = (extra) => list(["bun", ...(extra ?? []), "browser"]);
+    const serverConditions = (extra) => extra === undefined || extra.length === 0
+        ? ""
+        : list([...target.serverConditions.before, ...extra, ...target.serverConditions.after]);
+    return {
+        pluginImport: plugin === undefined ? "" : `import { ${plugin.name} } from "${plugin.specifier}"\n`,
+        defineConst: hoist
+            ? `${framework.defineNote === undefined ? "" : `${framework.defineNote}\n`}const define = ${defineLiteral}\n`
+            : "",
+        clientPlugins: call("dom"),
+        clientConditions: clientConditions(framework.conditions?.client),
+        clientDefine: hoist ? "  define,\n" : `  define: ${defineLiteral},\n`,
+        serverPlugins: call("ssr"),
+        serverConditions: serverConditions(framework.conditions?.ssr),
+        serverDefine: hoist ? "  define,\n" : "",
+    };
+}
+export const BUILD_TARGETS = [
+    {
+        file: "build.ts",
+        header: "// Build for Cloudflare Pages → dist/ (_worker.js + _routes.json + client assets). `bun run build`.",
+        headerOverrides: {
+            solid: `// Build for Cloudflare Pages → dist/ (_worker.js + _routes.json + client assets). \`bun run build\`.
+// Solid: solidBunPlugin("dom") for the client, ("ssr") for the server + the \`solid\` export condition.`,
+            svelte: `// Build for Cloudflare Pages → dist/ (_worker.js + _routes.json + client assets). \`bun run build\`.
+// Svelte: svelteBunPlugin("dom") compiles .svelte for the client, ("ssr") for the server bundle.`,
+        },
+        serverConditions: { before: ["workerd", "edge-light"], after: ["browser"] },
+        extraFsImports: ["writeFileSync"],
+        setup: "const dist = `${dir}/dist`\n",
+        clientOutDir: "`${dist}/assets`",
+        serverEntry: "`${dir}/_worker.ts`",
+        serverOutDir: "`${dir}/.build`",
+        serverTarget: "",
+        tail: `cpSync(worker, \`\${dist}/_worker.js\`)
+rmSync(\`\${dir}/.build\`, { recursive: true, force: true })
+writeFileSync(
+  \`\${dist}/_routes.json\`,
+  \`\${JSON.stringify({ version: 1, include: ["/*"], exclude: ["/assets/*"] }, null, 2)}\\n\`,
+)
+console.log("Cloudflare Pages output → dist (deploy: wrangler pages deploy dist)")
+`,
+    },
+    {
+        file: "build-bun.ts",
+        header: `// Build for Bun (nifra's flagship runtime) → dist-bun/ (server-bun.js + client assets).
+// \`bun run build:bun\`. Run: \`bun dist-bun/server-bun.js\`.`,
+        serverConditions: { before: ["bun"], after: [] },
+        setup: "const dist = `${dir}/dist-bun`\n",
+        clientOutDir: "`${dist}/assets`",
+        serverEntry: "`${dir}/server-bun.ts`",
+        serverOutDir: "`${dir}/.build-bun`",
+        serverTarget: '  target: "bun",\n',
+        tail: `cpSync(worker, \`\${dist}/server-bun.js\`)
+rmSync(\`\${dir}/.build-bun\`, { recursive: true, force: true })
+console.log("Bun output → dist-bun (run: bun dist-bun/server-bun.js)")
+`,
+    },
+    {
+        file: "build-node.ts",
+        header: "// Build for Node → dist-node/ (server-node.js + client assets). `bun run build:node`.",
+        headerOverrides: {
+            solid: `// Build for Node → dist-node/ (server-node.js + client assets). \`bun run build:node\`.
+// Run: \`node dist-node/server-node.js\` (or the Dockerfile). \`node\`+\`solid\` → solid-js/web's server build.`,
+            svelte: `// Build for Node → dist-node/ (server-node.js + client assets). \`bun run build:node\`.
+// Run: \`node dist-node/server-node.js\` (or the Dockerfile).`,
+            vue: `// Build for Node → dist-node/ (server-node.js + client assets). \`bun run build:node\`.
+// Run: \`node dist-node/server-node.js\` (or the Dockerfile).`,
+        },
+        serverConditions: { before: ["node"], after: [] },
+        setup: "const dist = `${dir}/dist-node`\n",
+        clientOutDir: "`${dist}/assets`",
+        serverEntry: "`${dir}/server-node.ts`",
+        serverOutDir: "`${dir}/.build-node`",
+        serverTarget: '  target: "node",\n',
+        tail: `cpSync(worker, \`\${dist}/server-node.js\`)
+rmSync(\`\${dir}/.build-node\`, { recursive: true, force: true })
+console.log("Node output → dist-node (run: node dist-node/server-node.js)")
+`,
+    },
+    {
+        file: "build-deno.ts",
+        header: "// Build for Deno → dist-deno/ (server-deno.js + client assets). `bun run build:deno`.",
+        headerOverrides: {
+            solid: `// Build for Deno → dist-deno/ (server-deno.js + client assets). \`bun run build:deno\`.
+// Run: \`deno task start\` (or deployctl). Deno runs the edge bundle (workerd/edge-light + solid).`,
+            svelte: `// Build for Deno → dist-deno/ (server-deno.js + client assets). \`bun run build:deno\`.
+// Run: \`deno task start\` (or deployctl).`,
+            vue: `// Build for Deno → dist-deno/ (server-deno.js + client assets). \`bun run build:deno\`.
+// Run: \`deno task start\` (or deployctl for Deno Deploy).`,
+        },
+        serverConditions: { before: ["workerd", "edge-light"], after: ["browser"] },
+        setup: "const dist = `${dir}/dist-deno`\n",
+        clientOutDir: "`${dist}/assets`",
+        serverEntry: "`${dir}/server-deno.ts`",
+        serverOutDir: "`${dir}/.build-deno`",
+        serverTarget: "",
+        tail: `cpSync(worker, \`\${dist}/server-deno.js\`)
+rmSync(\`\${dir}/.build-deno\`, { recursive: true, force: true })
+console.log("Deno output → dist-deno (run: deno run -A dist-deno/server-deno.js)")
+`,
+    },
+    {
+        file: "build-vercel.ts",
+        header: `// Build for Vercel, emitting Vercel's Build Output API v3 at .vercel/output/ so it deploys with no
+// framework preset: \`vercel deploy --prebuilt\`. Layout:
+//   .vercel/output/config.json                   - serve static files, else SSR via the function
+//   .vercel/output/static/assets/<client bundle>  - Vercel's CDN serves these directly
+//   .vercel/output/functions/index.func/index.js  - the Edge SSR function (+ .vc-config.json)`,
+        serverConditions: { before: ["workerd", "edge-light"], after: ["browser"] },
+        extraFsImports: ["writeFileSync"],
+        setup: `const out = \`\${dir}/.vercel/output\`
+const fn = \`\${out}/functions/index.func\`
+`,
+        clientOutDir: "`${out}/static/assets`",
+        serverEntry: "`${dir}/server-vercel.ts`",
+        serverOutDir: "`${dir}/.build-vercel`",
+        serverTarget: "",
+        tail: `cpSync(worker, \`\${fn}/index.js\`)
+rmSync(\`\${dir}/.build-vercel\`, { recursive: true, force: true })
+
+// Build Output API v3: serve real files first (\`handle: filesystem\` → /assets/*), then SSR the rest.
+writeFileSync(
+  \`\${fn}/.vc-config.json\`,
+  \`\${JSON.stringify({ runtime: "edge", entrypoint: "index.js" }, null, 2)}\\n\`,
+)
+writeFileSync(
+  \`\${out}/config.json\`,
+  \`\${JSON.stringify(
+    { version: 3, routes: [{ handle: "filesystem" }, { src: "/(.*)", dest: "/index" }] },
+    null,
+    2,
+  )}\\n\`,
+)
+console.log("Vercel output → .vercel/output (deploy: vercel deploy --prebuilt)")
+`,
+    },
+];
+/** The `rm`/`mkdir` preamble differs only for Vercel, which builds two trees rather than one. */
+function preambleFor(target) {
+    if (target.file !== "build-vercel.ts") {
+        return `rmSync(dist, { recursive: true, force: true })
+mkdirSync(\`\${dist}/assets\`, { recursive: true })
+`;
+    }
+    return `rmSync(\`\${dir}/.vercel\`, { recursive: true, force: true })
+mkdirSync(\`\${out}/static/assets\`, { recursive: true })
+mkdirSync(fn, { recursive: true })
+`;
+}
+/** Emit one target's build entry for one framework. */
+export function renderBuildFile(target, framework) {
+    const injections = injectionsFor(framework, target);
+    const header = target.headerOverrides?.[framework.id] ?? target.header;
+    const fsImports = ["cpSync", "mkdirSync", "rmSync", ...(target.extraFsImports ?? [])].sort();
+    return `${header}
+import { ${fsImports.join(", ")} } from "node:fs"
+import { buildClient, buildServer } from "@nifrajs/web/build"
+${injections.pluginImport}
+const dir = import.meta.dir
+${target.setup}${injections.defineConst}${preambleFor(target)}
+const client = await buildClient({
+  routesDir: \`\${dir}/routes\`,
+  outDir: ${target.clientOutDir},
+  clientModule: "${framework.package}/client",
+${injections.clientPlugins}${injections.clientConditions}${injections.clientDefine}})
+const { worker } = await buildServer({
+  routesDir: \`\${dir}/routes\`,
+  serverEntry: ${target.serverEntry},
+  outDir: ${target.serverOutDir},
+${target.serverTarget}  clientEntry: client.entry,
+${injections.serverPlugins}${injections.serverConditions}${injections.serverDefine}})
+${target.tail}`;
+}
+//# sourceMappingURL=site-build.js.map

package/dist/scaffold/site-build.js.map

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

package/dist/scaffold/site-files.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The rest of a site scaffold's mechanical files: the adapter re-export, the manifest, the tsconfig.
+ *
+ * Same argument as `site-build.ts`. These three were five copies each whose only real difference was
+ * which framework they name, and keeping five copies is how `.vercel` came to be excluded from four
+ * tsconfigs and not the fifth.
+ */
+import { type FrameworkSpec } from "./frameworks.js";
+/**
+ * `framework.ts` - the one file every server entry imports the adapter from, which is what keeps the
+ * entries themselves framework-agnostic and therefore shareable.
+ */
+export declare function renderFrameworkModule(framework: FrameworkSpec): string;
+export declare function renderPackageJson(framework: FrameworkSpec): string;
+export declare function renderTsconfig(framework: FrameworkSpec): string;
+//# sourceMappingURL=site-files.d.ts.map

package/dist/scaffold/site-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-files.d.ts","sourceRoot":"","sources":["../../src/scaffold/site-files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,iBAAiB,CAAA;AAKrE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAQtE;AAqBD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAoBlE;AAgCD,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAoB/D"}

package/dist/scaffold/site-files.js

@@ -0,0 +1,112 @@
+/**
+ * The rest of a site scaffold's mechanical files: the adapter re-export, the manifest, the tsconfig.
+ *
+ * Same argument as `site-build.ts`. These three were five copies each whose only real difference was
+ * which framework they name, and keeping five copies is how `.vercel` came to be excluded from four
+ * tsconfigs and not the fifth.
+ */
+import { NIFRA_DEP_RANGE } from "./frameworks.js";
+/** JSON as these files are written: two-space indent, trailing newline. */
+const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
+/**
+ * `framework.ts` - the one file every server entry imports the adapter from, which is what keeps the
+ * entries themselves framework-agnostic and therefore shareable.
+ */
+export function renderFrameworkModule(framework) {
+    return `// The frontend adapter for this app. \`create-nifra --framework <react|preact|vue|solid|svelte>\` swaps
+// this one line (and the routes + build config); every server entry imports the adapter from here, so
+// they stay framework-agnostic.
+import { ${framework.adapter} } from "${framework.package}"
+
+export const adapter = ${framework.adapter}
+`;
+}
+/** The scripts every site scaffold ships, identical across frameworks. */
+const SCRIPTS = {
+    dev: "nifra dev",
+    preview: "bunx wrangler pages dev dist",
+    build: "bun run build.ts",
+    "build:bun": "bun run build-bun.ts",
+    "build:node": "bun run build-node.ts",
+    "build:deno": "bun run build-deno.ts",
+    "build:vercel": "bun run build-vercel.ts",
+    start: "bun dist-bun/server-bun.js",
+    "start:node": "node dist-node/server-node.js",
+    "deploy:cf": "wrangler pages deploy dist",
+    "deploy:vercel": "vercel deploy --prebuilt",
+    check: "nifra check && nifra assure",
+};
+/** Nifra packages every site depends on, whatever it renders with. */
+const NIFRA_RUNTIME = ["client", "core", "schema", "deno", "node", "web"];
+export function renderPackageJson(framework) {
+    const dependencies = {};
+    for (const name of NIFRA_RUNTIME)
+        dependencies[`@nifrajs/${name}`] = NIFRA_DEP_RANGE;
+    dependencies[framework.package] = NIFRA_DEP_RANGE;
+    Object.assign(dependencies, framework.runtimeDependencies);
+    return json({
+        name: "nifra-site",
+        version: "0.0.0",
+        type: "module",
+        private: true,
+        scripts: SCRIPTS,
+        dependencies,
+        devDependencies: {
+            "@nifrajs/cli": NIFRA_DEP_RANGE,
+            ...framework.devDependencies,
+            typescript: "^6.0.3",
+            vite: "^8.0.0",
+        },
+    });
+}
+/**
+ * Directories a build writes and a typecheck must not read, plus the entries that are run by Bun
+ * rather than typechecked as part of the app.
+ *
+ * `.vercel` is in here for every framework. It was missing from React's copy alone, which is the shape
+ * this whole refactor is about: `build-vercel.ts` writes there in all five, and four tsconfigs knew.
+ */
+const EXCLUDE = [
+    "node_modules",
+    "dist",
+    "dist-bun",
+    "dist-node",
+    "dist-deno",
+    "dist-vercel",
+    ".nifra",
+    ".vercel",
+    ".wrangler",
+    "server-manifest.ts",
+    "server-bun.ts",
+    "server-node.ts",
+    "server-deno.ts",
+    "server-vercel.ts",
+    "_worker.ts",
+    "build.ts",
+    "build-bun.ts",
+    "build-node.ts",
+    "build-deno.ts",
+    "build-vercel.ts",
+];
+export function renderTsconfig(framework) {
+    const ts = framework.typescript;
+    return json({
+        compilerOptions: {
+            target: "ES2022",
+            module: "ESNext",
+            moduleResolution: "bundler",
+            lib: ["ES2022", "DOM", "DOM.Iterable"],
+            ...(ts.jsx === undefined ? {} : { jsx: ts.jsx }),
+            ...(ts.jsxImportSource === undefined ? {} : { jsxImportSource: ts.jsxImportSource }),
+            strict: true,
+            noUncheckedIndexedAccess: true,
+            skipLibCheck: true,
+            noEmit: true,
+            verbatimModuleSyntax: true,
+            ...(ts.types === undefined ? {} : { types: ts.types }),
+        },
+        include: ts.includeTsx === false ? ["**/*.ts"] : ["**/*.ts", "**/*.tsx"],
+        exclude: EXCLUDE,
+    });
+}
+//# sourceMappingURL=site-files.js.map

package/dist/scaffold/site-files.js.map

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

package/dist/scaffold/site.d.ts

@@ -0,0 +1,33 @@
+import { type FrameworkSpec } from "./frameworks.js";
+/**
+ * Files identical in every site scaffold, taken from the base directory.
+ *
+ * Listed rather than globbed: a glob would silently absorb a file someone adds to the base for one
+ * framework's benefit, which is the failure this is meant to end. Adding a shared file means saying so
+ * here, and `site-composition.test.ts` fails if this list and the directory disagree.
+ */
+export declare const SHARED_SITE_FILES: readonly string[];
+/** Files each framework supplies itself, relative to its overlay directory. */
+export declare const FRAMEWORK_SITE_FILES: readonly string[];
+/** Route files, whose extension is the framework's own. */
+export declare const ROUTE_BASENAMES: readonly string[];
+/** Extension the framework's route files carry. */
+export declare function routeExtension(framework: FrameworkSpec): string;
+/** The base directory: the shared files plus React's own, which is also the React overlay. */
+export declare const SITE_BASE_DIR: string;
+export declare function overlayDir(framework: FrameworkSpec): string;
+/** Every file a site scaffold emits, and the text it holds. Generated files only. */
+export declare function generatedSiteFiles(framework: FrameworkSpec): Map<string, string>;
+export interface MaterializeOptions {
+    /** Overwrite an existing destination. Default false, which refuses rather than clobbers. */
+    readonly force?: boolean;
+}
+/**
+ * Write a complete site scaffold into `target`.
+ *
+ * Refusing an occupied destination is the default and is preserved deliberately: `cp`'s
+ * `errorOnExist` did that before this was generated, and losing it would turn a mistyped path into
+ * silent data loss in someone's working directory. `--force` is what `bun create nifra .` needs.
+ */
+export declare function materializeSite(target: string, id: string, options?: MaterializeOptions): Promise<void>;
+//# sourceMappingURL=site.d.ts.map

package/dist/scaffold/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/scaffold/site.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,iBAAiB,CAAA;AAInE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAc9C,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAqC,CAAA;AAEvF,2DAA2D;AAC3D,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAiC,CAAA;AAE9E,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAI/D;AAGD,8FAA8F;AAC9F,eAAO,MAAM,aAAa,QAA0C,CAAA;AACpE,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAI3D;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhF;AAED,MAAM,WAAW,kBAAkB;IACjC,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAqBf"}