@carbon/web-components 2.62.0 → 2.63.0-rc.0

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

@@ -4,6 +4,7 @@
  * 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 '../icon-button/icon-button';
 import './slug';
 import './slug-action-button';
 //# sourceMappingURL=index.d.ts.map

package/lib/components/slug/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/slug/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,CAAC;AAChB,OAAO,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/slug/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,4BAA4B,CAAC;AACpC,OAAO,QAAQ,CAAC;AAChB,OAAO,sBAAsB,CAAC"}

package/lib/components/tag/dismissible-tag.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.

package/lib/components/tag/dismissible-tag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dismissible-tag.d.ts","sourceRoot":"","sources":["../../../src/components/tag/dismissible-tag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,MAAM,MAAM,YAAY,CAAC;AAChC,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;;;;;;;;;;uBAI7B,CAAA;;;;;;;AAFD;;;;;;;GAOG;AACH,cACM,iBAAkB,SAAQ,sBAAqC;IAEnE,SAAS,CAAC,WAAW,EAAG,iBAAiB,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,qBAAqB;IAe/B;;OAEG;IACH,SAAS,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK;IAuBpD;;;;OAIG;IAIH,SAAS,CAAC,YAAY,GAAI,OAAO,UAAU,UAwCzC;IAEF;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;OAEG;IAMH,uBAAuB,SAAY;IAEnC;;OAEG;IAEH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IAEH,IAAI,UAAQ;IAEZ;;OAEG;IAEH,IAAI,WAAmB;IAEvB;;OAEG;IAEH,QAAQ,SAAM;IAEd;;OAEG;IAEH,IAAI,SAAM;IAEV;;OAEG;IAEH,IAAI,WAAiB;IAErB,MAAM;IA+CN;;;;OAIG;IACH,MAAM,KAAK,QAAQ,WAElB;IAED;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;;OAGG;IACH,MAAM,KAAK,gBAAgB,WAE1B;IAED;;OAEG;IACH,MAAM,KAAK,UAAU,WAEpB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"dismissible-tag.d.ts","sourceRoot":"","sources":["../../../src/components/tag/dismissible-tag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,MAAM,MAAM,YAAY,CAAC;AAChC,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;;;;;;;;;;uBAI7B,CAAA;;;;;;;AAFD;;;;;;;GAOG;AACH,cACM,iBAAkB,SAAQ,sBAAqC;IAEnE,SAAS,CAAC,WAAW,EAAG,iBAAiB,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,qBAAqB;IAe/B;;OAEG;IACH,SAAS,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK;IAuBpD;;;;OAIG;IAIH,SAAS,CAAC,YAAY,GAAI,OAAO,UAAU,UA0CzC;IAEF;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;OAEG;IAMH,uBAAuB,SAAY;IAEnC;;OAEG;IAEH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IAEH,IAAI,UAAQ;IAEZ;;OAEG;IAEH,IAAI,WAAmB;IAEvB;;OAEG;IAEH,QAAQ,SAAM;IAEd;;OAEG;IAEH,IAAI,SAAM;IAEV;;OAEG;IAEH,IAAI,WAAiB;IAErB,MAAM;IA2DN;;;;OAIG;IACH,MAAM,KAAK,QAAQ,WAElB;IAED;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;;OAGG;IACH,MAAM,KAAK,gBAAgB,WAE1B;IAED;;OAEG;IACH,MAAM,KAAK,UAAU,WAEpB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,iBAAiB,CAAC"}

package/lib/components/tag/tag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../../src/components/tag/tag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAQvC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAI5C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;;;;;;;;;;uBAKG,CAAC;;;;;;;AAHlC;;;;;GAKG;AACH,cACM,MAAO,SAAQ,WAAyC;IAE5D,SAAS,CAAC,WAAW,EAAG,iBAAiB,CAAC;IAG1C,cAAc,EAAG,WAAW,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK;IAsBpD;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK;IAOjD;;;;OAIG;IAIH,SAAS,CAAC,YAAY,GAAI,OAAO,UAAU,UAgCzC;IAEF;;;;OAIG;IAEH,KAAK,SAAkB;IAEvB;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,MAAM,UAAS;IAEf;;OAEG;IAEH,aAAa,UAAS;IAEtB;;OAEG;IAEH,IAAI,UAAQ;IAEZ;;OAEG;IAEH,IAAI,WAAmB;IAEvB;;OAEG;IAEH,IAAI,WAAiB;IAErB;;OAEG;IAEH,mBAAmB,UAAS;IAE5B,OAAO;IAoBP,MAAM;IA8BN;;;;OAIG;IACH,MAAM,KAAK,QAAQ,WAElB;IAED;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;;OAGG;IACH,MAAM,KAAK,gBAAgB,WAE1B;IAED;;OAEG;IACH,MAAM,KAAK,UAAU,WAEpB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../../src/components/tag/tag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAQvC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAI5C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;;;;;;;;;;uBAKG,CAAC;;;;;;;AAHlC;;;;;GAKG;AACH,cACM,MAAO,SAAQ,WAAyC;IAE5D,SAAS,CAAC,WAAW,EAAG,iBAAiB,CAAC;IAG1C,cAAc,EAAG,WAAW,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK;IAsBpD;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK;IAOjD;;;;OAIG;IAIH,SAAS,CAAC,YAAY,GAAI,OAAO,UAAU,UAkCzC;IAEF;;;;OAIG;IAEH,KAAK,SAAkB;IAEvB;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,MAAM,UAAS;IAEf;;OAEG;IAEH,aAAa,UAAS;IAEtB;;OAEG;IAEH,IAAI,UAAQ;IAEZ;;OAEG;IAEH,IAAI,WAAmB;IAEvB;;OAEG;IAEH,IAAI,WAAiB;IAErB;;OAEG;IAEH,mBAAmB,UAAS;IAE5B,OAAO;IAoBP,MAAM;IA8BN;;;;OAIG;IACH,MAAM,KAAK,QAAQ,WAElB;IAED;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;;OAGG;IACH,MAAM,KAAK,gBAAgB,WAE1B;IAED;;OAEG;IACH,MAAM,KAAK,UAAU,WAEpB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,MAAM,CAAC"}

