@vived/core 1.4.2 → 1.4.4

package/dist/cjs/Entities/MemoizedNumber.js

@@ -1,19 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoizedNumber = void 0;
+/**
+ * A wrapper class for numeric values that tracks changes and triggers callbacks.
+ * Only triggers the callback when the value actually changes.
+ */
 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/cjs/Entities/MemoizedNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedNumber.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedNumber.ts"],"names":[],"mappings":";;;AAAA,MAAa,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;AAtBD,wCAsBC","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,MAAa,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;AAzCD,wCAyCC","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/cjs/Entities/MemoizedQuaternion.js

@@ -2,19 +2,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoizedQuaternion = void 0;
 const ValueObjects_1 = require("../ValueObjects");
+/**
+ * A wrapper class for Quaternion objects that tracks changes and triggers callbacks.
+ * Only triggers the callback when the quaternion value actually changes.
+ */
 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 (ValueObjects_1.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/cjs/Entities/MemoizedQuaternion.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedQuaternion.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedQuaternion.ts"],"names":[],"mappings":";;;AAAA,kDAA6C;AAE7C,MAAa,kBAAkB;IAG7B,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,CAAa;QACnB,IAAI,yBAAU,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;AAxBD,gDAwBC","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,kDAA6C;AAE7C;;;GAGG;AACH,MAAa,kBAAkB;IAG7B;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAa;QACnB,IAAI,yBAAU,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;AAzCD,gDAyCC","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/cjs/Entities/MemoizedString.js

@@ -1,19 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoizedString = void 0;
+/**
+ * A wrapper class for string values that tracks changes and triggers callbacks.
+ * Only triggers the callback when the value actually changes.
+ */
 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/cjs/Entities/MemoizedString.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedString.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedString.ts"],"names":[],"mappings":";;;AAAA,MAAa,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;AAtBD,wCAsBC","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,MAAa,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;AAzCD,wCAyCC","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/cjs/Entities/MemoizedVector2.js

@@ -2,19 +2,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoizedVector2 = void 0;
 const ValueObjects_1 = require("../ValueObjects");
+/**
+ * A wrapper class for Vector2 objects that tracks changes and triggers callbacks.
+ * Only triggers the callback when the vector value actually changes.
+ */
 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 (ValueObjects_1.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/cjs/Entities/MemoizedVector2.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedVector2.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedVector2.ts"],"names":[],"mappings":";;;AAAA,kDAA0C;AAE1C,MAAa,eAAe;IAG1B,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,sBAAO,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;AAxBD,0CAwBC","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,kDAA0C;AAE1C;;;GAGG;AACH,MAAa,eAAe;IAG1B;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,sBAAO,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;AAzCD,0CAyCC","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/cjs/Entities/MemoizedVector3.js

@@ -2,19 +2,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoizedVector3 = void 0;
 const ValueObjects_1 = require("../ValueObjects");
+/**
+ * A wrapper class for Vector3 objects that tracks changes and triggers callbacks.
+ * Only triggers the callback when the vector value actually changes.
+ */
 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 (ValueObjects_1.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/cjs/Entities/MemoizedVector3.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedVector3.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedVector3.ts"],"names":[],"mappings":";;;AAAA,kDAA0C;AAE1C,MAAa,eAAe;IAG1B,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,sBAAO,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;AAxBD,0CAwBC","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,kDAA0C;AAE1C;;;GAGG;AACH,MAAa,eAAe;IAG1B;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,sBAAO,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;AAzCD,0CAyCC","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/cjs/Entities/ObservableEntity.js

@@ -2,15 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObservableEntity = void 0;
 const ObserverList_1 = require("./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.
+ */
 class ObservableEntity {
     constructor() {
         this.observerList = new ObserverList_1.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/cjs/Entities/ObservableEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableEntity.js","sourceRoot":"","sources":["../../../src/Entities/ObservableEntity.ts"],"names":[],"mappings":";;;AAAA,iDAA8C;AAI9C,MAAsB,gBAAgB;IAAtC;QACU,iBAAY,GAAG,IAAI,2BAAY,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;AAZD,4CAYC","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,iDAA8C;AAO9C;;;;;GAKG;AACH,MAAsB,gBAAgB;IAAtC;QACU,iBAAY,GAAG,IAAI,2BAAY,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;AAzBD,4CAyBC","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/cjs/Entities/ObserverList.js

@@ -1,23 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObserverList = void 0;
+/**
+ * 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
+ */
 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/cjs/Entities/ObserverList.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObserverList.js","sourceRoot":"","sources":["../../../src/Entities/ObserverList.ts"],"names":[],"mappings":";;;AAAA,MAAa,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;AAvBD,oCAuBC","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,MAAa,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;AAtCD,oCAsCC","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/cjs/Entities/RangedNumber.js

@@ -1,10 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RangedNumber = void 0;
+/**
+ * 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.
+ */
 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)
@@ -12,9 +25,19 @@ 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) {
@@ -25,6 +48,12 @@ 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/cjs/Entities/RangedNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"RangedNumber.js","sourceRoot":"","sources":["../../../src/Entities/RangedNumber.ts"],"names":[],"mappings":";;;AAMA,MAAa,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;AAtCD,oCAsCC","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,MAAa,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;AApED,oCAoEC","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/cjs/ExampleFeature/Adapters/examplePmAdapter.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * 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>;
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.examplePmAdapter = void 0;
+const ExamplePM_1 = require("../PMs/ExamplePM");
+/**
+ * An adapter that connects UI components to ExamplePM instances.
+ * Implements PmAdapter<string> because ExamplePM provides string view models.
+ */
+exports.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_1.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_1.ExamplePM.getById(id, appObjects)?.removeView(setVM);
+    }
+};
+//# sourceMappingURL=examplePmAdapter.js.map

package/dist/cjs/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,gDAA6C;AAE7C;;;GAGG;AACU,QAAA,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,qBAAS,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,qBAAS,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/cjs/ExampleFeature/Adapters/exampleSingletonPmAdapter.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * 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>;
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exampleSingletonPmAdapter = void 0;
+const ExampleSingletonPM_1 = require("../PMs/ExampleSingletonPM");
+/**
+ * An adapter that connects UI components to the ExampleSingletonPM.
+ * Implements SingletonPmAdapter<ExampleVM> because ExampleSingletonPM provides ExampleVM view models.
+ */
+exports.exampleSingletonPmAdapter = {
+    // Default view model to use before data is available
+    defaultVM: ExampleSingletonPM_1.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_1.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_1.ExampleSingletonPM.get(appObjects)?.removeView(setVM);
+    }
+};
+//# sourceMappingURL=exampleSingletonPmAdapter.js.map

package/dist/cjs/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,kEAImC;AAEnC;;;GAGG;AACU,QAAA,yBAAyB,GAAkC;IACtE,qDAAqD;IACrD,SAAS,EAAE,6CAAwB;IAEnC;;;;OAIG;IACH,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA8B,EAAE,EAAE;QACvE,oDAAoD;QACpD,MAAM,EAAE,GAAG,uCAAkB,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,uCAAkB,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/cjs/ExampleFeature/Adapters/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./examplePmAdapter"), exports);
+__exportStar(require("./exampleSingletonPmAdapter"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./setExampleText"), exports);
+__exportStar(require("./toggleExampleBoolean"), exports);
+//# sourceMappingURL=index.js.map

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

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