three-cad-viewer 4.1.2 → 4.2.0

package/src/ui/index.html

@@ -3,14 +3,18 @@
 
     <div class="tcv_cad_body">
         <div class="tcv_cad_navigation">
+            <div class="tcv_toggle_tools_wrapper">
+                <span class='tcv_toggle_tools'></span><span class="tcv_tools_label">Tools</span>
+            </div>
             <div class="tcv_cad_tree tcv_round">
                 <div class="tcv_tabnav">
                     <span class="tcv_tooltip" style="flex: 1"><input class='tcv_tab_tree tcv_tab tcv_tab-left tcv_tab-selected' value="Tree" type="button" style="width: 100%" /></span>
                     <span class="tcv_tooltip" style="flex: 1"><input class='tcv_tab_clip tcv_tab tcv_tab-right tcv_tab-unselected' value="Clip" type="button" style="width: 100%" /></span>
-                    <span class="tcv_tooltip" style="flex: 1"><input class='tcv_tab_material tcv_tab tcv_tab-right tcv_tab-unselected' value="Material" type="button" style="width: 100%" /></span>
                     <span class="tcv_tooltip" style="flex: 1"><input class='tcv_tab_zebra tcv_tab tcv_tab-right tcv_tab-unselected' value="Zebra" type="button" style="width: 100%" /></span>
+                    <span class="tcv_tooltip" style="flex: 1"><input class='tcv_tab_material tcv_tab tcv_tab-right tcv_tab-unselected' value="Material" type="button" style="width: 100%" /></span>
+                    <span class="tcv_tooltip" style="flex: 1"><input class='tcv_tab_studio tcv_tab tcv_tab-right tcv_tab-unselected' value="Studio" type="button" style="width: 100%" /></span>
                 </div>
-                <div class="tcv_cad_tree_toggles">
+                <div class="tcv_cad_tree_toggles tcv_toggles_tree">
                     <span class="tcv_tooltip" data-tooltip="Collpase nodes with a single leaf">
                         <input class='tcv_collapse_singles tcv_btn tcv_small_btn' value="1" type="button" />
                     </span>
@@ -24,6 +28,30 @@
                         <input class='tcv_expand tcv_btn tcv_small_btn' value="E" type="button" />
                     </span>
                 </div>
+                <div class="tcv_cad_tree_toggles tcv_toggles_clip" style="display: none;">
+                    <span class="tcv_tooltip" data-tooltip="Reset to default clip planes">
+                        <input class='tcv_clip_reset tcv_btn tcv_small_btn' value="R" type="button" />
+                    </span>
+                </div>
+                <div class="tcv_cad_tree_toggles tcv_toggles_material" style="display: none;">
+                    <span class="tcv_tooltip" data-tooltip="Reset to original values">
+                        <input class='tcv_material_reset tcv_btn tcv_small_btn' value="R" type="button" />
+                    </span>
+                </div>
+                <div class="tcv_cad_tree_toggles tcv_toggles_zebra" style="display: none;">
+                    <span class="tcv_tooltip" data-tooltip="Reset to default zebra settings">
+                        <input class='tcv_zebra_reset tcv_btn tcv_small_btn' value="R" type="button" />
+                    </span>
+                </div>
+                <div class="tcv_cad_tree_toggles tcv_toggles_studio" style="display: none;">
+                    <div class="tcv_studio_spinner"></div>
+                    <span class="tcv_tooltip" data-tooltip="Edit material of selected object">
+                        <input class='tcv_mat_editor_toggle tcv_btn tcv_small_btn' value="E" type="button" />
+                    </span>
+                    <span class="tcv_tooltip" data-tooltip="Reset to default values">
+                        <input class='tcv_studio_reset tcv_btn tcv_small_btn' value="R" type="button" />
+                    </span>
+                </div>
                 <div class="tcv_box_content tcv_mac-scrollbar tcv_scroller">
                     <div class="tcv_cad_tree_container"></div>
                     <div class="tcv_cad_clip_container">
