@fusion.dev/helix 0.114.0 → 0.116.0

package/custom-elements.json

@@ -77453,6 +77453,33 @@
               "attribute": "tone",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "caption",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Words drawn on the map with the area, such as `A` for a search sector.\nUnset, nothing is drawn. Keep it short: it is a caption on a map, and the\narea's `label` is what a screen reader hears.",
+              "attribute": "caption",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapArea",
+                "module": "src/map/area/map-area.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "captionPlacement",
+              "type": {
+                "text": "'inside' | 'outside'"
+              },
+              "default": "'inside'",
+              "description": "Where the caption stands. `inside`, the default, at the point of the area\nfurthest from its edges. `outside`, just above the area's northernmost\npoint, clear of the shape, for an area whose caption would cover what is\nin it.",
+              "attribute": "caption-placement",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapArea",
+                "module": "src/map/area/map-area.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "description",
@@ -77854,6 +77881,31 @@
               "description": "The area's color. Uses your primary color unless set.",
               "fieldName": "tone"
             },
+            {
+              "name": "caption",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Words drawn on the map with the area, such as `A` for a search sector.\nUnset, nothing is drawn. Keep it short: it is a caption on a map, and the\narea's `label` is what a screen reader hears.",
+              "fieldName": "caption",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapArea",
+                "module": "src/map/area/map-area.ts"
+              }
+            },
+            {
+              "name": "caption-placement",
+              "type": {
+                "text": "'inside' | 'outside'"
+              },
+              "default": "'inside'",
+              "description": "Where the caption stands. `inside`, the default, at the point of the area\nfurthest from its edges. `outside`, just above the area's northernmost\npoint, clear of the shape, for an area whose caption would cover what is\nin it.",
+              "fieldName": "captionPlacement",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMapArea",
+                "module": "src/map/area/map-area.ts"
+              }
+            },
             {
               "name": "description",
               "type": {
@@ -83774,6 +83826,20 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "activateHintLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Press the map to use it'",
+              "description": "The hint shown when a map waiting to be pressed is scrolled or swiped\nover, with `gestures=\"activate\"`.",
+              "attribute": "activate-hint-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "bearing",
@@ -83830,6 +83896,19 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
+              },
+              "description": "Which gestures the map takes from the page.\n\n- `always`, which unset is: the wheel zooms the map and one finger pans\n  it, for a map that is the page, such as a full-screen view.\n- `cooperative`: the wheel and one finger scroll the page, and the map\n  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so\n  when a gesture passes to the page. Best for a map embedded in a page.\n- `activate`: the map takes nothing until it is pressed, and gives it\n  back on Escape, when the pointer leaves it, or on a press elsewhere.\n\nThe keyboard and the frame's buttons work in every mode. The renderer is\ntold through the connector, so MapLibre and Leaflet behave alike.",
+              "attribute": "gestures",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "hybridLabel",
@@ -84082,6 +84161,48 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "twoFingerHintLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Use two fingers to move the map'",
+              "description": "The hint shown when one finger swipes over a map with `gestures=\"cooperative\"`.",
+              "attribute": "two-finger-hint-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "usingLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Using the map. Press Escape to scroll the page again.'",
+              "description": "The line shown while a map with `gestures=\"activate\"` has the gestures.",
+              "attribute": "using-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "wheelHintLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Use {key} and scroll to zoom the map'",
+              "description": "The hint shown when the wheel scrolls past a map with\n`gestures=\"cooperative\"`, with `{key}`, which is ⌘ on a Mac and Ctrl\nelsewhere, as the renderer reads it.",
+              "attribute": "wheel-hint-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "zoomedLabel",
@@ -84565,6 +84686,167 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "hint",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''",
+              "description": "The hint on the map while one shows, put there by a gesture the map let pass.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hinting",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private",
+              "description": "When the hint goes.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hintAt",
+              "type": {
+                "text": "{ x: number; y: number } | undefined"
+              },
+              "privacy": "private",
+              "description": "Where the gesture was, in the map's box, which the hint is shown at:\nwhere the reader is looking, and on the map wherever a page laid its own\ncontent over the rest of it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "taken",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether a map with `gestures=\"activate\"` has been pressed, and has the gestures.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "showHint",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "words",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "at",
+                  "optional": true,
+                  "type": {
+                    "text": "{ clientX: number; clientY: number }"
+                  }
+                }
+              ],
+              "description": "Shows a hint over the map for a moment, where the gesture was.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleWheel",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A wheel the map let pass to the page, which is said: a reader scrolling\nthe page past a map that did not zoom is told why, and how to zoom it.\n**Ctrl or ⌘ with the wheel is the map's**, and is what a trackpad's pinch\narrives as.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTouchMove",
+              "privacy": "private",
+              "readonly": true,
+              "description": "One finger moving over the map, which scrolls the page, and is said.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTake",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press on the map itself, which hands a waiting map the gestures.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackKey",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Escape, which gives the page its scroll back.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackOutside",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press anywhere else on the page, which gives it its scroll back.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackBlur",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The window losing focus, as a reader switching away does.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleLeave",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The pointer leaving the frame. **Heard on the frame and not the map's\ncanvas**, which a pointer resting on a marker has left, since markers\nstand outside it. **A mouse or a pen and never a finger**, whose\n`pointerleave` is the finger lifting: a tap took the map and gave it back\nin one.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleSlotChange",
@@ -85274,6 +85556,19 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "name": "activate-hint-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Press the map to use it'",
+              "description": "The hint shown when a map waiting to be pressed is scrolled or swiped\nover, with `gestures=\"activate\"`.",
+              "fieldName": "activateHintLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "name": "bearing",
               "type": {
@@ -85326,6 +85621,18 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
+              },
+              "description": "Which gestures the map takes from the page.\n\n- `always`, which unset is: the wheel zooms the map and one finger pans\n  it, for a map that is the page, such as a full-screen view.\n- `cooperative`: the wheel and one finger scroll the page, and the map\n  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so\n  when a gesture passes to the page. Best for a map embedded in a page.\n- `activate`: the map takes nothing until it is pressed, and gives it\n  back on Escape, when the pointer leaves it, or on a press elsewhere.\n\nThe keyboard and the frame's buttons work in every mode. The renderer is\ntold through the connector, so MapLibre and Leaflet behave alike.",
+              "fieldName": "gestures",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "name": "hybrid-label",
               "type": {
@@ -85559,6 +85866,45 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "name": "two-finger-hint-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Use two fingers to move the map'",
+              "description": "The hint shown when one finger swipes over a map with `gestures=\"cooperative\"`.",
+              "fieldName": "twoFingerHintLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "name": "using-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Using the map. Press Escape to scroll the page again.'",
+              "description": "The line shown while a map with `gestures=\"activate\"` has the gestures.",
+              "fieldName": "usingLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "name": "wheel-hint-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Use {key} and scroll to zoom the map'",
+              "description": "The hint shown when the wheel scrolls past a map with\n`gestures=\"cooperative\"`, with `{key}`, which is ⌘ on a Mac and Ctrl\nelsewhere, as the renderer reads it.",
+              "fieldName": "wheelHintLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "name": "zoomed-label",
               "type": {
@@ -85609,7 +85955,11 @@
                 "slug": "preview"
               },
               {
-                "description": "A map behind a page's own words, filling a hero whose words decide its height, with its credit in a corner and no landmarks.",
+                "description": "Search sectors, each named on the map by its caption: two inside their sector and one above it, clear of what it holds.",
+                "slug": "areas"
+              },
+              {
+                "description": "A map behind a page's own words, filling a hero whose words decide its height, with its credit in a corner, no landmarks, and the page's scroll left to the page.",
                 "slug": "behind-content"
               },
               {
@@ -85748,6 +86098,22 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "description": "Words over the map for a moment when it lets a gesture pass to the page, such as how to zoom it.",
+              "name": "gesture-hint",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
+            {
+              "description": "The line shown while a map with `gestures=\"activate\"` has the gestures.",
+              "name": "gesture-status",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "description": "The strip above the map.",
               "name": "header",
@@ -86080,6 +86446,14 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "description": "A map with `gestures=\"activate\"` has been pressed and has the gestures.",
+              "name": "using",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "description": "Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.",
               "name": "settled",

package/dist/map/root/map-root.css.js

@@ -31,6 +31,43 @@ overflow: hidden;
 position: relative;
 }
 
+[part="gesture-hint"],
+[part="gesture-status"] {
+background-color: var(--helix-color-surface-inverse);
+border-radius: var(--helix-radii-sm);
+color: var(--helix-color-foreground-inverse);
+
+left: 50%;
+max-inline-size: calc(100% - var(--helix-space-lg) * 2);
+pointer-events: none;
+position: absolute;
+text-align: center;
+z-index: calc(var(--helix-layer-raised) + 2);
+}
+
+[part="gesture-hint"] {
+font-size: var(--helix-text-sm);
+inset-block-start: clamp(
+var(--helix-space-2xl),
+var(--_map-hint-y, 50%),
+calc(100% - var(--helix-space-2xl))
+);
+padding: var(--helix-space-xs) var(--helix-space-sm);
+translate: -50% -50%;
+}
+
+[part="gesture-status"] {
+font-size: var(--helix-text-xs);
+inset-block-start: var(--helix-space-xs);
+padding: var(--helix-space-2xs) var(--helix-space-xs);
+translate: -50% 0;
+}
+
+[part="gesture-hint"][hidden],
+[part="gesture-status"][hidden] {
+display: none;
+}
+
 [part="layers"] {
 block-size: 1px;
 clip-path: inset(50%);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix",
   "description": "Styled component tier. Extends the headless tier with token-driven presentation.",
-  "version": "0.114.0",
+  "version": "0.116.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -51,13 +51,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.114.0",
-    "@fusion.dev/helix-headless": "0.114.0",
-    "@fusion.dev/helix-styles": "0.114.0"
+    "@fusion.dev/helix-core": "0.116.0",
+    "@fusion.dev/helix-headless": "0.116.0",
+    "@fusion.dev/helix-styles": "0.116.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.114.0",
-    "@fusion.dev/helix-testing": "0.114.0",
+    "@fusion.dev/helix-cem": "0.116.0",
+    "@fusion.dev/helix-testing": "0.116.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -13627,6 +13627,20 @@ export type HelixMapAreaHelixMapPartChangeElementEvent =
 export type HelixMapAreaProps = {
   /** The area's color. Uses your primary color unless set. */
   tone?: (HelixMapArea["tone"]) | undefined;
+  /** Words drawn on the map with the area, such as `A` for a search sector.
+Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+area's `label` is what a screen reader hears. */
+  caption?: (HelixMapArea["caption"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  "caption-placement"?: (HelixMapArea["captionPlacement"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  captionPlacement?: (HelixMapArea["captionPlacement"]) | undefined;
   /** More about the area. Read after its label in the frame's list. */
   description?: (HelixMapArea["description"]) | undefined;
   /** A name this layer shares with other layers, such as a route and its
@@ -13649,6 +13663,20 @@ first. */
 export type HelixMapAreaSolidJsProps = {
   /** The area's color. Uses your primary color unless set. */
   "prop:tone"?: (HelixMapArea["tone"]) | undefined;
+  /** Words drawn on the map with the area, such as `A` for a search sector.
+Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+area's `label` is what a screen reader hears. */
+  "prop:caption"?: (HelixMapArea["caption"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  "attr:caption-placement"?: (HelixMapArea["captionPlacement"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  "prop:captionPlacement"?: (HelixMapArea["captionPlacement"]) | undefined;
   /** More about the area. Read after its label in the frame's list. */
   "prop:description"?: (HelixMapArea["description"]) | undefined;
   /** A name this layer shares with other layers, such as a route and its
@@ -14389,6 +14417,12 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "zoom-out-label"?: (HelixMap["zoomOutLabel"]) | undefined;
   /** The zoom out button's label. */
   zoomOutLabel?: (HelixMap["zoomOutLabel"]) | undefined;
+  /** The hint shown when a map waiting to be pressed is scrolled or swiped
+over, with `gestures="activate"`. */
+  "activate-hint-label"?: (HelixMap["activateHintLabel"]) | undefined;
+  /** The hint shown when a map waiting to be pressed is scrolled or swiped
+over, with `gestures="activate"`. */
+  activateHintLabel?: (HelixMap["activateHintLabel"]) | undefined;
   /** The map's rotation, in degrees clockwise from north. `connectMap` keeps it
 current, and the Face north button's needle turns with it. */
   bearing?: (HelixMap["bearing"]) | undefined;
@@ -14403,6 +14437,19 @@ the map zooms in, and pressing one zooms in to its places. */
   "flat-label"?: (HelixMap["flatLabel"]) | undefined;
   /** What screen readers hear when the map is tilted back to looking straight down. */
   flatLabel?: (HelixMap["flatLabel"]) | undefined;
+  /** Which gestures the map takes from the page.
+
+- `always`, which unset is: the wheel zooms the map and one finger pans
+  it, for a map that is the page, such as a full-screen view.
+- `cooperative`: the wheel and one finger scroll the page, and the map
+  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
+  when a gesture passes to the page. Best for a map embedded in a page.
+- `activate`: the map takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode. The renderer is
+told through the connector, so MapLibre and Leaflet behave alike. */
+  gestures?: (HelixMap["gestures"]) | undefined;
   /** The Hybrid map type's name. */
   "hybrid-label"?: (HelixMap["hybridLabel"]) | undefined;
   /** The Hybrid map type's name. */
@@ -14484,6 +14531,22 @@ top of the map faces, clockwise from north. */
   /** What screen readers hear when the map is turned. `{degrees}` is the way the
 top of the map faces, clockwise from north. */
   turnedLabel?: (HelixMap["turnedLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
+  "two-finger-hint-label"?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
+  twoFingerHintLabel?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a map with `gestures="activate"` has the gestures. */
+  "using-label"?: (HelixMap["usingLabel"]) | undefined;
+  /** The line shown while a map with `gestures="activate"` has the gestures. */
+  usingLabel?: (HelixMap["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a map with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere, as the renderer reads it. */
+  "wheel-hint-label"?: (HelixMap["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a map with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere, as the renderer reads it. */
+  wheelHintLabel?: (HelixMap["wheelHintLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
   "zoomed-label"?: (HelixMap["zoomedLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
@@ -14663,6 +14726,12 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "attr:zoom-out-label"?: (HelixMap["zoomOutLabel"]) | undefined;
   /** The zoom out button's label. */
   "prop:zoomOutLabel"?: (HelixMap["zoomOutLabel"]) | undefined;
+  /** The hint shown when a map waiting to be pressed is scrolled or swiped
+over, with `gestures="activate"`. */
+  "attr:activate-hint-label"?: (HelixMap["activateHintLabel"]) | undefined;
+  /** The hint shown when a map waiting to be pressed is scrolled or swiped
+over, with `gestures="activate"`. */
+  "prop:activateHintLabel"?: (HelixMap["activateHintLabel"]) | undefined;
   /** The map's rotation, in degrees clockwise from north. `connectMap` keeps it
 current, and the Face north button's needle turns with it. */
   "prop:bearing"?: (HelixMap["bearing"]) | undefined;
@@ -14677,6 +14746,19 @@ the map zooms in, and pressing one zooms in to its places. */
   "attr:flat-label"?: (HelixMap["flatLabel"]) | undefined;
   /** What screen readers hear when the map is tilted back to looking straight down. */
   "prop:flatLabel"?: (HelixMap["flatLabel"]) | undefined;
+  /** Which gestures the map takes from the page.
+
+- `always`, which unset is: the wheel zooms the map and one finger pans
+  it, for a map that is the page, such as a full-screen view.
+- `cooperative`: the wheel and one finger scroll the page, and the map
+  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
+  when a gesture passes to the page. Best for a map embedded in a page.
+- `activate`: the map takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode. The renderer is
+told through the connector, so MapLibre and Leaflet behave alike. */
+  "prop:gestures"?: (HelixMap["gestures"]) | undefined;
   /** The Hybrid map type's name. */
   "attr:hybrid-label"?: (HelixMap["hybridLabel"]) | undefined;
   /** The Hybrid map type's name. */
@@ -14758,6 +14840,22 @@ top of the map faces, clockwise from north. */
   /** What screen readers hear when the map is turned. `{degrees}` is the way the
 top of the map faces, clockwise from north. */
   "prop:turnedLabel"?: (HelixMap["turnedLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
+  "attr:two-finger-hint-label"?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
+  "prop:twoFingerHintLabel"?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a map with `gestures="activate"` has the gestures. */
+  "attr:using-label"?: (HelixMap["usingLabel"]) | undefined;
+  /** The line shown while a map with `gestures="activate"` has the gestures. */
+  "prop:usingLabel"?: (HelixMap["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a map with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere, as the renderer reads it. */
+  "attr:wheel-hint-label"?: (HelixMap["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a map with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere, as the renderer reads it. */
+  "prop:wheelHintLabel"?: (HelixMap["wheelHintLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
   "attr:zoomed-label"?: (HelixMap["zoomedLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
@@ -37015,6 +37113,13 @@ export type CustomElements = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `tone`: The area's color. Uses your primary color unless set.
+   * - `caption`: Words drawn on the map with the area, such as `A` for a search sector.
+   * Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+   * area's `label` is what a screen reader hears.
+   * - `caption-placement`/`captionPlacement`: Where the caption stands. `inside`, the default, at the point of the area
+   * furthest from its edges. `outside`, just above the area's northernmost
+   * point, clear of the shape, for an area whose caption would cover what is
+   * in it.
    * - `description`: More about the area. Read after its label in the frame's list.
    * - `group`: A name this layer shares with other layers, such as a route and its
    * dotted legs. The layers menu shows layers in the same group as one entry,
@@ -37668,12 +37773,26 @@ export type CustomElements = {
    * - `pan-up-label`/`panUpLabel`: The pan up button's label.
    * - `zoom-in-label`/`zoomInLabel`: The zoom in button's label.
    * - `zoom-out-label`/`zoomOutLabel`: The zoom out button's label.
+   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a map waiting to be pressed is scrolled or swiped
+   * over, with `gestures="activate"`.
    * - `bearing`: The map's rotation, in degrees clockwise from north. `connectMap` keeps it
    * current, and the Face north button's needle turns with it.
    * - `cluster`: Combines markers that would overlap into one count. Counts split apart as
    * the map zooms in, and pressing one zooms in to its places.
    * - `face-north-label`/`faceNorthLabel`: The Face north button's label.
    * - `flat-label`/`flatLabel`: What screen readers hear when the map is tilted back to looking straight down.
+   * - `gestures`: Which gestures the map takes from the page.
+   *
+   * - `always`, which unset is: the wheel zooms the map and one finger pans
+   *   it, for a map that is the page, such as a full-screen view.
+   * - `cooperative`: the wheel and one finger scroll the page, and the map
+   *   takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
+   *   when a gesture passes to the page. Best for a map embedded in a page.
+   * - `activate`: the map takes nothing until it is pressed, and gives it
+   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
+   *
+   * The keyboard and the frame's buttons work in every mode. The renderer is
+   * told through the connector, so MapLibre and Leaflet behave alike.
    * - `hybrid-label`/`hybridLabel`: The Hybrid map type's name.
    * - `label`: The map's name, read by screen readers. Name the place, such as "Delivery
    * area", so that several maps on one page can be told apart. Required.
@@ -37700,6 +37819,11 @@ export type CustomElements = {
    * - `tilt-label`/`tiltLabel`: The 3D button's label.
    * - `turned-label`/`turnedLabel`: What screen readers hear when the map is turned. `{degrees}` is the way the
    * top of the map faces, clockwise from north.
+   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a map with `gestures="cooperative"`.
+   * - `using-label`/`usingLabel`: The line shown while a map with `gestures="activate"` has the gestures.
+   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a map with
+   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+   * elsewhere, as the renderer reads it.
    * - `zoomed-label`/`zoomedLabel`: What screen readers hear after a zoom. `{level}` is the zoom level.
    * - `zoom-level`/`zoomLevel`: How far the map is zoomed, in its renderer's levels. `connectMap` keeps it
    * current, and the map says it after a zoom.
@@ -37802,6 +37926,8 @@ export type CustomElements = {
    * - `face-north`: The compass: its needle points north as the map turns, and pressing it turns the map to face north.
    * - `footer`: The strip below the map.
    * - `fullscreen`: The button that makes the map fill the screen.
+   * - `gesture-hint`: Words over the map for a moment when it lets a gesture pass to the page, such as how to zoom it.
+   * - `gesture-status`: The line shown while a map with `gestures="activate"` has the gestures.
    * - `header`: The strip above the map.
    * - `layer`: One entry in the list of the map's layers.
    * - `layer-choice`: One layer's tile in the layers menu, pressed while the layer is shown.
@@ -37836,6 +37962,7 @@ export type CustomElements = {
    * - `fullscreen`: The map fills the screen.
    * - `idle`: The user has been still long enough for the header and footer to fade.
    * - `ready`: The map has been drawn whole, after `helix-map-ready`.
+   * - `using`: A map with `gestures="activate"` has been pressed and has the gestures.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-map": Partial<HelixMapProps & BaseProps<HelixMap> & BaseEvents<HelixMap>>;
@@ -59017,6 +59144,13 @@ export type CustomElementsSolidJs = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `tone`: The area's color. Uses your primary color unless set.
+   * - `caption`: Words drawn on the map with the area, such as `A` for a search sector.
+   * Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+   * area's `label` is what a screen reader hears.
+   * - `caption-placement`/`captionPlacement`: Where the caption stands. `inside`, the default, at the point of the area
+   * furthest from its edges. `outside`, just above the area's northernmost
+   * point, clear of the shape, for an area whose caption would cover what is
+   * in it.
    * - `description`: More about the area. Read after its label in the frame's list.
    * - `group`: A name this layer shares with other layers, such as a route and its
    * dotted legs. The layers menu shows layers in the same group as one entry,
@@ -59694,12 +59828,26 @@ export type CustomElementsSolidJs = {
    * - `pan-up-label`/`panUpLabel`: The pan up button's label.
    * - `zoom-in-label`/`zoomInLabel`: The zoom in button's label.
    * - `zoom-out-label`/`zoomOutLabel`: The zoom out button's label.
+   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a map waiting to be pressed is scrolled or swiped
+   * over, with `gestures="activate"`.
    * - `bearing`: The map's rotation, in degrees clockwise from north. `connectMap` keeps it
    * current, and the Face north button's needle turns with it.
    * - `cluster`: Combines markers that would overlap into one count. Counts split apart as
    * the map zooms in, and pressing one zooms in to its places.
    * - `face-north-label`/`faceNorthLabel`: The Face north button's label.
    * - `flat-label`/`flatLabel`: What screen readers hear when the map is tilted back to looking straight down.
+   * - `gestures`: Which gestures the map takes from the page.
+   *
+   * - `always`, which unset is: the wheel zooms the map and one finger pans
+   *   it, for a map that is the page, such as a full-screen view.
+   * - `cooperative`: the wheel and one finger scroll the page, and the map
+   *   takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
+   *   when a gesture passes to the page. Best for a map embedded in a page.
+   * - `activate`: the map takes nothing until it is pressed, and gives it
+   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
+   *
+   * The keyboard and the frame's buttons work in every mode. The renderer is
+   * told through the connector, so MapLibre and Leaflet behave alike.
    * - `hybrid-label`/`hybridLabel`: The Hybrid map type's name.
    * - `label`: The map's name, read by screen readers. Name the place, such as "Delivery
    * area", so that several maps on one page can be told apart. Required.
@@ -59726,6 +59874,11 @@ export type CustomElementsSolidJs = {
    * - `tilt-label`/`tiltLabel`: The 3D button's label.
    * - `turned-label`/`turnedLabel`: What screen readers hear when the map is turned. `{degrees}` is the way the
    * top of the map faces, clockwise from north.
+   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a map with `gestures="cooperative"`.
+   * - `using-label`/`usingLabel`: The line shown while a map with `gestures="activate"` has the gestures.
+   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a map with
+   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+   * elsewhere, as the renderer reads it.
    * - `zoomed-label`/`zoomedLabel`: What screen readers hear after a zoom. `{level}` is the zoom level.
    * - `zoom-level`/`zoomLevel`: How far the map is zoomed, in its renderer's levels. `connectMap` keeps it
    * current, and the map says it after a zoom.
@@ -59828,6 +59981,8 @@ export type CustomElementsSolidJs = {
    * - `face-north`: The compass: its needle points north as the map turns, and pressing it turns the map to face north.
    * - `footer`: The strip below the map.
    * - `fullscreen`: The button that makes the map fill the screen.
+   * - `gesture-hint`: Words over the map for a moment when it lets a gesture pass to the page, such as how to zoom it.
+   * - `gesture-status`: The line shown while a map with `gestures="activate"` has the gestures.
    * - `header`: The strip above the map.
    * - `layer`: One entry in the list of the map's layers.
    * - `layer-choice`: One layer's tile in the layers menu, pressed while the layer is shown.
@@ -59862,6 +60017,7 @@ export type CustomElementsSolidJs = {
    * - `fullscreen`: The map fills the screen.
    * - `idle`: The user has been still long enough for the header and footer to fade.
    * - `ready`: The map has been drawn whole, after `helix-map-ready`.
+   * - `using`: A map with `gestures="activate"` has been pressed and has the gestures.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-map": Partial<

package/types/vue.d.ts

@@ -6969,6 +6969,20 @@ export type HelixMapAreaHelixMapPartChangeElementEvent =
 export type HelixMapAreaVueProps = {
   /** The area's color. Uses your primary color unless set. */
   tone?: (HelixMapArea["tone"]) | undefined;
+  /** Words drawn on the map with the area, such as `A` for a search sector.
+Unset, nothing is drawn. Keep it short: it is a caption on a map, and the
+area's `label` is what a screen reader hears. */
+  caption?: (HelixMapArea["caption"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  "caption-placement"?: (HelixMapArea["captionPlacement"]) | undefined;
+  /** Where the caption stands. `inside`, the default, at the point of the area
+furthest from its edges. `outside`, just above the area's northernmost
+point, clear of the shape, for an area whose caption would cover what is
+in it. */
+  captionPlacement?: (HelixMapArea["captionPlacement"]) | undefined;
   /** More about the area. Read after its label in the frame's list. */
   description?: (HelixMapArea["description"]) | undefined;
   /** A name this layer shares with other layers, such as a route and its
@@ -7452,6 +7466,12 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "zoom-out-label"?: (HelixMap["zoomOutLabel"]) | undefined;
   /** The zoom out button's label. */
   zoomOutLabel?: (HelixMap["zoomOutLabel"]) | undefined;
+  /** The hint shown when a map waiting to be pressed is scrolled or swiped
+over, with `gestures="activate"`. */
+  "activate-hint-label"?: (HelixMap["activateHintLabel"]) | undefined;
+  /** The hint shown when a map waiting to be pressed is scrolled or swiped
+over, with `gestures="activate"`. */
+  activateHintLabel?: (HelixMap["activateHintLabel"]) | undefined;
   /** The map's rotation, in degrees clockwise from north. `connectMap` keeps it
 current, and the Face north button's needle turns with it. */
   bearing?: (HelixMap["bearing"]) | undefined;
@@ -7466,6 +7486,19 @@ the map zooms in, and pressing one zooms in to its places. */
   "flat-label"?: (HelixMap["flatLabel"]) | undefined;
   /** What screen readers hear when the map is tilted back to looking straight down. */
   flatLabel?: (HelixMap["flatLabel"]) | undefined;
+  /** Which gestures the map takes from the page.
+
+- `always`, which unset is: the wheel zooms the map and one finger pans
+  it, for a map that is the page, such as a full-screen view.
+- `cooperative`: the wheel and one finger scroll the page, and the map
+  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
+  when a gesture passes to the page. Best for a map embedded in a page.
+- `activate`: the map takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode. The renderer is
+told through the connector, so MapLibre and Leaflet behave alike. */
+  gestures?: (HelixMap["gestures"]) | undefined;
   /** The Hybrid map type's name. */
   "hybrid-label"?: (HelixMap["hybridLabel"]) | undefined;
   /** The Hybrid map type's name. */
@@ -7547,6 +7580,22 @@ top of the map faces, clockwise from north. */
   /** What screen readers hear when the map is turned. `{degrees}` is the way the
 top of the map faces, clockwise from north. */
   turnedLabel?: (HelixMap["turnedLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
+  "two-finger-hint-label"?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
+  twoFingerHintLabel?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a map with `gestures="activate"` has the gestures. */
+  "using-label"?: (HelixMap["usingLabel"]) | undefined;
+  /** The line shown while a map with `gestures="activate"` has the gestures. */
+  usingLabel?: (HelixMap["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a map with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere, as the renderer reads it. */
+  "wheel-hint-label"?: (HelixMap["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a map with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere, as the renderer reads it. */
+  wheelHintLabel?: (HelixMap["wheelHintLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
   "zoomed-label"?: (HelixMap["zoomedLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */