@stencil/core 4.38.0 → 4.38.1

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 (90) hide show
  1. package/cli/index.cjs +1 -1
  2. package/cli/index.js +1 -1
  3. package/cli/package.json +1 -1
  4. package/compiler/lib.decorators.d.ts +13 -15
  5. package/compiler/lib.dom.asynciterable.d.ts +14 -6
  6. package/compiler/lib.dom.d.ts +15847 -5014
  7. package/compiler/lib.dom.iterable.d.ts +207 -111
  8. package/compiler/lib.es2015.core.d.ts +9 -9
  9. package/compiler/lib.es2015.generator.d.ts +2 -2
  10. package/compiler/lib.es2015.iterable.d.ts +214 -104
  11. package/compiler/lib.es2015.symbol.wellknown.d.ts +11 -11
  12. package/compiler/lib.es2016.array.include.d.ts +9 -9
  13. package/compiler/lib.es2016.intl.d.ts +1 -1
  14. package/compiler/lib.es2017.arraybuffer.d.ts +21 -0
  15. package/compiler/lib.es2017.d.ts +3 -2
  16. package/compiler/lib.es2017.object.d.ts +4 -4
  17. package/compiler/lib.es2017.sharedmemory.d.ts +15 -15
  18. package/compiler/lib.es2017.typedarrays.d.ts +9 -9
  19. package/compiler/lib.es2018.asyncgenerator.d.ts +2 -2
  20. package/compiler/lib.es2018.asynciterable.d.ts +16 -6
  21. package/compiler/lib.es2020.bigint.d.ts +100 -62
  22. package/compiler/lib.es2020.intl.d.ts +36 -36
  23. package/compiler/lib.es2020.sharedmemory.d.ts +13 -11
  24. package/compiler/lib.es2020.string.d.ts +3 -1
  25. package/compiler/lib.es2020.symbol.wellknown.d.ts +5 -1
  26. package/compiler/lib.es2021.intl.d.ts +17 -17
  27. package/compiler/lib.es2021.weakref.d.ts +2 -0
  28. package/compiler/lib.es2022.array.d.ts +11 -11
  29. package/compiler/lib.es2022.d.ts +1 -2
  30. package/compiler/lib.es2022.error.d.ts +2 -0
  31. package/compiler/lib.es2022.intl.d.ts +39 -11
  32. package/compiler/lib.es2023.array.d.ts +79 -79
  33. package/compiler/lib.es2024.arraybuffer.d.ts +65 -0
  34. package/compiler/lib.es2024.collection.d.ts +29 -0
  35. package/compiler/lib.es2024.d.ts +26 -0
  36. package/compiler/lib.es2024.full.d.ts +24 -0
  37. package/compiler/lib.es2024.promise.d.ts +35 -0
  38. package/compiler/{lib.es2022.sharedmemory.d.ts → lib.es2024.sharedmemory.d.ts} +29 -0
  39. package/compiler/lib.es5.d.ts +321 -305
  40. package/compiler/lib.esnext.array.d.ts +1 -1
  41. package/compiler/lib.esnext.collection.d.ts +1 -11
  42. package/compiler/lib.esnext.d.ts +6 -5
  43. package/compiler/lib.esnext.disposable.d.ts +8 -0
  44. package/compiler/lib.esnext.error.d.ts +24 -0
  45. package/compiler/lib.esnext.float16.d.ts +445 -0
  46. package/compiler/lib.esnext.iterator.d.ts +148 -0
  47. package/compiler/lib.esnext.promise.d.ts +11 -12
  48. package/compiler/lib.esnext.sharedmemory.d.ts +25 -0
  49. package/compiler/lib.webworker.asynciterable.d.ts +14 -6
  50. package/compiler/lib.webworker.d.ts +5113 -1394
  51. package/compiler/lib.webworker.iterable.d.ts +125 -61
  52. package/compiler/package.json +1 -1
  53. package/compiler/stencil.js +20679 -15213
  54. package/dev-server/client/index.js +1 -1
  55. package/dev-server/client/package.json +1 -1
  56. package/dev-server/connector.html +2 -2
  57. package/dev-server/index.js +1 -1
  58. package/dev-server/package.json +1 -1
  59. package/dev-server/server-process.js +2 -2
  60. package/internal/app-data/package.json +1 -1
  61. package/internal/app-globals/package.json +1 -1
  62. package/internal/client/index.js +5 -2
  63. package/internal/client/package.json +1 -1
  64. package/internal/client/patch-browser.js +1 -1
  65. package/internal/hydrate/index.js +5 -2
  66. package/internal/hydrate/package.json +1 -1
  67. package/internal/hydrate/runner.js +2 -2
  68. package/internal/package.json +1 -1
  69. package/internal/stencil-public-runtime.d.ts +2 -1
  70. package/internal/testing/index.js +4 -1
  71. package/internal/testing/package.json +1 -1
  72. package/mock-doc/index.cjs +2 -2
  73. package/mock-doc/index.d.ts +2 -2
  74. package/mock-doc/index.js +2 -2
  75. package/mock-doc/package.json +1 -1
  76. package/package.json +9 -9
  77. package/screenshot/index.js +1 -1
  78. package/screenshot/package.json +1 -1
  79. package/screenshot/pixel-match.js +1 -1
  80. package/screenshot/screenshot-fs.d.ts +1 -1
  81. package/sys/node/index.js +1 -1
  82. package/sys/node/package.json +1 -1
  83. package/sys/node/worker.js +1 -1
  84. package/testing/index.d.ts +1 -1
  85. package/testing/index.js +93 -1
  86. package/testing/mocks.d.ts +1 -0
  87. package/testing/package.json +1 -1
  88. /package/compiler/{lib.esnext.object.d.ts → lib.es2024.object.d.ts} +0 -0
  89. /package/compiler/{lib.esnext.regexp.d.ts → lib.es2024.regexp.d.ts} +0 -0
  90. /package/compiler/{lib.esnext.string.d.ts → lib.es2024.string.d.ts} +0 -0
