@fusion.dev/helix 0.202.0 → 0.204.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix",
   "description": "Styled component tier. Extends the headless tier with token-driven presentation.",
-  "version": "0.202.0",
+  "version": "0.204.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -60,14 +60,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.202.0",
-    "@fusion.dev/helix-headless": "0.202.0",
-    "@fusion.dev/helix-styles": "0.202.0",
+    "@fusion.dev/helix-core": "0.204.0",
+    "@fusion.dev/helix-headless": "0.204.0",
+    "@fusion.dev/helix-styles": "0.204.0",
     "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.202.0",
-    "@fusion.dev/helix-testing": "0.202.0",
+    "@fusion.dev/helix-cem": "0.204.0",
+    "@fusion.dev/helix-testing": "0.204.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.14.5",
     "@lit-labs/ssr": "^4.1.0",

package/skills/helix/SKILL.md

@@ -2,12 +2,12 @@
 name: helix
 description: Writes and checks pages built with Helix, the web components in @fusion.dev/helix. Use when building or reviewing any user interface in a project that installs @fusion.dev/helix, and when code has helix- elements, Helix tokens, or the helix command line.
 metadata:
-  version: "0.202.0"
+  version: "0.204.0"
 ---
 
 # Helix
 
-This guide is for @fusion.dev/helix 0.202.0, the version installed beside it.
+This guide is for @fusion.dev/helix 0.204.0, the version installed beside it.
 
 ## Using Helix with an agent
 

package/types/jsx.d.ts

@@ -1692,7 +1692,8 @@ a timer. */
 `variant`.
 
 Absent is `native`, which is each shape answering in the terms it is made
-of: braid leans, rays are occluded, threads pinch, particles scatter. The
+of: braid leans, rays are occluded, threads pinch, particles scatter, a
+constellation gathers. The
 named options are generic, and are a deliberate step down in meaning. A
 response made of the same material as the shape says something about that
 shape; a lamp following the cursor says the same nothing on every one.
@@ -1770,10 +1771,11 @@ that range, because they interpolate: a larger number would extrapolate,
 and a streak whose length passed through zero would be drawn as a bar
 across the whole frame.
 
-Read by six of the eleven shapes, the ones made of many similar things,
+Read by seven of the twelve shapes, the ones made of many similar things,
 whether those are counted or continuous: `streaks`, whose lanes draw a
-speed, a length, a width, a spacing and a weight apiece; `particles`, whose
-motes draw a size, a brightness and a wander; `rays` and `aurora`, whose
+speed, a length, a width, a spacing and a weight apiece; `particles` and
+`constellation`, whose motes and stars draw a size, a brightness and a
+wander; `rays` and `aurora`, whose
 fan, bundles and folds widen or even out; `caustics`, whose three depths of
 fold close on one scale and one weight while the pool over them flattens to
 an even wash; and `fracture`, whose sites come home to their own cell
@@ -1796,7 +1798,7 @@ property writes the attribute onto every host anybody renders.
 
 **`variant` and not `shape`.** `shape` is an axis about geometry, `circle`
 against `square`, `arc` against `ring`, and it is registered as one.
-Aurora, braid and caustics are not geometries; they are eleven names for a
+Aurora, braid and caustics are not geometries; they are twelve names for a
 look, which is what `variant` is for by the rule the registry already
 states. */
   variant?: (HelixAura["variant"]) | undefined;
@@ -1829,7 +1831,8 @@ a timer. */
 `variant`.
 
 Absent is `native`, which is each shape answering in the terms it is made
-of: braid leans, rays are occluded, threads pinch, particles scatter. The
+of: braid leans, rays are occluded, threads pinch, particles scatter, a
+constellation gathers. The
 named options are generic, and are a deliberate step down in meaning. A
 response made of the same material as the shape says something about that
 shape; a lamp following the cursor says the same nothing on every one.
@@ -1907,10 +1910,11 @@ that range, because they interpolate: a larger number would extrapolate,
 and a streak whose length passed through zero would be drawn as a bar
 across the whole frame.
 
-Read by six of the eleven shapes, the ones made of many similar things,
+Read by seven of the twelve shapes, the ones made of many similar things,
 whether those are counted or continuous: `streaks`, whose lanes draw a
