@vived/core 2.0.0 → 2.0.2

package/README.md

@@ -4,7 +4,7 @@ Core Components for VIVED Apps and Hosts
 
 ## Overview
 
-@vived/core provides foundational architecture components used across VIVED applications. This library implements a component-based architecture pattern that enables building complex applications with proper separation of concerns.
+`@vived/core` provides a comprehensive architecture framework for building scalable, maintainable applications using Clean Architecture principles. The library combines a component-based architecture (AppObject pattern) with reactive entities, immutable value objects, and utility functions optimized for 3D graphics and interactive applications.
 
 ## Installation
 
@@ -12,93 +12,303 @@ Core Components for VIVED Apps and Hosts
 npm install @vived/core
 ```
 
-## Core Concepts
+## Documentation
 
-The package is built around the "AppObject" architecture, which follows a component-based design pattern:
+This package includes comprehensive documentation for each module:
 
-### AppObject
+- **[AppObject Architecture](src/AppObject/README.md)** - Component-based architecture pattern with entities, use cases, presentation managers, views, and controllers
+- **[DomainFactories](src/DomainFactories/README.md)** - Multi-phase initialization system for organizing domain components
+- **[Entities](src/Entities/README.md)** - Observable entities with memoized properties for automatic change detection
+- **[ValueObjects](src/ValueObjects/README.md)** - Immutable mathematical primitives for 3D graphics and geometry
+- **[Utilities](src/Utilities/README.md)** - Helper functions for animations, colors, conversions, and file operations
+- **[Types](src/Types/README.md)** - TypeScript interfaces for adapters and application boundaries
+- **[ExampleFeature](src/ExampleFeature/README.md)** - Complete reference implementation demonstrating best practices
 
-- The central entity that acts as a container for components
-- Each AppObject has a unique ID and belongs to an AppObjectRepo
-- Components can be added, removed, and queried
-- AppObjects are observable entities, notifying observers when components change
+## Quick Start
 
-### AppObjectRepo
+### AppObject Architecture
 
-- Manages a collection of AppObjects 
-- Provides methods to find, create, and manage AppObjects
-- Handles singleton components across the application
-- Includes logging infrastructure for debugging
+The core architecture follows Clean Architecture dependency rules with a component-based design:
 
-### Component Types
+```typescript
+import { makeAppObjectRepo } from "@vived/core";
 
-The architecture implements a clean separation of concerns through specialized components:
+// Create the application repository
+const appObjects = makeAppObjectRepo();
 
-1. **Entity (AppObjectEntity)**
-   - Holds and manages application state
-   - Provides change notifications when state is modified
+// Create an AppObject
+const myObject = appObjects.getOrCreate("myObject");
 
-2. **Presentation Manager (AppObjectPM)**
-   - Manages view models for UI representation
-   - Transforms application state into UI-ready data
-   - Notifies views when view models change
+// Add components to it
+const entity = makeMyEntity(myObject);
+const useCase = makeMyUseCase(myObject);
+const presentationManager = makeMyPM(myObject);
+```
+
+**Key Components:**
+- **Entities** - Store and manage domain data with automatic change notifications
+- **Use Cases** - Implement business logic and operations
+- **Presentation Managers** - Transform entity data into view models for UI
+- **Controllers** - Provide simplified APIs for UI interactions
+- **Adapters** - Connect UI frameworks (React, Vue, etc.) to presentation managers
+
+### Domain Factories
+
+Organize features using domain factories with phased initialization:
+
+```typescript
+import { makeDomainFactoryRepo } from "@vived/core";
+
+// Create domain factory repository
+const domainFactoryRepo = makeDomainFactoryRepo(appObjects);
+
+// Create your feature factories
+new MyFeatureDomainFactory(appObjects.getOrCreate("MyFeature"));
+
+// Initialize all features in proper order
+domainFactoryRepo.setupDomain();
+```
+
+### Reactive Entities
+
+Build reactive data models with automatic change detection:
+
+```typescript
+import { MemoizedString, MemoizedNumber, ObservableEntity } from "@vived/core";
+
+class UserEntity extends ObservableEntity
+{
+	private nameProperty = new MemoizedString("", () => this.notify());
+	private ageProperty = new MemoizedNumber(0, () => this.notify());
+	
+	get name() { return this.nameProperty.val; }
+	set name(value: string) { this.nameProperty.val = value; }
+	
+	get age() { return this.ageProperty.val; }
+	set age(value: number) { this.ageProperty.val = value; }
+}
+
+// Changes automatically notify observers
+const user = new UserEntity();
+user.addObserver(() => console.log("User changed!"));
+user.name = "John"; // Triggers notification
+```
 
-3. **Use Case (AppObjectUC)**
-   - Implements business logic
-   - Coordinates between data layer and presentation
+### Value Objects for 3D Graphics
 
-4. **Controller (AppObjectController)**
-   - Handles external inputs (user actions, system events)
-   - Delegates to appropriate use cases
+Work with immutable mathematical primitives:
 
-5. **View (AppObjectView)**
-   - UI representation components
-   - Consumes view models and renders UI
+```typescript
+import { Vector3, Quaternion, Matrix, Color } from "@vived/core";
 
-## Example Implementation
+// Vector operations
+const position = new Vector3(10, 20, 30);
+const direction = Vector3.Forward();
+const sum = Vector3.Add(position, direction);
 
