plotagents 0.5.0 → 0.8.0

package/schema.json

@@ -2,11 +2,8 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://unpkg.com/plotagents/schema.json",
   "title": "plotagents spec",
-  "description": "Declarative chart spec. Data as rows (tidy) plus the field name for each role. Everything else has well-designed defaults.",
+  "description": "Declarative chart spec. Data as rows (tidy) plus the field name for each role. Everything else has well-designed defaults. `data` is required except for kpi (`items`), flowchart (`nodes` + `edges`), chord (`matrix`) and wordcloud with raw `text`.",
   "type": "object",
-  "required": [
-    "data"
-  ],
   "properties": {
     "type": {
       "type": "string",
@@ -42,8 +39,14 @@
         "chord",
         "pyramid",
         "flowchart",
+        "gantt",
+        "wordcloud",
         "choropleth",
         "symbolmap",
+        "pointmap",
+        "table",
+        "corr",
+        "pairplot",
         "barplot",
         "countplot",
         "columns",
@@ -67,6 +70,13 @@
         "pointplot",
         "spider",
         "doughnut",
+        "dotmap",
+        "dot-map",
+        "tilemap",
+        "basemap",
+        "mapa-puntos",
+        "mapa-de-puntos",
+        "latlon",
         "graph",
         "force",
         "red",
@@ -86,13 +96,62 @@
         "symbol",
         "bubblemap",
         "mapa-simbolos",
+        "words",
+        "word-cloud",
+        "wordclouds",
+        "tagcloud",
+        "tag-cloud",
+        "nube",
+        "nube-de-palabras",
+        "cloud",
+        "timeline",
+        "roadmap",
+        "schedule",
+        "cronograma",
+        "carta-gantt",
+        "ganttchart",
+        "gantt-chart",
+        "planning",
+        "tabla",
+        "tables",
+        "datatable",
+        "data-table",
+        "grid",
+        "tableau",
+        "tabelle",
+        "tabela",
+        "spreadsheet",
+        "planilla",
+        "correlation",
+        "correlations",
+        "corrplot",
+        "corrmatrix",
+        "corr-matrix",
+        "correlation-matrix",
+        "correlogram",
+        "correlograma",
+        "correlacion",
+        "correlación",
+        "matriz-correlacion",
+        "matriz-de-correlacion",
+        "matriz-de-correlación",
+        "clustermap",
+        "cluster-map",
+        "pairs",
+        "pairgrid",
+        "splom",
+        "scattermatrix",
+        "scatter-matrix",
+        "scatterplot-matrix",
+        "matriz-de-dispersion",
+        "matriz-de-dispersión",
         "tree",
         "stat",
         "stats",
         "number",
         "heat"
       ],
-      "description": "Compare: bar, count. Time: line, area. Relationships: scatter, bubble, regplot, residplot, jointplot, radar. Distributions (seaborn): hist, kde, ecdf, box, violin, strip, swarm, point. Part-to-whole: treemap, sunburst, donut, pie. Other: heatmap, sankey, kpi. seaborn names are accepted (barplot, countplot, histplot, kdeplot, boxplot, violinplot, lmplot…). \"auto\" (default) picks from the data."
+      "description": "Compare: bar, count. Time: line, area. Schedules: gantt. Relationships: scatter, bubble, regplot, residplot, jointplot, radar, corr (correlation matrix; clustermap), pairplot (scatter-plot matrix). Distributions (seaborn): hist, kde, ecdf, box, violin, strip, swarm, point. Part-to-whole: treemap, sunburst, donut, pie. Other: heatmap, sankey, kpi, network, chord, pyramid, flowchart, wordcloud. Maps: choropleth, symbolmap, pointmap (lat/lon dots over a tile basemap). seaborn names are accepted (barplot, countplot, histplot, kdeplot, boxplot, violinplot, lmplot…). \"auto\" (default) picks from the data."
     },
     "data": {
       "description": "Array of rows, e.g. [{ \"region\": \"Biobío\", \"sales\": 1240 }]. For kpi it can be omitted in favor of `items`.",
@@ -124,9 +183,13 @@
       "type": "string",
       "enum": [
         "es",
-        "en"
+        "en",
+        "pt",
+        "fr",
+        "de",
+        "auto"
       ],
-      "description": "Language and number format. Default \"es\" (1.234,5); use \"en\" for 1,234.5."
+      "description": "Language and number format. Default \"es\" (1.234,5); \"en\" for 1,234.5; also \"pt\", \"fr\", \"de\". \"auto\" recognizes the language from the title, subtitle, column names and categories (tables do this when `locale` is omitted)."
     },
     "x": {
       "type": "string",
@@ -150,6 +213,10 @@
       "type": "string",
       "description": "Field that splits the data into colored series. Alias: hue."
     },
+    "color": {
+      "type": "string",
+      "description": "Alias of series when it names a field (a \"#hex\" value is a fixed color instead)."
+    },
     "hue": {
       "type": "string",
       "description": "Alias of series (seaborn naming)."
@@ -164,7 +231,7 @@
     },
     "group": {
       "type": "string",
-      "description": "Level-1 group field for a two-level treemap (shortcut for path)."
+      "description": "Level-1 group field for a two-level treemap (shortcut for path). gantt: phase/workstream field (one colored section per phase). table: rows grouped under a header per value."
     },
     "path": {
       "type": "array",
@@ -249,29 +316,211 @@
         }
       }
     },
