@needle-tools/engine 4.8.8-next.aa09526 → 4.8.8-next.db5fdbd

package/dist/{needle-engine.bundle-xO7DnXAE.js → needle-engine.bundle-COsyGTEY.js}

@@ -1765,9 +1765,9 @@ fo('if(!globalThis["NEEDLE_PROJECT_BUILD_TIME"]) globalThis["NEEDLE_PROJECT_BUIL
 fo('if(!globalThis["NEEDLE_PUBLIC_KEY"]) globalThis["NEEDLE_PUBLIC_KEY"] = "unknown";');
 fo('globalThis["__NEEDLE_ENGINE_VERSION__"] = "4.8.8";');
 fo('globalThis["__NEEDLE_ENGINE_GENERATOR__"] = "undefined";');
-fo('globalThis["__NEEDLE_PROJECT_BUILD_TIME__"] = "Thu Sep 04 2025 07:54:57 GMT+0000 (Coordinated Universal Time)";');
+fo('globalThis["__NEEDLE_PROJECT_BUILD_TIME__"] = "Fri Sep 05 2025 14:22:32 GMT+0000 (Coordinated Universal Time)";');
 fo('globalThis["__NEEDLE_PUBLIC_KEY__"] = "' + NEEDLE_PUBLIC_KEY + '";');
-const En = "4.8.8", Cm = "undefined", Gb = "Thu Sep 04 2025 07:54:57 GMT+0000 (Coordinated Universal Time)";
+const En = "4.8.8", Cm = "undefined", Gb = "Fri Sep 05 2025 14:22:32 GMT+0000 (Coordinated Universal Time)";
 Hb && console.log(`Engine version: ${En} (generator: ${Cm})
 Project built at ${Gb}`);
 const bl = NEEDLE_PUBLIC_KEY, oo = "needle_isActiveInHierarchy", Br = "builtin_components", Mh = "needle_editor_guid";
@@ -4240,7 +4240,7 @@ class Oa {
     return this.applyDefaultObjectOptions(n, e), n;
   }
   static applyDefaultObjectOptions(e, t) {
-    e.receiveShadow = !0, e.castShadow = !0, t?.name && (e.name = t.name), t?.position && (Array.isArray(t.position) ? e.position.set(t.position[0], t.position[1], t.position[2]) : e.position.set(t.position.x, t.position.y, t.position.z)), t?.rotation && (Array.isArray(t.rotation) ? e.rotation.set(t.rotation[0], t.rotation[1], t.rotation[2]) : e.rotation.set(t.rotation.x, t.rotation.y, t.rotation.z)), t?.scale && (typeof t.scale == "number" ? e.scale.set(t.scale, t.scale, t.scale) : Array.isArray(t.scale) ? e.scale.set(t.scale[0], t.scale[1], t.scale[2]) : e.scale.set(t.scale.x, t.scale.y, t.scale.z)), t?.receiveShadow != null && (e.receiveShadow = t.receiveShadow), t?.castShadow != null && (e.castShadow = t.castShadow), t?.parent && t.parent.add(e);
+    e.receiveShadow = !0, e.castShadow = !0, t?.name && (e.name = t.name), t?.position && (Array.isArray(t.position) ? e.position.set(t.position[0], t.position[1], t.position[2]) : e.position.set(t.position.x || 0, t.position.y || 0, t.position.z || 0)), t?.rotation && (Array.isArray(t.rotation) ? e.rotation.set(t.rotation[0], t.rotation[1], t.rotation[2]) : e.rotation.set(t.rotation.x || 0, t.rotation.y || 0, t.rotation.z || 0)), t?.scale && (typeof t.scale == "number" ? e.scale.set(t.scale, t.scale, t.scale) : Array.isArray(t.scale) ? e.scale.set(t.scale[0], t.scale[1], t.scale[2]) : e.scale.set(t.scale.x || 1, t.scale.y || 1, t.scale.z || 1)), t?.receiveShadow != null && (e.receiveShadow = t.receiveShadow), t?.castShadow != null && (e.castShadow = t.castShadow), t?.parent && t.parent.add(e);
   }
 }
 function P1(s, e, t, i, n) {
@@ -11184,13 +11184,25 @@ Possible solutions:
    * Set a rect or dom element. The camera center will be moved to the center of the rect.  
    * This is useful if you have Needle Engine embedded in a HTML layout and while you want the webgl background to fill e.g. the whole screen you want to move the camera center to free space.  
    * For that you can simply pass in the rect or HMTL div that you want the camera to center on.
+   * @param rect The focus rect or null to disable
+   * @param settings Optional settings for the focus rect. These will override the `focusRectSettings` property
    */
-  setCameraFocusRect(e) {
-    this._focusRect = e;
+  setCameraFocusRect(e, t) {
+    this._focusRect = e, t && Object.assign(this.focusRectSettings, t);
   }
   get focusRect() {
     return this._focusRect;
   }
+  /** Settings when a focus rect is set. Use `setCameraFocusRect(...)` to do so.  
+   * This can be used to offset the renderer center e.g. to a specific DOM element.
+   */
+  focusRectSettings = {
+    /** Controls how fast the rect is centered. Smaller values mean the rect is centered faster.   
+     * A minimum value of 0 means the rect is centered instantly.
+     * @default .05
+    */
+    damping: 0.05
+  };
   _focusRect = null;
   _lastTimestamp = 0;
   _accumulatedTime = 0;
@@ -11264,7 +11276,11 @@ Possible solutions:
       2
       /* LateUpdate */
     ), this.physicsSteps === void 0 && (this.physicsSteps = 1), this.physics.engine && this.physicsSteps > 0 && this.internalUpdatePhysics(this.physicsSteps), this.isVisibleToUser || this.runInBackground) {
-      this._focusRect && this.mainCamera instanceof me && CC(this._focusRect, this.time.deltaTime / 0.05, this.mainCamera, this.renderer), this._currentFrameEvent = 3;
+      if (this._focusRect && this.mainCamera instanceof me) {
+        const n = this.focusRectSettings, o = n.damping > 0 ? this.time.deltaTime / n.damping : 1;
+        CC(this._focusRect, o, this.mainCamera, this.renderer);
+      }
+      this._currentFrameEvent = 3;
       for (let n = 0; n < this.scripts_onBeforeRender.length; n++) {
         const o = this.scripts_onBeforeRender[n];
         o.activeAndEnabled && o.onBeforeRender !== void 0 && (U.Current = this, o.onBeforeRender(t));
@@ -16321,7 +16337,7 @@ class ye extends T {
       return;
     }
     let i;
-    if (Array.isArray(e) ? i = e : e && "type" in e ? i = e.children : e && typeof e == "object" && !(e instanceof M) && !Array.isArray(e) && (t = e, i = t.objects), i && !Array.isArray(i) && (i = i.children), (!Array.isArray(i) || i && i.length <= 0) && (i = this.context.scene.children), !Array.isArray(i) || i.length <= 0) {
+    if (Array.isArray(e) || e && "type" in e ? i = e : e && typeof e == "object" && !(e instanceof M) && !Array.isArray(e) && (t = e, i = t.objects), i && !Array.isArray(i) && (i = [i]), (!Array.isArray(i) || i && i.length <= 0) && (i = this.context.scene.children), !Array.isArray(i) || i.length <= 0) {
       console.warn("No objects to fit camera to...");
       return;
     }
@@ -16332,9 +16348,9 @@ class ye extends T {
     }
     t || (t = {});
     const { immediate: r = !1, centerCamera: a, cameraNearFar: l = "auto", fitOffset: c = 1.1, fov: h = n?.fov } = t, d = new b(), f = new b(), p = _i(i, void 0, this._camera?.threeCamera?.layers), g = p.clone();
-    n.updateMatrixWorld(), n.updateProjectionMatrix(), p.getCenter(f);
+    p.getCenter(f);
     const _ = new b();
-    if (p.getSize(_), p.applyMatrix4(n.matrixWorldInverse), p.getSize(d), p.setFromCenterAndSize(f, d), Number.isNaN(d.x) || Number.isNaN(d.y) || Number.isNaN(d.z)) {
+    if (p.getSize(_), n.updateMatrixWorld(), p.applyMatrix4(n.matrixWorldInverse), p.getSize(d), p.setFromCenterAndSize(f, d), Number.isNaN(d.x) || Number.isNaN(d.y) || Number.isNaN(d.z)) {
       console.warn("Camera fit size resultet in NaN", n, p, [...i]);
       return;
     }
@@ -16347,10 +16363,10 @@ class ye extends T {
     const O = 0.05, k = f.clone();
     if (k.y -= d.y * O, t.targetOffset && (t.targetOffset.x !== void 0 && (k.x += t.targetOffset.x), t.targetOffset.y !== void 0 && (k.y += t.targetOffset.y), t.targetOffset.z !== void 0 && (k.z += t.targetOffset.z)), t.relativeTargetOffset && (t.relativeTargetOffset.x !== void 0 && (k.x += t.relativeTargetOffset.x * d.x), t.relativeTargetOffset.y !== void 0 && (k.y += t.relativeTargetOffset.y * d.y), t.relativeTargetOffset.z !== void 0 && (k.z += t.relativeTargetOffset.z * d.z)), this.setLookTargetPosition(k, r), this.setFieldOfView(t.fov, r), l == null || l == "auto") {
       const W = S.findObjectOfType(Ms), X = W ? W.radius : 0, A = Math.max(_.x, _.y, _.z, X);
-      n.near = I / 100, n.far = A + I * 10, W && (this.maxZoom = Math.max(Math.min(this.maxZoom, X * 0.5), I));
+      n.near = I / 100, n.far = A + I * 10, n.updateProjectionMatrix(), W && (this.maxZoom = Math.max(Math.min(this.maxZoom, X * 0.5), I));
     }
     const E = o.getDistance();
-    E < this.minZoom && (this.minZoom = E * 0.9), E > this.maxZoom && (this.maxZoom = E * 1.1), n.updateMatrixWorld(), n.updateProjectionMatrix();
+    E < this.minZoom && (this.minZoom = E * 0.9), E > this.maxZoom && (this.maxZoom = E * 1.1);
     const B = f.clone();
     t.fitDirection ? B.sub(new b().copy(t.fitDirection).multiplyScalar(1e6)) : B.sub(n.worldPosition), a === "y" && (B.y = 0), B.normalize(), B.multiplyScalar(I), a === "y" && (B.y += -O * 4 * I);
     let L = f.clone().sub(B);
@@ -18662,18 +18678,18 @@ const vr = class Cl extends T {
    * @param context The context to create the contact shadows in.
    * @returns The instance of the contact shadows.
    */
-  static auto(e) {
+  static auto(e, t) {
     if (e || (e = U.Current), !e)
       throw new Error("No context provided and no current context set.");
-    let t = this._instances.get(e);
-    if (!t || t.destroyed) {
-      const i = new M();
-      t = An(i, Cl, {
+    let i = this._instances.get(e);
+    if (!i || i.destroyed) {
+      const n = new M();
+      i = An(n, Cl, {
         autoFit: !1,
         occludeBelowGround: !1
-      }), this._instances.set(e, t);
+      }), this._instances.set(e, i);
     }
-    return e.scene.add(t.gameObject), t.fitShadows(), t;
+    return e.scene.add(i.gameObject), i.fitShadows(t), i;
   }
   autoFit = !1;
   darkness = 0.5;
@@ -18683,11 +18699,13 @@ const vr = class Cl extends T {
   backfaceShadows = !0;
   /**
    * The minimum size of the shadows box
+   * @default undefined
    */
   minSize;
   /**
    * When enabled the shadows will not be updated automatically. Use `needsUpdate()` to update the shadows manually.
    * This is useful when you want to update the shadows only when the scene changes.
+   * @default false
    */
   manualUpdate = !1;
   /**
@@ -18719,12 +18737,12 @@ const vr = class Cl extends T {
   /**
    * Call to fit the shadows to the scene.
    */
-  fitShadows() {
+  fitShadows(e = {}) {
     sl && console.warn("Fitting shadows to scene"), hp(this.shadowsRoot, !1);
-    const e = _i(this.context.scene.children, [this.shadowsRoot]), t = Math.max(1, this.blur / 32), i = e.max.x - e.min.x, n = e.max.z - e.min.z;
-    e.expandByVector(new b(t * i, 0, t * n)), sl && z.DrawWireBox3(e, 16776960, 60), this.gameObject.parent && e.applyMatrix4(this.gameObject.parent.matrixWorld.clone().invert());
-    const o = e.min, r = Math.max(1e-5, (e.max.y - o.y) * 2e-3);
-    e.max.y += r, this.shadowsRoot.position.set((o.x + e.max.x) / 2, o.y - r, (o.z + e.max.z) / 2), this.shadowsRoot.scale.set(e.max.x - o.x, e.max.y - o.y, e.max.z - o.z), this.applyMinSize(), this.shadowsRoot.matrixWorldNeedsUpdate = !0, sl && console.log("Fitted shadows to scene", this.shadowsRoot.scale.clone());
+    const t = e.object || this.context.scene, i = _i(t, [this.shadowsRoot]), n = Math.max(1, this.blur / 32), o = i.max.x - i.min.x, r = i.max.z - i.min.z;
+    i.expandByVector(new b(n * o, 0, n * r)), sl && z.DrawWireBox3(i, 16776960, 60), this.gameObject.parent && i.applyMatrix4(this.gameObject.parent.matrixWorld.clone().invert());
+    const a = i.min, l = Math.max(1e-5, (i.max.y - a.y) * 2e-3);
+    i.max.y += l, this.shadowsRoot.position.set((a.x + i.max.x) / 2, a.y - l, (a.z + i.max.z) / 2), this.shadowsRoot.scale.set(i.max.x - a.x, i.max.y - a.y, i.max.z - a.z), e.positionOffset && (e.positionOffset.x !== void 0 && (this.shadowsRoot.position.x += e.positionOffset.x), e.positionOffset.y !== void 0 && (this.shadowsRoot.position.y += e.positionOffset.y), e.positionOffset.z !== void 0 && (this.shadowsRoot.position.z += e.positionOffset.z)), e.scaleFactor && (e.scaleFactor.x !== void 0 && (this.shadowsRoot.scale.x *= e.scaleFactor.x), e.scaleFactor.y !== void 0 && (this.shadowsRoot.scale.y *= e.scaleFactor.y), e.scaleFactor.z !== void 0 && (this.shadowsRoot.scale.z *= e.scaleFactor.z)), this.applyMinSize(), this.shadowsRoot.matrixWorldNeedsUpdate = !0, sl && console.log("Fitted shadows to scene", this.shadowsRoot.scale.clone());
   }
   /** @internal */
   awake() {
@@ -20588,7 +20606,7 @@ class Fp extends T {
       }
     } else
       this._ambientLightObj && this._ambientLightObj.removeFromParent(), this._hemisphereLightObj && this._hemisphereLightObj.removeFromParent();
-    this.sourceId && this.context.sceneLighting.internalEnableReflection(this.sourceId);
+    this.sourceId && (this.context.domElement.getAttribute("environment-image") || this.context.sceneLighting.internalEnableReflection(this.sourceId));
   }
   onDisable() {
     Nr && console.warn("💡⚫ <<< Disable lighting:", this.sourceId, this), this._ambientLightObj && this._ambientLightObj.removeFromParent(), this._hemisphereLightObj && this._hemisphereLightObj.removeFromParent(), this.sourceId && this.context.sceneLighting.internalDisableReflection(this.sourceId);