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

package/dist/components/progress-circle/ProgressCircle.base.d.ts

@@ -0,0 +1,83 @@
+import { PropertyValues } from 'lit';
+import { SpectrumElement } from '../../element/index.js';
+import { PROGRESS_CIRCLE_VALID_SIZES, ProgressCircleStaticColor } from './ProgressCircle.types.js';
+declare const ProgressCircleBase_base: typeof SpectrumElement & {
+    new (...args: any[]): import('../../mixins/index.js').SizedElementInterface;
+    prototype: import('../../mixins/index.js').SizedElementInterface;
+} & import('../../mixins/index.js').SizedElementConstructor;
+/**
+ * A progress circle component that visually represents the completion progress of a task.
+ * Can be used in both determinate (with specific progress value) and indeterminate (loading) states.
+ *
+ * @attribute {ElementSize} size - The size of the progress circle.
+ */
+export declare abstract class ProgressCircleBase extends ProgressCircleBase_base {
+    /**
+     * The size of the progress circle.
+     *
+     * @default m
+     */
+    size: (typeof PROGRESS_CIRCLE_VALID_SIZES)[number];
+    /**
+     * @internal
+     *
+     * A readonly array of the valid static colors for the progress circle.
+     *
+     * This is an actual internal property, intended not for customer use
+     * but for use in internal validation logic, stories, tests, etc.
+     *
+     * Because S1 and S2 support different static colors, the value of this
+     * property must be set in each subclass.
+     */
+    static readonly STATIC_COLORS: readonly string[];
+    /**
+     * @internal
+     *
+     * Static color variant for use on different backgrounds.
+     *
+     * This is a public property, but its valid values vary between S1 and S2,
+     * so the property (and its docs) need to be redefined in each subclass.
+     *
+     * The type declared here is a union of the valid values for S1 and S2,
+     * and should be narrowed in each subclass.
+     */
+    staticColor?: ProgressCircleStaticColor;
+    /**
+     * Accessible label for the progress circle.
+     *
+     * Used to provide context about what is loading or progressing.
+     * When no accessible name is provided (no label, aria-label, or
+     * aria-labelledby), a default "Loading" label is applied.
+     *
+     * @todo Localize the default "Loading" fallback via LanguageResolutionController
+     * once a runtime i18n system for static strings is available.
+     */
+    label: string;
+    /**
+     * Progress value from 0 to 100.
+     *
+     * When `null` (indeterminate), the component shows a loading animation.
+     * Setting a number switches to determinate mode. Removing the `progress`
+     * attribute or setting this property to `null` returns to indeterminate.
+     * Values outside 0–100 or non-finite numbers are clamped (non-finite becomes 0).
+     *
+     * Reflected to the `progress` attribute when set; the attribute is omitted when indeterminate.
+     */
+    progress: number | null;
+    private languageResolver;
+    /**
+     * @todo Localize via LanguageResolutionController once a runtime i18n
+     * system for static strings is available.
+     */
+    private static readonly DEFAULT_LABEL;
+    /** True when light DOM has element nodes or non-whitespace text (no default slot). */
+    private static hasMeaningfulLightDomChildren;
+    private hasAccessibleName;
+    private static clampProgress;
+    private formatProgress;
+    private warnDeprecatedLightDomChildren;
+    protected willUpdate(changes: PropertyValues): void;
+    protected firstUpdated(changes: PropertyValues): void;
+    protected updated(changes: PropertyValues): void;
+}
+export {};

package/dist/components/progress-circle/ProgressCircle.base.js

@@ -0,0 +1,77 @@
+import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
+import { PROGRESS_CIRCLE_VALID_SIZES as t } from "./ProgressCircle.types.js";
+import { property as n } from "lit/decorators.js";
+import { SpectrumElement as r } from "@adobe/spectrum-wc-core/element/index.js";
+import { SizedMixin as i } from "@adobe/spectrum-wc-core/mixins/index.js";
+import { isDebug as a, validateEnum as o, warnIf as s } from "@adobe/spectrum-wc-core/utils/index.js";
+import { LanguageResolutionController as c, languageResolverUpdatedSymbol as l } from "@adobe/spectrum-wc-core/controllers/language-resolution.js";
+//#region components/progress-circle/ProgressCircle.base.ts
+var u, d = class e extends i(r, { validSizes: t }) {
+	constructor(...e) {
+		super(...e), this.label = "", this.progress = null, this.languageResolver = new c(this);
+	}
+	static hasMeaningfulLightDomChildren(e) {
+		for (let n of e.childNodes) {
+			var t;
+			if (n.nodeType === Node.ELEMENT_NODE || n.nodeType === Node.TEXT_NODE && (t = n.textContent) != null && t.trim()) return !0;
+		}
+		return !1;
+	}
+	hasAccessibleName() {
+		return !!(this.label || this.getAttribute("aria-label") || this.getAttribute("aria-labelledby"));
+	}
+	static clampProgress(e) {
+		return Number.isFinite(e) ? Math.min(100, Math.max(0, e)) : 0;
+	}
+	formatProgress() {
+		var e;
+		return new Intl.NumberFormat(this.languageResolver.language, {
+			style: "percent",
+			unitDisplay: "narrow"
+		}).format(((e = this.progress) == null ? 0 : e) / 100);
+	}
+	warnDeprecatedLightDomChildren() {
+		s(this, e.hasMeaningfulLightDomChildren(this), `<${this.localName}> no longer has a default slot. Light DOM children are not rendered and are not used for an accessible name. Use the "label" attribute or property, or "aria-label" / "aria-labelledby" on the host instead.`, "https://spectrum-web-components.adobe.com/?path=/docs/components-progress-circle--docs", { level: "deprecation" });
+	}
+	willUpdate(t) {
+		if (t.has("progress") && this.progress !== null) {
+			let t = e.clampProgress(this.progress);
+			t !== this.progress && (this.progress = t);
+		}
+		super.willUpdate(t);
+	}
+	firstUpdated(e) {
+		super.firstUpdated(e), this.setAttribute("role", "progressbar");
+	}
+	updated(t) {
+		if (super.updated(t), t.has("progress") && (this.progress !== null && this.progress >= 0 ? (this.setAttribute("aria-valuemin", "0"), this.setAttribute("aria-valuemax", "100"), this.setAttribute("aria-valuenow", String(this.progress)), this.setAttribute("aria-valuetext", this.formatProgress())) : (this.removeAttribute("aria-valuemin"), this.removeAttribute("aria-valuemax"), this.removeAttribute("aria-valuenow"), this.removeAttribute("aria-valuetext"))), this.progress !== null && t.has(l) && this.setAttribute("aria-valuetext", this.formatProgress()), t.has("label") && (this.label.length ? this.setAttribute("aria-label", this.label) : t.get("label") === this.getAttribute("aria-label") && this.removeAttribute("aria-label")), t.has("label") && !this.hasAccessibleName() && (this.setAttribute("aria-label", e.DEFAULT_LABEL), s(this, !0, `<${this.localName}> requires an accessible name. A default label of "${e.DEFAULT_LABEL}" has been applied, but a more specific label should be provided via:`, "https://spectrum-web-components.adobe.com/?path=/docs/components-progress-circle--docs", {
+			type: "accessibility",
+			issues: [
+				"value supplied to the \"label\" attribute, which will be displayed visually as part of the element, or",
+				"value supplied to the \"aria-label\" attribute, which will only be provided to screen readers, or",
+				"an element ID reference supplied to the \"aria-labelledby\" attribute, which will be provided by screen readers and will need to be managed manually by the parent application."
+			]
+		})), t.has("staticColor") && this.staticColor !== void 0) {
+			let e = this.constructor;
+			o(this, {
+				prop: "static-color",
+				value: this.staticColor,
+				valid: e.STATIC_COLORS,
+				url: "https://spectrum-web-components.adobe.com/?path=/docs/components-progress-circle--docs"
+			});
+		}
+		a() && this.warnDeprecatedLightDomChildren();
+	}
+};
+u = d, u.DEFAULT_LABEL = "Loading", e([n({
+	type: String,
+	reflect: !0,
+	attribute: "static-color"
+})], d.prototype, "staticColor", void 0), e([n({ type: String })], d.prototype, "label", void 0), e([n({
+	type: Number,
+	reflect: !0
+})], d.prototype, "progress", void 0);
+//#endregion
+export { d as ProgressCircleBase };
+
+//# sourceMappingURL=ProgressCircle.base.js.map

