@earendil-works/chord 1.3.0 → 1.5.0

package/dist/next-node/plugins/evaluate.d.ts

@@ -0,0 +1,33 @@
+import type { Principal } from "../../next/data/index.ts";
+import type { Facet } from "../../next/host/index.ts";
+import type { BuiltFacet } from "./build.ts";
+import type { Plugin } from "./discover.ts";
+/**
+ * The host packages by specifier, each what Node's `require` would give: a CommonJS package's exports, an ESM
+ * package's namespace (`import * as`), wrapped once so default and named imports both work.
+ */
+export type HostPackages = Readonly<Record<string, unknown>>;
+/** What `evaluateFacet` takes besides the script: the host packages and the plugin it was built from. */
+export type EvaluateOptions = {
+    readonly hostPackages: HostPackages;
+    readonly plugin: Plugin;
+};
+/** A built script, as evaluation takes it. */
+export type BuiltScript = Extract<BuiltFacet, {
+    readonly kind: "script";
+}>;
+/**
+ * Evaluates `built` and returns its facet (its default export). Throws what the script throws while it is evaluated,
+ * an import its `require` does not answer, or a declaration error when its default export is not a facet.
+ */
+export declare function evaluateFacet<P extends Principal = Principal>(built: BuiltScript, options: EvaluateOptions): Facet<P>;
+/**
+ * Inside a facet script, the absolute path of `path`, a file of the facet's own plugin (`..` out of its directory
+ * refused); evaluation gives each facet its own. Imported anywhere else, it throws.
+ */
+export declare function pluginFile(path: string): string;
+/** The one specifier of this component a script imports (`pluginFile`): external always, answered per facet. */
+export declare const PLUGINS_SPECIFIER = "@earendil-works/chord/next/plugins";
+/** The package a bare specifier names: `@scope/name` or `name`, without a subpath. */
+export declare function packageName(specifier: string): string;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/next-node/plugins/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../src/next-node/plugins/evaluate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D,yGAAyG;AACzG,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CA2BrH;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,gHAAgH;AAChH,eAAO,MAAM,iBAAiB,uCAAuC,CAAC;AAsBtE,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/next-node/plugins/evaluate.js

