minidraco 0.3.0 → 0.5.0

package/README.md

@@ -39,21 +39,21 @@ const mesh = decodeDracoMesh(new Uint8Array(bytes))
 
 ## Performance
 
-Median across a 19-model corpus vs [draco.js](https://github.com/mrdoob/draco.js) and the official
+Median across an 18-model corpus vs [draco.js](https://github.com/mrdoob/draco.js) and the official
 [draco3d](https://www.npmjs.com/package/draco3d) wasm decoder (full results in
 [BENCH.md](https://github.com/verekia/minidraco/blob/main/BENCH.md)):
 
-| benchmark                                     | vs draco.js     | vs draco3d wasm |
-| --------------------------------------------- | --------------- | --------------- |
-| single-threaded decode — bun (JSC)            | ⚪ even         | 🟢 1.13× faster |
-| single-threaded decode — Chrome (V8)          | ⚪ even         | 🟢 1.50× faster |
-| `GLTFLoader.parse`, worker pool — Chrome (V8) | 🟢 1.23× faster | 🔴 1.10× slower |
-
-On par with draco.js, faster than the wasm decoder single-threaded, and competitive in a real
-`GLTFLoader.parse` with the main thread left free.
-
-🟢 **Cold start is the real win, and no warm benchmark shows it:** there's no `draco_decoder.wasm`
-to fetch and compile before the first decode, so the first model on screen appears sooner.
+| benchmark                                          | vs draco.js     | vs draco3d wasm |
+| -------------------------------------------------- | --------------- | --------------- |
+| single-threaded decode — bun (JSC)                 | 🟢 1.27× faster | 🟢 1.38× faster |
+| single-threaded decode — Chrome (V8)               | 🟢 1.29× faster | 🟢 1.11× faster |
+| `GLTFLoader.parse`, warm worker pool — Chrome (V8) | 🟢 1.62× faster | ⚪ even         |
+| `GLTFLoader.parse`, cold first load — Chrome (V8)  | 🟢 1.31× faster | ⚪ even         |
+
+Faster than draco.js across the corpus, ahead of the wasm decoder single-threaded, and even with
+it in a real `GLTFLoader.parse` with the main thread left free — both warm and on the first load
+of a session, where minidraco's worker pool is still JIT-warming while the wasm decoder is
+fetching and compiling its module (no `draco_decoder.wasm` to host or download here).
 
 ## Download size
 

package/dist/index.d.ts

@@ -3,6 +3,7 @@ declare class DataBuffer {
     constructor();
     update(data: Uint8Array | ArrayBufferView | ArrayBuffer | null | undefined, size: number, offset?: number): boolean;
     resize(newSize: number): void;
+    adoptScratch(size: number): void;
     write(bytePos: number, inArray: Uint8Array | ArrayBufferView | ArrayBuffer, dataSize: number): void;
     get data(): Uint8Array;
     get dataSize(): number;
@@ -44,10 +45,15 @@ declare class GeometryAttribute {
 
 declare class AttributeTransformData {
     _transformType: number;
-    _buffer: DataBuffer;
+    _bytes: Uint8Array;
+    _view: DataView;
+    _size: number;
     constructor();
     get transformType(): number;
     set transformType(type: number);
+    get dataSize(): number;
+    get data(): Uint8Array;
+    _reserve(sizeNeeded: number): void;
     setParameterValue(byteOffset: number, value: number, type: string): void;
     appendParameterValue(value: number, type: string): void;
     _typeSize(type: string): number;
@@ -81,6 +87,7 @@ declare class PointAttribute extends GeometryAttribute {
     constructor(geometryAttribute?: GeometryAttribute);
     init(attributeType: number, numComponents: number, dataType: number, normalized: boolean, numAttributeValues: number): void;
     reset(numAttributeValues: number): boolean;
+    resetScratch(numAttributeValues: number): boolean;
     get size(): number;
     mappedIndex(pointIndex: number): number;
     get isMappingIdentity(): boolean;
@@ -89,6 +96,8 @@ declare class PointAttribute extends GeometryAttribute {
     setIdentityMapping(): void;
     setExplicitMapping(numPoints: number): void;
     setExplicitMappingUnfilled(numPoints: number): void;
+    setExplicitMappingShared(map: Uint32Array): void;
+    setExplicitMappingScratch(numPoints: number): void;
     setAttributeTransformData(transformData: AttributeTransformData): void;
     convertValue(attIndex: number, outVal: number[] | Int32Array | Uint32Array | Float32Array | Float64Array): void;
     extractTo<C extends new (length: number) => ExtractTypedArray>(OutputTypedArray: C, numPoints: number): InstanceType<C>;