@carbon/web-components 2.46.0 → 2.47.0

package/es-custom/globals/controllers/floating-controller.js

@@ -8,7 +8,7 @@
 import { autoUpdate, offset, flip, size, arrow, hide, computePosition } from '@floating-ui/dom';
 
 /**
- * Copyright IBM Corp. 2024, 2025
+ * Copyright IBM Corp. 2024, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -36,6 +36,8 @@ class FloatingController {
     async computePlacement() {
         var _a, _b, _c;
         const { arrowElement, alignment, caret, trigger, target, styleElement, matchWidth, open, alignmentAxisOffset, autoAlignBoundary, isTabTip, } = this.options;
+        const isListBox = (target === null || target === void 0 ? void 0 : target.role) === 'listbox';
+        const isMenu = (target === null || target === void 0 ? void 0 : target.localName) === 'cds-custom-menu';
         const element = styleElement !== null && styleElement !== void 0 ? styleElement : target;
         if (!element)
             return;
@@ -86,35 +88,37 @@ class FloatingController {
                     ? shimmedAlign.includes('bottom')
                         ? ['bottom-start', 'bottom-end', 'top-start', 'top-end']
                         : ['top-start', 'top-end', 'bottom-start', 'bottom-end']
-                    : shimmedAlign.includes('bottom')
-                        ? [
-                            'bottom',
-                            'bottom-start',
-                            'bottom-end',
-                            'right',
-                            'right-start',
-                            'right-end',
-                            'left',
-                            'left-start',
-                            'left-end',
-                            'top',
-                            'top-start',
-                            'top-end',
-                        ]
-                        : [
-                            'top',
-                            'top-start',
-                            'top-end',
-                            'left',
-                            'left-start',
-                            'left-end',
-                            'right',
-                            'right-start',
-                            'right-end',
-                            'bottom',
-                            'bottom-start',
-                            'bottom-end',
-                        ],
+                    : isListBox || isMenu
+                        ? ['top', 'bottom']
+                        : shimmedAlign.includes('bottom')
+                            ? [
+                                'bottom',
+                                'bottom-start',
+                                'bottom-end',
+                                'right',
+                                'right-start',
+                                'right-end',
+                                'left',
+                                'left-start',
+                                'left-end',
+                                'top',
+                                'top-start',
+                                'top-end',
+                            ]
+                            : [
+                                'top',
+                                'top-start',
+                                'top-end',
+                                'left',
+                                'left-start',
+                                'left-end',
+                                'right',
+                                'right-start',
+                                'right-end',
+                                'bottom',
+                                'bottom-start',
+                                'bottom-end',
+                            ],
                 fallbackStrategy: 'initialPlacement',
                 fallbackAxisSideDirection: 'start',
                 boundary: autoAlignBoundary,

package/es-custom/globals/controllers/floating-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"floating-controller.js","sources":["../../../src/globals/controllers/floating-controller.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2024, 2025\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nimport { ReactiveController, ReactiveElement } from 'lit';\nimport {\n  computePosition,\n  flip,\n  size,\n  offset,\n  arrow,\n  autoUpdate,\n  hide,\n  Placement,\n  type Boundary,\n} from '@floating-ui/dom';\n\ntype FloatingControllerOptions = {\n  target: HTMLElement;\n  trigger: HTMLElement;\n  alignment: string;\n\n  arrowElement?: HTMLElement | undefined;\n  flipArguments?: object;\n  caret?: boolean;\n\n  styleElement?: HTMLElement;\n  matchWidth?: boolean;\n  open: boolean;\n  alignmentAxisOffset?: number;\n  autoAlignBoundary?: Boundary;\n  isTabTip?: boolean;\n};\n\n/**\n * Controller for positioning the menu using Floating UI.\n */\nexport default class FloatingController implements ReactiveController {\n  /**\n   * Host component\n   */\n  private host: ReactiveElement;\n  /**\n   * Floating-ui options to pass to `computePlacement()`\n   */\n  private options!: FloatingControllerOptions;\n  /**\n   * cleanup function to stop auto updates\n   */\n  private cleanup?: () => void;\n\n  /**\n   * register with host component\n   * @param host host component\n   */\n  constructor(host: ReactiveElement) {\n    this.host = host;\n    host.addController(this);\n  }\n\n  async setPlacement(options: FloatingControllerOptions = this.options) {\n    this.options = options;\n    const { trigger, target } = options;\n    this.cleanup = autoUpdate(trigger, target, this.updatePlacement);\n  }\n\n  updatePlacement = (): void => {\n    this.computePlacement();\n  };\n\n  async computePlacement() {\n    const {\n      arrowElement,\n      alignment,\n      caret,\n      trigger,\n      target,\n      styleElement,\n      matchWidth,\n      open,\n      alignmentAxisOffset,\n      autoAlignBoundary,\n      isTabTip,\n    } = this.options;\n\n    const element = styleElement ?? target;\n\n    if (!element) return;\n\n    let shimmedAlign;\n    switch (alignment) {\n      case 'top-left':\n        shimmedAlign = 'top-start';\n        break;\n      case 'top-right':\n        shimmedAlign = 'top-end';\n        break;\n      case 'bottom-left':\n        shimmedAlign = 'bottom-start';\n        break;\n      case 'bottom-right':\n        shimmedAlign = 'bottom-end';\n        break;\n      case 'left-bottom':\n        shimmedAlign = 'left-end';\n        break;\n      case 'left-top':\n        shimmedAlign = 'left-start';\n        break;\n      case 'right-bottom':\n        shimmedAlign = 'right-end';\n        break;\n      case 'right-top':\n        shimmedAlign = 'right-start';\n        break;\n      default:\n        shimmedAlign = alignment;\n        break;\n    }\n    const cs = getComputedStyle(element);\n    const toPx = (val: string) => {\n      const raw = parseFloat(val);\n      return val.trim().endsWith('rem') ? raw * 16 : raw;\n    };\n    const offsetPx = !isTabTip\n      ? (toPx(cs.getPropertyValue('--cds-popover-offset').trim()) ?? 10)\n      : 0;\n\n    const middleware = [\n      offset(\n        caret && !isTabTip\n          ? { alignmentAxis: alignmentAxisOffset, mainAxis: offsetPx }\n          : 0\n      ),\n      flip({\n        fallbackPlacements: isTabTip\n          ? shimmedAlign.includes('bottom')\n            ? ['bottom-start', 'bottom-end', 'top-start', 'top-end']\n            : ['top-start', 'top-end', 'bottom-start', 'bottom-end']\n          : shimmedAlign.includes('bottom')\n            ? [\n                'bottom',\n                'bottom-start',\n                'bottom-end',\n                'right',\n                'right-start',\n                'right-end',\n                'left',\n                'left-start',\n                'left-end',\n                'top',\n                'top-start',\n                'top-end',\n              ]\n            : [\n                'top',\n                'top-start',\n                'top-end',\n                'left',\n                'left-start',\n                'left-end',\n                'right',\n                'right-start',\n                'right-end',\n                'bottom',\n                'bottom-start',\n                'bottom-end',\n              ],\n\n        fallbackStrategy: 'initialPlacement',\n        fallbackAxisSideDirection: 'start',\n        boundary: autoAlignBoundary,\n      }),\n      ...(matchWidth && (shimmedAlign === 'bottom' || shimmedAlign === 'top')\n        ? [\n            size({\n              apply({ rects, elements }) {\n                elements.floating.style.width = `${rects.reference.width}px`;\n              },\n            }),\n          ]\n        : [\n            size({\n              apply({ elements }) {\n                elements.floating.style.removeProperty('width');\n              },\n            }),\n          ]),\n\n      ...(caret && arrowElement\n        ? [arrow({ element: arrowElement, padding: 15 })]\n        : []),\n\n      ...[hide()],\n    ];\n\n    if (open) {\n      const { x, y, placement, middlewareData, strategy } =\n        await computePosition(trigger, element, {\n          strategy: 'fixed',\n          middleware,\n          placement: shimmedAlign as Placement,\n        });\n\n      element.setAttribute('align', placement);\n\n      element.style.left = `${x}px`;\n      element.style.top = `${y}px`;\n      element.style.position = `${strategy}`;\n\n      element.style.visibility = middlewareData.hide?.referenceHidden\n        ? 'hidden'\n        : 'visible';\n\n      if (arrowElement) {\n        // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- https://github.com/carbon-design-system/carbon/issues/20452\n        // @ts-ignore\n        const { x: arrowX, y: arrowY } = middlewareData.arrow;\n\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\n        const staticSide: any = {\n          top: 'bottom',\n          right: 'left',\n          bottom: 'top',\n          left: 'right',\n        }[placement.split('-')[0]];\n\n        arrowElement.style.left = arrowX != null ? `${arrowX}px` : '';\n        arrowElement.style.top = arrowY != null ? `${arrowY}px` : '';\n        arrowElement.style.right = '';\n        arrowElement.style.bottom = '';\n        arrowElement.style[staticSide] = `${-arrowElement.offsetWidth / 2}px`;\n      }\n\n      // adding specific case here where the style of the caret/arrow\n      // is dependent on the placement\n      // TODO: remove reference to slug in v12\n      if (\n        this.host.tagName === 'CDS-AI-LABEL' ||\n        this.host.tagName === 'CDS-SLUG'\n      ) {\n        this.host?.setAttribute('alignment', placement);\n      }\n    }\n  }\n\n  hostUpdated(): void {\n    if (!this.host.hasAttribute('open')) {\n      this.cleanup?.();\n      this.cleanup = undefined;\n    }\n  }\n\n  hostDisconnected(): void {\n    this.cleanup?.();\n    this.cleanup = undefined;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"floating-controller.js","sources":["../../../src/globals/controllers/floating-controller.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2024, 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nimport { ReactiveController, ReactiveElement } from 'lit';\nimport {\n  computePosition,\n  flip,\n  size,\n  offset,\n  arrow,\n  autoUpdate,\n  hide,\n  Placement,\n  type Boundary,\n} from '@floating-ui/dom';\n\ntype FloatingControllerOptions = {\n  target: HTMLElement;\n  trigger: HTMLElement;\n  alignment: string;\n\n  arrowElement?: HTMLElement | undefined;\n  flipArguments?: object;\n  caret?: boolean;\n\n  styleElement?: HTMLElement;\n  matchWidth?: boolean;\n  open: boolean;\n  alignmentAxisOffset?: number;\n  autoAlignBoundary?: Boundary;\n  isTabTip?: boolean;\n};\n\n/**\n * Controller for positioning the menu using Floating UI.\n */\nexport default class FloatingController implements ReactiveController {\n  /**\n   * Host component\n   */\n  private host: ReactiveElement;\n  /**\n   * Floating-ui options to pass to `computePlacement()`\n   */\n  private options!: FloatingControllerOptions;\n  /**\n   * cleanup function to stop auto updates\n   */\n  private cleanup?: () => void;\n\n  /**\n   * register with host component\n   * @param host host component\n   */\n  constructor(host: ReactiveElement) {\n    this.host = host;\n    host.addController(this);\n  }\n\n  async setPlacement(options: FloatingControllerOptions = this.options) {\n    this.options = options;\n    const { trigger, target } = options;\n    this.cleanup = autoUpdate(trigger, target, this.updatePlacement);\n  }\n\n  updatePlacement = (): void => {\n    this.computePlacement();\n  };\n\n  async computePlacement() {\n    const {\n      arrowElement,\n      alignment,\n      caret,\n      trigger,\n      target,\n      styleElement,\n      matchWidth,\n      open,\n      alignmentAxisOffset,\n      autoAlignBoundary,\n      isTabTip,\n    } = this.options;\n\n    const isListBox = target?.role === 'listbox';\n    const isMenu = target?.localName === 'cds-custom-menu';\n\n    const element = styleElement ?? target;\n\n    if (!element) return;\n\n    let shimmedAlign;\n    switch (alignment) {\n      case 'top-left':\n        shimmedAlign = 'top-start';\n        break;\n      case 'top-right':\n        shimmedAlign = 'top-end';\n        break;\n      case 'bottom-left':\n        shimmedAlign = 'bottom-start';\n        break;\n      case 'bottom-right':\n        shimmedAlign = 'bottom-end';\n        break;\n      case 'left-bottom':\n        shimmedAlign = 'left-end';\n        break;\n      case 'left-top':\n        shimmedAlign = 'left-start';\n        break;\n      case 'right-bottom':\n        shimmedAlign = 'right-end';\n        break;\n      case 'right-top':\n        shimmedAlign = 'right-start';\n        break;\n      default:\n        shimmedAlign = alignment;\n        break;\n    }\n    const cs = getComputedStyle(element);\n    const toPx = (val: string) => {\n      const raw = parseFloat(val);\n      return val.trim().endsWith('rem') ? raw * 16 : raw;\n    };\n    const offsetPx = !isTabTip\n      ? (toPx(cs.getPropertyValue('--cds-popover-offset').trim()) ?? 10)\n      : 0;\n\n    const middleware = [\n      offset(\n        caret && !isTabTip\n          ? { alignmentAxis: alignmentAxisOffset, mainAxis: offsetPx }\n          : 0\n      ),\n      flip({\n        fallbackPlacements: isTabTip\n          ? shimmedAlign.includes('bottom')\n            ? ['bottom-start', 'bottom-end', 'top-start', 'top-end']\n            : ['top-start', 'top-end', 'bottom-start', 'bottom-end']\n          : isListBox || isMenu\n            ? ['top', 'bottom']\n            : shimmedAlign.includes('bottom')\n              ? [\n                  'bottom',\n                  'bottom-start',\n                  'bottom-end',\n                  'right',\n                  'right-start',\n                  'right-end',\n                  'left',\n                  'left-start',\n                  'left-end',\n                  'top',\n                  'top-start',\n                  'top-end',\n                ]\n              : [\n                  'top',\n                  'top-start',\n                  'top-end',\n                  'left',\n                  'left-start',\n                  'left-end',\n                  'right',\n                  'right-start',\n                  'right-end',\n                  'bottom',\n                  'bottom-start',\n                  'bottom-end',\n                ],\n\n        fallbackStrategy: 'initialPlacement',\n        fallbackAxisSideDirection: 'start',\n        boundary: autoAlignBoundary,\n      }),\n      ...(matchWidth && (shimmedAlign === 'bottom' || shimmedAlign === 'top')\n        ? [\n            size({\n              apply({ rects, elements }) {\n                elements.floating.style.width = `${rects.reference.width}px`;\n              },\n            }),\n          ]\n        : [\n            size({\n              apply({ elements }) {\n                elements.floating.style.removeProperty('width');\n              },\n            }),\n          ]),\n\n      ...(caret && arrowElement\n        ? [arrow({ element: arrowElement, padding: 15 })]\n        : []),\n\n      ...[hide()],\n    ];\n\n    if (open) {\n      const { x, y, placement, middlewareData, strategy } =\n        await computePosition(trigger, element, {\n          strategy: 'fixed',\n          middleware,\n          placement: shimmedAlign as Placement,\n        });\n\n      element.setAttribute('align', placement);\n\n      element.style.left = `${x}px`;\n      element.style.top = `${y}px`;\n      element.style.position = `${strategy}`;\n\n      element.style.visibility = middlewareData.hide?.referenceHidden\n        ? 'hidden'\n        : 'visible';\n\n      if (arrowElement) {\n        // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- https://github.com/carbon-design-system/carbon/issues/20452\n        // @ts-ignore\n        const { x: arrowX, y: arrowY } = middlewareData.arrow;\n\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\n        const staticSide: any = {\n          top: 'bottom',\n          right: 'left',\n          bottom: 'top',\n          left: 'right',\n        }[placement.split('-')[0]];\n\n        arrowElement.style.left = arrowX != null ? `${arrowX}px` : '';\n        arrowElement.style.top = arrowY != null ? `${arrowY}px` : '';\n        arrowElement.style.right = '';\n        arrowElement.style.bottom = '';\n        arrowElement.style[staticSide] = `${-arrowElement.offsetWidth / 2}px`;\n      }\n\n      // adding specific case here where the style of the caret/arrow\n      // is dependent on the placement\n      // TODO: remove reference to slug in v12\n      if (\n        this.host.tagName === 'CDS-AI-LABEL' ||\n        this.host.tagName === 'CDS-SLUG'\n      ) {\n        this.host?.setAttribute('alignment', placement);\n      }\n    }\n  }\n\n  hostUpdated(): void {\n    if (!this.host.hasAttribute('open')) {\n      this.cleanup?.();\n      this.cleanup = undefined;\n    }\n  }\n\n  hostDisconnected(): void {\n    this.cleanup?.();\n    this.cleanup = undefined;\n  }\n}\n"],"names":[],"mappings":"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"}

package/es-custom/globals/decorators/carbon-element.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2019, 2022
+ * Copyright IBM Corp. 2019, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -7,18 +7,19 @@
 export declare type Constructor<T> = {
     new (...args: any[]): T;
 };
+type Finisher = (<T>(clazz: Constructor<T>) => Constructor<T>) | (<T>(clazz: Constructor<T>) => void);
 export interface ClassDescriptor {
     kind: 'class';
     elements: ClassElement[];
-    finisher?: <T>(clazz: Constructor<T>) => void | Constructor<T>;
+    finisher?: Finisher;
 }
 export interface ClassElement {
     kind: 'field' | 'method';
     key: PropertyKey;
     placement: 'static' | 'prototype' | 'own';
-    initializer?: Function;
+    initializer?: () => unknown;
     extras?: ClassElement[];
-    finisher?: <T>(clazz: Constructor<T>) => void | Constructor<T>;
+    finisher?: Finisher;
     descriptor?: PropertyDescriptor;
 }
 /**

package/es-custom/globals/decorators/carbon-element.js

@@ -6,7 +6,7 @@
  */
 
 /**
- * Copyright IBM Corp. 2019, 2022
+ * Copyright IBM Corp. 2019, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/es-custom/globals/decorators/carbon-element.js.map

@@ -1 +1 @@
-{"version":3,"file":"carbon-element.js","sources":["../../../src/globals/decorators/carbon-element.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2019, 2022\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/*\n * IMPORTANT: For compatibility with tsickle and the Closure JS compiler, all\n * property decorators (but not class decorators) in this file that have\n * an @ExportDecoratedItems annotation must be defined as a regular function,\n * not an arrow function.\n */\nexport declare type Constructor<T> = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\n  new (...args: any[]): T;\n};\nexport interface ClassDescriptor {\n  kind: 'class';\n  elements: ClassElement[];\n  // eslint-disable-next-line   @typescript-eslint/no-invalid-void-type -- https://github.com/carbon-design-system/carbon/issues/20452\n  finisher?: <T>(clazz: Constructor<T>) => void | Constructor<T>;\n}\nexport interface ClassElement {\n  kind: 'field' | 'method';\n  key: PropertyKey;\n  placement: 'static' | 'prototype' | 'own';\n  // eslint-disable-next-line   @typescript-eslint/no-unsafe-function-type -- https://github.com/carbon-design-system/carbon/issues/20452\n  initializer?: Function;\n  extras?: ClassElement[];\n  // eslint-disable-next-line   @typescript-eslint/no-invalid-void-type -- https://github.com/carbon-design-system/carbon/issues/20452\n  finisher?: <T>(clazz: Constructor<T>) => void | Constructor<T>;\n  descriptor?: PropertyDescriptor;\n}\n\n/**\n * Allow for custom element classes with private constructors\n */\ntype CustomElementClass = Omit<typeof HTMLElement, 'new'>;\n\nconst legacyCustomElement = (tagName: string, clazz: CustomElementClass) => {\n  try {\n    customElements.define(tagName, clazz as CustomElementConstructor);\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars -- https://github.com/carbon-design-system/carbon/issues/20452\n  } catch (error) {\n    // eslint-disable-next-line no-console -- https://github.com/carbon-design-system/carbon/issues/20452\n    console.warn(`Attempting to re-define ${tagName}`);\n  }\n  // Cast as any because TS doesn't recognize the return type as being a\n  // subtype of the decorated class when clazz is typed as\n  // `Constructor<HTMLElement>` for some reason.\n  // `Constructor<HTMLElement>` is helpful to make sure the decorator is\n  // applied to elements however.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return clazz as any;\n};\n\nconst standardCustomElement = (\n  tagName: string,\n  descriptor: ClassDescriptor\n) => {\n  const { kind, elements } = descriptor;\n  return {\n    kind,\n    elements,\n    // This callback is called once the class is otherwise fully defined\n    finisher(clazz: Constructor<HTMLElement>) {\n      try {\n        customElements.define(tagName, clazz);\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars -- https://github.com/carbon-design-system/carbon/issues/20452\n      } catch (error) {\n        // eslint-disable-next-line no-console -- https://github.com/carbon-design-system/carbon/issues/20452\n        console.warn(`Attempting to re-define ${tagName}`);\n      }\n    },\n  };\n};\n\n/**\n * Class decorator factory that defines the decorated class as a custom element.\n *\n * ```js\n * @customElement('my-element')\n * class MyElement extends LitElement {\n *   render() {\n *     return html``;\n *   }\n * }\n * ```\n *\n * @category Decorator\n * @param tagName The tag name of the custom element to define.\n */\nexport const carbonElement =\n  (tagName: string) =>\n  (classOrDescriptor: CustomElementClass | ClassDescriptor) =>\n    typeof classOrDescriptor === 'function'\n      ? legacyCustomElement(tagName, classOrDescriptor)\n      : standardCustomElement(tagName, classOrDescriptor as ClassDescriptor);\n"],"names":[],"mappings":";;;;;;;AAAA;;;;;AAKG;AAmCH,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,KAAyB,KAAI;AACzE,IAAA,IAAI;AACF,QAAA,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAiC,CAAC;;IAEnE;IAAE,OAAO,KAAK,EAAE;;AAEd,QAAA,OAAO,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAA,CAAE,CAAC;IACpD;;;;;;;AAOA,IAAA,OAAO,KAAY;AACrB,CAAC;AAED,MAAM,qBAAqB,GAAG,CAC5B,OAAe,EACf,UAA2B,KACzB;AACF,IAAA,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,UAAU;IACrC,OAAO;QACL,IAAI;QACJ,QAAQ;;AAER,QAAA,QAAQ,CAAC,KAA+B,EAAA;AACtC,YAAA,IAAI;AACF,gBAAA,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;;YAEvC;YAAE,OAAO,KAAK,EAAE;;AAEd,gBAAA,OAAO,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAA,CAAE,CAAC;YACpD;QACF,CAAC;KACF;AACH,CAAC;AAED;;;;;;;;;;;;;;AAcG;AACI,MAAM,aAAa,GACxB,CAAC,OAAe,KAChB,CAAC,iBAAuD,KACtD,OAAO,iBAAiB,KAAK;AAC3B,MAAE,mBAAmB,CAAC,OAAO,EAAE,iBAAiB;AAChD,MAAE,qBAAqB,CAAC,OAAO,EAAE,iBAAoC;;;;"}
+{"version":3,"file":"carbon-element.js","sources":["../../../src/globals/decorators/carbon-element.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2019, 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/*\n * IMPORTANT: For compatibility with tsickle and the Closure JS compiler, all\n * property decorators (but not class decorators) in this file that have\n * an @ExportDecoratedItems annotation must be defined as a regular function,\n * not an arrow function.\n */\nexport declare type Constructor<T> = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\n  new (...args: any[]): T;\n};\n\ntype Finisher =\n  | (<T>(clazz: Constructor<T>) => Constructor<T>)\n  | (<T>(clazz: Constructor<T>) => void);\n\nexport interface ClassDescriptor {\n  kind: 'class';\n  elements: ClassElement[];\n  finisher?: Finisher;\n}\n\nexport interface ClassElement {\n  kind: 'field' | 'method';\n  key: PropertyKey;\n  placement: 'static' | 'prototype' | 'own';\n  initializer?: () => unknown;\n  extras?: ClassElement[];\n  finisher?: Finisher;\n  descriptor?: PropertyDescriptor;\n}\n\n/**\n * Allow for custom element classes with private constructors\n */\ntype CustomElementClass = Omit<typeof HTMLElement, 'new'>;\n\nconst legacyCustomElement = (tagName: string, clazz: CustomElementClass) => {\n  try {\n    customElements.define(tagName, clazz as CustomElementConstructor);\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars -- https://github.com/carbon-design-system/carbon/issues/20452\n  } catch (error) {\n    // eslint-disable-next-line no-console -- https://github.com/carbon-design-system/carbon/issues/20452\n    console.warn(`Attempting to re-define ${tagName}`);\n  }\n  // Cast as any because TS doesn't recognize the return type as being a\n  // subtype of the decorated class when clazz is typed as\n  // `Constructor<HTMLElement>` for some reason.\n  // `Constructor<HTMLElement>` is helpful to make sure the decorator is\n  // applied to elements however.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return clazz as any;\n};\n\nconst standardCustomElement = (\n  tagName: string,\n  descriptor: ClassDescriptor\n) => {\n  const { kind, elements } = descriptor;\n  return {\n    kind,\n    elements,\n    // This callback is called once the class is otherwise fully defined\n    finisher(clazz: Constructor<HTMLElement>) {\n      try {\n        customElements.define(tagName, clazz);\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars -- https://github.com/carbon-design-system/carbon/issues/20452\n      } catch (error) {\n        // eslint-disable-next-line no-console -- https://github.com/carbon-design-system/carbon/issues/20452\n        console.warn(`Attempting to re-define ${tagName}`);\n      }\n    },\n  };\n};\n\n/**\n * Class decorator factory that defines the decorated class as a custom element.\n *\n * ```js\n * @customElement('my-element')\n * class MyElement extends LitElement {\n *   render() {\n *     return html``;\n *   }\n * }\n * ```\n *\n * @category Decorator\n * @param tagName The tag name of the custom element to define.\n */\nexport const carbonElement =\n  (tagName: string) =>\n  (classOrDescriptor: CustomElementClass | ClassDescriptor) =>\n    typeof classOrDescriptor === 'function'\n      ? legacyCustomElement(tagName, classOrDescriptor)\n      : standardCustomElement(tagName, classOrDescriptor as ClassDescriptor);\n"],"names":[],"mappings":";;;;;;;AAAA;;;;;AAKG;AAsCH,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,KAAyB,KAAI;AACzE,IAAA,IAAI;AACF,QAAA,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAiC,CAAC;;IAEnE;IAAE,OAAO,KAAK,EAAE;;AAEd,QAAA,OAAO,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAA,CAAE,CAAC;IACpD;;;;;;;AAOA,IAAA,OAAO,KAAY;AACrB,CAAC;AAED,MAAM,qBAAqB,GAAG,CAC5B,OAAe,EACf,UAA2B,KACzB;AACF,IAAA,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,UAAU;IACrC,OAAO;QACL,IAAI;QACJ,QAAQ;;AAER,QAAA,QAAQ,CAAC,KAA+B,EAAA;AACtC,YAAA,IAAI;AACF,gBAAA,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;;YAEvC;YAAE,OAAO,KAAK,EAAE;;AAEd,gBAAA,OAAO,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAA,CAAE,CAAC;YACpD;QACF,CAAC;KACF;AACH,CAAC;AAED;;;;;;;;;;;;;;AAcG;AACI,MAAM,aAAa,GACxB,CAAC,OAAe,KAChB,CAAC,iBAAuD,KACtD,OAAO,iBAAiB,KAAK;AAC3B,MAAE,mBAAmB,CAAC,OAAO,EAAE,iBAAiB;AAChD,MAAE,qBAAqB,CAAC,OAAO,EAAE,iBAAoC;;;;"}

package/lib/components/ai-label/ai-label.d.ts

@@ -45,11 +45,11 @@ declare class CDSAILabel extends CDSToggleTip {
      */
     buttonLabel: string;
     previousValue: any;
+    connectedCallback(): void;
     protected _handleClick: () => void;
     protected _renderToggleTipLabel: () => import("lit-html").TemplateResult<1>;
     protected _renderTooltipButton: () => import("lit-html").TemplateResult<1>;
     protected _renderInnerContent: () => import("lit-html").TemplateResult<1>;
     attributeChangedCallback(name: any, old: any, newValue: any): void;
-    static styles: any;
 }
 export default CDSAILabel;

package/lib/components/breadcrumb/breadcrumb-overflow-menu.d.ts

@@ -13,7 +13,7 @@ import CDSOverflowMenu from '../overflow-menu/overflow-menu';
  * @element cds-breadcrumb-overflow-menu
  */
 declare class CDSBreadcrumbOverflowMenu extends CDSOverflowMenu {
+    connectedCallback(): void;
     render(): import("lit-html").TemplateResult<1>;
-    static styles: any;
 }
 export default CDSBreadcrumbOverflowMenu;

package/lib/components/chat-button/chat-button-skeleton.d.ts

@@ -17,7 +17,7 @@ declare class CDSChatButtonSkeleton extends LitElement {
      * Specify the size of the `ChatButtonSkeleton`, from the following list of sizes: 'sm', 'md', 'lg'
      */
     size: CHAT_BUTTON_SIZE;
+    connectedCallback(): void;
     render(): import("lit-html").TemplateResult<1>;
-    static styles: any;
 }
 export default CDSChatButtonSkeleton;

package/lib/components/chat-button/chat-button.d.ts

@@ -43,7 +43,7 @@ declare class CDSChatButton extends LitElement {
      * Specify whether the quick action `ChatButton` should be rendered as selected. This disables the input
      */
     isSelected: boolean;
+    connectedCallback(): void;
     render(): import("lit-html").TemplateResult<1>;
-    static styles: any;
 }
 export default CDSChatButton;

package/lib/components/combo-box/combo-box.d.ts

@@ -77,7 +77,7 @@ declare class CDSComboBox extends CDSDropdown {
     protected _handleUserInitiatedSelectItem(item?: CDSComboBoxItem): void;
     protected _selectionDidChange(itemToSelect?: CDSComboBoxItem): void;
     protected _renderLabel(): TemplateResult;
-    protected _renderFollowingLabel(): TemplateResult | void;
+    protected _renderFollowingLabel(): TemplateResult | undefined;
     protected _renderTitleLabel(): TemplateResult;
     /**
      * The `aria-label` attribute for the icon to clear selection.
@@ -100,6 +100,10 @@ declare class CDSComboBox extends CDSDropdown {
      * **Experimental**: will enable autocomplete and typeahead for the input field.
      */
     typeahead: boolean;
+    /**
+     * `true` to allow custom values that do not match any item in the list.
+     */
+    allowCustomValue: boolean;
     shouldUpdate(changedProperties: any): boolean;
     protected _clearInputWithoutSelecting(focus?: boolean): void;
     updated(changedProperties: any): void;

package/lib/components/copy/copy.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2019, 2024
+ * Copyright IBM Corp. 2019, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/date-picker/range-plugin.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2019, 2024
+ * Copyright IBM Corp. 2019, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/dropdown/dropdown.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2019, 2025
+ * Copyright IBM Corp. 2019, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -1537,7 +1537,7 @@ declare class CDSDropdown extends CDSDropdown_base {
     /**
      * @returns The content preceding the trigger button.
      */
-    protected _renderPrecedingLabel(): TemplateResult | void;
+    protected _renderPrecedingLabel(): TemplateResult | undefined;
     /**
      * @returns The main content of the trigger button.
      */
@@ -1549,7 +1549,7 @@ declare class CDSDropdown extends CDSDropdown_base {
     /**
      * @returns The content following the trigger button.
      */
-    protected _renderFollowingLabel(): TemplateResult | void;
+    protected _renderFollowingLabel(): TemplateResult | undefined;
     /**
      * Handles event to include selected value on the parent form.
      *

package/lib/components/grid/column-hang.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2024, 2024
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/grid/column.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2024, 2024
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/grid/grid.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2024, 2024
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/grid/index.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2024, 2024
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/icon-button/icon-button.d.ts

@@ -46,9 +46,9 @@ declare class CDSIconButton extends CDSButton {
      * Specify the size of the Button. Defaults to `md`.
      */
     size: string;
+    connectedCallback(): void;
     updated(changedProperties: any): void;
     protected _renderTooltipContent(): import("lit-html").TemplateResult<1>;
     render(): import("lit-html").TemplateResult<1>;
-    static styles: any;
 }
 export default CDSIconButton;

package/lib/components/menu/menu-context.d.ts

@@ -1,14 +1,15 @@
 /**
- * Copyright IBM Corp. 2024
+ * Copyright IBM Corp. 2024, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
+export type MenuContextUpdate = Partial<Omit<StateType, 'updateFromChild'>>;
 export type StateType = {
     isRoot: boolean;
     hasSelectableItems: boolean;
     size: 'xs' | 'sm' | 'md' | 'lg' | null;
-    updateFromChild: (item: {}) => void;
+    updateFromChild: (item: MenuContextUpdate) => void;
 };
 export declare const menuDefaultState: StateType;
 export declare const MenuContext: {

package/lib/components/menu/menu.d.ts

@@ -1,10 +1,11 @@
 /**
- * Copyright IBM Corp. 2024, 2025
+ * Copyright IBM Corp. 2024, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 import { LitElement } from 'lit';
+import { type MenuContextUpdate } from './menu-context';
 import CDSmenuItem from './menu-item';
 import { MENU_BACKGROUND_TOKEN, MENU_SIZE } from './defs';
 export { MENU_SIZE };
@@ -368,7 +369,7 @@ declare const CDSMenu_base: {
 } & typeof LitElement;
 declare class CDSMenu extends CDSMenu_base {
     context: {
-        updateFromChild: (updatedItem: any) => void;
+        updateFromChild: (updatedItem: MenuContextUpdate) => void;
         isRoot: boolean;
         hasSelectableItems: boolean;
         size: "xs" | "sm" | "md" | "lg" | null;

package/lib/components/modal/modal-body.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2019, 2023
+ * Copyright IBM Corp. 2019, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -12,7 +12,9 @@ import { LitElement } from 'lit';
  */
 declare class CDSModalBody extends LitElement {
     private userDefinedTabindex;
+    private _resizeObserver?;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     checkScroll(): void;
     render(): import("lit-html").TemplateResult<1>;
     static styles: any;

package/lib/components/modal/modal-close-button.d.ts

@@ -1,10 +1,11 @@
 /**
- * Copyright IBM Corp. 2019, 2024
+ * Copyright IBM Corp. 2019, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 import { LitElement } from 'lit';
+import '../icon-button';
 declare const CDSModalCloseButton_base: {
     new (...args: any[]): {
         focus(): void;

package/lib/components/modal/modal.d.ts

@@ -1,11 +1,12 @@
 /**
- * Copyright IBM Corp. 2019, 2024
+ * Copyright IBM Corp. 2019, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 import { LitElement } from 'lit';
 import { MODAL_SIZE } from './defs';
+import '../inline-loading';
 export { MODAL_SIZE };
 declare const CDSModal_base: {
     new (...args: any[]): {
@@ -370,6 +371,22 @@ declare class CDSModal extends CDSModal_base {
      * The element that had focus before this modal gets open.
      */
     private _launcher;
+    /**
+     * The inline loading element that renders when `loading-status` is not `inactive`
+     */
+    private _loadingEl;
+    /**
+     * MutationObserver that observes the modal-footer
+     */
+    private _footerObserver?;
+    /**
+     * MutationObserver that observes the modal-header
+     */
+    private _headerObserver?;
+    /**
+     * Loading statuses that are not `inactive`
+     */
+    private WORKING_LOADING_STATUSES;
     /**
      * Handles `click` event on this element.
      *
@@ -441,11 +458,55 @@ declare class CDSModal extends CDSModal_base {
      * Prevent closing on click outside of modal
      */
     preventCloseOnClickOutside: boolean;
+    /**
+     * Specify the loading status
+     */
+    loadingStatus: 'inactive' | 'active' | 'finished' | 'error';
+    /**
+     * Specify the description for the loading text
+     */
+    loadingDescription: string;
+    /**
+     * Provide a delay for the setTimeout for success
+     */
+    loadingSuccessDelay: number;
+    /**
+     * Specify the description for the loading icon
+     */
+    loadingIconDescription: string;
+    /**
+     * Specify if Enter key should be used as "submit" action that clicks the primary footer button
+     */
+    shouldSubmitOnEnter: boolean;
     /**
      * Prevent the modal from closing after clicking the close button
      */
     preventClose: boolean;
-    firstUpdated(): void;
+    private _initializeLoadingEl;
+    private _getFooterElements;
+    private _updateLoadingElement;
+    firstUpdated(): Promise<void>;
+    /**
+     * Computes the aria-label of the modal based on (in order of highest to lowest precedence):
+     * - `modal-label`
+     * - `aria-label`
+     * - `modal-heading`
+     */
+    private _computeAriaLabel;
+    /**
+     * Observes the modal footer's `has-three-buttons` attribute to account for cases
+     * where the loading status and the amount of footer-buttons
+     * are being changed dynamically
+     */
+    private _observeFooter;
+    /**
+     * Observes the modal header to account for cases where the modal-heading,
+     * modal-label, and/or `aria-label` are dynamically changing
+     * to update the `aria-label` put on the modal
+     */
+    private _observeHeader;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     render(): import("lit-html").TemplateResult<1>;
     updated(changedProperties: any): Promise<void>;
     /**
@@ -478,6 +539,10 @@ declare class CDSModal extends CDSModal_base {
      * The name of the custom event fired after this modal is closed upon a user gesture.
      */
     static get eventClose(): string;
+    /**
+     * The name of the custom event fired when this modal reaches a `finished` loading state
+     */
+    static get eventOnLoadingSuccess(): string;
     static styles: any;
 }
 export default CDSModal;

package/lib/components/multi-select/multi-select.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2020, 2025
+ * Copyright IBM Corp. 2020, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -76,7 +76,7 @@ declare class CDSMultiSelect extends CDSDropdown {
       @returns The main content of the trigger button.
      */
     protected _renderLabel(): TemplateResult;
-    protected _renderFollowingLabel(): TemplateResult | void;
+    protected _renderFollowingLabel(): TemplateResult | undefined;
     /**
      * Handles `input` event on the `<input>` for filtering.
      */

package/lib/components/overflow-menu/overflow-menu.d.ts

@@ -755,6 +755,5 @@ declare class CDSOverflowMenu extends CDSOverflowMenu_base implements CDSFloatin
     connectedCallback(): void;
     updated(changedProperties: any): void;
     render(): import("lit-html").TemplateResult<1>;
-    static styles: any;
 }
 export default CDSOverflowMenu;

package/lib/components/page-header/index.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2025, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/page-header/page-header-breadcrumb.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2025, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/page-header/page-header-content-text.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2025, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/page-header/page-header-content.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2025, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/page-header/page-header-hero-image.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2025, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/page-header/page-header-tabs.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2025, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the

package/lib/components/page-header/page-header.d.ts

@@ -1,6 +1,4 @@
 /**
- * @license
- *
  * Copyright IBM Corp. 2019, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the