@vived/core 1.4.2 → 1.4.3

package/dist/cjs/AppObject/AppObjectEntityRepo.js

@@ -3,27 +3,83 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppObjectEntityRepo = void 0;
 const Entities_1 = require("../Entities");
 const AppObjectEntity_1 = require("./AppObjectEntity");
+/**
+ * A repository for managing collections of AppObjectEntity instances.
+ *
+ * This generic class provides a centralized way to store, retrieve, and manage
+ * entities that are associated with specific AppObjects. It implements the observer
+ * pattern to notify listeners when entities are added or removed.
+ *
+ * @template T - The type of entities managed by this repository, must extend AppObjectEntity
+ * @extends AppObjectEntity
+ *
+ * @example
+ * ```typescript
+ * // Create a repository for player entities
+ * const playerRepo = new AppObjectEntityRepo<PlayerEntity>();
+ *
+ * // Add a new player
+ * const player = new PlayerEntity(appObject);
+ * playerRepo.add(player);
+ *
+ * // Get a player by its AppObject ID
+ * const retrievedPlayer = playerRepo.getForAppObject("player1");
+ * ```
+ */
 class AppObjectEntityRepo extends AppObjectEntity_1.AppObjectEntity {
     constructor() {
         super(...arguments);
         this.entityLookup = new Map();
         this.onEntityAddedObservers = new Entities_1.ObserverList();
+        /**
+         * Registers an observer to be notified when an entity is added to the repository.
+         *
+         * @param {(addedEntity: T) => void} observer - The callback function to invoke when an entity is added
+         */
         this.addEntityAddedObserver = (observer) => {
             this.onEntityAddedObservers.add(observer);
         };
+        /**
+         * Removes an observer previously registered for entity addition notifications.
+         *
+         * @param {(addedEntity: T) => void} observer - The callback function to remove
+         */
         this.removeEntityAddedObserver = (observer) => {
             this.onEntityAddedObservers.remove(observer);
         };
         this.onEntityRemovedObservers = new Entities_1.ObserverList();
+        /**
+         * Registers an observer to be notified when an entity is removed from the repository.
+         *
+         * @param {(removedEntity: T) => void} observer - The callback function to invoke when an entity is removed
+         */
         this.addEntityRemovedObserver = (observer) => {
             this.onEntityRemovedObservers.add(observer);
         };
+        /**
+         * Removes an observer previously registered for entity removal notifications.
+         *
+         * @param {(removedEntity: T) => void} observer - The callback function to remove
+         */
         this.removeEntityRemovedObserver = (observer) => {
             this.onEntityRemovedObservers.remove(observer);
         };
+        /**
+         * Checks if an entity exists for the given AppObject ID.
+         *
+         * @param {string} appObjectID - The ID of the AppObject
+         * @returns {boolean} True if an entity exists for the given AppObject ID, false otherwise
+         */
         this.hasForAppObject = (appObjectID) => {
             return this.entityLookup.has(appObjectID);
         };
+        /**
+         * Removes the entity associated with the specified AppObject ID.
+         *
+         * Notifies all registered observers after the entity is removed.
+         *
+         * @param {string} id - The ID of the AppObject whose entity should be removed
+         */
         this.removeForAppObject = (id) => {
             const existing = this.entityLookup.get(id);
             if (!existing)
@@ -33,13 +89,32 @@ class AppObjectEntityRepo extends AppObjectEntity_1.AppObjectEntity {
             this.notifyOnChange();
             this.onEntityRemovedObservers.notify(existing);
         };
+        /**
+         * Gets the entity associated with the specified AppObject ID.
+         *
+         * @param {string} appObjectID - The ID of the AppObject
+         * @returns {T | undefined} The entity if found, undefined otherwise
+         */
         this.getForAppObject = (appObjectID) => {
             return this.entityLookup.get(appObjectID);
         };
+        /**
+         * Gets all entities in the repository.
+         *
+         * @returns {T[]} An array of all entities
+         */
         this.getAll = () => {
             return Array.from(this.entityLookup.values());
         };
     }
+    /**
+     * Adds an entity to the repository.
+     *
+     * If an entity with the same AppObject ID already exists, it is replaced.
+     * Notifies all registered observers after the entity is added.
+     *
+     * @param {T} entity - The entity to add
+     */
     add(entity) {
         const existing = this.entityLookup.get(entity.appObject.id);
         if (existing) {
@@ -50,7 +125,6 @@ class AppObjectEntityRepo extends AppObjectEntity_1.AppObjectEntity {
         this.notifyOnChange();
         this.onEntityAddedObservers.notify(entity);
     }
-    ;
 }
 exports.AppObjectEntityRepo = AppObjectEntityRepo;
 //# sourceMappingURL=AppObjectEntityRepo.js.map

package/dist/cjs/AppObject/AppObjectEntityRepo.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectEntityRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectEntityRepo.ts"],"names":[],"mappings":";;;AAAA,0CAA2C;AAC3C,uDAAoD;AAEpD,MAAa,mBAEX,SAAQ,iCAAe;IAFzB;;QAIU,iBAAY,GAAG,IAAI,GAAG,EAAa,CAAC;QAEpC,2BAAsB,GAAG,IAAI,uBAAY,EAAK,CAAC;QACvD,2BAAsB,GAAG,CAAC,QAAkC,EAAE,EAAE;YAC9D,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC;QACF,8BAAyB,GAAG,CAAC,QAAkC,EAAQ,EAAE;YACvE,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC,CAAC;QAEM,6BAAwB,GAAG,IAAI,uBAAY,EAAK,CAAC;QACzD,6BAAwB,GAAG,CAAC,QAAoC,EAAE,EAAE;YAClE,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC;QACF,gCAA2B,GAAG,CAC5B,QAAoC,EAC9B,EAAE;YACR,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF,oBAAe,GAAG,CAAC,WAAmB,EAAW,EAAE;YACjD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC,CAAC;QAcF,uBAAkB,GAAG,CAAC,EAAU,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAEtB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7B,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF,oBAAe,GAAG,CAAC,WAAmB,EAAiB,EAAE;YACvD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF,WAAM,GAAG,GAAQ,EAAE;YACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IA7BC,GAAG,CAAC,MAAS;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAA,CAAC;CAmBH;AAzDD,kDAyDC","sourcesContent":["import { ObserverList } from \"../Entities\";\r\nimport { AppObjectEntity } from \"./AppObjectEntity\";\r\n\r\nexport class AppObjectEntityRepo<\r\n  T extends AppObjectEntity\r\n> extends AppObjectEntity {\r\n\r\n  private entityLookup = new Map<string, T>();\r\n\r\n  private onEntityAddedObservers = new ObserverList<T>();\r\n  addEntityAddedObserver = (observer: (addedEntity: T) => void) => {\r\n    this.onEntityAddedObservers.add(observer);\r\n  };\r\n  removeEntityAddedObserver = (observer: (addedEntity: T) => void): void => {\r\n    this.onEntityAddedObservers.remove(observer);\r\n  };\r\n\r\n  private onEntityRemovedObservers = new ObserverList<T>();\r\n  addEntityRemovedObserver = (observer: (removedEntity: T) => void) => {\r\n    this.onEntityRemovedObservers.add(observer);\r\n  };\r\n  removeEntityRemovedObserver = (\r\n    observer: (removedEntity: T) => void\r\n  ): void => {\r\n    this.onEntityRemovedObservers.remove(observer);\r\n  };\r\n\r\n  hasForAppObject = (appObjectID: string): boolean => {\r\n    return this.entityLookup.has(appObjectID);\r\n  };\r\n\r\n  add(entity: T) {\r\n    const existing = this.entityLookup.get(entity.appObject.id);\r\n    if (existing) {\r\n      existing.removeChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this.entityLookup.set(entity.appObject.id, entity);\r\n    entity.addChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityAddedObservers.notify(entity);\r\n  };\r\n\r\n  removeForAppObject = (id: string) => {\r\n    const existing = this.entityLookup.get(id);\r\n    if (!existing) return;\r\n\r\n    this.entityLookup.delete(id);\r\n    existing.removeChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityRemovedObservers.notify(existing);\r\n  };\r\n\r\n  getForAppObject = (appObjectID: string): T | undefined => {\r\n    return this.entityLookup.get(appObjectID);\r\n  };\r\n\r\n  getAll = (): T[] => {\r\n    return Array.from(this.entityLookup.values());\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"AppObjectEntityRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectEntityRepo.ts"],"names":[],"mappings":";;;AAAA,0CAA2C;AAC3C,uDAAoD;AAEpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,mBAEX,SAAQ,iCAAe;IAFzB;;QAGU,iBAAY,GAAG,IAAI,GAAG,EAAa,CAAC;QAEpC,2BAAsB,GAAG,IAAI,uBAAY,EAAK,CAAC;QACvD;;;;WAIG;QACH,2BAAsB,GAAG,CAAC,QAAkC,EAAE,EAAE;YAC9D,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF;;;;WAIG;QACH,8BAAyB,GAAG,CAAC,QAAkC,EAAQ,EAAE;YACvE,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC,CAAC;QAEM,6BAAwB,GAAG,IAAI,uBAAY,EAAK,CAAC;QACzD;;;;WAIG;QACH,6BAAwB,GAAG,CAAC,QAAoC,EAAE,EAAE;YAClE,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC;QAEF;;;;WAIG;QACH,gCAA2B,GAAG,CAC5B,QAAoC,EAC9B,EAAE;YACR,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF;;;;;WAKG;QACH,oBAAe,GAAG,CAAC,WAAmB,EAAW,EAAE;YACjD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC,CAAC;QAsBF;;;;;;WAMG;QACH,uBAAkB,GAAG,CAAC,EAAU,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAEtB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7B,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF;;;;;WAKG;QACH,oBAAe,GAAG,CAAC,WAAmB,EAAiB,EAAE;YACvD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF;;;;WAIG;QACH,WAAM,GAAG,GAAQ,EAAE;YACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAvDC;;;;;;;OAOG;IACH,GAAG,CAAC,MAAS;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;CAqCF;AA9GD,kDA8GC","sourcesContent":["import { ObserverList } from \"../Entities\";\r\nimport { AppObjectEntity } from \"./AppObjectEntity\";\r\n\r\n/**\r\n * A repository for managing collections of AppObjectEntity instances.\r\n *\r\n * This generic class provides a centralized way to store, retrieve, and manage\r\n * entities that are associated with specific AppObjects. It implements the observer\r\n * pattern to notify listeners when entities are added or removed.\r\n *\r\n * @template T - The type of entities managed by this repository, must extend AppObjectEntity\r\n * @extends AppObjectEntity\r\n *\r\n * @example\r\n * ```typescript\r\n * // Create a repository for player entities\r\n * const playerRepo = new AppObjectEntityRepo<PlayerEntity>();\r\n *\r\n * // Add a new player\r\n * const player = new PlayerEntity(appObject);\r\n * playerRepo.add(player);\r\n *\r\n * // Get a player by its AppObject ID\r\n * const retrievedPlayer = playerRepo.getForAppObject(\"player1\");\r\n * ```\r\n */\r\nexport class AppObjectEntityRepo<\r\n  T extends AppObjectEntity,\r\n> extends AppObjectEntity {\r\n  private entityLookup = new Map<string, T>();\r\n\r\n  private onEntityAddedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is added to the repository.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to invoke when an entity is added\r\n   */\r\n  addEntityAddedObserver = (observer: (addedEntity: T) => void) => {\r\n    this.onEntityAddedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity addition notifications.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityAddedObserver = (observer: (addedEntity: T) => void): void => {\r\n    this.onEntityAddedObservers.remove(observer);\r\n  };\r\n\r\n  private onEntityRemovedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is removed from the repository.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to invoke when an entity is removed\r\n   */\r\n  addEntityRemovedObserver = (observer: (removedEntity: T) => void) => {\r\n    this.onEntityRemovedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity removal notifications.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityRemovedObserver = (\r\n    observer: (removedEntity: T) => void\r\n  ): void => {\r\n    this.onEntityRemovedObservers.remove(observer);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given AppObject ID, false otherwise\r\n   */\r\n  hasForAppObject = (appObjectID: string): boolean => {\r\n    return this.entityLookup.has(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Adds an entity to the repository.\r\n   *\r\n   * If an entity with the same AppObject ID already exists, it is replaced.\r\n   * Notifies all registered observers after the entity is added.\r\n   *\r\n   * @param {T} entity - The entity to add\r\n   */\r\n  add(entity: T) {\r\n    const existing = this.entityLookup.get(entity.appObject.id);\r\n    if (existing) {\r\n      existing.removeChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this.entityLookup.set(entity.appObject.id, entity);\r\n    entity.addChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityAddedObservers.notify(entity);\r\n  }\r\n\r\n  /**\r\n   * Removes the entity associated with the specified AppObject ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   */\r\n  removeForAppObject = (id: string) => {\r\n    const existing = this.entityLookup.get(id);\r\n    if (!existing) return;\r\n\r\n    this.entityLookup.delete(id);\r\n    existing.removeChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityRemovedObservers.notify(existing);\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   */\r\n  getForAppObject = (appObjectID: string): T | undefined => {\r\n    return this.entityLookup.get(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Gets all entities in the repository.\r\n   *\r\n   * @returns {T[]} An array of all entities\r\n   */\r\n  getAll = (): T[] => {\r\n    return Array.from(this.entityLookup.values());\r\n  };\r\n}\r\n"]}

package/dist/cjs/AppObject/AppObjectPM.js

@@ -3,31 +3,77 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppObjectPM = void 0;
 const Entities_1 = require("../Entities");
 const AppObjectComponent_1 = require("./AppObjectComponent");
+/**
+ * Presentation Manager (PM) component that transforms application state into view models
+ *
+ * AppObjectPM acts as a mediator between application state (entities) and views.
+ * It transforms raw application data into a format that's optimized for presentation,
+ * implementing the presentation model or MVVM pattern.
+ *
+ * A PM typically:
+ * 1. Observes entity changes
+ * 2. Transforms entity data into view models
+ * 3. Notifies attached views when view models change
+ * 4. Handles view model caching and optimization
+ *
+ * @typeparam T The view model type this PM produces
+ */
 class AppObjectPM extends AppObjectComponent_1.AppObjectComponent {
     constructor() {
         super(...arguments);
+        /** Identifies this as a Presentation Manager component */
         this.componentType = AppObjectComponent_1.AppObjectComponentType.PM;
+        /** List of view update functions to notify when the view model changes */
         this.observerList = new Entities_1.ObserverList();
     }
+    /**
+     * Gets the most recently generated view model
+     * @returns The last view model or undefined if none has been generated
+     */
     get lastVM() {
         return this._lastVM;
     }
+    /**
+     * Registers a view update function to be called when the view model changes
+     * If a view model already exists, the provided function is called immediately with that model
+     *
+     * @param updateView Function to call with updated view models
+     */
     addView(updateView) {
         this.observerList.add(updateView);
+        // Immediately update the view with current view model if one exists
         if (this._lastVM !== undefined) {
             updateView(this._lastVM);
         }
     }
+    /**
+     * Unregisters a previously added view update function
+     *
+     * @param updateView The view update function to remove
+     */
     removeView(updateView) {
         this.observerList.remove(updateView);
     }
+    /**
+     * Updates the view model and notifies all registered views if the model has changed
+     * This method should be called by derived classes when the view model needs to be updated
+     *
+     * The method performs equality checking to prevent unnecessary updates when
+     * the new view model is equivalent to the previous one
+     *
+     * @param vm The new view model
+     */
     doUpdateView(vm) {
+        // Skip update if the view model hasn't changed
         if (this._lastVM && this.vmsAreEqual(this._lastVM, vm)) {
             return;
         }
         this._lastVM = vm;
         this.observerList.notify(vm);
     }
+    /**
+     * Cleans up resources and detaches this PM from its parent AppObject
+     */
     dispose() {
         this.observerList.clear();
         if (this.appObject.getComponent(this.type) === this) {

package/dist/cjs/AppObject/AppObjectPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectPM.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectPM.ts"],"names":[],"mappings":";;;AAAA,0CAA2C;AAC3C,6DAAkF;AAElF,MAAsB,WAAe,SAAQ,uCAAkB;IAA/D;;QACW,kBAAa,GAAG,2CAAsB,CAAC,EAAE,CAAC;QAQ3C,iBAAY,GAAG,IAAI,uBAAY,EAAK,CAAC;IA8B/C,CAAC;IAlCC,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAID,OAAO,CAAC,UAA2B;QACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAElC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,UAAU,CAAC,UAA2B;QACpC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,YAAY,CAAC,EAAK;QAChB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;CACF;AAvCD,kCAuCC","sourcesContent":["import { ObserverList } from \"../Entities\";\r\nimport { AppObjectComponent, AppObjectComponentType } from \"./AppObjectComponent\";\r\n\r\nexport abstract class AppObjectPM<T> extends AppObjectComponent {\r\n  readonly componentType = AppObjectComponentType.PM;\r\n  abstract vmsAreEqual(a: T, b: T): boolean;\r\n\r\n  private _lastVM?: T;\r\n  get lastVM(): T | undefined {\r\n    return this._lastVM;\r\n  }\r\n\r\n  private observerList = new ObserverList<T>();\r\n\r\n  addView(updateView: (vm: T) => void): void {\r\n    this.observerList.add(updateView);\r\n\r\n    if (this._lastVM !== undefined) {\r\n      updateView(this._lastVM);\r\n    }\r\n  }\r\n\r\n  removeView(updateView: (vm: T) => void): void {\r\n    this.observerList.remove(updateView);\r\n  }\r\n\r\n  doUpdateView(vm: T) {\r\n    if (this._lastVM && this.vmsAreEqual(this._lastVM, vm)) {\r\n      return;\r\n    }\r\n\r\n    this._lastVM = vm;\r\n    this.observerList.notify(vm);\r\n  }\r\n\r\n  dispose() {\r\n    this.observerList.clear();\r\n    if (this.appObject.getComponent(this.type) === this) {\r\n      this.appObject.removeComponent(this.type);\r\n    }\r\n    super.dispose();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppObjectPM.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectPM.ts"],"names":[],"mappings":";;;AAAA,0CAA2C;AAC3C,6DAAkF;AAElF;;;;;;;;;;;;;;GAcG;AACH,MAAsB,WAAe,SAAQ,uCAAkB;IAA/D;;QACE,0DAA0D;QACjD,kBAAa,GAAG,2CAAsB,CAAC,EAAE,CAAC;QAuBnD,0EAA0E;QAClE,iBAAY,GAAG,IAAI,uBAAY,EAAK,CAAC;IAuD/C,CAAC;IAhEC;;;OAGG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAKD;;;;;OAKG;IACH,OAAO,CAAC,UAA2B;QACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAElC,oEAAoE;QACpE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,UAA2B;QACpC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAK;QAChB,+CAA+C;QAC/C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;CACF;AAjFD,kCAiFC","sourcesContent":["import { ObserverList } from \"../Entities\";\r\nimport { AppObjectComponent, AppObjectComponentType } from \"./AppObjectComponent\";\r\n\r\n/**\r\n * Presentation Manager (PM) component that transforms application state into view models\r\n * \r\n * AppObjectPM acts as a mediator between application state (entities) and views.\r\n * It transforms raw application data into a format that's optimized for presentation,\r\n * implementing the presentation model or MVVM pattern.\r\n * \r\n * A PM typically:\r\n * 1. Observes entity changes\r\n * 2. Transforms entity data into view models\r\n * 3. Notifies attached views when view models change\r\n * 4. Handles view model caching and optimization\r\n * \r\n * @typeparam T The view model type this PM produces\r\n */\r\nexport abstract class AppObjectPM<T> extends AppObjectComponent {\r\n  /** Identifies this as a Presentation Manager component */\r\n  readonly componentType = AppObjectComponentType.PM;\r\n  \r\n  /**\r\n   * Compares two view models to determine if they're equivalent\r\n   * Used to prevent unnecessary view updates when the view model hasn't changed\r\n   * \r\n   * @param a First view model to compare\r\n   * @param b Second view model to compare\r\n   * @returns True if the view models are considered equal, false otherwise\r\n   */\r\n  abstract vmsAreEqual(a: T, b: T): boolean;\r\n\r\n  /** The most recently generated view model */\r\n  private _lastVM?: T;\r\n  \r\n  /**\r\n   * Gets the most recently generated view model\r\n   * @returns The last view model or undefined if none has been generated\r\n   */\r\n  get lastVM(): T | undefined {\r\n    return this._lastVM;\r\n  }\r\n\r\n  /** List of view update functions to notify when the view model changes */\r\n  private observerList = new ObserverList<T>();\r\n\r\n  /**\r\n   * Registers a view update function to be called when the view model changes\r\n   * If a view model already exists, the provided function is called immediately with that model\r\n   * \r\n   * @param updateView Function to call with updated view models\r\n   */\r\n  addView(updateView: (vm: T) => void): void {\r\n    this.observerList.add(updateView);\r\n\r\n    // Immediately update the view with current view model if one exists\r\n    if (this._lastVM !== undefined) {\r\n      updateView(this._lastVM);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unregisters a previously added view update function\r\n   * \r\n   * @param updateView The view update function to remove\r\n   */\r\n  removeView(updateView: (vm: T) => void): void {\r\n    this.observerList.remove(updateView);\r\n  }\r\n\r\n  /**\r\n   * Updates the view model and notifies all registered views if the model has changed\r\n   * This method should be called by derived classes when the view model needs to be updated\r\n   * \r\n   * The method performs equality checking to prevent unnecessary updates when\r\n   * the new view model is equivalent to the previous one\r\n   * \r\n   * @param vm The new view model\r\n   */\r\n  doUpdateView(vm: T) {\r\n    // Skip update if the view model hasn't changed\r\n    if (this._lastVM && this.vmsAreEqual(this._lastVM, vm)) {\r\n      return;\r\n    }\r\n\r\n    this._lastVM = vm;\r\n    this.observerList.notify(vm);\r\n  }\r\n\r\n  /**\r\n   * Cleans up resources and detaches this PM from its parent AppObject\r\n   */\r\n  dispose() {\r\n    this.observerList.clear();\r\n    if (this.appObject.getComponent(this.type) === this) {\r\n      this.appObject.removeComponent(this.type);\r\n    }\r\n    super.dispose();\r\n  }\r\n}\r\n"]}

package/dist/cjs/AppObject/AppObjectRepo.js

@@ -4,12 +4,32 @@ exports.AppObjectRepo = void 0;
 exports.makeAppObjectRepo = makeAppObjectRepo;
 const Entities_1 = require("../Entities");
 const AppObject_1 = require("./AppObject");
+/**
+ * Abstract repository class for managing AppObjects and their components.
+ *
+ * This class provides the interface for storing, retrieving, and managing application
+ * objects, their components, and singletons. It also includes logging functionality
+ * and observer pattern implementation for tracking changes to the repository.
+ *
+ * @extends ObservableEntity
+ */
 class AppObjectRepo extends Entities_1.ObservableEntity {
 }
 exports.AppObjectRepo = AppObjectRepo;
+/**
+ * Creates and returns a new AppObjectRepo instance.
+ *
+ * @returns {AppObjectRepo} A new AppObjectRepo instance
+ */
 function makeAppObjectRepo() {
     return new AppObjectRepoImp();
 }
+/**
+ * Implementation of the AppObjectRepo abstract class.
+ *
+ * @private
+ * @extends AppObjectRepo
+ */
 class AppObjectRepoImp extends AppObjectRepo {
     constructor() {
         super(...arguments);

package/dist/cjs/AppObject/AppObjectRepo.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectRepo.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObservableEntity, ObserverList } from \"../Entities\";\r\nimport { AppObject, makeAppObject } from \"./AppObject\";\r\nimport { AppObjectComponent } from \"./AppObjectComponent\";\r\n\r\nexport abstract class AppObjectRepo extends ObservableEntity {\r\n  abstract has(appObjectID: string): boolean;\r\n  abstract add(appObject: AppObject): void;\r\n  abstract remove(appObjectID: string): void;\r\n  abstract get(appObjectID: string): AppObject | undefined;\r\n  abstract getOrCreate(appObjectID: string): AppObject;\r\n  abstract getAll(): AppObject[];\r\n\r\n  abstract submitLog(sender: string, message: string): void;\r\n  abstract submitWarning(sender: string, message: string): void;\r\n  abstract submitError(sender: string, message: string): void;\r\n  abstract submitFatal(sender: string, message: string): void;\r\n\r\n  abstract registerSingleton(component: AppObjectComponent): void;\r\n  abstract getSingleton<T extends AppObjectComponent>(\r\n    type: string\r\n  ): T | undefined;\r\n\r\n  abstract getAppObjectComponent<T extends AppObjectComponent>(\r\n    appObjectID: string,\r\n    type: string\r\n  ): T | undefined;\r\n  abstract getAllAppObjectsWithComponent(componentType: string): AppObject[];\r\n  abstract getAllComponents<T extends AppObjectComponent>(type: string): T[];\r\n\r\n  abstract addAppObjectAddedObserver: (\r\n    observer: (addedEntity: AppObject) => void\r\n  ) => void;\r\n  abstract removeAppObjectAddedObserver: (\r\n    observer: (addedEntity: AppObject) => void\r\n  ) => void;\r\n\r\n  abstract addAppObjectRemovedObserver: (\r\n    observer: (addedEntity: AppObject) => void\r\n  ) => void;\r\n  abstract removedAppObjectRemovedObserver: (\r\n    observer: (addedEntity: AppObject) => void\r\n  ) => void;\r\n}\r\n\r\nexport function makeAppObjectRepo(): AppObjectRepo {\r\n  return new AppObjectRepoImp();\r\n}\r\n\r\nclass AppObjectRepoImp extends AppObjectRepo {\r\n  private appObjectLookup = new Map<string, AppObject>();\r\n  private singletons = new Map<string, AppObjectComponent>();\r\n\r\n  private onAppObjectAddedObserver = new ObserverList<AppObject>();\r\n  addAppObjectAddedObserver = (observer: (addedEntity: AppObject) => void) => {\r\n    this.onAppObjectAddedObserver.add(observer);\r\n  };\r\n  removeAppObjectAddedObserver = (\r\n    observer: (addedEntity: AppObject) => void\r\n  ): void => {\r\n    this.onAppObjectAddedObserver.remove(observer);\r\n  };\r\n\r\n  private onAppObjectRemovedObservers = new ObserverList<AppObject>();\r\n  addAppObjectRemovedObserver = (\r\n    observer: (removedEntity: AppObject) => void\r\n  ) => {\r\n    this.onAppObjectRemovedObservers.add(observer);\r\n  };\r\n  removedAppObjectRemovedObserver = (\r\n    observer: (removedEntity: AppObject) => void\r\n  ): void => {\r\n    this.onAppObjectRemovedObservers.remove(observer);\r\n  };\r\n\r\n  has = (id: string): boolean => {\r\n    return this.appObjectLookup.has(id);\r\n  };\r\n\r\n  add = (appObject: AppObject) => {\r\n    const existing = this.appObjectLookup.get(appObject.id);\r\n    if (existing) {\r\n      existing.removeObserver(this.notify);\r\n    }\r\n\r\n    this.appObjectLookup.set(appObject.id, appObject);\r\n    appObject.addObserver(this.notify);\r\n    this.notify();\r\n    this.onAppObjectAddedObserver.notify(appObject);\r\n  };\r\n\r\n  remove = (id: string) => {\r\n    const existing = this.appObjectLookup.get(id);\r\n    if (!existing) return;\r\n\r\n    this.appObjectLookup.delete(id);\r\n    existing.removeObserver(this.notify);\r\n    this.notify();\r\n    this.onAppObjectRemovedObservers.notify(existing);\r\n  };\r\n\r\n  get = (id: string): AppObject | undefined => {\r\n    return this.appObjectLookup.get(id);\r\n  };\r\n\r\n  getOrCreate = (id: string): AppObject => {\r\n    const existing = this.appObjectLookup.get(id);\r\n\r\n    if (!existing) {\r\n      return makeAppObject(id, this);\r\n    } else {\r\n      return existing;\r\n    }\r\n  };\r\n\r\n  getAll = (): AppObject[] => {\r\n    return Array.from(this.appObjectLookup.values());\r\n  };\r\n\r\n  getAllAppObjectsWithComponent(componentType: string): AppObject[] {\r\n    const rArray: AppObject[] = [];\r\n\r\n    this.appObjectLookup.forEach((appObj) => {\r\n      if (appObj.hasComponent(componentType)) {\r\n        rArray.push(appObj);\r\n      }\r\n    });\r\n\r\n    return rArray;\r\n  }\r\n\r\n  getAllComponents<T extends AppObjectComponent>(type: string): T[] {\r\n    const rArray: T[] = [];\r\n\r\n    this.appObjectLookup.forEach((appObj) => {\r\n      const aoEntity = appObj.getComponent(type);\r\n      if (aoEntity) {\r\n        rArray.push(aoEntity as T);\r\n      }\r\n    });\r\n\r\n    return rArray;\r\n  }\r\n\r\n  getAppObjectComponent<T extends AppObjectComponent>(\r\n    id: string,\r\n    entityType: string\r\n  ): T | undefined {\r\n    const ao = this.appObjectLookup.get(id);\r\n    if (!ao) {\r\n      return undefined;\r\n    }\r\n\r\n    return ao.getComponent(entityType) as T;\r\n  }\r\n\r\n  submitLog(sender: string, message: string): void {\r\n    console.log(`[${sender}]: ${message}`);\r\n  }\r\n  submitWarning(sender: string, message: string): void {\r\n    console.warn(`[${sender}]: ${message}`);\r\n  }\r\n  submitError(sender: string, message: string): void {\r\n    console.error(`[${sender}]: ${message}`);\r\n  }\r\n  submitFatal(sender: string, message: string): void {\r\n    console.error(`FATAL ERROR - [${sender}]: ${message}`);\r\n  }\r\n\r\n  registerSingleton(component: AppObjectComponent): void {\r\n    if (this.singletons.has(component.type)) {\r\n      this.submitWarning(\r\n        \"AppObjectRepo\",\r\n        `Singleton for type ${component.type} already exists. Relpacing`\r\n      );\r\n    }\r\n\r\n    this.singletons.set(component.type, component);\r\n  }\r\n\r\n  getSingleton<T extends AppObjectComponent>(type: string): T | undefined {\r\n    if (this.singletons.has(type)) {\r\n      return this.singletons.get(type) as T;\r\n    }\r\n\r\n    const components = this.getAllComponents<AppObjectComponent>(type);\r\n    if (components.length === 1) {\r\n      this.singletons.set(components[0].type, components[0]);\r\n      return components[0] as T;\r\n    } else if (components.length === 0) {\r\n      this.submitWarning(\r\n        \"AppObjectRepo\",\r\n        `Unable to find a singleton for ${type}`\r\n      );\r\n      return undefined;\r\n    } else if (components.length > 1) {\r\n      this.submitWarning(\r\n        \"AppObjectRepo\",\r\n        `Multiple ${type} found. There should only be one if it truly a singleton. Using the first one`\r\n      );\r\n      return components[0] as T;\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppObjectRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectRepo.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObservableEntity, ObserverList } from \"../Entities\";\r\nimport { AppObject, makeAppObject } from \"./AppObject\";\r\nimport { AppObjectComponent } from \"./AppObjectComponent\";\r\n\r\n/**\r\n * Abstract repository class for managing AppObjects and their components.\r\n *\r\n * This class provides the interface for storing, retrieving, and managing application\r\n * objects, their components, and singletons. It also includes logging functionality\r\n * and observer pattern implementation for tracking changes to the repository.\r\n *\r\n * @extends ObservableEntity\r\n */\r\nexport abstract class AppObjectRepo extends ObservableEntity {\r\n  /**\r\n   * Checks if an AppObject with the specified ID exists in the repository.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject to check\r\n   * @returns {boolean} True if the AppObject exists, false otherwise\r\n   */\r\n  abstract has(appObjectID: string): boolean;\r\n\r\n  /**\r\n   * Adds an AppObject to the repository.\r\n   *\r\n   * @param {AppObject} appObject - The AppObject to add\r\n   */\r\n  abstract add(appObject: AppObject): void;\r\n\r\n  /**\r\n   * Removes an AppObject with the specified ID from the repository.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject to remove\r\n   */\r\n  abstract remove(appObjectID: string): void;\r\n\r\n  /**\r\n   * Gets an AppObject by its ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject to retrieve\r\n   * @returns {AppObject | undefined} The AppObject if found, undefined otherwise\r\n   */\r\n  abstract get(appObjectID: string): AppObject | undefined;\r\n\r\n  /**\r\n   * Gets an AppObject by its ID, or creates a new one if it doesn't exist.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject to retrieve or create\r\n   * @returns {AppObject} The existing or newly created AppObject\r\n   */\r\n  abstract getOrCreate(appObjectID: string): AppObject;\r\n\r\n  /**\r\n   * Gets all AppObjects in the repository.\r\n   *\r\n   * @returns {AppObject[]} An array of all AppObjects\r\n   */\r\n  abstract getAll(): AppObject[];\r\n\r\n  /**\r\n   * Logs an informational message.\r\n   *\r\n   * @param {string} sender - The identifier of the message sender\r\n   * @param {string} message - The message to log\r\n   */\r\n  abstract submitLog(sender: string, message: string): void;\r\n\r\n  /**\r\n   * Logs a warning message.\r\n   *\r\n   * @param {string} sender - The identifier of the message sender\r\n   * @param {string} message - The warning message to log\r\n   */\r\n  abstract submitWarning(sender: string, message: string): void;\r\n\r\n  /**\r\n   * Logs an error message.\r\n   *\r\n   * @param {string} sender - The identifier of the message sender\r\n   * @param {string} message - The error message to log\r\n   */\r\n  abstract submitError(sender: string, message: string): void;\r\n\r\n  /**\r\n   * Logs a fatal error message.\r\n   *\r\n   * @param {string} sender - The identifier of the message sender\r\n   * @param {string} message - The fatal error message to log\r\n   */\r\n  abstract submitFatal(sender: string, message: string): void;\r\n\r\n  /**\r\n   * Registers a component as a singleton in the repository.\r\n   *\r\n   * @param {AppObjectComponent} component - The component to register as a singleton\r\n   */\r\n  abstract registerSingleton(component: AppObjectComponent): void;\r\n\r\n  /**\r\n   * Gets a singleton component of the specified type.\r\n   *\r\n   * @template T - Type of the component to retrieve, must extend AppObjectComponent\r\n   * @param {string} type - The type of the singleton to retrieve\r\n   * @returns {T | undefined} The singleton component if found, undefined otherwise\r\n   */\r\n  abstract getSingleton<T extends AppObjectComponent>(\r\n    type: string\r\n  ): T | undefined;\r\n\r\n  /**\r\n   * Gets a component of the specified type from an AppObject.\r\n   *\r\n   * @template T - Type of the component to retrieve, must extend AppObjectComponent\r\n   * @param {string} appObjectID - The ID of the AppObject containing the component\r\n   * @param {string} type - The type of the component to retrieve\r\n   * @returns {T | undefined} The component if found, undefined otherwise\r\n   */\r\n  abstract getAppObjectComponent<T extends AppObjectComponent>(\r\n    appObjectID: string,\r\n    type: string\r\n  ): T | undefined;\r\n\r\n  /**\r\n   * Gets all AppObjects that have a component of the specified type.\r\n   *\r\n   * @param {string} componentType - The component type to filter by\r\n   * @returns {AppObject[]} An array of AppObjects having the specified component type\r\n   */\r\n  abstract getAllAppObjectsWithComponent(componentType: string): AppObject[];\r\n\r\n  /**\r\n   * Gets all components of the specified type across all AppObjects.\r\n   *\r\n   * @template T - Type of the components to retrieve, must extend AppObjectComponent\r\n   * @param {string} type - The type of components to retrieve\r\n   * @returns {T[]} An array of all components of the specified type\r\n   */\r\n  abstract getAllComponents<T extends AppObjectComponent>(type: string): T[];\r\n\r\n  /**\r\n   * Adds an observer to be notified when an AppObject is added to the repository.\r\n   *\r\n   * @param {(addedEntity: AppObject) => void} observer - The observer function\r\n   */\r\n  abstract addAppObjectAddedObserver: (\r\n    observer: (addedEntity: AppObject) => void\r\n  ) => void;\r\n\r\n  /**\r\n   * Removes an observer previously registered for AppObject addition notifications.\r\n   *\r\n   * @param {(addedEntity: AppObject) => void} observer - The observer function to remove\r\n   */\r\n  abstract removeAppObjectAddedObserver: (\r\n    observer: (addedEntity: AppObject) => void\r\n  ) => void;\r\n\r\n  /**\r\n   * Adds an observer to be notified when an AppObject is removed from the repository.\r\n   *\r\n   * @param {(addedEntity: AppObject) => void} observer - The observer function\r\n   */\r\n  abstract addAppObjectRemovedObserver: (\r\n    observer: (addedEntity: AppObject) => void\r\n  ) => void;\r\n\r\n  /**\r\n   * Removes an observer previously registered for AppObject removal notifications.\r\n   *\r\n   * @param {(addedEntity: AppObject) => void} observer - The observer function to remove\r\n   */\r\n  abstract removedAppObjectRemovedObserver: (\r\n    observer: (addedEntity: AppObject) => void\r\n  ) => void;\r\n}\r\n\r\n/**\r\n * Creates and returns a new AppObjectRepo instance.\r\n *\r\n * @returns {AppObjectRepo} A new AppObjectRepo instance\r\n */\r\nexport function makeAppObjectRepo(): AppObjectRepo {\r\n  return new AppObjectRepoImp();\r\n}\r\n\r\n/**\r\n * Implementation of the AppObjectRepo abstract class.\r\n *\r\n * @private\r\n * @extends AppObjectRepo\r\n */\r\nclass AppObjectRepoImp extends AppObjectRepo {\r\n  private appObjectLookup = new Map<string, AppObject>();\r\n  private singletons = new Map<string, AppObjectComponent>();\r\n\r\n  private onAppObjectAddedObserver = new ObserverList<AppObject>();\r\n  addAppObjectAddedObserver = (observer: (addedEntity: AppObject) => void) => {\r\n    this.onAppObjectAddedObserver.add(observer);\r\n  };\r\n  removeAppObjectAddedObserver = (\r\n    observer: (addedEntity: AppObject) => void\r\n  ): void => {\r\n    this.onAppObjectAddedObserver.remove(observer);\r\n  };\r\n\r\n  private onAppObjectRemovedObservers = new ObserverList<AppObject>();\r\n  addAppObjectRemovedObserver = (\r\n    observer: (removedEntity: AppObject) => void\r\n  ) => {\r\n    this.onAppObjectRemovedObservers.add(observer);\r\n  };\r\n  removedAppObjectRemovedObserver = (\r\n    observer: (removedEntity: AppObject) => void\r\n  ): void => {\r\n    this.onAppObjectRemovedObservers.remove(observer);\r\n  };\r\n\r\n  has = (id: string): boolean => {\r\n    return this.appObjectLookup.has(id);\r\n  };\r\n\r\n  add = (appObject: AppObject) => {\r\n    const existing = this.appObjectLookup.get(appObject.id);\r\n    if (existing) {\r\n      existing.removeObserver(this.notify);\r\n    }\r\n\r\n    this.appObjectLookup.set(appObject.id, appObject);\r\n    appObject.addObserver(this.notify);\r\n    this.notify();\r\n    this.onAppObjectAddedObserver.notify(appObject);\r\n  };\r\n\r\n  remove = (id: string) => {\r\n    const existing = this.appObjectLookup.get(id);\r\n    if (!existing) return;\r\n\r\n    this.appObjectLookup.delete(id);\r\n    existing.removeObserver(this.notify);\r\n    this.notify();\r\n    this.onAppObjectRemovedObservers.notify(existing);\r\n  };\r\n\r\n  get = (id: string): AppObject | undefined => {\r\n    return this.appObjectLookup.get(id);\r\n  };\r\n\r\n  getOrCreate = (id: string): AppObject => {\r\n    const existing = this.appObjectLookup.get(id);\r\n\r\n    if (!existing) {\r\n      return makeAppObject(id, this);\r\n    } else {\r\n      return existing;\r\n    }\r\n  };\r\n\r\n  getAll = (): AppObject[] => {\r\n    return Array.from(this.appObjectLookup.values());\r\n  };\r\n\r\n  getAllAppObjectsWithComponent(componentType: string): AppObject[] {\r\n    const rArray: AppObject[] = [];\r\n\r\n    this.appObjectLookup.forEach((appObj) => {\r\n      if (appObj.hasComponent(componentType)) {\r\n        rArray.push(appObj);\r\n      }\r\n    });\r\n\r\n    return rArray;\r\n  }\r\n\r\n  getAllComponents<T extends AppObjectComponent>(type: string): T[] {\r\n    const rArray: T[] = [];\r\n\r\n    this.appObjectLookup.forEach((appObj) => {\r\n      const aoEntity = appObj.getComponent(type);\r\n      if (aoEntity) {\r\n        rArray.push(aoEntity as T);\r\n      }\r\n    });\r\n\r\n    return rArray;\r\n  }\r\n\r\n  getAppObjectComponent<T extends AppObjectComponent>(\r\n    id: string,\r\n    entityType: string\r\n  ): T | undefined {\r\n    const ao = this.appObjectLookup.get(id);\r\n    if (!ao) {\r\n      return undefined;\r\n    }\r\n\r\n    return ao.getComponent(entityType) as T;\r\n  }\r\n\r\n  submitLog(sender: string, message: string): void {\r\n    console.log(`[${sender}]: ${message}`);\r\n  }\r\n  submitWarning(sender: string, message: string): void {\r\n    console.warn(`[${sender}]: ${message}`);\r\n  }\r\n  submitError(sender: string, message: string): void {\r\n    console.error(`[${sender}]: ${message}`);\r\n  }\r\n  submitFatal(sender: string, message: string): void {\r\n    console.error(`FATAL ERROR - [${sender}]: ${message}`);\r\n  }\r\n\r\n  registerSingleton(component: AppObjectComponent): void {\r\n    if (this.singletons.has(component.type)) {\r\n      this.submitWarning(\r\n        \"AppObjectRepo\",\r\n        `Singleton for type ${component.type} already exists. Relpacing`\r\n      );\r\n    }\r\n\r\n    this.singletons.set(component.type, component);\r\n  }\r\n\r\n  getSingleton<T extends AppObjectComponent>(type: string): T | undefined {\r\n    if (this.singletons.has(type)) {\r\n      return this.singletons.get(type) as T;\r\n    }\r\n\r\n    const components = this.getAllComponents<AppObjectComponent>(type);\r\n    if (components.length === 1) {\r\n      this.singletons.set(components[0].type, components[0]);\r\n      return components[0] as T;\r\n    } else if (components.length === 0) {\r\n      this.submitWarning(\r\n        \"AppObjectRepo\",\r\n        `Unable to find a singleton for ${type}`\r\n      );\r\n      return undefined;\r\n    } else if (components.length > 1) {\r\n      this.submitWarning(\r\n        \"AppObjectRepo\",\r\n        `Multiple ${type} found. There should only be one if it truly a singleton. Using the first one`\r\n      );\r\n      return components[0] as T;\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/cjs/AppObject/AppObjectUC.js

@@ -2,9 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppObjectUC = void 0;
 const AppObjectComponent_1 = require("./AppObjectComponent");
+/**
+ * AppObjectUC (Use Case) serves as a base use case class within the application framework.
+ *
+ * Use Cases are components that represent specific application operations or workflows.
+ * They encapsulate business rules and coordinate interactions between different parts
+ * of the application. Extend this class to implement specific use case scenarios.
+ *
+ * @extends AppObjectComponent
+ * @example
+ * ```typescript
+ * class PurchaseItemUC extends AppObjectUC {
+ *   execute(itemId: string, quantity: number): boolean {
+ *     // Implement the purchase item use case
+ *     return true; // if successful
+ *   }
+ * }
+ * ```
+ */
 class AppObjectUC extends AppObjectComponent_1.AppObjectComponent {
     constructor() {
         super(...arguments);
+        /**
+         * The component type identifier used to categorize this component as a use case
+         * This property helps the component system identify and manage use case components.
+         * @readonly
+         */
         this.componentType = AppObjectComponent_1.AppObjectComponentType.UC;
     }
 }

package/dist/cjs/AppObject/AppObjectUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectUC.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectUC.ts"],"names":[],"mappings":";;;AAAA,6DAAkF;AAElF,MAAa,WAAY,SAAQ,uCAAkB;IAAnD;;QACU,kBAAa,GAAG,2CAAsB,CAAC,EAAE,CAAC;IACpD,CAAC;CAAA;AAFD,kCAEC","sourcesContent":["import { AppObjectComponent, AppObjectComponentType } from \"./AppObjectComponent\";\r\n\r\nexport class AppObjectUC extends AppObjectComponent {\r\n\treadonly componentType = AppObjectComponentType.UC;\r\n}\r\n"]}
+{"version":3,"file":"AppObjectUC.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectUC.ts"],"names":[],"mappings":";;;AAAA,6DAG8B;AAE9B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,WAAY,SAAQ,uCAAkB;IAAnD;;QACE;;;;WAIG;QACM,kBAAa,GAAG,2CAAsB,CAAC,EAAE,CAAC;IACrD,CAAC;CAAA;AAPD,kCAOC","sourcesContent":["import {\r\n  AppObjectComponent,\r\n  AppObjectComponentType,\r\n} from \"./AppObjectComponent\";\r\n\r\n/**\r\n * AppObjectUC (Use Case) serves as a base use case class within the application framework.\r\n *\r\n * Use Cases are components that represent specific application operations or workflows.\r\n * They encapsulate business rules and coordinate interactions between different parts\r\n * of the application. Extend this class to implement specific use case scenarios.\r\n *\r\n * @extends AppObjectComponent\r\n * @example\r\n * ```typescript\r\n * class PurchaseItemUC extends AppObjectUC {\r\n *   execute(itemId: string, quantity: number): boolean {\r\n *     // Implement the purchase item use case\r\n *     return true; // if successful\r\n *   }\r\n * }\r\n * ```\r\n */\r\nexport class AppObjectUC extends AppObjectComponent {\r\n  /**\r\n   * The component type identifier used to categorize this component as a use case\r\n   * This property helps the component system identify and manage use case components.\r\n   * @readonly\r\n   */\r\n  readonly componentType = AppObjectComponentType.UC;\r\n}\r\n"]}

