@venizia/ignis-inversion 0.2.0-9 → 0.2.1-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/LICENSE.md +0 -1
- package/README.md +83 -117
- package/dist/cjs/common/utilities.d.ts +31 -3
- package/dist/cjs/common/utilities.d.ts.map +1 -1
- package/dist/cjs/common/utilities.js +61 -5
- package/dist/cjs/common/utilities.js.map +1 -1
- package/dist/cjs/modules/binding/binding.d.ts +3 -0
- package/dist/cjs/modules/binding/binding.d.ts.map +1 -1
- package/dist/cjs/modules/binding/binding.js +8 -6
- package/dist/cjs/modules/binding/binding.js.map +1 -1
- package/dist/cjs/modules/binding/common/constants.d.ts.map +1 -1
- package/dist/cjs/modules/binding/common/constants.js +2 -6
- package/dist/cjs/modules/binding/common/constants.js.map +1 -1
- package/dist/cjs/modules/container/base.d.ts +25 -0
- package/dist/cjs/modules/container/base.d.ts.map +1 -1
- package/dist/cjs/modules/container/base.js +84 -26
- package/dist/cjs/modules/container/base.js.map +1 -1
- package/dist/cjs/modules/container/container.d.ts +9 -2
- package/dist/cjs/modules/container/container.d.ts.map +1 -1
- package/dist/cjs/modules/container/container.js +21 -11
- package/dist/cjs/modules/container/container.js.map +1 -1
- package/dist/cjs/modules/error/app-error.js +2 -5
- package/dist/cjs/modules/error/app-error.js.map +1 -1
- package/dist/cjs/modules/registry/registry.d.ts.map +1 -1
- package/dist/cjs/modules/registry/registry.js +7 -3
- package/dist/cjs/modules/registry/registry.js.map +1 -1
- package/dist/esm/common/index.d.ts +4 -4
- package/dist/esm/common/index.js +4 -4
- package/dist/esm/common/utilities.d.ts +32 -4
- package/dist/esm/common/utilities.d.ts.map +1 -1
- package/dist/esm/common/utilities.js +58 -4
- package/dist/esm/common/utilities.js.map +1 -1
- package/dist/esm/index.d.ts +2 -2
- package/dist/esm/index.js +4 -4
- package/dist/esm/modules/binding/binding.d.ts +8 -5
- package/dist/esm/modules/binding/binding.d.ts.map +1 -1
- package/dist/esm/modules/binding/binding.js +12 -10
- package/dist/esm/modules/binding/binding.js.map +1 -1
- package/dist/esm/modules/binding/common/constants.d.ts +1 -1
- package/dist/esm/modules/binding/common/constants.d.ts.map +1 -1
- package/dist/esm/modules/binding/common/constants.js +3 -4
- package/dist/esm/modules/binding/common/constants.js.map +1 -1
- package/dist/esm/modules/binding/common/index.d.ts +2 -2
- package/dist/esm/modules/binding/common/index.js +2 -2
- package/dist/esm/modules/binding/common/types.d.ts +3 -3
- package/dist/esm/modules/binding/index.d.ts +2 -2
- package/dist/esm/modules/binding/index.js +2 -2
- package/dist/esm/modules/container/abstract.d.ts +5 -5
- package/dist/esm/modules/container/abstract.js +1 -1
- package/dist/esm/modules/container/base.d.ts +29 -4
- package/dist/esm/modules/container/base.d.ts.map +1 -1
- package/dist/esm/modules/container/base.js +89 -31
- package/dist/esm/modules/container/base.js.map +1 -1
- package/dist/esm/modules/container/common/index.d.ts +1 -1
- package/dist/esm/modules/container/common/index.js +1 -1
- package/dist/esm/modules/container/common/types.d.ts +3 -3
- package/dist/esm/modules/container/container.d.ts +11 -4
- package/dist/esm/modules/container/container.d.ts.map +1 -1
- package/dist/esm/modules/container/container.js +24 -14
- package/dist/esm/modules/container/container.js.map +1 -1
- package/dist/esm/modules/container/index.d.ts +4 -4
- package/dist/esm/modules/container/index.js +4 -4
- package/dist/esm/modules/error/app-error.d.ts +1 -1
- package/dist/esm/modules/error/app-error.js +3 -3
- package/dist/esm/modules/error/app-error.js.map +1 -1
- package/dist/esm/modules/error/common/index.d.ts +1 -1
- package/dist/esm/modules/error/common/index.js +1 -1
- package/dist/esm/modules/error/common/types.d.ts +1 -1
- package/dist/esm/modules/error/definition.d.ts +1 -1
- package/dist/esm/modules/error/index.d.ts +4 -4
- package/dist/esm/modules/error/index.js +4 -4
- package/dist/esm/modules/error/message-code.d.ts +2 -2
- package/dist/esm/modules/index.d.ts +5 -5
- package/dist/esm/modules/index.js +5 -5
- package/dist/esm/modules/metadata/common/index.d.ts +1 -1
- package/dist/esm/modules/metadata/common/index.js +1 -1
- package/dist/esm/modules/metadata/index.d.ts +2 -2
- package/dist/esm/modules/metadata/index.js +2 -2
- package/dist/esm/modules/metadata/injectors.d.ts +2 -2
- package/dist/esm/modules/metadata/injectors.js +2 -2
- package/dist/esm/modules/registry/common/index.d.ts +1 -1
- package/dist/esm/modules/registry/common/index.js +1 -1
- package/dist/esm/modules/registry/common/types.d.ts +1 -1
- package/dist/esm/modules/registry/index.d.ts +2 -2
- package/dist/esm/modules/registry/index.js +2 -2
- package/dist/esm/modules/registry/registry.d.ts +3 -3
- package/dist/esm/modules/registry/registry.d.ts.map +1 -1
- package/dist/esm/modules/registry/registry.js +10 -6
- package/dist/esm/modules/registry/registry.js.map +1 -1
- package/dist/esm/package.json +6 -0
- package/package.json +3 -5
package/LICENSE.md
CHANGED
|
@@ -72,7 +72,6 @@ Ignis uses the following open-source libraries. We are grateful to the authors a
|
|
|
72
72
|
|
|
73
73
|
| Library | License | Description |
|
|
74
74
|
|---------|---------|-------------|
|
|
75
|
-
| [Lodash](https://github.com/lodash/lodash) | MIT | Utility library |
|
|
76
75
|
| [reflect-metadata](https://github.com/rbuckton/reflect-metadata) | Apache-2.0 | Metadata reflection API |
|
|
77
76
|
|
|
78
77
|
### Documentation Dependencies
|
package/README.md
CHANGED
|
@@ -1,47 +1,23 @@
|
|
|
1
|
-
|
|
1
|
+
# @venizia/ignis-inversion
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
**A small IoC container that works anywhere.**
|
|
8
|
-
|
|
9
|
-
[](https://ignis.venizia.ai/references/base/dependency-injection)
|
|
10
|
-
[](https://www.npmjs.com/package/@venizia/ignis-inversion)
|
|
11
|
-
[](https://opensource.org/licenses/MIT)
|
|
12
|
-
[](https://www.typescriptlang.org/)
|
|
13
|
-
|
|
14
|
-
[Documentation](https://ignis.venizia.ai/references/base/dependency-injection) •
|
|
15
|
-
[Core API](https://ignis.venizia.ai/references/) •
|
|
16
|
-
[Changelog](https://ignis.venizia.ai/changelogs/)
|
|
17
|
-
|
|
18
|
-
</div>
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
The dependency injection container behind [IGNIS](https://ignis.venizia.ai) - decorator-driven
|
|
23
|
-
constructor and property injection, a fluent binding API, singleton/transient scopes, and tag-based
|
|
24
|
-
discovery, in roughly 350 lines.
|
|
25
|
-
|
|
26
|
-
It has no framework dependency. Reach for it when you want LoopBack 4-style DI without adopting a
|
|
27
|
-
framework, and it is small enough to ship into a browser bundle. IGNIS itself uses nothing more than
|
|
28
|
-
what is documented here.
|
|
3
|
+
The dependency injection container under IGNIS, and the error type every IGNIS package throws. It
|
|
4
|
+
depends on no other IGNIS package, so you can install it alone to get LoopBack 4-style bindings
|
|
5
|
+
without the framework.
|
|
29
6
|
|
|
30
7
|
## Install
|
|
31
8
|
|
|
32
9
|
```bash
|
|
33
|
-
bun add @venizia/ignis-inversion
|
|
10
|
+
bun add @venizia/ignis-inversion
|
|
34
11
|
```
|
|
35
12
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
> declared **inline**. Bun does not resolve them through `extends`, and `@inject` is silently
|
|
39
|
-
> dropped without them.
|
|
13
|
+
`reflect-metadata` comes as a dependency, and the package entry imports it. Your `tsconfig.json`
|
|
14
|
+
must declare `experimentalDecorators: true` itself (see [Decorators](#decorators)).
|
|
40
15
|
|
|
41
|
-
##
|
|
16
|
+
## Use it
|
|
17
|
+
|
|
18
|
+
Bind values and classes under string keys, then ask the container for a key.
|
|
42
19
|
|
|
43
20
|
```typescript
|
|
44
|
-
import 'reflect-metadata';
|
|
45
21
|
import { BindingScopes, Container, inject } from '@venizia/ignis-inversion';
|
|
46
22
|
|
|
47
23
|
class GreetingService {
|
|
@@ -55,7 +31,7 @@ class GreetingService {
|
|
|
55
31
|
}
|
|
56
32
|
}
|
|
57
33
|
|
|
58
|
-
const container = new Container(
|
|
34
|
+
const container = new Container();
|
|
59
35
|
|
|
60
36
|
container.bind({ key: 'config.prefix' }).toValue('Hello');
|
|
61
37
|
container
|
|
@@ -66,119 +42,109 @@ container
|
|
|
66
42
|
const service = container.get<GreetingService>({ key: 'services.GreetingService' });
|
|
67
43
|
console.log(service.greet('IGNIS')); // Hello IGNIS (en)
|
|
68
44
|
|
|
69
|
-
//
|
|
70
|
-
container.findByTag({ tag: 'services' }); // [
|
|
45
|
+
// The first segment of a dotted key becomes a tag.
|
|
46
|
+
container.findByTag({ tag: 'services' }); // [the 'services.GreetingService' binding]
|
|
71
47
|
```
|
|
72
48
|
|
|
73
|
-
|
|
49
|
+
Notice that `config.locale` is never bound. `isOptional: true` makes it resolve to `undefined`
|
|
50
|
+
instead of throwing.
|
|
74
51
|
|
|
75
|
-
|
|
52
|
+
## API
|
|
76
53
|
|
|
77
|
-
|
|
54
|
+
Every method takes an options object: `container.get({ key })`, never `container.get(key)`.
|
|
78
55
|
|
|
79
|
-
|
|
|
56
|
+
| Container member | What it does |
|
|
80
57
|
| :--- | :--- |
|
|
81
|
-
| `new Container({ scope })` | The default container. `AbstractContainer` (contract) and `BaseContainer` (storage) are exported for custom implementations |
|
|
82
58
|
| `bind<T>({ key })` | Creates and registers a `Binding`, returned for chaining |
|
|
83
|
-
| `get<T>({ key, isOptional })` | Resolves a
|
|
84
|
-
| `gets
|
|
85
|
-
| `getBinding
|
|
86
|
-
| `
|
|
87
|
-
| `
|
|
88
|
-
| `
|
|
89
|
-
| `
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
### Binding
|
|
93
|
-
|
|
94
|
-
| Member | What it does |
|
|
59
|
+
| `get<T>({ key, isOptional })` | Resolves a key. Throws when the key is unbound, unless `isOptional` is `true`. `key` may also be `{ namespace, key }` |
|
|
60
|
+
| `gets({ bindings })` | Resolves several keys; every entry is optional |
|
|
61
|
+
| `getBinding({ key })`, `isBound({ key })`, `unbind({ key })`, `set({ binding })` | Read, test, remove, or register a `Binding` |
|
|
62
|
+
| `instantiate(cls)` / `resolve(cls)` | Builds a class from its `@inject` metadata without binding it |
|
|
63
|
+
| `findByTag({ tag, exclude })` | Every binding with a tag; `exclude` takes an array or a `Set` of keys |
|
|
64
|
+
| `clear()` / `reset()` | Drops cached singletons / drops every binding |
|
|
65
|
+
| `startResolutionCounting()`, `getResolutionCounts()`, `stopResolutionCounting()` | Counts how often each key is resolved, off by default |
|
|
66
|
+
|
|
67
|
+
| Binding member | What it does |
|
|
95
68
|
| :--- | :--- |
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
99
|
-
|
|
|
100
|
-
|
|
|
101
|
-
|
|
|
102
|
-
| `.clearCache()` | Discards a cached singleton instance |
|
|
69
|
+
| `toValue(value)` | Returns the value as-is |
|
|
70
|
+
| `toClass(Class)` | Instantiates the class through the container |
|
|
71
|
+
| `toProvider(factory)` | Calls `(container) => T`, or instantiates a class with a `value(container)` method |
|
|
72
|
+
| `setScope(scope)` | `BindingScopes.TRANSIENT` (default) or `BindingScopes.SINGLETON` |
|
|
73
|
+
| `setTags(...tags)`, `hasTag(tag)`, `getTags()` | Tags for `findByTag` |
|
|
74
|
+
| `clearCache()` | Discards the cached singleton |
|
|
103
75
|
|
|
104
|
-
|
|
76
|
+
`AbstractContainer` (the contract) and `BaseContainer` (the storage) are exported for custom
|
|
77
|
+
containers. `BindingKeys.build({ namespace, key })` joins a namespace and a key with a dot.
|
|
105
78
|
|
|
106
|
-
|
|
107
|
-
| :--- | :--- | :--- |
|
|
108
|
-
| `@inject({ key, isOptional? })` | Constructor parameter | Resolved by index and passed to the constructor |
|
|
109
|
-
| `@inject({ key, isOptional? })` | Property | Assigned after construction |
|
|
79
|
+
## Decorators
|
|
110
80
|
|
|
111
|
-
|
|
112
|
-
|
|
81
|
+
`@inject` marks a constructor parameter or a property. Pass a `key`, or a `target` class to
|
|
82
|
+
resolve through the key that class was registered under.
|
|
113
83
|
|
|
114
|
-
|
|
84
|
+
| Option | Type | Meaning |
|
|
85
|
+
| :--- | :--- | :--- |
|
|
86
|
+
| `key` | `string \| symbol` | The binding key to resolve |
|
|
87
|
+
| `target` | class, or a function returning one | Resolve the class's recorded key. The function form survives an import cycle |
|
|
88
|
+
| `isOptional` | `boolean` | Resolve an unbound key to `undefined` instead of throwing |
|
|
115
89
|
|
|
116
|
-
|
|
117
|
-
| :--- | :--- |
|
|
118
|
-
| `BindingKeys.build({ namespace, key })` | Joins the two with a dot. `key` is required; an empty namespace yields the bare key |
|
|
119
|
-
| Namespace auto-tagging | A dotted key tags its binding with the first segment - `services.UserService` is tagged `services` |
|
|
120
|
-
| `BindingScopes` | `SINGLETON`, `TRANSIENT` |
|
|
121
|
-
| `BindingValueTypes` | `CLASS`, `VALUE`, `PROVIDER` - the resolver kinds |
|
|
90
|
+
Constructor parameters resolve before construction. Properties are assigned after it.
|
|
122
91
|
|
|
123
|
-
|
|
92
|
+
> [!IMPORTANT]
|
|
93
|
+
> Declare `experimentalDecorators: true` in your own `tsconfig.json`, not only through `extends`.
|
|
94
|
+
> Bun can miss an inherited flag when it runs source, and then drops parameter decorators with no
|
|
95
|
+
> error. `emitDecoratorMetadata` is not needed: `@inject` records the parameter index itself.
|
|
124
96
|
|
|
125
|
-
|
|
97
|
+
Decorate every constructor parameter of a class the container builds. An undecorated parameter
|
|
98
|
+
before a decorated one is refused with `Constructor parameter N has no @inject`. An undecorated
|
|
99
|
+
trailing parameter receives `undefined`.
|
|
126
100
|
|
|
127
101
|
## Errors
|
|
128
102
|
|
|
129
|
-
|
|
130
|
-
consumer gets it for free. Never throw a raw `new Error`.
|
|
103
|
+
The package also holds the error type the whole framework throws.
|
|
131
104
|
|
|
132
105
|
```typescript
|
|
133
106
|
import { getError, isApplicationError } from '@venizia/ignis-inversion';
|
|
134
107
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
108
|
+
try {
|
|
109
|
+
throw getError({
|
|
110
|
+
message: { text: 'User not found', code: 'user.not_found', args: { id: 42 } },
|
|
111
|
+
statusCode: 404,
|
|
112
|
+
});
|
|
113
|
+
} catch (error) {
|
|
114
|
+
if (isApplicationError(error)) {
|
|
115
|
+
console.log(error.statusCode, error.normalized); // 404 { text, code, args }
|
|
116
|
+
}
|
|
117
|
+
}
|
|
139
118
|
```
|
|
140
119
|
|
|
141
|
-
`getError` returns an `ApplicationError
|
|
142
|
-
|
|
120
|
+
`getError` returns an `ApplicationError`, an `Error` subclass. It carries `statusCode` (default
|
|
121
|
+
`400`), `normalized` (`{ text, code, args }`) and an optional `extra` bag. A bare string `message`
|
|
122
|
+
becomes `text`. A missing code becomes `MessageCode.DEFAULT` (`core.system_error`). Unknown
|
|
123
|
+
top-level keys go into `extra`.
|
|
143
124
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
| `text` | The human-readable message |
|
|
147
|
-
| `code` | A dotted, lower snake_case message code. Falls back to `MessageCode.DEFAULT` (`core.system_error`) |
|
|
148
|
-
| `args` | Interpolation arguments, `{}` when there are none |
|
|
149
|
-
|
|
150
|
-
`message` also accepts a bare string, which becomes `text`. Unknown top-level keys are swept into
|
|
151
|
-
`extra`, so a throw site can attach context the framework does not model.
|
|
152
|
-
|
|
153
|
-
> [!IMPORTANT]
|
|
154
|
-
> Check errors with `isApplicationError(error)`, never `instanceof ApplicationError`. Several
|
|
155
|
-
> packages can carry their own copy of the class, so `instanceof` fails across package boundaries.
|
|
156
|
-
|
|
157
|
-
Also exported: `ApplicationError`, `MessageCode`, `ErrorScopes`, and the `TError*` types. Catalogued
|
|
158
|
-
errors are declared as `TErrorDefinition` objects and thrown with `getError({ error: Definition })`.
|
|
125
|
+
Test with `isApplicationError(error)`, not `instanceof ApplicationError`. A CommonJS copy and an
|
|
126
|
+
ES module copy of the package can both be loaded, and `instanceof` fails across them.
|
|
159
127
|
|
|
160
|
-
##
|
|
128
|
+
## Entry points
|
|
161
129
|
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
`super({ ... })` or onto a binding, never as a bare parameter.
|
|
130
|
+
| Entry point | What it gives | Extra peers |
|
|
131
|
+
| :--- | :--- | :--- |
|
|
132
|
+
| `@venizia/ignis-inversion` | Everything: container, bindings, `@inject`, `MetadataRegistry`, errors | none |
|
|
166
133
|
|
|
167
|
-
|
|
168
|
-
|
|
134
|
+
The package ships both CommonJS (`dist/cjs`) and ES modules (`dist/esm`). `import` resolves the ES
|
|
135
|
+
build, `require` the CommonJS one. The ES build is what a browser bundle takes.
|
|
169
136
|
|
|
170
|
-
|
|
171
|
-
that loads two copies gets two metadata stores and silently empty injection.
|
|
137
|
+
## Where it sits
|
|
172
138
|
|
|
173
|
-
|
|
174
|
-
|
|
139
|
+
Depends on nothing in IGNIS. Used by filter, helpers and kernel: dev-configs -> **inversion** ->
|
|
140
|
+
{filter, helpers} -> {boot, kernel} -> connectors -> {core-worker, core-server} -> atlas.
|
|
175
141
|
|
|
176
142
|
## Links
|
|
177
143
|
|
|
178
|
-
[
|
|
179
|
-
[Dependency injection](https://ignis.venizia.ai/references/base/dependency-injection)
|
|
180
|
-
[
|
|
181
|
-
[
|
|
182
|
-
[
|
|
144
|
+
- [Inversion (DI) guide](https://ignis.venizia.ai/extensions/helpers/inversion/)
|
|
145
|
+
- [Dependency injection reference](https://ignis.venizia.ai/references/base/dependency-injection)
|
|
146
|
+
- [Error handling](https://ignis.venizia.ai/extensions/helpers/error/)
|
|
147
|
+
- [Changelog](https://ignis.venizia.ai/changelogs/)
|
|
148
|
+
- [Source](https://github.com/VENIZIA-AI/ignis/blob/main/packages/inversion)
|
|
183
149
|
|
|
184
|
-
MIT licensed
|
|
150
|
+
MIT licensed - see [LICENSE.md](./LICENSE.md).
|
|
@@ -1,10 +1,38 @@
|
|
|
1
1
|
import type { AnyType, TClass, TInjectTarget, TValueOrAsyncResolver, TValueOrResolver } from './types';
|
|
2
|
+
/**
|
|
3
|
+
* True for a value carrying nothing: `null`/`undefined`, an empty string, array, `Map`, `Set`, or an
|
|
4
|
+
* object with no own enumerable keys. A number, boolean or function is empty too - it holds no
|
|
5
|
+
* entries.
|
|
6
|
+
*
|
|
7
|
+
* Hand-written rather than `lodash/isEmpty`, and NOT a plain `!value`: `!{}` is `false` while an
|
|
8
|
+
* empty object IS empty, so the two disagree on exactly the case a swap would silently flip.
|
|
9
|
+
*/
|
|
10
|
+
export declare const isEmpty: (opts: {
|
|
11
|
+
value: unknown;
|
|
12
|
+
}) => boolean;
|
|
13
|
+
/**
|
|
14
|
+
* A shallow copy without `keys`.
|
|
15
|
+
*
|
|
16
|
+
* Hand-written rather than `lodash/omit`: this package is bundled for browsers, where importing
|
|
17
|
+
* lodash for one function costs 24 KB. Matches lodash on the shapes we pass it - a flat key list,
|
|
18
|
+
* never a nested path.
|
|
19
|
+
*/
|
|
20
|
+
export declare const omit: <T extends object, K extends PropertyKey>(opts: {
|
|
21
|
+
source: T;
|
|
22
|
+
keys: readonly K[];
|
|
23
|
+
}) => Omit<T, Extract<K, keyof T>>;
|
|
2
24
|
/** Tells a CONSTRUCTOR from a RESOLVER via source text - `prototype !== undefined` is true of every non-arrow function. Sound only on ES2020+ output (classes emit as `class`); ES5 bundling breaks it. */
|
|
3
25
|
export declare const isClass: <T>(target: any) => target is TClass<T>;
|
|
4
26
|
/** Reads a value-or-resolver. A class constructor is returned as-is; only a plain function is called. */
|
|
5
|
-
export declare const resolveValue: <T>(
|
|
27
|
+
export declare const resolveValue: <T>(opts: {
|
|
28
|
+
value: TValueOrResolver<T>;
|
|
29
|
+
}) => T;
|
|
6
30
|
/** `resolveValue` for a resolver that may answer a promise. */
|
|
7
|
-
export declare const resolveValueAsync: <T>(
|
|
31
|
+
export declare const resolveValueAsync: <T>(opts: {
|
|
32
|
+
value: TValueOrAsyncResolver<T>;
|
|
33
|
+
}) => Promise<T>;
|
|
8
34
|
/** Reads what `@inject({ target })` named. The function form is called HERE, never at decoration: that is what lets a class reached through an import cycle be named at all. Answers `undefined` when the function hands back something that is not a class. The container resolves synchronously, so there is no async form. */
|
|
9
|
-
export declare const resolveInjectTarget: (
|
|
35
|
+
export declare const resolveInjectTarget: (opts: {
|
|
36
|
+
target: TInjectTarget;
|
|
37
|
+
}) => TClass<AnyType> | undefined;
|
|
10
38
|
//# sourceMappingURL=utilities.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,MAAM,EACN,aAAa,EAEb,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,2MAA2M;AAC3M,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,QAAQ,GAAG,KAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAM1D,CAAC;AAMF,yGAAyG;AACzG,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,
|
|
1
|
+
{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,MAAM,EACN,aAAa,EAEb,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,KAAG,OAwBlD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,WAAW,EAAE,MAAM;IAClE,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;CACpB,KAAG,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAe9B,CAAC;AAEF,2MAA2M;AAC3M,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,QAAQ,GAAG,KAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAM1D,CAAC;AAMF,yGAAyG;AACzG,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,MAAM;IAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CAAE,KAAG,CAGtE,CAAC;AAOF,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,GAAU,CAAC,EAAE,MAAM;IAC/C,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACjC,KAAG,OAAO,CAAC,CAAC,CAGZ,CAAC;AAEF,iUAAiU;AACjU,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,MAAM,EAAE,aAAa,CAAC;CACvB,KAAG,MAAM,CAAC,OAAO,CAAC,GAAG,SAGrB,CAAC"}
|
|
@@ -1,6 +1,56 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.resolveInjectTarget = exports.resolveValueAsync = exports.resolveValue = exports.isClass = void 0;
|
|
3
|
+
exports.resolveInjectTarget = exports.resolveValueAsync = exports.resolveValue = exports.isClass = exports.omit = exports.isEmpty = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* True for a value carrying nothing: `null`/`undefined`, an empty string, array, `Map`, `Set`, or an
|
|
6
|
+
* object with no own enumerable keys. A number, boolean or function is empty too - it holds no
|
|
7
|
+
* entries.
|
|
8
|
+
*
|
|
9
|
+
* Hand-written rather than `lodash/isEmpty`, and NOT a plain `!value`: `!{}` is `false` while an
|
|
10
|
+
* empty object IS empty, so the two disagree on exactly the case a swap would silently flip.
|
|
11
|
+
*/
|
|
12
|
+
const isEmpty = (opts) => {
|
|
13
|
+
const { value } = opts;
|
|
14
|
+
if (value === null || value === undefined) {
|
|
15
|
+
return true;
|
|
16
|
+
}
|
|
17
|
+
// The types that carry a MEANINGFUL length. Duck-typing on `.length` instead would call
|
|
18
|
+
// `{ length: 0 }` empty, which it is not - it has an own key.
|
|
19
|
+
if (typeof value === 'string' || Array.isArray(value) || ArrayBuffer.isView(value)) {
|
|
20
|
+
return value.length === 0;
|
|
21
|
+
}
|
|
22
|
+
if (value instanceof Map || value instanceof Set) {
|
|
23
|
+
return value.size === 0;
|
|
24
|
+
}
|
|
25
|
+
if (typeof value !== 'object') {
|
|
26
|
+
return true;
|
|
27
|
+
}
|
|
28
|
+
// Own keys only: `for...in` would walk the prototype chain and call an object with an inherited
|
|
29
|
+
// property non-empty.
|
|
30
|
+
return Object.keys(value).length === 0;
|
|
31
|
+
};
|
|
32
|
+
exports.isEmpty = isEmpty;
|
|
33
|
+
/**
|
|
34
|
+
* A shallow copy without `keys`.
|
|
35
|
+
*
|
|
36
|
+
* Hand-written rather than `lodash/omit`: this package is bundled for browsers, where importing
|
|
37
|
+
* lodash for one function costs 24 KB. Matches lodash on the shapes we pass it - a flat key list,
|
|
38
|
+
* never a nested path.
|
|
39
|
+
*/
|
|
40
|
+
const omit = (opts) => {
|
|
41
|
+
const { source, keys } = opts;
|
|
42
|
+
const dropped = new Set(keys);
|
|
43
|
+
const kept = {};
|
|
44
|
+
const entries = Object.entries(source);
|
|
45
|
+
for (const [key, value] of entries) {
|
|
46
|
+
if (dropped.has(key)) {
|
|
47
|
+
continue;
|
|
48
|
+
}
|
|
49
|
+
kept[key] = value;
|
|
50
|
+
}
|
|
51
|
+
return kept;
|
|
52
|
+
};
|
|
53
|
+
exports.omit = omit;
|
|
4
54
|
/** Tells a CONSTRUCTOR from a RESOLVER via source text - `prototype !== undefined` is true of every non-arrow function. Sound only on ES2020+ output (classes emit as `class`); ES5 bundling breaks it. */
|
|
5
55
|
const isClass = (target) => {
|
|
6
56
|
if (typeof target !== 'function' || target.prototype === undefined) {
|
|
@@ -12,15 +62,21 @@ exports.isClass = isClass;
|
|
|
12
62
|
/** A resolver is anything callable that is not a class - a class is a value here, never a factory. */
|
|
13
63
|
const isResolver = (valueOrResolver) => typeof valueOrResolver === 'function' && !(0, exports.isClass)(valueOrResolver);
|
|
14
64
|
/** Reads a value-or-resolver. A class constructor is returned as-is; only a plain function is called. */
|
|
15
|
-
const resolveValue = (
|
|
65
|
+
const resolveValue = (opts) => {
|
|
66
|
+
const { value } = opts;
|
|
67
|
+
return isResolver(value) ? value() : value;
|
|
68
|
+
};
|
|
16
69
|
exports.resolveValue = resolveValue;
|
|
17
70
|
const isAsyncResolver = (valueOrResolver) => typeof valueOrResolver === 'function' && !(0, exports.isClass)(valueOrResolver);
|
|
18
71
|
/** `resolveValue` for a resolver that may answer a promise. */
|
|
19
|
-
const resolveValueAsync = async (
|
|
72
|
+
const resolveValueAsync = async (opts) => {
|
|
73
|
+
const { value } = opts;
|
|
74
|
+
return isAsyncResolver(value) ? value() : value;
|
|
75
|
+
};
|
|
20
76
|
exports.resolveValueAsync = resolveValueAsync;
|
|
21
77
|
/** Reads what `@inject({ target })` named. The function form is called HERE, never at decoration: that is what lets a class reached through an import cycle be named at all. Answers `undefined` when the function hands back something that is not a class. The container resolves synchronously, so there is no async form. */
|
|
22
|
-
const resolveInjectTarget = (
|
|
23
|
-
const resolved = (0, exports.resolveValue)(target);
|
|
78
|
+
const resolveInjectTarget = (opts) => {
|
|
79
|
+
const resolved = (0, exports.resolveValue)({ value: opts.target });
|
|
24
80
|
return (0, exports.isClass)(resolved) ? resolved : undefined;
|
|
25
81
|
};
|
|
26
82
|
exports.resolveInjectTarget = resolveInjectTarget;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../src/common/utilities.ts"],"names":[],"mappings":";;;AAUA,2MAA2M;AACpM,MAAM,OAAO,GAAG,CAAI,MAAW,EAAuB,EAAE;IAC7D,IAAI,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AANW,QAAA,OAAO,WAMlB;AAEF,sGAAsG;AACtG,MAAM,UAAU,GAAG,CAAI,eAAoC,EAAmC,EAAE,CAC9F,OAAO,eAAe,KAAK,UAAU,IAAI,CAAC,IAAA,eAAO,EAAC,eAAe,CAAC,CAAC;AAErE,yGAAyG;AAClG,MAAM,YAAY,GAAG,CAAI,
|
|
1
|
+
{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../src/common/utilities.ts"],"names":[],"mappings":"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"}
|
|
@@ -7,6 +7,7 @@ export declare class Binding<T = any> extends BaseHelper implements IBinding<T>
|
|
|
7
7
|
key: string;
|
|
8
8
|
private bindScope;
|
|
9
9
|
private tags;
|
|
10
|
+
/** Boxed: a singleton may legitimately be `null`, `false`, `0`, `''` or `undefined`. */
|
|
10
11
|
private cached?;
|
|
11
12
|
private resolver;
|
|
12
13
|
constructor(opts: {
|
|
@@ -26,6 +27,8 @@ export declare class Binding<T = any> extends BaseHelper implements IBinding<T>
|
|
|
26
27
|
hasTag(tag: string): boolean;
|
|
27
28
|
getTags(): string[];
|
|
28
29
|
getScope(): TBindingScope;
|
|
30
|
+
/** True when `getValue` answers without building anything: a cached singleton or a plain value. Nothing it reads can form a cycle. */
|
|
31
|
+
isSettled(): boolean;
|
|
29
32
|
getValue(container?: IContainer): T;
|
|
30
33
|
clearCache(): void;
|
|
31
34
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../../../src/modules/binding/binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAiB,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAmB,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEpG,qBAAa,OAAO,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,UAAW,YAAW,QAAQ,CAAC,CAAC,CAAC;IACrE,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,MAAM,CAAC,
|
|
1
|
+
{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../../../src/modules/binding/binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAiB,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAmB,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEpG,qBAAa,OAAO,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,UAAW,YAAW,QAAQ,CAAC,CAAC,CAAC;IACrE,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,IAAI,CAAc;IAC1B,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,CAAe;IAE9B,OAAO,CAAC,QAAQ,CAG4D;gBAEhE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;WAajB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAK/B,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAKvB,UAAU,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK5C,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;KAAE,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAU/F,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKpC,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAKhC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,OAAO,IAAI,MAAM,EAAE;IAInB,QAAQ,IAAI,aAAa;IAIzB,sIAAsI;IACtI,SAAS,IAAI,OAAO;IAOpB,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,CAAC;IAuDnC,UAAU;CAGX"}
|
|
@@ -57,9 +57,14 @@ class Binding extends base_helper_1.BaseHelper {
|
|
|
57
57
|
getScope() {
|
|
58
58
|
return this.bindScope;
|
|
59
59
|
}
|
|
60
|
+
/** True when `getValue` answers without building anything: a cached singleton or a plain value. Nothing it reads can form a cycle. */
|
|
61
|
+
isSettled() {
|
|
62
|
+
return ((this.bindScope === constants_1.BindingScopes.SINGLETON && this.cached !== undefined) ||
|
|
63
|
+
this.resolver.type === constants_1.BindingValueTypes.VALUE);
|
|
64
|
+
}
|
|
60
65
|
getValue(container) {
|
|
61
|
-
if (this.bindScope === constants_1.BindingScopes.SINGLETON && this.cached
|
|
62
|
-
return this.cached;
|
|
66
|
+
if (this.bindScope === constants_1.BindingScopes.SINGLETON && this.cached) {
|
|
67
|
+
return this.cached.value;
|
|
63
68
|
}
|
|
64
69
|
let instance;
|
|
65
70
|
const { type: resolverType } = this.resolver;
|
|
@@ -99,14 +104,11 @@ class Binding extends base_helper_1.BaseHelper {
|
|
|
99
104
|
}
|
|
100
105
|
}
|
|
101
106
|
if (this.bindScope === constants_1.BindingScopes.SINGLETON) {
|
|
102
|
-
this.cached = instance;
|
|
107
|
+
this.cached = { value: instance };
|
|
103
108
|
}
|
|
104
109
|
return instance;
|
|
105
110
|
}
|
|
106
111
|
clearCache() {
|
|
107
|
-
if (!this.cached) {
|
|
108
|
-
return;
|
|
109
|
-
}
|
|
110
112
|
this.cached = undefined;
|
|
111
113
|
}
|
|
112
114
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../../src/modules/binding/binding.ts"],"names":[],"mappings":";;;AAAA,oCAAoC;AACpC,sDAAkD;AAGlD,kDAAqF;AACrF,0CAAoG;AAEpG,MAAa,OAAiB,SAAQ,wBAAU;
|
|
1
|
+
{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../../src/modules/binding/binding.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/modules/binding/common/constants.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/modules/binding/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;CACzC;AACD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;CACvC;AACD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEtE,qBAAa,WAAW;IACtB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CAgBtD"}
|
|
@@ -1,10 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
-
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
-
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
-
};
|
|
5
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
3
|
exports.BindingKeys = exports.BindingValueTypes = exports.BindingScopes = void 0;
|
|
7
|
-
const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
|
|
8
4
|
const error_1 = require("../../error");
|
|
9
5
|
class BindingScopes {
|
|
10
6
|
static { this.SINGLETON = 'singleton'; }
|
|
@@ -21,10 +17,10 @@ class BindingKeys {
|
|
|
21
17
|
static build(opts) {
|
|
22
18
|
const { namespace, key } = opts;
|
|
23
19
|
const keyParts = [];
|
|
24
|
-
if (
|
|
20
|
+
if (namespace) {
|
|
25
21
|
keyParts.push(namespace);
|
|
26
22
|
}
|
|
27
|
-
if (
|
|
23
|
+
if (!key) {
|
|
28
24
|
throw (0, error_1.getError)({
|
|
29
25
|
message: `[BindingKeys][build] Invalid key to build | key: ${key}`,
|
|
30
26
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/binding/common/constants.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/binding/common/constants.ts"],"names":[],"mappings":";;;AAAA,uCAAuC;AAGvC,MAAa,aAAa;aACR,cAAS,GAAG,WAAW,CAAC;aACxB,cAAS,GAAG,WAAW,CAAC;;AAF1C,sCAGC;AAGD,MAAa,iBAAiB;aACZ,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAChB,aAAQ,GAAG,UAAU,CAAC;;AAHxC,8CAIC;AAGD,MAAa,WAAW;IACtB,MAAM,CAAC,KAAK,CAAC,IAAwC;QACnD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAA,gBAAQ,EAAC;gBACb,OAAO,EAAE,oDAAoD,GAAG,EAAE;aACnE,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AAjBD,kCAiBC"}
|
|
@@ -10,10 +10,35 @@ export declare abstract class BaseContainer extends AbstractContainer {
|
|
|
10
10
|
protected isCountingResolutions: boolean;
|
|
11
11
|
/** Whether `startResolutionCounting` has ever run. A report read without it would name every binding, which is a wrong answer rather than an empty one. */
|
|
12
12
|
protected hasStartedResolutionCounting: boolean;
|
|
13
|
+
/** The string each BOUND symbol is stored under: `Symbol('x')` twice is two keys, and both print as "Symbol(x)". */
|
|
14
|
+
protected symbolKeys: Map<symbol, string>;
|
|
15
|
+
/** How many symbols have been bound per description, so a new one gets its suffix in one step. */
|
|
16
|
+
protected symbolDescriptionCounts: Map<string, number>;
|
|
17
|
+
/**
|
|
18
|
+
* Nesting depth of the reads in progress. Past {@link CYCLE_CHECK_DEPTH} the keys are tracked, and
|
|
19
|
+
* a key met again is a cycle: a real graph is far shallower, so the common read pays one counter.
|
|
20
|
+
* Only the synchronous part is checked - a cycle through an `await` is not seen.
|
|
21
|
+
*/
|
|
22
|
+
protected resolutionDepth: number;
|
|
23
|
+
protected resolvingKeys: Set<string>;
|
|
13
24
|
constructor(opts?: {
|
|
14
25
|
scope: string;
|
|
15
26
|
});
|
|
16
27
|
getMetadataRegistry(): import("../registry/registry").MetadataRegistry;
|
|
28
|
+
/**
|
|
29
|
+
* The string a key is stored under, or `undefined` for a symbol that was never bound - a lookup
|
|
30
|
+
* never records one, so reading with throwaway symbols leaves nothing behind.
|
|
31
|
+
*/
|
|
32
|
+
protected toKeyString(opts: {
|
|
33
|
+
key: TBindingKey | {
|
|
34
|
+
namespace: string;
|
|
35
|
+
key: string;
|
|
36
|
+
};
|
|
37
|
+
}): string | undefined;
|
|
38
|
+
/** A bound symbol's own string: its description, suffixed (`Symbol(x)#2`) when another symbol holds it. */
|
|
39
|
+
protected bindSymbolKey(opts: {
|
|
40
|
+
key: symbol;
|
|
41
|
+
}): string;
|
|
17
42
|
bind<T>(opts: {
|
|
18
43
|
key: TBindingKey;
|
|
19
44
|
}): Binding<T>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/modules/container/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/modules/container/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK/C,kKAAkK;AAClK,8BAAsB,aAAc,SAAQ,iBAAiB;IAC3D,SAAS,CAAC,QAAQ,4BAA8B;IAEhD,2EAA2E;IAC3E,SAAS,CAAC,gBAAgB,sBAA6B;IAEvD,mJAAmJ;IACnJ,SAAS,CAAC,qBAAqB,UAAS;IAExC,2JAA2J;IAC3J,SAAS,CAAC,4BAA4B,UAAS;IAE/C,oHAAoH;IACpH,SAAS,CAAC,UAAU,sBAA6B;IAEjD,kGAAkG;IAClG,SAAS,CAAC,uBAAuB,sBAA6B;IAE9D;;;;OAIG;IACH,SAAS,CAAC,eAAe,SAAK;IAC9B,SAAS,CAAC,aAAa,cAAqB;gBAEhC,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAI3B,mBAAmB;IAI5B;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE;QAC1B,GAAG,EAAE,WAAW,GAAG;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACvD,GAAG,MAAM,GAAG,SAAS;IAqBtB,2GAA2G;IAC3G,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAiB7C,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ/C,OAAO,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO;IAK5C,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE;QAC3B,GAAG,EAAE,WAAW,GAAG;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACvD,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAKhB,MAAM,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO;IAW3C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI;IAK3C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QACpB,GAAG,EAAE,WAAW,GAAG;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,UAAU,CAAC,EAAE,KAAK,CAAC;KACpB,GAAG,CAAC;IACI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QACpB,GAAG,EAAE,WAAW,GAAG;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,CAAC,GAAG,SAAS;IAqDR,IAAI,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE;QACvC,QAAQ,EAAE;aACP,CAAC,IAAI,MAAM,CAAC,GAAG;gBACd,GAAG,EAAE,WAAW,GAAG;oBAAE,SAAS,EAAE,MAAM,CAAC;oBAAC,GAAG,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACtD,UAAU,CAAC,EAAE,OAAO,CAAC;aACtB;SACF,CAAC;KACH,GAAG;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;KAAE;IAMxC,gMAAgM;IACvL,uBAAuB,IAAI,IAAI;IAMxC,yFAAyF;IAChF,sBAAsB,IAAI,IAAI;IAIvC,4IAA4I;IACnI,mBAAmB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAIlD,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAI7B,SAAS,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE;QAChC,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;KACvC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE;IAyBP,KAAK,IAAI,IAAI;IAOb,KAAK,IAAI,IAAI;CAKvB"}
|