@carbon/web-components 2.62.0 → 2.63.0

package/es/components/user-avatar/user-avatar.js

@@ -0,0 +1,151 @@
+/**
+ * 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.
+ */
+
+import "../../globals/settings.js";
+import { carbonElement } from "../../globals/decorators/carbon-element.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
+import iconLoader from "../../globals/internal/icon-loader.js";
+import HostListenerMixin from "../../globals/mixins/host-listener.js";
+import "../tooltip/index.js";
+import user_avatar_default$1 from "./user-avatar.scss.js";
+import { LitElement, html } from "lit";
+import { property, state } from "lit/decorators.js";
+import { classMap } from "lit/directives/class-map.js";
+import User from "@carbon/icons/es/user/16";
+//#region src/components/user-avatar/user-avatar.ts
+/**
+* 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.
+*/
+const blockClass = `cds--user-avatar`;
+/**
+* User Avatar.
+*
+* @element cds-user-avatar
+*/
+let CDSUserAvatar = class CDSUserAvatar extends HostListenerMixin(LitElement) {
+	constructor(..._args) {
+		super(..._args);
+		this.tooltipAlignment = "bottom";
+		this.size = "md";
+		this.backgroundColor = "order-1-cyan";
+		this._hasRenderIcon = false;
+		this._observerMutation = null;
+		this._handleMutation = () => {
+			this._hasRenderIcon = Boolean(this.querySelector("[slot=\"rendericon\"]"));
+		};
+	}
+	connectedCallback() {
+		super.connectedCallback();
+		this._hasRenderIcon = Boolean(this.querySelector("[slot=\"rendericon\"]"));
+		this._observerMutation = new MutationObserver(this._handleMutation);
+		this._observerMutation.observe(this, {
+			childList: true,
+			subtree: true,
+			attributes: true,
+			attributeFilter: ["slot"]
+		});
+	}
+	disconnectedCallback() {
+		if (this._observerMutation) {
+			this._observerMutation.disconnect();
+			this._observerMutation = null;
+		}
+		super.disconnectedCallback();
+	}
+	_onSlotChange() {
+		this._hasRenderIcon = Boolean(this.querySelector("[slot=\"rendericon\"]"));
+	}
+	render() {
+		const getItem = () => {
+			if (this.image) {
+				const imageClasses = classMap({
+					[`${blockClass}__photo`]: true,
+					[`${blockClass}__photo--${this.size}`]: this.size
+				});
+				return html` <img
+          alt="${this.imageDescription ?? ""}"
+          src="${this.image}"
+          class="${imageClasses}" />`;
+			}
+			if (this._hasRenderIcon) return html`<slot
+          name="rendericon"
+          @slotchange=${this._onSlotChange}></slot>`;
+			if (this.name) {
+				const parts = this.name?.split(" ") || [];
+				const firstChar = parts[0].charAt(0).toUpperCase();
+				const secondChar = parts[0].charAt(1).toUpperCase();
+				if (parts.length === 1) return firstChar + secondChar;
+				const lastChar = parts[parts.length - 1].charAt(0).toUpperCase();
+				const initials = [firstChar];
+				if (lastChar) initials.push(lastChar);
+				return "".concat(...initials);
+			}
+			return html`${iconLoader(User, { slot: "rendericon" })} `;
+		};
+		const { tooltipText, tooltipAlignment, size, backgroundColor, theme } = this;
+		const classes = classMap({
+			[`${blockClass}`]: true,
+			[`${blockClass}--${size}`]: size,
+			[`${blockClass}--${backgroundColor}`]: backgroundColor,
+			[`${blockClass}--${theme}`]: theme
+		});
+		const Avatar = () => html`<div class="${classes}">${getItem()}</div>`;
+		if (tooltipText) return html`<cds-tooltip
+        align=${tooltipAlignment}
+        class=${`${blockClass}__tooltip cds--icon-tooltip`}>
+        <button
+          class=${`${blockClass}__tooltip-trigger`}
+          type="button"
+          aria-label=${tooltipText}>
+          ${Avatar()}
+        </button>
+        <cds-tooltip-content class=${`${blockClass}__tooltip-content`}>
+          ${tooltipText}
+        </cds-tooltip-content>
+      </cds-tooltip>`;
+		else return html` ${Avatar()}`;
+	}
+	static {
+		this.shadowRootOptions = {
+			...LitElement.shadowRootOptions,
+			delegatesFocus: true
+		};
+	}
+	static {
+		this.styles = user_avatar_default$1;
+	}
+};
+__decorate([property({
+	reflect: true,
+	attribute: "tooltip-text"
+})], CDSUserAvatar.prototype, "tooltipText", void 0);
+__decorate([property({
+	reflect: true,
+	attribute: "tooltip-alignment"
+})], CDSUserAvatar.prototype, "tooltipAlignment", void 0);
+__decorate([property({ reflect: true })], CDSUserAvatar.prototype, "name", void 0);
+__decorate([property({ reflect: true })], CDSUserAvatar.prototype, "size", void 0);
+__decorate([property({ reflect: true })], CDSUserAvatar.prototype, "image", void 0);
+__decorate([property({
+	reflect: true,
+	attribute: "image-description"
+})], CDSUserAvatar.prototype, "imageDescription", void 0);
+__decorate([property({
+	reflect: true,
+	attribute: "background-color"
+})], CDSUserAvatar.prototype, "backgroundColor", void 0);
+__decorate([property({ reflect: true })], CDSUserAvatar.prototype, "theme", void 0);
+__decorate([state()], CDSUserAvatar.prototype, "_hasRenderIcon", void 0);
+CDSUserAvatar = __decorate([carbonElement(`cds-user-avatar`)], CDSUserAvatar);
+var user_avatar_default = CDSUserAvatar;
+//#endregion
+export { user_avatar_default as default };
+
+//# sourceMappingURL=user-avatar.js.map

