ditox 3.2.0 → 3.3.1

package/dist/cjs/modules.js

@@ -1,143 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.declareModuleBindings = exports.declareModule = exports.bindModules = exports.bindModule = void 0;
-const tokens_1 = require("./tokens");
-const utils_1 = require("./utils");
-/**
- * Binds the dependency module to the container
- * @param container - Dependency container.
- * @param moduleDeclaration - Declaration of the dependency module.
- * @param options - Options for module binding.
- *
- * @example
- * ```ts
- * bindModule(container, LOGGER_MODULE);
- * ```
- */
-function bindModule(container, moduleDeclaration, options) {
-    var _a, _b, _c;
-    const rootEntry = {
-        module: moduleDeclaration,
-        options: options !== null && options !== void 0 ? options : {},
-    };
-    const bfsVisits = new Set([rootEntry]);
-    const bfsQueue = [rootEntry];
-    let bfsIndex = 0;
-    while (bfsIndex < bfsQueue.length) {
-        const entry = bfsQueue[bfsIndex];
-        const m = 'module' in entry ? entry.module : entry;
-        (_a = m.imports) === null || _a === void 0 ? void 0 : _a.forEach((depEntry) => {
-            if (!bfsVisits.has(depEntry)) {
-                bfsVisits.add(depEntry);
-                bfsQueue.push(depEntry);
-            }
-        });
-        bfsIndex++;
-    }
-    for (let i = 0; i < bfsQueue.length; i++) {
-        const entry = bfsQueue[i];
-        const m = 'module' in entry ? entry.module : entry;
-        (_b = m.beforeBinding) === null || _b === void 0 ? void 0 : _b.call(m, container);
-    }
-    for (let i = 0; i < bfsQueue.length; i++) {
-        const entry = bfsQueue[i];
-        bindModuleEntry(container, entry);
-    }
-    for (let i = bfsQueue.length - 1; i >= 0; i--) {
-        const entry = bfsQueue[i];
-        const m = 'module' in entry ? entry.module : entry;
-        (_c = m.afterBinding) === null || _c === void 0 ? void 0 : _c.call(m, container);
-    }
-}
-exports.bindModule = bindModule;
-function bindModuleEntry(container, entry) {
-    let module;
-    let options;
-    if ('module' in entry) {
-        module = entry.module;
-        options = entry.options;
-    }
-    else {
-        module = entry;
-    }
-    const scope = options === null || options === void 0 ? void 0 : options.scope;
-    const exportedValueTokens = new Set();
-    const moduleExports = module.exports;
-    if (moduleExports) {
-        const keys = Object.keys(moduleExports);
-        keys.forEach((valueKey) => {
-            const valueToken = moduleExports[valueKey];
-            if (valueToken) {
-                exportedValueTokens.add(valueToken);
-                container.bindFactory(valueToken, (0, utils_1.injectable)((module) => module[valueKey], module.token), { scope });
-            }
-        });
-    }
-    container.bindFactory(module.token, module.factory, {
-        scope,
-        onRemoved: (moduleInstance) => {
-            if (moduleInstance.destroy) {
-                moduleInstance.destroy();
-            }
-            exportedValueTokens.forEach((valueToken) => container.remove(valueToken));
-            exportedValueTokens.clear();
-        },
-    });
-}
-/**
- * Binds dependency modules to the container
- *
- * @param container - Dependency container for binding
- * @param modules - Array of module binding entries: module declaration or `{module: ModuleDeclaration, options: BindModuleOptions}` objects.
- */
-function bindModules(container, modules) {
-    modules.forEach((entry) => {
-        if ('module' in entry) {
-            bindModule(container, entry.module, entry.options);
-        }
-        else {
-            bindModule(container, entry);
-        }
-    });
-}
-exports.bindModules = bindModules;
-/**
- * Declares a module binding
- *
- * @param declaration - a module declaration
- * @param declaration.token - optional field
- *
- *  @example
- * ```ts
- * const LOGGER_MODULE = declareModule<LoggerModule>({
- *   factory: (container) => {
- *     const transport = container.resolve(TRANSPORT_TOKEN).open();
- *     return {
- *       logger: { log: (message) => transport.write(message) },
- *       destroy: () => transport.close(),
- *     }
- *   },
- *   exports: {
- *     logger: LOGGER_TOKEN,
- *   },
- * });
- * ```
- */
-function declareModule(declaration) {
-    var _a;
-    return { ...declaration, token: (_a = declaration.token) !== null && _a !== void 0 ? _a : (0, tokens_1.token)() };
-}
-exports.declareModule = declareModule;
-/**
- * Declares bindings of several modules
- *
- * @param modules - module declaration entries
- */
-function declareModuleBindings(modules) {
-    return declareModule({
-        factory: () => ({}),
-        imports: modules,
-    });
-}
-exports.declareModuleBindings = declareModuleBindings;
-//# sourceMappingURL=modules.js.map