@@ -0,0 +1,98 @@
+// Evaluating (slice 7c §3): a built script run with `vm.Script` in this context under a stable filename per (plugin,
+// kind, digest), given the `require` that answers its external imports: the host packages (one instance per process),
+// this component's `pluginFile` bound to the plugin's directory, and `chord.external` packages and Node builtins from
+// the plugin's own `node_modules`. No module map and no cache: an old facet's closures are collected once nothing holds
+// them.
+import { createRequire, isBuiltin } from "node:module";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
+import { Script } from "node:vm";
+import { registerScript } from "./stack.js";
+/**
+ * Evaluates `built` and returns its facet (its default export). Throws what the script throws while it is evaluated,
+ * an import its `require` does not answer, or a declaration error when its default export is not a facet.
+ */
+export function evaluateFacet(built, options) {
+    const { plugin, hostPackages } = options;
+    const where = `plugin "${plugin.name}" (${built.facet})`;
+    const file = plugin.facets[built.facet] ?? `${built.facet}.js`;
+    const filename = `/chord-plugins/${plugin.name}/${basename(file)}?${built.digest}`;
+    // The script is one function expression: its value when run.
+    const wrapper = new Script(built.source, { filename }).runInThisContext();
+    const module = { exports: {} };
+    let facet;
+    try {
+        wrapper(requireFor(plugin, hostPackages, where), module, module.exports);
+        // A trust boundary: plugin code; its default export is checked to be a facet (a getter of it may throw too).
+        facet = module.exports?.default;
+        if (typeof facet !== "object" || facet === null || typeof facet.setup !== "function") {
+            throw new Error(`${where}: its default export is not a facet (defineFacet)`);
+        }
+    }
+    catch (error) {
+        // Its stack maps while the error lives (an import-time throw names the plugin's line).
+        if (typeof error === "object" && error !== null)
+            registerScript(filename, built.source, plugin.dir, error);
+        throw error;
+    }
+    registerScript(filename, built.source, plugin.dir, facet);
+    return facet;
+}
+/**
+ * Inside a facet script, the absolute path of `path`, a file of the facet's own plugin (`..` out of its directory
+ * refused); evaluation gives each facet its own. Imported anywhere else, it throws.
+ */
+export function pluginFile(path) {
+    throw new Error(`pluginFile("${path}"): only a plugin's facet script, evaluated by the plugins component, has one`);
+}
+/** The one specifier of this component a script imports (`pluginFile`): external always, answered per facet. */
+export const PLUGINS_SPECIFIER = "@earendil-works/chord/next/plugins";
+/** The `require` a facet script of `plugin` takes (`where` names the facet in its errors). */
+function requireFor(plugin, hostPackages, where) {
+    let fromPlugin;
+    let plugins;
+    return (specifier) => {
+        if (Object.hasOwn(hostPackages, specifier))
+            return interop(hostPackages[specifier]);
+        if (specifier === PLUGINS_SPECIFIER) {
+            plugins ??= { pluginFile: (path) => fileOf(plugin, path) };
+            return plugins;
+        }
+        if (isBuiltin(specifier) || plugin.external.includes(packageName(specifier))) {
+            fromPlugin ??= createRequire(join(plugin.dir, "package.json"));
+            return fromPlugin(specifier);
+        }
+        throw new Error(`${where}: "${specifier}" is not a host package, a Node builtin or one of its chord.external packages`);
+    };
+}
+/** The package a bare specifier names: `@scope/name` or `name`, without a subpath. */
+export function packageName(specifier) {
+    const parts = specifier.split("/");
+    return specifier.startsWith("@") ? parts.slice(0, 2).join("/") : parts[0];
+}
+/** The absolute path of `path` inside `plugin`'s directory; one out of it is refused. */
+function fileOf(plugin, path) {
+    const file = resolve(plugin.dir, path);
+    const rest = relative(plugin.dir, file);
+    if (rest.startsWith("..") || isAbsolute(rest)) {
+        throw new Error(`pluginFile("${path}"): outside the directory of plugin "${plugin.name}"`);
+    }
+    return file;
+}
+/** ESM namespaces wrapped for a CommonJS script, by namespace: one wrapper per namespace, held as long as it is. */
+const wrapped = new WeakMap();
+/**
+ * A host package as a CommonJS script imports it: an ESM namespace wrapped once with `__esModule` (so esbuild's interop
+ * reads its `default` for a default import, its names for named ones), any other value as it is.
+ */
+function interop(value) {
+    if (typeof value !== "object" || value === null || Object.prototype.toString.call(value) !== "[object Module]") {
+        return value;
+    }
+    let made = wrapped.get(value);
+    if (made === undefined) {
+        made = { ...value, __esModule: true };
+        wrapped.set(value, made);
+    }
+    return made;
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/next-node/plugins/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../../src/next-node/plugins/evaluate.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,sHAAsH;AACtH,sHAAsH;AACtH,wHAAwH;AACxH,QAAQ;AAER,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKjC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAc5C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAkC,KAAkB,EAAE,OAAwB;IAC1G,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,KAAK,GAAG,WAAW,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,KAAK,GAAG,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC;IAC/D,MAAM,QAAQ,GAAG,kBAAkB,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;IACnF,6DAA6D;IAC7D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,gBAAgB,EAI9D,CAAC;IACV,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,EAAa,EAAE,CAAC;IAC1C,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACJ,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACzE,6GAA6G;QAC7G,KAAK,GAAI,MAAM,CAAC,OAAiD,EAAE,OAAO,CAAC;QAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAA6B,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC/G,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mDAAmD,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,uFAAuF;QACvF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3G,MAAM,KAAK,CAAC;IACb,CAAC;IACD,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,KAAiB,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,+EAA+E,CAAC,CAAC;AACrH,CAAC;AAED,gHAAgH;AAChH,MAAM,CAAC,MAAM,iBAAiB,GAAG,oCAAoC,CAAC;AAEtE,8FAA8F;AAC9F,SAAS,UAAU,CAAC,MAAc,EAAE,YAA0B,EAAE,KAAa;IAC5E,IAAI,UAAsC,CAAC;IAC3C,IAAI,OAAsE,CAAC;IAC3E,OAAO,CAAC,SAAS,EAAE,EAAE;QACpB,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC;YAAE,OAAO,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;QACpF,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;YACrC,OAAO,KAAK,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YAC3D,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAC9E,UAAU,KAAK,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YAC/D,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,KAAK,CACd,GAAG,KAAK,MAAM,SAAS,+EAA+E,CACtG,CAAC;IACH,CAAC,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC5C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;AAC5E,CAAC;AAED,yFAAyF;AACzF,SAAS,MAAM,CAAC,MAAc,EAAE,IAAY;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,wCAAwC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,oHAAoH;AACpH,MAAM,OAAO,GAAG,IAAI,OAAO,EAAkB,CAAC;AAE9C;;;GAGG;AACH,SAAS,OAAO,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,EAAE,CAAC;QAChH,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["// Evaluating (slice 7c §3): a built script run with `vm.Script` in this context under a stable filename per (plugin,\n// kind, digest), given the `require` that answers its external imports: the host packages (one instance per process),\n// this component's `pluginFile` bound to the plugin's directory, and `chord.external` packages and Node builtins from\n// the plugin's own `node_modules`. No module map and no cache: an old facet's closures are collected once nothing holds\n// them.\n\nimport { createRequire, isBuiltin } from \"node:module\";\nimport { basename, isAbsolute, join, relative, resolve } from \"node:path\";\nimport { Script } from \"node:vm\";\nimport type { Principal } from \"../../next/data/index.ts\";\nimport type { Facet } from \"../../next/host/index.ts\";\nimport type { BuiltFacet } from \"./build.ts\";\nimport type { Plugin } from \"./discover.ts\";\nimport { registerScript } from \"./stack.ts\";\n\n/**\n * The host packages by specifier, each what Node's `require` would give: a CommonJS package's exports, an ESM\n * package's namespace (`import * as`), wrapped once so default and named imports both work.\n */\nexport type HostPackages = Readonly<Record<string, unknown>>;\n\n/** What `evaluateFacet` takes besides the script: the host packages and the plugin it was built from. */\nexport type EvaluateOptions = { readonly hostPackages: HostPackages; readonly plugin: Plugin };\n\n/** A built script, as evaluation takes it. */\nexport type BuiltScript = Extract<BuiltFacet, { readonly kind: \"script\" }>;\n\n/**\n * Evaluates `built` and returns its facet (its default export). Throws what the script throws while it is evaluated,\n * an import its `require` does not answer, or a declaration error when its default export is not a facet.\n */\nexport function evaluateFacet<P extends Principal = Principal>(built: BuiltScript, options: EvaluateOptions): Facet<P> {\n\tconst { plugin, hostPackages } = options;\n\tconst where = `plugin \"${plugin.name}\" (${built.facet})`;\n\tconst file = plugin.facets[built.facet] ?? `${built.facet}.js`;\n\tconst filename = `/chord-plugins/${plugin.name}/${basename(file)}?${built.digest}`;\n\t// The script is one function expression: its value when run.\n\tconst wrapper = new Script(built.source, { filename }).runInThisContext() as (\n\t\trequire: (specifier: string) => unknown,\n\t\tmodule: { exports: unknown },\n\t\texports: unknown,\n\t) => void;\n\tconst module = { exports: {} as unknown };\n\tlet facet: unknown;\n\ttry {\n\t\twrapper(requireFor(plugin, hostPackages, where), module, module.exports);\n\t\t// A trust boundary: plugin code; its default export is checked to be a facet (a getter of it may throw too).\n\t\tfacet = (module.exports as { readonly default?: unknown } | null)?.default;\n\t\tif (typeof facet !== \"object\" || facet === null || typeof (facet as { setup?: unknown }).setup !== \"function\") {\n\t\t\tthrow new Error(`${where}: its default export is not a facet (defineFacet)`);\n\t\t}\n\t} catch (error) {\n\t\t// Its stack maps while the error lives (an import-time throw names the plugin's line).\n\t\tif (typeof error === \"object\" && error !== null) registerScript(filename, built.source, plugin.dir, error);\n\t\tthrow error;\n\t}\n\tregisterScript(filename, built.source, plugin.dir, facet);\n\treturn facet as Facet<P>;\n}\n\n/**\n * Inside a facet script, the absolute path of `path`, a file of the facet's own plugin (`..` out of its directory\n * refused); evaluation gives each facet its own. Imported anywhere else, it throws.\n */\nexport function pluginFile(path: string): string {\n\tthrow new Error(`pluginFile(\"${path}\"): only a plugin's facet script, evaluated by the plugins component, has one`);\n}\n\n/** The one specifier of this component a script imports (`pluginFile`): external always, answered per facet. */\nexport const PLUGINS_SPECIFIER = \"@earendil-works/chord/next/plugins\";\n\n/** The `require` a facet script of `plugin` takes (`where` names the facet in its errors). */\nfunction requireFor(plugin: Plugin, hostPackages: HostPackages, where: string): (specifier: string) => unknown {\n\tlet fromPlugin: NodeJS.Require | undefined;\n\tlet plugins: { readonly pluginFile: (path: string) => string } | undefined;\n\treturn (specifier) => {\n\t\tif (Object.hasOwn(hostPackages, specifier)) return interop(hostPackages[specifier]);\n\t\tif (specifier === PLUGINS_SPECIFIER) {\n\t\t\tplugins ??= { pluginFile: (path) => fileOf(plugin, path) };\n\t\t\treturn plugins;\n\t\t}\n\t\tif (isBuiltin(specifier) || plugin.external.includes(packageName(specifier))) {\n\t\t\tfromPlugin ??= createRequire(join(plugin.dir, \"package.json\"));\n\t\t\treturn fromPlugin(specifier);\n\t\t}\n\t\tthrow new Error(\n\t\t\t`${where}: \"${specifier}\" is not a host package, a Node builtin or one of its chord.external packages`,\n\t\t);\n\t};\n}\n\n/** The package a bare specifier names: `@scope/name` or `name`, without a subpath. */\nexport function packageName(specifier: string): string {\n\tconst parts = specifier.split(\"/\");\n\treturn specifier.startsWith(\"@\") ? parts.slice(0, 2).join(\"/\") : parts[0]!;\n}\n\n/** The absolute path of `path` inside `plugin`'s directory; one out of it is refused. */\nfunction fileOf(plugin: Plugin, path: string): string {\n\tconst file = resolve(plugin.dir, path);\n\tconst rest = relative(plugin.dir, file);\n\tif (rest.startsWith(\"..\") || isAbsolute(rest)) {\n\t\tthrow new Error(`pluginFile(\"${path}\"): outside the directory of plugin \"${plugin.name}\"`);\n\t}\n\treturn file;\n}\n\n/** ESM namespaces wrapped for a CommonJS script, by namespace: one wrapper per namespace, held as long as it is. */\nconst wrapped = new WeakMap<object, object>();\n\n/**\n * A host package as a CommonJS script imports it: an ESM namespace wrapped once with `__esModule` (so esbuild's interop\n * reads its `default` for a default import, its names for named ones), any other value as it is.\n */\nfunction interop(value: unknown): unknown {\n\tif (typeof value !== \"object\" || value === null || Object.prototype.toString.call(value) !== \"[object Module]\") {\n\t\treturn value;\n\t}\n\tlet made = wrapped.get(value);\n\tif (made === undefined) {\n\t\tmade = { ...value, __esModule: true };\n\t\twrapped.set(value, made);\n\t}\n\treturn made;\n}\n"]}

