@genesislcap/foundation-utils 14.400.0 → 14.401.0

package/dist/custom-elements.json

@@ -127,6 +127,14 @@
             "package": "./resource"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./route"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -391,126 +399,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"
-              }
-            }
-          ],
-          "description": "assureDesignSystem.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "getCurrentDesignSystem",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "element",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "The starting HTML element"
-            },
-            {
-              "name": "fallbackPrefix",
-              "type": {
-                "text": "string"
-              },
-              "description": "The prefix to fallback to if the provider is not available"
-            }
-          ],
-          "description": "Get the current design system provider element and prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "getCurrentDesignSystemPrefix",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "element",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "The starting HTML element"
-            },
-            {
-              "name": "fallbackPrefix",
-              "type": {
-                "text": "string"
-              },
-              "description": "The prefix to fallback to if the provider is not available"
-            }
-          ],
-          "description": "Get the current design system prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "assureDesignSystem",
-          "declaration": {
-            "name": "assureDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getCurrentDesignSystem",
-          "declaration": {
-            "name": "getCurrentDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getCurrentDesignSystemPrefix",
-          "declaration": {
-            "name": "getCurrentDesignSystemPrefix",
-            "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/decorators/index.ts",
@@ -564,6 +452,21 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/encoding/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./base64"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/directives/index.ts",
@@ -1263,7 +1166,112 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/encoding/index.ts",
+      "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"
+        },
+        {
+          "kind": "function",
+          "name": "getCurrentDesignSystem",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The starting HTML element"
+            },
+            {
+              "name": "fallbackPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "The prefix to fallback to if the provider is not available"
+            }
+          ],
+          "description": "Get the current design system provider element and prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getCurrentDesignSystemPrefix",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The starting HTML element"
+            },
+            {
+              "name": "fallbackPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "The prefix to fallback to if the provider is not available"
+            }
+          ],
+          "description": "Get the current design system prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "assureDesignSystem",
+          "declaration": {
+            "name": "assureDesignSystem",
+            "module": "src/design-system/design-system.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getCurrentDesignSystem",
+          "declaration": {
+            "name": "getCurrentDesignSystem",
+            "module": "src/design-system/design-system.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getCurrentDesignSystemPrefix",
+          "declaration": {
+            "name": "getCurrentDesignSystemPrefix",
+            "module": "src/design-system/design-system.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -1271,7 +1279,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./base64"
+            "package": "./design-system"
           }
         }
       ]