-The package includes a fully implemented `ExampleFeature` that demonstrates the App Object Component architecture. This example demonstrates how to structure your code following the recommended patterns:
+// Rotations with quaternions
+const rotation = Quaternion.FromYawPitchRoll(
+	Angle.FromDegrees(45),
+	Angle.FromDegrees(0),
+	Angle.FromDegrees(0)
+);
+
+// Transformation matrices
+const transform = Matrix.Translation(position);
+const rotationMatrix = Matrix.FromQuaternion(rotation);
+
+// Colors
+const red = Color.RGB(255, 0, 0);
+const transparent = Color.RGBA(0, 0, 0, 128);
+const named = Color.X11("CornflowerBlue");
+```
+
+### Animation Utilities
+
+Create smooth animations with easing functions:
+
+```typescript
+import { LerpNumber, quintInOut } from "@vived/core";
+
+const lerper = new LerpNumber();
+
+// Animate a value from 0 to 100 over 2 seconds
+await lerper.lerp({
+	start: 0,
+	end: 100,
+	durationMS: 2000,
+	ease: quintInOut,
+	update: (value) => {
+		element.style.opacity = value / 100;
+	},
+	onComplete: () => {
+		console.log("Animation complete!");
+	}
+});
+```
+
+### UI Integration with Adapters
+
+Connect your UI framework to the architecture:
+
+```typescript
+import { useEffect, useState } from "react";
+import { myFeatureAdapter } from "@vived/core";
+
+function MyComponent({ id, appObjects })
+{
+	const [viewModel, setViewModel] = useState(myFeatureAdapter.defaultVM);
+	
+	useEffect(() => {
+		// Subscribe to updates
+		myFeatureAdapter.subscribe(id, appObjects, setViewModel);
+		
+		// Cleanup on unmount
+		return () => {
+			myFeatureAdapter.unsubscribe(id, appObjects, setViewModel);
+		};
+	}, [id]);
+	
+	return <div>{viewModel.someProperty}</div>;
+}
+```
 
-### Directory Structure
-- **Entities/** - Domain models for storing and managing state
-- **PMs/** - Presentation Managers that transform data for UI consumption
-- **UCs/** - Use Cases that implement business logic operations
-- **Controllers/** - Simplified API for UI interaction
-- **Adapters/** - Connect UI frameworks to PMs
-- **Mocks/** - Test doubles for unit testing
-- **Factory/** - Factories for creating the features at runtime
+## Package Contents
 
-Refer to the `ExampleFeature` directory for a complete implementation example that shows the interaction between all component types.
+### Architecture Components
 
-## Value Objects
+- **AppObject System** - Component container pattern with dependency injection
+- **Entity System** - Observable entities with memoized properties
+- **Repository Pattern** - Manage collections of entities
+- **Use Cases** - Business logic layer
+- **Presentation Managers** - View model transformation layer
+- **Controllers** - Simplified UI interaction APIs
+- **Adapters** - Framework-agnostic UI integration
 
-The package provides immutable value objects for mathematical and graphical operations:
+### Value Objects
 
-### Geometric & Mathematical Types
-- **Vector2**: 2D vector with operations like addition, dot product, rotation, and unit vector calculation
-- **Vector3**: 3D vector with similar operations plus cross product and coordinate transformations
-- **Quaternion**: For 3D rotations with methods for creation from angles, Euler angles, and matrices plus interpolation
-- **Matrix**: For transformation operations like translation, rotation, and scaling
-- **Angle**: Encapsulates angle values with automatic conversion between degrees and radians
-- **Rectangle**: For 2D rectangular regions with intersection testing
+**Vectors & Geometry:**
+- Vector2, Vector3 - 2D and 3D vectors with full operations
+- Quaternion - 3D rotation representation
+- Matrix - 4x4 transformation matrices
+- Angle - Type-safe angle conversions
+- Rectangle - 2D rectangular bounds
+- LineSegment2D - 2D line segment operations
+- ParametricLine - 3D parametric line representation
+- ParametricPlane - 3D plane representation
 
-### Parametric Geometry
-- **ParametricLine**: Represents lines with point and direction for intersection calculations
-- **ParametricPlane**: Represents planes with point and normal for 3D geometric operations
-- **LineSegment2D**: Represents finite line segments with intersection testing
+**Graphics:**
+- Color - RGBA color with hex and X11 color support
 
-### Graphics & Utilities
-- **Color**: RGBA color representation with utility methods for conversion between formats (RGB, Hex, X11 names)
-- **Version**: Semantic versioning implementation with comparison operators
+**Versioning:**
+- Version - Semantic version parsing and comparison
 
-## Utilities
+### Utilities
 
-The package also includes various utility functions:
-- Color manipulation (adding alpha to hex, converting alpha to hex)
-- Length converters for different measurement systems
-- Linear interpolation and easing functions
-- Angle conversion between degrees and radians
-- File operations like downloading
+**Animation:**
+- LerpNumber - Smooth numeric interpolation
+- Easing functions - 20+ easing functions (quad, cubic, quart, quint, sin, expo, circ)
+- interpolateNumber - Basic numeric interpolation
+
+**Color:**
+- addAlphaToHex - Add transparency to hex colors
+- alphaToHex - Convert alpha values to hex
+
+**Conversion:**
+- degreesToRadians - Angle conversion
+- Length converters - Inches/feet to meters and vice versa
+
+**File Operations:**
+- downloadFile - Trigger browser downloads
+- generateUniqueID - UUID v4 generation
+
+### Types
+
+- PmAdapter - Interface for connecting UI to presentation managers
+- SingletonPmAdapter - Interface for singleton presentation managers
+- EaseFn - Type definition for easing functions
+- AppBoundary - Application embedding interfaces
+
+## Architecture Principles
+
+### Clean Architecture
+
+The library enforces dependency rules where inner layers never depend on outer layers:
+
+```
+UI Layer
+    ↓
+Adapters & Controllers
+    ↓
+Presentation Managers
+    ↓
+Use Cases
+    ↓
+Entities
+```
+
+### Component-Based Design
+
+Everything is a component attached to an AppObject:
+- Promotes composition over inheritance
+- Enables dependency injection
+- Facilitates testing with mock components
+- Supports both instance and singleton patterns
+
+### Reactive by Default
+
+Entities notify observers when they change:
+- Automatic UI updates
+- No manual refresh logic needed
+- Performance optimized with memoization
+
+### Immutable Value Objects
+
+Mathematical primitives are immutable:
+- Thread-safe operations
+- Predictable behavior
+- Easy to reason about
+- Optimal for 3D graphics pipelines
+
+## Example Feature
+
+See [ExampleFeature](src/ExampleFeature/README.md) for a complete, production-ready reference implementation showing:
+- Feature folder structure
+- Entity, Use Case, and PM implementation
+- Controller and Adapter patterns
+- React integration examples
+- Testing strategies
+- Factory-based initialization
+
+## Use Cases
+
+- **3D Graphics Applications** - WebGL, Three.js, Babylon.js applications
+- **VR/AR Experiences** - Interactive virtual environments
+- **Data Visualization** - Charts, graphs, and interactive dashboards
+- **Game Development** - Game engines and interactive experiences
+- **Educational Software** - Interactive learning applications
+- **Configuration Tools** - Complex application settings and preferences
+
+## TypeScript Support
+
+Fully typed with TypeScript definitions included. Supports both ESM and CommonJS:
+
+```json
+{
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  }
+}
+```
+
+## Contributing
+
+This is a foundational library for VIVED applications. For detailed architecture decisions and patterns, refer to the comprehensive documentation in each module's README.
 
 ## License
+
 ISC

package/dist/cjs/AppObject/AppObjectEntityRepo.js

@@ -165,6 +165,19 @@ class AppObjectEntityRepo extends AppObjectEntity_1.AppObjectEntity {
         this.getAll = () => {
             return Array.from(this.entityLookup.values());
         };
+        /**
+         * Gets an entity by ID, or creates it if it doesn't exist.
+         *
+         * @param {string} id - The ID of the entity to get or create
+         * @returns {T} The existing or newly created entity
+         */
+        this.getOrCreate = (id) => {
+            const existing = this.getById(id);
+            if (existing) {
+                return existing;
+            }
+            return this.create(id);
+        };
     }
     /**
      * Adds an entity to the repository.
@@ -195,7 +208,8 @@ class AppObjectEntityRepo extends AppObjectEntity_1.AppObjectEntity {
      */
     create(id) {
         const idToUse = id ?? (0, Utilities_1.generateUniqueID)();
-        const entity = this.entityFactory(idToUse);
+        const ao = this.appObjects.getOrCreate(idToUse);
+        const entity = this.entityFactory(ao);
         this.add(entity);
         return entity;
     }
@@ -209,7 +223,7 @@ class AppObjectEntityRepo extends AppObjectEntity_1.AppObjectEntity {
      * @returns {T} A new entity instance
      * @throws {Error} If not overridden in derived class
      */
-    entityFactory(id) {
+    entityFactory(appObject) {
         // Override this method in derived classes to provide entity creation logic
         throw new Error("Entity factory not implemented.");
     }

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

@@ -1 +1 @@
-{"version":3,"file":"AppObjectEntityRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectEntityRepo.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObserverList } from \"../Entities\";\r\nimport { generateUniqueID } from \"../Utilities\";\r\nimport { AppObjectEntity } from \"./AppObjectEntity\";\r\n\r\n/**\r\n * A repository for managing collections of AppObjectEntity instances.\r\n *\r\n * This generic class provides a centralized way to store, retrieve, and manage\r\n * entities that are associated with specific AppObjects. It implements the observer\r\n * pattern to notify listeners when entities are added or removed.\r\n *\r\n * Derived classes should override the `entityFactory` method to provide custom\r\n * entity creation logic for the `create` method.\r\n *\r\n * @template T - The type of entities managed by this repository, must extend AppObjectEntity\r\n * @extends AppObjectEntity\r\n *\r\n * @example\r\n * ```typescript\r\n * // Create a custom repository with entity factory\r\n * class PlayerRepo extends AppObjectEntityRepo<PlayerEntity> {\r\n *   entityFactory(id: string): PlayerEntity {\r\n *     const appObject = makeAppObject(id, this.appObjects);\r\n *     return new PlayerEntity(appObject);\r\n *   }\r\n * }\r\n *\r\n * const playerRepo = new PlayerRepo(repoAppObject);\r\n *\r\n * // Create a new player with auto-generated ID\r\n * const player = playerRepo.create();\r\n *\r\n * // Create a new player with specific ID\r\n * const specificPlayer = playerRepo.create(\"player1\");\r\n *\r\n * // Get a player by its ID\r\n * const retrievedPlayer = playerRepo.getById(\"player1\");\r\n * ```\r\n */\r\nexport class AppObjectEntityRepo<\r\n  T extends AppObjectEntity,\r\n> extends AppObjectEntity {\r\n  private entityLookup = new Map<string, T>();\r\n\r\n  private onEntityAddedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is added to the repository.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to invoke when an entity is added\r\n   */\r\n  addEntityAddedObserver = (observer: (addedEntity: T) => void) => {\r\n    this.onEntityAddedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity addition notifications.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityAddedObserver = (observer: (addedEntity: T) => void): void => {\r\n    this.onEntityAddedObservers.remove(observer);\r\n  };\r\n\r\n  private onEntityRemovedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is removed from the repository.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to invoke when an entity is removed\r\n   */\r\n  addEntityRemovedObserver = (observer: (removedEntity: T) => void) => {\r\n    this.onEntityRemovedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity removal notifications.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityRemovedObserver = (\r\n    observer: (removedEntity: T) => void\r\n  ): void => {\r\n    this.onEntityRemovedObservers.remove(observer);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given ID.\r\n   *\r\n   * @param {string} id - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given ID, false otherwise\r\n   */\r\n  has = (id: string): boolean => {\r\n    return this.entityLookup.has(id);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given AppObject ID, false otherwise\r\n   * @deprecated Use has instead\r\n   */\r\n  hasForAppObject = (appObjectID: string): boolean => {\r\n    return this.has(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Adds an entity to the repository.\r\n   *\r\n   * If an entity with the same AppObject ID already exists, it is replaced.\r\n   * Notifies all registered observers after the entity is added.\r\n   *\r\n   * @param {T} entity - The entity to add\r\n   */\r\n  add(entity: T) {\r\n    const existing = this.entityLookup.get(entity.appObject.id);\r\n    if (existing) {\r\n      existing.removeChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this.entityLookup.set(entity.appObject.id, entity);\r\n    entity.addChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityAddedObservers.notify(entity);\r\n  }\r\n\r\n  /**\r\n   * Creates a new entity with the specified or auto-generated ID and adds it to the repository.\r\n   *\r\n   * This method uses the `entityFactory` method to create the entity instance.\r\n   * If no ID is provided, a unique ID is generated automatically.\r\n   *\r\n   * @param {string} [id] - Optional ID for the entity. If not provided, a unique ID is generated.\r\n   * @returns {T} The newly created entity\r\n   */\r\n  create(id?: string): T {\r\n    const idToUse = id ?? generateUniqueID();\r\n    const entity = this.entityFactory(idToUse);\r\n    this.add(entity);\r\n    return entity;\r\n  }\r\n\r\n  /**\r\n   * Factory method for creating entity instances.\r\n   *\r\n   * This method must be overridden in derived classes to provide custom entity creation logic.\r\n   * It is called by the `create` method to instantiate new entities.\r\n   *\r\n   * @param {string} id - The ID to use for the new entity\r\n   * @returns {T} A new entity instance\r\n   * @throws {Error} If not overridden in derived class\r\n   */\r\n  entityFactory(id: string): T {\r\n    // Override this method in derived classes to provide entity creation logic\r\n    throw new Error(\"Entity factory not implemented.\");\r\n  }\r\n\r\n  /**\r\n   * Removes the entity associated with the specified ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   */\r\n  removeById = (id: string) => {\r\n    const existing = this.entityLookup.get(id);\r\n    if (!existing) return;\r\n\r\n    this.entityLookup.delete(id);\r\n    existing.removeChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityRemovedObservers.notify(existing);\r\n  };\r\n\r\n  /**\r\n   * Removes the entity associated with the specified AppObject ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   * @deprecated Use removeById instead\r\n   */\r\n  removeForAppObject = (id: string) => {\r\n    this.removeById(id);\r\n  };\r\n\r\n  /**\r\n   * Removes all entities from the repository.\r\n   *\r\n   * Unsubscribes from all entity change observers and notifies all registered\r\n   * removal observers for each entity before clearing the repository.\r\n   */\r\n  deleteAll = () => {\r\n    const entities = Array.from(this.entityLookup.values());\r\n\r\n    entities.forEach((entity) => {\r\n      entity.removeChangeObserver(this.notifyOnChange);\r\n      this.onEntityRemovedObservers.notify(entity);\r\n    });\r\n\r\n    this.entityLookup.clear();\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified ID.\r\n   *\r\n   * @param {string} id - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   */\r\n  getById = (id: string): T | undefined => {\r\n    return this.entityLookup.get(id);\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   * @deprecated Use getById instead\r\n   */\r\n  getForAppObject = (appObjectID: string): T | undefined => {\r\n    return this.getById(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Gets all entities in the repository.\r\n   *\r\n   * @returns {T[]} An array of all entities\r\n   */\r\n  getAll = (): T[] => {\r\n    return Array.from(this.entityLookup.values());\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"AppObjectEntityRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectEntityRepo.ts"],"names":[],"mappings":";;;AAAA,0CAA2C;AAC3C,4CAAgD;AAEhD,uDAAoD;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAa,mBAEX,SAAQ,iCAAe;IAFzB;;QAGU,iBAAY,GAAG,IAAI,GAAG,EAAa,CAAC;QAEpC,2BAAsB,GAAG,IAAI,uBAAY,EAAK,CAAC;QACvD;;;;WAIG;QACH,2BAAsB,GAAG,CAAC,QAAkC,EAAE,EAAE;YAC9D,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF;;;;WAIG;QACH,8BAAyB,GAAG,CAAC,QAAkC,EAAQ,EAAE;YACvE,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC,CAAC;QAEM,6BAAwB,GAAG,IAAI,uBAAY,EAAK,CAAC;QACzD;;;;WAIG;QACH,6BAAwB,GAAG,CAAC,QAAoC,EAAE,EAAE;YAClE,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC;QAEF;;;;WAIG;QACH,gCAA2B,GAAG,CAC5B,QAAoC,EAC9B,EAAE;YACR,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF;;;;;WAKG;QACH,QAAG,GAAG,CAAC,EAAU,EAAW,EAAE;YAC5B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC;QAEF;;;;;;WAMG;QACH,oBAAe,GAAG,CAAC,WAAmB,EAAW,EAAE;YACjD,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC;QAsDF;;;;;;WAMG;QACH,eAAU,GAAG,CAAC,EAAU,EAAE,EAAE;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAEtB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7B,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF;;;;;;;WAOG;QACH,uBAAkB,GAAG,CAAC,EAAU,EAAE,EAAE;YAClC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC,CAAC;QAEF;;;;;WAKG;QACH,cAAS,GAAG,GAAG,EAAE;YACf,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;YAExD,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC1B,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACjD,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF;;;;;WAKG;QACH,YAAO,GAAG,CAAC,EAAU,EAAiB,EAAE;YACtC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC;QAEF;;;;;;WAMG;QACH,oBAAe,GAAG,CAAC,WAAmB,EAAiB,EAAE;YACvD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC,CAAC;QAEF;;;;WAIG;QACH,WAAM,GAAG,GAAQ,EAAE;YACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC;QAEF;;;;;WAKG;QACH,gBAAW,GAAG,CAAC,EAAU,EAAK,EAAE;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC;IACJ,CAAC;IA9IC;;;;;;;OAOG;IACH,GAAG,CAAC,MAAS;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAW;QAChB,MAAM,OAAO,GAAG,EAAE,IAAI,IAAA,4BAAgB,GAAE,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CAAC,SAAoB;QAChC,2EAA2E;QAC3E,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;CA4FF;AAhND,kDAgNC","sourcesContent":["import { ObserverList } from \"../Entities\";\r\nimport { generateUniqueID } from \"../Utilities\";\r\nimport { AppObject } from \"./AppObject\";\r\nimport { AppObjectEntity } from \"./AppObjectEntity\";\r\n\r\n/**\r\n * A repository for managing collections of AppObjectEntity instances.\r\n *\r\n * This generic class provides a centralized way to store, retrieve, and manage\r\n * entities that are associated with specific AppObjects. It implements the observer\r\n * pattern to notify listeners when entities are added or removed.\r\n *\r\n * Derived classes should override the `entityFactory` method to provide custom\r\n * entity creation logic for the `create` method.\r\n *\r\n * @template T - The type of entities managed by this repository, must extend AppObjectEntity\r\n * @extends AppObjectEntity\r\n *\r\n * @example\r\n * ```typescript\r\n * // Create a custom repository with entity factory\r\n * class PlayerRepo extends AppObjectEntityRepo<PlayerEntity> {\r\n *   entityFactory(id: string): PlayerEntity {\r\n *     const appObject = makeAppObject(id, this.appObjects);\r\n *     return new PlayerEntity(appObject);\r\n *   }\r\n * }\r\n *\r\n * const playerRepo = new PlayerRepo(repoAppObject);\r\n *\r\n * // Create a new player with auto-generated ID\r\n * const player = playerRepo.create();\r\n *\r\n * // Create a new player with specific ID\r\n * const specificPlayer = playerRepo.create(\"player1\");\r\n *\r\n * // Get a player by its ID\r\n * const retrievedPlayer = playerRepo.getById(\"player1\");\r\n * ```\r\n */\r\nexport class AppObjectEntityRepo<\r\n  T extends AppObjectEntity,\r\n> extends AppObjectEntity {\r\n  private entityLookup = new Map<string, T>();\r\n\r\n  private onEntityAddedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is added to the repository.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to invoke when an entity is added\r\n   */\r\n  addEntityAddedObserver = (observer: (addedEntity: T) => void) => {\r\n    this.onEntityAddedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity addition notifications.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityAddedObserver = (observer: (addedEntity: T) => void): void => {\r\n    this.onEntityAddedObservers.remove(observer);\r\n  };\r\n\r\n  private onEntityRemovedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is removed from the repository.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to invoke when an entity is removed\r\n   */\r\n  addEntityRemovedObserver = (observer: (removedEntity: T) => void) => {\r\n    this.onEntityRemovedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity removal notifications.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityRemovedObserver = (\r\n    observer: (removedEntity: T) => void\r\n  ): void => {\r\n    this.onEntityRemovedObservers.remove(observer);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given ID.\r\n   *\r\n   * @param {string} id - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given ID, false otherwise\r\n   */\r\n  has = (id: string): boolean => {\r\n    return this.entityLookup.has(id);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given AppObject ID, false otherwise\r\n   * @deprecated Use has instead\r\n   */\r\n  hasForAppObject = (appObjectID: string): boolean => {\r\n    return this.has(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Adds an entity to the repository.\r\n   *\r\n   * If an entity with the same AppObject ID already exists, it is replaced.\r\n   * Notifies all registered observers after the entity is added.\r\n   *\r\n   * @param {T} entity - The entity to add\r\n   */\r\n  add(entity: T) {\r\n    const existing = this.entityLookup.get(entity.appObject.id);\r\n    if (existing) {\r\n      existing.removeChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this.entityLookup.set(entity.appObject.id, entity);\r\n    entity.addChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityAddedObservers.notify(entity);\r\n  }\r\n\r\n  /**\r\n   * Creates a new entity with the specified or auto-generated ID and adds it to the repository.\r\n   *\r\n   * This method uses the `entityFactory` method to create the entity instance.\r\n   * If no ID is provided, a unique ID is generated automatically.\r\n   *\r\n   * @param {string} [id] - Optional ID for the entity. If not provided, a unique ID is generated.\r\n   * @returns {T} The newly created entity\r\n   */\r\n  create(id?: string): T {\r\n    const idToUse = id ?? generateUniqueID();\r\n    const ao = this.appObjects.getOrCreate(idToUse);\r\n    const entity = this.entityFactory(ao);\r\n    this.add(entity);\r\n    return entity;\r\n  }\r\n\r\n  /**\r\n   * Factory method for creating entity instances.\r\n   *\r\n   * This method must be overridden in derived classes to provide custom entity creation logic.\r\n   * It is called by the `create` method to instantiate new entities.\r\n   *\r\n   * @param {string} id - The ID to use for the new entity\r\n   * @returns {T} A new entity instance\r\n   * @throws {Error} If not overridden in derived class\r\n   */\r\n  entityFactory(appObject: AppObject): T {\r\n    // Override this method in derived classes to provide entity creation logic\r\n    throw new Error(\"Entity factory not implemented.\");\r\n  }\r\n\r\n  /**\r\n   * Removes the entity associated with the specified ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   */\r\n  removeById = (id: string) => {\r\n    const existing = this.entityLookup.get(id);\r\n    if (!existing) return;\r\n\r\n    this.entityLookup.delete(id);\r\n    existing.removeChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityRemovedObservers.notify(existing);\r\n  };\r\n\r\n  /**\r\n   * Removes the entity associated with the specified AppObject ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   * @deprecated Use removeById instead\r\n   */\r\n  removeForAppObject = (id: string) => {\r\n    this.removeById(id);\r\n  };\r\n\r\n  /**\r\n   * Removes all entities from the repository.\r\n   *\r\n   * Unsubscribes from all entity change observers and notifies all registered\r\n   * removal observers for each entity before clearing the repository.\r\n   */\r\n  deleteAll = () => {\r\n    const entities = Array.from(this.entityLookup.values());\r\n\r\n    entities.forEach((entity) => {\r\n      entity.removeChangeObserver(this.notifyOnChange);\r\n      this.onEntityRemovedObservers.notify(entity);\r\n    });\r\n\r\n    this.entityLookup.clear();\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified ID.\r\n   *\r\n   * @param {string} id - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   */\r\n  getById = (id: string): T | undefined => {\r\n    return this.entityLookup.get(id);\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   * @deprecated Use getById instead\r\n   */\r\n  getForAppObject = (appObjectID: string): T | undefined => {\r\n    return this.getById(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Gets all entities in the repository.\r\n   *\r\n   * @returns {T[]} An array of all entities\r\n   */\r\n  getAll = (): T[] => {\r\n    return Array.from(this.entityLookup.values());\r\n  };\r\n\r\n  /**\r\n   * Gets an entity by ID, or creates it if it doesn't exist.\r\n   *\r\n   * @param {string} id - The ID of the entity to get or create\r\n   * @returns {T} The existing or newly created entity\r\n   */\r\n  getOrCreate = (id: string): T => {\r\n    const existing = this.getById(id);\r\n    if (existing) {\r\n      return existing;\r\n    }\r\n    return this.create(id);\r\n  };\r\n}\r\n"]}

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