package/dist/next-node/plugins/index.d.ts

@@ -0,0 +1,9 @@
+export { type BuildInput, type BuildOptions, type BuiltFacet, buildFacet } from "./build.ts";
+export { type Discovery, type DiscoveryOptions, type DiscoveryProblem, discoverPlugins, type Plugin, } from "./discover.ts";
+export { type BuiltScript, type EvaluateOptions, evaluateFacet, type HostPackages, pluginFile } from "./evaluate.ts";
+export { type InstallOptions, installDependencies } from "./install.ts";
+export { type Built, createPlugins, type KindDefinition, type Plugins, type PluginsError, type PluginsOptions, type RolloutHost, type RolloutResult, type RolloutStep, } from "./plugins.ts";
+export { createPluginRuntime, type PluginRuntime, type PluginScript, type RuntimeLoad } from "./runtime.ts";
+export { mapStack } from "./stack.ts";
+export type { PluginsState } from "./watcher.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/next-node/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next-node/plugins/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EACN,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,eAAe,EACf,KAAK,MAAM,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACrH,OAAO,EAAE,KAAK,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EACN,KAAK,KAAK,EACV,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5G,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/next-node/plugins/index.js

@@ -0,0 +1,11 @@
+// Chord v2's plugins component (`@earendil-works/chord/next/plugins` once v2 has its entry point; slice 7c): plugin
+// directories found, built into scripts, evaluated, loaded and reloaded per plugin, watched and rolled out. Node-only
+// (`fs`, esbuild, `vm`); esbuild is an optional peer dependency, imported only here.
+export { buildFacet } from "./build.js";
+export { discoverPlugins, } from "./discover.js";
+export { evaluateFacet, pluginFile } from "./evaluate.js";
+export { installDependencies } from "./install.js";
+export { createPlugins, } from "./plugins.js";
+export { createPluginRuntime } from "./runtime.js";
+export { mapStack } from "./stack.js";
+//# sourceMappingURL=index.js.map

