dougong 0.8.3 → 0.10.0

package/dist/composition/plugin.d.ts

@@ -0,0 +1,65 @@
+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;
+}
+declare const configurationInputBrand: unique symbol;
+export interface Plugin<Configuration = void, Requires extends Requirements = {}, Provides extends Provisions = {}, ConfigurationInput = Configuration> {
+    readonly [configurationInputBrand]?: (input: ConfigurationInput) => ConfigurationInput;
+    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 extends Omit<Plugin<unknown, Requirements, Provisions>, "configuration" | "setup" | typeof configurationInputBrand> {
+    readonly configuration?: unknown;
+    readonly setup: (context: never, configuration: never) => unknown;
+}
+export type InstanceContext = Omit<PluginContext<{}>, "dependencies"> & {
+    readonly dependencies: Readonly<Record<string, unknown>>;
+};
+export interface NormalizedPlugin extends Omit<Plugin<unknown, Requirements, Provisions>, "requires" | "provides" | "setup"> {
+    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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"}

package/dist/contracts/contract-registry.d.ts

@@ -0,0 +1,18 @@
+import { ContractIdentity, ContractKind } from './contracts.js';
+export declare class ContractRegistry {
+    #private;
+    assertKinds(kinds: ReadonlyMap<string, ContractKind>): void;
+    assertCompatible(contract: ContractIdentity): void;
+    remember(contract: ContractIdentity): void;
+    writer(candidateKinds: ReadonlyMap<string, ContractKind>): ContractRegistryWriter;
+    commit(kinds: ReadonlyMap<string, ContractKind>): void;
+}
+export declare class ContractRegistryWriter {
+    #private;
+    constructor(registry: ContractRegistry, candidateKinds: ReadonlyMap<string, ContractKind>);
+    remember(contract: ContractIdentity): void;
+    commit(): void;
+    discard(): void;
+}
+export declare function rememberContractKind(kinds: Map<string, ContractKind>, contract: ContractIdentity): void;
+//# sourceMappingURL=contract-registry.d.ts.map

package/dist/contracts/contract-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-registry.d.ts","sourceRoot":"","sources":["../../src/contracts/contract-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKrE,qBAAa,gBAAgB;;IAG3B,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAIpD,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB;IAI3C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;IAInC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAIxD,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;CAIhD;AAWD,qBAAa,sBAAsB;;gBAGrB,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAKzF,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;IAenC,MAAM;IAON,OAAO;CAGR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,QAAQ,EAAE,gBAAgB,QAGhG"}

package/dist/contracts/contracts.d.ts

@@ -0,0 +1,51 @@
+declare const contractBrand: unique symbol;
+declare const contractValueSlot: unique symbol;
+declare const optionalBrand: unique symbol;
+interface ContractValueSlot<T> {
+    readonly value: T;
+    readonly accept: (value: T) => void;
+}
+export type ContractKind = "service" | "extensionPoint" | "event";
+export interface ContractIdentity {
+    readonly id: string;
+    readonly kind: ContractKind;
+}
+interface ContractBrand {
+    readonly [contractBrand]: true;
+}
+interface Contract<T, Kind extends ContractKind> extends ContractIdentity, ContractBrand {
+    readonly kind: Kind;
+    readonly [contractValueSlot]: ContractValueSlot<T>;
+}
+interface ServiceIdentity extends ContractIdentity, ContractBrand {
+    readonly kind: "service";
+}
+interface ExtensionPointIdentity extends ContractIdentity, ContractBrand {
+    readonly kind: "extensionPoint";
+}
+export interface Service<T> extends Contract<T, "service"> {
+}
+export interface ExtensionPoint<T> extends Contract<T, "extensionPoint"> {
+}
+export interface Event<T> extends Contract<T, "event"> {
+}
+interface OptionalServiceIdentity {
+    readonly [optionalBrand]: true;
+    readonly kind: "optional";
+    readonly service: ServiceIdentity;
+}
+export interface OptionalService<T> extends OptionalServiceIdentity {
+    readonly service: Service<T>;
+    readonly [contractValueSlot]: ContractValueSlot<T>;
+}
+export type Requirement = ServiceIdentity | ExtensionPointIdentity | OptionalServiceIdentity;
+export type ContractValue<T> = T extends Contract<infer Value, ContractKind> ? Value : never;
+export declare function normalizeContract<T extends ContractIdentity>(value: T, expected?: ContractKind, message?: string): T;
+export declare function normalizeContract(value: unknown, expected?: ContractKind, message?: string): ContractIdentity;
+export declare function service<T>(id: string): Service<T>;
+export declare function event<T>(id: string): Event<T>;
+export declare function extensionPoint<T>(id: string): ExtensionPoint<T>;
+export declare function optional<T>(token: Service<T>): OptionalService<T>;
+export declare function normalizeRequirement(value: unknown, message?: string, optionalMessage?: string): Requirement;
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts/contracts.d.ts.map

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

package/dist/contracts/errors.d.ts

@@ -0,0 +1,93 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+export declare const lifetimeBusyCode = "BUSY";
+export declare const changeConflictCode = "CHANGE_CONFLICT";
+export declare const changeForeignCode = "CHANGE_FOREIGN";
+export declare const contractConflictCode = "CONTRACT_CONFLICT";
+export declare const contributionUnavailableCode = "CONTRIBUTION_UNAVAILABLE";
+export declare const eventBeforeCommitCode = "EVENT_BEFORE_COMMIT";
+export declare const groupConflictCode = "GROUP_CONFLICT";
+export declare const groupCycleCode = "GROUP_CYCLE";
+export declare const groupForeignCode = "GROUP_FOREIGN";
+export declare const groupMissingCode = "GROUP_MISSING";
+export declare const groupRemovedCode = "GROUP_REMOVED";
+export declare const hostBusyCode = "HOST_BUSY";
+export declare const hostQuarantinedCode = "HOST_QUARANTINED";
+export declare const installationConflictCode = "INSTALLATION_CONFLICT";
+export declare const installationForeignCode = "INSTALLATION_FOREIGN";
+export declare const installationRemovedCode = "INSTALLATION_REMOVED";
+export declare const lifetimeDisposedCode = "LIFETIME_DISPOSED";
+export declare const planConsumedCode = "PLAN_CONSUMED";
+export declare const planForeignCode = "PLAN_FOREIGN";
+export declare const planStaleCode = "PLAN_STALE";
+export declare const providesInvalidCode = "PROVIDES_INVALID";
+export declare const serviceConflictCode = "SERVICE_CONFLICT";
+export declare const serviceCycleCode = "SERVICE_CYCLE";
+export declare const serviceMissingCode = "SERVICE_MISSING";
+export declare const serviceUnavailableCode = "SERVICE_UNAVAILABLE";
+export declare const shutdownTimeoutCode = "SHUTDOWN_TIMEOUT";
+export declare const transitionFailedCode = "TRANSITION_FAILED";
+declare const detailKinds: {
+    readonly outcome: "outcome";
+    readonly phase: "text";
+    readonly installation: "text";
+    readonly contract: "text";
+    readonly dependencyPath: "path";
+    readonly affectedInstallations: "path";
+    readonly stateRevision: "revision";
+    readonly expectedRevision: "revision";
+};
+declare const outcomes: readonly ["rejected", "restored", "quarantined"];
+interface DetailValues {
+    readonly outcome: (typeof outcomes)[number];
+    readonly text: string;
+    readonly path: ReadonlyArray<string>;
+    readonly revision: number;
+}
+export type ErrorDetails = {
+    readonly [Field in keyof typeof detailKinds]?: DetailValues[(typeof detailKinds)[Field]];
+};
+export declare class DougongError<Code extends string = string> extends Error {
+    name: string;
+    readonly code: Code;
+    readonly details: ErrorDetails;
+    constructor(code: Code, message: string, options?: ErrorOptions & {
+        readonly details?: ErrorDetails;
+    });
+}
+export declare function quarantinedHost(revision: number): DougongError<"HOST_QUARANTINED">;
+export interface ErrorSnapshot {
+    readonly name: string;
+    readonly message: string;
+    readonly code?: string;
+    readonly stack?: string;
+    readonly cause?: ErrorSnapshot;
+    readonly error?: ErrorSnapshot;
+    readonly suppressed?: ErrorSnapshot;
+    readonly errors?: ReadonlyArray<ErrorSnapshot>;
+    readonly details?: ErrorDetails;
+    readonly fields?: Readonly<Record<string, string | ReadonlyArray<string>>>;
+    readonly issues?: ReadonlyArray<{
+        readonly message: string;
+        readonly path?: ReadonlyArray<string | number>;
+    }>;
+    readonly truncated?: true;
+}
+export declare class RecordedFailure extends Error {
+    #private;
+    readonly name = "RecordedFailure";
+    readonly code: string | undefined;
+    get snapshot(): ErrorSnapshot;
+    constructor(error: unknown, fields?: ReadonlyArray<string>);
+}
+export declare function isError(value: unknown): value is Error;
+export declare function normalizeFailure(error: unknown, code: string, message: string): Error;
+export declare function isCancellationReason(signal: AbortSignal, error: unknown): boolean;
+export declare class ConfigurationValidationError extends DougongError {
+    name: string;
+    readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+    constructor(issues: ReadonlyArray<StandardSchemaV1.Issue>, options?: ErrorOptions & {
+        readonly details?: ErrorDetails;
+    });
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/contracts/errors.d.ts.map

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

package/dist/contracts/logging.d.ts

@@ -0,0 +1,20 @@
+import { SynchronousResult } from '../internal/async-result.js';
+import { disposeSymbol, Disposable } from './resource.js';
+export interface Logger<Result = SynchronousResult<void>> {
+    readonly debug: (message: unknown, ...details: unknown[]) => Result;
+    readonly info: (message: unknown, ...details: unknown[]) => Result;
+    readonly warn: (message: unknown, ...details: unknown[]) => Result;
+    readonly error: (message: unknown, ...details: unknown[]) => Result;
+}
+export declare function captureLogger<Input extends Logger<unknown>>(value: Input): {
+    readonly [Level in keyof Logger]: (...arguments_: Parameters<Logger<unknown>[Level]>) => ReturnType<Input[Level]>;
+};
+export declare function captureLogger(value: unknown): Logger<unknown>;
+export declare function isLogger(value: unknown): value is Logger<unknown>;
+export declare class ScopedLogger implements Disposable {
+    #private;
+    readonly handle: Logger;
+    constructor(logger: Logger<unknown>, metadata: Readonly<Record<string, unknown>>);
+    [disposeSymbol](): void;
+}
+//# sourceMappingURL=logging.d.ts.map

package/dist/contracts/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/contracts/logging.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC/D,MAAM,WAAW,MAAM,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;IACpE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;IACnE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;IACnE,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;CACrE;AAED,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,CAAC,OAAO,CAAC,EACzD,KAAK,EAAE,KAAK,GACX;IACD,QAAQ,EAAE,KAAK,IAAI,MAAM,MAAM,GAAG,CAChC,GAAG,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAC9C,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;CAC9B,CAAC;AACF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAkB/D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAOjE;AAED,qBAAa,YAAa,YAAW,UAAU;;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAKpB;gBAKS,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIhF,CAAC,aAAa,CAAC;CAYhB"}

package/dist/contracts/resource.d.ts

@@ -0,0 +1,16 @@
+export type Awaitable<T> = T | PromiseLike<T>;
+export { assertPromiseRuntime, resolveDisposalSymbol, asyncDisposeSymbol, disposeSymbol, } from '../internal/disposal-runtime.js';
+export interface Disposable {
+    [Symbol.dispose](): void;
+}
+export interface AsyncDisposable {
+    [Symbol.asyncDispose](): PromiseLike<void>;
+}
+export type Resource = Disposable | AsyncDisposable;
+export interface Publication extends Disposable {
+    publish(): void;
+}
+export declare function markOwnedControlHandle<T extends Resource>(handle: T): T;
+export declare function claimResource(resource: Resource): () => void;
+export declare function captureDisposer(resource: Resource): () => Awaitable<void>;
+//# sourceMappingURL=resource.d.ts.map

package/dist/contracts/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/contracts/resource.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAE9C,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,GACd,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,eAAe,CAAC;AAEpD,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,OAAO,IAAI,IAAI,CAAC;CACjB;AAUD,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAGvE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAc5D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAmBzE"}

package/dist/contracts/status.d.ts

@@ -0,0 +1,3 @@
+export type HostStatus = "stopped" | "starting" | "running" | "changing" | "stopping" | "quarantined";
+export type InstallationState = "pending" | "stopped" | "running" | "changing" | "removed" | "quarantined";
+//# sourceMappingURL=status.d.ts.map

package/dist/contracts/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/contracts/status.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GACpB,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAC3B,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC"}

package/dist/contributions/contribution-store.d.ts

@@ -0,0 +1,51 @@
+import { ContractIdentity, ExtensionPoint, Requirement } from '../contracts/contracts.js';
+import { Lifetime, LifetimeOwnership } from '../lifetime/lifetime.js';
+import { ResolvedValue } from '../internal/async-result.js';
+import { disposeSymbol, Disposable, Publication, Awaitable } from '../contracts/resource.js';
+import { SnapshotView } from '../observation/snapshot-view.js';
+export interface Contribution<T> extends Disposable {
+    readonly update: (value: T) => void;
+}
+export interface ContributionView<T> extends SnapshotView<ReadonlyArray<string>> {
+    use<Result>(id: string, callback: (value: T) => Awaitable<Result>): Promise<ResolvedValue<Awaited<Result>>>;
+}
+export interface ContributionOperations {
+    add<T>(token: ExtensionPoint<T>, key: string, value: T, options?: LifetimeOwnership): Contribution<T>;
+}
+type ExtensionPointIdentity = Extract<Requirement, {
+    readonly kind: "extensionPoint";
+}>;
+declare class ContributionRecord<T> implements Publication {
+    #private;
+    readonly handle: Contribution<T>;
+    constructor(store: ContributionStore<T>, id: string, initialValue: T, owner: Lifetime, detachFromOwner: () => void);
+    publish(): void;
+    use<Result>(callback: (value: T) => Awaitable<Result>): Promise<ResolvedValue<Awaited<Result>>>;
+    update(value: T): void;
+    [disposeSymbol](): void;
+}
+export declare class ContributionStore<T> {
+    #private;
+    constructor(invalidate: (store: ContributionStore<unknown>) => void, report: (error: unknown) => void, releaseIfUnused: (store: ContributionStore<unknown>) => void);
+    stage(installationId: string, key: string, value: T, owner: Lifetime, remember?: () => void): Contribution<T>;
+    view(own: (resource: Disposable) => () => void, owner?: Lifetime): ContributionView<T>;
+    hostView(): ContributionView<T>;
+    use<Result>(id: string, callback: (value: T) => Awaitable<Result>): Promise<ResolvedValue<Awaited<Result>>>;
+    snapshot(): readonly string[];
+    subscribe(listener: () => void, own?: (resource: Disposable) => () => void): Disposable;
+    publishClaim(id: string, contribution: ContributionRecord<T>): void;
+    valueChanged(id: string, contribution: ContributionRecord<T>): void;
+    removeContribution(id: string, contribution: ContributionRecord<T>): void;
+    publishSnapshot(): void;
+}
+export declare class ContributionRegistry {
+    #private;
+    constructor(report: (error: unknown) => void);
+    get<T = unknown>(token: ExtensionPointIdentity): ContributionStore<T>;
+    view<T = unknown>(token: ExtensionPointIdentity, owner?: Lifetime): ContributionView<T>;
+    scope(owner: Lifetime, installationId: string, remember: (token: ContractIdentity) => void): ContributionOperations;
+    beginBatch(): void;
+    endBatch(): void;
+}
+export {};
+//# sourceMappingURL=contribution-store.d.ts.map

package/dist/contributions/contribution-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-store.d.ts","sourceRoot":"","sources":["../../src/contributions/contribution-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACL,aAAa,EAEb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,UAAU;IACjD,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9E,GAAG,CAAC,MAAM,EACR,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,GACxC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,CAAC,EACH,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,iBAAiB,GAC1B,YAAY,CAAC,CAAC,CAAC,CAAC;CACpB;AAED,KAAK,sBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAAC;AAuFxF,cAAM,kBAAkB,CAAC,CAAC,CAAE,YAAW,WAAW;;IAGhD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;gBAG/B,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,CAAC,EACf,KAAK,EAAE,QAAQ,EACf,eAAe,EAAE,MAAM,IAAI;IAO7B,OAAO;IAMP,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAQ/F,MAAM,CAAC,KAAK,EAAE,CAAC;IAYf,CAAC,aAAa,CAAC;CAYhB;AAED,qBAAa,iBAAiB,CAAC,CAAC;;gBAe5B,UAAU,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI,EACvD,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAChC,eAAe,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI;IAO9D,KAAK,CACH,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,QAAQ,EACf,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,YAAY,CAAC,CAAC,CAAC;IAoBlB,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC;IA4BtF,QAAQ,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI/B,GAAG,CAAC,MAAM,EACR,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,GACxC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAS1C,QAAQ;IAIR,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,MAAM,IAAI;IA4B1E,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAS5D,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAO5D,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAalE,eAAe;CAyChB;AAiDD,qBAAa,oBAAoB;;gBAMnB,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAI5C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAiBrE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAKvF,KAAK,CACH,KAAK,EAAE,QAAQ,EACf,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAC1C,sBAAsB;IAIzB,UAAU;IAKV,QAAQ;CA4BT"}

package/dist/events/event-hub.d.ts

@@ -0,0 +1,27 @@
+import { ContractIdentity, Event } from '../contracts/contracts.js';
+import { Lifetime, LifetimeOwnership } from '../lifetime/lifetime.js';
+import { disposeSymbol, Disposable, Publication } from '../contracts/resource.js';
+export type EventListener<T> = (payload: T) => unknown;
+export type EventArguments<T> = [T] extends [void] ? [payload?: T] : [payload: T];
+export interface EventOperations {
+    on<T>(token: Event<T>, listener: EventListener<T>, options?: LifetimeOwnership): Disposable;
+    emit<T>(token: Event<T>, ...payload: EventArguments<T>): Promise<void>;
+}
+declare class ListenerRegistration<T> implements Publication {
+    #private;
+    readonly handle: Disposable;
+    constructor(hub: EventHub, eventId: string, listener: EventListener<T>, owner: Lifetime, detach: () => void);
+    publish(): void;
+    invoke(payload: T): Promise<unknown>;
+    [disposeSymbol](): void;
+}
+export declare class EventHub {
+    #private;
+    scope(owner: Lifetime, remember: (token: ContractIdentity) => void): EventOperations;
+    stage<T>(eventId: string, listener: EventListener<T>, owner: Lifetime): Disposable;
+    add<T>(eventId: string, registration: ListenerRegistration<T>): void;
+    delete<T>(eventId: string, registration: ListenerRegistration<T>): void;
+    emit<T>(eventId: string, payload: T): Promise<void>;
+}
+export {};
+//# sourceMappingURL=event-hub.d.ts.map

package/dist/events/event-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-hub.d.ts","sourceRoot":"","sources":["../../src/events/event-hub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEjG,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EACL,aAAa,EAEb,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC;AACvD,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC;IAC5F,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AASD,cAAM,oBAAoB,CAAC,CAAC,CAAE,YAAW,WAAW;;IAGlD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;gBAG1B,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,IAAI;IASpB,OAAO;IAMP,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpC,CAAC,aAAa,CAAC;CAOhB;AAmDD,qBAAa,QAAQ;;IAGnB,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,eAAe;IAIpF,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU;IAKlF,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAM7D,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAO1D,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB1D"}

package/dist/execution/engine.d.ts

@@ -0,0 +1,27 @@
+import { Service, OptionalService, ExtensionPoint } from '../contracts/contracts.js';
+import { ResolvedValue } from '../internal/async-result.js';
+import { Plan } from '../composition/plan.js';
+import { ApplyResult, HostOptions } from './host-api.js';
+import { ChangeSet, Group, Installation } from '../composition/declarations.js';
+import { HostStatus } from '../contracts/status.js';
+import { HostSnapshot } from '../inspection/diagnostics.js';
+import { Awaitable } from '../contracts/resource.js';
+export declare class Engine {
+    #private;
+    readonly name: string;
+    constructor(options?: HostOptions);
+    get status(): HostStatus;
+    get stateRevision(): number;
+    get diagnostics(): import('../index.js').SnapshotView<HostSnapshot>;
+    installation(id: string): Installation | undefined;
+    group(id: string): Group | undefined;
+    explain(id: string): readonly import('../index.js').BindingReport[];
+    change(): ChangeSet;
+    plan(change: ChangeSet, signal?: AbortSignal): Promise<Plan>;
+    apply(plan: Plan): Promise<ApplyResult>;
+    start(): Promise<ApplyResult>;
+    stop(): Promise<ApplyResult>;
+    use<T, Result>(requirement: Service<T> | OptionalService<T>, callback: (value: T | undefined) => Awaitable<Result>): Promise<ResolvedValue<Awaited<Result>>>;
+    contributions<T>(point: ExtensionPoint<T>): import('../index.js').ContributionView<T>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/execution/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/execution/engine.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAY/E,OAAO,EAGL,KAAK,IAAI,EAEV,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,YAAY,EAEb,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,8BAA8B,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAiE1D,qBAAa,MAAM;;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAkBV,OAAO,GAAE,WAAgB;IA0ErC,IAAI,MAAM,IAAI,UAAU,CAEvB;IACD,IAAI,aAAa,WAEhB;IACD,IAAI,WAAW,qDAEd;IAED,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIlD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC,OAAO,CAAC,EAAE,EAAE,MAAM;IAMlB,MAAM,IAAI,SAAS;IAcb,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkClE,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAMvC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAG7B,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAI5B,GAAG,CAAC,CAAC,EAAE,MAAM,EACX,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAC5C,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,SAAS,CAAC,MAAM,CAAC,GACpD,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IA2B1C,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;CAmoB1C"}

package/dist/execution/host-api.d.ts

@@ -0,0 +1,49 @@
+import { ChangeSet, Group, Installation, InitialInstallation } from '../composition/declarations.js';
+import { HostStatus } from '../contracts/status.js';
+import { Logger } from '../contracts/logging.js';
+import { Service, OptionalService, ExtensionPoint } from '../contracts/contracts.js';
+import { ContributionView } from '../contributions/contribution-store.js';
+import { SnapshotView } from '../observation/snapshot-view.js';
+import { HostSnapshot } from '../inspection/diagnostics.js';
+import { Awaitable } from '../contracts/resource.js';
+import { Plan, BindingReport } from '../composition/plan.js';
+import { AnyPlugin } from '../composition/plugin.js';
+import { ResolvedValue } from '../internal/async-result.js';
+export interface HostOptions<Declarations extends ReadonlyArray<AnyPlugin> = ReadonlyArray<AnyPlugin>> {
+    readonly name?: string;
+    readonly installations?: {
+        readonly [Index in keyof Declarations]: {
+            readonly plugin: Declarations[Index];
+        } & NoInfer<InitialInstallation<Declarations[Index]>>;
+    };
+    readonly groups?: ReadonlyArray<{
+        readonly id: string;
+        readonly parentId?: string;
+    }>;
+    readonly logger?: Logger;
+    readonly onError?: (error: unknown) => Awaitable<void>;
+    readonly shutdownTimeoutMilliseconds?: number;
+}
+export interface ApplyResult {
+    readonly stateRevision: number;
+    readonly affectedInstallations: ReadonlyArray<string>;
+}
+export interface Host {
+    readonly name: string;
+    readonly status: HostStatus;
+    readonly stateRevision: number;
+    readonly diagnostics: SnapshotView<HostSnapshot>;
+    change(): ChangeSet;
+    plan(change: ChangeSet, signal?: AbortSignal): Promise<Plan>;
+    apply(plan: Plan): Promise<ApplyResult>;
+    start(): Promise<ApplyResult>;
+    stop(): Promise<ApplyResult>;
+    use<T, Result>(service: Service<T>, callback: (value: T) => Awaitable<Result>): Promise<ResolvedValue<Awaited<Result>>>;
+    use<T, Result>(service: OptionalService<T>, callback: (value: T | undefined) => Awaitable<Result>): Promise<ResolvedValue<Awaited<Result>>>;
+    contributions<T>(point: ExtensionPoint<T>): ContributionView<T>;
+    installation(id: string): Installation | undefined;
+    group(id: string): Group | undefined;
+    explain(installationId: string): ReadonlyArray<BindingReport>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=host-api.d.ts.map

package/dist/execution/host-api.d.ts.map

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

package/dist/execution/host.d.ts

@@ -0,0 +1,4 @@
+import { Host, HostOptions } from './host-api.js';
+import { AnyPlugin } from '../composition/plugin.js';
+export declare function createHost<const Declarations extends ReadonlyArray<AnyPlugin>>(options?: HostOptions<Declarations>): Host;
+//# sourceMappingURL=host.d.ts.map

package/dist/execution/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/execution/host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,wBAAgB,UAAU,CAAC,KAAK,CAAC,YAAY,SAAS,aAAa,CAAC,SAAS,CAAC,EAC5E,OAAO,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,GAClC,IAAI,CA6BN"}

package/dist/execution/instance.d.ts

@@ -0,0 +1,34 @@
+import { ContractRegistryWriter } from '../contracts/contract-registry.js';
+import { Logger } from '../contracts/logging.js';
+import { EventHub } from '../events/event-hub.js';
+import { ContributionRegistry } from '../contributions/contribution-store.js';
+import { Lifetime, ReleaseFailure } from '../lifetime/lifetime.js';
+import { InstallationRecord, InstallationDeclaration } from '../composition/installation.js';
+import { Awaitable } from '../contracts/resource.js';
+export interface InstanceEnvironment {
+    readonly hostName: string;
+    readonly logger: Logger<unknown>;
+    readonly report: (error: unknown) => void;
+    readonly releaseFailed: (failure: ReleaseFailure) => void;
+    readonly changed: () => void;
+    readonly events: EventHub;
+    readonly contributions: ContributionRegistry;
+    readonly contracts: ContractRegistryWriter;
+    readonly startupSignal: AbortSignal;
+    readonly shutdownTimeoutMilliseconds: number | undefined;
+}
+export declare class Instance {
+    #private;
+    readonly installation: InstallationRecord;
+    readonly declaration: InstallationDeclaration;
+    readonly generation: number;
+    private readonly environment;
+    readonly lifetime: Lifetime;
+    constructor(installation: InstallationRecord, declaration: InstallationDeclaration, generation: number, environment: InstanceEnvironment);
+    prepare(dependencies: Readonly<Record<string, unknown>>, configuration: unknown): Promise<void>;
+    read(serviceId: string): unknown;
+    use<T, Result>(serviceId: string, callback: (value: T) => Awaitable<Result>): Promise<import('../index.js').ResolvedValue<Awaited<Result>>>;
+    publish(): void;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=instance.d.ts.map

package/dist/execution/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/execution/instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAGlG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1D;AAED,qBAAa,QAAQ;;IAKjB,QAAQ,CAAC,YAAY,EAAE,kBAAkB;IACzC,QAAQ,CAAC,WAAW,EAAE,uBAAuB;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAP9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAIjB,YAAY,EAAE,kBAAkB,EAChC,WAAW,EAAE,uBAAuB,EACpC,UAAU,EAAE,MAAM,EACV,WAAW,EAAE,mBAAmB;IAc7C,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO;IAmDrF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMhC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC;IAI3E,OAAO;IAKD,OAAO;CAOd"}

package/dist/index.d.ts

@@ -1,4 +1,19 @@
-export * from '@dougongjs/core';
-export * from '@dougongjs/platform';
-export { batch, computed, observe, signal, type ObservationOwner, type ObservationTask, type Observer, type Readable, type ReadonlySignal, type Signal, } from '@dougongjs/reactive';
+export { service, extensionPoint, event, optional, type ContractKind, type ContractValue, type Service, type ExtensionPoint, type Event, type OptionalService, type Requirement, } from './contracts/contracts.js';
+export { createHost } from './execution/host.js';
+export type { Host, HostOptions, ApplyResult } from './execution/host-api.js';
+export type { HostStatus, InstallationState } from './contracts/status.js';
+export type { ResolvedValue } from './internal/async-result.js';
+export type { ChangeSet, Group, Installation, InstallationOptions, InstallationArguments, InstallationUpdate, InstallationOrigin, InitialInstallation, } from './composition/declarations.js';
+export { definePlugin, type Plugin, type AnyPlugin, type PluginContext, type Requirements, type Provisions, type ResolvedRequirement, type ResolvedRequirements, type ProvidedServices, type InstanceMetadata, } from './composition/plugin.js';
+export { captureConfiguration, type ConfigurationValue } from './composition/configuration.js';
+export { describePlugin, type PluginDescriptor, type PluginConfigurationDescriptor, type PluginDescriptionOptions, } from './composition/plugin-description.js';
+export type { Plan, PlanReport, BindingReport, ImpactReason, PlanOperation, DeclarationSnapshot, } from './composition/plan.js';
+export type { HostSnapshot, InstallationSnapshot, GroupSnapshot, } from './inspection/diagnostics.js';
+export type { SnapshotView } from './observation/snapshot-view.js';
+export type { LifetimeContext, ChildLifetime, LifetimeOwnership, Task, Cleanup, BackgroundTask, LifetimePhase, LifetimeSnapshot, UnresolvedObligation, } from './lifetime/lifetime.js';
+export type { Contribution, ContributionView, ContributionOperations, } from './contributions/contribution-store.js';
+export type { EventListener, EventOperations, EventArguments } from './events/event-hub.js';
+export { isLogger, type Logger } from './contracts/logging.js';
+export { DougongError, ConfigurationValidationError, RecordedFailure, isError, isCancellationReason, type ErrorSnapshot, type ErrorDetails, } from './contracts/errors.js';
+export { disposeSymbol, asyncDisposeSymbol, type Disposable, type AsyncDisposable, type Resource, type Awaitable, } from './contracts/resource.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,EACN,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,MAAM,GACZ,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,cAAc,EACd,KAAK,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EACV,SAAS,EACT,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EACL,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,GAC9B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,IAAI,EACJ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,IAAI,EACJ,OAAO,EACP,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,4BAA4B,EAC5B,eAAe,EACf,OAAO,EACP,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,SAAS,GACf,MAAM,yBAAyB,CAAC"}