@fusion.dev/helix 0.117.0 → 0.118.0

package/custom-elements.json

@@ -14451,6 +14451,19 @@
               "attribute": "separation",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "activateHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when a surface waiting to be pressed is scrolled or\nswiped over, with `gestures=\"activate\"`. Absent is the family's own.",
+              "attribute": "activate-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "controls",
@@ -14506,6 +14519,19 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
+              },
+              "description": "Which gestures the surface takes from the page.\n\n- `always`: the surface takes the wheel and one finger, for a surface\n  that is the page, such as a full-screen view. A map rests here.\n- Unset is the family's own: `always` for a map, and for a board, a\n  drag and a pinch, with the plain wheel left to the page until the\n  board fills the screen.\n- `cooperative`: the wheel and one finger scroll the page, and the\n  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame\n  says so when a gesture passes to the page. Best for a surface embedded\n  in a page.\n- `activate`: the surface 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.\n\n**Unreflected and without a default**, because a default that reflected\nwould write an attribute onto every host that no server sent, and the\nhydration that followed would disagree with it.",
+              "attribute": "gestures",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "idleDelay",
@@ -14590,6 +14616,45 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "twoFingerHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when one finger swipes over a surface with\n`gestures=\"cooperative\"`. Absent is the family's own.",
+              "attribute": "two-finger-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "usingLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The line shown while a surface with `gestures=\"activate\"` has the\ngestures. Absent is the family's own.",
+              "attribute": "using-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "wheelHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when the wheel scrolls past a surface with\n`gestures=\"cooperative\"`, with `{key}`, which is ⌘ on a Mac and Ctrl\nelsewhere. Absent is the family's own.",
+              "attribute": "wheel-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "zoomInLabel",
@@ -14632,6 +14697,73 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "gesturesTaken",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "default": "false",
+              "description": "Whether an `activate` surface has been pressed, and has the gestures.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hint",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''",
+              "description": "The hint over the surface while one shows, put there by a gesture it let pass.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hinting",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private",
+              "description": "When the hint goes.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hintAt",
+              "type": {
+                "text": "{ x: number; y: number } | undefined"
+              },
+              "privacy": "private",
+              "description": "Where the gesture was, in the viewport's box, which the hint is shown\nat: where the reader is looking, and on the surface wherever a page laid\nits own content over the rest of it.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "takenBy",
+              "type": {
+                "text": "Event | undefined"
+              },
+              "privacy": "private",
+              "description": "The press that took the gestures, which is not also the first gesture.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "fullscreen",
@@ -14682,6 +14814,180 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "restingGestureLabels",
+              "type": {
+                "text": "ViewportGestureLabels"
+              },
+              "privacy": "protected",
+              "description": "What the surface says about its gestures where the page does not say\nit, which a family overrides to name what it is: \"Press the map to use\nit\" reads better than a word that fits every surface.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "gestureAllowed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Whether a gesture that started with this event is the surface's to\nanswer, for a family that answers gestures itself. Never while an\n`activate` surface waits, and never on the press that ended the wait:\nthat press hands over the gestures and moves nothing.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "gesturesChanged",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Says that `gestureMode` changed. Nothing here; a family whose renderer\nis told through a connector says it with its own event.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.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 surface for a moment, where the gesture was.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGestureWheel",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A wheel the surface let pass to the page, which is said: a reader\nscrolling the page past a surface that did not zoom is told why, and how\nto zoom it. **Ctrl or ⌘ with the wheel is the surface's**, and is what a\ntrackpad's pinch arrives as.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGestureTouch",
+              "privacy": "private",
+              "readonly": true,
+              "description": "One finger moving over the surface, which scrolls the page, and is said.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTake",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press on the surface itself, which hands a waiting surface the gestures.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackKey",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Escape, which gives the page its scroll back.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.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": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackBlur",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The window losing focus, as a reader switching away does.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handlePointerLeave",
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The pointer leaving the frame, which the family binds on its region.\n**Heard on the frame and not the drawing**, which a pointer resting on\nsomething raised over it has left. **A mouse or a pen and never a\nfinger**, whose `pointerleave` is the finger lifting: a tap took the\nsurface and gave it back in one.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderGestures",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The hint over the surface and the line while it is in use, which the\nfamily draws inside its viewport, over what was slotted. The parts are\nwritten out, as the controls' are, so the manifest sees them.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "panEvent",
@@ -16768,6 +17074,17 @@
                 "module": "src/canvas/root/canvas-root.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "handleTouchStart",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A second finger on a cooperative board, which would otherwise go on\nscrolling the page the first finger started: stopped at the start, so\nthe two fingers pinch and move the board. **Not passive**, which is the\nonly way a start can be stopped.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCanvas",