@@ -20,13 +20,12 @@ and limitations under the License.
20
20
  /// Window Iterable APIs
21
21
  /////////////////////////////
22
22
 
23
- interface AbortSignal {
24
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static) */
25
- any(signals: Iterable<AbortSignal>): AbortSignal;
26
- }
27
-
28
23
  interface AudioParam {
29
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioParam/setValueCurveAtTime) */
24
+ /**
25
+ * The **`setValueCurveAtTime()`** method of the following a curve defined by a list of values.
26
+ *
27
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioParam/setValueCurveAtTime)
28
+ */
30
29
  setValueCurveAtTime(values: Iterable<number>, startTime: number, duration: number): AudioParam;
31
30
  }
32
31
 
@@ -34,47 +33,59 @@ interface AudioParamMap extends ReadonlyMap<string, AudioParam> {
34
33
  }
35
34
 
36
35
  interface BaseAudioContext {
37
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/createIIRFilter) */
36
+ /**
37
+ * The **`createIIRFilter()`** method of the BaseAudioContext interface creates an IIRFilterNode, which represents a general **infinite impulse response** (IIR) filter which can be configured to serve as various types of filter.
38
+ *
39
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/createIIRFilter)
40
+ */
38
41
  createIIRFilter(feedforward: Iterable<number>, feedback: Iterable<number>): IIRFilterNode;
39
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/createPeriodicWave) */
42
+ /**
43
+ * The `createPeriodicWave()` method of the BaseAudioContext interface is used to create a PeriodicWave.
44
+ *
45
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/createPeriodicWave)
46
+ */
40
47
  createPeriodicWave(real: Iterable<number>, imag: Iterable<number>, constraints?: PeriodicWaveConstraints): PeriodicWave;
41
48
  }
42
49
 
43
50
  interface CSSKeyframesRule {
44
- [Symbol.iterator](): IterableIterator<CSSKeyframeRule>;
51
+ [Symbol.iterator](): ArrayIterator<CSSKeyframeRule>;
45
52
  }
46
53
 
47
54
  interface CSSNumericArray {
48
- [Symbol.iterator](): IterableIterator<CSSNumericValue>;
49
- entries(): IterableIterator<[number, CSSNumericValue]>;
50
- keys(): IterableIterator<number>;
51
- values(): IterableIterator<CSSNumericValue>;
55
+ [Symbol.iterator](): ArrayIterator<CSSNumericValue>;
56
+ entries(): ArrayIterator<[number, CSSNumericValue]>;
57
+ keys(): ArrayIterator<number>;
58
+ values(): ArrayIterator<CSSNumericValue>;
52
59
  }
53
60
 
54
61
  interface CSSRuleList {
55
- [Symbol.iterator](): IterableIterator<CSSRule>;
62
+ [Symbol.iterator](): ArrayIterator<CSSRule>;
56
63
  }
57
64
 
58
65
  interface CSSStyleDeclaration {
59
- [Symbol.iterator](): IterableIterator<string>;
66
+ [Symbol.iterator](): ArrayIterator<string>;
60
67
  }
61
68
 
62
69
  interface CSSTransformValue {
63
- [Symbol.iterator](): IterableIterator<CSSTransformComponent>;
64
- entries(): IterableIterator<[number, CSSTransformComponent]>;
65
- keys(): IterableIterator<number>;
66
- values(): IterableIterator<CSSTransformComponent>;
70
+ [Symbol.iterator](): ArrayIterator<CSSTransformComponent>;
71
+ entries(): ArrayIterator<[number, CSSTransformComponent]>;
72
+ keys(): ArrayIterator<number>;
73
+ values(): ArrayIterator<CSSTransformComponent>;
67
74
  }
68
75
 
69
76
  interface CSSUnparsedValue {
70
- [Symbol.iterator](): IterableIterator<CSSUnparsedSegment>;
71
- entries(): IterableIterator<[number, CSSUnparsedSegment]>;
72
- keys(): IterableIterator<number>;
73
- values(): IterableIterator<CSSUnparsedSegment>;
77
+ [Symbol.iterator](): ArrayIterator<CSSUnparsedSegment>;
78
+ entries(): ArrayIterator<[number, CSSUnparsedSegment]>;
79
+ keys(): ArrayIterator<number>;
80
+ values(): ArrayIterator<CSSUnparsedSegment>;
74
81
  }
