@cloudscape-design/components-themeable 3.0.1210 → 3.0.1212

package/lib/internal/template/internal/hooks/use-base-component/styles-check.js

@@ -3,7 +3,7 @@
 import { useEffect } from 'react';
 import { GIT_SHA, PACKAGE_VERSION, THEME } from '../../environment';
 import { metrics } from '../../metrics';
-export function checkMissingStyles(ownerDocument) {
+function checkMissingStyles(ownerDocument) {
     if (!ownerDocument.defaultView) {
         // skip the check if this iframe is detached
         return;
@@ -23,17 +23,36 @@ function documentReady(document, callback) {
         (_a = document.defaultView) === null || _a === void 0 ? void 0 : _a.addEventListener('load', () => callback(), { once: true });
     }
 }
-export function documentReadyAndIdle(document, signal) {
-    return new Promise((resolve, reject) => {
+async function documentReadyAndIdle(document, signal) {
+    await new Promise((resolve, reject) => {
         signal.addEventListener('abort', () => reject(new DOMException('Aborted', 'AbortError')));
         documentReady(document, () => {
-            setTimeout(() => {
-                requestIdleCallback(() => resolve());
-            }, 1000);
+            setTimeout(() => requestIdleCallback(() => resolve()), 1000);
         });
     });
+    const stylesheets = Array.from(document.querySelectorAll('link[rel="stylesheet"]'));
+    await Promise.all(stylesheets.map(link => {
+        // already loaded
+        if (link.sheet) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve, reject) => {
+            function cleanup(done) {
+                link.removeEventListener('load', onLoad);
+                link.removeEventListener('error', onError);
+                signal.removeEventListener('abort', onAbort);
+                done();
+            }
+            const onLoad = () => cleanup(resolve);
+            const onError = () => cleanup(resolve);
+            const onAbort = () => cleanup(() => reject(new DOMException('Aborted', 'AbortError')));
+            link.addEventListener('load', onLoad);
+            link.addEventListener('error', onError);
+            signal.addEventListener('abort', onAbort);
+        });
+    }));
 }
-const checkedDocs = new WeakMap();
+let checkedDocs = new WeakMap();
 const checkMissingStylesOnce = (document) => {
     const checked = checkedDocs.get(document);
     if (!checked) {
@@ -41,6 +60,7 @@ const checkMissingStylesOnce = (document) => {
         checkedDocs.set(document, true);
     }
 };
+export const __testResetCheckedDocs = () => (checkedDocs = new WeakMap());
 export function useMissingStylesCheck(elementRef) {
     useEffect(() => {
         var _a, _b;

package/lib/internal/template/internal/hooks/use-base-component/styles-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"styles-check.js","sourceRoot":"","sources":["../../../../../src/internal/hooks/use-base-component/styles-check.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport React, { useEffect } from 'react';\n\nimport { GIT_SHA, PACKAGE_VERSION, THEME } from '../../environment';\nimport { metrics } from '../../metrics';\n\nexport function checkMissingStyles(ownerDocument: Document) {\n  if (!ownerDocument.defaultView) {\n    // skip the check if this iframe is detached\n    return;\n  }\n  const result = getComputedStyle(ownerDocument.body).getPropertyValue(`--awsui-version-info-${GIT_SHA}`);\n  if (!result) {\n    console.error(`Missing AWS-UI CSS for theme \"${THEME}\", version \"${PACKAGE_VERSION}\", and git sha \"${GIT_SHA}\".`);\n    metrics.sendOpsMetricObject('awsui-missing-css-asset', {});\n  }\n}\n\nfunction documentReady(document: Document, callback: () => void) {\n  if (document.readyState === 'complete') {\n    callback();\n  } else {\n    document.defaultView?.addEventListener('load', () => callback(), { once: true });\n  }\n}\n\nexport function documentReadyAndIdle(document: Document, signal: AbortSignal) {\n  return new Promise<void>((resolve, reject) => {\n    signal.addEventListener('abort', () => reject(new DOMException('Aborted', 'AbortError')));\n    documentReady(document, () => {\n      setTimeout(() => {\n        requestIdleCallback(() => resolve());\n      }, 1000);\n    });\n  });\n}\n\nconst checkedDocs = new WeakMap<Document, boolean>();\nconst checkMissingStylesOnce = (document: Document) => {\n  const checked = checkedDocs.get(document);\n  if (!checked) {\n    checkMissingStyles(document);\n    checkedDocs.set(document, true);\n  }\n};\n\nexport function useMissingStylesCheck(elementRef: React.RefObject<HTMLElement>) {\n  useEffect(() => {\n    // if idle callbacks not supported, we simply do not collect the metric\n    if (typeof requestIdleCallback !== 'function') {\n      return;\n    }\n    const ownerDocument = elementRef.current?.ownerDocument ?? document;\n    const abortController = new AbortController();\n    documentReadyAndIdle(ownerDocument, abortController.signal).then(\n      () => checkMissingStylesOnce(ownerDocument),\n      error => {\n        // istanbul ignore next\n        if (error.name !== 'AbortError') {\n          throw error;\n        }\n      }\n    );\n    return () => abortController.abort();\n  }, [elementRef]);\n}\n"]}
+{"version":3,"file":"styles-check.js","sourceRoot":"","sources":["../../../../../src/internal/hooks/use-base-component/styles-check.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport React, { useEffect } from 'react';\n\nimport { GIT_SHA, PACKAGE_VERSION, THEME } from '../../environment';\nimport { metrics } from '../../metrics';\n\nfunction checkMissingStyles(ownerDocument: Document) {\n  if (!ownerDocument.defaultView) {\n    // skip the check if this iframe is detached\n    return;\n  }\n\n  const result = getComputedStyle(ownerDocument.body).getPropertyValue(`--awsui-version-info-${GIT_SHA}`);\n  if (!result) {\n    console.error(`Missing AWS-UI CSS for theme \"${THEME}\", version \"${PACKAGE_VERSION}\", and git sha \"${GIT_SHA}\".`);\n    metrics.sendOpsMetricObject('awsui-missing-css-asset', {});\n  }\n}\n\nfunction documentReady(document: Document, callback: () => void) {\n  if (document.readyState === 'complete') {\n    callback();\n  } else {\n    document.defaultView?.addEventListener('load', () => callback(), { once: true });\n  }\n}\n\nasync function documentReadyAndIdle(document: Document, signal: AbortSignal) {\n  await new Promise<void>((resolve, reject) => {\n    signal.addEventListener('abort', () => reject(new DOMException('Aborted', 'AbortError')));\n    documentReady(document, () => {\n      setTimeout(() => requestIdleCallback(() => resolve()), 1000);\n    });\n  });\n\n  const stylesheets = Array.from(document.querySelectorAll<HTMLLinkElement>('link[rel=\"stylesheet\"]'));\n  await Promise.all(\n    stylesheets.map(link => {\n      // already loaded\n      if (link.sheet) {\n        return Promise.resolve();\n      }\n      return new Promise<void>((resolve, reject) => {\n        function cleanup(done: () => void) {\n          link.removeEventListener('load', onLoad);\n          link.removeEventListener('error', onError);\n          signal.removeEventListener('abort', onAbort);\n          done();\n        }\n        const onLoad = () => cleanup(resolve);\n        const onError = () => cleanup(resolve);\n        const onAbort = () => cleanup(() => reject(new DOMException('Aborted', 'AbortError')));\n\n        link.addEventListener('load', onLoad);\n        link.addEventListener('error', onError);\n        signal.addEventListener('abort', onAbort);\n      });\n    })\n  );\n}\n\nlet checkedDocs = new WeakMap<Document, boolean>();\nconst checkMissingStylesOnce = (document: Document) => {\n  const checked = checkedDocs.get(document);\n  if (!checked) {\n    checkMissingStyles(document);\n    checkedDocs.set(document, true);\n  }\n};\n\nexport const __testResetCheckedDocs = () => (checkedDocs = new WeakMap());\n\nexport function useMissingStylesCheck(elementRef: React.RefObject<HTMLElement>) {\n  useEffect(() => {\n    // if idle callbacks not supported, we simply do not collect the metric\n    if (typeof requestIdleCallback !== 'function') {\n      return;\n    }\n    const ownerDocument = elementRef.current?.ownerDocument ?? document;\n    const abortController = new AbortController();\n    documentReadyAndIdle(ownerDocument, abortController.signal).then(\n      () => checkMissingStylesOnce(ownerDocument),\n      error => {\n        // istanbul ignore next\n        if (error.name !== 'AbortError') {\n          throw error;\n        }\n      }\n    );\n    return () => abortController.abort();\n  }, [elementRef]);\n}\n"]}

package/lib/internal/template/internal/utils/flatten-children.d.ts

@@ -0,0 +1,3 @@
+import { ReactNode } from 'react';
+export declare function flattenChildren(children: ReactNode): ReactNode[];
+//# sourceMappingURL=flatten-children.d.ts.map

package/lib/internal/template/internal/utils/flatten-children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-children.d.ts","sourceRoot":"","sources":["../../../../src/internal/utils/flatten-children.ts"],"names":[],"mappings":"AAEA,OAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGzC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAWhE"}

package/lib/internal/template/internal/utils/flatten-children.js

@@ -0,0 +1,17 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import React from 'react';
+import flattenChildrenLegacy from 'react-keyed-flatten-children';
+export function flattenChildren(children) {
+    var _a;
+    const versionString = (_a = React.version) === null || _a === void 0 ? void 0 : _a.split('.')[0];
+    const majorVersion = versionString ? parseInt(versionString, 10) : NaN;
+    if (!Number.isNaN(majorVersion) && majorVersion < 19) {
+        // React 16-18: Use react-keyed-flatten-children for backward compatibility
+        return flattenChildrenLegacy(children);
+    }
+    // React 19+: Uses Children.toArray() which doesn't flatten fragments.
+    // This also supports bigint which is not available in earlier React versions.
+    return React.Children.toArray(children);
+}
+//# sourceMappingURL=flatten-children.js.map

package/lib/internal/template/internal/utils/flatten-children.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-children.js","sourceRoot":"","sources":["../../../../src/internal/utils/flatten-children.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sCAAsC;AACtC,OAAO,KAAoB,MAAM,OAAO,CAAC;AACzC,OAAO,qBAAqB,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,eAAe,CAAC,QAAmB;;IACjD,MAAM,aAAa,GAAG,MAAA,KAAK,CAAC,OAAO,0CAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAEvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACrD,2EAA2E;QAC3E,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IACD,sEAAsE;IACtE,8EAA8E;IAC9E,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport React, { ReactNode } from 'react';\nimport flattenChildrenLegacy from 'react-keyed-flatten-children';\n\nexport function flattenChildren(children: ReactNode): ReactNode[] {\n  const versionString = React.version?.split('.')[0];\n  const majorVersion = versionString ? parseInt(versionString, 10) : NaN;\n\n  if (!Number.isNaN(majorVersion) && majorVersion < 19) {\n    // React 16-18: Use react-keyed-flatten-children for backward compatibility\n    return flattenChildrenLegacy(children);\n  }\n  // React 19+: Uses Children.toArray() which doesn't flatten fragments.\n  // This also supports bigint which is not available in earlier React versions.\n  return React.Children.toArray(children);\n}\n"]}

package/lib/internal/template/link/interfaces.d.ts

@@ -91,6 +91,8 @@ export interface LinkProps extends BaseComponentProps {
      */
     rel?: string;
     /**
+     * An object containing CSS properties to customize the link's visual appearance.
+     * Refer to the [style](/components/link/?tabId=style) tab for more details.
      * @awsuiSystem core
      */
     style?: LinkProps.Style;

package/lib/internal/template/link/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/link/interfaces.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,IAAI,YAAY,EAC3B,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAE5E,MAAM,WAAW,SAAU,SAAQ,kBAAkB;IACnD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC;IAE9B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAE1D;;OAEG;IACH,OAAO,CAAC,EAAE,yBAAyB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE3D;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAExB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC;CACpF;AAED,yBAAiB,SAAS,CAAC;IACzB,KAAY,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,mBAAmB,CAAC;IAC7E,KAAY,QAAQ,GAChB,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,GACZ,WAAW,GACX,SAAS,CAAC;IACd,KAAY,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;IAE1C,KAAY,YAAY,GAAG,oBAAoB,CAAC;IAEhD,UAAiB,GAAG;QAClB;;WAEG;QACH,KAAK,IAAI,IAAI,CAAC;KACf;IAED,KAAY,WAAW,GAAG,YAAY,CAAC;IACvC,UAAiB,KAAK;QACpB,IAAI,CAAC,EAAE;YACL,KAAK,CAAC,EAAE;gBACN,MAAM,CAAC,EAAE,MAAM,CAAC;gBAChB,OAAO,CAAC,EAAE,MAAM,CAAC;gBACjB,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC;YACF,SAAS,CAAC,EAAE;gBACV,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,YAAY,CAAC,EAAE,MAAM,CAAC;gBACtB,WAAW,CAAC,EAAE,MAAM,CAAC;aACtB,CAAC;SACH,CAAC;KACH;CACF"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/link/interfaces.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,IAAI,YAAY,EAC3B,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAE5E,MAAM,WAAW,SAAU,SAAQ,kBAAkB;IACnD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC;IAE9B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAE1D;;OAEG;IACH,OAAO,CAAC,EAAE,yBAAyB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE3D;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAExB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC;CACpF;AAED,yBAAiB,SAAS,CAAC;IACzB,KAAY,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,mBAAmB,CAAC;IAC7E,KAAY,QAAQ,GAChB,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,GACZ,WAAW,GACX,SAAS,CAAC;IACd,KAAY,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;IAE1C,KAAY,YAAY,GAAG,oBAAoB,CAAC;IAEhD,UAAiB,GAAG;QAClB;;WAEG;QACH,KAAK,IAAI,IAAI,CAAC;KACf;IAED,KAAY,WAAW,GAAG,YAAY,CAAC;IACvC,UAAiB,KAAK;QACpB,IAAI,CAAC,EAAE;YACL,KAAK,CAAC,EAAE;gBACN,MAAM,CAAC,EAAE,MAAM,CAAC;gBAChB,OAAO,CAAC,EAAE,MAAM,CAAC;gBACjB,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC;YACF,SAAS,CAAC,EAAE;gBACV,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,YAAY,CAAC,EAAE,MAAM,CAAC;gBACtB,WAAW,CAAC,EAAE,MAAM,CAAC;aACtB,CAAC;SACH,CAAC;KACH;CACF"}

package/lib/internal/template/link/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/link/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport React from 'react';\n\nimport { BaseComponentProps } from '../internal/base-component';\nimport {\n  BaseNavigationDetail,\n  CancelableEventHandler,\n  ClickDetail as _ClickDetail,\n  NonCancelableEventHandler,\n} from '../internal/events';\n/**\n * @awsuiSystem core\n */\nimport { NativeAttributes } from '../internal/utils/with-native-attributes';\n\nexport interface LinkProps extends BaseComponentProps {\n  /**\n   * Determines the visual style of the link as follows:\n   *\n   * - `primary` - Displays the link text with bold styling for sufficient contrast with surrounding text.\n   *     Use this for links where the context doesn't imply interactivity such as\n   *     \"Learn more\" links and links within paragraphs.\n   * - `secondary` - Does not provide any additional indicators for interactivity (except for an underline when the user hovers over or focuses the link).\n   *     This can be used in cases where the interactivity is strongly implied by its context,\n   *     such as in a table or a list of external links.\n   * - `info` - Use for \"info\" links that link to content in a help panel.\n   *\n   * The default is `secondary`, except inside the following components where it defaults to `primary`:\n   * - Table\n   * - Cards\n   * - Alert\n   * - Popover\n   * - Help Panel (main `content` only)\n   */\n  variant?: LinkProps.Variant;\n\n  /**\n   * Determines the font size and line height.\n   * This property is overridden if the variant is `info`.\n   */\n  fontSize?: LinkProps.FontSize;\n\n  /**\n   * Determines the text color of the link and its icon.\n   *\n   * - `normal`: Use in most cases where a link is required.\n   * - `inverted`: Use to style links inside Flashbars.\n   *\n   * This property is overridden if the variant is `info`.\n   */\n  color?: LinkProps.Color;\n\n  /**\n   * Marks the link as external by adding an icon after the text. If `href`\n   * is provided, opens the link in a new tab when clicked.\n   */\n  external?: boolean;\n\n  /**\n   * Specifies where to open the linked URL. Set this to `_blank` to open the URL\n   * in a new tab. If you set this property to `_blank`, the component\n   * automatically adds `rel=\"noopener noreferrer\"` to avoid performance\n   * and security issues.\n   *\n   * For other options see the documentation for <a> tag's\n   * [target attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#target).\n   */\n  target?: string;\n\n  /**\n   * The URL that the link points to.\n   * If an `href` is not provided, the component will render using a\n   * \"button\" role and `target` will not be used.\n   */\n  href?: string;\n\n  /**\n   * The text to render inside the link.\n   */\n  children?: React.ReactNode;\n\n  /**\n   * Adds an aria-label to the HTML element.\n   */\n  ariaLabel?: string;\n\n  /**\n   * Adds an aria-label to the external icon.\n   * @i18n\n   */\n  externalIconAriaLabel?: string;\n\n  /**\n   * Called when a link is clicked without any modifier keys. If the link has no `href` provided, it will be called on\n   * all clicks.\n   *\n   * If you want to implement client-side routing yourself, use this event and prevent default browser navigation\n   * (by calling `preventDefault`).\n   */\n  onFollow?: CancelableEventHandler<LinkProps.FollowDetail>;\n\n  /**\n   * Called when the user clicks on the link. Do not use this handler for navigation, use the `onFollow` event instead.\n   */\n  onClick?: NonCancelableEventHandler<LinkProps.ClickDetail>;\n\n  /**\n   * Adds a `rel` attribute to the link. If the `rel` property is provided, it overrides the default behaviour.\n   * By default, the component sets the `rel` attribute to \"noopener noreferrer\" when `external` is `true` or `target` is `\"_blank\"`.\n   */\n  rel?: string;\n\n  /**\n   * @awsuiSystem core\n   */\n  style?: LinkProps.Style;\n\n  /**\n   * Attributes to add to the native element.\n   * Some attributes will be automatically combined with internal attribute values:\n   * - `className` will be appended.\n   * - Event handlers will be chained, unless the default is prevented.\n   *\n   * We do not support using this attribute to apply custom styling.\n   *\n   * @awsuiSystem core\n   */\n  nativeAttributes?: NativeAttributes<React.AnchorHTMLAttributes<HTMLAnchorElement>>;\n}\n\nexport namespace LinkProps {\n  export type Variant = 'primary' | 'secondary' | 'info' | 'awsui-value-large';\n  export type FontSize =\n    | 'body-s'\n    | 'body-m'\n    | 'heading-xs'\n    | 'heading-s'\n    | 'heading-m'\n    | 'heading-l'\n    | 'heading-xl'\n    | 'display-l'\n    | 'inherit';\n  export type Color = 'normal' | 'inverted';\n\n  export type FollowDetail = BaseNavigationDetail;\n\n  export interface Ref {\n    /**\n     * Sets the browser focus on the anchor element.\n     */\n    focus(): void;\n  }\n\n  export type ClickDetail = _ClickDetail;\n  export interface Style {\n    root?: {\n      color?: {\n        active?: string;\n        default?: string;\n        hover?: string;\n      };\n      focusRing?: {\n        borderColor?: string;\n        borderRadius?: string;\n        borderWidth?: string;\n      };\n    };\n  }\n}\n"]}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/link/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport React from 'react';\n\nimport { BaseComponentProps } from '../internal/base-component';\nimport {\n  BaseNavigationDetail,\n  CancelableEventHandler,\n  ClickDetail as _ClickDetail,\n  NonCancelableEventHandler,\n} from '../internal/events';\n/**\n * @awsuiSystem core\n */\nimport { NativeAttributes } from '../internal/utils/with-native-attributes';\n\nexport interface LinkProps extends BaseComponentProps {\n  /**\n   * Determines the visual style of the link as follows:\n   *\n   * - `primary` - Displays the link text with bold styling for sufficient contrast with surrounding text.\n   *     Use this for links where the context doesn't imply interactivity such as\n   *     \"Learn more\" links and links within paragraphs.\n   * - `secondary` - Does not provide any additional indicators for interactivity (except for an underline when the user hovers over or focuses the link).\n   *     This can be used in cases where the interactivity is strongly implied by its context,\n   *     such as in a table or a list of external links.\n   * - `info` - Use for \"info\" links that link to content in a help panel.\n   *\n   * The default is `secondary`, except inside the following components where it defaults to `primary`:\n   * - Table\n   * - Cards\n   * - Alert\n   * - Popover\n   * - Help Panel (main `content` only)\n   */\n  variant?: LinkProps.Variant;\n\n  /**\n   * Determines the font size and line height.\n   * This property is overridden if the variant is `info`.\n   */\n  fontSize?: LinkProps.FontSize;\n\n  /**\n   * Determines the text color of the link and its icon.\n   *\n   * - `normal`: Use in most cases where a link is required.\n   * - `inverted`: Use to style links inside Flashbars.\n   *\n   * This property is overridden if the variant is `info`.\n   */\n  color?: LinkProps.Color;\n\n  /**\n   * Marks the link as external by adding an icon after the text. If `href`\n   * is provided, opens the link in a new tab when clicked.\n   */\n  external?: boolean;\n\n  /**\n   * Specifies where to open the linked URL. Set this to `_blank` to open the URL\n   * in a new tab. If you set this property to `_blank`, the component\n   * automatically adds `rel=\"noopener noreferrer\"` to avoid performance\n   * and security issues.\n   *\n   * For other options see the documentation for <a> tag's\n   * [target attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#target).\n   */\n  target?: string;\n\n  /**\n   * The URL that the link points to.\n   * If an `href` is not provided, the component will render using a\n   * \"button\" role and `target` will not be used.\n   */\n  href?: string;\n\n  /**\n   * The text to render inside the link.\n   */\n  children?: React.ReactNode;\n\n  /**\n   * Adds an aria-label to the HTML element.\n   */\n  ariaLabel?: string;\n\n  /**\n   * Adds an aria-label to the external icon.\n   * @i18n\n   */\n  externalIconAriaLabel?: string;\n\n  /**\n   * Called when a link is clicked without any modifier keys. If the link has no `href` provided, it will be called on\n   * all clicks.\n   *\n   * If you want to implement client-side routing yourself, use this event and prevent default browser navigation\n   * (by calling `preventDefault`).\n   */\n  onFollow?: CancelableEventHandler<LinkProps.FollowDetail>;\n\n  /**\n   * Called when the user clicks on the link. Do not use this handler for navigation, use the `onFollow` event instead.\n   */\n  onClick?: NonCancelableEventHandler<LinkProps.ClickDetail>;\n\n  /**\n   * Adds a `rel` attribute to the link. If the `rel` property is provided, it overrides the default behaviour.\n   * By default, the component sets the `rel` attribute to \"noopener noreferrer\" when `external` is `true` or `target` is `\"_blank\"`.\n   */\n  rel?: string;\n\n  /**\n   * An object containing CSS properties to customize the link's visual appearance.\n   * Refer to the [style](/components/link/?tabId=style) tab for more details.\n   * @awsuiSystem core\n   */\n  style?: LinkProps.Style;\n\n  /**\n   * Attributes to add to the native element.\n   * Some attributes will be automatically combined with internal attribute values:\n   * - `className` will be appended.\n   * - Event handlers will be chained, unless the default is prevented.\n   *\n   * We do not support using this attribute to apply custom styling.\n   *\n   * @awsuiSystem core\n   */\n  nativeAttributes?: NativeAttributes<React.AnchorHTMLAttributes<HTMLAnchorElement>>;\n}\n\nexport namespace LinkProps {\n  export type Variant = 'primary' | 'secondary' | 'info' | 'awsui-value-large';\n  export type FontSize =\n    | 'body-s'\n    | 'body-m'\n    | 'heading-xs'\n    | 'heading-s'\n    | 'heading-m'\n    | 'heading-l'\n    | 'heading-xl'\n    | 'display-l'\n    | 'inherit';\n  export type Color = 'normal' | 'inverted';\n\n  export type FollowDetail = BaseNavigationDetail;\n\n  export interface Ref {\n    /**\n     * Sets the browser focus on the anchor element.\n     */\n    focus(): void;\n  }\n\n  export type ClickDetail = _ClickDetail;\n  export interface Style {\n    root?: {\n      color?: {\n        active?: string;\n        default?: string;\n        hover?: string;\n      };\n      focusRing?: {\n        borderColor?: string;\n        borderRadius?: string;\n        borderWidth?: string;\n      };\n    };\n  }\n}\n"]}

package/lib/internal/template/link/styles.css.js

@@ -1,25 +1,25 @@
 
     import './styles.scoped.css';
     export default {
-  "link": "awsui_link_4c84z_1rl6a_145",
-  "variant-secondary": "awsui_variant-secondary_4c84z_1rl6a_212",
-  "variant-primary": "awsui_variant-primary_4c84z_1rl6a_247",
-  "variant-info": "awsui_variant-info_4c84z_1rl6a_280",
-  "variant-value-large": "awsui_variant-value-large_4c84z_1rl6a_315",
-  "variant-top-navigation": "awsui_variant-top-navigation_4c84z_1rl6a_347",
-  "variant-recovery": "awsui_variant-recovery_4c84z_1rl6a_382",
-  "button": "awsui_button_4c84z_1rl6a_415",
-  "color-inverted": "awsui_color-inverted_4c84z_1rl6a_450",
-  "font-size-body-s": "awsui_font-size-body-s_4c84z_1rl6a_471",
-  "font-size-body-m": "awsui_font-size-body-m_4c84z_1rl6a_478",
-  "font-size-heading-xs": "awsui_font-size-heading-xs_4c84z_1rl6a_484",
-  "font-size-heading-s": "awsui_font-size-heading-s_4c84z_1rl6a_490",
-  "font-size-heading-m": "awsui_font-size-heading-m_4c84z_1rl6a_497",
-  "font-size-heading-l": "awsui_font-size-heading-l_4c84z_1rl6a_504",
-  "font-size-heading-xl": "awsui_font-size-heading-xl_4c84z_1rl6a_511",
-  "font-size-display-l": "awsui_font-size-display-l_4c84z_1rl6a_518",
-  "font-size-inherit": "awsui_font-size-inherit_4c84z_1rl6a_525",
-  "icon-wrapper": "awsui_icon-wrapper_4c84z_1rl6a_533",
-  "icon": "awsui_icon_4c84z_1rl6a_533"
+  "link": "awsui_link_4c84z_1grqn_145",
+  "variant-secondary": "awsui_variant-secondary_4c84z_1grqn_212",
+  "variant-primary": "awsui_variant-primary_4c84z_1grqn_247",
+  "variant-info": "awsui_variant-info_4c84z_1grqn_280",
+  "variant-value-large": "awsui_variant-value-large_4c84z_1grqn_315",
+  "variant-top-navigation": "awsui_variant-top-navigation_4c84z_1grqn_347",
+  "variant-recovery": "awsui_variant-recovery_4c84z_1grqn_382",
+  "button": "awsui_button_4c84z_1grqn_415",
+  "color-inverted": "awsui_color-inverted_4c84z_1grqn_450",
+  "font-size-body-s": "awsui_font-size-body-s_4c84z_1grqn_471",
+  "font-size-body-m": "awsui_font-size-body-m_4c84z_1grqn_478",
+  "font-size-heading-xs": "awsui_font-size-heading-xs_4c84z_1grqn_484",
+  "font-size-heading-s": "awsui_font-size-heading-s_4c84z_1grqn_490",
+  "font-size-heading-m": "awsui_font-size-heading-m_4c84z_1grqn_497",
+  "font-size-heading-l": "awsui_font-size-heading-l_4c84z_1grqn_504",
+  "font-size-heading-xl": "awsui_font-size-heading-xl_4c84z_1grqn_511",
+  "font-size-display-l": "awsui_font-size-display-l_4c84z_1grqn_518",
+  "font-size-inherit": "awsui_font-size-inherit_4c84z_1grqn_525",
+  "icon-wrapper": "awsui_icon-wrapper_4c84z_1grqn_533",
+  "icon": "awsui_icon_4c84z_1grqn_533"
 };