three-cad-viewer 4.3.9 → 5.0.1

package/dist/scene/nestedgroup.d.ts

@@ -2,6 +2,9 @@ import * as THREE from "three";
 import { BoundingBox } from "./bbox.js";
 import { ObjectGroup, isObjectGroup } from "./objectgroup.js";
 import { MaterialFactory } from "../rendering/material-factory.js";
+import { ComponentRegistry } from "../rendering/id-picking.js";
+import { HighlightController } from "../rendering/highlight.js";
+import { MeshGeometrySource } from "../tools/cad_tools/mesh-measure.js";
 import type { ZebraColorScheme, ZebraMappingMode, StudioTextureMapping, Shapes, ColorValue, MaterialAppearance, MaterialXMaterial } from "../core/types";
 interface ShapeData {
     vertices: Float32Array | number[][];
@@ -9,9 +12,16 @@ interface ShapeData {
     triangles: Uint32Array | number[][];
     edges?: Float32Array | number[][];
     uvs?: Float32Array | number[];
+    triangles_per_face?: number[] | Uint32Array;
+    segments_per_edge?: number[] | Uint32Array;
+    obj_vertices?: Float32Array | number[];
+    face_types?: number[] | Uint32Array;
+    edge_types?: number[] | Uint8Array | Uint32Array;
 }
 interface EdgeData {
     edges: Float32Array | number[][];
+    segments_per_edge?: number[] | Uint32Array;
+    obj_vertices?: Float32Array | number[];
 }
 interface VertexData {
     obj_vertices: Float32Array | number[];
@@ -37,7 +47,6 @@ interface ShapeEntry {
     state: number[];
     loc?: [[number, number, number], [number, number, number, number]];
     renderback?: boolean;
-    exploded?: boolean;
     geomtype?: number | null;
     subtype?: string | null;
     texture?: {
@@ -77,6 +86,24 @@ declare class NestedGroup {
     bbox: BoundingBox | null;
     bsphere: THREE.Sphere | null;
     groups: GroupsMap;
+    /**
+     * id-based-picking component registry: maps each per-vertex `componentId` to its
+     * `ComponentInfo` for the GPU picker (populated when `assignIds === true`).
+     */
+    registry: ComponentRegistry;
+    /** Whether to assign component ids while rendering. */
+    assignIds: boolean;
+    /**
+     * Component-level shader highlight: patches visual materials to tint/widen by
+     * `componentId` (created when `assignIds`).
+     */
+    highlight: HighlightController | null;
+    /**
+     * Per-node mesh geometry for the internal (TypeScript) measurement backend.
+     * Populated for the compact group only (`assignIds`), keyed by node path like the
+     * {@link registry}; lets measurements be computed without the Python backend.
+     */
+    meshGeometry: MeshGeometrySource;
     clipPlanes: THREE.Plane[] | null;
     materialFactory: MaterialFactory;
     materialsTable: Record<string, string | MaterialXMaterial | MaterialAppearance> | null;
@@ -159,10 +186,25 @@ declare class NestedGroup {
     /**
      * Render a tessellated 3D shape with front/back faces and optional edges.
      */
-    renderShape(shape: ShapeData, color: ColorValue, alpha: number | null, renderback: boolean, exploded: boolean, path: string, name: string, states: number[], geomtype?: {
+    renderShape(shape: ShapeData, color: ColorValue, alpha: number | null, renderback: boolean, path: string, name: string, states: number[], geomtype?: {
         topo: string;
         geomtype: number | string | null;
     } | null, subtype?: string | null, texture_data?: TextureData | null, texture_width?: number | null, texture_height?: number | null): ObjectGroup;
+    /**
+     * Build the pick-only B-rep-corner cloud (+ a selection-marker highlight Points) for a
+     * node carrying `obj_vertices` — a solid, a standalone face, or a standalone edge — so
+     * its corners are selectable via id-picking.
+     *
+     * The pick cloud lives on the VERTEX pick layer ONLY (NOT visual layer 0), so the visual
+     * camera never draws it; its material stays `visible:true` because three drops
+     * `material.visible===false` objects before `overrideMaterial` applies. Its pick-buffer
+     * visibility is kept in sync with the owning group (`setPickVertices`) so a hidden shape
+     * stops contributing corner ids.
+     *
+     * `subtype` is "solid" for a solid (→ the corner ids carry the owning `solidPath`, so the
+     * pick gates on faces||edges) and null for standalone faces/edges (→ own-node corners).
+     */
+    private _addPickVertices;
     /**
      * Create edge geometry from extruded polygons.
      */
@@ -170,14 +212,14 @@ declare class NestedGroup {
     /**
      * Render extruded 2D polygons (GDS format) as 3D geometry.
      */
-    renderPolygons(shape: PolygonShape, minZ: number, color: ColorValue, alpha: number, renderback: boolean, _exploded: boolean, path: string, name: string, states: number[], geomtype?: {
+    renderPolygons(shape: PolygonShape, minZ: number, color: ColorValue, alpha: number, renderback: boolean, path: string, name: string, states: number[], geomtype?: {
         topo: string;
         geomtype: number | string | null;
     } | null, subtype?: string | null): ObjectGroup;
     /**
      * Recursively render all shapes in the shape tree.
      * Note: The shapes parameter uses the public Shapes type but internally
-     * contains ShapeEntry/ShapeTree data after decomposition by viewer._decompose()
+     * contains ShapeEntry/ShapeTree data.
      */
     renderLoop(shapes: Shapes): THREE.Group;
     /**

package/dist/scene/objectgroup.d.ts

@@ -61,6 +61,13 @@ declare class ObjectGroup extends THREE.Group {
     edges: Edges | null;
     edgeMaterial: EdgeMaterial | null;
     vertices: VertexPoints | null;
+    /**
+     * Pick-only `obj_vertices` cloud for a solid's B-rep corners (vertex pick layer,
+     * off the visual layer). Has its own always-visible material, so it is NOT covered by
+     * {@link setShapeVisible}/{@link setEdgesVisible} — its pick-buffer visibility is kept
+     * in sync explicitly so a hidden solid's corners don't keep stealing hover picks.
+     */
+    pickVertices: VertexPoints | null;
     clipping: Map<number, THREE.Group>;
     isSelected: boolean;
     originalColor: THREE.Color | null;
@@ -120,6 +127,16 @@ declare class ObjectGroup extends THREE.Group {
      * Set the vertices points.
      */
     setVertices(points: VertexPoints): void;
+    /**
+     * Register the pick-only B-rep-corner cloud (vertex pick layer). Its pick-buffer
+     * visibility is then kept in sync with the solid's overall visibility so a hidden
+     * solid stops contributing vertex ids to the pick buffer (otherwise its corners win
+     * the vertex>face priority over a visible face behind them → hover flicker).
+     */
+    setPickVertices(points: VertexPoints): void;
+    /** Sync the pick-only vertex cloud's visibility with the group's (pickable iff the
+     *  front faces or edges are visible — matches the picker's hidden-component gate). */
+    private _syncPickVertices;
     /**
      * Add a clipping group for a plane index.
      */

package/dist/scene/render-shape.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shape tessellation and decomposition for rendering CAD objects.
+ * Shape tessellation for rendering CAD objects.
  */
 import { NestedGroup } from "./nestedgroup.js";
 import { BoundingBox } from "./bbox.js";
@@ -32,7 +32,7 @@ interface ShapeRenderConfig {
     normalLen: number;
 }
 /**
- * Handles tessellation and decomposition of CAD shapes for rendering.
+ * Handles tessellation of CAD shapes for rendering.
  */
 declare class ShapeRenderer {
     private config;
@@ -58,28 +58,12 @@ declare class ShapeRenderer {
      * @returns The navigation tree object.
      */
     private _getTree;
-    /**
-     * Decompose a CAD object into faces, edges and vertices.
-     * @param part - The part to decompose.
-     * @returns A decomposed part object.
-     */
-    private _decompose;
-    /**
-     * Convert Shape arrays to TypedArrays for efficient rendering.
-     * Note: This mutates the shape in place.
-     */
-    private _convertArrays;
-    /**
-     * Recursively process shapes, converting arrays and decomposing parts.
-     */
-    private _processShapes;
     /**
      * Render the shapes of the CAD object.
-     * @param exploded - Whether to render the compact or exploded version
      * @param shapes - The Shapes object.
      * @returns A nested THREE.Group object and navigation tree.
      */
-    render(exploded: boolean, shapes: Shapes): RenderResult;
+    render(shapes: Shapes): RenderResult;
 }
 export { ShapeRenderer };
 export type { ShapeTreeData, RenderResult, ShapeRenderConfig };

package/dist/three-cad-viewer.css

@@ -258,7 +258,6 @@ input[type="radio"] {
   background-image: var(--tcv-icon-nav_closed);
 } */
 
-
 .tcv_cad_viewer {
   --tcv-ui-row-gap: 8px;
   margin: 0;
@@ -288,6 +287,30 @@ input[type="radio"] {
   margin: 2px;
 }
 
+/* Hover preselection readout: a rounded overlay badge in a FIXED row directly
+   below the grid-size badge (.tcv_tick_size at bottom:22px), so the grid badge
+   never moves when this appears/vanishes. Left:84px clears the 80px orientation
+   marker — keep in sync with OrientationMarker(80,80) in viewer.ts. JS hides it
+   (display:none) when empty. Pure overlay — never intercepts pointer events. */
+.tcv_status_line {
+  position: absolute;
+  bottom: 4px;
+  left: 84px;
+  max-width: calc(100% - 88px);
+  font-size: 12px;
+  line-height: 14px;
+  font-family: sans-serif;
+  color: var(--tcv-font-color);
+  background-color: var(--tcv-bg-overlay-rest-color);
+  border-radius: 4px;
+  padding: 1px 4px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  pointer-events: none;
+  z-index: 100;
+}
+
 .tcv_cad_view_glass {
   position: absolute !important;
   left: 4px;
@@ -326,7 +349,7 @@ input[type="radio"] {
   font-family: sans-serif;
   font-size: 12px;
   overflow: hidden;
-  user-select:text;
+  user-select: text;
 }
 
 .tcv_cad_info_wrapper {
@@ -418,7 +441,7 @@ input[type="radio"] {
   line-height: 14px;
 }
 
-.tcv_small_table_row>td,
+.tcv_small_table_row > td,
 th {
   padding-left: 6px;
 }
@@ -856,7 +879,6 @@ input[type="button"] {
   margin-right: 0;
 }
 
-
 .tcv_zebra_radio {
   margin-bottom: var(--tcv-ui-row-gap);
   margin-left: -3px;
@@ -1107,7 +1129,7 @@ input[type="button"] {
   max-width: 80%;
   text-align: center;
   pointer-events: auto;
-  box-shadow: 0 1px 4px rgba(0,0,0,0.3);
+  box-shadow: 0 1px 4px rgba(0, 0, 0, 0.3);
 }
 
 .tcv_studio_spinner {
@@ -1124,7 +1146,9 @@ input[type="button"] {
 }
 
 @keyframes tcv_spin {
-  to { transform: rotate(360deg); }
+  to {
+    transform: rotate(360deg);
+  }
 }
 
 .tcv_filter_menu {
@@ -1144,10 +1168,13 @@ input[type="button"] {
   color: var(--tcv-font-color);
   font-size: 13px;
   border: none;
-  float: right;
   position: absolute;
-  right: 0px;
-  width: auto;
+  right: -4px;
+  top: -3px;
+  /* Fixed width so the trigger pill and the option list share one right-anchored
+     box — their right borders coincide (and line up with the panel edge). Wide
+     enough for the longest option ("Vertex"). */
+  width: 5em;
 }
 
 .tcv_shape_filter:hover {
@@ -1161,9 +1188,9 @@ input[type="button"] {
 }
 
 .tcv_filter_value {
-  width: 3em;
+  flex: 1;
+  text-align: left;
   padding-left: 3px;
-  display: inline-block;
 }
 
 .tcv_filter_dropdown_active {
@@ -1180,22 +1207,29 @@ input[type="button"] {
 }
 
 .tcv_filter_content {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
   background-color: var(--tcv-bg-overlay-color);
 }
 
-.tcv_tick_size{
-  background-color: var(--tcv-bg-overlay-color);
+/* Grid-size badge: FIXED bottom-left row, just above the status readout. Stays
+   put whether or not the status line is shown (no jumping). */
+.tcv_tick_size {
+  position: absolute;
+  bottom: 22px;
+  left: 84px;
+  background-color: var(--tcv-bg-overlay-rest-color);
   border-radius: 4px;
-  padding:2px;
-  width:fit-content;
+  padding: 1px 4px;
+  width: fit-content;
   font-size: 12px;
-  margin-left:100px;
-  margin-top: -24px;
-  z-index: 1000;
+  line-height: 14px;
+  z-index: 100;
 }
 
-.tcv_tick_size_value{
-  padding:3px;
+.tcv_tick_size_value {
+  padding: 3px;
 }