ditox 3.2.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 +49 -27
  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} +189 -196
  5. package/dist/{browser/index.d.ts → index.d.ts} +189 -196
  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 +2 -2
  13. package/src/index.ts +22 -24
  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 -93
  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 -93
  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,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 {};
package/dist/cjs/utils.js DELETED
@@ -1,156 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.injectableClass = exports.injectable = exports.resolveValues = exports.resolveValue = exports.tryResolveValues = exports.tryResolveValue = exports.bindMultiValue = exports.isToken = void 0;
4
- /**
5
- * Checks if a value is the token
6
- */
7
- function isToken(value) {
8
- return (value !== undefined &&
9
- value !== null &&
10
- typeof value === 'object' &&
11
- 'symbol' in value &&
12
- typeof value.symbol === 'symbol');
13
- }
14
- exports.isToken = isToken;
15
- /**
16
- * Rebinds the array by the token with added new value.
17
- * @param container - Dependency container.
18
- * @param token - Token for an array of values.
19
- * @param value - New value which is added to the end of the array.
20
- */
21
- function bindMultiValue(container, token, value) {
22
- var _a;
23
- const prevValues = (_a = container.get(token)) !== null && _a !== void 0 ? _a : [];
24
- const nextValues = [...prevValues, value];
25
- container.bindValue(token, nextValues);
26
- }
27
- exports.bindMultiValue = bindMultiValue;
28
- /**
29
- * Tries to resolve a value by the provided token.
30
- *
31
- * If an argument is an object which has tokens as its properties,
32
- * then returns an object containing resolved values as properties.
33
-
34
- * If a token is not found, then `undefined` value is used.
35
- *
36
- * @example
37
- * ```ts
38
- * const value = tryResolveValue(container, tokenA);
39
- * console.log(value); // 1
40
- *
41
- * const props = tryResolveValue(container, {a: tokenA, b: tokenB});
42
- * console.log(props); // {a: 1, b: 2}
43
- * ```
44
- */
45
- function tryResolveValue(container, token) {
46
- if (isToken(token)) {
47
- return container.get(token);
48
- }
49
- const obj = {};
50
- Object.keys(token).forEach((key) => (obj[key] = container.get(token[key])));
51
- return obj;
52
- }
53
- exports.tryResolveValue = tryResolveValue;
54
- /**
55
- * Returns an array of resolved values or objects with resolved values.
56
- *
57
- * If an item of the array is an object which has tokens as its properties,
58
- * then returns an object containing resolved values as properties.
59
-
60
- * If a token is not found, then `undefined` value is used.
61
- *
62
- * @example
63
- * ```ts
64
- * const items1 = tryResolveValues(container, tokenA);
65
- * console.log(items1); // [1]
66
- *
67
- * const items2 = tryResolveValues(container, tokenA, {a: tokenA, b: tokenB});
68
- * console.log(items2); // [1, {a: 1, b: 2}]
69
- * ```
70
- */
71
- function tryResolveValues(container, ...tokens) {
72
- return tokens.map((item) => tryResolveValue(container, item));
73
- }
74
- exports.tryResolveValues = tryResolveValues;
75
- /**
76
- * Resolves a value by the provided token.
77
- *
78
- * If an argument is an object which has tokens as its properties,
79
- * then returns an object containing resolved values as properties.
80
-
81
- * If a value is not found by the token, then `ResolverError` is thrown.
82
- *
83
- * @example
84
- * ```ts
85
- * const value = resolveValue(container, tokenA);
86
- * console.log(value); // 1
87
- *
88
- * const props = resolveValue(container, {a: tokenA, b: tokenB});
89
- * console.log(props); // {a: 1, b: 2}
90
- * ```
91
- */
92
- function resolveValue(container, token) {
93
- if (isToken(token)) {
94
- return container.resolve(token);
95
- }
96
- const obj = {};
97
- Object.keys(token).forEach((key) => (obj[key] = container.resolve(token[key])));
98
- return obj;
99
- }
100
- exports.resolveValue = resolveValue;
101
- /**
102
- * Returns an array of resolved values or objects with resolved values.
103
- *
104
- * If an item of the array is an object which has tokens as its properties,
105
- * then returns an object containing resolved values as properties.
106
-
107
- * If a token is not found, then `ResolverError` is thrown.
108
- *
109
- * @example
110
- * ```ts
111
- * const items1 = resolveValues(container, tokenA);
112
- * console.log(items1); // [1]
113
- *
114
- * const items2 = resolveValues(container, tokenA, {a: tokenA, b: tokenB});
115
- * console.log(items2); // [1, {a: 1, b: 2}]
116
- * ```
117
- */
118
- function resolveValues(container, ...tokens) {
119
- return tokens.map((item) => resolveValue(container, item));
120
- }
121
- exports.resolveValues = resolveValues;
122
- /**
123
- * Decorates a factory by passing resolved values as factory arguments.
124
- *
125
- * If an argument is an object which has tokens as its properties,
126
- * then returns an object containing resolved values as properties.
127
- *
128
- * @param factory - A factory.
129
- * @param tokens - Tokens which correspond to factory arguments.
130
- *
131
- * @return Decorated factory which takes a dependency container as a single argument.
132
- */
133
- function injectable(factory, ...tokens) {
134
- return (container) => {
135
- const values = resolveValues(container, ...tokens);
136
- return factory.apply(this, values);
137
- };
138
- }
139
- exports.injectable = injectable;
140
- /**
141
- * Decorates a class by passing resolved values as arguments to its constructor.
142
- *
143
- * If an argument is an object which has tokens as its properties,
144
- * then returns an object containing resolved values as properties.
145
- *
146
- * @param constructor - Constructor of a class
147
- * @param tokens - Tokens which correspond to constructor arguments
148
- *
149
- * @return A factory function which takes a dependency container as a single argument
150
- * and returns a new created class.
151
- */
152
- function injectableClass(constructor, ...tokens) {
153
- return injectable((...values) => new constructor(...values), ...tokens);
154
- }
155
- exports.injectableClass = injectableClass;
156
- //# sourceMappingURL=utils.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"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"}
@@ -1,93 +0,0 @@
1
- import { Token } from './tokens';
2
- /**
3
- * ResolverError is thrown by the resolver when a token is not found in a container.
4
- */
5
- export declare class ResolverError extends Error {
6
- constructor(message: string);
7
- }
8
- /**
9
- * @see https://github.com/mnasyrov/ditox#factory-lifetimes
10
- */
11
- export type FactoryScope = 'scoped' | 'singleton' | 'transient';
12
- /**
13
- * Options for factory binding.
14
- *
15
- * `scope` types:
16
- * - `singleton` - **This is the default**. The value is created and cached by the most distant parent container which owns the factory function.
17
- * - `scoped` - The value is created and cached by the nearest container which owns the factory function.
18
- * - `transient` - The value is created every time it is resolved.
19
- *
20
- * `scoped` and `singleton` scopes can have `onRemoved` callback. It is called when a token is removed from the container.
21
- */
22
- export type FactoryOptions<T> = {
23
- scope?: 'scoped' | 'singleton';
24
- onRemoved?: (value: T) => void;
25
- } | {
26
- scope: 'transient';
27
- };
28
- /**
29
- * Dependency container.
30
- */
31
- export type Container = {
32
- /**
33
- * Binds a value for the token
34
- */
35
- bindValue<T>(token: Token<T>, value: T): void;
36
- /**
37
- * Binds a factory for the token.
38
- */
39
- bindFactory<T>(token: Token<T>, factory: (container: Container) => T, options?: FactoryOptions<T>): void;
40
- /**
41
- * Checks if the token is registered in the container hierarchy.
42
- */
43
- hasToken(token: Token<unknown>): boolean;
44
- /**
45
- * Returns a resolved value by the token, or returns `undefined` in case the token is not found.
46
- */
47
- get<T>(token: Token<T>): T | undefined;
48
- /**
49
- * Returns a resolved value by the token or throws `ResolverError` in case the token is not found.
50
- */
51
- resolve<T>(token: Token<T>): T;
52
- /**
53
- * Removes a binding for the token.
54
- */
55
- remove<T>(token: Token<T>): void;
56
- /**
57
- * Removes all bindings in the container.
58
- */
59
- removeAll(): void;
60
- };
61
- /**
62
- * A subset of Container interface that provides read-only access to dependency resolution.
63
- * This type is used for parent containers to allow token resolution without exposing mutation methods.
64
- */
65
- export type ContainerResolver = Pick<Container, 'hasToken' | 'get' | 'resolve'>;
66
- /** @internal */
67
- export declare const CONTAINER: Token<Container>;
68
- /** @internal */
69
- export declare const PARENT_CONTAINERS: Token<ReadonlyArray<Container>>;
70
- /** @internal */
71
- export declare const RESOLVER: Token<Resolver>;
72
- /** @internal */
73
- declare const NOT_FOUND: unique symbol;
74
- /** @internal */
75
- type FactoryContext<T> = {
76
- factory: (container: Container) => T;
77
- options?: FactoryOptions<T>;
78
- };
79
- /** @internal */
80
- export type FactoriesMap = Map<symbol, FactoryContext<any>>;
81
- /** @internal */
82
- export declare const FACTORIES_MAP: Token<FactoriesMap>;
83
- /** @internal */
84
- type Resolver = <T>(token: Token<T>, origin: Container) => T | typeof NOT_FOUND;
85
- /**
86
- * Creates a new dependency container.
87
- *
88
- * 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.
89
- *
90
- * @param parentArg - Optional parent container or an array of containers.
91
- */
92
- export declare function createContainer(parentArg?: ContainerResolver | ReadonlyArray<ContainerResolver>): Container;
93
- export {};
@@ -1,211 +0,0 @@
1
- import { token } from './tokens';
2
- /**
3
- * ResolverError is thrown by the resolver when a token is not found in a container.
4
- */
5
- export class ResolverError extends Error {
6
- constructor(message) {
7
- super(message);
8
- Object.setPrototypeOf(this, new.target.prototype);
9
- this.name = 'ResolverError';
10
- }
11
- }
12
- /** @internal */
13
- export const CONTAINER = token('ditox.Container');
14
- /** @internal */
15
- export const PARENT_CONTAINERS = token('ditox.ParentContainer');
16
- /** @internal */
17
- export const RESOLVER = token('ditox.Resolver');
18
- /** @internal */
19
- const NOT_FOUND = Symbol();
20
- /** @internal */
21
- const DEFAULT_SCOPE = 'singleton';
22
- /** @internal */
23
- export const FACTORIES_MAP = token('ditox.FactoriesMap');
24
- /** @internal */
25
- function getScope(options) {
26
- var _a;
27
- return (_a = options === null || options === void 0 ? void 0 : options.scope) !== null && _a !== void 0 ? _a : DEFAULT_SCOPE;
28
- }
29
- /** @internal */
30
- function getOnRemoved(options) {
31
- return options.scope === undefined ||
32
- options.scope === 'scoped' ||
33
- options.scope === 'singleton'
34
- ? options.onRemoved
35
- : undefined;
36
- }
37
- /** @internal */
38
- function isInternalToken(token) {
39
- return (token.symbol === CONTAINER.symbol ||
40
- token.symbol === PARENT_CONTAINERS.symbol ||
41
- token.symbol === RESOLVER.symbol);
42
- }
43
- /**
44
- * Creates a new dependency container.
45
- *
46
- * 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.
47
- *
48
- * @param parentArg - Optional parent container or an array of containers.
49
- */
50
- export function createContainer(parentArg) {
51
- const parents = parentArg
52
- ? Array.isArray(parentArg)
53
- ? [...parentArg]
54
- : [parentArg]
55
- : undefined;
56
- const values = new Map();
57
- const factories = new Map();
58
- const container = {
59
- bindValue(token, value) {
60
- if (isInternalToken(token)) {
61
- return;
62
- }
63
- values.set(token.symbol, value);
64
- },
65
- bindFactory(token, factory, options) {
66
- if (isInternalToken(token)) {
67
- return;
68
- }
69
- factories.set(token.symbol, { factory, options });
70
- },
71
- remove(token) {
72
- var _a;
73
- if (isInternalToken(token)) {
74
- return;
75
- }
76
- const options = (_a = factories.get(token.symbol)) === null || _a === void 0 ? void 0 : _a.options;
77
- if (options) {
78
- executeOnRemoved(token.symbol, options);
79
- }
80
- values.delete(token.symbol);
81
- factories.delete(token.symbol);
82
- },
83
- removeAll() {
84
- factories.forEach((context, tokenSymbol) => {
85
- if (context.options) {
86
- executeOnRemoved(tokenSymbol, context.options);
87
- }
88
- });
89
- values.clear();
90
- factories.clear();
91
- bindInternalTokens();
92
- },
93
- hasToken(token) {
94
- return (values.has(token.symbol) ||
95
- factories.has(token.symbol) ||
96
- parentContainersHaveToken(parents, token));
97
- },
98
- get(token) {
99
- const value = resolver(token, container);
100
- if (value !== NOT_FOUND) {
101
- return value;
102
- }
103
- if (token.isOptional) {
104
- return token.optionalValue;
105
- }
106
- return undefined;
107
- },
108
- resolve(token) {
109
- var _a;
110
- const value = resolver(token, container);
111
- if (value !== NOT_FOUND) {
112
- return value;
113
- }
114
- if (token.isOptional) {
115
- return token.optionalValue;
116
- }
117
- throw new ResolverError(`Token "${(_a = token.symbol.description) !== null && _a !== void 0 ? _a : ''}" is not provided`);
118
- },
119
- };
120
- function resolver(token, origin) {
121
- const value = values.get(token.symbol);
122
- const hasValue = value !== undefined || values.has(token.symbol);
123
- if (hasValue && origin === container) {
124
- return value;
125
- }
126
- const factoryContext = factories.get(token.symbol);
127
- if (factoryContext) {
128
- const scope = getScope(factoryContext.options);
129
- switch (scope) {
130
- case 'singleton': {
131
- if (hasValue) {
132
- return value;
133
- }
134
- else if (parentContainersHaveToken(parents, token)) {
135
- break;
136
- }
137
- else {
138
- // Cache the value in the same container where the factory is registered.
139
- const value = factoryContext.factory(container);
140
- container.bindValue(token, value);
141
- return value;
142
- }
143
- }
144
- case 'scoped': {
145
- if (hasValue) {
146
- return value;
147
- }
148
- else {
149
- // Create a value within the factory's container and cache it.
150
- const value = factoryContext.factory(container);
151
- container.bindValue(token, value);
152
- return value;
153
- }
154
- }
155
- case 'transient': {
156
- // Create a value within the origin container and don't cache it.
157
- return factoryContext.factory(origin);
158
- }
159
- }
160
- }
161
- if (hasValue) {
162
- return value;
163
- }
164
- if (parents) {
165
- return parentContainersResolveToken(parents, token, origin);
166
- }
167
- return NOT_FOUND;
168
- }
169
- function executeOnRemoved(tokenSymbol, options) {
170
- const onRemoved = getOnRemoved(options);
171
- if (onRemoved) {
172
- const value = values.get(tokenSymbol);
173
- if (value !== undefined || values.has(tokenSymbol)) {
174
- onRemoved(value);
175
- }
176
- }
177
- }
178
- function bindInternalTokens() {
179
- values.set(CONTAINER.symbol, container);
180
- values.set(RESOLVER.symbol, resolver);
181
- values.set(FACTORIES_MAP.symbol, factories);
182
- if (parents) {
183
- values.set(PARENT_CONTAINERS.symbol, parents);
184
- }
185
- }
186
- bindInternalTokens();
187
- return container;
188
- }
189
- function parentContainersHaveToken(parents, token) {
190
- if (!parents)
191
- return false;
192
- for (let i = 0; i < parents.length; i++) {
193
- if (parents[i].hasToken(token)) {
194
- return true;
195
- }
196
- }
197
- return false;
198
- }
199
- function parentContainersResolveToken(parents, token, origin) {
200
- for (const parentContainer of parents) {
201
- const parentResolver = parentContainer.get(RESOLVER);
202
- if (parentResolver) {
203
- const resolved = parentResolver(token, origin);
204
- if (resolved !== NOT_FOUND) {
205
- return resolved;
206
- }
207
- }
208
- }
209
- return NOT_FOUND;
210
- }
211
- //# sourceMappingURL=container.js.map
@@ -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, ContainerResolver, } 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/esm/index.js DELETED
@@ -1,5 +0,0 @@
1
- export { token, optional } from './tokens';
2
- export { ResolverError, createContainer } from './container';
3
- export { isToken, bindMultiValue, tryResolveValue, tryResolveValues, resolveValue, resolveValues, injectable, injectableClass, } from './utils';
4
- export { bindModule, bindModules, declareModule, declareModuleBindings, } from './modules';
5
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAC,aAAa,EAAE,eAAe,EAAC,MAAM,aAAa,CAAC;AAQ3D,OAAO,EACL,OAAO,EACP,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,qBAAqB,GACtB,MAAM,WAAW,CAAC"}