package/dist/cjs/modules.js.map

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

package/dist/cjs/tokens.d.ts

@@ -1,56 +0,0 @@
-/**
- * @ignore
- * Binding token for mandatory value
- */
-export type RequiredToken<T> = {
-    symbol: symbol;
-    type?: T;
-    isOptional?: false;
-};
-/**
- * @ignore
- * Binding token for optional value
- */
-export type OptionalToken<T> = {
-    symbol: symbol;
-    type?: T;
-    isOptional: true;
-    optionalValue: T;
-};
-/**
- * Binding token
- */
-export type Token<T> = RequiredToken<T> | OptionalToken<T>;
-/**
- * Token options
- */
-export type TokenOptions = {
-    /**
-     * Key for token's symbol. It allows to create shareable tokens.
-     */
-    key: string;
-    /** @ignore */
-    description?: undefined;
-} | {
-    /** Description for better error messages */
-    description?: string;
-    /** @ignore */
-    key?: undefined;
-};
-/**
- * Creates a new binding token.
- * @param description - Token description for better error messages.
- */
-export declare function token<T>(description?: string): Token<T>;
-/**
- * Creates a new binding token.
- * @param options - Token description for better error messages.
- */ export declare function token<T>(options?: TokenOptions): Token<T>;
-/**
- * Decorate a token with an optional value.
- * This value is be used as default value in case a container does not have registered token.
- * @param token - Existed token.
- * @param optionalValue - Default value for the resolver.
- */
-export declare function optional<T>(token: Token<T>, optionalValue: T): OptionalToken<T>;
-export declare function optional<T>(token: Token<T>): OptionalToken<T | undefined>;

package/dist/cjs/tokens.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.optional = exports.token = void 0;
-function token(options) {
-    const normalized = typeof options === 'string' ? { description: options } : options;
-    const symbol = (normalized === null || normalized === void 0 ? void 0 : normalized.key)
-        ? Symbol.for(normalized.key)
-        : Symbol(normalized === null || normalized === void 0 ? void 0 : normalized.description);
-    return { symbol };
-}
-exports.token = token;
-function optional(token, optionalValue) {
-    return {
-        symbol: token.symbol,
-        isOptional: true,
-        optionalValue,
-    };
-}
-exports.optional = optional;
-//# sourceMappingURL=tokens.js.map

package/dist/cjs/tokens.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/tokens.ts"],"names":[],"mappings":";;;AAwDA,SAAgB,KAAK,CAAI,OAA+B;IACtD,MAAM,UAAU,GACd,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAC,WAAW,EAAE,OAAO,EAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAEjE,MAAM,MAAM,GAAW,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,GAAG;QACpC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAC5B,CAAC,CAAC,MAAM,CAAC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,WAAW,CAAC,CAAC;IAEpC,OAAO,EAAC,MAAM,EAAC,CAAC;AAClB,CAAC;AATD,sBASC;AAaD,SAAgB,QAAQ,CACtB,KAAe,EACf,aAAiB;IAEjB,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,aAAa;KACd,CAAC;AACJ,CAAC;AATD,4BASC"}

package/dist/cjs/utils.d.ts

