@nebula-spatial/viewer 0.4.3 → 0.4.4

package/dist/{session-1duLyM88.js → session-c7xBLA4J.js}

@@ -1,7 +1,7 @@
 import { DataTexture as N, LinearMipmapLinearFilter as oe, LinearFilter as ae, LoadingManager as ie, Loader as le, Texture as X, TextureLoader as ce, LinearSRGBColorSpace as G, SRGBColorSpace as ue, RGBAFormat as K, UnsignedByteType as J, NoColorSpace as fe, Mesh as pe, MeshPhysicalMaterial as Q, MeshPhongMaterial as k, MeshLambertMaterial as de, Color as _, Quaternion as Z, Vector3 as ee, Group as he, Box3 as me } from "three";
 import { DRACOLoader as ge } from "three/examples/jsm/loaders/DRACOLoader.js";
 import { GLTFLoader as ye } from "three/examples/jsm/loaders/GLTFLoader.js";
-import { S as we, d as Y } from "./stage-BKqg5vNe.js";
+import { S as we, d as Y } from "./stage-D113SHD8.js";
 import { TGALoader as be } from "three/examples/jsm/loaders/TGALoader.js";
 import { FBXLoader as xe } from "three/examples/jsm/loaders/FBXLoader.js";
 import { unzlibSync as Ee } from "three/examples/jsm/libs/fflate.module.js";
