npm - @opendata-ai/openchart-core - Versions diffs - 8.0.0-rc.9 → 8.1.0 - Mend

@opendata-ai/openchart-core 8.0.0-rc.9 → 8.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (83) hide show

package/README.md +1 -1
package/dist/index.d.ts +403 -45
package/dist/index.js +50 -18
package/dist/index.js.map +1 -1
package/dist/styles.css +1 -1
package/dist/styles.css.map +1 -1
package/package.json +1 -2
package/schema/chart.schema.json +375 -69
package/schema/table.schema.json +35 -1
package/schema/vizspec.schema.json +992 -171
package/src/accessibility/__tests__/alt-text.test.ts +0 -110
package/src/accessibility/__tests__/aria.test.ts +0 -125
package/src/accessibility/alt-text.ts +0 -155
package/src/accessibility/aria.ts +0 -75
package/src/accessibility/index.ts +0 -6
package/src/colors/__tests__/colorblind.test.ts +0 -75
package/src/colors/__tests__/contrast.test.ts +0 -119
package/src/colors/__tests__/palettes.test.ts +0 -74
package/src/colors/colorblind.ts +0 -131
package/src/colors/contrast.ts +0 -143
package/src/colors/index.ts +0 -36
package/src/colors/palettes.ts +0 -206
package/src/helpers/__tests__/deep-merge.test.ts +0 -54
package/src/helpers/__tests__/spec-builders.test.ts +0 -338
package/src/helpers/deep-merge.ts +0 -29
package/src/helpers/spec-builders.ts +0 -479
package/src/index.ts +0 -215
package/src/labels/__tests__/collision.test.ts +0 -310
package/src/labels/collision.ts +0 -249
package/src/labels/index.ts +0 -13
package/src/layout/__tests__/chrome.test.ts +0 -208
package/src/layout/__tests__/text-measure.test.ts +0 -57
package/src/layout/chrome.ts +0 -470
package/src/layout/index.ts +0 -18
package/src/layout/text-measure.ts +0 -404
package/src/layout/text-wrap.ts +0 -93
package/src/locale/__tests__/format.test.ts +0 -606
package/src/locale/format.ts +0 -459
package/src/locale/index.ts +0 -21
package/src/responsive/__tests__/breakpoints.test.ts +0 -146
package/src/responsive/__tests__/metrics.test.ts +0 -52
package/src/responsive/breakpoints.ts +0 -177
package/src/responsive/index.ts +0 -53
package/src/responsive/metrics.ts +0 -299
package/src/schema/__tests__/generated-artifacts.test.ts +0 -42
package/src/schema/__tests__/schema.test.ts +0 -179
package/src/styles/__tests__/reduced-motion-selectors.test.ts +0 -28
package/src/styles/animation.css +0 -213
package/src/styles/base.css +0 -102
package/src/styles/chrome.css +0 -174
package/src/styles/dark.css +0 -44
package/src/styles/graph.css +0 -135
package/src/styles/index.css +0 -28
package/src/styles/keyframes.css +0 -151
package/src/styles/legend.css +0 -18
package/src/styles/reduced-motion.css +0 -67
package/src/styles/series-search.css +0 -153
package/src/styles/sparkline.css +0 -16
package/src/styles/table-animation.css +0 -93
package/src/styles/table.css +0 -398
package/src/styles/token-definitions.ts +0 -199
package/src/styles/tokens.css +0 -156
package/src/styles/tooltip.css +0 -126
package/src/styles/you-draw-it.css +0 -126
package/src/theme/__tests__/dark-mode.test.ts +0 -232
package/src/theme/__tests__/defaults.test.ts +0 -73
package/src/theme/__tests__/resolve.test.ts +0 -277
package/src/theme/dark-mode.ts +0 -258
package/src/theme/defaults.ts +0 -110
package/src/theme/index.ts +0 -8
package/src/theme/presets.ts +0 -64
package/src/theme/resolve.ts +0 -312
package/src/types/__tests__/encoding.test.ts +0 -368
package/src/types/__tests__/gradient.test.ts +0 -95
package/src/types/__tests__/spec.test.ts +0 -499
package/src/types/encoding.ts +0 -280
package/src/types/events.ts +0 -236
package/src/types/index.ts +0 -290
package/src/types/layout.ts +0 -2024
package/src/types/schema-roots.ts +0 -32
package/src/types/spec.ts +0 -2925
package/src/types/table.ts +0 -108
package/src/types/theme.ts +0 -209

package/schema/chart.schema.json CHANGED Viewed

