@vived/host 4.1.0 → 4.3.0

package/dist/cjs/Snackbar/Controllers/makeSnackbar.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeSnackbar = makeSnackbar;
+const SnackbarRepo_1 = require("../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)
+ */
+function makeSnackbar(appObjects, message, snackbarAction, durationInSeconds) {
+    const repo = SnackbarRepo_1.SnackbarRepo.get(appObjects);
+    if (repo) {
+        repo.makeSnackbar(message, snackbarAction, durationInSeconds);
+    }
+    else {
+        appObjects.submitError("makeSnackbar", "Unable to find SnackbarRepo");
+    }
+}
+//# sourceMappingURL=makeSnackbar.js.map

package/dist/cjs/Snackbar/Controllers/makeSnackbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Controllers/makeSnackbar.ts"],"names":[],"mappings":";;AAWA,oCAYC;AAtBD,2DAAwE;AAExE;;;;;;;GAOG;AACH,SAAgB,YAAY,CAC1B,UAAyB,EACzB,OAAe,EACf,cAA+B,EAC/B,iBAA0B;IAE1B,MAAM,IAAI,GAAG,2BAAY,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/cjs/Snackbar/Entities/SnackbarRepo.js

@@ -3,66 +3,111 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SnackbarRepo = void 0;
 exports.makeSnackbarRepo = makeSnackbarRepo;
 const core_1 = require("@vived/core");
+/**
+ * Repository for managing snackbar notifications
+ * Handles creating, displaying, and dismissing snackbars
+ */
 class SnackbarRepo extends core_1.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 (0, core_1.getSingletonComponent)(SnackbarRepo.type, appObjects);
     }
 }
 exports.SnackbarRepo = SnackbarRepo;
 SnackbarRepo.type = "SnackbarRepo";
+/**
+ * Creates a new SnackbarRepo instance
+ * @param appObject The application object
+ * @returns A new SnackbarRepo instance
+ */
 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/cjs/Snackbar/Entities/SnackbarRepo.js.map

