# GaugeChart changelog

Read the complete [LICENSE](https://snowui.dev/LICENSE) for the installed version before use.

Reviewed against Chinese source SHA-256 `dca98fd7c719b0806bdbc7d1e6c08779a3ebeafd9dc4008d5d6138bcc99b0dec`. For version differences, check the installed package as well.

<a id="v175-2026-10-23"></a>

### v1.7.5 (2026-10-23)

- Retain a 4 CSS px floor for the shared HoverPanel dot-to-name and name-to-value gaps in LTR and RTL. Preserve the default 4px / 8px gaps, larger tokens, chart geometry, and center annotations.

<a id="v174-2026-10-20"></a>

### v1.7.4 (2026-10-20)

- Localized the built-in root accessible name through the shared locale protocol. Fixed explicit aria-label values being overwritten by the default; business names and numeric formatting remain unchanged.

- 2026-09-21: Unified the usage guide, source property table, and Site / AI reading entry points. Documentation only; component behavior is unchanged.

<a id="v172-2026-09-05"></a>

### v1.7.2 (2026-09-05)

- Sector appearance now computes one linear timeline per frame. HoverPanel pointer and cell-hit coordinates share one root measurement per render frame. Public API, semicircle paths, motion duration, visuals, and interaction semantics are unchanged.

<a id="v171-2026-09-04"></a>

### v1.7.1 (2026-09-04)

- Zero-gap sectors now paint color once through an alpha paint mask while retaining seam cover, reducing antialiasing gaps and eliminating dark edges caused by overlapping translucent fill and stroke.

<a id="v170-2026-09-04"></a>

### v1.7.0 (2026-09-04)

- Added optional idle center title and subtitle using the default hover typography. Hover / focus temporarily replace them, and leaving restores them.
- Static center content and dynamic role templates retain their precedence. Role content resynchronizes after loading recovery or toggling the center area.

<a id="v161-2026-09-04"></a>

### v1.6.1 (2026-09-04)

- Fixed queued hover animations replaying after rapid repeated entry/exit and sector switching. A new target takes over immediately from current geometry.
- After pointer exit, a sector with remaining focus stays emphasized. Reduced motion shows final geometry immediately.

<a id="v160-2026-09-03"></a>

### v1.6.0 (2026-09-03)

- Added `minWidth`, default `"40px"`. Setting it equal to chart width prevents responsive shrinking; numeric dimensions follow the same unit rules.

<a id="v151-2026-09-03"></a>

### v1.5.1 (2026-09-03)

- Default responsiveness supports the remaining width in side-by-side flex layouts, with a fixed 40px minimum visible width. No manual opt-in is needed; disabling it retains declared dimensions.

<a id="v150-2026-09-03"></a>

### v1.5.0 (2026-09-03)

- The chart and all center content scale down proportionally with available width by default and return to declared size when space recovers. `enableResponsive=false` retains declared size.
- HoverPanel keeps its size, while pointer / focus positioning follows the actual displayed chart size.

<a id="v141-2026-09-03"></a>

### v1.4.1 (2026-09-03)

- Audited all public properties and completed documentation for Frame forwarding, empty data, size parsing, formatting precedence, and controlled-motion boundaries.
- Site examples now cover 12 complete scenarios: documentation readiness, half-ring / half-pie, size, color, aggregation, formatting, tooltip, hit testing, playback, controlled progress, and report status.
- Examples use design-system Tokens and default center text. Code and Preview are generated from the same recipe.

<a id="v140-2026-09-03"></a>

### v1.4.0 (2026-09-03)

- Added `showBaseLayer=false` to enable same-color outlines at final size on demand. Real graphics and entrance motion retain their behavior.

<a id="2026-09-02"></a>

### 2026-09-02

- HoverPanel is enabled by default, retaining the light appearance.

<a id="v130-2026-06-04"></a>

### v1.3.0 (2026-06-04)

- Added shared Chart `colorMode`: `sequence`, `monochromeFade`, and `monochrome`.
- Added primary `color` plus separate `monochromeColor` / `mutedMonochromeColor` entries. All three modes support per-sector custom colors through `data[i].color` and `colors[i]`.

<a id="v120-2026-05-31"></a>

### v1.2.0 (2026-05-31)

- Gaps now use `padAngle + padRadius` during path construction, replacing the post-render gap mask and radial short-line mask.
- The fill layer now uses a complete padded path with a local `revealPath` mask, fixing misalignment between animated fill and placeholder sectors.
- Corner rounding now uses d3-shape throughout, fixing ineffective large radii, missing corners on short arcs, and clipping on hover.
- Added an official ECharts example, local source reference, and records of this round’s issues and solutions.
- For opaque zero-gap sectors, added a `0.5px` same-color seam cover and a stroke-only `blur(0.5px)` seam.

<a id="v110-2026-05-28"></a>

### v1.1.0 (2026-05-28)

- Aligned the default color sequence with CircularChart.
- Supports the `colors` palette, per-sector colors, CSS variables, `linear-gradient(...)` strings, and gradient objects.
- Corner radii and transparent gaps scale proportionally from a 320px baseline.
- Added a 4% same-color placeholder layer, real fill layer, transparent hit layer, and transparent gaps.
- Added entrance motion, controlled progress, scrolling timeline, refill, and reverse-rewind methods.
- Extracted pure chart color, gradient, geometry, ring path, and appearance-timeline logic into `components/src/lib/chart/`.

<a id="v100-2026-05-22"></a>

### v1.0.0 (2026-05-22)

- Initial GaugeChart implementation.
- Supports adjustable overall width/height, ring thickness, corner radius, separators, and outward thickening on hover.
- Supports center hover labels, 10 items by default with an explicit limit up to 28, and SnowUI’s `primary + secondary-*` color sequence.
- Integrated a Frame root, Skeleton, Test examples, and standards registration.

[Component guide](https://snowui.dev/llms/en/components/gauge-chart.md) · [Full reference](https://snowui.dev/llms/en/components/gauge-chart/reference.md)