@genesislcap/foundation-utils 14.274.1 → 14.275.0

package/dist/custom-elements.json

@@ -367,6 +367,91 @@
         }
       ]
     },
+    {
+      "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",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./design-system"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/decorators/index.ts",
@@ -458,56 +543,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"
-        }
-      ],
-      "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",

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

@@ -51,4 +51,19 @@ export type DesignSystemResource<T = DesignSystemModule> = Promise<T>;
  * @public
  */
 export declare function assureDesignSystem(module: DesignSystemModule): DesignSystemModule;
+/**
+ * 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 declare function getCurrentDesignSystemPrefix(element: HTMLElement, fallbackPrefix: string): string;
 //# sourceMappingURL=design-system.d.ts.map

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;;;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"}
+{"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"}

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

@@ -1,3 +1,4 @@
+import { logger } from '../utils';
 /**
  * assureDesignSystem.
  *
@@ -45,3 +46,181 @@ 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.
+ * 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) {
+    // First try: Check element and its ancestors
+    let current = element;
+    while (current) {
+        const tagName = current.tagName.toLowerCase();
+        if (tagName.endsWith('-design-system-provider')) {
+            const prefix = tagName.split('-design-system-provider')[0];
+            if (prefix) {
+                logger.debug(`Found provider by ancestor search: ${tagName}, prefix: ${prefix}`);
+                return prefix;
+            }
+        }
+        // Move up the DOM tree, handling shadow DOM boundaries
+        if (current.parentElement) {
+            current = current.parentElement;
+        }
+        else if (current.getRootNode && current.getRootNode() instanceof ShadowRoot) {
+            current = current.getRootNode().host;
+        }
+        else {
+            current = null;
+        }
+    }
+    // Second try: Document-wide search
+    const allProviders = document.querySelectorAll('[class*="-design-system-provider"],[id*="-design-system-provider"]');
+    const providerElements = Array.from(allProviders);
+    // Add shadow DOM providers
+    const shadowProviders = getAllElements(document).filter((el) => {
+        var _a;
+        const tagName = (_a = el.tagName) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+        return (tagName === null || tagName === void 0 ? void 0 : tagName.endsWith('-design-system-provider')) || false;
+    });
+    providerElements.push(...shadowProviders);
+    if (providerElements.length > 0) {
+        const provider = providerElements[0];
+        const providerTag = provider.tagName.toLowerCase();
+        const prefix = providerTag.split('-design-system-provider')[0];
+        if (prefix) {
+            logger.debug(`Found provider by document search: ${providerTag}, prefix: ${prefix}`);
+            return prefix;
+        }
+    }
+    logger.debug(`No provider found. Falling back to ${fallbackPrefix}.`);
+    return fallbackPrefix;
+}

package/dist/foundation-utils.api.json

@@ -3716,6 +3716,68 @@
             }
           ]
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!getCurrentDesignSystemPrefix:function(1)",
+          "docComment": "/**\n * Get the current design system 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 The current design system prefix\n *\n * @example\n * ```ts\n * const prefix = getCurrentDesignSystemPrefix(myElement, 'default-prefix');\n * logger.debug(prefix); // e.g., 'rapid' or 'default-prefix'\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getCurrentDesignSystemPrefix(element: "
+            },
+            {
+              "kind": "Reference",
+              "text": "HTMLElement",
+              "canonicalReference": "!HTMLElement:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", fallbackPrefix: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/design-system/design-system.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 6
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "element",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "fallbackPrefix",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "getCurrentDesignSystemPrefix"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-utils!getDateFormatter:function(1)",

package/dist/foundation-utils.d.ts

@@ -521,6 +521,22 @@ export declare namespace Genesis {
  */
 export declare const GENESIS_SOCKET_URL: string;
 
+/**
+ * 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 declare function getCurrentDesignSystemPrefix(element: HTMLElement, fallbackPrefix: string): string;
+
 /**
  * @public
  */

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

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

package/docs/api/foundation-utils.md

@@ -32,6 +32,7 @@
 |  [formatDateTimestamp(timestamp)](./foundation-utils.formatdatetimestamp.md) | Formats \[DATE\] UNIX Timestamps (without time) to readable strings |
 |  [formatDateTimeTimestamp(timestamp)](./foundation-utils.formatdatetimetimestamp.md) | Formats \[DATETIME\] UNIX Timestamps (with time) to readable strings |
 |  [formatTimestamp(timestamp, withTime)](./foundation-utils.formattimestamp.md) | Formats \[DATE\|DATETIME\] Unix Timestamps to readable strings |
+|  [getCurrentDesignSystemPrefix(element, fallbackPrefix)](./foundation-utils.getcurrentdesignsystemprefix.md) | Get the current design system prefix by checking available providers. If no provider is found, falls back to the provided prefix. |
 |  [getDateFormatter(locale, options)](./foundation-utils.getdateformatter.md) |  |
 |  [getNumberFormatter(format, locale)](./foundation-utils.getnumberformatter.md) |  |
 |  [JSONReplacer(key, value)](./foundation-utils.jsonreplacer.md) | JSON replacer function. |

package/docs/api-report.md

@@ -297,6 +297,9 @@ export namespace Genesis {
 // @public
 export const GENESIS_SOCKET_URL: string;
 
+// @public
+export function getCurrentDesignSystemPrefix(element: HTMLElement, fallbackPrefix: string): string;
+
 // @public (undocumented)
 export function getDateFormatter(locale?: string, options?: Intl.DateTimeFormatOptions): (params: any) => string;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.274.1",
+  "version": "14.275.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -27,19 +27,19 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.274.1",
-    "@genesislcap/genx": "14.274.1",
-    "@genesislcap/rollup-builder": "14.274.1",
-    "@genesislcap/ts-builder": "14.274.1",
-    "@genesislcap/uvu-playwright-builder": "14.274.1",
-    "@genesislcap/vite-builder": "14.274.1",
-    "@genesislcap/webpack-builder": "14.274.1",
+    "@genesislcap/foundation-testing": "14.275.0",
+    "@genesislcap/genx": "14.275.0",
+    "@genesislcap/rollup-builder": "14.275.0",
+    "@genesislcap/ts-builder": "14.275.0",
+    "@genesislcap/uvu-playwright-builder": "14.275.0",
+    "@genesislcap/vite-builder": "14.275.0",
+    "@genesislcap/webpack-builder": "14.275.0",
     "@types/json-schema": "^7.0.11",
     "rimraf": "^5.0.0"
   },
   "dependencies": {
     "@genesislcap/expression-builder": "14.258.1",
-    "@genesislcap/foundation-logger": "14.274.1",
+    "@genesislcap/foundation-logger": "14.275.0",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.49.6",
@@ -57,5 +57,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "a4925dc9d6c9da09f282cc5255ade13937cba2cd"
+  "gitHead": "ce2f043a6de1db6be728298be2baf76d4586f705"
 }