every-plugin 2.10.0 → 3.0.0-rc.0

package/dist/build/ui/factory.mjs

@@ -0,0 +1,80 @@
+import { CORE_UI_PLUGIN_KEY } from "../../ui/manifest/contract.mjs";
+import { createUiRsbuildConfig } from "./rsbuild-config.mjs";
+import fs from "node:fs";
+import path from "node:path";
+
+//#region src/build/ui/factory.ts
+/**
+* The core ui's rsbuild factory — the workspace-form counterpart of
+* `createUiRsbuildConfig` (folder-form plugin uis). The config object the
+* generated `.every-plugin/ui.rsbuild.config.generated.mjs` materializes:
+* the APP_NAME/APP_ACCOUNT defines come from the authored config through
+* `readAuthoredConfigInput` (everything-dev/config), which the generated
+* file loads in the workspace's own module graph.
+*/
+/**
+* The platform skill family ships inside the framework packages' npm tarballs
+* (`files: ["skills"]`), so resolving them from `node_modules` gives the core
+* ui the same copies in the parent workspace (pnpm symlinks) and every
+* generated child repo (published tarball). Served at `/skills/<pkg>/<skill>`.
+*/
+const SKILL_PACKAGES = [
+	"everything-dev",
+	"every-plugin",
+	"better-near-auth"
+];
+function platformSkillCopies(workspaceRoot) {
+	return SKILL_PACKAGES.flatMap((name) => {
+		const from = path.join(workspaceRoot, "node_modules", name, "skills");
+		return fs.existsSync(from) ? [{
+			from,
+			to: `./skills/${name}`,
+			globOptions: { ignore: ["**/_artifacts/**"] }
+		}] : [];
+	});
+}
+/**
+* The core ui's MF build surface — entry points and the declared exposes
+* (ADR 0008 §2). Entries and the bootstrap exposes resolve to GENERATED
+* stubs (ADR 0023); only surfaces with consumers are declared: the browser
+* bootstrap, the shared component barrel, the SSR router module, the
+* composition engine, and the generated route config.
+*/
+const CORE_UI_WEB_ENTRY = "./src/entry.gen.ts";
+const CORE_UI_WEB_EXPOSES = {
+	"./Hydrate": "./src/hydrate.gen.tsx",
+	"./components": "./src/components/index.ts"
+};
+const CORE_UI_NODE_ENTRY = "./src/router.server.gen.tsx";
+const CORE_UI_NODE_EXPOSES = {
+	"./Router": "./src/router.server.gen.tsx",
+	"./compose": "./src/compose.gen.ts",
+	"./routeConfig": "./src/routeConfig.gen.ts"
+};
+function createCoreUiRsbuildConfig({ domain, account } = {}) {
+	const workspaceRoot = process.cwd();
+	const pkg = JSON.parse(fs.readFileSync(path.join(workspaceRoot, "package.json"), "utf-8"));
+	return createUiRsbuildConfig({
+		workspaceRoot,
+		pkg,
+		role: "provider",
+		manifestName: "ui",
+		devPort: 3003,
+		webEntry: CORE_UI_WEB_ENTRY,
+		webExposes: CORE_UI_WEB_EXPOSES,
+		nodeEntry: CORE_UI_NODE_ENTRY,
+		nodeExposes: CORE_UI_NODE_EXPOSES,
+		copy: [{
+			from: path.join(workspaceRoot, "public"),
+			to: "./"
+		}, ...platformSkillCopies(workspaceRoot)],
+		define: {
+			"import.meta.env.APP_NAME": JSON.stringify(domain),
+			"import.meta.env.APP_ACCOUNT": JSON.stringify(account)
+		}
+	});
+}
+
+//#endregion
+export { CORE_UI_NODE_ENTRY, CORE_UI_NODE_EXPOSES, CORE_UI_WEB_ENTRY, CORE_UI_WEB_EXPOSES, createCoreUiRsbuildConfig, platformSkillCopies };
+//# sourceMappingURL=factory.mjs.map

package/dist/build/ui/factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.mjs","names":[],"sources":["../../../src/build/ui/factory.ts"],"sourcesContent":["/**\n * The core ui's rsbuild factory — the workspace-form counterpart of\n * `createUiRsbuildConfig` (folder-form plugin uis). The config object the\n * generated `.every-plugin/ui.rsbuild.config.generated.mjs` materializes:\n * the APP_NAME/APP_ACCOUNT defines come from the authored config through\n * `readAuthoredConfigInput` (everything-dev/config), which the generated\n * file loads in the workspace's own module graph.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { CORE_UI_PLUGIN_KEY } from \"../../ui/manifest/contract\";\nimport { createUiRsbuildConfig } from \"./rsbuild-config\";\n\n/**\n * The platform skill family ships inside the framework packages' npm tarballs\n * (`files: [\"skills\"]`), so resolving them from `node_modules` gives the core\n * ui the same copies in the parent workspace (pnpm symlinks) and every\n * generated child repo (published tarball). Served at `/skills/<pkg>/<skill>`.\n */\nconst SKILL_PACKAGES = [\"everything-dev\", \"every-plugin\", \"better-near-auth\"] as const;\n\nexport function platformSkillCopies(workspaceRoot: string): Array<{\n  from: string;\n  to: string;\n  globOptions: { ignore: string[] };\n}> {\n  return SKILL_PACKAGES.flatMap((name) => {\n    const from = path.join(workspaceRoot, \"node_modules\", name, \"skills\");\n    return fs.existsSync(from)\n      ? [\n          {\n            from,\n            to: `./skills/${name}`,\n            globOptions: { ignore: [\"**/_artifacts/**\"] },\n          },\n        ]\n      : [];\n  });\n}\n\nexport interface CoreUiRsbuildConfigInput {\n  /** Authored config domain — stamped as `import.meta.env.APP_NAME`. */\n  domain?: string;\n  /** Authored config account — stamped as `import.meta.env.APP_ACCOUNT`. */\n  account?: string;\n}\n\n/**\n * The core ui's MF build surface — entry points and the declared exposes\n * (ADR 0008 §2). Entries and the bootstrap exposes resolve to GENERATED\n * stubs (ADR 0023); only surfaces with consumers are declared: the browser\n * bootstrap, the shared component barrel, the SSR router module, the\n * composition engine, and the generated route config.\n */\nexport const CORE_UI_WEB_ENTRY = \"./src/entry.gen.ts\";\n\nexport const CORE_UI_WEB_EXPOSES: Record<string, string> = {\n  \"./Hydrate\": \"./src/hydrate.gen.tsx\",\n  \"./components\": \"./src/components/index.ts\",\n};\n\nexport const CORE_UI_NODE_ENTRY = \"./src/router.server.gen.tsx\";\n\nexport const CORE_UI_NODE_EXPOSES: Record<string, string> = {\n  \"./Router\": \"./src/router.server.gen.tsx\",\n  \"./compose\": \"./src/compose.gen.ts\",\n  \"./routeConfig\": \"./src/routeConfig.gen.ts\",\n};\n\nexport function createCoreUiRsbuildConfig({ domain, account }: CoreUiRsbuildConfigInput = {}) {\n  const workspaceRoot = process.cwd();\n  const pkg = JSON.parse(fs.readFileSync(path.join(workspaceRoot, \"package.json\"), \"utf-8\")) as {\n    name: string;\n  };\n\n  return createUiRsbuildConfig({\n    workspaceRoot,\n    pkg,\n    role: \"provider\",\n    manifestName: CORE_UI_PLUGIN_KEY,\n    devPort: 3003,\n    webEntry: CORE_UI_WEB_ENTRY,\n    webExposes: CORE_UI_WEB_EXPOSES,\n    nodeEntry: CORE_UI_NODE_ENTRY,\n    nodeExposes: CORE_UI_NODE_EXPOSES,\n    copy: [\n      { from: path.join(workspaceRoot, \"public\"), to: \"./\" },\n      ...platformSkillCopies(workspaceRoot),\n    ],\n    define: {\n      \"import.meta.env.APP_NAME\": JSON.stringify(domain),\n      \"import.meta.env.APP_ACCOUNT\": JSON.stringify(account),\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,iBAAiB;CAAC;CAAkB;CAAgB;AAAkB;AAE5E,SAAgB,oBAAoB,eAIjC;CACD,OAAO,eAAe,SAAS,SAAS;EACtC,MAAM,OAAO,KAAK,KAAK,eAAe,gBAAgB,MAAM,QAAQ;EACpE,OAAO,GAAG,WAAW,IAAI,IACrB,CACE;GACE;GACA,IAAI,YAAY;GAChB,aAAa,EAAE,QAAQ,CAAC,kBAAkB,EAAE;EAC9C,CACF,IACA,CAAC;CACP,CAAC;AACH;;;;;;;;AAgBA,MAAa,oBAAoB;AAEjC,MAAa,sBAA8C;CACzD,aAAa;CACb,gBAAgB;AAClB;AAEA,MAAa,qBAAqB;AAElC,MAAa,uBAA+C;CAC1D,YAAY;CACZ,aAAa;CACb,iBAAiB;AACnB;AAEA,SAAgB,0BAA0B,EAAE,QAAQ,YAAsC,CAAC,GAAG;CAC5F,MAAM,gBAAgB,QAAQ,IAAI;CAClC,MAAM,MAAM,KAAK,MAAM,GAAG,aAAa,KAAK,KAAK,eAAe,cAAc,GAAG,OAAO,CAAC;CAIzF,OAAO,sBAAsB;EAC3B;EACA;EACA,MAAM;EACN;EACA,SAAS;EACT,UAAU;EACV,YAAY;EACZ,WAAW;EACX,aAAa;EACb,MAAM,CACJ;GAAE,MAAM,KAAK,KAAK,eAAe,QAAQ;GAAG,IAAI;EAAK,GACrD,GAAG,oBAAoB,aAAa,CACtC;EACA,QAAQ;GACN,4BAA4B,KAAK,UAAU,MAAM;GACjD,+BAA+B,KAAK,UAAU,OAAO;EACvD;CACF,CAAC;AACH"}

