Update typings and README [ci skip]

dcodeIO · dcodeIO · commit 1020b28cb98e · 2018-09-24T01:34:18.000+02:00
diff --git a/API.md b/API.md
@@ -32,6 +32,7 @@ The API is documented in the rest of this document.
   - [Atomic memory accesses 🦄](#atomic-memory-accesses-)
   - [Atomic read-modify-write operations 🦄](#atomic-read-modify-write-operations-)
   - [Atomic wait and wake operations 🦄](#atomic-wait-and-wake-operations-)
+  - [Sign extension operations 🦄](#sign-extension-operations-)
 - [Expression manipulation](#expression-manipulation)
 - [Relooper](#relooper)
 - [Source maps](#source-maps)
@@ -83,6 +84,9 @@ The API is documented in the rest of this document.
 * Module#**getFunctionTypeBySignature**(resultType: `Type`, paramTypes: `Type[]`): `Signature`<br />
   Gets an existing function type by its parametric signature. Returns `0` if there is no such function type.
 
+* Module#**removeFunctionType**(name: `string`): `void`<br />
+  Removes a function type.
+
 * Module#**addFunction**(name: `string`, functionType: `Signature`, varTypes: `Type[]`, body: `Expression`): `Function`<br />
   Adds a function. `varTypes` indicate additional locals, in the given order.
 
@@ -104,9 +108,6 @@ The API is documented in the rest of this document.
 * Module#**addGlobalImport**(internalName: `string`, externalModuleName: `string`, externalBaseName: `string`, globalType: `Type`): `Import`<br />
   Adds a global variable import. Imported globals must be immutable.
 
-* Module#**removeImport**(internalName: `string`): `void`<br />
-  Removes an import, by internal name.
-
 * Module#**addFunctionExport**(internalName: `string`, externalName: `string`): `Export`<br />
   Adds a function export.
 
@@ -119,10 +120,13 @@ The API is documented in the rest of this document.
 * Module#**addGlobalExport**(internalName: `string`, externalName: `string`): `Export`<br />
   Adds a global variable export. Exported globals must be immutable.
 
+* Module#**addGlobal**(name: `string`, type: `Type`, mutable: `number`, value: `Expression`): `Global`<br />
+  Adds a global instance variable.
+
 * Module#**removeExport**(externalName: `string`): `void`<br />
   Removes an export, by external name.
 
-* Module#**setFunctionTable**(funcs: `Function[]`): `void`<br />
+* Module#**setFunctionTable**(initial: `number`, maximum: `number`, funcs: `string[]`): `void`<br />
   Sets the contents of the function table. There's just one table for now, using name `"0"`.
 
 * Module#**setMemory**(initial: `number`, maximum: `number`, exportName: `string | null`, segments: `MemorySegment[]`): `void`<br />
@@ -144,26 +148,29 @@ The API is documented in the rest of this document.
 * **getFunctionInfo**(ftype: `Function`: `FunctionInfo`<br />
   Obtains information about a function.
 
-  * FunctionInfo#**name**: `string | null`
+  * FunctionInfo#**name**: `string`
+  * FunctionInfo#**module**: `string | null` (if imported)
+  * FunctionInfo#**base**: `string | null` (if imported)
   * FunctionInfo#**type**: `FunctionType`
   * FunctionInfo#**params**: `Type[]`
   * FunctionInfo#**result**: `Type`
   * FunctionInfo#**vars**: `Type`
   * FunctionInfo#**body**: `Expression`
 
-* **getImportInfo**(import_: `Import`): `ImportInfo`<br />
+* **getGlobalInfo**(global: `Global`): `GlobalInfo`<br />
   Obtains information about an import, always including:
 
-  * ImportInfo#**kind**: `ExternalKind`
-  * ImportInfo#**module**: `string`
-  * ImportInfo#**base**: `string`
-  * ImportInfo#**name**: `string`
+  * GlobalInfo#**name**: `string`
+  * GlobalInfo#**module**: `string | null` (if imported)
+  * GlobalInfo#**base**: `string | null` (if imported)
+  * GlobalInfo#**type**: `Type`
 
-  Additional properties depend on the expression's `kind` and are usually equivalent to the respective parameters when creating such an import:
+* **getExportInfo**(export_: `Export`): `ExportInfo`<br />
+  Obtains information about an export.
 
-  * GlobalImportInfo#**globalType**: `Type`
-  >
-  * FunctionImportInfo#**functionType**: `FunctionType`
+  * ExportInfo#**kind**: `ExternalKind`
+  * ExportInfo#**name**: `string`
+  * ExportInfo#**value**: `string`
 
   Possible `ExternalKind` values are:
 
@@ -172,13 +179,6 @@ The API is documented in the rest of this document.
   * **ExternalMemory**: `ExternalKind`
   * **ExternalGlobal**: `ExternalKind`
 
-* **getExportInfo**(export_: `Export`): `ExportInfo`<br />
-  Obtains information about an export.
-
-  * ExportInfo#**kind**: `ExternalKind`
-  * ExportInfo#**name**: `string`
-  * ExportInfo#**value**: `string`
-
 ### Module validation
 
 * Module#**validate**(): `boolean`<br />
@@ -284,19 +284,19 @@ The API is documented in the rest of this document.
 
 #### [Variable accesses](http://webassembly.org/docs/semantics/#local-variables)
 
-* Module#**getLocal/get_local**(index: `number`, type: `Type`): `Expression`<br />
+* Module#**get_local/getLocal**(index: `number`, type: `Type`): `Expression`<br />
   Creates a get_local for the local at the specified index. Note that we must specify the type here as we may not have created the local being called yet.
 
-* Module#**setLocal/set_local**(index: `number`, value: `Expression`): `Expression`<br />
+* Module#**set_local/setLocal**(index: `number`, value: `Expression`): `Expression`<br />
   Creates a set_local for the local at the specified index.
 
-* Module#**teeLocal/tee_local**(index: `number`, value: `Expression`): `Expression`<br />
+* Module#**tee_local/teeLocal**(index: `number`, value: `Expression`): `Expression`<br />
   Creates a tee_local for the local at the specified index. A tee differs from a set in that the value remains on the stack.
 
-* Module#**getGlobal/get_global**(name: `string`, type: `Type`): `Expression`<br />
+* Module#**get_global/getGlobal**(name: `string`, type: `Type`): `Expression`<br />
   Creates a get_global for the global with the specified name. Note that we must specify the type here as we may not have created the global being called yet.
 
-* Module#**setGlobal/set_global**(name: `string`, value: `Expression`): `Expression`<br />
+* Module#**set_global/setGlobal**(name: `string`, value: `Expression`): `Expression`<br />
   Creates a set_global for the global with the specified name.
 
 #### [Integer operations](http://webassembly.org/docs/semantics/#32-bit-integer-operators)
@@ -441,10 +441,7 @@ The API is documented in the rest of this document.
 * Module#**call**(name: `string`, operands: `Expression[]`, returnType: `Type`): `Expression`<br />
   Creates a call to a function. Note that we must specify the return type here as we may not have created the function being called yet.
 
-* Module#**callImport/call_import**(name: `string`, operands: `Expression[]`, returnType: `Type`): `Expression`<br />
-  Similar to **call**, but calls an imported function.
-
-* Module#**callIndirect/call_indirect**(target: `Expression`, operands: `Expression[]`, returnType: `Type`): `Expression`<br />
+* Module#**call_indirect/callIndirect**(target: `Expression`, operands: `Expression[]`, returnType: `Type`): `Expression`<br />
   Similar to **call**, but calls indirectly, i.e., via a function pointer, so an expression replaces the name as the called value.
 
 #### [Linear memory accesses](http://webassembly.org/docs/semantics/#linear-memory-accesses)
@@ -478,9 +475,8 @@ The API is documented in the rest of this document.
 
 #### [Host operations](http://webassembly.org/docs/semantics/#resizing)
 
-* Module#**currentMemory/current_memory**(): `Expression`
-* Module#**growMemory/get_memory**(value: `number`): `Expression`
-* Module#**hasFeature/has_feature**(name: `string`): `Expression` 🦄
+* Module#**current_memory/currentMemory**(): `Expression`
+* Module#**grow_memory/growMemory**(value: `number`): `Expression`
 
 #### [Atomic memory accesses](https://github.com/WebAssembly/threads/blob/master/proposals/threads/Overview.md#atomic-memory-accesses) 🦄
 
@@ -559,6 +555,15 @@ The API is documented in the rest of this document.
 * Module#i64.**wait**(ptr: `Expression`, expected: `Expression`, timeout: `Expression`): `Expression`
 * Module#**wake**(ptr: `Expression`, wakeCount: `Expression`): `Expression`
 
+#### [Sign extension operations](https://github.com/WebAssembly/sign-extension-ops/blob/master/proposals/sign-extension-ops/Overview.md) 🦄
+
+* Module#i32.**extend8_s**(value: `Expression`): `Expression`
+* Module#i32.**extend16_s**(value: `Expression`): `Expression`
+>
+* Module#i64.**extend8_s**(value: `Expression`): `Expression`
+* Module#i64.**extend16_s**(value: `Expression`): `Expression`
+* Module#i64.**extend32_s**(value: `Expression`): `Expression`
+
 ### Expression manipulation
 
 * **getExpressionId**(expr: `Expression`): `ExpressionId`<br />
diff --git a/README.md b/README.md
@@ -175,9 +175,6 @@ API
 * Module#**addGlobalImport**(internalName: `string`, externalModuleName: `string`, externalBaseName: `string`, globalType: `Type`): `Import`<br />
   Adds a global variable import. Imported globals must be immutable.
 
-* Module#**removeImport**(internalName: `string`): `void`<br />
-  Removes an import, by internal name.
-
 * Module#**addFunctionExport**(internalName: `string`, externalName: `string`): `Export`<br />
   Adds a function export.
 
@@ -196,7 +193,7 @@ API
 * Module#**removeExport**(externalName: `string`): `void`<br />
   Removes an export, by external name.
 
-* Module#**setFunctionTable**(funcs: `Function[]`): `void`<br />
+* Module#**setFunctionTable**(initial: `number`, maximum: `number`, funcs: `string[]`): `void`<br />
   Sets the contents of the function table. There's just one table for now, using name `"0"`.
 
 * Module#**setMemory**(initial: `number`, maximum: `number`, exportName: `string | null`, segments: `MemorySegment[]`): `void`<br />
@@ -218,26 +215,29 @@ API
 * **getFunctionInfo**(ftype: `Function`: `FunctionInfo`<br />
   Obtains information about a function.
 
-  * FunctionInfo#**name**: `string | null`
+  * FunctionInfo#**name**: `string`
+  * FunctionInfo#**module**: `string | null` (if imported)
+  * FunctionInfo#**base**: `string | null` (if imported)
   * FunctionInfo#**type**: `FunctionType`
   * FunctionInfo#**params**: `Type[]`
   * FunctionInfo#**result**: `Type`
   * FunctionInfo#**vars**: `Type`
   * FunctionInfo#**body**: `Expression`
 
-* **getImportInfo**(import_: `Import`): `ImportInfo`<br />
+* **getGlobalInfo**(global: `Global`): `GlobalInfo`<br />
   Obtains information about an import, always including:
 
-  * ImportInfo#**kind**: `ExternalKind`
-  * ImportInfo#**module**: `string`
-  * ImportInfo#**base**: `string`
-  * ImportInfo#**name**: `string`
+  * GlobalInfo#**name**: `string`
+  * GlobalInfo#**module**: `string | null` (if imported)
+  * GlobalInfo#**base**: `string | null` (if imported)
+  * GlobalInfo#**type**: `Type`
 
-  Additional properties depend on the expression's `kind` and are usually equivalent to the respective parameters when creating such an import:
+* **getExportInfo**(export_: `Export`): `ExportInfo`<br />
+  Obtains information about an export.
 
-  * GlobalImportInfo#**globalType**: `Type`
-  >
-  * FunctionImportInfo#**functionType**: `FunctionType`
+  * ExportInfo#**kind**: `ExternalKind`
+  * ExportInfo#**name**: `string`
+  * ExportInfo#**value**: `string`
 
   Possible `ExternalKind` values are:
 
@@ -246,13 +246,6 @@ API
   * **ExternalMemory**: `ExternalKind`
   * **ExternalGlobal**: `ExternalKind`
 
-* **getExportInfo**(export_: `Export`): `ExportInfo`<br />
-  Obtains information about an export.
-
-  * ExportInfo#**kind**: `ExternalKind`
-  * ExportInfo#**name**: `string`
-  * ExportInfo#**value**: `string`
-
 ### Module validation
 
 * Module#**validate**(): `boolean`<br />
@@ -515,9 +508,6 @@ API
 * Module#**call**(name: `string`, operands: `Expression[]`, returnType: `Type`): `Expression`<br />
   Creates a call to a function. Note that we must specify the return type here as we may not have created the function being called yet.
 
-* Module#**call_import/callImport**(name: `string`, operands: `Expression[]`, returnType: `Type`): `Expression`<br />
-  Similar to **call**, but calls an imported function.
-
 * Module#**call_indirect/callIndirect**(target: `Expression`, operands: `Expression[]`, returnType: `Type`): `Expression`<br />
   Similar to **call**, but calls indirectly, i.e., via a function pointer, so an expression replaces the name as the called value.
 
@@ -554,7 +544,6 @@ API
 
 * Module#**current_memory/currentMemory**(): `Expression`
 * Module#**grow_memory/growMemory**(value: `number`): `Expression`
-* Module#**has_feature/hasFeature**(name: `string`): `Expression` 🦄
 
 #### [Atomic memory accesses](https://github.com/WebAssembly/threads/blob/master/proposals/threads/Overview.md#atomic-memory-accesses) 🦄
 
diff --git a/index.d.ts b/index.d.ts
@@ -15,7 +15,6 @@ declare module binaryen {
   const BreakId: ExpressionId;
   const SwitchId: ExpressionId;
   const CallId: ExpressionId;
-  const CallImportId: ExpressionId;
   const CallIndirectId: ExpressionId;
   const GetLocalid: ExpressionId;
   const SetLocalId: ExpressionId;
@@ -327,13 +326,12 @@ declare module binaryen {
     addTableImport(internalName: string, externalModuleName: string, externalBaseName: string): Import;
     addMemoryImport(internalName: string, externalModuleName: string, externalBaseName: string): Import;
     addGlobalImport(internalName: string, externalModuleName: string, externalBaseName: string, globalType: Type): Import;
-    removeImport(internalName: string): void;
     addFunctionExport(internalName: string, externalName: string): Export;
     addTableExport(internalName: string, externalName: string): Export;
     addMemoryExport(internalName: string, externalName: string): Export;
     addGlobalExport(internalName: string, externalName: string): Export;
     removeExport(externalName: string): void;
-    setFunctionTable(funcs: number[]): void;
+    setFunctionTable(initial: number, maximum: number, funcs: number[]): void;
     setMemory(initial: number, maximum: number, exportName?: string | null, segments?: MemorySegment[]): void;
     setStart(start: binaryen.Function): void;
 
@@ -367,7 +365,6 @@ declare module binaryen {
     /* alias */ br_if(label: string, condition?: Expression, value?: Expression): Statement;
     switch(labels: string[], defaultLabel: string, condition: Expression, value?: Expression): Statement;
     call(name: string, operands: Expression[], type: Type): Expression;
-    callImport(name: string, operands: Expression[], type: Type): Expression;
     /* alias */ call_import(name: string, operands: Expression[], type: Type): Expression;
     callIndirect(target: Expression, operands: Expression[], type: Type): Expression;
     /* alias */ call_indirect(target: Expression, operands: Expression[], type: Type): Expression;
@@ -389,8 +386,6 @@ declare module binaryen {
     /* alias */ grow_memory(value: Expression): Expression;
     currentMemory(): Expression;
     /* alias */ current_memory(): Expression;
-    hasFeature(name: string): Expression;
-    /* alias */ has_feature(name: string): Expression;
     unreachable(): Statement;
     wake(ptr: Expression, wakeCount: Expression): Expression;
   }
@@ -560,28 +555,22 @@ declare module binaryen {
 
   interface FunctionInfo {
     name: string;
-    ype: FunctionType;
+    module: string | null;
+    base: string | null;
+    type: FunctionType;
     params: Type[];
     result: Type;
     vars: Type[];
     body: Expression
   }
 
-  function getImportInfo(import_: Import): ImportInfo;
+  function getGlobalInfo(global: Global): GlobalInfo;
 
-  interface ImportInfo {
-    kind: ExternalKind;
-    module: string;
-    base: string;
+  interface GlobalInfo {
     name: string;
-  }
-
-  interface GlobalImportInfo extends ImportInfo {
-    globalType: Type;
-  }
-
-  interface FunctionImportInfo extends ImportInfo {
-    functionType: string;
+    module: string | null;
+    base: string | null;
+    type: Type;
   }
 
   function getExportInfo(export_: Export): ExportInfo;