package/dist/components/progress-circle/ProgressCircle.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressCircle.base.js","names":[],"sources":["../../../components/progress-circle/ProgressCircle.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport {\n  LanguageResolutionController,\n  languageResolverUpdatedSymbol,\n} from '@adobe/spectrum-wc-core/controllers/language-resolution.js';\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { SizedMixin } from '@adobe/spectrum-wc-core/mixins/index.js';\nimport {\n  isDebug,\n  validateEnum,\n  warnIf,\n} from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport {\n  PROGRESS_CIRCLE_VALID_SIZES,\n  ProgressCircleStaticColor,\n} from './ProgressCircle.types.js';\n\n/**\n * A progress circle component that visually represents the completion progress of a task.\n * Can be used in both determinate (with specific progress value) and indeterminate (loading) states.\n *\n * @attribute {ElementSize} size - The size of the progress circle.\n */\nexport abstract class ProgressCircleBase extends SizedMixin(SpectrumElement, {\n  validSizes: PROGRESS_CIRCLE_VALID_SIZES,\n}) {\n  /**\n   * The size of the progress circle.\n   *\n   * @default m\n   */\n  declare public size: (typeof PROGRESS_CIRCLE_VALID_SIZES)[number];\n\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of the valid static colors for the progress circle.\n   *\n   * This is an actual internal property, intended not for customer use\n   * but for use in internal validation logic, stories, tests, etc.\n   *\n   * Because S1 and S2 support different static colors, the value of this\n   * property must be set in each subclass.\n   */\n  static readonly STATIC_COLORS: readonly string[];\n\n  /**\n   * @internal\n   *\n   * Static color variant for use on different backgrounds.\n   *\n   * This is a public property, but its valid values vary between S1 and S2,\n   * so the property (and its docs) need to be redefined in each subclass.\n   *\n   * The type declared here is a union of the valid values for S1 and S2,\n   * and should be narrowed in each subclass.\n   */\n  @property({ type: String, reflect: true, attribute: 'static-color' })\n  public staticColor?: ProgressCircleStaticColor;\n\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * Accessible label for the progress circle.\n   *\n   * Used to provide context about what is loading or progressing.\n   * When no accessible name is provided (no label, aria-label, or\n   * aria-labelledby), a default \"Loading\" label is applied.\n   *\n   * @todo Localize the default \"Loading\" fallback via LanguageResolutionController\n   * once a runtime i18n system for static strings is available.\n   */\n  @property({ type: String })\n  public label = '';\n\n  /**\n   * Progress value from 0 to 100.\n   *\n   * When `null` (indeterminate), the component shows a loading animation.\n   * Setting a number switches to determinate mode. Removing the `progress`\n   * attribute or setting this property to `null` returns to indeterminate.\n   * Values outside 0–100 or non-finite numbers are clamped (non-finite becomes 0).\n   *\n   * Reflected to the `progress` attribute when set; the attribute is omitted when indeterminate.\n   */\n  @property({ type: Number, reflect: true })\n  public progress: number | null = null;\n\n  private languageResolver = new LanguageResolutionController(this);\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  /**\n   * @todo Localize via LanguageResolutionController once a runtime i18n\n   * system for static strings is available.\n   */\n  private static readonly DEFAULT_LABEL = 'Loading';\n\n  /** True when light DOM has element nodes or non-whitespace text (no default slot). */\n  private static hasMeaningfulLightDomChildren(host: HTMLElement): boolean {\n    for (const node of host.childNodes) {\n      if (\n        node.nodeType === Node.ELEMENT_NODE ||\n        (node.nodeType === Node.TEXT_NODE && node.textContent?.trim())\n      ) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  private hasAccessibleName(): boolean {\n    return Boolean(\n      this.label ||\n      this.getAttribute('aria-label') ||\n      this.getAttribute('aria-labelledby')\n    );\n  }\n\n  private static clampProgress(value: number): number {\n    if (!Number.isFinite(value)) {\n      return 0;\n    }\n    return Math.min(100, Math.max(0, value));\n  }\n\n  private formatProgress(): string {\n    return new Intl.NumberFormat(this.languageResolver.language, {\n      style: 'percent',\n      unitDisplay: 'narrow',\n    }).format((this.progress ?? 0) / 100);\n  }\n\n  private warnDeprecatedLightDomChildren(): void {\n    warnIf(\n      this,\n      ProgressCircleBase.hasMeaningfulLightDomChildren(this),\n      `<${this.localName}> no longer has a default slot. Light DOM children are not rendered and are not used for an accessible name. Use the \"label\" attribute or property, or \"aria-label\" / \"aria-labelledby\" on the host instead.`,\n      'https://spectrum-web-components.adobe.com/?path=/docs/components-progress-circle--docs',\n      { level: 'deprecation' }\n    );\n  }\n\n  protected override willUpdate(changes: PropertyValues): void {\n    if (changes.has('progress') && this.progress !== null) {\n      const clamped = ProgressCircleBase.clampProgress(this.progress);\n      if (clamped !== this.progress) {\n        this.progress = clamped;\n      }\n    }\n\n    super.willUpdate(changes);\n  }\n\n  protected override firstUpdated(changes: PropertyValues): void {\n    super.firstUpdated(changes);\n    this.setAttribute('role', 'progressbar');\n  }\n\n  protected override updated(changes: PropertyValues): void {\n    super.updated(changes);\n\n    if (changes.has('progress')) {\n      if (this.progress !== null && this.progress >= 0) {\n        this.setAttribute('aria-valuemin', '0');\n        this.setAttribute('aria-valuemax', '100');\n        this.setAttribute('aria-valuenow', String(this.progress));\n        this.setAttribute('aria-valuetext', this.formatProgress());\n      } else {\n        this.removeAttribute('aria-valuemin');\n        this.removeAttribute('aria-valuemax');\n        this.removeAttribute('aria-valuenow');\n        this.removeAttribute('aria-valuetext');\n      }\n    }\n\n    if (this.progress !== null && changes.has(languageResolverUpdatedSymbol)) {\n      this.setAttribute('aria-valuetext', this.formatProgress());\n    }\n\n    if (changes.has('label')) {\n      if (this.label.length) {\n        this.setAttribute('aria-label', this.label);\n      } else if (changes.get('label') === this.getAttribute('aria-label')) {\n        this.removeAttribute('aria-label');\n      }\n    }\n\n    // Apply default accessible name fallback after handling explicit label changes.\n    if (changes.has('label') && !this.hasAccessibleName()) {\n      this.setAttribute('aria-label', ProgressCircleBase.DEFAULT_LABEL);\n      warnIf(\n        this,\n        true,\n        `<${this.localName}> requires an accessible name. A default label of \"${ProgressCircleBase.DEFAULT_LABEL}\" has been applied, but a more specific label should be provided via:`,\n        'https://spectrum-web-components.adobe.com/?path=/docs/components-progress-circle--docs',\n        {\n          type: 'accessibility',\n          issues: [\n            'value supplied to the \"label\" attribute, which will be displayed visually as part of the element, or',\n            'value supplied to the \"aria-label\" attribute, which will only be provided to screen readers, or',\n            'an element ID reference supplied to the \"aria-labelledby\" attribute, which will be provided by screen readers and will need to be managed manually by the parent application.',\n          ],\n        }\n      );\n    }\n\n    if (changes.has('staticColor') && this.staticColor !== undefined) {\n      const constructor = this.constructor as typeof ProgressCircleBase;\n      validateEnum(this, {\n        prop: 'static-color',\n        value: this.staticColor,\n        valid: constructor.STATIC_COLORS,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-progress-circle--docs',\n      });\n    }\n\n    // Guard the call site: `hasMeaningfulLightDomChildren` traverses the light\n    // DOM and the message is built eagerly as an argument, so both would run on\n    // every `updated()` (including production) if passed straight to `warnIf`.\n    // `isDebug()` skips that work entirely when validation is off.\n    if (isDebug()) {\n      this.warnDeprecatedLightDomChildren();\n    }\n  }\n}\n"],"mappings":";;;;;;;;OAsCsB,IAAtB,MAAsB,UAA2B,EAAW,GAAiB,EAC3E,YAAY,GACb,CAAC,CAAC;;4BAsDc,oBAakB,8BAEN,IAAI,EAA6B,KAAK;;CAajE,OAAe,8BAA8B,GAA4B;AACvE,OAAK,IAAM,KAAQ,EAAK,YAAY;;AAClC,OACE,EAAK,aAAa,KAAK,gBACtB,EAAK,aAAa,KAAK,cAAA,IAAa,EAAK,gBAAA,QAAA,EAAa,MAAM,CAE7D,QAAO;;AAGX,SAAO;;CAGT,oBAAqC;AACnC,SAAO,GACL,KAAK,SACL,KAAK,aAAa,aAAa,IAC/B,KAAK,aAAa,kBAAkB;;CAIxC,OAAe,cAAc,GAAuB;AAIlD,SAHK,OAAO,SAAS,EAAM,GAGpB,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,EAAM,CAAC,GAF/B;;CAKX,iBAAiC;;AAC/B,SAAO,IAAI,KAAK,aAAa,KAAK,iBAAiB,UAAU;GAC3D,OAAO;GACP,aAAa;GACd,CAAC,CAAC,SAAA,IAAQ,KAAK,aAAA,OAAY,IAAZ,KAAiB,IAAI;;CAGvC,iCAA+C;AAC7C,IACE,MACA,EAAmB,8BAA8B,KAAK,EACtD,IAAI,KAAK,UAAU,+MACnB,0FACA,EAAE,OAAO,eAAe,CACzB;;CAGH,WAA8B,GAA+B;AAC3D,MAAI,EAAQ,IAAI,WAAW,IAAI,KAAK,aAAa,MAAM;GACrD,IAAM,IAAU,EAAmB,cAAc,KAAK,SAAS;AAC/D,GAAI,MAAY,KAAK,aACnB,KAAK,WAAW;;AAIpB,QAAM,WAAW,EAAQ;;CAG3B,aAAgC,GAA+B;AAE7D,EADA,MAAM,aAAa,EAAQ,EAC3B,KAAK,aAAa,QAAQ,cAAc;;CAG1C,QAA2B,GAA+B;AAgDxD,MA/CA,MAAM,QAAQ,EAAQ,EAElB,EAAQ,IAAI,WAAW,KACrB,KAAK,aAAa,QAAQ,KAAK,YAAY,KAC7C,KAAK,aAAa,iBAAiB,IAAI,EACvC,KAAK,aAAa,iBAAiB,MAAM,EACzC,KAAK,aAAa,iBAAiB,OAAO,KAAK,SAAS,CAAC,EACzD,KAAK,aAAa,kBAAkB,KAAK,gBAAgB,CAAC,KAE1D,KAAK,gBAAgB,gBAAgB,EACrC,KAAK,gBAAgB,gBAAgB,EACrC,KAAK,gBAAgB,gBAAgB,EACrC,KAAK,gBAAgB,iBAAiB,IAItC,KAAK,aAAa,QAAQ,EAAQ,IAAI,EAA8B,IACtE,KAAK,aAAa,kBAAkB,KAAK,gBAAgB,CAAC,EAGxD,EAAQ,IAAI,QAAQ,KAClB,KAAK,MAAM,SACb,KAAK,aAAa,cAAc,KAAK,MAAM,GAClC,EAAQ,IAAI,QAAQ,KAAK,KAAK,aAAa,aAAa,IACjE,KAAK,gBAAgB,aAAa,GAKlC,EAAQ,IAAI,QAAQ,IAAI,CAAC,KAAK,mBAAmB,KACnD,KAAK,aAAa,cAAc,EAAmB,cAAc,EACjE,EACE,MACA,IACA,IAAI,KAAK,UAAU,qDAAqD,EAAmB,cAAc,wEACzG,0FACA;GACE,MAAM;GACN,QAAQ;IACN;IACA;IACA;IACD;GACF,CACF,GAGC,EAAQ,IAAI,cAAc,IAAI,KAAK,gBAAgB,KAAA,GAAW;GAChE,IAAM,IAAc,KAAK;AACzB,KAAa,MAAM;IACjB,MAAM;IACN,OAAO,KAAK;IACZ,OAAO,EAAY;IACnB,KAAK;IACN,CAAC;;AAOJ,EAAI,GAAS,IACX,KAAK,gCAAgC;;;yBA9HD,cA3CvC,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,WAAW;CAAgB,CAAC,CAAA,EAAA,EAAA,WAAA,eAAA,KAAA,EAAA,KAiBpE,EAAS,EAAE,MAAM,QAAQ,CAAC,CAAA,EAAA,EAAA,WAAA,SAAA,KAAA,EAAA,KAa1B,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA"}

