mviz 1.6.4 → 1.6.7

package/schema/mviz.v1.schema.json

@@ -109,6 +109,27 @@
         "pct1"
       ]
     },
+    "TableColumnFormatOption": {
+      "description": "Format options for table columns. Extends FormatOption with 'date' and 'duration', which only affect table rendering and sort (not chart axes/labels).",
+      "enum": [
+        "auto",
+        "currency_auto",
+        "currency",
+        "currency0k",
+        "currency0m",
+        "currency0b",
+        "num0",
+        "num1",
+        "num0k",
+        "num0m",
+        "num0b",
+        "pct",
+        "pct0",
+        "pct1",
+        "date",
+        "duration"
+      ]
+    },
     "CurrencyCode": {
       "type": "string",
       "description": "ISO 4217 currency code (e.g., USD, GBP, EUR)"
@@ -135,6 +156,7 @@
     },
     "ColumnarData": {
       "type": "object",
+      "description": "Columnar data shape accepted as an alternative to `data` on DataArray-based chart types. The CLI normalizes this to `data` before rendering or linting.",
       "properties": {
         "columns": {
           "type": "array",
@@ -176,13 +198,15 @@
           "type": "array",
           "items": {
             "type": "string"
-          }
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
         },
         "rows": {
           "type": "array",
           "items": {
             "type": "array"
-          }
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
         },
         "x": {
           "type": "string"
@@ -213,6 +237,13 @@
         },
         "yMax": {
           "type": "number"
+        },
+        "xAxisType": {
+          "enum": [
+            "category",
+            "time",
+            "value"
+          ]
         }
       },
       "additionalProperties": false
@@ -239,13 +270,15 @@
           "type": "array",
           "items": {
             "type": "string"
-          }
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
         },
         "rows": {
           "type": "array",
           "items": {
             "type": "array"
-          }
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
         },
         "x": {
           "type": "string"
@@ -306,13 +339,15 @@
           "type": "array",
           "items": {
             "type": "string"
-          }
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
         },
         "rows": {
           "type": "array",
           "items": {
             "type": "array"
-          }
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
         },
         "x": {
           "type": "string"
@@ -343,6 +378,13 @@
         },
         "yMax": {
           "type": "number"
+        },
+        "xAxisType": {
+          "enum": [
+            "category",
+            "time",
+            "value"
+          ]
         }
       },
       "additionalProperties": false
@@ -363,6 +405,20 @@
         "data": {
           "$ref": "#/$defs/DataArray"
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "name": {
           "type": "string",
           "default": "name"
@@ -401,6 +457,20 @@
         "data": {
           "$ref": "#/$defs/DataArray"
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "x": {
           "type": "string"
         },
@@ -456,6 +526,20 @@
         "data": {
           "$ref": "#/$defs/DataArray"
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "x": {
           "type": "string"
         },
@@ -540,8 +624,7 @@
     "HistogramChart": {
       "type": "object",
       "required": [
-        "type",
-        "data"
+        "type"
       ],
       "properties": {
         "$schema": {
@@ -564,6 +647,20 @@
             }
           ]
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "value": {
           "type": "string"
         },
@@ -578,13 +675,25 @@
           "$ref": "#/$defs/Theme"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "data"
+          ]
+        },
+        {
+          "required": [
+            "columns",
+            "rows"
+          ]
+        }
+      ]
     },
     "WaterfallChart": {
       "type": "object",
       "required": [
-        "type",
-        "data"
+        "type"
       ],
       "properties": {
         "$schema": {
@@ -622,6 +731,20 @@
             }
           }
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "name": {
           "type": "string",
           "default": "name",
@@ -653,13 +776,25 @@
           "$ref": "#/$defs/Theme"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "data"
+          ]
+        },
+        {
+          "required": [
+            "columns",
+            "rows"
+          ]
+        }
+      ]
     },
     "XmrChart": {
       "type": "object",
       "required": [
-        "type",
-        "data"
+        "type"
       ],
       "properties": {
         "$schema": {
@@ -682,6 +817,20 @@
             }
           ]
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "value": {
           "type": "string",
           "default": "value"
@@ -707,13 +856,25 @@
           "type": "number"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "data"
+          ]
+        },
+        {
+          "required": [
+            "columns",
+            "rows"
+          ]
+        }
+      ]
     },
     "SankeyChart": {
       "type": "object",
       "required": [
-        "type",
-        "data"
+        "type"
       ],
       "properties": {
         "$schema": {
@@ -745,6 +906,20 @@
             }
           }
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "nodes": {
           "type": "array",
           "items": {
@@ -758,13 +933,25 @@
           "$ref": "#/$defs/Theme"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "data"
+          ]
+        },
+        {
+          "required": [
+            "columns",
+            "rows"
+          ]
+        }
+      ]
     },
     "FunnelChart": {
       "type": "object",
       "required": [
-        "type",
-        "data"
+        "type"
       ],
       "properties": {
         "$schema": {
@@ -777,6 +964,20 @@
         "data": {
           "$ref": "#/$defs/DataArray"
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "name": {
           "type": "string"
         },
@@ -796,13 +997,25 @@
           "$ref": "#/$defs/Theme"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "data"
+          ]
+        },
+        {
+          "required": [
+            "columns",
+            "rows"
+          ]
+        }
+      ]
     },
     "HeatmapChart": {
       "type": "object",
       "required": [
         "type",
-        "data",
         "xCategories",
         "yCategories"
       ],
@@ -839,6 +1052,20 @@
             ]
           }
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "xCategories": {
           "type": "array",
           "items": {
@@ -864,13 +1091,25 @@
           "$ref": "#/$defs/Theme"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "data"
+          ]
+        },
+        {
+          "required": [
+            "columns",
+            "rows"
+          ]
+        }
+      ]
     },
     "CalendarChart": {
       "type": "object",
       "required": [
         "type",
-        "data",
         "year"
       ],
       "properties": {
@@ -900,6 +1139,20 @@
             }
           }
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "year": {
           "type": "integer"
         },
