@praxisui/charts 9.0.33 → 9.0.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -143,11 +143,16 @@ Use the component with either local data or governed remote execution:
143
143
  The public contract is `PraxisChartConfig` or the canonical `PraxisXUiChartContract`; raw ECharts options are adapter detail, not the host-facing model.
144
144
 
145
145
  Supported canonical kinds are `bar`, `horizontal-bar`, `line`, `area`, `stacked-bar`,
146
- `stacked-area`, `combo`, `pie`, `donut`, `scatter`, `funnel`, `pyramid`, and `treemap`. Funnel,
146
+ `stacked-area`, `combo`, `pie`, `donut`, `scatter`, `funnel`, `pyramid`, `treemap`, and `gauge`. Funnel,
147
147
  pyramid, and treemap require one categorical dimension and exactly one non-negative metric. Funnel
148
148
  and pyramid preserve the canonical row order; pyramid reverses the visual direction without sorting
149
149
  stages by value. Treemap materializes the same governed category/metric buckets as proportional
150
150
  rectangles without introducing hierarchy or engine-specific options into the public contract.
151
+ Gauge requires one dimension, exactly one metric and an explicit finite `gauge.scale` whose `max`
152
+ is greater than `min`. A remote gauge uses `praxis.stats` `group-by` with
153
+ `source.options.limit = 1`; zero or multiple buckets, non-finite values and values outside the
154
+ declared scale fail closed instead of being clamped. Pointer, ticks and angles remain renderer
155
+ details and are not part of the public contract.
151
156
  Scatter accepts one or two metrics. With one metric, the first dimension is X and the metric is Y.
152
157
  With two metrics, the first dimension remains the grouped bucket identity while the first and second
153
158
  metrics map to X and Y; the canonical mapper derives the multi-metric stats request.