@@ -84,81 +112,62 @@
                         </div>
                     </div>
                     <div class="tcv_cad_material_container">
-                        <div class="tcv_cad_tree_toggles">
-                            <span class="tcv_tooltip" data-tooltip="Reset to original values">
-                                <input class='tcv_material_reset tcv_btn tcv_small_btn' value="R" type="button" />
-                            </span>
-                        </div>
-                        <div class="tcv_material_ambientlight tcv_label">
-                            Ambient light intensity (%)
-                        </div>
-                        <div class="tcv_slider_group">
-                            <div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label">Ambient Light</span>
+                            <div class="tcv_studio_slider_group">
                                 <input type="range" min="0" max="20" value="1"
                                     class="tcv_sld_value_ambientlight tcv_clip_slider">
                                 <input value=1 class="tcv_inp_value_ambientlight tcv_clip_input"></input>
                             </div>
                         </div>
-                        <div class="tcv_material_pointlight tcv_label">
-                            Directional light intensity (%)
-                        </div>
-                        <div class="tcv_slider_group">
-                            <div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label">Direct Light</span>
+                            <div class="tcv_studio_slider_group">
                                 <input type="range" min="0" max="40" value="1"
                                     class="tcv_sld_value_pointlight tcv_clip_slider">
                                 <input value=1 class="tcv_inp_value_pointlight tcv_clip_input"></input>
                             </div>
                         </div>
-                        <div class="tcv_material_metalness tcv_label">
-                            Metalness (%)
-                        </div>
-                        <div class="tcv_slider_group">
-                            <div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label">Metalness</span>
+                            <div class="tcv_studio_slider_group">
                                 <input type="range" min="0" max="100" value="40"
                                     class="tcv_sld_value_metalness tcv_clip_slider">
                                 <input value=40 class="tcv_inp_value_metalness tcv_clip_input"></input>
                             </div>
                         </div>
-                        <div class="tcv_material_roughness tcv_label">
-                            Roughness (%)
-                        </div>
-                        <div class="tcv_slider_group">
-                            <div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label">Roughness</span>
+                            <div class="tcv_studio_slider_group">
                                 <input type="range" min="0" max="100" value="40"
                                     class="tcv_sld_value_roughness tcv_clip_slider">
                                 <input value=40 class="tcv_inp_value_roughness tcv_clip_input"></input>
                             </div>
                         </div>
                         <div class="tcv_material_info">
-                            Note: This is not a full material renderer.
+                            Control material for CAD view, values in %
                         </div>
                     </div>
                     <div class="tcv_cad_zebra_container">
-                        <div class="tcv_zebra_stripe_count tcv_label">
-                            Stripe Count
-                        </div>
-                        <div class="tcv_slider_group">
-                            <div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label">Stripe Count</span>
+                            <div class="tcv_studio_slider_group">
                                 <input type="range" min="2" max="50" value="10"
                                     class="tcv_sld_value_zebra_count tcv_clip_slider">
                                 <input value=10 class="tcv_inp_value_zebra_count tcv_clip_input"></input>
                             </div>
-                        </div>                        
-                        <div class="tcv_zebra_stripe_opacity tcv_label">
-                            Stripe Opacity
                         </div>
-                        <div class="tcv_slider_group">
-                            <div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label">Stripe Opacity</span>
+                            <div class="tcv_studio_slider_group">
                                 <input type="range" min="0.0" max="1.0" step="0.01" value="1.0"
                                     class="tcv_sld_value_zebra_opacity tcv_clip_slider">
                                 <input value=1.0 class="tcv_inp_value_zebra_opacity tcv_clip_input"></input>
                             </div>
-                        </div>                        
-                        <div class="tcv_zebra_stripe_direction tcv_label">
-                            Stripe Direction
                         </div>
