@vived/core 1.6.0 → 2.0.1

package/dist/cjs/AppObject/AppObjectSingletonEntity.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppObjectSingletonEntity = void 0;
+const AppObjectEntity_1 = require("./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.
+ */
+class AppObjectSingletonEntity extends AppObjectEntity_1.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, type) {
+        super(appObject, type);
+        this.appObjects.registerSingleton(this);
+    }
+    /**
+     * Cleans up resources and unregisters the singleton
+     *
+     * This method:
+     * 1. Unregisters itself from the singleton registry
+     * 2. Calls the parent class dispose method
+     */
+    dispose() {
+        this.appObjects.unregisterSingleton(this.type);
+        super.dispose();
+    }
+}
+exports.AppObjectSingletonEntity = AppObjectSingletonEntity;
+//# sourceMappingURL=AppObjectSingletonEntity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonEntity.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonEntity.ts"],"names":[],"mappings":";;;AACA,uDAAoD;AAEpD;;;;;;;;;GASG;AACH,MAAa,wBAAyB,SAAQ,iCAAe;IAC3D;;;;;;OAMG;IACH,YAAY,SAAoB,EAAE,IAAY;QAC5C,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAEvB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;CACF;AAzBD,4DAyBC","sourcesContent":["import { AppObject } from \"./AppObject\";\r\nimport { AppObjectEntity } from \"./AppObjectEntity\";\r\n\r\n/**\r\n * Singleton entity component that manages application state\r\n *\r\n * AppObjectSingletonEntity extends AppObjectEntity and automatically registers itself\r\n * as a singleton in the AppObjectRepo upon construction. This ensures only one instance\r\n * of this entity type exists across the entire application.\r\n *\r\n * Use this class when you need an entity that should have only one instance globally,\r\n * such as application-wide configuration or shared state managers.\r\n */\r\nexport class AppObjectSingletonEntity extends AppObjectEntity {\r\n  /**\r\n   * Creates a new singleton entity component and attaches it to the specified AppObject\r\n   * Automatically registers itself as a singleton in the AppObjectRepo\r\n   *\r\n   * @param appObject The parent AppObject this component will be attached to\r\n   * @param type The unique type identifier for this component\r\n   */\r\n  constructor(appObject: AppObject, type: string) {\r\n    super(appObject, type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n\r\n  /**\r\n   * Cleans up resources and unregisters the singleton\r\n   *\r\n   * This method:\r\n   * 1. Unregisters itself from the singleton registry\r\n   * 2. Calls the parent class dispose method\r\n   */\r\n  dispose() {\r\n    this.appObjects.unregisterSingleton(this.type);\r\n    super.dispose();\r\n  }\r\n}\r\n"]}

package/dist/cjs/AppObject/AppObjectSingletonEntityRepo.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppObjectSingletonEntityRepo = void 0;
+const AppObjectEntityRepo_1 = require("./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);
+ *   }
+ * }
+ * ```
+ */
+class AppObjectSingletonEntityRepo extends AppObjectEntityRepo_1.AppObjectEntityRepo {
+    /**
+     * 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, type) {
+        super(appObject, type);
+        this.appObjects.registerSingleton(this);
+    }
+    /**
+     * Cleans up resources and unregisters the singleton
+     *
+     * This method:
+     * 1. Unregisters itself from the singleton registry
+     * 2. Calls the parent class dispose method
+     */
+    dispose() {
+        this.appObjects.unregisterSingleton(this.type);
+        super.dispose();
+    }
+}
+exports.AppObjectSingletonEntityRepo = AppObjectSingletonEntityRepo;
+//# sourceMappingURL=AppObjectSingletonEntityRepo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonEntityRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonEntityRepo.ts"],"names":[],"mappings":";;;AAEA,+DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,4BAEX,SAAQ,yCAAsB;IAC9B;;;;;;OAMG;IACH,YAAY,SAAoB,EAAE,IAAY;QAC5C,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAEvB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;CACF;AA3BD,oEA2BC","sourcesContent":["import { AppObject } from \"./AppObject\";\r\nimport { AppObjectEntity } from \"./AppObjectEntity\";\r\nimport { AppObjectEntityRepo } from \"./AppObjectEntityRepo\";\r\n\r\n/**\r\n * A singleton repository for managing collections of AppObjectEntity instances.\r\n *\r\n * This generic class extends AppObjectEntityRepo and automatically registers itself\r\n * as a singleton in the AppObjectRepo upon construction. This ensures only one instance\r\n * of this repository type exists across the entire application.\r\n *\r\n * Use this class when you need a centralized repository that should have only one instance\r\n * globally, such as application-wide entity collections or shared resource managers.\r\n *\r\n * @template T - The type of entities managed by this repository, must extend AppObjectEntity\r\n * @extends AppObjectEntityRepo\r\n *\r\n * @example\r\n * ```typescript\r\n * // Create a singleton repository for player entities\r\n * class PlayerRepo extends AppObjectSingletonEntityRepo<PlayerEntity> {\r\n *   static type = \"playerRepo\";\r\n *   constructor(appObject: AppObject) {\r\n *     super(appObject, PlayerRepo.type);\r\n *   }\r\n * }\r\n * ```\r\n */\r\nexport class AppObjectSingletonEntityRepo<\r\n  T extends AppObjectEntity,\r\n> extends AppObjectEntityRepo<T> {\r\n  /**\r\n   * Creates a new singleton entity repository component and attaches it to the specified AppObject\r\n   * Automatically registers itself as a singleton in the AppObjectRepo\r\n   *\r\n   * @param appObject The parent AppObject this component will be attached to\r\n   * @param type The unique type identifier for this component\r\n   */\r\n  constructor(appObject: AppObject, type: string) {\r\n    super(appObject, type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n\r\n  /**\r\n   * Cleans up resources and unregisters the singleton\r\n   *\r\n   * This method:\r\n   * 1. Unregisters itself from the singleton registry\r\n   * 2. Calls the parent class dispose method\r\n   */\r\n  dispose() {\r\n    this.appObjects.unregisterSingleton(this.type);\r\n    super.dispose();\r\n  }\r\n}\r\n"]}

