three-cad-viewer 5.0.1 → 5.0.3

package/dist/utils/decode-instances.d.ts

@@ -11,7 +11,7 @@
  * instances via `"shape": { "ref": N }`. After decoding, the result is a
  * standard Shapes tree with TypedArrays — identical to the existing format.
  */
-import type { Shapes } from "../core/types.js";
+import type { Shape, Shapes } from "../core/types.js";
 /** A single base64-encoded buffer entry. */
 interface EncodedBuffer {
     shape: number[];
@@ -48,13 +48,34 @@ declare function decodeInlineBuffers(shapes: Shapes): void;
  * Detected by the presence of an `instances` array and a `shapes` object.
  */
 declare function isInstancedFormat(data: unknown): data is InstancedData;
+/**
+ * Decode every instance's buffers from base64 into TypedArrays.
+ *
+ * This is the leaf half of the instanced format: it knows the encoding and
+ * nothing about the shapes tree. A host that receives its geometry as raw
+ * binary rather than base64 skips this step and builds the `Shape[]` itself.
+ */
+declare function decodeBuffers(instances: EncodedInstance[]): Shape[];
+/**
+ * Resolve `{ ref: N }` entries in the shapes tree against decoded instances,
+ * and return the tree.
+ *
+ * This is the structural half: the same geometry referenced N times - twenty
+ * identical bolts - which every host needs whatever encoding it received the
+ * buffers in. Held separate from `decodeBuffers` so that a host holding
+ * TypedArrays already does not have to reimplement the walk.
+ */
+declare function resolveInstances(shapes: Shapes, decoded: Shape[]): Shapes;
 /**
  * Decode the instanced format into a standard Shapes object.
  *
  * 1. Decode all instance buffers from base64 → TypedArrays
  * 2. Walk the shapes tree and replace { ref: N } with decoded instances
  * 3. Return the unwrapped Shapes object
+ *
+ * Kept as the composition of the two halves above, so existing callers see
+ * no change.
  */
 declare function decodeInstancedFormat(data: InstancedData): Shapes;
-export { isInstancedFormat, decodeInstancedFormat, decodeInlineBuffers };
+export { isInstancedFormat, decodeBuffers, resolveInstances, decodeInstancedFormat, decodeInlineBuffers, };
 export type { InstancedData, EncodedBuffer, EncodedInstance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "three-cad-viewer",
-  "version": "5.0.1",
+  "version": "5.0.3",
   "type": "module",
   "description": "WebGL-based CAD viewer built on Three.js with clipping planes, measurement tools, and tree navigation",
   "repository": {