@stencil/core 4.38.3-dev.1762750959.bede52f → 4.38.3-dev.1762795767.192e568

package/compiler/lib.es2015.iterable.d.ts

@@ -38,59 +38,39 @@ interface IteratorReturnResult<TReturn> {
 
 type IteratorResult<T, TReturn = any> = IteratorYieldResult<T> | IteratorReturnResult<TReturn>;
 
-interface Iterator<T, TReturn = any, TNext = any> {
+interface Iterator<T, TReturn = any, TNext = undefined> {
     // NOTE: 'next' is defined using a tuple to ensure we report the correct assignability errors in all places.
-    next(...[value]: [] | [TNext]): IteratorResult<T, TReturn>;
+    next(...args: [] | [TNext]): IteratorResult<T, TReturn>;
     return?(value?: TReturn): IteratorResult<T, TReturn>;
     throw?(e?: any): IteratorResult<T, TReturn>;
 }
 
-interface Iterable<T, TReturn = any, TNext = any> {
-    [Symbol.iterator](): Iterator<T, TReturn, TNext>;
+interface Iterable<T> {
+    [Symbol.iterator](): Iterator<T>;
 }
 
-/**
- * Describes a user-defined {@link Iterator} that is also iterable.
- */
-interface IterableIterator<T, TReturn = any, TNext = any> extends Iterator<T, TReturn, TNext> {
-    [Symbol.iterator](): IterableIterator<T, TReturn, TNext>;
-}
-
-/**
- * Describes an {@link Iterator} produced by the runtime that inherits from the intrinsic `Iterator.prototype`.
- */
-interface IteratorObject<T, TReturn = unknown, TNext = unknown> extends Iterator<T, TReturn, TNext> {
-    [Symbol.iterator](): IteratorObject<T, TReturn, TNext>;
-}
-
-/**
- * Defines the `TReturn` type used for built-in iterators produced by `Array`, `Map`, `Set`, and others.
- * This is `undefined` when `strictBuiltInIteratorReturn` is `true`; otherwise, this is `any`.
- */
-type BuiltinIteratorReturn = intrinsic;
-
-interface ArrayIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
-    [Symbol.iterator](): ArrayIterator<T>;
+interface IterableIterator<T> extends Iterator<T> {
+    [Symbol.iterator](): IterableIterator<T>;
 }
 
 interface Array<T> {
     /** Iterator */
-    [Symbol.iterator](): ArrayIterator<T>;
+    [Symbol.iterator](): IterableIterator<T>;
 
     /**
      * Returns an iterable of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, T]>;
+    entries(): IterableIterator<[number, T]>;
 
     /**
      * Returns an iterable of keys in the array
      */
-    keys(): ArrayIterator<number>;
+    keys(): IterableIterator<number>;
 
     /**
      * Returns an iterable of values in the array
      */
-    values(): ArrayIterator<T>;
+    values(): IterableIterator<T>;
 }
 
 interface ArrayConstructor {
@@ -111,71 +91,67 @@ interface ArrayConstructor {
 
 interface ReadonlyArray<T> {
     /** Iterator of values in the array. */
-    [Symbol.iterator](): ArrayIterator<T>;
+    [Symbol.iterator](): IterableIterator<T>;
 
     /**
      * Returns an iterable of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, T]>;
+    entries(): IterableIterator<[number, T]>;
 
     /**
      * Returns an iterable of keys in the array
      */
-    keys(): ArrayIterator<number>;
+    keys(): IterableIterator<number>;
 
     /**
      * Returns an iterable of values in the array
      */
-    values(): ArrayIterator<T>;
+    values(): IterableIterator<T>;
 }
 
 interface IArguments {
     /** Iterator */
-    [Symbol.iterator](): ArrayIterator<any>;
-}
-
-interface MapIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
-    [Symbol.iterator](): MapIterator<T>;
+    [Symbol.iterator](): IterableIterator<any>;
 }
 
 interface Map<K, V> {
     /** Returns an iterable of entries in the map. */
-    [Symbol.iterator](): MapIterator<[K, V]>;
+    [Symbol.iterator](): IterableIterator<[K, V]>;
 
     /**
      * Returns an iterable of key, value pairs for every entry in the map.
      */
-    entries(): MapIterator<[K, V]>;
+    entries(): IterableIterator<[K, V]>;
 
     /**
      * Returns an iterable of keys in the map
      */
-    keys(): MapIterator<K>;
+    keys(): IterableIterator<K>;
 
     /**
      * Returns an iterable of values in the map
      */
-    values(): MapIterator<V>;
+    values(): IterableIterator<V>;
 }
 
 interface ReadonlyMap<K, V> {
     /** Returns an iterable of entries in the map. */
-    [Symbol.iterator](): MapIterator<[K, V]>;
+    [Symbol.iterator](): IterableIterator<[K, V]>;
 
     /**
      * Returns an iterable of key, value pairs for every entry in the map.
      */
-    entries(): MapIterator<[K, V]>;
+    entries(): IterableIterator<[K, V]>;
 
     /**
      * Returns an iterable of keys in the map
      */
-    keys(): MapIterator<K>;
+    keys(): IterableIterator<K>;
 
     /**
      * Returns an iterable of values in the map
      */
-    values(): MapIterator<V>;
+    values(): IterableIterator<V>;
 }
 
 interface MapConstructor {
@@ -189,48 +165,42 @@ interface WeakMapConstructor {
     new <K extends WeakKey, V>(iterable: Iterable<readonly [K, V]>): WeakMap<K, V>;
 }
 
-interface SetIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
-    [Symbol.iterator](): SetIterator<T>;
-}
-
 interface Set<T> {
     /** Iterates over values in the set. */
-    [Symbol.iterator](): SetIterator<T>;
-
+    [Symbol.iterator](): IterableIterator<T>;
     /**
      * Returns an iterable of [v,v] pairs for every value `v` in the set.
      */
-    entries(): SetIterator<[T, T]>;
-
+    entries(): IterableIterator<[T, T]>;
     /**
      * Despite its name, returns an iterable of the values in the set.
      */
-    keys(): SetIterator<T>;
+    keys(): IterableIterator<T>;
 
     /**
      * Returns an iterable of values in the set.
      */
-    values(): SetIterator<T>;
+    values(): IterableIterator<T>;
 }
 
 interface ReadonlySet<T> {
     /** Iterates over values in the set. */
-    [Symbol.iterator](): SetIterator<T>;
+    [Symbol.iterator](): IterableIterator<T>;
 
     /**
      * Returns an iterable of [v,v] pairs for every value `v` in the set.
      */
-    entries(): SetIterator<[T, T]>;
+    entries(): IterableIterator<[T, T]>;
 
     /**
      * Despite its name, returns an iterable of the values in the set.
      */
-    keys(): SetIterator<T>;
+    keys(): IterableIterator<T>;
 
     /**
      * Returns an iterable of values in the set.
      */
-    values(): SetIterator<T>;
+    values(): IterableIterator<T>;
 }
 
 interface SetConstructor {
@@ -263,343 +233,263 @@ interface PromiseConstructor {
     race<T>(values: Iterable<T | PromiseLike<T>>): Promise<Awaited<T>>;
 }
 
-interface StringIterator<T> extends IteratorObject<T, BuiltinIteratorReturn, unknown> {
-    [Symbol.iterator](): StringIterator<T>;
-}
-
 interface String {
     /** Iterator */
-    [Symbol.iterator](): StringIterator<string>;
+    [Symbol.iterator](): IterableIterator<string>;
 }
 
-interface Int8Array<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
-
+interface Int8Array {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
-
+    entries(): IterableIterator<[number, number]>;
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
-
+    keys(): IterableIterator<number>;
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Int8ArrayConstructor {
-    new (elements: Iterable<number>): Int8Array<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Int8Array<ArrayBuffer>;
+    new (elements: Iterable<number>): Int8Array;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Int8Array<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Int8Array;
 }
 
-interface Uint8Array<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
-
+interface Uint8Array {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
-
+    entries(): IterableIterator<[number, number]>;
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
-
+    keys(): IterableIterator<number>;
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Uint8ArrayConstructor {
-    new (elements: Iterable<number>): Uint8Array<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Uint8Array<ArrayBuffer>;
+    new (elements: Iterable<number>): Uint8Array;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Uint8Array<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Uint8Array;
 }
 
-interface Uint8ClampedArray<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
-
+interface Uint8ClampedArray {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
+    entries(): IterableIterator<[number, number]>;
 
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
+    keys(): IterableIterator<number>;
 
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Uint8ClampedArrayConstructor {
-    new (elements: Iterable<number>): Uint8ClampedArray<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Uint8ClampedArray<ArrayBuffer>;
+    new (elements: Iterable<number>): Uint8ClampedArray;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Uint8ClampedArray<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Uint8ClampedArray;
 }
 
-interface Int16Array<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
+interface Int16Array {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
+    entries(): IterableIterator<[number, number]>;
 
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
+    keys(): IterableIterator<number>;
 
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Int16ArrayConstructor {
-    new (elements: Iterable<number>): Int16Array<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Int16Array<ArrayBuffer>;
+    new (elements: Iterable<number>): Int16Array;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Int16Array<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Int16Array;
 }
 
-interface Uint16Array<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
-
+interface Uint16Array {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
-
+    entries(): IterableIterator<[number, number]>;
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
-
+    keys(): IterableIterator<number>;
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Uint16ArrayConstructor {
-    new (elements: Iterable<number>): Uint16Array<ArrayBuffer>;
+    new (elements: Iterable<number>): Uint16Array;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Uint16Array<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Uint16Array<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Uint16Array;
 }
 
-interface Int32Array<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
-
+interface Int32Array {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
-
+    entries(): IterableIterator<[number, number]>;
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
-
+    keys(): IterableIterator<number>;
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Int32ArrayConstructor {
-    new (elements: Iterable<number>): Int32Array<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Int32Array<ArrayBuffer>;
+    new (elements: Iterable<number>): Int32Array;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Int32Array<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Int32Array;
 }
 
-interface Uint32Array<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
-
+interface Uint32Array {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
-
+    entries(): IterableIterator<[number, number]>;
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
-
+    keys(): IterableIterator<number>;
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Uint32ArrayConstructor {
-    new (elements: Iterable<number>): Uint32Array<ArrayBuffer>;
+    new (elements: Iterable<number>): Uint32Array;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Uint32Array<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Uint32Array<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Uint32Array;
 }
 
-interface Float32Array<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
-
+interface Float32Array {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
-
+    entries(): IterableIterator<[number, number]>;
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
-
+    keys(): IterableIterator<number>;
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Float32ArrayConstructor {
-    new (elements: Iterable<number>): Float32Array<ArrayBuffer>;
+    new (elements: Iterable<number>): Float32Array;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Float32Array<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Float32Array<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Float32Array;
 }
 
-interface Float64Array<TArrayBuffer extends ArrayBufferLike> {
-    [Symbol.iterator](): ArrayIterator<number>;
-
+interface Float64Array {
+    [Symbol.iterator](): IterableIterator<number>;
     /**
      * Returns an array of key, value pairs for every entry in the array
      */
-    entries(): ArrayIterator<[number, number]>;
-
+    entries(): IterableIterator<[number, number]>;
     /**
      * Returns an list of keys in the array
      */
-    keys(): ArrayIterator<number>;
-
+    keys(): IterableIterator<number>;
     /**
      * Returns an list of values in the array
      */
-    values(): ArrayIterator<number>;
+    values(): IterableIterator<number>;
 }
 
 interface Float64ArrayConstructor {
-    new (elements: Iterable<number>): Float64Array<ArrayBuffer>;
-
-    /**
-     * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
-     */
-    from(elements: Iterable<number>): Float64Array<ArrayBuffer>;
+    new (elements: Iterable<number>): Float64Array;
 
     /**
      * Creates an array from an array-like or iterable object.
-     * @param elements An iterable object to convert to an array.
+     * @param arrayLike An array-like or iterable object to convert to an array.
      * @param mapfn A mapping function to call on every element of the array.
      * @param thisArg Value of 'this' used to invoke the mapfn.
      */
-    from<T>(elements: Iterable<T>, mapfn?: (v: T, k: number) => number, thisArg?: any): Float64Array<ArrayBuffer>;
+    from(arrayLike: Iterable<number>, mapfn?: (v: number, k: number) => number, thisArg?: any): Float64Array;
 }