package/dist/cjs/AppObject/AppObjectSingletonPM.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppObjectSingletonPM = void 0;
+const AppObjectPM_1 = require("./AppObjectPM");
+/**
+ * Singleton Presentation Manager (PM) component that transforms application state into view models
+ *
+ * AppObjectSingletonPM extends AppObjectPM and automatically registers itself as a singleton
+ * in the AppObjectRepo upon construction. This ensures only one instance of this PM type exists
+ * across the entire application.
+ *
+ * Use this class when you need a presentation manager that should have only one instance globally,
+ * such as application-wide UI state managers or shared view model providers.
+ *
+ * A singleton 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
+ * 5. Exists as a single instance across the application
+ *
+ * @typeparam T The view model type this PM produces
+ * @extends AppObjectPM
+ *
+ * @example
+ * ```typescript
+ * class GlobalSettingsPM extends AppObjectSingletonPM<SettingsVM> {
+ *   static type = "globalSettingsPM";
+ *
+ *   constructor(appObject: AppObject) {
+ *     super(appObject, GlobalSettingsPM.type);
+ *   }
+ *
+ *   vmsAreEqual(a: SettingsVM, b: SettingsVM): boolean {
+ *     return a.theme === b.theme && a.language === b.language;
+ *   }
+ *
+ *   formVM(): void {
+ *     // Form view model from entities
+ *   }
+ * }
+ * ```
+ */
+class AppObjectSingletonPM extends AppObjectPM_1.AppObjectPM {
+    /**
+     * Creates a new singleton presentation manager 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, type) {
+        super(appObject, type);
+        this.appObjects.registerSingleton(this);
+    }
+    /**
+     * Cleans up resources and unregisters the singleton
+     *
+     * This method:
+     * 1. Unregisters itself from the singleton registry
+     * 2. Calls the parent class dispose method (which handles entity observers and views)
+     */
+    dispose() {
+        this.appObjects.unregisterSingleton(this.type);
+        super.dispose();
+    }
+}
+exports.AppObjectSingletonPM = AppObjectSingletonPM;
+//# sourceMappingURL=AppObjectSingletonPM.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonPM.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonPM.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAsB,oBAAwB,SAAQ,yBAAc;IAClE;;;;;;OAMG;IACH,YAAY,SAAoB,EAAE,IAAY;QAC5C,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAEvB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;CACF;AAzBD,oDAyBC","sourcesContent":["import { AppObject } from \"./AppObject\";\r\nimport { AppObjectPM } from \"./AppObjectPM\";\r\n\r\n/**\r\n * Singleton Presentation Manager (PM) component that transforms application state into view models\r\n *\r\n * AppObjectSingletonPM extends AppObjectPM and automatically registers itself as a singleton\r\n * in the AppObjectRepo upon construction. This ensures only one instance of this PM type exists\r\n * across the entire application.\r\n *\r\n * Use this class when you need a presentation manager that should have only one instance globally,\r\n * such as application-wide UI state managers or shared view model providers.\r\n *\r\n * A singleton 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 * 5. Exists as a single instance across the application\r\n *\r\n * @typeparam T The view model type this PM produces\r\n * @extends AppObjectPM\r\n *\r\n * @example\r\n * ```typescript\r\n * class GlobalSettingsPM extends AppObjectSingletonPM<SettingsVM> {\r\n *   static type = \"globalSettingsPM\";\r\n *\r\n *   constructor(appObject: AppObject) {\r\n *     super(appObject, GlobalSettingsPM.type);\r\n *   }\r\n *\r\n *   vmsAreEqual(a: SettingsVM, b: SettingsVM): boolean {\r\n *     return a.theme === b.theme && a.language === b.language;\r\n *   }\r\n *\r\n *   formVM(): void {\r\n *     // Form view model from entities\r\n *   }\r\n * }\r\n * ```\r\n */\r\nexport abstract class AppObjectSingletonPM<T> extends AppObjectPM<T> {\r\n  /**\r\n   * Creates a new singleton presentation manager component and attaches it to the specified AppObject\r\n   * Automatically registers itself as a singleton in the AppObjectRepo\r\n   *\r\n   * @param appObject The parent AppObject this component will be attached to\r\n   * @param type The unique type identifier for this component\r\n   */\r\n  constructor(appObject: AppObject, type: string) {\r\n    super(appObject, type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n\r\n  /**\r\n   * Cleans up resources and unregisters the singleton\r\n   *\r\n   * This method:\r\n   * 1. Unregisters itself from the singleton registry\r\n   * 2. Calls the parent class dispose method (which handles entity observers and views)\r\n   */\r\n  dispose() {\r\n    this.appObjects.unregisterSingleton(this.type);\r\n    super.dispose();\r\n  }\r\n}\r\n"]}

package/dist/cjs/AppObject/AppObjectSingletonUC.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppObjectSingletonUC = void 0;
+const AppObjectUC_1 = require("./AppObjectUC");
+/**
+ * AppObjectSingletonUC (Use Case) serves as a singleton use case class within the application framework.
+ *
+ * This class extends AppObjectUC and automatically registers itself as a singleton in the
+ * AppObjectRepo upon construction. This ensures only one instance of this use case type exists
+ * across the entire application.
+ *
+ * Use Cases are components that represent specific application operations or workflows.
+ * They encapsulate business rules and coordinate interactions between different parts
+ * of the application. Use this singleton version when the use case should exist as a
+ * single instance globally, such as application-wide orchestration or workflow managers.
+ *
+ * @extends AppObjectUC
+ *
+ * @example
+ * ```typescript
+ * class GlobalPurchaseManagerUC extends AppObjectSingletonUC {
+ *   static type = "globalPurchaseManagerUC";
+ *
+ *   constructor(appObject: AppObject) {
+ *     super(appObject, GlobalPurchaseManagerUC.type);
+ *   }
+ *
+ *   execute(itemId: string, quantity: number): boolean {
+ *     // Implement the purchase item use case
+ *     return true; // if successful
+ *   }
+ * }
+ * ```
+ */
+class AppObjectSingletonUC extends AppObjectUC_1.AppObjectUC {
+    /**
+     * Creates a new singleton use case 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, type) {
+        super(appObject, type);
+        this.appObjects.registerSingleton(this);
+    }
+    /**
+     * Cleans up resources and unregisters the singleton
+     *
+     * This method:
+     * 1. Unregisters itself from the singleton registry
+     * 2. Calls the parent class dispose method
+     */
+    dispose() {
+        this.appObjects.unregisterSingleton(this.type);
+        super.dispose();
+    }
+}
+exports.AppObjectSingletonUC = AppObjectSingletonUC;
+//# sourceMappingURL=AppObjectSingletonUC.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonUC.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonUC.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAa,oBAAqB,SAAQ,yBAAW;IACnD;;;;;;OAMG;IACH,YAAY,SAAoB,EAAE,IAAY;QAC5C,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAEvB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;CACF;AAzBD,oDAyBC","sourcesContent":["import { AppObject } from \"./AppObject\";\r\nimport { AppObjectUC } from \"./AppObjectUC\";\r\n\r\n/**\r\n * AppObjectSingletonUC (Use Case) serves as a singleton use case class within the application framework.\r\n *\r\n * This class extends AppObjectUC and automatically registers itself as a singleton in the\r\n * AppObjectRepo upon construction. This ensures only one instance of this use case type exists\r\n * across the entire application.\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. Use this singleton version when the use case should exist as a\r\n * single instance globally, such as application-wide orchestration or workflow managers.\r\n *\r\n * @extends AppObjectUC\r\n *\r\n * @example\r\n * ```typescript\r\n * class GlobalPurchaseManagerUC extends AppObjectSingletonUC {\r\n *   static type = \"globalPurchaseManagerUC\";\r\n *\r\n *   constructor(appObject: AppObject) {\r\n *     super(appObject, GlobalPurchaseManagerUC.type);\r\n *   }\r\n *\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 AppObjectSingletonUC extends AppObjectUC {\r\n  /**\r\n   * Creates a new singleton use case component and attaches it to the specified AppObject\r\n   * Automatically registers itself as a singleton in the AppObjectRepo\r\n   *\r\n   * @param appObject The parent AppObject this component will be attached to\r\n   * @param type The unique type identifier for this component\r\n   */\r\n  constructor(appObject: AppObject, type: string) {\r\n    super(appObject, type);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n\r\n  /**\r\n   * Cleans up resources and unregisters the singleton\r\n   *\r\n   * This method:\r\n   * 1. Unregisters itself from the singleton registry\r\n   * 2. Calls the parent class dispose method\r\n   */\r\n  dispose() {\r\n    this.appObjects.unregisterSingleton(this.type);\r\n    super.dispose();\r\n  }\r\n}\r\n"]}

