@draco-rust/decoder 0.1.1 → 0.1.2

package/README.md

@@ -11,10 +11,14 @@ Each entry is a separate module. A bundler includes only the one you import.
 
 | import | decodes | gzip |
 |---|---|---|
-| `@draco-rust/decoder` | meshes and point clouds | ~87 KiB |
-| `@draco-rust/decoder/mesh` | meshes only, which is all glTF's `KHR_draco_mesh_compression` allows | ~72 KiB |
-| `@draco-rust/decoder/point-cloud` | point clouds only (scans, splats) | ~58 KiB |
-| `@draco-rust/decoder/legacy` | meshes and point clouds, plus bitstreams older than 2.2 | ~97 KiB |
+| `@draco-rust/decoder` | meshes and point clouds | ~92 KiB |
+| `@draco-rust/decoder/mesh` | meshes only, which is all glTF's `KHR_draco_mesh_compression` allows | ~77 KiB |
+| `@draco-rust/decoder/point-cloud` | point clouds only (scans, splats) | ~63 KiB |
+| `@draco-rust/decoder/legacy` | meshes and point clouds, plus bitstreams older than 2.2 | ~103 KiB |
+
+Each entry also has a worker pool and a three.js loader of its own, which use
+that entry's module: `@draco-rust/decoder/pool` and `@draco-rust/decoder/three`,
+or `@draco-rust/decoder/mesh/pool`, `@draco-rust/decoder/mesh/three` and so on.
 
 ## Usage
 
@@ -36,6 +40,77 @@ triangle corners, which is empty for a point cloud. `normals` and `uvs` are
 such attribute. Attributes the stream carries beyond those are in
 `meshes[0].extras`, and `result.warnings` says what was not interpreted.
 
