@dougongjs/core 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Dougong contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,18 @@
+# @dougongjs/core
+
+能力组合与结构化生命周期内核。
+
+- `Service` 稳定的一对一能力，依赖通过 `requires` 显式声明
+- `Extension` 可动态增减的开放贡献集合
+- `Event` 不保留状态的瞬时事实
+- `Lifetime` 监听、贡献、任务与资源的结构化所有权
+- `Application` / `ChangeSet` 事务化的安装图，失败回滚或 fail closed
+
+不使用 Service Locator、环境作用域、原型链注入或 Proxy。运行时依赖只有 `@standard-schema/spec`。
+
+- 文档站：https://tangerg.github.io/dougong/
+- 仓库：https://github.com/Tangerg/dougong
+
+> 早期开发阶段（0.0.x），当前不承诺向后兼容。需要 Node.js >= 22 或等价的 ES2024 宿主。
+
+MIT

package/dist/application-api.d.ts

@@ -0,0 +1,51 @@
+import { ApplicationSnapshot, ApplicationStatus } from './diagnostics';
+import { Logger } from './lifetime';
+import { InstallationStatus } from './plugin-installation';
+import { PluginDefinition, Provisions, Requirements } from './plugin';
+import { Service } from './contracts';
+import { SnapshotView } from './snapshot-view';
+export type PluginUpdate<Config, Requires extends Requirements = Requirements, Provides extends Provisions = Provisions, ConfigInput = Config> = {
+    readonly plugin: PluginDefinition<Config, Requires, Provides, ConfigInput>;
+    readonly config?: ConfigInput;
+} | {
+    readonly plugin?: never;
+    readonly config: ConfigInput;
+};
+export interface InstallationHandle {
+    readonly id: string;
+    readonly status: InstallationStatus;
+    ready(): Promise<void>;
+    remove(): Promise<void>;
+}
+export interface PluginHandle<Config = unknown, Requires extends Requirements = Requirements, Provides extends Provisions = Provisions, ConfigInput = Config> extends InstallationHandle {
+    readonly groupId: string;
+    update(update: PluginUpdate<Config, Requires, Provides, ConfigInput>): Promise<void>;
+}
+export interface PluginChangeSet {
+    install<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(plugin: PluginDefinition<Config, Requires, Provides, ConfigInput>, ...config: [ConfigInput] extends [void] ? [config?: ConfigInput] : [config: ConfigInput]): PluginHandle<Config, Requires, Provides, ConfigInput>;
+    update<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(handle: PluginHandle<Config, Requires, Provides, ConfigInput>, update: PluginUpdate<Config, Requires, Provides, ConfigInput>): this;
+    remove<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(handle: PluginHandle<Config, Requires, Provides, ConfigInput>): this;
+    commit(): Promise<void>;
+}
+export interface CreateAppOptions {
+    readonly name?: string;
+    readonly logger?: Logger;
+    readonly onError?: (error: unknown) => void;
+}
+export interface PluginContainer {
+    install<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(plugin: PluginDefinition<Config, Requires, Provides, ConfigInput>, ...config: [ConfigInput] extends [void] ? [config?: ConfigInput] : [config: ConfigInput]): PluginHandle<Config, Requires, Provides, ConfigInput>;
+    change(): PluginChangeSet;
+    group(name: string, configure: (group: PluginGroup) => void): PluginGroup;
+}
+export interface PluginGroup extends PluginContainer, InstallationHandle {
+    readonly name: string;
+}
+export interface Application extends PluginContainer {
+    readonly name: string;
+    readonly status: ApplicationStatus;
+    readonly diagnostics: SnapshotView<ApplicationSnapshot>;
+    get<T>(token: Service<T>): T;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=application-api.d.ts.map

package/dist/application-api.d.ts.map

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

package/dist/application-runtime.d.ts

@@ -0,0 +1,36 @@
+import { Service } from './contracts';
+import { Logger } from './lifetime';
+import { PluginGraph } from './plugin-graph';
+import { PluginInstallation } from './plugin-installation';
+export type RuntimeChangeOutcome = {
+    readonly kind: "committed";
+    readonly affected: ReadonlySet<PluginInstallation>;
+} | {
+    readonly kind: "rolled-back";
+    readonly affected: ReadonlySet<PluginInstallation>;
+    readonly error: unknown;
+};
+interface ApplicationRuntimeOptions {
+    readonly applicationName: string;
+    readonly logger: Logger;
+    readonly isInstalled: (installationId: string) => boolean;
+    readonly report: (error: unknown) => void;
+}
+type ServiceAvailability = "available" | "unavailable";
+/**
+ * Owns the committed plugin runtime: contracts, services, events, extensions,
+ * Lifetimes and graph transitions. The Application owns declarations and
+ * command serialization; neither side duplicates the other's state.
+ */
+export declare class ApplicationRuntime {
+    #private;
+    constructor(options: ApplicationRuntimeOptions);
+    get hasCommittedPlan(): boolean;
+    get<T>(token: Service<T>, availability: ServiceAvailability): T;
+    buildPlan(installations: Iterable<PluginInstallation>): PluginGraph;
+    start(plan: PluginGraph): Promise<void>;
+    stop(): Promise<unknown[]>;
+    transition(nextPlan: PluginGraph, changed: ReadonlySet<PluginInstallation>, restoreDeclarations: () => void): Promise<RuntimeChangeOutcome>;
+}
+export {};
+//# sourceMappingURL=application-runtime.d.ts.map

package/dist/application-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime.d.ts","sourceRoot":"","sources":["../src/application-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8C,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAIvF,OAAO,EAA+B,KAAK,MAAM,EAAmB,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAkB,KAAK,kBAAkB,EAAsB,MAAM,uBAAuB,CAAC;AAIpG,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAA;CAAE,GAClF;IACE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAQN,UAAU,yBAAyB;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C;AAED,KAAK,mBAAmB,GAAG,WAAW,GAAG,aAAa,CAAC;AAIvD;;;;GAIG;AACH,qBAAa,kBAAkB;;gBAajB,OAAO,EAAE,yBAAyB;IAQ9C,IAAI,gBAAgB,YAEnB;IAED,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,mBAAmB,GAAG,CAAC;IAc/D,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IAI/C,KAAK,CAAC,IAAI,EAAE,WAAW;IAYvB,IAAI;IAQJ,UAAU,CACd,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,WAAW,CAAC,kBAAkB,CAAC,EACxC,mBAAmB,EAAE,MAAM,IAAI,GAC9B,OAAO,CAAC,oBAAoB,CAAC;CA8ajC"}

package/dist/application.d.ts

@@ -0,0 +1,6 @@
+import { Application, CreateAppOptions } from './application-api';
+export type { InstallationStatus } from './plugin-installation';
+export type { ApplicationSnapshot, ApplicationStatus, GroupSnapshot, PluginSnapshot, } from './diagnostics';
+export type { Application, CreateAppOptions, InstallationHandle, PluginChangeSet, PluginContainer, PluginGroup, PluginHandle, PluginUpdate, } from './application-api';
+export declare function createApp(options?: CreateAppOptions): Application;
+//# sourceMappingURL=application.d.ts.map

package/dist/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAKjB,MAAM,mBAAmB,CAAC;AAuB3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,mBAAmB,CAAC;AAid3B,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAEjE"}

package/dist/change-set.d.ts

@@ -0,0 +1,51 @@
+import { PluginChangeSet, PluginHandle, PluginUpdate } from './application-api';
+import { AnyPlugin, PluginInstallation } from './plugin-installation';
+import { PluginDefinition, Provisions, Requirements } from './plugin';
+type PluginDeclarationUpdate = {
+    readonly kind: "plugin";
+    readonly plugin: AnyPlugin;
+} | {
+    readonly kind: "config";
+    readonly config: unknown;
+} | {
+    readonly kind: "plugin-and-config";
+    readonly plugin: AnyPlugin;
+    readonly config: unknown;
+};
+export type PluginChangeOperation = {
+    readonly kind: "install";
+    readonly installation: PluginInstallation;
+} | {
+    readonly kind: "update";
+    readonly installation: PluginInstallation;
+    readonly declaration: PluginDeclarationUpdate;
+} | {
+    readonly kind: "remove";
+    readonly installation: PluginInstallation;
+};
+interface PluginChangeHost {
+    create(plugin: AnyPlugin, config: unknown): {
+        readonly installation: PluginInstallation;
+        readonly handle: object;
+    };
+    resolve(handle: object): PluginInstallation;
+    execute(operations: ReadonlyArray<PluginChangeOperation>): Promise<void>;
+    attach(installation: PluginInstallation): void;
+    discard(installation: PluginInstallation, error: unknown): void;
+}
+export declare function discardPluginChangeSetDraft(draft: PluginChangeSetDraft, error: unknown): void;
+/**
+ * Rich one-shot draft for the canonical mutation path. It owns target
+ * uniqueness, handle authority, sealing and commit idempotency before the
+ * application ever sees a candidate graph.
+ */
+export declare class PluginChangeSetDraft implements PluginChangeSet {
+    #private;
+    constructor(host: PluginChangeHost);
+    install<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(plugin: PluginDefinition<Config, Requires, Provides, ConfigInput>, ...config: [ConfigInput] extends [void] ? [config?: ConfigInput] : [config: ConfigInput]): PluginHandle<Config, Requires, Provides, ConfigInput>;
+    update<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(handle: PluginHandle<Config, Requires, Provides, ConfigInput>, update: PluginUpdate<Config, Requires, Provides, ConfigInput>): this;
+    remove<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(handle: PluginHandle<Config, Requires, Provides, ConfigInput>): this;
+    commit(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=change-set.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"change-set.d.ts","sourceRoot":"","sources":["../src/change-set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAEnG,KAAK,uBAAuB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACrD;IACE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAA;CAAE,GACvE;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;CAC/C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE3E,UAAU,gBAAgB;IACxB,MAAM,CACJ,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,OAAO,GACd;QACD,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;QAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC5C,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/C,OAAO,CAAC,YAAY,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACjE;AAUD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,QAEtF;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,eAAe;;gBAI9C,IAAI,EAAE,gBAAgB;IAMlC,OAAO,CAAC,MAAM,EAAE,QAAQ,SAAS,YAAY,EAAE,QAAQ,SAAS,UAAU,EAAE,WAAW,EACrF,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,EACjE,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GACvF,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;IAQxD,MAAM,CAAC,MAAM,EAAE,QAAQ,SAAS,YAAY,EAAE,QAAQ,SAAS,UAAU,EAAE,WAAW,EACpF,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,EAC7D,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;IAgC/D,MAAM,CAAC,MAAM,EAAE,QAAQ,SAAS,YAAY,EAAE,QAAQ,SAAS,UAAU,EAAE,WAAW,EACpF,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;IAO/D,MAAM;CAwEP"}

package/dist/contract-registry.d.ts

@@ -0,0 +1,19 @@
+import { ContractIdentity, ContractKind } from './contracts';
+/** Application-wide identity registry with an explicit draft commit boundary. */
+export declare class ContractRegistry {
+    #private;
+    get kinds(): ReadonlyMap<string, ContractKind>;
+    assertCompatible(contract: ContractIdentity): void;
+    remember(contract: ContractIdentity): void;
+    draft(candidateKinds: ReadonlyMap<string, ContractKind>): ContractRegistryDraft;
+    commit(kinds: ReadonlyMap<string, ContractKind>): void;
+}
+export declare class ContractRegistryDraft {
+    #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/contract-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-registry.d.ts","sourceRoot":"","sources":["../src/contract-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGlE,iFAAiF;AACjF,qBAAa,gBAAgB;;IAG3B,IAAI,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAE7C;IAED,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB;IAI3C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;IAInC,KAAK,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAIvD,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;CAIhD;AAYD,qBAAa,qBAAqB;;gBAGpB,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.d.ts

@@ -0,0 +1,30 @@
+declare const contractType: unique symbol;
+export type ContractKind = "service" | "extension" | "event";
+export interface ContractIdentity {
+    readonly id: string;
+    readonly kind: ContractKind;
+}
+interface Contract<T, K extends ContractKind> extends ContractIdentity {
+    readonly kind: K;
+    readonly [contractType]?: T;
+}
+export interface Service<T> extends Contract<T, "service"> {
+}
+export interface Extension<T> extends Contract<T, "extension"> {
+}
+export interface Event<T> extends Contract<T, "event"> {
+}
+export interface OptionalService<T> {
+    readonly kind: "optional";
+    readonly service: Service<T>;
+}
+export type Requirement<T = unknown> = Service<T> | Extension<T> | OptionalService<T>;
+export type ContractValue<T> = T extends Contract<infer Value, ContractKind> ? Value : never;
+export declare function isContract(value: unknown, expected?: ContractKind): value is ContractIdentity;
+export declare function assertContract(value: unknown, expected?: ContractKind): asserts value is ContractIdentity;
+export declare function service<T>(id: string): Service<T>;
+export declare function event<T>(id: string): Event<T>;
+export declare function extension<T>(id: string): Extension<T>;
+export declare function optional<T>(token: Service<T>): OptionalService<T>;
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY,EAAE,OAAO,MAAwC,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAED,UAAU,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,YAAY,CAAE,SAAQ,gBAAgB;IACpE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC;CAAG;AAC7D,MAAM,WAAW,SAAS,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC;CAAG;AACjE,MAAM,WAAW,KAAK,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;CAAG;AAEzD,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AAEtF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,KAAK,EAAE,YAAY,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;AAgB7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,KAAK,IAAI,gBAAgB,CAY7F;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAGnC;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAEjD;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAE7C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAErD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAKjE"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,35 @@
+import { GroupNode } from './group';
+import { LifetimeSnapshot } from './lifetime';
+import { PluginInstallation, InstallationStatus } from './plugin-installation';
+import { SnapshotView } from './snapshot-view';
+export type ApplicationStatus = "idle" | "starting" | "active" | "changing" | "stopping";
+export interface PluginSnapshot {
+    readonly id: string;
+    readonly name: string;
+    readonly groupId: string;
+    readonly status: InstallationStatus;
+    readonly requires: ReadonlyArray<string>;
+    readonly provides: ReadonlyArray<string>;
+    readonly lifetime?: SnapshotView<LifetimeSnapshot>;
+    readonly error?: unknown;
+}
+export interface GroupSnapshot {
+    readonly id: string;
+    readonly name: string;
+    readonly parentId?: string;
+}
+export interface ApplicationSnapshot {
+    readonly name: string;
+    readonly status: ApplicationStatus;
+    readonly revision: number;
+    readonly plugins: ReadonlyMap<string, PluginSnapshot>;
+    readonly groups: ReadonlyMap<string, GroupSnapshot>;
+}
+/** Immutable operational read model; never a service locator or control plane. */
+export declare class ApplicationDiagnostics {
+    #private;
+    readonly view: SnapshotView<ApplicationSnapshot>;
+    constructor(name: string, groups: Iterable<GroupNode>, report: (error: unknown) => void);
+    publish(status: ApplicationStatus, installations: Iterable<PluginInstallation>, groups: Iterable<GroupNode>): void;
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACrD;AAED,kFAAkF;AAClF,qBAAa,sBAAsB;;IAMjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;gBAErC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAOvF,OAAO,CACL,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAC3C,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;CAqD9B"}

package/dist/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class DougongError extends Error {
+    readonly code: string;
+    name: string;
+    constructor(code: string, message: string, options?: ErrorOptions);
+}
+/** Preserves Error values and classifies non-Error rejection reasons. */
+export declare function normalizeFailure(error: unknown, code: string, message: string): Error;
+export interface ValidationIssue {
+    readonly message: string;
+    readonly path?: ReadonlyArray<PropertyKey | {
+        readonly key: PropertyKey;
+    }>;
+}
+export declare class ConfigValidationError extends DougongError {
+    name: string;
+    readonly issues: ReadonlyArray<ValidationIssue>;
+    constructor(issues: ReadonlyArray<ValidationIssue>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;aAInB,IAAI,EAAE,MAAM;IAHrB,IAAI,SAAkB;gBAGb,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAIzB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAErF;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,GAAG;QAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,qBAAa,qBAAsB,SAAQ,YAAY;IAC5C,IAAI,SAA2B;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;gBAEpC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC;CAyBnD"}

package/dist/event-hub.d.ts

@@ -0,0 +1,10 @@
+import { Disposable, Publication, StagedResource } from './resource';
+export type EventListener<T> = (payload: T) => unknown;
+export declare class EventHub {
+    #private;
+    stage<T>(eventId: string, listener: EventListener<T>, release: (publication: Publication) => void): StagedResource<Disposable>;
+    add<T>(eventId: string, listener: EventListener<T>): void;
+    delete<T>(eventId: string, listener: EventListener<T>): void;
+    emit<T>(eventId: string, payload: T): Promise<void>;
+}
+//# sourceMappingURL=event-hub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-hub.d.ts","sourceRoot":"","sources":["../src/event-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC;AAqEvD,qBAAa,QAAQ;;IAGnB,KAAK,CAAC,CAAC,EACL,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,GAC1C,cAAc,CAAC,UAAU,CAAC;IAK7B,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAMlD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAO/C,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;CAa1C"}

package/dist/extension-store.d.ts

@@ -0,0 +1,46 @@
+import { Extension } from './contracts';
+import { Disposable, Publication, StagedResource } from './resource';
+import { SnapshotView } from './snapshot-view';
+export interface Contribution<T> extends Disposable {
+    update(value: T): void;
+}
+export type ExtensionView<T> = SnapshotView<ReadonlyMap<string, T>>;
+export type ExtensionLeaseKind = "view" | "subscription";
+declare class ContributionRecord<T> implements StagedResource<Contribution<T>> {
+    #private;
+    readonly handle: Contribution<T>;
+    constructor(store: ExtensionStore<T>, id: string, initialValue: T, detachFromOwner: (publication: Publication) => void);
+    publish(): void;
+    update(value: T): void;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare class ExtensionStore<T> {
+    #private;
+    constructor(invalidate: (store: ExtensionStore<unknown>) => void, report: (error: unknown) => void, releaseIfUnused: (store: ExtensionStore<unknown>) => void);
+    stage(ownerId: string, key: string, value: T, release: (publication: Publication) => void): ContributionRecord<T>;
+    view(own: (resource: Disposable, kind: ExtensionLeaseKind) => () => void): ExtensionView<T>;
+    snapshot(): ReadonlyMap<string, T>;
+    subscribe(listener: () => void, own: (resource: Disposable, kind: ExtensionLeaseKind) => () => void): ExtensionSubscription<T>;
+    insert(id: string, contribution: ContributionRecord<T>, value: T): void;
+    update(id: string, contribution: ContributionRecord<T>, value: T): void;
+    removeContribution(id: string, contribution: ContributionRecord<T>, visibility: "staged" | "published"): void;
+    publishSnapshot(): void;
+    removeListener(listener: () => void): void;
+}
+declare class ExtensionSubscription<T> implements Disposable {
+    #private;
+    constructor(store: ExtensionStore<T>, listener: () => void, release: () => void);
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+export declare class ExtensionRegistry {
+    #private;
+    constructor(report: (error: unknown) => void);
+    get<T>(token: Extension<T>): ExtensionStore<T>;
+    beginBatch(): void;
+    endBatch(): void;
+}
+export type ExtensionRequirementView<T> = T extends Extension<infer Value> ? ExtensionView<Value> : never;
+export {};
+//# sourceMappingURL=extension-store.d.ts.map

package/dist/extension-store.d.ts.map

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

package/dist/group-coordinator.d.ts

@@ -0,0 +1,46 @@
+import { PluginGroup, PluginHandle } from './application-api';
+import { PluginChangeSetDraft, PluginChangeOperation } from './change-set';
+import { GroupConfigurationSession, GroupNode } from './group';
+import { AnyPlugin, InstallationStatus, PluginInstallation } from './plugin-installation';
+import { PluginDefinition, Provisions, Requirements } from './plugin';
+export interface GroupCoordinatorHost {
+    installations(): Iterable<PluginInstallation>;
+    createDraft(group: GroupNode, plugin: AnyPlugin, config: unknown): {
+        readonly installation: PluginInstallation;
+        readonly handle: object;
+    };
+    resolveHandle(handle: object): PluginInstallation;
+    executeChanges(operations: ReadonlyArray<PluginChangeOperation>): Promise<void>;
+    attachInstallation(installation: PluginInstallation): void;
+    discardInstallation(installation: PluginInstallation, error: unknown): void;
+    runExclusive(operation: () => Promise<void>): Promise<void>;
+    removeInstallations(operations: ReadonlyArray<PluginChangeOperation>): Promise<void>;
+    notifyChanged(): void;
+}
+declare class PluginGroupImpl implements PluginGroup {
+    #private;
+    constructor(coordinator: GroupCoordinator, node: GroupNode, configuration?: GroupConfigurationSession<PluginChangeSetDraft>);
+    get id(): string;
+    get name(): string;
+    get status(): InstallationStatus;
+    ready(): Promise<void>;
+    install<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(plugin: PluginDefinition<Config, Requires, Provides, ConfigInput>, ...config: [ConfigInput] extends [void] ? [config?: ConfigInput] : [config: ConfigInput]): PluginHandle<Config, Requires, Provides, ConfigInput>;
+    change(): PluginChangeSetDraft;
+    group(name: string, configure: (group: PluginGroup) => void): PluginGroupImpl;
+    remove(): Promise<void>;
+}
+/** Owns the complete structural Group model and compiles it to plugin changes. */
+export declare class GroupCoordinator {
+    #private;
+    readonly root: GroupNode;
+    constructor(rootName: string, host: GroupCoordinatorHost);
+    nodes(): GroupNode[];
+    install<Config, Requires extends Requirements, Provides extends Provisions, ConfigInput>(group: GroupNode, plugin: PluginDefinition<Config, Requires, Provides, ConfigInput>, ...config: [ConfigInput] extends [void] ? [config?: ConfigInput] : [config: ConfigInput]): PluginHandle<Config, Requires, Provides, ConfigInput>;
+    change(group: GroupNode, tracking?: "immediate" | "deferred"): PluginChangeSetDraft;
+    create(parent: GroupNode, name: string, configure: (group: PluginGroup) => void, inherited?: GroupConfigurationSession<PluginChangeSetDraft>): PluginGroupImpl;
+    ready(group: GroupNode): Promise<void>;
+    status(group: GroupNode): InstallationStatus;
+    remove(group: GroupNode): Promise<void>;
+}
+export {};
+//# sourceMappingURL=group-coordinator.d.ts.map

package/dist/group-coordinator.d.ts.map

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

package/dist/group-lifecycle.d.ts

@@ -0,0 +1,19 @@
+import { DougongError } from './errors';
+import { GroupNode } from './group';
+import { InstallationStatus } from './plugin-installation';
+/**
+ * Owns the readiness barrier for one structural Group node. A failed mutation
+ * cannot poison an established Group because transactions expose only the
+ * restored committed state.
+ */
+export declare class GroupLifecycle {
+    #private;
+    readonly node: GroupNode;
+    constructor(node: GroupNode, initialState: "new" | "established", notifyChanged: () => void);
+    status(contents: InstallationStatus): InstallationStatus;
+    ready(readyContents: () => Promise<void>): Promise<void>;
+    track(operation: Promise<void>): void;
+    release(): void;
+}
+export declare function groupRemovedError(group: GroupNode): DougongError;
+//# sourceMappingURL=group-lifecycle.d.ts.map

package/dist/group-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-lifecycle.d.ts","sourceRoot":"","sources":["../src/group-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;GAIG;AACH,qBAAa,cAAc;;IAKvB,QAAQ,CAAC,IAAI,EAAE,SAAS;gBAAf,IAAI,EAAE,SAAS,EACxB,YAAY,EAAE,KAAK,GAAG,aAAa,EACnC,aAAa,EAAE,MAAM,IAAI;IAM3B,MAAM,CAAC,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB;IAQlD,KAAK,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAU9C,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC;IAwC9B,OAAO;CASR;AAaD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,gBAEjD"}

package/dist/group.d.ts

@@ -0,0 +1,31 @@
+/** One explicit transaction shared by every nested Group configure callback. */
+export declare class GroupConfigurationSession<Draft> {
+    #private;
+    constructor(draft: Draft, discard: (draft: Draft, error: unknown) => void, normalize: (error: unknown) => Error);
+    get failure(): Error | undefined;
+    requireDraft(): Draft;
+    assertOpen(): void;
+    fail(error: unknown): Error;
+    seal(): Draft;
+    discard(error: unknown): void;
+}
+/**
+ * A Group is an ownership tree over installations, never a capability scope.
+ * Service resolution and Extension/Event visibility remain application-wide.
+ */
+export declare class GroupNode {
+    #private;
+    readonly id: string;
+    readonly name: string;
+    private constructor();
+    static root(name: string): GroupNode;
+    get attached(): boolean;
+    get children(): ReadonlyArray<GroupNode>;
+    get parent(): GroupNode | undefined;
+    create(name: string): GroupNode;
+    containsId(candidateId: string): boolean;
+    assertAttached(): void;
+    detach(): void;
+    walk(): GroupNode[];
+}
+//# sourceMappingURL=group.d.ts.map

package/dist/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../src/group.ts"],"names":[],"mappings":"AAeA,gFAAgF;AAChF,qBAAa,yBAAyB,CAAC,KAAK;;gBAIxC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,EAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK;IAKtC,IAAI,OAAO,sBAEV;IAED,YAAY;IAOZ,UAAU;IAIV,IAAI,CAAC,KAAK,EAAE,OAAO;IAcnB,IAAI;IAQJ,OAAO,CAAC,KAAK,EAAE,OAAO;CAOvB;AAUD;;;GAGG;AACH,qBAAa,SAAS;;IAKlB,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFvB,OAAO;IAQP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM;IAIxB,IAAI,QAAQ,YAEX;IAED,IAAI,QAAQ,IAAI,aAAa,CAAC,SAAS,CAAC,CAEvC;IAED,IAAI,MAAM,IAAI,SAAS,GAAG,SAAS,CAGlC;IAED,MAAM,CAAC,IAAI,EAAE,MAAM;IAWnB,UAAU,CAAC,WAAW,EAAE,MAAM;IAM9B,cAAc;IAMd,MAAM;IASN,IAAI;CAYL"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { event, extension, optional, service, type ContractKind, type ContractValue, type Event, type Extension, type OptionalService, type Requirement, type Service, } from './contracts';
+export { createApp, type Application, type ApplicationSnapshot, type ApplicationStatus, type CreateAppOptions, type GroupSnapshot, type InstallationHandle, type PluginChangeSet, type PluginContainer, type PluginGroup, type PluginHandle, type PluginSnapshot, type InstallationStatus, type PluginUpdate, } from './application';
+export { definePlugin, type Awaitable, type PluginContext, type PluginDefinition, type ProvidedServices, type Provisions, type Requirements, type ResolvedRequirement, type ResolvedRequirements, } from './plugin';
+export { type BackgroundTask, type Cleanup, type LifetimeContext, type LifetimeOperations, type LifetimePhase, type LifetimeSnapshot, type Logger, type PluginMeta, type Task, } from './lifetime';
+export type { Contribution, ExtensionView } from './extension-store';
+export type { EventListener } from './event-hub';
+export { ConfigValidationError, DougongError } from './errors';
+export type { Disposable } from './resource';
+export { ReadonlyMapSnapshot } from './readonly-map';
+export { SerialQueue } from './serial-queue';
+export { SnapshotPublisher, type SnapshotView } from './snapshot-view';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,SAAS,EACT,QAAQ,EACR,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,OAAO,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,IAAI,GACV,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC"}