@@ -1,137 +0,0 @@
-import type { Container } from './container';
-import { Token } from './tokens';
-type ValuesProps = {
-    [key: string]: unknown;
-};
-type TokenProps<Props extends ValuesProps> = {
-    [K in keyof Props]: Token<Props[K]>;
-};
-/**
- * Checks if a value is the token
- */
-export declare function isToken<T>(value: unknown): value is Token<T>;
-/**
- * Rebinds the array by the token with added new value.
- * @param container - Dependency container.
- * @param token - Token for an array of values.
- * @param value - New value which is added to the end of the array.
- */
-export declare function bindMultiValue<T>(container: Container, token: Token<ReadonlyArray<T>>, value: T): void;
-/**
- * Tries to resolve a value by the provided token.
- *
- * If an argument is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
-
- * If a token is not found, then `undefined` value is used.
- *
- * @example
- * ```ts
- * const value = tryResolveValue(container, tokenA);
- * console.log(value); // 1
- *
- * const props = tryResolveValue(container, {a: tokenA, b: tokenB});
- * console.log(props); // {a: 1, b: 2}
- * ```
- */
-export declare function tryResolveValue<Tokens extends Token<unknown> | {
-    [key: string]: Token<unknown>;
-}, Values extends Tokens extends Token<infer V> ? V | undefined : Tokens extends TokenProps<infer Props> ? Partial<Props> : never>(container: Container, token: Tokens): Values;
-/**
- * Returns an array of resolved values or objects with resolved values.
- *
- * If an item of the array is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
-
- * If a token is not found, then `undefined` value is used.
- *
- * @example
- * ```ts
- * const items1 = tryResolveValues(container, tokenA);
- * console.log(items1); // [1]
- *
- * const items2 = tryResolveValues(container, tokenA, {a: tokenA, b: tokenB});
- * console.log(items2); // [1, {a: 1, b: 2}]
- * ```
- */
-export declare function tryResolveValues<Tokens extends (Token<unknown> | {
-    [key: string]: Token<unknown>;
-})[], Values extends {
-    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V | undefined : Tokens[K] extends TokenProps<infer Props> ? Partial<Props> : never;
-}>(container: Container, ...tokens: Tokens): Values;
-/**
- * Resolves a value by the provided token.
- *
- * If an argument is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
-
- * If a value is not found by the token, then `ResolverError` is thrown.
- *
- * @example
- * ```ts
- * const value = resolveValue(container, tokenA);
- * console.log(value); // 1
- *
- * const props = resolveValue(container, {a: tokenA, b: tokenB});
- * console.log(props); // {a: 1, b: 2}
- * ```
- */
-export declare function resolveValue<Tokens extends Token<unknown> | {
-    [key: string]: Token<unknown>;
-}, Values extends Tokens extends Token<infer V> ? V : Tokens extends TokenProps<infer Props> ? Props : never>(container: Container, token: Tokens): Values;
-/**
- * Returns an array of resolved values or objects with resolved values.
- *
- * If an item of the array is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
-
- * If a token is not found, then `ResolverError` is thrown.
- *
- * @example
- * ```ts
- * const items1 = resolveValues(container, tokenA);
- * console.log(items1); // [1]
- *
- * const items2 = resolveValues(container, tokenA, {a: tokenA, b: tokenB});
- * console.log(items2); // [1, {a: 1, b: 2}]
- * ```
- */
-export declare function resolveValues<Tokens extends (Token<unknown> | {
-    [key: string]: Token<unknown>;
-})[], Values extends {
-    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps<infer Props> ? Props : never;
-}>(container: Container, ...tokens: Tokens): Values;
-/**
- * Decorates a factory by passing resolved values as factory arguments.
- *
- * If an argument is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
- *
- * @param factory - A factory.
- * @param tokens - Tokens which correspond to factory arguments.
- *
- * @return Decorated factory which takes a dependency container as a single argument.
- */
-export declare function injectable<Tokens extends (Token<unknown> | {
-    [key: string]: Token<unknown>;
-})[], Values extends {
-    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps<infer Props> ? Props : never;
-}, Result>(this: unknown, factory: (...params: Values) => Result, ...tokens: Tokens): (container: Container) => Result;
-/**
- * Decorates a class by passing resolved values as arguments to its constructor.
- *
- * If an argument is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
- *
- * @param constructor - Constructor of a class
- * @param tokens - Tokens which correspond to constructor arguments
- *
- * @return A factory function which takes a dependency container as a single argument
- * and returns a new created class.
- */
-export declare function injectableClass<Tokens extends (Token<unknown> | {
-    [key: string]: Token<unknown>;
-})[], Values extends {
-    [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps<infer Props> ? Props : never;
-}, Result>(this: unknown, constructor: new (...params: Values) => Result, ...tokens: Tokens): (container: Container) => Result;
-export {};

package/dist/cjs/utils.js

@@ -1,156 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.injectableClass = exports.injectable = exports.resolveValues = exports.resolveValue = exports.tryResolveValues = exports.tryResolveValue = exports.bindMultiValue = exports.isToken = void 0;
-/**
- * Checks if a value is the token
- */
-function isToken(value) {
-    return (value !== undefined &&
-        value !== null &&
-        typeof value === 'object' &&
-        'symbol' in value &&
-        typeof value.symbol === 'symbol');
-}
-exports.isToken = isToken;
-/**
- * Rebinds the array by the token with added new value.
- * @param container - Dependency container.
- * @param token - Token for an array of values.
- * @param value - New value which is added to the end of the array.
- */
-function bindMultiValue(container, token, value) {
-    var _a;
-    const prevValues = (_a = container.get(token)) !== null && _a !== void 0 ? _a : [];
-    const nextValues = [...prevValues, value];
-    container.bindValue(token, nextValues);
-}
-exports.bindMultiValue = bindMultiValue;
-/**
- * Tries to resolve a value by the provided token.
- *
- * If an argument is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
-
- * If a token is not found, then `undefined` value is used.
- *
- * @example
- * ```ts
- * const value = tryResolveValue(container, tokenA);
- * console.log(value); // 1
- *
- * const props = tryResolveValue(container, {a: tokenA, b: tokenB});
- * console.log(props); // {a: 1, b: 2}
- * ```
- */
-function tryResolveValue(container, token) {
-    if (isToken(token)) {
-        return container.get(token);
-    }
-    const obj = {};
-    Object.keys(token).forEach((key) => (obj[key] = container.get(token[key])));
-    return obj;
-}
-exports.tryResolveValue = tryResolveValue;
-/**
- * Returns an array of resolved values or objects with resolved values.
- *
- * If an item of the array is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
-
- * If a token is not found, then `undefined` value is used.
- *
- * @example
- * ```ts
- * const items1 = tryResolveValues(container, tokenA);
- * console.log(items1); // [1]
- *
- * const items2 = tryResolveValues(container, tokenA, {a: tokenA, b: tokenB});
- * console.log(items2); // [1, {a: 1, b: 2}]
- * ```
- */
-function tryResolveValues(container, ...tokens) {
-    return tokens.map((item) => tryResolveValue(container, item));
-}
-exports.tryResolveValues = tryResolveValues;
-/**
- * Resolves a value by the provided token.
- *
- * If an argument is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
-
- * If a value is not found by the token, then `ResolverError` is thrown.
- *
- * @example
- * ```ts
- * const value = resolveValue(container, tokenA);
- * console.log(value); // 1
- *
- * const props = resolveValue(container, {a: tokenA, b: tokenB});
- * console.log(props); // {a: 1, b: 2}
- * ```
- */
-function resolveValue(container, token) {
-    if (isToken(token)) {
-        return container.resolve(token);
-    }
-    const obj = {};
-    Object.keys(token).forEach((key) => (obj[key] = container.resolve(token[key])));
-    return obj;
-}
-exports.resolveValue = resolveValue;
-/**
- * Returns an array of resolved values or objects with resolved values.
- *
- * If an item of the array is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
-
- * If a token is not found, then `ResolverError` is thrown.
- *
- * @example
- * ```ts
- * const items1 = resolveValues(container, tokenA);
- * console.log(items1); // [1]
- *
- * const items2 = resolveValues(container, tokenA, {a: tokenA, b: tokenB});
- * console.log(items2); // [1, {a: 1, b: 2}]
- * ```
- */
-function resolveValues(container, ...tokens) {
-    return tokens.map((item) => resolveValue(container, item));
-}
-exports.resolveValues = resolveValues;
-/**
- * Decorates a factory by passing resolved values as factory arguments.
- *
- * If an argument is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
- *
- * @param factory - A factory.
- * @param tokens - Tokens which correspond to factory arguments.
- *
- * @return Decorated factory which takes a dependency container as a single argument.
- */
-function injectable(factory, ...tokens) {
-    return (container) => {
-        const values = resolveValues(container, ...tokens);
-        return factory.apply(this, values);
-    };
-}
-exports.injectable = injectable;
-/**
- * Decorates a class by passing resolved values as arguments to its constructor.
- *
- * If an argument is an object which has tokens as its properties,
- * then returns an object containing resolved values as properties.
- *
- * @param constructor - Constructor of a class
- * @param tokens - Tokens which correspond to constructor arguments
- *
- * @return A factory function which takes a dependency container as a single argument
- * and returns a new created class.
- */
-function injectableClass(constructor, ...tokens) {
-    return injectable((...values) => new constructor(...values), ...tokens);
-}
-exports.injectableClass = injectableClass;
-//# sourceMappingURL=utils.js.map

package/dist/cjs/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";;;AAQA;;GAEG;AACH,SAAgB,OAAO,CAAI,KAAc;IACvC,OAAO,CACL,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,OAAQ,KAAa,CAAC,MAAM,KAAK,QAAQ,CAC1C,CAAC;AACJ,CAAC;AARD,0BAQC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,SAAoB,EACpB,KAA8B,EAC9B,KAAQ;;IAER,MAAM,UAAU,GAAG,MAAA,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC;IAC1C,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AARD,wCAQC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAO7B,SAAoB,EAAE,KAAa;IACnC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE;QAClB,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,CAAW,CAAC;KACvC;IAED,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,GAAG,CAAC;AACb,CAAC;AAfD,0CAeC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,gBAAgB,CAS9B,SAAoB,EAAE,GAAG,MAAc;IACvC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAW,CAAC;AAC1E,CAAC;AAXD,4CAWC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,YAAY,CAO1B,SAAoB,EAAE,KAAa;IACnC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE;QAClB,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAW,CAAC;KAC3C;IAED,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CACxB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CACpD,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAjBD,oCAiBC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,aAAa,CAS3B,SAAoB,EAAE,GAAG,MAAc;IACvC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAW,CAAC;AACvE,CAAC;AAXD,sCAWC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,UAAU,CAYxB,OAAsC,EACtC,GAAG,MAAc;IAEjB,OAAO,CAAC,SAAS,EAAE,EAAE;QACnB,MAAM,MAAM,GAAW,aAAa,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,CAAC;QAC3D,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC;AAnBD,gCAmBC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAY7B,WAA8C,EAC9C,GAAG,MAAc;IAEjB,OAAO,UAAU,CACf,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,GAAG,MAAM,CAAC,EACzC,GAAG,MAAM,CACV,CAAC;AACJ,CAAC;AAnBD,0CAmBC"}

