@adobe/spectrum-wc-core 2.0.0-beta.2 → 2.0.0-beta.3

package/dist/components/action-group/ActionGroup.types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+export declare const ACTION_GROUP_VALID_SIZES: readonly ["xs", "s", "m", "l", "xl"];
+export declare const ACTION_GROUP_ORIENTATIONS: readonly ["horizontal", "vertical"];
+export declare const ACTION_GROUP_STATIC_COLORS: readonly ["white", "black"];
+export type ActionGroupSize = (typeof ACTION_GROUP_VALID_SIZES)[number];
+export type ActionGroupOrientation = (typeof ACTION_GROUP_ORIENTATIONS)[number];
+export type ActionGroupStaticColor = (typeof ACTION_GROUP_STATIC_COLORS)[number];

package/dist/components/action-group/ActionGroup.types.js

@@ -0,0 +1,12 @@
+//#region components/action-group/ActionGroup.types.ts
+var e = [
+	"xs",
+	"s",
+	"m",
+	"l",
+	"xl"
+], t = ["horizontal", "vertical"], n = ["white", "black"];
+//#endregion
+export { t as ACTION_GROUP_ORIENTATIONS, n as ACTION_GROUP_STATIC_COLORS, e as ACTION_GROUP_VALID_SIZES };
+
+//# sourceMappingURL=ActionGroup.types.js.map

package/dist/components/action-group/ActionGroup.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionGroup.types.js","names":[],"sources":["../../../components/action-group/ActionGroup.types.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport type { ElementSize } from '@adobe/spectrum-wc-core/mixins/index.js';\n\n// ──────────────────\n//     SHARED\n// ──────────────────\n\nexport const ACTION_GROUP_VALID_SIZES = [\n  'xs',\n  's',\n  'm',\n  'l',\n  'xl',\n] as const satisfies readonly ElementSize[];\n\nexport const ACTION_GROUP_ORIENTATIONS = ['horizontal', 'vertical'] as const;\n\nexport const ACTION_GROUP_STATIC_COLORS = ['white', 'black'] as const;\n\n// ──────────────────\n//     TYPES\n// ──────────────────\n\nexport type ActionGroupSize = (typeof ACTION_GROUP_VALID_SIZES)[number];\nexport type ActionGroupOrientation = (typeof ACTION_GROUP_ORIENTATIONS)[number];\nexport type ActionGroupStaticColor =\n  (typeof ACTION_GROUP_STATIC_COLORS)[number];\n"],"mappings":";AAkBA,IAAa,IAA2B;CACtC;CACA;CACA;CACA;CACA;CACD,EAEY,IAA4B,CAAC,cAAc,WAAW,EAEtD,IAA6B,CAAC,SAAS,QAAQ"}

package/dist/components/action-group/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+export * from './ActionGroup.base.js';
+export * from './ActionGroup.types.js';

package/dist/components/action-group/index.js

@@ -0,0 +1,3 @@
+import { ACTION_GROUP_ORIENTATIONS as e, ACTION_GROUP_STATIC_COLORS as t, ACTION_GROUP_VALID_SIZES as n } from "./ActionGroup.types.js";
+import { ActionGroupBase as r } from "./ActionGroup.base.js";
+export { e as ACTION_GROUP_ORIENTATIONS, t as ACTION_GROUP_STATIC_COLORS, n as ACTION_GROUP_VALID_SIZES, r as ActionGroupBase };

package/dist/components/alert-banner/AlertBanner.base.js

@@ -2,8 +2,9 @@ import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/he
 import { ALERT_BANNER_VALID_VARIANTS as t } from "./AlertBanner.types.js";
 import { property as n } from "lit/decorators.js";
 import { SpectrumElement as r } from "@adobe/spectrum-wc-core/element/index.js";
+import { validateEnum as i } from "@adobe/spectrum-wc-core/utils/index.js";
 //#region components/alert-banner/AlertBanner.base.ts
