@realsee/dnalogel 3.69.12 → 3.69.13-alpha-2

package/libs/shared-utils/Object3DHelper/Helper/RotateHelper.js

@@ -1,53 +1,59 @@
-var m = Object.defineProperty;
-var w = (a, s, t) => s in a ? m(a, s, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[s] = t;
-var i = (a, s, t) => (w(a, typeof s != "symbol" ? s + "" : s, t), t);
-import * as r from "three";
-import { RotateHelperAbstract as u } from "../Base/BaseHelper.js";
-import { AXES_THREE_COLOR as l } from "../Constants/color.js";
-import { tipsDom as y } from "./HTML/tipsDom.js";
-import { calculateScaleByCamera as C } from "../utils/calculateScaleByCamera.js";
-class D extends u {
-  constructor(t, e) {
-    super(t, e);
-    i(this, "name", "RotateHelper");
-    i(this, "xCircle");
-    i(this, "yCircle");
-    i(this, "zCircle");
-    i(this, "children", []);
-    i(this, "angleTips");
-    i(this, "container");
-    (e == null ? void 0 : e.yzCircleEnable) !== !1 && (this.xCircle = new n({ direction: "x", color: l.X })), (e == null ? void 0 : e.xzCircleEnable) !== !1 && (this.yCircle = new n({ direction: "y", color: l.Y })), (e == null ? void 0 : e.xyCircleEnable) !== !1 && (this.zCircle = new n({ direction: "z", color: l.Z })), e != null && e.container && (e == null ? void 0 : e.angleTipsEnable) !== !1 && (this.container = e == null ? void 0 : e.container, this.angleTips = y({ display: "none" }), this.container.appendChild(this.angleTips.element)), this.add(...[this.xCircle, this.yCircle, this.zCircle].filter(Boolean)), this.show();
+var x = Object.defineProperty;
+var M = (o, a, t) => a in o ? x(o, a, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[a] = t;
+var s = (o, a, t) => (M(o, typeof a != "symbol" ? a + "" : a, t), t);
+import * as e from "three";
+import { RotateHelperAbstract as A } from "../Base/BaseHelper.js";
+import { AXES_THREE_COLOR as w } from "../Constants/color.js";
+import { tipsDom as S } from "./HTML/tipsDom.js";
+import { calculateScaleByCamera as u } from "../utils/calculateScaleByCamera.js";
+class T extends A {
+  constructor(t, i) {
+    super(t, i);
+    s(this, "name", "RotateHelper");
+    s(this, "xCircle");
+    s(this, "yCircle");
+    s(this, "zCircle");
+    s(this, "children", []);
+    s(this, "angleTips");
+    s(this, "container");
+    (i == null ? void 0 : i.yzCircleEnable) !== !1 && (this.xCircle = new p({ direction: "x", color: w.X })), (i == null ? void 0 : i.xzCircleEnable) !== !1 && (this.yCircle = new p({ direction: "y", color: w.Y })), (i == null ? void 0 : i.xyCircleEnable) !== !1 && (this.zCircle = new p({ direction: "z", color: w.Z })), i != null && i.container && (i == null ? void 0 : i.angleTipsEnable) !== !1 && (this.container = i == null ? void 0 : i.container, this.angleTips = S({ display: "none" }), this.container.appendChild(this.angleTips.element)), this.add(...[this.xCircle, this.yCircle, this.zCircle].filter(Boolean)), this.show();
   }
   hide() {
     this.children.forEach((t) => t.hide());
   }
   show() {
     var t;
-    this.children.forEach((e) => e.showCircle()), (t = this.angleTips) == null || t.hide();
+    this.children.forEach((i) => i.showCircle()), (t = this.angleTips) == null || t.hide();
   }
   setScaleByCamera(t) {
-    this.scale.setScalar(C(t, this.position));
+    this.scale.setScalar(u(t, this.position));
+  }
+  update(t) {
+    if (t.type === "OrthographicCamera")
+      return;
+    const i = new e.Vector3(0, 0, -1).applyQuaternion(t.quaternion), h = new e.Vector3(1, 0, 0).applyQuaternion(this.quaternion), f = new e.Vector3(0, 1, 0).applyQuaternion(this.quaternion), g = new e.Vector3(0, 0, 1).applyQuaternion(this.quaternion), y = i.angleTo(h), C = i.angleTo(f), d = i.angleTo(g), m = Math.PI / 2, l = C >= m, c = d >= m, n = y >= m;
+    this.xCircle && (l && c ? this.xCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, 0, Math.PI / 2) : l && !c ? this.xCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI / 2, Math.PI / 2) : !l && c ? this.xCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI / 2 * 3, Math.PI / 2) : !l && !c && (this.xCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI, Math.PI / 2)), this.xCircle.angleSector && (this.xCircle.angleSector.offsetAngle = (r) => r, l && c ? this.xCircle.angleSector.baseAxes = new e.Vector3(0, 0, 1) : l && !c ? this.xCircle.angleSector.baseAxes = new e.Vector3(0, 0, 1) : !l && c ? (this.xCircle.angleSector.baseAxes = new e.Vector3(0, -1, 0), this.xCircle.angleSector.offsetAngle = (r) => r - Math.PI / 2) : !l && !c && (this.xCircle.angleSector.baseAxes = new e.Vector3(0, 0, -1), this.xCircle.angleSector.offsetAngle = (r) => r - Math.PI))), this.yCircle && (this.yCircle.angleSector.offsetAngle = (r) => r, n && c ? this.yCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, 0, Math.PI / 2) : n && !c ? this.yCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI / 2 * 3, Math.PI / 2) : !n && c ? this.yCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI / 2, Math.PI / 2) : !n && !c && (this.yCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI, Math.PI / 2)), n && c ? this.yCircle.angleSector.baseAxes = new e.Vector3(1, 0, 0) : n && !c ? (this.yCircle.angleSector.baseAxes = new e.Vector3(0, 0, -1), this.yCircle.angleSector.offsetAngle = (r) => r - Math.PI / 2) : !n && c ? (this.yCircle.angleSector.baseAxes = new e.Vector3(0, 0, 1), this.yCircle.angleSector.offsetAngle = (r) => r + Math.PI / 2) : !n && !c && (this.yCircle.angleSector.baseAxes = new e.Vector3(-1, 0, 0), this.yCircle.angleSector.offsetAngle = (r) => r + Math.PI)), this.zCircle && (this.zCircle.angleSector.offsetAngle = (r) => r, n && l ? this.zCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, 0, Math.PI / 2) : n && !l ? this.zCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI / 2 * 3, Math.PI / 2) : !n && l ? this.zCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI / 2, Math.PI / 2) : !n && !l && (this.zCircle.circle.geometry = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI, Math.PI / 2)), this.zCircle.angleSector && (n && l ? this.zCircle.angleSector.baseAxes = new e.Vector3(1, 0, 0) : n && !l ? (this.zCircle.angleSector.baseAxes = new e.Vector3(0, -1, 0), this.zCircle.angleSector.offsetAngle = (r) => r - Math.PI / 2) : !n && l ? (this.zCircle.angleSector.baseAxes = new e.Vector3(0, 1, 0), this.zCircle.angleSector.offsetAngle = (r) => r + Math.PI / 2) : !n && !l && (this.zCircle.angleSector.baseAxes = new e.Vector3(-1, 0, 0), this.zCircle.angleSector.offsetAngle = (r) => r + Math.PI)));
   }
   showDraggingHelper(t) {
-    var e;
-    this.hide(), this.children.filter((h) => t.includes(h.direction)).forEach((h) => h.showRing()), (e = this.angleTips) == null || e.show();
+    var i;
+    this.hide(), this.children.filter((h) => t.includes(h.direction)).forEach((h) => h.showRing()), (i = this.angleTips) == null || i.show();
   }
   dispose() {
-    var t, e;
-    this.removeFromParent(), (e = (t = this.angleTips) == null ? void 0 : t.element) == null || e.remove();
+    var t, i;
+    this.removeFromParent(), (i = (t = this.angleTips) == null ? void 0 : t.element) == null || i.remove();
   }
 }
