@genesislcap/foundation-events 14.302.0 → 14.302.1-alpha-d11831b.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/dist/dts/eventEmitter/emitterFunction.d.ts.map +1 -1
- package/dist/dts/eventEmitter/eventEmitterDI.d.ts.map +1 -1
- package/dist/dts/eventEmitter/eventEmitterMixin.d.ts +256 -215
- package/dist/dts/eventEmitter/eventEmitterMixin.d.ts.map +1 -1
- package/dist/dts/tsdoc-metadata.json +1 -1
- package/dist/dts/types.d.ts.map +1 -1
- package/dist/foundation-events.api.json +945 -328
- package/dist/foundation-events.d.ts +256 -215
- package/docs/api/foundation-events.createinputemitter.md +4 -1
- package/docs/api/foundation-events.createselectemitter.md +4 -1
- package/docs/api/foundation-events.customevent.md +40 -1
- package/docs/api/foundation-events.defaulteventemitterdi.emit.md +31 -3
- package/docs/api/foundation-events.defaulteventemitterdi.md +29 -3
- package/docs/api/foundation-events.emitter.md +6 -3
- package/docs/api/foundation-events.eventemitter.md +297 -216
- package/docs/api/foundation-events.eventemitterdi.emit.md +31 -3
- package/docs/api/foundation-events.eventemitterdi.md +22 -4
- package/docs/api/foundation-events.getbaseemitargs.md +40 -1
- package/docs/api/foundation-events.isemitoptions.md +40 -1
- package/docs/api/foundation-events.md +309 -32
- package/docs/api/foundation-events.registeremitter.md +5 -1
- package/docs/api/foundation-events.typedemitter._emit.md +31 -3
- package/docs/api/foundation-events.typedemitter.md +21 -3
- package/docs/api/index.md +21 -3
- package/docs/api-report.md.api.md +466 -0
- package/package.json +11 -11
@@ -12,9 +12,37 @@ emit<K extends keyof TEventDetailMap>(...args: TEventDetailMap[K] extends void ?
|
|
12
12
|
|
13
13
|
## Parameters
|
14
14
|
|
15
|
-
|
16
|
-
|
17
|
-
|
15
|
+
<table><thead><tr><th>
|
16
|
+
|
17
|
+
Parameter
|
18
|
+
|
19
|
+
|
20
|
+
</th><th>
|
21
|
+
|
22
|
+
Type
|
23
|
+
|
24
|
+
|
25
|
+
</th><th>
|
26
|
+
|
27
|
+
Description
|
28
|
+
|
29
|
+
|
30
|
+
</th></tr></thead>
|
31
|
+
<tbody><tr><td>
|
32
|
+
|
33
|
+
args
|
34
|
+
|
35
|
+
|
36
|
+
</td><td>
|
37
|
+
|
38
|
+
TEventDetailMap\[K\] extends void ? \[origin: [EmitOrigin](./foundation-events.emitorigin.md)<!-- -->, type: K, options?: [EmitOptions](./foundation-events.emitoptions.md)<!-- -->\] : \[origin: [EmitOrigin](./foundation-events.emitorigin.md)<!-- -->, type: K, detail: TEventDetailMap\[K\], options?: [EmitOptions](./foundation-events.emitoptions.md)<!-- -->\]
|
39
|
+
|
40
|
+
|
41
|
+
</td><td>
|
42
|
+
|
43
|
+
|
44
|
+
</td></tr>
|
45
|
+
</tbody></table>
|
18
46
|
|
19
47
|
**Returns:**
|
20
48
|
|
@@ -14,7 +14,7 @@ export interface EventEmitterDI<TEventDetailMap extends EventDetailMap>
|
|
14
14
|
|
15
15
|
## Remarks
|
16
16
|
|
17
|
-
A strongly typed event emitter with events typed to [EventDetailMap](./foundation-events.eventdetailmap.md) pairings. This is closely related to the [EventEmitter](./foundation-events.eventemitter.md) mixin in terms of functionality, however its purpose is different. This allows you to create pre-configured EventEmitters that can be injected anywhere. These can emit typed events from an origin html element, without that element needing to be an actual . If you are starting out, we recommend using the [EventEmitter](./foundation-events.eventemitter.md) mixin where possible.
|
17
|
+
A strongly typed event emitter with events typed to [EventDetailMap](./foundation-events.eventdetailmap.md) pairings. This is closely related to the [EventEmitter()](./foundation-events.eventemitter.md) mixin in terms of functionality, however its purpose is different. This allows you to create pre-configured EventEmitters that can be injected anywhere. These can emit typed events from an origin html element, without that element needing to be an actual . If you are starting out, we recommend using the [EventEmitter()](./foundation-events.eventemitter.md) mixin where possible.
|
18
18
|
|
19
19
|
## Example 1
|
20
20
|
|
@@ -42,7 +42,25 @@ export class MyComponent extends FASTElement {
|
|
42
42
|
|
43
43
|
## Methods
|
44
44
|
|
45
|
-
|
46
|
-
|
47
|
-
|
45
|
+
<table><thead><tr><th>
|
46
|
+
|
47
|
+
Method
|
48
|
+
|
49
|
+
|
50
|
+
</th><th>
|
51
|
+
|
52
|
+
Description
|
53
|
+
|
54
|
+
|
55
|
+
</th></tr></thead>
|
56
|
+
<tbody><tr><td>
|
57
|
+
|
58
|
+
[emit(args)](./foundation-events.eventemitterdi.emit.md)
|
59
|
+
|
60
|
+
|
61
|
+
</td><td>
|
62
|
+
|
63
|
+
|
64
|
+
</td></tr>
|
65
|
+
</tbody></table>
|
48
66
|
|
@@ -2,7 +2,7 @@
|
|
2
2
|
|
3
3
|
[Home](./index.md) > [@genesislcap/foundation-events](./foundation-events.md) > [getBaseEmitArgs](./foundation-events.getbaseemitargs.md)
|
4
4
|
|
5
|
-
## getBaseEmitArgs
|
5
|
+
## getBaseEmitArgs() function
|
6
6
|
|
7
7
|
|
8
8
|
**Signature:**
|
@@ -10,3 +10,42 @@
|
|
10
10
|
```typescript
|
11
11
|
getBaseEmitArgs: (...args: unknown[]) => EmitArgs
|
12
12
|
```
|
13
|
+
|
14
|
+
## Parameters
|
15
|
+
|
16
|
+
<table><thead><tr><th>
|
17
|
+
|
18
|
+
Parameter
|
19
|
+
|
20
|
+
|
21
|
+
</th><th>
|
22
|
+
|
23
|
+
Type
|
24
|
+
|
25
|
+
|
26
|
+
</th><th>
|
27
|
+
|
28
|
+
Description
|
29
|
+
|
30
|
+
|
31
|
+
</th></tr></thead>
|
32
|
+
<tbody><tr><td>
|
33
|
+
|
34
|
+
args
|
35
|
+
|
36
|
+
|
37
|
+
</td><td>
|
38
|
+
|
39
|
+
unknown\[\]
|
40
|
+
|
41
|
+
|
42
|
+
</td><td>
|
43
|
+
|
44
|
+
|
45
|
+
</td></tr>
|
46
|
+
</tbody></table>
|
47
|
+
|
48
|
+
**Returns:**
|
49
|
+
|
50
|
+
[EmitArgs](./foundation-events.emitargs.md)
|
51
|
+
|
@@ -2,7 +2,7 @@
|
|
2
2
|
|
3
3
|
[Home](./index.md) > [@genesislcap/foundation-events](./foundation-events.md) > [isEmitOptions](./foundation-events.isemitoptions.md)
|
4
4
|
|
5
|
-
## isEmitOptions
|
5
|
+
## isEmitOptions() function
|
6
6
|
|
7
7
|
|
8
8
|
**Signature:**
|
@@ -10,3 +10,42 @@
|
|
10
10
|
```typescript
|
11
11
|
isEmitOptions: (candidate: EmitOptions | any) => boolean
|
12
12
|
```
|
13
|
+
|
14
|
+
## Parameters
|
15
|
+
|
16
|
+
<table><thead><tr><th>
|
17
|
+
|
18
|
+
Parameter
|
19
|
+
|
20
|
+
|
21
|
+
</th><th>
|
22
|
+
|
23
|
+
Type
|
24
|
+
|
25
|
+
|
26
|
+
</th><th>
|
27
|
+
|
28
|
+
Description
|
29
|
+
|
30
|
+
|
31
|
+
</th></tr></thead>
|
32
|
+
<tbody><tr><td>
|
33
|
+
|
34
|
+
candidate
|
35
|
+
|
36
|
+
|
37
|
+
</td><td>
|
38
|
+
|
39
|
+
[EmitOptions](./foundation-events.emitoptions.md) \| any
|
40
|
+
|
41
|
+
|
42
|
+
</td><td>
|
43
|
+
|
44
|
+
|
45
|
+
</td></tr>
|
46
|
+
</tbody></table>
|
47
|
+
|
48
|
+
**Returns:**
|
49
|
+
|
50
|
+
boolean
|
51
|
+
|
@@ -6,45 +6,322 @@
|
|
6
6
|
|
7
7
|
## Classes
|
8
8
|
|
9
|
-
|
10
|
-
|
11
|
-
|
9
|
+
<table><thead><tr><th>
|
10
|
+
|
11
|
+
Class
|
12
|
+
|
13
|
+
|
14
|
+
</th><th>
|
15
|
+
|
16
|
+
Description
|
17
|
+
|
18
|
+
|
19
|
+
</th></tr></thead>
|
20
|
+
<tbody><tr><td>
|
21
|
+
|
22
|
+
[DefaultEventEmitterDI](./foundation-events.defaulteventemitterdi.md)
|
23
|
+
|
24
|
+
|
25
|
+
</td><td>
|
26
|
+
|
27
|
+
Default EventEmitterDI.
|
28
|
+
|
29
|
+
|
30
|
+
</td></tr>
|
31
|
+
</tbody></table>
|
32
|
+
|
33
|
+
## Functions
|
34
|
+
|
35
|
+
<table><thead><tr><th>
|
36
|
+
|
37
|
+
Function
|
38
|
+
|
39
|
+
|
40
|
+
</th><th>
|
41
|
+
|
42
|
+
Description
|
43
|
+
|
44
|
+
|
45
|
+
</th></tr></thead>
|
46
|
+
<tbody><tr><td>
|
47
|
+
|
48
|
+
[createInputEmitter()](./foundation-events.createinputemitter.md)
|
49
|
+
|
50
|
+
|
51
|
+
</td><td>
|
52
|
+
|
53
|
+
`<input>` template emit helper.
|
54
|
+
|
55
|
+
|
56
|
+
</td></tr>
|
57
|
+
<tr><td>
|
58
|
+
|
59
|
+
[createSelectEmitter()](./foundation-events.createselectemitter.md)
|
60
|
+
|
61
|
+
|
62
|
+
</td><td>
|
63
|
+
|
64
|
+
`<select>` template emit helper.
|
65
|
+
|
66
|
+
|
67
|
+
</td></tr>
|
68
|
+
<tr><td>
|
69
|
+
|
70
|
+
[customEvent(ctx)](./foundation-events.customevent.md)
|
71
|
+
|
72
|
+
|
73
|
+
</td><td>
|
74
|
+
|
75
|
+
|
76
|
+
|
77
|
+
</td></tr>
|
78
|
+
<tr><td>
|
79
|
+
|
80
|
+
[emitter()](./foundation-events.emitter.md)
|
81
|
+
|
82
|
+
|
83
|
+
</td><td>
|
84
|
+
|
85
|
+
emitter function.
|
86
|
+
|
87
|
+
This is the functional equivalent of the strongly typed `.emit` function created with the [EventEmitter()](./foundation-events.eventemitter.md) mixin.
|
88
|
+
|
89
|
+
|
90
|
+
</td></tr>
|
91
|
+
<tr><td>
|
92
|
+
|
93
|
+
[EventEmitter(Target)](./foundation-events.eventemitter.md)
|
94
|
+
|
95
|
+
|
96
|
+
</td><td>
|
97
|
+
|
98
|
+
EventEmitter mixin.
|
99
|
+
|
100
|
+
|
101
|
+
</td></tr>
|
102
|
+
<tr><td>
|
103
|
+
|
104
|
+
[getBaseEmitArgs(args)](./foundation-events.getbaseemitargs.md)
|
105
|
+
|
106
|
+
|
107
|
+
</td><td>
|
108
|
+
|
109
|
+
|
110
|
+
|
111
|
+
</td></tr>
|
112
|
+
<tr><td>
|
113
|
+
|
114
|
+
[isEmitOptions(candidate)](./foundation-events.isemitoptions.md)
|
115
|
+
|
116
|
+
|
117
|
+
</td><td>
|
118
|
+
|
119
|
+
|
120
|
+
|
121
|
+
</td></tr>
|
122
|
+
<tr><td>
|
123
|
+
|
124
|
+
[registerEmitter()](./foundation-events.registeremitter.md)
|
125
|
+
|
126
|
+
|
127
|
+
</td><td>
|
128
|
+
|
129
|
+
Register an emitter with the DI.
|
130
|
+
|
131
|
+
|
132
|
+
</td></tr>
|
133
|
+
</tbody></table>
|
12
134
|
|
13
135
|
## Interfaces
|
14
136
|
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
137
|
+
<table><thead><tr><th>
|
138
|
+
|
139
|
+
Interface
|
140
|
+
|
141
|
+
|
142
|
+
</th><th>
|
143
|
+
|
144
|
+
Description
|
145
|
+
|
146
|
+
|
147
|
+
</th></tr></thead>
|
148
|
+
<tbody><tr><td>
|
149
|
+
|
150
|
+
[EventEmitterDI](./foundation-events.eventemitterdi.md)
|
151
|
+
|
152
|
+
|
153
|
+
</td><td>
|
154
|
+
|
155
|
+
EventEmitterDI interface.
|
156
|
+
|
157
|
+
|
158
|
+
</td></tr>
|
159
|
+
<tr><td>
|
160
|
+
|
161
|
+
[TypedEmitter](./foundation-events.typedemitter.md)
|
162
|
+
|
163
|
+
|
164
|
+
</td><td>
|
165
|
+
|
166
|
+
|
167
|
+
|
168
|
+
</td></tr>
|
169
|
+
</tbody></table>
|
19
170
|
|
20
171
|
## Variables
|
21
172
|
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
173
|
+
<table><thead><tr><th>
|
174
|
+
|
175
|
+
Variable
|
176
|
+
|
177
|
+
|
178
|
+
</th><th>
|
179
|
+
|
180
|
+
Description
|
181
|
+
|
182
|
+
|
183
|
+
</th></tr></thead>
|
184
|
+
<tbody><tr><td>
|
185
|
+
|
186
|
+
[logger](./foundation-events.logger.md)
|
187
|
+
|
188
|
+
|
189
|
+
</td><td>
|
190
|
+
|
191
|
+
|
192
|
+
|
193
|
+
</td></tr>
|
194
|
+
<tr><td>
|
195
|
+
|
196
|
+
[targetChecked](./foundation-events.targetchecked.md)
|
197
|
+
|
198
|
+
|
199
|
+
</td><td>
|
200
|
+
|
201
|
+
|
202
|
+
</td></tr>
|
203
|
+
<tr><td>
|
204
|
+
|
205
|
+
[targetFirstSelectedValue](./foundation-events.targetfirstselectedvalue.md)
|
206
|
+
|
207
|
+
|
208
|
+
</td><td>
|
209
|
+
|
210
|
+
|
211
|
+
|
212
|
+
</td></tr>
|
213
|
+
<tr><td>
|
214
|
+
|
215
|
+
[targetValue](./foundation-events.targetvalue.md)
|
216
|
+
|
217
|
+
|
218
|
+
</td><td>
|
219
|
+
|
220
|
+
|
221
|
+
|
222
|
+
</td></tr>
|
223
|
+
</tbody></table>
|
36
224
|
|
37
225
|
## Type Aliases
|
38
226
|
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
227
|
+
<table><thead><tr><th>
|
228
|
+
|
229
|
+
Type Alias
|
230
|
+
|
231
|
+
|
232
|
+
</th><th>
|
233
|
+
|
234
|
+
Description
|
235
|
+
|
236
|
+
|
237
|
+
</th></tr></thead>
|
238
|
+
<tbody><tr><td>
|
239
|
+
|
240
|
+
[ConstructableTypedEventEmitter](./foundation-events.constructabletypedeventemitter.md)
|
241
|
+
|
242
|
+
|
243
|
+
</td><td>
|
244
|
+
|
245
|
+
|
246
|
+
</td></tr>
|
247
|
+
<tr><td>
|
248
|
+
|
249
|
+
[CustomEventMap](./foundation-events.customeventmap.md)
|
250
|
+
|
251
|
+
|
252
|
+
</td><td>
|
253
|
+
|
254
|
+
|
255
|
+
|
256
|
+
</td></tr>
|
257
|
+
<tr><td>
|
258
|
+
|
259
|
+
[EmitArgs](./foundation-events.emitargs.md)
|
260
|
+
|
261
|
+
|
262
|
+
</td><td>
|
263
|
+
|
264
|
+
|
265
|
+
|
266
|
+
</td></tr>
|
267
|
+
<tr><td>
|
268
|
+
|
269
|
+
[EmitOptions](./foundation-events.emitoptions.md)
|
270
|
+
|
271
|
+
|
272
|
+
</td><td>
|
273
|
+
|
274
|
+
|
275
|
+
|
276
|
+
</td></tr>
|
277
|
+
<tr><td>
|
278
|
+
|
279
|
+
[EmitOrigin](./foundation-events.emitorigin.md)
|
280
|
+
|
281
|
+
|
282
|
+
</td><td>
|
283
|
+
|
284
|
+
|
285
|
+
|
286
|
+
</td></tr>
|
287
|
+
<tr><td>
|
288
|
+
|
289
|
+
[EmitReturn](./foundation-events.emitreturn.md)
|
290
|
+
|
291
|
+
|
292
|
+
</td><td>
|
293
|
+
|
294
|
+
|
295
|
+
|
296
|
+
</td></tr>
|
297
|
+
<tr><td>
|
298
|
+
|
299
|
+
[EventDetailMap](./foundation-events.eventdetailmap.md)
|
300
|
+
|
301
|
+
|
302
|
+
</td><td>
|
303
|
+
|
304
|
+
|
305
|
+
|
306
|
+
</td></tr>
|
307
|
+
<tr><td>
|
308
|
+
|
309
|
+
[EventEmitterTarget](./foundation-events.eventemittertarget.md)
|
310
|
+
|
311
|
+
|
312
|
+
</td><td>
|
313
|
+
|
314
|
+
|
315
|
+
</td></tr>
|
316
|
+
<tr><td>
|
317
|
+
|
318
|
+
[KeysMatching](./foundation-events.keysmatching.md)
|
319
|
+
|
320
|
+
|
321
|
+
</td><td>
|
322
|
+
|
323
|
+
|
324
|
+
|
325
|
+
</td></tr>
|
326
|
+
</tbody></table>
|
50
327
|
|
@@ -2,7 +2,7 @@
|
|
2
2
|
|
3
3
|
[Home](./index.md) > [@genesislcap/foundation-events](./foundation-events.md) > [registerEmitter](./foundation-events.registeremitter.md)
|
4
4
|
|
5
|
-
## registerEmitter
|
5
|
+
## registerEmitter() function
|
6
6
|
|
7
7
|
Register an emitter with the DI.
|
8
8
|
|
@@ -11,3 +11,7 @@ Register an emitter with the DI.
|
|
11
11
|
```typescript
|
12
12
|
registerEmitter: <TEventDetailMap extends EventDetailMap>() => import("@microsoft/fast-foundation").InterfaceSymbol<EventEmitterDI<TEventDetailMap>>
|
13
13
|
```
|
14
|
+
**Returns:**
|
15
|
+
|
16
|
+
import("@microsoft/fast-foundation").InterfaceSymbol<[EventEmitterDI](./foundation-events.eventemitterdi.md)<!-- --><TEventDetailMap>>
|
17
|
+
|
@@ -12,9 +12,37 @@ $emit<K extends keyof TEventDetailMap & string>(...args: TEventDetailMap[K] exte
|
|
12
12
|
|
13
13
|
## Parameters
|
14
14
|
|
15
|
-
|
16
|
-
|
17
|
-
|
15
|
+
<table><thead><tr><th>
|
16
|
+
|
17
|
+
Parameter
|
18
|
+
|
19
|
+
|
20
|
+
</th><th>
|
21
|
+
|
22
|
+
Type
|
23
|
+
|
24
|
+
|
25
|
+
</th><th>
|
26
|
+
|
27
|
+
Description
|
28
|
+
|
29
|
+
|
30
|
+
</th></tr></thead>
|
31
|
+
<tbody><tr><td>
|
32
|
+
|
33
|
+
args
|
34
|
+
|
35
|
+
|
36
|
+
</td><td>
|
37
|
+
|
38
|
+
TEventDetailMap\[K\] extends void ? \[type: K, options?: [EmitOptions](./foundation-events.emitoptions.md)<!-- -->\] : \[type: K, detail: TEventDetailMap\[K\], options?: [EmitOptions](./foundation-events.emitoptions.md)<!-- -->\]
|
39
|
+
|
40
|
+
|
41
|
+
</td><td>
|
42
|
+
|
43
|
+
|
44
|
+
</td></tr>
|
45
|
+
</tbody></table>
|
18
46
|
|
19
47
|
**Returns:**
|
20
48
|
|
@@ -13,7 +13,25 @@ export interface TypedEmitter<TEventDetailMap extends EventDetailMap>
|
|
13
13
|
|
14
14
|
## Methods
|
15
15
|
|
16
|
-
|
17
|
-
|
18
|
-
|
16
|
+
<table><thead><tr><th>
|
17
|
+
|
18
|
+
Method
|
19
|
+
|
20
|
+
|
21
|
+
</th><th>
|
22
|
+
|
23
|
+
Description
|
24
|
+
|
25
|
+
|
26
|
+
</th></tr></thead>
|
27
|
+
<tbody><tr><td>
|
28
|
+
|
29
|
+
[$emit(args)](./foundation-events.typedemitter._emit.md)
|
30
|
+
|
31
|
+
|
32
|
+
</td><td>
|
33
|
+
|
34
|
+
|
35
|
+
</td></tr>
|
36
|
+
</tbody></table>
|
19
37
|
|
package/docs/api/index.md
CHANGED
@@ -6,7 +6,25 @@
|
|
6
6
|
|
7
7
|
## Packages
|
8
8
|
|
9
|
-
|
10
|
-
|
11
|
-
|
9
|
+
<table><thead><tr><th>
|
10
|
+
|
11
|
+
Package
|
12
|
+
|
13
|
+
|
14
|
+
</th><th>
|
15
|
+
|
16
|
+
Description
|
17
|
+
|
18
|
+
|
19
|
+
</th></tr></thead>
|
20
|
+
<tbody><tr><td>
|
21
|
+
|
22
|
+
[@genesislcap/foundation-events](./foundation-events.md)
|
23
|
+
|
24
|
+
|
25
|
+
</td><td>
|
26
|
+
|
27
|
+
|
28
|
+
</td></tr>
|
29
|
+
</tbody></table>
|
12
30
|
|