package/es/components/user-avatar/user-avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-avatar.js","names":["styles","customElement"],"sources":["../../../src/components/user-avatar/user-avatar.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2025, 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 { LitElement, html } from 'lit';\nimport { property, state } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { prefix } from '../../globals/settings';\nimport HostListenerMixin from '../../globals/mixins/host-listener';\nimport { carbonElement as customElement } from '../../globals/decorators/carbon-element';\nimport styles from './user-avatar.scss?lit';\nimport '../tooltip/index';\nimport User from '@carbon/icons/es/user/16';\nimport { iconLoader } from '../../globals/internal/icon-loader';\n\nconst blockClass = `${prefix}--user-avatar`;\n\n/**\n * User Avatar.\n *\n * @element cds-user-avatar\n */\n\n@customElement(`${prefix}-user-avatar`)\nclass CDSUserAvatar extends HostListenerMixin(LitElement) {\n  /**\n   * Specify the text of the tooltip.\n   * Can be string\n   */\n  @property({ reflect: true, attribute: 'tooltip-text' })\n  tooltipText;\n\n  /**\n   * Specify the alignment of the tooltip.\n   */\n  @property({ reflect: true, attribute: 'tooltip-alignment' })\n  tooltipAlignment = 'bottom';\n\n  /**\n   * When passing the name prop, either send the initials to be used or the\n   * user's full name. The first two capital letters of the user's name will be\n   * used as the name.\n   */\n  @property({ reflect: true })\n  name;\n\n  /**\n   * Set the size of the avatar circle.\n   */\n  @property({ reflect: true })\n  size = 'md';\n\n  /**\n   * When passing the image prop, supply a full path to the image to be\n   * displayed.\n   */\n  @property({ reflect: true })\n  image;\n\n  /**\n   * When passing the image prop use the imageDescription prop to describe the\n   * image for screen reader.\n   */\n  @property({ reflect: true, attribute: 'image-description' })\n  imageDescription;\n\n  /**\n   * Specify the background color for UserAvatar.\n   */\n  @property({ reflect: true, attribute: 'background-color' })\n  backgroundColor = 'order-1-cyan';\n\n  /**\n   * Set theme in which the component will be rendered.\n   */\n  @property({ reflect: true })\n  theme;\n\n  @state()\n  private _hasRenderIcon = false;\n\n  private _observerMutation: MutationObserver | null = null;\n\n  private _handleMutation = () => {\n    this._hasRenderIcon = Boolean(this.querySelector('[slot=\"rendericon\"]'));\n  };\n\n  connectedCallback() {\n    super.connectedCallback();\n    this._hasRenderIcon = Boolean(this.querySelector('[slot=\"rendericon\"]'));\n    this._observerMutation = new MutationObserver(this._handleMutation);\n    this._observerMutation.observe(this, {\n      childList: true,\n      subtree: true,\n      attributes: true,\n      attributeFilter: ['slot'],\n    });\n  }\n\n  disconnectedCallback() {\n    if (this._observerMutation) {\n      this._observerMutation.disconnect();\n      this._observerMutation = null;\n    }\n    super.disconnectedCallback();\n  }\n\n  private _onSlotChange() {\n    this._hasRenderIcon = Boolean(this.querySelector('[slot=\"rendericon\"]'));\n  }\n\n  render() {\n    const getItem = () => {\n      if (this.image) {\n        const imageClasses = classMap({\n          [`${blockClass}__photo`]: true,\n          [`${blockClass}__photo--${this.size}`]: this.size,\n        });\n        return html` <img\n          alt=\"${this.imageDescription ?? ''}\"\n          src=\"${this.image}\"\n          class=\"${imageClasses}\" />`;\n      }\n      if (this._hasRenderIcon) {\n        return html`<slot\n          name=\"rendericon\"\n          @slotchange=${this._onSlotChange}></slot>`;\n      }\n      if (this.name) {\n        const parts = this.name?.split(' ') || [];\n        const firstChar = parts[0].charAt(0).toUpperCase();\n        const secondChar = parts[0].charAt(1).toUpperCase();\n        if (parts.length === 1) {\n          return firstChar + secondChar;\n        }\n        const lastChar = parts[parts.length - 1].charAt(0).toUpperCase();\n        const initials = [firstChar];\n        if (lastChar) {\n          initials.push(lastChar);\n        }\n\n        return ''.concat(...initials);\n      }\n      return html`${iconLoader(User, { slot: 'rendericon' })} `;\n    };\n\n    const { tooltipText, tooltipAlignment, size, backgroundColor, theme } =\n      this;\n    const classes = classMap({\n      [`${blockClass}`]: true,\n      [`${blockClass}--${size}`]: size,\n      [`${blockClass}--${backgroundColor}`]: backgroundColor,\n      [`${blockClass}--${theme}`]: theme,\n    });\n\n    const Avatar = () => html`<div class=\"${classes}\">${getItem()}</div>`;\n\n    if (tooltipText) {\n      return html`<cds-tooltip\n        align=${tooltipAlignment}\n        class=${`${blockClass}__tooltip ${prefix}--icon-tooltip`}>\n        <button\n          class=${`${blockClass}__tooltip-trigger`}\n          type=\"button\"\n          aria-label=${tooltipText}>\n          ${Avatar()}\n        </button>\n        <cds-tooltip-content class=${`${blockClass}__tooltip-content`}>\n          ${tooltipText}\n        </cds-tooltip-content>\n      </cds-tooltip>`;\n    } else {\n      return html` ${Avatar()}`;\n    }\n  }\n\n  static shadowRootOptions = {\n    ...LitElement.shadowRootOptions,\n    delegatesFocus: true,\n  };\n\n  static styles = styles;\n}\n\nexport default CDSUserAvatar;\n"],"mappings":"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"}