@@ -111,7 +111,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -152,8 +152,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -380,7 +387,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -421,8 +428,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -649,7 +663,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -690,8 +704,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -918,7 +939,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -959,8 +980,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -1187,7 +1215,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -1228,8 +1256,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -1456,7 +1491,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -1497,8 +1532,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -1725,7 +1767,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -1766,8 +1808,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -1994,7 +2043,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -2035,8 +2084,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -2263,7 +2319,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -2304,8 +2360,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -2532,7 +2595,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -2573,8 +2636,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -2801,7 +2871,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -2842,8 +2912,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -3070,7 +3147,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -3111,8 +3188,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -3339,7 +3423,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -3380,8 +3464,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -3608,7 +3699,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -3649,8 +3740,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -3877,7 +3975,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -3918,8 +4016,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -4146,7 +4251,7 @@
                         },
                         "size": {
                           "type": "number",
-                          "description": "Fixed bar thickness in pixels for bar/column marks. When set, bars are this height (horizontal) or width (vertical), centered within the band."
+                          "description": "Bar/column marks: fixed bar thickness in pixels. When set, bars are this height (horizontal) or width (vertical), centered within the band.\n\nPoint marks: the dot RADIUS in pixels (default 5, typical 2-12). This is NOT Vega-Lite's point `size`, which is an area in px^2 -- a VL size of 110 corresponds to `size: 6` here (r = sqrt(area / pi)). Validation rejects values above 50 with the conversion."
                         },
                         "filled": {
                           "type": "boolean",
@@ -4187,8 +4292,15 @@
                           "description": "Clip marks to the chart area."
                         },
                         "trendline": {
-                          "type": "boolean",
-                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals."
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "$ref": "#/definitions/TrendlineConfig"
+                            }
+                          ],
+                          "description": "Overlay a least-squares regression line on scatter (point) marks. Defaults to true. Set `mark: { type: 'point', trendline: false }` to suppress it when the chart already carries its own reference line (e.g. a manual x=y diagonal in a separate layer), which would otherwise produce two competing diagonals.\n\nPass an object to control stacking order: the line renders `below` the points by default, but a dense scatter (thousands of overlapping dots) fully occludes a line drawn underneath, so `{ layer: 'above' }` lifts the reference line over the cloud."
                         },
                         "dx": {
                           "type": "number",
@@ -4455,6 +4567,29 @@
       "additionalProperties": false,
       "description": "Radial gradient definition. Coordinates are in [0,1] normalized space relative to the mark's bounding box."
     },
