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

package/dist/{needle-engine.bundle-NtRy1Q8c.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 08:27:15 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 08:27:15 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);
@@ -20590,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);