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

package/dist/components/divider/Divider.base.js

@@ -3,16 +3,21 @@ import { DIVIDER_STATIC_COLORS as t, DIVIDER_VALID_SIZES as n } from "./Divider.
 import { property 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 { validateEnum as o } from "@adobe/spectrum-wc-core/utils/index.js";
 //#region components/divider/Divider.base.ts
-var o, s = class extends a(i, { validSizes: n }) {
+var s, c = class extends a(i, { validSizes: n }) {
 	constructor(...e) {
 		super(...e), this.vertical = !1;
 	}
 	update(e) {
-		var t;
-		if ((t = window.__swc) != null && t.DEBUG) {
+		if (this.staticColor !== void 0) {
 			let e = this.constructor;
-			this.staticColor !== void 0 && !e.STATIC_COLORS.includes(this.staticColor) && window.__swc.warn(this, `<${this.localName}> element expects the "static-color" attribute to be one of the following:`, "https://opensource.adobe.com/spectrum-web-components/components/divider/", { issues: [...e.STATIC_COLORS] });
+			o(this, {
+				prop: "static-color",
+				value: this.staticColor,
+				valid: e.STATIC_COLORS,
+				url: "https://spectrum-web-components.adobe.com/?path=/docs/components-divider--docs"
+			});
 		}
 		super.update(e);
 	}
@@ -23,15 +28,15 @@ var o, s = class extends a(i, { validSizes: n }) {
 		super.updated(e), e.has("vertical") && (this.vertical ? this.setAttribute("aria-orientation", "vertical") : this.removeAttribute("aria-orientation"));
 	}
 };
-o = s, o.STATIC_COLORS = t, e([r({
+s = c, s.STATIC_COLORS = t, e([r({
 	type: Boolean,
 	reflect: !0
-})], s.prototype, "vertical", void 0), e([r({
+})], c.prototype, "vertical", void 0), e([r({
 	type: String,
 	reflect: !0,
 	attribute: "static-color"
-})], s.prototype, "staticColor", void 0);
+})], c.prototype, "staticColor", void 0);
 //#endregion
-export { s as DividerBase };
+export { c as DividerBase };
 
 //# sourceMappingURL=Divider.base.js.map

package/dist/components/divider/Divider.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"Divider.base.js","names":[],"sources":["../../../components/divider/Divider.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 { SizedMixin } from '@adobe/spectrum-wc-core/mixins/index.js';\n\nimport {\n  DIVIDER_STATIC_COLORS,\n  DIVIDER_VALID_SIZES,\n  type DividerSize,\n  type DividerStaticColor,\n} from './Divider.types.js';\n\n/**\n * A divider separates and distinguishes sections of content or groups of menu items.\n *\n * Layout sizing: horizontal dividers fill the **inline size** of the container (`inline-size: 100%`\n * with a minimum track); vertical dividers fill the **block size** (`block-size: 100%` with a minimum\n * track). When the percentage basis does not resolve (for example a lone flex item in a row),\n * set a definite width or height on the host or an ancestor so the line can render predictably.\n *\n * @attribute {ElementSize} size - The size of the divider.\n */\nexport abstract class DividerBase extends SizedMixin(SpectrumElement, {\n  validSizes: DIVIDER_VALID_SIZES,\n}) {\n  /**\n   * The size of the divider.\n   *\n   * @default m\n   */\n  declare public size: DividerSize;\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of the valid static color variants for the divider.\n   */\n  static readonly STATIC_COLORS: readonly string[] = DIVIDER_STATIC_COLORS;\n\n  /**\n   * Whether the divider is vertical. If false, the divider is horizontal. The default is false.\n   */\n  @property({ type: Boolean, reflect: true })\n  public vertical = false;\n\n  /**\n   * The static color variant to use for the divider.\n   */\n  @property({ type: String, reflect: true, attribute: 'static-color' })\n  public staticColor?: DividerStaticColor;\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override update(changedProperties: PropertyValues): void {\n    if (window.__swc?.DEBUG) {\n      const constructor = this.constructor as typeof DividerBase;\n      if (\n        typeof this.staticColor !== 'undefined' &&\n        !constructor.STATIC_COLORS.includes(this.staticColor)\n      ) {\n        window.__swc.warn(\n          this,\n          `<${this.localName}> element expects the \"static-color\" attribute to be one of the following:`,\n          'https://opensource.adobe.com/spectrum-web-components/components/divider/',\n          {\n            issues: [...constructor.STATIC_COLORS],\n          }\n        );\n      }\n    }\n    super.update(changedProperties);\n  }\n\n  protected override firstUpdated(changed: PropertyValues<this>): void {\n    super.firstUpdated(changed);\n    this.setAttribute('role', 'separator');\n  }\n\n  protected override updated(changed: PropertyValues<this>): void {\n    super.updated(changed);\n    if (changed.has('vertical')) {\n      if (this.vertical) {\n        this.setAttribute('aria-orientation', 'vertical');\n      } else {\n        this.removeAttribute('aria-orientation');\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;OAmCsB,IAAtB,cAA0C,EAAW,GAAiB,EACpE,YAAY,GACb,CAAC,CAAC;;+BAuBiB;;CAYlB,OAA0B,GAAyC;;AACjE,OAAA,IAAI,OAAO,UAAA,QAAA,EAAO,OAAO;GACvB,IAAM,IAAc,KAAK;AACzB,GACS,KAAK,gBAAgB,UAC5B,CAAC,EAAY,cAAc,SAAS,KAAK,YAAY,IAErD,OAAO,MAAM,KACX,MACA,IAAI,KAAK,UAAU,6EACnB,4EACA,EACE,QAAQ,CAAC,GAAG,EAAY,cAAc,EACvC,CACF;;AAGL,QAAM,OAAO,EAAkB;;CAGjC,aAAgC,GAAqC;AAEnE,EADA,MAAM,aAAa,EAAQ,EAC3B,KAAK,aAAa,QAAQ,YAAY;;CAGxC,QAA2B,GAAqC;AAE9D,EADA,MAAM,QAAQ,EAAQ,EAClB,EAAQ,IAAI,WAAW,KACrB,KAAK,WACP,KAAK,aAAa,oBAAoB,WAAW,GAEjD,KAAK,gBAAgB,mBAAmB;;;yBAjDK,MAKlD,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAM1C,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,WAAW;CAAgB,CAAC,CAAA,EAAA,EAAA,WAAA,eAAA,KAAA,EAAA"}
+{"version":3,"file":"Divider.base.js","names":[],"sources":["../../../components/divider/Divider.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 { SizedMixin } from '@adobe/spectrum-wc-core/mixins/index.js';\nimport { validateEnum } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport {\n  DIVIDER_STATIC_COLORS,\n  DIVIDER_VALID_SIZES,\n  type DividerSize,\n  type DividerStaticColor,\n} from './Divider.types.js';\n\n/**\n * A divider separates and distinguishes sections of content or groups of menu items.\n *\n * Layout sizing: horizontal dividers fill the **inline size** of the container (`inline-size: 100%`\n * with a minimum track); vertical dividers fill the **block size** (`block-size: 100%` with a minimum\n * track). When the percentage basis does not resolve (for example a lone flex item in a row),\n * set a definite width or height on the host or an ancestor so the line can render predictably.\n *\n * @attribute {ElementSize} size - The size of the divider.\n */\nexport abstract class DividerBase extends SizedMixin(SpectrumElement, {\n  validSizes: DIVIDER_VALID_SIZES,\n}) {\n  /**\n   * The size of the divider.\n   *\n   * @default m\n   */\n  declare public size: DividerSize;\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of the valid static color variants for the divider.\n   */\n  static readonly STATIC_COLORS: readonly string[] = DIVIDER_STATIC_COLORS;\n\n  /**\n   * Whether the divider is vertical. If false, the divider is horizontal. The default is false.\n   */\n  @property({ type: Boolean, reflect: true })\n  public vertical = false;\n\n  /**\n   * The static color variant to use for the divider.\n   */\n  @property({ type: String, reflect: true, attribute: 'static-color' })\n  public staticColor?: DividerStaticColor;\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override update(changedProperties: PropertyValues): void {\n    if (typeof this.staticColor !== 'undefined') {\n      const constructor = this.constructor as typeof DividerBase;\n      validateEnum(this, {\n        prop: 'static-color',\n        value: this.staticColor,\n        valid: constructor.STATIC_COLORS,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-divider--docs',\n      });\n    }\n    super.update(changedProperties);\n  }\n\n  protected override firstUpdated(changed: PropertyValues<this>): void {\n    super.firstUpdated(changed);\n    this.setAttribute('role', 'separator');\n  }\n\n  protected override updated(changed: PropertyValues<this>): void {\n    super.updated(changed);\n    if (changed.has('vertical')) {\n      if (this.vertical) {\n        this.setAttribute('aria-orientation', 'vertical');\n      } else {\n        this.removeAttribute('aria-orientation');\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;OAoCsB,IAAtB,cAA0C,EAAW,GAAiB,EACpE,YAAY,GACb,CAAC,CAAC;;+BAuBiB;;CAYlB,OAA0B,GAAyC;AACjE,MAAW,KAAK,gBAAgB,QAAa;GAC3C,IAAM,IAAc,KAAK;AACzB,KAAa,MAAM;IACjB,MAAM;IACN,OAAO,KAAK;IACZ,OAAO,EAAY;IACnB,KAAK;IACN,CAAC;;AAEJ,QAAM,OAAO,EAAkB;;CAGjC,aAAgC,GAAqC;AAEnE,EADA,MAAM,aAAa,EAAQ,EAC3B,KAAK,aAAa,QAAQ,YAAY;;CAGxC,QAA2B,GAAqC;AAE9D,EADA,MAAM,QAAQ,EAAQ,EAClB,EAAQ,IAAI,WAAW,KACrB,KAAK,WACP,KAAK,aAAa,oBAAoB,WAAW,GAEjD,KAAK,gBAAgB,mBAAmB;;;yBA1CK,MAKlD,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAM1C,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,WAAW;CAAgB,CAAC,CAAA,EAAA,EAAA,WAAA,eAAA,KAAA,EAAA"}

package/dist/components/dropzone/Dropzone.base.d.ts

@@ -0,0 +1,74 @@
+import { SpectrumElement } from '../../element/index.js';
+import { DropEffect, DropzoneSize } from './Dropzone.types.js';
+declare const DropzoneBase_base: typeof SpectrumElement & {
+    new (...args: any[]): import('../../mixins/index.js').SizedElementInterface;
+    prototype: import('../../mixins/index.js').SizedElementInterface;
+} & import('../../mixins/index.js').SizedElementConstructor;
+/**
+ * Base class for the `<swc-dropzone>` drop zone component.
+ *
+ * Encapsulates all drag-and-drop event handling, state management, and
+ * validation logic. Rendering, ARIA, and CSS are provided by the concrete
+ * SWC subclass.
+ *
+ * @attribute {DropzoneSize} size - Controls the illustrated icon scale and container dimensions.
+ *
+ * @slot - Slot for the illustrated message and browse control. Hidden automatically when `filled` is true.
+ * @slot filled-content - Slot for the uploaded-state content (e.g. an image preview). Shown automatically when `filled` is true; hidden otherwise.
+ *
+ * @fires swc-dropzone-should-accept - Cancelable event fired on every native `dragover`
+ *   tick while a drag is over the zone, not just on entry. Cancel to reject the dragged
+ *   payload and set the cursor to `none`.
+ * @fires swc-dropzone-dragover - Fired once when dragged files enter the zone and are
+ *   accepted; does not repeat on subsequent `dragover` ticks while still hovering.
+ * @fires swc-dropzone-dragleave - Fired when an accepted drag leaves the zone after a
+ *   100 ms debounce, or immediately when it becomes rejected. Detail is a plain snapshot
+ *   `{ clientX, clientY, relatedTarget }` captured synchronously from the native event.
+ * @fires swc-dropzone-drop - Fired when files are dropped on the zone. `element.dragged`
+ *   is still `true` when this event fires; it transitions to `false` after dispatch.
+ */
+export declare abstract class DropzoneBase extends DropzoneBase_base {
+    /**
+     * The size of the drop zone.
+     *
+     * @default m
+     */
+    size: DropzoneSize;
+    /**
+     * Whether files are currently being dragged over the drop zone.
+     * Set automatically by the component; also settable to reflect programmatic state.
+     *
+     * @attr dragged
+     * @default false
+     */
+    dragged: boolean;
+    /**
+     * Whether the drop zone has received a file and is in the filled state.
+     * Set by consuming code after a successful drop or browse-file selection to
+     * switch the zone to its filled visual.
+     *
+     * @attr filled
+     * @default false
+     */
+    filled: boolean;
+    /**
+     * The OS drag-cursor feedback shown while a file is held over the zone.
+     * Maps directly to `DataTransfer.dropEffect`. Settable via the `drop-effect`
+     * attribute, but property changes do not reflect back to the attribute
+     * because it controls browser chrome, not component state.
+     *
+     * @attr drop-effect
+     * @type {'copy' | 'move' | 'link' | 'none'}
+     * @default 'copy'
+     */
+    get dropEffect(): DropEffect;
+    set dropEffect(value: DropEffect | null);
+    /** @internal */
+    private _dropEffect;
+    protected constructor();
+    /** @internal */
+    private readonly _sizePropagation;
+    /** @internal */
+    protected handleDefaultSlotChange(): void;
+}
+export {};

package/dist/components/dropzone/Dropzone.base.js

@@ -0,0 +1,82 @@
+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 { DragAndDropController as n } from "../../controllers/drag-and-drop-controller/src/drag-and-drop-controller.js";
+import { DROPZONE_DEFAULT_DROP_EFFECT as r, DROPZONE_VALID_SIZES as i, DROP_EFFECTS as a, SWC_DROPZONE_DRAGLEAVE_EVENT as o, SWC_DROPZONE_DRAGOVER_EVENT as s, SWC_DROPZONE_DROP_EVENT as c, SWC_DROPZONE_SHOULD_ACCEPT_EVENT as l } from "./Dropzone.types.js";
+import { property as u } from "lit/decorators.js";
+import { SpectrumElement as d } from "@adobe/spectrum-wc-core/element/index.js";
+import { SizedMixin as f } from "@adobe/spectrum-wc-core/mixins/index.js";
+import { validateEnum as p } from "@adobe/spectrum-wc-core/utils/index.js";
+//#region components/dropzone/Dropzone.base.ts
+var m = class extends f(d, { validSizes: i }) {
+	get dropEffect() {
+		return this._dropEffect;
+	}
+	set dropEffect(e) {
+		if (e === null) {
+			let e = this._dropEffect;
+			this._dropEffect = r, this.requestUpdate("dropEffect", e);
+		} else if (a.includes(e)) {
+			let t = this._dropEffect;
+			this._dropEffect = e, this.requestUpdate("dropEffect", t);
+		} else p(this, {
+			prop: "drop-effect",
+			value: e,
+			valid: a,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-dropzone--docs"
+		});
+	}
+	constructor() {
+		super(), this.dragged = !1, this.filled = !1, this._dropEffect = r, this._sizePropagation = new t(this, {
+			attribute: "size",
+			getValue: () => this.size,
+			selector: "swc-illustrated-message"
+		}), new n(this, {
+			isDragged: () => this.dragged,
+			shouldAccept: (e) => this.dispatchEvent(new CustomEvent(l, {
+				bubbles: !0,
+				cancelable: !0,
+				composed: !0,
+				detail: e
+			})),
+			dropEffect: () => this._dropEffect,
+			onDragEnter: (e) => {
+				this.dragged = !0, this.dispatchEvent(new CustomEvent(s, {
+					bubbles: !0,
+					composed: !0,
+					detail: e
+				}));
+			},
+			onDragLeave: (e) => {
+				this.dragged = !1, this.dispatchEvent(new CustomEvent(o, {
+					bubbles: !0,
+					composed: !0,
+					detail: e
+				}));
+			},
+			onDrop: (e) => {
+				this.dispatchEvent(new CustomEvent(c, {
+					bubbles: !0,
+					composed: !0,
+					detail: e
+				})), this.dragged = !1;
+			}
+		});
+	}
+	handleDefaultSlotChange() {
+		this._sizePropagation.propagate();
+	}
+};
+e([u({
+	type: Boolean,
+	reflect: !0
+})], m.prototype, "dragged", void 0), e([u({
+	type: Boolean,
+	reflect: !0
+})], m.prototype, "filled", void 0), e([u({
+	type: String,
+	attribute: "drop-effect"
+})], m.prototype, "dropEffect", null);
+//#endregion
+export { m as DropzoneBase };
+
+//# sourceMappingURL=Dropzone.base.js.map

package/dist/components/dropzone/Dropzone.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dropzone.base.js","names":[],"sources":["../../../components/dropzone/Dropzone.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 { 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 { DragAndDropController } from '../../controllers/drag-and-drop-controller/index.js';\nimport { SlotAttributePropagationController } from '../../controllers/slot-attribute-propagation-controller/index.js';\nimport {\n  DROP_EFFECTS,\n  type DropEffect,\n  DROPZONE_DEFAULT_DROP_EFFECT,\n  DROPZONE_VALID_SIZES,\n  type DropzoneDragLeaveDetail,\n  type DropzoneSize,\n  SWC_DROPZONE_DRAGLEAVE_EVENT,\n  SWC_DROPZONE_DRAGOVER_EVENT,\n  SWC_DROPZONE_DROP_EVENT,\n  SWC_DROPZONE_SHOULD_ACCEPT_EVENT,\n} from './Dropzone.types.js';\n\n/**\n * Base class for the `<swc-dropzone>` drop zone component.\n *\n * Encapsulates all drag-and-drop event handling, state management, and\n * validation logic. Rendering, ARIA, and CSS are provided by the concrete\n * SWC subclass.\n *\n * @attribute {DropzoneSize} size - Controls the illustrated icon scale and container dimensions.\n *\n * @slot - Slot for the illustrated message and browse control. Hidden automatically when `filled` is true.\n * @slot filled-content - Slot for the uploaded-state content (e.g. an image preview). Shown automatically when `filled` is true; hidden otherwise.\n *\n * @fires swc-dropzone-should-accept - Cancelable event fired on every native `dragover`\n *   tick while a drag is over the zone, not just on entry. Cancel to reject the dragged\n *   payload and set the cursor to `none`.\n * @fires swc-dropzone-dragover - Fired once when dragged files enter the zone and are\n *   accepted; does not repeat on subsequent `dragover` ticks while still hovering.\n * @fires swc-dropzone-dragleave - Fired when an accepted drag leaves the zone after a\n *   100 ms debounce, or immediately when it becomes rejected. Detail is a plain snapshot\n *   `{ clientX, clientY, relatedTarget }` captured synchronously from the native event.\n * @fires swc-dropzone-drop - Fired when files are dropped on the zone. `element.dragged`\n *   is still `true` when this event fires; it transitions to `false` after dispatch.\n */\nexport abstract class DropzoneBase extends SizedMixin(SpectrumElement, {\n  validSizes: DROPZONE_VALID_SIZES,\n}) {\n  /**\n   * The size of the drop zone.\n   *\n   * @default m\n   */\n  declare public size: DropzoneSize;\n\n  // ──────────────────────────\n  //     SHARED API\n  // ──────────────────────────\n\n  /**\n   * Whether files are currently being dragged over the drop zone.\n   * Set automatically by the component; also settable to reflect programmatic state.\n   *\n   * @attr dragged\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public dragged = false;\n\n  /**\n   * Whether the drop zone has received a file and is in the filled state.\n   * Set by consuming code after a successful drop or browse-file selection to\n   * switch the zone to its filled visual.\n   *\n   * @attr filled\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public filled = false;\n\n  /**\n   * The OS drag-cursor feedback shown while a file is held over the zone.\n   * Maps directly to `DataTransfer.dropEffect`. Settable via the `drop-effect`\n   * attribute, but property changes do not reflect back to the attribute\n   * because it controls browser chrome, not component state.\n   *\n   * @attr drop-effect\n   * @type {'copy' | 'move' | 'link' | 'none'}\n   * @default 'copy'\n   */\n  @property({ type: String, attribute: 'drop-effect' })\n  public get dropEffect(): DropEffect {\n    return this._dropEffect;\n  }\n\n  public set dropEffect(value: DropEffect | null) {\n    // Lit passes `null` here when the `drop-effect` attribute is removed;\n    // treat that as \"reset to the default\" rather than an invalid value.\n    if (value === null) {\n      const oldValue = this._dropEffect;\n      this._dropEffect = DROPZONE_DEFAULT_DROP_EFFECT;\n      this.requestUpdate('dropEffect', oldValue);\n    } else if ((DROP_EFFECTS as readonly string[]).includes(value)) {\n      const oldValue = this._dropEffect;\n      this._dropEffect = value;\n      this.requestUpdate('dropEffect', oldValue);\n    } else {\n      validateEnum(this, {\n        prop: 'drop-effect',\n        value,\n        valid: DROP_EFFECTS,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-dropzone--docs',\n      });\n    }\n  }\n\n  /** @internal */\n  private _dropEffect: DropEffect = DROPZONE_DEFAULT_DROP_EFFECT;\n\n  // ──────────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────────\n\n  protected constructor() {\n    super();\n    new DragAndDropController(this, {\n      isDragged: () => this.dragged,\n      shouldAccept: (event) =>\n        this.dispatchEvent(\n          new CustomEvent<DragEvent>(SWC_DROPZONE_SHOULD_ACCEPT_EVENT, {\n            bubbles: true,\n            cancelable: true,\n            composed: true,\n            detail: event,\n          })\n        ),\n      dropEffect: () => this._dropEffect,\n      onDragEnter: (event) => {\n        this.dragged = true;\n        this.dispatchEvent(\n          new CustomEvent<DragEvent>(SWC_DROPZONE_DRAGOVER_EVENT, {\n            bubbles: true,\n            composed: true,\n            detail: event,\n          })\n        );\n      },\n      onDragLeave: (snapshot) => {\n        this.dragged = false;\n        this.dispatchEvent(\n          new CustomEvent<DropzoneDragLeaveDetail>(\n            SWC_DROPZONE_DRAGLEAVE_EVENT,\n            {\n              bubbles: true,\n              composed: true,\n              detail: snapshot,\n            }\n          )\n        );\n      },\n      onDrop: (event) => {\n        // Dispatch before clearing `dragged`; `updated()` handles the status region after `filled` settles.\n        this.dispatchEvent(\n          new CustomEvent<DragEvent>(SWC_DROPZONE_DROP_EVENT, {\n            bubbles: true,\n            composed: true,\n            detail: event,\n          })\n        );\n        this.dragged = false;\n      },\n    });\n  }\n\n  /** @internal */\n  private readonly _sizePropagation = new SlotAttributePropagationController(\n    this,\n    {\n      attribute: 'size',\n      getValue: () => this.size,\n      selector: 'swc-illustrated-message',\n    }\n  );\n\n  /** @internal */\n  protected handleDefaultSlotChange(): void {\n    this._sizePropagation.propagate();\n  }\n}\n"],"mappings":";;;;;;;;;AAwDA,IAAsB,IAAtB,cAA2C,EAAW,GAAiB,EACrE,YAAY,GACb,CAAC,CAAC;CA2CD,IACW,aAAyB;AAClC,SAAO,KAAK;;CAGd,IAAW,WAAW,GAA0B;AAG9C,MAAI,MAAU,MAAM;GAClB,IAAM,IAAW,KAAK;AAEtB,GADA,KAAK,cAAc,GACnB,KAAK,cAAc,cAAc,EAAS;aAChC,EAAmC,SAAS,EAAM,EAAE;GAC9D,IAAM,IAAW,KAAK;AAEtB,GADA,KAAK,cAAc,GACnB,KAAK,cAAc,cAAc,EAAS;QAE1C,GAAa,MAAM;GACjB,MAAM;GACN;GACA,OAAO;GACP,KAAK;GACN,CAAC;;CAWN,cAAwB;AAEtB,EADA,OAAO,iBAzDQ,kBAWD,uBAuCkB,2BA0DE,IAAI,EACtC,MACA;GACE,WAAW;GACX,gBAAgB,KAAK;GACrB,UAAU;GACX,CACF,EAzDC,IAAI,EAAsB,MAAM;GAC9B,iBAAiB,KAAK;GACtB,eAAe,MACb,KAAK,cACH,IAAI,YAAuB,GAAkC;IAC3D,SAAS;IACT,YAAY;IACZ,UAAU;IACV,QAAQ;IACT,CAAC,CACH;GACH,kBAAkB,KAAK;GACvB,cAAc,MAAU;AAEtB,IADA,KAAK,UAAU,IACf,KAAK,cACH,IAAI,YAAuB,GAA6B;KACtD,SAAS;KACT,UAAU;KACV,QAAQ;KACT,CAAC,CACH;;GAEH,cAAc,MAAa;AAEzB,IADA,KAAK,UAAU,IACf,KAAK,cACH,IAAI,YACF,GACA;KACE,SAAS;KACT,UAAU;KACV,QAAQ;KACT,CACF,CACF;;GAEH,SAAS,MAAU;AASjB,IAPA,KAAK,cACH,IAAI,YAAuB,GAAyB;KAClD,SAAS;KACT,UAAU;KACV,QAAQ;KACT,CAAC,CACH,EACD,KAAK,UAAU;;GAElB,CAAC;;CAcJ,0BAA0C;AACxC,OAAK,iBAAiB,WAAW;;;GAxHlC,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA,KAW1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,UAAA,KAAA,EAAA,KAa1C,EAAS;CAAE,MAAM;CAAQ,WAAW;CAAe,CAAC,CAAA,EAAA,EAAA,WAAA,cAAA,KAAA"}

package/dist/components/dropzone/Dropzone.types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 type DropzoneSize = 's' | 'm' | 'l';
+export declare const DROPZONE_VALID_SIZES: readonly ["s", "m", "l"];
+/** Valid OS drag-cursor feedback values for the drop zone. */
+export type DropEffect = 'copy' | 'move' | 'link' | 'none';
+export declare const DROP_EFFECTS: readonly ["copy", "move", "link", "none"];
+export declare const DROPZONE_DEFAULT_DROP_EFFECT: "copy";
+/** Fired when files are dragged over the drop zone; cancelable to reject. */
+export declare const SWC_DROPZONE_SHOULD_ACCEPT_EVENT = "swc-dropzone-should-accept";
+/** Fired when files are dragged over the drop zone and accepted. */
+export declare const SWC_DROPZONE_DRAGOVER_EVENT = "swc-dropzone-dragover";
+/** Fired when an accepted drag leaves the drop zone or becomes rejected. */
+export declare const SWC_DROPZONE_DRAGLEAVE_EVENT = "swc-dropzone-dragleave";
+/** Fired when files are dropped on the drop zone. */
+export declare const SWC_DROPZONE_DROP_EVENT = "swc-dropzone-drop";
+/**
+ * Detail emitted with `swc-dropzone-dragleave`. Values are captured synchronously
+ * from the native `DragEvent` before the 100 ms debounce timer fires, preventing
+ * stale reads from a recycled event object.
+ */
+export interface DropzoneDragLeaveDetail {
+    clientX: number;
+    clientY: number;
+    relatedTarget: EventTarget | null;
+}
+declare global {
+    interface GlobalEventHandlersEventMap {
+        [SWC_DROPZONE_SHOULD_ACCEPT_EVENT]: CustomEvent<DragEvent>;
+        [SWC_DROPZONE_DRAGOVER_EVENT]: CustomEvent<DragEvent>;
+        [SWC_DROPZONE_DRAGLEAVE_EVENT]: CustomEvent<DropzoneDragLeaveDetail>;
+        [SWC_DROPZONE_DROP_EVENT]: CustomEvent<DragEvent>;
+    }
+}

package/dist/components/dropzone/Dropzone.types.js

@@ -0,0 +1,15 @@
+//#region components/dropzone/Dropzone.types.ts
+var e = [
+	"s",
+	"m",
+	"l"
+], t = [
+	"copy",
+	"move",
+	"link",
+	"none"
+], n = "copy", r = "swc-dropzone-should-accept", i = "swc-dropzone-dragover", a = "swc-dropzone-dragleave", o = "swc-dropzone-drop";
+//#endregion
+export { n as DROPZONE_DEFAULT_DROP_EFFECT, e as DROPZONE_VALID_SIZES, t as DROP_EFFECTS, a as SWC_DROPZONE_DRAGLEAVE_EVENT, i as SWC_DROPZONE_DRAGOVER_EVENT, o as SWC_DROPZONE_DROP_EVENT, r as SWC_DROPZONE_SHOULD_ACCEPT_EVENT };
+
+//# sourceMappingURL=Dropzone.types.js.map

package/dist/components/dropzone/Dropzone.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dropzone.types.js","names":[],"sources":["../../../components/dropzone/Dropzone.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\n// ──────────────────\n//     SIZES\n// ──────────────────\n\nexport type DropzoneSize = 's' | 'm' | 'l';\n\nexport const DROPZONE_VALID_SIZES = [\n  's',\n  'm',\n  'l',\n] as const satisfies readonly DropzoneSize[];\n\n// ──────────────────\n//     DROP EFFECT\n// ──────────────────\n\n/** Valid OS drag-cursor feedback values for the drop zone. */\nexport type DropEffect = 'copy' | 'move' | 'link' | 'none';\n\nexport const DROP_EFFECTS = [\n  'copy',\n  'move',\n  'link',\n  'none',\n] as const satisfies readonly DropEffect[];\n\nexport const DROPZONE_DEFAULT_DROP_EFFECT =\n  'copy' as const satisfies DropEffect;\n\n// ──────────────────\n//     EVENTS\n// ──────────────────\n\n/** Fired when files are dragged over the drop zone; cancelable to reject. */\nexport const SWC_DROPZONE_SHOULD_ACCEPT_EVENT = 'swc-dropzone-should-accept';\n\n/** Fired when files are dragged over the drop zone and accepted. */\nexport const SWC_DROPZONE_DRAGOVER_EVENT = 'swc-dropzone-dragover';\n\n/** Fired when an accepted drag leaves the drop zone or becomes rejected. */\nexport const SWC_DROPZONE_DRAGLEAVE_EVENT = 'swc-dropzone-dragleave';\n\n/** Fired when files are dropped on the drop zone. */\nexport const SWC_DROPZONE_DROP_EVENT = 'swc-dropzone-drop';\n\n/**\n * Detail emitted with `swc-dropzone-dragleave`. Values are captured synchronously\n * from the native `DragEvent` before the 100 ms debounce timer fires, preventing\n * stale reads from a recycled event object.\n */\nexport interface DropzoneDragLeaveDetail {\n  clientX: number;\n  clientY: number;\n  relatedTarget: EventTarget | null;\n}\n\ndeclare global {\n  interface GlobalEventHandlersEventMap {\n    [SWC_DROPZONE_SHOULD_ACCEPT_EVENT]: CustomEvent<DragEvent>;\n    [SWC_DROPZONE_DRAGOVER_EVENT]: CustomEvent<DragEvent>;\n    [SWC_DROPZONE_DRAGLEAVE_EVENT]: CustomEvent<DropzoneDragLeaveDetail>;\n    [SWC_DROPZONE_DROP_EVENT]: CustomEvent<DragEvent>;\n  }\n}\n"],"mappings":";AAkBA,IAAa,IAAuB;CAClC;CACA;CACA;CACD,EASY,IAAe;CAC1B;CACA;CACA;CACA;CACD,EAEY,IACX,QAOW,IAAmC,8BAGnC,IAA8B,yBAG9B,IAA+B,0BAG/B,IAA0B"}

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

package/dist/components/dropzone/index.js

@@ -0,0 +1,3 @@
+import { DROPZONE_DEFAULT_DROP_EFFECT as e, DROPZONE_VALID_SIZES as t, DROP_EFFECTS as n, SWC_DROPZONE_DRAGLEAVE_EVENT as r, SWC_DROPZONE_DRAGOVER_EVENT as i, SWC_DROPZONE_DROP_EVENT as a, SWC_DROPZONE_SHOULD_ACCEPT_EVENT as o } from "./Dropzone.types.js";
+import { DropzoneBase as s } from "./Dropzone.base.js";
+export { e as DROPZONE_DEFAULT_DROP_EFFECT, t as DROPZONE_VALID_SIZES, n as DROP_EFFECTS, s as DropzoneBase, r as SWC_DROPZONE_DRAGLEAVE_EVENT, i as SWC_DROPZONE_DRAGOVER_EVENT, a as SWC_DROPZONE_DROP_EVENT, o as SWC_DROPZONE_SHOULD_ACCEPT_EVENT };

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