@vived/core 1.4.1 → 1.4.3

package/dist/cjs/AppObject/AppObjectEntityRepo.js

@@ -0,0 +1,130 @@
+"use strict";
+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)
+                return;
+            this.entityLookup.delete(id);
+            existing.removeChangeObserver(this.notifyOnChange);
+            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) {
+            existing.removeChangeObserver(this.notifyOnChange);
+        }
+        this.entityLookup.set(entity.appObject.id, entity);
+        entity.addChangeObserver(this.notifyOnChange);
+        this.notifyOnChange();
+        this.onEntityAddedObservers.notify(entity);
+    }
+}
+exports.AppObjectEntityRepo = AppObjectEntityRepo;
+//# sourceMappingURL=AppObjectEntityRepo.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,86 @@
+"use strict";
+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) {
+            this.appObject.removeComponent(this.type);
+        }
+        super.dispose();
+    }
+}
+exports.AppObjectPM = AppObjectPM;
+//# sourceMappingURL=AppObjectPM.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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);
+        this.appObjectLookup = new Map();
+        this.singletons = new Map();
+        this.onAppObjectAddedObserver = new Entities_1.ObserverList();
+        this.addAppObjectAddedObserver = (observer) => {
+            this.onAppObjectAddedObserver.add(observer);
+        };
+        this.removeAppObjectAddedObserver = (observer) => {
+            this.onAppObjectAddedObserver.remove(observer);
+        };
+        this.onAppObjectRemovedObservers = new Entities_1.ObserverList();
+        this.addAppObjectRemovedObserver = (observer) => {
+            this.onAppObjectRemovedObservers.add(observer);
+        };
+        this.removedAppObjectRemovedObserver = (observer) => {
+            this.onAppObjectRemovedObservers.remove(observer);
+        };
+        this.has = (id) => {
+            return this.appObjectLookup.has(id);
+        };
+        this.add = (appObject) => {
+            const existing = this.appObjectLookup.get(appObject.id);
+            if (existing) {
+                existing.removeObserver(this.notify);
+            }
+            this.appObjectLookup.set(appObject.id, appObject);
+            appObject.addObserver(this.notify);
+            this.notify();
+            this.onAppObjectAddedObserver.notify(appObject);
+        };
+        this.remove = (id) => {
+            const existing = this.appObjectLookup.get(id);
+            if (!existing)
+                return;
+            this.appObjectLookup.delete(id);
+            existing.removeObserver(this.notify);
+            this.notify();
+            this.onAppObjectRemovedObservers.notify(existing);
+        };
+        this.get = (id) => {
+            return this.appObjectLookup.get(id);
+        };
+        this.getOrCreate = (id) => {
+            const existing = this.appObjectLookup.get(id);
+            if (!existing) {
+                return (0, AppObject_1.makeAppObject)(id, this);
+            }
+            else {
+                return existing;
+            }
+        };
+        this.getAll = () => {
+            return Array.from(this.appObjectLookup.values());
+        };
+    }
+    getAllAppObjectsWithComponent(componentType) {
+        const rArray = [];
+        this.appObjectLookup.forEach((appObj) => {
+            if (appObj.hasComponent(componentType)) {
+                rArray.push(appObj);
+            }
+        });
+        return rArray;
+    }
+    getAllComponents(type) {
+        const rArray = [];
+        this.appObjectLookup.forEach((appObj) => {
+            const aoEntity = appObj.getComponent(type);
+            if (aoEntity) {
+                rArray.push(aoEntity);
+            }
+        });
+        return rArray;
+    }
+    getAppObjectComponent(id, entityType) {
+        const ao = this.appObjectLookup.get(id);
+        if (!ao) {
+            return undefined;
+        }
+        return ao.getComponent(entityType);
+    }
+    submitLog(sender, message) {
+        console.log(`[${sender}]: ${message}`);
+    }
+    submitWarning(sender, message) {
+        console.warn(`[${sender}]: ${message}`);
+    }
+    submitError(sender, message) {
+        console.error(`[${sender}]: ${message}`);
+    }
+    submitFatal(sender, message) {
+        console.error(`FATAL ERROR - [${sender}]: ${message}`);
+    }
+    registerSingleton(component) {
+        if (this.singletons.has(component.type)) {
+            this.submitWarning("AppObjectRepo", `Singleton for type ${component.type} already exists. Relpacing`);
+        }
+        this.singletons.set(component.type, component);
+    }
+    getSingleton(type) {
+        if (this.singletons.has(type)) {
+            return this.singletons.get(type);
+        }
+        const components = this.getAllComponents(type);
+        if (components.length === 1) {
+            this.singletons.set(components[0].type, components[0]);
+            return components[0];
+        }
+        else if (components.length === 0) {
+            this.submitWarning("AppObjectRepo", `Unable to find a singleton for ${type}`);
+            return undefined;
+        }
+        else if (components.length > 1) {
+            this.submitWarning("AppObjectRepo", `Multiple ${type} found. There should only be one if it truly a singleton. Using the first one`);
+            return components[0];
+        }
+    }
+}
+//# sourceMappingURL=AppObjectRepo.js.map

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

