@vived/core 1.4.2 → 1.4.4

package/dist/esm/Entities/MemoizedNumber.js

@@ -1,16 +1,37 @@
+/**
+ * A wrapper class for numeric values that tracks changes and triggers callbacks.
+ * Only triggers the callback when the value actually changes.
+ */
 export class MemoizedNumber {
+    /**
+     * Gets the current numeric value
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the numeric value and triggers the onChange callback if the value changed
+     * @param b - The new numeric value
+     */
     set val(b) {
         if (this._val === b)
             return;
         this._val = b;
         this.onChangeCallback();
     }
+    /**
+     * Sets the value without triggering the onChange callback
+     * @param val - The new numeric value
+     */
     setValQuietly(val) {
         this._val = val;
     }
+    /**
+     * Creates a new MemoizedNumber instance
+     *
+     * @param initialValue - The initial numeric value
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(initialValue, onChangeCallback) {
         this._val = initialValue;
         this.onChangeCallback = onChangeCallback;

package/dist/esm/Entities/MemoizedNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedNumber.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedNumber.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAc;IAEzB,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,CAAS;QACf,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE5B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,GAAW;QAC9B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID,YAAY,YAAoB,EAAE,gBAA4B;QAC5D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["export class MemoizedNumber {\r\n  private _val: number;\r\n  get val(): number {\r\n    return this._val;\r\n  }\r\n  set val(b: number) {\r\n    if (this._val === b) return;\r\n\r\n    this._val = b;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  public setValQuietly(val: number) {\r\n    this._val = val;\r\n  }\r\n  \r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(initialValue: number, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MemoizedNumber.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedNumber.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,cAAc;IAGzB;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAS;QACf,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE5B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,GAAW;QAC9B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID;;;;;OAKG;IACH,YAAY,YAAoB,EAAE,gBAA4B;QAC5D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["/**\r\n * A wrapper class for numeric values that tracks changes and triggers callbacks.\r\n * Only triggers the callback when the value actually changes.\r\n */\r\nexport class MemoizedNumber {\r\n  private _val: number;\r\n\r\n  /**\r\n   * Gets the current numeric value\r\n   */\r\n  get val(): number {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the numeric value and triggers the onChange callback if the value changed\r\n   * @param b - The new numeric value\r\n   */\r\n  set val(b: number) {\r\n    if (this._val === b) return;\r\n\r\n    this._val = b;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  /**\r\n   * Sets the value without triggering the onChange callback\r\n   * @param val - The new numeric value\r\n   */\r\n  public setValQuietly(val: number) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new MemoizedNumber instance\r\n   *\r\n   * @param initialValue - The initial numeric value\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(initialValue: number, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}

package/dist/esm/Entities/MemoizedQuaternion.js

@@ -1,17 +1,38 @@
 import { Quaternion } from "../ValueObjects";
+/**
+ * A wrapper class for Quaternion objects that tracks changes and triggers callbacks.
+ * Only triggers the callback when the quaternion value actually changes.
+ */
 export class MemoizedQuaternion {
+    /**
+     * Gets the current Quaternion value
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the Quaternion value and triggers the onChange callback if the value changed
+     * @param v - The new Quaternion value
+     */
     set val(v) {
         if (Quaternion.Equal(v, this._val))
             return;
         this._val = v;
         this.onChangeCallback();
     }
+    /**
+     * Sets the value without triggering the onChange callback
+     * @param val - The new Quaternion value
+     */
     setValQuietly(val) {
         this._val = val;
     }
+    /**
+     * Creates a new MemoizedQuaternion instance
+     *
+     * @param initialValue - The initial Quaternion value
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(initialValue, onChangeCallback) {
         this._val = initialValue;
         this.onChangeCallback = onChangeCallback;

package/dist/esm/Entities/MemoizedQuaternion.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedQuaternion.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedQuaternion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,OAAO,kBAAkB;IAG7B,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,CAAa;QACnB,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAE3C,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,GAAe;QAClC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID,YAAY,YAAwB,EAAE,gBAA4B;QAChE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["import { Quaternion } from \"../ValueObjects\";\r\n\r\nexport class MemoizedQuaternion {\r\n  private _val: Quaternion;\r\n\r\n  get val(): Quaternion {\r\n    return this._val;\r\n  }\r\n\r\n  set val(v: Quaternion) {\r\n    if (Quaternion.Equal(v, this._val)) return;\r\n\r\n    this._val = v;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  public setValQuietly(val: Quaternion) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(initialValue: Quaternion, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MemoizedQuaternion.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedQuaternion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAG7B;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAa;QACnB,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAE3C,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,GAAe;QAClC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID;;;;;OAKG;IACH,YAAY,YAAwB,EAAE,gBAA4B;QAChE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["import { Quaternion } from \"../ValueObjects\";\r\n\r\n/**\r\n * A wrapper class for Quaternion objects that tracks changes and triggers callbacks.\r\n * Only triggers the callback when the quaternion value actually changes.\r\n */\r\nexport class MemoizedQuaternion {\r\n  private _val: Quaternion;\r\n\r\n  /**\r\n   * Gets the current Quaternion value\r\n   */\r\n  get val(): Quaternion {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the Quaternion value and triggers the onChange callback if the value changed\r\n   * @param v - The new Quaternion value\r\n   */\r\n  set val(v: Quaternion) {\r\n    if (Quaternion.Equal(v, this._val)) return;\r\n\r\n    this._val = v;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  /**\r\n   * Sets the value without triggering the onChange callback\r\n   * @param val - The new Quaternion value\r\n   */\r\n  public setValQuietly(val: Quaternion) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new MemoizedQuaternion instance\r\n   *\r\n   * @param initialValue - The initial Quaternion value\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(initialValue: Quaternion, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}

package/dist/esm/Entities/MemoizedString.js

@@ -1,16 +1,37 @@
+/**
+ * A wrapper class for string values that tracks changes and triggers callbacks.
+ * Only triggers the callback when the value actually changes.
+ */
 export class MemoizedString {
+    /**
+     * Gets the current string value
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the string value and triggers the onChange callback if the value changed
+     * @param b - The new string value
+     */
     set val(b) {
         if (this._val === b)
             return;
         this._val = b;
         this.onChangeCallback();
     }
+    /**
+     * Sets the value without triggering the onChange callback
+     * @param val - The new string value
+     */
     setValQuietly(val) {
         this._val = val;
     }
+    /**
+     * Creates a new MemoizedString instance
+     *
+     * @param initialValue - The initial string value
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(initialValue, onChangeCallback) {
         this._val = initialValue;
         this.onChangeCallback = onChangeCallback;

package/dist/esm/Entities/MemoizedString.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedString.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedString.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAc;IAEzB,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,CAAS;QACf,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE5B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,GAAW;QAC9B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID,YAAY,YAAoB,EAAE,gBAA4B;QAC5D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["export class MemoizedString {\r\n  private _val: string;\r\n  get val(): string {\r\n    return this._val;\r\n  }\r\n  set val(b: string) {\r\n    if (this._val === b) return;\r\n\r\n    this._val = b;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  public setValQuietly(val: string) {\r\n    this._val = val;\r\n  }\r\n   \r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(initialValue: string, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MemoizedString.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedString.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,cAAc;IAGzB;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAS;QACf,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE5B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,GAAW;QAC9B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID;;;;;OAKG;IACH,YAAY,YAAoB,EAAE,gBAA4B;QAC5D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["/**\r\n * A wrapper class for string values that tracks changes and triggers callbacks.\r\n * Only triggers the callback when the value actually changes.\r\n */\r\nexport class MemoizedString {\r\n  private _val: string;\r\n\r\n  /**\r\n   * Gets the current string value\r\n   */\r\n  get val(): string {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the string value and triggers the onChange callback if the value changed\r\n   * @param b - The new string value\r\n   */\r\n  set val(b: string) {\r\n    if (this._val === b) return;\r\n\r\n    this._val = b;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  /**\r\n   * Sets the value without triggering the onChange callback\r\n   * @param val - The new string value\r\n   */\r\n  public setValQuietly(val: string) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new MemoizedString instance\r\n   *\r\n   * @param initialValue - The initial string value\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(initialValue: string, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}

package/dist/esm/Entities/MemoizedVector2.js

@@ -1,17 +1,38 @@
 import { Vector2 } from "../ValueObjects";
+/**
+ * A wrapper class for Vector2 objects that tracks changes and triggers callbacks.
+ * Only triggers the callback when the vector value actually changes.
+ */
 export class MemoizedVector2 {
+    /**
+     * Gets the current Vector2 value
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the Vector2 value and triggers the onChange callback if the value changed
+     * @param v - The new Vector2 value
+     */
     set val(v) {
         if (Vector2.Equal(v, this._val))
             return;
         this._val = v;
         this.onChangeCallback();
     }
+    /**
+     * Sets the value without triggering the onChange callback
+     * @param val - The new Vector2 value
+     */
     setValQuietly(val) {
         this._val = val;
     }
+    /**
+     * Creates a new MemoizedVector2 instance
+     *
+     * @param initialValue - The initial Vector2 value
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(initialValue, onChangeCallback) {
         this._val = initialValue;
         this.onChangeCallback = onChangeCallback;

package/dist/esm/Entities/MemoizedVector2.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedVector2.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedVector2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,OAAO,eAAe;IAG1B,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAExC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,GAAY;QAC/B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID,YAAY,YAAqB,EAAE,gBAA4B;QAC7D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["import { Vector2 } from \"../ValueObjects\";\r\n\r\nexport class MemoizedVector2 {\r\n  private _val: Vector2;\r\n\r\n  get val(): Vector2 {\r\n    return this._val;\r\n  }\r\n\r\n  set val(v: Vector2) {\r\n    if (Vector2.Equal(v, this._val)) return;\r\n\r\n    this._val = v;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  public setValQuietly(val: Vector2) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(initialValue: Vector2, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MemoizedVector2.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedVector2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;GAGG;AACH,MAAM,OAAO,eAAe;IAG1B;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAExC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,GAAY;QAC/B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID;;;;;OAKG;IACH,YAAY,YAAqB,EAAE,gBAA4B;QAC7D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["import { Vector2 } from \"../ValueObjects\";\r\n\r\n/**\r\n * A wrapper class for Vector2 objects that tracks changes and triggers callbacks.\r\n * Only triggers the callback when the vector value actually changes.\r\n */\r\nexport class MemoizedVector2 {\r\n  private _val: Vector2;\r\n\r\n  /**\r\n   * Gets the current Vector2 value\r\n   */\r\n  get val(): Vector2 {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the Vector2 value and triggers the onChange callback if the value changed\r\n   * @param v - The new Vector2 value\r\n   */\r\n  set val(v: Vector2) {\r\n    if (Vector2.Equal(v, this._val)) return;\r\n\r\n    this._val = v;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  /**\r\n   * Sets the value without triggering the onChange callback\r\n   * @param val - The new Vector2 value\r\n   */\r\n  public setValQuietly(val: Vector2) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new MemoizedVector2 instance\r\n   *\r\n   * @param initialValue - The initial Vector2 value\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(initialValue: Vector2, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}

package/dist/esm/Entities/MemoizedVector3.js

@@ -1,17 +1,38 @@
 import { Vector3 } from "../ValueObjects";
+/**
+ * A wrapper class for Vector3 objects that tracks changes and triggers callbacks.
+ * Only triggers the callback when the vector value actually changes.
+ */
 export class MemoizedVector3 {
+    /**
+     * Gets the current Vector3 value
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the Vector3 value and triggers the onChange callback if the value changed
+     * @param v - The new Vector3 value
+     */
     set val(v) {
         if (Vector3.Equal(v, this._val))
             return;
         this._val = v;
         this.onChangeCallback();
     }
+    /**
+     * Sets the value without triggering the onChange callback
+     * @param val - The new Vector3 value
+     */
     setValQuietly(val) {
         this._val = val;
     }
+    /**
+     * Creates a new MemoizedVector3 instance
+     *
+     * @param initialValue - The initial Vector3 value
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(initialValue, onChangeCallback) {
         this._val = initialValue;
         this.onChangeCallback = onChangeCallback;

package/dist/esm/Entities/MemoizedVector3.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedVector3.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedVector3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,OAAO,eAAe;IAG1B,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAExC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,GAAY;QAC/B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID,YAAY,YAAqB,EAAE,gBAA4B;QAC7D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["import { Vector3 } from \"../ValueObjects\";\r\n\r\nexport class MemoizedVector3 {\r\n  private _val: Vector3;\r\n\r\n  get val(): Vector3 {\r\n    return this._val;\r\n  }\r\n\r\n  set val(v: Vector3) {\r\n    if (Vector3.Equal(v, this._val)) return;\r\n\r\n    this._val = v;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  public setValQuietly(val: Vector3) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(initialValue: Vector3, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MemoizedVector3.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedVector3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;GAGG;AACH,MAAM,OAAO,eAAe;IAG1B;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAExC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,GAAY;QAC/B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID;;;;;OAKG;IACH,YAAY,YAAqB,EAAE,gBAA4B;QAC7D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["import { Vector3 } from \"../ValueObjects\";\r\n\r\n/**\r\n * A wrapper class for Vector3 objects that tracks changes and triggers callbacks.\r\n * Only triggers the callback when the vector value actually changes.\r\n */\r\nexport class MemoizedVector3 {\r\n  private _val: Vector3;\r\n\r\n  /**\r\n   * Gets the current Vector3 value\r\n   */\r\n  get val(): Vector3 {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the Vector3 value and triggers the onChange callback if the value changed\r\n   * @param v - The new Vector3 value\r\n   */\r\n  set val(v: Vector3) {\r\n    if (Vector3.Equal(v, this._val)) return;\r\n\r\n    this._val = v;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  /**\r\n   * Sets the value without triggering the onChange callback\r\n   * @param val - The new Vector3 value\r\n   */\r\n  public setValQuietly(val: Vector3) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new MemoizedVector3 instance\r\n   *\r\n   * @param initialValue - The initial Vector3 value\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(initialValue: Vector3, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}

package/dist/esm/Entities/ObservableEntity.js

@@ -1,13 +1,30 @@
 import { ObserverList } from "./ObserverList";
+/**
+ * Base class that implements the Observable pattern.
+ * Allows other objects to register as observers and be notified of changes.
+ *
+ * Extend this class to make your entity observable.
+ */
 export class ObservableEntity {
     constructor() {
         this.observerList = new ObserverList();
+        /**
+         * Registers a new observer to be notified of changes
+         * @param observer Function to be called when the entity changes
+         */
         this.addObserver = (observer) => {
             this.observerList.add(observer);
         };
+        /**
+         * Unregisters an existing observer
+         * @param observer The observer function to remove
+         */
         this.removeObserver = (observer) => {
             this.observerList.remove(observer);
         };
+        /**
+         * Notifies all registered observers about a change
+         */
         this.notify = () => {
             this.observerList.notify();
         };

package/dist/esm/Entities/ObservableEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableEntity.js","sourceRoot":"","sources":["../../../src/Entities/ObservableEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,MAAM,OAAgB,gBAAgB;IAAtC;QACU,iBAAY,GAAG,IAAI,YAAY,EAAQ,CAAC;QAEhD,gBAAW,GAAG,CAAC,QAAwB,EAAQ,EAAE;YAC/C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;QACF,mBAAc,GAAG,CAAC,QAAwB,EAAQ,EAAE;YAClD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC;QACF,WAAM,GAAG,GAAG,EAAE;YACZ,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC;CAAA","sourcesContent":["import { ObserverList } from \"./ObserverList\";\r\n\r\nexport type EntityObserver = () => void;\r\n\r\nexport abstract class ObservableEntity {\r\n  private observerList = new ObserverList<void>();\r\n\r\n  addObserver = (observer: EntityObserver): void => {\r\n    this.observerList.add(observer);\r\n  };\r\n  removeObserver = (observer: EntityObserver): void => {\r\n    this.observerList.remove(observer);\r\n  };\r\n  notify = () => {\r\n    this.observerList.notify();\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"ObservableEntity.js","sourceRoot":"","sources":["../../../src/Entities/ObservableEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C;;;;;GAKG;AACH,MAAM,OAAgB,gBAAgB;IAAtC;QACU,iBAAY,GAAG,IAAI,YAAY,EAAQ,CAAC;QAEhD;;;WAGG;QACH,gBAAW,GAAG,CAAC,QAAwB,EAAQ,EAAE;YAC/C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;QAEF;;;WAGG;QACH,mBAAc,GAAG,CAAC,QAAwB,EAAQ,EAAE;YAClD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC;QAEF;;WAEG;QACH,WAAM,GAAG,GAAG,EAAE;YACZ,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC;CAAA","sourcesContent":["import { ObserverList } from \"./ObserverList\";\r\n\r\n/**\r\n * Function type for entity observers\r\n */\r\nexport type EntityObserver = () => void;\r\n\r\n/**\r\n * Base class that implements the Observable pattern.\r\n * Allows other objects to register as observers and be notified of changes.\r\n *\r\n * Extend this class to make your entity observable.\r\n */\r\nexport abstract class ObservableEntity {\r\n  private observerList = new ObserverList<void>();\r\n\r\n  /**\r\n   * Registers a new observer to be notified of changes\r\n   * @param observer Function to be called when the entity changes\r\n   */\r\n  addObserver = (observer: EntityObserver): void => {\r\n    this.observerList.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Unregisters an existing observer\r\n   * @param observer The observer function to remove\r\n   */\r\n  removeObserver = (observer: EntityObserver): void => {\r\n    this.observerList.remove(observer);\r\n  };\r\n\r\n  /**\r\n   * Notifies all registered observers about a change\r\n   */\r\n  notify = () => {\r\n    this.observerList.notify();\r\n  };\r\n}\r\n"]}

package/dist/esm/Entities/ObserverList.js

@@ -1,20 +1,41 @@
+/**
+ * A generic implementation of the Observer pattern.
+ * Maintains a list of observer functions that can be notified with a message.
+ *
+ * @typeParam T - The type of message that will be passed to observers
+ */
 export class ObserverList {
     constructor() {
         this.observers = [];
+        /**
+         * Notifies all observers by calling them with the provided message
+         * @param msg - The message to send to all observers
+         */
         this.notify = (msg) => {
             this.observers.forEach((obs) => {
                 obs(msg);
             });
         };
+        /**
+         * Adds a new observer function to the list
+         * @param obs - The observer function to add
+         */
         this.add = (obs) => {
             this.observers.push(obs);
         };
+        /**
+         * Removes an observer from the list
+         * @param obs - The observer function to remove
+         */
         this.remove = (obs) => {
             const index = this.observers.indexOf(obs);
             if (index >= 0) {
                 this.observers.splice(index, 1);
             }
         };
+        /**
+         * Removes all observers from the list
+         */
         this.clear = () => {
             this.observers = [];
         };

package/dist/esm/Entities/ObserverList.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObserverList.js","sourceRoot":"","sources":["../../../src/Entities/ObserverList.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IAAzB;QACU,cAAS,GAAyB,EAAE,CAAC;QAEtC,WAAM,GAAG,CAAC,GAAM,EAAE,EAAE;YACzB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,GAAG,CAAC,GAAG,CAAC,CAAC;YACX,CAAC,CAAC,CAAC;QACL,CAAC,CAAA;QAEM,QAAG,GAAG,CAAC,GAAqB,EAAE,EAAE;YACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAA;QAEM,WAAM,GAAG,CAAC,GAAqB,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC,CAAA;QAEM,UAAK,GAAG,GAAG,EAAE;YAClB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACtB,CAAC,CAAA;IACH,CAAC;CAAA","sourcesContent":["export class ObserverList<T> {\r\n  private observers: ((msg: T) => void)[] = [];\r\n\r\n  public notify = (msg: T) => {\r\n    this.observers.forEach((obs) => {\r\n      obs(msg);\r\n    });\r\n  }\r\n\r\n  public add = (obs: (msg: T) => void) => {\r\n    this.observers.push(obs);\r\n  }\r\n\r\n  public remove = (obs: (msg: T) => void) => {\r\n    const index = this.observers.indexOf(obs);\r\n    if (index >= 0) {\r\n      this.observers.splice(index, 1);\r\n    }\r\n  }\r\n\r\n  public clear = () => {\r\n    this.observers = [];\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ObserverList.js","sourceRoot":"","sources":["../../../src/Entities/ObserverList.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAAzB;QACU,cAAS,GAAyB,EAAE,CAAC;QAE7C;;;WAGG;QACI,WAAM,GAAG,CAAC,GAAM,EAAE,EAAE;YACzB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,GAAG,CAAC,GAAG,CAAC,CAAC;YACX,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF;;;WAGG;QACI,QAAG,GAAG,CAAC,GAAqB,EAAE,EAAE;YACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAC;QAEF;;;WAGG;QACI,WAAM,GAAG,CAAC,GAAqB,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC,CAAC;QAEF;;WAEG;QACI,UAAK,GAAG,GAAG,EAAE;YAClB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC;CAAA","sourcesContent":["/**\r\n * A generic implementation of the Observer pattern.\r\n * Maintains a list of observer functions that can be notified with a message.\r\n *\r\n * @typeParam T - The type of message that will be passed to observers\r\n */\r\nexport class ObserverList<T> {\r\n  private observers: ((msg: T) => void)[] = [];\r\n\r\n  /**\r\n   * Notifies all observers by calling them with the provided message\r\n   * @param msg - The message to send to all observers\r\n   */\r\n  public notify = (msg: T) => {\r\n    this.observers.forEach((obs) => {\r\n      obs(msg);\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Adds a new observer function to the list\r\n   * @param obs - The observer function to add\r\n   */\r\n  public add = (obs: (msg: T) => void) => {\r\n    this.observers.push(obs);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer from the list\r\n   * @param obs - The observer function to remove\r\n   */\r\n  public remove = (obs: (msg: T) => void) => {\r\n    const index = this.observers.indexOf(obs);\r\n    if (index >= 0) {\r\n      this.observers.splice(index, 1);\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Removes all observers from the list\r\n   */\r\n  public clear = () => {\r\n    this.observers = [];\r\n  };\r\n}\r\n"]}

package/dist/esm/Entities/RangedNumber.js

@@ -1,7 +1,20 @@
+/**
+ * A numeric value that is constrained to a specified range.
+ * Values set outside the range will be automatically clamped.
+ * Triggers a callback when the value changes.
+ */
 export class RangedNumber {
+    /**
+     * Gets the current numeric value (guaranteed to be within min/max range)
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the numeric value and triggers the onChange callback if the value changed.
+     * The input value will be automatically clamped to the defined min/max range.
+     * @param x - The new numeric value
+     */
     set val(x) {
         const y = this.clamp(x);
         if (this._val === y)
@@ -9,9 +22,19 @@ export class RangedNumber {
         this._val = y;
         this.onChangeCallback();
     }
+    /**
+     * Sets the value without triggering the onChange callback.
+     * The input value will still be clamped to the defined range.
+     * @param val - The new numeric value
+     */
     setValQuietly(val) {
         this._val = this.clamp(val);
     }
+    /**
+     * Ensures a value is within the min/max range
+     * @param x - The value to clamp
+     * @returns The clamped value
+     */
     clamp(x) {
         let rVal = x;
         if (x > this.maxValue) {
@@ -22,6 +45,12 @@ export class RangedNumber {
         }
         return rVal;
     }
+    /**
+     * Creates a new RangedNumber instance
+     *
+     * @param props - Object containing min, max, and initialValue properties
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(props, onChangeCallback) {
         this.maxValue = props.max;
         this.minValue = props.min;

package/dist/esm/Entities/RangedNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"RangedNumber.js","sourceRoot":"","sources":["../../../src/Entities/RangedNumber.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,YAAY;IAIvB,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,CAAS;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE5B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,GAAW;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,CAAS;QACrB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;aAAM,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,YAAY,KAA6B,EAAE,gBAA4B;QACrE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC;QAE1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["export interface RangedNumberProperties {\r\n  min: number;\r\n  max: number;\r\n  initialValue: number;\r\n}\r\n\r\nexport class RangedNumber {\r\n  public readonly maxValue: number;\r\n  public readonly minValue: number;\r\n  private _val: number;\r\n  get val(): number {\r\n    return this._val;\r\n  }\r\n  set val(x: number) {\r\n    const y = this.clamp(x);\r\n    if (this._val === y) return;\r\n\r\n    this._val = y;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  public setValQuietly(val: number) {\r\n    this._val = this.clamp(val);\r\n  }\r\n\r\n  private clamp(x: number): number {\r\n    let rVal = x;\r\n    if (x > this.maxValue) {\r\n      rVal = this.maxValue;\r\n    } else if (x < this.minValue) {\r\n      rVal = this.minValue;\r\n    }\r\n\r\n    return rVal;\r\n  }\r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(props: RangedNumberProperties, onChangeCallback: () => void) {\r\n    this.maxValue = props.max;\r\n    this.minValue = props.min;\r\n\r\n    this._val = this.clamp(props.initialValue);\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"RangedNumber.js","sourceRoot":"","sources":["../../../src/Entities/RangedNumber.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAQvB;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,IAAI,GAAG,CAAC,CAAS;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE5B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,aAAa,CAAC,GAAW;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,CAAS;QACrB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;aAAM,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAID;;;;;OAKG;IACH,YAAY,KAA6B,EAAE,gBAA4B;QACrE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC;QAE1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF","sourcesContent":["/**\r\n * Properties required to initialize a RangedNumber\r\n */\r\nexport interface RangedNumberProperties {\r\n  /** The minimum allowed value */\r\n  min: number;\r\n  /** The maximum allowed value */\r\n  max: number;\r\n  /** The initial value (will be clamped between min and max) */\r\n  initialValue: number;\r\n}\r\n\r\n/**\r\n * A numeric value that is constrained to a specified range.\r\n * Values set outside the range will be automatically clamped.\r\n * Triggers a callback when the value changes.\r\n */\r\nexport class RangedNumber {\r\n  /** The maximum allowed value */\r\n  public readonly maxValue: number;\r\n  /** The minimum allowed value */\r\n  public readonly minValue: number;\r\n\r\n  private _val: number;\r\n\r\n  /**\r\n   * Gets the current numeric value (guaranteed to be within min/max range)\r\n   */\r\n  get val(): number {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the numeric value and triggers the onChange callback if the value changed.\r\n   * The input value will be automatically clamped to the defined min/max range.\r\n   * @param x - The new numeric value\r\n   */\r\n  set val(x: number) {\r\n    const y = this.clamp(x);\r\n    if (this._val === y) return;\r\n\r\n    this._val = y;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  /**\r\n   * Sets the value without triggering the onChange callback.\r\n   * The input value will still be clamped to the defined range.\r\n   * @param val - The new numeric value\r\n   */\r\n  public setValQuietly(val: number) {\r\n    this._val = this.clamp(val);\r\n  }\r\n\r\n  /**\r\n   * Ensures a value is within the min/max range\r\n   * @param x - The value to clamp\r\n   * @returns The clamped value\r\n   */\r\n  private clamp(x: number): number {\r\n    let rVal = x;\r\n    if (x > this.maxValue) {\r\n      rVal = this.maxValue;\r\n    } else if (x < this.minValue) {\r\n      rVal = this.minValue;\r\n    }\r\n\r\n    return rVal;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new RangedNumber instance\r\n   *\r\n   * @param props - Object containing min, max, and initialValue properties\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(props: RangedNumberProperties, onChangeCallback: () => void) {\r\n    this.maxValue = props.max;\r\n    this.minValue = props.min;\r\n\r\n    this._val = this.clamp(props.initialValue);\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}

package/dist/esm/ExampleFeature/Adapters/examplePmAdapter.js

@@ -0,0 +1,61 @@
+/**
+ * examplePmAdapter.ts
+ *
+ * This file demonstrates how to implement a PM Adapter to connect UI components to PMs.
+ * PM Adapters provide a standardized way for UI frameworks to subscribe to PM updates.
+ * This adapter connects to regular (non-singleton) PMs that require an AppObject ID.
+ *
+ * Key concepts:
+ * - PM Adapters implement the PmAdapter<VM> interface where VM is the view model type
+ * - They handle subscribing UI components to PMs and unsubscribing when done
+ * - They provide a default view model for initial rendering before data is available
+ * - They abstract away the details of finding and connecting to specific PMs
+ *
+ * Usage pattern (React example):
+ * ```typescript
+ * // In a React component
+ * function MyComponent({ id }) {
+ *   const viewModel = usePmAdapter(examplePmAdapter, id);
+ *   return <div>{viewModel}</div>;
+ * }
+ * ```
+ */
+import { ExamplePM } from "../PMs/ExamplePM";
+/**
+ * An adapter that connects UI components to ExamplePM instances.
+ * Implements PmAdapter<string> because ExamplePM provides string view models.
+ */
+export const examplePmAdapter = {
+    // Default view model to use before data is available
+    defaultVM: "",
+    /**
+     * Subscribes a UI component to updates from an ExamplePM
+     * @param id The ID of the AppObject containing the PM
+     * @param appObjects The application's AppObjectRepo
+     * @param setVM Callback function that updates the UI component
+     */
+    subscribe: (id, appObjects, setVM) => {
+        // Return early if no ID is provided
+        if (!id)
+            return;
+        // Find the PM using the provided ID
+        const pm = ExamplePM.getById(id, appObjects);
+        if (!pm) {
+            appObjects.submitError("examplePmAdapter", "Unable to find ExamplePM");
+            return;
+        }
+        // Register the UI component's callback to receive updates
+        pm.addView(setVM);
+    },
+    /**
+     * Unsubscribes a UI component from updates when it's no longer needed
+     * @param id The ID of the AppObject containing the PM
+     * @param appObjects The application's AppObjectRepo
+     * @param setVM The same callback function that was used to subscribe
+     */
+    unsubscribe: (id, appObjects, setVM) => {
+        // Find the PM and remove the view if it exists
+        ExamplePM.getById(id, appObjects)?.removeView(setVM);
+    }
+};
+//# sourceMappingURL=examplePmAdapter.js.map

package/dist/esm/ExampleFeature/Adapters/examplePmAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examplePmAdapter.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Adapters/examplePmAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,qDAAqD;IACrD,SAAS,EAAE,EAAE;IAEb;;;;;OAKG;IACH,SAAS,EAAE,CACT,EAAU,EACV,UAAyB,EACzB,KAA2B,EAC3B,EAAE;QACF,oCAAoC;QACpC,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,oCAAoC;QACpC,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,0BAA0B,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,0DAA0D;QAC1D,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,WAAW,EAAE,CACX,EAAU,EACV,UAAyB,EACzB,KAA2B,EAC3B,EAAE;QACF,+CAA+C;QAC/C,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;CACF,CAAC","sourcesContent":["/**\r\n * examplePmAdapter.ts\r\n * \r\n * This file demonstrates how to implement a PM Adapter to connect UI components to PMs.\r\n * PM Adapters provide a standardized way for UI frameworks to subscribe to PM updates.\r\n * This adapter connects to regular (non-singleton) PMs that require an AppObject ID.\r\n * \r\n * Key concepts:\r\n * - PM Adapters implement the PmAdapter<VM> interface where VM is the view model type\r\n * - They handle subscribing UI components to PMs and unsubscribing when done\r\n * - They provide a default view model for initial rendering before data is available\r\n * - They abstract away the details of finding and connecting to specific PMs\r\n * \r\n * Usage pattern (React example):\r\n * ```typescript\r\n * // In a React component\r\n * function MyComponent({ id }) {\r\n *   const viewModel = usePmAdapter(examplePmAdapter, id);\r\n *   return <div>{viewModel}</div>;\r\n * }\r\n * ```\r\n */\r\n\r\nimport { AppObjectRepo } from \"../../AppObject\";\r\nimport { PmAdapter } from \"../../Types/PmAdapter\";\r\nimport { ExamplePM } from \"../PMs/ExamplePM\";\r\n\r\n/**\r\n * An adapter that connects UI components to ExamplePM instances.\r\n * Implements PmAdapter<string> because ExamplePM provides string view models.\r\n */\r\nexport const examplePmAdapter: PmAdapter<string> = {\r\n  // Default view model to use before data is available\r\n  defaultVM: \"\",\r\n  \r\n  /**\r\n   * Subscribes a UI component to updates from an ExamplePM\r\n   * @param id The ID of the AppObject containing the PM\r\n   * @param appObjects The application's AppObjectRepo\r\n   * @param setVM Callback function that updates the UI component\r\n   */\r\n  subscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: string) => void\r\n  ) => {\r\n    // Return early if no ID is provided\r\n    if (!id) return;\r\n\r\n    // Find the PM using the provided ID\r\n    const pm = ExamplePM.getById(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"examplePmAdapter\", \"Unable to find ExamplePM\");\r\n      return;\r\n    }\r\n    \r\n    // Register the UI component's callback to receive updates\r\n    pm.addView(setVM);\r\n  },\r\n  \r\n  /**\r\n   * Unsubscribes a UI component from updates when it's no longer needed\r\n   * @param id The ID of the AppObject containing the PM\r\n   * @param appObjects The application's AppObjectRepo\r\n   * @param setVM The same callback function that was used to subscribe\r\n   */\r\n  unsubscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: string) => void\r\n  ) => {\r\n    // Find the PM and remove the view if it exists\r\n    ExamplePM.getById(id, appObjects)?.removeView(setVM);\r\n  }\r\n};\r\n"]}

package/dist/esm/ExampleFeature/Adapters/exampleSingletonPmAdapter.js

@@ -0,0 +1,57 @@
+/**
+ * exampleSingletonPmAdapter.ts
+ *
+ * This file demonstrates how to implement a Singleton PM Adapter to connect UI components
+ * to singleton PMs. Singleton PM Adapters provide a standardized way for UI frameworks
+ * to subscribe to singleton PM updates without needing to specify an AppObject ID.
+ *
+ * Key concepts:
+ * - Singleton PM Adapters implement the SingletonPmAdapter<VM> interface
+ * - They handle subscribing UI components to singleton PMs and unsubscribing when done
+ * - They provide a default view model for initial rendering before data is available
+ * - They don't require an AppObject ID since they connect to globally accessible singletons
+ *
+ * Usage pattern (React example):
+ * ```typescript
+ * // In a React component
+ * function MyComponent() {
+ *   // Note: no ID needed since it's connecting to a singleton
+ *   const viewModel = useSingletonPmAdapter(exampleSingletonPmAdapter);
+ *   return <div>{viewModel.aBoolProperty ? "True" : "False"}</div>;
+ * }
+ * ```
+ */
+import { defaultSlideNavigationVM, ExampleSingletonPM } from "../PMs/ExampleSingletonPM";
+/**
+ * An adapter that connects UI components to the ExampleSingletonPM.
+ * Implements SingletonPmAdapter<ExampleVM> because ExampleSingletonPM provides ExampleVM view models.
+ */
+export const exampleSingletonPmAdapter = {
+    // Default view model to use before data is available
+    defaultVM: defaultSlideNavigationVM,
+    /**
+     * Subscribes a UI component to updates from the ExampleSingletonPM
+     * @param appObjects The application's AppObjectRepo
+     * @param setVM Callback function that updates the UI component
+     */
+    subscribe: (appObjects, setVM) => {
+        // Find the singleton PM using its static get method
+        const pm = ExampleSingletonPM.get(appObjects);
+        if (!pm) {
+            appObjects.submitError("exampleSingletonPmAdapter", "Unable to find ExampleSingletonPM");
+            return;
+        }
+        // Register the UI component's callback to receive updates
+        pm.addView(setVM);
+    },
+    /**
+     * Unsubscribes a UI component from updates when it's no longer needed
+     * @param appObjects The application's AppObjectRepo
+     * @param setVM The same callback function that was used to subscribe
+     */
+    unsubscribe: (appObjects, setVM) => {
+        // Find the singleton PM and remove the view if it exists
+        ExampleSingletonPM.get(appObjects)?.removeView(setVM);
+    }
+};
+//# sourceMappingURL=exampleSingletonPmAdapter.js.map

package/dist/esm/ExampleFeature/Adapters/exampleSingletonPmAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exampleSingletonPmAdapter.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Adapters/exampleSingletonPmAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAkC;IACtE,qDAAqD;IACrD,SAAS,EAAE,wBAAwB;IAEnC;;;;OAIG;IACH,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA8B,EAAE,EAAE;QACvE,oDAAoD;QACpD,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,2BAA2B,EAC3B,mCAAmC,CACpC,CAAC;YACF,OAAO;QACT,CAAC;QAED,0DAA0D;QAC1D,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,WAAW,EAAE,CAAC,UAAyB,EAAE,KAA8B,EAAE,EAAE;QACzE,yDAAyD;QACzD,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;CACF,CAAC","sourcesContent":["/**\r\n * exampleSingletonPmAdapter.ts\r\n * \r\n * This file demonstrates how to implement a Singleton PM Adapter to connect UI components\r\n * to singleton PMs. Singleton PM Adapters provide a standardized way for UI frameworks\r\n * to subscribe to singleton PM updates without needing to specify an AppObject ID.\r\n * \r\n * Key concepts:\r\n * - Singleton PM Adapters implement the SingletonPmAdapter<VM> interface\r\n * - They handle subscribing UI components to singleton PMs and unsubscribing when done\r\n * - They provide a default view model for initial rendering before data is available\r\n * - They don't require an AppObject ID since they connect to globally accessible singletons\r\n * \r\n * Usage pattern (React example):\r\n * ```typescript\r\n * // In a React component\r\n * function MyComponent() {\r\n *   // Note: no ID needed since it's connecting to a singleton\r\n *   const viewModel = useSingletonPmAdapter(exampleSingletonPmAdapter);\r\n *   return <div>{viewModel.aBoolProperty ? \"True\" : \"False\"}</div>;\r\n * }\r\n * ```\r\n */\r\n\r\nimport { AppObjectRepo } from \"../../AppObject\";\r\nimport { SingletonPmAdapter } from \"../../Types/SingletonPmAdapter\";\r\nimport {\r\n  defaultSlideNavigationVM,\r\n  ExampleSingletonPM,\r\n  ExampleVM\r\n} from \"../PMs/ExampleSingletonPM\";\r\n\r\n/**\r\n * An adapter that connects UI components to the ExampleSingletonPM.\r\n * Implements SingletonPmAdapter<ExampleVM> because ExampleSingletonPM provides ExampleVM view models.\r\n */\r\nexport const exampleSingletonPmAdapter: SingletonPmAdapter<ExampleVM> = {\r\n  // Default view model to use before data is available\r\n  defaultVM: defaultSlideNavigationVM,\r\n  \r\n  /**\r\n   * Subscribes a UI component to updates from the ExampleSingletonPM\r\n   * @param appObjects The application's AppObjectRepo\r\n   * @param setVM Callback function that updates the UI component\r\n   */\r\n  subscribe: (appObjects: AppObjectRepo, setVM: (vm: ExampleVM) => void) => {\r\n    // Find the singleton PM using its static get method\r\n    const pm = ExampleSingletonPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"exampleSingletonPmAdapter\",\r\n        \"Unable to find ExampleSingletonPM\"\r\n      );\r\n      return;\r\n    }\r\n    \r\n    // Register the UI component's callback to receive updates\r\n    pm.addView(setVM);\r\n  },\r\n  \r\n  /**\r\n   * Unsubscribes a UI component from updates when it's no longer needed\r\n   * @param appObjects The application's AppObjectRepo\r\n   * @param setVM The same callback function that was used to subscribe\r\n   */\r\n  unsubscribe: (appObjects: AppObjectRepo, setVM: (vm: ExampleVM) => void) => {\r\n    // Find the singleton PM and remove the view if it exists\r\n    ExampleSingletonPM.get(appObjects)?.removeView(setVM);\r\n  }\r\n};\r\n"]}

package/dist/esm/ExampleFeature/Adapters/index.js

@@ -0,0 +1,3 @@
+export * from "./examplePmAdapter";
+export * from "./exampleSingletonPmAdapter";
+//# sourceMappingURL=index.js.map

package/dist/esm/ExampleFeature/Adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC","sourcesContent":["export * from \"./examplePmAdapter\";\r\nexport * from \"./exampleSingletonPmAdapter\";\r\n"]}

package/dist/esm/ExampleFeature/Controllers/index.js

@@ -0,0 +1,3 @@
+export * from "./setExampleText";
+export * from "./toggleExampleBoolean";
+//# sourceMappingURL=index.js.map

package/dist/esm/ExampleFeature/Controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC","sourcesContent":["export * from \"./setExampleText\";\r\nexport * from \"./toggleExampleBoolean\";\r\n"]}

package/dist/esm/ExampleFeature/Controllers/setExampleText.js

@@ -0,0 +1,45 @@
+/**
+ * setExampleText.ts
+ *
+ * This file demonstrates how to implement a Controller function.
+ * Controllers are simple functions that provide a simplified API for UI components
+ * to interact with Use Cases (UCs). They handle the details of finding the right
+ * UC and calling its methods with the appropriate parameters.
+ *
+ * Key concepts:
+ * - Controllers are functions that take parameters from UI components
+ * - They find the appropriate UC and call its methods
+ * - They handle error cases and provide appropriate feedback
+ * - They simplify the API for UI components
+ *
+ * Usage pattern (React example):
+ * ```typescript
+ * // In a React component
+ * function ExampleTextInput({ id, appObjects }) {
+ *   const handleChange = (e) => {
+ *     setExampleText(e.target.value, id, appObjects);
+ *   };
+ *   return <input onChange={handleChange} />;
+ * }
+ * ```
+ */
+import { EditExampleStringUC } from "../UCs/EditExampleStringUC";
+/**
+ * Controller function to update the text of an ExampleEntity
+ *
+ * @param text The new text to set
+ * @param id The ID of the AppObject containing the EditExampleStringUC
+ * @param appObjects The application's AppObjectRepo
+ */
+export function setExampleText(text, id, appObjects) {
+    // Find the Use Case using the provided ID
+    const uc = EditExampleStringUC.getById(id, appObjects);
+    // Handle the case where the UC doesn't exist
+    if (!uc) {
+        appObjects.submitWarning("setExampleText", "Unable to find EditExampleStringUC");
+        return;
+    }
+    // Call the UC method to perform the operation
+    uc.editExampleString(text);
+}
+//# sourceMappingURL=setExampleText.js.map

package/dist/esm/ExampleFeature/Controllers/setExampleText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setExampleText.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Controllers/setExampleText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,EAAU,EACV,UAAyB;IAEzB,0CAA0C;IAC1C,MAAM,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAEvD,6CAA6C;IAC7C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,UAAU,CAAC,aAAa,CACtB,gBAAgB,EAChB,oCAAoC,CACrC,CAAC;QACF,OAAO;IACT,CAAC;IAED,8CAA8C;IAC9C,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC","sourcesContent":["/**\r\n * setExampleText.ts\r\n * \r\n * This file demonstrates how to implement a Controller function.\r\n * Controllers are simple functions that provide a simplified API for UI components\r\n * to interact with Use Cases (UCs). They handle the details of finding the right\r\n * UC and calling its methods with the appropriate parameters.\r\n * \r\n * Key concepts:\r\n * - Controllers are functions that take parameters from UI components\r\n * - They find the appropriate UC and call its methods\r\n * - They handle error cases and provide appropriate feedback\r\n * - They simplify the API for UI components\r\n * \r\n * Usage pattern (React example):\r\n * ```typescript\r\n * // In a React component\r\n * function ExampleTextInput({ id, appObjects }) {\r\n *   const handleChange = (e) => {\r\n *     setExampleText(e.target.value, id, appObjects);\r\n *   };\r\n *   return <input onChange={handleChange} />;\r\n * }\r\n * ```\r\n */\r\n\r\nimport { AppObjectRepo } from \"../../AppObject\";\r\nimport { EditExampleStringUC } from \"../UCs/EditExampleStringUC\";\r\n\r\n/**\r\n * Controller function to update the text of an ExampleEntity\r\n * \r\n * @param text The new text to set\r\n * @param id The ID of the AppObject containing the EditExampleStringUC\r\n * @param appObjects The application's AppObjectRepo\r\n */\r\nexport function setExampleText(\r\n  text: string,\r\n  id: string,\r\n  appObjects: AppObjectRepo\r\n) {\r\n  // Find the Use Case using the provided ID\r\n  const uc = EditExampleStringUC.getById(id, appObjects);\r\n  \r\n  // Handle the case where the UC doesn't exist\r\n  if (!uc) {\r\n    appObjects.submitWarning(\r\n      \"setExampleText\",\r\n      \"Unable to find EditExampleStringUC\"\r\n    );\r\n    return;\r\n  }\r\n\r\n  // Call the UC method to perform the operation\r\n  uc.editExampleString(text);\r\n}\r\n"]}