package/dist/cjs/AppObject/index.js

@@ -22,6 +22,10 @@ __exportStar(require("./AppObjectRepo"), exports);
 __exportStar(require("./AppObjectUC"), exports);
 __exportStar(require("./AppObjectController"), exports);
 __exportStar(require("./AppObjectView"), exports);
+__exportStar(require("./AppObjectSingletonEntity"), exports);
+__exportStar(require("./AppObjectSingletonEntityRepo"), exports);
+__exportStar(require("./AppObjectSingletonPM"), exports);
+__exportStar(require("./AppObjectSingletonUC"), exports);
 __exportStar(require("./getSingletonComponent"), exports);
 __exportStar(require("./printAppObjectDetails"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +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\";"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/AppObject/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,oDAAkC;AAClC,wDAAsC;AACtC,gDAA8B;AAC9B,kDAAgC;AAChC,gDAA8B;AAC9B,wDAAsC;AACtC,kDAAgC;AAChC,6DAA2C;AAC3C,iEAA+C;AAC/C,yDAAuC;AACvC,yDAAuC;AACvC,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 \"./AppObjectSingletonEntity\";\r\nexport * from \"./AppObjectSingletonEntityRepo\";\r\nexport * from \"./AppObjectSingletonPM\";\r\nexport * from \"./AppObjectSingletonUC\";\r\nexport * from \"./getSingletonComponent\";\r\nexport * from \"./printAppObjectDetails\";\r\n"]}

package/dist/cjs/Entities/ObserverList.js

@@ -43,6 +43,12 @@ class ObserverList {
             this.observers = [];
         };
     }
+    /**
+     * Gets the number of observers in the list
+     */
+    get length() {
+        return this.observers.length;
+    }
 }
 exports.ObserverList = ObserverList;
 //# sourceMappingURL=ObserverList.js.map

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

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

package/dist/cjs/ExampleFeature/Entities/ExampleRepo.js

@@ -21,7 +21,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExampleRepo = void 0;
 exports.makeExampleRepo = makeExampleRepo;
 const AppObject_1 = require("../../AppObject");
-const generateUniqueID_1 = require("../../Utilities/generateUniqueID");
 const ExampleEntity_1 = require("./ExampleEntity");
 /**
  * ExampleRepo manages a collection of ExampleEntity instances.
@@ -76,38 +75,27 @@ function makeExampleRepo(appObject) {
  * This private class handles the actual implementation details
  */
 class ExampleRepoImp extends ExampleRepo {
+    /**
+     * Factory implementation for creating ExampleEntity instances
+     * @param appObject The AppObject for the entity
+     * @returns A newly created ExampleEntity
+     */
+    entityFactory(appObject) {
+        return (0, ExampleEntity_1.makeExampleEntity)(appObject);
+    }
     /**
      * Deletes an ExampleEntity from the repository by its AppObject ID
      * @param id The ID of the entity's AppObject
      */
     deleteExampleEntity(id) {
-        const entity = this.getForAppObject(id);
+        const entity = this.getById(id);
         if (!entity)
             return;
         entity.appObject.dispose();
-        this.removeForAppObject(id);
+        this.removeById(id);
     }
     constructor(appObject) {
         super(appObject, ExampleRepo.type);
-        /**
-         * Creates a new ExampleEntity and adds it to the repository
-         * @param id Optional ID for the entity's AppObject (generates one if not provided)
-         * @returns The newly created ExampleEntity
-         */
-        this.createExampleEntity = (id) => {
-            const idToUse = id ?? (0, generateUniqueID_1.generateUniqueID)();
-            const entity = this.exampleEntityFactory(idToUse);
-            this.add(entity);
-            return entity;
-        };
-        /**
-         * Default factory implementation for creating ExampleEntity instances
-         * Can be overridden to create specialized entities
-         */
-        this.exampleEntityFactory = (id) => {
-            const ao = this.appObjects.getOrCreate(id);
-            return (0, ExampleEntity_1.makeExampleEntity)(ao);
-        };
     }
 }
 //# sourceMappingURL=ExampleRepo.js.map