package/lib/components/tile/clickable-tile.d.ts

@@ -4,6 +4,7 @@
  * 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 { classMap } from 'lit/directives/class-map.js';
 import CDSLink from '../link/link';
 import { TILE_COLOR_SCHEME } from './defs';
 /**
@@ -12,7 +13,7 @@ import { TILE_COLOR_SCHEME } from './defs';
  * @element cds-clickable-tile
  */
 declare class CDSClickableTile extends CDSLink {
-    protected get _classes(): any;
+    protected get _classes(): ReturnType<typeof classMap>;
     /**
      * The color scheme.
      *

package/lib/components/tile/clickable-tile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clickable-tile.d.ts","sourceRoot":"","sources":["../../../src/components/tile/clickable-tile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAS3C;;;;GAIG;AACH,cACM,gBAAiB,SAAQ,OAAO;IAEpC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAU5B;IAED;;;;OAIG;IAEH,WAAW,oBAA6B;IAExC;;OAEG;IAEH,QAAQ,SAAY;IAEpB;;;OAGG;IAEH,iBAAiB,UAAS;IAG1B,OAAO,UAAS;IAEhB;;OAEG;IAEH,IAAI,UAAS;IAEb;;;;;OAKG;IACH,iBAAiB;IAQjB;;OAEG;IACH,SAAS,CAAC,YAAY;IAuBtB;;;;OAIG;IACH,MAAM,KAAK,QAAQ,WAElB;IAED;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"clickable-tile.d.ts","sourceRoot":"","sources":["../../../src/components/tile/clickable-tile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAGvD,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAS3C;;;;GAIG;AACH,cACM,gBAAiB,SAAQ,OAAO;IACpC,SAAS,KAAK,QAAQ,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAUpD;IAED;;;;OAIG;IAEH,WAAW,oBAA6B;IAExC;;OAEG;IAEH,QAAQ,SAAY;IAEpB;;;OAGG;IAEH,iBAAiB,UAAS;IAG1B,OAAO,UAAS;IAEhB;;OAEG;IAEH,IAAI,UAAS;IAEb;;;;;OAKG;IACH,iBAAiB;IAQjB;;OAEG;IACH,SAAS,CAAC,YAAY;IAuBtB;;;;OAIG;IACH,MAAM,KAAK,QAAQ,WAElB;IAED;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,gBAAgB,CAAC"}

package/lib/globals/controllers/floating-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floating-controller.d.ts","sourceRoot":"","sources":["../../../src/globals/controllers/floating-controller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAC1D,OAAO,EAEL,IAAI,EAOJ,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAC;AAE1B,KAAK,yBAAyB,GAAG;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,YAAW,kBAAkB;IACnE;;OAEG;IACH,OAAO,CAAC,IAAI,CAAkB;IAC9B;;OAEG;IACH,OAAO,CAAC,OAAO,CAA6B;IAC5C;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,CAAa;IAE7B;;;OAGG;gBACS,IAAI,EAAE,eAAe;IAK3B,YAAY,CAAC,OAAO,GAAE,yBAAwC;IAOpE,eAAe,QAAO,IAAI,CAExB;IAEI,gBAAgB;IA6LtB,WAAW,IAAI,IAAI;IAOnB,gBAAgB,IAAI,IAAI;CAIzB"}
+{"version":3,"file":"floating-controller.d.ts","sourceRoot":"","sources":["../../../src/globals/controllers/floating-controller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAC1D,OAAO,EAEL,IAAI,EAOJ,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAC;AAE1B,KAAK,yBAAyB,GAAG;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,YAAW,kBAAkB;IACnE;;OAEG;IACH,OAAO,CAAC,IAAI,CAAkB;IAC9B;;OAEG;IACH,OAAO,CAAC,OAAO,CAA6B;IAC5C;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,CAAa;IAE7B;;;OAGG;gBACS,IAAI,EAAE,eAAe;IAK3B,YAAY,CAAC,OAAO,GAAE,yBAAwC;IAOpE,eAAe,QAAO,IAAI,CAExB;IAEI,gBAAgB;IA4LtB,WAAW,IAAI,IAAI;IAOnB,gBAAgB,IAAI,IAAI;CAIzB"}

package/lib/globals/controllers/floating-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"floating-controller.js","names":[],"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?: Parameters<typeof flip>[0];\n  caret?: boolean;\n\n  styleElement?: HTMLElement;\n  matchWidth?: boolean;\n  open: boolean;\n  alignmentAxisOffset?: number;\n  mainAxisOffset?: 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?.();\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      mainAxisOffset,\n      autoAlignBoundary,\n      isTabTip,\n      flipArguments,\n    } = this.options;\n\n    const isListBox = target?.role === 'listbox';\n    const isMenu = target?.localName === 'cds-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        !isTabTip\n          ? {\n              alignmentAxis: alignmentAxisOffset,\n              // Allow callers to override default trigger-to-surface spacing.\n              // Fallback remains 4px for non-caret overlays.\n              mainAxis: mainAxisOffset ?? (caret ? offsetPx : 4),\n            }\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        ...flipArguments,\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"],"mappings":"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"}
+{"version":3,"file":"floating-controller.js","names":[],"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?: Parameters<typeof flip>[0];\n  caret?: boolean;\n\n  styleElement?: HTMLElement;\n  matchWidth?: boolean;\n  open: boolean;\n  alignmentAxisOffset?: number;\n  mainAxisOffset?: 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?.();\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      mainAxisOffset,\n      autoAlignBoundary,\n      isTabTip,\n      flipArguments,\n    } = this.options;\n\n    const isListBox = target?.role === 'listbox';\n    const isMenu = target?.localName === 'cds-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        !isTabTip\n          ? {\n              alignmentAxis: alignmentAxisOffset,\n              // Allow callers to override default trigger-to-surface spacing.\n              // Fallback remains 4px for non-caret overlays.\n              mainAxis: mainAxisOffset ?? (caret ? offsetPx : 4),\n            }\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        ...flipArguments,\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        const staticSide = {\n          top: 'bottom',\n          right: 'left',\n          bottom: 'top',\n          left: 'right',\n        }[placement.split('-')[0] as 'top' | 'right' | 'bottom' | 'left'];\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"],"mappings":"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"}

package/lib/globals/decorators/carbon-element.d.ts

@@ -38,6 +38,14 @@ type CustomElementClass = Omit<typeof HTMLElement, 'new'>;
  * }
  * ```
  *
+ * @deprecated The `carbonElement` decorator is deprecated and will be removed in
+ *   v3. In v3, `@carbon/web-components` moves to pure component
+ *   classes (`static is = '${prefix}-name'`) with opt-in registration via
+ *   `defineCustomElement`, and this self-registering decorator is removed. If you
+ *   author your own custom elements with it, migrate to Lit's `customElement`
+ *   (`import { customElement } from 'lit/decorators.js'`). See the v3 migration
+ *   guide:
+ *   https://github.com/carbon-design-system/carbon/blob/main/docs/guides/cwc-v3-migration.md#the-carbonelement-decorator-is-removed
  * @category Decorator
  * @param tagName The tag name of the custom element to define.
  */

package/lib/globals/decorators/carbon-element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"carbon-element.d.ts","sourceRoot":"","sources":["../../../src/globals/decorators/carbon-element.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,CAAC,OAAO,MAAM,WAAW,CAAC,CAAC,IAAI;IAEnC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACzB,CAAC;AAEF,KAAK,QAAQ,GACT,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,GAC9C,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,WAAW,CAAC;IACjB,SAAS,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED;;GAEG;AACH,KAAK,kBAAkB,GAAG,IAAI,CAAC,OAAO,WAAW,EAAE,KAAK,CAAC,CAAC;AAsC1D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GACvB,SAAS,MAAM,MACf,mBAAmB,kBAAkB,GAAG,eAAe,QAGkB,CAAC"}
+{"version":3,"file":"carbon-element.d.ts","sourceRoot":"","sources":["../../../src/globals/decorators/carbon-element.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,CAAC,OAAO,MAAM,WAAW,CAAC,CAAC,IAAI;IAEnC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACzB,CAAC;AAEF,KAAK,QAAQ,GACT,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,GAC9C,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,WAAW,CAAC;IACjB,SAAS,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED;;GAEG;AACH,KAAK,kBAAkB,GAAG,IAAI,CAAC,OAAO,WAAW,EAAE,KAAK,CAAC,CAAC;AAsC1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,aAAa,GACvB,SAAS,MAAM,MACf,mBAAmB,kBAAkB,GAAG,eAAe,QAGkB,CAAC"}

package/lib/globals/internal/collection-helpers.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.
@@ -10,21 +10,21 @@
  * @param [thisObject] The context object for the given callback function.
  * @returns A new array with all elements where `predicate` returns truthy.
  */
-export declare const filter: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, predicate: (search: Node, index?: number) => boolean, thisObject?: any) => any[];
+export declare const filter: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, predicate: (search: Node, index?: number) => boolean, thisObject?: unknown) => any[];
 /**
  * @param a A DOM collection.
  * @param predicate The callback function.
  * @param [thisObject] The context object for the given callback function.
  * @returns The index of the first item in the given collection where `predicate` returns `true`. `-1` if no such item is found.
  */
