@agimon-ai/po 0.0.0-alpha.0

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

@@ -0,0 +1,188 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.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_module = require("node:module");
+let node_url = require("node:url");
+//#region src/builders/web/webPluginGenerate.ts
+const HEADER = "// Generated by po web builder. Do not edit by hand.";
+/** The template po-web renders when a composition names none, so its classes always compile. */
+const FALLBACK_TEMPLATE_PACKAGE = "@agimon-ai/po-template-advanced";
+const BUILTIN_CLIENT_MODULE = node_path.default.join("src", "web", "app", "webPlugins.generated.ts");
+const BUILTIN_CSS_MODULE = node_path.default.join("src", "web", "styles", "webPluginSources.generated.css");
+/**
+* The import name of one plugin copy, derived from its slot so two copies of one pluginId
+* never collide. A host slot is its kebab-case pluginId and keeps the committed module's
+* names; a copy slot's '.' becomes '_', which no host name can contain.
+*/
+function slotIdentifier(slot) {
+	return slot.replace(/-([a-z0-9])/g, (_, ch) => ch.toUpperCase()).replace(/[^A-Za-z0-9_$]/g, "_");
+}
+function relativeImport(fromDir, toFile) {
+	const spec = node_path.default.relative(fromDir, toFile).split(node_path.default.sep).join("/");
+	return spec.startsWith(".") ? spec : `./${spec}`;
+}
+function renderClientModule(plugins, style, packageRoot) {
+	const lines = [HEADER, "import type { WebPluginDefinition } from '@agimon-ai/po-core/web';"];
+	const names = [];
+	const fromDir = node_path.default.join(packageRoot, "src", "web", "app");
+	for (const plugin of plugins) {
+		const name = `${slotIdentifier(plugin.slot)}Plugin`;
+		names.push(name);
+		const entry = node_path.default.join(plugin.packageDir, plugin.client.entry);
+		const specifier = style === "relative" ? relativeImport(fromDir, entry) : (0, node_url.pathToFileURL)(node_fs.default.realpathSync(entry)).href;
+		lines.push(`import { webPlugin as ${name} } from '${specifier}';`);
+	}
+	lines.push("", `export const webPlugins: readonly WebPluginDefinition[] = [${names.join(", ")}];`, "");
+	return lines.join("\n");
+}
+/**
+* The directory Tailwind scans for a plugin's class names.
+*
+* `src/extensions` wins, because a plugin's components colocate with the routed
+* file that renders them, in private `_components` and `_lib` folders. The
+* legacy `src/web` root is only a fallback: `existsSync` is true for a
+* half-emptied directory holding nothing but a tsconfig, and packages have been
+* in exactly that state, so preferring it would hand Tailwind a directory with
+* no components in it and silently drop every class.
+*
+* The client entry's own directory is the last resort. It is published through
+* `src/exports/webClient.ts`, a one-line re-export, or generated outside `src`
+* entirely, so it holds no components either.
+*/
+function pluginSourceRoot(plugin) {
+	const routingRoot = node_path.default.join(plugin.packageDir, "src", "extensions");
+	if (node_fs.default.existsSync(routingRoot)) return routingRoot;
+	const webRoot = node_path.default.join(plugin.packageDir, "src", "web");
+	if (node_fs.default.existsSync(webRoot)) return webRoot;
+	return node_path.default.dirname(node_path.default.join(plugin.packageDir, plugin.client.entry));
+}
+/**
+* Where Tailwind finds the fallback template's classes. app.css names it by a
+* path from its own folder into po-web's node_modules, which holds only in
+* this repository; an installed po-web has the template beside it instead,
+* so a sync build that scanned only that path shipped the cockpit without the
+* template's responsive layout. Resolving it as Node does works in both.
+*/
+function fallbackTemplateSourceRoot(packageRoot) {
+	let manifest;
+	try {
+		manifest = (0, node_module.createRequire)(node_path.default.join(packageRoot, "package.json")).resolve(`${FALLBACK_TEMPLATE_PACKAGE}/package.json`);
+	} catch {
+		return;
+	}
+	const extensions = node_path.default.join(node_path.default.dirname(manifest), "dist", "extensions");
+	return node_fs.default.existsSync(extensions) ? extensions : void 0;
+}
+function renderCssModule(plugins, leadingSourceRoots) {
+	const lines = [`/* ${HEADER.slice(3)} */`, ...leadingSourceRoots.map((root) => `@source "${root}";`)];
+	for (const plugin of plugins) {
+		if (plugin.isHost) continue;
+		lines.push(`@source "${pluginSourceRoot(plugin)}";`);
+	}
+	lines.push("");
+	return lines.join("\n");
+}
+/** The committed client registry, rendered from the host package alone. */
+function renderBuiltinWebPluginModules(packageRoot) {
+	const plugins = require_webPluginScan.scanWebPlugins(packageRoot);
+	return /* @__PURE__ */ new Map([[BUILTIN_CLIENT_MODULE, renderClientModule(plugins, "relative", packageRoot)], [BUILTIN_CSS_MODULE, renderCssModule(plugins, [])]]);
+}
+/**
+* Keeps the committed client registry fresh: write-if-changed locally,
+* check-only (throw) in CI. Both vite.config.ts and tsdown.config.ts call
+* this at config-load time.
+*/
+function ensureBuiltinWebPluginModules({ packageRoot, check = false }) {
+	const stale = [];
+	for (const [relativePath, content] of renderBuiltinWebPluginModules(packageRoot)) {
+		const filePath = node_path.default.join(packageRoot, relativePath);
+		if ((node_fs.default.existsSync(filePath) ? node_fs.default.readFileSync(filePath, "utf8") : void 0) === content) continue;
+		if (check) {
+			stale.push(relativePath);
+			continue;
+		}
+		node_fs.default.mkdirSync(node_path.default.dirname(filePath), { recursive: true });
+		node_fs.default.writeFileSync(filePath, content);
+	}
+	if (stale.length > 0) throw new Error(`Stale generated web plugin modules: ${stale.join(", ")}. Run pnpm build in po-web and commit them.`);
+}
+/** The style entry of each plugin's Rollup input name, so each emits one content-hashed file. */
+const BASE_STYLE_ENTRY = "base";
+const pluginStyleEntryName = (slot) => `plugin-${slot}`;
+/**
+* One Tailwind entry per plugin: app.css with only the shell's sources plus that plugin's,
+* so a mount that loads its plugins' files never receives another workspace's classes.
+* Host plugins live in the shell's sources and share the base entry.
+*/
+function writeWebPluginStyleEntries(plugins, generatedDir, packageRoot) {
+	const stylesDir = node_path.default.join(generatedDir, "styles");
+	node_fs.default.mkdirSync(stylesDir, { recursive: true });
+	const fallbackTemplate = fallbackTemplateSourceRoot(packageRoot);
+	const baseSourcesPath = node_path.default.join(generatedDir, "webPluginBaseSources.generated.css");
+	node_fs.default.writeFileSync(baseSourcesPath, renderCssModule([], [node_path.default.join(packageRoot, "src", "web"), ...fallbackTemplate === void 0 ? [] : [fallbackTemplate]]));
+	const appCss = relativeImport(node_fs.default.realpathSync(stylesDir), node_fs.default.realpathSync(node_path.default.join(packageRoot, "src", "web", "styles", "app.css")));
+	const baseEntryPath = node_path.default.join(stylesDir, `${BASE_STYLE_ENTRY}.css`);
+	node_fs.default.writeFileSync(baseEntryPath, `/* ${HEADER.slice(3)} */\n@import '${appCss}';\n`);
+	const pluginEntryPaths = /* @__PURE__ */ new Map();
+	for (const plugin of plugins) {
+		if (plugin.isHost) continue;
+		const entryPath = node_path.default.join(stylesDir, `${pluginStyleEntryName(plugin.slot)}.css`);
+		node_fs.default.writeFileSync(entryPath, `/* ${HEADER.slice(3)} */\n@import '${appCss}';\n@source "${pluginSourceRoot(plugin)}";\n`);
+		pluginEntryPaths.set(plugin.slot, entryPath);
+	}
+	return {
+		baseSourcesPath,
+		baseEntryPath,
+		pluginEntryPaths
+	};
+}
+/**
+* The sync-time variant: renders the full client plugin set (host built-ins plus
+* the installed composition's packages) into a generation directory the bundler
+* aliases over the committed builtin modules.
+*/
+function writeSyncWebPluginModules(plugins, generatedDir, packageRoot) {
+	node_fs.default.mkdirSync(generatedDir, { recursive: true });
+	const clientModulePath = node_path.default.join(generatedDir, "webPlugins.generated.ts");
+	const cssModulePath = node_path.default.join(generatedDir, "webPluginSources.generated.css");
+	node_fs.default.writeFileSync(clientModulePath, renderClientModule(plugins, "absolute", packageRoot));
+	const slotsDir = node_path.default.join(generatedDir, "slots");
+	node_fs.default.mkdirSync(slotsDir, { recursive: true });
+	const slotEntryPaths = {};
+	for (const plugin of plugins) {
+		const entryPath = node_path.default.join(slotsDir, `${plugin.slot}.ts`);
+		const specifier = (0, node_url.pathToFileURL)(node_fs.default.realpathSync(node_path.default.join(plugin.packageDir, plugin.client.entry))).href;
+		node_fs.default.writeFileSync(entryPath, `${HEADER}\nexport { webPlugin } from '${specifier}';\n`);
+		slotEntryPaths[plugin.slot] = entryPath;
+	}
+	const fallbackTemplate = fallbackTemplateSourceRoot(packageRoot);
+	const leadingSourceRoots = [node_path.default.join(packageRoot, "src", "web"), ...fallbackTemplate === void 0 ? [] : [fallbackTemplate]];
+	node_fs.default.writeFileSync(cssModulePath, renderCssModule(plugins, leadingSourceRoots));
+	const hostPlugins = plugins.filter((plugin) => plugin.isHost);
+	const shell = {
+		clientModulePath: node_path.default.join(generatedDir, "webPluginShell.generated.ts"),
+		cssModulePath: node_path.default.join(generatedDir, "webPluginShellSources.generated.css")
+	};
+	node_fs.default.writeFileSync(shell.clientModulePath, renderClientModule(hostPlugins, "absolute", packageRoot));
+	node_fs.default.writeFileSync(shell.cssModulePath, renderCssModule(hostPlugins, leadingSourceRoots));
+	return {
+		clientModulePath,
+		slotEntryPaths,
+		cssModulePath,
+		shell
+	};
+}
+//#endregion
+exports.BASE_STYLE_ENTRY = BASE_STYLE_ENTRY;
+exports.BUILTIN_CLIENT_MODULE = BUILTIN_CLIENT_MODULE;
+exports.BUILTIN_CSS_MODULE = BUILTIN_CSS_MODULE;
+exports.ensureBuiltinWebPluginModules = ensureBuiltinWebPluginModules;
+exports.pluginStyleEntryName = pluginStyleEntryName;
+exports.renderBuiltinWebPluginModules = renderBuiltinWebPluginModules;
+exports.writeSyncWebPluginModules = writeSyncWebPluginModules;
+exports.writeWebPluginStyleEntries = writeWebPluginStyleEntries;
+
+//# sourceMappingURL=webPluginGenerate.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webPluginGenerate.cjs","names":["path","pathToFileURL","fs","createRequire","scanWebPlugins"],"sources":["../../../../src/builders/web/webPluginGenerate.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport type { DeclaredWebPlugin } from './webPluginManifest';\nimport { scanWebPlugins } from './webPluginScan';\n\nconst HEADER = '// Generated by po web builder. Do not edit by hand.';\n/** The template po-web renders when a composition names none, so its classes always compile. */\nconst FALLBACK_TEMPLATE_PACKAGE = '@agimon-ai/po-template-advanced';\nexport const BUILTIN_CLIENT_MODULE = path.join('src', 'web', 'app', 'webPlugins.generated.ts');\nexport const BUILTIN_CSS_MODULE = path.join('src', 'web', 'styles', 'webPluginSources.generated.css');\n\n/**\n * The import name of one plugin copy, derived from its slot so two copies of one pluginId\n * never collide. A host slot is its kebab-case pluginId and keeps the committed module's\n * names; a copy slot's '.' becomes '_', which no host name can contain.\n */\nfunction slotIdentifier(slot: string): string {\n  return slot.replace(/-([a-z0-9])/g, (_, ch: string) => ch.toUpperCase()).replace(/[^A-Za-z0-9_$]/g, '_');\n}\n\nfunction relativeImport(fromDir: string, toFile: string): string {\n  const spec = path.relative(fromDir, toFile).split(path.sep).join('/');\n  return spec.startsWith('.') ? spec : `./${spec}`;\n}\n\nfunction renderClientModule(\n  plugins: readonly DeclaredWebPlugin[],\n  style: 'relative' | 'absolute',\n  packageRoot: string,\n): string {\n  const lines = [HEADER, \"import type { WebPluginDefinition } from '@agimon-ai/po-core/web';\"];\n  const names: string[] = [];\n  const fromDir = path.join(packageRoot, 'src', 'web', 'app');\n  for (const plugin of plugins) {\n    const name = `${slotIdentifier(plugin.slot)}Plugin`;\n    names.push(name);\n    const entry = path.join(plugin.packageDir, plugin.client.entry);\n    // The committed builtin module keeps machine-neutral relative imports; the\n    // sync-generated module lives outside src, is aliased over the committed\n    // path, and resolves imports against its real location, so every entry\n    // becomes an absolute file URL into the installed packages.\n    const specifier =\n      style === 'relative' ? relativeImport(fromDir, entry) : pathToFileURL(fs.realpathSync(entry)).href;\n    lines.push(`import { webPlugin as ${name} } from '${specifier}';`);\n  }\n  lines.push('', `export const webPlugins: readonly WebPluginDefinition[] = [${names.join(', ')}];`, '');\n  return lines.join('\\n');\n}\n\n/**\n * The directory Tailwind scans for a plugin's class names.\n *\n * `src/extensions` wins, because a plugin's components colocate with the routed\n * file that renders them, in private `_components` and `_lib` folders. The\n * legacy `src/web` root is only a fallback: `existsSync` is true for a\n * half-emptied directory holding nothing but a tsconfig, and packages have been\n * in exactly that state, so preferring it would hand Tailwind a directory with\n * no components in it and silently drop every class.\n *\n * The client entry's own directory is the last resort. It is published through\n * `src/exports/webClient.ts`, a one-line re-export, or generated outside `src`\n * entirely, so it holds no components either.\n */\nfunction pluginSourceRoot(plugin: DeclaredWebPlugin): string {\n  const routingRoot = path.join(plugin.packageDir, 'src', 'extensions');\n  if (fs.existsSync(routingRoot)) return routingRoot;\n  const webRoot = path.join(plugin.packageDir, 'src', 'web');\n  if (fs.existsSync(webRoot)) return webRoot;\n  return path.dirname(path.join(plugin.packageDir, plugin.client.entry));\n}\n\n/**\n * Where Tailwind finds the fallback template's classes. app.css names it by a\n * path from its own folder into po-web's node_modules, which holds only in\n * this repository; an installed po-web has the template beside it instead,\n * so a sync build that scanned only that path shipped the cockpit without the\n * template's responsive layout. Resolving it as Node does works in both.\n */\nfunction fallbackTemplateSourceRoot(packageRoot: string): string | undefined {\n  let manifest: string;\n  try {\n    manifest = createRequire(path.join(packageRoot, 'package.json')).resolve(\n      `${FALLBACK_TEMPLATE_PACKAGE}/package.json`,\n    );\n  } catch {\n    // Not installed: the cockpit then has no fallback template to render either.\n    return undefined;\n  }\n  const extensions = path.join(path.dirname(manifest), 'dist', 'extensions');\n  return fs.existsSync(extensions) ? extensions : undefined;\n}\n\nfunction renderCssModule(plugins: readonly DeclaredWebPlugin[], leadingSourceRoots: readonly string[]): string {\n  // Sync CSS is compiled from a generated directory, so Tailwind cannot infer\n  // the stable shell tree from app.css. Its caller names that tree explicitly\n  // so later plugin utilities do not override missing responsive shell utilities.\n  const lines = [`/* ${HEADER.slice(3)} */`, ...leadingSourceRoots.map((root) => `@source \"${root}\";`)];\n  for (const plugin of plugins) {\n    if (plugin.isHost) continue;\n    lines.push(`@source \"${pluginSourceRoot(plugin)}\";`);\n  }\n  lines.push('');\n  return lines.join('\\n');\n}\n\n/** The committed client registry, rendered from the host package alone. */\nexport function renderBuiltinWebPluginModules(packageRoot: string): Map<string, string> {\n  const plugins = scanWebPlugins(packageRoot);\n  return new Map([\n    [BUILTIN_CLIENT_MODULE, renderClientModule(plugins, 'relative', packageRoot)],\n    [BUILTIN_CSS_MODULE, renderCssModule(plugins, [])],\n  ]);\n}\n\n/**\n * Keeps the committed client registry fresh: write-if-changed locally,\n * check-only (throw) in CI. Both vite.config.ts and tsdown.config.ts call\n * this at config-load time.\n */\nexport function ensureBuiltinWebPluginModules({\n  packageRoot,\n  check = false,\n}: {\n  packageRoot: string;\n  check?: boolean;\n}): void {\n  const stale: string[] = [];\n  for (const [relativePath, content] of renderBuiltinWebPluginModules(packageRoot)) {\n    const filePath = path.join(packageRoot, relativePath);\n    const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : undefined;\n    if (existing === content) continue;\n    if (check) {\n      stale.push(relativePath);\n      continue;\n    }\n    fs.mkdirSync(path.dirname(filePath), { recursive: true });\n    fs.writeFileSync(filePath, content);\n  }\n  if (stale.length > 0) {\n    throw new Error(\n      `Stale generated web plugin modules: ${stale.join(', ')}. Run pnpm build in po-web and commit them.`,\n    );\n  }\n}\n\n/** A client plugin registry and the Tailwind source list that goes with it. */\nexport interface WebPluginRegistryModules {\n  clientModulePath: string;\n  cssModulePath: string;\n}\n\nexport interface SyncGeneratedModules extends WebPluginRegistryModules {\n  /** One entry module per slot, each re-exporting only that copy's `webPlugin`. */\n  slotEntryPaths: Record<string, string>;\n  /**\n   * The signed shell's registry: host plugins only. Every other plugin reaches the\n   * browser through its slot entry, and the global mount replaces the shell's\n   * registry once it loads, so compiling them into the shell too shipped each plugin's\n   * code and emitted assets (the voice VAD model among them) a second time.\n   */\n  shell: WebPluginRegistryModules;\n}\n\nexport interface WebPluginStyleEntries {\n  /** Shell and fallback-template sources only, aliased over app.css's plugin source list. */\n  baseSourcesPath: string;\n  /** The stylesheet every plugin entry extends; a mount with no plugin styles loads it alone. */\n  baseEntryPath: string;\n  /** One stylesheet entry per non-host plugin copy, keyed by its slot. */\n  pluginEntryPaths: Map<string, string>;\n}\n\n/** The style entry of each plugin's Rollup input name, so each emits one content-hashed file. */\nexport const BASE_STYLE_ENTRY = 'base';\nexport const pluginStyleEntryName = (slot: string): string => `plugin-${slot}`;\n\n/**\n * One Tailwind entry per plugin: app.css with only the shell's sources plus that plugin's,\n * so a mount that loads its plugins' files never receives another workspace's classes.\n * Host plugins live in the shell's sources and share the base entry.\n */\nexport function writeWebPluginStyleEntries(\n  plugins: readonly DeclaredWebPlugin[],\n  generatedDir: string,\n  packageRoot: string,\n): WebPluginStyleEntries {\n  const stylesDir = path.join(generatedDir, 'styles');\n  fs.mkdirSync(stylesDir, { recursive: true });\n  const fallbackTemplate = fallbackTemplateSourceRoot(packageRoot);\n  const baseSourcesPath = path.join(generatedDir, 'webPluginBaseSources.generated.css');\n  fs.writeFileSync(\n    baseSourcesPath,\n    renderCssModule(\n      [],\n      [path.join(packageRoot, 'src', 'web'), ...(fallbackTemplate === undefined ? [] : [fallbackTemplate])],\n    ),\n  );\n  // Resolvers follow real paths (a temp dir under /var is /private/var), so relate real paths.\n  const appCss = relativeImport(\n    fs.realpathSync(stylesDir),\n    fs.realpathSync(path.join(packageRoot, 'src', 'web', 'styles', 'app.css')),\n  );\n  const baseEntryPath = path.join(stylesDir, `${BASE_STYLE_ENTRY}.css`);\n  fs.writeFileSync(baseEntryPath, `/* ${HEADER.slice(3)} */\\n@import '${appCss}';\\n`);\n  const pluginEntryPaths = new Map<string, string>();\n  for (const plugin of plugins) {\n    if (plugin.isHost) continue;\n    const entryPath = path.join(stylesDir, `${pluginStyleEntryName(plugin.slot)}.css`);\n    fs.writeFileSync(\n      entryPath,\n      `/* ${HEADER.slice(3)} */\\n@import '${appCss}';\\n@source \"${pluginSourceRoot(plugin)}\";\\n`,\n    );\n    pluginEntryPaths.set(plugin.slot, entryPath);\n  }\n  return { baseSourcesPath, baseEntryPath, pluginEntryPaths };\n}\n\n/**\n * The sync-time variant: renders the full client plugin set (host built-ins plus\n * the installed composition's packages) into a generation directory the bundler\n * aliases over the committed builtin modules.\n */\nexport function writeSyncWebPluginModules(\n  plugins: readonly DeclaredWebPlugin[],\n  generatedDir: string,\n  packageRoot: string,\n): SyncGeneratedModules {\n  fs.mkdirSync(generatedDir, { recursive: true });\n  const clientModulePath = path.join(generatedDir, 'webPlugins.generated.ts');\n  const cssModulePath = path.join(generatedDir, 'webPluginSources.generated.css');\n  fs.writeFileSync(clientModulePath, renderClientModule(plugins, 'absolute', packageRoot));\n  // Styles are built per plugin by writeWebPluginStyleEntries, so slot entries carry none.\n  const slotsDir = path.join(generatedDir, 'slots');\n  fs.mkdirSync(slotsDir, { recursive: true });\n  const slotEntryPaths: Record<string, string> = {};\n  for (const plugin of plugins) {\n    const entryPath = path.join(slotsDir, `${plugin.slot}.ts`);\n    const specifier = pathToFileURL(fs.realpathSync(path.join(plugin.packageDir, plugin.client.entry))).href;\n    fs.writeFileSync(entryPath, `${HEADER}\\nexport { webPlugin } from '${specifier}';\\n`);\n    slotEntryPaths[plugin.slot] = entryPath;\n  }\n  const fallbackTemplate = fallbackTemplateSourceRoot(packageRoot);\n  const leadingSourceRoots = [\n    path.join(packageRoot, 'src', 'web'),\n    ...(fallbackTemplate === undefined ? [] : [fallbackTemplate]),\n  ];\n  fs.writeFileSync(cssModulePath, renderCssModule(plugins, leadingSourceRoots));\n  const hostPlugins = plugins.filter((plugin) => plugin.isHost);\n  const shell = {\n    clientModulePath: path.join(generatedDir, 'webPluginShell.generated.ts'),\n    cssModulePath: path.join(generatedDir, 'webPluginShellSources.generated.css'),\n  };\n  fs.writeFileSync(shell.clientModulePath, renderClientModule(hostPlugins, 'absolute', packageRoot));\n  fs.writeFileSync(shell.cssModulePath, renderCssModule(hostPlugins, leadingSourceRoots));\n  return {\n    clientModulePath,\n    slotEntryPaths,\n    cssModulePath,\n    shell,\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,56 @@
+import { DeclaredWebPlugin } from "./webPluginManifest.mjs";
+//#region src/builders/web/webPluginGenerate.d.ts
+export declare const BUILTIN_CLIENT_MODULE: string;
+export declare const BUILTIN_CSS_MODULE: string;
+/** The committed client registry, rendered from the host package alone. */
+export declare function renderBuiltinWebPluginModules(packageRoot: string): Map<string, string>;
+/**
+ * Keeps the committed client registry fresh: write-if-changed locally,
+ * check-only (throw) in CI. Both vite.config.ts and tsdown.config.ts call
+ * this at config-load time.
+ */
+export declare function ensureBuiltinWebPluginModules({ packageRoot, check }: {
+  packageRoot: string;
+  check?: boolean;
+}): void;
+/** A client plugin registry and the Tailwind source list that goes with it. */
+export interface WebPluginRegistryModules {
+  clientModulePath: string;
+  cssModulePath: string;
+}
+export interface SyncGeneratedModules extends WebPluginRegistryModules {
+  /** One entry module per slot, each re-exporting only that copy's `webPlugin`. */
+  slotEntryPaths: Record<string, string>;
+  /**
+   * The signed shell's registry: host plugins only. Every other plugin reaches the
+   * browser through its slot entry, and the global mount replaces the shell's
+   * registry once it loads, so compiling them into the shell too shipped each plugin's
+   * code and emitted assets (the voice VAD model among them) a second time.
+   */
+  shell: WebPluginRegistryModules;
+}
+export interface WebPluginStyleEntries {
+  /** Shell and fallback-template sources only, aliased over app.css's plugin source list. */
+  baseSourcesPath: string;
+  /** The stylesheet every plugin entry extends; a mount with no plugin styles loads it alone. */
+  baseEntryPath: string;
+  /** One stylesheet entry per non-host plugin copy, keyed by its slot. */
+  pluginEntryPaths: Map<string, string>;
+}
+/** The style entry of each plugin's Rollup input name, so each emits one content-hashed file. */
+export declare const BASE_STYLE_ENTRY = "base";
+export declare const pluginStyleEntryName: (slot: string) => string;
+/**
+ * One Tailwind entry per plugin: app.css with only the shell's sources plus that plugin's,
+ * so a mount that loads its plugins' files never receives another workspace's classes.
+ * Host plugins live in the shell's sources and share the base entry.
+ */
+export declare function writeWebPluginStyleEntries(plugins: readonly DeclaredWebPlugin[], generatedDir: string, packageRoot: string): WebPluginStyleEntries;
+/**
+ * The sync-time variant: renders the full client plugin set (host built-ins plus
+ * the installed composition's packages) into a generation directory the bundler
+ * aliases over the committed builtin modules.
+ */
+export declare function writeSyncWebPluginModules(plugins: readonly DeclaredWebPlugin[], generatedDir: string, packageRoot: string): SyncGeneratedModules;
+//#endregion
+//# sourceMappingURL=webPluginGenerate.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webPluginGenerate.d.mts","names":[],"sources":["../../../../src/builders/web/webPluginGenerate.ts"],"mappings":";;qBAWa;qBACA;;wBAiGG,8BAA8B,sBAAsB;;;;;;wBAapD,gCACd,aACA;EAEA;EACA;;;iBAsBe;EACf;EACA;;iBAGe,6BAA6B;;EAE5C,gBAAgB;;;;;;;EAOhB,OAAO;;iBAGQ;;EAEf;;EAEA;;EAEA,kBAAkB;;;qBAIP;qBACA,uBAAoB;;;;;;wBAOjB,2BACd,kBAAkB,qBAClB,sBACA,sBACC;;;;;;wBAqCa,0BACd,kBAAkB,qBAClB,sBACA,sBACC"}

