@genome-spy/core 0.76.0 → 0.78.0

package/dist/schema.json

@@ -1748,6 +1748,63 @@
           },
           "type": "object"
         },
+        "scales": {
+          "additionalProperties": {
+            "$ref": "#/definitions/Scale"
+          },
+          "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+          "properties": {
+            "angle": {
+              "$ref": "#/definitions/Scale"
+            },
+            "color": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dx": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dy": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fill": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fillOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "opacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "shape": {
+              "$ref": "#/definitions/Scale"
+            },
+            "size": {
+              "$ref": "#/definitions/Scale"
+            },
+            "stroke": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeWidth": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x2": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y2": {
+              "$ref": "#/definitions/Scale"
+            }
+          },
+          "type": "object"
+        },
         "separator": {
           "anyOf": [
             {
@@ -2566,6 +2623,63 @@
               },
               "type": "object"
             },
+            "scales": {
+              "additionalProperties": {
+                "$ref": "#/definitions/Scale"
+              },
+              "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+              "properties": {
+                "angle": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "color": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dx": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dy": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fill": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fillOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "opacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "shape": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "size": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "stroke": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeWidth": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x2": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y2": {
+                  "$ref": "#/definitions/Scale"
+                }
+              },
+              "type": "object"
+            },
             "templates": {
               "additionalProperties": {
                 "$ref": "#/definitions/ViewSpec"
@@ -2967,6 +3081,63 @@
               },
               "type": "object"
             },
+            "scales": {
+              "additionalProperties": {
+                "$ref": "#/definitions/Scale"
+              },
+              "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+              "properties": {
+                "angle": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "color": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dx": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dy": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fill": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fillOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "opacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "shape": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "size": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "stroke": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeWidth": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x2": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y2": {
+                  "$ref": "#/definitions/Scale"
+                }
+              },
+              "type": "object"
+            },
             "templates": {
               "additionalProperties": {
                 "$ref": "#/definitions/ViewSpec"
@@ -3367,6 +3538,63 @@
               },
               "type": "object"
             },
+            "scales": {
+              "additionalProperties": {
+                "$ref": "#/definitions/Scale"
+              },
+              "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+              "properties": {
+                "angle": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "color": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dx": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dy": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fill": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fillOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "opacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "shape": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "size": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "stroke": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeWidth": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x2": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y2": {
+                  "$ref": "#/definitions/Scale"
+                }
+              },
+              "type": "object"
+            },
             "stops": {
               "$ref": "#/definitions/MultiscaleStopsDef",
               "description": "Stop definition that controls transitions between the multiscale levels.\n\n- `number[]` is shorthand for `{ metric: \"unitsPerPixel\", values: ... }`\n- `(number | ExprRef)[]` supports mixed constants and expressions\n- Object form allows configuring metric, channel, and fade."
@@ -3749,6 +3977,63 @@
               },
               "type": "object"
             },
+            "scales": {
+              "additionalProperties": {
+                "$ref": "#/definitions/Scale"
+              },
+              "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+              "properties": {
+                "angle": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "color": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dx": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dy": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fill": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fillOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "opacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "shape": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "size": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "stroke": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeWidth": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x2": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y2": {
+                  "$ref": "#/definitions/Scale"
+                }
+              },
+              "type": "object"
+            },
             "separator": {
               "anyOf": [
                 {
@@ -4164,6 +4449,63 @@
               },
               "type": "object"
             },
+            "scales": {
+              "additionalProperties": {
+                "$ref": "#/definitions/Scale"
+              },
+              "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+              "properties": {
+                "angle": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "color": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dx": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dy": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fill": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fillOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "opacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "shape": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "size": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "stroke": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeWidth": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x2": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y2": {
+                  "$ref": "#/definitions/Scale"
+                }
+              },
+              "type": "object"
+            },
             "separator": {
               "anyOf": [
                 {
@@ -4570,6 +4912,63 @@
               },
               "type": "object"
             },
+            "scales": {
+              "additionalProperties": {
+                "$ref": "#/definitions/Scale"
+              },
+              "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+              "properties": {
+                "angle": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "color": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dx": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "dy": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fill": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "fillOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "opacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "shape": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "size": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "stroke": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeOpacity": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "strokeWidth": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "x2": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y": {
+                  "$ref": "#/definitions/Scale"
+                },
+                "y2": {
+                  "$ref": "#/definitions/Scale"
+                }
+              },
+              "type": "object"
+            },
             "separator": {
               "anyOf": [
                 {
@@ -4830,6 +5229,28 @@
         }
       ]
     },
+    "DomainValue": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "$ref": "#/definitions/ExprRef"
+        }
+      ]
+    },
+    "DomainValueArray": {
+      "items": {
+        "$ref": "#/definitions/DomainValue"
+      },
+      "type": "array"
+    },
     "DsvDataFormat": {
       "additionalProperties": false,
       "properties": {
@@ -6951,6 +7372,63 @@
           },
           "type": "object"
         },
