copper3d 3.6.6 → 3.6.8

package/dist/Utils/surfaceAnnotation/types.d.ts

@@ -22,6 +22,7 @@ export interface Annotation {
     label: string;
     color: string;
     closed: boolean;
+    visible: boolean;
     vertices: AnnotationVertex[];
     object3D: THREE.Object3D | null;
 }

package/dist/Utils/surfaceAnnotation/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/Utils/surfaceAnnotation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAuC/B,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAEjC,sGAAsG;AACtG,MAAM,UAAU,qBAAqB,CACnC,CAAa,EACb,IAAgB;IAEhB,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IACjE,OAAO;QACL,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,EAAE,EAAE,EAAE,CAAC,CAAC;QACR,EAAE,EAAE,EAAE,CAAC,CAAC;QACR,EAAE,EAAE,EAAE,CAAC,CAAC;QACR,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAEhC,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAChC,CAAmB,EACnB,IAAgB;IAEhB,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1E,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5E,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAClB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/Utils/surfaceAnnotation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAwC/B,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAEjC,sGAAsG;AACtG,MAAM,UAAU,qBAAqB,CACnC,CAAa,EACb,IAAgB;IAEhB,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IACjE,OAAO;QACL,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,EAAE,EAAE,EAAE,CAAC,CAAC;QACR,EAAE,EAAE,EAAE,CAAC,CAAC;QACR,EAAE,EAAE,EAAE,CAAC,CAAC;QACR,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAEhC,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAChC,CAAmB,EACnB,IAAgB;IAEhB,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1E,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5E,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAClB,CAAC"}

package/dist/bundle.esm.js

@@ -49752,8 +49752,11 @@ class baseScene extends commonScene {
             this.renderer.setSize(this.container.clientWidth, this.container.clientHeight);
         };
         this.renderer = renderer;
