@praxisui/charts 9.0.0-beta.21 → 9.0.0-beta.25

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
@@ -134,13 +134,29 @@ const chartDocument: PraxisXUiChartContract = {
134
134
 
135
135
  Supported sizing modes are `fixed`, `fill-container` and `auto`. Prefer `fill-container` inside dashboard widget shells. Supported surface modes are `auto`, `embedded` and `contained`; prefer `embedded` when another shell owns the card, header or border.
136
136
 
137
+ ## Micro Visualizations
138
+
139
+ `PraxisMicroVisualizationComponent` renders the first renderer-neutral presentation visualizations from `@praxisui/core`.
140
+ It is intended for compact presentation surfaces, especially table cells, list items and read-only form summaries.
141
+
142
+ The initial table-safe kinds are:
143
+
144
+ - `comparison`
145
+ - `stackedBar`
146
+ - `bullet`
147
+ - `delta`
148
+
149
+ The component does not instantiate ECharts. It renders lightweight HTML/CSS from `PraxisPresentationVisualizationConfig`
150
+ and falls back to `fallbackText` when the visualization kind is not supported by this first cut.
151
+ For `comparison`, use `points` as the canonical numeric series; `items` remains reserved for item/step-oriented visualizations such as process flow.
152
+
137
153
  ## Authoring Surface
138
154
 
139
155
  `PraxisChartConfigEditor` is the initial editor shell for canonical `x-ui.chart` documents. It expects governed resources, fields and targets from the host and emits structured apply/save/reset events. The authoring manifest is exported as `PRAXIS_CHARTS_AUTHORING_MANIFEST` for backend/tooling workflows that need executable chart-edit operations.
140
156
 
141
157
  ## Public API Snapshot
142
158
 
143
- Main exports include `PraxisChartComponent`, `PraxisChartConfigEditor`, chart event/config models, `PraxisXUiChartContract`, engine adapter tokens, `providePraxisCharts`, canonical mapping/normalization/validation services, analytics chart services, chart metadata and `PRAXIS_CHARTS_AUTHORING_MANIFEST`.
159
+ Main exports include `PraxisChartComponent`, `PraxisMicroVisualizationComponent`, `PraxisChartConfigEditor`, chart event/config models, `PraxisXUiChartContract`, engine adapter tokens, `providePraxisCharts`, canonical mapping/normalization/validation services, analytics chart services, chart metadata and `PRAXIS_CHARTS_AUTHORING_MANIFEST`.
144
160
 
145
161
  ## Official Links
146
162
 
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": "1.0.0",
3
- "generatedAt": "2026-06-25T18:12:49.520Z",
3
+ "generatedAt": "2026-06-30T12:05:08.567Z",
4
4
  "packageName": "@praxisui/charts",
5
- "packageVersion": "9.0.0-beta.21",
5
+ "packageVersion": "9.0.0-beta.25",
6
6
  "sourceRegistry": "praxis-component-registry-ingestion",
7
7
  "sourceRegistryVersion": "1.0.0",
8
8
  "componentCount": 2,
@@ -970,7 +970,7 @@
970
970
  "affectedPaths": [
971
971
  "queryContext"
972
972
  ],
973
- "submissionImpact": "config-only",
973
+ "submissionImpact": "affects-schema-backed-data",
974
974
  "preconditions": [
975
975
  "config-initialized"
976
976
  ]
@@ -1093,7 +1093,7 @@
1093
1093
  "affectedPaths": [
1094
1094
  "chartDocument.events.crossFilter"
1095
1095
  ],
1096
- "submissionImpact": "config-only",
1096
+ "submissionImpact": "affects-schema-backed-data",
1097
1097
  "preconditions": [
1098
1098
  "config-initialized"
1099
1099
  ]
@@ -1284,7 +1284,7 @@
1284
1284
  "affectedPaths": [
1285
1285
  "chartDocument.events.selectionChange"
1286
1286
  ],
1287
- "submissionImpact": "config-only",
1287
+ "submissionImpact": "affects-schema-backed-data",
1288
1288
  "preconditions": [
1289
1289
  "config-initialized"
1290
1290
  ]
@@ -1753,9 +1753,9 @@
1753
1753
  {
1754
1754
  "chunkIndex": 1,
1755
1755
  "chunkKind": "authoring_manifest",
1756
- "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-chart\",\n \"ownerPackage\": \"@praxisui/charts\",\n \"configSchemaId\": \"PraxisXUiChartContract\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"chartDocument\",\n \"type\": \"PraxisXUiChartContract | null\",\n \"description\": \"Canonical x-ui.chart document used as the authoring source of truth.\"\n },\n {\n \"name\": \"config\",\n \"type\": \"PraxisChartConfig\",\n \"description\": \"Runtime chart configuration mapped from or supplied beside the canonical chart document.\"\n },\n {\n \"name\": \"queryContext\",\n \"type\": \"PraxisChartQueryContext | null\",\n \"description\": \"Declarative query context merged into remote datasource requests.\"\n },\n {\n \"name\": \"remoteDataResolver\",\n \"type\": \"PraxisChartRemoteDataResolver | null\",\n \"description\": \"Host-governed remote row resolver for integrations outside the default praxis.stats client.\"\n },\n {\n \"name\": \"availableResources\",\n \"type\": \"ChartEditorResourceOption[]\",\n \"description\": \"Governed remote resource catalog exposed to the config editor.\"\n },\n {\n \"name\": \"availableFields\",\n \"type\": \"ChartEditorFieldOption[]\",\n \"description\": \"Governed semantic field catalog exposed to the config editor.\"\n },\n {\n \"name\": \"availableTargets\",\n \"type\": \"ChartEditorTargetOption[]\",\n \"description\": \"Governed widget or route targets exposed to chart event authoring.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"chartType\",\n \"resolver\": \"x-ui-chart-kind\",\n \"description\": \"Canonical `kind` field in PraxisXUiChartContract.\"\n },\n {\n \"kind\": \"series\",\n \"resolver\": \"x-ui-chart-metric-by-field\",\n \"description\": \"Metric-backed series definition in `metrics[]`, keyed by field.\"\n },\n {\n \"kind\": \"axis\",\n \"resolver\": \"x-ui-chart-dimension-or-metric-axis\",\n \"description\": \"Dimension role, metric axis and chart orientation semantics.\"\n },\n {\n \"kind\": \"dataBinding\",\n \"resolver\": \"x-ui-chart-source-and-field-catalog\",\n \"description\": \"Source, dimensions, metrics and resource/field bindings.\"\n },\n {\n \"kind\": \"queryContext\",\n \"resolver\": \"praxis-chart-query-context\",\n \"description\": \"Runtime queryContext contract for filters, sort, limit and page.\"\n },\n {\n \"kind\": \"crossFilter\",\n \"resolver\": \"x-ui-chart-events-cross-filter\",\n \"description\": \"Cross-filter event mapping emitted as structured query-context filters.\"\n },\n {\n \"kind\": \"drilldown\",\n \"resolver\": \"x-ui-chart-events-drill-down\",\n \"description\": \"Drilldown event mapping and governed target.\"\n },\n {\n \"kind\": \"selection\",\n \"resolver\": \"x-ui-chart-events-selection-change\",\n \"description\": \"Selection event enablement and mapping semantics.\"\n },\n {\n \"kind\": \"legend\",\n \"resolver\": \"x-ui-chart-legend-feature\",\n \"description\": \"Legend visibility through boolean or toggleable feature object.\"\n },\n {\n \"kind\": \"tooltip\",\n \"resolver\": \"x-ui-chart-tooltip-feature\",\n \"description\": \"Tooltip visibility through boolean or toggleable feature object.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"chart.document.set\",\n \"title\": \"Set chart document\",\n \"scope\": \"global\",\n \"targetKind\": \"dataBinding\",\n \"target\": {\n \"kind\": \"dataBinding\",\n \"resolver\": \"x-ui-chart-document-root\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"version\",\n \"kind\",\n \"source\"\n ],\n \"properties\": {\n \"version\": {\n \"const\": \"0.1.0\"\n },\n \"kind\": {\n \"enum\": [\n \"bar\",\n \"combo\",\n \"horizontal-bar\",\n \"line\",\n \"pie\",\n \"donut\",\n \"area\",\n \"stacked-bar\",\n \"stacked-area\",\n \"scatter\"\n ]\n },\n \"chartId\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"subtitle\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"source\": {\n \"type\": \"object\",\n \"required\": [\n \"kind\"\n ],\n \"properties\": {\n \"kind\": {\n \"enum\": [\n \"praxis.stats\",\n \"derived\"\n ]\n },\n \"resource\": {\n \"type\": \"string\"\n },\n \"operation\": {\n \"enum\": [\n \"group-by\",\n \"timeseries\",\n \"distribution\"\n ]\n },\n \"options\": {\n \"type\": \"object\"\n }\n }\n },\n \"dimensions\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"metrics\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"events\": {\n \"type\": \"object\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"set-value\",\n \"path\": \"chartDocument\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"chart-document-shape\",\n \"chart-version-supported\",\n \"chart-type-series-axis-compatible\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"chart.type.set\",\n \"title\": \"Set chart type\",\n \"scope\": \"global\",\n \"targetKind\": \"chartType\",\n \"target\": {\n \"kind\": \"chartType\",\n \"resolver\": \"x-ui-chart-kind\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"kind\"\n ],\n \"properties\": {\n \"kind\": {\n \"enum\": [\n \"bar\",\n \"combo\",\n \"horizontal-bar\",\n \"line\",\n \"pie\",\n \"donut\",\n \"area\",\n \"stacked-bar\",\n \"stacked-area\",\n \"scatter\"\n ]\n },\n \"orientation\": {\n \"enum\": [\n \"vertical\",\n \"horizontal\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"chartDocument\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"chart-type-supported\",\n \"chart-type-series-axis-compatible\",\n \"pie-single-metric\",\n \"combo-minimum-series\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.kind\",\n \"chartDocument.orientation\",\n \"chartDocument.metrics[]\",\n \"chartDocument.dimensions[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"series.add\",\n \"title\": \"Add chart series\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"series\",\n \"target\": {\n \"kind\": \"series\",\n \"resolver\": \"x-ui-chart-metric-by-field\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"aggregation\": {\n \"enum\": [\n \"sum\",\n \"avg\",\n \"min\",\n \"max\",\n \"count\",\n \"distinct-count\"\n ]\n },\n \"seriesKind\": {\n \"enum\": [\n \"bar\",\n \"line\",\n \"area\"\n ]\n },\n \"axis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"color\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n },\n \"afterField\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-series-add\",\n \"handlerContract\": {\n \"reads\": [\n \"chartDocument.kind\",\n \"chartDocument.metrics[]\",\n \"availableFields[]\"\n ],\n \"writes\": [\n \"chartDocument.metrics[]\"\n ],\n \"identityKeys\": [\n \"chartDocument.metrics[].field\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"aggregation\": {\n \"enum\": [\n \"sum\",\n \"avg\",\n \"min\",\n \"max\",\n \"count\",\n \"distinct-count\"\n ]\n },\n \"seriesKind\": {\n \"enum\": [\n \"bar\",\n \"line\",\n \"area\"\n ]\n },\n \"axis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"color\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n },\n \"afterField\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"field-not-in-catalog\",\n \"duplicate-series-field\",\n \"aggregation-not-supported\",\n \"chart-type-series-incompatible\"\n ],\n \"description\": \"Adds a metric-backed series by semantic field, validating it against availableFields and chart kind compatibility before patching metrics[].\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"series-field-exists\",\n \"series-field-aggregable\",\n \"series-id-unique\",\n \"chart-type-series-axis-compatible\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.metrics[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"series.remove\",\n \"title\": \"Remove chart series\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"series\",\n \"target\": {\n \"kind\": \"series\",\n \"resolver\": \"x-ui-chart-metric-by-field\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"replacementField\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"remove-by-key\",\n \"path\": \"chartDocument.metrics[]\",\n \"key\": \"field\"\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"series-exists\",\n \"destructive-series-removal-confirmed\",\n \"chart-keeps-required-metric\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.metrics[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-series-exists\",\n \"confirmation-collected\"\n ]\n },\n {\n \"operationId\": \"axis.configure\",\n \"title\": \"Configure chart axis\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"axis\",\n \"target\": {\n \"kind\": \"axis\",\n \"resolver\": \"x-ui-chart-dimension-or-metric-axis\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"dimensionField\": {\n \"type\": \"string\"\n },\n \"dimensionRole\": {\n \"enum\": [\n \"category\",\n \"series\",\n \"segment\",\n \"time\",\n \"value\"\n ]\n },\n \"metricField\": {\n \"type\": \"string\"\n },\n \"metricAxis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"orientation\": {\n \"enum\": [\n \"vertical\",\n \"horizontal\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-axis-configure\",\n \"handlerContract\": {\n \"reads\": [\n \"chartDocument.kind\",\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\",\n \"availableFields[]\"\n ],\n \"writes\": [\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\",\n \"chartDocument.orientation\"\n ],\n \"identityKeys\": [\n \"chartDocument.dimensions[].field\",\n \"chartDocument.metrics[].field\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"dimensionField\": {\n \"type\": \"string\"\n },\n \"dimensionRole\": {\n \"enum\": [\n \"category\",\n \"series\",\n \"segment\",\n \"time\",\n \"value\"\n ]\n },\n \"metricField\": {\n \"type\": \"string\"\n },\n \"metricAxis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"orientation\": {\n \"enum\": [\n \"vertical\",\n \"horizontal\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"field-not-in-catalog\",\n \"secondary-axis-non-combo\",\n \"missing-required-dimension\",\n \"axis-role-incompatible\"\n ],\n \"description\": \"Configures dimensions and metric axes using semantic fields, preserving combo-only secondary axis constraints.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"axis-field-exists\",\n \"secondary-axis-combo-only\",\n \"cartesian-dimension-required\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[].axis\",\n \"chartDocument.orientation\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"data.resource.bind\",\n \"title\": \"Bind chart data resource\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"dataBinding\",\n \"target\": {\n \"kind\": \"dataBinding\",\n \"resolver\": \"x-ui-chart-source-and-field-catalog\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"sourceKind\"\n ],\n \"properties\": {\n \"sourceKind\": {\n \"enum\": [\n \"praxis.stats\",\n \"derived\"\n ]\n },\n \"resource\": {\n \"type\": \"string\"\n },\n \"operation\": {\n \"enum\": [\n \"group-by\",\n \"timeseries\",\n \"distribution\"\n ]\n },\n \"dimensions\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"role\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"metrics\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"aggregation\": {\n \"enum\": [\n \"sum\",\n \"avg\",\n \"min\",\n \"max\",\n \"count\",\n \"distinct-count\"\n ]\n },\n \"seriesKind\": {\n \"enum\": [\n \"bar\",\n \"line\",\n \"area\"\n ]\n },\n \"axis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"color\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n },\n \"afterField\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-data-resource-bind\",\n \"handlerContract\": {\n \"reads\": [\n \"availableResources[]\",\n \"availableFields[]\",\n \"chartDocument.source\",\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\"\n ],\n \"writes\": [\n \"chartDocument.source\",\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\"\n ],\n \"identityKeys\": [\n \"availableResources[].path\",\n \"availableResources[].id\",\n \"availableFields[].field\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"sourceKind\"\n ],\n \"properties\": {\n \"sourceKind\": {\n \"enum\": [\n \"praxis.stats\",\n \"derived\"\n ]\n },\n \"resource\": {\n \"type\": \"string\"\n },\n \"operation\": {\n \"enum\": [\n \"group-by\",\n \"timeseries\",\n \"distribution\"\n ]\n },\n \"dimensions\": {\n \"type\": \"array\"\n },\n \"metrics\": {\n \"type\": \"array\"\n }\n }\n },\n \"failureModes\": [\n \"resource-not-in-api-metadata\",\n \"field-not-in-schema\",\n \"stats-operation-not-supported\",\n \"remote-binding-incomplete\"\n ],\n \"description\": \"Binds a derived or praxis.stats source using the governed resource and field catalogs instead of free-form prompt examples.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"remote-resource-in-api-metadata\",\n \"bound-fields-exist\",\n \"stats-operation-supported\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.source\",\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\"\n ],\n \"submissionImpact\": \"affects-remote-binding\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"queryContext.set\",\n \"title\": \"Set chart query context\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"queryContext\",\n \"target\": {\n \"kind\": \"queryContext\",\n \"resolver\": \"praxis-chart-query-context\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"filters\": {\n \"type\": \"object\"\n },\n \"sort\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"limit\": {\n \"type\": \"number\"\n },\n \"page\": {\n \"type\": \"object\"\n },\n \"meta\": {\n \"type\": \"object\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"set-value\",\n \"path\": \"queryContext\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"query-context-structured\",\n \"query-context-fields-exist\",\n \"query-context-safe-values\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"queryContext\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"crossFilter.configure\",\n \"title\": \"Configure chart cross-filter\",\n \"scope\": \"eventMapping\",\n \"targetKind\": \"crossFilter\",\n \"target\": {\n \"kind\": \"crossFilter\",\n \"resolver\": \"x-ui-chart-events-cross-filter\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-event-cross-filter-configure\",\n \"handlerContract\": {\n \"reads\": [\n \"chartDocument.events.crossFilter\",\n \"chartDocument.dimensions[]\",\n \"availableTargets[]\"\n ],\n \"writes\": [\n \"chartDocument.events.crossFilter\"\n ],\n \"identityKeys\": [\n \"availableTargets[].id\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"target-not-in-catalog\",\n \"mapping-source-field-missing\",\n \"mapping-target-invalid\",\n \"unsafe-event-action\"\n ],\n \"description\": \"Configures crossFilter as a structured event action that emits safe query-context filters to a governed target.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"cross-filter-output-structured\",\n \"event-target-governed\",\n \"event-mapping-fields-exist\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.events.crossFilter\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"drilldown.configure\",\n \"title\": \"Configure chart drilldown\",\n \"scope\": \"eventMapping\",\n \"targetKind\": \"drilldown\",\n \"target\": {\n \"kind\": \"drilldown\",\n \"resolver\": \"x-ui-chart-events-drill-down\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-event-drilldown-configure\",\n \"handlerContract\": {\n \"reads\": [\n \"chartDocument.events.drillDown\",\n \"chartDocument.dimensions[]\",\n \"availableTargets[]\"\n ],\n \"writes\": [\n \"chartDocument.events.drillDown\"\n ],\n \"identityKeys\": [\n \"availableTargets[].id\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"target-not-in-catalog\",\n \"mapping-source-field-missing\",\n \"drilldown-target-invalid\",\n \"unsafe-event-action\"\n ],\n \"description\": \"Configures drillDown through governed route/widget targets and structured field mappings.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"drilldown-target-governed\",\n \"event-mapping-fields-exist\",\n \"event-action-supported\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.events.drillDown\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"selection.configure\",\n \"title\": \"Configure chart selection\",\n \"scope\": \"selection\",\n \"targetKind\": \"selection\",\n \"target\": {\n \"kind\": \"selection\",\n \"resolver\": \"x-ui-chart-events-selection-change\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"chartDocument.events.selectionChange\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"selection-output-structured\",\n \"event-mapping-fields-exist\",\n \"event-action-supported\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.events.selectionChange\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"legend.configure\",\n \"title\": \"Configure chart legend\",\n \"scope\": \"skin\",\n \"targetKind\": \"legend\",\n \"target\": {\n \"kind\": \"legend\",\n \"resolver\": \"x-ui-chart-legend-feature\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"enabled\"\n ],\n \"properties\": {\n \"enabled\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"set-value\",\n \"path\": \"chartDocument.legend\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"feature-toggle-valid\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.legend\"\n ],\n \"submissionImpact\": \"visual-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"tooltip.configure\",\n \"title\": \"Configure chart tooltip\",\n \"scope\": \"skin\",\n \"targetKind\": \"tooltip\",\n \"target\": {\n \"kind\": \"tooltip\",\n \"resolver\": \"x-ui-chart-tooltip-feature\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"enabled\"\n ],\n \"properties\": {\n \"enabled\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"set-value\",\n \"path\": \"chartDocument.tooltip\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"feature-toggle-valid\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.tooltip\"\n ],\n \"submissionImpact\": \"visual-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"chart-document-shape\",\n \"level\": \"error\",\n \"code\": \"CHART_DOCUMENT_SHAPE\",\n \"description\": \"Document must conform to PraxisXUiChartContract.\"\n },\n {\n \"validatorId\": \"chart-version-supported\",\n \"level\": \"error\",\n \"code\": \"CHART_VERSION_SUPPORTED\",\n \"description\": \"Only x-ui.chart version 0.1.0 is authorable.\"\n },\n {\n \"validatorId\": \"chart-type-supported\",\n \"level\": \"error\",\n \"code\": \"CHART_TYPE_SUPPORTED\",\n \"description\": \"Chart kind must be supported by @praxisui/charts.\"\n },\n {\n \"validatorId\": \"chart-type-series-axis-compatible\",\n \"level\": \"error\",\n \"code\": \"CHART_TYPE_SERIES_AXIS_COMPATIBLE\",\n \"description\": \"Chart kind, dimensions, metrics and axes must be compatible.\"\n },\n {\n \"validatorId\": \"pie-single-metric\",\n \"level\": \"error\",\n \"code\": \"PIE_SINGLE_METRIC\",\n \"description\": \"Pie and donut charts support a single metric.\"\n },\n {\n \"validatorId\": \"combo-minimum-series\",\n \"level\": \"error\",\n \"code\": \"COMBO_MINIMUM_SERIES\",\n \"description\": \"Combo charts require at least two metrics.\"\n },\n {\n \"validatorId\": \"series-field-exists\",\n \"level\": \"error\",\n \"code\": \"SERIES_FIELD_EXISTS\",\n \"description\": \"Series field must exist in availableFields or schema context.\"\n },\n {\n \"validatorId\": \"series-field-aggregable\",\n \"level\": \"error\",\n \"code\": \"SERIES_FIELD_AGGREGABLE\",\n \"description\": \"Metric fields must support the requested aggregation.\"\n },\n {\n \"validatorId\": \"series-id-unique\",\n \"level\": \"error\",\n \"code\": \"SERIES_ID_UNIQUE\",\n \"description\": \"Metric/series identity must be stable and unique by field.\"\n },\n {\n \"validatorId\": \"series-exists\",\n \"level\": \"error\",\n \"code\": \"SERIES_EXISTS\",\n \"description\": \"Series removal target must exist.\"\n },\n {\n \"validatorId\": \"destructive-series-removal-confirmed\",\n \"level\": \"error\",\n \"code\": \"DESTRUCTIVE_SERIES_REMOVAL_CONFIRMED\",\n \"description\": \"Removing a series requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"chart-keeps-required-metric\",\n \"level\": \"error\",\n \"code\": \"CHART_KEEPS_REQUIRED_METRIC\",\n \"description\": \"A chart cannot be left without required metrics.\"\n },\n {\n \"validatorId\": \"axis-field-exists\",\n \"level\": \"error\",\n \"code\": \"AXIS_FIELD_EXISTS\",\n \"description\": \"Axis/dimension fields must exist in availableFields or schema context.\"\n },\n {\n \"validatorId\": \"secondary-axis-combo-only\",\n \"level\": \"error\",\n \"code\": \"SECONDARY_AXIS_COMBO_ONLY\",\n \"description\": \"Secondary axis is supported only for combo charts.\"\n },\n {\n \"validatorId\": \"cartesian-dimension-required\",\n \"level\": \"error\",\n \"code\": \"CARTESIAN_DIMENSION_REQUIRED\",\n \"description\": \"Cartesian charts require at least one dimension.\"\n },\n {\n \"validatorId\": \"remote-resource-in-api-metadata\",\n \"level\": \"error\",\n \"code\": \"REMOTE_RESOURCE_IN_API_METADATA\",\n \"description\": \"Remote praxis.stats resource must come from the governed API metadata/resource catalog.\"\n },\n {\n \"validatorId\": \"bound-fields-exist\",\n \"level\": \"error\",\n \"code\": \"BOUND_FIELDS_EXIST\",\n \"description\": \"Bound dimensions and metrics must exist in the schema/data context.\"\n },\n {\n \"validatorId\": \"stats-operation-supported\",\n \"level\": \"error\",\n \"code\": \"STATS_OPERATION_SUPPORTED\",\n \"description\": \"Remote datasource operation must be supported by the stats backend.\"\n },\n {\n \"validatorId\": \"query-context-structured\",\n \"level\": \"error\",\n \"code\": \"QUERY_CONTEXT_STRUCTURED\",\n \"description\": \"queryContext must use structured filters, sort, limit and page fields.\"\n },\n {\n \"validatorId\": \"query-context-fields-exist\",\n \"level\": \"warning\",\n \"code\": \"QUERY_CONTEXT_FIELDS_EXIST\",\n \"description\": \"queryContext filter fields should exist in the schema/data context.\"\n },\n {\n \"validatorId\": \"query-context-safe-values\",\n \"level\": \"error\",\n \"code\": \"QUERY_CONTEXT_SAFE_VALUES\",\n \"description\": \"queryContext values must be serializable safe data.\"\n },\n {\n \"validatorId\": \"cross-filter-output-structured\",\n \"level\": \"error\",\n \"code\": \"CROSS_FILTER_OUTPUT_STRUCTURED\",\n \"description\": \"Cross-filter output must be structured as query-context filters.\"\n },\n {\n \"validatorId\": \"event-target-governed\",\n \"level\": \"error\",\n \"code\": \"EVENT_TARGET_GOVERNED\",\n \"description\": \"Event targets must be selected from availableTargets or an approved host catalog.\"\n },\n {\n \"validatorId\": \"event-mapping-fields-exist\",\n \"level\": \"error\",\n \"code\": \"EVENT_MAPPING_FIELDS_EXIST\",\n \"description\": \"Event mapping source fields must exist in chart data context.\"\n },\n {\n \"validatorId\": \"event-action-supported\",\n \"level\": \"error\",\n \"code\": \"EVENT_ACTION_SUPPORTED\",\n \"description\": \"Event action must be one of the supported structured action kinds.\"\n },\n {\n \"validatorId\": \"drilldown-target-governed\",\n \"level\": \"error\",\n \"code\": \"DRILLDOWN_TARGET_GOVERNED\",\n \"description\": \"Drilldown target must be a governed route or widget target.\"\n },\n {\n \"validatorId\": \"selection-output-structured\",\n \"level\": \"error\",\n \"code\": \"SELECTION_OUTPUT_STRUCTURED\",\n \"description\": \"Selection output must resolve selected point filters deterministically.\"\n },\n {\n \"validatorId\": \"feature-toggle-valid\",\n \"level\": \"error\",\n \"code\": \"FEATURE_TOGGLE_VALID\",\n \"description\": \"Legend and tooltip feature values must be boolean or toggleable feature objects.\"\n },\n {\n \"validatorId\": \"editor-runtime-round-trip\",\n \"level\": \"error\",\n \"code\": \"EDITOR_RUNTIME_ROUND_TRIP\",\n \"description\": \"PraxisChartConfigEditor must save/reopen the same canonical document that runtime consumes.\"\n }\n ],\n \"roundTripRequirements\": [\n \"The canonical saved shape is PraxisXUiChartContract, not raw ECharts options.\",\n \"PraxisChartConfigEditor must preserve chart kind, source, dimensions, metrics, events, legend and tooltip across apply/save/reset/reopen.\",\n \"Remote bindings must be resolved from availableResources/API metadata and availableFields/schema context.\",\n \"Cross-filter, drilldown and selection authoring must persist structured event actions, not prompt examples or command strings.\"\n ],\n \"examples\": [\n {\n \"id\": \"set-bar-chart\",\n \"request\": \"Use a bar chart for employees by department.\",\n \"operationId\": \"chart.type.set\",\n \"params\": {\n \"kind\": \"bar\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-salary-series\",\n \"request\": \"Add salary as a summed metric.\",\n \"operationId\": \"series.add\",\n \"params\": {\n \"field\": \"salary\",\n \"aggregation\": \"sum\",\n \"label\": \"Salary\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-old-series\",\n \"request\": \"Remove the old cost series.\",\n \"operationId\": \"series.remove\",\n \"target\": \"cost\",\n \"params\": {\n \"field\": \"cost\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-secondary-axis\",\n \"request\": \"Put margin on a secondary axis for the combo chart.\",\n \"operationId\": \"axis.configure\",\n \"params\": {\n \"metricField\": \"margin\",\n \"metricAxis\": \"secondary\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"bind-stats-resource\",\n \"request\": \"Bind this chart to payroll stats grouped by department.\",\n \"operationId\": \"data.resource.bind\",\n \"params\": {\n \"sourceKind\": \"praxis.stats\",\n \"resource\": \"/api/stats/payroll\",\n \"operation\": \"group-by\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-query-context\",\n \"request\": \"Limit the chart to active employees and sort by total descending.\",\n \"operationId\": \"queryContext.set\",\n \"params\": {\n \"filters\": {\n \"status\": \"ACTIVE\"\n },\n \"sort\": [\n \"total,desc\"\n ],\n \"limit\": 10\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-cross-filter\",\n \"request\": \"Use selected department to filter the employee table.\",\n \"operationId\": \"crossFilter.configure\",\n \"params\": {\n \"event\": \"crossFilter\",\n \"action\": \"filter-widget\",\n \"target\": \"employeesTable\",\n \"mapping\": {\n \"department\": \"department\"\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-drilldown\",\n \"request\": \"Open the department detail when a point is clicked.\",\n \"operationId\": \"drilldown.configure\",\n \"params\": {\n \"event\": \"drillDown\",\n \"action\": \"navigate\",\n \"target\": \"/departments/detail\",\n \"mapping\": {\n \"department\": \"departmentId\"\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-selection\",\n \"request\": \"Emit selected department as a structured selection event.\",\n \"operationId\": \"selection.configure\",\n \"params\": {\n \"event\": \"selectionChange\",\n \"action\": \"emit\",\n \"mapping\": {\n \"department\": \"department\"\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"toggle-legend\",\n \"request\": \"Show the legend.\",\n \"operationId\": \"legend.configure\",\n \"params\": {\n \"enabled\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"toggle-tooltip\",\n \"request\": \"Disable tooltips.\",\n \"operationId\": \"tooltip.configure\",\n \"params\": {\n \"enabled\": false\n },\n \"isPositive\": true\n },\n {\n \"id\": \"round-trip-editor-runtime\",\n \"request\": \"Save this chart in the editor and reopen it without changing the runtime chart document.\",\n \"operationId\": \"chart.document.set\",\n \"params\": {\n \"version\": \"0.1.0\",\n \"kind\": \"bar\",\n \"source\": {\n \"kind\": \"derived\"\n },\n \"dimensions\": [\n {\n \"field\": \"department\"\n }\n ],\n \"metrics\": [\n {\n \"field\": \"total\",\n \"aggregation\": \"count\"\n }\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-ambiguous-series-target\",\n \"request\": \"Remove total when more than one chart series resolves to total.\",\n \"operationId\": \"series.remove\",\n \"target\": \"total\",\n \"params\": {\n \"field\": \"total\"\n },\n \"isPositive\": false\n },\n {\n \"id\": \"reject-prompt-routing\",\n \"request\": \"Use the prompt example text to decide which backend endpoint to call.\",\n \"operationId\": \"data.resource.bind\",\n \"params\": {\n \"sourceKind\": \"praxis.stats\",\n \"resource\": \"from prompt example\"\n },\n \"isPositive\": false\n },\n {\n \"id\": \"reject-unsafe-target\",\n \"request\": \"Navigate to javascript:alert(1) on drilldown.\",\n \"operationId\": \"drilldown.configure\",\n \"params\": {\n \"event\": \"drillDown\",\n \"action\": \"navigate\",\n \"target\": \"javascript:alert(1)\"\n },\n \"isPositive\": false\n }\n ]\n}",
1756
+ "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-chart\",\n \"ownerPackage\": \"@praxisui/charts\",\n \"configSchemaId\": \"PraxisXUiChartContract\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"chartDocument\",\n \"type\": \"PraxisXUiChartContract | null\",\n \"description\": \"Canonical x-ui.chart document used as the authoring source of truth.\"\n },\n {\n \"name\": \"config\",\n \"type\": \"PraxisChartConfig\",\n \"description\": \"Runtime chart configuration mapped from or supplied beside the canonical chart document.\"\n },\n {\n \"name\": \"queryContext\",\n \"type\": \"PraxisChartQueryContext | null\",\n \"description\": \"Declarative query context merged into remote datasource requests.\"\n },\n {\n \"name\": \"remoteDataResolver\",\n \"type\": \"PraxisChartRemoteDataResolver | null\",\n \"description\": \"Host-governed remote row resolver for integrations outside the default praxis.stats client.\"\n },\n {\n \"name\": \"availableResources\",\n \"type\": \"ChartEditorResourceOption[]\",\n \"description\": \"Governed remote resource catalog exposed to the config editor.\"\n },\n {\n \"name\": \"availableFields\",\n \"type\": \"ChartEditorFieldOption[]\",\n \"description\": \"Governed semantic field catalog exposed to the config editor.\"\n },\n {\n \"name\": \"availableTargets\",\n \"type\": \"ChartEditorTargetOption[]\",\n \"description\": \"Governed widget or route targets exposed to chart event authoring.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"chartType\",\n \"resolver\": \"x-ui-chart-kind\",\n \"description\": \"Canonical `kind` field in PraxisXUiChartContract.\"\n },\n {\n \"kind\": \"series\",\n \"resolver\": \"x-ui-chart-metric-by-field\",\n \"description\": \"Metric-backed series definition in `metrics[]`, keyed by field.\"\n },\n {\n \"kind\": \"axis\",\n \"resolver\": \"x-ui-chart-dimension-or-metric-axis\",\n \"description\": \"Dimension role, metric axis and chart orientation semantics.\"\n },\n {\n \"kind\": \"dataBinding\",\n \"resolver\": \"x-ui-chart-source-and-field-catalog\",\n \"description\": \"Source, dimensions, metrics and resource/field bindings.\"\n },\n {\n \"kind\": \"queryContext\",\n \"resolver\": \"praxis-chart-query-context\",\n \"description\": \"Runtime queryContext contract for filters, sort, limit and page.\"\n },\n {\n \"kind\": \"crossFilter\",\n \"resolver\": \"x-ui-chart-events-cross-filter\",\n \"description\": \"Cross-filter event mapping emitted as structured query-context filters.\"\n },\n {\n \"kind\": \"drilldown\",\n \"resolver\": \"x-ui-chart-events-drill-down\",\n \"description\": \"Drilldown event mapping and governed target.\"\n },\n {\n \"kind\": \"selection\",\n \"resolver\": \"x-ui-chart-events-selection-change\",\n \"description\": \"Selection event enablement and mapping semantics.\"\n },\n {\n \"kind\": \"legend\",\n \"resolver\": \"x-ui-chart-legend-feature\",\n \"description\": \"Legend visibility through boolean or toggleable feature object.\"\n },\n {\n \"kind\": \"tooltip\",\n \"resolver\": \"x-ui-chart-tooltip-feature\",\n \"description\": \"Tooltip visibility through boolean or toggleable feature object.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"chart.document.set\",\n \"title\": \"Set chart document\",\n \"scope\": \"global\",\n \"targetKind\": \"dataBinding\",\n \"target\": {\n \"kind\": \"dataBinding\",\n \"resolver\": \"x-ui-chart-document-root\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"version\",\n \"kind\",\n \"source\"\n ],\n \"properties\": {\n \"version\": {\n \"const\": \"0.1.0\"\n },\n \"kind\": {\n \"enum\": [\n \"bar\",\n \"combo\",\n \"horizontal-bar\",\n \"line\",\n \"pie\",\n \"donut\",\n \"area\",\n \"stacked-bar\",\n \"stacked-area\",\n \"scatter\"\n ]\n },\n \"chartId\": {\n \"type\": \"string\"\n },\n \"title\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"subtitle\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"source\": {\n \"type\": \"object\",\n \"required\": [\n \"kind\"\n ],\n \"properties\": {\n \"kind\": {\n \"enum\": [\n \"praxis.stats\",\n \"derived\"\n ]\n },\n \"resource\": {\n \"type\": \"string\"\n },\n \"operation\": {\n \"enum\": [\n \"group-by\",\n \"timeseries\",\n \"distribution\"\n ]\n },\n \"options\": {\n \"type\": \"object\"\n }\n }\n },\n \"dimensions\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"metrics\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"events\": {\n \"type\": \"object\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"set-value\",\n \"path\": \"chartDocument\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"chart-document-shape\",\n \"chart-version-supported\",\n \"chart-type-series-axis-compatible\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"chart.type.set\",\n \"title\": \"Set chart type\",\n \"scope\": \"global\",\n \"targetKind\": \"chartType\",\n \"target\": {\n \"kind\": \"chartType\",\n \"resolver\": \"x-ui-chart-kind\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"kind\"\n ],\n \"properties\": {\n \"kind\": {\n \"enum\": [\n \"bar\",\n \"combo\",\n \"horizontal-bar\",\n \"line\",\n \"pie\",\n \"donut\",\n \"area\",\n \"stacked-bar\",\n \"stacked-area\",\n \"scatter\"\n ]\n },\n \"orientation\": {\n \"enum\": [\n \"vertical\",\n \"horizontal\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"chartDocument\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"chart-type-supported\",\n \"chart-type-series-axis-compatible\",\n \"pie-single-metric\",\n \"combo-minimum-series\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.kind\",\n \"chartDocument.orientation\",\n \"chartDocument.metrics[]\",\n \"chartDocument.dimensions[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"series.add\",\n \"title\": \"Add chart series\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"series\",\n \"target\": {\n \"kind\": \"series\",\n \"resolver\": \"x-ui-chart-metric-by-field\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"aggregation\": {\n \"enum\": [\n \"sum\",\n \"avg\",\n \"min\",\n \"max\",\n \"count\",\n \"distinct-count\"\n ]\n },\n \"seriesKind\": {\n \"enum\": [\n \"bar\",\n \"line\",\n \"area\"\n ]\n },\n \"axis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"color\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n },\n \"afterField\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-series-add\",\n \"handlerContract\": {\n \"reads\": [\n \"chartDocument.kind\",\n \"chartDocument.metrics[]\",\n \"availableFields[]\"\n ],\n \"writes\": [\n \"chartDocument.metrics[]\"\n ],\n \"identityKeys\": [\n \"chartDocument.metrics[].field\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"aggregation\": {\n \"enum\": [\n \"sum\",\n \"avg\",\n \"min\",\n \"max\",\n \"count\",\n \"distinct-count\"\n ]\n },\n \"seriesKind\": {\n \"enum\": [\n \"bar\",\n \"line\",\n \"area\"\n ]\n },\n \"axis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"color\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n },\n \"afterField\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"field-not-in-catalog\",\n \"duplicate-series-field\",\n \"aggregation-not-supported\",\n \"chart-type-series-incompatible\"\n ],\n \"description\": \"Adds a metric-backed series by semantic field, validating it against availableFields and chart kind compatibility before patching metrics[].\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"series-field-exists\",\n \"series-field-aggregable\",\n \"series-id-unique\",\n \"chart-type-series-axis-compatible\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.metrics[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"series.remove\",\n \"title\": \"Remove chart series\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"series\",\n \"target\": {\n \"kind\": \"series\",\n \"resolver\": \"x-ui-chart-metric-by-field\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"replacementField\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"remove-by-key\",\n \"path\": \"chartDocument.metrics[]\",\n \"key\": \"field\"\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"series-exists\",\n \"destructive-series-removal-confirmed\",\n \"chart-keeps-required-metric\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.metrics[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\",\n \"target-series-exists\",\n \"confirmation-collected\"\n ]\n },\n {\n \"operationId\": \"axis.configure\",\n \"title\": \"Configure chart axis\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"axis\",\n \"target\": {\n \"kind\": \"axis\",\n \"resolver\": \"x-ui-chart-dimension-or-metric-axis\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"dimensionField\": {\n \"type\": \"string\"\n },\n \"dimensionRole\": {\n \"enum\": [\n \"category\",\n \"series\",\n \"segment\",\n \"time\",\n \"value\"\n ]\n },\n \"metricField\": {\n \"type\": \"string\"\n },\n \"metricAxis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"orientation\": {\n \"enum\": [\n \"vertical\",\n \"horizontal\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-axis-configure\",\n \"handlerContract\": {\n \"reads\": [\n \"chartDocument.kind\",\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\",\n \"availableFields[]\"\n ],\n \"writes\": [\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\",\n \"chartDocument.orientation\"\n ],\n \"identityKeys\": [\n \"chartDocument.dimensions[].field\",\n \"chartDocument.metrics[].field\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"dimensionField\": {\n \"type\": \"string\"\n },\n \"dimensionRole\": {\n \"enum\": [\n \"category\",\n \"series\",\n \"segment\",\n \"time\",\n \"value\"\n ]\n },\n \"metricField\": {\n \"type\": \"string\"\n },\n \"metricAxis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"orientation\": {\n \"enum\": [\n \"vertical\",\n \"horizontal\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"field-not-in-catalog\",\n \"secondary-axis-non-combo\",\n \"missing-required-dimension\",\n \"axis-role-incompatible\"\n ],\n \"description\": \"Configures dimensions and metric axes using semantic fields, preserving combo-only secondary axis constraints.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"axis-field-exists\",\n \"secondary-axis-combo-only\",\n \"cartesian-dimension-required\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[].axis\",\n \"chartDocument.orientation\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"data.resource.bind\",\n \"title\": \"Bind chart data resource\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"dataBinding\",\n \"target\": {\n \"kind\": \"dataBinding\",\n \"resolver\": \"x-ui-chart-source-and-field-catalog\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"sourceKind\"\n ],\n \"properties\": {\n \"sourceKind\": {\n \"enum\": [\n \"praxis.stats\",\n \"derived\"\n ]\n },\n \"resource\": {\n \"type\": \"string\"\n },\n \"operation\": {\n \"enum\": [\n \"group-by\",\n \"timeseries\",\n \"distribution\"\n ]\n },\n \"dimensions\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"role\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"metrics\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"required\": [\n \"field\"\n ],\n \"properties\": {\n \"field\": {\n \"type\": \"string\"\n },\n \"label\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"object\"\n }\n ]\n },\n \"aggregation\": {\n \"enum\": [\n \"sum\",\n \"avg\",\n \"min\",\n \"max\",\n \"count\",\n \"distinct-count\"\n ]\n },\n \"seriesKind\": {\n \"enum\": [\n \"bar\",\n \"line\",\n \"area\"\n ]\n },\n \"axis\": {\n \"enum\": [\n \"primary\",\n \"secondary\"\n ]\n },\n \"color\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n },\n \"afterField\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-data-resource-bind\",\n \"handlerContract\": {\n \"reads\": [\n \"availableResources[]\",\n \"availableFields[]\",\n \"chartDocument.source\",\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\"\n ],\n \"writes\": [\n \"chartDocument.source\",\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\"\n ],\n \"identityKeys\": [\n \"availableResources[].path\",\n \"availableResources[].id\",\n \"availableFields[].field\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"sourceKind\"\n ],\n \"properties\": {\n \"sourceKind\": {\n \"enum\": [\n \"praxis.stats\",\n \"derived\"\n ]\n },\n \"resource\": {\n \"type\": \"string\"\n },\n \"operation\": {\n \"enum\": [\n \"group-by\",\n \"timeseries\",\n \"distribution\"\n ]\n },\n \"dimensions\": {\n \"type\": \"array\"\n },\n \"metrics\": {\n \"type\": \"array\"\n }\n }\n },\n \"failureModes\": [\n \"resource-not-in-api-metadata\",\n \"field-not-in-schema\",\n \"stats-operation-not-supported\",\n \"remote-binding-incomplete\"\n ],\n \"description\": \"Binds a derived or praxis.stats source using the governed resource and field catalogs instead of free-form prompt examples.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"remote-resource-in-api-metadata\",\n \"bound-fields-exist\",\n \"stats-operation-supported\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.source\",\n \"chartDocument.dimensions[]\",\n \"chartDocument.metrics[]\"\n ],\n \"submissionImpact\": \"affects-remote-binding\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"queryContext.set\",\n \"title\": \"Set chart query context\",\n \"scope\": \"dataBinding\",\n \"targetKind\": \"queryContext\",\n \"target\": {\n \"kind\": \"queryContext\",\n \"resolver\": \"praxis-chart-query-context\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"filters\": {\n \"type\": \"object\"\n },\n \"sort\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"limit\": {\n \"type\": \"number\"\n },\n \"page\": {\n \"type\": \"object\"\n },\n \"meta\": {\n \"type\": \"object\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"set-value\",\n \"path\": \"queryContext\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"query-context-structured\",\n \"query-context-fields-exist\",\n \"query-context-safe-values\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"queryContext\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"crossFilter.configure\",\n \"title\": \"Configure chart cross-filter\",\n \"scope\": \"eventMapping\",\n \"targetKind\": \"crossFilter\",\n \"target\": {\n \"kind\": \"crossFilter\",\n \"resolver\": \"x-ui-chart-events-cross-filter\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-event-cross-filter-configure\",\n \"handlerContract\": {\n \"reads\": [\n \"chartDocument.events.crossFilter\",\n \"chartDocument.dimensions[]\",\n \"availableTargets[]\"\n ],\n \"writes\": [\n \"chartDocument.events.crossFilter\"\n ],\n \"identityKeys\": [\n \"availableTargets[].id\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"target-not-in-catalog\",\n \"mapping-source-field-missing\",\n \"mapping-target-invalid\",\n \"unsafe-event-action\"\n ],\n \"description\": \"Configures crossFilter as a structured event action that emits safe query-context filters to a governed target.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"cross-filter-output-structured\",\n \"event-target-governed\",\n \"event-mapping-fields-exist\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.events.crossFilter\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"drilldown.configure\",\n \"title\": \"Configure chart drilldown\",\n \"scope\": \"eventMapping\",\n \"targetKind\": \"drilldown\",\n \"target\": {\n \"kind\": \"drilldown\",\n \"resolver\": \"x-ui-chart-events-drill-down\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"chart-event-drilldown-configure\",\n \"handlerContract\": {\n \"reads\": [\n \"chartDocument.events.drillDown\",\n \"chartDocument.dimensions[]\",\n \"availableTargets[]\"\n ],\n \"writes\": [\n \"chartDocument.events.drillDown\"\n ],\n \"identityKeys\": [\n \"availableTargets[].id\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"target-not-in-catalog\",\n \"mapping-source-field-missing\",\n \"drilldown-target-invalid\",\n \"unsafe-event-action\"\n ],\n \"description\": \"Configures drillDown through governed route/widget targets and structured field mappings.\"\n }\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"drilldown-target-governed\",\n \"event-mapping-fields-exist\",\n \"event-action-supported\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.events.drillDown\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"selection.configure\",\n \"title\": \"Configure chart selection\",\n \"scope\": \"selection\",\n \"targetKind\": \"selection\",\n \"target\": {\n \"kind\": \"selection\",\n \"resolver\": \"x-ui-chart-events-selection-change\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"event\",\n \"action\"\n ],\n \"properties\": {\n \"event\": {\n \"enum\": [\n \"pointClick\",\n \"selectionChange\",\n \"drillDown\",\n \"crossFilter\"\n ]\n },\n \"action\": {\n \"enum\": [\n \"filter-widget\",\n \"open-detail\",\n \"navigate\",\n \"update-context\",\n \"emit\"\n ]\n },\n \"target\": {\n \"type\": \"string\"\n },\n \"mapping\": {\n \"type\": \"object\",\n \"additionalProperties\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"chartDocument.events.selectionChange\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"selection-output-structured\",\n \"event-mapping-fields-exist\",\n \"event-action-supported\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.events.selectionChange\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"legend.configure\",\n \"title\": \"Configure chart legend\",\n \"scope\": \"skin\",\n \"targetKind\": \"legend\",\n \"target\": {\n \"kind\": \"legend\",\n \"resolver\": \"x-ui-chart-legend-feature\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"enabled\"\n ],\n \"properties\": {\n \"enabled\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"set-value\",\n \"path\": \"chartDocument.legend\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"feature-toggle-valid\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.legend\"\n ],\n \"submissionImpact\": \"visual-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n },\n {\n \"operationId\": \"tooltip.configure\",\n \"title\": \"Configure chart tooltip\",\n \"scope\": \"skin\",\n \"targetKind\": \"tooltip\",\n \"target\": {\n \"kind\": \"tooltip\",\n \"resolver\": \"x-ui-chart-tooltip-feature\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"enabled\"\n ],\n \"properties\": {\n \"enabled\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"set-value\",\n \"path\": \"chartDocument.tooltip\"\n }\n ],\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"validators\": [\n \"feature-toggle-valid\",\n \"editor-runtime-round-trip\"\n ],\n \"affectedPaths\": [\n \"chartDocument.tooltip\"\n ],\n \"submissionImpact\": \"visual-only\",\n \"preconditions\": [\n \"config-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"chart-document-shape\",\n \"level\": \"error\",\n \"code\": \"CHART_DOCUMENT_SHAPE\",\n \"description\": \"Document must conform to PraxisXUiChartContract.\"\n },\n {\n \"validatorId\": \"chart-version-supported\",\n \"level\": \"error\",\n \"code\": \"CHART_VERSION_SUPPORTED\",\n \"description\": \"Only x-ui.chart version 0.1.0 is authorable.\"\n },\n {\n \"validatorId\": \"chart-type-supported\",\n \"level\": \"error\",\n \"code\": \"CHART_TYPE_SUPPORTED\",\n \"description\": \"Chart kind must be supported by @praxisui/charts.\"\n },\n {\n \"validatorId\": \"chart-type-series-axis-compatible\",\n \"level\": \"error\",\n \"code\": \"CHART_TYPE_SERIES_AXIS_COMPATIBLE\",\n \"description\": \"Chart kind, dimensions, metrics and axes must be compatible.\"\n },\n {\n \"validatorId\": \"pie-single-metric\",\n \"level\": \"error\",\n \"code\": \"PIE_SINGLE_METRIC\",\n \"description\": \"Pie and donut charts support a single metric.\"\n },\n {\n \"validatorId\": \"combo-minimum-series\",\n \"level\": \"error\",\n \"code\": \"COMBO_MINIMUM_SERIES\",\n \"description\": \"Combo charts require at least two metrics.\"\n },\n {\n \"validatorId\": \"series-field-exists\",\n \"level\": \"error\",\n \"code\": \"SERIES_FIELD_EXISTS\",\n \"description\": \"Series field must exist in availableFields or schema context.\"\n },\n {\n \"validatorId\": \"series-field-aggregable\",\n \"level\": \"error\",\n \"code\": \"SERIES_FIELD_AGGREGABLE\",\n \"description\": \"Metric fields must support the requested aggregation.\"\n },\n {\n \"validatorId\": \"series-id-unique\",\n \"level\": \"error\",\n \"code\": \"SERIES_ID_UNIQUE\",\n \"description\": \"Metric/series identity must be stable and unique by field.\"\n },\n {\n \"validatorId\": \"series-exists\",\n \"level\": \"error\",\n \"code\": \"SERIES_EXISTS\",\n \"description\": \"Series removal target must exist.\"\n },\n {\n \"validatorId\": \"destructive-series-removal-confirmed\",\n \"level\": \"error\",\n \"code\": \"DESTRUCTIVE_SERIES_REMOVAL_CONFIRMED\",\n \"description\": \"Removing a series requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"chart-keeps-required-metric\",\n \"level\": \"error\",\n \"code\": \"CHART_KEEPS_REQUIRED_METRIC\",\n \"description\": \"A chart cannot be left without required metrics.\"\n },\n {\n \"validatorId\": \"axis-field-exists\",\n \"level\": \"error\",\n \"code\": \"AXIS_FIELD_EXISTS\",\n \"description\": \"Axis/dimension fields must exist in availableFields or schema context.\"\n },\n {\n \"validatorId\": \"secondary-axis-combo-only\",\n \"level\": \"error\",\n \"code\": \"SECONDARY_AXIS_COMBO_ONLY\",\n \"description\": \"Secondary axis is supported only for combo charts.\"\n },\n {\n \"validatorId\": \"cartesian-dimension-required\",\n \"level\": \"error\",\n \"code\": \"CARTESIAN_DIMENSION_REQUIRED\",\n \"description\": \"Cartesian charts require at least one dimension.\"\n },\n {\n \"validatorId\": \"remote-resource-in-api-metadata\",\n \"level\": \"error\",\n \"code\": \"REMOTE_RESOURCE_IN_API_METADATA\",\n \"description\": \"Remote praxis.stats resource must come from the governed API metadata/resource catalog.\"\n },\n {\n \"validatorId\": \"bound-fields-exist\",\n \"level\": \"error\",\n \"code\": \"BOUND_FIELDS_EXIST\",\n \"description\": \"Bound dimensions and metrics must exist in the schema/data context.\"\n },\n {\n \"validatorId\": \"stats-operation-supported\",\n \"level\": \"error\",\n \"code\": \"STATS_OPERATION_SUPPORTED\",\n \"description\": \"Remote datasource operation must be supported by the stats backend.\"\n },\n {\n \"validatorId\": \"query-context-structured\",\n \"level\": \"error\",\n \"code\": \"QUERY_CONTEXT_STRUCTURED\",\n \"description\": \"queryContext must use structured filters, sort, limit and page fields.\"\n },\n {\n \"validatorId\": \"query-context-fields-exist\",\n \"level\": \"warning\",\n \"code\": \"QUERY_CONTEXT_FIELDS_EXIST\",\n \"description\": \"queryContext filter fields should exist in the schema/data context.\"\n },\n {\n \"validatorId\": \"query-context-safe-values\",\n \"level\": \"error\",\n \"code\": \"QUERY_CONTEXT_SAFE_VALUES\",\n \"description\": \"queryContext values must be serializable safe data.\"\n },\n {\n \"validatorId\": \"cross-filter-output-structured\",\n \"level\": \"error\",\n \"code\": \"CROSS_FILTER_OUTPUT_STRUCTURED\",\n \"description\": \"Cross-filter output must be structured as query-context filters.\"\n },\n {\n \"validatorId\": \"event-target-governed\",\n \"level\": \"error\",\n \"code\": \"EVENT_TARGET_GOVERNED\",\n \"description\": \"Event targets must be selected from availableTargets or an approved host catalog.\"\n },\n {\n \"validatorId\": \"event-mapping-fields-exist\",\n \"level\": \"error\",\n \"code\": \"EVENT_MAPPING_FIELDS_EXIST\",\n \"description\": \"Event mapping source fields must exist in chart data context.\"\n },\n {\n \"validatorId\": \"event-action-supported\",\n \"level\": \"error\",\n \"code\": \"EVENT_ACTION_SUPPORTED\",\n \"description\": \"Event action must be one of the supported structured action kinds.\"\n },\n {\n \"validatorId\": \"drilldown-target-governed\",\n \"level\": \"error\",\n \"code\": \"DRILLDOWN_TARGET_GOVERNED\",\n \"description\": \"Drilldown target must be a governed route or widget target.\"\n },\n {\n \"validatorId\": \"selection-output-structured\",\n \"level\": \"error\",\n \"code\": \"SELECTION_OUTPUT_STRUCTURED\",\n \"description\": \"Selection output must resolve selected point filters deterministically.\"\n },\n {\n \"validatorId\": \"feature-toggle-valid\",\n \"level\": \"error\",\n \"code\": \"FEATURE_TOGGLE_VALID\",\n \"description\": \"Legend and tooltip feature values must be boolean or toggleable feature objects.\"\n },\n {\n \"validatorId\": \"editor-runtime-round-trip\",\n \"level\": \"error\",\n \"code\": \"EDITOR_RUNTIME_ROUND_TRIP\",\n \"description\": \"PraxisChartConfigEditor must save/reopen the same canonical document that runtime consumes.\"\n }\n ],\n \"roundTripRequirements\": [\n \"The canonical saved shape is PraxisXUiChartContract, not raw ECharts options.\",\n \"PraxisChartConfigEditor must preserve chart kind, source, dimensions, metrics, events, legend and tooltip across apply/save/reset/reopen.\",\n \"Remote bindings must be resolved from availableResources/API metadata and availableFields/schema context.\",\n \"Cross-filter, drilldown and selection authoring must persist structured event actions, not prompt examples or command strings.\"\n ],\n \"examples\": [\n {\n \"id\": \"set-bar-chart\",\n \"request\": \"Use a bar chart for employees by department.\",\n \"operationId\": \"chart.type.set\",\n \"params\": {\n \"kind\": \"bar\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-salary-series\",\n \"request\": \"Add salary as a summed metric.\",\n \"operationId\": \"series.add\",\n \"params\": {\n \"field\": \"salary\",\n \"aggregation\": \"sum\",\n \"label\": \"Salary\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-old-series\",\n \"request\": \"Remove the old cost series.\",\n \"operationId\": \"series.remove\",\n \"target\": \"cost\",\n \"params\": {\n \"field\": \"cost\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-secondary-axis\",\n \"request\": \"Put margin on a secondary axis for the combo chart.\",\n \"operationId\": \"axis.configure\",\n \"params\": {\n \"metricField\": \"margin\",\n \"metricAxis\": \"secondary\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"bind-stats-resource\",\n \"request\": \"Bind this chart to payroll stats grouped by department.\",\n \"operationId\": \"data.resource.bind\",\n \"params\": {\n \"sourceKind\": \"praxis.stats\",\n \"resource\": \"/api/stats/payroll\",\n \"operation\": \"group-by\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-query-context\",\n \"request\": \"Limit the chart to active employees and sort by total descending.\",\n \"operationId\": \"queryContext.set\",\n \"params\": {\n \"filters\": {\n \"status\": \"ACTIVE\"\n },\n \"sort\": [\n \"total,desc\"\n ],\n \"limit\": 10\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-cross-filter\",\n \"request\": \"Use selected department to filter the employee table.\",\n \"operationId\": \"crossFilter.configure\",\n \"params\": {\n \"event\": \"crossFilter\",\n \"action\": \"filter-widget\",\n \"target\": \"employeesTable\",\n \"mapping\": {\n \"department\": \"department\"\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-drilldown\",\n \"request\": \"Open the department detail when a point is clicked.\",\n \"operationId\": \"drilldown.configure\",\n \"params\": {\n \"event\": \"drillDown\",\n \"action\": \"navigate\",\n \"target\": \"/departments/detail\",\n \"mapping\": {\n \"department\": \"departmentId\"\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"configure-selection\",\n \"request\": \"Emit selected department as a structured selection event.\",\n \"operationId\": \"selection.configure\",\n \"params\": {\n \"event\": \"selectionChange\",\n \"action\": \"emit\",\n \"mapping\": {\n \"department\": \"department\"\n }\n },\n \"isPositive\": true\n },\n {\n \"id\": \"toggle-legend\",\n \"request\": \"Show the legend.\",\n \"operationId\": \"legend.configure\",\n \"params\": {\n \"enabled\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"toggle-tooltip\",\n \"request\": \"Disable tooltips.\",\n \"operationId\": \"tooltip.configure\",\n \"params\": {\n \"enabled\": false\n },\n \"isPositive\": true\n },\n {\n \"id\": \"round-trip-editor-runtime\",\n \"request\": \"Save this chart in the editor and reopen it without changing the runtime chart document.\",\n \"operationId\": \"chart.document.set\",\n \"params\": {\n \"version\": \"0.1.0\",\n \"kind\": \"bar\",\n \"source\": {\n \"kind\": \"derived\"\n },\n \"dimensions\": [\n {\n \"field\": \"department\"\n }\n ],\n \"metrics\": [\n {\n \"field\": \"total\",\n \"aggregation\": \"count\"\n }\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-ambiguous-series-target\",\n \"request\": \"Remove total when more than one chart series resolves to total.\",\n \"operationId\": \"series.remove\",\n \"target\": \"total\",\n \"params\": {\n \"field\": \"total\"\n },\n \"isPositive\": false\n },\n {\n \"id\": \"reject-prompt-routing\",\n \"request\": \"Use the prompt example text to decide which backend endpoint to call.\",\n \"operationId\": \"data.resource.bind\",\n \"params\": {\n \"sourceKind\": \"praxis.stats\",\n \"resource\": \"from prompt example\"\n },\n \"isPositive\": false\n },\n {\n \"id\": \"reject-unsafe-target\",\n \"request\": \"Navigate to javascript:alert(1) on drilldown.\",\n \"operationId\": \"drilldown.configure\",\n \"params\": {\n \"event\": \"drillDown\",\n \"action\": \"navigate\",\n \"target\": \"javascript:alert(1)\"\n },\n \"isPositive\": false\n }\n ]\n}",
1757
1757
  "sourcePointer": "praxis-ui-angular/projects/praxis-charts/src/lib/ai/praxis-charts-authoring-manifest.ts",
1758
- "contentHash": "67ba025af58a8536d5e237f49b11c7924b29d25c6ae7e782c97e64e309c5e468",
1758
+ "contentHash": "ac5ab33ce5501ff1fb3f9de4b45f09b72e6ede7b1ea74050d36bfef0a8380d9c",
1759
1759
  "sourceKind": "component_definition",
1760
1760
  "sourceId": "praxis-chart",
1761
1761
  "corpusVersion": "1.0.0"