@codefast/di 0.5.0-canary.4 → 0.5.0-canary.6

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export type { ActivationHandler, BindingIdentifier, BindingKind, BindingScope, BindingTag, ConstraintContext, Constructor, DependencyKey, DeactivationHandler, ResolutionFrame, ResolveOptions, ResolutionContext, TokenValue, } from "#/types";
+export { token, tokenName, isToken } from "#/token";
+export type { Token } from "#/token";
+export type { AliasBindingBuilder, BindToBuilder, BindingBuilder, ConstantBindingBuilder, ScopedBindingBuilder, SingletonBindingBuilder, SingletonLifecycleBuilder, SlotConstrainedBuilder, TransientBindingBuilder, } from "#/binding";
+export { Container } from "#/container";
+export type { Container as ContainerInterface, ContainerStatic } from "#/container";
+export { effectiveBindingScope } from "#/binding-scope";
+export { injectionSlotToResolveOptions, bindingSlotToResolveOptions } from "#/resolve-options";
+export type { BindingSnapshot, ContainerSnapshot } from "#/inspector";
+export type { ContainerGraphJson, GraphEdge, GraphNode, GraphOptions } from "#/dependency-graph";
+export { AsyncModule, isSyncModule, Module, SyncModule } from "#/module";
+export type { AsyncModuleBuilder, ModuleBuilder } from "#/module";
+export { inject, injectAll, isInjectionDescriptor, optional } from "#/decorators/inject";
+export type { InjectionDescriptor, InjectOptions } from "#/decorators/inject";
+export { injectable } from "#/decorators/injectable";
+export type { InjectableDependency, InjectableOptions } from "#/decorators/injectable";
+export { postConstruct, preDestroy } from "#/decorators/lifecycle-decorators";
+export { createAutoRegisterRegistry } from "#/decorators/injectable";
+export type { AutoRegisterRegistry } from "#/decorators/injectable";
+export { MetadataReaderToken } from "#/metadata/metadata-reader-token";
+export type { MetadataReader, MutableLifecycleMetadata } from "#/metadata/metadata-types";
+export { whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll, } from "#/constraints";
+export { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError, } from "#/errors";
+export type { ScopeViolationDetails } from "#/errors";
+//# 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":"AACA,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,SAAS,IAAI,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAG/F,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGjG,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzF,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAG9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAG1F,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,OAAO,EACP,sBAAsB,EACtB,aAAa,EACb,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// Token
+export { token, tokenName, isToken } from "#/token";
+// Container
+export { Container } from "#/container";
+export { effectiveBindingScope } from "#/binding-scope";
+export { injectionSlotToResolveOptions, bindingSlotToResolveOptions } from "#/resolve-options";
+// Module
+export { AsyncModule, isSyncModule, Module, SyncModule } from "#/module";
+// Decorators
+export { inject, injectAll, isInjectionDescriptor, optional } from "#/decorators/inject";
+export { injectable } from "#/decorators/injectable";
+export { postConstruct, preDestroy } from "#/decorators/lifecycle-decorators";
+// Auto-register
+export { createAutoRegisterRegistry } from "#/decorators/injectable";
+// MetadataReader
+export { MetadataReaderToken } from "#/metadata/metadata-reader-token";
+// Constraints — contextual injection predicates for .when()
+export { whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll, } from "#/constraints";
+// Errors
+export { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError, } from "#/errors";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAgBpD,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAQ/F,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGzE,aAAa;AACb,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAE9E,gBAAgB;AAChB,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAGrE,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAGvE,4DAA4D;AAC5D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,SAAS;AACT,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,OAAO,EACP,sBAAsB,EACtB,aAAa,EACb,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,UAAU,CAAC"}

package/dist/inspector.d.ts