+    "text": {
+      "description": "wordcloud: field with the words, OR the raw text to count (a string or a list of strings, e.g. open survey answers). Raw text drops Spanish/English stopwords.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      ]
+    },
+    "textField": {
+      "type": "string",
+      "description": "wordcloud: field holding free text in each row; words are counted across rows."
+    },
+    "stopwords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "wordcloud: extra words to ignore when counting raw text."
+    },
+    "minFont": {
+      "type": "number",
+      "description": "wordcloud: smallest font size (default 11)."
+    },
+    "maxFont": {
+      "type": "number",
+      "description": "wordcloud: largest font size (default from the panel size)."
+    },
+    "task": {
+      "type": "string",
+      "description": "gantt: task name field (one row per task)."
+    },
+    "start": {
+      "type": "string",
+      "description": "gantt: start date field (\"2026-03-02\", \"2026-03\") or a number (e.g. week)."
+    },
+    "end": {
+      "type": "string",
+      "description": "gantt: end date field. Day dates are inclusive. Missing end, or end equal to start, makes a milestone."
+    },
+    "duration": {
+      "type": "string",
+      "description": "gantt: duration field (days, or units of a numeric axis) instead of `end`."
+    },
+    "progress": {
+      "type": "string",
+      "description": "gantt: completion field, 0–1 or 0–100. The filled part of each bar is the progress."
+    },
+    "dependsOn": {
+      "type": "string",
+      "description": "gantt: field with the name(s) of the predecessor task(s) (\"A\" or \"A, B\"): draws arrows."
+    },
+    "milestone": {
+      "type": "string",
+      "description": "gantt: boolean field that marks milestones (drawn as diamonds)."
+    },
+    "today": {
+      "description": "gantt: date of the \"today\" line (\"2026-03-12\"), or true for the current date.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "number"
+        }
+      ]
+    },
+    "groupHeaders": {
+      "description": "gantt: false draws phases as a color legend instead of section headers.",
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "compact"
+          ]
+        }
+      ]
+    },
+    "rowHeight": {
+      "type": "number",
+      "description": "gantt: row height in px."
+    },
+    "collapsed": {
+      "description": "gantt: phases (values of `group`) drawn collapsed into one summary row; true collapses all. In the browser a click on a phase header toggles it.",
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      ]
+    },
+    "collapsible": {
+      "type": "boolean",
+      "description": "gantt: false disables click-to-collapse of phases in the browser."
+    },
+    "critical": {
+      "type": "boolean",
+      "description": "gantt: highlight the critical path, the zero-slack chain along `dependsOn`."
+    },
+    "criticalColor": {
+      "type": "string",
+      "description": "gantt: color of the critical path."
+    },
+    "weekends": {
+      "type": "boolean",
+      "description": "gantt: shade weekends on day plans of up to 120 days (default true)."
+    },
+    "todayColor": {
+      "type": "string",
+      "description": "gantt: color of the \"today\" line."
+    },
+    "sort": {
+      "type": "string",
+      "enum": [
+        "desc",
+        "asc",
+        "none",
+        "alpha",
+        "start"
+      ],
+      "description": "bar: category order (desc by default unless the categories are time). gantt: \"start\" orders tasks by start date. donut/chord: \"none\" keeps the data order."
+    },
     "geo": {
-      "description": "choropleth/symbolmap: \"chile\" (16 regions, default), \"usa\" (50 states + DC, Albers with Alaska/Hawaii insets; Puerto Rico when it has data), \"world\" (countries), a name registered with registerGeo(), or a GeoJSON FeatureCollection.",
+      "description": "choropleth/symbolmap: \"chile\" (16 regions, default), \"usa\" (50 states + DC, Albers with Alaska/Hawaii insets; Puerto Rico when it has data), \"world\" (countries), a name registered with registerGeo(), or YOUR OWN geometry: a GeoJSON FeatureCollection, Feature, list of Features or bare geometry, or a TopoJSON Topology. Polygons are filled, LineStrings stroked and Points drawn as dots. In the browser, render() also accepts a URL to a .geojson/.topojson file.",
       "anyOf": [
         {
           "type": "string"
         },
         {
           "type": "object"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
         }
       ]
     },