@@ -0,0 +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\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

@@ -0,0 +1,35 @@
+"use strict";
+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;
+    }
+}
+exports.AppObjectUC = AppObjectUC;
+//# sourceMappingURL=AppObjectUC.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,34 @@
+"use strict";
+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;
+    }
+}
+exports.AppObjectView = AppObjectView;
+//# sourceMappingURL=AppObjectView.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,26 @@
+"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);
+}
+//# sourceMappingURL=getSingletonComponent.js.map

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

@@ -0,0 +1 @@
+{"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/AppObject/index.js

@@ -0,0 +1,27 @@
+"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("./AppObject"), exports);
+__exportStar(require("./AppObjectEntity"), exports);
+__exportStar(require("./AppObjectEntityRepo"), exports);
+__exportStar(require("./AppObjectPM"), exports);
+__exportStar(require("./AppObjectRepo"), exports);
+__exportStar(require("./AppObjectUC"), exports);
+__exportStar(require("./AppObjectController"), exports);
+__exportStar(require("./AppObjectView"), exports);
+__exportStar(require("./getSingletonComponent"), exports);
+__exportStar(require("./printAppObjectDetails"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/AppObject/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,oDAAiC;AACjC,wDAAqC;AACrC,gDAA6B;AAC7B,kDAA+B;AAC/B,gDAA6B;AAC7B,wDAAqC;AACrC,kDAA+B;AAC/B,0DAAwC;AACxC,0DAAwC","sourcesContent":["export * from \"./AppObject\"\r\nexport * from \"./AppObjectEntity\"\r\nexport * from \"./AppObjectEntityRepo\"\r\nexport * from \"./AppObjectPM\"\r\nexport * from \"./AppObjectRepo\"\r\nexport * from \"./AppObjectUC\"\r\nexport * from \"./AppObjectController\"\r\nexport * from \"./AppObjectView\"\r\nexport * from \"./getSingletonComponent\";\r\nexport * from \"./printAppObjectDetails\";"]}

package/dist/cjs/AppObject/printAppObjectDetails.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printAppObjectDetails = printAppObjectDetails;
+function printAppObjectDetails(id, appObjects) {
+    const appObject = appObjects.get(id);
+    if (!appObject) {
+        console.warn("[printAppObjectDetails] Unable to find App Object by ID");
+        return;
+    }
+    console.log("[printAppObjectDetails] Start App Object Details ---");
+    console.log(`id: ${appObject.id}`);
+    const components = appObject.allComponents();
+    components.forEach((component) => {
+        console.log(`Has Component: ${component.type}`);
+    });
+    console.log("[printAppObjectDetails] End App Object Details ---");
+}
+//# sourceMappingURL=printAppObjectDetails.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"printAppObjectDetails.js","sourceRoot":"","sources":["../../../src/AppObject/printAppObjectDetails.ts"],"names":[],"mappings":";;AAEA,sDAcC;AAdD,SAAgB,qBAAqB,CAAC,EAAU,EAAE,UAAyB;IACzE,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QACxE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,OAAO,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC;IAC7C,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/B,OAAO,CAAC,GAAG,CAAC,kBAAkB,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;AACpE,CAAC","sourcesContent":["import { AppObjectRepo } from \"./AppObjectRepo\";\r\n\r\nexport function printAppObjectDetails(id: string, appObjects: AppObjectRepo) {\r\n  const appObject = appObjects.get(id);\r\n  if (!appObject) {\r\n    console.warn(\"[printAppObjectDetails] Unable to find App Object by ID\");\r\n    return;\r\n  }\r\n\r\n  console.log(\"[printAppObjectDetails] Start App Object Details ---\");\r\n  console.log(`id: ${appObject.id}`);\r\n  const components = appObject.allComponents();\r\n  components.forEach((component) => {\r\n    console.log(`Has Component: ${component.type}`);\r\n  });\r\n  console.log(\"[printAppObjectDetails] End App Object Details ---\");\r\n}\r\n"]}

package/dist/cjs/Entities/MemoizedAngle.js

@@ -0,0 +1,44 @@
+"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;
+    }
+}
+exports.MemoizedAngle = MemoizedAngle;
+//# sourceMappingURL=MemoizedAngle.js.map