@genesislcap/foundation-utils 14.307.2 → 14.307.4-alpha-0d4c6f2.0

package/dist/custom-elements.json

@@ -369,53 +369,120 @@
     },
     {
       "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",
+      "path": "src/design-system/design-system.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "renderOnChange",
+          "name": "assureDesignSystem",
+          "return": {
+            "type": {
+              "text": "DesignSystemModule"
+            }
+          },
           "parameters": [
             {
-              "name": "target",
+              "name": "module",
               "type": {
-                "text": "FASTElement & { render(): void }"
+                "text": "DesignSystemModule"
+              }
+            }
+          ],
+          "description": "assureDesignSystem.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getCurrentDesignSystem",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
               },
-              "description": "The target to define the property change handler on."
+              "description": "The starting HTML element"
             },
             {
-              "name": "name",
+              "name": "fallbackPrefix",
               "type": {
                 "text": "string"
               },
-              "description": "The property name."
+              "description": "The prefix to fallback to if the provider is not available"
             }
           ],
-          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
+          "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": "renderOnChange",
+          "name": "assureDesignSystem",
           "declaration": {
-            "name": "renderOnChange",
-            "module": "src/decorators/renderOnChange.ts"
+            "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"
           }
         }
       ]
@@ -445,7 +512,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/encoding/index.ts",
+      "path": "src/decorators/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -453,7 +520,45 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./base64"
+            "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"
           }
         }
       ]
@@ -918,77 +1023,7 @@
     },
     {
       "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": "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": "getCurrentDesignSystemPrefix",
-          "declaration": {
-            "name": "getCurrentDesignSystemPrefix",
-            "module": "src/design-system/design-system.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/design-system/index.ts",
+      "path": "src/encoding/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -996,7 +1031,7 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./design-system"
+            "package": "./base64"
           }
         }
       ]
@@ -1976,72 +2011,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/styles/dom.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "insertDocumentCSSRule",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "cssRule",
-              "type": {
-                "text": "string"
-              },
-              "description": "The CSS rule to insert."
-            },
-            {
-              "name": "styleElementId",
-              "type": {
-                "text": "string"
-              },
-              "description": "The ID of the style element to use or create."
-            }
-          ],
-          "description": "Inserts a CSS rule into the document by creating a new style element or using an existing one with the specified ID.\nReturns a function that can be called to remove the rule from the document.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "insertDocumentLink",
-          "parameters": [
-            {
-              "name": "href",
-              "type": {
-                "text": "string"
-              },
-              "description": "The URL of the CSS file to insert."
-            }
-          ],
-          "description": "Inserts a CSS link into the document if it doesn't already exist.",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "insertDocumentCSSRule",
-          "declaration": {
-            "name": "insertDocumentCSSRule",
-            "module": "src/styles/dom.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "insertDocumentLink",
-          "declaration": {
-            "name": "insertDocumentLink",
-            "module": "src/styles/dom.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/styles/index.ts",
@@ -2055,14 +2024,6 @@
             "package": "./color"
           }
         },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./dom"
