@earendil-works/chord 1.4.0 → 1.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../../src/next-node/plugins/plugins.ts"],"names":[],"mappings":"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","sourcesContent":["// The plugins component (slice 7c §4, §5; decision \"Slice 7c's points\"; slice 10 D11, D12): discovery, builds and the\n// watcher, and per kind the complete current set of scripts (built on first use, updated by every rollout that ships\n// the kind), which its plugin runtime loads and reloads hosts with: unchanged plugins as the same facet objects, removed\n// ones left out, a failed build or evaluation keeping the plugin's loaded facet. `rollout` runs the app's steps in order\n// (one result per host) and clears the marks of plugins applied on every host of every step.\n\nimport type { Context } from \"../../context/index.ts\";\nimport type { Principal } from \"../../next/data/index.ts\";\nimport type { Host, LoadReport, PluginFacet, ReloadReport } from \"../../next/host/index.ts\";\nimport { Batch, type BatchError } from \"../../next/state/internal.ts\";\nimport type { Watchable } from \"../../watch.ts\";\nimport { type BuiltFacet, buildFacet } from \"./build.ts\";\nimport { type Discovery, discoverPlugins, type Plugin } from \"./discover.ts\";\nimport type { HostPackages } from \"./evaluate.ts\";\nimport { type InstallOptions, installDependencies } from \"./install.ts\";\nimport { createPluginRuntime, type PluginRuntime, type PluginScript } from \"./runtime.ts\";\nimport { type MarkSnapshot, type PluginsState, PluginWatcher } from \"./watcher.ts\";\n\n/** What `createPlugins` takes. */\nexport type PluginsOptions = {\n\t/** The directories plugins are listed in, in order: the first root's plugin wins a duplicate name. */\n\treadonly roots: readonly string[];\n\t/**\n\t * The app's facet kinds (one file per kind in a plugin), each with where its builds run and the host packages they\n\t * keep external: `{ server: { platform: \"node\", hostPackages: [\"@earendil-works/chord/next\", \"@app/core\"] }, … }`.\n\t */\n\treadonly kinds: Readonly<Record<string, KindDefinition>>;\n\t/** The app's base code: a change sets `base` (the app restarts its hosts; Chord restarts nothing). */\n\treadonly base?: readonly string[];\n\t/** Where the app serves browser builds' assets: the URL prefix their imports evaluate to. */\n\treadonly publicPath?: string;\n\t/** How `installDependencies` runs npm. */\n\treadonly install?: InstallOptions;\n\t/** The watcher cannot watch (reported once), and the marks' watch listeners that threw. */\n\treadonly onError: (error: PluginsError) => void;\n};\n\n/** One facet kind: Node or browser builds, and the host packages (by specifier) its builds keep external. */\nexport type KindDefinition = { readonly platform: \"node\" | \"browser\"; readonly hostPackages: readonly string[] };\n\n/** What the component reports. */\nexport type PluginsError = BatchError | { readonly kind: \"watch_failed\"; readonly error: unknown };\n\n/**\n * A build of some plugins, plain data (a clone of it reloads the same): every facet of each, the plugins as its\n * discovery saw them by name (what a reload evaluates with), and the plugins no longer discovered.\n */\nexport type Built = {\n\treadonly facets: readonly BuiltFacet[];\n\treadonly plugins: Readonly<Record<string, Plugin>>;\n\treadonly removed: readonly string[];\n};\n\n/**\n * What a rollout step did on one of its hosts (`host` named by the step): its reload's report; `stopped` when the host\n * stopped cleanly during the step (it gets the current set at its next start); `error` when it crashed or its reload\n * failed (every plugin of the step's kinds in the build counts as failed there).\n */\nexport type RolloutHost =\n\t| { readonly host: string; readonly report: ReloadReport }\n\t| { readonly host: string; readonly stopped: true }\n\t| { readonly host: string; readonly error: unknown };\n\n/** What a rollout step does: reloads its hosts with the facets of its kinds, one result per host (D12). */\nexport type RolloutStep = {\n\treadonly name: string;\n\treadonly kinds: readonly string[];\n\treload(built: Built, context: Context): Promise<{ readonly hosts: readonly RolloutHost[] }>;\n};\n\n/** What a rollout did: each step's hosts in order, and the step it stopped at (rejected), if it stopped. */\nexport type RolloutResult = {\n\treadonly steps: readonly { readonly name: string; readonly hosts: readonly RolloutHost[] }[];\n\treadonly stopped: { readonly step: string; readonly error: unknown } | undefined;\n};\n\n/** The plugins component. */\nexport interface Plugins {\n\t/** The marks: `{ dirty, install, set, base }`, a JSON watchable. */\n\treadonly state: Watchable<PluginsState>;\n\t/** The plugins of the last discovery. */\n\treadonly discovery: Discovery;\n\t/**\n\t * Builds every facet of `names` (and of plugins discovered since the last build; discovery runs again first when\n\t * the plugin set changed): plain data. It changes no current set: a rollout ships it.\n\t */\n\tbuild(names: readonly string[], context: Context): Promise<Built>;\n\t/**\n\t * The complete current set of `kind`: every discovered plugin's facet of it (built on first use), as the last\n\t * rollout or reload shipping `kind` left it; what a worker starts with.\n\t */\n\tscripts(kind: string, context: Context): Promise<readonly PluginScript[]>;\n\t/**\n\t * `kind`'s current set now, synchronously (`undefined` before its first use): a rollout step reads it as the rollout\n\t * applied its build, before another rollout can change it.\n\t */\n\tcurrent(kind: string): readonly PluginScript[] | undefined;\n\t/**\n\t * Loads `host` with `kind`'s current set, evaluated with `modules` (the host packages, this process's instances, by\n\t * specifier; kept for the host's reloads), and `core` (the app's own facets): a plugin whose build or evaluation\n\t * fails is left out and reported with the host's report.\n\t */\n\tload<P extends Principal>(\n\t\thost: Host<P>,\n\t\toptions: { readonly kind: string; readonly core: readonly PluginFacet<P>[]; readonly modules: HostPackages },\n\t\tcontext: Context,\n\t): Promise<LoadReport>;\n\t/**\n\t * Applies `built` to the current set of `host`'s kind (loaded by `load`) and reloads `host` with that complete set,\n\t * after its earlier reloads (`PluginRuntime.reload`). The host's report.\n\t */\n\treload<P extends Principal>(host: Host<P>, built: Built, context: Context): Promise<ReloadReport>;\n\t/** An in-process rollout step named `name`: `reload(host, built)`, one host named `name`. */\n\tstep<P extends Principal>(name: string, host: Host<P>): RolloutStep;\n\t/**\n\t * Runs `steps` in order with `built`, applying it to the current set of each step's kinds right before that step,\n\t * and stops at one that rejects; failed plugins and hosts do not stop it. Clears the dirty marks of the built\n\t * plugins applied on every host of every step (not failed on any, every built kind of theirs shipped by a step)\n\t * that did not change since the build.\n\t */\n\trollout(steps: readonly RolloutStep[], built: Built, context: Context): Promise<RolloutResult>;\n\t/** Installs plugin `name`'s dependencies (`installDependencies`): its install mark clears, and it is dirty. */\n\tinstallDependencies(name: string, context: Context): Promise<void>;\n\t/** Stops the watcher. */\n\tclose(): void;\n}\n\n/** Creates the plugins component (and its plugin runtime) and starts the watcher. Discovery runs at first use. */\nexport function createPlugins(options: PluginsOptions, _context: Context): Plugins {\n\treturn new PluginsComponent(options);\n}\n\nclass PluginsComponent implements Plugins {\n\treadonly #options: PluginsOptions;\n\treadonly #watcher: PluginWatcher;\n\treadonly #runtime: PluginRuntime;\n\t#discovery: Discovery = { plugins: [], problems: [] };\n\t#discovered = false;\n\t/** The latest build of every (plugin, kind) built so far, by `plugin\\u0000kind`. */\n\treadonly #built = new Map<string, BuiltFacet>();\n\t/** The current set of each kind used so far, by plugin name. */\n\treadonly #current = new Map<string, Map<string, PluginScript>>();\n\t/** The kind each loaded host was loaded with, held as long as the host is. */\n\treadonly #kinds = new WeakMap<object, string>();\n\t/** The marks each build started from, held as long as its result is (a rollout given a copy clears none). */\n\treadonly #snapshots = new WeakMap<Built, MarkSnapshot>();\n\n\tconstructor(options: PluginsOptions) {\n\t\tthis.#options = options;\n\t\tthis.#runtime = createPluginRuntime();\n\t\tconst batch = new Batch((error) => options.onError(error), undefined);\n\t\tthis.#watcher = new PluginWatcher(\n\t\t\t{\n\t\t\t\troots: options.roots,\n\t\t\t\tbase: options.base ?? [],\n\t\t\t\tkinds: Object.keys(options.kinds),\n\t\t\t\tfailed: (error) => options.onError({ kind: \"watch_failed\", error }),\n\t\t\t},\n\t\t\tbatch,\n\t\t);\n\t}\n\n\tget state(): Watchable<PluginsState> {\n\t\t// Its value is a `PluginsState`.\n\t\treturn this.#watcher as unknown as Watchable<PluginsState>;\n\t}\n\n\tget discovery(): Discovery {\n\t\treturn this.#discovery;\n\t}\n\n\tasync build(names: readonly string[], context: Context): Promise<Built> {\n\t\tconst before = new Set(this.#discovery.plugins.map(({ name }) => name));\n\t\tif (!this.#discovered || this.#watcher.needsDiscovery) await this.#discover(context);\n\t\tconst now = this.#discovery.plugins;\n\t\tconst removed = [...before].filter((name) => !now.some((plugin) => plugin.name === name));\n\t\tconst wanted = now.filter(({ name }) => names.includes(name) || !before.has(name));\n\t\tconst snapshot = this.#watcher.snapshot([...wanted.map(({ name }) => name), ...removed]);\n\t\tconst facets = await Promise.all(\n\t\t\twanted.flatMap((plugin) => Object.keys(plugin.facets).map((kind) => this.#buildOne(plugin, kind, context))),\n\t\t);\n\t\tconst plugins = Object.fromEntries(wanted.map((plugin) => [plugin.name, plugin]));\n\t\tconst built: Built = { facets, plugins, removed };\n\t\tthis.#snapshots.set(built, snapshot);\n\t\treturn built;\n\t}\n\n\tasync scripts(kind: string, context: Context): Promise<readonly PluginScript[]> {\n\t\treturn [...(await this.#set(kind, context)).values()];\n\t}\n\n\tcurrent(kind: string): readonly PluginScript[] | undefined {\n\t\tconst set = this.#current.get(kind);\n\t\treturn set === undefined ? undefined : [...set.values()];\n\t}\n\n\tasync load<P extends Principal>(\n\t\thost: Host<P>,\n\t\toptions: { readonly kind: string; readonly core: readonly PluginFacet<P>[]; readonly modules: HostPackages },\n\t\tcontext: Context,\n\t): Promise<LoadReport> {\n\t\tconst { kind, core, modules } = options;\n\t\tconst scripts = await this.scripts(kind, context);\n\t\tthis.#kinds.set(host, kind);\n\t\treturn this.#runtime.load(host, { kind, core, scripts, modules }, context);\n\t}\n\n\tasync reload<P extends Principal>(host: Host<P>, built: Built, context: Context): Promise<ReloadReport> {\n\t\tconst kind = this.#kinds.get(host);\n\t\tif (kind === undefined) throw new Error(\"plugins.reload: the host was not loaded by this component\");\n\t\tconst set = await this.#set(kind, context);\n\t\t// Applied and read in one step: two reloads started together each pass the set their own build made.\n\t\tship(set, kind, built);\n\t\treturn this.#runtime.reload(host, [...set.values()], context);\n\t}\n\n\tstep<P extends Principal>(name: string, host: Host<P>): RolloutStep {\n\t\tconst kind = this.#kinds.get(host);\n\t\tif (kind === undefined) throw new Error(\"plugins.step: the host was not loaded by this component\");\n\t\treturn {\n\t\t\tname,\n\t\t\tkinds: [kind],\n\t\t\treload: async (built, context) => ({\n\t\t\t\thosts: [{ host: name, report: await this.reload(host, built, context) }],\n\t\t\t}),\n\t\t};\n\t}\n\n\tasync rollout(steps: readonly RolloutStep[], built: Built, context: Context): Promise<RolloutResult> {\n\t\tconst done: { readonly name: string; readonly hosts: readonly RolloutHost[] }[] = [];\n\t\tconst failed = new Set<string>();\n\t\tconst shipped = new Set<string>();\n\t\tfor (const step of steps) {\n\t\t\tlet hosts: readonly RolloutHost[];\n\t\t\ttry {\n\t\t\t\tfor (const kind of step.kinds) ship(await this.#set(kind, context), kind, built);\n\t\t\t\thosts = (await step.reload(built, context)).hosts;\n\t\t\t} catch (error) {\n\t\t\t\treturn { steps: done, stopped: { step: step.name, error } };\n\t\t\t}\n\t\t\tfor (const kind of step.kinds) shipped.add(kind);\n\t\t\tfor (const entry of hosts) {\n\t\t\t\tif (\"report\" in entry) for (const { plugin } of entry.report.failed) failed.add(plugin);\n\t\t\t\telse if (\"error\" in entry) for (const plugin of builtOf(built, step.kinds)) failed.add(plugin);\n\t\t\t}\n\t\t\tdone.push({ name: step.name, hosts });\n\t\t}\n\t\t// A plugin with a built kind no step shipped is not applied everywhere it runs: it stays dirty.\n\t\tfor (const { plugin, facet } of built.facets) if (!shipped.has(facet)) failed.add(plugin);\n\t\tconst snapshot = this.#snapshots.get(built);\n\t\tif (snapshot !== undefined) {\n\t\t\tthis.#watcher.applied(\n\t\t\t\t[...snapshot.plugins.keys()].filter((name) => !failed.has(name)),\n\t\t\t\tsnapshot,\n\t\t\t);\n\t\t}\n\t\treturn { steps: done, stopped: undefined };\n\t}\n\n\tasync installDependencies(name: string, context: Context): Promise<void> {\n\t\tif (!this.#discovered) await this.#discover(context);\n\t\tconst plugin = this.#discovery.plugins.find((each) => each.name === name);\n\t\tif (plugin === undefined) throw new Error(`plugins.installDependencies: no plugin \"${name}\"`);\n\t\tawait installDependencies(plugin, context, this.#options.install);\n\t\tthis.#watcher.installed(name);\n\t}\n\n\tclose(): void {\n\t\tthis.#watcher.close();\n\t}\n\n\t/** Discovers the plugins again; the changes of the plugin set and of `package.json`s seen until now clear. */\n\tasync #discover(context: Context): Promise<void> {\n\t\tconst seen = this.#watcher.discoverySnapshot();\n\t\tthis.#discovery = await discoverPlugins(\n\t\t\tthis.#options.roots,\n\t\t\t{ kinds: Object.keys(this.#options.kinds) },\n\t\t\tcontext,\n\t\t);\n\t\tthis.#discovered = true;\n\t\tthis.#watcher.know(this.#discovery, seen);\n\t}\n\n\t/** `kind`'s current set, made at its first use from every discovered plugin's facet of it (built if needed). */\n\tasync #set(kind: string, context: Context): Promise<Map<string, PluginScript>> {\n\t\tlet set = this.#current.get(kind);\n\t\tif (set !== undefined) return set;\n\t\tif (!this.#discovered) await this.#discover(context);\n\t\tconst plugins = this.#discovery.plugins.filter((plugin) => plugin.facets[kind] !== undefined);\n\t\tconst scripts = await Promise.all(\n\t\t\tplugins.map(async (plugin): Promise<PluginScript> => {\n\t\t\t\tconst built =\n\t\t\t\t\tthis.#built.get(`${plugin.name}\\u0000${kind}`) ?? (await this.#buildOne(plugin, kind, context));\n\t\t\t\treturn { plugin, built };\n\t\t\t}),\n\t\t);\n\t\t// Built concurrently: a set made meanwhile (by a concurrent first use) wins.\n\t\tset = this.#current.get(kind) ?? new Map(scripts.map((script) => [script.plugin.name, script]));\n\t\tthis.#current.set(kind, set);\n\t\treturn set;\n\t}\n\n\t/** Builds `plugin`'s facet of `kind` and keeps it as the latest; the watcher learns what it read. */\n\tasync #buildOne(plugin: Plugin, kind: string, context: Context): Promise<BuiltFacet> {\n\t\tconst { kinds, publicPath } = this.#options;\n\t\t// Discovery finds facet files of the app's kinds only.\n\t\tconst { platform, hostPackages } = kinds[kind]!;\n\t\tconst options = {\n\t\t\thostPackages,\n\t\t\tplatform,\n\t\t\tplugins: this.#discovery.plugins,\n\t\t\t...(publicPath === undefined ? {} : { publicPath }),\n\t\t} as const;\n\t\tconst built = await buildFacet(plugin, kind, options, context);\n\t\tthis.#built.set(`${plugin.name}\\u0000${kind}`, built);\n\t\tthis.#watcher.used([built]);\n\t\treturn built;\n\t}\n}\n\n/**\n * Applies `built` to `set`, `kind`'s current set: its removed plugins and those rebuilt without a facet of `kind` leave\n * it, its facets of `kind` replace theirs.\n */\nfunction ship(set: Map<string, PluginScript>, kind: string, built: Built): void {\n\tfor (const name of built.removed) set.delete(name);\n\tfor (const [name, plugin] of Object.entries(built.plugins)) if (plugin.facets[kind] === undefined) set.delete(name);\n\tfor (const facet of built.facets) {\n\t\t// Own properties only: a plugin may be named like one of `Object.prototype`'s (`constructor`).\n\t\tif (facet.facet === kind && Object.hasOwn(built.plugins, facet.plugin)) {\n\t\t\tset.set(facet.plugin, { plugin: built.plugins[facet.plugin]!, built: facet });\n\t\t}\n\t}\n}\n\n/** The plugins of `built` with a facet of one of `kinds`. */\nfunction builtOf(built: Built, kinds: readonly string[]): string[] {\n\treturn built.facets.filter(({ facet }) => kinds.includes(facet)).map(({ plugin }) => plugin);\n}\n"]}

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

