@soonspacejs/plugin-transform-controls 2.15.1 → 2.15.4

package/dist/index.d.ts

@@ -3,6 +3,12 @@ import { Object3D } from 'three';
 import { TransformControls } from 'three/examples/jsm/controls/TransformControls.js';
 export interface StartOptions {
     mode?: 'translate' | 'rotate' | 'scale';
+    /**
+     * 限制对象移动范围的 Object3D（例如通过 ssp.getObjectById / ssp.loadModel 获得的对象）
+     * 插件会实时从该对象取其世界包围盒作为允许范围，
+     * 并在 objectChange 时按照被控对象世界 bbox 的半尺寸将对象 clamp 在其中
+     */
+    bounds?: Object3D;
     onUpdate?: (object: Object3D) => void;
     onDragStart?: (object: Object3D) => void;
     onDragEnd?: (object: Object3D) => void;
@@ -16,5 +22,9 @@ export default class TransformControlsPlugin {
     _getPreviousControl(): TransformControls | undefined;
     close(control?: TransformControls | undefined): void;
     closeAll(): void;
+    /**
+     * 动态更新指定控制器的移动范围来源对象（传 null 取消限制）
+     */
+    setBounds(control?: TransformControls | undefined, bounds?: Object3D | null): void;
     changeMode(control?: TransformControls | undefined, mode?: StartOptions['mode']): void;
 }

package/dist/index.esm.js

@@ -1,24 +1,32 @@
-import { Mesh as h } from "three";
-import { TransformControls as p } from "three/examples/jsm/controls/TransformControls.js";
-class f {
+import { Box3 as y, Vector3 as p, Matrix4 as E, Mesh as P } from "three";
+import { TransformControls as S } from "three/examples/jsm/controls/TransformControls.js";
+const u = new y(), o = new y(), h = new p(), f = new p(), r = new p(), i = new p(), x = new p(), l = new p(), d = new E(), c = /* @__PURE__ */ new WeakMap();
+function v(s, e) {
+  return e.setFromObject(s), e.isEmpty() && (s.getWorldPosition(e.min), e.max.copy(e.min)), e;
+}
+function w(s, e) {
+  v(e, o), v(s, u), u.getCenter(h), u.getSize(f).multiplyScalar(0.5), r.addVectors(o.min, f), i.subVectors(o.max, f), r.x > i.x && (r.x = i.x = (o.min.x + o.max.x) * 0.5), r.y > i.y && (r.y = i.y = (o.min.y + o.max.y) * 0.5), r.z > i.z && (r.z = i.z = (o.min.z + o.max.z) * 0.5), x.copy(h).clamp(r, i), l.subVectors(x, h), !(l.x === 0 && l.y === 0 && l.z === 0) && (s.parent && (s.parent.updateWorldMatrix(!0, !1), d.copy(s.parent.matrixWorld).invert(), d.elements[12] = 0, d.elements[13] = 0, d.elements[14] = 0, l.applyMatrix4(d)), s.position.add(l));
+}
+class V {
   constructor(e) {
     this.ssp = e;
   }
   controls = /* @__PURE__ */ new Set();
-  start(e, s = {}) {
-    const { mode: t = "translate", onUpdate: a, onDragStart: i, onDragEnd: d, onClose: l } = s, r = new p(
+  start(e, t = {}) {
+    const { mode: a = "translate", bounds: _, onUpdate: C, onDragStart: M, onDragEnd: z, onClose: B } = t, n = new S(
       this.ssp.viewport.camera,
       this.ssp.viewport.rendererManager.interactiveContainer
     );
-    this.controls.add(r), r.attach(e), r.mode = t, r.addEventListener("dragging-changed", (n) => {
-      this.ssp.controls.enabled = !n.value, n.value ? i?.(e) : d?.(e);
-    }), r.addEventListener("objectChange", () => {
-      a?.(e), this.ssp.signals.objectChanged.dispatch(e);
+    c.set(n, _ ?? null), this.controls.add(n), n.attach(e), n.mode = a, n.addEventListener("dragging-changed", (m) => {
+      this.ssp.controls.enabled = !m.value, m.value ? M?.(e) : z?.(e);
+    }), n.addEventListener("objectChange", () => {
+      const m = c.get(n) ?? null;
+      m && w(e, m), C?.(e), this.ssp.signals.objectChanged.dispatch(e);
     });
-    const o = r.getHelper();
-    return o.addEventListener("removed", () => {
-      l?.();
-    }), this.ssp.viewport.scene.add(o), this.ssp.render(), r;
+    const g = n.getHelper();
+    return g.addEventListener("removed", () => {
+      B?.();
+    }), this.ssp.viewport.scene.add(g), this.ssp.render(), n;
   }
   _getPreviousControl() {
     return [...this.controls].at(-1);
@@ -26,19 +34,25 @@ class f {
   close(e = this._getPreviousControl()) {
     if (e) {
       e.detach(), e.disconnect();
-      const s = e.getHelper();
-      s.traverse(function(t) {
-        t instanceof h && (t.geometry && t.geometry.dispose(), t.material && t.material.dispose());
-      }), this.ssp.removeObject(s), this.controls.delete(e);
+      const t = e.getHelper();
+      t.traverse(function(a) {
+        a instanceof P && (a.geometry && a.geometry.dispose(), a.material && a.material.dispose());
+      }), this.ssp.removeObject(t), c.delete(e), this.controls.delete(e);
     }
   }
   closeAll() {
     this.controls.forEach((e) => this.close(e)), this.controls.clear();
   }
-  changeMode(e = this._getPreviousControl(), s = "translate") {
-    e && e.mode !== s && (e.mode = s, this.ssp.signals.objectChanged.dispatch());
+  /**
+   * 动态更新指定控制器的移动范围来源对象（传 null 取消限制）
+   */
+  setBounds(e = this._getPreviousControl(), t = null) {
+    e && (c.set(e, t), t && w(e.object, t));
+  }
+  changeMode(e = this._getPreviousControl(), t = "translate") {
+    e && e.mode !== t && (e.mode = t, this.ssp.signals.objectChanged.dispatch());
   }
 }
 export {
-  f as default
+  V as default
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soonspacejs/plugin-transform-controls",
   "pluginName": "TransformControlsPlugin",
-  "version": "2.15.1",
+  "version": "2.15.4",
   "description": "Transform-controls plugin for SoonSpace.js",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",
@@ -15,6 +15,6 @@
   "license": "UNLICENSED",
   "gitHead": "4a87dd85050651088e11c3da777c49fab3db7e5d",
   "peerDependencies": {
-    "soonspacejs": "2.15.1"
+    "soonspacejs": "2.15.4"
   }
 }