@praxisui/charts 9.0.0-beta.74 → 9.0.0-beta.76

package/README.md

@@ -159,6 +159,36 @@ const chartDocument: PraxisXUiChartContract = {
 };
 ```
 
+Governed period comparisons use the same document and the canonical `comparison` stats operation. The resource must publish `canonicalOperations.statsComparison=true`; the dimension must be group-by eligible, the period field time-series eligible, and metrics are limited to `count`, `distinct-count`, or `sum` as declared by capabilities.
+
+```ts
+const comparisonDocument: PraxisXUiChartContract = {
+  version: '0.1.0',
+  kind: 'bar',
+  chartId: 'employees-by-department-comparison',
+  source: {
+    kind: 'praxis.stats',
+    resource: '/api/human-resources/employees',
+    operation: 'comparison',
+    options: {
+      comparisonPeriod: {
+        field: 'admissionDate',
+        timezone: 'America/Sao_Paulo',
+        preset: 'LAST_30_DAYS',
+        mode: 'PREVIOUS_ALIGNED',
+      },
+    },
+  },
+  dimensions: [{ field: 'department' }],
+  metrics: [
+    { field: 'employeeId', aggregation: 'distinct-count', label: 'Employees' },
+    { field: 'absenceDays', aggregation: 'sum', label: 'Absence days' },
+  ],
+};
+```
+
+The mapper emits one `POST /stats/comparison` request with canonical `metrics[]`; it never downgrades the document into independent period requests or a singular `metric`. Each governed metric is materialized as current and previous display series.
+
 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.
 
 ## Micro Visualizations
@@ -189,6 +219,8 @@ Rich charts still use the canonical `x-ui.chart` document flow above; micro visu
 
 `PraxisChartConfigEditor` is the initial editor shell for canonical `x-ui.chart` documents. It consumes governed resources, fields and targets 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.
 
+`ChartResourceCapabilityCatalogAdapter` derives resource operations and eligible dimension, time and metric options directly from `ResourceCapabilitySnapshot`, including fail-closed comparison eligibility.
+
 Applications should install `providePraxisCharts()` once. The registered `ComponentDocMeta.configEditor.contextResolver` materializes the editor context without making Page Builder own Chart semantics. Initial resolution groups `/schemas/catalog` endpoints by the stable `resourceKey`, exposes that value as `availableResources[].id`, and keeps the catalog's governed root-relative resource path as `availableResources[].path`. A selected `praxis.stats` source is normalized to that operational path before save; the discovery id is never persisted as an executable URL.
 
 Capabilities are loaded lazily from the exact catalog-published endpoint only after resource selection. Concurrent catalog and per-resource capability reads are deduplicated in flight and bounded by a 10-second timeout, but successful permission-sensitive projections are not cached across requests until the host publishes a canonical authentication/context epoch. Denied, unavailable, ambiguous, stale and empty evidence fails closed, and later requests remain retryable. `canonicalOperations` gates group-by, timeseries and distribution, while `stats.fields[]` gates dimensions, metrics, aggregations and exact `distributionModes` eligibility for terms versus histogram. `/schemas/filtered` enrichment of field titles, types and `x-ui` remains a later schema-flow gate; capabilities remain the authority for eligibility.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-16T21:05:04.797Z",
+  "generatedAt": "2026-07-17T20:02:53.244Z",
   "packageName": "@praxisui/charts",
-  "packageVersion": "9.0.0-beta.74",
+  "packageVersion": "9.0.0-beta.76",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -502,7 +502,7 @@
         "componentId": "praxis-chart",
         "ownerPackage": "@praxisui/charts",
         "configSchemaId": "PraxisXUiChartContract",
-        "manifestVersion": "1.0.0",
+        "manifestVersion": "1.1.0",
         "runtimeInputs": [
           {
             "name": "chartDocument",
@@ -676,11 +676,49 @@
                       "enum": [
                         "group-by",
                         "timeseries",
-                        "distribution"
+                        "distribution",
+                        "comparison"
                       ]
                     },
                     "options": {
-                      "type": "object"
+                      "type": "object",
+                      "properties": {
+                        "comparisonPeriod": {
+                          "type": "object",
+                          "required": [
+                            "field",
+                            "timezone",
+                            "preset",
+                            "mode"
+                          ],
+                          "properties": {
+                            "field": {
+                              "type": "string"
+                            },
+                            "timezone": {
+                              "type": "string"
+                            },
+                            "preset": {
+                              "enum": [
+                                "TODAY",
+                                "YESTERDAY",
+                                "LAST_7_DAYS",
+                                "LAST_30_DAYS",
+                                "THIS_MONTH",
+                                "LAST_MONTH",
+                                "THIS_QUARTER",
+                                "THIS_YEAR"
+                              ]
+                            },
+                            "mode": {
+                              "enum": [
+                                "PREVIOUS_ALIGNED",
+                                "PREVIOUS_CALENDAR_PERIOD"
+                              ]
+                            }
+                          }
+                        }
+                      }
                     }
                   }
                 },
@@ -1148,13 +1186,7 @@
                   "type": "string",
                   "pattern": "^/(?!/)"
                 },
-                "operation": {
-                  "enum": [
-                    "group-by",
-                    "timeseries",
-                    "distribution"
-                  ]
-                },
+                "operation": {},
                 "dimensions": {
                   "type": "array",
                   "items": {
@@ -1244,6 +1276,7 @@
                   ],
                   "writes": [
                     "chartDocument.source",
+                    "chartDocument.source.options.comparisonPeriod",
                     "chartDocument.dimensions[]",
                     "chartDocument.metrics[]"
                   ],
@@ -1267,13 +1300,7 @@
                         "type": "string",
                         "pattern": "^/(?!/)"
                       },
-                      "operation": {
-                        "enum": [
-                          "group-by",
-                          "timeseries",
-                          "distribution"
-                        ]
-                      },
+                      "operation": {},
                       "dimensions": {
                         "type": "array"
                       },
@@ -1286,9 +1313,11 @@
                     "resource-not-in-api-metadata",
                     "field-not-in-schema",
                     "stats-operation-not-supported",
+                    "comparison-period-incomplete",
+                    "comparison-metric-unsupported",
                     "remote-binding-incomplete"
                   ],
-                  "description": "Binds a derived or praxis.stats source using governed catalogs. For praxis.stats, availableResources[].id is discovery-only: validation requires the matching availableResources[].path and compilation persists that path as chartDocument.source.resource."
+                  "description": "Binds a derived or praxis.stats source using governed resource, capability and field catalogs. For praxis.stats, availableResources[].id is discovery-only: validation requires the matching availableResources[].path and compilation persists that path. Comparison requires one canonical operation, metrics[] and an eligible period field."
                 }
               }
             ],
@@ -1298,10 +1327,13 @@
               "remote-resource-in-api-metadata",
               "bound-fields-exist",
               "stats-operation-supported",
+              "comparison-period-complete",
+              "comparison-metrics-supported",
               "editor-runtime-round-trip"
             ],
             "affectedPaths": [
               "chartDocument.source",
+              "chartDocument.source.options.comparisonPeriod",
               "chartDocument.dimensions[]",
               "chartDocument.metrics[]"
             ],
@@ -1985,6 +2017,18 @@
             "code": "STATS_OPERATION_SUPPORTED",
             "description": "Remote datasource operation must be supported by the stats backend."
           },
+          {
+            "validatorId": "comparison-period-complete",
+            "level": "error",
+            "code": "COMPARISON_PERIOD_COMPLETE",
+            "description": "Comparison requires a time-series eligible period field, timezone, preset and mode grounded in the governed resource capabilities."
+          },
+          {
+            "validatorId": "comparison-metrics-supported",
+            "level": "error",
+            "code": "COMPARISON_METRICS_SUPPORTED",
+            "description": "Comparison requires unique metrics[] aliases using only COUNT, DISTINCT_COUNT or SUM capabilities; singular metric payloads are not authorable."
+          },
           {
             "validatorId": "query-context-structured",
             "level": "error",
@@ -2068,6 +2112,7 @@
           "The canonical saved shape is PraxisXUiChartContract, not raw ECharts options.",
           "PraxisChartConfigEditor must preserve chart kind, source, dimensions, metrics, events, legend and tooltip across apply/save/reset/reopen.",
           "Remote bindings persist availableResources[].path; availableResources[].id remains discovery identity, and transient resource/field/target catalogs and diagnostics are never persisted in widget inputs.",
+          "Comparison must preserve one canonical /stats/comparison request with metrics[] and a complete comparisonPeriod; it must not downgrade into independent group-by calls.",
           "Cross-filter, drilldown and selection authoring must persist structured event actions, not prompt examples or command strings.",
           "[P1] Backend handler, resolver and validators now execute directly; end-to-end Page Builder parity remains open until assistant requests project the transient availableTargets[].events catalog through validationContext and expose its fail-closed diagnostics.",
           "[P2] Transform-output semantics and target input-schema/port fields must be materialized and validated by Core; local transform.output inspection and backend-enriched inputFields are not substitutes for those canonical projections.",
@@ -2125,6 +2170,34 @@
             },
             "isPositive": true
           },
+          {
+            "id": "bind-comparison-resource",
+            "request": "Compare active employees by department with the previous aligned 30-day period.",
+            "operationId": "data.resource.bind",
+            "params": {
+              "sourceKind": "praxis.stats",
+              "resource": "/api/human-resources/employees",
+              "operation": "comparison",
+              "comparisonPeriod": {
+                "field": "admissionDate",
+                "timezone": "America/Sao_Paulo",
+                "preset": "LAST_30_DAYS",
+                "mode": "PREVIOUS_ALIGNED"
+              },
+              "dimensions": [
+                {
+                  "field": "department"
+                }
+              ],
+              "metrics": [
+                {
+                  "field": "employeeId",
+                  "aggregation": "distinct-count"
+                }
+              ]
+            },
+            "isPositive": true
+          },
           {
             "id": "set-query-context",
             "request": "Limit the chart to active employees and sort by total descending.",
@@ -2279,9 +2352,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "authoring_manifest",
-          "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\": \"Canonical @praxisui/core query context observed by remote datasource requests; flat filters execute in praxis.stats and governed filterExpression is preserved but rejected until stats expression support is proven.\"\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\": \"Transient authoring catalog: id is the stable /schemas/catalog discovery identity, while path is the governed root-relative operational value persisted to chartDocument.source.resource.\"\n    },\n    {\n      \"name\": \"availableFields\",\n      \"type\": \"ChartEditorFieldOption[]\",\n      \"description\": \"Transient capability-backed field catalog. operations, aggregations and distributionModes declare exact group-by, timeseries, distribution/terms and distribution/histogram eligibility.\"\n    },\n    {\n      \"name\": \"availableTargets\",\n      \"type\": \"ChartEditorTargetOption[]\",\n      \"description\": \"Transient visual-authoring targets derived from existing top-level composition links to public, non-deprecated widget ports or explicitly writable declared page state; id is the unique authoring identity and events[] declares the exact structured Chart events authorized by compatible links. Raw pointClick evidence never authorizes events.pointClick, which is emitted through pointAction. Local transform.output semantic-kind inspection does not replace a Core-validated transform-output projection (P2), and the visual catalog does not yet publish the target input-schema/port projection required for end-to-end mapping validation.\"\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 @praxisui/core queryContext contract for filters, filterExpression, sort, limit, page and governance metadata.\"\n    },\n    {\n      \"kind\": \"pointClick\",\n      \"resolver\": \"x-ui-chart-events-point-click\",\n      \"description\": \"Raw pointClick evidence plus a separate pointAction output for configured pointClick actions.\"\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\": \"Single-point selection event enablement and mapping semantics; toggle and multi-select are intentionally not advertised.\"\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            \"pattern\": \"^/(?!/)\"\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              \"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                  \"pattern\": \"^/(?!/)\"\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 governed catalogs. For praxis.stats, availableResources[].id is discovery-only: validation requires the matching availableResources[].path and compilation persists that path as chartDocument.source.resource.\"\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          \"filterExpression\": {\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-filter-expression-stats-unsupported\",\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\": \"pointClick.configure\",\n      \"title\": \"Configure chart point click\",\n      \"scope\": \"eventMapping\",\n      \"targetKind\": \"pointClick\",\n      \"target\": {\n        \"kind\": \"pointClick\",\n        \"resolver\": \"x-ui-chart-events-point-click\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"action\"\n        ],\n        \"properties\": {\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-point-click-configure\",\n          \"handlerContract\": {\n            \"reads\": [\n              \"chartDocument.events.pointClick\",\n              \"chartDocument.dimensions[]\",\n              \"availableTargets[]\"\n            ],\n            \"writes\": [\n              \"chartDocument.events.pointClick\"\n            ],\n            \"identityKeys\": [\n              \"availableTargets[].id\"\n            ],\n            \"inputSchema\": {\n              \"type\": \"object\",\n              \"required\": [\n                \"action\"\n              ],\n              \"properties\": {\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 pointClick through the pointAction output while keeping pointClick as raw point evidence.\"\n          }\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"point-click-action-structured\",\n        \"event-target-governed\",\n        \"event-mapping-fields-exist\",\n        \"event-action-supported\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"chartDocument.events.pointClick\"\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          \"action\"\n        ],\n        \"properties\": {\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                \"action\"\n              ],\n              \"properties\": {\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 emitted through the crossFilter output with safe query-context filters to a governed target. For praxis.stats rows, key is governed bucket identity and label is presentation evidence; mappings may use key when the target schema accepts that identity.\"\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          \"action\"\n        ],\n        \"properties\": {\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                \"action\"\n              ],\n              \"properties\": {\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 the dedicated drillDown output with 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          \"action\"\n        ],\n        \"properties\": {\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-selection-configure\",\n          \"handlerContract\": {\n            \"reads\": [\n              \"chartDocument.events.selectionChange\",\n              \"chartDocument.dimensions[]\",\n              \"availableTargets[]\"\n            ],\n            \"writes\": [\n              \"chartDocument.events.selectionChange\"\n            ],\n            \"identityKeys\": [\n              \"availableTargets[].id\"\n            ],\n            \"inputSchema\": {\n              \"type\": \"object\",\n              \"required\": [\n                \"action\"\n              ],\n              \"properties\": {\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 selectionChange as single-point selection evidence whose event key is governed by the operation.\"\n          }\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"selection-output-structured\",\n        \"event-target-governed\",\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    },\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 equal a governed root-relative availableResources[].path beginning with exactly one slash; a discovery id is not an executable resource path.\"\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 capability-backed field context and satisfy its operation, aggregation and distribution-mode eligibility.\"\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 the canonical @praxisui/core structure for filters, filterExpression, sort, limit, page and meta.\"\n    },\n    {\n      \"validatorId\": \"query-context-filter-expression-stats-unsupported\",\n      \"level\": \"error\",\n      \"code\": \"QUERY_CONTEXT_FILTER_EXPRESSION_STATS_UNSUPPORTED\",\n      \"description\": \"praxis.stats currently executes only flat queryContext.filters; governed filterExpression must be preserved for diagnostics and rejected until backend expression support is declared.\"\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\": \"point-click-action-structured\",\n      \"level\": \"error\",\n      \"code\": \"POINT_CLICK_ACTION_STRUCTURED\",\n      \"description\": \"Configured pointClick actions must be emitted through pointAction while pointClick remains raw point evidence.\"\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 resolve to exactly one availableTargets[].id and declare the authored event plus action; missing, duplicate or cross-event identities fail closed.\"\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; praxis.stats reserves key for bucket identity and label for presentation.\"\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 persist availableResources[].path; availableResources[].id remains discovery identity, and transient resource/field/target catalogs and diagnostics are never persisted in widget inputs.\",\n    \"Cross-filter, drilldown and selection authoring must persist structured event actions, not prompt examples or command strings.\",\n    \"[P1] Backend handler, resolver and validators now execute directly; end-to-end Page Builder parity remains open until assistant requests project the transient availableTargets[].events catalog through validationContext and expose its fail-closed diagnostics.\",\n    \"[P2] Transform-output semantics and target input-schema/port fields must be materialized and validated by Core; local transform.output inspection and backend-enriched inputFields are not substitutes for those canonical projections.\",\n    \"Enrichment of capability-backed availableFields with /schemas/filtered property metadata remains a later schema-flow gate.\"\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        \"action\": \"filter-widget\",\n        \"target\": \"employeesTable\",\n        \"mapping\": {\n          \"department\": \"department\"\n        }\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"configure-stats-key-cross-filter\",\n      \"request\": \"Use the governed department bucket identity to filter the employee table.\",\n      \"operationId\": \"crossFilter.configure\",\n      \"params\": {\n        \"action\": \"filter-widget\",\n        \"target\": \"employeesTable\",\n        \"mapping\": {\n          \"key\": \"departmentIdsIn\"\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        \"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        \"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        \"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}",
+          "content": "{\n  \"schemaVersion\": \"1.0.0\",\n  \"componentId\": \"praxis-chart\",\n  \"ownerPackage\": \"@praxisui/charts\",\n  \"configSchemaId\": \"PraxisXUiChartContract\",\n  \"manifestVersion\": \"1.1.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\": \"Canonical @praxisui/core query context observed by remote datasource requests; flat filters execute in praxis.stats and governed filterExpression is preserved but rejected until stats expression support is proven.\"\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\": \"Transient authoring catalog: id is the stable /schemas/catalog discovery identity, while path is the governed root-relative operational value persisted to chartDocument.source.resource.\"\n    },\n    {\n      \"name\": \"availableFields\",\n      \"type\": \"ChartEditorFieldOption[]\",\n      \"description\": \"Transient capability-backed field catalog. operations, aggregations and distributionModes declare exact group-by, timeseries, distribution/terms and distribution/histogram eligibility.\"\n    },\n    {\n      \"name\": \"availableTargets\",\n      \"type\": \"ChartEditorTargetOption[]\",\n      \"description\": \"Transient visual-authoring targets derived from existing top-level composition links to public, non-deprecated widget ports or explicitly writable declared page state; id is the unique authoring identity and events[] declares the exact structured Chart events authorized by compatible links. Raw pointClick evidence never authorizes events.pointClick, which is emitted through pointAction. Local transform.output semantic-kind inspection does not replace a Core-validated transform-output projection (P2), and the visual catalog does not yet publish the target input-schema/port projection required for end-to-end mapping validation.\"\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 @praxisui/core queryContext contract for filters, filterExpression, sort, limit, page and governance metadata.\"\n    },\n    {\n      \"kind\": \"pointClick\",\n      \"resolver\": \"x-ui-chart-events-point-click\",\n      \"description\": \"Raw pointClick evidence plus a separate pointAction output for configured pointClick actions.\"\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\": \"Single-point selection event enablement and mapping semantics; toggle and multi-select are intentionally not advertised.\"\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                  \"comparison\"\n                ]\n              },\n              \"options\": {\n                \"type\": \"object\",\n                \"properties\": {\n                  \"comparisonPeriod\": {\n                    \"type\": \"object\",\n                    \"required\": [\n                      \"field\",\n                      \"timezone\",\n                      \"preset\",\n                      \"mode\"\n                    ],\n                    \"properties\": {\n                      \"field\": {\n                        \"type\": \"string\"\n                      },\n                      \"timezone\": {\n                        \"type\": \"string\"\n                      },\n                      \"preset\": {\n                        \"enum\": [\n                          \"TODAY\",\n                          \"YESTERDAY\",\n                          \"LAST_7_DAYS\",\n                          \"LAST_30_DAYS\",\n                          \"THIS_MONTH\",\n                          \"LAST_MONTH\",\n                          \"THIS_QUARTER\",\n                          \"THIS_YEAR\"\n                        ]\n                      },\n                      \"mode\": {\n                        \"enum\": [\n                          \"PREVIOUS_ALIGNED\",\n                          \"PREVIOUS_CALENDAR_PERIOD\"\n                        ]\n                      }\n                    }\n                  }\n                }\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            \"pattern\": \"^/(?!/)\"\n          },\n          \"operation\": {},\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.source.options.comparisonPeriod\",\n              \"chartDocument.dimensions[]\",\n              \"chartDocument.metrics[]\"\n            ],\n            \"identityKeys\": [\n              \"availableResources[].path\",\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                  \"pattern\": \"^/(?!/)\"\n                },\n                \"operation\": {},\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              \"comparison-period-incomplete\",\n              \"comparison-metric-unsupported\",\n              \"remote-binding-incomplete\"\n            ],\n            \"description\": \"Binds a derived or praxis.stats source using governed resource, capability and field catalogs. For praxis.stats, availableResources[].id is discovery-only: validation requires the matching availableResources[].path and compilation persists that path. Comparison requires one canonical operation, metrics[] and an eligible period field.\"\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        \"comparison-period-complete\",\n        \"comparison-metrics-supported\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"chartDocument.source\",\n        \"chartDocument.source.options.comparisonPeriod\",\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          \"filterExpression\": {\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-filter-expression-stats-unsupported\",\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\": \"pointClick.configure\",\n      \"title\": \"Configure chart point click\",\n      \"scope\": \"eventMapping\",\n      \"targetKind\": \"pointClick\",\n      \"target\": {\n        \"kind\": \"pointClick\",\n        \"resolver\": \"x-ui-chart-events-point-click\",\n        \"ambiguityPolicy\": \"fail\",\n        \"required\": false\n      },\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"action\"\n        ],\n        \"properties\": {\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-point-click-configure\",\n          \"handlerContract\": {\n            \"reads\": [\n              \"chartDocument.events.pointClick\",\n              \"chartDocument.dimensions[]\",\n              \"availableTargets[]\"\n            ],\n            \"writes\": [\n              \"chartDocument.events.pointClick\"\n            ],\n            \"identityKeys\": [\n              \"availableTargets[].id\"\n            ],\n            \"inputSchema\": {\n              \"type\": \"object\",\n              \"required\": [\n                \"action\"\n              ],\n              \"properties\": {\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 pointClick through the pointAction output while keeping pointClick as raw point evidence.\"\n          }\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"point-click-action-structured\",\n        \"event-target-governed\",\n        \"event-mapping-fields-exist\",\n        \"event-action-supported\",\n        \"editor-runtime-round-trip\"\n      ],\n      \"affectedPaths\": [\n        \"chartDocument.events.pointClick\"\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          \"action\"\n        ],\n        \"properties\": {\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                \"action\"\n              ],\n              \"properties\": {\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 emitted through the crossFilter output with safe query-context filters to a governed target. For praxis.stats rows, key is governed bucket identity and label is presentation evidence; mappings may use key when the target schema accepts that identity.\"\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          \"action\"\n        ],\n        \"properties\": {\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                \"action\"\n              ],\n              \"properties\": {\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 the dedicated drillDown output with 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          \"action\"\n        ],\n        \"properties\": {\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-selection-configure\",\n          \"handlerContract\": {\n            \"reads\": [\n              \"chartDocument.events.selectionChange\",\n              \"chartDocument.dimensions[]\",\n              \"availableTargets[]\"\n            ],\n            \"writes\": [\n              \"chartDocument.events.selectionChange\"\n            ],\n            \"identityKeys\": [\n              \"availableTargets[].id\"\n            ],\n            \"inputSchema\": {\n              \"type\": \"object\",\n              \"required\": [\n                \"action\"\n              ],\n              \"properties\": {\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 selectionChange as single-point selection evidence whose event key is governed by the operation.\"\n          }\n        }\n      ],\n      \"destructive\": false,\n      \"requiresConfirmation\": false,\n      \"validators\": [\n        \"selection-output-structured\",\n        \"event-target-governed\",\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    },\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 equal a governed root-relative availableResources[].path beginning with exactly one slash; a discovery id is not an executable resource path.\"\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 capability-backed field context and satisfy its operation, aggregation and distribution-mode eligibility.\"\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\": \"comparison-period-complete\",\n      \"level\": \"error\",\n      \"code\": \"COMPARISON_PERIOD_COMPLETE\",\n      \"description\": \"Comparison requires a time-series eligible period field, timezone, preset and mode grounded in the governed resource capabilities.\"\n    },\n    {\n      \"validatorId\": \"comparison-metrics-supported\",\n      \"level\": \"error\",\n      \"code\": \"COMPARISON_METRICS_SUPPORTED\",\n      \"description\": \"Comparison requires unique metrics[] aliases using only COUNT, DISTINCT_COUNT or SUM capabilities; singular metric payloads are not authorable.\"\n    },\n    {\n      \"validatorId\": \"query-context-structured\",\n      \"level\": \"error\",\n      \"code\": \"QUERY_CONTEXT_STRUCTURED\",\n      \"description\": \"queryContext must use the canonical @praxisui/core structure for filters, filterExpression, sort, limit, page and meta.\"\n    },\n    {\n      \"validatorId\": \"query-context-filter-expression-stats-unsupported\",\n      \"level\": \"error\",\n      \"code\": \"QUERY_CONTEXT_FILTER_EXPRESSION_STATS_UNSUPPORTED\",\n      \"description\": \"praxis.stats currently executes only flat queryContext.filters; governed filterExpression must be preserved for diagnostics and rejected until backend expression support is declared.\"\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\": \"point-click-action-structured\",\n      \"level\": \"error\",\n      \"code\": \"POINT_CLICK_ACTION_STRUCTURED\",\n      \"description\": \"Configured pointClick actions must be emitted through pointAction while pointClick remains raw point evidence.\"\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 resolve to exactly one availableTargets[].id and declare the authored event plus action; missing, duplicate or cross-event identities fail closed.\"\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; praxis.stats reserves key for bucket identity and label for presentation.\"\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 persist availableResources[].path; availableResources[].id remains discovery identity, and transient resource/field/target catalogs and diagnostics are never persisted in widget inputs.\",\n    \"Comparison must preserve one canonical /stats/comparison request with metrics[] and a complete comparisonPeriod; it must not downgrade into independent group-by calls.\",\n    \"Cross-filter, drilldown and selection authoring must persist structured event actions, not prompt examples or command strings.\",\n    \"[P1] Backend handler, resolver and validators now execute directly; end-to-end Page Builder parity remains open until assistant requests project the transient availableTargets[].events catalog through validationContext and expose its fail-closed diagnostics.\",\n    \"[P2] Transform-output semantics and target input-schema/port fields must be materialized and validated by Core; local transform.output inspection and backend-enriched inputFields are not substitutes for those canonical projections.\",\n    \"Enrichment of capability-backed availableFields with /schemas/filtered property metadata remains a later schema-flow gate.\"\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\": \"bind-comparison-resource\",\n      \"request\": \"Compare active employees by department with the previous aligned 30-day period.\",\n      \"operationId\": \"data.resource.bind\",\n      \"params\": {\n        \"sourceKind\": \"praxis.stats\",\n        \"resource\": \"/api/human-resources/employees\",\n        \"operation\": \"comparison\",\n        \"comparisonPeriod\": {\n          \"field\": \"admissionDate\",\n          \"timezone\": \"America/Sao_Paulo\",\n          \"preset\": \"LAST_30_DAYS\",\n          \"mode\": \"PREVIOUS_ALIGNED\"\n        },\n        \"dimensions\": [\n          {\n            \"field\": \"department\"\n          }\n        ],\n        \"metrics\": [\n          {\n            \"field\": \"employeeId\",\n            \"aggregation\": \"distinct-count\"\n          }\n        ]\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        \"action\": \"filter-widget\",\n        \"target\": \"employeesTable\",\n        \"mapping\": {\n          \"department\": \"department\"\n        }\n      },\n      \"isPositive\": true\n    },\n    {\n      \"id\": \"configure-stats-key-cross-filter\",\n      \"request\": \"Use the governed department bucket identity to filter the employee table.\",\n      \"operationId\": \"crossFilter.configure\",\n      \"params\": {\n        \"action\": \"filter-widget\",\n        \"target\": \"employeesTable\",\n        \"mapping\": {\n          \"key\": \"departmentIdsIn\"\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        \"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        \"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        \"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}",
           "sourcePointer": "projects/praxis-charts/src/lib/ai/praxis-charts-authoring-manifest.ts",
-          "contentHash": "28a2c73ac3c736d1bdf589cea5c363c049d9e87e6f58a542376ed60112e0bf22",
+          "contentHash": "1c9f4d3b6d162fa6734f2f35ff3a0819457ada7c514afabe70fe3fca16811352",
           "sourceKind": "component_definition",
           "sourceId": "praxis-chart",
           "corpusVersion": "1.0.0"