@vived/core 1.4.2 → 1.4.4

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

@@ -0,0 +1,92 @@
+/**
+ * ExamplePM.ts
+ *
+ * This file demonstrates how to implement a Presentation Manager (PM) component.
+ * PMs are responsible for transforming entity data into view models (VMs) for the UI.
+ * They observe entities for changes and update their views when data changes.
+ *
+ * Key concepts:
+ * - PMs extend AppObjectPM<VM> where VM is the view model type
+ * - They observe entities and transform entity data into view models
+ * - They notify UI components (views) when view models change
+ * - Each PM instance is associated with a specific AppObject
+ *
+ * Usage pattern:
+ * 1. Get a PM instance using getById
+ * 2. Register UI components as views using addView(callback)
+ * 3. PM will call the view callbacks with updated view models when entities change
+ * 4. Remove UI components with removeView(callback) when they're unmounted
+ */
+import { AppObjectPM } from "../../AppObject";
+import { ExampleEntity } from "../Entities/ExampleEntity";
+/**
+ * ExamplePM transforms ExampleEntity data into a simple string view model.
+ * Abstract class provides the interface and static helper methods.
+ */
+export class ExamplePM extends AppObjectPM {
+    /**
+     * Retrieves an ExamplePM by its parent AppObject's ID
+     * @param id The ID of the parent AppObject
+     * @param appObjects The AppObjectRepo to search in
+     * @returns The ExamplePM component or undefined if not found
+     */
+    static getById(id, appObjects) {
+        return appObjects.get(id)?.getComponent(ExamplePM.type);
+    }
+}
+/** Unique type identifier for this component */
+ExamplePM.type = "ExamplePMType";
+/**
+ * Factory function to create a new ExamplePM
+ * @param appObject The AppObject to attach the PM to
+ * @returns A new ExamplePM instance
+ */
+export function makeExamplePM(appObject) {
+    return new ExamplePMImp(appObject);
+}
+/**
+ * Concrete implementation of ExamplePM
+ * This private class handles the actual implementation details
+ */
+class ExamplePMImp extends ExamplePM {
+    /**
+     * Gets the ExampleEntity from the same AppObject
+     * Uses getCachedLocalComponent for efficient repeated access
+     */
+    get exampleEntity() {
+        return this.getCachedLocalComponent(ExampleEntity.type);
+    }
+    /**
+     * Compares two view models to determine if they're equal
+     * Used to avoid unnecessary view updates when values haven't changed
+     */
+    vmsAreEqual(a, b) {
+        return a === b;
+    }
+    constructor(appObject) {
+        super(appObject, ExamplePM.type);
+        /**
+         * Handler for entity change events
+         * Transforms entity data into a view model and updates views
+         */
+        this.onEntityChange = () => {
+            if (!this.exampleEntity)
+                return;
+            // 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);
+        // Call the change handler initially to set up the initial view model
+        this.onEntityChange();
+    }
+}
+//# sourceMappingURL=ExamplePM.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,97 @@
+/**
+ * ExampleSingletonPM.ts
+ *
+ * This file demonstrates how to implement a Singleton Presentation Manager (PM).
+ * Singleton PMs are special PMs that exist only once in the application and can be
+ * accessed globally. They transform data from singleton entities into view models.
+ *
+ * Key concepts:
+ * - Singleton PMs extend AppObjectPM<VM> like regular PMs
+ * - They register themselves as singletons with appObjects.registerSingleton()
+ * - They're accessed through a static get() method using getSingletonComponent()
+ * - They typically observe singleton entities and provide data to multiple UI components
+ *
+ * Usage pattern:
+ * 1. Access the singleton PM using the static get() method
+ * 2. Register UI components as views using addView(callback)
+ * 3. PM will call the view callbacks with updated view models when entities change
+ * 4. Remove UI components with removeView(callback) when they're unmounted
+ */
+import { AppObjectPM, } from "../../AppObject";
+import { getSingletonComponent } from "../../AppObject/getSingletonComponent";
+import { SingletonEntityExample } from "../Entities/ExampleSingletonEntity";
+/**
+ * ExampleSingletonPM transforms SingletonEntityExample data into an ExampleVM.
+ * As a singleton, only one instance exists in the application.
+ */
+export class ExampleSingletonPM extends AppObjectPM {
+}
+/** Unique type identifier for this component */
+ExampleSingletonPM.type = "ExampleSingletonPMType";
+/**
+ * Global accessor for the singleton PM
+ * @param appObjects The AppObjectRepo to search in
+ * @returns The singleton PM or undefined if not created yet
+ */
+ExampleSingletonPM.get = (appObjects) => getSingletonComponent(ExampleSingletonPM.type, appObjects);
+/**
+ * Default view model used when no data is available
+ * UI components can use this initially or when the PM is not found
+ */
+export const defaultSlideNavigationVM = {
+    aBoolProperty: true
+};
+/**
+ * Factory function to create a new ExampleSingletonPM
+ * @param appObject The AppObject to attach the PM to
+ * @returns A new ExampleSingletonPM instance
+ */
+export function makeExampleSingletonPM(appObject) {
+    return new ExampleSingletonPMImp(appObject);
+}
+/**
+ * Concrete implementation of ExampleSingletonPM
+ * This private class handles the actual implementation details
+ */
+class ExampleSingletonPMImp extends ExampleSingletonPM {
+    /**
+     * Gets the SingletonEntityExample from the application
+     * Uses getCachedSingleton for efficient repeated access
+     */
+    get exampleEntity() {
+        return this.getCachedSingleton(SingletonEntityExample.type);
+    }
+    /**
+     * Compares two view models to determine if they're equal
+     * Used to avoid unnecessary view updates when values haven't changed
+     */
+    vmsAreEqual(a, b) {
+        if (a.aBoolProperty !== b.aBoolProperty)
+            return false;
+        return true;
+    }
+    constructor(appObject) {
+        super(appObject, ExampleSingletonPM.type);
+        /**
+         * Handler for entity change events
+         * Transforms entity data into a view model and updates views
+         */
+        this.onEntityChange = () => {
+            if (!this.exampleEntity)
+                return;
+            // Extract the boolean property from the entity
+            const aBoolProperty = this.exampleEntity.aBoolProperty;
+            // Create a view model with the extracted data
+            const vm = { aBoolProperty };
+            // Update all registered views with the new view model
+            this.doUpdateView(vm);
+        };
+        // Register as an observer of the entity to receive change notifications
+        this.exampleEntity?.addChangeObserver(this.onEntityChange);
+        // Call the change handler initially to set up the initial view model
+        this.onEntityChange();
+        // Register this PM as a singleton so it can be accessed globally
+        this.appObjects.registerSingleton(this);
+    }
+}
+//# sourceMappingURL=ExampleSingletonPM.js.map

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

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

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

@@ -0,0 +1,3 @@
+export * from "./ExamplePM";
+export * from "./ExampleSingletonPM";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC","sourcesContent":["export * from \"./ExamplePM\";\r\nexport * from \"./ExampleSingletonPM\";\r\n"]}

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