package/dist/cjs/ExampleFeature/Entities/ExampleRepo.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExampleRepo.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Entities/ExampleRepo.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAwEH,0CAEC;AAxED,+CAIyB;AACzB,uEAAoE;AACpE,mDAAmE;AAKnE;;;GAGG;AACH,MAAsB,WAAY,SAAQ,+BAAkC;IAa1E;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,MAAiB;QAC1B,OAAO,MAAM,CAAC,YAAY,CAAc,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,EAAU,EACV,UAAyB;QAEzB,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,YAAY,CAAc,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,SAAoB;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACvE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;;AA/CH,kCAgDC;AA/CC,gDAAgD;AAChC,gBAAI,GAAG,iBAAiB,CAAC;AAgD3C;;;;GAIG;AACH,SAAgB,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,cAAe,SAAQ,WAAW;IAatC;;;OAGG;IACH,mBAAmB,CAAC,EAAU;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAWD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAlCrC;;;;WAIG;QACH,wBAAmB,GAAG,CAAC,EAAsB,EAAiB,EAAE;YAC9D,MAAM,OAAO,GAAG,EAAE,IAAI,IAAA,mCAAgB,GAAE,CAAC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAcF;;;WAGG;QACH,yBAAoB,GAAG,CAAC,EAAU,EAAiB,EAAE;YACnD,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC3C,OAAO,IAAA,iCAAiB,EAAC,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC;IAIF,CAAC;CACF","sourcesContent":["/**\r\n * ExampleRepo.ts\r\n * \r\n * This file demonstrates how to implement a repository to manage collections of entities.\r\n * Repositories are responsible for creating, retrieving, and deleting entities.\r\n * \r\n * Key concepts:\r\n * - Repositories extend AppObjectEntityRepo<T> where T is the entity type\r\n * - They provide methods to create and delete entities\r\n * - They manage collections of entities and provide access to them\r\n * - They can use custom entity factories to create specialized entities\r\n * \r\n * Usage pattern:\r\n * 1. Get or create a repository using getById, get, or addIfMissing\r\n * 2. Use the repository to create new entities\r\n * 3. Access entities through the repository's getters\r\n * 4. Delete entities through the repository when they're no longer needed\r\n */\r\n\r\nimport {\r\n  AppObject,\r\n  AppObjectEntityRepo,\r\n  AppObjectRepo\r\n} from \"../../AppObject\";\r\nimport { generateUniqueID } from \"../../Utilities/generateUniqueID\";\r\nimport { ExampleEntity, makeExampleEntity } from \"./ExampleEntity\";\r\n\r\n/** Type definition for a factory function that creates ExampleEntity instances */\r\nexport type ExampleEntityFactory = (id: string) => ExampleEntity;\r\n\r\n/**\r\n * ExampleRepo manages a collection of ExampleEntity instances.\r\n * Abstract class provides the interface and static helper methods.\r\n */\r\nexport abstract class ExampleRepo extends AppObjectEntityRepo<ExampleEntity> {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"ExampleRepoType\";\r\n\r\n  /** Factory function used to create new entities */\r\n  abstract exampleEntityFactory: ExampleEntityFactory;\r\n\r\n  /** Creates a new entity with an optional ID */\r\n  abstract createExampleEntity(id?: string): ExampleEntity;\r\n  \r\n  /** Deletes an entity by its AppObject ID */\r\n  abstract deleteExampleEntity(id: string): void;\r\n\r\n  /**\r\n   * Retrieves an ExampleRepo component from an AppObject\r\n   * @param appObj The AppObject to get the component from\r\n   * @returns The ExampleRepo component or undefined if not found\r\n   */\r\n  static get(appObj: AppObject): ExampleRepo | undefined {\r\n    return appObj.getComponent<ExampleRepo>(this.type);\r\n  }\r\n\r\n  /**\r\n   * Retrieves an ExampleRepo 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 ExampleRepo component or undefined if not found\r\n   */\r\n  static getById(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): ExampleRepo | undefined {\r\n    return appObjects.get(id)?.getComponent<ExampleRepo>(this.type);\r\n  }\r\n\r\n  /**\r\n   * Ensures an ExampleRepo exists on the AppObject, creating one if needed\r\n   * @param appObject The AppObject to check/add the component to\r\n   * @returns The existing or newly created ExampleRepo\r\n   */\r\n  static addIfMissing(appObject: AppObject): ExampleRepo {\r\n    const existing = appObject.getComponent<ExampleRepo>(ExampleRepo.type);\r\n    if (existing) {\r\n      return existing;\r\n    } else {\r\n      return makeExampleRepo(appObject);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new ExampleRepo\r\n * @param appObject The AppObject to attach the repo to\r\n * @returns A new ExampleRepo instance\r\n */\r\nexport function makeExampleRepo(appObject: AppObject): ExampleRepo {\r\n  return new ExampleRepoImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ExampleRepo\r\n * This private class handles the actual implementation details\r\n */\r\nclass ExampleRepoImp extends ExampleRepo {\r\n  /**\r\n   * Creates a new ExampleEntity and adds it to the repository\r\n   * @param id Optional ID for the entity's AppObject (generates one if not provided)\r\n   * @returns The newly created ExampleEntity\r\n   */\r\n  createExampleEntity = (id: string | undefined): ExampleEntity => {\r\n    const idToUse = id ?? generateUniqueID();\r\n    const entity = this.exampleEntityFactory(idToUse);\r\n    this.add(entity);\r\n    return entity;\r\n  };\r\n\r\n  /**\r\n   * Deletes an ExampleEntity from the repository by its AppObject ID\r\n   * @param id The ID of the entity's AppObject\r\n   */\r\n  deleteExampleEntity(id: string): void {\r\n    const entity = this.getForAppObject(id);\r\n    if (!entity) return;\r\n\r\n    entity.appObject.dispose();\r\n    this.removeForAppObject(id);\r\n  }\r\n\r\n  /**\r\n   * Default factory implementation for creating ExampleEntity instances\r\n   * Can be overridden to create specialized entities\r\n   */\r\n  exampleEntityFactory = (id: string): ExampleEntity => {\r\n    const ao = this.appObjects.getOrCreate(id);\r\n    return makeExampleEntity(ao);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ExampleRepo.type);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ExampleRepo.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Entities/ExampleRepo.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AA6DH,0CAEC;AA7DD,+CAAgF;AAChF,mDAAmE;AAKnE;;;GAGG;AACH,MAAsB,WAAY,SAAQ,+BAAkC;IAO1E;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,MAAiB;QAC1B,OAAO,MAAM,CAAC,YAAY,CAAc,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,EAAU,EACV,UAAyB;QAEzB,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,YAAY,CAAc,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,SAAoB;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACvE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;;AAzCH,kCA0CC;AAzCC,gDAAgD;AAChC,gBAAI,GAAG,iBAAiB,CAAC;AA0C3C;;;;GAIG;AACH,SAAgB,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,cAAe,SAAQ,WAAW;IACtC;;;;OAIG;IACH,aAAa,CAAC,SAAoB;QAChC,OAAO,IAAA,iCAAiB,EAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,EAAU;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF","sourcesContent":["/**\r\n * ExampleRepo.ts\r\n *\r\n * This file demonstrates how to implement a repository to manage collections of entities.\r\n * Repositories are responsible for creating, retrieving, and deleting entities.\r\n *\r\n * Key concepts:\r\n * - Repositories extend AppObjectEntityRepo<T> where T is the entity type\r\n * - They provide methods to create and delete entities\r\n * - They manage collections of entities and provide access to them\r\n * - They can use custom entity factories to create specialized entities\r\n *\r\n * Usage pattern:\r\n * 1. Get or create a repository using getById, get, or addIfMissing\r\n * 2. Use the repository to create new entities\r\n * 3. Access entities through the repository's getters\r\n * 4. Delete entities through the repository when they're no longer needed\r\n */\r\n\r\nimport { AppObject, AppObjectEntityRepo, AppObjectRepo } from \"../../AppObject\";\r\nimport { ExampleEntity, makeExampleEntity } from \"./ExampleEntity\";\r\n\r\n/** Type definition for a factory function that creates ExampleEntity instances */\r\nexport type ExampleEntityFactory = (appObject: AppObject) => ExampleEntity;\r\n\r\n/**\r\n * ExampleRepo manages a collection of ExampleEntity instances.\r\n * Abstract class provides the interface and static helper methods.\r\n */\r\nexport abstract class ExampleRepo extends AppObjectEntityRepo<ExampleEntity> {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"ExampleRepoType\";\r\n\r\n  /** Deletes an entity by its AppObject ID */\r\n  abstract deleteExampleEntity(id: string): void;\r\n\r\n  /**\r\n   * Retrieves an ExampleRepo component from an AppObject\r\n   * @param appObj The AppObject to get the component from\r\n   * @returns The ExampleRepo component or undefined if not found\r\n   */\r\n  static get(appObj: AppObject): ExampleRepo | undefined {\r\n    return appObj.getComponent<ExampleRepo>(this.type);\r\n  }\r\n\r\n  /**\r\n   * Retrieves an ExampleRepo 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 ExampleRepo component or undefined if not found\r\n   */\r\n  static getById(\r\n    id: string,\r\n    appObjects: AppObjectRepo\r\n  ): ExampleRepo | undefined {\r\n    return appObjects.get(id)?.getComponent<ExampleRepo>(this.type);\r\n  }\r\n\r\n  /**\r\n   * Ensures an ExampleRepo exists on the AppObject, creating one if needed\r\n   * @param appObject The AppObject to check/add the component to\r\n   * @returns The existing or newly created ExampleRepo\r\n   */\r\n  static addIfMissing(appObject: AppObject): ExampleRepo {\r\n    const existing = appObject.getComponent<ExampleRepo>(ExampleRepo.type);\r\n    if (existing) {\r\n      return existing;\r\n    } else {\r\n      return makeExampleRepo(appObject);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new ExampleRepo\r\n * @param appObject The AppObject to attach the repo to\r\n * @returns A new ExampleRepo instance\r\n */\r\nexport function makeExampleRepo(appObject: AppObject): ExampleRepo {\r\n  return new ExampleRepoImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ExampleRepo\r\n * This private class handles the actual implementation details\r\n */\r\nclass ExampleRepoImp extends ExampleRepo {\r\n  /**\r\n   * Factory implementation for creating ExampleEntity instances\r\n   * @param appObject The AppObject for the entity\r\n   * @returns A newly created ExampleEntity\r\n   */\r\n  entityFactory(appObject: AppObject): ExampleEntity {\r\n    return makeExampleEntity(appObject);\r\n  }\r\n\r\n  /**\r\n   * Deletes an ExampleEntity from the repository by its AppObject ID\r\n   * @param id The ID of the entity's AppObject\r\n   */\r\n  deleteExampleEntity(id: string): void {\r\n    const entity = this.getById(id);\r\n    if (!entity) return;\r\n\r\n    entity.appObject.dispose();\r\n    this.removeById(id);\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ExampleRepo.type);\r\n  }\r\n}\r\n"]}