package/es/components/user-avatar/user-avatar.scss.js

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+
+import { css } from "lit";
+//#region src/components/user-avatar/user-avatar.scss?lit
+var user_avatar_default = css(["a,abbr,acronym,address,applet,article,aside,audio,b,big,blockquote,body,canvas,caption,center,cite,code,dd,del,details,dfn,div,dl,dt,em,embed,fieldset,figcaption,figure,footer,form,h1,h2,h3,h4,h5,h6,header,hgroup,html,i,iframe,img,ins,kbd,label,legend,li,mark,menu,nav,object,ol,output,p,pre,q,ruby,s,samp,section,small,span,strike,strong,sub,summary,sup,table,tbody,td,tfoot,th,thead,time,tr,tt,u,ul,var,video{padding:0;border:0;margin:0;font:inherit;font-feature-settings:\"liga\" 1;font-size:100%;vertical-align:baseline}button,input,select,textarea{border-radius:0;font-family:inherit}:root{color-scheme:var(--cds-color-scheme,light)}article,aside,details,figcaption,figure,footer,header,hgroup,menu,nav,section{display:block}body{background-color:var(--cds-background,#fff);color:var(--cds-text-primary,#161616);line-height:1}ol,ul{list-style:none}blockquote,q{quotes:none}blockquote:after,blockquote:before,q:after,q:before{content:none}table{border-collapse:collapse;border-spacing:0}html{box-sizing:border-box}*,:after,:before{box-sizing:inherit}html{font-size:100%}body{font-weight:400;font-family:IBM Plex Sans,system-ui,-apple-system,BlinkMacSystemFont,\\.SFNSText-Regular,sans-serif;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility}code{font-family:IBM Plex Mono,system-ui,-apple-system,BlinkMacSystemFont,\\.SFNSText-Regular,monospace}strong{font-weight:600}@media screen and (-ms-high-contrast:active){svg{fill:ButtonText}}h1{font-size:var(--cds-heading-06-font-size,2.625rem);font-weight:var(--cds-heading-06-font-weight,300);line-height:var(--cds-heading-06-line-height,1.199);letter-spacing:var(--cds-heading-06-letter-spacing,0)}h2{font-size:var(--cds-heading-05-font-size,2rem);font-weight:var(--cds-heading-05-font-weight,400);line-height:var(--cds-heading-05-line-height,1.25);letter-spacing:var(--cds-heading-05-letter-spacing,0)}h3{font-size:var(--cds-heading-04-font-size,1.75rem);font-weight:var(--cds-heading-04-font-weight,400);line-height:var(--cds-heading-04-line-height,1.28572);letter-spacing:var(--cds-heading-04-letter-spacing,0)}h4{font-size:var(--cds-heading-03-font-size,1.25rem);font-weight:var(--cds-heading-03-font-weight,400);line-height:var(--cds-heading-03-line-height,1.4);letter-spacing:var(--cds-heading-03-letter-spacing,0)}h5{font-size:var(--cds-heading-02-font-size,1rem);font-weight:var(--cds-heading-02-font-weight,600);line-height:var(--cds-heading-02-line-height,1.5);letter-spacing:var(--cds-heading-02-letter-spacing,0)}h6{font-size:var(--cds-heading-01-font-size,.875rem);font-weight:var(--cds-heading-01-font-weight,600);line-height:var(--cds-heading-01-line-height,1.42857);letter-spacing:var(--cds-heading-01-letter-spacing,.16px)}p{font-size:var(--cds-body-02-font-size,1rem);font-weight:var(--cds-body-02-font-weight,400);line-height:var(--cds-body-02-line-height,1.5);letter-spacing:var(--cds-body-02-letter-spacing,0)}a{color:var(--cds-link-primary,#0062fe)}em{font-style:italic}.cds--user-avatar{position:relative;display:flex;align-items:center;justify-content:center;border:.5px solid transparent;border-radius:100%;block-size:4rem;color:var(--cds-text-inverse,#fff);inline-size:4rem;outline:none;outline-offset:3px}.cds--user-avatar svg{color:var(--cds-icon-inverse,#fff)}.cds--user-avatar__tooltip-trigger{display:flex;box-sizing:border-box;align-items:center;justify-content:center;padding:0;border:0;margin:0;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;block-size:100%;cursor:pointer;inline-size:100%;outline:none}.cds--user-avatar__tooltip:focus-within .cds--user-avatar{outline:2px solid var(--cds-focus,#0f62fe);outline-offset:1px}.cds--user-avatar__photo{border-radius:100%;-o-object-fit:contain;object-fit:contain}.cds--user-avatar--xl{block-size:4rem;inline-size:4rem}.cds--user-avatar--lg{block-size:3rem;inline-size:3rem}.cds--user-avatar--md{block-size:2rem;inline-size:2rem}.cds--user-avatar--sm{block-size:1.5rem;inline-size:1.5rem}.cds--user-avatar--xl{font-size:var(--cds-heading-04-font-size,1.75rem);font-weight:var(--cds-heading-04-font-weight,400);line-height:var(--cds-heading-04-line-height,1.28572);letter-spacing:var(--cds-heading-04-letter-spacing,0)}.cds--user-avatar--lg{font-size:var(--cds-heading-03-font-size,1.25rem);font-weight:var(--cds-heading-03-font-weight,400);line-height:var(--cds-heading-03-line-height,1.4);letter-spacing:var(--cds-heading-03-letter-spacing,0)}.cds--user-avatar--md{font-size:var(--cds-body-compact-01-font-size,.875rem);font-weight:var(--cds-body-compact-01-font-weight,400);line-height:var(--cds-body-compact-01-line-height,1.28572);letter-spacing:var(--cds-body-compact-01-letter-spacing,.16px)}.cds--user-avatar--sm{font-size:var(--cds-label-01-font-size,.75rem);font-weight:var(--cds-label-01-font-weight,400);line-height:var(--cds-label-01-line-height,1.33333);letter-spacing:var(--cds-label-01-letter-spacing,.32px)}.cds--user-avatar__photo--xl{border-radius:100%;block-size:4rem;inline-size:4rem;-o-object-fit:fill;object-fit:fill}.cds--user-avatar__photo--lg{border-radius:100%;block-size:3rem;inline-size:3rem;-o-object-fit:fill;object-fit:fill}.cds--user-avatar__photo--md{border-radius:100%;block-size:2rem;inline-size:2rem;-o-object-fit:fill;object-fit:fill}.cds--user-avatar__photo--sm{border-radius:100%;block-size:1.5rem;inline-size:1.5rem;-o-object-fit:fill;object-fit:fill}.cds--g10 .cds--user-avatar--order-1-cyan,.cds--white .cds--user-avatar--order-1-cyan,:root .cds--user-avatar--order-1-cyan{background-color:#0072c3}.cds--g10 .cds--user-avatar--order-2-gray,.cds--white .cds--user-avatar--order-2-gray,:root .cds--user-avatar--order-2-gray{background-color:#6f6f6f}.cds--g10 .cds--user-avatar--order-3-green,.cds--white .cds--user-avatar--order-3-green,:root .cds--user-avatar--order-3-green{background-color:#198038}.cds--g10 .cds--user-avatar--order-4-magenta,.cds--white .cds--user-avatar--order-4-magenta,:root .cds--user-avatar--order-4-magenta{background-color:#d02670}.cds--g10 .cds--user-avatar--order-5-purple,.cds--white .cds--user-avatar--order-5-purple,:root .cds--user-avatar--order-5-purple{background-color:#8a3ffc}.cds--g10 .cds--user-avatar--order-6-teal,.cds--white .cds--user-avatar--order-6-teal,:root .cds--user-avatar--order-6-teal{background-color:#007d79}.cds--g10 .cds--user-avatar--order-7-cyan,.cds--white .cds--user-avatar--order-7-cyan,:root .cds--user-avatar--order-7-cyan{background-color:#003a6d}.cds--g10 .cds--user-avatar--order-8-gray,.cds--white .cds--user-avatar--order-8-gray,:root .cds--user-avatar--order-8-gray{background-color:#393939}.cds--g10 .cds--user-avatar--order-9-green,.cds--white .cds--user-avatar--order-9-green,:root .cds--user-avatar--order-9-green{background-color:#044317}.cds--g10 .cds--user-avatar--order-10-magenta,.cds--white .cds--user-avatar--order-10-magenta,:root .cds--user-avatar--order-10-magenta{background-color:#740937}.cds--g10 .cds--user-avatar--order-11-purple,.cds--white .cds--user-avatar--order-11-purple,:root .cds--user-avatar--order-11-purple{background-color:#491d8b}.cds--g10 .cds--user-avatar--order-12-teal,.cds--white .cds--user-avatar--order-12-teal,:root .cds--user-avatar--order-12-teal{background-color:#004144}.cds--g100 .cds--user-avatar--order-1-cyan,.cds--g90 .cds--user-avatar--order-1-cyan{background-color:#1192e8}.cds--g100 .cds--user-avatar--order-2-gray,.cds--g90 .cds--user-avatar--order-2-gray{background-color:#8d8d8d}.cds--g100 .cds--user-avatar--order-3-green,.cds--g90 .cds--user-avatar--order-3-green{background-color:#24a148}.cds--g100 .cds--user-avatar--order-4-magenta,.cds--g90 .cds--user-avatar--order-4-magenta{background-color:#ee5396}.cds--g100 .cds--user-avatar--order-5-purple,.cds--g90 .cds--user-avatar--order-5-purple{background-color:#a56eff}.cds--g100 .cds--user-avatar--order-6-teal,.cds--g90 .cds--user-avatar--order-6-teal{background-color:#009d9a}.cds--g100 .cds--user-avatar--order-7-cyan,.cds--g90 .cds--user-avatar--order-7-cyan{background-color:#82cfff}.cds--g100 .cds--user-avatar--order-8-gray,.cds--g90 .cds--user-avatar--order-8-gray{background-color:#c6c6c6}.cds--g100 .cds--user-avatar--order-9-green,.cds--g90 .cds--user-avatar--order-9-green{background-color:#6fdc8c}.cds--g100 .cds--user-avatar--order-10-magenta,.cds--g90 .cds--user-avatar--order-10-magenta{background-color:#ffafd2}.cds--g100 .cds--user-avatar--order-11-purple,.cds--g90 .cds--user-avatar--order-11-purple{background-color:#d4bbff}.cds--g100 .cds--user-avatar--order-12-teal,.cds--g90 .cds--user-avatar--order-12-teal{background-color:#3ddbd9}:host(cds-user-avatar){display:inline-block}:host(cds-user-avatar) .cds--user-avatar{box-sizing:border-box}:host(cds-user-avatar) .cds--user-avatar--xl ::slotted([slot=rendericon]){block-size:2rem;inline-size:2rem}:host(cds-user-avatar) .cds--user-avatar--lg ::slotted([slot=rendericon]){block-size:1.5rem;inline-size:1.5rem}:host(cds-user-avatar) .cds--user-avatar--md ::slotted([slot=rendericon]){block-size:1.25rem;inline-size:1.25rem}:host(cds-user-avatar) .cds--user-avatar--sm ::slotted([slot=rendericon]){block-size:1rem;inline-size:1rem}:host(cds-user-avatar) .cds--user-avatar__tooltip-trigger{padding:0;border:0;background:none;outline:none}:host(cds-user-avatar) .cds--user-avatar__tooltip-content{--cds-tooltip-padding-block:0.125rem}:host(cds-user-avatar) .cds--user-avatar__tooltip-content:focus-within{outline:.125rem solid var(--cds-focus,#0f62fe);outline-offset:1px}:host(cds-user-avatar) .cds--user-avatar--order-1-cyan,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-1-cyan{background-color:#0072c3}:host(cds-user-avatar) .cds--user-avatar--order-2-gray,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-2-gray{background-color:#6f6f6f}:host(cds-user-avatar) .cds--user-avatar--order-3-green,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-3-green{background-color:#198038}:host(cds-user-avatar) .cds--user-avatar--order-4-magenta,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-4-magenta{background-color:#d02670}:host(cds-user-avatar) .cds--user-avatar--order-5-purple,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-5-purple{background-color:#8a3ffc}:host(cds-user-avatar) .cds--user-avatar--order-6-teal,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-6-teal{background-color:#007d79}:host(cds-user-avatar) .cds--user-avatar--order-7-cyan,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-7-cyan{background-color:#003a6d}:host(cds-user-avatar) .cds--user-avatar--order-8-gray,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-8-gray{background-color:#393939}:host(cds-user-avatar) .cds--user-avatar--order-9-green,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-9-green{background-color:#044317}:host(cds-user-avatar) .cds--user-avatar--order-10-magenta,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-10-magenta{background-color:#740937}:host(cds-user-avatar) .cds--user-avatar--order-11-purple,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-11-purple{background-color:#491d8b}:host(cds-user-avatar) .cds--user-avatar--order-12-teal,:host(cds-user-avatar[theme=light]) .cds--user-avatar--order-12-teal{background-color:#004144}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-1-cyan{background-color:#1192e8}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-2-gray{background-color:#8d8d8d}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-3-green{background-color:#24a148}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-4-magenta{background-color:#ee5396}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-5-purple{background-color:#a56eff}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-6-teal{background-color:#009d9a}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-7-cyan{background-color:#82cfff}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-8-gray{background-color:#c6c6c6}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-9-green{background-color:#6fdc8c}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-10-magenta{background-color:#ffafd2}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-11-purple{background-color:#d4bbff}:host(cds-user-avatar[theme=dark]) .cds--user-avatar--order-12-teal{background-color:#3ddbd9}"]);
+//#endregion
+export { user_avatar_default as default };
+
+//# sourceMappingURL=user-avatar.scss.js.map