+    "geoObject": {
+      "type": "string",
+      "description": "TopoJSON: name of the object inside `objects` to draw (default: the first one)."
+    },
     "key": {
       "type": "string",
       "description": "choropleth/symbolmap: data field with the region, state or country name/code to match (US: \"TX\", \"Texas\", \"06\")."
     },
     "projection": {
-      "type": "string",
-      "enum": [
-        "mercator",
-        "equalEarth",
-        "albersUsa"
-      ],
-      "description": "choropleth/symbolmap: map projection (picked automatically)."
+      "description": "Map projection (picked automatically): \"mercator\", \"equalEarth\", \"albersUsa\", \"equirectangular\", \"conic\" (or { type: \"conic\", parallels: [-30, -45], rotate: 72 }), \"identity\" (coordinates already in pixels, y down) or \"planar\" (projected coordinates such as UTM metres, y up; chosen automatically when coordinates are outside lon/lat range).",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "mercator",
+            "equalEarth",
+            "albersUsa",
+            "equirectangular",
+            "conic",
+            "identity",
+            "planar"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string"
+            },
+            "parallels": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              }
+            },
+            "rotate": {
+              "type": "number"
+            },
+            "center": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              }
+            }
+          }
+        }
+      ]
     },
     "values": {
       "type": "boolean",
@@ -279,7 +528,169 @@
     },
     "featureKey": {
       "type": "string",
-      "description": "choropleth: feature property to match against (default tries code, id, ISO-3, name and aliases)."
+      "description": "choropleth: feature property to match `key` against. Default tries code, id, ISO-3, name and aliases, then any property whose values match the data (e.g. \"CUT_REG\", \"GEOID\")."
+    },
+    "nameKey": {
+      "type": "string",
+      "description": "choropleth: feature property with the display name (default: name, NOMBRE, NAME_1, ADMIN…)."
+    },
+    "fitTo": {
+      "description": "Map framing: zoom to some regions (names or codes), a bounding box [lonMin, latMin, lonMax, latMax], or \"markers\". The rest of the map stays as context, clipped.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "number"
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "markers": {
+      "description": "Map: points on top, from [{ lon, lat, label, value?, color? }] or { data, lon, lat, label, size, color, legend, maxRadius, labels }. With a size field, circles are area-proportional.",
+      "anyOf": [
+        {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        },
+        {
+          "type": "object"
+        }
+      ]
+    },
+    "layers": {
+      "type": "array",
+      "description": "Map: extra GeoJSON drawn over (or `below: true` under) the regions: rivers, roads, routes, borders, points. Each { geo, label?, stroke?, width?, fill?, dash?, opacity?, below? }; a `label` adds a legend key.",
+      "items": {
+        "type": "object"
+      }
+    },
+    "borderColor": {
+      "type": "string",
+      "description": "Map: color of the borders between regions."
+    },
+    "borderWidth": {
+      "type": "number",
+      "description": "Map: width of the borders between regions."
+    },
+    "pointRadius": {
+      "type": "number",
+      "description": "Map: radius of Point features in your own GeoJSON (default 5)."
+    },
+    "missing": {
+      "type": "string",
+      "enum": [
+        "hatch",
+        "plain"
+      ],
+      "description": "choropleth: how regions without data look: hatched (default) or \"plain\" (flat tint)."
+    },
+    "thresholds": {
+      "type": "array",
+      "items": {
+        "type": "number"
+      },
+      "description": "choropleth: class breaks (same as a list in `scale`)."
+    },
+    "lat": {
+      "type": "string",
+      "description": "pointmap: latitude field (auto-detected: lat, latitude, latitud)."
+    },
+    "lon": {
+      "type": "string",
+      "description": "pointmap: longitude field (auto-detected: lon, lng, longitude, longitud)."
+    },
+    "tiles": {
+      "description": "pointmap: basemap. \"osm\" (default), \"esri-gray\", \"esri-dark\", \"carto-light\", \"carto-dark\", \"mapbox-light\", \"mapbox-dark\" (needs `tilesKey`), your own { url, attribution, subdomains, maxZoom, retina } with {z}/{x}/{y}, or false for none (vector world outline).",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "osm",
+            "esri-gray",
+            "esri-dark",
+            "carto-light",
+            "carto-dark",
+            "mapbox-light",
+            "mapbox-dark"
+          ]
+        },
+        {
+          "type": "boolean",
+          "enum": [
+            false
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "url": {
+              "type": "string"
+            },
+            "attribution": {
+              "type": "string"
+            },
+            "subdomains": {
+              "type": "string"
+            },
+            "maxZoom": {
+              "type": "number"
+            },
+            "retina": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "url"
+          ]
+        }
+      ]
+    },
+    "tilesKey": {
+      "type": "string",
+      "description": "pointmap: API key or PUBLIC token for the tile provider (Mapbox \"pk.…\"; a secret \"sk.\" token is rejected because it would be visible in the SVG)."
+    },
+    "tileStyle": {
+      "type": "string",
+      "enum": [
+        "muted",
+        "original"
+      ],
+      "description": "pointmap: \"muted\" (default) desaturates the basemap so the data stands out; \"original\" keeps its colors."
+    },
+    "tileOpacity": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "pointmap: basemap opacity."
+    },
+    "zoom": {
+      "type": "number",
+      "description": "pointmap: tile zoom level (automatic from the points by default)."
+    },
+    "center": {
+      "type": "array",
+      "items": {
+        "type": "number"
+      },
+      "minItems": 2,
+      "maxItems": 2,
+      "description": "pointmap: map center [lon, lat] (default: fitted to the points)."
+    },
+    "tall": {
+      "type": "boolean",
+      "description": "Map: false prevents the tall layout (map on the left, ranked label column on the right) for elongated territories."
     },
     "midpoint": {
       "type": "number",
@@ -289,6 +700,26 @@
       "type": "integer",
       "description": "choropleth: number of color classes (default 5)."
     },