package/dist/build/ui/generated-config.cjs

@@ -0,0 +1,118 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_compose = require('../rspack/compose.cjs');
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+
+//#region src/build/ui/generated-config.ts
+const UI_DIR = "ui";
+const GENERATED_CONFIG_DIR = ".every-plugin";
+const GENERATED_UI_CONFIG = "ui.rsbuild.config.generated.mjs";
+/**
+* Folder-form UI source: a `ui/` directory with route files but no own
+* package.json — the plugin workspace owns the build (single-workspace
+* plugin, one dev process, one deploy train). Workspace-form ui sources
+* (own package.json + scripts) are NOT managed here.
+*/
+function hasFolderFormUi(cwd) {
+	const uiDir = node_path.default.join(cwd, UI_DIR);
+	return node_fs.default.existsSync(node_path.default.join(uiDir, "src", "routes")) && !node_fs.default.existsSync(node_path.default.join(uiDir, "package.json"));
+}
+function generatedUiConfig(pluginId) {
+	return `import path from "node:path";
+import { createUiRsbuildConfig } from "every-plugin/build/ui";
+import pkg from "../package.json";
+
+const workspaceRoot = path.resolve(import.meta.dirname, "..", "ui");
+
+export default createUiRsbuildConfig({
+  workspaceRoot,
+  pkg,
+  role: "consumer",
+  manifestName: ${JSON.stringify(pluginId)},
+  devPort: Number(process.env.BOS_UI_PORT) || 0,
+  webEntry: "./ui/src/routeConfig.gen.ts",
+  webExposes: { "./routeConfig": "./ui/src/routeConfig.gen.ts" },
+  nodeEntry: "./ui/src/routeConfig.gen.ts",
+  nodeExposes: { "./routeConfig": "./ui/src/routeConfig.gen.ts" },
+  routesDirectory: "./ui/src/routes",
+});
+`;
+}
+/**
+* Canonical config-layout derivation: the composition key for a plugin
+* workspace — the `<key>` of the `plugins/<key>` directory relative to the
+* nearest `bos.config.json`. The dev server and the generated ui config
+* both key off this; no consumer keeps a private copy.
+*/
+function pluginLayoutKey(cwd) {
+	const bosConfigPath = require_compose.findBosConfigPath(cwd);
+	const [workspaceGroup, layoutKey] = (bosConfigPath ? node_path.default.relative(node_path.default.dirname(bosConfigPath), cwd) : void 0)?.split(node_path.default.sep) ?? [];
+	return workspaceGroup === "plugins" && layoutKey ? layoutKey : null;
+}
+/**
+* Synthesize the rsbuild config for a folder-form ui source (the plugin
+* build contract, not per-plugin config — mirrors the rspack generated
+* config). Returns the config file path, or null when the workspace has no
+* folder-form ui source.
+*/
+function ensureGeneratedUiRsbuildConfig(cwd) {
+	if (!hasFolderFormUi(cwd)) return null;
+	const pluginId = pluginLayoutKey(cwd);
+	if (!pluginId) throw new Error(`[every-plugin] cannot derive the ui's composition key from ${cwd} — no authored config (bos.app.ts / bos.config.json) found above a plugins/<key> directory. The manifest name is the layout key; the container name is never a fallback.`);
+	const outDir = node_path.default.join(cwd, GENERATED_CONFIG_DIR);
+	node_fs.default.mkdirSync(outDir, { recursive: true });
+	const outPath = node_path.default.join(outDir, GENERATED_UI_CONFIG);
+	const next = generatedUiConfig(pluginId);
+	if (!node_fs.default.existsSync(outPath) || node_fs.default.readFileSync(outPath, "utf8") !== next) node_fs.default.writeFileSync(outPath, next);
+	return outPath;
+}
+const CORE_UI_MARKERS = {
+	routes: "src/routes",
+	contract: "src/contract.ts"
+};
+/**
+* Workspace-form core ui: the workspace IS the ui (own package.json, route
+* tree) and is not plugin-shaped — the /api counterpart of the plugin
+* workspace form. The entry stub is NOT a marker: it is generated
+* (ADR 0023), so a fresh clone has no bootstrap stubs until the first
+* generation pass.
+*/
+function hasCoreUiWorkspace(cwd = process.cwd()) {
+	return node_fs.default.existsSync(node_path.default.join(cwd, CORE_UI_MARKERS.routes)) && !node_fs.default.existsSync(node_path.default.join(cwd, CORE_UI_MARKERS.contract)) && !node_fs.default.existsSync(node_path.default.join(cwd, "plugin.dev.ts"));
+}
+function generatedCoreUiConfig() {
+	return `import { defineConfig } from "@rsbuild/core";
+import { readAuthoredConfigInput } from "everything-dev/config";
+import { createCoreUiRsbuildConfig } from "every-plugin/build/ui";
+
+export default defineConfig(async () =>
+  createCoreUiRsbuildConfig(await readAuthoredConfigInput()),
+);
+`;
+}
+/**
+* Synthesize the rsbuild config for a workspace-form core ui with no local
+* `rsbuild.config.ts` — the /api generated-config model. A local file is an
+* override and wins untouched. Returns the workspace-relative config path,
+* or null when the workspace is not a core ui (or has a local config).
+*/
+function ensureGeneratedCoreUiRsbuildConfig(cwd = process.cwd()) {
+	if (!hasCoreUiWorkspace(cwd)) return null;
+	if (node_fs.default.existsSync(node_path.default.join(cwd, "rsbuild.config.ts"))) return null;
+	const outDir = node_path.default.join(cwd, GENERATED_CONFIG_DIR);
+	node_fs.default.mkdirSync(outDir, { recursive: true });
+	const outPath = node_path.default.join(outDir, GENERATED_UI_CONFIG);
+	node_fs.default.writeFileSync(outPath, generatedCoreUiConfig());
+	console.log("[every-plugin] rsbuild.config.ts not found — using the core ui build factory.");
+	return node_path.default.join(GENERATED_CONFIG_DIR, GENERATED_UI_CONFIG);
+}
+
+//#endregion
+exports.ensureGeneratedCoreUiRsbuildConfig = ensureGeneratedCoreUiRsbuildConfig;
+exports.ensureGeneratedUiRsbuildConfig = ensureGeneratedUiRsbuildConfig;
+exports.hasCoreUiWorkspace = hasCoreUiWorkspace;
+exports.hasFolderFormUi = hasFolderFormUi;
+exports.pluginLayoutKey = pluginLayoutKey;
+//# sourceMappingURL=generated-config.cjs.map