-          }
-        },
         {
           "kind": "js",
           "name": "*",
@@ -2337,6 +2298,99 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/dom.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "insertDocumentCSSRule",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "cssRule",
+              "type": {
+                "text": "string"
+              },
+              "description": "The CSS rule to insert."
+            },
+            {
+              "name": "styleElementId",
+              "type": {
+                "text": "string"
+              },
+              "description": "The ID of the style element to use or create."
+            }
+          ],
+          "description": "Inserts a CSS rule into the document by creating a new style element or using an existing one with the specified ID.\nReturns a function that can be called to remove the rule from the document.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "insertDocumentLink",
+          "parameters": [
+            {
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "description": "The URL of the CSS file to insert."
+            }
+          ],
+          "description": "Inserts a CSS link into the document if it doesn't already exist.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getAllElements",
+          "return": {
+            "type": {
+              "text": "Element[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "root",
+              "type": {
+                "text": "Element | Document"
+              }
+            }
+          ],
+          "description": "Recursively gather all elements including those in shadow DOM",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "insertDocumentCSSRule",
+          "declaration": {
+            "name": "insertDocumentCSSRule",
+            "module": "src/utils/dom.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "insertDocumentLink",
+          "declaration": {
+            "name": "insertDocumentLink",
+            "module": "src/utils/dom.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getAllElements",
+          "declaration": {
+            "name": "getAllElements",
+            "module": "src/utils/dom.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/index.ts",
@@ -2350,6 +2404,14 @@
             "package": "./delay"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./dom"
+          }
+        },
         {
           "kind": "js",
           "name": "*",

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

@@ -51,6 +51,25 @@ export type DesignSystemResource<T = DesignSystemModule> = Promise<T>;
  * @public
  */
 export declare function assureDesignSystem(module: DesignSystemModule): DesignSystemModule;
+/**
+ * Get the current design system provider element and prefix by checking available providers.
+ * If no provider is found, falls back to the provided prefix.
+ * @param element - The starting HTML element
+ * @param fallbackPrefix - The prefix to fallback to if the provider is not available
+ * @returns An object containing the current design system provider element and prefix
+ *
+ * @example
+ * ```ts
+ * const { element: providerElement, prefix } = getCurrentDesignSystem(myElement, 'default-prefix');
+ * logger.debug(prefix); // e.g., 'rapid' or 'default-prefix'
+ * logger.debug(providerElement); // The provider element or null
+ * ```
+ * @public
+ */
+export declare function getCurrentDesignSystem(element: HTMLElement, fallbackPrefix: string): {
+    element: HTMLElement | null;
+    prefix: string;
+};
 /**
  * Get the current design system prefix by checking available providers.
  * If no provider is found, falls back to the provided prefix.

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;AAG1D;;;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;AAmJD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAiDjG"}
+{"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;AAG1D;;;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;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,MAAM,GACrB;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiDjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEjG"}

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

@@ -1,5 +1,4 @@
 export * from './color';
-export * from './dom';
 export * from './slotted-styles';
 export * from './typography';
 export * from './toElementStyles';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/styles/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/styles/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/dts/{styles → utils}/dom.d.ts

@@ -13,4 +13,9 @@ export declare const insertDocumentCSSRule: (cssRule: string, styleElementId: st
  * @param href - The URL of the CSS file to insert.
  */
 export declare const insertDocumentLink: (href: string) => void;
+/**
+ * Recursively gather all elements including those in shadow DOM
+ * @public
+ */
+export declare function getAllElements(root: Element | Document): Element[];
 //# sourceMappingURL=dom.d.ts.map

package/dist/dts/utils/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/utils/dom.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,gBAAgB,MAAM,KAAG,CAAC,MAAM,IAAI,CAyC1F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,SAQ9C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,EAAE,CAoBlE"}

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

@@ -1,3 +1,4 @@
 export * from './delay';
+export * from './dom';
 export * from './logger';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}

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

@@ -1,4 +1,4 @@
-import { logger } from '../utils';
+import { getAllElements, logger } from '../utils';
 /**
  * assureDesignSystem.
  *
@@ -47,139 +47,21 @@ export function assureDesignSystem(module) {
     return module;
 }
 /**
- * Recursively gather all elements including those in shadow DOM
- * @private
- */
-function getAllElements(root) {
-    const elements = [];
-    const processedShadowRoots = new Set();
-    function collectElements(node) {
-        // Get all elements in the current node
-        const nodeElements = Array.from(node.querySelectorAll('*'));
-        elements.push(...nodeElements);
-        // Process shadow roots
-        nodeElements.forEach((el) => {
-            if (el.shadowRoot && !processedShadowRoots.has(el.shadowRoot)) {
-                processedShadowRoots.add(el.shadowRoot);
-                collectElements(el.shadowRoot);
-            }
-        });
-    }
-    collectElements(root);
-    return elements;
-}
-/**
- * Find design system providers in the document, including those in shadow DOM
- * Prioritizes providers that are closest to the specified element
- * @private
- */
-function findProvidersByDocumentSearch(targetElement) {
-    // Get all elements including those in shadow DOM
-    const allElements = getAllElements(document);
-    logger.debug(`Total elements found including shadow DOM: ${allElements.length}`);
-    // Find elements with tag names ending in -design-system-provider
-    const providerElements = allElements.filter((el) => {
-        var _a;
-        const tagName = (_a = el.tagName) === null || _a === void 0 ? void 0 : _a.toLowerCase();
-        if (!tagName)
-            return false;
-        const isProvider = tagName.endsWith('-design-system-provider');
-        if (isProvider) {
-            logger.debug(`Found provider in document: ${tagName}`);
-        }
-        return isProvider;
-    });
-    if (providerElements.length === 0) {
-        logger.debug(`No design-system-provider elements found in document`);
-        return null;
-    }
-    logger.debug(`Found ${providerElements.length} design-system-provider elements in document`);
-    // If only one provider found, use it
-    if (providerElements.length === 1) {
-        const provider = providerElements[0];
-        const providerTag = provider.tagName.toLowerCase();
-        const prefix = providerTag.split('-design-system-provider')[0];
-        if (prefix) {
-            logger.debug(`Only one provider found: ${providerTag} with prefix: ${prefix}`);
-            return prefix;
-        }
-        return null;
-    }
-    // Multiple providers - find the closest one to our target element
-    // First, check if any provider is an ancestor of our element
-    let closestAncestor = null;
-    let closestAncestorDepth = Infinity;
-    // Start from element's parent and move up
-    let currentEl = targetElement.parentElement;
-    let depth = 1;
-    while (currentEl) {
-        const tagName = currentEl.tagName.toLowerCase();
-        if (tagName.endsWith('-design-system-provider')) {
-            // Found a direct ancestor that is a provider
-            closestAncestor = currentEl;
-            closestAncestorDepth = depth;
-            break;
-        }
-        currentEl = currentEl.parentElement;
-        depth += 1;
-    }
-    if (closestAncestor) {
-        // We found an ancestor that is a provider
-        const providerTag = closestAncestor.tagName.toLowerCase();
-        const prefix = providerTag.split('-design-system-provider')[0];
-        logger.debug(`Found ancestor provider at depth ${closestAncestorDepth}: ${providerTag} with prefix: ${prefix}`);
-        return prefix || null;
-    }
-    // No ancestor is a provider - check document order
-    // Calculate each provider's proximity to our element in the DOM
-    // Sort by DOM proximity (closest first)
-    const providersWithDistance = providerElements.map((provider) => {
-        var _a, _b;
-        const providerTag = provider.tagName.toLowerCase();
-        const prefix = providerTag.split('-design-system-provider')[0];
-        // Use TreeWalker to calculate DOM distance
-        const nodePositionMap = new Map();
-        let counter = 0;
-        // Build a map of nodes to positions
-        const walker = document.createTreeWalker(document.documentElement, NodeFilter.SHOW_ELEMENT);
-        let current = walker.currentNode;
-        while (current) {
-            nodePositionMap.set(current, counter);
-            counter += 1;
-            current = walker.nextNode();
-        }
-        // Get positions or maximum value if node not in map
-        const providerPosition = (_a = nodePositionMap.get(provider)) !== null && _a !== void 0 ? _a : Number.MAX_SAFE_INTEGER;
-        const targetPosition = (_b = nodePositionMap.get(targetElement)) !== null && _b !== void 0 ? _b : Number.MAX_SAFE_INTEGER;
-        // Calculate distance as the absolute difference in positions
-        const distance = Math.abs(providerPosition - targetPosition);
-        return { provider, prefix: prefix || '', distance };
-    });
-    // Sort by distance (closest first)
-    providersWithDistance.sort((a, b) => a.distance - b.distance);
-    // Use the closest provider
-    if (providersWithDistance.length > 0 && providersWithDistance[0].prefix) {
-        const closestProvider = providersWithDistance[0];
-        logger.debug(`Using closest provider: ${closestProvider.provider.tagName.toLowerCase()} with prefix: ${closestProvider.prefix} (distance: ${closestProvider.distance})`);
-        return closestProvider.prefix;
-    }
-    return null;
-}
-/**
- * Get the current design system prefix by checking available providers.
+ * Get the current design system provider element and prefix by checking available providers.
  * If no provider is found, falls back to the provided prefix.
  * @param element - The starting HTML element
  * @param fallbackPrefix - The prefix to fallback to if the provider is not available
- * @returns The current design system prefix
+ * @returns An object containing the current design system provider element and prefix
  *
  * @example
  * ```ts
- * const prefix = getCurrentDesignSystemPrefix(myElement, 'default-prefix');
+ * const { element: providerElement, prefix } = getCurrentDesignSystem(myElement, 'default-prefix');
  * logger.debug(prefix); // e.g., 'rapid' or 'default-prefix'
+ * logger.debug(providerElement); // The provider element or null
  * ```
  * @public
  */
-export function getCurrentDesignSystemPrefix(element, fallbackPrefix) {
+export function getCurrentDesignSystem(element, fallbackPrefix) {
     // First try: Check element and its ancestors
     let current = element;
     while (current) {
@@ -188,7 +70,7 @@ export function getCurrentDesignSystemPrefix(element, fallbackPrefix) {
             const prefix = tagName.split('-design-system-provider')[0];
             if (prefix) {
                 logger.debug(`Found provider by ancestor search: ${tagName}, prefix: ${prefix}`);
-                return prefix;
+                return { element: current, prefix };
             }
         }
         // Move up the DOM tree, handling shadow DOM boundaries
@@ -218,9 +100,26 @@ export function getCurrentDesignSystemPrefix(element, fallbackPrefix) {
         const prefix = providerTag.split('-design-system-provider')[0];
         if (prefix) {
             logger.debug(`Found provider by document search: ${providerTag}, prefix: ${prefix}`);
-            return prefix;
+            return { element: provider, prefix };
         }
     }
     logger.debug(`No provider found. Falling back to ${fallbackPrefix}.`);
-    return fallbackPrefix;
+    return { element: null, prefix: fallbackPrefix };
+}
+/**
+ * Get the current design system prefix by checking available providers.
+ * If no provider is found, falls back to the provided prefix.
+ * @param element - The starting HTML element
+ * @param fallbackPrefix - The prefix to fallback to if the provider is not available
+ * @returns The current design system prefix
+ *
+ * @example
+ * ```ts
+ * const prefix = getCurrentDesignSystemPrefix(myElement, 'default-prefix');
+ * logger.debug(prefix); // e.g., 'rapid' or 'default-prefix'
+ * ```
+ * @public
+ */
+export function getCurrentDesignSystemPrefix(element, fallbackPrefix) {
+    return getCurrentDesignSystem(element, fallbackPrefix).prefix;
 }

package/dist/esm/styles/index.js

@@ -1,5 +1,4 @@
 export * from './color';
-export * from './dom';
 export * from './slotted-styles';
 export * from './typography';
 export * from './toElementStyles';

package/dist/esm/styles/typography.js

@@ -1,4 +1,4 @@
-import { insertDocumentCSSRule } from './dom';
+import { insertDocumentCSSRule } from '../utils/dom';
 /**
  * Loads font faces by inserting a style element with the specified font face rules into the document.
  * @param fontFaceRules - The CSS rules for the font faces.

package/dist/esm/{styles → utils}/dom.js

@@ -1,4 +1,4 @@
-import { logger } from '../utils/logger';
+import { logger } from './logger';
 /**
  * Inserts a CSS rule into the document by creating a new style element or using an existing one with the specified ID.
  * Returns a function that can be called to remove the rule from the document.
@@ -60,3 +60,25 @@ export const insertDocumentLink = (href) => {
     link.href = href;
     document.head.appendChild(link);
 };
+/**
+ * Recursively gather all elements including those in shadow DOM
+ * @public
+ */
+export function getAllElements(root) {
+    const elements = [];
+    const processedShadowRoots = new Set();
+    function collectElements(node) {
+        // Get all elements in the current node
+        const nodeElements = Array.from(node.querySelectorAll('*'));
+        elements.push(...nodeElements);
+        // Process shadow roots
+        nodeElements.forEach((el) => {
+            if (el.shadowRoot && !processedShadowRoots.has(el.shadowRoot)) {
+                processedShadowRoots.add(el.shadowRoot);
+                collectElements(el.shadowRoot);
+            }
+        });
+    }
+    collectElements(root);
+    return elements;
+}

package/dist/esm/utils/index.js

@@ -1,2 +1,3 @@
 export * from './delay';
+export * from './dom';
 export * from './logger';

package/dist/foundation-utils.api.json

@@ -3923,6 +3923,137 @@
             }
           ]
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!getAllElements:function(1)",
+          "docComment": "/**\n * Recursively gather all elements including those in shadow DOM\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getAllElements(root: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Element",
+              "canonicalReference": "!Element:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " | "
+            },
+            {
+              "kind": "Reference",
+              "text": "Document",
+              "canonicalReference": "!Document:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Element",
+              "canonicalReference": "!Element:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/utils/dom.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 7
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "root",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "getAllElements"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!getCurrentDesignSystem:function(1)",
+          "docComment": "/**\n * Get the current design system provider element and prefix by checking available providers. If no provider is found, falls back to the provided prefix.\n *\n * @param element - The starting HTML element\n *\n * @param fallbackPrefix - The prefix to fallback to if the provider is not available\n *\n * @returns An object containing the current design system provider element and prefix\n *\n * @example\n * ```ts\n * const { element: providerElement, prefix } = getCurrentDesignSystem(myElement, 'default-prefix');\n * logger.debug(prefix); // e.g., 'rapid' or 'default-prefix'\n * logger.debug(providerElement); // The provider element or null\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getCurrentDesignSystem(element: "
+            },
+            {
+              "kind": "Reference",
+              "text": "HTMLElement",
+              "canonicalReference": "!HTMLElement:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", fallbackPrefix: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    element: "
+            },
+            {
+              "kind": "Reference",
+              "text": "HTMLElement",
+              "canonicalReference": "!HTMLElement:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " | null;\n    prefix: string;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/design-system/design-system.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 8
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "element",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "fallbackPrefix",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "getCurrentDesignSystem"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-utils!getCurrentDesignSystemPrefix:function(1)",
@@ -4842,7 +4973,7 @@
               "text": "(() => void)"
             }
           ],