@@ -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"]}
+{"version":3,"file":"SnackbarRepo.js","sourceRoot":"","sources":["../../../../src/Snackbar/Entities/SnackbarRepo.ts"],"names":[],"mappings":";;;AAqFA,4CAEC;AAvFD,sCAKqB;AA6BrB;;;GAGG;AACH,MAAsB,YAAa,SAAQ,sBAAe;IAGxD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAe,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5E,CAAC;;AAVH,oCAwCC;AAvCQ,iBAAI,GAAG,cAAc,CAAC;AAyC/B;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,SAAoB;IACnD,OAAO,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,eAAgB,SAAQ,YAAY;IAQxC;;;;OAIG;IACH,YAAY,SAAoB,EAAE,2BAAmC,CAAC;QACpE,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QATtC,yDAAyD;QACjD,2BAAsB,GAAY,KAAK,CAAC;QAS9C,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,wBAAwB,GAAG,wBAAwB,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,YAAY,CACV,OAAe,EACf,cAA2C,EAC3C,iBAAsC;QAEtC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,cAAc,IAAI,cAAc,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC,IAAI,CACP,yEAAyE,CAC1E,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,IAAI,IAAI,CAAC,wBAAwB,CAAC;QACpE,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,wCAAwC,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAa;YACzB,OAAO;YACP,iBAAiB,EAAE,QAAQ;YAC3B,cAAc;SACf,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAE3B,OAAO;IACT,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,wBAAwB;QACtB,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAClD,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,eAAe,CAAC,cAAc,EAAE,CAAC;gBACnC,eAAe,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;gBACxC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,mBAAmB;QAC/B,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,sBAAsB,GAAW,GAAG,CAAC;QAC3C,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;QAEnC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAClD,IAAI,eAAe,EAAE,CAAC;gBACpB,IAAI,cAAc,GAAG,eAAe,CAAC,iBAAiB,CAAC;gBACvD,OACE,IAAI,CAAC,kBAAkB,EAAE,KAAK,eAAe;oBAC7C,cAAc,GAAG,CAAC,EAClB,CAAC;oBACD,gDAAgD;oBAChD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC,CACnD,CAAC;oBACF,cAAc,IAAI,sBAAsB,CAAC;gBAC3C,CAAC;gBACD,IACE,IAAI,CAAC,kBAAkB,EAAE,KAAK,eAAe;oBAC7C,cAAc,IAAI,CAAC,EACnB,CAAC;oBACD,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC;IACtC,CAAC;CACF","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/cjs/Snackbar/Factories/setupSnackbar.js

@@ -3,6 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupSnackbar = setupSnackbar;
 const Entities_1 = require("../Entities");
 const PMs_1 = require("../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
+ */
 function setupSnackbar(appObjects) {
     const ao = appObjects.getOrCreate("Snackbar");
     // Entities

package/dist/cjs/Snackbar/Factories/setupSnackbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"setupSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Factories/setupSnackbar.ts"],"names":[],"mappings":";;AAIA,sCAQC;AAXD,0CAA+C;AAC/C,gCAAwC;AAExC,SAAgB,aAAa,CAAC,UAAyB;IACrD,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE9C,WAAW;IACX,IAAA,2BAAgB,EAAC,EAAE,CAAC,CAAC;IAErB,MAAM;IACN,IAAA,oBAAc,EAAC,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"]}
+{"version":3,"file":"setupSnackbar.js","sourceRoot":"","sources":["../../../../src/Snackbar/Factories/setupSnackbar.ts"],"names":[],"mappings":";;AAUA,sCAQC;AAjBD,0CAA+C;AAC/C,gCAAwC;AAExC;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,UAAyB;IACrD,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE9C,WAAW;IACX,IAAA,2BAAgB,EAAC,EAAE,CAAC,CAAC;IAErB,MAAM;IACN,IAAA,oBAAc,EAAC,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/cjs/Snackbar/PMs/SnackbarPM.js

@@ -4,20 +4,47 @@ exports.defaultSnackbarVM = exports.SnackbarPM = void 0;
 exports.makeSnackbarPM = makeSnackbarPM;
 const core_1 = require("@vived/core");
 const SnackbarRepo_1 = require("../Entities/SnackbarRepo");
+/**
+ * Presentation Manager for snackbar notifications
+ * Transforms data from SnackbarRepo into view models for UI components
+ */
 class SnackbarPM extends core_1.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 (0, core_1.getSingletonComponent)(SnackbarPM.type, appObjects);
     }
 }
 exports.SnackbarPM = SnackbarPM;
 SnackbarPM.type = "SnackbarPM";
+/**
+ * Creates a new SnackbarPM instance
+ * @param appObject The application object
+ * @returns A new SnackbarPM instance
+ */
 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_1.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;
@@ -27,31 +54,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
+ */
 exports.defaultSnackbarVM = {
     message: undefined,
     durationInSeconds: 0,

package/dist/cjs/Snackbar/PMs/SnackbarPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"SnackbarPM.js","sourceRoot":"","sources":["../../../../src/Snackbar/PMs/SnackbarPM.ts"],"names":[],"mappings":";;;AAsBA,wCAEC;AAxBD,sCAKqB;AACrB,2DAAwD;AAQxD,MAAsB,UAAW,SAAQ,kBAAuB;IAG9D,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AALH,gCAMC;AALQ,eAAI,GAAG,YAAY,CAAC;AAO7B,SAAgB,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,2BAAY,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;AAEY,QAAA,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"]}
+{"version":3,"file":"SnackbarPM.js","sourceRoot":"","sources":["../../../../src/Snackbar/PMs/SnackbarPM.ts"],"names":[],"mappings":";;;AA2CA,wCAEC;AA7CD,sCAKqB;AACrB,2DAAwD;AAexD;;;GAGG;AACH,MAAsB,UAAW,SAAQ,kBAAuB;IAG9D;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAVH,gCAWC;AAVQ,eAAI,GAAG,YAAY,CAAC;AAY7B;;;;GAIG;AACH,SAAgB,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,2BAAY,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;AACU,QAAA,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/cjs/ThemeColors/Factories/index.js

@@ -14,5 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./setupThemeForSandbox"), exports);
+__exportStar(require("./setupTheme"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/ThemeColors/Factories/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ThemeColors/Factories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAsC","sourcesContent":["export * from \"./setupThemeForSandbox\""]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ThemeColors/Factories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B","sourcesContent":["export * from \"./setupTheme\""]}