-                        <div class="tcv_slider_group">
-                            <div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label">Direction</span>
+                            <div class="tcv_studio_slider_group">
                                 <input type="range" min="0" max="90" step="0.5" value="0"
                                     class="tcv_sld_value_zebra_direction tcv_clip_slider">
                                 <input value=0 class="tcv_inp_value_zebra_direction tcv_clip_input"></input>
@@ -186,7 +195,122 @@
                                     <label for="zebra_normal" class="tcv_radio_label">Normal</label>
                                 </span>
                             </div>
-                        </div>                                             
+                        </div>
+                    </div>
+                    <div class="tcv_cad_studio_container">
+                        <!-- Group 1: Environment -->
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="HDR environment map for lighting and reflections">Environment</span>
+                            <select class="tcv_studio_environment tcv_studio_select">
+                                <optgroup label="Studio">
+                                    <option value="studio">Procedural Studio</option>
+                                    <option value="studio_small_08" title="Poly Haven: studio_small_08.hdr (soft light, neutral, backlight)">Soft Light</option>
+                                    <option value="studio_small_03" title="Poly Haven: studio_small_03.hdr (high-contrast, softbox + ceiling lamp, crisp)">High Contrast Studio</option>
+                                    <option value="white_studio_05" title="Poly Haven: white_studio_05.hdr (white, product, bright, neutral lighting)">Bright Neutral</option>
+                                    <option value="white_studio_03" title="Poly Haven: white_studio_03.hdr (white, softbox, reflection, clean)">Clean Softbox</option>
+                                    <option value="photo_studio_01" title="Poly Haven: photo_studio_01.hdr (lighting setup, spotlights)">Spotlit Setup</option>
+                                    <option value="studio_small_09" title="Poly Haven: studio_small_09.hdr (product lighting, controlled, soft reflections)">Controlled Light</option>
+                                    <option value="cyclorama_hard_light" title="Poly Haven: cyclorama_hard_light.hdr (cyclorama, hard light, contrast)">Hard Contrast Light</option>
+                                </optgroup>
+                                <optgroup label="Outdoor">
+                                    <option value="canary_wharf" title="Poly Haven: canary_wharf.hdr (urban, city, overcast)">Urban Overcast</option>
+                                    <option value="kiara_1_dawn" title="Poly Haven: kiara_1_dawn.hdr (dawn, warm, nature, sunrise)">Outdoor Warm</option>
+                                    <option value="empty_warehouse_01" title="Poly Haven: empty_warehouse_01.hdr (warehouse, neutral, big space)">Neutral Industrial</option>
+                                    <option value="san_giuseppe_bridge" title="Poly Haven: san_giuseppe_bridge.hdr (bridge, outdoor, GPUOpen reference)">San Giuseppe Bridge</option>
+                                </optgroup>
+                            </select>
+                        </div>
+                        <div class="tcv_studio_checks tcv_studio_4k_row">
+                            <input class='tcv_studio_4k_env_maps tcv_check' type="checkbox" title="Download 4K environment maps (sharper reflections, slower)" />
+                            <span class="tcv_label" title="Download 4K environment maps (sharper reflections, slower)">Use 4K maps</span>
+                        </div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="Brightness of the environment lighting">Env Intensity</span>
+                            <div class="tcv_studio_slider_group">
+                                <input type="range" min="0" max="300" step="1" value="100"
+                                    class="tcv_sld_value_studio_env_intensity tcv_clip_slider">
+                                <input value=100 class="tcv_inp_value_studio_env_intensity tcv_clip_input"></input>
+                            </div>
+                        </div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="Rotate the environment map around the vertical axis">Env Rotation</span>
+                            <div class="tcv_studio_slider_group">
+                                <input type="range" min="0" max="360" step="1" value="0"
+                                    class="tcv_sld_value_studio_env_rotation tcv_clip_slider">
+                                <input value=0 class="tcv_inp_value_studio_env_rotation tcv_clip_input"></input>
+                            </div>
+                        </div>
+
+                        <div class="tcv_studio_group_spacer"></div>
+
+                        <!-- Group 2: Appearance -->
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="Scene background style">Background</span>
+                            <select class="tcv_studio_background tcv_studio_select">
+                                <option value="environment">Environment</option>
+                                <option value="transparent">Transparent</option>
+                                <option value="gradient">Gradient Grey</option>
+                                <option value="gradient-dark">Gradient Dark Grey</option>
+                                <option value="white">Solid White</option>
+                                <option value="grey">Solid Grey</option>
+                                <option value="darkgrey">Solid Dark Grey</option>
+                            </select>
+                        </div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="Tone mapping algorithm for HDR to display conversion">Tone Mapping</span>
+                            <select class="tcv_studio_tone_mapping tcv_studio_select">
+                                <option value="neutral">PBR Neutral</option>
+                                <option value="ACES">ACES Filmic</option>
+                                <option value="none">Linear (none)</option>
+                            </select>
+                        </div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="Overall brightness of the rendered image">Exposure</span>
+                            <div class="tcv_studio_slider_group">
+                                <input type="range" min="0" max="300" step="1" value="100"
+                                    class="tcv_sld_value_studio_exposure tcv_clip_slider">
+                                <input value=100 class="tcv_inp_value_studio_exposure tcv_clip_input"></input>
+                            </div>
+                        </div>
+
+                        <div class="tcv_studio_group_spacer"></div>
+
+                        <!-- Group 3: Shadows & AO -->
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="Darkness of directional shadows on the floor and between objects">Shadow Intensity</span>
+                            <div class="tcv_studio_slider_group">
+                                <input type="range" min="0" max="100" step="1" value="50"
+                                    class="tcv_sld_value_studio_shadow_intensity tcv_clip_slider">
+                                <input value=50 class="tcv_inp_value_studio_shadow_intensity tcv_clip_input"></input>
+                            </div>
+                        </div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="Blur amount for shadow edges (sharp to soft)">Shadow Softness</span>
+                            <div class="tcv_studio_slider_group">
+                                <input type="range" min="0" max="100" step="1" value="20"
+                                    class="tcv_sld_value_studio_shadow_softness tcv_clip_slider">
+                                <input value=20 class="tcv_inp_value_studio_shadow_softness tcv_clip_input"></input>
+                            </div>
+                        </div>
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="Screen-space ambient occlusion — darkens crevices and contact areas">AO Intensity</span>
+                            <div class="tcv_studio_slider_group">
+                                <input type="range" min="0" max="30" value="5"
+                                    class="tcv_sld_value_studio_ao_intensity tcv_clip_slider">
+                                <input value=5 class="tcv_inp_value_studio_ao_intensity tcv_clip_input"></input>
+                            </div>
+                        </div>
+
+                        <div class="tcv_studio_group_spacer"></div>
+
+                        <!-- Group 4: Textures -->
+                        <div class="tcv_studio_row">
+                            <span class="tcv_label" title="How textures are projected onto surfaces without UV coordinates">Texture Mapping</span>
+                            <select class="tcv_studio_texture_mapping tcv_studio_select">
+                                <option value="triplanar">Triplanar</option>
+                                <option value="parametric">Parametric UV</option>
+                            </select>
+                        </div>
                     </div>
                 </div>
             </div>
