@genome-spy/app 0.88.1 → 0.89.0

package/dist/schema.json

@@ -132,7 +132,7 @@
       "properties": {
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -1153,7 +1153,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -1345,7 +1345,7 @@
         },
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -2362,7 +2362,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -2546,7 +2546,7 @@
         },
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -3573,7 +3573,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -3745,7 +3745,7 @@
         },
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -4772,7 +4772,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -4980,7 +4980,7 @@
             },
             "axes": {
               "additionalProperties": false,
-              "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+              "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
               "properties": {
                 "x": {
                   "additionalProperties": false,
@@ -6000,6 +6000,13 @@
               },
               "type": "array"
             },
+            "predicates": {
+              "additionalProperties": {
+                "$ref": "#/definitions/SelectionPredicateDefinition"
+              },
+              "description": "Define a selection test once instead of repeating it across this unit's conditional encodings, including conditional draw order. Use `test: { ref: \"name\" }` in a condition to reference it.\n\nDefinitions are local to this unit and are not inherited. An inherited encoding may reference a name if each consuming unit defines it. Selection parameters and projected channels resolve in this unit. Filter transforms do not use these definitions.",
+              "type": "object"
+            },
             "resolve": {
               "additionalProperties": false,
               "description": "Specifies how scales, axes, and legends are [resolved](https://genomespy.app/docs/grammar/composition/#scale-axis-and-legend-resolution) in the view hierarchy.\n\nIf legend resolution is not configured explicitly, it follows the corresponding scale resolution.",
@@ -6018,7 +6025,7 @@
             },
             "scales": {
               "additionalProperties": false,
-              "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+              "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
               "properties": {
                 "angle": {
                   "$ref": "#/definitions/Scale"
@@ -6216,7 +6223,7 @@
             },
             "axes": {
               "additionalProperties": false,
-              "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+              "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
               "properties": {
                 "x": {
                   "additionalProperties": false,
@@ -7262,7 +7269,7 @@
             },
             "scales": {
               "additionalProperties": false,
-              "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+              "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
               "properties": {
                 "angle": {
                   "$ref": "#/definitions/Scale"
@@ -7459,7 +7466,7 @@
             },
             "axes": {
               "additionalProperties": false,
-              "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+              "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
               "properties": {
                 "x": {
                   "additionalProperties": false,
@@ -8505,7 +8512,7 @@
             },
             "scales": {
               "additionalProperties": false,
-              "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+              "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
               "properties": {
                 "angle": {
                   "$ref": "#/definitions/Scale"
@@ -8714,7 +8721,7 @@
             },
             "axes": {
               "additionalProperties": false,
-              "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+              "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
               "properties": {
                 "x": {
                   "additionalProperties": false,
@@ -9737,7 +9744,7 @@
             },
             "scales": {
               "additionalProperties": false,
-              "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+              "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
               "properties": {
                 "angle": {
                   "$ref": "#/definitions/Scale"
@@ -9966,7 +9973,7 @@
             },
             "axes": {
               "additionalProperties": false,
-              "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+              "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
               "properties": {
                 "x": {
                   "additionalProperties": false,
@@ -11002,7 +11009,7 @@
             },
             "scales": {
               "additionalProperties": false,
-              "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+              "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
               "properties": {
                 "angle": {
                   "$ref": "#/definitions/Scale"
@@ -11204,7 +11211,7 @@
             },
             "axes": {
               "additionalProperties": false,
-              "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+              "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
               "properties": {
                 "x": {
                   "additionalProperties": false,
@@ -12244,7 +12251,7 @@
             },
             "scales": {
               "additionalProperties": false,
-              "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+              "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
               "properties": {
                 "angle": {
                   "$ref": "#/definitions/Scale"
@@ -12447,7 +12454,7 @@
             },
             "axes": {
               "additionalProperties": false,
-              "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+              "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
               "properties": {
                 "x": {
                   "additionalProperties": false,
@@ -13493,7 +13500,7 @@
             },
             "scales": {
               "additionalProperties": false,
-              "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+              "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
               "properties": {
                 "angle": {
                   "$ref": "#/definitions/Scale"
@@ -13702,7 +13709,7 @@
         },
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -14703,6 +14710,13 @@
           },
           "type": "array"
         },
+        "predicates": {
+          "additionalProperties": {
+            "$ref": "#/definitions/SelectionPredicateDefinition"
+          },
+          "description": "Define a selection test once instead of repeating it across this unit's conditional encodings, including conditional draw order. Use `test: { ref: \"name\" }` in a condition to reference it.\n\nDefinitions are local to this unit and are not inherited. An inherited encoding may reference a name if each consuming unit defines it. Selection parameters and projected channels resolve in this unit. Filter transforms do not use these definitions.",
+          "type": "object"
+        },
         "resolve": {
           "additionalProperties": false,
           "description": "Specifies how scales, axes, and legends are [resolved](https://genomespy.app/docs/grammar/composition/#scale-axis-and-legend-resolution) in the view hierarchy.\n\nIf legend resolution is not configured explicitly, it follows the corresponding scale resolution.",
@@ -14721,7 +14735,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -14901,7 +14915,7 @@
         },
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -15905,7 +15919,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -16205,18 +16219,13 @@
         "direction": {
           "anyOf": [
             {
-              "const": "forward",
-              "type": "string"
-            },
-            {
-              "const": "reverse",
-              "type": "string"
+              "$ref": "#/definitions/ArrowDirection"
             },
             {
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Direction of the arrowhead. `\"forward\"` places the arrowhead at the secondary endpoint (`x2`, `y2`). `\"reverse\"` places it at the primary endpoint (`x`, `y`). For data-driven direction, use the `direction` encoding channel.\n\n__Default value:__ `\"forward\"`"
+          "description": "Direction of the arrowhead. `\"forward\"` places the arrowhead at the secondary endpoint (`x2`, `y2`). `\"reverse\"` places it at the primary endpoint (`x`, `y`). `\"both\"` places equivalent heads at both endpoints and suppresses `headSpacing` and `startNotch` for that arrow. For data-driven direction, use the `direction` encoding channel.\n\n__Default value:__ `\"forward\"`"
         },
         "fill": {
           "anyOf": [
@@ -16310,7 +16319,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Spacing between repeated arrowheads as a multiplier of resolved `size`. The effective spacing is at least the rendered arrowhead footprint, including stroke. If `null`, arrowheads are not repeated.\n\n__Default value:__ `null`"
+          "description": "Spacing between repeated arrowheads as a multiplier of resolved `size`. The effective spacing is at least the rendered arrowhead footprint, including stroke. If `null`, arrowheads are not repeated. Repetition is suppressed when `direction` resolves to `\"both\"`.\n\n__Default value:__ `null`"
         },
         "headWidth": {
           "anyOf": [
@@ -16369,7 +16378,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Whether to draw a notch at the start of the arrow. The start notch uses the same slope as the arrowhead edge.\n\n__Default value:__ `false`"
+          "description": "Whether to draw a notch at the start of the arrow. The start notch uses the same slope as the arrowhead edge. It is suppressed when `direction` resolves to `\"both\"` because a bidirectional arrow has no unique start.\n\n__Default value:__ `false`"
         },
         "stem": {
           "anyOf": [
@@ -16527,7 +16536,8 @@
     "ArrowDirection": {
       "enum": [
         "forward",
-        "reverse"
+        "reverse",
+        "both"
       ],
       "type": "string"
     },
@@ -16599,18 +16609,13 @@
         "direction": {
           "anyOf": [
             {
-              "const": "forward",
-              "type": "string"
-            },
-            {
-              "const": "reverse",
-              "type": "string"
+              "$ref": "#/definitions/ArrowDirection"
             },
             {
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Direction of the arrowhead. `\"forward\"` places the arrowhead at the secondary endpoint (`x2`, `y2`). `\"reverse\"` places it at the primary endpoint (`x`, `y`). For data-driven direction, use the `direction` encoding channel.\n\n__Default value:__ `\"forward\"`"
+          "description": "Direction of the arrowhead. `\"forward\"` places the arrowhead at the secondary endpoint (`x2`, `y2`). `\"reverse\"` places it at the primary endpoint (`x`, `y`). `\"both\"` places equivalent heads at both endpoints and suppresses `headSpacing` and `startNotch` for that arrow. For data-driven direction, use the `direction` encoding channel.\n\n__Default value:__ `\"forward\"`"
         },
         "fill": {
           "anyOf": [
@@ -16704,7 +16709,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Spacing between repeated arrowheads as a multiplier of resolved `size`. The effective spacing is at least the rendered arrowhead footprint, including stroke. If `null`, arrowheads are not repeated.\n\n__Default value:__ `null`"
+          "description": "Spacing between repeated arrowheads as a multiplier of resolved `size`. The effective spacing is at least the rendered arrowhead footprint, including stroke. If `null`, arrowheads are not repeated. Repetition is suppressed when `direction` resolves to `\"both\"`.\n\n__Default value:__ `null`"
         },
         "headWidth": {
           "anyOf": [
@@ -16763,7 +16768,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Whether to draw a notch at the start of the arrow. The start notch uses the same slope as the arrowhead edge.\n\n__Default value:__ `false`"
+          "description": "Whether to draw a notch at the start of the arrow. The start notch uses the same slope as the arrowhead edge. It is suppressed when `direction` resolves to `\"both\"` because a bidirectional arrow has no unique start.\n\n__Default value:__ `false`"
         },
         "stem": {
           "anyOf": [
@@ -18285,7 +18290,7 @@
               "type": "string"
             }
           ],
-          "description": "Whether the brush rectangle should be clipped to the viewport.\n\n__Default value:__ `true`"
+          "description": "Clip the brush rectangle to the viewport along the selected axes. An explicit value overrides this direction-based default.\n\n__Default value:__ `\"x\"` for x selections, `\"y\"` for y selections, and `true` for x/y selections."
         },
         "cursor": {
           "anyOf": [
@@ -18673,7 +18678,7 @@
       "properties": {
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -19684,7 +19689,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -19968,6 +19973,27 @@
           "description": "Filter using a parameter name.",
           "type": "string"
         },
+        "project": {
+          "additionalProperties": false,
+          "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+          "properties": {
+            "x": {
+              "enum": [
+                "x",
+                "x2"
+              ],
+              "type": "string"
+            },
+            "y": {
+              "enum": [
+                "y",
+                "y2"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
           "description": "An alternative channel for scale resolution.\n\nThis is mainly for internal use and allows using `color` channel to resolve `fill` and `stroke` channels under certain circumstances."
@@ -20041,6 +20067,27 @@
           "description": "Filter using a parameter name.",
           "type": "string"
         },
+        "project": {
+          "additionalProperties": false,
+          "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+          "properties": {
+            "x": {
+              "enum": [
+                "x",
+                "x2"
+              ],
+              "type": "string"
+            },
+            "y": {
+              "enum": [
+                "y",
+                "y2"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
           "description": "An alternative channel for scale resolution.\n\nThis is mainly for internal use and allows using `color` channel to resolve `fill` and `stroke` channels under certain circumstances."
@@ -20112,6 +20159,27 @@
           "description": "Filter using a parameter name.",
           "type": "string"
         },
+        "project": {
+          "additionalProperties": false,
+          "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+          "properties": {
+            "x": {
+              "enum": [
+                "x",
+                "x2"
+              ],
+              "type": "string"
+            },
+            "y": {
+              "enum": [
+                "y",
+                "y2"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
           "description": "An alternative channel for scale resolution.\n\nThis is mainly for internal use and allows using `color` channel to resolve `fill` and `stroke` channels under certain circumstances."
@@ -20182,6 +20250,27 @@
           "description": "Filter using a parameter name.",
           "type": "string"
         },
+        "project": {
+          "additionalProperties": false,
+          "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+          "properties": {
+            "x": {
+              "enum": [
+                "x",
+                "x2"
+              ],
+              "type": "string"
+            },
+            "y": {
+              "enum": [
+                "y",
+                "y2"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
           "description": "An alternative channel for scale resolution.\n\nThis is mainly for internal use and allows using `color` channel to resolve `fill` and `stroke` channels under certain circumstances."
@@ -20250,6 +20339,27 @@
           "description": "Filter using a parameter name.",
           "type": "string"
         },
+        "project": {
+          "additionalProperties": false,
+          "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+          "properties": {
+            "x": {
+              "enum": [
+                "x",
+                "x2"
+              ],
+              "type": "string"
+            },
+            "y": {
+              "enum": [
+                "y",
+                "y2"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
           "description": "An alternative channel for scale resolution.\n\nThis is mainly for internal use and allows using `color` channel to resolve `fill` and `stroke` channels under certain circumstances."
@@ -20296,6 +20406,27 @@
           "description": "Filter using a parameter name.",
           "type": "string"
         },
+        "project": {
+          "additionalProperties": false,
+          "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+          "properties": {
+            "x": {
+              "enum": [
+                "x",
+                "x2"
+              ],
+              "type": "string"
+            },
+            "y": {
+              "enum": [
+                "y",
+                "y2"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
         "title": {
           "description": "A title for the field. If `null`, the title will be removed.",
           "type": [
@@ -20336,6 +20467,27 @@
           "description": "Filter using a parameter name.",
           "type": "string"
         },
+        "project": {
+          "additionalProperties": false,
+          "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+          "properties": {
+            "x": {
+              "enum": [
+                "x",
+                "x2"
+              ],
+              "type": "string"
+            },
+            "y": {
+              "enum": [
+                "y",
+                "y2"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
         "title": {
           "description": "A title for the field. If `null`, the title will be removed.",
           "type": [
@@ -20414,10 +20566,10 @@
         "test": {
           "anyOf": [
             {
-              "$ref": "#/definitions/ParameterPredicate"
+              "$ref": "#/definitions/SelectionPredicateDefinition"
             },
             {
-              "$ref": "#/definitions/SelectionUnionTest"
+              "$ref": "#/definitions/NamedSelectionPredicateRef"
             }
           ]
         },
@@ -20489,10 +20641,10 @@
         "test": {
           "anyOf": [
             {
-              "$ref": "#/definitions/ParameterPredicate"
+              "$ref": "#/definitions/SelectionPredicateDefinition"
             },
             {
-              "$ref": "#/definitions/SelectionUnionTest"
+              "$ref": "#/definitions/NamedSelectionPredicateRef"
             }
           ]
         },
@@ -20562,10 +20714,10 @@
         "test": {
           "anyOf": [
             {
-              "$ref": "#/definitions/ParameterPredicate"
+              "$ref": "#/definitions/SelectionPredicateDefinition"
             },
             {
-              "$ref": "#/definitions/SelectionUnionTest"
+              "$ref": "#/definitions/NamedSelectionPredicateRef"
             }
           ]
         },
@@ -20634,10 +20786,10 @@
         "test": {
           "anyOf": [
             {
-              "$ref": "#/definitions/ParameterPredicate"
+              "$ref": "#/definitions/SelectionPredicateDefinition"
             },
             {
-              "$ref": "#/definitions/SelectionUnionTest"
+              "$ref": "#/definitions/NamedSelectionPredicateRef"
             }
           ]
         },
@@ -20704,10 +20856,10 @@
         "test": {
           "anyOf": [
             {
-              "$ref": "#/definitions/ParameterPredicate"
+              "$ref": "#/definitions/SelectionPredicateDefinition"
             },
             {
-              "$ref": "#/definitions/SelectionUnionTest"
+              "$ref": "#/definitions/NamedSelectionPredicateRef"
             }
           ]
         },
@@ -20737,10 +20889,10 @@
         "test": {
           "anyOf": [
             {
-              "$ref": "#/definitions/ParameterPredicate"
+              "$ref": "#/definitions/SelectionPredicateDefinition"
             },
             {
-              "$ref": "#/definitions/SelectionUnionTest"
+              "$ref": "#/definitions/NamedSelectionPredicateRef"
             }
           ]
         },
@@ -20779,10 +20931,10 @@
         "test": {
           "anyOf": [
             {
-              "$ref": "#/definitions/ParameterPredicate"
+              "$ref": "#/definitions/SelectionPredicateDefinition"
             },
             {
-              "$ref": "#/definitions/SelectionUnionTest"
+              "$ref": "#/definitions/NamedSelectionPredicateRef"
             }
           ]
         },
@@ -21188,6 +21340,43 @@
         }
       ]
     },
+    "DebouncedExprParameter": {
+      "additionalProperties": false,
+      "properties": {
+        "debounce": {
+          "description": "Delays publication until the expression dependencies have remained unchanged for the specified number of milliseconds. The initial value is published immediately.",
+          "minimum": 0,
+          "type": "number"
+        },
+        "description": {
+          "description": "A description of the parameter. Can be used for documentation and to explain the meaning of the control or selection.",
+          "type": "string"
+        },
+        "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"
+        },
+        "persist": {
+          "description": "Whether the parameter should be persisted in bookmarks and provenance.\n\nThis primarily affects GenomeSpy App behavior. Set to `false` for ephemeral params (e.g., hover selections) or when the selection cannot be persisted due to missing `encoding.key`.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "push": {
+          "const": "outer",
+          "description": "Reuses the nearest same-named parameter in an ancestor scope and writes updates to it. Declare the target parameter on the ancestor first.\n\nThis is useful when interaction in a child view updates state owned by a composed view, such as a parameter that controls a shared scale.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "debounce",
+        "expr",
+        "name"
+      ],
+      "type": "object"
+    },
     "DirectionDef": {
       "anyOf": [
         {
@@ -21373,6 +21562,106 @@
       ],
       "type": "object"
     },
+    "Displace2DParams": {
+      "additionalProperties": false,
+      "description": "Progressively displaces axis-aligned rectangles to reduce overlap while keeping them close to positions mapped through the view's x and y scales. Every input row receives signed pixel offsets. Earlier rows have higher placement priority.",
+      "properties": {
+        "anchorHeight": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/Field"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Height in logical pixels of an obstacle centered on the anchor. A number or expression supplies one value for all rows; a field supplies per-row values. Setting either anchor dimension to zero disables the obstacle for that row.\n\n__Default value:__ `0`"
+        },
+        "anchorWidth": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/Field"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Width in logical pixels of an obstacle centered on the anchor. A number or expression supplies one value for all rows; a field supplies per-row values. Setting either anchor dimension to zero disables the obstacle for that row.\n\n__Default value:__ `0`"
+        },
+        "as": {
+          "description": "Names of the output fields for signed horizontal and vertical pixel offsets. Positive values move right and down, respectively. Neither name may overwrite `key`.\n\n__Default value:__ `[\"xDisplacement\", \"yDisplacement\"]`",
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "description": {
+          "description": "A description of the transform step. Can be used for documentation and agent context.",
+          "type": "string"
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/Field"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Collision height in logical pixels, including any desired vertical spacing. A number or expression supplies one value for all rows; a field supplies per-row values. Values must be non-negative. Setting either collision dimension to zero disables displacement for that row."
+        },
+        "key": {
+          "$ref": "#/definitions/Field",
+          "description": "Field containing a unique string or finite numeric identifier. Use a key to preserve placement when upstream transforms replace, filter, or reorder rows. Without a key, placement state follows row object identity."
+        },
+        "type": {
+          "const": "displace2d",
+          "description": "The type of the transform to be applied",
+          "type": "string"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/Field"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Collision width in logical pixels, including any desired horizontal spacing. A number or expression supplies one value for all rows; a field supplies per-row values. Values must be non-negative. Setting either collision dimension to zero disables displacement for that row."
+        },
+        "x": {
+          "$ref": "#/definitions/Field",
+          "description": "Field containing the anchor value mapped through the view's x scale."
+        },
+        "y": {
+          "$ref": "#/definitions/Field",
+          "description": "Field containing the anchor value mapped through the view's y scale."
+        }
+      },
+      "required": [
+        "height",
+        "type",
+        "width",
+        "x",
+        "y"
+      ],
+      "type": "object"
+    },
     "DomEventType": {
       "anyOf": [
         {
@@ -21519,7 +21808,7 @@
         },
         "direction": {
           "$ref": "#/definitions/DirectionDef",
-          "description": "Direction of arrow marks. Encoded values are mapped with a discrete scale whose range values must be `\"forward\"` or `\"reverse\"`.\n\nThis channel is supported by arrow marks only and does not create a legend."
+          "description": "Direction of arrow marks. Encoded values are mapped with a discrete scale whose range values must be `\"forward\"`, `\"reverse\"`, or `\"both\"`. The automatic range contains only `\"forward\"` and `\"reverse\"`; use an explicit value or range to select `\"both\"`.\n\nThis channel is supported by arrow marks only and does not create a legend."
         },
         "dx": {
           "anyOf": [
@@ -22058,6 +22347,11 @@
     "ExprFilterParams": {
       "additionalProperties": false,
       "properties": {
+        "debounce": {
+          "description": "Trailing-edge delay in milliseconds before requesting dataflow replay after a reactive expression dependency changes. Repeated changes restart the delay.\n\nParameter updates and incoming data are not delayed. Incoming batches use current parameter values, and a completed batch satisfies any pending reactive replay. The delay does not wait for independently scheduled lazy data loads.\n\n__Default value:__ no delay",
+          "minimum": 0,
+          "type": "number"
+        },
         "description": {
           "description": "A description of the transform step. Can be used for documentation and agent context.",
           "type": "string"
@@ -22079,39 +22373,17 @@
       "type": "object"
     },
     "ExprParameter": {
-      "additionalProperties": false,
-      "properties": {
-        "description": {
-          "description": "A description of the parameter. Can be used for documentation and to explain the meaning of the control or selection.",
-          "type": "string"
-        },
-        "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"
-        },
-        "persist": {
-          "description": "Whether the parameter should be persisted in bookmarks and provenance.\n\nThis primarily affects GenomeSpy App behavior. Set to `false` for ephemeral params (e.g., hover selections) or when the selection cannot be persisted due to missing `encoding.key`.\n\n__Default value:__ `true`",
-          "type": "boolean"
+      "anyOf": [
+        {
+          "$ref": "#/definitions/PlainExprParameter"
         },
-        "push": {
-          "const": "outer",
-          "description": "Reuses the nearest same-named parameter in an ancestor scope and writes updates to it. Declare the target parameter on the ancestor first.\n\nThis is useful when interaction in a child view updates state owned by a composed view, such as a parameter that controls a shared scale.",
-          "type": "string"
+        {
+          "$ref": "#/definitions/TransitionedExprParameter"
         },
-        "transition": {
-          "$ref": "#/definitions/ParamTransition",
-          "description": "Smoothly follows numeric expression output values."
+        {
+          "$ref": "#/definitions/DebouncedExprParameter"
         }
-      },
-      "required": [
-        "expr",
-        "name"
-      ],
-      "type": "object"
+      ]
     },
     "ExprRef": {
       "additionalProperties": false,
@@ -22889,6 +23161,11 @@
           "description": "The (new) field where the computed value is written to",
           "type": "string"
         },
+        "debounce": {
+          "description": "Trailing-edge delay in milliseconds before requesting dataflow replay after a reactive expression dependency changes. Repeated changes restart the delay.\n\nParameter updates and incoming data are not delayed. Incoming batches use current parameter values, and a completed batch satisfies any pending reactive replay. The delay does not wait for independently scheduled lazy data loads.\n\n__Default value:__ no delay",
+          "minimum": 0,
+          "type": "number"
+        },
         "description": {
           "description": "A description of the transform step. Can be used for documentation and agent context.",
           "type": "string"
@@ -23568,7 +23845,7 @@
         },
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -24575,7 +24852,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -25155,7 +25432,7 @@
       "properties": {
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -26171,7 +26448,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -28617,7 +28894,7 @@
       "properties": {
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -29634,7 +29911,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -29857,6 +30134,19 @@
         }
       ]
     },
+    "NamedSelectionPredicateRef": {
+      "additionalProperties": false,
+      "description": "Reference to a named selection predicate in the consuming unit view.",
+      "properties": {
+        "ref": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "ref"
+      ],
+      "type": "object"
+    },
     "NumericDomain": {
       "items": {
         "type": "number"
@@ -29910,6 +30200,27 @@
               "description": "Filter using a parameter name.",
               "type": "string"
             },
+            "project": {
+              "additionalProperties": false,
+              "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+              "properties": {
+                "x": {
+                  "enum": [
+                    "x",
+                    "x2"
+                  ],
+                  "type": "string"
+                },
+                "y": {
+                  "enum": [
+                    "y",
+                    "y2"
+                  ],
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
             "value": {
               "type": "number"
             }
@@ -29926,10 +30237,10 @@
             "test": {
               "anyOf": [
                 {
-                  "$ref": "#/definitions/ParameterPredicate"
+                  "$ref": "#/definitions/SelectionPredicateDefinition"
                 },
                 {
-                  "$ref": "#/definitions/SelectionUnionTest"
+                  "$ref": "#/definitions/NamedSelectionPredicateRef"
                 }
               ]
             },
@@ -30158,6 +30469,27 @@
         "param": {
           "description": "Filter using a parameter name.",
           "type": "string"
+        },
+        "project": {
+          "additionalProperties": false,
+          "description": "Bind interval selection components to positional channels of this mark. For example, `{ \"x\": \"x2\" }` tests the selected x interval against x2 alone. Each selected component must be mapped when this is provided. The target must be an unconditional field encoding of the same data type.",
+          "properties": {
+            "x": {
+              "enum": [
+                "x",
+                "x2"
+              ],
+              "type": "string"
+            },
+            "y": {
+              "enum": [
+                "y",
+                "y2"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
         }
       },
       "required": [
@@ -30263,6 +30595,37 @@
       ],
       "type": "object"
     },
+    "PlainExprParameter": {
+      "additionalProperties": false,
+      "properties": {
+        "description": {
+          "description": "A description of the parameter. Can be used for documentation and to explain the meaning of the control or selection.",
+          "type": "string"
+        },
+        "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"
+        },
+        "persist": {
+          "description": "Whether the parameter should be persisted in bookmarks and provenance.\n\nThis primarily affects GenomeSpy App behavior. Set to `false` for ephemeral params (e.g., hover selections) or when the selection cannot be persisted due to missing `encoding.key`.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "push": {
+          "const": "outer",
+          "description": "Reuses the nearest same-named parameter in an ancestor scope and writes updates to it. Declare the target parameter on the ancestor first.\n\nThis is useful when interaction in a child view updates state owned by a composed view, such as a parameter that controls a shared scale.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "expr",
+        "name"
+      ],
+      "type": "object"
+    },
     "PlainValueParameter": {
       "additionalProperties": false,
       "properties": {
@@ -33643,7 +34006,7 @@
       "properties": {
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -34670,7 +35033,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -36562,6 +36925,11 @@
     "SelectionFilterParams": {
       "additionalProperties": false,
       "properties": {
+        "debounce": {
+          "description": "Trailing-edge delay in milliseconds before requesting dataflow replay after a reactive expression dependency changes. Repeated changes restart the delay.\n\nParameter updates and incoming data are not delayed. Incoming batches use current parameter values, and a completed batch satisfies any pending reactive replay. The delay does not wait for independently scheduled lazy data loads.\n\n__Default value:__ no delay",
+          "minimum": 0,
+          "type": "number"
+        },
         "description": {
           "description": "A description of the transform step. Can be used for documentation and agent context.",
           "type": "string"
@@ -36672,6 +37040,69 @@
       ],
       "type": "object"
     },
+    "SelectionPredicateDefinition": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SelectionPredicateOperand"
+        },
+        {
+          "$ref": "#/definitions/SelectionUnionTest"
+        }
+      ],
+      "description": "A selection test; definitions cannot refer to other named predicates."
+    },
+    "SelectionPredicateOperand": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ParameterPredicate"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "and": {
+              "items": {
+                "$ref": "#/definitions/SelectionPredicateOperand"
+              },
+              "minItems": 1,
+              "type": "array"
+            }
+          },
+          "required": [
+            "and"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "or": {
+              "items": {
+                "$ref": "#/definitions/SelectionPredicateOperand"
+              },
+              "minItems": 1,
+              "type": "array"
+            }
+          },
+          "required": [
+            "or"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "not": {
+              "$ref": "#/definitions/SelectionPredicateOperand"
+            }
+          },
+          "required": [
+            "not"
+          ],
+          "type": "object"
+        }
+      ],
+      "description": "Selection predicates may be combined under a condition's `test` property."
+    },
     "SelectionType": {
       "enum": [
         "point",
@@ -37700,18 +38131,13 @@
             {
               "anyOf": [
                 {
-                  "const": "forward",
-                  "type": "string"
-                },
-                {
-                  "const": "reverse",
-                  "type": "string"
+                  "$ref": "#/definitions/ArrowDirection"
                 },
                 {
                   "$ref": "#/definitions/ExprRef"
                 }
               ],
-              "description": "Direction of the arrowhead. `\"forward\"` places the arrowhead at the secondary endpoint (`x2`, `y2`). `\"reverse\"` places it at the primary endpoint (`x`, `y`). For data-driven direction, use the `direction` encoding channel.\n\n__Default value:__ `\"forward\"`"
+              "description": "Direction of the arrowhead. `\"forward\"` places the arrowhead at the secondary endpoint (`x2`, `y2`). `\"reverse\"` places it at the primary endpoint (`x`, `y`). `\"both\"` places equivalent heads at both endpoints and suppresses `headSpacing` and `startNotch` for that arrow. For data-driven direction, use the `direction` encoding channel.\n\n__Default value:__ `\"forward\"`"
             },
             {
               "$ref": "#/definitions/LegendDirection",
@@ -38123,7 +38549,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Spacing between repeated arrowheads as a multiplier of resolved `size`. The effective spacing is at least the rendered arrowhead footprint, including stroke. If `null`, arrowheads are not repeated.\n\n__Default value:__ `null`"
+          "description": "Spacing between repeated arrowheads as a multiplier of resolved `size`. The effective spacing is at least the rendered arrowhead footprint, including stroke. If `null`, arrowheads are not repeated. Repetition is suppressed when `direction` resolves to `\"both\"`.\n\n__Default value:__ `null`"
         },
         "headWidth": {
           "anyOf": [
@@ -38732,7 +39158,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Whether to draw a notch at the start of the arrow. The start notch uses the same slope as the arrowhead edge.\n\n__Default value:__ `false`"
+          "description": "Whether to draw a notch at the start of the arrow. The start notch uses the same slope as the arrowhead edge. It is suppressed when `direction` resolves to `\"both\"` because a bidirectional arrow has no unique start.\n\n__Default value:__ `false`"
         },
         "stem": {
           "anyOf": [
@@ -41136,6 +41562,9 @@
         {
           "$ref": "#/definitions/Displace1DParams"
         },
+        {
+          "$ref": "#/definitions/Displace2DParams"
+        },
         {
           "$ref": "#/definitions/FlattenDelimitedParams"
         },
@@ -41210,6 +41639,42 @@
         }
       ]
     },
+    "TransitionedExprParameter": {
+      "additionalProperties": false,
+      "properties": {
+        "description": {
+          "description": "A description of the parameter. Can be used for documentation and to explain the meaning of the control or selection.",
+          "type": "string"
+        },
+        "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"
+        },
+        "persist": {
+          "description": "Whether the parameter should be persisted in bookmarks and provenance.\n\nThis primarily affects GenomeSpy App behavior. Set to `false` for ephemeral params (e.g., hover selections) or when the selection cannot be persisted due to missing `encoding.key`.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "push": {
+          "const": "outer",
+          "description": "Reuses the nearest same-named parameter in an ancestor scope and writes updates to it. Declare the target parameter on the ancestor first.\n\nThis is useful when interaction in a child view updates state owned by a composed view, such as a parameter that controls a shared scale.",
+          "type": "string"
+        },
+        "transition": {
+          "$ref": "#/definitions/ParamTransition",
+          "description": "Smoothly follows numeric expression output values."
+        }
+      },
+      "required": [
+        "expr",
+        "name",
+        "transition"
+      ],
+      "type": "object"
+    },
     "TransitionedMultiscaleStops": {
       "additionalProperties": false,
       "properties": {
@@ -41355,7 +41820,7 @@
       "properties": {
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -42345,6 +42810,13 @@
           },
           "type": "array"
         },
+        "predicates": {
+          "additionalProperties": {
+            "$ref": "#/definitions/SelectionPredicateDefinition"
+          },
+          "description": "Define a selection test once instead of repeating it across this unit's conditional encodings, including conditional draw order. Use `test: { ref: \"name\" }` in a condition to reference it.\n\nDefinitions are local to this unit and are not inherited. An inherited encoding may reference a name if each consuming unit defines it. Selection parameters and projected channels resolve in this unit. Filter transforms do not use these definitions.",
+          "type": "object"
+        },
         "resolve": {
           "additionalProperties": false,
           "description": "Specifies how scales, axes, and legends are [resolved](https://genomespy.app/docs/grammar/composition/#scale-axis-and-legend-resolution) in the view hierarchy.\n\nIf legend resolution is not configured explicitly, it follows the corresponding scale resolution.",
@@ -42363,7 +42835,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"
@@ -42707,7 +43179,7 @@
         },
         "axes": {
           "additionalProperties": false,
-          "description": "Defines properties for axis resolutions used by this view subtree.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
+          "description": "Defines properties for axis resolutions used by this view subtree. When a positional scale is declared at the view level, an axis can be created explicitly by declaring the corresponding channel here.\n\nUse this when a composed view shares an axis across child views and the axis settings belong to the composed view rather than an individual encoding. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error.",
           "properties": {
             "x": {
               "additionalProperties": false,
@@ -43700,7 +44172,7 @@
         },
         "scales": {
           "additionalProperties": false,
-          "description": "Defines properties for 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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
+          "description": "Defines properties for scale resolutions used by this view subtree. A scale declaration does not create an axis; declare the corresponding `axes` property when an axis is needed without a positional encoding.\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. An ancestor declaration shadows the whole declaration of a descendant that targets the same resolution. Declarations in separate sibling subtrees are ambiguous and cause an error. Expression references in these scale properties use this view's parameter scope and can access parameters declared here or on ancestors.",
           "properties": {
             "angle": {
               "$ref": "#/definitions/Scale"