npm - @vived/host - Versions diffs - 4.2.0 → 4.4.0 - Mend

@vived/host 4.2.0 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1714) hide show

package/dist/esm/Snackbar/Controllers/callActiveSnackbarAction.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"callActiveSnackbarAction.js","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/callActiveSnackbarAction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,UAAU,wBAAwB,CAAC,UAAyB;IAChE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,WAAW,CACpB,0BAA0B,EAC1B,6BAA6B,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\nexport function callActiveSnackbarAction(appObjects: AppObjectRepo) {\r\n const repo = SnackbarRepo.get(appObjects);\r\n if (repo) {\r\n repo.callActiveSnackbarAction();\r\n } else {\r\n appObjects.submitError(\r\n \"callActiveSnackbarAction\",\r\n \"Unable to find SnackbarRepo\"\r\n );\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"callActiveSnackbarAction.js","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/callActiveSnackbarAction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAyB;IAChE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,WAAW,CACpB,0BAA0B,EAC1B,6BAA6B,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\n/*\r\n Executes the action of the currently active snackbar, if it has one\r\n * Also dismisses the snackbar after executing the action\r\n * \r\n * @param appObjects The application object repository\r\n */\r\nexport function callActiveSnackbarAction(appObjects: AppObjectRepo): void {\r\n const repo = SnackbarRepo.get(appObjects);\r\n if (repo) {\r\n repo.callActiveSnackbarAction();\r\n } else {\r\n appObjects.submitError(\r\n \"callActiveSnackbarAction\",\r\n \"Unable to find SnackbarRepo\"\r\n );\r\n }\r\n}\r\n"]}

package/dist/esm/Snackbar/Controllers/dismissActiveSnackbar.js CHANGED Viewed

@@ -1,4 +1,9 @@
 import { SnackbarRepo } from "../Entities/SnackbarRepo";
+/**
+ * Dismisses the currently active snackbar, if any exists
+ *
+ * @param appObjects The application object repository
+ */
 export function dismissActiveSnackbar(appObjects) {
     const repo = SnackbarRepo.get(appObjects);
     if (repo) {

package/dist/esm/Snackbar/Controllers/dismissActiveSnackbar.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"dismissActiveSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/dismissActiveSnackbar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,UAAU,qBAAqB,CAAC,UAAyB;IAC7D,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,WAAW,CACpB,uBAAuB,EACvB,6BAA6B,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\nexport function dismissActiveSnackbar(appObjects: AppObjectRepo) {\r\n const repo = SnackbarRepo.get(appObjects);\r\n if (repo) {\r\n repo.dismissActiveSnackbar();\r\n } else {\r\n appObjects.submitError(\r\n \"dismissActiveSnackbar\",\r\n \"Unable to find SnackbarRepo\"\r\n );\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"dismissActiveSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/dismissActiveSnackbar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAyB;IAC7D,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,WAAW,CACpB,uBAAuB,EACvB,6BAA6B,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\n/*\r\n Dismisses the currently active snackbar, if any exists\r\n * \r\n * @param appObjects The application object repository\r\n */\r\nexport function dismissActiveSnackbar(appObjects: AppObjectRepo): void {\r\n const repo = SnackbarRepo.get(appObjects);\r\n if (repo) {\r\n repo.dismissActiveSnackbar();\r\n } else {\r\n appObjects.submitError(\r\n \"dismissActiveSnackbar\",\r\n \"Unable to find SnackbarRepo\"\r\n );\r\n }\r\n}\r\n"]}

package/dist/esm/Snackbar/Controllers/index.js CHANGED Viewed

@@ -1,3 +1,4 @@
 export * from "./callActiveSnackbarAction";
 export * from "./dismissActiveSnackbar";
+export * from "./makeSnackbar";
 //# sourceMappingURL=index.js.map

package/dist/esm/Snackbar/Controllers/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC","sourcesContent":["export * from \"./callActiveSnackbarAction\";\r\nexport * from \"./dismissActiveSnackbar\";\r\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC","sourcesContent":["export * from \"./callActiveSnackbarAction\";\r\nexport * from \"./dismissActiveSnackbar\";\r\nexport * from \"./makeSnackbar\";\r\n"]}

package/dist/esm/Snackbar/Controllers/makeSnackbar.js ADDED Viewed

@@ -0,0 +1,19 @@
+import { SnackbarRepo } from "../Entities/SnackbarRepo";
+/**
+ * Creates and displays a new snackbar notification
+ *
+ * @param appObjects The application object repository
+ * @param message The message to display in the snackbar
+ * @param snackbarAction Optional action button configuration with text and callback
+ * @param durationInSeconds Optional duration in seconds before auto-dismissing (defaults to 4 seconds)
+ */
+export function makeSnackbar(appObjects, message, snackbarAction, durationInSeconds) {
+    const repo = SnackbarRepo.get(appObjects);
+    if (repo) {
+        repo.makeSnackbar(message, snackbarAction, durationInSeconds);
+    }
+    else {
+        appObjects.submitError("makeSnackbar", "Unable to find SnackbarRepo");
+    }
+}
+//# sourceMappingURL=makeSnackbar.js.map

package/dist/esm/Snackbar/Controllers/makeSnackbar.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"makeSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/makeSnackbar.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,UAAyB,EACzB,OAAe,EACf,cAA+B,EAC/B,iBAA0B;IAE1B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,6BAA6B,CAAC,CAAC;IACxE,CAAC;AACH,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { SnackbarAction, SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\n/**\r\n * Creates and displays a new snackbar notification\r\n * \r\n * @param appObjects The application object repository\r\n * @param message The message to display in the snackbar\r\n * @param snackbarAction Optional action button configuration with text and callback\r\n * @param durationInSeconds Optional duration in seconds before auto-dismissing (defaults to 4 seconds)\r\n */\r\nexport function makeSnackbar(\r\n appObjects: AppObjectRepo,\r\n message: string,\r\n snackbarAction?: SnackbarAction,\r\n durationInSeconds?: number\r\n): void {\r\n const repo = SnackbarRepo.get(appObjects);\r\n if (repo) {\r\n repo.makeSnackbar(message, snackbarAction, durationInSeconds);\r\n } else {\r\n appObjects.submitError(\"makeSnackbar\", \"Unable to find SnackbarRepo\");\r\n }\r\n}\r\n"]}

package/dist/esm/Snackbar/Entities/SnackbarRepo.js CHANGED Viewed

@@ -1,63 +1,108 @@
 import { AppObjectEntity, getSingletonComponent } from "@vived/core";
+/**
+ * Repository for managing snackbar notifications
+ * Handles creating, displaying, and dismissing snackbars
+ */
 export class SnackbarRepo extends AppObjectEntity {
+    /**
+     * Gets the singleton instance of SnackbarRepo
+     * @param appObjects The application object repository
+     * @returns The SnackbarRepo instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(SnackbarRepo.type, appObjects);
     }
 }
 SnackbarRepo.type = "SnackbarRepo";
+/**
+ * Creates a new SnackbarRepo instance
+ * @param appObject The application object
+ * @returns A new SnackbarRepo instance
+ */
 export function makeSnackbarRepo(appObject) {
     return new SnackbarRepoImp(appObject);
 }
+/**
+ * Implementation of SnackbarRepo
+ * Handles the queue of snackbars and their timing
+ */
 class SnackbarRepoImp extends SnackbarRepo {
+    /**
+     * Creates a new SnackbarRepoImp instance
+     * @param appObject The application object
+     * @param defaultDurationInSeconds Default duration for snackbars (default: 4 seconds)
+     */
     constructor(appObject, defaultDurationInSeconds = 4) {
         super(appObject, SnackbarRepo.type);
+        /** Flag to prevent multiple timing loops from running */
         this.monitoringSnackbarTime = false;
-        this.makeSnackbar = (message, snackbarAction, durationInSeconds) => {
-            if (message.trim().length === 0) {
-                this.warn("Snackbar must have a message");
-                return;
-            }
-            if (snackbarAction && snackbarAction.actionButtonText.trim().length === 0) {
-                this.warn("If a Snackbar has an action then the action button text cannot be empty");
-                return;
-            }
-            const duration = durationInSeconds ?? this.defaultDurationInSeconds;
-            if (duration <= 0) {
-                this.warn(`${duration} is an invalid duration for a Snackbar`);
-                return;
-            }
-            const snackbar = {
-                message,
-                durationInSeconds: duration,
-                snackbarAction
-            };
-            this.snackbarQueue.push(snackbar);
-            this.notifyOnChange();
-            this.monitorSnackbarTime();
-            return;
-        };
-        this.getCurrentSnackbar = () => {
-            return this.snackbarQueue.length > 0 ? this.snackbarQueue[0] : undefined;
-        };
-        this.dismissActiveSnackbar = () => {
-            if (this.snackbarQueue.length > 0) {
-                this.snackbarQueue.splice(0, 1);
-                this.notifyOnChange();
-            }
-        };
-        this.callActiveSnackbarAction = () => {
-            const currentSnackbar = this.getCurrentSnackbar();
-            if (currentSnackbar) {
-                if (currentSnackbar.snackbarAction) {
-                    currentSnackbar.snackbarAction.action();
-                    this.dismissActiveSnackbar();
-                }
-            }
-        };
         this.snackbarQueue = [];
         this.defaultDurationInSeconds = defaultDurationInSeconds;
         this.appObjects.registerSingleton(this);
     }
+    /**
+     * Creates and displays a new snackbar notification
+     * @param message The message to display
+     * @param snackbarAction Optional action button and callback
+     * @param durationInSeconds Optional duration in seconds before auto-dismissing
+     */
+    makeSnackbar(message, snackbarAction, durationInSeconds) {
+        if (message.trim().length === 0) {
+            this.warn("Snackbar must have a message");
+            return;
+        }
+        if (snackbarAction && snackbarAction.actionButtonText.trim().length === 0) {
+            this.warn("If a Snackbar has an action then the action button text cannot be empty");
+            return;
+        }
+        const duration = durationInSeconds ?? this.defaultDurationInSeconds;
+        if (duration <= 0) {
+            this.warn(`${duration} is an invalid duration for a Snackbar`);
+            return;
+        }
+        const snackbar = {
+            message,
+            durationInSeconds: duration,
+            snackbarAction
+        };
+        this.snackbarQueue.push(snackbar);
+        this.notifyOnChange();
+        this.monitorSnackbarTime();
+        return;
+    }
+    /**
+     * Gets the currently active snackbar, if any
+     * @returns The current snackbar or undefined if none is active
+     */
+    getCurrentSnackbar() {
+        return this.snackbarQueue.length > 0 ? this.snackbarQueue[0] : undefined;
+    }
+    /**
+     * Dismisses the currently active snackbar, if any
+     */
+    dismissActiveSnackbar() {
+        if (this.snackbarQueue.length > 0) {
+            this.snackbarQueue.splice(0, 1);
+            this.notifyOnChange();
+        }
+    }
+    /**
+     * Executes the action of the currently active snackbar, if it has one
+     * Also dismisses the snackbar after executing the action
+     */
+    callActiveSnackbarAction() {
+        const currentSnackbar = this.getCurrentSnackbar();
+        if (currentSnackbar) {
+            if (currentSnackbar.snackbarAction) {
+                currentSnackbar.snackbarAction.action();
+                this.dismissActiveSnackbar();
+            }
+        }
+    }
+    /**
+     * Monitors the timing of snackbars to auto-dismiss them when their duration expires
+     * Uses a loop that checks each snackbar's remaining time
+     */
     async monitorSnackbarTime() {
         if (this.monitoringSnackbarTime) {
             return;

package/dist/esm/Snackbar/Entities/SnackbarRepo.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"SnackbarRepo.js","sourceRoot":"","sources":["../../../../src/Snackbar/Entities/SnackbarRepo.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n AppObject,\r\n AppObjectEntity,\r\n AppObjectRepo,\r\n getSingletonComponent\r\n} from \"@vived/core\";\r\n\r\nexport interface Snackbar {\r\n message: string;\r\n durationInSeconds: number;\r\n snackbarAction?: SnackbarAction;\r\n}\r\n\r\nexport interface SnackbarAction {\r\n actionButtonText: string;\r\n action: () => void;\r\n}\r\n\r\nexport type SnackbarObserver = (snackbar: Snackbar \| undefined) => void;\r\n\r\nexport abstract class SnackbarRepo extends AppObjectEntity {\r\n static type = \"SnackbarRepo\";\r\n\r\n static get(appObjects: AppObjectRepo) {\r\n return getSingletonComponent<SnackbarRepo>(SnackbarRepo.type, appObjects);\r\n }\r\n\r\n abstract makeSnackbar(\r\n message: string,\r\n snackbarAction?: SnackbarAction,\r\n durationInSeconds?: number\r\n ): void;\r\n abstract getCurrentSnackbar(): Snackbar \| undefined;\r\n abstract dismissActiveSnackbar(): void;\r\n abstract callActiveSnackbarAction(): void;\r\n}\r\n\r\nexport function makeSnackbarRepo(appObject: AppObject): SnackbarRepo {\r\n return new SnackbarRepoImp(appObject);\r\n}\r\n\r\nclass SnackbarRepoImp extends SnackbarRepo {\r\n private snackbarQueue: Snackbar[];\r\n private defaultDurationInSeconds: number;\r\n private monitoringSnackbarTime: boolean = false;\r\n\r\n constructor(appObject: AppObject, defaultDurationInSeconds: number = 4) {\r\n super(appObject, SnackbarRepo.type);\r\n this.snackbarQueue = [];\r\n this.defaultDurationInSeconds = defaultDurationInSeconds;\r\n this.appObjects.registerSingleton(this);\r\n }\r\n\r\n makeSnackbar = (\r\n message: string,\r\n snackbarAction?: SnackbarAction \| undefined,\r\n durationInSeconds?: number \| undefined\r\n ): void => {\r\n if (message.trim().length === 0) {\r\n this.warn(\"Snackbar must have a message\");\r\n return;\r\n }\r\n\r\n if (snackbarAction && snackbarAction.actionButtonText.trim().length === 0) {\r\n this.warn(\r\n \"If a Snackbar has an action then the action button text cannot be empty\"\r\n );\r\n return;\r\n }\r\n\r\n const duration = durationInSeconds ?? this.defaultDurationInSeconds;\r\n if (duration <= 0) {\r\n this.warn(`${duration} is an invalid duration for a Snackbar`);\r\n return;\r\n }\r\n\r\n const snackbar: Snackbar = {\r\n message,\r\n durationInSeconds: duration,\r\n snackbarAction\r\n };\r\n\r\n this.snackbarQueue.push(snackbar);\r\n this.notifyOnChange();\r\n this.monitorSnackbarTime();\r\n\r\n return;\r\n };\r\n\r\n getCurrentSnackbar = (): Snackbar \| undefined => {\r\n return this.snackbarQueue.length > 0 ? this.snackbarQueue[0] : undefined;\r\n };\r\n\r\n dismissActiveSnackbar = () => {\r\n if (this.snackbarQueue.length > 0) {\r\n this.snackbarQueue.splice(0, 1);\r\n this.notifyOnChange();\r\n }\r\n };\r\n\r\n callActiveSnackbarAction = () => {\r\n const currentSnackbar = this.getCurrentSnackbar();\r\n if (currentSnackbar) {\r\n if (currentSnackbar.snackbarAction) {\r\n currentSnackbar.snackbarAction.action();\r\n this.dismissActiveSnackbar();\r\n }\r\n }\r\n };\r\n\r\n private async monitorSnackbarTime() {\r\n if (this.monitoringSnackbarTime) {\r\n return;\r\n }\r\n\r\n const loopFrequencyInSeconds: number = 0.1;\r\n this.monitoringSnackbarTime = true;\r\n\r\n while (this.snackbarQueue.length > 0) {\r\n const currentSnackbar = this.getCurrentSnackbar();\r\n if (currentSnackbar) {\r\n let currentTimeout = currentSnackbar.durationInSeconds;\r\n while (\r\n this.getCurrentSnackbar() === currentSnackbar &&\r\n currentTimeout > 0\r\n ) {\r\n // tslint:disable-next-line:no-shadowed-variable\r\n await new Promise((resolve) =>\r\n setTimeout(resolve, loopFrequencyInSeconds * 1000)\r\n );\r\n currentTimeout -= loopFrequencyInSeconds;\r\n }\r\n if (\r\n this.getCurrentSnackbar() === currentSnackbar &&\r\n currentTimeout <= 0\r\n ) {\r\n this.dismissActiveSnackbar();\r\n }\r\n }\r\n }\r\n this.monitoringSnackbarTime = false;\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"SnackbarRepo.js","sourceRoot":"","sources":["../../../../src/Snackbar/Entities/SnackbarRepo.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n AppObject,\r\n AppObjectEntity,\r\n AppObjectRepo,\r\n getSingletonComponent\r\n} from \"@vived/core\";\r\n\r\n/*\r\n Represents a snackbar notification with a message, duration, and optional action\r\n /\r\nexport interface Snackbar {\r\n /* The text message to display in the snackbar /\r\n message: string;\r\n /* How long the snackbar should be displayed before auto-dismissing (in seconds) /\r\n durationInSeconds: number;\r\n /* Optional action button and callback for the snackbar /\r\n snackbarAction?: SnackbarAction;\r\n}\r\n\r\n/\r\n Represents an action button for a snackbar\r\n /\r\nexport interface SnackbarAction {\r\n /* The text to display on the action button /\r\n actionButtonText: string;\r\n /* Callback function to execute when the action button is clicked /\r\n action: () => void;\r\n}\r\n\r\n/\r\n Observer type for snackbar state changes\r\n /\r\nexport type SnackbarObserver = (snackbar: Snackbar \| undefined) => void;\r\n\r\n/\r\n Repository for managing snackbar notifications\r\n * Handles creating, displaying, and dismissing snackbars\r\n /\r\nexport abstract class SnackbarRepo extends AppObjectEntity {\r\n static type = \"SnackbarRepo\";\r\n\r\n /\r\n Gets the singleton instance of SnackbarRepo\r\n * @param appObjects The application object repository\r\n * @returns The SnackbarRepo instance or undefined if not found\r\n /\r\n static get(appObjects: AppObjectRepo) {\r\n return getSingletonComponent<SnackbarRepo>(SnackbarRepo.type, appObjects);\r\n }\r\n\r\n /\r\n Creates and displays a new snackbar notification\r\n * @param message The message to display\r\n * @param snackbarAction Optional action button and callback\r\n * @param durationInSeconds Optional duration in seconds before auto-dismissing\r\n /\r\n abstract makeSnackbar(\r\n message: string,\r\n snackbarAction?: SnackbarAction,\r\n durationInSeconds?: number\r\n ): void;\r\n \r\n /\r\n Gets the currently active snackbar, if any\r\n * @returns The current snackbar or undefined if none is active\r\n /\r\n abstract getCurrentSnackbar(): Snackbar \| undefined;\r\n \r\n /\r\n Dismisses the currently active snackbar, if any\r\n /\r\n abstract dismissActiveSnackbar(): void;\r\n \r\n /\r\n Executes the action of the currently active snackbar, if it has one\r\n * Also dismisses the snackbar after executing the action\r\n /\r\n abstract callActiveSnackbarAction(): void;\r\n}\r\n\r\n/\r\n Creates a new SnackbarRepo instance\r\n * @param appObject The application object\r\n * @returns A new SnackbarRepo instance\r\n /\r\nexport function makeSnackbarRepo(appObject: AppObject): SnackbarRepo {\r\n return new SnackbarRepoImp(appObject);\r\n}\r\n\r\n/\r\n Implementation of SnackbarRepo\r\n * Handles the queue of snackbars and their timing\r\n /\r\nclass SnackbarRepoImp extends SnackbarRepo {\r\n /* Queue of snackbars to display /\r\n private snackbarQueue: Snackbar[];\r\n /* Default duration for snackbars if not specified /\r\n private defaultDurationInSeconds: number;\r\n /* Flag to prevent multiple timing loops from running /\r\n private monitoringSnackbarTime: boolean = false;\r\n\r\n /\r\n Creates a new SnackbarRepoImp instance\r\n * @param appObject The application object\r\n * @param defaultDurationInSeconds Default duration for snackbars (default: 4 seconds)\r\n /\r\n constructor(appObject: AppObject, defaultDurationInSeconds: number = 4) {\r\n super(appObject, SnackbarRepo.type);\r\n this.snackbarQueue = [];\r\n this.defaultDurationInSeconds = defaultDurationInSeconds;\r\n this.appObjects.registerSingleton(this);\r\n }\r\n\r\n /\r\n Creates and displays a new snackbar notification\r\n * @param message The message to display\r\n * @param snackbarAction Optional action button and callback\r\n * @param durationInSeconds Optional duration in seconds before auto-dismissing\r\n /\r\n makeSnackbar(\r\n message: string,\r\n snackbarAction?: SnackbarAction \| undefined,\r\n durationInSeconds?: number \| undefined\r\n ): void {\r\n if (message.trim().length === 0) {\r\n this.warn(\"Snackbar must have a message\");\r\n return;\r\n }\r\n\r\n if (snackbarAction && snackbarAction.actionButtonText.trim().length === 0) {\r\n this.warn(\r\n \"If a Snackbar has an action then the action button text cannot be empty\"\r\n );\r\n return;\r\n }\r\n\r\n const duration = durationInSeconds ?? this.defaultDurationInSeconds;\r\n if (duration <= 0) {\r\n this.warn(`${duration} is an invalid duration for a Snackbar`);\r\n return;\r\n }\r\n\r\n const snackbar: Snackbar = {\r\n message,\r\n durationInSeconds: duration,\r\n snackbarAction\r\n };\r\n\r\n this.snackbarQueue.push(snackbar);\r\n this.notifyOnChange();\r\n this.monitorSnackbarTime();\r\n\r\n return;\r\n }\r\n\r\n /\r\n Gets the currently active snackbar, if any\r\n * @returns The current snackbar or undefined if none is active\r\n /\r\n getCurrentSnackbar(): Snackbar \| undefined {\r\n return this.snackbarQueue.length > 0 ? this.snackbarQueue[0] : undefined;\r\n }\r\n\r\n /\r\n Dismisses the currently active snackbar, if any\r\n /\r\n dismissActiveSnackbar(): void {\r\n if (this.snackbarQueue.length > 0) {\r\n this.snackbarQueue.splice(0, 1);\r\n this.notifyOnChange();\r\n }\r\n }\r\n\r\n /\r\n Executes the action of the currently active snackbar, if it has one\r\n * Also dismisses the snackbar after executing the action\r\n /\r\n callActiveSnackbarAction(): void {\r\n const currentSnackbar = this.getCurrentSnackbar();\r\n if (currentSnackbar) {\r\n if (currentSnackbar.snackbarAction) {\r\n currentSnackbar.snackbarAction.action();\r\n this.dismissActiveSnackbar();\r\n }\r\n }\r\n }\r\n\r\n /\r\n Monitors the timing of snackbars to auto-dismiss them when their duration expires\r\n * Uses a loop that checks each snackbar's remaining time\r\n /\r\n private async monitorSnackbarTime() {\r\n if (this.monitoringSnackbarTime) {\r\n return;\r\n }\r\n\r\n const loopFrequencyInSeconds: number = 0.1;\r\n this.monitoringSnackbarTime = true;\r\n\r\n while (this.snackbarQueue.length > 0) {\r\n const currentSnackbar = this.getCurrentSnackbar();\r\n if (currentSnackbar) {\r\n let currentTimeout = currentSnackbar.durationInSeconds;\r\n while (\r\n this.getCurrentSnackbar() === currentSnackbar &&\r\n currentTimeout > 0\r\n ) {\r\n // tslint:disable-next-line:no-shadowed-variable\r\n await new Promise((resolve) =>\r\n setTimeout(resolve, loopFrequencyInSeconds 1000)\r\n );\r\n currentTimeout -= loopFrequencyInSeconds;\r\n }\r\n if (\r\n this.getCurrentSnackbar() === currentSnackbar &&\r\n currentTimeout <= 0\r\n ) {\r\n this.dismissActiveSnackbar();\r\n }\r\n }\r\n }\r\n this.monitoringSnackbarTime = false;\r\n }\r\n}\r\n"]}

package/dist/esm/Snackbar/Factories/setupSnackbar.js CHANGED Viewed

@@ -1,5 +1,11 @@
 import { makeSnackbarRepo } from "../Entities";
 import { makeSnackbarPM } from "../PMs";
+/**
+ * Sets up the Snackbar feature by creating its entity and presentation manager
+ * This is the main entry point for initializing the Snackbar system
+ *
+ * @param appObjects The application object repository
+ */
 export function setupSnackbar(appObjects) {
     const ao = appObjects.getOrCreate("Snackbar");
     // Entities

package/dist/esm/Snackbar/Factories/setupSnackbar.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"setupSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Factories/setupSnackbar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,UAAU,aAAa,CAAC,UAAyB;IACrD,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE9C,WAAW;IACX,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAErB,MAAM;IACN,cAAc,CAAC,EAAE,CAAC,CAAC;AACrB,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { makeSnackbarRepo } from \"../Entities\";\r\nimport { makeSnackbarPM } from \"../PMs\";\r\n\r\nexport function setupSnackbar(appObjects: AppObjectRepo) {\r\n const ao = appObjects.getOrCreate(\"Snackbar\");\r\n\r\n // Entities\r\n makeSnackbarRepo(ao);\r\n\r\n // PMs\r\n makeSnackbarPM(ao);\r\n}\r\n"]}
1	+ {"version":3,"file":"setupSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Factories/setupSnackbar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,UAAyB;IACrD,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE9C,WAAW;IACX,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAErB,MAAM;IACN,cAAc,CAAC,EAAE,CAAC,CAAC;AACrB,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { makeSnackbarRepo } from \"../Entities\";\r\nimport { makeSnackbarPM } from \"../PMs\";\r\n\r\n/*\r\n Sets up the Snackbar feature by creating its entity and presentation manager\r\n * This is the main entry point for initializing the Snackbar system\r\n * \r\n * @param appObjects The application object repository\r\n */\r\nexport function setupSnackbar(appObjects: AppObjectRepo): void {\r\n const ao = appObjects.getOrCreate(\"Snackbar\");\r\n\r\n // Entities\r\n makeSnackbarRepo(ao);\r\n\r\n // PMs\r\n makeSnackbarPM(ao);\r\n}\r\n"]}

package/dist/esm/Snackbar/PMs/SnackbarPM.js CHANGED Viewed

@@ -1,18 +1,45 @@
 import { AppObjectPM, getSingletonComponent } from "@vived/core";
 import { SnackbarRepo } from "../Entities/SnackbarRepo";
+/**
+ * Presentation Manager for snackbar notifications
+ * Transforms data from SnackbarRepo into view models for UI components
+ */
 export class SnackbarPM extends AppObjectPM {
+    /**
+     * Gets the singleton instance of SnackbarPM
+     * @param appObjects The application object repository
+     * @returns The SnackbarPM instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(SnackbarPM.type, appObjects);
     }
 }
 SnackbarPM.type = "SnackbarPM";
+/**
+ * Creates a new SnackbarPM instance
+ * @param appObject The application object
+ * @returns A new SnackbarPM instance
+ */
 export function makeSnackbarPM(appObject) {
     return new SnackbarPMImp(appObject);
 }
+/**
+ * Implementation of SnackbarPM
+ * Manages the view model transformation and updates
+ */
 class SnackbarPMImp extends SnackbarPM {
+    /**
+     * Gets the cached singleton instance of SnackbarRepo
+     */
     get snackbarRepo() {
         return this.getCachedSingleton(SnackbarRepo.type);
     }
+    /**
+     * Compares two view models for equality
+     * @param a First view model
+     * @param b Second view model
+     * @returns True if the view models are equal, false otherwise
+     */
     vmsAreEqual(a, b) {
         if (a.message !== b.message)
             return false;
@@ -22,31 +49,42 @@ class SnackbarPMImp extends SnackbarPM {
             return false;
         return true;
     }
+    /**
+     * Updates the view model based on the current snackbar state
+     * Called whenever the snackbar repository changes
+     */
+    updateView() {
+        let model = {
+            message: undefined,
+            durationInSeconds: 0,
+            actionButtonText: undefined
+        };
+        const snackbar = this.snackbarRepo?.getCurrentSnackbar();
+        if (snackbar) {
+            model = {
+                message: snackbar.message,
+                durationInSeconds: snackbar.durationInSeconds,
+                actionButtonText: snackbar.snackbarAction
+                    ? snackbar.snackbarAction.actionButtonText
+                    : undefined
+            };
+        }
+        this.doUpdateView(model);
+    }
+    /**
+     * Creates a new SnackbarPMImp instance
+     * @param appObject The application object
+     */
     constructor(appObject) {
         super(appObject, SnackbarPM.type);
-        this.updateView = () => {
-            let model = {
-                message: undefined,
-                durationInSeconds: 0,
-                actionButtonText: undefined
-            };
-            const snackbar = this.snackbarRepo?.getCurrentSnackbar();
-            if (snackbar) {
-                model = {
-                    message: snackbar.message,
-                    durationInSeconds: snackbar.durationInSeconds,
-                    actionButtonText: snackbar.snackbarAction
-                        ? snackbar.snackbarAction.actionButtonText
-                        : undefined
-                };
-            }
-            this.doUpdateView(model);
-        };
         this.updateView(); // Initialize the lastVM
-        this.snackbarRepo?.addChangeObserver(this.updateView);
+        this.snackbarRepo?.addChangeObserver(this.updateView.bind(this));
         this.appObjects.registerSingleton(this);
     }
 }
+/**
+ * Default empty view model used when no snackbar is active
+ */
 export const defaultSnackbarVM = {
     message: undefined,
     durationInSeconds: 0,

package/dist/esm/Snackbar/PMs/SnackbarPM.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"SnackbarPM.js","sourceRoot":"","sources":["../../../../src/Snackbar/PMs/SnackbarPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EAEX,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;~~AAQxD~~,MAAM,OAAgB,UAAW,SAAQ,WAAuB;IAG9D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;~~AAJM~~,eAAI,GAAG,YAAY,CAAC;~~AAO7B~~,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IACpC,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAe,YAAY,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,WAAW,CAAC,CAAa,EAAE,CAAa;QACtC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,CAAC,iBAAiB,KAAK,CAAC,CAAC,iBAAiB;YAAE,OAAO,KAAK,CAAC;QAC9D,IAAI,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,gBAAgB;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;~~IAwBD,YAAY,SAAoB~~;~~QAC9B~~,~~KAAK,CAAC,SAAS,EAAE,~~UAAU~~,CAAC,IAAI,CAAC,CAAC~~;~~QAvB5B~~,~~eAAU,GAAG,GAAS,EAAE;YAC9B,~~IAAI,KAAK,GAAe;~~gBACtB~~,OAAO,EAAE,SAAS;~~gBAClB~~,iBAAiB,EAAE,CAAC;~~gBACpB~~,gBAAgB,EAAE,SAAS;~~aAC5B~~,CAAC;~~YAEF~~,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,kBAAkB,EAAE,CAAC;~~YAEzD~~,IAAI,QAAQ,EAAE,CAAC;~~gBACb~~,KAAK,GAAG;~~oBACN~~,OAAO,EAAE,QAAQ,CAAC,OAAO;~~oBACzB~~,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;~~oBAC7C~~,gBAAgB,EAAE,QAAQ,CAAC,cAAc;~~wBACvC~~,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,gBAAgB;~~wBAC1C~~,CAAC,CAAC,SAAS;~~iBACd~~,CAAC;~~YACJ~~,CAAC;~~YAED~~,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;~~QAC3B~~,CAAC,CAAC;~~QAKA~~,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,wBAAwB;QAC3C,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;~~QACtD~~,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,SAAS;CAC5B,CAAC","sourcesContent":["import {\r\n AppObject,\r\n AppObjectPM,\r\n AppObjectRepo,\r\n getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\nexport interface SnackbarVM {\r\n message: string \| undefined;\r\n durationInSeconds: number;\r\n actionButtonText: string \| undefined;\r\n}\r\n\r\nexport abstract class SnackbarPM extends AppObjectPM<SnackbarVM> {\r\n static type = \"SnackbarPM\";\r\n\r\n static get(appObjects: AppObjectRepo) {\r\n return getSingletonComponent<SnackbarPM>(SnackbarPM.type, appObjects);\r\n }\r\n}\r\n\r\nexport function makeSnackbarPM(appObject: AppObject): SnackbarPM {\r\n return new SnackbarPMImp(appObject);\r\n}\r\n\r\nclass SnackbarPMImp extends SnackbarPM {\r\n private get snackbarRepo() {\r\n return this.getCachedSingleton<SnackbarRepo>(SnackbarRepo.type);\r\n }\r\n\r\n vmsAreEqual(a: SnackbarVM, b: SnackbarVM): boolean {\r\n if (a.message !== b.message) return false;\r\n if (a.durationInSeconds !== b.durationInSeconds) return false;\r\n if (a.actionButtonText !== b.actionButtonText) return false;\r\n return true;\r\n }\r\n\r\n private updateView = (): void => {\r\n let model: SnackbarVM = {\r\n message: undefined,\r\n durationInSeconds: 0,\r\n actionButtonText: undefined\r\n };\r\n\r\n const snackbar = this.snackbarRepo?.getCurrentSnackbar();\r\n\r\n if (snackbar) {\r\n model = {\r\n message: snackbar.message,\r\n durationInSeconds: snackbar.durationInSeconds,\r\n actionButtonText: snackbar.snackbarAction\r\n ? snackbar.snackbarAction.actionButtonText\r\n : undefined\r\n };\r\n }\r\n\r\n this.doUpdateView(model);\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, SnackbarPM.type);\r\n\r\n this.updateView(); // Initialize the lastVM\r\n this.snackbarRepo?.addChangeObserver(this.updateView);\r\n this.appObjects.registerSingleton(this);\r\n }\r\n}\r\n\r\nexport const defaultSnackbarVM: SnackbarVM = {\r\n message: undefined,\r\n durationInSeconds: 0,\r\n actionButtonText: undefined\r\n};\r\n"]}
1	+ {"version":3,"file":"SnackbarPM.js","sourceRoot":"","sources":["../../../../src/Snackbar/PMs/SnackbarPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EAEX,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAexD;;;GAGG;AACH,MAAM,OAAgB,UAAW,SAAQ,WAAuB;IAG9D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AATM,eAAI,GAAG,YAAY,CAAC;AAY7B;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,aAAc,SAAQ,UAAU;IACpC;;OAEG;IACH,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,kBAAkB,CAAe,YAAY,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,CAAa,EAAE,CAAa;QACtC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,CAAC,iBAAiB,KAAK,CAAC,CAAC,iBAAiB;YAAE,OAAO,KAAK,CAAC;QAC9D,IAAI,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,gBAAgB;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACK,UAAU;QAChB,IAAI,KAAK,GAAe;YACtB,OAAO,EAAE,SAAS;YAClB,iBAAiB,EAAE,CAAC;YACpB,gBAAgB,EAAE,SAAS;SAC5B,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,kBAAkB,EAAE,CAAC;QAEzD,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;gBAC7C,gBAAgB,EAAE,QAAQ,CAAC,cAAc;oBACvC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,gBAAgB;oBAC1C,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,wBAAwB;QAC3C,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,SAAS;CAC5B,CAAC","sourcesContent":["import {\r\n AppObject,\r\n AppObjectPM,\r\n AppObjectRepo,\r\n getSingletonComponent\r\n} from \"@vived/core\";\r\nimport { SnackbarRepo } from \"../Entities/SnackbarRepo\";\r\n\r\n/*\r\n View model for snackbar UI components\r\n * Contains only the properties needed for display\r\n /\r\nexport interface SnackbarVM {\r\n /* Message to display in the snackbar (undefined when no active snackbar) /\r\n message: string \| undefined;\r\n /* Duration in seconds before the snackbar auto-dismisses /\r\n durationInSeconds: number;\r\n /* Text for the action button (undefined when no action) /\r\n actionButtonText: string \| undefined;\r\n}\r\n\r\n/\r\n Presentation Manager for snackbar notifications\r\n * Transforms data from SnackbarRepo into view models for UI components\r\n /\r\nexport abstract class SnackbarPM extends AppObjectPM<SnackbarVM> {\r\n static type = \"SnackbarPM\";\r\n\r\n /\r\n Gets the singleton instance of SnackbarPM\r\n * @param appObjects The application object repository\r\n * @returns The SnackbarPM instance or undefined if not found\r\n /\r\n static get(appObjects: AppObjectRepo) {\r\n return getSingletonComponent<SnackbarPM>(SnackbarPM.type, appObjects);\r\n }\r\n}\r\n\r\n/\r\n Creates a new SnackbarPM instance\r\n * @param appObject The application object\r\n * @returns A new SnackbarPM instance\r\n /\r\nexport function makeSnackbarPM(appObject: AppObject): SnackbarPM {\r\n return new SnackbarPMImp(appObject);\r\n}\r\n\r\n/\r\n Implementation of SnackbarPM\r\n * Manages the view model transformation and updates\r\n /\r\nclass SnackbarPMImp extends SnackbarPM {\r\n /\r\n Gets the cached singleton instance of SnackbarRepo\r\n /\r\n private get snackbarRepo() {\r\n return this.getCachedSingleton<SnackbarRepo>(SnackbarRepo.type);\r\n }\r\n\r\n /\r\n Compares two view models for equality\r\n * @param a First view model\r\n * @param b Second view model\r\n * @returns True if the view models are equal, false otherwise\r\n /\r\n vmsAreEqual(a: SnackbarVM, b: SnackbarVM): boolean {\r\n if (a.message !== b.message) return false;\r\n if (a.durationInSeconds !== b.durationInSeconds) return false;\r\n if (a.actionButtonText !== b.actionButtonText) return false;\r\n return true;\r\n }\r\n\r\n /\r\n Updates the view model based on the current snackbar state\r\n * Called whenever the snackbar repository changes\r\n /\r\n private updateView(): void {\r\n let model: SnackbarVM = {\r\n message: undefined,\r\n durationInSeconds: 0,\r\n actionButtonText: undefined\r\n };\r\n\r\n const snackbar = this.snackbarRepo?.getCurrentSnackbar();\r\n\r\n if (snackbar) {\r\n model = {\r\n message: snackbar.message,\r\n durationInSeconds: snackbar.durationInSeconds,\r\n actionButtonText: snackbar.snackbarAction\r\n ? snackbar.snackbarAction.actionButtonText\r\n : undefined\r\n };\r\n }\r\n\r\n this.doUpdateView(model);\r\n }\r\n\r\n /\r\n Creates a new SnackbarPMImp instance\r\n * @param appObject The application object\r\n /\r\n constructor(appObject: AppObject) {\r\n super(appObject, SnackbarPM.type);\r\n\r\n this.updateView(); // Initialize the lastVM\r\n this.snackbarRepo?.addChangeObserver(this.updateView.bind(this));\r\n this.appObjects.registerSingleton(this);\r\n }\r\n}\r\n\r\n/\r\n Default empty view model used when no snackbar is active\r\n */\r\nexport const defaultSnackbarVM: SnackbarVM = {\r\n message: undefined,\r\n durationInSeconds: 0,\r\n actionButtonText: undefined\r\n};\r\n"]}

package/dist/esm/StateMachine/Entities/HostEditingStateEntity.js CHANGED Viewed

@@ -11,6 +11,12 @@ export function makeHostEditingStateEntity(appObject) {
     return new HostEditingStateEntityImp(appObject);
 }
 class HostEditingStateEntityImp extends HostEditingStateEntity {
+    get editingState() {
+        return this._editingState;
+    }
+    get isEditing() {
+        return this._editingState !== undefined;
+    }
     get isNewState() {
         return this._isNewState;
     }
@@ -29,12 +35,6 @@ class HostEditingStateEntityImp extends HostEditingStateEntity {
     get somethingHasChanged() {
         return this.memoizedSomethingHasChanged.val;
     }
-    get isEditing() {
-        return this._editingState !== undefined;
-    }
-    get editingState() {
-        return this._editingState;
-    }
     constructor(appObject) {
         super(appObject, HostEditingStateEntity.type);
         this._isNewState = false;

package/dist/esm/StateMachine/Entities/HostEditingStateEntity.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"HostEditingStateEntity.js","sourceRoot":"","sources":["../../../../src/StateMachine/Entities/HostEditingStateEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,qBAAqB,EAErB,eAAe,EAEhB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,OAAgB,sBAAuB,SAAQ,eAAe;IAclE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,sBAAsB,CAAC,IAAI,EAC3B,UAAU,CACX,CAAC;IACJ,CAAC;;AAlBM,2BAAI,GAAG,wBAAwB,CAAC;AAqBzC,MAAM,UAAU,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,yBAA0B,SAAQ,sBAAsB;~~IAE5D~~,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAGD,IAAI,sBAAsB;QACxB,OAAO,IAAI,CAAC,uBAAuB,CAAC;IACtC,CAAC;~~IAED~~,IAAI,sBAAsB,CAAC,GAAuB;QAChD,IAAI,IAAI,CAAC,uBAAuB,KAAK,GAAG;YAAE,OAAO;QAEjD,IAAI,CAAC,uBAAuB,GAAG,GAAG,CAAC;QACnC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,IAAY,gBAAgB;QAC1B,OAAO,IAAI,CAAC,kBAAkB,CAAmB,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAMD,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC;IAC9C,CAAC;~~IAsCD~~,~~IAAI,SAAS;QACX,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC;IAC1C,CAAC;IAID,IAAI,~~YAAY~~;QACd~~,~~OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAoDD,YAAY,~~SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;~~QA9HxC~~,gBAAW,GAAG,KAAK,CAAC;~~QAqBpB~~,gCAA2B,GAAG,IAAI,eAAe,CACvD,KAAK,EACL,IAAI,CAAC,cAAc,CACpB,CAAC;QAKM,mBAAc,GAAG,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,aAAa;gBAAE,OAAO,KAAK,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,iBAAiB;gBAAE,OAAO,IAAI,CAAC;YAEzC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,IAAI,CAAC,iBAAiB,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YAEzE,IAAI,IAAI,CAAC,aAAa,CAAC,gBAAgB,KAAK,IAAI,CAAC,iBAAiB,CAAC,QAAQ;gBACzE,OAAO,IAAI,CAAC;YAEd,IACE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM;gBAEzE,OAAO,IAAI,CAAC;YACd,IAAI,iBAAiB,GAAG,KAAK,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE;gBACtD,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC1D,IAAI,eAAe,KAAK,cAAc,EAAE,CAAC;oBACvC,iBAAiB,GAAG,IAAI,CAAC;gBAC3B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,iBAAiB,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YACvE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YACxE,IAAI,iBAAiB,KAAK,YAAY;gBAAE,OAAO,IAAI,CAAC;YAEpD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QAEM,wBAAmB,GAAG,GAAS,EAAE;YACvC,IAAI,CAAC,2BAA2B,CAAC,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/D,CAAC,CAAC;~~QAcF~~,kBAAa,GAAG,GAAgC,EAAE;YAChD,IAAI,CAAC,IAAI,CAAC,gBAAgB;gBAAE,OAAO;YAEnC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC;YAC5D,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAC/D,IAAI,CAAC,2BAA2B,CAAC,GAAG,GAAG,IAAI,CAAC;YAE5C,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC,CAAC;QAEF,iBAAY,GAAG,CAAC,KAAsB,EAAQ,EAAE;YAC9C,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;YAE3B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACxC,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAE/D,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,oBAAe,GAAG,GAAS,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,aAAa;gBAAE,OAAO;YAEhC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;YAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC,CAAC;QAEF,kBAAa,GAAG,GAAS,EAAE;YACzB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC,CAAC;QAEM,uBAAkB,GAAG,GAAG,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,aAAa;gBAAE,OAAO;YAEhC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAClE,IAAI,CAAC,uBAAuB,GAAG,SAAS,CAAC;YACzC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,IAAI,CAAC,2BAA2B,CAAC,GAAG,GAAG,KAAK,CAAC;YAC7C,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC;QAIA,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { MemoizedBoolean } from \"@vived/core\";\r\nimport {\r\n getSingletonComponent,\r\n AppObject,\r\n AppObjectEntity,\r\n AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { HostStateEntity, StateDTO } from \"./HostStateEntity\";\r\nimport { HostStateMachine } from \"./HostStateMachine\";\r\n\r\nexport abstract class HostEditingStateEntity extends AppObjectEntity {\r\n static type = \"HostEditingStateEntity\";\r\n\r\n abstract get isEditing(): boolean;\r\n abstract get isNewState(): boolean;\r\n abstract get editingState(): HostStateEntity \| undefined;\r\n abstract get somethingHasChanged(): boolean;\r\n abstract stateValidationMessage?: string;\r\n\r\n abstract startNewState(): HostStateEntity \| undefined;\r\n abstract startEditing(state: HostStateEntity): void;\r\n abstract cancelEditState(): void;\r\n abstract finishEditing(): void;\r\n\r\n static get(appObjects: AppObjectRepo) {\r\n return getSingletonComponent<HostEditingStateEntity>(\r\n HostEditingStateEntity.type,\r\n appObjects\r\n );\r\n }\r\n}\r\n\r\nexport function makeHostEditingStateEntity(\r\n appObject: AppObject\r\n): HostEditingStateEntity {\r\n return new HostEditingStateEntityImp(appObject);\r\n}\r\n\r\nclass HostEditingStateEntityImp extends HostEditingStateEntity {\r\n private _isNewState = false;\r\n get isNewState(): boolean {\r\n return this._isNewState;\r\n }\r\n private _stateValidationMessage?: string \| undefined;\r\n~~\r\n~~ get stateValidationMessage(): string \| undefined {\r\n return this._stateValidationMessage;\r\n }\r\n~~\r\n~~ set stateValidationMessage(val: string \| undefined) {\r\n if (this._stateValidationMessage === val) return;\r\n\r\n this._stateValidationMessage = val;\r\n this.notifyOnChange();\r\n }\r\n\r\n private get hostStateMachine() {\r\n return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n }\r\n\r\n private memoizedSomethingHasChanged = new MemoizedBoolean(\r\n false,\r\n this.notifyOnChange\r\n );\r\n get somethingHasChanged(): boolean {\r\n return this.memoizedSomethingHasChanged.val;\r\n }\r\n\r\n private checkForChange = () => {\r\n if (!this._editingState) return false;\r\n if (!this.originalStateData) return true;\r\n\r\n if (this._editingState.name !== this.originalStateData.name) return true;\r\n\r\n if (this._editingState.expectedResponse !== this.originalStateData.response)\r\n return true;\r\n\r\n if (\r\n this._editingState.assets.length !== this.originalStateData.assets.length\r\n )\r\n return true;\r\n let assetsHaveChanged = false;\r\n this._editingState.assets.forEach((currentAssetID, i) => {\r\n const originalAssetId = this.originalStateData!.assets[i];\r\n if (originalAssetId !== currentAssetID) {\r\n assetsHaveChanged = true;\r\n }\r\n });\r\n\r\n if (assetsHaveChanged) {\r\n return true;\r\n }\r\n\r\n const currentDataString = JSON.stringify(this._editingState.stateData);\r\n const originalData = JSON.stringify(this.originalStateData?.data ?? \"\");\r\n if (currentDataString !== originalData) return true;\r\n\r\n return false;\r\n };\r\n\r\n private onStateEntityChange = (): void => {\r\n this.memoizedSomethingHasChanged.val = this.checkForChange();\r\n };\r\n\r\n get isEditing(): boolean {\r\n return this._editingState !== undefined;\r\n }\r\n\r\n private _editingState?: HostStateEntity;\r\n\r\n get editingState() {\r\n return this._editingState;\r\n }\r\n\r\n private originalStateData?: StateDTO;\r\n\r\n startNewState = (): HostStateEntity \| undefined => {\r\n if (!this.hostStateMachine) return;\r\n\r\n this.originalStateData = undefined;\r\n this._isNewState = true;\r\n this._editingState = this.hostStateMachine.createNewState();\r\n this._editingState.addChangeObserver(this.onStateEntityChange);\r\n this.memoizedSomethingHasChanged.val = true;\r\n\r\n return this._editingState;\r\n };\r\n\r\n startEditing = (state: HostStateEntity): void => {\r\n this._editingState = state;\r\n\r\n this.originalStateData = state.getDTO();\r\n this._editingState.addChangeObserver(this.onStateEntityChange);\r\n\r\n this.notifyOnChange();\r\n };\r\n\r\n cancelEditState = (): void => {\r\n if (!this._editingState) return;\r\n\r\n if (this.originalStateData) {\r\n this._editingState.setDTO(this.originalStateData);\r\n } else {\r\n this.hostStateMachine?.deleteState(this._editingState.id);\r\n }\r\n\r\n this.resetInternalState();\r\n };\r\n\r\n finishEditing = (): void => {\r\n this.resetInternalState();\r\n };\r\n\r\n private resetInternalState = () => {\r\n if (!this._editingState) return;\r\n\r\n this._isNewState = false;\r\n this._editingState.removeChangeObserver(this.onStateEntityChange);\r\n this._stateValidationMessage = undefined;\r\n this._editingState = undefined;\r\n this.memoizedSomethingHasChanged.val = false;\r\n this.notifyOnChange();\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, HostEditingStateEntity.type);\r\n this.appObjects.registerSingleton(this);\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"HostEditingStateEntity.js","sourceRoot":"","sources":["../../../../src/StateMachine/Entities/HostEditingStateEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import { MemoizedBoolean } from \"@vived/core\";\r\nimport {\r\n getSingletonComponent,\r\n AppObject,\r\n AppObjectEntity,\r\n AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { HostStateEntity, StateDTO } from \"./HostStateEntity\";\r\nimport { HostStateMachine } from \"./HostStateMachine\";\r\n\r\nexport abstract class HostEditingStateEntity extends AppObjectEntity {\r\n static type = \"HostEditingStateEntity\";\r\n\r\n abstract get isEditing(): boolean;\r\n abstract get isNewState(): boolean;\r\n abstract get editingState(): HostStateEntity \| undefined;\r\n abstract get somethingHasChanged(): boolean;\r\n abstract stateValidationMessage?: string;\r\n\r\n abstract startNewState(): HostStateEntity \| undefined;\r\n abstract startEditing(state: HostStateEntity): void;\r\n abstract cancelEditState(): void;\r\n abstract finishEditing(): void;\r\n\r\n static get(appObjects: AppObjectRepo) {\r\n return getSingletonComponent<HostEditingStateEntity>(\r\n HostEditingStateEntity.type,\r\n appObjects\r\n );\r\n }\r\n}\r\n\r\nexport function makeHostEditingStateEntity(\r\n appObject: AppObject\r\n): HostEditingStateEntity {\r\n return new HostEditingStateEntityImp(appObject);\r\n}\r\n\r\nclass HostEditingStateEntityImp extends HostEditingStateEntity {\r\n private originalStateData?: StateDTO;\r\n \r\n private _editingState?: HostStateEntity;\r\n get editingState() {\r\n return this._editingState;\r\n }\r\n\r\n get isEditing(): boolean {\r\n return this._editingState !== undefined;\r\n }\r\n\r\n private _isNewState = false;\r\n get isNewState(): boolean {\r\n return this._isNewState;\r\n }\r\n\r\n private _stateValidationMessage?: string \| undefined;\r\n get stateValidationMessage(): string \| undefined {\r\n return this._stateValidationMessage;\r\n }\r\n set stateValidationMessage(val: string \| undefined) {\r\n if (this._stateValidationMessage === val) return;\r\n\r\n this._stateValidationMessage = val;\r\n this.notifyOnChange();\r\n }\r\n\r\n private get hostStateMachine() {\r\n return this.getCachedSingleton<HostStateMachine>(HostStateMachine.type);\r\n }\r\n\r\n private memoizedSomethingHasChanged = new MemoizedBoolean(\r\n false,\r\n this.notifyOnChange\r\n );\r\n get somethingHasChanged(): boolean {\r\n return this.memoizedSomethingHasChanged.val;\r\n }\r\n\r\n private checkForChange = () => {\r\n if (!this._editingState) return false;\r\n if (!this.originalStateData) return true;\r\n\r\n if (this._editingState.name !== this.originalStateData.name) return true;\r\n\r\n if (this._editingState.expectedResponse !== this.originalStateData.response)\r\n return true;\r\n\r\n if (\r\n this._editingState.assets.length !== this.originalStateData.assets.length\r\n )\r\n return true;\r\n let assetsHaveChanged = false;\r\n this._editingState.assets.forEach((currentAssetID, i) => {\r\n const originalAssetId = this.originalStateData!.assets[i];\r\n if (originalAssetId !== currentAssetID) {\r\n assetsHaveChanged = true;\r\n }\r\n });\r\n\r\n if (assetsHaveChanged) {\r\n return true;\r\n }\r\n\r\n const currentDataString = JSON.stringify(this._editingState.stateData);\r\n const originalData = JSON.stringify(this.originalStateData?.data ?? \"\");\r\n if (currentDataString !== originalData) return true;\r\n\r\n return false;\r\n };\r\n\r\n private onStateEntityChange = (): void => {\r\n this.memoizedSomethingHasChanged.val = this.checkForChange();\r\n };\r\n\r\n startNewState = (): HostStateEntity \| undefined => {\r\n if (!this.hostStateMachine) return;\r\n\r\n this.originalStateData = undefined;\r\n this._isNewState = true;\r\n this._editingState = this.hostStateMachine.createNewState();\r\n this._editingState.addChangeObserver(this.onStateEntityChange);\r\n this.memoizedSomethingHasChanged.val = true;\r\n\r\n return this._editingState;\r\n };\r\n\r\n startEditing = (state: HostStateEntity): void => {\r\n this._editingState = state;\r\n\r\n this.originalStateData = state.getDTO();\r\n this._editingState.addChangeObserver(this.onStateEntityChange);\r\n\r\n this.notifyOnChange();\r\n };\r\n\r\n cancelEditState = (): void => {\r\n if (!this._editingState) return;\r\n\r\n if (this.originalStateData) {\r\n this._editingState.setDTO(this.originalStateData);\r\n } else {\r\n this.hostStateMachine?.deleteState(this._editingState.id);\r\n }\r\n\r\n this.resetInternalState();\r\n };\r\n\r\n finishEditing = (): void => {\r\n this.resetInternalState();\r\n };\r\n\r\n private resetInternalState = () => {\r\n if (!this._editingState) return;\r\n\r\n this._isNewState = false;\r\n this._editingState.removeChangeObserver(this.onStateEntityChange);\r\n this._stateValidationMessage = undefined;\r\n this._editingState = undefined;\r\n this.memoizedSomethingHasChanged.val = false;\r\n this.notifyOnChange();\r\n };\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, HostEditingStateEntity.type);\r\n this.appObjects.registerSingleton(this);\r\n }\r\n}\r\n"]}

package/dist/esm/ZSpaceHost/Entities/ZSpaceHost.js CHANGED Viewed

@@ -1,14 +1,48 @@
 import { MemoizedBoolean } from "@vived/core";
 import { getSingletonComponent, AppObjectEntity } from "@vived/core";
+/**
+ * ZSpaceHostEntity is a singleton entity that manages the state and functionality
+ * for zSpace integration in VIVED applications.
+ *
+ * This entity handles:
+ * 1. zSpace feature detection (isSupported)
+ * 2. Emulation mode toggling (emulate)
+ * 3. Active state management (isActive)
+ * 4. XR Session management
+ *
+ * Usage:
+ * - To check if zSpace is available: ZSpaceHostEntity.get(appObjects)?.isSupported
+ * - To check if zSpace is active: ZSpaceHostEntity.get(appObjects)?.isActive
+ * - To enable/disable emulation: ZSpaceHostEntity.get(appObjects).emulate = true/false
+ *
+ * Important: This is a singleton entity - only one instance exists in the application.
+ * Always access via ZSpaceHostEntity.get(appObjects) rather than creating new instances.
+ */
 export class ZSpaceHostEntity extends AppObjectEntity {
+    /**
+     * Get the singleton ZSpaceHostEntity instance
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The ZSpaceHostEntity instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(ZSpaceHostEntity.type, appObjects);
     }
 }
 ZSpaceHostEntity.type = "ZSpaceHostEntity";
+/**
+ * Factory function to create the ZSpaceHostEntity
+ * For internal use only - external code should use ZSpaceHostEntity.get()
+ *
+ * @param appObject - The AppObject to attach the entity to
+ * @returns A new ZSpaceHostEntity instance
+ */
 export function makeZSpaceHostEntity(appObject) {
     return new ZSpaceHostImp(appObject);
 }
+/**
+ * Implementation of ZSpaceHostEntity
+ * Uses MemoizedBoolean for all properties to ensure proper change notifications
+ */
 class ZSpaceHostImp extends ZSpaceHostEntity {
     get isSupported() {
         return this.memoizedIsSupported.val;

package/dist/esm/ZSpaceHost/Entities/ZSpaceHost.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ZSpaceHost.js","sourceRoot":"","sources":["../../../../src/ZSpaceHost/Entities/ZSpaceHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,qBAAqB,EAErB,eAAe,EAEhB,MAAM,aAAa,CAAC;AAErB,MAAM,OAAgB,gBAAiB,SAAQ,eAAe;~~IAc5D~~,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,gBAAgB,CAAC,IAAI,EACrB,UAAU,CACX,CAAC;IACJ,CAAC;;~~AAlBM~~,qBAAI,GAAG,kBAAkB,CAAC;~~AAqBnC~~,MAAM,UAAU,oBAAoB,CAAC,SAAoB;IACvD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,gBAAgB;IAE1C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC;IACtC,CAAC;IACD,IAAI,WAAW,CAAC,GAAY;QAC1B,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,GAAG,CAAC;IACrC,CAAC;IAGD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,GAAY;QACtB,IAAI,CAAC,eAAe,CAAC,GAAG,GAAG,GAAG,CAAC;IACjC,CAAC;IAGD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;IACjC,CAAC;IACD,IAAI,QAAQ,CAAC,GAAY;QACvB,IAAI,CAAC,cAAc,CAAC,GAAG,GAAG,GAAG,CAAC;IAChC,CAAC;IAID,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QA3BlC,wBAAmB,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAQtE,oBAAe,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAQjE,mBAAc,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAYvE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { MemoizedBoolean } from \"@vived/core\";\r\nimport {\r\n getSingletonComponent,\r\n AppObject,\r\n AppObjectEntity,\r\n AppObjectRepo\r\n} from \"@vived/core\";\r\n\r\nexport abstract class ZSpaceHostEntity extends AppObjectEntity {\r\n static type = \"ZSpaceHostEntity\";\r\n\r\n abstract get isSupported(): boolean;\r\n abstract set isSupported(val: boolean);\r\n\r\n abstract get emulate(): boolean;\r\n abstract set emulate(val: boolean);\r\n\r\n abstract get isActive(): boolean;\r\n abstract set isActive(val: boolean);\r\n\r\n abstract session: XRSession \| undefined;\r\n\r\n static get(appObjects: AppObjectRepo) {\r\n return getSingletonComponent<ZSpaceHostEntity>(\r\n ZSpaceHostEntity.type,\r\n appObjects\r\n );\r\n }\r\n}\r\n\r\nexport function makeZSpaceHostEntity(appObject: AppObject): ZSpaceHostEntity {\r\n return new ZSpaceHostImp(appObject);\r\n}\r\n\r\nclass ZSpaceHostImp extends ZSpaceHostEntity {\r\n private memoizedIsSupported = new MemoizedBoolean(false, this.notifyOnChange);\r\n get isSupported(): boolean {\r\n return this.memoizedIsSupported.val;\r\n }\r\n set isSupported(val: boolean) {\r\n this.memoizedIsSupported.val = val;\r\n }\r\n\r\n private memoizedEmulate = new MemoizedBoolean(true, this.notifyOnChange);\r\n get emulate(): boolean {\r\n return this.memoizedEmulate.val;\r\n }\r\n set emulate(val: boolean) {\r\n this.memoizedEmulate.val = val;\r\n }\r\n\r\n private memoizedActive = new MemoizedBoolean(false, this.notifyOnChange);\r\n get isActive(): boolean {\r\n return this.memoizedActive.val;\r\n }\r\n set isActive(val: boolean) {\r\n this.memoizedActive.val = val;\r\n }\r\n\r\n session: XRSession \| undefined;\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, ZSpaceHostEntity.type);\r\n this.appObjects.registerSingleton(this);\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"ZSpaceHost.js","sourceRoot":"","sources":["../../../../src/ZSpaceHost/Entities/ZSpaceHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,qBAAqB,EAErB,eAAe,EAEhB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,eAAe;IA6B5D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAC1B,gBAAgB,CAAC,IAAI,EACrB,UAAU,CACX,CAAC;IACJ,CAAC;;AAtCM,qBAAI,GAAG,kBAAkB,CAAC;AAyCnC;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAoB;IACvD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,aAAc,SAAQ,gBAAgB;IAE1C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC;IACtC,CAAC;IACD,IAAI,WAAW,CAAC,GAAY;QAC1B,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,GAAG,CAAC;IACrC,CAAC;IAGD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,GAAY;QACtB,IAAI,CAAC,eAAe,CAAC,GAAG,GAAG,GAAG,CAAC;IACjC,CAAC;IAGD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;IACjC,CAAC;IACD,IAAI,QAAQ,CAAC,GAAY;QACvB,IAAI,CAAC,cAAc,CAAC,GAAG,GAAG,GAAG,CAAC;IAChC,CAAC;IAID,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QA3BlC,wBAAmB,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAQtE,oBAAe,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAQjE,mBAAc,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAYvE,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { MemoizedBoolean } from \"@vived/core\";\r\nimport {\r\n getSingletonComponent,\r\n AppObject,\r\n AppObjectEntity,\r\n AppObjectRepo\r\n} from \"@vived/core\";\r\n\r\n/*\r\n ZSpaceHostEntity is a singleton entity that manages the state and functionality\r\n * for zSpace integration in VIVED applications.\r\n \r\n This entity handles:\r\n * 1. zSpace feature detection (isSupported)\r\n * 2. Emulation mode toggling (emulate)\r\n * 3. Active state management (isActive)\r\n * 4. XR Session management\r\n \r\n Usage:\r\n * - To check if zSpace is available: ZSpaceHostEntity.get(appObjects)?.isSupported\r\n * - To check if zSpace is active: ZSpaceHostEntity.get(appObjects)?.isActive\r\n * - To enable/disable emulation: ZSpaceHostEntity.get(appObjects).emulate = true/false\r\n \r\n Important: This is a singleton entity - only one instance exists in the application.\r\n * Always access via ZSpaceHostEntity.get(appObjects) rather than creating new instances.\r\n /\r\nexport abstract class ZSpaceHostEntity extends AppObjectEntity {\r\n static type = \"ZSpaceHostEntity\";\r\n\r\n /\r\n Whether zSpace hardware is supported in the current environment\r\n /\r\n abstract get isSupported(): boolean;\r\n abstract set isSupported(val: boolean);\r\n\r\n /\r\n Whether to emulate zSpace hardware when not available\r\n * When true, the system will simulate zSpace capabilities\r\n /\r\n abstract get emulate(): boolean;\r\n abstract set emulate(val: boolean);\r\n\r\n /\r\n Whether zSpace is currently active\r\n * This is true when either real zSpace hardware is active\r\n * or when emulation is enabled\r\n /\r\n abstract get isActive(): boolean;\r\n abstract set isActive(val: boolean);\r\n\r\n /\r\n The current XR Session if zSpace is active\r\n /\r\n abstract session: XRSession \| undefined;\r\n\r\n /\r\n Get the singleton ZSpaceHostEntity instance\r\n * @param appObjects - The AppObjectRepo instance\r\n * @returns The ZSpaceHostEntity instance or undefined if not found\r\n /\r\n static get(appObjects: AppObjectRepo) {\r\n return getSingletonComponent<ZSpaceHostEntity>(\r\n ZSpaceHostEntity.type,\r\n appObjects\r\n );\r\n }\r\n}\r\n\r\n/\r\n Factory function to create the ZSpaceHostEntity\r\n * For internal use only - external code should use ZSpaceHostEntity.get()\r\n \r\n @param appObject - The AppObject to attach the entity to\r\n * @returns A new ZSpaceHostEntity instance\r\n /\r\nexport function makeZSpaceHostEntity(appObject: AppObject): ZSpaceHostEntity {\r\n return new ZSpaceHostImp(appObject);\r\n}\r\n\r\n/\r\n Implementation of ZSpaceHostEntity\r\n * Uses MemoizedBoolean for all properties to ensure proper change notifications\r\n */\r\nclass ZSpaceHostImp extends ZSpaceHostEntity {\r\n private memoizedIsSupported = new MemoizedBoolean(false, this.notifyOnChange);\r\n get isSupported(): boolean {\r\n return this.memoizedIsSupported.val;\r\n }\r\n set isSupported(val: boolean) {\r\n this.memoizedIsSupported.val = val;\r\n }\r\n\r\n private memoizedEmulate = new MemoizedBoolean(true, this.notifyOnChange);\r\n get emulate(): boolean {\r\n return this.memoizedEmulate.val;\r\n }\r\n set emulate(val: boolean) {\r\n this.memoizedEmulate.val = val;\r\n }\r\n\r\n private memoizedActive = new MemoizedBoolean(false, this.notifyOnChange);\r\n get isActive(): boolean {\r\n return this.memoizedActive.val;\r\n }\r\n set isActive(val: boolean) {\r\n this.memoizedActive.val = val;\r\n }\r\n\r\n session: XRSession \| undefined;\r\n\r\n constructor(appObject: AppObject) {\r\n super(appObject, ZSpaceHostEntity.type);\r\n this.appObjects.registerSingleton(this);\r\n }\r\n}\r\n"]}

package/dist/esm/ZSpaceHost/PMs/EmulateZSpacePM.js CHANGED Viewed

@@ -1,11 +1,57 @@
 import { getSingletonComponent, AppObjectPM } from "@vived/core";
 import { ZSpaceHostEntity } from "../Entities";
+/**
+ * EmulateZSpacePM is a singleton Presentation Manager that provides a boolean view model
+ * indicating whether zSpace emulation is currently enabled.
+ *
+ * This PM allows UI components to observe and (through controllers) control whether
+ * zSpace features should be emulated when actual zSpace hardware is not available.
+ *
+ * Usage in UI components:
+ * 1. Via direct PM access (not recommended for UI components):
+ *    const pm = EmulateZSpacePM.get(appObjects);
+ *    pm?.addView((isEmulating) => { updateUIBasedOn(isEmulating); });
+ *
+ * 2. Via adapter (recommended for React/UI components):
+ *    import { emulateZSpacePMAdapter } from "../Adapters";
+ *
+ *    // In a React component:
+ *    const [isEmulating, setIsEmulating] = useState(emulateZSpacePMAdapter.defaultVM);
+ *
+ *    useEffect(() => {
+ *      emulateZSpacePMAdapter.subscribe(appObjects, setIsEmulating);
+ *      return () => emulateZSpacePMAdapter.unsubscribe(appObjects, setIsEmulating);
+ *    }, [appObjects]);
+ *
+ * 3. To toggle emulation state (in a controller or UI event handler):
+ *    import { toggleEmulateZSpace } from "../Controllers";
+ *
+ *    // When handling a UI event:
+ *    const handleToggleEmulation = () => {
+ *      toggleEmulateZSpace(appObjects);
+ *    };
+ *
+ * Emulation is useful during development or when testing on systems without zSpace hardware.
+ * When emulation is enabled, many zSpace-specific UI features can still be tested.
+ */
 export class EmulateZSpacePM extends AppObjectPM {
+    /**
+     * Get the singleton instance of EmulateZSpacePM
+     * @param appObjects - The AppObjectRepo instance
+     * @returns The EmulateZSpacePM instance or undefined if not found
+     */
     static get(appObjects) {
         return getSingletonComponent(EmulateZSpacePM.type, appObjects);
     }
 }
 EmulateZSpacePM.type = "EmulateZSpacePM";
+/**
+ * Factory function to create the EmulateZSpacePM
+ * For internal use only - external code should use EmulateZSpacePM.get()
+ *
+ * @param appObject - The AppObject to attach the PM to
+ * @returns A new EmulateZSpacePM instance
+ */
 export function makeEmulateZSpacePM(appObject) {
     return new EmulateZSpacePMImp(appObject);
 }
@@ -13,6 +59,9 @@ class EmulateZSpacePMImp extends EmulateZSpacePM {
     vmsAreEqual(a, b) {
         return a === b;
     }
+    get zSpace() {
+        return this.getCachedSingleton(ZSpaceHostEntity.type);
+    }
     constructor(appObject) {
         super(appObject, EmulateZSpacePM.type);
         this.onEntityChange = () => {
@@ -20,12 +69,12 @@ class EmulateZSpacePMImp extends EmulateZSpacePM {
                 return;
             this.doUpdateView(this.zSpace.emulate);
         };
-        this.zSpace = appObject.getComponent(ZSpaceHostEntity.type);
-        if (!this.zSpace) {
+        const zSpace = this.zSpace;
+        if (!zSpace) {
             this.error("PM Has been added to an app object that does not have a ZSpaceHostEntity");
             return;
         }
-        this.zSpace.addChangeObserver(this.onEntityChange);
+        zSpace.addChangeObserver(this.onEntityChange);
         this.onEntityChange();
         this.appObjects.registerSingleton(this);
     }