Add types for WebAssembly

BUILD.gn

@@ -102,6 +102,7 @@ ts_sources = [
   "js/url.ts",
   "js/url_search_params.ts",
   "js/util.ts",
+  "js/wasm.d.ts",
   "js/workers.ts",
   "js/write_file.ts",
   "js/performance.ts",

js/globals.ts

@@ -4,8 +4,11 @@
 // is evaluated in.  We use this file to automatically build the runtime type
 // library.
 
+// TODO This doesn't work.
+/// <reference path="./wasm.d.ts" />
+
 // Modules which will make up part of the global public API surface should be
-// imported as namespaces, so when the runtime tpye library is generated they
+// imported as namespaces, so when the runtime type library is generated they
 // can be expressed as a namespace in the type library.
 import * as blob from "./blob";
 import * as consoleTypes from "./console";
@@ -97,3 +100,5 @@ export type TextDecoder = textEncoding.TextDecoder;
 window.performance = new performanceUtil.Performance();
 
 window.workerMain = workers.workerMain;
+
+//window.WebAssembly = _WebAssembly;

js/wasm.d.ts

@@ -0,0 +1,125 @@
+// MIT License
+// Copied from https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/webassembly-js-api/index.d.ts
+// Type definitions for WebAssembly v1 (MVP)
+// Project: https://github.com/winksaville/test-webassembly-js-ts
+// Definitions by: 01alchemist <https://twitter.com/01alchemist>
+//                 Wink Saville <[email protected]>
+//                 Periklis Tsirakidis <https://github.com/periklis>
+//                 Sergey Rubanov <https://github.com/chicoxyzzy>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.2
+
+/**
+ * The WebAssembly namespace, see [WebAssembly](https://github.com/webassembly)
+ * and [WebAssembly JS API](http://webassembly.org/getting-started/js-api/)
+ * for more information.
+ */
+declare namespace WebAssembly {
+  type Imports = Array<{
+    name: string;
+    kind: string;
+  }>;
+
+  type Exports = Array<{
+    module: string;
+    name: string;
+    kind: string;
+  }>;
+
+  type BufferSource = ArrayBufferView | ArrayBuffer;
+
+  /**
+   * WebAssembly.Module
+   */
+  class Module {
+    constructor(bufferSource: BufferSource);
+    static customSections(module: Module, sectionName: string): ArrayBuffer[];
+    static exports(module: Module): Imports;
+    static imports(module: Module): Exports;
+  }
+
+  /**
+   * WebAssembly.Instance
+   */
+  class Instance {
+    readonly exports: any;
+    constructor(module: Module, importObject?: any);
+  }
+
+  /**
+   * WebAssembly.Memory
+   * Note: A WebAssembly page has a constant size of 65,536 bytes, i.e., 64KiB.
+   */
+  interface MemoryDescriptor {
+    initial: number;
+    maximum?: number;
+  }
+
+  class Memory {
+    readonly buffer: ArrayBuffer;
+    constructor(memoryDescriptor: MemoryDescriptor);
+    grow(numPages: number): number;
+  }
+
+  /**
+   * WebAssembly.Table
+   */
+  interface TableDescriptor {
+    element: "anyfunc";
+    initial: number;
+    maximum?: number;
+  }
+
+  class Table {
+    readonly length: number;
+    constructor(tableDescriptor: TableDescriptor);
+    get(index: number): (args: any[]) => any;
+    grow(numElements: number): number;
+    set(index: number, value: (args: any[]) => any): void;
+  }
+
+  /**
+   * Errors
+   */
+  class CompileError extends Error {
+    readonly fileName: string;
+    readonly lineNumber: string;
+    readonly columnNumber: string;
+    constructor(message?: string, fileName?: string, lineNumber?: number);
+    toString(): string;
+  }
+
+  class LinkError extends Error {
+    readonly fileName: string;
+    readonly lineNumber: string;
+    readonly columnNumber: string;
+    constructor(message?: string, fileName?: string, lineNumber?: number);
+    toString(): string;
+  }
+
+  class RuntimeError extends Error {
+    readonly fileName: string;
+    readonly lineNumber: string;
+    readonly columnNumber: string;
+    constructor(message?: string, fileName?: string, lineNumber?: number);
+    toString(): string;
+  }
+
+  function compile(bufferSource: BufferSource): Promise<Module>;
+
+  interface ResultObject {
+    module: Module;
+    instance: Instance;
+  }
+
+  function instantiate(
+    bufferSource: BufferSource,
+    importObject?: object
+  ): Promise<ResultObject>;
+  function instantiate(
+    module: Module,
+    importObject?: object
+  ): Promise<Instance>;
+
+  function validate(bufferSource: BufferSource): boolean;
+}

tests/wasm.js

@@ -0,0 +1,15 @@
+// prettier-ignore
+const wasmCode = new Uint8Array([
+  0, 97, 115, 109, 1, 0, 0, 0, 1, 133, 128, 128, 128, 0, 1, 96, 0, 1, 127,
+  3, 130, 128, 128, 128, 0, 1, 0, 4, 132, 128, 128, 128, 0, 1, 112, 0, 0,
+  5, 131, 128, 128, 128, 0, 1, 0, 1, 6, 129, 128, 128, 128, 0, 0, 7, 145,
+  128, 128, 128, 0, 2, 6, 109, 101, 109, 111, 114, 121, 2, 0, 4, 109, 97,
+  105, 110, 0, 0, 10, 138, 128, 128, 128, 0, 1, 132, 128, 128, 128, 0, 0,
+  65, 42, 11
+]);
+
+const wasmModule = new WebAssembly.Module(wasmCode);
+
+const wasmInstance = new WebAssembly.Instance(wasmModule, {});
+
+console.log(wasmInstance.exports.main().toString());

tests/wasm.js.out

@@ -0,0 +1 @@
+42

tests/wasm.js.test

@@ -0,0 +1,2 @@
+args: tests/wasm.js
+output: tests/wasm.js.out

tests/wasm.ts

@@ -0,0 +1,15 @@
+// prettier-ignore
+const wasmCode = new Uint8Array([
+  0, 97, 115, 109, 1, 0, 0, 0, 1, 133, 128, 128, 128, 0, 1, 96, 0, 1, 127,
+  3, 130, 128, 128, 128, 0, 1, 0, 4, 132, 128, 128, 128, 0, 1, 112, 0, 0,
+  5, 131, 128, 128, 128, 0, 1, 0, 1, 6, 129, 128, 128, 128, 0, 0, 7, 145,
+  128, 128, 128, 0, 2, 6, 109, 101, 109, 111, 114, 121, 2, 0, 4, 109, 97,
+  105, 110, 0, 0, 10, 138, 128, 128, 128, 0, 1, 132, 128, 128, 128, 0, 0,
+  65, 42, 11
+]);
+
+const wasmModule = new WebAssembly.Module(wasmCode);
+
+const wasmInstance = new WebAssembly.Instance(wasmModule, {});
+
+console.log(wasmInstance.exports.main().toString());

tests/wasm.ts.out

@@ -0,0 +1 @@
+42

tests/wasm.ts.test

@@ -0,0 +1,2 @@
+args: tests/wasm.ts
+output: tests/wasm.ts.out