package/dist/components/progress-circle/ProgressCircle.types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+export declare const PROGRESS_CIRCLE_VALID_SIZES: readonly ["s", "m", "l"];
+export declare const PROGRESS_CIRCLE_STATIC_COLORS: readonly ["white", "black"];
+export type ProgressCircleStaticColor = (typeof PROGRESS_CIRCLE_STATIC_COLORS)[number];
+export type ProgressCircleSize = (typeof PROGRESS_CIRCLE_VALID_SIZES)[number];

package/dist/components/progress-circle/ProgressCircle.types.js

@@ -0,0 +1,10 @@
+//#region components/progress-circle/ProgressCircle.types.ts
+var e = [
+	"s",
+	"m",
+	"l"
+], t = ["white", "black"];
+//#endregion
+export { t as PROGRESS_CIRCLE_STATIC_COLORS, e as PROGRESS_CIRCLE_VALID_SIZES };
+
+//# sourceMappingURL=ProgressCircle.types.js.map

package/dist/components/progress-circle/ProgressCircle.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressCircle.types.js","names":[],"sources":["../../../components/progress-circle/ProgressCircle.types.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport type { ElementSize } from '@adobe/spectrum-wc-core/mixins/index.js';\n\nexport const PROGRESS_CIRCLE_VALID_SIZES = [\n  's',\n  'm',\n  'l',\n] as const satisfies readonly ElementSize[];\nexport const PROGRESS_CIRCLE_STATIC_COLORS = ['white', 'black'] as const;\n\nexport type ProgressCircleStaticColor =\n  (typeof PROGRESS_CIRCLE_STATIC_COLORS)[number];\nexport type ProgressCircleSize = (typeof PROGRESS_CIRCLE_VALID_SIZES)[number];\n"],"mappings":";AAcA,IAAa,IAA8B;CACzC;CACA;CACA;CACD,EACY,IAAgC,CAAC,SAAS,QAAQ"}