75
82
 
76
83
  interface Cache {
77
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache/addAll) */
84
+ /**
85
+ * The **`addAll()`** method of the Cache interface takes an array of URLs, retrieves them, and adds the resulting response objects to the given cache.
86
+ *
87
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache/addAll)
88
+ */
78
89
  addAll(requests: Iterable<RequestInfo>): Promise<void>;
79
90
  }
80
91
 
@@ -88,76 +99,99 @@ interface CanvasPathDrawingStyles {
88
99
  setLineDash(segments: Iterable<number>): void;
89
100
  }
90
101
 
102
+ interface CookieStoreManager {
103
+ /**
104
+ * The **`subscribe()`** method of the CookieStoreManager interface subscribes a ServiceWorkerRegistration to cookie change events.
105
+ *
106
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CookieStoreManager/subscribe)
107
+ */
108
+ subscribe(subscriptions: Iterable<CookieStoreGetOptions>): Promise<void>;
109
+ /**
110
+ * The **`unsubscribe()`** method of the CookieStoreManager interface stops the ServiceWorkerRegistration from receiving previously subscribed events.
111
+ *
112
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CookieStoreManager/unsubscribe)
113
+ */
114
+ unsubscribe(subscriptions: Iterable<CookieStoreGetOptions>): Promise<void>;
115
+ }
116
+
91
117
  interface CustomStateSet extends Set<string> {
92
118
  }
93
119
 
94
120
  interface DOMRectList {
95
- [Symbol.iterator](): IterableIterator<DOMRect>;
121
+ [Symbol.iterator](): ArrayIterator<DOMRect>;
96
122
  }
97
123
 
98
124
  interface DOMStringList {
99
- [Symbol.iterator](): IterableIterator<string>;
125
+ [Symbol.iterator](): ArrayIterator<string>;
100
126
  }
101
127
 
102
128
  interface DOMTokenList {
103
- [Symbol.iterator](): IterableIterator<string>;
104
- entries(): IterableIterator<[number, string]>;
105
- keys(): IterableIterator<number>;
106
- values(): IterableIterator<string>;
129
+ [Symbol.iterator](): ArrayIterator<string>;
130
+ entries(): ArrayIterator<[number, string]>;
131
+ keys(): ArrayIterator<number>;
132
+ values(): ArrayIterator<string>;
107
133
  }
108
134
 
109
135
  interface DataTransferItemList {
110
- [Symbol.iterator](): IterableIterator<DataTransferItem>;
136
+ [Symbol.iterator](): ArrayIterator<DataTransferItem>;
111
137
  }
112
138
 
113
139
  interface EventCounts extends ReadonlyMap<string, number> {
114
140
  }
115
141
 
116
142
  interface FileList {
117
- [Symbol.iterator](): IterableIterator<File>;
143
+ [Symbol.iterator](): ArrayIterator<File>;
118
144
  }
119
145
 
120
146
  interface FontFaceSet extends Set<FontFace> {
121
147
  }
122
148
 
149
+ interface FormDataIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
150
+ [Symbol.iterator](): FormDataIterator<T>;
151
+ }
152
+
123
153
  interface FormData {
124
- [Symbol.iterator](): IterableIterator<[string, FormDataEntryValue]>;
154
+ [Symbol.iterator](): FormDataIterator<[string, FormDataEntryValue]>;
125
155
  /** Returns an array of key, value pairs for every entry in the list. */
126
- entries(): IterableIterator<[string, FormDataEntryValue]>;
156
+ entries(): FormDataIterator<[string, FormDataEntryValue]>;
127
157
  /** Returns a list of keys in the list. */
128
- keys(): IterableIterator<string>;
158
+ keys(): FormDataIterator<string>;
129
159
  /** Returns a list of values in the list. */
130
- values(): IterableIterator<FormDataEntryValue>;
160
+ values(): FormDataIterator<FormDataEntryValue>;
131
161
  }
132
162
 
133
163
  interface HTMLAllCollection {
134
- [Symbol.iterator](): IterableIterator<Element>;
164
+ [Symbol.iterator](): ArrayIterator<Element>;
135
165
  }
136
166
 
137
167
  interface HTMLCollectionBase {
138
- [Symbol.iterator](): IterableIterator<Element>;
168
+ [Symbol.iterator](): ArrayIterator<Element>;
139
169
  }
140
170
 
141
171
  interface HTMLCollectionOf<T extends Element> {
142
- [Symbol.iterator](): IterableIterator<T>;
172
+ [Symbol.iterator](): ArrayIterator<T>;
143
173
  }
144
174
 
145
175
  interface HTMLFormElement {
146
- [Symbol.iterator](): IterableIterator<Element>;
176
+ [Symbol.iterator](): ArrayIterator<Element>;
147
177
  }
148
178
 