-export declare const findIndex: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, predicate: (search: Node, index?: number) => boolean, thisObject?: any) => number;
+export declare const findIndex: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, predicate: (search: Node, index?: number) => boolean, thisObject?: unknown) => number;
 /**
  * @param a A DOM collection.
  * @param predicate The callback function.
  * @param [thisObject] The context object for the given callback function.
  * @returns The first item in the given collection where `predicate` returns `true`. `null` if no such item is found.
  */
-export declare const find: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, predicate: (search: Node, index?: number) => boolean, thisObject?: any) => any;
+export declare const find: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, predicate: (search: Node, index?: number) => boolean, thisObject?: unknown) => any;
 /**
  * Walks through the given DOM collection and runs the given callback.
  *
@@ -32,7 +32,7 @@ export declare const find: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, pre
  * @param predicate The callback function.
  * @param [thisObject] The context object for the given callback function.
  */
-export declare const forEach: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, predicate: (search: Element, index?: number) => void, thisObject?: any) => void;
+export declare const forEach: (a: NodeListOf<Node> | HTMLCollectionOf<Element>, predicate: (search: Element, index?: number) => void, thisObject?: unknown) => void;
 /**
  * @param a A DOM collection.
  * @param item An item in the DOM collection.

package/lib/globals/internal/collection-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection-helpers.d.ts","sourceRoot":"","sources":["../../../src/globals/internal/collection-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GACjB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,EAEpD,aAAa,GAAG,UACwC,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,EAEpD,aAAa,GAAG,WAC2C,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,EAEpD,aAAa,GAAG,QACsC,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAClB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,EAEpD,aAAa,GAAG,SACyC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAClB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,MAAM,IAAI,WAC8B,CAAC"}
+{"version":3,"file":"collection-helpers.d.ts","sourceRoot":"","sources":["../../../src/globals/internal/collection-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GACjB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,EACpD,aAAa,OAAO,UACoC,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,EACpD,aAAa,OAAO,WACuC,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,EACpD,aAAa,OAAO,QACkC,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAClB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,EACpD,aAAa,OAAO,SACqC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAClB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAC/C,MAAM,IAAI,WAC8B,CAAC"}

package/lib/globals/internal/getSupportedLocale.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright IBM Corp. 2025, 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.
+ */
+/**
+ * Returns `locale` if it is supported by `Intl.NumberFormat`, otherwise
+ * returns `defaultLocale`.
+ */
+export declare function getSupportedLocale(locale: Intl.LocalesArgument, defaultLocale: string): Intl.LocalesArgument;
+//# sourceMappingURL=getSupportedLocale.d.ts.map

