@fusion.dev/helix-headless 0.203.0 → 0.204.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-headless",
   "description": "Headless component tier. Structure, accessibility, state, and form participation. No styling.",
-  "version": "0.203.0",
+  "version": "0.204.1",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -53,14 +53,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.203.0",
-    "@fusion.dev/helix-icons": "0.203.0",
+    "@fusion.dev/helix-core": "0.204.1",
+    "@fusion.dev/helix-icons": "0.204.1",
     "tslib": "^2.8.1",
     "uqr": "^0.1.3"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.203.0",
-    "@fusion.dev/helix-testing": "0.203.0",
+    "@fusion.dev/helix-cem": "0.204.1",
+    "@fusion.dev/helix-testing": "0.204.1",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.14.5",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -19811,6 +19811,12 @@ export type HelixHeadlessLogHelixExpandElementEvent =
 /** `helix-pin` event type */
 export type HelixHeadlessLogHelixPinElementEvent =
   HelixHeadlessLogElementEvent<HelixPinEvent>;
+/** `helix-select` event type */
+export type HelixHeadlessLogHelixSelectElementEvent =
+  HelixHeadlessLogElementEvent<HelixSelectEvent>;
+/** `helix-selected` event type */
+export type HelixHeadlessLogHelixSelectedElementEvent =
+  HelixHeadlessLogElementEvent<HelixSelectedEvent>;
 
 export type HelixHeadlessLogProps = {
   /** Whether the log opens following its newest line, when `pinned` is not set.
@@ -19846,6 +19852,11 @@ many arrived together and `{text}` is the first of them. */
   "fallback-label"?: (HelixHeadlessLog["fallbackLabel"]) | undefined;
   /** The log's name, read by screen readers, where `label` is empty. */
   fallbackLabel?: (HelixHeadlessLog["fallbackLabel"]) | undefined;
+  /** The format written text is in, read with a parser Helix ships:
+`github-actions` reads a GitHub Actions log's workflow commands into steps
+and levels, and `vercel` a Vercel build log's phases and warnings. Absent
+reads none. `parse` wins over it. */
+  format?: (HelixHeadlessLog["format"]) | undefined;
   /** What a screen reader hears when a step finishes or fails. `{heading}` is
 the step's heading and `{status}` is `done` or `failed`. */
   "group-label"?: (HelixHeadlessLog["groupLabel"]) | undefined;
@@ -19894,6 +19905,16 @@ true would write the attribute on upgrade. */
   "resume-label"?: (HelixHeadlessLog["resumeLabel"]) | undefined;
   /** The words on the button that returns to the newest line, where `resume` is empty. */
   resumeLabel?: (HelixHeadlessLog["resumeLabel"]) | undefined;
+  /** Whether pressing a line's number selects the line, and pressing another
+with Shift selects every line between them. Each number is then a
+button, or a link with `line-href`, and the arrow keys move between them. */
+  selectable?: (HelixHeadlessLog["selectable"]) | undefined;
+  /** The lines selected, as a number or a range such as `12-20`. Empty selects
+none. A reader's press asks first: `helix-select` is cancelable. */
+  "selected-lines"?: (HelixHeadlessLog["selectedLines"]) | undefined;
+  /** The lines selected, as a number or a range such as `12-20`. Empty selects
+none. A reader's press asks first: `helix-select` is cancelable. */
+  selectedLines?: (HelixHeadlessLog["selectedLines"]) | undefined;
   /** How near the newest line still counts as being at it, in pixels. */
   threshold?: (HelixHeadlessLog["threshold"]) | undefined;
   /** How each line shows its `at`: `absolute` on the clock, `relative` as the
@@ -19924,8 +19945,8 @@ Replaced rather than mutated: setting it starts the log over with these
 lines, and `write` adds to them. Set it or write children, not both. */
   lines?: (HelixHeadlessLog["lines"]) | undefined;
   /** Reads each finished line of written text: return the fields to set, such
-as `level` or `group`, or `null` to drop the line. Lines in `lines` are
-taken as they are. */
+as `level`, `open` or `close` to start or end a step, or `null` to drop
+the line. Lines in `lines` are taken as they are. Wins over `format`. */
   parse?: (HelixHeadlessLog["parse"]) | undefined;
   /** Text to read as it arrives, to the end: a `ReadableStream` of text or
 bytes, such as a `fetch` response's body, or an async iterable. Bytes are
@@ -19937,10 +19958,14 @@ reading the last one. */
   "onhelix-before-pin"?: ((
     e: HelixHeadlessLogHelixBeforePinElementEvent,
   ) => void) | undefined;
-  /** Fired after a reader opens or closes a group drawn from `groups`, with the `id` of every open group in `detail.value`, separated by commas. */
+  /** Fired after a reader opens or closes a step drawn from `groups` or opened by a parser, with the `id` of every open group in `detail.value`, separated by commas. */
   "onhelix-expand"?: ((e: HelixHeadlessLogHelixExpandElementEvent) => void) | undefined;
   /** Fired after the log follows the newest line or lets go of it, with `true` or `false` in `detail.value`. */
   "onhelix-pin"?: ((e: HelixHeadlessLogHelixPinElementEvent) => void) | undefined;
+  /** Fired when a reader presses a number to change the selection, with the lines asked for in `detail.value`. Cancelable. */
+  "onhelix-select"?: ((e: HelixHeadlessLogHelixSelectElementEvent) => void) | undefined;
+  /** Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`. */
+  "onhelix-selected"?: ((e: HelixHeadlessLogHelixSelectedElementEvent) => void) | undefined;
 };
 
 export type HelixHeadlessLogSolidJsProps = {
@@ -19977,6 +20002,11 @@ many arrived together and `{text}` is the first of them. */
   "attr:fallback-label"?: (HelixHeadlessLog["fallbackLabel"]) | undefined;
   /** The log's name, read by screen readers, where `label` is empty. */
   "prop:fallbackLabel"?: (HelixHeadlessLog["fallbackLabel"]) | undefined;
+  /** The format written text is in, read with a parser Helix ships:
+`github-actions` reads a GitHub Actions log's workflow commands into steps
+and levels, and `vercel` a Vercel build log's phases and warnings. Absent
+reads none. `parse` wins over it. */
+  "prop:format"?: (HelixHeadlessLog["format"]) | undefined;
   /** What a screen reader hears when a step finishes or fails. `{heading}` is
 the step's heading and `{status}` is `done` or `failed`. */
   "attr:group-label"?: (HelixHeadlessLog["groupLabel"]) | undefined;
@@ -20025,6 +20055,16 @@ true would write the attribute on upgrade. */
   "attr:resume-label"?: (HelixHeadlessLog["resumeLabel"]) | undefined;
   /** The words on the button that returns to the newest line, where `resume` is empty. */
   "prop:resumeLabel"?: (HelixHeadlessLog["resumeLabel"]) | undefined;
+  /** Whether pressing a line's number selects the line, and pressing another
+with Shift selects every line between them. Each number is then a
+button, or a link with `line-href`, and the arrow keys move between them. */
+  "prop:selectable"?: (HelixHeadlessLog["selectable"]) | undefined;
+  /** The lines selected, as a number or a range such as `12-20`. Empty selects
+none. A reader's press asks first: `helix-select` is cancelable. */
+  "attr:selected-lines"?: (HelixHeadlessLog["selectedLines"]) | undefined;
+  /** The lines selected, as a number or a range such as `12-20`. Empty selects
+none. A reader's press asks first: `helix-select` is cancelable. */
+  "prop:selectedLines"?: (HelixHeadlessLog["selectedLines"]) | undefined;
   /** How near the newest line still counts as being at it, in pixels. */
   "prop:threshold"?: (HelixHeadlessLog["threshold"]) | undefined;
   /** How each line shows its `at`: `absolute` on the clock, `relative` as the
@@ -20055,8 +20095,8 @@ Replaced rather than mutated: setting it starts the log over with these
 lines, and `write` adds to them. Set it or write children, not both. */
   "prop:lines"?: (HelixHeadlessLog["lines"]) | undefined;
   /** Reads each finished line of written text: return the fields to set, such
-as `level` or `group`, or `null` to drop the line. Lines in `lines` are
-taken as they are. */
+as `level`, `open` or `close` to start or end a step, or `null` to drop
+the line. Lines in `lines` are taken as they are. Wins over `format`. */
   "prop:parse"?: (HelixHeadlessLog["parse"]) | undefined;
   /** Text to read as it arrives, to the end: a `ReadableStream` of text or
 bytes, such as a `fetch` response's body, or an async iterable. Bytes are
@@ -20067,10 +20107,14 @@ reading the last one. */
   "on:helix-before-pin"?: ((
     e: HelixHeadlessLogHelixBeforePinElementEvent,
   ) => void) | undefined;
-  /** Fired after a reader opens or closes a group drawn from `groups`, with the `id` of every open group in `detail.value`, separated by commas. */
+  /** Fired after a reader opens or closes a step drawn from `groups` or opened by a parser, with the `id` of every open group in `detail.value`, separated by commas. */
   "on:helix-expand"?: ((e: HelixHeadlessLogHelixExpandElementEvent) => void) | undefined;
   /** Fired after the log follows the newest line or lets go of it, with `true` or `false` in `detail.value`. */
   "on:helix-pin"?: ((e: HelixHeadlessLogHelixPinElementEvent) => void) | undefined;
+  /** Fired when a reader presses a number to change the selection, with the lines asked for in `detail.value`. Cancelable. */
+  "on:helix-select"?: ((e: HelixHeadlessLogHelixSelectElementEvent) => void) | undefined;
+  /** Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`. */
+  "on:helix-selected"?: ((e: HelixHeadlessLogHelixSelectedElementEvent) => void) | undefined;
 
   /** Set the innerHTML of the element */
   innerHTML?: (string) | undefined;
@@ -54785,9 +54829,10 @@ export type CustomElements = {
    * - `line-debug`: The row of a line at `debug`.
    * - `line-error`: The row of a line at `error`.
    * - `line-marked`: The row of a line `mark-lines` names on the log.
+   * - `line-selected`: The row of a line in the log's selection.
    * - `line-warn`: The row of a line at `warn`.
    * - `match`: Text that matches the log's `query`, in a line the log draws from data.
-   * - `number`: The line's number, shown with `line-numbers`, and a link with `line-href`.
+   * - `number`: The line's number, shown with `line-numbers`: a link with `line-href`, and a button on a `selectable` log.
    * - `run`: A stretch of text drawn in an ANSI style, in a line the log draws from data. Its color is `--log-run-color` and its background `--log-run-background-color`.
    * - `run-bold`: A run drawn bold.
    * - `run-dim`: A run drawn faint.
@@ -54827,8 +54872,15 @@ export type CustomElements = {
    * starts the line over, so a progress bar stays one line, and the line still
    * being written is shown as it stands. ANSI colors and weights are drawn, in
    * the sixteen colors the styled tier takes from your theme, and every other
-   * escape code is dropped. Give `parse` a function to read each finished line,
-   * such as a level off its prefix or a group off a marker.
+   * escape code is dropped.
+   *
+   * **Read a CI log's own markers with `format`.** `github-actions` reads the
+   * workflow commands a step writes, `::group::` and `::error::` among them,
+   * and the times at the start of a downloaded log. `vercel` reads a Vercel
+   * build log's phases and its warnings. Each step opens as it starts, folds
+   * once it passes, stays open where it failed, and is timed from its lines.
+   * For any other log, give `parse` a function that reads each finished line:
+   * it returns a level, a group, or `open` and `close` to start and end a step.
    *
    * **Steps fold.** Lines that name a group in `groups` stand under its heading,
    * which shows its status and how long it took and opens and closes the lines.
@@ -54843,6 +54895,18 @@ export type CustomElements = {
    * to one. `timestamps` shows each line's `at`, on the clock or as the time
    * into the run. `mark-lines` marks lines, such as `12, 40-44`.
    *
+   * **`selectable` lets a reader select lines**, as a code host does: pressing a
+   * number selects its line, and pressing another with Shift selects every line
+   * between them. `selected-lines` holds the selection, such as `12-20`, and
+   * `helix-select` asks before it changes. With a `line-href` that is a
+   * fragment, the address follows the selection, `#L12` or `#L12-L20`, and a
+   * page opened at one selects it and scrolls to it.
+   *
+   * **The numbers are one tab stop.** Where they are links or buttons, Tab
+   * reaches the one a reader last used, or the first selected, and the arrow
+   * keys move between them, with Home and End for the first and the last. With
+   * Shift on a `selectable` log, the selection follows.
+   *
    * **What a screen reader hears.** The log is a `log` and stays quiet as lines
    * arrive, since reading a build aloud line by line helps nobody. A separate
    * status region says each line at `error` once it arrives, each step once it
@@ -54873,6 +54937,10 @@ export type CustomElements = {
    * - `error-label`/`errorLabel`: What a screen reader hears when lines at `error` arrive. `{count}` is how
    * many arrived together and `{text}` is the first of them.
    * - `fallback-label`/`fallbackLabel`: The log's name, read by screen readers, where `label` is empty.
+   * - `format`: The format written text is in, read with a parser Helix ships:
+   * `github-actions` reads a GitHub Actions log's workflow commands into steps
+   * and levels, and `vercel` a Vercel build log's phases and warnings. Absent
+   * reads none. `parse` wins over it.
    * - `group-label`/`groupLabel`: What a screen reader hears when a step finishes or fails. `{heading}` is
    * the step's heading and `{status}` is `done` or `failed`.
    * - `label`: The log's name, read by screen readers.
@@ -54893,6 +54961,11 @@ export type CustomElements = {
    * true would write the attribute on upgrade.
    * - `query`: Text a line has to hold to be shown, ignoring case. Empty shows every line.
    * - `resume-label`/`resumeLabel`: The words on the button that returns to the newest line, where `resume` is empty.
+   * - `selectable`: Whether pressing a line's number selects the line, and pressing another
+   * with Shift selects every line between them. Each number is then a
+   * button, or a link with `line-href`, and the arrow keys move between them.
+   * - `selected-lines`/`selectedLines`: The lines selected, as a number or a range such as `12-20`. Empty selects
+   * none. A reader's press asks first: `helix-select` is cancelable.
    * - `threshold`: How near the newest line still counts as being at it, in pixels.
    * - `timestamps`: How each line shows its `at`: `absolute` on the clock, `relative` as the
    * time since the first line. Absent shows no time.
@@ -54914,8 +54987,8 @@ export type CustomElements = {
    * Replaced rather than mutated: setting it starts the log over with these
    * lines, and `write` adds to them. Set it or write children, not both. (property only)
    * - `parse`: Reads each finished line of written text: return the fields to set, such
-   * as `level` or `group`, or `null` to drop the line. Lines in `lines` are
-   * taken as they are. (property only)
+   * as `level`, `open` or `close` to start or end a step, or `null` to drop
+   * the line. Lines in `lines` are taken as they are. Wins over `format`. (property only)
    * - `source`: Text to read as it arrives, to the end: a `ReadableStream` of text or
    * bytes, such as a `fetch` response's body, or an async iterable. Bytes are
    * read as UTF-8. The log sets `done` when it ends, and a new source stops
@@ -54948,8 +55021,10 @@ export type CustomElements = {
    * Events that will be emitted by the component.
    *
    * - `helix-before-pin`: Fired when the reader leaves the newest line by scrolling, or comes back to it. Cancelable.
-   * - `helix-expand`: Fired after a reader opens or closes a group drawn from `groups`, with the `id` of every open group in `detail.value`, separated by commas.
+   * - `helix-expand`: Fired after a reader opens or closes a step drawn from `groups` or opened by a parser, with the `id` of every open group in `detail.value`, separated by commas.
    * - `helix-pin`: Fired after the log follows the newest line or lets go of it, with `true` or `false` in `detail.value`.
+   * - `helix-select`: Fired when a reader presses a number to change the selection, with the lines asked for in `detail.value`. Cancelable.
+   * - `helix-selected`: Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`.
    *
    * ## Slots
    *
@@ -55028,6 +55103,7 @@ export type CustomElements = {
    * - `line-run-italic`: A run drawn italic.
    * - `line-run-strike`: A run drawn struck through.
    * - `line-run-underline`: A run drawn underlined.
+   * - `line-selected`: The row of a line drawn from data that is selected.
    * - `line-text`: The text of a line drawn from data.
    * - `line-time`: The time of a line drawn from data.
    * - `line-warn`: The row of a line drawn from data at `warn`.
@@ -87097,9 +87173,10 @@ export type CustomElementsSolidJs = {
    * - `line-debug`: The row of a line at `debug`.
    * - `line-error`: The row of a line at `error`.
    * - `line-marked`: The row of a line `mark-lines` names on the log.
+   * - `line-selected`: The row of a line in the log's selection.
    * - `line-warn`: The row of a line at `warn`.
    * - `match`: Text that matches the log's `query`, in a line the log draws from data.
-   * - `number`: The line's number, shown with `line-numbers`, and a link with `line-href`.
+   * - `number`: The line's number, shown with `line-numbers`: a link with `line-href`, and a button on a `selectable` log.
    * - `run`: A stretch of text drawn in an ANSI style, in a line the log draws from data. Its color is `--log-run-color` and its background `--log-run-background-color`.
    * - `run-bold`: A run drawn bold.
    * - `run-dim`: A run drawn faint.
@@ -87142,8 +87219,15 @@ export type CustomElementsSolidJs = {
    * starts the line over, so a progress bar stays one line, and the line still
    * being written is shown as it stands. ANSI colors and weights are drawn, in
    * the sixteen colors the styled tier takes from your theme, and every other
-   * escape code is dropped. Give `parse` a function to read each finished line,
-   * such as a level off its prefix or a group off a marker.
+   * escape code is dropped.
+   *
+   * **Read a CI log's own markers with `format`.** `github-actions` reads the
+   * workflow commands a step writes, `::group::` and `::error::` among them,
+   * and the times at the start of a downloaded log. `vercel` reads a Vercel
+   * build log's phases and its warnings. Each step opens as it starts, folds
+   * once it passes, stays open where it failed, and is timed from its lines.
+   * For any other log, give `parse` a function that reads each finished line:
+   * it returns a level, a group, or `open` and `close` to start and end a step.
    *
    * **Steps fold.** Lines that name a group in `groups` stand under its heading,
    * which shows its status and how long it took and opens and closes the lines.
@@ -87158,6 +87242,18 @@ export type CustomElementsSolidJs = {
    * to one. `timestamps` shows each line's `at`, on the clock or as the time
    * into the run. `mark-lines` marks lines, such as `12, 40-44`.
    *
+   * **`selectable` lets a reader select lines**, as a code host does: pressing a
+   * number selects its line, and pressing another with Shift selects every line
+   * between them. `selected-lines` holds the selection, such as `12-20`, and
+   * `helix-select` asks before it changes. With a `line-href` that is a
+   * fragment, the address follows the selection, `#L12` or `#L12-L20`, and a
+   * page opened at one selects it and scrolls to it.
+   *
+   * **The numbers are one tab stop.** Where they are links or buttons, Tab
+   * reaches the one a reader last used, or the first selected, and the arrow
+   * keys move between them, with Home and End for the first and the last. With
+   * Shift on a `selectable` log, the selection follows.
+   *
    * **What a screen reader hears.** The log is a `log` and stays quiet as lines
    * arrive, since reading a build aloud line by line helps nobody. A separate
    * status region says each line at `error` once it arrives, each step once it
@@ -87188,6 +87284,10 @@ export type CustomElementsSolidJs = {
    * - `error-label`/`errorLabel`: What a screen reader hears when lines at `error` arrive. `{count}` is how
    * many arrived together and `{text}` is the first of them.
    * - `fallback-label`/`fallbackLabel`: The log's name, read by screen readers, where `label` is empty.
+   * - `format`: The format written text is in, read with a parser Helix ships:
+   * `github-actions` reads a GitHub Actions log's workflow commands into steps
+   * and levels, and `vercel` a Vercel build log's phases and warnings. Absent
+   * reads none. `parse` wins over it.
    * - `group-label`/`groupLabel`: What a screen reader hears when a step finishes or fails. `{heading}` is
    * the step's heading and `{status}` is `done` or `failed`.
    * - `label`: The log's name, read by screen readers.
@@ -87208,6 +87308,11 @@ export type CustomElementsSolidJs = {
    * true would write the attribute on upgrade.
    * - `query`: Text a line has to hold to be shown, ignoring case. Empty shows every line.
    * - `resume-label`/`resumeLabel`: The words on the button that returns to the newest line, where `resume` is empty.
+   * - `selectable`: Whether pressing a line's number selects the line, and pressing another
+   * with Shift selects every line between them. Each number is then a
+   * button, or a link with `line-href`, and the arrow keys move between them.
+   * - `selected-lines`/`selectedLines`: The lines selected, as a number or a range such as `12-20`. Empty selects
+   * none. A reader's press asks first: `helix-select` is cancelable.
    * - `threshold`: How near the newest line still counts as being at it, in pixels.
    * - `timestamps`: How each line shows its `at`: `absolute` on the clock, `relative` as the
    * time since the first line. Absent shows no time.
@@ -87229,8 +87334,8 @@ export type CustomElementsSolidJs = {
    * Replaced rather than mutated: setting it starts the log over with these
    * lines, and `write` adds to them. Set it or write children, not both. (property only)
    * - `parse`: Reads each finished line of written text: return the fields to set, such
-   * as `level` or `group`, or `null` to drop the line. Lines in `lines` are
-   * taken as they are. (property only)
+   * as `level`, `open` or `close` to start or end a step, or `null` to drop
+   * the line. Lines in `lines` are taken as they are. Wins over `format`. (property only)
    * - `source`: Text to read as it arrives, to the end: a `ReadableStream` of text or
    * bytes, such as a `fetch` response's body, or an async iterable. Bytes are
    * read as UTF-8. The log sets `done` when it ends, and a new source stops
@@ -87263,8 +87368,10 @@ export type CustomElementsSolidJs = {
    * Events that will be emitted by the component.
    *
    * - `helix-before-pin`: Fired when the reader leaves the newest line by scrolling, or comes back to it. Cancelable.
-   * - `helix-expand`: Fired after a reader opens or closes a group drawn from `groups`, with the `id` of every open group in `detail.value`, separated by commas.
+   * - `helix-expand`: Fired after a reader opens or closes a step drawn from `groups` or opened by a parser, with the `id` of every open group in `detail.value`, separated by commas.
    * - `helix-pin`: Fired after the log follows the newest line or lets go of it, with `true` or `false` in `detail.value`.
+   * - `helix-select`: Fired when a reader presses a number to change the selection, with the lines asked for in `detail.value`. Cancelable.
+   * - `helix-selected`: Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`.
    *
    * ## Slots
    *
@@ -87343,6 +87450,7 @@ export type CustomElementsSolidJs = {
    * - `line-run-italic`: A run drawn italic.
    * - `line-run-strike`: A run drawn struck through.
    * - `line-run-underline`: A run drawn underlined.
+   * - `line-selected`: The row of a line drawn from data that is selected.
    * - `line-text`: The text of a line drawn from data.
    * - `line-time`: The time of a line drawn from data.
    * - `line-warn`: The row of a line drawn from data at `warn`.

package/types/vue.d.ts

@@ -84,7 +84,6 @@ import type {
   HelixHeadlessListbox,
   HelixHeadlessLoader,
   HelixHeadlessLogGroup,
-  timeOf,
   HelixHeadlessLogLine,
   HelixHeadlessLog,
   HelixHeadlessMapArea,
@@ -10137,6 +10136,12 @@ export type HelixHeadlessLogHelixExpandElementEvent =
 /** `helix-pin` event type */
 export type HelixHeadlessLogHelixPinElementEvent =
   HelixHeadlessLogElementEvent<HelixPinEvent>;
+/** `helix-select` event type */
+export type HelixHeadlessLogHelixSelectElementEvent =
+  HelixHeadlessLogElementEvent<HelixSelectEvent>;
+/** `helix-selected` event type */
+export type HelixHeadlessLogHelixSelectedElementEvent =
+  HelixHeadlessLogElementEvent<HelixSelectedEvent>;
 
 export type HelixHeadlessLogVueProps = {
   /** Whether the log opens following its newest line, when `pinned` is not set.
@@ -10172,6 +10177,11 @@ many arrived together and `{text}` is the first of them. */
   "fallback-label"?: (HelixHeadlessLog["fallbackLabel"]) | undefined;
   /** The log's name, read by screen readers, where `label` is empty. */
   fallbackLabel?: (HelixHeadlessLog["fallbackLabel"]) | undefined;
+  /** The format written text is in, read with a parser Helix ships:
+`github-actions` reads a GitHub Actions log's workflow commands into steps
+and levels, and `vercel` a Vercel build log's phases and warnings. Absent
+reads none. `parse` wins over it. */
+  format?: (HelixHeadlessLog["format"]) | undefined;
   /** What a screen reader hears when a step finishes or fails. `{heading}` is
 the step's heading and `{status}` is `done` or `failed`. */
   "group-label"?: (HelixHeadlessLog["groupLabel"]) | undefined;
@@ -10220,6 +10230,16 @@ true would write the attribute on upgrade. */
   "resume-label"?: (HelixHeadlessLog["resumeLabel"]) | undefined;
   /** The words on the button that returns to the newest line, where `resume` is empty. */
   resumeLabel?: (HelixHeadlessLog["resumeLabel"]) | undefined;
+  /** Whether pressing a line's number selects the line, and pressing another
+with Shift selects every line between them. Each number is then a
+button, or a link with `line-href`, and the arrow keys move between them. */
+  selectable?: (HelixHeadlessLog["selectable"]) | undefined;
+  /** The lines selected, as a number or a range such as `12-20`. Empty selects
+none. A reader's press asks first: `helix-select` is cancelable. */
+  "selected-lines"?: (HelixHeadlessLog["selectedLines"]) | undefined;
+  /** The lines selected, as a number or a range such as `12-20`. Empty selects
+none. A reader's press asks first: `helix-select` is cancelable. */
+  selectedLines?: (HelixHeadlessLog["selectedLines"]) | undefined;
   /** How near the newest line still counts as being at it, in pixels. */
   threshold?: (HelixHeadlessLog["threshold"]) | undefined;
   /** How each line shows its `at`: `absolute` on the clock, `relative` as the
@@ -10250,8 +10270,8 @@ Replaced rather than mutated: setting it starts the log over with these
 lines, and `write` adds to them. Set it or write children, not both. */
   lines?: (HelixHeadlessLog["lines"]) | undefined;
   /** Reads each finished line of written text: return the fields to set, such
-as `level` or `group`, or `null` to drop the line. Lines in `lines` are
-taken as they are. */
+as `level`, `open` or `close` to start or end a step, or `null` to drop
+the line. Lines in `lines` are taken as they are. Wins over `format`. */
   parse?: (HelixHeadlessLog["parse"]) | undefined;
   /** Text to read as it arrives, to the end: a `ReadableStream` of text or
 bytes, such as a `fetch` response's body, or an async iterable. Bytes are
@@ -10263,10 +10283,14 @@ reading the last one. */
 export type HelixHeadlessLogVueEvents = {
   /** Fired when the reader leaves the newest line by scrolling, or comes back to it. Cancelable. */
   "helix-before-pin": HelixHeadlessLogHelixBeforePinElementEvent;
-  /** Fired after a reader opens or closes a group drawn from `groups`, with the `id` of every open group in `detail.value`, separated by commas. */
+  /** Fired after a reader opens or closes a step drawn from `groups` or opened by a parser, with the `id` of every open group in `detail.value`, separated by commas. */
   "helix-expand": HelixHeadlessLogHelixExpandElementEvent;
   /** Fired after the log follows the newest line or lets go of it, with `true` or `false` in `detail.value`. */
   "helix-pin": HelixHeadlessLogHelixPinElementEvent;
+  /** Fired when a reader presses a number to change the selection, with the lines asked for in `detail.value`. Cancelable. */
+  "helix-select": HelixHeadlessLogHelixSelectElementEvent;
+  /** Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`. */
+  "helix-selected": HelixHeadlessLogHelixSelectedElementEvent;
 };
 
 /** `HelixHeadlessMapArea` component event */
@@ -21012,7 +21036,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessLogLineVueProps,
     HelixHeadlessLogLineVueEvents
   >;
-  /** A log holds lines in the order they were written and keeps the reader at the newest one, until they scroll up to read. It stays where they left it while lines keep arriving, and a button returns them to the end ('resume-label', "Jump to latest").  **Lines arrive two ways.** For a log you serve whole, write 'Log.Line' elements as children, inside 'Log.Group' elements for the steps. For a log that is still being written, hand it text: 'write(chunk)' takes text as it arrives, in pieces that need not end at a line break, and 'source' takes a 'ReadableStream' or an async iterable and reads it to the end. 'lines' takes the lines as data. Text drawn from data is drawn one window at a time, so a log of a hundred thousand lines holds a screenful of elements, and the log needs a block size of its own. Do not use both ways at once.  **Written text is read the way a terminal shows it.** A carriage return starts the line over, so a progress bar stays one line, and the line still being written is shown as it stands. ANSI colors and weights are drawn, in the sixteen colors the styled tier takes from your theme, and every other escape code is dropped. Give 'parse' a function to read each finished line, such as a level off its prefix or a group off a marker.  **Steps fold.** Lines that name a group in 'groups' stand under its heading, which shows its status and how long it took and opens and closes the lines. A group a reader opens or closes fires 'helix-expand' with every open group.  **Search with 'query'.** The log shows only the lines that hold it, marks each match, opens the groups that hold one, and says how many lines match.  'line-numbers' numbers the lines from the first ever written, so a number still names its line once 'limit' has let older lines go, and 'line-href' makes each number a link, such as '#L{n}'. 'scrollToLine(n)' takes a reader to one. 'timestamps' shows each line's 'at', on the clock or as the time into the run. 'mark-lines' marks lines, such as '12, 40-44'.  **What a screen reader hears.** The log is a 'log' and stays quiet as lines arrive, since reading a build aloud line by line helps nobody. A separate status region says each line at 'error' once it arrives, each step once it finishes or fails, and the end of the run once 'done' is set or 'source' ends. Set 'done' yourself when output you 'write' is complete.  The log scrolls on this tier. It carries 'data-scroller', so following the newest line and drawing a window work with no stylesheet. Give the log a block size, such as 'helix-headless-log::part(log) { block-size: 20rem }'.  '''js import '@fusion.dev/helix/log' ''' */
+  /** A log holds lines in the order they were written and keeps the reader at the newest one, until they scroll up to read. It stays where they left it while lines keep arriving, and a button returns them to the end ('resume-label', "Jump to latest").  **Lines arrive two ways.** For a log you serve whole, write 'Log.Line' elements as children, inside 'Log.Group' elements for the steps. For a log that is still being written, hand it text: 'write(chunk)' takes text as it arrives, in pieces that need not end at a line break, and 'source' takes a 'ReadableStream' or an async iterable and reads it to the end. 'lines' takes the lines as data. Text drawn from data is drawn one window at a time, so a log of a hundred thousand lines holds a screenful of elements, and the log needs a block size of its own. Do not use both ways at once.  **Written text is read the way a terminal shows it.** A carriage return starts the line over, so a progress bar stays one line, and the line still being written is shown as it stands. ANSI colors and weights are drawn, in the sixteen colors the styled tier takes from your theme, and every other escape code is dropped.  **Read a CI log's own markers with 'format'.** 'github-actions' reads the workflow commands a step writes, '::group::' and '::error::' among them, and the times at the start of a downloaded log. 'vercel' reads a Vercel build log's phases and its warnings. Each step opens as it starts, folds once it passes, stays open where it failed, and is timed from its lines. For any other log, give 'parse' a function that reads each finished line: it returns a level, a group, or 'open' and 'close' to start and end a step.  **Steps fold.** Lines that name a group in 'groups' stand under its heading, which shows its status and how long it took and opens and closes the lines. A group a reader opens or closes fires 'helix-expand' with every open group.  **Search with 'query'.** The log shows only the lines that hold it, marks each match, opens the groups that hold one, and says how many lines match.  'line-numbers' numbers the lines from the first ever written, so a number still names its line once 'limit' has let older lines go, and 'line-href' makes each number a link, such as '#L{n}'. 'scrollToLine(n)' takes a reader to one. 'timestamps' shows each line's 'at', on the clock or as the time into the run. 'mark-lines' marks lines, such as '12, 40-44'.  **'selectable' lets a reader select lines**, as a code host does: pressing a number selects its line, and pressing another with Shift selects every line between them. 'selected-lines' holds the selection, such as '12-20', and 'helix-select' asks before it changes. With a 'line-href' that is a fragment, the address follows the selection, '#L12' or '#L12-L20', and a page opened at one selects it and scrolls to it.  **The numbers are one tab stop.** Where they are links or buttons, Tab reaches the one a reader last used, or the first selected, and the arrow keys move between them, with Home and End for the first and the last. With Shift on a 'selectable' log, the selection follows.  **What a screen reader hears.** The log is a 'log' and stays quiet as lines arrive, since reading a build aloud line by line helps nobody. A separate status region says each line at 'error' once it arrives, each step once it finishes or fails, and the end of the run once 'done' is set or 'source' ends. Set 'done' yourself when output you 'write' is complete.  The log scrolls on this tier. It carries 'data-scroller', so following the newest line and drawing a window work with no stylesheet. Give the log a block size, such as 'helix-headless-log::part(log) { block-size: 20rem }'.  '''js import '@fusion.dev/helix/log' ''' */
   "helix-headless-log": DefineCustomElement<
     HelixHeadlessLog,
     HelixHeadlessLogVueProps,