@genesislcap/foundation-utils 14.118.0 → 14.119.0

package/dist/custom-elements.json

@@ -341,6 +341,132 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/decorators/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./renderOnChange"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/decorators/renderOnChange.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderOnChange",
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "text": "FASTElement & { render(): void }"
+              },
+              "description": "The target to define the property change handler on."
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "description": "The property name."
+            }
+          ],
+          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderOnChange",
+          "declaration": {
+            "name": "renderOnChange",
+            "module": "src/decorators/renderOnChange.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./sync"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./when-else"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/design-system.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "assureDesignSystem",
+          "return": {
+            "type": {
+              "text": "DesignSystemModule"
+            }
+          },
+          "parameters": [
+            {
+              "name": "module",
+              "type": {
+                "text": "DesignSystemModule"
+              }
+            }
+          ],
+          "description": "assureDesignSystem.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "assureDesignSystem",
+          "declaration": {
+            "name": "assureDesignSystem",
+            "module": "src/design-system/design-system.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./design-system"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/env/index.ts",
@@ -564,59 +690,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/decorators/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./renderOnChange"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/decorators/renderOnChange.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "renderOnChange",
-          "parameters": [
-            {
-              "name": "target",
-              "type": {
-                "text": "FASTElement & { render(): void }"
-              },
-              "description": "The target to define the property change handler on."
-            },
-            {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "The property name."
-            }
-          ],
-          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "renderOnChange",
-          "declaration": {
-            "name": "renderOnChange",
-            "module": "src/decorators/renderOnChange.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/error/errorMap.ts",
@@ -745,6 +818,11 @@
               "privacy": "public",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "values",
+              "privacy": "public"
+            },
             {
               "kind": "field",
               "name": "messages",
@@ -811,78 +889,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/design-system/design-system.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "assureDesignSystem",
-          "return": {
-            "type": {
-              "text": "DesignSystemModule"
-            }
-          },
-          "parameters": [
-            {
-              "name": "module",
-              "type": {
-                "text": "DesignSystemModule"
-              }
-            }
-          ],
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "assureDesignSystem",
-          "declaration": {
-            "name": "assureDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/design-system/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./design-system"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./sync"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./when-else"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/formatters/datetime.ts",

package/dist/dts/design-system/design-system.d.ts

@@ -1,5 +1,6 @@
 import { DesignSystem } from '@microsoft/fast-foundation';
 /**
+ * DesignSystemModule.
  * @public
  */
 export interface DesignSystemModule {
@@ -7,10 +8,46 @@ export interface DesignSystemModule {
     [key: string]: any;
 }
 /**
+ * DesignSystemResource.
  * @public
  */
 export type DesignSystemResource<T = DesignSystemModule> = Promise<T>;
 /**
+ * assureDesignSystem.
+ *
+ * @remarks
+ * Webpack caching strategies can backfill missing modules with placeholders in an attempt to prevent errors. In the case
+ * of offline remotes, we rely on the error to fall back to local versions. This utility assures we have a design system.
+ *
+ * @example
+ * ```ts
+ * async function zeroDesignSystemImport(): Promise<DesignSystemModule> {
+ *   let module: DesignSystemModule;
+ *   let type: ResourceType = ResourceType.remote;
+ *   try {
+ *     module = await import('foundationZero/ZeroDesignSystem');
+ *     return assureDesignSystem(module);
+ *   } catch (e) {
+ *     logger.info(
+ *       `Please note remoteEntry.js load errors are expected if module federated dependencies are offline. Falling back to locally bundled versions.`,
+ *     );
+ *     type = ResourceType.local;
+ *     module = await import('@genesislcap/foundation-zero');
+ *     return assureDesignSystem(module);
+ *   } finally {
+ *     logger.debug(`Using '${type}' version of foundation-zero`);
+ *   }
+ * }
+ * ```
+ *
+ * @example You should also instruct webpack to use strict module handling.
+ * ```ts
+ * output: {
+ *   strictModuleErrorHandling: true,
+ *   strictModuleExceptionHandling: true,
+ * }
+ * ```
+ *
  * @public
  */
 export declare function assureDesignSystem(module: DesignSystemModule): DesignSystemModule;

package/dist/dts/design-system/design-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"design-system.d.ts","sourceRoot":"","sources":["../../../src/design-system/design-system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,CACjB,OAAO,CAAC,EAAE,WAAW,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,GAAG,kBAAkB,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAQjF"}
+{"version":3,"file":"design-system.d.ts","sourceRoot":"","sources":["../../../src/design-system/design-system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,CACjB,OAAO,CAAC,EAAE,WAAW,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,GAAG,kBAAkB,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAQjF"}

package/dist/dts/error/errorMap.d.ts

@@ -9,7 +9,7 @@ export type ErrorMapLogger = (...args: any[]) => void;
 /**
  * @public
  */
-export interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size'> {
+export interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size' | 'values'> {
     /**
      * Error map as messages.
      * @returns string
@@ -83,6 +83,10 @@ export declare class DefaultErrorMap<TErrorDetailMap extends ErrorDetailMap> imp
      * @public
      */
     get size(): number;
+    /**
+     * @public
+     */
+    values(): IterableIterator<Error>;
     /** {@inheritDoc ErrorMap.messages} */
     get messages(): string;
 }

package/dist/dts/error/errorMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorMap.d.ts","sourceRoot":"","sources":["../../../src/error/errorMap.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,eAAe,SAAS,cAAc,CAC9D,SAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5F;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,eAAe,SAAS,cAAc,CACjE,YAAW,QAAQ,CAAC,eAAe,CAAC;IAUxB,OAAO,CAAC,MAAM;IARd,OAAO,CAAC,GAAG,CAA2C;IAElE,uCAAuC;IAC3B,SAAS,EAAE,KAAK,CAAC;IAE7B;;OAEG;gBACiB,MAAM,EAAE,cAAc;IAE1C,iCAAiC;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAMnD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS;IAIlD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,OAAO;IAIxC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,OAAO;IAa3C;;;OAGG;IACH,KAAK;IAKL;;;;;OAKG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sCAAsC;IACtC,IAAI,QAAQ,IAAI,MAAM,CAUrB;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,mDACjB,cAAc,8BACoD,CAAC"}
+{"version":3,"file":"errorMap.d.ts","sourceRoot":"","sources":["../../../src/error/errorMap.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,eAAe,SAAS,cAAc,CAC9D,SAAQ,IAAI,CACV,GAAG,CAAC,MAAM,eAAe,EAAE,KAAK,CAAC,EACjC,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CACvD;IACD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,eAAe,SAAS,cAAc,CACjE,YAAW,QAAQ,CAAC,eAAe,CAAC;IAUxB,OAAO,CAAC,MAAM;IARd,OAAO,CAAC,GAAG,CAA2C;IAElE,uCAAuC;IAC3B,SAAS,EAAE,KAAK,CAAC;IAE7B;;OAEG;gBACiB,MAAM,EAAE,cAAc;IAE1C,iCAAiC;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAMnD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS;IAIlD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,OAAO;IAIxC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,OAAO;IAa3C;;;OAGG;IACH,KAAK;IAKL;;;;;OAKG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,MAAM;IAIN,sCAAsC;IACtC,IAAI,QAAQ,IAAI,MAAM,CAUrB;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,mDACjB,cAAc,8BACoD,CAAC"}

package/dist/dts/observer/observer.d.ts

@@ -5,6 +5,7 @@
 export type Listener<EventType> = (ev: EventType) => void;
 /**
  * Subscribes a listener function to receive events of a specific type.
+ * @returns An unsubscribe function.
  * @public
  */
 export type Subscribe<EventType> = (listener: Listener<EventType>) => () => void;

package/dist/dts/observer/observer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../src/observer/observer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,SAAS,IAAI,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAC;AAC1D;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,MAAM,IAAI,CAAC;AACjF;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,SAAS;IACjC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,sCAW1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAa,WAAW,mBAAmB,OAAO,KAAK,GAAG,SAYzF,CAAC"}
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../src/observer/observer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,SAAS,IAAI,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAC;AAC1D;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,MAAM,IAAI,CAAC;AACjF;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,SAAS;IACjC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,sCAW1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAa,WAAW,mBAAmB,OAAO,KAAK,GAAG,SAYzF,CAAC"}

package/dist/esm/design-system/design-system.js

@@ -1,4 +1,39 @@
 /**
+ * assureDesignSystem.
+ *
+ * @remarks
+ * Webpack caching strategies can backfill missing modules with placeholders in an attempt to prevent errors. In the case
+ * of offline remotes, we rely on the error to fall back to local versions. This utility assures we have a design system.
+ *
+ * @example
+ * ```ts
+ * async function zeroDesignSystemImport(): Promise<DesignSystemModule> {
+ *   let module: DesignSystemModule;
+ *   let type: ResourceType = ResourceType.remote;
+ *   try {
+ *     module = await import('foundationZero/ZeroDesignSystem');
+ *     return assureDesignSystem(module);
+ *   } catch (e) {
+ *     logger.info(
+ *       `Please note remoteEntry.js load errors are expected if module federated dependencies are offline. Falling back to locally bundled versions.`,
+ *     );
+ *     type = ResourceType.local;
+ *     module = await import('@genesislcap/foundation-zero');
+ *     return assureDesignSystem(module);
+ *   } finally {
+ *     logger.debug(`Using '${type}' version of foundation-zero`);
+ *   }
+ * }
+ * ```
+ *
+ * @example You should also instruct webpack to use strict module handling.
+ * ```ts
+ * output: {
+ *   strictModuleErrorHandling: true,
+ *   strictModuleExceptionHandling: true,
+ * }
+ * ```
+ *
  * @public
  */
 export function assureDesignSystem(module) {

package/dist/esm/error/errorMap.js

@@ -72,6 +72,12 @@ export class DefaultErrorMap {
     get size() {
         return this.map.size;
     }
+    /**
+     * @public
+     */
+    values() {
+        return this.map.values();
+    }
     /** {@inheritDoc ErrorMap.messages} */
     get messages() {
         const count = this.size;

package/dist/foundation-utils.api.json

@@ -230,7 +230,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-utils!assureDesignSystem:function(1)",
-          "docComment": "/**\n * @public\n */\n",
+          "docComment": "/**\n * assureDesignSystem.\n *\n * @remarks\n *\n * Webpack caching strategies can backfill missing modules with placeholders in an attempt to prevent errors. In the case of offline remotes, we rely on the error to fall back to local versions. This utility assures we have a design system.\n *\n * @example\n * ```ts\n * async function zeroDesignSystemImport(): Promise<DesignSystemModule> {\n *   let module: DesignSystemModule;\n *   let type: ResourceType = ResourceType.remote;\n *   try {\n *     module = await import('foundationZero/ZeroDesignSystem');\n *     return assureDesignSystem(module);\n *   } catch (e) {\n *     logger.info(\n *       `Please note remoteEntry.js load errors are expected if module federated dependencies are offline. Falling back to locally bundled versions.`,\n *     );\n *     type = ResourceType.local;\n *     module = await import('@genesislcap/foundation-zero');\n *     return assureDesignSystem(module);\n *   } finally {\n *     logger.debug(`Using '${type}' version of foundation-zero`);\n *   }\n * }\n * ```\n *\n * @example\n *\n * You should also instruct webpack to use strict module handling.\n * ```ts\n * output: {\n *   strictModuleErrorHandling: true,\n *   strictModuleExceptionHandling: true,\n * }\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2109,6 +2109,51 @@
               "isStatic": false,
               "isProtected": false,
               "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-utils!DefaultErrorMap#values:member(1)",
+              "docComment": "/**\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "values(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IterableIterator",
+                  "canonicalReference": "!IterableIterator:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Error",
+                  "canonicalReference": "!Error:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "values"
             }
           ],
           "implementsTokenRanges": [
@@ -2327,7 +2372,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/foundation-utils!DesignSystemModule:interface",
-          "docComment": "/**\n * @public\n */\n",
+          "docComment": "/**\n * DesignSystemModule.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2474,7 +2519,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-utils!DesignSystemResource:type",
-          "docComment": "/**\n * @public\n */\n",
+          "docComment": "/**\n * DesignSystemResource.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2730,7 +2775,7 @@
             },
             {
               "kind": "Content",
-              "text": ">, 'get' | 'has' | 'delete' | 'clear' | 'size'>"
+              "text": ">, 'get' | 'has' | 'delete' | 'clear' | 'size' | 'values'>"
             },
             {
               "kind": "Content",
@@ -11863,7 +11908,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-utils!Subscribe:type",
-          "docComment": "/**\n * Subscribes a listener function to receive events of a specific type.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Subscribes a listener function to receive events of a specific type.\n *\n * @returns An unsubscribe function.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

package/dist/foundation-utils.d.ts

@@ -29,6 +29,41 @@ export declare const activeColorScheme: CSSDesignToken<string>;
 export declare let API_HOST: string;
 
 /**
+ * assureDesignSystem.
+ *
+ * @remarks
+ * Webpack caching strategies can backfill missing modules with placeholders in an attempt to prevent errors. In the case
+ * of offline remotes, we rely on the error to fall back to local versions. This utility assures we have a design system.
+ *
+ * @example
+ * ```ts
+ * async function zeroDesignSystemImport(): Promise<DesignSystemModule> {
+ *   let module: DesignSystemModule;
+ *   let type: ResourceType = ResourceType.remote;
+ *   try {
+ *     module = await import('foundationZero/ZeroDesignSystem');
+ *     return assureDesignSystem(module);
+ *   } catch (e) {
+ *     logger.info(
+ *       `Please note remoteEntry.js load errors are expected if module federated dependencies are offline. Falling back to locally bundled versions.`,
+ *     );
+ *     type = ResourceType.local;
+ *     module = await import('@genesislcap/foundation-zero');
+ *     return assureDesignSystem(module);
+ *   } finally {
+ *     logger.debug(`Using '${type}' version of foundation-zero`);
+ *   }
+ * }
+ * ```
+ *
+ * @example You should also instruct webpack to use strict module handling.
+ * ```ts
+ * output: {
+ *   strictModuleErrorHandling: true,
+ *   strictModuleExceptionHandling: true,
+ * }
+ * ```
+ *
  * @public
  */
 export declare function assureDesignSystem(module: DesignSystemModule): DesignSystemModule;
@@ -220,6 +255,10 @@ export declare class DefaultErrorMap<TErrorDetailMap extends ErrorDetailMap> imp
      * @public
      */
     get size(): number;
+    /**
+     * @public
+     */
+    values(): IterableIterator<Error>;
     /** {@inheritDoc ErrorMap.messages} */
     get messages(): string;
 }
@@ -264,6 +303,7 @@ export declare class DefaultServerRowDTOMapper implements ServerRowDTOMapper {
 }
 
 /**
+ * DesignSystemModule.
  * @public
  */
 export declare interface DesignSystemModule {
@@ -272,6 +312,7 @@ export declare interface DesignSystemModule {
 }
 
 /**
+ * DesignSystemResource.
  * @public
  */
 export declare type DesignSystemResource<T = DesignSystemModule> = Promise<T>;
@@ -301,7 +342,7 @@ export declare type ErrorDetailMap = Record<string, unknown>;
 /**
  * @public
  */
-export declare interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size'> {
+export declare interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size' | 'values'> {
     /**
      * Error map as messages.
      * @returns string
@@ -1592,6 +1633,7 @@ export declare let SOCKET_EXT: string;
 
 /**
  * Subscribes a listener function to receive events of a specific type.
+ * @returns An unsubscribe function.
  * @public
  */
 export declare type Subscribe<EventType> = (listener: Listener<EventType>) => () => void;

package/docs/api/foundation-utils.assuredesignsystem.md

@@ -4,6 +4,7 @@
 
 ## assureDesignSystem() function
 
+assureDesignSystem.
 
 **Signature:**
 
@@ -21,3 +22,41 @@ export declare function assureDesignSystem(module: DesignSystemModule): DesignSy
 
 [DesignSystemModule](./foundation-utils.designsystemmodule.md)
 
+## Remarks
+
+Webpack caching strategies can backfill missing modules with placeholders in an attempt to prevent errors. In the case of offline remotes, we rely on the error to fall back to local versions. This utility assures we have a design system.
+
+## Example 1
+
+
+```ts
+async function zeroDesignSystemImport(): Promise<DesignSystemModule> {
+  let module: DesignSystemModule;
+  let type: ResourceType = ResourceType.remote;
+  try {
+    module = await import('foundationZero/ZeroDesignSystem');
+    return assureDesignSystem(module);
+  } catch (e) {
+    logger.info(
+      `Please note remoteEntry.js load errors are expected if module federated dependencies are offline. Falling back to locally bundled versions.`,
+    );
+    type = ResourceType.local;
+    module = await import('@genesislcap/foundation-zero');
+    return assureDesignSystem(module);
+  } finally {
+    logger.debug(`Using '${type}' version of foundation-zero`);
+  }
+}
+```
+
+## Example 2
+
+You should also instruct webpack to use strict module handling.
+
+```ts
+output: {
+  strictModuleErrorHandling: true,
+  strictModuleExceptionHandling: true,
+}
+```
+

package/docs/api/foundation-utils.defaulterrormap.md

@@ -35,4 +35,5 @@ export declare class DefaultErrorMap<TErrorDetailMap extends ErrorDetailMap> imp
 |  [get(key)](./foundation-utils.defaulterrormap.get.md) |  | Get an error by key. |
 |  [has(key)](./foundation-utils.defaulterrormap.has.md) |  | Has an error for key. |
 |  [set(key, error)](./foundation-utils.defaulterrormap.set.md) |  | Set an error by key. |
+|  [values()](./foundation-utils.defaulterrormap.values.md) |  |  |
 

package/docs/api/foundation-utils.defaulterrormap.values.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [DefaultErrorMap](./foundation-utils.defaulterrormap.md) &gt; [values](./foundation-utils.defaulterrormap.values.md)
+
+## DefaultErrorMap.values() method
+
+
+**Signature:**
+
+```typescript
+values(): IterableIterator<Error>;
+```
+**Returns:**
+
+IterableIterator&lt;Error&gt;
+

package/docs/api/foundation-utils.designsystemmodule.md

@@ -4,6 +4,7 @@
 
 ## DesignSystemModule interface
 
+DesignSystemModule.
 
 **Signature:**
 

package/docs/api/foundation-utils.designsystemresource.md

@@ -4,6 +4,7 @@
 
 ## DesignSystemResource type
 
+DesignSystemResource.
 
 **Signature:**
 

package/docs/api/foundation-utils.errormap.md

@@ -8,9 +8,9 @@
 **Signature:**
 
 ```typescript
-export interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size'> 
+export interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size' | 'values'> 
 ```
-**Extends:** Pick&lt;Map&lt;keyof TErrorDetailMap, Error&gt;, 'get' \| 'has' \| 'delete' \| 'clear' \| 'size'&gt;
+**Extends:** Pick&lt;Map&lt;keyof TErrorDetailMap, Error&gt;, 'get' \| 'has' \| 'delete' \| 'clear' \| 'size' \| 'values'&gt;
 
 ## Properties
 

package/docs/api/foundation-utils.md

@@ -26,7 +26,7 @@
 
 |  Function | Description |
 |  --- | --- |
-|  [assureDesignSystem(module)](./foundation-utils.assuredesignsystem.md) |  |
+|  [assureDesignSystem(module)](./foundation-utils.assuredesignsystem.md) | assureDesignSystem. |
 |  [createLogger(name, options)](./foundation-utils.createlogger.md) | Creates a logger with the given name and options. |
 |  [customNumberParser(value)](./foundation-utils.customnumberparser.md) | A Default Number Parser for deserializing objects. |
 |  [formatDateTimestamp(timestamp)](./foundation-utils.formatdatetimestamp.md) | Formats \[DATE\] UNIX Timestamps (without time) to readable strings |
@@ -45,7 +45,7 @@
 |  --- | --- |
 |  [Database](./foundation-utils.database.md) | Represents a database with basic CRUD operations. |
 |  [DatabaseRecord](./foundation-utils.databaserecord.md) | Represents a database record. |
-|  [DesignSystemModule](./foundation-utils.designsystemmodule.md) |  |
+|  [DesignSystemModule](./foundation-utils.designsystemmodule.md) | DesignSystemModule. |
 |  [DTOMapper](./foundation-utils.dtomapper.md) |  |
 |  [ErrorMap](./foundation-utils.errormap.md) |  |
 |  [JSONSerializer](./foundation-utils.jsonserializer.md) | An interface representing a JSON serializer. |
@@ -108,7 +108,7 @@
 |  [ConstructableLifecycleHandler](./foundation-utils.constructablelifecyclehandler.md) |  |
 |  [ConstructablePendingState](./foundation-utils.constructablependingstate.md) | A mixin that provides functionality for raising <code>pending-state</code> events. |
 |  [ConversionType](./foundation-utils.conversiontype.md) | Represents the possible types of value conversion for data synchronization. |
-|  [DesignSystemResource](./foundation-utils.designsystemresource.md) |  |
+|  [DesignSystemResource](./foundation-utils.designsystemresource.md) | DesignSystemResource. |
 |  [ErrorDetailMap](./foundation-utils.errordetailmap.md) |  |
 |  [ErrorMapLogger](./foundation-utils.errormaplogger.md) |  |
 |  [EventName](./foundation-utils.eventname.md) | Represents the possible event names for data synchronization. |

package/docs/api-report.md

@@ -25,7 +25,7 @@ export const activeColorScheme: CSSDesignToken<string>;
 // @public
 export let API_HOST: string;
 
-// @public (undocumented)
+// @public
 export function assureDesignSystem(module: DesignSystemModule): DesignSystemModule;
 
 // Warning: (ae-internal-missing-underscore) The name "BIG_INT_64_BITS" should be prefixed with an underscore because the declaration is marked as @internal
@@ -144,6 +144,8 @@ export class DefaultErrorMap<TErrorDetailMap extends ErrorDetailMap> implements
     get messages(): string;
     set(key: keyof TErrorDetailMap, error: Error): void;
     get size(): number;
+    // (undocumented)
+    values(): IterableIterator<Error>;
 }
 
 // @public
@@ -161,7 +163,7 @@ export class DefaultServerRowDTOMapper implements ServerRowDTOMapper {
     toDTO: (entity: ServerRowEntity) => ServerRowDTO;
 }
 
-// @public (undocumented)
+// @public
 export interface DesignSystemModule {
     // (undocumented)
     [key: string]: any;
@@ -169,7 +171,7 @@ export interface DesignSystemModule {
     provideDesignSystem(element?: HTMLElement, prefix?: string): DesignSystem | Pick<DesignSystem, 'register'>;
 }
 
-// @public (undocumented)
+// @public
 export type DesignSystemResource<T = DesignSystemModule> = Promise<T>;
 
 // Warning: (ae-internal-missing-underscore) The name "DOMContainer" should be prefixed with an underscore because the declaration is marked as @internal
@@ -193,7 +195,7 @@ export interface DTOMapper<TDTO, TEntity> {
 export type ErrorDetailMap = Record<string, unknown>;
 
 // @public (undocumented)
-export interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size'> {
+export interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size' | 'values'> {
     readonly lastError: Error;
     readonly messages: string;
     set(key: keyof TErrorDetailMap, error: Error): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.118.0",
+  "version": "14.119.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -19,12 +19,12 @@
     "test": "genx test"
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.118.0",
-    "@genesislcap/genx": "14.118.0",
+    "@genesislcap/foundation-testing": "14.119.0",
+    "@genesislcap/genx": "14.119.0",
     "rimraf": "^3.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-logger": "14.118.0",
+    "@genesislcap/foundation-logger": "14.119.0",
     "@microsoft/fast-components": "^2.21.3",
     "@microsoft/fast-element": "^1.7.0",
     "@microsoft/fast-foundation": "^2.33.2",
@@ -42,5 +42,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "03508c2fc32d208bb7a037a3587b39690cfa752d"
+  "gitHead": "e404631dc1081f17be8ba7d9b487adfb6d852bad"
 }