@@ -0,0 +1,82 @@
+/**
+ * EditExampleStringUC.ts
+ *
+ * This file demonstrates how to implement a Use Case (UC) component.
+ * UCs handle business logic and operations that modify entities.
+ * They encapsulate specific actions that can be performed in the application.
+ *
+ * Key concepts:
+ * - UCs extend AppObjectUC and provide methods for specific operations
+ * - They implement business logic for modifying entities
+ * - They validate inputs and handle errors
+ * - Each UC instance is associated with a specific AppObject
+ *
+ * Usage pattern:
+ * 1. Get a UC instance using getById or get
+ * 2. Call the UC's methods to perform operations
+ * 3. The UC will update entities, which will trigger PM updates and UI refreshes
+ */
+import { AppObjectUC } from "../../AppObject";
+import { ExampleEntity } from "../Entities/ExampleEntity";
+/**
+ * EditExampleStringUC provides functionality to update the string property of an ExampleEntity.
+ * Abstract class provides the interface and static helper methods.
+ */
+export class EditExampleStringUC extends AppObjectUC {
+    /**
+     * Retrieves an EditExampleStringUC component from an AppObject
+     * @param appObj The AppObject to get the component from
+     * @returns The EditExampleStringUC component or undefined if not found
+     */
+    static get(appObj) {
+        return appObj.getComponent(this.type);
+    }
+    /**
+     * Retrieves an EditExampleStringUC by its parent AppObject's ID
+     * @param id The ID of the parent AppObject
+     * @param appObjects The AppObjectRepo to search in
+     * @returns The EditExampleStringUC component or undefined if not found
+     */
+    static getById(id, appObjects) {
+        return appObjects.get(id)?.getComponent(this.type);
+    }
+}
+/** Unique type identifier for this component */
+EditExampleStringUC.type = "EditExampleStringUCType";
+/**
+ * Factory function to create a new EditExampleStringUC
+ * @param appObject The AppObject to attach the UC to
+ * @returns A new EditExampleStringUC instance
+ */
+export function makeEditSlideTextUC(appObject) {
+    return new EditSlideTextUCImp(appObject);
+}
+/**
+ * Concrete implementation of EditExampleStringUC
+ * This private class handles the actual implementation details
+ */
+class EditSlideTextUCImp extends EditExampleStringUC {
+    /**
+     * Gets the ExampleEntity from the same AppObject
+     * Uses getCachedLocalComponent for efficient repeated access
+     */
+    get exampleEntity() {
+        return this.getCachedLocalComponent(ExampleEntity.type);
+    }
+    constructor(appObject) {
+        super(appObject, EditExampleStringUC.type);
+        /**
+         * Implements the editExampleString method to update the entity's string property
+         * @param text The new string value to set
+         */
+        this.editExampleString = (text) => {
+            if (!this.exampleEntity) {
+                this.warn("Unable to find AppState");
+                return;
+            }
+            // Update the entity property, which will trigger PM updates and UI refreshes
+            this.exampleEntity.aStringProperty = text;
+        };
+    }
+}
+//# sourceMappingURL=EditExampleStringUC.js.map

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * ToggleExampleBooleanUC.ts
+ *
+ * This file demonstrates how to implement a Singleton Use Case (UC) component.
+ * Singleton UCs are special UCs that exist only once in the application and can be
+ * accessed globally. They handle business logic and operations that modify singleton entities.
+ *
+ * Key concepts:
+ * - Singleton UCs extend AppObjectUC like regular UCs
+ * - They register themselves as singletons with appObjects.registerSingleton()
+ * - They're accessed through a static get() method using getSingletonComponent()
+ * - They typically operate on singleton entities
+ *
+ * Usage pattern:
+ * 1. Access the singleton UC using the static get() method
+ * 2. Call the UC's methods to perform operations
+ * 3. The UC will update entities, which will trigger PM updates and UI refreshes
+ */
+import { AppObjectUC } from "../../AppObject";
+import { getSingletonComponent } from "../../AppObject/getSingletonComponent";
+import { SingletonEntityExample } from "../Entities/ExampleSingletonEntity";
+/**
+ * ToggleExampleBooleanUC provides functionality to toggle the boolean property
+ * of the SingletonEntityExample. As a singleton, only one instance exists in the application.
+ */
+export class ToggleExampleBooleanUC extends AppObjectUC {
+}
+/** Unique type identifier for this component */
+ToggleExampleBooleanUC.type = "ToggleExampleBooleanUCType";
+/**
+ * Global accessor for the singleton UC
+ * @param appObjects The AppObjectRepo to search in
+ * @returns The singleton UC or undefined if not created yet
+ */
+ToggleExampleBooleanUC.get = (appObjects) => getSingletonComponent(ToggleExampleBooleanUC.type, appObjects);
+/**
+ * Factory function to create a new ToggleExampleBooleanUC
+ * @param appObject The AppObject to attach the UC to
+ * @returns A new ToggleExampleBooleanUC instance
+ */
+export function makeToggleExampleBooleanUC(appObject) {
+    return new ToggleExampleBooleanUCImp(appObject);
+}
+/**
+ * Concrete implementation of ToggleExampleBooleanUC
+ * This private class handles the actual implementation details
+ */
+class ToggleExampleBooleanUCImp extends ToggleExampleBooleanUC {
+    /**
+     * Gets the SingletonEntityExample from the application
+     * Uses getCachedSingleton for efficient repeated access
+     */
+    get singletonEntityExample() {
+        return this.getCachedSingleton(SingletonEntityExample.type);
+    }
+    constructor(appObject) {
+        super(appObject, ToggleExampleBooleanUC.type);
+        /**
+         * Implements the toggleExampleBoolean method to invert the entity's boolean property
+         */
+        this.toggleExampleBoolean = () => {
+            if (!this.singletonEntityExample) {
+                this.warn("Unable to find SingletonEntityExample");
+                return;
+            }
+            // Toggle the boolean property by inverting its current value
+            this.singletonEntityExample.aBoolProperty =
+                !this.singletonEntityExample?.aBoolProperty;
+        };
+        // Register this UC as a singleton so it can be accessed globally
+        this.appObjects.registerSingleton(this);
+    }
+}
+//# sourceMappingURL=ToggleExampleBooleanUC.js.map

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

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

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