-          "fileUrlPath": "src/styles/dom.ts",
+          "fileUrlPath": "src/utils/dom.ts",
           "returnTypeTokenRange": {
             "startIndex": 5,
             "endIndex": 6
@@ -4891,7 +5022,7 @@
               "text": "void"
             }
           ],
-          "fileUrlPath": "src/styles/dom.ts",
+          "fileUrlPath": "src/utils/dom.ts",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 4

package/dist/foundation-utils.d.ts

@@ -545,6 +545,32 @@ export declare namespace Genesis {
  */
 export declare const GENESIS_SOCKET_URL: string;
 
+/**
+ * Recursively gather all elements including those in shadow DOM
+ * @public
+ */
+export declare function getAllElements(root: Element | Document): Element[];
+
+/**
+ * Get the current design system provider element and prefix by checking available providers.
+ * If no provider is found, falls back to the provided prefix.
+ * @param element - The starting HTML element
+ * @param fallbackPrefix - The prefix to fallback to if the provider is not available
+ * @returns An object containing the current design system provider element and prefix
+ *
+ * @example
+ * ```ts
+ * const { element: providerElement, prefix } = getCurrentDesignSystem(myElement, 'default-prefix');
+ * logger.debug(prefix); // e.g., 'rapid' or 'default-prefix'
+ * logger.debug(providerElement); // The provider element or null
+ * ```
+ * @public
+ */
+export declare function getCurrentDesignSystem(element: HTMLElement, fallbackPrefix: string): {
+    element: HTMLElement | null;
+    prefix: string;
+};
+
 /**
  * Get the current design system prefix by checking available providers.
  * If no provider is found, falls back to the provided prefix.

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

@@ -0,0 +1,52 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [getAllElements](./foundation-utils.getallelements.md)
+
+## getAllElements() function
+
+Recursively gather all elements including those in shadow DOM
+
+**Signature:**
+
+```typescript
+export declare function getAllElements(root: Element | Document): Element[];
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+root
+
+
+</td><td>
+
+Element \| Document
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Element\[\]
+

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

@@ -0,0 +1,84 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [getCurrentDesignSystem](./foundation-utils.getcurrentdesignsystem.md)
+
+## getCurrentDesignSystem() function
+
+Get the current design system provider element and prefix by checking available providers. If no provider is found, falls back to the provided prefix.
+
+**Signature:**
+
+```typescript
+export declare function getCurrentDesignSystem(element: HTMLElement, fallbackPrefix: string): {
+    element: HTMLElement | null;
+    prefix: string;
+};
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+element
+
+
+</td><td>
+
+HTMLElement
+
+
+</td><td>
+
+The starting HTML element
+
+
+</td></tr>
+<tr><td>
+
+fallbackPrefix
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The prefix to fallback to if the provider is not available
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+{ element: HTMLElement \| null; prefix: string; }
+
+An object containing the current design system provider element and prefix
+
+## Example
+
+
+```ts
+const { element: providerElement, prefix } = getCurrentDesignSystem(myElement, 'default-prefix');
+logger.debug(prefix); // e.g., 'rapid' or 'default-prefix'
+logger.debug(providerElement); // The provider element or null
+```
+

package/docs/api/foundation-utils.md

@@ -286,6 +286,28 @@ Formats \[DATETIME\] UNIX Timestamps (with time and milliseconds) to readable st
 Formats \[DATE\|DATETIME\] Unix Timestamps to readable strings
 
 
+</td></tr>
+<tr><td>
+
+[getAllElements(root)](./foundation-utils.getallelements.md)
+
+
+</td><td>
+
+Recursively gather all elements including those in shadow DOM
+
+
+</td></tr>
+<tr><td>
+
+[getCurrentDesignSystem(element, fallbackPrefix)](./foundation-utils.getcurrentdesignsystem.md)
+
+
+</td><td>
+
+Get the current design system provider element and prefix by checking available providers. If no provider is found, falls back to the provided prefix.
+
+
 </td></tr>
 <tr><td>
 

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

@@ -306,6 +306,15 @@ export namespace Genesis {
 // @public
 export const GENESIS_SOCKET_URL: string;
 
+// @public
+export function getAllElements(root: Element | Document): Element[];
+
+// @public
+export function getCurrentDesignSystem(element: HTMLElement, fallbackPrefix: string): {
+    element: HTMLElement | null;
+    prefix: string;
+};
+
 // @public
 export function getCurrentDesignSystemPrefix(element: HTMLElement, fallbackPrefix: string): string;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.307.2",
+  "version": "14.307.4-alpha-0d4c6f2.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -27,18 +27,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.307.2",
-    "@genesislcap/genx": "14.307.2",
-    "@genesislcap/rollup-builder": "14.307.2",
-    "@genesislcap/ts-builder": "14.307.2",
-    "@genesislcap/uvu-playwright-builder": "14.307.2",
-    "@genesislcap/vite-builder": "14.307.2",
-    "@genesislcap/webpack-builder": "14.307.2",
+    "@genesislcap/foundation-testing": "14.307.4-alpha-0d4c6f2.0",
+    "@genesislcap/genx": "14.307.4-alpha-0d4c6f2.0",
+    "@genesislcap/rollup-builder": "14.307.4-alpha-0d4c6f2.0",
+    "@genesislcap/ts-builder": "14.307.4-alpha-0d4c6f2.0",
+    "@genesislcap/uvu-playwright-builder": "14.307.4-alpha-0d4c6f2.0",
+    "@genesislcap/vite-builder": "14.307.4-alpha-0d4c6f2.0",
+    "@genesislcap/webpack-builder": "14.307.4-alpha-0d4c6f2.0",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "14.307.2",
-    "@genesislcap/foundation-logger": "14.307.2",
+    "@genesislcap/expression-builder": "14.307.4-alpha-0d4c6f2.0",
+    "@genesislcap/foundation-logger": "14.307.4-alpha-0d4c6f2.0",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.49.6",
@@ -55,5 +55,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "a3bfd4199f20640443c512431840c7e8dedc5b4c"
+  "gitHead": "ae54a5f20a2e08cc8447cd248cf5703062e0b13a"
 }

package/dist/dts/styles/dom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/styles/dom.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,gBAAgB,MAAM,KAAG,CAAC,MAAM,IAAI,CAyC1F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,SAQ9C,CAAC"}