@fusion.dev/helix-headless 0.212.1 → 0.213.0

package/types/vue.d.ts

@@ -10292,10 +10292,28 @@ export type HelixHeadlessLogLineVueProps = {
   at?: (HelixHeadlessLogLine["at"]) | undefined;
   /** How much the line matters. Absent is `info`. */
   level?: (HelixHeadlessLogLine["level"]) | undefined;
+  /** What a screen reader hears before the text of a line at each level, for a
+page in another language, keyed by level, such as `{ warn: 'Warnung:' }`.
+A line at `info` or `log` hears nothing extra, and nor does a line whose
+text already starts with its words, such as `Error: Cannot find module`.
+As an attribute it is that object as JSON. */
+  "level-words"?: (HelixHeadlessLogLine["levelWords"]) | undefined;
+  /** What a screen reader hears before the text of a line at each level, for a
+page in another language, keyed by level, such as `{ warn: 'Warnung:' }`.
+A line at `info` or `log` hears nothing extra, and nor does a line whose
+text already starts with its words, such as `Error: Cannot find module`.
+As an attribute it is that object as JSON. */
+  levelWords?: (HelixHeadlessLogLine["levelWords"]) | undefined;
   /** What a screen reader hears for the link on a line's number. `{number}` is the number. */
   "line-label"?: (HelixHeadlessLogLine["lineLabel"]) | undefined;
   /** What a screen reader hears for the link on a line's number. `{number}` is the number. */
   lineLabel?: (HelixHeadlessLogLine["lineLabel"]) | undefined;
+  /** What a screen reader hears after a line written more than once in a row.
+`{count}` is how many times, in the locale. */
+  "times-label"?: (HelixHeadlessLogLine["timesLabel"]) | undefined;
+  /** What a screen reader hears after a line written more than once in a row.
+`{count}` is how many times, in the locale. */
+  timesLabel?: (HelixHeadlessLogLine["timesLabel"]) | undefined;
 };
 
 export type HelixHeadlessLogLineVueEvents = {};