package/dist/build/ui/generated-config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-config.cjs","names":["path","fs","findBosConfigPath"],"sources":["../../../src/build/ui/generated-config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findBosConfigPath } from \"../rspack/compose\";\n\nconst UI_DIR = \"ui\";\nconst GENERATED_CONFIG_DIR = \".every-plugin\";\nconst GENERATED_UI_CONFIG = \"ui.rsbuild.config.generated.mjs\";\n\n/**\n * Folder-form UI source: a `ui/` directory with route files but no own\n * package.json — the plugin workspace owns the build (single-workspace\n * plugin, one dev process, one deploy train). Workspace-form ui sources\n * (own package.json + scripts) are NOT managed here.\n */\nexport function hasFolderFormUi(cwd: string): boolean {\n  const uiDir = path.join(cwd, UI_DIR);\n  return (\n    fs.existsSync(path.join(uiDir, \"src\", \"routes\")) &&\n    !fs.existsSync(path.join(uiDir, \"package.json\"))\n  );\n}\n\nfunction generatedUiConfig(pluginId: string): string {\n  return `import path from \"node:path\";\nimport { createUiRsbuildConfig } from \"every-plugin/build/ui\";\nimport pkg from \"../package.json\";\n\nconst workspaceRoot = path.resolve(import.meta.dirname, \"..\", \"ui\");\n\nexport default createUiRsbuildConfig({\n  workspaceRoot,\n  pkg,\n  role: \"consumer\",\n  manifestName: ${JSON.stringify(pluginId)},\n  devPort: Number(process.env.BOS_UI_PORT) || 0,\n  webEntry: \"./ui/src/routeConfig.gen.ts\",\n  webExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  nodeEntry: \"./ui/src/routeConfig.gen.ts\",\n  nodeExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  routesDirectory: \"./ui/src/routes\",\n});\n`;\n}\n\n/**\n * Canonical config-layout derivation: the composition key for a plugin\n * workspace — the `<key>` of the `plugins/<key>` directory relative to the\n * nearest `bos.config.json`. The dev server and the generated ui config\n * both key off this; no consumer keeps a private copy.\n */\nexport function pluginLayoutKey(cwd: string): string | null {\n  const bosConfigPath = findBosConfigPath(cwd);\n  const relativeWorkspace = bosConfigPath\n    ? path.relative(path.dirname(bosConfigPath), cwd)\n    : undefined;\n  const [workspaceGroup, layoutKey] = relativeWorkspace?.split(path.sep) ?? [];\n  return workspaceGroup === \"plugins\" && layoutKey ? layoutKey : null;\n}\n\n/**\n * Synthesize the rsbuild config for a folder-form ui source (the plugin\n * build contract, not per-plugin config — mirrors the rspack generated\n * config). Returns the config file path, or null when the workspace has no\n * folder-form ui source.\n */\nexport function ensureGeneratedUiRsbuildConfig(cwd: string): string | null {\n  if (!hasFolderFormUi(cwd)) return null;\n  // The manifest's name derives ONLY from the plugins/<key> layout key\n  // (ADR 0008 §2) — a non-derivable key fails the build loudly, never the\n  // container-name fallback that mis-keyed manifests.\n  const pluginId = pluginLayoutKey(cwd);\n  if (!pluginId) {\n    throw new Error(\n      `[every-plugin] cannot derive the ui's composition key from ${cwd} — no authored config (bos.app.ts / bos.config.json) found above a plugins/<key> directory. The manifest name is the layout key; the container name is never a fallback.`,\n    );\n  }\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  const next = generatedUiConfig(pluginId);\n  if (!fs.existsSync(outPath) || fs.readFileSync(outPath, \"utf8\") !== next) {\n    fs.writeFileSync(outPath, next);\n  }\n  return outPath;\n}\n\nconst CORE_UI_MARKERS = {\n  routes: \"src/routes\",\n  contract: \"src/contract.ts\",\n};\n\n/**\n * Workspace-form core ui: the workspace IS the ui (own package.json, route\n * tree) and is not plugin-shaped — the /api counterpart of the plugin\n * workspace form. The entry stub is NOT a marker: it is generated\n * (ADR 0023), so a fresh clone has no bootstrap stubs until the first\n * generation pass.\n */\nexport function hasCoreUiWorkspace(cwd: string = process.cwd()): boolean {\n  return (\n    fs.existsSync(path.join(cwd, CORE_UI_MARKERS.routes)) &&\n    !fs.existsSync(path.join(cwd, CORE_UI_MARKERS.contract)) &&\n    !fs.existsSync(path.join(cwd, \"plugin.dev.ts\"))\n  );\n}\n\nfunction generatedCoreUiConfig(): string {\n  return `import { defineConfig } from \"@rsbuild/core\";\nimport { readAuthoredConfigInput } from \"everything-dev/config\";\nimport { createCoreUiRsbuildConfig } from \"every-plugin/build/ui\";\n\nexport default defineConfig(async () =>\n  createCoreUiRsbuildConfig(await readAuthoredConfigInput()),\n);\n`;\n}\n\n/**\n * Synthesize the rsbuild config for a workspace-form core ui with no local\n * `rsbuild.config.ts` — the /api generated-config model. A local file is an\n * override and wins untouched. Returns the workspace-relative config path,\n * or null when the workspace is not a core ui (or has a local config).\n */\nexport function ensureGeneratedCoreUiRsbuildConfig(cwd: string = process.cwd()): string | null {\n  if (!hasCoreUiWorkspace(cwd)) return null;\n  if (fs.existsSync(path.join(cwd, \"rsbuild.config.ts\"))) return null;\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  fs.writeFileSync(outPath, generatedCoreUiConfig());\n  console.log(\"[every-plugin] rsbuild.config.ts not found — using the core ui build factory.\");\n  return path.join(GENERATED_CONFIG_DIR, GENERATED_UI_CONFIG);\n}\n"],"mappings":";;;;;;;;AAIA,MAAM,SAAS;AACf,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;;;;;;;AAQ5B,SAAgB,gBAAgB,KAAsB;CACpD,MAAM,QAAQA,kBAAK,KAAK,KAAK,MAAM;CACnC,OACEC,gBAAG,WAAWD,kBAAK,KAAK,OAAO,OAAO,QAAQ,CAAC,KAC/C,CAACC,gBAAG,WAAWD,kBAAK,KAAK,OAAO,cAAc,CAAC;AAEnD;AAEA,SAAS,kBAAkB,UAA0B;CACnD,OAAO;;;;;;;;;;kBAUS,KAAK,UAAU,QAAQ,EAAE;;;;;;;;;AAS3C;;;;;;;AAQA,SAAgB,gBAAgB,KAA4B;CAC1D,MAAM,gBAAgBE,kCAAkB,GAAG;CAI3C,MAAM,CAAC,gBAAgB,cAHG,gBACtBF,kBAAK,SAASA,kBAAK,QAAQ,aAAa,GAAG,GAAG,IAC9C,OACiD,EAAE,MAAMA,kBAAK,GAAG,KAAK,CAAC;CAC3E,OAAO,mBAAmB,aAAa,YAAY,YAAY;AACjE;;;;;;;AAQA,SAAgB,+BAA+B,KAA4B;CACzE,IAAI,CAAC,gBAAgB,GAAG,GAAG,OAAO;CAIlC,MAAM,WAAW,gBAAgB,GAAG;CACpC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,8DAA8D,IAAI,yKACpE;CAEF,MAAM,SAASA,kBAAK,KAAK,KAAK,oBAAoB;CAClD,gBAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAUA,kBAAK,KAAK,QAAQ,mBAAmB;CACrD,MAAM,OAAO,kBAAkB,QAAQ;CACvC,IAAI,CAACC,gBAAG,WAAW,OAAO,KAAKA,gBAAG,aAAa,SAAS,MAAM,MAAM,MAClE,gBAAG,cAAc,SAAS,IAAI;CAEhC,OAAO;AACT;AAEA,MAAM,kBAAkB;CACtB,QAAQ;CACR,UAAU;AACZ;;;;;;;;AASA,SAAgB,mBAAmB,MAAc,QAAQ,IAAI,GAAY;CACvE,OACEA,gBAAG,WAAWD,kBAAK,KAAK,KAAK,gBAAgB,MAAM,CAAC,KACpD,CAACC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,gBAAgB,QAAQ,CAAC,KACvD,CAACC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,eAAe,CAAC;AAElD;AAEA,SAAS,wBAAgC;CACvC,OAAO;;;;;;;;AAQT;;;;;;;AAQA,SAAgB,mCAAmC,MAAc,QAAQ,IAAI,GAAkB;CAC7F,IAAI,CAAC,mBAAmB,GAAG,GAAG,OAAO;CACrC,IAAIC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,mBAAmB,CAAC,GAAG,OAAO;CAC/D,MAAM,SAASA,kBAAK,KAAK,KAAK,oBAAoB;CAClD,gBAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAUA,kBAAK,KAAK,QAAQ,mBAAmB;CACrD,gBAAG,cAAc,SAAS,sBAAsB,CAAC;CACjD,QAAQ,IAAI,+EAA+E;CAC3F,OAAOA,kBAAK,KAAK,sBAAsB,mBAAmB;AAC5D"}