package/dist/cjs/ExampleFeature/Entities/ExampleSingletonEntity.js

@@ -27,7 +27,7 @@ const MemoizedBoolean_1 = require("../../Entities/MemoizedBoolean");
  * SingletonEntityExample represents a global entity with a boolean property.
  * As a singleton, only one instance exists in the application.
  */
-class SingletonEntityExample extends AppObject_1.AppObjectEntity {
+class SingletonEntityExample extends AppObject_1.AppObjectSingletonEntity {
 }
 exports.SingletonEntityExample = SingletonEntityExample;
 /** Unique type identifier for this component */
@@ -62,8 +62,6 @@ class SingletonEntityExampleImp extends SingletonEntityExample {
         super(appObject, SingletonEntityExample.type);
         // MemoizedBoolean tracks changes to the boolean value and calls notifyOnChange when updated
         this.memoizedIsAuthoring = new MemoizedBoolean_1.MemoizedBoolean(false, this.notifyOnChange);
-        // Register this entity as a singleton so it can be accessed globally
-        this.appObjects.registerSingleton(this);
     }
 }
 //# sourceMappingURL=ExampleSingletonEntity.js.map

package/dist/cjs/ExampleFeature/Entities/ExampleSingletonEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExampleSingletonEntity.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Entities/ExampleSingletonEntity.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAsCH,gEAIC;AAxCD,+CAIyB;AACzB,iFAA8E;AAC9E,oEAAiE;AAEjE;;;GAGG;AACH,MAAsB,sBAAuB,SAAQ,2BAAe;;AAApE,wDAiBC;AAhBC,gDAAgD;AAChC,2BAAI,GAAG,4BAA4B,CAAC;AAMpD;;;;GAIG;AACI,0BAAG,GAAG,CACX,UAAyB,EACW,EAAE,CACtC,IAAA,6CAAqB,EAAC,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAGnE;;;;GAIG;AACH,SAAgB,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,yBAA0B,SAAQ,sBAAsB;IAI5D,iDAAiD;IACjD,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC;IACtC,CAAC;IAED,IAAI,aAAa,CAAC,GAAY;QAC5B,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,GAAG,CAAC;IACrC,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAbhD,4FAA4F;QACpF,wBAAmB,GAAG,IAAI,iCAAe,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAa5E,qEAAqE;QACrE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["/**\r\n * ExampleSingletonEntity.ts\r\n * \r\n * This file demonstrates how to implement a singleton entity in the application.\r\n * Singleton entities are special entities that exist only once in the application\r\n * and can be accessed globally from anywhere.\r\n * \r\n * Key concepts:\r\n * - Singleton entities extend AppObjectEntity like regular entities\r\n * - They register themselves as singletons with appObjects.registerSingleton()\r\n * - They're accessed through a static get() method using getSingletonComponent()\r\n * - There's only one instance of a singleton entity in the entire application\r\n * \r\n * Usage pattern:\r\n * 1. Access the singleton entity using the static get() method\r\n * 2. Access or modify properties via getters/setters\r\n * 3. Register change observers to react to property updates\r\n */\r\n\r\nimport {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo\r\n} from \"../../AppObject\";\r\nimport { getSingletonComponent } from \"../../AppObject/getSingletonComponent\";\r\nimport { MemoizedBoolean } from \"../../Entities/MemoizedBoolean\";\r\n\r\n/**\r\n * SingletonEntityExample represents a global entity with a boolean property.\r\n * As a singleton, only one instance exists in the application.\r\n */\r\nexport abstract class SingletonEntityExample extends AppObjectEntity {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"SingletonEntityExampleType\";\r\n\r\n  /** Boolean property accessor methods that must be implemented */\r\n  abstract get aBoolProperty(): boolean;\r\n  abstract set aBoolProperty(val: boolean);\r\n\r\n  /**\r\n   * Global accessor for the singleton entity\r\n   * @param appObjects The AppObjectRepo to search in\r\n   * @returns The singleton entity or undefined if not created yet\r\n   */\r\n  static get = (\r\n    appObjects: AppObjectRepo\r\n  ): SingletonEntityExample | undefined =>\r\n    getSingletonComponent(SingletonEntityExample.type, appObjects);\r\n}\r\n\r\n/**\r\n * Factory function to create a new SingletonEntityExample\r\n * @param appObject The AppObject to attach the entity to\r\n * @returns A new SingletonEntityExample instance\r\n */\r\nexport function makeSingletonEntityExample(\r\n  appObject: AppObject\r\n): SingletonEntityExample {\r\n  return new SingletonEntityExampleImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of SingletonEntityExample\r\n * This private class handles the actual implementation details\r\n */\r\nclass SingletonEntityExampleImp extends SingletonEntityExample {\r\n  // MemoizedBoolean tracks changes to the boolean value and calls notifyOnChange when updated\r\n  private memoizedIsAuthoring = new MemoizedBoolean(false, this.notifyOnChange);\r\n  \r\n  // Property accessors that use the memoized value\r\n  get aBoolProperty() {\r\n    return this.memoizedIsAuthoring.val;\r\n  }\r\n  \r\n  set aBoolProperty(val: boolean) {\r\n    this.memoizedIsAuthoring.val = val;\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SingletonEntityExample.type);\r\n    // Register this entity as a singleton so it can be accessed globally\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ExampleSingletonEntity.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Entities/ExampleSingletonEntity.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAsCH,gEAIC;AAxCD,+CAIyB;AACzB,iFAA8E;AAC9E,oEAAiE;AAEjE;;;GAGG;AACH,MAAsB,sBAAuB,SAAQ,oCAAwB;;AAA7E,wDAiBC;AAhBC,gDAAgD;AAChC,2BAAI,GAAG,4BAA4B,CAAC;AAMpD;;;;GAIG;AACI,0BAAG,GAAG,CACX,UAAyB,EACW,EAAE,CACtC,IAAA,6CAAqB,EAAC,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAGnE;;;;GAIG;AACH,SAAgB,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,yBAA0B,SAAQ,sBAAsB;IAI5D,iDAAiD;IACjD,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC;IACtC,CAAC;IAED,IAAI,aAAa,CAAC,GAAY;QAC5B,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,GAAG,CAAC;IACrC,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAbhD,4FAA4F;QACpF,wBAAmB,GAAG,IAAI,iCAAe,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAa9E,CAAC;CACF","sourcesContent":["/**\r\n * ExampleSingletonEntity.ts\r\n *\r\n * This file demonstrates how to implement a singleton entity in the application.\r\n * Singleton entities are special entities that exist only once in the application\r\n * and can be accessed globally from anywhere.\r\n *\r\n * Key concepts:\r\n * - Singleton entities extend AppObjectEntity like regular entities\r\n * - They register themselves as singletons with appObjects.registerSingleton()\r\n * - They're accessed through a static get() method using getSingletonComponent()\r\n * - There's only one instance of a singleton entity in the entire application\r\n *\r\n * Usage pattern:\r\n * 1. Access the singleton entity using the static get() method\r\n * 2. Access or modify properties via getters/setters\r\n * 3. Register change observers to react to property updates\r\n */\r\n\r\nimport {\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectSingletonEntity,\r\n} from \"../../AppObject\";\r\nimport { getSingletonComponent } from \"../../AppObject/getSingletonComponent\";\r\nimport { MemoizedBoolean } from \"../../Entities/MemoizedBoolean\";\r\n\r\n/**\r\n * SingletonEntityExample represents a global entity with a boolean property.\r\n * As a singleton, only one instance exists in the application.\r\n */\r\nexport abstract class SingletonEntityExample extends AppObjectSingletonEntity {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"SingletonEntityExampleType\";\r\n\r\n  /** Boolean property accessor methods that must be implemented */\r\n  abstract get aBoolProperty(): boolean;\r\n  abstract set aBoolProperty(val: boolean);\r\n\r\n  /**\r\n   * Global accessor for the singleton entity\r\n   * @param appObjects The AppObjectRepo to search in\r\n   * @returns The singleton entity or undefined if not created yet\r\n   */\r\n  static get = (\r\n    appObjects: AppObjectRepo\r\n  ): SingletonEntityExample | undefined =>\r\n    getSingletonComponent(SingletonEntityExample.type, appObjects);\r\n}\r\n\r\n/**\r\n * Factory function to create a new SingletonEntityExample\r\n * @param appObject The AppObject to attach the entity to\r\n * @returns A new SingletonEntityExample instance\r\n */\r\nexport function makeSingletonEntityExample(\r\n  appObject: AppObject\r\n): SingletonEntityExample {\r\n  return new SingletonEntityExampleImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of SingletonEntityExample\r\n * This private class handles the actual implementation details\r\n */\r\nclass SingletonEntityExampleImp extends SingletonEntityExample {\r\n  // MemoizedBoolean tracks changes to the boolean value and calls notifyOnChange when updated\r\n  private memoizedIsAuthoring = new MemoizedBoolean(false, this.notifyOnChange);\r\n\r\n  // Property accessors that use the memoized value\r\n  get aBoolProperty() {\r\n    return this.memoizedIsAuthoring.val;\r\n  }\r\n\r\n  set aBoolProperty(val: boolean) {\r\n    this.memoizedIsAuthoring.val = val;\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SingletonEntityExample.type);\r\n  }\r\n}\r\n"]}