-class n extends r.Group {
+class p extends e.Group {
   constructor(t) {
     super();
-    i(this, "direction");
+    s(this, "direction");
     /** 1/4 圆 */
-    i(this, "circle");
+    s(this, "circle");
     /** 旋转过程中展示的背景圆环 */
-    i(this, "ring");
+    s(this, "ring");
     /** 旋转过程中表示角度的扇形 */
-    i(this, "angleSector");
-    this.direction = t.direction, this.circle = new x(t), this.ring = new b(t), this.angleSector = new M(t), this.add(this.circle, this.ring, this.angleSector), this.direction === "y" ? this.rotateX(Math.PI / 2) : this.direction === "x" && this.rotateY(-Math.PI / 2);
+    s(this, "angleSector");
+    this.direction = t.direction, this.circle = new P(t), this.ring = new I(t), this.angleSector = new b(t), this.add(this.circle, this.ring, this.angleSector), this.direction === "y" ? this.rotation.x = Math.PI / 2 : this.direction === "x" && (this.rotation.y = -Math.PI / 2);
   }
   showCircle() {
     this.add(this.circle), this.remove(this.ring, this.angleSector);
@@ -59,73 +65,106 @@ class n extends r.Group {
     this.remove(this.ring, this.angleSector, this.circle);
   }
 }
-class x extends r.Mesh {
+class P extends e.Mesh {
   constructor(t) {
-    var e;
+    var i;
     super();
-    i(this, "direction");
-    i(this, "gapAngle", 0.02);
-    i(this, "geometry", new r.RingGeometry(0.25, 0.3, 20, 8, this.gapAngle, Math.PI / 2 - this.gapAngle * 2));
-    this.material = new r.MeshBasicMaterial({
+    s(this, "direction");
+    s(this, "gapAngle", 0.02);
+    s(this, "geometry", new e.RingGeometry(0.25, 0.3, 20, 8, this.gapAngle, Math.PI / 2 - this.gapAngle * 2));
+    this.material = new e.MeshBasicMaterial({
       opacity: 0.6,
-      color: (e = t.color) != null ? e : 16777215,
+      color: (i = t.color) != null ? i : 16777215,
       transparent: !0,
-      side: r.DoubleSide,
+      side: e.DoubleSide,
       depthTest: !1,
       depthWrite: !1
     }), this.renderOrder = 50, this.direction = t.direction, this.geometry.name = `RotateHelperCircleGeometry-${this.direction}`;
   }
 }
-class b extends r.Group {
+class I extends e.Group {
   constructor(t) {
     super();
-    i(this, "direction");
+    s(this, "direction");
     this.direction = t.direction;
-    const e = 0.015, h = new Array(8).fill(null).map((R, c) => {
-      const d = new r.RingGeometry(0.25, 0.3, 20, 8, Math.PI / 4 * c + e, Math.PI / 4 - e * 2), p = new r.MeshBasicMaterial({
+    const i = 0.015, h = new Array(8).fill(null).map((f, g) => {
+      const y = new e.RingGeometry(0.25, 0.3, 20, 8, Math.PI / 4 * g + i, Math.PI / 4 - i * 2), C = new e.MeshBasicMaterial({
         opacity: 1,
         color: 16777215,
         depthTest: !1,
         depthWrite: !1,
         transparent: !0,
-        side: r.DoubleSide
+        side: e.DoubleSide
       });
       this.renderOrder = 50;
-      const o = new r.Mesh(d, p);
-      return o.name = `AxesDashedRing-${this.direction}-${c}`, o;
+      const d = new e.Mesh(y, C);
+      return d.name = `AxesDashedRing-${this.direction}-${g}`, d;
     });
     this.add(...h);
   }
 }
-class M extends r.Mesh {
+class b extends e.Mesh {
   constructor(t) {
     var h;
     super();
-    i(this, "direction");
-    i(this, "baseAxes");
-    i(this, "angleDirection");
+    s(this, "direction");
+    s(this, "baseAxes");
+    s(this, "offsetAngle", (t) => t);
+    s(this, "angleDirection");
     switch (t.direction) {
       case "x":
-        this.baseAxes = new r.Vector3(0, 0, 1);
+        this.baseAxes = new e.Vector3(0, 0, 1);
         break;
       case "y":
-        this.baseAxes = new r.Vector3(1, 0, 0);
+        this.baseAxes = new e.Vector3(1, 0, 0);
         break;
       case "z":
-        this.baseAxes = new r.Vector3(1, 0, 0);
+        this.baseAxes = new e.Vector3(1, 0, 0);
         break;
     }
-    const e = 0.3 + 5e-4;
-    this.geometry = new r.CircleGeometry(e, 48, 0, 1e-4), this.material = new r.MeshBasicMaterial({
+    const i = 0.3 + 5e-4;
+    this.geometry = new e.CircleGeometry(i, 48, 0, 1e-4), this.material = new e.MeshBasicMaterial({
       opacity: 0.4,
       color: (h = t.color) != null ? h : 16777215,
       depthTest: !1,
       depthWrite: !1,
       transparent: !0,
-      side: r.DoubleSide
+      side: e.DoubleSide
     }), this.renderOrder = 50, this.direction = t.direction, this.angleDirection = this.direction === "z" ? 1 : -1;
   }
+  /**
+   * 设置扇形旋转方向为顺时针
+   */
+  setClockwiseDirection() {
+    this.angleDirection = -1;
+  }
+  /**
+   * 设置扇形旋转方向为逆时针
+   */
+  setCounterClockwiseDirection() {
+    this.angleDirection = 1;
+  }
+  /**
+   * 切换扇形旋转方向
+   */
+  toggleDirection() {
+    this.angleDirection = this.angleDirection === 1 ? -1 : 1;
+  }
+  /**
+   * 设置扇形的基础轴向
+   * @param axes 新的基础轴向向量
+   */
+  setBaseAxes(t) {
+    this.baseAxes = t.clone().normalize();
+  }
+  /**
+   * 获取当前旋转方向
+   * @returns 'clockwise' | 'counterclockwise'
+   */
+  getDirection() {
+    return this.angleDirection === -1 ? "clockwise" : "counterclockwise";
+  }
 }
 export {
-  D as RotateHelper
+  T as RotateHelper
 };

package/libs/shared-utils/Object3DHelper/Helper/ScaleHelper.d.ts

@@ -1,16 +1,61 @@
 import * as THREE from 'three';
 import { ScaleHelperAbstract, type BaseHelperConfig } from '../Base/BaseHelper';
 import type { ScalePosition } from '../typings';
+interface LineConnection {
+    line: THREE.Line;
+    mesh1: THREE.Object3D & {
+        scalePosition: ScalePosition;
+    };
+    mesh2: THREE.Object3D & {
+        scalePosition: ScalePosition;
+    };
+}
 export declare class ScaleHelper<T extends THREE.Object3D = THREE.Object3D> extends ScaleHelperAbstract<T> {
     name: string;
     scaleMeshes: Array<THREE.Object3D & {
         scalePosition: ScalePosition;
     }>;
+    lineConnections: Array<LineConnection>;
     private positions;
+    private container;
+    private needsInitialScaling;
+    private lastCamera;
+    private isInitializing;
     constructor(originObject3D: T, config?: {
         positions?: Array<ScalePosition> | (() => Array<ScalePosition>);
+        container?: HTMLElement | null;
     } & BaseHelperConfig);
     initQuaternion(): void;
     initialPosition(offset?: THREE.Vector3): void;
+    /**
+     * 清理所有缩放球
+     */
+    private clearAllSpheres;
+    /**
+     * 创建中心对称球之间的直线连接
+     */
+    private createLineConnections;
+    update(camera: THREE.Camera): void;
+    /**
+     * 应用球的缩放逻辑
+     */
+    private applySphereScaling;
+    /**
+     * 应用直线缩放逻辑（直线不需要特殊的缩放处理）
+     */
+    private applyLineScaling;
+    /**
+     * 显示所有直线连接
+     */
+    showLineConnections(): void;
+    /**
+     * 隐藏所有直线连接
+     */
+    hideLineConnections(): void;
+    /**
+     * 更新直线连接的位置和可见性
+     */
+    private updateLineConnections;
     setScaleByCamera(camera: THREE.PerspectiveCamera | THREE.OrthographicCamera): void;
 }
+export {};

package/libs/shared-utils/Object3DHelper/Helper/ScaleHelper.js

@@ -1,54 +1,202 @@
-var p = Object.defineProperty;
-var h = (i, t, e) => t in i ? p(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
-var c = (i, t, e) => (h(i, typeof t != "symbol" ? t + "" : t, e), e);
-import * as n from "three";
-import { ScaleHelperAbstract as d } from "../Base/BaseHelper.js";
-import { calculateScaleByCamera as u } from "../utils/calculateScaleByCamera.js";
-class S extends d {
-  constructor(e, s) {
-    super(e, s);
-    c(this, "name", "ScaleHelper");
-    c(this, "scaleMeshes", []);
-    c(this, "positions", []);
-    s && (this.positions = s.positions);
+var u = Object.defineProperty;
+var g = (a, r, e) => r in a ? u(a, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : a[r] = e;
+var l = (a, r, e) => (g(a, typeof r != "symbol" ? r + "" : r, e), e);
+import * as t from "three";
+import { ScaleHelperAbstract as S } from "../Base/BaseHelper.js";
+import { calculateScaleByCamera as b } from "../utils/calculateScaleByCamera.js";
+class Q extends S {
+  constructor(e, i) {
+    super(e, i);
+    l(this, "name", "ScaleHelper");
+    l(this, "scaleMeshes", []);
+    l(this, "lineConnections", []);
+    l(this, "positions", []);
+    l(this, "container");
+    l(this, "needsInitialScaling", !1);
+    l(this, "lastCamera", null);
+    l(this, "isInitializing", !1);
+    i && (this.positions = i.positions, this.container = i.container), this.raycast = () => {
+    };
   }
   initQuaternion() {
     this.quaternion.copy(this.originObject3D.quaternion);
   }
   initialPosition(e) {
-    this.position.copy(this.originObject3D.position);
-    const s = typeof this.positions == "function" ? this.positions() : this.positions;
-    s && (this.scaleMeshes = s.map((a, r) => {
-      var l;
-      const o = (l = this.scaleMeshes[r]) != null ? l : m();
-      return o.position.copy(a.handlePosition), o.scalePosition = a, this.addIfNotExists(o), o;
-    }));
+    if (this.isInitializing) {
+      console.warn("ScaleHelper: initialPosition called while already initializing, skipping");
+      return;
+    }
+    this.isInitializing = !0;
+    try {
+      this.position.copy(this.originObject3D.position);
+      const i = typeof this.positions == "function" ? this.positions() : this.positions;
+      if (!i) {
+        this.isInitializing = !1;
+        return;
+      }
+      this.clearAllSpheres(), this.scaleMeshes = i.map((s, n) => {
+        const o = y();
+        return o.position.copy(s.handlePosition), o.scalePosition = s, o.children.forEach((h) => {
+          h.scalePosition = s;
+        }), this.add(o), o;
+      }), this.createLineConnections(), this.needsInitialScaling = !0, this.lastCamera && (this.applySphereScaling(this.lastCamera), this.applyLineScaling(this.lastCamera), this.needsInitialScaling = !1);
+    } finally {
+      this.isInitializing = !1;
+    }
   }
-  setScaleByCamera(e) {
-    this.scaleMeshes.forEach((s) => {
-      s.scale.setScalar(
-        u(e, s.scalePosition.handlePosition.clone().applyMatrix4(this.matrixWorld))
+  /**
+   * 清理所有缩放球
+   */
+  clearAllSpheres() {
+    this.scaleMeshes.forEach((i) => {
+      this.remove(i);
+    }), this.scaleMeshes = [];
+    const e = this.children.filter((i) => i.name === "ScaleHelperSphere");
+    e.length > 0 && e.forEach((i) => {
+      this.remove(i);
+    });
+  }
+  /**
+   * 创建中心对称球之间的直线连接
+   */
+  createLineConnections() {
+    this.lineConnections.forEach((s) => {
+      this.remove(s.line);
+    }), this.lineConnections = [];
+    const e = {
+      top: "bottom",
+      bottom: "top",
+      left: "right",
+      right: "left",
+      front: "back",
+      back: "front"
+    }, i = /* @__PURE__ */ new Set();
+    for (const s of this.scaleMeshes) {
+      const n = s.scalePosition.id;
+      if (!n || i.has(n))
+        continue;
+      const o = e[n];
+      if (!o)
+        continue;
+      const h = this.scaleMeshes.find((m) => m.scalePosition.id === o);
+      if (!h)
+        continue;
+      const c = w(s.position.clone(), h.position.clone());
+      this.add(c), this.lineConnections.push({
+        line: c,
+        mesh1: s,
+        mesh2: h
+      }), i.add(n), i.add(o);
+    }
+  }
+  update(e) {
+    if (e.type !== "OrthographicCamera")
+      return;
+    const i = e.position.clone(), s = this.originObject3D.getWorldPosition(new t.Vector3()), n = i.sub(s).normalize(), o = {
+      front: new t.Vector3(0, 0, 1).applyQuaternion(this.originObject3D.getWorldQuaternion(new t.Quaternion())),
+      back: new t.Vector3(0, 0, -1).applyQuaternion(this.originObject3D.getWorldQuaternion(new t.Quaternion())),
+      left: new t.Vector3(-1, 0, 0).applyQuaternion(this.originObject3D.getWorldQuaternion(new t.Quaternion())),
+      right: new t.Vector3(1, 0, 0).applyQuaternion(this.originObject3D.getWorldQuaternion(new t.Quaternion())),
+      top: new t.Vector3(0, 1, 0).applyQuaternion(this.originObject3D.getWorldQuaternion(new t.Quaternion())),
+      bottom: new t.Vector3(0, -1, 0).applyQuaternion(this.originObject3D.getWorldQuaternion(new t.Quaternion()))
+    };
+    let h = -1, c = "";
+    Object.entries(o).forEach(([p, d]) => {
+      const f = n.dot(d);
+      f > h && (h = f, c = p);
+    });
+    const m = {
+      top: "bottom",
+      bottom: "top",
+      left: "right",
+      right: "left",
+      front: "back",
+      back: "front"
+    };
+    this.scaleMeshes.forEach((p) => {
+      const d = p.scalePosition.id, f = m[c];
+      d === c || d === f ? p.visible = !1 : p.visible = !0;
+    }), this.updateLineConnections(), this.lastCamera && (this.applySphereScaling(this.lastCamera), this.applyLineScaling(this.lastCamera));
+  }
+  /**
+   * 应用球的缩放逻辑
+   */
+  applySphereScaling(e) {
+    this.updateMatrixWorld(!0), this.scaleMeshes.forEach((i) => {
+      i.scale.setScalar(
+        b(e, i.scalePosition.handlePosition.clone().applyMatrix4(this.matrixWorld))
       );
     });
   }
+  /**
+   * 应用直线缩放逻辑（直线不需要特殊的缩放处理）
+   */
+  applyLineScaling(e) {
+  }
+  /**
+   * 显示所有直线连接
+   */
+  showLineConnections() {
+    this.lineConnections.forEach((e) => {
+      const i = e.mesh1.visible && e.mesh2.visible;
+      e.line.visible = i;
+    });
+  }
+  /**
+   * 隐藏所有直线连接
+   */
+  hideLineConnections() {
+    this.lineConnections.forEach((e) => {
+      e.line.visible = !1;
+    });
+  }
+  /**
+   * 更新直线连接的位置和可见性
+   */
+  updateLineConnections() {
+    this.lineConnections.forEach((e) => {
+      e.line.scale.set(1, 1, 1), e.line.position.set(0, 0, 0), e.line.rotation.set(0, 0, 0);
+      const s = e.line.geometry.attributes.position;
+      s.setXYZ(0, e.mesh1.position.x, e.mesh1.position.y, e.mesh1.position.z), s.setXYZ(1, e.mesh2.position.x, e.mesh2.position.y, e.mesh2.position.z), s.needsUpdate = !0;
+      const n = e.mesh1.visible && e.mesh2.visible;
+      e.line.visible = n;
+    });
+  }
+  setScaleByCamera(e) {
+    this.lastCamera = e, this.applySphereScaling(e), this.applyLineScaling(e), this.needsInitialScaling && requestAnimationFrame(() => {
+      this.applySphereScaling(e), this.applyLineScaling(e);
+    }), this.needsInitialScaling = !1;
+  }
 }
-function m() {
-  const i = new n.Group();
-  i.name = "ScaleHelperCube";
-  const t = 0.05, e = new n.BoxGeometry(t, t, t), s = new n.MeshBasicMaterial({
+function y() {
+  const a = new t.Group();
+  a.name = "ScaleHelperSphere";
+  const r = 0.03, e = new t.SphereGeometry(r, 16, 16), i = new t.MeshBasicMaterial({
     color: 16776960,
     transparent: !0,
-    side: n.DoubleSide
-  }), a = new n.MeshBasicMaterial({
+    side: t.DoubleSide
+  }), s = new t.MeshBasicMaterial({
     color: 16776960,
     opacity: 0.4,
     depthTest: !1,
     depthWrite: !1,
     transparent: !0,
-    side: n.DoubleSide
-  }), r = new n.Mesh(e, s), o = new n.Mesh(e, a);
-  return r.name = "ScaleHelperCube-front", o.name = "ScaleHelperCube-behind", r.renderOrder = 11, o.renderOrder = 10, i.add(r, o), i;
+    side: t.DoubleSide
+  }), n = new t.Mesh(e, i), o = new t.Mesh(e, s);
+  return n.name = "ScaleHelperSphere-front", o.name = "ScaleHelperSphere-behind", n.renderOrder = 11, o.renderOrder = 10, a.add(n, o), a;
+}
+function w(a, r) {
+  const e = new t.BufferGeometry(), i = [a, r];
+  e.setFromPoints(i);
+  const s = new t.LineBasicMaterial({
+    color: 16776960,
+    // 黄色，与球的颜色一致
+    transparent: !0,
+    opacity: 0.8
+  }), n = new t.Line(e, s);
+  return n.name = "ScaleHelperSolidLine", n.renderOrder = 9, n.raycast = () => {
+  }, n;
 }
 export {
-  S as ScaleHelper
+  Q as ScaleHelper
 };

package/libs/shared-utils/Object3DHelper/typings/Direction.d.ts

@@ -1,2 +1,2 @@
-export type Direction = 'x' | 'y' | 'z';
+export type Direction = 'x' | 'y' | 'z' | 'plane';
 export type Direction4 = 'nesw' | 'nwse' | 'ns' | 'ew';

package/libs/shared-utils/Object3DHelper/typings/Hooks.d.ts

@@ -14,6 +14,9 @@ export type HelperEventMap = {
     scaleEnd: () => void;
     moveByMouseEnable: () => void;
     moveByMouseDisable: () => void;
+    updateOtherHelpers: (params: {
+        camera: THREE.Camera;
+    }) => void;
 };
 export type InternalHelperEventMap = {
     initialHelperPosition: () => void;

package/libs/shared-utils/Object3DHelper/utils/dashGuide.d.ts

@@ -0,0 +1,56 @@
+import * as THREE from 'three';
+/** 将世界坐标投影为屏幕像素坐标 */
+export declare function projectToScreen(camera: THREE.Camera, container: HTMLElement | null | undefined, point: THREE.Vector3): THREE.Vector2;
+/** 估算某方向上线段的像素与世界长度的比例（世界单位/像素） */
+export declare function computeWorldPerPixel(camera: THREE.Camera, container: HTMLElement | null | undefined, center: THREE.Vector3, direction: THREE.Vector3): number;
+/** 计算虚线长度：随相机距离/视口变化自适应，限制在可视范围内 */
+export declare function computeGuideLength(camera: THREE.Camera, center: THREE.Vector3): number;
+export type ComputeParamsOptions = {
+    lengthFactorPx?: number;
+    dashPx?: number;
+    gapPx?: number;
+};
+/** 计算虚线总长度与像素目标（用于生成 LineSegments） */
+export declare function computeGuideParams(camera: THREE.Camera, container: HTMLElement | null | undefined, center: THREE.Vector3, direction: THREE.Vector3, options?: ComputeParamsOptions): {
+    length: number;
+    dashPx: number;
+    gapPx: number;
+};
+/** 基于像素恒定构建虚线段几何（返回 position attribute） */
+export type BuildSegmentsOptions = {
+    segmentsCap?: number;
+    wppClampFactor?: number;
+    expectedSegmentsSafety?: number;
+    expectedSegmentsMargin?: number;
+};
+export declare function buildDashSegments(camera: THREE.Camera, container: HTMLElement | null | undefined, center: THREE.Vector3, direction: THREE.Vector3, totalLength: number, dashPx: number, gapPx: number, options?: BuildSegmentsOptions): Float32Array;
+export type DashGuideOptions = ComputeParamsOptions & BuildSegmentsOptions & {
+    color?: number;
+    renderOrder?: number;
+};
+export declare class DashGuideLine {
+    private camera;
+    private container;
+    private defaults;
+    constructor(camera: THREE.Camera, container: HTMLElement | null | undefined, defaults?: DashGuideOptions);
+    /** 创建虚线（LineSegments + LineBasicMaterial），控制器负责添加到场景 */
+    create(center: THREE.Vector3, direction: THREE.Vector3, options?: DashGuideOptions): THREE.LineSegments<THREE.BufferGeometry, THREE.LineBasicMaterial>;
+    /** 更新已创建的虚线，使其保持像素恒定 */
+    update(segments: THREE.LineSegments<THREE.BufferGeometry, THREE.LineBasicMaterial>, center: THREE.Vector3, direction: THREE.Vector3, options?: DashGuideOptions): void;
+    /** 创建无限长直线（Line + LineBasicMaterial），穿过整个平面 */
+    createSolidLine(center: THREE.Vector3, direction: THREE.Vector3, options?: {
+        color?: number;
+        renderOrder?: number;
+    }): THREE.Line<THREE.BufferGeometry, THREE.LineBasicMaterial>;
+    /** 更新已创建的直线，使其始终穿过整个平面 */
+    updateSolidLine(line: THREE.Line<THREE.BufferGeometry, THREE.LineBasicMaterial>, center: THREE.Vector3, direction: THREE.Vector3, options?: {
+        color?: number;
+        renderOrder?: number;
+    }): void;
+    /** 计算"无限"直线的长度，确保穿过整个可视区域 */
+    private computeInfiniteLineLength;
+    /** 释放虚线的几何与材质 */
+    dispose(segments?: THREE.LineSegments<THREE.BufferGeometry, THREE.LineBasicMaterial> | THREE.Line<THREE.BufferGeometry, THREE.LineBasicMaterial>): void;
+    /** 更新默认配置 */
+    updateDefaults(options: DashGuideOptions): void;
+}