@@ -0,0 +1,44 @@
+import type { BindingRegistry } from "#/registry";
+import type { ScopeManager } from "#/scope";
+import type { Token } from "#/token";
+import type { BindingIdentifier, BindingKind, BindingScope, BindingTag, Constructor, ResolveOptions } from "#/types";
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface BindingSnapshot {
+    readonly tokenName: string;
+    readonly kind: BindingKind;
+    readonly scope: BindingScope;
+    readonly slot: {
+        readonly name?: string;
+        readonly tags: ReadonlyArray<BindingTag>;
+    };
+    readonly id: BindingIdentifier;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface ContainerSnapshot {
+    readonly ownBindings: ReadonlyArray<BindingSnapshot>;
+    readonly cachedSingletonCount: number;
+    readonly hasParent: boolean;
+    readonly isDisposed: boolean;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare class Inspector {
+    private readonly _registry;
+    private readonly _scope;
+    private readonly _hasParent;
+    private readonly _isDisposed;
+    constructor(_registry: BindingRegistry, _scope: ScopeManager, _hasParent: boolean, _isDisposed: () => boolean);
+    inspect(): ContainerSnapshot;
+    lookupBindings<Value>(token: Token<Value> | Constructor<Value>): ReadonlyArray<BindingSnapshot>;
+    has(token: Token<unknown> | Constructor, options?: ResolveOptions, parentHas?: () => boolean): boolean;
+    hasOwn(token: Token<unknown> | Constructor, options?: ResolveOptions): boolean;
+    private _makeConstraintContext;
+    private allBindingSnapshots;
+    private _toSnapshot;
+}
+//# sourceMappingURL=inspector.d.ts.map

package/dist/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../src/inspector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;KAC1C,CAAC;IACF,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACrD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAID;;GAEG;AACH,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJ9B,YACmB,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,OAAO,EACnB,WAAW,EAAE,MAAM,OAAO,EACzC;IAEJ,OAAO,IAAI,iBAAiB,CAQ3B;IAED,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,eAAe,CAAC,CAG9F;IAED,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAYrG;IAED,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAS7E;IAED,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,WAAW;CAcpB"}

package/dist/inspector.js

@@ -0,0 +1,82 @@
+import { effectiveBindingScope } from "#/binding-scope";
+import { selectBinding } from "#/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/inspector.js.map

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

package/dist/lifecycle.d.ts

@@ -0,0 +1,21 @@
+import type { Binding } from "#/binding";
+import type { MetadataReader } from "#/metadata/metadata-types";
+import type { Token } from "#/token";
+import type { ActivationHandler, Constructor, DeactivationHandler, ResolutionContext } from "#/types";
+/**
+ * @since 0.3.16-canary.0
+ */
+export declare class LifecycleManager {
+    private readonly _activationHooks;
+    private readonly _deactivationHooks;
+    private _activationVersion;
+    registerActivation<const Value>(token: Token<Value> | Constructor<Value>, handler: ActivationHandler<Value>): void;
+    hasActivationHandlers<const Value>(token: Token<Value> | Constructor<Value>): boolean;
+    get activationVersion(): number;
+    registerDeactivation<const Value>(token: Token<Value> | Constructor<Value>, handler: DeactivationHandler<Value>): void;
+    runActivation<const Value>(resolutionContext: ResolutionContext, binding: Binding<Value>, instance: Value, metadataReader: MetadataReader): Promise<Value>;
+    runActivationSync<const Value>(resolutionContext: ResolutionContext, binding: Binding<Value>, instance: Value, metadataReader: MetadataReader): Value;
+    runDeactivation<const Value>(binding: Binding<Value>, instance: Value, metadataReader: MetadataReader): Promise<void>;
+    runDeactivationSync<const Value>(binding: Binding<Value>, instance: Value, metadataReader: MetadataReader): void;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEtG;;GAEG;AACH,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8E;IAC/G,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgF;IACnH,OAAO,CAAC,kBAAkB,CAAK;IAE/B,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,CAKjH;IAED,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAMpF;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,oBAAoB,CAAC,KAAK,CAAC,KAAK,EAC9B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,EACxC,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAClC,IAAI,CAGN;IAEK,aAAa,CAAC,KAAK,CAAC,KAAK,EAC7B,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EACvB,QAAQ,EAAE,KAAK,EACf,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,KAAK,CAAC,CAmChB;IAED,iBAAiB,CAAC,KAAK,CAAC,KAAK,EAC3B,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EACvB,QAAQ,EAAE,KAAK,EACf,cAAc,EAAE,cAAc,GAC7B,KAAK,CA0CP;IAEK,eAAe,CAAC,KAAK,CAAC,KAAK,EAC/B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EACvB,QAAQ,EAAE,KAAK,EACf,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,IAAI,CAAC,CAqCf;IAED,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI,CAsC/G;CACF"}

package/dist/lifecycle.js

@@ -0,0 +1,174 @@
+import { AsyncActivationError, AsyncDeactivationError } from "#/errors";
+import { tokenName } from "#/token";
+/**
+ * @since 0.3.16-canary.0
+ */
+export class LifecycleManager {
+    // Container-level activation/deactivation hooks per token
+    _activationHooks = new Map();
+    _deactivationHooks = new Map();
+    _activationVersion = 0;
+    registerActivation(token, handler) {
+        this._activationVersion += 1;
+        // ✓ TS6.0: Map.getOrInsert (ES2025)
+        const list = this._activationHooks.getOrInsert(token, []);
+        list.push(handler);
+    }
+    hasActivationHandlers(token) {
+        if (this._activationHooks.size === 0) {
+            return false;
+        }
+        const list = this._activationHooks.get(token);
+        return list !== undefined && list.length > 0;
+    }
+    get activationVersion() {
+        return this._activationVersion;
+    }
+    registerDeactivation(token, handler) {
+        const list = this._deactivationHooks.getOrInsert(token, []);
+        list.push(handler);
+    }
+    async runActivation(resolutionContext, binding, instance, metadataReader) {
+        let activatedInstance = instance;
+        // 1. @postConstruct() — after TC39 construction (constructor + accessor addInitializer callbacks)
+        if (binding.kind === "class") {
+            const lifecycle = metadataReader.getLifecycleMetadata(binding.target);
+            if (lifecycle?.postConstruct && lifecycle.postConstruct.length > 0) {
+                for (const methodName of lifecycle.postConstruct) {
+                    const method = activatedInstance[methodName];
+                    if (typeof method === "function") {
+                        const hookResult = method.call(activatedInstance);
+                        if (hookResult instanceof Promise) {
+                            await hookResult;
+                        }
+                    }
+                }
+            }
+        }
+        // 2. per-binding onActivation
+        if (binding.kind !== "alias" && binding.onActivation !== undefined) {
+            const activationResult = binding.onActivation(resolutionContext, activatedInstance);
+            activatedInstance = activationResult instanceof Promise ? await activationResult : activationResult;
+        }
+        // 3. container-level onActivation
+        const containerHooks = this._activationHooks.get(binding.token);
+        if (containerHooks !== undefined) {
+            for (const hook of containerHooks) {
+                const activationResult = hook(resolutionContext, activatedInstance);
+                activatedInstance = (activationResult instanceof Promise ? await activationResult : activationResult);
+            }
+        }
+        return activatedInstance;
+    }
+    runActivationSync(resolutionContext, binding, instance, metadataReader) {
+        let activatedInstance = instance;
+        // 1. @postConstruct() — must be sync (instance fully constructed per TC39 order)
+        if (binding.kind === "class") {
+            const lifecycle = metadataReader.getLifecycleMetadata(binding.target);
+            if (lifecycle?.postConstruct && lifecycle.postConstruct.length > 0) {
+                for (const methodName of lifecycle.postConstruct) {
+                    const method = activatedInstance[methodName];
+                    if (typeof method === "function") {
+                        const hookResult = method.call(activatedInstance);
+                        if (hookResult instanceof Promise) {
+                            throw new AsyncActivationError(tokenName(binding.token), "postConstruct", methodName);
+                        }
+                    }
+                }
+            }
+        }
+        // 2. per-binding onActivation (must be sync)
+        if (binding.kind !== "alias" && binding.onActivation !== undefined) {
+            const activationResult = binding.onActivation(resolutionContext, activatedInstance);
+            if (activationResult instanceof Promise) {
+                throw new AsyncActivationError(tokenName(binding.token), "onActivation");
+            }
+            activatedInstance = activationResult;
+        }
+        // 3. container-level onActivation (must be sync)
+        const tokenDisplayName = tokenName(binding.token);
+        const containerHooks = this._activationHooks.get(binding.token);
+        if (containerHooks !== undefined) {
+            for (const hook of containerHooks) {
+                const activationResult = hook(resolutionContext, activatedInstance);
+                if (activationResult instanceof Promise) {
+                    throw new AsyncActivationError(tokenDisplayName, "onActivation");
+                }
+                activatedInstance = activationResult;
+            }
+        }
+        return activatedInstance;
+    }
+    async runDeactivation(binding, instance, metadataReader) {
+        const tokenKey = binding.token;
+        // 1. container-level onDeactivation
+        const containerHooks = this._deactivationHooks.get(tokenKey);
+        if (containerHooks !== undefined) {
+            for (const hook of containerHooks) {
+                const hookResult = hook(instance);
+                if (hookResult instanceof Promise) {
+                    await hookResult;
+                }
+            }
+        }
+        // 2. per-binding onDeactivation
+        if (binding.kind !== "alias" && binding.onDeactivation !== undefined) {
+            const hookResult = binding.onDeactivation(instance);
+            if (hookResult instanceof Promise) {
+                await hookResult;
+            }
+        }
+        // 3. @preDestroy() — all methods in declaration order
+        if (binding.kind === "class") {
+            const lifecycle = metadataReader.getLifecycleMetadata(binding.target);
+            if (lifecycle?.preDestroy && lifecycle.preDestroy.length > 0) {
+                for (const methodName of lifecycle.preDestroy) {
+                    const method = instance[methodName];
+                    if (typeof method === "function") {
+                        const hookResult = method.call(instance);
+                        if (hookResult instanceof Promise) {
+                            await hookResult;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    runDeactivationSync(binding, instance, metadataReader) {
+        const tokenDisplayName = tokenName(binding.token);
+        const tokenKey = binding.token;
+        // 1. container-level onDeactivation
+        const containerHooks = this._deactivationHooks.get(tokenKey);
+        if (containerHooks !== undefined) {
+            for (const hook of containerHooks) {
+                const hookResult = hook(instance);
+                if (hookResult instanceof Promise) {
+                    throw new AsyncDeactivationError(tokenDisplayName);
+                }
+            }
+        }
+        // 2. per-binding onDeactivation
+        if (binding.kind !== "alias" && binding.onDeactivation !== undefined) {
+            const hookResult = binding.onDeactivation(instance);
+            if (hookResult instanceof Promise) {
+                throw new AsyncDeactivationError(tokenDisplayName);
+            }
+        }
+        // 3. @preDestroy()
+        if (binding.kind === "class") {
+            const lifecycle = metadataReader.getLifecycleMetadata(binding.target);
+            if (lifecycle?.preDestroy && lifecycle.preDestroy.length > 0) {
+                for (const methodName of lifecycle.preDestroy) {
+                    const method = instance[methodName];
+                    if (typeof method === "function") {
+                        const hookResult = method.call(instance);
+                        if (hookResult instanceof Promise) {
+                            throw new AsyncDeactivationError(tokenDisplayName);
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.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 _getMetadataRecord;
+    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;IACzD,OAAO,CAAC,kBAAkB;IAY1B,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;IACvB,kBAAkB,CAAC,MAAmB,EAAE,GAAoB;QAClE,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"}