cxplot 0.1.23 → 0.1.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cxplot",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "cxplot \u2014 validate, render, hash and export CanvasXpress figure specs with the same engine the browser runs",
   "bin": {
     "cxplot": "bin/cxplot.js"
@@ -22,7 +22,7 @@
   "dependencies": {
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
-    "canvasxpress": "70.8.1",
+    "canvasxpress": "71.0.0",
     "playwright": "1.59.1"
   },
   "keywords": [

package/schema/canvasxpress-config-latest.schema.json

@@ -3,7 +3,7 @@
   "$id": "https://canvasxpress.org/schema/canvasxpress-config-latest.schema.json",
   "title": "CanvasXpress configuration",
   "description": "Machine-generated schema for the CanvasXpress config object. Generated from CanvasXpress.doc (the engine's internal parameter registry) — do not hand-edit; re-run tools/schema/generate-config-schema.js.",
-  "x-cx-version": "70.8",
+  "x-cx-version": "71",
   "type": "object",
   "additionalProperties": true,
   "properties": {
@@ -169,6 +169,40 @@
         "WordCloud"
       ]
     },
+    "areaColumnWidth": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Width of the column marks drawn when areaShowColumns is true, as a fraction (0..1) of the per-category slot",
+      "default": 0.6,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Area Graphs",
+      "x-cx-nl": "Set the area column width to {_float_}",
+      "x-cx-graphtypes": [
+        "Area",
+        "AreaLine"
+      ]
+    },
+    "areaShowColumns": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "Draw a solid bar/column mark at each category on top of the stacked area band (a TrendPlot: stacked bars with a semi-transparent stacked area behind them). Composes with any areaType/areaStyle",
+      "default": false,
+      "x-cx-options": [
+        true,
+        false
+      ],
+      "x-cx-false-disables": true,
+      "x-cx-category": "Area Graphs",
+      "x-cx-nl": "Set the area show columns to {_option_}",
+      "x-cx-graphtypes": [
+        "Area",
+        "AreaLine"
+      ]
+    },
     "areaStyle": {
       "type": [
         "string",
@@ -2800,6 +2834,174 @@
         "Treemap"
       ]
     },
