dougong 0.8.2 → 0.9.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 { 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 message = await host.use(GREETER, (service) => service.greet("Dougong"));
+await host[Symbol.asyncDispose]();
 ```
 
-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; Node.js 22+, Chrome/Edge 119+, Firefox 124+, Safari 17.4+.
 
-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,8 @@
+export { SnapshotPublisher, batchSnapshotNotifications } from './observation/snapshot-view.js';
+export { ReadonlyMapSnapshot } from './observation/readonly-map.js';
+export { SerialQueue } from './internal/serial-queue.js';
+export { normalizePlainRecord } from './internal/record.js';
+export { captureDataArray } from './internal/data-array.js';
+export { onAbort } from './internal/abort.js';
+export { captureLogger } from './contracts/logging.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,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/advanced.js

@@ -0,0 +1,39 @@
+import { _ as e, i as t, m as n, n as r, o as i, s as a, t as o } from "./record-CZVpq8vk.js";
+// src/observation/readonly-map.ts
+var s = 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 { s as ReadonlyMapSnapshot, r as SerialQueue, i as SnapshotPublisher, a as batchSnapshotNotifications, n as captureDataArray, t as captureLogger, o as normalizePlainRecord, e as onAbort };

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

@@ -0,0 +1,49 @@
+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';
+export type ChangeOperation = {
+    readonly kind: "install";
+    readonly installation: InstallationRecord;
+    readonly declaration: InstallationDeclaration;
+} | {
+    readonly kind: "update";
+    readonly installation: InstallationRecord;
+    readonly update: Readonly<{
+        plugin?: NormalizedPlugin;
+        configuration?: ConfigurationValue | undefined;
+        origin?: InstallationOrigin | undefined;
+    }>;
+} | {
+    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,EAIT,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;AAE5C,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,QAAQ,CAAC;QACxB,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,aAAa,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;QAC/C,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;KACzC,CAAC,CAAC;CACJ,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,9 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+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<{
+    readonly value: 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;AAK9D,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,CAiDnF;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;IAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAAA;CAAE,CAAC,CAkC7D"}

package/dist/composition/declarations.d.ts

@@ -0,0 +1,53 @@
+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;
+} & ([ConfigurationInputOf<Declaration>] extends [void] ? {
+    readonly configuration?: ConfigurationInputOf<Declaration>;
+} : {
+    readonly configuration: ConfigurationInputOf<Declaration>;
+});
+export type InstallationUpdate<Declaration extends AnyPlugin = AnyPlugin> = {
+    readonly plugin: Declaration;
+    readonly configuration?: ConfigurationInputOf<Declaration>;
+    readonly origin?: InstallationOrigin;
+} | {
+    readonly plugin?: never;
+    readonly configuration: ConfigurationInputOf<Declaration>;
+    readonly origin?: never;
+};
+export interface ChangeSet {
+    install<Declaration extends AnyPlugin>(plugin: Declaration, options: InstallationOptions<Declaration>): Installation<Declaration>;
+    update<Declaration extends AnyPlugin>(installation: Installation<Declaration>, update: InstallationUpdate<Declaration>): void;
+    remove<Declaration extends AnyPlugin>(installation: Installation<Declaration>): void;
+    group(id: string, parent?: Group): Group;
+    removeGroup(group: Group): void;
+}
+export interface InitialInstallation {
+    readonly id: string;
+    readonly plugin: AnyPlugin;
+    readonly configuration?: unknown;
+    readonly origin?: InstallationOrigin;
+    readonly groupId?: string;
+}
+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;AAG9D,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;IAuBnF,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,34 @@
+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 index: number;
+    readonly group: GroupNode | undefined;
+    readonly facade: Installation;
+    constructor(id: string, index: number, 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,MAAM;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IAPvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;gBAKnB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,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,82 @@
+import { InstallationGraph } from './installation-graph.js';
+import { InstallationDeclaration, InstallationRecord } from './installation.js';
+import { GroupNode } from './group.js';
+import { ConfigurationValue } from './configuration.js';
+import { InstallationOrigin } from './declarations.js';
+export type TransitionIntent = "change" | "start" | "stop";
+export interface BindingReport {
+    readonly installation: string;
+    readonly contract: string;
+    readonly optional: boolean;
+    readonly provider: string | undefined;
+}
+export interface ImpactReason {
+    readonly installation: string;
+    readonly kind: "installed" | "updated" | "removed" | "provider_changed" | "start" | "stop";
+    readonly contract?: string;
+    readonly provider?: string;
+    readonly previousProvider?: string;
+}
+export interface DeclarationSnapshot {
+    readonly pluginName: string;
+    readonly origin: InstallationOrigin | undefined;
+}
+export type PlanOperation = {
+    readonly kind: "install" | "update" | "remove";
+    readonly id: string;
+    readonly before: DeclarationSnapshot | undefined;
+    readonly after: DeclarationSnapshot | 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 describeBindings(graph: InstallationGraph, installations?: ReadonlyArray<InstallationRecord>): ReadonlyArray<BindingReport>;
+export declare function describeImpact(previous: InstallationGraph, candidate: InstallationGraph, affected: ReadonlySet<InstallationRecord>, direct: ReadonlyMap<InstallationRecord, ImpactReason["kind"]>): ReadonlyArray<ImpactReason>;
+export declare function describeDeclaration(declaration: InstallationDeclaration | undefined): DeclarationSnapshot | undefined;
+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":"AACA,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,CAuK7B"}

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"}

package/dist/composition/plugin.d.ts

@@ -0,0 +1,68 @@
+import { StandardJSONSchemaV1, StandardSchemaV1 } from '@standard-schema/spec';
+import { ExtensionPoint, OptionalService, Requirement, Service } from '../contracts/contracts.js';
+import { ContributionView, ContributionOperations } from '../contributions/contribution-store.js';
+import { LifetimeContext } from '../lifetime/lifetime.js';
+import { Logger } from '../contracts/logging.js';
+import { EventOperations } from '../events/event-hub.js';
+import { Awaitable } from '../contracts/resource.js';
+export type { Awaitable } from '../contracts/resource.js';
+export type Requirements = Readonly<Record<string, Requirement>>;
+export type Provisions = Readonly<Record<string, Extract<Requirement, {
+    readonly kind: "service";
+}>>>;
+type ServiceValue<T> = T extends Service<infer Value> ? Value : never;
+export type ResolvedRequirement<T> = T extends OptionalService<infer Value> ? Value | undefined : T extends Service<infer Value> ? Value : T extends ExtensionPoint<infer Value> ? ContributionView<Value> : never;
+export type ResolvedRequirements<T extends Requirements> = {
+    readonly [Key in keyof T]: ResolvedRequirement<T[Key]>;
+};
+export type ProvidedServices<T extends Provisions> = {
+    readonly [Key in keyof T]: ServiceValue<T[Key]>;
+};
+type SetupOutput<T extends Provisions> = keyof T extends never ? void : ProvidedServices<T>;
+interface PluginSchema<Input, Output> extends StandardSchemaV1<Input, Output> {
+    readonly "~standard": StandardSchemaV1.Props<Input, Output> & {
+        readonly jsonSchema?: StandardJSONSchemaV1.Converter;
+    };
+}
+export interface InstanceMetadata {
+    readonly hostName: string;
+    readonly installationId: string;
+    readonly pluginName: string;
+    readonly generation: number;
+    readonly groupId: string | undefined;
+}
+export interface PluginContext<T extends Requirements = Requirements> {
+    readonly dependencies: ResolvedRequirements<T>;
+    readonly lifetime: LifetimeContext;
+    readonly events: EventOperations;
+    readonly contributions: ContributionOperations;
+    readonly metadata: InstanceMetadata;
+    readonly logger: Logger;
+}
+export interface Plugin<Configuration = void, Requires extends Requirements = {}, Provides extends Provisions = {}, ConfigurationInput = Configuration> {
+    readonly name: string;
+    readonly configuration?: PluginSchema<ConfigurationInput, Configuration>;
+    readonly requires?: Requires;
+    readonly provides?: Provides;
+    readonly setup: (context: PluginContext<Requires>, configuration: Configuration) => Awaitable<SetupOutput<NoInfer<Provides>>>;
+}
+export interface AnyPlugin {
+    readonly name: string;
+    readonly configuration?: unknown;
+    readonly requires?: Requirements;
+    readonly provides?: Provisions;
+    readonly setup: (context: never, configuration: never) => unknown;
+}
+export type InstanceContext = Omit<PluginContext<{}>, "dependencies"> & {
+    readonly dependencies: Readonly<Record<string, unknown>>;
+};
+export interface NormalizedPlugin {
+    readonly name: string;
+    readonly configuration?: PluginSchema<unknown, unknown>;
+    readonly requires: Requirements;
+    readonly provides: Provisions;
+    readonly setup: (context: InstanceContext, configuration: unknown) => Awaitable<void | Readonly<Record<string, unknown>>>;
+}
+export declare function definePlugin<Configuration = void, Requires extends Requirements = {}, Provides extends Provisions = {}, ConfigurationInput = Configuration>(plugin: Plugin<Configuration, Requires, Provides, ConfigurationInput>): Plugin<NoInfer<Configuration>, NoInfer<Requires>, NoInfer<Provides>, NoInfer<ConfigurationInput>>;
+export declare function normalizePlugin(plugin: AnyPlugin): NormalizedPlugin;
+//# sourceMappingURL=plugin.d.ts.map

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

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