dougong 0.8.3 → 0.10.0

package/README.md

@@ -1,111 +1,36 @@
 # dougong
 
-[简体中文](#简体中文) · [English](#english)
+The TypeScript plugin composition kernel. This package owns contracts, declarations, immutable plans, execution, resource lifetimes and diagnostic projections.
 
----
-
-## 简体中文
-
-**能力组合与结构化生命周期内核**，纯 JavaScript/TypeScript。
-
-这是门面包，聚合 [`@dougongjs/core`](https://www.npmjs.com/package/@dougongjs/core)、[`@dougongjs/reactive`](https://www.npmjs.com/package/@dougongjs/reactive) 与 [`@dougongjs/platform`](https://www.npmjs.com/package/@dougongjs/platform)。它只做 re-export，不包含任何逻辑——架构门禁会强制这一点。
-
-```sh
-npm install dougong
-```
-
-```ts
-import { createHost, definePlugin, service } from "dougong"
-
-const CLOCK = service<Clock>("app/clock")
-
-const clock = definePlugin({
-  name: "app.clock",
-  provides: { clock: CLOCK },
-  setup: () => ({ clock: { now: () => new Date() } }),
-})
-
-const greeter = definePlugin({
-  name: "app.greeter",
-  requires: { clock: CLOCK },
-  setup(ctx) {
-    console.log(ctx.clock.now())
-  },
-})
-
-const host = createHost({ name: "hello" })
-host.install(greeter)
-host.install(clock)
-await host.start()
-```
-
-六个原子：**Service**（稳定的一对一能力）、**ExtensionPoint**（开放贡献集合）、**Event**（瞬时事实）、**Lifetime**（结构化所有权）、**Plugin**、**Host**。
-
-三条核心保证：依赖与所有权**显式**写在声明里；每个语义只有**一条**正式路径；事务只暴露**已提交**状态。
-
-### 环境要求
-
-Node.js ≥ 22；浏览器 / WebView 基线为 Chrome / Edge 119、Firefox 121、Safari 17.4，并提供 `Promise.withResolvers()`。显式 `.dispose()` 在全部基线上可用；`using` / `await using` 还要求运行时原生提供或应用预先 polyfill `Symbol.dispose` / `Symbol.asyncDispose`。Dougong 不修改全局对象。TypeScript 消费者需要：
-
-```json
-"lib": ["ES2024", "DOM", "DOM.Iterable", "ESNext.Disposable"]
-```
-
----
-
-## English
-
-A **capability composition and structured lifetime kernel** in pure JavaScript/TypeScript.
-
-This is the facade package aggregating [`@dougongjs/core`](https://www.npmjs.com/package/@dougongjs/core), [`@dougongjs/reactive`](https://www.npmjs.com/package/@dougongjs/reactive) and [`@dougongjs/platform`](https://www.npmjs.com/package/@dougongjs/platform). It only re-exports and contains no logic — an architecture gate enforces that.
-
-```sh
-npm install dougong
-```
+Upgrading from 0.8.3? Read the [migration guide](https://tangerg.github.io/dougong/en/guide/migrating-to-0.9) and [0.9.0 release notes](https://tangerg.github.io/dougong/en/reference/release-0.9.0).
 
 ```ts
-import { createHost, definePlugin, service } from "dougong"
-
-const CLOCK = service<Clock>("app/clock")
-
-const clock = definePlugin({
-  name: "app.clock",
-  provides: { clock: CLOCK },
-  setup: () => ({ clock: { now: () => new Date() } }),
-})
+import { asyncDisposeSymbol, createHost, definePlugin, service } from "dougong";
 
+const GREETER = service<{ greet(name: string): string }>("application/greeter");
 const greeter = definePlugin({
-  name: "app.greeter",
-  requires: { clock: CLOCK },
-  setup(ctx) {
-    console.log(ctx.clock.now())
+  name: "application.greeter",
+  provides: { greeter: GREETER },
+  setup() {
+    return { greeter: { greet: (name) => `Hello, ${name}` } };
   },
-})
-
-const host = createHost({ name: "hello" })
-host.install(greeter)
-host.install(clock)
-await host.start()
+});
+
+const host = createHost({
+  name: "application",
+  installations: [{ id: "greeter", plugin: greeter }],
+});
+await host.start();
+const { value: message } = await host.use(GREETER, (service) => service.greet("Dougong"));
+await host[asyncDisposeSymbol]();
 ```
 
-Six atoms: **Service** (a stable one-to-one capability), **ExtensionPoint** (an open contribution set), **Event** (a transient fact), **Lifetime** (structured ownership), **Plugin**, **Host**.
-
-Three core guarantees: dependencies and ownership are written **explicitly** in declarations; every semantic has exactly **one** canonical path; transactions expose only **committed** state.
-
-### Requirements
-
-Node.js ≥ 22; Chrome / Edge 119, Firefox 121 or Safari 17.4 for browsers and WebViews, with `Promise.withResolvers()`. Explicit `.dispose()` works throughout; `using` / `await using` additionally require native or application-polyfilled `Symbol.dispose` / `Symbol.asyncDispose`. Dougong does not mutate globals. TypeScript consumers need:
-
-```json
-"lib": ["ES2024", "DOM", "DOM.Iterable", "ESNext.Disposable"]
-```
+Use `host.change()`, `host.plan(change)` and `host.apply(plan)` for changes. Services and executable contributions are borrowed with `host.use` and `ContributionView.use`. Standard resources belong to `context.lifetime`; context dependencies live under `context.dependencies`.
 
----
+Read and observe execution through `host.diagnostics.get()` and `host.diagnostics.subscribe()`. Successful transitions resolve with the state revision and affected installations; failures reject. Cleanup failure retains dependent resources while releasing independently safe branches. It quarantines the whole Host permanently: creating a replacement does not dispose old resources. Follow the [quarantine procedure](https://tangerg.github.io/dougong/en/guide/transactions#quarantine) before takeover.
 
-- 文档站 / Documentation: https://tangerg.github.io/dougong/
-- 仓库 / Repository: https://github.com/Tangerg/dougong
+The formal `dougong/advanced` subpath exports stable snapshot publishing, immutable map snapshots, serial queues and record normalization for downstream composition. Optional delivery and reactivity live in `@dougongjs/platform` and `@dougongjs/reactive`.
 
-> 早期 0.x 开发阶段，当前不承诺向后兼容。
-> Early 0.x development; no backward-compatibility promises yet.
+ESM; <!-- runtime-baseline:start -->Node.js `^24.22.0 || >=26.10.0`, Chrome ≥ 119, Edge ≥ 119, Firefox ≥ 124, Safari ≥ 17.4<!-- runtime-baseline:end -->.
 
-MIT
+[API documentation](https://tangerg.github.io/dougong/en/reference/core-api) · [Architecture](https://tangerg.github.io/dougong/en/reference/architecture)

package/dist/advanced.d.ts

@@ -0,0 +1,9 @@
+export { SnapshotPublisher, batchSnapshotNotifications } from './observation/snapshot-view.js';
+export { ReadonlyMapSnapshot } from './observation/readonly-map.js';
+export { SerialQueue } from './internal/serial-queue.js';
+export { normalizePlainRecord, recordFields } from './internal/record.js';
+export { captureDataArray } from './internal/data-array.js';
+export { onAbort } from './internal/abort.js';
+export { captureLogger } from './contracts/logging.js';
+export { resolveValue } from './internal/async-result.js';
+//# sourceMappingURL=advanced.d.ts.map

package/dist/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../src/advanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/advanced.js

@@ -0,0 +1,39 @@
+import { G as e, H as t, a as n, c as r, o as i, q as a, r as o, s, t as c } from "./serial-queue-DjEs2KFf.js";
+// src/observation/readonly-map.ts
+var l = class {
+	#e;
+	constructor(e = []) {
+		if (!e || typeof e != "object" && typeof e != "function") throw TypeError("ReadonlyMapSnapshot values must be an iterable object");
+		this.#e = new Map(e), Object.freeze(this);
+	}
+	get size() {
+		return this.#e.size;
+	}
+	get(e) {
+		return this.#e.get(e);
+	}
+	has(e) {
+		return this.#e.has(e);
+	}
+	forEach(e, t) {
+		if (typeof e != "function") throw TypeError("ReadonlyMapSnapshot callback must be a function");
+		for (let [n, r] of this.#e) Reflect.apply(e, t, [
+			r,
+			n,
+			this
+		]);
+	}
+	entries() {
+		return this.#e.entries();
+	}
+	keys() {
+		return this.#e.keys();
+	}
+	values() {
+		return this.#e.values();
+	}
+	[Symbol.iterator]() {
+		return this.entries();
+	}
+};
+export { l as ReadonlyMapSnapshot, c as SerialQueue, n as SnapshotPublisher, i as batchSnapshotNotifications, t as captureDataArray, o as captureLogger, s as normalizePlainRecord, e as onAbort, r as recordFields, a as resolveValue };

package/dist/composition/change-set.d.ts

@@ -0,0 +1,56 @@
+import { ConfigurationValue } from './configuration.js';
+import { NormalizedPlugin } from './plugin.js';
+import { ChangeSet, InstallationOrigin } from './declarations.js';
+import { InstallationDeclaration, InstallationRecord } from './installation.js';
+import { GroupNode } from './group.js';
+type NormalizedInstallationUpdate = {
+    readonly kind: "replace";
+    readonly plugin: NormalizedPlugin;
+    readonly configuration?: ConfigurationValue | undefined;
+    readonly origin: InstallationOrigin | undefined;
+} | {
+    readonly kind: "configure";
+    readonly configuration: ConfigurationValue | undefined;
+    readonly plugin?: never;
+    readonly origin?: never;
+};
+export type ChangeOperation = {
+    readonly kind: "install";
+    readonly installation: InstallationRecord;
+    readonly declaration: InstallationDeclaration;
+} | {
+    readonly kind: "update";
+    readonly installation: InstallationRecord;
+    readonly update: NormalizedInstallationUpdate;
+} | {
+    readonly kind: "remove";
+    readonly installation: InstallationRecord;
+} | {
+    readonly kind: "group";
+    readonly group: GroupNode;
+} | {
+    readonly kind: "remove-group";
+    readonly group: GroupNode;
+};
+export interface ChangePort {
+    readonly create: (id: string, group: GroupNode | undefined) => InstallationRecord;
+    readonly resolve: (installation: object) => InstallationRecord;
+    readonly createGroup: (id: string, parent: GroupNode | undefined) => GroupNode;
+    readonly resolveGroup: (group: object) => GroupNode;
+}
+export declare function assertId(id: unknown, label: string): asserts id is string;
+interface DraftState {
+    readonly port: ChangePort;
+    readonly operations: ChangeOperation[];
+    readonly targets: Set<object>;
+}
+export declare class ChangeSets {
+    #private;
+    create(port: ChangePort): ChangeSet;
+    take(change: ChangeSet): ReadonlyArray<ChangeOperation>;
+    requireOpen(change: ChangeSet): DraftState;
+    track(installation: InstallationRecord): void;
+    close(revision: number): void;
+}
+export {};
+//# sourceMappingURL=change-set.d.ts.map

package/dist/composition/change-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-set.d.ts","sourceRoot":"","sources":["../../src/composition/change-set.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,KAAK,EACV,SAAS,EAKT,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAc5C,KAAK,4BAA4B,GAC7B;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACjD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;CACzB,CAAC;AAEN,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;CAC/C,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;CAC/C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,KAAK,kBAAkB,CAAC;IAClF,QAAQ,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,kBAAkB,CAAC;IAC/D,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,KAAK,SAAS,CAAC;IAC/E,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;CACrD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAIzE;AAED,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,qBAAa,UAAU;;IAIrB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;IAMnC,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC,eAAe,CAAC;IAYvD,WAAW,CAAC,MAAM,EAAE,SAAS;IAM7B,KAAK,CAAC,YAAY,EAAE,kBAAkB;IAItC,KAAK,CAAC,QAAQ,EAAE,MAAM;CASvB"}

package/dist/composition/configuration.d.ts

@@ -0,0 +1,8 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { ResolvedValue } from '../internal/async-result.js';
+export type ConfigurationValue = null | boolean | string | number | ReadonlyArray<ConfigurationValue> | {
+    readonly [key: string]: ConfigurationValue;
+};
+export declare function captureConfiguration(input: unknown): ConfigurationValue | undefined;
+export declare function resolvePluginConfiguration(schema: StandardSchemaV1<unknown, unknown> | undefined, input: ConfigurationValue | undefined, installationId: string, validity?: AbortSignal): Promise<ResolvedValue<ConfigurationValue | undefined>>;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/composition/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/composition/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAK/E,MAAM,MAAM,kBAAkB,GAC1B,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,aAAa,CAAC,kBAAkB,CAAC,GACjC;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAC;AASnD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAwCnF;AAGD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,EACtD,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,aAAa,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC,CAgCxD"}

package/dist/composition/declarations.d.ts

@@ -0,0 +1,60 @@
+import { AnyPlugin, Plugin } from './plugin.js';
+import { ConfigurationValue } from './configuration.js';
+import { InstallationState } from '../contracts/status.js';
+export type InstallationOrigin = Readonly<Record<string, ConfigurationValue>>;
+declare const installationBrand: unique symbol;
+declare const groupBrand: unique symbol;
+export interface Installation<Declaration extends AnyPlugin = AnyPlugin> {
+    readonly [installationBrand]: (declaration: Declaration) => Declaration;
+    readonly id: string;
+    readonly groupId: string | undefined;
+    readonly status: InstallationState;
+    readonly origin: InstallationOrigin | undefined;
+}
+export interface Group {
+    readonly [groupBrand]: true;
+    readonly id: string;
+    readonly parentId: string | undefined;
+}
+type ConfigurationInputOf<Declaration extends AnyPlugin> = Declaration extends Plugin<infer _Configuration, infer _Requires, infer _Provides, infer Input> ? Input : unknown;
+export type InstallationOptions<Declaration extends AnyPlugin = AnyPlugin> = {
+    readonly id: string;
+    readonly group?: Group;
+    readonly origin?: InstallationOrigin;
+} & (undefined extends ConfigurationInputOf<Declaration> ? {
+    readonly configuration?: NoInfer<ConfigurationInputOf<Declaration>>;
+} : {
+    readonly configuration: NoInfer<ConfigurationInputOf<Declaration>>;
+});
+export type InstallationArguments<Declaration extends AnyPlugin = AnyPlugin> = Declaration extends unknown ? [plugin: Declaration, options: InstallationOptions<Declaration>] : never;
+type SharedConfigurationInput<Declaration extends AnyPlugin> = (Declaration extends unknown ? (input: ConfigurationInputOf<Declaration>) => void : never) extends (input: infer Input) => void ? Input : never;
+type InstallationReplacement<Declaration extends AnyPlugin, PreviousInput> = Declaration extends unknown ? {
+    readonly plugin: Declaration;
+    readonly origin?: InstallationOrigin;
+} & ([PreviousInput] extends [ConfigurationInputOf<Declaration>] ? {
+    readonly configuration?: ConfigurationInputOf<Declaration>;
+} : {
+    readonly configuration: ConfigurationInputOf<Declaration>;
+}) : never;
+export type InstallationUpdate<Declaration extends AnyPlugin = AnyPlugin> = InstallationReplacement<Declaration, ConfigurationInputOf<Declaration>> | {
+    readonly plugin?: never;
+    readonly configuration: SharedConfigurationInput<Declaration>;
+    readonly origin?: never;
+};
+export interface ChangeSet {
+    install<Arguments extends readonly [plugin: AnyPlugin, options: unknown]>(...declaration: Arguments & NoInfer<InstallationArguments<Arguments[0]>>): Installation<Arguments[0]>;
+    update<Declaration extends AnyPlugin>(installation: Installation<Declaration>, update: NoInfer<InstallationUpdate<Declaration>>): void;
+    remove<Declaration extends AnyPlugin>(installation: Installation<Declaration>): void;
+    group(id: string, parent?: Group): Group;
+    removeGroup(group: Group): void;
+}
+type InitialInstallationFromArguments<Arguments> = Arguments extends [
+    plugin: infer Declaration,
+    options: infer Options
+] ? Omit<Options, "group"> & {
+    readonly plugin: Declaration;
+    readonly groupId?: string;
+} : never;
+export type InitialInstallation<Declaration extends AnyPlugin = AnyPlugin> = InitialInstallationFromArguments<InstallationArguments<Declaration>>;
+export {};
+//# sourceMappingURL=declarations.d.ts.map

package/dist/composition/declarations.d.ts.map

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

package/dist/composition/group.d.ts

@@ -0,0 +1,10 @@
+import { Group } from './declarations.js';
+export declare class GroupNode {
+    readonly id: string;
+    readonly parent: GroupNode | undefined;
+    readonly facade: Group;
+    constructor(id: string, parent: GroupNode | undefined);
+    get parentId(): string | undefined;
+}
+export declare function buildInitialGroups(parents: ReadonlyMap<string, string | undefined>, create: (id: string, parent: GroupNode | undefined) => GroupNode): Map<string, GroupNode>;
+//# sourceMappingURL=group.d.ts.map

package/dist/composition/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../src/composition/group.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,qBAAa,SAAS;IAGlB,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS;IAHxC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;gBAEZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,SAAS,GAAG,SAAS;IAKxC,IAAI,QAAQ,uBAEX;CACF;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAChD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,KAAK,SAAS,0BAqBjE"}

package/dist/composition/installation-graph.d.ts

@@ -0,0 +1,17 @@
+import { ContractKind } from '../contracts/contracts.js';
+import { InstallationDeclaration, InstallationRecord } from './installation.js';
+export declare class InstallationGraph {
+    #private;
+    readonly declarations: ReadonlyMap<InstallationRecord, InstallationDeclaration>;
+    readonly byId: ReadonlyMap<string, InstallationRecord>;
+    readonly order: ReadonlyArray<InstallationRecord>;
+    readonly layers: ReadonlyArray<ReadonlyArray<InstallationRecord>>;
+    readonly providers: ReadonlyMap<string, InstallationRecord>;
+    readonly dependents: ReadonlyMap<InstallationRecord, ReadonlySet<InstallationRecord>>;
+    readonly contractKinds: ReadonlyMap<string, ContractKind>;
+    private constructor();
+    static build(declarations: ReadonlyMap<InstallationRecord, InstallationDeclaration>): InstallationGraph;
+    declarationFor(installation: InstallationRecord): InstallationDeclaration;
+    affectedByTransitionTo(other: InstallationGraph, changed: ReadonlyArray<InstallationRecord>): Set<InstallationRecord>;
+}
+//# sourceMappingURL=installation-graph.d.ts.map

package/dist/composition/installation-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation-graph.d.ts","sourceRoot":"","sources":["../../src/composition/installation-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAQ9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIrF,qBAAa,iBAAiB;;IAE1B,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;IAC/E,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACjE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,kBAAkB,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACrF,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAP3D,OAAO;IAUP,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;IAsBnF,cAAc,CAAC,YAAY,EAAE,kBAAkB;IAO/C,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,aAAa,CAAC,kBAAkB,CAAC;CAmB5F"}

package/dist/composition/installation.d.ts

@@ -0,0 +1,33 @@
+import { InstallationState } from '../contracts/status.js';
+import { Installation, InstallationOrigin } from './declarations.js';
+import { AnyPlugin, NormalizedPlugin } from './plugin.js';
+import { ConfigurationValue } from './configuration.js';
+import { GroupNode } from './group.js';
+export interface InstallationDeclaration {
+    readonly plugin: NormalizedPlugin;
+    readonly configuration: ConfigurationValue | undefined;
+    readonly origin: InstallationOrigin | undefined;
+}
+export declare function claimInstallationId(ids: Set<string>, id: string): void;
+export declare function captureInstallationDeclaration(plugin: AnyPlugin, configuration: unknown, origin: unknown): InstallationDeclaration;
+export declare function captureOrigin(value: unknown): InstallationOrigin | undefined;
+export interface InstallationProjection {
+    readonly status: InstallationState;
+    readonly origin: InstallationOrigin | undefined;
+}
+export declare class PendingInstallations {
+    #private;
+    attach(installation: InstallationRecord): void;
+    retire(): void;
+}
+export declare class InstallationRecord {
+    #private;
+    readonly id: string;
+    readonly group: GroupNode | undefined;
+    readonly facade: Installation;
+    constructor(id: string, group: GroupNode | undefined);
+    get groupId(): string | undefined;
+    attach(read: () => InstallationProjection): void;
+    detach(projection: InstallationProjection): void;
+}
+//# sourceMappingURL=installation.d.ts.map

package/dist/composition/installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../src/composition/installation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACjD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,QAI/D;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,OAAO,EACtB,MAAM,EAAE,OAAO,GACd,uBAAuB,CAMzB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAO5E;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACjD;AAGD,qBAAa,oBAAoB;;IAK/B,MAAM,CAAC,YAAY,EAAE,kBAAkB;IAIvC,MAAM;CAGP;AAED,qBAAa,kBAAkB;;IAM3B,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IANvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;gBAKnB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,SAAS,GAAG,SAAS;IAevC,IAAI,OAAO,uBAEV;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,sBAAsB;IAIzC,MAAM,CAAC,UAAU,EAAE,sBAAsB;CAQ1C"}

package/dist/composition/plan.d.ts

@@ -0,0 +1,109 @@
+import { InstallationGraph } from './installation-graph.js';
+import { InstallationRecord } from './installation.js';
+import { GroupNode } from './group.js';
+import { ConfigurationValue } from './configuration.js';
+import { InstallationOrigin } from './declarations.js';
+import { ChangeOperation } from './change-set.js';
+export type TransitionIntent = "change" | "start" | "stop";
+export type BindingReport = {
+    readonly installation: string;
+    readonly contract: string;
+} & ({
+    readonly optional: false;
+    readonly provider: string;
+} | {
+    readonly optional: true;
+    readonly provider: string | undefined;
+});
+export type DirectImpactKind = "installed" | "updated" | "removed" | "start" | "stop";
+type ProviderChange = {
+    readonly provider: string;
+    readonly previousProvider?: string;
+} | {
+    readonly provider?: never;
+    readonly previousProvider: string;
+};
+export type ImpactReason = {
+    readonly installation: string;
+    readonly kind: DirectImpactKind;
+    readonly contract?: never;
+    readonly provider?: never;
+    readonly previousProvider?: never;
+} | ({
+    readonly installation: string;
+    readonly kind: "provider_changed";
+    readonly contract: string;
+} & ProviderChange);
+export interface DeclarationSnapshot {
+    readonly pluginName: string;
+    readonly origin: InstallationOrigin | undefined;
+}
+export type PlanOperation = {
+    readonly kind: "install";
+    readonly id: string;
+    readonly before: undefined;
+    readonly after: DeclarationSnapshot;
+} | {
+    readonly kind: "update";
+    readonly id: string;
+    readonly before: DeclarationSnapshot;
+    readonly after: DeclarationSnapshot;
+} | {
+    readonly kind: "remove";
+    readonly id: string;
+    readonly before: DeclarationSnapshot;
+    readonly after: undefined;
+} | {
+    readonly kind: "group" | "remove-group";
+    readonly id: string;
+    readonly parentId: string | undefined;
+};
+export interface PlanReport {
+    readonly baseStateRevision: number;
+    readonly intent: TransitionIntent;
+    readonly operations: ReadonlyArray<PlanOperation>;
+    readonly bindings: {
+        readonly before: ReadonlyArray<BindingReport>;
+        readonly after: ReadonlyArray<BindingReport>;
+    };
+    readonly affectedInstallations: ReadonlyArray<string>;
+    readonly reasons: ReadonlyArray<ImpactReason>;
+    readonly stopOrder: ReadonlyArray<string>;
+    readonly prepareOrder: ReadonlyArray<string>;
+    readonly publishOrder: ReadonlyArray<string>;
+    readonly execution: {
+        readonly atomicPublication: true;
+        readonly externalEffectsRollback: false;
+    };
+}
+declare const planBrand: unique symbol;
+export interface Plan {
+    readonly [planBrand]: true;
+    readonly report: PlanReport;
+}
+export interface PreparedTransition {
+    readonly groups: ReadonlyMap<string, GroupNode>;
+    readonly graph: InstallationGraph;
+    readonly affected: ReadonlySet<InstallationRecord>;
+    readonly configurations: ReadonlyMap<InstallationRecord, {
+        readonly value: ConfigurationValue | undefined;
+    }>;
+    readonly report: PlanReport;
+}
+interface PlanBase {
+    readonly revision: number;
+    readonly graph: InstallationGraph;
+}
+export declare class PlanAuthority {
+    #private;
+    get validationSignal(): AbortSignal;
+    issue(prepared: PreparedTransition, base: PlanBase): Plan;
+    read(plan: Plan, revision: number): PreparedTransition;
+    consume(plan: Plan): void;
+    invalidate(revision: number, quarantined: boolean): void;
+}
+export declare function describeOperations(operations: ReadonlyArray<ChangeOperation>, previous: InstallationGraph, candidate: InstallationGraph): ReadonlyArray<PlanOperation>;
+export declare function describeBindings(graph: InstallationGraph, installations?: ReadonlyArray<InstallationRecord>): ReadonlyArray<BindingReport>;
+export declare function describeImpact(previous: InstallationGraph, candidate: InstallationGraph, affected: ReadonlySet<InstallationRecord>, direct: ReadonlyMap<InstallationRecord, DirectImpactKind>): ReadonlyArray<ImpactReason>;
+export {};
+//# sourceMappingURL=plan.d.ts.map

package/dist/composition/plan.d.ts.map

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

package/dist/composition/planner.d.ts

@@ -0,0 +1,18 @@
+import { ContractRegistry } from '../contracts/contract-registry.js';
+import { InstallationGraph } from './installation-graph.js';
+import { ConfigurationValue } from './configuration.js';
+import { ChangeOperation } from './change-set.js';
+import { GroupNode } from './group.js';
+import { InstallationRecord } from './installation.js';
+import { PreparedTransition, TransitionIntent } from './plan.js';
+export interface CompositionState {
+    readonly phase: "stopped" | "running" | "quarantined";
+    readonly revision: number;
+    readonly groups: ReadonlyMap<string, GroupNode>;
+    readonly graph: InstallationGraph;
+    readonly configurations: ReadonlyMap<InstallationRecord, {
+        readonly value: ConfigurationValue | undefined;
+    }>;
+}
+export declare function compileTransition(current: CompositionState, operations: ReadonlyArray<ChangeOperation>, intent: TransitionIntent, contracts: ContractRegistry, validity?: AbortSignal): Promise<PreparedTransition>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/composition/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/composition/planner.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAClC,kBAAkB,EAClB;QAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAAA;KAAE,CACnD,CAAC;CACH;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,EAC1C,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAqJ7B"}

package/dist/composition/plugin-description.d.ts

@@ -0,0 +1,34 @@
+import { StandardJSONSchemaV1 } from '@standard-schema/spec';
+import { ConfigurationValue } from './configuration.js';
+import { AnyPlugin } from './plugin.js';
+export interface PluginDescriptionOptions {
+    readonly jsonSchemaTarget?: StandardJSONSchemaV1.Target;
+}
+export type PluginConfigurationDescriptor = {
+    readonly status: "none";
+} | {
+    readonly status: "unavailable";
+    readonly vendor: string;
+} | {
+    readonly status: "available";
+    readonly vendor: string;
+    readonly target: StandardJSONSchemaV1.Target;
+    readonly input: Readonly<Record<string, ConfigurationValue>>;
+    readonly output: Readonly<Record<string, ConfigurationValue>>;
+};
+export interface PluginDescriptor {
+    readonly name: string;
+    readonly requires: ReadonlyArray<{
+        readonly alias: string;
+        readonly id: string;
+        readonly kind: "service" | "extensionPoint";
+        readonly optional: boolean;
+    }>;
+    readonly provides: ReadonlyArray<{
+        readonly alias: string;
+        readonly id: string;
+    }>;
+    readonly configuration: PluginConfigurationDescriptor;
+}
+export declare function describePlugin(plugin: AnyPlugin, options?: PluginDescriptionOptions): PluginDescriptor;
+//# sourceMappingURL=plugin-description.d.ts.map

package/dist/composition/plugin-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-description.d.ts","sourceRoot":"","sources":["../../src/composition/plugin-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC;CACzD;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3D;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CAC/D,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;QAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAAC;QAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC5B,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC;CACvD;AAID,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,wBAA6B,GACrC,gBAAgB,CA4ClB"}