149
179
  interface HTMLSelectElement {
150
- [Symbol.iterator](): IterableIterator<HTMLOptionElement>;
180
+ [Symbol.iterator](): ArrayIterator<HTMLOptionElement>;
181
+ }
182
+
183
+ interface HeadersIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
184
+ [Symbol.iterator](): HeadersIterator<T>;
151
185
  }
152
186
 
153
187
  interface Headers {
154
- [Symbol.iterator](): IterableIterator<[string, string]>;
188
+ [Symbol.iterator](): HeadersIterator<[string, string]>;
155
189
  /** Returns an iterator allowing to go through all key/value pairs contained in this object. */
156
- entries(): IterableIterator<[string, string]>;
190
+ entries(): HeadersIterator<[string, string]>;
157
191
  /** Returns an iterator allowing to go through all keys of the key/value pairs contained in this object. */
158
- keys(): IterableIterator<string>;
192
+ keys(): HeadersIterator<string>;
159
193
  /** Returns an iterator allowing to go through all values of the key/value pairs contained in this object. */
160
- values(): IterableIterator<string>;
194
+ values(): HeadersIterator<string>;
161
195
  }
162
196
 
163
197
  interface Highlight extends Set<AbstractRange> {
@@ -168,7 +202,7 @@ interface HighlightRegistry extends Map<string, Highlight> {
168
202
 
169
203
  interface IDBDatabase {
170
204
  /**
171
- * Returns a new transaction with the given mode ("readonly" or "readwrite") and scope which can be a single object store name or an array of names.
205
+ * The **`transaction`** method of the IDBDatabase interface immediately returns a transaction object (IDBTransaction) containing the IDBTransaction.objectStore method, which you can use to access your object store.
172
206
  *
173
207
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBDatabase/transaction)
174
208
  */
@@ -177,195 +211,257 @@ interface IDBDatabase {
177
211
 
178
212
  interface IDBObjectStore {
179
213
  /**
180
- * Creates a new index in store with the given name, keyPath and options and returns a new IDBIndex. If the keyPath and options define constraints that cannot be satisfied with the data already in store the upgrade transaction will abort with a "ConstraintError" DOMException.
181
- *
182
- * Throws an "InvalidStateError" DOMException if not called within an upgrade transaction.
214
+ * The **`createIndex()`** method of the field/column defining a new data point for each database record to contain.
183
215
  *
184
216
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/createIndex)
185
217
  */
186
218
  createIndex(name: string, keyPath: string | Iterable<string>, options?: IDBIndexParameters): IDBIndex;
187
219
  }
188
220
 
221
+ interface ImageTrackList {
222
+ [Symbol.iterator](): ArrayIterator<ImageTrack>;
223
+ }
224
+
189
225
  interface MIDIInputMap extends ReadonlyMap<string, MIDIInput> {
190
226
  }
191
227
 
192
228
  interface MIDIOutput {
193
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/MIDIOutput/send) */
229
+ /**
230
+ * The **`send()`** method of the MIDIOutput interface queues messages for the corresponding MIDI port.
231
+ *
232
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MIDIOutput/send)
233
+ */
194
234
  send(data: Iterable<number>, timestamp?: DOMHighResTimeStamp): void;
195
235
  }
196
236
 
197
237
  interface MIDIOutputMap extends ReadonlyMap<string, MIDIOutput> {
198
238
  }
199
239
 
240
+ interface MediaKeyStatusMapIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
241
+ [Symbol.iterator](): MediaKeyStatusMapIterator<T>;
242
+ }
243
+
200
244
  interface MediaKeyStatusMap {
201
- [Symbol.iterator](): IterableIterator<[BufferSource, MediaKeyStatus]>;
202
- entries(): IterableIterator<[BufferSource, MediaKeyStatus]>;
203
- keys(): IterableIterator<BufferSource>;
204
- values(): IterableIterator<MediaKeyStatus>;
245
+ [Symbol.iterator](): MediaKeyStatusMapIterator<[BufferSource, MediaKeyStatus]>;
246
+ entries(): MediaKeyStatusMapIterator<[BufferSource, MediaKeyStatus]>;
247
+ keys(): MediaKeyStatusMapIterator<BufferSource>;
248
+ values(): MediaKeyStatusMapIterator<MediaKeyStatus>;
205
249
  }
206
250
 
207
251
  interface MediaList {
208
- [Symbol.iterator](): IterableIterator<string>;
252
+ [Symbol.iterator](): ArrayIterator<string>;
209
253
  }
210
254
 
211
255
  interface MessageEvent<T = any> {
212
- /**
213
- * @deprecated
214
- *
215
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/initMessageEvent)
216
- */
256
+ /** @deprecated */
217
257
  initMessageEvent(type: string, bubbles?: boolean, cancelable?: boolean, data?: any, origin?: string, lastEventId?: string, source?: MessageEventSource | null, ports?: Iterable<MessagePort>): void;
218
258
  }
219
259
 
220
260
  interface MimeTypeArray {
221
- [Symbol.iterator](): IterableIterator<MimeType>;
261
+ [Symbol.iterator](): ArrayIterator<MimeType>;
222
262
  }
223
263
 
224
264
  interface NamedNodeMap {
225
- [Symbol.iterator](): IterableIterator<Attr>;
265
+ [Symbol.iterator](): ArrayIterator<Attr>;
226
266
  }
227
267
 
228
268
  interface Navigator {
229
269
  /**
270
+ * The **`requestMediaKeySystemAccess()`** method of the Navigator interface returns a Promise which delivers a MediaKeySystemAccess object that can be used to access a particular media key system, which can in turn be used to create keys for decrypting a media stream.
230
271
  * Available only in secure contexts.
231
272
  *
232
273
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Navigator/requestMediaKeySystemAccess)
233
274
  */
234
275
  requestMediaKeySystemAccess(keySystem: string, supportedConfigurations: Iterable<MediaKeySystemConfiguration>): Promise<MediaKeySystemAccess>;
235
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Navigator/vibrate) */
276
+ /**
277
+ * The **`vibrate()`** method of the Navigator interface pulses the vibration hardware on the device, if such hardware exists.
278
+ *
279
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Navigator/vibrate)
280
+ */
236
281
  vibrate(pattern: Iterable<number>): boolean;
237
282
  }
238
283
 
239
284
  interface NodeList {
240
- [Symbol.iterator](): IterableIterator<Node>;
285
+ [Symbol.iterator](): ArrayIterator<Node>;
241
286
  /** Returns an array of key, value pairs for every entry in the list. */
242
- entries(): IterableIterator<[number, Node]>;
287
+ entries(): ArrayIterator<[number, Node]>;
243
288
  /** Returns an list of keys in the list. */
244
- keys(): IterableIterator<number>;
289
+ keys(): ArrayIterator<number>;
245
290
  /** Returns an list of values in the list. */
246
- values(): IterableIterator<Node>;
291
+ values(): ArrayIterator<Node>;
247
292
  }
248
293
 
249
294
  interface NodeListOf<TNode extends Node> {
250
- [Symbol.iterator](): IterableIterator<TNode>;
295
+ [Symbol.iterator](): ArrayIterator<TNode>;
251
296
  /** Returns an array of key, value pairs for every entry in the list. */
252
- entries(): IterableIterator<[number, TNode]>;
297
+ entries(): ArrayIterator<[number, TNode]>;
253
298
  /** Returns an list of keys in the list. */
254
- keys(): IterableIterator<number>;
299
+ keys(): ArrayIterator<number>;
255
300
  /** Returns an list of values in the list. */
256
- values(): IterableIterator<TNode>;
301
+ values(): ArrayIterator<TNode>;
257
302
  }
258
303
 
259
304
  interface Plugin {
260
- [Symbol.iterator](): IterableIterator<MimeType>;
305
+ [Symbol.iterator](): ArrayIterator<MimeType>;
261
306
  }
262
307
 
263
308
  interface PluginArray {
264
- [Symbol.iterator](): IterableIterator<Plugin>;
309
+ [Symbol.iterator](): ArrayIterator<Plugin>;
265
310
  }
266
311
 
267
312
  interface RTCRtpTransceiver {
268
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCRtpTransceiver/setCodecPreferences) */
269
- setCodecPreferences(codecs: Iterable<RTCRtpCodecCapability>): void;
313
+ /**
314
+ * The **`setCodecPreferences()`** method of the RTCRtpTransceiver interface is used to set the codecs that the transceiver allows for decoding _received_ data, in order of decreasing preference.
315
+ *
316
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/RTCRtpTransceiver/setCodecPreferences)
317
+ */
318
+ setCodecPreferences(codecs: Iterable<RTCRtpCodec>): void;
270
319
  }
