@opendata-ai/openchart-core 8.7.0 → 8.8.0

package/schema/vizspec.schema.json

@@ -22638,6 +22638,17 @@
             }
           ],
           "description": "Focus the camera. A feature id (or array) fits those features; `{ features, padding }` adds breathing room; `{ points: true, padding }` fits the points layer's cluster instead of any feature (use when points occupy a small part of a large feature, so fitting the feature would leave the cluster small and off-center); `{ points: { field, value }, padding }` fits only the matching point subset, so a story can pan between sub-clusters. null clears focus from a prior story step."
+        },
+        "zoom": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/GeoMapZoomConfig"
+            }
+          ],
+          "description": "Let readers zoom and pan the map. Off by default. `true` enables it with defaults; an object tunes the zoom ceiling and the on-screen buttons. Gestures: ctrl/cmd + wheel or trackpad pinch zooms around the cursor (a plain wheel scrolls the page), drag pans, double-click zooms in, two-finger pinch zooms on touch, and +/-/arrows/0 work when the map has focus. One finger scrolls the page until the reader has zoomed in, then pans the map."
         }
       },
       "required": [
@@ -22749,6 +22760,21 @@
       ],
       "description": "Fit the point layer's cluster. `true` fits every point; `{ field, value }` fits only the points whose data row has `row[field] === value` (e.g. only the campuses rated \"F\"), which lets a story pan between sub-clusters."
     },
+    "GeoMapZoomConfig": {
+      "type": "object",
+      "properties": {
+        "maxZoom": {
+          "type": "number",
+          "description": "Largest zoom factor, relative to the full map. Default 12, minimum 1."
+        },
+        "controls": {
+          "type": "boolean",
+          "description": "Show on-screen zoom in / zoom out / reset buttons. Default true."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Reader zoom and pan for a map. Opt-in: maps without it stay static.\n\n`maxZoom` caps how far readers can zoom in, as a multiple of the full map (the full map is 1, and readers can never zoom out past it). `controls` shows the on-screen zoom in / zoom out / reset buttons."
+    },
     "GeoMapEncoding": {
       "type": "object",
       "properties": {