@adobe/spectrum-wc-core 0.0.0-snapshot.20260922095923

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

@@ -0,0 +1,78 @@
+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').SizedElementInterface;
+    prototype: import('../../mixins/index.js').SizedElementInterface;
+} & import('../../mixins/index.js').SizedElementConstructor;
+/**
+ * Abstract base class for all button-like components. Owns shared semantic
+ * concerns: interaction state, sizing, slot-derived icon/label state,
+ * accessible-name resolution, and host-to-internal-button attribute forwarding.
+ *
+ * Visual API specific to `sp-button` (`variant`, `fill-style`, `static-color`)
+ * is intentionally absent so that ActionButton, ClearButton, CloseButton,
+ * PickerButton, and InfieldButton can extend this base without inheriting
+ * the `swc-button` visual surface.
+ *
+ * @attribute {ElementSize} size - The size of the button.
+ */
+export declare abstract class ButtonBase extends ButtonBase_base {
+    static shadowRootOptions: ShadowRootInit;
+    /**
+     * The size of the button.
+     *
+     * @default m
+     */
+    size: ButtonSize;
+    /**
+     * Whether the button is disabled. Removes focusability and prevents
+     * interaction.
+     */
+    disabled: boolean;
+    /**
+     * Accessible label forwarded to the internal `<button>` element as
+     * `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;
+    /**
+     * Returns the set of attributes that should be forwarded to the internal
+     * semantic `<button>` element, if not otherwise directly managed.
+     *
+     * @internal
+     */
+    protected getForwardedButtonAttributes(): Record<string, string | boolean | undefined>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * 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
+     * listener (capture) and inner `@click` binding both call this handler.
+     */
+    protected readonly handleClick: (event: Event) => void;
+    protected update(changedProperties: PropertyValues): void;
+}
+export {};

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

@@ -0,0 +1,51 @@
+import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
+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 { 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 c, l = class extends i(r, { validSizes: t }) {
+	constructor(...e) {
+		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.slotPresence.isPresent;
+	}
+	get hasLabel() {
+		return this.slotText.hasContent;
+	}
+	getForwardedButtonAttributes() {
+		return { disabled: this.disabled };
+	}
+	connectedCallback() {
+		super.connectedCallback(), this.addEventListener("click", this.handleClick, !0);
+	}
+	disconnectedCallback() {
+		this.removeEventListener("click", this.handleClick, !0), super.disconnectedCallback();
+	}
+	update(e) {
+		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"]
+		});
+	}
+};
+c = l, c.shadowRootOptions = {
+	...r.shadowRootOptions,
+	delegatesFocus: !0
+}, e([n({
+	type: Boolean,
+	reflect: !0
+})], l.prototype, "disabled", void 0), e([n({
+	type: String,
+	attribute: "accessible-label"
+})], l.prototype, "accessibleLabel", void 0);
+//#endregion
+export { l as ButtonBase };
+
+//# sourceMappingURL=Button.base.js.map

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