271
320
 
272
321
  interface RTCStatsReport extends ReadonlyMap<string, any> {
273
322
  }
274
323
 
275
324
  interface SVGLengthList {
276
- [Symbol.iterator](): IterableIterator<SVGLength>;
325
+ [Symbol.iterator](): ArrayIterator<SVGLength>;
277
326
  }
278
327
 
279
328
  interface SVGNumberList {
280
- [Symbol.iterator](): IterableIterator<SVGNumber>;
329
+ [Symbol.iterator](): ArrayIterator<SVGNumber>;
281
330
  }
282
331
 
283
332
  interface SVGPointList {
284
- [Symbol.iterator](): IterableIterator<DOMPoint>;
333
+ [Symbol.iterator](): ArrayIterator<DOMPoint>;
285
334
  }
286
335
 
287
336
  interface SVGStringList {
288
- [Symbol.iterator](): IterableIterator<string>;
337
+ [Symbol.iterator](): ArrayIterator<string>;
289
338
  }
290
339
 
291
340
  interface SVGTransformList {
292
- [Symbol.iterator](): IterableIterator<SVGTransform>;
341
+ [Symbol.iterator](): ArrayIterator<SVGTransform>;
293
342
  }
294
343
 
295
344
  interface SourceBufferList {
296
- [Symbol.iterator](): IterableIterator<SourceBuffer>;
345
+ [Symbol.iterator](): ArrayIterator<SourceBuffer>;
297
346
  }
298
347
 