package/dist/build/ui/generated-config.d.cts

@@ -0,0 +1,33 @@
+//#region src/build/ui/generated-config.d.ts
+/**
+ * Folder-form UI source: a `ui/` directory with route files but no own
+ * package.json — the plugin workspace owns the build (single-workspace
+ * plugin, one dev process, one deploy train). Workspace-form ui sources
+ * (own package.json + scripts) are NOT managed here.
+ */
+declare function hasFolderFormUi(cwd: string): boolean;
+/**
+ * Synthesize the rsbuild config for a folder-form ui source (the plugin
+ * build contract, not per-plugin config — mirrors the rspack generated
+ * config). Returns the config file path, or null when the workspace has no
+ * folder-form ui source.
+ */
+declare function ensureGeneratedUiRsbuildConfig(cwd: string): string | null;
+/**
+ * Workspace-form core ui: the workspace IS the ui (own package.json, route
+ * tree) and is not plugin-shaped — the /api counterpart of the plugin
+ * workspace form. The entry stub is NOT a marker: it is generated
+ * (ADR 0023), so a fresh clone has no bootstrap stubs until the first
+ * generation pass.
+ */
+declare function hasCoreUiWorkspace(cwd?: string): boolean;
+/**
+ * Synthesize the rsbuild config for a workspace-form core ui with no local
+ * `rsbuild.config.ts` — the /api generated-config model. A local file is an
+ * override and wins untouched. Returns the workspace-relative config path,
+ * or null when the workspace is not a core ui (or has a local config).
+ */
+declare function ensureGeneratedCoreUiRsbuildConfig(cwd?: string): string | null;
+//#endregion
+export { ensureGeneratedCoreUiRsbuildConfig, ensureGeneratedUiRsbuildConfig, hasCoreUiWorkspace, hasFolderFormUi };
+//# sourceMappingURL=generated-config.d.cts.map

package/dist/build/ui/generated-config.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-config.d.cts","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"mappings":";;;;;;;iBAcgB,gBAAgB;;;;;;;iBAmDhB,+BAA+B;;;;;;;;iBAiC/B,mBAAmB;;;;;;;iBAyBnB,mCAAmC"}

package/dist/build/ui/generated-config.d.mts

@@ -0,0 +1,33 @@
+//#region src/build/ui/generated-config.d.ts
+/**
+ * Folder-form UI source: a `ui/` directory with route files but no own
+ * package.json — the plugin workspace owns the build (single-workspace
+ * plugin, one dev process, one deploy train). Workspace-form ui sources
+ * (own package.json + scripts) are NOT managed here.
+ */
+declare function hasFolderFormUi(cwd: string): boolean;
+/**
+ * Synthesize the rsbuild config for a folder-form ui source (the plugin
+ * build contract, not per-plugin config — mirrors the rspack generated
+ * config). Returns the config file path, or null when the workspace has no
+ * folder-form ui source.
+ */
+declare function ensureGeneratedUiRsbuildConfig(cwd: string): string | null;
+/**
+ * Workspace-form core ui: the workspace IS the ui (own package.json, route
+ * tree) and is not plugin-shaped — the /api counterpart of the plugin
+ * workspace form. The entry stub is NOT a marker: it is generated
+ * (ADR 0023), so a fresh clone has no bootstrap stubs until the first
+ * generation pass.
+ */
+declare function hasCoreUiWorkspace(cwd?: string): boolean;
+/**
+ * Synthesize the rsbuild config for a workspace-form core ui with no local
+ * `rsbuild.config.ts` — the /api generated-config model. A local file is an
+ * override and wins untouched. Returns the workspace-relative config path,
+ * or null when the workspace is not a core ui (or has a local config).
+ */
+declare function ensureGeneratedCoreUiRsbuildConfig(cwd?: string): string | null;
+//#endregion
+export { ensureGeneratedCoreUiRsbuildConfig, ensureGeneratedUiRsbuildConfig, hasCoreUiWorkspace, hasFolderFormUi };
+//# sourceMappingURL=generated-config.d.mts.map

package/dist/build/ui/generated-config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-config.d.mts","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"mappings":";;;;;;;iBAcgB,gBAAgB;;;;;;;iBAmDhB,+BAA+B;;;;;;;;iBAiC/B,mBAAmB;;;;;;;iBAyBnB,mCAAmC"}

package/dist/build/ui/generated-config.mjs