-        this.ambientLight = new AmbientLight(0x606060, 0.8);
-        this.directionalLight = new DirectionalLight(0xffffff, 1.0);
+        // three r165+ removed `useLegacyLights`; lighting is always physically
+        // correct now, which makes the same intensity ~1/PI as dim as the old
+        // (three <=0.150) legacy default. Scale by PI to keep the prior brightness.
+        this.ambientLight = new AmbientLight(0x606060, 0.8 * Math.PI);
+        this.directionalLight = new DirectionalLight(0xffffff, 1.0 * Math.PI);
         if (!(opt === null || opt === void 0 ? void 0 : opt.alpha)) {
             this.vignette = createBackground({
                 aspect: this.container.clientWidth / this.container.clientHeight,
@@ -49838,7 +49841,7 @@ class baseScene extends commonScene {
     }
     addLights() {
         // Hemisphere light: sky/ground for broad ambient fill
-        const hemiLight = new HemisphereLight(0xddeeff, 0x0f0e0d, 0.6);
+        const hemiLight = new HemisphereLight(0xddeeff, 0x0f0e0d, 0.6 * Math.PI);
         hemiLight.name = "hemi_light";
         this.scene.add(hemiLight);
         // Main key light — front-right, slightly above
@@ -49848,12 +49851,12 @@ class baseScene extends commonScene {
         this.camera.add(this.ambientLight);
         this.camera.add(this.directionalLight);
         // Fill light — opposite side to soften shadows
-        const fillLight = new DirectionalLight(0xffffff, 0.4);
+        const fillLight = new DirectionalLight(0xffffff, 0.4 * Math.PI);
         fillLight.name = "fill_light";
         fillLight.position.set(-0.5, -0.2, -0.866);
         this.camera.add(fillLight);
         // Top light — illuminates the top surface that key/fill lights miss
-        const topLight = new DirectionalLight(0xffffff, 0.5);
+        const topLight = new DirectionalLight(0xffffff, 0.5 * Math.PI);
         topLight.name = "top_light";
         topLight.position.set(0, 1, 0.2);
         this.camera.add(topLight);
@@ -61165,6 +61168,15 @@ class MeshGraph {
         const nm = new Matrix3().getNormalMatrix(mesh.matrixWorld);
         return n.applyMatrix3(nm).normalize();
     }
+    /** Vertex local normal at index i (reads from the welded graphGeo normal attribute). */
+    vertexNormalLocal(i) {
+        return new Vector3(this.normals ? this.normals[i * 3] : 0, this.normals ? this.normals[i * 3 + 1] : 0, this.normals ? this.normals[i * 3 + 2] : 1);
+    }
+    /** Normal at the vertex nearest to localPoint (for recovering normals from imported point coordinates). */
+    nearestNormalLocal(p) {
+        const i = this.nearestVertex(p);
+        return this.vertexNormalLocal(i);
+    }
     /** Vertex local coordinates + local normal (the graph geometry is already local space). */
     vertexLocal(i) {
         return {
@@ -61390,6 +61402,13 @@ class AnnotationStore {
             this.notify();
         }
     }
+    setVisible(id, visible) {
+        const a = this.get(id);
+        if (a) {
+            a.visible = visible;
+            this.notify();
+        }
+    }
     toJSON(modelName, mesh, opts = {}) {
         var _a;
         const space = (_a = opts.space) !== null && _a !== void 0 ? _a : "local";
@@ -61414,6 +61433,7 @@ class AnnotationStore {
                 label: a.label,
                 color: a.color,
                 closed: a.closed,
+                visible: a.visible,
                 points: a.vertices.map(toPt),
             })),
         };
@@ -61433,6 +61453,10 @@ class SurfaceAnnotator {
         var _a, _b, _c;
         this.mode = "navigate";
         this.spaceHeld = false;
+        this.drawLock = false;
+        this.armed = "freehand";
+        this.spaceDownAt = 0;
+        this.spaceDragged = false;
         this.pointerDown = false;
         this.store = new AnnotationStore();
         this.managed = new Set();
@@ -61459,14 +61483,18 @@ class SurfaceAnnotator {
                 (this.activeGeoLine.material.resolution.set(w, h));
         };
         this.onPointerDown = (e) => {
-            if (this.spaceHeld)
-                return;
             if (e.button !== 0)
                 return; // left button only
             if (!this.insideContainer(e))
                 return;
             this.pointerDown = true;
-            if (this.mode === "point") {
+            // Only act with the armed tool when in drawing mode (drawLock or spaceHeld).
+            // When not drawing, navigation is the default — pointer events go to camera controls.
+            if (!this.drawing)
+                return;
+            // Use armed tool (not this.mode which may be "navigate")
+            const activeTool = this.armed;
+            if (activeTool === "point") {
                 const h = this.hit(e);
                 if (!h)
                     return;
@@ -61480,13 +61508,14 @@ class SurfaceAnnotator {
                     label: `Point ${this.seq}`,
                     color: this.pointColorVal,
                     closed: false,
+                    visible: true,
                     vertices: [v],
                     object3D: marker,
                 };
                 this.store.add(ann);
                 return;
             }
-            if (this.mode === "freehand") {
+            if (activeTool === "freehand") {
                 this.activeStroke = new StrokeContour(this.minGap, this.maxJump, this.o.mesh);
                 this.activeStroke.begin();
                 const h = this.hit(e);
@@ -61496,7 +61525,7 @@ class SurfaceAnnotator {
                 this.o.scene.add(this.activeLine);
                 return;
             }
-            if (this.mode === "geodesic") {
+            if (activeTool === "geodesic") {
                 // First check whether an existing anchor was clicked → cancel that point (any point can be canceled).
                 const pick = this.pickGeoMarker(e);
                 if (pick >= 0 && this.activeGeo) {
@@ -61523,15 +61552,26 @@ class SurfaceAnnotator {
             }
         };
         this.onPointerMove = (e) => {
-            if (this.spaceHeld) {
-                this.setGeoHover(-1);
+            // Track if user dragged while space was held (so a hold-drag is not treated as a tap).
+            if (this.spaceHeld && this.pointerDown) {
+                this.spaceDragged = true;
+            }
+            // When not drawing, navigation is default — don't interfere with camera controls.
+            if (!this.drawing) {
+                // In geodesic mode we can still show the hover hint when not drawing.
+                if (this.armed === "geodesic" && !this.pointerDown) {
+                    this.setGeoHover(this.insideContainer(e) ? this.pickGeoMarker(e) : -1);
+                }
+                else {
+                    this.setGeoHover(-1);
+                }
                 return;
             }
-            // In geodesic mode, show the "✕" hint when hovering an anchor sphere (that point can be clicked to cancel).
-            if (this.mode === "geodesic" && !this.pointerDown) {
+            // Drawing mode: geodesic hover hint
+            if (this.armed === "geodesic" && !this.pointerDown) {
                 this.setGeoHover(this.insideContainer(e) ? this.pickGeoMarker(e) : -1);
             }
-            if (this.mode === "freehand" &&
+            if (this.armed === "freehand" &&
                 this.pointerDown &&
                 this.activeStroke &&
                 this.activeLine) {
@@ -61556,6 +61596,7 @@ class SurfaceAnnotator {
                         label: `Contour ${this.seq}`,
                         color: this.freehandColor,
                         closed: false,
+                        visible: true,
                         vertices: verts,
                         object3D: this.activeLine,
                     };
@@ -61573,11 +61614,17 @@ class SurfaceAnnotator {
             if (this.isTypingTarget(e))
                 return;
             if (e.code === "Space") {
+                if (!this.spaceHeld) {
+                    this.spaceDownAt = performance.now();
+                    this.spaceDragged = false;
+                }
                 this.spaceHeld = true;
                 this.applyCameraGating();
+                e.preventDefault();
                 return;
             }
             if (e.key === "Escape") {
+                this.drawLock = false;
                 this.setMode("navigate");
                 return;
             }
@@ -61610,7 +61657,11 @@ class SurfaceAnnotator {
         };
         this.onKeyUp = (e) => {
             if (e.code === "Space") {
+                const held = performance.now() - this.spaceDownAt;
                 this.spaceHeld = false;
+                if (held <= SurfaceAnnotator.TAP_MS && !this.spaceDragged) {
+                    this.drawLock = !this.drawLock; // tap toggles lock
+                }
                 this.applyCameraGating();
             }
         };
@@ -61666,6 +61717,10 @@ class SurfaceAnnotator {
         if (m !== "geodesic" && this.activeGeo)
             this.clearActiveGeo();
         this.mode = m;
+        // Record armed tool when choosing a drawing mode (not navigate).
+        // Camera gating is NOT changed here — the user must use Space to enter drawing.
+        if (m !== "navigate")
+            this.armed = m;
         this.applyCameraGating();
         (_b = (_a = this.o).onModeChange) === null || _b === void 0 ? void 0 : _b.call(_a, m);
     }
@@ -61728,10 +61783,92 @@ class SurfaceAnnotator {
     exportJSON(modelName, opts) {
         return this.store.toJSON(modelName, this.o.mesh, opts);
     }
+    setVisible(id, visible) {
+        this.store.setVisible(id, visible);
+    }
+    /**
+     * Rebuild annotations from an exported payload (local-space points). Normals are taken from the
+     * point when present ([x,y,z,nx,ny,nz]); otherwise recovered from the welded graph's nearest
+     * vertex. Each imported item becomes first-class (select/recolor/hide/delete/export).
+     */
+    importAnnotations(payload) {
+        var _a, _b, _c, _d;
+        let count = 0;
+        let maxImported = this.seq;
+        for (const a of (_a = payload.annotations) !== null && _a !== void 0 ? _a : []) {
+            const verts = a.points.map((p) => {
+                const [x, y, z] = p;
+                let nx = p[3], ny = p[4], nz = p[5];
+                if (nx === undefined || ny === undefined || nz === undefined) {
+                    const nrm = this.graph.nearestNormalLocal(new Vector3(x, y, z));
+                    nx = nrm.x;
+                    ny = nrm.y;
+                    nz = nrm.z;
+                }
+                return { x, y, z, nx, ny, nz, faceIndex: 0 };
+            });
+            if (a.type === "points") {
+                for (const v of verts) {
+                    // Only reuse the provided id for a single-point entry (the round-trip case);
+                    // a multi-point points entry must get a fresh id per marker to avoid duplicate keys.
+                    const id = a.id && verts.length === 1 ? a.id : this.nextId();
+                    const marker = makePointMarker(v, this.o.mesh, a.color, this.markerRadius);
+                    this.o.scene.add(marker);
+                    this.store.add({
+                        id,
+                        type: "points",
+                        mode: null,
+                        label: a.label,
+                        color: a.color,
+                        closed: false,
+                        visible: (_b = a.visible) !== null && _b !== void 0 ? _b : true,
+                        vertices: [v],
+                        object3D: marker,
+                    });
+                    // track max numeric id
+                    const m = id.match(/^a(\d+)$/);
+                    if (m)
+                        maxImported = Math.max(maxImported, parseInt(m[1], 10));
+                    count++;
+                }
+            }
+            else {
+                if (verts.length < 2)
+                    continue;
+                const id = (_c = a.id) !== null && _c !== void 0 ? _c : this.nextId();
+                const line = makeContourLine(verts, a.color, a.closed, this.o.container, this.epsilon, this.o.mesh);
+                this.o.scene.add(line);
+                this.store.add({
+                    id,
+                    type: "contour",
+                    mode: a.mode,
+                    label: a.label,
+                    color: a.color,
+                    closed: a.closed,
+                    visible: (_d = a.visible) !== null && _d !== void 0 ? _d : true,
+                    vertices: verts,
+                    object3D: line,
+                });
+                const m = id.match(/^a(\d+)$/);
+                if (m)
+                    maxImported = Math.max(maxImported, parseInt(m[1], 10));
+                count++;
+            }
+        }
+        // keep seq ahead of any imported numeric ids to avoid collisions
+        if (maxImported > this.seq)
+            this.seq = maxImported;
+        return count;
+    }
     // ---- Internal ----
+    get drawing() {
+        return this.drawLock || this.spaceHeld;
+    }
     applyCameraGating() {
-        // Holding Space for temporary rotation takes priority; otherwise enable the camera only in navigate mode.
-        this.o.controls.enabled = this.spaceHeld || this.mode === "navigate";
+        var _a, _b;
+        // Default is navigate (camera enabled). Drawing only when drawLock or spaceHeld.
+        this.o.controls.enabled = !this.drawing;
+        (_b = (_a = this.o).onInteractionChange) === null || _b === void 0 ? void 0 : _b.call(_a, { drawing: this.drawing, armed: this.armed, locked: this.drawLock });
     }
     /** Reconcile the scene against store.list(): add missing objects, remove deleted ones (no dispose, kept for undo restore). */
     reconcile() {
@@ -61749,6 +61886,11 @@ class SurfaceAnnotator {
                 this.o.scene.add(o);
         }
         this.managed = present;
+        // Apply per-annotation visibility
+        for (const a of this.store.list()) {
+            if (a.object3D)
+                a.object3D.visible = a.visible;
+        }
         this.applySelection();
         (_b = (_a = this.o).onChange) === null || _b === void 0 ? void 0 : _b.call(_a, this.store.list());
     }
@@ -61756,6 +61898,8 @@ class SurfaceAnnotator {
         for (const a of this.store.list()) {
             if (!a.object3D)
                 continue;
+            if (!a.visible)
+                continue;
             const sel = a.id === this.selectedId;
             if (a.type === "contour") {
                 const mat = a.object3D.material;
@@ -61988,6 +62132,7 @@ class SurfaceAnnotator {
                 label: `Contour ${this.seq}`,
                 color: this.geodesicColor,
                 closed,
+                visible: true,
                 vertices: verts,
                 object3D: this.activeGeoLine,
             };
@@ -62021,7 +62166,8 @@ class SurfaceAnnotator {
         window.removeEventListener("keyup", this.onKeyUp);
         window.removeEventListener("resize", this.onResize);
     }
-}
+}
+SurfaceAnnotator.TAP_MS = 250;
 
 class copperScene extends baseScene {
     // rayster pick
@@ -83444,15 +83590,15 @@ function evaluateElement(element, weights) {
 }
 
 // import * as kiwrious from "copper3d_plugin_heart_k";
-// "v3.6.6" is injected at build time by rollup @rollup/plugin-replace, sourced from package.json version.
+// "v3.6.8" is injected at build time by rollup @rollup/plugin-replace, sourced from package.json version.
 // When copper3d is consumed from local source (no rollup replace step), the identifier is undefined and
 // referencing it throws a ReferenceError — guard it so local loading still works.
 let _revision = "unknown";
 try {
-    _revision = "v3.6.6";
+    _revision = "v3.6.8";
 }
 catch (_a) {
-    /* "v3.6.6" not injected (local source build) */
+    /* "v3.6.8" not injected (local source build) */
 }
 const REVISION = _revision;
 // Expose on global so the version can be read in a production browser console via window.__COPPER3D_VERSION__