+    "TrendlineConfig": {
+      "type": "object",
+      "properties": {
+        "layer": {
+          "type": "string",
+          "enum": [
+            "above",
+            "below"
+          ],
+          "description": "Stacking order relative to the point marks. `'below'` (default) draws the line behind the dots; `'above'` draws it on top so it stays visible over a dense cloud."
+        },
+        "stroke": {
+          "type": "string",
+          "description": "Stroke color. Defaults to the theme's high-contrast text color so the line reads on both light and dark grounds. Set an explicit CSS color to override."
+        },
+        "strokeWidth": {
+          "type": "number",
+          "description": "Stroke width in pixels. Defaults to 1.5. Over a dense cloud with `layer: 'above'`, a heavier line (e.g. 2.5) stays legible where the thin default disappears into the dots."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Configuration for the scatter regression trend line. Passed as the object form of `MarkDef.trendline`."
+    },
     "ArcEncoding<DataRow>": {
       "type": "object",
       "properties": {
@@ -4489,7 +4624,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -4554,6 +4689,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -4901,7 +5044,7 @@
         },
         "padding": {
           "type": "number",
-          "description": "Padding for band/point scales."
+          "description": "Padding for band/point scales. Point-scale default (a categorical x/y on a line/area/point mark) is 0 for line and area marks (the trend runs flush to the plot edges) and 0.5 for other marks (e.g. scatter, so points don't collide with the axis). `paddingOuter` is accepted as an alias here since point scales have no inner bands."
         },
         "paddingInner": {
           "type": "number",
@@ -5063,12 +5206,13 @@
       "type": "string",
       "enum": [
         "top",
+        "top-left",
         "right",
         "bottom",
         "bottom-right",
         "inline"
       ],
-      "description": "Legend position at a given breakpoint."
+      "description": "Legend position at a given breakpoint. `'top-left'` is a map-only overlay position: the legend floats inside the map area's top-left corner (with its own backdrop) instead of reserving a block of figure height. Charts treat it as the default position."
     },
     "AnnotationOffset": {
       "type": "object",
@@ -5860,6 +6004,10 @@
         "color": {
           "type": "string",
           "description": "Text color (CSS color string)."
+        },
+        "maxLines": {
+          "type": "number",
+          "description": "Maximum number of lines this chrome text may wrap to. Additional lines are dropped and the last kept line is truncated with an ellipsis. Bounds the chrome's contribution to layout height at any container width. Applies whether the font size comes from the theme default or an explicit override. Caps height only, not horizontal overflow of a single unbreakable word."
         }
       },
       "additionalProperties": false,
@@ -6912,7 +7060,7 @@
         "update": {
           "anyOf": [
             {
-              "$ref": "#/definitions/AnimationPhaseConfig"
+              "$ref": "#/definitions/UpdatePhaseConfig"
             },
             {
               "type": "boolean"
@@ -6993,6 +7141,36 @@
       "additionalProperties": false,
       "description": "Stagger configuration for sequential element reveal."
     },
+    "UpdatePhaseConfig": {
+      "type": "object",
+      "properties": {
+        "duration": {
+          "type": "number",
+          "description": "Duration in ms. Default: 500 for enter."
+        },
+        "ease": {
+          "$ref": "#/definitions/AnimationEase",
+          "description": "Easing preset. Default: 'smooth'."
+        },
+        "stagger": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AnimationStagger"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Stagger config. true = defaults, false = no stagger. Default: true for enter."
+        },
+        "maxMarks": {
+          "type": "number",
+          "description": "Maximum mark count that still runs a tweened data-update transition. Default: 500. Above the cap the chart swaps instantly instead, because per-frame SVG attribute writes on thousands of elements drop frames on low-end devices. Raise it deliberately when the audience is desktop-heavy and you have measured the frame budget."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Data-update phase config. Adds `maxMarks` on top of the shared phase options; the cap is meaningless for enter/exit, which animate via CSS."
+    },
     "Display": {
       "type": "string",
       "enum": [
@@ -7154,7 +7332,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -7219,6 +7397,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -7265,7 +7451,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -7330,6 +7516,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -7376,7 +7570,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -7441,6 +7635,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -7487,7 +7689,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -7552,6 +7754,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -7598,7 +7808,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -7663,6 +7873,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -7709,7 +7927,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -7774,6 +7992,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -7820,7 +8046,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -7885,6 +8111,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "additionalProperties": false,
@@ -7927,7 +8161,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -7992,6 +8226,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -8035,7 +8277,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -8100,6 +8342,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -8145,7 +8395,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -8210,6 +8460,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -8255,7 +8513,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -8320,6 +8578,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -8366,7 +8632,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -8431,6 +8697,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -8477,7 +8751,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -8542,6 +8816,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "additionalProperties": false,
@@ -8574,7 +8856,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -8639,6 +8921,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -8682,7 +8972,7 @@
               "$ref": "#/definitions/ValueDef"
             }
           ],
-          "description": "Size channel. Used by point/bubble charts to scale dot area by a quantitative field. Accepts a conditional definition to vary size based on data predicates, or a bare `{ value }` constant (VL aligned; expanded to `mark.size`)."
+          "description": "Size channel. Used by point/bubble charts to scale dots by a quantitative field, area-proportionally (sqrt curve). The units are dot RADII in px: `scale.range` defaults to [3, 30] for scatter, and a bare `{ value }` constant expands to `mark.size`, also a radius. This differs from Vega-Lite, where point size is an area in px^2 -- VL-scale values (60-900) are rejected by validation with the conversion. Accepts a conditional definition to vary size based on data predicates."
         },
         "detail": {
           "$ref": "#/definitions/EncodingChannel%3CDataRow%3E",
@@ -8747,6 +9037,14 @@
         "facet": {
           "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
           "description": "Facet channel: partitions data into a grid of small-multiple panels. Each unique value of the facet field produces one panel. Panels share scales by default; use `resolve: { scale: { y: 'independent' } }` for per-panel axes."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Row facet channel: partitions data into vertically-stacked panels. Each unique value of the row field produces one panel, arranged in a single column. Shares the x-axis scale by default; y-axis is independent. Mutually exclusive with `facet` and `column`."
+        },
+        "column": {
+          "$ref": "#/definitions/FacetChannel%3CDataRow%3E",
+          "description": "Column facet channel: partitions data into side-by-side panels. Each unique value of the column field produces one panel, arranged in a single row. Shares the y-axis scale by default; x-axis is independent. Mutually exclusive with `facet` and `row`."
         }
       },
       "required": [
@@ -8783,6 +9081,14 @@
           "$ref": "#/definitions/Chrome",
           "description": "Editorial chrome (title, subtitle, source, etc.)."
         },
+        "chromeLayout": {
+          "type": "string",
+          "enum": [
+            "subtract",
+            "grow"
+          ],
+          "description": "How chrome height interacts with the container height budget.\n\n- `'subtract'` (default): the container height is fixed and chrome text   (title/subtitle/source) is subtracted from it, shrinking the plot. This   is the historical behavior.\n- `'grow'`: the container height is treated as the *plot* budget, and the   rendered SVG grows taller by the measured chrome height. The plot keeps   its full budget (minus axis/padding overhead) regardless of how many   lines the title wraps to.\n\n`'grow'` is a no-op for faceted specs in this version."
+        },
         "title": {
           "anyOf": [
             {
@@ -8884,14 +9190,14 @@
         },
         "watermark": {
           "type": "boolean",
-          "description": "Whether to show the tryOpenData.ai watermark. Defaults to true."
+          "description": "Whether to show the tryOpenData.ai watermark. Defaults to true; auto-hides when the container is under 200px tall (the cramped height class) unless explicitly set."
         },
         "hiddenSeries": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "Series names to hide from rendering. Hidden series remain in the legend but are visually dimmed."
+          "description": "Series names to hide from rendering by default. This is the authored persistence target for legend visibility. Runtime legend toggles (legend-toggle edit events) layer on top of this via ephemeral runtime sets but never modify it."
         },
         "seriesStyles": {
           "type": "object",