-var i = class extends r {
+var a = class extends r {
 	constructor(...e) {
 		super(...e), this.open = !1, this.dismissible = !1, this._variant = "";
 	}
@@ -13,12 +14,12 @@ var i = class extends r {
 	set variant(e) {
 		if (e === this.variant) return;
 		let n = this.variant;
-		if (this.isValidVariant(e)) this.setAttribute("variant", e), this._variant = e;
-		else {
-			var r;
-			this.removeAttribute("variant"), this._variant = "", (r = window.__swc) != null && r.DEBUG && window.__swc.warn(this, `<${this.localName}> element expects the "variant" attribute to be one of the following:`, "https://opensource.adobe.com/spectrum-web-components/components/alert-banner/#variants", { issues: [...t] });
-		}
-		this.requestUpdate("variant", n);
+		this.isValidVariant(e) ? (this.setAttribute("variant", e), this._variant = e) : (this.removeAttribute("variant"), this._variant = "", i(this, {
+			prop: "variant",
+			value: e,
+			valid: t,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-alert-banner--docs"
+		})), this.requestUpdate("variant", n);
 	}
 	get variant() {
 		return this._variant;
@@ -46,11 +47,11 @@ var i = class extends r {
 e([n({
 	type: Boolean,
 	reflect: !0
-})], i.prototype, "open", void 0), e([n({
+})], a.prototype, "open", void 0), e([n({
 	type: Boolean,
 	reflect: !0
-})], i.prototype, "dismissible", void 0), e([n({ type: String })], i.prototype, "variant", null);
+})], a.prototype, "dismissible", void 0), e([n({ type: String })], a.prototype, "variant", null);
 //#endregion
-export { i as AlertBannerBase };
+export { a as AlertBannerBase };
 
 //# sourceMappingURL=AlertBanner.base.js.map

package/dist/components/alert-banner/AlertBanner.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"AlertBanner.base.js","names":[],"sources":["../../../components/alert-banner/AlertBanner.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { CSSResultArray, PropertyValues, TemplateResult } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\n\nimport {\n  ALERT_BANNER_VALID_VARIANTS,\n  type AlertBannerVariant,\n} from './AlertBanner.types.js';\n\n/**\n * An alert banner shows pressing and high-signal messages, such as system alerts.\n * It is meant to be noticed and prompt users to take action.\n *\n * @slot - The main content of the alert banner.\n * @slot action - An optional action button for the alert banner.\n *\n * @fires close - Dispatched when the alert banner is dismissed. Cancelable.\n */\nexport abstract class AlertBannerBase extends SpectrumElement {\n  public static override get styles(): CSSResultArray {\n    return [];\n  }\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * Controls the display of the alert banner.\n   */\n  @property({ type: Boolean, reflect: true })\n  public open = false;\n\n  /**\n   * Whether to include an icon-only close button to dismiss the alert banner.\n   */\n  @property({ type: Boolean, reflect: true })\n  public dismissible = false;\n\n  /**\n   * The variant applies specific styling when set to `negative` or `info`;\n   * `variant` attribute is removed when it's passed an invalid variant.\n   */\n  @property({ type: String })\n  public set variant(variant: AlertBannerVariant) {\n    if (variant === this.variant) {\n      return;\n    }\n    const oldValue = this.variant;\n\n    if (this.isValidVariant(variant)) {\n      this.setAttribute('variant', variant);\n      this._variant = variant;\n    } else {\n      this.removeAttribute('variant');\n      this._variant = '';\n\n      if (window.__swc?.DEBUG) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> element expects the \"variant\" attribute to be one of the following:`,\n          'https://opensource.adobe.com/spectrum-web-components/components/alert-banner/#variants',\n          {\n            issues: [...ALERT_BANNER_VALID_VARIANTS],\n          }\n        );\n      }\n    }\n    this.requestUpdate('variant', oldValue);\n  }\n\n  public get variant(): AlertBannerVariant {\n    return this._variant;\n  }\n\n  private _variant: AlertBannerVariant = '';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected isValidVariant(variant: string): boolean {\n    return (ALERT_BANNER_VALID_VARIANTS as readonly string[]).includes(variant);\n  }\n\n  protected abstract renderIcon(variant: string): TemplateResult;\n\n  protected shouldClose(): void {\n    const applyDefault = this.dispatchEvent(\n      new CustomEvent('close', {\n        composed: true,\n        bubbles: true,\n        cancelable: true,\n      })\n    );\n    if (applyDefault) {\n      this.close();\n    }\n  }\n\n  public close(): void {\n    this.open = false;\n  }\n\n  protected handleKeydown(event: KeyboardEvent): void {\n    if (event.code === 'Escape' && this.dismissible) {\n      this.shouldClose();\n    }\n  }\n\n  protected override updated(changes: PropertyValues): void {\n    super.updated(changes);\n\n    if (changes.has('open')) {\n      if (this.open) {\n        this.addEventListener('keydown', this.handleKeydown);\n      } else {\n        this.removeEventListener('keydown', this.handleKeydown);\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AA8BA,IAAsB,IAAtB,cAA8C,EAAgB;;2BAa9C,uBAMO,oBAsCkB;;CAxDvC,WAA2B,SAAyB;AAClD,SAAO,EAAE;;CAuBX,IACW,QAAQ,GAA6B;AAC9C,MAAI,MAAY,KAAK,QACnB;EAEF,IAAM,IAAW,KAAK;AAEtB,MAAI,KAAK,eAAe,EAAQ,CAE9B,CADA,KAAK,aAAa,WAAW,EAAQ,EACrC,KAAK,WAAW;OACX;;AAIL,GAHA,KAAK,gBAAgB,UAAU,EAC/B,KAAK,WAAW,KAEhB,IAAI,OAAO,UAAA,QAAA,EAAO,SAChB,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,wEACnB,0FACA,EACE,QAAQ,CAAC,GAAG,EAA4B,EACzC,CACF;;AAGL,OAAK,cAAc,WAAW,EAAS;;CAGzC,IAAW,UAA8B;AACvC,SAAO,KAAK;;CASd,eAAyB,GAA0B;AACjD,SAAQ,EAAkD,SAAS,EAAQ;;CAK7E,cAA8B;AAQ5B,EAPqB,KAAK,cACxB,IAAI,YAAY,SAAS;GACvB,UAAU;GACV,SAAS;GACT,YAAY;GACb,CAAC,CACH,IAEC,KAAK,OAAO;;CAIhB,QAAqB;AACnB,OAAK,OAAO;;CAGd,cAAwB,GAA4B;AAClD,EAAI,EAAM,SAAS,YAAY,KAAK,eAClC,KAAK,aAAa;;CAItB,QAA2B,GAA+B;AAGxD,EAFA,MAAM,QAAQ,EAAQ,EAElB,EAAQ,IAAI,OAAO,KACjB,KAAK,OACP,KAAK,iBAAiB,WAAW,KAAK,cAAc,GAEpD,KAAK,oBAAoB,WAAW,KAAK,cAAc;;;GAvF5D,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,QAAA,KAAA,EAAA,KAM1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,eAAA,KAAA,EAAA,KAO1C,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA"}
+{"version":3,"file":"AlertBanner.base.js","names":[],"sources":["../../../components/alert-banner/AlertBanner.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { CSSResultArray, PropertyValues, TemplateResult } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { validateEnum } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport {\n  ALERT_BANNER_VALID_VARIANTS,\n  type AlertBannerVariant,\n} from './AlertBanner.types.js';\n\n/**\n * An alert banner shows pressing and high-signal messages, such as system alerts.\n * It is meant to be noticed and prompt users to take action.\n *\n * @slot - The main content of the alert banner.\n * @slot action - An optional action button for the alert banner.\n *\n * @fires close - Dispatched when the alert banner is dismissed. Cancelable.\n */\nexport abstract class AlertBannerBase extends SpectrumElement {\n  public static override get styles(): CSSResultArray {\n    return [];\n  }\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * Controls the display of the alert banner.\n   */\n  @property({ type: Boolean, reflect: true })\n  public open = false;\n\n  /**\n   * Whether to include an icon-only close button to dismiss the alert banner.\n   */\n  @property({ type: Boolean, reflect: true })\n  public dismissible = false;\n\n  /**\n   * The variant applies specific styling when set to `negative` or `info`;\n   * `variant` attribute is removed when it's passed an invalid variant.\n   */\n  @property({ type: String })\n  public set variant(variant: AlertBannerVariant) {\n    if (variant === this.variant) {\n      return;\n    }\n    const oldValue = this.variant;\n\n    if (this.isValidVariant(variant)) {\n      this.setAttribute('variant', variant);\n      this._variant = variant;\n    } else {\n      this.removeAttribute('variant');\n      this._variant = '';\n\n      validateEnum(this, {\n        prop: 'variant',\n        value: variant,\n        valid: ALERT_BANNER_VALID_VARIANTS,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-alert-banner--docs',\n      });\n    }\n    this.requestUpdate('variant', oldValue);\n  }\n\n  public get variant(): AlertBannerVariant {\n    return this._variant;\n  }\n\n  private _variant: AlertBannerVariant = '';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected isValidVariant(variant: string): boolean {\n    return (ALERT_BANNER_VALID_VARIANTS as readonly string[]).includes(variant);\n  }\n\n  protected abstract renderIcon(variant: string): TemplateResult;\n\n  protected shouldClose(): void {\n    const applyDefault = this.dispatchEvent(\n      new CustomEvent('close', {\n        composed: true,\n        bubbles: true,\n        cancelable: true,\n      })\n    );\n    if (applyDefault) {\n      this.close();\n    }\n  }\n\n  public close(): void {\n    this.open = false;\n  }\n\n  protected handleKeydown(event: KeyboardEvent): void {\n    if (event.code === 'Escape' && this.dismissible) {\n      this.shouldClose();\n    }\n  }\n\n  protected override updated(changes: PropertyValues): void {\n    super.updated(changes);\n\n    if (changes.has('open')) {\n      if (this.open) {\n        this.addEventListener('keydown', this.handleKeydown);\n      } else {\n        this.removeEventListener('keydown', this.handleKeydown);\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;AA+BA,IAAsB,IAAtB,cAA8C,EAAgB;;2BAa9C,uBAMO,oBAkCkB;;CApDvC,WAA2B,SAAyB;AAClD,SAAO,EAAE;;CAuBX,IACW,QAAQ,GAA6B;AAC9C,MAAI,MAAY,KAAK,QACnB;EAEF,IAAM,IAAW,KAAK;AAgBtB,EAdI,KAAK,eAAe,EAAQ,IAC9B,KAAK,aAAa,WAAW,EAAQ,EACrC,KAAK,WAAW,MAEhB,KAAK,gBAAgB,UAAU,EAC/B,KAAK,WAAW,IAEhB,EAAa,MAAM;GACjB,MAAM;GACN,OAAO;GACP,OAAO;GACP,KAAK;GACN,CAAC,GAEJ,KAAK,cAAc,WAAW,EAAS;;CAGzC,IAAW,UAA8B;AACvC,SAAO,KAAK;;CASd,eAAyB,GAA0B;AACjD,SAAQ,EAAkD,SAAS,EAAQ;;CAK7E,cAA8B;AAQ5B,EAPqB,KAAK,cACxB,IAAI,YAAY,SAAS;GACvB,UAAU;GACV,SAAS;GACT,YAAY;GACb,CAAC,CACH,IAEC,KAAK,OAAO;;CAIhB,QAAqB;AACnB,OAAK,OAAO;;CAGd,cAAwB,GAA4B;AAClD,EAAI,EAAM,SAAS,YAAY,KAAK,eAClC,KAAK,aAAa;;CAItB,QAA2B,GAA+B;AAGxD,EAFA,MAAM,QAAQ,EAAQ,EAElB,EAAQ,IAAI,OAAO,KACjB,KAAK,OACP,KAAK,iBAAiB,WAAW,KAAK,cAAc,GAEpD,KAAK,oBAAoB,WAAW,KAAK,cAAc;;;GAnF5D,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,QAAA,KAAA,EAAA,KAM1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,eAAA,KAAA,EAAA,KAO1C,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA"}

package/dist/components/asset/Asset.base.d.ts

@@ -18,5 +18,5 @@ export declare abstract class AssetBase extends SpectrumElement {
      * Accessible label for the asset’s file or folder variant.
      */
     label: string;
-    protected updated(changes: PropertyValues): void;
+    protected update(changes: PropertyValues): void;
 }

package/dist/components/asset/Asset.base.js

@@ -2,24 +2,30 @@ import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/he
 import { ASSET_VARIANTS as t } from "./Asset.types.js";
 import { property as n } from "lit/decorators.js";
 import { SpectrumElement as r } from "@adobe/spectrum-wc-core/element/index.js";
+import { validateEnum as i } from "@adobe/spectrum-wc-core/utils/index.js";
 //#region components/asset/Asset.base.ts
-var i, a = class extends r {
+var a, o = class extends r {
 	constructor(...e) {
 		super(...e), this.label = "";
 	}
-	updated(e) {
-		var t;
-		if (super.updated(e), (t = window.__swc) != null && t.DEBUG) {
+	update(e) {
+		if (this.variant !== void 0) {
 			let e = this.constructor;
-			this.variant !== void 0 && !e.VARIANTS.includes(this.variant) && window.__swc.warn(this, `<${this.localName}> element expects the "variant" attribute to be one of the following:`, "https://opensource.adobe.com/spectrum-web-components/components/asset/", { issues: [...e.VARIANTS] });
+			i(this, {
+				prop: "variant",
+				value: this.variant,
+				valid: e.VARIANTS,
+				url: "https://spectrum-web-components.adobe.com/?path=/docs/components-asset--docs"
+			});
 		}
+		super.update(e);
 	}
 };
-i = a, i.VARIANTS = t, e([n({
+a = o, a.VARIANTS = t, e([n({
 	type: String,
 	reflect: !0
-})], a.prototype, "variant", void 0), e([n({ type: String })], a.prototype, "label", void 0);
+})], o.prototype, "variant", void 0), e([n({ type: String })], o.prototype, "label", void 0);
 //#endregion
-export { a as AssetBase };
+export { o as AssetBase };
 
 //# sourceMappingURL=Asset.base.js.map

package/dist/components/asset/Asset.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"Asset.base.js","names":[],"sources":["../../../components/asset/Asset.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\n\nimport { ASSET_VARIANTS, type AssetVariant } from './Asset.types.js';\n\nexport abstract class AssetBase extends SpectrumElement {\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of all valid variants for the asset.\n   *\n   * This is an actual internal property, intended not for customer use\n   */\n  static readonly VARIANTS: readonly AssetVariant[] = ASSET_VARIANTS;\n\n  // ─────────────────\n  //     SHARED API\n  // ─────────────────\n\n  /**\n   * The variant of the asset. When not provided, slot content is rendered (e.g., an image).\n   */\n  @property({ type: String, reflect: true })\n  public variant: AssetVariant | undefined;\n\n  /**\n   * Accessible label for the asset’s file or folder variant.\n   */\n  @property({ type: String })\n  public label = '';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override updated(changes: PropertyValues): void {\n    super.updated(changes);\n    if (window.__swc?.DEBUG) {\n      const constructor = this.constructor as typeof AssetBase;\n      if (\n        typeof this.variant !== 'undefined' &&\n        !constructor.VARIANTS.includes(this.variant)\n      ) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> element expects the \"variant\" attribute to be one of the following:`,\n          'https://opensource.adobe.com/spectrum-web-components/components/asset/',\n          {\n            issues: [...constructor.VARIANTS],\n          }\n        );\n      }\n    }\n  }\n}\n"],"mappings":";;;;;OAmBsB,IAAtB,cAAwC,EAAgB;;4BA4BvC;;CAMf,QAA2B,GAA+B;;AAExD,MADA,MAAM,QAAQ,EAAQ,GACtB,IAAI,OAAO,UAAA,QAAA,EAAO,OAAO;GACvB,IAAM,IAAc,KAAK;AACzB,GACS,KAAK,YAAY,UACxB,CAAC,EAAY,SAAS,SAAS,KAAK,QAAQ,IAE5C,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,wEACnB,0EACA,EACE,QAAQ,CAAC,GAAG,EAAY,SAAS,EAClC,CACF;;;;oBArC6C,MASnD,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA,KAMzC,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA"}
+{"version":3,"file":"Asset.base.js","names":[],"sources":["../../../components/asset/Asset.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { validateEnum } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport { ASSET_VARIANTS, type AssetVariant } from './Asset.types.js';\n\nexport abstract class AssetBase extends SpectrumElement {\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of all valid variants for the asset.\n   *\n   * This is an actual internal property, intended not for customer use\n   */\n  static readonly VARIANTS: readonly AssetVariant[] = ASSET_VARIANTS;\n\n  // ─────────────────\n  //     SHARED API\n  // ─────────────────\n\n  /**\n   * The variant of the asset. When not provided, slot content is rendered (e.g., an image).\n   */\n  @property({ type: String, reflect: true })\n  public variant: AssetVariant | undefined;\n\n  /**\n   * Accessible label for the asset’s file or folder variant.\n   */\n  @property({ type: String })\n  public label = '';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override update(changes: PropertyValues): void {\n    if (typeof this.variant !== 'undefined') {\n      const constructor = this.constructor as typeof AssetBase;\n      validateEnum(this, {\n        prop: 'variant',\n        value: this.variant,\n        valid: constructor.VARIANTS,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-asset--docs',\n      });\n    }\n    super.update(changes);\n  }\n}\n"],"mappings":";;;;;;OAoBsB,IAAtB,cAAwC,EAAgB;;4BA4BvC;;CAMf,OAA0B,GAA+B;AACvD,MAAW,KAAK,YAAY,QAAa;GACvC,IAAM,IAAc,KAAK;AACzB,KAAa,MAAM;IACjB,MAAM;IACN,OAAO,KAAK;IACZ,OAAO,EAAY;IACnB,KAAK;IACN,CAAC;;AAEJ,QAAM,OAAO,EAAQ;;;oBAhC6B,MASnD,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA,KAMzC,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA"}

package/dist/components/avatar/Avatar.base.js

@@ -2,8 +2,9 @@ import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/he
 import { AVATAR_VALID_SIZES as t } from "./Avatar.types.js";
 import { property as n } from "lit/decorators.js";
 import { SpectrumElement as r } from "@adobe/spectrum-wc-core/element/index.js";
+import { warnIf as i } from "@adobe/spectrum-wc-core/utils/index.js";
 //#region components/avatar/Avatar.base.ts
-var i, a = class extends r {
+var a, o = class extends r {
 	constructor(...e) {
 		super(...e), this.src = "", this._size = 500, this.outline = !1, this.disabled = !1, this.decorative = !1;
 	}
@@ -11,46 +12,41 @@ var i, a = class extends r {
 		return this._size;
 	}
 	set size(e) {
-		let n = t.includes(Number(e)) ? Number(e) : 500;
-		if (this._size === n) return;
-		let r = this._size;
-		this._size = n, this.requestUpdate("size", r);
+		let n = t.includes(Number(e)), r = n ? Number(e) : 500;
+		if (i(this, !n, `<${this.localName}> expects "size" to be one of: ${t.join(", ")}. Received "${e}".`, "https://spectrum-web-components.adobe.com/?path=/docs/components-avatar--docs", { issues: [`size="${e}"`] }), this._size === r) return;
+		let a = this._size;
+		this._size = r, this.requestUpdate("size", a);
 	}
 	firstUpdated(e) {
-		var t;
-		super.firstUpdated(e), this.hasAttribute("size") || this.setAttribute("size", String(this.size)), this._syncAriaHidden(), (t = window.__swc) != null && t.DEBUG && this._warnMissingAlt();
+		super.firstUpdated(e), this.hasAttribute("size") || this.setAttribute("size", String(this.size)), this._syncAriaHidden(), this._warnMissingAlt();
 	}
 	updated(e) {
-		var t;
-		super.updated(e), e.has("decorative") && this._syncAriaHidden(), e.has("alt") && (t = window.__swc) != null && t.DEBUG && this._warnMissingAlt();
+		super.updated(e), e.has("decorative") && this._syncAriaHidden(), e.has("alt") && this._warnMissingAlt();
 	}
 	_syncAriaHidden() {
 		this.decorative ? this.setAttribute("aria-hidden", "true") : this.removeAttribute("aria-hidden");
 	}
 	_warnMissingAlt() {
-		if (this.alt === void 0 && !this.decorative) {
-			var e;
-			(e = window.__swc) == null || e.warn(this, `<${this.localName}> is missing an \`alt\` attribute. Provide a text description or pass \`alt=""\` and mark it as \`decorative\`.`, "https://opensource.adobe.com/spectrum-web-components/components/avatar/#accessibility", {
-				type: "accessibility",
-				issues: ["Provide an `alt` attribute with meaningful alternative text, or", "Set `alt=\"\"` and mark the image as `decorative` (hidden from screen readers)."]
-			});
-		}
+		i(this, this.alt === void 0 && !this.decorative, `<${this.localName}> is missing an \`alt\` attribute. Provide a text description or pass \`alt=""\` and mark it as \`decorative\`.`, "https://spectrum-web-components.adobe.com/?path=/docs/components-avatar--docs", {
+			type: "accessibility",
+			issues: ["Provide an `alt` attribute with meaningful alternative text, or", "Set `alt=\"\"` and mark the image as `decorative` (hidden from screen readers)."]
+		});
 	}
 };
-i = a, i.VALID_SIZES = t, e([n({ type: String })], a.prototype, "src", void 0), e([n({ type: String })], a.prototype, "alt", void 0), e([n({
+a = o, a.VALID_SIZES = t, e([n({ type: String })], o.prototype, "src", void 0), e([n({ type: String })], o.prototype, "alt", void 0), e([n({
 	type: Number,
 	reflect: !0
-})], a.prototype, "size", null), e([n({
+})], o.prototype, "size", null), e([n({
 	type: Boolean,
 	reflect: !0
-})], a.prototype, "outline", void 0), e([n({
+})], o.prototype, "outline", void 0), e([n({
 	type: Boolean,
 	reflect: !0
-})], a.prototype, "disabled", void 0), e([n({
+})], o.prototype, "disabled", void 0), e([n({
 	type: Boolean,
 	reflect: !0
-})], a.prototype, "decorative", void 0);
+})], o.prototype, "decorative", void 0);
 //#endregion
-export { a as AvatarBase };
+export { o as AvatarBase };
 
 //# sourceMappingURL=Avatar.base.js.map

package/dist/components/avatar/Avatar.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.base.js","names":[],"sources":["../../../components/avatar/Avatar.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\n\nimport {\n  AVATAR_DEFAULT_SIZE,\n  AVATAR_VALID_SIZES,\n  type AvatarSize,\n} from './Avatar.types.js';\n\n/**\n * Base class for the avatar component.\n *\n * Provides the core API for displaying a circular profile image. Concrete\n * classes supply the stylesheet and render template.\n */\nexport abstract class AvatarBase extends SpectrumElement {\n  // ─────────────────────────\n  //     STATIC\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * The set of valid numeric size values for the avatar.\n   *\n   * This is an internal property not intended for consumer use, but used in\n   * internal validation logic, stories, and tests to keep them in sync with\n   * the canonical type definition in `Avatar.types.ts`.\n   */\n  static readonly VALID_SIZES: readonly AvatarSize[] = AVATAR_VALID_SIZES;\n\n  // ──────────────────\n  //     CORE API\n  // ──────────────────\n\n  /**\n   * URL of the profile image to display.\n   */\n  @property({ type: String })\n  public src = '';\n\n  /**\n   * Text description of the avatar image.\n   */\n  @property({ type: String })\n  public alt: string | undefined;\n\n  // ───────────────────\n  //     SIZE API\n  // ───────────────────\n\n  /**\n   * The size of the avatar. Invalid values fall back to the default (500).\n   *\n   * @default 500\n   */\n  @property({ type: Number, reflect: true })\n  public get size(): AvatarSize {\n    return this._size;\n  }\n\n  public set size(value: AvatarSize) {\n    const validSize = (AVATAR_VALID_SIZES as readonly number[]).includes(\n      Number(value)\n    )\n      ? (Number(value) as AvatarSize)\n      : AVATAR_DEFAULT_SIZE;\n\n    if (this._size === validSize) {\n      return;\n    }\n\n    const oldSize = this._size;\n    this._size = validSize;\n    this.requestUpdate('size', oldSize);\n  }\n\n  private _size: AvatarSize = AVATAR_DEFAULT_SIZE;\n\n  // ───────────────────────\n  //     VISUAL API\n  // ───────────────────────\n\n  /**\n   * Renders a visual outline around the avatar image.\n   */\n  @property({ type: Boolean, reflect: true })\n  public outline = false;\n\n  /**\n   * Renders the avatar at reduced opacity, indicating the entity is inactive or unavailable.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled = false;\n\n  // ───────────────────────────\n  //     ACCESSIBILITY API\n  // ───────────────────────────\n\n  /**\n   * Marks the avatar as decorative, hiding it from assistive technology.\n   */\n  @property({ type: Boolean, reflect: true })\n  public decorative = false;\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override firstUpdated(changes: PropertyValues): void {\n    super.firstUpdated(changes);\n    if (!this.hasAttribute('size')) {\n      this.setAttribute('size', String(this.size));\n    }\n    this._syncAriaHidden();\n    if (window.__swc?.DEBUG) {\n      this._warnMissingAlt();\n    }\n  }\n\n  protected override updated(changes: PropertyValues): void {\n    super.updated(changes);\n    if (changes.has('decorative')) {\n      this._syncAriaHidden();\n    }\n    if (changes.has('alt') && window.__swc?.DEBUG) {\n      this._warnMissingAlt();\n    }\n  }\n\n  private _syncAriaHidden(): void {\n    if (this.decorative) {\n      this.setAttribute('aria-hidden', 'true');\n    } else {\n      this.removeAttribute('aria-hidden');\n    }\n  }\n\n  private _warnMissingAlt(): void {\n    if (this.alt === undefined && !this.decorative) {\n      window.__swc?.warn(\n        this,\n        `<${this.localName}> is missing an \\`alt\\` attribute. Provide a text description or pass \\`alt=\"\"\\` and mark it as \\`decorative\\`.`,\n        'https://opensource.adobe.com/spectrum-web-components/components/avatar/#accessibility',\n        {\n          type: 'accessibility',\n          issues: [\n            'Provide an `alt` attribute with meaningful alternative text, or',\n            'Set `alt=\"\"` and mark the image as `decorative` (hidden from screen readers).',\n          ],\n        }\n      );\n    }\n  }\n}\n"],"mappings":";;;;;OA4BsB,IAAtB,cAAyC,EAAgB;;0BAwB1C,qCAgDI,oBAMC,sBAUE;;CA/CpB,IACW,OAAmB;AAC5B,SAAO,KAAK;;CAGd,IAAW,KAAK,GAAmB;EACjC,IAAM,IAAa,EAAyC,SAC1D,OAAO,EAAM,CACd,GACI,OAAO,EAAM,GAAA;AAGlB,MAAI,KAAK,UAAU,EACjB;EAGF,IAAM,IAAU,KAAK;AAErB,EADA,KAAK,QAAQ,GACb,KAAK,cAAc,QAAQ,EAAQ;;CAmCrC,aAAgC,GAA+B;;AAM7D,EALA,MAAM,aAAa,EAAQ,EACtB,KAAK,aAAa,OAAO,IAC5B,KAAK,aAAa,QAAQ,OAAO,KAAK,KAAK,CAAC,EAE9C,KAAK,iBAAiB,GACtB,IAAI,OAAO,UAAA,QAAA,EAAO,SAChB,KAAK,iBAAiB;;CAI1B,QAA2B,GAA+B;;AAKxD,EAJA,MAAM,QAAQ,EAAQ,EAClB,EAAQ,IAAI,aAAa,IAC3B,KAAK,iBAAiB,EAEpB,EAAQ,IAAI,MAAM,KAAA,IAAI,OAAO,UAAA,QAAA,EAAO,SACtC,KAAK,iBAAiB;;CAI1B,kBAAgC;AAC9B,EAAI,KAAK,aACP,KAAK,aAAa,eAAe,OAAO,GAExC,KAAK,gBAAgB,cAAc;;CAIvC,kBAAgC;AAC9B,MAAI,KAAK,QAAQ,KAAA,KAAa,CAAC,KAAK,YAAY;;AAC9C,IAAA,IAAA,OAAO,UAAA,QAAA,EAAO,KACZ,MACA,IAAI,KAAK,UAAU,kHACnB,yFACA;IACE,MAAM;IACN,QAAQ,CACN,mEACA,kFACD;IACF,CACF;;;;uBA1HgD,MASpD,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,OAAA,KAAA,EAAA,KAM1B,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,OAAA,KAAA,EAAA,KAY1B,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,QAAA,KAAA,KA8BzC,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA,KAM1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAU1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,cAAA,KAAA,EAAA"}
+{"version":3,"file":"Avatar.base.js","names":[],"sources":["../../../components/avatar/Avatar.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { warnIf } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport {\n  AVATAR_DEFAULT_SIZE,\n  AVATAR_VALID_SIZES,\n  type AvatarSize,\n} from './Avatar.types.js';\n\n/**\n * Base class for the avatar component.\n *\n * Provides the core API for displaying a circular profile image. Concrete\n * classes supply the stylesheet and render template.\n */\nexport abstract class AvatarBase extends SpectrumElement {\n  // ─────────────────────────\n  //     STATIC\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * The set of valid numeric size values for the avatar.\n   *\n   * This is an internal property not intended for consumer use, but used in\n   * internal validation logic, stories, and tests to keep them in sync with\n   * the canonical type definition in `Avatar.types.ts`.\n   */\n  static readonly VALID_SIZES: readonly AvatarSize[] = AVATAR_VALID_SIZES;\n\n  // ──────────────────\n  //     CORE API\n  // ──────────────────\n\n  /**\n   * URL of the profile image to display.\n   */\n  @property({ type: String })\n  public src = '';\n\n  /**\n   * Text description of the avatar image.\n   */\n  @property({ type: String })\n  public alt: string | undefined;\n\n  // ───────────────────\n  //     SIZE API\n  // ───────────────────\n\n  /**\n   * The size of the avatar. Invalid values fall back to the default (500).\n   *\n   * @default 500\n   */\n  @property({ type: Number, reflect: true })\n  public get size(): AvatarSize {\n    return this._size;\n  }\n\n  public set size(value: AvatarSize) {\n    const isValid = (AVATAR_VALID_SIZES as readonly number[]).includes(\n      Number(value)\n    );\n    const validSize = isValid\n      ? (Number(value) as AvatarSize)\n      : AVATAR_DEFAULT_SIZE;\n\n    warnIf(\n      this,\n      !isValid,\n      `<${this.localName}> expects \"size\" to be one of: ${AVATAR_VALID_SIZES.join(', ')}. Received \"${value}\".`,\n      'https://spectrum-web-components.adobe.com/?path=/docs/components-avatar--docs',\n      { issues: [`size=\"${value}\"`] }\n    );\n\n    if (this._size === validSize) {\n      return;\n    }\n\n    const oldSize = this._size;\n    this._size = validSize;\n    this.requestUpdate('size', oldSize);\n  }\n\n  private _size: AvatarSize = AVATAR_DEFAULT_SIZE;\n\n  // ───────────────────────\n  //     VISUAL API\n  // ───────────────────────\n\n  /**\n   * Renders a visual outline around the avatar image.\n   */\n  @property({ type: Boolean, reflect: true })\n  public outline = false;\n\n  /**\n   * Renders the avatar at reduced opacity, indicating the entity is inactive or unavailable.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled = false;\n\n  // ───────────────────────────\n  //     ACCESSIBILITY API\n  // ───────────────────────────\n\n  /**\n   * Marks the avatar as decorative, hiding it from assistive technology.\n   */\n  @property({ type: Boolean, reflect: true })\n  public decorative = false;\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override firstUpdated(changes: PropertyValues): void {\n    super.firstUpdated(changes);\n    if (!this.hasAttribute('size')) {\n      this.setAttribute('size', String(this.size));\n    }\n    this._syncAriaHidden();\n    this._warnMissingAlt();\n  }\n\n  protected override updated(changes: PropertyValues): void {\n    super.updated(changes);\n    if (changes.has('decorative')) {\n      this._syncAriaHidden();\n    }\n    if (changes.has('alt')) {\n      this._warnMissingAlt();\n    }\n  }\n\n  private _syncAriaHidden(): void {\n    if (this.decorative) {\n      this.setAttribute('aria-hidden', 'true');\n    } else {\n      this.removeAttribute('aria-hidden');\n    }\n  }\n\n  private _warnMissingAlt(): void {\n    warnIf(\n      this,\n      this.alt === undefined && !this.decorative,\n      `<${this.localName}> is missing an \\`alt\\` attribute. Provide a text description or pass \\`alt=\"\"\\` and mark it as \\`decorative\\`.`,\n      'https://spectrum-web-components.adobe.com/?path=/docs/components-avatar--docs',\n      {\n        type: 'accessibility',\n        issues: [\n          'Provide an `alt` attribute with meaningful alternative text, or',\n          'Set `alt=\"\"` and mark the image as `decorative` (hidden from screen readers).',\n        ],\n      }\n    );\n  }\n}\n"],"mappings":";;;;;;OA6BsB,IAAtB,cAAyC,EAAgB;;0BAwB1C,qCAyDI,oBAMC,sBAUE;;CAxDpB,IACW,OAAmB;AAC5B,SAAO,KAAK;;CAGd,IAAW,KAAK,GAAmB;EACjC,IAAM,IAAW,EAAyC,SACxD,OAAO,EAAM,CACd,EACK,IAAY,IACb,OAAO,EAAM,GAAA;AAWlB,MARA,EACE,MACA,CAAC,GACD,IAAI,KAAK,UAAU,iCAAiC,EAAmB,KAAK,KAAK,CAAC,cAAc,EAAM,KACtG,iFACA,EAAE,QAAQ,CAAC,SAAS,EAAM,GAAG,EAAE,CAChC,EAEG,KAAK,UAAU,EACjB;EAGF,IAAM,IAAU,KAAK;AAErB,EADA,KAAK,QAAQ,GACb,KAAK,cAAc,QAAQ,EAAQ;;CAmCrC,aAAgC,GAA+B;AAM7D,EALA,MAAM,aAAa,EAAQ,EACtB,KAAK,aAAa,OAAO,IAC5B,KAAK,aAAa,QAAQ,OAAO,KAAK,KAAK,CAAC,EAE9C,KAAK,iBAAiB,EACtB,KAAK,iBAAiB;;CAGxB,QAA2B,GAA+B;AAKxD,EAJA,MAAM,QAAQ,EAAQ,EAClB,EAAQ,IAAI,aAAa,IAC3B,KAAK,iBAAiB,EAEpB,EAAQ,IAAI,MAAM,IACpB,KAAK,iBAAiB;;CAI1B,kBAAgC;AAC9B,EAAI,KAAK,aACP,KAAK,aAAa,eAAe,OAAO,GAExC,KAAK,gBAAgB,cAAc;;CAIvC,kBAAgC;AAC9B,IACE,MACA,KAAK,QAAQ,KAAA,KAAa,CAAC,KAAK,YAChC,IAAI,KAAK,UAAU,kHACnB,iFACA;GACE,MAAM;GACN,QAAQ,CACN,mEACA,kFACD;GACF,CACF;;;uBAjIkD,MASpD,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,OAAA,KAAA,EAAA,KAM1B,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,OAAA,KAAA,EAAA,KAY1B,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,QAAA,KAAA,KAuCzC,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA,KAM1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAU1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,cAAA,KAAA,EAAA"}

package/dist/components/badge/Badge.base.d.ts

@@ -1,13 +1,9 @@
 import { PropertyValues } from 'lit';
+import { SlotPresenceController } from '../../controllers/slot-presence-controller/index.js';
+import { SlotTextController } from '../../controllers/slot-text-controller/index.js';
 import { SpectrumElement } from '../../element/index.js';
 import { BadgeSize, BadgeVariant, FixedValues } from './Badge.types.js';
 declare const BadgeBase_base: typeof SpectrumElement & {
-    new (...args: any[]): import('../../mixins/observe-slot-presence.js').SlotPresenceObservingInterface;
-    prototype: import('../../mixins/observe-slot-presence.js').SlotPresenceObservingInterface;
-} & {
-    new (...args: any[]): import('../../mixins/observe-slot-text.js').SlotTextObservingInterface;
-    prototype: import('../../mixins/observe-slot-text.js').SlotTextObservingInterface;
-} & {
     new (...args: any[]): import('../../mixins/index.js').SizedElementInterface;
     prototype: import('../../mixins/index.js').SizedElementInterface;
 } & import('../../mixins/index.js').SizedElementConstructor;
@@ -19,8 +15,6 @@ declare const BadgeBase_base: typeof SpectrumElement & {
  *
  * @slot - Text label of the badge.
  * @slot icon - Optional icon that appears to the left of the label
- *
- * @todo review the mixin composition here. We currently have 3 levels of mixins on this class, but the mixin composition guide recommends a maximum of 2.
  */
 export declare abstract class BadgeBase extends BadgeBase_base {
     /**
@@ -87,12 +81,34 @@ export declare abstract class BadgeBase extends BadgeBase_base {
      * Can only be used with semantic variants.
      */
     outline: boolean;
+    /**
+     * Observes whether an icon is slotted into `[slot="icon"]`.
+     *
+     * @internal
+     */
+    protected slotPresence: SlotPresenceController;
+    /**
+     * Observes whether the default slot has meaningful text content. The default
+     * slot must bind `@slotchange=${this.slotText.handleSlotChange}` for changes
+     * after the first render to be tracked.
+     *
+     * @internal
+     */
+    protected slotText: SlotTextController;
     /**
      * @internal
      *
      * Used for rendering gap when the badge has an icon.
      */
     protected get hasIcon(): boolean;
+    /**
+     * Whether the default slot has meaningful text content. Consumed by the
+     * concrete element's `render()` to toggle icon-only presentation (the
+     * `swc-Badge--no-label` class and its icon-only padding tokens).
+     *
+     * @internal
+     */
+    protected get slotHasContent(): boolean;
     protected update(changedProperties: PropertyValues): void;
 }
 export {};

package/dist/components/badge/Badge.base.js

@@ -3,42 +3,47 @@ import { BADGE_VALID_SIZES as t, BADGE_VARIANTS_SEMANTIC as n, FIXED_VALUES as r
 import { property as i } from "lit/decorators.js";
 import { SpectrumElement as a } from "@adobe/spectrum-wc-core/element/index.js";
 import { SizedMixin as o } from "@adobe/spectrum-wc-core/mixins/index.js";
-import { ObserveSlotPresence as s } from "@adobe/spectrum-wc-core/mixins/observe-slot-presence.js";
-import { ObserveSlotText as c } from "@adobe/spectrum-wc-core/mixins/observe-slot-text.js";
+import { validateEnum as s, warnIf as c } from "@adobe/spectrum-wc-core/utils/index.js";
+import { SlotPresenceController as l } from "@adobe/spectrum-wc-core/controllers/slot-presence-controller/index.js";
+import { SlotTextController as u } from "@adobe/spectrum-wc-core/controllers/slot-text-controller/index.js";
 //#region components/badge/Badge.base.ts
-var l, u = class extends o(c(s(a, "[slot=\"icon\"]"), ""), {
+var d, f = class extends o(a, {
 	validSizes: t,
 	defaultSize: "s"
 }) {
 	constructor(...e) {
-		super(...e), this.variant = "neutral", this.subtle = !1, this.outline = !1;
+		super(...e), this.variant = "neutral", this.subtle = !1, this.outline = !1, this.slotPresence = new l(this, "[slot=\"icon\"]"), this.slotText = new u(this);
 	}
 	get hasIcon() {
-		return this.slotContentIsPresent;
+		return this.slotPresence.isPresent;
+	}
+	get slotHasContent() {
+		return this.slotText.hasContent;
 	}
 	update(e) {
-		var t;
-		if ((t = window.__swc) != null && t.DEBUG) {
-			let e = this.constructor;
-			e.VARIANTS.includes(this.variant) || window.__swc.warn(this, `<${this.localName}> element expects the "variant" attribute to be one of the following:`, "https://opensource.adobe.com/spectrum-web-components/components/badge/#variants", { issues: [...e.VARIANTS] }), "outline" in this && this.outline === !0 && !e.VARIANTS_SEMANTIC.includes(this.variant) && window.__swc.warn(this, `<${this.localName}> element only supports the outline styling if the variant is a semantic color variant.`, "https://opensource.adobe.com/spectrum-web-components/components/badge/#variants", { issues: [...e.VARIANTS_SEMANTIC] });
-		}
-		super.update(e);
+		let t = this.constructor;
+		s(this, {
+			prop: "variant",
+			value: this.variant,
+			valid: t.VARIANTS,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-badge--docs"
+		}), c(this, "outline" in this && this.outline === !0 && !t.VARIANTS_SEMANTIC.includes(this.variant), `<${this.localName}> element only supports the outline styling if the variant is a semantic color variant.`, "https://spectrum-web-components.adobe.com/?path=/docs/components-badge--docs", { issues: [...t.VARIANTS_SEMANTIC] }), super.update(e);
 	}
 };
-l = u, l.FIXED_VALUES = r, l.VARIANTS_SEMANTIC = n, e([i({
+d = f, d.FIXED_VALUES = r, d.VARIANTS_SEMANTIC = n, e([i({
 	type: String,
 	reflect: !0
-})], u.prototype, "variant", void 0), e([i({
+})], f.prototype, "variant", void 0), e([i({
 	type: String,
 	reflect: !0
-})], u.prototype, "fixed", void 0), e([i({
+})], f.prototype, "fixed", void 0), e([i({
 	type: Boolean,
 	reflect: !0
-})], u.prototype, "subtle", void 0), e([i({
+})], f.prototype, "subtle", void 0), e([i({
 	type: Boolean,
 	reflect: !0
-})], u.prototype, "outline", void 0);
+})], f.prototype, "outline", void 0);
 //#endregion
-export { u as BadgeBase };
+export { f as BadgeBase };
 
 //# sourceMappingURL=Badge.base.js.map

package/dist/components/badge/Badge.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"Badge.base.js","names":[],"sources":["../../../components/badge/Badge.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { SizedMixin } from '@adobe/spectrum-wc-core/mixins/index.js';\nimport { ObserveSlotPresence } from '@adobe/spectrum-wc-core/mixins/observe-slot-presence.js';\nimport { ObserveSlotText } from '@adobe/spectrum-wc-core/mixins/observe-slot-text.js';\n\nimport {\n  BADGE_VALID_SIZES,\n  BADGE_VARIANTS_SEMANTIC,\n  type BadgeSize,\n  type BadgeVariant,\n  FIXED_VALUES,\n  type FixedValues,\n} from './Badge.types.js';\n\n/**\n * A badge component that displays short, descriptive information about an element.\n * Badges are typically used to indicate status, categories, or provide supplementary information.\n *\n * @attribute {ElementSize} size - The size of the badge.\n *\n * @slot - Text label of the badge.\n * @slot icon - Optional icon that appears to the left of the label\n *\n * @todo review the mixin composition here. We currently have 3 levels of mixins on this class, but the mixin composition guide recommends a maximum of 2.\n */\nexport abstract class BadgeBase extends SizedMixin(\n  ObserveSlotText(ObserveSlotPresence(SpectrumElement, '[slot=\"icon\"]'), ''),\n  {\n    validSizes: BADGE_VALID_SIZES,\n    defaultSize: 's',\n  }\n) {\n  /**\n   * The size of the badge.\n   *\n   * @default s\n   */\n  declare public size: BadgeSize;\n\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of the valid color variants for the badge.\n   *\n   * This is an actual internal property, intended not for customer use\n   * but for use in internal validation logic, stories, tests, etc.\n   *\n   * Because S1 and S2 support different color variants, the value of this\n   * property must be set in each subclass.\n   */\n  static readonly VARIANTS_COLOR: readonly string[];\n\n  /**\n   * @internal\n   *\n   * A readonly array of all valid variants for the badge.\n   *\n   * This is an actual internal property, intended not for customer use\n   * but for use in internal validation logic, stories, tests, etc.\n   *\n   * Because S1 and S2 support different variants, the value of this\n   * property must be set in each subclass.\n   */\n  static readonly VARIANTS: readonly string[];\n\n  /**\n   * @internal\n   *\n   * The variant of the badge.\n   *\n   * This is a public property, but its valid values vary between S1 and S2,\n   * so the property (and its docs) need to be redefined in each subclass.\n   *\n   * The type declared here is a union of the valid values for S1 and S2,\n   * and should be narrowed in each subclass.\n   */\n  @property({ type: String, reflect: true })\n  public variant: BadgeVariant = 'neutral';\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * @internal\n   */\n  static readonly FIXED_VALUES: readonly string[] = FIXED_VALUES;\n\n  /**\n   * @internal\n   */\n  static readonly VARIANTS_SEMANTIC: readonly string[] =\n    BADGE_VARIANTS_SEMANTIC;\n\n  /**\n   * The fixed position of the badge.\n   */\n  @property({ type: String, reflect: true })\n  public fixed?: FixedValues;\n\n  /**\n   * Whether the badge is subtle.\n   */\n  @property({ type: Boolean, reflect: true })\n  public subtle: boolean = false;\n\n  /**\n   * Whether the badge is outlined.\n   *\n   * Can only be used with semantic variants.\n   */\n  @property({ type: Boolean, reflect: true })\n  public outline: boolean = false;\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  /**\n   * @internal\n   *\n   * Used for rendering gap when the badge has an icon.\n   */\n  protected get hasIcon(): boolean {\n    return this.slotContentIsPresent;\n  }\n\n  protected override update(changedProperties: PropertyValues): void {\n    if (window.__swc?.DEBUG) {\n      const constructor = this.constructor as typeof BadgeBase;\n      if (!constructor.VARIANTS.includes(this.variant)) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> element expects the \"variant\" attribute to be one of the following:`,\n          'https://opensource.adobe.com/spectrum-web-components/components/badge/#variants',\n          {\n            issues: [...constructor.VARIANTS],\n          }\n        );\n      }\n      // Check outline property if it exists (S2 only)\n      if (\n        'outline' in this &&\n        (this as { outline: boolean }).outline === true &&\n        !constructor.VARIANTS_SEMANTIC.includes(this.variant)\n      ) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> element only supports the outline styling if the variant is a semantic color variant.`,\n          'https://opensource.adobe.com/spectrum-web-components/components/badge/#variants',\n          {\n            issues: [...constructor.VARIANTS_SEMANTIC],\n          }\n        );\n      }\n    }\n    super.update(changedProperties);\n  }\n}\n"],"mappings":";;;;;;;;OAuCsB,IAAtB,cAAwC,EACtC,EAAgB,EAAoB,GAAiB,kBAAgB,EAAE,GAAG,EAC1E;CACE,YAAY;CACZ,aAAa;CACd,CACF,CAAC;;8BAkD+B,yBA2BN,mBAQC;;CAW1B,IAAc,UAAmB;AAC/B,SAAO,KAAK;;CAGd,OAA0B,GAAyC;;AACjE,OAAA,IAAI,OAAO,UAAA,QAAA,EAAO,OAAO;GACvB,IAAM,IAAc,KAAK;AAYzB,GAXK,EAAY,SAAS,SAAS,KAAK,QAAQ,IAC9C,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,wEACnB,mFACA,EACE,QAAQ,CAAC,GAAG,EAAY,SAAS,EAClC,CACF,EAID,aAAa,QACZ,KAA8B,YAAY,MAC3C,CAAC,EAAY,kBAAkB,SAAS,KAAK,QAAQ,IAErD,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,0FACnB,mFACA,EACE,QAAQ,CAAC,GAAG,EAAY,kBAAkB,EAC3C,CACF;;AAGL,QAAM,OAAO,EAAkB;;;wBAtEiB,yBAMhD,MAhBD,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA,KAqBzC,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA,KAMzC,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,UAAA,KAAA,EAAA,KAQ1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA"}
+{"version":3,"file":"Badge.base.js","names":[],"sources":["../../../components/badge/Badge.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SlotPresenceController } from '@adobe/spectrum-wc-core/controllers/slot-presence-controller/index.js';\nimport { SlotTextController } from '@adobe/spectrum-wc-core/controllers/slot-text-controller/index.js';\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { SizedMixin } from '@adobe/spectrum-wc-core/mixins/index.js';\nimport { validateEnum, warnIf } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport {\n  BADGE_VALID_SIZES,\n  BADGE_VARIANTS_SEMANTIC,\n  type BadgeSize,\n  type BadgeVariant,\n  FIXED_VALUES,\n  type FixedValues,\n} from './Badge.types.js';\n\n/**\n * A badge component that displays short, descriptive information about an element.\n * Badges are typically used to indicate status, categories, or provide supplementary information.\n *\n * @attribute {ElementSize} size - The size of the badge.\n *\n * @slot - Text label of the badge.\n * @slot icon - Optional icon that appears to the left of the label\n */\nexport abstract class BadgeBase extends SizedMixin(SpectrumElement, {\n  validSizes: BADGE_VALID_SIZES,\n  defaultSize: 's',\n}) {\n  /**\n   * The size of the badge.\n   *\n   * @default s\n   */\n  declare public size: BadgeSize;\n\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of the valid color variants for the badge.\n   *\n   * This is an actual internal property, intended not for customer use\n   * but for use in internal validation logic, stories, tests, etc.\n   *\n   * Because S1 and S2 support different color variants, the value of this\n   * property must be set in each subclass.\n   */\n  static readonly VARIANTS_COLOR: readonly string[];\n\n  /**\n   * @internal\n   *\n   * A readonly array of all valid variants for the badge.\n   *\n   * This is an actual internal property, intended not for customer use\n   * but for use in internal validation logic, stories, tests, etc.\n   *\n   * Because S1 and S2 support different variants, the value of this\n   * property must be set in each subclass.\n   */\n  static readonly VARIANTS: readonly string[];\n\n  /**\n   * @internal\n   *\n   * The variant of the badge.\n   *\n   * This is a public property, but its valid values vary between S1 and S2,\n   * so the property (and its docs) need to be redefined in each subclass.\n   *\n   * The type declared here is a union of the valid values for S1 and S2,\n   * and should be narrowed in each subclass.\n   */\n  @property({ type: String, reflect: true })\n  public variant: BadgeVariant = 'neutral';\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * @internal\n   */\n  static readonly FIXED_VALUES: readonly string[] = FIXED_VALUES;\n\n  /**\n   * @internal\n   */\n  static readonly VARIANTS_SEMANTIC: readonly string[] =\n    BADGE_VARIANTS_SEMANTIC;\n\n  /**\n   * The fixed position of the badge.\n   */\n  @property({ type: String, reflect: true })\n  public fixed?: FixedValues;\n\n  /**\n   * Whether the badge is subtle.\n   */\n  @property({ type: Boolean, reflect: true })\n  public subtle: boolean = false;\n\n  /**\n   * Whether the badge is outlined.\n   *\n   * Can only be used with semantic variants.\n   */\n  @property({ type: Boolean, reflect: true })\n  public outline: boolean = false;\n\n  // ──────────────────────\n  //     CONTROLLERS\n  // ──────────────────────\n\n  /**\n   * Observes whether an icon is slotted into `[slot=\"icon\"]`.\n   *\n   * @internal\n   */\n  protected slotPresence = new SlotPresenceController(this, '[slot=\"icon\"]');\n\n  /**\n   * Observes whether the default slot has meaningful text content. The default\n   * slot must bind `@slotchange=${this.slotText.handleSlotChange}` for changes\n   * after the first render to be tracked.\n   *\n   * @internal\n   */\n  protected slotText = new SlotTextController(this);\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  /**\n   * @internal\n   *\n   * Used for rendering gap when the badge has an icon.\n   */\n  protected get hasIcon(): boolean {\n    return this.slotPresence.isPresent;\n  }\n\n  /**\n   * Whether the default slot has meaningful text content. Consumed by the\n   * concrete element's `render()` to toggle icon-only presentation (the\n   * `swc-Badge--no-label` class and its icon-only padding tokens).\n   *\n   * @internal\n   */\n  protected get slotHasContent(): boolean {\n    return this.slotText.hasContent;\n  }\n\n  protected override update(changedProperties: PropertyValues): void {\n    const constructor = this.constructor as typeof BadgeBase;\n    validateEnum(this, {\n      prop: 'variant',\n      value: this.variant,\n      valid: constructor.VARIANTS,\n      url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-badge--docs',\n    });\n    // Check outline property if it exists (S2 only)\n    warnIf(\n      this,\n      'outline' in this &&\n        (this as { outline: boolean }).outline === true &&\n        !constructor.VARIANTS_SEMANTIC.includes(this.variant),\n      `<${this.localName}> element only supports the outline styling if the variant is a semantic color variant.`,\n      'https://spectrum-web-components.adobe.com/?path=/docs/components-badge--docs',\n      { issues: [...constructor.VARIANTS_SEMANTIC] }\n    );\n    super.update(changedProperties);\n  }\n}\n"],"mappings":";;;;;;;;;OAsCsB,IAAtB,cAAwC,EAAW,GAAiB;CAClE,YAAY;CACZ,aAAa;CACd,CAAC,CAAC;;8BAkD8B,yBA2BN,mBAQC,wBAWD,IAAI,EAAuB,MAAM,kBAAgB,kBASrD,IAAI,EAAmB,KAAK;;CAWjD,IAAc,UAAmB;AAC/B,SAAO,KAAK,aAAa;;CAU3B,IAAc,iBAA0B;AACtC,SAAO,KAAK,SAAS;;CAGvB,OAA0B,GAAyC;EACjE,IAAM,IAAc,KAAK;AAiBzB,EAhBA,EAAa,MAAM;GACjB,MAAM;GACN,OAAO,KAAK;GACZ,OAAO,EAAY;GACnB,KAAK;GACN,CAAC,EAEF,EACE,MACA,aAAa,QACV,KAA8B,YAAY,MAC3C,CAAC,EAAY,kBAAkB,SAAS,KAAK,QAAQ,EACvD,IAAI,KAAK,UAAU,0FACnB,gFACA,EAAE,QAAQ,CAAC,GAAG,EAAY,kBAAkB,EAAE,CAC/C,EACD,MAAM,OAAO,EAAkB;;;wBA1FiB,yBAMhD,MAhBD,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA,KAqBzC,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA,KAMzC,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,UAAA,KAAA,EAAA,KAQ1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA"}

package/dist/components/button/Button.base.d.ts

@@ -1,13 +1,9 @@
 import { PropertyValues } from 'lit';
+import { SlotPresenceController } from '../../controllers/slot-presence-controller/index.js';
+import { SlotTextController } from '../../controllers/slot-text-controller/index.js';
 import { SpectrumElement } from '../../element/index.js';
 import { ButtonSize } from './Button.types.js';
 declare const ButtonBase_base: typeof SpectrumElement & {
-    new (...args: any[]): import('../../mixins/index.js').SlotPresenceObservingInterface;
-    prototype: import('../../mixins/index.js').SlotPresenceObservingInterface;
-} & {
-    new (...args: any[]): import('../../mixins/index.js').SlotTextObservingInterface;
-    prototype: import('../../mixins/index.js').SlotTextObservingInterface;
-} & {
     new (...args: any[]): import('../../mixins/index.js').SizedElementInterface;
     prototype: import('../../mixins/index.js').SizedElementInterface;
 } & import('../../mixins/index.js').SizedElementConstructor;
@@ -22,9 +18,6 @@ declare const ButtonBase_base: typeof SpectrumElement & {
  * the `swc-button` visual surface.
  *
  * @attribute {ElementSize} size - The size of the button.
- *
- * @todo We currently have 3 levels of mixins on this class, but the mixin
- * composition guide recommends a maximum of 2. Explore reducing after milestone 2.
  */
 export declare abstract class ButtonBase extends ButtonBase_base {
     static shadowRootOptions: ShadowRootInit;
@@ -44,6 +37,20 @@ export declare abstract class ButtonBase extends ButtonBase_base {
      * `aria-label`. Required for icon-only buttons, which have no visible text.
      */
     accessibleLabel?: string;
+    /**
+     * Observes whether an icon is slotted into `[slot="icon"]`.
+     *
+     * @internal
+     */
+    protected slotPresence: SlotPresenceController;
+    /**
+     * Observes whether the default slot has a meaningful text label. The default
+     * slot must bind `@slotchange=${this.slotText.handleSlotChange}` for changes
+     * after the first render to be tracked.
+     *
+     * @internal
+     */
+    protected slotText: SlotTextController;
     protected get hasIcon(): boolean;
     protected get hasLabel(): boolean;
     /**
@@ -56,7 +63,10 @@ export declare abstract class ButtonBase extends ButtonBase_base {
     connectedCallback(): void;
     disconnectedCallback(): void;
     /**
-     * Suppresses click activation while the button is `disabled`.
+     * Suppresses click activation while the button is `disabled`, or externally
+     * marked `aria-disabled` (e.g. by a disabled parent `swc-action-group`,
+     * which uses `aria-disabled` instead of native `disabled` so children
+     * remain keyboard-reachable).
      *
      * Slotted icon content lives in the light DOM, so pointer clicks on icons
      * bypass the disabled inner `<button>` and bubble on the host. The host

package/dist/components/button/Button.base.js

@@ -2,19 +2,22 @@ import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/he
 import { BUTTON_VALID_SIZES as t } from "./Button.types.js";
 import { property as n } from "lit/decorators.js";
 import { SpectrumElement as r } from "@adobe/spectrum-wc-core/element/index.js";
-import { ObserveSlotPresence as i, ObserveSlotText as a, SizedMixin as o } from "@adobe/spectrum-wc-core/mixins/index.js";
+import { SizedMixin as i } from "@adobe/spectrum-wc-core/mixins/index.js";
+import { warnIf as a } from "@adobe/spectrum-wc-core/utils/index.js";
+import { SlotPresenceController as o } from "@adobe/spectrum-wc-core/controllers/slot-presence-controller/index.js";
+import { SlotTextController as s } from "@adobe/spectrum-wc-core/controllers/slot-text-controller/index.js";
 //#region components/button/Button.base.ts
-var s, c = class extends o(a(i(r, "[slot=\"icon\"]"), ""), { validSizes: t }) {
+var c, l = class extends i(r, { validSizes: t }) {
 	constructor(...e) {
-		super(...e), this.disabled = !1, this.handleClick = (e) => {
-			this.disabled && (e.preventDefault(), e.stopImmediatePropagation());
+		super(...e), this.disabled = !1, this.slotPresence = new o(this, "[slot=\"icon\"]"), this.slotText = new s(this), this.handleClick = (e) => {
+			(this.disabled || this.getAttribute("aria-disabled") === "true") && (e.preventDefault(), e.stopImmediatePropagation());
 		};
 	}
 	get hasIcon() {
-		return this.slotContentIsPresent;
+		return this.slotPresence.isPresent;
 	}
 	get hasLabel() {
-		return this.slotHasContent;
+		return this.slotText.hasContent;
 	}
 	getForwardedButtonAttributes() {
 		return { disabled: this.disabled };
@@ -26,21 +29,23 @@ var s, c = class extends o(a(i(r, "[slot=\"icon\"]"), ""), { validSizes: t }) {
 		this.removeEventListener("click", this.handleClick, !0), super.disconnectedCallback();
 	}
 	update(e) {
-		var t;
-		super.update(e), (t = window.__swc) != null && t.DEBUG && this.hasIcon && !this.hasLabel && !this.accessibleLabel && window.__swc.warn(this, `<${this.localName}> with an icon and no label must have an "accessible-label" attribute to be accessible.`, "https://opensource.adobe.com/spectrum-web-components/components/button/#icon-only", { issues: ["accessible-label"] });
+		super.update(e), a(this, this.hasIcon && !this.hasLabel && !this.accessibleLabel, `<${this.localName}> with an icon and no label must have an "accessible-label" attribute to be accessible.`, "https://spectrum-web-components.adobe.com/?path=/docs/components-button--docs", {
+			type: "accessibility",
+			issues: ["accessible-label"]
+		});
 	}
 };
-s = c, s.shadowRootOptions = {
+c = l, c.shadowRootOptions = {
 	...r.shadowRootOptions,
 	delegatesFocus: !0
 }, e([n({
 	type: Boolean,
 	reflect: !0
-})], c.prototype, "disabled", void 0), e([n({
+})], l.prototype, "disabled", void 0), e([n({
 	type: String,
 	attribute: "accessible-label"
-})], c.prototype, "accessibleLabel", void 0);
+})], l.prototype, "accessibleLabel", void 0);
 //#endregion
-export { c as ButtonBase };
+export { l as ButtonBase };
 
 //# sourceMappingURL=Button.base.js.map