@@ -0,0 +1,111 @@
+import { findBosConfigPath } from "../rspack/compose.mjs";
+import fs from "node:fs";
+import path from "node:path";
+
+//#region src/build/ui/generated-config.ts
+const UI_DIR = "ui";
+const GENERATED_CONFIG_DIR = ".every-plugin";
+const GENERATED_UI_CONFIG = "ui.rsbuild.config.generated.mjs";
+/**
+* Folder-form UI source: a `ui/` directory with route files but no own
+* package.json — the plugin workspace owns the build (single-workspace
+* plugin, one dev process, one deploy train). Workspace-form ui sources
+* (own package.json + scripts) are NOT managed here.
+*/
+function hasFolderFormUi(cwd) {
+	const uiDir = path.join(cwd, UI_DIR);
+	return fs.existsSync(path.join(uiDir, "src", "routes")) && !fs.existsSync(path.join(uiDir, "package.json"));
+}
+function generatedUiConfig(pluginId) {
+	return `import path from "node:path";
+import { createUiRsbuildConfig } from "every-plugin/build/ui";
+import pkg from "../package.json";
+
+const workspaceRoot = path.resolve(import.meta.dirname, "..", "ui");
+
+export default createUiRsbuildConfig({
+  workspaceRoot,
+  pkg,
+  role: "consumer",
+  manifestName: ${JSON.stringify(pluginId)},
+  devPort: Number(process.env.BOS_UI_PORT) || 0,
+  webEntry: "./ui/src/routeConfig.gen.ts",
+  webExposes: { "./routeConfig": "./ui/src/routeConfig.gen.ts" },
+  nodeEntry: "./ui/src/routeConfig.gen.ts",
+  nodeExposes: { "./routeConfig": "./ui/src/routeConfig.gen.ts" },
+  routesDirectory: "./ui/src/routes",
+});
+`;
+}
+/**
+* Canonical config-layout derivation: the composition key for a plugin
+* workspace — the `<key>` of the `plugins/<key>` directory relative to the
+* nearest `bos.config.json`. The dev server and the generated ui config
+* both key off this; no consumer keeps a private copy.
+*/
+function pluginLayoutKey(cwd) {
+	const bosConfigPath = findBosConfigPath(cwd);
+	const [workspaceGroup, layoutKey] = (bosConfigPath ? path.relative(path.dirname(bosConfigPath), cwd) : void 0)?.split(path.sep) ?? [];
+	return workspaceGroup === "plugins" && layoutKey ? layoutKey : null;
+}
+/**
+* Synthesize the rsbuild config for a folder-form ui source (the plugin
+* build contract, not per-plugin config — mirrors the rspack generated
+* config). Returns the config file path, or null when the workspace has no
+* folder-form ui source.
+*/
+function ensureGeneratedUiRsbuildConfig(cwd) {
+	if (!hasFolderFormUi(cwd)) return null;
+	const pluginId = pluginLayoutKey(cwd);
+	if (!pluginId) throw new Error(`[every-plugin] cannot derive the ui's composition key from ${cwd} — no authored config (bos.app.ts / bos.config.json) found above a plugins/<key> directory. The manifest name is the layout key; the container name is never a fallback.`);
+	const outDir = path.join(cwd, GENERATED_CONFIG_DIR);
+	fs.mkdirSync(outDir, { recursive: true });
+	const outPath = path.join(outDir, GENERATED_UI_CONFIG);
+	const next = generatedUiConfig(pluginId);
+	if (!fs.existsSync(outPath) || fs.readFileSync(outPath, "utf8") !== next) fs.writeFileSync(outPath, next);
+	return outPath;
+}
+const CORE_UI_MARKERS = {
+	routes: "src/routes",
+	contract: "src/contract.ts"
+};
+/**
+* Workspace-form core ui: the workspace IS the ui (own package.json, route
+* tree) and is not plugin-shaped — the /api counterpart of the plugin
+* workspace form. The entry stub is NOT a marker: it is generated
+* (ADR 0023), so a fresh clone has no bootstrap stubs until the first
+* generation pass.
+*/
+function hasCoreUiWorkspace(cwd = process.cwd()) {
+	return fs.existsSync(path.join(cwd, CORE_UI_MARKERS.routes)) && !fs.existsSync(path.join(cwd, CORE_UI_MARKERS.contract)) && !fs.existsSync(path.join(cwd, "plugin.dev.ts"));
+}
+function generatedCoreUiConfig() {
+	return `import { defineConfig } from "@rsbuild/core";
+import { readAuthoredConfigInput } from "everything-dev/config";
+import { createCoreUiRsbuildConfig } from "every-plugin/build/ui";
+
+export default defineConfig(async () =>
+  createCoreUiRsbuildConfig(await readAuthoredConfigInput()),
+);
+`;
+}
+/**
+* Synthesize the rsbuild config for a workspace-form core ui with no local
+* `rsbuild.config.ts` — the /api generated-config model. A local file is an
+* override and wins untouched. Returns the workspace-relative config path,
+* or null when the workspace is not a core ui (or has a local config).
+*/
+function ensureGeneratedCoreUiRsbuildConfig(cwd = process.cwd()) {
+	if (!hasCoreUiWorkspace(cwd)) return null;
+	if (fs.existsSync(path.join(cwd, "rsbuild.config.ts"))) return null;
+	const outDir = path.join(cwd, GENERATED_CONFIG_DIR);
+	fs.mkdirSync(outDir, { recursive: true });
+	const outPath = path.join(outDir, GENERATED_UI_CONFIG);
+	fs.writeFileSync(outPath, generatedCoreUiConfig());
+	console.log("[every-plugin] rsbuild.config.ts not found — using the core ui build factory.");
+	return path.join(GENERATED_CONFIG_DIR, GENERATED_UI_CONFIG);
+}
+
+//#endregion
+export { ensureGeneratedCoreUiRsbuildConfig, ensureGeneratedUiRsbuildConfig, hasCoreUiWorkspace, hasFolderFormUi, pluginLayoutKey };
+//# sourceMappingURL=generated-config.mjs.map

package/dist/build/ui/generated-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-config.mjs","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findBosConfigPath } from \"../rspack/compose\";\n\nconst UI_DIR = \"ui\";\nconst GENERATED_CONFIG_DIR = \".every-plugin\";\nconst GENERATED_UI_CONFIG = \"ui.rsbuild.config.generated.mjs\";\n\n/**\n * Folder-form UI source: a `ui/` directory with route files but no own\n * package.json — the plugin workspace owns the build (single-workspace\n * plugin, one dev process, one deploy train). Workspace-form ui sources\n * (own package.json + scripts) are NOT managed here.\n */\nexport function hasFolderFormUi(cwd: string): boolean {\n  const uiDir = path.join(cwd, UI_DIR);\n  return (\n    fs.existsSync(path.join(uiDir, \"src\", \"routes\")) &&\n    !fs.existsSync(path.join(uiDir, \"package.json\"))\n  );\n}\n\nfunction generatedUiConfig(pluginId: string): string {\n  return `import path from \"node:path\";\nimport { createUiRsbuildConfig } from \"every-plugin/build/ui\";\nimport pkg from \"../package.json\";\n\nconst workspaceRoot = path.resolve(import.meta.dirname, \"..\", \"ui\");\n\nexport default createUiRsbuildConfig({\n  workspaceRoot,\n  pkg,\n  role: \"consumer\",\n  manifestName: ${JSON.stringify(pluginId)},\n  devPort: Number(process.env.BOS_UI_PORT) || 0,\n  webEntry: \"./ui/src/routeConfig.gen.ts\",\n  webExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  nodeEntry: \"./ui/src/routeConfig.gen.ts\",\n  nodeExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  routesDirectory: \"./ui/src/routes\",\n});\n`;\n}\n\n/**\n * Canonical config-layout derivation: the composition key for a plugin\n * workspace — the `<key>` of the `plugins/<key>` directory relative to the\n * nearest `bos.config.json`. The dev server and the generated ui config\n * both key off this; no consumer keeps a private copy.\n */\nexport function pluginLayoutKey(cwd: string): string | null {\n  const bosConfigPath = findBosConfigPath(cwd);\n  const relativeWorkspace = bosConfigPath\n    ? path.relative(path.dirname(bosConfigPath), cwd)\n    : undefined;\n  const [workspaceGroup, layoutKey] = relativeWorkspace?.split(path.sep) ?? [];\n  return workspaceGroup === \"plugins\" && layoutKey ? layoutKey : null;\n}\n\n/**\n * Synthesize the rsbuild config for a folder-form ui source (the plugin\n * build contract, not per-plugin config — mirrors the rspack generated\n * config). Returns the config file path, or null when the workspace has no\n * folder-form ui source.\n */\nexport function ensureGeneratedUiRsbuildConfig(cwd: string): string | null {\n  if (!hasFolderFormUi(cwd)) return null;\n  // The manifest's name derives ONLY from the plugins/<key> layout key\n  // (ADR 0008 §2) — a non-derivable key fails the build loudly, never the\n  // container-name fallback that mis-keyed manifests.\n  const pluginId = pluginLayoutKey(cwd);\n  if (!pluginId) {\n    throw new Error(\n      `[every-plugin] cannot derive the ui's composition key from ${cwd} — no authored config (bos.app.ts / bos.config.json) found above a plugins/<key> directory. The manifest name is the layout key; the container name is never a fallback.`,\n    );\n  }\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  const next = generatedUiConfig(pluginId);\n  if (!fs.existsSync(outPath) || fs.readFileSync(outPath, \"utf8\") !== next) {\n    fs.writeFileSync(outPath, next);\n  }\n  return outPath;\n}\n\nconst CORE_UI_MARKERS = {\n  routes: \"src/routes\",\n  contract: \"src/contract.ts\",\n};\n\n/**\n * Workspace-form core ui: the workspace IS the ui (own package.json, route\n * tree) and is not plugin-shaped — the /api counterpart of the plugin\n * workspace form. The entry stub is NOT a marker: it is generated\n * (ADR 0023), so a fresh clone has no bootstrap stubs until the first\n * generation pass.\n */\nexport function hasCoreUiWorkspace(cwd: string = process.cwd()): boolean {\n  return (\n    fs.existsSync(path.join(cwd, CORE_UI_MARKERS.routes)) &&\n    !fs.existsSync(path.join(cwd, CORE_UI_MARKERS.contract)) &&\n    !fs.existsSync(path.join(cwd, \"plugin.dev.ts\"))\n  );\n}\n\nfunction generatedCoreUiConfig(): string {\n  return `import { defineConfig } from \"@rsbuild/core\";\nimport { readAuthoredConfigInput } from \"everything-dev/config\";\nimport { createCoreUiRsbuildConfig } from \"every-plugin/build/ui\";\n\nexport default defineConfig(async () =>\n  createCoreUiRsbuildConfig(await readAuthoredConfigInput()),\n);\n`;\n}\n\n/**\n * Synthesize the rsbuild config for a workspace-form core ui with no local\n * `rsbuild.config.ts` — the /api generated-config model. A local file is an\n * override and wins untouched. Returns the workspace-relative config path,\n * or null when the workspace is not a core ui (or has a local config).\n */\nexport function ensureGeneratedCoreUiRsbuildConfig(cwd: string = process.cwd()): string | null {\n  if (!hasCoreUiWorkspace(cwd)) return null;\n  if (fs.existsSync(path.join(cwd, \"rsbuild.config.ts\"))) return null;\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  fs.writeFileSync(outPath, generatedCoreUiConfig());\n  console.log(\"[every-plugin] rsbuild.config.ts not found — using the core ui build factory.\");\n  return path.join(GENERATED_CONFIG_DIR, GENERATED_UI_CONFIG);\n}\n"],"mappings":";;;;;AAIA,MAAM,SAAS;AACf,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;;;;;;;AAQ5B,SAAgB,gBAAgB,KAAsB;CACpD,MAAM,QAAQ,KAAK,KAAK,KAAK,MAAM;CACnC,OACE,GAAG,WAAW,KAAK,KAAK,OAAO,OAAO,QAAQ,CAAC,KAC/C,CAAC,GAAG,WAAW,KAAK,KAAK,OAAO,cAAc,CAAC;AAEnD;AAEA,SAAS,kBAAkB,UAA0B;CACnD,OAAO;;;;;;;;;;kBAUS,KAAK,UAAU,QAAQ,EAAE;;;;;;;;;AAS3C;;;;;;;AAQA,SAAgB,gBAAgB,KAA4B;CAC1D,MAAM,gBAAgB,kBAAkB,GAAG;CAI3C,MAAM,CAAC,gBAAgB,cAHG,gBACtB,KAAK,SAAS,KAAK,QAAQ,aAAa,GAAG,GAAG,IAC9C,OACiD,EAAE,MAAM,KAAK,GAAG,KAAK,CAAC;CAC3E,OAAO,mBAAmB,aAAa,YAAY,YAAY;AACjE;;;;;;;AAQA,SAAgB,+BAA+B,KAA4B;CACzE,IAAI,CAAC,gBAAgB,GAAG,GAAG,OAAO;CAIlC,MAAM,WAAW,gBAAgB,GAAG;CACpC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,8DAA8D,IAAI,yKACpE;CAEF,MAAM,SAAS,KAAK,KAAK,KAAK,oBAAoB;CAClD,GAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAU,KAAK,KAAK,QAAQ,mBAAmB;CACrD,MAAM,OAAO,kBAAkB,QAAQ;CACvC,IAAI,CAAC,GAAG,WAAW,OAAO,KAAK,GAAG,aAAa,SAAS,MAAM,MAAM,MAClE,GAAG,cAAc,SAAS,IAAI;CAEhC,OAAO;AACT;AAEA,MAAM,kBAAkB;CACtB,QAAQ;CACR,UAAU;AACZ;;;;;;;;AASA,SAAgB,mBAAmB,MAAc,QAAQ,IAAI,GAAY;CACvE,OACE,GAAG,WAAW,KAAK,KAAK,KAAK,gBAAgB,MAAM,CAAC,KACpD,CAAC,GAAG,WAAW,KAAK,KAAK,KAAK,gBAAgB,QAAQ,CAAC,KACvD,CAAC,GAAG,WAAW,KAAK,KAAK,KAAK,eAAe,CAAC;AAElD;AAEA,SAAS,wBAAgC;CACvC,OAAO;;;;;;;;AAQT;;;;;;;AAQA,SAAgB,mCAAmC,MAAc,QAAQ,IAAI,GAAkB;CAC7F,IAAI,CAAC,mBAAmB,GAAG,GAAG,OAAO;CACrC,IAAI,GAAG,WAAW,KAAK,KAAK,KAAK,mBAAmB,CAAC,GAAG,OAAO;CAC/D,MAAM,SAAS,KAAK,KAAK,KAAK,oBAAoB;CAClD,GAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAU,KAAK,KAAK,QAAQ,mBAAmB;CACrD,GAAG,cAAc,SAAS,sBAAsB,CAAC;CACjD,QAAQ,IAAI,+EAA+E;CAC3F,OAAO,KAAK,KAAK,sBAAsB,mBAAmB;AAC5D"}

