@chipmobilesdk/rn-chart 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -1,74 +1,126 @@
-# Changelog
-
-All notable changes to `@chipmobilesdk/rn-chart` are documented here.
-
-The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
-this package adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.1.0] - Unreleased
-
-### Added
-
-Initial release. A domain-agnostic charting package for ChipMobileSdk-family
-apps.
-
-- **One datasource contract** across five chart families, with a shared point
-  envelope and a discriminated `Position` (category, instant, matrix). Families
-  accepting the same position kind interchange without changing the datasource.
-- **Four-way value semantics** — `known` (including a real zero), `unknown`,
-  `notApplicable`, `withheld` — carried as a discriminated union with no numeric
-  field on the three non-value cases, so a gap cannot be coerced to zero.
-- **Chart families**: `ProgressChart`, `DistributionChart`, `TimeSeriesChart`,
-  `BarChart`, `HeatmapChart`, plus `ChartLegend`.
-- **Seven chart states** per family — loading, empty, ready, error, stale,
-  no-permission, partial — with per-chart failure containment and an
-  app-supplied failure-report callback that carries no data values.
-- **Interaction callbacks** for point selection, series selection, segment
-  press, and series visibility. Uncontrolled by default; app-controlled when
-  the corresponding value prop is supplied. The package never navigates,
-  fetches, or mutates.
-- **Theming** through a `ChartTheme` value type resolved from prop, context, or
-  a built-in light/dark default. No dependency on `@chipmobilesdk/rn-theme` or
-  `react-native-unistyles`.
-- **Formatting** through app-supplied formatters for axis labels, values,
-  legend entries, and summaries, with documented locale-neutral defaults.
-- **Accessibility**: composed per-chart summaries, state announcements, and
-  `adjustable` selection traversal for assistive technology.
-- **Dataset budgets** (`DATASET_BUDGETS`) with a dev-only, once-per-chart
-  over-budget warning. Over-budget datasets still render.
-
-### Release notes for consuming apps
-
-What a team adopting this package needs to know and do:
-
-- **Install two things, not one.** `@chipmobilesdk/rn-chart` and its required
-  peer `react-native-svg` (>= 15.15), then `pod install` on iOS.
-- **No permissions, no manifest changes, no store-declaration changes.** The
-  package requests nothing and collects nothing. Note that its *no-permission
-  chart state* is an app-level data-access concept, not an OS permission.
-- **Screenshots may need updating** wherever charts change how a screen looks.
-  No other store metadata is affected.
-- **If you chart sensitive data**, read the data-behaviour note in the README
-  before completing Apple App Privacy or Google Play Data Safety. The package
-  introduces no collection of its own, but anything your app transmits is yours
-  to declare.
-- **If you render narrative or AI-sourced text near a chart**, moderation and
-  content obligations are entirely yours — this package ships no free-text
-  surface.
-- **One API habit to adopt**: keep your datasource referentially stable (state
-  or `useMemo`). Rebuilding it inline every render defeats the package's
-  memoization, and no library can fix that from the inside.
-
-### Notes
-
-- **Peer dependencies**: `react` >= 19, `react-native` >= 0.85,
-  `react-native-svg` >= 15.15. No runtime dependencies.
-- **Native code**: none is authored in this package. `react-native-svg` is a
-  native-backed peer; see the README for install and setup.
-- **Stability**: the value, datasource, state, error, and interaction contracts
-  are stable. `ChartTheme`, `LegendEntry`, family-specific props, and the
-  `DATASET_BUDGETS` values are experimental and may change in a minor release —
-  see `specs/007-rn-chart-package/contracts/public-api.md` §6.
-- **Out of scope, reserved for a future additive minor**: insight/narrative
-  presentation and composable chart primitives. Neither will change the
-  datasource, state, or interaction contracts when it lands.
+# @chipmobilesdk/rn-chart
+
+## 0.2.1
+
+### Patch Changes
+
+- Packaging only; no code change. The package no longer declares `engines.node`: a
+  React Native package does not run on Node, so the field only produced install
+  warnings in apps on another Node version. rn-i18n's command-line tooling does run
+  on Node; its README's compatibility table states the version it needs. ([#14](https://github.com/operationd8979/chip-mobile-sdk/pull/14))
+
+## [0.2.0] - 2026-11-01
+
+Three drawing defects on the production path. **No code change is required.**
+
+### Fixed
+
+- **Axis labels are no longer clipped.** The frame handed every builder the
+  full container, so Y labels (right-aligned left of the plot) were drawn at
+  negative x and X labels fell below the bottom of the SVG: on a device a bar
+  or time-series chart showed no value scale and cut-off dates. Builders now
+  reserve room for their own labels before projecting anything, in one pass.
+- **Distribution legends match their segments.** Segments were coloured by
+  point index while the legend listed series, so a one-series donut of four
+  segments had four colours and one legend entry; four one-point series all
+  drew in the first palette colour. Segment colours now come from one resolver
+  shared by the arcs and the legend, which has one entry per segment. Point
+  colours also had their own map: they shared the series map, so a point id
+  equal to a series id overwrote that series' colour, in every family.
+- **Reference markers are drawn.** Every builder returned no markers, so
+  targets, baselines and thresholds reached the accessibility summary only.
+  Bar and time-series charts now draw them across the plot (with the domain
+  stretched to include them); progress draws its target on each bar.
+- **Progress overshoot stays inside the plot.** It started at the plot's
+  right edge and was clipped, so 118% looked like 100%. The track is now scaled
+  so the target sits inside the plot and the excess is visible beyond it.
+
+- **No phantom axis below zero on all-positive bars.** The domain was padded
+  past zero on both sides, so a bar chart with no negative value printed a
+  negative tick (`-5.5`) on top of the `0` label once labels became visible.
+
+### Added
+
+- `DataPoint.color`, a per-segment colour for distribution charts.
+- `LegendEntry.pointId`, set on distribution entries.
+- `buildLegendEntries(..., family)`: pass `'distribution'` for segment entries.
+
+### Changed
+
+- The plot area of bar and time-series charts is smaller by the space its axis
+  labels need, and `ResolvedGeometry.plot` reports that inner rectangle.
+
+## [0.1.1] - 2026-08-01
+
+### Changed
+
+- The package now ships its agent skill (`skills/`), which consuming apps
+  copy in with `scripts/sync-sdk-skills.mjs`. No code change.
+
+## [0.1.0] - 2026-08-01
+
+### Added
+
+Initial release. A domain-agnostic charting package for ChipMobileSdk-family
+apps.
+
+- **One datasource contract** across five chart families, with a shared point
+  envelope and a discriminated `Position` (category, instant, matrix). Families
+  accepting the same position kind interchange without changing the datasource.
+- **Four-way value semantics** — `known` (including a real zero), `unknown`,
+  `notApplicable`, `withheld` — carried as a discriminated union with no numeric
+  field on the three non-value cases, so a gap cannot be coerced to zero.
+- **Chart families**: `ProgressChart`, `DistributionChart`, `TimeSeriesChart`,
+  `BarChart`, `HeatmapChart`, plus `ChartLegend`.
+- **Seven chart states** per family — loading, empty, ready, error, stale,
+  no-permission, partial — with per-chart failure containment and an
+  app-supplied failure-report callback that carries no data values.
+- **Interaction callbacks** for point selection, series selection, segment
+  press, and series visibility. Uncontrolled by default; app-controlled when
+  the corresponding value prop is supplied. The package never navigates,
+  fetches, or mutates.
+- **Theming** through a `ChartTheme` value type resolved from prop, context, or
+  a built-in light/dark default. No dependency on `@chipmobilesdk/rn-theme` or
+  `react-native-unistyles`.
+- **Formatting** through app-supplied formatters for axis labels, values,
+  legend entries, and summaries, with documented locale-neutral defaults.
+- **Accessibility**: composed per-chart summaries, state announcements, and
+  `adjustable` selection traversal for assistive technology.
+- **Dataset budgets** (`DATASET_BUDGETS`) with a dev-only, once-per-chart
+  over-budget warning. Over-budget datasets still render.
+
+### Release notes for consuming apps
+
+What a team adopting this package needs to know and do:
+
+- **Install two things, not one.** `@chipmobilesdk/rn-chart` and its required
+  peer `react-native-svg` (>= 15.15), then `pod install` on iOS.
+- **No permissions, no manifest changes, no store-declaration changes.** The
+  package requests nothing and collects nothing. Note that its *no-permission
+  chart state* is an app-level data-access concept, not an OS permission.
+- **Screenshots may need updating** wherever charts change how a screen looks.
+  No other store metadata is affected.
+- **If you chart sensitive data**, read the data-behaviour note in the README
+  before completing Apple App Privacy or Google Play Data Safety. The package
+  introduces no collection of its own, but anything your app transmits is yours
+  to declare.
+- **If you render narrative or AI-sourced text near a chart**, moderation and
+  content obligations are entirely yours — this package ships no free-text
+  surface.
+- **One API habit to adopt**: keep your datasource referentially stable (state
+  or `useMemo`). Rebuilding it inline every render defeats the package's
+  memoization, and no library can fix that from the inside.
+
+### Notes
+
+- **Peer dependencies**: `react` >= 19, `react-native` >= 0.85,
+  `react-native-svg` >= 15.15. No runtime dependencies.
+- **Native code**: none is authored in this package. `react-native-svg` is a
+  native-backed peer; see the README for install and setup.
+- **Stability**: the value, datasource, state, error, and interaction contracts
+  are stable. `ChartTheme`, `LegendEntry`, family-specific props, and the
+  `DATASET_BUDGETS` values are experimental and may change in a minor release —
+  see `specs/007-rn-chart-package/contracts/public-api.md` §6.
+- **Out of scope, reserved for a future additive minor**: insight/narrative
+  presentation and composable chart primitives. Neither will change the
+  datasource, state, or interaction contracts when it lands.