@vived/core 1.6.0 → 2.0.0

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

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

package/dist/esm/AppObject/AppObjectSingletonEntity.js

@@ -0,0 +1,36 @@
+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 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, 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();
+    }
+}
+//# sourceMappingURL=AppObjectSingletonEntity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonEntity.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonEntity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,OAAO,wBAAyB,SAAQ,eAAe;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","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/esm/AppObject/AppObjectSingletonEntityRepo.js

@@ -0,0 +1,50 @@
+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 class AppObjectSingletonEntityRepo extends 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();
+    }
+}
+//# sourceMappingURL=AppObjectSingletonEntityRepo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonEntityRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonEntityRepo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,4BAEX,SAAQ,mBAAsB;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","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/esm/AppObject/AppObjectSingletonPM.js

@@ -0,0 +1,65 @@
+import { AppObjectPM } from "./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
+ *   }
+ * }
+ * ```
+ */
+export class AppObjectSingletonPM extends 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();
+    }
+}
+//# sourceMappingURL=AppObjectSingletonPM.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonPM.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonPM.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,OAAgB,oBAAwB,SAAQ,WAAc;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","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/esm/AppObject/AppObjectSingletonUC.js

@@ -0,0 +1,56 @@
+import { AppObjectUC } from "./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
+ *   }
+ * }
+ * ```
+ */
+export class AppObjectSingletonUC extends 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();
+    }
+}
+//# sourceMappingURL=AppObjectSingletonUC.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppObjectSingletonUC.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectSingletonUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;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","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/esm/AppObject/index.js

@@ -6,6 +6,10 @@ export * from "./AppObjectRepo";
 export * from "./AppObjectUC";
 export * from "./AppObjectController";
 export * from "./AppObjectView";
+export * from "./AppObjectSingletonEntity";
+export * from "./AppObjectSingletonEntityRepo";
+export * from "./AppObjectSingletonPM";
+export * from "./AppObjectSingletonUC";
 export * from "./getSingletonComponent";
 export * from "./printAppObjectDetails";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/AppObject/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC","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,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC","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/esm/Entities/ObserverList.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"ObserverList.js","sourceRoot":"","sources":["../../../src/Entities/ObserverList.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,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","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,MAAM,OAAO,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","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/esm/ExampleFeature/Entities/ExampleRepo.js

@@ -17,7 +17,6 @@
  * 4. Delete entities through the repository when they're no longer needed
  */
 import { AppObjectEntityRepo } from "../../AppObject";
-import { generateUniqueID } from "../../Utilities/generateUniqueID";
 import { makeExampleEntity } from "./ExampleEntity";
 /**
  * ExampleRepo manages a collection of ExampleEntity instances.
@@ -71,38 +70,28 @@ export function makeExampleRepo(appObject) {
  * This private class handles the actual implementation details
  */
 class ExampleRepoImp extends ExampleRepo {
+    /**
+     * Factory implementation for creating ExampleEntity instances
+     * @param id The ID for the entity's AppObject
+     * @returns A newly created ExampleEntity
+     */
+    entityFactory(id) {
+        const ao = this.appObjects.getOrCreate(id);
+        return makeExampleEntity(ao);
+    }
     /**
      * 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 ?? 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 makeExampleEntity(ao);
-        };
     }
 }
 //# sourceMappingURL=ExampleRepo.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ExampleRepo.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Entities/ExampleRepo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,mBAAmB,EAEpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAiB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKnE;;;GAGG;AACH,MAAM,OAAgB,WAAY,SAAQ,mBAAkC;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;;AA9CD,gDAAgD;AAChC,gBAAI,GAAG,iBAAiB,CAAC;AAgD3C;;;;GAIG;AACH,MAAM,UAAU,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,gBAAgB,EAAE,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,iBAAiB,CAAC,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;AAEH,OAAO,EAAa,mBAAmB,EAAiB,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAiB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKnE;;;GAGG;AACH,MAAM,OAAgB,WAAY,SAAQ,mBAAkC;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;;AAxCD,gDAAgD;AAChC,gBAAI,GAAG,iBAAiB,CAAC;AA0C3C;;;;GAIG;AACH,MAAM,UAAU,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,EAAU;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC/B,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 = (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  /** 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 id The ID for the entity's AppObject\r\n   * @returns A newly created ExampleEntity\r\n   */\r\n  entityFactory(id: string): ExampleEntity {\r\n    const ao = this.appObjects.getOrCreate(id);\r\n    return makeExampleEntity(ao);\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/esm/ExampleFeature/Entities/ExampleSingletonEntity.js

@@ -16,14 +16,14 @@
  * 2. Access or modify properties via getters/setters
  * 3. Register change observers to react to property updates
  */
-import { AppObjectEntity } from "../../AppObject";
+import { AppObjectSingletonEntity, } from "../../AppObject";
 import { getSingletonComponent } from "../../AppObject/getSingletonComponent";
 import { MemoizedBoolean } from "../../Entities/MemoizedBoolean";
 /**
  * SingletonEntityExample represents a global entity with a boolean property.
  * As a singleton, only one instance exists in the application.
  */
-export class SingletonEntityExample extends AppObjectEntity {
+export class SingletonEntityExample extends AppObjectSingletonEntity {
 }
 /** Unique type identifier for this component */
 SingletonEntityExample.type = "SingletonEntityExampleType";
@@ -57,8 +57,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(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/esm/ExampleFeature/Entities/ExampleSingletonEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExampleSingletonEntity.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Entities/ExampleSingletonEntity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;GAGG;AACH,MAAM,OAAgB,sBAAuB,SAAQ,eAAe;;AAClE,gDAAgD;AAChC,2BAAI,GAAG,4BAA4B,CAAC;AAMpD;;;;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;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,eAAe,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;AAEH,OAAO,EAGL,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;GAGG;AACH,MAAM,OAAgB,sBAAuB,SAAQ,wBAAwB;;AAC3E,gDAAgD;AAChC,2BAAI,GAAG,4BAA4B,CAAC;AAMpD;;;;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;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,eAAe,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/esm/ExampleFeature/Factory/ExampleFeatureFactory.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"ExampleFeatureFactory.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/Factory/ExampleFeatureFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IAAxD;;QAEC,gBAAW,GAAG,uBAAuB,CAAC;IA6CvC,CAAC;IA3CA;;;;;OAKG;IACH,aAAa;QAEZ,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAEP,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAEP,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,UAAU;QAET,gDAAgD;IACjD,CAAC;CACD;AAED,MAAM,UAAU,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":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IAAxD;;QAEC,gBAAW,GAAG,uBAAuB,CAAC;IA6CvC,CAAC;IA3CA;;;;;OAKG;IACH,aAAa;QAEZ,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAEP,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAEP,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,UAAU;QAET,gDAAgD;IACjD,CAAC;CACD;AAED,MAAM,UAAU,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/esm/ExampleFeature/PMs/ExamplePM.js

@@ -65,28 +65,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/esm/ExampleFeature/PMs/ExamplePM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExamplePM.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/PMs/ExamplePM.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAa,WAAW,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,MAAM,OAAgB,SAAU,SAAQ,WAAmB;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;;AAXD,gDAAgD;AAChC,cAAI,GAAG,eAAe,CAAC;AAazC;;;;GAIG;AACH,MAAM,UAAU,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,aAAa,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;AAEH,OAAO,EAAa,WAAW,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,MAAM,OAAgB,SAAU,SAAQ,WAAmB;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;;AAXD,gDAAgD;AAChC,cAAI,GAAG,eAAe,CAAC;AAazC;;;;GAIG;AACH,MAAM,UAAU,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,aAAa,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"]}