@vived/core 1.6.0 → 2.0.1

package/dist/esm/ExampleFeature/PMs/ExampleSingletonPM.js

@@ -6,10 +6,10 @@
  * accessed globally. They transform data from singleton entities into view models.
  *
  * Key concepts:
- * - Singleton PMs extend AppObjectPM<VM> like regular PMs
- * - They register themselves as singletons with appObjects.registerSingleton()
+ * - Singleton PMs extend AppObjectSingletonPM<VM> which handles singleton registration automatically
  * - They're accessed through a static get() method using getSingletonComponent()
  * - They typically observe singleton entities and provide data to multiple UI components
+ * - They use formVM() to transform entity data into view models
  *
  * Usage pattern:
  * 1. Access the singleton PM using the static get() method
@@ -17,14 +17,14 @@
  * 3. PM will call the view callbacks with updated view models when entities change
  * 4. Remove UI components with removeView(callback) when they're unmounted
  */
-import { AppObjectPM, } from "../../AppObject";
+import { AppObjectSingletonPM, } from "../../AppObject";
 import { getSingletonComponent } from "../../AppObject/getSingletonComponent";
 import { SingletonEntityExample } from "../Entities/ExampleSingletonEntity";
 /**
  * ExampleSingletonPM transforms SingletonEntityExample data into an ExampleVM.
  * As a singleton, only one instance exists in the application.
  */