+    "scale": {
+      "description": "choropleth: \"quantile\" (default), \"equal\", \"continuous\", \"categorical\" (text values get one color each; automatic when `value` holds text) or a list of thresholds.",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "quantile",
+            "equal",
+            "continuous",
+            "categorical"
+          ]
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "number"
+          }
+        }
+      ]
+    },
     "nodes": {
       "type": "array",
       "items": {
@@ -307,9 +738,53 @@
       "type": "string",
       "enum": [
         "force",
+        "circular",
+        "radial",
+        "concentric",
+        "clusters",
+        "tree",
+        "grid",
         "circle"
       ],
-      "description": "network layout."
+      "description": "network layout: \"force\" (default) deterministic force-directed; \"circular\" around a circle by group with names rotated outward (\"circle\" = circular); \"radial\" tree rings from `focus` or the most connected node; \"concentric\" rings by weight; \"clusters\" one cluster per group; \"tree\" the radial tree laid flat; \"grid\" ordered by group."
+    },
+    "curveness": {
+      "type": "number",
+      "minimum": 0,
+      "description": "network: edge bend as a share of its length (default 0.3; 0 = straight)."
+    },
+    "maxRadius": {
+      "type": "number",
+      "description": "network/symbolmap/pointmap/bubble: largest node or circle radius in px."
+    },
+    "iterations": {
+      "type": "integer",
+      "description": "network: force-layout iterations (automatic by size)."
+    },
+    "nodeId": {
+      "type": "string",
+      "description": "network: id field in `nodes` (default id/name)."
+    },
+    "nodeLabel": {
+      "type": "string",
+      "description": "network: label field in `nodes` (default label, else the id)."
+    },
+    "labelOrientation": {
+      "type": "string",
+      "enum": [
+        "horizontal",
+        "radial"
+      ],
+      "description": "chord: label orientation (radial by default above 10 groups)."
+    },
+    "ribbonColor": {
+      "type": "string",
+      "enum": [
+        "source",
+        "smaller",
+        "larger"
+      ],
+      "description": "chord: ribbon color: \"source\" (default when directed), \"smaller\" group (default) or \"larger\" flow."
     },
     "matrix": {
       "type": "array",
@@ -356,9 +831,256 @@
       "type": "string",
       "description": "One panel per value of this field (small multiples, seaborn col). Shared scales and colors."
     },
+    "col": {
+      "type": "string",
+      "description": "Alias of facet (seaborn naming)."
+    },
+    "facetOrder": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "facet: panel order (values of the facet field; the rest follow)."
+    },
     "columns": {
+      "description": "table: the columns, in order: field names or objects { field, label, type, format, align, width, good, target, colorScale, total, lines }. Column types: text, number, bar (data bar), heat (cell color), delta (▲/▼ change, colored by `good`), sparkline (field holds a list of numbers), progress (meter vs `target` field/number, or 0–1 / 0–100), badge (status pill; status words in es/en/pt/fr/de get good/warning/critical colors), check (booleans as ✓), date, link, rank. Omit to infer everything. facet: panels per row (an integer, seaborn col_wrap). kpi: tiles per row.",
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "text",
+                      "number",
+                      "bar",
+                      "heat",
+                      "delta",
+                      "sparkline",
+                      "progress",
+                      "badge",
+                      "check",
+                      "date",
+                      "link",
+                      "rank"
+                    ]
+                  },
+                  "format": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "object"
+                      }
+                    ]
+                  },
+                  "align": {
+                    "type": "string",
+                    "enum": [
+                      "left",
+                      "right",
+                      "center"
+                    ]
+                  },
+                  "width": {
+                    "type": "number"
+                  },
+                  "good": {
+                    "type": "string",
+                    "enum": [
+                      "up",
+                      "down"
+                    ]
+                  },
+                  "target": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      }
+                    ]
+                  },
+                  "colorScale": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      {
+                        "type": "object"
+                      }
+                    ]
+                  },
+                  "total": {
+                    "anyOf": [
+                      {
+                        "type": "boolean"
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "sum",
+                          "mean",
+                          "min",
+                          "max",
+                          "count"
+                        ]
+                      }
+                    ]
+                  },
+                  "lines": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 6
+                  },
+                  "text": {
+                    "type": "string",
+                    "description": "link: field with the text to show instead of the URL."
+                  },
+                  "sortable": {
+                    "type": "boolean"
+                  }
+                }
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "sortBy": {
+      "type": "string",
+      "description": "table: column to sort by (field or label). Numbers sort high→low by default, text A→Z. In the browser a click on a header sorts."
+    },
+    "sortOrder": {
+      "type": "string",
+      "enum": [
+        "asc",
+        "desc"
+      ],
+      "description": "table: sort direction (same as `sort: \"asc\" | \"desc\"`)."
+    },
+    "pageSize": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "minimum": 1
+        },
+        {
+          "type": "boolean",
+          "enum": [
+            false
+          ]
+        }
+      ],
+      "description": "table: rows per page. Default: all rows up to 15, then pages of 10. false shows every row."
+    },
+    "page": {
       "type": "integer",
-      "description": "facet: panels per row (seaborn col_wrap). Reduced automatically on narrow screens."
+      "minimum": 1,
+      "description": "table: page to show (1-based). In the browser the pager changes it."
+    },
+    "query": {
+      "type": "string",
+      "description": "table: show only rows that contain these words (accent- and case-insensitive)."
+    },
+    "search": {
+      "type": "boolean",
+      "description": "table: search box in the browser (default: on above 20 rows)."
+    },
+    "total": {
+      "description": "table: totals row. true sums numbers (and averages percents and progress); \"mean\"/\"sum\"; or { field: \"sum\" | \"mean\" | false, label }.",
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "sum",
+            "mean",
+            "min",
+            "max"
+          ]
+        },
+        {
+          "type": "object"
+        }
+      ]
+    },
+    "totalLabel": {
+      "type": "string",
+      "description": "table: label of the totals row (default \"Total\"/\"Gesamt\")."
+    },
+    "rank": {
+      "type": "boolean",
+      "description": "table: add a \"#\" column with the position under the current sort."
+    },
+    "cards": {
+      "description": "table: one card per row. \"auto\" (default) switches when the columns do not fit (phones); true always; false never (columns shrink and truncate).",
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "auto"
+          ]
+        }
+      ]
+    },
+    "density": {
+      "type": "string",
+      "enum": [
+        "compact",
+        "normal",
+        "comfortable"
+      ],
+      "description": "table: row height."
+    },
+    "striped": {
+      "type": "boolean",
+      "description": "table: tint every other row (helps on very wide tables)."
+    },
+    "bars": {
+      "type": "boolean",
+      "description": "table: false turns off the automatic data bar on the main numeric column."
+    },
+    "sortable": {
+      "type": "boolean",
+      "description": "table: false disables click-to-sort on headers in the browser."
+    },
+    "sharex": {
+      "type": "boolean",
+      "description": "facet: same x scale in every panel (default true)."
+    },
+    "panelHeight": {
+      "type": "number",
+      "description": "facet: height of each panel in px."
     },
     "sharey": {
       "type": "boolean",
@@ -366,18 +1088,82 @@
     },
     "time": {
       "type": "string",
-      "description": "Time field (d3plus-style): shows one period at a time (the latest by default) and, in the browser, a slider with play. Not used by line/area, which get a range slider."
+      "description": "Time field (d3plus-style): shows one period at a time (the latest by default, or `timeValue`). Add `slider: true` only when the person asks to move through periods."
     },
     "timeValue": {
       "description": "Period to show when `time` is set."
     },
     "slider": {
-      "type": "boolean",
-      "description": "Browser: false removes the time slider (the chart shows `timeValue` or the latest period)."
+      "description": "Browser time controls, OFF by default; set them only when the person asks. true: period buttons when there are few periods (≤ 8), a minimal slider otherwise; line/area get a range slider. \"buttons\" or \"slider\" force one.",
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "buttons",
+            "slider"
+          ]
+        }
+      ]
     },
     "play": {
       "type": "boolean",
-      "description": "Browser: false keeps the time slider but hides the play button."
+      "description": "Browser: false keeps the time controls but hides the play button."
+    },
+    "playInterval": {
+      "type": "number",
+      "description": "Browser: milliseconds per period while playing."
+    },
+    "legend": {
+      "description": "Legend: true/false, or its position \"top\" (default), \"bottom\", \"left\", \"right\" (left/right fall back to bottom under 520px wide), or { position }.",
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "top",
+            "bottom",
+            "left",
+            "right"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "position": {
+              "type": "string",
+              "enum": [
+                "top",
+                "bottom",
+                "left",
+                "right"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "legendTitle": {
+      "type": "string",
+      "description": "Title of a color-ramp or size legend (heatmap, maps)."
+    },
+    "exclude": {
+      "description": "Drop legend entries (series, first hierarchy level, group or donut slice) and recompute axes and shares with the rest. Colors stay fixed; excluded entries remain in the legend, faded, so a click re-adds them. In the browser shift+click on a legend key toggles it.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      ]
     },
     "compare": {
       "description": "With `time`: period to compute changes against: \"previous\" (default), \"first\", a specific period, or false.",
@@ -408,10 +1194,20 @@
     },
     "xRange": {
       "type": "array",
-      "description": "line/area: visible x range [from, to] (what the range slider sets)."
+      "description": "line/area: visible x range [from, to] (what the range slider sets with `slider: true`)."
+    },
+    "showValues": {
+      "type": "boolean",
+      "description": "treemap: show each tile value next to its label."
+    },
+    "hole": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 0.9,
+      "description": "sunburst: size of the center hole as a fraction of the radius (default 0.3)."
     },
     "focus": {
-      "description": "treemap/sunburst: path to drill into, e.g. [\"Mining\"]. network: a node id to center and highlight with its neighbors. In the browser, clicking does it.",
+      "description": "treemap/sunburst: path to drill into, e.g. [\"Mining\"] (in the browser a click on a tile or legend key zooms to it). network: a node id to center and highlight with its neighbors.",
       "anyOf": [
         {
           "type": "string"
@@ -456,6 +1252,23 @@
       },
       "description": "Fixed value-axis domain [min, max]."
     },
+    "valueDomain": {
+      "type": "array",
+      "items": {
+        "type": "number"
+      },
+      "minItems": 2,
+      "maxItems": 2,
+      "description": "box/violin/strip/swarm/point/radar: fixed value-axis domain [min, max] whatever the orientation."
+    },
+    "orient": {
+      "type": "string",
+      "enum": [
+        "v",
+        "h"
+      ],
+      "description": "box/violin/strip/swarm/point: \"v\" vertical or \"h\" horizontal (same as `horizontal`)."
+    },
     "zero": {
       "type": "boolean",
       "description": "line: force (or prevent) a y axis starting at zero."
@@ -468,8 +1281,55 @@
       "type": "string",
       "description": "y-axis title (drawn horizontally above the axis)."
     },
-    "format": {
-      "description": "Value format: \"number\" | \"compact\" | \"percent\" | \"currency\" | \"integer\", or { type, prefix, suffix, decimals, currency }.",
+    "format": {
+      "description": "Value format: \"number\" | \"compact\" | \"percent\" | \"currency\" | \"integer\", or { type, prefix, suffix, decimals (0–20), currency }.",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "number",
+            "compact",
+            "percent",
+            "currency",
+            "integer"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "number",
+                "compact",
+                "percent",
+                "currency",
+                "integer"
+              ]
+            },
+            "prefix": {
+              "type": "string"
+            },
+            "suffix": {
+              "type": "string"
+            },
+            "decimals": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
+            },
+            "currency": {
+              "type": "string"
+            },
+            "scale": {
+              "type": "number"
+            }
+          }
+        }
+      ]
+    },
+    "xFormat": {
+      "description": "Format of x values when x is a measure (scatter, regplot, hist).",
       "anyOf": [
         {
           "type": "string",
@@ -485,8 +1345,62 @@
           "type": "object",
           "properties": {
             "type": {
+              "type": "string",
+              "enum": [
+                "number",
+                "compact",
+                "percent",
+                "currency",
+                "integer"
+              ]
+            },
+            "prefix": {
+              "type": "string"
+            },
+            "suffix": {
+              "type": "string"
+            },
+            "decimals": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
+            },
+            "currency": {
               "type": "string"
             },
+            "scale": {
+              "type": "number"
+            }
+          }
+        }
+      ]
+    },
+    "yFormat": {
+      "description": "Format of y values (overrides `format` on the y axis).",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "number",
+            "compact",
+            "percent",
+            "currency",
+            "integer"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "number",
+                "compact",
+                "percent",
+                "currency",
+                "integer"
+              ]
+            },
             "prefix": {
               "type": "string"
             },
