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

package/dist/components/tabs/TabPanel.base.js

@@ -0,0 +1,36 @@
+import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
+import { property as t } from "lit/decorators.js";
+import { SpectrumElement as n } from "@adobe/spectrum-wc-core/element/index.js";
+//#region components/tabs/TabPanel.base.ts
+var r = 0, i = class extends n {
+	constructor(...e) {
+		super(...e), this.selected = !1, this.tabId = "";
+	}
+	handleFocusin() {
+		this.removeAttribute("tabindex");
+	}
+	handleFocusout() {
+		this.tabIndex = this.selected ? 0 : -1;
+	}
+	firstUpdated(e) {
+		super.firstUpdated(e), this.slot = "tab-panel", this.setAttribute("role", "tabpanel"), this.tabIndex = 0, this.hasAttribute("id") || (this.id = `swc-tab-panel-${r++}`);
+	}
+	updated(e) {
+		super.updated(e), e.has("selected") && this.syncVisibility();
+	}
+	syncVisibility() {
+		this.selected ? (this.removeAttribute("aria-hidden"), this.tabIndex = 0) : (this.setAttribute("aria-hidden", "true"), this.tabIndex = -1);
+	}
+};
+e([t({
+	type: Boolean,
+	reflect: !0
+})], i.prototype, "selected", void 0), e([t({
+	type: String,
+	reflect: !0,
+	attribute: "tab-id"
+})], i.prototype, "tabId", void 0);
+//#endregion
+export { i as TabPanelBase };
+
+//# sourceMappingURL=TabPanel.base.js.map

package/dist/components/tabs/TabPanel.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabPanel.base.js","names":[],"sources":["../../../components/tabs/TabPanel.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';\n\nlet panelIdCounter = 0;\n\n/**\n * Base class for a tab panel that displays content associated with\n * a tab.\n *\n * Manages visibility, ARIA hidden state, tabindex, and the\n * focus-in/out behavior that prevents Tab-key trapping inside panel\n * content.\n *\n * In 1st-gen, `slot=\"tab-panel\"` was\n * assigned programmatically in `firstUpdated` so consumers never\n * wrote it in markup. This behavior is preserved in gen2.\n *\n * The panel removes its own\n * `tabindex` on `focusin` so that Tab presses inside the panel\n * move to the next interactive element rather than being trapped.\n * On `focusout`, `tabindex` is restored so the panel remains\n * focusable from the tablist.\n *\n * @slot - Content displayed when the associated tab is selected\n */\nexport abstract class TabPanelBase extends SpectrumElement {\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * Whether this panel is currently visible (its associated tab is\n   * selected). Managed by the parent `swc-tabs` — consumers should\n   * not set this directly.\n   */\n  @property({ type: Boolean, reflect: true })\n  public selected = false;\n\n  /**\n   * Unique identifier linking this panel to its corresponding tab.\n   * Must match the `tab-id` attribute on the associated `swc-tab`.\n   */\n  @property({ type: String, reflect: true, attribute: 'tab-id' })\n  public tabId = '';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  /**\n   * Removes the panel's `tabindex` while focus is inside the panel\n   * so that Tab presses navigate to the next interactive element\n   * rather than the panel container itself.\n   */\n  protected handleFocusin(): void {\n    this.removeAttribute('tabindex');\n  }\n\n  /**\n   * Restores `tabindex` when focus leaves the panel so the panel\n   * remains directly focusable from the tablist via Tab key.\n   */\n  protected handleFocusout(): void {\n    this.tabIndex = this.selected ? 0 : -1;\n  }\n\n  protected override firstUpdated(_changes: PropertyValues): void {\n    super.firstUpdated(_changes);\n\n    this.slot = 'tab-panel';\n    this.setAttribute('role', 'tabpanel');\n    this.tabIndex = 0;\n\n    if (!this.hasAttribute('id')) {\n      this.id = `swc-tab-panel-${panelIdCounter++}`;\n    }\n  }\n\n  protected override updated(changes: PropertyValues): void {\n    super.updated(changes);\n\n    if (changes.has('selected')) {\n      this.syncVisibility();\n    }\n  }\n\n  private syncVisibility(): void {\n    if (this.selected) {\n      this.removeAttribute('aria-hidden');\n      this.tabIndex = 0;\n    } else {\n      this.setAttribute('aria-hidden', 'true');\n      this.tabIndex = -1;\n    }\n  }\n}\n"],"mappings":";;;;AAgBA,IAAI,IAAiB,GAsBC,IAAtB,cAA2C,EAAgB;;+BAWvC,iBAOH;;CAWf,gBAAgC;AAC9B,OAAK,gBAAgB,WAAW;;CAOlC,iBAAiC;AAC/B,OAAK,WAAW,KAAK,WAAW,IAAI;;CAGtC,aAAgC,GAAgC;AAO9D,EANA,MAAM,aAAa,EAAS,EAE5B,KAAK,OAAO,aACZ,KAAK,aAAa,QAAQ,WAAW,EACrC,KAAK,WAAW,GAEX,KAAK,aAAa,KAAK,KAC1B,KAAK,KAAK,iBAAiB;;CAI/B,QAA2B,GAA+B;AAGxD,EAFA,MAAM,QAAQ,EAAQ,EAElB,EAAQ,IAAI,WAAW,IACzB,KAAK,gBAAgB;;CAIzB,iBAA+B;AAC7B,EAAI,KAAK,YACP,KAAK,gBAAgB,cAAc,EACnC,KAAK,WAAW,MAEhB,KAAK,aAAa,eAAe,OAAO,EACxC,KAAK,WAAW;;;GAzDnB,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAO1C,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,WAAW;CAAU,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA"}

package/dist/components/tabs/TabPanel.types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/**
+ * Reserved for future tab-panel-specific type definitions.
+ * The file is scaffolded now so imports are stable when implementation
+ * work begins.
+ */
+export {};

package/dist/components/tabs/Tabs.base.d.ts

