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

package/dist/controllers/slot-presence-controller/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 { SlotPresenceController } from './src/slot-presence-controller.js';

package/dist/controllers/slot-presence-controller/index.js

@@ -0,0 +1,2 @@
+import { SlotPresenceController as e } from "./src/slot-presence-controller.js";
+export { e as SlotPresenceController };

package/dist/controllers/slot-presence-controller/src/slot-presence-controller.d.ts

@@ -0,0 +1,57 @@
+import { ReactiveController, ReactiveElement } from 'lit';
+/**
+ * A reactive controller that observes whether slotted content matching
+ * given CSS selectors is present in the host's light DOM.
+ *
+ * Replaces the `ObserveSlotPresence` mixin with a composition-based approach.
+ *
+ * @example
+ * ```typescript
+ * class MyComponent extends SpectrumElement {
+ *   private slotPresence = new SlotPresenceController(this, '[slot="icon"]');
+ *
+ *   get hasIcon(): boolean {
+ *     return this.slotPresence.isPresent;
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Observing multiple selectors
+ * class MyComponent extends SpectrumElement {
+ *   private slotPresence = new SlotPresenceController(this, [
+ *     '[slot="icon"]',
+ *     '[slot="description"]',
+ *   ]);
+ *
+ *   get hasIcon(): boolean {
+ *     return this.slotPresence.getPresence('[slot="icon"]');
+ *   }
+ *
+ *   get hasDescription(): boolean {
+ *     return this.slotPresence.getPresence('[slot="description"]');
+ *   }
+ * }
+ * ```
+ */
+export declare class SlotPresenceController implements ReactiveController {
+    private host;
+    private selectors;
+    private presenceMap;
+    private observer;
+    constructor(host: ReactiveElement, selectors: string | string[]);
+    /**
+     * Whether slotted content is present. Use this when observing a single
+     * selector. Throws if multiple selectors were provided — use
+     * `getPresence(selector)` instead.
+     */
+    get isPresent(): boolean;
+    /**
+     * Returns whether content matching the given selector is present.
+     */
+    getPresence(selector: string): boolean;
+    private checkPresence;
+    hostConnected(): void;
+    hostDisconnected(): void;
+}

package/dist/controllers/slot-presence-controller/src/slot-presence-controller.js

@@ -0,0 +1,44 @@
+//#region controllers/slot-presence-controller/src/slot-presence-controller.ts
+var e = class {
+	constructor(e, t) {
+		this.presenceMap = /* @__PURE__ */ new Map(), this.host = e, this.selectors = Array.isArray(t) ? t : [t], this.host.addController(this), this.observer = new MutationObserver(() => {
+			this.checkPresence();
+		}), this.checkPresence();
+	}
+	get isPresent() {
+		if (this.selectors.length === 1) {
+			var e;
+			return (e = this.presenceMap.get(this.selectors[0])) == null ? !1 : e;
+		}
+		throw Error("Multiple selectors provided to SlotPresenceController — use getPresence(selector) instead.");
+	}
+	getPresence(e) {
+		if (this.presenceMap.has(e)) {
+			var t;
+			return (t = this.presenceMap.get(e)) == null ? !1 : t;
+		}
+		throw Error(`The provided selector \`${e}\` is not being observed.`);
+	}
+	checkPresence() {
+		let e = !1;
+		for (let n of this.selectors) {
+			var t;
+			let r = !!this.host.querySelector(`:scope > ${n}`);
+			((t = this.presenceMap.get(n)) == null ? !1 : t) !== r && (e = !0), this.presenceMap.set(n, r);
+		}
+		e && this.host.requestUpdate();
+	}
+	hostConnected() {
+		this.observer.observe(this.host, {
+			childList: !0,
+			subtree: !0
+		}), this.checkPresence();
+	}
+	hostDisconnected() {
+		this.observer.disconnect();
+	}
+};
+//#endregion
+export { e as SlotPresenceController };
+
+//# sourceMappingURL=slot-presence-controller.js.map