@@ -0,0 +1,41 @@
+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 { BuiltFacet } from "./build.ts";
+import type { Plugin } from "./discover.ts";
+import { type HostPackages } from "./evaluate.ts";
+/** One plugin's facet of a kind as shipped to a host (plain data): its build and its plugin record. */
+export type PluginScript = {
+    readonly plugin: Plugin;
+    readonly built: BuiltFacet;
+};
+/** What `PluginRuntime.load` takes besides the host. */
+export type RuntimeLoad<P extends Principal> = {
+    readonly kind: string;
+    readonly core: readonly PluginFacet<P>[];
+    readonly scripts: readonly PluginScript[];
+    readonly modules: HostPackages;
+};
+/** The plugin runtime: loads and reloads hosts with complete sets of shipped scripts. */
+export interface PluginRuntime {
+    /**
+     * Evaluates `scripts` (the complete set of `kind`) with `modules` (the host packages their `require` answers: this
+     * process's instances, kept for the host's reloads) and loads them on `host` with `core` (the app's own facets): a
+     * plugin whose build or evaluation failed is left out and reported with the host's report.
+     */
+    load<P extends Principal>(host: Host<P>, options: RuntimeLoad<P>, context: Context): Promise<LoadReport>;
+    /**
+     * Reloads `host` (loaded by `load`) with `scripts`, the complete set now, after its earlier reloads: its core facets
+     * and unchanged plugins (the same digest) as the same objects, new scripts evaluated, a plugin whose build or
+     * evaluation failed passed as its loaded facet (an added one left out; both given to the host's closure rule),
+     * loaded plugins not in `scripts` left out. What the host committed is the loaded set, also when the reload rejects
+     * `aborted` after its commit.
+     */
+    reload<P extends Principal>(host: Host<P>, scripts: readonly PluginScript[], context: Context): Promise<ReloadReport>;
+}
+/**
+ * Creates a plugin runtime: turns V8's compilation cache off (once per process: each distinct evaluated script would
+ * stay cached).
+ */
+export declare function createPluginRuntime(): PluginRuntime;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/next-node/plugins/runtime.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAGX,IAAI,EACJ,UAAU,EACV,WAAW,EAEX,YAAY,EACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjE,uGAAuG;AACvG,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAEnF,wDAAwD;AACxD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEF,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC7B;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzG;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,SAAS,SAAS,EACzB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAMnD"}

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