+        "scales": {
+          "additionalProperties": {
+            "$ref": "#/definitions/Scale"
+          },
+          "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+          "properties": {
+            "angle": {
+              "$ref": "#/definitions/Scale"
+            },
+            "color": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dx": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dy": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fill": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fillOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "opacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "shape": {
+              "$ref": "#/definitions/Scale"
+            },
+            "size": {
+              "$ref": "#/definitions/Scale"
+            },
+            "stroke": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeWidth": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x2": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y2": {
+              "$ref": "#/definitions/Scale"
+            }
+          },
+          "type": "object"
+        },
         "separator": {
           "anyOf": [
             {
@@ -7686,6 +8164,63 @@
           },
           "type": "object"
         },
+        "scales": {
+          "additionalProperties": {
+            "$ref": "#/definitions/Scale"
+          },
+          "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+          "properties": {
+            "angle": {
+              "$ref": "#/definitions/Scale"
+            },
+            "color": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dx": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dy": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fill": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fillOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "opacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "shape": {
+              "$ref": "#/definitions/Scale"
+            },
+            "size": {
+              "$ref": "#/definitions/Scale"
+            },
+            "stroke": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeWidth": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x2": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y2": {
+              "$ref": "#/definitions/Scale"
+            }
+          },
+          "type": "object"
+        },
         "templates": {
           "additionalProperties": {
             "$ref": "#/definitions/ViewSpec"
@@ -9027,6 +9562,63 @@
           },
           "type": "object"
         },
+        "scales": {
+          "additionalProperties": {
+            "$ref": "#/definitions/Scale"
+          },
+          "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+          "properties": {
+            "angle": {
+              "$ref": "#/definitions/Scale"
+            },
+            "color": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dx": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dy": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fill": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fillOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "opacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "shape": {
+              "$ref": "#/definitions/Scale"
+            },
+            "size": {
+              "$ref": "#/definitions/Scale"
+            },
+            "stroke": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeWidth": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x2": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y2": {
+              "$ref": "#/definitions/Scale"
+            }
+          },
+          "type": "object"
+        },
         "stops": {
           "$ref": "#/definitions/MultiscaleStopsDef",
           "description": "Stop definition that controls transitions between the multiscale levels.\n\n- `number[]` is shorthand for `{ metric: \"unitsPerPixel\", values: ... }`\n- `(number | ExprRef)[]` supports mixed constants and expressions\n- Object form allows configuring metric, channel, and fade."
@@ -11759,9 +12351,12 @@
             },
             {
               "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/DomainValueArray"
             }
           ],
-          "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values."
+          "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values.\n\nThe domain can also be defined by an expression reference that evaluates to the domain array. Array elements may also be expression references."
         },
         "domainMax": {
           "description": "Sets the maximum value in the scale domain, overriding the `domain` property. This property is only intended for use with scales having continuous domains.",
@@ -11785,7 +12380,7 @@
               "type": "object"
             }
           ],
-          "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains defined by an `ExprRef`, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for ExprRef-driven domains."
+          "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains that include `ExprRef`s, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for `ExprRef`-driven domains."
         },
         "exponent": {
           "description": "The exponent of the `pow` scale.",
@@ -11858,27 +12453,25 @@
           "anyOf": [
             {
               "items": {
-                "type": "number"
-              },
-              "type": "array"
-            },
-            {
-              "items": {
-                "type": "string"
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "$ref": "#/definitions/ExprRef"
+                  }
+                ]
               },
               "type": "array"
             },
             {
               "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`)."
+          "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). Array elements may also be expression references.\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. Array elements may also be expression references.\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`)."
         },
         "reverse": {
           "description": "If true, reverses the order of the scale range.\n\n__Default value:__ `false`.",
@@ -11971,9 +12564,12 @@
             },
             {
               "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/DomainValueArray"
             }
           ],
-          "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values."
+          "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values.\n\nThe domain can also be defined by an expression reference that evaluates to the domain array. Array elements may also be expression references."
         },
         "domainMax": {
           "description": "Sets the maximum value in the scale domain, overriding the `domain` property. This property is only intended for use with scales having continuous domains.",
@@ -11997,7 +12593,7 @@
               "type": "object"
             }
           ],
-          "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains defined by an `ExprRef`, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for ExprRef-driven domains."
+          "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains that include `ExprRef`s, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for `ExprRef`-driven domains."
         },
         "exponent": {
           "description": "The exponent of the `pow` scale.",
@@ -12054,9 +12650,12 @@
                 },
                 {
                   "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/DomainValueArray"
                 }
               ],