@@ -177,7 +177,7 @@ async function Ae(e, t, n) {
     return l = new xe(m).parse(e, ""), await Promise.all(p), t.signal.throwIfAborted(), { root: l, textures: d };
   } catch (u) {
     if (s.abort(u), await Promise.allSettled(p), l) {
-      const { disposeModelResources: w } = await import("./stage-BKqg5vNe.js").then((f) => f.r);
+      const { disposeModelResources: w } = await import("./stage-D113SHD8.js").then((f) => f.r);
       w(l, d);
     } else for (const w of d) w.dispose();
     throw u;

package/dist/{stage-BKqg5vNe.js → stage-D113SHD8.js}

@@ -1,9 +1,9 @@
 var y = Object.defineProperty;
-var b = (u, t, e) => t in u ? y(u, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : u[t] = e;
-var a = (u, t, e) => b(u, typeof t != "symbol" ? t + "" : t, e);
-import * as o from "three";
-import { V as p } from "./index-BDo6voB2.js";
-const v = 1, M = (
+var b = (u, e, t) => e in u ? y(u, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : u[e] = t;
+var a = (u, e, t) => b(u, typeof e != "symbol" ? e + "" : e, t);
+import * as r from "three";
+import { V as g } from "./index-D-o1ODOX.js";
+const m = 1, M = (
   /* glsl */
   `
   uniform mat4 textureMatrix;
@@ -86,29 +86,29 @@ const v = 1, M = (
   }
 `
 );
-class P extends o.Mesh {
-  constructor({ size: e = 20, textureWidth: i = 512, textureHeight: r = 512 } = {}) {
-    const s = new o.Matrix4(), l = new o.WebGLRenderTarget(i, r, {
-      type: o.HalfFloatType,
-      minFilter: o.LinearFilter,
-      magFilter: o.LinearFilter,
-      format: o.RGBAFormat,
+class P extends r.Mesh {
+  constructor({ size: t = 20, textureWidth: i = 512, textureHeight: o = 512 } = {}) {
+    const s = new r.Matrix4(), l = new r.WebGLRenderTarget(i, o, {
+      type: r.HalfFloatType,
+      minFilter: r.LinearFilter,
+      magFilter: r.LinearFilter,
+      format: r.RGBAFormat,
       depthBuffer: !0,
       samples: 0
-    }), n = new o.ShaderMaterial({
+    }), n = new r.ShaderMaterial({
       uniforms: {
         tDiffuse: { value: l.texture },
         textureMatrix: { value: s },
-        resolution: { value: new o.Vector2(i, r) },
-        fineGridColor: { value: new o.Color(2502702) },
-        coarseGridColor: { value: new o.Color(7897726) },
+        resolution: { value: new r.Vector2(i, o) },
+        fineGridColor: { value: new r.Color(2502702) },
+        coarseGridColor: { value: new r.Color(7897726) },
         blurIntensity: { value: 1.7 },
         reflectionMix: { value: 0.07 },
         gridOpacity: { value: 1 },
         gridScale: { value: 0.2 },
-        groundCenter: { value: new o.Vector2() },
-        maxRadius: { value: e * 0.5 },
-        fadeSoftness: { value: e * 0.325 }
+        groundCenter: { value: new r.Vector2() },
+        maxRadius: { value: t * 0.5 },
+        fadeSoftness: { value: t * 0.325 }
       },
       vertexShader: M,
       fragmentShader: w,
@@ -117,7 +117,7 @@ class P extends o.Mesh {
       toneMapped: !0,
       fog: !1
     });
-    super(new o.PlaneGeometry(e, e), n);
+    super(new r.PlaneGeometry(t, t), n);
     a(this, "renderTarget");
     a(this, "textureMatrix");
     a(this, "virtualCamera");
@@ -132,11 +132,11 @@ class P extends o.Mesh {
     a(this, "view");
     a(this, "target");
     a(this, "q");
-    this.renderTarget = l, this.textureMatrix = s, this.virtualCamera = new o.PerspectiveCamera(), this.virtualCamera.layers.set(v), this.clipBias = 3e-3, this.frustumCulled = !1, this.renderOrder = 1, this.position.z = 2e-3, this.reflectorPlane = new o.Plane(), this.normal = new o.Vector3(), this.reflectorWorldPosition = new o.Vector3(), this.cameraWorldPosition = new o.Vector3(), this.rotationMatrix = new o.Matrix4(), this.lookAtPosition = new o.Vector3(0, 0, -1), this.clipPlane = new o.Vector4(), this.view = new o.Vector3(), this.target = new o.Vector3(), this.q = new o.Vector4();
+    this.renderTarget = l, this.textureMatrix = s, this.virtualCamera = new r.PerspectiveCamera(), this.virtualCamera.layers.set(m), this.clipBias = 3e-3, this.frustumCulled = !1, this.renderOrder = 1, this.position.z = 2e-3, this.reflectorPlane = new r.Plane(), this.normal = new r.Vector3(), this.reflectorWorldPosition = new r.Vector3(), this.cameraWorldPosition = new r.Vector3(), this.rotationMatrix = new r.Matrix4(), this.lookAtPosition = new r.Vector3(0, 0, -1), this.clipPlane = new r.Vector4(), this.view = new r.Vector3(), this.target = new r.Vector3(), this.q = new r.Vector4();
   }
-  renderReflection(e, i, r) {
-    if (this.reflectorWorldPosition.setFromMatrixPosition(this.matrixWorld), this.cameraWorldPosition.setFromMatrixPosition(r.matrixWorld), this.rotationMatrix.extractRotation(this.matrixWorld), this.normal.set(0, 0, 1).applyMatrix4(this.rotationMatrix), this.view.subVectors(this.reflectorWorldPosition, this.cameraWorldPosition), this.view.dot(this.normal) > 0) return;
-    this.view.reflect(this.normal).negate().add(this.reflectorWorldPosition), this.rotationMatrix.extractRotation(r.matrixWorld), this.lookAtPosition.set(0, 0, -1).applyMatrix4(this.rotationMatrix).add(this.cameraWorldPosition), this.target.subVectors(this.reflectorWorldPosition, this.lookAtPosition).reflect(this.normal).negate().add(this.reflectorWorldPosition), this.virtualCamera.position.copy(this.view), this.virtualCamera.up.set(0, 1, 0).applyMatrix4(this.rotationMatrix).reflect(this.normal), this.virtualCamera.lookAt(this.target), this.virtualCamera.near = r.near, this.virtualCamera.far = r.far, this.virtualCamera.updateMatrixWorld(), this.virtualCamera.projectionMatrix.copy(r.projectionMatrix), this.textureMatrix.set(
+  renderReflection(t, i, o) {
+    if (this.reflectorWorldPosition.setFromMatrixPosition(this.matrixWorld), this.cameraWorldPosition.setFromMatrixPosition(o.matrixWorld), this.rotationMatrix.extractRotation(this.matrixWorld), this.normal.set(0, 0, 1).applyMatrix4(this.rotationMatrix), this.view.subVectors(this.reflectorWorldPosition, this.cameraWorldPosition), this.view.dot(this.normal) > 0) return;
+    this.view.reflect(this.normal).negate().add(this.reflectorWorldPosition), this.rotationMatrix.extractRotation(o.matrixWorld), this.lookAtPosition.set(0, 0, -1).applyMatrix4(this.rotationMatrix).add(this.cameraWorldPosition), this.target.subVectors(this.reflectorWorldPosition, this.lookAtPosition).reflect(this.normal).negate().add(this.reflectorWorldPosition), this.virtualCamera.position.copy(this.view), this.virtualCamera.up.set(0, 1, 0).applyMatrix4(this.rotationMatrix).reflect(this.normal), this.virtualCamera.lookAt(this.target), this.virtualCamera.near = o.near, this.virtualCamera.far = o.far, this.virtualCamera.updateMatrixWorld(), this.virtualCamera.projectionMatrix.copy(o.projectionMatrix), this.textureMatrix.set(
       0.5,
       0,
       0,
@@ -166,31 +166,31 @@ class P extends o.Mesh {
       -1,
       (1 + s.elements[10]) / s.elements[14]
     ), this.clipPlane.multiplyScalar(2 / this.clipPlane.dot(this.q)), s.elements[2] = this.clipPlane.x, s.elements[6] = this.clipPlane.y, s.elements[10] = this.clipPlane.z + 1 - this.clipBias, s.elements[14] = this.clipPlane.w, this.virtualCamera.projectionMatrixInverse.copy(s).invert();
-    const l = e.getRenderTarget(), n = e.xr.enabled, c = e.shadowMap.autoUpdate, d = e.shadowMap.enabled;
+    const l = t.getRenderTarget(), n = t.xr.enabled, c = t.shadowMap.autoUpdate, d = t.shadowMap.enabled;
     try {
-      e.xr.enabled = !1, e.shadowMap.enabled = !1, e.shadowMap.autoUpdate = !1, e.setRenderTarget(this.renderTarget), e.state.buffers.depth.setMask(!0), e.clear(), e.render(i, this.virtualCamera);
+      t.xr.enabled = !1, t.shadowMap.enabled = !1, t.shadowMap.autoUpdate = !1, t.setRenderTarget(this.renderTarget), t.state.buffers.depth.setMask(!0), t.clear(), t.render(i, this.virtualCamera);
     } finally {
-      e.setRenderTarget(l), e.xr.enabled = n, e.shadowMap.enabled = d, e.shadowMap.autoUpdate = c;
+      t.setRenderTarget(l), t.xr.enabled = n, t.shadowMap.enabled = d, t.shadowMap.autoUpdate = c;
     }
   }
-  setRenderSize(e, i) {
-    this.renderTarget.setSize(e, i), this.material.uniforms.resolution.value.set(e, i);
+  setRenderSize(t, i) {
+    this.renderTarget.setSize(t, i), this.material.uniforms.resolution.value.set(t, i);
   }
   // Radius is in world units; the outer 65% fades before the square mesh edge.
-  setRadius(e, i, r = this.material.uniforms.groundCenter.value) {
-    this.scale.setScalar(e * 2 / this.geometry.parameters.width), this.position.x = r.x, this.position.y = r.y, this.material.uniforms.groundCenter.value.set(r.x, r.y), this.material.uniforms.gridScale.value = i, this.material.uniforms.maxRadius.value = e, this.material.uniforms.fadeSoftness.value = e * 0.65;
+  setRadius(t, i, o = this.material.uniforms.groundCenter.value) {
+    this.scale.setScalar(t * 2 / this.geometry.parameters.width), this.position.x = o.x, this.position.y = o.y, this.material.uniforms.groundCenter.value.set(o.x, o.y), this.material.uniforms.gridScale.value = i, this.material.uniforms.maxRadius.value = t, this.material.uniforms.fadeSoftness.value = t * 0.65;
   }
 }
-const g = {
+const v = {
   light: {
-    background: p.light,
+    background: g.light,
     fineGrid: 5859168,
     coarseGrid: 3427136,
     gridOpacity: 0.85,
     reflectionMix: 0.06
   },
   dark: {
-    background: p.dark,
+    background: g.dark,
     fineGrid: 7375236,
     coarseGrid: 5552554,
     gridOpacity: 0.9,
@@ -200,22 +200,22 @@ const g = {
   simulation: 0.68,
   model: 1.4
 };
-function x(u, t = []) {
+function x(u, e = []) {
   var l;
-  const e = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), r = new Set(t), s = /* @__PURE__ */ new Set();
+  const t = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), o = new Set(e), s = /* @__PURE__ */ new Set();
   u.traverse((n) => {
     const c = n;
-    c.geometry && e.add(c.geometry);
+    c.geometry && t.add(c.geometry);
     for (const d of Array.isArray(c.material) ? c.material : [c.material])
       if (d) {
         i.add(d);
         for (const h of Object.values(d))
-          S(h) && r.add(h);
+          S(h) && o.add(h);
       }
   });
-  for (const n of e) n.dispose();
+  for (const n of t) n.dispose();
   for (const n of i) n.dispose();
-  for (const n of r) {
+  for (const n of o) {
     const c = (l = n.source) == null ? void 0 : l.data;
     c && typeof c.close == "function" && s.add(c), n.dispose();
   }
@@ -224,27 +224,27 @@ function x(u, t = []) {
 function S(u) {
   return !!(u && typeof u == "object" && u.isTexture);
 }
-const F = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const V = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   disposeModelResources: x
 }, Symbol.toStringTag, { value: "Module" })), f = 2213822, G = 6000111, R = 6;
-function T(u, t, e) {
-  t.updateMatrixWorld();
-  const i = new o.Vector3();
-  return t.getWorldDirection(i).normalize(), u.setFromNormalAndCoplanarPoint(i, e);
+function T(u, e, t) {
+  e.updateMatrixWorld();
+  const i = new r.Vector3();
+  return e.getWorldDirection(i).normalize(), u.setFromNormalAndCoplanarPoint(i, t);
 }
 class W {
-  constructor(t, e = "dark", i, r = "simulation") {
-    a(this, "root", new o.Group());
+  constructor(e, t = "dark", i, o = "simulation") {
+    a(this, "root", new r.Group());
     a(this, "reflector", new P({ size: 100, textureWidth: 256, textureHeight: 256 }));
     a(this, "values");
     a(this, "fog");
-    a(this, "raycaster", new o.Raycaster());
-    a(this, "pointer", new o.Vector2());
-    a(this, "dragPlane", new o.Plane());
-    a(this, "dragTarget", new o.Vector3());
-    a(this, "dragIntersection", new o.Vector3());
-    a(this, "dragOffset", new o.Vector3());
+    a(this, "raycaster", new r.Raycaster());
+    a(this, "pointer", new r.Vector2());
+    a(this, "dragPlane", new r.Plane());
+    a(this, "dragTarget", new r.Vector3());
+    a(this, "dragIntersection", new r.Vector3());
+    a(this, "dragOffset", new r.Vector3());
     a(this, "bodyGroups", /* @__PURE__ */ new Map());
     a(this, "auxiliaries", /* @__PURE__ */ new Set());
     a(this, "forceLine");
@@ -254,24 +254,36 @@ class W {
     a(this, "size", "");
     a(this, "groundVisible");
     a(this, "disposed", !1);
-    this.model = t, this.runtime = i, this.presentation = r, this.values = g[e];
-    const s = this.values, l = new o.Box3().setFromObject(t), n = Math.max(...l.getSize(new o.Vector3()).toArray());
+    this.model = e, this.runtime = i, this.presentation = o, this.values = v[t];
+    const s = this.values, l = new r.Box3().setFromObject(e), n = Math.max(...l.getSize(new r.Vector3()).toArray());
     if (!Number.isFinite(n) || n <= 0) throw new Error("Empty simulation geometry.");
-    this.root.add(t), this.forceLine = this.createForceLine(), this.root.add(this.forceLine), t.traverse((m) => {
-      m instanceof o.Mesh && m.layers.enable(v);
+    this.root.add(e), this.forceLine = this.createForceLine(), this.root.add(this.forceLine), e.traverse((p) => {
+      p instanceof r.Mesh && p.layers.enable(m);
     }), this.root.add(this.reflector);
-    const c = Math.max(l.getSize(new o.Vector3()).length() * 0.5, 0.02), d = this.reflector.material.uniforms;
-    d.fineGridColor.value.setHex(s.fineGrid), d.coarseGridColor.value.setHex(s.coarseGrid), d.gridOpacity.value = s.gridOpacity, d.reflectionMix.value = s.reflectionMix, this.layoutGround(l, c), this.groundVisible = r === "simulation", this.setGroundVisible(this.groundVisible);
-    const h = c / Math.sin(o.MathUtils.degToRad(38) / 2) * 1.25;
-    this.fog = new o.Fog(s.background, h * 2.5, h * 8);
+    const c = Math.max(l.getSize(new r.Vector3()).length() * 0.5, 0.02), d = this.reflector.material.uniforms;
+    d.fineGridColor.value.setHex(s.fineGrid), d.coarseGridColor.value.setHex(s.coarseGrid), d.gridOpacity.value = s.gridOpacity, d.reflectionMix.value = s.reflectionMix, this.layoutGround(l, c), this.groundVisible = o === "simulation", this.setGroundVisible(this.groundVisible);
+    const h = c / Math.sin(r.MathUtils.degToRad(38) / 2) * 1.25;
+    this.fog = new r.Fog(s.background, h * 2.5, h * 8);
   }
-  setTheme(t) {
+  setRuntime(e) {
+    this.disposed || this.runtime === e || (this.endGrab(), this.runtime = e, this.bodyGroups.clear());
+  }
+  replaceModel(e, t = !0) {
+    this.disposed || e === this.model || (this.endGrab(), this.bodyGroups.clear(), this.model.removeFromParent(), this.model = e, this.root.add(e), e.traverse((i) => {
+      i instanceof r.Mesh && i.layers.enable(m);
+    }), t && this.reseatGround());
+  }
+  resetGround() {
+    var e;
+    this.disposed || (this.reflector.position.z = (((e = this.runtime) == null ? void 0 : e.defaultGroundHeight) ?? 0) + 2e-3);
+  }
+  setTheme(e) {
     if (this.disposed) return;
-    const e = this.values = g[t], i = this.reflector.material.uniforms;
-    i.fineGridColor.value.setHex(e.fineGrid), i.coarseGridColor.value.setHex(e.coarseGrid), i.gridOpacity.value = e.gridOpacity, i.reflectionMix.value = e.reflectionMix, this.fog.color.setHex(e.background);
+    const t = this.values = v[e], i = this.reflector.material.uniforms;
+    i.fineGridColor.value.setHex(t.fineGrid), i.coarseGridColor.value.setHex(t.coarseGrid), i.gridOpacity.value = t.gridOpacity, i.reflectionMix.value = t.reflectionMix, this.fog.color.setHex(t.background);
   }
-  layoutGround(t, e) {
-    this.reflector.setRadius(e * 8, Math.pow(10, Math.floor(Math.log10(Math.max(e, 0.01)))), t.getCenter(new o.Vector3()));
+  layoutGround(e, t) {
+    this.reflector.setRadius(t * 8, Math.pow(10, Math.floor(Math.log10(Math.max(t, 0.01)))), e.getCenter(new r.Vector3()));
   }
   /**
    * Re-fits the ground disc and reflection to the model's current world bounds.
@@ -282,113 +294,115 @@ class W {
   reseatGround() {
     if (this.disposed) return;
     this.root.updateMatrixWorld(!0);
-    const t = new o.Box3().setFromObject(this.model);
-    t.isEmpty() || this.layoutGround(t, Math.max(t.getSize(new o.Vector3()).length() * 0.5, 0.02));
+    const e = new r.Box3().setFromObject(this.model);
+    e.isEmpty() || this.layoutGround(e, Math.max(e.getSize(new r.Vector3()).length() * 0.5, 0.02));
   }
   createForceLine() {
-    const t = new o.BufferGeometry().setFromPoints([
-      new o.Vector3(),
-      new o.Vector3()
-    ]), e = new o.LineBasicMaterial({
+    const e = new r.BufferGeometry().setFromPoints([
+      new r.Vector3(),
+      new r.Vector3()
+    ]), t = new r.LineBasicMaterial({
       color: f,
       depthTest: !1,
       transparent: !0
-    }), i = new o.Line(t, e);
+    }), i = new r.Line(e, t);
     return i.renderOrder = 1e3, i.visible = !1, i;
   }
-  findBodyGroup(t) {
+  findBodyGroup(e) {
     var i;
-    let e = t;
-    for (; e && e !== this.model && e !== this.root; ) {
-      if (typeof ((i = e.userData) == null ? void 0 : i.bodyId) == "number") return e;
-      e = e.parent;
+    let t = e;
+    for (; t && t !== this.model && t !== this.root; ) {
+      if (typeof ((i = t.userData) == null ? void 0 : i.bodyId) == "number") return t;
+      t = t.parent;
     }
     return null;
   }
-  getBodyGroup(t) {
-    let e = this.bodyGroups.get(t);
-    return e || this.model.traverse((i) => {
-      var r;
-      ((r = i.userData) == null ? void 0 : r.bodyId) === t && (e = i, this.bodyGroups.set(t, i));
-    }), e;
+  getBodyGroup(e) {
+    let t = this.bodyGroups.get(e);
+    return t || this.model.traverse((i) => {
+      var o;
+      ((o = i.userData) == null ? void 0 : o.bodyId) === e && (t = i, this.bodyGroups.set(e, i));
+    }), t;
   }
-  pointerRay(t, e, i) {
-    const r = i.getBoundingClientRect();
+  pointerRay(e, t, i) {
+    const o = i.getBoundingClientRect();
     this.pointer.set(
-      (t.clientX - r.left) / r.width * 2 - 1,
-      -((t.clientY - r.top) / r.height) * 2 + 1
-    ), this.raycaster.setFromCamera(this.pointer, e);
+      (e.clientX - o.left) / o.width * 2 - 1,
+      -((e.clientY - o.top) / o.height) * 2 + 1
+    ), this.raycaster.setFromCamera(this.pointer, t);
   }
-  setForceBoost(t) {
-    var e;
-    !((e = this.runtime) != null && e.grab) || t === this.forceBoosted || (this.forceBoosted = t, this.runtime.updateGrabStrength(t ? R : 1), this.forceLine.material.color.setHex(t ? G : f));
+  setForceBoost(e) {
+    var t;
+    !((t = this.runtime) != null && t.grab) || e === this.forceBoosted || (this.forceBoosted = e, this.runtime.updateGrabStrength(e ? R : 1), this.forceLine.material.color.setHex(e ? G : f));
   }
-  beginGrab(t, e, i) {
+  beginGrab(e, t, i) {
     if (!this.runtime || this.disposed) return !1;
-    this.pointerRay(t, e, i);
-    const r = this.raycaster.intersectObject(this.model, !0).find((c) => c.object.isMesh);
-    if (!r) return !1;
-    const s = this.findBodyGroup(r.object);
+    this.pointerRay(e, t, i);
+    const o = this.raycaster.intersectObject(this.model, !0).find((c) => c.object.isMesh);
+    if (!o) return !1;
+    const s = this.findBodyGroup(o.object);
     if (!s) return !1;
-    const l = s.worldToLocal(r.point.clone());
-    this.dragTarget.copy(r.point), T(this.dragPlane, e, r.point), this.dragOffset.set(0, 0, 0);
-    const n = this.root.worldToLocal(r.point.clone());
+    const l = s.worldToLocal(o.point.clone());
+    this.dragTarget.copy(o.point), T(this.dragPlane, t, o.point), this.dragOffset.set(0, 0, 0);
+    const n = this.root.worldToLocal(o.point.clone());
     return this.bodyGroups.set(s.userData.bodyId, s), this.runtime.beginGrab({
       bodyId: s.userData.bodyId,
       localPoint: [l.x, l.y, l.z],
       target: [n.x, n.y, n.z]
-    }), this.forceBoosted = !1, this.setForceBoost(t.shiftKey), this.forceLine.visible = !0, this.updateForceLine(), this.grabCanvas = i, i != null && i.style && (this.previousCursor = i.style.cursor, i.style.cursor = "grabbing"), !0;
+    }), this.forceBoosted = !1, this.setForceBoost(e.shiftKey), this.forceLine.visible = !0, this.updateForceLine(), this.grabCanvas = i, i != null && i.style && (this.previousCursor = i.style.cursor, i.style.cursor = "grabbing"), !0;
   }
-  moveGrab(t, e, i) {
+  moveGrab(e, t, i) {
     var s;
     if (!((s = this.runtime) != null && s.grab)) return;
-    if (this.pointerRay(t, e, i), this.setForceBoost(t.shiftKey), i != null && i.style && i.style.cursor !== "grabbing" && (i.style.cursor = "grabbing"), this.raycaster.ray.intersectPlane(this.dragPlane, this.dragIntersection))
+    if (this.pointerRay(e, t, i), this.setForceBoost(e.shiftKey), i != null && i.style && i.style.cursor !== "grabbing" && (i.style.cursor = "grabbing"), this.raycaster.ray.intersectPlane(this.dragPlane, this.dragIntersection))
       this.dragTarget.copy(this.dragIntersection).add(this.dragOffset);
     else
       return;
-    const r = this.root.worldToLocal(this.dragTarget.clone());
-    this.runtime.updateGrabTarget([r.x, r.y, r.z]), this.updateForceLine();
+    const o = this.root.worldToLocal(this.dragTarget.clone());
+    this.runtime.updateGrabTarget([o.x, o.y, o.z]), this.updateForceLine();
   }
   endGrab() {
-    var t;
-    this.runtime && (this.runtime.endGrab(), this.forceBoosted = !1, this.forceLine.visible = !1, this.forceLine.material.color.setHex(f), (t = this.grabCanvas) != null && t.style && (this.grabCanvas.style.cursor = this.previousCursor), this.grabCanvas = null);
+    var e;
+    this.runtime && (this.runtime.endGrab(), this.forceBoosted = !1, this.forceLine.visible = !1, this.forceLine.material.color.setHex(f), (e = this.grabCanvas) != null && e.style && (this.grabCanvas.style.cursor = this.previousCursor), this.grabCanvas = null);
   }
   updateForceLine() {
     var n;
-    const t = (n = this.runtime) == null ? void 0 : n.grab;
-    if (!t) return;
-    const e = this.getBodyGroup(t.bodyId);
+    const e = (n = this.runtime) == null ? void 0 : n.grab;
     if (!e) return;
-    const i = new o.Vector3().fromArray(t.localPoint), r = e.localToWorld(i), s = this.root.worldToLocal(r), l = this.forceLine.geometry.attributes.position;
-    l.setXYZ(0, s.x, s.y, s.z), l.setXYZ(1, t.target[0], t.target[1], t.target[2]), l.needsUpdate = !0;
-  }
-  beforeRender(t, e, i) {
-    var l;
-    const r = {
-      tone: t.toneMapping,
-      exposure: t.toneMappingExposure,
-      color: t.outputColorSpace,
-      environment: e.environment,
-      fog: e.fog,
-      background: e.background
+    const t = this.getBodyGroup(e.bodyId);
+    if (!t) return;
+    const i = new r.Vector3().fromArray(e.localPoint), o = t.localToWorld(i), s = this.root.worldToLocal(o), l = this.forceLine.geometry.attributes.position;
+    l.setXYZ(0, s.x, s.y, s.z), l.setXYZ(1, e.target[0], e.target[1], e.target[2]), l.needsUpdate = !0;
+  }
+  beforeRender(e, t, i) {
+    var l, n;
+    const o = {
+      tone: e.toneMapping,
+      exposure: e.toneMappingExposure,
+      color: e.outputColorSpace,
+      environment: t.environment,
+      fog: t.fog,
+      background: t.background
     }, s = () => {
-      t.toneMapping = r.tone, t.toneMappingExposure = r.exposure, t.outputColorSpace = r.color, e.environment = r.environment, e.fog = r.fog, e.background = r.background;
+      e.toneMapping = o.tone, e.toneMappingExposure = o.exposure, e.outputColorSpace = o.color, t.environment = o.environment, t.fog = o.fog, t.background = o.background;
     };
     if (this.disposed) return s;
     try {
-      (l = this.runtime) != null && l.grab && this.updateForceLine(), t.toneMapping = o.ACESFilmicToneMapping, t.toneMappingExposure = C[this.presentation], t.outputColorSpace = o.SRGBColorSpace, e.background = new o.Color(this.values.background), e.fog = this.fog;
-      const n = t.getSize(new o.Vector2()), c = `${n.x}:${n.y}`;
-      return c !== this.size && (this.size = c, this.reflector.setRenderSize(Math.max(1, Math.floor(n.x * 0.35)), Math.max(1, Math.floor(n.y * 0.35)))), e.updateMatrixWorld(!0), i.updateMatrixWorld(!0), this.groundVisible && i instanceof o.PerspectiveCamera && this.reflector.renderReflection(t, e, i), s;
-    } catch (n) {
-      throw s(), n;
+      (l = this.runtime) != null && l.grab && this.updateForceLine();
+      const c = (n = this.runtime) == null ? void 0 : n.defaultGroundHeight;
+      c !== void 0 && (this.reflector.position.z = c + 2e-3), e.toneMapping = r.ACESFilmicToneMapping, e.toneMappingExposure = C[this.presentation], e.outputColorSpace = r.SRGBColorSpace, t.background = new r.Color(this.values.background), t.fog = this.fog;
+      const d = e.getSize(new r.Vector2()), h = `${d.x}:${d.y}`;
+      return h !== this.size && (this.size = h, this.reflector.setRenderSize(Math.max(1, Math.floor(d.x * 0.35)), Math.max(1, Math.floor(d.y * 0.35)))), t.updateMatrixWorld(!0), i.updateMatrixWorld(!0), this.groundVisible && i instanceof r.PerspectiveCamera && this.reflector.renderReflection(e, t, i), s;
+    } catch (c) {
+      throw s(), c;
     }
   }
   /**
    * The reflector mesh carries both the grid lines and the reflection. Hiding
    * it also skips the reflection render pass, which only feeds its shader.
    */
-  setGroundVisible(t) {
-    this.groundVisible = t, this.reflector.visible = t;
+  setGroundVisible(e) {
+    this.groundVisible = e, this.reflector.visible = e;
   }
   getGroundVisible() {
     return this.groundVisible;
@@ -399,20 +413,23 @@ class W {
    * so nesting hidden aids (collision meshes, which are far larger than the
    * visual shell) would inflate both the reflection extent and the camera fit.
    */
-  attachAuxiliary(t) {
-    this.auxiliaries.add(t), this.root.add(t);
+  attachAuxiliary(e) {
+    this.auxiliaries.add(e), this.root.add(e);
+  }
+  detachAuxiliary(e) {
+    this.auxiliaries.delete(e) && e.removeFromParent();
   }
   getModelBounds() {
     this.root.updateMatrixWorld(!0);
-    const t = new o.Box3().setFromObject(this.model);
-    if (!t.isEmpty()) return t;
-    const e = new o.Box3();
-    return e.min.set(-5e3, -5e3, -5e3), e.max.set(5e3, 5e3, 5e3), e;
+    const e = new r.Box3().setFromObject(this.model);
+    if (!e.isEmpty()) return e;
+    const t = new r.Box3();
+    return t.min.set(-5e3, -5e3, -5e3), t.max.set(5e3, 5e3, 5e3), t;
   }
   dispose() {
     if (!this.disposed) {
       this.disposed = !0, this.endGrab(), this.model.removeFromParent();
-      for (const t of this.auxiliaries) t.removeFromParent();
+      for (const e of this.auxiliaries) e.removeFromParent();
       this.auxiliaries.clear(), this.root.removeFromParent(), this.reflector.renderTarget.dispose(), x(this.root);
     }
   }
@@ -420,5 +437,5 @@ class W {
 export {
   W as S,
   x as d,
-  F as r
+  V as r
 };

package/dist/types.d.ts

@@ -88,6 +88,8 @@ export interface ViewerFitViewOptions {
     viewMode?: ViewerViewMode;
 }
 export interface ViewerPickOptions {
+    /** Stop at the nearest intersection when accelerated picking is available. */
+    firstHitOnly?: boolean;
     roots?: readonly Object3D[];
     recursive?: boolean;
     includeInvisible?: boolean;

package/dist/ui/types.d.ts

@@ -33,6 +33,8 @@ export interface ViewerUiOptions {
     cad?: ViewerCadUiOptions;
     /** Shared scene controls for model and simulation assets, gated by capabilities. */
     scene?: ViewerSceneUiOptions;
+    /** Built-in URDF review workbench. Defaults to true for preset 'auto'. */
+    urdf?: boolean;
 }
 export interface ViewerUiTokens {
     accent?: string;