package/dist/controllers/slot-presence-controller/src/slot-presence-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-presence-controller.js","names":[],"sources":["../../../../controllers/slot-presence-controller/src/slot-presence-controller.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 { ReactiveController, ReactiveElement } from 'lit';\n\n/**\n * A reactive controller that observes whether slotted content matching\n * given CSS selectors is present in the host's light DOM.\n *\n * Replaces the `ObserveSlotPresence` mixin with a composition-based approach.\n *\n * @example\n * ```typescript\n * class MyComponent extends SpectrumElement {\n *   private slotPresence = new SlotPresenceController(this, '[slot=\"icon\"]');\n *\n *   get hasIcon(): boolean {\n *     return this.slotPresence.isPresent;\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Observing multiple selectors\n * class MyComponent extends SpectrumElement {\n *   private slotPresence = new SlotPresenceController(this, [\n *     '[slot=\"icon\"]',\n *     '[slot=\"description\"]',\n *   ]);\n *\n *   get hasIcon(): boolean {\n *     return this.slotPresence.getPresence('[slot=\"icon\"]');\n *   }\n *\n *   get hasDescription(): boolean {\n *     return this.slotPresence.getPresence('[slot=\"description\"]');\n *   }\n * }\n * ```\n */\nexport class SlotPresenceController implements ReactiveController {\n  private host: ReactiveElement;\n  private selectors: string[];\n  private presenceMap = new Map<string, boolean>();\n  private observer: MutationObserver;\n\n  constructor(host: ReactiveElement, selectors: string | string[]) {\n    this.host = host;\n    this.selectors = Array.isArray(selectors) ? selectors : [selectors];\n    this.host.addController(this);\n\n    this.observer = new MutationObserver(() => {\n      this.checkPresence();\n    });\n\n    // Check initial state synchronously\n    this.checkPresence();\n  }\n\n  /**\n   * Whether slotted content is present. Use this when observing a single\n   * selector. Throws if multiple selectors were provided — use\n   * `getPresence(selector)` instead.\n   */\n  get isPresent(): boolean {\n    if (this.selectors.length === 1) {\n      return this.presenceMap.get(this.selectors[0]) ?? false;\n    }\n    throw new Error(\n      'Multiple selectors provided to SlotPresenceController — use getPresence(selector) instead.'\n    );\n  }\n\n  /**\n   * Returns whether content matching the given selector is present.\n   */\n  getPresence(selector: string): boolean {\n    if (this.presenceMap.has(selector)) {\n      return this.presenceMap.get(selector) ?? false;\n    }\n    throw new Error(\n      `The provided selector \\`${selector}\\` is not being observed.`\n    );\n  }\n\n  private checkPresence(): void {\n    let changed = false;\n    for (const selector of this.selectors) {\n      const nextValue = !!this.host.querySelector(`:scope > ${selector}`);\n      const previousValue = this.presenceMap.get(selector) ?? false;\n      if (previousValue !== nextValue) {\n        changed = true;\n      }\n      this.presenceMap.set(selector, nextValue);\n    }\n    if (changed) {\n      // The `ObserveSlotPresence` mixin this controller replaces deferred the\n      // re-render with `this.updateComplete.then(() => this.requestUpdate())`.\n      // The controller requests the update synchronously instead. This is\n      // safe because `checkPresence` only runs from the constructor, the\n      // `MutationObserver` callback, and `hostConnected` — never from inside\n      // the host's own `update()`/`render()` — so there is no re-entrant\n      // update. Lit batches `requestUpdate()` calls into the next microtask,\n      // so multiple presence changes in one tick still coalesce into a single\n      // render. See the controller stories for the behavioral test.\n      this.host.requestUpdate();\n    }\n  }\n\n  hostConnected(): void {\n    this.observer.observe(this.host, {\n      childList: true,\n      subtree: true,\n    });\n    this.checkPresence();\n  }\n\n  hostDisconnected(): void {\n    this.observer.disconnect();\n  }\n}\n"],"mappings":";AAkDA,IAAa,IAAb,MAAkE;CAMhE,YAAY,GAAuB,GAA8B;AAU/D,qCAboB,IAAI,KAAsB,EAI9C,KAAK,OAAO,GACZ,KAAK,YAAY,MAAM,QAAQ,EAAU,GAAG,IAAY,CAAC,EAAU,EACnE,KAAK,KAAK,cAAc,KAAK,EAE7B,KAAK,WAAW,IAAI,uBAAuB;AACzC,QAAK,eAAe;IACpB,EAGF,KAAK,eAAe;;CAQtB,IAAI,YAAqB;AACvB,MAAI,KAAK,UAAU,WAAW,GAAG;;AAC/B,WAAA,IAAO,KAAK,YAAY,IAAI,KAAK,UAAU,GAAG,KAAA,OAAI,KAAJ;;AAEhD,QAAU,MACR,6FACD;;CAMH,YAAY,GAA2B;AACrC,MAAI,KAAK,YAAY,IAAI,EAAS,EAAE;;AAClC,WAAA,IAAO,KAAK,YAAY,IAAI,EAAS,KAAA,OAAI,KAAJ;;AAEvC,QAAU,MACR,2BAA2B,EAAS,2BACrC;;CAGH,gBAA8B;EAC5B,IAAI,IAAU;AACd,OAAK,IAAM,KAAY,KAAK,WAAW;;GACrC,IAAM,IAAY,CAAC,CAAC,KAAK,KAAK,cAAc,YAAY,IAAW;AAKnE,KAHA,IADsB,KAAK,YAAY,IAAI,EAAS,KAAA,OAAI,KAAJ,OAC9B,MACpB,IAAU,KAEZ,KAAK,YAAY,IAAI,GAAU,EAAU;;AAE3C,EAAI,KAUF,KAAK,KAAK,eAAe;;CAI7B,gBAAsB;AAKpB,EAJA,KAAK,SAAS,QAAQ,KAAK,MAAM;GAC/B,WAAW;GACX,SAAS;GACV,CAAC,EACF,KAAK,eAAe;;CAGtB,mBAAyB;AACvB,OAAK,SAAS,YAAY"}

package/dist/controllers/slot-text-controller/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 { SlotTextController, type SlotTextConfig, } from './src/slot-text-controller.js';

package/dist/controllers/slot-text-controller/index.js

@@ -0,0 +1,2 @@
+import { SlotTextController as e } from "./src/slot-text-controller.js";
+export { e as SlotTextController };

package/dist/controllers/slot-text-controller/src/slot-text-controller.d.ts

@@ -0,0 +1,92 @@
+import { ReactiveController, ReactiveElement } from 'lit';
+export interface SlotTextConfig {
+    /**
+     * The slot name to observe. Use `''` (empty string) for the default slot.
+     *
+     * @default '' (default slot)
+     */
+    slotName?: string;
+    /**
+     * CSS selectors for elements to exclude when checking for content.
+     * Matched elements are ignored — only non-excluded elements and
+     * non-empty text nodes count as "content."
+     */
+    excludeSelectors?: string[];
+}
+/**
+ * A reactive controller that observes whether a slot contains meaningful
+ * text or element content.
+ *
+ * Replaces the `ObserveSlotText` mixin with a composition-based approach.
+ *
+ * Monitors for `characterData` mutations (text changes) and re-evaluates
+ * on slot change events. The host is requested to update whenever the
+ * content state changes.
+ *
+ * @example
+ * ```typescript
+ * class MyButton extends SpectrumElement {
+ *   private slotText = new SlotTextController(this);
+ *
+ *   get hasLabel(): boolean {
+ *     return this.slotText.hasContent;
+ *   }
+ *
+ *   override render() {
+ *     return html`<slot @slotchange=${this.slotText.handleSlotChange}></slot>`;
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Named slot with exclusions
+ * class MyComponent extends SpectrumElement {
+ *   private slotText = new SlotTextController(this, {
+ *     slotName: 'description',
+ *     excludeSelectors: ['.visually-hidden'],
+ *   });
+ * }
+ * ```
+ */
+export declare class SlotTextController implements ReactiveController {
+    private host;
+    private slotName;
+    private excludeSelectors;
+    private observer;
+    private _hasContent;
+    constructor(host: ReactiveElement, config?: SlotTextConfig);
+    /**
+     * Whether the observed slot has meaningful content (text nodes or
+     * non-excluded elements).
+     */
+    get hasContent(): boolean;
+    /**
+     * Bind this to the slot's `@slotchange` event in the template.
+     *
+     * @example
+     * ```html
+     * <slot @slotchange=${this.slotText.handleSlotChange}></slot>
+     * ```
+     */
+    handleSlotChange: (event: Event) => void;
+    private evaluateNodes;
+    /**
+     * Checks initial content from light DOM children before the first render,
+     * before slots are assigned.
+     *
+     * This runs from `hostConnected`, which Lit invokes during the host's
+     * `connectedCallback` — before the first `update()`. It sets `_hasContent`
+     * directly and intentionally does not call `requestUpdate()`: the first
+     * render has not happened yet, so it will read the correct value when it
+     * runs. This differs from the `ObserveSlotText` mixin, where `slotHasContent`
+     * was a reactive `@property` assigned in `update()`. After the first render,
+     * `handleSlotChange` (bound via `@slotchange`) and the `characterData`
+     * observer take over and do call `requestUpdate()` on change. The
+     * controller stories cover initial content being reflected on first paint.
+     */
+    private checkInitialContent;
+    private checkContent;
+    hostConnected(): void;
+    hostDisconnected(): void;
+}

package/dist/controllers/slot-text-controller/src/slot-text-controller.js

@@ -0,0 +1,53 @@
+//#region controllers/slot-text-controller/src/slot-text-controller.ts
+var e = class {
+	constructor(e, t = {}) {
+		var n, r;
+		this._hasContent = !1, this.handleSlotChange = (e) => {
+			let t = e.target.assignedNodes({ flatten: !0 });
+			this.evaluateNodes(t);
+		}, this.host = e, this.slotName = (n = t.slotName) == null ? "" : n, this.excludeSelectors = (r = t.excludeSelectors) == null ? [] : r, this.host.addController(this), this.observer = new MutationObserver((e) => {
+			for (let t of e) if (t.type === "characterData") {
+				this.checkContent();
+				return;
+			}
+		});
+	}
+	get hasContent() {
+		return this._hasContent;
+	}
+	evaluateNodes(e) {
+		let t = [...e].some((e) => {
+			let t = e;
+			return t.tagName ? !this.excludeSelectors.some((e) => t.matches(e)) : this.slotName ? !1 : e.nodeType === Node.TEXT_NODE && e.textContent ? e.textContent.trim().length > 0 : !1;
+		});
+		t !== this._hasContent && (this._hasContent = t, this.host.requestUpdate());
+	}
+	checkInitialContent() {
+		let { childNodes: e } = this.host;
+		this._hasContent = [...e].filter((e) => {
+			let t = e;
+			return t.tagName ? this.excludeSelectors.some((e) => t.matches(e)) ? !1 : this.slotName ? t.getAttribute("slot") === this.slotName : !t.hasAttribute("slot") : this.slotName ? !1 : e.nodeType === Node.TEXT_NODE && e.textContent ? e.textContent.trim().length > 0 : !1;
+		}).length > 0;
+	}
+	checkContent() {
+		var e;
+		let t = (e = this.host.shadowRoot) == null ? void 0 : e.querySelector(this.slotName ? `slot[name="${this.slotName}"]` : "slot:not([name])");
+		if (t) {
+			let e = t.assignedNodes({ flatten: !0 });
+			this.evaluateNodes(e);
+		}
+	}
+	hostConnected() {
+		this.observer.observe(this.host, {
+			characterData: !0,
+			subtree: !0
+		}), this.checkInitialContent();
+	}
+	hostDisconnected() {
+		this.observer.disconnect();
+	}
+};
+//#endregion
+export { e as SlotTextController };
+
+//# sourceMappingURL=slot-text-controller.js.map

package/dist/controllers/slot-text-controller/src/slot-text-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-text-controller.js","names":[],"sources":["../../../../controllers/slot-text-controller/src/slot-text-controller.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 { ReactiveController, ReactiveElement } from 'lit';\n\nexport interface SlotTextConfig {\n  /**\n   * The slot name to observe. Use `''` (empty string) for the default slot.\n   *\n   * @default '' (default slot)\n   */\n  slotName?: string;\n\n  /**\n   * CSS selectors for elements to exclude when checking for content.\n   * Matched elements are ignored — only non-excluded elements and\n   * non-empty text nodes count as \"content.\"\n   */\n  excludeSelectors?: string[];\n}\n\n/**\n * A reactive controller that observes whether a slot contains meaningful\n * text or element content.\n *\n * Replaces the `ObserveSlotText` mixin with a composition-based approach.\n *\n * Monitors for `characterData` mutations (text changes) and re-evaluates\n * on slot change events. The host is requested to update whenever the\n * content state changes.\n *\n * @example\n * ```typescript\n * class MyButton extends SpectrumElement {\n *   private slotText = new SlotTextController(this);\n *\n *   get hasLabel(): boolean {\n *     return this.slotText.hasContent;\n *   }\n *\n *   override render() {\n *     return html`<slot @slotchange=${this.slotText.handleSlotChange}></slot>`;\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Named slot with exclusions\n * class MyComponent extends SpectrumElement {\n *   private slotText = new SlotTextController(this, {\n *     slotName: 'description',\n *     excludeSelectors: ['.visually-hidden'],\n *   });\n * }\n * ```\n */\nexport class SlotTextController implements ReactiveController {\n  private host: ReactiveElement;\n  private slotName: string;\n  private excludeSelectors: string[];\n  private observer: MutationObserver;\n  private _hasContent = false;\n\n  constructor(host: ReactiveElement, config: SlotTextConfig = {}) {\n    this.host = host;\n    this.slotName = config.slotName ?? '';\n    this.excludeSelectors = config.excludeSelectors ?? [];\n    this.host.addController(this);\n\n    this.observer = new MutationObserver((mutations) => {\n      for (const mutation of mutations) {\n        if (mutation.type === 'characterData') {\n          this.checkContent();\n          return;\n        }\n      }\n    });\n  }\n\n  /**\n   * Whether the observed slot has meaningful content (text nodes or\n   * non-excluded elements).\n   */\n  get hasContent(): boolean {\n    return this._hasContent;\n  }\n\n  /**\n   * Bind this to the slot's `@slotchange` event in the template.\n   *\n   * @example\n   * ```html\n   * <slot @slotchange=${this.slotText.handleSlotChange}></slot>\n   * ```\n   */\n  handleSlotChange = (event: Event): void => {\n    const slot = event.target as HTMLSlotElement;\n    const nodes = slot.assignedNodes({ flatten: true });\n    this.evaluateNodes(nodes);\n  };\n\n  private evaluateNodes(nodes: Iterable<Node>): void {\n    const hasContent = [...nodes].some((node) => {\n      const el = node as HTMLElement;\n      if (el.tagName) {\n        return !this.excludeSelectors.some((sel) => el.matches(sel));\n      }\n      // A bare text node can never carry a `slot` attribute, so it is only\n      // ever assigned to the default slot. When observing a named slot it must\n      // not count as content.\n      if (this.slotName) {\n        return false;\n      }\n      // Only real text nodes count. Comment nodes (e.g. Lit's child-part\n      // markers left behind by a `${cond ? nothing : label}` binding) also\n      // lack a `tagName`, and their `textContent` is the marker data, which\n      // would otherwise be misread as label text.\n      return node.nodeType === Node.TEXT_NODE && node.textContent\n        ? node.textContent.trim().length > 0\n        : false;\n    });\n\n    if (hasContent !== this._hasContent) {\n      this._hasContent = hasContent;\n      this.host.requestUpdate();\n    }\n  }\n\n  /**\n   * Checks initial content from light DOM children before the first render,\n   * before slots are assigned.\n   *\n   * This runs from `hostConnected`, which Lit invokes during the host's\n   * `connectedCallback` — before the first `update()`. It sets `_hasContent`\n   * directly and intentionally does not call `requestUpdate()`: the first\n   * render has not happened yet, so it will read the correct value when it\n   * runs. This differs from the `ObserveSlotText` mixin, where `slotHasContent`\n   * was a reactive `@property` assigned in `update()`. After the first render,\n   * `handleSlotChange` (bound via `@slotchange`) and the `characterData`\n   * observer take over and do call `requestUpdate()` on change. The\n   * controller stories cover initial content being reflected on first paint.\n   */\n  private checkInitialContent(): void {\n    const { childNodes } = this.host;\n    const relevant = [...childNodes].filter((node) => {\n      const el = node as HTMLElement;\n      if (el.tagName) {\n        const excluded = this.excludeSelectors.some((sel) => el.matches(sel));\n        if (excluded) {\n          return false;\n        }\n        // Match slot assignment: named slot checks slot attribute,\n        // default slot checks for no slot attribute\n        return this.slotName\n          ? el.getAttribute('slot') === this.slotName\n          : !el.hasAttribute('slot');\n      }\n      // A bare text node has no `slot` attribute, so it is only assigned to\n      // the default slot; it never counts as content for a named slot.\n      if (this.slotName) {\n        return false;\n      }\n      // Only real text nodes count. Comment nodes (e.g. Lit's child-part\n      // markers left behind by a `${cond ? nothing : label}` binding) also\n      // lack a `tagName`, and their `textContent` is the marker data, which\n      // would otherwise be misread as label text.\n      return node.nodeType === Node.TEXT_NODE && node.textContent\n        ? node.textContent.trim().length > 0\n        : false;\n    });\n    this._hasContent = relevant.length > 0;\n  }\n\n  private checkContent(): void {\n    // Re-query assigned nodes from the slot element in the shadow root\n    const slot = this.host.shadowRoot?.querySelector(\n      this.slotName ? `slot[name=\"${this.slotName}\"]` : 'slot:not([name])'\n    ) as HTMLSlotElement | null;\n    if (slot) {\n      const nodes = slot.assignedNodes({ flatten: true });\n      this.evaluateNodes(nodes);\n    }\n  }\n\n  hostConnected(): void {\n    this.observer.observe(this.host, {\n      characterData: true,\n      subtree: true,\n    });\n    this.checkInitialContent();\n  }\n\n  hostDisconnected(): void {\n    this.observer.disconnect();\n  }\n}\n"],"mappings":";AAkEA,IAAa,IAAb,MAA8D;CAO5D,YAAY,GAAuB,IAAyB,EAAE,EAAE;;AAM9D,qBARoB,6BAkCF,MAAuB;GAEzC,IAAM,IADO,EAAM,OACA,cAAc,EAAE,SAAS,IAAM,CAAC;AACnD,QAAK,cAAc,EAAM;KAlCzB,KAAK,OAAO,GACZ,KAAK,YAAA,IAAW,EAAO,aAAA,OAAY,KAAZ,GACvB,KAAK,oBAAA,IAAmB,EAAO,qBAAA,OAAoB,EAAE,GAAtB,GAC/B,KAAK,KAAK,cAAc,KAAK,EAE7B,KAAK,WAAW,IAAI,kBAAkB,MAAc;AAClD,QAAK,IAAM,KAAY,EACrB,KAAI,EAAS,SAAS,iBAAiB;AACrC,SAAK,cAAc;AACnB;;IAGJ;;CAOJ,IAAI,aAAsB;AACxB,SAAO,KAAK;;CAiBd,cAAsB,GAA6B;EACjD,IAAM,IAAa,CAAC,GAAG,EAAM,CAAC,MAAM,MAAS;GAC3C,IAAM,IAAK;AAcX,UAbI,EAAG,UACE,CAAC,KAAK,iBAAiB,MAAM,MAAQ,EAAG,QAAQ,EAAI,CAAC,GAK1D,KAAK,WACA,KAMF,EAAK,aAAa,KAAK,aAAa,EAAK,cAC5C,EAAK,YAAY,MAAM,CAAC,SAAS,IACjC;IACJ;AAEF,EAAI,MAAe,KAAK,gBACtB,KAAK,cAAc,GACnB,KAAK,KAAK,eAAe;;CAkB7B,sBAAoC;EAClC,IAAM,EAAE,kBAAe,KAAK;AA2B5B,OAAK,cA1BY,CAAC,GAAG,EAAW,CAAC,QAAQ,MAAS;GAChD,IAAM,IAAK;AAqBX,UApBI,EAAG,UACY,KAAK,iBAAiB,MAAM,MAAQ,EAAG,QAAQ,EAAI,CAAC,GAE5D,KAIF,KAAK,WACR,EAAG,aAAa,OAAO,KAAK,KAAK,WACjC,CAAC,EAAG,aAAa,OAAO,GAI1B,KAAK,WACA,KAMF,EAAK,aAAa,KAAK,aAAa,EAAK,cAC5C,EAAK,YAAY,MAAM,CAAC,SAAS,IACjC;IACJ,CAC0B,SAAS;;CAGvC,eAA6B;;EAE3B,IAAM,KAAA,IAAO,KAAK,KAAK,eAAA,OAAA,KAAA,IAAA,EAAY,cACjC,KAAK,WAAW,cAAc,KAAK,SAAS,MAAM,mBACnD;AACD,MAAI,GAAM;GACR,IAAM,IAAQ,EAAK,cAAc,EAAE,SAAS,IAAM,CAAC;AACnD,QAAK,cAAc,EAAM;;;CAI7B,gBAAsB;AAKpB,EAJA,KAAK,SAAS,QAAQ,KAAK,MAAM;GAC/B,eAAe;GACf,SAAS;GACV,CAAC,EACF,KAAK,qBAAqB;;CAG5B,mBAAyB;AACvB,OAAK,SAAS,YAAY"}

package/dist/element/index.d.ts

@@ -10,5 +10,5 @@
  * governing permissions and limitations under the License.
  */
 export { defineElement } from './define-element.js';
-export { SpectrumElement, SpectrumMixin, type SpectrumInterface, } from './spectrum-element.js';
+export { SpectrumElement } from './spectrum-element.js';
 export { coreVersion, version } from './version.js';

package/dist/element/index.js

@@ -1,4 +1,4 @@
 import { defineElement as e } from "./define-element.js";
 import { coreVersion as t, version as n } from "./version.js";
-import { SpectrumElement as r, SpectrumMixin as i } from "./spectrum-element.js";
-export { r as SpectrumElement, i as SpectrumMixin, t as coreVersion, e as defineElement, n as version };
+import { SpectrumElement as r } from "./spectrum-element.js";
+export { r as SpectrumElement, t as coreVersion, e as defineElement, n as version };

package/dist/element/spectrum-element.d.ts

@@ -1,15 +1,5 @@
-import { LitElement, ReactiveElement } from 'lit';
-type Constructor<T = Record<string, unknown>> = {
-    new (...args: any[]): T;
-    prototype: T;
-};
-export interface SpectrumInterface {
-    shadowRoot: ShadowRoot;
-    hasVisibleFocusInTree(): boolean;
-}
-export declare function SpectrumMixin<T extends Constructor<ReactiveElement>>(constructor: T): T & Constructor<SpectrumInterface>;
-declare const SpectrumElement_base: typeof LitElement & Constructor<SpectrumInterface>;
-export declare class SpectrumElement extends SpectrumElement_base {
+import { LitElement } from 'lit';
+export declare class SpectrumElement extends LitElement {
     /**
      * @internal
      */
@@ -18,9 +8,62 @@ export declare class SpectrumElement extends SpectrumElement_base {
      * @internal
      */
     static CORE_VERSION: string;
+}
+/**
+ * Builds the deduplication key for a dev-mode warning. The `message` is part of
+ * the key so two distinct problems that share a `type`/`level` (the common
+ * case) do not suppress each other; only a verbatim repeat of the same warning
+ * is deduplicated. Exported so the dedup key can be unit tested without relying
+ * on the `NODE_ENV`-gated `window.__swc` setup below.
+ */
+export declare function warningId(localName: string, type: WarningType, level: WarningLevel, message: string): BrandedSWCWarningID;
+/**
+ * A group of dev-mode warnings that share a `warningId`, collected within a
+ * single microtask so they can be emitted as one console line with a count.
+ */
+type BatchedWarning = {
+    message: string;
+    url: string;
+    localName: string;
+    type: WarningType;
+    level: WarningLevel;
+    listedIssues: string;
+    elements: HTMLElement[];
+    count: number;
     /**
-     * @internal
+     * Elements already counted in this batch, keyed by identity. A repeated
+     * `warn()` for an element already here does not bump `count` again.
      */
-    get dir(): CSSStyleDeclaration['direction'];
-}
+    countedElements?: Set<HTMLElement>;
+    /**
+     * Whether the dev-mode warning (the only warning with no element) has been
+     * counted, so repeats of it collapse to one.
+     */
+    countedDevModeWarning?: boolean;
+};
+/**
+ * Builds the `console.warn` arguments for a grouped dev warning: the message
+ * and a count line, then the element ref(s) to inspect. By default one
+ * representative element is shown; `verbose` shows every collected element
+ * (already capped at collection time). Exported so the grouped output can be
+ * unit tested without the `NODE_ENV`-gated `window.__swc` setup below.
+ *
+ * @internal
+ */
+export declare function buildGroupedWarningArgs(batch: BatchedWarning, verbose: boolean): unknown[];
+/**
+ * Records one warning occurrence into its batch, counting by element identity:
+ * `count` becomes the number of distinct elements with this warning, not the
+ * number of `warn()` calls. A host that warns once per child (same message,
+ * same element) still counts as one affected element. `count` is uncapped;
+ * `maxDisplayed` only limits how many element refs are kept for display.
+ *
+ * @param batch - Grouped-warning batch to record into.
+ * @param element - Element the warning is about, or `undefined` for the
+ *   dev-mode warning, which is not about a specific element.
+ * @param maxDisplayed - Cap on element refs kept for display; does not affect
+ *   `count`.
+ * @internal
+ */
+export declare function recordAffectedElement(batch: BatchedWarning, element: HTMLElement | undefined, maxDisplayed: number): void;
 export {};

package/dist/element/spectrum-element.js

@@ -1,26 +1,35 @@
-import { getActiveElement as e } from "../utils/get-active-element.js";
-import { coreVersion as t, version as n } from "./version.js";
-import { LitElement as r } from "lit";
+import { coreVersion as e, version as t } from "./version.js";
+import { LitElement as n } from "lit";
 //#region element/spectrum-element.ts
-var i;
-function a(t) {
-	class n extends t {
-		hasVisibleFocusInTree() {
-			var t;
-			let n = e(this.getRootNode());
-			return (t = n == null ? void 0 : n.matches(":focus-visible")) == null ? !1 : t;
-		}
-	}
-	return n;
+var r, i = class extends n {};
+r = i, r.VERSION = t, r.CORE_VERSION = e;
+function a(e, t, n, r) {
+	return `${e}:${t}:${n}:${r}`;
 }
-var o = class extends a(r) {
-	get dir() {
-		var e;
-		return (e = getComputedStyle(this).direction) == null ? "ltr" : e;
+function o(e, t) {
+	let { message: n, url: r, localName: i, type: a, level: o, listedIssues: s, elements: c, count: l } = e, u = o === "deprecation" ? "DEPRECATION NOTICE: " : "", d = t ? c : c.slice(0, 1), f = "";
+	f = l === 1 ? d.length ? "\nAffected element:" : "" : `\n${l} <${i}> elements affected:`;
+	let p = [u + n + "\n" + s + f];
+	for (let e of d) p.push(e);
+	return p.push((d.length ? "\n\n" : "\n") + r + "\n", { data: {
+		localName: i,
+		type: a,
+		level: o,
+		count: l
+	} }), p;
+}
+function s(e, t, n) {
+	var r;
+	if (!t) {
+		if (e.countedDevModeWarning) return;
+		e.countedDevModeWarning = !0, e.count += 1;
+		return;
 	}
-};
-if (i = o, i.VERSION = n, i.CORE_VERSION = t, process.env.NODE_ENV === "development") {
-	var s, c, l;
+	let i = (r = e.countedElements) == null ? e.countedElements = /* @__PURE__ */ new Set() : r;
+	i.has(t) || (i.add(t), e.count += 1, e.elements.length < n && e.elements.push(t));
+}
+if (process.env.NODE_ENV !== "production") {
+	var c, l, u;
 	let e = {
 		default: !1,
 		accessibility: !1,
@@ -31,36 +40,46 @@ if (i = o, i.VERSION = n, i.CORE_VERSION = t, process.env.NODE_ENV === "developm
 		medium: !1,
 		high: !1,
 		deprecation: !1
+	}, n = /* @__PURE__ */ new Map(), r = !1, i = () => {
+		r = !1, n.forEach((e, t) => {
+			console.warn(...o(e, !!window.__swc.verbose)), window.__swc.issuedWarnings.add(t);
+		}), n.clear();
 	};
 	window.__swc = {
 		...window.__swc,
 		DEBUG: !0,
-		ignoreWarningLocalNames: { ...((s = window.__swc) == null ? void 0 : s.ignoreWarningLocalNames) || {} },
+		ignoreWarningLocalNames: { ...((c = window.__swc) == null ? void 0 : c.ignoreWarningLocalNames) || {} },
 		ignoreWarningTypes: {
 			...e,
-			...((c = window.__swc) == null ? void 0 : c.ignoreWarningTypes) || {}
+			...((l = window.__swc) == null ? void 0 : l.ignoreWarningTypes) || {}
 		},
 		ignoreWarningLevels: {
 			...t,
-			...((l = window.__swc) == null ? void 0 : l.ignoreWarningLevels) || {}
+			...((u = window.__swc) == null ? void 0 : u.ignoreWarningLevels) || {}
 		},
 		issuedWarnings: /* @__PURE__ */ new Set(),
-		warn: (e, t, n, { type: r = "api", level: i = "default", issues: a } = {}) => {
-			let { localName: o = "base" } = e || {}, s = `${o}:${r}:${i}`;
-			if (!window.__swc.verbose && window.__swc.issuedWarnings.has(s) || window.__swc.ignoreWarningLocalNames[o] || window.__swc.ignoreWarningTypes[r] || window.__swc.ignoreWarningLevels[i]) return;
-			window.__swc.issuedWarnings.add(s);
-			let c = "";
-			a && a.length && (a.unshift(""), c = a.join("\n    - ") + "\n");
-			let l = i === "deprecation" ? "DEPRECATION NOTICE: " : "", u = e ? "\nInspect this issue in the follow element:" : "", d = (e ? "\n\n" : "\n") + n + "\n", f = [];
-			f.push(l + t + "\n" + c + u), e && f.push(e), f.push(d, { data: {
-				localName: o,
-				type: r,
-				level: i
-			} }), console.warn(...f);
+		warn: (e, t, o, { type: c = "api", level: l = "default", issues: u } = {}) => {
+			let { localName: d = "base" } = e || {}, f = a(d, c, l, t);
+			if (window.__swc.ignoreWarningLocalNames[d] || window.__swc.ignoreWarningTypes[c] || window.__swc.ignoreWarningLevels[l] || !window.__swc.verbose && window.__swc.issuedWarnings.has(f)) return;
+			let p = n.get(f);
+			if (!p) {
+				let e = "";
+				u && u.length && (u.unshift(""), e = u.join("\n    - ") + "\n"), p = {
+					message: t,
+					url: o,
+					localName: d,
+					type: c,
+					level: l,
+					listedIssues: e,
+					elements: [],
+					count: 0
+				}, n.set(f, p);
+			}
+			s(p, e, 10), r || (r = !0, queueMicrotask(i));
 		}
 	}, window.__swc.warn(void 0, "Spectrum Web Components is in dev mode. Not recommended for production!", "https://opensource.adobe.com/spectrum-web-components/dev-mode/", { type: "default" });
 }
 //#endregion
-export { o as SpectrumElement, a as SpectrumMixin };
+export { i as SpectrumElement, o as buildGroupedWarningArgs, s as recordAffectedElement, a as warningId };
 
 //# sourceMappingURL=spectrum-element.js.map

package/dist/element/spectrum-element.js.map

@@ -1 +1 @@
-{"version":3,"file":"spectrum-element.js","names":[],"sources":["../../element/spectrum-element.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 { LitElement, ReactiveElement } from 'lit';\n\nimport { getActiveElement } from '../utils/get-active-element.js';\nimport { coreVersion, version } from './version.js';\n\ntype Constructor<T = Record<string, unknown>> = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  new (...args: any[]): T;\n  prototype: T;\n};\n\nexport interface SpectrumInterface {\n  shadowRoot: ShadowRoot;\n  hasVisibleFocusInTree(): boolean;\n}\n\nexport function SpectrumMixin<T extends Constructor<ReactiveElement>>(\n  constructor: T\n): T & Constructor<SpectrumInterface> {\n  class SpectrumMixinElement extends constructor {\n    /**\n     * @internal\n     */\n    public override shadowRoot!: ShadowRoot;\n\n    /**\n     * @internal\n     */\n    public hasVisibleFocusInTree(): boolean {\n      const active = getActiveElement(\n        this.getRootNode() as Document | ShadowRoot\n      );\n\n      return active?.matches(':focus-visible') ?? false;\n    }\n  }\n  return SpectrumMixinElement;\n}\n\nexport class SpectrumElement extends SpectrumMixin(LitElement) {\n  /**\n   * @internal\n   */\n  static VERSION = version;\n\n  /**\n   * @internal\n   */\n  static CORE_VERSION = coreVersion;\n\n  /**\n   * @internal\n   */\n  public override get dir(): CSSStyleDeclaration['direction'] {\n    return getComputedStyle(this).direction ?? 'ltr';\n  }\n}\n\nif (process.env.NODE_ENV === 'development') {\n  const ignoreWarningTypes = {\n    default: false,\n    accessibility: false,\n    api: false,\n  };\n  const ignoreWarningLevels = {\n    default: false,\n    low: false,\n    medium: false,\n    high: false,\n    deprecation: false,\n  };\n  window.__swc = {\n    ...window.__swc,\n    DEBUG: true,\n    ignoreWarningLocalNames: {\n      ...(window.__swc?.ignoreWarningLocalNames || {}),\n    },\n    ignoreWarningTypes: {\n      ...ignoreWarningTypes,\n      ...(window.__swc?.ignoreWarningTypes || {}),\n    },\n    ignoreWarningLevels: {\n      ...ignoreWarningLevels,\n      ...(window.__swc?.ignoreWarningLevels || {}),\n    },\n    issuedWarnings: new Set(),\n    warn: (\n      element,\n      message,\n      url,\n      { type = 'api', level = 'default', issues } = {}\n    ): void => {\n      const { localName = 'base' } = element || {};\n      const id = `${localName}:${type}:${level}` as BrandedSWCWarningID;\n      if (!window.__swc.verbose && window.__swc.issuedWarnings.has(id)) {\n        return;\n      }\n      if (window.__swc.ignoreWarningLocalNames[localName]) {\n        return;\n      }\n      if (window.__swc.ignoreWarningTypes[type]) {\n        return;\n      }\n      if (window.__swc.ignoreWarningLevels[level]) {\n        return;\n      }\n      window.__swc.issuedWarnings.add(id);\n      let listedIssues = '';\n      if (issues && issues.length) {\n        issues.unshift('');\n        listedIssues = issues.join('\\n    - ') + '\\n';\n      }\n      const intro = level === 'deprecation' ? 'DEPRECATION NOTICE: ' : '';\n      const inspectElement = element\n        ? '\\nInspect this issue in the follow element:'\n        : '';\n      const displayURL = (element ? '\\n\\n' : '\\n') + url + '\\n';\n      const messages: unknown[] = [];\n      messages.push(intro + message + '\\n' + listedIssues + inspectElement);\n      if (element) {\n        messages.push(element);\n      }\n      messages.push(displayURL, {\n        data: {\n          localName,\n          type,\n          level,\n        },\n      });\n      console.warn(...messages);\n    },\n  };\n\n  window.__swc.warn(\n    undefined,\n    'Spectrum Web Components is in dev mode. Not recommended for production!',\n    'https://opensource.adobe.com/spectrum-web-components/dev-mode/',\n    { type: 'default' }\n  );\n}\n"],"mappings":";;;;;AA4BA,SAAgB,EACd,GACoC;CACpC,MAAM,UAA6B,EAAY;EAS7C,wBAAwC;;GACtC,IAAM,IAAS,EACb,KAAK,aAAa,CACnB;AAED,WAAA,IAAA,KAAA,OAAA,KAAA,IAAO,EAAQ,QAAQ,iBAAiB,KAAA,OAAI,KAAJ;;;AAG5C,QAAO;;AAGT,IAAa,IAAb,cAAqC,EAAc,EAAW,CAAC;CAc7D,IAAoB,MAAwC;;AAC1D,UAAA,IAAO,iBAAiB,KAAK,CAAC,cAAA,OAAa,QAAb;;;AAIlC,uBAfmB,oBAKK,GAUxB,QAAA,IAAA,aAA6B,eAAe;;CAC1C,IAAM,IAAqB;EACzB,SAAS;EACT,eAAe;EACf,KAAK;EACN,EACK,IAAsB;EAC1B,SAAS;EACT,KAAK;EACL,QAAQ;EACR,MAAM;EACN,aAAa;EACd;AA+DD,CA9DA,OAAO,QAAQ;EACb,GAAG,OAAO;EACV,OAAO;EACP,yBAAyB,EACvB,KAAA,IAAI,OAAO,UAAA,OAAA,KAAA,IAAA,EAAO,4BAA2B,EAAE,EAChD;EACD,oBAAoB;GAClB,GAAG;GACH,KAAA,IAAI,OAAO,UAAA,OAAA,KAAA,IAAA,EAAO,uBAAsB,EAAE;GAC3C;EACD,qBAAqB;GACnB,GAAG;GACH,KAAA,IAAI,OAAO,UAAA,OAAA,KAAA,IAAA,EAAO,wBAAuB,EAAE;GAC5C;EACD,gCAAgB,IAAI,KAAK;EACzB,OACE,GACA,GACA,GACA,EAAE,UAAO,OAAO,WAAQ,WAAW,cAAW,EAAE,KACvC;GACT,IAAM,EAAE,eAAY,WAAW,KAAW,EAAE,EACtC,IAAK,GAAG,EAAU,GAAG,EAAK,GAAG;AAUnC,OATI,CAAC,OAAO,MAAM,WAAW,OAAO,MAAM,eAAe,IAAI,EAAG,IAG5D,OAAO,MAAM,wBAAwB,MAGrC,OAAO,MAAM,mBAAmB,MAGhC,OAAO,MAAM,oBAAoB,GACnC;AAEF,UAAO,MAAM,eAAe,IAAI,EAAG;GACnC,IAAI,IAAe;AACnB,GAAI,KAAU,EAAO,WACnB,EAAO,QAAQ,GAAG,EAClB,IAAe,EAAO,KAAK,WAAW,GAAG;GAE3C,IAAM,IAAQ,MAAU,gBAAgB,yBAAyB,IAC3D,IAAiB,IACnB,gDACA,IACE,KAAc,IAAU,SAAS,QAAQ,IAAM,MAC/C,IAAsB,EAAE;AAY9B,GAXA,EAAS,KAAK,IAAQ,IAAU,OAAO,IAAe,EAAe,EACjE,KACF,EAAS,KAAK,EAAQ,EAExB,EAAS,KAAK,GAAY,EACxB,MAAM;IACJ;IACA;IACA;IACD,EACF,CAAC,EACF,QAAQ,KAAK,GAAG,EAAS;;EAE5B,EAED,OAAO,MAAM,KACX,KAAA,GACA,2EACA,kEACA,EAAE,MAAM,WAAW,CACpB"}
+{"version":3,"file":"spectrum-element.js","names":[],"sources":["../../element/spectrum-element.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 { LitElement } from 'lit';\n\nimport { coreVersion, version } from './version.js';\n\nexport class SpectrumElement extends LitElement {\n  /**\n   * @internal\n   */\n  static VERSION = version;\n\n  /**\n   * @internal\n   */\n  static CORE_VERSION = coreVersion;\n}\n\n/**\n * Builds the deduplication key for a dev-mode warning. The `message` is part of\n * the key so two distinct problems that share a `type`/`level` (the common\n * case) do not suppress each other; only a verbatim repeat of the same warning\n * is deduplicated. Exported so the dedup key can be unit tested without relying\n * on the `NODE_ENV`-gated `window.__swc` setup below.\n */\nexport function warningId(\n  localName: string,\n  type: WarningType,\n  level: WarningLevel,\n  message: string\n): BrandedSWCWarningID {\n  return `${localName}:${type}:${level}:${message}` as BrandedSWCWarningID;\n}\n\n/**\n * A group of dev-mode warnings that share a `warningId`, collected within a\n * single microtask so they can be emitted as one console line with a count.\n */\ntype BatchedWarning = {\n  message: string;\n  url: string;\n  localName: string;\n  type: WarningType;\n  level: WarningLevel;\n  listedIssues: string;\n  elements: HTMLElement[];\n  count: number;\n\n  /**\n   * Elements already counted in this batch, keyed by identity. A repeated\n   * `warn()` for an element already here does not bump `count` again.\n   */\n  countedElements?: Set<HTMLElement>;\n\n  /**\n   * Whether the dev-mode warning (the only warning with no element) has been\n   * counted, so repeats of it collapse to one.\n   */\n  countedDevModeWarning?: boolean;\n};\n\n/**\n * Builds the `console.warn` arguments for a grouped dev warning: the message\n * and a count line, then the element ref(s) to inspect. By default one\n * representative element is shown; `verbose` shows every collected element\n * (already capped at collection time). Exported so the grouped output can be\n * unit tested without the `NODE_ENV`-gated `window.__swc` setup below.\n *\n * @internal\n */\nexport function buildGroupedWarningArgs(\n  batch: BatchedWarning,\n  verbose: boolean\n): unknown[] {\n  const {\n    message,\n    url,\n    localName,\n    type,\n    level,\n    listedIssues,\n    elements,\n    count,\n  } = batch;\n  const intro = level === 'deprecation' ? 'DEPRECATION NOTICE: ' : '';\n  const shown = verbose ? elements : elements.slice(0, 1);\n  let countLine = '';\n  if (count === 1) {\n    countLine = shown.length ? '\\nAffected element:' : '';\n  } else {\n    countLine = `\\n${count} <${localName}> elements affected:`;\n  }\n  const args: unknown[] = [intro + message + '\\n' + listedIssues + countLine];\n  for (const el of shown) {\n    args.push(el);\n  }\n  args.push((shown.length ? '\\n\\n' : '\\n') + url + '\\n', {\n    data: { localName, type, level, count },\n  });\n  return args;\n}\n\n/**\n * Records one warning occurrence into its batch, counting by element identity:\n * `count` becomes the number of distinct elements with this warning, not the\n * number of `warn()` calls. A host that warns once per child (same message,\n * same element) still counts as one affected element. `count` is uncapped;\n * `maxDisplayed` only limits how many element refs are kept for display.\n *\n * @param batch - Grouped-warning batch to record into.\n * @param element - Element the warning is about, or `undefined` for the\n *   dev-mode warning, which is not about a specific element.\n * @param maxDisplayed - Cap on element refs kept for display; does not affect\n *   `count`.\n * @internal\n */\nexport function recordAffectedElement(\n  batch: BatchedWarning,\n  element: HTMLElement | undefined,\n  maxDisplayed: number\n): void {\n  if (!element) {\n    // The dev-mode warning is the only warning with no element; count it once\n    // however often it fires.\n    if (batch.countedDevModeWarning) {\n      return;\n    }\n    batch.countedDevModeWarning = true;\n    batch.count += 1;\n    return;\n  }\n  const countedElements = (batch.countedElements ??= new Set<HTMLElement>());\n  if (countedElements.has(element)) {\n    return; // this element is already counted for the batch\n  }\n  countedElements.add(element);\n  batch.count += 1;\n  if (batch.elements.length < maxDisplayed) {\n    batch.elements.push(element);\n  }\n}\n\n// Enabled in every environment except production (the ecosystem convention);\n// a production build strips this block via dead-code elimination.\nif (process.env.NODE_ENV !== 'production') {\n  const ignoreWarningTypes = {\n    default: false,\n    accessibility: false,\n    api: false,\n  };\n  const ignoreWarningLevels = {\n    default: false,\n    low: false,\n    medium: false,\n    high: false,\n    deprecation: false,\n  };\n\n  // Grouped warnings: collect same-`warningId` warnings fired within one\n  // microtask and emit a single console line with the total count. By default\n  // one representative element is shown for inspection; `verbose` lists all\n  // collected elements (capped at WARNING_ELEMENT_CAP).\n  const WARNING_ELEMENT_CAP = 10;\n  const batchedWarnings = new Map<BrandedSWCWarningID, BatchedWarning>();\n  let flushScheduled = false;\n\n  const flushWarnings = (): void => {\n    flushScheduled = false;\n    batchedWarnings.forEach((batch, id) => {\n      console.warn(\n        ...buildGroupedWarningArgs(batch, Boolean(window.__swc.verbose))\n      );\n      window.__swc.issuedWarnings.add(id);\n    });\n    batchedWarnings.clear();\n  };\n\n  window.__swc = {\n    ...window.__swc,\n    DEBUG: true,\n    ignoreWarningLocalNames: {\n      ...(window.__swc?.ignoreWarningLocalNames || {}),\n    },\n    ignoreWarningTypes: {\n      ...ignoreWarningTypes,\n      ...(window.__swc?.ignoreWarningTypes || {}),\n    },\n    ignoreWarningLevels: {\n      ...ignoreWarningLevels,\n      ...(window.__swc?.ignoreWarningLevels || {}),\n    },\n    issuedWarnings: new Set(),\n    warn: (\n      element,\n      message,\n      url,\n      { type = 'api', level = 'default', issues } = {}\n    ): void => {\n      const { localName = 'base' } = element || {};\n      const id = warningId(localName, type, level, message);\n      // Ignore filters short-circuit before any batching.\n      if (window.__swc.ignoreWarningLocalNames[localName]) {\n        return;\n      }\n      if (window.__swc.ignoreWarningTypes[type]) {\n        return;\n      }\n      if (window.__swc.ignoreWarningLevels[level]) {\n        return;\n      }\n      // Session dedup: each id emits one grouped line per session. `verbose`\n      // bypasses it so every microtask flush re-emits.\n      if (!window.__swc.verbose && window.__swc.issuedWarnings.has(id)) {\n        return;\n      }\n      // Collect into the per-id batch; `flushWarnings` builds the grouped\n      // message on the next microtask.\n      let batch = batchedWarnings.get(id);\n      if (!batch) {\n        let listedIssues = '';\n        if (issues && issues.length) {\n          issues.unshift('');\n          listedIssues = issues.join('\\n    - ') + '\\n';\n        }\n        batch = {\n          message,\n          url,\n          localName,\n          type,\n          level,\n          listedIssues,\n          elements: [],\n          count: 0,\n        };\n        batchedWarnings.set(id, batch);\n      }\n      recordAffectedElement(batch, element, WARNING_ELEMENT_CAP);\n      if (!flushScheduled) {\n        flushScheduled = true;\n        queueMicrotask(flushWarnings);\n      }\n    },\n  };\n\n  window.__swc.warn(\n    undefined,\n    'Spectrum Web Components is in dev mode. Not recommended for production!',\n    'https://opensource.adobe.com/spectrum-web-components/dev-mode/',\n    { type: 'default' }\n  );\n}\n"],"mappings":";;;OAgBa,IAAb,cAAqC,EAAW;mBAI7B,oBAKK;AAUxB,SAAgB,EACd,GACA,GACA,GACA,GACqB;AACrB,QAAO,GAAG,EAAU,GAAG,EAAK,GAAG,EAAM,GAAG;;AAuC1C,SAAgB,EACd,GACA,GACW;CACX,IAAM,EACJ,YACA,QACA,cACA,SACA,UACA,iBACA,aACA,aACE,GACE,IAAQ,MAAU,gBAAgB,yBAAyB,IAC3D,IAAQ,IAAU,IAAW,EAAS,MAAM,GAAG,EAAE,EACnD,IAAY;AAChB,CAGE,IAHE,MAAU,IACA,EAAM,SAAS,wBAAwB,KAEvC,KAAK,EAAM,IAAI,EAAU;CAEvC,IAAM,IAAkB,CAAC,IAAQ,IAAU,OAAO,IAAe,EAAU;AAC3E,MAAK,IAAM,KAAM,EACf,GAAK,KAAK,EAAG;AAKf,QAHA,EAAK,MAAM,EAAM,SAAS,SAAS,QAAQ,IAAM,MAAM,EACrD,MAAM;EAAE;EAAW;EAAM;EAAO;EAAO,EACxC,CAAC,EACK;;AAiBT,SAAgB,EACd,GACA,GACA,GACM;;AACN,KAAI,CAAC,GAAS;AAGZ,MAAI,EAAM,sBACR;AAGF,EADA,EAAM,wBAAwB,IAC9B,EAAM,SAAS;AACf;;CAEF,IAAM,KAAA,IAAmB,EAAM,oBAAA,OAAN,EAAM,kCAAoB,IAAI,KAAkB,GAA1C;AAC3B,GAAgB,IAAI,EAAQ,KAGhC,EAAgB,IAAI,EAAQ,EAC5B,EAAM,SAAS,GACX,EAAM,SAAS,SAAS,KAC1B,EAAM,SAAS,KAAK,EAAQ;;AAMhC,IAAA,QAAA,IAAA,aAA6B,cAAc;;CACzC,IAAM,IAAqB;EACzB,SAAS;EACT,eAAe;EACf,KAAK;EACN,EACK,IAAsB;EAC1B,SAAS;EACT,KAAK;EACL,QAAQ;EACR,MAAM;EACN,aAAa;EACd,EAOK,oBAAkB,IAAI,KAA0C,EAClE,IAAiB,IAEf,UAA4B;AAQhC,EAPA,IAAiB,IACjB,EAAgB,SAAS,GAAO,MAAO;AAIrC,GAHA,QAAQ,KACN,GAAG,EAAwB,GAAO,EAAQ,OAAO,MAAM,QAAS,CACjE,EACD,OAAO,MAAM,eAAe,IAAI,EAAG;IACnC,EACF,EAAgB,OAAO;;AAsEzB,CAnEA,OAAO,QAAQ;EACb,GAAG,OAAO;EACV,OAAO;EACP,yBAAyB,EACvB,KAAA,IAAI,OAAO,UAAA,OAAA,KAAA,IAAA,EAAO,4BAA2B,EAAE,EAChD;EACD,oBAAoB;GAClB,GAAG;GACH,KAAA,IAAI,OAAO,UAAA,OAAA,KAAA,IAAA,EAAO,uBAAsB,EAAE;GAC3C;EACD,qBAAqB;GACnB,GAAG;GACH,KAAA,IAAI,OAAO,UAAA,OAAA,KAAA,IAAA,EAAO,wBAAuB,EAAE;GAC5C;EACD,gCAAgB,IAAI,KAAK;EACzB,OACE,GACA,GACA,GACA,EAAE,UAAO,OAAO,WAAQ,WAAW,cAAW,EAAE,KACvC;GACT,IAAM,EAAE,eAAY,WAAW,KAAW,EAAE,EACtC,IAAK,EAAU,GAAW,GAAM,GAAO,EAAQ;AAarD,OAXI,OAAO,MAAM,wBAAwB,MAGrC,OAAO,MAAM,mBAAmB,MAGhC,OAAO,MAAM,oBAAoB,MAKjC,CAAC,OAAO,MAAM,WAAW,OAAO,MAAM,eAAe,IAAI,EAAG,CAC9D;GAIF,IAAI,IAAQ,EAAgB,IAAI,EAAG;AACnC,OAAI,CAAC,GAAO;IACV,IAAI,IAAe;AAenB,IAdI,KAAU,EAAO,WACnB,EAAO,QAAQ,GAAG,EAClB,IAAe,EAAO,KAAK,WAAW,GAAG,OAE3C,IAAQ;KACN;KACA;KACA;KACA;KACA;KACA;KACA,UAAU,EAAE;KACZ,OAAO;KACR,EACD,EAAgB,IAAI,GAAI,EAAM;;AAGhC,GADA,EAAsB,GAAO,GAAS,GAAoB,EACrD,MACH,IAAiB,IACjB,eAAe,EAAc;;EAGlC,EAED,OAAO,MAAM,KACX,KAAA,GACA,2EACA,kEACA,EAAE,MAAM,WAAW,CACpB"}

package/dist/element/version.d.ts

@@ -12,8 +12,8 @@
 /**
  * The version of the 2nd-gen Spectrum Web Components library.
  */
-export declare const version = "2.0.0-beta.1";
+export declare const version = "2.0.0-beta.2";
 /**
  * The version of the core base package.
  */
-export declare const coreVersion = "2.0.0-beta.1";
+export declare const coreVersion = "2.0.0-beta.2";

package/dist/element/version.js

@@ -1,5 +1,5 @@
 //#region element/version.ts
-var e = "2.0.0-beta.1", t = "2.0.0-beta.1";
+var e = "2.0.0-beta.2", t = "2.0.0-beta.2";
 //#endregion
 export { t as coreVersion, e as version };
 

package/dist/element/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","names":[],"sources":["../../element/version.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// Auto-generated from 2nd-gen/packages/core/package.json\n// Generation: 2nd-gen\n// DO NOT EDIT - This file is generated by scripts/generate-versions.js\n\n/**\n * The version of the 2nd-gen Spectrum Web Components library.\n */\nexport const version = '2.0.0-beta.1';\n\n/**\n * The version of the core base package.\n */\nexport const coreVersion = '2.0.0-beta.1';\n"],"mappings":";AAmBA,IAAa,IAAU,gBAKV,IAAc"}
+{"version":3,"file":"version.js","names":[],"sources":["../../element/version.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// Auto-generated from 2nd-gen/packages/core/package.json\n// Generation: 2nd-gen\n// DO NOT EDIT - This file is generated by scripts/generate-versions.js\n\n/**\n * The version of the 2nd-gen Spectrum Web Components library.\n */\nexport const version = '2.0.0-beta.2';\n\n/**\n * The version of the core base package.\n */\nexport const coreVersion = '2.0.0-beta.2';\n"],"mappings":";AAmBA,IAAa,IAAU,gBAKV,IAAc"}

package/dist/mixins/index.d.ts

@@ -11,8 +11,6 @@
  */
 export { DisabledMixin, type DisabledInterface } from './disabled-mixin.js';
 export { LINEAR_PROGRESS_LABEL_POSITIONS, LINEAR_PROGRESS_STATIC_COLORS, LINEAR_PROGRESS_VALID_SIZES, LinearProgressMixin, type LinearProgressInterface, type LinearProgressLabelPosition, type LinearProgressSize, type LinearProgressStaticColor, } from './linear-progress-mixin.js';
-export { ObserveSlotPresence, type SlotPresenceObservingInterface, } from './observe-slot-presence.js';
-export { ObserveSlotText, type SlotTextObservingInterface, } from './observe-slot-text.js';
 export { PendingMixin, type PendingInterface } from './pending-mixin.js';
 export { DEFAULT_ELEMENT_SIZES, ELEMENT_SIZES, SizedMixin, } from './sized-mixin.js';
 export type { DefaultElementSize, ElementSize, SizedElementConstructor, SizedElementInterface, } from './sized-mixin.js';

package/dist/mixins/index.js

@@ -1,7 +1,5 @@
 import { DisabledMixin as e } from "./disabled-mixin.js";
-import { ObserveSlotPresence as t } from "./observe-slot-presence.js";
-import { LINEAR_PROGRESS_LABEL_POSITIONS as n, LINEAR_PROGRESS_STATIC_COLORS as r, LINEAR_PROGRESS_VALID_SIZES as i, LinearProgressMixin as a } from "./linear-progress-mixin.js";
-import { ObserveSlotText as o } from "./observe-slot-text.js";
-import { PendingMixin as s } from "./pending-mixin.js";
-import { DEFAULT_ELEMENT_SIZES as c, ELEMENT_SIZES as l, SizedMixin as u } from "./sized-mixin.js";
-export { c as DEFAULT_ELEMENT_SIZES, e as DisabledMixin, l as ELEMENT_SIZES, n as LINEAR_PROGRESS_LABEL_POSITIONS, r as LINEAR_PROGRESS_STATIC_COLORS, i as LINEAR_PROGRESS_VALID_SIZES, a as LinearProgressMixin, t as ObserveSlotPresence, o as ObserveSlotText, s as PendingMixin, u as SizedMixin };
+import { LINEAR_PROGRESS_LABEL_POSITIONS as t, LINEAR_PROGRESS_STATIC_COLORS as n, LINEAR_PROGRESS_VALID_SIZES as r, LinearProgressMixin as i } from "./linear-progress-mixin.js";
+import { PendingMixin as a } from "./pending-mixin.js";
+import { DEFAULT_ELEMENT_SIZES as o, ELEMENT_SIZES as s, SizedMixin as c } from "./sized-mixin.js";
+export { o as DEFAULT_ELEMENT_SIZES, e as DisabledMixin, s as ELEMENT_SIZES, t as LINEAR_PROGRESS_LABEL_POSITIONS, n as LINEAR_PROGRESS_STATIC_COLORS, r as LINEAR_PROGRESS_VALID_SIZES, i as LinearProgressMixin, a as PendingMixin, c as SizedMixin };