package/dist/cjs/AppObject/AppObjectView.js

@@ -2,9 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppObjectView = void 0;
 const AppObjectComponent_1 = require("./AppObjectComponent");
+/**
+ * AppObjectView serves as a base view class within the application framework.
+ *
+ * Views are components that handle the visual representation of an AppObject,
+ * such as rendering, animations, or user interface elements. Extend this class
+ * to create custom visual representations for specific application objects.
+ *
+ * @extends AppObjectComponent
+ * @example
+ * ```typescript
+ * class PlayerView extends AppObjectView {
+ *   render(renderContext: RenderContext) {
+ *     // Render the player character on screen
+ *   }
+ * }
+ * ```
+ */
 class AppObjectView extends AppObjectComponent_1.AppObjectComponent {
     constructor() {
         super(...arguments);
+        /**
+         * The component type identifier used to categorize this component as a view
+         * This property helps the component system identify and manage view components.
+         * @readonly
+         */
         this.componentType = AppObjectComponent_1.AppObjectComponentType.VIEW;
     }
 }

package/dist/cjs/AppObject/AppObjectView.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectView.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectView.ts"],"names":[],"mappings":";;;AAAA,6DAAkF;AAElF,MAAa,aAAc,SAAQ,uCAAkB;IAArD;;QACU,kBAAa,GAAG,2CAAsB,CAAC,IAAI,CAAC;IACtD,CAAC;CAAA;AAFD,sCAEC","sourcesContent":["import { AppObjectComponent, AppObjectComponentType } from \"./AppObjectComponent\";\r\n\r\nexport class AppObjectView extends AppObjectComponent {\r\n\treadonly componentType = AppObjectComponentType.VIEW;\r\n}"]}
+{"version":3,"file":"AppObjectView.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectView.ts"],"names":[],"mappings":";;;AAAA,6DAG8B;AAE9B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,aAAc,SAAQ,uCAAkB;IAArD;;QACE;;;;WAIG;QACM,kBAAa,GAAG,2CAAsB,CAAC,IAAI,CAAC;IACvD,CAAC;CAAA;AAPD,sCAOC","sourcesContent":["import {\r\n  AppObjectComponent,\r\n  AppObjectComponentType,\r\n} from \"./AppObjectComponent\";\r\n\r\n/**\r\n * AppObjectView serves as a base view class within the application framework.\r\n *\r\n * Views are components that handle the visual representation of an AppObject,\r\n * such as rendering, animations, or user interface elements. Extend this class\r\n * to create custom visual representations for specific application objects.\r\n *\r\n * @extends AppObjectComponent\r\n * @example\r\n * ```typescript\r\n * class PlayerView extends AppObjectView {\r\n *   render(renderContext: RenderContext) {\r\n *     // Render the player character on screen\r\n *   }\r\n * }\r\n * ```\r\n */\r\nexport class AppObjectView extends AppObjectComponent {\r\n  /**\r\n   * The component type identifier used to categorize this component as a view\r\n   * This property helps the component system identify and manage view components.\r\n   * @readonly\r\n   */\r\n  readonly componentType = AppObjectComponentType.VIEW;\r\n}\r\n"]}

