@codefast/di 0.5.0-canary.5 → 0.5.0-canary.7

package/dist/introspection/inspector.js

@@ -0,0 +1,82 @@
+import { effectiveBindingScope } from "#/resolution/binding-scope";
+import { selectBinding } from "#/resolution/binding-select";
+import { tokenName } from "#/token";
+// ── Inspector ─────────────────────────────────────────────────────────────────
+/**
+ * @since 0.3.16-canary.0
+ */
+export class Inspector {
+    #registry;
+    #scope;
+    #hasParent;
+    #isDisposed;
+    constructor(registry, scope, hasParent, isDisposed) {
+        this.#registry = registry;
+        this.#scope = scope;
+        this.#hasParent = hasParent;
+        this.#isDisposed = isDisposed;
+    }
+    inspect() {
+        const snapshots = this.allBindingSnapshots();
+        return {
+            ownBindings: snapshots,
+            cachedSingletonCount: this.#scope.getAllSingletons().size,
+            hasParent: this.#hasParent,
+            isDisposed: this.#isDisposed(),
+        };
+    }
+    lookupBindings(token) {
+        const bindings = this.#registry.getAll(token);
+        return bindings.map((binding) => this.#toSnapshot(binding));
+    }
+    has(token, options, parentHas) {
+        const bindings = this.#registry.getAll(token);
+        if (bindings.length > 0) {
+            if (options !== undefined) {
+                if (selectBinding(bindings, options, this.#makeConstraintContext(options), tokenName(token)) !== undefined) {
+                    return true;
+                }
+            }
+            else {
+                return true;
+            }
+        }
+        return parentHas?.() ?? false;
+    }
+    hasOwn(token, options) {
+        const bindings = this.#registry.getAll(token);
+        if (bindings.length === 0) {
+            return false;
+        }
+        if (options !== undefined) {
+            return selectBinding(bindings, options, this.#makeConstraintContext(options), tokenName(token)) !== undefined;
+        }
+        return true;
+    }
+    #makeConstraintContext(options) {
+        return {
+            resolutionPath: [],
+            resolutionStack: [],
+            parent: undefined,
+            ancestors: [],
+            currentResolveOptions: options,
+        };
+    }
+    allBindingSnapshots() {
+        return this.#registry.allBindings().map((binding) => this.#toSnapshot(binding));
+    }
+    #toSnapshot(binding) {
+        const scope = effectiveBindingScope(binding);
+        const slot = binding.slot.name !== undefined
+            ? { name: binding.slot.name, tags: binding.slot.tags }
+            : { tags: binding.slot.tags };
+        return {
+            tokenName: tokenName(binding.token),
+            kind: binding.kind,
+            scope,
+            slot,
+            id: binding.id,
+        };
+    }
+}
+//# sourceMappingURL=inspector.js.map

package/dist/introspection/inspector.js.map

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

package/dist/metadata/{metadata-keys.d.mts → metadata-keys.d.ts}

@@ -1,16 +1,15 @@
-//#region src/metadata/metadata-keys.d.ts
 /**
  * @since 0.3.16-canary.0
  */
-declare const INJECTABLE_KEY: unique symbol;
+export declare const INJECTABLE_KEY: unique symbol;
 /**
  * @since 0.3.16-canary.0
  */
-declare const LIFECYCLE_KEY: unique symbol;
+export declare const LIFECYCLE_KEY: unique symbol;
 /**
  * @since 0.3.16-canary.0
  */
-declare const INJECT_ACCESSOR_KEY: unique symbol;
+export declare const INJECT_ACCESSOR_KEY: unique symbol;
 /**
  * The well-known symbol used by TC39 Stage 3 decorator transforms to store class metadata.
  *
@@ -22,6 +21,5 @@ declare const INJECT_ACCESSOR_KEY: unique symbol;
  *
  * @since 0.3.16-canary.0
  */
-declare const METADATA_SYMBOL: symbol;
-//#endregion
-export { INJECTABLE_KEY, INJECT_ACCESSOR_KEY, LIFECYCLE_KEY, METADATA_SYMBOL };
+export declare const METADATA_SYMBOL: symbol;
+//# sourceMappingURL=metadata-keys.d.ts.map

package/dist/metadata/metadata-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-keys.d.ts","sourceRoot":"","sources":["../../src/metadata/metadata-keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,MAAgC,CAAC;AACrE;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,MAA+B,CAAC;AACnE;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,MAAqC,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,MAAyD,CAAC"}

package/dist/metadata/metadata-keys.js

@@ -0,0 +1,25 @@
+/**
+ * @since 0.3.16-canary.0
+ */
+export const INJECTABLE_KEY = Symbol("di:injectable");
+/**
+ * @since 0.3.16-canary.0
+ */
+export const LIFECYCLE_KEY = Symbol("di:lifecycle");
+/**
+ * @since 0.3.16-canary.0
+ */
+export const INJECT_ACCESSOR_KEY = Symbol("di:inject-accessor");
+/**
+ * The well-known symbol used by TC39 Stage 3 decorator transforms to store class metadata.
+ *
+ * `Symbol.metadata` is defined natively once the runtime ships the full TC39 decorator
+ * proposal.  Until then (current Node.js / browsers), Babel and esbuild both fall back to
+ * `Symbol.for("Symbol.metadata")` — a global-registry symbol with the same string key.
+ * Resolving it here once keeps the reader and the decorator transforms in sync regardless
+ * of which path is taken.
+ *
+ * @since 0.3.16-canary.0
+ */
+export const METADATA_SYMBOL = Symbol.metadata ?? Symbol.for("Symbol.metadata");
+//# sourceMappingURL=metadata-keys.js.map

package/dist/metadata/metadata-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-keys.js","sourceRoot":"","sources":["../../src/metadata/metadata-keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB,MAAM,CAAC,eAAe,CAAC,CAAC;AACrE;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AACnE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/metadata/metadata-reader-token.d.ts

@@ -0,0 +1,7 @@
+import type { MetadataReader } from "#/metadata/metadata-types";
+import type { Token } from "#/token";
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare const MetadataReaderToken: Token<MetadataReader>;
+//# sourceMappingURL=metadata-reader-token.d.ts.map

package/dist/metadata/metadata-reader-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-reader-token.d.ts","sourceRoot":"","sources":["../../src/metadata/metadata-reader-token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,cAAc,CAA2C,CAAC"}

package/dist/metadata/metadata-reader-token.js

@@ -0,0 +1,6 @@
+import { token } from "#/token";
+/**
+ * @since 0.3.16-canary.0
+ */
+export const MetadataReaderToken = token("MetadataReader");
+//# sourceMappingURL=metadata-reader-token.js.map

package/dist/metadata/metadata-reader-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-reader-token.js","sourceRoot":"","sources":["../../src/metadata/metadata-reader-token.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA0B,KAAK,CAAiB,gBAAgB,CAAC,CAAC"}

package/dist/metadata/metadata-types.d.ts

@@ -0,0 +1,48 @@
+import type { InjectionDescriptor } from "#/decorators/inject";
+import type { Token } from "#/token";
+import type { Constructor } from "#/types";
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface ParamMetadata {
+    readonly index: number;
+    readonly token: Token<unknown> | Constructor;
+    readonly optional: boolean;
+    readonly multi: boolean;
+    readonly name?: string;
+    readonly tags?: ReadonlyArray<readonly [string, unknown]>;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface ConstructorMetadata {
+    readonly params: ReadonlyArray<ParamMetadata>;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface LifecycleMetadata {
+    readonly postConstruct: ReadonlyArray<string>;
+    readonly preDestroy: ReadonlyArray<string>;
+}
+/**
+ * Mutable buckets used while aggregating decorator metadata (same keys as {@link LifecycleMetadata}).
+ *
+ * @since 0.3.16-canary.0
+ */
+export interface MutableLifecycleMetadata {
+    postConstruct: Array<string>;
+    preDestroy: Array<string>;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface MetadataReader {
+    getConstructorMetadata(target: Constructor): ConstructorMetadata | undefined;
+    getLifecycleMetadata(target: Constructor): LifecycleMetadata | undefined;
+    getAccessorMetadata?(target: Constructor): ReadonlyArray<{
+        readonly key: string | symbol;
+        readonly descriptor: InjectionDescriptor;
+    }> | undefined;
+}
+//# sourceMappingURL=metadata-types.d.ts.map

package/dist/metadata/metadata-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-types.d.ts","sourceRoot":"","sources":["../../src/metadata/metadata-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC7E,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACzE,mBAAmB,CAAC,CAClB,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CAC3G"}

package/dist/metadata/metadata-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metadata-types.js.map

package/dist/metadata/metadata-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-types.js","sourceRoot":"","sources":["../../src/metadata/metadata-types.ts"],"names":[],"mappings":""}

package/dist/metadata/symbol-metadata-reader.d.ts

@@ -0,0 +1,20 @@
+import type { InjectionDescriptor } from "#/decorators/inject";
+import type { ConstructorMetadata, LifecycleMetadata, MetadataReader } from "#/metadata/metadata-types";
+import type { Constructor } from "#/types";
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare class SymbolMetadataReader implements MetadataReader {
+    #private;
+    getConstructorMetadata(target: Constructor): ConstructorMetadata | undefined;
+    getLifecycleMetadata(target: Constructor): LifecycleMetadata | undefined;
+    getAccessorMetadata(target: Constructor): Array<{
+        key: string | symbol;
+        descriptor: InjectionDescriptor;
+    }> | undefined;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare const defaultMetadataReader: SymbolMetadataReader;
+//# sourceMappingURL=symbol-metadata-reader.d.ts.map

package/dist/metadata/symbol-metadata-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-metadata-reader.d.ts","sourceRoot":"","sources":["../../src/metadata/symbol-metadata-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;;IAazD,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAG3E;IAED,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAGvE;IAED,mBAAmB,CACjB,MAAM,EAAE,WAAW,GAClB,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,UAAU,EAAE,mBAAmB,CAAA;KAAE,CAAC,GAAG,SAAS,CAK9E;CACF;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,sBAA6B,CAAC"}

package/dist/metadata/symbol-metadata-reader.js

@@ -0,0 +1,34 @@
+import { INJECT_ACCESSOR_KEY, INJECTABLE_KEY, LIFECYCLE_KEY, METADATA_SYMBOL } from "#/metadata/metadata-keys";
+/**
+ * @since 0.3.16-canary.0
+ */
+export class SymbolMetadataReader {
+    #getMetadataRecord(target, key) {
+        const descriptor = Object.getOwnPropertyDescriptor(target, METADATA_SYMBOL);
+        if (descriptor === undefined) {
+            return undefined;
+        }
+        const record = descriptor.value;
+        if (!record || typeof record !== "object" || !Object.hasOwn(record, key)) {
+            return undefined;
+        }
+        return record;
+    }
+    getConstructorMetadata(target) {
+        const record = this.#getMetadataRecord(target, INJECTABLE_KEY);
+        return record?.[INJECTABLE_KEY];
+    }
+    getLifecycleMetadata(target) {
+        const record = this.#getMetadataRecord(target, LIFECYCLE_KEY);
+        return record?.[LIFECYCLE_KEY];
+    }
+    getAccessorMetadata(target) {
+        const record = this.#getMetadataRecord(target, INJECT_ACCESSOR_KEY);
+        return record?.[INJECT_ACCESSOR_KEY];
+    }
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export const defaultMetadataReader = new SymbolMetadataReader();
+//# sourceMappingURL=symbol-metadata-reader.js.map

package/dist/metadata/symbol-metadata-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-metadata-reader.js","sourceRoot":"","sources":["../../src/metadata/symbol-metadata-reader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAI/G;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC/B,kBAAkB,CAAC,MAAmB,EAAE,GAAoB;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAC5E,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,CAAC,KAA4D,CAAC;QACvF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACzE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sBAAsB,CAAC,MAAmB;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC/D,OAAO,MAAM,EAAE,CAAC,cAAc,CAAoC,CAAC;IACrE,CAAC;IAED,oBAAoB,CAAC,MAAmB;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC9D,OAAO,MAAM,EAAE,CAAC,aAAa,CAAkC,CAAC;IAClE,CAAC;IAED,mBAAmB,CACjB,MAAmB;QAEnB,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;QACpE,OAAO,MAAM,EAAE,CAAC,mBAAmB,CAEtB,CAAC;IAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,67 @@
+import type { BindToBuilder } from "#/binding";
+import type { Token } from "#/token";
+import type { Constructor } from "#/types";
+declare const SYNC_MODULE_BRAND: unique symbol;
+declare const ASYNC_MODULE_BRAND: unique symbol;
+/**
+ * Key for the module's setup callback. A symbol (not exported from the package root)
+ * keeps the container-only member out of consumer-facing autocomplete entirely.
+ *
+ * @since 0.5.0-canary.7
+ */
+export declare const MODULE_SETUP: unique symbol;
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface SyncModule {
+    readonly name: string;
+    readonly [SYNC_MODULE_BRAND]: true;
+    readonly [MODULE_SETUP]: (builder: ModuleBuilder) => void;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface AsyncModule {
+    readonly name: string;
+    readonly [ASYNC_MODULE_BRAND]: true;
+    readonly [MODULE_SETUP]: (builder: AsyncModuleBuilder) => Promise<void>;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface ModuleBuilder {
+    bind<const Value>(token: Token<Value> | Constructor<Value>): BindToBuilder<Value>;
+    import(...modules: Array<SyncModule>): void;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface AsyncModuleBuilder {
+    bind<const Value>(token: Token<Value> | Constructor<Value>): BindToBuilder<Value>;
+    import(...modules: Array<SyncModule | AsyncModule>): void;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare const SyncModule: {
+    create(name: string, setup: (builder: ModuleBuilder) => void): SyncModule;
+};
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare const AsyncModule: {
+    create(name: string, setup: (builder: AsyncModuleBuilder) => Promise<void>): AsyncModule;
+};
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare const Module: {
+    create(name: string, setup: (builder: ModuleBuilder) => void): SyncModule;
+    createAsync(name: string, setup: (builder: AsyncModuleBuilder) => Promise<void>): AsyncModule;
+};
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare function isSyncModule(module: SyncModule | AsyncModule): module is SyncModule;
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,QAAA,MAAM,iBAAiB,EAAE,OAAO,MAAiC,CAAC;AAClE,QAAA,MAAM,kBAAkB,EAAE,OAAO,MAAkC,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,MAAkC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;IACpC,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAID;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClF,MAAM,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClF,MAAM,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC;CAC3D;AAID;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,MAAM,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,UAAU;CAO1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,MAAM,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW;CAOzF,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB,MAAM,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,UAAU;IAGzE,WAAW,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW;CAG9F,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,IAAI,UAAU,CAEnF"}

package/dist/module.js

@@ -0,0 +1,54 @@
+// ── Branded types (runtime symbols for branding) ─────────────────────────────
+const SYNC_MODULE_BRAND = Symbol("di:sync-module");
+const ASYNC_MODULE_BRAND = Symbol("di:async-module");
+/**
+ * Key for the module's setup callback. A symbol (not exported from the package root)
+ * keeps the container-only member out of consumer-facing autocomplete entirely.
+ *
+ * @since 0.5.0-canary.7
+ */
+export const MODULE_SETUP = Symbol("di:module-setup");
+// ── Static factories ──────────────────────────────────────────────────────────
+/**
+ * @since 0.3.16-canary.0
+ */
+export const SyncModule = {
+    create(name, setup) {
+        return {
+            name,
+            [SYNC_MODULE_BRAND]: true,
+            [MODULE_SETUP]: setup,
+        };
+    },
+};
+/**
+ * @since 0.3.16-canary.0
+ */
+export const AsyncModule = {
+    create(name, setup) {
+        return {
+            name,
+            [ASYNC_MODULE_BRAND]: true,
+            [MODULE_SETUP]: setup,
+        };
+    },
+};
+// ── Module — unified API ──────────────────────────────────────────────────────
+/**
+ * @since 0.3.16-canary.0
+ */
+export const Module = {
+    create(name, setup) {
+        return SyncModule.create(name, setup);
+    },
+    createAsync(name, setup) {
+        return AsyncModule.create(name, setup);
+    },
+};
+/**
+ * @since 0.3.16-canary.0
+ */
+export function isSyncModule(module) {
+    return module[SYNC_MODULE_BRAND];
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAIA,gFAAgF;AAEhF,MAAM,iBAAiB,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAClE,MAAM,kBAAkB,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAsCrE,iFAAiF;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM,CAAC,IAAY,EAAE,KAAuC;QAC1D,OAAO;YACL,IAAI;YACJ,CAAC,iBAAiB,CAAC,EAAE,IAAa;YAClC,CAAC,YAAY,CAAC,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,CAAC,IAAY,EAAE,KAAqD;QACxE,OAAO;YACL,IAAI;YACJ,CAAC,kBAAkB,CAAC,EAAE,IAAa;YACnC,CAAC,YAAY,CAAC,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,iFAAiF;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,CAAC,IAAY,EAAE,KAAuC;QAC1D,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IACD,WAAW,CAAC,IAAY,EAAE,KAAqD;QAC7E,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAgC;IAC3D,OAAQ,MAAqB,CAAC,iBAAiB,CAAC,CAAC;AACnD,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,33 @@
+import type { Binding } from "#/binding";
+import type { Token } from "#/token";
+import type { BindingIdentifier, Constructor } from "#/types";
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare class BindingRegistry {
+    #private;
+    /** Monotonic version — increments on every mutation. */
+    get version(): number;
+    /** Add or replace binding using slot-aware last-wins. Returns the displaced binding, if any. */
+    add(uncommittedBinding: Binding): Binding | undefined;
+    /** Remove all bindings for a token. Returns removed bindings. */
+    removeByToken(token: Token<unknown> | Constructor): Array<Binding>;
+    /** Remove a specific binding by ID. Returns the removed binding or undefined. */
+    removeById(id: BindingIdentifier): Binding | undefined;
+    /** Get all bindings for a token. */
+    getAll(token: Token<unknown> | Constructor): ReadonlyArray<Binding>;
+    /** Get binding by ID. */
+    getById(id: BindingIdentifier): Binding | undefined;
+    /** Check if any binding exists for token. */
+    has(token: Token<unknown> | Constructor): boolean;
+    /** All bindings in the registry. */
+    allBindings(): ReadonlyArray<Binding>;
+    /** Remove all bindings. Returns all removed. */
+    clear(): ReadonlyArray<Binding>;
+    getSimpleNamed(token: Token<unknown> | Constructor, name: string): Binding | undefined;
+    getSimpleTagged(token: Token<unknown> | Constructor, tagKey: string, tagValue: unknown): Binding | undefined;
+    getFastDefault(token: Token<unknown> | Constructor): Binding | undefined;
+    /** Summarize available slot strings for a token (for error messages). */
+    availableSlotStrings(token: Token<unknown> | Constructor): Array<string>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAwC7E;;GAEG;AACH,qBAAa,eAAe;;IAc1B,wDAAwD;IACxD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,gGAAgG;IAChG,GAAG,CAAC,kBAAkB,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CA4BpD;IAED,iEAAiE;IACjE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAYjE;IAED,iFAAiF;IACjF,UAAU,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS,CA0BrD;IAED,oCAAoC;IACpC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,CAElE;IAED,yBAAyB;IACzB,OAAO,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAElD;IAED,6CAA6C;IAC7C,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,OAAO,CAIhD;IAED,oCAAoC;IACpC,WAAW,IAAI,aAAa,CAAC,OAAO,CAAC,CAMpC;IAED,gDAAgD;IAChD,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAS9B;IAED,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAErF;IAED,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAK3G;IAED,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAEvE;IAED,yEAAyE;IACzE,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAGvE;CAwFF"}