@@ -77,12 +77,11 @@ function makeExampleRepo(appObject) {
 class ExampleRepoImp extends ExampleRepo {
     /**
      * Factory implementation for creating ExampleEntity instances
-     * @param id The ID for the entity's AppObject
+     * @param appObject The AppObject for the entity
      * @returns A newly created ExampleEntity
      */
-    entityFactory(id) {
-        const ao = this.appObjects.getOrCreate(id);
-        return (0, ExampleEntity_1.makeExampleEntity)(ao);
+    entityFactory(appObject) {
+        return (0, ExampleEntity_1.makeExampleEntity)(appObject);
     }
     /**
      * Deletes an ExampleEntity from the repository by its AppObject ID

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

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

package/dist/cjs/ExampleFeature/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Controllers
+__exportStar(require("./Controllers/setExampleText"), exports);
+__exportStar(require("./Controllers/toggleExampleBoolean"), exports);
+// Adapters
+__exportStar(require("./Adapters/examplePmAdapter"), exports);
+__exportStar(require("./Adapters/exampleSingletonPmAdapter"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ExampleFeature/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,cAAc;AACd,+DAA6C;AAC7C,qEAAmD;AAEnD,WAAW;AACX,8DAA4C;AAC5C,uEAAqD","sourcesContent":["// Controllers\r\nexport * from \"./Controllers/setExampleText\";\r\nexport * from \"./Controllers/toggleExampleBoolean\";\r\n\r\n// Adapters\r\nexport * from \"./Adapters/examplePmAdapter\";\r\nexport * from \"./Adapters/exampleSingletonPmAdapter\";\r\n"]}

package/dist/esm/AppObject/AppObjectEntityRepo.js

@@ -162,6 +162,19 @@ export class AppObjectEntityRepo extends AppObjectEntity {
         this.getAll = () => {
             return Array.from(this.entityLookup.values());
         };
+        /**
+         * Gets an entity by ID, or creates it if it doesn't exist.
+         *
+         * @param {string} id - The ID of the entity to get or create
+         * @returns {T} The existing or newly created entity
+         */
+        this.getOrCreate = (id) => {
+            const existing = this.getById(id);
+            if (existing) {
+                return existing;
+            }
+            return this.create(id);
+        };
     }
     /**
      * Adds an entity to the repository.
@@ -192,7 +205,8 @@ export class AppObjectEntityRepo extends AppObjectEntity {
      */
     create(id) {
         const idToUse = id ?? generateUniqueID();
-        const entity = this.entityFactory(idToUse);
+        const ao = this.appObjects.getOrCreate(idToUse);
+        const entity = this.entityFactory(ao);
         this.add(entity);
         return entity;
     }
@@ -206,7 +220,7 @@ export class AppObjectEntityRepo extends AppObjectEntity {
      * @returns {T} A new entity instance
      * @throws {Error} If not overridden in derived class
      */
-    entityFactory(id) {
+    entityFactory(appObject) {
         // Override this method in derived classes to provide entity creation logic
         throw new Error("Entity factory not implemented.");
     }

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

@@ -1 +1 @@
-{"version":3,"file":"AppObjectEntityRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectEntityRepo.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObserverList } from \"../Entities\";\r\nimport { generateUniqueID } from \"../Utilities\";\r\nimport { AppObjectEntity } from \"./AppObjectEntity\";\r\n\r\n/**\r\n * A repository for managing collections of AppObjectEntity instances.\r\n *\r\n * This generic class provides a centralized way to store, retrieve, and manage\r\n * entities that are associated with specific AppObjects. It implements the observer\r\n * pattern to notify listeners when entities are added or removed.\r\n *\r\n * Derived classes should override the `entityFactory` method to provide custom\r\n * entity creation logic for the `create` method.\r\n *\r\n * @template T - The type of entities managed by this repository, must extend AppObjectEntity\r\n * @extends AppObjectEntity\r\n *\r\n * @example\r\n * ```typescript\r\n * // Create a custom repository with entity factory\r\n * class PlayerRepo extends AppObjectEntityRepo<PlayerEntity> {\r\n *   entityFactory(id: string): PlayerEntity {\r\n *     const appObject = makeAppObject(id, this.appObjects);\r\n *     return new PlayerEntity(appObject);\r\n *   }\r\n * }\r\n *\r\n * const playerRepo = new PlayerRepo(repoAppObject);\r\n *\r\n * // Create a new player with auto-generated ID\r\n * const player = playerRepo.create();\r\n *\r\n * // Create a new player with specific ID\r\n * const specificPlayer = playerRepo.create(\"player1\");\r\n *\r\n * // Get a player by its ID\r\n * const retrievedPlayer = playerRepo.getById(\"player1\");\r\n * ```\r\n */\r\nexport class AppObjectEntityRepo<\r\n  T extends AppObjectEntity,\r\n> extends AppObjectEntity {\r\n  private entityLookup = new Map<string, T>();\r\n\r\n  private onEntityAddedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is added to the repository.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to invoke when an entity is added\r\n   */\r\n  addEntityAddedObserver = (observer: (addedEntity: T) => void) => {\r\n    this.onEntityAddedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity addition notifications.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityAddedObserver = (observer: (addedEntity: T) => void): void => {\r\n    this.onEntityAddedObservers.remove(observer);\r\n  };\r\n\r\n  private onEntityRemovedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is removed from the repository.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to invoke when an entity is removed\r\n   */\r\n  addEntityRemovedObserver = (observer: (removedEntity: T) => void) => {\r\n    this.onEntityRemovedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity removal notifications.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityRemovedObserver = (\r\n    observer: (removedEntity: T) => void\r\n  ): void => {\r\n    this.onEntityRemovedObservers.remove(observer);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given ID.\r\n   *\r\n   * @param {string} id - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given ID, false otherwise\r\n   */\r\n  has = (id: string): boolean => {\r\n    return this.entityLookup.has(id);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given AppObject ID, false otherwise\r\n   * @deprecated Use has instead\r\n   */\r\n  hasForAppObject = (appObjectID: string): boolean => {\r\n    return this.has(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Adds an entity to the repository.\r\n   *\r\n   * If an entity with the same AppObject ID already exists, it is replaced.\r\n   * Notifies all registered observers after the entity is added.\r\n   *\r\n   * @param {T} entity - The entity to add\r\n   */\r\n  add(entity: T) {\r\n    const existing = this.entityLookup.get(entity.appObject.id);\r\n    if (existing) {\r\n      existing.removeChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this.entityLookup.set(entity.appObject.id, entity);\r\n    entity.addChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityAddedObservers.notify(entity);\r\n  }\r\n\r\n  /**\r\n   * Creates a new entity with the specified or auto-generated ID and adds it to the repository.\r\n   *\r\n   * This method uses the `entityFactory` method to create the entity instance.\r\n   * If no ID is provided, a unique ID is generated automatically.\r\n   *\r\n   * @param {string} [id] - Optional ID for the entity. If not provided, a unique ID is generated.\r\n   * @returns {T} The newly created entity\r\n   */\r\n  create(id?: string): T {\r\n    const idToUse = id ?? generateUniqueID();\r\n    const entity = this.entityFactory(idToUse);\r\n    this.add(entity);\r\n    return entity;\r\n  }\r\n\r\n  /**\r\n   * Factory method for creating entity instances.\r\n   *\r\n   * This method must be overridden in derived classes to provide custom entity creation logic.\r\n   * It is called by the `create` method to instantiate new entities.\r\n   *\r\n   * @param {string} id - The ID to use for the new entity\r\n   * @returns {T} A new entity instance\r\n   * @throws {Error} If not overridden in derived class\r\n   */\r\n  entityFactory(id: string): T {\r\n    // Override this method in derived classes to provide entity creation logic\r\n    throw new Error(\"Entity factory not implemented.\");\r\n  }\r\n\r\n  /**\r\n   * Removes the entity associated with the specified ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   */\r\n  removeById = (id: string) => {\r\n    const existing = this.entityLookup.get(id);\r\n    if (!existing) return;\r\n\r\n    this.entityLookup.delete(id);\r\n    existing.removeChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityRemovedObservers.notify(existing);\r\n  };\r\n\r\n  /**\r\n   * Removes the entity associated with the specified AppObject ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   * @deprecated Use removeById instead\r\n   */\r\n  removeForAppObject = (id: string) => {\r\n    this.removeById(id);\r\n  };\r\n\r\n  /**\r\n   * Removes all entities from the repository.\r\n   *\r\n   * Unsubscribes from all entity change observers and notifies all registered\r\n   * removal observers for each entity before clearing the repository.\r\n   */\r\n  deleteAll = () => {\r\n    const entities = Array.from(this.entityLookup.values());\r\n\r\n    entities.forEach((entity) => {\r\n      entity.removeChangeObserver(this.notifyOnChange);\r\n      this.onEntityRemovedObservers.notify(entity);\r\n    });\r\n\r\n    this.entityLookup.clear();\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified ID.\r\n   *\r\n   * @param {string} id - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   */\r\n  getById = (id: string): T | undefined => {\r\n    return this.entityLookup.get(id);\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   * @deprecated Use getById instead\r\n   */\r\n  getForAppObject = (appObjectID: string): T | undefined => {\r\n    return this.getById(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Gets all entities in the repository.\r\n   *\r\n   * @returns {T[]} An array of all entities\r\n   */\r\n  getAll = (): T[] => {\r\n    return Array.from(this.entityLookup.values());\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"AppObjectEntityRepo.js","sourceRoot":"","sources":["../../../src/AppObject/AppObjectEntityRepo.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObserverList } from \"../Entities\";\r\nimport { generateUniqueID } from \"../Utilities\";\r\nimport { AppObject } from \"./AppObject\";\r\nimport { AppObjectEntity } from \"./AppObjectEntity\";\r\n\r\n/**\r\n * A repository for managing collections of AppObjectEntity instances.\r\n *\r\n * This generic class provides a centralized way to store, retrieve, and manage\r\n * entities that are associated with specific AppObjects. It implements the observer\r\n * pattern to notify listeners when entities are added or removed.\r\n *\r\n * Derived classes should override the `entityFactory` method to provide custom\r\n * entity creation logic for the `create` method.\r\n *\r\n * @template T - The type of entities managed by this repository, must extend AppObjectEntity\r\n * @extends AppObjectEntity\r\n *\r\n * @example\r\n * ```typescript\r\n * // Create a custom repository with entity factory\r\n * class PlayerRepo extends AppObjectEntityRepo<PlayerEntity> {\r\n *   entityFactory(id: string): PlayerEntity {\r\n *     const appObject = makeAppObject(id, this.appObjects);\r\n *     return new PlayerEntity(appObject);\r\n *   }\r\n * }\r\n *\r\n * const playerRepo = new PlayerRepo(repoAppObject);\r\n *\r\n * // Create a new player with auto-generated ID\r\n * const player = playerRepo.create();\r\n *\r\n * // Create a new player with specific ID\r\n * const specificPlayer = playerRepo.create(\"player1\");\r\n *\r\n * // Get a player by its ID\r\n * const retrievedPlayer = playerRepo.getById(\"player1\");\r\n * ```\r\n */\r\nexport class AppObjectEntityRepo<\r\n  T extends AppObjectEntity,\r\n> extends AppObjectEntity {\r\n  private entityLookup = new Map<string, T>();\r\n\r\n  private onEntityAddedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is added to the repository.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to invoke when an entity is added\r\n   */\r\n  addEntityAddedObserver = (observer: (addedEntity: T) => void) => {\r\n    this.onEntityAddedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity addition notifications.\r\n   *\r\n   * @param {(addedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityAddedObserver = (observer: (addedEntity: T) => void): void => {\r\n    this.onEntityAddedObservers.remove(observer);\r\n  };\r\n\r\n  private onEntityRemovedObservers = new ObserverList<T>();\r\n  /**\r\n   * Registers an observer to be notified when an entity is removed from the repository.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to invoke when an entity is removed\r\n   */\r\n  addEntityRemovedObserver = (observer: (removedEntity: T) => void) => {\r\n    this.onEntityRemovedObservers.add(observer);\r\n  };\r\n\r\n  /**\r\n   * Removes an observer previously registered for entity removal notifications.\r\n   *\r\n   * @param {(removedEntity: T) => void} observer - The callback function to remove\r\n   */\r\n  removeEntityRemovedObserver = (\r\n    observer: (removedEntity: T) => void\r\n  ): void => {\r\n    this.onEntityRemovedObservers.remove(observer);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given ID.\r\n   *\r\n   * @param {string} id - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given ID, false otherwise\r\n   */\r\n  has = (id: string): boolean => {\r\n    return this.entityLookup.has(id);\r\n  };\r\n\r\n  /**\r\n   * Checks if an entity exists for the given AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {boolean} True if an entity exists for the given AppObject ID, false otherwise\r\n   * @deprecated Use has instead\r\n   */\r\n  hasForAppObject = (appObjectID: string): boolean => {\r\n    return this.has(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Adds an entity to the repository.\r\n   *\r\n   * If an entity with the same AppObject ID already exists, it is replaced.\r\n   * Notifies all registered observers after the entity is added.\r\n   *\r\n   * @param {T} entity - The entity to add\r\n   */\r\n  add(entity: T) {\r\n    const existing = this.entityLookup.get(entity.appObject.id);\r\n    if (existing) {\r\n      existing.removeChangeObserver(this.notifyOnChange);\r\n    }\r\n\r\n    this.entityLookup.set(entity.appObject.id, entity);\r\n    entity.addChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityAddedObservers.notify(entity);\r\n  }\r\n\r\n  /**\r\n   * Creates a new entity with the specified or auto-generated ID and adds it to the repository.\r\n   *\r\n   * This method uses the `entityFactory` method to create the entity instance.\r\n   * If no ID is provided, a unique ID is generated automatically.\r\n   *\r\n   * @param {string} [id] - Optional ID for the entity. If not provided, a unique ID is generated.\r\n   * @returns {T} The newly created entity\r\n   */\r\n  create(id?: string): T {\r\n    const idToUse = id ?? generateUniqueID();\r\n    const ao = this.appObjects.getOrCreate(idToUse);\r\n    const entity = this.entityFactory(ao);\r\n    this.add(entity);\r\n    return entity;\r\n  }\r\n\r\n  /**\r\n   * Factory method for creating entity instances.\r\n   *\r\n   * This method must be overridden in derived classes to provide custom entity creation logic.\r\n   * It is called by the `create` method to instantiate new entities.\r\n   *\r\n   * @param {string} id - The ID to use for the new entity\r\n   * @returns {T} A new entity instance\r\n   * @throws {Error} If not overridden in derived class\r\n   */\r\n  entityFactory(appObject: AppObject): T {\r\n    // Override this method in derived classes to provide entity creation logic\r\n    throw new Error(\"Entity factory not implemented.\");\r\n  }\r\n\r\n  /**\r\n   * Removes the entity associated with the specified ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   */\r\n  removeById = (id: string) => {\r\n    const existing = this.entityLookup.get(id);\r\n    if (!existing) return;\r\n\r\n    this.entityLookup.delete(id);\r\n    existing.removeChangeObserver(this.notifyOnChange);\r\n    this.notifyOnChange();\r\n    this.onEntityRemovedObservers.notify(existing);\r\n  };\r\n\r\n  /**\r\n   * Removes the entity associated with the specified AppObject ID.\r\n   *\r\n   * Notifies all registered observers after the entity is removed.\r\n   *\r\n   * @param {string} id - The ID of the AppObject whose entity should be removed\r\n   * @deprecated Use removeById instead\r\n   */\r\n  removeForAppObject = (id: string) => {\r\n    this.removeById(id);\r\n  };\r\n\r\n  /**\r\n   * Removes all entities from the repository.\r\n   *\r\n   * Unsubscribes from all entity change observers and notifies all registered\r\n   * removal observers for each entity before clearing the repository.\r\n   */\r\n  deleteAll = () => {\r\n    const entities = Array.from(this.entityLookup.values());\r\n\r\n    entities.forEach((entity) => {\r\n      entity.removeChangeObserver(this.notifyOnChange);\r\n      this.onEntityRemovedObservers.notify(entity);\r\n    });\r\n\r\n    this.entityLookup.clear();\r\n    this.notifyOnChange();\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified ID.\r\n   *\r\n   * @param {string} id - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   */\r\n  getById = (id: string): T | undefined => {\r\n    return this.entityLookup.get(id);\r\n  };\r\n\r\n  /**\r\n   * Gets the entity associated with the specified AppObject ID.\r\n   *\r\n   * @param {string} appObjectID - The ID of the AppObject\r\n   * @returns {T | undefined} The entity if found, undefined otherwise\r\n   * @deprecated Use getById instead\r\n   */\r\n  getForAppObject = (appObjectID: string): T | undefined => {\r\n    return this.getById(appObjectID);\r\n  };\r\n\r\n  /**\r\n   * Gets all entities in the repository.\r\n   *\r\n   * @returns {T[]} An array of all entities\r\n   */\r\n  getAll = (): T[] => {\r\n    return Array.from(this.entityLookup.values());\r\n  };\r\n\r\n  /**\r\n   * Gets an entity by ID, or creates it if it doesn't exist.\r\n   *\r\n   * @param {string} id - The ID of the entity to get or create\r\n   * @returns {T} The existing or newly created entity\r\n   */\r\n  getOrCreate = (id: string): T => {\r\n    const existing = this.getById(id);\r\n    if (existing) {\r\n      return existing;\r\n    }\r\n    return this.create(id);\r\n  };\r\n}\r\n"]}