-speed, a length, a width, a spacing and a weight apiece; `particles`, whose
-motes draw a size, a brightness and a wander; `rays` and `aurora`, whose
+speed, a length, a width, a spacing and a weight apiece; `particles` and
+`constellation`, whose motes and stars draw a size, a brightness and a
+wander; `rays` and `aurora`, whose
 fan, bundles and folds widen or even out; `caustics`, whose three depths of
 fold close on one scale and one weight while the pool over them flattens to
 an even wash; and `fracture`, whose sites come home to their own cell
@@ -1933,7 +1937,7 @@ property writes the attribute onto every host anybody renders.
 
 **`variant` and not `shape`.** `shape` is an axis about geometry, `circle`
 against `square`, `arc` against `ring`, and it is registered as one.
-Aurora, braid and caustics are not geometries; they are eleven names for a
+Aurora, braid and caustics are not geometries; they are twelve names for a
 look, which is what `variant` is for by the rule the registry already
 states. */
   "prop:variant"?: (HelixAura["variant"]) | undefined;
@@ -22506,6 +22510,12 @@ export type HelixLogHelixExpandElementEvent =
   HelixLogElementEvent<HelixExpandEvent>;
 /** `helix-pin` event type */
 export type HelixLogHelixPinElementEvent = HelixLogElementEvent<HelixPinEvent>;
