ditox 3.1.0 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +135 -32
  2. package/dist/index.cjs +518 -0
  3. package/dist/index.cjs.map +1 -0
  4. package/dist/{umd/index.d.ts → index.d.cts} +195 -197
  5. package/dist/{browser/index.d.ts → index.d.ts} +195 -197
  6. package/dist/index.js +501 -0
  7. package/dist/index.js.map +1 -0
  8. package/dist/index.umd.js +524 -0
  9. package/dist/index.umd.js.map +1 -0
  10. package/package.json +22 -19
  11. package/src/container.test.ts +34 -33
  12. package/src/container.ts +12 -6
  13. package/src/index.ts +26 -23
  14. package/src/modules.test.ts +172 -37
  15. package/src/modules.ts +22 -5
  16. package/src/tokens.test.ts +9 -8
  17. package/src/tokens.ts +2 -2
  18. package/src/utils.test.ts +18 -17
  19. package/src/utils.ts +21 -21
  20. package/dist/browser/index.js +0 -2
  21. package/dist/browser/index.js.map +0 -1
  22. package/dist/cjs/container.d.ts +0 -88
  23. package/dist/cjs/container.js +0 -216
  24. package/dist/cjs/container.js.map +0 -1
  25. package/dist/cjs/index.d.ts +0 -7
  26. package/dist/cjs/index.js +0 -24
  27. package/dist/cjs/index.js.map +0 -1
  28. package/dist/cjs/modules.d.ts +0 -121
  29. package/dist/cjs/modules.js +0 -143
  30. package/dist/cjs/modules.js.map +0 -1
  31. package/dist/cjs/tokens.d.ts +0 -56
  32. package/dist/cjs/tokens.js +0 -20
  33. package/dist/cjs/tokens.js.map +0 -1
  34. package/dist/cjs/utils.d.ts +0 -137
  35. package/dist/cjs/utils.js +0 -156
  36. package/dist/cjs/utils.js.map +0 -1
  37. package/dist/esm/container.d.ts +0 -88
  38. package/dist/esm/container.js +0 -211
  39. package/dist/esm/container.js.map +0 -1
  40. package/dist/esm/index.d.ts +0 -7
  41. package/dist/esm/index.js +0 -5
  42. package/dist/esm/index.js.map +0 -1
  43. package/dist/esm/modules.d.ts +0 -121
  44. package/dist/esm/modules.js +0 -136
  45. package/dist/esm/modules.js.map +0 -1
  46. package/dist/esm/tokens.d.ts +0 -56
  47. package/dist/esm/tokens.js +0 -15
  48. package/dist/esm/tokens.js.map +0 -1
  49. package/dist/esm/utils.d.ts +0 -137
  50. package/dist/esm/utils.js +0 -145
  51. package/dist/esm/utils.js.map +0 -1
  52. package/dist/umd/index.js +0 -2
  53. package/dist/umd/index.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/container.ts"],"names":[],"mappings":"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"}
@@ -1,7 +0,0 @@
1
- export { token, optional } from './tokens';
2
- export type { RequiredToken, OptionalToken, Token } from './tokens';
3
- export { ResolverError, createContainer } from './container';
4
- export type { FactoryScope, FactoryOptions, Container } from './container';
5
- export { isToken, bindMultiValue, tryResolveValue, tryResolveValues, resolveValue, resolveValues, injectable, injectableClass, } from './utils';
6
- export { bindModule, bindModules, declareModule, declareModuleBindings, } from './modules';
7
- export type { Module, ModuleDeclaration, BindModuleOptions, ModuleBindingEntry, } from './modules';
package/dist/cjs/index.js DELETED
@@ -1,24 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.declareModuleBindings = exports.declareModule = exports.bindModules = exports.bindModule = exports.injectableClass = exports.injectable = exports.resolveValues = exports.resolveValue = exports.tryResolveValues = exports.tryResolveValue = exports.bindMultiValue = exports.isToken = exports.createContainer = exports.ResolverError = exports.optional = exports.token = void 0;
4
- var tokens_1 = require("./tokens");
5
- Object.defineProperty(exports, "token", { enumerable: true, get: function () { return tokens_1.token; } });
6
- Object.defineProperty(exports, "optional", { enumerable: true, get: function () { return tokens_1.optional; } });
7
- var container_1 = require("./container");
8
- Object.defineProperty(exports, "ResolverError", { enumerable: true, get: function () { return container_1.ResolverError; } });
9
- Object.defineProperty(exports, "createContainer", { enumerable: true, get: function () { return container_1.createContainer; } });
10
- var utils_1 = require("./utils");
11
- Object.defineProperty(exports, "isToken", { enumerable: true, get: function () { return utils_1.isToken; } });
12
- Object.defineProperty(exports, "bindMultiValue", { enumerable: true, get: function () { return utils_1.bindMultiValue; } });
13
- Object.defineProperty(exports, "tryResolveValue", { enumerable: true, get: function () { return utils_1.tryResolveValue; } });
14
- Object.defineProperty(exports, "tryResolveValues", { enumerable: true, get: function () { return utils_1.tryResolveValues; } });
15
- Object.defineProperty(exports, "resolveValue", { enumerable: true, get: function () { return utils_1.resolveValue; } });
16
- Object.defineProperty(exports, "resolveValues", { enumerable: true, get: function () { return utils_1.resolveValues; } });
17
- Object.defineProperty(exports, "injectable", { enumerable: true, get: function () { return utils_1.injectable; } });
18
- Object.defineProperty(exports, "injectableClass", { enumerable: true, get: function () { return utils_1.injectableClass; } });
19
- var modules_1 = require("./modules");
20
- Object.defineProperty(exports, "bindModule", { enumerable: true, get: function () { return modules_1.bindModule; } });
21
- Object.defineProperty(exports, "bindModules", { enumerable: true, get: function () { return modules_1.bindModules; } });
22
- Object.defineProperty(exports, "declareModule", { enumerable: true, get: function () { return modules_1.declareModule; } });
23
- Object.defineProperty(exports, "declareModuleBindings", { enumerable: true, get: function () { return modules_1.declareModuleBindings; } });
24
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAyC;AAAjC,+FAAA,KAAK,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAGvB,yCAA2D;AAAnD,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAGtC,iCASiB;AARf,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,mGAAA,UAAU,OAAA;AACV,wGAAA,eAAe,OAAA;AAGjB,qCAKmB;AAJjB,qGAAA,UAAU,OAAA;AACV,sGAAA,WAAW,OAAA;AACX,wGAAA,aAAa,OAAA;AACb,gHAAA,qBAAqB,OAAA"}
@@ -1,121 +0,0 @@
1
- import { Container } from './container';
2
- import { Token } from './tokens';
3
- type AnyObject = Record<string, any>;
4
- type EmptyObject = Record<string, never>;
5
- type ModuleController = {
6
- /** Dispose the module and clean its resources */
7
- destroy?: () => void;
8
- };
9
- /**
10
- * Dependency module
11
- *
12
- * @example
13
- * ```ts
14
- * type LoggerModule = Module<{
15
- * logger: Logger;
16
- * }>;
17
- * ```
18
- */
19
- export type Module<ModuleProps extends AnyObject = EmptyObject> = ModuleController & ModuleProps;
20
- type GetModuleProps<T> = T extends Module<infer Props> ? Props : never;
21
- /**
22
- * Description how to bind the module in declarative way.
23
- *
24
- * @example
25
- * ```ts
26
- * const LOGGER_MODULE: ModuleDeclaration<LoggerModule> = {
27
- * token: LOGGER_MODULE_TOKEN,
28
- * factory: (container) => {
29
- * const transport = container.resolve(TRANSPORT_TOKEN).open();
30
- * return {
31
- * logger: { log: (message) => transport.write(message) },
32
- * destroy: () => transport.close(),
33
- * }
34
- * },
35
- * exports: {
36
- * logger: LOGGER_TOKEN,
37
- * },
38
- * };
39
- * ```
40
- */
41
- export type ModuleDeclaration<T extends Module<AnyObject>> = {
42
- /** Token for the module */
43
- token: Token<T>;
44
- /** Modules for binding */
45
- imports?: ReadonlyArray<ModuleBindingEntry>;
46
- /** Factory of the module */
47
- factory: (container: Container) => T;
48
- /** Dictionary of module properties which are bound to tokens. */
49
- exports?: {
50
- [K in keyof GetModuleProps<T>]?: Token<GetModuleProps<T>[K]>;
51
- };
52
- /** Callback could be used to prepare an environment. It is called before binding the module. */
53
- beforeBinding?: (container: Container) => void;
54
- /** Callback could be used to export complex dependencies from the module. It is called after binding the module. */
55
- afterBinding?: (container: Container) => void;
56
- };
57
- export type AnyModuleDeclaration = ModuleDeclaration<Module<AnyObject>>;
58
- /**
59
- * Options for module binding.
60
- *
61
- * `scope` types:
62
- * - `singleton` - **This is the default**. The value is created and cached by the most distant parent container which owns the factory function.
63
- * - `scoped` - The value is created and cached by the nearest container which owns the factory function.
64
- */
65
- export type BindModuleOptions = {
66
- scope?: 'scoped' | 'singleton';
67
- };
68
- type ModuleDeclarationWithOptions = {
69
- module: ModuleDeclaration<AnyObject>;
70
- options: BindModuleOptions;
71
- };
72
- export type ModuleBindingEntry = ModuleDeclaration<AnyObject> | ModuleDeclarationWithOptions;
73
- /**
74
- * Binds the dependency module to the container
75
- * @param container - Dependency container.
76
- * @param moduleDeclaration - Declaration of the dependency module.
77
- * @param options - Options for module binding.
78
- *
79
- * @example
80
- * ```ts
81
- * bindModule(container, LOGGER_MODULE);
82
- * ```
83
- */
84
- export declare function bindModule<T extends Module<AnyObject>>(container: Container, moduleDeclaration: ModuleDeclaration<T>, options?: BindModuleOptions): void;
85
- /**
86
- * Binds dependency modules to the container
87
- *
88
- * @param container - Dependency container for binding
89
- * @param modules - Array of module binding entries: module declaration or `{module: ModuleDeclaration, options: BindModuleOptions}` objects.
90
- */
91
- export declare function bindModules(container: Container, modules: ReadonlyArray<ModuleBindingEntry>): void;
92
- /**
93
- * Declares a module binding
94
- *
95
- * @param declaration - a module declaration
96
- * @param declaration.token - optional field
97
- *
98
- * @example
99
- * ```ts
100
- * const LOGGER_MODULE = declareModule<LoggerModule>({
101
- * factory: (container) => {
102
- * const transport = container.resolve(TRANSPORT_TOKEN).open();
103
- * return {
104
- * logger: { log: (message) => transport.write(message) },
105
- * destroy: () => transport.close(),
106
- * }
107
- * },
108
- * exports: {
109
- * logger: LOGGER_TOKEN,
110
- * },
111
- * });
112
- * ```
113
- */
114
- export declare function declareModule<T extends Module<AnyObject>>(declaration: Omit<ModuleDeclaration<T>, 'token'> & Partial<Pick<ModuleDeclaration<T>, 'token'>>): ModuleDeclaration<T>;
115
- /**
116
- * Declares bindings of several modules
117
- *
118
- * @param modules - module declaration entries
119
- */
120
- export declare function declareModuleBindings(modules: ReadonlyArray<ModuleBindingEntry>): ModuleDeclaration<Module>;
121
- export {};
@@ -1,143 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.declareModuleBindings = exports.declareModule = exports.bindModules = exports.bindModule = void 0;
4
- const tokens_1 = require("./tokens");
5
- const utils_1 = require("./utils");
6
- /**
7
- * Binds the dependency module to the container
8
- * @param container - Dependency container.
9
- * @param moduleDeclaration - Declaration of the dependency module.
10
- * @param options - Options for module binding.
11
- *
12
- * @example
13
- * ```ts
14
- * bindModule(container, LOGGER_MODULE);
15
- * ```
16
- */
17
- function bindModule(container, moduleDeclaration, options) {
18
- var _a, _b, _c;
19
- const rootEntry = {
20
- module: moduleDeclaration,
21
- options: options !== null && options !== void 0 ? options : {},
22
- };
23
- const bfsVisits = new Set([rootEntry]);
24
- const bfsQueue = [rootEntry];
25
- let bfsIndex = 0;
26
- while (bfsIndex < bfsQueue.length) {
27
- const entry = bfsQueue[bfsIndex];
28
- const m = 'module' in entry ? entry.module : entry;
29
- (_a = m.imports) === null || _a === void 0 ? void 0 : _a.forEach((depEntry) => {
30
- if (!bfsVisits.has(depEntry)) {
31
- bfsVisits.add(depEntry);
32
- bfsQueue.push(depEntry);
33
- }
34
- });
35
- bfsIndex++;
36
- }
37
- for (let i = 0; i < bfsQueue.length; i++) {
38
- const entry = bfsQueue[i];
39
- const m = 'module' in entry ? entry.module : entry;
40
- (_b = m.beforeBinding) === null || _b === void 0 ? void 0 : _b.call(m, container);
41
- }
42
- for (let i = 0; i < bfsQueue.length; i++) {
43
- const entry = bfsQueue[i];
44
- bindModuleEntry(container, entry);
45
- }
46
- for (let i = bfsQueue.length - 1; i >= 0; i--) {
47
- const entry = bfsQueue[i];
48
- const m = 'module' in entry ? entry.module : entry;
49
- (_c = m.afterBinding) === null || _c === void 0 ? void 0 : _c.call(m, container);
50
- }
51
- }
52
- exports.bindModule = bindModule;
53
- function bindModuleEntry(container, entry) {
54
- let module;
55
- let options;
56
- if ('module' in entry) {
57
- module = entry.module;
58
- options = entry.options;
59
- }
60
- else {
61
- module = entry;
62
- }
63
- const scope = options === null || options === void 0 ? void 0 : options.scope;
64
- const exportedValueTokens = new Set();
65
- const moduleExports = module.exports;
66
- if (moduleExports) {
67
- const keys = Object.keys(moduleExports);
68
- keys.forEach((valueKey) => {
69
- const valueToken = moduleExports[valueKey];
70
- if (valueToken) {
71
- exportedValueTokens.add(valueToken);
72
- container.bindFactory(valueToken, (0, utils_1.injectable)((module) => module[valueKey], module.token), { scope });
73
- }
74
- });
75
- }
76
- container.bindFactory(module.token, module.factory, {
77
- scope,
78
- onRemoved: (moduleInstance) => {
79
- if (moduleInstance.destroy) {
80
- moduleInstance.destroy();
81
- }
82
- exportedValueTokens.forEach((valueToken) => container.remove(valueToken));
83
- exportedValueTokens.clear();
84
- },
85
- });
86
- }
87
- /**
88
- * Binds dependency modules to the container
89
- *
90
- * @param container - Dependency container for binding
91
- * @param modules - Array of module binding entries: module declaration or `{module: ModuleDeclaration, options: BindModuleOptions}` objects.
92
- */
93
- function bindModules(container, modules) {
94
- modules.forEach((entry) => {
95
- if ('module' in entry) {
96
- bindModule(container, entry.module, entry.options);
97
- }
98
- else {
99
- bindModule(container, entry);
100
- }
101
- });
102
- }
103
- exports.bindModules = bindModules;
104
- /**
105
- * Declares a module binding
106
- *
107
- * @param declaration - a module declaration
108
- * @param declaration.token - optional field
109
- *
110
- * @example
111
- * ```ts
112
- * const LOGGER_MODULE = declareModule<LoggerModule>({
113
- * factory: (container) => {
114
- * const transport = container.resolve(TRANSPORT_TOKEN).open();
115
- * return {
116
- * logger: { log: (message) => transport.write(message) },
117
- * destroy: () => transport.close(),
118
- * }
119
- * },
120
- * exports: {
121
- * logger: LOGGER_TOKEN,
122
- * },
123
- * });
124
- * ```
125
- */
126
- function declareModule(declaration) {
127
- var _a;
128
- return { ...declaration, token: (_a = declaration.token) !== null && _a !== void 0 ? _a : (0, tokens_1.token)() };
129
- }
130
- exports.declareModule = declareModule;
131
- /**
132
- * Declares bindings of several modules
133
- *
134
- * @param modules - module declaration entries
135
- */
136
- function declareModuleBindings(modules) {
137
- return declareModule({
138
- factory: () => ({}),
139
- imports: modules,
140
- });
141
- }
142
- exports.declareModuleBindings = declareModuleBindings;
143
- //# sourceMappingURL=modules.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/modules.ts"],"names":[],"mappings":"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"}
@@ -1,56 +0,0 @@
1
- /**
2
- * @ignore
3
- * Binding token for mandatory value
4
- */
5
- export type RequiredToken<T> = {
6
- symbol: symbol;
7
- type?: T;
8
- isOptional?: false;
9
- };
10
- /**
11
- * @ignore
12
- * Binding token for optional value
13
- */
14
- export type OptionalToken<T> = {
15
- symbol: symbol;
16
- type?: T;
17
- isOptional: true;
18
- optionalValue: T;
19
- };
20
- /**
21
- * Binding token
22
- */
23
- export type Token<T> = RequiredToken<T> | OptionalToken<T>;
24
- /**
25
- * Token options
26
- */
27
- export type TokenOptions = {
28
- /**
29
- * Key for token's symbol. It allows to create shareable tokens.
30
- */
31
- key: string;
32
- /** @ignore */
33
- description?: undefined;
34
- } | {
35
- /** Description for better error messages */
36
- description?: string;
37
- /** @ignore */
38
- key?: undefined;
39
- };
40
- /**
41
- * Creates a new binding token.
42
- * @param description - Token description for better error messages.
43
- */
44
- export declare function token<T>(description?: string): Token<T>;
45
- /**
46
- * Creates a new binding token.
47
- * @param options - Token description for better error messages.
48
- */ export declare function token<T>(options?: TokenOptions): Token<T>;
49
- /**
50
- * Decorate a token with an optional value.
51
- * This value is be used as default value in case a container does not have registered token.
52
- * @param token - Existed token.
53
- * @param optionalValue - Default value for the resolver.
54
- */
55
- export declare function optional<T>(token: Token<T>, optionalValue: T): OptionalToken<T>;
56
- export declare function optional<T>(token: Token<T>): OptionalToken<T | undefined>;
@@ -1,20 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.optional = exports.token = void 0;
4
- function token(options) {
5
- const normalized = typeof options === 'string' ? { description: options } : options;
6
- const symbol = (normalized === null || normalized === void 0 ? void 0 : normalized.key)
7
- ? Symbol.for(normalized.key)
8
- : Symbol(normalized === null || normalized === void 0 ? void 0 : normalized.description);
9
- return { symbol };
10
- }
11
- exports.token = token;
12
- function optional(token, optionalValue) {
13
- return {
14
- symbol: token.symbol,
15
- isOptional: true,
16
- optionalValue,
17
- };
18
- }
19
- exports.optional = optional;
20
- //# sourceMappingURL=tokens.js.map
@@ -1 +0,0 @@
1
- {"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"}
@@ -1,137 +0,0 @@
1
- import type { Container } from './container';
2
- import { Token } from './tokens';
3
- type ValuesProps = {
4
- [key: string]: unknown;
5
- };
6
- type TokenProps<Props extends ValuesProps> = {
7
- [K in keyof Props]: Token<Props[K]>;
8
- };
9
- /**
10
- * Checks if a value is the token
11
- */
12
- export declare function isToken<T>(value: unknown): value is Token<T>;
13
- /**
14
- * Rebinds the array by the token with added new value.
15
- * @param container - Dependency container.
16
- * @param token - Token for an array of values.
17
- * @param value - New value which is added to the end of the array.
18
- */
19
- export declare function bindMultiValue<T>(container: Container, token: Token<ReadonlyArray<T>>, value: T): void;
20
- /**
21
- * Tries to resolve a value by the provided token.
22
- *
23
- * If an argument is an object which has tokens as its properties,
24
- * then returns an object containing resolved values as properties.
25
-
26
- * If a token is not found, then `undefined` value is used.
27
- *
28
- * @example
29
- * ```ts
30
- * const value = tryResolveValue(container, tokenA);
31
- * console.log(value); // 1
32
- *
33
- * const props = tryResolveValue(container, {a: tokenA, b: tokenB});
34
- * console.log(props); // {a: 1, b: 2}
35
- * ```
36
- */
37
- export declare function tryResolveValue<Tokens extends Token<unknown> | {
38
- [key: string]: Token<unknown>;
39
- }, Values extends Tokens extends Token<infer V> ? V | undefined : Tokens extends TokenProps<infer Props> ? Partial<Props> : never>(container: Container, token: Tokens): Values;
40
- /**
41
- * Returns an array of resolved values or objects with resolved values.
42
- *
43
- * If an item of the array is an object which has tokens as its properties,
44
- * then returns an object containing resolved values as properties.
45
-
46
- * If a token is not found, then `undefined` value is used.
47
- *
48
- * @example
49
- * ```ts
50
- * const items1 = tryResolveValues(container, tokenA);
51
- * console.log(items1); // [1]
52
- *
53
- * const items2 = tryResolveValues(container, tokenA, {a: tokenA, b: tokenB});
54
- * console.log(items2); // [1, {a: 1, b: 2}]
55
- * ```
56
- */
57
- export declare function tryResolveValues<Tokens extends (Token<unknown> | {
58
- [key: string]: Token<unknown>;
59
- })[], Values extends {
60
- [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V | undefined : Tokens[K] extends TokenProps<infer Props> ? Partial<Props> : never;
61
- }>(container: Container, ...tokens: Tokens): Values;
62
- /**
63
- * Resolves a value by the provided token.
64
- *
65
- * If an argument is an object which has tokens as its properties,
66
- * then returns an object containing resolved values as properties.
67
-
68
- * If a value is not found by the token, then `ResolverError` is thrown.
69
- *
70
- * @example
71
- * ```ts
72
- * const value = resolveValue(container, tokenA);
73
- * console.log(value); // 1
74
- *
75
- * const props = resolveValue(container, {a: tokenA, b: tokenB});
76
- * console.log(props); // {a: 1, b: 2}
77
- * ```
78
- */
79
- export declare function resolveValue<Tokens extends Token<unknown> | {
80
- [key: string]: Token<unknown>;
81
- }, Values extends Tokens extends Token<infer V> ? V : Tokens extends TokenProps<infer Props> ? Props : never>(container: Container, token: Tokens): Values;
82
- /**
83
- * Returns an array of resolved values or objects with resolved values.
84
- *
85
- * If an item of the array is an object which has tokens as its properties,
86
- * then returns an object containing resolved values as properties.
87
-
88
- * If a token is not found, then `ResolverError` is thrown.
89
- *
90
- * @example
91
- * ```ts
92
- * const items1 = resolveValues(container, tokenA);
93
- * console.log(items1); // [1]
94
- *
95
- * const items2 = resolveValues(container, tokenA, {a: tokenA, b: tokenB});
96
- * console.log(items2); // [1, {a: 1, b: 2}]
97
- * ```
98
- */
99
- export declare function resolveValues<Tokens extends (Token<unknown> | {
100
- [key: string]: Token<unknown>;
101
- })[], Values extends {
102
- [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps<infer Props> ? Props : never;
103
- }>(container: Container, ...tokens: Tokens): Values;
104
- /**
105
- * Decorates a factory by passing resolved values as factory arguments.
106
- *
107
- * If an argument is an object which has tokens as its properties,
108
- * then returns an object containing resolved values as properties.
109
- *
110
- * @param factory - A factory.
111
- * @param tokens - Tokens which correspond to factory arguments.
112
- *
113
- * @return Decorated factory which takes a dependency container as a single argument.
114
- */
115
- export declare function injectable<Tokens extends (Token<unknown> | {
116
- [key: string]: Token<unknown>;
117
- })[], Values extends {
118
- [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps<infer Props> ? Props : never;
119
- }, Result>(this: unknown, factory: (...params: Values) => Result, ...tokens: Tokens): (container: Container) => Result;
120
- /**
121
- * Decorates a class by passing resolved values as arguments to its constructor.
122
- *
123
- * If an argument is an object which has tokens as its properties,
124
- * then returns an object containing resolved values as properties.
125
- *
126
- * @param constructor - Constructor of a class
127
- * @param tokens - Tokens which correspond to constructor arguments
128
- *
129
- * @return A factory function which takes a dependency container as a single argument
130
- * and returns a new created class.
131
- */
132
- export declare function injectableClass<Tokens extends (Token<unknown> | {
133
- [key: string]: Token<unknown>;
134
- })[], Values extends {
135
- [K in keyof Tokens]: Tokens[K] extends Token<infer V> ? V : Tokens[K] extends TokenProps<infer Props> ? Props : never;
136
- }, Result>(this: unknown, constructor: new (...params: Values) => Result, ...tokens: Tokens): (container: Container) => Result;
137
- export {};