@needle-tools/engine 3.35.1-beta → 3.35.1-beta.1

package/dist/needle-engine.js

@@ -30203,13 +30203,13 @@ class Py {
 }
 r(Py, "eventListeners", /* @__PURE__ */ new Map());
 const oT = IA("debugdefines");
-kE('if(!globalThis[""3.35.1-beta""]) globalThis[""3.35.1-beta""] = "0.0.0";');
+kE('if(!globalThis[""3.35.1-beta.1""]) globalThis[""3.35.1-beta.1""] = "0.0.0";');
 kE('if(!globalThis[""undefined""]) globalThis[""undefined""] = "unknown";');
-kE('if(!globalThis[""Fri Mar 29 2024 11:35:51 GMT+0100 (GMT+01:00)""]) globalThis[""Fri Mar 29 2024 11:35:51 GMT+0100 (GMT+01:00)""] = "unknown";');
-kE('globalThis["__NEEDLE_ENGINE_VERSION__"] = "3.35.1-beta";');
+kE('if(!globalThis[""Fri Mar 29 2024 16:20:59 GMT+0100 (GMT+01:00)""]) globalThis[""Fri Mar 29 2024 16:20:59 GMT+0100 (GMT+01:00)""] = "unknown";');
+kE('globalThis["__NEEDLE_ENGINE_VERSION__"] = "3.35.1-beta.1";');
 kE('globalThis["__NEEDLE_ENGINE_GENERATOR__"] = "undefined";');
-kE('globalThis["__NEEDLE_PROJECT_BUILD_TIME__"] = "Fri Mar 29 2024 11:35:51 GMT+0100 (GMT+01:00)";');
-const sC = "3.35.1-beta", HR = "undefined", sT = "Fri Mar 29 2024 11:35:51 GMT+0100 (GMT+01:00)";
+kE('globalThis["__NEEDLE_PROJECT_BUILD_TIME__"] = "Fri Mar 29 2024 16:20:59 GMT+0100 (GMT+01:00)";');
+const sC = "3.35.1-beta.1", HR = "undefined", sT = "Fri Mar 29 2024 16:20:59 GMT+0100 (GMT+01:00)";
 oT && console.log(`Engine version: ${sC} (generator: ${HR})
 Project built at ${sT}`);
 const wa = "needle_isActiveInHierarchy", lQ = "builtin_components", Wp = "needle_editor_guid";
@@ -62651,7 +62651,11 @@ class Po {
     r(this, "rootMotionHandler");
     this.model = A, dI && console.log(this);
   }
