@fusion.dev/helix 0.116.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",
@@ -61523,22 +61932,22 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/grid/index.ts",
+      "path": "src/graph/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "*",
+          "name": "HelixGraph",
           "declaration": {
-            "name": "*",
-            "module": "src/grid/root/grid-root.js"
+            "name": "HelixGraph",
+            "module": "./root/graph-root.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/grid/root/grid-root.css.ts",
+      "path": "src/graph/root/graph-root.css.ts",
       "declarations": [
         {
           "kind": "variable",
@@ -61551,328 +61960,2994 @@
           "name": "styles",
           "declaration": {
             "name": "styles",
-            "module": "src/grid/root/grid-root.css.ts"
+            "module": "src/graph/root/graph-root.css.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/grid/root/grid-root.ts",
+      "path": "src/graph/root/graph-root.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Set columns in one of two ways:\n\n- `columns` sets a fixed count.\n- `min` fits as many equal columns as there is room for at that width, so the\n  layout responds with no breakpoints to maintain.\n\nIf you set both, `min` wins. The grid is presentation only, so there is no\nheadless tier.",
-          "name": "HelixGrid",
+          "description": "The styled frame: the drawing with its zoom and fullscreen buttons, and the\nlist of notes beside it, which moves below the drawing where the frame is\nnarrower than 40rem. The selected note leads the list on a surface of its\nown, and the notes linked to it are named by how they link.",
+          "name": "HelixGraph",
           "cssProperties": [
             {
-              "description": "An explicit track list. It overrides `min` and `columns`. Use it for tracks of unequal widths, which neither attribute can set.",
-              "name": "--grid-columns"
-            }
-          ],
-          "slots": [
+              "description": "The color behind the drawing while it loads.",
+              "name": "--graph-background-color"
+            },
             {
-              "description": "The items to lay out.",
-              "name": ""
+              "description": "The frame's height, as a length.",
+              "name": "--graph-block-size"
+            },
+            {
+              "description": "The frame's border color.",
+              "name": "--graph-border-color"
+            },
+            {
+              "description": "The list's width beside the drawing.",
+              "name": "--graph-panel-size"
+            },
+            {
+              "description": "The background of the zoom and fullscreen buttons. Map and Canvas use the same property.",
+              "name": "--viewport-control-background-color"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "alignItems",
+              "name": "activateHintLabel",
               "type": {
-                "text": "'start' | 'center' | 'end' | 'stretch' | undefined"
+                "text": "string | undefined"
               },
-              "description": "How each cell aligns within its row. Sets `align-items`.\n\n**Named for the CSS property it sets**, the way `Flex` is, and the same\nproperty on a grid: it places every cell in its row's track rather than\nplacing the tracks. No `baseline`, which `Flex` offers, because cells in a\nrow of a grid are boxes of unrelated content and lining their first lines\nup is a thing a reader asks for between siblings in a row, not between\ncells in a table of them.\n\nThere is no `justifyContent` here for the same reason: the tracks are\n`1fr`, so they already fill the row and there is nothing left over to\ndistribute. `columns`, `min` and `--grid-columns` are how a grid says how\nwide its tracks are.",
-              "attribute": "align-items",
-              "reflects": true
+              "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": "columns",
+              "name": "controls",
               "type": {
-                "text": "number | undefined"
+                "text": "string | undefined"
               },
-              "description": "A fixed number of equal columns.",
-              "attribute": "columns",
-              "reflects": true
+              "description": "Which controls to show, as a list such as `pan zoom fullscreen`, or\n`none`. A family can add words of its own.\n\n**A list rather than a switch, because the overlap is not symmetric.** A\nsurface a consumer brings often has zoom controls of its own and almost\nnever has pan buttons, so a single switch would make them choose between\na duplicate and nothing.\n\n`none` draws none of them, which is the right answer where what was\nslotted already has controls a reader can find: what this argues for is\nthat *a* findable control exists, never that it is ours. The methods stay\npublic either way, so a consumer drawing their own chrome can still drive\nthe surface.\n\nAbsent is whatever the family rests at, which is this library's rule that\na resting value is an attribute's absence: zoom, the compass and\nfullscreen for a map, whose pan buttons a page asks for, and zoom and\nfullscreen for a board, which a reader drags and whose pad took a third\nof the frame. The\nstylesheet lays the cluster out by which buttons are in it rather than by\nthis attribute, so the two defaults need no rule each.",
+              "attribute": "controls",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
             },
             {
               "kind": "field",
-              "name": "gap",
+              "name": "controlsLabel",
               "type": {
-                "text": "'none' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | undefined"
+                "text": "string | undefined"
               },
-              "description": "The space between cells, as a step on the space scale.",
-              "attribute": "gap",
-              "reflects": true
+              "description": "The name of the group of controls, read by screen readers.\n\nAbsent is the family's own name for it, \"Map controls\" or \"Board\ncontrols\", which names what the controls drive rather than the\nmechanism. Written here to say it in another language, which every other\nstring this surface speaks already allowed and this one did not.",
+              "attribute": "controls-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
             },
             {
               "kind": "field",
-              "name": "min",
+              "name": "controlsPlacement",
+              "type": {
+                "text": "'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | undefined"
+              },
+              "description": "Which corner the controls sit in.\n\n**Configurable because there is no safe default**, which is a collision\nrather than a taste: whatever a consumer slots may put its own controls\nin any corner, and every library that draws some made this a setting for\nthe same reason.\n\nLogical corners rather than left and right, so a right-to-left page moves\nthem without a consumer writing a second rule. Absent is the top end, a\nresting value being an attribute's absence: a default that reflected\nwould write an attribute onto every host that no server sent.",
+              "attribute": "controls-placement",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fullscreenLabel",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "The minimum column width. The grid fits as many columns as the width allows.\n\nTakes precedence over `columns`: a grid that both fixes a count and reflows\nis two intentions in one element.",
-              "attribute": "min"
+              "default": "'Fill the screen'",
+              "description": "The fullscreen button's label.",
+              "attribute": "fullscreen-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
             },
             {
-              "kind": "method",
-              "name": "applyTemplate",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "gestures",
+              "type": {
+                "text": "'activate' | 'always' | 'cooperative' | undefined"
               },
-              "description": "Writes the track list into the shadow root's own stylesheet.\n\nInto a `<style>` rather than onto `this.style`, and the difference is\nhydration. An inline style on the host is an attribute the element gives\nitself once it upgrades, so a React consumer's server markup does not have\nit and hydration reports a mismatch it will not patch up. The shadow root\nis not part of the tree React hydrates, so a rule written there is free.\n\nThe element is filled imperatively because Lit refuses expressions inside\n`<style>`: it is an invalid binding location and throws while rendering\nrather than at build time. Hence a static, empty element in the template\nand its `textContent` set here.\n\nIt sets a custom property rather than the track list itself. A shadow\nroot's adopted stylesheets cascade *after* its own `<style>` elements, and\n`static styles` is adopted, so a `grid-template-columns` here lost to the\none in the stylesheet and every `min` grid came out a single column. The\nstylesheet only ever reads `--_grid-template`, so there is nothing to\nlose against.\n\nThe consequence is that a server-rendered grid falls back to the\nstylesheet's single column until it upgrades. That is why `columns` is also\nexpressed as plain CSS below: the fixed-count case, which can be enumerated,\nneeds no JavaScript at all, and only `min` depends on this."
+              "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": "tier",
+              "name": "idleDelay",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.\n\nZero keeps it up, which is the default: these controls are how a keyboard\nreader operates the surface, and chrome that hid itself by default would\nbe the component undoing its own argument. Set it for a display nobody\ndrives.",
+              "attribute": "idle-delay",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "panDownLabel",
               "type": {
                 "text": "string"
               },
-              "static": true,
-              "default": "'helix-headless-'",
-              "description": "The prefix this tier registers its elements under.\n\n**A component that renders another renders its own tier's version of it**,\nso `helix-headless-pagination-size` composes `helix-headless-select` and\n`helix-pagination-size` composes `helix-select`. One template says\n`${this.tag('select')}` and each tier answers with its own name.\n\n**The public tag may not be the composed one, in either tier.** Using it\ncosts three things: the name means two different things depending on what a\nconsumer imported, the headless tier composes an element it does not ship,\nand the composition cannot be tested there at all, because there is no\n`helix-select` on that tier to test it against.\n\n**A prefix rather than an override per composition**, which was the first\nplan and does not compile. An override re-renders the fragment from the\nsubclass, and the fragment reads members the base keeps private:\n`PaginationSize` alone would have had to widen `options`, `current` and\n`handleChange` to `protected` so a subclass could say the same thing again.\nSixteen families of that is a lot of encapsulation spent on saying one\nword differently.",
+              "default": "'Pan down'",
+              "description": "The pan down button's label.\n\n**A label for each way rather than one with the way filled in**, which is\nwhat this was: `Pan {way}` filled in with `left`, so a page that said it\nin French read out \"Déplacer left\". The word for a direction is as much\nthe translator's as the word for panning, and a language can put it\nanywhere in the phrase.",
+              "attribute": "pan-down-label",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "tag",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "StaticValue"
-                }
+              "kind": "field",
+              "name": "panLeftLabel",
+              "type": {
+                "text": "string"
               },
-              "parameters": [
-                {
-                  "name": "name",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "One composed tag, as a static value a template can interpolate.\n\n`unsafeStatic` is safe by construction: the name is a literal in our own\nsource and the prefix is one of two strings this class defines. Called per\nrender and not cached, which costs nothing, because `static-html` keys its\ntemplate cache on the joined string rather than on the object.",
+              "default": "'Pan left'",
+              "description": "The pan left button's label.",
+              "attribute": "pan-left-label",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "partNamed",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "T | null"
-                }
+              "kind": "field",
+              "name": "panRightLabel",
+              "type": {
+                "text": "string"
               },
-              "parameters": [
-                {
-                  "name": "name",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "One of this element's own parts, by name, or null where it is not rendered.\n\nNot `part`, which every element already has: `Element.part` is the\n`DOMTokenList` of the names the element itself carries, and a method under\nthat name is a type error on every subclass.\n\n**One guard for every lookup.** Lit's server shim has no `querySelector`\non the render root, so a lookup reached during a server render, from a\ngetter a template reads or from `willUpdate`, throws there and nowhere\nelse. Four spellings of the same guard had grown across the library, and\na fifth site with none. Null on the server, which is what the rest of the\ncode already treats a part that has not rendered as.\n\n**`~=` and not `=`.** A part drawn in a state carries a second name while\nthe state holds, `part=\"page page-current\"`, and an exact match stops\nfinding it for exactly as long as it is the one that matters.\n\n`helix component`'s `selectors` reads these calls the way it reads a\n`querySelector('[part=\"x\"]')`, so a name nothing renders is a finding\nrather than a null an optional chain swallows.",
+              "default": "'Pan right'",
+              "description": "The pan right button's label.",
+              "attribute": "pan-right-label",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "internals",
+              "name": "panStep",
               "type": {
-                "text": "ElementInternals"
+                "text": "number"
               },
-              "privacy": "protected",
-              "readonly": true,
-              "description": "The element's semantics, set without touching the DOM.\n\n`ElementInternals` sets the implicit role, which an author's own `role`\nattribute still overrides, and it writes no attribute. Setting `role` on the\nhost directly would: that is an attribute the element gives itself after it\nupgrades, which a React consumer's server markup never had, and hydration\nreports it as a mismatch.\n\nAvailable during server rendering. Lit's shim implements `attachInternals`,\nso nothing here needs a guard.",
+              "default": "0.25",
+              "description": "How far one press pans the view, as a fraction of its size.\n\nA fraction rather than a distance, because this surface does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture\nat any zoom, and a consumer who wants their own units multiplies by them.",
+              "attribute": "pan-step",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "toggleState",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "panUpLabel",
+              "type": {
+                "text": "string"
               },
-              "parameters": [
-                {
-                  "name": "name",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "on",
-                  "type": {
-                    "text": "boolean"
-                  }
-                }
-              ],
-              "description": "Records a boolean fact about this element as a custom state.\n\n**The host belongs to whoever rendered it, and a component's own\nbookkeeping may not be kept there.** An attribute written on the first\nupdate is markup a consumer's server never sent, so a React consumer\nhydrates a DOM that has gained attributes since and reports a mismatch it\nwill not patch up. A custom state is not in the DOM at all: it carries the\nfact to a stylesheet through `:state()` and leaves the markup alone, so the\nserver's output and the client's agree by construction.\n\n`SETTLED` carries the long version of that argument; `checked`, `open`,\n`invalid` and `has-label` are recorded the same way, each of them a state a\n`default-*` attribute resolves before React reaches the node.\n\n**Deferring the definitions is not a fix and could not be.** Importing them\nfrom an effect so the upgrades fall the other side of hydration works only\nwhile hydration is one pass: anything that splits it, a streamed segment or\na suspended boundary, puts an upgrade back inside the window. Timing cannot\nbe the guarantee when the fact is kept somewhere React reconciles.\n\nFeature-tested rather than assumed, the way `hostAria` tests element\nreferences. An engine without `CustomStateSet` records nothing and keeps\nwhatever the resting rule draws, which is the safe direction to fail.\n\n**The engines the test is for are browsers**: Safari below 17.4 and Firefox\nbelow 126, where the write is a `TypeError`, so a component bypassing this\nfails to render rather than rendering without whatever the state draws.\nLit's server shim sets `states`, so the guard passes there and records a\nstate nothing reads, which is harmless.",
+              "default": "'Pan up'",
+              "description": "The pan up button's label.",
+              "attribute": "pan-up-label",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "whenSettled",
+              "name": "twoFingerHintLabel",
               "type": {
-                "text": "Promise<void>"
+                "text": "string | undefined"
               },
-              "readonly": true,
-              "description": "Resolves a frame after the first update, when transitions are switched on.\n\n**Named `whenSettled` because `settled` is taken four times over**, by\nImage, Splitter and both color controls, none of them about transitions. A\nbase class takes the name every subclass then cannot use.\n\n**The state it reports cannot be watched, which is why this exists.** A\ncustom state is deliberately not in the DOM, so there is no\n`MutationObserver` equivalent for `ElementInternals.states`. Await this\ninstead.\n\nSeparate from `updateComplete`, which resolves in the microtask checkpoint\nthe suppression is still active in. That is the distinction `readyToMove`\nin `@fusion.dev/helix-testing` is written around.\n\nIt never resolves where `requestAnimationFrame` never fires, which is a\nserver, a hidden tab, and happy-dom. Callers that must not hang there race\nit against a timeout, as the happy-dom harness's `readyToMove` does. The\nbrowser harness's awaits it alone: a browser always runs the frame, and a\ntimer beside it was a bet on how long one takes, which a busy run lost.",
-              "default": "new Promise<void>((resolve) => { this.resolveSettled = resolve })",
+              "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": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "resolveSettled",
+              "name": "usingLabel",
               "type": {
-                "text": "() => void"
+                "text": "string | undefined"
               },
-              "privacy": "private",
-              "description": "Resolves `whenSettled`, once, from the frame that records the state.",
+              "description": "The line shown while a surface with `gestures=\"activate\"` has the\ngestures. Absent is the family's own.",
+              "attribute": "using-label",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "fromServer",
+              "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",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Zoom in'",
+              "description": "The zoom in button's label.",
+              "attribute": "zoom-in-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resting",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
+              "privacy": "protected",
               "default": "false",
-              "description": "Whether the shadow root was a server's, parsed from declarative shadow DOM.",
+              "description": "Whether the reader has been still long enough to hide the chrome.",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "hydrating",
+              "name": "filled",
               "type": {
                 "text": "boolean"
               },
               "privacy": "protected",
-              "description": "Whether this update is hydrating a server's markup, and so has to render\nexactly what the server rendered.\n\n**Lit hydrates by assuming the markup already shows the first render.** A\nvalue that differs is recorded and never written, so the page keeps the\nserver's, and a template that differs throws. The server has no children,\nso anything a component reads from its children waits for the update after\nhydration, which `finishHydration` asks for. Without a server's markup the\nfirst render reads them and there is one render.",
-              "readonly": true,
+              "default": "false",
+              "description": "Whether the surface is filling the screen.",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "serverRendered",
+              "name": "gesturesTaken",
               "type": {
                 "text": "boolean"
               },
               "privacy": "protected",
-              "description": "Whether this element hydrated a server's markup rather than rendering its own.\n\nFor what happened before hydration and cannot be heard after it: an image\nthe parser fetched fires `load` or `error` before any listener exists, so a\ncomponent asks the image instead, once, when this is true.",
-              "readonly": true,
+              "default": "false",
+              "description": "Whether an `activate` surface has been pressed, and has the gestures.",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "finishHydration",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "hint",
+              "type": {
+                "text": "string"
               },
-              "description": "Asks for the update a hydration put off, so the reads it skipped happen.\n\nCalled from `firstUpdated`, the end of the hydrating update. The render it\nschedules can only follow that one, which is the exception Lit's\nchange-in-update warning names, and it happens only on a page a server\nrendered.",
+              "privacy": "private",
+              "default": "''",
+              "description": "The hint over the surface while one shows, put there by a gesture it let pass.",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "childrenKnown",
+              "name": "hinting",
               "type": {
-                "text": "boolean"
+                "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",
               "privacy": "protected",
-              "description": "Whether this render can know the children.\n\nA server cannot: its element shim carries attributes and no tree, so\n`children` is undefined there. A render hydrating what a server sent must\nnot, because it has to be the server's render. Anywhere else it can. A\ncomponent whose render depends on its children reads them through\n`knownChildren`, and treats \"not known\" as its own answer rather than as\n\"none\": a list that renders its empty state because nobody has looked yet is\nthe one thing an empty state must never do.",
               "readonly": true,
+              "default": "new FullscreenController(this, (full) => { this.filled = full })",
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "knownChildren",
+              "name": "idle",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new IdleController( this, () => this.idleDelay, (resting) => { this.resting = resting }, )",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "zoomOutLabel",
               "type": {
-                "text": "Element[]"
+                "text": "string"
+              },
+              "default": "'Zoom out'",
+              "description": "The zoom out button's label.",
+              "attribute": "zoom-out-label",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "restingControlsLabel",
+              "type": {
+                "text": "string"
               },
               "privacy": "protected",
-              "description": "The children a render may read: all of them where they are known, and none otherwise.",
+              "description": "What the group of controls is called where the page does not say.\n\nA getter a family overrides rather than a default on the property, the\nway `restingControls` is: a default would reflect nothing and still be\none value for every family composing this.",
               "readonly": true,
               "inheritedFrom": {
-                "name": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "field",
-              "name": "assignsByName",
+              "name": "restingGestureLabels",
               "type": {
-                "text": "boolean"
+                "text": "ViewportGestureLabels"
               },
               "privacy": "protected",
-              "description": "Whether this element's slots route by name although it asked to assign them\nby hand.\n\n**A declarative shadow root is always the by-name kind.** HTML has no way to\nask for manual assignment, so a component that assigns by hand and hydrates\na server's root gets one where `slot.assign()` does nothing, and its\nchildren land wherever their `slot` attribute sends them. The way through is\nto write that attribute, which is what `route` does. Only there: on a root\nthis element made, assignment stays manual and the consumer's markup is\nnever touched, which is what a React consumer's hydration requires.",
+              "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": "HelixElement",
-                "module": "src/helix-element/helix-element.ts"
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
               }
             },
             {
               "kind": "method",
-              "name": "route",
+              "name": "gestureAllowed",
               "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
               "parameters": [
                 {
-                  "name": "child",
+                  "name": "event",
                   "type": {
-                    "text": "Element"
+                    "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",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Event"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "_detail",
+                  "type": {
+                    "text": "ViewportPanDetail"
+                  }
+                }
+              ],
+              "description": "The pan event, which the family names and this one does not.\n\n**No default, and the analyzer is why as much as the taste is.** A mixin\nthat built a `helix-map-pan` would put it in the manifest of every family\nthat composed the surface, since a mixin's code is resolved into its\nusers: a canvas would be documented as dispatching a map's event, and a\nconsumer reading the reference page would believe it. So the surface\ncarries no event name at all, and a family that forgets to name one hears\nabout it the first time a reader presses an arrow.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "zoomEvent",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Event"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "_detail",
+                  "type": {
+                    "text": "ViewportZoomDetail"
+                  }
+                }
+              ],
+              "description": "The zoom event, which the family names, for the same reason.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "pan",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "to",
+                  "type": {
+                    "text": "ViewportWay"
+                  }
+                }
+              ],
+              "description": "Pans the view one step in a direction.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              },
+              "type": {
+                "text": "pan(to: ViewportWay) => void"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "zoom",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "by",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Zooms the view one step: `1` zooms in and `-1` zooms out.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              },
+              "type": {
+                "text": "zoom(by: number) => void"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toggleFullscreen",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Turns fullscreen on or off.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              },
+              "type": {
+                "text": "toggleFullscreen() => void"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "restingControls",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "description": "Which controls the surface draws while `controls` is absent.\n\nAll three here, and a family overrides it where its reader has a better\nway to do one of them already.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "drawsControls",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "group",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Whether `controls`, or the resting controls, names a group.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderMoreControls",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "description": "More buttons for the group of controls, after zoom. None here; a family adds its own.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleMoreKeys",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "_event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Answers a key the family adds, and says whether it did. None here.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "sideOf",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "way",
+                  "type": {
+                    "text": "ViewportWay"
+                  }
+                }
+              ],
+              "description": "The side of the screen a reading-order way is on, left or right.\n\n**Start is left only where the text runs that way.** The pad's grid is\nlaid out in reading order, so on a right-to-left page the start button\nsits on the right, and it said \"left\" and pointed left from there.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "rightToLeft",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the page runs right to left, as far as this render may say.\n\n**Not while hydrating.** A server cannot measure direction, so it drew\nthe left-to-right pad; Lit hydrates by keeping what the server drew and\nrecording the client's value unwritten, so a right-to-left answer in the\nhydrating render would never reach the page. It answers once hydration\nis over, and `firstUpdated` asks for that render.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "panLabel",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "way",
+                  "type": {
+                    "text": "ViewportWay"
+                  }
+                }
+              ],
+              "description": "What one pan control is called, with the way it goes filled in.\n\nLeft and right rather than start and end, because the label is read aloud\nand a reader knows which way left is. The event keeps the reading-order\nname, which is the one a right-to-left page needs.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "panGlyph",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "way",
+                  "type": {
+                    "text": "ViewportWay"
+                  }
+                }
+              ],
+              "description": "The arrow drawn on a pan control, pointing the way it goes on screen.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleKeydown",
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The arrow keys, which are the second way rather than the only one.\n\n`inlineStep` rather than a test against `ArrowLeft`, so the reader on a\nright-to-left page moves the way their text runs, which is what the pan\ncontrols say too.\n\n**Only from the surface's own frame, and that is the difference between\none move and two.** What a consumer slots may answer the arrow keys\nitself, and a press relayed from inside it moves their view once on its\nown and once more on the event this would send. The rule is the region\nand the controls rather than the whole shadow root, because a family with\nits own focusable content in there, a list of notes beside a canvas,\nwould otherwise pan the surface out from under a reader arrowing through\nit.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "controlsElement",
+              "type": {
+                "text": "Element | null"
+              },
+              "privacy": "protected",
+              "description": "The group of controls as drawn, or nothing where none are.\n\n**Here, because this is what renders it.** A family that measures the\ncluster, as a board does to keep its fit clear of the buttons, would\notherwise look up a part its own template never writes, and a lookup\nlike that is one a later edit to this template breaks without a word.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderControls",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "description": "The controls, or nothing where a consumer kept none of them.\n\n**Written out rather than generated**, because a part name behind an\ninterpolation is a part the manifest cannot see: a loop would publish\n`pan-` and a consumer's `::part(pan-up)` would match nothing.",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "active",
+              "type": {
+                "text": "string"
+              },
+              "description": "The `value` of the current item.\n\nNot `option.active`, which is the option the keyboard is on: that is a\ndifferent question from which one is chosen.\n\nWriting always applies, so `<helix-tabs active=\"one\">` starts on that\ntab, and `default-active` is how markup says where to start without\nnaming the current one.",
+              "attribute": "active",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "defaultActive",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The `value` of the item declared current in markup.\n\nIgnored once `active` is written.",
+              "attribute": "default-active",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "activeState",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "The state, whoever set it, and `undefined` until somebody has.\n\nOne field and not two. Writing always applies, the way a native control\ndoes when a script assigns to it.",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "requestActive",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Requests a new current item, and returns whether the change was applied.\n\nAnnounces before it acts, so `preventDefault()` on the `helix-before-activate` is\na refusal and nothing moves. Unlike a native control, nothing has moved\nby the time this runs, so refusing is simply not writing: there is\nnothing to put back. Nobody refusing means the set updates itself,\nwhether or not a consumer declared `active`, a declared property being a\nseed and a correction.",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              },
+              "type": {
+                "text": "requestActive(next: string) => boolean"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "announceActivated",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Says the current child moved, once it has.\n\n`helix-activate` rather than a native word: nothing on the platform means\n\"a set chose a different member\", and borrowing `change` would be a lie\nabout what moved.\n\nA consumer who only wants to know which child is current cannot use\n`helix-before-activate` for it, that one firing *before* `apply`, so\n`currentTarget.active` is the previous value inside the handler and\n`detail.value` is a proposal another listener may refuse. `helix-select`\nis no substitute either: it fires when an item is *chosen* and not when\n`active` is assigned.\n\n**After `apply`, which is the whole reason it is a second event**, so the\nstate is on the element by the time a handler reads it. Not cancelable:\nthe decision was taken by the event before this one, and two refusable\nevents for one transition are two answers to one question.",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "resolveActive",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Item | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "items",
+                  "type": {
+                    "text": "Item[]"
+                  }
+                }
+              ],
+              "description": "Which item is current, given what there is to choose from.\n\nThe first enabled one when `active` names nothing, which is a set before\nits consumer has chosen and a set whose current item has just been\nremoved. Disabled items are skipped in the fallback but not in the match:\na consumer who names a disabled item meant it, and quietly moving to\nanother would be the component overruling them.",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "countLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{count} notes'",
+              "description": "What the list says of a note's count, with `{count}`.",
+              "attribute": "count-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "depth",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "How many links from the selected note to show, for its local graph. Unset\nshows every note. The list holds what the drawing shows.",
+              "attribute": "depth",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The graph's name, read by screen readers, such as \"Research notes\".\nRequired.",
+              "attribute": "label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "linkedBothLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Linked both ways with {note}'",
+              "description": "How a note linked both to and from the selected one is described, with `{note}`.",
+              "attribute": "linked-both-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "linkedFromLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Linked from {note}'",
+              "description": "How a note the selected one links to is described, with `{note}`, the selected note's name.",
+              "attribute": "linked-from-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "links",
+              "type": {
+                "text": "readonly GraphLink[]"
+              },
+              "default": "[]",
+              "description": "The links between notes, each from `source` to `target`. A property, never an attribute.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "linksToLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Links to {note}'",
+              "description": "How a note that links to the selected one is described, with `{note}`.",
+              "attribute": "links-to-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "nodes",
+              "type": {
+                "text": "readonly GraphNode[]"
+              },
+              "default": "[]",
+              "description": "The notes. A property, never an attribute.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "notesLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Notes'",
+              "description": "The list's name, read by screen readers.",
+              "attribute": "notes-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "searchLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Find a note'",
+              "description": "The search field's name.",
+              "attribute": "search-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "selectedLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Selected'",
+              "description": "How the selected note is described in the list.",
+              "attribute": "selected-label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "query",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''",
+              "description": "What the search field holds.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "cursor",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "The row the keyboard is on, as an index into the list.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "adjacency",
+              "type": {
+                "text": "Adjacency"
+              },
+              "privacy": "private",
+              "default": "new Map()",
+              "description": "Which notes link to and from each, read again when `links` changes.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "sorted",
+              "type": {
+                "text": "GraphNode[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "The notes in the order of their names, read again when `nodes` changes.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "entries",
+              "type": {
+                "text": "Entry[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "The list's rows, read again when anything they come from changes.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "kept",
+              "type": {
+                "text": "Set<string> | undefined"
+              },
+              "privacy": "private",
+              "description": "The notes the local graph keeps, or every note where there is no `depth`.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "whole",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the graph has been drawn whole, which `drawn()` says.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "said",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''",
+              "description": "How many notes there were when the count was last said.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "virtualize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new VirtualizeController(this, { container: () => this.partNamed('list'), count: () => this.entries.length, estimate: () => 32, rows: () => [...(this.renderRoot.querySelectorAll?.('[data-index]') ?? [])].map((element) => ({ element: element as HTMLElement, index: Number((element as HTMLElement).dataset.index), })), })",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "ready",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the graph has been drawn whole. For code that runs after `helix-graph-ready`.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "drawn",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "whole",
+                  "default": "true"
+                }
+              ],
+              "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"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "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",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "How many notes the list holds, in the page's numbers.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "relationText",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "Entry"
+                  }
+                }
+              ],
+              "description": "How a row stands to the selected note, in words, or nothing where it does not.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "choose",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Selects the note a row names, through the request a page can refuse.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "moveTo",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Moves the keyboard to a row, and the list to show it.\n\n**Scrolled by the row's own box where it is drawn, and by the estimate\nwhere it is not**, so a jump to the end of ten thousand notes lands there\nand the row is drawn by the update the scroll asks for.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleListKeydown",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The keys in the list. **Kept from the frame**, whose arrows pan the\ndrawing: a reader moving through the list was moving the graph under it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleSearchKeydown",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The search field's keys, which belong to the field and never pan the\ngraph. Escape empties a search that has words in it, and passes through\nan empty one to whatever the page does with it.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleSearch",
+              "privacy": "private",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderFilterIcon",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The mark in the search field, behind a seam: a slot for the page, and a\nmethod for the tier above, as the listbox's filter has.",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderRows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult[]"
+                }
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tier",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "default": "'helix-headless-'",
+              "description": "The prefix this tier registers its elements under.\n\n**A component that renders another renders its own tier's version of it**,\nso `helix-headless-pagination-size` composes `helix-headless-select` and\n`helix-pagination-size` composes `helix-select`. One template says\n`${this.tag('select')}` and each tier answers with its own name.\n\n**The public tag may not be the composed one, in either tier.** Using it\ncosts three things: the name means two different things depending on what a\nconsumer imported, the headless tier composes an element it does not ship,\nand the composition cannot be tested there at all, because there is no\n`helix-select` on that tier to test it against.\n\n**A prefix rather than an override per composition**, which was the first\nplan and does not compile. An override re-renders the fragment from the\nsubclass, and the fragment reads members the base keeps private:\n`PaginationSize` alone would have had to widen `options`, `current` and\n`handleChange` to `protected` so a subclass could say the same thing again.\nSixteen families of that is a lot of encapsulation spent on saying one\nword differently.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "tag",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "StaticValue"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "One composed tag, as a static value a template can interpolate.\n\n`unsafeStatic` is safe by construction: the name is a literal in our own\nsource and the prefix is one of two strings this class defines. Called per\nrender and not cached, which costs nothing, because `static-html` keys its\ntemplate cache on the joined string rather than on the object.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "partNamed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "T | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "One of this element's own parts, by name, or null where it is not rendered.\n\nNot `part`, which every element already has: `Element.part` is the\n`DOMTokenList` of the names the element itself carries, and a method under\nthat name is a type error on every subclass.\n\n**One guard for every lookup.** Lit's server shim has no `querySelector`\non the render root, so a lookup reached during a server render, from a\ngetter a template reads or from `willUpdate`, throws there and nowhere\nelse. Four spellings of the same guard had grown across the library, and\na fifth site with none. Null on the server, which is what the rest of the\ncode already treats a part that has not rendered as.\n\n**`~=` and not `=`.** A part drawn in a state carries a second name while\nthe state holds, `part=\"page page-current\"`, and an exact match stops\nfinding it for exactly as long as it is the one that matters.\n\n`helix component`'s `selectors` reads these calls the way it reads a\n`querySelector('[part=\"x\"]')`, so a name nothing renders is a finding\nrather than a null an optional chain swallows.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The element's semantics, set without touching the DOM.\n\n`ElementInternals` sets the implicit role, which an author's own `role`\nattribute still overrides, and it writes no attribute. Setting `role` on the\nhost directly would: that is an attribute the element gives itself after it\nupgrades, which a React consumer's server markup never had, and hydration\nreports it as a mismatch.\n\nAvailable during server rendering. Lit's shim implements `attachInternals`,\nso nothing here needs a guard.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toggleState",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "on",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Records a boolean fact about this element as a custom state.\n\n**The host belongs to whoever rendered it, and a component's own\nbookkeeping may not be kept there.** An attribute written on the first\nupdate is markup a consumer's server never sent, so a React consumer\nhydrates a DOM that has gained attributes since and reports a mismatch it\nwill not patch up. A custom state is not in the DOM at all: it carries the\nfact to a stylesheet through `:state()` and leaves the markup alone, so the\nserver's output and the client's agree by construction.\n\n`SETTLED` carries the long version of that argument; `checked`, `open`,\n`invalid` and `has-label` are recorded the same way, each of them a state a\n`default-*` attribute resolves before React reaches the node.\n\n**Deferring the definitions is not a fix and could not be.** Importing them\nfrom an effect so the upgrades fall the other side of hydration works only\nwhile hydration is one pass: anything that splits it, a streamed segment or\na suspended boundary, puts an upgrade back inside the window. Timing cannot\nbe the guarantee when the fact is kept somewhere React reconciles.\n\nFeature-tested rather than assumed, the way `hostAria` tests element\nreferences. An engine without `CustomStateSet` records nothing and keeps\nwhatever the resting rule draws, which is the safe direction to fail.\n\n**The engines the test is for are browsers**: Safari below 17.4 and Firefox\nbelow 126, where the write is a `TypeError`, so a component bypassing this\nfails to render rather than rendering without whatever the state draws.\nLit's server shim sets `states`, so the guard passes there and records a\nstate nothing reads, which is harmless.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "whenSettled",
+              "type": {
+                "text": "Promise<void>"
+              },
+              "readonly": true,
+              "description": "Resolves a frame after the first update, when transitions are switched on.\n\n**Named `whenSettled` because `settled` is taken four times over**, by\nImage, Splitter and both color controls, none of them about transitions. A\nbase class takes the name every subclass then cannot use.\n\n**The state it reports cannot be watched, which is why this exists.** A\ncustom state is deliberately not in the DOM, so there is no\n`MutationObserver` equivalent for `ElementInternals.states`. Await this\ninstead.\n\nSeparate from `updateComplete`, which resolves in the microtask checkpoint\nthe suppression is still active in. That is the distinction `readyToMove`\nin `@fusion.dev/helix-testing` is written around.\n\nIt never resolves where `requestAnimationFrame` never fires, which is a\nserver, a hidden tab, and happy-dom. Callers that must not hang there race\nit against a timeout, as the happy-dom harness's `readyToMove` does. The\nbrowser harness's awaits it alone: a browser always runs the frame, and a\ntimer beside it was a bet on how long one takes, which a busy run lost.",
+              "default": "new Promise<void>((resolve) => { this.resolveSettled = resolve })",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resolveSettled",
+              "type": {
+                "text": "() => void"
+              },
+              "privacy": "private",
+              "description": "Resolves `whenSettled`, once, from the frame that records the state.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fromServer",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the shadow root was a server's, parsed from declarative shadow DOM.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hydrating",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this update is hydrating a server's markup, and so has to render\nexactly what the server rendered.\n\n**Lit hydrates by assuming the markup already shows the first render.** A\nvalue that differs is recorded and never written, so the page keeps the\nserver's, and a template that differs throws. The server has no children,\nso anything a component reads from its children waits for the update after\nhydration, which `finishHydration` asks for. Without a server's markup the\nfirst render reads them and there is one render.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "serverRendered",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this element hydrated a server's markup rather than rendering its own.\n\nFor what happened before hydration and cannot be heard after it: an image\nthe parser fetched fires `load` or `error` before any listener exists, so a\ncomponent asks the image instead, once, when this is true.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finishHydration",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks for the update a hydration put off, so the reads it skipped happen.\n\nCalled from `firstUpdated`, the end of the hydrating update. The render it\nschedules can only follow that one, which is the exception Lit's\nchange-in-update warning names, and it happens only on a page a server\nrendered.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "childrenKnown",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this render can know the children.\n\nA server cannot: its element shim carries attributes and no tree, so\n`children` is undefined there. A render hydrating what a server sent must\nnot, because it has to be the server's render. Anywhere else it can. A\ncomponent whose render depends on its children reads them through\n`knownChildren`, and treats \"not known\" as its own answer rather than as\n\"none\": a list that renders its empty state because nobody has looked yet is\nthe one thing an empty state must never do.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "knownChildren",
+              "type": {
+                "text": "Element[]"
+              },
+              "privacy": "protected",
+              "description": "The children a render may read: all of them where they are known, and none otherwise.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "assignsByName",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this element's slots route by name although it asked to assign them\nby hand.\n\n**A declarative shadow root is always the by-name kind.** HTML has no way to\nask for manual assignment, so a component that assigns by hand and hydrates\na server's root gets one where `slot.assign()` does nothing, and its\nchildren land wherever their `slot` attribute sends them. The way through is\nto write that attribute, which is what `route` does. Only there: on a root\nthis element made, assignment stays manual and the consumer's markup is\nnever touched, which is what a React consumer's hydration requires.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "route",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "child",
+                  "type": {
+                    "text": "Element"
+                  }
+                },
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                }
+              ],
+              "description": "Sends a child to a slot by name, on a root that routes by name.\n\n`undefined` is the default slot. Written only when it differs, so routing\nthe same child again on every update writes nothing.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "stopInner",
+              "privacy": "protected",
+              "readonly": true,
+              "description": "Stops an inner control's own announcement at this element's boundary.\n\n**A composed control is one control to a consumer, and the natives had no\nequivalent of the stop the prefixed events already get.** `<helix-select>`\nrenders a `<helix-listbox>`, and both announce: the listbox dispatches\n`input` and `change` from its own host, `input` is composed by\nspecification, and a consumer listening on the select therefore heard one\nchoice twice. Measured before this existed, on the styled tier, one choice\non the inner listbox: select `input` twice and `change` three times,\ncombobox, date input, time input and color input twice each. `Command` was\nthe only one that was right, because it happened to reach for\n`stopImmediatePropagation` for a different reason.\n\nBound on the child in the parent's template, so it runs while the event is\nstill at the child and before it can cross. The guard is for the case where\na component binds this on itself: an element must never stop its own\nannouncement, which is the one it exists to make.\n\nThis is the same job the `helix-before-*` handlers do with their own\n`stopPropagation`, and it is separate rather than folded into them because\na consumer may legitimately refuse a request without the notification ever\nhappening: the two travel at different times and one can be absent.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "relayNativeEvent",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                },
+                {
+                  "name": "init",
+                  "optional": true,
+                  "type": {
+                    "text": "EventInit"
+                  }
+                }
+              ],
+              "description": "Re-emits a native event from the host, under its own name.\n\nA native event fired by an inner `<input>` or `<textarea>` is not composed,\nso it stops at the shadow boundary and a consumer listening on\n`<helix-input>` hears nothing. Re-dispatching it from the host is what\nmakes the component behave like the control it wraps.\n\nThe relayed event keeps the native name deliberately. `change` is `change`,\nwhich is what a consumer already knows to listen for, and it is what\nreaches React: its synthetic system claims `onChange` and wires it to that\nname, so a prefixed one would never arrive.\n\n`composed` is not forced. It defaults to the original event's own value, so\na relayed `change` stops at the next shadow boundary exactly as a native\none would. Pass it explicitly only where escaping is the intent, and say so\nwhere you do.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finalizeStyles",
+              "privacy": "protected",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "CSSResultOrNative[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "styles",
+                  "optional": true,
+                  "type": {
+                    "text": "CSSResultOrNative | CSSResultOrNative[]"
+                  }
+                }
+              ],
+              "description": "Prepends the shadow-root reset to every subclass's styles, so no component\nhas to remember to include it.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
+          "superclass": {
+            "name": "HelixHeadlessGraph",
+            "package": "@fusion.dev/helix-headless/graph"
+          },
+          "summary": "A frame around a graph of notes drawn by another library, and the list that makes it readable.",
+          "helix": {
+            "category": "media",
+            "since": "0.116.0",
+            "status": "experimental",
+            "documentation": "https://fusion.dev/helix/components/graph",
+            "aliases": [
+              "Knowledge graph",
+              "Network",
+              "Note graph",
+              "Second brain"
+            ],
+            "tier": "styled",
+            "group": "Graph",
+            "part": "Root",
+            "examples": [
+              {
+                "description": "A graph of linked notes, with the selected note's links and backlinks listed first.",
+                "slug": "preview"
+              }
+            ],
+            "source": "helix/styled/src/graph"
+          },
+          "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": {
+                "text": "string | undefined"
+              },
+              "description": "Which controls to show, as a list such as `pan zoom fullscreen`, or\n`none`. A family can add words of its own.\n\n**A list rather than a switch, because the overlap is not symmetric.** A\nsurface a consumer brings often has zoom controls of its own and almost\nnever has pan buttons, so a single switch would make them choose between\na duplicate and nothing.\n\n`none` draws none of them, which is the right answer where what was\nslotted already has controls a reader can find: what this argues for is\nthat *a* findable control exists, never that it is ours. The methods stay\npublic either way, so a consumer drawing their own chrome can still drive\nthe surface.\n\nAbsent is whatever the family rests at, which is this library's rule that\na resting value is an attribute's absence: zoom, the compass and\nfullscreen for a map, whose pan buttons a page asks for, and zoom and\nfullscreen for a board, which a reader drags and whose pad took a third\nof the frame. The\nstylesheet lays the cluster out by which buttons are in it rather than by\nthis attribute, so the two defaults need no rule each.",
+              "fieldName": "controls",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "controls-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The name of the group of controls, read by screen readers.\n\nAbsent is the family's own name for it, \"Map controls\" or \"Board\ncontrols\", which names what the controls drive rather than the\nmechanism. Written here to say it in another language, which every other\nstring this surface speaks already allowed and this one did not.",
+              "fieldName": "controlsLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "controls-placement",
+              "type": {
+                "text": "'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | undefined"
+              },
+              "description": "Which corner the controls sit in.\n\n**Configurable because there is no safe default**, which is a collision\nrather than a taste: whatever a consumer slots may put its own controls\nin any corner, and every library that draws some made this a setting for\nthe same reason.\n\nLogical corners rather than left and right, so a right-to-left page moves\nthem without a consumer writing a second rule. Absent is the top end, a\nresting value being an attribute's absence: a default that reflected\nwould write an attribute onto every host that no server sent.",
+              "fieldName": "controlsPlacement",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "fullscreen-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Fill the screen'",
+              "description": "The fullscreen button's label.",
+              "fieldName": "fullscreenLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "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": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.\n\nZero keeps it up, which is the default: these controls are how a keyboard\nreader operates the surface, and chrome that hid itself by default would\nbe the component undoing its own argument. Set it for a display nobody\ndrives.",
+              "fieldName": "idleDelay",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "pan-down-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pan down'",
+              "description": "The pan down button's label.\n\n**A label for each way rather than one with the way filled in**, which is\nwhat this was: `Pan {way}` filled in with `left`, so a page that said it\nin French read out \"Déplacer left\". The word for a direction is as much\nthe translator's as the word for panning, and a language can put it\nanywhere in the phrase.",
+              "fieldName": "panDownLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "pan-left-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pan left'",
+              "description": "The pan left button's label.",
+              "fieldName": "panLeftLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "pan-right-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pan right'",
+              "description": "The pan right button's label.",
+              "fieldName": "panRightLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "pan-step",
+              "type": {
+                "text": "number"
+              },
+              "default": "0.25",
+              "description": "How far one press pans the view, as a fraction of its size.\n\nA fraction rather than a distance, because this surface does not know the\nscale of what is inside it: a quarter of the viewport is the same gesture\nat any zoom, and a consumer who wants their own units multiplies by them.",
+              "fieldName": "panStep",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "pan-up-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pan up'",
+              "description": "The pan up button's label.",
+              "fieldName": "panUpLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "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": {
+                "text": "string"
+              },
+              "default": "'Zoom in'",
+              "description": "The zoom in button's label.",
+              "fieldName": "zoomInLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "zoom-out-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Zoom out'",
+              "description": "The zoom out button's label.",
+              "fieldName": "zoomOutLabel",
+              "inheritedFrom": {
+                "name": "MixinViewport",
+                "module": "src/mixins/mixin-viewport/mixin-viewport.ts"
+              }
+            },
+            {
+              "name": "active",
+              "type": {
+                "text": "string"
+              },
+              "description": "The `value` of the current item.\n\nNot `option.active`, which is the option the keyboard is on: that is a\ndifferent question from which one is chosen.\n\nWriting always applies, so `<helix-tabs active=\"one\">` starts on that\ntab, and `default-active` is how markup says where to start without\nnaming the current one.",
+              "fieldName": "active",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "name": "default-active",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The `value` of the item declared current in markup.\n\nIgnored once `active` is written.",
+              "fieldName": "defaultActive",
+              "inheritedFrom": {
+                "name": "MixinControllerActive",
+                "module": "src/mixins/mixin-controller-active/mixin-controller-active.ts"
+              }
+            },
+            {
+              "name": "count-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'{count} notes'",
+              "description": "What the list says of a note's count, with `{count}`.",
+              "fieldName": "countLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "name": "depth",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "How many links from the selected note to show, for its local graph. Unset\nshows every note. The list holds what the drawing shows.",
+              "fieldName": "depth",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The graph's name, read by screen readers, such as \"Research notes\".\nRequired.",
+              "fieldName": "label",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "name": "linked-both-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Linked both ways with {note}'",
+              "description": "How a note linked both to and from the selected one is described, with `{note}`.",
+              "fieldName": "linkedBothLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "name": "linked-from-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Linked from {note}'",
+              "description": "How a note the selected one links to is described, with `{note}`, the selected note's name.",
+              "fieldName": "linkedFromLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "name": "links-to-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Links to {note}'",
+              "description": "How a note that links to the selected one is described, with `{note}`.",
+              "fieldName": "linksToLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "name": "notes-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Notes'",
+              "description": "The list's name, read by screen readers.",
+              "fieldName": "notesLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "name": "search-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Find a note'",
+              "description": "The search field's name.",
+              "fieldName": "searchLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "name": "selected-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Selected'",
+              "description": "How the selected note is described in the list.",
+              "fieldName": "selectedLabel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "HelixActivateEvent"
+              },
+              "description": "A note was selected, in the list or in the drawing. The detail's `value` is its `id`.",
+              "name": "helix-activate",
+              "reactProp": "onhelix-activate",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixBeforeActivateEvent"
+              },
+              "description": "A note is about to be selected. Cancelable: cancel it to keep the selection in your own state.",
+              "name": "helix-before-activate",
+              "reactProp": "onhelix-before-activate",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "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. `connectGraph` moves the drawing.",
+              "name": "helix-graph-pan",
+              "reactProp": "onhelix-graph-pan",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "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"
+              },
+              "description": "The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not.",
+              "name": "helix-graph-ready",
+              "reactProp": "onhelix-graph-ready",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "type": {
+                "text": "HelixGraphZoomEvent"
+              },
+              "description": "A zoom button or key was pressed. `connectGraph` zooms the drawing.",
+              "name": "helix-graph-zoom",
+              "reactProp": "onhelix-graph-zoom",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "description": "The renderer's box, which the drawing is made in.",
+              "name": "",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The icon in the search field. Defaults to a magnifying glass.",
+              "name": "filter-icon",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "Content below the graph.",
+              "name": "footer",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "Content above the graph.",
+              "name": "header",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The room the notes after those drawn would take, so the list scrolls its whole length.",
+              "name": "after",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The room the notes before those drawn would take.",
+              "name": "before",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The drawing beside the list, or above it where the frame is narrow.",
+              "name": "body",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The group the pan and zoom buttons sit in.",
+              "name": "controls",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "How many notes the list holds, which a search narrows, at the end of the search bar.",
+              "name": "count",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The icon beside the search field.",
+              "name": "filter-icon",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The default icon beside the search field, shown when none is slotted.",
+              "name": "filter-mark",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The strip below the graph.",
+              "name": "footer",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The button that makes the graph fill the screen.",
+              "name": "fullscreen",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "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",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The list of notes, which draws only the rows in view.",
+              "name": "list",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "What screen readers hear when a search changes how many notes there are.",
+              "name": "live",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "One note in the list.",
+              "name": "note",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The note the keyboard is on in the list.",
+              "name": "note-cursor",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "A note linked to or from the selected one.",
+              "name": "note-linked",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "A note's name in the list.",
+              "name": "note-name",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "How a note stands to the selected one, such as \"Linked from Alpha\".",
+              "name": "note-relation",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The selected note, first in the list.",
+              "name": "note-selected",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The button that moves the graph down.",
+              "name": "pan-down",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The button that moves the graph toward the end of a line of text: right in English.",
+              "name": "pan-end",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The button that moves the graph toward the start of a line of text: left in English.",
+              "name": "pan-start",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The button that moves the graph up.",
+              "name": "pan-up",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The search field and the list, beside the drawing or below it.",
+              "name": "panel",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The frame: the drawing, its controls and the list.",
+              "name": "region",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The bar holding the icon, the search field and the count.",
+              "name": "search",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The field that finds a note by its name.",
+              "name": "search-field",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The drawing and its controls.",
+              "name": "stage",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The box the renderer draws in.",
+              "name": "viewport",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The zoom in button.",
+              "name": "zoom-in",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The zoom out button.",
+              "name": "zoom-out",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            }
+          ],
+          "cssStates": [
+            {
+              "description": "The graph fills the screen.",
+              "name": "fullscreen",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The user has been still long enough for the header and footer to fade.",
+              "name": "idle",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
+            {
+              "description": "The graph has been drawn whole, after `helix-graph-ready`.",
+              "name": "ready",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "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",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            }
+          ],
+          "modulePath": "src/graph/root/graph-root.ts",
+          "definitionPath": "src/graph/root/graph-root.ts"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixGraph",
+          "declaration": {
+            "name": "HelixGraph",
+            "module": "src/graph/root/graph-root.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "helix-graph",
+          "declaration": {
+            "name": "HelixGraph",
+            "module": "src/graph/root/graph-root.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/grid/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/grid/root/grid-root.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/grid/root/grid-root.css.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "styles"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "styles",
+          "declaration": {
+            "name": "styles",
+            "module": "src/grid/root/grid-root.css.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/grid/root/grid-root.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Set columns in one of two ways:\n\n- `columns` sets a fixed count.\n- `min` fits as many equal columns as there is room for at that width, so the\n  layout responds with no breakpoints to maintain.\n\nIf you set both, `min` wins. The grid is presentation only, so there is no\nheadless tier.",
+          "name": "HelixGrid",
+          "cssProperties": [
+            {
+              "description": "An explicit track list. It overrides `min` and `columns`. Use it for tracks of unequal widths, which neither attribute can set.",
+              "name": "--grid-columns"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The items to lay out.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "alignItems",
+              "type": {
+                "text": "'start' | 'center' | 'end' | 'stretch' | undefined"
+              },
+              "description": "How each cell aligns within its row. Sets `align-items`.\n\n**Named for the CSS property it sets**, the way `Flex` is, and the same\nproperty on a grid: it places every cell in its row's track rather than\nplacing the tracks. No `baseline`, which `Flex` offers, because cells in a\nrow of a grid are boxes of unrelated content and lining their first lines\nup is a thing a reader asks for between siblings in a row, not between\ncells in a table of them.\n\nThere is no `justifyContent` here for the same reason: the tracks are\n`1fr`, so they already fill the row and there is nothing left over to\ndistribute. `columns`, `min` and `--grid-columns` are how a grid says how\nwide its tracks are.",
+              "attribute": "align-items",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "columns",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "A fixed number of equal columns.",
+              "attribute": "columns",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "gap",
+              "type": {
+                "text": "'none' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | undefined"
+              },
+              "description": "The space between cells, as a step on the space scale.",
+              "attribute": "gap",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "min",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The minimum column width. The grid fits as many columns as the width allows.\n\nTakes precedence over `columns`: a grid that both fixes a count and reflows\nis two intentions in one element.",
+              "attribute": "min"
+            },
+            {
+              "kind": "method",
+              "name": "applyTemplate",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Writes the track list into the shadow root's own stylesheet.\n\nInto a `<style>` rather than onto `this.style`, and the difference is\nhydration. An inline style on the host is an attribute the element gives\nitself once it upgrades, so a React consumer's server markup does not have\nit and hydration reports a mismatch it will not patch up. The shadow root\nis not part of the tree React hydrates, so a rule written there is free.\n\nThe element is filled imperatively because Lit refuses expressions inside\n`<style>`: it is an invalid binding location and throws while rendering\nrather than at build time. Hence a static, empty element in the template\nand its `textContent` set here.\n\nIt sets a custom property rather than the track list itself. A shadow\nroot's adopted stylesheets cascade *after* its own `<style>` elements, and\n`static styles` is adopted, so a `grid-template-columns` here lost to the\none in the stylesheet and every `min` grid came out a single column. The\nstylesheet only ever reads `--_grid-template`, so there is nothing to\nlose against.\n\nThe consequence is that a server-rendered grid falls back to the\nstylesheet's single column until it upgrades. That is why `columns` is also\nexpressed as plain CSS below: the fixed-count case, which can be enumerated,\nneeds no JavaScript at all, and only `min` depends on this."
+            },
+            {
+              "kind": "field",
+              "name": "tier",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "default": "'helix-headless-'",
+              "description": "The prefix this tier registers its elements under.\n\n**A component that renders another renders its own tier's version of it**,\nso `helix-headless-pagination-size` composes `helix-headless-select` and\n`helix-pagination-size` composes `helix-select`. One template says\n`${this.tag('select')}` and each tier answers with its own name.\n\n**The public tag may not be the composed one, in either tier.** Using it\ncosts three things: the name means two different things depending on what a\nconsumer imported, the headless tier composes an element it does not ship,\nand the composition cannot be tested there at all, because there is no\n`helix-select` on that tier to test it against.\n\n**A prefix rather than an override per composition**, which was the first\nplan and does not compile. An override re-renders the fragment from the\nsubclass, and the fragment reads members the base keeps private:\n`PaginationSize` alone would have had to widen `options`, `current` and\n`handleChange` to `protected` so a subclass could say the same thing again.\nSixteen families of that is a lot of encapsulation spent on saying one\nword differently.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "tag",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "StaticValue"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "One composed tag, as a static value a template can interpolate.\n\n`unsafeStatic` is safe by construction: the name is a literal in our own\nsource and the prefix is one of two strings this class defines. Called per\nrender and not cached, which costs nothing, because `static-html` keys its\ntemplate cache on the joined string rather than on the object.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "partNamed",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "T | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "One of this element's own parts, by name, or null where it is not rendered.\n\nNot `part`, which every element already has: `Element.part` is the\n`DOMTokenList` of the names the element itself carries, and a method under\nthat name is a type error on every subclass.\n\n**One guard for every lookup.** Lit's server shim has no `querySelector`\non the render root, so a lookup reached during a server render, from a\ngetter a template reads or from `willUpdate`, throws there and nowhere\nelse. Four spellings of the same guard had grown across the library, and\na fifth site with none. Null on the server, which is what the rest of the\ncode already treats a part that has not rendered as.\n\n**`~=` and not `=`.** A part drawn in a state carries a second name while\nthe state holds, `part=\"page page-current\"`, and an exact match stops\nfinding it for exactly as long as it is the one that matters.\n\n`helix component`'s `selectors` reads these calls the way it reads a\n`querySelector('[part=\"x\"]')`, so a name nothing renders is a finding\nrather than a null an optional chain swallows.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "protected",
+              "readonly": true,
+              "description": "The element's semantics, set without touching the DOM.\n\n`ElementInternals` sets the implicit role, which an author's own `role`\nattribute still overrides, and it writes no attribute. Setting `role` on the\nhost directly would: that is an attribute the element gives itself after it\nupgrades, which a React consumer's server markup never had, and hydration\nreports it as a mismatch.\n\nAvailable during server rendering. Lit's shim implements `attachInternals`,\nso nothing here needs a guard.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toggleState",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "on",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Records a boolean fact about this element as a custom state.\n\n**The host belongs to whoever rendered it, and a component's own\nbookkeeping may not be kept there.** An attribute written on the first\nupdate is markup a consumer's server never sent, so a React consumer\nhydrates a DOM that has gained attributes since and reports a mismatch it\nwill not patch up. A custom state is not in the DOM at all: it carries the\nfact to a stylesheet through `:state()` and leaves the markup alone, so the\nserver's output and the client's agree by construction.\n\n`SETTLED` carries the long version of that argument; `checked`, `open`,\n`invalid` and `has-label` are recorded the same way, each of them a state a\n`default-*` attribute resolves before React reaches the node.\n\n**Deferring the definitions is not a fix and could not be.** Importing them\nfrom an effect so the upgrades fall the other side of hydration works only\nwhile hydration is one pass: anything that splits it, a streamed segment or\na suspended boundary, puts an upgrade back inside the window. Timing cannot\nbe the guarantee when the fact is kept somewhere React reconciles.\n\nFeature-tested rather than assumed, the way `hostAria` tests element\nreferences. An engine without `CustomStateSet` records nothing and keeps\nwhatever the resting rule draws, which is the safe direction to fail.\n\n**The engines the test is for are browsers**: Safari below 17.4 and Firefox\nbelow 126, where the write is a `TypeError`, so a component bypassing this\nfails to render rather than rendering without whatever the state draws.\nLit's server shim sets `states`, so the guard passes there and records a\nstate nothing reads, which is harmless.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "whenSettled",
+              "type": {
+                "text": "Promise<void>"
+              },
+              "readonly": true,
+              "description": "Resolves a frame after the first update, when transitions are switched on.\n\n**Named `whenSettled` because `settled` is taken four times over**, by\nImage, Splitter and both color controls, none of them about transitions. A\nbase class takes the name every subclass then cannot use.\n\n**The state it reports cannot be watched, which is why this exists.** A\ncustom state is deliberately not in the DOM, so there is no\n`MutationObserver` equivalent for `ElementInternals.states`. Await this\ninstead.\n\nSeparate from `updateComplete`, which resolves in the microtask checkpoint\nthe suppression is still active in. That is the distinction `readyToMove`\nin `@fusion.dev/helix-testing` is written around.\n\nIt never resolves where `requestAnimationFrame` never fires, which is a\nserver, a hidden tab, and happy-dom. Callers that must not hang there race\nit against a timeout, as the happy-dom harness's `readyToMove` does. The\nbrowser harness's awaits it alone: a browser always runs the frame, and a\ntimer beside it was a bet on how long one takes, which a busy run lost.",
+              "default": "new Promise<void>((resolve) => { this.resolveSettled = resolve })",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resolveSettled",
+              "type": {
+                "text": "() => void"
+              },
+              "privacy": "private",
+              "description": "Resolves `whenSettled`, once, from the frame that records the state.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "fromServer",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the shadow root was a server's, parsed from declarative shadow DOM.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hydrating",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this update is hydrating a server's markup, and so has to render\nexactly what the server rendered.\n\n**Lit hydrates by assuming the markup already shows the first render.** A\nvalue that differs is recorded and never written, so the page keeps the\nserver's, and a template that differs throws. The server has no children,\nso anything a component reads from its children waits for the update after\nhydration, which `finishHydration` asks for. Without a server's markup the\nfirst render reads them and there is one render.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "serverRendered",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this element hydrated a server's markup rather than rendering its own.\n\nFor what happened before hydration and cannot be heard after it: an image\nthe parser fetched fires `load` or `error` before any listener exists, so a\ncomponent asks the image instead, once, when this is true.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finishHydration",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Asks for the update a hydration put off, so the reads it skipped happen.\n\nCalled from `firstUpdated`, the end of the hydrating update. The render it\nschedules can only follow that one, which is the exception Lit's\nchange-in-update warning names, and it happens only on a page a server\nrendered.",
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "childrenKnown",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this render can know the children.\n\nA server cannot: its element shim carries attributes and no tree, so\n`children` is undefined there. A render hydrating what a server sent must\nnot, because it has to be the server's render. Anywhere else it can. A\ncomponent whose render depends on its children reads them through\n`knownChildren`, and treats \"not known\" as its own answer rather than as\n\"none\": a list that renders its empty state because nobody has looked yet is\nthe one thing an empty state must never do.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "knownChildren",
+              "type": {
+                "text": "Element[]"
+              },
+              "privacy": "protected",
+              "description": "The children a render may read: all of them where they are known, and none otherwise.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "assignsByName",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "protected",
+              "description": "Whether this element's slots route by name although it asked to assign them\nby hand.\n\n**A declarative shadow root is always the by-name kind.** HTML has no way to\nask for manual assignment, so a component that assigns by hand and hydrates\na server's root gets one where `slot.assign()` does nothing, and its\nchildren land wherever their `slot` attribute sends them. The way through is\nto write that attribute, which is what `route` does. Only there: on a root\nthis element made, assignment stays manual and the consumer's markup is\nnever touched, which is what a React consumer's hydration requires.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "HelixElement",
+                "module": "src/helix-element/helix-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "route",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "child",
+                  "type": {
+                    "text": "Element"
+                  }
+                },
                 {
                   "name": "name",
                   "type": {
@@ -66520,6 +69595,14 @@
             "module": "src/format-date/index.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/graph/index.js"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -83284,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",
@@ -83339,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",
@@ -83423,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",
@@ -83465,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",
@@ -83515,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",
@@ -83826,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",
@@ -83896,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",
@@ -84161,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",
@@ -84686,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",
@@ -85403,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": {
@@ -85452,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": {
@@ -85530,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": {
@@ -85556,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": {
@@ -85621,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": {
@@ -85866,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": {
@@ -86446,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",