@@ -494,17 +1408,22 @@
               "type": "string"
             },
             "decimals": {
-              "type": "integer"
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
             },
             "currency": {
               "type": "string"
+            },
+            "scale": {
+              "type": "number"
             }
           }
         }
       ]
     },
     "highlight": {
-      "description": "Emphasize one or more categories/series and mute the rest.",
+      "description": "Emphasize one or more categories/series and mute the rest. table: the rows whose label matches.",
       "anyOf": [
         {
           "type": "string"
@@ -566,7 +1485,7 @@
       ]
     },
     "labels": {
-      "description": "Value labels: true, false or \"auto\". In scatter/regplot: a number of points or a list of names to label.",
+      "description": "Value labels: true, false or \"auto\". In scatter/regplot: a number of points or a list of names to label. network: true labels every node.",
       "anyOf": [
         {
           "type": "boolean"
@@ -637,19 +1556,20 @@
       "type": "boolean",
       "description": "Force horizontal orientation (otherwise chosen from label length and count)."
     },
-    "sort": {
-      "type": "string",
-      "enum": [
-        "desc",
-        "asc",
-        "none",
-        "alpha"
-      ],
-      "description": "bar: category order (desc by default unless the categories are time)."
-    },
     "top": {
       "type": "integer",
-      "description": "bar: keep the N largest and fold the rest into \"Other\"."
+      "description": "bar: keep the N largest and fold the rest into \"Other\". table: keep the first N rows after sorting."
+    },
+    "endLabels": {
+      "type": "boolean",
+      "description": "line/regplot: false removes the series names at the end of each line (a legend is drawn instead)."
+    },
+    "labelsFor": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Wide table (y as a list): display names per column, e.g. { \"rev\": \"Revenue\" }."
     },
     "index": {
       "type": "boolean",
@@ -745,7 +1665,7 @@
       "description": "kde: fill the area. line: false removes the gradient under a single line."
     },
     "order": {
-      "description": "regplot: polynomial degree (number). box/violin/strip/swarm/point: category order (list).",
+      "description": "regplot: polynomial degree (number). box/violin/strip/swarm/point: category order (list). corr: variable order (list).",
       "anyOf": [
         {
           "type": "integer"
@@ -780,7 +1700,7 @@
         "scatter",
         "reg"
       ],
-      "description": "jointplot: center plot."
+      "description": "jointplot: center plot. pairplot: \"reg\" adds a least-squares line to every scatter panel."
     },
     "marginal": {
       "type": "string",
@@ -796,10 +1716,65 @@
         "box",
         "quartiles",
         "points",
+        "stick",
         "none"
       ],
       "description": "violin: what goes inside."
     },
+    "bandwidth": {
+      "type": "number",
+      "description": "violin: KDE bandwidth (default Scott's rule)."
+    },
+    "bwAdjust": {
+      "type": "number",
+      "description": "kde/violin/hist kde: multiply the bandwidth (seaborn bw_adjust)."
+    },
+    "cut": {
+      "type": "number",
+      "description": "kde/violin: how far the density extends past the data, in bandwidths."
+    },
+    "jitter": {
+      "description": "strip: spread of the points across the category (fraction of the band, default 0.6; 0 or false = none).",
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        }
+      ]
+    },
+    "dodge": {
+      "type": "boolean",
+      "description": "strip/swarm/point with hue: place groups side by side."
+    },
+    "hueOrder": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Order of the hue groups."
+    },
+    "showMeans": {
+      "type": "boolean",
+      "description": "box/strip: mark the mean."
+    },
+    "cumulative": {
+      "type": "boolean",
+      "description": "hist/kde: cumulative distribution."
+    },
+    "rug": {
+      "type": "boolean",
+      "description": "kde: tick marks for each observation."
+    },
+    "complementary": {
+      "type": "boolean",
+      "description": "ecdf: show 1 − F(x) (share above each value)."
+    },
+    "radius": {
+      "type": "number",
+      "description": "Point radius in px (scatter, regplot, strip, swarm)."
+    },
     "split": {
       "type": "boolean",
       "description": "violin: with two hue levels, one half each."
@@ -816,6 +1791,115 @@
       "type": "boolean",
       "description": "donut: semicircle."
     },
