@genome-spy/core 0.43.3 → 0.45.0

package/dist/schema.json

@@ -314,8 +314,15 @@
           "description": "Which channel's scale domain to monitor.\n\n__Default value:__ `\"x\"`"
         },
         "debounce": {
-          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`"
         },
         "debounceMode": {
           "description": "The debounce mode for data updates. If set to `\"domain\"`, domain change events (panning and zooming) will be debounced. If set to `\"window\"`, the data fetches initiated by the changes to the visible window (or tile) will be debounced.  If your data is small, the `\"window\"` is better as it will start fetching data while the user is still panning around, resulting in a shorter perceived latency.\n\n__Default value:__ `\"window\"`",
@@ -365,8 +372,15 @@
           "description": "Which channel's scale domain to monitor.\n\n__Default value:__ `\"x\"`"
         },
         "debounce": {
-          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`"
         },
         "debounceMode": {
           "description": "The debounce mode for data updates. If set to `\"domain\"`, domain change events (panning and zooming) will be debounced. If set to `\"window\"`, the data fetches initiated by the changes to the visible window (or tile) will be debounced.  If your data is small, the `\"window\"` is better as it will start fetching data while the user is still panning around, resulting in a shorter perceived latency.\n\n__Default value:__ `\"window\"`",
@@ -381,12 +395,26 @@
           "type": "string"
         },
         "url": {
-          "description": "URL of the BigBed file.",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "URL of the BigBed file."
         },
         "windowSize": {
-          "description": "Size of each chunk when fetching the BigBed file. Data is only fetched when the length of the visible domain smaller than the window size.\n\n__Default value:__ `1000000`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Size of each chunk when fetching the BigBed file. Data is only fetched when the length of the visible domain smaller than the window size.\n\n__Default value:__ `1000000`"
         }
       },
       "required": [
@@ -403,8 +431,15 @@
           "description": "Which channel's scale domain to monitor.\n\n__Default value:__ `\"x\"`"
         },
         "debounce": {
-          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`"
         },
         "debounceMode": {
           "description": "The debounce mode for data updates. If set to `\"domain\"`, domain change events (panning and zooming) will be debounced. If set to `\"window\"`, the data fetches initiated by the changes to the visible window (or tile) will be debounced.  If your data is small, the `\"window\"` is better as it will start fetching data while the user is still panning around, resulting in a shorter perceived latency.\n\n__Default value:__ `\"window\"`",
@@ -415,16 +450,30 @@
           "type": "string"
         },
         "pixelsPerBin": {
-          "description": "The approximate minimum width of each data bin, in pixels.\n\n__Default value:__ `2`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The approximate minimum width of each data bin, in pixels.\n\n__Default value:__ `2`"
         },
         "type": {
           "const": "bigwig",
           "type": "string"
         },
         "url": {
-          "description": "URL of the BigWig file.",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "URL of the BigWig file."
         }
       },
       "required": [
@@ -433,6 +482,122 @@
       ],
       "type": "object"
     },
