ts-ioc-container 72.0.0 → 72.2.0

package/typings/registration/IRegistration.d.ts

@@ -3,19 +3,61 @@ import type { ArgsFn, DecorateFn, GetCacheKey, IProvider, ProviderHook, ScopeAcc
 import { BindToken } from '../token/BindToken.js';
 import { MapFn } from '../utils/fp.js';
 import { type constructor } from '../utils/basic.js';
+/**
+ * Decides whether a registration is copied into a scope when that scope is
+ * created (or when the registration is added). `prev` is the result of the
+ * rules before it, so rules chain. Set with {@link scope} or `registration.when(...)`.
+ *
+ * @example
+ * const onlyRequest: ScopeMatchRule = (s) => s.hasTag('request');
+ */
 export type ScopeMatchRule = (s: IContainer, prev: boolean) => boolean;
+/**
+ * A provider transform usable in both places: `registration.pipe(...)` calls
+ * `mapProvider`, `@register(...)` calls `mapRegistration`. Build one with
+ * {@link registerPipe}; `singleton()`, `lazy()`, `scopeAccess()` etc. are all pipes.
+ */
 export interface ProviderPipe<T = unknown> {
     mapProvider(p: IProvider<T>): IProvider<T>;
     mapRegistration(r: IRegistration<T>): IRegistration<T>;
 }
+/** Narrows `obj` to a {@link ProviderPipe}. */
 export declare const isProviderPipe: <T>(obj: unknown) => obj is ProviderPipe<T>;
+/**
+ * Turns a provider transform into a {@link ProviderPipe}, so it works both in
+ * `@register(...)` and in `registration.pipe(...)`.
+ *
+ * @example
+ * const cached = <T>() => registerPipe<T>((p) => p.singleton());
+ *
+ * @register(bindTo('Cache'), cached())
+ * class Cache {}
+ */
 export declare const registerPipe: <T>(mapProvider: (p: IProvider<T>) => IProvider<T>) => ProviderPipe<T>;
+/**
+ * Anything that can name a binding key: a raw key, or a token that knows how to bind itself.
+ */
 export type Bindable<T = any> = DependencyKey | BindToken<T>;
+/** Normalizes a {@link Bindable}: a raw key becomes a `SingleToken`, a token is returned as is. */
 export declare const toBindToken: <T>(target: Bindable<T>) => BindToken<T>;
+/**
+ * Everything accepted at provider level - by `IRegistration.pipe(...)`.
+ */
 export type ProviderMapper<T = any> = MapFn<IProvider<T>> | ProviderPipe<T>;
+/** Normalizes a {@link ProviderMapper} to a plain provider transform. */
 export declare const toProviderFn: <T>(mapper: ProviderMapper<T>) => MapFn<IProvider<T>>;
+/**
+ * Everything accepted at registration level - by `@register(...)`.
+ */
 export type RegistrationMapper<T = any> = MapFn<IRegistration<T>> | ProviderPipe<T> | Bindable<T>;
+/** Normalizes a {@link RegistrationMapper} to a plain registration transform (a `Bindable` becomes `bindTo(...)`). */
 export declare const toRegistrationFn: <T>(mapper: RegistrationMapper<T>) => MapFn<IRegistration<T>>;
+/**
+ * A recipe for putting one provider into matching scopes. Created with
+ * `Registration.fromClass` / `fromValue` / `fromFn` / `fromKey` and added with
+ * `container.addRegistration(...)`; `applyTo(scope)` registers the provider
+ * when the scope rules match.
+ */
 export interface IRegistration<T = any> extends IContainerModule {
     getKeyOrFail(): DependencyKey;
     when(...predicates: ScopeMatchRule[]): this;
@@ -24,16 +66,111 @@ export interface IRegistration<T = any> extends IContainerModule {
     pipe(...mappers: ProviderMapper<T>[]): this;
     bindToAlias(alias: DependencyKey): this;
 }
+/** The dependency type `T` of an `IRegistration<T>`. */
 export type ReturnTypeOfRegistration<T> = T extends IRegistration<infer R> ? R : never;
+/** Reads the registration transforms written on a class by {@link register}. */
 export declare const getTransformers: (Target: constructor<unknown>) => MapFn<IRegistration<any>>[];
+/**
+ * Class decorator that configures how `Registration.fromClass(Target)` registers
+ * the class: binding keys, scope rules and provider pipes. A bare key or token
+ * is shorthand for `bindTo(...)`. Without a key the class name is used.
+ *
+ * @example
+ * @register(bindTo(ILoggerToken), scope((s) => s.hasTag('application')), singleton())
+ * class Logger implements ILogger {}
+ *
+ * container.addRegistration(Registration.fromClass(Logger));
+ */
 export declare const register: (...mappers: RegistrationMapper[]) => ClassDecorator;
+/**
+ * Binds a registration to one or more keys or tokens. A `SingleToken` binds its
+ * key; an alias token (`toSingleAlias`, `toGroupAlias`) adds an alias.
+ *
+ * @example
+ * @register(bindTo(ILoggerToken))
+ * class Logger {}
+ *
+ * @example
+ * Registration.fromValue(config).bindTo('Config');
+ */
 export declare const bindTo: (...tokens: Bindable[]) => MapFn<IRegistration>;
+/**
+ * Limits which scopes a registration is copied into. Without it, a registration
+ * lands in every scope, so a `singleton()` becomes one instance per scope.
+ *
+ * @example
+ * @register(bindTo('Repo'), scope((s) => s.hasTag('request')))
+ * class Repo {}
+ */
 export declare const scope: (...rules: ScopeMatchRule[]) => MapFn<IRegistration>;
+/**
+ * Appends fixed values after the runtime args handed to the provider.
+ *
+ * @example
+ * @register(bindTo('Client'), appendArgs('https://api.example.com'))
+ * class Client {
+ *   constructor(@inject(arg(0)) readonly baseUrl: string) {}
+ * }
+ */
 export declare const appendArgs: <T>(...extraArgs: unknown[]) => ProviderPipe<T>;
+/**
+ * Appends values computed at resolve time after the runtime args.
+ *
+ * @example
+ * @register(bindTo('Client'), appendArgsFn(({ scope }) => [scope.resolve('API_URL')]))
+ * class Client {}
+ */
 export declare const appendArgsFn: <T>(fn: ArgsFn) => ProviderPipe<T>;
+/**
+ * Controls from which scopes the provider may be resolved (unlike {@link scope},
+ * which controls where it is registered). A denied lookup falls through to the parent.
+ *
+ * @example
+ * @register(bindTo('Admin'), scopeAccess(({ invocationScope }) => invocationScope.hasTag('admin')))
+ * class AdminService {}
+ */
 export declare const scopeAccess: <T>(rule: ScopeAccessRule) => ProviderPipe<T>;
+/**
+ * Resolves the dependency as a proxy that constructs the real instance on first
+ * member access.
+ *
+ * @example
+ * @register(bindTo('Heavy'), lazy())
+ * class HeavyService {}
+ */
 export declare const lazy: <T>() => ProviderPipe<T>;
+/**
+ * Marks the provider for eager resolution when the scope is set up; needs
+ * `container.useModule(new AutoResolveModule())`.
+ */
 export declare const autoResolve: <T>() => ProviderPipe<T>;
+/**
+ * Wraps or replaces the resolved dependency. Order relative to `lazy()` decides
+ * whether the proxy or the real instance is decorated.
+ *
+ * @example
+ * @register(bindTo('Api'), decorate((api, scope) => new LoggingApi(api)))
+ * class Api {}
+ */
 export declare const decorate: (...fns: DecorateFn[]) => ProviderPipe<unknown>;
+/**
+ * Caches the dependency per provider, which means per scope the registration
+ * was copied into (combine with {@link scope}). `getCacheKey` receives the
+ * runtime args and caches one instance per distinct key.
+ *
+ * @example
+ * @register(bindTo('Db'), scope((s) => s.hasTag('application')), singleton())
+ * class Db {}
+ *
+ * @example
+ * // one instance per tenant id passed as the first runtime arg
+ * @register(bindTo('TenantDb'), singleton(([tenantId]) => String(tenantId)))
+ * class TenantDb {}
+ */
 export declare const singleton: <T = unknown>(getCacheKey?: GetCacheKey) => ProviderPipe<T>;
+/**
+ * Registration-level form of `IProvider.onResolved`: attaches provider hooks to
+ * the piped registration's provider.
+ */
 export declare const onResolve: <T = unknown>(...hooks: ProviderHook[]) => ProviderPipe<T>;
+//# sourceMappingURL=IRegistration.d.ts.map

package/typings/registration/IRegistration.d.ts.map

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

package/typings/registration/Registration.d.ts

@@ -2,6 +2,22 @@ import { DependencyKey, IContainer } from '../container/IContainer.js';
 import type { IProvider, ResolveDependency } from '../provider/IProvider.js';
 import { type Bindable, type IRegistration, type ProviderMapper, type ScopeMatchRule } from './IRegistration.js';
 import { type constructor } from '../utils/basic.js';
+/**
+ * Builds registrations for `container.addRegistration(...)`. Usually imported as
+ * `Registration as R`.
+ *
+ * - `R.fromClass(Class)` - reads the class's `@register(...)` config; the key
+ *   defaults to the class name.
+ * - `R.fromValue(value).bindTo('Key')` - a constant.
+ * - `R.fromFn(({ scope, args }) => ...).bindTo('Key')` - a factory.
+ * - `R.fromKey('Other').bindTo('Key')` - an alias of another key.
+ *
+ * @example
+ * container
+ *   .addRegistration(R.fromClass(Logger))
+ *   .addRegistration(R.fromValue('https://api.example.com').bindTo('API_URL'))
+ *   .addRegistration(R.fromFn(({ scope }) => new Client(scope.resolve('API_URL'))).bindTo('Client'));
+ */
 export declare class Registration<T = any> implements IRegistration<T> {
     private createProvider;
     key?: DependencyKey | undefined;
@@ -21,6 +37,13 @@ export declare class Registration<T = any> implements IRegistration<T> {
     when(...predicates: ScopeMatchRule[]): this;
     bindTo(key: Bindable): this;
     private matchScope;
+    /**
+     * @throws {DependencyMissingKeyError} when the registration matches the scope but has no binding key.
+     */
     applyTo(container: IContainer): void;
+    /**
+     * @throws {DependencyMissingKeyError} when no binding key has been set for this registration.
+     */
     getKeyOrFail(): DependencyKey;
 }
+//# sourceMappingURL=Registration.d.ts.map

package/typings/registration/Registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registration.d.ts","sourceRoot":"","sources":["../../lib/registration/Registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EAIpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,WAAW,EAAM,MAAM,gBAAgB,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IA0B1D,OAAO,CAAC,cAAc;IACf,GAAG,CAAC,EAAE,aAAa;IAC1B,OAAO,CAAC,UAAU;IA3BpB,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO;IAK5E,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;IAQ5B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAIzC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa;IAIpC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAiC;gBAGtC,cAAc,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EACnC,GAAG,CAAC,EAAE,aAAa,YAAA,EAClB,UAAU,GAAE,cAAc,EAAO;IAG3C,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKnC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKvC,IAAI,CAAC,GAAG,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI;IAK3C,IAAI,CAAC,GAAG,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI;IAK3C,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAK3B,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAepC;;OAEG;IACH,YAAY,IAAI,aAAa;CAQ9B"}

package/typings/select.d.ts

@@ -1,6 +1,20 @@
 import { type CreateScopeOptions } from './container/IContainer.js';
 import { FunctionToken } from './token/FunctionToken.js';
 import { GroupInstanceToken, InstancePredicate } from './token/GroupInstanceToken.js';
+/**
+ * Shortcuts for common tokens.
+ *
+ * - `select.token(x)` - `toToken(x)`
+ * - `select.alias('Key')` - a {@link GroupAliasToken}
+ * - `select.instances(predicate)` - instances already created in the scope
+ * - `select.scope.current` - the resolving scope itself
+ * - `select.scope.create({ tags })` - a new child scope
+ *
+ * @example
+ * class Handler {
+ *   constructor(@inject(by(select.scope.current)) private scope: IContainer) {}
+ * }
+ */
 export declare const select: {
     alias: <T>(token: import("./container/IContainer.js").DependencyKey) => import("./token/GroupAliasToken.js").GroupAliasToken<T>;
     token: <T = any>(token: import("./token/toToken.js").Injectable<T>) => import(".").InjectionToken<T>;
@@ -10,3 +24,4 @@ export declare const select: {
         create: (options: CreateScopeOptions) => FunctionToken<import("./container/IContainer.js").IContainer>;
     };
 };
+//# sourceMappingURL=select.d.ts.map

package/typings/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../lib/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGnF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM;;;4BAKM,iBAAiB;;;0BAKpB,kBAAkB;;CAEvC,CAAC"}

package/typings/token/BindToken.d.ts

@@ -1,5 +1,8 @@
 import { IRegistration } from '../registration/IRegistration.js';
+/** A token that can bind a registration to itself (a key or an alias). */
 export interface BindToken<T = any> {
     bindTo(r: IRegistration<T>): void;
 }
+/** Narrows `token` to a {@link BindToken}. */
 export declare function isBindToken(token: unknown): token is BindToken;
+//# sourceMappingURL=BindToken.d.ts.map

package/typings/token/BindToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BindToken.d.ts","sourceRoot":"","sources":["../../lib/token/BindToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAI9D,0EAA0E;AAC1E,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,GAAG;IAChC,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACnC;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D"}

package/typings/token/ClassToken.d.ts

@@ -2,6 +2,7 @@ import { IContainer } from '../container/IContainer.js';
 import { InjectionToken } from './InjectionToken.js';
 import { type constructor, Serializable } from '../utils/basic.js';
 import { ArgsFn, ResolveOptions } from '../provider/IProvider.js';
+/** A token for a class: resolves it through the scope's injector. `toToken(Class)` creates one. */
 export declare class ClassToken<T = any> extends InjectionToken<T> implements Serializable {
     private readonly target;
     private readonly _getArgsFn;
@@ -19,3 +20,4 @@ export declare class ClassToken<T = any> extends InjectionToken<T> implements Se
     addTags(...tags: string[]): ClassToken<T>;
     toString(): string;
 }
+//# sourceMappingURL=ClassToken.d.ts.map

package/typings/token/ClassToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassToken.d.ts","sourceRoot":"","sources":["../../lib/token/ClassToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAe,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE/D,mGAAmG;AACnG,qBAAa,UAAU,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAE,YAAW,YAAY;IAK9E,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGf,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACvC,EACE,SAAuB,EACvB,MAAc,EACd,IAAS,GACV,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO;IAOnE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IACpB,GAAG,UAAU;IAGvB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,IAAS,EAAE,IAAI,EAAE,GAAE,cAAmB,GAAG,CAAC;IAOnE,IAAI,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;IAS1B,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,EAAE;IASvC,IAAI;IAQJ,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;IAQzC,QAAQ,IAAI,MAAM;CAGnB"}

package/typings/token/ConstantToken.d.ts

@@ -1,15 +1,29 @@
 import type { IContainer } from '../container/IContainer.js';
 import { InjectionToken } from './InjectionToken.js';
 import { Serializable } from '../utils/basic.js';
+/** A token that always resolves to a fixed value. It takes no args and cannot be lazy. */
 export declare class ConstantToken<T = any> extends InjectionToken<T> implements Serializable {
     private readonly token;
     constructor(token: T, { tags }?: {
         tags?: string[];
     });
     resolve(s: IContainer): T;
+    /**
+     * @throws {MethodNotImplementedError} always — a constant token cannot receive static args.
+     */
     args(...deps: unknown[]): InjectionToken<T>;
+    /**
+     * @throws {MethodNotImplementedError} always — a constant token cannot receive resolved args.
+     */
     argsFn(getArgsFn: (s: IContainer) => unknown[]): InjectionToken<T>;
+    /**
+     * @throws {MethodNotImplementedError} always — a constant token cannot be made lazy.
+     */
     lazy(): InjectionToken<T>;
     addTags(...tags: string[]): ConstantToken<T>;
+    /**
+     * @throws {MethodNotImplementedError} always — a constant token has no underlying key.
+     */
     toString(): string;
 }
+//# sourceMappingURL=ConstantToken.d.ts.map

package/typings/token/ConstantToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConstantToken.d.ts","sourceRoot":"","sources":["../../lib/token/ConstantToken.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,0FAA0F;AAC1F,qBAAa,aAAa,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAE,YAAW,YAAY;IAEjF,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,CAAC,EACzB,EAAE,IAAS,EAAE,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO;IAKzC,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC;IAIzB;;OAEG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAI3C;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAIlE;;OAEG;IACH,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC;IAIzB,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;IAI5C;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB"}

package/typings/token/FunctionToken.d.ts

@@ -3,6 +3,12 @@ import { InjectionToken } from './InjectionToken.js';
 import { InjectFn } from '../hooks/hook.js';
 import { ArgsFn, ResolveOptions } from '../provider/IProvider.js';
 import { Serializable } from '../utils/basic.js';
+/**
+ * A token that resolves by calling an `InjectFn` with the resolution context.
+ *
+ * @example
+ * const CurrentScope = new FunctionToken(({ scope }) => scope);
+ */
 export declare class FunctionToken<T = any> extends InjectionToken<T> implements Serializable {
     private readonly fn;
     private readonly _getArgsFn;
@@ -17,5 +23,9 @@ export declare class FunctionToken<T = any> extends InjectionToken<T> implements
     argsFn(fn: (s: IContainer) => unknown[]): InjectionToken<T>;
     lazy(): InjectionToken<T>;
     addTags(...tags: string[]): FunctionToken<T>;
+    /**
+     * @throws {MethodNotImplementedError} always — a function token has no underlying key.
+     */
     toString(): string;
 }
+//# sourceMappingURL=FunctionToken.d.ts.map

package/typings/token/FunctionToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionToken.d.ts","sourceRoot":"","sources":["../../lib/token/FunctionToken.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAe,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAE,YAAW,YAAY;IAKjF,OAAO,CAAC,QAAQ,CAAC,EAAE;IAJrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGf,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,EAChC,EACE,SAAuB,EACvB,MAAc,EACd,IAAS,GACV,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO;IAOnE,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,IAAS,EAAE,IAAI,EAAE,GAAE,cAAmB,GAAG,CAAC;IAQnE,IAAI,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAS9C,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAS3D,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC;IAQzB,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;IAQ5C;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB"}

package/typings/token/GroupAliasToken.d.ts

@@ -4,6 +4,18 @@ import { IRegistration } from '../registration/IRegistration.js';
 import { BindToken } from './BindToken.js';
 import { ArgsFn, ResolveOptions } from '../provider/IProvider.js';
 import { Serializable } from '../utils/basic.js';
+/**
+ * A token for every dependency registered under an alias. As a `bindTo(...)`
+ * target it adds the alias; resolving returns all matches as an array.
+ *
+ * @example
+ * const IMiddlewareToken = toGroupAlias<IMiddleware>('IMiddleware');
+ *
+ * @register(bindTo(IMiddlewareToken))
+ * class Auth implements IMiddleware {}
+ *
+ * IMiddlewareToken.resolve(scope); // IMiddleware[]
+ */
 export declare class GroupAliasToken<T = any> extends InjectionToken<T[]> implements BindToken<T>, Serializable {
     readonly token: DependencyKey;
     private readonly _getArgsFn;
@@ -22,4 +34,6 @@ export declare class GroupAliasToken<T = any> extends InjectionToken<T[]> implem
     addTags(...tags: string[]): GroupAliasToken<T>;
     toString(): string;
 }
+/** Creates a {@link GroupAliasToken} for `token`. */
 export declare const toGroupAlias: <T>(token: DependencyKey) => GroupAliasToken<T>;
+//# sourceMappingURL=GroupAliasToken.d.ts.map

package/typings/token/GroupAliasToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupAliasToken.d.ts","sourceRoot":"","sources":["../../lib/token/GroupAliasToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAe,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAE,YAAW,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY;IAKnG,QAAQ,CAAC,KAAK,EAAE,aAAa;IAJ/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGvB,KAAK,EAAE,aAAa,EAC7B,EACE,SAAuB,EACvB,MAAc,EACd,IAAS,GACV,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO;IAOnE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,IACxB,GAAG,UAAU;IAGvB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,IAAS,EAAE,IAAI,EAAE,GAAE,cAAmB,GAAG,CAAC,EAAE;IAOrE,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAI1B,IAAI,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;IAS1B,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,EAAE;IASvC,IAAI;IAQJ,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC;IAQ9C,QAAQ,IAAI,MAAM;CAGnB;AAED,qDAAqD;AACrD,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,aAAa,uBAAkC,CAAC"}

package/typings/token/GroupInstanceToken.d.ts

@@ -1,7 +1,12 @@
 import { InjectionToken } from './InjectionToken.js';
 import type { IContainer } from '../container/IContainer.js';
 import { Instance, Serializable } from '../utils/basic.js';
+/** Selects instances for a {@link GroupInstanceToken}. */
 export type InstancePredicate = (dep: unknown) => boolean;
+/**
+ * Resolves the instances already created in a scope (and, by default, its
+ * child scopes) that match a predicate. Created by `select.instances(...)`.
+ */
 export declare class GroupInstanceToken extends InjectionToken<Instance[]> implements Serializable {
     private predicate;
     private isCascade;
@@ -10,11 +15,25 @@ export declare class GroupInstanceToken extends InjectionToken<Instance[]> imple
         isCascade?: boolean;
     });
     select<R>(fn: (target: Instance) => R): (s: IContainer) => R[];
+    /**
+     * @throws {MethodNotImplementedError} always — a group instance token cannot receive static args.
+     */
     args(...deps: unknown[]): this;
+    /**
+     * @throws {MethodNotImplementedError} always — a group instance token cannot receive resolved args.
+     */
     argsFn(getArgsFn: (s: IContainer) => unknown[]): InjectionToken<Instance[]>;
+    /**
+     * @throws {MethodNotImplementedError} always — a group instance token cannot be made lazy.
+     */
     lazy(): InjectionToken<Instance[]>;
+    /** Whether instances of child scopes are included (default `true`). */
     cascade(isTrue: boolean): this;
     resolve(c: IContainer): Instance[];
     addTags(...tags: string[]): GroupInstanceToken;
+    /**
+     * @throws {MethodNotImplementedError} always — a group instance token has no underlying key.
+     */
     toString(): string;
 }
+//# sourceMappingURL=GroupInstanceToken.d.ts.map

package/typings/token/GroupInstanceToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupInstanceToken.d.ts","sourceRoot":"","sources":["../../lib/token/GroupInstanceToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAExD,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;AAE1D;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,cAAc,CAAC,QAAQ,EAAE,CAAE,YAAW,YAAY;IAItF,OAAO,CAAC,SAAS;IAHnB,OAAO,CAAC,SAAS,CAAU;gBAGjB,SAAS,EAAE,iBAAiB,EACpC,EAAE,IAAS,EAAE,SAAgB,EAAE,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;IAMhF,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,CAAC,IAC3B,GAAG,UAAU;IAGvB;;OAEG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;IAI3E;;OAEG;IACH,IAAI,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;IAIlC,uEAAuE;IACvE,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAK9B,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,EAAE;IAIlC,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB;IAI9C;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB"}

package/typings/token/InjectionToken.d.ts

@@ -1,6 +1,12 @@
 import { type IContainer, type Tag } from '../container/IContainer.js';
 import { ArgsFn, ResolveOptions } from '../provider/IProvider.js';
+/**
+ * The default `getArgsFn` of every token: the runtime `args` a token is
+ * resolved with reach the provider as they are, and `token.args(...)` /
+ * `token.argsFn(...)` append after them.
+ */
 export declare const forwardArgs: ArgsFn;
+/** Base class of every token: something resolvable from a scope that can be specialized with args, lazy and tags. */
 export declare abstract class InjectionToken<T = any> {
     private readonly tags;
     protected constructor(tags?: Tag[]);
@@ -12,4 +18,6 @@ export declare abstract class InjectionToken<T = any> {
     hasTag(tag: Tag): boolean;
     protected getTags(): Tag[];
 }
+/** Narrows `target` to an {@link InjectionToken}. */
 export declare function isInjectionToken<T = any>(target: unknown): target is InjectionToken<T>;
+//# sourceMappingURL=InjectionToken.d.ts.map

package/typings/token/InjectionToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InjectionToken.d.ts","sourceRoot":"","sources":["../../lib/token/InjectionToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,GAAG,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG/D;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,MAAgC,CAAC;AAE3D,qHAAqH;AACrH,8BAAsB,cAAc,CAAC,CAAC,GAAG,GAAG;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAEhC,SAAS,aAAa,IAAI,GAAE,GAAG,EAAO;IAItC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAEnD,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAIzB,SAAS,CAAC,OAAO,IAAI,GAAG,EAAE;CAG3B;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,CAUtF"}

package/typings/token/SingleAliasToken.d.ts

@@ -4,6 +4,10 @@ import { IRegistration } from '../registration/IRegistration.js';
 import { BindToken } from './BindToken.js';
 import { ArgsFn, ResolveOptions } from '../provider/IProvider.js';
 import { Serializable } from '../utils/basic.js';
+/**
+ * Like {@link GroupAliasToken}, but resolves exactly one dependency registered
+ * under the alias, and throws `DependencyNotFoundError` when there is none.
+ */
 export declare class SingleAliasToken<T = any> extends InjectionToken<T> implements BindToken<T>, Serializable {
     readonly token: DependencyKey;
     private readonly _getArgsFn;
@@ -22,4 +26,6 @@ export declare class SingleAliasToken<T = any> extends InjectionToken<T> impleme
     addTags(...tags: string[]): SingleAliasToken<T>;
     toString(): string;
 }
+/** Creates a {@link SingleAliasToken} for `token`. */
 export declare const toSingleAlias: <T>(token: DependencyKey) => SingleAliasToken<T>;
+//# sourceMappingURL=SingleAliasToken.d.ts.map

package/typings/token/SingleAliasToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingleAliasToken.d.ts","sourceRoot":"","sources":["../../lib/token/SingleAliasToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAe,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,gBAAgB,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAE,YAAW,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY;IAKlG,QAAQ,CAAC,KAAK,EAAE,aAAa;IAJ/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGvB,KAAK,EAAE,aAAa,EAC7B,EACE,SAAuB,EACvB,MAAc,EACd,IAAS,GACV,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO;IAOnE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IACpB,GAAG,UAAU;IAGvB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,IAAS,EAAE,IAAI,EAAE,GAAE,cAAmB,GAAG,CAAC;IAOnE,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAI1B,IAAI,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;IAS1B,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,EAAE;IASvC,IAAI;IAQJ,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAQ/C,QAAQ,IAAI,MAAM;CAGnB;AAED,sDAAsD;AACtD,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,aAAa,wBAAmC,CAAC"}

package/typings/token/SingleToken.d.ts

@@ -3,6 +3,23 @@ import { InjectionToken } from './InjectionToken.js';
 import { IRegistration } from '../registration/IRegistration.js';
 import { ArgsFn, ResolveOptions } from '../provider/IProvider.js';
 import { Serializable } from '../utils/basic.js';
+/**
+ * A typed handle for one dependency key - the usual way to name a dependency.
+ * `args(...)`, `argsFn(...)` and `lazy()` return a new token and never change
+ * this one, so one token can be specialized per injection site.
+ *
+ * @example
+ * const ILoggerToken = new SingleToken<ILogger>('ILogger');
+ *
+ * @register(bindTo(ILoggerToken))
+ * class Logger implements ILogger {}
+ *
+ * class App {
+ *   constructor(@inject(by(ILoggerToken)) logger: ILogger) {}
+ * }
+ * ILoggerToken.resolve(scope);
+ * ILoggerToken.args('prefix').lazy().resolve(scope);
+ */
 export declare class SingleToken<T = any> extends InjectionToken<T> implements Serializable {
     token: DependencyKey;
     private readonly _getArgsFn;
@@ -21,3 +38,4 @@ export declare class SingleToken<T = any> extends InjectionToken<T> implements S
     addTags(...tags: string[]): SingleToken<T>;
     toString(): string;
 }
+//# sourceMappingURL=SingleToken.d.ts.map

package/typings/token/SingleToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingleToken.d.ts","sourceRoot":"","sources":["../../lib/token/SingleToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAe,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAE,YAAW,YAAY;IAKxE,KAAK,EAAE,aAAa;IAJ7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGzB,KAAK,EAAE,aAAa,EAC3B,EACE,SAAuB,EACvB,MAAc,EACd,IAAS,GACV,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO;IAOnE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IACpB,GAAG,UAAU;IAGvB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,IAAS,EAAE,IAAI,EAAE,GAAE,cAAmB,GAAG,CAAC;IAOnE,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAI1B,IAAI,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;IAS1B,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,EAAE;IASvC,IAAI;IAQJ,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC;IAQ1C,QAAQ,IAAI,MAAM;CAGnB"}

package/typings/token/toToken.d.ts

@@ -2,6 +2,18 @@ import { DependencyKey } from '../container/IContainer.js';
 import { InjectionToken } from './InjectionToken.js';
 import { InjectFn } from '../hooks/hook.js';
 import { type constructor } from '../utils/basic.js';
+/** Anything `toToken(...)` turns into a token: a token, a key, a class or an `InjectFn`. */
 export type Injectable<T = any> = InjectFn<T> | InjectionToken<T> | DependencyKey | constructor<T>;
+/**
+ * @throws {UnsupportedTokenTypeError} when `token` is not an `InjectionToken`, a `DependencyKey`, a constructor, or a function.
+ */
 export declare const toToken: <T = any>(token: Injectable<T>) => InjectionToken<T>;
+/**
+ * Wraps a runtime argument so it can be resolved uniformly: an `InjectionToken`
+ * is returned as-is, anything else becomes a `ConstantToken` of itself. The
+ * library never applies it to the args list - a call site that wants
+ * "resolve tokens, pass literals through" does so explicitly, e.g.
+ * `@inject(({ scope, args = [] }) => argToToken(args[0]).resolve(scope))`.
+ */
 export declare const argToToken: <T = unknown>(v: T) => InjectionToken<T>;
+//# sourceMappingURL=toToken.d.ts.map

package/typings/token/toToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toToken.d.ts","sourceRoot":"","sources":["../../lib/token/toToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAmB,MAAM,yBAAyB,CAAC;AAKzE,OAAO,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,WAAW,EAAM,MAAM,gBAAgB,CAAC;AAGtD,4FAA4F;AAC5F,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAEnG;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,GAAG,EAAE,OAAO,UAAU,CAAC,CAAC,CAAC,KAAG,cAAc,CAAC,CAAC,CAoBvE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,KAAG,cAAc,CAAC,CAAC,CAAwD,CAAC"}

package/typings/utils/ProxyRegistry.d.ts

@@ -1,20 +1,83 @@
+/**
+ * The proxy operations the library depends on. Depend on this rather than on
+ * {@link ProxyRegistry} itself, so a caller can substitute its own
+ * implementation - the concrete registry is a singleton and cannot be
+ * constructed a second time.
+ */
 export interface IProxyRegistry {
+    /**
+     * Returns the real object behind `value`, unwrapping proxies stacked to any
+     * depth. A value that is not a proxy is returned as is.
+     *
+     * The library calls this itself wherever a proxy would give the wrong answer -
+     * every read of class metadata (see `resolveConstructor`, `getHooks`,
+     * `resolveArgs`) and every identity check against a tracked instance (see
+     * `IContainer.hasInstance`). Pass the container's own values to those APIs as
+     * they come; unwrapping by hand is for code that needs the real object for its
+     * own reasons.
+     */
     unwrap<T extends object>(value: T): T;
     createProxy<T extends object>(target: T, handler?: ProxyHandler<T>): T;
+    /**
+     * Creates a proxy that resolves its target on first access and caches it.
+     */
     createLazyProxy<T extends object>(resolveInstance: () => T): T;
+    /**
+     * Wraps `resolveInstance` in a lazy proxy when `isLazy`, otherwise calls it
+     * right away.
+     */
     toLazyIf<T extends object>(resolveInstance: () => T, isLazy?: boolean): T;
 }
+/**
+ * Creates proxies and tracks them, so a proxy can be traced back to the real
+ * object it stands for. The library's own {@link IProxyRegistry}.
+ *
+ * Process-wide singleton: a proxy created anywhere must be unwrappable
+ * everywhere, and the registry holds no configuration that would justify a
+ * second instance. Obtain it with {@link ProxyRegistry.getInstance}.
+ *
+ * Entries are held weakly - a proxy that becomes unreachable is collected along
+ * with its state.
+ */
 export declare class ProxyRegistry implements IProxyRegistry {
     private static instance?;
     private readonly states;
     private constructor();
     static getInstance(): ProxyRegistry;
+    /**
+     * Returns the real object behind `value`, unwrapping proxies stacked to any
+     * depth. A value that is not a proxy is returned as is.
+     */
     unwrap<T extends object>(value: T): T;
     createProxy<T extends object>(target: T, handler?: ProxyHandler<T>): T;
+    /**
+     * Creates a proxy that resolves its target on first access and caches it.
+     * The target is unwrapped on resolution, so wrapping a lazy proxy in another
+     * lazy proxy never stacks beyond one level.
+     */
     createLazyProxy<T extends object>(resolveInstance: () => T): T;
+    /**
+     * Wraps `resolveInstance` in a lazy proxy when `isLazy`, otherwise calls it
+     * right away.
+     */
     toLazyIf<T extends object>(resolveInstance: () => T, isLazy?: boolean): T;
     private isProxy;
     private getTarget;
     private register;
 }
+/**
+ * The real object behind `value`, unwrapping proxies stacked to any depth. A
+ * value that is not a proxy is returned as is.
+ *
+ * A shortcut for `ProxyRegistry.getInstance().unwrap(value)` - the registry is a
+ * process-wide singleton, so unwrapping never needs an instance of its own. The
+ * library already unwraps wherever a proxy would give the wrong answer (reading
+ * class metadata, and `IContainer.hasInstance`), so reach for this only when
+ * your own code needs the real object - an identity check of your own, or
+ * bypassing a lazy proxy on purpose.
+ *
+ * Note that unwrapping a lazy proxy resolves its target, which is the point:
+ * there is no real object to hand back until it does.
+ */
 export declare const unwrapProxy: <T extends object>(value: T) => T;
+//# sourceMappingURL=ProxyRegistry.d.ts.map

package/typings/utils/ProxyRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProxyRegistry.d.ts","sourceRoot":"","sources":["../../lib/utils/ProxyRegistry.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IAEtC,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAEvE;;OAEG;IACH,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE/D;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;CAC3E;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAgB;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAEpE,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,aAAa;IAKnC;;;OAGG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAIrC,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAE,YAAY,CAAC,CAAC,CAAM,GAAG,CAAC;IAK1E;;;;OAIG;IACH,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC;IAgC9D;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAAE,OAAe,GAAG,CAAC;IAIhF,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,QAAQ;CAIjB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,OAAO,CAAC,KAAG,CAA8C,CAAC"}