@fusion.dev/helix 0.117.0 → 0.119.0

package/types/jsx.d.ts

@@ -83,7 +83,9 @@ import type {
   HelixFormElement,
   HelixFormatDate,
   HelixGraph,
+  HelixGraphLayoutEvent,
   HelixGraphPanEvent,
+  HelixGraphPartChangeEvent,
   HelixGraphReadyEvent,
   HelixGraphZoomEvent,
   HelixGrid,
@@ -2925,6 +2927,12 @@ Absent is no ruling, a resting value being an attribute's absence. */
 Framed is where it rests. Plain is for a board that fills a panel or an
 app's working area, where the container is already the frame. */
   separation?: (HelixCanvas["separation"]) | 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"?: (HelixCanvas["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?: (HelixCanvas["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -2989,6 +2997,26 @@ would write an attribute onto every host that no server sent. */
   "fullscreen-label"?: (HelixCanvas["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   fullscreenLabel?: (HelixCanvas["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?: (HelixCanvas["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
@@ -3043,6 +3071,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "pan-up-label"?: (HelixCanvas["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   panUpLabel?: (HelixCanvas["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"?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  twoFingerHintLabel?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "using-label"?: (HelixCanvas["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  usingLabel?: (HelixCanvas["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"?: (HelixCanvas["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?: (HelixCanvas["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "zoom-in-label"?: (HelixCanvas["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -3251,6 +3299,12 @@ Absent is no ruling, a resting value being an attribute's absence. */
 Framed is where it rests. Plain is for a board that fills a panel or an
 app's working area, where the container is already the frame. */
   "prop:separation"?: (HelixCanvas["separation"]) | 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"?: (HelixCanvas["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"?: (HelixCanvas["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -3315,6 +3369,26 @@ would write an attribute onto every host that no server sent. */
   "attr:fullscreen-label"?: (HelixCanvas["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   "prop:fullscreenLabel"?: (HelixCanvas["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"?: (HelixCanvas["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
@@ -3369,6 +3443,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "attr:pan-up-label"?: (HelixCanvas["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   "prop:panUpLabel"?: (HelixCanvas["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"?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "prop:twoFingerHintLabel"?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "attr:using-label"?: (HelixCanvas["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "prop:usingLabel"?: (HelixCanvas["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"?: (HelixCanvas["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"?: (HelixCanvas["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "attr:zoom-in-label"?: (HelixCanvas["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -11012,9 +11106,15 @@ export type HelixGraphHelixActivateElementEvent =
 /** `helix-before-activate` event type */
 export type HelixGraphHelixBeforeActivateElementEvent =
   HelixGraphElementEvent<HelixBeforeActivateEvent>;
+/** `helix-graph-layout` event type */
+export type HelixGraphHelixGraphLayoutElementEvent =
+  HelixGraphElementEvent<HelixGraphLayoutEvent>;
 /** `helix-graph-pan` event type */
 export type HelixGraphHelixGraphPanElementEvent =
   HelixGraphElementEvent<HelixGraphPanEvent>;
+/** `helix-graph-part-change` event type */
+export type HelixGraphHelixGraphPartChangeElementEvent =
+  HelixGraphElementEvent<HelixGraphPartChangeEvent>;
 /** `helix-graph-ready` event type */
 export type HelixGraphHelixGraphReadyElementEvent =
   HelixGraphElementEvent<HelixGraphReadyEvent>;
@@ -11023,6 +11123,12 @@ export type HelixGraphHelixGraphZoomElementEvent =
   HelixGraphElementEvent<HelixGraphZoomEvent>;
 
 export type HelixGraphProps = {
+  /** 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"?: (HelixGraph["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?: (HelixGraph["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -11087,6 +11193,26 @@ would write an attribute onto every host that no server sent. */
   "fullscreen-label"?: (HelixGraph["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   fullscreenLabel?: (HelixGraph["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?: (HelixGraph["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
@@ -11141,6 +11267,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "pan-up-label"?: (HelixGraph["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   panUpLabel?: (HelixGraph["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"?: (HelixGraph["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  twoFingerHintLabel?: (HelixGraph["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "using-label"?: (HelixGraph["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  usingLabel?: (HelixGraph["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"?: (HelixGraph["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?: (HelixGraph["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "zoom-in-label"?: (HelixGraph["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -11211,15 +11357,27 @@ Required. */
   "onhelix-before-activate"?: ((
     e: HelixGraphHelixBeforeActivateElementEvent,
   ) => 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: HelixGraphHelixGraphLayoutElementEvent) => void) | undefined;
+  /** A pan button or arrow key was pressed. `connectGraph` moves the drawing. */
   "onhelix-graph-pan"?: ((e: HelixGraphHelixGraphPanElementEvent) => 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: HelixGraphHelixGraphPartChangeElementEvent,
+  ) => 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: HelixGraphHelixGraphReadyElementEvent) => 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: HelixGraphHelixGraphZoomElementEvent) => void) | undefined;
 };
 
 export type HelixGraphSolidJsProps = {
+  /** 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"?: (HelixGraph["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"?: (HelixGraph["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -11284,6 +11442,26 @@ would write an attribute onto every host that no server sent. */
   "attr:fullscreen-label"?: (HelixGraph["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   "prop:fullscreenLabel"?: (HelixGraph["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"?: (HelixGraph["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
@@ -11338,6 +11516,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "attr:pan-up-label"?: (HelixGraph["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   "prop:panUpLabel"?: (HelixGraph["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"?: (HelixGraph["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "prop:twoFingerHintLabel"?: (HelixGraph["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "attr:using-label"?: (HelixGraph["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "prop:usingLabel"?: (HelixGraph["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"?: (HelixGraph["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"?: (HelixGraph["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "attr:zoom-in-label"?: (HelixGraph["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -11407,11 +11605,17 @@ Required. */
   "on:helix-before-activate"?: ((
     e: HelixGraphHelixBeforeActivateElementEvent,
   ) => 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: HelixGraphHelixGraphLayoutElementEvent) => void) | undefined;
+  /** A pan button or arrow key was pressed. `connectGraph` moves the drawing. */
   "on:helix-graph-pan"?: ((e: HelixGraphHelixGraphPanElementEvent) => 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: HelixGraphHelixGraphPartChangeElementEvent,
+  ) => 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: HelixGraphHelixGraphReadyElementEvent) => 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: HelixGraphHelixGraphZoomElementEvent) => void) | undefined;
 
   /** Set the innerHTML of the element */
@@ -14711,6 +14915,12 @@ the container's edge is the map's. */
 shows the map through a blur, `frosted` blurs more, and `transparent` has
 no background. Your theme sets how see-through each one is. */
   material?: (HelixMap["material"]) | 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"?: (HelixMap["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?: (HelixMap["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -14775,6 +14985,26 @@ would write an attribute onto every host that no server sent. */
   "fullscreen-label"?: (HelixMap["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   fullscreenLabel?: (HelixMap["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?: (HelixMap["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
@@ -14829,6 +15059,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "pan-up-label"?: (HelixMap["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   panUpLabel?: (HelixMap["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"?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  twoFingerHintLabel?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "using-label"?: (HelixMap["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  usingLabel?: (HelixMap["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"?: (HelixMap["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?: (HelixMap["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "zoom-in-label"?: (HelixMap["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -14837,12 +15087,6 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "zoom-out-label"?: (HelixMap["zoomOutLabel"]) | undefined;
   /** The zoom out button's label. */
   zoomOutLabel?: (HelixMap["zoomOutLabel"]) | undefined;
-  /** The hint shown when a map waiting to be pressed is scrolled or swiped
-over, with `gestures="activate"`. */
-  "activate-hint-label"?: (HelixMap["activateHintLabel"]) | undefined;
-  /** The hint shown when a map waiting to be pressed is scrolled or swiped
-over, with `gestures="activate"`. */
-  activateHintLabel?: (HelixMap["activateHintLabel"]) | undefined;
   /** The map's rotation, in degrees clockwise from north. `connectMap` keeps it
 current, and the Face north button's needle turns with it. */
   bearing?: (HelixMap["bearing"]) | undefined;
@@ -14857,19 +15101,6 @@ the map zooms in, and pressing one zooms in to its places. */
   "flat-label"?: (HelixMap["flatLabel"]) | undefined;
   /** What screen readers hear when the map is tilted back to looking straight down. */
   flatLabel?: (HelixMap["flatLabel"]) | undefined;
-  /** Which gestures the map takes from the page.
-
-- `always`, which unset is: the wheel zooms the map and one finger pans
-  it, for a map that is the page, such as a full-screen view.
-- `cooperative`: the wheel and one finger scroll the page, and the map
-  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
-  when a gesture passes to the page. Best for a map embedded in a page.
-- `activate`: the map takes nothing until it is pressed, and gives it
-  back on Escape, when the pointer leaves it, or on a press elsewhere.
-
-The keyboard and the frame's buttons work in every mode. The renderer is
-told through the connector, so MapLibre and Leaflet behave alike. */
-  gestures?: (HelixMap["gestures"]) | undefined;
   /** The Hybrid map type's name. */
   "hybrid-label"?: (HelixMap["hybridLabel"]) | undefined;
   /** The Hybrid map type's name. */
@@ -14951,22 +15182,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?: (HelixMap["turnedLabel"]) | undefined;
-  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
-  "two-finger-hint-label"?: (HelixMap["twoFingerHintLabel"]) | undefined;
-  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
-  twoFingerHintLabel?: (HelixMap["twoFingerHintLabel"]) | undefined;
-  /** The line shown while a map with `gestures="activate"` has the gestures. */
-  "using-label"?: (HelixMap["usingLabel"]) | undefined;
-  /** The line shown while a map with `gestures="activate"` has the gestures. */
-  usingLabel?: (HelixMap["usingLabel"]) | undefined;
-  /** The hint shown when the wheel scrolls past a map with
-`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-elsewhere, as the renderer reads it. */
-  "wheel-hint-label"?: (HelixMap["wheelHintLabel"]) | undefined;
-  /** The hint shown when the wheel scrolls past a map with
-`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-elsewhere, as the renderer reads it. */
-  wheelHintLabel?: (HelixMap["wheelHintLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
   "zoomed-label"?: (HelixMap["zoomedLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
@@ -15020,6 +15235,12 @@ the container's edge is the map's. */
 shows the map through a blur, `frosted` blurs more, and `transparent` has
 no background. Your theme sets how see-through each one is. */
   "prop:material"?: (HelixMap["material"]) | 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"?: (HelixMap["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"?: (HelixMap["activateHintLabel"]) | undefined;
   /** Which controls to show, as a list such as `pan zoom fullscreen`, or
 `none`. A family can add words of its own.
 
@@ -15084,6 +15305,26 @@ would write an attribute onto every host that no server sent. */
   "attr:fullscreen-label"?: (HelixMap["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
   "prop:fullscreenLabel"?: (HelixMap["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"?: (HelixMap["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
@@ -15138,6 +15379,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "attr:pan-up-label"?: (HelixMap["panUpLabel"]) | undefined;
   /** The pan up button's label. */
   "prop:panUpLabel"?: (HelixMap["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"?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The hint shown when one finger swipes over a surface with
+`gestures="cooperative"`. Absent is the family's own. */
+  "prop:twoFingerHintLabel"?: (HelixMap["twoFingerHintLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "attr:using-label"?: (HelixMap["usingLabel"]) | undefined;
+  /** The line shown while a surface with `gestures="activate"` has the
+gestures. Absent is the family's own. */
+  "prop:usingLabel"?: (HelixMap["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"?: (HelixMap["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"?: (HelixMap["wheelHintLabel"]) | undefined;
   /** The zoom in button's label. */
   "attr:zoom-in-label"?: (HelixMap["zoomInLabel"]) | undefined;
   /** The zoom in button's label. */
@@ -15146,12 +15407,6 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
   "attr:zoom-out-label"?: (HelixMap["zoomOutLabel"]) | undefined;
   /** The zoom out button's label. */
   "prop:zoomOutLabel"?: (HelixMap["zoomOutLabel"]) | undefined;
-  /** The hint shown when a map waiting to be pressed is scrolled or swiped
-over, with `gestures="activate"`. */
-  "attr:activate-hint-label"?: (HelixMap["activateHintLabel"]) | undefined;
-  /** The hint shown when a map waiting to be pressed is scrolled or swiped
-over, with `gestures="activate"`. */
-  "prop:activateHintLabel"?: (HelixMap["activateHintLabel"]) | undefined;
   /** The map's rotation, in degrees clockwise from north. `connectMap` keeps it
 current, and the Face north button's needle turns with it. */
   "prop:bearing"?: (HelixMap["bearing"]) | undefined;
@@ -15166,19 +15421,6 @@ the map zooms in, and pressing one zooms in to its places. */
   "attr:flat-label"?: (HelixMap["flatLabel"]) | undefined;
   /** What screen readers hear when the map is tilted back to looking straight down. */
   "prop:flatLabel"?: (HelixMap["flatLabel"]) | undefined;
-  /** Which gestures the map takes from the page.
-
-- `always`, which unset is: the wheel zooms the map and one finger pans
-  it, for a map that is the page, such as a full-screen view.
-- `cooperative`: the wheel and one finger scroll the page, and the map
-  takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
-  when a gesture passes to the page. Best for a map embedded in a page.
-- `activate`: the map takes nothing until it is pressed, and gives it
-  back on Escape, when the pointer leaves it, or on a press elsewhere.
-
-The keyboard and the frame's buttons work in every mode. The renderer is
-told through the connector, so MapLibre and Leaflet behave alike. */
-  "prop:gestures"?: (HelixMap["gestures"]) | undefined;
   /** The Hybrid map type's name. */
   "attr:hybrid-label"?: (HelixMap["hybridLabel"]) | undefined;
   /** The Hybrid map type's name. */
@@ -15260,22 +15502,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"?: (HelixMap["turnedLabel"]) | undefined;
-  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
-  "attr:two-finger-hint-label"?: (HelixMap["twoFingerHintLabel"]) | undefined;
-  /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
-  "prop:twoFingerHintLabel"?: (HelixMap["twoFingerHintLabel"]) | undefined;
-  /** The line shown while a map with `gestures="activate"` has the gestures. */
-  "attr:using-label"?: (HelixMap["usingLabel"]) | undefined;
-  /** The line shown while a map with `gestures="activate"` has the gestures. */
-  "prop:usingLabel"?: (HelixMap["usingLabel"]) | undefined;
-  /** The hint shown when the wheel scrolls past a map with
-`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-elsewhere, as the renderer reads it. */
-  "attr:wheel-hint-label"?: (HelixMap["wheelHintLabel"]) | undefined;
-  /** The hint shown when the wheel scrolls past a map with
-`gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
-elsewhere, as the renderer reads it. */
-  "prop:wheelHintLabel"?: (HelixMap["wheelHintLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
   "attr:zoomed-label"?: (HelixMap["zoomedLabel"]) | undefined;
   /** What screen readers hear after a zoom. `{level}` is the zoom level. */
@@ -29162,6 +29388,8 @@ export type CustomElements = {
    *
    * Framed is where it rests. Plain is for a board that fills a panel or an
    * app's working area, where the container is already the frame.
+   * - `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.
    *
@@ -29201,6 +29429,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
@@ -29222,6 +29469,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.
    * - `comes-from-label`/`comesFromLabel`: The text read with a card to say where its connections come from, with `{cards}`.
@@ -29410,6 +29664,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.
@@ -29435,6 +29691,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-canvas": Partial<
@@ -35218,6 +35476,8 @@ 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 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.
    *
@@ -35257,6 +35517,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
@@ -35278,6 +35557,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.
@@ -35332,9 +35618,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
    *
@@ -35361,10 +35649,14 @@ export type CustomElements = {
    * whether or not a consumer declared `active`, a declared property being a
    * seed and a correction.
    * - `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.
    *
    * ## CSS Custom Properties
    *
@@ -35389,6 +35681,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.
@@ -35418,6 +35712,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-graph": Partial<HelixGraphProps & BaseProps<HelixGraph> & BaseEvents<HelixGraph>>;
@@ -38345,6 +38641,8 @@ export type CustomElements = {
    * - `material`: The background of the pan and zoom buttons. Leave unset for solid. `glass`
    * shows the map through a blur, `frosted` blurs more, and `transparent` has
    * no background. Your theme sets how see-through each one is.
+   * - `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.
    *
@@ -38384,6 +38682,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
@@ -38405,28 +38722,21 @@ 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.
-   * - `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.
@@ -38453,11 +38763,6 @@ 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.
@@ -38596,6 +38901,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.
    */
@@ -51261,6 +51567,8 @@ export type CustomElementsSolidJs = {
    *
    * Framed is where it rests. Plain is for a board that fills a panel or an
    * app's working area, where the container is already the frame.
+   * - `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.
    *
@@ -51300,6 +51608,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
@@ -51321,6 +51648,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.
    * - `comes-from-label`/`comesFromLabel`: The text read with a card to say where its connections come from, with `{cards}`.
@@ -51509,6 +51843,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.
@@ -51534,6 +51870,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-canvas": Partial<
@@ -57418,6 +57756,8 @@ 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 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.
    *
@@ -57457,6 +57797,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
@@ -57478,6 +57837,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.
@@ -57532,9 +57898,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
    *
@@ -57561,10 +57929,14 @@ export type CustomElementsSolidJs = {
    * whether or not a consumer declared `active`, a declared property being a
    * seed and a correction.
    * - `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.
    *
    * ## CSS Custom Properties
    *
@@ -57589,6 +57961,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.
@@ -57618,6 +57992,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-graph": Partial<
@@ -60619,6 +60995,8 @@ export type CustomElementsSolidJs = {
    * - `material`: The background of the pan and zoom buttons. Leave unset for solid. `glass`
    * shows the map through a blur, `frosted` blurs more, and `transparent` has
    * no background. Your theme sets how see-through each one is.
+   * - `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.
    *
@@ -60658,6 +61036,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
@@ -60679,28 +61076,21 @@ 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.
-   * - `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.
@@ -60727,11 +61117,6 @@ 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.
@@ -60870,6 +61255,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.
    */