@fusion.dev/helix-headless 0.116.0 → 0.118.0

package/types/jsx.d.ts

@@ -36,6 +36,11 @@ import type {
   HelixFacetEvent,
   HelixFilterEvent,
   HelixFormElement,
+  HelixGraphLayoutEvent,
+  HelixGraphPanEvent,
+  HelixGraphPartChangeEvent,
+  HelixGraphReadyEvent,
+  HelixGraphZoomEvent,
   HelixHeadlessAccordion,
   HelixHeadlessAccordionItem,
   HelixHeadlessAnnouncement,
@@ -87,6 +92,7 @@ import type {
   HelixHeadlessFilterMenu,
   HelixHeadlessFilterOperator,
   HelixHeadlessFormatDate,
+  HelixHeadlessGraph,
   HelixHeadlessHeatmap,
   HelixHeadlessIcon,
   HelixHeadlessIconButton,
@@ -2261,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.
 
@@ -2325,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
@@ -2379,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. */
@@ -2579,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.
 
@@ -2643,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
@@ -2697,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. */
@@ -9265,6 +9363,553 @@ Empty is the runtime's own. */
   textContent?: (string | number) | undefined;
 };
 
+/** `HelixHeadlessGraph` component event */
+export type HelixHeadlessGraphElementEvent<E = Event> = TypedEvent<
+  HelixHeadlessGraph,
+  E
+>;
+/** `helix-activate` event type */
+export type HelixHeadlessGraphHelixActivateElementEvent =
+  HelixHeadlessGraphElementEvent<HelixActivateEvent>;
+/** `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>;
+/** `helix-graph-zoom` event type */
+export type HelixHeadlessGraphHelixGraphZoomElementEvent =
+  HelixHeadlessGraphElementEvent<HelixGraphZoomEvent>;
+
+export type HelixHeadlessGraphProps = {
+  /** What the list says of a note's count, with `{count}`. */
+  "count-label"?: (HelixHeadlessGraph["countLabel"]) | undefined;
+  /** What the list says of a note's count, with `{count}`. */
+  countLabel?: (HelixHeadlessGraph["countLabel"]) | undefined;
+  /** How many links from the selected note to show, for its local graph. Unset
+shows every note. The list holds what the drawing shows. */
+  depth?: (HelixHeadlessGraph["depth"]) | undefined;
+  /** The graph's name, read by screen readers, such as "Research notes".
+Required. */
+  label?: (HelixHeadlessGraph["label"]) | undefined;
+  /** How a note linked both to and from the selected one is described, with `{note}`. */
+  "linked-both-label"?: (HelixHeadlessGraph["linkedBothLabel"]) | undefined;
+  /** How a note linked both to and from the selected one is described, with `{note}`. */
+  linkedBothLabel?: (HelixHeadlessGraph["linkedBothLabel"]) | undefined;
+  /** How a note the selected one links to is described, with `{note}`, the selected note's name. */
+  "linked-from-label"?: (HelixHeadlessGraph["linkedFromLabel"]) | undefined;
+  /** How a note the selected one links to is described, with `{note}`, the selected note's name. */
+  linkedFromLabel?: (HelixHeadlessGraph["linkedFromLabel"]) | undefined;
+  /** How a note that links to the selected one is described, with `{note}`. */
+  "links-to-label"?: (HelixHeadlessGraph["linksToLabel"]) | undefined;
+  /** How a note that links to the selected one is described, with `{note}`. */
+  linksToLabel?: (HelixHeadlessGraph["linksToLabel"]) | undefined;
+  /** The list's name, read by screen readers. */
+  "notes-label"?: (HelixHeadlessGraph["notesLabel"]) | undefined;
+  /** The list's name, read by screen readers. */
+  notesLabel?: (HelixHeadlessGraph["notesLabel"]) | undefined;
+  /** The search field's name. */
+  "search-label"?: (HelixHeadlessGraph["searchLabel"]) | undefined;
+  /** The search field's name. */
+  searchLabel?: (HelixHeadlessGraph["searchLabel"]) | undefined;
+  /** How the selected note is described in the list. */
+  "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.
+
+**A list rather than a switch, because the overlap is not symmetric.** A
+surface a consumer brings often has zoom controls of its own and almost
+never has pan buttons, so a single switch would make them choose between
+a duplicate and nothing.
+
+`none` draws none of them, which is the right answer where what was
+slotted already has controls a reader can find: what this argues for is
+that *a* findable control exists, never that it is ours. The methods stay
+public either way, so a consumer drawing their own chrome can still drive
+the surface.
+
+Absent is whatever the family rests at, which is this library's rule that
+a resting value is an attribute's absence: zoom, the compass and
+fullscreen for a map, whose pan buttons a page asks for, and zoom and
+fullscreen for a board, which a reader drags and whose pad took a third
+of the frame. The
+stylesheet lays the cluster out by which buttons are in it rather than by
+this attribute, so the two defaults need no rule each. */
+  controls?: (HelixHeadlessGraph["controls"]) | undefined;
+  /** The name of the group of controls, read by screen readers.
+
+Absent is the family's own name for it, "Map controls" or "Board
+controls", which names what the controls drive rather than the
+mechanism. Written here to say it in another language, which every other
+string this surface speaks already allowed and this one did not. */
+  "controls-label"?: (HelixHeadlessGraph["controlsLabel"]) | undefined;
+  /** The name of the group of controls, read by screen readers.
+
+Absent is the family's own name for it, "Map controls" or "Board
+controls", which names what the controls drive rather than the
+mechanism. Written here to say it in another language, which every other
+string this surface speaks already allowed and this one did not. */
+  controlsLabel?: (HelixHeadlessGraph["controlsLabel"]) | undefined;
+  /** Which corner the controls sit in.
+
+**Configurable because there is no safe default**, which is a collision
+rather than a taste: whatever a consumer slots may put its own controls
+in any corner, and every library that draws some made this a setting for
+the same reason.
+
+Logical corners rather than left and right, so a right-to-left page moves
+them without a consumer writing a second rule. Absent is the top end, a
+resting value being an attribute's absence: a default that reflected
+would write an attribute onto every host that no server sent. */
+  "controls-placement"?: (HelixHeadlessGraph["controlsPlacement"]) | undefined;
+  /** Which corner the controls sit in.
+
+**Configurable because there is no safe default**, which is a collision
+rather than a taste: whatever a consumer slots may put its own controls
+in any corner, and every library that draws some made this a setting for
+the same reason.
+
+Logical corners rather than left and right, so a right-to-left page moves
+them without a consumer writing a second rule. Absent is the top end, a
+resting value being an attribute's absence: a default that reflected
+would write an attribute onto every host that no server sent. */
+  controlsPlacement?: (HelixHeadlessGraph["controlsPlacement"]) | undefined;
+  /** The fullscreen button's label. */
+  "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
+reader operates the surface, and chrome that hid itself by default would
+be the component undoing its own argument. Set it for a display nobody
+drives. */
+  "idle-delay"?: (HelixHeadlessGraph["idleDelay"] | `${number}`) | 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
+reader operates the surface, and chrome that hid itself by default would
+be the component undoing its own argument. Set it for a display nobody
+drives. */
+  idleDelay?: (HelixHeadlessGraph["idleDelay"]) | undefined;
+  /** The pan down button's label.
+
+**A label for each way rather than one with the way filled in**, which is
+what this was: `Pan {way}` filled in with `left`, so a page that said it
+in French read out "Déplacer left". The word for a direction is as much
+the translator's as the word for panning, and a language can put it
+anywhere in the phrase. */
+  "pan-down-label"?: (HelixHeadlessGraph["panDownLabel"]) | undefined;
+  /** The pan down button's label.
+
+**A label for each way rather than one with the way filled in**, which is
+what this was: `Pan {way}` filled in with `left`, so a page that said it
+in French read out "Déplacer left". The word for a direction is as much
+the translator's as the word for panning, and a language can put it
+anywhere in the phrase. */
+  panDownLabel?: (HelixHeadlessGraph["panDownLabel"]) | undefined;
+  /** The pan left button's label. */
+  "pan-left-label"?: (HelixHeadlessGraph["panLeftLabel"]) | undefined;
+  /** The pan left button's label. */
+  panLeftLabel?: (HelixHeadlessGraph["panLeftLabel"]) | undefined;
+  /** The pan right button's label. */
+  "pan-right-label"?: (HelixHeadlessGraph["panRightLabel"]) | undefined;
+  /** The pan right button's label. */
+  panRightLabel?: (HelixHeadlessGraph["panRightLabel"]) | undefined;
+  /** How far one press pans the view, as a fraction of its size.
+
+A fraction rather than a distance, because this surface does not know the
+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-step"?: (HelixHeadlessGraph["panStep"] | `${number}`) | undefined;
+  /** How far one press pans the view, as a fraction of its size.
+
+A fraction rather than a distance, because this surface does not know the
+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. */
+  panStep?: (HelixHeadlessGraph["panStep"]) | undefined;
+  /** The pan up button's label. */
+  "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. */
+  zoomInLabel?: (HelixHeadlessGraph["zoomInLabel"]) | undefined;
+  /** The zoom out button's label. */
+  "zoom-out-label"?: (HelixHeadlessGraph["zoomOutLabel"]) | undefined;
+  /** The zoom out button's label. */
+  zoomOutLabel?: (HelixHeadlessGraph["zoomOutLabel"]) | undefined;
+  /** The `value` of the current item.
+
+Not `option.active`, which is the option the keyboard is on: that is a
+different question from which one is chosen.
+
+Writing always applies, so `<helix-tabs active="one">` starts on that
+tab, and `default-active` is how markup says where to start without
+naming the current one. */
+  active?: (HelixHeadlessGraph["active"]) | undefined;
+  /** The `value` of the item declared current in markup.
+
+Ignored once `active` is written. */
+  "default-active"?: (HelixHeadlessGraph["defaultActive"]) | undefined;
+  /** The `value` of the item declared current in markup.
+
+Ignored once `active` is written. */
+  defaultActive?: (HelixHeadlessGraph["defaultActive"]) | undefined;
+  /** The links between notes, each from `source` to `target`. A property, never an attribute. */
+  links?: (HelixHeadlessGraph["links"]) | undefined;
+  /** The notes. A property, never an attribute. */
+  nodes?: (HelixHeadlessGraph["nodes"]) | undefined;
+
+  /** A note was selected, in the list or in the drawing. The detail's `value` is its `id`. */
+  "onhelix-activate"?: ((e: HelixHeadlessGraphHelixActivateElementEvent) => void) | undefined;
+  /** A note is about to be selected. Cancelable: cancel it to keep the selection in your own state. */
+  "onhelix-before-activate"?: ((
+    e: HelixHeadlessGraphHelixBeforeActivateElementEvent,
+  ) => void) | undefined;
+  /** 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. `connectGraph` zooms the drawing. */
+  "onhelix-graph-zoom"?: ((
+    e: HelixHeadlessGraphHelixGraphZoomElementEvent,
+  ) => void) | undefined;
+};
+
+export type HelixHeadlessGraphSolidJsProps = {
+  /** What the list says of a note's count, with `{count}`. */
+  "attr:count-label"?: (HelixHeadlessGraph["countLabel"]) | undefined;
+  /** What the list says of a note's count, with `{count}`. */
+  "prop:countLabel"?: (HelixHeadlessGraph["countLabel"]) | undefined;
+  /** How many links from the selected note to show, for its local graph. Unset
+shows every note. The list holds what the drawing shows. */
+  "prop:depth"?: (HelixHeadlessGraph["depth"]) | undefined;
+  /** The graph's name, read by screen readers, such as "Research notes".
+Required. */
+  "prop:label"?: (HelixHeadlessGraph["label"]) | undefined;
+  /** How a note linked both to and from the selected one is described, with `{note}`. */
+  "attr:linked-both-label"?: (HelixHeadlessGraph["linkedBothLabel"]) | undefined;
+  /** How a note linked both to and from the selected one is described, with `{note}`. */
+  "prop:linkedBothLabel"?: (HelixHeadlessGraph["linkedBothLabel"]) | undefined;
+  /** How a note the selected one links to is described, with `{note}`, the selected note's name. */
+  "attr:linked-from-label"?: (HelixHeadlessGraph["linkedFromLabel"]) | undefined;
+  /** How a note the selected one links to is described, with `{note}`, the selected note's name. */
+  "prop:linkedFromLabel"?: (HelixHeadlessGraph["linkedFromLabel"]) | undefined;
+  /** How a note that links to the selected one is described, with `{note}`. */
+  "attr:links-to-label"?: (HelixHeadlessGraph["linksToLabel"]) | undefined;
+  /** How a note that links to the selected one is described, with `{note}`. */
+  "prop:linksToLabel"?: (HelixHeadlessGraph["linksToLabel"]) | undefined;
+  /** The list's name, read by screen readers. */
+  "attr:notes-label"?: (HelixHeadlessGraph["notesLabel"]) | undefined;
+  /** The list's name, read by screen readers. */
+  "prop:notesLabel"?: (HelixHeadlessGraph["notesLabel"]) | undefined;
+  /** The search field's name. */
+  "attr:search-label"?: (HelixHeadlessGraph["searchLabel"]) | undefined;
+  /** The search field's name. */
+  "prop:searchLabel"?: (HelixHeadlessGraph["searchLabel"]) | undefined;
+  /** How the selected note is described in the list. */
+  "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.
+
+**A list rather than a switch, because the overlap is not symmetric.** A
+surface a consumer brings often has zoom controls of its own and almost
+never has pan buttons, so a single switch would make them choose between
+a duplicate and nothing.
+
+`none` draws none of them, which is the right answer where what was
+slotted already has controls a reader can find: what this argues for is
+that *a* findable control exists, never that it is ours. The methods stay
+public either way, so a consumer drawing their own chrome can still drive
+the surface.
+
+Absent is whatever the family rests at, which is this library's rule that
+a resting value is an attribute's absence: zoom, the compass and
+fullscreen for a map, whose pan buttons a page asks for, and zoom and
+fullscreen for a board, which a reader drags and whose pad took a third
+of the frame. The
+stylesheet lays the cluster out by which buttons are in it rather than by
+this attribute, so the two defaults need no rule each. */
+  "prop:controls"?: (HelixHeadlessGraph["controls"]) | undefined;
+  /** The name of the group of controls, read by screen readers.
+
+Absent is the family's own name for it, "Map controls" or "Board
+controls", which names what the controls drive rather than the
+mechanism. Written here to say it in another language, which every other
+string this surface speaks already allowed and this one did not. */
+  "attr:controls-label"?: (HelixHeadlessGraph["controlsLabel"]) | undefined;
+  /** The name of the group of controls, read by screen readers.
+
+Absent is the family's own name for it, "Map controls" or "Board
+controls", which names what the controls drive rather than the
+mechanism. Written here to say it in another language, which every other
+string this surface speaks already allowed and this one did not. */
+  "prop:controlsLabel"?: (HelixHeadlessGraph["controlsLabel"]) | undefined;
+  /** Which corner the controls sit in.
+
+**Configurable because there is no safe default**, which is a collision
+rather than a taste: whatever a consumer slots may put its own controls
+in any corner, and every library that draws some made this a setting for
+the same reason.
+
+Logical corners rather than left and right, so a right-to-left page moves
+them without a consumer writing a second rule. Absent is the top end, a
+resting value being an attribute's absence: a default that reflected
+would write an attribute onto every host that no server sent. */
+  "attr:controls-placement"?: (HelixHeadlessGraph["controlsPlacement"]) | undefined;
+  /** Which corner the controls sit in.
+
+**Configurable because there is no safe default**, which is a collision
+rather than a taste: whatever a consumer slots may put its own controls
+in any corner, and every library that draws some made this a setting for
+the same reason.
+
+Logical corners rather than left and right, so a right-to-left page moves
+them without a consumer writing a second rule. Absent is the top end, a
+resting value being an attribute's absence: a default that reflected
+would write an attribute onto every host that no server sent. */
+  "prop:controlsPlacement"?: (HelixHeadlessGraph["controlsPlacement"]) | undefined;
+  /** The fullscreen button's label. */
+  "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
+reader operates the surface, and chrome that hid itself by default would
+be the component undoing its own argument. Set it for a display nobody
+drives. */
+  "attr:idle-delay"?: (HelixHeadlessGraph["idleDelay"] | `${number}`) | 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
+reader operates the surface, and chrome that hid itself by default would
+be the component undoing its own argument. Set it for a display nobody
+drives. */
+  "prop:idleDelay"?: (HelixHeadlessGraph["idleDelay"]) | undefined;
+  /** The pan down button's label.
+
+**A label for each way rather than one with the way filled in**, which is
+what this was: `Pan {way}` filled in with `left`, so a page that said it
+in French read out "Déplacer left". The word for a direction is as much
+the translator's as the word for panning, and a language can put it
+anywhere in the phrase. */
+  "attr:pan-down-label"?: (HelixHeadlessGraph["panDownLabel"]) | undefined;
+  /** The pan down button's label.
+
+**A label for each way rather than one with the way filled in**, which is
+what this was: `Pan {way}` filled in with `left`, so a page that said it
+in French read out "Déplacer left". The word for a direction is as much
+the translator's as the word for panning, and a language can put it
+anywhere in the phrase. */
+  "prop:panDownLabel"?: (HelixHeadlessGraph["panDownLabel"]) | undefined;
+  /** The pan left button's label. */
+  "attr:pan-left-label"?: (HelixHeadlessGraph["panLeftLabel"]) | undefined;
+  /** The pan left button's label. */
+  "prop:panLeftLabel"?: (HelixHeadlessGraph["panLeftLabel"]) | undefined;
+  /** The pan right button's label. */
+  "attr:pan-right-label"?: (HelixHeadlessGraph["panRightLabel"]) | undefined;
+  /** The pan right button's label. */
+  "prop:panRightLabel"?: (HelixHeadlessGraph["panRightLabel"]) | undefined;
+  /** How far one press pans the view, as a fraction of its size.
+
+A fraction rather than a distance, because this surface does not know the
+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. */
+  "attr:pan-step"?: (HelixHeadlessGraph["panStep"] | `${number}`) | undefined;
+  /** How far one press pans the view, as a fraction of its size.
+
+A fraction rather than a distance, because this surface does not know the
+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. */
+  "prop:panStep"?: (HelixHeadlessGraph["panStep"]) | undefined;
+  /** The pan up button's label. */
+  "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. */
+  "prop:zoomInLabel"?: (HelixHeadlessGraph["zoomInLabel"]) | undefined;
+  /** The zoom out button's label. */
+  "attr:zoom-out-label"?: (HelixHeadlessGraph["zoomOutLabel"]) | undefined;
+  /** The zoom out button's label. */
+  "prop:zoomOutLabel"?: (HelixHeadlessGraph["zoomOutLabel"]) | undefined;
+  /** The `value` of the current item.
+
+Not `option.active`, which is the option the keyboard is on: that is a
+different question from which one is chosen.
+
+Writing always applies, so `<helix-tabs active="one">` starts on that
+tab, and `default-active` is how markup says where to start without
+naming the current one. */
+  "prop:active"?: (HelixHeadlessGraph["active"]) | undefined;
+  /** The `value` of the item declared current in markup.
+
+Ignored once `active` is written. */
+  "attr:default-active"?: (HelixHeadlessGraph["defaultActive"]) | undefined;
+  /** The `value` of the item declared current in markup.
+
+Ignored once `active` is written. */
+  "prop:defaultActive"?: (HelixHeadlessGraph["defaultActive"]) | undefined;
+  /** The links between notes, each from `source` to `target`. A property, never an attribute. */
+  "prop:links"?: (HelixHeadlessGraph["links"]) | undefined;
+  /** The notes. A property, never an attribute. */
+  "prop:nodes"?: (HelixHeadlessGraph["nodes"]) | undefined;
+  /** A note was selected, in the list or in the drawing. The detail's `value` is its `id`. */
+  "on:helix-activate"?: ((
+    e: HelixHeadlessGraphHelixActivateElementEvent,
+  ) => void) | undefined;
+  /** A note is about to be selected. Cancelable: cancel it to keep the selection in your own state. */
+  "on:helix-before-activate"?: ((
+    e: HelixHeadlessGraphHelixBeforeActivateElementEvent,
+  ) => void) | undefined;
+  /** 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. `connectGraph` zooms the drawing. */
+  "on:helix-graph-zoom"?: ((
+    e: HelixHeadlessGraphHelixGraphZoomElementEvent,
+  ) => void) | undefined;
+
+  /** Set the innerHTML of the element */
+  innerHTML?: (string) | undefined;
+  /** Set the textContent of the element */
+  textContent?: (string | number) | undefined;
+};
+
 /** `HelixHeadlessHeatmap` component event */
 export type HelixHeadlessHeatmapElementEvent<E = Event> = TypedEvent<
   HelixHeadlessHeatmap,
@@ -12068,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;
@@ -12088,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. */
@@ -12182,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. */
@@ -12208,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.
 
@@ -12272,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
@@ -12326,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. */
@@ -12360,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;
@@ -12380,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. */
@@ -12474,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. */
@@ -12500,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.
 
@@ -12564,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
@@ -12618,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. */
@@ -24816,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.
    *
@@ -24855,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
@@ -24876,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,
@@ -24992,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.
@@ -25017,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<
@@ -30518,6 +31217,267 @@ export type CustomElements = {
       BaseEvents<HelixHeadlessFormatDate>
   >;
 
+  /**
+   * 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, 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
+   * find a note for anyone. The selected note comes first, then the notes it
+   * links to and from, then every other note, and the search field narrows it.
+   * Selecting a note in the list or in the drawing is the same selection.
+   *
+   * Set `depth` to show the local graph: only the notes within that many links
+   * of the selected one.
+   *
+   * `nodes` and `links` are properties, never markup: a graph of ten thousand
+   * notes as ten thousand elements would cost what the renderer exists to save.
+   * The list draws only the rows in view.
+   *
+   * The list scrolls on this tier. It carries `data-scroller`, and `core` ships
+   * `[data-scroller] { overflow: auto }` into every shadow root. You still need
+   * to set a block size on the list, or it grows to hold every row.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `count-label`/`countLabel`: What the list says of a note's count, with `{count}`.
+   * - `depth`: How many links from the selected note to show, for its local graph. Unset
+   * shows every note. The list holds what the drawing shows.
+   * - `label`: The graph's name, read by screen readers, such as "Research notes".
+   * Required.
+   * - `linked-both-label`/`linkedBothLabel`: How a note linked both to and from the selected one is described, with `{note}`.
+   * - `linked-from-label`/`linkedFromLabel`: How a note the selected one links to is described, with `{note}`, the selected note's name.
+   * - `links-to-label`/`linksToLabel`: How a note that links to the selected one is described, with `{note}`.
+   * - `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.
+   *
+   * **A list rather than a switch, because the overlap is not symmetric.** A
+   * surface a consumer brings often has zoom controls of its own and almost
+   * never has pan buttons, so a single switch would make them choose between
+   * a duplicate and nothing.
+   *
+   * `none` draws none of them, which is the right answer where what was
+   * slotted already has controls a reader can find: what this argues for is
+   * that *a* findable control exists, never that it is ours. The methods stay
+   * public either way, so a consumer drawing their own chrome can still drive
+   * the surface.
+   *
+   * Absent is whatever the family rests at, which is this library's rule that
+   * a resting value is an attribute's absence: zoom, the compass and
+   * fullscreen for a map, whose pan buttons a page asks for, and zoom and
+   * fullscreen for a board, which a reader drags and whose pad took a third
+   * of the frame. The
+   * stylesheet lays the cluster out by which buttons are in it rather than by
+   * this attribute, so the two defaults need no rule each.
+   * - `controls-label`/`controlsLabel`: The name of the group of controls, read by screen readers.
+   *
+   * Absent is the family's own name for it, "Map controls" or "Board
+   * controls", which names what the controls drive rather than the
+   * mechanism. Written here to say it in another language, which every other
+   * string this surface speaks already allowed and this one did not.
+   * - `controls-placement`/`controlsPlacement`: Which corner the controls sit in.
+   *
+   * **Configurable because there is no safe default**, which is a collision
+   * rather than a taste: whatever a consumer slots may put its own controls
+   * in any corner, and every library that draws some made this a setting for
+   * the same reason.
+   *
+   * Logical corners rather than left and right, so a right-to-left page moves
+   * them without a consumer writing a second rule. Absent is the top end, a
+   * 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
+   * reader operates the surface, and chrome that hid itself by default would
+   * be the component undoing its own argument. Set it for a display nobody
+   * drives.
+   * - `pan-down-label`/`panDownLabel`: The pan down button's label.
+   *
+   * **A label for each way rather than one with the way filled in**, which is
+   * what this was: `Pan {way}` filled in with `left`, so a page that said it
+   * in French read out "Déplacer left". The word for a direction is as much
+   * the translator's as the word for panning, and a language can put it
+   * anywhere in the phrase.
+   * - `pan-left-label`/`panLeftLabel`: The pan left button's label.
+   * - `pan-right-label`/`panRightLabel`: The pan right button's label.
+   * - `pan-step`/`panStep`: How far one press pans the view, as a fraction of its size.
+   *
+   * A fraction rather than a distance, because this surface does not know the
+   * 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.
+   *
+   * Not `option.active`, which is the option the keyboard is on: that is a
+   * different question from which one is chosen.
+   *
+   * Writing always applies, so `<helix-tabs active="one">` starts on that
+   * tab, and `default-active` is how markup says where to start without
+   * naming the current one.
+   * - `default-active`/`defaultActive`: The `value` of the item declared current in markup.
+   *
+   * Ignored once `active` is written.
+   * - `links`: The links between notes, each from `source` to `target`. A property, never an attribute. (property only)
+   * - `nodes`: The notes. A property, never an attribute. (property only)
+   * - `ready`: Whether the graph has been drawn whole. For code that runs after `helix-graph-ready`. (property only) (readonly)
+   * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
+   *
+   * **Named `whenSettled` because `settled` is taken four times over**, by
+   * Image, Splitter and both color controls, none of them about transitions. A
+   * base class takes the name every subclass then cannot use.
+   *
+   * **The state it reports cannot be watched, which is why this exists.** A
+   * custom state is deliberately not in the DOM, so there is no
+   * `MutationObserver` equivalent for `ElementInternals.states`. Await this
+   * instead.
+   *
+   * Separate from `updateComplete`, which resolves in the microtask checkpoint
+   * the suppression is still active in. That is the distinction `readyToMove`
+   * in `@fusion.dev/helix-testing` is written around.
+   *
+   * It never resolves where `requestAnimationFrame` never fires, which is a
+   * server, a hidden tab, and happy-dom. Callers that must not hang there race
+   * it against a timeout, as the happy-dom harness's `readyToMove` does. The
+   * browser harness's awaits it alone: a browser always runs the frame, and a
+   * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
+   *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `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-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. `connectGraph` zooms the drawing.
+   *
+   * ## Slots
+   *
+   * Areas where markup can be added to the component.
+   *
+   * - `(default)`: The renderer's box, which the drawing is made in.
+   * - `filter-icon`: The icon in the search field. Defaults to a magnifying glass.
+   * - `footer`: Content below the graph.
+   * - `header`: Content above the graph.
+   *
+   * ## Methods
+   *
+   * 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. 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.
+   * - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
+   *
+   * Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
+   * a refusal and nothing moves. Unlike a native control, nothing has moved
+   * by the time this runs, so refusing is simply not writing: there is
+   * nothing to put back. Nobody refusing means the set updates itself,
+   * whether or not a consumer declared `active`, a declared property being a
+   * seed and a correction.
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `after`: The room the notes after those drawn would take, so the list scrolls its whole length.
+   * - `before`: The room the notes before those drawn would take.
+   * - `body`: The drawing beside the list, or above it where the frame is narrow.
+   * - `controls`: The group the pan and zoom buttons sit in.
+   * - `count`: How many notes the list holds, which a search narrows, at the end of the search bar.
+   * - `filter-icon`: The icon beside the search field.
+   * - `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.
+   * - `note`: One note in the list.
+   * - `note-cursor`: The note the keyboard is on in the list.
+   * - `note-linked`: A note linked to or from the selected one.
+   * - `note-name`: A note's name in the list.
+   * - `note-relation`: How a note stands to the selected one, such as "Linked from Alpha".
+   * - `note-selected`: The selected note, first in the list.
+   * - `pan-down`: The button that moves the graph down.
+   * - `pan-end`: The button that moves the graph toward the end of a line of text: right in English.
+   * - `pan-start`: The button that moves the graph toward the start of a line of text: left in English.
+   * - `pan-up`: The button that moves the graph up.
+   * - `panel`: The search field and the list, beside the drawing or below it.
+   * - `region`: The frame: the drawing, its controls and the list.
+   * - `search`: The bar holding the icon, the search field and the count.
+   * - `search-field`: The field that finds a note by its name.
+   * - `stage`: The drawing and its controls.
+   * - `viewport`: The box the renderer draws in.
+   * - `zoom-in`: The zoom in button.
+   * - `zoom-out`: The zoom out button.
+   *
+   * ## CSS States
+   *
+   * These can be used to apply styling when a component is in a given state.
+   *
+   * - `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<
+    HelixHeadlessGraphProps & BaseProps<HelixHeadlessGraph> & BaseEvents<HelixHeadlessGraph>
+  >;
+
   /**
    * A grid of cells, each colored by a tone. `rows="1"` makes a status strip, and
    * `rows="7"` makes a contribution graph. GitHub's contribution graph uses five
@@ -33211,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.
@@ -33257,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.
    *
@@ -33304,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
@@ -33325,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
@@ -33458,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.
    */
@@ -44813,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.
    *
@@ -44852,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
@@ -44873,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,
@@ -44989,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.
@@ -45014,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<
@@ -50583,6 +51585,270 @@ export type CustomElementsSolidJs = {
       BaseEvents<HelixHeadlessFormatDate>
   >;
 
+  /**
+   * 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, 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
+   * find a note for anyone. The selected note comes first, then the notes it
+   * links to and from, then every other note, and the search field narrows it.
+   * Selecting a note in the list or in the drawing is the same selection.
+   *
+   * Set `depth` to show the local graph: only the notes within that many links
+   * of the selected one.
+   *
+   * `nodes` and `links` are properties, never markup: a graph of ten thousand
+   * notes as ten thousand elements would cost what the renderer exists to save.
+   * The list draws only the rows in view.
+   *
+   * The list scrolls on this tier. It carries `data-scroller`, and `core` ships
+   * `[data-scroller] { overflow: auto }` into every shadow root. You still need
+   * to set a block size on the list, or it grows to hold every row.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `count-label`/`countLabel`: What the list says of a note's count, with `{count}`.
+   * - `depth`: How many links from the selected note to show, for its local graph. Unset
+   * shows every note. The list holds what the drawing shows.
+   * - `label`: The graph's name, read by screen readers, such as "Research notes".
+   * Required.
+   * - `linked-both-label`/`linkedBothLabel`: How a note linked both to and from the selected one is described, with `{note}`.
+   * - `linked-from-label`/`linkedFromLabel`: How a note the selected one links to is described, with `{note}`, the selected note's name.
+   * - `links-to-label`/`linksToLabel`: How a note that links to the selected one is described, with `{note}`.
+   * - `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.
+   *
+   * **A list rather than a switch, because the overlap is not symmetric.** A
+   * surface a consumer brings often has zoom controls of its own and almost
+   * never has pan buttons, so a single switch would make them choose between
+   * a duplicate and nothing.
+   *
+   * `none` draws none of them, which is the right answer where what was
+   * slotted already has controls a reader can find: what this argues for is
+   * that *a* findable control exists, never that it is ours. The methods stay
+   * public either way, so a consumer drawing their own chrome can still drive
+   * the surface.
+   *
+   * Absent is whatever the family rests at, which is this library's rule that
+   * a resting value is an attribute's absence: zoom, the compass and
+   * fullscreen for a map, whose pan buttons a page asks for, and zoom and
+   * fullscreen for a board, which a reader drags and whose pad took a third
+   * of the frame. The
+   * stylesheet lays the cluster out by which buttons are in it rather than by
+   * this attribute, so the two defaults need no rule each.
+   * - `controls-label`/`controlsLabel`: The name of the group of controls, read by screen readers.
+   *
+   * Absent is the family's own name for it, "Map controls" or "Board
+   * controls", which names what the controls drive rather than the
+   * mechanism. Written here to say it in another language, which every other
+   * string this surface speaks already allowed and this one did not.
+   * - `controls-placement`/`controlsPlacement`: Which corner the controls sit in.
+   *
+   * **Configurable because there is no safe default**, which is a collision
+   * rather than a taste: whatever a consumer slots may put its own controls
+   * in any corner, and every library that draws some made this a setting for
+   * the same reason.
+   *
+   * Logical corners rather than left and right, so a right-to-left page moves
+   * them without a consumer writing a second rule. Absent is the top end, a
+   * 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
+   * reader operates the surface, and chrome that hid itself by default would
+   * be the component undoing its own argument. Set it for a display nobody
+   * drives.
+   * - `pan-down-label`/`panDownLabel`: The pan down button's label.
+   *
+   * **A label for each way rather than one with the way filled in**, which is
+   * what this was: `Pan {way}` filled in with `left`, so a page that said it
+   * in French read out "Déplacer left". The word for a direction is as much
+   * the translator's as the word for panning, and a language can put it
+   * anywhere in the phrase.
+   * - `pan-left-label`/`panLeftLabel`: The pan left button's label.
+   * - `pan-right-label`/`panRightLabel`: The pan right button's label.
+   * - `pan-step`/`panStep`: How far one press pans the view, as a fraction of its size.
+   *
+   * A fraction rather than a distance, because this surface does not know the
+   * 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.
+   *
+   * Not `option.active`, which is the option the keyboard is on: that is a
+   * different question from which one is chosen.
+   *
+   * Writing always applies, so `<helix-tabs active="one">` starts on that
+   * tab, and `default-active` is how markup says where to start without
+   * naming the current one.
+   * - `default-active`/`defaultActive`: The `value` of the item declared current in markup.
+   *
+   * Ignored once `active` is written.
+   * - `links`: The links between notes, each from `source` to `target`. A property, never an attribute. (property only)
+   * - `nodes`: The notes. A property, never an attribute. (property only)
+   * - `ready`: Whether the graph has been drawn whole. For code that runs after `helix-graph-ready`. (property only) (readonly)
+   * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
+   *
+   * **Named `whenSettled` because `settled` is taken four times over**, by
+   * Image, Splitter and both color controls, none of them about transitions. A
+   * base class takes the name every subclass then cannot use.
+   *
+   * **The state it reports cannot be watched, which is why this exists.** A
+   * custom state is deliberately not in the DOM, so there is no
+   * `MutationObserver` equivalent for `ElementInternals.states`. Await this
+   * instead.
+   *
+   * Separate from `updateComplete`, which resolves in the microtask checkpoint
+   * the suppression is still active in. That is the distinction `readyToMove`
+   * in `@fusion.dev/helix-testing` is written around.
+   *
+   * It never resolves where `requestAnimationFrame` never fires, which is a
+   * server, a hidden tab, and happy-dom. Callers that must not hang there race
+   * it against a timeout, as the happy-dom harness's `readyToMove` does. The
+   * browser harness's awaits it alone: a browser always runs the frame, and a
+   * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
+   *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `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-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. `connectGraph` zooms the drawing.
+   *
+   * ## Slots
+   *
+   * Areas where markup can be added to the component.
+   *
+   * - `(default)`: The renderer's box, which the drawing is made in.
+   * - `filter-icon`: The icon in the search field. Defaults to a magnifying glass.
+   * - `footer`: Content below the graph.
+   * - `header`: Content above the graph.
+   *
+   * ## Methods
+   *
+   * 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. 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.
+   * - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
+   *
+   * Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
+   * a refusal and nothing moves. Unlike a native control, nothing has moved
+   * by the time this runs, so refusing is simply not writing: there is
+   * nothing to put back. Nobody refusing means the set updates itself,
+   * whether or not a consumer declared `active`, a declared property being a
+   * seed and a correction.
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `after`: The room the notes after those drawn would take, so the list scrolls its whole length.
+   * - `before`: The room the notes before those drawn would take.
+   * - `body`: The drawing beside the list, or above it where the frame is narrow.
+   * - `controls`: The group the pan and zoom buttons sit in.
+   * - `count`: How many notes the list holds, which a search narrows, at the end of the search bar.
+   * - `filter-icon`: The icon beside the search field.
+   * - `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.
+   * - `note`: One note in the list.
+   * - `note-cursor`: The note the keyboard is on in the list.
+   * - `note-linked`: A note linked to or from the selected one.
+   * - `note-name`: A note's name in the list.
+   * - `note-relation`: How a note stands to the selected one, such as "Linked from Alpha".
+   * - `note-selected`: The selected note, first in the list.
+   * - `pan-down`: The button that moves the graph down.
+   * - `pan-end`: The button that moves the graph toward the end of a line of text: right in English.
+   * - `pan-start`: The button that moves the graph toward the start of a line of text: left in English.
+   * - `pan-up`: The button that moves the graph up.
+   * - `panel`: The search field and the list, beside the drawing or below it.
+   * - `region`: The frame: the drawing, its controls and the list.
+   * - `search`: The bar holding the icon, the search field and the count.
+   * - `search-field`: The field that finds a note by its name.
+   * - `stage`: The drawing and its controls.
+   * - `viewport`: The box the renderer draws in.
+   * - `zoom-in`: The zoom in button.
+   * - `zoom-out`: The zoom out button.
+   *
+   * ## CSS States
+   *
+   * These can be used to apply styling when a component is in a given state.
+   *
+   * - `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<
+    HelixHeadlessGraphProps &
+      HelixHeadlessGraphSolidJsProps &
+      BaseProps<HelixHeadlessGraph> &
+      BaseEvents<HelixHeadlessGraph>
+  >;
+
   /**
    * A grid of cells, each colored by a tone. `rows="1"` makes a status strip, and
    * `rows="7"` makes a contribution graph. GitHub's contribution graph uses five
@@ -53330,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.
@@ -53376,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.
    *
@@ -53423,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
@@ -53444,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
@@ -53577,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.
    */