From dc2b27fc5d1941c01b18af39c279e89a8dcfdf23 Mon Sep 17 00:00:00 2001 From: Rajdeep Chandra Date: Mon, 25 May 2026 16:39:42 +0530 Subject: [PATCH] docs(changelog): reformat 2nd-gen CHANGELOGs to match strategy Apply the agreed changelog format to existing entries: consumer-facing descriptions, component docs and migration guide links, no author attributions, and deduplicated core entries. Co-authored-by: Cursor --- 2nd-gen/packages/core/CHANGELOG.md | 105 ++++------------------------- 2nd-gen/packages/swc/CHANGELOG.md | 75 ++++++--------------- 2 files changed, 36 insertions(+), 144 deletions(-) diff --git a/2nd-gen/packages/core/CHANGELOG.md b/2nd-gen/packages/core/CHANGELOG.md index bc052991e0..6393c97cae 100644 --- a/2nd-gen/packages/core/CHANGELOG.md +++ b/2nd-gen/packages/core/CHANGELOG.md @@ -1,117 +1,40 @@ -## 0.1.0 - -### Minor Changes - -- [#6067](https://github.com/adobe/spectrum-web-components/pull/6067) [`ba14a2b`](https://github.com/adobe/spectrum-web-components/commit/ba14a2b6361a0089a9a8c72232f245cde0716d89) Thanks [@caseyisonit](https://github.com/caseyisonit)! - Refactored size mixin exports and badge type naming for consistency. - - **@spectrum-web-components/base (1st-gen)** - - **Added**: New exports `ELEMENT_SIZES` and `DEFAULT_ELEMENT_SIZES` for typed size arrays - - **Deprecated**: `ElementSizes` record is now deprecated in favor of `ELEMENT_SIZES`. The export is preserved for backward compatibility but will be removed in a future major release. - - **@spectrum-web-components/core (2nd-gen)** - - **Changed**: Replaced `ElementSizes` record with `ELEMENT_SIZES` const array and `DEFAULT_ELEMENT_SIZES` - - **Changed**: `VALID_SIZES` arrays are now typed as `readonly ElementSize[]` for better type safety - - **Changed**: Badge type exports renamed for consistency: - - `BADGE_VARIANTS_S2` → `BADGE_VARIANTS` - - `BADGE_VARIANTS_COLOR_S2` → `BADGE_VARIANTS_COLOR` - - `BadgeVariantS2` → `BadgeVariant` - - `BadgeColorVariantS2` → `BadgeColorVariant` - -- [#6122](https://github.com/adobe/spectrum-web-components/pull/6122) [`7b153b5`](https://github.com/adobe/spectrum-web-components/commit/7b153b5433a8f6d47850f8939b058f7bc431c48c) Thanks [@rise-erpelding](https://github.com/rise-erpelding)! - **Breaking**: `` migration includes new `subtle`/`outline` styles, additional non-semantic color variants, and default behavior updates (`variant="neutral"` and reflected `size="s"` when omitted). `--mod-badge-*` hooks are removed, and `--swc-badge-*` hooks are **not** a strict 1:1 replacement surface for every previous override. See the badge consumer migration guide. - - **Breaking**: `` migration reflects `size="m"` when omitted (visual medium behavior remains unchanged). `--mod-divider-*` hooks are removed, and the new public styling surface (`--swc-divider-thickness`, `--swc-divider-background-color`) is **not** a strict 1:1 replacement for prior size/static-color-specific overrides. See the divider consumer migration guide. - - **Breaking**: `` migration removes the `indeterminate` attribute (omit `progress` or set `progress = null` instead), no longer renders light DOM children as labels (use `label`/`aria-label`), and adds `static-color="black"` support. `--mod-progress-circle-*` hooks are removed, and `--swc-progress-circle-*` hooks are **not** a strict 1:1 replacement for all prior behavior. See the progress circle consumer migration guide. +# @spectrum-web-components/core - **Breaking**: `` migration removes the deprecated `disabled` attribute, removes the `accent` variant, and updates default behavior (`variant="neutral"` when omitted). `--mod-status-light-*` hooks are removed, and `--swc-status-light-*` hooks are **not** a strict 1:1 replacement for every previous override pattern. `StatusLightSize` is exported from core for typed usage. See the status light consumer migration guide. - -- [#6183](https://github.com/adobe/spectrum-web-components/pull/6183) [`8aa488e`](https://github.com/adobe/spectrum-web-components/commit/8aa488e3867725b1ed93b2b5c31cba686f116688) Thanks [@Rajdeepc](https://github.com/Rajdeepc)! - **feat(tabs):** Add 2nd-gen tabs (`swc-tabs`, `swc-tab`, `swc-tab-panel`) with Spectrum 2 styling, selection indicator, and WAI-ARIA tabs keyboard behavior. A single side-effect import `@adobe/spectrum-wc/components/tabs/swc-tabs.js` registers all three elements. See `components/tabs/migration.md` for migration from 1st-gen `sp-tabs`. - -### Patch Changes - -- [#5936](https://github.com/adobe/spectrum-web-components/pull/5936) [`f37dec6`](https://github.com/adobe/spectrum-web-components/commit/f37dec6ae39fd89a4c12e084b4a0f4d9092d79b0) Thanks [@rubencarvalho](https://github.com/rubencarvalho)! - **Refactored**: Overhauled text direction management across the component library. Previously, `SpectrumElement` and `sp-theme` actively managed `dir` by traversing the DOM on connect, setting `dir` attributes on every component, and observing changes via `MutationObserver`. This has been replaced with a passive approach that relies on the native CSS `:dir()` pseudo-class and `getComputedStyle(this).direction` for JavaScript access, letting the browser's built-in direction inheritance do the work. Removed redundant `dir` property overrides from individual components, replaced `[dir]` attribute selectors with `:dir()` in stylesheets, and converted physical CSS properties to logical equivalents where applicable. - -# [0.1.0](https://github.com/adobe/spectrum-web-components/compare/@spectrum-web-components/core@0.0.4...@spectrum-web-components/core@0.1.0) (2026-05-12) +## 0.1.0 ### Minor Changes -Refactored size mixin exports and badge type naming for consistency. - -**@spectrum-web-components/base (1st-gen)** - -- **Added**: New exports `ELEMENT_SIZES` and `DEFAULT_ELEMENT_SIZES` for typed size arrays -- **Deprecated**: `ElementSizes` record is now deprecated in favor of `ELEMENT_SIZES`. The export is preserved for backward compatibility but will be removed in a future major release. - -**@spectrum-web-components/core (2nd-gen)** +- [#6067](https://github.com/adobe/spectrum-web-components/pull/6067) [`ba14a2b`](https://github.com/adobe/spectrum-web-components/commit/ba14a2b6361a0089a9a8c72232f245cde0716d89) - `Core` — Refactored size mixin exports and badge type naming for consistency. Replaced `ElementSizes` record with `ELEMENT_SIZES` const array and `DEFAULT_ELEMENT_SIZES`; `VALID_SIZES` typed as `readonly ElementSize[]`. Badge exports renamed: `BADGE_VARIANTS_S2` → `BADGE_VARIANTS`, `BadgeVariantS2` → `BadgeVariant`, `BadgeColorVariantS2` → `BadgeColorVariant`. -- **Changed**: Replaced `ElementSizes` record with `ELEMENT_SIZES` const array and `DEFAULT_ELEMENT_SIZES` -- **Changed**: `VALID_SIZES` arrays are now typed as `readonly ElementSize[]` for better type safety -- **Changed**: Badge type exports renamed for consistency: - - `BADGE_VARIANTS_S2` → `BADGE_VARIANTS` - - `BADGE_VARIANTS_COLOR_S2` → `BADGE_VARIANTS_COLOR` - - `BadgeVariantS2` → `BadgeVariant` - - `BadgeColorVariantS2` → `BadgeColorVariant` +- [#6122](https://github.com/adobe/spectrum-web-components/pull/6122) [`7b153b5`](https://github.com/adobe/spectrum-web-components/commit/7b153b5433a8f6d47850f8939b058f7bc431c48c) - `Badge` — Migrated to 2nd-gen with `subtle`/`outline` styles, additional color variants, and updated defaults. See the [component docs](https://spectrum-web-components.adobe.com/?path=/docs/components-badge--docs) and [migration guide](https://spectrum-web-components.adobe.com/?path=/docs/components-badge-migration-guide--docs). + `Divider` — Migrated to 2nd-gen. See the [component docs](https://spectrum-web-components.adobe.com/?path=/docs/components-divider--docs) and [migration guide](https://spectrum-web-components.adobe.com/?path=/docs/components-divider-migration-guide--docs). + `Progress Circle` — Migrated to 2nd-gen; removed `indeterminate` attribute. See the [component docs](https://spectrum-web-components.adobe.com/?path=/docs/components-progress-circle--docs) and [migration guide](https://spectrum-web-components.adobe.com/?path=/docs/components-progress-circle-migration-guide--docs). + `Status Light` — Migrated to 2nd-gen; removed `disabled` attribute and `accent` variant. See the [component docs](https://spectrum-web-components.adobe.com/?path=/docs/components-status-light--docs) and [migration guide](https://spectrum-web-components.adobe.com/?path=/docs/components-status-light-migration-guide--docs). -**Breaking**: `` migration includes new `subtle`/`outline` styles, additional non-semantic color variants, and default behavior updates (`variant="neutral"` and reflected `size="s"` when omitted). `--mod-badge-*` hooks are removed, and `--swc-badge-*` hooks are **not** a strict 1:1 replacement surface for every previous override. See the badge consumer migration guide. - -**Breaking**: `` migration reflects `size="m"` when omitted (visual medium behavior remains unchanged). `--mod-divider-*` hooks are removed, and the new public styling surface (`--swc-divider-thickness`, `--swc-divider-background-color`) is **not** a strict 1:1 replacement for prior size/static-color-specific overrides. See the divider consumer migration guide. - -**Breaking**: `` migration removes the `indeterminate` attribute (omit `progress` or set `progress = null` instead), no longer renders light DOM children as labels (use `label`/`aria-label`), and adds `static-color="black"` support. `--mod-progress-circle-*` hooks are removed, and `--swc-progress-circle-*` hooks are **not** a strict 1:1 replacement for all prior behavior. See the progress circle consumer migration guide. - -**Breaking**: `` migration removes the deprecated `disabled` attribute, removes the `accent` variant, and updates default behavior (`variant="neutral"` when omitted). `--mod-status-light-*` hooks are removed, and `--swc-status-light-*` hooks are **not** a strict 1:1 replacement for every previous override pattern. `StatusLightSize` is exported from core for typed usage. See the status light consumer migration guide. - -**feat(tabs):** Add 2nd-gen tabs (`swc-tabs`, `swc-tab`, `swc-tab-panel`) with Spectrum 2 styling, selection indicator, and WAI-ARIA tabs keyboard behavior. A single side-effect import `@adobe/spectrum-wc/components/tabs/swc-tabs.js` registers all three elements. See `components/tabs/migration.md` for migration from 1st-gen `sp-tabs`. +- [#6183](https://github.com/adobe/spectrum-web-components/pull/6183) [`8aa488e`](https://github.com/adobe/spectrum-web-components/commit/8aa488e3867725b1ed93b2b5c31cba686f116688) - `Tabs` — Added 2nd-gen tabs (`swc-tabs`, `swc-tab`, `swc-tab-panel`) with Spectrum 2 styling, selection indicator, and keyboard navigation. See the [component docs](https://spectrum-web-components.adobe.com/?path=/docs/components-tabs--docs) and [migration guide](https://spectrum-web-components.adobe.com/?path=/docs/components-tabs-migration-guide--docs). ### Patch Changes -**Refactored**: Overhauled text direction management across the component library. Previously, `SpectrumElement` and `sp-theme` actively managed `dir` by traversing the DOM on connect, setting `dir` attributes on every component, and observing changes via `MutationObserver`. This has been replaced with a passive approach that relies on the native CSS `:dir()` pseudo-class and `getComputedStyle(this).direction` for JavaScript access, letting the browser's built-in direction inheritance do the work. Removed redundant `dir` property overrides from individual components, replaced `[dir]` attribute selectors with `:dir()` in stylesheets, and converted physical CSS properties to logical equivalents where applicable. +- [#5936](https://github.com/adobe/spectrum-web-components/pull/5936) [`f37dec6`](https://github.com/adobe/spectrum-web-components/commit/f37dec6ae39fd89a4c12e084b4a0f4d9092d79b0) - `Core` — Overhauled text direction management. Replaced active `dir` attribute management with passive CSS `:dir()` pseudo-class and `getComputedStyle(this).direction`; removed `MutationObserver`-based direction tracking and converted physical CSS properties to logical equivalents. ## 0.0.4 ### Patch Changes -- [#5998](https://github.com/adobe/spectrum-web-components/pull/5998) [`6f5419a`](https://github.com/adobe/spectrum-web-components/commit/6f5419a4de29a1ee440a36c1a57d8c2e1476e2f6) Thanks [@rubencarvalho](https://github.com/rubencarvalho)! - **Fixed** missing export for `alert-banner` from `@spectrum-web-components/core`, which could cause build failures in certain environments. - -# [0.0.4](https://github.com/adobe/spectrum-web-components/compare/@spectrum-web-components/core@0.0.3...@spectrum-web-components/core@0.0.4) (2026-02-03) - -### Patch Changes - -**Fixed** missing export for `alert-banner` from `@spectrum-web-components/core`, which could cause build failures in certain environments. +- [#5998](https://github.com/adobe/spectrum-web-components/pull/5998) [`6f5419a`](https://github.com/adobe/spectrum-web-components/commit/6f5419a4de29a1ee440a36c1a57d8c2e1476e2f6) - `Core` — Fixed missing export for `alert-banner` which could cause build failures in certain environments. ## 0.0.3 ### Patch Changes -- [#5993](https://github.com/adobe/spectrum-web-components/pull/5993) [`95e1c25`](https://github.com/adobe/spectrum-web-components/commit/95e1c25672f62f3723dfa66129ae5ecdeabe578a) Thanks [@rubencarvalho](https://github.com/rubencarvalho)! - - **Fixed**: Replaced wildcard exports from `@spectrum-web-components/core` with explicit named exports for better bundler compatibility - - **Fixed**: Changed build target from ES2022 to ES2018 to support Vitest and other consumer environments - - **Fixed**: Added `@spectrum-web-components/core` as direct dependency to `@spectrum-web-components/shared` to resolve module resolution issues in strict dependency environments - - **Fixed**: Added `@lit-labs/observers` as dependency and externalized it in Vite build config - -# [0.0.3](https://github.com/adobe/spectrum-web-components/compare/@spectrum-web-components/core@0.0.2...@spectrum-web-components/core@0.0.3) (2026-02-02) - -### Patch Changes - -- **Fixed**: Replaced wildcard exports from `@spectrum-web-components/core` with explicit named exports for better bundler compatibility -- **Fixed**: Changed build target from ES2022 to ES2018 to support Vitest and other consumer environments -- **Fixed**: Added `@spectrum-web-components/core` as direct dependency to `@spectrum-web-components/shared` to resolve module resolution issues in strict dependency environments -- **Fixed**: Added `@lit-labs/observers` as dependency and externalized it in Vite build config +- [#5993](https://github.com/adobe/spectrum-web-components/pull/5993) [`95e1c25`](https://github.com/adobe/spectrum-web-components/commit/95e1c25672f62f3723dfa66129ae5ecdeabe578a) - `Core` — Replaced wildcard exports with explicit named exports for better bundler compatibility. Changed build target from ES2022 to ES2018. Added `@spectrum-web-components/core` as direct dependency to `@spectrum-web-components/shared`. Added `@lit-labs/observers` as dependency. ## 0.0.2 ### Patch Changes -- [#5900](https://github.com/adobe/spectrum-web-components/pull/5900) [`283f0fe`](https://github.com/adobe/spectrum-web-components/commit/283f0fe07533c464e9fe1a3e7edebecb9128e11f) Thanks [@TarunAdobe](https://github.com/TarunAdobe)! - Added missing dependencies to the package.json files of several components to align with their usage in source code. - -- [#5893](https://github.com/adobe/spectrum-web-components/pull/5893) [`1d76b70`](https://github.com/adobe/spectrum-web-components/commit/1d76b7093d8ff5f9b26f07a69086488341a02650) Thanks [@majornista](https://github.com/majornista)! - hover overlays should close with the Esc key when trigger is not focused - -- [#5866](https://github.com/adobe/spectrum-web-components/pull/5866) [`9cb816b`](https://github.com/adobe/spectrum-web-components/commit/9cb816b5ac80387fdc9bb87381f5149fecb1b595) Thanks [@rubencarvalho](https://github.com/rubencarvalho)! - - **Fixed**: Added `typesVersions` to `@spectrum-web-components/core` to improve TypeScript module resolution for users with `moduleResolution: "node"`. This provides a fallback mechanism when the `exports` field resolution encounters issues, ensuring type declarations are properly resolved across different TypeScript configurations. - -# [0.0.2](https://github.com/adobe/spectrum-web-components/compare/@spectrum-web-components/core@0.0.1...@spectrum-web-components/core@0.0.2) (2026-01-27) - -### Patch Changes - -Added missing dependencies to the package.json files of several components to align with their usage in source code. +- [#5900](https://github.com/adobe/spectrum-web-components/pull/5900) [`283f0fe`](https://github.com/adobe/spectrum-web-components/commit/283f0fe07533c464e9fe1a3e7edebecb9128e11f) - `Core` — Added missing dependencies to package.json files of several components. -hover overlays should close with the Esc key when trigger is not focused +- [#5893](https://github.com/adobe/spectrum-web-components/pull/5893) [`1d76b70`](https://github.com/adobe/spectrum-web-components/commit/1d76b7093d8ff5f9b26f07a69086488341a02650) - `Overlay` — Fixed hover overlays to close with the Esc key when trigger is not focused. -- **Fixed**: Added `typesVersions` to `@spectrum-web-components/core` to improve TypeScript module resolution for users with `moduleResolution: "node"`. This provides a fallback mechanism when the `exports` field resolution encounters issues, ensuring type declarations are properly resolved across different TypeScript configurations. +- [#5866](https://github.com/adobe/spectrum-web-components/pull/5866) [`9cb816b`](https://github.com/adobe/spectrum-web-components/commit/9cb816b5ac80387fdc9bb87381f5149fecb1b595) - `Core` — Added `typesVersions` to improve TypeScript module resolution for users with `moduleResolution: "node"`. diff --git a/2nd-gen/packages/swc/CHANGELOG.md b/2nd-gen/packages/swc/CHANGELOG.md index 3d01bdfb91..f4e8f66330 100644 --- a/2nd-gen/packages/swc/CHANGELOG.md +++ b/2nd-gen/packages/swc/CHANGELOG.md @@ -4,55 +4,28 @@ ### Minor Changes -- [#6184](https://github.com/adobe/spectrum-web-components/pull/6184) [`68261b1`](https://github.com/adobe/spectrum-web-components/commit/68261b1cf230f385be59f7e4fa1b09fd361b27c6) Thanks [@blunteshwar](https://github.com/blunteshwar)! - **feat(color-loupe):** Add 2nd-gen `` with Spectrum 2 visual fidelity. Key changes from 1st-gen ``: - - Pure visual, non-interactive component — accessibility semantics are delegated to the parent color picker or color field - - SVG loupe graphic carries `aria-hidden="true"`; no role, label, or tab stop on the host - - `open` property controls visibility via CSS opacity and transform transitions - - `color` property accepts any valid CSS color string, including colors with alpha transparency revealed over an opacity checkerboard +- [#6184](https://github.com/adobe/spectrum-web-components/pull/6184) [`68261b1`](https://github.com/adobe/spectrum-web-components/commit/68261b1cf230f385be59f7e4fa1b09fd361b27c6) - `Color Loupe` — Added `` with Spectrum 2 visual fidelity. See the [component docs](https://spectrum-web-components.adobe.com/?path=/docs/color-components-color-loupe--docs) and [migration guide](https://spectrum-web-components.adobe.com/?path=/docs/color-components-color-loupe-migration-guide--docs). - See the [migration guide](https://spectrum-web-components.adobe.com/?path=/docs/color-components-color-loupe-migration-guide--docs) for upgrading from 1st-gen `sp-color-loupe`. - -- [#6224](https://github.com/adobe/spectrum-web-components/pull/6224) [`3ec4028`](https://github.com/adobe/spectrum-web-components/commit/3ec4028bb417b1e0d13f82bdac7d8a34720d8d68) Thanks [@TarunAdobe](https://github.com/TarunAdobe)! - **fix(suggestion-group):** require heading via `slot="heading"` instead of the `heading` string property. - - Removed the `heading` property; consumers now provide heading content and semantics via `