+    "clustreeArrowSize": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Length (pixels) of the clustree edge arrowhead",
+      "default": 9,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "Set the clustree arrow size to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeEdgeArrows": {
+      "type": "boolean",
+      "description": "Flag to draw a directed arrowhead at the child (finer-resolution) end of each clustree transition edge",
+      "default": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "{Draw|Do Not Draw} a directed arrowhead at the child (finer-resolution) end of each clustree transition edge",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeEdgeMinAlpha": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Minimum edge opacity (0..1) so very small transitions stay faintly visible; opacity scales with the incoming proportion up to 1",
+      "default": 0.15,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "Set the clustree edge min alpha to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeEdgePalette": {
+      "type": [
+        "array",
+        "boolean",
+        "string",
+        "number"
+      ],
+      "description": "Ordered hex color stops (low to high transition count) for the clustree edge colour gradient. Defaults to a Spectral ramp",
+      "default": [],
+      "x-cx-false-disables": true,
+      "x-cx-scalar-autowrap": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "Set the clustree edge palette to {_array_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeEdgeWidth": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Constant rendered width (pixels) of clustree transition edges (count is shown by colour, incoming proportion by opacity, as in the clustree package)",
+      "default": 1.5,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "Set the clustree edge width to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeFlip": {
+      "type": "boolean",
+      "description": "Flag to orient a clustree plot left-to-right (resolution on the x-axis) instead of top-to-bottom",
+      "default": false,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "{Orient|Do Not Orient} a clustree plot left-to-right (resolution on the x-axis) instead of top-to-bottom",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeNodeLabels": {
+      "type": "boolean",
+      "description": "Flag to draw the cluster-id label centered on each clustree node",
+      "default": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "{Draw|Do Not Draw} the cluster-id label centered on each clustree node",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeNodePalette": {
+      "type": [
+        "array",
+        "boolean",
+        "string",
+        "number"
+      ],
+      "description": "Qualitative hex colours used to colour clustree nodes by resolution level (one per level, cycled). Defaults to ColorBrewer Paired",
+      "default": [],
+      "x-cx-false-disables": true,
+      "x-cx-scalar-autowrap": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "Set the clustree node palette to {_array_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeNodeTextSize": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Font size (pixels) of the cluster-id label drawn on each clustree node",
+      "default": 9,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "Set the clustree node text size to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreePrefix": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "When deriving a clustree from a cluster-label matrix, use only the columns whose name starts with this prefix (one column per clustering resolution). When unset, every column is treated as a resolution level. Also used as the resolution-axis title",
+      "default": false,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "Set the clustree prefix to {_string_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeShowAxes": {
+      "type": "boolean",
+      "description": "Flag to show the raw numeric layout coordinate axes and grid in a clustree plot (debug). By default only the labelled resolution axis (one tick per clustering level) is shown and the order axis + grid are hidden",
+      "default": false,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "{Show|Do Not Show} the raw numeric layout coordinate axes and grid in a clustree plot (debug)",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeShowEdgeLegend": {
+      "type": "boolean",
+      "description": "Flag to show the clustree edge legends (transition Count colour ramp and In Prop opacity ramp)",
+      "default": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "{Show|Do Not Show} the clustree edge legends (transition Count colour ramp and In Prop opacity ramp)",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "clustreeSweeps": {
+      "type": [
+        "integer",
+        "boolean"
+      ],
+      "description": "Number of barycenter ordering sweeps used to reduce edge crossings in the layered clustree layout",
+      "default": 4,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Clustree Plots",
+      "x-cx-nl": "Set the clustree sweeps to {_integer_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
     "codeType": {
       "type": [
         "string",
@@ -9096,6 +9298,161 @@
         "Violin"
       ]
     },
+    "drillBreadcrumb": {
+      "type": "boolean",
+      "description": "Flag to show the drill-down breadcrumb strip in the viewport when a drillHierarchy is active and the chart has been drilled. Set false for API-only drill control",
+      "default": true,
+      "x-cx-category": "Data",
+      "x-cx-nl": "{Show|Do Not Show} the drill-down breadcrumb strip in the viewport when a drillHierarchy is active and the chart has been drilled",
+      "x-cx-graphtypes": [
+        "Alluvial",
+        "Area",
+        "AreaLine",
+        "Bar",
+        "BarLine",
+        "Boxplot",
+        "Bin",
+        "Binplot",
+        "Bubble",
+        "Bullet",
+        "CDF",
+        "Chord",
+        "Circular",
+        "Cleveland",
+        "Contour",
+        "Correlation",
+        "Density",
+        "Distribution",
+        "Donut",
+        "DotLine",
+        "Dotplot",
+        "Dumbbell",
+        "Fish",
+        "Gantt",
+        "Heatmap",
+        "Hex",
+        "Hexplot",
+        "Histogram",
+        "KaplanMeier",
+        "Line",
+        "Lollipop",
+        "Map",
+        "Meter",
+        "ParallelCoordinates",
+        "OptionsWall",
+        "Pareto",
+        "Pie",
+        "QQ",
+        "Quantile",
+        "Radar",
+        "Ribbon",
+        "Ridgeline",
+        "Sankey",
+        "Scatter2D",
+        "Scatter3D",
+        "ScatterBubble2D",
+        "Spaghetti",
+        "SPLOM",
+        "Stacked",
+        "StackedLine",
+        "StackedPercent",
+        "StackedPercentLine",
+        "Streamgraph",
+        "Sunburst",
+        "TagCloud",
+        "Tornado",
+        "TimeSeries",
+        "Tree",
+        "TreeBracket",
+        "Treemap",
+        "Upset",
+        "Violin",
+        "Volcano",
+        "Waterfall",
+        "WordCloud"
+      ]
+    },
+    "drillHierarchy": {
+      "type": [
+        "array",
+        "boolean",
+        "string",
+        "number"
+      ],
+      "description": "An array of sample annotation names, coarse to fine (e.g. [\"Region\",\"State\",\"City\"]), defining a drill-down hierarchy. When set, clicking a mark filters to the clicked level value and regroups by the next finer annotation; a breadcrumb walks back. Each entry must be a category in the data.x object",
+      "default": [],
+      "x-cx-false-disables": true,
+      "x-cx-scalar-autowrap": true,
+      "x-cx-category": "Data",
+      "x-cx-nl": "Drill-down hierarchy {_multi-factor_}",
+      "x-cx-graphtypes": [
+        "Alluvial",
+        "Area",
+        "AreaLine",
+        "Bar",
+        "BarLine",
+        "Boxplot",
+        "Bin",
+        "Binplot",
+        "Bubble",
+        "Bullet",
+        "CDF",
+        "Chord",
+        "Circular",
+        "Cleveland",
+        "Contour",
+        "Correlation",
+        "Density",
+        "Distribution",
+        "Donut",
+        "DotLine",
+        "Dotplot",
+        "Dumbbell",
+        "Fish",
+        "Gantt",
+        "Heatmap",
+        "Hex",
+        "Hexplot",
+        "Histogram",
+        "KaplanMeier",
+        "Line",
+        "Lollipop",
+        "Map",
+        "Meter",
+        "ParallelCoordinates",
+        "OptionsWall",
+        "Pareto",
+        "Pie",
+        "QQ",
+        "Quantile",
+        "Radar",
+        "Ribbon",
+        "Ridgeline",
+        "Sankey",
+        "Scatter2D",
+        "Scatter3D",
+        "ScatterBubble2D",
+        "Spaghetti",
+        "SPLOM",
+        "Stacked",
+        "StackedLine",
+        "StackedPercent",
+        "StackedPercentLine",
+        "Streamgraph",
+        "Sunburst",
+        "TagCloud",
+        "Tornado",
+        "TimeSeries",
+        "Tree",
+        "TreeBracket",
+        "Treemap",
+        "Upset",
+        "Violin",
+        "Volcano",
+        "Waterfall",
+        "WordCloud"
+      ]
+    },
     "dumbbellArrowDirection": {
       "type": [
         "string",
@@ -23140,6 +23497,7 @@
         "manhattan",
         "manhattanCNV",
         "bin2d",
+        "clustree",
         "polygon",
         "stream"
       ],
@@ -30193,6 +30551,62 @@
       "x-cx-category": "Plot Performance",
       "x-cx-nl": "Set the stream window to {_integer_}"
     },
+    "streamlineColor": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "Fixed color for streamlines (stream mode). When unset (or \"magnitude\") streamlines are colored by velocity magnitude",
+      "default": false,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the streamline color to {_string_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "streamlineSeedStride": {
+      "type": [
+        "integer",
+        "boolean"
+      ],
+      "description": "Seed a streamline every N grid cells (stream mode); larger values draw fewer streamlines",
+      "default": 2,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the streamline seed stride to {_integer_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "streamlineStepSize": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "RK4 step size as a fraction of the grid cell size (stream mode)",
+      "default": 0.5,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the streamline step size to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "streamlineSteps": {
+      "type": [
+        "integer",
+        "boolean"
+      ],
+      "description": "Maximum RK4 integration steps per streamline (stream mode)",
+      "default": 160,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the streamline steps to {_integer_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
     "stringEdgeAttributes": {
       "type": [
         "array",
@@ -34518,6 +34932,249 @@
         "Treemap"
       ]
     },
+    "vectorArrowSize": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Length (pixels) of the arrowhead drawn at each vector tip / streamline midpoint",
+      "default": 7,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector arrow size to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorColorByMagnitude": {
+      "type": "boolean",
+      "description": "Flag to color raw arrows by velocity magnitude (gradient) instead of by the group annotation. Grid arrows and streamlines are always colored by magnitude unless streamlineColor is set",
+      "default": false,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "{Color|Do Not Color} raw arrows by velocity magnitude (gradient) instead of by the group annotation",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorColorValueColor": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "format": "cx-color",
+      "description": "Color for the Fixed arrow color used in raw mode when there is no group annotation and vectorColorByMagnitude is off",
+      "default": "rgb(55,126,184)",
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Color the vector color value {_color_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorDensity": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Fraction (0..1) of samples to draw in raw mode (subsampling for dense embeddings). 1 draws every sample",
+      "default": 1,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector density to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorFieldMode": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "Vector-field rendering mode: raw draws one arrow per sample, grid averages the field onto a regular grid and draws one arrow per cell (quiver), stream draws integrated streamlines (streamplot)",
+      "default": "raw",
+      "enum": [
+        "raw",
+        "grid",
+        "stream",
+        false
+      ],
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector field mode to {_option_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorGridSize": {
+      "type": [
+        "integer",
+        "boolean"
+      ],
+      "description": "Number of cells per axis when averaging the field onto a grid (grid mode) or sampling it for streamlines (stream mode)",
+      "default": 20,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector grid size to {_integer_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorGroupBy": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "Column (sample) name holding a group label used to color raw arrows",
+      "default": false,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector group by to {_string_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorGroupPalette": {
+      "type": [
+        "array",
+        "boolean",
+        "string",
+        "number"
+      ],
+      "description": "Qualitative hex colors used to color raw arrows by group (one per group, cycled). Defaults to ColorBrewer Set1",
+      "default": [],
+      "x-cx-false-disables": true,
+      "x-cx-scalar-autowrap": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector group palette to {_array_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorLineWidth": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Rendered width (pixels) of the arrow shafts and streamlines",
+      "default": 1,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector line width to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorMinMagnitude": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Velocity magnitude below which streamline integration stops (stream mode). Defaults to 1% of the maximum magnitude",
+      "default": false,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector min magnitude to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorPalette": {
+      "type": [
+        "array",
+        "boolean",
+        "string",
+        "number"
+      ],
+      "description": "Ordered hex color stops (low to high magnitude) for the vector / streamline magnitude gradient. Defaults to a blue-white-red ramp",
+      "default": [],
+      "x-cx-false-disables": true,
+      "x-cx-scalar-autowrap": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector palette to {_array_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorScale": {
+      "type": [
+        "number",
+        "boolean"
+      ],
+      "description": "Multiplier applied to the auto arrow length (raw / grid modes). Larger values draw longer arrows",
+      "default": 1,
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector scale to {_float_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorShowLegend": {
+      "type": "boolean",
+      "description": "Flag to show the vector-field legend (magnitude color ramp, or the group legend in raw mode)",
+      "default": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "{Show|Do Not Show} the vector-field legend (magnitude color ramp, or the group legend in raw mode)",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorUBy": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "Column (sample) name holding the x velocity component when the input is a standard Scatter2D matrix",
+      "default": "vx",
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector u by to {_string_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorVBy": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "Column (sample) name holding the y velocity component when the input is a standard Scatter2D matrix",
+      "default": "vy",
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector v by to {_string_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorXBy": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "Column (sample) name holding the x position when the input is a standard Scatter2D matrix",
+      "default": "x",
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector x by to {_string_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
+    "vectorYBy": {
+      "type": [
+        "string",
+        "boolean"
+      ],
+      "description": "Column (sample) name holding the y position when the input is a standard Scatter2D matrix",
+      "default": "y",
+      "x-cx-false-disables": true,
+      "x-cx-category": "Vector Field Plots",
+      "x-cx-nl": "Set the vector y by to {_string_}",
+      "x-cx-graphtypes": [
+        "Scatter2D"
+      ]
+    },
     "vennColors": {
       "type": [
         "array",