package/dist/src/builders/web/webPluginGenerate.mjs

@@ -0,0 +1,178 @@
+import { scanWebPlugins } from "./webPluginScan.mjs";
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+//#region src/builders/web/webPluginGenerate.ts
+const HEADER = "// Generated by po web builder. Do not edit by hand.";
+/** The template po-web renders when a composition names none, so its classes always compile. */
+const FALLBACK_TEMPLATE_PACKAGE = "@agimon-ai/po-template-advanced";
+const BUILTIN_CLIENT_MODULE = path.join("src", "web", "app", "webPlugins.generated.ts");
+const BUILTIN_CSS_MODULE = path.join("src", "web", "styles", "webPluginSources.generated.css");
+/**
+* The import name of one plugin copy, derived from its slot so two copies of one pluginId
+* never collide. A host slot is its kebab-case pluginId and keeps the committed module's
+* names; a copy slot's '.' becomes '_', which no host name can contain.
+*/
+function slotIdentifier(slot) {
+	return slot.replace(/-([a-z0-9])/g, (_, ch) => ch.toUpperCase()).replace(/[^A-Za-z0-9_$]/g, "_");
+}
+function relativeImport(fromDir, toFile) {
+	const spec = path.relative(fromDir, toFile).split(path.sep).join("/");
+	return spec.startsWith(".") ? spec : `./${spec}`;
+}
+function renderClientModule(plugins, style, packageRoot) {
+	const lines = [HEADER, "import type { WebPluginDefinition } from '@agimon-ai/po-core/web';"];
+	const names = [];
+	const fromDir = path.join(packageRoot, "src", "web", "app");
+	for (const plugin of plugins) {
+		const name = `${slotIdentifier(plugin.slot)}Plugin`;
+		names.push(name);
+		const entry = path.join(plugin.packageDir, plugin.client.entry);
+		const specifier = style === "relative" ? relativeImport(fromDir, entry) : pathToFileURL(fs.realpathSync(entry)).href;
+		lines.push(`import { webPlugin as ${name} } from '${specifier}';`);
+	}
+	lines.push("", `export const webPlugins: readonly WebPluginDefinition[] = [${names.join(", ")}];`, "");
+	return lines.join("\n");
+}
+/**
+* The directory Tailwind scans for a plugin's class names.
+*
+* `src/extensions` wins, because a plugin's components colocate with the routed
+* file that renders them, in private `_components` and `_lib` folders. The
+* legacy `src/web` root is only a fallback: `existsSync` is true for a
+* half-emptied directory holding nothing but a tsconfig, and packages have been
+* in exactly that state, so preferring it would hand Tailwind a directory with
+* no components in it and silently drop every class.
+*
+* The client entry's own directory is the last resort. It is published through
+* `src/exports/webClient.ts`, a one-line re-export, or generated outside `src`
+* entirely, so it holds no components either.
+*/
+function pluginSourceRoot(plugin) {
+	const routingRoot = path.join(plugin.packageDir, "src", "extensions");
+	if (fs.existsSync(routingRoot)) return routingRoot;
+	const webRoot = path.join(plugin.packageDir, "src", "web");
+	if (fs.existsSync(webRoot)) return webRoot;
+	return path.dirname(path.join(plugin.packageDir, plugin.client.entry));
+}
+/**
+* Where Tailwind finds the fallback template's classes. app.css names it by a
+* path from its own folder into po-web's node_modules, which holds only in
+* this repository; an installed po-web has the template beside it instead,
+* so a sync build that scanned only that path shipped the cockpit without the
+* template's responsive layout. Resolving it as Node does works in both.
+*/
+function fallbackTemplateSourceRoot(packageRoot) {
+	let manifest;
+	try {
+		manifest = createRequire(path.join(packageRoot, "package.json")).resolve(`${FALLBACK_TEMPLATE_PACKAGE}/package.json`);
+	} catch {
+		return;
+	}
+	const extensions = path.join(path.dirname(manifest), "dist", "extensions");
+	return fs.existsSync(extensions) ? extensions : void 0;
+}
+function renderCssModule(plugins, leadingSourceRoots) {
+	const lines = [`/* ${HEADER.slice(3)} */`, ...leadingSourceRoots.map((root) => `@source "${root}";`)];
+	for (const plugin of plugins) {
+		if (plugin.isHost) continue;
+		lines.push(`@source "${pluginSourceRoot(plugin)}";`);
+	}
+	lines.push("");
+	return lines.join("\n");
+}
+/** The committed client registry, rendered from the host package alone. */
+function renderBuiltinWebPluginModules(packageRoot) {
+	const plugins = scanWebPlugins(packageRoot);
+	return /* @__PURE__ */ new Map([[BUILTIN_CLIENT_MODULE, renderClientModule(plugins, "relative", packageRoot)], [BUILTIN_CSS_MODULE, renderCssModule(plugins, [])]]);
+}
+/**
+* Keeps the committed client registry fresh: write-if-changed locally,
+* check-only (throw) in CI. Both vite.config.ts and tsdown.config.ts call
+* this at config-load time.
+*/
+function ensureBuiltinWebPluginModules({ packageRoot, check = false }) {
+	const stale = [];
+	for (const [relativePath, content] of renderBuiltinWebPluginModules(packageRoot)) {
+		const filePath = path.join(packageRoot, relativePath);
+		if ((fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : void 0) === content) continue;
+		if (check) {
+			stale.push(relativePath);
+			continue;
+		}
+		fs.mkdirSync(path.dirname(filePath), { recursive: true });
+		fs.writeFileSync(filePath, content);
+	}
+	if (stale.length > 0) throw new Error(`Stale generated web plugin modules: ${stale.join(", ")}. Run pnpm build in po-web and commit them.`);
+}
+/** The style entry of each plugin's Rollup input name, so each emits one content-hashed file. */
+const BASE_STYLE_ENTRY = "base";
+const pluginStyleEntryName = (slot) => `plugin-${slot}`;
+/**
+* One Tailwind entry per plugin: app.css with only the shell's sources plus that plugin's,
+* so a mount that loads its plugins' files never receives another workspace's classes.
+* Host plugins live in the shell's sources and share the base entry.
+*/
+function writeWebPluginStyleEntries(plugins, generatedDir, packageRoot) {
+	const stylesDir = path.join(generatedDir, "styles");
+	fs.mkdirSync(stylesDir, { recursive: true });
+	const fallbackTemplate = fallbackTemplateSourceRoot(packageRoot);
+	const baseSourcesPath = path.join(generatedDir, "webPluginBaseSources.generated.css");
+	fs.writeFileSync(baseSourcesPath, renderCssModule([], [path.join(packageRoot, "src", "web"), ...fallbackTemplate === void 0 ? [] : [fallbackTemplate]]));
+	const appCss = relativeImport(fs.realpathSync(stylesDir), fs.realpathSync(path.join(packageRoot, "src", "web", "styles", "app.css")));
+	const baseEntryPath = path.join(stylesDir, `${BASE_STYLE_ENTRY}.css`);
+	fs.writeFileSync(baseEntryPath, `/* ${HEADER.slice(3)} */\n@import '${appCss}';\n`);
+	const pluginEntryPaths = /* @__PURE__ */ new Map();
+	for (const plugin of plugins) {
+		if (plugin.isHost) continue;
+		const entryPath = path.join(stylesDir, `${pluginStyleEntryName(plugin.slot)}.css`);
+		fs.writeFileSync(entryPath, `/* ${HEADER.slice(3)} */\n@import '${appCss}';\n@source "${pluginSourceRoot(plugin)}";\n`);
+		pluginEntryPaths.set(plugin.slot, entryPath);
+	}
+	return {
+		baseSourcesPath,
+		baseEntryPath,
+		pluginEntryPaths
+	};
+}
+/**
+* The sync-time variant: renders the full client plugin set (host built-ins plus
+* the installed composition's packages) into a generation directory the bundler
+* aliases over the committed builtin modules.
+*/
+function writeSyncWebPluginModules(plugins, generatedDir, packageRoot) {
+	fs.mkdirSync(generatedDir, { recursive: true });
+	const clientModulePath = path.join(generatedDir, "webPlugins.generated.ts");
+	const cssModulePath = path.join(generatedDir, "webPluginSources.generated.css");
+	fs.writeFileSync(clientModulePath, renderClientModule(plugins, "absolute", packageRoot));
+	const slotsDir = path.join(generatedDir, "slots");
+	fs.mkdirSync(slotsDir, { recursive: true });
+	const slotEntryPaths = {};
+	for (const plugin of plugins) {
+		const entryPath = path.join(slotsDir, `${plugin.slot}.ts`);
+		const specifier = pathToFileURL(fs.realpathSync(path.join(plugin.packageDir, plugin.client.entry))).href;
+		fs.writeFileSync(entryPath, `${HEADER}\nexport { webPlugin } from '${specifier}';\n`);
+		slotEntryPaths[plugin.slot] = entryPath;
+	}
+	const fallbackTemplate = fallbackTemplateSourceRoot(packageRoot);
+	const leadingSourceRoots = [path.join(packageRoot, "src", "web"), ...fallbackTemplate === void 0 ? [] : [fallbackTemplate]];
+	fs.writeFileSync(cssModulePath, renderCssModule(plugins, leadingSourceRoots));
+	const hostPlugins = plugins.filter((plugin) => plugin.isHost);
+	const shell = {
+		clientModulePath: path.join(generatedDir, "webPluginShell.generated.ts"),
+		cssModulePath: path.join(generatedDir, "webPluginShellSources.generated.css")
+	};
+	fs.writeFileSync(shell.clientModulePath, renderClientModule(hostPlugins, "absolute", packageRoot));
+	fs.writeFileSync(shell.cssModulePath, renderCssModule(hostPlugins, leadingSourceRoots));
+	return {
+		clientModulePath,
+		slotEntryPaths,
+		cssModulePath,
+		shell
+	};
+}
+//#endregion
+export { BASE_STYLE_ENTRY, BUILTIN_CLIENT_MODULE, BUILTIN_CSS_MODULE, ensureBuiltinWebPluginModules, pluginStyleEntryName, renderBuiltinWebPluginModules, writeSyncWebPluginModules, writeWebPluginStyleEntries };
+
+//# sourceMappingURL=webPluginGenerate.mjs.map