@@ -206,10 +330,23 @@
         </div>
 
         <div class="tcv_cad_view">
+            <div class="tcv_warning_banner" style="display: none;"></div>
             <div class="tcv_distance_measurement_panel tcv_panel tcv_round">
                 <div class="tcv_measure_header">Distance</div>
             </div>
 
+            <div class="tcv_mat_editor tcv_round" style="display: none;">
+                <div class="tcv_mat_editor_titlebar">
+                    <span class="tcv_mat_editor_title">Material Editor</span>
+                    <span class="tcv_mat_editor_titlebar_btns">
+                        <input class="tcv_mat_editor_reset tcv_btn tcv_small_btn" value="R" type="button" title="Reset to original material" />
+                        <input class="tcv_mat_editor_close tcv_btn tcv_small_btn" value="X" type="button" title="Close" />
+                    </span>
+                </div>
+                <div class="tcv_mat_editor_path"></div>
+                <div class="tcv_mat_editor_content tcv_mac-scrollbar tcv_scroller"></div>
+            </div>
+
             <div class="tcv_properties_measurement_panel tcv_panel tcv_round">
                 <div class="tcv_measure_header">Properties</div>
                 <div class="tcv_measure_subheader">Shape</div>

package/src/utils/decode-instances.ts

@@ -0,0 +1,233 @@
+/**
+ * Decode the compressed/instanced shape format.
+ *
+ * The instanced format wraps a standard Shapes object:
+ * ```
+ * { instances: [ { vertices: {shape,dtype,buffer,codec}, ... }, ... ],
+ *   shapes:    { version, parts, loc, name, id, bb, ... } }
+ * ```
+ *
+ * Each instance contains base64-encoded geometry buffers. Parts reference
+ * instances via `"shape": { "ref": N }`. After decoding, the result is a
+ * standard Shapes tree with TypedArrays — identical to the existing format.
+ */
+import type { Shape, Shapes } from "../core/types.js";
+
+// =============================================================================
+// Types for the encoded format
+// =============================================================================
+
+/** A single base64-encoded buffer entry. */
+interface EncodedBuffer {
+  shape: number[];
+  dtype: "float32" | "int32" | "uint32";
+  buffer: string;
+  codec: "b64";
+}
+
+/** An encoded geometry instance (all 9 buffer fields + optional uvs). */
+interface EncodedInstance {
+  vertices: EncodedBuffer;
+  triangles: EncodedBuffer;
+  normals: EncodedBuffer;
+  edges: EncodedBuffer;
+  obj_vertices: EncodedBuffer;
+  face_types: EncodedBuffer;
+  edge_types: EncodedBuffer;
+  triangles_per_face: EncodedBuffer;
+  segments_per_edge: EncodedBuffer;
+  uvs?: EncodedBuffer;
+}
+
+/** Top-level structure of the instanced format. */
+interface InstancedData {
+  instances: EncodedInstance[];
+  shapes: Shapes;
+}
+
+/** Shape reference (before resolution). */
+interface ShapeRef {
+  ref: number;
+}
+
+// =============================================================================
+// Decoding
+// =============================================================================
+
+/** Maximum decoded buffer size (512 MB). */
+const MAX_BUFFER_BYTES = 512 * 1024 * 1024;
+
+/** Decode a base64 string to a Uint8Array. */
+function fromBase64(b64: string): Uint8Array {
+  const binary = atob(b64);
+  if (binary.length > MAX_BUFFER_BYTES) {
+    throw new Error(
+      `Decoded buffer size ${binary.length} bytes exceeds maximum of ${MAX_BUFFER_BYTES} bytes`,
+    );
+  }
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+
+/** Decode a single encoded buffer entry to a typed array. */
+function decodeBuffer(buf: EncodedBuffer): Float32Array | Uint32Array {
+  const bytes = fromBase64(buf.buffer);
+  const arrayBuffer = bytes.buffer.slice(
+    bytes.byteOffset,
+    bytes.byteOffset + bytes.byteLength,
+  );
+  switch (buf.dtype) {
+    case "float32":
+      return new Float32Array(arrayBuffer);
+    case "int32":
+    case "uint32":
+      return new Uint32Array(arrayBuffer);
+    default:
+      throw new Error(`Unknown dtype: ${buf.dtype}`);
+  }
+}
+
+/** Decode all buffer fields of an instance into a Shape object. */
+function decodeInstance(inst: EncodedInstance): Shape {
+  const shape: Shape = {
+    vertices: decodeBuffer(inst.vertices) as Float32Array,
+    triangles: decodeBuffer(inst.triangles) as Uint32Array,
+    normals: decodeBuffer(inst.normals) as Float32Array,
+    edges: decodeBuffer(inst.edges) as Float32Array,
+    obj_vertices: decodeBuffer(inst.obj_vertices) as Float32Array,
+    face_types: decodeBuffer(inst.face_types) as Uint32Array,
+    edge_types: decodeBuffer(inst.edge_types) as Uint32Array,
+    triangles_per_face: decodeBuffer(inst.triangles_per_face) as Uint32Array,
+    segments_per_edge: decodeBuffer(inst.segments_per_edge) as Uint32Array,
+  };
+  if (inst.uvs) {
+    shape.uvs = decodeBuffer(inst.uvs) as Float32Array;
+  }
+  return shape;
+}
+
+/** Check if a value is an encoded buffer (inline base64 field). */
+function isEncodedBuffer(val: unknown): val is EncodedBuffer {
+  return (
+    typeof val === "object" &&
+    val !== null &&
+    "buffer" in val &&
+    "dtype" in val &&
+    "codec" in val &&
+    (val as EncodedBuffer).codec === "b64"
+  );
+}
+
+/**
+ * Decode any inline encoded buffers on a shape object.
+ * Mutates the shape in place, replacing EncodedBuffer fields with TypedArrays.
+ */
+function decodeInlineShapeBuffers(shape: Record<string, unknown>): void {
+  for (const key of Object.keys(shape)) {
+    if (isEncodedBuffer(shape[key])) {
+      shape[key] = decodeBuffer(shape[key] as EncodedBuffer);
+    }
+  }
+}
+
+/**
+ * Walk the shapes tree and decode any inline encoded buffers found in
+ * part.shape objects. This handles edge/vertex-only objects that embed
+ * encoded buffers directly (not via instance refs).
+ */
+function decodeInlineBuffers(shapes: Shapes): void {
+  if (shapes.parts) {
+    for (const part of shapes.parts) {
+      if (
+        part.shape != null &&
+        typeof part.shape === "object" &&
+        !isShapeRef(part.shape as unknown)
+      ) {
+        decodeInlineShapeBuffers(part.shape as unknown as Record<string, unknown>);
+      }
+      if (part.parts) {
+        decodeInlineBuffers(part);
+      }
+    }
+  }
+}
+
+/** Check if a shape field is an unresolved reference. */
+function isShapeRef(shape: unknown): shape is ShapeRef {
+  return (
+    typeof shape === "object" &&
+    shape !== null &&
+    "ref" in shape &&
+    typeof (shape as ShapeRef).ref === "number"
+  );
+}
+
+/**
+ * Recursively walk the shapes tree and replace { ref: N } entries
+ * with the corresponding decoded instance.
+ *
+ * Before decoding, `part.shape` may be `{ ref: N }` which doesn't match
+ * the `Shape` type. We use `unknown` casts since this operates on raw
+ * (pre-typed) data that is being transformed into the proper type.
+ */
+function resolveRefs(shapes: Shapes, decoded: Shape[]): void {
+  if (shapes.parts) {
+    for (const part of shapes.parts) {
+      if (isShapeRef(part.shape as unknown)) {
+        const ref = (part.shape as unknown as ShapeRef).ref;
+        if (ref < 0 || ref >= decoded.length) {
+          throw new Error(
+            `Shape ref ${ref} is out of bounds (${decoded.length} instances decoded)`,
+          );
+        }
+        part.shape = decoded[ref];
+      }
+      if (part.parts) {
+        resolveRefs(part, decoded);
+      }
+    }
+  }
+}
+
+// =============================================================================
+// Public API
+// =============================================================================
+
+/**
+ * Type guard: check if data is in the instanced format.
+ * Detected by the presence of an `instances` array and a `shapes` object.
+ */
+function isInstancedFormat(data: unknown): data is InstancedData {
+  return (
+    typeof data === "object" &&
+    data !== null &&
+    "instances" in data &&
+    Array.isArray((data as InstancedData).instances) &&
+    "shapes" in data &&
+    typeof (data as InstancedData).shapes === "object"
+  );
+}
+
+/**
+ * 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
+ */
+function decodeInstancedFormat(data: InstancedData): Shapes {
+  // Decode all instances
+  const decoded = data.instances.map(decodeInstance);
+
+  // Resolve all shape references
+  const shapes = data.shapes;
+  resolveRefs(shapes, decoded);
+
+  return shapes;
+}
+
+export { isInstancedFormat, decodeInstancedFormat, decodeInlineBuffers };
+export type { InstancedData, EncodedBuffer, EncodedInstance };

package/src/utils/utils.ts

@@ -110,12 +110,9 @@ interface Disposable {
   dispose: () => void;
 }
 
-function isDisposable(value: unknown): value is Disposable {
-  return value !== null && typeof value === "object" && "dispose" in value && typeof (value as Disposable).dispose === "function";
-}
-
 interface MaterialLike {
   dispose: () => void;
+  // MeshStandardMaterial texture maps
   map?: Disposable | null;
   normalMap?: Disposable | null;
   roughnessMap?: Disposable | null;
@@ -124,29 +121,45 @@ interface MaterialLike {
   emissiveMap?: Disposable | null;
   alphaMap?: Disposable | null;
   bumpMap?: Disposable | null;
+  // MeshPhysicalMaterial additional texture maps
+  transmissionMap?: Disposable | null;
+  clearcoatMap?: Disposable | null;
+  clearcoatRoughnessMap?: Disposable | null;
+  clearcoatNormalMap?: Disposable | null;
+  thicknessMap?: Disposable | null;
+  specularIntensityMap?: Disposable | null;
+  specularColorMap?: Disposable | null;
+  sheenColorMap?: Disposable | null;
+  sheenRoughnessMap?: Disposable | null;
+  anisotropyMap?: Disposable | null;
 }
 
+/** All texture map property names on MaterialLike (for iteration) */
+const MATERIAL_TEXTURE_KEYS: readonly (keyof Omit<MaterialLike, "dispose">)[] = [
+  // MeshStandardMaterial
+  "map", "normalMap", "roughnessMap", "metalnessMap",
+  "aoMap", "emissiveMap", "alphaMap", "bumpMap",
+  // MeshPhysicalMaterial
+  "transmissionMap", "clearcoatMap", "clearcoatRoughnessMap", "clearcoatNormalMap",
+  "thicknessMap", "specularIntensityMap", "specularColorMap",
+  "sheenColorMap", "sheenRoughnessMap", "anisotropyMap",
+];
+
 /**
- * Dispose a material and its associated textures.
+ * Dispose a material and detach its texture references.
+ *
+ * Texture GPU resources are NOT freed here -- TextureCache is the sole owner
+ * of loaded textures and is responsible for calling texture.dispose().
+ * This function only nulls out the material's texture map references to
+ * break the association, then disposes the material itself.
  */
 function disposeMaterial(material: MaterialLike | null | undefined): void {
   if (!material) return;
 
-  // Dispose all texture properties
-  const textures = [
-    material.map,
-    material.normalMap,
-    material.roughnessMap,
-    material.metalnessMap,
-    material.aoMap,
-    material.emissiveMap,
-    material.alphaMap,
-    material.bumpMap,
-  ];
-  for (const texture of textures) {
-    if (isDisposable(texture)) {
-      gpuTracker.untrack("texture", texture);
-      texture.dispose();
+  // Detach all texture references (do NOT dispose -- TextureCache owns them)
+  for (const key of MATERIAL_TEXTURE_KEYS) {
+    if (material[key]) {
+      (material as unknown as Record<string, unknown>)[key] = null;
     }
   }