package/dist/components/progress-circle/index.d.ts

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

package/dist/components/progress-circle/index.js

@@ -0,0 +1,3 @@
+import { PROGRESS_CIRCLE_STATIC_COLORS as e, PROGRESS_CIRCLE_VALID_SIZES as t } from "./ProgressCircle.types.js";
+import { ProgressCircleBase as n } from "./ProgressCircle.base.js";
+export { e as PROGRESS_CIRCLE_STATIC_COLORS, t as PROGRESS_CIRCLE_VALID_SIZES, n as ProgressCircleBase };

package/dist/components/status-light/StatusLight.base.d.ts

@@ -0,0 +1,69 @@
+import { PropertyValues } from 'lit';
+import { SpectrumElement } from '../../element/index.js';
+import { StatusLightSize, StatusLightVariant } from './StatusLight.types.js';
+declare const StatusLightBase_base: typeof SpectrumElement & {
+    new (...args: any[]): import('../../mixins/index.js').SizedElementInterface;
+    prototype: import('../../mixins/index.js').SizedElementInterface;
+} & import('../../mixins/index.js').SizedElementConstructor;
+/**
+ * A status light is a great way to convey semantic meaning and the condition of an entity, such as statuses and categories. It provides visual indicators through colored dots accompanied by descriptive text.
+ *
+ * @slot - The text label of the status light.
+ * @attribute {ElementSize} size - The size of the status light.
+ */
+export declare abstract class StatusLightBase extends StatusLightBase_base {
+    /**
+     * The size of the status light.
+     */
+    size: StatusLightSize;
+    /**
+     * @internal
+     *
+     * A readonly array of the valid color variants for the status light.
+     *
+     * This is an actual internal property, intended not for customer use
+     * but for use in internal validation logic, stories, tests, etc.
+     *
+     * Because S1 and S2 support different color variants, the value of this
+     * property must be set in each subclass.
+     */
+    static readonly VARIANTS_COLOR: readonly string[];
+    /**
+     * @internal
+     *
+     * A readonly array of the valid semantic variants for the status light.
+     *
+     * This is an actual internal property, intended not for customer use
+     * but for use in internal validation logic, stories, tests, etc.
+     *
+     * Because S1 and S2 support different semantic variants, the value of this
+     * property must be set in each subclass.
+     */
+    static readonly VARIANTS_SEMANTIC: readonly string[];
+    /**
+     * @internal
+     *
+     * A readonly array of all valid variants for the status light.
+     *
+     * This is an actual internal property, intended not for customer use
+     * but for use in internal validation logic, stories, tests, etc.
+     *
+     * Because S1 and S2 support different variants, the value of this
+     * property must be set in each subclass.
+     */
+    static readonly VARIANTS: readonly string[];
+    /**
+     * @internal
+     *
+     * The variant of the status light.
+     *
+     * This is a public property, but its valid values vary between S1 and S2,
+     * so the property (and its docs) need to be redefined in each subclass.
+     *
+     * The type declared here is a union of the valid values for S1 and S2,
+     * and should be narrowed in each subclass.
+     */
+    variant: StatusLightVariant;
+    protected update(changes: PropertyValues): void;
+}
+export {};

