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

package/dist/components/icon/Icon.base.d.ts

@@ -6,9 +6,16 @@ declare const IconBase_base: typeof SpectrumElement & {
     prototype: import('../../mixins/index.js').SizedElementInterface;
 } & import('../../mixins/index.js').SizedElementConstructor;
 /**
- * An icon renderer that displays slotted SVG markup.
+ * Shared behavior for icon elements: the `size` scale, the `accessibleLabel`, and
+ * host-owned accessibility. Concrete elements own their own `render()` and styles;
+ * this base carries no template and no CSS.
  *
- * @attribute {string} label - Accessible label for the icon.
+ * The host owns semantics: when `accessibleLabel` is set the host is exposed as an
+ * image (`role="img"` with that label); when empty (the default) the host is marked
+ * `aria-hidden` and the icon is decorative. The rendered or slotted SVG is never
+ * given its own role, avoiding double-announcement.
+ *
+ * @attribute {string} accessible-label - Accessible label for the icon.
  * @attribute {string} size - T-shirt icon size.
  */
 export declare abstract class IconBase extends IconBase_base {
@@ -19,14 +26,11 @@ export declare abstract class IconBase extends IconBase_base {
      */
     size: (typeof ICON_VALID_SIZES)[number];
     /**
-     * Accessible label for the icon.
+     * Accessible label for the icon. When empty the icon is decorative.
      */
-    label: string;
-    private defaultSlotElements;
+    accessibleLabel: string;
     protected firstUpdated(changedProperties: PropertyValues): void;
     protected updated(changedProperties: PropertyValues): void;
-    protected handleSlotChange(): void;
-    private updateSlottedIcon;
     private updateHostAccessibility;
 }
 export {};

package/dist/components/icon/Icon.base.js

@@ -1,35 +1,28 @@
 import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
 import { ICON_VALID_SIZES as t } from "./Icon.types.js";
-import { property as n, queryAssignedElements as r } from "lit/decorators.js";
-import { SpectrumElement as i } from "@adobe/spectrum-wc-core/element/index.js";
-import { SizedMixin as a } from "@adobe/spectrum-wc-core/mixins/index.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";
 //#region components/icon/Icon.base.ts
-var o = class extends a(i, { validSizes: [...t] }) {
+var a = class extends i(r, { validSizes: [...t] }) {
 	constructor(...e) {
-		super(...e), this.label = "";
+		super(...e), this.accessibleLabel = "";
 	}
 	firstUpdated(e) {
-		super.firstUpdated(e), this.updateSlottedIcon(), this.updateHostAccessibility();
+		super.firstUpdated(e), this.updateHostAccessibility();
 	}
 	updated(e) {
-		super.updated(e), e.has("label") && (this.updateSlottedIcon(), this.updateHostAccessibility());
-	}
-	handleSlotChange() {
-		this.updateSlottedIcon();
-	}
-	updateSlottedIcon() {
-		var e;
-		let [t] = this.defaultSlotElements;
-		if (!t) return;
-		let n = t instanceof SVGElement ? t : (e = t.querySelector) == null ? void 0 : e.call(t, "svg");
-		n && (n.setAttribute("role", "img"), this.label ? (n.setAttribute("aria-label", this.label), n.removeAttribute("aria-hidden")) : (n.setAttribute("aria-hidden", "true"), n.removeAttribute("aria-label")));
+		super.updated(e), e.has("accessibleLabel") && this.updateHostAccessibility();
 	}
 	updateHostAccessibility() {
-		this.label ? this.removeAttribute("aria-hidden") : this.setAttribute("aria-hidden", "true");
+		this.accessibleLabel ? (this.setAttribute("role", "img"), this.setAttribute("aria-label", this.accessibleLabel), this.removeAttribute("aria-hidden")) : (this.removeAttribute("role"), this.removeAttribute("aria-label"), this.setAttribute("aria-hidden", "true"));
 	}
 };
-e([n({ type: String })], o.prototype, "label", void 0), e([r({ flatten: !0 })], o.prototype, "defaultSlotElements", void 0);
+e([n({
+	type: String,
+	attribute: "accessible-label"
+})], a.prototype, "accessibleLabel", void 0);
 //#endregion
-export { o as IconBase };
+export { a as IconBase };
 
 //# sourceMappingURL=Icon.base.js.map

package/dist/components/icon/Icon.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"Icon.base.js","names":[],"sources":["../../../components/icon/Icon.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, queryAssignedElements } 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';\n\nimport { ICON_VALID_SIZES } from './Icon.types.js';\n\n/**\n * An icon renderer that displays slotted SVG markup.\n *\n * @attribute {string} label - Accessible label for the icon.\n * @attribute {string} size - T-shirt icon size.\n */\nexport abstract class IconBase extends SizedMixin(SpectrumElement, {\n  validSizes: [...ICON_VALID_SIZES],\n}) {\n  /**\n   * T-shirt icon size.\n   *\n   * @default m\n   */\n  declare public size: (typeof ICON_VALID_SIZES)[number];\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * Accessible label for the icon.\n   */\n  @property({ type: String })\n  public label = '';\n\n  @queryAssignedElements({ flatten: true })\n  private defaultSlotElements!: Element[];\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override firstUpdated(changedProperties: PropertyValues): void {\n    super.firstUpdated(changedProperties);\n    this.updateSlottedIcon();\n    this.updateHostAccessibility();\n  }\n\n  protected override updated(changedProperties: PropertyValues): void {\n    super.updated(changedProperties);\n    if (changedProperties.has('label')) {\n      this.updateSlottedIcon();\n      this.updateHostAccessibility();\n    }\n  }\n\n  protected handleSlotChange(): void {\n    this.updateSlottedIcon();\n  }\n\n  private updateSlottedIcon(): void {\n    const [slotted] = this.defaultSlotElements;\n    if (!slotted) {\n      return;\n    }\n    const svgElement =\n      slotted instanceof SVGElement ? slotted : slotted.querySelector?.('svg');\n    if (!svgElement) {\n      return;\n    }\n    svgElement.setAttribute('role', 'img');\n    if (this.label) {\n      svgElement.setAttribute('aria-label', this.label);\n      svgElement.removeAttribute('aria-hidden');\n    } else {\n      svgElement.setAttribute('aria-hidden', 'true');\n      svgElement.removeAttribute('aria-label');\n    }\n  }\n\n  private updateHostAccessibility(): void {\n    if (this.label) {\n      this.removeAttribute('aria-hidden');\n    } else {\n      this.setAttribute('aria-hidden', 'true');\n    }\n  }\n}\n"],"mappings":";;;;;;AAyBA,IAAsB,IAAtB,cAAuC,EAAW,GAAiB,EACjE,YAAY,CAAC,GAAG,EAAiB,EAClC,CAAC,CAAC;;4BAgBc;;CASf,aAAgC,GAAyC;AAGvE,EAFA,MAAM,aAAa,EAAkB,EACrC,KAAK,mBAAmB,EACxB,KAAK,yBAAyB;;CAGhC,QAA2B,GAAyC;AAElE,EADA,MAAM,QAAQ,EAAkB,EAC5B,EAAkB,IAAI,QAAQ,KAChC,KAAK,mBAAmB,EACxB,KAAK,yBAAyB;;CAIlC,mBAAmC;AACjC,OAAK,mBAAmB;;CAG1B,oBAAkC;;EAChC,IAAM,CAAC,KAAW,KAAK;AACvB,MAAI,CAAC,EACH;EAEF,IAAM,IACJ,aAAmB,aAAa,KAAA,IAAU,EAAQ,kBAAA,OAAA,KAAA,IAAA,EAAA,KAAA,GAAgB,MAAM;AACrE,QAGL,EAAW,aAAa,QAAQ,MAAM,EAClC,KAAK,SACP,EAAW,aAAa,cAAc,KAAK,MAAM,EACjD,EAAW,gBAAgB,cAAc,KAEzC,EAAW,aAAa,eAAe,OAAO,EAC9C,EAAW,gBAAgB,aAAa;;CAI5C,0BAAwC;AACtC,EAAI,KAAK,QACP,KAAK,gBAAgB,cAAc,GAEnC,KAAK,aAAa,eAAe,OAAO;;;GApD3C,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA,KAG1B,EAAsB,EAAE,SAAS,IAAM,CAAC,CAAA,EAAA,EAAA,WAAA,uBAAA,KAAA,EAAA"}
+{"version":3,"file":"Icon.base.js","names":[],"sources":["../../../components/icon/Icon.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';\n\nimport { ICON_VALID_SIZES } from './Icon.types.js';\n\n/**\n * Shared behavior for icon elements: the `size` scale, the `accessibleLabel`, and\n * host-owned accessibility. Concrete elements own their own `render()` and styles;\n * this base carries no template and no CSS.\n *\n * The host owns semantics: when `accessibleLabel` is set the host is exposed as an\n * image (`role=\"img\"` with that label); when empty (the default) the host is marked\n * `aria-hidden` and the icon is decorative. The rendered or slotted SVG is never\n * given its own role, avoiding double-announcement.\n *\n * @attribute {string} accessible-label - Accessible label for the icon.\n * @attribute {string} size - T-shirt icon size.\n */\nexport abstract class IconBase extends SizedMixin(SpectrumElement, {\n  validSizes: [...ICON_VALID_SIZES],\n}) {\n  /**\n   * T-shirt icon size.\n   *\n   * @default m\n   */\n  declare public size: (typeof ICON_VALID_SIZES)[number];\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * Accessible label for the icon. When empty the icon is decorative.\n   */\n  @property({ type: String, attribute: 'accessible-label' })\n  public accessibleLabel = '';\n\n  // ──────────────────────\n  //     ACCESSIBILITY\n  // ──────────────────────\n\n  protected override firstUpdated(changedProperties: PropertyValues): void {\n    super.firstUpdated(changedProperties);\n    this.updateHostAccessibility();\n  }\n\n  protected override updated(changedProperties: PropertyValues): void {\n    super.updated(changedProperties);\n    if (changedProperties.has('accessibleLabel')) {\n      this.updateHostAccessibility();\n    }\n  }\n\n  private updateHostAccessibility(): void {\n    if (this.accessibleLabel) {\n      this.setAttribute('role', 'img');\n      this.setAttribute('aria-label', this.accessibleLabel);\n      this.removeAttribute('aria-hidden');\n    } else {\n      this.removeAttribute('role');\n      this.removeAttribute('aria-label');\n      this.setAttribute('aria-hidden', 'true');\n    }\n  }\n}\n"],"mappings":";;;;;;AAgCA,IAAsB,IAAtB,cAAuC,EAAW,GAAiB,EACjE,YAAY,CAAC,GAAG,EAAiB,EAClC,CAAC,CAAC;;sCAgBwB;;CAMzB,aAAgC,GAAyC;AAEvE,EADA,MAAM,aAAa,EAAkB,EACrC,KAAK,yBAAyB;;CAGhC,QAA2B,GAAyC;AAElE,EADA,MAAM,QAAQ,EAAkB,EAC5B,EAAkB,IAAI,kBAAkB,IAC1C,KAAK,yBAAyB;;CAIlC,0BAAwC;AACtC,EAAI,KAAK,mBACP,KAAK,aAAa,QAAQ,MAAM,EAChC,KAAK,aAAa,cAAc,KAAK,gBAAgB,EACrD,KAAK,gBAAgB,cAAc,KAEnC,KAAK,gBAAgB,OAAO,EAC5B,KAAK,gBAAgB,aAAa,EAClC,KAAK,aAAa,eAAe,OAAO;;;GA3B3C,EAAS;CAAE,MAAM;CAAQ,WAAW;CAAoB,CAAC,CAAA,EAAA,EAAA,WAAA,mBAAA,KAAA,EAAA"}

package/dist/components/illustrated-message/IllustratedMessage.base.d.ts

@@ -1,4 +1,5 @@
 import { PropertyValues } from 'lit';
+import { SlotTextController } from '../../controllers/slot-text-controller/index.js';
 import { SpectrumElement } from '../../element/index.js';
 import { IllustratedMessageOrientation, IllustratedMessageSize } from './IllustratedMessage.types.js';
 /**
@@ -6,9 +7,9 @@ import { IllustratedMessageOrientation, IllustratedMessageSize } from './Illustr
  * used in empty states or error pages.
  *
  * @slot - Decorative or informative SVG illustration
- * @slot heading - The heading element, h2–h6
- *   @todo SWC-1943 Add slot constraints once the CEM slot constraints work is complete:
- *   `{required} {allowedChildren: h2, h3, h4, h5, h6} {maxChildren: 1}`
+ * @slot heading - Optional heading; when present, must be a single h2–h6 element.
+ *   Both constraints (allowed h2–h6 children and a single heading) are validated
+ *   in dev mode.
  * @slot description - Supporting description text
  * @slot actions - Optional action controls displayed below the description, typically a button or button group. Receives `size` automatically from the illustrated message.
  */
@@ -31,16 +32,29 @@ export declare abstract class IllustratedMessageBase extends SpectrumElement {
      * The layout orientation
      */
     orientation: IllustratedMessageOrientation;
+    /**
+     * Observes whether the default (illustration) slot has assigned content.
+     *
+     * @internal
+     */
+    protected slotText: SlotTextController;
     private readonly _sizePropagation;
-    protected updated(changedProperties: PropertyValues): void;
+    /**
+     * Whether the default (illustration) slot has assigned content, so
+     * rendering subclasses can collapse the illustration wrapper when no
+     * illustration is provided instead of reserving its fixed size.
+     */
+    protected get hasIllustration(): boolean;
+    protected update(changedProperties: PropertyValues): void;
     protected handleActionsSlotChange(): void;
     /**
      * @internal
      *
-     * Validates that the heading slot only contains `<h2>`–`<h6>` elements.
-     * Rendering subclasses must wire this to the heading slot's `slotchange`
-     * event (e.g. `<slot name="heading" @slotchange=${this.handleHeadingSlotChange}>`)
-     * for the validation warning to fire.
+     * Validates the heading slot: children must be `<h2>`–`<h6>`, and at most a
+     * single heading is allowed. Rendering subclasses must wire this to the
+     * heading slot's `slotchange` event (e.g.
+     * `<slot name="heading" @slotchange=${this.handleHeadingSlotChange}>`) for the
+     * validation warnings to fire.
      */
     protected handleHeadingSlotChange(event: Event): void;
 }

package/dist/components/illustrated-message/IllustratedMessage.base.js

@@ -3,44 +3,57 @@ import { SlotAttributePropagationController as t } from "../../controllers/slot-
 import { ILLUSTRATED_MESSAGE_VALID_ORIENTATIONS as n, ILLUSTRATED_MESSAGE_VALID_SIZES as r } from "./IllustratedMessage.types.js";
 import { property as i } from "lit/decorators.js";
 import { SpectrumElement as a } from "@adobe/spectrum-wc-core/element/index.js";
+import { validateAllowedChildren as o, validateEnum as s, warnIf as c } from "@adobe/spectrum-wc-core/utils/index.js";
+import { SlotTextController as l } from "@adobe/spectrum-wc-core/controllers/slot-text-controller/index.js";
 //#region components/illustrated-message/IllustratedMessage.base.ts
-var o, s = class extends a {
+var u, d = class extends a {
 	constructor(...e) {
-		super(...e), this.size = "m", this.orientation = "vertical", this._sizePropagation = new t(this, {
+		super(...e), this.size = "m", this.orientation = "vertical", this.slotText = new l(this), this._sizePropagation = new t(this, {
 			attribute: "size",
 			getValue: () => this.size,
 			slotName: "actions"
 		});
 	}
-	updated(e) {
-		var t;
-		super.updated(e), (t = window.__swc) != null && t.DEBUG && (e.has("size") && !r.includes(this.size) && window.__swc.warn(this, `<${this.localName}> received an invalid "size" value of "${this.size}". Valid values are ${r.join(", ")}.`, "https://opensource.adobe.com/spectrum-web-components/components/illustrated-message/", { issues: [`size="${this.size}"`] }), e.has("orientation") && !n.includes(this.orientation) && window.__swc.warn(this, `<${this.localName}> received an invalid "orientation" value of "${this.orientation}". Valid values are ${n.join(", ")}.`, "https://opensource.adobe.com/spectrum-web-components/components/illustrated-message/", { issues: [`orientation="${this.orientation}"`] }));
+	get hasIllustration() {
+		return this.slotText.hasContent;
+	}
+	update(e) {
+		e.has("size") && s(this, {
+			prop: "size",
+			value: this.size,
+			valid: r,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-illustrated-message--docs"
+		}), e.has("orientation") && s(this, {
+			prop: "orientation",
+			value: this.orientation,
+			valid: n,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-illustrated-message--docs"
+		}), super.update(e);
 	}
 	handleActionsSlotChange() {
 		this._sizePropagation.propagate();
 	}
 	handleHeadingSlotChange(e) {
-		var t;
-		if ((t = window.__swc) != null && t.DEBUG) {
-			let t = e.target;
-			for (let e of t.assignedElements()) [
-				"H2",
-				"H3",
-				"H4",
-				"H5",
-				"H6"
-			].includes(e.tagName) || window.__swc.warn(this, `<${this.localName}> heading slot received a <${e.tagName.toLowerCase()}> element. Only <h2>–<h6> elements are allowed in the heading slot.`, "https://opensource.adobe.com/spectrum-web-components/components/illustrated-message/", { issues: [`heading slot: <${e.tagName.toLowerCase()}>`] });
-		}
+		let t = e.target, n = "https://spectrum-web-components.adobe.com/?path=/docs/components-illustrated-message--docs";
+		o(this, t, [
+			"h2",
+			"h3",
+			"h4",
+			"h5",
+			"h6"
+		], "heading", n);
+		let r = t.assignedElements().length;
+		c(this, r > 1, `<${this.localName}> "heading" slot accepts a single heading element but received ${r}.`, n, { issues: [`heading slot: ${r} elements`] });
 	}
 };
-o = s, o.VALID_SIZES = r, o.VALID_ORIENTATIONS = n, e([i({
+u = d, u.VALID_SIZES = r, u.VALID_ORIENTATIONS = n, e([i({
 	type: String,
 	reflect: !0
-})], s.prototype, "size", void 0), e([i({
+})], d.prototype, "size", void 0), e([i({
 	type: String,
 	reflect: !0
-})], s.prototype, "orientation", void 0);
+})], d.prototype, "orientation", void 0);
 //#endregion
-export { s as IllustratedMessageBase };
+export { d as IllustratedMessageBase };
 
 //# sourceMappingURL=IllustratedMessage.base.js.map

package/dist/components/illustrated-message/IllustratedMessage.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"IllustratedMessage.base.js","names":[],"sources":["../../../components/illustrated-message/IllustratedMessage.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\n\nimport { SlotAttributePropagationController } from '../../controllers/slot-attribute-propagation-controller/index.js';\nimport {\n  ILLUSTRATED_MESSAGE_VALID_ORIENTATIONS,\n  ILLUSTRATED_MESSAGE_VALID_SIZES,\n  type IllustratedMessageOrientation,\n  type IllustratedMessageSize,\n} from './IllustratedMessage.types.js';\n\n/**\n * An illustrated message displays an illustration and a message, typically\n * used in empty states or error pages.\n *\n * @slot - Decorative or informative SVG illustration\n * @slot heading - The heading element, h2–h6\n *   @todo SWC-1943 Add slot constraints once the CEM slot constraints work is complete:\n *   `{required} {allowedChildren: h2, h3, h4, h5, h6} {maxChildren: 1}`\n * @slot description - Supporting description text\n * @slot actions - Optional action controls displayed below the description, typically a button or button group. Receives `size` automatically from the illustrated message.\n */\nexport abstract class IllustratedMessageBase extends SpectrumElement {\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   */\n  static readonly VALID_SIZES: readonly IllustratedMessageSize[] =\n    ILLUSTRATED_MESSAGE_VALID_SIZES;\n\n  /**\n   * @internal\n   */\n  static readonly VALID_ORIENTATIONS: readonly IllustratedMessageOrientation[] =\n    ILLUSTRATED_MESSAGE_VALID_ORIENTATIONS;\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * The size of the message\n   *\n   * @default m\n   */\n  @property({ type: String, reflect: true })\n  public size: IllustratedMessageSize = 'm';\n\n  /**\n   * The layout orientation\n   */\n  @property({ type: String, reflect: true })\n  public orientation: IllustratedMessageOrientation = 'vertical';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  private readonly _sizePropagation = new SlotAttributePropagationController(\n    this,\n    {\n      attribute: 'size',\n      getValue: () => this.size,\n      slotName: 'actions',\n    }\n  );\n\n  protected override updated(changedProperties: PropertyValues): void {\n    super.updated(changedProperties);\n\n    if (window.__swc?.DEBUG) {\n      if (\n        changedProperties.has('size') &&\n        !ILLUSTRATED_MESSAGE_VALID_SIZES.includes(this.size)\n      ) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> received an invalid \"size\" value of \"${this.size}\". Valid values are ${ILLUSTRATED_MESSAGE_VALID_SIZES.join(', ')}.`,\n          'https://opensource.adobe.com/spectrum-web-components/components/illustrated-message/',\n          { issues: [`size=\"${this.size}\"`] }\n        );\n      }\n\n      if (\n        changedProperties.has('orientation') &&\n        !ILLUSTRATED_MESSAGE_VALID_ORIENTATIONS.includes(this.orientation)\n      ) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> received an invalid \"orientation\" value of \"${this.orientation}\". Valid values are ${ILLUSTRATED_MESSAGE_VALID_ORIENTATIONS.join(', ')}.`,\n          'https://opensource.adobe.com/spectrum-web-components/components/illustrated-message/',\n          { issues: [`orientation=\"${this.orientation}\"`] }\n        );\n      }\n    }\n  }\n\n  protected handleActionsSlotChange(): void {\n    this._sizePropagation.propagate();\n  }\n\n  /**\n   * @internal\n   *\n   * Validates that the heading slot only contains `<h2>`–`<h6>` elements.\n   * Rendering subclasses must wire this to the heading slot's `slotchange`\n   * event (e.g. `<slot name=\"heading\" @slotchange=${this.handleHeadingSlotChange}>`)\n   * for the validation warning to fire.\n   */\n  protected handleHeadingSlotChange(event: Event): void {\n    if (window.__swc?.DEBUG) {\n      const headingSlot = event.target as HTMLSlotElement;\n      for (const el of headingSlot.assignedElements()) {\n        if (!['H2', 'H3', 'H4', 'H5', 'H6'].includes(el.tagName)) {\n          window.__swc.warn(\n            this,\n            `<${this.localName}> heading slot received a <${el.tagName.toLowerCase()}> element. Only <h2>–<h6> elements are allowed in the heading slot.`,\n            'https://opensource.adobe.com/spectrum-web-components/components/illustrated-message/',\n            { issues: [`heading slot: <${el.tagName.toLowerCase()}>`] }\n          );\n        }\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;OAoCsB,IAAtB,cAAqD,EAAgB;;2BA2B7B,wBAMc,oCAMhB,IAAI,EACtC,MACA;GACE,WAAW;GACX,gBAAgB,KAAK;GACrB,UAAU;GACX,CACF;;CAED,QAA2B,GAAyC;;AAGlE,EAFA,MAAM,QAAQ,EAAkB,GAEhC,IAAI,OAAO,UAAA,QAAA,EAAO,UAEd,EAAkB,IAAI,OAAO,IAC7B,CAAC,EAAgC,SAAS,KAAK,KAAK,IAEpD,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,yCAAyC,KAAK,KAAK,sBAAsB,EAAgC,KAAK,KAAK,CAAC,IACvI,wFACA,EAAE,QAAQ,CAAC,SAAS,KAAK,KAAK,GAAG,EAAE,CACpC,EAID,EAAkB,IAAI,cAAc,IACpC,CAAC,EAAuC,SAAS,KAAK,YAAY,IAElE,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,gDAAgD,KAAK,YAAY,sBAAsB,EAAuC,KAAK,KAAK,CAAC,IAC5J,wFACA,EAAE,QAAQ,CAAC,gBAAgB,KAAK,YAAY,GAAG,EAAE,CAClD;;CAKP,0BAA0C;AACxC,OAAK,iBAAiB,WAAW;;CAWnC,wBAAkC,GAAoB;;AACpD,OAAA,IAAI,OAAO,UAAA,QAAA,EAAO,OAAO;GACvB,IAAM,IAAc,EAAM;AAC1B,QAAK,IAAM,KAAM,EAAY,kBAAkB,CAC7C,CAAK;IAAC;IAAM;IAAM;IAAM;IAAM;IAAK,CAAC,SAAS,EAAG,QAAQ,IACtD,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,6BAA6B,EAAG,QAAQ,aAAa,CAAC,sEACzE,wFACA,EAAE,QAAQ,CAAC,kBAAkB,EAAG,QAAQ,aAAa,CAAC,GAAG,EAAE,CAC5D;;;;uBA3FP,0BAMA,MAWD,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,QAAA,KAAA,EAAA,KAMzC,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,eAAA,KAAA,EAAA"}
+{"version":3,"file":"IllustratedMessage.base.js","names":[],"sources":["../../../components/illustrated-message/IllustratedMessage.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 { SlotTextController } from '@adobe/spectrum-wc-core/controllers/slot-text-controller/index.js';\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport {\n  validateAllowedChildren,\n  validateEnum,\n  warnIf,\n} from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport { SlotAttributePropagationController } from '../../controllers/slot-attribute-propagation-controller/index.js';\nimport {\n  ILLUSTRATED_MESSAGE_VALID_ORIENTATIONS,\n  ILLUSTRATED_MESSAGE_VALID_SIZES,\n  type IllustratedMessageOrientation,\n  type IllustratedMessageSize,\n} from './IllustratedMessage.types.js';\n\n/**\n * An illustrated message displays an illustration and a message, typically\n * used in empty states or error pages.\n *\n * @slot - Decorative or informative SVG illustration\n * @slot heading - Optional heading; when present, must be a single h2–h6 element.\n *   Both constraints (allowed h2–h6 children and a single heading) are validated\n *   in dev mode.\n * @slot description - Supporting description text\n * @slot actions - Optional action controls displayed below the description, typically a button or button group. Receives `size` automatically from the illustrated message.\n */\nexport abstract class IllustratedMessageBase extends SpectrumElement {\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   */\n  static readonly VALID_SIZES: readonly IllustratedMessageSize[] =\n    ILLUSTRATED_MESSAGE_VALID_SIZES;\n\n  /**\n   * @internal\n   */\n  static readonly VALID_ORIENTATIONS: readonly IllustratedMessageOrientation[] =\n    ILLUSTRATED_MESSAGE_VALID_ORIENTATIONS;\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * The size of the message\n   *\n   * @default m\n   */\n  @property({ type: String, reflect: true })\n  public size: IllustratedMessageSize = 'm';\n\n  /**\n   * The layout orientation\n   */\n  @property({ type: String, reflect: true })\n  public orientation: IllustratedMessageOrientation = 'vertical';\n\n  // ──────────────────────\n  //     CONTROLLERS\n  // ──────────────────────\n\n  /**\n   * Observes whether the default (illustration) slot has assigned content.\n   *\n   * @internal\n   */\n  protected slotText = new SlotTextController(this);\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  private readonly _sizePropagation = new SlotAttributePropagationController(\n    this,\n    {\n      attribute: 'size',\n      getValue: () => this.size,\n      slotName: 'actions',\n    }\n  );\n\n  /**\n   * Whether the default (illustration) slot has assigned content, so\n   * rendering subclasses can collapse the illustration wrapper when no\n   * illustration is provided instead of reserving its fixed size.\n   */\n  protected get hasIllustration(): boolean {\n    return this.slotText.hasContent;\n  }\n\n  protected override update(changedProperties: PropertyValues): void {\n    if (changedProperties.has('size')) {\n      validateEnum(this, {\n        prop: 'size',\n        value: this.size,\n        valid: ILLUSTRATED_MESSAGE_VALID_SIZES,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-illustrated-message--docs',\n      });\n    }\n\n    if (changedProperties.has('orientation')) {\n      validateEnum(this, {\n        prop: 'orientation',\n        value: this.orientation,\n        valid: ILLUSTRATED_MESSAGE_VALID_ORIENTATIONS,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-illustrated-message--docs',\n      });\n    }\n\n    super.update(changedProperties);\n  }\n\n  protected handleActionsSlotChange(): void {\n    this._sizePropagation.propagate();\n  }\n\n  /**\n   * @internal\n   *\n   * Validates the heading slot: children must be `<h2>`–`<h6>`, and at most a\n   * single heading is allowed. Rendering subclasses must wire this to the\n   * heading slot's `slotchange` event (e.g.\n   * `<slot name=\"heading\" @slotchange=${this.handleHeadingSlotChange}>`) for the\n   * validation warnings to fire.\n   */\n  protected handleHeadingSlotChange(event: Event): void {\n    const slot = event.target as HTMLSlotElement;\n    const url =\n      'https://spectrum-web-components.adobe.com/?path=/docs/components-illustrated-message--docs';\n    validateAllowedChildren(\n      this,\n      slot,\n      ['h2', 'h3', 'h4', 'h5', 'h6'],\n      'heading',\n      url\n    );\n    const headingCount = slot.assignedElements().length;\n    warnIf(\n      this,\n      headingCount > 1,\n      `<${this.localName}> \"heading\" slot accepts a single heading element but received ${headingCount}.`,\n      url,\n      { issues: [`heading slot: ${headingCount} elements`] }\n    );\n  }\n}\n"],"mappings":";;;;;;;;OA0CsB,IAAtB,cAAqD,EAAgB;;2BA2B7B,wBAMc,4BAW/B,IAAI,EAAmB,KAAK,0BAMb,IAAI,EACtC,MACA;GACE,WAAW;GACX,gBAAgB,KAAK;GACrB,UAAU;GACX,CACF;;CAOD,IAAc,kBAA2B;AACvC,SAAO,KAAK,SAAS;;CAGvB,OAA0B,GAAyC;AAmBjE,EAlBI,EAAkB,IAAI,OAAO,IAC/B,EAAa,MAAM;GACjB,MAAM;GACN,OAAO,KAAK;GACZ,OAAO;GACP,KAAK;GACN,CAAC,EAGA,EAAkB,IAAI,cAAc,IACtC,EAAa,MAAM;GACjB,MAAM;GACN,OAAO,KAAK;GACZ,OAAO;GACP,KAAK;GACN,CAAC,EAGJ,MAAM,OAAO,EAAkB;;CAGjC,0BAA0C;AACxC,OAAK,iBAAiB,WAAW;;CAYnC,wBAAkC,GAAoB;EACpD,IAAM,IAAO,EAAM,QACb,IACJ;AACF,IACE,MACA,GACA;GAAC;GAAM;GAAM;GAAM;GAAM;GAAK,EAC9B,WACA,EACD;EACD,IAAM,IAAe,EAAK,kBAAkB,CAAC;AAC7C,IACE,MACA,IAAe,GACf,IAAI,KAAK,UAAU,iEAAiE,EAAa,IACjG,GACA,EAAE,QAAQ,CAAC,iBAAiB,EAAa,WAAW,EAAE,CACvD;;;uBAhHD,0BAMA,MAWD,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,QAAA,KAAA,EAAA,KAMzC,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,eAAA,KAAA,EAAA"}

package/dist/components/infield-button/InfieldButton.base.d.ts

@@ -0,0 +1,28 @@
+import { ButtonBase } from '../button';
+import { InfieldButtonSize } from './InfieldButton.types.js';
+/**
+ * Abstract base class for infield button components. Extends ButtonBase with a
+ * restricted size set, quiet treatment, and non-focusable shadow root.
+ *
+ * Infield buttons are always embedded inside a form field (e.g. number field). They are
+ * clickable via pointer only; they are not in the tab order and not independently focusable.
+ * All keyboard behavior is owned by the parent field, which also provides the visible
+ * focus ring. The parent field is expected to set the `size` attribute.
+ *
+ * @slot icon - Icon to display inside the button.
+ *
+ * @attribute {ElementSize} size - Size delegated from the parent field. Defaults to
+ *   medium when no parent sets it, though standalone usage is not supported.
+ */
+export declare abstract class InfieldButtonBase extends ButtonBase {
+    /** @internal */
+    static readonly VALID_SIZES: readonly InfieldButtonSize[];
+    /** @internal */
+    static readonly NO_DEFAULT_SIZE = true;
+    static shadowRootOptions: ShadowRootInit;
+    /**
+     * Applies the quiet (no-background) visual treatment. Used when the infield button
+     * is part of a quiet field variant.
+     */
+    quiet: boolean;
+}

package/dist/components/infield-button/InfieldButton.base.js

@@ -0,0 +1,22 @@
+import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
+import { INFIELD_BUTTON_VALID_SIZES as t } from "./InfieldButton.types.js";
+import { property as n } from "lit/decorators.js";
+import { SpectrumElement as r } from "@adobe/spectrum-wc-core/element/index.js";
+import { ButtonBase as i } from "@adobe/spectrum-wc-core/components/button";
+//#region components/infield-button/InfieldButton.base.ts
+var a, o = class extends i {
+	constructor(...e) {
+		super(...e), this.quiet = !1;
+	}
+};
+a = o, a.VALID_SIZES = t, a.NO_DEFAULT_SIZE = !0, a.shadowRootOptions = {
+	...r.shadowRootOptions,
+	delegatesFocus: !1
+}, e([n({
+	type: Boolean,
+	reflect: !0
+})], o.prototype, "quiet", void 0);
+//#endregion
+export { o as InfieldButtonBase };
+
+//# sourceMappingURL=InfieldButton.base.js.map

package/dist/components/infield-button/InfieldButton.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InfieldButton.base.js","names":[],"sources":["../../../components/infield-button/InfieldButton.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 { property } from 'lit/decorators.js';\n\nimport { ButtonBase } from '@adobe/spectrum-wc-core/components/button';\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\n\nimport {\n  INFIELD_BUTTON_VALID_SIZES,\n  type InfieldButtonSize,\n} from './InfieldButton.types.js';\n\n/**\n * Abstract base class for infield button components. Extends ButtonBase with a\n * restricted size set, quiet treatment, and non-focusable shadow root.\n *\n * Infield buttons are always embedded inside a form field (e.g. number field). They are\n * clickable via pointer only; they are not in the tab order and not independently focusable.\n * All keyboard behavior is owned by the parent field, which also provides the visible\n * focus ring. The parent field is expected to set the `size` attribute.\n *\n * @slot icon - Icon to display inside the button.\n *\n * @attribute {ElementSize} size - Size delegated from the parent field. Defaults to\n *   medium when no parent sets it, though standalone usage is not supported.\n */\nexport abstract class InfieldButtonBase extends ButtonBase {\n  // ────────────────────\n  //     API OVERRIDES\n  // ────────────────────\n\n  /** @internal */\n  static override readonly VALID_SIZES: readonly InfieldButtonSize[] =\n    INFIELD_BUTTON_VALID_SIZES;\n\n  // The parent field owns sizing; infield buttons must not auto-reflect size=\"m\"\n  // when no explicit size is provided. Overriding NO_DEFAULT_SIZE lets the\n  // SizedMixin setter and update() read this flag via this.constructor, so the\n  // decision cascades through the full prototype chain without closure leakage.\n  /** @internal */\n  static override readonly NO_DEFAULT_SIZE = true;\n\n  // Infield buttons are clickable but never independently focusable. The parent field\n  // owns keyboard behavior and supplies the only focus ring.\n  static override shadowRootOptions: ShadowRootInit = {\n    ...SpectrumElement.shadowRootOptions,\n    delegatesFocus: false,\n  };\n\n  // ───────────────────\n  //     API ADDITIONS\n  // ───────────────────\n\n  /**\n   * Applies the quiet (no-background) visual treatment. Used when the infield button\n   * is part of a quiet field variant.\n   */\n  @property({ type: Boolean, reflect: true })\n  public quiet: boolean = false;\n}\n"],"mappings":";;;;;;OAoCsB,IAAtB,cAAgD,EAAW;;4BAgCjC;;;uBAzBtB,uBAOyC,0BAIS;CAClD,GAAG,EAAgB;CACnB,gBAAgB;CACjB,KAUA,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA"}

package/dist/components/infield-button/InfieldButton.types.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 declare const INFIELD_BUTTON_VALID_SIZES: readonly ["s", "m", "l", "xl"];
+export type InfieldButtonSize = (typeof INFIELD_BUTTON_VALID_SIZES)[number];

package/dist/components/infield-button/InfieldButton.types.js

@@ -0,0 +1,11 @@
+//#region components/infield-button/InfieldButton.types.ts
+var e = [
+	"s",
+	"m",
+	"l",
+	"xl"
+];
+//#endregion
+export { e as INFIELD_BUTTON_VALID_SIZES };
+
+//# sourceMappingURL=InfieldButton.types.js.map

package/dist/components/infield-button/InfieldButton.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InfieldButton.types.js","names":[],"sources":["../../../components/infield-button/InfieldButton.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 INFIELD_BUTTON_VALID_SIZES = [\n  's',\n  'm',\n  'l',\n  'xl',\n] as const satisfies readonly ElementSize[];\n\n// ──────────────────\n//     TYPES\n// ──────────────────\n\nexport type InfieldButtonSize = (typeof INFIELD_BUTTON_VALID_SIZES)[number];\n"],"mappings":";AAkBA,IAAa,IAA6B;CACxC;CACA;CACA;CACA;CACD"}

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

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

@@ -0,0 +1,3 @@
+import { INFIELD_BUTTON_VALID_SIZES as e } from "./InfieldButton.types.js";
+import { InfieldButtonBase as t } from "./InfieldButton.base.js";
+export { e as INFIELD_BUTTON_VALID_SIZES, t as InfieldButtonBase };

package/dist/components/meter/Meter.base.js

@@ -3,8 +3,9 @@ import { METER_VARIANTS as t } from "./Meter.types.js";
 import { property as n } from "lit/decorators.js";
 import { SpectrumElement as r } from "@adobe/spectrum-wc-core/element/index.js";
 import { LINEAR_PROGRESS_VALID_SIZES as i, LinearProgressMixin as a, SizedMixin as o } from "@adobe/spectrum-wc-core/mixins/index.js";
+import { validateEnum as s } from "@adobe/spectrum-wc-core/utils/index.js";
 //#region components/meter/Meter.base.ts
-var s, c = class extends a(o(r, {
+var c, l = class extends a(o(r, {
 	validSizes: i,
 	defaultSize: "m"
 })) {
@@ -13,18 +14,19 @@ var s, c = class extends a(o(r, {
 	}
 	willUpdate(e) {
 		let t = this.constructor;
-		if (!t.VARIANTS.includes(this.variant)) {
-			var n;
-			(n = window.__swc) != null && n.DEBUG && window.__swc.warn(this, `<${this.localName}> element expects the "variant" attribute to be one of the following:`, "https://spectrum-web-components.adobe.com/?path=/docs/components-meter--docs", { issues: [...t.VARIANTS] }), this.variant = "informative";
-		}
-		super.willUpdate(e);
+		t.VARIANTS.includes(this.variant) || (s(this, {
+			prop: "variant",
+			value: this.variant,
+			valid: t.VARIANTS,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-meter--docs"
+		}), this.variant = "informative"), super.willUpdate(e);
 	}
 };
-s = c, s.VARIANTS = t, e([n({
+c = l, c.VARIANTS = t, e([n({
 	type: String,
 	reflect: !0
-})], c.prototype, "variant", void 0);
+})], l.prototype, "variant", void 0);
 //#endregion
-export { c as MeterBase };
+export { l as MeterBase };
 
 //# sourceMappingURL=Meter.base.js.map

package/dist/components/meter/Meter.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"Meter.base.js","names":[],"sources":["../../../components/meter/Meter.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  LINEAR_PROGRESS_VALID_SIZES,\n  LinearProgressMixin,\n  SizedMixin,\n} from '@adobe/spectrum-wc-core/mixins/index.js';\n\nimport { METER_VARIANTS, type MeterVariant } from './Meter.types.js';\n\n/**\n * A non-focusable, read-only bar that shows a value inside a fixed range.\n * Implements the WAI-ARIA `meter` role on the shadow `.swc-Meter` element\n * (the host carries no ARIA).\n *\n * @attribute {ElementSize} size - The size of the meter.\n */\nexport abstract class MeterBase extends LinearProgressMixin(\n  SizedMixin(SpectrumElement, {\n    validSizes: LINEAR_PROGRESS_VALID_SIZES,\n    defaultSize: 'm',\n  })\n) {\n  /**\n   * The size of the meter.\n   *\n   * @default m\n   */\n  declare public size: (typeof LINEAR_PROGRESS_VALID_SIZES)[number];\n\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of all valid variants for the meter. Concrete\n   * subclasses re-declare with their own valid set so validation logic\n   * resolves against `(this.constructor as typeof MeterBase).VARIANTS`.\n   */\n  static readonly VARIANTS: readonly string[] = METER_VARIANTS;\n\n  /**\n   * The variant of the meter. Drives the bar fill color.\n   */\n  @property({ type: String, reflect: true })\n  public variant: MeterVariant = 'informative';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override willUpdate(changes: PropertyValues): void {\n    const constructor = this.constructor as typeof MeterBase;\n    if (!constructor.VARIANTS.includes(this.variant)) {\n      if (window.__swc?.DEBUG) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> element expects the \"variant\" attribute to be one of the following:`,\n          'https://spectrum-web-components.adobe.com/?path=/docs/components-meter--docs',\n          {\n            issues: [...constructor.VARIANTS],\n          }\n        );\n      }\n      // Unknown variant: fall back to the default so the reflected\n      // attribute and fill color always resolve to a valid variant.\n      // Normalizing in `willUpdate` (Lit's input-normalization hook) folds\n      // the change into the current cycle instead of scheduling a second\n      // reactive update.\n      this.variant = 'informative';\n    }\n    super.willUpdate(changes);\n  }\n}\n"],"mappings":";;;;;;OA+BsB,IAAtB,cAAwC,EACtC,EAAW,GAAiB;CAC1B,YAAY;CACZ,aAAa;CACd,CAAC,CACH,CAAC;;8BAyB+B;;CAM/B,WAA8B,GAA+B;EAC3D,IAAM,IAAc,KAAK;AACzB,MAAI,CAAC,EAAY,SAAS,SAAS,KAAK,QAAQ,EAAE;;AAgBhD,IAfA,IAAI,OAAO,UAAA,QAAA,EAAO,SAChB,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,wEACnB,gFACA,EACE,QAAQ,CAAC,GAAG,EAAY,SAAS,EAClC,CACF,EAOH,KAAK,UAAU;;AAEjB,QAAM,WAAW,EAAQ;;;oBAhCmB,MAK7C,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA"}
+{"version":3,"file":"Meter.base.js","names":[],"sources":["../../../components/meter/Meter.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  LINEAR_PROGRESS_VALID_SIZES,\n  LinearProgressMixin,\n  SizedMixin,\n} from '@adobe/spectrum-wc-core/mixins/index.js';\nimport { validateEnum } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport { METER_VARIANTS, type MeterVariant } from './Meter.types.js';\n\n/**\n * A non-focusable, read-only bar that shows a value inside a fixed range.\n * Implements the WAI-ARIA `meter` role on the shadow `.swc-Meter` element\n * (the host carries no ARIA).\n *\n * @attribute {ElementSize} size - The size of the meter.\n */\nexport abstract class MeterBase extends LinearProgressMixin(\n  SizedMixin(SpectrumElement, {\n    validSizes: LINEAR_PROGRESS_VALID_SIZES,\n    defaultSize: 'm',\n  })\n) {\n  /**\n   * The size of the meter.\n   *\n   * @default m\n   */\n  declare public size: (typeof LINEAR_PROGRESS_VALID_SIZES)[number];\n\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of all valid variants for the meter. Concrete\n   * subclasses re-declare with their own valid set so validation logic\n   * resolves against `(this.constructor as typeof MeterBase).VARIANTS`.\n   */\n  static readonly VARIANTS: readonly string[] = METER_VARIANTS;\n\n  /**\n   * The variant of the meter. Drives the bar fill color.\n   */\n  @property({ type: String, reflect: true })\n  public variant: MeterVariant = 'informative';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override willUpdate(changes: PropertyValues): void {\n    const constructor = this.constructor as typeof MeterBase;\n    if (!constructor.VARIANTS.includes(this.variant)) {\n      validateEnum(this, {\n        prop: 'variant',\n        value: this.variant,\n        valid: constructor.VARIANTS,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-meter--docs',\n      });\n      // Unknown variant: fall back to the default so the reflected\n      // attribute and fill color always resolve to a valid variant.\n      // Normalizing in `willUpdate` (Lit's input-normalization hook) folds\n      // the change into the current cycle instead of scheduling a second\n      // reactive update.\n      this.variant = 'informative';\n    }\n    super.willUpdate(changes);\n  }\n}\n"],"mappings":";;;;;;;OAgCsB,IAAtB,cAAwC,EACtC,EAAW,GAAiB;CAC1B,YAAY;CACZ,aAAa;CACd,CAAC,CACH,CAAC;;8BAyB+B;;CAM/B,WAA8B,GAA+B;EAC3D,IAAM,IAAc,KAAK;AAezB,EAdK,EAAY,SAAS,SAAS,KAAK,QAAQ,KAC9C,EAAa,MAAM;GACjB,MAAM;GACN,OAAO,KAAK;GACZ,OAAO,EAAY;GACnB,KAAK;GACN,CAAC,EAMF,KAAK,UAAU,gBAEjB,MAAM,WAAW,EAAQ;;;oBA5BmB,MAK7C,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA"}

package/dist/components/popover/Popover.base.d.ts

@@ -151,23 +151,7 @@ export declare abstract class PopoverBase extends SpectrumElement {
     private _interactiveElement;
     /** The positioning anchor (an element or a `VirtualTrigger`). */
     private _anchor;
-    /** The element the click-to-toggle listeners are currently attached to. */
-    private _clickTrigger;
-    /**
-     * True between a trigger press start (`pointerdown`/`touchstart`) and its
-     * `click`, so a light-dismiss inside that window is attributed to the press.
-     * Both events open it, covering touch (where the dismiss can fire off
-     * `touchstart` before `pointerdown`).
-     */
-    private _triggerPointerActive;
-    /** Cancels the pending press-end listeners armed in `_onTriggerPressStart`. */
-    private _pressEndAbort;
-    /**
-     * Set when the trigger press light-dismissed an open popover (an `'outside'`
-     * close observed while `_triggerPointerActive`), so the trailing `click` of
-     * that same gesture is read as the close rather than a reopen.
-     */
-    private _dismissedByTriggerPress;
+    private readonly _pressGuard;
     /** Cause of the in-progress close, read when dispatching `swc-close`. */
     private _closeSource;
     /** Suppresses the open/close effect when `open` is synced from a native event. */
@@ -200,10 +184,6 @@ export declare abstract class PopoverBase extends SpectrumElement {
     protected updated(changedProperties: PropertyValues): void;
     private _positioningChanged;
     private _wireTrigger;
-    private _removeTriggerListeners;
-    private _onTriggerPressStart;
-    private _onTriggerPressEnd;
-    private _onTriggerClick;
     private _clearTriggerAria;
     private _isFocusWithin;
     private _startPositioning;