+                "module": "src/canvas/root/canvas-root.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "handleStopKeydown",
@@ -17725,6 +18042,18 @@
               "description": "How the board is set apart from the page. `plain` draws no frame.\n\nFramed is where it rests. Plain is for a board that fills a panel or an\napp's working area, where the container is already the frame.",
               "fieldName": "separation"
             },
+            {
+              "name": "activate-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when a surface waiting to be pressed is scrolled or\nswiped over, with `gestures=\"activate\"`. Absent is the family's own.",
+              "fieldName": "activateHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "controls",
               "type": {
@@ -17774,6 +18103,18 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
+              },
+              "description": "Which gestures the surface takes from the page.\n\n- `always`: the surface takes the wheel and one finger, for a surface\n  that is the page, such as a full-screen view. A map rests here.\n- Unset is the family's own: `always` for a map, and for a board, a\n  drag and a pinch, with the plain wheel left to the page until the\n  board fills the screen.\n- `cooperative`: the wheel and one finger scroll the page, and the\n  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame\n  says so when a gesture passes to the page. Best for a surface embedded\n  in a page.\n- `activate`: the surface 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.\n\n**Unreflected and without a default**, because a default that reflected\nwould write an attribute onto every host that no server sent, and the\nhydration that followed would disagree with it.",
+              "fieldName": "gestures",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "idle-delay",
               "type": {
@@ -17852,6 +18193,42 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "name": "two-finger-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when one finger swipes over a surface with\n`gestures=\"cooperative\"`. Absent is the family's own.",
+              "fieldName": "twoFingerHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "using-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The line shown while a surface with `gestures=\"activate\"` has the\ngestures. Absent is the family's own.",
+              "fieldName": "usingLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "wheel-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when the wheel scrolls past a surface with\n`gestures=\"cooperative\"`, with `{key}`, which is ⌘ on a Mac and Ctrl\nelsewhere. Absent is the family's own.",
+              "fieldName": "wheelHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "zoom-in-label",
               "type": {
@@ -18218,6 +18595,22 @@
                 "module": "src/canvas/root/canvas-root.ts"
               }
             },
+            {
+              "description": "Words over the board for a moment when it lets a gesture pass to the page, such as how to zoom it.",
+              "name": "gesture-hint",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCanvas",
+                "module": "src/canvas/root/canvas-root.ts"
+              }
+            },
+            {
+              "description": "The line shown while a board with `gestures=\"activate\"` has the gestures.",
+              "name": "gesture-status",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCanvas",
+                "module": "src/canvas/root/canvas-root.ts"
+              }
+            },
             {
               "description": "The strip above the board.",
               "name": "header",
@@ -18538,6 +18931,22 @@
                 "module": "src/canvas/root/canvas-root.ts"
               }
             },
