OODS Foundry

before
{"$defs":{"colorEncodingBinding":{"description":"A color-channel encoding binding: like encodingBinding, plus an optional explicit `range` (hex colors) that overrides the baked OODS categorical palette on a nominal/ordinal color scale. `range` is only valid on the color channel.","oneOf":[{"minLength":1,"type":"string"},{"additionalProperties":false,"properties":{"aggregate":{"enum":["sum","count","average","median","min","max","distinct"],"type":"string"},"field":{"minLength":1,"type":"string"},"range":{"description":"Explicit hex colors for a nominal/ordinal color scale. Overrides the baked OODS categorical palette so an agent can supply its own scale (e.g. a 2-color presence scale). Applied in array order to the distinct series; a shorter range recycles (Vega domain[i]->range[i] mod len). Cartesian color only.","items":{"pattern":"^#(?:[0-9a-fA-F]{3}){1,2}$","type":"string"},"minItems":2,"type":"array"},"scale":{"enum":["linear","temporal","log","sqrt","band","point","diverging"],"type":"string"},"sort":{"oneOf":[{"enum":["none","ascending","descending"],"type":"string"},{"additionalProperties":false,"properties":{"field":{"type":"string"},"order":{"enum":["ascending","descending"],"type":"string"}},"required":["field","order"],"type":"object"}]},"timeUnit":{"enum":["year","quarter","month","week","day","hour","minute","second"],"type":"string"},"title":{"type":"string"},"type":{"description":"Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.","enum":["quantitative","temporal","ordinal","nominal"],"type":"string"}},"required":["field"],"type":"object"}]},"encodingBinding":{"description":"An encoding binding: either a bare field-name string, or an object with the field plus optional aggregate/scale/timeUnit/sort/title.","oneOf":[{"minLength":1,"type":"string"},{"additionalProperties":false,"properties":{"aggregate":{"enum":["sum","count","average","median","min","max","distinct"],"type":"string"},"currency":{"description":"ISO 4217 code of the amounts this channel encodes, for example EUR. The labels print its en-US symbol where the format has \"$\" (EUR €, GBP £); without a format they read \"$,f\" ($12,000). One currency per chart.","pattern":"^[A-Za-z]{3}$","type":"string"},"field":{"minLength":1,"type":"string"},"format":{"description":"Label format of this channel's axis (x, y) or legend: a d3-format specifier such as \"$,f\" or \",.0f\" (d3-time-format for a temporal field). \"$\" prints the currency symbol: the currency's, else $. Without a precision, labels take the precision of the tick step, so neighbouring ticks never print the same text. Carried in the normalized spec, so artifact.certify replays it.","maxLength":64,"minLength":1,"type":"string"},"scale":{"enum":["linear","temporal","log","sqrt","band","point","diverging"],"type":"string"},"sort":{"oneOf":[{"enum":["none","ascending","descending"],"type":"string"},{"additionalProperties":false,"properties":{"field":{"type":"string"},"order":{"enum":["ascending","descending"],"type":"string"}},"required":["field","order"],"type":"object"}]},"timeUnit":{"enum":["year","quarter","month","week","day","hour","minute","second"],"type":"string"},"title":{"type":"string"},"type":{"description":"Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.","enum":["quantitative","temporal","ordinal","nominal"],"type":"string"}},"required":["field"],"type":"object"}]},"hierarchyNode":{"additionalProperties":true,"description":"A nested-hierarchy node: a name, an optional numeric value, and optional children (recursive). Extra fields are preserved for tooltips.","properties":{"children":{"items":{"$ref":"#/$defs/hierarchyNode"},"type":"array"},"name":{"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"}},"$id":"https://designlab.local/schemas/viz.render.input.json","$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"description":"Render a real, data-bound visualization. Supply a registered pattern identity to preserve its source data and presentation, chartType + encodings for explicit mode, or rows for suggest or structured-intent mode. Retired patterns are not offered; structurally unsupported patterns return OODS-V167; pattern conflicts with explicit data, intent, or source identity/presentation overrides return OODS-V166. Brand, theme and output controls remain available.","properties":{"a11yEquivalence":{"default":true,"description":"A11y equivalence CERTIFY-AT-EMISSION switch. DEFAULT ON. The cartesian (Vega-Lite) emission is checked against the accessible-equivalence engine (validateVizEquivalenceRules): error-severity rules BLOCK (status:'error' with per-rule OODS-<rule.id> codes in `errors`), warn-severity failures surface in `warnings` as OODS-<rule.id>. Default builder output is conformant-BY-CONSTRUCTION , so generated specs pass; set false to opt out for agent-supplied non-conformant specs. Scoped to the cartesian path (the ECharts-primary scaffold has empty data and would spuriously fail data-equivalence rules).","type":"boolean"},"brand":{"default":"A","enum":["A","B"],"type":"string"},"chartType":{"description":"Chart type. The tabular marks (bar->MarkBar, line->MarkLine, area->MarkArea, scatter->MarkPoint, heatmap->MarkRect) bind inline rows with x/y encodings. The hierarchy/flow/network/geo charts are explicit-only and return an ECharts option as the primary spec (no Vega-Lite equivalent): 'treemap' and 'sunburst' take the 'hierarchy' data branch; 'sankey' takes the 'sankey' data branch (nodes + value-weighted links); 'force_graph' takes the 'network' data branch (nodes + links); 'choropleth', 'bubble_map', and 'flow_map' take the 'geo' data branch (inline geometry + per-type encoding — flow_map draws origin→destination arcs); 'chord' takes the 'chord' data branch (sankey-shaped nodes + value-weighted links — a ring of category arcs joined by ribbons whose width is the value). Omit chartType to enter suggest mode (the recommender chooses a tabular type from the inferred field profiles).","enum":["bar","line","area","scatter","heatmap","treemap","sunburst","sankey","force_graph","choropleth","bubble_map","flow_map","chord"],"type":"string"},"chord":{"additionalProperties":false,"description":"Chord data for chartType 'chord' (explicit-only) — used INSTEAD of rows + x/y encodings. A native ECharts ribbon diagram: a ring of category arcs connected by weighted ribbons. Sankey-shaped — nodes plus value-weighted links; every link MUST carry a numeric 'value' (the ribbon width IS the flow magnitude) and reference existing node names — a link naming a node absent from 'nodes' fails loud (OODS-V147).","properties":{"links":{"description":"Directed, value-weighted ribbons between ring arcs (matched to arcs by name). Directed: source→target and target→source are distinct ribbons (a reciprocal pair is valid data). Each (source, target) pair should be unique — a duplicate directed link double-counts the ribbon and is flagged with a warning (OODS-V148).","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target","value"],"type":"object"},"minItems":1,"type":"array"},"nodes":{"description":"Ring arcs. Each carries a unique 'name'.","items":{"additionalProperties":true,"properties":{"name":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"description":{"description":"Optional override for the synthesized accessibility description. When omitted, a non-empty description is generated from the encodings.","type":"string"},"encodings":{"additionalProperties":false,"description":"Channel -> field bindings. Required, with at least x and y, when chartType is supplied (explicit mode).","properties":{"color":{"$ref":"#/$defs/colorEncodingBinding"},"detail":{"$ref":"#/$defs/encodingBinding"},"shape":{"$ref":"#/$defs/encodingBinding"},"size":{"$ref":"#/$defs/encodingBinding"},"x":{"$ref":"#/$defs/encodingBinding"},"y":{"$ref":"#/$defs/encodingBinding"}},"type":"object"},"geo":{"additionalProperties":false,"description":"Geo data for chartType 'choropleth', 'bubble_map', or 'flow_map' (explicit-only) — used INSTEAD of rows + x/y encodings. Carries INLINE geometry (a GeoJSON FeatureCollection in 'geojson', or a TopoJSON Topology in 'topojson' + 'topoObjectName'), an optional 'join' that merges tabular 'rows' into features by key, and the per-type encoding: 'valueField' colours regions for choropleth; 'longitudeField'/'latitudeField' (+ optional 'sizeField'/'colorField') place points for bubble_map; 'originLongitudeField'/'originLatitudeField'/'destinationLongitudeField'/'destinationLatitudeField' (+ optional 'strengthField'/'curvature') draw origin→destination ARCS for flow_map. Geometry is supplied INLINE — it is never fetched over the network. NOTE: geo specs are NOT self-contained (unlike treemap/sankey): the resolved FeatureCollection rides back on echartsSpec.__registration and the client re-registers the map by name before rendering. Geometry payloads can be large (a world atlas is ~100KB) — prefer a pre-simplified TopoJSON.","properties":{"colorField":{"description":"Bubble map: optional row field driving bubble colour.","minLength":1,"type":"string"},"colorScale":{"description":"Optional colour scale (defaults to a continuous linear ramp). 'ordinal' paints discrete per-category colours; 'diverging' ramps two hues about a neutral midpoint (zero).","enum":["linear","quantize","quantile","threshold","ordinal","diverging"],"type":"string"},"curvature":{"description":"Flow map: optional arc curveness (0 = straight, ~0.3 default). Bends each origin→destination line into an arc.","maximum":1,"minimum":0,"type":"number"},"destinationLatitudeField":{"description":"Flow map: the row field holding the DESTINATION latitude. Required for flow_map.","minLength":1,"type":"string"},"destinationLongitudeField":{"description":"Flow map: the row field holding the DESTINATION longitude. Required for flow_map.","minLength":1,"type":"string"},"geojson":{"additionalProperties":true,"description":"Inline GeoJSON FeatureCollection (type:'FeatureCollection', features:[...]). Required for choropleth (the regions); optional base map for bubble_map.","type":"object"},"join":{"additionalProperties":false,"description":"Choropleth join: merge each row into the feature whose 'featureProperty' equals the row's 'dataKey' value.","properties":{"dataKey":{"description":"Key in each tabular row.","minLength":1,"type":"string"},"featureProperty":{"description":"Matching property name in each feature's properties.","minLength":1,"type":"string"}},"required":["dataKey","featureProperty"],"type":"object"},"latitudeField":{"description":"Bubble map: the row field holding latitude. Required for bubble_map.","minLength":1,"type":"string"},"longitudeField":{"description":"Bubble map: the row field holding longitude. Required for bubble_map.","minLength":1,"type":"string"},"originLatitudeField":{"description":"Flow map: the row field holding the ORIGIN latitude. Required for flow_map.","minLength":1,"type":"string"},"originLongitudeField":{"description":"Flow map: the row field holding the ORIGIN longitude. Required for flow_map.","minLength":1,"type":"string"},"rows":{"description":"Tabular records: for choropleth, the values joined into features (paired with 'join'); for bubble_map, the points to plot.","items":{"additionalProperties":true,"type":"object"},"maxItems":5000,"type":"array"},"sizeField":{"description":"Bubble map: optional row field driving bubble size.","minLength":1,"type":"string"},"strengthField":{"description":"Flow map: optional numeric row field whose magnitude drives each arc's line width (via a continuous visualMap).","minLength":1,"type":"string"},"topoObjectName":{"description":"Which TopoJSON object to extract (defaults to the sole object when there is exactly one).","minLength":1,"type":"string"},"topojson":{"additionalProperties":true,"description":"Inline TopoJSON Topology (type:'Topology'); converted to a GeoJSON FeatureCollection. Set 'topoObjectName' when the topology holds more than one object.","type":"object"},"valueField":{"description":"Choropleth: the numeric field — in feature properties, or merged in via 'join' — whose value colours each region. Required for choropleth.","minLength":1,"type":"string"}},"type":"object"},"hierarchy":{"description":"Hierarchy data for chartType 'treemap' or 'sunburst' (explicit-only) — used INSTEAD of rows + x/y encodings. A discriminated union on 'type': 'adjacency_list' (flat nodes linked by parentId; a node whose parent is missing becomes its own root) or 'nested' (a single root node with children).","oneOf":[{"additionalProperties":false,"properties":{"data":{"description":"Flat node list. Each node carries id, parentId (null for roots), and a numeric value.","items":{"additionalProperties":true,"properties":{"id":{"minLength":1,"type":"string"},"name":{"type":"string"},"parentId":{"type":["string","null"]},"value":{"type":"number"}},"required":["id","parentId","value"],"type":"object"},"minItems":1,"type":"array"},"type":{"const":"adjacency_list"}},"required":["type","data"],"type":"object"},{"additionalProperties":false,"properties":{"data":{"$ref":"#/$defs/hierarchyNode"},"type":{"const":"nested"}},"required":["type","data"],"type":"object"}]},"id":{"description":"Optional stable identifier for the produced spec.","type":"string"},"intent":{"additionalProperties":false,"description":"STRUCTURED (typed, NOT free-text) visualization intent — the deterministic half of the NL→viz hand-off. Supply it INSTEAD of chartType/encodings (mutually exclusive with chartType): the named measures/dimensions drive ENCODING, `goal` + the data drive the recommender's chartType pick, an optional `chartFamily` post-filters that pick. Requires `rows`.","properties":{"chartFamily":{"description":"Optional preferred chart family. Post-filters the recommender ranking (NOT a scorer term) to this family, flagged lowConfidence when it was not the recommender's top pick. Constrained to the 5 TABULAR marks — the 8 explicit-only types are not recommender-rankable.","enum":["bar","line","area","scatter","heatmap"],"type":"string"},"dimensions":{"description":"Named dimension fields (the breakdowns/axes); may be empty (e.g. a two-measure scatter). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data).","items":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":"string"},"type":{"enum":["quantitative","temporal","nominal","ordinal"],"type":"string"}},"required":["name"],"type":"object"},"type":"array"},"goal":{"description":"The analytical goal that steers the recommender (the live 7-value goal vocabulary).","enum":["comparison","trend","composition","part-to-whole","relationship","intensity","distribution"],"type":"string"},"measures":{"description":"Named measure fields (the metrics to plot). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data).","items":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":"string"},"type":{"enum":["quantitative","temporal","nominal","ordinal"],"type":"string"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["goal","measures","dimensions"],"type":"object"},"name":{"description":"Optional human-friendly chart title.","type":"string"},"network":{"additionalProperties":false,"description":"Network data for chartType 'force_graph' (explicit-only) — used INSTEAD of rows + x/y encodings. Nodes (each with a unique 'id'; an optional 'group' drives category colour) and directed links (optional numeric 'value'). Every link MUST reference existing node ids — a link naming a node absent from 'nodes' fails loud (OODS-V147).","properties":{"links":{"description":"Directed edges between nodes (an empty array is allowed for an all-isolated-nodes graph). Each 'source'/'target' MUST match a node 'id' (a dangling ref fails loud, OODS-V147). Directed: source→target and target→source are distinct edges. Each (source, target) pair should be unique — a duplicate directed edge double-counts and is flagged with a warning (OODS-V148).","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target"],"type":"object"},"type":"array"},"nodes":{"description":"Graph nodes. Each carries a unique 'id'; optional 'group' (category) and 'value' (sizing).","items":{"additionalProperties":true,"properties":{"group":{"type":"string"},"id":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["id"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"opacity":{"description":"Optional constant mark opacity for the five Cartesian chart families. Preserved in normalized mark options and applied to both Vega-Lite and ECharts pixels. Omission preserves renderer defaults. Unsupported for hierarchy, network and geographic chart families.","maximum":1,"minimum":0,"type":"number"},"output":{"additionalProperties":false,"properties":{"height":{"maximum":2000,"minimum":100,"type":"integer"},"includeA11y":{"const":true},"includeNormalizedSpec":{"const":true},"svg":{"const":true},"width":{"maximum":2000,"minimum":100,"type":"integer"}},"required":[],"type":"object"},"pattern":{"description":"Exact versioned pattern source identity. Renderable patterns preserve source rows, identity, presentation and accessibility metadata. Retired identities are not offered (their reasons are in the viz taxonomy). Structurally unsupported scenes return OODS-V167. Static SVG shows the default selection state (OODS-V175). Cannot be combined with chartType, encodings, rows, intent, hierarchy, sankey, chord, network, geo, id, name, description or opacity (OODS-V166).","enum":["pattern:viz:bubble-distribution","pattern:viz:correlation-matrix","pattern:viz:correlation-scatter","pattern:viz:detail-overview-bar","pattern:viz:diverging-bar","pattern:viz:drilldown-stacked-bar","pattern:viz:facet-small-multiples-line","pattern:viz:facet-target-band","pattern:viz:focus-context-line","pattern:viz:grouped-bar","pattern:viz:histogram","pattern:viz:layered-line-area","pattern:viz:multi-series-line","pattern:viz:running-total-area","pattern:viz:simple-bar","pattern:viz:sparkline-grid","pattern:viz:stacked-100-bar","pattern:viz:stacked-area-projection","pattern:viz:stacked-bar","pattern:viz:target-band-line","pattern:viz:time-grid-heatmap","pattern:viz:waterfall"],"type":"string"},"rows":{"description":"Inline data rows — the primary data path. Bounded: a few hundred rows is the sweet spot. Each row is a flat object mapping field name to value.","items":{"additionalProperties":true,"type":"object"},"maxItems":500,"minItems":1,"type":"array"},"sankey":{"additionalProperties":false,"description":"Flow data for chartType 'sankey' (explicit-only) — used INSTEAD of rows + x/y encodings. Nodes plus value-weighted links; every link MUST carry a numeric 'value' (the link width IS the flow magnitude) and reference existing node names.","properties":{"links":{"description":"Directed, value-weighted flows between nodes. Each (source, target) pair should be unique — a duplicate directed flow double-counts the link width. (Uniqueness is advisory for sankey; it is not warning-enforced.)","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target","value"],"type":"object"},"minItems":1,"type":"array"},"nodes":{"description":"Flow nodes. Each carries a unique 'name'; an optional numeric 'value' overrides the computed throughput.","items":{"additionalProperties":true,"properties":{"name":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"strictFields":{"default":false,"description":"Field/key-presence STRICT switch. When true, a referenced data key that does not resolve is surfaced in `warnings` instead of a silent confident-wrong result: (m05) an explicit tabular chart whose encoding references a field ABSENT from every (non-empty) row → OODS-V131; (m06) a choropleth corridor whose join key has NO matching map feature → OODS-V134 (per unmatched corridor). DEFAULT false keeps today's behavior byte-identical (the geo silent-drop preserved). The dashboard.render strict check (its own `strictFields`) escalates V131 to an error panel via `onPanelError`.","type":"boolean"},"theme":{"default":"light","enum":["light","dark","hc"],"type":"string"}},"title":"Viz render input","type":"object"}

after
{"$defs":{"colorEncodingBinding":{"description":"A color-channel encoding binding: like encodingBinding, plus an optional explicit `range` (hex colors) that overrides the baked OODS categorical palette on a nominal/ordinal color scale. `range` is only valid on the color channel.","oneOf":[{"minLength":1,"type":"string"},{"additionalProperties":false,"properties":{"aggregate":{"enum":["sum","count","average","median","min","max","distinct"],"type":"string"},"field":{"minLength":1,"type":"string"},"range":{"description":"Explicit hex colors for a nominal/ordinal color scale. Overrides the baked OODS categorical palette so an agent can supply its own scale (e.g. a 2-color presence scale). Applied in array order to the distinct series; a shorter range recycles (Vega domain[i]->range[i] mod len). Cartesian color only.","items":{"pattern":"^#(?:[0-9a-fA-F]{3}){1,2}$","type":"string"},"minItems":2,"type":"array"},"scale":{"enum":["linear","temporal","log","sqrt","band","point","diverging"],"type":"string"},"sort":{"oneOf":[{"enum":["none","ascending","descending"],"type":"string"},{"additionalProperties":false,"properties":{"field":{"type":"string"},"order":{"enum":["ascending","descending"],"type":"string"}},"required":["field","order"],"type":"object"}]},"timeUnit":{"enum":["year","quarter","month","week","day","hour","minute","second"],"type":"string"},"title":{"type":"string"},"type":{"description":"Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.","enum":["quantitative","temporal","ordinal","nominal"],"type":"string"}},"required":["field"],"type":"object"}]},"encodingBinding":{"description":"An encoding binding: either a bare field-name string, or an object with the field plus optional aggregate/scale/timeUnit/sort/title.","oneOf":[{"minLength":1,"type":"string"},{"additionalProperties":false,"properties":{"aggregate":{"enum":["sum","count","average","median","min","max","distinct"],"type":"string"},"currency":{"description":"ISO 4217 code of the amounts this channel encodes, for example EUR. The labels print its en-US symbol where the format has \"$\" (EUR €, GBP £); without a format they read \"$,f\" ($12,000). One currency per chart.","pattern":"^[A-Za-z]{3}$","type":"string"},"field":{"minLength":1,"type":"string"},"format":{"description":"Label format of this channel's axis (x, y) or legend: a d3-format specifier such as \"$,f\" or \",.0f\" (d3-time-format for a temporal field). \"$\" prints the currency symbol: the currency's, else $. Without a precision, labels take the precision of the tick step, so neighbouring ticks never print the same text. Carried in the normalized spec, so artifact_certify replays it.","maxLength":64,"minLength":1,"type":"string"},"scale":{"enum":["linear","temporal","log","sqrt","band","point","diverging"],"type":"string"},"sort":{"oneOf":[{"enum":["none","ascending","descending"],"type":"string"},{"additionalProperties":false,"properties":{"field":{"type":"string"},"order":{"enum":["ascending","descending"],"type":"string"}},"required":["field","order"],"type":"object"}]},"timeUnit":{"enum":["year","quarter","month","week","day","hour","minute","second"],"type":"string"},"title":{"type":"string"},"type":{"description":"Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.","enum":["quantitative","temporal","ordinal","nominal"],"type":"string"}},"required":["field"],"type":"object"}]},"hierarchyNode":{"additionalProperties":true,"description":"A nested-hierarchy node: a name, an optional numeric value, and optional children (recursive). Extra fields are preserved for tooltips.","properties":{"children":{"items":{"$ref":"#/$defs/hierarchyNode"},"type":"array"},"name":{"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"}},"$id":"https://oods-foundry.com/schemas/viz.render.input.json","$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"description":"Render a real, data-bound visualization. Supply a registered pattern identity to preserve its source data and presentation, chartType + encodings for explicit mode, or rows for suggest or structured-intent mode. Retired patterns are not offered; structurally unsupported patterns return OODS-V167; pattern conflicts with explicit data, intent, or source identity/presentation overrides return OODS-V166. Brand, theme and output controls remain available.","properties":{"a11yEquivalence":{"default":true,"description":"Checks the drawn chart's accessible equivalents as it is rendered; on by default. For Vega-Lite charts, a rule marked error stops the render (status error, with one OODS-<rule id> code per rule in errors), and a rule marked warn is reported in warnings. Charts built from rows and encodings always pass. Set false only for a spec you supply that is known not to conform. ECharts-primary charts are not checked here, because their scaffold has no data yet.","type":"boolean"},"brand":{"default":"A","enum":["A","B"],"type":"string"},"chartType":{"description":"Chart type. The tabular marks (bar->MarkBar, line->MarkLine, area->MarkArea, scatter->MarkPoint, heatmap->MarkRect) bind inline rows with x/y encodings. The hierarchy/flow/network/geo charts are explicit-only and return an ECharts option as the primary spec (no Vega-Lite equivalent): 'treemap' and 'sunburst' take the 'hierarchy' data branch; 'sankey' takes the 'sankey' data branch (nodes + value-weighted links); 'force_graph' takes the 'network' data branch (nodes + links); 'choropleth', 'bubble_map', and 'flow_map' take the 'geo' data branch (inline geometry + per-type encoding — flow_map draws origin→destination arcs); 'chord' takes the 'chord' data branch (sankey-shaped nodes + value-weighted links — a ring of category arcs joined by ribbons whose width is the value). Omit chartType to enter suggest mode (the recommender chooses a tabular type from the inferred field profiles).","enum":["bar","line","area","scatter","heatmap","treemap","sunburst","sankey","force_graph","choropleth","bubble_map","flow_map","chord"],"type":"string"},"chord":{"additionalProperties":false,"description":"Chord data for chartType 'chord' (explicit-only) — used instead of rows + x/y encodings. A native ECharts ribbon diagram: a ring of category arcs connected by weighted ribbons. Sankey-shaped — nodes plus value-weighted links; every link must carry a numeric 'value' (the ribbon width IS the flow magnitude) and reference existing node names — a link naming a node absent from 'nodes' fails loud (OODS-V147).","properties":{"links":{"description":"Directed, value-weighted ribbons between ring arcs (matched to arcs by name). Directed: source→target and target→source are distinct ribbons (a reciprocal pair is valid data). Each (source, target) pair should be unique — a duplicate directed link double-counts the ribbon and is flagged with a warning (OODS-V148).","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target","value"],"type":"object"},"minItems":1,"type":"array"},"nodes":{"description":"Ring arcs. Each carries a unique 'name'.","items":{"additionalProperties":true,"properties":{"name":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"description":{"description":"Optional override for the synthesized accessibility description. When omitted, a non-empty description is generated from the encodings.","type":"string"},"encodings":{"additionalProperties":false,"description":"Channel -> field bindings. Required, with at least x and y, when chartType is supplied (explicit mode).","properties":{"color":{"$ref":"#/$defs/colorEncodingBinding"},"detail":{"$ref":"#/$defs/encodingBinding"},"shape":{"$ref":"#/$defs/encodingBinding"},"size":{"$ref":"#/$defs/encodingBinding"},"x":{"$ref":"#/$defs/encodingBinding"},"y":{"$ref":"#/$defs/encodingBinding"}},"type":"object"},"geo":{"additionalProperties":false,"description":"Geo data for chartType 'choropleth', 'bubble_map', or 'flow_map' (explicit-only) — used instead of rows + x/y encodings. Carries inline geometry (a GeoJSON FeatureCollection in 'geojson', or a TopoJSON Topology in 'topojson' + 'topoObjectName'), an optional 'join' that merges tabular 'rows' into features by key, and the per-type encoding: 'valueField' colours regions for choropleth; 'longitudeField'/'latitudeField' (+ optional 'sizeField'/'colorField') place points for bubble_map; 'originLongitudeField'/'originLatitudeField'/'destinationLongitudeField'/'destinationLatitudeField' (+ optional 'strengthField'/'curvature') draw origin→destination arcs for flow_map. Geometry is supplied inline — it is never fetched over the network. Note: geo specs are not self-contained (unlike treemap/sankey): the resolved FeatureCollection rides back on echartsSpec.__registration and the client re-registers the map by name before rendering. Geometry payloads can be large (a world atlas is ~100KB) — prefer a pre-simplified TopoJSON.","properties":{"colorField":{"description":"Bubble map: optional row field driving bubble colour.","minLength":1,"type":"string"},"colorScale":{"description":"Optional colour scale (defaults to a continuous linear ramp). 'ordinal' paints discrete per-category colours; 'diverging' ramps two hues about a neutral midpoint (zero).","enum":["linear","quantize","quantile","threshold","ordinal","diverging"],"type":"string"},"curvature":{"description":"Flow map: optional arc curveness (0 = straight, ~0.3 default). Bends each origin→destination line into an arc.","maximum":1,"minimum":0,"type":"number"},"destinationLatitudeField":{"description":"Flow map: the row field holding the destination latitude. Required for flow_map.","minLength":1,"type":"string"},"destinationLongitudeField":{"description":"Flow map: the row field holding the destination longitude. Required for flow_map.","minLength":1,"type":"string"},"geojson":{"additionalProperties":true,"description":"Inline GeoJSON FeatureCollection (type:'FeatureCollection', features:[...]). Required for choropleth (the regions); optional base map for bubble_map.","type":"object"},"join":{"additionalProperties":false,"description":"Choropleth join: merge each row into the feature whose 'featureProperty' equals the row's 'dataKey' value.","properties":{"dataKey":{"description":"Key in each tabular row.","minLength":1,"type":"string"},"featureProperty":{"description":"Matching property name in each feature's properties.","minLength":1,"type":"string"}},"required":["dataKey","featureProperty"],"type":"object"},"latitudeField":{"description":"Bubble map: the row field holding latitude. Required for bubble_map.","minLength":1,"type":"string"},"longitudeField":{"description":"Bubble map: the row field holding longitude. Required for bubble_map.","minLength":1,"type":"string"},"originLatitudeField":{"description":"Flow map: the row field holding the origin latitude. Required for flow_map.","minLength":1,"type":"string"},"originLongitudeField":{"description":"Flow map: the row field holding the origin longitude. Required for flow_map.","minLength":1,"type":"string"},"rows":{"description":"Tabular records: for choropleth, the values joined into features (paired with 'join'); for bubble_map, the points to plot.","items":{"additionalProperties":true,"type":"object"},"maxItems":5000,"type":"array"},"sizeField":{"description":"Bubble map: optional row field driving bubble size.","minLength":1,"type":"string"},"strengthField":{"description":"Flow map: optional numeric row field whose magnitude drives each arc's line width (via a continuous visualMap).","minLength":1,"type":"string"},"topoObjectName":{"description":"Which TopoJSON object to extract (defaults to the sole object when there is exactly one).","minLength":1,"type":"string"},"topojson":{"additionalProperties":true,"description":"Inline TopoJSON Topology (type:'Topology'); converted to a GeoJSON FeatureCollection. Set 'topoObjectName' when the topology holds more than one object.","type":"object"},"valueField":{"description":"Choropleth: the numeric field — in feature properties, or merged in via 'join' — whose value colours each region. Required for choropleth.","minLength":1,"type":"string"}},"type":"object"},"hierarchy":{"description":"Hierarchy data for chartType 'treemap' or 'sunburst' (explicit-only) — used instead of rows + x/y encodings. A discriminated union on 'type': 'adjacency_list' (flat nodes linked by parentId; a node whose parent is missing becomes its own root) or 'nested' (a single root node with children).","oneOf":[{"additionalProperties":false,"properties":{"data":{"description":"Flat node list. Each node carries id, parentId (null for roots), and a numeric value.","items":{"additionalProperties":true,"properties":{"id":{"minLength":1,"type":"string"},"name":{"type":"string"},"parentId":{"type":["string","null"]},"value":{"type":"number"}},"required":["id","parentId","value"],"type":"object"},"minItems":1,"type":"array"},"type":{"const":"adjacency_list","type":"string"}},"required":["type","data"],"type":"object"},{"additionalProperties":false,"properties":{"data":{"$ref":"#/$defs/hierarchyNode"},"type":{"const":"nested","type":"string"}},"required":["type","data"],"type":"object"}]},"id":{"description":"Optional stable identifier for the produced spec.","type":"string"},"intent":{"additionalProperties":false,"description":"Structured (typed, not free-text) visualization intent — the deterministic half of the NL→viz hand-off. Supply it instead of chartType/encodings (mutually exclusive with chartType): the named measures/dimensions drive encoding, `goal` + the data drive the recommender's chartType pick, an optional `chartFamily` post-filters that pick. Requires `rows`.","properties":{"chartFamily":{"description":"Optional preferred chart family. Post-filters the recommender ranking (not a scorer term) to this family, flagged lowConfidence when it was not the recommender's top pick. Constrained to the 5 tabular marks — the 8 explicit-only types are not recommender-rankable.","enum":["bar","line","area","scatter","heatmap"],"type":"string"},"dimensions":{"description":"Named dimension fields (the breakdowns/axes); may be empty (e.g. a two-measure scatter). Each name must exist among the data rows' fields. `type` is reserved in v0.1 (field types infer from the data).","items":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":"string"},"type":{"enum":["quantitative","temporal","nominal","ordinal"],"type":"string"}},"required":["name"],"type":"object"},"type":"array"},"goal":{"description":"The analytical goal that steers the recommender (the live 7-value goal vocabulary).","enum":["comparison","trend","composition","part-to-whole","relationship","intensity","distribution"],"type":"string"},"measures":{"description":"Named measure fields (the metrics to plot). Each name must exist among the data rows' fields. `type` is reserved in v0.1 (field types infer from the data).","items":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":"string"},"type":{"enum":["quantitative","temporal","nominal","ordinal"],"type":"string"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["goal","measures","dimensions"],"type":"object"},"name":{"description":"Optional human-friendly chart title.","type":"string"},"network":{"additionalProperties":false,"description":"Network data for chartType 'force_graph' (explicit-only) — used instead of rows + x/y encodings. Nodes (each with a unique 'id'; an optional 'group' drives category colour) and directed links (optional numeric 'value'). Every link must reference existing node ids — a link naming a node absent from 'nodes' fails loud (OODS-V147).","properties":{"links":{"description":"Directed edges between nodes (an empty array is allowed for an all-isolated-nodes graph). Each 'source'/'target' must match a node 'id' (a dangling ref fails loud, OODS-V147). Directed: source→target and target→source are distinct edges. Each (source, target) pair should be unique — a duplicate directed edge double-counts and is flagged with a warning (OODS-V148).","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target"],"type":"object"},"type":"array"},"nodes":{"description":"Graph nodes. Each carries a unique 'id'; optional 'group' (category) and 'value' (sizing).","items":{"additionalProperties":true,"properties":{"group":{"type":"string"},"id":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["id"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"opacity":{"description":"Optional constant mark opacity for the five Cartesian chart families. Preserved in normalized mark options and applied to both Vega-Lite and ECharts pixels. Omission preserves renderer defaults. Unsupported for hierarchy, network and geographic chart families.","maximum":1,"minimum":0,"type":"number"},"output":{"additionalProperties":false,"properties":{"height":{"maximum":2000,"minimum":100,"type":"integer"},"includeA11y":{"const":true},"includeNormalizedSpec":{"const":true},"svg":{"const":true},"width":{"maximum":2000,"minimum":100,"type":"integer"}},"required":[],"type":"object"},"pattern":{"description":"Exact versioned pattern source identity. Renderable patterns preserve source rows, identity, presentation and accessibility metadata. Retired identities are not offered (their reasons are in the viz taxonomy). Structurally unsupported scenes return OODS-V167. Static SVG shows the default selection state (OODS-V175). Cannot be combined with chartType, encodings, rows, intent, hierarchy, sankey, chord, network, geo, id, name, description or opacity (OODS-V166).","enum":["pattern:viz:bubble-distribution","pattern:viz:correlation-matrix","pattern:viz:correlation-scatter","pattern:viz:detail-overview-bar","pattern:viz:diverging-bar","pattern:viz:drilldown-stacked-bar","pattern:viz:facet-small-multiples-line","pattern:viz:facet-target-band","pattern:viz:focus-context-line","pattern:viz:grouped-bar","pattern:viz:histogram","pattern:viz:layered-line-area","pattern:viz:multi-series-line","pattern:viz:running-total-area","pattern:viz:simple-bar","pattern:viz:sparkline-grid","pattern:viz:stacked-100-bar","pattern:viz:stacked-area-projection","pattern:viz:stacked-bar","pattern:viz:target-band-line","pattern:viz:time-grid-heatmap","pattern:viz:waterfall"],"type":"string"},"rows":{"description":"Inline data rows — the primary data path. Bounded: a few hundred rows is the sweet spot. Each row is a flat object mapping field name to value.","items":{"additionalProperties":true,"type":"object"},"maxItems":500,"minItems":1,"type":"array"},"sankey":{"additionalProperties":false,"description":"Flow data for chartType 'sankey' (explicit-only) — used instead of rows + x/y encodings. Nodes plus value-weighted links; every link must carry a numeric 'value' (the link width IS the flow magnitude) and reference existing node names.","properties":{"links":{"description":"Directed, value-weighted flows between nodes. Each (source, target) pair should be unique — a duplicate directed flow double-counts the link width. (Uniqueness is advisory for sankey; it is not warning-enforced.)","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target","value"],"type":"object"},"minItems":1,"type":"array"},"nodes":{"description":"Flow nodes. Each carries a unique 'name'; an optional numeric 'value' overrides the computed throughput.","items":{"additionalProperties":true,"properties":{"name":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"strictFields":{"default":false,"description":"Strict field checks. When true, a data key that does not resolve is reported in warnings instead of producing a silently wrong chart: an encoding that names a field missing from every non-empty row (OODS-V131), or a choropleth region whose join key matches no map feature (OODS-V134, one per unmatched region). The default, false, keeps the current behavior, which drops unmatched map regions silently. Dashboard_render has its own strictFields, which turns OODS-V131 into an error panel through its onPanelError option.","type":"boolean"},"theme":{"default":"light","enum":["light","dark","hc"],"type":"string"}},"title":"Viz render input","type":"object"}

before
{"$defs":{"colorEncodingBinding":{"description":"A color-channel encoding binding: like encodingBinding, plus an optional explicit `range` (hex colors) that overrides the baked OODS categorical palette on a nominal/ordinal color scale. `range` is only valid on the color channel.","oneOf":[{"minLength":1,"type":"string"},{"additionalProperties":false,"properties":{"aggregate":{"enum":["sum","count","average","median","min","max","distinct"],"type":"string"},"field":{"minLength":1,"type":"string"},"range":{"description":"Explicit hex colors for a nominal/ordinal color scale. Overrides the baked OODS categorical palette so an agent can supply its own scale (e.g. a 2-color presence scale). Applied in array order to the distinct series; a shorter range recycles (Vega domain[i]->range[i] mod len). Cartesian color only.","items":{"pattern":"^#(?:[0-9a-fA-F]{3}){1,2}$","type":"string"},"minItems":2,"type":"array"},"scale":{"enum":["linear","temporal","log","sqrt","band","point","diverging"],"type":"string"},"sort":{"oneOf":[{"enum":["none","ascending","descending"],"type":"string"},{"additionalProperties":false,"properties":{"field":{"type":"string"},"order":{"enum":["ascending","descending"],"type":"string"}},"required":["field","order"],"type":"object"}]},"timeUnit":{"enum":["year","quarter","month","week","day","hour","minute","second"],"type":"string"},"title":{"type":"string"},"type":{"description":"Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.","enum":["quantitative","temporal","ordinal","nominal"],"type":"string"}},"required":["field"],"type":"object"}]},"encodingBinding":{"description":"An encoding binding: either a bare field-name string, or an object with the field plus optional aggregate/scale/timeUnit/sort/title.","oneOf":[{"minLength":1,"type":"string"},{"additionalProperties":false,"properties":{"aggregate":{"enum":["sum","count","average","median","min","max","distinct"],"type":"string"},"currency":{"description":"ISO 4217 code of the amounts this channel encodes, for example EUR. The labels print its en-US symbol where the format has \"$\" (EUR €, GBP £); without a format they read \"$,f\" ($12,000). One currency per chart.","pattern":"^[A-Za-z]{3}$","type":"string"},"field":{"minLength":1,"type":"string"},"format":{"description":"Label format of this channel's axis (x, y) or legend: a d3-format specifier such as \"$,f\" or \",.0f\" (d3-time-format for a temporal field). \"$\" prints the currency symbol: the currency's, else $. Without a precision, labels take the precision of the tick step, so neighbouring ticks never print the same text. Carried in the normalized spec, so artifact.certify replays it.","maxLength":64,"minLength":1,"type":"string"},"scale":{"enum":["linear","temporal","log","sqrt","band","point","diverging"],"type":"string"},"sort":{"oneOf":[{"enum":["none","ascending","descending"],"type":"string"},{"additionalProperties":false,"properties":{"field":{"type":"string"},"order":{"enum":["ascending","descending"],"type":"string"}},"required":["field","order"],"type":"object"}]},"timeUnit":{"enum":["year","quarter","month","week","day","hour","minute","second"],"type":"string"},"title":{"type":"string"},"type":{"description":"Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.","enum":["quantitative","temporal","ordinal","nominal"],"type":"string"}},"required":["field"],"type":"object"}]},"hierarchyNode":{"additionalProperties":true,"description":"A nested-hierarchy node: a name, an optional numeric value, and optional children (recursive). Extra fields are preserved for tooltips.","properties":{"children":{"items":{"$ref":"#/$defs/hierarchyNode"},"type":"array"},"name":{"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"nonPatternInput":{"allOf":[{"if":{"properties":{"chartType":{"enum":["bar","line","area","scatter","heatmap"]}},"required":["chartType"]},"then":{"properties":{"encodings":{"required":["x","y"]}},"required":["encodings"]}},{"if":{"properties":{"chartType":{"enum":["treemap","sunburst"]}},"required":["chartType"]},"then":{"required":["hierarchy"]}},{"if":{"properties":{"chartType":{"const":"sankey"}},"required":["chartType"]},"then":{"required":["sankey"]}},{"if":{"properties":{"chartType":{"const":"force_graph"}},"required":["chartType"]},"then":{"required":["network"]}},{"if":{"properties":{"chartType":{"const":"choropleth"}},"required":["chartType"]},"then":{"properties":{"geo":{"anyOf":[{"required":["geojson"]},{"required":["topojson"]}],"required":["valueField"]}},"required":["geo"]}},{"if":{"properties":{"chartType":{"const":"bubble_map"}},"required":["chartType"]},"then":{"properties":{"geo":{"required":["longitudeField","latitudeField","rows"]}},"required":["geo"]}},{"if":{"properties":{"chartType":{"const":"flow_map"}},"required":["chartType"]},"then":{"properties":{"geo":{"anyOf":[{"required":["geojson"]},{"required":["topojson"]}],"required":["originLongitudeField","originLatitudeField","destinationLongitudeField","destinationLatitudeField","rows"]}},"required":["geo"]}},{"if":{"properties":{"chartType":{"const":"chord"}},"required":["chartType"]},"then":{"required":["chord"]}}],"oneOf":[{"required":["rows"]},{"required":["datasetRef"]},{"required":["hierarchy"]},{"required":["sankey"]},{"required":["chord"]},{"required":["network"]},{"required":["geo"]}]}},"$id":"https://designlab.local/schemas/viz.render.input.json","$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"allOf":[{"if":{"not":{"required":["pattern"]}},"then":{"$ref":"#/$defs/nonPatternInput"}}],"description":"Render a real, data-bound visualization. Supply a registered pattern identity to preserve its source data and presentation, chartType + encodings for explicit mode, or rows/datasetRef for suggest or structured-intent mode. Retired patterns are not offered; structurally unsupported patterns return OODS-V167; pattern conflicts with explicit data, intent, or source identity/presentation overrides return OODS-V166. Brand, theme and output controls remain available.","properties":{"a11yEquivalence":{"default":true,"description":"A11y equivalence CERTIFY-AT-EMISSION switch. DEFAULT ON. The cartesian (Vega-Lite) emission is checked against the accessible-equivalence engine (validateVizEquivalenceRules): error-severity rules BLOCK (status:'error' with per-rule OODS-<rule.id> codes in `errors`), warn-severity failures surface in `warnings` as OODS-<rule.id>. Default builder output is conformant-BY-CONSTRUCTION , so generated specs pass; set false to opt out for agent-supplied non-conformant specs. Scoped to the cartesian path (the ECharts-primary scaffold has empty data and would spuriously fail data-equivalence rules).","type":"boolean"},"brand":{"default":"A","enum":["A","B"],"type":"string"},"chartType":{"description":"Chart type. The tabular marks (bar->MarkBar, line->MarkLine, area->MarkArea, scatter->MarkPoint, heatmap->MarkRect) bind inline rows/datasetRef with x/y encodings. The hierarchy/flow/network/geo charts are explicit-only and return an ECharts option as the primary spec (no Vega-Lite equivalent): 'treemap' and 'sunburst' take the 'hierarchy' data branch; 'sankey' takes the 'sankey' data branch (nodes + value-weighted links); 'force_graph' takes the 'network' data branch (nodes + links); 'choropleth', 'bubble_map', and 'flow_map' take the 'geo' data branch (inline geometry + per-type encoding — flow_map draws origin→destination arcs); 'chord' takes the 'chord' data branch (sankey-shaped nodes + value-weighted links — a ring of category arcs joined by ribbons whose width is the value). Omit chartType to enter suggest mode (the recommender chooses a tabular type from the inferred field profiles).","enum":["bar","line","area","scatter","heatmap","treemap","sunburst","sankey","force_graph","choropleth","bubble_map","flow_map","chord"],"type":"string"},"chord":{"additionalProperties":false,"description":"Chord data for chartType 'chord' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. A native ECharts ribbon diagram: a ring of category arcs connected by weighted ribbons. Sankey-shaped — nodes plus value-weighted links; every link MUST carry a numeric 'value' (the ribbon width IS the flow magnitude) and reference existing node names — a link naming a node absent from 'nodes' fails loud (OODS-V147).","properties":{"links":{"description":"Directed, value-weighted ribbons between ring arcs (matched to arcs by name). Directed: source→target and target→source are distinct ribbons (a reciprocal pair is valid data). Each (source, target) pair should be unique — a duplicate directed link double-counts the ribbon and is flagged with a warning (OODS-V148).","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target","value"],"type":"object"},"minItems":1,"type":"array"},"nodes":{"description":"Ring arcs. Each carries a unique 'name'.","items":{"additionalProperties":true,"properties":{"name":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"description":{"description":"Optional override for the synthesized accessibility description. When omitted, a non-empty description is generated from the encodings.","type":"string"},"encodings":{"additionalProperties":false,"description":"Channel -> field bindings. Required, with at least x and y, when chartType is supplied (explicit mode).","properties":{"color":{"$ref":"#/$defs/colorEncodingBinding"},"detail":{"$ref":"#/$defs/encodingBinding"},"shape":{"$ref":"#/$defs/encodingBinding"},"size":{"$ref":"#/$defs/encodingBinding"},"x":{"$ref":"#/$defs/encodingBinding"},"y":{"$ref":"#/$defs/encodingBinding"}},"type":"object"},"geo":{"additionalProperties":false,"description":"Geo data for chartType 'choropleth', 'bubble_map', or 'flow_map' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Carries INLINE geometry (a GeoJSON FeatureCollection in 'geojson', or a TopoJSON Topology in 'topojson' + 'topoObjectName'), an optional 'join' that merges tabular 'rows' into features by key, and the per-type encoding: 'valueField' colours regions for choropleth; 'longitudeField'/'latitudeField' (+ optional 'sizeField'/'colorField') place points for bubble_map; 'originLongitudeField'/'originLatitudeField'/'destinationLongitudeField'/'destinationLatitudeField' (+ optional 'strengthField'/'curvature') draw origin→destination ARCS for flow_map. Geometry is supplied INLINE — it is never fetched over the network. NOTE: geo specs are NOT self-contained (unlike treemap/sankey): the resolved FeatureCollection rides back on echartsSpec.__registration and the client re-registers the map by name before rendering. Geometry payloads can be large (a world atlas is ~100KB) — prefer a pre-simplified TopoJSON.","properties":{"colorField":{"description":"Bubble map: optional row field driving bubble colour.","minLength":1,"type":"string"},"colorScale":{"description":"Optional colour scale (defaults to a continuous linear ramp). 'ordinal' paints discrete per-category colours; 'diverging' ramps two hues about a neutral midpoint (zero).","enum":["linear","quantize","quantile","threshold","ordinal","diverging"],"type":"string"},"curvature":{"description":"Flow map: optional arc curveness (0 = straight, ~0.3 default). Bends each origin→destination line into an arc.","maximum":1,"minimum":0,"type":"number"},"destinationLatitudeField":{"description":"Flow map: the row field holding the DESTINATION latitude. Required for flow_map.","minLength":1,"type":"string"},"destinationLongitudeField":{"description":"Flow map: the row field holding the DESTINATION longitude. Required for flow_map.","minLength":1,"type":"string"},"geojson":{"additionalProperties":true,"description":"Inline GeoJSON FeatureCollection (type:'FeatureCollection', features:[...]). Required for choropleth (the regions); optional base map for bubble_map.","type":"object"},"join":{"additionalProperties":false,"description":"Choropleth join: merge each row into the feature whose 'featureProperty' equals the row's 'dataKey' value.","properties":{"dataKey":{"description":"Key in each tabular row.","minLength":1,"type":"string"},"featureProperty":{"description":"Matching property name in each feature's properties.","minLength":1,"type":"string"}},"required":["dataKey","featureProperty"],"type":"object"},"latitudeField":{"description":"Bubble map: the row field holding latitude. Required for bubble_map.","minLength":1,"type":"string"},"longitudeField":{"description":"Bubble map: the row field holding longitude. Required for bubble_map.","minLength":1,"type":"string"},"originLatitudeField":{"description":"Flow map: the row field holding the ORIGIN latitude. Required for flow_map.","minLength":1,"type":"string"},"originLongitudeField":{"description":"Flow map: the row field holding the ORIGIN longitude. Required for flow_map.","minLength":1,"type":"string"},"rows":{"description":"Tabular records: for choropleth, the values joined into features (paired with 'join'); for bubble_map, the points to plot.","items":{"additionalProperties":true,"type":"object"},"maxItems":5000,"type":"array"},"sizeField":{"description":"Bubble map: optional row field driving bubble size.","minLength":1,"type":"string"},"strengthField":{"description":"Flow map: optional numeric row field whose magnitude drives each arc's line width (via a continuous visualMap).","minLength":1,"type":"string"},"topoObjectName":{"description":"Which TopoJSON object to extract (defaults to the sole object when there is exactly one).","minLength":1,"type":"string"},"topojson":{"additionalProperties":true,"description":"Inline TopoJSON Topology (type:'Topology'); converted to a GeoJSON FeatureCollection. Set 'topoObjectName' when the topology holds more than one object.","type":"object"},"valueField":{"description":"Choropleth: the numeric field — in feature properties, or merged in via 'join' — whose value colours each region. Required for choropleth.","minLength":1,"type":"string"}},"type":"object"},"hierarchy":{"description":"Hierarchy data for chartType 'treemap' or 'sunburst' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. A discriminated union on 'type': 'adjacency_list' (flat nodes linked by parentId; a node whose parent is missing becomes its own root) or 'nested' (a single root node with children).","oneOf":[{"additionalProperties":false,"properties":{"data":{"description":"Flat node list. Each node carries id, parentId (null for roots), and a numeric value.","items":{"additionalProperties":true,"properties":{"id":{"minLength":1,"type":"string"},"name":{"type":"string"},"parentId":{"type":["string","null"]},"value":{"type":"number"}},"required":["id","parentId","value"],"type":"object"},"minItems":1,"type":"array"},"type":{"const":"adjacency_list"}},"required":["type","data"],"type":"object"},{"additionalProperties":false,"properties":{"data":{"$ref":"#/$defs/hierarchyNode"},"type":{"const":"nested"}},"required":["type","data"],"type":"object"}]},"id":{"description":"Optional stable identifier for the produced spec.","type":"string"},"intent":{"additionalProperties":false,"description":"STRUCTURED (typed, NOT free-text) visualization intent — the deterministic half of the NL→viz hand-off. Supply it INSTEAD of chartType/encodings (mutually exclusive with chartType): the named measures/dimensions drive ENCODING, `goal` + the data drive the recommender's chartType pick, an optional `chartFamily` post-filters that pick, and an optional governed `measureRef` lights the governed-measure narrative overlay (only when output.includeA11y=true). Requires `rows` (or a `datasetRef`).","properties":{"chartFamily":{"description":"Optional preferred chart family. Post-filters the recommender ranking (NOT a scorer term) to this family, flagged lowConfidence when it was not the recommender's top pick. Constrained to the 5 TABULAR marks — the 8 explicit-only types are not recommender-rankable.","enum":["bar","line","area","scatter","heatmap"],"type":"string"},"dimensions":{"description":"Named dimension fields (the breakdowns/axes); may be empty (e.g. a two-measure scatter). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data).","items":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":"string"},"type":{"enum":["quantitative","temporal","nominal","ordinal"],"type":"string"}},"required":["name"],"type":"object"},"type":"array"},"goal":{"description":"The analytical goal that steers the recommender (the live 7-value goal vocabulary).","enum":["comparison","trend","composition","part-to-whole","relationship","intensity","distribution"],"type":"string"},"measures":{"description":"Named measure fields (the metrics to plot). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data).","items":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":"string"},"type":{"enum":["quantitative","temporal","nominal","ordinal"],"type":"string"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["goal","measures","dimensions"],"type":"object"},"name":{"description":"Optional human-friendly chart title.","type":"string"},"network":{"additionalProperties":false,"description":"Network data for chartType 'force_graph' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Nodes (each with a unique 'id'; an optional 'group' drives category colour) and directed links (optional numeric 'value'). Every link MUST reference existing node ids — a link naming a node absent from 'nodes' fails loud (OODS-V147).","properties":{"links":{"description":"Directed edges between nodes (an empty array is allowed for an all-isolated-nodes graph). Each 'source'/'target' MUST match a node 'id' (a dangling ref fails loud, OODS-V147). Directed: source→target and target→source are distinct edges. Each (source, target) pair should be unique — a duplicate directed edge double-counts and is flagged with a warning (OODS-V148).","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target"],"type":"object"},"type":"array"},"nodes":{"description":"Graph nodes. Each carries a unique 'id'; optional 'group' (category) and 'value' (sizing).","items":{"additionalProperties":true,"properties":{"group":{"type":"string"},"id":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["id"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"opacity":{"description":"Optional constant mark opacity for the five Cartesian chart families. Preserved in normalized mark options and applied to both Vega-Lite and ECharts pixels. Omission preserves renderer defaults. Unsupported for hierarchy, network and geographic chart families.","maximum":1,"minimum":0,"type":"number"},"output":{"additionalProperties":false,"properties":{"height":{"maximum":2000,"minimum":100,"type":"integer"},"includeA11y":{"const":true},"includeNormalizedSpec":{"const":true},"svg":{"const":true},"width":{"maximum":2000,"minimum":100,"type":"integer"}},"required":[],"type":"object"},"pattern":{"description":"Exact versioned pattern source identity. Renderable patterns preserve source rows, identity, presentation and accessibility metadata. Retired identities are not offered (their reasons are in the viz taxonomy). Structurally unsupported scenes return OODS-V167. Static SVG shows the default selection state (OODS-V175). Cannot be combined with chartType, encodings, rows, datasetRef, intent, hierarchy, sankey, chord, network, geo, id, name, description or opacity (OODS-V166).","enum":["pattern:viz:bubble-distribution","pattern:viz:correlation-matrix","pattern:viz:correlation-scatter","pattern:viz:detail-overview-bar","pattern:viz:diverging-bar","pattern:viz:drilldown-stacked-bar","pattern:viz:facet-small-multiples-line","pattern:viz:facet-target-band","pattern:viz:focus-context-line","pattern:viz:grouped-bar","pattern:viz:histogram","pattern:viz:layered-line-area","pattern:viz:multi-series-line","pattern:viz:running-total-area","pattern:viz:simple-bar","pattern:viz:sparkline-grid","pattern:viz:stacked-100-bar","pattern:viz:stacked-area-projection","pattern:viz:stacked-bar","pattern:viz:target-band-line","pattern:viz:time-grid-heatmap","pattern:viz:waterfall"],"type":"string"},"rows":{"description":"Inline data rows — the primary data path. Bounded: a few hundred rows is the sweet spot. Each row is a flat object mapping field name to value.","items":{"additionalProperties":true,"type":"object"},"maxItems":5000,"minItems":1,"type":"array"},"sankey":{"additionalProperties":false,"description":"Flow data for chartType 'sankey' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Nodes plus value-weighted links; every link MUST carry a numeric 'value' (the link width IS the flow magnitude) and reference existing node names.","properties":{"links":{"description":"Directed, value-weighted flows between nodes. Each (source, target) pair should be unique — a duplicate directed flow double-counts the link width. (Uniqueness is advisory for sankey; it is not warning-enforced.)","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target","value"],"type":"object"},"minItems":1,"type":"array"},"nodes":{"description":"Flow nodes. Each carries a unique 'name'; an optional numeric 'value' overrides the computed throughput.","items":{"additionalProperties":true,"properties":{"name":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"strictFields":{"default":false,"description":"Field/key-presence STRICT switch. When true, a referenced data key that does not resolve is surfaced in `warnings` instead of a silent confident-wrong result: (m05) an explicit tabular chart whose encoding references a field ABSENT from every (non-empty) row → OODS-V131; (m06) a choropleth corridor whose join key has NO matching map feature → OODS-V134 (per unmatched corridor). DEFAULT false keeps today's behavior byte-identical (the geo silent-drop preserved). The dashboard.render strict check (its own `strictFields`) escalates V131 to an error panel via `onPanelError`.","type":"boolean"},"theme":{"default":"light","enum":["light","dark","hc"],"type":"string"}},"title":"Viz render input","type":"object"}

after
{"$defs":{"colorEncodingBinding":{"description":"A color-channel encoding binding: like encodingBinding, plus an optional explicit `range` (hex colors) that overrides the baked OODS categorical palette on a nominal/ordinal color scale. `range` is only valid on the color channel.","oneOf":[{"minLength":1,"type":"string"},{"additionalProperties":false,"properties":{"aggregate":{"enum":["sum","count","average","median","min","max","distinct"],"type":"string"},"field":{"minLength":1,"type":"string"},"range":{"description":"Explicit hex colors for a nominal/ordinal color scale. Overrides the baked OODS categorical palette so an agent can supply its own scale (e.g. a 2-color presence scale). Applied in array order to the distinct series; a shorter range recycles (Vega domain[i]->range[i] mod len). Cartesian color only.","items":{"pattern":"^#(?:[0-9a-fA-F]{3}){1,2}$","type":"string"},"minItems":2,"type":"array"},"scale":{"enum":["linear","temporal","log","sqrt","band","point","diverging"],"type":"string"},"sort":{"oneOf":[{"enum":["none","ascending","descending"],"type":"string"},{"additionalProperties":false,"properties":{"field":{"type":"string"},"order":{"enum":["ascending","descending"],"type":"string"}},"required":["field","order"],"type":"object"}]},"timeUnit":{"enum":["year","quarter","month","week","day","hour","minute","second"],"type":"string"},"title":{"type":"string"},"type":{"description":"Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.","enum":["quantitative","temporal","ordinal","nominal"],"type":"string"}},"required":["field"],"type":"object"}]},"encodingBinding":{"description":"An encoding binding: either a bare field-name string, or an object with the field plus optional aggregate/scale/timeUnit/sort/title.","oneOf":[{"minLength":1,"type":"string"},{"additionalProperties":false,"properties":{"aggregate":{"enum":["sum","count","average","median","min","max","distinct"],"type":"string"},"currency":{"description":"ISO 4217 code of the amounts this channel encodes, for example EUR. The labels print its en-US symbol where the format has \"$\" (EUR €, GBP £); without a format they read \"$,f\" ($12,000). One currency per chart.","pattern":"^[A-Za-z]{3}$","type":"string"},"field":{"minLength":1,"type":"string"},"format":{"description":"Label format of this channel's axis (x, y) or legend: a d3-format specifier such as \"$,f\" or \",.0f\" (d3-time-format for a temporal field). \"$\" prints the currency symbol: the currency's, else $. Without a precision, labels take the precision of the tick step, so neighbouring ticks never print the same text. Carried in the normalized spec, so artifact.certify replays it.","maxLength":64,"minLength":1,"type":"string"},"scale":{"enum":["linear","temporal","log","sqrt","band","point","diverging"],"type":"string"},"sort":{"oneOf":[{"enum":["none","ascending","descending"],"type":"string"},{"additionalProperties":false,"properties":{"field":{"type":"string"},"order":{"enum":["ascending","descending"],"type":"string"}},"required":["field","order"],"type":"object"}]},"timeUnit":{"enum":["year","quarter","month","week","day","hour","minute","second"],"type":"string"},"title":{"type":"string"},"type":{"description":"Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.","enum":["quantitative","temporal","ordinal","nominal"],"type":"string"}},"required":["field"],"type":"object"}]},"hierarchyNode":{"additionalProperties":true,"description":"A nested-hierarchy node: a name, an optional numeric value, and optional children (recursive). Extra fields are preserved for tooltips.","properties":{"children":{"items":{"$ref":"#/$defs/hierarchyNode"},"type":"array"},"name":{"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"}},"$id":"https://designlab.local/schemas/viz.render.input.json","$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"description":"Render a real, data-bound visualization. Supply a registered pattern identity to preserve its source data and presentation, chartType + encodings for explicit mode, or rows for suggest or structured-intent mode. Retired patterns are not offered; structurally unsupported patterns return OODS-V167; pattern conflicts with explicit data, intent, or source identity/presentation overrides return OODS-V166. Brand, theme and output controls remain available.","properties":{"a11yEquivalence":{"default":true,"description":"A11y equivalence CERTIFY-AT-EMISSION switch. DEFAULT ON. The cartesian (Vega-Lite) emission is checked against the accessible-equivalence engine (validateVizEquivalenceRules): error-severity rules BLOCK (status:'error' with per-rule OODS-<rule.id> codes in `errors`), warn-severity failures surface in `warnings` as OODS-<rule.id>. Default builder output is conformant-BY-CONSTRUCTION , so generated specs pass; set false to opt out for agent-supplied non-conformant specs. Scoped to the cartesian path (the ECharts-primary scaffold has empty data and would spuriously fail data-equivalence rules).","type":"boolean"},"brand":{"default":"A","enum":["A","B"],"type":"string"},"chartType":{"description":"Chart type. The tabular marks (bar->MarkBar, line->MarkLine, area->MarkArea, scatter->MarkPoint, heatmap->MarkRect) bind inline rows with x/y encodings. The hierarchy/flow/network/geo charts are explicit-only and return an ECharts option as the primary spec (no Vega-Lite equivalent): 'treemap' and 'sunburst' take the 'hierarchy' data branch; 'sankey' takes the 'sankey' data branch (nodes + value-weighted links); 'force_graph' takes the 'network' data branch (nodes + links); 'choropleth', 'bubble_map', and 'flow_map' take the 'geo' data branch (inline geometry + per-type encoding — flow_map draws origin→destination arcs); 'chord' takes the 'chord' data branch (sankey-shaped nodes + value-weighted links — a ring of category arcs joined by ribbons whose width is the value). Omit chartType to enter suggest mode (the recommender chooses a tabular type from the inferred field profiles).","enum":["bar","line","area","scatter","heatmap","treemap","sunburst","sankey","force_graph","choropleth","bubble_map","flow_map","chord"],"type":"string"},"chord":{"additionalProperties":false,"description":"Chord data for chartType 'chord' (explicit-only) — used INSTEAD of rows + x/y encodings. A native ECharts ribbon diagram: a ring of category arcs connected by weighted ribbons. Sankey-shaped — nodes plus value-weighted links; every link MUST carry a numeric 'value' (the ribbon width IS the flow magnitude) and reference existing node names — a link naming a node absent from 'nodes' fails loud (OODS-V147).","properties":{"links":{"description":"Directed, value-weighted ribbons between ring arcs (matched to arcs by name). Directed: source→target and target→source are distinct ribbons (a reciprocal pair is valid data). Each (source, target) pair should be unique — a duplicate directed link double-counts the ribbon and is flagged with a warning (OODS-V148).","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target","value"],"type":"object"},"minItems":1,"type":"array"},"nodes":{"description":"Ring arcs. Each carries a unique 'name'.","items":{"additionalProperties":true,"properties":{"name":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"description":{"description":"Optional override for the synthesized accessibility description. When omitted, a non-empty description is generated from the encodings.","type":"string"},"encodings":{"additionalProperties":false,"description":"Channel -> field bindings. Required, with at least x and y, when chartType is supplied (explicit mode).","properties":{"color":{"$ref":"#/$defs/colorEncodingBinding"},"detail":{"$ref":"#/$defs/encodingBinding"},"shape":{"$ref":"#/$defs/encodingBinding"},"size":{"$ref":"#/$defs/encodingBinding"},"x":{"$ref":"#/$defs/encodingBinding"},"y":{"$ref":"#/$defs/encodingBinding"}},"type":"object"},"geo":{"additionalProperties":false,"description":"Geo data for chartType 'choropleth', 'bubble_map', or 'flow_map' (explicit-only) — used INSTEAD of rows + x/y encodings. Carries INLINE geometry (a GeoJSON FeatureCollection in 'geojson', or a TopoJSON Topology in 'topojson' + 'topoObjectName'), an optional 'join' that merges tabular 'rows' into features by key, and the per-type encoding: 'valueField' colours regions for choropleth; 'longitudeField'/'latitudeField' (+ optional 'sizeField'/'colorField') place points for bubble_map; 'originLongitudeField'/'originLatitudeField'/'destinationLongitudeField'/'destinationLatitudeField' (+ optional 'strengthField'/'curvature') draw origin→destination ARCS for flow_map. Geometry is supplied INLINE — it is never fetched over the network. NOTE: geo specs are NOT self-contained (unlike treemap/sankey): the resolved FeatureCollection rides back on echartsSpec.__registration and the client re-registers the map by name before rendering. Geometry payloads can be large (a world atlas is ~100KB) — prefer a pre-simplified TopoJSON.","properties":{"colorField":{"description":"Bubble map: optional row field driving bubble colour.","minLength":1,"type":"string"},"colorScale":{"description":"Optional colour scale (defaults to a continuous linear ramp). 'ordinal' paints discrete per-category colours; 'diverging' ramps two hues about a neutral midpoint (zero).","enum":["linear","quantize","quantile","threshold","ordinal","diverging"],"type":"string"},"curvature":{"description":"Flow map: optional arc curveness (0 = straight, ~0.3 default). Bends each origin→destination line into an arc.","maximum":1,"minimum":0,"type":"number"},"destinationLatitudeField":{"description":"Flow map: the row field holding the DESTINATION latitude. Required for flow_map.","minLength":1,"type":"string"},"destinationLongitudeField":{"description":"Flow map: the row field holding the DESTINATION longitude. Required for flow_map.","minLength":1,"type":"string"},"geojson":{"additionalProperties":true,"description":"Inline GeoJSON FeatureCollection (type:'FeatureCollection', features:[...]). Required for choropleth (the regions); optional base map for bubble_map.","type":"object"},"join":{"additionalProperties":false,"description":"Choropleth join: merge each row into the feature whose 'featureProperty' equals the row's 'dataKey' value.","properties":{"dataKey":{"description":"Key in each tabular row.","minLength":1,"type":"string"},"featureProperty":{"description":"Matching property name in each feature's properties.","minLength":1,"type":"string"}},"required":["dataKey","featureProperty"],"type":"object"},"latitudeField":{"description":"Bubble map: the row field holding latitude. Required for bubble_map.","minLength":1,"type":"string"},"longitudeField":{"description":"Bubble map: the row field holding longitude. Required for bubble_map.","minLength":1,"type":"string"},"originLatitudeField":{"description":"Flow map: the row field holding the ORIGIN latitude. Required for flow_map.","minLength":1,"type":"string"},"originLongitudeField":{"description":"Flow map: the row field holding the ORIGIN longitude. Required for flow_map.","minLength":1,"type":"string"},"rows":{"description":"Tabular records: for choropleth, the values joined into features (paired with 'join'); for bubble_map, the points to plot.","items":{"additionalProperties":true,"type":"object"},"maxItems":5000,"type":"array"},"sizeField":{"description":"Bubble map: optional row field driving bubble size.","minLength":1,"type":"string"},"strengthField":{"description":"Flow map: optional numeric row field whose magnitude drives each arc's line width (via a continuous visualMap).","minLength":1,"type":"string"},"topoObjectName":{"description":"Which TopoJSON object to extract (defaults to the sole object when there is exactly one).","minLength":1,"type":"string"},"topojson":{"additionalProperties":true,"description":"Inline TopoJSON Topology (type:'Topology'); converted to a GeoJSON FeatureCollection. Set 'topoObjectName' when the topology holds more than one object.","type":"object"},"valueField":{"description":"Choropleth: the numeric field — in feature properties, or merged in via 'join' — whose value colours each region. Required for choropleth.","minLength":1,"type":"string"}},"type":"object"},"hierarchy":{"description":"Hierarchy data for chartType 'treemap' or 'sunburst' (explicit-only) — used INSTEAD of rows + x/y encodings. A discriminated union on 'type': 'adjacency_list' (flat nodes linked by parentId; a node whose parent is missing becomes its own root) or 'nested' (a single root node with children).","oneOf":[{"additionalProperties":false,"properties":{"data":{"description":"Flat node list. Each node carries id, parentId (null for roots), and a numeric value.","items":{"additionalProperties":true,"properties":{"id":{"minLength":1,"type":"string"},"name":{"type":"string"},"parentId":{"type":["string","null"]},"value":{"type":"number"}},"required":["id","parentId","value"],"type":"object"},"minItems":1,"type":"array"},"type":{"const":"adjacency_list"}},"required":["type","data"],"type":"object"},{"additionalProperties":false,"properties":{"data":{"$ref":"#/$defs/hierarchyNode"},"type":{"const":"nested"}},"required":["type","data"],"type":"object"}]},"id":{"description":"Optional stable identifier for the produced spec.","type":"string"},"intent":{"additionalProperties":false,"description":"STRUCTURED (typed, NOT free-text) visualization intent — the deterministic half of the NL→viz hand-off. Supply it INSTEAD of chartType/encodings (mutually exclusive with chartType): the named measures/dimensions drive ENCODING, `goal` + the data drive the recommender's chartType pick, an optional `chartFamily` post-filters that pick. Requires `rows`.","properties":{"chartFamily":{"description":"Optional preferred chart family. Post-filters the recommender ranking (NOT a scorer term) to this family, flagged lowConfidence when it was not the recommender's top pick. Constrained to the 5 TABULAR marks — the 8 explicit-only types are not recommender-rankable.","enum":["bar","line","area","scatter","heatmap"],"type":"string"},"dimensions":{"description":"Named dimension fields (the breakdowns/axes); may be empty (e.g. a two-measure scatter). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data).","items":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":"string"},"type":{"enum":["quantitative","temporal","nominal","ordinal"],"type":"string"}},"required":["name"],"type":"object"},"type":"array"},"goal":{"description":"The analytical goal that steers the recommender (the live 7-value goal vocabulary).","enum":["comparison","trend","composition","part-to-whole","relationship","intensity","distribution"],"type":"string"},"measures":{"description":"Named measure fields (the metrics to plot). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data).","items":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":"string"},"type":{"enum":["quantitative","temporal","nominal","ordinal"],"type":"string"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["goal","measures","dimensions"],"type":"object"},"name":{"description":"Optional human-friendly chart title.","type":"string"},"network":{"additionalProperties":false,"description":"Network data for chartType 'force_graph' (explicit-only) — used INSTEAD of rows + x/y encodings. Nodes (each with a unique 'id'; an optional 'group' drives category colour) and directed links (optional numeric 'value'). Every link MUST reference existing node ids — a link naming a node absent from 'nodes' fails loud (OODS-V147).","properties":{"links":{"description":"Directed edges between nodes (an empty array is allowed for an all-isolated-nodes graph). Each 'source'/'target' MUST match a node 'id' (a dangling ref fails loud, OODS-V147). Directed: source→target and target→source are distinct edges. Each (source, target) pair should be unique — a duplicate directed edge double-counts and is flagged with a warning (OODS-V148).","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target"],"type":"object"},"type":"array"},"nodes":{"description":"Graph nodes. Each carries a unique 'id'; optional 'group' (category) and 'value' (sizing).","items":{"additionalProperties":true,"properties":{"group":{"type":"string"},"id":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["id"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"opacity":{"description":"Optional constant mark opacity for the five Cartesian chart families. Preserved in normalized mark options and applied to both Vega-Lite and ECharts pixels. Omission preserves renderer defaults. Unsupported for hierarchy, network and geographic chart families.","maximum":1,"minimum":0,"type":"number"},"output":{"additionalProperties":false,"properties":{"height":{"maximum":2000,"minimum":100,"type":"integer"},"includeA11y":{"const":true},"includeNormalizedSpec":{"const":true},"svg":{"const":true},"width":{"maximum":2000,"minimum":100,"type":"integer"}},"required":[],"type":"object"},"pattern":{"description":"Exact versioned pattern source identity. Renderable patterns preserve source rows, identity, presentation and accessibility metadata. Retired identities are not offered (their reasons are in the viz taxonomy). Structurally unsupported scenes return OODS-V167. Static SVG shows the default selection state (OODS-V175). Cannot be combined with chartType, encodings, rows, intent, hierarchy, sankey, chord, network, geo, id, name, description or opacity (OODS-V166).","enum":["pattern:viz:bubble-distribution","pattern:viz:correlation-matrix","pattern:viz:correlation-scatter","pattern:viz:detail-overview-bar","pattern:viz:diverging-bar","pattern:viz:drilldown-stacked-bar","pattern:viz:facet-small-multiples-line","pattern:viz:facet-target-band","pattern:viz:focus-context-line","pattern:viz:grouped-bar","pattern:viz:histogram","pattern:viz:layered-line-area","pattern:viz:multi-series-line","pattern:viz:running-total-area","pattern:viz:simple-bar","pattern:viz:sparkline-grid","pattern:viz:stacked-100-bar","pattern:viz:stacked-area-projection","pattern:viz:stacked-bar","pattern:viz:target-band-line","pattern:viz:time-grid-heatmap","pattern:viz:waterfall"],"type":"string"},"rows":{"description":"Inline data rows — the primary data path. Bounded: a few hundred rows is the sweet spot. Each row is a flat object mapping field name to value.","items":{"additionalProperties":true,"type":"object"},"maxItems":500,"minItems":1,"type":"array"},"sankey":{"additionalProperties":false,"description":"Flow data for chartType 'sankey' (explicit-only) — used INSTEAD of rows + x/y encodings. Nodes plus value-weighted links; every link MUST carry a numeric 'value' (the link width IS the flow magnitude) and reference existing node names.","properties":{"links":{"description":"Directed, value-weighted flows between nodes. Each (source, target) pair should be unique — a duplicate directed flow double-counts the link width. (Uniqueness is advisory for sankey; it is not warning-enforced.)","items":{"additionalProperties":true,"properties":{"source":{"minLength":1,"type":"string"},"target":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["source","target","value"],"type":"object"},"minItems":1,"type":"array"},"nodes":{"description":"Flow nodes. Each carries a unique 'name'; an optional numeric 'value' overrides the computed throughput.","items":{"additionalProperties":true,"properties":{"name":{"minLength":1,"type":"string"},"value":{"type":"number"}},"required":["name"],"type":"object"},"minItems":1,"type":"array"}},"required":["nodes","links"],"type":"object"},"strictFields":{"default":false,"description":"Field/key-presence STRICT switch. When true, a referenced data key that does not resolve is surfaced in `warnings` instead of a silent confident-wrong result: (m05) an explicit tabular chart whose encoding references a field ABSENT from every (non-empty) row → OODS-V131; (m06) a choropleth corridor whose join key has NO matching map feature → OODS-V134 (per unmatched corridor). DEFAULT false keeps today's behavior byte-identical (the geo silent-drop preserved). The dashboard.render strict check (its own `strictFields`) escalates V131 to an error panel via `onPanelError`.","type":"boolean"},"theme":{"default":"light","enum":["light","dark","hc"],"type":"string"}},"title":"Viz render input","type":"object"}

before
—

after
List Components

before
—

after
Look Up Recorded Screen

before
—

after
Snapshot Registry

before
—

after
Read Tool Schema

before
—

after
Render Chart