package/dist/components/status-light/StatusLight.base.js

@@ -0,0 +1,32 @@
+import { __decorate as e } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/decorate.js";
+import { STATUS_LIGHT_VALID_SIZES as t } from "./StatusLight.types.js";
+import { property as n } from "lit/decorators.js";
+import { SpectrumElement as r } from "@adobe/spectrum-wc-core/element/index.js";
+import { SizedMixin as i } from "@adobe/spectrum-wc-core/mixins/index.js";
+import { validateEnum as a, warnIf as o } from "@adobe/spectrum-wc-core/utils/index.js";
+//#region components/status-light/StatusLight.base.ts
+var s = class extends i(r, {
+	validSizes: t,
+	noDefaultSize: !0
+}) {
+	constructor(...e) {
+		super(...e), this.variant = "neutral";
+	}
+	update(e) {
+		let t = this.constructor;
+		this.variant === "accent" ? o(this, !0, `<${this.localName}> does not support the "accent" variant in Spectrum 2. Use "neutral" or "info" depending on intent.`, "https://spectrum-web-components.adobe.com/?path=/docs/status-light-migration-guide--docs", { level: "deprecation" }) : a(this, {
+			prop: "variant",
+			value: this.variant,
+			valid: t.VARIANTS,
+			url: "https://spectrum-web-components.adobe.com/?path=/docs/components-status-light--docs"
+		}), o(this, this.hasAttribute("disabled"), `<${this.localName}> does not support the "disabled" attribute. It was deprecated in Spectrum 1 and has been removed in Spectrum 2.`, "https://spectrum-web-components.adobe.com/?path=/docs/status-light-migration-guide--docs", { level: "deprecation" }), super.update(e);
+	}
+};
+e([n({
+	type: String,
+	reflect: !0
+})], s.prototype, "variant", void 0);
+//#endregion
+export { s as StatusLightBase };
+
+//# sourceMappingURL=StatusLight.base.js.map