package/dist/cjs/AppObject/getSingletonComponent.js

@@ -1,6 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSingletonComponent = getSingletonComponent;
+/**
+ * Retrieves a singleton component of the specified type from the application objects repository.
+ *
+ * This utility function provides a convenient way to access singleton components that should
+ * have only one instance across the entire application.
+ *
+ * @template T - Type of the component to retrieve, must extend AppObjectComponent
+ * @param {string} type - The type identifier of the component to retrieve
+ * @param {AppObjectRepo} appObjects - The repository containing all application objects
+ * @returns {T | undefined} The singleton component instance if found, otherwise undefined
+ *
+ * @example
+ * ```typescript
+ * const cameraController = getSingletonComponent<CameraController>(CameraController.type, appObjectRepo);
+ * if (cameraController) {
+ *   cameraController.focusOn(targetObject);
+ * }
+ * ```
+ */
 function getSingletonComponent(type, appObjects) {
     return appObjects.getSingleton(type);
 }

package/dist/cjs/AppObject/getSingletonComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSingletonComponent.js","sourceRoot":"","sources":["../../../src/AppObject/getSingletonComponent.ts"],"names":[],"mappings":";;AAGA,sDAKC;AALD,SAAgB,qBAAqB,CACnC,IAAY,EACZ,UAAyB;IAEzB,OAAO,UAAU,CAAC,YAAY,CAAI,IAAI,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["import { AppObjectComponent } from \"./AppObjectComponent\";\r\nimport { AppObjectRepo } from \"./AppObjectRepo\";\r\n\r\nexport function getSingletonComponent<T extends AppObjectComponent>(\r\n  type: string,\r\n  appObjects: AppObjectRepo\r\n): T | undefined {\r\n  return appObjects.getSingleton<T>(type);\r\n}\r\n"]}
+{"version":3,"file":"getSingletonComponent.js","sourceRoot":"","sources":["../../../src/AppObject/getSingletonComponent.ts"],"names":[],"mappings":";;AAsBA,sDAKC;AAxBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,qBAAqB,CACnC,IAAY,EACZ,UAAyB;IAEzB,OAAO,UAAU,CAAC,YAAY,CAAI,IAAI,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["import { AppObjectComponent } from \"./AppObjectComponent\";\r\nimport { AppObjectRepo } from \"./AppObjectRepo\";\r\n\r\n/**\r\n * Retrieves a singleton component of the specified type from the application objects repository.\r\n *\r\n * This utility function provides a convenient way to access singleton components that should\r\n * have only one instance across the entire application.\r\n *\r\n * @template T - Type of the component to retrieve, must extend AppObjectComponent\r\n * @param {string} type - The type identifier of the component to retrieve\r\n * @param {AppObjectRepo} appObjects - The repository containing all application objects\r\n * @returns {T | undefined} The singleton component instance if found, otherwise undefined\r\n *\r\n * @example\r\n * ```typescript\r\n * const cameraController = getSingletonComponent<CameraController>(CameraController.type, appObjectRepo);\r\n * if (cameraController) {\r\n *   cameraController.focusOn(targetObject);\r\n * }\r\n * ```\r\n */\r\nexport function getSingletonComponent<T extends AppObjectComponent>(\r\n  type: string,\r\n  appObjects: AppObjectRepo\r\n): T | undefined {\r\n  return appObjects.getSingleton<T>(type);\r\n}\r\n"]}