package/dist/src/builders/web/webPluginGenerate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPluginGenerate.mjs","names":[],"sources":["../../../../src/builders/web/webPluginGenerate.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport type { DeclaredWebPlugin } from './webPluginManifest';\nimport { scanWebPlugins } from './webPluginScan';\n\nconst HEADER = '// Generated by po web builder. Do not edit by hand.';\n/** The template po-web renders when a composition names none, so its classes always compile. */\nconst FALLBACK_TEMPLATE_PACKAGE = '@agimon-ai/po-template-advanced';\nexport const BUILTIN_CLIENT_MODULE = path.join('src', 'web', 'app', 'webPlugins.generated.ts');\nexport const BUILTIN_CSS_MODULE = path.join('src', 'web', 'styles', 'webPluginSources.generated.css');\n\n/**\n * The import name of one plugin copy, derived from its slot so two copies of one pluginId\n * never collide. A host slot is its kebab-case pluginId and keeps the committed module's\n * names; a copy slot's '.' becomes '_', which no host name can contain.\n */\nfunction slotIdentifier(slot: string): string {\n  return slot.replace(/-([a-z0-9])/g, (_, ch: string) => ch.toUpperCase()).replace(/[^A-Za-z0-9_$]/g, '_');\n}\n\nfunction relativeImport(fromDir: string, toFile: string): string {\n  const spec = path.relative(fromDir, toFile).split(path.sep).join('/');\n  return spec.startsWith('.') ? spec : `./${spec}`;\n}\n\nfunction renderClientModule(\n  plugins: readonly DeclaredWebPlugin[],\n  style: 'relative' | 'absolute',\n  packageRoot: string,\n): string {\n  const lines = [HEADER, \"import type { WebPluginDefinition } from '@agimon-ai/po-core/web';\"];\n  const names: string[] = [];\n  const fromDir = path.join(packageRoot, 'src', 'web', 'app');\n  for (const plugin of plugins) {\n    const name = `${slotIdentifier(plugin.slot)}Plugin`;\n    names.push(name);\n    const entry = path.join(plugin.packageDir, plugin.client.entry);\n    // The committed builtin module keeps machine-neutral relative imports; the\n    // sync-generated module lives outside src, is aliased over the committed\n    // path, and resolves imports against its real location, so every entry\n    // becomes an absolute file URL into the installed packages.\n    const specifier =\n      style === 'relative' ? relativeImport(fromDir, entry) : pathToFileURL(fs.realpathSync(entry)).href;\n    lines.push(`import { webPlugin as ${name} } from '${specifier}';`);\n  }\n  lines.push('', `export const webPlugins: readonly WebPluginDefinition[] = [${names.join(', ')}];`, '');\n  return lines.join('\\n');\n}\n\n/**\n * The directory Tailwind scans for a plugin's class names.\n *\n * `src/extensions` wins, because a plugin's components colocate with the routed\n * file that renders them, in private `_components` and `_lib` folders. The\n * legacy `src/web` root is only a fallback: `existsSync` is true for a\n * half-emptied directory holding nothing but a tsconfig, and packages have been\n * in exactly that state, so preferring it would hand Tailwind a directory with\n * no components in it and silently drop every class.\n *\n * The client entry's own directory is the last resort. It is published through\n * `src/exports/webClient.ts`, a one-line re-export, or generated outside `src`\n * entirely, so it holds no components either.\n */\nfunction pluginSourceRoot(plugin: DeclaredWebPlugin): string {\n  const routingRoot = path.join(plugin.packageDir, 'src', 'extensions');\n  if (fs.existsSync(routingRoot)) return routingRoot;\n  const webRoot = path.join(plugin.packageDir, 'src', 'web');\n  if (fs.existsSync(webRoot)) return webRoot;\n  return path.dirname(path.join(plugin.packageDir, plugin.client.entry));\n}\n\n/**\n * Where Tailwind finds the fallback template's classes. app.css names it by a\n * path from its own folder into po-web's node_modules, which holds only in\n * this repository; an installed po-web has the template beside it instead,\n * so a sync build that scanned only that path shipped the cockpit without the\n * template's responsive layout. Resolving it as Node does works in both.\n */\nfunction fallbackTemplateSourceRoot(packageRoot: string): string | undefined {\n  let manifest: string;\n  try {\n    manifest = createRequire(path.join(packageRoot, 'package.json')).resolve(\n      `${FALLBACK_TEMPLATE_PACKAGE}/package.json`,\n    );\n  } catch {\n    // Not installed: the cockpit then has no fallback template to render either.\n    return undefined;\n  }\n  const extensions = path.join(path.dirname(manifest), 'dist', 'extensions');\n  return fs.existsSync(extensions) ? extensions : undefined;\n}\n\nfunction renderCssModule(plugins: readonly DeclaredWebPlugin[], leadingSourceRoots: readonly string[]): string {\n  // Sync CSS is compiled from a generated directory, so Tailwind cannot infer\n  // the stable shell tree from app.css. Its caller names that tree explicitly\n  // so later plugin utilities do not override missing responsive shell utilities.\n  const lines = [`/* ${HEADER.slice(3)} */`, ...leadingSourceRoots.map((root) => `@source \"${root}\";`)];\n  for (const plugin of plugins) {\n    if (plugin.isHost) continue;\n    lines.push(`@source \"${pluginSourceRoot(plugin)}\";`);\n  }\n  lines.push('');\n  return lines.join('\\n');\n}\n\n/** The committed client registry, rendered from the host package alone. */\nexport function renderBuiltinWebPluginModules(packageRoot: string): Map<string, string> {\n  const plugins = scanWebPlugins(packageRoot);\n  return new Map([\n    [BUILTIN_CLIENT_MODULE, renderClientModule(plugins, 'relative', packageRoot)],\n    [BUILTIN_CSS_MODULE, renderCssModule(plugins, [])],\n  ]);\n}\n\n/**\n * Keeps the committed client registry fresh: write-if-changed locally,\n * check-only (throw) in CI. Both vite.config.ts and tsdown.config.ts call\n * this at config-load time.\n */\nexport function ensureBuiltinWebPluginModules({\n  packageRoot,\n  check = false,\n}: {\n  packageRoot: string;\n  check?: boolean;\n}): void {\n  const stale: string[] = [];\n  for (const [relativePath, content] of renderBuiltinWebPluginModules(packageRoot)) {\n    const filePath = path.join(packageRoot, relativePath);\n    const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : undefined;\n    if (existing === content) continue;\n    if (check) {\n      stale.push(relativePath);\n      continue;\n    }\n    fs.mkdirSync(path.dirname(filePath), { recursive: true });\n    fs.writeFileSync(filePath, content);\n  }\n  if (stale.length > 0) {\n    throw new Error(\n      `Stale generated web plugin modules: ${stale.join(', ')}. Run pnpm build in po-web and commit them.`,\n    );\n  }\n}\n\n/** A client plugin registry and the Tailwind source list that goes with it. */\nexport interface WebPluginRegistryModules {\n  clientModulePath: string;\n  cssModulePath: string;\n}\n\nexport interface SyncGeneratedModules extends WebPluginRegistryModules {\n  /** One entry module per slot, each re-exporting only that copy's `webPlugin`. */\n  slotEntryPaths: Record<string, string>;\n  /**\n   * The signed shell's registry: host plugins only. Every other plugin reaches the\n   * browser through its slot entry, and the global mount replaces the shell's\n   * registry once it loads, so compiling them into the shell too shipped each plugin's\n   * code and emitted assets (the voice VAD model among them) a second time.\n   */\n  shell: WebPluginRegistryModules;\n}\n\nexport interface WebPluginStyleEntries {\n  /** Shell and fallback-template sources only, aliased over app.css's plugin source list. */\n  baseSourcesPath: string;\n  /** The stylesheet every plugin entry extends; a mount with no plugin styles loads it alone. */\n  baseEntryPath: string;\n  /** One stylesheet entry per non-host plugin copy, keyed by its slot. */\n  pluginEntryPaths: Map<string, string>;\n}\n\n/** The style entry of each plugin's Rollup input name, so each emits one content-hashed file. */\nexport const BASE_STYLE_ENTRY = 'base';\nexport const pluginStyleEntryName = (slot: string): string => `plugin-${slot}`;\n\n/**\n * One Tailwind entry per plugin: app.css with only the shell's sources plus that plugin's,\n * so a mount that loads its plugins' files never receives another workspace's classes.\n * Host plugins live in the shell's sources and share the base entry.\n */\nexport function writeWebPluginStyleEntries(\n  plugins: readonly DeclaredWebPlugin[],\n  generatedDir: string,\n  packageRoot: string,\n): WebPluginStyleEntries {\n  const stylesDir = path.join(generatedDir, 'styles');\n  fs.mkdirSync(stylesDir, { recursive: true });\n  const fallbackTemplate = fallbackTemplateSourceRoot(packageRoot);\n  const baseSourcesPath = path.join(generatedDir, 'webPluginBaseSources.generated.css');\n  fs.writeFileSync(\n    baseSourcesPath,\n    renderCssModule(\n      [],\n      [path.join(packageRoot, 'src', 'web'), ...(fallbackTemplate === undefined ? [] : [fallbackTemplate])],\n    ),\n  );\n  // Resolvers follow real paths (a temp dir under /var is /private/var), so relate real paths.\n  const appCss = relativeImport(\n    fs.realpathSync(stylesDir),\n    fs.realpathSync(path.join(packageRoot, 'src', 'web', 'styles', 'app.css')),\n  );\n  const baseEntryPath = path.join(stylesDir, `${BASE_STYLE_ENTRY}.css`);\n  fs.writeFileSync(baseEntryPath, `/* ${HEADER.slice(3)} */\\n@import '${appCss}';\\n`);\n  const pluginEntryPaths = new Map<string, string>();\n  for (const plugin of plugins) {\n    if (plugin.isHost) continue;\n    const entryPath = path.join(stylesDir, `${pluginStyleEntryName(plugin.slot)}.css`);\n    fs.writeFileSync(\n      entryPath,\n      `/* ${HEADER.slice(3)} */\\n@import '${appCss}';\\n@source \"${pluginSourceRoot(plugin)}\";\\n`,\n    );\n    pluginEntryPaths.set(plugin.slot, entryPath);\n  }\n  return { baseSourcesPath, baseEntryPath, pluginEntryPaths };\n}\n\n/**\n * The sync-time variant: renders the full client plugin set (host built-ins plus\n * the installed composition's packages) into a generation directory the bundler\n * aliases over the committed builtin modules.\n */\nexport function writeSyncWebPluginModules(\n  plugins: readonly DeclaredWebPlugin[],\n  generatedDir: string,\n  packageRoot: string,\n): SyncGeneratedModules {\n  fs.mkdirSync(generatedDir, { recursive: true });\n  const clientModulePath = path.join(generatedDir, 'webPlugins.generated.ts');\n  const cssModulePath = path.join(generatedDir, 'webPluginSources.generated.css');\n  fs.writeFileSync(clientModulePath, renderClientModule(plugins, 'absolute', packageRoot));\n  // Styles are built per plugin by writeWebPluginStyleEntries, so slot entries carry none.\n  const slotsDir = path.join(generatedDir, 'slots');\n  fs.mkdirSync(slotsDir, { recursive: true });\n  const slotEntryPaths: Record<string, string> = {};\n  for (const plugin of plugins) {\n    const entryPath = path.join(slotsDir, `${plugin.slot}.ts`);\n    const specifier = pathToFileURL(fs.realpathSync(path.join(plugin.packageDir, plugin.client.entry))).href;\n    fs.writeFileSync(entryPath, `${HEADER}\\nexport { webPlugin } from '${specifier}';\\n`);\n    slotEntryPaths[plugin.slot] = entryPath;\n  }\n  const fallbackTemplate = fallbackTemplateSourceRoot(packageRoot);\n  const leadingSourceRoots = [\n    path.join(packageRoot, 'src', 'web'),\n    ...(fallbackTemplate === undefined ? [] : [fallbackTemplate]),\n  ];\n  fs.writeFileSync(cssModulePath, renderCssModule(plugins, leadingSourceRoots));\n  const hostPlugins = plugins.filter((plugin) => plugin.isHost);\n  const shell = {\n    clientModulePath: path.join(generatedDir, 'webPluginShell.generated.ts'),\n    cssModulePath: path.join(generatedDir, 'webPluginShellSources.generated.css'),\n  };\n  fs.writeFileSync(shell.clientModulePath, renderClientModule(hostPlugins, 'absolute', packageRoot));\n  fs.writeFileSync(shell.cssModulePath, renderCssModule(hostPlugins, leadingSourceRoots));\n  return {\n    clientModulePath,\n    slotEntryPaths,\n    cssModulePath,\n    shell,\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,128 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.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_crypto = require("node:crypto");
+node_crypto = require_runtime.__toESM(node_crypto, 1);
+//#region src/builders/web/webPluginManifest.ts
+/**
+* The poWeb manifest vocabulary: how a package declares its web plugin in
+* package.json, validated and ordered; the filesystem is read only to name each
+* copy's slot by its real directory. The
+* scan adapter feeds this from real manifests; the sync bundler feeds it from
+* the installed composition's package roots.
+*
+* Plugins are independent: a manifest names no other plugin, and the order
+* plugins install in is only a tiebreak (registrationOrder, then pluginId),
+* because every relation between two plugins resolves by name once all of
+* them are installed. A collision between two packages is a notice for the
+* sync log and the first package keeps the name; only a malformed block is an
+* error, which the scanner turns into a notice for that package alone.
+*
+* The native app's poNative blocks share this exact shape, so the same
+* validation reads either field.
+*/
+const PLUGIN_ID_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+/** The order a plugin installs at when its manifest names none. */
+const DEFAULT_REGISTRATION_ORDER = 1e3;
+var WebPluginManifestError = class extends Error {
+	constructor(packageDir, message, field = "poWeb") {
+		super(`${field} manifest in ${packageDir}: ${message}`);
+		this.name = "WebPluginManifestError";
+	}
+};
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeEntry(packageDir, kind, value, field) {
+	const raw = typeof value === "string" ? { entry: value } : value;
+	if (!isRecord(raw)) throw new WebPluginManifestError(packageDir, `${kind} must be a path or {entry}.`, field);
+	const { entry } = raw;
+	if (typeof entry !== "string" || !entry.startsWith("./") || entry.includes("..")) throw new WebPluginManifestError(packageDir, `${kind}.entry must be a package-relative ./path with no '..'.`, field);
+	return { entry };
+}
+const SLOT_HASH_LENGTH = 8;
+/** The slot of one installed plugin copy; see DeclaredWebPlugin.slot. */
+function pluginSlot(plugin) {
+	if (plugin.isHost) return plugin.pluginId;
+	let directory;
+	try {
+		directory = node_fs.default.realpathSync(plugin.packageDir);
+	} catch {
+		directory = node_path.default.resolve(plugin.packageDir);
+	}
+	const digest = node_crypto.default.createHash("sha256").update(directory).digest("hex");
+	return `${plugin.pluginId}.${digest.slice(0, SLOT_HASH_LENGTH)}`;
+}
+/** The field's value normalized to a list: one plugin object or an array of them. */
+function pluginBlocksOf(manifest, field = "poWeb") {
+	const value = manifest[field];
+	if (value === void 0) return [];
+	return Array.isArray(value) ? value : [value];
+}
+/** Validates one manifest's blocks into declared plugins; throws WebPluginManifestError on bad shape. */
+function declaredPluginsOf(packageDir, manifest, isHost, field = "poWeb") {
+	const plugins = [];
+	for (const block of pluginBlocksOf(manifest, field)) {
+		if (!isRecord(block)) throw new WebPluginManifestError(packageDir, "each block must be an object.", field);
+		const { pluginId, registrationOrder = DEFAULT_REGISTRATION_ORDER, client, scopes } = block;
+		if (!Array.isArray(scopes) || scopes.length === 0 || scopes.some((scope) => ![
+			"global",
+			"workspace",
+			"session"
+		].includes(scope))) throw new WebPluginManifestError(packageDir, "scopes must explicitly name global, workspace, or session; resync the plugin.", field);
+		if (typeof pluginId !== "string" || !PLUGIN_ID_PATTERN.test(pluginId)) throw new WebPluginManifestError(packageDir, `pluginId '${String(pluginId)}' must be kebab-case.`, field);
+		if (!Number.isInteger(registrationOrder) || registrationOrder < 0) throw new WebPluginManifestError(packageDir, `'${pluginId}' needs a non-negative integer registrationOrder.`, field);
+		plugins.push({
+			pluginId,
+			slot: pluginSlot({
+				pluginId,
+				packageDir,
+				isHost
+			}),
+			registrationOrder,
+			packageDir,
+			packageName: typeof manifest.name === "string" ? manifest.name : packageDir,
+			isHost,
+			client: normalizeEntry(packageDir, "client", client, field),
+			scopes
+		});
+	}
+	return plugins;
+}
+/** Code-unit order, never the locale's: the same packages must order the same on every machine. */
+function compareCodeUnits(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+const byInstallOrder = (left, right) => left.registrationOrder - right.registrationOrder || compareCodeUnits(left.pluginId, right.pluginId) || compareCodeUnits(left.packageDir, right.packageDir);
+/**
+* The deterministic install order, (registrationOrder, pluginId), with the
+* cross-package collisions resolved by the browser client registry: the first
+* plugin keeps a shared pluginId and the later package is dropped with a notice.
+*/
+function orderDeclaredPlugins(plugins, onNotice = () => void 0) {
+	const sorted = [...plugins].sort(byInstallOrder);
+	const byId = /* @__PURE__ */ new Map();
+	const kept = [];
+	for (const plugin of sorted) {
+		const holder = byId.get(plugin.pluginId);
+		if (holder !== void 0) {
+			onNotice(`web plugin '${plugin.pluginId}' from ${plugin.packageDir} is skipped: ${holder.packageDir} already declares it.`);
+			continue;
+		}
+		byId.set(plugin.pluginId, plugin);
+		kept.push(plugin);
+	}
+	return kept;
+}
+//#endregion
+exports.DEFAULT_REGISTRATION_ORDER = DEFAULT_REGISTRATION_ORDER;
+exports.WebPluginManifestError = WebPluginManifestError;
+exports.compareCodeUnits = compareCodeUnits;
+exports.declaredPluginsOf = declaredPluginsOf;
+exports.orderDeclaredPlugins = orderDeclaredPlugins;
+exports.pluginBlocksOf = pluginBlocksOf;
+exports.pluginSlot = pluginSlot;
+
+//# sourceMappingURL=webPluginManifest.cjs.map