+    "thickness": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "donut: ring thickness as a fraction of the radius (1 = pie)."
+    },
+    "maxSlices": {
+      "type": "integer",
+      "minimum": 2,
+      "description": "donut/pie: slices before the rest fold into \"Other\" (default 6)."
+    },
+    "centerValue": {
+      "type": "string",
+      "description": "donut/sunburst: text in the center (default: the total)."
+    },
+    "centerLabel": {
+      "type": "string",
+      "description": "donut/sunburst: caption under the center value."
+    },
+    "cellHeight": {
+      "type": "number",
+      "description": "heatmap: maximum cell height in px."
+    },
+    "vars": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "corr/pairplot: the numeric fields to relate, in order (seaborn `vars`). Default: every numeric field (pairplot: the first 6). `y: [...]` works too."
+    },
+    "method": {
+      "type": "string",
+      "enum": [
+        "pearson",
+        "spearman"
+      ],
+      "description": "corr: correlation coefficient. \"pearson\" (default, linear) or \"spearman\" (ranks: monotonic relations, robust to outliers)."
+    },
+    "triangle": {
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "lower",
+            "full"
+          ]
+        },
+        {
+          "type": "boolean"
+        }
+      ],
+      "description": "corr: \"lower\" (default) shows each pair once, below the diagonal; \"full\" shows the whole symmetric matrix (default with `cluster`)."
+    },
+    "cluster": {
+      "type": "boolean",
+      "description": "corr: reorder variables by hierarchical clustering (average linkage on 1 − r) and draw the dendrogram on top, like sns.clustermap. `type: \"clustermap\"` sets it."
+    },
+    "dendrogram": {
+      "type": "boolean",
+      "description": "corr with `cluster`: false hides the dendrogram but keeps the clustered order."
+    },
+    "alpha": {
+      "type": "number",
+      "exclusiveMinimum": 0,
+      "exclusiveMaximum": 1,
+      "description": "corr: significance level (e.g. 0.05). Cells with p ≥ alpha are greyed out and a legend key explains it. p-values use Fisher's z."
+    },
+    "cellSize": {
+      "type": "number",
+      "description": "corr: maximum cell size in px (cells are square)."
+    },
+    "diag": {
+      "type": "string",
+      "enum": [
+        "hist",
+        "kde"
+      ],
+      "description": "pairplot: what goes on the diagonal. Default \"hist\", or \"kde\" when `hue` is set."
+    },
+    "upper": {
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "corr",
+            "scatter"
+          ]
+        },
+        {
+          "type": "boolean",
+          "enum": [
+            false
+          ]
+        }
+      ],
+      "description": "pairplot: above the diagonal, \"corr\" (default: Pearson r, tinted by strength, per `hue` group when there is room), \"scatter\" (mirror), or false (empty)."
+    },
+    "corner": {
+      "type": "boolean",
+      "description": "pairplot: draw only the lower triangle and the diagonal (seaborn corner=True)."
+    },
+    "panelSize": {
+      "type": "number",
+      "description": "pairplot: maximum panel size in px."
+    },
+    "diverging": {
+      "type": "boolean",
+      "description": "heatmap/choropleth: diverging color scale around 0 (or `midpoint`)."
+    },
     "colors": {
       "type": "object",
       "additionalProperties": {
@@ -824,7 +1908,7 @@
       "description": "Pin colors to entities: { \"Biobío\": \"#3A47B8\" }."
     },
     "palette": {
-      "description": "Palette shortcut: a name (\"cdia\", \"okabe-ito\", \"tableau10\", \"udec\") or a list of colors in fixed order.",
+      "description": "Categorical colors: a name (\"cdia\", \"okabe-ito\", \"tableau10\", \"udec\"), a matplotlib qualitative palette (\"tab10\", \"tab20\", \"Set1\", \"Set2\", \"Set3\", \"Pastel1\", \"Pastel2\", \"Paired\", \"Accent\", \"Dark2\"), any colormap name (sampled, e.g. \"viridis\"), or a list of colors in fixed order.",
       "anyOf": [
         {
           "type": "string"
@@ -838,7 +1922,93 @@
       ]
     },
     "ramp": {
-      "description": "Sequential ramp: a name (\"indigo\", \"magenta\", \"teal\", \"amber\") or a list of colors from light to dark.",
+      "description": "Sequential ramp: a name (\"indigo\", \"magenta\", \"teal\", \"amber\"), any colormap name, or a list of colors from light to dark.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      ]
+    },
+    "colorScale": {
+      "description": "Continuous color scale (heatmap, choropleth, treemap change, pointmap values): any matplotlib colormap name, case-insensitive, `_r` reverses (\"viridis\", \"plasma\", \"inferno\", \"magma\", \"cividis\", \"Blues\", \"Greens\", \"YlOrRd\", \"RdBu\", \"coolwarm\", \"Spectral\", \"turbo\", \"twilight\"…); diverging names imply a diverging scale. Or a list of hex colors, or { name | colors, reverse, mid }. Aliases: cmap, colormap. Qualitative palettes (tab10…) go in `palette`; avoid rainbow maps (jet, hsv).",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 2
+        },
+        {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "colors": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "reverse": {
+              "type": "boolean"
+            },
+            "mid": {
+              "type": "number",
+              "description": "Center of a diverging scale."
+            }
+          }
+        }
+      ]
+    },
+    "cmap": {
+      "description": "Alias of colorScale (matplotlib naming).",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 2
+        },
+        {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "colors": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "reverse": {
+              "type": "boolean"
+            },
+            "mid": {
+              "type": "number",
+              "description": "Center of a diverging scale."
+            }
+          }
+        }
+      ]
+    },
+    "colormap": {
+      "description": "Alias of colorScale.",
       "anyOf": [
         {
           "type": "string"
@@ -847,24 +2017,179 @@
           "type": "array",
           "items": {
             "type": "string"
+          },
+          "minItems": 2
+        },
+        {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "colors": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "reverse": {
+              "type": "boolean"
+            },
+            "mid": {
+              "type": "number",
+              "description": "Center of a diverging scale."
+            }
           }
         }
       ]
     },
     "theme": {
-      "description": "Theme: \"papel\" (light, default), \"noche\" (dark), or a JSON object deep-merged over `extends`. Keys: surface, ink, lede, muted, grid, axis, tint, dim, other, categorical (list or palette name), sequential, diverging, status {good, warning, critical}, font {family, mono, import}, type {title, subtitle, label, axis, legend, source, titleWeight}, marks {barRadius, barMax, lineWidth, pointRadius, gap, ring, areaOpacity, bandOpacity, dotOpacity}, axes {inside, grid}, layout {padding}.",
+      "description": "Theme: \"papel\" (light, default), \"noche\" (dark), a name registered with registerTheme(), or a JSON object deep-merged over `extends`. Simple tokens: background (alias of surface), text (alias of ink), accent (first series color), grid (a color or { color, dash, width }), axis, tooltip { bg, ink }, radius / barRadius (corner radius), font. Full keys: surface, ink, lede, muted, tint, dim, other, categorical (list, palette or colormap name), sequential, diverging, status {good, warning, critical}, font {family, mono, import}, type {title, subtitle, label, axis, legend, source, titleWeight}, marks {barRadius, barMax, lineWidth, pointRadius, gap, ring, areaOpacity, bandOpacity, dotOpacity}, axes {inside, grid}, layout {padding}. configure({ theme }) applies it to every chart.",
       "anyOf": [
         {
           "type": "string",
-          "enum": [
-            "papel",
-            "noche",
-            "light",
-            "dark"
-          ]
+          "description": "\"papel\", \"noche\", \"light\", \"dark\" or a registered theme name."
         },
         {
-          "type": "object"
+          "type": "object",
+          "properties": {
+            "extends": {
+              "type": "string"
+            },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "light",
+                "dark"
+              ]
+            },
+            "background": {
+              "type": "string"
+            },
+            "surface": {
+              "type": "string"
+            },
+            "text": {
+              "type": "string"
+            },
+            "ink": {
+              "type": "string"
+            },
+            "lede": {
+              "type": "string"
+            },
+            "muted": {
+              "type": "string"
+            },
+            "accent": {
+              "type": "string"
+            },
+            "grid": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "color": {
+                      "type": "string"
+                    },
+                    "dash": {
+                      "type": "string"
+                    },
+                    "width": {
+                      "type": "number"
+                    }
+                  }
+                }
+              ]
+            },
+            "axis": {
+              "type": "string"
+            },
+            "tooltip": {
+              "type": "object",
+              "properties": {
+                "bg": {
+                  "type": "string"
+                },
+                "ink": {
+                  "type": "string"
+                }
+              }
+            },
+            "radius": {
+              "type": "number"
+            },
+            "barRadius": {
+              "type": "number"
+            },
+            "categorical": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            "sequential": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            "diverging": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            "font": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object"
+                }
+              ]
+            },
+            "status": {
+              "type": "object"
+            },
+            "type": {
+              "type": "object"
+            },
+            "marks": {
+              "type": "object"
+            },
+            "axes": {
+              "type": "object"
+            },
+            "layout": {
+              "type": "object"
+            }
+          }
         }
       ]
     },
@@ -890,6 +2215,10 @@
     "height": {
       "type": "number",
       "description": "Height in px. Automatic for horizontal bars, heatmaps, KPI tiles, and narrow treemaps, sunbursts and radars."
+    },
+    "padding": {
+      "type": "number",
+      "description": "Outer padding in px (default from the width)."
     }
   }
 }