package/dist/cjs/Entities/MemoizedAngle.js

@@ -1,19 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoizedAngle = void 0;
+/**
+ * A wrapper class for Angle objects that tracks changes and triggers callbacks.
+ * Only triggers the callback when the angle value actually changes.
+ */
 class MemoizedAngle {
+    /**
+     * Gets the current angle value
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the angle value and triggers the onChange callback if the value changed
+     * @param b - The new Angle value
+     */
     set val(b) {
         if (this._val.degrees === b.degrees)
             return;
         this._val = b;
         this.onChangeCallback();
     }
+    /**
+     * Sets the value without triggering the onChange callback
+     * @param val - The new Angle value
+     */
     setValQuietly(val) {
         this._val = val;
     }
+    /**
+     * Creates a new MemoizedAngle instance
+     *
+     * @param initialValue - The initial Angle value
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(initialValue, onChangeCallback) {
         this._val = initialValue;
         this.onChangeCallback = onChangeCallback;

package/dist/cjs/Entities/MemoizedAngle.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedAngle.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedAngle.ts"],"names":[],"mappings":";;;AAEA,MAAa,aAAa;IAExB,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,CAAQ;QACd,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO;QAE5C,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,GAAU;QAC7B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID,YAAY,YAAmB,EAAE,gBAA4B;QAC3D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF;AAtBD,sCAsBC","sourcesContent":["import { Angle } from \"../ValueObjects\";\r\n\r\nexport class MemoizedAngle {\r\n  private _val: Angle;\r\n  get val(): Angle {\r\n    return this._val;\r\n  }\r\n  set val(b: Angle) {\r\n    if (this._val.degrees === b.degrees) return;\r\n\r\n    this._val = b;\r\n    this.onChangeCallback();\r\n  }\r\n\r\n  public setValQuietly(val: Angle) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(initialValue: Angle, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MemoizedAngle.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedAngle.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,aAAa;IAGxB;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAQ;QACd,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO;QAE5C,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,GAAU;QAC7B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID;;;;;OAKG;IACH,YAAY,YAAmB,EAAE,gBAA4B;QAC3D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF;AAzCD,sCAyCC","sourcesContent":["import { Angle } from \"../ValueObjects\";\r\n\r\n/**\r\n * A wrapper class for Angle objects that tracks changes and triggers callbacks.\r\n * Only triggers the callback when the angle value actually changes.\r\n */\r\nexport class MemoizedAngle {\r\n  private _val: Angle;\r\n\r\n  /**\r\n   * Gets the current angle value\r\n   */\r\n  get val(): Angle {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the angle value and triggers the onChange callback if the value changed\r\n   * @param b - The new Angle value\r\n   */\r\n  set val(b: Angle) {\r\n    if (this._val.degrees === b.degrees) 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 Angle value\r\n   */\r\n  public setValQuietly(val: Angle) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new MemoizedAngle instance\r\n   *\r\n   * @param initialValue - The initial Angle value\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(initialValue: Angle, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}

package/dist/cjs/Entities/MemoizedBoolean.js

@@ -1,19 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoizedBoolean = void 0;
+/**
+ * A wrapper class for boolean values that tracks changes and triggers callbacks.
+ * Only triggers the callback when the value actually changes.
+ */
 class MemoizedBoolean {
+    /**
+     * Gets the current boolean value
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the boolean value and triggers the onChange callback if the value changed
+     * @param b - The new boolean 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 boolean value
+     */
     setValQuietly(val) {
         this._val = val;
     }
+    /**
+     * Creates a new MemoizedBoolean instance
+     *
+     * @param initialValue - The initial boolean value
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(initialValue, onChangeCallback) {
         this._val = initialValue;
         this.onChangeCallback = onChangeCallback;

package/dist/cjs/Entities/MemoizedBoolean.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedBoolean.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedBoolean.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAe;IAE1B,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,CAAU;QAChB,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,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;AAtBD,0CAsBC","sourcesContent":["export class MemoizedBoolean {\r\n  private _val: boolean;\r\n  get val(): boolean {\r\n    return this._val;\r\n  }\r\n  set val(b: boolean) {\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: boolean) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(initialValue: boolean, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MemoizedBoolean.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedBoolean.ts"],"names":[],"mappings":";;;AAAA;;;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,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,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":["/**\r\n * A wrapper class for boolean values that tracks changes and triggers callbacks.\r\n * Only triggers the callback when the value actually changes.\r\n */\r\nexport class MemoizedBoolean {\r\n  private _val: boolean;\r\n\r\n  /**\r\n   * Gets the current boolean value\r\n   */\r\n  get val(): boolean {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the boolean value and triggers the onChange callback if the value changed\r\n   * @param b - The new boolean value\r\n   */\r\n  set val(b: boolean) {\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 boolean value\r\n   */\r\n  public setValQuietly(val: boolean) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new MemoizedBoolean instance\r\n   *\r\n   * @param initialValue - The initial boolean value\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(initialValue: boolean, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}

package/dist/cjs/Entities/MemoizedColor.js

@@ -2,19 +2,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoizedColor = void 0;
 const ValueObjects_1 = require("../ValueObjects");
+/**
+ * A wrapper class for Color objects that tracks changes and triggers callbacks.
+ * Only triggers the callback when the color value actually changes.
+ */
 class MemoizedColor {
+    /**
+     * Gets the current Color value
+     */
     get val() {
         return this._val;
     }
+    /**
+     * Sets the Color value and triggers the onChange callback if the value changed
+     * @param v - The new Color value
+     */
     set val(v) {
         if (ValueObjects_1.Color.Equal(v, this._val))
             return;
         this._val = v;
         this.onChangeCallback();
     }
+    /**
+     * Sets the value without triggering the onChange callback
+     * @param val - The new Color value
+     */
     setValQuietly(val) {
         this._val = val;
     }
+    /**
+     * Creates a new MemoizedColor instance
+     *
+     * @param initialValue - The initial Color value
+     * @param onChangeCallback - Function to call when the value changes
+     */
     constructor(initialValue, onChangeCallback) {
         this._val = initialValue;
         this.onChangeCallback = onChangeCallback;

package/dist/cjs/Entities/MemoizedColor.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemoizedColor.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedColor.ts"],"names":[],"mappings":";;;AAAA,kDAAwC;AAExC,MAAa,aAAa;IAGxB,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,CAAC,CAAQ;QACd,IAAI,oBAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAEtC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEM,aAAa,CAAC,GAAU;QAC7B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID,YAAY,YAAmB,EAAE,gBAA4B;QAC3D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF;AAxBD,sCAwBC","sourcesContent":["import { Color } from \"../ValueObjects\";\r\n\r\nexport class MemoizedColor {\r\n  private _val: Color;\r\n\r\n  get val(): Color {\r\n    return this._val;\r\n  }\r\n\r\n  set val(v: Color) {\r\n    if (Color.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: Color) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  constructor(initialValue: Color, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"MemoizedColor.js","sourceRoot":"","sources":["../../../src/Entities/MemoizedColor.ts"],"names":[],"mappings":";;;AAAA,kDAAwC;AAExC;;;GAGG;AACH,MAAa,aAAa;IAGxB;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,IAAI,GAAG,CAAC,CAAQ;QACd,IAAI,oBAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QAEtC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,GAAU;QAC7B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAID;;;;;OAKG;IACH,YAAY,YAAmB,EAAE,gBAA4B;QAC3D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF;AAzCD,sCAyCC","sourcesContent":["import { Color } from \"../ValueObjects\";\r\n\r\n/**\r\n * A wrapper class for Color objects that tracks changes and triggers callbacks.\r\n * Only triggers the callback when the color value actually changes.\r\n */\r\nexport class MemoizedColor {\r\n  private _val: Color;\r\n\r\n  /**\r\n   * Gets the current Color value\r\n   */\r\n  get val(): Color {\r\n    return this._val;\r\n  }\r\n\r\n  /**\r\n   * Sets the Color value and triggers the onChange callback if the value changed\r\n   * @param v - The new Color value\r\n   */\r\n  set val(v: Color) {\r\n    if (Color.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 Color value\r\n   */\r\n  public setValQuietly(val: Color) {\r\n    this._val = val;\r\n  }\r\n\r\n  private onChangeCallback: () => void;\r\n\r\n  /**\r\n   * Creates a new MemoizedColor instance\r\n   *\r\n   * @param initialValue - The initial Color value\r\n   * @param onChangeCallback - Function to call when the value changes\r\n   */\r\n  constructor(initialValue: Color, onChangeCallback: () => void) {\r\n    this._val = initialValue;\r\n    this.onChangeCallback = onChangeCallback;\r\n  }\r\n}\r\n"]}