@@ -0,0 +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 { 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 { warnIf } from '@adobe/spectrum-wc-core/utils/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`, or externally\n   * marked `aria-disabled` (e.g. by a disabled parent `swc-action-group`,\n   * which uses `aria-disabled` instead of native `disabled` so children\n   * remain keyboard-reachable).\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 || this.getAttribute('aria-disabled') === 'true') {\n      event.preventDefault();\n      event.stopImmediatePropagation();\n    }\n  };\n\n  protected override update(changedProperties: PropertyValues): void {\n    super.update(changedProperties);\n    warnIf(\n      this,\n      this.hasIcon && !this.hasLabel && !this.accessibleLabel,\n      `<${this.localName}> with an icon and no label must have an \"accessible-label\" attribute to be accessible.`,\n      'https://spectrum-web-components.adobe.com/?path=/docs/components-button--docs',\n      { type: 'accessibility', issues: ['accessible-label'] }\n    );\n  }\n}\n"],"mappings":";;;;;;;;;OAmCsB,IAAtB,cAAyC,EAAW,GAAiB,EACnE,YAAY,GACb,CAAC,CAAC;;+BAsB0B,wBAkBF,IAAI,EAAuB,MAAM,kBAAgB,kBASrD,IAAI,EAAmB,KAAK,sBAmDf,MAAuB;AACvD,IAAI,KAAK,YAAY,KAAK,aAAa,gBAAgB,KAAK,YAC1D,EAAM,gBAAgB,EACtB,EAAM,0BAA0B;;;CAhDpC,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;;CAoB9B,OAA0B,GAAyC;AAEjE,EADA,MAAM,OAAO,EAAkB,EAC/B,EACE,MACA,KAAK,WAAW,CAAC,KAAK,YAAY,CAAC,KAAK,iBACxC,IAAI,KAAK,UAAU,0FACnB,iFACA;GAAE,MAAM;GAAiB,QAAQ,CAAC,mBAAmB;GAAE,CACxD;;;6BAlHiD;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/button/Button.types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 BUTTON_VALID_SIZES: readonly ["s", "m", "l", "xl"];
+export declare const BUTTON_VARIANTS: readonly ["primary", "secondary", "accent", "negative"];
+export declare const BUTTON_FILL_STYLES: readonly ["fill", "outline"];
+export declare const BUTTON_STATIC_COLORS: readonly ["white", "black"];
+export type ButtonSize = (typeof BUTTON_VALID_SIZES)[number];
+export type ButtonVariant = (typeof BUTTON_VARIANTS)[number];
+export type ButtonFillStyle = (typeof BUTTON_FILL_STYLES)[number];
+export type ButtonStaticColor = (typeof BUTTON_STATIC_COLORS)[number];

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

@@ -0,0 +1,16 @@
+//#region components/button/Button.types.ts
+var e = [
+	"s",
+	"m",
+	"l",
+	"xl"
+], t = [
+	"primary",
+	"secondary",
+	"accent",
+	"negative"
+], n = ["fill", "outline"], r = ["white", "black"];
+//#endregion
+export { n as BUTTON_FILL_STYLES, r as BUTTON_STATIC_COLORS, e as BUTTON_VALID_SIZES, t as BUTTON_VARIANTS };
+
+//# sourceMappingURL=Button.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Button.types.js","names":[],"sources":["../../../components/button/Button.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 BUTTON_VALID_SIZES = [\n  's',\n  'm',\n  'l',\n  'xl',\n] as const satisfies readonly ElementSize[];\n\nexport const BUTTON_VARIANTS = [\n  'primary',\n  'secondary',\n  'accent',\n  'negative',\n] as const;\n\nexport const BUTTON_FILL_STYLES = ['fill', 'outline'] as const;\n\nexport const BUTTON_STATIC_COLORS = ['white', 'black'] as const;\n\n// ──────────────────\n//     TYPES\n// ──────────────────\n\nexport type ButtonSize = (typeof BUTTON_VALID_SIZES)[number];\nexport type ButtonVariant = (typeof BUTTON_VARIANTS)[number];\nexport type ButtonFillStyle = (typeof BUTTON_FILL_STYLES)[number];\nexport type ButtonStaticColor = (typeof BUTTON_STATIC_COLORS)[number];\n"],"mappings":";AAkBA,IAAa,IAAqB;CAChC;CACA;CACA;CACA;CACD,EAEY,IAAkB;CAC7B;CACA;CACA;CACA;CACD,EAEY,IAAqB,CAAC,QAAQ,UAAU,EAExC,IAAuB,CAAC,SAAS,QAAQ"}

package/dist/components/button/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 './Button.base.js';
+export * from './Button.types.js';

package/dist/components/button/index.js

@@ -0,0 +1,3 @@
+import { BUTTON_FILL_STYLES as e, BUTTON_STATIC_COLORS as t, BUTTON_VALID_SIZES as n, BUTTON_VARIANTS as r } from "./Button.types.js";
+import { ButtonBase as i } from "./Button.base.js";
+export { e as BUTTON_FILL_STYLES, t as BUTTON_STATIC_COLORS, n as BUTTON_VALID_SIZES, r as BUTTON_VARIANTS, i as ButtonBase };

package/dist/components/button-group/ButtonGroup.base.d.ts

@@ -0,0 +1,89 @@
+import { PropertyValues } from 'lit';
+import { SpectrumElement } from '../../element/index.js';
+import { ButtonGroupAlignment, ButtonGroupOrientation, ButtonGroupSize } from './ButtonGroup.types.js';
+declare const ButtonGroupBase_base: typeof SpectrumElement & {
+    new (...args: any[]): import('../../mixins/index.js').SizedElementInterface;
+    prototype: import('../../mixins/index.js').SizedElementInterface;
+} & import('../../mixins/index.js').SizedElementConstructor;
+/**
+ * A button group clusters related actions together, providing consistent
+ * spacing, sizing, and orientation. The host exposes `role="group"` and
+ * propagates `size` and `disabled` to slotted button children.
+ *
+ * This base class owns shared logic and accessibility semantics. Rendering
+ * and styling live in the concrete SWC subclass.
+ *
+ * @slot - One or more `swc-button` elements.
+ *
+ * @attribute {ElementSize} size - The size of the button group and its children.
+ */
+export declare abstract class ButtonGroupBase extends ButtonGroupBase_base {
+    /**
+     * The size of the button group. Propagated to all slotted button children.
+     *
+     * @default m
+     */
+    size: ButtonGroupSize;
+    /**
+     * @internal
+     *
+     * Valid orientation values for validation.
+     */
+    static readonly ORIENTATIONS: readonly string[];
+    /**
+     * @internal
+     *
+     * Valid alignment values for validation.
+     */
+    static readonly ALIGNMENTS: readonly string[];
+    /**
+     * The layout direction of the button group.
+     *
+     * Note: this property does NOT set `aria-orientation` on the host because
+     * `aria-orientation` is only meaningful for roles that manage arrow-key
+     * navigation (e.g. `toolbar`, `listbox`). Since button-group uses
+     * sequential Tab navigation (not roving tabindex), the attribute would
+     * be invalid.
+     */
+    orientation: ButtonGroupOrientation;
+    /**
+     * Whether all buttons in the group are disabled. When `true`, forces
+     * every slotted button child to `disabled`. When `false`, children
+     * retain their individual disabled state — a button slotted with
+     * `disabled` remains disabled even when the group is enabled.
+     */
+    disabled: boolean;
+    /**
+     * The alignment of buttons within the group along the main axis.
+     */
+    align: ButtonGroupAlignment;
+    private buttons;
+    /**
+     * Tracks buttons that were individually disabled before the group
+     * forced all children disabled. Used to restore their state when
+     * the group becomes enabled again.
+     */
+    private individuallyDisabled;
+    private readonly _sizePropagation;
+    protected firstUpdated(changed: PropertyValues<this>): void;
+    protected update(changedProperties: PropertyValues): void;
+    protected updated(changed: PropertyValues<this>): void;
+    /**
+     * Handles slotchange events from the default slot. Ensures newly slotted
+     * children receive the current size and disabled state.
+     */
+    protected handleSlotchange(): void;
+    /**
+     * Propagates disabled state to slotted button children.
+     *
+     * Uses a one-directional model: when the group is disabled, all children
+     * are forced disabled (tracking which were already individually disabled).
+     * When the group is enabled, children are restored to their individual
+     * disabled state — a button slotted with `disabled` remains disabled.
+     *
+     * On slotchange when the group is enabled, buttons are not touched so
+     * their declarative `disabled` attribute is preserved.
+     */
+    private propagateDisabledToChildren;
+}
+export {};

package/dist/components/button-group/ButtonGroup.base.js

@@ -0,0 +1,60 @@
+import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
+import { SlotAttributePropagationController as t } from "../../controllers/slot-attribute-propagation-controller/src/slot-attribute-propagation-controller.js";
+import { BUTTON_GROUP_ALIGNMENTS as n, BUTTON_GROUP_ORIENTATIONS as r, BUTTON_GROUP_SIZES as i } from "./ButtonGroup.types.js";
+import { property as a, queryAssignedElements as o } from "lit/decorators.js";
+import { SpectrumElement as s } from "@adobe/spectrum-wc-core/element/index.js";
+import { SizedMixin as c } from "@adobe/spectrum-wc-core/mixins/index.js";
+import { validateEnum as l } from "@adobe/spectrum-wc-core/utils/index.js";
+//#region components/button-group/ButtonGroup.base.ts
+var u, d = class extends c(s, { validSizes: i }) {
+	constructor(...e) {
+		super(...e), this.orientation = "horizontal", this.disabled = !1, this.align = "start", this.individuallyDisabled = /* @__PURE__ */ new WeakSet(), this._sizePropagation = new t(this, {
+			attribute: "size",
+			getValue: () => this.size
+		});
+	}
+	firstUpdated(e) {
+		super.firstUpdated(e), this.setAttribute("role", "group");
+	}
+	update(e) {
+		let t = this.constructor;
+		l(this, {
+			prop: "orientation",
+			value: this.orientation,
+			valid: t.ORIENTATIONS,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-button-group--docs"
+		}), l(this, {
+			prop: "align",
+			value: this.align,
+			valid: t.ALIGNMENTS,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-button-group--docs"
+		}), super.update(e);
+	}
+	updated(e) {
+		if (super.updated(e), e.has("disabled")) {
+			let t = e.get("disabled");
+			(this.disabled || t) && this.propagateDisabledToChildren();
+		}
+	}
+	handleSlotchange() {
+		this._sizePropagation.propagate(), this.disabled && this.propagateDisabledToChildren();
+	}
+	propagateDisabledToChildren() {
+		for (let e of this.buttons) this.disabled ? (e.disabled && this.individuallyDisabled.add(e), e.disabled = !0) : e.disabled = this.individuallyDisabled.has(e);
+		this.disabled || (this.individuallyDisabled = /* @__PURE__ */ new WeakSet());
+	}
+};
+u = d, u.ORIENTATIONS = r, u.ALIGNMENTS = n, e([a({
+	type: String,
+	reflect: !0
+})], d.prototype, "orientation", void 0), e([a({
+	type: Boolean,
+	reflect: !0
+})], d.prototype, "disabled", void 0), e([a({
+	type: String,
+	reflect: !0
+})], d.prototype, "align", void 0), e([o({ flatten: !0 })], d.prototype, "buttons", void 0);
+//#endregion
+export { d as ButtonGroupBase };
+
+//# sourceMappingURL=ButtonGroup.base.js.map

package/dist/components/button-group/ButtonGroup.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonGroup.base.js","names":[],"sources":["../../../components/button-group/ButtonGroup.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, queryAssignedElements } from 'lit/decorators.js';\n\nimport type { ButtonBase } from '@adobe/spectrum-wc-core/components/button';\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { SizedMixin } from '@adobe/spectrum-wc-core/mixins/index.js';\nimport { validateEnum } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport { SlotAttributePropagationController } from '../../controllers/slot-attribute-propagation-controller/index.js';\nimport {\n  BUTTON_GROUP_ALIGNMENTS,\n  BUTTON_GROUP_ORIENTATIONS,\n  BUTTON_GROUP_SIZES,\n  type ButtonGroupAlignment,\n  type ButtonGroupOrientation,\n  type ButtonGroupSize,\n} from './ButtonGroup.types.js';\n\n/**\n * A button group clusters related actions together, providing consistent\n * spacing, sizing, and orientation. The host exposes `role=\"group\"` and\n * propagates `size` and `disabled` to slotted button children.\n *\n * This base class owns shared logic and accessibility semantics. Rendering\n * and styling live in the concrete SWC subclass.\n *\n * @slot - One or more `swc-button` elements.\n *\n * @attribute {ElementSize} size - The size of the button group and its children.\n */\nexport abstract class ButtonGroupBase extends SizedMixin(SpectrumElement, {\n  validSizes: BUTTON_GROUP_SIZES,\n}) {\n  /**\n   * The size of the button group. Propagated to all slotted button children.\n   *\n   * @default m\n   */\n  declare public size: ButtonGroupSize;\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * @internal\n   *\n   * Valid orientation values for validation.\n   */\n  static readonly ORIENTATIONS: readonly string[] = BUTTON_GROUP_ORIENTATIONS;\n\n  /**\n   * @internal\n   *\n   * Valid alignment values for validation.\n   */\n  static readonly ALIGNMENTS: readonly string[] = BUTTON_GROUP_ALIGNMENTS;\n\n  /**\n   * The layout direction of the button group.\n   *\n   * Note: this property does NOT set `aria-orientation` on the host because\n   * `aria-orientation` is only meaningful for roles that manage arrow-key\n   * navigation (e.g. `toolbar`, `listbox`). Since button-group uses\n   * sequential Tab navigation (not roving tabindex), the attribute would\n   * be invalid.\n   */\n  @property({ type: String, reflect: true })\n  public orientation: ButtonGroupOrientation = 'horizontal';\n\n  /**\n   * Whether all buttons in the group are disabled. When `true`, forces\n   * every slotted button child to `disabled`. When `false`, children\n   * retain their individual disabled state — a button slotted with\n   * `disabled` remains disabled even when the group is enabled.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled = false;\n\n  /**\n   * The alignment of buttons within the group along the main axis.\n   */\n  @property({ type: String, reflect: true })\n  public align: ButtonGroupAlignment = 'start';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  @queryAssignedElements({ flatten: true })\n  private buttons!: ButtonBase[];\n\n  /**\n   * Tracks buttons that were individually disabled before the group\n   * forced all children disabled. Used to restore their state when\n   * the group becomes enabled again.\n   */\n  private individuallyDisabled = new WeakSet<ButtonBase>();\n\n  private readonly _sizePropagation = new SlotAttributePropagationController(\n    this,\n    {\n      attribute: 'size',\n      getValue: () => this.size,\n    }\n  );\n\n  protected override firstUpdated(changed: PropertyValues<this>): void {\n    super.firstUpdated(changed);\n    this.setAttribute('role', 'group');\n  }\n\n  protected override update(changedProperties: PropertyValues): void {\n    const constructor = this.constructor as typeof ButtonGroupBase;\n    validateEnum(this, {\n      prop: 'orientation',\n      value: this.orientation,\n      valid: constructor.ORIENTATIONS,\n      url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-button-group--docs',\n    });\n    validateEnum(this, {\n      prop: 'align',\n      value: this.align,\n      valid: constructor.ALIGNMENTS,\n      url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-button-group--docs',\n    });\n    super.update(changedProperties);\n  }\n\n  protected override updated(changed: PropertyValues<this>): void {\n    super.updated(changed);\n\n    if (changed.has('disabled')) {\n      const wasDisabled = changed.get('disabled');\n      if (this.disabled || wasDisabled) {\n        this.propagateDisabledToChildren();\n      }\n    }\n  }\n\n  /**\n   * Handles slotchange events from the default slot. Ensures newly slotted\n   * children receive the current size and disabled state.\n   */\n  protected handleSlotchange(): void {\n    this._sizePropagation.propagate();\n\n    if (this.disabled) {\n      this.propagateDisabledToChildren();\n    }\n  }\n\n  /**\n   * Propagates disabled state to slotted button children.\n   *\n   * Uses a one-directional model: when the group is disabled, all children\n   * are forced disabled (tracking which were already individually disabled).\n   * When the group is enabled, children are restored to their individual\n   * disabled state — a button slotted with `disabled` remains disabled.\n   *\n   * On slotchange when the group is enabled, buttons are not touched so\n   * their declarative `disabled` attribute is preserved.\n   */\n  private propagateDisabledToChildren(): void {\n    for (const button of this.buttons) {\n      if (this.disabled) {\n        if (button.disabled) {\n          this.individuallyDisabled.add(button);\n        }\n        button.disabled = true;\n      } else {\n        button.disabled = this.individuallyDisabled.has(button);\n      }\n    }\n\n    if (!this.disabled) {\n      this.individuallyDisabled = new WeakSet();\n    }\n  }\n}\n"],"mappings":";;;;;;;;OA0CsB,IAAtB,cAA8C,EAAW,GAAiB,EACxE,YAAY,GACb,CAAC,CAAC;;kCAoC4C,8BAS3B,iBAMmB,qDAcN,IAAI,SAAqB,0BAEpB,IAAI,EACtC,MACA;GACE,WAAW;GACX,gBAAgB,KAAK;GACtB,CACF;;CAED,aAAgC,GAAqC;AAEnE,EADA,MAAM,aAAa,EAAQ,EAC3B,KAAK,aAAa,QAAQ,QAAQ;;CAGpC,OAA0B,GAAyC;EACjE,IAAM,IAAc,KAAK;AAazB,EAZA,EAAa,MAAM;GACjB,MAAM;GACN,OAAO,KAAK;GACZ,OAAO,EAAY;GACnB,KAAK;GACN,CAAC,EACF,EAAa,MAAM;GACjB,MAAM;GACN,OAAO,KAAK;GACZ,OAAO,EAAY;GACnB,KAAK;GACN,CAAC,EACF,MAAM,OAAO,EAAkB;;CAGjC,QAA2B,GAAqC;AAG9D,MAFA,MAAM,QAAQ,EAAQ,EAElB,EAAQ,IAAI,WAAW,EAAE;GAC3B,IAAM,IAAc,EAAQ,IAAI,WAAW;AAC3C,IAAI,KAAK,YAAY,MACnB,KAAK,6BAA6B;;;CASxC,mBAAmC;AAGjC,EAFA,KAAK,iBAAiB,WAAW,EAE7B,KAAK,YACP,KAAK,6BAA6B;;CAetC,8BAA4C;AAC1C,OAAK,IAAM,KAAU,KAAK,QACxB,CAAI,KAAK,YACH,EAAO,YACT,KAAK,qBAAqB,IAAI,EAAO,EAEvC,EAAO,WAAW,MAElB,EAAO,WAAW,KAAK,qBAAqB,IAAI,EAAO;AAI3D,EAAK,KAAK,aACR,KAAK,uCAAuB,IAAI,SAAS;;;wBA/HK,kBAOF,MAW/C,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,eAAA,KAAA,EAAA,KASzC,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAM1C,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA,KAOzC,EAAsB,EAAE,SAAS,IAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA"}