package/dist/components/status-light/StatusLight.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusLight.base.js","names":[],"sources":["../../../components/status-light/StatusLight.base.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { SpectrumElement } from '@adobe/spectrum-wc-core/element/index.js';\nimport { SizedMixin } from '@adobe/spectrum-wc-core/mixins/index.js';\nimport { validateEnum, warnIf } from '@adobe/spectrum-wc-core/utils/index.js';\n\nimport {\n  STATUS_LIGHT_VALID_SIZES,\n  type StatusLightSize,\n  type StatusLightVariant,\n} from './StatusLight.types.js';\n\n/**\n * A status light is a great way to convey semantic meaning and the condition of an entity, such as statuses and categories. It provides visual indicators through colored dots accompanied by descriptive text.\n *\n * @slot - The text label of the status light.\n * @attribute {ElementSize} size - The size of the status light.\n */\nexport abstract class StatusLightBase extends SizedMixin(SpectrumElement, {\n  validSizes: STATUS_LIGHT_VALID_SIZES,\n  noDefaultSize: true,\n}) {\n  /**\n   * The size of the status light.\n   */\n  declare public size: StatusLightSize;\n\n  // ─────────────────────────\n  //     API TO OVERRIDE\n  // ─────────────────────────\n\n  /**\n   * @internal\n   *\n   * A readonly array of the valid color variants for the status light.\n   *\n   * This is an actual internal property, intended not for customer use\n   * but for use in internal validation logic, stories, tests, etc.\n   *\n   * Because S1 and S2 support different color variants, the value of this\n   * property must be set in each subclass.\n   */\n  static readonly VARIANTS_COLOR: readonly string[];\n\n  /**\n   * @internal\n   *\n   * A readonly array of the valid semantic variants for the status light.\n   *\n   * This is an actual internal property, intended not for customer use\n   * but for use in internal validation logic, stories, tests, etc.\n   *\n   * Because S1 and S2 support different semantic variants, the value of this\n   * property must be set in each subclass.\n   */\n  static readonly VARIANTS_SEMANTIC: readonly string[];\n\n  /**\n   * @internal\n   *\n   * A readonly array of all valid variants for the status light.\n   *\n   * This is an actual internal property, intended not for customer use\n   * but for use in internal validation logic, stories, tests, etc.\n   *\n   * Because S1 and S2 support different variants, the value of this\n   * property must be set in each subclass.\n   */\n  static readonly VARIANTS: readonly string[];\n\n  /**\n   * @internal\n   *\n   * The variant of the status light.\n   *\n   * This is a public property, but its valid values vary between S1 and S2,\n   * so the property (and its docs) need to be redefined in each subclass.\n   *\n   * The type declared here is a union of the valid values for S1 and S2,\n   * and should be narrowed in each subclass.\n   */\n  @property({ type: String, reflect: true })\n  public variant: StatusLightVariant = 'neutral';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override update(changes: PropertyValues): void {\n    const constructor = this.constructor as typeof StatusLightBase;\n    // @ts-expect-error -- intentional runtime guard: 1st-gen consumers may pass 'accent'\n    if (this.variant === 'accent') {\n      warnIf(\n        this,\n        true,\n        `<${this.localName}> does not support the \"accent\" variant in Spectrum 2. Use \"neutral\" or \"info\" depending on intent.`,\n        'https://spectrum-web-components.adobe.com/?path=/docs/status-light-migration-guide--docs',\n        { level: 'deprecation' }\n      );\n    } else {\n      validateEnum(this, {\n        prop: 'variant',\n        value: this.variant,\n        valid: constructor.VARIANTS,\n        url: 'https://spectrum-web-components.adobe.com/?path=/docs/components-status-light--docs',\n      });\n    }\n    warnIf(\n      this,\n      this.hasAttribute('disabled'),\n      `<${this.localName}> does not support the \"disabled\" attribute. It was deprecated in Spectrum 1 and has been removed in Spectrum 2.`,\n      'https://spectrum-web-components.adobe.com/?path=/docs/status-light-migration-guide--docs',\n      { level: 'deprecation' }\n    );\n\n    super.update(changes);\n  }\n}\n"],"mappings":";;;;;;;AA8BA,IAAsB,IAAtB,cAA8C,EAAW,GAAiB;CACxE,YAAY;CACZ,eAAe;CAChB,CAAC,CAAC;;8BA6DoC;;CAMrC,OAA0B,GAA+B;EACvD,IAAM,IAAc,KAAK;AA0BzB,EAxBI,KAAK,YAAY,WACnB,EACE,MACA,IACA,IAAI,KAAK,UAAU,sGACnB,4FACA,EAAE,OAAO,eAAe,CACzB,GAED,EAAa,MAAM;GACjB,MAAM;GACN,OAAO,KAAK;GACZ,OAAO,EAAY;GACnB,KAAK;GACN,CAAC,EAEJ,EACE,MACA,KAAK,aAAa,WAAW,EAC7B,IAAI,KAAK,UAAU,mHACnB,4FACA,EAAE,OAAO,eAAe,CACzB,EAED,MAAM,OAAO,EAAQ;;;GAlCtB,EAAS;CAAE,MAAM;CAAQ,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,WAAA,KAAA,EAAA"}

package/dist/components/status-light/StatusLight.types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+export declare const STATUS_LIGHT_VALID_SIZES: readonly ["s", "m", "l", "xl"];
+export declare const STATUS_LIGHT_VARIANTS_SEMANTIC: readonly ["neutral", "info", "positive", "negative", "notice"];
+export declare const STATUS_LIGHT_VARIANTS_COLOR: readonly ["fuchsia", "indigo", "magenta", "purple", "seafoam", "yellow", "chartreuse", "celery", "cyan", "pink", "turquoise", "brown", "cinnamon", "silver"];
+export declare const STATUS_LIGHT_VARIANTS: readonly ["neutral", "info", "positive", "negative", "notice", "fuchsia", "indigo", "magenta", "purple", "seafoam", "yellow", "chartreuse", "celery", "cyan", "pink", "turquoise", "brown", "cinnamon", "silver"];
+export type StatusLightSemanticVariant = (typeof STATUS_LIGHT_VARIANTS_SEMANTIC)[number];
+export type StatusLightColorVariant = (typeof STATUS_LIGHT_VARIANTS_COLOR)[number];
+export type StatusLightVariant = (typeof STATUS_LIGHT_VARIANTS)[number];
+export type StatusLightSize = (typeof STATUS_LIGHT_VALID_SIZES)[number];

package/dist/components/status-light/StatusLight.types.js

@@ -0,0 +1,32 @@
+//#region components/status-light/StatusLight.types.ts
+var e = [
+	"s",
+	"m",
+	"l",
+	"xl"
+], t = [
+	"neutral",
+	"info",
+	"positive",
+	"negative",
+	"notice"
+], n = [
+	"fuchsia",
+	"indigo",
+	"magenta",
+	"purple",
+	"seafoam",
+	"yellow",
+	"chartreuse",
+	"celery",
+	"cyan",
+	"pink",
+	"turquoise",
+	"brown",
+	"cinnamon",
+	"silver"
+], r = [...t, ...n];
+//#endregion
+export { e as STATUS_LIGHT_VALID_SIZES, r as STATUS_LIGHT_VARIANTS, n as STATUS_LIGHT_VARIANTS_COLOR, t as STATUS_LIGHT_VARIANTS_SEMANTIC };
+
+//# sourceMappingURL=StatusLight.types.js.map

package/dist/components/status-light/StatusLight.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusLight.types.js","names":[],"sources":["../../../components/status-light/StatusLight.types.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport type { ElementSize } from '@adobe/spectrum-wc-core/mixins/index.js';\n\nexport const STATUS_LIGHT_VALID_SIZES = [\n  's',\n  'm',\n  'l',\n  'xl',\n] as const satisfies readonly ElementSize[];\n\nexport const STATUS_LIGHT_VARIANTS_SEMANTIC = [\n  'neutral',\n  'info',\n  'positive',\n  'negative',\n  'notice',\n] as const;\n\nexport const STATUS_LIGHT_VARIANTS_COLOR = [\n  'fuchsia',\n  'indigo',\n  'magenta',\n  'purple',\n  'seafoam',\n  'yellow',\n  'chartreuse',\n  'celery',\n  'cyan',\n  'pink',\n  'turquoise',\n  'brown',\n  'cinnamon',\n  'silver',\n] as const;\n\nexport const STATUS_LIGHT_VARIANTS = [\n  ...STATUS_LIGHT_VARIANTS_SEMANTIC,\n  ...STATUS_LIGHT_VARIANTS_COLOR,\n] as const;\n\nexport type StatusLightSemanticVariant =\n  (typeof STATUS_LIGHT_VARIANTS_SEMANTIC)[number];\n\nexport type StatusLightColorVariant =\n  (typeof STATUS_LIGHT_VARIANTS_COLOR)[number];\n\nexport type StatusLightVariant = (typeof STATUS_LIGHT_VARIANTS)[number];\n\nexport type StatusLightSize = (typeof STATUS_LIGHT_VALID_SIZES)[number];\n"],"mappings":";AAcA,IAAa,IAA2B;CACtC;CACA;CACA;CACA;CACD,EAEY,IAAiC;CAC5C;CACA;CACA;CACA;CACA;CACD,EAEY,IAA8B;CACzC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,EAEY,IAAwB,CACnC,GAAG,GACH,GAAG,EACJ"}

package/dist/components/status-light/index.d.ts

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

package/dist/components/status-light/index.js

@@ -0,0 +1,3 @@
+import { STATUS_LIGHT_VALID_SIZES as e, STATUS_LIGHT_VARIANTS as t, STATUS_LIGHT_VARIANTS_COLOR as n, STATUS_LIGHT_VARIANTS_SEMANTIC as r } from "./StatusLight.types.js";
+import { StatusLightBase as i } from "./StatusLight.base.js";
+export { e as STATUS_LIGHT_VALID_SIZES, t as STATUS_LIGHT_VARIANTS, n as STATUS_LIGHT_VARIANTS_COLOR, r as STATUS_LIGHT_VARIANTS_SEMANTIC, i as StatusLightBase };

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

@@ -0,0 +1,49 @@
+import { PropertyValues } from 'lit';
+import { SpectrumElement } from '../../element/index.js';
+/**
+ * Base class for an individual tab within a tabbed interface.
+ *
+ * Manages the tab's selection state, disabled behavior, ARIA
+ * attributes, and roving tabindex. Concrete classes supply the
+ * stylesheet and render template.
+ *
+ * Disabled tabs use `aria-disabled="true"` and remain focusable via
+ * arrow keys per the ARIA Authoring Practices Guide, but are not
+ * activatable (Enter, Space, and click are guarded).
+ *
+ * @slot - Text label of the tab
+ * @slot icon - Optional icon displayed before the label
+ */
+export declare abstract class TabBase extends SpectrumElement {
+    /**
+     * Whether this tab is disabled. Disabled tabs are announced as
+     * unavailable by assistive technology and cannot be activated,
+     * but remain focusable via arrow keys within the tablist.
+     */
+    disabled: boolean;
+    /**
+     * Whether this tab is currently selected. Managed by the parent
+     * `swc-tabs` container — consumers should not set this directly.
+     * Use `swc-tabs[selected]` instead.
+     */
+    selected: boolean;
+    /**
+     * Whether the tab is displayed in vertical orientation.
+     *
+     * Orientation is primarily driven by the parent `swc-tabs` `direction`
+     * attribute; this property remains for styling and any consumers that read
+     * it explicitly. We can remove it in a future major once vertical layout is
+     * fully parent-driven only—track that cleanup in the component backlog if
+     * it becomes redundant in practice.
+     */
+    vertical: boolean;
+    /**
+     * Unique identifier for this tab. Used by the parent `swc-tabs`
+     * to match this tab to its corresponding `swc-tab-panel`.
+     */
+    tabId: string;
+    protected firstUpdated(changes: PropertyValues): void;
+    protected updated(changes: PropertyValues): void;
+    private syncAriaSelected;
+    private syncAriaDisabled;
+}

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

@@ -0,0 +1,39 @@
+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/Tab.base.ts
+var r = 0, i = class extends n {
+	constructor(...e) {
+		super(...e), this.disabled = !1, this.selected = !1, this.vertical = !1, this.tabId = "";
+	}
+	firstUpdated(e) {
+		super.firstUpdated(e), this.setAttribute("role", "tab"), this.hasAttribute("id") || (this.id = `swc-tab-${r++}`), this.syncAriaSelected(), this.syncAriaDisabled(), this.hasAttribute("tabindex") || (this.tabIndex = -1);
+	}
+	updated(e) {
+		super.updated(e), e.has("selected") && this.syncAriaSelected(), e.has("disabled") && this.syncAriaDisabled();
+	}
+	syncAriaSelected() {
+		this.setAttribute("aria-selected", String(this.selected));
+	}
+	syncAriaDisabled() {
+		this.disabled ? this.setAttribute("aria-disabled", "true") : this.removeAttribute("aria-disabled");
+	}
+};
+e([t({
+	type: Boolean,
+	reflect: !0
+})], i.prototype, "disabled", void 0), e([t({
+	type: Boolean,
+	reflect: !0
+})], i.prototype, "selected", void 0), e([t({
+	type: Boolean,
+	reflect: !0
+})], i.prototype, "vertical", void 0), e([t({
+	type: String,
+	reflect: !0,
+	attribute: "tab-id"
+})], i.prototype, "tabId", void 0);
+//#endregion
+export { i as TabBase };
+
+//# sourceMappingURL=Tab.base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tab.base.js","names":[],"sources":["../../../components/tabs/Tab.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 tabIdCounter = 0;\n\n/**\n * Base class for an individual tab within a tabbed interface.\n *\n * Manages the tab's selection state, disabled behavior, ARIA\n * attributes, and roving tabindex. Concrete classes supply the\n * stylesheet and render template.\n *\n * Disabled tabs use `aria-disabled=\"true\"` and remain focusable via\n * arrow keys per the ARIA Authoring Practices Guide, but are not\n * activatable (Enter, Space, and click are guarded).\n *\n * @slot - Text label of the tab\n * @slot icon - Optional icon displayed before the label\n */\nexport abstract class TabBase extends SpectrumElement {\n  // ──────────────────\n  //     SHARED API\n  // ──────────────────\n\n  /**\n   * Whether this tab is disabled. Disabled tabs are announced as\n   * unavailable by assistive technology and cannot be activated,\n   * but remain focusable via arrow keys within the tablist.\n   */\n  @property({ type: Boolean, reflect: true })\n  public disabled = false;\n\n  /**\n   * Whether this tab is currently selected. Managed by the parent\n   * `swc-tabs` container — consumers should not set this directly.\n   * Use `swc-tabs[selected]` instead.\n   */\n  @property({ type: Boolean, reflect: true })\n  public selected = false;\n\n  /**\n   * Whether the tab is displayed in vertical orientation.\n   *\n   * Orientation is primarily driven by the parent `swc-tabs` `direction`\n   * attribute; this property remains for styling and any consumers that read\n   * it explicitly. We can remove it in a future major once vertical layout is\n   * fully parent-driven only—track that cleanup in the component backlog if\n   * it becomes redundant in practice.\n   */\n  @property({ type: Boolean, reflect: true })\n  public vertical = false;\n\n  /**\n   * Unique identifier for this tab. Used by the parent `swc-tabs`\n   * to match this tab to its corresponding `swc-tab-panel`.\n   */\n  @property({ type: String, reflect: true, attribute: 'tab-id' })\n  public tabId = '';\n\n  // ──────────────────────\n  //     IMPLEMENTATION\n  // ──────────────────────\n\n  protected override firstUpdated(changes: PropertyValues): void {\n    super.firstUpdated(changes);\n\n    this.setAttribute('role', 'tab');\n\n    if (!this.hasAttribute('id')) {\n      this.id = `swc-tab-${tabIdCounter++}`;\n    }\n\n    this.syncAriaSelected();\n    this.syncAriaDisabled();\n\n    // Initial tabindex: -1 by default. The parent TabsBase\n    // manages roving tabindex via setRovingTabindex() /\n    // updateCheckedState() to ensure exactly one tab has\n    // tabindex=\"0\" at all times.\n    if (!this.hasAttribute('tabindex')) {\n      this.tabIndex = -1;\n    }\n  }\n\n  protected override updated(changes: PropertyValues): void {\n    super.updated(changes);\n\n    if (changes.has('selected')) {\n      this.syncAriaSelected();\n    }\n\n    if (changes.has('disabled')) {\n      this.syncAriaDisabled();\n    }\n  }\n\n  private syncAriaSelected(): void {\n    this.setAttribute('aria-selected', String(this.selected));\n  }\n\n  private syncAriaDisabled(): void {\n    if (this.disabled) {\n      this.setAttribute('aria-disabled', 'true');\n    } else {\n      this.removeAttribute('aria-disabled');\n    }\n  }\n}\n"],"mappings":";;;;AAgBA,IAAI,IAAe,GAgBG,IAAtB,cAAsC,EAAgB;;+BAWlC,oBAQA,oBAYA,iBAOH;;CAMf,aAAgC,GAA+B;AAgB7D,EAfA,MAAM,aAAa,EAAQ,EAE3B,KAAK,aAAa,QAAQ,MAAM,EAE3B,KAAK,aAAa,KAAK,KAC1B,KAAK,KAAK,WAAW,QAGvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAMlB,KAAK,aAAa,WAAW,KAChC,KAAK,WAAW;;CAIpB,QAA2B,GAA+B;AAOxD,EANA,MAAM,QAAQ,EAAQ,EAElB,EAAQ,IAAI,WAAW,IACzB,KAAK,kBAAkB,EAGrB,EAAQ,IAAI,WAAW,IACzB,KAAK,kBAAkB;;CAI3B,mBAAiC;AAC/B,OAAK,aAAa,iBAAiB,OAAO,KAAK,SAAS,CAAC;;CAG3D,mBAAiC;AAC/B,EAAI,KAAK,WACP,KAAK,aAAa,iBAAiB,OAAO,GAE1C,KAAK,gBAAgB,gBAAgB;;;GA3ExC,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAQ1C,EAAS;CAAE,MAAM;CAAS,SAAS;CAAM,CAAC,CAAA,EAAA,EAAA,WAAA,YAAA,KAAA,EAAA,KAY1C,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/Tab.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-specific type definitions (e.g., icon placement,
+ * badge configuration). The file is scaffolded now so imports are stable
+ * when implementation work begins.
+ */
+export {};

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