@@ -910,7 +1163,20 @@
           "$ref": "#/$defs/Theme"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "data"
+          ]
+        },
+        {
+          "required": [
+            "columns",
+            "rows"
+          ]
+        }
+      ]
     },
     "SparklineChart": {
       "type": "object",
@@ -938,8 +1204,30 @@
             }
           ]
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "value": {
-          "type": "number"
+          "oneOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "Numeric percentage for pct/pct_bar sparkType, or the data field name (string) whose values are plotted for line/bar/area/dumbbell sparkType."
         },
         "sparkType": {
           "enum": [
@@ -962,6 +1250,11 @@
         },
         "theme": {
           "$ref": "#/$defs/Theme"
+        },
+        "showValue": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show the formatted value next to the bar (pct/pct_bar sparkType only)"
         }
       },
       "additionalProperties": false
@@ -983,6 +1276,20 @@
         "data": {
           "$ref": "#/$defs/DataArray"
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "x": {
           "type": "string"
         },
@@ -1043,7 +1350,6 @@
       "type": "object",
       "required": [
         "type",
-        "data",
         "category",
         "start",
         "end"
@@ -1059,6 +1365,20 @@
         "data": {
           "$ref": "#/$defs/DataArray"
         },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Columnar form: column names. Use together with `rows` as an alternative to `data`."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array"
+          },
+          "description": "Columnar form: row values. Use together with `columns` as an alternative to `data`."
+        },
         "category": {
           "type": "string"
         },
@@ -1093,9 +1413,28 @@
         },
         "theme": {
           "$ref": "#/$defs/Theme"
+        },
+        "xMin": {
+          "type": "number"
+        },
+        "xMax": {
+          "type": "number"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "data"
+          ]
+        },
+        {
+          "required": [
+            "columns",
+            "rows"
+          ]
+        }
+      ]
     },
     "MermaidChart": {
       "type": "object",
@@ -1113,8 +1452,15 @@
         },
         "code": {
           "oneOf": [
-            { "type": "string" },
-            { "type": "array", "items": { "type": "string" } }
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
           ],
           "description": "Mermaid diagram syntax as string or array of lines (joined with newlines)"
         },
@@ -1227,6 +1573,11 @@
           "type": "boolean",
           "default": true
         },
+        "neutralIs": {
+          "type": "number",
+          "default": 0,
+          "description": "Value treated as neutral (no change). When value === neutralIs, the indicator uses a right-arrow and muted color instead of green/red."
+        },
         "comparison": {
           "type": "object",
           "properties": {
@@ -1253,8 +1604,16 @@
         "type"
       ],
       "anyOf": [
-        { "required": ["message"] },
-        { "required": ["content"] }
+        {
+          "required": [
+            "message"
+          ]
+        },
+        {
+          "required": [
+            "content"
+          ]
+        }
       ],
       "properties": {
         "$schema": {
@@ -1415,7 +1774,7 @@
           ]
         },
         "fmt": {
-          "$ref": "#/$defs/FormatOption"
+          "$ref": "#/$defs/TableColumnFormatOption"
         },
         "bold": {
           "type": "boolean"
@@ -1480,6 +1839,16 @@
         "compact": {
           "type": "boolean"
         },
+        "sortable": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable click-to-sort on column headers. Cycles asc \u2192 desc \u2192 none. Numeric columns sort by raw value."
+        },
+        "filter": {
+          "type": "boolean",
+          "default": false,
+          "description": "When true, render a global search input above the table that filters rows by case-insensitive contains match on any cell."
+        },
         "currency": {
           "$ref": "#/$defs/CurrencyCode"
         },