@@ -0,0 +1,3 @@
+export * from "./EditExampleStringUC";
+export * from "./ToggleExampleBooleanUC";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ExampleFeature/UCs/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC","sourcesContent":["export * from \"./EditExampleStringUC\";\r\nexport * from \"./ToggleExampleBooleanUC\";\r\n"]}

package/dist/esm/ExampleFeature/index.js

@@ -0,0 +1,8 @@
+export * from "./Adapters";
+export * from "./Controllers";
+export * from "./Entities";
+export * from "./Factory";
+export * from "./Mocks";
+export * from "./PMs";
+export * from "./UCs";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ExampleFeature/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC","sourcesContent":["export * from \"./Adapters\";\r\nexport * from \"./Controllers\";\r\nexport * from \"./Entities\";\r\nexport * from \"./Factory\";\r\nexport * from \"./Mocks\";\r\nexport * from \"./PMs\";\r\nexport * from \"./UCs\";"]}

package/dist/esm/Types/PmAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"PmAdapter.js","sourceRoot":"","sources":["../../../src/Types/PmAdapter.ts"],"names":[],"mappings":"","sourcesContent":["import { AppObjectRepo } from \"../AppObject\";\r\n\r\nexport interface PmAdapter<VM> {\r\n  defaultVM: VM;\r\n  subscribe(\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: VM) => void\r\n  ): void;\r\n  unsubscribe(\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: VM) => void\r\n  ): void;\r\n}\r\n"]}
+{"version":3,"file":"PmAdapter.js","sourceRoot":"","sources":["../../../src/Types/PmAdapter.ts"],"names":[],"mappings":"","sourcesContent":["import { AppObjectRepo } from \"../AppObject\";\r\n\r\n/**\r\n * PmAdapter interface defines a bridge between UI components and AppObjectPM (Presentation Manager) components.\r\n * It allows UI frameworks (like React, Vue, Angular, etc.) to subscribe to view model updates from specific AppObjects.\r\n * \r\n * This adapter is used for AppObject-specific subscriptions, where each UI component subscribes to\r\n * a particular AppObject's presentation manager, identified by its ID.\r\n * \r\n * Usage example with React:\r\n * ```typescript\r\n * // Define an adapter for a specific view model type\r\n * class MyComponentAdapter implements PmAdapter<MyViewModel> {\r\n *   // Default view model when no data is available\r\n *   defaultVM: MyViewModel = { value: 0, label: \"\" };\r\n *   \r\n *   // Subscribe to updates from a specific AppObject's presentation manager\r\n *   subscribe(id: string, appObjects: AppObjectRepo, setVM: (vm: MyViewModel) => void): void {\r\n *     const appObject = appObjects.get(id);\r\n *     if (!appObject) return;\r\n *     \r\n *     const pm = appObject.getComponent<MyPM>(\"MyPresentationManager\");\r\n *     if (pm) {\r\n *       pm.addView(setVM);\r\n *       // Initial update with current view model if available\r\n *       if (pm.lastVM) setVM(pm.lastVM);\r\n *     }\r\n *   }\r\n *   \r\n *   // Unsubscribe when component unmounts\r\n *   unsubscribe(id: string, appObjects: AppObjectRepo, setVM: (vm: MyViewModel) => void): void {\r\n *     const appObject = appObjects.get(id);\r\n *     if (!appObject) return;\r\n *     \r\n *     const pm = appObject.getComponent<MyPM>(\"MyPresentationManager\");\r\n *     if (pm) {\r\n *       pm.removeView(setVM);\r\n *     }\r\n *   }\r\n * }\r\n * ```\r\n * \r\n * @typeparam VM The view model type provided by this adapter\r\n */\r\nexport interface PmAdapter<VM> {\r\n  /**\r\n   * Default view model to use when no data is available\r\n   * This prevents null/undefined handling in UI components\r\n   */\r\n  defaultVM: VM;\r\n  \r\n  /**\r\n   * Subscribe to view model updates from an AppObject's presentation manager\r\n   * \r\n   * @param id The ID of the AppObject to subscribe to\r\n   * @param appObjects The repository containing the AppObjects\r\n   * @param setVM Callback function that updates the UI with new view models\r\n   */\r\n  subscribe(\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: VM) => void\r\n  ): void;\r\n  \r\n  /**\r\n   * Unsubscribe from view model updates when a component is being unmounted or no longer needs updates\r\n   * \r\n   * @param id The ID of the AppObject to unsubscribe from\r\n   * @param appObjects The repository containing the AppObjects\r\n   * @param setVM The same callback function that was provided to subscribe\r\n   */\r\n  unsubscribe(\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: VM) => void\r\n  ): void;\r\n}\r\n"]}

