@espressif/dashboard-ui-components 1.1.3 → 1.2.1

package/CHANGELOG.md

@@ -4,17 +4,98 @@ All notable changes to this project are documented here. The format is based on
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres
 to [Semantic Versioning](https://semver.org/).
 
-## [Unreleased]
+## [1.2.1] - 2026-08-27
+
+A patch release that adds one new component (`StatusBadge`). No breaking
+changes.
 
 ### Added
-- `DataTable`: `noResultsAction` renders a call-to-action (e.g. an "Add device"
-  button) below the description in the empty state — the missing piece for the
-  common "no users found, create user" pattern. Alongside it, `noResultsHeading`
-  and `noResultsDescription` now accept `ReactNode` as well as `string`, and
-  `noResultsIllustration` / `hideNoResultsIllustration` let you swap or drop the
-  empty-state graphic. Purely additive: existing string usages keep working
-  unchanged, and the default illustration/heading/description stay the same when
-  nothing is passed.
+- **`StatusBadge`** — new component. A thin, i18n-free wrapper around `Badge`
+  and `Spinner` for the "icon + translated label" status chips that every
+  consumer app has been hand-rolling. `label` is the already-translated
+  string; `Icon` is an optional `LucideIcon` rendered in the leading slot;
+  `isLoading` swaps the icon for a matching-size `Spinner` while keeping the
+  chip's footprint stable. `color` and `variant` pass straight through to the
+  underlying `Badge` (defaults: `variant="soft"`, no color). `size` (`sm` /
+  `default` / `lg`, default `default`) drives gap, padding and icon pixel
+  size (14 / 16 / 18 px); the chip is always `rounded-full` — the defining
+  status-chip shape. The per-status registry (which icon / colour / label
+  for `pending` vs `failed`) stays in the consuming app's domain layer; the
+  library ships only the primitive. Exports: `StatusBadge`,
+  `StatusBadgeProps`, `statusBadgeSizeVariants`. No new dependencies.
+
+## [1.2.0] - 2026-08-26
+
+A minor release that adds two new components (`Carousel`, `InputOTP`), extends
+localisation on `KeyValueManager`, and reworks how solid-surface icon cards
+render their inner disc so the glyph stays legible.
+
+### Added
+- **`Carousel`** — new component. Built on Embla Carousel with the autoplay
+  plugin. Slides are supplied as `data` (each with a stable `id`); `orientation`
+  chooses `horizontal` / `vertical`; `navigation` selects between built-in
+  `dots`, `arrows`, or a `custom` renderer that receives a
+  `CarouselNavigationState` (`canScrollPrev` / `canScrollNext`,
+  `selectedIndex`, `scrollSnaps`, `scrollPrev` / `scrollNext` / `scrollTo`).
+  `maxDots` caps the pagination row at a sliding window (clamped to `[1, 10]`,
+  default `5`). `autoplay` + `delay` (clamped to `[1000, 10000]` ms, default
+  `3000`) drive automatic advancement; `loop` wraps at the ends. `onNext` /
+  `onPrevious` fire after every direction change (user, keyboard, autoplay or
+  custom). `className` / `itemClassName` style the wrapper and each slide.
+  Exports: `Carousel`, `CarouselItem`, `CarouselNavigationState`,
+  `CarouselNavigationStyle`, `CarouselOrientation`, `CarouselProps`. Adds
+  `embla-carousel-react` and `embla-carousel-autoplay` as dependencies.
+- **`InputOTP`** — new component, alongside `InputOTPSeparator`. Built on the
+  `input-otp` package. Numeric by default; `allowAlphaNumeric` widens the
+  accepted characters to `[a-zA-Z0-9]`, and `regex` accepts a custom JS regex
+  source (which overrides `allowAlphaNumeric`). Slot count is clamped to
+  `[2, 12]` (default `6`). `separators` (e.g. `[3, 3]`) inserts group
+  boundaries between slot runs — ignored with a `console.warn` when the sum
+  does not equal `length`. Controlled or uncontrolled (`value` /
+  `defaultValue`); `onChange` fires on every keystroke, `onComplete` once the
+  final slot is filled. Composes with the standard input shell (`label`,
+  `required`, `size`, `rounded`, `disabled`, `startHelperContent` /
+  `endHelperContent`, `hintContent`, `error` / `errorContent`). Adds
+  `input-otp` as a dependency.
+- `KeyValueManager`: five new label overrides on the existing `labels` prop —
+  `keyLabel`, `valueLabel`, `actionLabel` (used for the column headers *and*
+  the add-popover field labels), `emptyItems` (message when the list is
+  empty) and `emptySearch` (message when a search returns no results). The
+  `search` placeholder is now derived at resolve time from `keyLabel` /
+  `valueLabel` when no explicit `search` is passed, so renaming the columns
+  updates the placeholder automatically. Backwards compatible — omitted
+  labels fall back to the existing defaults.
+- `IconAvatar`: `discClassName` and `discStyle` — extra classes and inline
+  style applied to the inner disc after the variant/legacy styling. Enables
+  the new solid-surface icon-disc treatment below without callers rebuilding
+  the avatar from scratch.
+
+### Changed
+- **Solid-surface icon cards** (`SimpleClickableCard`, `SimpleInfoCard`,
+  `IconTextActionCard`, and `Alert` when it renders an `IconAvatar`): when
+  the outer variant is `solid`, the inner icon disc now renders as a
+  translucent-foreground bubble on the same-color surface — a ≈15 %
+  foreground fill with a ≈30 % foreground border, glyph painted in the
+  color's `-foreground` token — instead of resolving the avatar to the
+  surface's opposite color. Reads as an inverted-fill circle enclosing the
+  glyph, restoring contrast against the same-color card. Non-solid variants
+  are unchanged and each consumer keeps its previous default (`Alert` still
+  opts into a solid avatar disc; the card components still fall through to
+  `IconAvatar`'s `legacy` tinted disc). Explicit `iconAvatarVariant` /
+  `iconAvatarColor` props always win. Internal only: `SOLID_ICON_AVATAR_COLOR`
+  is removed and `resolveIconAvatarColor` becomes `resolveIconAvatarDefaults`.
+
+### Fixed
+- Display issues on solid-variant `Alert` and card components where the icon
+  glyph could wash out against a same-color background. The redesign in
+  *Changed* restores contrast without any prop change on the caller side.
+
+### Internal
+Nothing in this section affects the published package.
+
+- Removed a stray tracked `todo.md` from the repository root.
+
+## [1.1.3] - 2026-08-08
 
 ### Fixed
 - **Vite 8 compatibility**: `LottieAnimationContainer` and everything built on it
@@ -67,6 +148,18 @@ which does not ship to consumers.
   round-trip, the plain-text fallback for an unbundled language (`haskell`), and
   the `github-light` / `github-dark` theme override.
 
+## [1.1.2] - 2026-08-06
+
+### Added
+- `DataTable`: `noResultsAction` renders a call-to-action (e.g. an "Add device"
+  button) below the description in the empty state — the missing piece for the
+  common "no users found, create user" pattern. Alongside it, `noResultsHeading`
+  and `noResultsDescription` now accept `ReactNode` as well as `string`, and
+  `noResultsIllustration` / `hideNoResultsIllustration` let you swap or drop the
+  empty-state graphic. Purely additive: existing string usages keep working
+  unchanged, and the default illustration/heading/description stay the same when
+  nothing is passed.
+
 ## [1.1.1] - 2026-08-04
 
 A patch release with no API changes: a much smaller published bundle, a wider default