-              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values."
+              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values.\n\nThe domain can also be defined by an expression reference that evaluates to the domain array. Array elements may also be expression references."
             },
             "domainMax": {
               "description": "Sets the maximum value in the scale domain, overriding the `domain` property. This property is only intended for use with scales having continuous domains.",
@@ -12080,7 +12679,7 @@
                   "type": "object"
                 }
               ],
-              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains defined by an `ExprRef`, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for ExprRef-driven domains."
+              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains that include `ExprRef`s, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for `ExprRef`-driven domains."
             },
             "exponent": {
               "description": "The exponent of the `pow` scale.",
@@ -12153,27 +12752,25 @@
               "anyOf": [
                 {
                   "items": {
-                    "type": "number"
-                  },
-                  "type": "array"
-                },
-                {
-                  "items": {
-                    "type": "string"
+                    "anyOf": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/definitions/ExprRef"
+                      }
+                    ]
                   },
                   "type": "array"
                 },
                 {
                   "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`)."
+              "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). Array elements may also be expression references.\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. Array elements may also be expression references.\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`)."
             },
             "reverse": {
               "description": "If true, reverses the order of the scale range.\n\n__Default value:__ `false`.",
@@ -12278,9 +12875,12 @@
                 },
                 {
                   "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/DomainValueArray"
                 }
               ],
-              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values."
+              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values.\n\nThe domain can also be defined by an expression reference that evaluates to the domain array. Array elements may also be expression references."
             },
             "domainMax": {
               "description": "Sets the maximum value in the scale domain, overriding the `domain` property. This property is only intended for use with scales having continuous domains.",
@@ -12304,7 +12904,7 @@
                   "type": "object"
                 }
               ],
-              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains defined by an `ExprRef`, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for ExprRef-driven domains."
+              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains that include `ExprRef`s, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for `ExprRef`-driven domains."
             },
             "exponent": {
               "description": "The exponent of the `pow` scale.",
@@ -12377,27 +12977,25 @@
               "anyOf": [
                 {
                   "items": {
-                    "type": "number"
-                  },
-                  "type": "array"
-                },
-                {
-                  "items": {
-                    "type": "string"
+                    "anyOf": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/definitions/ExprRef"
+                      }
+                    ]
                   },
                   "type": "array"
                 },
                 {
                   "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`)."
+              "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). Array elements may also be expression references.\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. Array elements may also be expression references.\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`)."
             },
             "reverse": {
               "description": "If true, reverses the order of the scale range.\n\n__Default value:__ `false`.",
@@ -12522,9 +13120,12 @@
                 },
                 {
                   "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/DomainValueArray"
                 }
               ],
-              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values."
+              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values.\n\nThe domain can also be defined by an expression reference that evaluates to the domain array. Array elements may also be expression references."
             },
             "domainMax": {
               "description": "Sets the maximum value in the scale domain, overriding the `domain` property. This property is only intended for use with scales having continuous domains.",
@@ -12548,7 +13149,7 @@
                   "type": "object"
                 }
               ],
-              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains defined by an `ExprRef`, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for ExprRef-driven domains."
+              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains that include `ExprRef`s, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for `ExprRef`-driven domains."
             },
             "exponent": {
               "description": "The exponent of the `pow` scale.",
@@ -12621,27 +13222,25 @@
               "anyOf": [
                 {
                   "items": {
-                    "type": "number"
-                  },
-                  "type": "array"
-                },
-                {
-                  "items": {
-                    "type": "string"
+                    "anyOf": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/definitions/ExprRef"
+                      }
+                    ]
                   },
                   "type": "array"
                 },
                 {
                   "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`)."
+              "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). Array elements may also be expression references.\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. Array elements may also be expression references.\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`)."
             },
             "reverse": {
               "description": "If true, reverses the order of the scale range.\n\n__Default value:__ `false`.",
@@ -12743,9 +13342,12 @@
                 },
                 {
                   "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/DomainValueArray"
                 }
               ],
-              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values."
+              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values.\n\nThe domain can also be defined by an expression reference that evaluates to the domain array. Array elements may also be expression references."
             },
             "domainMax": {
               "description": "Sets the maximum value in the scale domain, overriding the `domain` property. This property is only intended for use with scales having continuous domains.",
@@ -12769,7 +13371,7 @@
                   "type": "object"
                 }
               ],
-              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains defined by an `ExprRef`, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for ExprRef-driven domains."
+              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains that include `ExprRef`s, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for `ExprRef`-driven domains."
             },
             "exponent": {
               "description": "The exponent of the `pow` scale.",
@@ -12842,27 +13444,25 @@
               "anyOf": [
                 {
                   "items": {
-                    "type": "number"
-                  },
-                  "type": "array"
-                },
-                {
-                  "items": {
-                    "type": "string"
+                    "anyOf": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/definitions/ExprRef"
+                      }
+                    ]
                   },
                   "type": "array"
                 },
                 {
                   "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`)."
+              "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). Array elements may also be expression references.\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. Array elements may also be expression references.\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`)."
             },
             "reverse": {
               "description": "If true, reverses the order of the scale range.\n\n__Default value:__ `false`.",
@@ -12977,9 +13577,12 @@
                 },
                 {
                   "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/DomainValueArray"
                 }
               ],
