@opendata-ai/openchart-core 8.8.0 → 8.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendata-ai/openchart-core",
-  "version": "8.8.0",
+  "version": "8.9.1",
   "description": "Types, theme, colors, accessibility, and utilities for openchart",
   "license": "Apache-2.0",
   "author": "Riley Hilliard",

package/schema/chart.schema.json

@@ -7386,6 +7386,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": {},
@@ -8061,6 +8122,17 @@
           "type": "string",
           "description": "Optional muted second-tone text rendered below the primary `text`. Used for supporting context (e.g. methodology, source). Newlines in `text` still produce multi-line primary; subtitle is a separate block.\n\nSupports the same inline `**bold**` spans as `text`. When a subtitle is present and no `fontWeight` is set, the primary `text` resolves to weight 700 — the lede + context stack."
         },
+        "subtitleFontSize": {
+          "type": "number",
+          "description": "Subtitle size in pixels. Default: round(fontSize * 0.85)."
+        },
+        "maxWidth": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "description": "Optional display wrap width in pixels. Omitted or null keeps unbounded lines."
+        },
         "dot": {
           "anyOf": [
             {
@@ -8193,6 +8265,10 @@
           "$ref": "#/definitions/ConnectorType",
           "description": "Connector style."
         },
+        "bend": {
+          "type": "number",
+          "description": "Curve displacement along the chord normal, from -1 to 1. Omitted or zero preserves the automatic curve. Ignored for other connector types."
+        },
         "arrow": {
           "type": "boolean",
           "description": "Whether to draw an arrowhead at the data-point end. Default: true for curve, false for straight. Drop-line never takes a head."
@@ -8368,6 +8444,16 @@
           "$ref": "#/definitions/AnnotationOffset",
           "description": "Pixel offset for the reference line label."
         },
+        "labelPlacement": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "start",
+            "end",
+            "outside"
+          ],
+          "description": "Opt-in screen-space label placement. Outside reserves a right gutter or top lane; omission preserves legacy labelAnchor behavior."
+        },
         "labelAnchor": {
           "$ref": "#/definitions/AnnotationAnchor",
           "description": "Anchor direction for the reference line label."
@@ -8541,6 +8627,21 @@
     "ResponsiveConfig": {
       "type": "object",
       "properties": {
+        "compactAnnotationLimit": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "description": "Maximum eligible inline callouts below 400px container width; null or omitted is unlimited. Pinned annotations are exempt."
+        },
+        "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)."
@@ -8625,6 +8726,34 @@
                   "$ref": "#/definitions/TokenValue",
                   "description": "Annotation text color. Accepts a TokenValue for light/dark pairs."
                 },
+                "annotationLabel": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation label color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationMuted": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation muted color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationLeader": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation leader color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationRule": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation rule color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationRangeFill": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation rangefill color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationMarkerFill": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation markerfill color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationPlate": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation plate color. Accepts a TokenValue light/dark pair."
+                },
                 "positive": {
                   "$ref": "#/definitions/TokenValue",
                   "description": "Semantic color for positive/up-trend values. Accepts a TokenValue for light/dark pairs."
@@ -8757,10 +8886,10 @@
             "eyebrow": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Eyebrow (kicker) style override."
@@ -8768,10 +8897,10 @@
             "title": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Title style override."
@@ -8779,10 +8908,10 @@
             "subtitle": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Subtitle style override."
@@ -8790,10 +8919,10 @@
             "source": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Source/attribution style override."
@@ -8801,10 +8930,10 @@
             "byline": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Byline style override."
@@ -8812,10 +8941,10 @@
             "footer": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Footer style override."
@@ -8995,15 +9124,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."
+    },
     "AnimationConfig": {
       "type": "object",
       "properties": {
+        "preset": {
+          "$ref": "#/definitions/AnimationPreset",
+          "description": "Base preset; explicit phase settings take precedence."
+        },
         "enter": {
           "anyOf": [
             {
@@ -9048,6 +9193,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."
@@ -9071,6 +9220,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": [
@@ -9102,6 +9267,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."
@@ -11261,6 +11430,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": {
@@ -11384,7 +11560,7 @@
         },
         "darkMode": {
           "$ref": "#/definitions/DarkMode",
-          "description": "Dark mode behavior. Defaults to \"off\"."
+          "deprecated": "Use the mount darkMode option; the spec field has no effect."
         },
         "watermark": {
           "type": "boolean",

package/schema/table.schema.json

@@ -9,6 +9,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",
@@ -42,7 +58,7 @@
         },
         "darkMode": {
           "$ref": "#/definitions/DarkMode",
-          "description": "Dark mode behavior."
+          "deprecated": "Use the mount darkMode option; the spec field has no effect."
         },
         "watermark": {
           "type": "boolean",
@@ -126,6 +142,67 @@
       "additionalProperties": false,
       "description": "Table specification: input for data table visualizations.\n\nTables are a visualization type, not just an HTML grid. They support heatmap coloring, inline sparklines, sorted columns, search, and pagination."
     },
+    "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": {},
@@ -587,6 +664,34 @@
                   "$ref": "#/definitions/TokenValue",
                   "description": "Annotation text color. Accepts a TokenValue for light/dark pairs."
                 },
+                "annotationLabel": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation label color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationMuted": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation muted color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationLeader": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation leader color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationRule": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation rule color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationRangeFill": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation rangefill color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationMarkerFill": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation markerfill color. Accepts a TokenValue light/dark pair."
+                },
+                "annotationPlate": {
+                  "$ref": "#/definitions/TokenValue",
+                  "description": "Annotation plate color. Accepts a TokenValue light/dark pair."
+                },
                 "positive": {
                   "$ref": "#/definitions/TokenValue",
                   "description": "Semantic color for positive/up-trend values. Accepts a TokenValue for light/dark pairs."
@@ -719,10 +824,10 @@
             "eyebrow": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Eyebrow (kicker) style override."
@@ -730,10 +835,10 @@
             "title": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Title style override."
@@ -741,10 +846,10 @@
             "subtitle": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Subtitle style override."
@@ -752,10 +857,10 @@
             "source": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Source/attribution style override."
@@ -763,10 +868,10 @@
             "byline": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Byline style override."
@@ -774,10 +879,10 @@
             "footer": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "$ref": "#/definitions/ChromeThemeOverride"
                 },
                 {
-                  "$ref": "#/definitions/ChromeThemeOverride"
+                  "type": "string"
                 }
               ],
               "description": "Footer style override."
@@ -919,15 +1024,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."
+    },
     "AnimationConfig": {
       "type": "object",
       "properties": {
+        "preset": {
+          "$ref": "#/definitions/AnimationPreset",
+          "description": "Base preset; explicit phase settings take precedence."
+        },
         "enter": {
           "anyOf": [
             {
@@ -972,6 +1093,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."
@@ -995,6 +1120,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": [
@@ -1026,6 +1167,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."