package/dist/build/ui/hash-artifacts-plugin.cjs

@@ -0,0 +1,61 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_build_artifact_names = require('../artifact-names.cjs');
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+
+//#region src/build/ui/hash-artifacts-plugin.ts
+function listFiles(dir, out = []) {
+	for (const entry of node_fs.default.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+		const full = node_path.default.join(dir, entry.name);
+		if (entry.isDirectory()) listFiles(full, out);
+		else out.push(node_path.default.relative(dir, full).split(node_path.default.sep).join("/"));
+	}
+	return out;
+}
+/**
+* Emits the additive hashed copies for one environment's dist root (ticket:
+* atomic-deploys 01). The entry itself is hashed by the build (filename
+* template); this plugin adds immutable hashed copies of the fixed-name
+* browser artifacts (mf-manifest.json at the root, style.css under
+* static/css), and `build-report.json` for the deploy leg. Idempotent under
+* watch: same bytes → same hashed names.
+*/
+function hashArtifactsPlugin(options) {
+	return {
+		name: "hash-artifacts",
+		setup(api) {
+			api.onAfterEnvironmentCompile(() => {
+				const distRoot = options.distRoot;
+				if (!node_fs.default.existsSync(distRoot)) return;
+				const resolveExisting = (name) => {
+					return [node_path.default.join(distRoot, name), node_path.default.join(distRoot, "static", "css", name)].find((candidate) => node_fs.default.existsSync(candidate)) ?? null;
+				};
+				const assetNames = listFiles(distRoot);
+				if (!require_build_artifact_names.findHashedEntry(assetNames, options.entryBase)) return;
+				const contents = {};
+				for (const fixedName of [require_build_artifact_names.MF_MANIFEST_FILENAME, require_build_artifact_names.STYLE_FILENAME]) {
+					const from = resolveExisting(fixedName);
+					if (from) contents[fixedName] = node_fs.default.readFileSync(from, "utf8");
+				}
+				const plan = require_build_artifact_names.planArtifactCopies({
+					assetNames,
+					entryBase: options.entryBase,
+					contents
+				});
+				if (!plan) return;
+				for (const copy of plan.copies) {
+					const from = resolveExisting(copy.from);
+					if (!from) throw new Error(`[hash-artifacts] planned copy source missing: ${copy.from}`);
+					node_fs.default.copyFileSync(from, node_path.default.join(distRoot, copy.to));
+				}
+				node_fs.default.writeFileSync(node_path.default.join(distRoot, "build-report.json"), `${JSON.stringify(require_build_artifact_names.BuildEntryReportSchema.parse(plan.report), null, 2)}\n`);
+			});
+		}
+	};
+}
+
+//#endregion
+exports.hashArtifactsPlugin = hashArtifactsPlugin;
+//# sourceMappingURL=hash-artifacts-plugin.cjs.map

