@genome-spy/core 0.66.1 → 0.68.0

package/dist/schema.json

@@ -839,8 +839,8 @@
           "$ref": "#/definitions/FieldName",
           "description": "The field having the chromosome or contig."
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
           "type": "boolean"
         },
         "offset": {
@@ -999,7 +999,7 @@
           "type": "array"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
@@ -1020,6 +1020,10 @@
           ],
           "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
+        "domainInert": {
+          "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "encoding": {
           "$ref": "#/definitions/Encoding",
           "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -1043,7 +1047,7 @@
           "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "name": {
-          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+          "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
           "type": "string"
         },
         "padding": {
@@ -1090,6 +1094,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -1167,6 +1174,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -1218,6 +1228,17 @@
           },
           "type": "object"
         },
+        "separator": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/SeparatorProps"
+            }
+          ],
+          "description": "Draws separator rules between visible child views. The separators are centered within the spacing gaps and do not affect layout.\n\nIf `true`, the defaults are equivalent to: `{\"type\":\"rule\",\"size\":1,\"color\":\"#ccc\",\"opacity\":1,\"strokeDash\":[4,4],\"strokeCap\":\"butt\"}` Use `includePlotMargin` to control whether the separators extend into the plot margin.\n\n__Default value:__ `false`"
+        },
         "spacing": {
           "description": "The gap between the views, in pixels.",
           "type": "number"
@@ -1327,10 +1348,6 @@
           "minimum": 0,
           "type": "number"
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
-          "type": "boolean"
-        },
         "datum": {
           "anyOf": [
             {
@@ -1386,6 +1403,10 @@
         {
           "additionalProperties": false,
           "properties": {
+            "domainInert": {
+              "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "empty": {
               "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
               "type": "boolean"
@@ -1772,6 +1793,10 @@
           "$ref": "#/definitions/NumericMarkPropDef",
           "description": "Fill opacity of the marks."
         },
+        "key": {
+          "$ref": "#/definitions/KeyDef",
+          "description": "One or more data fields that uniquely identify data objects for stable point selections and bookmarking across sessions. Unlike `uniqueId` (an implicit surrogate key), key fields must be stable in the source data.\n\nUse a single field definition for simple keys, or an array of field definitions for composite keys. For composite keys, field order is significant."
+        },
         "opacity": {
           "$ref": "#/definitions/NumericMarkPropDef",
           "description": "Opacity of the marks."
@@ -1781,7 +1806,8 @@
           "description": "Facet identifier for interactive filtering, sorting, and grouping in the App."
         },
         "search": {
-          "$ref": "#/definitions/FieldDefWithoutScale"
+          "$ref": "#/definitions/SearchDef",
+          "description": "One or more fields used by the App's location/search input to match data objects in this view.\n\nUse a single field definition for simple search, or an array for matching against multiple fields. A datum matches when any configured search field matches the entered term."
         },
         "semanticScore": {
           "$ref": "#/definitions/FieldDefWithoutScale"
@@ -1840,8 +1866,8 @@
                   "description": "Builds and index for efficient rendering of subsets of the data. This setting is useful when rendering large amounts of data and often only a small subset of the data is visible. An example of such a situation is a scatter plot spanning the whole genome.\n\nThis setting implicitly sorts the data by the field assigned on the `x` channel.",
                   "type": "boolean"
                 },
-                "contributesToScaleDomain": {
-                  "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
+                "domainInert": {
+                  "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
                   "type": "boolean"
                 },
                 "field": {
@@ -1907,8 +1933,8 @@
                   "$ref": "#/definitions/FieldName",
                   "description": "The field having the chromosome or contig."
                 },
-                "contributesToScaleDomain": {
-                  "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
+                "domainInert": {
+                  "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
                   "type": "boolean"
                 },
                 "offset": {
@@ -1976,10 +2002,6 @@
                   "description": "Builds and index for efficient rendering of subsets of the data. This setting is useful when rendering large amounts of data and often only a small subset of the data is visible. An example of such a situation is a scatter plot spanning the whole genome.\n\nThis setting implicitly sorts the data by the field assigned on the `x` channel.",
                   "type": "boolean"
                 },
-                "contributesToScaleDomain": {
-                  "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
-                  "type": "boolean"
-                },
                 "datum": {
                   "anyOf": [
                     {
@@ -1991,6 +2013,10 @@
                   ],
                   "description": "A constant value in data domain."
                 },
+                "domainInert": {
+                  "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+                  "type": "boolean"
+                },
                 "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."
@@ -2046,6 +2072,10 @@
                   "description": "Builds and index for efficient rendering of subsets of the data. This setting is useful when rendering large amounts of data and often only a small subset of the data is visible. An example of such a situation is a scatter plot spanning the whole genome.\n\nThis setting implicitly sorts the data by the field assigned on the `x` channel.",
                   "type": "boolean"
                 },
+                "domainInert": {
+                  "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+                  "type": "boolean"
+                },
                 "expr": {
                   "description": "An expression. Properties of the data can be accessed through the `datum` object.",
                   "type": "string"
@@ -2218,16 +2248,12 @@
     "FieldName": {
       "type": "string"
     },
-    "FieldOrDatumDefWithCondition<DatumDef,(string|null)>": {
-      "additionalProperties": false,
+    "FieldOrDatumDefWithCondition<MarkPropFieldDef<Type>,(string|null)>": {
+      "additionalProperties": {
+        "not": {}
+      },
       "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
       "properties": {
-        "band": {
-          "description": "Relative position on band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
-          "maximum": 1,
-          "minimum": 0,
-          "type": "number"
-        },
         "condition": {
           "anyOf": [
             {
@@ -2242,20 +2268,13 @@
           ],
           "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
           "type": "boolean"
         },
-        "datum": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/Scalar"
-            },
-            {
-              "$ref": "#/definitions/ExprRef"
-            }
-          ],
-          "description": "A constant value in data domain."
+        "field": {
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`.",
+          "type": "string"
         },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
@@ -2283,18 +2302,17 @@
           "$ref": "#/definitions/Type"
         }
       },
+      "required": [
+        "type"
+      ],
       "type": "object"
     },
-    "FieldOrDatumDefWithCondition<DatumDef,number>": {
-      "additionalProperties": false,
+    "FieldOrDatumDefWithCondition<MarkPropFieldDef<Type>,number>": {
+      "additionalProperties": {
+        "not": {}
+      },
       "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
       "properties": {
-        "band": {
-          "description": "Relative position on band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
-          "maximum": 1,
-          "minimum": 0,
-          "type": "number"
-        },
         "condition": {
           "anyOf": [
             {
@@ -2309,20 +2327,13 @@
           ],
           "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
           "type": "boolean"
         },
-        "datum": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/Scalar"
-            },
-            {
-              "$ref": "#/definitions/ExprRef"
-            }
-          ],
-          "description": "A constant value in data domain."
+        "field": {
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`.",
+          "type": "string"
         },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
@@ -2350,9 +2361,12 @@
           "$ref": "#/definitions/Type"
         }
       },
+      "required": [
+        "type"
+      ],
       "type": "object"
     },
-    "FieldOrDatumDefWithCondition<MarkPropFieldDef<Type>,(string|null)>": {
+    "FieldOrDatumDefWithCondition<MarkPropFieldDef<TypeForShape>,(string|null)>": {
       "additionalProperties": {
         "not": {}
       },
@@ -2372,8 +2386,8 @@
           ],
           "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
           "type": "boolean"
         },
         "field": {
@@ -2403,7 +2417,7 @@
           ]
         },
         "type": {
-          "$ref": "#/definitions/Type"
+          "$ref": "#/definitions/TypeForShape"
         }
       },
       "required": [
@@ -2411,33 +2425,44 @@
       ],
       "type": "object"
     },
-    "FieldOrDatumDefWithCondition<MarkPropFieldDef<Type>,number>": {
-      "additionalProperties": {
-        "not": {}
-      },
+    "FieldOrDatumDefWithCondition<ScaleDatumDef,(string|null)>": {
+      "additionalProperties": false,
       "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
       "properties": {
+        "band": {
+          "description": "Relative position on band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
         "condition": {
           "anyOf": [
             {
-              "$ref": "#/definitions/Conditional%3CValueDef%3C(number%7CExprRef)%3E%3E"
+              "$ref": "#/definitions/Conditional%3CValueDef%3C(string%7Cnull%7CExprRef)%3E%3E"
             },
             {
               "items": {
-                "$ref": "#/definitions/Conditional%3CValueDef%3C(number%7CExprRef)%3E%3E"
+                "$ref": "#/definitions/Conditional%3CValueDef%3C(string%7Cnull%7CExprRef)%3E%3E"
               },
               "type": "array"
             }
           ],
           "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
-          "type": "boolean"
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scalar"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in data domain."
         },
-        "field": {
-          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`.",
-          "type": "string"
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+          "type": "boolean"
         },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
@@ -2465,38 +2490,46 @@
           "$ref": "#/definitions/Type"
         }
       },
-      "required": [
-        "type"
-      ],
       "type": "object"
     },
-    "FieldOrDatumDefWithCondition<MarkPropFieldDef<TypeForShape>,(string|null)>": {
-      "additionalProperties": {
-        "not": {}
-      },
+    "FieldOrDatumDefWithCondition<ScaleDatumDef,number>": {
+      "additionalProperties": false,
       "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
       "properties": {
+        "band": {
+          "description": "Relative position on band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
         "condition": {
           "anyOf": [
             {
-              "$ref": "#/definitions/Conditional%3CValueDef%3C(string%7Cnull%7CExprRef)%3E%3E"
+              "$ref": "#/definitions/Conditional%3CValueDef%3C(number%7CExprRef)%3E%3E"
             },
             {
               "items": {
-                "$ref": "#/definitions/Conditional%3CValueDef%3C(string%7Cnull%7CExprRef)%3E%3E"
+                "$ref": "#/definitions/Conditional%3CValueDef%3C(number%7CExprRef)%3E%3E"
               },
               "type": "array"
             }
           ],
           "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
-          "type": "boolean"
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scalar"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in data domain."
         },
-        "field": {
-          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`.",
-          "type": "string"
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+          "type": "boolean"
         },
         "resolutionChannel": {
           "$ref": "#/definitions/ChannelWithScale",
@@ -2521,12 +2554,9 @@
           ]
         },
         "type": {
-          "$ref": "#/definitions/TypeForShape"
+          "$ref": "#/definitions/Type"
         }
       },
-      "required": [
-        "type"
-      ],
       "type": "object"
     },
     "FilterParams": {
@@ -3228,7 +3258,7 @@
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
@@ -3249,6 +3279,10 @@
           ],
           "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
+        "domainInert": {
+          "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "encoding": {
           "$ref": "#/definitions/Encoding",
           "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -3286,7 +3320,7 @@
           "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "name": {
-          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+          "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
           "type": "string"
         },
         "padding": {
@@ -3333,6 +3367,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -3410,6 +3447,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -3461,6 +3501,17 @@
           },
           "type": "object"
         },
+        "separator": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/SeparatorProps"
+            }
+          ],
+          "description": "Draws separator rules between visible child views. The separators are centered within the spacing gaps and do not affect layout.\n\nIf `true`, the defaults are equivalent to: `{\"type\":\"rule\",\"size\":1,\"color\":\"#ccc\",\"opacity\":1,\"strokeDash\":[4,4],\"strokeCap\":\"butt\"}` Use `includePlotMargin` to control whether the separators extend into the plot margin.\n\n__Default value:__ `false`"
+        },
         "spacing": {
           "description": "The gap between the views, in pixels.",
           "type": "number"
@@ -3596,7 +3647,7 @@
           "description": "The method to import a specification."
         },
         "name": {
-          "description": "The name given to the imported view. This property overrides the name specified in the imported specification.",
+          "description": "The name given to the imported view. This property overrides the name specified in the imported specification and defines an import scope that is used for bookmarkable view visibility and parameter addressing.",
           "type": "string"
         },
         "params": {
@@ -3826,6 +3877,19 @@
       },
       "type": "object"
     },
