@praxisui/charts 9.0.32 → 9.0.34

package/README.md

@@ -143,9 +143,16 @@ Use the component with either local data or governed remote execution:
 The public contract is `PraxisChartConfig` or the canonical `PraxisXUiChartContract`; raw ECharts options are adapter detail, not the host-facing model.
 
 Supported canonical kinds are `bar`, `horizontal-bar`, `line`, `area`, `stacked-bar`,
-`stacked-area`, `combo`, `pie`, `donut`, `scatter`, `funnel`, and `pyramid`. Funnel and
-pyramid require one categorical dimension and exactly one non-negative metric. They preserve the
-canonical row order; pyramid reverses the visual direction without sorting stages by value.
+`stacked-area`, `combo`, `pie`, `donut`, `scatter`, `funnel`, `pyramid`, `treemap`, and `gauge`. Funnel,
+pyramid, and treemap require one categorical dimension and exactly one non-negative metric. Funnel
+and pyramid preserve the canonical row order; pyramid reverses the visual direction without sorting
+stages by value. Treemap materializes the same governed category/metric buckets as proportional
+rectangles without introducing hierarchy or engine-specific options into the public contract.
+Gauge requires one dimension, exactly one metric and an explicit finite `gauge.scale` whose `max`
+is greater than `min`. A remote gauge uses `praxis.stats` `group-by` with
+`source.options.limit = 1`; zero or multiple buckets, non-finite values and values outside the
+declared scale fail closed instead of being clamped. Pointer, ticks and angles remain renderer
+details and are not part of the public contract.
 Scatter accepts one or two metrics. With one metric, the first dimension is X and the metric is Y.
 With two metrics, the first dimension remains the grouped bucket identity while the first and second
 metrics map to X and Y; the canonical mapper derives the multi-metric stats request.