@fusion.dev/helix-headless 0.203.0 → 0.204.0

package/custom-elements.json

@@ -101459,9 +101459,45 @@
       "kind": "javascript-module",
       "path": "src/log/buffer.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "stepDuration",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "seconds",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "`seconds` as a step's duration reads: `12s`, `1m 12s`, or `1h 2m`."
+        },
+        {
+          "kind": "function",
+          "name": "timeOf",
+          "return": {
+            "type": {
+              "text": "number | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "at",
+              "type": {
+                "text": "number | string | undefined"
+              }
+            }
+          ],
+          "description": "Milliseconds since the epoch for `at`, or undefined where it names no time."
+        },
         {
           "kind": "class",
-          "description": "The text of a run, kept as lines.\n\n**Written text arrives in pieces that do not end at line breaks**, so the\nline still being written is held apart and shown as it stands, the way a\nterminal shows a prompt or a progress bar before its line ends. A line is\nfinished by `\\n` or `\\r\\n`.\n\n**A carriage return on its own starts the line over.** A progress bar is\none line rewritten a hundred times, and drawing each rewrite as a line of\nits own is the failure every log viewer is judged by. The text after the\nlast `\\r` replaces the line. A terminal overwrites only as many characters\nas were written, so `abc\\rxy` reads `xyc` there and `xy` here; a program\nthat redraws a line writes the whole line, which reads the same in both.\n\n**Color carries from line to line**, as it does in a terminal, so a block\nthat opens with green and closes many lines later is green throughout. It\ncarries through text a carriage return replaced as well.",
+          "description": "The text of a run, kept as lines.\n\n**Written text arrives in pieces that do not end at line breaks**, so the\nline still being written is held apart and shown as it stands, the way a\nterminal shows a prompt or a progress bar before its line ends. A line is\nfinished by `\\n` or `\\r\\n`.\n\n**A carriage return on its own starts the line over.** A progress bar is\none line rewritten a hundred times, and drawing each rewrite as a line of\nits own is the failure every log viewer is judged by. The text after the\nlast `\\r` replaces the line. A terminal overwrites only as many characters\nas were written, so `abc\\rxy` reads `xyc` there and `xy` here; a program\nthat redraws a line writes the whole line, which reads the same in both.\n\n**Color carries from line to line**, as it does in a terminal, so a block\nthat opens with green and closes many lines later is green throughout. It\ncarries through text a carriage return replaced as well.\n\n**Steps a parser opens are kept here**, in `steps`, each a new object\nwhenever it changes, so a log can compare one set with the next and see a\nstep finish.",
           "name": "LogBuffer",
           "members": [
             {
@@ -101500,6 +101536,44 @@
               "default": "undefined",
               "description": "Reads each finished line of written text."
             },
+            {
+              "kind": "field",
+              "name": "steps",
+              "type": {
+                "text": "LogGroup[]"
+              },
+              "default": "[]",
+              "description": "The steps `parse` opened, in order, replaced as a whole when one changes."
+            },
+            {
+              "kind": "field",
+              "name": "openStep",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "The step that is open, by its place in `steps`."
+            },
+            {
+              "kind": "field",
+              "name": "stepFailed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether a line in the open step was at `error`, and when the step began."
+            },
+            {
+              "kind": "field",
+              "name": "stepStarted",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined"
+            },
             {
               "kind": "field",
               "name": "partial",
@@ -101633,6 +101707,66 @@
               },
               "description": "Finishes the line being written."
             },
+            {
+              "kind": "field",
+              "name": "stepEnded",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "When the open step's latest line was written."
+            },
+            {
+              "kind": "method",
+              "name": "openStepNamed",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "heading",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "at",
+                  "type": {
+                    "text": "number | undefined"
+                  }
+                }
+              ],
+              "description": "Opens a step named `heading`, closing the one that is open."
+            },
+            {
+              "kind": "method",
+              "name": "closeStep",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "close",
+                  "type": {
+                    "text": "NonNullable<LogParsed['close']>"
+                  }
+                },
+                {
+                  "name": "at",
+                  "type": {
+                    "text": "number | undefined"
+                  }
+                }
+              ],
+              "description": "Closes the open step: failed where one of its lines was at `error`, done\notherwise, timed from its first line to `at`, and folded unless it failed,\nas a CI page folds a step that passed."
+            },
             {
               "kind": "method",
               "name": "trim",
@@ -101649,6 +101783,22 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "stepDuration",
+          "declaration": {
+            "name": "stepDuration",
+            "module": "src/log/buffer.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "timeOf",
+          "declaration": {
+            "name": "timeOf",
+            "module": "src/log/buffer.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "LogBuffer",
@@ -102449,6 +102599,14 @@
             "module": "./buffer.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "LogParsed",
+          "declaration": {
+            "name": "LogParsed",
+            "module": "./buffer.js"
+          }
+        },
         {
           "kind": "js",
           "name": "LogParser",
@@ -102489,6 +102647,22 @@
             "module": "./line/log-line.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "parseGitHubActions",
+          "declaration": {
+            "name": "parseGitHubActions",
+            "module": "./parsers.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseVercel",
+          "declaration": {
+            "name": "parseVercel",
+            "module": "./parsers.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixHeadlessLog",
@@ -102519,24 +102693,6 @@
       "kind": "javascript-module",
       "path": "src/log/line/log-line.ts",
       "declarations": [
-        {
-          "kind": "function",
-          "name": "timeOf",
-          "return": {
-            "type": {
-              "text": "number | undefined"
-            }
-          },
-          "parameters": [
-            {
-              "name": "at",
-              "type": {
-                "text": "number | string | undefined"
-              }
-            }
-          ],
-          "description": "Milliseconds since the epoch for `at`, or undefined where it names no time."
-        },
         {
           "kind": "class",
           "description": "Write one for each line of a log you serve whole, inside a `Log` or a\n`Log.Group`. The log numbers each line, counting the lines of every group,\nand tells it whether to show its number and its time.\n\n`level` says how much a line matters, and the styled tier draws `warn` and\n`error` lines apart. The text is the line's own content, so you can mark it\nup yourself.",
@@ -102568,6 +102724,10 @@
               "description": "The row of a line `mark-lines` names on the log.",
               "name": "line-marked"
             },
+            {
+              "description": "The row of a line in the log's selection.",
+              "name": "line-selected"
+            },
             {
               "description": "The row of a line at `warn`.",
               "name": "line-warn"
@@ -102577,7 +102737,7 @@
               "name": "match"
             },
             {
-              "description": "The line's number, shown with `line-numbers`, and a link with `line-href`.",
+              "description": "The line's number, shown with `line-numbers`: a link with `line-href`, and a button on a `selectable` log.",
               "name": "number"
             },
             {
@@ -102672,7 +102832,7 @@
                   "text": "TemplateResult | typeof nothing"
                 }
               },
-              "description": "The number, as a link where the log gave one, or as text a screen reader skips."
+              "description": "The number: a link where the log gave `line-href`, a button where the log\nis `selectable`, and otherwise text a screen reader skips.\n\n**One number in the log is a tab stop, and the rest are reached with the\narrow keys**, so a log of a thousand lines is one stop on the way through\nthe page. The log says which, with `logStop`."
             },
             {
               "kind": "method",
@@ -103124,14 +103284,6 @@
         }
       ],
       "exports": [
-        {
-          "kind": "js",
-          "name": "timeOf",
-          "declaration": {
-            "name": "timeOf",
-            "module": "src/log/line/log-line.ts"
-          }
-        },
         {
           "kind": "js",
           "name": "HelixHeadlessLogLine",
@@ -103150,13 +103302,80 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/log/parsers.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "parseGitHubActions",
+          "parameters": [
+            {
+              "name": "raw"
+            }
+          ],
+          "description": "Reads a GitHub Actions log: the workflow commands a step writes, such as\n`::group::Install` and `::error file=app.ts,line=3::Missing`, and the\n`##[group]` form and leading times of a log downloaded from a run.\n\n- `group` and `endgroup` open and close a step, which folds once it passes\n  and stays open where a line in it is an error.\n- `error`, `warning`, `notice` and `debug` set the line's level, with the\n  file, line, column and title in front of the message.\n- `command`, the line GitHub writes for each command a step runs, stays as\n  it is.\n- `add-mask`, `set-output` and the other commands GitHub never shows are\n  dropped. Text after `stop-commands` is read as commands still.\n- A leading time becomes the line's `at`, which times each step and which\n  `timestamps` shows.",
+          "type": {
+            "text": "LogParser"
+          }
+        },
+        {
+          "kind": "function",
+          "name": "parseVercel",
+          "parameters": [
+            {
+              "name": "raw"
+            }
+          ],
+          "description": "Reads a Vercel build log, as the CLI prints it with `vercel inspect --logs`\nand the dashboard shows it: a time and two spaces in front of each line.\n\n- `Running \"…\"` opens a step named for what it runs, and the line is its\n  first. `Build Completed in …` closes it and stands after it.\n- `Deploying outputs…` opens a step named for it, and `Deployment\n  completed` closes it.\n- A line starting `Error`, `Failed` or `npm ERR!`, or holding `error:`, is\n  at `error`, and one starting `Warning` or `warn` is at `warn`.\n- The leading time becomes the line's `at`, which times each step.",
+          "type": {
+            "text": "LogParser"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "LOG_FORMATS",
+          "type": {
+            "text": "object"
+          },
+          "default": "{ 'github-actions': parseGitHubActions, vercel: parseVercel, }",
+          "description": "The parsers `format` names."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "parseGitHubActions",
+          "declaration": {
+            "name": "parseGitHubActions",
+            "module": "src/log/parsers.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseVercel",
+          "declaration": {
+            "name": "parseVercel",
+            "module": "src/log/parsers.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LOG_FORMATS",
+          "declaration": {
+            "name": "LOG_FORMATS",
+            "module": "src/log/parsers.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/log/root/log-root.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A log holds lines in the order they were written and keeps the reader at\nthe newest one, until they scroll up to read. It stays where they left it\nwhile lines keep arriving, and a button returns them to the end\n(`resume-label`, \"Jump to latest\").\n\n**Lines arrive two ways.** For a log you serve whole, write `Log.Line`\nelements as children, inside `Log.Group` elements for the steps. For a log\nthat is still being written, hand it text: `write(chunk)` takes text as it\narrives, in pieces that need not end at a line break, and `source` takes a\n`ReadableStream` or an async iterable and reads it to the end. `lines` takes\nthe lines as data. Text drawn from data is drawn one window at a time, so a\nlog of a hundred thousand lines holds a screenful of elements, and the log\nneeds a block size of its own. Do not use both ways at once.\n\n**Written text is read the way a terminal shows it.** A carriage return\nstarts the line over, so a progress bar stays one line, and the line still\nbeing written is shown as it stands. ANSI colors and weights are drawn, in\nthe sixteen colors the styled tier takes from your theme, and every other\nescape code is dropped. Give `parse` a function to read each finished line,\nsuch as a level off its prefix or a group off a marker.\n\n**Steps fold.** Lines that name a group in `groups` stand under its heading,\nwhich shows its status and how long it took and opens and closes the lines.\nA group a reader opens or closes fires `helix-expand` with every open group.\n\n**Search with `query`.** The log shows only the lines that hold it, marks\neach match, opens the groups that hold one, and says how many lines match.\n\n`line-numbers` numbers the lines from the first ever written, so a number\nstill names its line once `limit` has let older lines go, and `line-href`\nmakes each number a link, such as `#L{n}`. `scrollToLine(n)` takes a reader\nto one. `timestamps` shows each line's `at`, on the clock or as the time\ninto the run. `mark-lines` marks lines, such as `12, 40-44`.\n\n**What a screen reader hears.** The log is a `log` and stays quiet as lines\narrive, since reading a build aloud line by line helps nobody. A separate\nstatus region says each line at `error` once it arrives, each step once it\nfinishes or fails, and the end of the run once `done` is set or `source`\nends. Set `done` yourself when output you `write` is complete.\n\nThe log scrolls on this tier. It carries `data-scroller`, so following the\nnewest line and drawing a window work with no stylesheet. Give the log a\nblock size, such as `helix-headless-log::part(log) { block-size: 20rem }`.\n\n```js\nimport '@fusion.dev/helix/log'\n```",
+          "description": "A log holds lines in the order they were written and keeps the reader at\nthe newest one, until they scroll up to read. It stays where they left it\nwhile lines keep arriving, and a button returns them to the end\n(`resume-label`, \"Jump to latest\").\n\n**Lines arrive two ways.** For a log you serve whole, write `Log.Line`\nelements as children, inside `Log.Group` elements for the steps. For a log\nthat is still being written, hand it text: `write(chunk)` takes text as it\narrives, in pieces that need not end at a line break, and `source` takes a\n`ReadableStream` or an async iterable and reads it to the end. `lines` takes\nthe lines as data. Text drawn from data is drawn one window at a time, so a\nlog of a hundred thousand lines holds a screenful of elements, and the log\nneeds a block size of its own. Do not use both ways at once.\n\n**Written text is read the way a terminal shows it.** A carriage return\nstarts the line over, so a progress bar stays one line, and the line still\nbeing written is shown as it stands. ANSI colors and weights are drawn, in\nthe sixteen colors the styled tier takes from your theme, and every other\nescape code is dropped.\n\n**Read a CI log's own markers with `format`.** `github-actions` reads the\nworkflow commands a step writes, `::group::` and `::error::` among them,\nand the times at the start of a downloaded log. `vercel` reads a Vercel\nbuild log's phases and its warnings. Each step opens as it starts, folds\nonce it passes, stays open where it failed, and is timed from its lines.\nFor any other log, give `parse` a function that reads each finished line:\nit returns a level, a group, or `open` and `close` to start and end a step.\n\n**Steps fold.** Lines that name a group in `groups` stand under its heading,\nwhich shows its status and how long it took and opens and closes the lines.\nA group a reader opens or closes fires `helix-expand` with every open group.\n\n**Search with `query`.** The log shows only the lines that hold it, marks\neach match, opens the groups that hold one, and says how many lines match.\n\n`line-numbers` numbers the lines from the first ever written, so a number\nstill names its line once `limit` has let older lines go, and `line-href`\nmakes each number a link, such as `#L{n}`. `scrollToLine(n)` takes a reader\nto one. `timestamps` shows each line's `at`, on the clock or as the time\ninto the run. `mark-lines` marks lines, such as `12, 40-44`.\n\n**`selectable` lets a reader select lines**, as a code host does: pressing a\nnumber selects its line, and pressing another with Shift selects every line\nbetween them. `selected-lines` holds the selection, such as `12-20`, and\n`helix-select` asks before it changes. With a `line-href` that is a\nfragment, the address follows the selection, `#L12` or `#L12-L20`, and a\npage opened at one selects it and scrolls to it.\n\n**The numbers are one tab stop.** Where they are links or buttons, Tab\nreaches the one a reader last used, or the first selected, and the arrow\nkeys move between them, with Home and End for the first and the last. With\nShift on a `selectable` log, the selection follows.\n\n**What a screen reader hears.** The log is a `log` and stays quiet as lines\narrive, since reading a build aloud line by line helps nobody. A separate\nstatus region says each line at `error` once it arrives, each step once it\nfinishes or fails, and the end of the run once `done` is set or `source`\nends. Set `done` yourself when output you `write` is complete.\n\nThe log scrolls on this tier. It carries `data-scroller`, so following the\nnewest line and drawing a window work with no stylesheet. Give the log a\nblock size, such as `helix-headless-log::part(log) { block-size: 20rem }`.\n\n```js\nimport '@fusion.dev/helix/log'\n```",
           "name": "HelixHeadlessLog",
           "cssProperties": [
             {
@@ -103345,6 +103564,10 @@
               "description": "A run drawn underlined.",
               "name": "line-run-underline"
             },
+            {
+              "description": "The row of a line drawn from data that is selected.",
+              "name": "line-selected"
+            },
             {
               "description": "The text of a line drawn from data.",
               "name": "line-text"
@@ -103533,6 +103756,15 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "format",
+              "type": {
+                "text": "'github-actions' | 'vercel' | undefined"
+              },
+              "description": "The format written text is in, read with a parser Helix ships:\n`github-actions` reads a GitHub Actions log's workflow commands into steps\nand levels, and `vercel` a Vercel build log's phases and warnings. Absent\nreads none. `parse` wins over it.",
+              "attribute": "format"
+            },
             {
               "kind": "field",
               "name": "groupLabel",
@@ -103645,7 +103877,7 @@
               "type": {
                 "text": "LogParser | undefined"
               },
-              "description": "Reads each finished line of written text: return the fields to set, such\nas `level` or `group`, or `null` to drop the line. Lines in `lines` are\ntaken as they are."
+              "description": "Reads each finished line of written text: return the fields to set, such\nas `level`, `open` or `close` to start or end a step, or `null` to drop\nthe line. Lines in `lines` are taken as they are. Wins over `format`."
             },
             {
               "kind": "field",
@@ -103679,6 +103911,26 @@
                 "words": true
               }
             },
+            {
+              "kind": "field",
+              "name": "selectable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether pressing a line's number selects the line, and pressing another\nwith Shift selects every line between them. Each number is then a\nbutton, or a link with `line-href`, and the arrow keys move between them.",
+              "attribute": "selectable"
+            },
+            {
+              "kind": "field",
+              "name": "selectedLines",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The lines selected, as a number or a range such as `12-20`. Empty selects\nnone. A reader's press asks first: `helix-select` is cancelable.",
+              "attribute": "selected-lines"
+            },
             {
               "kind": "field",
               "name": "source",
@@ -103726,6 +103978,54 @@
               "privacy": "private",
               "default": "undefined"
             },
+            {
+              "kind": "field",
+              "name": "formatValue",
+              "type": {
+                "text": "'github-actions' | 'vercel' | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "parseValue",
+              "type": {
+                "text": "LogParser | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "stop",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "The number that is the log's one tab stop among its numbers, or 0 before anyone moved."
+            },
+            {
+              "kind": "field",
+              "name": "selectionAnchor",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "The line a Shift press measures a range from."
+            },
+            {
+              "kind": "field",
+              "name": "lastGroups",
+              "type": {
+                "text": "readonly LogGroup[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "The steps the last update saw, which a page's `open` is compared with."
+            },
             {
               "kind": "field",
               "name": "doneState",
@@ -103936,6 +104236,65 @@
               "description": "Whether the lines are data rather than children.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "formatParser",
+              "type": {
+                "text": "LogParser | undefined"
+              },
+              "privacy": "private",
+              "description": "The parser `format` names.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "allGroups",
+              "type": {
+                "text": "readonly LogGroup[]"
+              },
+              "privacy": "private",
+              "description": "The steps from `groups`, then the steps a parser opened.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "interactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the numbers take focus: links with `line-href`, or buttons when `selectable`.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "selection",
+              "type": {
+                "text": "[number, number] | undefined"
+              },
+              "privacy": "private",
+              "description": "The selection as its first and last line, or undefined where there is none.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "selected",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "number",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Whether line `number` is selected."
+            },
             {
               "kind": "field",
               "name": "log",
@@ -104030,6 +104389,152 @@
                 "text": "scrollToLine(number: number, options: LogScrollOptions = {}) => Promise<boolean>"
               }
             },
+            {
+              "kind": "method",
+              "name": "requestSelect",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Asks to select `value`, a line or a range, and applies it unless refused,\nthen says so and, with a `line-href` that is a fragment such as `#L{n}`,\nputs the selection in the address."
+            },
+            {
+              "kind": "method",
+              "name": "address",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "What the address holds for a selection, as `line-href` spells a line:\n`#L12`, and `#L12-L20` for a range. Undefined where `line-href` is not a\nfragment, since a link elsewhere is the page's to follow."
+            },
+            {
+              "kind": "method",
+              "name": "writeAddress",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Puts a selection in the address without a new history entry, so the back\nbutton leaves the page rather than walking through every line pressed."
+            },
+            {
+              "kind": "field",
+              "name": "readAddress",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Reads a line or a range out of the address, as `line-href` spells one,\nselects it where the log is `selectable`, and scrolls to it."
+            },
+            {
+              "kind": "method",
+              "name": "reachable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number[]"
+                }
+              },
+              "description": "The numbers of the lines a reader can move between, in order: what is\ndrawn from data, or the lines written as children that no query hides\nand no shut group folds away."
+            },
+            {
+              "kind": "method",
+              "name": "stopAmong",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "numbers",
+                  "type": {
+                    "text": "readonly number[]"
+                  }
+                }
+              ],
+              "description": "The number that is the tab stop among `numbers`: the one a reader last\nmoved to, else the first selected, else the first."
+            },
+            {
+              "kind": "method",
+              "name": "focusLine",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "number",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Moves focus to line `number`'s number, drawing it first where it is windowed."
+            },
+            {
+              "kind": "method",
+              "name": "numberFrom",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "path",
+                  "type": {
+                    "text": "readonly EventTarget[]"
+                  }
+                }
+              ],
+              "description": "The line a number belongs to, out of an event's path, and its number."
+            },
+            {
+              "kind": "field",
+              "name": "handleClick",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A press on a number selects its line, or with Shift every line from the\nlast one pressed. A link's own navigation is held back while it selects,\nsince the selection writes the address itself."
+            },
+            {
+              "kind": "field",
+              "name": "handleNumberKey",
+              "privacy": "private",
+              "readonly": true,
+              "description": "The arrow keys move between numbers, and Home and End go to the first and\nthe last, from a number with focus. With Shift on a `selectable` log, the\nselection follows."
+            },
             {
               "kind": "method",
               "name": "isOpen",
@@ -104253,6 +104758,12 @@
                   "type": {
                     "text": "number | undefined"
                   }
+                },
+                {
+                  "name": "stop",
+                  "type": {
+                    "text": "number"
+                  }
                 }
               ],
               "description": "One row drawn from data: a line, or a group's heading."
@@ -104843,7 +105354,7 @@
               "type": {
                 "text": "HelixExpandEvent"
               },
-              "description": "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.",
+              "description": "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.",
               "name": "helix-expand",
               "reactProp": "onhelix-expand"
             },
@@ -104854,6 +105365,22 @@
               "description": "Fired after the log follows the newest line or lets go of it, with `true` or `false` in `detail.value`.",
               "name": "helix-pin",
               "reactProp": "onhelix-pin"
+            },
+            {
+              "type": {
+                "text": "HelixSelectEvent"
+              },
+              "description": "Fired when a reader presses a number to change the selection, with the lines asked for in `detail.value`. Cancelable.",
+              "name": "helix-select",
+              "reactProp": "onhelix-select"
+            },
+            {
+              "type": {
+                "text": "HelixSelectedEvent"
+              },
+              "description": "Fired after the selection changes, with the lines now selected in `detail.value`, such as `12-20`.",
+              "name": "helix-selected",
+              "reactProp": "onhelix-selected"
             }
           ],
           "attributes": [
@@ -104923,6 +105450,14 @@
               "description": "The log's name, read by screen readers, where `label` is empty.",
               "fieldName": "fallbackLabel"
             },
+            {
+              "name": "format",
+              "type": {
+                "text": "'github-actions' | 'vercel' | undefined"
+              },
+              "description": "The format written text is in, read with a parser Helix ships:\n`github-actions` reads a GitHub Actions log's workflow commands into steps\nand levels, and `vercel` a Vercel build log's phases and warnings. Absent\nreads none. `parse` wins over it.",
+              "fieldName": "format"
+            },
             {
               "name": "group-label",
               "type": {
@@ -105021,6 +105556,24 @@
               "description": "The words on the button that returns to the newest line, where `resume` is empty.",
               "fieldName": "resumeLabel"
             },
+            {
+              "name": "selectable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether pressing a line's number selects the line, and pressing another\nwith Shift selects every line between them. Each number is then a\nbutton, or a link with `line-href`, and the arrow keys move between them.",
+              "fieldName": "selectable"
+            },
+            {
+              "name": "selected-lines",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The lines selected, as a number or a range such as `12-20`. Empty selects\nnone. A reader's press asks first: `helix-select` is cancelable.",
+              "fieldName": "selectedLines"
+            },
             {
               "name": "threshold",
               "type": {
@@ -219293,6 +219846,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-headless",
-    "version": "0.203.0"
+    "version": "0.204.0"
   }
 }