+    "KeyDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldDefWithoutScale"
+        },
+        {
+          "items": {
+            "$ref": "#/definitions/FieldDefWithoutScale"
+          },
+          "type": "array"
+        }
+      ]
+    },
     "LayerSpec": {
       "additionalProperties": false,
       "properties": {
@@ -3848,7 +3912,7 @@
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
@@ -3869,6 +3933,10 @@
           ],
           "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
+        "domainInert": {
+          "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "encoding": {
           "$ref": "#/definitions/Encoding",
           "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -3908,7 +3976,7 @@
           "type": "array"
         },
         "name": {
-          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+          "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
           "type": "string"
         },
         "opacity": {
@@ -3959,6 +4027,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -4036,6 +4107,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -4545,7 +4619,7 @@
           "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CMarkPropFieldDef%3CTypeForShape%3E%2C(string%7Cnull)%3E"
         },
         {
-          "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CDatumDef%2C(string%7Cnull)%3E"
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CScaleDatumDef%2C(string%7Cnull)%3E"
         },
         {
           "$ref": "#/definitions/ValueDefWithCondition%3C(string%7Cnull)%3E"
@@ -4558,7 +4632,7 @@
           "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CMarkPropFieldDef%3CType%3E%2C(string%7Cnull)%3E"
         },
         {
-          "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CDatumDef%2C(string%7Cnull)%3E"
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CScaleDatumDef%2C(string%7Cnull)%3E"
         },
         {
           "$ref": "#/definitions/ValueDefWithCondition%3C(string%7Cnull)%3E"
@@ -4571,7 +4645,7 @@
           "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CMarkPropFieldDef%3CType%3E%2Cnumber%3E"
         },
         {
-          "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CDatumDef%2Cnumber%3E"
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition%3CScaleDatumDef%2Cnumber%3E"
         },
         {
           "$ref": "#/definitions/ValueDefWithCondition%3Cnumber%3E"
@@ -5090,6 +5164,10 @@
               "minimum": 0,
               "type": "number"
             },
+            "domainInert": {
+              "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "field": {
               "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`.",
               "type": "string"
@@ -5116,10 +5194,6 @@
               "minimum": 0,
               "type": "number"
             },
-            "contributesToScaleDomain": {
-              "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
-              "type": "boolean"
-            },
             "datum": {
               "anyOf": [
                 {
@@ -5131,6 +5205,10 @@
               ],
               "description": "A constant value in data domain."
             },
+            "domainInert": {
+              "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "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."
@@ -5168,6 +5246,10 @@
               "minimum": 0,
               "type": "number"
             },
+            "domainInert": {
+              "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "expr": {
               "description": "An expression. Properties of the data can be accessed through the `datum` object.",
               "type": "string"
@@ -5213,10 +5295,6 @@
           "minimum": 0,
           "type": "number"
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
-          "type": "boolean"
-        },
         "datum": {
           "anyOf": [
             {
@@ -5228,6 +5306,10 @@
           ],
           "description": "A constant value in data domain."
         },
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "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."
@@ -5298,6 +5380,10 @@
           "minimum": 0,
           "type": "number"
         },
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "expr": {
           "description": "An expression. Properties of the data can be accessed through the `datum` object.",
           "type": "string"
@@ -5339,8 +5425,8 @@
           "minimum": 0,
           "type": "number"
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
           "type": "boolean"
         },
         "field": {
@@ -5920,7 +6006,7 @@
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
@@ -5949,6 +6035,10 @@
               ],
               "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
+            "domainInert": {
+              "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "encoding": {
               "$ref": "#/definitions/Encoding",
               "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -5986,7 +6076,7 @@
               "description": "The graphical mark presenting the data objects."
             },
             "name": {
-              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+              "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
               "type": "string"
             },
             "opacity": {
@@ -6037,6 +6127,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -6114,6 +6207,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -6281,7 +6377,7 @@
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
@@ -6310,6 +6406,10 @@
               ],
               "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
+            "domainInert": {
+              "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "encoding": {
               "$ref": "#/definitions/Encoding",
               "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -6352,7 +6452,7 @@
               "type": "array"
             },
             "name": {
-              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+              "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
               "type": "string"
             },
             "opacity": {
@@ -6403,6 +6503,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -6480,6 +6583,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -6632,7 +6738,7 @@
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
@@ -6661,6 +6767,10 @@
               ],
               "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
+            "domainInert": {
+              "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "encoding": {
               "$ref": "#/definitions/Encoding",
               "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -6687,7 +6797,7 @@
               "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "name": {
-              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+              "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
               "type": "string"
             },
             "padding": {
@@ -6734,6 +6844,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -6811,6 +6924,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -6862,6 +6978,17 @@
               },
               "type": "object"
             },
+            "separator": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/SeparatorProps"
+                }
+              ],
+              "description": "Draws separator rules between visible child views. The separators are centered within the spacing gaps and do not affect layout.\n\nIf `true`, the defaults are equivalent to: `{\"type\":\"rule\",\"size\":1,\"color\":\"#ccc\",\"opacity\":1,\"strokeDash\":[4,4],\"strokeCap\":\"butt\"}` Use `includePlotMargin` to control whether the separators extend into the plot margin.\n\n__Default value:__ `false`"
+            },
             "spacing": {
               "description": "The gap between the views, in pixels.",
               "type": "number"
@@ -6978,7 +7105,7 @@
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
@@ -7007,6 +7134,10 @@
               ],
               "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