-              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values."
+              "description": "Customized domain values.\n\nFor _quantitative_ fields, `domain` can take the form of a two-element array with minimum and maximum values.  [Piecewise scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise) can be created by providing a `domain` with more than two entries.\n\nFor _temporal_ fields, `domain` can be a two-element array minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\nFor _ordinal_ and _nominal_ fields, `domain` can be an array that lists valid input values.\n\nThe domain can also be defined by an expression reference that evaluates to the domain array. Array elements may also be expression references."
             },
             "domainMax": {
               "description": "Sets the maximum value in the scale domain, overriding the `domain` property. This property is only intended for use with scales having continuous domains.",
@@ -13003,7 +13606,7 @@
                   "type": "object"
                 }
               ],
-              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains defined by an `ExprRef`, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for ExprRef-driven domains."
+              "description": "Controls whether domain updates are applied immediately or with a smooth transition.\n\nSet this to `false` to apply domain updates immediately. The default is `true`, except for domains that include `ExprRef`s, which default to `false` unless overridden.\n\n__Default value:__ `true`, except `false` for `ExprRef`-driven domains."
             },
             "exponent": {
               "description": "The exponent of the `pow` scale.",
@@ -13076,27 +13679,25 @@
               "anyOf": [
                 {
                   "items": {
-                    "type": "number"
-                  },
-                  "type": "array"
-                },
-                {
-                  "items": {
-                    "type": "string"
+                    "anyOf": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "$ref": "#/definitions/ExprRef"
+                      }
+                    ]
                   },
                   "type": "array"
                 },
                 {
                   "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`)."
+              "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). Array elements may also be expression references.\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. Array elements may also be expression references.\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`)."
             },
             "reverse": {
               "description": "If true, reverses the order of the scale range.\n\n__Default value:__ `false`.",
@@ -13147,27 +13748,25 @@
           "anyOf": [
             {
               "items": {
-                "type": "number"
-              },
-              "type": "array"
-            },
-            {
-              "items": {
-                "type": "string"
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "$ref": "#/definitions/ExprRef"
+                  }
+                ]
               },
               "type": "array"
             },
             {
               "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`)."
+          "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). Array elements may also be expression references.\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. Array elements may also be expression references.\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`)."
         },
         "reverse": {
           "description": "If true, reverses the order of the scale range.\n\n__Default value:__ `false`.",
@@ -16930,6 +17529,63 @@
           },
           "type": "object"
         },
+        "scales": {
+          "additionalProperties": {
+            "$ref": "#/definitions/Scale"
+          },
+          "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+          "properties": {
+            "angle": {
+              "$ref": "#/definitions/Scale"
+            },
+            "color": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dx": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dy": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fill": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fillOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "opacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "shape": {
+              "$ref": "#/definitions/Scale"
+            },
+            "size": {
+              "$ref": "#/definitions/Scale"
+            },
+            "stroke": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeWidth": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x2": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y2": {
+              "$ref": "#/definitions/Scale"
+            }
+          },
+          "type": "object"
+        },
         "templates": {
           "additionalProperties": {
             "$ref": "#/definitions/ViewSpec"
@@ -17372,6 +18028,63 @@
           },
           "type": "object"
         },
+        "scales": {
+          "additionalProperties": {
+            "$ref": "#/definitions/Scale"
+          },
+          "description": "Configures scale resolutions used by this view subtree.\n\nUse this when a composed view shares a scale across child views and the scale settings, such as the visible domain, belong to the composed view rather than an individual encoding.",
+          "properties": {
+            "angle": {
+              "$ref": "#/definitions/Scale"
+            },
+            "color": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dx": {
+              "$ref": "#/definitions/Scale"
+            },
+            "dy": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fill": {
+              "$ref": "#/definitions/Scale"
+            },
+            "fillOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "opacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "shape": {
+              "$ref": "#/definitions/Scale"
+            },
+            "size": {
+              "$ref": "#/definitions/Scale"
+            },
+            "stroke": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeOpacity": {
+              "$ref": "#/definitions/Scale"
+            },
+            "strokeWidth": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x": {
+              "$ref": "#/definitions/Scale"
+            },
+            "x2": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y": {
+              "$ref": "#/definitions/Scale"
+            },
+            "y2": {
+              "$ref": "#/definitions/Scale"
+            }
+          },
+          "type": "object"
+        },
         "separator": {
           "anyOf": [
             {