@@ -0,0 +1,221 @@
+import { PropertyValues } from 'lit';
+import { SpectrumElement } from '../../element/index.js';
+import { KeyboardActivation, TabDensity, TabsDirection } from './Tabs.types.js';
+/**
+ * Base class for a tabbed interface container.
+ *
+ * Manages selection state, tab/panel association, ARIA wiring,
+ * keyboard navigation, and event dispatching. Concrete classes
+ * supply the stylesheet, render template, and visual behaviors
+ * such as the selection indicator.
+ *
+ * Public API follows the Spectrum 2 / Spectrum Design–aligned surface
+ * from the tabs migration plan: `keyboard-activation` and `density`
+ * instead of legacy `auto`, `compact`, `quiet`, `emphasized`, and
+ * t-shirt `size` attributes.
+ *
+ * @slot - Tab items (elements with `role="tab"`)
+ * @slot tab-panel - Tab panel content (elements with `role="tabpanel"`)
+ *
+ * @fires change - The selected tab has changed. Cancelable —
+ *   calling `preventDefault()` reverts the selection.
+ */
+export declare abstract class TabsBase extends SpectrumElement {
+    /**
+     * @internal
+     *
+     * Valid direction values for validation and CEM/stories.
+     */
+    static readonly VALID_DIRECTIONS: readonly TabsDirection[];
+    /**
+     * @internal
+     */
+    static readonly VALID_KEYBOARD_ACTIVATIONS: readonly KeyboardActivation[];
+    /**
+     * @internal
+     */
+    static readonly VALID_DENSITIES: readonly TabDensity[];
+    /**
+     * Whether selection follows keyboard focus (`automatic`, default) or the
+     * user must press Enter or Space to activate (`manual`). Prefer `manual`
+     * when tab panels are expensive to render or not fully present in the DOM.
+     *
+     * @see https://w3c.github.io/aria-practices/#kbd_selection_follows_focus
+     */
+    get keyboardActivation(): KeyboardActivation;
+    set keyboardActivation(value: string);
+    /** @internal */
+    private _keyboardActivation;
+    /**
+     * Layout density: `regular` (default) or `compact` (reduced tab spacing).
+     */
+    get density(): TabDensity;
+    set density(value: string);
+    /** @internal */
+    private _density;
+    /**
+     * The layout direction of the tab list: `horizontal` (default) or `vertical`.
+     *
+     * @default 'horizontal'
+     */
+    get direction(): TabsDirection;
+    set direction(value: TabsDirection);
+    /** @internal */
+    private _direction;
+    /**
+     * Whether the entire tab list is disabled. When `true`,
+     * `aria-disabled="true"` is applied to the tablist element and
+     * all interaction is suppressed.
+     */
+    disabled: boolean;
+    /**
+     * Accessible label for the tablist. Rendered as `aria-label` on the
+     * element with `role="tablist"` in the concrete template.
+     */
+    accessibleLabel: string;
+    /**
+     * The `tab-id` of the currently selected tab. Setting this property
+     * updates which tab appears selected and which panel is visible.
+     */
+    selected: string;
+    /** @internal */
+    private static readonly INDICATOR_BASE_SIZE;
+    /**
+     * @internal
+     *
+     * Inline style applied to the selection indicator element.
+     * Computed from the selected tab's position and dimensions.
+     */
+    protected selectionIndicatorStyle: string;
+    /**
+     * @internal
+     *
+     * Suppresses the transition on the very first indicator placement
+     * so it doesn't animate from the origin.
+     */
+    protected shouldAnimate: boolean;
+    /**
+     * @internal
+     *
+     * Cached list of tab elements managed by this container. Updated
+     * via `handleTabSlotChange`.
+     */
+    private _tabs;
+    /**
+     * @internal
+     *
+     * Manages roving tabindex and arrow-key / Home / End focus movement within
+     * the tab list. Direction is kept in sync with `this.direction` via
+     * `setOptions` in `willUpdate`. Disabled tabs remain in the navigation
+     * sequence (per APG) but are not activatable.
+     *
+     * `getItems` returns an empty array when the container is disabled so all
+     * tabs lose their tab stop, matching the `aria-disabled` tablist behavior.
+     */
+    private readonly _navigation;
+    /**
+     * Handles `focusgroupNavigationActiveChange` events dispatched by
+     * `_navigation`. In automatic activation mode, selects the newly focused
+     * tab (unless it is disabled).
+     *
+     * Only `source: 'keyboard'` (arrow keys, Home/End) and `source: 'focus'`
+     * (pointer click, Tab-key entry) represent a real focus move that
+     * "selection follows focus" should react to. `'refresh'` and
+     * `'programmatic'` fire when `_navigation` re-parks the roving tab stop
+     * without anyone actually moving focus there — for example on mount or when
+     * re-enabling after `disabled` — and must not trigger a spurious selection
+     * or `change` event.
+     */
+    private readonly _handleNavigationActiveChange;
+    /**
+     * Whether an assigned node is treated as a tab. `role="tab"` is set in
+     * each tab's `firstUpdated`, so `slotchange` may run before that — accept
+     * known tab host tag names so the tab list and selection indicator sync.
+     */
+    private static isTabSlotNode;
+    /**
+     * Called by the concrete class when the default slot's content
+     * changes. Rebuilds the internal tab list and syncs selection
+     * state.
+     */
+    protected handleTabSlotChange(event: Event): void;
+    /**
+     * Called by the concrete class when the `tab-panel` slot's content
+     * changes. Wires up `aria-controls` / `aria-labelledby` between
+     * each tab and its panel.
+     */
+    protected handlePanelSlotChange(event: Event): void;
+    /**
+     * Click handler bound to the tablist wrapper in the concrete
+     * template. Activates the clicked tab.
+     */
+    protected handleClick(event: Event): void;
+    /**
+     * Keyboard handler for Enter and Space activation. Arrow-key, Home, and
+     * End navigation is handled by `FocusgroupNavigationController` in capture
+     * phase on the host element.
+     */
+    protected handleKeyDown(event: KeyboardEvent): void;
+    /**
+     * Attempts to select the given tab element. Dispatches a cancelable
+     * `change` event — if the consumer calls `preventDefault()`, the
+     * selection reverts to the previous value.
+     */
+    private selectTarget;
+    /**
+     * Synchronizes the `selected` property on each child tab to match
+     * `this.selected`, then parks the roving tab stop on the selected tab via
+     * `_navigation.setActiveItem`. Tabindex management is otherwise owned by
+     * `FocusgroupNavigationController` — for example, `_navigation.refresh()`
+     * resets all tabindex values when the tab list or `disabled` state changes.
+     */
+    private updateCheckedState;
+    /**
+     * Wires up cross-element ARIA relationships between tabs and
+     * panels. Each tab gets `aria-controls` pointing at its panel's
+     * `id`, and each panel gets `aria-labelledby` pointing at its
+     * tab's `id`.
+     */
+    private managePanels;
+    /**
+     * @internal
+     *
+     * Recalculates the selection indicator's position and size based
+     * on the currently selected tab element. Uses CSS transforms for
+     * smooth animation between tab positions.
+     *
+     * The indicator is a fixed-size element (100px base) that gets
+     * `scaleX`/`scaleY` to match the selected tab's width/height,
+     * and `translateX`/`translateY` to match its offset position.
+     */
+    protected updateSelectionIndicator: () => Promise<void>;
+    /** @internal */
+    private _resizeObserver?;
+    /**
+     * @internal
+     *
+     * Watches for `dir` attribute changes so the indicator recalculates
+     * when writing direction flips at runtime. `getComputedStyle` in
+     * `updateSelectionIndicator` resolves inherited direction correctly,
+     * but nothing else observes it: a `dir` flip on the document root or
+     * an ancestor doesn't resize this element, so the `ResizeObserver`
+     * below won't catch it. Mirrors the `dir`-watching pattern in
+     * `placement-controller.ts`.
+     */
+    private _directionObserver?;
+    protected willUpdate(changes: PropertyValues): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Focuses the selected tab, or the first tab when none is selected yet.
+     * Slotted tabs live in the light DOM; this is more reliable than relying
+     * only on shadow `delegatesFocus` across browsers and test harnesses.
+     */
+    focus(options?: FocusOptions): void;
+    protected firstUpdated(changes: PropertyValues): void;
+    /**
+     * Waits for all child tab elements to finish their update cycle
+     * before resolving so layout-dependent callers see stable geometry.
+     */
+    getUpdateComplete(): Promise<boolean>;
+}