+            "domainInert": {
+              "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "encoding": {
               "$ref": "#/definitions/Encoding",
               "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -7047,7 +7178,7 @@
               "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "name": {
-              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+              "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
               "type": "string"
             },
             "padding": {
@@ -7094,6 +7225,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -7171,6 +7305,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -7222,6 +7359,17 @@
               },
               "type": "object"
             },
+            "separator": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/SeparatorProps"
+                }
+              ],
+              "description": "Draws separator rules between visible child views. The separators are centered within the spacing gaps and do not affect layout.\n\nIf `true`, the defaults are equivalent to: `{\"type\":\"rule\",\"size\":1,\"color\":\"#ccc\",\"opacity\":1,\"strokeDash\":[4,4],\"strokeCap\":\"butt\"}` Use `includePlotMargin` to control whether the separators extend into the plot margin.\n\n__Default value:__ `false`"
+            },
             "spacing": {
               "description": "The gap between the views, in pixels.",
               "type": "number"
@@ -7342,7 +7490,7 @@
               "type": "array"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
@@ -7371,6 +7519,10 @@
               ],
               "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
+            "domainInert": {
+              "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "encoding": {
               "$ref": "#/definitions/Encoding",
               "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -7397,7 +7549,7 @@
               "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "name": {
-              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+              "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
               "type": "string"
             },
             "padding": {
@@ -7444,6 +7596,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -7521,6 +7676,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -7572,6 +7730,17 @@
               },
               "type": "object"
             },
