@tsonic/js-globals 0.2.2 → 0.3.0

package/index.d.ts

@@ -29,7 +29,7 @@ declare global {
     /**
      * Returns the item located at the specified index.
      */
-    [n: int]: T;
+    [n: number]: T;
 
     /**
      * Appends new elements to the end of an array, and returns the new length.
@@ -154,7 +154,7 @@ declare global {
 
   interface ReadonlyArray<T> {
     readonly length: int;
-    readonly [n: int]: T;
+    readonly [n: number]: T;
     slice(start?: int, end?: int): T[];
     indexOf(searchElement: T, fromIndex?: int): int;
     lastIndexOf(searchElement: T, fromIndex?: int): int;
@@ -570,17 +570,27 @@ declare global {
   /**
    * Iterator types
    */
-  interface Iterator<T> {
-    next(): IteratorResult<T>;
-    return?(value?: any): IteratorResult<T>;
-    throw?(e?: any): IteratorResult<T>;
+  interface Iterator<T, TReturn = any, TNext = undefined> {
+    next(...args: [] | [TNext]): IteratorResult<T, TReturn>;
+    return?(value?: TReturn): IteratorResult<T, TReturn>;
+    throw?(e?: any): IteratorResult<T, TReturn>;
   }
 
-  interface IteratorResult<T> {
+  interface IteratorResult<T, TReturn = any> {
     done: boolean;
+    value: T | TReturn;
+  }
+
+  interface IteratorYieldResult<T> {
+    done: false;
     value: T;
   }
 
+  interface IteratorReturnResult<TReturn> {
+    done: true;
+    value: TReturn;
+  }
+
   interface Iterable<T> {
     [Symbol.iterator](): Iterator<T>;
   }
@@ -589,6 +599,40 @@ declare global {
     [Symbol.iterator](): IterableIterator<T>;
   }
 
+  /**
+   * Async Iterator types (for for-await loops)
+   */
+  interface AsyncIterator<T, TReturn = any, TNext = undefined> {
+    next(...args: [] | [TNext]): Promise<IteratorResult<T, TReturn>>;
+    return?(value?: TReturn | PromiseLike<TReturn>): Promise<IteratorResult<T, TReturn>>;
+    throw?(e?: any): Promise<IteratorResult<T, TReturn>>;
+  }
+
+  interface AsyncIterable<T> {
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+  }
+
+  interface AsyncIterableIterator<T> extends AsyncIterator<T> {
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+  }
+
+  /**
+   * Generator types
+   */
+  interface Generator<T = unknown, TReturn = any, TNext = unknown> extends Iterator<T, TReturn, TNext> {
+    next(...args: [] | [TNext]): IteratorResult<T, TReturn>;
+    return(value: TReturn): IteratorResult<T, TReturn>;
+    throw(e: any): IteratorResult<T, TReturn>;
+    [Symbol.iterator](): Generator<T, TReturn, TNext>;
+  }
+
+  interface AsyncGenerator<T = unknown, TReturn = any, TNext = unknown> extends AsyncIterator<T, TReturn, TNext> {
+    next(...args: [] | [TNext]): Promise<IteratorResult<T, TReturn>>;
+    return(value: TReturn | PromiseLike<TReturn>): Promise<IteratorResult<T, TReturn>>;
+    throw(e: any): Promise<IteratorResult<T, TReturn>>;
+    [Symbol.asyncIterator](): AsyncGenerator<T, TReturn, TNext>;
+  }
+
   /**
    * Template literal type utilities
    */
@@ -601,14 +645,14 @@ declare global {
    * Additional types
    */
   interface IArguments {
-    [index: int]: any;
+    [index: number]: any;
     length: int;
     callee: Function;
   }
 
   interface ArrayLike<T> {
     readonly length: int;
-    readonly [n: int]: T;
+    readonly [n: number]: T;
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsonic/js-globals",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Global type definitions for Tsonic JS mode (noLib: true, JavaScript semantics)",
   "main": "index.d.ts",
   "types": "index.d.ts",