package/dist/esm/Types/SingletonPmAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"SingletonPmAdapter.js","sourceRoot":"","sources":["../../../src/Types/SingletonPmAdapter.ts"],"names":[],"mappings":"","sourcesContent":["import { AppObjectRepo } from \"../AppObject\";\r\n\r\nexport interface SingletonPmAdapter<VM> {\r\n  defaultVM: VM;\r\n  subscribe(appObjects: AppObjectRepo, setVM: (vm: VM) => void): void;\r\n  unsubscribe(appObjects: AppObjectRepo, setVM: (vm: VM) => void): void;\r\n}\r\n"]}
+{"version":3,"file":"SingletonPmAdapter.js","sourceRoot":"","sources":["../../../src/Types/SingletonPmAdapter.ts"],"names":[],"mappings":"","sourcesContent":["import { AppObjectRepo } from \"../AppObject\";\r\n\r\n/**\r\n * SingletonPmAdapter interface defines a bridge between UI components and singleton presentation managers.\r\n * It's similar to PmAdapter but designed for components that subscribe to a singleton PM \r\n * (a PM that exists only once in the application).\r\n * \r\n * This adapter simplifies the subscription process when there's only one instance of a specific\r\n * presentation manager type in the entire application, eliminating the need to specify an AppObject ID.\r\n * \r\n * Usage example with React:\r\n * ```typescript\r\n * // Define an adapter for a singleton presentation manager\r\n * class GlobalSettingsPMAdapter implements SingletonPmAdapter<SettingsViewModel> {\r\n *   // Default view model when no data is available\r\n *   defaultVM: SettingsViewModel = { theme: \"light\", fontSize: \"medium\" };\r\n *   \r\n *   // Subscribe to updates from the singleton presentation manager\r\n *   subscribe(appObjects: AppObjectRepo, setVM: (vm: SettingsViewModel) => void): void {\r\n *     // Get the singleton PM\r\n *     const settingsPM = appObjects.getSingleton<SettingsPM>(\"SettingsPM\");\r\n *     if (settingsPM) {\r\n *       // Register the update callback\r\n *       settingsPM.addView(setVM);\r\n *       // Initial update with current view model if available\r\n *       if (settingsPM.lastVM) setVM(settingsPM.lastVM);\r\n *     }\r\n *   }\r\n *   \r\n *   // Unsubscribe when component unmounts\r\n *   unsubscribe(appObjects: AppObjectRepo, setVM: (vm: SettingsViewModel) => void): void {\r\n *     const settingsPM = appObjects.getSingleton<SettingsPM>(\"SettingsPM\");\r\n *     if (settingsPM) {\r\n *       settingsPM.removeView(setVM);\r\n *     }\r\n *   }\r\n * }\r\n * ```\r\n * \r\n * @typeparam VM The view model type provided by this adapter\r\n */\r\nexport interface SingletonPmAdapter<VM> {\r\n  /**\r\n   * Default view model to use when no data is available\r\n   * This prevents null/undefined handling in UI components\r\n   */\r\n  defaultVM: VM;\r\n  \r\n  /**\r\n   * Subscribe to view model updates from a singleton presentation manager\r\n   * \r\n   * @param appObjects The repository containing the AppObjects\r\n   * @param setVM Callback function that updates the UI with new view models\r\n   */\r\n  subscribe(appObjects: AppObjectRepo, setVM: (vm: VM) => void): void;\r\n  \r\n  /**\r\n   * Unsubscribe from view model updates when a component is being unmounted or no longer needs updates\r\n   * \r\n   * @param appObjects The repository containing the AppObjects\r\n   * @param setVM The same callback function that was provided to subscribe\r\n   */\r\n  unsubscribe(appObjects: AppObjectRepo, setVM: (vm: VM) => void): void;\r\n}\r\n"]}