+            "separator": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/SeparatorProps"
+                }
+              ],
+              "description": "Draws separator rules between visible child views. The separators are centered within the spacing gaps and do not affect layout.\n\nIf `true`, the defaults are equivalent to: `{\"type\":\"rule\",\"size\":1,\"color\":\"#ccc\",\"opacity\":1,\"strokeDash\":[4,4],\"strokeCap\":\"butt\"}` Use `includePlotMargin` to control whether the separators extend into the plot margin.\n\n__Default value:__ `false`"
+            },
             "spacing": {
               "description": "The gap between the views, in pixels.",
               "type": "number"
@@ -7675,7 +7844,7 @@
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
@@ -7704,6 +7873,10 @@
               ],
               "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
+            "domainInert": {
+              "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+              "type": "boolean"
+            },
             "encoding": {
               "$ref": "#/definitions/Encoding",
               "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -7730,7 +7903,7 @@
               "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "name": {
-              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+              "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
               "type": "string"
             },
             "padding": {
@@ -7777,6 +7950,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -7854,6 +8030,9 @@
                     "fillOpacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
+                    "key": {
+                      "$ref": "#/definitions/ResolutionBehavior"
+                    },
                     "opacity": {
                       "$ref": "#/definitions/ResolutionBehavior"
                     },
@@ -8315,7 +8494,7 @@
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
@@ -8336,6 +8515,10 @@
           ],
           "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
