@agimon-ai/po 0.0.0-alpha.0

package/dist/src/builders/web/index.cjs

@@ -0,0 +1,361 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_packageUrl = require("../server/packageUrl.cjs");
+const require_webPluginManifest = require("./webPluginManifest.cjs");
+const require_webPluginScan = require("./webPluginScan.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);
+let node_child_process = require("node:child_process");
+let node_module = require("node:module");
+let node_crypto = require("node:crypto");
+node_crypto = require_runtime.__toESM(node_crypto, 1);
+//#region src/builders/web/index.ts
+const WEB_PACKAGE = "@agimon-ai/po-web";
+const WEB_PACKAGE_ROOT_ENV = "PO_WEB_PACKAGE_ROOT";
+/** The package roots a set of compositions activates, each once. */
+function compositionPackageRoots(compositions) {
+	return [...new Set(compositions.flatMap((composition) => composition.packageEntries).map(packageRootOf).filter((root) => root !== void 0))];
+}
+/** Walks from a resolved module path up to the directory owning its package.json. */
+function packageRootOf(entryPath) {
+	let dir = node_path.default.dirname(entryPath);
+	for (;;) {
+		if (node_fs.default.existsSync(node_path.default.join(dir, "package.json"))) return dir;
+		const parent = node_path.default.dirname(dir);
+		if (parent === dir) return void 0;
+		dir = parent;
+	}
+}
+function resolveWebPackageRoot(repoRoot, environment) {
+	const override = environment[WEB_PACKAGE_ROOT_ENV];
+	if (override !== void 0 && override !== "") return node_path.default.resolve(override);
+	try {
+		return node_path.default.dirname((0, node_module.createRequire)(node_path.default.join(repoRoot, "package.json")).resolve(`${WEB_PACKAGE}/package.json`));
+	} catch {
+		try {
+			return node_path.default.dirname((0, node_module.createRequire)(require("url").pathToFileURL(__filename).href).resolve(`${WEB_PACKAGE}/package.json`));
+		} catch {
+			return;
+		}
+	}
+}
+/** The installed po-web host version the global web build would use, or `none` when it is not installed. */
+function webHostVersion(poHome, environment = process.env) {
+	const webRoot = resolveWebPackageRoot(poHome, environment);
+	if (webRoot === void 0) return "none";
+	try {
+		const manifest = JSON.parse(node_fs.default.readFileSync(node_path.default.join(webRoot, "package.json"), "utf8"));
+		return typeof manifest.version === "string" ? manifest.version : "unversioned";
+	} catch (error) {
+		return `unreadable:${error instanceof Error ? error.message : String(error)}`;
+	}
+}
+/** Bumped whenever the build's output layout changes, so an old layout is never reused. */
+const GLOBAL_BUILD_FORMAT = "global-web-4";
+/** The record every keyed global build writes last, so a key directory holding it is complete. */
+const BUILD_RECORD = "build.json";
+const BUILD_CHILD_SCRIPT = `
+const [bundleUrl, request] = process.argv.slice(1);
+try {
+  const { bundleCockpitWeb } = await import(bundleUrl);
+  const { hostRoot, pluginRoots, outDir } = JSON.parse(request);
+  const result = await bundleCockpitWeb({
+    hostRoot,
+    pluginRoots,
+    outDir,
+    onNotice: (message) => process.stderr.write(message + '\\n'),
+  });
+  process.stdout.write(JSON.stringify(result));
+} catch (error) {
+  process.stderr.write(error instanceof Error ? (error.stack ?? error.message) : String(error));
+  process.exitCode = 1;
+}
+`;
+/**
+* The size+mtime signature of every file a plugin package hands the build: its manifest
+* plus the whole top-level folder of the client entry and of each declared export, so an
+* edited import or a rebuilt dist chunk changes the key, not only the entry file.
+*/
+function packageSignature(packageDir, entries) {
+	try {
+		const files = /* @__PURE__ */ new Set();
+		for (const entry of entries) for (const file of require_packageUrl.snapshotFiles(packageDir, entry)) files.add(file);
+		return require_packageUrl.statSignature(packageDir, [...files].sort());
+	} catch (error) {
+		return `unreadable:${error instanceof Error ? error.message : String(error)}`;
+	}
+}
+/**
+* The content key of a build: the format, the host package when there is one, then every
+* plugin package's file signature. A changed source or dist file or a changed plugin set
+* yields a new key; roots that declare no plugin do not take part.
+*/
+function globalBuildKey(format, hostRoot, plugins) {
+	const hash = node_crypto.default.createHash("sha256").update(format);
+	if (hostRoot !== void 0) hash.update(`host:${hostRoot}:${node_fs.default.readFileSync(node_path.default.join(hostRoot, "package.json"), "utf8")}`);
+	const entries = /* @__PURE__ */ new Map();
+	for (const plugin of [...plugins].sort((a, b) => require_webPluginManifest.compareCodeUnits(a.pluginId, b.pluginId))) {
+		hash.update(`\0${plugin.pluginId}:${plugin.packageDir}:${plugin.client.entry}`);
+		const list = entries.get(plugin.packageDir) ?? [];
+		list.push(node_path.default.join(plugin.packageDir, plugin.client.entry));
+		entries.set(plugin.packageDir, list);
+	}
+	for (const packageDir of [...entries.keys()].sort()) hash.update(`\0${packageDir}\0${packageSignature(packageDir, entries.get(packageDir) ?? [])}`);
+	return hash.digest("hex").slice(0, 32);
+}
+function bundleModuleUrl() {
+	const extension = require("url").pathToFileURL(__filename).href.endsWith(".ts") ? "ts" : "mjs";
+	return new URL(`./bundle.${extension}`, require("url").pathToFileURL(__filename).href).href;
+}
+/** Runs Vite in a child process so its module graph and caches never stay in the server heap. */
+function runBuildProcess(request, environment, onNotice) {
+	const args = [
+		...process.execArgv,
+		"--input-type=module",
+		"--eval",
+		BUILD_CHILD_SCRIPT,
+		bundleModuleUrl(),
+		JSON.stringify(request)
+	];
+	return new Promise((resolve, reject) => {
+		(0, node_child_process.execFile)(process.execPath, args, {
+			cwd: request.hostRoot,
+			env: environment,
+			encoding: "utf8",
+			maxBuffer: 67108864
+		}, (error, stdout, stderr) => {
+			if (error) {
+				reject(new Error(`${stderr || stdout}`.trim() || `Web build exited with code ${String(error.code ?? 1)}`));
+				return;
+			}
+			for (const line of stderr.split("\n")) if (line.trim()) onNotice(line.trim());
+			resolve(JSON.parse(stdout));
+		});
+	});
+}
+/** A key directory's parsed build record, or undefined when the build is not there (yet). */
+function readBuildJson(directory) {
+	try {
+		return JSON.parse(node_fs.default.readFileSync(node_path.default.join(directory, BUILD_RECORD), "utf8"));
+	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
+		throw error;
+	}
+}
+function readBuildRecord(directory) {
+	const record = readBuildJson(directory);
+	if (record === void 0) return void 0;
+	return {
+		...record,
+		webDirectory: node_path.default.join(directory, "web"),
+		pluginsDirectory: node_path.default.join(directory, "plugins")
+	};
+}
+function webBuildsRoot(poHome) {
+	return node_path.default.join(poHome, "build", "web");
+}
+/** The complete global web build of one key, or undefined when it is not there. Never builds. */
+function readGlobalWebBuildRecord(poHome, key) {
+	return readBuildRecord(node_path.default.join(webBuildsRoot(poHome), key));
+}
+/**
+* The key of the most recently written complete global web build, for a server that starts
+* before sync ever wrote a pointer. Temporary build folders start with a dot and are skipped.
+*/
+function newestGlobalWebBuildKey(poHome) {
+	const root = webBuildsRoot(poHome);
+	if (!node_fs.default.existsSync(root)) return void 0;
+	return node_fs.default.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith(".")).map((entry) => ({
+		name: entry.name,
+		file: node_path.default.join(root, entry.name, BUILD_RECORD)
+	})).filter((entry) => node_fs.default.existsSync(entry.file)).map((entry) => ({
+		name: entry.name,
+		modified: node_fs.default.statSync(entry.file).mtimeMs
+	})).sort((left, right) => right.modified - left.modified)[0]?.name;
+}
+/**
+* Builds into a temporary sibling of `directory`, writes the build record last, and renames
+* the result into place, so a key directory is always complete. Losing the rename to another
+* process that finished the same key is fine: its bytes are identical.
+*/
+async function buildKeyDirectory(buildsRoot, key, directory, build) {
+	node_fs.default.mkdirSync(buildsRoot, { recursive: true });
+	const temporary = node_fs.default.mkdtempSync(node_path.default.join(buildsRoot, `.${key}-`));
+	try {
+		const record = await build(temporary);
+		node_fs.default.writeFileSync(node_path.default.join(temporary, BUILD_RECORD), `${JSON.stringify(record, null, 2)}\n`);
+		try {
+			node_fs.default.renameSync(temporary, directory);
+		} catch (error) {
+			if (readBuildJson(directory) === void 0) throw error;
+		}
+	} finally {
+		node_fs.default.rmSync(temporary, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+const pendingBuilds = /* @__PURE__ */ new Map();
+/** Joins a build of the same key that is already running in this process instead of starting another. */
+async function singleFlightBuild(key, run) {
+	const pending = pendingBuilds.get(key);
+	if (pending !== void 0) return pending;
+	const started = run();
+	pendingBuilds.set(key, started);
+	try {
+		return await started;
+	} finally {
+		pendingBuilds.delete(key);
+	}
+}
+/** The build key for these plugin roots and where its build lives, without building anything. */
+function resolveGlobalWebBuild(input) {
+	const environment = input.environment ?? process.env;
+	const webRoot = (input.resolveWebRoot ?? resolveWebPackageRoot)(input.poHome, environment);
+	if (webRoot === void 0 || !node_fs.default.existsSync(node_path.default.join(webRoot, "package.json"))) return {
+		status: "skipped",
+		reason: `${WEB_PACKAGE} is not installed; no web composition is published`
+	};
+	const pluginRoots = [...new Set(input.pluginRoots.map((root) => node_path.default.resolve(root)))].sort();
+	let key;
+	try {
+		key = globalBuildKey(GLOBAL_BUILD_FORMAT, webRoot, require_webPluginScan.scanWebPlugins(webRoot, pluginRoots, input.onNotice ?? (() => {})));
+	} catch (error) {
+		return {
+			status: "failed",
+			reason: error instanceof Error ? error.message : String(error)
+		};
+	}
+	const buildsRoot = node_path.default.join(input.poHome, "build", "web");
+	return {
+		status: "resolved",
+		webRoot,
+		pluginRoots,
+		key,
+		buildsRoot,
+		directory: node_path.default.join(buildsRoot, key)
+	};
+}
+/** Whether the global build for these plugin roots exists, for a check that must not build. */
+function readGlobalWebBuildStatus(input) {
+	const resolved = resolveGlobalWebBuild(input);
+	if (resolved.status !== "resolved") return resolved;
+	return {
+		status: readBuildRecord(resolved.directory) === void 0 ? "missing" : "current",
+		key: resolved.key
+	};
+}
+async function ensureGlobalWebBuild(input) {
+	const environment = input.environment ?? process.env;
+	const notice = input.onNotice ?? (() => {});
+	const resolved = resolveGlobalWebBuild(input);
+	if (resolved.status !== "resolved") return resolved;
+	const { webRoot, pluginRoots, key, buildsRoot, directory } = resolved;
+	const existing = readBuildRecord(directory);
+	if (existing !== void 0) return {
+		status: "cached",
+		build: existing
+	};
+	return singleFlightBuild(key, async () => {
+		try {
+			await buildKeyDirectory(buildsRoot, key, directory, async (temporary) => {
+				const request = {
+					hostRoot: webRoot,
+					pluginRoots,
+					outDir: temporary
+				};
+				const output = await (input.runBuild ?? ((value) => runBuildProcess(value, environment, notice)))(request);
+				return {
+					key,
+					plugins: output.plugins,
+					pluginStyles: output.pluginStyles,
+					baseStyle: output.baseStyle
+				};
+			});
+			const build = readBuildRecord(directory);
+			if (build === void 0) throw new Error(`The web build '${key}' was not recorded.`);
+			return {
+				status: "built",
+				build
+			};
+		} catch (error) {
+			return {
+				status: "failed",
+				reason: error instanceof Error ? error.message : String(error)
+			};
+		}
+	});
+}
+/** The plugin copies a mount runs, host plugins plus its own roots', at most one per pluginId (first wins). */
+function mountPluginCopies(build, packageRoots) {
+	const roots = new Set(packageRoots.map((root) => node_path.default.resolve(root)));
+	const seen = /* @__PURE__ */ new Set();
+	return build.plugins.filter((plugin) => {
+		if (!plugin.isHost && !roots.has(node_path.default.resolve(plugin.packageDir))) return false;
+		if (seen.has(plugin.pluginId)) return false;
+		seen.add(plugin.pluginId);
+		return true;
+	});
+}
+/** The `pluginId` values a mount runs: the host's plugins plus those of its own package roots, deduplicated. */
+function mountWebPluginIds(build, packageRoots) {
+	return mountPluginCopies(build, packageRoots).map((plugin) => plugin.pluginId);
+}
+/** The slots a mount runs: one copy per pluginId, the first in build order. */
+function mountWebPluginSlots(build, packageRoots) {
+	return mountPluginCopies(build, packageRoots).map(require_webPluginManifest.pluginSlot);
+}
+/**
+* The package roots among `packageRoots` that declare a web plugin the build has no slot for:
+* a package that was not synced yet, or was left out of the build. Their names, else their roots.
+*/
+function unslottedWebPackages(build, packageRoots) {
+	const slotted = new Set(build.plugins.map((plugin) => node_path.default.resolve(plugin.packageDir)));
+	const missing = [];
+	for (const root of new Set(packageRoots.map((entry) => node_path.default.resolve(entry)))) {
+		if (slotted.has(root)) continue;
+		let manifest;
+		try {
+			manifest = JSON.parse(node_fs.default.readFileSync(node_path.default.join(root, "package.json"), "utf8"));
+		} catch {
+			continue;
+		}
+		if (manifest.poWeb === void 0) continue;
+		missing.push(typeof manifest.name === "string" ? manifest.name : root);
+	}
+	return missing;
+}
+/** The pluginIds with more than one installed copy among the host and these roots, each with its slots in build order. */
+function duplicatePluginCopies(build, packageRoots) {
+	const roots = new Set(packageRoots.map((root) => node_path.default.resolve(root)));
+	const slotsById = /* @__PURE__ */ new Map();
+	for (const plugin of build.plugins) {
+		if (!plugin.isHost && !roots.has(node_path.default.resolve(plugin.packageDir))) continue;
+		const slot = require_webPluginManifest.pluginSlot(plugin);
+		const slots = slotsById.get(plugin.pluginId) ?? [];
+		if (!slots.includes(slot)) slots.push(slot);
+		slotsById.set(plugin.pluginId, slots);
+	}
+	return new Map([...slotsById].filter(([, slots]) => slots.length > 1));
+}
+//#endregion
+exports.BUILD_RECORD = BUILD_RECORD;
+exports.buildKeyDirectory = buildKeyDirectory;
+exports.compositionPackageRoots = compositionPackageRoots;
+exports.duplicatePluginCopies = duplicatePluginCopies;
+exports.ensureGlobalWebBuild = ensureGlobalWebBuild;
+exports.globalBuildKey = globalBuildKey;
+exports.mountWebPluginIds = mountWebPluginIds;
+exports.mountWebPluginSlots = mountWebPluginSlots;
+exports.newestGlobalWebBuildKey = newestGlobalWebBuildKey;
+exports.packageRootOf = packageRootOf;
+exports.readBuildJson = readBuildJson;
+exports.readGlobalWebBuildRecord = readGlobalWebBuildRecord;
+exports.readGlobalWebBuildStatus = readGlobalWebBuildStatus;
+exports.singleFlightBuild = singleFlightBuild;
+exports.unslottedWebPackages = unslottedWebPackages;
+exports.webHostVersion = webHostVersion;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/builders/web/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["path","fs","createRequire","snapshotFiles","statSignature","crypto","compareCodeUnits","scanWebPlugins","pluginSlot"],"sources":["../../../../src/builders/web/index.ts"],"sourcesContent":["import { execFile } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\nimport type { GlobalWebBuild, GlobalWebBuildPlugin } from '@agimon-ai/po-core/webCompositions';\n\nimport { snapshotFiles, statSignature } from '../server/packageUrl';\nimport { compareCodeUnits, type DeclaredWebPlugin, pluginSlot } from './webPluginManifest';\nimport { scanWebPlugins } from './webPluginScan';\n\nconst WEB_PACKAGE = '@agimon-ai/po-web';\nconst WEB_PACKAGE_ROOT_ENV = 'PO_WEB_PACKAGE_ROOT';\n\n/** The package roots a set of compositions activates, each once. */\nexport function compositionPackageRoots(compositions: readonly { packageEntries: readonly string[] }[]): string[] {\n  return [\n    ...new Set(\n      compositions\n        .flatMap((composition) => composition.packageEntries)\n        .map(packageRootOf)\n        .filter((root): root is string => root !== undefined),\n    ),\n  ];\n}\n\n/** Walks from a resolved module path up to the directory owning its package.json. */\nexport function packageRootOf(entryPath: string): string | undefined {\n  let dir = path.dirname(entryPath);\n  for (;;) {\n    if (fs.existsSync(path.join(dir, 'package.json'))) return dir;\n    const parent = path.dirname(dir);\n    if (parent === dir) return undefined;\n    dir = parent;\n  }\n}\n\nfunction resolveWebPackageRoot(repoRoot: string, environment: NodeJS.ProcessEnv): string | undefined {\n  const override = environment[WEB_PACKAGE_ROOT_ENV];\n  if (override !== undefined && override !== '') return path.resolve(override);\n  try {\n    return path.dirname(createRequire(path.join(repoRoot, 'package.json')).resolve(`${WEB_PACKAGE}/package.json`));\n  } catch {\n    try {\n      return path.dirname(createRequire(import.meta.url).resolve(`${WEB_PACKAGE}/package.json`));\n    } catch {\n      return undefined;\n    }\n  }\n}\n\n/** The installed po-web host version the global web build would use, or `none` when it is not installed. */\nexport function webHostVersion(poHome: string, environment: NodeJS.ProcessEnv = process.env): string {\n  const webRoot = resolveWebPackageRoot(poHome, environment);\n  if (webRoot === undefined) return 'none';\n  try {\n    const manifest = JSON.parse(fs.readFileSync(path.join(webRoot, 'package.json'), 'utf8')) as { version?: unknown };\n    return typeof manifest.version === 'string' ? manifest.version : 'unversioned';\n  } catch (error) {\n    return `unreadable:${error instanceof Error ? error.message : String(error)}`;\n  }\n}\n\n/** Bumped whenever the build's output layout changes, so an old layout is never reused. */\nconst GLOBAL_BUILD_FORMAT = 'global-web-4';\n/** The record every keyed global build writes last, so a key directory holding it is complete. */\nexport const BUILD_RECORD = 'build.json';\nconst BUILD_CHILD_SCRIPT = `\nconst [bundleUrl, request] = process.argv.slice(1);\ntry {\n  const { bundleCockpitWeb } = await import(bundleUrl);\n  const { hostRoot, pluginRoots, outDir } = JSON.parse(request);\n  const result = await bundleCockpitWeb({\n    hostRoot,\n    pluginRoots,\n    outDir,\n    onNotice: (message) => process.stderr.write(message + '\\\\n'),\n  });\n  process.stdout.write(JSON.stringify(result));\n} catch (error) {\n  process.stderr.write(error instanceof Error ? (error.stack ?? error.message) : String(error));\n  process.exitCode = 1;\n}\n`;\n\n/** One build's record: the publishable build, whose plugins carry each copy's package and slot closure. */\nexport type GlobalWebBuildRecord = GlobalWebBuild;\n\nexport interface GlobalWebBuildInput {\n  /** Po's global home; builds land in `<home>/build/web/<key>/`. */\n  poHome: string;\n  /** The union of every scope's package roots; roots without a poWeb block are ignored. */\n  pluginRoots: readonly string[];\n  environment?: NodeJS.ProcessEnv;\n  onNotice?: (message: string) => void;\n  /** Test seam over the child-process build. */\n  runBuild?: (request: { hostRoot: string; pluginRoots: string[]; outDir: string }) => Promise<BuildOutput>;\n  /** Test seam over package resolution. */\n  resolveWebRoot?: (repoRoot: string, environment: NodeJS.ProcessEnv) => string | undefined;\n}\n\ninterface BuildOutput {\n  assetsDir: string;\n  pluginsDir: string;\n  plugins: GlobalWebBuildPlugin[];\n  pluginStyles: Record<string, string>;\n  baseStyle: string;\n}\n\nexport type GlobalWebBuildResult =\n  | { status: 'built' | 'cached'; build: GlobalWebBuildRecord }\n  | { status: 'skipped'; reason: string }\n  | { status: 'failed'; reason: string };\n\n/**\n * The size+mtime signature of every file a plugin package hands the build: its manifest\n * plus the whole top-level folder of the client entry and of each declared export, so an\n * edited import or a rebuilt dist chunk changes the key, not only the entry file.\n */\nfunction packageSignature(packageDir: string, entries: readonly string[]): string {\n  try {\n    const files = new Set<string>();\n    for (const entry of entries) for (const file of snapshotFiles(packageDir, entry)) files.add(file);\n    return statSignature(packageDir, [...files].sort());\n  } catch (error) {\n    // A declared export that is not built yet must not block the build; it only weakens the key.\n    return `unreadable:${error instanceof Error ? error.message : String(error)}`;\n  }\n}\n\n/**\n * The content key of a build: the format, the host package when there is one, then every\n * plugin package's file signature. A changed source or dist file or a changed plugin set\n * yields a new key; roots that declare no plugin do not take part.\n */\nexport function globalBuildKey(\n  format: string,\n  hostRoot: string | undefined,\n  plugins: readonly DeclaredWebPlugin[],\n): string {\n  const hash = crypto.createHash('sha256').update(format);\n  if (hostRoot !== undefined)\n    hash.update(`host:${hostRoot}:${fs.readFileSync(path.join(hostRoot, 'package.json'), 'utf8')}`);\n  const entries = new Map<string, string[]>();\n  for (const plugin of [...plugins].sort((a, b) => compareCodeUnits(a.pluginId, b.pluginId))) {\n    hash.update(`\\0${plugin.pluginId}:${plugin.packageDir}:${plugin.client.entry}`);\n    const list = entries.get(plugin.packageDir) ?? [];\n    list.push(path.join(plugin.packageDir, plugin.client.entry));\n    entries.set(plugin.packageDir, list);\n  }\n  for (const packageDir of [...entries.keys()].sort())\n    hash.update(`\\0${packageDir}\\0${packageSignature(packageDir, entries.get(packageDir) ?? [])}`);\n  return hash.digest('hex').slice(0, 32);\n}\n\nfunction bundleModuleUrl(): string {\n  const extension = import.meta.url.endsWith('.ts') ? 'ts' : 'mjs';\n  return new URL(`./bundle.${extension}`, import.meta.url).href;\n}\n\n/** Runs Vite in a child process so its module graph and caches never stay in the server heap. */\nfunction runBuildProcess(\n  request: { hostRoot: string; pluginRoots: string[]; outDir: string },\n  environment: NodeJS.ProcessEnv,\n  onNotice: (message: string) => void,\n): Promise<BuildOutput> {\n  const args = [\n    ...process.execArgv,\n    '--input-type=module',\n    '--eval',\n    BUILD_CHILD_SCRIPT,\n    bundleModuleUrl(),\n    JSON.stringify(request),\n  ];\n  return new Promise((resolve, reject) => {\n    execFile(\n      process.execPath,\n      args,\n      { cwd: request.hostRoot, env: environment, encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 },\n      (error, stdout, stderr) => {\n        if (error) {\n          reject(new Error(`${stderr || stdout}`.trim() || `Web build exited with code ${String(error.code ?? 1)}`));\n          return;\n        }\n        for (const line of stderr.split('\\n')) if (line.trim()) onNotice(line.trim());\n        resolve(JSON.parse(stdout) as BuildOutput);\n      },\n    );\n  });\n}\n\n/** A key directory's parsed build record, or undefined when the build is not there (yet). */\nexport function readBuildJson<T>(directory: string): T | undefined {\n  try {\n    return JSON.parse(fs.readFileSync(path.join(directory, BUILD_RECORD), 'utf8')) as T;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\nfunction readBuildRecord(directory: string): GlobalWebBuildRecord | undefined {\n  const record = readBuildJson<Omit<GlobalWebBuildRecord, 'webDirectory' | 'pluginsDirectory'>>(directory);\n  if (record === undefined) return undefined;\n  return { ...record, webDirectory: path.join(directory, 'web'), pluginsDirectory: path.join(directory, 'plugins') };\n}\n\nfunction webBuildsRoot(poHome: string): string {\n  return path.join(poHome, 'build', 'web');\n}\n\n/** The complete global web build of one key, or undefined when it is not there. Never builds. */\nexport function readGlobalWebBuildRecord(poHome: string, key: string): GlobalWebBuildRecord | undefined {\n  return readBuildRecord(path.join(webBuildsRoot(poHome), key));\n}\n\n/**\n * The key of the most recently written complete global web build, for a server that starts\n * before sync ever wrote a pointer. Temporary build folders start with a dot and are skipped.\n */\nexport function newestGlobalWebBuildKey(poHome: string): string | undefined {\n  const root = webBuildsRoot(poHome);\n  if (!fs.existsSync(root)) return undefined;\n  return fs\n    .readdirSync(root, { withFileTypes: true })\n    .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))\n    .map((entry) => ({ name: entry.name, file: path.join(root, entry.name, BUILD_RECORD) }))\n    .filter((entry) => fs.existsSync(entry.file))\n    .map((entry) => ({ name: entry.name, modified: fs.statSync(entry.file).mtimeMs }))\n    .sort((left, right) => right.modified - left.modified)[0]?.name;\n}\n\n/**\n * Builds into a temporary sibling of `directory`, writes the build record last, and renames\n * the result into place, so a key directory is always complete. Losing the rename to another\n * process that finished the same key is fine: its bytes are identical.\n */\nexport async function buildKeyDirectory(\n  buildsRoot: string,\n  key: string,\n  directory: string,\n  build: (temporary: string) => Promise<object>,\n): Promise<void> {\n  fs.mkdirSync(buildsRoot, { recursive: true });\n  const temporary = fs.mkdtempSync(path.join(buildsRoot, `.${key}-`));\n  try {\n    const record = await build(temporary);\n    fs.writeFileSync(path.join(temporary, BUILD_RECORD), `${JSON.stringify(record, null, 2)}\\n`);\n    try {\n      fs.renameSync(temporary, directory);\n    } catch (error) {\n      if (readBuildJson(directory) === undefined) throw error;\n    }\n  } finally {\n    fs.rmSync(temporary, { recursive: true, force: true });\n  }\n}\n\nconst pendingBuilds = new Map<string, Promise<unknown>>();\n\n/** Joins a build of the same key that is already running in this process instead of starting another. */\nexport async function singleFlightBuild<T>(key: string, run: () => Promise<T>): Promise<T> {\n  const pending = pendingBuilds.get(key);\n  if (pending !== undefined) return pending as Promise<T>;\n  const started = run();\n  pendingBuilds.set(key, started);\n  try {\n    return await started;\n  } finally {\n    pendingBuilds.delete(key);\n  }\n}\n\n/**\n * Ensures the one global web build for the given plugin roots exists and returns it.\n *\n * The output is `<home>/build/web/<key>/`, built in a temporary directory and renamed into\n * place, so a key directory is always complete; an existing key builds nothing. Each\n * non-host plugin gets its own content-hashed stylesheet, so a mount loads only its own.\n */\ntype ResolvedGlobalWebBuild =\n  | { status: 'resolved'; webRoot: string; pluginRoots: string[]; key: string; buildsRoot: string; directory: string }\n  | { status: 'skipped'; reason: string }\n  | { status: 'failed'; reason: string };\n\n/** The build key for these plugin roots and where its build lives, without building anything. */\nfunction resolveGlobalWebBuild(input: GlobalWebBuildInput): ResolvedGlobalWebBuild {\n  const environment = input.environment ?? process.env;\n  const webRoot = (input.resolveWebRoot ?? resolveWebPackageRoot)(input.poHome, environment);\n  if (webRoot === undefined || !fs.existsSync(path.join(webRoot, 'package.json')))\n    return { status: 'skipped', reason: `${WEB_PACKAGE} is not installed; no web composition is published` };\n  const pluginRoots = [...new Set(input.pluginRoots.map((root) => path.resolve(root)))].sort();\n  let key: string;\n  try {\n    key = globalBuildKey(\n      GLOBAL_BUILD_FORMAT,\n      webRoot,\n      scanWebPlugins(webRoot, pluginRoots, input.onNotice ?? ((): void => {})),\n    );\n  } catch (error) {\n    return { status: 'failed', reason: error instanceof Error ? error.message : String(error) };\n  }\n  const buildsRoot = path.join(input.poHome, 'build', 'web');\n  return { status: 'resolved', webRoot, pluginRoots, key, buildsRoot, directory: path.join(buildsRoot, key) };\n}\n\n/** Whether the global build for these plugin roots exists, for a check that must not build. */\nexport function readGlobalWebBuildStatus(\n  input: GlobalWebBuildInput,\n):\n  | { status: 'current' | 'missing'; key: string }\n  | { status: 'skipped'; reason: string }\n  | { status: 'failed'; reason: string } {\n  const resolved = resolveGlobalWebBuild(input);\n  if (resolved.status !== 'resolved') return resolved;\n  return { status: readBuildRecord(resolved.directory) === undefined ? 'missing' : 'current', key: resolved.key };\n}\n\nexport async function ensureGlobalWebBuild(input: GlobalWebBuildInput): Promise<GlobalWebBuildResult> {\n  const environment = input.environment ?? process.env;\n  const notice = input.onNotice ?? ((): void => {});\n  const resolved = resolveGlobalWebBuild(input);\n  if (resolved.status !== 'resolved') return resolved;\n  const { webRoot, pluginRoots, key, buildsRoot, directory } = resolved;\n  const existing = readBuildRecord(directory);\n  if (existing !== undefined) return { status: 'cached', build: existing };\n  return singleFlightBuild(key, async (): Promise<GlobalWebBuildResult> => {\n    try {\n      await buildKeyDirectory(buildsRoot, key, directory, async (temporary) => {\n        const request = { hostRoot: webRoot, pluginRoots, outDir: temporary };\n        const output = await (input.runBuild ?? ((value) => runBuildProcess(value, environment, notice)))(request);\n        return {\n          key,\n          plugins: output.plugins,\n          pluginStyles: output.pluginStyles,\n          baseStyle: output.baseStyle,\n        };\n      });\n      const build = readBuildRecord(directory);\n      if (build === undefined) throw new Error(`The web build '${key}' was not recorded.`);\n      return { status: 'built', build };\n    } catch (error) {\n      return { status: 'failed', reason: error instanceof Error ? error.message : String(error) };\n    }\n  });\n}\n\ntype MountPluginRecord = { pluginId: string; packageDir: string; isHost: boolean };\n\n/** The plugin copies a mount runs, host plugins plus its own roots', at most one per pluginId (first wins). */\nfunction mountPluginCopies(\n  build: { plugins: readonly MountPluginRecord[] },\n  packageRoots: readonly string[],\n): MountPluginRecord[] {\n  const roots = new Set(packageRoots.map((root) => path.resolve(root)));\n  const seen = new Set<string>();\n  return build.plugins.filter((plugin) => {\n    if (!plugin.isHost && !roots.has(path.resolve(plugin.packageDir))) return false;\n    if (seen.has(plugin.pluginId)) return false;\n    seen.add(plugin.pluginId);\n    return true;\n  });\n}\n\n/** The `pluginId` values a mount runs: the host's plugins plus those of its own package roots, deduplicated. */\nexport function mountWebPluginIds(\n  build: { plugins: readonly MountPluginRecord[] },\n  packageRoots: readonly string[],\n): string[] {\n  return mountPluginCopies(build, packageRoots).map((plugin) => plugin.pluginId);\n}\n\n/** The slots a mount runs: one copy per pluginId, the first in build order. */\nexport function mountWebPluginSlots(\n  build: { plugins: readonly MountPluginRecord[] },\n  packageRoots: readonly string[],\n): string[] {\n  return mountPluginCopies(build, packageRoots).map(pluginSlot);\n}\n\n/**\n * The package roots among `packageRoots` that declare a web plugin the build has no slot for:\n * a package that was not synced yet, or was left out of the build. Their names, else their roots.\n */\nexport function unslottedWebPackages(\n  build: { plugins: readonly MountPluginRecord[] },\n  packageRoots: readonly string[],\n): string[] {\n  const slotted = new Set(build.plugins.map((plugin) => path.resolve(plugin.packageDir)));\n  const missing: string[] = [];\n  for (const root of new Set(packageRoots.map((entry) => path.resolve(entry)))) {\n    if (slotted.has(root)) continue;\n    let manifest: { name?: unknown; poWeb?: unknown };\n    try {\n      manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as typeof manifest;\n    } catch {\n      // Unreadable manifests are reported by the build's own scan, not as a missing slot.\n      continue;\n    }\n    if (manifest.poWeb === undefined) continue;\n    missing.push(typeof manifest.name === 'string' ? manifest.name : root);\n  }\n  return missing;\n}\n\n/** The pluginIds with more than one installed copy among the host and these roots, each with its slots in build order. */\nexport function duplicatePluginCopies(\n  build: { plugins: readonly MountPluginRecord[] },\n  packageRoots: readonly string[],\n): Map<string, string[]> {\n  const roots = new Set(packageRoots.map((root) => path.resolve(root)));\n  const slotsById = new Map<string, string[]>();\n  for (const plugin of build.plugins) {\n    if (!plugin.isHost && !roots.has(path.resolve(plugin.packageDir))) continue;\n    const slot = pluginSlot(plugin);\n    const slots = slotsById.get(plugin.pluginId) ?? [];\n    if (!slots.includes(slot)) slots.push(slot);\n    slotsById.set(plugin.pluginId, slots);\n  }\n  return new Map([...slotsById].filter(([, slots]) => slots.length > 1));\n}\n"],"mappings":"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"}

package/dist/src/builders/web/index.d.mts

@@ -0,0 +1,109 @@
+import { DeclaredWebPlugin } from "./webPluginManifest.mjs";
+import { GlobalWebBuild, GlobalWebBuildPlugin } from "@agimon-ai/po-core/webCompositions";
+//#region src/builders/web/index.d.ts
+/** The package roots a set of compositions activates, each once. */
+export declare function compositionPackageRoots(compositions: readonly {
+  packageEntries: readonly string[];
+}[]): string[];
+/** Walks from a resolved module path up to the directory owning its package.json. */
+export declare function packageRootOf(entryPath: string): string | undefined;
+/** The installed po-web host version the global web build would use, or `none` when it is not installed. */
+export declare function webHostVersion(poHome: string, environment?: NodeJS.ProcessEnv): string;
+/** The record every keyed global build writes last, so a key directory holding it is complete. */
+export declare const BUILD_RECORD = "build.json";
+/** One build's record: the publishable build, whose plugins carry each copy's package and slot closure. */
+export type GlobalWebBuildRecord = GlobalWebBuild;
+export interface GlobalWebBuildInput {
+  /** Po's global home; builds land in `<home>/build/web/<key>/`. */
+  poHome: string;
+  /** The union of every scope's package roots; roots without a poWeb block are ignored. */
+  pluginRoots: readonly string[];
+  environment?: NodeJS.ProcessEnv;
+  onNotice?: (message: string) => void;
+  /** Test seam over the child-process build. */
+  runBuild?: (request: {
+    hostRoot: string;
+    pluginRoots: string[];
+    outDir: string;
+  }) => Promise<BuildOutput>;
+  /** Test seam over package resolution. */
+  resolveWebRoot?: (repoRoot: string, environment: NodeJS.ProcessEnv) => string | undefined;
+}
+interface BuildOutput {
+  assetsDir: string;
+  pluginsDir: string;
+  plugins: GlobalWebBuildPlugin[];
+  pluginStyles: Record<string, string>;
+  baseStyle: string;
+}
+export type GlobalWebBuildResult = {
+  status: 'built' | 'cached';
+  build: GlobalWebBuildRecord;
+} | {
+  status: 'skipped';
+  reason: string;
+} | {
+  status: 'failed';
+  reason: string;
+};
+/**
+ * The content key of a build: the format, the host package when there is one, then every
+ * plugin package's file signature. A changed source or dist file or a changed plugin set
+ * yields a new key; roots that declare no plugin do not take part.
+ */
+export declare function globalBuildKey(format: string, hostRoot: string | undefined, plugins: readonly DeclaredWebPlugin[]): string;
+/** A key directory's parsed build record, or undefined when the build is not there (yet). */
+export declare function readBuildJson<T>(directory: string): T | undefined;
+/** The complete global web build of one key, or undefined when it is not there. Never builds. */
+export declare function readGlobalWebBuildRecord(poHome: string, key: string): GlobalWebBuildRecord | undefined;
+/**
+ * The key of the most recently written complete global web build, for a server that starts
+ * before sync ever wrote a pointer. Temporary build folders start with a dot and are skipped.
+ */
+export declare function newestGlobalWebBuildKey(poHome: string): string | undefined;
+/**
+ * Builds into a temporary sibling of `directory`, writes the build record last, and renames
+ * the result into place, so a key directory is always complete. Losing the rename to another
+ * process that finished the same key is fine: its bytes are identical.
+ */
+export declare function buildKeyDirectory(buildsRoot: string, key: string, directory: string, build: (temporary: string) => Promise<object>): Promise<void>;
+/** Joins a build of the same key that is already running in this process instead of starting another. */
+export declare function singleFlightBuild<T>(key: string, run: () => Promise<T>): Promise<T>;
+/** Whether the global build for these plugin roots exists, for a check that must not build. */
+export declare function readGlobalWebBuildStatus(input: GlobalWebBuildInput): {
+  status: 'current' | 'missing';
+  key: string;
+} | {
+  status: 'skipped';
+  reason: string;
+} | {
+  status: 'failed';
+  reason: string;
+};
+export declare function ensureGlobalWebBuild(input: GlobalWebBuildInput): Promise<GlobalWebBuildResult>;
+type MountPluginRecord = {
+  pluginId: string;
+  packageDir: string;
+  isHost: boolean;
+};
+/** The `pluginId` values a mount runs: the host's plugins plus those of its own package roots, deduplicated. */
+export declare function mountWebPluginIds(build: {
+  plugins: readonly MountPluginRecord[];
+}, packageRoots: readonly string[]): string[];
+/** The slots a mount runs: one copy per pluginId, the first in build order. */
+export declare function mountWebPluginSlots(build: {
+  plugins: readonly MountPluginRecord[];
+}, packageRoots: readonly string[]): string[];
+/**
+ * The package roots among `packageRoots` that declare a web plugin the build has no slot for:
+ * a package that was not synced yet, or was left out of the build. Their names, else their roots.
+ */
+export declare function unslottedWebPackages(build: {
+  plugins: readonly MountPluginRecord[];
+}, packageRoots: readonly string[]): string[];
+/** The pluginIds with more than one installed copy among the host and these roots, each with its slots in build order. */
+export declare function duplicatePluginCopies(build: {
+  plugins: readonly MountPluginRecord[];
+}, packageRoots: readonly string[]): Map<string, string[]>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/builders/web/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/builders/web/index.ts"],"mappings":";;;;wBAgBgB,wBAAwB;EAAyB;;;wBAYjD,cAAc;;wBAyBd,eAAe,gBAAgB,cAAa,OAAO;;qBActD;;YAoBD,uBAAuB;iBAElB;;EAEf;;EAEA;EACA,cAAc,OAAO;EACrB,YAAY;;EAEZ,YAAY;IAAW;IAAkB;IAAuB;QAAqB,QAAQ;;EAE7F,kBAAkB,kBAAkB,aAAa,OAAO;;UAGhD;EACR;EACA;EACA,SAAS;EACT,cAAc;EACd;;YAGU;EACN;EAA4B,OAAO;;EACnC;EAAmB;;EACnB;EAAkB;;;;;;;wBAuBR,eACd,gBACA,8BACA,kBAAkB;;wBAsDJ,cAAc,GAAG,oBAAoB;;wBAoBrC,yBAAyB,gBAAgB,cAAc;;;;;wBAQvD,wBAAwB;;;;;;wBAiBlB,kBACpB,oBACA,aACA,mBACA,QAAQ,sBAAsB,kBAC7B;;wBAmBmB,kBAAkB,GAAG,aAAa,WAAW,QAAQ,KAAK,QAAQ;;wBA8CxE,yBACd,OAAO;EAEH;EAA+B;;EAC/B;EAAmB;;EACnB;EAAkB;;wBAMF,qBAAqB,OAAO,sBAAsB,QAAQ;KA6B3E;EAAsB;EAAkB;EAAoB;;;wBAkBjD,kBACd;EAAS,kBAAkB;GAC3B;;wBAMc,oBACd;EAAS,kBAAkB;GAC3B;;;;;wBASc,qBACd;EAAS,kBAAkB;GAC3B;;wBAoBc,sBACd;EAAS,kBAAkB;GAC3B,kCACC"}