+/** `helix-select` event type */
+export type HelixLogHelixSelectElementEvent =
+  HelixLogElementEvent<HelixSelectEvent>;
+/** `helix-selected` event type */
+export type HelixLogHelixSelectedElementEvent =
+  HelixLogElementEvent<HelixSelectedEvent>;
 
 export type HelixLogProps = {
   /** The text shown and announced when there are no rows and none are loading. */
@@ -22551,6 +22561,11 @@ many arrived together and `{text}` is the first of them. */
   "fallback-label"?: (HelixLog["fallbackLabel"]) | undefined;
   /** The log's name, read by screen readers, where `label` is empty. */
   fallbackLabel?: (HelixLog["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?: (HelixLog["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"?: (HelixLog["groupLabel"]) | undefined;
@@ -22599,6 +22614,16 @@ true would write the attribute on upgrade. */
   "resume-label"?: (HelixLog["resumeLabel"]) | undefined;
   /** The words on the button that returns to the newest line, where `resume` is empty. */
   resumeLabel?: (HelixLog["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?: (HelixLog["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"?: (HelixLog["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?: (HelixLog["selectedLines"]) | undefined;
   /** How near the newest line still counts as being at it, in pixels. */
   threshold?: (HelixLog["threshold"]) | undefined;
   /** How each line shows its `at`: `absolute` on the clock, `relative` as the
@@ -22619,8 +22644,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?: (HelixLog["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?: (HelixLog["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
@@ -22630,10 +22655,14 @@ reading the last one. */
 
   /** Fired when the reader leaves the newest line by scrolling, or comes back to it. Cancelable. */
   "onhelix-before-pin"?: ((e: HelixLogHelixBeforePinElementEvent) => 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: HelixLogHelixExpandElementEvent) => 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: HelixLogHelixPinElementEvent) => 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: HelixLogHelixSelectElementEvent) => void) | undefined;
+  /** Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`. */
+  "onhelix-selected"?: ((e: HelixLogHelixSelectedElementEvent) => void) | undefined;
 };
 
 export type HelixLogSolidJsProps = {
@@ -22680,6 +22709,11 @@ many arrived together and `{text}` is the first of them. */
   "attr:fallback-label"?: (HelixLog["fallbackLabel"]) | undefined;
   /** The log's name, read by screen readers, where `label` is empty. */
   "prop:fallbackLabel"?: (HelixLog["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"?: (HelixLog["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"?: (HelixLog["groupLabel"]) | undefined;
@@ -22728,6 +22762,16 @@ true would write the attribute on upgrade. */
   "attr:resume-label"?: (HelixLog["resumeLabel"]) | undefined;
   /** The words on the button that returns to the newest line, where `resume` is empty. */
   "prop:resumeLabel"?: (HelixLog["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"?: (HelixLog["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"?: (HelixLog["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"?: (HelixLog["selectedLines"]) | undefined;
   /** How near the newest line still counts as being at it, in pixels. */
   "prop:threshold"?: (HelixLog["threshold"]) | undefined;
   /** How each line shows its `at`: `absolute` on the clock, `relative` as the
@@ -22748,8 +22792,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"?: (HelixLog["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"?: (HelixLog["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
@@ -22758,10 +22802,14 @@ reading the last one. */
   "prop:source"?: (HelixLog["source"]) | undefined;
   /** Fired when the reader leaves the newest line by scrolling, or comes back to it. Cancelable. */
   "on:helix-before-pin"?: ((e: HelixLogHelixBeforePinElementEvent) => 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: HelixLogHelixExpandElementEvent) => 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: HelixLogHelixPinElementEvent) => 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: HelixLogHelixSelectElementEvent) => void) | undefined;
+  /** Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`. */
+  "on:helix-selected"?: ((e: HelixLogHelixSelectedElementEvent) => void) | undefined;
 
   /** Set the innerHTML of the element */
   innerHTML?: (string) | undefined;
@@ -45947,7 +45995,8 @@ export type CustomElements = {
    * `variant`.
    *
    * Absent is `native`, which is each shape answering in the terms it is made
-   * of: braid leans, rays are occluded, threads pinch, particles scatter. The
+   * of: braid leans, rays are occluded, threads pinch, particles scatter, a
+   * constellation gathers. The
    * named options are generic, and are a deliberate step down in meaning. A
    * response made of the same material as the shape says something about that
    * shape; a lamp following the cursor says the same nothing on every one.
@@ -46007,10 +46056,11 @@ export type CustomElements = {
    * and a streak whose length passed through zero would be drawn as a bar
    * across the whole frame.
    *
-   * Read by six of the eleven shapes, the ones made of many similar things,
+   * Read by seven of the twelve shapes, the ones made of many similar things,
    * whether those are counted or continuous: `streaks`, whose lanes draw a
-   * speed, a length, a width, a spacing and a weight apiece; `particles`, whose
-   * motes draw a size, a brightness and a wander; `rays` and `aurora`, whose
+   * speed, a length, a width, a spacing and a weight apiece; `particles` and
+   * `constellation`, whose motes and stars draw a size, a brightness and a
+   * wander; `rays` and `aurora`, whose
    * fan, bundles and folds widen or even out; `caustics`, whose three depths of
    * fold close on one scale and one weight while the pool over them flattens to
    * an even wash; and `fracture`, whose sites come home to their own cell
@@ -46032,7 +46082,7 @@ export type CustomElements = {
    *
    * **`variant` and not `shape`.** `shape` is an axis about geometry, `circle`
    * against `square`, `arc` against `ring`, and it is registered as one.
-   * Aurora, braid and caustics are not geometries; they are eleven names for a
+   * Aurora, braid and caustics are not geometries; they are twelve names for a
    * look, which is what `variant` is for by the rule the registry already
    * states.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -59767,6 +59817,7 @@ export type CustomElements = {
    * - `--log-error-color`: The color of a line at `error`, and of the band behind it. Defaults to the danger color.
    * - `--log-mark-background-color`: The band behind a line `mark-lines` names.
    * - `--log-match-background-color`: The fill behind text that matches the log's `query`.
+   * - `--log-selected-background-color`: The band behind a selected line, on a `selectable` log.
    * - `--log-warn-color`: The color of a line at `warn`, and of the band behind it. Defaults to the warning color.
    * - `--log-run-background-color`: Written on a `run` with a background, in the same form as `--log-run-color`.
    * - `--log-run-color`: Written on a `run` with a text color: one of the sixteen `--log-ansi-*` colors the log publishes, or the color itself.
@@ -59779,9 +59830,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.
@@ -59838,6 +59890,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.
@@ -59858,6 +59914,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.
@@ -59873,8 +59934,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
@@ -59907,8 +59968,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
    *
@@ -59998,6 +60061,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`.
@@ -77903,7 +77967,8 @@ export type CustomElementsSolidJs = {
    * `variant`.
    *
    * Absent is `native`, which is each shape answering in the terms it is made
-   * of: braid leans, rays are occluded, threads pinch, particles scatter. The
+   * of: braid leans, rays are occluded, threads pinch, particles scatter, a
+   * constellation gathers. The
    * named options are generic, and are a deliberate step down in meaning. A
    * response made of the same material as the shape says something about that
    * shape; a lamp following the cursor says the same nothing on every one.
@@ -77963,10 +78028,11 @@ export type CustomElementsSolidJs = {
    * and a streak whose length passed through zero would be drawn as a bar
    * across the whole frame.
    *
-   * Read by six of the eleven shapes, the ones made of many similar things,
+   * Read by seven of the twelve shapes, the ones made of many similar things,
    * whether those are counted or continuous: `streaks`, whose lanes draw a
-   * speed, a length, a width, a spacing and a weight apiece; `particles`, whose
-   * motes draw a size, a brightness and a wander; `rays` and `aurora`, whose
+   * speed, a length, a width, a spacing and a weight apiece; `particles` and
+   * `constellation`, whose motes and stars draw a size, a brightness and a
+   * wander; `rays` and `aurora`, whose
    * fan, bundles and folds widen or even out; `caustics`, whose three depths of
    * fold close on one scale and one weight while the pool over them flattens to
    * an even wash; and `fracture`, whose sites come home to their own cell
@@ -77988,7 +78054,7 @@ export type CustomElementsSolidJs = {
    *
    * **`variant` and not `shape`.** `shape` is an axis about geometry, `circle`
    * against `square`, `arc` against `ring`, and it is registered as one.
-   * Aurora, braid and caustics are not geometries; they are eleven names for a
+   * Aurora, braid and caustics are not geometries; they are twelve names for a
    * look, which is what `variant` is for by the rule the registry already
    * states.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -91917,6 +91983,7 @@ export type CustomElementsSolidJs = {
    * - `--log-error-color`: The color of a line at `error`, and of the band behind it. Defaults to the danger color.
    * - `--log-mark-background-color`: The band behind a line `mark-lines` names.
    * - `--log-match-background-color`: The fill behind text that matches the log's `query`.
+   * - `--log-selected-background-color`: The band behind a selected line, on a `selectable` log.
    * - `--log-warn-color`: The color of a line at `warn`, and of the band behind it. Defaults to the warning color.
    * - `--log-run-background-color`: Written on a `run` with a background, in the same form as `--log-run-color`.
    * - `--log-run-color`: Written on a `run` with a text color: one of the sixteen `--log-ansi-*` colors the log publishes, or the color itself.
@@ -91929,9 +91996,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.
@@ -91991,6 +92059,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.
@@ -92011,6 +92083,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.
@@ -92026,8 +92103,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
@@ -92060,8 +92137,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
    *
@@ -92151,6 +92230,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`.
@@ -110619,6 +110699,8 @@ export type CustomCssProperties = {
   "--log-mark-background-color"?: (string) | undefined;
   /** The fill behind text that matches the log's `query`. */
   "--log-match-background-color"?: (string) | undefined;
+  /** The band behind a selected line, on a `selectable` log. */
+  "--log-selected-background-color"?: (string) | undefined;
   /** The color of a line at `warn`, and of the band behind it. Defaults to the warning color. */
   "--log-warn-color"?: (string) | undefined;
   /** Written on a `run` with a background, in the same form as `--log-run-color`. */

package/types/vue.d.ts

@@ -926,7 +926,8 @@ a timer. */
 `variant`.
 
 Absent is `native`, which is each shape answering in the terms it is made
-of: braid leans, rays are occluded, threads pinch, particles scatter. The
+of: braid leans, rays are occluded, threads pinch, particles scatter, a
+constellation gathers. The
 named options are generic, and are a deliberate step down in meaning. A
 response made of the same material as the shape says something about that
 shape; a lamp following the cursor says the same nothing on every one.
@@ -1004,10 +1005,11 @@ that range, because they interpolate: a larger number would extrapolate,
 and a streak whose length passed through zero would be drawn as a bar
 across the whole frame.
 
-Read by six of the eleven shapes, the ones made of many similar things,
+Read by seven of the twelve shapes, the ones made of many similar things,
 whether those are counted or continuous: `streaks`, whose lanes draw a
-speed, a length, a width, a spacing and a weight apiece; `particles`, whose
-motes draw a size, a brightness and a wander; `rays` and `aurora`, whose
+speed, a length, a width, a spacing and a weight apiece; `particles` and
+`constellation`, whose motes and stars draw a size, a brightness and a
+wander; `rays` and `aurora`, whose
 fan, bundles and folds widen or even out; `caustics`, whose three depths of
 fold close on one scale and one weight while the pool over them flattens to
 an even wash; and `fracture`, whose sites come home to their own cell
@@ -1030,7 +1032,7 @@ property writes the attribute onto every host anybody renders.
 
 **`variant` and not `shape`.** `shape` is an axis about geometry, `circle`
 against `square`, `arc` against `ring`, and it is registered as one.
-Aurora, braid and caustics are not geometries; they are eleven names for a
+Aurora, braid and caustics are not geometries; they are twelve names for a
 look, which is what `variant` is for by the rule the registry already
 states. */
   variant?: (HelixAura["variant"]) | undefined;
@@ -11530,6 +11532,12 @@ export type HelixLogHelixExpandElementEvent =
   HelixLogElementEvent<HelixExpandEvent>;
 /** `helix-pin` event type */
 export type HelixLogHelixPinElementEvent = HelixLogElementEvent<HelixPinEvent>;
+/** `helix-select` event type */
+export type HelixLogHelixSelectElementEvent =
+  HelixLogElementEvent<HelixSelectEvent>;
+/** `helix-selected` event type */
+export type HelixLogHelixSelectedElementEvent =
+  HelixLogElementEvent<HelixSelectedEvent>;
 
 export type HelixLogVueProps = {
   /** The text shown and announced when there are no rows and none are loading. */
@@ -11575,6 +11583,11 @@ many arrived together and `{text}` is the first of them. */
   "fallback-label"?: (HelixLog["fallbackLabel"]) | undefined;
   /** The log's name, read by screen readers, where `label` is empty. */
   fallbackLabel?: (HelixLog["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?: (HelixLog["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"?: (HelixLog["groupLabel"]) | undefined;
@@ -11623,6 +11636,16 @@ true would write the attribute on upgrade. */
   "resume-label"?: (HelixLog["resumeLabel"]) | undefined;
   /** The words on the button that returns to the newest line, where `resume` is empty. */
   resumeLabel?: (HelixLog["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?: (HelixLog["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"?: (HelixLog["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?: (HelixLog["selectedLines"]) | undefined;
   /** How near the newest line still counts as being at it, in pixels. */
   threshold?: (HelixLog["threshold"]) | undefined;
   /** How each line shows its `at`: `absolute` on the clock, `relative` as the
@@ -11643,8 +11666,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?: (HelixLog["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?: (HelixLog["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
@@ -11656,10 +11679,14 @@ reading the last one. */
 export type HelixLogVueEvents = {
   /** Fired when the reader leaves the newest line by scrolling, or comes back to it. Cancelable. */
   "helix-before-pin": HelixLogHelixBeforePinElementEvent;
-  /** 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": HelixLogHelixExpandElementEvent;
   /** Fired after the log follows the newest line or lets go of it, with `true` or `false` in `detail.value`. */
   "helix-pin": HelixLogHelixPinElementEvent;
+  /** Fired when a reader presses a number to change the selection, with the lines asked for in `detail.value`. Cancelable. */
+  "helix-select": HelixLogHelixSelectElementEvent;
+  /** Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`. */
+  "helix-selected": HelixLogHelixSelectedElementEvent;
 };
 
 /** `HelixMapArea` component event */
@@ -24279,6 +24306,8 @@ export type CustomCssProperties = {
   "--log-mark-background-color"?: (string) | undefined;
   /** The fill behind text that matches the log's `query`. */
   "--log-match-background-color"?: (string) | undefined;
+  /** The band behind a selected line, on a `selectable` log. */
+  "--log-selected-background-color"?: (string) | undefined;
   /** The color of a line at `warn`, and of the band behind it. Defaults to the warning color. */
   "--log-warn-color"?: (string) | undefined;
   /** Written on a `run` with a background, in the same form as `--log-run-color`. */