package/dist/next-node/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/next-node/plugins/index.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,sHAAsH;AACtH,qFAAqF;AAErF,OAAO,EAAuD,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAIN,eAAe,GAEf,MAAM,eAAe,CAAC;AACvB,OAAO,EAA0C,aAAa,EAAqB,UAAU,EAAE,MAAM,eAAe,CAAC;AACrH,OAAO,EAAuB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAEN,aAAa,GAQb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAA2D,MAAM,cAAc,CAAC;AAC5G,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC","sourcesContent":["// Chord v2's plugins component (`@earendil-works/chord/next/plugins` once v2 has its entry point; slice 7c): plugin\n// directories found, built into scripts, evaluated, loaded and reloaded per plugin, watched and rolled out. Node-only\n// (`fs`, esbuild, `vm`); esbuild is an optional peer dependency, imported only here.\n\nexport { type BuildInput, type BuildOptions, type BuiltFacet, buildFacet } from \"./build.ts\";\nexport {\n\ttype Discovery,\n\ttype DiscoveryOptions,\n\ttype DiscoveryProblem,\n\tdiscoverPlugins,\n\ttype Plugin,\n} from \"./discover.ts\";\nexport { type BuiltScript, type EvaluateOptions, evaluateFacet, type HostPackages, pluginFile } from \"./evaluate.ts\";\nexport { type InstallOptions, installDependencies } from \"./install.ts\";\nexport {\n\ttype Built,\n\tcreatePlugins,\n\ttype KindDefinition,\n\ttype Plugins,\n\ttype PluginsError,\n\ttype PluginsOptions,\n\ttype RolloutHost,\n\ttype RolloutResult,\n\ttype RolloutStep,\n} from \"./plugins.ts\";\nexport { createPluginRuntime, type PluginRuntime, type PluginScript, type RuntimeLoad } from \"./runtime.ts\";\nexport { mapStack } from \"./stack.ts\";\nexport type { PluginsState } from \"./watcher.ts\";\n"]}

package/dist/next-node/plugins/install.d.ts

@@ -0,0 +1,13 @@
+import type { Context } from "../../context/index.ts";
+import type { Plugin } from "./discover.ts";
+/** What `installDependencies` takes besides the plugin: the npm command (`["npm"]` by default, e.g. `["pnpm"]`). */
+export type InstallOptions = {
+    readonly npmCommand?: readonly string[];
+};
+/**
+ * Installs `plugin`'s `dependencies` into its own `node_modules` (`npm install --omit=dev --legacy-peer-deps
+ * --ignore-scripts --no-audit --no-fund` in its real directory). Rejects with the command's output when it fails, and
+ * when `context` aborts (the command is killed).
+ */
+export declare function installDependencies(plugin: Plugin, context: Context, options?: InstallOptions): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/next-node/plugins/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/next-node/plugins/install.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,oHAAoH;AACpH,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAKzE;;;;GAIG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/next-node/plugins/install.js

