@dougongjs/core 0.0.1

package/dist/lifetime-diagnostics.d.ts

@@ -0,0 +1,36 @@
+import { SnapshotView } from './snapshot-view';
+export type LifetimePhase = "active" | "disposing" | "disposed";
+/** Immutable projection of one real Lifetime ownership node. */
+export interface LifetimeSnapshot {
+    readonly label: string;
+    readonly phase: LifetimePhase;
+    readonly cleanups: number;
+    readonly tasks: number;
+    readonly listeners: number;
+    readonly contributions: number;
+    readonly extensionViews: number;
+    readonly subscriptions: number;
+    readonly children: ReadonlyArray<LifetimeSnapshot>;
+}
+export type LifetimeResourceKind = "cleanups" | "tasks" | "listeners" | "contributions" | "extensionViews" | "subscriptions";
+/** Internal state that mirrors a Lifetime without retaining any owned resource. */
+export interface LifetimeDiagnosticNode {
+    readonly label: string;
+    readonly counts: Record<LifetimeResourceKind, number>;
+    readonly children: Set<LifetimeDiagnosticNode>;
+    phase: LifetimePhase;
+}
+/** Publishes immutable data snapshots for one root Lifetime ownership tree. */
+export declare class LifetimeDiagnostics {
+    #private;
+    readonly root: LifetimeDiagnosticNode;
+    readonly view: SnapshotView<LifetimeSnapshot>;
+    constructor(rootLabel: string, report: (error: unknown) => void);
+    createNode(label: string): LifetimeDiagnosticNode;
+    attach(parent: LifetimeDiagnosticNode, child: LifetimeDiagnosticNode): void;
+    detach(parent: LifetimeDiagnosticNode, child: LifetimeDiagnosticNode): void;
+    change(node: LifetimeDiagnosticNode, kind: LifetimeResourceKind, delta: 1 | -1): void;
+    beginDisposing(node: LifetimeDiagnosticNode): void;
+    finishRoot(): void;
+}
+//# sourceMappingURL=lifetime-diagnostics.d.ts.map

package/dist/lifetime-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifetime-diagnostics.d.ts","sourceRoot":"","sources":["../src/lifetime-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAEhE,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,oBAAoB,GAC9B,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE5F,mFAAmF;AACnF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC/C,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,+EAA+E;AAC/E,qBAAa,mBAAmB;;IAG9B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;gBAElC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAM/D,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,KAAK,EAAE,sBAAsB;IAMpE,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,KAAK,EAAE,sBAAsB;IAKpE,MAAM,CAAC,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IAO9E,cAAc,CAAC,IAAI,EAAE,sBAAsB;IAM3C,UAAU;CAMX"}

package/dist/lifetime.d.ts