package/dist/build/ui/hash-artifacts-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-artifacts-plugin.cjs","names":["fs","path","findHashedEntry","MF_MANIFEST_FILENAME","STYLE_FILENAME","planArtifactCopies","BuildEntryReportSchema"],"sources":["../../../src/build/ui/hash-artifacts-plugin.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { RsbuildPlugin } from \"@rsbuild/core\";\nimport {\n  BuildEntryReportSchema,\n  findHashedEntry,\n  MF_MANIFEST_FILENAME,\n  planArtifactCopies,\n  STYLE_FILENAME,\n} from \"../artifact-names\";\n\nexport interface HashArtifactsPluginOptions {\n  /** The container entry's base name in this environment's dist root. */\n  entryBase: string;\n  /** Absolute dist root this environment wrote (web: `dist`, node: `dist/ssr`). */\n  distRoot: string;\n}\n\nfunction listFiles(dir: string, out: string[] = []): string[] {\n  for (const entry of fs\n    .readdirSync(dir, { withFileTypes: true })\n    .sort((a, b) => a.name.localeCompare(b.name))) {\n    const full = path.join(dir, entry.name);\n    if (entry.isDirectory()) listFiles(full, out);\n    else out.push(path.relative(dir, full).split(path.sep).join(\"/\"));\n  }\n  return out;\n}\n\n/**\n * Emits the additive hashed copies for one environment's dist root (ticket:\n * atomic-deploys 01). The entry itself is hashed by the build (filename\n * template); this plugin adds immutable hashed copies of the fixed-name\n * browser artifacts (mf-manifest.json at the root, style.css under\n * static/css), and `build-report.json` for the deploy leg. Idempotent under\n * watch: same bytes → same hashed names.\n */\nexport function hashArtifactsPlugin(options: HashArtifactsPluginOptions): RsbuildPlugin {\n  return {\n    name: \"hash-artifacts\",\n    setup(api) {\n      api.onAfterEnvironmentCompile(() => {\n        const distRoot = options.distRoot;\n        if (!fs.existsSync(distRoot)) return;\n\n        const resolveExisting = (name: string): string | null => {\n          const candidates = [\n            path.join(distRoot, name),\n            path.join(distRoot, \"static\", \"css\", name),\n          ];\n          return candidates.find((candidate) => fs.existsSync(candidate)) ?? null;\n        };\n\n        const assetNames = listFiles(distRoot);\n        const entry = findHashedEntry(assetNames, options.entryBase);\n        if (!entry) return;\n\n        const contents: Record<string, string> = {};\n        for (const fixedName of [MF_MANIFEST_FILENAME, STYLE_FILENAME]) {\n          const from = resolveExisting(fixedName);\n          if (from) contents[fixedName] = fs.readFileSync(from, \"utf8\");\n        }\n\n        const plan = planArtifactCopies({ assetNames, entryBase: options.entryBase, contents });\n        if (!plan) return;\n\n        for (const copy of plan.copies) {\n          const from = resolveExisting(copy.from);\n          if (!from) throw new Error(`[hash-artifacts] planned copy source missing: ${copy.from}`);\n          fs.copyFileSync(from, path.join(distRoot, copy.to));\n        }\n        fs.writeFileSync(\n          path.join(distRoot, \"build-report.json\"),\n          `${JSON.stringify(BuildEntryReportSchema.parse(plan.report), null, 2)}\\n`,\n        );\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAkBA,SAAS,UAAU,KAAa,MAAgB,CAAC,GAAa;CAC5D,KAAK,MAAM,SAASA,gBACjB,YAAY,KAAK,EAAE,eAAe,KAAK,CAAC,CAAC,CACzC,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC,GAAG;EAC/C,MAAM,OAAOC,kBAAK,KAAK,KAAK,MAAM,IAAI;EACtC,IAAI,MAAM,YAAY,GAAG,UAAU,MAAM,GAAG;OACvC,IAAI,KAAKA,kBAAK,SAAS,KAAK,IAAI,CAAC,CAAC,MAAMA,kBAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;CAClE;CACA,OAAO;AACT;;;;;;;;;AAUA,SAAgB,oBAAoB,SAAoD;CACtF,OAAO;EACL,MAAM;EACN,MAAM,KAAK;GACT,IAAI,gCAAgC;IAClC,MAAM,WAAW,QAAQ;IACzB,IAAI,CAACD,gBAAG,WAAW,QAAQ,GAAG;IAE9B,MAAM,mBAAmB,SAAgC;KAKvD,OAAO,CAHLC,kBAAK,KAAK,UAAU,IAAI,GACxBA,kBAAK,KAAK,UAAU,UAAU,OAAO,IAAI,CAE3B,CAAC,CAAC,MAAM,cAAcD,gBAAG,WAAW,SAAS,CAAC,KAAK;IACrE;IAEA,MAAM,aAAa,UAAU,QAAQ;IAErC,IAAI,CADUE,6CAAgB,YAAY,QAAQ,SACzC,GAAG;IAEZ,MAAM,WAAmC,CAAC;IAC1C,KAAK,MAAM,aAAa,CAACC,mDAAsBC,2CAAc,GAAG;KAC9D,MAAM,OAAO,gBAAgB,SAAS;KACtC,IAAI,MAAM,SAAS,aAAaJ,gBAAG,aAAa,MAAM,MAAM;IAC9D;IAEA,MAAM,OAAOK,gDAAmB;KAAE;KAAY,WAAW,QAAQ;KAAW;IAAS,CAAC;IACtF,IAAI,CAAC,MAAM;IAEX,KAAK,MAAM,QAAQ,KAAK,QAAQ;KAC9B,MAAM,OAAO,gBAAgB,KAAK,IAAI;KACtC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,iDAAiD,KAAK,MAAM;KACvF,gBAAG,aAAa,MAAMJ,kBAAK,KAAK,UAAU,KAAK,EAAE,CAAC;IACpD;IACA,gBAAG,cACDA,kBAAK,KAAK,UAAU,mBAAmB,GACvC,GAAG,KAAK,UAAUK,oDAAuB,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC,EAAE,GACxE;GACF,CAAC;EACH;CACF;AACF"}

package/dist/build/ui/hash-artifacts-plugin.d.cts

@@ -0,0 +1,20 @@
+import { RsbuildPlugin } from "@rsbuild/core";
+//#region src/build/ui/hash-artifacts-plugin.d.ts
+interface HashArtifactsPluginOptions {
+  /** The container entry's base name in this environment's dist root. */
+  entryBase: string;
+  /** Absolute dist root this environment wrote (web: `dist`, node: `dist/ssr`). */
+  distRoot: string;
+}
+/**
+ * Emits the additive hashed copies for one environment's dist root (ticket:
+ * atomic-deploys 01). The entry itself is hashed by the build (filename
+ * template); this plugin adds immutable hashed copies of the fixed-name
+ * browser artifacts (mf-manifest.json at the root, style.css under
+ * static/css), and `build-report.json` for the deploy leg. Idempotent under
+ * watch: same bytes → same hashed names.
+ */
+declare function hashArtifactsPlugin(options: HashArtifactsPluginOptions): RsbuildPlugin;
+//#endregion
+export { HashArtifactsPluginOptions, hashArtifactsPlugin };
+//# sourceMappingURL=hash-artifacts-plugin.d.cts.map

package/dist/build/ui/hash-artifacts-plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-artifacts-plugin.d.cts","names":[],"sources":["../../../src/build/ui/hash-artifacts-plugin.ts"],"mappings":";;UAWiB;;EAEf;;EAEA;;;;;;;;;;iBAsBc,oBAAoB,SAAS,6BAA6B"}

package/dist/build/ui/hash-artifacts-plugin.d.mts

@@ -0,0 +1,20 @@
+import { RsbuildPlugin } from "@rsbuild/core";
+//#region src/build/ui/hash-artifacts-plugin.d.ts
+interface HashArtifactsPluginOptions {
+  /** The container entry's base name in this environment's dist root. */
+  entryBase: string;
+  /** Absolute dist root this environment wrote (web: `dist`, node: `dist/ssr`). */
+  distRoot: string;
+}
+/**
+ * Emits the additive hashed copies for one environment's dist root (ticket:
+ * atomic-deploys 01). The entry itself is hashed by the build (filename
+ * template); this plugin adds immutable hashed copies of the fixed-name
+ * browser artifacts (mf-manifest.json at the root, style.css under
+ * static/css), and `build-report.json` for the deploy leg. Idempotent under
+ * watch: same bytes → same hashed names.
+ */
+declare function hashArtifactsPlugin(options: HashArtifactsPluginOptions): RsbuildPlugin;
+//#endregion
+export { HashArtifactsPluginOptions, hashArtifactsPlugin };
+//# sourceMappingURL=hash-artifacts-plugin.d.mts.map

package/dist/build/ui/hash-artifacts-plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-artifacts-plugin.d.mts","names":[],"sources":["../../../src/build/ui/hash-artifacts-plugin.ts"],"mappings":";;UAWiB;;EAEf;;EAEA;;;;;;;;;;iBAsBc,oBAAoB,SAAS,6BAA6B"}

package/dist/build/ui/hash-artifacts-plugin.mjs