+        "domainInert": {
+          "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "encoding": {
           "$ref": "#/definitions/Encoding",
           "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -8359,7 +8542,7 @@
           "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "name": {
-          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+          "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
           "type": "string"
         },
         "padding": {
@@ -8406,6 +8589,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -8483,6 +8669,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -8926,6 +9115,19 @@
       ],
       "type": "object"
     },
+    "SearchDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldDefWithoutScale"
+        },
+        {
+          "items": {
+            "$ref": "#/definitions/FieldDefWithoutScale"
+          },
+          "type": "array"
+        }
+      ]
+    },
     "SecondaryChromPosDef": {
       "additionalProperties": false,
       "properties": {
@@ -8950,6 +9152,10 @@
           "$ref": "#/definitions/FieldName",
           "description": "The field having the chromosome or contig."
         },
+        "domainInert": {
+          "description": "Whether the field or evaluated expr should be excluded from the scale's domain. Prefer the view-level `domainInert` when an entire subtree should be excluded.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "offset": {
           "description": "An offset or offsets that allow for adjusting the numbering base. The offset is subtracted from the positions.\n\nGenomeSpy uses internally zero-based indexing with half-open intervals. UCSC-based formats (BED, etc.) generally use this scheme. However, for example, VCF files use one-based indexing and must be adjusted by setting the offset to `1`.\n\n**Default:** `0`",
           "type": "number"
@@ -9051,6 +9257,10 @@
           "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",
           "type": "string"
@@ -9087,6 +9297,167 @@
       ],
       "type": "string"
     },
