@fusion.dev/helix-headless 0.105.0 → 0.106.0

package/dist/tabs/root/tabs-root.d.ts

@@ -5,15 +5,16 @@ declare const HelixHeadlessTabs_base: (new (...args: any[]) => import("@fusion.d
  * @summary A row of tabs and the panel each one shows.
  *
  * @description
- * Selection is coordinated by event, the same shape the accordion and the tree
- * use: a tab dispatches `helix-select` and the root pairs it with the panel of
- * the same value. Nothing registers with anything, so tabs added later work
- * without the root being told.
+ * Selection works through an event, the same as in the accordion and the tree.
+ * A tab dispatches `helix-select`, and the root pairs it with the panel of the
+ * same value. Nothing registers with anything, so tabs added later work with no
+ * extra setup.
  *
- * The tab list is a single tab stop, moved with the arrow keys through
- * `KeyboardNavigationController`, the same one the radio and toggle groups use.
- * Selection follows focus, which is the right default for a small set where
- * showing a panel is cheap; a set where it is not should use `manual`.
+ * The tab list is a single tab stop, and the arrow keys move between tabs
+ * through `KeyboardNavigationController`, the same as in the radio and toggle
+ * groups. Selection follows focus, which suits a small set where showing a
+ * panel is cheap. Set `manual` when showing a panel is expensive, so focus can
+ * move without selecting.
  *
  * @since 0.1.0
  * @status stable
@@ -21,14 +22,14 @@ declare const HelixHeadlessTabs_base: (new (...args: any[]) => import("@fusion.d
  * @aliases TabList, Segmented control
  * @documentation https://fusion.dev/helix/components/tabs
  *
- * @slot - The tabs, which are this element's own children.
- * @slot panels - The panels, which are this element's own children. A wrapper around them is assigned to the slot and pairs with nothing, since the pairing walks these children rather than the slot's tree.
+ * @slot - The tabs, as direct children of this element.
+ * @slot panels - The panels, as direct children of this element. Panels inside a wrapper are not paired with tabs, because pairing reads only the direct children.
  *
- * @event {HelixActivateEvent} helix-activate - Fired once the current one has moved, so the element already holds it.
- * @event {HelixBeforeActivateEvent} helix-before-activate - Fired before the current tab moves, and cancelable. The only way to refuse one.
- * @event {HelixSelectEvent} helix-select - Fired when a tab is chosen. Dispatched by the tab and listened for here, because the root is what a consumer holds. Cancelable: refusing it takes the decision and nothing moves.
+ * @event {HelixActivateEvent} helix-activate - Fired after the active tab changes, so the element already holds the new value.
+ * @event {HelixBeforeActivateEvent} helix-before-activate - Fired before the active tab changes, and cancelable. Canceling it is the only way to block a change.
+ * @event {HelixSelectEvent} helix-select - Fired when a tab is chosen. The tab sends it and the root handles it, so you can listen on the root. Cancelable: canceling it stops the change and leaves the decision to you.
  *
- * @csspart indicator - The mark that travels to the selected tab.
+ * @csspart indicator - The marker that moves to the selected tab.
  * @csspart panels - The panel container.
  * @csspart tabs - The tab list.
  */
@@ -36,11 +37,12 @@ export declare class HelixHeadlessTabs extends HelixHeadlessTabs_base {
     protected readonly keys: KeyboardNavigationController;
     private readonly indicator;
     /**
-     * Accessible name for the tab list.
+     * The tab list's name, read by screen readers.
      */
     label: string;
     /**
-     * Whether arrowing to a tab also selects it.
+     * Stops the arrow keys from selecting each tab they move to. By default,
+     * arrowing to a tab also selects it.
      *
      * Automatic is the default because showing a panel is usually cheap. Set this
      * where it is not, so a reader arrowing past four tabs does not load four
@@ -48,7 +50,7 @@ export declare class HelixHeadlessTabs extends HelixHeadlessTabs_base {
      */
     manual: boolean;
     /**
-     * How the row reads.
+     * How the row of tabs is drawn.
      *
      * Unset is a raised pill on the selected tab with nothing behind the row,
      * which is what a set sitting inside other chrome wants. `underlined` is a

package/dist/tabs/tab/tab.d.ts

@@ -5,12 +5,12 @@ declare const HelixHeadlessTab_base: (new (...args: any[]) => import("@fusion.de
  * @summary One tab in a tab list.
  *
  * @description
- * An element rather than a slot because it owns selection and its own tab stop.
+ * A tab is an element, because it manages selection and its own tab stop.
  *
- * Its id and the id it controls are both derived from `value`, so the pairing
- * between a tab and its panel survives server rendering. A generated id would
- * differ between the server's render and the client's and break the link, and
- * `aria-controls` pointing at nothing is worse than not being there.
+ * Its id and the id it controls both come from `value`, so the link between a
+ * tab and its panel works with server rendering. A generated id would differ
+ * between the server render and the client render, and `aria-controls` would
+ * point at nothing.
  *
  * @since 0.1.0
  * @status stable
@@ -19,7 +19,7 @@ declare const HelixHeadlessTab_base: (new (...args: any[]) => import("@fusion.de
  *
  * @slot - The tab's label.
  *
- * @event {HelixSelectEvent} helix-select - Fired when the tab is chosen. Cancelable: refusing it takes the decision and nothing moves.
+ * @event {HelixSelectEvent} helix-select - Fired when the tab is chosen. Cancelable: canceling it stops the change and leaves the decision to you.
  *
  * @csspart tab - The tab itself.
  *

package/dist/tag/root/tag-root.d.ts

@@ -2,17 +2,16 @@ import { HelixElement } from '@fusion.dev/helix-core';
 import { type TemplateResult } from 'lit';
 declare const HelixHeadlessTag_base: (new (...args: any[]) => import("@fusion.dev/helix-core").DismissibleElement) & typeof HelixElement;
 /**
- * @summary Labels content with a short piece of metadata.
+ * @summary A short label that adds metadata to content.
  *
  * @description
- * A tag is a label, and optionally a label the reader can take off.
- * `dismissible` is what separates it from a badge: a badge reports a state the
- * reader cannot change, a tag names something they can.
+ * A label that people can optionally remove. `dismissible` is the difference
+ * from a badge: a badge shows a state that people cannot change, and a tag
+ * names something they can remove.
  *
- * Dismissing is a request. The tag does not remove itself, because the consumer
- * owns the list it sits in and taking the node out from under them would put
- * their state and the document out of step. Canceling `helix-dismiss` is a
- * refusal.
+ * The remove button sends `helix-dismiss`. The tag does not remove itself,
+ * because your code owns the list it is in, so remove it in your handler. A
+ * listener can cancel `helix-dismiss`, and `dismiss()` then returns `false`.
  *
  * @since 0.1.0
  * @status stable
@@ -21,12 +20,12 @@ declare const HelixHeadlessTag_base: (new (...args: any[]) => import("@fusion.de
  * @documentation https://fusion.dev/helix/components/tag
  *
  * @slot - The tag's label.
- * @slot start - A category the label belongs to, set before it and weightier.
+ * @slot start - The category the label belongs to, shown before it in a heavier weight.
  *
- * @event {HelixDismissEvent} helix-dismiss - Fired when the reader asks to remove the tag. Cancelable: refusing it takes the decision and nothing moves.
+ * @event {HelixDismissEvent} helix-dismiss - The remove button was pressed. The tag does not remove itself, so remove it in response. Cancelable.
  *
- * @csspart dismiss - The control that asks to remove the tag.
- * @csspart dismiss-mark - The glyph on the dismiss control, where none is slotted.
+ * @csspart dismiss - The button that removes the tag.
+ * @csspart dismiss-mark - The icon on the remove button.
  * @csspart start - The category before the label.
  */
 export declare class HelixHeadlessTag extends HelixHeadlessTag_base {

package/dist/textarea/root/textarea-root.d.ts

@@ -2,23 +2,18 @@ import { AriaForwardController, HelixFormElement } from '@fusion.dev/helix-core'
 import { type PropertyValues, type TemplateResult } from 'lit';
 declare const HelixHeadlessTextarea_base: (new (...args: any[]) => import("@fusion.dev/helix-core").MixinControllerValueInterface) & (new (...args: any[]) => import("@fusion.dev/helix-core").MixinFieldInterface) & typeof HelixFormElement;
 /**
- * @summary Several lines of text a reader types into.
+ * @summary A multi-line text field.
  *
  * @description
- * A real `<textarea>`, so the caret, the selection, spellcheck, the resize
- * handle and the keyboard a phone chooses are all the platform's, and it
- * serializes into the server's markup so the field is usable before any script
- * loads.
+ * Renders a `<textarea>`, so the caret, selection, spellcheck, resize handle,
+ * and phone keyboard come from the platform. It is in the server markup, so the
+ * field works before any script loads.
  *
- * **Not an Input with a taller box.** The difference is the Enter key: in a
- * single-line field it submits the form, and here it inserts a line. That is a
- * behavioral difference the platform owns and cannot be styled into existence,
- * which is why this is its own element rather than `Input` with a property.
+ * It is a separate element from `Input` because Enter inserts a line break
+ * here. In a single-line field, Enter submits the form.
  *
- * `rows` sets the height it starts at, and `auto-grow` lets it follow its own
- * content. They are not alternatives: `rows` is where an empty field begins and
- * `auto-grow` is what happens after, so a field that grows still has to start
- * somewhere.
+ * `rows` sets the starting height, and `auto-grow` makes the field grow with
+ * its content. You can use both: `rows` sets where an empty field begins.
  *
  * @since 0.1.0
  * @status stable
@@ -26,35 +21,37 @@ declare const HelixHeadlessTextarea_base: (new (...args: any[]) => import("@fusi
  * @aliases Multiline, TextArea
  * @documentation https://fusion.dev/helix/components/textarea
  *
- * @event {Event} change - Relayed from the textarea once the reader has finished.
+ * @event {Event} change - Sent from the textarea when the user finishes an edit.
  * @event {HelixBeforeChangeEvent} helix-before-change - Fired as the text changes, and cancelable.
- * @event {Event} input - Announced once the value has moved.
+ * @event {Event} input - Fired after the value changes.
  *
  * @csspart control - The textarea itself.
- * @csspart feedback - What is wrong with it.
- * @csspart field - The box holding the control.
+ * @csspart feedback - The message that says what is wrong.
+ * @csspart field - The box that holds the textarea.
  * @csspart hint - Help under the field, while nothing is wrong.
- * @csspart label - The question, over the field.
+ * @csspart label - The label above the field.
  *
- * @cssstate invalid - While there is feedback to show: the platform's verdict, or the consumer's `feedback`.
+ * @cssstate invalid - The control has an error to show, from the browser's validation or from your `feedback`.
  */
 export declare class HelixHeadlessTextarea extends HelixHeadlessTextarea_base {
     protected readonly aria: AriaForwardController;
     /** Typed or dragged, so every edit is announced. See `announcesInput`. */
     protected readonly announcesInput = true;
     /**
-     * What the browser may autofill here, as one of the platform's own tokens.
+     * What the browser can autofill in the field, as a standard `autocomplete`
+     * token.
      *
      * Empty leaves the attribute off, which is the browser's default. Set it to
      * a token like `email` or `bday` to ask for autofill, or to `off` to refuse.
      */
     autocomplete: string;
     /**
-     * Whether the box follows its own content rather than scrolling.
+     * Grows the box to fit its content, so it does not scroll.
      */
     autoGrow: boolean;
     /**
-     * How many characters wide the box is, where the layout is not deciding.
+     * How many characters wide the box is, when the layout does not set its
+     * width.
      *
      * Optional and absent by default, which is the reflected-property rule: a
      * `<textarea>` left alone is 20 columns wide and a styled one is whatever its
@@ -64,7 +61,7 @@ export declare class HelixHeadlessTextarea extends HelixHeadlessTextarea_base {
      */
     cols?: number;
     /**
-     * The name a second entry carries, holding which way the text runs.
+     * The name of a second form entry that submits the direction of the text.
      *
      * **Submitted through `setFormValue`, because the inner control's own
      * `dirname` cannot reach the form.** This host is form-associated and reports
@@ -75,11 +72,11 @@ export declare class HelixHeadlessTextarea extends HelixHeadlessTextarea_base {
      */
     dirName: string;
     /**
-     * Most characters the value may have.
+     * The most characters the value can have.
      */
     maxLength?: number;
     /**
-     * Fewest characters the value may have.
+     * The fewest characters the value can have.
      *
      * Forwarded to the real `<textarea>` rather than checked here, which is what
      * makes the message the browser's and therefore the reader's own language.
@@ -88,13 +85,13 @@ export declare class HelixHeadlessTextarea extends HelixHeadlessTextarea_base {
      */
     minLength?: number;
     /**
-     * Shown while the field is empty.
+     * Text shown while the field is empty.
      *
      * Not a label: it goes when typing starts.
      */
     placeholder: string;
     /**
-     * Whether the field refuses input while still submitting its value.
+     * Blocks typing in the field. The value is still submitted with the form.
      */
     readOnly: boolean;
     /** Focus is delegated to the control, so the host is never the target. */
@@ -146,7 +143,7 @@ export declare class HelixHeadlessTextarea extends HelixHeadlessTextarea_base {
      */
     private formValue;
     /**
-     * The caret and the selection, under the platform's own names.
+     * The direction of the selection, as a native textarea reports it.
      *
      * **The whole reason this renders a real `<textarea>` is the caret**, and the
      * control is inside this shadow root, so `querySelector` does not find it and
@@ -167,8 +164,8 @@ export declare class HelixHeadlessTextarea extends HelixHeadlessTextarea_base {
     get selectionStart(): number;
     set selectionStart(at: number);
     /**
-     * Selects a range, which is the one operation the three accessors above
-     * cannot express between them.
+     * Selects a range of text, which the three selection properties cannot do
+     * between them.
      *
      * Setting `selectionStart` past the current `selectionEnd` drags the end
      * along, so the two writes a consumer would make in sequence do not compose
@@ -178,9 +175,9 @@ export declare class HelixHeadlessTextarea extends HelixHeadlessTextarea_base {
     setSelectionRange(start: number, end: number, direction?: SelectionDirection): void;
     /** How many characters the value holds. */
     get textLength(): number;
-    /** What kind of control this is, which for a textarea is always the one word. */
+    /** The control's type, which is always `textarea`. */
     get type(): string;
-    /** Puts the caret in the field, the way a label pointing at one would. */
+    /** Puts the caret in the field, as a label pointing at it would. */
     focus(options?: FocusOptions): void;
     /** Reports the value and the validity the host stands behind. */
     private sync;

package/dist/time-input/root/time-input-root.d.ts

@@ -5,25 +5,23 @@ import '../../tag/index.js';
 import '../../time-picker/index.js';
 declare const HelixHeadlessTimeInput_base: (new (...args: any[]) => import("@fusion.dev/helix-core").MixinPickerEditingInterface) & (new (...args: any[]) => import("@fusion.dev/helix-core").MixinPickerFieldInterface) & (new (...args: any[]) => import("@fusion.dev/helix-core").MixinControllerOpenInterface) & (new (...args: any[]) => import("@fusion.dev/helix-core").MixinTokensInterface) & (new (...args: any[]) => import("@fusion.dev/helix-core").MixinControllerValueInterface) & (new (...args: any[]) => import("@fusion.dev/helix-core").MixinFieldInterface) & typeof HelixFormElement;
 /**
- * @summary A time, typed or picked from a list.
+ * @summary A field for a time, typed or picked from a list.
  *
  * @description
- * **The list is `TimePicker`, not a second one written here.** It is worth
- * having on its own, flat in a settings pane with nothing to open, and this
- * element is the field, the overlay and the form. Exactly the arrangement Input
- * Date has with `DatePicker` and Color Input with `ColorPicker`.
+ * The list is a `TimePicker`, which you can also use on its own, for example in
+ * a settings pane. This element adds the field, the overlay, and the form
+ * association, the same arrangement Date Input has with `DatePicker` and Color
+ * Input has with `ColorPicker`.
  *
- * **Typed as well as picked, and that is the division the list depends on.** A
- * list at a step offers the times a product actually has, and the field is how a
- * reader says `09:07`. Neither is a worse version of the other: without the
- * field a step is a cage, and without the list every common time is typed out.
+ * You can type a time or pick one. The list offers times at a step, and the
+ * field lets you enter any time, such as `09:07`.
  *
- * **The value is `HH:mm` on a twenty-four hour clock, always**, because that is
- * what a form submits, what `min` and `max` compare against, and what sorts as a
- * string. What the field *shows* is the reader's own convention while it is
- * idle, and the value itself once the caret is in it: the same separation Input
- * Date draws, and for the same reason, which is that `2:30 PM` cannot be typed
- * back and `Intl` has no parser to make it so.
+ * The value is always `HH:mm` on a 24-hour clock, because that is what the form
+ * submits, what `min` and `max` compare against, and what sorts correctly as a
+ * string. While idle, the field shows the time in the user's locale format.
+ * Once the caret is in the field, it shows the value itself, because a
+ * formatted time such as `2:30 PM` cannot be typed back and `Intl` has no
+ * parser for it.
  *
  * @since 0.1.0
  * @status stable
@@ -31,67 +29,67 @@ declare const HelixHeadlessTimeInput_base: (new (...args: any[]) => import("@fus
  * @aliases TimeField, InputTime
  * @documentation https://fusion.dev/helix/components/time-input
  *
- * @slot feedback - What is wrong with it.
+ * @slot feedback - The message that says what is wrong with the value.
  * @slot hint - Help under the field.
- * @slot trigger - The mark on the field saying a list opens.
+ * @slot trigger - The icon on the field that shows a list opens.
  *
- * @event {Event} change - Announced once the value has moved.
- * @event {HelixBeforeChangeEvent} helix-before-change - Fired before the time changes. Cancelable: refusing it takes the decision and nothing moves.
- * @event {HelixBeforeCloseEvent} helix-before-close - Fired before it closes. Cancelable: refusing it takes the decision and nothing moves.
- * @event {HelixBeforeOpenEvent} helix-before-open - Fired before the list opens. Cancelable: refusing it takes the decision and nothing moves.
- * @event {Event} input - Announced once the value has moved.
- * @event {Event} toggle - Says the state moved, carrying `newState` and `oldState`.
+ * @event {Event} change - Fired after the value changes.
+ * @event {HelixBeforeChangeEvent} helix-before-change - Fired before the time changes. Cancelable: canceling it stops the change and leaves the decision to you.
+ * @event {HelixBeforeCloseEvent} helix-before-close - Fired before the list closes. Cancelable: canceling it keeps the list open and leaves the decision to you.
+ * @event {HelixBeforeOpenEvent} helix-before-open - Fired before the list opens. Cancelable: canceling it keeps the list closed and leaves the decision to you.
+ * @event {Event} input - Fired after the value changes.
+ * @event {Event} toggle - Fired after the list opens or closes, with `newState` and `oldState`.
  *
  * @csspart control - The text input.
- * @csspart feedback - What is wrong with it.
- * @csspart field - The box holding the text and the trigger.
+ * @csspart feedback - The message that says what is wrong with the value.
+ * @csspart field - The box that holds the text and the trigger.
  * @csspart hint - Help under the field, while nothing is wrong.
- * @csspart label - The question, over the field.
- * @csspart picker - The list inside it.
- * @csspart picker-column - One of them.
- * @csspart picker-column-empty - Shown when a filter has hidden everything.
- * @csspart picker-column-feedback - What is wrong with it.
- * @csspart picker-column-filter-icon - The mark beside that field.
- * @csspart picker-column-filter-mark - The glyph beside the filter field, where none is slotted.
+ * @csspart label - The label above the field.
+ * @csspart picker - The time picker inside the panel.
+ * @csspart picker-column - One column of the picker.
+ * @csspart picker-column-empty - The text shown when the filter hides every option.
+ * @csspart picker-column-feedback - The column's message that says what is wrong with the value.
+ * @csspart picker-column-filter-icon - The icon beside the filter field.
+ * @csspart picker-column-filter-mark - The default icon beside the filter field, shown when none is slotted.
  * @csspart picker-column-hint - Help under the list.
- * @csspart picker-column-items - The list itself.
- * @csspart picker-column-label - The question, over the list.
- * @csspart picker-column-live - The inner column's `live`, the region a screen reader hears its empty and loading lines from.
- * @csspart picker-column-loading - Shown while the options are still on their way.
- * @csspart picker-column-search - The region holding the field that narrows the list.
- * @csspart picker-column-search-field - The field itself.
+ * @csspart picker-column-items - The list of options.
+ * @csspart picker-column-label - The label above the list.
+ * @csspart picker-column-live - The inner column's `live` part, the region screen readers announce its empty and loading text from.
+ * @csspart picker-column-loading - The text shown while the options load.
+ * @csspart picker-column-search - The region that holds the filter field.
+ * @csspart picker-column-search-field - The filter field.
  * @csspart picker-columns - The row of columns, in `wheels`.
  * @csspart picker-list - The listbox holding the times, in `list`.
- * @csspart picker-list-empty - Shown when a filter has hidden everything.
- * @csspart picker-list-feedback - What is wrong with it.
- * @csspart picker-list-filter-icon - The mark beside that field.
- * @csspart picker-list-filter-mark - The glyph beside the filter field, where none is slotted.
+ * @csspart picker-list-empty - The text shown when the filter hides every option.
+ * @csspart picker-list-feedback - The inner list's message that says what is wrong with the value.
+ * @csspart picker-list-filter-icon - The icon beside the filter field.
+ * @csspart picker-list-filter-mark - The default icon beside the filter field, shown when none is slotted.
  * @csspart picker-list-hint - Help under the list.
- * @csspart picker-list-items - The list itself.
- * @csspart picker-list-label - The question, over the list.
- * @csspart picker-list-live - The inner list's `live`, the region a screen reader hears its empty and loading lines from.
- * @csspart picker-list-loading - Shown while the options are still on their way.
- * @csspart picker-list-search - The region holding the field that narrows the list.
- * @csspart picker-list-search-field - The field itself.
- * @csspart picker-option - One time in it. Carries `data-between` inside a range.
- * @csspart picker-option-between - A time inside a chosen range, short of either end, beside `picker-option`.
- * @csspart picker-option-description - The caption under the words, when there is one.
+ * @csspart picker-list-items - The list of options.
+ * @csspart picker-list-label - The label above the list.
+ * @csspart picker-list-live - The inner list's `live` part, the region screen readers announce its empty and loading text from.
+ * @csspart picker-list-loading - The text shown while the options load.
+ * @csspart picker-list-search - The region that holds the filter field.
+ * @csspart picker-list-search-field - The filter field.
+ * @csspart picker-option - One time in the picker. Carries `data-between` inside a range.
+ * @csspart picker-option-between - A time inside a chosen range, between its two ends. Set together with `picker-option`.
+ * @csspart picker-option-description - The caption under the label, when there is one.
  * @csspart picker-option-item - The row.
  * @csspart picker-option-item-active - The row the keyboard is on.
  * @csspart picker-option-item-selected - The row of a chosen time: the one time, or either end of a range.
- * @csspart picker-option-label - The words.
- * @csspart picker-option-text - The words and the caption, as one column.
- * @csspart rest - How many times are held beyond the ones shown. A `<button>` with `expandable`, a `<span>` without it.
+ * @csspart picker-option-label - The option's label.
+ * @csspart picker-option-text - The label and the caption, as one column.
+ * @csspart rest - The count of times held beyond the ones shown. A `<button>` with `expandable`, and a `<span>` without it.
  * @csspart surface - The floating panel.
  * @csspart tags - The row the times sit in.
  * @csspart time - One held time, as a tag, in `multiple`.
  * @csspart time-dismiss - The remove button, when `dismissible`.
- * @csspart time-dismiss-mark - The glyph on the dismiss control, where none is slotted.
+ * @csspart time-dismiss-mark - The default icon on the remove button, shown when none is slotted.
  * @csspart time-start - The category before the label.
  * @csspart trigger - The control that opens the list.
- * @csspart trigger-icon - The mark on the button that opens the clock.
+ * @csspart trigger-icon - The icon on the button that opens the clock.
  *
- * @cssstate invalid - While there is feedback to show: the platform's verdict, or the consumer's `feedback`.
+ * @cssstate invalid - The control has an error to show, from the browser's validation or from your `feedback`.
  * @cssstate open - While the clock is open.
  */
 export declare class HelixHeadlessTimeInput extends HelixHeadlessTimeInput_base {
@@ -118,7 +116,7 @@ export declare class HelixHeadlessTimeInput extends HelixHeadlessTimeInput_base
      */
     min: string;
     /**
-     * How many times can be held at once.
+     * How many times the field holds at once.
      *
      * Absent is one. `range` holds a start and an end, `multiple` holds any
      * number, and both are carried as one comma-separated value, which is what a
@@ -127,11 +125,11 @@ export declare class HelixHeadlessTimeInput extends HelixHeadlessTimeInput_base
      */
     mode?: 'multiple' | 'range';
     /**
-     * What the field says before a time is in it.
+     * Placeholder text shown before a time is entered.
      */
     placeholder: string;
     /**
-     * What a reader is told when a range holds more than two times.
+     * The message shown when a range holds more than two times.
      *
      * **Every sentence a control raises in the browser's bubble is a property**,
      * so a form in another language speaks it. Absent is the control's own
@@ -139,17 +137,17 @@ export declare class HelixHeadlessTimeInput extends HelixHeadlessTimeInput_base
      */
     rangeLengthMessage?: string;
     /**
-     * What a reader is told when a time is after `max`, with `{max}` filled in
-     * as the field writes it.
+     * The message shown when a time is after `max`, with `{max}` filled in as
+     * the field displays it.
      */
     rangeOverflowMessage?: string;
     /**
-     * What a reader is told when a time is before `min`, with `{min}` filled
-     * in as the field writes it.
+     * The message shown when a time is before `min`, with `{min}` filled in as
+     * the field displays it.
      */
     rangeUnderflowMessage?: string;
     /**
-     * What the control removing one time is called, with `{name}` filled in.
+     * The name of the button that removes one time, with `{name}` filled in.
      *
      * **The name goes in**, so a row of them is heard as which one each
      * removes rather than as "Remove" said once per time.
@@ -160,7 +158,8 @@ export declare class HelixHeadlessTimeInput extends HelixHeadlessTimeInput_base
      */
     step: number;
     /**
-     * Whether the field writes the time out, or holds the value as it is.
+     * Whether the field shows the time in the local style or as the value
+     * itself.
      *
      * `local` is the reader's own convention from `Intl`, which is what a time is
      * for reading; `iso` is `HH:mm`, which is what it is for typing. The field
@@ -169,7 +168,7 @@ export declare class HelixHeadlessTimeInput extends HelixHeadlessTimeInput_base
      */
     timeStyle: 'iso' | 'local';
     /**
-     * Accessible name for the control that opens the list.
+     * The name of the button that opens the list, read by screen readers.
      */
     triggerLabel: string;
     /** Every time in the value, which may hold more than one. */
@@ -209,7 +208,8 @@ export declare class HelixHeadlessTimeInput extends HelixHeadlessTimeInput_base
     /** What is wrong with the times, which the text input cannot say. */
     protected validate(): string;
     /**
-     * Whether the panel is one list of times or a column each.
+     * Whether the panel shows one list of times or a column for each part of the
+     * time.
      *
      * `list` offers whole times, which is what a product with slots or opening
      * hours has. `wheels` splits them into an hour, a minute and a meridiem where
@@ -259,7 +259,8 @@ export declare class HelixHeadlessTimeInput extends HelixHeadlessTimeInput_base
     protected renderTrigger(): TemplateResult;
     protected render(): TemplateResult;
     /**
-     * The value as a `Date` on 1 January 1970 UTC, or `null` while there is no time.
+     * The value as a `Date` on January 1, 1970 UTC, or `null` while there is no
+     * time.
      *
      * The platform's own pair on `<input type="time">`, epoch day included: a time
      * is an offset into a day rather than an instant, and putting it on the epoch