+    "BindCheckbox": {
+      "additionalProperties": false,
+      "properties": {
+        "debounce": {
+          "description": "If defined, delays event handling until the specified milliseconds have elapsed since the last event was fired.",
+          "type": "number"
+        },
+        "description": {
+          "description": "An optional description or help text that is shown below the input element.",
+          "type": "string"
+        },
+        "input": {
+          "const": "checkbox",
+          "type": "string"
+        },
+        "name": {
+          "description": "By default, the parameter name is used to label input elements. This `name` property can be used instead to specify a custom label for the bound parameter.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "input"
+      ],
+      "type": "object"
+    },
+    "BindRadioSelect": {
+      "additionalProperties": false,
+      "properties": {
+        "debounce": {
+          "description": "If defined, delays event handling until the specified milliseconds have elapsed since the last event was fired.",
+          "type": "number"
+        },
+        "description": {
+          "description": "An optional description or help text that is shown below the input element.",
+          "type": "string"
+        },
+        "input": {
+          "enum": [
+            "radio",
+            "select"
+          ],
+          "type": "string"
+        },
+        "labels": {
+          "description": "An array of label strings to represent the `options` values. If unspecified, the `options` value will be coerced to a string and used as the label.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "name": {
+          "description": "By default, the parameter name is used to label input elements. This `name` property can be used instead to specify a custom label for the bound parameter.",
+          "type": "string"
+        },
+        "options": {
+          "description": "An array of options to select from.",
+          "items": {},
+          "type": "array"
+        }
+      },
+      "required": [
+        "input",
+        "options"
+      ],
+      "type": "object"
+    },
+    "BindRange": {
+      "additionalProperties": false,
+      "properties": {
+        "debounce": {
+          "description": "If defined, delays event handling until the specified milliseconds have elapsed since the last event was fired.",
+          "type": "number"
+        },
+        "description": {
+          "description": "An optional description or help text that is shown below the input element.",
+          "type": "string"
+        },
+        "input": {
+          "const": "range",
+          "type": "string"
+        },
+        "max": {
+          "description": "Sets the maximum slider value. Defaults to the larger of the signal value and `100`.",
+          "type": "number"
+        },
+        "min": {
+          "description": "Sets the minimum slider value. Defaults to the smaller of the signal value and `0`.",
+          "type": "number"
+        },
+        "name": {
+          "description": "By default, the parameter name is used to label input elements. This `name` property can be used instead to specify a custom label for the bound parameter.",
+          "type": "string"
+        },
+        "step": {
+          "description": "Sets the minimum slider increment. If undefined, the step size will be automatically determined based on the `min` and `max` values.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "input"
+      ],
+      "type": "object"
+    },
+    "Binding": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/BindCheckbox"
+        },
+        {
+          "$ref": "#/definitions/BindRadioSelect"
+        },
+        {
+          "$ref": "#/definitions/BindRange"
+        }
+      ]
+    },
     "ChannelWithScale": {
       "anyOf": [
         {
@@ -721,6 +886,13 @@
           "$ref": "#/definitions/PaddingConfig",
           "description": "Padding in pixels.\n\n**Default:* `0`"
         },
+        "params": {
+          "description": "Dynamic variables that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/VariableParameter"
+          },
+          "type": "array"
+        },
         "resolve": {
           "additionalProperties": false,
           "properties": {
@@ -1267,7 +1439,14 @@
                   "type": "boolean"
                 },
                 "datum": {
-                  "$ref": "#/definitions/Scalar",
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/Scalar"
+                    },
+                    {
+                      "$ref": "#/definitions/ExprRef"
+                    }
+                  ],
                   "description": "A constant value in data domain."
                 },
                 "resolutionChannel": {
@@ -1354,8 +1533,15 @@
                   ]
                 },
                 "value": {
-                  "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"`, values between `0` to `1` for opacity).",
-                  "type": "number"
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "$ref": "#/definitions/ExprRef"
+                    }
+                  ],
+                  "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"`, values between `0` to `1` for opacity)."
                 }
               },
               "required": [
@@ -2073,8 +2259,15 @@
           "description": "Which channel's scale domain to monitor.\n\n__Default value:__ `\"x\"`"
         },
         "debounce": {
-          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`"
         },
         "debounceMode": {
           "description": "The debounce mode for data updates. If set to `\"domain\"`, domain change events (panning and zooming) will be debounced. If set to `\"window\"`, the data fetches initiated by the changes to the visible window (or tile) will be debounced.  If your data is small, the `\"window\"` is better as it will start fetching data while the user is still panning around, resulting in a shorter perceived latency.\n\n__Default value:__ `\"window\"`",
@@ -2179,6 +2372,13 @@
           "$ref": "#/definitions/PaddingConfig",
           "description": "Padding in pixels.\n\n**Default:* `0`"
         },
+        "params": {
+          "description": "Dynamic variables that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/VariableParameter"
+          },
+          "type": "array"
+        },
         "resolve": {
           "additionalProperties": false,
           "properties": {
@@ -2317,14 +2517,26 @@
       ],
       "type": "object"
     },