package/dist/components/button-group/ButtonGroup.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 BUTTON_GROUP_SIZES: readonly ["s", "m", "l", "xl"];
+export declare const BUTTON_GROUP_ORIENTATIONS: readonly ["horizontal", "vertical"];
+export declare const BUTTON_GROUP_ALIGNMENTS: readonly ["start", "center", "end"];
+export type ButtonGroupSize = (typeof BUTTON_GROUP_SIZES)[number];
+export type ButtonGroupOrientation = (typeof BUTTON_GROUP_ORIENTATIONS)[number];
+export type ButtonGroupAlignment = (typeof BUTTON_GROUP_ALIGNMENTS)[number];

package/dist/components/button-group/ButtonGroup.types.js

@@ -0,0 +1,15 @@
+//#region components/button-group/ButtonGroup.types.ts
+var e = [
+	"s",
+	"m",
+	"l",
+	"xl"
+], t = ["horizontal", "vertical"], n = [
+	"start",
+	"center",
+	"end"
+];
+//#endregion
+export { n as BUTTON_GROUP_ALIGNMENTS, t as BUTTON_GROUP_ORIENTATIONS, e as BUTTON_GROUP_SIZES };
+
+//# sourceMappingURL=ButtonGroup.types.js.map

package/dist/components/button-group/ButtonGroup.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonGroup.types.js","names":[],"sources":["../../../components/button-group/ButtonGroup.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 BUTTON_GROUP_SIZES = [\n  's',\n  'm',\n  'l',\n  'xl',\n] as const satisfies readonly ElementSize[];\n\nexport const BUTTON_GROUP_ORIENTATIONS = ['horizontal', 'vertical'] as const;\n\nexport const BUTTON_GROUP_ALIGNMENTS = ['start', 'center', 'end'] as const;\n\n// ──────────────────\n// TYPES\n// ──────────────────\n\nexport type ButtonGroupSize = (typeof BUTTON_GROUP_SIZES)[number];\nexport type ButtonGroupOrientation = (typeof BUTTON_GROUP_ORIENTATIONS)[number];\nexport type ButtonGroupAlignment = (typeof BUTTON_GROUP_ALIGNMENTS)[number];\n"],"mappings":";AAkBA,IAAa,IAAqB;CAChC;CACA;CACA;CACA;CACD,EAEY,IAA4B,CAAC,cAAc,WAAW,EAEtD,IAA0B;CAAC;CAAS;CAAU;CAAM"}