@@ -0,0 +1,136 @@
+// The plugin runtime (slice 10 §3, D11): loading and reloading hosts with shipped scripts, without building (no
+// esbuild, no watcher), so a worker evaluates what the server built. Per host it keeps the facet loaded for every plugin
+// and passes the host its complete set at each reload: unchanged plugins (the same digest) as the same facet objects,
+// removed ones (loaded, not shipped) left out; a plugin whose build or evaluation failed keeps its loaded facet (left
+// out at startup) and is reported with the host's report. The plugins component (`createPlugins`) uses one.
+import { setFlagsFromString } from "node:v8";
+import { isChordError } from "../../next/data/index.js";
+import { evaluateFacet } from "./evaluate.js";
+/**
+ * Creates a plugin runtime: turns V8's compilation cache off (once per process: each distinct evaluated script would
+ * stay cached).
+ */
+export function createPluginRuntime() {
+    if (!cacheOff) {
+        setFlagsFromString("--no-compilation-cache");
+        cacheOff = true;
+    }
+    return new Runtime();
+}
+/** Whether this process turned V8's compilation cache off already. */
+let cacheOff = false;
+class Runtime {
+    /** Each loaded host's plugins, held as long as the host is. */
+    #hosts = new WeakMap();
+    async load(host, options, context) {
+        const { modules } = options;
+        const prepared = options.scripts.map(({ plugin, built }) => [plugin.name, prepare(plugin, built, modules)]);
+        const failed = [];
+        const facets = [...options.core];
+        for (const [plugin, each] of prepared) {
+            if (each.kind === "failed")
+                failed.push({ plugin, error: each.error });
+            // Evaluated for this host's principal type: the facets are the app's (`Facet<P>` is invariant in `P`).
+            else
+                facets.push({ name: plugin, facet: each.facet });
+        }
+        const report = await host.load(facets, context);
+        const left = new Set(report.failed.map(({ plugin }) => plugin));
+        const loaded = new Map();
+        for (const [plugin, each] of prepared) {
+            if (each.kind === "facet" && !left.has(plugin))
+                loaded.set(plugin, each);
+        }
+        // The host's own facets, for its later reloads.
+        const core = options.core;
+        this.#hosts.set(host, { core, modules, loaded, reloading: Promise.resolve() });
+        return { failed: [...failed, ...report.failed] };
+    }
+    reload(host, scripts, context) {
+        const state = this.#hosts.get(host);
+        if (state === undefined)
+            throw new Error("plugins.reload: the host was not loaded by this runtime");
+        // One after another per host: a reload computing its set from a loaded map an earlier one is about to change
+        // would pass that plugin's old facet and roll it back.
+        const reload = state.reloading.then(() => this.#reload(host, state, scripts, context));
+        // The tail settles to nothing: a report kept as its value would keep a rejected facet's closure (its error).
+        state.reloading = reload.then(() => { }, () => { });
+        return reload;
+    }
+    /** One reload of `host` with the complete set `scripts`. */
+    async #reload(host, state, scripts, context) {
+        const failed = [];
+        const next = new Map();
+        for (const { plugin, built } of scripts) {
+            const { name } = plugin;
+            const loaded = state.loaded.get(name);
+            if (built.kind === "script" && built.digest === loaded?.digest) {
+                next.set(name, loaded);
+                continue;
+            }
+            const prepared = prepare(plugin, built, state.modules);
+            if (prepared.kind === "facet") {
+                next.set(name, prepared);
+                continue;
+            }
+            failed.push({ plugin: name, error: prepared.error });
+            if (loaded !== undefined)
+                next.set(name, loaded);
+        }
+        const facets = [...state.core, ...[...next].map(([name, { facet }]) => ({ name, facet }))];
+        // The host takes facets of its own principal type: the runtime loaded them for it. The plugins whose build or
+        // evaluation failed are the host's to report, and its closure rule's to consider.
+        let report;
+        try {
+            report = await host.reload(facets, context, { failed });
+        }
+        catch (error) {
+            // Aborted after its commit: the commit stands, and is what the host runs now.
+            const committed = committedOf(error);
+            if (committed !== undefined)
+                adopt(state, next, committed.failed);
+            throw error;
+        }
+        adopt(state, next, report.failed.map(({ plugin }) => plugin));
+        return report;
+    }
+}
+/** `built` evaluated for `plugin` with `modules`, or why not: its build failed, or its evaluation threw. */
+function prepare(plugin, built, modules) {
+    if (built.kind === "failed") {
+        const message = `plugin "${plugin.name}": its ${built.facet} facet failed to build:\n${built.errors.join("\n")}`;
+        return { kind: "failed", error: new Error(message) };
+    }
+    try {
+        const facet = evaluateFacet(built, { hostPackages: modules, plugin });
+        return { kind: "facet", facet, digest: built.digest };
+    }
+    catch (error) {
+        return { kind: "failed", error };
+    }
+}
+/**
+ * Adopts as `state`'s loaded facets the set `next` a reload committed: a plugin the host kept old (`failed`) stays loaded
+ * as it was, an added one it left out is not loaded.
+ */
+function adopt(state, next, failed) {
+    for (const plugin of failed) {
+        const loaded = state.loaded.get(plugin);
+        if (loaded === undefined)
+            next.delete(plugin);
+        else
+            next.set(plugin, loaded);
+    }
+    state.loaded.clear();
+    for (const [name, each] of next)
+        state.loaded.set(name, each);
+}
+/** What the commit of a reload that rejected applied: an `aborted` error after its commit says (`details.committed`). */
+function committedOf(error) {
+    if (!isChordError(error, "aborted"))
+        return undefined;
+    const details = error.details;
+    // The kernel's own error: its `committed` is a `CommittedReload`.
+    return typeof details === "object" && details !== null ? details.committed : undefined;
+}
+//# sourceMappingURL=runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/next-node/plugins/runtime.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,yHAAyH;AACzH,sHAAsH;AACtH,sHAAsH;AACtH,4GAA4G;AAE5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAkB,MAAM,0BAA0B,CAAC;AAYxE,OAAO,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AAmCjE;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,kBAAkB,CAAC,wBAAwB,CAAC,CAAC;QAC7C,QAAQ,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,OAAO,EAAE,CAAC;AACtB,CAAC;AAED,sEAAsE;AACtE,IAAI,QAAQ,GAAG,KAAK,CAAC;AAqBrB,MAAM,OAAO;IACZ,+DAA+D;IACtD,MAAM,GAAG,IAAI,OAAO,EAAuB,CAAC;IAErD,KAAK,CAAC,IAAI,CAAsB,IAAa,EAAE,OAAuB,EAAE,OAAgB;QACvF,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CACnC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAU,CAC9E,CAAC;QACF,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAqB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACvE,uGAAuG;;gBAClG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAA4B,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC9C,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1E,CAAC;QACD,gDAAgD;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAoD,CAAC;QAC1E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/E,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,CACL,IAAa,EACb,OAAgC,EAChC,OAAgB;QAEhB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACpG,6GAA6G;QAC7G,uDAAuD;QACvD,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACvF,6GAA6G;QAC7G,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAC5B,GAAG,EAAE,GAAE,CAAC,EACR,GAAG,EAAE,GAAE,CAAC,CACR,CAAC;QACF,OAAO,MAAM,CAAC;IACf,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,OAAO,CACZ,IAAa,EACb,KAAkB,EAClB,OAAgC,EAChC,OAAgB;QAEhB,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC5C,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;YACzC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;YACxB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,MAAM,EAAE,CAAC;gBAChE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACvB,SAAS;YACV,CAAC;YACD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACzB,SAAS;YACV,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YACrD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3F,8GAA8G;QAC9G,kFAAkF;QAClF,IAAI,MAAoB,CAAC;QACzB,IAAI,CAAC;YACJ,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAA8C,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,8EAA8E;YAC9E,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,SAAS,KAAK,SAAS;gBAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;QACb,CAAC;QACD,KAAK,CACJ,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CACzC,CAAC;QACF,OAAO,MAAM,CAAC;IACf,CAAC;CACD;AAED,4GAA4G;AAC5G,SAAS,OAAO,CAAC,MAAc,EAAE,KAAiB,EAAE,OAAqB;IACxE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,WAAW,MAAM,CAAC,IAAI,UAAU,KAAK,CAAC,KAAK,4BAA4B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,SAAS,KAAK,CAAC,KAAkB,EAAE,IAA8B,EAAE,MAAyB;IAC3F,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;;YACzC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI;QAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,yHAAyH;AACzH,SAAS,WAAW,CAAC,KAAc;IAClC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAsE,CAAC;IAC7F,kEAAkE;IAClE,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACxF,CAAC","sourcesContent":["// The plugin runtime (slice 10 §3, D11): loading and reloading hosts with shipped scripts, without building (no\n// esbuild, no watcher), so a worker evaluates what the server built. Per host it keeps the facet loaded for every plugin\n// and passes the host its complete set at each reload: unchanged plugins (the same digest) as the same facet objects,\n// removed ones (loaded, not shipped) left out; a plugin whose build or evaluation failed keeps its loaded facet (left\n// out at startup) and is reported with the host's report. The plugins component (`createPlugins`) uses one.\n\nimport { setFlagsFromString } from \"node:v8\";\nimport type { Context } from \"../../context/index.ts\";\nimport { isChordError, type Principal } from \"../../next/data/index.ts\";\nimport type {\n\tCommittedReload,\n\tFacet,\n\tHost,\n\tLoadReport,\n\tPluginFacet,\n\tPluginFailure,\n\tReloadReport,\n} from \"../../next/host/index.ts\";\nimport type { BuiltFacet } from \"./build.ts\";\nimport type { Plugin } from \"./discover.ts\";\nimport { evaluateFacet, type HostPackages } from \"./evaluate.ts\";\n\n/** One plugin's facet of a kind as shipped to a host (plain data): its build and its plugin record. */\nexport type PluginScript = { readonly plugin: Plugin; readonly built: BuiltFacet };\n\n/** What `PluginRuntime.load` takes besides the host. */\nexport type RuntimeLoad<P extends Principal> = {\n\treadonly kind: string;\n\treadonly core: readonly PluginFacet<P>[];\n\treadonly scripts: readonly PluginScript[];\n\treadonly modules: HostPackages;\n};\n\n/** The plugin runtime: loads and reloads hosts with complete sets of shipped scripts. */\nexport interface PluginRuntime {\n\t/**\n\t * Evaluates `scripts` (the complete set of `kind`) with `modules` (the host packages their `require` answers: this\n\t * process's instances, kept for the host's reloads) and loads them on `host` with `core` (the app's own facets): a\n\t * plugin whose build or evaluation failed is left out and reported with the host's report.\n\t */\n\tload<P extends Principal>(host: Host<P>, options: RuntimeLoad<P>, context: Context): Promise<LoadReport>;\n\t/**\n\t * Reloads `host` (loaded by `load`) with `scripts`, the complete set now, after its earlier reloads: its core facets\n\t * and unchanged plugins (the same digest) as the same objects, new scripts evaluated, a plugin whose build or\n\t * evaluation failed passed as its loaded facet (an added one left out; both given to the host's closure rule),\n\t * loaded plugins not in `scripts` left out. What the host committed is the loaded set, also when the reload rejects\n\t * `aborted` after its commit.\n\t */\n\treload<P extends Principal>(\n\t\thost: Host<P>,\n\t\tscripts: readonly PluginScript[],\n\t\tcontext: Context,\n\t): Promise<ReloadReport>;\n}\n\n/**\n * Creates a plugin runtime: turns V8's compilation cache off (once per process: each distinct evaluated script would\n * stay cached).\n */\nexport function createPluginRuntime(): PluginRuntime {\n\tif (!cacheOff) {\n\t\tsetFlagsFromString(\"--no-compilation-cache\");\n\t\tcacheOff = true;\n\t}\n\treturn new Runtime();\n}\n\n/** Whether this process turned V8's compilation cache off already. */\nlet cacheOff = false;\n\n/** A plugin's facet as a host loaded it, with its script's digest. */\ntype LoadedFacet = { readonly facet: Facet<Principal>; readonly digest: string };\n\n/**\n * A host's plugins as the runtime loaded them: its core facets, its modules, each plugin's loaded facet, and its\n * reloads, one after another (each computes its complete set once the previous one adopted its result).\n */\ntype HostPlugins = {\n\treadonly core: readonly PluginFacet<Principal>[];\n\treadonly modules: HostPackages;\n\treadonly loaded: Map<string, LoadedFacet>;\n\treloading: Promise<void>;\n};\n\n/** A plugin's facet passed to a host, or why it was not: a build or evaluation failure. */\ntype Prepared =\n\t| { readonly kind: \"facet\"; readonly facet: Facet<Principal>; readonly digest: string }\n\t| { readonly kind: \"failed\"; readonly error: unknown };\n\nclass Runtime implements PluginRuntime {\n\t/** Each loaded host's plugins, held as long as the host is. */\n\treadonly #hosts = new WeakMap<object, HostPlugins>();\n\n\tasync load<P extends Principal>(host: Host<P>, options: RuntimeLoad<P>, context: Context): Promise<LoadReport> {\n\t\tconst { modules } = options;\n\t\tconst prepared = options.scripts.map(\n\t\t\t({ plugin, built }) => [plugin.name, prepare(plugin, built, modules)] as const,\n\t\t);\n\t\tconst failed: PluginFailure[] = [];\n\t\tconst facets: PluginFacet<P>[] = [...options.core];\n\t\tfor (const [plugin, each] of prepared) {\n\t\t\tif (each.kind === \"failed\") failed.push({ plugin, error: each.error });\n\t\t\t// Evaluated for this host's principal type: the facets are the app's (`Facet<P>` is invariant in `P`).\n\t\t\telse facets.push({ name: plugin, facet: each.facet as unknown as Facet<P> });\n\t\t}\n\t\tconst report = await host.load(facets, context);\n\t\tconst left = new Set(report.failed.map(({ plugin }) => plugin));\n\t\tconst loaded = new Map<string, LoadedFacet>();\n\t\tfor (const [plugin, each] of prepared) {\n\t\t\tif (each.kind === \"facet\" && !left.has(plugin)) loaded.set(plugin, each);\n\t\t}\n\t\t// The host's own facets, for its later reloads.\n\t\tconst core = options.core as unknown as readonly PluginFacet<Principal>[];\n\t\tthis.#hosts.set(host, { core, modules, loaded, reloading: Promise.resolve() });\n\t\treturn { failed: [...failed, ...report.failed] };\n\t}\n\n\treload<P extends Principal>(\n\t\thost: Host<P>,\n\t\tscripts: readonly PluginScript[],\n\t\tcontext: Context,\n\t): Promise<ReloadReport> {\n\t\tconst state = this.#hosts.get(host);\n\t\tif (state === undefined) throw new Error(\"plugins.reload: the host was not loaded by this runtime\");\n\t\t// One after another per host: a reload computing its set from a loaded map an earlier one is about to change\n\t\t// would pass that plugin's old facet and roll it back.\n\t\tconst reload = state.reloading.then(() => this.#reload(host, state, scripts, context));\n\t\t// The tail settles to nothing: a report kept as its value would keep a rejected facet's closure (its error).\n\t\tstate.reloading = reload.then(\n\t\t\t() => {},\n\t\t\t() => {},\n\t\t);\n\t\treturn reload;\n\t}\n\n\t/** One reload of `host` with the complete set `scripts`. */\n\tasync #reload<P extends Principal>(\n\t\thost: Host<P>,\n\t\tstate: HostPlugins,\n\t\tscripts: readonly PluginScript[],\n\t\tcontext: Context,\n\t): Promise<ReloadReport> {\n\t\tconst failed: PluginFailure[] = [];\n\t\tconst next = new Map<string, LoadedFacet>();\n\t\tfor (const { plugin, built } of scripts) {\n\t\t\tconst { name } = plugin;\n\t\t\tconst loaded = state.loaded.get(name);\n\t\t\tif (built.kind === \"script\" && built.digest === loaded?.digest) {\n\t\t\t\tnext.set(name, loaded);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst prepared = prepare(plugin, built, state.modules);\n\t\t\tif (prepared.kind === \"facet\") {\n\t\t\t\tnext.set(name, prepared);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tfailed.push({ plugin: name, error: prepared.error });\n\t\t\tif (loaded !== undefined) next.set(name, loaded);\n\t\t}\n\t\tconst facets = [...state.core, ...[...next].map(([name, { facet }]) => ({ name, facet }))];\n\t\t// The host takes facets of its own principal type: the runtime loaded them for it. The plugins whose build or\n\t\t// evaluation failed are the host's to report, and its closure rule's to consider.\n\t\tlet report: ReloadReport;\n\t\ttry {\n\t\t\treport = await host.reload(facets as unknown as readonly PluginFacet<P>[], context, { failed });\n\t\t} catch (error) {\n\t\t\t// Aborted after its commit: the commit stands, and is what the host runs now.\n\t\t\tconst committed = committedOf(error);\n\t\t\tif (committed !== undefined) adopt(state, next, committed.failed);\n\t\t\tthrow error;\n\t\t}\n\t\tadopt(\n\t\t\tstate,\n\t\t\tnext,\n\t\t\treport.failed.map(({ plugin }) => plugin),\n\t\t);\n\t\treturn report;\n\t}\n}\n\n/** `built` evaluated for `plugin` with `modules`, or why not: its build failed, or its evaluation threw. */\nfunction prepare(plugin: Plugin, built: BuiltFacet, modules: HostPackages): Prepared {\n\tif (built.kind === \"failed\") {\n\t\tconst message = `plugin \"${plugin.name}\": its ${built.facet} facet failed to build:\\n${built.errors.join(\"\\n\")}`;\n\t\treturn { kind: \"failed\", error: new Error(message) };\n\t}\n\ttry {\n\t\tconst facet = evaluateFacet(built, { hostPackages: modules, plugin });\n\t\treturn { kind: \"facet\", facet, digest: built.digest };\n\t} catch (error) {\n\t\treturn { kind: \"failed\", error };\n\t}\n}\n\n/**\n * Adopts as `state`'s loaded facets the set `next` a reload committed: a plugin the host kept old (`failed`) stays loaded\n * as it was, an added one it left out is not loaded.\n */\nfunction adopt(state: HostPlugins, next: Map<string, LoadedFacet>, failed: readonly string[]): void {\n\tfor (const plugin of failed) {\n\t\tconst loaded = state.loaded.get(plugin);\n\t\tif (loaded === undefined) next.delete(plugin);\n\t\telse next.set(plugin, loaded);\n\t}\n\tstate.loaded.clear();\n\tfor (const [name, each] of next) state.loaded.set(name, each);\n}\n\n/** What the commit of a reload that rejected applied: an `aborted` error after its commit says (`details.committed`). */\nfunction committedOf(error: unknown): CommittedReload | undefined {\n\tif (!isChordError(error, \"aborted\")) return undefined;\n\tconst details = error.details as { readonly committed?: CommittedReload } | null | undefined;\n\t// The kernel's own error: its `committed` is a `CommittedReload`.\n\treturn typeof details === \"object\" && details !== null ? details.committed : undefined;\n}\n"]}

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