package/dist/cjs/ExampleFeature/Factory/ExampleFeatureFactory.js

@@ -59,7 +59,7 @@ class ExampleFeatureFactory extends DomainFactories_1.DomainFactory {
 }
 exports.ExampleFeatureFactory = ExampleFeatureFactory;
 function makeExampleFeatureFactory(appObjects) {
-    const appObject = appObjects.getOrCreate("ExampleFeatureFactory");
+    const appObject = appObjects.getOrCreate("FeatureName");
     return new ExampleFeatureFactory(appObject);
 }
 //# sourceMappingURL=ExampleFeatureFactory.js.map

package/dist/cjs/ExampleFeature/Factory/ExampleFeatureFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExampleFeatureFactory.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Factory/ExampleFeatureFactory.ts"],"names":[],"mappings":";;;AAgEA,8DAGC;AAlED,2DAAsD;AACtD,+EAAgF;AAChF,kEAAmE;AACnE,0EAA2E;AAE3E;;;;;;;;GAQG;AACH,MAAa,qBAAsB,SAAQ,+BAAa;IAAxD;;QAEC,gBAAW,GAAG,uBAAuB,CAAC;IA6CvC,CAAC;IA3CA;;;;;OAKG;IACH,aAAa;QAEZ,IAAA,mDAA0B,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAEP,IAAA,mDAA0B,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAEP,IAAA,2CAAsB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,UAAU;QAET,gDAAgD;IACjD,CAAC;CACD;AA/CD,sDA+CC;AAED,SAAgB,yBAAyB,CAAC,UAAyB;IAClE,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAClE,OAAO,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { AppObjectRepo } from \"../../AppObject\";\r\nimport { DomainFactory } from \"../../DomainFactories\";\r\nimport { makeSingletonEntityExample } from \"../Entities/ExampleSingletonEntity\";\r\nimport { makeExampleSingletonPM } from \"../PMs/ExampleSingletonPM\";\r\nimport { makeToggleExampleBooleanUC } from \"../UCs/ToggleExampleBooleanUC\";\r\n\r\n/**\r\n * Factory responsible for setting up the Example Feature domain components.\r\n * \r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Example Feature functionality. It follows the domain-driven\r\n * design pattern by organizing components into their respective layers.\r\n * \r\n * @extends DomainFactory\r\n */\r\nexport class ExampleFeatureFactory extends DomainFactory\r\n{\r\n\tfactoryName = \"ExampleFeatureFactory\";\r\n\r\n\t/**\r\n\t * Sets up all entities required for the Example Feature.\r\n\t * \r\n\t * Initializes singleton entities that maintain the state and business\r\n\t * logic for the example feature functionality.\r\n\t */\r\n\tsetupEntities(): void\r\n\t{\r\n\t\tmakeSingletonEntityExample(this.appObject);\r\n\t}\r\n\r\n\t/**\r\n\t * Sets up all use cases for the Example Feature.\r\n\t * \r\n\t * Initializes use cases that define the business operations and\r\n\t * workflows available in the example feature.\r\n\t */\r\n\tsetupUCs(): void\r\n\t{\r\n\t\tmakeToggleExampleBooleanUC(this.appObject);\r\n\t}\r\n\r\n\t/**\r\n\t * Sets up all presentation models for the Example Feature.\r\n\t * \r\n\t * Initializes presentation models that handle the view logic and\r\n\t * state management for UI components related to the example feature.\r\n\t */\r\n\tsetupPMs(): void\r\n\t{\r\n\t\tmakeExampleSingletonPM(this.appObject);\r\n\t}\r\n\r\n\t/**\r\n\t * Performs any final setup operations after all components are initialized.\r\n\t * \r\n\t * This method is called after entities, use cases, and presentation models\r\n\t * have been set up. Currently no additional setup is required for this feature.\r\n\t */\r\n\tfinalSetup(): void\r\n\t{\r\n\t\t// No additional setup required for this feature\r\n\t}\r\n}\r\n\r\nexport function makeExampleFeatureFactory(appObjects: AppObjectRepo):ExampleFeatureFactory {\r\n\tconst appObject = appObjects.getOrCreate(\"ExampleFeatureFactory\");\r\n\treturn new ExampleFeatureFactory(appObject);\r\n}"]}
+{"version":3,"file":"ExampleFeatureFactory.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Factory/ExampleFeatureFactory.ts"],"names":[],"mappings":";;;AAgEA,8DAGC;AAlED,2DAAsD;AACtD,+EAAgF;AAChF,kEAAmE;AACnE,0EAA2E;AAE3E;;;;;;;;GAQG;AACH,MAAa,qBAAsB,SAAQ,+BAAa;IAAxD;;QAEC,gBAAW,GAAG,uBAAuB,CAAC;IA6CvC,CAAC;IA3CA;;;;;OAKG;IACH,aAAa;QAEZ,IAAA,mDAA0B,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAEP,IAAA,mDAA0B,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAEP,IAAA,2CAAsB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,UAAU;QAET,gDAAgD;IACjD,CAAC;CACD;AA/CD,sDA+CC;AAED,SAAgB,yBAAyB,CAAC,UAAyB;IAClE,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IACxD,OAAO,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { AppObjectRepo } from \"../../AppObject\";\r\nimport { DomainFactory } from \"../../DomainFactories\";\r\nimport { makeSingletonEntityExample } from \"../Entities/ExampleSingletonEntity\";\r\nimport { makeExampleSingletonPM } from \"../PMs/ExampleSingletonPM\";\r\nimport { makeToggleExampleBooleanUC } from \"../UCs/ToggleExampleBooleanUC\";\r\n\r\n/**\r\n * Factory responsible for setting up the Example Feature domain components.\r\n * \r\n * This factory initializes all entities, use cases, and presentation models\r\n * required for the Example Feature functionality. It follows the domain-driven\r\n * design pattern by organizing components into their respective layers.\r\n * \r\n * @extends DomainFactory\r\n */\r\nexport class ExampleFeatureFactory extends DomainFactory\r\n{\r\n\tfactoryName = \"ExampleFeatureFactory\";\r\n\r\n\t/**\r\n\t * Sets up all entities required for the Example Feature.\r\n\t * \r\n\t * Initializes singleton entities that maintain the state and business\r\n\t * logic for the example feature functionality.\r\n\t */\r\n\tsetupEntities(): void\r\n\t{\r\n\t\tmakeSingletonEntityExample(this.appObject);\r\n\t}\r\n\r\n\t/**\r\n\t * Sets up all use cases for the Example Feature.\r\n\t * \r\n\t * Initializes use cases that define the business operations and\r\n\t * workflows available in the example feature.\r\n\t */\r\n\tsetupUCs(): void\r\n\t{\r\n\t\tmakeToggleExampleBooleanUC(this.appObject);\r\n\t}\r\n\r\n\t/**\r\n\t * Sets up all presentation models for the Example Feature.\r\n\t * \r\n\t * Initializes presentation models that handle the view logic and\r\n\t * state management for UI components related to the example feature.\r\n\t */\r\n\tsetupPMs(): void\r\n\t{\r\n\t\tmakeExampleSingletonPM(this.appObject);\r\n\t}\r\n\r\n\t/**\r\n\t * Performs any final setup operations after all components are initialized.\r\n\t * \r\n\t * This method is called after entities, use cases, and presentation models\r\n\t * have been set up. Currently no additional setup is required for this feature.\r\n\t */\r\n\tfinalSetup(): void\r\n\t{\r\n\t\t// No additional setup required for this feature\r\n\t}\r\n}\r\n\r\nexport function makeExampleFeatureFactory(appObjects: AppObjectRepo):ExampleFeatureFactory {\r\n\tconst appObject = appObjects.getOrCreate(\"FeatureName\");\r\n\treturn new ExampleFeatureFactory(appObject);\r\n}"]}