@@ -10322,6 +10340,11 @@ export type HelixHeadlessLogHelixSelectedElementEvent =
   HelixHeadlessLogElementEvent<HelixSelectedEvent>;
 
 export type HelixHeadlessLogVueProps = {
+  /** Folds a line written again straight after itself into it, with a count,
+as a browser's console does, so a loop writing one warning a thousand
+times is one line. For lines written or given as data, read as they
+arrive; numbers, `line-href` and the selection count a folded line once. */
+  collapse?: (HelixHeadlessLog["collapse"]) | undefined;
   /** Whether the log opens following its newest line, when `pinned` is not set.
 `default-pinned="false"` opens it where it starts. */
   "default-pinned"?: (HelixHeadlessLog["defaultPinned"]) | undefined;
@@ -10368,6 +10391,11 @@ the step's heading and `{status}` is `done` or `failed`. */
   groupLabel?: (HelixHeadlessLog["groupLabel"]) | undefined;
   /** The log's name, read by screen readers. */
   label?: (HelixHeadlessLog["label"]) | undefined;
+  /** The quietest level shown: `info` hides `debug` and `log` lines, `warn`
+shows warnings and errors, and `error` errors only. Unset shows every line.
+Lines it hides are kept, so lowering it shows them again, and a step shows
+while it holds a line that shows. */
+  level?: (HelixHeadlessLog["level"]) | undefined;
   /** The most lines kept, or 0 to keep them all. Past it the oldest lines are
 let go, and the line above the log says how many. */
   limit?: (HelixHeadlessLog["limit"]) | undefined;
@@ -17570,10 +17598,24 @@ exit code, written as the process gave it, and code `0` is a clean exit. */
   "find-controls-label"?: (HelixHeadlessTerminal["findControlsLabel"]) | undefined;
   /** The name of the find bar's row of buttons, read by screen readers. */
   findControlsLabel?: (HelixHeadlessTerminal["findControlsLabel"]) | undefined;
+  /** What the find bar says when its regular expression cannot be read. */
+  "find-invalid-label"?: (HelixHeadlessTerminal["findInvalidLabel"]) | undefined;
+  /** What the find bar says when its regular expression cannot be read. */
+  findInvalidLabel?: (HelixHeadlessTerminal["findInvalidLabel"]) | undefined;
   /** The find button's label, and the find field's name and placeholder. */
   "find-label"?: (HelixHeadlessTerminal["findLabel"]) | undefined;
   /** The find button's label, and the find field's name and placeholder. */
   findLabel?: (HelixHeadlessTerminal["findLabel"]) | undefined;
+  /** Whether the find bar matches case, so "Error" does not find "error". The
+reader turns it on and off from the bar. */
+  "find-match-case"?: (HelixHeadlessTerminal["findMatchCase"]) | undefined;
+  /** Whether the find bar matches case, so "Error" does not find "error". The
+reader turns it on and off from the bar. */
+  findMatchCase?: (HelixHeadlessTerminal["findMatchCase"]) | undefined;
+  /** The match case button's label. */
+  "find-match-case-label"?: (HelixHeadlessTerminal["findMatchCaseLabel"]) | undefined;
+  /** The match case button's label. */
+  findMatchCaseLabel?: (HelixHeadlessTerminal["findMatchCaseLabel"]) | undefined;
   /** The next match button's label. */
   "find-next-label"?: (HelixHeadlessTerminal["findNextLabel"]) | undefined;
   /** The next match button's label. */
@@ -17582,6 +17624,24 @@ exit code, written as the process gave it, and code `0` is a clean exit. */
   "find-previous-label"?: (HelixHeadlessTerminal["findPreviousLabel"]) | undefined;
   /** The previous match button's label. */
   findPreviousLabel?: (HelixHeadlessTerminal["findPreviousLabel"]) | undefined;
+  /** Whether the find bar reads what the reader types as a regular expression,
+in JavaScript's syntax. The reader turns it on and off from the bar. */
+  "find-regex"?: (HelixHeadlessTerminal["findRegex"]) | undefined;
+  /** Whether the find bar reads what the reader types as a regular expression,
+in JavaScript's syntax. The reader turns it on and off from the bar. */
+  findRegex?: (HelixHeadlessTerminal["findRegex"]) | undefined;
+  /** The regular expression button's label. */
+  "find-regex-label"?: (HelixHeadlessTerminal["findRegexLabel"]) | undefined;
+  /** The regular expression button's label. */
+  findRegexLabel?: (HelixHeadlessTerminal["findRegexLabel"]) | undefined;
+  /** Whether the find bar matches whole words only. The reader turns it on and off from the bar. */
+  "find-whole-word"?: (HelixHeadlessTerminal["findWholeWord"]) | undefined;
+  /** Whether the find bar matches whole words only. The reader turns it on and off from the bar. */
+  findWholeWord?: (HelixHeadlessTerminal["findWholeWord"]) | undefined;
+  /** The whole word button's label. */
+  "find-whole-word-label"?: (HelixHeadlessTerminal["findWholeWordLabel"]) | undefined;
+  /** The whole word button's label. */
+  findWholeWordLabel?: (HelixHeadlessTerminal["findWholeWordLabel"]) | undefined;
   /** The fullscreen button's label. */
   "fullscreen-label"?: (HelixHeadlessTerminal["fullscreenLabel"]) | undefined;
   /** The fullscreen button's label. */
@@ -21464,7 +21524,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessLogGroupVueProps,
     HelixHeadlessLogGroupVueEvents
   >;
-  /** Write one for each line of a log you serve whole, inside a 'Log' or a 'Log.Group'. The log numbers each line, counting the lines of every group, and tells it whether to show its number and its time.  'level' says how much a line matters, and the styled tier draws 'warn' and 'error' lines apart. The text is the line's own content, so you can mark it up yourself. */
+  /** Write one for each line of a log you serve whole, inside a 'Log' or a 'Log.Group'. The log numbers each line, counting the lines of every group, and tells it whether to show its number and its time.  'level' says how much a line matters, and the styled tier draws 'warn' and 'error' lines apart. A line at 'debug', 'warn' or 'error' says its level in words before its text, so a reader moving through the log hears it as well as the color shows it. The text is the line's own content, so you can mark it up yourself. */
   "helix-headless-log-line": DefineCustomElement<
     HelixHeadlessLogLine,
     HelixHeadlessLogLineVueProps,
@@ -21890,7 +21950,7 @@ export interface WcToolkitVueGlobalComponents {
     HelixHeadlessTagVueProps,
     HelixHeadlessTagVueEvents
   >;
-  /** Wraps a terminal drawn by xterm.js or another emulator. The frame adds a header with the terminal's name and its controls, a find bar, and a status line. 'connectTerminal' in '@fusion.dev/helix-terminal' connects it to the emulator and draws the terminal in the colors the '--terminal-*' properties set, which the styled tier sets from your theme. Helix does not start a process: you connect the stream. Write the program's output with 'write()', send what the reader types to the process from 'helix-terminal-input', and resize the process's pseudo-terminal from 'helix-terminal-resize'.  Output written before a renderer is connected is held and written first, so the process can start before the emulator loads. 'write()' resolves once the renderer has parsed the output, which is how a page pauses a process that writes faster than the terminal draws.  The controls are a row in the header, and 'controls' names which ones: 'find', 'copy', 'clear', and 'fullscreen'. 'find clear' by default. A control the renderer cannot answer is left out once it is connected. Set 'exit-code' when the process exits: the frame says how it exited, stops sending input, and shows a Restart button that sends 'helix-terminal-restart'.  **Keyboard.** Every key goes to the program, Tab, Shift+Tab, and Escape included, except these:  - Control+Shift+F, or Command+F on a Mac, opens the find bar. Enter and   Shift+Enter move between the matches, and Escape closes the bar and   returns focus to the terminal. - Control+Shift+C copies the selection. On a Mac, Command+C does. - Control+M, or Control+Shift+M on a Mac, switches Tab between typing in the   terminal and moving focus out of it. The status line says when Tab moves   focus, and the terminal's input describes the key to a screen reader.  **Screen readers.** A terminal draws its grid as a picture of text, so a screen reader reads nothing in it by default. Set 'screen-reader-mode' to have the renderer keep the grid as lines a screen reader can move through and announce new output as it arrives, which xterm.js calls screen reader mode. It costs time on every write, so it is off by default: connect it to a setting your reader can turn on. */
+  /** Wraps a terminal drawn by xterm.js or another emulator. The frame adds a header with the terminal's name and its controls, a find bar, and a status line. 'connectTerminal' in '@fusion.dev/helix-terminal' connects it to the emulator and draws the terminal in the colors the '--terminal-*' properties set, which the styled tier sets from your theme. Helix does not start a process: you connect the stream. Write the program's output with 'write()', send what the reader types to the process from 'helix-terminal-input', and resize the process's pseudo-terminal from 'helix-terminal-resize'.  Output written before a renderer is connected is held and written first, so the process can start before the emulator loads. 'write()' resolves once the renderer has parsed the output, which is how a page pauses a process that writes faster than the terminal draws.  The controls are a row in the header, and 'controls' names which ones: 'find', 'copy', 'clear', and 'fullscreen'. 'find clear' by default. A control the renderer cannot answer is left out once it is connected. Set 'exit-code' when the process exits: the frame says how it exited, stops sending input, and shows a Restart button that sends 'helix-terminal-restart'.  **Keyboard.** Every key goes to the program, Tab, Shift+Tab, and Escape included, except these:  - Control+Shift+F, or Command+F on a Mac, opens the find bar. Enter and   Shift+Enter move between the matches, and Escape closes the bar and   returns focus to the terminal. - Control+Shift+C copies the selection. On a Mac, Command+C does. - Control+Shift+V pastes, as it does in the browser, and the program reads   it as typed text. On a Mac, Command+V does. - Control+M, or Control+Shift+M on a Mac, switches Tab between typing in the   terminal and moving focus out of it. The status line says when Tab moves   focus, and the terminal's input describes the key to a screen reader.  **Screen readers.** A terminal draws its grid as a picture of text, so a screen reader reads nothing in it by default. Set 'screen-reader-mode' to have the renderer keep the grid as lines a screen reader can move through and announce new output as it arrives, which xterm.js calls screen reader mode. It costs time on every write, so it is off by default: connect it to a setting your reader can turn on. */
   "helix-headless-terminal": DefineCustomElement<
     HelixHeadlessTerminal,
     HelixHeadlessTerminalVueProps,

package/types/words.d.ts

@@ -2366,6 +2366,16 @@ declare module '@fusion.dev/helix-core' {
        * English: `{status, select, failed {{heading} failed} other {{heading} finished}}`
        */
       groupLabel: Message
+      /**
+       * What a screen reader hears before the text of a line at each level, for a
+       * page in another language, keyed by level, such as `{ warn: 'Warnung:' }`.
+       * A line at `info` or `log` hears nothing extra, and nor does a line whose
+       * text already starts with its words, such as `Error: Cannot find module`.
+       * As an attribute it is that object as JSON.
+       *
+       * English: `{ debug: 'Debug:', error: 'Error:', warn: 'Warning:', }`
+       */
+      levelWords: MessageTable
       /**
        * What a screen reader hears for the link on a line's number. `{number}` is the number.
        *
@@ -2397,6 +2407,13 @@ declare module '@fusion.dev/helix-core' {
        * English: `{status, select, pending {waiting} running {running} done {finished} failed {failed} skipped {skipped} other {}}`
        */
       statusLabel: Message
+      /**
+       * What a screen reader hears after a line written more than once in a row.
+       * `{count}` is how many times, in the locale.
+       *
+       * English: `{count} times`
+       */
+      timesLabel: Message
     }
     'helix-map': {
       /**
@@ -4029,12 +4046,24 @@ declare module '@fusion.dev/helix-core' {
        * English: `Find controls`
        */
       findControlsLabel: Message
+      /**
+       * What the find bar says when its regular expression cannot be read.
+       *
+       * English: `Not a valid regular expression`
+       */
+      findInvalidLabel: Message
       /**
        * The find button's label, and the find field's name and placeholder.
        *
        * English: `Find`
        */
       findLabel: Message
+      /**
+       * The match case button's label.
+       *
+       * English: `Match case`
+       */
+      findMatchCaseLabel: Message
       /**
        * The next match button's label.
        *
@@ -4047,6 +4076,18 @@ declare module '@fusion.dev/helix-core' {
        * English: `Previous match`
        */
       findPreviousLabel: Message
+      /**
+       * The regular expression button's label.
+       *
+       * English: `Use regular expression`
+       */
+      findRegexLabel: Message
+      /**
+       * The whole word button's label.
+       *
+       * English: `Match whole word`
+       */
+      findWholeWordLabel: Message
       /**
        * The fullscreen button's label.
        *