@@ -0,0 +1,58 @@
+import { BuildEntryReportSchema, MF_MANIFEST_FILENAME, STYLE_FILENAME, findHashedEntry, planArtifactCopies } from "../artifact-names.mjs";
+import fs from "node:fs";
+import path from "node:path";
+
+//#region src/build/ui/hash-artifacts-plugin.ts
+function listFiles(dir, out = []) {
+	for (const entry of fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+		const full = path.join(dir, entry.name);
+		if (entry.isDirectory()) listFiles(full, out);
+		else out.push(path.relative(dir, full).split(path.sep).join("/"));
+	}
+	return out;
+}
+/**
+* Emits the additive hashed copies for one environment's dist root (ticket:
+* atomic-deploys 01). The entry itself is hashed by the build (filename
+* template); this plugin adds immutable hashed copies of the fixed-name
+* browser artifacts (mf-manifest.json at the root, style.css under
+* static/css), and `build-report.json` for the deploy leg. Idempotent under
+* watch: same bytes → same hashed names.
+*/
+function hashArtifactsPlugin(options) {
+	return {
+		name: "hash-artifacts",
+		setup(api) {
+			api.onAfterEnvironmentCompile(() => {
+				const distRoot = options.distRoot;
+				if (!fs.existsSync(distRoot)) return;
+				const resolveExisting = (name) => {
+					return [path.join(distRoot, name), path.join(distRoot, "static", "css", name)].find((candidate) => fs.existsSync(candidate)) ?? null;
+				};
+				const assetNames = listFiles(distRoot);
+				if (!findHashedEntry(assetNames, options.entryBase)) return;
+				const contents = {};
+				for (const fixedName of [MF_MANIFEST_FILENAME, STYLE_FILENAME]) {
+					const from = resolveExisting(fixedName);
+					if (from) contents[fixedName] = fs.readFileSync(from, "utf8");
+				}
+				const plan = planArtifactCopies({
+					assetNames,
+					entryBase: options.entryBase,
+					contents
+				});
+				if (!plan) return;
+				for (const copy of plan.copies) {
+					const from = resolveExisting(copy.from);
+					if (!from) throw new Error(`[hash-artifacts] planned copy source missing: ${copy.from}`);
+					fs.copyFileSync(from, path.join(distRoot, copy.to));
+				}
+				fs.writeFileSync(path.join(distRoot, "build-report.json"), `${JSON.stringify(BuildEntryReportSchema.parse(plan.report), null, 2)}\n`);
+			});
+		}
+	};
+}
+
+//#endregion
+export { hashArtifactsPlugin };
+//# sourceMappingURL=hash-artifacts-plugin.mjs.map

package/dist/build/ui/hash-artifacts-plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-artifacts-plugin.mjs","names":[],"sources":["../../../src/build/ui/hash-artifacts-plugin.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { RsbuildPlugin } from \"@rsbuild/core\";\nimport {\n  BuildEntryReportSchema,\n  findHashedEntry,\n  MF_MANIFEST_FILENAME,\n  planArtifactCopies,\n  STYLE_FILENAME,\n} from \"../artifact-names\";\n\nexport interface HashArtifactsPluginOptions {\n  /** The container entry's base name in this environment's dist root. */\n  entryBase: string;\n  /** Absolute dist root this environment wrote (web: `dist`, node: `dist/ssr`). */\n  distRoot: string;\n}\n\nfunction listFiles(dir: string, out: string[] = []): string[] {\n  for (const entry of fs\n    .readdirSync(dir, { withFileTypes: true })\n    .sort((a, b) => a.name.localeCompare(b.name))) {\n    const full = path.join(dir, entry.name);\n    if (entry.isDirectory()) listFiles(full, out);\n    else out.push(path.relative(dir, full).split(path.sep).join(\"/\"));\n  }\n  return out;\n}\n\n/**\n * Emits the additive hashed copies for one environment's dist root (ticket:\n * atomic-deploys 01). The entry itself is hashed by the build (filename\n * template); this plugin adds immutable hashed copies of the fixed-name\n * browser artifacts (mf-manifest.json at the root, style.css under\n * static/css), and `build-report.json` for the deploy leg. Idempotent under\n * watch: same bytes → same hashed names.\n */\nexport function hashArtifactsPlugin(options: HashArtifactsPluginOptions): RsbuildPlugin {\n  return {\n    name: \"hash-artifacts\",\n    setup(api) {\n      api.onAfterEnvironmentCompile(() => {\n        const distRoot = options.distRoot;\n        if (!fs.existsSync(distRoot)) return;\n\n        const resolveExisting = (name: string): string | null => {\n          const candidates = [\n            path.join(distRoot, name),\n            path.join(distRoot, \"static\", \"css\", name),\n          ];\n          return candidates.find((candidate) => fs.existsSync(candidate)) ?? null;\n        };\n\n        const assetNames = listFiles(distRoot);\n        const entry = findHashedEntry(assetNames, options.entryBase);\n        if (!entry) return;\n\n        const contents: Record<string, string> = {};\n        for (const fixedName of [MF_MANIFEST_FILENAME, STYLE_FILENAME]) {\n          const from = resolveExisting(fixedName);\n          if (from) contents[fixedName] = fs.readFileSync(from, \"utf8\");\n        }\n\n        const plan = planArtifactCopies({ assetNames, entryBase: options.entryBase, contents });\n        if (!plan) return;\n\n        for (const copy of plan.copies) {\n          const from = resolveExisting(copy.from);\n          if (!from) throw new Error(`[hash-artifacts] planned copy source missing: ${copy.from}`);\n          fs.copyFileSync(from, path.join(distRoot, copy.to));\n        }\n        fs.writeFileSync(\n          path.join(distRoot, \"build-report.json\"),\n          `${JSON.stringify(BuildEntryReportSchema.parse(plan.report), null, 2)}\\n`,\n        );\n      });\n    },\n  };\n}\n"],"mappings":";;;;;AAkBA,SAAS,UAAU,KAAa,MAAgB,CAAC,GAAa;CAC5D,KAAK,MAAM,SAAS,GACjB,YAAY,KAAK,EAAE,eAAe,KAAK,CAAC,CAAC,CACzC,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC,GAAG;EAC/C,MAAM,OAAO,KAAK,KAAK,KAAK,MAAM,IAAI;EACtC,IAAI,MAAM,YAAY,GAAG,UAAU,MAAM,GAAG;OACvC,IAAI,KAAK,KAAK,SAAS,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;CAClE;CACA,OAAO;AACT;;;;;;;;;AAUA,SAAgB,oBAAoB,SAAoD;CACtF,OAAO;EACL,MAAM;EACN,MAAM,KAAK;GACT,IAAI,gCAAgC;IAClC,MAAM,WAAW,QAAQ;IACzB,IAAI,CAAC,GAAG,WAAW,QAAQ,GAAG;IAE9B,MAAM,mBAAmB,SAAgC;KAKvD,OAAO,CAHL,KAAK,KAAK,UAAU,IAAI,GACxB,KAAK,KAAK,UAAU,UAAU,OAAO,IAAI,CAE3B,CAAC,CAAC,MAAM,cAAc,GAAG,WAAW,SAAS,CAAC,KAAK;IACrE;IAEA,MAAM,aAAa,UAAU,QAAQ;IAErC,IAAI,CADU,gBAAgB,YAAY,QAAQ,SACzC,GAAG;IAEZ,MAAM,WAAmC,CAAC;IAC1C,KAAK,MAAM,aAAa,CAAC,sBAAsB,cAAc,GAAG;KAC9D,MAAM,OAAO,gBAAgB,SAAS;KACtC,IAAI,MAAM,SAAS,aAAa,GAAG,aAAa,MAAM,MAAM;IAC9D;IAEA,MAAM,OAAO,mBAAmB;KAAE;KAAY,WAAW,QAAQ;KAAW;IAAS,CAAC;IACtF,IAAI,CAAC,MAAM;IAEX,KAAK,MAAM,QAAQ,KAAK,QAAQ;KAC9B,MAAM,OAAO,gBAAgB,KAAK,IAAI;KACtC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,iDAAiD,KAAK,MAAM;KACvF,GAAG,aAAa,MAAM,KAAK,KAAK,UAAU,KAAK,EAAE,CAAC;IACpD;IACA,GAAG,cACD,KAAK,KAAK,UAAU,mBAAmB,GACvC,GAAG,KAAK,UAAU,uBAAuB,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC,EAAE,GACxE;GACF,CAAC;EACH;CACF;AACF"}