package/dist/components/tabs/Tabs.base.js

@@ -0,0 +1,213 @@
+import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
+import { KEYBOARD_ACTIVATIONS as t, KEYBOARD_ACTIVATION_DEFAULT as n, TABS_DEFAULT_DIRECTION as r, TABS_DIRECTIONS as i, TAB_DENSITIES as a, TAB_DENSITY_DEFAULT as o } from "./Tabs.types.js";
+import { property as s, state as c } from "lit/decorators.js";
+import { FocusgroupNavigationController as l, focusgroupNavigationActiveChange as u } from "@adobe/spectrum-wc-core/controllers/index.js";
+import { SpectrumElement as d } from "@adobe/spectrum-wc-core/element/index.js";
+import { validateEnum as f, warnIf as p } from "@adobe/spectrum-wc-core/utils/index.js";
+//#region components/tabs/Tabs.base.ts
+var m, h = class e extends d {
+	constructor(...t) {
+		super(...t), this._keyboardActivation = n, this._density = o, this._direction = r, this.disabled = !1, this.accessibleLabel = "", this.selected = "", this.selectionIndicatorStyle = "", this.shouldAnimate = !1, this._tabs = [], this._navigation = new l(this, {
+			direction: this._direction,
+			wrap: !0,
+			memory: !0,
+			getItems: () => this.disabled ? [] : this._tabs
+		}), this._handleNavigationActiveChange = (e) => {
+			if (this._keyboardActivation !== "automatic") return;
+			let { activeElement: t, source: n } = e.detail;
+			if (n !== "keyboard" && n !== "focus" || !t) return;
+			let r = t;
+			r.disabled || this.selectTarget(r);
+		}, this.updateSelectionIndicator = async () => {
+			var t, n;
+			let r = this._tabs.find((e) => e.selected);
+			if (!r) {
+				this.selectionIndicatorStyle = "transform: translateX(0px) scaleX(0) scaleY(0)";
+				return;
+			}
+			let i = (t = this.renderRoot) == null ? void 0 : t.querySelector(".tablist");
+			if (!i) return;
+			await Promise.all([(n = r.updateComplete) == null ? Promise.resolve() : n, document.fonts ? document.fonts.ready : Promise.resolve()]);
+			let a = r.getBoundingClientRect(), o = i.getBoundingClientRect();
+			this._direction === "horizontal" ? this.selectionIndicatorStyle = `transform: translateX(${getComputedStyle(this).direction === "rtl" ? a.right - o.right : a.left - o.left}px) scaleX(${a.width / e.INDICATOR_BASE_SIZE})` : this.selectionIndicatorStyle = `transform: translateY(${a.top - o.top}px) scaleY(${a.height / e.INDICATOR_BASE_SIZE})`, this.shouldAnimate || (await this.updateComplete, this.shouldAnimate = !0);
+		};
+	}
+	get keyboardActivation() {
+		return this._keyboardActivation;
+	}
+	set keyboardActivation(e) {
+		let r = t.includes(e);
+		f(this, {
+			prop: "keyboard-activation",
+			value: e,
+			valid: t,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs"
+		});
+		let i = r ? e : n;
+		if (this._keyboardActivation === i) return;
+		let a = this._keyboardActivation;
+		this._keyboardActivation = i, this.requestUpdate("keyboardActivation", a);
+	}
+	get density() {
+		return this._density;
+	}
+	set density(e) {
+		let t = a.includes(e);
+		f(this, {
+			prop: "density",
+			value: e,
+			valid: a,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs"
+		});
+		let n = t ? e : o;
+		if (this._density === n) return;
+		let r = this._density;
+		this._density = n, this.requestUpdate("density", r);
+	}
+	get direction() {
+		return this._direction;
+	}
+	set direction(e) {
+		let t = i.includes(e);
+		f(this, {
+			prop: "direction",
+			value: e,
+			valid: i,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs"
+		});
+		let n = t ? e : r;
+		if (this._direction === n) return;
+		let a = this._direction;
+		this._direction = n, this.requestUpdate("direction", a);
+	}
+	static isTabSlotNode(e) {
+		return e instanceof HTMLElement ? e.getAttribute("role") === "tab" ? !0 : e.localName === "swc-tab" : !1;
+	}
+	handleTabSlotChange(t) {
+		this._tabs = t.target.assignedElements().filter(e.isTabSlotNode), this._navigation.refresh(), this.updateCheckedState(), this.updateSelectionIndicator();
+	}
+	handlePanelSlotChange(e) {
+		let t = e.target.assignedElements();
+		this.managePanels(t);
+	}
+	handleClick(e) {
+		if (this.disabled) return;
+		let t = e.composedPath().find((e) => e.parentElement === this);
+		!t || t.disabled || this.selectTarget(t);
+	}
+	handleKeyDown(e) {
+		if (this.disabled) return;
+		let { code: t } = e;
+		if (t === "Enter" || t === "Space") {
+			e.preventDefault();
+			let t = e.target;
+			t && !t.disabled && this.selectTarget(t);
+		}
+	}
+	selectTarget(e) {
+		let t = e.tabId;
+		if (!t || t === this.selected) return;
+		let n = this.selected;
+		this.selected = t, this.updateCheckedState(), this.dispatchEvent(new Event("change", { cancelable: !0 })) || (this.selected = n);
+	}
+	updateCheckedState() {
+		for (let e of this._tabs) e.selected = !1;
+		if (this.selected) {
+			let e = this._tabs.find((e) => e.tabId === this.selected);
+			e ? (e.selected = !0, this._navigation.setActiveItem(e)) : this.selected = "";
+		}
+	}
+	managePanels(e) {
+		for (let t of e) {
+			let { tabId: e, id: n } = t, r = this.querySelector(`[role="tab"][tab-id="${e}"]`);
+			r && (r.setAttribute("aria-controls", n), t.setAttribute("aria-labelledby", r.id)), t.selected = e === this.selected;
+		}
+	}
+	willUpdate(e) {
+		if (!this.hasUpdated) {
+			let e = this.querySelector(":scope > [selected]");
+			e && this.selectTarget(e);
+		}
+		if (super.willUpdate(e), e.has("selected")) {
+			this._tabs.length && this.updateCheckedState();
+			let t = e.get("selected");
+			if (t) {
+				let e = this.querySelector(`[role="tabpanel"][tab-id="${t}"]`);
+				e && (e.selected = !1);
+			}
+			let n = this.querySelector(`[role="tabpanel"][tab-id="${this.selected}"]`);
+			n && (n.selected = !0), this.updateSelectionIndicator();
+		}
+		if (e.has("disabled") && this._tabs.length) if (this._navigation.refresh(), this.disabled) for (let e of this._tabs) e.tabIndex = -1;
+		else this.updateCheckedState();
+		e.has("direction") && (this._navigation.setOptions({ direction: this.direction }), this.updateSelectionIndicator());
+	}
+	connectedCallback() {
+		super.connectedCallback(), this.addEventListener(u, this._handleNavigationActiveChange), window.addEventListener("resize", this.updateSelectionIndicator), "fonts" in document && document.fonts.addEventListener("loadingdone", this.updateSelectionIndicator), this._resizeObserver = new ResizeObserver(() => {
+			this.updateSelectionIndicator();
+		}), this._resizeObserver.observe(this), this._directionObserver = new MutationObserver(() => {
+			this.updateSelectionIndicator();
+		});
+		let e = (e) => {
+			if (e) {
+				var t;
+				(t = this._directionObserver) == null || t.observe(e, {
+					attributes: !0,
+					attributeFilter: ["dir"]
+				});
+			}
+		};
+		e(this.ownerDocument.documentElement), e(this.closest("[dir]"));
+	}
+	disconnectedCallback() {
+		var e, t;
+		this.removeEventListener(u, this._handleNavigationActiveChange), window.removeEventListener("resize", this.updateSelectionIndicator), "fonts" in document && document.fonts.removeEventListener("loadingdone", this.updateSelectionIndicator), (e = this._resizeObserver) == null || e.disconnect(), this._resizeObserver = void 0, (t = this._directionObserver) == null || t.disconnect(), this._directionObserver = void 0, super.disconnectedCallback();
+	}
+	focus(e) {
+		if (this.disabled) return;
+		let t = this._tabs.find((e) => e.selected);
+		if (t) {
+			t.focus(e);
+			return;
+		}
+		if (this._tabs.length) {
+			this._tabs[0].focus(e);
+			return;
+		}
+		super.focus(e);
+	}
+	firstUpdated(e) {
+		super.firstUpdated(e), this.hasAttribute("direction") || this.setAttribute("direction", this.direction), p(this, !this.accessibleLabel, `<${this.localName}> requires an "accessible-label" attribute to provide an accessible name for the tablist.`, "https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs", {
+			type: "accessibility",
+			level: "high"
+		});
+	}
+	async getUpdateComplete() {
+		let e = await super.getUpdateComplete(), t = [...this.children].map((e) => "updateComplete" in e ? e.updateComplete : Promise.resolve(!0));
+		return await Promise.all(t), e;
+	}
+};
+m = h, m.VALID_DIRECTIONS = i, m.VALID_KEYBOARD_ACTIVATIONS = t, m.VALID_DENSITIES = a, m.INDICATOR_BASE_SIZE = 100, e([s({
+	type: String,
+	reflect: !0,
+	attribute: "keyboard-activation"
+})], h.prototype, "keyboardActivation", null), e([s({
+	type: String,
+	reflect: !0
+})], h.prototype, "density", null), e([s({
+	type: String,
+	reflect: !0
+})], h.prototype, "direction", null), e([s({
+	type: Boolean,
+	reflect: !0
+})], h.prototype, "disabled", void 0), e([s({
+	type: String,
+	attribute: "accessible-label"
+})], h.prototype, "accessibleLabel", void 0), e([s({
+	type: String,
+	reflect: !0
+})], h.prototype, "selected", void 0), e([c()], h.prototype, "selectionIndicatorStyle", void 0), e([c()], h.prototype, "shouldAnimate", void 0);
+//#endregion
+export { h as TabsBase };
+
+//# sourceMappingURL=Tabs.base.js.map