package/dist/esm/container.d.ts

@@ -1,93 +0,0 @@
-import { Token } from './tokens';
-/**
- * ResolverError is thrown by the resolver when a token is not found in a container.
- */
-export declare class ResolverError extends Error {
-    constructor(message: string);
-}
-/**
- * @see https://github.com/mnasyrov/ditox#factory-lifetimes
- */
-export type FactoryScope = 'scoped' | 'singleton' | 'transient';
-/**
- * Options for factory binding.
- *
- * `scope` types:
- *   - `singleton` - **This is the default**. The value is created and cached by the most distant parent container which owns the factory function.
- *   - `scoped` - The value is created and cached by the nearest container which owns the factory function.
- *   - `transient` - The value is created every time it is resolved.
- *
- * `scoped` and `singleton` scopes can have `onRemoved` callback. It is called when a token is removed from the container.
- */
-export type FactoryOptions<T> = {
-    scope?: 'scoped' | 'singleton';
-    onRemoved?: (value: T) => void;
-} | {
-    scope: 'transient';
-};
-/**
- * Dependency container.
- */
-export type Container = {
-    /**
-     * Binds a value for the token
-     */
-    bindValue<T>(token: Token<T>, value: T): void;
-    /**
-     * Binds a factory for the token.
-     */
-    bindFactory<T>(token: Token<T>, factory: (container: Container) => T, options?: FactoryOptions<T>): void;
-    /**
-     * Checks if the token is registered in the container hierarchy.
-     */
-    hasToken(token: Token<unknown>): boolean;
-    /**
-     * Returns a resolved value by the token, or returns `undefined` in case the token is not found.
-     */
-    get<T>(token: Token<T>): T | undefined;
-    /**
-     * Returns a resolved value by the token or throws `ResolverError` in case the token is not found.
-     */
-    resolve<T>(token: Token<T>): T;
-    /**
-     * Removes a binding for the token.
-     */
-    remove<T>(token: Token<T>): void;
-    /**
-     * Removes all bindings in the container.
-     */
-    removeAll(): void;
-};
-/**
- * A subset of Container interface that provides read-only access to dependency resolution.
- * This type is used for parent containers to allow token resolution without exposing mutation methods.
- */
-export type ContainerResolver = Pick<Container, 'hasToken' | 'get' | 'resolve'>;
-/** @internal */
-export declare const CONTAINER: Token<Container>;
-/** @internal */
-export declare const PARENT_CONTAINERS: Token<ReadonlyArray<Container>>;
-/** @internal */
-export declare const RESOLVER: Token<Resolver>;
-/** @internal */
-declare const NOT_FOUND: unique symbol;
-/** @internal */
-type FactoryContext<T> = {
-    factory: (container: Container) => T;
-    options?: FactoryOptions<T>;
-};
-/** @internal */
-export type FactoriesMap = Map<symbol, FactoryContext<any>>;
-/** @internal */
-export declare const FACTORIES_MAP: Token<FactoriesMap>;
-/** @internal */
-type Resolver = <T>(token: Token<T>, origin: Container) => T | typeof NOT_FOUND;
-/**
- * Creates a new dependency container.
- *
- * Container can have an optional parent to chain token resolution. The parent is used in case the current container does not have a registered token.
- *
- * @param parentArg - Optional parent container or an array of containers.
- */
-export declare function createContainer(parentArg?: ContainerResolver | ReadonlyArray<ContainerResolver>): Container;
-export {};