@@ -2564,7 +2572,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/serializers/index.ts",
+      "path": "src/route/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -2572,16 +2580,124 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./json"
+            "package": "./route"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/shortcut-manager/index.ts",
-      "declarations": [],
-      "exports": [
+      "path": "src/route/route.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A singleton utility to observe and notify about route changes.\nIt uses both polling and popstate events to detect changes.",
+          "name": "RouteUtil",
+          "members": [
+            {
+              "kind": "field",
+              "name": "pathName",
+              "type": {
+                "text": "string"
+              },
+              "description": "The current pathname of the window location."
+            },
+            {
+              "kind": "field",
+              "name": "routeCheckInterval",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "instance",
+              "type": {
+                "text": "RouteUtil"
+              },
+              "privacy": "private",
+              "static": true
+            },
+            {
+              "kind": "field",
+              "name": "shared",
+              "type": {
+                "text": "RouteUtil"
+              },
+              "privacy": "public",
+              "static": true,
+              "description": "Gets the singleton instance of RouteUtil.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "initializeRouteDetection",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Initialize framework-agnostic route detection"
+            },
+            {
+              "kind": "method",
+              "name": "handleRouteChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Handle route changes by updating the pathName observable"
+            },
+            {
+              "kind": "method",
+              "name": "destroy",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Clean up route detection listeners and polling."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RouteUtil",
+          "declaration": {
+            "name": "RouteUtil",
+            "module": "src/route/route.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/serializers/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./json"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shortcut-manager/index.ts",
+      "declarations": [],
+      "exports": [
         {
           "kind": "js",
           "name": "*",
@@ -4143,160 +4259,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/sync/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./sync"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/sync/sync.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "defaultEventMap",
-          "type": {
-            "text": "Map<string, EventName>"
-          },
-          "default": "new Map([\n  ['FAST-TEXT-AREA', 'input'],\n  ['FAST-TEXT-FIELD', 'input'],\n  ['FOUNDATION-TEXT-AREA', 'input'],\n  ['FOUNDATION-TEXT-FIELD', 'input'],\n  ['INPUT', 'input'],\n  ['ZERO-TEXT-FIELD', 'input'],\n])",
-          "description": "A map that associates specific HTML element tags with their corresponding default event names.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "sync",
-          "return": {
-            "type": {
-              "text": "CaptureType<TSource>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "binding",
-              "type": {
-                "text": "Binding<TSource, TReturn>"
-              }
-            },
-            {
-              "name": "conversionType",
-              "default": "'string'",
-              "type": {
-                "text": "ConversionType"
-              }
-            },
-            {
-              "name": "eventName",
-              "default": "'default'",
-              "type": {
-                "text": "EventName"
-              }
-            },
-            {
-              "name": "keyAttr",
-              "optional": true,
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Creates a synchronization directive that binds a data source to an HTML element,",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "defaultEventMap",
-          "declaration": {
-            "name": "defaultEventMap",
-            "module": "src/directives/sync/sync.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "sync",
-          "declaration": {
-            "name": "sync",
-            "module": "src/directives/sync/sync.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/when-else/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./when-else"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/when-else/when-else.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "whenElse",
-          "return": {
-            "type": {
-              "text": "CaptureType<TSource>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "binding",
-              "type": {
-                "text": "Binding<TSource, TReturn>"
-              },
-              "description": "The condition to test for rendering."
-            },
-            {
-              "name": "trueTemplateOrTemplateBinding",
-              "type": {
-                "text": "WhenTemplate<TSource>"
-              },
-              "description": "The template or a binding that gets the template to render when the condition is true."
-            },
-            {
-              "name": "falseTemplateOrTemplateBinding",
-              "type": {
-                "text": "WhenTemplate<TSource>"
-              },
-              "description": "The template or a binding that gets the template to render when the condition is false."
-            }
-          ],
-          "description": "Directive that allows supplying an \"else\" template to the traditional https://www.fast.design/docs/api/fast-element.when/#when-function directive",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "whenElse",
-          "declaration": {
-            "name": "whenElse",
-            "module": "src/directives/when-else/when-else.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/encoding/base64/decode.ts",
@@ -4451,6 +4413,160 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/sync/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./sync"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/sync/sync.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "defaultEventMap",
+          "type": {
+            "text": "Map<string, EventName>"
+          },
+          "default": "new Map([\n  ['FAST-TEXT-AREA', 'input'],\n  ['FAST-TEXT-FIELD', 'input'],\n  ['FOUNDATION-TEXT-AREA', 'input'],\n  ['FOUNDATION-TEXT-FIELD', 'input'],\n  ['INPUT', 'input'],\n  ['ZERO-TEXT-FIELD', 'input'],\n])",
+          "description": "A map that associates specific HTML element tags with their corresponding default event names.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "sync",
+          "return": {
+            "type": {
+              "text": "CaptureType<TSource>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "binding",
+              "type": {
+                "text": "Binding<TSource, TReturn>"
+              }
+            },
+            {
+              "name": "conversionType",
+              "default": "'string'",
+              "type": {
+                "text": "ConversionType"
+              }
+            },
+            {
+              "name": "eventName",
+              "default": "'default'",
+              "type": {
+                "text": "EventName"
+              }
+            },
+            {
+              "name": "keyAttr",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Creates a synchronization directive that binds a data source to an HTML element,",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "defaultEventMap",
+          "declaration": {
+            "name": "defaultEventMap",
+            "module": "src/directives/sync/sync.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sync",
+          "declaration": {
+            "name": "sync",
+            "module": "src/directives/sync/sync.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/when-else/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./when-else"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/when-else/when-else.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "whenElse",
+          "return": {
+            "type": {
+              "text": "CaptureType<TSource>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "binding",
+              "type": {
+                "text": "Binding<TSource, TReturn>"
+              },
+              "description": "The condition to test for rendering."
+            },
+            {
+              "name": "trueTemplateOrTemplateBinding",
+              "type": {
+                "text": "WhenTemplate<TSource>"
+              },
+              "description": "The template or a binding that gets the template to render when the condition is true."
+            },
+            {
+              "name": "falseTemplateOrTemplateBinding",
+              "type": {
+                "text": "WhenTemplate<TSource>"
+              },
+              "description": "The template or a binding that gets the template to render when the condition is false."
+            }
+          ],
+          "description": "Directive that allows supplying an \"else\" template to the traditional https://www.fast.design/docs/api/fast-element.when/#when-function directive",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "whenElse",
+          "declaration": {
+            "name": "whenElse",
+            "module": "src/directives/when-else/when-else.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/mappers/dto/index.ts",

package/dist/dts/index.d.ts

@@ -13,6 +13,7 @@ export * from './mixins';
 export * from './observer';
 export * from './promise';
 export * from './resource';
+export * from './route';
 export * from './serializers';
 export * from './shortcut-manager';
 export * from './state';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

package/dist/dts/route/index.d.ts

@@ -0,0 +1,2 @@
+export * from './route';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/route/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/route/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/dts/route/route.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A singleton utility to observe and notify about route changes.
+ * It uses both polling and popstate events to detect changes.
+ * @public
+ */
+export declare class RouteUtil {
+    /**
+     * The current pathname of the window location.
+     */
+    pathName: string;
+    private routeCheckInterval;
+    private static instance;
+    private constructor();
+    /**
+     * Gets the singleton instance of RouteUtil.
+     */
+    static get shared(): RouteUtil;
+    /**
+     * Initialize framework-agnostic route detection
+     */
+    private initializeRouteDetection;
+    /**
+     * Handle route changes by updating the pathName observable
+     */
+    private handleRouteChange;
+    /**
+     * Clean up route detection listeners and polling.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/route/route.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACS,QAAQ,EAAE,MAAM,CAA4B;IAExD,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAY;IAEnC,OAAO;IAIP;;OAEG;IACH,WAAkB,MAAM,IAAI,SAAS,CAKpC;IAED;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAYhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACI,OAAO,IAAI,IAAI;CAYvB"}

package/dist/esm/index.js

@@ -13,6 +13,7 @@ export * from './mixins';
 export * from './observer';
 export * from './promise';
 export * from './resource';
+export * from './route';
 export * from './serializers';
 export * from './shortcut-manager';
 export * from './state';

package/dist/esm/route/index.js

@@ -0,0 +1 @@
+export * from './route';

package/dist/esm/route/route.js

@@ -0,0 +1,66 @@
+import { __decorate } from "tslib";
+import { createLogger } from '@genesislcap/foundation-logger';
+import { observable } from '@microsoft/fast-element';
+const logger = createLogger('route-util');
+const DEFAULT_ROUTE_POLL_CHANGE = 500;
+/**
+ * A singleton utility to observe and notify about route changes.
+ * It uses both polling and popstate events to detect changes.
+ * @public
+ */
+export class RouteUtil {
+    constructor() {
+        /**
+         * The current pathname of the window location.
+         */
+        this.pathName = window.location.pathname;
+        this.routeCheckInterval = null;
+        this.initializeRouteDetection();
+    }
+    /**
+     * Gets the singleton instance of RouteUtil.
+     */
+    static get shared() {
+        if (!RouteUtil.instance) {
+            RouteUtil.instance = new RouteUtil();
+        }
+        return RouteUtil.instance;
+    }
+    /**
+     * Initialize framework-agnostic route detection
+     */
+    initializeRouteDetection() {
+        // Listen for browser back/forward navigation
+        window.addEventListener('popstate', this.handleRouteChange.bind(this));
+        // Start polling for route changes every DEFAULT_ROUTE_POLL_CHANGEms
+        this.routeCheckInterval = window.setInterval(() => {
+            this.handleRouteChange();
+        }, DEFAULT_ROUTE_POLL_CHANGE);
+        logger.debug('Route detection initialized');
+    }
+    /**
+     * Handle route changes by updating the pathName observable
+     */
+    handleRouteChange() {
+        const newPathname = window.location.pathname;
+        if (this.pathName !== newPathname) {
+            this.pathName = newPathname;
+        }
+    }
+    /**
+     * Clean up route detection listeners and polling.
+     */
+    destroy() {
+        // Remove popstate listener
+        window.removeEventListener('popstate', this.handleRouteChange.bind(this));
+        // Clear polling interval
+        if (this.routeCheckInterval !== null) {
+            window.clearInterval(this.routeCheckInterval);
+            this.routeCheckInterval = null;
+        }
+        logger.debug('Route detection cleaned up');
+    }
+}
+__decorate([
+    observable
+], RouteUtil.prototype, "pathName", void 0);

package/dist/foundation-utils.api.json

@@ -16946,6 +16946,117 @@
           ],
           "name": "respondToVisibility"
         },
+        {
+          "kind": "Class",
+          "canonicalReference": "@genesislcap/foundation-utils!RouteUtil:class",
+          "docComment": "/**\n * A singleton utility to observe and notify about route changes. It uses both polling and popstate events to detect changes.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class RouteUtil "
+            }
+          ],
+          "fileUrlPath": "src/route/route.ts",
+          "releaseTag": "Public",
+          "isAbstract": false,
+          "name": "RouteUtil",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-utils!RouteUtil#destroy:member(1)",
+              "docComment": "/**\n * Clean up route detection listeners and polling.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "destroy(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "destroy"
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-utils!RouteUtil#pathName:member",
+              "docComment": "/**\n * The current pathname of the window location.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "pathName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "pathName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-utils!RouteUtil.shared:member",
+              "docComment": "/**\n * Gets the singleton instance of RouteUtil.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static get shared(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "RouteUtil",
+                  "canonicalReference": "@genesislcap/foundation-utils!RouteUtil:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "shared",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": true,
+              "isProtected": false,
+              "isAbstract": false
+            }
+          ],
+          "implementsTokenRanges": []
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-utils!ServerRowDTO:type",

package/dist/foundation-utils.d.ts

@@ -2158,6 +2158,37 @@ export declare type ResourceType = (typeof ResourceType)[keyof typeof ResourceTy
  */
 export declare const respondToVisibility: (element: HTMLElement, callback: (arg0: boolean) => any) => (() => void);
 
+/**
+ * A singleton utility to observe and notify about route changes.
+ * It uses both polling and popstate events to detect changes.
+ * @public
+ */
+export declare class RouteUtil {
+    /**
+     * The current pathname of the window location.
+     */
+    pathName: string;
+    private routeCheckInterval;
+    private static instance;
+    private constructor();
+    /**
+     * Gets the singleton instance of RouteUtil.
+     */
+    static get shared(): RouteUtil;
+    /**
+     * Initialize framework-agnostic route detection
+     */
+    private initializeRouteDetection;
+    /**
+     * Handle route changes by updating the pathName observable
+     */
+    private handleRouteChange;
+    /**
+     * Clean up route detection listeners and polling.
+     */
+    destroy(): void;
+}
+
 /**
  * The data for a server row DTO.
  * @public

package/docs/api/foundation-utils.md

@@ -107,6 +107,17 @@ An in memory database of specific DatabaseRecord types.
 
 
 
+</td></tr>
+<tr><td>
+
+[RouteUtil](./foundation-utils.routeutil.md)
+
+
+</td><td>
+
+A singleton utility to observe and notify about route changes. It uses both polling and popstate events to detect changes.
+
+
 </td></tr>
 <tr><td>
 

package/docs/api/foundation-utils.routeutil.destroy.md

@@ -0,0 +1,17 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [RouteUtil](./foundation-utils.routeutil.md) &gt; [destroy](./foundation-utils.routeutil.destroy.md)
+
+## RouteUtil.destroy() method
+
+Clean up route detection listeners and polling.
+
+**Signature:**
+
+```typescript
+destroy(): void;
+```
+**Returns:**
+
+void
+

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

@@ -0,0 +1,115 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [RouteUtil](./foundation-utils.routeutil.md)
+
+## RouteUtil class
+
+A singleton utility to observe and notify about route changes. It uses both polling and popstate events to detect changes.
+
+**Signature:**
+
+```typescript
+export declare class RouteUtil 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[pathName](./foundation-utils.routeutil.pathname.md)
+
+
+</td><td>
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The current pathname of the window location.
+
+
+</td></tr>
+<tr><td>
+
+[shared](./foundation-utils.routeutil.shared.md)
+
+
+</td><td>
+
+`static`
+
+`readonly`
+
+
+</td><td>
+
+[RouteUtil](./foundation-utils.routeutil.md)
+
+
+</td><td>
+
+Gets the singleton instance of RouteUtil.
+
+
+</td></tr>
+</tbody></table>
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[destroy()](./foundation-utils.routeutil.destroy.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Clean up route detection listeners and polling.
+
+
+</td></tr>
+</tbody></table>
+

package/docs/api/foundation-utils.routeutil.pathname.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [RouteUtil](./foundation-utils.routeutil.md) &gt; [pathName](./foundation-utils.routeutil.pathname.md)
+
+## RouteUtil.pathName property
+
+The current pathname of the window location.
+
+**Signature:**
+
+```typescript
+pathName: string;
+```

package/docs/api/foundation-utils.routeutil.shared.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [RouteUtil](./foundation-utils.routeutil.md) &gt; [shared](./foundation-utils.routeutil.shared.md)
+
+## RouteUtil.shared property
+
+Gets the singleton instance of RouteUtil.
+
+**Signature:**
+
+```typescript
+static get shared(): RouteUtil;
+```

package/docs/api-report.md.api.md

@@ -1430,6 +1430,13 @@ export type ResourceType = (typeof ResourceType)[keyof typeof ResourceType];
 // @public
 export const respondToVisibility: (element: HTMLElement, callback: (arg0: boolean) => any) => (() => void);
 
+// @public
+export class RouteUtil {
+    destroy(): void;
+    pathName: string;
+    static get shared(): RouteUtil;
+}
+
 // @public
 export type ServerRowDTO = {
     DETAILS: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.400.0",
+  "version": "14.401.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -29,18 +29,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.400.0",
-    "@genesislcap/genx": "14.400.0",
-    "@genesislcap/rollup-builder": "14.400.0",
-    "@genesislcap/ts-builder": "14.400.0",
-    "@genesislcap/uvu-playwright-builder": "14.400.0",
-    "@genesislcap/vite-builder": "14.400.0",
-    "@genesislcap/webpack-builder": "14.400.0",
+    "@genesislcap/foundation-testing": "14.401.0",
+    "@genesislcap/genx": "14.401.0",
+    "@genesislcap/rollup-builder": "14.401.0",
+    "@genesislcap/ts-builder": "14.401.0",
+    "@genesislcap/uvu-playwright-builder": "14.401.0",
+    "@genesislcap/vite-builder": "14.401.0",
+    "@genesislcap/webpack-builder": "14.401.0",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "14.400.0",
-    "@genesislcap/foundation-logger": "14.400.0",
+    "@genesislcap/expression-builder": "14.401.0",
+    "@genesislcap/foundation-logger": "14.401.0",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.50.0",
@@ -58,5 +58,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "e95f4522e1f30ffbd0d7ac427199da5cc7df7de8"
+  "gitHead": "acec5783b3e1674b2be3d3a31c056264cef0c5f6"
 }