`...

` (or any element) - - `accessible-label` takes explicit precedence over heading-derived labeling when both are present - - Host exposes `role="group"` with `aria-labelledby` pointing at the slotted heading so the accessible name resolves across the shadow boundary - - Component still imposes heading typography (i.e. `font-size: token("font-size-200")`) +- [#6224](https://github.com/adobe/spectrum-web-components/pull/6224) [`3ec4028`](https://github.com/adobe/spectrum-web-components/commit/3ec4028bb417b1e0d13f82bdac7d8a34720d8d68) - `Suggestion Group` — Changed heading API to use `slot="heading"` instead of the `heading` string property. Consumer action: replace `heading="…"` with a slotted element like `

…

`. ### Patch Changes -- [#6315](https://github.com/adobe/spectrum-web-components/pull/6315) [`6ac4d14`](https://github.com/adobe/spectrum-web-components/commit/6ac4d1454613edf4134586e4eb67627455081711) Thanks [@TarunAdobe](https://github.com/TarunAdobe)! - **refactor(conversational-ai):** Tighten `swc-conversation-thread` focus handling and story layout for conversational AI. - - Roving focus for the thread is driven only by `FocusgroupNavigationController`; the reflected `active-index` attribute and related public surface are removed. - - Conversation thread stories avoid host inline layout styles in favor of neutral wrappers where needed. - - `swc-user-message` no longer applies host `margin-inline-end` gutter; rely on thread or app shell spacing for edge inset. +- [#6315](https://github.com/adobe/spectrum-web-components/pull/6315) [`6ac4d14`](https://github.com/adobe/spectrum-web-components/commit/6ac4d1454613edf4134586e4eb67627455081711) - `Conversation Thread` — Simplified focus handling; removed `active-index` attribute and related public surface. ## 0.1.0 ### Minor Changes -- [#6254](https://github.com/adobe/spectrum-web-components/pull/6254) [`38a463f`](https://github.com/adobe/spectrum-web-components/commit/38a463f7f4745373d143cdb08c7d87ba932cf1dd) Thanks [@5t3ph](https://github.com/5t3ph)! - **feat(button):** Add 2nd-gen `` with full Spectrum 2 visual fidelity. Key changes from 1st-gen ``: - - Renders an internal native `