package/lib/globals/internal/getSupportedLocale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSupportedLocale.d.ts","sourceRoot":"","sources":["../../../src/globals/internal/getSupportedLocale.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,eAAe,EAC5B,aAAa,EAAE,MAAM,GACpB,IAAI,CAAC,eAAe,CAStB"}

package/lib/globals/mixins/on.d.ts

@@ -1,10 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 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 default function on(element: any, ...args: any): {
+export default function on<TEvent extends Event = Event>(element: EventTarget, type: string, listener: EventListenerObject | ((event: TEvent) => void), options?: boolean | AddEventListenerOptions): {
     release(): null;
 };
 //# sourceMappingURL=on.d.ts.map

package/lib/globals/mixins/on.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"on.d.ts","sourceRoot":"","sources":["../../../src/globals/mixins/on.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,MAAM,CAAC,OAAO,UAAU,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG;;EAQpD"}
+{"version":3,"file":"on.d.ts","sourceRoot":"","sources":["../../../src/globals/mixins/on.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,OAAO,UAAU,EAAE,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK,EACrD,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mBAAmB,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,EACzD,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB;;EAiB5C"}

package/lib/globals/register.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Copyright IBM Corp. 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.
+ */
+/**
+ * Public registration API for `@carbon/web-components`
+ *
+ * Component classes are side-effect free; importing a class does not
+ * register it. Registration is opt-in, using `defineCustomElement`.
+ * By default, Carbon web components auto-register via their import barrels.
+ */
+/**
+ * Custom element constructor that carries the registered tag name as a
+ * static `is` property instead of baking the tag name into a decorator.
+ */
+export interface CarbonCustomElementConstructor extends CustomElementConstructor {
+    /**
+     * the tag name this element registers under
+     */
+    is: string;
+}
+/**
+ * Options for {@link defineCustomElement}
+ */
+export interface DefineCustomElementOptions {
+    /**
+     * The tag name to register under. Defaults to the class's static `is`.
+     * Pass custom name to avoid global-registry collisions.
+     *
+     * ```js
+     * import CDSButton from '@carbon/web-components/es/components/button/button.js';
+     * import { defineCustomElement } from '@carbon/web-components/es/globals/register.js';
+     *
+     * // <cwc-button>
+     * defineCustomElement(CDSButton, { name: 'cwc-button' });
+     * ```
+     */
+    name?: string;
+    /**
+     * A custom registry to define the element in. Defaults to the global
+     * `customElements`. Pass a scoped `CustomElementRegistry` to keep registration
+     * out of global namespace.
+     *
+     * ```js
+     * import CDSButton from '@carbon/web-components/es/components/button/button.js';
+     * import { defineCustomElement } from '@carbon/web-components/es/globals/register.js';
+     *
+     * // Requires native support or the
+     * // `@webcomponents/scoped-custom-element-registry` polyfill.
+     * const registry = new CustomElementRegistry();
+     * defineCustomElement(CDSButton, { registry });
+     *
+     * // <cds-button> resolves to this registry, not the global one
+     * host.attachShadow({ mode: 'open', customElementRegistry: registry });
+     * ```
+     */
+    registry?: CustomElementRegistry;
+}
+/**
+ * Register a custom element class, under `options.name` in `options.registry`.
+ *
+ * `clazz` only needs to be a custom element constructor. `static is` is how a
+ * class carries its own tag (see {@link CarbonCustomElementConstructor}), but a
+ * class without one can still be registered by passing `options.name` — which
+ * is how an existing class is put on a second tag.
+ * Called by the registering barrels so importing a class stays pure.
+ *
+ * Re-registering the same class under the same tag is a no-op. If the tag is
+ * registered by a different class, i.e. two copies on the same page, the first
+ * definition wins and a warning is emitted in development.
+ *
+ * Classes can only be registered once per registry. If the tag is free but
+ * `clazz` is already registered under another name, e.g. a custom name call
+ * after the default tag was defined, a subclass is registered under the new name
+ * instead as `instanceof clazz`.
+ *
+ * @param clazz The custom element class to register
+ * @param options Registration options
+ * @returns The registered class, for re-export. This is `clazz` itself,
+ *   except in the subclass case above, where it is the subclass that was
+ *   actually registered under `options.name`.
+ */
+export declare const defineCustomElement: <T extends CustomElementConstructor & {
+    is?: string;
+}>(clazz: T, options?: DefineCustomElementOptions) => T;
+export default defineCustomElement;
+//# sourceMappingURL=register.d.ts.map

package/lib/globals/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/globals/register.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,8BACf,SAAQ,wBAAwB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,CAAC,SAAS,wBAAwB,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAEpD,OAAO,CAAC,EACR,UAAS,0BAA+B,KACvC,CA8CF,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/lib/globals/register.js

@@ -0,0 +1,61 @@
+/**
+ * Copyright IBM Corp. 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.
+ */
+
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/globals/register.ts
+/**
+* Register a custom element class, under `options.name` in `options.registry`.
+*
+* `clazz` only needs to be a custom element constructor. `static is` is how a
+* class carries its own tag (see {@link CarbonCustomElementConstructor}), but a
+* class without one can still be registered by passing `options.name` — which
+* is how an existing class is put on a second tag.
+* Called by the registering barrels so importing a class stays pure.
+*
+* Re-registering the same class under the same tag is a no-op. If the tag is
+* registered by a different class, i.e. two copies on the same page, the first
+* definition wins and a warning is emitted in development.
+*
+* Classes can only be registered once per registry. If the tag is free but
+* `clazz` is already registered under another name, e.g. a custom name call
+* after the default tag was defined, a subclass is registered under the new name
+* instead as `instanceof clazz`.
+*
+* @param clazz The custom element class to register
+* @param options Registration options
+* @returns The registered class, for re-export. This is `clazz` itself,
+*   except in the subclass case above, where it is the subclass that was
+*   actually registered under `options.name`.
+*/
+const defineCustomElement = (clazz, options = {}) => {
+	const registry = options.registry ?? customElements;
+	const name = options.name ?? clazz.is;
+	if (!name) return clazz;
+	const existing = registry.get(name);
+	if (existing) {
+		if (existing !== clazz && process.env.NODE_ENV === "development") globalThis.console?.warn(`[@carbon/web-components] <${name}> is already defined by a different class. This usually means more than one copy of @carbon/web-components is on the page; the first definition wins and components may mix versions. Deduplicate the dependency, or register into a scoped registry.`);
+		return clazz;
+	}
+	try {
+		registry.define(name, clazz);
+	} catch (error) {
+		if (error == null || error.name !== "NotSupportedError") throw error;
+		const ScopedElement = class extends clazz {};
+		Object.defineProperty(ScopedElement, "is", { value: name });
+		registry.define(name, ScopedElement);
+		return ScopedElement;
+	}
+	return clazz;
+};
+//#endregion
+exports.default = defineCustomElement;
+exports.defineCustomElement = defineCustomElement;
+
+//# sourceMappingURL=register.js.map

package/lib/globals/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","names":[],"sources":["../../src/globals/register.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 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 * Public registration API for `@carbon/web-components`\n *\n * Component classes are side-effect free; importing a class does not\n * register it. Registration is opt-in, using `defineCustomElement`.\n * By default, Carbon web components auto-register via their import barrels.\n */\n\n/**\n * Custom element constructor that carries the registered tag name as a\n * static `is` property instead of baking the tag name into a decorator.\n */\nexport interface CarbonCustomElementConstructor\n  extends CustomElementConstructor {\n  /**\n   * the tag name this element registers under\n   */\n  is: string;\n}\n\n/**\n * Options for {@link defineCustomElement}\n */\nexport interface DefineCustomElementOptions {\n  /**\n   * The tag name to register under. Defaults to the class's static `is`.\n   * Pass custom name to avoid global-registry collisions.\n   *\n   * ```js\n   * import CDSButton from '@carbon/web-components/es/components/button/button.js';\n   * import { defineCustomElement } from '@carbon/web-components/es/globals/register.js';\n   *\n   * // <cwc-button>\n   * defineCustomElement(CDSButton, { name: 'cwc-button' });\n   * ```\n   */\n  name?: string;\n  /**\n   * A custom registry to define the element in. Defaults to the global\n   * `customElements`. Pass a scoped `CustomElementRegistry` to keep registration\n   * out of global namespace.\n   *\n   * ```js\n   * import CDSButton from '@carbon/web-components/es/components/button/button.js';\n   * import { defineCustomElement } from '@carbon/web-components/es/globals/register.js';\n   *\n   * // Requires native support or the\n   * // `@webcomponents/scoped-custom-element-registry` polyfill.\n   * const registry = new CustomElementRegistry();\n   * defineCustomElement(CDSButton, { registry });\n   *\n   * // <cds-button> resolves to this registry, not the global one\n   * host.attachShadow({ mode: 'open', customElementRegistry: registry });\n   * ```\n   */\n  registry?: CustomElementRegistry;\n}\n\n/**\n * Register a custom element class, under `options.name` in `options.registry`.\n *\n * `clazz` only needs to be a custom element constructor. `static is` is how a\n * class carries its own tag (see {@link CarbonCustomElementConstructor}), but a\n * class without one can still be registered by passing `options.name` — which\n * is how an existing class is put on a second tag.\n * Called by the registering barrels so importing a class stays pure.\n *\n * Re-registering the same class under the same tag is a no-op. If the tag is\n * registered by a different class, i.e. two copies on the same page, the first\n * definition wins and a warning is emitted in development.\n *\n * Classes can only be registered once per registry. If the tag is free but\n * `clazz` is already registered under another name, e.g. a custom name call\n * after the default tag was defined, a subclass is registered under the new name\n * instead as `instanceof clazz`.\n *\n * @param clazz The custom element class to register\n * @param options Registration options\n * @returns The registered class, for re-export. This is `clazz` itself,\n *   except in the subclass case above, where it is the subclass that was\n *   actually registered under `options.name`.\n */\nexport const defineCustomElement = <\n  T extends CustomElementConstructor & { is?: string },\n>(\n  clazz: T,\n  options: DefineCustomElementOptions = {}\n): T => {\n  const registry = options.registry ?? customElements;\n  const name = options.name ?? clazz.is;\n  if (!name) {\n    return clazz;\n  }\n\n  const existing = registry.get(name);\n\n  if (existing) {\n    // Tag already definied, redefining with same class is a no-op. If more than\n    // one copy fights for tag the first definition wins\n    if (existing !== clazz && process.env.NODE_ENV === 'development') {\n      globalThis.console?.warn(\n        `[@carbon/web-components] <${name}> is already defined by a different ` +\n          `class. This usually means more than one copy of ` +\n          `@carbon/web-components is on the page; the first definition wins and ` +\n          `components may mix versions. Deduplicate the dependency, or register ` +\n          `into a scoped registry.`\n      );\n    }\n    return clazz;\n  }\n\n  // Tag name is free, but a class can only be registered once per registry.\n  // If `clazz` is already registered under another name, e.g. default `cds-`,\n  // `define()` throws `NotSupportedError`. Register new subclass under new\n  // name instead, so the custom name works. Elements stay `instanceof clazz`.\n  try {\n    registry.define(name, clazz as unknown as CustomElementConstructor);\n  } catch (error) {\n    if (\n      error == null ||\n      (error as { name?: string }).name !== 'NotSupportedError'\n    ) {\n      throw error;\n    }\n\n    const ScopedElement = class extends (clazz as unknown as CustomElementConstructor) {};\n    // keep static `is` in sync with the tag is was registered under\n    Object.defineProperty(ScopedElement, 'is', { value: name });\n    registry.define(name, ScopedElement);\n    return ScopedElement as unknown as T;\n  }\n\n  return clazz;\n};\n\nexport default defineCustomElement;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFA,MAAa,uBAGX,OACA,UAAsC,CAAC,MACjC;CACN,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,OAAO,QAAQ,QAAQ,MAAM;CACnC,IAAI,CAAC,MACH,OAAO;CAGT,MAAM,WAAW,SAAS,IAAI,IAAI;CAElC,IAAI,UAAU;EAGZ,IAAI,aAAa,SAAS,QAAQ,IAAI,aAAa,eACjD,WAAW,SAAS,KAClB,6BAA6B,KAAK,sPAKpC;EAEF,OAAO;CACT;CAMA,IAAI;EACF,SAAS,OAAO,MAAM,KAA4C;CACpE,SAAS,OAAO;EACd,IACE,SAAS,QACR,MAA4B,SAAS,qBAEtC,MAAM;EAGR,MAAM,gBAAgB,cAAe,MAA8C,CAAC;EAEpF,OAAO,eAAe,eAAe,MAAM,EAAE,OAAO,KAAK,CAAC;EAC1D,SAAS,OAAO,MAAM,aAAa;EACnC,OAAO;CACT;CAEA,OAAO;AACT"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/web-components",
   "description": "Web components for the Carbon Design System",
-  "version": "2.62.0",
+  "version": "2.63.0-rc.0",
   "license": "Apache-2.0",
   "main": "es/index.js",
   "module": "es/index.js",
@@ -11,7 +11,11 @@
     "directory": "packages/web-components"
   },
   "bugs": "https://github.com/carbon-design-system/carbon/issues",
+  "bin": {
+    "create-prefixed-build": "./bin/create-prefixed-build.js"
+  },
   "files": [
+    "bin/**/*",
     "custom-elements.json",
     "es/**/*",
     "es-custom/**/*",
@@ -51,9 +55,10 @@
     "build": "yarn clean && node tasks/build.js && yarn wca",
     "build:dist": "node tasks/build-dist.js",
     "build:cdn": "yarn clean && yarn build:dist",
-    "ci-check": "yarn wca && yarn typecheck",
+    "ci-check": "yarn registration-coverage && yarn wca && yarn typecheck",
     "clean": "rimraf es es-custom lib scss dist storybook-static storybook-static-v12 .storybook-v12/generated",
     "postinstall": "ibmtelemetry --config=telemetry.yml",
+    "registration-coverage": "node tasks/registration-coverage.mjs",
     "serve": "node tasks/build.js --serve",
     "start": "yarn storybook",
     "storybook": "storybook dev -p 6011",
@@ -61,27 +66,28 @@
     "storybook:v12": "yarn storybook:v12:prepare && storybook dev -p 6012 --config-dir .storybook-v12",
     "storybook:v12:build": "yarn storybook:v12:prepare && storybook build --config-dir .storybook-v12 --output-dir storybook-static-v12",
     "storybook:v12:prepare": "node ../../tasks/prepare-v12-storybook.mjs .",
-    "test": "web-test-runner \"src/components/**/__tests__/**/*.js\" --node-resolve --concurrency=1",
+    "test": "web-test-runner --node-resolve --concurrency=1",
     "test:updateSnapshots": "yarn test --update-snapshots",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "wca": "web-component-analyzer analyze src --outFile custom-elements.json",
+    "wca": "web-component-analyzer analyze src --outFile custom-elements.json && node tasks/wca-deprecation.mjs",
     "telemetry:config": "npx -y @ibm/telemetry-js-config-generator generate --wc --id 8cf8b3b8-a121-47d3-9eec-e4bea0ff23f5 --endpoint https://www-api.ibm.com/ibm-telemetry/v1/metrics --files ./src/components"
   },
   "dependencies": {
     "@carbon/icon-helpers": "10.47.0",
-    "@carbon/icons": "^11.87.0",
-    "@carbon/styles": "^1.114.0",
+    "@carbon/icons": "^11.88.0-rc.0",
+    "@carbon/styles": "^1.115.0-rc.0",
     "@carbon/utilities": "^0.25.0",
     "@floating-ui/dom": "^1.6.3",
     "@ibm/telemetry-js": "^1.10.2",
+    "@lit-labs/signals": "^0.3.0",
     "@lit/context": "^1.1.3",
     "lit": "^3.1.0",
     "lodash-es": "^4.17.21",
     "tslib": "^2.6.3"
   },
   "devDependencies": {
-    "@carbon/layout": "^11.58.0",
-    "@carbon/motion": "^11.51.0",
+    "@carbon/layout": "^11.59.0-rc.0",
+    "@carbon/motion": "^11.52.0-rc.0",
     "@juggle/resize-observer": "^3.4.0",
     "@mordech/vite-lit-loader": "^0.40.0",
     "@open-wc/testing": "^5.0.0",
@@ -97,7 +103,7 @@
     "@web/test-runner-puppeteer": "^1.0.0",
     "@webcomponents/webcomponentsjs": "^2.8.0",
     "autoprefixer": "^10.4.0",
-    "cssnano": "^8.0.0",
+    "cssnano": "^9.0.0",
     "flatpickr": "4.6.13",
     "globby": "^16.0.0",
     "remark-gfm": "^4.0.0",
@@ -130,5 +136,5 @@
       }
     ]
   },
-  "gitHead": "7518c84ffd00f22434fe19d83119692c12fccb2f"
+  "gitHead": "474482a993dff6b9085309aa4bc8484cf71b1612"
 }