@@ -0,0 +1,49 @@
+import { PropertyValues } from 'lit';
+import { SpectrumElement } from '../../element/index.js';
+/**
+ * Base class for a tab panel that displays content associated with
+ * a tab.
+ *
+ * Manages visibility, ARIA hidden state, tabindex, and the
+ * focus-in/out behavior that prevents Tab-key trapping inside panel
+ * content.
+ *
+ * In 1st-gen, `slot="tab-panel"` was
+ * assigned programmatically in `firstUpdated` so consumers never
+ * wrote it in markup. This behavior is preserved in gen2.
+ *
+ * The panel removes its own
+ * `tabindex` on `focusin` so that Tab presses inside the panel
+ * move to the next interactive element rather than being trapped.
+ * On `focusout`, `tabindex` is restored so the panel remains
+ * focusable from the tablist.
+ *
+ * @slot - Content displayed when the associated tab is selected
+ */
+export declare abstract class TabPanelBase extends SpectrumElement {
+    /**
+     * Whether this panel is currently visible (its associated tab is
+     * selected). Managed by the parent `swc-tabs` — consumers should
+     * not set this directly.
+     */
+    selected: boolean;
+    /**
+     * Unique identifier linking this panel to its corresponding tab.
+     * Must match the `tab-id` attribute on the associated `swc-tab`.
+     */
+    tabId: string;
+    /**
+     * Removes the panel's `tabindex` while focus is inside the panel
+     * so that Tab presses navigate to the next interactive element
+     * rather than the panel container itself.
+     */
+    protected handleFocusin(): void;
+    /**
+     * Restores `tabindex` when focus leaves the panel so the panel
+     * remains directly focusable from the tablist via Tab key.
+     */
+    protected handleFocusout(): void;
+    protected firstUpdated(_changes: PropertyValues): void;
+    protected updated(changes: PropertyValues): void;
+    private syncVisibility;
+}