@praxisui/charts 9.0.25 → 9.0.27

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
@@ -142,6 +142,35 @@ Use the component with either local data or governed remote execution:
142
142
 
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
+ Supported canonical kinds are `bar`, `horizontal-bar`, `line`, `area`, `stacked-bar`,
146
+ `stacked-area`, `combo`, `pie`, `donut`, `scatter`, `funnel`, and `pyramid`. Funnel and
147
+ pyramid require one categorical dimension and exactly one non-negative metric. They preserve the
148
+ canonical row order; pyramid reverses the visual direction without sorting stages by value.
149
+
150
+ ## Governed chart/table presentation
151
+
152
+ `PraxisAnalyticsPresentationComponent` materializes an existing `x-ui.analytics` projection as a
153
+ chart or analytic table. The projection is selected by exact `projectionId`; the component reuses
154
+ `AnalyticsPresentationResolver` and the official Charts/Table adapters instead of rebuilding stats
155
+ requests.
156
+
157
+ ```html
158
+ <praxis-analytics-presentation
159
+ [analytics]="analytics"
160
+ projectionId="supplier-procurement-funnel"
161
+ [availableFamilies]="['chart', 'analytic-table']"
162
+ [preferredFamily]="savedPreference"
163
+ [queryContext]="queryContext"
164
+ (presentationChange)="rememberTemporarily($event)"
165
+ />
166
+ ```
167
+
168
+ Choice precedence is temporary user choice, persisted `preferredFamily`, then projection hints.
169
+ `availableFamilies` must already reflect host policy/capabilities; the runtime intersects it with
170
+ installed and semantically eligible renderers. Incompatible preferences fail closed. This first
171
+ cut may execute the same canonical query again when switching renderer, and stale table responses
172
+ are ignored. KPI and summary-list remain unavailable until they have canonical remote renderers.
173
+
145
174
  ## Canonical Chart Documents
146
175
 
147
176
  New `x-ui.chart` documents should describe sizing, surface mode, source, dimensions and metrics declaratively.