package/scss/components/ai-label/ai-label.scss

@@ -4,8 +4,6 @@
 * This source code is licensed under the Apache-2.0 license found in the
 * LICENSE file in the root directory of this source tree.
 */
-@use 'sass:map';
-
 @use '@carbon/styles/scss/config' as *;
 @use '@carbon/styles/scss/type' as *;
 @use '@carbon/styles/scss/theme' as *;
@@ -16,26 +14,14 @@
 @use '@carbon/styles/scss/utilities/ai-gradient' as *;
 @use '@carbon/styles/scss/components/slug/index' as *;
 
-// importing tag color tokens for the styling slug in tag component
-@use '@carbon/styles/scss/components/tag/tokens' as tag-tokens;
-
-$colorMap: (
-  'red': tag-tokens.$tag-color-red,
-  'magenta': tag-tokens.$tag-color-magenta,
-  'purple': tag-tokens.$tag-color-purple,
-  'blue': tag-tokens.$tag-color-blue,
-  'cyan': tag-tokens.$tag-color-cyan,
-  'teal': tag-tokens.$tag-color-teal,
-  'green': tag-tokens.$tag-color-green,
-  'gray': tag-tokens.$tag-color-gray,
-  'cool-gray': tag-tokens.$tag-color-cool-gray,
-  'warm-gray': tag-tokens.$tag-color-warm-gray,
-  'high-contrast': $text-inverse,
-);
-
 :host(#{$prefix}-ai-label) {
   @extend .#{$prefix}--slug;
 
+  .#{$prefix}--slug__button {
+    border-color: transparent;
+    color: currentColor;
+  }
+
   .#{$prefix}--slug__text {
     @include font-family('sans');
   }
