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

package/dist/components/accordion/AccordionItem.base.d.ts

@@ -1,10 +1,7 @@
 import { PropertyValues } from 'lit';
+import { SlotPresenceController } from '../../controllers/slot-presence-controller/index.js';
 import { SpectrumElement } from '../../element/index.js';
 import { AccordionHeadingLevel, AccordionSize } from './Accordion.types.js';
-declare const AccordionItemBase_base: typeof SpectrumElement & {
-    new (...args: any[]): import('../../mixins/observe-slot-presence.js').SlotPresenceObservingInterface;
-    prototype: import('../../mixins/observe-slot-presence.js').SlotPresenceObservingInterface;
-};
 /**
  * Base class for accordion item components. Manages open/disabled state,
  * heading level (set by the parent accordion), and the toggle event.
@@ -19,7 +16,14 @@ declare const AccordionItemBase_base: typeof SpectrumElement & {
  *   the toggle button so they remain independently interactive.
  * @slot - The panel content revealed when the item is open.
  */
-export declare abstract class AccordionItemBase extends AccordionItemBase_base {
+export declare abstract class AccordionItemBase extends SpectrumElement {
+    /**
+     * Observes whether content is slotted into `[slot="actions"]` so the header
+     * can conditionally render the actions container.
+     *
+     * @internal
+     */
+    protected slotPresence: SlotPresenceController;
     /**
      * Whether the accordion item panel is expanded.
      */
@@ -50,6 +54,13 @@ export declare abstract class AccordionItemBase extends AccordionItemBase_base {
      * when the accordion is re-enabled.
      */
     protected parentDisabled: boolean;
+    /**
+     * @internal
+     * Whether content is slotted into `[slot="actions"]`. Consumed by the
+     * concrete element's `render()` to conditionally render the actions
+     * container.
+     */
+    protected get hasActions(): boolean;
     /**
      * @internal
      * Whether the item may change `open` (expand or collapse). When false, the
@@ -83,4 +94,3 @@ export declare abstract class AccordionItemBase extends AccordionItemBase_base {
     connectedCallback(): void;
     disconnectedCallback(): void;
 }
-export {};

package/dist/components/accordion/AccordionItem.base.js

@@ -2,11 +2,11 @@ import { SWC_ACCORDION_ITEM_AFTER_CLOSE_EVENT as e, SWC_ACCORDION_ITEM_AFTER_OPE
 import { __decorate as a } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
 import { property as o, state as s } from "lit/decorators.js";
 import { SpectrumElement as c } from "@adobe/spectrum-wc-core/element/index.js";
-import { ObserveSlotPresence as l } from "@adobe/spectrum-wc-core/mixins/observe-slot-presence.js";
+import { SlotPresenceController as l } from "@adobe/spectrum-wc-core/controllers/slot-presence-controller/index.js";
 //#region components/accordion/AccordionItem.base.ts
-var u = class extends l(c, "[slot=\"actions\"]") {
+var u = class extends c {
 	constructor(...e) {
-		super(...e), this.disabled = !1, this._open = !1, this.headingLevel = 3, this.parentDisabled = !1, this.afterEventPending = !1, this.handleTransitionEnd = (e) => {
+		super(...e), this.slotPresence = new l(this, "[slot=\"actions\"]"), this.disabled = !1, this._open = !1, this.headingLevel = 3, this.parentDisabled = !1, this.afterEventPending = !1, this.handleTransitionEnd = (e) => {
 			e.target !== this.contentPanel || e.propertyName !== "height" || !this.afterEventPending || (this.afterEventPending = !1, this.dispatchAfterEvent(this.open));
 		}, this.handleTransitionCancel = (e) => {
 			e.target !== this.contentPanel || e.propertyName !== "height" || !this.afterEventPending || (this.afterEventPending = !1, this.dispatchAfterEvent(this.open));
@@ -20,6 +20,9 @@ var u = class extends l(c, "[slot=\"actions\"]") {
 		let t = this._open;
 		this._open = e, e ? this.setAttribute("open", "") : this.removeAttribute("open"), this.requestUpdate("open", t);
 	}
+	get hasActions() {
+		return this.slotPresence.isPresent;
+	}
 	mayExpand() {
 		return !this.disabled && !this.parentDisabled;
 	}

package/dist/components/accordion/AccordionItem.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"AccordionItem.base.js","names":[],"sources":["../../../components/accordion/AccordionItem.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, state } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { ObserveSlotPresence } from '@adobe/spectrum-wc-core/mixins/observe-slot-presence.js';\n\nimport {\n  type AccordionHeadingLevel,\n  type AccordionSize,\n  SWC_ACCORDION_ITEM_AFTER_CLOSE_EVENT,\n  SWC_ACCORDION_ITEM_AFTER_OPEN_EVENT,\n  SWC_ACCORDION_ITEM_CLOSE_EVENT,\n  SWC_ACCORDION_ITEM_OPEN_EVENT,\n  SWC_ACCORDION_ITEM_TOGGLE_EVENT,\n} from './Accordion.types.js';\n\n/**\n * Base class for accordion item components. Manages open/disabled state,\n * heading level (set by the parent accordion), and the toggle event.\n *\n * @attribute {boolean} open - Whether the accordion item panel is expanded.\n * @attribute {boolean} disabled - Whether the accordion item is disabled.\n * @attribute {AccordionSize} size - Size of the item. Inherited from the parent\n *   accordion when slotted; controls the chevron icon when used standalone.\n *\n * @slot label - The heading text for this accordion item.\n * @slot actions - Optional actions rendered adjacent to the heading, outside\n *   the toggle button so they remain independently interactive.\n * @slot - The panel content revealed when the item is open.\n */\nexport abstract class AccordionItemBase extends ObserveSlotPresence(\n  SpectrumElement,\n  '[slot=\"actions\"]'\n) {\n  // ──────────────────\n  //     PUBLIC API\n  // ──────────────────\n\n  /**\n   * Whether the accordion item panel is expanded.\n   */\n  @property({ type: Boolean, reflect: true })\n  public get open(): boolean {\n    return this._open;\n  }\n\n  public set open(value: boolean) {\n    if (this.hasUpdated && !this.mayExpand() && value !== this._open) {\n      return;\n    }\n    if (value === this._open) {\n      return;\n    }\n    const oldValue = this._open;\n    this._open = value;\n    if (value) {\n      this.setAttribute('open', '');\n    } else {\n      this.removeAttribute('open');\n    }\n    this.requestUpdate('open', oldValue);\n  }\n\n  /**\n   * Whether the accordion item is disabled. A disabled item keeps its header\n   * in the tab order but blocks toggling.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled: boolean = false;\n\n  /**\n   * The size of the item. Inherited from the parent accordion; controls which\n   * chevron icon is displayed. Has no effect when the item is used standalone.\n   */\n  @property({ type: String, reflect: true })\n  public size?: AccordionSize;\n\n  private _open = false;\n\n  // ──────────────────────\n  //     INTERNAL STATE\n  // ──────────────────────\n\n  /**\n   * @internal\n   * Heading level (2–6) propagated by the parent accordion. Defaults to 3\n   * for standalone items.\n   */\n  @state()\n  protected headingLevel: AccordionHeadingLevel = 3;\n\n  /**\n   * @internal\n   * Set by the parent accordion when its own `disabled` is true. Causes the\n   * item to render as disabled (aria-disabled + inert panel) without clobbering\n   * the item's own `disabled` property, so the per-item state is preserved\n   * when the accordion is re-enabled.\n   */\n  @state()\n  protected parentDisabled: boolean = false;\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  /**\n   * @internal\n   * Whether the item may change `open` (expand or collapse). When false, the\n   * `open` setter and `toggle()` leave state unchanged.\n   */\n  protected mayExpand(): boolean {\n    return !this.disabled && !this.parentDisabled;\n  }\n\n  private get contentPanel(): HTMLElement | null {\n    return this.shadowRoot?.getElementById('content') ?? null;\n  }\n\n  private dispatchAfterEvent(isOpen: boolean): void {\n    this.dispatchEvent(\n      new Event(\n        isOpen\n          ? SWC_ACCORDION_ITEM_AFTER_OPEN_EVENT\n          : SWC_ACCORDION_ITEM_AFTER_CLOSE_EVENT,\n        { bubbles: true, composed: true }\n      )\n    );\n  }\n\n  // Guards dispatchAfterEvent so only one after-event fires per open/close\n  // cycle. transitionend fires once per CSS property; height is the only match.\n  private afterEventPending = false;\n\n  private readonly handleTransitionEnd = (event: TransitionEvent): void => {\n    if (\n      event.target !== this.contentPanel ||\n      event.propertyName !== 'height' ||\n      !this.afterEventPending\n    ) {\n      return;\n    }\n    this.afterEventPending = false;\n    this.dispatchAfterEvent(this.open);\n  };\n\n  // Reused for transitioncancel: an externally interrupted transition must still\n  // resolve afterEventPending so the after-event is not silently lost.\n  private readonly handleTransitionCancel = (event: TransitionEvent): void => {\n    if (\n      event.target !== this.contentPanel ||\n      event.propertyName !== 'height' ||\n      !this.afterEventPending\n    ) {\n      return;\n    }\n    this.afterEventPending = false;\n    this.dispatchAfterEvent(this.open);\n  };\n\n  /**\n   * @internal\n   * Toggles the item open state. Guards for disabled, flips `open`, dispatches\n   * the toggle event, and reverts if the event is canceled. On success, dispatches\n   * `swc-after-open` or `swc-after-close` after the panel height transition ends,\n   * or immediately if no transition is active.\n   */\n  protected toggle(): void {\n    if (!this.mayExpand()) {\n      return;\n    }\n    this.open = !this.open;\n    const toggleEvent = new Event(SWC_ACCORDION_ITEM_TOGGLE_EVENT, {\n      bubbles: true,\n      composed: true,\n      cancelable: true,\n    });\n    if (!this.dispatchEvent(toggleEvent)) {\n      this.open = !this.open;\n      return;\n    }\n    const isOpen = this.open;\n    this.dispatchEvent(\n      new Event(\n        isOpen ? SWC_ACCORDION_ITEM_OPEN_EVENT : SWC_ACCORDION_ITEM_CLOSE_EVENT,\n        {\n          bubbles: true,\n          composed: true,\n        }\n      )\n    );\n    const panel = this.contentPanel;\n    if (!panel || getComputedStyle(panel).transitionDuration === '0s') {\n      this.dispatchAfterEvent(isOpen);\n    } else {\n      this.afterEventPending = true;\n    }\n  }\n\n  /**\n   * @internal\n   * Synchronizes parent-managed heading level onto the item.\n   */\n  public setManagedHeading(heading: AccordionHeadingLevel): void {\n    this.headingLevel = heading;\n  }\n\n  /**\n   * @internal\n   * Synchronizes parent-managed disabled state onto the item.\n   */\n  public setManagedParentDisabled(disabled: boolean): void {\n    this.parentDisabled = disabled;\n  }\n\n  protected override firstUpdated(changedProperties: PropertyValues): void {\n    super.firstUpdated(changedProperties);\n    this.contentPanel?.addEventListener(\n      'transitionend',\n      this.handleTransitionEnd\n    );\n    this.contentPanel?.addEventListener(\n      'transitioncancel',\n      this.handleTransitionCancel\n    );\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    if (this.hasUpdated) {\n      this.contentPanel?.addEventListener(\n        'transitionend',\n        this.handleTransitionEnd\n      );\n      this.contentPanel?.addEventListener(\n        'transitioncancel',\n        this.handleTransitionCancel\n      );\n    }\n  }\n\n  public override disconnectedCallback(): void {\n    super.disconnectedCallback();\n    this.contentPanel?.removeEventListener(\n      'transitionend',\n      this.handleTransitionEnd\n    );\n    this.contentPanel?.removeEventListener(\n      'transitioncancel',\n      this.handleTransitionCancel\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"AccordionItem.base.js","names":[],"sources":["../../../components/accordion/AccordionItem.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, state } from 'lit/decorators.js';\n\nimport { SlotPresenceController } from '@adobe/spectrum-wc-core/controllers/slot-presence-controller/index.js';\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\n\nimport {\n  type AccordionHeadingLevel,\n  type AccordionSize,\n  SWC_ACCORDION_ITEM_AFTER_CLOSE_EVENT,\n  SWC_ACCORDION_ITEM_AFTER_OPEN_EVENT,\n  SWC_ACCORDION_ITEM_CLOSE_EVENT,\n  SWC_ACCORDION_ITEM_OPEN_EVENT,\n  SWC_ACCORDION_ITEM_TOGGLE_EVENT,\n} from './Accordion.types.js';\n\n/**\n * Base class for accordion item components. Manages open/disabled state,\n * heading level (set by the parent accordion), and the toggle event.\n *\n * @attribute {boolean} open - Whether the accordion item panel is expanded.\n * @attribute {boolean} disabled - Whether the accordion item is disabled.\n * @attribute {AccordionSize} size - Size of the item. Inherited from the parent\n *   accordion when slotted; controls the chevron icon when used standalone.\n *\n * @slot label - The heading text for this accordion item.\n * @slot actions - Optional actions rendered adjacent to the heading, outside\n *   the toggle button so they remain independently interactive.\n * @slot - The panel content revealed when the item is open.\n */\nexport abstract class AccordionItemBase extends SpectrumElement {\n  // ──────────────────────\n  //     CONTROLLERS\n  // ──────────────────────\n\n  /**\n   * Observes whether content is slotted into `[slot=\"actions\"]` so the header\n   * can conditionally render the actions container.\n   *\n   * @internal\n   */\n  protected slotPresence = new SlotPresenceController(this, '[slot=\"actions\"]');\n\n  // ──────────────────\n  //     PUBLIC API\n  // ──────────────────\n\n  /**\n   * Whether the accordion item panel is expanded.\n   */\n  @property({ type: Boolean, reflect: true })\n  public get open(): boolean {\n    return this._open;\n  }\n\n  public set open(value: boolean) {\n    if (this.hasUpdated && !this.mayExpand() && value !== this._open) {\n      return;\n    }\n    if (value === this._open) {\n      return;\n    }\n    const oldValue = this._open;\n    this._open = value;\n    if (value) {\n      this.setAttribute('open', '');\n    } else {\n      this.removeAttribute('open');\n    }\n    this.requestUpdate('open', oldValue);\n  }\n\n  /**\n   * Whether the accordion item is disabled. A disabled item keeps its header\n   * in the tab order but blocks toggling.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled: boolean = false;\n\n  /**\n   * The size of the item. Inherited from the parent accordion; controls which\n   * chevron icon is displayed. Has no effect when the item is used standalone.\n   */\n  @property({ type: String, reflect: true })\n  public size?: AccordionSize;\n\n  private _open = false;\n\n  // ──────────────────────\n  //     INTERNAL STATE\n  // ──────────────────────\n\n  /**\n   * @internal\n   * Heading level (2–6) propagated by the parent accordion. Defaults to 3\n   * for standalone items.\n   */\n  @state()\n  protected headingLevel: AccordionHeadingLevel = 3;\n\n  /**\n   * @internal\n   * Set by the parent accordion when its own `disabled` is true. Causes the\n   * item to render as disabled (aria-disabled + inert panel) without clobbering\n   * the item's own `disabled` property, so the per-item state is preserved\n   * when the accordion is re-enabled.\n   */\n  @state()\n  protected parentDisabled: boolean = false;\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  /**\n   * @internal\n   * Whether content is slotted into `[slot=\"actions\"]`. Consumed by the\n   * concrete element's `render()` to conditionally render the actions\n   * container.\n   */\n  protected get hasActions(): boolean {\n    return this.slotPresence.isPresent;\n  }\n\n  /**\n   * @internal\n   * Whether the item may change `open` (expand or collapse). When false, the\n   * `open` setter and `toggle()` leave state unchanged.\n   */\n  protected mayExpand(): boolean {\n    return !this.disabled && !this.parentDisabled;\n  }\n\n  private get contentPanel(): HTMLElement | null {\n    return this.shadowRoot?.getElementById('content') ?? null;\n  }\n\n  private dispatchAfterEvent(isOpen: boolean): void {\n    this.dispatchEvent(\n      new Event(\n        isOpen\n          ? SWC_ACCORDION_ITEM_AFTER_OPEN_EVENT\n          : SWC_ACCORDION_ITEM_AFTER_CLOSE_EVENT,\n        { bubbles: true, composed: true }\n      )\n    );\n  }\n\n  // Guards dispatchAfterEvent so only one after-event fires per open/close\n  // cycle. transitionend fires once per CSS property; height is the only match.\n  private afterEventPending = false;\n\n  private readonly handleTransitionEnd = (event: TransitionEvent): void => {\n    if (\n      event.target !== this.contentPanel ||\n      event.propertyName !== 'height' ||\n      !this.afterEventPending\n    ) {\n      return;\n    }\n    this.afterEventPending = false;\n    this.dispatchAfterEvent(this.open);\n  };\n\n  // Reused for transitioncancel: an externally interrupted transition must still\n  // resolve afterEventPending so the after-event is not silently lost.\n  private readonly handleTransitionCancel = (event: TransitionEvent): void => {\n    if (\n      event.target !== this.contentPanel ||\n      event.propertyName !== 'height' ||\n      !this.afterEventPending\n    ) {\n      return;\n    }\n    this.afterEventPending = false;\n    this.dispatchAfterEvent(this.open);\n  };\n\n  /**\n   * @internal\n   * Toggles the item open state. Guards for disabled, flips `open`, dispatches\n   * the toggle event, and reverts if the event is canceled. On success, dispatches\n   * `swc-after-open` or `swc-after-close` after the panel height transition ends,\n   * or immediately if no transition is active.\n   */\n  protected toggle(): void {\n    if (!this.mayExpand()) {\n      return;\n    }\n    this.open = !this.open;\n    const toggleEvent = new Event(SWC_ACCORDION_ITEM_TOGGLE_EVENT, {\n      bubbles: true,\n      composed: true,\n      cancelable: true,\n    });\n    if (!this.dispatchEvent(toggleEvent)) {\n      this.open = !this.open;\n      return;\n    }\n    const isOpen = this.open;\n    this.dispatchEvent(\n      new Event(\n        isOpen ? SWC_ACCORDION_ITEM_OPEN_EVENT : SWC_ACCORDION_ITEM_CLOSE_EVENT,\n        {\n          bubbles: true,\n          composed: true,\n        }\n      )\n    );\n    const panel = this.contentPanel;\n    if (!panel || getComputedStyle(panel).transitionDuration === '0s') {\n      this.dispatchAfterEvent(isOpen);\n    } else {\n      this.afterEventPending = true;\n    }\n  }\n\n  /**\n   * @internal\n   * Synchronizes parent-managed heading level onto the item.\n   */\n  public setManagedHeading(heading: AccordionHeadingLevel): void {\n    this.headingLevel = heading;\n  }\n\n  /**\n   * @internal\n   * Synchronizes parent-managed disabled state onto the item.\n   */\n  public setManagedParentDisabled(disabled: boolean): void {\n    this.parentDisabled = disabled;\n  }\n\n  protected override firstUpdated(changedProperties: PropertyValues): void {\n    super.firstUpdated(changedProperties);\n    this.contentPanel?.addEventListener(\n      'transitionend',\n      this.handleTransitionEnd\n    );\n    this.contentPanel?.addEventListener(\n      'transitioncancel',\n      this.handleTransitionCancel\n    );\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    if (this.hasUpdated) {\n      this.contentPanel?.addEventListener(\n        'transitionend',\n        this.handleTransitionEnd\n      );\n      this.contentPanel?.addEventListener(\n        'transitioncancel',\n        this.handleTransitionCancel\n      );\n    }\n  }\n\n  public override disconnectedCallback(): void {\n    super.disconnectedCallback();\n    this.contentPanel?.removeEventListener(\n      'transitionend',\n      this.handleTransitionEnd\n    );\n    this.contentPanel?.removeEventListener(\n      'transitioncancel',\n      this.handleTransitionCancel\n    );\n  }\n}\n"],"mappings":"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"}

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,18 +3,21 @@ 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 { SlotPresenceController as s } from "@adobe/spectrum-wc-core/controllers/slot-presence-controller/index.js";
+import { SlotTextController as c } 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 l, u = 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 s(this, "[slot=\"icon\"]"), this.slotText = new c(this);
 	}
 	get hasIcon() {
-		return this.slotContentIsPresent;
+		return this.slotPresence.isPresent;
+	}
+	get slotHasContent() {
+		return this.slotText.hasContent;
 	}
 	update(e) {
 		var t;

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';\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    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":";;;;;;;;OAqCsB,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;;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;;;wBArGiB,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;
     /**

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

@@ -2,19 +2,21 @@ 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 { SlotPresenceController as a } from "@adobe/spectrum-wc-core/controllers/slot-presence-controller/index.js";
+import { SlotTextController as o } 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 s, c = class extends i(r, { validSizes: t }) {
 	constructor(...e) {
-		super(...e), this.disabled = !1, this.handleClick = (e) => {
+		super(...e), this.disabled = !1, this.slotPresence = new a(this, "[slot=\"icon\"]"), this.slotText = new o(this), this.handleClick = (e) => {
 			this.disabled && (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 };

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

@@ -1 +1 @@
-{"version":3,"file":"Button.base.js","names":[],"sources":["../../../components/button/Button.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 {\n  ObserveSlotPresence,\n  ObserveSlotText,\n  SizedMixin,\n} from '@adobe/spectrum-wc-core/mixins/index.js';\n\nimport { BUTTON_VALID_SIZES, type ButtonSize } from './Button.types.js';\n\n/**\n * Abstract base class for all button-like components. Owns shared semantic\n * concerns: interaction state, sizing, slot-derived icon/label state,\n * accessible-name resolution, and host-to-internal-button attribute forwarding.\n *\n * Visual API specific to `sp-button` (`variant`, `fill-style`, `static-color`)\n * is intentionally absent so that ActionButton, ClearButton, CloseButton,\n * PickerButton, and InfieldButton can extend this base without inheriting\n * the `swc-button` visual surface.\n *\n * @attribute {ElementSize} size - The size of the button.\n *\n * @todo We currently have 3 levels of mixins on this class, but the mixin\n * composition guide recommends a maximum of 2. Explore reducing after milestone 2.\n */\nexport abstract class ButtonBase extends SizedMixin(\n  ObserveSlotText(ObserveSlotPresence(SpectrumElement, '[slot=\"icon\"]'), ''),\n  { validSizes: BUTTON_VALID_SIZES }\n) {\n  static override shadowRootOptions: ShadowRootInit = {\n    ...SpectrumElement.shadowRootOptions,\n    delegatesFocus: true,\n  };\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * The size of the button.\n   *\n   * @default m\n   */\n  declare public size: ButtonSize;\n\n  /**\n   * Whether the button is disabled. Removes focusability and prevents\n   * interaction.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled: boolean = false;\n\n  /**\n   * Accessible label forwarded to the internal `<button>` element as\n   * `aria-label`. Required for icon-only buttons, which have no visible text.\n   */\n  @property({ type: String, attribute: 'accessible-label' })\n  public accessibleLabel?: string;\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected get hasIcon(): boolean {\n    return this.slotContentIsPresent;\n  }\n\n  protected get hasLabel(): boolean {\n    return this.slotHasContent;\n  }\n\n  /**\n   * Returns the set of attributes that should be forwarded to the internal\n   * semantic `<button>` element, if not otherwise directly managed.\n   *\n   * @internal\n   */\n  protected getForwardedButtonAttributes(): Record<\n    string,\n    string | boolean | undefined\n  > {\n    return {\n      disabled: this.disabled,\n    };\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    // Capture phase so slotted light-DOM clicks are suppressed before host\n    // listeners (e.g. Storybook actions) run.\n    this.addEventListener('click', this.handleClick, true);\n  }\n\n  public override disconnectedCallback(): void {\n    this.removeEventListener('click', this.handleClick, true);\n    super.disconnectedCallback();\n  }\n\n  /**\n   * Suppresses click activation while the button is `disabled`.\n   *\n   * Slotted icon content lives in the light DOM, so pointer clicks on icons\n   * bypass the disabled inner `<button>` and bubble on the host. The host\n   * listener (capture) and inner `@click` binding both call this handler.\n   */\n  protected readonly handleClick = (event: Event): void => {\n    if (this.disabled) {\n      event.preventDefault();\n      event.stopImmediatePropagation();\n    }\n  };\n\n  protected override update(changedProperties: PropertyValues): void {\n    super.update(changedProperties);\n    if (window.__swc?.DEBUG) {\n      if (this.hasIcon && !this.hasLabel && !this.accessibleLabel) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> with an icon and no label must have an \"accessible-label\" attribute to be accessible.`,\n          'https://opensource.adobe.com/spectrum-web-components/components/button/#icon-only',\n          { issues: ['accessible-label'] }\n        );\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;OAuCsB,IAAtB,cAAyC,EACvC,EAAgB,EAAoB,GAAiB,kBAAgB,EAAE,GAAG,EAC1E,EAAE,YAAY,GAAoB,CACnC,CAAC;;+BAsB2B,wBAuDO,MAAuB;AACvD,GAAI,KAAK,aACP,EAAM,gBAAgB,EACtB,EAAM,0BAA0B;;;CA7CpC,IAAc,UAAmB;AAC/B,SAAO,KAAK;;CAGd,IAAc,WAAoB;AAChC,SAAO,KAAK;;CASd,+BAGE;AACA,SAAO,EACL,UAAU,KAAK,UAChB;;CAGH,oBAA0C;AAIxC,EAHA,MAAM,mBAAmB,EAGzB,KAAK,iBAAiB,SAAS,KAAK,aAAa,GAAK;;CAGxD,uBAA6C;AAE3C,EADA,KAAK,oBAAoB,SAAS,KAAK,aAAa,GAAK,EACzD,MAAM,sBAAsB;;CAiB9B,OAA0B,GAAyC;;AAEjE,EADA,MAAM,OAAO,EAAkB,GAC/B,IAAI,OAAO,UAAA,QAAA,EAAO,SACZ,KAAK,WAAW,CAAC,KAAK,YAAY,CAAC,KAAK,mBAC1C,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,0FACnB,qFACA,EAAE,QAAQ,CAAC,mBAAmB,EAAE,CACjC;;;6BA5F6C;CAClD,GAAG,EAAgB;CACnB,gBAAgB;CACjB,KAiBA,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAO1C,EAAS;CAAE,MAAM;CAAQ,WAAW;CAAoB,CAAC,CAAA,EAAA,EAAA,WAAA,mBAAA,KAAA,EAAA"}
+{"version":3,"file":"Button.base.js","names":[],"sources":["../../../components/button/Button.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 { 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';\n\nimport { BUTTON_VALID_SIZES, type ButtonSize } from './Button.types.js';\n\n/**\n * Abstract base class for all button-like components. Owns shared semantic\n * concerns: interaction state, sizing, slot-derived icon/label state,\n * accessible-name resolution, and host-to-internal-button attribute forwarding.\n *\n * Visual API specific to `sp-button` (`variant`, `fill-style`, `static-color`)\n * is intentionally absent so that ActionButton, ClearButton, CloseButton,\n * PickerButton, and InfieldButton can extend this base without inheriting\n * the `swc-button` visual surface.\n *\n * @attribute {ElementSize} size - The size of the button.\n */\nexport abstract class ButtonBase extends SizedMixin(SpectrumElement, {\n  validSizes: BUTTON_VALID_SIZES,\n}) {\n  static override shadowRootOptions: ShadowRootInit = {\n    ...SpectrumElement.shadowRootOptions,\n    delegatesFocus: true,\n  };\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * The size of the button.\n   *\n   * @default m\n   */\n  declare public size: ButtonSize;\n\n  /**\n   * Whether the button is disabled. Removes focusability and prevents\n   * interaction.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled: boolean = false;\n\n  /**\n   * Accessible label forwarded to the internal `<button>` element as\n   * `aria-label`. Required for icon-only buttons, which have no visible text.\n   */\n  @property({ type: String, attribute: 'accessible-label' })\n  public accessibleLabel?: string;\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 a meaningful text label. 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  protected get hasIcon(): boolean {\n    return this.slotPresence.isPresent;\n  }\n\n  protected get hasLabel(): boolean {\n    return this.slotText.hasContent;\n  }\n\n  /**\n   * Returns the set of attributes that should be forwarded to the internal\n   * semantic `<button>` element, if not otherwise directly managed.\n   *\n   * @internal\n   */\n  protected getForwardedButtonAttributes(): Record<\n    string,\n    string | boolean | undefined\n  > {\n    return {\n      disabled: this.disabled,\n    };\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    // Capture phase so slotted light-DOM clicks are suppressed before host\n    // listeners (e.g. Storybook actions) run.\n    this.addEventListener('click', this.handleClick, true);\n  }\n\n  public override disconnectedCallback(): void {\n    this.removeEventListener('click', this.handleClick, true);\n    super.disconnectedCallback();\n  }\n\n  /**\n   * Suppresses click activation while the button is `disabled`.\n   *\n   * Slotted icon content lives in the light DOM, so pointer clicks on icons\n   * bypass the disabled inner `<button>` and bubble on the host. The host\n   * listener (capture) and inner `@click` binding both call this handler.\n   */\n  protected readonly handleClick = (event: Event): void => {\n    if (this.disabled) {\n      event.preventDefault();\n      event.stopImmediatePropagation();\n    }\n  };\n\n  protected override update(changedProperties: PropertyValues): void {\n    super.update(changedProperties);\n    if (window.__swc?.DEBUG) {\n      if (this.hasIcon && !this.hasLabel && !this.accessibleLabel) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> with an icon and no label must have an \"accessible-label\" attribute to be accessible.`,\n          'https://opensource.adobe.com/spectrum-web-components/components/button/#icon-only',\n          { issues: ['accessible-label'] }\n        );\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;OAkCsB,IAAtB,cAAyC,EAAW,GAAiB,EACnE,YAAY,GACb,CAAC,CAAC;;+BAsB0B,wBAkBF,IAAI,EAAuB,MAAM,kBAAgB,kBASrD,IAAI,EAAmB,KAAK,sBAgDf,MAAuB;AACvD,GAAI,KAAK,aACP,EAAM,gBAAgB,EACtB,EAAM,0BAA0B;;;CA7CpC,IAAc,UAAmB;AAC/B,SAAO,KAAK,aAAa;;CAG3B,IAAc,WAAoB;AAChC,SAAO,KAAK,SAAS;;CASvB,+BAGE;AACA,SAAO,EACL,UAAU,KAAK,UAChB;;CAGH,oBAA0C;AAIxC,EAHA,MAAM,mBAAmB,EAGzB,KAAK,iBAAiB,SAAS,KAAK,aAAa,GAAK;;CAGxD,uBAA6C;AAE3C,EADA,KAAK,oBAAoB,SAAS,KAAK,aAAa,GAAK,EACzD,MAAM,sBAAsB;;CAiB9B,OAA0B,GAAyC;;AAEjE,EADA,MAAM,OAAO,EAAkB,GAC/B,IAAI,OAAO,UAAA,QAAA,EAAO,SACZ,KAAK,WAAW,CAAC,KAAK,YAAY,CAAC,KAAK,mBAC1C,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,0FACnB,qFACA,EAAE,QAAQ,CAAC,mBAAmB,EAAE,CACjC;;;6BAhH6C;CAClD,GAAG,EAAgB;CACnB,gBAAgB;CACjB,KAiBA,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAO1C,EAAS;CAAE,MAAM;CAAQ,WAAW;CAAoB,CAAC,CAAA,EAAA,EAAA,WAAA,mBAAA,KAAA,EAAA"}

package/dist/components/card/Card.base.d.ts

@@ -1,5 +1,6 @@
 import { PropertyValues } from 'lit';
 import { SpectrumElement } from '../../element/index.js';
+import { SlotTextController } from '../../controllers/slot-text-controller/index.js';
 import { CardDensity, CardVariant } from './Card.types.js';
 declare const CardBase_base: typeof SpectrumElement & {
     new (...args: any[]): import('../../mixins/index.js').SizedElementInterface;
@@ -9,20 +10,31 @@ declare const CardBase_base: typeof SpectrumElement & {
  * Abstract base class for all card-family components. Owns the semantics
  * shared across every card type: sizing, visual variant, and density.
  *
- * `swc-card`, `swc-user-card`, and `swc-product-card` each extend this base
- * directly and render the shared anatomy via `renderCardTemplate()` in
- * `swc/components/card/card-template.ts`. That template also carries a
- * collection placeholder and an avatar/thumbnail glyph, each supplied
- * per-component via `renderCollection`/`renderGlyph`.
- *
  * @attribute {ElementSize} size - The size of the card.
  *
+ * @fires swc-card-click - Dispatched when a `selectable` card is activated (click, Enter, or Space).
+ *
  * @slot preview - Primary preview content
  * @slot title - Card title
  * @slot actions - Optional action controls
  * @slot description - Supporting description text
  * @slot footer - Optional footer content
  * @slot - Additional body content
+ *
+ * @cssprop --swc-card-base-max-inline-size - Maximum inline size of the card. Defaults to 280px, overridden per size.
+ * @cssprop --swc-card-base-border-radius - Corner radius of the card. Defaults to the extra-large corner-radius token, overridden per size.
+ * @cssprop --swc-card-base-box-shadow - Box shadow (elevation) of the card. Defaults to the emphasized drop-shadow token; overridden by the tertiary variant, selectable focus, and title-as-link/selectable hover.
+ * @cssprop --swc-card-base-background-color - Background color of the card. Defaults to the layer-2 background token; overridden by the secondary, tertiary, and quiet variants.
+ * @cssprop --swc-card-base-preview-aspect-ratio - Aspect ratio of the preview slot. Defaults to 3/2.
+ * @cssprop --swc-card-base-title-font-size - Font size of the title slot. Defaults to the medium font-size token, overridden per size.
+ * @cssprop --swc-card-base-title-line-height - Line height of the title slot. Defaults to the medium line-height token, overridden per size.
+ * @cssprop --swc-card-base-description-font-size - Font size of the description slot and default slot content. Defaults to a smaller font-size token, overridden per size.
+ * @cssprop --swc-card-base-action-component-height - Height used to vertically balance slotted actions content. Defaults to the smallest component-height token, overridden per size.
+ * @cssprop --swc-card-base-content-header-gap - Column gap between the title and actions slots. Defaults to the medium base-gap token, overridden per size.
+ * @cssprop --swc-card-base-content-padding - Padding of the content region. Defaults to the medium container-padding token; overridden by density.
+ * @cssprop --swc-card-base-content-padding-regular - Content padding used at the default (regular) density, per size.
+ * @cssprop --swc-card-base-content-padding-compact - Content padding used at compact density, per size.
+ * @cssprop --swc-card-base-content-padding-spacious - Content padding used at spacious density, per size.
  */
 export declare abstract class CardBase extends CardBase_base {
     /**
@@ -48,75 +60,111 @@ export declare abstract class CardBase extends CardBase_base {
     /**
      * Indicates the consumer has wrapped their `title` slot content in a real
      * link. Extends that link's hit area to cover the card surface while
-     * leaving navigation entirely consumer-owned — Card accepts no `href`.
-     *
-     * @todo Naming, and the `::slotted(a)::after` vs. click-proxy mechanism,
-     * are still open. See the card family plan, A11y-3 / Q2.
+     * leaving navigation entirely consumer-owned; Card accepts no `href`.
      */
     titleAsLink: boolean;
     /**
      * Makes the card focusable and captures surface clicks (excluding nested
      * interactive targets) to dispatch a `swc-card-click` event, independent
-     * of `titleAsLink`. Lays groundwork for a future `CardView` selection
-     * model without Card owning selected-state UI itself.
+     * of `titleAsLink`.
      *
-     * @todo Event name and `tabindex` management details are still open. See
-     * the card family plan, A11y-3 / Q3.
-     * @todo No `role` is set when `selectable` is true — deferred rather than
-     * defaulting to `role="button"`, since the eventual `CardView` selection
-     * model may call for a different role (e.g. `option`/`gridcell`) that
-     * `role="button"` would be wrong to have committed to today. See the card
-     * family plan, A11y-3 / Q8.
+     * @todo No ARIA role is set yet; deferred until a future `CardView`
+     * selection model determines the appropriate role.
      */
     selectable: boolean;
+    /**
+     * Keeps a slotted action control's `size` one step smaller than the
+     * card's own `size`.
+     */
+    private readonly _sizePropagation;
+    /**
+     * Observes whether the default slot has meaningful content. Each concrete
+     * card's `render()` must bind `@slotchange=${this.slotText.handleSlotChange}`
+     * on the default slot (via `renderCardTemplate`'s `onDefaultSlotChange`) for
+     * changes after the first render to be tracked.
+     *
+     * @internal
+     */
+    protected slotText: SlotTextController;
+    /**
+     * Whether the default slot has meaningful content. Consumed by each concrete
+     * card's `render()` (through `renderCardTemplate`'s `hasDefaultSlotContent`)
+     * to toggle the `--hasDefault` class.
+     *
+     * @internal
+     */
+    protected get slotHasContent(): boolean;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    protected firstUpdated(changedProperties: PropertyValues): void;
     protected updated(changedProperties: PropertyValues): void;
     /**
      * @internal
-     * The card's own `title` slot element, or `null` before the concrete
-     * class's `renderCardTemplate()` call has rendered.
+     *
+     * The card's own `title` slot element.
      */
     protected getTitleSlotElement(): HTMLSlotElement | null;
     /**
      * @internal
-     * The `title` slot's link, supporting both forms consumers reasonably
-     * use: the assigned element itself is the anchor (`<a slot="title"
-     * href="...">`), or the anchor is nested inside a wrapper (`<span
-     * slot="title"><a href="...">`). Requires `href` — a link with no
-     * destination can't usefully be clicked-through.
+     *
+     * The card's own `actions` slot element.
+     */
+    protected getActionsSlotElement(): HTMLSlotElement | null;
+    /**
+     * Whether the `actions` slot is supported for this card's current state.
+     * `xs` cards don't have room for it. Concrete classes may override this
+     * to exclude the slot for other reasons, independent of size.
+     */
+    protected get actionsSupported(): boolean;
+    /**
+     * @internal
+     *
+     * Warns in dev mode when the `actions` slot has content but isn't
+     * supported for the current state. Visual suppression is handled in
+     * CSS, not here.
+     */
+    private checkActionsSupport;
+    /**
+     * @internal
+     *
+     * The `title` slot's link: either the assigned element itself
+     * (`<a slot="title" href="...">`) or an anchor nested inside a wrapper
+     * (`<span slot="title"><a href="...">`). Requires `href`.
      */
     protected getTitleLinkElement(): HTMLAnchorElement | null;
     /**
      * @internal
-     * Whether `node` provides its own interaction/focus semantics. Checking
-     * the `tabIndex` IDL property (rather than the `tabindex` attribute or a
-     * tag-name list) correctly covers natively-interactive elements
-     * (`button`, `input`, `select`, `textarea`, `a[href]`) with no explicit
-     * attribute, excludes `tabindex="-1"` (focusable for scripting, not a
-     * click target) and disabled controls, and works for a custom element's
-     * internal shadow-DOM control too — `composedPath()` already traverses
-     * into other elements' shadow roots for composed events like `click`, so
-     * an internal `<button>` inside e.g. `<swc-button>` is inspected directly
-     * regardless of which shadow tree it belongs to.
+     *
+     * Whether `node` has its own interaction/focus semantics, via the
+     * `tabIndex` IDL property rather than the `tabindex` attribute; this
+     * also correctly excludes `tabindex="-1"` and disabled controls.
      */
     private static isFocusable;
+    /**
+     * @internal
+     *
+     * The size one step below `size` in `CARD_VALID_SIZES`, clamped at the
+     * smallest size.
+     */
+    private static getSmallerSize;
+    /**
+     * Re-propagates the `actions` slot's `size` for elements assigned after
+     * the initial render, wired to the slot's `slotchange` in
+     * `firstUpdated()`.
+     */
+    protected readonly handleActionsSlotChange: () => void;
     /**
      * Proxies a qualifying surface click to `titleAsLink`'s link and/or
      * dispatches `swc-card-click` for `selectable`, after filtering out
-     * clicks that landed on a nested interactive target (see `isFocusable()`
-     * and the `actions`-slot exclusion above).
+     * clicks that landed on a nested interactive target or followed a
+     * text-selection drag.
      */
     protected readonly handleSurfaceClick: (event: Event) => void;
     /**
-     * `tabindex` is only ever added alongside this listener (see `updated()`)
-     * and removed alongside its removal — a focusable card is never left
-     * without keyboard activation. Enter and Space are treated identically
-     * and both proxy to `titleAsLink`'s link when set, even though a bare
-     * link conventionally responds to Enter only: the card's own activation
-     * contract (Enter+Space, more button-like) is authoritative once
-     * `selectable` makes the card itself the focused target, regardless of
-     * what that activation happens to proxy to.
+     * Enter and Space both activate the card, even though a bare link
+     * conventionally responds to Enter only; the card's own activation
+     * contract takes precedence once `selectable` makes it the focused
+     * target.
      */
     protected readonly handleSelectableKeydown: (event: KeyboardEvent) => void;
 }