@opendata-ai/openchart-core 8.8.0 → 8.9.0

package/schema/vizspec.schema.json

@@ -7415,6 +7415,67 @@
       "additionalProperties": false,
       "description": "Facet channel definition: partitions data into small-multiple panels.\n\nUnlike positional channels, facet only needs a field, a categorical type, and optional layout hints (columns, sort). It does not carry scale/axis config because it produces a grid, not a visual encoding."
     },
+    "FieldMetadata": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "text",
+            "number",
+            "date"
+          ],
+          "description": "Explicit imported field type; preserved with the portable document."
+        },
+        "role": {
+          "type": "string",
+          "const": "identity",
+          "description": "Identifies an internal, persistent row identity column."
+        },
+        "label": {
+          "type": "string"
+        },
+        "unit": {
+          "type": "string"
+        },
+        "measure": {
+          "type": "string"
+        },
+        "provenance": {
+          "type": "string"
+        },
+        "representation": {
+          "type": "string",
+          "enum": [
+            "number",
+            "percent",
+            "proportion"
+          ],
+          "description": "Percent is encoded 0–100; proportion is encoded 0–1."
+        },
+        "interval": {
+          "type": "object",
+          "properties": {
+            "lower": {
+              "type": "string"
+            },
+            "upper": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "lower",
+            "upper"
+          ],
+          "additionalProperties": false
+        },
+        "statusField": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Supplied semantics; the library never invents a measure or uncertainty."
+    },
     "DataRow": {
       "type": "object",
       "additionalProperties": {},
@@ -8570,6 +8631,14 @@
     "ResponsiveConfig": {
       "type": "object",
       "properties": {
+        "preserveEnd": {
+          "type": "boolean",
+          "description": "Preserve the final temporal boundary before thinning interior ticks."
+        },
+        "labelSummary": {
+          "type": "boolean",
+          "description": "Move direct series labels into a keyed list when the inline column cannot fit."
+        },
         "autoThin": {
           "type": "boolean",
           "description": "Automatic annotation thinning at narrow widths. When true (default), annotations that can't be placed without overlap are demoted to numbered dot markers with footnote text below the chart. Set false to restore the pre-auto-thinning behavior (annotations hidden at compact breakpoints)."
@@ -9024,15 +9093,31 @@
         {
           "type": "boolean"
         },
+        {
+          "$ref": "#/definitions/AnimationPreset"
+        },
         {
           "$ref": "#/definitions/AnimationConfig"
         }
       ],
       "description": "Animation spec property.\n- true: enable entrance animation with sensible defaults\n- false/omitted: no animation (current behavior)\n- AnimationConfig: full control via enter/update/exit phases"
     },
+    "AnimationPreset": {
+      "type": "string",
+      "enum": [
+        "fluid",
+        "subtle",
+        "legacy"
+      ],
+      "description": "Opt-in motion language. `legacy` preserves the v8 tween timing."
+    },
     "AnimationConfig": {
       "type": "object",
       "properties": {
+        "preset": {
+          "$ref": "#/definitions/AnimationPreset",
+          "description": "Base preset; explicit phase settings take precedence."
+        },
         "enter": {
           "anyOf": [
             {
@@ -9077,6 +9162,10 @@
     "AnimationPhaseConfig": {
       "type": "object",
       "properties": {
+        "spring": {
+          "$ref": "#/definitions/SpringConfig",
+          "description": "Spring mode. Cannot be combined with duration or ease in this phase."
+        },
         "duration": {
           "type": "number",
           "description": "Duration in ms. Default: 500 for enter."
@@ -9100,6 +9189,22 @@
       "additionalProperties": false,
       "description": "Animation phase config. Follows Vega's enter/update/exit model. Each phase can be true (use defaults) or a config object."
     },
+    "SpringConfig": {
+      "type": "object",
+      "properties": {
+        "stiffness": {
+          "type": "number"
+        },
+        "damping": {
+          "type": "number"
+        },
+        "mass": {
+          "type": "number"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Physical spring parameters. Quantitative motion is bounded at critical damping."
+    },
     "AnimationEase": {
       "type": "string",
       "enum": [
@@ -9131,6 +9236,10 @@
     "UpdatePhaseConfig": {
       "type": "object",
       "properties": {
+        "spring": {
+          "$ref": "#/definitions/SpringConfig",
+          "description": "Spring mode. Cannot be combined with duration or ease in this phase."
+        },
         "duration": {
           "type": "number",
           "description": "Duration in ms. Default: 500 for enter."
@@ -11757,6 +11866,13 @@
             "encoding": {
               "$ref": "#/definitions/ArcEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -12291,6 +12407,13 @@
             "encoding": {
               "$ref": "#/definitions/LineEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -12825,6 +12948,13 @@
             "encoding": {
               "$ref": "#/definitions/BarEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -13359,6 +13489,13 @@
             "encoding": {
               "$ref": "#/definitions/AreaEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -13893,6 +14030,13 @@
             "encoding": {
               "$ref": "#/definitions/PointEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -14427,6 +14571,13 @@
             "encoding": {
               "$ref": "#/definitions/CircleEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -14961,6 +15112,13 @@
             "encoding": {
               "$ref": "#/definitions/LollipopEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -15495,6 +15653,13 @@
             "encoding": {
               "$ref": "#/definitions/BeeswarmEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -16029,6 +16194,13 @@
             "encoding": {
               "$ref": "#/definitions/RangeEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -16563,6 +16735,13 @@
             "encoding": {
               "$ref": "#/definitions/WaffleEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -17097,6 +17276,13 @@
             "encoding": {
               "$ref": "#/definitions/TextEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -17631,6 +17817,13 @@
             "encoding": {
               "$ref": "#/definitions/TickEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -18165,6 +18358,13 @@
             "encoding": {
               "$ref": "#/definitions/RectEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -18699,6 +18899,13 @@
             "encoding": {
               "$ref": "#/definitions/Encoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -19233,6 +19440,13 @@
             "encoding": {
               "$ref": "#/definitions/CalendarEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -19767,6 +19981,13 @@
             "encoding": {
               "$ref": "#/definitions/ParliamentEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -20301,6 +20522,13 @@
             "encoding": {
               "$ref": "#/definitions/HistogramEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -20835,6 +21063,13 @@
             "encoding": {
               "$ref": "#/definitions/DensityEncoding%3CDataRow%3E"
             },
+            "fields": {
+              "type": "object",
+              "additionalProperties": {
+                "$ref": "#/definitions/FieldMetadata"
+              },
+              "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+            },
             "data": {
               "type": "array",
               "items": {
@@ -21184,6 +21419,22 @@
     "TableSpec": {
       "type": "object",
       "properties": {
+        "mobileLayout": {
+          "type": "string",
+          "enum": [
+            "cards",
+            "priority",
+            "scroll"
+          ],
+          "description": "Compact layout. v8 defaults to cards; priority retains comparable columns with expandable details."
+        },
+        "fields": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/FieldMetadata"
+          },
+          "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+        },
         "type": {
           "type": "string",
           "const": "table",
@@ -22552,6 +22803,13 @@
     "GeoMapSpec": {
       "type": "object",
       "properties": {
+        "fields": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/FieldMetadata"
+          },
+          "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+        },
         "type": {
           "type": "string",
           "const": "map",
@@ -22984,6 +23242,13 @@
         "encoding": {
           "description": "Encoding channel map."
         },
+        "fields": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/FieldMetadata"
+          },
+          "description": "Optional authored measure, unit, provenance, and supplied interval metadata."
+        },
         "data": {
           "type": "array",
           "items": {