+    "SeparatorProps": {
+      "additionalProperties": false,
+      "properties": {
+        "clip": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "const": "never",
+              "type": "string"
+            }
+          ],
+          "description": "If true, the mark is clipped to the UnitView's rectangle. By default, clipping is enabled for marks that have zoomable positional scales."
+        },
+        "color": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Color of the mark. Affects either `fill` or `stroke`, depending on the `filled` property."
+        },
+        "includePlotMargin": {
+          "description": "Whether separators extend into the plot margin (axes/padding) around the grid.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "minBufferSize": {
+          "description": "Minimum size for WebGL buffers (number of data items). Allows for using `bufferSubData()` to update graphics.\n\nThis property is intended for internal use.",
+          "type": "number"
+        },
+        "minLength": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The minimum length of the rule in pixels. Use this property to ensure that very short ranged rules remain visible even when the user zooms out.\n\n**Default value:** `0`"
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Opacity of the mark. Affects `fillOpacity` or `strokeOpacity`, depending on the `filled` property."
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Stroke width of `\"link\"` and `\"rule\"` marks in pixels, the area of the bounding square of `\"point\"` mark, or the font size of `\"text\"` mark."
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "const": "butt",
+              "type": "string"
+            },
+            {
+              "const": "square",
+              "type": "string"
+            },
+            {
+              "const": "round",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The style of stroke ends. Available choices: `\"butt\"`, `\"round`\", and `\"square\"`.\n\n**Default value:** `\"butt\"`"
+        },
+        "strokeDash": {
+          "description": "An array of of alternating stroke and gap lengths or `null` for solid strokes.\n\n**Default value:** `null`",
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        "strokeDashOffset": {
+          "description": "An offset for the stroke dash pattern.\n\n**Default value:** `0`",
+          "type": "number"
+        },
+        "tooltip": {
+          "$ref": "#/definitions/Tooltip",
+          "description": "Tooltip handler. If `null`, no tooltip is shown. If string, specifies the [tooltip handler](https://genomespy.app/docs/api/#custom-tooltip-handlers) to use."
+        },
+        "type": {
+          "const": "rule",
+          "type": "string"
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Position on the x axis."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary position on the x axis."
+        },
+        "xOffset": {
+          "description": "Offsets of the `x` and `x2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
+          "type": "number"
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Position on the y axis."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary position on the y axis."
+        },
+        "yOffset": {
+          "description": "Offsets of the `y` and `y2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
     "SequenceGenerator": {
       "additionalProperties": false,
       "properties": {
@@ -9259,10 +9630,6 @@
           "minimum": 0,
           "type": "number"
         },
-        "contributesToScaleDomain": {
-          "description": "Whether the field or evaluated expr should be included in the scale's domain.\n\n**Default value:** `true`",
-          "type": "boolean"
-        },
         "datum": {
           "anyOf": [
             {
@@ -9866,7 +10233,7 @@
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
@@ -9887,6 +10254,10 @@
           ],
           "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
+        "domainInert": {
+          "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "encoding": {
           "$ref": "#/definitions/Encoding",
           "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -9921,7 +10292,7 @@
           "description": "The graphical mark presenting the data objects."
         },
         "name": {
-          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+          "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
           "type": "string"
         },
         "opacity": {
@@ -9972,6 +10343,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -10049,6 +10423,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -10285,7 +10662,7 @@
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is unique within its import scope.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
@@ -10306,6 +10683,10 @@
           ],
           "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
+        "domainInert": {
+          "description": "If true, this view and its descendants do not contribute to scale domains. Child views inherit this flag automatically.\n\n**Default value:** `false`",
+          "type": "boolean"
+        },
         "encoding": {
           "$ref": "#/definitions/Encoding",
           "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
@@ -10329,7 +10710,7 @@
           "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "name": {
-          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
+          "description": "An explicit name used to address the view. It is recommended to keep names unique among siblings. In the App (where view state is bookmarkable), the name must be unique within its import scope for views with configurable visibility, etc.",
           "type": "string"
         },
         "padding": {
@@ -10376,6 +10757,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -10453,6 +10837,9 @@
                 "fillOpacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
+                "key": {
+                  "$ref": "#/definitions/ResolutionBehavior"
+                },
                 "opacity": {
                   "$ref": "#/definitions/ResolutionBehavior"
                 },
@@ -10504,6 +10891,17 @@
           },
           "type": "object"
         },
+        "separator": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/SeparatorProps"
+            }
+          ],
+          "description": "Draws separator rules between visible child views. The separators are centered within the spacing gaps and do not affect layout.\n\nIf `true`, the defaults are equivalent to: `{\"type\":\"rule\",\"size\":1,\"color\":\"#ccc\",\"opacity\":1,\"strokeDash\":[4,4],\"strokeCap\":\"butt\"}` Use `includePlotMargin` to control whether the separators extend into the plot margin.\n\n__Default value:__ `false`"
+        },
         "spacing": {
           "description": "The gap between the views, in pixels.",
           "type": "number"
@@ -10740,6 +11138,10 @@
           "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",
           "type": "string"