-  /** Create an animatorcontroller with clips assigned */
+  /** Create an animatorcontroller. States are created from the clips array.
+   * @param clips the clips to assign to the controller
+   * @param options options to control the creation of the controller. 
+   * @returns the created animator controller
+  */
   static createFromClips(A, e = { looping: !1, autoTransition: !0, transitionDuration: 0 }) {
     const t = [];
     for (let o = 0; o < A.length; o++) {
@@ -62763,6 +62767,7 @@ class Po {
   isInTransition() {
     return this._activeStates.length > 1;
   }
+  /** Set the speed of the animator controller. Larger values will make the animation play faster. */
   setSpeed(A) {
     this._speed = A;
   }
@@ -63208,12 +63213,8 @@ class oI extends UA {
     r(this, "keepAnimatorControllerStateOnDisable", !1);
     r(this, "_parametersAreDirty", !1);
     r(this, "_isDirty", !1);
-    // set speed(val: number) {
-    //     // console.trace(val);
-    //     this.SetSpeed(val)
-    // }
-    r(this, "speed", 1);
-    r(this, "normalizedStartOffset", 0);
+    r(this, "_speed", 1);
+    r(this, "_normalizedStartOffset", 0);
     r(this, "_animatorController", null);
     // Why do we jump through hoops like this? It's because of the PlayableDirector and animation tracks
     // they NEED to use the same mixer when binding/creating the animation clips
@@ -63243,17 +63244,25 @@ class oI extends UA {
     var e;
     return ((e = this.runtimeAnimatorController) == null ? void 0 : e.currentAction) || null;
   }
+  /** @returns {boolean} True if parameters have been changed */
   get parametersAreDirty() {
     return this._parametersAreDirty;
   }
+  /** @returns {boolean} True if the animator has been changed */
   get isDirty() {
     return this._isDirty;
   }
-  // NOTE: the uppercase events have been deprecated because UnityEvent methods are all exported with lowercase first letter
-  /**@deprecated use play */
+  /**@deprecated use play() */
   Play(e, t = -1, i = Number.NEGATIVE_INFINITY, I = 0) {
     this.play(e, t, i, I);
   }
+  /** Plays an animation on the animator
+   * @param {string | number} name The name of the animation to play. Can also be the hash of the animation
+   * @param {number} layer The layer to play the animation on. Default is -1
+   * @param {number} normalizedTime The normalized time to start the animation at. Default is Number.NEGATIVE_INFINITY
+   * @param {number} transitionDurationInSec The duration of the transition to the new animation. Default is 0
+   * @returns {void}
+   * */
   play(e, t = -1, i = Number.NEGATIVE_INFINITY, I = 0) {
     var o;
     (o = this.runtimeAnimatorController) == null || o.play(e, t, i, I), this._isDirty = !0;
@@ -63262,6 +63271,7 @@ class oI extends UA {
   Reset() {
     this.reset();
   }
+  /** Resets the animatorcontroller */
   reset() {
     var e;
     (e = this._animatorController) == null || e.reset(), this._isDirty = !0;
@@ -63349,6 +63359,7 @@ class oI extends UA {
   IsInTransition() {
     return this.isInTransition();
   }
+  /** @returns `true` if the animator is currently in a transition */
   isInTransition() {
     var e;
     return ((e = this.runtimeAnimatorController) == null ? void 0 : e.isInTransition()) ?? !1;
@@ -63359,13 +63370,16 @@ class oI extends UA {
   }
   setSpeed(e) {
     var t;
-    e !== this.speed && (Go && console.log("setSpeed", e), this.speed = e, (t = this._animatorController) == null || t.setSpeed(e));
+    e !== this._speed && (Go && console.log("setSpeed", e), this._speed = e, ((t = this._animatorController) == null ? void 0 : t.animator) == this && this._animatorController.setSpeed(e));
   }
+  /** Will generate a random speed between the min and max values and set it to the animatorcontroller */
   set minMaxSpeed(e) {
-    this.speed = te.lerp(e.x, e.y, Math.random());
+    var t;
+    this._speed = te.lerp(e.x, e.y, Math.random()), ((t = this._animatorController) == null ? void 0 : t.animator) == this && this._animatorController.setSpeed(this._speed);
   }
   set minMaxOffsetNormalized(e) {
-    this.normalizedStartOffset = te.lerp(e.x, e.y, Math.random()), this.runtimeAnimatorController && (this.runtimeAnimatorController.normalizedStartOffset = this.normalizedStartOffset);
+    var t;
+    this._normalizedStartOffset = te.lerp(e.x, e.y, Math.random()), ((t = this.runtimeAnimatorController) == null ? void 0 : t.animator) == this && (this.runtimeAnimatorController.normalizedStartOffset = this._normalizedStartOffset);
   }
   awake() {
     Go && console.log("ANIMATOR", this.name, this), this.gameObject && this.initializeRuntimeAnimatorController();
@@ -63374,7 +63388,7 @@ class oI extends UA {
     const t = e || this.runtimeAnimatorController !== this._initializeWithRuntimeAnimatorController;
     if (this.runtimeAnimatorController && t) {
       const i = this.runtimeAnimatorController.clone();
-      this._initializeWithRuntimeAnimatorController = i, i ? (console.assert(this.runtimeAnimatorController !== i), this.runtimeAnimatorController = i, console.assert(this.runtimeAnimatorController === i), this.runtimeAnimatorController.bind(this), this.runtimeAnimatorController.setSpeed(this.speed), this.runtimeAnimatorController.normalizedStartOffset = this.normalizedStartOffset) : console.warn("Could not clone animator controller", this.runtimeAnimatorController);
+      this._initializeWithRuntimeAnimatorController = i, i ? (console.assert(this.runtimeAnimatorController !== i), this.runtimeAnimatorController = i, console.assert(this.runtimeAnimatorController === i), this.runtimeAnimatorController.bind(this), this.runtimeAnimatorController.setSpeed(this._speed), this.runtimeAnimatorController.normalizedStartOffset = this._normalizedStartOffset) : console.warn("Could not clone animator controller", this.runtimeAnimatorController);
     }
   }
   onDisable() {

package/dist/needle-engine.light.js

@@ -30203,13 +30203,13 @@ class Vb {
 }
 h(Vb, "eventListeners", /* @__PURE__ */ new Map());
 const SU = ne("debugdefines");
-tp('if(!globalThis[""3.35.1-beta""]) globalThis[""3.35.1-beta""] = "0.0.0";');
+tp('if(!globalThis[""3.35.1-beta.1""]) globalThis[""3.35.1-beta.1""] = "0.0.0";');
 tp('if(!globalThis[""undefined""]) globalThis[""undefined""] = "unknown";');
-tp('if(!globalThis[""Fri Mar 29 2024 11:36:02 GMT+0100 (GMT+01:00)""]) globalThis[""Fri Mar 29 2024 11:36:02 GMT+0100 (GMT+01:00)""] = "unknown";');
-tp('globalThis["__NEEDLE_ENGINE_VERSION__"] = "3.35.1-beta";');
+tp('if(!globalThis[""Fri Mar 29 2024 16:21:06 GMT+0100 (GMT+01:00)""]) globalThis[""Fri Mar 29 2024 16:21:06 GMT+0100 (GMT+01:00)""] = "unknown";');
+tp('globalThis["__NEEDLE_ENGINE_VERSION__"] = "3.35.1-beta.1";');
 tp('globalThis["__NEEDLE_ENGINE_GENERATOR__"] = "undefined";');
-tp('globalThis["__NEEDLE_PROJECT_BUILD_TIME__"] = "Fri Mar 29 2024 11:36:02 GMT+0100 (GMT+01:00)";');
-const ql = "3.35.1-beta", TT = "undefined", CU = "Fri Mar 29 2024 11:36:02 GMT+0100 (GMT+01:00)";
+tp('globalThis["__NEEDLE_PROJECT_BUILD_TIME__"] = "Fri Mar 29 2024 16:21:06 GMT+0100 (GMT+01:00)";');
+const ql = "3.35.1-beta.1", TT = "undefined", CU = "Fri Mar 29 2024 16:21:06 GMT+0100 (GMT+01:00)";
 SU && console.log(`Engine version: ${ql} (generator: ${TT})
 Project built at ${CU}`);
 const sh = "needle_isActiveInHierarchy", Wd = "builtin_components", c0 = "needle_editor_guid";
@@ -62651,7 +62651,11 @@ class Lo {
     h(this, "rootMotionHandler");
     this.model = e, cr && console.log(this);
   }
-  /** Create an animatorcontroller with clips assigned */
+  /** Create an animatorcontroller. States are created from the clips array.
+   * @param clips the clips to assign to the controller
+   * @param options options to control the creation of the controller. 
+   * @returns the created animator controller
+  */
   static createFromClips(e, t = { looping: !1, autoTransition: !0, transitionDuration: 0 }) {
     const i = [];
     for (let o = 0; o < e.length; o++) {
@@ -62763,6 +62767,7 @@ class Lo {
   isInTransition() {
     return this._activeStates.length > 1;
   }
+  /** Set the speed of the animator controller. Larger values will make the animation play faster. */
   setSpeed(e) {
     this._speed = e;
   }
@@ -63208,12 +63213,8 @@ class Ks extends Te {
     h(this, "keepAnimatorControllerStateOnDisable", !1);
     h(this, "_parametersAreDirty", !1);
     h(this, "_isDirty", !1);
-    // set speed(val: number) {
-    //     // console.trace(val);
-    //     this.SetSpeed(val)
-    // }
-    h(this, "speed", 1);
-    h(this, "normalizedStartOffset", 0);
+    h(this, "_speed", 1);
+    h(this, "_normalizedStartOffset", 0);
     h(this, "_animatorController", null);
     // Why do we jump through hoops like this? It's because of the PlayableDirector and animation tracks
     // they NEED to use the same mixer when binding/creating the animation clips
@@ -63243,17 +63244,25 @@ class Ks extends Te {
     var t;
     return ((t = this.runtimeAnimatorController) == null ? void 0 : t.currentAction) || null;
   }
+  /** @returns {boolean} True if parameters have been changed */
   get parametersAreDirty() {
     return this._parametersAreDirty;
   }
+  /** @returns {boolean} True if the animator has been changed */
   get isDirty() {
     return this._isDirty;
   }
-  // NOTE: the uppercase events have been deprecated because UnityEvent methods are all exported with lowercase first letter
-  /**@deprecated use play */
+  /**@deprecated use play() */
   Play(t, i = -1, n = Number.NEGATIVE_INFINITY, r = 0) {
     this.play(t, i, n, r);
   }
+  /** Plays an animation on the animator
+   * @param {string | number} name The name of the animation to play. Can also be the hash of the animation
+   * @param {number} layer The layer to play the animation on. Default is -1
+   * @param {number} normalizedTime The normalized time to start the animation at. Default is Number.NEGATIVE_INFINITY
+   * @param {number} transitionDurationInSec The duration of the transition to the new animation. Default is 0
+   * @returns {void}
+   * */
   play(t, i = -1, n = Number.NEGATIVE_INFINITY, r = 0) {
     var o;
     (o = this.runtimeAnimatorController) == null || o.play(t, i, n, r), this._isDirty = !0;
@@ -63262,6 +63271,7 @@ class Ks extends Te {
   Reset() {
     this.reset();
   }
+  /** Resets the animatorcontroller */
   reset() {
     var t;
     (t = this._animatorController) == null || t.reset(), this._isDirty = !0;
@@ -63349,6 +63359,7 @@ class Ks extends Te {
   IsInTransition() {
     return this.isInTransition();
   }
+  /** @returns `true` if the animator is currently in a transition */
   isInTransition() {
     var t;
     return ((t = this.runtimeAnimatorController) == null ? void 0 : t.isInTransition()) ?? !1;
@@ -63359,13 +63370,16 @@ class Ks extends Te {
   }
   setSpeed(t) {
     var i;
-    t !== this.speed && (Ao && console.log("setSpeed", t), this.speed = t, (i = this._animatorController) == null || i.setSpeed(t));
+    t !== this._speed && (Ao && console.log("setSpeed", t), this._speed = t, ((i = this._animatorController) == null ? void 0 : i.animator) == this && this._animatorController.setSpeed(t));
   }
+  /** Will generate a random speed between the min and max values and set it to the animatorcontroller */
   set minMaxSpeed(t) {
-    this.speed = et.lerp(t.x, t.y, Math.random());
+    var i;
+    this._speed = et.lerp(t.x, t.y, Math.random()), ((i = this._animatorController) == null ? void 0 : i.animator) == this && this._animatorController.setSpeed(this._speed);
   }
   set minMaxOffsetNormalized(t) {
-    this.normalizedStartOffset = et.lerp(t.x, t.y, Math.random()), this.runtimeAnimatorController && (this.runtimeAnimatorController.normalizedStartOffset = this.normalizedStartOffset);
+    var i;
+    this._normalizedStartOffset = et.lerp(t.x, t.y, Math.random()), ((i = this.runtimeAnimatorController) == null ? void 0 : i.animator) == this && (this.runtimeAnimatorController.normalizedStartOffset = this._normalizedStartOffset);
   }
   awake() {
     Ao && console.log("ANIMATOR", this.name, this), this.gameObject && this.initializeRuntimeAnimatorController();
@@ -63374,7 +63388,7 @@ class Ks extends Te {
     const i = t || this.runtimeAnimatorController !== this._initializeWithRuntimeAnimatorController;
     if (this.runtimeAnimatorController && i) {
       const n = this.runtimeAnimatorController.clone();
-      this._initializeWithRuntimeAnimatorController = n, n ? (console.assert(this.runtimeAnimatorController !== n), this.runtimeAnimatorController = n, console.assert(this.runtimeAnimatorController === n), this.runtimeAnimatorController.bind(this), this.runtimeAnimatorController.setSpeed(this.speed), this.runtimeAnimatorController.normalizedStartOffset = this.normalizedStartOffset) : console.warn("Could not clone animator controller", this.runtimeAnimatorController);
+      this._initializeWithRuntimeAnimatorController = n, n ? (console.assert(this.runtimeAnimatorController !== n), this.runtimeAnimatorController = n, console.assert(this.runtimeAnimatorController === n), this.runtimeAnimatorController.bind(this), this.runtimeAnimatorController.setSpeed(this._speed), this.runtimeAnimatorController.normalizedStartOffset = this._normalizedStartOffset) : console.warn("Could not clone animator controller", this.runtimeAnimatorController);
     }
   }
   onDisable() {