@fusion.dev/helix-headless 0.208.0 → 0.209.0

package/types/jsx.d.ts

@@ -177,6 +177,7 @@ import type {
   HelixHeadlessTabs,
   HelixHeadlessTag,
   HelixHeadlessTagGroup,
+  HelixHeadlessTerminal,
   HelixHeadlessTextarea,
   HelixHeadlessTimeInput,
   HelixHeadlessTimePicker,
@@ -240,6 +241,12 @@ import type {
   HelixShortcutEvent,
   HelixSortEvent,
   HelixSortedEvent,
+  HelixTerminalBellEvent,
+  HelixTerminalInputEvent,
+  HelixTerminalLinkEvent,
+  HelixTerminalResizeEvent,
+  HelixTerminalRestartEvent,
+  HelixTerminalTitleEvent,
   HelixToggleEvent,
   HelixTourAskEvent,
   HelixTourStatusEvent,
@@ -33904,6 +33911,319 @@ select. */
   textContent?: (string | number) | undefined;
 };
 
+/** `HelixHeadlessTerminal` component event */
+export type HelixHeadlessTerminalElementEvent<E = Event> = TypedEvent<
+  HelixHeadlessTerminal,
+  E
+>;
+/** `helix-copy` event type */
+export type HelixHeadlessTerminalHelixCopyElementEvent =
+  HelixHeadlessTerminalElementEvent<HelixCopyEvent>;
+/** `helix-terminal-bell` event type */
+export type HelixHeadlessTerminalHelixTerminalBellElementEvent =
+  HelixHeadlessTerminalElementEvent<HelixTerminalBellEvent>;
+/** `helix-terminal-input` event type */
+export type HelixHeadlessTerminalHelixTerminalInputElementEvent =
+  HelixHeadlessTerminalElementEvent<HelixTerminalInputEvent>;
+/** `helix-terminal-link` event type */
+export type HelixHeadlessTerminalHelixTerminalLinkElementEvent =
+  HelixHeadlessTerminalElementEvent<HelixTerminalLinkEvent>;
+/** `helix-terminal-resize` event type */
+export type HelixHeadlessTerminalHelixTerminalResizeElementEvent =
+  HelixHeadlessTerminalElementEvent<HelixTerminalResizeEvent>;
+/** `helix-terminal-restart` event type */
+export type HelixHeadlessTerminalHelixTerminalRestartElementEvent =
+  HelixHeadlessTerminalElementEvent<HelixTerminalRestartEvent>;
+/** `helix-terminal-title` event type */
+export type HelixHeadlessTerminalHelixTerminalTitleElementEvent =
+  HelixHeadlessTerminalElementEvent<HelixTerminalTitleEvent>;
+
+export type HelixHeadlessTerminalProps = {
+  /** The clear button's label. */
+  "clear-label"?: (HelixHeadlessTerminal["clearLabel"]) | undefined;
+  /** The clear button's label. */
+  clearLabel?: (HelixHeadlessTerminal["clearLabel"]) | undefined;
+  /** The grid's width in character cells. Set it with `rows` to fix the grid's size; unset, the grid fills the frame. */
+  columns?: (HelixHeadlessTerminal["columns"]) | undefined;
+  /** Which built-in controls the header shows, as a list of `find`, `copy`,
+`clear`, and `fullscreen`, or `none`. Absent is `find clear`. */
+  controls?: (HelixHeadlessTerminal["controls"]) | undefined;
+  /** The name of the row of controls, read by screen readers. */
+  "controls-label"?: (HelixHeadlessTerminal["controlsLabel"]) | undefined;
+  /** The name of the row of controls, read by screen readers. */
+  controlsLabel?: (HelixHeadlessTerminal["controlsLabel"]) | undefined;
+  /** What screen readers hear after a copy. */
+  "copied-label"?: (HelixHeadlessTerminal["copiedLabel"]) | undefined;
+  /** What screen readers hear after a copy. */
+  copiedLabel?: (HelixHeadlessTerminal["copiedLabel"]) | undefined;
+  /** The copy button's label. */
+  "copy-label"?: (HelixHeadlessTerminal["copyLabel"]) | undefined;
+  /** The copy button's label. */
+  copyLabel?: (HelixHeadlessTerminal["copyLabel"]) | undefined;
+  /** How the process exited, which the page sets when it does. While it is set,
+the status line says it, the frame sends no input, and Restart is shown.
+Clear it when a new process starts. */
+  "exit-code"?: (HelixHeadlessTerminal["exitCode"] | `${number}`) | undefined;
+  /** How the process exited, which the page sets when it does. While it is set,
+the status line says it, the frame sends no input, and Restart is shown.
+Clear it when a new process starts. */
+  exitCode?: (HelixHeadlessTerminal["exitCode"]) | undefined;
+  /** What the status line says once the process has exited. `{code}` is its
+exit code, written as the process gave it, and code `0` is a clean exit. */
+  "exited-label"?: (HelixHeadlessTerminal["exitedLabel"]) | undefined;
+  /** What the status line says once the process has exited. `{code}` is its
+exit code, written as the process gave it, and code `0` is a clean exit. */
+  exitedLabel?: (HelixHeadlessTerminal["exitedLabel"]) | undefined;
+  /** The terminal's name where `label` is empty and the host has no `aria-label`. */
+  "fallback-label"?: (HelixHeadlessTerminal["fallbackLabel"]) | undefined;
+  /** The terminal's name where `label` is empty and the host has no `aria-label`. */
+  fallbackLabel?: (HelixHeadlessTerminal["fallbackLabel"]) | undefined;
+  /** The label of the button that closes the find bar. */
+  "find-close-label"?: (HelixHeadlessTerminal["findCloseLabel"]) | undefined;
+  /** The label of the button that closes the find bar. */
+  findCloseLabel?: (HelixHeadlessTerminal["findCloseLabel"]) | undefined;
+  /** The name of the find bar's row of buttons, read by screen readers. */
+  "find-controls-label"?: (HelixHeadlessTerminal["findControlsLabel"]) | undefined;
+  /** The name of the find bar's row of buttons, read by screen readers. */
+  findControlsLabel?: (HelixHeadlessTerminal["findControlsLabel"]) | undefined;
+  /** The find button's label, and the find field's name and placeholder. */
+  "find-label"?: (HelixHeadlessTerminal["findLabel"]) | undefined;
+  /** The find button's label, and the find field's name and placeholder. */
+  findLabel?: (HelixHeadlessTerminal["findLabel"]) | undefined;
+  /** The next match button's label. */
+  "find-next-label"?: (HelixHeadlessTerminal["findNextLabel"]) | undefined;
+  /** The next match button's label. */
+  findNextLabel?: (HelixHeadlessTerminal["findNextLabel"]) | undefined;
+  /** The previous match button's label. */
+  "find-previous-label"?: (HelixHeadlessTerminal["findPreviousLabel"]) | undefined;
+  /** The previous match button's label. */
+  findPreviousLabel?: (HelixHeadlessTerminal["findPreviousLabel"]) | undefined;
+  /** The fullscreen button's label. */
+  "fullscreen-label"?: (HelixHeadlessTerminal["fullscreenLabel"]) | undefined;
+  /** The fullscreen button's label. */
+  fullscreenLabel?: (HelixHeadlessTerminal["fullscreenLabel"]) | undefined;
+  /** The name of the element the reader types into, which the renderer draws. */
+  "input-label"?: (HelixHeadlessTerminal["inputLabel"]) | undefined;
+  /** The name of the element the reader types into, which the renderer draws. */
+  inputLabel?: (HelixHeadlessTerminal["inputLabel"]) | undefined;
+  /** The terminal's name, in the header and for screen readers, such as the
+shell or the folder it runs in. Several terminals on a page need names
+that tell them apart. */
+  label?: (HelixHeadlessTerminal["label"]) | undefined;
+  /** What the find bar says of its matches. `{index}` is the current match,
+counting from 1, and `{count}` how many there are. */
+  "matches-label"?: (HelixHeadlessTerminal["matchesLabel"]) | undefined;
+  /** What the find bar says of its matches. `{index}` is the current match,
+counting from 1, and `{count}` how many there are. */
+  matchesLabel?: (HelixHeadlessTerminal["matchesLabel"]) | undefined;
+  /** Draws the output and sends no input, with no cursor, for a transcript or
+a command an agent ran. The attribute is `readonly`, the platform's
+spelling. */
+  readonly?: (HelixHeadlessTerminal["readOnly"]) | undefined;
+  /** Draws the output and sends no input, with no cursor, for a transcript or
+a command an agent ran. The attribute is `readonly`, the platform's
+spelling. */
+  readOnly?: (HelixHeadlessTerminal["readOnly"]) | undefined;
+  /** The Restart button's label. */
+  "restart-label"?: (HelixHeadlessTerminal["restartLabel"]) | undefined;
+  /** The Restart button's label. */
+  restartLabel?: (HelixHeadlessTerminal["restartLabel"]) | undefined;
+  /** The grid's height in lines. Set it with `columns` to fix the grid's size; unset, the grid fills the frame. */
+  rows?: (HelixHeadlessTerminal["rows"]) | undefined;
+  /** Keeps the grid as lines a screen reader moves through, and says new
+output as it arrives. Off by default, since it costs time on every
+write. Connect it to a setting your reader can turn on. */
+  "screen-reader-mode"?: (HelixHeadlessTerminal["screenReaderMode"]) | undefined;
+  /** Keeps the grid as lines a screen reader moves through, and says new
+output as it arrives. Off by default, since it costs time on every
+write. Connect it to a setting your reader can turn on. */
+  screenReaderMode?: (HelixHeadlessTerminal["screenReaderMode"]) | undefined;
+  /** What the terminal's input describes to a screen reader. `{key}` is the key that switches Tab. */
+  "tab-hint-label"?: (HelixHeadlessTerminal["tabHintLabel"]) | undefined;
+  /** What the terminal's input describes to a screen reader. `{key}` is the key that switches Tab. */
+  tabHintLabel?: (HelixHeadlessTerminal["tabHintLabel"]) | undefined;
+  /** What the status line says while Tab moves focus. `{key}` is the key that switches it back. */
+  "tab-moves-focus-label"?: (HelixHeadlessTerminal["tabMovesFocusLabel"]) | undefined;
+  /** What the status line says while Tab moves focus. `{key}` is the key that switches it back. */
+  tabMovesFocusLabel?: (HelixHeadlessTerminal["tabMovesFocusLabel"]) | undefined;
+  /** What screen readers hear when Tab goes back to typing in the terminal. */
+  "tab-types-label"?: (HelixHeadlessTerminal["tabTypesLabel"]) | undefined;
+  /** What screen readers hear when Tab goes back to typing in the terminal. */
+  tabTypesLabel?: (HelixHeadlessTerminal["tabTypesLabel"]) | undefined;
+
+  /** The copy control or its key put the selection on the clipboard. */
+  "onhelix-copy"?: ((e: HelixHeadlessTerminalHelixCopyElementEvent) => void) | undefined;
+  /** The program rang the bell. The frame flashes once. */
+  "onhelix-terminal-bell"?: ((
+    e: HelixHeadlessTerminalHelixTerminalBellElementEvent,
+  ) => void) | undefined;
+  /** The reader typed or pasted, with `data` encoded for the program. Write it to the process. Not sent while `readonly`, or once `exit-code` is set. */
+  "onhelix-terminal-input"?: ((
+    e: HelixHeadlessTerminalHelixTerminalInputElementEvent,
+  ) => void) | undefined;
+  /** A link in the output was activated, with its `href`. Cancelable: cancel it to open the link yourself. Left alone, a web address opens in a new tab. */
+  "onhelix-terminal-link"?: ((
+    e: HelixHeadlessTerminalHelixTerminalLinkElementEvent,
+  ) => void) | undefined;
+  /** The grid changed size, with `columns`, `rows`, `width`, and `height`. Resize the process's pseudo-terminal to match. */
+  "onhelix-terminal-resize"?: ((
+    e: HelixHeadlessTerminalHelixTerminalResizeElementEvent,
+  ) => void) | undefined;
+  /** The Restart button was pressed after the process exited. Start a new process and clear `exit-code`. */
+  "onhelix-terminal-restart"?: ((
+    e: HelixHeadlessTerminalHelixTerminalRestartElementEvent,
+  ) => void) | undefined;
+  /** The program set its title, with `title`. The frame keeps its own `label`. */
+  "onhelix-terminal-title"?: ((
+    e: HelixHeadlessTerminalHelixTerminalTitleElementEvent,
+  ) => void) | undefined;
+};
+
+export type HelixHeadlessTerminalSolidJsProps = {
+  /** The clear button's label. */
+  "attr:clear-label"?: (HelixHeadlessTerminal["clearLabel"]) | undefined;
+  /** The clear button's label. */
+  "prop:clearLabel"?: (HelixHeadlessTerminal["clearLabel"]) | undefined;
+  /** The grid's width in character cells. Set it with `rows` to fix the grid's size; unset, the grid fills the frame. */
+  "prop:columns"?: (HelixHeadlessTerminal["columns"]) | undefined;
+  /** Which built-in controls the header shows, as a list of `find`, `copy`,
+`clear`, and `fullscreen`, or `none`. Absent is `find clear`. */
+  "prop:controls"?: (HelixHeadlessTerminal["controls"]) | undefined;
+  /** The name of the row of controls, read by screen readers. */
+  "attr:controls-label"?: (HelixHeadlessTerminal["controlsLabel"]) | undefined;
+  /** The name of the row of controls, read by screen readers. */
+  "prop:controlsLabel"?: (HelixHeadlessTerminal["controlsLabel"]) | undefined;
+  /** What screen readers hear after a copy. */
+  "attr:copied-label"?: (HelixHeadlessTerminal["copiedLabel"]) | undefined;
+  /** What screen readers hear after a copy. */
+  "prop:copiedLabel"?: (HelixHeadlessTerminal["copiedLabel"]) | undefined;
+  /** The copy button's label. */
+  "attr:copy-label"?: (HelixHeadlessTerminal["copyLabel"]) | undefined;
+  /** The copy button's label. */
+  "prop:copyLabel"?: (HelixHeadlessTerminal["copyLabel"]) | undefined;
+  /** How the process exited, which the page sets when it does. While it is set,
+the status line says it, the frame sends no input, and Restart is shown.
+Clear it when a new process starts. */
+  "attr:exit-code"?: (HelixHeadlessTerminal["exitCode"] | `${number}`) | undefined;
+  /** How the process exited, which the page sets when it does. While it is set,
+the status line says it, the frame sends no input, and Restart is shown.
+Clear it when a new process starts. */
+  "prop:exitCode"?: (HelixHeadlessTerminal["exitCode"]) | undefined;
+  /** What the status line says once the process has exited. `{code}` is its
+exit code, written as the process gave it, and code `0` is a clean exit. */
+  "attr:exited-label"?: (HelixHeadlessTerminal["exitedLabel"]) | undefined;
+  /** What the status line says once the process has exited. `{code}` is its
+exit code, written as the process gave it, and code `0` is a clean exit. */
+  "prop:exitedLabel"?: (HelixHeadlessTerminal["exitedLabel"]) | undefined;
+  /** The terminal's name where `label` is empty and the host has no `aria-label`. */
+  "attr:fallback-label"?: (HelixHeadlessTerminal["fallbackLabel"]) | undefined;
+  /** The terminal's name where `label` is empty and the host has no `aria-label`. */
+  "prop:fallbackLabel"?: (HelixHeadlessTerminal["fallbackLabel"]) | undefined;
+  /** The label of the button that closes the find bar. */
+  "attr:find-close-label"?: (HelixHeadlessTerminal["findCloseLabel"]) | undefined;
+  /** The label of the button that closes the find bar. */
+  "prop:findCloseLabel"?: (HelixHeadlessTerminal["findCloseLabel"]) | undefined;
+  /** The name of the find bar's row of buttons, read by screen readers. */
+  "attr:find-controls-label"?: (HelixHeadlessTerminal["findControlsLabel"]) | undefined;
+  /** The name of the find bar's row of buttons, read by screen readers. */
+  "prop:findControlsLabel"?: (HelixHeadlessTerminal["findControlsLabel"]) | undefined;
+  /** The find button's label, and the find field's name and placeholder. */
+  "attr:find-label"?: (HelixHeadlessTerminal["findLabel"]) | undefined;
+  /** The find button's label, and the find field's name and placeholder. */
+  "prop:findLabel"?: (HelixHeadlessTerminal["findLabel"]) | undefined;
+  /** The next match button's label. */
+  "attr:find-next-label"?: (HelixHeadlessTerminal["findNextLabel"]) | undefined;
+  /** The next match button's label. */
+  "prop:findNextLabel"?: (HelixHeadlessTerminal["findNextLabel"]) | undefined;
+  /** The previous match button's label. */
+  "attr:find-previous-label"?: (HelixHeadlessTerminal["findPreviousLabel"]) | undefined;
+  /** The previous match button's label. */
+  "prop:findPreviousLabel"?: (HelixHeadlessTerminal["findPreviousLabel"]) | undefined;
+  /** The fullscreen button's label. */
+  "attr:fullscreen-label"?: (HelixHeadlessTerminal["fullscreenLabel"]) | undefined;
+  /** The fullscreen button's label. */
+  "prop:fullscreenLabel"?: (HelixHeadlessTerminal["fullscreenLabel"]) | undefined;
+  /** The name of the element the reader types into, which the renderer draws. */
+  "attr:input-label"?: (HelixHeadlessTerminal["inputLabel"]) | undefined;
+  /** The name of the element the reader types into, which the renderer draws. */
+  "prop:inputLabel"?: (HelixHeadlessTerminal["inputLabel"]) | undefined;
+  /** The terminal's name, in the header and for screen readers, such as the
+shell or the folder it runs in. Several terminals on a page need names
+that tell them apart. */
+  "prop:label"?: (HelixHeadlessTerminal["label"]) | undefined;
+  /** What the find bar says of its matches. `{index}` is the current match,
+counting from 1, and `{count}` how many there are. */
+  "attr:matches-label"?: (HelixHeadlessTerminal["matchesLabel"]) | undefined;
+  /** What the find bar says of its matches. `{index}` is the current match,
+counting from 1, and `{count}` how many there are. */
+  "prop:matchesLabel"?: (HelixHeadlessTerminal["matchesLabel"]) | undefined;
+  /** Draws the output and sends no input, with no cursor, for a transcript or
+a command an agent ran. The attribute is `readonly`, the platform's
+spelling. */
+  "bool:readonly"?: (HelixHeadlessTerminal["readOnly"]) | undefined;
+  /** Draws the output and sends no input, with no cursor, for a transcript or
+a command an agent ran. The attribute is `readonly`, the platform's
+spelling. */
+  "prop:readOnly"?: (HelixHeadlessTerminal["readOnly"]) | undefined;
+  /** The Restart button's label. */
+  "attr:restart-label"?: (HelixHeadlessTerminal["restartLabel"]) | undefined;
+  /** The Restart button's label. */
+  "prop:restartLabel"?: (HelixHeadlessTerminal["restartLabel"]) | undefined;
+  /** The grid's height in lines. Set it with `columns` to fix the grid's size; unset, the grid fills the frame. */
+  "prop:rows"?: (HelixHeadlessTerminal["rows"]) | undefined;
+  /** Keeps the grid as lines a screen reader moves through, and says new
+output as it arrives. Off by default, since it costs time on every
+write. Connect it to a setting your reader can turn on. */
+  "bool:screen-reader-mode"?: (HelixHeadlessTerminal["screenReaderMode"]) | undefined;
+  /** Keeps the grid as lines a screen reader moves through, and says new
+output as it arrives. Off by default, since it costs time on every
+write. Connect it to a setting your reader can turn on. */
+  "prop:screenReaderMode"?: (HelixHeadlessTerminal["screenReaderMode"]) | undefined;
+  /** What the terminal's input describes to a screen reader. `{key}` is the key that switches Tab. */
+  "attr:tab-hint-label"?: (HelixHeadlessTerminal["tabHintLabel"]) | undefined;
+  /** What the terminal's input describes to a screen reader. `{key}` is the key that switches Tab. */
+  "prop:tabHintLabel"?: (HelixHeadlessTerminal["tabHintLabel"]) | undefined;
+  /** What the status line says while Tab moves focus. `{key}` is the key that switches it back. */
+  "attr:tab-moves-focus-label"?: (HelixHeadlessTerminal["tabMovesFocusLabel"]) | undefined;
+  /** What the status line says while Tab moves focus. `{key}` is the key that switches it back. */
+  "prop:tabMovesFocusLabel"?: (HelixHeadlessTerminal["tabMovesFocusLabel"]) | undefined;
+  /** What screen readers hear when Tab goes back to typing in the terminal. */
+  "attr:tab-types-label"?: (HelixHeadlessTerminal["tabTypesLabel"]) | undefined;
+  /** What screen readers hear when Tab goes back to typing in the terminal. */
+  "prop:tabTypesLabel"?: (HelixHeadlessTerminal["tabTypesLabel"]) | undefined;
+  /** The copy control or its key put the selection on the clipboard. */
+  "on:helix-copy"?: ((e: HelixHeadlessTerminalHelixCopyElementEvent) => void) | undefined;
+  /** The program rang the bell. The frame flashes once. */
+  "on:helix-terminal-bell"?: ((
+    e: HelixHeadlessTerminalHelixTerminalBellElementEvent,
+  ) => void) | undefined;
+  /** The reader typed or pasted, with `data` encoded for the program. Write it to the process. Not sent while `readonly`, or once `exit-code` is set. */
+  "on:helix-terminal-input"?: ((
+    e: HelixHeadlessTerminalHelixTerminalInputElementEvent,
+  ) => void) | undefined;
+  /** A link in the output was activated, with its `href`. Cancelable: cancel it to open the link yourself. Left alone, a web address opens in a new tab. */
+  "on:helix-terminal-link"?: ((
+    e: HelixHeadlessTerminalHelixTerminalLinkElementEvent,
+  ) => void) | undefined;
+  /** The grid changed size, with `columns`, `rows`, `width`, and `height`. Resize the process's pseudo-terminal to match. */
+  "on:helix-terminal-resize"?: ((
+    e: HelixHeadlessTerminalHelixTerminalResizeElementEvent,
+  ) => void) | undefined;
+  /** The Restart button was pressed after the process exited. Start a new process and clear `exit-code`. */
+  "on:helix-terminal-restart"?: ((
+    e: HelixHeadlessTerminalHelixTerminalRestartElementEvent,
+  ) => void) | undefined;
+  /** The program set its title, with `title`. The frame keeps its own `label`. */
+  "on:helix-terminal-title"?: ((
+    e: HelixHeadlessTerminalHelixTerminalTitleElementEvent,
+  ) => void) | undefined;
+
+  /** Set the innerHTML of the element */
+  innerHTML?: (string) | undefined;
+  /** Set the textContent of the element */
+  textContent?: (string | number) | undefined;
+};
+
 /** `HelixHeadlessTextarea` component event */
 export type HelixHeadlessTextareaElementEvent<E = Event> = TypedEvent<
   HelixHeadlessTextarea,
@@ -67579,6 +67899,266 @@ export type CustomElements<F extends Framework = "other"> = {
     HelixHeadlessTagProps & BaseProps<HelixHeadlessTag, F> & BaseEvents<HelixHeadlessTag>
   >;
 
+  /**
+   * Wraps a terminal drawn by xterm.js or another emulator. The frame adds a
+   * header with the terminal's name and its controls, a find bar, and a status
+   * line. `connectTerminal` in `@fusion.dev/helix-terminal` connects it to the
+   * emulator and draws the terminal in the colors the `--terminal-*` properties
+   * set, which the styled tier sets from your theme. Helix does not start a
+   * process: you connect the stream. Write the program's output with `write()`, send what the
+   * reader types to the process from `helix-terminal-input`, and resize the
+   * process's pseudo-terminal from `helix-terminal-resize`.
+   *
+   * Output written before a renderer is connected is held and written first, so
+   * the process can start before the emulator loads. `write()` resolves once
+   * the renderer has parsed the output, which is how a page pauses a process
+   * that writes faster than the terminal draws.
+   *
+   * The controls are a row in the header, and `controls` names which ones:
+   * `find`, `copy`, `clear`, and `fullscreen`. `find clear` by default. A control
+   * the renderer cannot answer is left out once it is connected. Set `exit-code`
+   * when the process exits: the frame says how it exited, stops sending input,
+   * and shows a Restart button that sends `helix-terminal-restart`.
+   *
+   * **Keyboard.** Every key goes to the program, Tab, Shift+Tab, and Escape
+   * included, except these:
+   *
+   * - Control+Shift+F, or Command+F on a Mac, opens the find bar. Enter and
+   *   Shift+Enter move between the matches, and Escape closes the bar and
+   *   returns focus to the terminal.
+   * - Control+Shift+C copies the selection. On a Mac, Command+C does.
+   * - Control+M, or Control+Shift+M on a Mac, switches Tab between typing in the
+   *   terminal and moving focus out of it. The status line says when Tab moves
+   *   focus, and the terminal's input describes the key to a screen reader.
+   *
+   * **Screen readers.** A terminal draws its grid as a picture of text, so a
+   * screen reader reads nothing in it by default. Set `screen-reader-mode` to
+   * have the renderer keep the grid as lines a screen reader can move through
+   * and announce new output as it arrives, which xterm.js calls screen reader
+   * mode. It costs time on every write, so it is off by default: connect it to
+   * a setting your reader can turn on.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `clear-label`/`clearLabel`: The clear button's label.
+   * - `columns`: The grid's width in character cells. Set it with `rows` to fix the grid's size; unset, the grid fills the frame.
+   * - `controls`: Which built-in controls the header shows, as a list of `find`, `copy`,
+   * `clear`, and `fullscreen`, or `none`. Absent is `find clear`.
+   * - `controls-label`/`controlsLabel`: The name of the row of controls, read by screen readers.
+   * - `copied-label`/`copiedLabel`: What screen readers hear after a copy.
+   * - `copy-label`/`copyLabel`: The copy button's label.
+   * - `exit-code`/`exitCode`: How the process exited, which the page sets when it does. While it is set,
+   * the status line says it, the frame sends no input, and Restart is shown.
+   * Clear it when a new process starts.
+   * - `exited-label`/`exitedLabel`: What the status line says once the process has exited. `{code}` is its
+   * exit code, written as the process gave it, and code `0` is a clean exit.
+   * - `fallback-label`/`fallbackLabel`: The terminal's name where `label` is empty and the host has no `aria-label`.
+   * - `find-close-label`/`findCloseLabel`: The label of the button that closes the find bar.
+   * - `find-controls-label`/`findControlsLabel`: The name of the find bar's row of buttons, read by screen readers.
+   * - `find-label`/`findLabel`: The find button's label, and the find field's name and placeholder.
+   * - `find-next-label`/`findNextLabel`: The next match button's label.
+   * - `find-previous-label`/`findPreviousLabel`: The previous match button's label.
+   * - `fullscreen-label`/`fullscreenLabel`: The fullscreen button's label.
+   * - `input-label`/`inputLabel`: The name of the element the reader types into, which the renderer draws.
+   * - `label`: The terminal's name, in the header and for screen readers, such as the
+   * shell or the folder it runs in. Several terminals on a page need names
+   * that tell them apart.
+   * - `matches-label`/`matchesLabel`: What the find bar says of its matches. `{index}` is the current match,
+   * counting from 1, and `{count}` how many there are.
+   * - `readonly`/`readOnly`: Draws the output and sends no input, with no cursor, for a transcript or
+   * a command an agent ran. The attribute is `readonly`, the platform's
+   * spelling.
+   * - `restart-label`/`restartLabel`: The Restart button's label.
+   * - `rows`: The grid's height in lines. Set it with `columns` to fix the grid's size; unset, the grid fills the frame.
+   * - `screen-reader-mode`/`screenReaderMode`: Keeps the grid as lines a screen reader moves through, and says new
+   * output as it arrives. Off by default, since it costs time on every
+   * write. Connect it to a setting your reader can turn on.
+   * - `tab-hint-label`/`tabHintLabel`: What the terminal's input describes to a screen reader. `{key}` is the key that switches Tab.
+   * - `tab-moves-focus-label`/`tabMovesFocusLabel`: What the status line says while Tab moves focus. `{key}` is the key that switches it back.
+   * - `tab-types-label`/`tabTypesLabel`: What screen readers hear when Tab goes back to typing in the terminal.
+   * - `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-copy`: The copy control or its key put the selection on the clipboard.
+   * - `helix-terminal-bell`: The program rang the bell. The frame flashes once.
+   * - `helix-terminal-input`: The reader typed or pasted, with `data` encoded for the program. Write it to the process. Not sent while `readonly`, or once `exit-code` is set.
+   * - `helix-terminal-link`: A link in the output was activated, with its `href`. Cancelable: cancel it to open the link yourself. Left alone, a web address opens in a new tab.
+   * - `helix-terminal-resize`: The grid changed size, with `columns`, `rows`, `width`, and `height`. Resize the process's pseudo-terminal to match.
+   * - `helix-terminal-restart`: The Restart button was pressed after the process exited. Start a new process and clear `exit-code`.
+   * - `helix-terminal-title`: The program set its title, with `title`. The frame keeps its own `label`.
+   *
+   * ## Slots
+   *
+   * Areas where markup can be added to the component.
+   *
+   * - `(default)`: The element your renderer draws the terminal in.
+   * - `actions`: Controls of your own in the header, before the built-in ones, such as a button that splits the pane.
+   * - `clear-icon`: Replaces the glyph inside the clear button.
+   * - `copy-icon`: Replaces the glyph inside the copy button.
+   * - `exit-actions`: Controls of your own beside Restart, shown once the process exits, such as a button that opens the whole log.
+   * - `find-actions`: Controls of your own in the find bar, between the count and the buttons that move between matches.
+   * - `find-close-icon`: Replaces the glyph inside the button that closes the find bar.
+   * - `find-icon`: Replaces the glyph inside the find button.
+   * - `find-next-icon`: Replaces the glyph inside the next match button.
+   * - `find-previous-icon`: Replaces the glyph inside the previous match button.
+   * - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
+   * - `label`: The terminal's name in the header, such as an icon beside the shell's name. Replaces `label` there.
+   * - `restart-icon`: Replaces the glyph inside the Restart button.
+   *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `write(data: string | Uint8Array) => Promise<void>`: Writes the program's output. Resolves once the renderer has parsed it,
+   * which is how a page pauses a process that writes faster than the
+   * terminal draws. Output written before a renderer is attached is held and
+   * written first.
+   * - `paste(text: string) => void`: Inputs text as a paste does, in bracketed paste mode where the program
+   * asked for it. It arrives as `helix-terminal-input`, like typed text.
+   * - `clear() => void`: Clears the scrollback, keeping the line the cursor is on.
+   * - `reset() => void`: Resets the emulator: its modes, its colors, and its screen.
+   * - `text(scope: 'all' | 'screen' = 'screen') => string`: The terminal as plain text, as the renderer drew it: the lines on screen,
+   * or with `all`, every line the scrollback holds. Empty before a renderer is
+   * attached.
+   * - `look() => TerminalLook`: The colors and the face the terminal is to be drawn in, as the
+   * `--terminal-*` properties resolve where the frame is. `connectTerminal`
+   * themes the renderer from it. A color nothing sets is left out, so the
+   * renderer keeps its own: the headless tier sets none, and the styled tier
+   * sets every one from the theme.
+   * - `focus(options?: FocusOptions) => void`: Focuses the terminal's input, where a renderer is attached.
+   * - `attach(renderer: TerminalRenderer) => TerminalSink`: Attaches what draws the terminal, and returns how it tells the frame what
+   * happened. `connectTerminal` calls it; a page drawing its own terminal calls
+   * it with its own renderer. Attaching another detaches the first.
+   *
+   * ## CSS Custom Properties
+   *
+   * CSS variables available for styling the component.
+   *
+   * - `--terminal-active-match-background-color`: The ground of the current match of a search.
+   * - `--terminal-active-match-border-color`: The edge of the current match of a search.
+   * - `--terminal-ansi-black`: ANSI black, which codes `30` and `40` draw.
+   * - `--terminal-ansi-blue`: ANSI blue, which codes `34` and `44` draw.
+   * - `--terminal-ansi-bright-black`: ANSI bright black, which codes `90` and `100` draw.
+   * - `--terminal-ansi-bright-blue`: ANSI bright blue, which codes `94` and `104` draw.
+   * - `--terminal-ansi-bright-cyan`: ANSI bright cyan, which codes `96` and `106` draw.
+   * - `--terminal-ansi-bright-green`: ANSI bright green, which codes `92` and `102` draw.
+   * - `--terminal-ansi-bright-magenta`: ANSI bright magenta, which codes `95` and `105` draw.
+   * - `--terminal-ansi-bright-red`: ANSI bright red, which codes `91` and `101` draw.
+   * - `--terminal-ansi-bright-white`: ANSI bright white, which codes `97` and `107` draw.
+   * - `--terminal-ansi-bright-yellow`: ANSI bright yellow, which codes `93` and `103` draw.
+   * - `--terminal-ansi-cyan`: ANSI cyan, which codes `36` and `46` draw.
+   * - `--terminal-ansi-green`: ANSI green, which codes `32` and `42` draw.
+   * - `--terminal-ansi-magenta`: ANSI magenta, which codes `35` and `45` draw.
+   * - `--terminal-ansi-red`: ANSI red, which codes `31` and `41` draw.
+   * - `--terminal-ansi-white`: ANSI white, which codes `37` and `47` draw.
+   * - `--terminal-ansi-yellow`: ANSI yellow, which codes `33` and `43` draw.
+   * - `--terminal-background-color`: The ground of the grid.
+   * - `--terminal-color`: The text of the grid where the program sets no color.
+   * - `--terminal-cursor-color`: The cursor.
+   * - `--terminal-match-background-color`: The ground of every match of a search but the current one.
+   * - `--terminal-scrollbar-thumb-color`: The grid's scrollbar.
+   * - `--terminal-selection-background-color`: The ground of selected text. See-through, so the text keeps its color.
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `actions`: The `actions` slot, first in the header's toolbar.
+   * - `clear`: The button that clears the scrollback.
+   * - `clear-button`: The clear button's inner button.
+   * - `clear-live`: The clear button's live region, which speaks while the button is pending.
+   * - `clear-spinner`: The ring the clear button turns while it is pending.
+   * - `clear-text`: The box the clear button's icon sits in.
+   * - `controls`: The toolbar at the end of the header: your actions, then the built-in buttons, one tab stop that the arrows move along.
+   * - `controls-toolbar`: The box inside the header's toolbar that lays its buttons out.
+   * - `copy`: The button that copies the selection. Disabled while nothing is selected.
+   * - `copy-button`: The copy button's inner button.
+   * - `copy-live`: The copy button's live region, which speaks while the button is pending.
+   * - `copy-spinner`: The ring the copy button turns while it is pending.
+   * - `copy-text`: The box the copy button's icon sits in.
+   * - `exit-actions`: The `exit-actions` slot, beside Restart in the status line.
+   * - `find`: The button that opens and closes the find bar. Expanded while it is open.
+   * - `find-actions`: The `find-actions` slot, first in the find bar's toolbar.
+   * - `find-bar`: The bar under the header where the reader searches the output.
+   * - `find-button`: The find button's inner button.
+   * - `find-close`: The button that closes the find bar.
+   * - `find-close-button`: The find bar's close button's inner button.
+   * - `find-close-live`: The find bar's close button's live region, which speaks while the button is pending.
+   * - `find-close-spinner`: The ring the find bar's close button turns while it is pending.
+   * - `find-close-text`: The box the find bar's close button's icon sits in.
+   * - `find-controls`: The toolbar at the end of the find bar: your find actions, then the buttons that move between matches and close the bar.
+   * - `find-controls-toolbar`: The box inside the find bar's toolbar that lays its buttons out.
+   * - `find-count`: Which match is current and how many there are, such as "3 of 12 matches".
+   * - `find-field`: The search field in the find bar.
+   * - `find-live`: The find button's live region, which speaks while the button is pending.
+   * - `find-next`: The button that moves to the next match.
+   * - `find-next-button`: The next match button's inner button.
+   * - `find-next-live`: The next match button's live region, which speaks while the button is pending.
+   * - `find-next-spinner`: The ring the next match button turns while it is pending.
+   * - `find-next-text`: The box the next match button's icon sits in.
+   * - `find-previous`: The button that moves to the previous match.
+   * - `find-previous-button`: The previous match button's inner button.
+   * - `find-previous-live`: The previous match button's live region, which speaks while the button is pending.
+   * - `find-previous-spinner`: The ring the previous match button turns while it is pending.
+   * - `find-previous-text`: The box the previous match button's icon sits in.
+   * - `find-spinner`: The ring the find button turns while it is pending.
+   * - `find-text`: The box the find button's icon sits in.
+   * - `fullscreen`: The button that makes the terminal fill the screen. Pressed while it does.
+   * - `fullscreen-button`: The fullscreen button's inner button.
+   * - `fullscreen-live`: The fullscreen button's live region, which speaks while the button is pending.
+   * - `fullscreen-spinner`: The ring the fullscreen button turns while it is pending.
+   * - `fullscreen-text`: The box the fullscreen button's icon sits in.
+   * - `header`: The strip above the terminal, with its name, your actions, and the controls.
+   * - `label`: The terminal's name in the header.
+   * - `live`: What screen readers hear after the frame acts: a match count, a copy, or a change to what Tab does. Visually hidden in the styled tier.
+   * - `region`: The named group the terminal sits in.
+   * - `restart`: The button in the status line that asks for a new process after the last one exited.
+   * - `restart-button`: The Restart button's inner button.
+   * - `restart-live`: The Restart button's live region, which speaks while the button is pending.
+   * - `restart-spinner`: The ring the Restart button turns while it is pending.
+   * - `restart-text`: The Restart button's label.
+   * - `status`: The line under the terminal that says the process exited, or that Tab moves focus.
+   * - `viewport`: The box the terminal is drawn in.
+   *
+   * ## CSS States
+   *
+   * These can be used to apply styling when a component is in a given state.
+   *
+   * - `bell`: The program rang the bell, held for a moment for a visual bell.
+   * - `exited`: The process has exited, by `exit-code`.
+   * - `find-open`: The find bar is open.
+   * - `fullscreen`: The terminal fills the screen.
+   * - `tab-moves-focus`: Tab moves focus out of the terminal, after Control+M.
+   * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
+   */
+  "helix-headless-terminal": Partial<
+    HelixHeadlessTerminalProps & BaseProps<HelixHeadlessTerminal, F> & BaseEvents<HelixHeadlessTerminal>
+  >;
+
   /**
    * Renders a `<textarea>`, so the caret, selection, spellcheck, resize handle,
    * and phone keyboard come from the platform. It is in the server markup, so the
@@ -69853,6 +70433,10 @@ export type CustomElements<F extends Framework = "other"> = {
    * tab stop while the toolbar's is elsewhere, so Tab stops once in the
    * toolbar. A composite without one keeps its own tab stop.
    *
+   * A `<slot>` in the toolbar counts as the controls assigned to it, for a
+   * toolbar a component draws in its own shadow root with your controls passed
+   * into it: they share its tab stop and its arrows with the component's own.
+   *
    * A toolbar inside another toolbar, a Helix one or the page's own
    * `role="toolbar"`, is a `group` of the outer one, as React Aria's is: the
    * outer toolbar's arrows walk through its controls and on past them, and it
@@ -100275,6 +100859,269 @@ export type CustomElementsSolidJs = {
       BaseEvents<HelixHeadlessTag>
   >;
 
+  /**
+   * Wraps a terminal drawn by xterm.js or another emulator. The frame adds a
+   * header with the terminal's name and its controls, a find bar, and a status
+   * line. `connectTerminal` in `@fusion.dev/helix-terminal` connects it to the
+   * emulator and draws the terminal in the colors the `--terminal-*` properties
+   * set, which the styled tier sets from your theme. Helix does not start a
+   * process: you connect the stream. Write the program's output with `write()`, send what the
+   * reader types to the process from `helix-terminal-input`, and resize the
+   * process's pseudo-terminal from `helix-terminal-resize`.
+   *
+   * Output written before a renderer is connected is held and written first, so
+   * the process can start before the emulator loads. `write()` resolves once
+   * the renderer has parsed the output, which is how a page pauses a process
+   * that writes faster than the terminal draws.
+   *
+   * The controls are a row in the header, and `controls` names which ones:
+   * `find`, `copy`, `clear`, and `fullscreen`. `find clear` by default. A control
+   * the renderer cannot answer is left out once it is connected. Set `exit-code`
+   * when the process exits: the frame says how it exited, stops sending input,
+   * and shows a Restart button that sends `helix-terminal-restart`.
+   *
+   * **Keyboard.** Every key goes to the program, Tab, Shift+Tab, and Escape
+   * included, except these:
+   *
+   * - Control+Shift+F, or Command+F on a Mac, opens the find bar. Enter and
+   *   Shift+Enter move between the matches, and Escape closes the bar and
+   *   returns focus to the terminal.
+   * - Control+Shift+C copies the selection. On a Mac, Command+C does.
+   * - Control+M, or Control+Shift+M on a Mac, switches Tab between typing in the
+   *   terminal and moving focus out of it. The status line says when Tab moves
+   *   focus, and the terminal's input describes the key to a screen reader.
+   *
+   * **Screen readers.** A terminal draws its grid as a picture of text, so a
+   * screen reader reads nothing in it by default. Set `screen-reader-mode` to
+   * have the renderer keep the grid as lines a screen reader can move through
+   * and announce new output as it arrives, which xterm.js calls screen reader
+   * mode. It costs time on every write, so it is off by default: connect it to
+   * a setting your reader can turn on.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `clear-label`/`clearLabel`: The clear button's label.
+   * - `columns`: The grid's width in character cells. Set it with `rows` to fix the grid's size; unset, the grid fills the frame.
+   * - `controls`: Which built-in controls the header shows, as a list of `find`, `copy`,
+   * `clear`, and `fullscreen`, or `none`. Absent is `find clear`.
+   * - `controls-label`/`controlsLabel`: The name of the row of controls, read by screen readers.
+   * - `copied-label`/`copiedLabel`: What screen readers hear after a copy.
+   * - `copy-label`/`copyLabel`: The copy button's label.
+   * - `exit-code`/`exitCode`: How the process exited, which the page sets when it does. While it is set,
+   * the status line says it, the frame sends no input, and Restart is shown.
+   * Clear it when a new process starts.
+   * - `exited-label`/`exitedLabel`: What the status line says once the process has exited. `{code}` is its
+   * exit code, written as the process gave it, and code `0` is a clean exit.
+   * - `fallback-label`/`fallbackLabel`: The terminal's name where `label` is empty and the host has no `aria-label`.
+   * - `find-close-label`/`findCloseLabel`: The label of the button that closes the find bar.
+   * - `find-controls-label`/`findControlsLabel`: The name of the find bar's row of buttons, read by screen readers.
+   * - `find-label`/`findLabel`: The find button's label, and the find field's name and placeholder.
+   * - `find-next-label`/`findNextLabel`: The next match button's label.
+   * - `find-previous-label`/`findPreviousLabel`: The previous match button's label.
+   * - `fullscreen-label`/`fullscreenLabel`: The fullscreen button's label.
+   * - `input-label`/`inputLabel`: The name of the element the reader types into, which the renderer draws.
+   * - `label`: The terminal's name, in the header and for screen readers, such as the
+   * shell or the folder it runs in. Several terminals on a page need names
+   * that tell them apart.
+   * - `matches-label`/`matchesLabel`: What the find bar says of its matches. `{index}` is the current match,
+   * counting from 1, and `{count}` how many there are.
+   * - `readonly`/`readOnly`: Draws the output and sends no input, with no cursor, for a transcript or
+   * a command an agent ran. The attribute is `readonly`, the platform's
+   * spelling.
+   * - `restart-label`/`restartLabel`: The Restart button's label.
+   * - `rows`: The grid's height in lines. Set it with `columns` to fix the grid's size; unset, the grid fills the frame.
+   * - `screen-reader-mode`/`screenReaderMode`: Keeps the grid as lines a screen reader moves through, and says new
+   * output as it arrives. Off by default, since it costs time on every
+   * write. Connect it to a setting your reader can turn on.
+   * - `tab-hint-label`/`tabHintLabel`: What the terminal's input describes to a screen reader. `{key}` is the key that switches Tab.
+   * - `tab-moves-focus-label`/`tabMovesFocusLabel`: What the status line says while Tab moves focus. `{key}` is the key that switches it back.
+   * - `tab-types-label`/`tabTypesLabel`: What screen readers hear when Tab goes back to typing in the terminal.
+   * - `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-copy`: The copy control or its key put the selection on the clipboard.
+   * - `helix-terminal-bell`: The program rang the bell. The frame flashes once.
+   * - `helix-terminal-input`: The reader typed or pasted, with `data` encoded for the program. Write it to the process. Not sent while `readonly`, or once `exit-code` is set.
+   * - `helix-terminal-link`: A link in the output was activated, with its `href`. Cancelable: cancel it to open the link yourself. Left alone, a web address opens in a new tab.
+   * - `helix-terminal-resize`: The grid changed size, with `columns`, `rows`, `width`, and `height`. Resize the process's pseudo-terminal to match.
+   * - `helix-terminal-restart`: The Restart button was pressed after the process exited. Start a new process and clear `exit-code`.
+   * - `helix-terminal-title`: The program set its title, with `title`. The frame keeps its own `label`.
+   *
+   * ## Slots
+   *
+   * Areas where markup can be added to the component.
+   *
+   * - `(default)`: The element your renderer draws the terminal in.
+   * - `actions`: Controls of your own in the header, before the built-in ones, such as a button that splits the pane.
+   * - `clear-icon`: Replaces the glyph inside the clear button.
+   * - `copy-icon`: Replaces the glyph inside the copy button.
+   * - `exit-actions`: Controls of your own beside Restart, shown once the process exits, such as a button that opens the whole log.
+   * - `find-actions`: Controls of your own in the find bar, between the count and the buttons that move between matches.
+   * - `find-close-icon`: Replaces the glyph inside the button that closes the find bar.
+   * - `find-icon`: Replaces the glyph inside the find button.
+   * - `find-next-icon`: Replaces the glyph inside the next match button.
+   * - `find-previous-icon`: Replaces the glyph inside the previous match button.
+   * - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
+   * - `label`: The terminal's name in the header, such as an icon beside the shell's name. Replaces `label` there.
+   * - `restart-icon`: Replaces the glyph inside the Restart button.
+   *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `write(data: string | Uint8Array) => Promise<void>`: Writes the program's output. Resolves once the renderer has parsed it,
+   * which is how a page pauses a process that writes faster than the
+   * terminal draws. Output written before a renderer is attached is held and
+   * written first.
+   * - `paste(text: string) => void`: Inputs text as a paste does, in bracketed paste mode where the program
+   * asked for it. It arrives as `helix-terminal-input`, like typed text.
+   * - `clear() => void`: Clears the scrollback, keeping the line the cursor is on.
+   * - `reset() => void`: Resets the emulator: its modes, its colors, and its screen.
+   * - `text(scope: 'all' | 'screen' = 'screen') => string`: The terminal as plain text, as the renderer drew it: the lines on screen,
+   * or with `all`, every line the scrollback holds. Empty before a renderer is
+   * attached.
+   * - `look() => TerminalLook`: The colors and the face the terminal is to be drawn in, as the
+   * `--terminal-*` properties resolve where the frame is. `connectTerminal`
+   * themes the renderer from it. A color nothing sets is left out, so the
+   * renderer keeps its own: the headless tier sets none, and the styled tier
+   * sets every one from the theme.
+   * - `focus(options?: FocusOptions) => void`: Focuses the terminal's input, where a renderer is attached.
+   * - `attach(renderer: TerminalRenderer) => TerminalSink`: Attaches what draws the terminal, and returns how it tells the frame what
+   * happened. `connectTerminal` calls it; a page drawing its own terminal calls
+   * it with its own renderer. Attaching another detaches the first.
+   *
+   * ## CSS Custom Properties
+   *
+   * CSS variables available for styling the component.
+   *
+   * - `--terminal-active-match-background-color`: The ground of the current match of a search.
+   * - `--terminal-active-match-border-color`: The edge of the current match of a search.
+   * - `--terminal-ansi-black`: ANSI black, which codes `30` and `40` draw.
+   * - `--terminal-ansi-blue`: ANSI blue, which codes `34` and `44` draw.
+   * - `--terminal-ansi-bright-black`: ANSI bright black, which codes `90` and `100` draw.
+   * - `--terminal-ansi-bright-blue`: ANSI bright blue, which codes `94` and `104` draw.
+   * - `--terminal-ansi-bright-cyan`: ANSI bright cyan, which codes `96` and `106` draw.
+   * - `--terminal-ansi-bright-green`: ANSI bright green, which codes `92` and `102` draw.
+   * - `--terminal-ansi-bright-magenta`: ANSI bright magenta, which codes `95` and `105` draw.
+   * - `--terminal-ansi-bright-red`: ANSI bright red, which codes `91` and `101` draw.
+   * - `--terminal-ansi-bright-white`: ANSI bright white, which codes `97` and `107` draw.
+   * - `--terminal-ansi-bright-yellow`: ANSI bright yellow, which codes `93` and `103` draw.
+   * - `--terminal-ansi-cyan`: ANSI cyan, which codes `36` and `46` draw.
+   * - `--terminal-ansi-green`: ANSI green, which codes `32` and `42` draw.
+   * - `--terminal-ansi-magenta`: ANSI magenta, which codes `35` and `45` draw.
+   * - `--terminal-ansi-red`: ANSI red, which codes `31` and `41` draw.
+   * - `--terminal-ansi-white`: ANSI white, which codes `37` and `47` draw.
+   * - `--terminal-ansi-yellow`: ANSI yellow, which codes `33` and `43` draw.
+   * - `--terminal-background-color`: The ground of the grid.
+   * - `--terminal-color`: The text of the grid where the program sets no color.
+   * - `--terminal-cursor-color`: The cursor.
+   * - `--terminal-match-background-color`: The ground of every match of a search but the current one.
+   * - `--terminal-scrollbar-thumb-color`: The grid's scrollbar.
+   * - `--terminal-selection-background-color`: The ground of selected text. See-through, so the text keeps its color.
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `actions`: The `actions` slot, first in the header's toolbar.
+   * - `clear`: The button that clears the scrollback.
+   * - `clear-button`: The clear button's inner button.
+   * - `clear-live`: The clear button's live region, which speaks while the button is pending.
+   * - `clear-spinner`: The ring the clear button turns while it is pending.
+   * - `clear-text`: The box the clear button's icon sits in.
+   * - `controls`: The toolbar at the end of the header: your actions, then the built-in buttons, one tab stop that the arrows move along.
+   * - `controls-toolbar`: The box inside the header's toolbar that lays its buttons out.
+   * - `copy`: The button that copies the selection. Disabled while nothing is selected.
+   * - `copy-button`: The copy button's inner button.
+   * - `copy-live`: The copy button's live region, which speaks while the button is pending.
+   * - `copy-spinner`: The ring the copy button turns while it is pending.
+   * - `copy-text`: The box the copy button's icon sits in.
+   * - `exit-actions`: The `exit-actions` slot, beside Restart in the status line.
+   * - `find`: The button that opens and closes the find bar. Expanded while it is open.
+   * - `find-actions`: The `find-actions` slot, first in the find bar's toolbar.
+   * - `find-bar`: The bar under the header where the reader searches the output.
+   * - `find-button`: The find button's inner button.
+   * - `find-close`: The button that closes the find bar.
+   * - `find-close-button`: The find bar's close button's inner button.
+   * - `find-close-live`: The find bar's close button's live region, which speaks while the button is pending.
+   * - `find-close-spinner`: The ring the find bar's close button turns while it is pending.
+   * - `find-close-text`: The box the find bar's close button's icon sits in.
+   * - `find-controls`: The toolbar at the end of the find bar: your find actions, then the buttons that move between matches and close the bar.
+   * - `find-controls-toolbar`: The box inside the find bar's toolbar that lays its buttons out.
+   * - `find-count`: Which match is current and how many there are, such as "3 of 12 matches".
+   * - `find-field`: The search field in the find bar.
+   * - `find-live`: The find button's live region, which speaks while the button is pending.
+   * - `find-next`: The button that moves to the next match.
+   * - `find-next-button`: The next match button's inner button.
+   * - `find-next-live`: The next match button's live region, which speaks while the button is pending.
+   * - `find-next-spinner`: The ring the next match button turns while it is pending.
+   * - `find-next-text`: The box the next match button's icon sits in.
+   * - `find-previous`: The button that moves to the previous match.
+   * - `find-previous-button`: The previous match button's inner button.
+   * - `find-previous-live`: The previous match button's live region, which speaks while the button is pending.
+   * - `find-previous-spinner`: The ring the previous match button turns while it is pending.
+   * - `find-previous-text`: The box the previous match button's icon sits in.
+   * - `find-spinner`: The ring the find button turns while it is pending.
+   * - `find-text`: The box the find button's icon sits in.
+   * - `fullscreen`: The button that makes the terminal fill the screen. Pressed while it does.
+   * - `fullscreen-button`: The fullscreen button's inner button.
+   * - `fullscreen-live`: The fullscreen button's live region, which speaks while the button is pending.
+   * - `fullscreen-spinner`: The ring the fullscreen button turns while it is pending.
+   * - `fullscreen-text`: The box the fullscreen button's icon sits in.
+   * - `header`: The strip above the terminal, with its name, your actions, and the controls.
+   * - `label`: The terminal's name in the header.
+   * - `live`: What screen readers hear after the frame acts: a match count, a copy, or a change to what Tab does. Visually hidden in the styled tier.
+   * - `region`: The named group the terminal sits in.
+   * - `restart`: The button in the status line that asks for a new process after the last one exited.
+   * - `restart-button`: The Restart button's inner button.
+   * - `restart-live`: The Restart button's live region, which speaks while the button is pending.
+   * - `restart-spinner`: The ring the Restart button turns while it is pending.
+   * - `restart-text`: The Restart button's label.
+   * - `status`: The line under the terminal that says the process exited, or that Tab moves focus.
+   * - `viewport`: The box the terminal is drawn in.
+   *
+   * ## CSS States
+   *
+   * These can be used to apply styling when a component is in a given state.
+   *
+   * - `bell`: The program rang the bell, held for a moment for a visual bell.
+   * - `exited`: The process has exited, by `exit-code`.
+   * - `find-open`: The find bar is open.
+   * - `fullscreen`: The terminal fills the screen.
+   * - `tab-moves-focus`: Tab moves focus out of the terminal, after Control+M.
+   * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
+   */
+  "helix-headless-terminal": Partial<
+    HelixHeadlessTerminalProps &
+      HelixHeadlessTerminalSolidJsProps &
+      BaseProps<HelixHeadlessTerminal, "solid"> &
+      BaseEvents<HelixHeadlessTerminal>
+  >;
+
   /**
    * Renders a `<textarea>`, so the caret, selection, spellcheck, resize handle,
    * and phone keyboard come from the platform. It is in the server markup, so the
@@ -102571,6 +103418,10 @@ export type CustomElementsSolidJs = {
    * tab stop while the toolbar's is elsewhere, so Tab stops once in the
    * toolbar. A composite without one keeps its own tab stop.
    *
+   * A `<slot>` in the toolbar counts as the controls assigned to it, for a
+   * toolbar a component draws in its own shadow root with your controls passed
+   * into it: they share its tab stop and its arrows with the component's own.
+   *
    * A toolbar inside another toolbar, a Helix one or the page's own
    * `role="toolbar"`, is a `group` of the outer one, as React Aria's is: the
    * outer toolbar's arrows walk through its controls and on past them, and it
@@ -105305,6 +106156,54 @@ export type CustomCssProperties = {
   "--table-template"?: (string) | undefined;
   /** Written by the row on its `expand` cell: how deep the row sits, from 1. Do not set it. */
   "--table-row-level"?: (string) | undefined;
+  /** The ground of the current match of a search. */
+  "--terminal-active-match-background-color"?: (string) | undefined;
+  /** The edge of the current match of a search. */
+  "--terminal-active-match-border-color"?: (string) | undefined;
+  /** ANSI black, which codes `30` and `40` draw. */
+  "--terminal-ansi-black"?: (string) | undefined;
+  /** ANSI blue, which codes `34` and `44` draw. */
+  "--terminal-ansi-blue"?: (string) | undefined;
+  /** ANSI bright black, which codes `90` and `100` draw. */
+  "--terminal-ansi-bright-black"?: (string) | undefined;
+  /** ANSI bright blue, which codes `94` and `104` draw. */
+  "--terminal-ansi-bright-blue"?: (string) | undefined;
+  /** ANSI bright cyan, which codes `96` and `106` draw. */
+  "--terminal-ansi-bright-cyan"?: (string) | undefined;
+  /** ANSI bright green, which codes `92` and `102` draw. */
+  "--terminal-ansi-bright-green"?: (string) | undefined;
+  /** ANSI bright magenta, which codes `95` and `105` draw. */
+  "--terminal-ansi-bright-magenta"?: (string) | undefined;
+  /** ANSI bright red, which codes `91` and `101` draw. */
+  "--terminal-ansi-bright-red"?: (string) | undefined;
+  /** ANSI bright white, which codes `97` and `107` draw. */
+  "--terminal-ansi-bright-white"?: (string) | undefined;
+  /** ANSI bright yellow, which codes `93` and `103` draw. */
+  "--terminal-ansi-bright-yellow"?: (string) | undefined;
+  /** ANSI cyan, which codes `36` and `46` draw. */
+  "--terminal-ansi-cyan"?: (string) | undefined;
+  /** ANSI green, which codes `32` and `42` draw. */
+  "--terminal-ansi-green"?: (string) | undefined;
+  /** ANSI magenta, which codes `35` and `45` draw. */
+  "--terminal-ansi-magenta"?: (string) | undefined;
+  /** ANSI red, which codes `31` and `41` draw. */
+  "--terminal-ansi-red"?: (string) | undefined;
+  /** ANSI white, which codes `37` and `47` draw. */
+  "--terminal-ansi-white"?: (string) | undefined;
+  /** ANSI yellow, which codes `33` and `43` draw. */
+  "--terminal-ansi-yellow"?: (string) | undefined;
+  /** The ground of the grid. */
+  "--terminal-background-color"?: (string) | undefined;
+  /** The text of the grid where the program sets no color. */
+  "--terminal-color"?: (string) | undefined;
+  /** The cursor. */
+  "--terminal-cursor-color"?: (string) | undefined;
+  /** The ground of every match of a search but the current one. */
+  "--terminal-match-background-color"?: (string) | undefined;
+  /** The grid's scrollbar. */
+  "--terminal-scrollbar-thumb-color"?: (string) | undefined;
+  /** The ground of selected text. See-through, so the text keeps its color. */
+  "--terminal-selection-background-color"?: (string) | undefined;
   /** How long this message stays, in milliseconds, for a progress hint. */
   "--toast-duration"?: (string) | undefined;
   /** How far a swipe has moved the message across, in pixels, toward the right. */