package/dist/esm/ValueObjects/Angle.js

@@ -20,7 +20,7 @@ export class Angle {
      * @param a Angle A
      * @param b Angle B
      * @param tolerance Tolerance for "Close" in degrees. Defaults to 0.001;
-     * @returns True if the difference between A and B (in degress) is less than the tolerance
+     * @returns True if the difference between A and B (in degrees) is less than the tolerance
      */
     static Close(a, b, tolerance = 0.001) {
         let diff = a.degrees - b.degrees;

package/dist/esm/ValueObjects/Angle.js.map

@@ -1 +1 @@
-{"version":3,"file":"Angle.js","sourceRoot":"","sources":["../../../src/ValueObjects/Angle.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,KAAK;IAChB;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,OAAe;QACvC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,OAAe;QACvC,OAAO,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,CAAQ,EAAE,CAAQ,EAAE,YAAoB,KAAK;QAC/D,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QACjC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,IAAI,GAAG,CAAC,IAAI,CAAC;QACf,CAAC;QACD,OAAO,IAAI,GAAG,SAAS,CAAC;IAC1B,CAAC;IAGD,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACzC,CAAC;IAED,YAAoB,OAAe;QAT3B,aAAQ,GAAG,CAAC,CAAC;QAUnB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;CACF","sourcesContent":["export class Angle {\r\n  /**\r\n   * Creates an angle from degrees\r\n   * @param degrees Angle in degrees\r\n   * @returns The angle\r\n   */\r\n  public static FromDegrees(degrees: number): Angle {\r\n    return new Angle(degrees);\r\n  }\r\n\r\n  /**\r\n   * Creates an angle from radians\r\n   * @param radians Angle in radians\r\n   * @returns The angle\r\n   */\r\n  public static FromRadians(radians: number): Angle {\r\n    return new Angle((radians * 180) / Math.PI);\r\n  }\r\n\r\n  /**\r\n   * Check to see if two angles are close\r\n   * @param a Angle A\r\n   * @param b Angle B\r\n   * @param tolerance Tolerance for \"Close\" in degrees. Defaults to 0.001;\r\n   * @returns True if the difference between A and B (in degress) is less than the tolerance\r\n   */\r\n  public static Close(a: Angle, b: Angle, tolerance: number = 0.001): boolean {\r\n    let diff = a.degrees - b.degrees;\r\n    if (diff < 0) {\r\n      diff = -diff;\r\n    }\r\n    return diff < tolerance;\r\n  }\r\n\r\n  private _degrees = 0;\r\n  public get degrees() {\r\n    return this._degrees;\r\n  }\r\n\r\n  public get radians() {\r\n    return (this._degrees * Math.PI) / 180;\r\n  }\r\n\r\n  private constructor(degrees: number) {\r\n    this._degrees = degrees;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Angle.js","sourceRoot":"","sources":["../../../src/ValueObjects/Angle.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,KAAK;IAChB;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,OAAe;QACvC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,OAAe;QACvC,OAAO,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,CAAQ,EAAE,CAAQ,EAAE,YAAoB,KAAK;QAC/D,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QACjC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,IAAI,GAAG,CAAC,IAAI,CAAC;QACf,CAAC;QACD,OAAO,IAAI,GAAG,SAAS,CAAC;IAC1B,CAAC;IAGD,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACzC,CAAC;IAED,YAAoB,OAAe;QAT3B,aAAQ,GAAG,CAAC,CAAC;QAUnB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;CACF","sourcesContent":["export class Angle {\r\n  /**\r\n   * Creates an angle from degrees\r\n   * @param degrees Angle in degrees\r\n   * @returns The angle\r\n   */\r\n  public static FromDegrees(degrees: number): Angle {\r\n    return new Angle(degrees);\r\n  }\r\n\r\n  /**\r\n   * Creates an angle from radians\r\n   * @param radians Angle in radians\r\n   * @returns The angle\r\n   */\r\n  public static FromRadians(radians: number): Angle {\r\n    return new Angle((radians * 180) / Math.PI);\r\n  }\r\n\r\n  /**\r\n   * Check to see if two angles are close\r\n   * @param a Angle A\r\n   * @param b Angle B\r\n   * @param tolerance Tolerance for \"Close\" in degrees. Defaults to 0.001;\r\n   * @returns True if the difference between A and B (in degrees) is less than the tolerance\r\n   */\r\n  public static Close(a: Angle, b: Angle, tolerance: number = 0.001): boolean {\r\n    let diff = a.degrees - b.degrees;\r\n    if (diff < 0) {\r\n      diff = -diff;\r\n    }\r\n    return diff < tolerance;\r\n  }\r\n\r\n  private _degrees = 0;\r\n  public get degrees() {\r\n    return this._degrees;\r\n  }\r\n\r\n  public get radians() {\r\n    return (this._degrees * Math.PI) / 180;\r\n  }\r\n\r\n  private constructor(degrees: number) {\r\n    this._degrees = degrees;\r\n  }\r\n}\r\n"]}

package/dist/esm/ValueObjects/LineSegment2D.js

@@ -22,14 +22,14 @@ export class LineSegment2D {
         }
         const tNumerator = (x1 - x3) * (y3 - y4) - (y1 - y3) * (x3 - x4);
         const t = tNumerator / denominator;
-        const tTolearnce = tolerance / a.length;
-        if (t < -tTolearnce || t > 1 + tTolearnce) {
+        const tTolerance = tolerance / a.length;
+        if (t < -tTolerance || t > 1 + tTolerance) {
             return undefined;
         }
         const uNumerator = (x2 - x1) * (y1 - y3) - (y2 - y1) * (x1 - x3);
         const u = uNumerator / denominator;
-        const uTolearnce = tolerance / b.length;
-        if (u < -uTolearnce || u > 1 + uTolearnce)
+        const uTolerance = tolerance / b.length;
+        if (u < -uTolerance || u > 1 + uTolerance)
             return undefined;
         const px = x1 + t * (x2 - x1);
         const py = y1 + t * (y2 - y1);
@@ -49,13 +49,13 @@ export class LineSegment2D {
             return line.end;
         }
         else {
-            const length = t * direction.magnitued;
+            const length = t * direction.magnitude;
             direction = Vector2.NewVectorOfLength(direction, length);
             return Vector2.Add(line.start, direction);
         }
     }
     get length() {
-        return Vector2.Subtract(this.start, this.end).magnitued;
+        return Vector2.Subtract(this.start, this.end).magnitude;
     }
     get direction() {
         return Vector2.Subtract(this.end, this.start).unit;

package/dist/esm/ValueObjects/LineSegment2D.js.map

@@ -1 +1 @@
-{"version":3,"file":"LineSegment2D.js","sourceRoot":"","sources":["../../../src/ValueObjects/LineSegment2D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,aAAa;IACjB,MAAM,CAAC,oBAAoB,CAChC,IAAmB,EACnB,OAAe;QAEf,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAErC,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAExD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAEM,MAAM,CAAC,SAAS,CACrB,CAAgB,EAChB,CAAgB,EAChB,SAAS,GAAG,CAAC;QAEb,mEAAmE;QACnE,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEnB,MAAM,WAAW,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,GAAG,UAAU,GAAG,WAAW,CAAC;QAEnC,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,EAAE,CAAC;YAC1C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,GAAG,UAAU,GAAG,WAAW,CAAC;QAEnC,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU;YAAE,OAAO,SAAS,CAAC;QAE5D,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAE9B,OAAO,IAAI,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAEM,MAAM,CAAC,kBAAkB,CAC9B,IAAmB,EACnB,KAAc;QAEd,mHAAmH;QACnH,IAAI,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,UAAU,GAAG,YAAY,CAAC;QAEpC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,GAAG,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC;YACvC,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACzD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAKD,IAAW,MAAM;QACf,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC;IAC1D,CAAC;IAED,IAAW,SAAS;QAClB,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED,YAAY,KAAc,EAAE,GAAY;QACtC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF","sourcesContent":["import { Vector2 } from \"./Vector2\";\r\n\r\nexport class LineSegment2D {\r\n  public static GetPositionAtPercent(\r\n    line: LineSegment2D,\r\n    percent: number\r\n  ): Vector2 {\r\n    const dir = line.direction;\r\n    const length = percent * line.length;\r\n\r\n    const localPos = Vector2.NewVectorOfLength(dir, length);\r\n\r\n    return Vector2.Add(line.start, localPos);\r\n  }\r\n\r\n  public static Intersect(\r\n    a: LineSegment2D,\r\n    b: LineSegment2D,\r\n    tolerance = 0\r\n  ): Vector2 | undefined {\r\n    // See https://en.wikipedia.org/wiki/Line%E2%80%93line_intersection\r\n    const x1 = a.start.x;\r\n    const y1 = a.start.y;\r\n    const x2 = a.end.x;\r\n    const y2 = a.end.y;\r\n    const x3 = b.start.x;\r\n    const y3 = b.start.y;\r\n    const x4 = b.end.x;\r\n    const y4 = b.end.y;\r\n\r\n    const denominator = (x1 - x2) * (y3 - y4) - (y1 - y2) * (x3 - x4);\r\n    if (denominator === 0) {\r\n      return undefined;\r\n    }\r\n\r\n    const tNumerator = (x1 - x3) * (y3 - y4) - (y1 - y3) * (x3 - x4);\r\n    const t = tNumerator / denominator;\r\n\r\n    const tTolearnce = tolerance / a.length;\r\n    if (t < -tTolearnce || t > 1 + tTolearnce) {\r\n      return undefined;\r\n    }\r\n\r\n    const uNumerator = (x2 - x1) * (y1 - y3) - (y2 - y1) * (x1 - x3);\r\n    const u = uNumerator / denominator;\r\n\r\n    const uTolearnce = tolerance / b.length;\r\n    if (u < -uTolearnce || u > 1 + uTolearnce) return undefined;\r\n\r\n    const px = x1 + t * (x2 - x1);\r\n    const py = y1 + t * (y2 - y1);\r\n\r\n    return new Vector2(px, py);\r\n  }\r\n\r\n  public static ClosestPointOnLine(\r\n    line: LineSegment2D,\r\n    point: Vector2\r\n  ): Vector2 {\r\n    // see https://monkeyproofsolutions.nl/wordpress/how-to-calculate-the-shortest-distance-between-a-point-and-a-line/\r\n    let direction = Vector2.Subtract(line.end, line.start);\r\n    const pointToStart = Vector2.Subtract(point, line.start);\r\n    const tNumerator = Vector2.Dot(direction, pointToStart);\r\n    const tDenominator = Vector2.Dot(direction, direction);\r\n    const t = tNumerator / tDenominator;\r\n\r\n    if (t < 0) {\r\n      return line.start;\r\n    } else if (t > 1) {\r\n      return line.end;\r\n    } else {\r\n      const length = t * direction.magnitued;\r\n      direction = Vector2.NewVectorOfLength(direction, length);\r\n      return Vector2.Add(line.start, direction);\r\n    }\r\n  }\r\n\r\n  readonly start: Vector2;\r\n  readonly end: Vector2;\r\n\r\n  public get length(): number {\r\n    return Vector2.Subtract(this.start, this.end).magnitued;\r\n  }\r\n\r\n  public get direction(): Vector2 {\r\n    return Vector2.Subtract(this.end, this.start).unit;\r\n  }\r\n\r\n  constructor(start: Vector2, end: Vector2) {\r\n    this.start = start;\r\n    this.end = end;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"LineSegment2D.js","sourceRoot":"","sources":["../../../src/ValueObjects/LineSegment2D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,aAAa;IACjB,MAAM,CAAC,oBAAoB,CAChC,IAAmB,EACnB,OAAe;QAEf,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAErC,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAExD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAEM,MAAM,CAAC,SAAS,CACrB,CAAgB,EAChB,CAAgB,EAChB,SAAS,GAAG,CAAC;QAEb,mEAAmE;QACnE,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEnB,MAAM,WAAW,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,GAAG,UAAU,GAAG,WAAW,CAAC;QAEnC,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,EAAE,CAAC;YAC1C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,GAAG,UAAU,GAAG,WAAW,CAAC;QAEnC,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU;YAAE,OAAO,SAAS,CAAC;QAE5D,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAE9B,OAAO,IAAI,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAEM,MAAM,CAAC,kBAAkB,CAC9B,IAAmB,EACnB,KAAc;QAEd,mHAAmH;QACnH,IAAI,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,UAAU,GAAG,YAAY,CAAC;QAEpC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,GAAG,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC;YACvC,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACzD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAKD,IAAW,MAAM;QACf,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC;IAC1D,CAAC;IAED,IAAW,SAAS;QAClB,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED,YAAY,KAAc,EAAE,GAAY;QACtC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF","sourcesContent":["import { Vector2 } from \"./Vector2\";\r\n\r\nexport class LineSegment2D {\r\n  public static GetPositionAtPercent(\r\n    line: LineSegment2D,\r\n    percent: number\r\n  ): Vector2 {\r\n    const dir = line.direction;\r\n    const length = percent * line.length;\r\n\r\n    const localPos = Vector2.NewVectorOfLength(dir, length);\r\n\r\n    return Vector2.Add(line.start, localPos);\r\n  }\r\n\r\n  public static Intersect(\r\n    a: LineSegment2D,\r\n    b: LineSegment2D,\r\n    tolerance = 0\r\n  ): Vector2 | undefined {\r\n    // See https://en.wikipedia.org/wiki/Line%E2%80%93line_intersection\r\n    const x1 = a.start.x;\r\n    const y1 = a.start.y;\r\n    const x2 = a.end.x;\r\n    const y2 = a.end.y;\r\n    const x3 = b.start.x;\r\n    const y3 = b.start.y;\r\n    const x4 = b.end.x;\r\n    const y4 = b.end.y;\r\n\r\n    const denominator = (x1 - x2) * (y3 - y4) - (y1 - y2) * (x3 - x4);\r\n    if (denominator === 0) {\r\n      return undefined;\r\n    }\r\n\r\n    const tNumerator = (x1 - x3) * (y3 - y4) - (y1 - y3) * (x3 - x4);\r\n    const t = tNumerator / denominator;\r\n\r\n    const tTolerance = tolerance / a.length;\r\n    if (t < -tTolerance || t > 1 + tTolerance) {\r\n      return undefined;\r\n    }\r\n\r\n    const uNumerator = (x2 - x1) * (y1 - y3) - (y2 - y1) * (x1 - x3);\r\n    const u = uNumerator / denominator;\r\n\r\n    const uTolerance = tolerance / b.length;\r\n    if (u < -uTolerance || u > 1 + uTolerance) return undefined;\r\n\r\n    const px = x1 + t * (x2 - x1);\r\n    const py = y1 + t * (y2 - y1);\r\n\r\n    return new Vector2(px, py);\r\n  }\r\n\r\n  public static ClosestPointOnLine(\r\n    line: LineSegment2D,\r\n    point: Vector2\r\n  ): Vector2 {\r\n    // see https://monkeyproofsolutions.nl/wordpress/how-to-calculate-the-shortest-distance-between-a-point-and-a-line/\r\n    let direction = Vector2.Subtract(line.end, line.start);\r\n    const pointToStart = Vector2.Subtract(point, line.start);\r\n    const tNumerator = Vector2.Dot(direction, pointToStart);\r\n    const tDenominator = Vector2.Dot(direction, direction);\r\n    const t = tNumerator / tDenominator;\r\n\r\n    if (t < 0) {\r\n      return line.start;\r\n    } else if (t > 1) {\r\n      return line.end;\r\n    } else {\r\n      const length = t * direction.magnitude;\r\n      direction = Vector2.NewVectorOfLength(direction, length);\r\n      return Vector2.Add(line.start, direction);\r\n    }\r\n  }\r\n\r\n  readonly start: Vector2;\r\n  readonly end: Vector2;\r\n\r\n  public get length(): number {\r\n    return Vector2.Subtract(this.start, this.end).magnitude;\r\n  }\r\n\r\n  public get direction(): Vector2 {\r\n    return Vector2.Subtract(this.end, this.start).unit;\r\n  }\r\n\r\n  constructor(start: Vector2, end: Vector2) {\r\n    this.start = start;\r\n    this.end = end;\r\n  }\r\n}\r\n"]}

package/dist/esm/ValueObjects/Matrix.js

@@ -2,21 +2,21 @@ import { Quaternion } from "./Quaternion";
 import { Vector3 } from "./Vector3";
 export class Matrix {
     /**
-     * Consructs an identity matrix
+     * Constructs an identity matrix
      * @returns An identity matrix
      */
     static Identity() {
         return new Matrix([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
     }
     /**
-     * Constructs an matrix of zeros
+     * Constructs a matrix of zeros
      * @returns A matrix of zeros
      */
     static Zero() {
         return new Matrix([0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]);
     }
     /**
-     * Compares two matricies
+     * Compares two matrices
      * @param a Matrix A
      * @param b Matrix B
      * @returns True if all the elements in matrix A are equal to all the elements of matrix B
@@ -35,7 +35,7 @@ export class Matrix {
      * Checks to see if Matrix A is close to Matrix B by comparing elements
      * @param a Matrix A
      * @param b Matrix B
-     * @param threshold "Close" thershold. Defaults to 0.001
+     * @param threshold "Close" threshold. Defaults to 0.001
      * @returns True if all the difference between the elements in each array is less than the threshold
      */
     static Close(a, b, threshold = 0.001) {
@@ -129,7 +129,7 @@ export class Matrix {
         ]);
     }
     /**
-     * Composes a matrix from a scale vector, rotation quaterion, and translation vector
+     * Composes a matrix from a scale vector, rotation quaternion, and translation vector
      * @param scale The scale of the transformation matrix
      * @param rotation The rotation of the transformation matrix
      * @param translation The translation of the transformation matrix
@@ -340,7 +340,7 @@ export class Matrix {
             array[12],
             array[13],
             array[14],
-            array[15]
+            array[15],
         ];
         return new Matrix(matrixArray);
     }