package/dist/cjs/ThemeColors/Factories/{setupThemeForSandbox.js → setupTheme.js}

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupThemeForSandbox = setupThemeForSandbox;
+exports.setupTheme = setupTheme;
 const Data_1 = require("../Data");
 const Entities_1 = require("../Entities");
 const PM_1 = require("../PM");
 const UCs_1 = require("../UCs");
-function setupThemeForSandbox(appObjects) {
+function setupTheme(appObjects) {
     const ao = appObjects.getOrCreate("Theme");
     // Entities
     const theme = (0, Entities_1.makeHostThemeEntity)(ao);
@@ -17,4 +17,4 @@ function setupThemeForSandbox(appObjects) {
     theme.submitScheme("dark", Data_1.vivedDarkThemeData);
     setThemeUC.setThemeByName("light"); // Hardcoded for now
 }
-//# sourceMappingURL=setupThemeForSandbox.js.map
+//# sourceMappingURL=setupTheme.js.map

package/dist/cjs/ThemeColors/Factories/setupTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupTheme.js","sourceRoot":"","sources":["../../../../src/ThemeColors/Factories/setupTheme.ts"],"names":[],"mappings":";;AAMA,gCAgBC;AArBD,kCAAkE;AAClE,0CAAkD;AAClD,8BAA0C;AAC1C,gCAAwC;AAExC,SAAgB,UAAU,CAAC,UAAyB;IAClD,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAE3C,WAAW;IACX,MAAM,KAAK,GAAG,IAAA,8BAAmB,EAAC,EAAE,CAAC,CAAC;IAEtC,MAAM;IACN,MAAM,UAAU,GAAG,IAAA,oBAAc,EAAC,EAAE,CAAC,CAAC;IAEtC,MAAM;IACN,IAAA,sBAAiB,EAAC,EAAE,CAAC,CAAC;IAEtB,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,0BAAmB,CAAC,CAAC;IACjD,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,yBAAkB,CAAC,CAAC;IAE/C,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB;AAC1D,CAAC","sourcesContent":["import { AppObjectRepo } from \"@vived/core\";\r\nimport { vivedDarkThemeData, vivedLightThemeData } from \"../Data\";\r\nimport { makeHostThemeEntity } from \"../Entities\";\r\nimport { makeThemeColorsPM } from \"../PM\";\r\nimport { makeSetThemeUC } from \"../UCs\";\r\n\r\nexport function setupTheme(appObjects: AppObjectRepo) {\r\n  const ao = appObjects.getOrCreate(\"Theme\");\r\n\r\n  // Entities\r\n  const theme = makeHostThemeEntity(ao);\r\n\r\n  // UCs\r\n  const setThemeUC = makeSetThemeUC(ao);\r\n\r\n  // PMs\r\n  makeThemeColorsPM(ao);\r\n\r\n  theme.submitScheme(\"light\", vivedLightThemeData);\r\n  theme.submitScheme(\"dark\", vivedDarkThemeData);\r\n\r\n  setThemeUC.setThemeByName(\"light\"); // Hardcoded for now\r\n}\r\n"]}

package/dist/cjs/ThemeColors/UCs/SetThemeUC.js