-export class ExampleSingletonPM extends AppObjectPM {
+export class ExampleSingletonPM extends AppObjectSingletonPM {
 }
 /** Unique type identifier for this component */
 ExampleSingletonPM.type = "ExampleSingletonPMType";
@@ -39,7 +39,7 @@ ExampleSingletonPM.get = (appObjects) => getSingletonComponent(ExampleSingletonP
  * UI components can use this initially or when the PM is not found
  */
 export const defaultSlideNavigationVM = {
-    aBoolProperty: true
+    aBoolProperty: true,
 };
 /**
  * Factory function to create a new ExampleSingletonPM
@@ -73,12 +73,10 @@ class ExampleSingletonPMImp extends ExampleSingletonPM {
     constructor(appObject) {
         super(appObject, ExampleSingletonPM.type);
         /**
-         * Handler for entity change events
          * Transforms entity data into a view model and updates views
+         * Called automatically when observed entities change
          */
-        this.onEntityChange = () => {
-            if (!this.exampleEntity)
-                return;
+        this.formVM = () => {
             // Extract the boolean property from the entity
             const aBoolProperty = this.exampleEntity.aBoolProperty;
             // Create a view model with the extracted data
@@ -87,11 +85,9 @@ class ExampleSingletonPMImp extends ExampleSingletonPM {
             this.doUpdateView(vm);
         };
         // Register as an observer of the entity to receive change notifications
-        this.exampleEntity?.addChangeObserver(this.onEntityChange);
+        this.observeEntity(this.exampleEntity);
         // Call the change handler initially to set up the initial view model
-        this.onEntityChange();
-        // Register this PM as a singleton so it can be accessed globally
-        this.appObjects.registerSingleton(this);
+        this.formVM();
     }
 }
 //# sourceMappingURL=ExampleSingletonPM.js.map

package/dist/esm/ExampleFeature/PMs/ExampleSingletonPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExampleSingletonPM.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/PMs/ExampleSingletonPM.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,WAAW,GAEZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAS5E;;;GAGG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,WAAsB;;AACrE,gDAAgD;AAChC,uBAAI,GAAG,wBAAwB,CAAC;AAEhD;;;;GAIG;AACI,sBAAG,GAAG,CAAC,UAAyB,EAAkC,EAAE,CACzE,qBAAqB,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAG/D;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAc;IACjD,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAoB;IAEpB,OAAO,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,qBAAsB,SAAQ,kBAAkB;IACpD;;;OAGG;IACH,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,sBAAsB,CAAC,IAAI,CAC5B,CAAC;IACJ,CAAC;IAmBD;;;OAGG;IACH,WAAW,CAAC,CAAY,EAAE,CAAY;QACpC,IAAI,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;QA3B5C;;;WAGG;QACH,mBAAc,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,aAAa;gBAAE,OAAO;YAEhC,+CAA+C;YAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC;YAEvD,8CAA8C;YAC9C,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;YAE7B,sDAAsD;YACtD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAcA,wEAAwE;QACxE,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAE3D,qEAAqE;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,iEAAiE;QACjE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["/**\r\n * ExampleSingletonPM.ts\r\n * \r\n * This file demonstrates how to implement a Singleton Presentation Manager (PM).\r\n * Singleton PMs are special PMs that exist only once in the application and can be\r\n * accessed globally. They transform data from singleton entities into view models.\r\n * \r\n * Key concepts:\r\n * - Singleton PMs extend AppObjectPM<VM> like regular PMs\r\n * - They register themselves as singletons with appObjects.registerSingleton()\r\n * - They're accessed through a static get() method using getSingletonComponent()\r\n * - They typically observe singleton entities and provide data to multiple UI components\r\n * \r\n * Usage pattern:\r\n * 1. Access the singleton PM using the static get() method\r\n * 2. Register UI components as views using addView(callback)\r\n * 3. PM will call the view callbacks with updated view models when entities change\r\n * 4. Remove UI components with removeView(callback) when they're unmounted\r\n */\r\n\r\nimport {\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo,\r\n} from \"../../AppObject\";\r\nimport { getSingletonComponent } from \"../../AppObject/getSingletonComponent\";\r\nimport { SingletonEntityExample } from \"../Entities/ExampleSingletonEntity\";\r\n\r\n/**\r\n * Interface defining the structure of the view model provided by ExampleSingletonPM\r\n */\r\nexport interface ExampleVM {\r\n  aBoolProperty: boolean;\r\n}\r\n\r\n/**\r\n * ExampleSingletonPM transforms SingletonEntityExample data into an ExampleVM.\r\n * As a singleton, only one instance exists in the application.\r\n */\r\nexport abstract class ExampleSingletonPM extends AppObjectPM<ExampleVM> {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"ExampleSingletonPMType\";\r\n\r\n  /**\r\n   * Global accessor for the singleton PM\r\n   * @param appObjects The AppObjectRepo to search in\r\n   * @returns The singleton PM or undefined if not created yet\r\n   */\r\n  static get = (appObjects: AppObjectRepo): ExampleSingletonPM | undefined =>\r\n    getSingletonComponent(ExampleSingletonPM.type, appObjects);\r\n}\r\n\r\n/**\r\n * Default view model used when no data is available\r\n * UI components can use this initially or when the PM is not found\r\n */\r\nexport const defaultSlideNavigationVM: ExampleVM = {\r\n  aBoolProperty: true\r\n};\r\n\r\n/**\r\n * Factory function to create a new ExampleSingletonPM\r\n * @param appObject The AppObject to attach the PM to\r\n * @returns A new ExampleSingletonPM instance\r\n */\r\nexport function makeExampleSingletonPM(\r\n  appObject: AppObject\r\n): ExampleSingletonPM {\r\n  return new ExampleSingletonPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ExampleSingletonPM\r\n * This private class handles the actual implementation details\r\n */\r\nclass ExampleSingletonPMImp extends ExampleSingletonPM {\r\n  /**\r\n   * Gets the SingletonEntityExample from the application\r\n   * Uses getCachedSingleton for efficient repeated access\r\n   */\r\n  private get exampleEntity() {\r\n    return this.getCachedSingleton<SingletonEntityExample>(\r\n      SingletonEntityExample.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Handler for entity change events\r\n   * Transforms entity data into a view model and updates views\r\n   */\r\n  onEntityChange = () => {\r\n    if (!this.exampleEntity) return;\r\n\r\n    // Extract the boolean property from the entity\r\n    const aBoolProperty = this.exampleEntity.aBoolProperty;\r\n\r\n    // Create a view model with the extracted data\r\n    const vm = { aBoolProperty };\r\n\r\n    // Update all registered views with the new view model\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  /**\r\n   * Compares two view models to determine if they're equal\r\n   * Used to avoid unnecessary view updates when values haven't changed\r\n   */\r\n  vmsAreEqual(a: ExampleVM, b: ExampleVM): boolean {\r\n    if (a.aBoolProperty !== b.aBoolProperty) return false;\r\n    return true;\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ExampleSingletonPM.type);\r\n\r\n    // Register as an observer of the entity to receive change notifications\r\n    this.exampleEntity?.addChangeObserver(this.onEntityChange);\r\n    \r\n    // Call the change handler initially to set up the initial view model\r\n    this.onEntityChange();\r\n    \r\n    // Register this PM as a singleton so it can be accessed globally\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ExampleSingletonPM.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/PMs/ExampleSingletonPM.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAGL,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAS5E;;;GAGG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,oBAA+B;;AAC9E,gDAAgD;AAChC,uBAAI,GAAG,wBAAwB,CAAC;AAEhD;;;;GAIG;AACI,sBAAG,GAAG,CAAC,UAAyB,EAAkC,EAAE,CACzE,qBAAqB,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAG/D;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAc;IACjD,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAoB;IAEpB,OAAO,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,qBAAsB,SAAQ,kBAAkB;IACpD;;;OAGG;IACH,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,sBAAsB,CAAC,IAAI,CAC5B,CAAC;IACJ,CAAC;IAiBD;;;OAGG;IACH,WAAW,CAAC,CAAY,EAAE,CAAY;QACpC,IAAI,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAzB5C;;;WAGG;QACH,WAAM,GAAG,GAAG,EAAE;YACZ,+CAA+C;YAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC;YAEvD,8CAA8C;YAC9C,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;YAE7B,sDAAsD;YACtD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAcA,wEAAwE;QACxE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEvC,qEAAqE;QACrE,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;CACF","sourcesContent":["/**\r\n * ExampleSingletonPM.ts\r\n *\r\n * This file demonstrates how to implement a Singleton Presentation Manager (PM).\r\n * Singleton PMs are special PMs that exist only once in the application and can be\r\n * accessed globally. They transform data from singleton entities into view models.\r\n *\r\n * Key concepts:\r\n * - Singleton PMs extend AppObjectSingletonPM<VM> which handles singleton registration automatically\r\n * - They're accessed through a static get() method using getSingletonComponent()\r\n * - They typically observe singleton entities and provide data to multiple UI components\r\n * - They use formVM() to transform entity data into view models\r\n *\r\n * Usage pattern:\r\n * 1. Access the singleton PM using the static get() method\r\n * 2. Register UI components as views using addView(callback)\r\n * 3. PM will call the view callbacks with updated view models when entities change\r\n * 4. Remove UI components with removeView(callback) when they're unmounted\r\n */\r\n\r\nimport {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectSingletonPM,\r\n} from \"../../AppObject\";\r\nimport { getSingletonComponent } from \"../../AppObject/getSingletonComponent\";\r\nimport { SingletonEntityExample } from \"../Entities/ExampleSingletonEntity\";\r\n\r\n/**\r\n * Interface defining the structure of the view model provided by ExampleSingletonPM\r\n */\r\nexport interface ExampleVM {\r\n  aBoolProperty: boolean;\r\n}\r\n\r\n/**\r\n * ExampleSingletonPM transforms SingletonEntityExample data into an ExampleVM.\r\n * As a singleton, only one instance exists in the application.\r\n */\r\nexport abstract class ExampleSingletonPM extends AppObjectSingletonPM<ExampleVM> {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"ExampleSingletonPMType\";\r\n\r\n  /**\r\n   * Global accessor for the singleton PM\r\n   * @param appObjects The AppObjectRepo to search in\r\n   * @returns The singleton PM or undefined if not created yet\r\n   */\r\n  static get = (appObjects: AppObjectRepo): ExampleSingletonPM | undefined =>\r\n    getSingletonComponent(ExampleSingletonPM.type, appObjects);\r\n}\r\n\r\n/**\r\n * Default view model used when no data is available\r\n * UI components can use this initially or when the PM is not found\r\n */\r\nexport const defaultSlideNavigationVM: ExampleVM = {\r\n  aBoolProperty: true,\r\n};\r\n\r\n/**\r\n * Factory function to create a new ExampleSingletonPM\r\n * @param appObject The AppObject to attach the PM to\r\n * @returns A new ExampleSingletonPM instance\r\n */\r\nexport function makeExampleSingletonPM(\r\n  appObject: AppObject\r\n): ExampleSingletonPM {\r\n  return new ExampleSingletonPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ExampleSingletonPM\r\n * This private class handles the actual implementation details\r\n */\r\nclass ExampleSingletonPMImp extends ExampleSingletonPM {\r\n  /**\r\n   * Gets the SingletonEntityExample from the application\r\n   * Uses getCachedSingleton for efficient repeated access\r\n   */\r\n  private get exampleEntity() {\r\n    return this.getCachedSingleton<SingletonEntityExample>(\r\n      SingletonEntityExample.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Transforms entity data into a view model and updates views\r\n   * Called automatically when observed entities change\r\n   */\r\n  formVM = () => {\r\n    // Extract the boolean property from the entity\r\n    const aBoolProperty = this.exampleEntity.aBoolProperty;\r\n\r\n    // Create a view model with the extracted data\r\n    const vm = { aBoolProperty };\r\n\r\n    // Update all registered views with the new view model\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  /**\r\n   * Compares two view models to determine if they're equal\r\n   * Used to avoid unnecessary view updates when values haven't changed\r\n   */\r\n  vmsAreEqual(a: ExampleVM, b: ExampleVM): boolean {\r\n    if (a.aBoolProperty !== b.aBoolProperty) return false;\r\n    return true;\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ExampleSingletonPM.type);\r\n\r\n    // Register as an observer of the entity to receive change notifications\r\n    this.observeEntity(this.exampleEntity);\r\n\r\n    // Call the change handler initially to set up the initial view model\r\n    this.formVM();\r\n  }\r\n}\r\n"]}

package/dist/esm/ExampleFeature/UCs/EditExampleStringUC.js

@@ -70,10 +70,6 @@ class EditSlideTextUCImp extends EditExampleStringUC {
          * @param text The new string value to set
          */
         this.editExampleString = (text) => {
-            if (!this.exampleEntity) {
-                this.warn("Unable to find AppState");
-                return;
-            }
             // Update the entity property, which will trigger PM updates and UI refreshes
             this.exampleEntity.aStringProperty = text;
         };

package/dist/esm/ExampleFeature/UCs/EditExampleStringUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditExampleStringUC.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/UCs/EditExampleStringUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAA4B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,MAAM,OAAgB,mBAAoB,SAAQ,WAAW;IAU3D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,MAAiB;QAC1B,OAAO,MAAM,CAAC,YAAY,CAAsB,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,EAAU,EACV,UAAyB;QAEzB,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,YAAY,CAAsB,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;;AA7BD,gDAAgD;AAChC,wBAAI,GAAG,yBAAyB,CAAC;AA+BnD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAoB;IACtD,OAAO,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,kBAAmB,SAAQ,mBAAmB;IAClD;;;OAGG;IACH,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,uBAAuB,CAAgB,aAAa,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAgBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAf7C;;;WAGG;QACH,sBAAiB,GAAG,CAAC,IAAY,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBACrC,OAAO;YACT,CAAC;YAED,6EAA6E;YAC7E,IAAI,CAAC,aAAa,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5C,CAAC,CAAC;IAIF,CAAC;CACF","sourcesContent":["/**\r\n * EditExampleStringUC.ts\r\n * \r\n * This file demonstrates how to implement a Use Case (UC) component.\r\n * UCs handle business logic and operations that modify entities.\r\n * They encapsulate specific actions that can be performed in the application.\r\n * \r\n * Key concepts:\r\n * - UCs extend AppObjectUC and provide methods for specific operations\r\n * - They implement business logic for modifying entities\r\n * - They validate inputs and handle errors\r\n * - Each UC instance is associated with a specific AppObject\r\n * \r\n * Usage pattern:\r\n * 1. Get a UC instance using getById or get\r\n * 2. Call the UC's methods to perform operations\r\n * 3. The UC will update entities, which will trigger PM updates and UI refreshes\r\n */\r\n\r\nimport { AppObject, AppObjectRepo, AppObjectUC } from \"../../AppObject\";\r\nimport { ExampleEntity } from \"../Entities/ExampleEntity\";\r\n\r\n/**\r\n * EditExampleStringUC provides functionality to update the string property of an ExampleEntity.\r\n * Abstract class provides the interface and static helper methods.\r\n */\r\nexport abstract class EditExampleStringUC extends AppObjectUC {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"EditExampleStringUCType\";\r\n\r\n  /**\r\n   * Updates the string property of the associated ExampleEntity\r\n   * @param text The new string value to set\r\n   */\r\n  abstract editExampleString(text: string): void;\r\n\r\n  /**\r\n   * Retrieves an EditExampleStringUC component from an AppObject\r\n   * @param appObj The AppObject to get the component from\r\n   * @returns The EditExampleStringUC component or undefined if not found\r\n   */\r\n  static get(appObj: AppObject): EditExampleStringUC | undefined {\r\n    return appObj.getComponent<EditExampleStringUC>(this.type);\r\n  }\r\n\r\n  /**\r\n   * Retrieves an EditExampleStringUC by its parent AppObject's ID\r\n   * @param id The ID of the parent AppObject\r\n   * @param appObjects The AppObjectRepo to search in\r\n   * @returns The EditExampleStringUC component or undefined if not found\r\n   */\r\n  static getById(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): EditExampleStringUC | undefined {\r\n    return appObjects.get(id)?.getComponent<EditExampleStringUC>(this.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new EditExampleStringUC\r\n * @param appObject The AppObject to attach the UC to\r\n * @returns A new EditExampleStringUC instance\r\n */\r\nexport function makeEditSlideTextUC(appObject: AppObject): EditExampleStringUC {\r\n  return new EditSlideTextUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of EditExampleStringUC\r\n * This private class handles the actual implementation details\r\n */\r\nclass EditSlideTextUCImp extends EditExampleStringUC {\r\n  /**\r\n   * Gets the ExampleEntity from the same AppObject\r\n   * Uses getCachedLocalComponent for efficient repeated access\r\n   */\r\n  private get exampleEntity() {\r\n    return this.getCachedLocalComponent<ExampleEntity>(ExampleEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Implements the editExampleString method to update the entity's string property\r\n   * @param text The new string value to set\r\n   */\r\n  editExampleString = (text: string) => {\r\n    if (!this.exampleEntity) {\r\n      this.warn(\"Unable to find AppState\");\r\n      return;\r\n    }\r\n\r\n    // Update the entity property, which will trigger PM updates and UI refreshes\r\n    this.exampleEntity.aStringProperty = text;\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, EditExampleStringUC.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"EditExampleStringUC.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/UCs/EditExampleStringUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAA4B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,MAAM,OAAgB,mBAAoB,SAAQ,WAAW;IAU3D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,MAAiB;QAC1B,OAAO,MAAM,CAAC,YAAY,CAAsB,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,EAAU,EACV,UAAyB;QAEzB,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,YAAY,CAAsB,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;;AA7BD,gDAAgD;AAChC,wBAAI,GAAG,yBAAyB,CAAC;AA+BnD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAoB;IACtD,OAAO,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,kBAAmB,SAAQ,mBAAmB;IAClD;;;OAGG;IACH,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,uBAAuB,CAAgB,aAAa,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAYD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAX7C;;;WAGG;QACH,sBAAiB,GAAG,CAAC,IAAY,EAAE,EAAE;YAEnC,6EAA6E;YAC7E,IAAI,CAAC,aAAa,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5C,CAAC,CAAC;IAIF,CAAC;CACF","sourcesContent":["/**\r\n * EditExampleStringUC.ts\r\n * \r\n * This file demonstrates how to implement a Use Case (UC) component.\r\n * UCs handle business logic and operations that modify entities.\r\n * They encapsulate specific actions that can be performed in the application.\r\n * \r\n * Key concepts:\r\n * - UCs extend AppObjectUC and provide methods for specific operations\r\n * - They implement business logic for modifying entities\r\n * - They validate inputs and handle errors\r\n * - Each UC instance is associated with a specific AppObject\r\n * \r\n * Usage pattern:\r\n * 1. Get a UC instance using getById or get\r\n * 2. Call the UC's methods to perform operations\r\n * 3. The UC will update entities, which will trigger PM updates and UI refreshes\r\n */\r\n\r\nimport { AppObject, AppObjectRepo, AppObjectUC } from \"../../AppObject\";\r\nimport { ExampleEntity } from \"../Entities/ExampleEntity\";\r\n\r\n/**\r\n * EditExampleStringUC provides functionality to update the string property of an ExampleEntity.\r\n * Abstract class provides the interface and static helper methods.\r\n */\r\nexport abstract class EditExampleStringUC extends AppObjectUC {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"EditExampleStringUCType\";\r\n\r\n  /**\r\n   * Updates the string property of the associated ExampleEntity\r\n   * @param text The new string value to set\r\n   */\r\n  abstract editExampleString(text: string): void;\r\n\r\n  /**\r\n   * Retrieves an EditExampleStringUC component from an AppObject\r\n   * @param appObj The AppObject to get the component from\r\n   * @returns The EditExampleStringUC component or undefined if not found\r\n   */\r\n  static get(appObj: AppObject): EditExampleStringUC | undefined {\r\n    return appObj.getComponent<EditExampleStringUC>(this.type);\r\n  }\r\n\r\n  /**\r\n   * Retrieves an EditExampleStringUC by its parent AppObject's ID\r\n   * @param id The ID of the parent AppObject\r\n   * @param appObjects The AppObjectRepo to search in\r\n   * @returns The EditExampleStringUC component or undefined if not found\r\n   */\r\n  static getById(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): EditExampleStringUC | undefined {\r\n    return appObjects.get(id)?.getComponent<EditExampleStringUC>(this.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new EditExampleStringUC\r\n * @param appObject The AppObject to attach the UC to\r\n * @returns A new EditExampleStringUC instance\r\n */\r\nexport function makeEditSlideTextUC(appObject: AppObject): EditExampleStringUC {\r\n  return new EditSlideTextUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of EditExampleStringUC\r\n * This private class handles the actual implementation details\r\n */\r\nclass EditSlideTextUCImp extends EditExampleStringUC {\r\n  /**\r\n   * Gets the ExampleEntity from the same AppObject\r\n   * Uses getCachedLocalComponent for efficient repeated access\r\n   */\r\n  private get exampleEntity() {\r\n    return this.getCachedLocalComponent<ExampleEntity>(ExampleEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Implements the editExampleString method to update the entity's string property\r\n   * @param text The new string value to set\r\n   */\r\n  editExampleString = (text: string) => {\r\n\r\n    // Update the entity property, which will trigger PM updates and UI refreshes\r\n    this.exampleEntity.aStringProperty = text;\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, EditExampleStringUC.type);\r\n  }\r\n}\r\n"]}

package/dist/esm/ExampleFeature/UCs/ToggleExampleBooleanUC.js

@@ -16,14 +16,14 @@
  * 2. Call the UC's methods to perform operations
  * 3. The UC will update entities, which will trigger PM updates and UI refreshes
  */
-import { AppObjectUC } from "../../AppObject";
+import { AppObjectSingletonUC, } from "../../AppObject";
 import { getSingletonComponent } from "../../AppObject/getSingletonComponent";
 import { SingletonEntityExample } from "../Entities/ExampleSingletonEntity";
 /**
  * ToggleExampleBooleanUC provides functionality to toggle the boolean property
  * of the SingletonEntityExample. As a singleton, only one instance exists in the application.
  */
-export class ToggleExampleBooleanUC extends AppObjectUC {
+export class ToggleExampleBooleanUC extends AppObjectSingletonUC {
 }
 /** Unique type identifier for this component */
 ToggleExampleBooleanUC.type = "ToggleExampleBooleanUCType";
@@ -59,16 +59,10 @@ class ToggleExampleBooleanUCImp extends ToggleExampleBooleanUC {
          * Implements the toggleExampleBoolean method to invert the entity's boolean property
          */
         this.toggleExampleBoolean = () => {
-            if (!this.singletonEntityExample) {
-                this.warn("Unable to find SingletonEntityExample");
-                return;
-            }
             // Toggle the boolean property by inverting its current value
             this.singletonEntityExample.aBoolProperty =
-                !this.singletonEntityExample?.aBoolProperty;
+                !this.singletonEntityExample.aBoolProperty;
         };
-        // Register this UC as a singleton so it can be accessed globally
-        this.appObjects.registerSingleton(this);
     }
 }
 //# sourceMappingURL=ToggleExampleBooleanUC.js.map

package/dist/esm/ExampleFeature/UCs/ToggleExampleBooleanUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToggleExampleBooleanUC.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/UCs/ToggleExampleBooleanUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,WAAW,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E;;;GAGG;AACH,MAAM,OAAgB,sBAAuB,SAAQ,WAAW;;AAC9D,gDAAgD;AAChC,2BAAI,GAAG,4BAA4B,CAAC;AAOpD;;;;GAIG;AACI,0BAAG,GAAG,CACX,UAAyB,EACW,EAAE,CACtC,qBAAqB,CAAC,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAGnE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,yBAA0B,SAAQ,sBAAsB;IAC5D;;;OAGG;IACH,IAAY,sBAAsB;QAChC,OAAO,IAAI,CAAC,kBAAkB,CAC5B,sBAAsB,CAAC,IAAI,CAC5B,CAAC;IACJ,CAAC;IAgBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAfhD;;WAEG;QACH,yBAAoB,GAAG,GAAG,EAAE;YAC1B,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,6DAA6D;YAC7D,IAAI,CAAC,sBAAsB,CAAC,aAAa;gBACvC,CAAC,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC;QAChD,CAAC,CAAC;QAIA,iEAAiE;QACjE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["/**\r\n * ToggleExampleBooleanUC.ts\r\n * \r\n * This file demonstrates how to implement a Singleton Use Case (UC) component.\r\n * Singleton UCs are special UCs that exist only once in the application and can be\r\n * accessed globally. They handle business logic and operations that modify singleton entities.\r\n * \r\n * Key concepts:\r\n * - Singleton UCs extend AppObjectUC like regular UCs\r\n * - They register themselves as singletons with appObjects.registerSingleton()\r\n * - They're accessed through a static get() method using getSingletonComponent()\r\n * - They typically operate on singleton entities\r\n * \r\n * Usage pattern:\r\n * 1. Access the singleton UC using the static get() method\r\n * 2. Call the UC's methods to perform operations\r\n * 3. The UC will update entities, which will trigger PM updates and UI refreshes\r\n */\r\n\r\nimport {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"../../AppObject\";\r\nimport { getSingletonComponent } from \"../../AppObject/getSingletonComponent\";\r\nimport { SingletonEntityExample } from \"../Entities/ExampleSingletonEntity\";\r\n\r\n/**\r\n * ToggleExampleBooleanUC provides functionality to toggle the boolean property\r\n * of the SingletonEntityExample. As a singleton, only one instance exists in the application.\r\n */\r\nexport abstract class ToggleExampleBooleanUC extends AppObjectUC {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"ToggleExampleBooleanUCType\";\r\n\r\n  /**\r\n   * Toggles the boolean property of the SingletonEntityExample\r\n   */\r\n  abstract toggleExampleBoolean(): void;\r\n\r\n  /**\r\n   * Global accessor for the singleton UC\r\n   * @param appObjects The AppObjectRepo to search in\r\n   * @returns The singleton UC or undefined if not created yet\r\n   */\r\n  static get = (\r\n    appObjects: AppObjectRepo\r\n  ): ToggleExampleBooleanUC | undefined =>\r\n    getSingletonComponent(ToggleExampleBooleanUC.type, appObjects);\r\n}\r\n\r\n/**\r\n * Factory function to create a new ToggleExampleBooleanUC\r\n * @param appObject The AppObject to attach the UC to\r\n * @returns A new ToggleExampleBooleanUC instance\r\n */\r\nexport function makeToggleExampleBooleanUC(\r\n  appObject: AppObject\r\n): ToggleExampleBooleanUC {\r\n  return new ToggleExampleBooleanUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ToggleExampleBooleanUC\r\n * This private class handles the actual implementation details\r\n */\r\nclass ToggleExampleBooleanUCImp extends ToggleExampleBooleanUC {\r\n  /**\r\n   * Gets the SingletonEntityExample from the application\r\n   * Uses getCachedSingleton for efficient repeated access\r\n   */\r\n  private get singletonEntityExample() {\r\n    return this.getCachedSingleton<SingletonEntityExample>(\r\n      SingletonEntityExample.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Implements the toggleExampleBoolean method to invert the entity's boolean property\r\n   */\r\n  toggleExampleBoolean = () => {\r\n    if (!this.singletonEntityExample) {\r\n      this.warn(\"Unable to find SingletonEntityExample\");\r\n      return;\r\n    }\r\n\r\n    // Toggle the boolean property by inverting its current value\r\n    this.singletonEntityExample.aBoolProperty =\r\n      !this.singletonEntityExample?.aBoolProperty;\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ToggleExampleBooleanUC.type);\r\n    // Register this UC as a singleton so it can be accessed globally\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ToggleExampleBooleanUC.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/UCs/ToggleExampleBooleanUC.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E;;;GAGG;AACH,MAAM,OAAgB,sBAAuB,SAAQ,oBAAoB;;AACvE,gDAAgD;AAChC,2BAAI,GAAG,4BAA4B,CAAC;AAOpD;;;;GAIG;AACI,0BAAG,GAAG,CACX,UAAyB,EACW,EAAE,CACtC,qBAAqB,CAAC,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAGnE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,yBAA0B,SAAQ,sBAAsB;IAC5D;;;OAGG;IACH,IAAY,sBAAsB;QAChC,OAAO,IAAI,CAAC,kBAAkB,CAC5B,sBAAsB,CAAC,IAAI,CAC5B,CAAC;IACJ,CAAC;IAWD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAVhD;;WAEG;QACH,yBAAoB,GAAG,GAAG,EAAE;YAC1B,6DAA6D;YAC7D,IAAI,CAAC,sBAAsB,CAAC,aAAa;gBACvC,CAAC,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAC;QAC/C,CAAC,CAAC;IAIF,CAAC;CACF","sourcesContent":["/**\r\n * ToggleExampleBooleanUC.ts\r\n *\r\n * This file demonstrates how to implement a Singleton Use Case (UC) component.\r\n * Singleton UCs are special UCs that exist only once in the application and can be\r\n * accessed globally. They handle business logic and operations that modify singleton entities.\r\n *\r\n * Key concepts:\r\n * - Singleton UCs extend AppObjectUC like regular UCs\r\n * - They register themselves as singletons with appObjects.registerSingleton()\r\n * - They're accessed through a static get() method using getSingletonComponent()\r\n * - They typically operate on singleton entities\r\n *\r\n * Usage pattern:\r\n * 1. Access the singleton UC using the static get() method\r\n * 2. Call the UC's methods to perform operations\r\n * 3. The UC will update entities, which will trigger PM updates and UI refreshes\r\n */\r\n\r\nimport {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectSingletonUC,\r\n} from \"../../AppObject\";\r\nimport { getSingletonComponent } from \"../../AppObject/getSingletonComponent\";\r\nimport { SingletonEntityExample } from \"../Entities/ExampleSingletonEntity\";\r\n\r\n/**\r\n * ToggleExampleBooleanUC provides functionality to toggle the boolean property\r\n * of the SingletonEntityExample. As a singleton, only one instance exists in the application.\r\n */\r\nexport abstract class ToggleExampleBooleanUC extends AppObjectSingletonUC {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"ToggleExampleBooleanUCType\";\r\n\r\n  /**\r\n   * Toggles the boolean property of the SingletonEntityExample\r\n   */\r\n  abstract toggleExampleBoolean(): void;\r\n\r\n  /**\r\n   * Global accessor for the singleton UC\r\n   * @param appObjects The AppObjectRepo to search in\r\n   * @returns The singleton UC or undefined if not created yet\r\n   */\r\n  static get = (\r\n    appObjects: AppObjectRepo\r\n  ): ToggleExampleBooleanUC | undefined =>\r\n    getSingletonComponent(ToggleExampleBooleanUC.type, appObjects);\r\n}\r\n\r\n/**\r\n * Factory function to create a new ToggleExampleBooleanUC\r\n * @param appObject The AppObject to attach the UC to\r\n * @returns A new ToggleExampleBooleanUC instance\r\n */\r\nexport function makeToggleExampleBooleanUC(\r\n  appObject: AppObject\r\n): ToggleExampleBooleanUC {\r\n  return new ToggleExampleBooleanUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ToggleExampleBooleanUC\r\n * This private class handles the actual implementation details\r\n */\r\nclass ToggleExampleBooleanUCImp extends ToggleExampleBooleanUC {\r\n  /**\r\n   * Gets the SingletonEntityExample from the application\r\n   * Uses getCachedSingleton for efficient repeated access\r\n   */\r\n  private get singletonEntityExample() {\r\n    return this.getCachedSingleton<SingletonEntityExample>(\r\n      SingletonEntityExample.type\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Implements the toggleExampleBoolean method to invert the entity's boolean property\r\n   */\r\n  toggleExampleBoolean = () => {\r\n    // Toggle the boolean property by inverting its current value\r\n    this.singletonEntityExample.aBoolProperty =\r\n      !this.singletonEntityExample.aBoolProperty;\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ToggleExampleBooleanUC.type);\r\n  }\r\n}\r\n"]}

package/dist/types/AppObject/AppObjectComponent.d.ts

@@ -49,17 +49,19 @@ export declare class AppObjectComponent {
      * Results are cached for better performance in repeated calls
      *
      * @param type The component type identifier to look up
-     * @returns The singleton component cast to type T, or undefined if not found
+     * @returns The singleton component cast to type T
+     * @throws Error if the component is not found
      */
-    getCachedSingleton<T extends AppObjectComponent>(type: string): T | undefined;
+    getCachedSingleton<T extends AppObjectComponent>(type: string): T;
     /**
      * Retrieves a component from the same AppObject as this component
      * Results are cached for better performance in repeated calls
      *
      * @param type The component type identifier to look up
-     * @returns The component cast to type T, or undefined if not found
+     * @returns The component cast to type T
+     * @throws Error if the component is not found
      */
-    getCachedLocalComponent<T extends AppObjectComponent>(type: string): T | undefined;
+    getCachedLocalComponent<T extends AppObjectComponent>(type: string): T;
     /**
      * Retrieves a singleton component from the repository with customizable logging
      * Unlike getCachedSingleton, results are not cached

package/dist/types/AppObject/AppObjectComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectComponent.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,oBAAY,sBAAsB;IAChC,2CAA2C;IAC3C,MAAM,WAAW;IAEjB,oDAAoD;IACpD,EAAE,yBAAyB;IAE3B,+DAA+D;IAC/D,EAAE,aAAa;IAEf,8CAA8C;IAC9C,UAAU,eAAe;IAEzB,sEAAsE;IACtE,IAAI,SAAS;IAEb,yEAAyE;IACzE,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAkC;IAEhF,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;;OAGG;IACH,IAAI,UAAU,IAAI,aAAa,CAE9B;IAED,qDAAqD;IACrD,OAAO,CAAC,gBAAgB,CAAyC;IAEjE;;;;;;OAMG;IACH,kBAAkB,CAAC,CAAC,SAAS,kBAAkB,EAC7C,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS;IAahB;;;;;;OAMG;IACH,uBAAuB,CAAC,CAAC,SAAS,kBAAkB,EAClD,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS;IAchB;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,SAAS,kBAAkB,EACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,KAAK,GAAG,MAAM,GAAG,OAAgB,GACzC,CAAC,GAAG,SAAS;IAqBhB;;;OAGG;IACH,OAAO;IAMP;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM;IAInB;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM;IAIpB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM;IAIrB;;;;;OAKG;gBACS,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM;CAK/C"}
+{"version":3,"file":"AppObjectComponent.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,oBAAY,sBAAsB;IAChC,2CAA2C;IAC3C,MAAM,WAAW;IAEjB,oDAAoD;IACpD,EAAE,yBAAyB;IAE3B,+DAA+D;IAC/D,EAAE,aAAa;IAEf,8CAA8C;IAC9C,UAAU,eAAe;IAEzB,sEAAsE;IACtE,IAAI,SAAS;IAEb,yEAAyE;IACzE,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CACb;IAEjC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;;OAGG;IACH,IAAI,UAAU,IAAI,aAAa,CAE9B;IAED,qDAAqD;IACrD,OAAO,CAAC,gBAAgB,CAAyC;IAEjE;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,SAAS,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAYjE;;;;;;;OAOG;IACH,uBAAuB,CAAC,CAAC,SAAS,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAatE;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,SAAS,kBAAkB,EACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,KAAK,GAAG,MAAM,GAAG,OAAgB,GACzC,CAAC,GAAG,SAAS;IAqBhB;;;OAGG;IACH,OAAO;IAMP;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM;IAInB;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM;IAIpB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM;IAIrB;;;;;OAKG;gBACS,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM;CAK/C"}

package/dist/types/AppObject/AppObjectEntityRepo.d.ts

@@ -1,3 +1,4 @@
+import { AppObject } from "./AppObject";
 import { AppObjectEntity } from "./AppObjectEntity";
 /**
  * A repository for managing collections of AppObjectEntity instances.
@@ -6,20 +7,32 @@ import { AppObjectEntity } from "./AppObjectEntity";
  * entities that are associated with specific AppObjects. It implements the observer
  * pattern to notify listeners when entities are added or removed.
  *
+ * Derived classes should override the `entityFactory` method to provide custom
+ * entity creation logic for the `create` method.
+ *
  * @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>();
+ * // Create a custom repository with entity factory
+ * class PlayerRepo extends AppObjectEntityRepo<PlayerEntity> {
+ *   entityFactory(id: string): PlayerEntity {
+ *     const appObject = makeAppObject(id, this.appObjects);
+ *     return new PlayerEntity(appObject);
+ *   }
+ * }
+ *
+ * const playerRepo = new PlayerRepo(repoAppObject);
  *
- * // Add a new player
- * const player = new PlayerEntity(appObject);
- * playerRepo.add(player);
+ * // Create a new player with auto-generated ID
+ * const player = playerRepo.create();
  *
- * // Get a player by its AppObject ID
- * const retrievedPlayer = playerRepo.getForAppObject("player1");
+ * // Create a new player with specific ID
+ * const specificPlayer = playerRepo.create("player1");
+ *
+ * // Get a player by its ID
+ * const retrievedPlayer = playerRepo.getById("player1");
  * ```
  */
 export declare class AppObjectEntityRepo<T extends AppObjectEntity> extends AppObjectEntity {
@@ -50,11 +63,19 @@ export declare class AppObjectEntityRepo<T extends AppObjectEntity> extends AppO
      * @param {(removedEntity: T) => void} observer - The callback function to remove
      */
     removeEntityRemovedObserver: (observer: (removedEntity: T) => void) => void;
+    /**
+     * Checks if an entity exists for the given ID.
+     *
+     * @param {string} id - The ID of the AppObject
+     * @returns {boolean} True if an entity exists for the given ID, false otherwise
+     */
+    has: (id: string) => boolean;
     /**
      * 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
+     * @deprecated Use has instead
      */
     hasForAppObject: (appObjectID: string) => boolean;
     /**
@@ -66,19 +87,64 @@ export declare class AppObjectEntityRepo<T extends AppObjectEntity> extends AppO
      * @param {T} entity - The entity to add
      */
     add(entity: T): void;
+    /**
+     * Creates a new entity with the specified or auto-generated ID and adds it to the repository.
+     *
+     * This method uses the `entityFactory` method to create the entity instance.
+     * If no ID is provided, a unique ID is generated automatically.
+     *
+     * @param {string} [id] - Optional ID for the entity. If not provided, a unique ID is generated.
+     * @returns {T} The newly created entity
+     */
+    create(id?: string): T;
+    /**
+     * Factory method for creating entity instances.
+     *
+     * This method must be overridden in derived classes to provide custom entity creation logic.
+     * It is called by the `create` method to instantiate new entities.
+     *
+     * @param {string} id - The ID to use for the new entity
+     * @returns {T} A new entity instance
+     * @throws {Error} If not overridden in derived class
+     */
+    entityFactory(appObject: AppObject): T;
+    /**
+     * Removes the entity associated with the specified ID.
+     *
+     * Notifies all registered observers after the entity is removed.
+     *
+     * @param {string} id - The ID of the AppObject whose entity should be removed
+     */
+    removeById: (id: string) => void;
     /**
      * 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
+     * @deprecated Use removeById instead
      */
     removeForAppObject: (id: string) => void;
+    /**
+     * Removes all entities from the repository.
+     *
+     * Unsubscribes from all entity change observers and notifies all registered
+     * removal observers for each entity before clearing the repository.
+     */
+    deleteAll: () => void;
+    /**
+     * Gets the entity associated with the specified ID.
+     *
+     * @param {string} id - The ID of the AppObject
+     * @returns {T | undefined} The entity if found, undefined otherwise
+     */
+    getById: (id: string) => T | undefined;
     /**
      * 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
+     * @deprecated Use getById instead
      */
     getForAppObject: (appObjectID: string) => T | undefined;
     /**
@@ -87,5 +153,12 @@ export declare class AppObjectEntityRepo<T extends AppObjectEntity> extends AppO
      * @returns {T[]} An array of all entities
      */
     getAll: () => T[];
+    /**
+     * Gets an entity by ID, or creates it if it doesn't exist.
+     *
+     * @param {string} id - The ID of the entity to get or create
+     * @returns {T} The existing or newly created entity
+     */
+    getOrCreate: (id: string) => T;
 }
 //# sourceMappingURL=AppObjectEntityRepo.d.ts.map

package/dist/types/AppObject/AppObjectEntityRepo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectEntityRepo.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectEntityRepo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAmB,CAC9B,CAAC,SAAS,eAAe,CACzB,SAAQ,eAAe;IACvB,OAAO,CAAC,YAAY,CAAwB;IAE5C,OAAO,CAAC,sBAAsB,CAAyB;IACvD;;;;OAIG;IACH,sBAAsB,GAAI,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,IAAI,UAE1D;IAEF;;;;OAIG;IACH,yBAAyB,GAAI,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,IAAI,KAAG,IAAI,CAEpE;IAEF,OAAO,CAAC,wBAAwB,CAAyB;IACzD;;;;OAIG;IACH,wBAAwB,GAAI,UAAU,CAAC,aAAa,EAAE,CAAC,KAAK,IAAI,UAE9D;IAEF;;;;OAIG;IACH,2BAA2B,GACzB,UAAU,CAAC,aAAa,EAAE,CAAC,KAAK,IAAI,KACnC,IAAI,CAEL;IAEF;;;;;OAKG;IACH,eAAe,GAAI,aAAa,MAAM,KAAG,OAAO,CAE9C;IAEF;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,CAAC;IAYb;;;;;;OAMG;IACH,kBAAkB,GAAI,IAAI,MAAM,UAQ9B;IAEF;;;;;OAKG;IACH,eAAe,GAAI,aAAa,MAAM,KAAG,CAAC,GAAG,SAAS,CAEpD;IAEF;;;;OAIG;IACH,MAAM,QAAO,CAAC,EAAE,CAEd;CACH"}
+{"version":3,"file":"AppObjectEntityRepo.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectEntityRepo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,mBAAmB,CAC9B,CAAC,SAAS,eAAe,CACzB,SAAQ,eAAe;IACvB,OAAO,CAAC,YAAY,CAAwB;IAE5C,OAAO,CAAC,sBAAsB,CAAyB;IACvD;;;;OAIG;IACH,sBAAsB,GAAI,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,IAAI,UAE1D;IAEF;;;;OAIG;IACH,yBAAyB,GAAI,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,IAAI,KAAG,IAAI,CAEpE;IAEF,OAAO,CAAC,wBAAwB,CAAyB;IACzD;;;;OAIG;IACH,wBAAwB,GAAI,UAAU,CAAC,aAAa,EAAE,CAAC,KAAK,IAAI,UAE9D;IAEF;;;;OAIG;IACH,2BAA2B,GACzB,UAAU,CAAC,aAAa,EAAE,CAAC,KAAK,IAAI,KACnC,IAAI,CAEL;IAEF;;;;;OAKG;IACH,GAAG,GAAI,IAAI,MAAM,KAAG,OAAO,CAEzB;IAEF;;;;;;OAMG;IACH,eAAe,GAAI,aAAa,MAAM,KAAG,OAAO,CAE9C;IAEF;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,CAAC;IAYb;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC;IAQtB;;;;;;;;;OASG;IACH,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,CAAC;IAKtC;;;;;;OAMG;IACH,UAAU,GAAI,IAAI,MAAM,UAQtB;IAEF;;;;;;;OAOG;IACH,kBAAkB,GAAI,IAAI,MAAM,UAE9B;IAEF;;;;;OAKG;IACH,SAAS,aAUP;IAEF;;;;;OAKG;IACH,OAAO,GAAI,IAAI,MAAM,KAAG,CAAC,GAAG,SAAS,CAEnC;IAEF;;;;;;OAMG;IACH,eAAe,GAAI,aAAa,MAAM,KAAG,CAAC,GAAG,SAAS,CAEpD;IAEF;;;;OAIG;IACH,MAAM,QAAO,CAAC,EAAE,CAEd;IAEF;;;;;OAKG;IACH,WAAW,GAAI,IAAI,MAAM,KAAG,CAAC,CAM3B;CACH"}

package/dist/types/AppObject/AppObjectPM.d.ts

@@ -1,4 +1,5 @@
 import { AppObjectComponent, AppObjectComponentType } from "./AppObjectComponent";
+import { AppObjectEntity } from "./AppObjectEntity";
 /**
  * Presentation Manager (PM) component that transforms application state into view models
  *
@@ -28,13 +29,28 @@ export declare abstract class AppObjectPM<T> extends AppObjectComponent {
     abstract vmsAreEqual(a: T, b: T): boolean;
     /** The most recently generated view model */
     private _lastVM?;
+    /**
+     * Optional default view model to return when no view model has been generated yet.
+     * If set, this value will be returned by the `lastVM` getter before any view model
+     * has been created via `doUpdateView`.
+     *
+     * This is useful for providing initial state to views without requiring immediate
+     * view model generation.
+     */
+    defaultVM?: T;
     /**
      * Gets the most recently generated view model
-     * @returns The last view model or undefined if none has been generated
+     * @returns The last view model, or `defaultVM` if no view model has been generated yet,
+     *          or undefined if neither exists
      */
     get lastVM(): T | undefined;
     /** List of view update functions to notify when the view model changes */
-    private observerList;
+    private views;
+    /**
+     * List of entities being observed by this PM.
+     * Used for automatic cleanup during disposal.
+     */
+    private observedEntities;
     /**
      * 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
@@ -42,6 +58,64 @@ export declare abstract class AppObjectPM<T> extends AppObjectComponent {
      * @param updateView Function to call with updated view models
      */
     addView(updateView: (vm: T) => void): void;
+    /**
+     * Called when an observed entity changes.
+     * If views are registered, this method calls `formVM()` to regenerate the view model.
+     *
+     * This method is automatically invoked when entities registered via `observeEntity()`
+     * notify their observers. It implements lazy evaluation - view models are only
+     * formed when there are views to receive them.
+     */
+    onEntityChanged(): void;
+    /**
+     * Forms and updates the view model based on current entity state.
+     *
+     * Override this method in derived classes to:
+     * 1. Read data from observed entities
+     * 2. Transform the data into a view model
+     * 3. Call `doUpdateView(vm)` with the new view model
+     *
+     * This method is only called when at least one view has been registered,
+     * implementing lazy evaluation to avoid unnecessary computation.
+     *
+     * @example
+     * ```typescript
+     * formVM(): void {
+     *   const entity = this.getCachedLocalComponent<MyEntity>(MyEntity.type);
+     *   if (entity) {
+     *     this.doUpdateView({
+     *       displayName: entity.name,
+     *       isActive: entity.active
+     *     });
+     *   }
+     * }
+     * ```
+     */
+    formVM(): void;
+    onViewAdded(): void;
+    /**
+     * Registers an entity to be observed for changes.
+     *
+     * When the entity notifies of changes (via `notifyOnChange()`), this PM will
+     * automatically call `onEntityChanged()`, which in turn calls `formVM()` if
+     * views are registered.
+     *
+     * The entity observer is automatically cleaned up when this PM is disposed.
+     *
+     * @param entity The entity to observe for changes
+     *
+     * @example
+     * ```typescript
+     * constructor(appObj: AppObject) {
+     *   super(appObj, MyPM.type);
+     *   const entity = appObj.getComponent<MyEntity>(MyEntity.type);
+     *   if (entity) {
+     *     this.observeEntity(entity);
+     *   }
+     * }
+     * ```
+     */
+    protected observeEntity(entity: AppObjectEntity): void;
     /**
      * Unregisters a previously added view update function
      *
@@ -60,6 +134,12 @@ export declare abstract class AppObjectPM<T> extends AppObjectComponent {
     doUpdateView(vm: T): void;
     /**
      * Cleans up resources and detaches this PM from its parent AppObject
+     *
+     * This method:
+     * 1. Removes change observers from all observed entities
+     * 2. Clears all view observers
+     * 3. Removes this component from its parent AppObject if still attached
+     * 4. Calls the parent class dispose method
      */
     dispose(): void;
 }

package/dist/types/AppObject/AppObjectPM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectPM.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectPM.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,WAAW,CAAC,CAAC,CAAE,SAAQ,kBAAkB;IAC7D,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,6BAA6B;IAEnD;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO;IAEzC,6CAA6C;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAI;IAEpB;;;OAGG;IACH,IAAI,MAAM,IAAI,CAAC,GAAG,SAAS,CAE1B;IAED,0EAA0E;IAC1E,OAAO,CAAC,YAAY,CAAyB;IAE7C;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAS1C;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAI7C;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC;IAUlB;;OAEG;IACH,OAAO;CAOR"}
+{"version":3,"file":"AppObjectPM.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectPM.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,WAAW,CAAC,CAAC,CAAE,SAAQ,kBAAkB;IAC7D,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,6BAA6B;IAEnD;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO;IAEzC,6CAA6C;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAI;IAEpB;;;;;;;OAOG;IACI,SAAS,CAAC,EAAE,CAAC,CAAC;IAErB;;;;OAIG;IACH,IAAI,MAAM,IAAI,CAAC,GAAG,SAAS,CAG1B;IAED,0EAA0E;IAC1E,OAAO,CAAC,KAAK,CAAyB;IAEtC;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAyB;IAEjD;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAgB1C;;;;;;;OAOG;IACH,eAAe,IAAI,IAAI;IAQvB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,IAAI,IAAI;IAMd,WAAW,IAAI,IAAI;IAInB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAQtD;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAI7C;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC;IAUlB;;;;;;;;OAQG;IACH,OAAO;CAaR"}

package/dist/types/AppObject/AppObjectRepo.d.ts

@@ -84,6 +84,12 @@ export declare abstract class AppObjectRepo extends ObservableEntity {
      * @param {AppObjectComponent} component - The component to register as a singleton
      */
     abstract registerSingleton(component: AppObjectComponent): void;
+    /**
+     * Unregisters a singleton component from the repository.
+     *
+     * @param {string} type - The type of the singleton to unregister
+     */
+    abstract unregisterSingleton(type: string): void;
     /**
      * Checks if a singleton component of the specified type exists.
      *

package/dist/types/AppObject/AppObjectRepo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppObjectRepo.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAgB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;GAQG;AACH,8BAAsB,aAAc,SAAQ,gBAAgB;IAC1D;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAExC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAExD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAEpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAEzD;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE7D;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE3D;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE3D;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAE/D;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAE5C;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,CAAC,SAAS,kBAAkB,EAChD,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS;IAEhB;;;;;;;OAOG;IACH,QAAQ,CAAC,qBAAqB,CAAC,CAAC,SAAS,kBAAkB,EACzD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,6BAA6B,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE;IAE1E;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE;IAE1E;;;;OAIG;IACH,QAAQ,CAAC,yBAAyB,EAAE,CAClC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,KACvC,IAAI,CAAC;IAEV;;;;OAIG;IACH,QAAQ,CAAC,4BAA4B,EAAE,CACrC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,KACvC,IAAI,CAAC;IAEV;;;;OAIG;IACH,QAAQ,CAAC,2BAA2B,EAAE,CACpC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,KACvC,IAAI,CAAC;IAEV;;;;OAIG;IACH,QAAQ,CAAC,+BAA+B,EAAE,CACxC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,KACvC,IAAI,CAAC;CACX;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAEjD"}
+{"version":3,"file":"AppObjectRepo.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAgB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;GAQG;AACH,8BAAsB,aAAc,SAAQ,gBAAgB;IAC1D;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAExC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAExD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAEpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAEzD;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE7D;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE3D;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAE3D;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAE/D;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAE5C;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,CAAC,SAAS,kBAAkB,EAChD,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS;IAEhB;;;;;;;OAOG;IACH,QAAQ,CAAC,qBAAqB,CAAC,CAAC,SAAS,kBAAkB,EACzD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,6BAA6B,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE;IAE1E;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE;IAE1E;;;;OAIG;IACH,QAAQ,CAAC,yBAAyB,EAAE,CAClC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,KACvC,IAAI,CAAC;IAEV;;;;OAIG;IACH,QAAQ,CAAC,4BAA4B,EAAE,CACrC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,KACvC,IAAI,CAAC;IAEV;;;;OAIG;IACH,QAAQ,CAAC,2BAA2B,EAAE,CACpC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,KACvC,IAAI,CAAC;IAEV;;;;OAIG;IACH,QAAQ,CAAC,+BAA+B,EAAE,CACxC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,KAAK,IAAI,KACvC,IAAI,CAAC;CACX;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAEjD"}

package/dist/types/AppObject/AppObjectSingletonEntity.d.ts

@@ -0,0 +1,31 @@
+import { AppObject } from "./AppObject";
+import { AppObjectEntity } from "./AppObjectEntity";
+/**
+ * Singleton entity component that manages application state
+ *
+ * AppObjectSingletonEntity extends AppObjectEntity and automatically registers itself
+ * as a singleton in the AppObjectRepo upon construction. This ensures only one instance
+ * of this entity type exists across the entire application.
+ *
+ * Use this class when you need an entity that should have only one instance globally,
+ * such as application-wide configuration or shared state managers.
+ */
+export declare class AppObjectSingletonEntity extends AppObjectEntity {
+    /**
+     * Creates a new singleton entity component and attaches it to the specified AppObject
+     * Automatically registers itself as a singleton in the AppObjectRepo
+     *
+     * @param appObject The parent AppObject this component will be attached to
+     * @param type The unique type identifier for this component
+     */
+    constructor(appObject: AppObject, type: string);
+    /**
+     * Cleans up resources and unregisters the singleton
+     *
+     * This method:
+     * 1. Unregisters itself from the singleton registry
+     * 2. Calls the parent class dispose method
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=AppObjectSingletonEntity.d.ts.map

package/dist/types/AppObject/AppObjectSingletonEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonEntity.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,eAAe;IAC3D;;;;;;OAMG;gBACS,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM;IAM9C;;;;;;OAMG;IACH,OAAO;CAIR"}

package/dist/types/AppObject/AppObjectSingletonEntityRepo.d.ts

@@ -0,0 +1,46 @@
+import { AppObject } from "./AppObject";
+import { AppObjectEntity } from "./AppObjectEntity";
+import { AppObjectEntityRepo } from "./AppObjectEntityRepo";
+/**
+ * A singleton repository for managing collections of AppObjectEntity instances.
+ *
+ * This generic class extends AppObjectEntityRepo and automatically registers itself
+ * as a singleton in the AppObjectRepo upon construction. This ensures only one instance
+ * of this repository type exists across the entire application.
+ *
+ * Use this class when you need a centralized repository that should have only one instance
+ * globally, such as application-wide entity collections or shared resource managers.
+ *
+ * @template T - The type of entities managed by this repository, must extend AppObjectEntity
+ * @extends AppObjectEntityRepo
+ *
+ * @example
+ * ```typescript
+ * // Create a singleton repository for player entities
+ * class PlayerRepo extends AppObjectSingletonEntityRepo<PlayerEntity> {
+ *   static type = "playerRepo";
+ *   constructor(appObject: AppObject) {
+ *     super(appObject, PlayerRepo.type);
+ *   }
+ * }
+ * ```
+ */
+export declare class AppObjectSingletonEntityRepo<T extends AppObjectEntity> extends AppObjectEntityRepo<T> {
+    /**
+     * Creates a new singleton entity repository component and attaches it to the specified AppObject
+     * Automatically registers itself as a singleton in the AppObjectRepo
+     *
+     * @param appObject The parent AppObject this component will be attached to
+     * @param type The unique type identifier for this component
+     */
+    constructor(appObject: AppObject, type: string);
+    /**
+     * Cleans up resources and unregisters the singleton
+     *
+     * This method:
+     * 1. Unregisters itself from the singleton registry
+     * 2. Calls the parent class dispose method
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=AppObjectSingletonEntityRepo.d.ts.map

package/dist/types/AppObject/AppObjectSingletonEntityRepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonEntityRepo.d.ts","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonEntityRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,4BAA4B,CACvC,CAAC,SAAS,eAAe,CACzB,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAC9B;;;;;;OAMG;gBACS,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM;IAM9C;;;;;;OAMG;IACH,OAAO;CAIR"}