@@ -0,0 +1,16 @@
+import { SourceMap } from "node:module";
+/**
+ * Registers the script `source` evaluated under `filename` for plugin directory `dir` while `owner` (its facet, or the
+ * error its evaluation threw) lives: its inline source map, whose sources are relative to the plugin's directory. Two
+ * evaluations of one script (two hosts) share the entry.
+ */
+export declare function registerScript(filename: string, source: string, dir: string, owner: object): void;
+/** The inline source map esbuild appended to a built script, if it has one. */
+export declare function inlineSourceMap(source: string): SourceMap | undefined;
+/**
+ * `error`'s stack with every position in a registered plugin script mapped through its source map to the plugin's file
+ * and line (`notes/worker.ts:12:3`: the plugin's directory name and the file's path inside it); other lines as they
+ * are. A value that is no error with a stack gives its string.
+ */
+export declare function mapStack(error: unknown): string;
+//# sourceMappingURL=stack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/next-node/plugins/stack.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAexC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAUjG;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAGrE;AAKD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU/C"}

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

@@ -0,0 +1,61 @@
+// Stack traces of plugin scripts (slice 7c §3, decision Q1 (b)): `vm.Script` maps no positions through a source map, so
+// every evaluated script registers its map under its filename while something of its evaluation lives (its facet, or
+// the error it threw while evaluated), and `mapStack` rewrites an error's stack through them, for the app's reporters.
+// Nothing global: no `Error.prepareStackTrace`, no process-wide source-map switch. The registry is a module-level `Map`
+// keyed by filename, not a `WeakMap` keyed by an owner: `mapStack` starts from a stack's text, which names only the
+// filename. Its entries go with the last evaluation of their script (a `FinalizationRegistry` counts them down).
+import { SourceMap } from "node:module";
+import { basename, join } from "node:path";
+/** The evaluated scripts by filename, while an evaluation of each lives. */
+const scripts = new Map();
+/** Counts down an evaluation that was collected; its script's entry goes with the last one. */
+const collected = new FinalizationRegistry((filename) => {
+    const script = scripts.get(filename);
+    if (script !== undefined && --script.live === 0)
+        scripts.delete(filename);
+});
+/**
+ * Registers the script `source` evaluated under `filename` for plugin directory `dir` while `owner` (its facet, or the
+ * error its evaluation threw) lives: its inline source map, whose sources are relative to the plugin's directory. Two
+ * evaluations of one script (two hosts) share the entry.
+ */
+export function registerScript(filename, source, dir, owner) {
+    let script = scripts.get(filename);
+    if (script === undefined) {
+        const map = inlineSourceMap(source);
+        if (map === undefined)
+            return;
+        script = { map, dir, live: 0 };
+        scripts.set(filename, script);
+    }
+    script.live++;
+    collected.register(owner, filename);
+}
+/** The inline source map esbuild appended to a built script, if it has one. */
+export function inlineSourceMap(source) {
+    const inline = SOURCE_MAP.exec(source);
+    return inline === null ? undefined : new SourceMap(JSON.parse(Buffer.from(inline[1], "base64").toString("utf8")));
+}
+/** The inline source map esbuild appends to a script. */
+const SOURCE_MAP = /\/\/# sourceMappingURL=data:application\/json;base64,([A-Za-z0-9+/=]+)\s*$/;
+/**
+ * `error`'s stack with every position in a registered plugin script mapped through its source map to the plugin's file
+ * and line (`notes/worker.ts:12:3`: the plugin's directory name and the file's path inside it); other lines as they
+ * are. A value that is no error with a stack gives its string.
+ */
+export function mapStack(error) {
+    const stack = error instanceof Error ? error.stack : undefined;
+    if (stack === undefined)
+        return String(error);
+    return stack.replace(POSITION, (whole, filename, line, column) => {
+        const script = scripts.get(filename);
+        const entry = script?.map.findEntry(Number(line) - 1, Number(column) - 1);
+        if (script === undefined || entry === undefined || !("originalSource" in entry))
+            return whole;
+        const file = join(basename(script.dir), entry.originalSource).split("\\").join("/");
+        return `${file}:${entry.originalLine + 1}:${entry.originalColumn + 1}`;
+    });
+}
+/** A position in a stack line: `filename:line:column`, the filename being anything up to it (spaces included). */
+const POSITION = /([^\s()]+):(\d+):(\d+)/g;
+//# sourceMappingURL=stack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../../src/next-node/plugins/stack.ts"],"names":[],"mappings":"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","sourcesContent":["// Stack traces of plugin scripts (slice 7c §3, decision Q1 (b)): `vm.Script` maps no positions through a source map, so\n// every evaluated script registers its map under its filename while something of its evaluation lives (its facet, or\n// the error it threw while evaluated), and `mapStack` rewrites an error's stack through them, for the app's reporters.\n// Nothing global: no `Error.prepareStackTrace`, no process-wide source-map switch. The registry is a module-level `Map`\n// keyed by filename, not a `WeakMap` keyed by an owner: `mapStack` starts from a stack's text, which names only the\n// filename. Its entries go with the last evaluation of their script (a `FinalizationRegistry` counts them down).\n\nimport { SourceMap } from \"node:module\";\nimport { basename, join } from \"node:path\";\n\n/** A registered script: how its positions map, its plugin's directory, and how many of its evaluations live. */\ntype Registered = { readonly map: SourceMap; readonly dir: string; live: number };\n\n/** The evaluated scripts by filename, while an evaluation of each lives. */\nconst scripts = new Map<string, Registered>();\n\n/** Counts down an evaluation that was collected; its script's entry goes with the last one. */\nconst collected = new FinalizationRegistry<string>((filename) => {\n\tconst script = scripts.get(filename);\n\tif (script !== undefined && --script.live === 0) scripts.delete(filename);\n});\n\n/**\n * Registers the script `source` evaluated under `filename` for plugin directory `dir` while `owner` (its facet, or the\n * error its evaluation threw) lives: its inline source map, whose sources are relative to the plugin's directory. Two\n * evaluations of one script (two hosts) share the entry.\n */\nexport function registerScript(filename: string, source: string, dir: string, owner: object): void {\n\tlet script = scripts.get(filename);\n\tif (script === undefined) {\n\t\tconst map = inlineSourceMap(source);\n\t\tif (map === undefined) return;\n\t\tscript = { map, dir, live: 0 };\n\t\tscripts.set(filename, script);\n\t}\n\tscript.live++;\n\tcollected.register(owner, filename);\n}\n\n/** The inline source map esbuild appended to a built script, if it has one. */\nexport function inlineSourceMap(source: string): SourceMap | undefined {\n\tconst inline = SOURCE_MAP.exec(source);\n\treturn inline === null ? undefined : new SourceMap(JSON.parse(Buffer.from(inline[1]!, \"base64\").toString(\"utf8\")));\n}\n\n/** The inline source map esbuild appends to a script. */\nconst SOURCE_MAP = /\\/\\/# sourceMappingURL=data:application\\/json;base64,([A-Za-z0-9+/=]+)\\s*$/;\n\n/**\n * `error`'s stack with every position in a registered plugin script mapped through its source map to the plugin's file\n * and line (`notes/worker.ts:12:3`: the plugin's directory name and the file's path inside it); other lines as they\n * are. A value that is no error with a stack gives its string.\n */\nexport function mapStack(error: unknown): string {\n\tconst stack = error instanceof Error ? error.stack : undefined;\n\tif (stack === undefined) return String(error);\n\treturn stack.replace(POSITION, (whole, filename: string, line: string, column: string) => {\n\t\tconst script = scripts.get(filename);\n\t\tconst entry = script?.map.findEntry(Number(line) - 1, Number(column) - 1);\n\t\tif (script === undefined || entry === undefined || !(\"originalSource\" in entry)) return whole;\n\t\tconst file = join(basename(script.dir), entry.originalSource).split(\"\\\\\").join(\"/\");\n\t\treturn `${file}:${entry.originalLine + 1}:${entry.originalColumn + 1}`;\n\t});\n}\n\n/** A position in a stack line: `filename:line:column`, the filename being anything up to it (spaces included). */\nconst POSITION = /([^\\s()]+):(\\d+):(\\d+)/g;\n"]}

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