+            {
+              "description": "The page keeps the plain wheel and one finger, with `gestures=\"cooperative\"` or while a board with `gestures=\"activate\"` waits to be pressed.",
+              "name": "sharing",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCanvas",
+                "module": "src/canvas/root/canvas-root.ts"
+              }
+            },
+            {
+              "description": "A board with `gestures=\"activate\"` has been pressed and has the gestures.",
+              "name": "using",
+              "inheritedFrom": {
+                "name": "HelixHeadlessCanvas",
+                "module": "src/canvas/root/canvas-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",
@@ -61587,6 +61996,19 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "activateHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when a surface waiting to be pressed is scrolled or\nswiped over, with `gestures=\"activate\"`. Absent is the family's own.",
+              "attribute": "activate-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "controls",
@@ -61642,6 +62064,19 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
+              },
+              "description": "Which gestures the surface takes from the page.\n\n- `always`: the surface takes the wheel and one finger, for a surface\n  that is the page, such as a full-screen view. A map rests here.\n- Unset is the family's own: `always` for a map, and for a board, a\n  drag and a pinch, with the plain wheel left to the page until the\n  board fills the screen.\n- `cooperative`: the wheel and one finger scroll the page, and the\n  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame\n  says so when a gesture passes to the page. Best for a surface embedded\n  in a page.\n- `activate`: the surface 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.\n\n**Unreflected and without a default**, because a default that reflected\nwould write an attribute onto every host that no server sent, and the\nhydration that followed would disagree with it.",
+              "attribute": "gestures",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "idleDelay",
@@ -61726,6 +62161,45 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "twoFingerHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when one finger swipes over a surface with\n`gestures=\"cooperative\"`. Absent is the family's own.",
+              "attribute": "two-finger-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "usingLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The line shown while a surface with `gestures=\"activate\"` has the\ngestures. Absent is the family's own.",
+              "attribute": "using-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "wheelHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when the wheel scrolls past a surface with\n`gestures=\"cooperative\"`, with `{key}`, which is ⌘ on a Mac and Ctrl\nelsewhere. Absent is the family's own.",
+              "attribute": "wheel-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "zoomInLabel",
@@ -61768,6 +62242,73 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "gesturesTaken",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "default": "false",
+              "description": "Whether an `activate` surface has been pressed, and has the gestures.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hint",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''",
+              "description": "The hint over the surface while one shows, put there by a gesture it let pass.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hinting",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private",
+              "description": "When the hint goes.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hintAt",
+              "type": {
+                "text": "{ x: number; y: number } | undefined"
+              },
+              "privacy": "private",
+              "description": "Where the gesture was, in the viewport's box, which the hint is shown\nat: where the reader is looking, and on the surface wherever a page laid\nits own content over the rest of it.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "takenBy",
+              "type": {
+                "text": "Event | undefined"
+              },
+              "privacy": "private",
+              "description": "The press that took the gestures, which is not also the first gesture.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "fullscreen",
@@ -61818,6 +62359,180 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "restingGestureLabels",
+              "type": {
+                "text": "ViewportGestureLabels"
+              },
+              "privacy": "protected",
+              "description": "What the surface says about its gestures where the page does not say\nit, which a family overrides to name what it is: \"Press the map to use\nit\" reads better than a word that fits every surface.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "gestureAllowed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Whether a gesture that started with this event is the surface's to\nanswer, for a family that answers gestures itself. Never while an\n`activate` surface waits, and never on the press that ended the wait:\nthat press hands over the gestures and moves nothing.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "gesturesChanged",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Says that `gestureMode` changed. Nothing here; a family whose renderer\nis told through a connector says it with its own event.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.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 surface for a moment, where the gesture was.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGestureWheel",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A wheel the surface let pass to the page, which is said: a reader\nscrolling the page past a surface that did not zoom is told why, and how\nto zoom it. **Ctrl or ⌘ with the wheel is the surface's**, and is what a\ntrackpad's pinch arrives as.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGestureTouch",
+              "privacy": "private",
+              "readonly": true,
+              "description": "One finger moving over the surface, which scrolls the page, and is said.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTake",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press on the surface itself, which hands a waiting surface the gestures.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackKey",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Escape, which gives the page its scroll back.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.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": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackBlur",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The window losing focus, as a reader switching away does.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handlePointerLeave",
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The pointer leaving the frame, which the family binds on its region.\n**Heard on the frame and not the drawing**, which a pointer resting on\nsomething raised over it has left. **A mouse or a pen and never a\nfinger**, whose `pointerleave` is the finger lifting: a tap took the\nsurface and gave it back in one.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderGestures",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The hint over the surface and the line while it is in use, which the\nfamily draws inside its viewport, over what was slotted. The parts are\nwritten out, as the controls' are, so the manifest sees them.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "panEvent",
@@ -62541,7 +63256,7 @@
                   "default": "true"
                 }
               ],
