@fusion.dev/helix-headless 0.117.0 → 0.118.0

package/types/jsx.d.ts

@@ -36,7 +36,9 @@ import type {
   HelixFacetEvent,
   HelixFilterEvent,
   HelixFormElement,
+  HelixGraphLayoutEvent,
   HelixGraphPanEvent,
+  HelixGraphPartChangeEvent,
   HelixGraphReadyEvent,
   HelixGraphZoomEvent,
   HelixHeadlessAccordion,
@@ -2265,6 +2267,12 @@ red is "blocked" on one board and "urgent" on the next. A reader who can
 see the board is told by the color; this is how a reader who cannot is
 told the same. A tone left out is not read. */
   toneLabels?: (HelixHeadlessCanvas["toneLabels"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "activate-hint-label"?: (HelixHeadlessCanvas["activateHintLabel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  activateHintLabel?: (HelixHeadlessCanvas["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -2329,6 +2337,26 @@ would write an attribute onto every host that no server sent. */
   "fullscreen-label"?: (HelixHeadlessCanvas["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   fullscreenLabel?: (HelixHeadlessCanvas["fullscreenLabel"]) | undefined;
+  /** Which gestures the surface takes from the page.
+
+- `always`: the surface takes the wheel and one finger, for a surface
+  that is the page, such as a full-screen view. A map rests here.
+- Unset is the family's own: `always` for a map, and for a board, a
+  drag and a pinch, with the plain wheel left to the page until the
+  board fills the screen.
+- `cooperative`: the wheel and one finger scroll the page, and the
+  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+  says so when a gesture passes to the page. Best for a surface embedded
+  in a page.
+- `activate`: the surface takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode.
+
+**Unreflected and without a default**, because a default that reflected
+would write an attribute onto every host that no server sent, and the
+hydration that followed would disagree with it. */
+  gestures?: (HelixHeadlessCanvas["gestures"]) | undefined;
   /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
 
 Zero keeps it up, which is the default: these controls are how a keyboard
@@ -2383,6 +2411,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "pan-up-label"?: (HelixHeadlessCanvas["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   panUpLabel?: (HelixHeadlessCanvas["panUpLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "two-finger-hint-label"?: (HelixHeadlessCanvas["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  twoFingerHintLabel?: (HelixHeadlessCanvas["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "using-label"?: (HelixHeadlessCanvas["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  usingLabel?: (HelixHeadlessCanvas["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "wheel-hint-label"?: (HelixHeadlessCanvas["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  wheelHintLabel?: (HelixHeadlessCanvas["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "zoom-in-label"?: (HelixHeadlessCanvas["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -2583,6 +2631,12 @@ red is "blocked" on one board and "urgent" on the next. A reader who can
 see the board is told by the color; this is how a reader who cannot is
 told the same. A tone left out is not read. */
   "prop:toneLabels"?: (HelixHeadlessCanvas["toneLabels"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "attr:activate-hint-label"?: (HelixHeadlessCanvas["activateHintLabel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "prop:activateHintLabel"?: (HelixHeadlessCanvas["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -2647,6 +2701,26 @@ would write an attribute onto every host that no server sent. */
   "attr:fullscreen-label"?: (HelixHeadlessCanvas["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   "prop:fullscreenLabel"?: (HelixHeadlessCanvas["fullscreenLabel"]) | undefined;
+  /** Which gestures the surface takes from the page.
+
+- `always`: the surface takes the wheel and one finger, for a surface
+  that is the page, such as a full-screen view. A map rests here.
+- Unset is the family's own: `always` for a map, and for a board, a
+  drag and a pinch, with the plain wheel left to the page until the
+  board fills the screen.
+- `cooperative`: the wheel and one finger scroll the page, and the
+  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+  says so when a gesture passes to the page. Best for a surface embedded
+  in a page.
+- `activate`: the surface takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode.
+
+**Unreflected and without a default**, because a default that reflected
+would write an attribute onto every host that no server sent, and the
+hydration that followed would disagree with it. */
+  "prop:gestures"?: (HelixHeadlessCanvas["gestures"]) | undefined;
   /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
 
 Zero keeps it up, which is the default: these controls are how a keyboard
@@ -2701,6 +2775,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "attr:pan-up-label"?: (HelixHeadlessCanvas["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   "prop:panUpLabel"?: (HelixHeadlessCanvas["panUpLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "attr:two-finger-hint-label"?: (HelixHeadlessCanvas["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "prop:twoFingerHintLabel"?: (HelixHeadlessCanvas["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "attr:using-label"?: (HelixHeadlessCanvas["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "prop:usingLabel"?: (HelixHeadlessCanvas["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "attr:wheel-hint-label"?: (HelixHeadlessCanvas["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "prop:wheelHintLabel"?: (HelixHeadlessCanvas["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "attr:zoom-in-label"?: (HelixHeadlessCanvas["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -9280,9 +9374,15 @@ export type HelixHeadlessGraphHelixActivateElementEvent =
 /** `helix-before-activate` event type */
 export type HelixHeadlessGraphHelixBeforeActivateElementEvent =
   HelixHeadlessGraphElementEvent<HelixBeforeActivateEvent>;
+/** `helix-graph-layout` event type */
+export type HelixHeadlessGraphHelixGraphLayoutElementEvent =
+  HelixHeadlessGraphElementEvent<HelixGraphLayoutEvent>;
 /** `helix-graph-pan` event type */
 export type HelixHeadlessGraphHelixGraphPanElementEvent =
   HelixHeadlessGraphElementEvent<HelixGraphPanEvent>;
+/** `helix-graph-part-change` event type */
+export type HelixHeadlessGraphHelixGraphPartChangeElementEvent =
+  HelixHeadlessGraphElementEvent<HelixGraphPartChangeEvent>;
 /** `helix-graph-ready` event type */
 export type HelixHeadlessGraphHelixGraphReadyElementEvent =
   HelixHeadlessGraphElementEvent<HelixGraphReadyEvent>;
@@ -9325,6 +9425,12 @@ Required. */
   "selected-label"?: (HelixHeadlessGraph["selectedLabel"]) | undefined;
   /** How the selected note is described in the list. */
   selectedLabel?: (HelixHeadlessGraph["selectedLabel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "activate-hint-label"?: (HelixHeadlessGraph["activateHintLabel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  activateHintLabel?: (HelixHeadlessGraph["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -9389,6 +9495,26 @@ would write an attribute onto every host that no server sent. */
   "fullscreen-label"?: (HelixHeadlessGraph["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   fullscreenLabel?: (HelixHeadlessGraph["fullscreenLabel"]) | undefined;
+  /** Which gestures the surface takes from the page.
+
+- `always`: the surface takes the wheel and one finger, for a surface
+  that is the page, such as a full-screen view. A map rests here.
+- Unset is the family's own: `always` for a map, and for a board, a
+  drag and a pinch, with the plain wheel left to the page until the
+  board fills the screen.
+- `cooperative`: the wheel and one finger scroll the page, and the
+  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+  says so when a gesture passes to the page. Best for a surface embedded
+  in a page.
+- `activate`: the surface takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode.
+
+**Unreflected and without a default**, because a default that reflected
+would write an attribute onto every host that no server sent, and the
+hydration that followed would disagree with it. */
+  gestures?: (HelixHeadlessGraph["gestures"]) | undefined;
   /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
 
 Zero keeps it up, which is the default: these controls are how a keyboard
@@ -9443,6 +9569,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "pan-up-label"?: (HelixHeadlessGraph["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   panUpLabel?: (HelixHeadlessGraph["panUpLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "two-finger-hint-label"?: (HelixHeadlessGraph["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  twoFingerHintLabel?: (HelixHeadlessGraph["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "using-label"?: (HelixHeadlessGraph["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  usingLabel?: (HelixHeadlessGraph["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "wheel-hint-label"?: (HelixHeadlessGraph["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  wheelHintLabel?: (HelixHeadlessGraph["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "zoom-in-label"?: (HelixHeadlessGraph["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -9479,15 +9625,23 @@ Ignored once `active` is written. */
   "onhelix-before-activate"?: ((
     e: HelixHeadlessGraphHelixBeforeActivateElementEvent,
   ) => void) | undefined;
-  /** A pan button or arrow key was pressed. Move the drawing. */
+  /** 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`. */
+  "onhelix-graph-layout"?: ((
+    e: HelixHeadlessGraphHelixGraphLayoutElementEvent,
+  ) => void) | undefined;
+  /** A pan button or arrow key was pressed. `connectGraph` moves the drawing. */
   "onhelix-graph-pan"?: ((
     e: HelixHeadlessGraphHelixGraphPanElementEvent,
   ) => void) | undefined;
+  /** The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it. */
+  "onhelix-graph-part-change"?: ((
+    e: HelixHeadlessGraphHelixGraphPartChangeElementEvent,
+  ) => void) | undefined;
   /** The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not. */
   "onhelix-graph-ready"?: ((
     e: HelixHeadlessGraphHelixGraphReadyElementEvent,
   ) => void) | undefined;
-  /** A zoom button or key was pressed. Zoom the drawing. */
+  /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
   "onhelix-graph-zoom"?: ((
     e: HelixHeadlessGraphHelixGraphZoomElementEvent,
   ) => void) | undefined;
@@ -9528,6 +9682,12 @@ Required. */
   "attr:selected-label"?: (HelixHeadlessGraph["selectedLabel"]) | undefined;
   /** How the selected note is described in the list. */
   "prop:selectedLabel"?: (HelixHeadlessGraph["selectedLabel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "attr:activate-hint-label"?: (HelixHeadlessGraph["activateHintLabel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "prop:activateHintLabel"?: (HelixHeadlessGraph["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -9592,6 +9752,26 @@ would write an attribute onto every host that no server sent. */
   "attr:fullscreen-label"?: (HelixHeadlessGraph["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   "prop:fullscreenLabel"?: (HelixHeadlessGraph["fullscreenLabel"]) | undefined;
+  /** Which gestures the surface takes from the page.
+
+- `always`: the surface takes the wheel and one finger, for a surface
+  that is the page, such as a full-screen view. A map rests here.
+- Unset is the family's own: `always` for a map, and for a board, a
+  drag and a pinch, with the plain wheel left to the page until the
+  board fills the screen.
+- `cooperative`: the wheel and one finger scroll the page, and the
+  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+  says so when a gesture passes to the page. Best for a surface embedded
+  in a page.
+- `activate`: the surface takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode.
+
+**Unreflected and without a default**, because a default that reflected
+would write an attribute onto every host that no server sent, and the
+hydration that followed would disagree with it. */
+  "prop:gestures"?: (HelixHeadlessGraph["gestures"]) | undefined;
   /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
 
 Zero keeps it up, which is the default: these controls are how a keyboard
@@ -9646,6 +9826,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "attr:pan-up-label"?: (HelixHeadlessGraph["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   "prop:panUpLabel"?: (HelixHeadlessGraph["panUpLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "attr:two-finger-hint-label"?: (HelixHeadlessGraph["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "prop:twoFingerHintLabel"?: (HelixHeadlessGraph["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "attr:using-label"?: (HelixHeadlessGraph["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "prop:usingLabel"?: (HelixHeadlessGraph["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "attr:wheel-hint-label"?: (HelixHeadlessGraph["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "prop:wheelHintLabel"?: (HelixHeadlessGraph["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "attr:zoom-in-label"?: (HelixHeadlessGraph["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -9683,15 +9883,23 @@ Ignored once `active` is written. */
   "on:helix-before-activate"?: ((
     e: HelixHeadlessGraphHelixBeforeActivateElementEvent,
   ) => void) | undefined;
-  /** A pan button or arrow key was pressed. Move the drawing. */
+  /** 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`. */
+  "on:helix-graph-layout"?: ((
+    e: HelixHeadlessGraphHelixGraphLayoutElementEvent,
+  ) => void) | undefined;
+  /** A pan button or arrow key was pressed. `connectGraph` moves the drawing. */
   "on:helix-graph-pan"?: ((
     e: HelixHeadlessGraphHelixGraphPanElementEvent,
   ) => void) | undefined;
+  /** The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it. */
+  "on:helix-graph-part-change"?: ((
+    e: HelixHeadlessGraphHelixGraphPartChangeElementEvent,
+  ) => void) | undefined;
   /** The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not. */
   "on:helix-graph-ready"?: ((
     e: HelixHeadlessGraphHelixGraphReadyElementEvent,
   ) => void) | undefined;
-  /** A zoom button or key was pressed. Zoom the drawing. */
+  /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
   "on:helix-graph-zoom"?: ((
     e: HelixHeadlessGraphHelixGraphZoomElementEvent,
   ) => void) | undefined;
@@ -12505,12 +12713,6 @@ export type HelixHeadlessMapHelixMapZoomElementEvent =
   HelixHeadlessMapElementEvent<HelixMapZoomEvent>;
 
 export type HelixHeadlessMapProps = {
-  /** The hint shown when a map waiting to be pressed is scrolled or swiped
-over, with `gestures="activate"`. */
-  "activate-hint-label"?: (HelixHeadlessMap["activateHintLabel"]) | undefined;
-  /** The hint shown when a map waiting to be pressed is scrolled or swiped
-over, with `gestures="activate"`. */
-  activateHintLabel?: (HelixHeadlessMap["activateHintLabel"]) | undefined;
   /** The map's rotation, in degrees clockwise from north. `connectMap` keeps it
 current, and the Face north button's needle turns with it. */
   bearing?: (HelixHeadlessMap["bearing"]) | undefined;
@@ -12525,19 +12727,6 @@ the map zooms in, and pressing one zooms in to its places. */
   "flat-label"?: (HelixHeadlessMap["flatLabel"]) | undefined;
   /** What screen readers hear when the map is tilted back to looking straight down. */
   flatLabel?: (HelixHeadlessMap["flatLabel"]) | undefined;
-  /** Which gestures the map takes from the page.
-
-- `always`, which unset is: the wheel zooms the map and one finger pans
-  it, for a map that is the page, such as a full-screen view.
-- `cooperative`: the wheel and one finger scroll the page, and the map
-  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
-  when a gesture passes to the page. Best for a map embedded in a page.
-- `activate`: the map takes nothing until it is pressed, and gives it
-  back on Escape, when the pointer leaves it, or on a press elsewhere.
-
-The keyboard and the frame's buttons work in every mode. The renderer is
-told through the connector, so MapLibre and Leaflet behave alike. */
-  gestures?: (HelixHeadlessMap["gestures"]) | undefined;
   /** The Hybrid map type's name. */
   "hybrid-label"?: (HelixHeadlessMap["hybridLabel"]) | undefined;
   /** The Hybrid map type's name. */
@@ -12619,22 +12808,6 @@ top of the map faces, clockwise from north. */
   /** What screen readers hear when the map is turned. `{degrees}` is the way the
 top of the map faces, clockwise from north. */
   turnedLabel?: (HelixHeadlessMap["turnedLabel"]) | undefined;
-  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
-  "two-finger-hint-label"?: (HelixHeadlessMap["twoFingerHintLabel"]) | undefined;
-  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
-  twoFingerHintLabel?: (HelixHeadlessMap["twoFingerHintLabel"]) | undefined;
-  /** The line shown while a map with `gestures="activate"` has the gestures. */
-  "using-label"?: (HelixHeadlessMap["usingLabel"]) | undefined;
-  /** The line shown while a map with `gestures="activate"` has the gestures. */
-  usingLabel?: (HelixHeadlessMap["usingLabel"]) | undefined;
-  /** The hint shown when the wheel scrolls past a map with
-`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-elsewhere, as the renderer reads it. */
-  "wheel-hint-label"?: (HelixHeadlessMap["wheelHintLabel"]) | undefined;
-  /** The hint shown when the wheel scrolls past a map with
-`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-elsewhere, as the renderer reads it. */
-  wheelHintLabel?: (HelixHeadlessMap["wheelHintLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
   "zoomed-label"?: (HelixHeadlessMap["zoomedLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
@@ -12645,6 +12818,12 @@ current, and the map says it after a zoom. */
   /** How far the map is zoomed, in its renderer's levels. `connectMap` keeps it
 current, and the map says it after a zoom. */
   zoomLevel?: (HelixHeadlessMap["zoomLevel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "activate-hint-label"?: (HelixHeadlessMap["activateHintLabel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  activateHintLabel?: (HelixHeadlessMap["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -12709,6 +12888,26 @@ would write an attribute onto every host that no server sent. */
   "fullscreen-label"?: (HelixHeadlessMap["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   fullscreenLabel?: (HelixHeadlessMap["fullscreenLabel"]) | undefined;
+  /** Which gestures the surface takes from the page.
+
+- `always`: the surface takes the wheel and one finger, for a surface
+  that is the page, such as a full-screen view. A map rests here.
+- Unset is the family's own: `always` for a map, and for a board, a
+  drag and a pinch, with the plain wheel left to the page until the
+  board fills the screen.
+- `cooperative`: the wheel and one finger scroll the page, and the
+  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+  says so when a gesture passes to the page. Best for a surface embedded
+  in a page.
+- `activate`: the surface takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode.
+
+**Unreflected and without a default**, because a default that reflected
+would write an attribute onto every host that no server sent, and the
+hydration that followed would disagree with it. */
+  gestures?: (HelixHeadlessMap["gestures"]) | undefined;
   /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
 
 Zero keeps it up, which is the default: these controls are how a keyboard
@@ -12763,6 +12962,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "pan-up-label"?: (HelixHeadlessMap["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   panUpLabel?: (HelixHeadlessMap["panUpLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "two-finger-hint-label"?: (HelixHeadlessMap["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  twoFingerHintLabel?: (HelixHeadlessMap["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "using-label"?: (HelixHeadlessMap["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  usingLabel?: (HelixHeadlessMap["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "wheel-hint-label"?: (HelixHeadlessMap["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  wheelHintLabel?: (HelixHeadlessMap["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "zoom-in-label"?: (HelixHeadlessMap["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -12797,12 +13016,6 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
 };
 
 export type HelixHeadlessMapSolidJsProps = {
-  /** The hint shown when a map waiting to be pressed is scrolled or swiped
-over, with `gestures="activate"`. */
-  "attr:activate-hint-label"?: (HelixHeadlessMap["activateHintLabel"]) | undefined;
-  /** The hint shown when a map waiting to be pressed is scrolled or swiped
-over, with `gestures="activate"`. */
-  "prop:activateHintLabel"?: (HelixHeadlessMap["activateHintLabel"]) | undefined;
   /** The map's rotation, in degrees clockwise from north. `connectMap` keeps it
 current, and the Face north button's needle turns with it. */
   "prop:bearing"?: (HelixHeadlessMap["bearing"]) | undefined;
@@ -12817,19 +13030,6 @@ the map zooms in, and pressing one zooms in to its places. */
   "attr:flat-label"?: (HelixHeadlessMap["flatLabel"]) | undefined;
   /** What screen readers hear when the map is tilted back to looking straight down. */
   "prop:flatLabel"?: (HelixHeadlessMap["flatLabel"]) | undefined;
-  /** Which gestures the map takes from the page.
-
-- `always`, which unset is: the wheel zooms the map and one finger pans
-  it, for a map that is the page, such as a full-screen view.
-- `cooperative`: the wheel and one finger scroll the page, and the map
-  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
-  when a gesture passes to the page. Best for a map embedded in a page.
-- `activate`: the map takes nothing until it is pressed, and gives it
-  back on Escape, when the pointer leaves it, or on a press elsewhere.
-
-The keyboard and the frame's buttons work in every mode. The renderer is
-told through the connector, so MapLibre and Leaflet behave alike. */
-  "prop:gestures"?: (HelixHeadlessMap["gestures"]) | undefined;
   /** The Hybrid map type's name. */
   "attr:hybrid-label"?: (HelixHeadlessMap["hybridLabel"]) | undefined;
   /** The Hybrid map type's name. */
@@ -12911,22 +13111,6 @@ top of the map faces, clockwise from north. */
   /** What screen readers hear when the map is turned. `{degrees}` is the way the
 top of the map faces, clockwise from north. */
   "prop:turnedLabel"?: (HelixHeadlessMap["turnedLabel"]) | undefined;
-  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
-  "attr:two-finger-hint-label"?: (HelixHeadlessMap["twoFingerHintLabel"]) | undefined;
-  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
-  "prop:twoFingerHintLabel"?: (HelixHeadlessMap["twoFingerHintLabel"]) | undefined;
-  /** The line shown while a map with `gestures="activate"` has the gestures. */
-  "attr:using-label"?: (HelixHeadlessMap["usingLabel"]) | undefined;
-  /** The line shown while a map with `gestures="activate"` has the gestures. */
-  "prop:usingLabel"?: (HelixHeadlessMap["usingLabel"]) | undefined;
-  /** The hint shown when the wheel scrolls past a map with
-`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-elsewhere, as the renderer reads it. */
-  "attr:wheel-hint-label"?: (HelixHeadlessMap["wheelHintLabel"]) | undefined;
-  /** The hint shown when the wheel scrolls past a map with
-`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-elsewhere, as the renderer reads it. */
-  "prop:wheelHintLabel"?: (HelixHeadlessMap["wheelHintLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
   "attr:zoomed-label"?: (HelixHeadlessMap["zoomedLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
@@ -12937,6 +13121,12 @@ current, and the map says it after a zoom. */
   /** How far the map is zoomed, in its renderer's levels. `connectMap` keeps it
 current, and the map says it after a zoom. */
   "prop:zoomLevel"?: (HelixHeadlessMap["zoomLevel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "attr:activate-hint-label"?: (HelixHeadlessMap["activateHintLabel"]) | undefined;
+  /** The hint shown when a surface waiting to be pressed is scrolled or
+swiped over, with `gestures="activate"`. Absent is the family's own. */
+  "prop:activateHintLabel"?: (HelixHeadlessMap["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -13001,6 +13191,26 @@ would write an attribute onto every host that no server sent. */
   "attr:fullscreen-label"?: (HelixHeadlessMap["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   "prop:fullscreenLabel"?: (HelixHeadlessMap["fullscreenLabel"]) | undefined;
+  /** Which gestures the surface takes from the page.
+
+- `always`: the surface takes the wheel and one finger, for a surface
+  that is the page, such as a full-screen view. A map rests here.
+- Unset is the family's own: `always` for a map, and for a board, a
+  drag and a pinch, with the plain wheel left to the page until the
+  board fills the screen.
+- `cooperative`: the wheel and one finger scroll the page, and the
+  surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+  says so when a gesture passes to the page. Best for a surface embedded
+  in a page.
+- `activate`: the surface takes nothing until it is pressed, and gives it
+  back on Escape, when the pointer leaves it, or on a press elsewhere.
+
+The keyboard and the frame's buttons work in every mode.
+
+**Unreflected and without a default**, because a default that reflected
+would write an attribute onto every host that no server sent, and the
+hydration that followed would disagree with it. */
+  "prop:gestures"?: (HelixHeadlessMap["gestures"]) | undefined;
   /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
 
 Zero keeps it up, which is the default: these controls are how a keyboard
@@ -13055,6 +13265,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "attr:pan-up-label"?: (HelixHeadlessMap["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   "prop:panUpLabel"?: (HelixHeadlessMap["panUpLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "attr:two-finger-hint-label"?: (HelixHeadlessMap["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "prop:twoFingerHintLabel"?: (HelixHeadlessMap["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "attr:using-label"?: (HelixHeadlessMap["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "prop:usingLabel"?: (HelixHeadlessMap["usingLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "attr:wheel-hint-label"?: (HelixHeadlessMap["wheelHintLabel"]) | undefined;
+  /** The hint shown when the wheel scrolls past a surface with
+`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+elsewhere. Absent is the family's own. */
+  "prop:wheelHintLabel"?: (HelixHeadlessMap["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "attr:zoom-in-label"?: (HelixHeadlessMap["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -25253,6 +25483,8 @@ export type CustomElements = {
    * red is "blocked" on one board and "urgent" on the next. A reader who can
    * see the board is told by the color; this is how a reader who cannot is
    * told the same. A tone left out is not read.
+   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a surface waiting to be pressed is scrolled or
+   * swiped over, with `gestures="activate"`. Absent is the family's own.
    * - `controls`: Which controls to show, as a list such as `pan zoom fullscreen`, or
    * `none`. A family can add words of its own.
    *
@@ -25292,6 +25524,25 @@ export type CustomElements = {
    * resting value being an attribute's absence: a default that reflected
    * would write an attribute onto every host that no server sent.
    * - `fullscreen-label`/`fullscreenLabel`: The fullscreen button's label.
+   * - `gestures`: Which gestures the surface takes from the page.
+   *
+   * - `always`: the surface takes the wheel and one finger, for a surface
+   *   that is the page, such as a full-screen view. A map rests here.
+   * - Unset is the family's own: `always` for a map, and for a board, a
+   *   drag and a pinch, with the plain wheel left to the page until the
+   *   board fills the screen.
+   * - `cooperative`: the wheel and one finger scroll the page, and the
+   *   surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+   *   says so when a gesture passes to the page. Best for a surface embedded
+   *   in a page.
+   * - `activate`: the surface takes nothing until it is pressed, and gives it
+   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
+   *
+   * The keyboard and the frame's buttons work in every mode.
+   *
+   * **Unreflected and without a default**, because a default that reflected
+   * would write an attribute onto every host that no server sent, and the
+   * hydration that followed would disagree with it.
    * - `idle-delay`/`idleDelay`: How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
    *
    * Zero keeps it up, which is the default: these controls are how a keyboard
@@ -25313,6 +25564,13 @@ export type CustomElements = {
    * scale of what is inside it: a quarter of the viewport is the same gesture
    * at any zoom, and a consumer who wants their own units multiplies by them.
    * - `pan-up-label`/`panUpLabel`: The pan up button's label.
+   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a surface with
+   * `gestures="cooperative"`. Absent is the family's own.
+   * - `using-label`/`usingLabel`: The line shown while a surface with `gestures="activate"` has the
+   * gestures. Absent is the family's own.
+   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a surface with
+   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+   * elsewhere. Absent is the family's own.
    * - `zoom-in-label`/`zoomInLabel`: The zoom in button's label.
    * - `zoom-out-label`/`zoomOutLabel`: The zoom out button's label.
    * - `view`: The board's current view: the document's point at the middle of the view,
@@ -25429,6 +25687,8 @@ export type CustomElements = {
    * - `edges`: The layer the connectors are drawn in.
    * - `footer`: The strip below the board.
    * - `fullscreen`: The button that makes the board fill the screen.
+   * - `gesture-hint`: Words over the board for a moment when it lets a gesture pass to the page, such as how to zoom it.
+   * - `gesture-status`: The line shown while a board with `gestures="activate"` has the gestures.
    * - `header`: The strip above the board.
    * - `label`: The label on a connector.
    * - `label-editor`: The field for editing a connection's label or a group's name, placed over that text.
@@ -25454,6 +25714,8 @@ export type CustomElements = {
    * - `holding`: An item picked up with a click follows the pointer until the next press puts it down.
    * - `idle`: The user has been still for `idle-delay` milliseconds. The board's own controls stay; select on it to hide chrome of your own.
    * - `pressing`: While a press on the board, its cards or its connections is under way.
+   * - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a board with `gestures="activate"` waits to be pressed.
+   * - `using`: A board with `gestures="activate"` has been pressed and has the gestures.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-headless-canvas": Partial<
@@ -30958,8 +31220,8 @@ export type CustomElements = {
   /**
    * Helix draws no graph. A force layout of thousands of notes is physics and
    * WebGL, which a renderer such as Sigma.js does. Put the renderer's box in the
-   * frame, draw `nodes` and `links` in it, and answer the frame's pan and zoom
-   * events by moving the drawing.
+   * frame, and `connectGraph` from `@fusion.dev/helix-graph` draws `nodes` and
+   * `links` in it and keeps it in step with the frame.
    *
    * What the frame adds is what a drawing of a graph cannot do: a list of every
    * note beside it, which is the graph for a screen reader and a quick way to
@@ -30993,6 +31255,8 @@ export type CustomElements = {
    * - `notes-label`/`notesLabel`: The list's name, read by screen readers.
    * - `search-label`/`searchLabel`: The search field's name.
    * - `selected-label`/`selectedLabel`: How the selected note is described in the list.
+   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a surface waiting to be pressed is scrolled or
+   * swiped over, with `gestures="activate"`. Absent is the family's own.
    * - `controls`: Which controls to show, as a list such as `pan zoom fullscreen`, or
    * `none`. A family can add words of its own.
    *
@@ -31032,6 +31296,25 @@ export type CustomElements = {
    * resting value being an attribute's absence: a default that reflected
    * would write an attribute onto every host that no server sent.
    * - `fullscreen-label`/`fullscreenLabel`: The fullscreen button's label.
+   * - `gestures`: Which gestures the surface takes from the page.
+   *
+   * - `always`: the surface takes the wheel and one finger, for a surface
+   *   that is the page, such as a full-screen view. A map rests here.
+   * - Unset is the family's own: `always` for a map, and for a board, a
+   *   drag and a pinch, with the plain wheel left to the page until the
+   *   board fills the screen.
+   * - `cooperative`: the wheel and one finger scroll the page, and the
+   *   surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+   *   says so when a gesture passes to the page. Best for a surface embedded
+   *   in a page.
+   * - `activate`: the surface takes nothing until it is pressed, and gives it
+   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
+   *
+   * The keyboard and the frame's buttons work in every mode.
+   *
+   * **Unreflected and without a default**, because a default that reflected
+   * would write an attribute onto every host that no server sent, and the
+   * hydration that followed would disagree with it.
    * - `idle-delay`/`idleDelay`: How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
    *
    * Zero keeps it up, which is the default: these controls are how a keyboard
@@ -31053,6 +31336,13 @@ export type CustomElements = {
    * scale of what is inside it: a quarter of the viewport is the same gesture
    * at any zoom, and a consumer who wants their own units multiplies by them.
    * - `pan-up-label`/`panUpLabel`: The pan up button's label.
+   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a surface with
+   * `gestures="cooperative"`. Absent is the family's own.
+   * - `using-label`/`usingLabel`: The line shown while a surface with `gestures="activate"` has the
+   * gestures. Absent is the family's own.
+   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a surface with
+   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+   * elsewhere. Absent is the family's own.
    * - `zoom-in-label`/`zoomInLabel`: The zoom in button's label.
    * - `zoom-out-label`/`zoomOutLabel`: The zoom out button's label.
    * - `active`: The `value` of the current item.
@@ -31096,9 +31386,11 @@ export type CustomElements = {
    *
    * - `helix-activate`: A note was selected, in the list or in the drawing. The detail's `value` is its `id`.
    * - `helix-before-activate`: A note is about to be selected. Cancelable: cancel it to keep the selection in your own state.
-   * - `helix-graph-pan`: A pan button or arrow key was pressed. Move the drawing.
+   * - `helix-graph-layout`: 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`.
+   * - `helix-graph-pan`: A pan button or arrow key was pressed. `connectGraph` moves the drawing.
+   * - `helix-graph-part-change`: The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.
    * - `helix-graph-ready`: The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not.
-   * - `helix-graph-zoom`: A zoom button or key was pressed. Zoom the drawing.
+   * - `helix-graph-zoom`: A zoom button or key was pressed. `connectGraph` zooms the drawing.
    *
    * ## Slots
    *
@@ -31114,10 +31406,14 @@ export type CustomElements = {
    * Methods that can be called to access component functionality.
    *
    * - `drawn(whole = true) => void`: Says the graph has been drawn whole, or with `false`, that it no longer
-   * is. Call it when the renderer's layout has settled and the graph is
-   * finished. The first call after
+   * is. Called by `connectGraph` once its layout has settled; a page drawing
+   * its own graph calls it when that graph is finished. The first call after
    * the graph was not drawn sends `helix-graph-ready` and turns on
    * `:state(ready)`.
+   * - `laidOut(positions: Record<string, { x: number; y: number }>) => void`: Says where a layout put each note, by its `id`: sends
+   * `helix-graph-layout` for the page to keep. Called by `connectGraph` once
+   * its layout has settled; a page laying out its own graph calls it the same
+   * way.
    * - `pan(to: ViewportWay) => void`: Pans the view one step in a direction.
    * - `zoom(by: number) => void`: Zooms the view one step: `1` zooms in and `-1` zooms out.
    * - `toggleFullscreen() => void`: Turns fullscreen on or off.
@@ -31143,6 +31439,8 @@ export type CustomElements = {
    * - `filter-mark`: The default icon beside the search field, shown when none is slotted.
    * - `footer`: The strip below the graph.
    * - `fullscreen`: The button that makes the graph fill the screen.
+   * - `gesture-hint`: Words over the graph for a moment when it lets a gesture pass to the page, such as how to zoom it.
+   * - `gesture-status`: The line shown while a graph with `gestures="activate"` has the gestures.
    * - `header`: The strip above the graph.
    * - `list`: The list of notes, which draws only the rows in view.
    * - `live`: What screen readers hear when a search changes how many notes there are.
@@ -31172,6 +31470,8 @@ export type CustomElements = {
    * - `fullscreen`: The graph fills the screen.
    * - `idle`: The user has been still long enough for the header and footer to fade.
    * - `ready`: The graph has been drawn whole, after `helix-graph-ready`.
+   * - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a graph with `gestures="activate"` waits to be pressed.
+   * - `using`: A graph with `gestures="activate"` has been pressed and has the gestures.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-headless-graph": Partial<
@@ -33871,26 +34171,12 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a map waiting to be pressed is scrolled or swiped
-   * over, with `gestures="activate"`.
    * - `bearing`: The map's rotation, in degrees clockwise from north. `connectMap` keeps it
    * current, and the Face north button's needle turns with it.
    * - `cluster`: Combines markers that would overlap into one count. Counts split apart as
    * the map zooms in, and pressing one zooms in to its places.
    * - `face-north-label`/`faceNorthLabel`: The Face north button's label.
    * - `flat-label`/`flatLabel`: What screen readers hear when the map is tilted back to looking straight down.
-   * - `gestures`: Which gestures the map takes from the page.
-   *
-   * - `always`, which unset is: the wheel zooms the map and one finger pans
-   *   it, for a map that is the page, such as a full-screen view.
-   * - `cooperative`: the wheel and one finger scroll the page, and the map
-   *   takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
-   *   when a gesture passes to the page. Best for a map embedded in a page.
-   * - `activate`: the map takes nothing until it is pressed, and gives it
-   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
-   *
-   * The keyboard and the frame's buttons work in every mode. The renderer is
-   * told through the connector, so MapLibre and Leaflet behave alike.
    * - `hybrid-label`/`hybridLabel`: The Hybrid map type's name.
    * - `label`: The map's name, read by screen readers. Name the place, such as "Delivery
    * area", so that several maps on one page can be told apart. Required.
@@ -33917,14 +34203,11 @@ export type CustomElements = {
    * - `tilt-label`/`tiltLabel`: The 3D button's label.
    * - `turned-label`/`turnedLabel`: What screen readers hear when the map is turned. `{degrees}` is the way the
    * top of the map faces, clockwise from north.
-   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a map with `gestures="cooperative"`.
-   * - `using-label`/`usingLabel`: The line shown while a map with `gestures="activate"` has the gestures.
-   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a map with
-   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-   * elsewhere, as the renderer reads it.
    * - `zoomed-label`/`zoomedLabel`: What screen readers hear after a zoom. `{level}` is the zoom level.
    * - `zoom-level`/`zoomLevel`: How far the map is zoomed, in its renderer's levels. `connectMap` keeps it
    * current, and the map says it after a zoom.
+   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a surface waiting to be pressed is scrolled or
+   * swiped over, with `gestures="activate"`. Absent is the family's own.
    * - `controls`: Which controls to show, as a list such as `pan zoom fullscreen`, or
    * `none`. A family can add words of its own.
    *
@@ -33964,6 +34247,25 @@ export type CustomElements = {
    * resting value being an attribute's absence: a default that reflected
    * would write an attribute onto every host that no server sent.
    * - `fullscreen-label`/`fullscreenLabel`: The fullscreen button's label.
+   * - `gestures`: Which gestures the surface takes from the page.
+   *
+   * - `always`: the surface takes the wheel and one finger, for a surface
+   *   that is the page, such as a full-screen view. A map rests here.
+   * - Unset is the family's own: `always` for a map, and for a board, a
+   *   drag and a pinch, with the plain wheel left to the page until the
+   *   board fills the screen.
+   * - `cooperative`: the wheel and one finger scroll the page, and the
+   *   surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+   *   says so when a gesture passes to the page. Best for a surface embedded
+   *   in a page.
+   * - `activate`: the surface takes nothing until it is pressed, and gives it
+   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
+   *
+   * The keyboard and the frame's buttons work in every mode.
+   *
+   * **Unreflected and without a default**, because a default that reflected
+   * would write an attribute onto every host that no server sent, and the
+   * hydration that followed would disagree with it.
    * - `idle-delay`/`idleDelay`: How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
    *
    * Zero keeps it up, which is the default: these controls are how a keyboard
@@ -33985,6 +34287,13 @@ export type CustomElements = {
    * scale of what is inside it: a quarter of the viewport is the same gesture
    * at any zoom, and a consumer who wants their own units multiplies by them.
    * - `pan-up-label`/`panUpLabel`: The pan up button's label.
+   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a surface with
+   * `gestures="cooperative"`. Absent is the family's own.
+   * - `using-label`/`usingLabel`: The line shown while a surface with `gestures="activate"` has the
+   * gestures. Absent is the family's own.
+   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a surface with
+   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+   * elsewhere. Absent is the family's own.
    * - `zoom-in-label`/`zoomInLabel`: The zoom in button's label.
    * - `zoom-out-label`/`zoomOutLabel`: The zoom out button's label.
    * - `ready`: Whether the map has been drawn whole, which `drawn()` says. For a page that
@@ -34118,6 +34427,7 @@ export type CustomElements = {
    * - `fullscreen`: The map fills the screen.
    * - `idle`: The user has been still long enough for the header and footer to fade.
    * - `ready`: The map has been drawn whole, after `helix-map-ready`.
+   * - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a map with `gestures="activate"` waits to be pressed.
    * - `using`: A map with `gestures="activate"` has been pressed and has the gestures.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -45473,6 +45783,8 @@ export type CustomElementsSolidJs = {
    * red is "blocked" on one board and "urgent" on the next. A reader who can
    * see the board is told by the color; this is how a reader who cannot is
    * told the same. A tone left out is not read.
+   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a surface waiting to be pressed is scrolled or
+   * swiped over, with `gestures="activate"`. Absent is the family's own.
    * - `controls`: Which controls to show, as a list such as `pan zoom fullscreen`, or
    * `none`. A family can add words of its own.
    *
@@ -45512,6 +45824,25 @@ export type CustomElementsSolidJs = {
    * resting value being an attribute's absence: a default that reflected
    * would write an attribute onto every host that no server sent.
    * - `fullscreen-label`/`fullscreenLabel`: The fullscreen button's label.
+   * - `gestures`: Which gestures the surface takes from the page.
+   *
+   * - `always`: the surface takes the wheel and one finger, for a surface
+   *   that is the page, such as a full-screen view. A map rests here.
+   * - Unset is the family's own: `always` for a map, and for a board, a
+   *   drag and a pinch, with the plain wheel left to the page until the
+   *   board fills the screen.
+   * - `cooperative`: the wheel and one finger scroll the page, and the
+   *   surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+   *   says so when a gesture passes to the page. Best for a surface embedded
+   *   in a page.
+   * - `activate`: the surface takes nothing until it is pressed, and gives it
+   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
+   *
+   * The keyboard and the frame's buttons work in every mode.
+   *
+   * **Unreflected and without a default**, because a default that reflected
+   * would write an attribute onto every host that no server sent, and the
+   * hydration that followed would disagree with it.
    * - `idle-delay`/`idleDelay`: How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
    *
    * Zero keeps it up, which is the default: these controls are how a keyboard
@@ -45533,6 +45864,13 @@ export type CustomElementsSolidJs = {
    * scale of what is inside it: a quarter of the viewport is the same gesture
    * at any zoom, and a consumer who wants their own units multiplies by them.
    * - `pan-up-label`/`panUpLabel`: The pan up button's label.
+   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a surface with
+   * `gestures="cooperative"`. Absent is the family's own.
+   * - `using-label`/`usingLabel`: The line shown while a surface with `gestures="activate"` has the
+   * gestures. Absent is the family's own.
+   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a surface with
+   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+   * elsewhere. Absent is the family's own.
    * - `zoom-in-label`/`zoomInLabel`: The zoom in button's label.
    * - `zoom-out-label`/`zoomOutLabel`: The zoom out button's label.
    * - `view`: The board's current view: the document's point at the middle of the view,
@@ -45649,6 +45987,8 @@ export type CustomElementsSolidJs = {
    * - `edges`: The layer the connectors are drawn in.
    * - `footer`: The strip below the board.
    * - `fullscreen`: The button that makes the board fill the screen.
+   * - `gesture-hint`: Words over the board for a moment when it lets a gesture pass to the page, such as how to zoom it.
+   * - `gesture-status`: The line shown while a board with `gestures="activate"` has the gestures.
    * - `header`: The strip above the board.
    * - `label`: The label on a connector.
    * - `label-editor`: The field for editing a connection's label or a group's name, placed over that text.
@@ -45674,6 +46014,8 @@ export type CustomElementsSolidJs = {
    * - `holding`: An item picked up with a click follows the pointer until the next press puts it down.
    * - `idle`: The user has been still for `idle-delay` milliseconds. The board's own controls stay; select on it to hide chrome of your own.
    * - `pressing`: While a press on the board, its cards or its connections is under way.
+   * - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a board with `gestures="activate"` waits to be pressed.
+   * - `using`: A board with `gestures="activate"` has been pressed and has the gestures.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-headless-canvas": Partial<
@@ -51246,8 +51588,8 @@ export type CustomElementsSolidJs = {
   /**
    * Helix draws no graph. A force layout of thousands of notes is physics and
    * WebGL, which a renderer such as Sigma.js does. Put the renderer's box in the
-   * frame, draw `nodes` and `links` in it, and answer the frame's pan and zoom
-   * events by moving the drawing.
+   * frame, and `connectGraph` from `@fusion.dev/helix-graph` draws `nodes` and
+   * `links` in it and keeps it in step with the frame.
    *
    * What the frame adds is what a drawing of a graph cannot do: a list of every
    * note beside it, which is the graph for a screen reader and a quick way to
@@ -51281,6 +51623,8 @@ export type CustomElementsSolidJs = {
    * - `notes-label`/`notesLabel`: The list's name, read by screen readers.
    * - `search-label`/`searchLabel`: The search field's name.
    * - `selected-label`/`selectedLabel`: How the selected note is described in the list.
+   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a surface waiting to be pressed is scrolled or
+   * swiped over, with `gestures="activate"`. Absent is the family's own.
    * - `controls`: Which controls to show, as a list such as `pan zoom fullscreen`, or
    * `none`. A family can add words of its own.
    *
@@ -51320,6 +51664,25 @@ export type CustomElementsSolidJs = {
    * resting value being an attribute's absence: a default that reflected
    * would write an attribute onto every host that no server sent.
    * - `fullscreen-label`/`fullscreenLabel`: The fullscreen button's label.
+   * - `gestures`: Which gestures the surface takes from the page.
+   *
+   * - `always`: the surface takes the wheel and one finger, for a surface
+   *   that is the page, such as a full-screen view. A map rests here.
+   * - Unset is the family's own: `always` for a map, and for a board, a
+   *   drag and a pinch, with the plain wheel left to the page until the
+   *   board fills the screen.
+   * - `cooperative`: the wheel and one finger scroll the page, and the
+   *   surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+   *   says so when a gesture passes to the page. Best for a surface embedded
+   *   in a page.
+   * - `activate`: the surface takes nothing until it is pressed, and gives it
+   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
+   *
+   * The keyboard and the frame's buttons work in every mode.
+   *
+   * **Unreflected and without a default**, because a default that reflected
+   * would write an attribute onto every host that no server sent, and the
+   * hydration that followed would disagree with it.
    * - `idle-delay`/`idleDelay`: How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
    *
    * Zero keeps it up, which is the default: these controls are how a keyboard
@@ -51341,6 +51704,13 @@ export type CustomElementsSolidJs = {
    * scale of what is inside it: a quarter of the viewport is the same gesture
    * at any zoom, and a consumer who wants their own units multiplies by them.
    * - `pan-up-label`/`panUpLabel`: The pan up button's label.
+   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a surface with
+   * `gestures="cooperative"`. Absent is the family's own.
+   * - `using-label`/`usingLabel`: The line shown while a surface with `gestures="activate"` has the
+   * gestures. Absent is the family's own.
+   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a surface with
+   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+   * elsewhere. Absent is the family's own.
    * - `zoom-in-label`/`zoomInLabel`: The zoom in button's label.
    * - `zoom-out-label`/`zoomOutLabel`: The zoom out button's label.
    * - `active`: The `value` of the current item.
@@ -51384,9 +51754,11 @@ export type CustomElementsSolidJs = {
    *
    * - `helix-activate`: A note was selected, in the list or in the drawing. The detail's `value` is its `id`.
    * - `helix-before-activate`: A note is about to be selected. Cancelable: cancel it to keep the selection in your own state.
-   * - `helix-graph-pan`: A pan button or arrow key was pressed. Move the drawing.
+   * - `helix-graph-layout`: 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`.
+   * - `helix-graph-pan`: A pan button or arrow key was pressed. `connectGraph` moves the drawing.
+   * - `helix-graph-part-change`: The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.
    * - `helix-graph-ready`: The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not.
-   * - `helix-graph-zoom`: A zoom button or key was pressed. Zoom the drawing.
+   * - `helix-graph-zoom`: A zoom button or key was pressed. `connectGraph` zooms the drawing.
    *
    * ## Slots
    *
@@ -51402,10 +51774,14 @@ export type CustomElementsSolidJs = {
    * Methods that can be called to access component functionality.
    *
    * - `drawn(whole = true) => void`: Says the graph has been drawn whole, or with `false`, that it no longer
-   * is. Call it when the renderer's layout has settled and the graph is
-   * finished. The first call after
+   * is. Called by `connectGraph` once its layout has settled; a page drawing
+   * its own graph calls it when that graph is finished. The first call after
    * the graph was not drawn sends `helix-graph-ready` and turns on
    * `:state(ready)`.
+   * - `laidOut(positions: Record<string, { x: number; y: number }>) => void`: Says where a layout put each note, by its `id`: sends
+   * `helix-graph-layout` for the page to keep. Called by `connectGraph` once
+   * its layout has settled; a page laying out its own graph calls it the same
+   * way.
    * - `pan(to: ViewportWay) => void`: Pans the view one step in a direction.
    * - `zoom(by: number) => void`: Zooms the view one step: `1` zooms in and `-1` zooms out.
    * - `toggleFullscreen() => void`: Turns fullscreen on or off.
@@ -51431,6 +51807,8 @@ export type CustomElementsSolidJs = {
    * - `filter-mark`: The default icon beside the search field, shown when none is slotted.
    * - `footer`: The strip below the graph.
    * - `fullscreen`: The button that makes the graph fill the screen.
+   * - `gesture-hint`: Words over the graph for a moment when it lets a gesture pass to the page, such as how to zoom it.
+   * - `gesture-status`: The line shown while a graph with `gestures="activate"` has the gestures.
    * - `header`: The strip above the graph.
    * - `list`: The list of notes, which draws only the rows in view.
    * - `live`: What screen readers hear when a search changes how many notes there are.
@@ -51460,6 +51838,8 @@ export type CustomElementsSolidJs = {
    * - `fullscreen`: The graph fills the screen.
    * - `idle`: The user has been still long enough for the header and footer to fade.
    * - `ready`: The graph has been drawn whole, after `helix-graph-ready`.
+   * - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a graph with `gestures="activate"` waits to be pressed.
+   * - `using`: A graph with `gestures="activate"` has been pressed and has the gestures.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-headless-graph": Partial<
@@ -54216,26 +54596,12 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a map waiting to be pressed is scrolled or swiped
-   * over, with `gestures="activate"`.
    * - `bearing`: The map's rotation, in degrees clockwise from north. `connectMap` keeps it
    * current, and the Face north button's needle turns with it.
    * - `cluster`: Combines markers that would overlap into one count. Counts split apart as
    * the map zooms in, and pressing one zooms in to its places.
    * - `face-north-label`/`faceNorthLabel`: The Face north button's label.
    * - `flat-label`/`flatLabel`: What screen readers hear when the map is tilted back to looking straight down.
-   * - `gestures`: Which gestures the map takes from the page.
-   *
-   * - `always`, which unset is: the wheel zooms the map and one finger pans
-   *   it, for a map that is the page, such as a full-screen view.
-   * - `cooperative`: the wheel and one finger scroll the page, and the map
-   *   takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
-   *   when a gesture passes to the page. Best for a map embedded in a page.
-   * - `activate`: the map takes nothing until it is pressed, and gives it
-   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
-   *
-   * The keyboard and the frame's buttons work in every mode. The renderer is
-   * told through the connector, so MapLibre and Leaflet behave alike.
    * - `hybrid-label`/`hybridLabel`: The Hybrid map type's name.
    * - `label`: The map's name, read by screen readers. Name the place, such as "Delivery
    * area", so that several maps on one page can be told apart. Required.
@@ -54262,14 +54628,11 @@ export type CustomElementsSolidJs = {
    * - `tilt-label`/`tiltLabel`: The 3D button's label.
    * - `turned-label`/`turnedLabel`: What screen readers hear when the map is turned. `{degrees}` is the way the
    * top of the map faces, clockwise from north.
-   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a map with `gestures="cooperative"`.
-   * - `using-label`/`usingLabel`: The line shown while a map with `gestures="activate"` has the gestures.
-   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a map with
-   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-   * elsewhere, as the renderer reads it.
    * - `zoomed-label`/`zoomedLabel`: What screen readers hear after a zoom. `{level}` is the zoom level.
    * - `zoom-level`/`zoomLevel`: How far the map is zoomed, in its renderer's levels. `connectMap` keeps it
    * current, and the map says it after a zoom.
+   * - `activate-hint-label`/`activateHintLabel`: The hint shown when a surface waiting to be pressed is scrolled or
+   * swiped over, with `gestures="activate"`. Absent is the family's own.
    * - `controls`: Which controls to show, as a list such as `pan zoom fullscreen`, or
    * `none`. A family can add words of its own.
    *
@@ -54309,6 +54672,25 @@ export type CustomElementsSolidJs = {
    * resting value being an attribute's absence: a default that reflected
    * would write an attribute onto every host that no server sent.
    * - `fullscreen-label`/`fullscreenLabel`: The fullscreen button's label.
+   * - `gestures`: Which gestures the surface takes from the page.
+   *
+   * - `always`: the surface takes the wheel and one finger, for a surface
+   *   that is the page, such as a full-screen view. A map rests here.
+   * - Unset is the family's own: `always` for a map, and for a board, a
+   *   drag and a pinch, with the plain wheel left to the page until the
+   *   board fills the screen.
+   * - `cooperative`: the wheel and one finger scroll the page, and the
+   *   surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
+   *   says so when a gesture passes to the page. Best for a surface embedded
+   *   in a page.
+   * - `activate`: the surface takes nothing until it is pressed, and gives it
+   *   back on Escape, when the pointer leaves it, or on a press elsewhere.
+   *
+   * The keyboard and the frame's buttons work in every mode.
+   *
+   * **Unreflected and without a default**, because a default that reflected
+   * would write an attribute onto every host that no server sent, and the
+   * hydration that followed would disagree with it.
    * - `idle-delay`/`idleDelay`: How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
    *
    * Zero keeps it up, which is the default: these controls are how a keyboard
@@ -54330,6 +54712,13 @@ export type CustomElementsSolidJs = {
    * scale of what is inside it: a quarter of the viewport is the same gesture
    * at any zoom, and a consumer who wants their own units multiplies by them.
    * - `pan-up-label`/`panUpLabel`: The pan up button's label.
+   * - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over a surface with
+   * `gestures="cooperative"`. Absent is the family's own.
+   * - `using-label`/`usingLabel`: The line shown while a surface with `gestures="activate"` has the
+   * gestures. Absent is the family's own.
+   * - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past a surface with
+   * `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
+   * elsewhere. Absent is the family's own.
    * - `zoom-in-label`/`zoomInLabel`: The zoom in button's label.
    * - `zoom-out-label`/`zoomOutLabel`: The zoom out button's label.
    * - `ready`: Whether the map has been drawn whole, which `drawn()` says. For a page that
@@ -54463,6 +54852,7 @@ export type CustomElementsSolidJs = {
    * - `fullscreen`: The map fills the screen.
    * - `idle`: The user has been still long enough for the header and footer to fade.
    * - `ready`: The map has been drawn whole, after `helix-map-ready`.
+   * - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a map with `gestures="activate"` waits to be pressed.
    * - `using`: A map with `gestures="activate"` has been pressed and has the gestures.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */