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.
- package/README.md +135 -32
- package/dist/index.cjs +518 -0
- package/dist/index.cjs.map +1 -0
- package/dist/{umd/index.d.ts → index.d.cts} +195 -197
- package/dist/{browser/index.d.ts → index.d.ts} +195 -197
- package/dist/index.js +501 -0
- package/dist/index.js.map +1 -0
- package/dist/index.umd.js +524 -0
- package/dist/index.umd.js.map +1 -0
- package/package.json +22 -19
- package/src/container.test.ts +34 -33
- package/src/container.ts +12 -6
- package/src/index.ts +26 -23
- package/src/modules.test.ts +172 -37
- package/src/modules.ts +22 -5
- package/src/tokens.test.ts +9 -8
- package/src/tokens.ts +2 -2
- package/src/utils.test.ts +18 -17
- package/src/utils.ts +21 -21
- package/dist/browser/index.js +0 -2
- package/dist/browser/index.js.map +0 -1
- package/dist/cjs/container.d.ts +0 -88
- package/dist/cjs/container.js +0 -216
- package/dist/cjs/container.js.map +0 -1
- package/dist/cjs/index.d.ts +0 -7
- package/dist/cjs/index.js +0 -24
- package/dist/cjs/index.js.map +0 -1
- package/dist/cjs/modules.d.ts +0 -121
- package/dist/cjs/modules.js +0 -143
- package/dist/cjs/modules.js.map +0 -1
- package/dist/cjs/tokens.d.ts +0 -56
- package/dist/cjs/tokens.js +0 -20
- package/dist/cjs/tokens.js.map +0 -1
- package/dist/cjs/utils.d.ts +0 -137
- package/dist/cjs/utils.js +0 -156
- package/dist/cjs/utils.js.map +0 -1
- package/dist/esm/container.d.ts +0 -88
- package/dist/esm/container.js +0 -211
- package/dist/esm/container.js.map +0 -1
- package/dist/esm/index.d.ts +0 -7
- package/dist/esm/index.js +0 -5
- package/dist/esm/index.js.map +0 -1
- package/dist/esm/modules.d.ts +0 -121
- package/dist/esm/modules.js +0 -136
- package/dist/esm/modules.js.map +0 -1
- package/dist/esm/tokens.d.ts +0 -56
- package/dist/esm/tokens.js +0 -15
- package/dist/esm/tokens.js.map +0 -1
- package/dist/esm/utils.d.ts +0 -137
- package/dist/esm/utils.js +0 -145
- package/dist/esm/utils.js.map +0 -1
- package/dist/umd/index.js +0 -2
- 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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"}
|
package/dist/cjs/index.d.ts
DELETED
|
@@ -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
|
package/dist/cjs/index.js.map
DELETED
|
@@ -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"}
|
package/dist/cjs/modules.d.ts
DELETED
|
@@ -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 {};
|
package/dist/cjs/modules.js
DELETED
|
@@ -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
|
package/dist/cjs/modules.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/modules.ts"],"names":[],"mappings":"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"}
|
package/dist/cjs/tokens.d.ts
DELETED
|
@@ -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>;
|
package/dist/cjs/tokens.js
DELETED
|
@@ -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
|
package/dist/cjs/tokens.js.map
DELETED
|
@@ -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"}
|
package/dist/cjs/utils.d.ts
DELETED
|
@@ -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 {};
|