package/dist/cjs/ExampleFeature/PMs/ExamplePM.js

@@ -70,28 +70,20 @@ class ExamplePMImp extends ExamplePM {
     }
     constructor(appObject) {
         super(appObject, ExamplePM.type);
+        /** Default view model before any entity data is available */
+        this.defaultVM = "";
         /**
          * Handler for entity change events
          * Transforms entity data into a view model and updates views
          */
-        this.onEntityChange = () => {
-            if (!this.exampleEntity)
-                return;
+        this.formVM = () => {
             // In this simple case, our view model is just the string property value
             this.doUpdateView(this.exampleEntity.aStringProperty);
         };
-        /**
-         * Cleanup method called when the PM is being disposed
-         * Removes any observers to prevent memory leaks
-         */
-        this.dispose = () => {
-            super.dispose();
-            this.exampleEntity?.removeChangeObserver(this.onEntityChange);
-        };
         // 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();
+        this.formVM();
     }
 }
 //# sourceMappingURL=ExamplePM.js.map

package/dist/cjs/ExampleFeature/PMs/ExamplePM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExamplePM.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/PMs/ExamplePM.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AA6BH,sCAEC;AA7BD,+CAAwE;AACxE,6DAA0D;AAE1D;;;GAGG;AACH,MAAsB,SAAU,SAAQ,uBAAmB;IAIzD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,EAAU,EAAE,UAAyB;QAClD,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;;AAZH,8BAaC;AAZC,gDAAgD;AAChC,cAAI,GAAG,eAAe,CAAC;AAazC;;;;GAIG;AACH,SAAgB,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,YAAa,SAAQ,SAAS;IAClC;;;OAGG;IACH,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,uBAAuB,CAAgB,6BAAa,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,CAAS,EAAE,CAAS;QAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAsBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QArBnC;;;WAGG;QACH,mBAAc,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,aAAa;gBAAE,OAAO;YAEhC,wEAAwE;YACxE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;QACxD,CAAC,CAAC;QAEF;;;WAGG;QACH,YAAO,GAAG,GAAS,EAAE;YACnB,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChE,CAAC,CAAC;QAKA,wEAAwE;QACxE,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAE3D,qEAAqE;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF","sourcesContent":["/**\r\n * ExamplePM.ts\r\n * \r\n * This file demonstrates how to implement a Presentation Manager (PM) component.\r\n * PMs are responsible for transforming entity data into view models (VMs) for the UI.\r\n * They observe entities for changes and update their views when data changes.\r\n * \r\n * Key concepts:\r\n * - PMs extend AppObjectPM<VM> where VM is the view model type\r\n * - They observe entities and transform entity data into view models\r\n * - They notify UI components (views) when view models change\r\n * - Each PM instance is associated with a specific AppObject\r\n * \r\n * Usage pattern:\r\n * 1. Get a PM instance using getById\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 { AppObject, AppObjectPM, AppObjectRepo } from \"../../AppObject\";\r\nimport { ExampleEntity } from \"../Entities/ExampleEntity\";\r\n\r\n/**\r\n * ExamplePM transforms ExampleEntity data into a simple string view model.\r\n * Abstract class provides the interface and static helper methods.\r\n */\r\nexport abstract class ExamplePM extends AppObjectPM<string> {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"ExamplePMType\";\r\n\r\n  /**\r\n   * Retrieves an ExamplePM 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 ExamplePM component or undefined if not found\r\n   */\r\n  static getById(id: string, appObjects: AppObjectRepo) {\r\n    return appObjects.get(id)?.getComponent<ExamplePM>(ExamplePM.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new ExamplePM\r\n * @param appObject The AppObject to attach the PM to\r\n * @returns A new ExamplePM instance\r\n */\r\nexport function makeExamplePM(appObject: AppObject): ExamplePM {\r\n  return new ExamplePMImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ExamplePM\r\n * This private class handles the actual implementation details\r\n */\r\nclass ExamplePMImp extends ExamplePM {\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   * 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: string, b: string): boolean {\r\n    return a === b;\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    // In this simple case, our view model is just the string property value\r\n    this.doUpdateView(this.exampleEntity.aStringProperty);\r\n  };\r\n\r\n  /**\r\n   * Cleanup method called when the PM is being disposed\r\n   * Removes any observers to prevent memory leaks\r\n   */\r\n  dispose = (): void => {\r\n    super.dispose();\r\n    this.exampleEntity?.removeChangeObserver(this.onEntityChange);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ExamplePM.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}\r\n"]}
+{"version":3,"file":"ExamplePM.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/PMs/ExamplePM.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AA6BH,sCAEC;AA7BD,+CAAwE;AACxE,6DAA0D;AAE1D;;;GAGG;AACH,MAAsB,SAAU,SAAQ,uBAAmB;IAIzD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,EAAU,EAAE,UAAyB;QAClD,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,YAAY,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;;AAZH,8BAaC;AAZC,gDAAgD;AAChC,cAAI,GAAG,eAAe,CAAC;AAazC;;;;GAIG;AACH,SAAgB,aAAa,CAAC,SAAoB;IAChD,OAAO,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,YAAa,SAAQ,SAAS;IAIlC;;;OAGG;IACH,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,uBAAuB,CAAgB,6BAAa,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,CAAS,EAAE,CAAS;QAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAYD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QA9BnC,6DAA6D;QACpD,cAAS,GAAG,EAAE,CAAC;QAkBxB;;;WAGG;QACH,WAAM,GAAG,GAAG,EAAE;YACZ,wEAAwE;YACxE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;QACxD,CAAC,CAAC;QAMA,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 * ExamplePM.ts\r\n *\r\n * This file demonstrates how to implement a Presentation Manager (PM) component.\r\n * PMs are responsible for transforming entity data into view models (VMs) for the UI.\r\n * They observe entities for changes and update their views when data changes.\r\n *\r\n * Key concepts:\r\n * - PMs extend AppObjectPM<VM> where VM is the view model type\r\n * - They observe entities and transform entity data into view models\r\n * - They notify UI components (views) when view models change\r\n * - Each PM instance is associated with a specific AppObject\r\n *\r\n * Usage pattern:\r\n * 1. Get a PM instance using getById\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 { AppObject, AppObjectPM, AppObjectRepo } from \"../../AppObject\";\r\nimport { ExampleEntity } from \"../Entities/ExampleEntity\";\r\n\r\n/**\r\n * ExamplePM transforms ExampleEntity data into a simple string view model.\r\n * Abstract class provides the interface and static helper methods.\r\n */\r\nexport abstract class ExamplePM extends AppObjectPM<string> {\r\n  /** Unique type identifier for this component */\r\n  static readonly type = \"ExamplePMType\";\r\n\r\n  /**\r\n   * Retrieves an ExamplePM 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 ExamplePM component or undefined if not found\r\n   */\r\n  static getById(id: string, appObjects: AppObjectRepo) {\r\n    return appObjects.get(id)?.getComponent<ExamplePM>(ExamplePM.type);\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new ExamplePM\r\n * @param appObject The AppObject to attach the PM to\r\n * @returns A new ExamplePM instance\r\n */\r\nexport function makeExamplePM(appObject: AppObject): ExamplePM {\r\n  return new ExamplePMImp(appObject);\r\n}\r\n\r\n/**\r\n * Concrete implementation of ExamplePM\r\n * This private class handles the actual implementation details\r\n */\r\nclass ExamplePMImp extends ExamplePM {\r\n  /** Default view model before any entity data is available */\r\n  readonly defaultVM = \"\";\r\n\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   * 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: string, b: string): boolean {\r\n    return a === b;\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  formVM = () => {\r\n    // In this simple case, our view model is just the string property value\r\n    this.doUpdateView(this.exampleEntity.aStringProperty);\r\n  };\r\n\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ExamplePM.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/cjs/ExampleFeature/PMs/ExampleSingletonPM.js

@@ -7,10 +7,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
@@ -28,7 +28,7 @@ const ExampleSingletonEntity_1 = require("../Entities/ExampleSingletonEntity");
  * ExampleSingletonPM transforms SingletonEntityExample data into an ExampleVM.
  * As a singleton, only one instance exists in the application.
  */
-class ExampleSingletonPM extends AppObject_1.AppObjectPM {
+class ExampleSingletonPM extends AppObject_1.AppObjectSingletonPM {
 }
 exports.ExampleSingletonPM = ExampleSingletonPM;
 /** Unique type identifier for this component */
@@ -44,7 +44,7 @@ ExampleSingletonPM.get = (appObjects) => (0, getSingletonComponent_1.getSingleto
  * UI components can use this initially or when the PM is not found
  */
 exports.defaultSlideNavigationVM = {
-    aBoolProperty: true
+    aBoolProperty: true,
 };
 /**
  * Factory function to create a new ExampleSingletonPM
@@ -78,12 +78,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
@@ -92,11 +90,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/cjs/ExampleFeature/PMs/ExampleSingletonPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExampleSingletonPM.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/PMs/ExampleSingletonPM.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AA+CH,wDAIC;AAjDD,+CAIyB;AACzB,iFAA8E;AAC9E,+EAA4E;AAS5E;;;GAGG;AACH,MAAsB,kBAAmB,SAAQ,uBAAsB;;AAAvE,gDAWC;AAVC,gDAAgD;AAChC,uBAAI,GAAG,wBAAwB,CAAC;AAEhD;;;;GAIG;AACI,sBAAG,GAAG,CAAC,UAAyB,EAAkC,EAAE,CACzE,IAAA,6CAAqB,EAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAG/D;;;GAGG;AACU,QAAA,wBAAwB,GAAc;IACjD,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;;;GAIG;AACH,SAAgB,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,+CAAsB,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;;;AA+CH,wDAIC;AAjDD,+CAIyB;AACzB,iFAA8E;AAC9E,+EAA4E;AAS5E;;;GAGG;AACH,MAAsB,kBAAmB,SAAQ,gCAA+B;;AAAhF,gDAWC;AAVC,gDAAgD;AAChC,uBAAI,GAAG,wBAAwB,CAAC;AAEhD;;;;GAIG;AACI,sBAAG,GAAG,CAAC,UAAyB,EAAkC,EAAE,CACzE,IAAA,6CAAqB,EAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAG/D;;;GAGG;AACU,QAAA,wBAAwB,GAAc;IACjD,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;;;GAIG;AACH,SAAgB,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,+CAAsB,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"]}