package/dist/components/tabs/Tabs.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.base.js","names":[],"sources":["../../../components/tabs/Tabs.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, state } from 'lit/decorators.js';\n\nimport {\n  focusgroupNavigationActiveChange,\n  type FocusgroupNavigationActiveChangeDetail,\n  FocusgroupNavigationController,\n} from '@adobe/spectrum-wc-core/controllers/index.js';\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { validateEnum, warnIf } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport {\n  KEYBOARD_ACTIVATION_DEFAULT,\n  KEYBOARD_ACTIVATIONS,\n  type KeyboardActivation,\n  TAB_DENSITIES,\n  TAB_DENSITY_DEFAULT,\n  type TabDensity,\n  type TabLike,\n  type TabPanelLike,\n  TABS_DEFAULT_DIRECTION,\n  TABS_DIRECTIONS,\n  type TabsDirection,\n} from './Tabs.types.js';\n\n/**\n * Base class for a tabbed interface container.\n *\n * Manages selection state, tab/panel association, ARIA wiring,\n * keyboard navigation, and event dispatching. Concrete classes\n * supply the stylesheet, render template, and visual behaviors\n * such as the selection indicator.\n *\n * Public API follows the Spectrum 2 / Spectrum Design–aligned surface\n * from the tabs migration plan: `keyboard-activation` and `density`\n * instead of legacy `auto`, `compact`, `quiet`, `emphasized`, and\n * t-shirt `size` attributes.\n *\n * @slot - Tab items (elements with `role=\"tab\"`)\n * @slot tab-panel - Tab panel content (elements with `role=\"tabpanel\"`)\n *\n * @fires change - The selected tab has changed. Cancelable —\n *   calling `preventDefault()` reverts the selection.\n */\nexport abstract class TabsBase extends SpectrumElement {\n  // ─────────────────────────\n  //     SHARED API\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * Valid direction values for validation and CEM/stories.\n   */\n  static readonly VALID_DIRECTIONS: readonly TabsDirection[] = TABS_DIRECTIONS;\n\n  /**\n   * @internal\n   */\n  static readonly VALID_KEYBOARD_ACTIVATIONS: readonly KeyboardActivation[] =\n    KEYBOARD_ACTIVATIONS;\n\n  /**\n   * @internal\n   */\n  static readonly VALID_DENSITIES: readonly TabDensity[] = TAB_DENSITIES;\n\n  /**\n   * Whether selection follows keyboard focus (`automatic`, default) or the\n   * user must press Enter or Space to activate (`manual`). Prefer `manual`\n   * when tab panels are expensive to render or not fully present in the DOM.\n   *\n   * @see https://w3c.github.io/aria-practices/#kbd_selection_follows_focus\n   */\n  @property({ type: String, reflect: true, attribute: 'keyboard-activation' })\n  public get keyboardActivation(): KeyboardActivation {\n    return this._keyboardActivation;\n  }\n\n  public set keyboardActivation(value: string) {\n    const isValid = (KEYBOARD_ACTIVATIONS as readonly string[]).includes(value);\n\n    validateEnum(this, {\n      prop: 'keyboard-activation',\n      value,\n      valid: KEYBOARD_ACTIVATIONS,\n      url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs',\n    });\n\n    const valid = isValid\n      ? (value as KeyboardActivation)\n      : KEYBOARD_ACTIVATION_DEFAULT;\n\n    if (this._keyboardActivation === valid) {\n      return;\n    }\n\n    const old = this._keyboardActivation;\n    this._keyboardActivation = valid;\n    this.requestUpdate('keyboardActivation', old);\n  }\n\n  /** @internal */\n  private _keyboardActivation: KeyboardActivation = KEYBOARD_ACTIVATION_DEFAULT;\n\n  /**\n   * Layout density: `regular` (default) or `compact` (reduced tab spacing).\n   */\n  @property({ type: String, reflect: true })\n  public get density(): TabDensity {\n    return this._density;\n  }\n\n  public set density(value: string) {\n    const isValid = (TAB_DENSITIES as readonly string[]).includes(value);\n\n    validateEnum(this, {\n      prop: 'density',\n      value,\n      valid: TAB_DENSITIES,\n      url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs',\n    });\n\n    const valid = isValid ? (value as TabDensity) : TAB_DENSITY_DEFAULT;\n\n    if (this._density === valid) {\n      return;\n    }\n\n    const old = this._density;\n    this._density = valid;\n    this.requestUpdate('density', old);\n  }\n\n  /** @internal */\n  private _density: TabDensity = TAB_DENSITY_DEFAULT;\n\n  /**\n   * The layout direction of the tab list: `horizontal` (default) or `vertical`.\n   *\n   * @default 'horizontal'\n   */\n  @property({ type: String, reflect: true })\n  public get direction(): TabsDirection {\n    return this._direction;\n  }\n\n  public set direction(value: TabsDirection) {\n    const isValid = (TABS_DIRECTIONS as readonly string[]).includes(value);\n\n    validateEnum(this, {\n      prop: 'direction',\n      value,\n      valid: TABS_DIRECTIONS,\n      url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs',\n    });\n\n    const validDirection = isValid\n      ? (value as TabsDirection)\n      : TABS_DEFAULT_DIRECTION;\n\n    if (this._direction === validDirection) {\n      return;\n    }\n\n    const oldDirection = this._direction;\n    this._direction = validDirection;\n    this.requestUpdate('direction', oldDirection);\n  }\n\n  /** @internal */\n  private _direction: TabsDirection = TABS_DEFAULT_DIRECTION;\n\n  /**\n   * Whether the entire tab list is disabled. When `true`,\n   * `aria-disabled=\"true\"` is applied to the tablist element and\n   * all interaction is suppressed.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled = false;\n\n  /**\n   * Accessible label for the tablist. Rendered as `aria-label` on the\n   * element with `role=\"tablist\"` in the concrete template.\n   */\n  @property({ type: String, attribute: 'accessible-label' })\n  public accessibleLabel = '';\n\n  /**\n   * The `tab-id` of the currently selected tab. Setting this property\n   * updates which tab appears selected and which panel is visible.\n   */\n  @property({ type: String, reflect: true })\n  public selected = '';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  /** @internal */\n  private static readonly INDICATOR_BASE_SIZE = 100;\n\n  /**\n   * @internal\n   *\n   * Inline style applied to the selection indicator element.\n   * Computed from the selected tab's position and dimensions.\n   */\n  @state()\n  protected selectionIndicatorStyle = '';\n\n  /**\n   * @internal\n   *\n   * Suppresses the transition on the very first indicator placement\n   * so it doesn't animate from the origin.\n   */\n  @state()\n  protected shouldAnimate = false;\n\n  /**\n   * @internal\n   *\n   * Cached list of tab elements managed by this container. Updated\n   * via `handleTabSlotChange`.\n   */\n  private _tabs: TabLike[] = [];\n\n  /**\n   * @internal\n   *\n   * Manages roving tabindex and arrow-key / Home / End focus movement within\n   * the tab list. Direction is kept in sync with `this.direction` via\n   * `setOptions` in `willUpdate`. Disabled tabs remain in the navigation\n   * sequence (per APG) but are not activatable.\n   *\n   * `getItems` returns an empty array when the container is disabled so all\n   * tabs lose their tab stop, matching the `aria-disabled` tablist behavior.\n   */\n  private readonly _navigation = new FocusgroupNavigationController(this, {\n    direction: this._direction,\n    wrap: true,\n    memory: true,\n    getItems: () => (this.disabled ? [] : (this._tabs as HTMLElement[])),\n  });\n\n  /**\n   * Handles `focusgroupNavigationActiveChange` events dispatched by\n   * `_navigation`. In automatic activation mode, selects the newly focused\n   * tab (unless it is disabled).\n   *\n   * Only `source: 'keyboard'` (arrow keys, Home/End) and `source: 'focus'`\n   * (pointer click, Tab-key entry) represent a real focus move that\n   * \"selection follows focus\" should react to. `'refresh'` and\n   * `'programmatic'` fire when `_navigation` re-parks the roving tab stop\n   * without anyone actually moving focus there — for example on mount or when\n   * re-enabling after `disabled` — and must not trigger a spurious selection\n   * or `change` event.\n   */\n  private readonly _handleNavigationActiveChange = (event: Event): void => {\n    if (this._keyboardActivation !== 'automatic') {\n      return;\n    }\n    const { activeElement, source } = (\n      event as CustomEvent<FocusgroupNavigationActiveChangeDetail>\n    ).detail;\n    if (source !== 'keyboard' && source !== 'focus') {\n      return;\n    }\n    if (!activeElement) {\n      return;\n    }\n    const tab = activeElement as TabLike;\n    if (tab.disabled) {\n      return;\n    }\n    this.selectTarget(tab);\n  };\n\n  /**\n   * Whether an assigned node is treated as a tab. `role=\"tab\"` is set in\n   * each tab's `firstUpdated`, so `slotchange` may run before that — accept\n   * known tab host tag names so the tab list and selection indicator sync.\n   */\n  private static isTabSlotNode(el: Element): el is TabLike {\n    if (!(el instanceof HTMLElement)) {\n      return false;\n    }\n    if (el.getAttribute('role') === 'tab') {\n      return true;\n    }\n    return el.localName === 'swc-tab';\n  }\n\n  /**\n   * Called by the concrete class when the default slot's content\n   * changes. Rebuilds the internal tab list and syncs selection\n   * state.\n   */\n  protected handleTabSlotChange(event: Event): void {\n    const slot = event.target as HTMLSlotElement;\n    this._tabs = slot\n      .assignedElements()\n      .filter(TabsBase.isTabSlotNode) as TabLike[];\n\n    this._navigation.refresh();\n    this.updateCheckedState();\n    this.updateSelectionIndicator();\n  }\n\n  /**\n   * Called by the concrete class when the `tab-panel` slot's content\n   * changes. Wires up `aria-controls` / `aria-labelledby` between\n   * each tab and its panel.\n   */\n  protected handlePanelSlotChange(event: Event): void {\n    const slot = event.target as HTMLSlotElement;\n    const panels = slot.assignedElements() as TabPanelLike[];\n    this.managePanels(panels);\n  }\n\n  /**\n   * Click handler bound to the tablist wrapper in the concrete\n   * template. Activates the clicked tab.\n   */\n  protected handleClick(event: Event): void {\n    if (this.disabled) {\n      return;\n    }\n\n    const target = event\n      .composedPath()\n      .find((el) => (el as TabLike).parentElement === this) as\n      | TabLike\n      | undefined;\n\n    if (!target || target.disabled) {\n      return;\n    }\n\n    this.selectTarget(target);\n  }\n\n  /**\n   * Keyboard handler for Enter and Space activation. Arrow-key, Home, and\n   * End navigation is handled by `FocusgroupNavigationController` in capture\n   * phase on the host element.\n   */\n  protected handleKeyDown(event: KeyboardEvent): void {\n    if (this.disabled) {\n      return;\n    }\n\n    const { code } = event;\n    if (code === 'Enter' || code === 'Space') {\n      event.preventDefault();\n      const target = event.target as TabLike | null;\n      if (target && !target.disabled) {\n        this.selectTarget(target);\n      }\n    }\n  }\n\n  /**\n   * Attempts to select the given tab element. Dispatches a cancelable\n   * `change` event — if the consumer calls `preventDefault()`, the\n   * selection reverts to the previous value.\n   */\n  private selectTarget(target: TabLike): void {\n    const id = target.tabId;\n    if (!id || id === this.selected) {\n      return;\n    }\n\n    const previous = this.selected;\n    this.selected = id;\n\n    // Sync child tab.selected eagerly so that change-event handlers read the\n    // correct state on individual tab elements without waiting for the next\n    // Lit render cycle (tabs.selected is already updated synchronously above).\n    this.updateCheckedState();\n\n    const applyDefault = this.dispatchEvent(\n      new Event('change', {\n        cancelable: true,\n      })\n    );\n\n    if (!applyDefault) {\n      this.selected = previous;\n    }\n  }\n\n  /**\n   * Synchronizes the `selected` property on each child tab to match\n   * `this.selected`, then parks the roving tab stop on the selected tab via\n   * `_navigation.setActiveItem`. Tabindex management is otherwise owned by\n   * `FocusgroupNavigationController` — for example, `_navigation.refresh()`\n   * resets all tabindex values when the tab list or `disabled` state changes.\n   */\n  private updateCheckedState(): void {\n    for (const tab of this._tabs) {\n      tab.selected = false;\n    }\n\n    if (this.selected) {\n      const currentTab = this._tabs.find((el) => el.tabId === this.selected);\n\n      if (currentTab) {\n        currentTab.selected = true;\n        this._navigation.setActiveItem(currentTab as HTMLElement);\n      } else {\n        this.selected = '';\n      }\n    }\n  }\n\n  /**\n   * Wires up cross-element ARIA relationships between tabs and\n   * panels. Each tab gets `aria-controls` pointing at its panel's\n   * `id`, and each panel gets `aria-labelledby` pointing at its\n   * tab's `id`.\n   */\n  private managePanels(panels: TabPanelLike[]): void {\n    for (const panel of panels) {\n      const { tabId, id } = panel;\n      const tab = this.querySelector(`[role=\"tab\"][tab-id=\"${tabId}\"]`);\n\n      if (tab) {\n        tab.setAttribute('aria-controls', id);\n        panel.setAttribute('aria-labelledby', tab.id);\n      }\n\n      panel.selected = tabId === this.selected;\n    }\n  }\n\n  // ───────────────────────────────────\n  //     SELECTION INDICATOR\n  // ───────────────────────────────────\n\n  /**\n   * @internal\n   *\n   * Recalculates the selection indicator's position and size based\n   * on the currently selected tab element. Uses CSS transforms for\n   * smooth animation between tab positions.\n   *\n   * The indicator is a fixed-size element (100px base) that gets\n   * `scaleX`/`scaleY` to match the selected tab's width/height,\n   * and `translateX`/`translateY` to match its offset position.\n   */\n  protected updateSelectionIndicator = async (): Promise<void> => {\n    const selectedElement = this._tabs.find((el) => el.selected);\n    if (!selectedElement) {\n      this.selectionIndicatorStyle =\n        'transform: translateX(0px) scaleX(0) scaleY(0)';\n      return;\n    }\n\n    const tablist = this.renderRoot?.querySelector('.tablist');\n    if (!tablist) {\n      return;\n    }\n\n    await Promise.all([\n      (selectedElement as HTMLElement & { updateComplete?: Promise<boolean> })\n        .updateComplete ?? Promise.resolve(),\n      document.fonts ? document.fonts.ready : Promise.resolve(),\n    ]);\n\n    const tabRect = selectedElement.getBoundingClientRect();\n    const listRect = tablist.getBoundingClientRect();\n\n    if (this._direction === 'horizontal') {\n      const isRtl = getComputedStyle(this).direction === 'rtl';\n      const offset = isRtl\n        ? tabRect.right - listRect.right\n        : tabRect.left - listRect.left;\n      const scale = tabRect.width / TabsBase.INDICATOR_BASE_SIZE;\n      this.selectionIndicatorStyle = `transform: translateX(${offset}px) scaleX(${scale})`;\n    } else {\n      const top = tabRect.top - listRect.top;\n      const scale = tabRect.height / TabsBase.INDICATOR_BASE_SIZE;\n      this.selectionIndicatorStyle = `transform: translateY(${top}px) scaleY(${scale})`;\n    }\n\n    if (!this.shouldAnimate) {\n      await this.updateComplete;\n      this.shouldAnimate = true;\n    }\n  };\n\n  /** @internal */\n  private _resizeObserver?: ResizeObserver;\n\n  /**\n   * @internal\n   *\n   * Watches for `dir` attribute changes so the indicator recalculates\n   * when writing direction flips at runtime. `getComputedStyle` in\n   * `updateSelectionIndicator` resolves inherited direction correctly,\n   * but nothing else observes it: a `dir` flip on the document root or\n   * an ancestor doesn't resize this element, so the `ResizeObserver`\n   * below won't catch it. Mirrors the `dir`-watching pattern in\n   * `placement-controller.ts`.\n   */\n  private _directionObserver?: MutationObserver;\n\n  // ───────────────────────────────────\n  //     LIFECYCLE\n  // ───────────────────────────────────\n\n  protected override willUpdate(changes: PropertyValues): void {\n    if (!this.hasUpdated) {\n      const selectedChild = this.querySelector(\n        ':scope > [selected]'\n      ) as TabLike | null;\n\n      if (selectedChild) {\n        this.selectTarget(selectedChild);\n      }\n    }\n\n    super.willUpdate(changes);\n\n    if (changes.has('selected')) {\n      if (this._tabs.length) {\n        this.updateCheckedState();\n      }\n\n      const previousValue = changes.get('selected') as string | undefined;\n      if (previousValue) {\n        const previous = this.querySelector(\n          `[role=\"tabpanel\"][tab-id=\"${previousValue}\"]`\n        ) as TabPanelLike | null;\n\n        if (previous) {\n          previous.selected = false;\n        }\n      }\n\n      const next = this.querySelector(\n        `[role=\"tabpanel\"][tab-id=\"${this.selected}\"]`\n      ) as TabPanelLike | null;\n\n      if (next) {\n        next.selected = true;\n      }\n\n      this.updateSelectionIndicator();\n    }\n\n    if (changes.has('disabled') && this._tabs.length) {\n      this._navigation.refresh();\n      if (this.disabled) {\n        // When disabled, getItems() returns [] so the controller's cleanup\n        // loop in refresh() iterates nothing. Explicitly remove all tabs from\n        // the tab order so the tablist is fully inert.\n        for (const tab of this._tabs) {\n          (tab as HTMLElement).tabIndex = -1;\n        }\n      } else {\n        // After re-enabling, restore the roving tab stop to the selected tab.\n        this.updateCheckedState();\n      }\n    }\n\n    if (changes.has('direction')) {\n      this._navigation.setOptions({ direction: this.direction });\n      this.updateSelectionIndicator();\n    }\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    this.addEventListener(\n      focusgroupNavigationActiveChange,\n      this._handleNavigationActiveChange\n    );\n    window.addEventListener('resize', this.updateSelectionIndicator);\n    if ('fonts' in document) {\n      document.fonts.addEventListener(\n        'loadingdone',\n        this.updateSelectionIndicator\n      );\n    }\n    this._resizeObserver = new ResizeObserver(() => {\n      this.updateSelectionIndicator();\n    });\n    this._resizeObserver.observe(this);\n\n    this._directionObserver = new MutationObserver(() => {\n      this.updateSelectionIndicator();\n    });\n    const observeDir = (node: Element | null | undefined) => {\n      if (node) {\n        this._directionObserver?.observe(node, {\n          attributes: true,\n          attributeFilter: ['dir'],\n        });\n      }\n    };\n    observeDir(this.ownerDocument.documentElement);\n    observeDir(this.closest('[dir]'));\n  }\n\n  public override disconnectedCallback(): void {\n    this.removeEventListener(\n      focusgroupNavigationActiveChange,\n      this._handleNavigationActiveChange\n    );\n    window.removeEventListener('resize', this.updateSelectionIndicator);\n    if ('fonts' in document) {\n      document.fonts.removeEventListener(\n        'loadingdone',\n        this.updateSelectionIndicator\n      );\n    }\n    this._resizeObserver?.disconnect();\n    this._resizeObserver = undefined;\n    this._directionObserver?.disconnect();\n    this._directionObserver = undefined;\n    super.disconnectedCallback();\n  }\n\n  /**\n   * Focuses the selected tab, or the first tab when none is selected yet.\n   * Slotted tabs live in the light DOM; this is more reliable than relying\n   * only on shadow `delegatesFocus` across browsers and test harnesses.\n   */\n  public override focus(options?: FocusOptions): void {\n    if (this.disabled) {\n      return;\n    }\n\n    const selectedTab = this._tabs.find((tab) => tab.selected);\n    if (selectedTab) {\n      (selectedTab as HTMLElement).focus(options);\n      return;\n    }\n\n    if (this._tabs.length) {\n      (this._tabs[0] as HTMLElement).focus(options);\n      return;\n    }\n\n    super.focus(options);\n  }\n\n  protected override firstUpdated(changes: PropertyValues): void {\n    super.firstUpdated(changes);\n\n    if (!this.hasAttribute('direction')) {\n      this.setAttribute('direction', this.direction);\n    }\n\n    warnIf(\n      this,\n      !this.accessibleLabel,\n      `<${this.localName}> requires an \"accessible-label\" attribute to provide an accessible name for the tablist.`,\n      'https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs',\n      { type: 'accessibility', level: 'high' }\n    );\n  }\n\n  /**\n   * Waits for all child tab elements to finish their update cycle\n   * before resolving so layout-dependent callers see stable geometry.\n   */\n  public override async getUpdateComplete(): Promise<boolean> {\n    const complete = await super.getUpdateComplete();\n\n    const children = [...this.children] as HTMLElement[];\n    const childUpdates = children.map((child) => {\n      if ('updateComplete' in child) {\n        return (child as unknown as { updateComplete: Promise<boolean> })\n          .updateComplete;\n      }\n      return Promise.resolve(true);\n    });\n\n    await Promise.all(childUpdates);\n    return complete;\n  }\n}\n"],"mappings":"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"}

package/dist/components/tabs/Tabs.types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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.
+ */
+/**
+ * Valid orientation directions for the tabs component.
+ *
+ * **`vertical-right`** was supported in 1st-gen but is not part of the
+ * S2-aligned `swc-tabs` surface; use `direction="vertical"` instead.
+ */
+export declare const TABS_DIRECTIONS: readonly ["horizontal", "vertical"];
+export type TabsDirection = (typeof TABS_DIRECTIONS)[number];
+export declare const TABS_DEFAULT_DIRECTION: "horizontal";
+/**
+ * How keyboard focus interacts with selection (Spectrum Design / S2 naming).
+ *
+ * - **`automatic`**: Selection follows focus as the user arrows between tabs
+ *   (default, matches React Spectrum/React Aria `Tabs`).
+ * - **`manual`**: Arrow keys move focus; Enter or Space activates. Prefer this
+ *   for tab panels that are expensive to render or not fully present in the DOM.
+ */
+export declare const KEYBOARD_ACTIVATIONS: readonly ["manual", "automatic"];
+export type KeyboardActivation = (typeof KEYBOARD_ACTIVATIONS)[number];
+export declare const KEYBOARD_ACTIVATION_DEFAULT: "automatic";
+/**
+ * Tab list density (Spectrum Design `density` naming).
+ */
+export declare const TAB_DENSITIES: readonly ["regular", "compact"];
+export type TabDensity = (typeof TAB_DENSITIES)[number];
+export declare const TAB_DENSITY_DEFAULT: "regular";
+/**
+ * Structural interface for tab-like elements managed by the tabs
+ * container. Allows the base class to work with any element that
+ * satisfies this contract without coupling to a concrete class.
+ */
+export interface TabLike extends HTMLElement {
+    tabId: string;
+    selected: boolean;
+    disabled: boolean;
+}
+/**
+ * Structural interface for tab-panel-like elements managed by the
+ * tabs container.
+ */
+export interface TabPanelLike extends HTMLElement {
+    tabId: string;
+    selected: boolean;
+}

package/dist/components/tabs/Tabs.types.js

@@ -0,0 +1,6 @@
+//#region components/tabs/Tabs.types.ts
+var e = ["horizontal", "vertical"], t = "horizontal", n = ["manual", "automatic"], r = "automatic", i = ["regular", "compact"], a = "regular";
+//#endregion
+export { n as KEYBOARD_ACTIVATIONS, r as KEYBOARD_ACTIVATION_DEFAULT, t as TABS_DEFAULT_DIRECTION, e as TABS_DIRECTIONS, i as TAB_DENSITIES, a as TAB_DENSITY_DEFAULT };
+
+//# sourceMappingURL=Tabs.types.js.map

package/dist/components/tabs/Tabs.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.types.js","names":[],"sources":["../../../components/tabs/Tabs.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 * Valid orientation directions for the tabs component.\n *\n * **`vertical-right`** was supported in 1st-gen but is not part of the\n * S2-aligned `swc-tabs` surface; use `direction=\"vertical\"` instead.\n */\nexport const TABS_DIRECTIONS = ['horizontal', 'vertical'] as const;\n\nexport type TabsDirection = (typeof TABS_DIRECTIONS)[number];\n\nexport const TABS_DEFAULT_DIRECTION =\n  'horizontal' as const satisfies TabsDirection;\n\n/**\n * How keyboard focus interacts with selection (Spectrum Design / S2 naming).\n *\n * - **`automatic`**: Selection follows focus as the user arrows between tabs\n *   (default, matches React Spectrum/React Aria `Tabs`).\n * - **`manual`**: Arrow keys move focus; Enter or Space activates. Prefer this\n *   for tab panels that are expensive to render or not fully present in the DOM.\n */\nexport const KEYBOARD_ACTIVATIONS = ['manual', 'automatic'] as const;\n\nexport type KeyboardActivation = (typeof KEYBOARD_ACTIVATIONS)[number];\n\nexport const KEYBOARD_ACTIVATION_DEFAULT =\n  'automatic' as const satisfies KeyboardActivation;\n\n/**\n * Tab list density (Spectrum Design `density` naming).\n */\nexport const TAB_DENSITIES = ['regular', 'compact'] as const;\n\nexport type TabDensity = (typeof TAB_DENSITIES)[number];\n\nexport const TAB_DENSITY_DEFAULT = 'regular' as const satisfies TabDensity;\n\n/**\n * Structural interface for tab-like elements managed by the tabs\n * container. Allows the base class to work with any element that\n * satisfies this contract without coupling to a concrete class.\n */\nexport interface TabLike extends HTMLElement {\n  tabId: string;\n  selected: boolean;\n  disabled: boolean;\n}\n\n/**\n * Structural interface for tab-panel-like elements managed by the\n * tabs container.\n */\nexport interface TabPanelLike extends HTMLElement {\n  tabId: string;\n  selected: boolean;\n}\n"],"mappings":";AAkBA,IAAa,IAAkB,CAAC,cAAc,WAAW,EAI5C,IACX,cAUW,IAAuB,CAAC,UAAU,YAAY,EAI9C,IACX,aAKW,IAAgB,CAAC,WAAW,UAAU,EAItC,IAAsB"}

package/dist/components/tabs/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+export * from './Tab.base.js';
+export * from './Tab.types.js';
+export * from './TabPanel.base.js';
+export * from './TabPanel.types.js';
+export * from './Tabs.base.js';
+export * from './Tabs.types.js';