@@ -0,0 +1,77 @@
+import { Event, Extension } from './contracts';
+import { Contribution, ExtensionLeaseKind } from './extension-store';
+import { EventListener } from './event-hub';
+import { LifetimeDiagnostics, LifetimeDiagnosticNode } from './lifetime-diagnostics';
+import { Disposable, Publication, StagedResource } from './resource';
+export type { LifetimePhase, LifetimeSnapshot } from './lifetime-diagnostics';
+export interface Logger {
+    debug(message: unknown, ...details: unknown[]): void;
+    info(message: unknown, ...details: unknown[]): void;
+    warn(message: unknown, ...details: unknown[]): void;
+    error(message: unknown, ...details: unknown[]): void;
+}
+export interface PluginMeta {
+    readonly applicationName: string;
+    readonly pluginName: string;
+    readonly installationId: string;
+    readonly groupId: string;
+}
+export interface Task<T = void> extends Disposable {
+    readonly result: Promise<T>;
+}
+export type Cleanup = () => unknown;
+export type BackgroundTask<T> = (signal: AbortSignal) => T | PromiseLike<T>;
+export interface LifetimeOperations {
+    readonly signal: AbortSignal;
+    cleanup(dispose: Cleanup): Disposable;
+    lifetime(label: string): LifetimeContext;
+    spawn<T>(task: BackgroundTask<T>): Task<T>;
+    on<T>(token: Event<T>, listener: EventListener<T>): Disposable;
+    emit<T>(token: Event<T>, payload: T): Promise<void>;
+    contribute<T>(token: Extension<T>, key: string, value: T): Contribution<T>;
+}
+export interface LifetimeContext extends LifetimeOperations, Disposable {
+}
+export interface LifetimeHost {
+    stageOn<T>(ownerId: string, token: Event<T>, listener: EventListener<T>, release: (publication: Publication) => void): StagedResource<Disposable>;
+    emit<T>(ownerId: string, token: Event<T>, payload: T): Promise<void>;
+    stageContribution<T>(ownerId: string, token: Extension<T>, key: string, value: T, release: (publication: Publication) => void): StagedResource<Contribution<T>>;
+    report(error: unknown): void;
+}
+interface LifetimeOptions {
+    readonly parentSignal?: AbortSignal;
+    readonly declarations?: "staged" | "published";
+    readonly parent?: {
+        readonly detach: (lifetime: Lifetime) => void;
+        readonly diagnostics: LifetimeDiagnostics;
+        readonly diagnosticNode: LifetimeDiagnosticNode;
+    };
+}
+declare class CleanupRecord implements Disposable {
+    #private;
+    constructor(cleanup: Cleanup, detachFromParent: (resource: Disposable) => void);
+    dispose(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export declare class Lifetime implements LifetimeContext {
+    #private;
+    readonly handle: LifetimeContext;
+    constructor(host: LifetimeHost, ownerId: string, options?: LifetimeOptions);
+    get signal(): AbortSignal;
+    get diagnostics(): import('./snapshot-view').SnapshotView<import('./lifetime-diagnostics').LifetimeSnapshot>;
+    cleanup(dispose: Cleanup): CleanupRecord;
+    lifetime(label: string): LifetimeContext;
+    spawn<T>(task: BackgroundTask<T>): Task<T>;
+    on<T>(token: Event<T>, listener: EventListener<T>): Disposable;
+    emit<T>(token: Event<T>, payload: T): Promise<void>;
+    contribute<T>(token: Extension<T>, key: string, value: T): Contribution<T>;
+    /** Owns an internal live capability without exposing a second Context API. */
+    ownLease(resource: Disposable, kind: ExtensionLeaseKind): () => boolean;
+    /** Releases a temporary startup cancellation edge after its layer commits. */
+    detachStartupSignal(): void;
+    /** Atomically makes all declarations staged during setup visible. */
+    publish(): void;
+    dispose(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=lifetime.d.ts.map

package/dist/lifetime.d.ts.map

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

package/dist/plugin-graph.d.ts

@@ -0,0 +1,17 @@
+import { ContractKind } from './contracts';
+import { PluginInstallation } from './plugin-installation';
+/** Immutable validated dependency plan over one application-wide capability graph. */
+export declare class PluginGraph {
+    #private;
+    readonly order: ReadonlyArray<PluginInstallation>;
+    readonly layers: ReadonlyArray<ReadonlyArray<PluginInstallation>>;
+    readonly providers: ReadonlyMap<string, PluginInstallation>;
+    readonly dependents: ReadonlyMap<PluginInstallation, ReadonlySet<PluginInstallation>>;
+    readonly contractKinds: ReadonlyMap<string, ContractKind>;
+    private constructor();
+    static build(source: Iterable<PluginInstallation>, committedKinds: ReadonlyMap<string, ContractKind>): PluginGraph;
+    providerFor(installation: PluginInstallation, serviceId: string): PluginInstallation | undefined;
+    provider(serviceId: string): PluginInstallation | undefined;
+    affectedByTransitionTo(other: PluginGraph, changed: ReadonlySet<PluginInstallation>): Set<PluginInstallation>;
+}
+//# sourceMappingURL=plugin-graph.d.ts.map

package/dist/plugin-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-graph.d.ts","sourceRoot":"","sources":["../src/plugin-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,sFAAsF;AACtF,qBAAa,WAAW;;IAOpB,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;IAL3D,OAAO;IAWP,MAAM,CAAC,KAAK,CACV,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACpC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAsBnD,WAAW,CAAC,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM;IAI/D,QAAQ,CAAC,SAAS,EAAE,MAAM;IAI1B,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,kBAAkB,CAAC;CAmBpF"}

package/dist/plugin-installation.d.ts

@@ -0,0 +1,44 @@
+import { Lifetime } from './lifetime';
+import { PluginDefinition, Provisions, Requirements } from './plugin';
+import { GroupNode } from './group';
+export type InstallationStatus = "pending" | "active" | "stopping" | "failed" | "removed";
+export type AnyPlugin = PluginDefinition<unknown, Requirements, Provisions, unknown>;
+export interface InstallationSpec {
+    readonly plugin: AnyPlugin;
+    readonly config: unknown;
+}
+export interface PluginRuntime {
+    readonly plugin: AnyPlugin;
+    readonly config: unknown;
+    readonly lifetime: Lifetime;
+}
+export declare function createInstallationSpec(plugin: AnyPlugin, config: unknown): InstallationSpec;
+/**
+ * A plugin installation is a stable identity whose declaration and runtime may
+ * change. State transitions and ready waiters live here so orchestration code
+ * cannot create a status that disagrees with the owned runtime.
+ */
+export declare class PluginInstallation {
+    #private;
+    readonly id: string;
+    readonly index: number;
+    readonly groupId: string;
+    constructor(id: string, index: number, group: GroupNode, spec: InstallationSpec);
+    attach(notifyChanged: () => void): void;
+    get status(): "failed" | "active" | "removed" | "pending" | "stopping";
+    get runtime(): PluginRuntime | undefined;
+    get error(): Error | undefined;
+    get group(): GroupNode;
+    get spec(): InstallationSpec;
+    reconfigure(spec: InstallationSpec): void;
+    ready(): Promise<void>;
+    trackReadiness(operation: Promise<void>): void;
+    activate(runtime: PluginRuntime): void;
+    settleReady(): void;
+    beginStopping(): boolean;
+    deactivate(): void;
+    fail(error: unknown): void;
+    discard(error: unknown): void;
+    remove(): void;
+}
+//# sourceMappingURL=plugin-installation.d.ts.map

package/dist/plugin-installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-installation.d.ts","sourceRoot":"","sources":["../src/plugin-installation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1F,MAAM,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAErF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAE3F;AAiCD;;;;GAIG;AACH,qBAAa,kBAAkB;;IAa3B,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM;IATxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAQd,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACtB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,gBAAgB;IAMxB,MAAM,CAAC,aAAa,EAAE,MAAM,IAAI;IAMhC,IAAI,MAAM,6DAET;IAED,IAAI,OAAO,8BAGV;IAED,IAAI,KAAK,sBAWR;IAED,IAAI,KAAK,cAER;IAED,IAAI,IAAI,qBAEP;IAED,WAAW,CAAC,IAAI,EAAE,gBAAgB;IAIlC,KAAK;IAML,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC;IAoCvC,QAAQ,CAAC,OAAO,EAAE,aAAa;IAI/B,WAAW;IAkBX,aAAa;IAOb,UAAU;IAIV,IAAI,CAAC,KAAK,EAAE,OAAO;IAInB,OAAO,CAAC,KAAK,EAAE,OAAO;IAuBtB,MAAM;CAwBP"}

package/dist/plugin.d.ts

@@ -0,0 +1,30 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { Extension, OptionalService, Requirement, Service } from './contracts';
+import { ExtensionRequirementView } from './extension-store';
+import { LifetimeOperations, Logger, PluginMeta } from './lifetime';
+import { Awaitable } from './resource';
+export type { Awaitable } from './resource';
+export type Requirements = Readonly<Record<string, Requirement>>;
+export type Provisions = Readonly<Record<string, Service<unknown>>>;
+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 Extension<unknown> ? ExtensionRequirementView<T> : 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>;
+export type PluginContext<T extends Requirements = Requirements> = LifetimeOperations & ResolvedRequirements<T> & {
+    readonly meta: PluginMeta;
+    readonly log: Logger;
+};
+export interface PluginDefinition<Config = void, Requires extends Requirements = {}, Provides extends Provisions = {}, ConfigInput = Config> {
+    readonly name: string;
+    readonly config?: StandardSchemaV1<ConfigInput, Config>;
+    readonly requires?: Requires;
+    readonly provides?: Provides;
+    readonly setup: (context: PluginContext<Requires>, config: Config) => Awaitable<SetupOutput<NoInfer<Provides>>>;
+}
+export declare function definePlugin<Config = void, Requires extends Requirements = {}, Provides extends Provisions = {}, ConfigInput = Config>(definition: PluginDefinition<Config, Requires, Provides, ConfigInput>): PluginDefinition<Config, Requires, Provides, ConfigInput>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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

package/dist/readonly-map.d.ts

@@ -0,0 +1,14 @@
+/** A structural snapshot that exposes no mutating Map methods. */
+export declare class ReadonlyMapSnapshot<Key, Value> implements ReadonlyMap<Key, Value> {
+    #private;
+    constructor(values?: ReadonlyMap<Key, Value> | Iterable<readonly [Key, Value]>);
+    get size(): number;
+    get(key: Key): Value | undefined;
+    has(key: Key): boolean;
+    forEach(callback: (value: Value, key: Key, map: ReadonlyMap<Key, Value>) => void, thisArg?: unknown): void;
+    entries(): MapIterator<[Key, Value]>;
+    keys(): MapIterator<Key>;
+    values(): MapIterator<Value>;
+    [Symbol.iterator](): MapIterator<[Key, Value]>;
+}
+//# sourceMappingURL=readonly-map.d.ts.map

package/dist/readonly-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-map.d.ts","sourceRoot":"","sources":["../src/readonly-map.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,qBAAa,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAE,YAAW,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC;;gBAGjE,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAK9E,IAAI,IAAI,WAEP;IAED,GAAG,CAAC,GAAG,EAAE,GAAG;IAIZ,GAAG,CAAC,GAAG,EAAE,GAAG;IAIZ,OAAO,CACL,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,IAAI,EACxE,OAAO,CAAC,EAAE,OAAO;IAKnB,OAAO;IAIP,IAAI;IAIJ,MAAM;IAIN,CAAC,MAAM,CAAC,QAAQ,CAAC;CAGlB"}

package/dist/resource.d.ts

@@ -0,0 +1,13 @@
+export type Awaitable<T> = T | PromiseLike<T>;
+export interface Disposable {
+    dispose(): void | Promise<void>;
+    [Symbol.dispose]?(): void;
+    [Symbol.asyncDispose]?(): Promise<void>;
+}
+export interface Publication extends Disposable {
+    publish(): void;
+}
+export interface StagedResource<T extends Disposable> extends Publication {
+    readonly handle: T;
+}
+//# sourceMappingURL=resource.d.ts.map

package/dist/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC;IAC1B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,WAAW;IACvE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACpB"}

package/dist/serial-queue.d.ts

@@ -0,0 +1,7 @@
+/** Serial execution where each caller keeps its own result and failures do not poison the tail. */
+export declare class SerialQueue {
+    #private;
+    get settled(): Promise<void>;
+    run<T>(operation: () => T | PromiseLike<T>): Promise<T>;
+}
+//# sourceMappingURL=serial-queue.d.ts.map

package/dist/serial-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-queue.d.ts","sourceRoot":"","sources":["../src/serial-queue.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,qBAAa,WAAW;;IAGtB,IAAI,OAAO,kBAEV;IAED,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAWxD"}

package/dist/snapshot-view.d.ts

@@ -0,0 +1,15 @@
+import { Disposable } from './resource';
+export interface SnapshotView<T> {
+    get(): T;
+    subscribe(listener: () => void): Disposable;
+}
+/** Synchronous writer for immutable operational snapshots. */
+export declare class SnapshotPublisher<T> implements Disposable {
+    #private;
+    constructor(read: () => T, report: (error: unknown) => void);
+    readonly view: SnapshotView<T>;
+    invalidate(): void;
+    dispose(): void;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=snapshot-view.d.ts.map

package/dist/snapshot-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-view.d.ts","sourceRoot":"","sources":["../src/snapshot-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,GAAG,IAAI,CAAC,CAAC;IACT,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;CAC7C;AAoBD,8DAA8D;AAC9D,qBAAa,iBAAiB,CAAC,CAAC,CAAE,YAAW,UAAU;;gBAMzC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAU3D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAG3B;IAEH,UAAU;IAYV,OAAO;IAcP,CAAC,MAAM,CAAC,OAAO,CAAC;CAgCjB"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@dougongjs/core",
+  "version": "0.0.1",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.0.0"
+  },
+  "description": "Capability composition and structured lifetime kernel for JavaScript/TypeScript.",
+  "license": "MIT",
+  "author": "Dougong contributors",
+  "homepage": "https://tangerg.github.io/dougong/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Tangerg/dougong.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/Tangerg/dougong/issues"
+  },
+  "keywords": [
+    "plugin",
+    "plugin-system",
+    "dependency-injection",
+    "lifetime",
+    "service-container",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build"
+  }
+}