299
348
  interface SpeechRecognitionResult {
300
- [Symbol.iterator](): IterableIterator<SpeechRecognitionAlternative>;
349
+ [Symbol.iterator](): ArrayIterator<SpeechRecognitionAlternative>;
301
350
  }
302
351
 
303
352
  interface SpeechRecognitionResultList {
304
- [Symbol.iterator](): IterableIterator<SpeechRecognitionResult>;
353
+ [Symbol.iterator](): ArrayIterator<SpeechRecognitionResult>;
354
+ }
355
+
356
+ interface StylePropertyMapReadOnlyIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
357
+ [Symbol.iterator](): StylePropertyMapReadOnlyIterator<T>;
305
358
  }
306
359
 
307
360
  interface StylePropertyMapReadOnly {
308
- [Symbol.iterator](): IterableIterator<[string, Iterable<CSSStyleValue>]>;
309
- entries(): IterableIterator<[string, Iterable<CSSStyleValue>]>;
310
- keys(): IterableIterator<string>;
311
- values(): IterableIterator<Iterable<CSSStyleValue>>;
361
+ [Symbol.iterator](): StylePropertyMapReadOnlyIterator<[string, Iterable<CSSStyleValue>]>;
362
+ entries(): StylePropertyMapReadOnlyIterator<[string, Iterable<CSSStyleValue>]>;
363
+ keys(): StylePropertyMapReadOnlyIterator<string>;
364
+ values(): StylePropertyMapReadOnlyIterator<Iterable<CSSStyleValue>>;
312
365
  }
313
366
 
314
367
  interface StyleSheetList {
315
- [Symbol.iterator](): IterableIterator<CSSStyleSheet>;
368
+ [Symbol.iterator](): ArrayIterator<CSSStyleSheet>;
316
369
  }
317
370
 
318
371
  interface SubtleCrypto {
319
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveKey) */
372
+ /**
373
+ * The **`deriveKey()`** method of the SubtleCrypto interface can be used to derive a secret key from a master key.
374
+ *
375
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveKey)
376
+ */
320
377
  deriveKey(algorithm: AlgorithmIdentifier | EcdhKeyDeriveParams | HkdfParams | Pbkdf2Params, baseKey: CryptoKey, derivedKeyType: AlgorithmIdentifier | AesDerivedKeyParams | HmacImportParams | HkdfParams | Pbkdf2Params, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
321
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/generateKey) */
322
- generateKey(algorithm: "Ed25519", extractable: boolean, keyUsages: ReadonlyArray<"sign" | "verify">): Promise<CryptoKeyPair>;
378
+ /**
379
+ * The **`generateKey()`** method of the SubtleCrypto interface is used to generate a new key (for symmetric algorithms) or key pair (for public-key algorithms).
380
+ *
381
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/generateKey)
382
+ */
383
+ generateKey(algorithm: "Ed25519" | { name: "Ed25519" }, extractable: boolean, keyUsages: ReadonlyArray<"sign" | "verify">): Promise<CryptoKeyPair>;
323
384
  generateKey(algorithm: RsaHashedKeyGenParams | EcKeyGenParams, extractable: boolean, keyUsages: ReadonlyArray<KeyUsage>): Promise<CryptoKeyPair>;
324
385
  generateKey(algorithm: AesKeyGenParams | HmacKeyGenParams | Pbkdf2Params, extractable: boolean, keyUsages: ReadonlyArray<KeyUsage>): Promise<CryptoKey>;
325
386
  generateKey(algorithm: AlgorithmIdentifier, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKeyPair | CryptoKey>;
326
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey) */
387
+ /**
388
+ * The **`importKey()`** method of the SubtleCrypto interface imports a key: that is, it takes as input a key in an external, portable format and gives you a CryptoKey object that you can use in the Web Crypto API.
389
+ *
390
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey)
391
+ */
327
392
  importKey(format: "jwk", keyData: JsonWebKey, algorithm: AlgorithmIdentifier | RsaHashedImportParams | EcKeyImportParams | HmacImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: ReadonlyArray<KeyUsage>): Promise<CryptoKey>;
328
393
  importKey(format: Exclude<KeyFormat, "jwk">, keyData: BufferSource, algorithm: AlgorithmIdentifier | RsaHashedImportParams | EcKeyImportParams | HmacImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
329
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey) */
394
+ /**
395
+ * The **`unwrapKey()`** method of the SubtleCrypto interface 'unwraps' a key.
396
+ *
397
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey)
398
+ */
330
399
  unwrapKey(format: KeyFormat, wrappedKey: BufferSource, unwrappingKey: CryptoKey, unwrapAlgorithm: AlgorithmIdentifier | RsaOaepParams | AesCtrParams | AesCbcParams | AesGcmParams, unwrappedKeyAlgorithm: AlgorithmIdentifier | RsaHashedImportParams | EcKeyImportParams | HmacImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
331
400
  }
332
401
 
333
402
  interface TextTrackCueList {
334
- [Symbol.iterator](): IterableIterator<TextTrackCue>;
403
+ [Symbol.iterator](): ArrayIterator<TextTrackCue>;
335
404
  }
336
405
 