package/es/components/user-avatar/user-avatar.scss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-avatar.scss.js","names":[],"sources":["../../../src/components/user-avatar/user-avatar.scss?lit"],"sourcesContent":["/*\n * Copyright IBM Corp. 2025, 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$css--plex: true !default;\n\n@use '@carbon/styles/scss/reset';\n@use '@carbon/styles/scss/config' as *;\n@use '@carbon/styles/scss/spacing' as *;\n@use '@carbon/styles/scss/theme' as *;\n@use '@carbon/styles/scss/type';\n@use '@carbon/styles/scss/colors' as *;\n\n@use '@carbon/styles/scss/components/user-avatar' as *;\n$block-class: #{$prefix}--user-avatar;\n\n:host(#{$prefix}-user-avatar) {\n  display: inline-block;\n\n  .#{$block-class} {\n    box-sizing: border-box;\n  }\n}\n\n:host(#{$prefix}-user-avatar) .#{$block-class}--xl {\n  ::slotted([slot='rendericon']) {\n    block-size: $spacing-07;\n    inline-size: $spacing-07;\n  }\n}\n\n:host(#{$prefix}-user-avatar) .#{$block-class}--lg {\n  ::slotted([slot='rendericon']) {\n    block-size: $spacing-06;\n    inline-size: $spacing-06;\n  }\n}\n\n:host(#{$prefix}-user-avatar) .#{$block-class}--md {\n  ::slotted([slot='rendericon']) {\n    block-size: $spacing-04 + $spacing-03;\n    inline-size: $spacing-04 + $spacing-03;\n  }\n}\n\n:host(#{$prefix}-user-avatar) .#{$block-class}--sm {\n  ::slotted([slot='rendericon']) {\n    block-size: $spacing-05;\n    inline-size: $spacing-05;\n  }\n}\n\n:host(#{$prefix}-user-avatar) .#{$block-class}__tooltip-trigger {\n  padding: 0;\n  border: 0;\n  background: none;\n  outline: none;\n}\n\n:host(#{$prefix}-user-avatar) .#{$block-class}__tooltip-content {\n  --cds-tooltip-padding-block: #{$spacing-01};\n\n  &:focus-within {\n    outline: $spacing-01 solid $focus;\n    outline-offset: 1px;\n  }\n}\n\n@mixin setBgColor($color) {\n  background-color: $color;\n}\n\n// this mixin allows you to set background color based on the lighter themes such as g10 and white\n@mixin setLightBg($order, $color) {\n  :host(#{$prefix}-user-avatar) .#{$block-class}--#{$order},\n  :host(#{$prefix}-user-avatar[theme='light']) .#{$block-class}--#{$order} {\n    @include setBgColor($color);\n  }\n}\n\n@mixin setDarkBg($order, $color) {\n  :host(#{$prefix}-user-avatar[theme='dark']) .#{$block-class}--#{$order} {\n    @include setBgColor($color);\n  }\n}\n\n@include setLightBg(order-1-cyan, $cyan-60);\n@include setLightBg(order-2-gray, $gray-60);\n@include setLightBg(order-3-green, $green-60);\n@include setLightBg(order-4-magenta, $magenta-60);\n@include setLightBg(order-5-purple, $purple-60);\n@include setLightBg(order-6-teal, $teal-60);\n@include setLightBg(order-7-cyan, $cyan-80);\n@include setLightBg(order-8-gray, $gray-80);\n@include setLightBg(order-9-green, $green-80);\n@include setLightBg(order-10-magenta, $magenta-80);\n@include setLightBg(order-11-purple, $purple-80);\n@include setLightBg(order-12-teal, $teal-80);\n@include setDarkBg(order-1-cyan, $cyan-50);\n@include setDarkBg(order-2-gray, $gray-50);\n@include setDarkBg(order-3-green, $green-50);\n@include setDarkBg(order-4-magenta, $magenta-50);\n@include setDarkBg(order-5-purple, $purple-50);\n@include setDarkBg(order-6-teal, $teal-50);\n@include setDarkBg(order-7-cyan, $cyan-30);\n@include setDarkBg(order-8-gray, $gray-30);\n@include setDarkBg(order-9-green, $green-30);\n@include setDarkBg(order-10-magenta, $magenta-30);\n@include setDarkBg(order-11-purple, $purple-30);\n@include setDarkBg(order-12-teal, $teal-30);\n"],"mappings":""}

package/es/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/es/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":";;;;;;;;;;;;AAyCA,IAAqB,qBAArB,MAAsE;;;;;CAkBpE,YAAY,MAAuB;+BAYL;GAC5B,KAAK,iBAAiB;EACxB;EAbE,KAAK,OAAO;EACZ,KAAK,cAAc,IAAI;CACzB;CAEA,MAAM,aAAa,UAAqC,KAAK,SAAS;EACpE,KAAK,UAAU;EACf,MAAM,EAAE,SAAS,WAAW;EAC5B,KAAK,UAAU;EACf,KAAK,UAAU,WAAW,SAAS,QAAQ,KAAK,eAAe;CACjE;CAMA,MAAM,mBAAmB;EACvB,MAAM,EACJ,cACA,WACA,OACA,SACA,QACA,cACA,YACA,MACA,qBACA,gBACA,mBACA,UACA,kBACE,KAAK;EAET,MAAM,YAAY,QAAQ,SAAS;EACnC,MAAM,SAAS,QAAQ,cAAc;EAErC,MAAM,UAAU,gBAAgB;EAEhC,IAAI,CAAC,SAAS;EAEd,IAAI;EACJ,QAAQ,WAAR;GACE,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF;IACE,eAAe;IACf;EACJ;EACA,MAAM,KAAK,iBAAiB,OAAO;EACnC,MAAM,QAAQ,QAAgB;GAC5B,MAAM,MAAM,WAAW,GAAG;GAC1B,OAAO,IAAI,KAAK,CAAC,CAAC,SAAS,KAAK,IAAI,MAAM,KAAK;EACjD;EACA,MAAM,WAAW,CAAC,WACb,KAAK,GAAG,iBAAiB,sBAAsB,CAAC,CAAC,KAAK,CAAC,KAAK,KAC7D;EAEJ,MAAM,aAAa;GACjB,OACE,CAAC,WACG;IACE,eAAe;IAGf,UAAU,mBAAmB,QAAQ,WAAW;GAClD,IACA,CACN;GACA,KAAK;IACH,oBAAoB,WAChB,aAAa,SAAS,QAAQ,IAC5B;KAAC;KAAgB;KAAc;KAAa;IAAS,IACrD;KAAC;KAAa;KAAW;KAAgB;IAAY,IACvD,aAAa,SACX,CAAC,OAAO,QAAQ,IAChB,aAAa,SAAS,QAAQ,IAC5B;KACE;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF,IACA;KACE;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF;IAER,kBAAkB;IAClB,2BAA2B;IAC3B,UAAU;IACV,GAAG;GACL,CAAC;GACD,GAAI,eAAe,iBAAiB,YAAY,iBAAiB,SAC7D,CACE,KAAK,EACH,MAAM,EAAE,OAAO,YAAY;IACzB,SAAS,SAAS,MAAM,QAAQ,GAAG,MAAM,UAAU,MAAM;GAC3D,EACF,CAAC,CACH,IACA,CACE,KAAK,EACH,MAAM,EAAE,YAAY;IAClB,SAAS,SAAS,MAAM,eAAe,OAAO;GAChD,EACF,CAAC,CACH;GAEJ,GAAI,SAAS,eACT,CAAC,MAAM;IAAE,SAAS;IAAc,SAAS;GAAG,CAAC,CAAC,IAC9C,CAAC;GAEL,GAAG,CAAC,KAAK,CAAC;EACZ;EAEA,IAAI,MAAM;GACR,MAAM,EAAE,GAAG,GAAG,WAAW,gBAAgB,aACvC,MAAM,gBAAgB,SAAS,SAAS;IACtC,UAAU;IACV;IACA,WAAW;GACb,CAAC;GAEH,QAAQ,aAAa,SAAS,SAAS;GAEvC,QAAQ,MAAM,OAAO,GAAG,EAAE;GAC1B,QAAQ,MAAM,MAAM,GAAG,EAAE;GACzB,QAAQ,MAAM,WAAW,GAAG;GAE5B,QAAQ,MAAM,aAAa,eAAe,MAAM,kBAC5C,WACA;GAEJ,IAAI,cAAc;IAGhB,MAAM,EAAE,GAAG,QAAQ,GAAG,WAAW,eAAe;IAGhD,MAAM,aAAkB;KACtB,KAAK;KACL,OAAO;KACP,QAAQ;KACR,MAAM;IACR,EAAE,UAAU,MAAM,GAAG,CAAC,CAAC;IAEvB,aAAa,MAAM,OAAO,UAAU,OAAO,GAAG,OAAO,MAAM;IAC3D,aAAa,MAAM,MAAM,UAAU,OAAO,GAAG,OAAO,MAAM;IAC1D,aAAa,MAAM,QAAQ;IAC3B,aAAa,MAAM,SAAS;IAC5B,aAAa,MAAM,cAAc,GAAG,CAAC,aAAa,cAAc,EAAE;GACpE;GAKA,IACE,KAAK,KAAK,YAAY,kBACtB,KAAK,KAAK,YAAY,YAEtB,KAAK,MAAM,aAAa,aAAa,SAAS;EAElD;CACF;CAEA,cAAoB;EAClB,IAAI,CAAC,KAAK,KAAK,aAAa,MAAM,GAAG;GACnC,KAAK,UAAU;GACf,KAAK,UAAU,KAAA;EACjB;CACF;CAEA,mBAAyB;EACvB,KAAK,UAAU;EACf,KAAK,UAAU,KAAA;CACjB;AACF"}
+{"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":";;;;;;;;;;;;AAyCA,IAAqB,qBAArB,MAAsE;;;;;CAkBpE,YAAY,MAAuB;+BAYL;GAC5B,KAAK,iBAAiB;EACxB;EAbE,KAAK,OAAO;EACZ,KAAK,cAAc,IAAI;CACzB;CAEA,MAAM,aAAa,UAAqC,KAAK,SAAS;EACpE,KAAK,UAAU;EACf,MAAM,EAAE,SAAS,WAAW;EAC5B,KAAK,UAAU;EACf,KAAK,UAAU,WAAW,SAAS,QAAQ,KAAK,eAAe;CACjE;CAMA,MAAM,mBAAmB;EACvB,MAAM,EACJ,cACA,WACA,OACA,SACA,QACA,cACA,YACA,MACA,qBACA,gBACA,mBACA,UACA,kBACE,KAAK;EAET,MAAM,YAAY,QAAQ,SAAS;EACnC,MAAM,SAAS,QAAQ,cAAc;EAErC,MAAM,UAAU,gBAAgB;EAEhC,IAAI,CAAC,SAAS;EAEd,IAAI;EACJ,QAAQ,WAAR;GACE,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF,KAAK;IACH,eAAe;IACf;GACF;IACE,eAAe;IACf;EACJ;EACA,MAAM,KAAK,iBAAiB,OAAO;EACnC,MAAM,QAAQ,QAAgB;GAC5B,MAAM,MAAM,WAAW,GAAG;GAC1B,OAAO,IAAI,KAAK,CAAC,CAAC,SAAS,KAAK,IAAI,MAAM,KAAK;EACjD;EACA,MAAM,WAAW,CAAC,WACb,KAAK,GAAG,iBAAiB,sBAAsB,CAAC,CAAC,KAAK,CAAC,KAAK,KAC7D;EAEJ,MAAM,aAAa;GACjB,OACE,CAAC,WACG;IACE,eAAe;IAGf,UAAU,mBAAmB,QAAQ,WAAW;GAClD,IACA,CACN;GACA,KAAK;IACH,oBAAoB,WAChB,aAAa,SAAS,QAAQ,IAC5B;KAAC;KAAgB;KAAc;KAAa;IAAS,IACrD;KAAC;KAAa;KAAW;KAAgB;IAAY,IACvD,aAAa,SACX,CAAC,OAAO,QAAQ,IAChB,aAAa,SAAS,QAAQ,IAC5B;KACE;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF,IACA;KACE;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF;IAER,kBAAkB;IAClB,2BAA2B;IAC3B,UAAU;IACV,GAAG;GACL,CAAC;GACD,GAAI,eAAe,iBAAiB,YAAY,iBAAiB,SAC7D,CACE,KAAK,EACH,MAAM,EAAE,OAAO,YAAY;IACzB,SAAS,SAAS,MAAM,QAAQ,GAAG,MAAM,UAAU,MAAM;GAC3D,EACF,CAAC,CACH,IACA,CACE,KAAK,EACH,MAAM,EAAE,YAAY;IAClB,SAAS,SAAS,MAAM,eAAe,OAAO;GAChD,EACF,CAAC,CACH;GAEJ,GAAI,SAAS,eACT,CAAC,MAAM;IAAE,SAAS;IAAc,SAAS;GAAG,CAAC,CAAC,IAC9C,CAAC;GAEL,GAAG,CAAC,KAAK,CAAC;EACZ;EAEA,IAAI,MAAM;GACR,MAAM,EAAE,GAAG,GAAG,WAAW,gBAAgB,aACvC,MAAM,gBAAgB,SAAS,SAAS;IACtC,UAAU;IACV;IACA,WAAW;GACb,CAAC;GAEH,QAAQ,aAAa,SAAS,SAAS;GAEvC,QAAQ,MAAM,OAAO,GAAG,EAAE;GAC1B,QAAQ,MAAM,MAAM,GAAG,EAAE;GACzB,QAAQ,MAAM,WAAW,GAAG;GAE5B,QAAQ,MAAM,aAAa,eAAe,MAAM,kBAC5C,WACA;GAEJ,IAAI,cAAc;IAGhB,MAAM,EAAE,GAAG,QAAQ,GAAG,WAAW,eAAe;IAEhD,MAAM,aAAa;KACjB,KAAK;KACL,OAAO;KACP,QAAQ;KACR,MAAM;IACR,EAAE,UAAU,MAAM,GAAG,CAAC,CAAC;IAEvB,aAAa,MAAM,OAAO,UAAU,OAAO,GAAG,OAAO,MAAM;IAC3D,aAAa,MAAM,MAAM,UAAU,OAAO,GAAG,OAAO,MAAM;IAC1D,aAAa,MAAM,QAAQ;IAC3B,aAAa,MAAM,SAAS;IAC5B,aAAa,MAAM,cAAc,GAAG,CAAC,aAAa,cAAc,EAAE;GACpE;GAKA,IACE,KAAK,KAAK,YAAY,kBACtB,KAAK,KAAK,YAAY,YAEtB,KAAK,MAAM,aAAa,aAAa,SAAS;EAElD;CACF;CAEA,cAAoB;EAClB,IAAI,CAAC,KAAK,KAAK,aAAa,MAAM,GAAG;GACnC,KAAK,UAAU;GACf,KAAK,UAAU,KAAA;EACjB;CACF;CAEA,mBAAyB;EACvB,KAAK,UAAU;EACf,KAAK,UAAU,KAAA;CACjB;AACF"}

package/es/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/es/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/es/globals/decorators/carbon-element.js

@@ -40,6 +40,14 @@ const standardCustomElement = (tagName, descriptor) => {
 * }
 * ```
 *
+* @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/es/globals/decorators/carbon-element.js.map

@@ -1 +1 @@
-{"version":3,"file":"carbon-element.js","names":[],"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  } catch {\n    // eslint-disable-next-line no-console\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      } catch {\n        // eslint-disable-next-line no-console\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"],"mappings":";;;;;;;;AA2CA,MAAM,uBAAuB,SAAiB,UAA8B;CAC1E,IAAI;EACF,eAAe,OAAO,SAAS,KAAiC;CAClE,QAAQ;EAEN,QAAQ,KAAK,2BAA2B,SAAS;CACnD;CAOA,OAAO;AACT;AAEA,MAAM,yBACJ,SACA,eACG;CACH,MAAM,EAAE,MAAM,aAAa;CAC3B,OAAO;EACL;EACA;EAEA,SAAS,OAAiC;GACxC,IAAI;IACF,eAAe,OAAO,SAAS,KAAK;GACtC,QAAQ;IAEN,QAAQ,KAAK,2BAA2B,SAAS;GACnD;EACF;CACF;AACF;;;;;;;;;;;;;;;;AAiBA,MAAa,iBACV,aACA,sBACC,OAAO,sBAAsB,aACzB,oBAAoB,SAAS,iBAAiB,IAC9C,sBAAsB,SAAS,iBAAoC"}
+{"version":3,"file":"carbon-element.js","names":[],"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  } catch {\n    // eslint-disable-next-line no-console\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      } catch {\n        // eslint-disable-next-line no-console\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 * @deprecated The `carbonElement` decorator is deprecated and will be removed in\n *   v3. In v3, `@carbon/web-components` moves to pure component\n *   classes (`static is = '${prefix}-name'`) with opt-in registration via\n *   `defineCustomElement`, and this self-registering decorator is removed. If you\n *   author your own custom elements with it, migrate to Lit's `customElement`\n *   (`import { customElement } from 'lit/decorators.js'`). See the v3 migration\n *   guide:\n *   https://github.com/carbon-design-system/carbon/blob/main/docs/guides/cwc-v3-migration.md#the-carbonelement-decorator-is-removed\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"],"mappings":";;;;;;;;AA2CA,MAAM,uBAAuB,SAAiB,UAA8B;CAC1E,IAAI;EACF,eAAe,OAAO,SAAS,KAAiC;CAClE,QAAQ;EAEN,QAAQ,KAAK,2BAA2B,SAAS;CACnD;CAOA,OAAO;AACT;AAEA,MAAM,yBACJ,SACA,eACG;CACH,MAAM,EAAE,MAAM,aAAa;CAC3B,OAAO;EACL;EACA;EAEA,SAAS,OAAiC;GACxC,IAAI;IACF,eAAe,OAAO,SAAS,KAAK;GACtC,QAAQ;IAEN,QAAQ,KAAK,2BAA2B,SAAS;GACnD;EACF;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAa,iBACV,aACA,sBACC,OAAO,sBAAsB,aACzB,oBAAoB,SAAS,iBAAiB,IAC9C,sBAAsB,SAAS,iBAAoC"}

package/es/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/es/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/es/globals/internal/collection-helpers.js

@@ -7,7 +7,7 @@
 
 //#region src/globals/internal/collection-helpers.ts
 /**
-* 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/globals/internal/collection-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection-helpers.js","names":[],"sources":["../../../src/globals/internal/collection-helpers.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 * @param a A DOM collection.\n * @param predicate The callback function.\n * @param [thisObject] The context object for the given callback function.\n * @returns A new array with all elements where `predicate` returns truthy.\n */\nexport const filter = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  predicate: (search: Node, index?: number) => boolean,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\n  thisObject?: any\n) => Array.prototype.filter.call(a, predicate, thisObject);\n\n/**\n * @param a A DOM collection.\n * @param predicate The callback function.\n * @param [thisObject] The context object for the given callback function.\n * @returns The index of the first item in the given collection where `predicate` returns `true`. `-1` if no such item is found.\n */\nexport const findIndex = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  predicate: (search: Node, index?: number) => boolean,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\n  thisObject?: any\n) => Array.prototype.findIndex.call(a, predicate, thisObject);\n\n/**\n * @param a A DOM collection.\n * @param predicate The callback function.\n * @param [thisObject] The context object for the given callback function.\n * @returns The first item in the given collection where `predicate` returns `true`. `null` if no such item is found.\n */\nexport const find = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  predicate: (search: Node, index?: number) => boolean,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\n  thisObject?: any\n) => Array.prototype.find.call(a, predicate, thisObject);\n\n/**\n * Walks through the given DOM collection and runs the given callback.\n *\n * @param a A DOM collection.\n * @param predicate The callback function.\n * @param [thisObject] The context object for the given callback function.\n */\nexport const forEach = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  predicate: (search: Element, index?: number) => void,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\n  thisObject?: any\n) => Array.prototype.forEach.call(a, predicate, thisObject);\n\n/**\n * @param a A DOM collection.\n * @param item An item in the DOM collection.\n * @returns The index of the first occurence of the given item in the given collection. `-1` if no such item is found.\n */\nexport const indexOf = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  item: Node\n) => Array.prototype.indexOf.call(a, item);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAaA,MAAa,UACX,GACA,WAEA,eACG,MAAM,UAAU,OAAO,KAAK,GAAG,WAAW,UAAU;;;;;;;AAQzD,MAAa,aACX,GACA,WAEA,eACG,MAAM,UAAU,UAAU,KAAK,GAAG,WAAW,UAAU;;;;;;;AAQ5D,MAAa,QACX,GACA,WAEA,eACG,MAAM,UAAU,KAAK,KAAK,GAAG,WAAW,UAAU;;;;;;;;AASvD,MAAa,WACX,GACA,WAEA,eACG,MAAM,UAAU,QAAQ,KAAK,GAAG,WAAW,UAAU;;;;;;AAO1D,MAAa,WACX,GACA,SACG,MAAM,UAAU,QAAQ,KAAK,GAAG,IAAI"}
+{"version":3,"file":"collection-helpers.js","names":[],"sources":["../../../src/globals/internal/collection-helpers.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 * @param a A DOM collection.\n * @param predicate The callback function.\n * @param [thisObject] The context object for the given callback function.\n * @returns A new array with all elements where `predicate` returns truthy.\n */\nexport const filter = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  predicate: (search: Node, index?: number) => boolean,\n  thisObject?: unknown\n) => Array.prototype.filter.call(a, predicate, thisObject);\n\n/**\n * @param a A DOM collection.\n * @param predicate The callback function.\n * @param [thisObject] The context object for the given callback function.\n * @returns The index of the first item in the given collection where `predicate` returns `true`. `-1` if no such item is found.\n */\nexport const findIndex = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  predicate: (search: Node, index?: number) => boolean,\n  thisObject?: unknown\n) => Array.prototype.findIndex.call(a, predicate, thisObject);\n\n/**\n * @param a A DOM collection.\n * @param predicate The callback function.\n * @param [thisObject] The context object for the given callback function.\n * @returns The first item in the given collection where `predicate` returns `true`. `null` if no such item is found.\n */\nexport const find = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  predicate: (search: Node, index?: number) => boolean,\n  thisObject?: unknown\n) => Array.prototype.find.call(a, predicate, thisObject);\n\n/**\n * Walks through the given DOM collection and runs the given callback.\n *\n * @param a A DOM collection.\n * @param predicate The callback function.\n * @param [thisObject] The context object for the given callback function.\n */\nexport const forEach = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  predicate: (search: Element, index?: number) => void,\n  thisObject?: unknown\n) => Array.prototype.forEach.call(a, predicate, thisObject);\n\n/**\n * @param a A DOM collection.\n * @param item An item in the DOM collection.\n * @returns The index of the first occurence of the given item in the given collection. `-1` if no such item is found.\n */\nexport const indexOf = (\n  a: NodeListOf<Node> | HTMLCollectionOf<Element>,\n  item: Node\n) => Array.prototype.indexOf.call(a, item);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAaA,MAAa,UACX,GACA,WACA,eACG,MAAM,UAAU,OAAO,KAAK,GAAG,WAAW,UAAU;;;;;;;AAQzD,MAAa,aACX,GACA,WACA,eACG,MAAM,UAAU,UAAU,KAAK,GAAG,WAAW,UAAU;;;;;;;AAQ5D,MAAa,QACX,GACA,WACA,eACG,MAAM,UAAU,KAAK,KAAK,GAAG,WAAW,UAAU;;;;;;;;AASvD,MAAa,WACX,GACA,WACA,eACG,MAAM,UAAU,QAAQ,KAAK,GAAG,WAAW,UAAU;;;;;;AAO1D,MAAa,WACX,GACA,SACG,MAAM,UAAU,QAAQ,KAAK,GAAG,IAAI"}

package/es/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/es/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/es/globals/internal/getSupportedLocale.js

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ */
+
+//#region src/globals/internal/getSupportedLocale.ts
+/**
+* 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`.
+*/
+function getSupportedLocale(locale, defaultLocale) {
+	try {
+		return Intl.NumberFormat.supportedLocalesOf(locale).length > 0 ? locale : defaultLocale;
+	} catch {
+		return defaultLocale;
+	}
+}
+//#endregion
+export { getSupportedLocale };
+
+//# sourceMappingURL=getSupportedLocale.js.map

package/es/globals/internal/getSupportedLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSupportedLocale.js","names":[],"sources":["../../../src/globals/internal/getSupportedLocale.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2025, 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 * Returns `locale` if it is supported by `Intl.NumberFormat`, otherwise\n * returns `defaultLocale`.\n */\nexport function getSupportedLocale(\n  locale: Intl.LocalesArgument,\n  defaultLocale: string\n): Intl.LocalesArgument {\n  try {\n    const supported = Intl.NumberFormat.supportedLocalesOf(\n      locale as string | string[]\n    );\n    return supported.length > 0 ? locale : defaultLocale;\n  } catch {\n    return defaultLocale;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAWA,SAAgB,mBACd,QACA,eACsB;CACtB,IAAI;EAIF,OAHkB,KAAK,aAAa,mBAClC,MAEa,CAAC,CAAC,SAAS,IAAI,SAAS;CACzC,QAAQ;EACN,OAAO;CACT;AACF"}

package/es/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/es/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/es/globals/mixins/on.js

@@ -7,15 +7,15 @@
 
 //#region src/globals/mixins/on.ts
 /**
-* 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.
 */
-function on(element, ...args) {
-	element.addEventListener(...args);
+function on(element, type, listener, options) {
+	element.addEventListener(type, listener, options);
 	return { release() {
-		element.removeEventListener(...args);
+		element.removeEventListener(type, listener, options);
 		return null;
 	} };
 }

package/es/globals/mixins/on.js.map

@@ -1 +1 @@
-{"version":3,"file":"on.js","names":[],"sources":["../../../src/globals/mixins/on.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2016, 2023\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// eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452\nexport default function on(element: any, ...args: any) {\n  element.addEventListener(...args);\n  return {\n    release() {\n      element.removeEventListener(...args);\n      return null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAQA,SAAwB,GAAG,SAAc,GAAG,MAAW;CACrD,QAAQ,iBAAiB,GAAG,IAAI;CAChC,OAAO,EACL,UAAU;EACR,QAAQ,oBAAoB,GAAG,IAAI;EACnC,OAAO;CACT,EACF;AACF"}
+{"version":3,"file":"on.js","names":[],"sources":["../../../src/globals/mixins/on.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2016, 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\nexport default function on<TEvent extends Event = Event>(\n  element: EventTarget,\n  type: string,\n  listener: EventListenerObject | ((event: TEvent) => void),\n  options?: boolean | AddEventListenerOptions\n) {\n  element.addEventListener(\n    type,\n    listener as EventListenerOrEventListenerObject,\n    options\n  );\n  return {\n    release() {\n      element.removeEventListener(\n        type,\n        listener as EventListenerOrEventListenerObject,\n        options\n      );\n      return null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAOA,SAAwB,GACtB,SACA,MACA,UACA,SACA;CACA,QAAQ,iBACN,MACA,UACA,OACF;CACA,OAAO,EACL,UAAU;EACR,QAAQ,oBACN,MACA,UACA,OACF;EACA,OAAO;CACT,EACF;AACF"}

package/es/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