@fusion.dev/helix 0.170.0 → 0.171.0

package/types/jsx.d.ts

@@ -7751,6 +7751,12 @@ export type HelixCodeBlockHelixToggleElementEvent =
   HelixCodeBlockElementEvent<HelixToggleEvent>;
 
 export type HelixCodeBlockProps = {
+  /** The lines to mark as inserted, as numbers and ranges counted from 1, such
+as `3-4`. Drawn as `mark-lines` is, in the added color. Not for a diff. */
+  "added-lines"?: (HelixCodeBlock["addedLines"]) | undefined;
+  /** The lines to mark as inserted, as numbers and ranges counted from 1, such
+as `3-4`. Drawn as `mark-lines` is, in the added color. Not for a diff. */
+  addedLines?: (HelixCodeBlock["addedLines"]) | undefined;
   /** The name of a block that scrolls, which is a tab stop while it does.
 
 Where the block has a name, the scroller says it too, such as "Code,
@@ -7909,6 +7915,12 @@ A false boolean reflects as the attribute's absence, so this costs no
 reflected property taking no default is satisfied by the default being
 `false`. */
   noCopy?: (HelixCodeBlock["noCopy"]) | undefined;
+  /** The lines to mark as deleted, as numbers and ranges counted from 1. Drawn
+as `mark-lines` is, in the removed color. Not for a diff. */
+  "removed-lines"?: (HelixCodeBlock["removedLines"]) | undefined;
+  /** The lines to mark as deleted, as numbers and ranges counted from 1. Drawn
+as `mark-lines` is, in the removed color. Not for a diff. */
+  removedLines?: (HelixCodeBlock["removedLines"]) | undefined;
   /** The words of a button that shows a folded run of unchanged lines, in a
 diff with `context-lines`. `{count}` is how many. */
   "show-unchanged-label"?: (HelixCodeBlock["showUnchangedLabel"]) | undefined;
@@ -7979,6 +7991,12 @@ read, nor for a diff. */
 };
 
 export type HelixCodeBlockSolidJsProps = {
+  /** The lines to mark as inserted, as numbers and ranges counted from 1, such
+as `3-4`. Drawn as `mark-lines` is, in the added color. Not for a diff. */
+  "attr:added-lines"?: (HelixCodeBlock["addedLines"]) | undefined;
+  /** The lines to mark as inserted, as numbers and ranges counted from 1, such
+as `3-4`. Drawn as `mark-lines` is, in the added color. Not for a diff. */
+  "prop:addedLines"?: (HelixCodeBlock["addedLines"]) | undefined;
   /** The name of a block that scrolls, which is a tab stop while it does.
 
 Where the block has a name, the scroller says it too, such as "Code,
@@ -8137,6 +8155,12 @@ A false boolean reflects as the attribute's absence, so this costs no
 reflected property taking no default is satisfied by the default being
 `false`. */
   "prop:noCopy"?: (HelixCodeBlock["noCopy"]) | undefined;
+  /** The lines to mark as deleted, as numbers and ranges counted from 1. Drawn
+as `mark-lines` is, in the removed color. Not for a diff. */
+  "attr:removed-lines"?: (HelixCodeBlock["removedLines"]) | undefined;
+  /** The lines to mark as deleted, as numbers and ranges counted from 1. Drawn
+as `mark-lines` is, in the removed color. Not for a diff. */
+  "prop:removedLines"?: (HelixCodeBlock["removedLines"]) | undefined;
   /** The words of a button that shows a folded run of unchanged lines, in a
 diff with `context-lines`. `{count}` is how many. */
   "attr:show-unchanged-label"?: (HelixCodeBlock["showUnchangedLabel"]) | undefined;
@@ -9029,10 +9053,11 @@ would give one control two of each. What is left is the validity call and
 the anchor the browser points its bubble at.
 
 **Text that is not a color is bad input**, so a form does not submit
-`#00` from a half-typed value. The picker draws no message of its own, so
-reporting it as each keystroke arrives shows nothing until the form asks;
-Color Input shows its own message against the field the reader typed
-into. */
+`#00` from a half-typed value. The picker marks it, and says
+`badInputMessage` under itself, once the reader leaves the value field or
+presses Enter, and a missing color once the reader has committed one or a
+form has refused the picker. Color Input shows its own message against the
+field the reader typed into. */
   required?: (HelixColorPicker["required"]) | undefined;
   /** What the square's horizontal ramp is called. */
   "saturation-label"?: (HelixColorPicker["saturationLabel"]) | undefined;
@@ -9409,10 +9434,11 @@ would give one control two of each. What is left is the validity call and
 the anchor the browser points its bubble at.
 
 **Text that is not a color is bad input**, so a form does not submit
-`#00` from a half-typed value. The picker draws no message of its own, so
-reporting it as each keystroke arrives shows nothing until the form asks;
-Color Input shows its own message against the field the reader typed
-into. */
+`#00` from a half-typed value. The picker marks it, and says
+`badInputMessage` under itself, once the reader leaves the value field or
+presses Enter, and a missing color once the reader has committed one or a
+form has refused the picker. Color Input shows its own message against the
+field the reader typed into. */
   "prop:required"?: (HelixColorPicker["required"]) | undefined;
   /** What the square's horizontal ramp is called. */
   "attr:saturation-label"?: (HelixColorPicker["saturationLabel"]) | undefined;
@@ -9773,12 +9799,13 @@ language. */
   locale?: (HelixCombobox["locale"]) | undefined;
   /** Whether more than one option can be chosen.
 
-The list already does the work: `value` comes apart on commas, a press
-toggles rather than replaces, and the arrows move without choosing. What
-this adds is the tags, and keeping the panel open between picks.
+The list already does the work: `value` is the chosen values joined with
+commas, a press toggles rather than replaces, and the arrows move without
+choosing. What this adds is the tags, and keeping the panel open between
+picks.
 
-A comma is therefore not available inside an option's value, which is the
-listbox's contract and not this element's to change.
+An option's value may hold a comma, and it is read as one value, as
+`Select` and `Listbox` read it. So may an answer the reader created.
 
 **The list is told, and the field is not.** `aria-multiselectable` belongs
 to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
@@ -10148,12 +10175,13 @@ language. */
   "prop:locale"?: (HelixCombobox["locale"]) | undefined;
   /** Whether more than one option can be chosen.
 
-The list already does the work: `value` comes apart on commas, a press
-toggles rather than replaces, and the arrows move without choosing. What
-this adds is the tags, and keeping the panel open between picks.
+The list already does the work: `value` is the chosen values joined with
+commas, a press toggles rather than replaces, and the arrows move without
+choosing. What this adds is the tags, and keeping the panel open between
+picks.
 
-A comma is therefore not available inside an option's value, which is the
-listbox's contract and not this element's to change.
+An option's value may hold a comma, and it is read as one value, as
+`Select` and `Listbox` read it. So may an answer the reader created.
 
 **The list is told, and the field is not.** `aria-multiselectable` belongs
 to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
@@ -10348,6 +10376,18 @@ so a palette filtered on a server sends one `helix-filter` for a word.
 so a palette filtered on a server sends one `helix-filter` for a word.
 `0` filters on every keystroke. See Listbox's `filter-delay`. */
   filterDelay?: (HelixCommand["filterDelay"]) | undefined;
+  /** Where Home and End go from the filter field.
+
+Absent, they move the caret, as APG's combobox has them. `list` moves the
+highlight to the first or the last command, as React Aria's Autocomplete
+does, and Shift with either still selects the text. */
+  "home-end"?: (HelixCommand["homeEnd"]) | undefined;
+  /** Where Home and End go from the filter field.
+
+Absent, they move the caret, as APG's combobox has them. `list` moves the
+highlight to the first or the last command, as React Aria's Autocomplete
+does, and Shift with either still selects the text. */
+  homeEnd?: (HelixCommand["homeEnd"]) | undefined;
   /** The key that opens the palette, written as `mod+k`, `shift+p`, or `k`,
 in Kbd's chord spelling: `mod` is Command or Control, `ctrl`, `cmd`,
 `alt` and `shift` the keys they name.
@@ -10365,6 +10405,10 @@ and `open`, `toggle` and the dialog's parts do nothing. */
   inline?: (HelixCommand["inline"]) | undefined;
   /** Accessible name for the overlay, which has no visible heading. */
   label?: (HelixCommand["label"]) | undefined;
+  /** How the commands are laid out, as Listbox's `layout`: `grid` draws them in
+rows and columns, for a palette of icons or emoji, and the arrow keys
+follow the rows and the columns. Absent is one command under another. */
+  layout?: (HelixCommand["layout"]) | undefined;
   /** What the list says when its commands could not be loaded, such as after a
 request to a server fails. Empty, null or no attribute is no error, so
 removing the attribute clears it. Passed to the list, which shows it
@@ -10480,6 +10524,18 @@ so a palette filtered on a server sends one `helix-filter` for a word.
 so a palette filtered on a server sends one `helix-filter` for a word.
 `0` filters on every keystroke. See Listbox's `filter-delay`. */
   "prop:filterDelay"?: (HelixCommand["filterDelay"]) | undefined;
+  /** Where Home and End go from the filter field.
+
+Absent, they move the caret, as APG's combobox has them. `list` moves the
+highlight to the first or the last command, as React Aria's Autocomplete
+does, and Shift with either still selects the text. */
+  "attr:home-end"?: (HelixCommand["homeEnd"]) | undefined;
+  /** Where Home and End go from the filter field.
+
+Absent, they move the caret, as APG's combobox has them. `list` moves the
+highlight to the first or the last command, as React Aria's Autocomplete
+does, and Shift with either still selects the text. */
+  "prop:homeEnd"?: (HelixCommand["homeEnd"]) | undefined;
   /** The key that opens the palette, written as `mod+k`, `shift+p`, or `k`,
 in Kbd's chord spelling: `mod` is Command or Control, `ctrl`, `cmd`,
 `alt` and `shift` the keys they name.
@@ -10497,6 +10553,10 @@ and `open`, `toggle` and the dialog's parts do nothing. */
   "prop:inline"?: (HelixCommand["inline"]) | undefined;
   /** Accessible name for the overlay, which has no visible heading. */
   "prop:label"?: (HelixCommand["label"]) | undefined;
+  /** How the commands are laid out, as Listbox's `layout`: `grid` draws them in
+rows and columns, for a palette of icons or emoji, and the arrow keys
+follow the rows and the columns. Absent is one command under another. */
+  "prop:layout"?: (HelixCommand["layout"]) | undefined;
   /** What the list says when its commands could not be loaded, such as after a
 request to a server fails. Empty, null or no attribute is no error, so
 removing the attribute clears it. Passed to the list, which shows it
@@ -15439,6 +15499,13 @@ nothing between them, because a word every chip carries is a word nobody
 reads. The moment somebody picks a different comparison it appears, which
 makes an unusual filter look unusual. */
   operatorLabel?: (HelixFilterChip["operatorLabel"]) | undefined;
+  /** Whether the remove button is a tab stop of its own.
+
+`FilterInput` writes `false` on the chips in its `tags` slot: the field's
+text is its one tab stop, and the arrow keys move from the text to the
+chips, as in a `multiple` Combobox. No attribute: it is coordination
+between elements, as `Tag.dismissTabStop` is. */
+  dismissTabStop?: (HelixFilterChip["dismissTabStop"]) | undefined;
 
   /** Fired when the user asks to remove the filter. Cancelable: call `preventDefault()` to keep the chip. */
   "onhelix-dismiss"?: ((e: HelixFilterChipHelixDismissElementEvent) => void) | undefined;
@@ -15515,6 +15582,13 @@ nothing between them, because a word every chip carries is a word nobody
 reads. The moment somebody picks a different comparison it appears, which
 makes an unusual filter look unusual. */
   "prop:operatorLabel"?: (HelixFilterChip["operatorLabel"]) | undefined;
+  /** Whether the remove button is a tab stop of its own.
+
+`FilterInput` writes `false` on the chips in its `tags` slot: the field's
+text is its one tab stop, and the arrow keys move from the text to the
+chips, as in a `multiple` Combobox. No attribute: it is coordination
+between elements, as `Tag.dismissTabStop` is. */
+  "prop:dismissTabStop"?: (HelixFilterChip["dismissTabStop"]) | undefined;
   /** Fired when the user asks to remove the filter. Cancelable: call `preventDefault()` to keep the chip. */
   "on:helix-dismiss"?: ((e: HelixFilterChipHelixDismissElementEvent) => void) | undefined;
 
@@ -15839,6 +15913,18 @@ and this one was the English a form in another language still spoke in
 the bubble it raises on submit: `feedback` replaces the message under
 the field and does not reach that one. */
   valueMissingMessage?: (HelixFilterInput["valueMissingMessage"]) | undefined;
+  /** Whether the field keeps a `FilterChip` for each filter in its `tags` slot,
+from the `helix-facet` events it hears.
+
+Off, you build the chips, which is what you do when your own model holds
+the filters. On, a filter typed, picked, or changed adds or updates the
+chip for its field, one with no values takes it away (unless its
+comparison takes none, such as "is empty"), and removing the chip clears
+the filter. A `helix-facet` you cancel changes no chip.
+
+The chips are elements the field adds to its own children, so leave this
+off where a framework renders those children and would remove them. */
+  chips?: (HelixFilterInput["chips"]) | undefined;
   /** Shows a button that empties the field.
 
 The text only. The tokens are the consumer's markup and this element is not
@@ -15860,6 +15946,29 @@ what you slot and you narrow it. */
 being typed, as React Aria's Autocomplete filters. Off, the panel shows
 what you slot and you narrow it. */
   filterSuggestions?: (HelixFilterInput["filterSuggestions"]) | undefined;
+  /** Whether the suggestions are still loading, such as while a request for the
+values of a typed key is out.
+
+The panel opens on `loading-text`, or the `loading` slot, while the field
+has focus, and a screen reader hears it. Slot the options and clear this
+when they arrive. */
+  loading?: (HelixFilterInput["loading"]) | undefined;
+  /** Text the panel shows while the suggestions load. */
+  "loading-text"?: (HelixFilterInput["loadingText"]) | undefined;
+  /** Text the panel shows while the suggestions load. */
+  loadingText?: (HelixFilterInput["loadingText"]) | undefined;
+  /** Text the panel shows when `filter-suggestions` hides every suggestion, such
+as "No matching filters".
+
+Empty, or no `no-results` slot, and the panel closes instead, as it does
+when it has nothing to offer. */
+  "no-results-text"?: (HelixFilterInput["noResultsText"]) | undefined;
+  /** Text the panel shows when `filter-suggestions` hides every suggestion, such
+as "No matching filters".
+
+Empty, or no `no-results` slot, and the panel closes instead, as it does
+when it has nothing to offer. */
+  noResultsText?: (HelixFilterInput["noResultsText"]) | undefined;
   /** The text shown while the field is empty.
 
 Not a label: it goes when typing starts. */
@@ -16050,6 +16159,18 @@ and this one was the English a form in another language still spoke in
 the bubble it raises on submit: `feedback` replaces the message under
 the field and does not reach that one. */
   "prop:valueMissingMessage"?: (HelixFilterInput["valueMissingMessage"]) | undefined;
+  /** Whether the field keeps a `FilterChip` for each filter in its `tags` slot,
+from the `helix-facet` events it hears.
+
+Off, you build the chips, which is what you do when your own model holds
+the filters. On, a filter typed, picked, or changed adds or updates the
+chip for its field, one with no values takes it away (unless its
+comparison takes none, such as "is empty"), and removing the chip clears
+the filter. A `helix-facet` you cancel changes no chip.
+
+The chips are elements the field adds to its own children, so leave this
+off where a framework renders those children and would remove them. */
+  "prop:chips"?: (HelixFilterInput["chips"]) | undefined;
   /** Shows a button that empties the field.
 
 The text only. The tokens are the consumer's markup and this element is not
@@ -16071,6 +16192,29 @@ what you slot and you narrow it. */
 being typed, as React Aria's Autocomplete filters. Off, the panel shows
 what you slot and you narrow it. */
   "prop:filterSuggestions"?: (HelixFilterInput["filterSuggestions"]) | undefined;
+  /** Whether the suggestions are still loading, such as while a request for the
+values of a typed key is out.
+
+The panel opens on `loading-text`, or the `loading` slot, while the field
+has focus, and a screen reader hears it. Slot the options and clear this
+when they arrive. */
+  "prop:loading"?: (HelixFilterInput["loading"]) | undefined;
+  /** Text the panel shows while the suggestions load. */
+  "attr:loading-text"?: (HelixFilterInput["loadingText"]) | undefined;
+  /** Text the panel shows while the suggestions load. */
+  "prop:loadingText"?: (HelixFilterInput["loadingText"]) | undefined;
+  /** Text the panel shows when `filter-suggestions` hides every suggestion, such
+as "No matching filters".
+
+Empty, or no `no-results` slot, and the panel closes instead, as it does
+when it has nothing to offer. */
+  "attr:no-results-text"?: (HelixFilterInput["noResultsText"]) | undefined;
+  /** Text the panel shows when `filter-suggestions` hides every suggestion, such
+as "No matching filters".
+
+Empty, or no `no-results` slot, and the panel closes instead, as it does
+when it has nothing to offer. */
+  "prop:noResultsText"?: (HelixFilterInput["noResultsText"]) | undefined;
   /** The text shown while the field is empty.
 
 Not a label: it goes when typing starts. */
@@ -24991,9 +25135,13 @@ speaks it: `feedback` replaces the message under the field and does not
 reach the bubble. Unset is the sentence registered for the page's
 language, then the English. */
   badInputMessage?: (HelixNumberInput["badInputMessage"]) | undefined;
-  /** The name of the step down button, read by screen readers. */
+  /** The name of the step down button, read by screen readers. The field's
+label follows it, so a reader hears "Decrease Quantity", as React Aria
+names its steppers. */
   "decrement-label"?: (HelixNumberInput["decrementLabel"]) | undefined;
-  /** The name of the step down button, read by screen readers. */
+  /** The name of the step down button, read by screen readers. The field's
+label follows it, so a reader hears "Decrease Quantity", as React Aria
+names its steppers. */
   decrementLabel?: (HelixNumberInput["decrementLabel"]) | undefined;
   /** `Intl.NumberFormat` options the number is shown with while the field is
 not being edited: a currency, a percent, a unit, or a number of decimals.
@@ -25011,9 +25159,13 @@ Written as JSON in the attribute.
 <helix-number-input format-options='{"style":"currency","currency":"EUR"}'></helix-number-input>
 ``` */
   formatOptions?: (HelixNumberInput["formatOptions"]) | undefined;
-  /** The name of the step up button, read by screen readers. */
+  /** The name of the step up button, read by screen readers. The field's
+label follows it, so a reader hears "Increase Quantity", as React Aria
+names its steppers. */
   "increment-label"?: (HelixNumberInput["incrementLabel"]) | undefined;
-  /** The name of the step up button, read by screen readers. */
+  /** The name of the step up button, read by screen readers. The field's
+label follows it, so a reader hears "Increase Quantity", as React Aria
+names its steppers. */
   incrementLabel?: (HelixNumberInput["incrementLabel"]) | undefined;
   /** How many steps `PageUp` and `PageDown` move.
 
@@ -25270,9 +25422,13 @@ speaks it: `feedback` replaces the message under the field and does not
 reach the bubble. Unset is the sentence registered for the page's
 language, then the English. */
   "prop:badInputMessage"?: (HelixNumberInput["badInputMessage"]) | undefined;
-  /** The name of the step down button, read by screen readers. */
+  /** The name of the step down button, read by screen readers. The field's
+label follows it, so a reader hears "Decrease Quantity", as React Aria
+names its steppers. */
   "attr:decrement-label"?: (HelixNumberInput["decrementLabel"]) | undefined;
-  /** The name of the step down button, read by screen readers. */
+  /** The name of the step down button, read by screen readers. The field's
+label follows it, so a reader hears "Decrease Quantity", as React Aria
+names its steppers. */
   "prop:decrementLabel"?: (HelixNumberInput["decrementLabel"]) | undefined;
   /** `Intl.NumberFormat` options the number is shown with while the field is
 not being edited: a currency, a percent, a unit, or a number of decimals.
@@ -25290,9 +25446,13 @@ Written as JSON in the attribute.
 <helix-number-input format-options='{"style":"currency","currency":"EUR"}'></helix-number-input>
 ``` */
   "prop:formatOptions"?: (HelixNumberInput["formatOptions"]) | undefined;
-  /** The name of the step up button, read by screen readers. */
+  /** The name of the step up button, read by screen readers. The field's
+label follows it, so a reader hears "Increase Quantity", as React Aria
+names its steppers. */
   "attr:increment-label"?: (HelixNumberInput["incrementLabel"]) | undefined;
-  /** The name of the step up button, read by screen readers. */
+  /** The name of the step up button, read by screen readers. The field's
+label follows it, so a reader hears "Increase Quantity", as React Aria
+names its steppers. */
   "prop:incrementLabel"?: (HelixNumberInput["incrementLabel"]) | undefined;
   /** How many steps `PageUp` and `PageDown` move.
 
@@ -29131,6 +29291,11 @@ it, here or anywhere: a frame is a document of its own and what is written
 on this host reaches nothing inside it, which is the same reason
 `colorMode` has to be sent rather than set. */
   direction?: (HelixSandboxPreview["direction"]) | undefined;
+  /** The packages an example can import by name in the built-in document,
+each mapped to the address of an ES module, as an import map's `imports`.
+Set it as JSON in the attribute or as an object. Not read where `src` is
+set. */
+  imports?: (HelixSandboxPreview["imports"]) | undefined;
   /** The frame's name, read by screen readers. */
   label?: (HelixSandboxPreview["label"]) | undefined;
   /** How the example is placed in the frame.
@@ -29213,6 +29378,11 @@ it, here or anywhere: a frame is a document of its own and what is written
 on this host reaches nothing inside it, which is the same reason
 `colorMode` has to be sent rather than set. */
   "prop:direction"?: (HelixSandboxPreview["direction"]) | undefined;
+  /** The packages an example can import by name in the built-in document,
+each mapped to the address of an ES module, as an import map's `imports`.
+Set it as JSON in the attribute or as an object. Not read where `src` is
+set. */
+  "prop:imports"?: (HelixSandboxPreview["imports"]) | undefined;
   /** The frame's name, read by screen readers. */
   "prop:label"?: (HelixSandboxPreview["label"]) | undefined;
   /** How the example is placed in the frame.
@@ -29652,6 +29822,10 @@ the pane's `label`. */
   /** The pane's file name, such as `index.html`, on its tab where a sandbox
 holds several panes. Empty puts the pane's `name` on the tab. */
   label?: (HelixSandboxSource["label"]) | undefined;
+  /** Whether each line of the source is numbered, in a gutter beside it. */
+  "line-numbers"?: (HelixSandboxSource["lineNumbers"]) | undefined;
+  /** Whether each line of the source is numbered, in a gutter beside it. */
+  lineNumbers?: (HelixSandboxSource["lineNumbers"]) | undefined;
   /** Which source this pane holds. Every `helix-before-edit` event includes it.
 
 `html` and `css` are what the sandbox root routes on; any other name is
@@ -29708,6 +29882,10 @@ the pane's `label`. */
   /** The pane's file name, such as `index.html`, on its tab where a sandbox
 holds several panes. Empty puts the pane's `name` on the tab. */
   "prop:label"?: (HelixSandboxSource["label"]) | undefined;
+  /** Whether each line of the source is numbered, in a gutter beside it. */
+  "bool:line-numbers"?: (HelixSandboxSource["lineNumbers"]) | undefined;
+  /** Whether each line of the source is numbered, in a gutter beside it. */
+  "prop:lineNumbers"?: (HelixSandboxSource["lineNumbers"]) | undefined;
   /** Which source this pane holds. Every `helix-before-edit` event includes it.
 
 `html` and `css` are what the sandbox root routes on; any other name is
@@ -32687,7 +32865,8 @@ Ignored once `active` is written. */
 Ignored once `active` is written. */
   defaultActive?: (HelixSteps["defaultActive"]) | undefined;
   /** Whether the arrow keys move focus between the stages' names, along the
-way the steps run. Off by default, so the arrows keep scrolling the page. */
+way the steps run, and the names are one tab stop. Off by default, so the
+arrows keep scrolling the page. */
   arrows?: (HelixSteps["arrows"]) | undefined;
   /** What marks a stage `complete`.
 
@@ -32771,7 +32950,8 @@ Ignored once `active` is written. */
 Ignored once `active` is written. */
   "prop:defaultActive"?: (HelixSteps["defaultActive"]) | undefined;
   /** Whether the arrow keys move focus between the stages' names, along the
-way the steps run. Off by default, so the arrows keep scrolling the page. */
+way the steps run, and the names are one tab stop. Off by default, so the
+arrows keep scrolling the page. */
   "prop:arrows"?: (HelixSteps["arrows"]) | undefined;
   /** What marks a stage `complete`.
 
@@ -32872,7 +33052,9 @@ with the page. */
   /** Whether a reader may pass the stage without finishing it, in a sequence
 with `linear`. Ark UI's skippable step. */
   optional?: (HelixStep["optional"]) | undefined;
-  /** The value the step sends in `helix-select`. */
+  /** The value the step sends in `helix-select`, and what names the step in its
+sequence's `active`. Without one, the sequence names the step by its place,
+counted from 1. */
   value?: (HelixStep["value"]) | undefined;
 
   /** Fired when the step is pressed. Cancelable: cancel it to keep the current step. */
@@ -32905,7 +33087,9 @@ with the page. */
   /** Whether a reader may pass the stage without finishing it, in a sequence
 with `linear`. Ark UI's skippable step. */
   "prop:optional"?: (HelixStep["optional"]) | undefined;
-  /** The value the step sends in `helix-select`. */
+  /** The value the step sends in `helix-select`, and what names the step in its
+sequence's `active`. Without one, the sequence names the step by its place,
+counted from 1. */
   "prop:value"?: (HelixStep["value"]) | undefined;
   /** Fired when the step is pressed. Cancelable: cancel it to keep the current step. */
   "on:helix-select"?: ((e: HelixStepHelixSelectElementEvent) => void) | undefined;
@@ -45776,6 +45960,10 @@ export type CustomElements = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `empty`: The conversation has no turns.
+   * - `loading`: Older turns are loading: `history` is `loading`.
+   * - `pinned`: The transcript follows its newest turn.
+   * - `typing`: `typing` names someone on the other side.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-chat": Partial<HelixChatProps & BaseProps<HelixChat> & BaseEvents<HelixChat>>;
@@ -46301,6 +46489,8 @@ export type CustomElements = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
+   * - `added-lines`/`addedLines`: The lines to mark as inserted, as numbers and ranges counted from 1, such
+   * as `3-4`. Drawn as `mark-lines` is, in the added color. Not for a diff.
    * - `code-label`/`codeLabel`: The name of a block that scrolls, which is a tab stop while it does.
    *
    * Where the block has a name, the scroller says it too, such as "Code,
@@ -46377,6 +46567,8 @@ export type CustomElements = {
    * `no-copy=""` on hosts that never asked for one, and the rule about a
    * reflected property taking no default is satisfied by the default being
    * `false`.
+   * - `removed-lines`/`removedLines`: The lines to mark as deleted, as numbers and ranges counted from 1. Drawn
+   * as `mark-lines` is, in the removed color. Not for a diff.
    * - `show-unchanged-label`/`showUnchangedLabel`: The words of a button that shows a folded run of unchanged lines, in a
    * diff with `context-lines`. `{count}` is how many.
    * - `variant`: How a diff's two versions are arranged. It has no effect without `diff`.
@@ -46456,6 +46648,8 @@ export type CustomElements = {
    * - `actions`: Controls for the block, in the header before the copy button.
    * - `copied-icon`: The copy button's icon after a copy. Defaults to a check mark.
    * - `copy-icon`: The copy button's icon before a copy. Defaults to a clipboard.
+   * - `expand-icon`: An icon on the button that shows every line of a capped block, before its words.
+   * - `label`: The block's name in the header, such as a file icon beside the file name. Replaces `label` and `language` there, and draws the header.
    *
    * ## CSS Custom Properties
    *
@@ -46520,7 +46714,9 @@ export type CustomElements = {
    * - `header`: The bar that holds the name and the copy button, shown when there is a name.
    * - `hunk`: In a diff, a `@@` line saying where the lines under it are.
    * - `label`: The block's name: its `label`, or its `language` where it has no label.
-   * - `mark`: The band behind a run of lines `mark-lines` names. The block writes where the run is laid out into `--code-block-mark-start`, `--code-block-mark-size`, and `--code-block-mark-inline-size` on it. Hidden from the accessibility tree.
+   * - `mark`: The band behind a run of lines `mark-lines`, `added-lines` or `removed-lines` names. The block writes where the run is laid out into `--code-block-mark-start`, `--code-block-mark-size`, and `--code-block-mark-inline-size` on it. Hidden from the accessibility tree.
+   * - `mark-added`: The band behind a run of lines `added-lines` names. Applied with `mark`.
+   * - `mark-removed`: The band behind a run of lines `removed-lines` names. Applied with `mark`.
    * - `marker`: In a diff, the `+`, `-`, or space that starts a line.
    * - `new`: In a split diff, the new version's `<pre>`.
    * - `number`: In a diff, a line number. In a `wrap` block with `line-numbers`, one line's number in the gutter, which the block makes as tall as the line it numbers through `--code-block-line-size`.
@@ -47129,10 +47325,11 @@ export type CustomElements = {
    * the anchor the browser points its bubble at.
    *
    * **Text that is not a color is bad input**, so a form does not submit
-   * `#00` from a half-typed value. The picker draws no message of its own, so
-   * reporting it as each keystroke arrives shows nothing until the form asks;
-   * Color Input shows its own message against the field the reader typed
-   * into.
+   * `#00` from a half-typed value. The picker marks it, and says
+   * `badInputMessage` under itself, once the reader leaves the value field or
+   * presses Enter, and a missing color once the reader has committed one or a
+   * form has refused the picker. Color Input shows its own message against the
+   * field the reader typed into.
    * - `saturation-label`/`saturationLabel`: What the square's horizontal ramp is called.
    * - `square-text`/`squareText`: What a screen reader hears for the square's place, the color's two
    * numbers and its name, on whichever of its two inputs it is on.
@@ -47231,12 +47428,8 @@ export type CustomElements = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `formResetCallback() => void`: Returns the control to its `defaultValue`, or to its `value` attribute
-   * where there is no `default-value`.
-   *
-   * Both halves are dropped, the consumer's and the control's, because a
-   * reset means the form is as it was served. Clearing only the internal one
-   * would leave a control that had been written to stuck at that value.
+   * - `formResetCallback() => void`: A reset ends any typing and takes back text that was not a color, so the
+   * field shows the color the reset put back.
    * - `requestValue(next: string) => boolean`: Requests a new value, and returns whether the change was applied.
    *
    * Announces before it acts, so `preventDefault()` on the `helix-before-change` is
@@ -47335,7 +47528,7 @@ export type CustomElements = {
    * - `eyedropper-live`: The live region of the button inside `eyedropper`, which says its pending label.
    * - `eyedropper-spinner`: The ring the eyedropper button turns while it is pending.
    * - `eyedropper-text`: The words on the button inside `eyedropper`, trimmed to their capitals and baseline.
-   * - `feedback`: The message under the picker, while `feedback` is set.
+   * - `feedback`: The message under the picker: `feedback`, or what is wrong with the answer once the picker is marked invalid.
    * - `field`: One channel's number field with its label, in `channel-fields`.
    * - `field-input`: The number input in a channel's field.
    * - `field-label`: The name above a channel's number input.
@@ -47502,12 +47695,13 @@ export type CustomElements = {
    * language.
    * - `multiple`: Whether more than one option can be chosen.
    *
-   * The list already does the work: `value` comes apart on commas, a press
-   * toggles rather than replaces, and the arrows move without choosing. What
-   * this adds is the tags, and keeping the panel open between picks.
+   * The list already does the work: `value` is the chosen values joined with
+   * commas, a press toggles rather than replaces, and the arrows move without
+   * choosing. What this adds is the tags, and keeping the panel open between
+   * picks.
    *
-   * A comma is therefore not available inside an option's value, which is the
-   * listbox's contract and not this element's to change.
+   * An option's value may hold a comma, and it is read as one value, as
+   * `Select` and `Listbox` read it. So may an answer the reader created.
    *
    * **The list is told, and the field is not.** `aria-multiselectable` belongs
    * to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
@@ -47798,6 +47992,11 @@ export type CustomElements = {
    * - `filter-delay`/`filterDelay`: How long typing rests before the commands are filtered, in milliseconds,
    * so a palette filtered on a server sends one `helix-filter` for a word.
    * `0` filters on every keystroke. See Listbox's `filter-delay`.
+   * - `home-end`/`homeEnd`: Where Home and End go from the filter field.
+   *
+   * Absent, they move the caret, as APG's combobox has them. `list` moves the
+   * highlight to the first or the last command, as React Aria's Autocomplete
+   * does, and Shift with either still selects the text.
    * - `hotkey`: The key that opens the palette, written as `mod+k`, `shift+p`, or `k`,
    * in Kbd's chord spelling: `mod` is Command or Control, `ctrl`, `cmd`,
    * `alt` and `shift` the keys they name.
@@ -47812,6 +48011,9 @@ export type CustomElements = {
    * Choosing a command says `helix-select` and leaves the list where it is,
    * and `open`, `toggle` and the dialog's parts do nothing.
    * - `label`: Accessible name for the overlay, which has no visible heading.
+   * - `layout`: How the commands are laid out, as Listbox's `layout`: `grid` draws them in
+   * rows and columns, for a palette of icons or emoji, and the arrow keys
+   * follow the rows and the columns. Absent is one command under another.
    * - `load-error`/`loadError`: What the list says when its commands could not be loaded, such as after a
    * request to a server fails. Empty, null or no attribute is no error, so
    * removing the attribute clears it. Passed to the list, which shows it
@@ -51210,6 +51412,12 @@ export type CustomElements = {
    * nothing between them, because a word every chip carries is a word nobody
    * reads. The moment somebody picks a different comparison it appears, which
    * makes an unusual filter look unusual.
+   * - `dismissTabStop`: Whether the remove button is a tab stop of its own.
+   *
+   * `FilterInput` writes `false` on the chips in its `tags` slot: the field's
+   * text is its one tab stop, and the arrow keys move from the text to the
+   * chips, as in a `multiple` Combobox. No attribute: it is coordination
+   * between elements, as `Tag.dismissTabStop` is. (property only)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -51667,6 +51875,17 @@ export type CustomElements = {
    * and this one was the English a form in another language still spoke in
    * the bubble it raises on submit: `feedback` replaces the message under
    * the field and does not reach that one.
+   * - `chips`: Whether the field keeps a `FilterChip` for each filter in its `tags` slot,
+   * from the `helix-facet` events it hears.
+   *
+   * Off, you build the chips, which is what you do when your own model holds
+   * the filters. On, a filter typed, picked, or changed adds or updates the
+   * chip for its field, one with no values takes it away (unless its
+   * comparison takes none, such as "is empty"), and removing the chip clears
+   * the filter. A `helix-facet` you cancel changes no chip.
+   *
+   * The chips are elements the field adds to its own children, so leave this
+   * off where a framework renders those children and would remove them.
    * - `clearable`: Shows a button that empties the field.
    *
    * The text only. The tokens are the consumer's markup and this element is not
@@ -51678,6 +51897,18 @@ export type CustomElements = {
    * - `filter-suggestions`/`filterSuggestions`: Whether the panel narrows itself to the suggestions that hold the term
    * being typed, as React Aria's Autocomplete filters. Off, the panel shows
    * what you slot and you narrow it.
+   * - `loading`: Whether the suggestions are still loading, such as while a request for the
+   * values of a typed key is out.
+   *
+   * The panel opens on `loading-text`, or the `loading` slot, while the field
+   * has focus, and a screen reader hears it. Slot the options and clear this
+   * when they arrive.
+   * - `loading-text`/`loadingText`: Text the panel shows while the suggestions load.
+   * - `no-results-text`/`noResultsText`: Text the panel shows when `filter-suggestions` hides every suggestion, such
+   * as "No matching filters".
+   *
+   * Empty, or no `no-results` slot, and the panel closes instead, as it does
+   * when it has nothing to offer.
    * - `placeholder`: The text shown while the field is empty.
    *
    * Not a label: it goes when typing starts.
@@ -51780,6 +52011,8 @@ export type CustomElements = {
    * - `feedback`: The message that says what is wrong, for content richer than a string. It shows while there is a message.
    * - `hint`: Help under the control, for content richer than the `hint` text.
    * - `label`: The label, for content richer than the `label` text.
+   * - `loading`: What the panel shows while `loading` is set, for content richer than `loading-text`.
+   * - `no-results`: What the panel shows when `filter-suggestions` hides every suggestion, for content richer than `no-results-text`.
    * - `start`: Content before the text, such as a search icon.
    * - `suggestions`: Suggestions for what to type next, as `Option`s and `Option.Group`s.
    * - `tags`: The active filters, as `FilterChip`s or `Tag`s.
@@ -51883,12 +52116,14 @@ export type CustomElements = {
    *
    * - `clear`: The button that empties the field.
    * - `control`: The input itself.
+   * - `empty`: Shown in the panel when `filter-suggestions` hides every suggestion.
    * - `feedback`: The error message under the field.
    * - `field`: The box that holds everything.
    * - `hint`: The help text under the field, shown while there is no error.
    * - `label`: The label above the field.
    * - `lead`: The box before the text that holds the `start` slot.
    * - `live`: The live region that says how many suggestions the open panel offers. It is rendered from the first time the panel opens with suggestions.
+   * - `loading`: Shown in the panel while the suggestions load.
    * - `rest`: The count of tokens that did not fit. It is a `<button>` with `expandable` and a `<span>` without it.
    * - `surface`: The floating panel the suggestions sit in.
    * - `tags`: The row the tokens sit in.
@@ -51898,6 +52133,8 @@ export type CustomElements = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `invalid`: The field has an error to show, from the browser's validation or from your `feedback`.
+   * - `loading`: While `loading` is set.
+   * - `no-results`: `filter-suggestions` hid every suggestion, and `no-results-text` or the `no-results` slot says so.
    * - `open`: The suggestions are open.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -53763,6 +54000,9 @@ export type CustomElements = {
    * Falling back to what the markup declared rather than to empty, because
    * a restore with no state is a form the browser has nothing recorded for,
    * which is the same situation as a fresh one.
+   * - `setRangeText(replacement: string, start?: number, end?: number, selectMode?: SelectionMode) => void`: Replaces a range of the text, as the native method does: the selection
+   * where `start` and `end` are left out, and `selectMode` says what is
+   * selected after. It sends no event, as the native method sends none.
    * - `setSelectionRange(start: number, end: number, direction?: SelectionDirection) => void`: Selects the range from `start` to `end` in one call, which setting
    * `selectionStart` and `selectionEnd` one at a time cannot always do.
    *
@@ -58211,7 +58451,9 @@ export type CustomElements = {
    * speaks it: `feedback` replaces the message under the field and does not
    * reach the bubble. Unset is the sentence registered for the page's
    * language, then the English.
-   * - `decrement-label`/`decrementLabel`: The name of the step down button, read by screen readers.
+   * - `decrement-label`/`decrementLabel`: The name of the step down button, read by screen readers. The field's
+   * label follows it, so a reader hears "Decrease Quantity", as React Aria
+   * names its steppers.
    * - `format-options`/`formatOptions`: `Intl.NumberFormat` options the number is shown with while the field is
    * not being edited: a currency, a percent, a unit, or a number of decimals.
    * Written as JSON in the attribute.
@@ -58219,7 +58461,9 @@ export type CustomElements = {
    * ```html
    * <helix-number-input format-options='{"style":"currency","currency":"EUR"}'></helix-number-input>
    * ```
-   * - `increment-label`/`incrementLabel`: The name of the step up button, read by screen readers.
+   * - `increment-label`/`incrementLabel`: The name of the step up button, read by screen readers. The field's
+   * label follows it, so a reader hears "Increase Quantity", as React Aria
+   * names its steppers.
    * - `large-step`/`largeStep`: How many steps `PageUp` and `PageDown` move.
    *
    * Ten steps, which is the convention every spinner on the platform follows,
@@ -58380,8 +58624,10 @@ export type CustomElements = {
    * Falling back to what the markup declared rather than to empty, because
    * a restore with no state is a form the browser has nothing recorded for,
    * which is the same situation as a fresh one.
-   * - `stepUp(large = false) => void`: Steps the value up, by `largeStep` steps when `large` is set.
-   * - `stepDown(large = false) => void`: Steps the value down, by `largeStep` steps when `large` is set.
+   * - `stepUp(count: number | boolean = 1) => void`: Steps the value up by `step`, `count` times, as the native method and
+   * `Input.stepUp` do. `true` takes `largeStep` steps, as `PageUp` does.
+   * - `stepDown(count: number | boolean = 1) => void`: Steps the value down by `step`, `count` times. `true` takes `largeStep`
+   * steps, as `PageDown` does.
    *
    * The same path a press of the down arrow takes, so a consumer driving this
    * from their own control gets the clamping and the announcement rather than
@@ -61322,6 +61568,15 @@ export type CustomElements = {
    * `servePreview` does. It defines no element, so an example that uses Helix
    * components needs a `src` that imports them.
    *
+   * **`imports` lets an example import packages by name** in the built-in
+   * document, as an import map: each name maps to the address of an ES module,
+   * such as `{"canvas-confetti": "https://esm.sh/canvas-confetti@1.9.3"}`, and
+   * `import confetti from 'canvas-confetti'` in the `js` pane then loads it. A
+   * CDN that serves npm packages as modules, such as esm.sh or jsDelivr's
+   * `+esm`, gives every package an address. A new map loads the document again,
+   * since a browser reads one only as a document starts. A `src` document
+   * declares its own.
+   *
    * **Examples render in a frame**, so an example's styles and scripts do not
    * affect the page around the sandbox, and `position: fixed` stays inside the
    * pane. The frame starts empty, with its own stylesheets and its own custom
@@ -61374,6 +61629,10 @@ export type CustomElements = {
    * it, here or anywhere: a frame is a document of its own and what is written
    * on this host reaches nothing inside it, which is the same reason
    * `colorMode` has to be sent rather than set.
+   * - `imports`: The packages an example can import by name in the built-in document,
+   * each mapped to the address of an ES module, as an import map's `imports`.
+   * Set it as JSON in the attribute or as an object. Not read where `src` is
+   * set.
    * - `label`: The frame's name, read by screen readers.
    * - `layout`: How the example is placed in the frame.
    *
@@ -61691,6 +61950,18 @@ export type CustomElements = {
    * that throws leaves the source drawn plain and the field editable, and the
    * error is reported to the page as an uncaught one.
    *
+   * **`line-numbers` numbers each line** in a gutter beside the source. A line
+   * that wraps keeps one number. The numbers are drawn, and hidden from screen
+   * readers, which read the field.
+   *
+   * Enter keeps the indentation of the line it breaks, and the new line is
+   * undone with the next undo as typing is.
+   *
+   * **The source can be written inside the pane** where `value` is not set: its
+   * text, or the markup of a `<template>` it holds, without the indentation the
+   * page gave it. Markup goes in a template so the page does not render it or
+   * run its scripts. Text inside the pane is read once, when it connects.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -61702,6 +61973,7 @@ export type CustomElements = {
    * - `keys-description`/`keysDescription`: The field's description, read by screen readers while Tab indents.
    * - `label`: The pane's file name, such as `index.html`, on its tab where a sandbox
    * holds several panes. Empty puts the pane's `name` on the tab.
+   * - `line-numbers`/`lineNumbers`: Whether each line of the source is numbered, in a gutter beside it.
    * - `name`: Which source this pane holds. Every `helix-before-edit` event includes it.
    *
    * `html` and `css` are what the sandbox root routes on; any other name is
@@ -61760,6 +62032,7 @@ export type CustomElements = {
    * - `--sandbox-source-constant-color`: Color of a `constant` run, under `tokenize`. Defaults to `--helix-color-syntax-constant`.
    * - `--sandbox-source-invalid-color`: Color of an `invalid` run, under `tokenize`. Defaults to `--helix-color-syntax-invalid`.
    * - `--sandbox-source-keyword-color`: Color of a `keyword` run, under `tokenize`. Defaults to `--helix-color-syntax-keyword`.
+   * - `--sandbox-source-line-number-color`: Color of the line numbers, under `line-numbers`. Defaults to `--helix-color-foreground-subtle`.
    * - `--sandbox-source-min-block-size`: Minimum height of the pane.
    * - `--sandbox-source-name-color`: Color of a `name` run, under `tokenize`. Defaults to `--helix-color-syntax-name`.
    * - `--sandbox-source-string-color`: Color of a `string` run, under `tokenize`. Defaults to `--helix-color-syntax-string`.
@@ -61769,8 +62042,9 @@ export type CustomElements = {
    *
    * Custom selectors for styling elements within the component.
    *
-   * - `field`: The box that scrolls the field and its colors together, under `tokenize`.
-   * - `highlight`: The colored copy of the source drawn under the field, under `tokenize`.
+   * - `field`: The box that scrolls the field and its colors together, under `tokenize` or `line-numbers`.
+   * - `highlight`: The colored copy of the source drawn under the field, under `tokenize` or `line-numbers`.
+   * - `line`: One line of that copy, under `line-numbers`, numbered in the gutter by its `::before`.
    * - `source`: The editable region.
    * - `token`: One run of the source that has a kind, under `tokenize`.
    *
@@ -64312,7 +64586,8 @@ export type CustomElements = {
    *
    * Ignored once `active` is written.
    * - `arrows`: Whether the arrow keys move focus between the stages' names, along the
-   * way the steps run. Off by default, so the arrows keep scrolling the page.
+   * way the steps run, and the names are one tab stop. Off by default, so the
+   * arrows keep scrolling the page.
    * - `completion`: What marks a stage `complete`.
    *
    * Absent, you do: each step's `complete` is yours, because a reader who
@@ -64467,7 +64742,9 @@ export type CustomElements = {
    * - `disabled`: Whether the stage is disabled, so the user cannot go to it.
    * - `optional`: Whether a reader may pass the stage without finishing it, in a sequence
    * with `linear`. Ark UI's skippable step.
-   * - `value`: The value the step sends in `helix-select`.
+   * - `value`: The value the step sends in `helix-select`, and what names the step in its
+   * sequence's `active`. Without one, the sequence names the step by its place,
+   * counted from 1.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -75038,6 +75315,10 @@ export type CustomElementsSolidJs = {
    *
    * These can be used to apply styling when a component is in a given state.
    *
+   * - `empty`: The conversation has no turns.
+   * - `loading`: Older turns are loading: `history` is `loading`.
+   * - `pinned`: The transcript follows its newest turn.
+   * - `typing`: `typing` names someone on the other side.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
   "helix-chat": Partial<
@@ -75571,6 +75852,8 @@ export type CustomElementsSolidJs = {
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
+   * - `added-lines`/`addedLines`: The lines to mark as inserted, as numbers and ranges counted from 1, such
+   * as `3-4`. Drawn as `mark-lines` is, in the added color. Not for a diff.
    * - `code-label`/`codeLabel`: The name of a block that scrolls, which is a tab stop while it does.
    *
    * Where the block has a name, the scroller says it too, such as "Code,
@@ -75647,6 +75930,8 @@ export type CustomElementsSolidJs = {
    * `no-copy=""` on hosts that never asked for one, and the rule about a
    * reflected property taking no default is satisfied by the default being
    * `false`.
+   * - `removed-lines`/`removedLines`: The lines to mark as deleted, as numbers and ranges counted from 1. Drawn
+   * as `mark-lines` is, in the removed color. Not for a diff.
    * - `show-unchanged-label`/`showUnchangedLabel`: The words of a button that shows a folded run of unchanged lines, in a
    * diff with `context-lines`. `{count}` is how many.
    * - `variant`: How a diff's two versions are arranged. It has no effect without `diff`.
@@ -75726,6 +76011,8 @@ export type CustomElementsSolidJs = {
    * - `actions`: Controls for the block, in the header before the copy button.
    * - `copied-icon`: The copy button's icon after a copy. Defaults to a check mark.
    * - `copy-icon`: The copy button's icon before a copy. Defaults to a clipboard.
+   * - `expand-icon`: An icon on the button that shows every line of a capped block, before its words.
+   * - `label`: The block's name in the header, such as a file icon beside the file name. Replaces `label` and `language` there, and draws the header.
    *
    * ## CSS Custom Properties
    *
@@ -75790,7 +76077,9 @@ export type CustomElementsSolidJs = {
    * - `header`: The bar that holds the name and the copy button, shown when there is a name.
    * - `hunk`: In a diff, a `@@` line saying where the lines under it are.
    * - `label`: The block's name: its `label`, or its `language` where it has no label.
-   * - `mark`: The band behind a run of lines `mark-lines` names. The block writes where the run is laid out into `--code-block-mark-start`, `--code-block-mark-size`, and `--code-block-mark-inline-size` on it. Hidden from the accessibility tree.
+   * - `mark`: The band behind a run of lines `mark-lines`, `added-lines` or `removed-lines` names. The block writes where the run is laid out into `--code-block-mark-start`, `--code-block-mark-size`, and `--code-block-mark-inline-size` on it. Hidden from the accessibility tree.
+   * - `mark-added`: The band behind a run of lines `added-lines` names. Applied with `mark`.
+   * - `mark-removed`: The band behind a run of lines `removed-lines` names. Applied with `mark`.
    * - `marker`: In a diff, the `+`, `-`, or space that starts a line.
    * - `new`: In a split diff, the new version's `<pre>`.
    * - `number`: In a diff, a line number. In a `wrap` block with `line-numbers`, one line's number in the gutter, which the block makes as tall as the line it numbers through `--code-block-line-size`.
@@ -76407,10 +76696,11 @@ export type CustomElementsSolidJs = {
    * the anchor the browser points its bubble at.
    *
    * **Text that is not a color is bad input**, so a form does not submit
-   * `#00` from a half-typed value. The picker draws no message of its own, so
-   * reporting it as each keystroke arrives shows nothing until the form asks;
-   * Color Input shows its own message against the field the reader typed
-   * into.
+   * `#00` from a half-typed value. The picker marks it, and says
+   * `badInputMessage` under itself, once the reader leaves the value field or
+   * presses Enter, and a missing color once the reader has committed one or a
+   * form has refused the picker. Color Input shows its own message against the
+   * field the reader typed into.
    * - `saturation-label`/`saturationLabel`: What the square's horizontal ramp is called.
    * - `square-text`/`squareText`: What a screen reader hears for the square's place, the color's two
    * numbers and its name, on whichever of its two inputs it is on.
@@ -76509,12 +76799,8 @@ export type CustomElementsSolidJs = {
    *
    * Methods that can be called to access component functionality.
    *
-   * - `formResetCallback() => void`: Returns the control to its `defaultValue`, or to its `value` attribute
-   * where there is no `default-value`.
-   *
-   * Both halves are dropped, the consumer's and the control's, because a
-   * reset means the form is as it was served. Clearing only the internal one
-   * would leave a control that had been written to stuck at that value.
+   * - `formResetCallback() => void`: A reset ends any typing and takes back text that was not a color, so the
+   * field shows the color the reset put back.
    * - `requestValue(next: string) => boolean`: Requests a new value, and returns whether the change was applied.
    *
    * Announces before it acts, so `preventDefault()` on the `helix-before-change` is
@@ -76613,7 +76899,7 @@ export type CustomElementsSolidJs = {
    * - `eyedropper-live`: The live region of the button inside `eyedropper`, which says its pending label.
    * - `eyedropper-spinner`: The ring the eyedropper button turns while it is pending.
    * - `eyedropper-text`: The words on the button inside `eyedropper`, trimmed to their capitals and baseline.
-   * - `feedback`: The message under the picker, while `feedback` is set.
+   * - `feedback`: The message under the picker: `feedback`, or what is wrong with the answer once the picker is marked invalid.
    * - `field`: One channel's number field with its label, in `channel-fields`.
    * - `field-input`: The number input in a channel's field.
    * - `field-label`: The name above a channel's number input.
@@ -76783,12 +77069,13 @@ export type CustomElementsSolidJs = {
    * language.
    * - `multiple`: Whether more than one option can be chosen.
    *
-   * The list already does the work: `value` comes apart on commas, a press
-   * toggles rather than replaces, and the arrows move without choosing. What
-   * this adds is the tags, and keeping the panel open between picks.
+   * The list already does the work: `value` is the chosen values joined with
+   * commas, a press toggles rather than replaces, and the arrows move without
+   * choosing. What this adds is the tags, and keeping the panel open between
+   * picks.
    *
-   * A comma is therefore not available inside an option's value, which is the
-   * listbox's contract and not this element's to change.
+   * An option's value may hold a comma, and it is read as one value, as
+   * `Select` and `Listbox` read it. So may an answer the reader created.
    *
    * **The list is told, and the field is not.** `aria-multiselectable` belongs
    * to `listbox`, `grid`, `tree` and `tablist`, and `combobox` dropped it in
@@ -77082,6 +77369,11 @@ export type CustomElementsSolidJs = {
    * - `filter-delay`/`filterDelay`: How long typing rests before the commands are filtered, in milliseconds,
    * so a palette filtered on a server sends one `helix-filter` for a word.
    * `0` filters on every keystroke. See Listbox's `filter-delay`.
+   * - `home-end`/`homeEnd`: Where Home and End go from the filter field.
+   *
+   * Absent, they move the caret, as APG's combobox has them. `list` moves the
+   * highlight to the first or the last command, as React Aria's Autocomplete
+   * does, and Shift with either still selects the text.
    * - `hotkey`: The key that opens the palette, written as `mod+k`, `shift+p`, or `k`,
    * in Kbd's chord spelling: `mod` is Command or Control, `ctrl`, `cmd`,
    * `alt` and `shift` the keys they name.
@@ -77096,6 +77388,9 @@ export type CustomElementsSolidJs = {
    * Choosing a command says `helix-select` and leaves the list where it is,
    * and `open`, `toggle` and the dialog's parts do nothing.
    * - `label`: Accessible name for the overlay, which has no visible heading.
+   * - `layout`: How the commands are laid out, as Listbox's `layout`: `grid` draws them in
+   * rows and columns, for a palette of icons or emoji, and the arrow keys
+   * follow the rows and the columns. Absent is one command under another.
    * - `load-error`/`loadError`: What the list says when its commands could not be loaded, such as after a
    * request to a server fails. Empty, null or no attribute is no error, so
    * removing the attribute clears it. Passed to the list, which shows it
@@ -80539,6 +80834,12 @@ export type CustomElementsSolidJs = {
    * nothing between them, because a word every chip carries is a word nobody
    * reads. The moment somebody picks a different comparison it appears, which
    * makes an unusual filter look unusual.
+   * - `dismissTabStop`: Whether the remove button is a tab stop of its own.
+   *
+   * `FilterInput` writes `false` on the chips in its `tags` slot: the field's
+   * text is its one tab stop, and the arrow keys move from the text to the
+   * chips, as in a `multiple` Combobox. No attribute: it is coordination
+   * between elements, as `Tag.dismissTabStop` is. (property only)
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -81008,6 +81309,17 @@ export type CustomElementsSolidJs = {
    * and this one was the English a form in another language still spoke in
    * the bubble it raises on submit: `feedback` replaces the message under
    * the field and does not reach that one.
+   * - `chips`: Whether the field keeps a `FilterChip` for each filter in its `tags` slot,
+   * from the `helix-facet` events it hears.
+   *
+   * Off, you build the chips, which is what you do when your own model holds
+   * the filters. On, a filter typed, picked, or changed adds or updates the
+   * chip for its field, one with no values takes it away (unless its
+   * comparison takes none, such as "is empty"), and removing the chip clears
+   * the filter. A `helix-facet` you cancel changes no chip.
+   *
+   * The chips are elements the field adds to its own children, so leave this
+   * off where a framework renders those children and would remove them.
    * - `clearable`: Shows a button that empties the field.
    *
    * The text only. The tokens are the consumer's markup and this element is not
@@ -81019,6 +81331,18 @@ export type CustomElementsSolidJs = {
    * - `filter-suggestions`/`filterSuggestions`: Whether the panel narrows itself to the suggestions that hold the term
    * being typed, as React Aria's Autocomplete filters. Off, the panel shows
    * what you slot and you narrow it.
+   * - `loading`: Whether the suggestions are still loading, such as while a request for the
+   * values of a typed key is out.
+   *
+   * The panel opens on `loading-text`, or the `loading` slot, while the field
+   * has focus, and a screen reader hears it. Slot the options and clear this
+   * when they arrive.
+   * - `loading-text`/`loadingText`: Text the panel shows while the suggestions load.
+   * - `no-results-text`/`noResultsText`: Text the panel shows when `filter-suggestions` hides every suggestion, such
+   * as "No matching filters".
+   *
+   * Empty, or no `no-results` slot, and the panel closes instead, as it does
+   * when it has nothing to offer.
    * - `placeholder`: The text shown while the field is empty.
    *
    * Not a label: it goes when typing starts.
@@ -81121,6 +81445,8 @@ export type CustomElementsSolidJs = {
    * - `feedback`: The message that says what is wrong, for content richer than a string. It shows while there is a message.
    * - `hint`: Help under the control, for content richer than the `hint` text.
    * - `label`: The label, for content richer than the `label` text.
+   * - `loading`: What the panel shows while `loading` is set, for content richer than `loading-text`.
+   * - `no-results`: What the panel shows when `filter-suggestions` hides every suggestion, for content richer than `no-results-text`.
    * - `start`: Content before the text, such as a search icon.
    * - `suggestions`: Suggestions for what to type next, as `Option`s and `Option.Group`s.
    * - `tags`: The active filters, as `FilterChip`s or `Tag`s.
@@ -81224,12 +81550,14 @@ export type CustomElementsSolidJs = {
    *
    * - `clear`: The button that empties the field.
    * - `control`: The input itself.
+   * - `empty`: Shown in the panel when `filter-suggestions` hides every suggestion.
    * - `feedback`: The error message under the field.
    * - `field`: The box that holds everything.
    * - `hint`: The help text under the field, shown while there is no error.
    * - `label`: The label above the field.
    * - `lead`: The box before the text that holds the `start` slot.
    * - `live`: The live region that says how many suggestions the open panel offers. It is rendered from the first time the panel opens with suggestions.
+   * - `loading`: Shown in the panel while the suggestions load.
    * - `rest`: The count of tokens that did not fit. It is a `<button>` with `expandable` and a `<span>` without it.
    * - `surface`: The floating panel the suggestions sit in.
    * - `tags`: The row the tokens sit in.
@@ -81239,6 +81567,8 @@ export type CustomElementsSolidJs = {
    * These can be used to apply styling when a component is in a given state.
    *
    * - `invalid`: The field has an error to show, from the browser's validation or from your `feedback`.
+   * - `loading`: While `loading` is set.
+   * - `no-results`: `filter-suggestions` hid every suggestion, and `no-results-text` or the `no-results` slot says so.
    * - `open`: The suggestions are open.
    * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
    */
@@ -83132,6 +83462,9 @@ export type CustomElementsSolidJs = {
    * Falling back to what the markup declared rather than to empty, because
    * a restore with no state is a form the browser has nothing recorded for,
    * which is the same situation as a fresh one.
+   * - `setRangeText(replacement: string, start?: number, end?: number, selectMode?: SelectionMode) => void`: Replaces a range of the text, as the native method does: the selection
+   * where `start` and `end` are left out, and `selectMode` says what is
+   * selected after. It sends no event, as the native method sends none.
    * - `setSelectionRange(start: number, end: number, direction?: SelectionDirection) => void`: Selects the range from `start` to `end` in one call, which setting
    * `selectionStart` and `selectionEnd` one at a time cannot always do.
    *
@@ -87670,7 +88003,9 @@ export type CustomElementsSolidJs = {
    * speaks it: `feedback` replaces the message under the field and does not
    * reach the bubble. Unset is the sentence registered for the page's
    * language, then the English.
-   * - `decrement-label`/`decrementLabel`: The name of the step down button, read by screen readers.
+   * - `decrement-label`/`decrementLabel`: The name of the step down button, read by screen readers. The field's
+   * label follows it, so a reader hears "Decrease Quantity", as React Aria
+   * names its steppers.
    * - `format-options`/`formatOptions`: `Intl.NumberFormat` options the number is shown with while the field is
    * not being edited: a currency, a percent, a unit, or a number of decimals.
    * Written as JSON in the attribute.
@@ -87678,7 +88013,9 @@ export type CustomElementsSolidJs = {
    * ```html
    * <helix-number-input format-options='{"style":"currency","currency":"EUR"}'></helix-number-input>
    * ```
-   * - `increment-label`/`incrementLabel`: The name of the step up button, read by screen readers.
+   * - `increment-label`/`incrementLabel`: The name of the step up button, read by screen readers. The field's
+   * label follows it, so a reader hears "Increase Quantity", as React Aria
+   * names its steppers.
    * - `large-step`/`largeStep`: How many steps `PageUp` and `PageDown` move.
    *
    * Ten steps, which is the convention every spinner on the platform follows,
@@ -87839,8 +88176,10 @@ export type CustomElementsSolidJs = {
    * Falling back to what the markup declared rather than to empty, because
    * a restore with no state is a form the browser has nothing recorded for,
    * which is the same situation as a fresh one.
-   * - `stepUp(large = false) => void`: Steps the value up, by `largeStep` steps when `large` is set.
-   * - `stepDown(large = false) => void`: Steps the value down, by `largeStep` steps when `large` is set.
+   * - `stepUp(count: number | boolean = 1) => void`: Steps the value up by `step`, `count` times, as the native method and
+   * `Input.stepUp` do. `true` takes `largeStep` steps, as `PageUp` does.
+   * - `stepDown(count: number | boolean = 1) => void`: Steps the value down by `step`, `count` times. `true` takes `largeStep`
+   * steps, as `PageDown` does.
    *
    * The same path a press of the down arrow takes, so a consumer driving this
    * from their own control gets the clamping and the announcement rather than
@@ -90838,6 +91177,15 @@ export type CustomElementsSolidJs = {
    * `servePreview` does. It defines no element, so an example that uses Helix
    * components needs a `src` that imports them.
    *
+   * **`imports` lets an example import packages by name** in the built-in
+   * document, as an import map: each name maps to the address of an ES module,
+   * such as `{"canvas-confetti": "https://esm.sh/canvas-confetti@1.9.3"}`, and
+   * `import confetti from 'canvas-confetti'` in the `js` pane then loads it. A
+   * CDN that serves npm packages as modules, such as esm.sh or jsDelivr's
+   * `+esm`, gives every package an address. A new map loads the document again,
+   * since a browser reads one only as a document starts. A `src` document
+   * declares its own.
+   *
    * **Examples render in a frame**, so an example's styles and scripts do not
    * affect the page around the sandbox, and `position: fixed` stays inside the
    * pane. The frame starts empty, with its own stylesheets and its own custom
@@ -90890,6 +91238,10 @@ export type CustomElementsSolidJs = {
    * it, here or anywhere: a frame is a document of its own and what is written
    * on this host reaches nothing inside it, which is the same reason
    * `colorMode` has to be sent rather than set.
+   * - `imports`: The packages an example can import by name in the built-in document,
+   * each mapped to the address of an ES module, as an import map's `imports`.
+   * Set it as JSON in the attribute or as an object. Not read where `src` is
+   * set.
    * - `label`: The frame's name, read by screen readers.
    * - `layout`: How the example is placed in the frame.
    *
@@ -91213,6 +91565,18 @@ export type CustomElementsSolidJs = {
    * that throws leaves the source drawn plain and the field editable, and the
    * error is reported to the page as an uncaught one.
    *
+   * **`line-numbers` numbers each line** in a gutter beside the source. A line
+   * that wraps keeps one number. The numbers are drawn, and hidden from screen
+   * readers, which read the field.
+   *
+   * Enter keeps the indentation of the line it breaks, and the new line is
+   * undone with the next undo as typing is.
+   *
+   * **The source can be written inside the pane** where `value` is not set: its
+   * text, or the markup of a `<template>` it holds, without the indentation the
+   * page gave it. Markup goes in a template so the page does not render it or
+   * run its scripts. Text inside the pane is read once, when it connects.
+   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -91224,6 +91588,7 @@ export type CustomElementsSolidJs = {
    * - `keys-description`/`keysDescription`: The field's description, read by screen readers while Tab indents.
    * - `label`: The pane's file name, such as `index.html`, on its tab where a sandbox
    * holds several panes. Empty puts the pane's `name` on the tab.
+   * - `line-numbers`/`lineNumbers`: Whether each line of the source is numbered, in a gutter beside it.
    * - `name`: Which source this pane holds. Every `helix-before-edit` event includes it.
    *
    * `html` and `css` are what the sandbox root routes on; any other name is
@@ -91282,6 +91647,7 @@ export type CustomElementsSolidJs = {
    * - `--sandbox-source-constant-color`: Color of a `constant` run, under `tokenize`. Defaults to `--helix-color-syntax-constant`.
    * - `--sandbox-source-invalid-color`: Color of an `invalid` run, under `tokenize`. Defaults to `--helix-color-syntax-invalid`.
    * - `--sandbox-source-keyword-color`: Color of a `keyword` run, under `tokenize`. Defaults to `--helix-color-syntax-keyword`.
+   * - `--sandbox-source-line-number-color`: Color of the line numbers, under `line-numbers`. Defaults to `--helix-color-foreground-subtle`.
    * - `--sandbox-source-min-block-size`: Minimum height of the pane.
    * - `--sandbox-source-name-color`: Color of a `name` run, under `tokenize`. Defaults to `--helix-color-syntax-name`.
    * - `--sandbox-source-string-color`: Color of a `string` run, under `tokenize`. Defaults to `--helix-color-syntax-string`.
@@ -91291,8 +91657,9 @@ export type CustomElementsSolidJs = {
    *
    * Custom selectors for styling elements within the component.
    *
-   * - `field`: The box that scrolls the field and its colors together, under `tokenize`.
-   * - `highlight`: The colored copy of the source drawn under the field, under `tokenize`.
+   * - `field`: The box that scrolls the field and its colors together, under `tokenize` or `line-numbers`.
+   * - `highlight`: The colored copy of the source drawn under the field, under `tokenize` or `line-numbers`.
+   * - `line`: One line of that copy, under `line-numbers`, numbered in the gutter by its `::before`.
    * - `source`: The editable region.
    * - `token`: One run of the source that has a kind, under `tokenize`.
    *
@@ -93884,7 +94251,8 @@ export type CustomElementsSolidJs = {
    *
    * Ignored once `active` is written.
    * - `arrows`: Whether the arrow keys move focus between the stages' names, along the
-   * way the steps run. Off by default, so the arrows keep scrolling the page.
+   * way the steps run, and the names are one tab stop. Off by default, so the
+   * arrows keep scrolling the page.
    * - `completion`: What marks a stage `complete`.
    *
    * Absent, you do: each step's `complete` is yours, because a reader who
@@ -94044,7 +94412,9 @@ export type CustomElementsSolidJs = {
    * - `disabled`: Whether the stage is disabled, so the user cannot go to it.
    * - `optional`: Whether a reader may pass the stage without finishing it, in a sequence
    * with `linear`. Ark UI's skippable step.
-   * - `value`: The value the step sends in `helix-select`.
+   * - `value`: The value the step sends in `helix-select`, and what names the step in its
+   * sequence's `active`. Without one, the sequence names the step by its place,
+   * counted from 1.
    * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
    *
    * **Named `whenSettled` because `settled` is taken four times over**, by
@@ -101874,6 +102244,8 @@ export type CustomCssProperties = {
   "--sandbox-source-invalid-color"?: (string) | undefined;
   /** Color of a `keyword` run, under `tokenize`. Defaults to `--helix-color-syntax-keyword`. */
   "--sandbox-source-keyword-color"?: (string) | undefined;
+  /** Color of the line numbers, under `line-numbers`. Defaults to `--helix-color-foreground-subtle`. */
+  "--sandbox-source-line-number-color"?: (string) | undefined;
   /** Minimum height of the pane. */
   "--sandbox-source-min-block-size"?: (string) | undefined;
   /** Color of a `name` run, under `tokenize`. Defaults to `--helix-color-syntax-name`. */