Fix and generalize loader definitions (#906)

Author: MaxGraey

lib/loader/index.d.ts

@@ -7,24 +7,11 @@ interface ImportsObject extends Record<string, any> {
   env?: {
     memory?: WebAssembly.Memory,
     table?: WebAssembly.Table,
-    abort?: (msg: number, file: number, line: number, column: number) => void,
-    trace?: (msg: number, numArgs?: number, ...args: any[]) => void
-  }
+    abort?(msg: number, file: number, line: number, column: number): void,
+    trace?(msg: number, numArgs?: number, ...args: number[]): void
+  };
 }
 
-type TypedArray
-  = Int8Array
-  | Uint8Array
-  | Uint8ClampedArray
-  | Int16Array
-  | Uint16Array
-  | Int32Array
-  | Uint32Array
-  | Float32Array
-  | Float64Array
-  | BigInt64Array
-  | BigUint64Array;
-
 /** Utility mixed in by the loader. */
 interface ASUtil {
   /** Explicit start function, if requested. */
@@ -34,32 +21,32 @@ interface ASUtil {
   /** Reads (copies) the value of a string from the module's memory. */
   __getString(ptr: number): string;
   /** Allocates a new array in the module's memory and returns a reference (pointer) to it. */
-  __allocArray(id: number, values: number[]): number;
+  __allocArray(id: number, values: ArrayLike<number>): number;
   /** Reads (copies) the values of an array from the module's memory. */
   __getArray(ptr: number): number[];
   /** Gets a view on the values of an array in the module's memory. */
-  __getArrayView(ptr: number): TypedArray;
-  /** Reads (copies) the values of Int8Array from the module's memory. */
+  __getArrayView(ptr: number): ArrayBufferView;
+  /** Reads the values of Int8Array from the module's memory. */
   __getInt8Array(ptr: number): Int8Array;
-  /** Reads (copies) the values of Uint8Array from the module's memory. */
+  /** Reads the values of Uint8Array from the module's memory. */
   __getUint8Array(ptr: number): Uint8Array;
-  /** Reads (copies) the values of Uint8Array from the module's memory. */
+  /** Reads the values of Uint8Array from the module's memory. */
   __getUint8ClampedArray(ptr: number): Uint8ClampedArray;
-  /** Reads (copies) the values of Int16Array from the module's memory. */
+  /** Reads the values of Int16Array from the module's memory. */
   __getInt16Array(ptr: number): Int16Array;
-  /** Reads (copies) the values of Uint16Array from the module's memory. */
+  /** Reads the values of Uint16Array from the module's memory. */
   __getUint16Array(ptr: number): Uint16Array;
-  /** Reads (copies) the values of Int32Array from the module's memory. */
+  /** Reads the values of Int32Array from the module's memory. */
   __getInt32Array(ptr: number): Int32Array;
-  /** Reads (copies) the values of Uint32Array from the module's memory. */
+  /** Reads the values of Uint32Array from the module's memory. */
   __getUint32Array(ptr: number): Uint32Array;
-  /** Reads (copies) the values of Int32Array from the module's memory. */
-  __getInt64Array(ptr: number): BigInt32Array;
-  /** Reads (copies) the values of Uint32Array from the module's memory. */
-  __getUint64Array(ptr: number): BigUint32Array;
-  /** Reads (copies) the values of Float32Array from the module's memory. */
+  /** Reads the values of Int32Array from the module's memory. */
+  __getInt64Array(ptr: number): BigInt64Array;
+  /** Reads the values of Uint32Array from the module's memory. */
+  __getUint64Array(ptr: number): BigUint64Array;
+  /** Reads the values of Float32Array from the module's memory. */
   __getFloat32Array(ptr: number): Float32Array;
-    /** Reads (copies) the values of Float64Array from the module's memory. */
+    /** Reads the values of Float64Array from the module's memory. */
   __getFloat64Array(ptr: number): Float64Array;
   /** Reads (copies) the data of an ArrayBuffer from the module's memory. */
   __getArrayBuffer(ptr: number): ArrayBuffer;
@@ -79,10 +66,10 @@ interface ASUtil {
 export declare function instantiate<T extends {}>(module: WebAssembly.Module, imports?: ImportsObject): ASUtil & T;
 
 /** Instantiates an AssemblyScript module from a buffer using the specified imports. */
-export declare function instantiateBuffer<T extends {}>(buffer: Uint8Array, imports?: ImportsObject): ASUtil & T;
+export declare function instantiateBuffer<T extends {}>(buffer: BufferSource, imports?: ImportsObject): ASUtil & T;
 
 /** Instantiates an AssemblyScript module from a response using the specified imports. */
-export declare function instantiateStreaming<T extends {}>(result: Promise<Response>, imports?: ImportsObject): Promise<ASUtil & T>;
+export declare function instantiateStreaming<T extends {}>(result: Response | PromiseLike<Response>, imports?: ImportsObject): Promise<ASUtil & T>;
 
 /** Demangles an AssemblyScript module's exports to a friendly object structure. */
 export declare function demangle<T extends {}>(exports: {}, baseModule?: {}): T;