@@ -315,24 +301,29 @@ $colorMap: (
   }
 }
 
-@each $color, $token in $colorMap {
-  :host(#{$prefix}-ai-label[tag='#{$color}']) {
-    .#{$prefix}--slug__text {
-      color: $token;
-    }
+:host(#{$prefix}-ai-label[tag]) {
+  .#{$prefix}--slug__button {
+    margin-inline-start: to-rem(1px);
+  }
 
-    .#{$prefix}--slug__text::before {
-      background: $token;
-    }
+  .#{$prefix}--slug__text::before {
+    background-color: currentColor;
+  }
 
-    @media (any-hover: hover) {
-      button:hover {
-        border-color: $token;
+  @media (any-hover: hover) {
+    .#{$prefix}--slug__button:hover {
+      border-color: currentColor;
+      background: transparent;
+      box-shadow: none;
+      color: currentColor;
 
-        .#{$prefix}--slug__text::before {
-          background-color: $token;
-        }
+      .#{$prefix}--slug__text::before {
+        background-color: currentColor;
       }
     }
+
+    .#{$prefix}--slug__button:hover:active {
+      color: $text-secondary;
+    }
   }
 }

package/scss/components/big-number/big-number-skeleton.scss

@@ -0,0 +1,58 @@
+// Copyright IBM Corp. 2025, 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.
+
+$css--plex: true !default;
+
+@use '@carbon/styles/scss/reset';
+@use '@carbon/styles/scss/config' as *;
+@use '@carbon/styles/scss/spacing' as *;
+
+$skeleton-block-class: #{$prefix}--big-number-skeleton;
+
+:host(#{$prefix}-big-number-skeleton) {
+  .#{$skeleton-block-class} {
+    inline-size: $spacing-10;
+  }
+
+  .#{$skeleton-block-class}--lg {
+    inline-size: $spacing-11;
+  }
+
+  .#{$skeleton-block-class}--xl {
+    inline-size: $spacing-12;
+  }
+
+  .#{$skeleton-block-class}__label {
+    block-size: $spacing-04;
+    inline-size: 70%;
+    margin-block: 0 $spacing-03;
+  }
+
+  .#{$skeleton-block-class}__value::part(placeholder) {
+    margin: 0;
+    block-size: $spacing-08;
+    inline-size: 100%;
+  }
+
+  .#{$skeleton-block-class}.#{$skeleton-block-class}--lg
+    .#{$skeleton-block-class}__label {
+    margin-block: 0 $spacing-04;
+  }
+
+  .#{$skeleton-block-class}.#{$skeleton-block-class}--lg
+    .#{$skeleton-block-class}__value::part(placeholder) {
+    block-size: $spacing-09;
+  }
+
+  .#{$skeleton-block-class}.#{$skeleton-block-class}--xl
+    .#{$skeleton-block-class}__label {
+    margin-block: 0 $spacing-05;
+  }
+
+  .#{$skeleton-block-class}.#{$skeleton-block-class}--xl
+    .#{$skeleton-block-class}__value::part(placeholder) {
+    block-size: $spacing-10;
+  }
+}