@@ -0,0 +1,37 @@
+// Installing a plugin's npm dependencies (slice 7c §5, decision "Slice 7c's points" (3)): as coding-agent installs a
+// package's dependencies, `npm install` in the plugin's real directory without dev dependencies, host peers or
+// lifecycle scripts; the command overridable.
+import { spawn } from "node:child_process";
+/** The install's arguments: production dependencies only, no host peers, no scripts, no audit or funding notes. */
+const INSTALL_ARGS = ["install", "--omit=dev", "--legacy-peer-deps", "--ignore-scripts", "--no-audit", "--no-fund"];
+/**
+ * Installs `plugin`'s `dependencies` into its own `node_modules` (`npm install --omit=dev --legacy-peer-deps
+ * --ignore-scripts --no-audit --no-fund` in its real directory). Rejects with the command's output when it fails, and
+ * when `context` aborts (the command is killed).
+ */
+export async function installDependencies(plugin, context, options = {}) {
+    const [command, ...prefix] = options.npmCommand ?? ["npm"];
+    if (command === undefined)
+        throw new Error("installDependencies: npmCommand is empty");
+    context.abortSignal?.throwIfAborted();
+    const child = spawn(command, [...prefix, ...INSTALL_ARGS], {
+        cwd: plugin.dir,
+        stdio: ["ignore", "pipe", "pipe"],
+        signal: context.abortSignal,
+    });
+    let output = "";
+    child.stdout.on("data", (chunk) => {
+        output += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+        output += chunk.toString();
+    });
+    const code = await new Promise((resolve, reject) => {
+        child.on("error", reject);
+        child.on("close", resolve);
+    });
+    if (code !== 0) {
+        throw new Error(`plugin "${plugin.name}": ${command} install failed (exit ${code}): ${output.trim()}`);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/next-node/plugins/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/next-node/plugins/install.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,+GAA+G;AAC/G,8CAA8C;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAO3C,mHAAmH;AACnH,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAEpH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAc,EACd,OAAgB,EAChB,OAAO,GAAmB,EAAE;IAE5B,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACvF,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,YAAY,CAAC,EAAE;QAC1D,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,MAAM,EAAE,OAAO,CAAC,WAAW;KAC3B,CAAC,CAAC;IACH,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,MAAM,OAAO,yBAAyB,IAAI,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxG,CAAC;AACF,CAAC","sourcesContent":["// Installing a plugin's npm dependencies (slice 7c §5, decision \"Slice 7c's points\" (3)): as coding-agent installs a\n// package's dependencies, `npm install` in the plugin's real directory without dev dependencies, host peers or\n// lifecycle scripts; the command overridable.\n\nimport { spawn } from \"node:child_process\";\nimport type { Context } from \"../../context/index.ts\";\nimport type { Plugin } from \"./discover.ts\";\n\n/** What `installDependencies` takes besides the plugin: the npm command (`[\"npm\"]` by default, e.g. `[\"pnpm\"]`). */\nexport type InstallOptions = { readonly npmCommand?: readonly string[] };\n\n/** The install's arguments: production dependencies only, no host peers, no scripts, no audit or funding notes. */\nconst INSTALL_ARGS = [\"install\", \"--omit=dev\", \"--legacy-peer-deps\", \"--ignore-scripts\", \"--no-audit\", \"--no-fund\"];\n\n/**\n * Installs `plugin`'s `dependencies` into its own `node_modules` (`npm install --omit=dev --legacy-peer-deps\n * --ignore-scripts --no-audit --no-fund` in its real directory). Rejects with the command's output when it fails, and\n * when `context` aborts (the command is killed).\n */\nexport async function installDependencies(\n\tplugin: Plugin,\n\tcontext: Context,\n\toptions: InstallOptions = {},\n): Promise<void> {\n\tconst [command, ...prefix] = options.npmCommand ?? [\"npm\"];\n\tif (command === undefined) throw new Error(\"installDependencies: npmCommand is empty\");\n\tcontext.abortSignal?.throwIfAborted();\n\tconst child = spawn(command, [...prefix, ...INSTALL_ARGS], {\n\t\tcwd: plugin.dir,\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\tsignal: context.abortSignal,\n\t});\n\tlet output = \"\";\n\tchild.stdout.on(\"data\", (chunk: Buffer) => {\n\t\toutput += chunk.toString();\n\t});\n\tchild.stderr.on(\"data\", (chunk: Buffer) => {\n\t\toutput += chunk.toString();\n\t});\n\tconst code = await new Promise<number | null>((resolve, reject) => {\n\t\tchild.on(\"error\", reject);\n\t\tchild.on(\"close\", resolve);\n\t});\n\tif (code !== 0) {\n\t\tthrow new Error(`plugin \"${plugin.name}\": ${command} install failed (exit ${code}): ${output.trim()}`);\n\t}\n}\n"]}

package/dist/next-node/plugins/plugins.d.ts

@@ -0,0 +1,135 @@
+import type { Context } from "../../context/index.ts";
+import type { Principal } from "../../next/data/index.ts";
+import type { Host, LoadReport, PluginFacet, ReloadReport } from "../../next/host/index.ts";
+import { type BatchError } from "../../next/state/internal.ts";
+import type { Watchable } from "../../watch.ts";
+import { type BuiltFacet } from "./build.ts";
+import { type Discovery, type Plugin } from "./discover.ts";
+import type { HostPackages } from "./evaluate.ts";
+import { type InstallOptions } from "./install.ts";
+import { type PluginScript } from "./runtime.ts";
+import { type PluginsState } from "./watcher.ts";
+/** What `createPlugins` takes. */
+export type PluginsOptions = {
+    /** The directories plugins are listed in, in order: the first root's plugin wins a duplicate name. */
+    readonly roots: readonly string[];
+    /**
+     * The app's facet kinds (one file per kind in a plugin), each with where its builds run and the host packages they
+     * keep external: `{ server: { platform: "node", hostPackages: ["@earendil-works/chord/next", "@app/core"] }, … }`.
+     */
+    readonly kinds: Readonly<Record<string, KindDefinition>>;
+    /** The app's base code: a change sets `base` (the app restarts its hosts; Chord restarts nothing). */
+    readonly base?: readonly string[];
+    /** Where the app serves browser builds' assets: the URL prefix their imports evaluate to. */
+    readonly publicPath?: string;
+    /** How `installDependencies` runs npm. */
+    readonly install?: InstallOptions;
+    /** The watcher cannot watch (reported once), and the marks' watch listeners that threw. */
+    readonly onError: (error: PluginsError) => void;
+};
+/** One facet kind: Node or browser builds, and the host packages (by specifier) its builds keep external. */
+export type KindDefinition = {
+    readonly platform: "node" | "browser";
+    readonly hostPackages: readonly string[];
+};
+/** What the component reports. */
+export type PluginsError = BatchError | {
+    readonly kind: "watch_failed";
+    readonly error: unknown;
+};
+/**
+ * A build of some plugins, plain data (a clone of it reloads the same): every facet of each, the plugins as its
+ * discovery saw them by name (what a reload evaluates with), and the plugins no longer discovered.
+ */
+export type Built = {
+    readonly facets: readonly BuiltFacet[];
+    readonly plugins: Readonly<Record<string, Plugin>>;
+    readonly removed: readonly string[];
+};
+/**
+ * What a rollout step did on one of its hosts (`host` named by the step): its reload's report; `stopped` when the host
+ * stopped cleanly during the step (it gets the current set at its next start); `error` when it crashed or its reload
+ * failed (every plugin of the step's kinds in the build counts as failed there).
+ */
+export type RolloutHost = {
+    readonly host: string;
+    readonly report: ReloadReport;
+} | {
+    readonly host: string;
+    readonly stopped: true;
+} | {
+    readonly host: string;
+    readonly error: unknown;
+};
+/** What a rollout step does: reloads its hosts with the facets of its kinds, one result per host (D12). */
+export type RolloutStep = {
+    readonly name: string;
+    readonly kinds: readonly string[];
+    reload(built: Built, context: Context): Promise<{
+        readonly hosts: readonly RolloutHost[];
+    }>;
+};
+/** What a rollout did: each step's hosts in order, and the step it stopped at (rejected), if it stopped. */
+export type RolloutResult = {
+    readonly steps: readonly {
+        readonly name: string;
+        readonly hosts: readonly RolloutHost[];
+    }[];
+    readonly stopped: {
+        readonly step: string;
+        readonly error: unknown;
+    } | undefined;
+};
+/** The plugins component. */
+export interface Plugins {
+    /** The marks: `{ dirty, install, set, base }`, a JSON watchable. */
+    readonly state: Watchable<PluginsState>;
+    /** The plugins of the last discovery. */
+    readonly discovery: Discovery;
+    /**
+     * Builds every facet of `names` (and of plugins discovered since the last build; discovery runs again first when
+     * the plugin set changed): plain data. It changes no current set: a rollout ships it.
+     */
+    build(names: readonly string[], context: Context): Promise<Built>;
+    /**
+     * The complete current set of `kind`: every discovered plugin's facet of it (built on first use), as the last
+     * rollout or reload shipping `kind` left it; what a worker starts with.
+     */
+    scripts(kind: string, context: Context): Promise<readonly PluginScript[]>;
+    /**
+     * `kind`'s current set now, synchronously (`undefined` before its first use): a rollout step reads it as the rollout
+     * applied its build, before another rollout can change it.
+     */
+    current(kind: string): readonly PluginScript[] | undefined;
+    /**
+     * Loads `host` with `kind`'s current set, evaluated with `modules` (the host packages, this process's instances, by
+     * specifier; kept for the host's reloads), and `core` (the app's own facets): a plugin whose build or evaluation
+     * fails is left out and reported with the host's report.
+     */
+    load<P extends Principal>(host: Host<P>, options: {
+        readonly kind: string;
+        readonly core: readonly PluginFacet<P>[];
+        readonly modules: HostPackages;
+    }, context: Context): Promise<LoadReport>;
+    /**
+     * Applies `built` to the current set of `host`'s kind (loaded by `load`) and reloads `host` with that complete set,
+     * after its earlier reloads (`PluginRuntime.reload`). The host's report.
+     */
+    reload<P extends Principal>(host: Host<P>, built: Built, context: Context): Promise<ReloadReport>;
+    /** An in-process rollout step named `name`: `reload(host, built)`, one host named `name`. */
+    step<P extends Principal>(name: string, host: Host<P>): RolloutStep;
+    /**
+     * Runs `steps` in order with `built`, applying it to the current set of each step's kinds right before that step,
+     * and stops at one that rejects; failed plugins and hosts do not stop it. Clears the dirty marks of the built
+     * plugins applied on every host of every step (not failed on any, every built kind of theirs shipped by a step)
+     * that did not change since the build.
+     */
+    rollout(steps: readonly RolloutStep[], built: Built, context: Context): Promise<RolloutResult>;
+    /** Installs plugin `name`'s dependencies (`installDependencies`): its install mark clears, and it is dirty. */
+    installDependencies(name: string, context: Context): Promise<void>;
+    /** Stops the watcher. */
+    close(): void;
+}
+/** Creates the plugins component (and its plugin runtime) and starts the watcher. Discovery runs at first use. */
+export declare function createPlugins(options: PluginsOptions, _context: Context): Plugins;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/next-node/plugins/plugins.d.ts.map

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

package/dist/next-node/plugins/plugins.js

@@ -0,0 +1,206 @@
+// The plugins component (slice 7c §4, §5; decision "Slice 7c's points"; slice 10 D11, D12): discovery, builds and the
+// watcher, and per kind the complete current set of scripts (built on first use, updated by every rollout that ships
+// the kind), which its plugin runtime loads and reloads hosts with: unchanged plugins as the same facet objects, removed
+// ones left out, a failed build or evaluation keeping the plugin's loaded facet. `rollout` runs the app's steps in order
+// (one result per host) and clears the marks of plugins applied on every host of every step.
+import { Batch } from "../../next/state/internal.js";
+import { buildFacet } from "./build.js";
+import { discoverPlugins } from "./discover.js";
+import { installDependencies } from "./install.js";
+import { createPluginRuntime } from "./runtime.js";
+import { PluginWatcher } from "./watcher.js";
+/** Creates the plugins component (and its plugin runtime) and starts the watcher. Discovery runs at first use. */
+export function createPlugins(options, _context) {
+    return new PluginsComponent(options);
+}
+class PluginsComponent {
+    #options;
+    #watcher;
+    #runtime;
+    #discovery = { plugins: [], problems: [] };
+    #discovered = false;
+    /** The latest build of every (plugin, kind) built so far, by `plugin\u0000kind`. */
+    #built = new Map();
+    /** The current set of each kind used so far, by plugin name. */
+    #current = new Map();
+    /** The kind each loaded host was loaded with, held as long as the host is. */
+    #kinds = new WeakMap();
+    /** The marks each build started from, held as long as its result is (a rollout given a copy clears none). */
+    #snapshots = new WeakMap();
+    constructor(options) {
+        this.#options = options;
+        this.#runtime = createPluginRuntime();
+        const batch = new Batch((error) => options.onError(error), undefined);
+        this.#watcher = new PluginWatcher({
+            roots: options.roots,
+            base: options.base ?? [],
+            kinds: Object.keys(options.kinds),
+            failed: (error) => options.onError({ kind: "watch_failed", error }),
+        }, batch);
+    }
+    get state() {
+        // Its value is a `PluginsState`.
+        return this.#watcher;
+    }
+    get discovery() {
+        return this.#discovery;
+    }
+    async build(names, context) {
+        const before = new Set(this.#discovery.plugins.map(({ name }) => name));
+        if (!this.#discovered || this.#watcher.needsDiscovery)
+            await this.#discover(context);
+        const now = this.#discovery.plugins;
+        const removed = [...before].filter((name) => !now.some((plugin) => plugin.name === name));
+        const wanted = now.filter(({ name }) => names.includes(name) || !before.has(name));
+        const snapshot = this.#watcher.snapshot([...wanted.map(({ name }) => name), ...removed]);
+        const facets = await Promise.all(wanted.flatMap((plugin) => Object.keys(plugin.facets).map((kind) => this.#buildOne(plugin, kind, context))));
+        const plugins = Object.fromEntries(wanted.map((plugin) => [plugin.name, plugin]));
+        const built = { facets, plugins, removed };
+        this.#snapshots.set(built, snapshot);
+        return built;
+    }
+    async scripts(kind, context) {
+        return [...(await this.#set(kind, context)).values()];
+    }
+    current(kind) {
+        const set = this.#current.get(kind);
+        return set === undefined ? undefined : [...set.values()];
+    }
+    async load(host, options, context) {
+        const { kind, core, modules } = options;
+        const scripts = await this.scripts(kind, context);
+        this.#kinds.set(host, kind);
+        return this.#runtime.load(host, { kind, core, scripts, modules }, context);
+    }
+    async reload(host, built, context) {
+        const kind = this.#kinds.get(host);
+        if (kind === undefined)
+            throw new Error("plugins.reload: the host was not loaded by this component");
+        const set = await this.#set(kind, context);
+        // Applied and read in one step: two reloads started together each pass the set their own build made.
+        ship(set, kind, built);
+        return this.#runtime.reload(host, [...set.values()], context);
+    }
+    step(name, host) {
+        const kind = this.#kinds.get(host);
+        if (kind === undefined)
+            throw new Error("plugins.step: the host was not loaded by this component");
+        return {
+            name,
+            kinds: [kind],
+            reload: async (built, context) => ({
+                hosts: [{ host: name, report: await this.reload(host, built, context) }],
+            }),
+        };
+    }
+    async rollout(steps, built, context) {
+        const done = [];
+        const failed = new Set();
+        const shipped = new Set();
+        for (const step of steps) {
+            let hosts;
+            try {
+                for (const kind of step.kinds)
+                    ship(await this.#set(kind, context), kind, built);
+                hosts = (await step.reload(built, context)).hosts;
+            }
+            catch (error) {
+                return { steps: done, stopped: { step: step.name, error } };
+            }
+            for (const kind of step.kinds)
+                shipped.add(kind);
+            for (const entry of hosts) {
+                if ("report" in entry)
+                    for (const { plugin } of entry.report.failed)
+                        failed.add(plugin);
+                else if ("error" in entry)
+                    for (const plugin of builtOf(built, step.kinds))
+                        failed.add(plugin);
+            }
+            done.push({ name: step.name, hosts });
+        }
+        // A plugin with a built kind no step shipped is not applied everywhere it runs: it stays dirty.
+        for (const { plugin, facet } of built.facets)
+            if (!shipped.has(facet))
+                failed.add(plugin);
+        const snapshot = this.#snapshots.get(built);
+        if (snapshot !== undefined) {
+            this.#watcher.applied([...snapshot.plugins.keys()].filter((name) => !failed.has(name)), snapshot);
+        }
+        return { steps: done, stopped: undefined };
+    }
+    async installDependencies(name, context) {
+        if (!this.#discovered)
+            await this.#discover(context);
+        const plugin = this.#discovery.plugins.find((each) => each.name === name);
+        if (plugin === undefined)
+            throw new Error(`plugins.installDependencies: no plugin "${name}"`);
+        await installDependencies(plugin, context, this.#options.install);
+        this.#watcher.installed(name);
+    }
+    close() {
+        this.#watcher.close();
+    }
+    /** Discovers the plugins again; the changes of the plugin set and of `package.json`s seen until now clear. */
+    async #discover(context) {
+        const seen = this.#watcher.discoverySnapshot();
+        this.#discovery = await discoverPlugins(this.#options.roots, { kinds: Object.keys(this.#options.kinds) }, context);
+        this.#discovered = true;
+        this.#watcher.know(this.#discovery, seen);
+    }
+    /** `kind`'s current set, made at its first use from every discovered plugin's facet of it (built if needed). */
+    async #set(kind, context) {
+        let set = this.#current.get(kind);
+        if (set !== undefined)
+            return set;
+        if (!this.#discovered)
+            await this.#discover(context);
+        const plugins = this.#discovery.plugins.filter((plugin) => plugin.facets[kind] !== undefined);
+        const scripts = await Promise.all(plugins.map(async (plugin) => {
+            const built = this.#built.get(`${plugin.name}\u0000${kind}`) ?? (await this.#buildOne(plugin, kind, context));
+            return { plugin, built };
+        }));
+        // Built concurrently: a set made meanwhile (by a concurrent first use) wins.
+        set = this.#current.get(kind) ?? new Map(scripts.map((script) => [script.plugin.name, script]));
+        this.#current.set(kind, set);
+        return set;
+    }
+    /** Builds `plugin`'s facet of `kind` and keeps it as the latest; the watcher learns what it read. */
+    async #buildOne(plugin, kind, context) {
+        const { kinds, publicPath } = this.#options;
+        // Discovery finds facet files of the app's kinds only.
+        const { platform, hostPackages } = kinds[kind];
+        const options = {
+            hostPackages,
+            platform,
+            plugins: this.#discovery.plugins,
+            ...(publicPath === undefined ? {} : { publicPath }),
+        };
+        const built = await buildFacet(plugin, kind, options, context);
+        this.#built.set(`${plugin.name}\u0000${kind}`, built);
+        this.#watcher.used([built]);
+        return built;
+    }
+}
+/**
+ * Applies `built` to `set`, `kind`'s current set: its removed plugins and those rebuilt without a facet of `kind` leave
+ * it, its facets of `kind` replace theirs.
+ */
+function ship(set, kind, built) {
+    for (const name of built.removed)
+        set.delete(name);
+    for (const [name, plugin] of Object.entries(built.plugins))
+        if (plugin.facets[kind] === undefined)
+            set.delete(name);
+    for (const facet of built.facets) {
+        // Own properties only: a plugin may be named like one of `Object.prototype`'s (`constructor`).
+        if (facet.facet === kind && Object.hasOwn(built.plugins, facet.plugin)) {
+            set.set(facet.plugin, { plugin: built.plugins[facet.plugin], built: facet });
+        }
+    }
+}
+/** The plugins of `built` with a facet of one of `kinds`. */
+function builtOf(built, kinds) {
+    return built.facets.filter(({ facet }) => kinds.includes(facet)).map(({ plugin }) => plugin);
+}
+//# sourceMappingURL=plugins.js.map