337
406
  interface TextTrackList {
338
- [Symbol.iterator](): IterableIterator<TextTrack>;
407
+ [Symbol.iterator](): ArrayIterator<TextTrack>;
339
408
  }
340
409
 
341
410
  interface TouchList {
342
- [Symbol.iterator](): IterableIterator<Touch>;
411
+ [Symbol.iterator](): ArrayIterator<Touch>;
412
+ }
413
+
414
+ interface URLSearchParamsIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
415
+ [Symbol.iterator](): URLSearchParamsIterator<T>;
343
416
  }
344
417
 
345
418
  interface URLSearchParams {
346
- [Symbol.iterator](): IterableIterator<[string, string]>;
419
+ [Symbol.iterator](): URLSearchParamsIterator<[string, string]>;
347
420
  /** Returns an array of key, value pairs for every entry in the search params. */
348
- entries(): IterableIterator<[string, string]>;
421
+ entries(): URLSearchParamsIterator<[string, string]>;
349
422
  /** Returns a list of keys in the search params. */
350
- keys(): IterableIterator<string>;
423
+ keys(): URLSearchParamsIterator<string>;
351
424
  /** Returns a list of values in the search params. */
352
- values(): IterableIterator<string>;
425
+ values(): URLSearchParamsIterator<string>;
426
+ }
427
+
428
+ interface ViewTransitionTypeSet extends Set<string> {
353
429
  }
354
430
 
355
431
  interface WEBGL_draw_buffers {
356
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_draw_buffers/drawBuffersWEBGL) */
432
+ /**
433
+ * The **`WEBGL_draw_buffers.drawBuffersWEBGL()`** method is part of the WebGL API and allows you to define the draw buffers to which all fragment colors are written.
434
+ *
435
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_draw_buffers/drawBuffersWEBGL)
436
+ */
357
437
  drawBuffersWEBGL(buffers: Iterable<GLenum>): void;
358
438
  }
359
439
 
360
440
  interface WEBGL_multi_draw {
361
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawArraysInstancedWEBGL) */
362
- multiDrawArraysInstancedWEBGL(mode: GLenum, firstsList: Int32Array | Iterable<GLint>, firstsOffset: number, countsList: Int32Array | Iterable<GLsizei>, countsOffset: number, instanceCountsList: Int32Array | Iterable<GLsizei>, instanceCountsOffset: number, drawcount: GLsizei): void;
363
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawArraysWEBGL) */
364
- multiDrawArraysWEBGL(mode: GLenum, firstsList: Int32Array | Iterable<GLint>, firstsOffset: number, countsList: Int32Array | Iterable<GLsizei>, countsOffset: number, drawcount: GLsizei): void;
365
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawElementsInstancedWEBGL) */
366
- multiDrawElementsInstancedWEBGL(mode: GLenum, countsList: Int32Array | Iterable<GLsizei>, countsOffset: number, type: GLenum, offsetsList: Int32Array | Iterable<GLsizei>, offsetsOffset: number, instanceCountsList: Int32Array | Iterable<GLsizei>, instanceCountsOffset: number, drawcount: GLsizei): void;
367
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawElementsWEBGL) */
368
- multiDrawElementsWEBGL(mode: GLenum, countsList: Int32Array | Iterable<GLsizei>, countsOffset: number, type: GLenum, offsetsList: Int32Array | Iterable<GLsizei>, offsetsOffset: number, drawcount: GLsizei): void;
441
+ /**
442
+ * The **`WEBGL_multi_draw.multiDrawArraysInstancedWEBGL()`** method of the WebGL API renders multiple primitives from array data.
443
+ *
444
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawArraysInstancedWEBGL)
445
+ */
446
+ multiDrawArraysInstancedWEBGL(mode: GLenum, firstsList: Int32Array<ArrayBufferLike> | Iterable<GLint>, firstsOffset: number, countsList: Int32Array<ArrayBufferLike> | Iterable<GLsizei>, countsOffset: number, instanceCountsList: Int32Array<ArrayBufferLike> | Iterable<GLsizei>, instanceCountsOffset: number, drawcount: GLsizei): void;
447
+ /**
448
+ * The **`WEBGL_multi_draw.multiDrawArraysWEBGL()`** method of the WebGL API renders multiple primitives from array data.
449
+ *
450
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawArraysWEBGL)
451
+ */
452
+ multiDrawArraysWEBGL(mode: GLenum, firstsList: Int32Array<ArrayBufferLike> | Iterable<GLint>, firstsOffset: number, countsList: Int32Array<ArrayBufferLike> | Iterable<GLsizei>, countsOffset: number, drawcount: GLsizei): void;
453
+ /**
454
+ * The **`WEBGL_multi_draw.multiDrawElementsInstancedWEBGL()`** method of the WebGL API renders multiple primitives from array data.
455
+ *
456
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawElementsInstancedWEBGL)
457
+ */
458
+ multiDrawElementsInstancedWEBGL(mode: GLenum, countsList: Int32Array<ArrayBufferLike> | Iterable<GLsizei>, countsOffset: number, type: GLenum, offsetsList: Int32Array<ArrayBufferLike> | Iterable<GLsizei>, offsetsOffset: number, instanceCountsList: Int32Array<ArrayBufferLike> | Iterable<GLsizei>, instanceCountsOffset: number, drawcount: GLsizei): void;
459
+ /**
460
+ * The **`WEBGL_multi_draw.multiDrawElementsWEBGL()`** method of the WebGL API renders multiple primitives from array data.
461
+ *
462
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawElementsWEBGL)
463
+ */
464
+ multiDrawElementsWEBGL(mode: GLenum, countsList: Int32Array<ArrayBufferLike> | Iterable<GLsizei>, countsOffset: number, type: GLenum, offsetsList: Int32Array<ArrayBufferLike> | Iterable<GLsizei>, offsetsOffset: number, drawcount: GLsizei): void;
369
465
  }