package/dist/components/button-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 './ButtonGroup.base.js';
+export * from './ButtonGroup.types.js';

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

@@ -0,0 +1,3 @@
+import { BUTTON_GROUP_ALIGNMENTS as e, BUTTON_GROUP_ORIENTATIONS as t, BUTTON_GROUP_SIZES as n } from "./ButtonGroup.types.js";
+import { ButtonGroupBase as r } from "./ButtonGroup.base.js";
+export { e as BUTTON_GROUP_ALIGNMENTS, t as BUTTON_GROUP_ORIENTATIONS, n as BUTTON_GROUP_SIZES, r as ButtonGroupBase };

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

@@ -0,0 +1,172 @@
+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;
+    prototype: import('../../mixins/index.js').SizedElementInterface;
+} & import('../../mixins/index.js').SizedElementConstructor;
+/**
+ * Abstract base class for all card-family components. Owns the semantics
+ * shared across every card type: sizing, visual variant, and density.
+ *
+ * @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 {
+    /**
+     * @internal
+     */
+    static readonly VARIANTS: readonly CardVariant[];
+    /**
+     * @internal
+     */
+    static readonly DENSITIES: readonly CardDensity[];
+    /**
+     * The visual variant of the card.
+     *
+     * @default primary
+     */
+    variant: CardVariant;
+    /**
+     * The density of the card, controlling internal spacing and gaps.
+     *
+     * @default regular
+     */
+    density: CardDensity;
+    /**
+     * 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`.
+     */
+    titleAsLink: boolean;
+    /**
+     * Makes the card focusable and captures surface clicks (excluding nested
+     * interactive targets) to dispatch a `swc-card-click` event, independent
+     * of `titleAsLink`.
+     *
+     * @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 update(changedProperties: PropertyValues): void;
+    protected updated(changedProperties: PropertyValues): void;
+    /**
+     * @internal
+     *
+     * The card's own `title` slot element.
+     */
+    protected getTitleSlotElement(): HTMLSlotElement | null;
+    /**
+     * @internal
+     *
+     * 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` 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 or followed a
+     * text-selection drag.
+     */
+    protected readonly handleSurfaceClick: (event: Event) => void;
+    /**
+     * 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;
+}
+export {};