-              "description": "Says the graph has been drawn whole, or with `false`, that it no longer\nis. Call it when the renderer's layout has settled and the graph is\nfinished. The first call after\nthe graph was not drawn sends `helix-graph-ready` and turns on\n`:state(ready)`.",
+              "description": "Says the graph has been drawn whole, or with `false`, that it no longer\nis. Called by `connectGraph` once its layout has settled; a page drawing\nits own graph calls it when that graph is finished. The first call after\nthe graph was not drawn sends `helix-graph-ready` and turns on\n`:state(ready)`.",
               "type": {
                 "text": "drawn(whole = true) => void"
               },
@@ -62550,6 +63265,31 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "laidOut",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "positions",
+                  "type": {
+                    "text": "Record<string, { x: number; y: number }>"
+                  }
+                }
+              ],
+              "description": "Says where a layout put each note, by its `id`: sends\n`helix-graph-layout` for the page to keep. Called by `connectGraph` once\nits layout has settled; a page laying out its own graph calls it the same\nway.",
+              "type": {
+                "text": "laidOut(positions: Record<string, { x: number; y: number }>) => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "countText",
@@ -63050,6 +63790,18 @@
           "tagName": "helix-graph",
           "customElement": true,
           "attributes": [
+            {
+              "name": "activate-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when a surface waiting to be pressed is scrolled or\nswiped over, with `gestures=\"activate\"`. Absent is the family's own.",
+              "fieldName": "activateHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "controls",
               "type": {
@@ -63099,6 +63851,18 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
+              },
+              "description": "Which gestures the surface takes from the page.\n\n- `always`: the surface takes the wheel and one finger, for a surface\n  that is the page, such as a full-screen view. A map rests here.\n- Unset is the family's own: `always` for a map, and for a board, a\n  drag and a pinch, with the plain wheel left to the page until the\n  board fills the screen.\n- `cooperative`: the wheel and one finger scroll the page, and the\n  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame\n  says so when a gesture passes to the page. Best for a surface embedded\n  in a page.\n- `activate`: the surface 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.\n\n**Unreflected and without a default**, because a default that reflected\nwould write an attribute onto every host that no server sent, and the\nhydration that followed would disagree with it.",
+              "fieldName": "gestures",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "idle-delay",
               "type": {
@@ -63177,6 +63941,42 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "name": "two-finger-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when one finger swipes over a surface with\n`gestures=\"cooperative\"`. Absent is the family's own.",
+              "fieldName": "twoFingerHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "using-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The line shown while a surface with `gestures=\"activate\"` has the\ngestures. Absent is the family's own.",
+              "fieldName": "usingLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "wheel-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when the wheel scrolls past a surface with\n`gestures=\"cooperative\"`, with `{key}`, which is ⌘ on a Mac and Ctrl\nelsewhere. Absent is the family's own.",
+              "fieldName": "wheelHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "zoom-in-label",
               "type": {
@@ -63370,11 +64170,23 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "type": {
+                "text": "HelixGraphLayoutEvent"
+              },
+              "description": "A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`.",
+              "name": "helix-graph-layout",
+              "reactProp": "onhelix-graph-layout",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "type": {
                 "text": "HelixGraphPanEvent"
               },
-              "description": "A pan button or arrow key was pressed. Move the drawing.",
+              "description": "A pan button or arrow key was pressed. `connectGraph` moves the drawing.",
               "name": "helix-graph-pan",
               "reactProp": "onhelix-graph-pan",
               "inheritedFrom": {
@@ -63382,6 +64194,18 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "type": {
+                "text": "HelixGraphPartChangeEvent"
+              },
+              "description": "The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.",
+              "name": "helix-graph-part-change",
+              "reactProp": "onhelix-graph-part-change",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "type": {
                 "text": "HelixGraphReadyEvent"
@@ -63398,7 +64222,7 @@
               "type": {
                 "text": "HelixGraphZoomEvent"
               },
-              "description": "A zoom button or key was pressed. Zoom the drawing.",
+              "description": "A zoom button or key was pressed. `connectGraph` zooms the drawing.",
               "name": "helix-graph-zoom",
               "reactProp": "onhelix-graph-zoom",
               "inheritedFrom": {
@@ -63514,6 +64338,22 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "description": "Words over the graph for a moment when it lets a gesture pass to the page, such as how to zoom it.",
+              "name": "gesture-hint",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The line shown while a graph with `gestures=\"activate\"` has the gestures.",
+              "name": "gesture-status",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "description": "The strip above the graph.",
               "name": "header",
@@ -63708,6 +64548,22 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "description": "The page keeps the plain wheel and one finger, with `gestures=\"cooperative\"` or while a graph with `gestures=\"activate\"` waits to be pressed.",
+              "name": "sharing",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "A graph with `gestures=\"activate\"` has been pressed and has the gestures.",
+              "name": "using",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-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",
@@ -85511,6 +86367,19 @@
               "attribute": "material",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "activateHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when a surface waiting to be pressed is scrolled or\nswiped over, with `gestures=\"activate\"`. Absent is the family's own.",
+              "attribute": "activate-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "controls",
@@ -85566,6 +86435,19 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
+              },
+              "description": "Which gestures the surface takes from the page.\n\n- `always`: the surface takes the wheel and one finger, for a surface\n  that is the page, such as a full-screen view. A map rests here.\n- Unset is the family's own: `always` for a map, and for a board, a\n  drag and a pinch, with the plain wheel left to the page until the\n  board fills the screen.\n- `cooperative`: the wheel and one finger scroll the page, and the\n  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame\n  says so when a gesture passes to the page. Best for a surface embedded\n  in a page.\n- `activate`: the surface 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.\n\n**Unreflected and without a default**, because a default that reflected\nwould write an attribute onto every host that no server sent, and the\nhydration that followed would disagree with it.",
+              "attribute": "gestures",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "idleDelay",
@@ -85650,6 +86532,45 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "twoFingerHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when one finger swipes over a surface with\n`gestures=\"cooperative\"`. Absent is the family's own.",
+              "attribute": "two-finger-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "usingLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The line shown while a surface with `gestures=\"activate\"` has the\ngestures. Absent is the family's own.",
+              "attribute": "using-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "wheelHintLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when the wheel scrolls past a surface with\n`gestures=\"cooperative\"`, with `{key}`, which is ⌘ on a Mac and Ctrl\nelsewhere. Absent is the family's own.",
+              "attribute": "wheel-hint-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "zoomInLabel",
@@ -85692,6 +86613,73 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "gesturesTaken",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "default": "false",
+              "description": "Whether an `activate` surface has been pressed, and has the gestures.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hint",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''",
+              "description": "The hint over the surface while one shows, put there by a gesture it let pass.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hinting",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private",
+              "description": "When the hint goes.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hintAt",
+              "type": {
+                "text": "{ x: number; y: number } | undefined"
+              },
+              "privacy": "private",
+              "description": "Where the gesture was, in the viewport's box, which the hint is shown\nat: where the reader is looking, and on the surface wherever a page laid\nits own content over the rest of it.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "takenBy",
+              "type": {
+                "text": "Event | undefined"
+              },
+              "privacy": "private",
+              "description": "The press that took the gestures, which is not also the first gesture.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "fullscreen",
@@ -85742,6 +86730,180 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "restingGestureLabels",
+              "type": {
+                "text": "ViewportGestureLabels"
+              },
+              "privacy": "protected",
+              "description": "What the surface says about its gestures where the page does not say\nit, which a family overrides to name what it is: \"Press the map to use\nit\" reads better than a word that fits every surface.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "gestureAllowed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Whether a gesture that started with this event is the surface's to\nanswer, for a family that answers gestures itself. Never while an\n`activate` surface waits, and never on the press that ended the wait:\nthat press hands over the gestures and moves nothing.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "gesturesChanged",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Says that `gestureMode` changed. Nothing here; a family whose renderer\nis told through a connector says it with its own event.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.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 surface for a moment, where the gesture was.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGestureWheel",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A wheel the surface let pass to the page, which is said: a reader\nscrolling the page past a surface that did not zoom is told why, and how\nto zoom it. **Ctrl or ⌘ with the wheel is the surface's**, and is what a\ntrackpad's pinch arrives as.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGestureTouch",
+              "privacy": "private",
+              "readonly": true,
+              "description": "One finger moving over the surface, which scrolls the page, and is said.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTake",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press on the surface itself, which hands a waiting surface the gestures.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackKey",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Escape, which gives the page its scroll back.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.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": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleGiveBackBlur",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The window losing focus, as a reader switching away does.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handlePointerLeave",
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The pointer leaving the frame, which the family binds on its region.\n**Heard on the frame and not the drawing**, which a pointer resting on\nsomething raised over it has left. **A mouse or a pen and never a\nfinger**, whose `pointerleave` is the finger lifting: a tap took the\nsurface and gave it back in one.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderGestures",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The hint over the surface and the line while it is in use, which the\nfamily draws inside its viewport, over what was slotted. The parts are\nwritten out, as the controls' are, so the manifest sees them.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "panEvent",
@@ -86053,20 +87215,6 @@
                 "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",
@@ -86123,19 +87271,6 @@
                 "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",
@@ -86388,48 +87523,6 @@
                 "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",
@@ -86913,167 +88006,6 @@
                 "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",
@@ -87630,6 +88562,18 @@
               "description": "The background of the pan and zoom buttons. Leave unset for solid. `glass`\nshows the map through a blur, `frosted` blurs more, and `transparent` has\nno background. Your theme sets how see-through each one is.",
               "fieldName": "material"
             },
+            {
+              "name": "activate-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when a surface waiting to be pressed is scrolled or\nswiped over, with `gestures=\"activate\"`. Absent is the family's own.",
+              "fieldName": "activateHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "controls",
               "type": {
@@ -87679,6 +88623,18 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
+              },
+              "description": "Which gestures the surface takes from the page.\n\n- `always`: the surface takes the wheel and one finger, for a surface\n  that is the page, such as a full-screen view. A map rests here.\n- Unset is the family's own: `always` for a map, and for a board, a\n  drag and a pinch, with the plain wheel left to the page until the\n  board fills the screen.\n- `cooperative`: the wheel and one finger scroll the page, and the\n  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame\n  says so when a gesture passes to the page. Best for a surface embedded\n  in a page.\n- `activate`: the surface 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.\n\n**Unreflected and without a default**, because a default that reflected\nwould write an attribute onto every host that no server sent, and the\nhydration that followed would disagree with it.",
+              "fieldName": "gestures",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "idle-delay",
               "type": {
@@ -87757,6 +88713,42 @@
                 "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
+            {
+              "name": "two-finger-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when one finger swipes over a surface with\n`gestures=\"cooperative\"`. Absent is the family's own.",
+              "fieldName": "twoFingerHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "using-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The line shown while a surface with `gestures=\"activate\"` has the\ngestures. Absent is the family's own.",
+              "fieldName": "usingLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "wheel-hint-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The hint shown when the wheel scrolls past a surface with\n`gestures=\"cooperative\"`, with `{key}`, which is ⌘ on a Mac and Ctrl\nelsewhere. Absent is the family's own.",
+              "fieldName": "wheelHintLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
             {
               "name": "zoom-in-label",
               "type": {
@@ -87783,19 +88775,6 @@
                 "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": {
@@ -87848,18 +88827,6 @@
                 "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": {
@@ -88093,45 +89060,6 @@
                 "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": {
@@ -88673,6 +89601,14 @@
                 "module": "src/map/root/map-root.ts"
               }
             },
+            {
+              "description": "The page keeps the plain wheel and one finger, with `gestures=\"cooperative\"` or while a map with `gestures=\"activate\"` waits to be pressed.",
+              "name": "sharing",
+              "inheritedFrom": {
+                "name": "HelixHeadlessMap",
+                "module": "src/map/root/map-root.ts"
+              }
+            },
             {
               "description": "A map with `gestures=\"activate\"` has been pressed and has the gestures.",
               "name": "using",