@@ -0,0 +1,58 @@
+import { type Context } from "../../context/index.ts";
+import type { JsonValue } from "../../json.ts";
+import { type Batch, Source } from "../../next/state/internal.ts";
+import { type BuiltFacet } from "./build.ts";
+import { type Discovery } from "./discover.ts";
+/** The marks: plugins to rebuild, plugins to install, whether to discover again, whether base code changed. */
+export type PluginsState = {
+    readonly dirty: readonly string[];
+    readonly install: readonly string[];
+    readonly set: boolean;
+    readonly base: boolean;
+};
+/** The generation of each dirty plugin's latest change when a build started: what its rollout may clear. */
+export type MarkSnapshot = {
+    readonly plugins: ReadonlyMap<string, number>;
+};
+/** The generations of the latest change of the plugin set and of a `package.json` when a discovery started. */
+export type DiscoverySnapshot = {
+    readonly set: number;
+    readonly manifest: number;
+};
+/** What the watcher watches and how it reports: the roots, the base code, the facet kinds, a failure to watch. */
+export type WatcherOptions = {
+    readonly roots: readonly string[];
+    readonly base: readonly string[];
+    readonly kinds: readonly string[];
+    /** The watcher cannot watch (the system's limit): reported once, after which the app builds on demand. */
+    readonly failed: (error: unknown) => void;
+};
+/**
+ * The watcher and the marks (`state`), a JSON watchable published at most once per microtask turn with changes. It
+ * marks for the plugins of the last discovery (`know`) and the files their last builds read (`used`).
+ */
+export declare class PluginWatcher extends Source {
+    #private;
+    constructor(options: WatcherOptions, batch: Batch);
+    get value(): JsonValue;
+    deliver(context: Context): void;
+    /** Whether the next build discovers again: the plugin set or a plugin's `package.json` changed. */
+    get needsDiscovery(): boolean;
+    /** What a discovery that starts now has seen. */
+    discoverySnapshot(): DiscoverySnapshot;
+    /** The plugins discovery found: marks are for them (a removed one's install clears); the changes it had seen clear. */
+    know(discovery: Discovery, seen: DiscoverySnapshot): void;
+    /** What `built` facets read: a later change of one of these files dirties their plugins. */
+    used(built: readonly BuiltFacet[]): void;
+    /** The marks a build of `names` starts from: each one's latest change. */
+    snapshot(names: Iterable<string>): MarkSnapshot;
+    /** `names` were applied everywhere: their marks clear unless a change came after `snapshot`. */
+    applied(names: Iterable<string>, snapshot: MarkSnapshot): void;
+    /** Plugin `name`'s dependencies were installed: its install mark clears and it is dirty (its packages changed). */
+    installed(name: string): void;
+    /** Marks what a change of the file or directory at `path` (absolute) asks for. */
+    mark(path: string): void;
+    /** Stops watching. */
+    close(): void;
+}
+//# sourceMappingURL=watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/next-node/plugins/watcher.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,KAAK,UAAU,EAAU,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,eAAe,CAAC;AAEjE,+GAA+G;AAC/G,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,4GAA4G;AAC5G,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE7E,+GAA+G;AAC/G,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,kHAAkH;AAClH,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C,CAAC;AAKF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,MAAM;;IA0BxC,YAAY,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAOhD;IAED,IAAI,KAAK,IAAI,SAAS,CAQrB;IAED,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAG9B;IAED,mGAAmG;IACnG,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,iDAAiD;IACjD,iBAAiB,IAAI,iBAAiB,CAErC;IAED,uHAAuH;IACvH,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAgBxD;IAED,4FAA4F;IAC5F,IAAI,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAMvC;IAED,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,YAAY,CAI9C;IAED,gGAAgG;IAChG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAM7D;IAED,mHAAmH;IACnH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5B;IAED,kFAAkF;IAClF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQvB;IAED,sBAAsB;IACtB,KAAK,IAAI,IAAI,CAIZ;CAyGD"}