370
466
 
371
467
  interface WebGL2RenderingContextBase {
@@ -380,7 +476,7 @@ interface WebGL2RenderingContextBase {
380
476
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/getActiveUniforms) */
381
477
  getActiveUniforms(program: WebGLProgram, uniformIndices: Iterable<GLuint>, pname: GLenum): any;
382
478
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/getUniformIndices) */
383
- getUniformIndices(program: WebGLProgram, uniformNames: Iterable<string>): Iterable<GLuint> | null;
479
+ getUniformIndices(program: WebGLProgram, uniformNames: Iterable<string>): GLuint[] | null;
384
480
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/invalidateFramebuffer) */
385
481
  invalidateFramebuffer(target: GLenum, attachments: Iterable<GLenum>): void;
386
482
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/invalidateSubFramebuffer) */
@@ -430,7 +526,7 @@ interface WebGL2RenderingContextOverloads {
430
526
  uniform4fv(location: WebGLUniformLocation | null, data: Iterable<GLfloat>, srcOffset?: number, srcLength?: GLuint): void;
431
527
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniform) */
432
528
  uniform4iv(location: WebGLUniformLocation | null, data: Iterable<GLint>, srcOffset?: number, srcLength?: GLuint): void;
433
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniformMatrix) */
529
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext/uniformMatrix) */
434
530
  uniformMatrix2fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: number, srcLength?: GLuint): void;
435
531
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext/uniformMatrix) */
436
532
  uniformMatrix3fv(location: WebGLUniformLocation | null, transpose: GLboolean, data: Iterable<GLfloat>, srcOffset?: number, srcLength?: GLuint): void;
@@ -560,38 +560,38 @@ interface StringConstructor {
560
560
  raw(template: { raw: readonly string[] | ArrayLike<string>; }, ...substitutions: any[]): string;
561
561
  }
562
562
 
563
- interface Int8Array {
563
+ interface Int8Array<TArrayBuffer extends ArrayBufferLike> {
564
564
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
565
565
  }
566
566
 
567
- interface Uint8Array {
567
+ interface Uint8Array<TArrayBuffer extends ArrayBufferLike> {
568
568
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
569
569
  }
570
570
 
571
- interface Uint8ClampedArray {
571
+ interface Uint8ClampedArray<TArrayBuffer extends ArrayBufferLike> {
572
572
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
573
573
  }
574
574
 
575
- interface Int16Array {
575
+ interface Int16Array<TArrayBuffer extends ArrayBufferLike> {
576
576
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
577
577
  }
578
578
 
579
- interface Uint16Array {
579
+ interface Uint16Array<TArrayBuffer extends ArrayBufferLike> {
580
580
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
581
581
  }
582
582
 
583
- interface Int32Array {
583
+ interface Int32Array<TArrayBuffer extends ArrayBufferLike> {
584
584
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
585
585
  }
586
586
 
587
- interface Uint32Array {
587
+ interface Uint32Array<TArrayBuffer extends ArrayBufferLike> {
588
588
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
589
589
  }
590
590
 
591
- interface Float32Array {
591
+ interface Float32Array<TArrayBuffer extends ArrayBufferLike> {
592
592
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
593
593
  }
594
594
 
595
- interface Float64Array {
595
+ interface Float64Array<TArrayBuffer extends ArrayBufferLike> {
596
596
  toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions): string;
597
597
  }
@@ -18,9 +18,9 @@ and limitations under the License.
18
18
 
19
19
  /// <reference lib="es2015.iterable" />
20
20
 
21
- interface Generator<T = unknown, TReturn = any, TNext = unknown> extends Iterator<T, TReturn, TNext> {
21
+ interface Generator<T = unknown, TReturn = any, TNext = any> extends IteratorObject<T, TReturn, TNext> {
22
22
  // NOTE: 'next' is defined using a tuple to ensure we report the correct assignability errors in all places.
23
- next(...args: [] | [TNext]): IteratorResult<T, TReturn>;
23
+ next(...[value]: [] | [TNext]): IteratorResult<T, TReturn>;
24
24
  return(value: TReturn): IteratorResult<T, TReturn>;
25
25
  throw(e: any): IteratorResult<T, TReturn>;
26
26
  [Symbol.iterator](): Generator<T, TReturn, TNext>;