-    "ImportConfig": {
+    "ImportParams": {
       "additionalProperties": false,
       "properties": {
         "name": {
+          "description": "Name for the imported view. Overrides the name defined in the imported spec.",
           "type": "string"
         },
         "params": {
-          "type": "object"
+          "anyOf": [
+            {
+              "items": {
+                "$ref": "#/definitions/VariableParameter"
+              },
+              "type": "array"
+            },
+            {
+              "type": "object"
+            }
+          ],
+          "description": "Dynamic variables that parameterize a visualization. Parameters defined here override the parameters defined in the imported spec."
         },
         "url": {
           "type": "string"
@@ -2336,7 +2548,7 @@
       "additionalProperties": false,
       "properties": {
         "import": {
-          "$ref": "#/definitions/ImportConfig"
+          "$ref": "#/definitions/ImportParams"
         }
       },
       "required": [
@@ -2352,8 +2564,15 @@
           "description": "Which channel's scale domain to monitor.\n\n__Default value:__ `\"x\"`"
         },
         "debounce": {
-          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Debounce time for data updates, in milliseconds. Debouncing prevents excessive data updates when the user is zooming or panning around.\n\n__Default value:__ `200`"
         },
         "debounceMode": {
           "description": "The debounce mode for data updates. If set to `\"domain\"`, domain change events (panning and zooming) will be debounced. If set to `\"window\"`, the data fetches initiated by the changes to the visible window (or tile) will be debounced.  If your data is small, the `\"window\"` is better as it will start fetching data while the user is still panning around, resulting in a shorter perceived latency.\n\n__Default value:__ `\"window\"`",
@@ -2552,6 +2771,13 @@
           "$ref": "#/definitions/PaddingConfig",
           "description": "Padding in pixels.\n\n**Default:* `0`"
         },
+        "params": {
+          "description": "Dynamic variables that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/VariableParameter"
+          },
+          "type": "array"
+        },
         "resolve": {
           "additionalProperties": false,
           "properties": {
@@ -2773,8 +2999,15 @@
           "description": "The horizontal alignment of the text. One of `\"left\"`, `\"center\"`, or `\"right\"`.\n\n**Default value:** `\"left\"`"
         },
         "angle": {
-          "description": "The rotation angle in degrees.\n\n**Default value:** `0`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The rotation angle in degrees.\n\n**Default value:** `0`"
         },
         "arcFadingDistance": {
           "anyOf": [
@@ -2835,7 +3068,14 @@
           "description": "If true, the mark is clipped to the UnitView's rectangle. By default, clipping is enabled for marks that have zoomable positional scales."
         },
         "color": {
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
         },
         "cornerRadius": {
           "anyOf": [
@@ -2901,32 +3141,74 @@
           "type": "number"
         },
         "fill": {
-          "description": "The fill color",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The fill color"
         },
         "fillGradientStrength": {
-          "description": "Gradient strength controls the amount of the gradient eye-candy effect in the fill color. Valid values are between 0 and 1.\n\n**Default value:** `0`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Gradient strength controls the amount of the gradient eye-candy effect in the fill color. Valid values are between 0 and 1.\n\n**Default value:** `0`"
         },
         "fillOpacity": {
-          "description": "The fill opacity. Value between [0, 1].",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The fill opacity. Value between [0, 1]."
         },
         "filled": {
           "description": "Whether the `color` represents the `fill` color (`true`) or the `stroke` color (`false`).",
           "type": "boolean"
         },
         "fitToBand": {
-          "description": "If true, sets the secondary positional channel that allows the text to be squeezed (see the `squeeze` property). Can be used when: 1) `\"band\"`, `\"index\"`, or `\"locus\"` scale is being used and 2) only the primary positional channel is specified.\n\n**Default value:** `false`",
-          "type": "boolean"
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If true, sets the secondary positional channel that allows the text to be squeezed (see the `squeeze` property). Can be used when: 1) `\"band\"`, `\"index\"`, or `\"locus\"` scale is being used and 2) only the primary positional channel is specified.\n\n**Default value:** `false`"
         },
         "flushX": {
-          "description": "If true, the text is kept inside the viewport when the range of `x` and `x2` intersect the viewport.",
-          "type": "boolean"
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If true, the text is kept inside the viewport when the range of `x` and `x2` intersect the viewport."
         },
         "flushY": {
-          "description": "If true, the text is kept inside the viewport when the range of `y` and `y2` intersect the viewport.",
-          "type": "boolean"
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If true, the text is kept inside the viewport when the range of `y` and `y2` intersect the viewport."
         },
         "font": {
           "description": "The font typeface. GenomeSpy uses [SDF](https://github.com/Chlumsky/msdfgen) versions of [Google Fonts](https://fonts.google.com/). Check their availability at the [A-Frame Fonts](https://github.com/etiennepinchon/aframe-fonts/tree/master/fonts) repository. System fonts are **not** supported.\n\n**Default value:** `\"Lato\"`",
@@ -2945,8 +3227,15 @@
           "type": "number"
         },
         "inwardStroke": {
-          "description": "Should the stroke only grow inwards, e.g, the diameter/outline is not affected by the stroke width. Thus, a point that has a zero size has no visible stroke. This allows strokes to be used with geometric zoom, etc.\n\n**Default value:** `false`",
-          "type": "boolean"
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Should the stroke only grow inwards, e.g, the diameter/outline is not affected by the stroke width. Thus, a point that has a zero size has no visible stroke. This allows strokes to be used with geometric zoom, etc.\n\n**Default value:** `false`"
         },
         "linkShape": {
           "anyOf": [
@@ -2973,8 +3262,15 @@
           "description": "The shape of the link path. Either `\"arc\"`, `\"diagonal\"`, `\"line\"`, or `\"dome\"`.\n\n**Default value:** `\"arc\"`"
         },
         "logoLetters": {
-          "description": "Stretch letters so that they can be used with [sequence logos](https://en.wikipedia.org/wiki/Sequence_logo), etc...",
-          "type": "boolean"
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Stretch letters so that they can be used with [sequence logos](https://en.wikipedia.org/wiki/Sequence_logo), etc..."
         },
         "maxChordLength": {
           "anyOf": [
@@ -3058,7 +3354,14 @@
           "description": "The minimum width of a rectangle in pixels. The property clamps rectangles' widths when the viewport is zoomed out.\n\nThis property also reduces flickering of very narrow rectangles when zooming. The value should generally be at least one.\n\n**Default value:** `1`"
         },
         "opacity": {
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
         },
         "orient": {
           "anyOf": [
@@ -3077,40 +3380,78 @@
           "description": "The orientation of the link path. Either `\"vertical\"` or `\"horizontal\"`. Only applies to diagonal links.\n\n**Default value:** `\"vertical\"`"
         },
         "paddingX": {
-          "description": "The horizontal padding, in pixels, when the `x2` channel is used for ranged text.\n\n**Default value:** `0`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal padding, in pixels, when the `x2` channel is used for ranged text.\n\n**Default value:** `0`"
         },
         "paddingY": {
-          "description": "The vertical padding, in pixels, when the `y2` channel is used for ranged text.\n\n**Default value:** `0`",
-          "type": "number"
-        },
-        "sampleFacetPadding": {
-          "description": "Padding between sample facet's upper/lower edge and the maximum point size. This property controls how tightly points are squeezed when facet's height is smaller than the maximum point size. The unit is a proportion of facet's height. The value must be between `0` and `0.5`. This property has no effect when sample faceting is not used.\n\n**Default value:** `0.1`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The vertical padding, in pixels, when the `y2` channel is used for ranged text.\n\n**Default value:** `0`"
         },
         "segments": {
           "description": "The number of segments in the bézier curve. Affects the rendering quality and performance. Use a higher value for a smoother curve.\n\n**Default value:* `101`",
           "type": "number"
         },
         "semanticZoomFraction": {
-          "description": "TODO\n\n**Default value:** `0.02`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "TODO\n\n**Default value:** `0.02`"
         },
         "shape": {
           "description": "One of `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n\n**Default value:** `\"circle\"`",
           "type": "string"
         },
         "size": {
-          "description": "The font size in pixels.\n\n**Default value:** `11`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font size in pixels.\n\n**Default value:** `11`"
         },
         "squeeze": {
-          "description": "If the `squeeze` property is true and secondary positional channels (`x2` and/or `y2`) are used, the text is scaled to fit mark's width and/or height.\n\n**Default value:** `true`",
-          "type": "boolean"
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If the `squeeze` property is true and secondary positional channels (`x2` and/or `y2`) are used, the text is scaled to fit mark's width and/or height.\n\n**Default value:** `true`"
         },
         "stroke": {
-          "description": "The stroke color",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The stroke color"
         },
         "strokeCap": {
           "anyOf": [
@@ -3144,15 +3485,36 @@
           "type": "number"
         },
         "strokeOpacity": {
-          "description": "The stroke opacity. Value between [0, 1].",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The stroke opacity. Value between [0, 1]."
         },
         "strokeWidth": {
-          "description": "The stroke width in pixels.",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The stroke width in pixels."
         },
         "text": {
-          "$ref": "#/definitions/Scalar",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scalar"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
           "description": "The text to display. The format of numeric data can be customized by setting a [format specifier](https://github.com/d3/d3-format#locale_format) to channel definition's `format` property.\n\n**Default value:** `\"\"`"
         },
         "tooltip": {
@@ -3187,20 +3549,48 @@
           "type": "number"
         },
         "x": {
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
         },
         "x2": {
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
         },
         "xOffset": {
           "description": "Offsets of the `x` and `x2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
           "type": "number"
         },
         "y": {
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
         },
         "y2": {
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
         },
         "yOffset": {
           "description": "Offsets of the `y` and `y2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -3216,7 +3606,14 @@
       "additionalProperties": false,
       "properties": {
         "datum": {
-          "$ref": "#/definitions/Scalar",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scalar"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
           "description": "A constant value in data domain."
         },
         "resolutionChannel": {
@@ -3254,7 +3651,14 @@
       "additionalProperties": false,
       "properties": {
         "datum": {
-          "$ref": "#/definitions/Scalar",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scalar"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
           "description": "A constant value in data domain."
         },
         "resolutionChannel": {
@@ -3710,7 +4114,14 @@
               "type": "number"
             },
             "datum": {
-              "$ref": "#/definitions/Scalar",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scalar"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
               "description": "A constant value in data domain."
             },
             "title": {
@@ -3768,7 +4179,14 @@
           "type": "number"
         },
         "datum": {
-          "$ref": "#/definitions/Scalar",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scalar"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
           "description": "A constant value in data domain."
         },
         "resolutionChannel": {
@@ -4166,6 +4584,13 @@
               "$ref": "#/definitions/PaddingConfig",
               "description": "Padding in pixels.\n\n**Default:* `0`"
             },
+            "params": {
+              "description": "Dynamic variables that parameterize a visualization.",
+              "items": {
+                "$ref": "#/definitions/VariableParameter"
+              },
+              "type": "array"
+            },
             "resolve": {
               "additionalProperties": false,
               "properties": {
@@ -4374,6 +4799,13 @@
               "$ref": "#/definitions/PaddingConfig",
               "description": "Padding in pixels.\n\n**Default:* `0`"
             },
+            "params": {
+              "description": "Dynamic variables that parameterize a visualization.",
+              "items": {
+                "$ref": "#/definitions/VariableParameter"
+              },
+              "type": "array"
+            },
             "resolve": {
               "additionalProperties": false,
               "properties": {
@@ -4556,6 +4988,13 @@
               "$ref": "#/definitions/PaddingConfig",
               "description": "Padding in pixels.\n\n**Default:* `0`"
             },
+            "params": {
+              "description": "Dynamic variables that parameterize a visualization.",
+              "items": {
+                "$ref": "#/definitions/VariableParameter"
+              },
+              "type": "array"
+            },
             "resolve": {
               "additionalProperties": false,
               "properties": {
@@ -4764,6 +5203,13 @@
               "$ref": "#/definitions/PaddingConfig",
               "description": "Padding in pixels.\n\n**Default:* `0`"
             },
+            "params": {
+              "description": "Dynamic variables that parameterize a visualization.",
+              "items": {
+                "$ref": "#/definitions/VariableParameter"
+              },
+              "type": "array"
+            },
             "resolve": {
               "additionalProperties": false,
               "properties": {
@@ -4962,6 +5408,13 @@
               "$ref": "#/definitions/PaddingConfig",
               "description": "Padding in pixels.\n\n**Default:* `0`"
             },
+            "params": {
+              "description": "Dynamic variables that parameterize a visualization.",
+              "items": {
+                "$ref": "#/definitions/VariableParameter"
+              },
+              "type": "array"
+            },
             "resolve": {
               "additionalProperties": false,
               "properties": {
@@ -5145,6 +5598,13 @@
               "$ref": "#/definitions/PaddingConfig",
               "description": "Padding in pixels.\n\n**Default:* `0`"
             },
+            "params": {
+              "description": "Dynamic variables that parameterize a visualization.",
+              "items": {
+                "$ref": "#/definitions/VariableParameter"
+              },
+              "type": "array"
+            },
             "resolve": {
               "additionalProperties": false,
               "properties": {
@@ -5452,6 +5912,13 @@
           "$ref": "#/definitions/PaddingConfig",
           "description": "Padding in pixels.\n\n**Default:* `0`"
         },
+        "params": {
+          "description": "Dynamic variables that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/VariableParameter"
+          },
+          "type": "array"
+        },
         "resolve": {
           "additionalProperties": false,
           "properties": {
@@ -5731,6 +6198,12 @@
             },
             {
               "type": "string"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ExprRef"
+              },
+              "type": "array"
             }
           ],
           "description": "The range of the scale. One of:\n\n- A string indicating a [pre-defined named scale range](https://vega.github.io/vega-lite/docs/scale.html#range-config) (e.g., example, `\"symbol\"`, or `\"diverging\"`).\n\n- For [continuous scales](https://vega.github.io/vega-lite/docs/scale.html#continuous), two-element array indicating  minimum and maximum values, or an array with more than two entries for specifying a [piecewise scale](https://vega.github.io/vega-lite/docs/scale.html#piecewise).\n\n- For [discrete](https://vega.github.io/vega-lite/docs/scale.html#discrete) and [discretizing](https://vega.github.io/vega-lite/docs/scale.html#discretizing) scales, an array of desired output values.\n\n__Notes:__\n\n1) For color scales you can also specify a color [`scheme`](https://vega.github.io/vega-lite/docs/scale.html#scheme) instead of `range`.\n\n2) Any directly specified `range` for `x` and `y` channels will be ignored. Range can be customized via the view's corresponding [size](https://vega.github.io/vega-lite/docs/size.html) (`width` and `height`)."
@@ -5926,20 +6399,48 @@
       "additionalProperties": false,
       "properties": {
         "as": {
-          "$ref": "#/definitions/FieldName",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FieldName"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
           "description": "The name of the generated sequence field.\n\n__Default value:__ `\"data\"`"
         },
         "start": {
-          "description": "The starting value of the sequence (inclusive).",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The starting value of the sequence (inclusive)."
         },
         "step": {
-          "description": "The step value between sequence entries.\n\n__Default value:__ `1`",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The step value between sequence entries.\n\n__Default value:__ `1`"
         },
         "stop": {
-          "description": "The ending value of the sequence (exclusive).",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The ending value of the sequence (exclusive)."
         }
       },
       "required": [
@@ -6044,7 +6545,14 @@
       "additionalProperties": false,
       "properties": {
         "datum": {
-          "$ref": "#/definitions/Scalar",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scalar"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
           "description": "A constant value in data domain."
         },
         "format": {
@@ -6107,16 +6615,30 @@
           "description": "The anchor position for placing the title and subtitle text. One of `\"start\"`, `\"middle\"`, or `\"end\"`. For example, with an orientation of top these anchor positions map to a left-, center-, or right-aligned title."
         },
         "angle": {
-          "description": "Angle in degrees of title and subtitle text.",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Angle in degrees of title and subtitle text."
         },
         "baseline": {
           "$ref": "#/definitions/Baseline",
           "description": "Vertical text baseline for title and subtitle text. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, or `\"bottom\"`."
         },
         "color": {
-          "description": "Text color for title text.",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Text color for title text."
         },
         "dx": {
           "description": "Delta offset for title and subtitle text x-coordinate.",
@@ -6131,9 +6653,16 @@
           "type": "string"
         },
         "fontSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
           "description": "Font size in pixels for title text.",
-          "minimum": 0,
-          "type": "number"
+          "minimum": 0
         },
         "fontStyle": {
           "$ref": "#/definitions/FontStyle",
@@ -6160,8 +6689,15 @@
           "type": "string"
         },
         "text": {
-          "description": "The title text.",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The title text."
         }
       },
       "required": [
@@ -6371,6 +6907,13 @@
           "$ref": "#/definitions/PaddingConfig",
           "description": "Padding in pixels.\n\n**Default:* `0`"
         },
+        "params": {
+          "description": "Dynamic variables that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/VariableParameter"
+          },
+          "type": "array"
+        },
         "resolve": {
           "additionalProperties": false,
           "properties": {
@@ -6497,6 +7040,9 @@
                 "type": "string"
               },
               "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
             }
           ],
           "description": "An URL or an array of URLs from which to load the data set. Use the `format.type` property to ensure the loaded data is correctly parsed."
@@ -6566,6 +7112,13 @@
           "$ref": "#/definitions/PaddingConfig",
           "description": "Padding in pixels.\n\n**Default:* `0`"
         },
+        "params": {
+          "description": "Dynamic variables that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/VariableParameter"
+          },
+          "type": "array"
+        },
         "resolve": {
           "additionalProperties": false,
           "properties": {
@@ -6695,11 +7248,18 @@
           ]
         },
         "value": {
-          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"`, values between `0` to `1` for opacity).",
-          "type": [
-            "string",
-            "null"
-          ]
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"`, values between `0` to `1` for opacity)."
         }
       },
       "required": [
@@ -6718,8 +7278,15 @@
           ]
         },
         "value": {
-          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"`, values between `0` to `1` for opacity).",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"`, values between `0` to `1` for opacity)."
         }
       },
       "required": [
@@ -6727,24 +7294,76 @@
       ],
       "type": "object"
     },
+    "VariableParameter": {
+      "additionalProperties": false,
+      "properties": {
+        "bind": {
+          "$ref": "#/definitions/Binding",
+          "description": "Binds the parameter to an external input element such as a slider, selection list or radio button group."
+        },
+        "expr": {
+          "description": "An expression for the value of the parameter. This expression may include other parameters, in which case the parameter will automatically update in response to upstream parameter changes.",
+          "type": "string"
+        },
+        "name": {
+          "description": "A unique name for the variable parameter. Parameter names should be valid JavaScript identifiers: they should contain only alphanumeric characters (or \"$\", or \"_\") and may not start with a digit. Reserved keywords that may not be used as parameter names are: \"datum\".",
+          "type": "string"
+        },
+        "value": {
+          "description": "The [initial value](http://vega.github.io/vega-lite/docs/value.html) of the parameter.\n\n__Default value:__ `undefined`"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
     "ViewBackground": {
       "additionalProperties": false,
       "properties": {
         "fill": {
-          "description": "The fill color",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The fill color"
         },
         "fillOpacity": {
-          "description": "The fill opacity. Value between [0, 1].",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The fill opacity. Value between [0, 1]."
         },
         "stroke": {
-          "description": "The stroke color",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The stroke color"
         },
         "strokeOpacity": {
-          "description": "The stroke opacity. Value between [0, 1].",
-          "type": "number"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The stroke opacity. Value between [0, 1]."
         },
         "strokeWidth": {
           "type": "number"