@@ -24,7 +24,7 @@ class SetThemeUCImp extends SetThemeUC {
         this.theme.activeSchemeName = name;
     }
     tryDetectTheme() {
-        if (!this.theme)
+        if (!this.theme || !window.matchMedia)
             return;
         const darkThemeMq = window.matchMedia("(prefers-color-scheme: dark)");
         if (darkThemeMq.matches) {

package/dist/cjs/ThemeColors/UCs/SetThemeUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"SetThemeUC.js","sourceRoot":"","sources":["../../../../src/ThemeColors/UCs/SetThemeUC.ts"],"names":[],"mappings":";;;AAsBA,wCAEC;AAxBD,sCAKqB;AACrB,0CAA8C;AAE9C,MAAsB,UAAW,SAAQ,kBAAW;IASlD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAXH,gCAYC;AAXQ,eAAI,GAAG,YAAY,CAAC;AAa7B,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IAIpC,IAAY,KAAK;QACf,OAAO,IAAI,CAAC,kBAAkB,CAAkB,0BAAe,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACrC,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;QACtE,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;IACH,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAzBpC,mBAAc,GAAG,OAAO,CAAC;QACzB,kBAAa,GAAG,MAAM,CAAC;QAyBrB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { HostThemeEntity } from \"../Entities\";\r\n\r\nexport abstract class SetThemeUC extends AppObjectUC {\r\n  static type = \"SetThemeUC\";\r\n\r\n  abstract lightThemeName: string;\r\n  abstract darkThemeName: string;\r\n\r\n  abstract setThemeByName(name: string): void;\r\n  abstract tryDetectTheme(): void;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<SetThemeUC>(SetThemeUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeSetThemeUC(appObject: AppObject): SetThemeUC {\r\n  return new SetThemeUCImp(appObject);\r\n}\r\n\r\nclass SetThemeUCImp extends SetThemeUC {\r\n  lightThemeName = \"light\";\r\n  darkThemeName = \"dark\";\r\n\r\n  private get theme() {\r\n    return this.getCachedSingleton<HostThemeEntity>(HostThemeEntity.type);\r\n  }\r\n\r\n  setThemeByName(name: string): void {\r\n    if (!this.theme) return;\r\n\r\n    this.theme.activeSchemeName = name;\r\n  }\r\n\r\n  tryDetectTheme(): void {\r\n    if (!this.theme) return;\r\n\r\n    const darkThemeMq = window.matchMedia(\"(prefers-color-scheme: dark)\");\r\n    if (darkThemeMq.matches) {\r\n      this.theme.activeSchemeName = this.darkThemeName;\r\n    } else {\r\n      this.theme.activeSchemeName = this.darkThemeName;\r\n    }\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SetThemeUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SetThemeUC.js","sourceRoot":"","sources":["../../../../src/ThemeColors/UCs/SetThemeUC.ts"],"names":[],"mappings":";;;AAsBA,wCAEC;AAxBD,sCAKqB;AACrB,0CAA8C;AAE9C,MAAsB,UAAW,SAAQ,kBAAW;IASlD,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,IAAA,4BAAqB,EAAa,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAXH,gCAYC;AAXQ,eAAI,GAAG,YAAY,CAAC;AAa7B,SAAgB,cAAc,CAAC,SAAoB;IACjD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,aAAc,SAAQ,UAAU;IAIpC,IAAY,KAAK;QACf,OAAO,IAAI,CAAC,kBAAkB,CAAkB,0BAAe,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACrC,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO;QAE9C,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;QACtE,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC;QACnD,CAAC;IACH,CAAC;IAED,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAzBpC,mBAAc,GAAG,OAAO,CAAC;QACzB,kBAAa,GAAG,MAAM,CAAC;QAyBrB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectRepo,\r\n  AppObjectUC\r\n} from \"@vived/core\";\r\nimport { HostThemeEntity } from \"../Entities\";\r\n\r\nexport abstract class SetThemeUC extends AppObjectUC {\r\n  static type = \"SetThemeUC\";\r\n\r\n  abstract lightThemeName: string;\r\n  abstract darkThemeName: string;\r\n\r\n  abstract setThemeByName(name: string): void;\r\n  abstract tryDetectTheme(): void;\r\n\r\n  static get(appObjects: AppObjectRepo) {\r\n    return getSingletonComponent<SetThemeUC>(SetThemeUC.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeSetThemeUC(appObject: AppObject): SetThemeUC {\r\n  return new SetThemeUCImp(appObject);\r\n}\r\n\r\nclass SetThemeUCImp extends SetThemeUC {\r\n  lightThemeName = \"light\";\r\n  darkThemeName = \"dark\";\r\n\r\n  private get theme() {\r\n    return this.getCachedSingleton<HostThemeEntity>(HostThemeEntity.type);\r\n  }\r\n\r\n  setThemeByName(name: string): void {\r\n    if (!this.theme) return;\r\n\r\n    this.theme.activeSchemeName = name;\r\n  }\r\n\r\n  tryDetectTheme(): void {\r\n    if (!this.theme || !window.matchMedia) return;\r\n\r\n    const darkThemeMq = window.matchMedia(\"(prefers-color-scheme: dark)\");\r\n    if (darkThemeMq.matches) {\r\n      this.theme.activeSchemeName = this.darkThemeName;\r\n    } else {\r\n      this.theme.activeSchemeName = this.darkThemeName;\r\n    }\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, SetThemeUC.type);\r\n    this.appObjects.registerSingleton(this);\r\n  }\r\n}\r\n"]}