+### Attributes the way a loader asks for them
+
+`decode_draco` returns every attribute as a typed array, or the ones a loader
+asks for, converted to the array type it needs. Upstream Draco's decoder makes
+the same conversions, and this one matches it byte for byte, refusing where it
+refuses.
+
+```js
+import init, { decode_draco } from "@draco-rust/decoder/mesh";
+
+await init();
+// By unique id, as glTF's KHR_draco_mesh_compression names them, or by type.
+const result = decode_draco(bytes, [
+  { name: "position", id: 0, type: "Float32Array" },
+  { name: "color", semantic: "COLOR", type: "Uint16Array" },
+]);
+if (!result.success) throw new Error(result.error);
+const { index, attributes } = result; // attributes[i]: { name, array, itemSize, normalized, ... }
+```
+
+Without the second argument every attribute comes back in its own type.
+
+### On workers
+
+Decoding runs on the calling thread. `createDecoderPool` runs it on workers
+instead, so a page stays responsive while several streams decode at once:
+
+```js
+import { createDecoderPool } from "@draco-rust/decoder/mesh/pool";
+
+const pool = createDecoderPool({ workers: 4 }); // default: cores - 1, at most 4
+const result = await pool.decode(bytes, requests); // what decode_draco returns
+pool.dispose();
+```
+
+The workers start as work arrives, and the wasm is compiled once for all of
+them. The stream is copied to the worker; `pool.decode(bytes, requests, {
+transfer: true })` hands over the buffer itself instead. The pool runs on Web
+Workers, on Node's worker threads (Node 20.16 and later), and from a CDN. With
+`workers: 0`, or where there are no workers, it decodes on the calling thread.
+A bundler that follows `new URL("./worker.js", import.meta.url)`, as Vite and
+webpack do, emits the worker on its own.
+
+### With three.js
+
+`createDracoLoader` stands in for three.js's `DRACOLoader`, on the pool. It
+takes three's classes rather than importing three, so it builds with your own
+copy:
+
+```js
+import * as THREE from "three";
+import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
+import { createDracoLoader } from "@draco-rust/decoder/mesh/three";
+
+const gltfLoader = new GLTFLoader();
+gltfLoader.setDRACOLoader(createDracoLoader(THREE));
+const gltf = await gltfLoader.loadAsync("model.glb");
+```
+
+For a `.drc` file, `await loader.parseAsync(arrayBuffer)` returns a
+`BufferGeometry`, and `parse(buffer, onLoad, onError)` works as DRACOLoader's
+does. Vertex colours from a `.drc` file are converted from sRGB, as
+DRACOLoader converts them, and an attribute whose items are not a multiple of
+four bytes is padded and interleaved, as DRACOLoader pads it since r181. The
+geometry is the one DRACOLoader builds, byte for byte, with one difference: an
+attribute that does not convert to the type asked for -- a negative value
+into a `Uint16Array`, say -- is an error here, where DRACOLoader fills the
+attribute with whatever its failed conversion left in memory. `setWorkerLimit`,
+`preload` and `dispose` are there too. In TypeScript, `setDRACOLoader` expects the `DRACOLoader` class, so cast
+the loader: `createDracoLoader(THREE) as unknown as DRACOLoader`.
+
 ### From a CDN, without a bundler
 
 ```js
@@ -61,9 +136,9 @@ For a subpath entry, resolve its own file, for example
 
 - Runs in every browser with WebAssembly, in Node 20.6 and later, in Deno and
   in Bun.
-- Decoding happens on the calling thread. Call it from a Web Worker to keep a
-  page responsive.
+- `parse_drc_bytes` and `decode_draco` decode on the calling thread; the pool
+  decodes on workers.
 - Licensed under Apache-2.0, like Draco.
 ## This build
 
-`@draco-rust/decoder@0.1.1` was built from draco-rust commit `f33cf80a`, with draco-core 2.3.0, draco-io 0.5.2, draco-gltf 0.6.0.
+`@draco-rust/decoder@0.1.2` was built from draco-rust commit `6bc95d5c`, with draco-core 2.3.2, draco-io 0.6.0, draco-gltf 0.7.0.

package/index.d.ts

@@ -1,6 +1,76 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/** The name of a typed array `decode_draco` can convert an attribute to. */
+export type DracoArrayType =
+| "Int8Array" | "Uint8Array" | "Int16Array" | "Uint16Array"
+| "Int32Array" | "Uint32Array" | "Float32Array";
+
+/** A Draco attribute type, as `semantic` names it. */
+export type DracoSemantic = "POSITION" | "NORMAL" | "COLOR" | "TEX_COORD" | "GENERIC";
+
+/**
+ * One attribute to decode: by `id`, its unique id, or by `semantic`, the first
+ * attribute of that type. `name` is handed back unchanged.
+ */
+export interface DracoAttributeRequest {
+    name?: string;
+    id?: number;
+    semantic?: DracoSemantic;
+    type?: DracoArrayType;
+}
+
+/** The typed arrays an attribute can come back in. */
+export type DracoArray =
+| Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array
+| Float32Array | Float64Array | BigInt64Array | BigUint64Array;
+
+export interface DracoAttribute {
+    /** The request's `name`, or else the name the stream's metadata gives it. */
+    name?: string;
+    uniqueId: number;
+    semantic: DracoSemantic;
+    array: DracoArray;
+    itemSize: number;
+    normalized: boolean;
+}
+
+export interface DracoDecodeResult {
+    success: boolean;
+    error?: string;
+    warnings: string[];
+    geometry?: "mesh" | "point_cloud";
+    /** Triangle corners for a mesh, `null` for a point cloud. */
+    index: Uint32Array | null;
+    attributes: DracoAttribute[];
+}
+
+
+
+/**
+ * Decodes a Draco stream and returns its attributes as typed arrays.
+ *
+ * `attributes` is `undefined` for every attribute in its own component type,
+ * or an array of requests `{ name, id, semantic, type }`:
+ *
+ * - `id`, a unique id, finds that attribute, as glTF's
+ *   `KHR_draco_mesh_compression` names them; a missing one is an error.
+ * - `semantic` (`"POSITION"`, `"NORMAL"`, `"COLOR"`, `"TEX_COORD"` or
+ *   `"GENERIC"`) finds the first attribute of that type instead, as a `.drc`
+ *   file is read; a missing one is left out.
+ * - `type`, a typed array's name such as `"Float32Array"` or
+ *   `"Uint16Array"`, converts the values the way upstream's
+ *   `GetAttributeDataArrayForAllPoints` does; without it the values keep
+ *   their own type. A value the type cannot hold is an error.
+ *
+ * The result is `{ success, error, warnings, geometry, index, attributes }`,
+ * where `geometry` is `"mesh"` or `"point_cloud"` as the stream's header says,
+ * `index` a `Uint32Array` of triangle corners for a mesh and `null` for a
+ * point cloud, and each attribute `{ name, uniqueId, semantic, array,
+ * itemSize, normalized }`.
+ */
+export function decode_draco(data: Uint8Array, attributes: DracoAttributeRequest[] | undefined): DracoDecodeResult;
+
 /**
  * Install the panic hook, so a panic reads as a message rather than a trap.
  */
@@ -25,14 +95,16 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly decode_draco: (a: number, b: number, c: number) => number;
     readonly init: () => void;
     readonly parse_drc_bytes: (a: number, b: number) => number;
     readonly supported_extensions: (a: number) => void;
     readonly version: (a: number) => void;
-    readonly __wbindgen_export: (a: number) => void;
-    readonly __wbindgen_export2: (a: number, b: number) => number;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
     readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
-    readonly __wbindgen_export3: (a: number, b: number, c: number) => void;
+    readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
     readonly __wbindgen_start: () => void;
 }
 

package/index.js

@@ -1,5 +1,37 @@
 /* @ts-self-types="./index.d.ts" */
 
+/**
+ * Decodes a Draco stream and returns its attributes as typed arrays.
+ *
+ * `attributes` is `undefined` for every attribute in its own component type,
+ * or an array of requests `{ name, id, semantic, type }`:
+ *
+ * - `id`, a unique id, finds that attribute, as glTF's
+ *   `KHR_draco_mesh_compression` names them; a missing one is an error.
+ * - `semantic` (`"POSITION"`, `"NORMAL"`, `"COLOR"`, `"TEX_COORD"` or
+ *   `"GENERIC"`) finds the first attribute of that type instead, as a `.drc`
+ *   file is read; a missing one is left out.
+ * - `type`, a typed array's name such as `"Float32Array"` or
+ *   `"Uint16Array"`, converts the values the way upstream's
+ *   `GetAttributeDataArrayForAllPoints` does; without it the values keep
+ *   their own type. A value the type cannot hold is an error.
+ *
+ * The result is `{ success, error, warnings, geometry, index, attributes }`,
+ * where `geometry` is `"mesh"` or `"point_cloud"` as the stream's header says,
+ * `index` a `Uint32Array` of triangle corners for a mesh and `null` for a
+ * point cloud, and each attribute `{ name, uniqueId, semantic, array,
+ * itemSize, normalized }`.
+ * @param {Uint8Array} data
+ * @param {DracoAttributeRequest[] | undefined} attributes
+ * @returns {DracoDecodeResult}
+ */
+export function decode_draco(data, attributes) {
+    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.decode_draco(ptr0, len0, addHeapObject(attributes));
+    return takeObject(ret);
+}
+
 /**
  * Install the panic hook, so a panic reads as a message rather than a trap.
  */
@@ -13,7 +45,7 @@ export function init() {
  * @returns {any}
  */
 export function parse_drc_bytes(data) {
-    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_export2);
+    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_export);
     const len0 = WASM_VECTOR_LEN;
     const ret = wasm.parse_drc_bytes(ptr0, len0);
     return takeObject(ret);
@@ -30,7 +62,7 @@ export function supported_extensions() {
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var v1 = getArrayJsValueFromWasm0(r0, r1);
-        wasm.__wbindgen_export3(r0, r1 * 4, 4);
+        wasm.__wbindgen_export4(r0, r1 * 4, 4);
         return v1;
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
@@ -54,15 +86,53 @@ export function version() {
         return getStringFromWasm0(r0, r1);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export3(deferred1_0, deferred1_1, 1);
+        wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
     }
 }
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg___wbindgen_is_null_e343b7d08827ba72: function(arg0) {
+            const ret = getObject(arg0) === null;
+            return ret;
+        },
+        __wbg___wbindgen_is_undefined_8865fb403f8fe9d8: function(arg0) {
+            const ret = getObject(arg0) === undefined;
+            return ret;
+        },
+        __wbg___wbindgen_number_get_2e0e7dee9f701a71: function(arg0, arg1) {
+            const obj = getObject(arg1);
+            const ret = typeof(obj) === 'number' ? obj : undefined;
+            getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+        },
+        __wbg___wbindgen_string_get_0380ccaa2f57f0d9: function(arg0, arg1) {
+            const obj = getObject(arg1);
+            const ret = typeof(obj) === 'string' ? obj : undefined;
+            var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
         __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
+        __wbg_get_31af05bd4842a84f: function() { return handleError(function (arg0, arg1) {
+            const ret = Reflect.get(getObject(arg0), getObject(arg1));
+            return addHeapObject(ret);
+        }, arguments); },
+        __wbg_get_unchecked_288889d017702237: function(arg0, arg1) {
+            const ret = getObject(arg0)[arg1 >>> 0];
+            return addHeapObject(ret);
+        },
+        __wbg_isArray_e15a2ff68ffdbef2: function(arg0) {
+            const ret = Array.isArray(getObject(arg0));
+            return ret;
+        },
+        __wbg_length_d4bdea10311bd9cf: function(arg0) {
+            const ret = getObject(arg0).length;
+            return ret;
+        },
         __wbg_new_617a8cdb8bb1130e: function() {
             const ret = new Object();
             return addHeapObject(ret);
@@ -71,14 +141,34 @@ function __wbg_get_imports() {
             const ret = new Array();
             return addHeapObject(ret);
         },
+        __wbg_new_from_slice_23f60f47cde8d664: function(arg0, arg1) {
+            const ret = new Uint16Array(getArrayU16FromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
+        __wbg_new_from_slice_2443ca2017fac0fd: function(arg0, arg1) {
+            const ret = new Int16Array(getArrayI16FromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
+        __wbg_new_from_slice_36f6b4e63daa7f59: function(arg0, arg1) {
+            const ret = new Int8Array(getArrayI8FromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
         __wbg_new_from_slice_37a3c3a194266cb8: function(arg0, arg1) {
             const ret = new Uint32Array(getArrayU32FromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
+        __wbg_new_from_slice_911f717853b222c7: function(arg0, arg1) {
+            const ret = new Int32Array(getArrayI32FromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
         __wbg_new_from_slice_9a868026ffa4208a: function(arg0, arg1) {
             const ret = new Uint8Array(getArrayU8FromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
+        __wbg_new_from_slice_aa8f37bd5e72dcc7: function(arg0, arg1) {
+            const ret = new BigInt64Array(getArrayI64FromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
         __wbg_new_from_slice_ca6ad97db1f4779a: function(arg0, arg1) {
             const ret = new Float32Array(getArrayF32FromWasm0(arg0, arg1));
             return addHeapObject(ret);
@@ -87,6 +177,10 @@ function __wbg_get_imports() {
             const ret = new Float64Array(getArrayF64FromWasm0(arg0, arg1));
             return addHeapObject(ret);
         },
+        __wbg_new_from_slice_f6cd96ab370a57b3: function(arg0, arg1) {
+            const ret = new BigUint64Array(getArrayU64FromWasm0(arg0, arg1));
+            return addHeapObject(ret);
+        },
         __wbg_push_2baf45db356cf468: function(arg0, arg1) {
             const ret = getObject(arg0).push(getObject(arg1));
             return ret;
@@ -140,6 +234,26 @@ function getArrayF64FromWasm0(ptr, len) {
     return getFloat64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
 }
 
+function getArrayI16FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getInt16ArrayMemory0().subarray(ptr / 2, ptr / 2 + len);
+}
+
+function getArrayI32FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getInt32ArrayMemory0().subarray(ptr / 4, ptr / 4 + len);
+}
+
+function getArrayI64FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getBigInt64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
+}
+
+function getArrayI8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getInt8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
 function getArrayJsValueFromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     const mem = getDataViewMemory0();
@@ -150,16 +264,42 @@ function getArrayJsValueFromWasm0(ptr, len) {
     return result;
 }
 
+function getArrayU16FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint16ArrayMemory0().subarray(ptr / 2, ptr / 2 + len);
+}
+
 function getArrayU32FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getUint32ArrayMemory0().subarray(ptr / 4, ptr / 4 + len);
 }
 
+function getArrayU64FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getBigUint64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
+}
+
 function getArrayU8FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
 }
 
+let cachedBigInt64ArrayMemory0 = null;
+function getBigInt64ArrayMemory0() {
+    if (cachedBigInt64ArrayMemory0 === null || cachedBigInt64ArrayMemory0.byteLength === 0) {
+        cachedBigInt64ArrayMemory0 = new BigInt64Array(wasm.memory.buffer);
+    }
+    return cachedBigInt64ArrayMemory0;
+}
+
+let cachedBigUint64ArrayMemory0 = null;
+function getBigUint64ArrayMemory0() {
+    if (cachedBigUint64ArrayMemory0 === null || cachedBigUint64ArrayMemory0.byteLength === 0) {
+        cachedBigUint64ArrayMemory0 = new BigUint64Array(wasm.memory.buffer);
+    }
+    return cachedBigUint64ArrayMemory0;
+}
+
 let cachedDataViewMemory0 = null;
 function getDataViewMemory0() {
     if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
@@ -184,10 +324,42 @@ function getFloat64ArrayMemory0() {
     return cachedFloat64ArrayMemory0;
 }
 
+let cachedInt16ArrayMemory0 = null;
+function getInt16ArrayMemory0() {
+    if (cachedInt16ArrayMemory0 === null || cachedInt16ArrayMemory0.byteLength === 0) {
+        cachedInt16ArrayMemory0 = new Int16Array(wasm.memory.buffer);
+    }
+    return cachedInt16ArrayMemory0;
+}
+
+let cachedInt32ArrayMemory0 = null;
+function getInt32ArrayMemory0() {
+    if (cachedInt32ArrayMemory0 === null || cachedInt32ArrayMemory0.byteLength === 0) {
+        cachedInt32ArrayMemory0 = new Int32Array(wasm.memory.buffer);
+    }
+    return cachedInt32ArrayMemory0;
+}
+
+let cachedInt8ArrayMemory0 = null;
+function getInt8ArrayMemory0() {
+    if (cachedInt8ArrayMemory0 === null || cachedInt8ArrayMemory0.byteLength === 0) {
+        cachedInt8ArrayMemory0 = new Int8Array(wasm.memory.buffer);
+    }
+    return cachedInt8ArrayMemory0;
+}
+
 function getStringFromWasm0(ptr, len) {
     return decodeText(ptr >>> 0, len);
 }
 
+let cachedUint16ArrayMemory0 = null;
+function getUint16ArrayMemory0() {
+    if (cachedUint16ArrayMemory0 === null || cachedUint16ArrayMemory0.byteLength === 0) {
+        cachedUint16ArrayMemory0 = new Uint16Array(wasm.memory.buffer);
+    }
+    return cachedUint16ArrayMemory0;
+}
+
 let cachedUint32ArrayMemory0 = null;
 function getUint32ArrayMemory0() {
     if (cachedUint32ArrayMemory0 === null || cachedUint32ArrayMemory0.byteLength === 0) {
@@ -210,7 +382,7 @@ function handleError(f, args) {
     try {
         return f.apply(this, args);
     } catch (e) {
-        wasm.__wbindgen_export(addHeapObject(e));
+        wasm.__wbindgen_export3(addHeapObject(e));
     }
 }
 
@@ -219,6 +391,10 @@ heap.push(undefined, null, true, false);
 
 let heap_next = heap.length;
 
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
 function passArray8ToWasm0(arg, malloc) {
     const ptr = malloc(arg.length * 1, 1) >>> 0;
     getUint8ArrayMemory0().set(arg, ptr / 1);
@@ -226,6 +402,43 @@ function passArray8ToWasm0(arg, malloc) {
     return ptr;
 }
 
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
 function takeObject(idx) {
     const ret = getObject(idx);
     dropObject(idx);
@@ -246,6 +459,19 @@ function decodeText(ptr, len) {
     return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
 }
 
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
 let WASM_VECTOR_LEN = 0;
 
 let wasmModule, wasmInstance, wasm;
@@ -253,9 +479,15 @@ function __wbg_finalize_init(instance, module) {
     wasmInstance = instance;
     wasm = instance.exports;
     wasmModule = module;
+    cachedBigInt64ArrayMemory0 = null;
+    cachedBigUint64ArrayMemory0 = null;
     cachedDataViewMemory0 = null;
     cachedFloat32ArrayMemory0 = null;
     cachedFloat64ArrayMemory0 = null;
+    cachedInt16ArrayMemory0 = null;
+    cachedInt32ArrayMemory0 = null;
+    cachedInt8ArrayMemory0 = null;
+    cachedUint16ArrayMemory0 = null;
     cachedUint32ArrayMemory0 = null;
     cachedUint8ArrayMemory0 = null;
     wasm.__wbindgen_start();

package/index_bg.wasm.d.ts

@@ -1,12 +1,14 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const decode_draco: (a: number, b: number, c: number) => number;
 export const init: () => void;
 export const parse_drc_bytes: (a: number, b: number) => number;
 export const supported_extensions: (a: number) => void;
 export const version: (a: number) => void;
-export const __wbindgen_export: (a: number) => void;
-export const __wbindgen_export2: (a: number, b: number) => number;
+export const __wbindgen_export: (a: number, b: number) => number;
+export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export3: (a: number) => void;
 export const __wbindgen_add_to_stack_pointer: (a: number) => number;
-export const __wbindgen_export3: (a: number, b: number, c: number) => void;
+export const __wbindgen_export4: (a: number, b: number, c: number) => void;
 export const __wbindgen_start: () => void;

package/legacy/index.d.ts

@@ -1,6 +1,76 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/** The name of a typed array `decode_draco` can convert an attribute to. */
+export type DracoArrayType =
+| "Int8Array" | "Uint8Array" | "Int16Array" | "Uint16Array"
+| "Int32Array" | "Uint32Array" | "Float32Array";
+
+/** A Draco attribute type, as `semantic` names it. */
+export type DracoSemantic = "POSITION" | "NORMAL" | "COLOR" | "TEX_COORD" | "GENERIC";
+
+/**
+ * One attribute to decode: by `id`, its unique id, or by `semantic`, the first
+ * attribute of that type. `name` is handed back unchanged.
+ */
+export interface DracoAttributeRequest {
+    name?: string;
+    id?: number;
+    semantic?: DracoSemantic;
+    type?: DracoArrayType;
+}
+
+/** The typed arrays an attribute can come back in. */
+export type DracoArray =
+| Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array
+| Float32Array | Float64Array | BigInt64Array | BigUint64Array;
+
+export interface DracoAttribute {
+    /** The request's `name`, or else the name the stream's metadata gives it. */
+    name?: string;
+    uniqueId: number;
+    semantic: DracoSemantic;
+    array: DracoArray;
+    itemSize: number;
+    normalized: boolean;
+}
+
+export interface DracoDecodeResult {
+    success: boolean;
+    error?: string;
+    warnings: string[];
+    geometry?: "mesh" | "point_cloud";
+    /** Triangle corners for a mesh, `null` for a point cloud. */
+    index: Uint32Array | null;
+    attributes: DracoAttribute[];
+}
+
+
+
+/**
+ * Decodes a Draco stream and returns its attributes as typed arrays.
+ *
+ * `attributes` is `undefined` for every attribute in its own component type,
+ * or an array of requests `{ name, id, semantic, type }`:
+ *
+ * - `id`, a unique id, finds that attribute, as glTF's
+ *   `KHR_draco_mesh_compression` names them; a missing one is an error.
+ * - `semantic` (`"POSITION"`, `"NORMAL"`, `"COLOR"`, `"TEX_COORD"` or
+ *   `"GENERIC"`) finds the first attribute of that type instead, as a `.drc`
+ *   file is read; a missing one is left out.
+ * - `type`, a typed array's name such as `"Float32Array"` or
+ *   `"Uint16Array"`, converts the values the way upstream's
+ *   `GetAttributeDataArrayForAllPoints` does; without it the values keep
+ *   their own type. A value the type cannot hold is an error.
+ *
+ * The result is `{ success, error, warnings, geometry, index, attributes }`,
+ * where `geometry` is `"mesh"` or `"point_cloud"` as the stream's header says,
+ * `index` a `Uint32Array` of triangle corners for a mesh and `null` for a
+ * point cloud, and each attribute `{ name, uniqueId, semantic, array,
+ * itemSize, normalized }`.
+ */
+export function decode_draco(data: Uint8Array, attributes: DracoAttributeRequest[] | undefined): DracoDecodeResult;
+
 /**
  * Install the panic hook, so a panic reads as a message rather than a trap.
  */
@@ -25,14 +95,16 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly decode_draco: (a: number, b: number, c: number) => number;
     readonly init: () => void;
     readonly parse_drc_bytes: (a: number, b: number) => number;
     readonly supported_extensions: (a: number) => void;
     readonly version: (a: number) => void;
-    readonly __wbindgen_export: (a: number) => void;
-    readonly __wbindgen_export2: (a: number, b: number) => number;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
     readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
-    readonly __wbindgen_export3: (a: number, b: number, c: number) => void;
+    readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
     readonly __wbindgen_start: () => void;
 }