package/dist/esm/Apps/Adapters/activeAppPMAdapter.js

@@ -1,6 +1,36 @@
 import { ActiveAppPM, defaultActiveAppVM } from "../PMs/ActiveAppPM";
+/**
+ * Adapter for the ActiveAppPM singleton presentation manager.
+ *
+ * This adapter provides a simple interface for framework components to connect with
+ * the ActiveAppPM presentation manager, which provides information about the currently
+ * active/selected app in the system.
+ *
+ * Usage in components:
+ * ```
+ * // React component example
+ * const [activeAppVm, setActiveAppVm] = useState(activeAppPMAdapter.defaultVM);
+ *
+ * useEffect(() => {
+ *   activeAppPMAdapter.subscribe(appObjects, setActiveAppVm);
+ *   return () => activeAppPMAdapter.unsubscribe(appObjects, setActiveAppVm);
+ * }, [appObjects]);
+ * ```
+ *
+ * @type {SingletonPmAdapter<ActiveAppVM>} Singleton adapter that provides the active app information
+ */
 export const activeAppPMAdapter = {
+    /**
+     * Default view model to use before the actual data is loaded
+     * or when the presentation manager isn't available
+     */
     defaultVM: defaultActiveAppVM,
+    /**
+     * Subscribes a view callback to the active app presentation manager
+     *
+     * @param appObjects - The app object repository
+     * @param setVM - Callback function that will receive view model updates
+     */
     subscribe: (appObjects, setVM) => {
         const pm = ActiveAppPM.get(appObjects);
         if (!pm) {
@@ -9,6 +39,12 @@ export const activeAppPMAdapter = {
         }
         pm.addView(setVM);
     },
+    /**
+     * Unsubscribes a view callback from the active app presentation manager
+     *
+     * @param appObjects - The app object repository
+     * @param setVM - The callback function to remove
+     */
     unsubscribe: (appObjects, setVM) => {
         const pm = ActiveAppPM.get(appObjects);
         if (!pm) {

package/dist/esm/Apps/Adapters/activeAppPMAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"activeAppPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/activeAppPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EAEX,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,CAAC,UAAyB,EAAE,KAAgC,EAAE,EAAE;QACzE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CACX,UAAyB,EACzB,KAAgC,EAChC,EAAE;QACF,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport {\r\n  ActiveAppPM,\r\n  ActiveAppVM,\r\n  defaultActiveAppVM\r\n} from \"../PMs/ActiveAppPM\";\r\n\r\nexport const activeAppPMAdapter: SingletonPmAdapter<ActiveAppVM> = {\r\n  defaultVM: defaultActiveAppVM,\r\n  subscribe: (appObjects: AppObjectRepo, setVM: (vm: ActiveAppVM) => void) => {\r\n    const pm = ActiveAppPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"activeAppPMAdapter\",\r\n        \"Unable to find ActiveAppPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n  unsubscribe: (\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: ActiveAppVM) => void\r\n  ) => {\r\n    const pm = ActiveAppPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"activeAppPMAdapter\",\r\n        \"Unable to find ActiveAppPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}
+{"version":3,"file":"activeAppPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/activeAppPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EAEX,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE;;;OAGG;IACH,SAAS,EAAE,kBAAkB;IAE7B;;;;;OAKG;IACH,SAAS,EAAE,CAAC,UAAyB,EAAE,KAAgC,EAAE,EAAE;QACzE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,WAAW,EAAE,CACX,UAAyB,EACzB,KAAgC,EAChC,EAAE;QACF,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CACpB,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport {\r\n  ActiveAppPM,\r\n  ActiveAppVM,\r\n  defaultActiveAppVM\r\n} from \"../PMs/ActiveAppPM\";\r\n\r\n/**\r\n * Adapter for the ActiveAppPM singleton presentation manager.\r\n *\r\n * This adapter provides a simple interface for framework components to connect with\r\n * the ActiveAppPM presentation manager, which provides information about the currently\r\n * active/selected app in the system.\r\n *\r\n * Usage in components:\r\n * ```\r\n * // React component example\r\n * const [activeAppVm, setActiveAppVm] = useState(activeAppPMAdapter.defaultVM);\r\n *\r\n * useEffect(() => {\r\n *   activeAppPMAdapter.subscribe(appObjects, setActiveAppVm);\r\n *   return () => activeAppPMAdapter.unsubscribe(appObjects, setActiveAppVm);\r\n * }, [appObjects]);\r\n * ```\r\n *\r\n * @type {SingletonPmAdapter<ActiveAppVM>} Singleton adapter that provides the active app information\r\n */\r\nexport const activeAppPMAdapter: SingletonPmAdapter<ActiveAppVM> = {\r\n  /**\r\n   * Default view model to use before the actual data is loaded\r\n   * or when the presentation manager isn't available\r\n   */\r\n  defaultVM: defaultActiveAppVM,\r\n\r\n  /**\r\n   * Subscribes a view callback to the active app presentation manager\r\n   *\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - Callback function that will receive view model updates\r\n   */\r\n  subscribe: (appObjects: AppObjectRepo, setVM: (vm: ActiveAppVM) => void) => {\r\n    const pm = ActiveAppPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"activeAppPMAdapter\",\r\n        \"Unable to find ActiveAppPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n\r\n  /**\r\n   * Unsubscribes a view callback from the active app presentation manager\r\n   *\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - The callback function to remove\r\n   */\r\n  unsubscribe: (\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: ActiveAppVM) => void\r\n  ) => {\r\n    const pm = ActiveAppPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\r\n        \"activeAppPMAdapter\",\r\n        \"Unable to find ActiveAppPM\"\r\n      );\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}

package/dist/esm/Apps/Adapters/appListPMAdapter.js

@@ -1,6 +1,35 @@
 import { AppsListPM } from "../PMs/AppsListPM";
+/**
+ * Adapter for the AppsListPM singleton presentation manager.
+ *
+ * This adapter provides a simple interface for framework components to connect with
+ * the AppsListPM presentation manager, which provides a list of available app IDs.
+ *
+ * Usage in components:
+ * ```
+ * // React component example
+ * const [appIds, setAppIds] = useState(appListPMAdapter.defaultVM);
+ *
+ * useEffect(() => {
+ *   appListPMAdapter.subscribe(appObjects, setAppIds);
+ *   return () => appListPMAdapter.unsubscribe(appObjects, setAppIds);
+ * }, [appObjects]);
+ * ```
+ *
+ * @type {SingletonPmAdapter<string[]>} Singleton adapter that provides a list of app IDs
+ */
 export const appListPMAdapter = {
+    /**
+     * Default view model to use before the actual data is loaded
+     * or when the presentation manager isn't available
+     */
     defaultVM: [],
+    /**
+     * Subscribes a view callback to the apps list presentation manager
+     *
+     * @param appObjects - The app object repository
+     * @param setVM - Callback function that will receive view model updates (array of app IDs)
+     */
     subscribe: (appObjects, setVM) => {
         const pm = AppsListPM.get(appObjects);
         if (!pm) {
@@ -9,6 +38,12 @@ export const appListPMAdapter = {
         }
         pm.addView(setVM);
     },
+    /**
+     * Unsubscribes a view callback from the apps list presentation manager
+     *
+     * @param appObjects - The app object repository
+     * @param setVM - The callback function to remove
+     */
     unsubscribe: (appObjects, setVM) => {
         const pm = AppsListPM.get(appObjects);
         if (!pm) {

package/dist/esm/Apps/Adapters/appListPMAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"appListPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appListPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAiC;IAC5D,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACtE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACxE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport { AppsListPM } from \"../PMs/AppsListPM\";\r\n\r\nexport const appListPMAdapter: SingletonPmAdapter<string[]> = {\r\n  defaultVM: [],\r\n  subscribe: (appObjects: AppObjectRepo, setVM: (vm: string[]) => void) => {\r\n    const pm = AppsListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appListPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n  unsubscribe: (appObjects: AppObjectRepo, setVM: (vm: string[]) => void) => {\r\n    const pm = AppsListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appListPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}
+{"version":3,"file":"appListPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appListPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiC;IAC5D;;;OAGG;IACH,SAAS,EAAE,EAAE;IAEb;;;;;OAKG;IACH,SAAS,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACtE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,WAAW,EAAE,CAAC,UAAyB,EAAE,KAA6B,EAAE,EAAE;QACxE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, SingletonPmAdapter } from \"@vived/core\";\r\nimport { AppsListPM } from \"../PMs/AppsListPM\";\r\n\r\n/**\r\n * Adapter for the AppsListPM singleton presentation manager.\r\n *\r\n * This adapter provides a simple interface for framework components to connect with\r\n * the AppsListPM presentation manager, which provides a list of available app IDs.\r\n *\r\n * Usage in components:\r\n * ```\r\n * // React component example\r\n * const [appIds, setAppIds] = useState(appListPMAdapter.defaultVM);\r\n *\r\n * useEffect(() => {\r\n *   appListPMAdapter.subscribe(appObjects, setAppIds);\r\n *   return () => appListPMAdapter.unsubscribe(appObjects, setAppIds);\r\n * }, [appObjects]);\r\n * ```\r\n *\r\n * @type {SingletonPmAdapter<string[]>} Singleton adapter that provides a list of app IDs\r\n */\r\nexport const appListPMAdapter: SingletonPmAdapter<string[]> = {\r\n  /**\r\n   * Default view model to use before the actual data is loaded\r\n   * or when the presentation manager isn't available\r\n   */\r\n  defaultVM: [],\r\n\r\n  /**\r\n   * Subscribes a view callback to the apps list presentation manager\r\n   *\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - Callback function that will receive view model updates (array of app IDs)\r\n   */\r\n  subscribe: (appObjects: AppObjectRepo, setVM: (vm: string[]) => void) => {\r\n    const pm = AppsListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appListPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n\r\n  /**\r\n   * Unsubscribes a view callback from the apps list presentation manager\r\n   *\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - The callback function to remove\r\n   */\r\n  unsubscribe: (appObjects: AppObjectRepo, setVM: (vm: string[]) => void) => {\r\n    const pm = AppsListPM.get(appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appListPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}

package/dist/esm/Apps/Adapters/appPMAdapter.js

@@ -1,6 +1,36 @@
 import { AppPM, defaultAppVM } from "../PMs/AppPM";
+/**
+ * Adapter for the AppPM presentation manager.
+ *
+ * This adapter provides a simple interface for framework components to connect with
+ * the AppPM presentation manager, which provides details about a specific app.
+ *
+ * Usage in components:
+ * ```
+ * // React component example
+ * const [vm, setVm] = useState(appPMAdapter.defaultVM);
+ *
+ * useEffect(() => {
+ *   appPMAdapter.subscribe(appId, appObjects, setVm);
+ *   return () => appPMAdapter.unsubscribe(appId, appObjects, setVm);
+ * }, [appId, appObjects]);
+ * ```
+ *
+ * @type {PmAdapter<AppVM>} Non-singleton adapter that requires an app ID
+ */
 export const appPMAdapter = {
+    /**
+     * Default view model to use before the actual data is loaded
+     * or when the presentation manager isn't available
+     */
     defaultVM: defaultAppVM,
+    /**
+     * Subscribes a view callback to the app presentation manager
+     *
+     * @param id - ID of the specific app to subscribe to
+     * @param appObjects - The app object repository
+     * @param setVM - Callback function that will receive view model updates
+     */
     subscribe: (id, appObjects, setVM) => {
         const pm = AppPM.get(id, appObjects);
         if (!pm) {
@@ -9,6 +39,13 @@ export const appPMAdapter = {
         }
         pm.addView(setVM);
     },
+    /**
+     * Unsubscribes a view callback from the app presentation manager
+     *
+     * @param id - ID of the specific app to unsubscribe from
+     * @param appObjects - The app object repository
+     * @param setVM - The callback function to remove
+     */
     unsubscribe: (id, appObjects, setVM) => {
         const pm = AppPM.get(id, appObjects);
         if (!pm) {

package/dist/esm/Apps/Adapters/appPMAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"appPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAS,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,CACT,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,WAAW,EAAE,CACX,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, PmAdapter } from \"@vived/core\";\r\nimport { AppPM, AppVM, defaultAppVM } from \"../PMs/AppPM\";\r\n\r\nexport const appPMAdapter: PmAdapter<AppVM> = {\r\n  defaultVM: defaultAppVM,\r\n  subscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: AppVM) => void\r\n  ) => {\r\n    const pm = AppPM.get(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n  unsubscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: AppVM) => void\r\n  ) => {\r\n    const pm = AppPM.get(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}
+{"version":3,"file":"appPMAdapter.js","sourceRoot":"","sources":["../../../../src/Apps/Adapters/appPMAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAS,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C;;;OAGG;IACH,SAAS,EAAE,YAAY;IAEvB;;;;;;OAMG;IACH,SAAS,EAAE,CACT,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,WAAW,EAAE,CACX,EAAU,EACV,UAAyB,EACzB,KAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,WAAW,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF,CAAC","sourcesContent":["import { AppObjectRepo, PmAdapter } from \"@vived/core\";\r\nimport { AppPM, AppVM, defaultAppVM } from \"../PMs/AppPM\";\r\n\r\n/**\r\n * Adapter for the AppPM presentation manager.\r\n *\r\n * This adapter provides a simple interface for framework components to connect with\r\n * the AppPM presentation manager, which provides details about a specific app.\r\n *\r\n * Usage in components:\r\n * ```\r\n * // React component example\r\n * const [vm, setVm] = useState(appPMAdapter.defaultVM);\r\n *\r\n * useEffect(() => {\r\n *   appPMAdapter.subscribe(appId, appObjects, setVm);\r\n *   return () => appPMAdapter.unsubscribe(appId, appObjects, setVm);\r\n * }, [appId, appObjects]);\r\n * ```\r\n *\r\n * @type {PmAdapter<AppVM>} Non-singleton adapter that requires an app ID\r\n */\r\nexport const appPMAdapter: PmAdapter<AppVM> = {\r\n  /**\r\n   * Default view model to use before the actual data is loaded\r\n   * or when the presentation manager isn't available\r\n   */\r\n  defaultVM: defaultAppVM,\r\n\r\n  /**\r\n   * Subscribes a view callback to the app presentation manager\r\n   *\r\n   * @param id - ID of the specific app to subscribe to\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - Callback function that will receive view model updates\r\n   */\r\n  subscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: AppVM) => void\r\n  ) => {\r\n    const pm = AppPM.get(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.addView(setVM);\r\n  },\r\n\r\n  /**\r\n   * Unsubscribes a view callback from the app presentation manager\r\n   *\r\n   * @param id - ID of the specific app to unsubscribe from\r\n   * @param appObjects - The app object repository\r\n   * @param setVM - The callback function to remove\r\n   */\r\n  unsubscribe: (\r\n    id: string,\r\n    appObjects: AppObjectRepo,\r\n    setVM: (vm: AppVM) => void\r\n  ) => {\r\n    const pm = AppPM.get(id, appObjects);\r\n    if (!pm) {\r\n      appObjects.submitError(\"appPMAdapter\", \"Unable to find AppsListPM\");\r\n      return;\r\n    }\r\n    pm.removeView(setVM);\r\n  }\r\n};\r\n"]}