@fusion.dev/helix-headless 0.228.0 → 0.229.1

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

@@ -9,7 +9,7 @@ declare const HelixHeadlessTimePicker_base: (new (...args: any[]) => import("@fu
  * @description
  * Shows the times at each `step` as a `Listbox`, which provides the keyboard
  * behavior, typeahead, scrolling into view, and announcements for a set of
- * options. `variant="wheels"` shows a column each for the hour, the minute, and
+ * options. `picker="wheels"` shows a column each for the hour, the minute, and
  * the meridiem, and one for the second with `seconds`. Left and Right move
  * between the wheels, and Tab does too.
  *
@@ -257,7 +257,7 @@ export declare class HelixHeadlessTimePicker extends HelixHeadlessTimePicker_bas
      * separate "from" and "to" control, is two answers to what a product asks as
      * one, and it makes the between part impossible to show.
      *
-     * **Neither works on wheels and the variant falls back.** A range on
+     * **Neither works on wheels and the picker falls back.** A range on
      * wheels is two sets of wheels, which is two controls; a multiple is a set,
      * and a wheel has exactly one value by construction. Rather than draw
      * something that cannot say what it holds, `wheels` renders as a list
@@ -269,16 +269,39 @@ export declare class HelixHeadlessTimePicker extends HelixHeadlessTimePicker_bas
      * `show-now`.
      */
     nowLabel: string;
+    /**
+     * Shows the times as one `list`, or as `wheels` with a column for each part
+     * of the time.
+     *
+     * `list` is the default and offers whole times, which is what a product with
+     * opening hours or slots actually has. `wheels` splits them into an hour, a
+     * minute and, where the locale uses one, a meridiem: three short columns
+     * instead of ninety-six rows, and the only way to reach `23:45` without
+     * scrolling most of a day.
+     *
+     * The trade is that a wheel cannot say which *combinations* are on offer. A
+     * list of half hours from nine to five is seventeen rows and every one of them
+     * is a time the product has; the same thing as columns is an hour column and a
+     * minute column, and nothing in either says the two are only valid together.
+     * The bounds are still enforced, so a reader can be refused after the fact,
+     * which is worse than not being offered it.
+     *
+     * So: `list` where the set is the point, `wheels` where any time is allowed
+     * and the range is a whole day.
+     *
+     * **Optional rather than defaulted, which is not a style preference.** A
+     * reflecting property with a default writes its attribute onto every host the
+     * moment the element upgrades, including the ones a consumer rendered and did
+     * not touch, and React reads that as a hydration mismatch. The absent
+     * attribute *is* the list, which the stylesheet reads as the base rule, so
+     * only the departure has to be named.
+     */
+    picker?: 'list' | 'wheels';
     /**
      * The validation message for a time after `max`. `{max}` is replaced with
      * `max`, written in `locale`.
      */
     rangeOverflowMessage: string;
-    /**
-     * The validation message for a time before `min`. `{min}` is replaced with
-     * `min`, written in `locale`.
-     */
-    rangeUnderflowMessage: string;
     /**
      * Every time on offer, as seconds since midnight.
      *
@@ -428,6 +451,13 @@ export declare class HelixHeadlessTimePicker extends HelixHeadlessTimePicker_bas
      * rather than wrong, which is why it can be left in.
      */
     reveal(): void;
+    /**
+     * The validation message for a time before `min`. `{min}` is replaced with
+     * `min`, written in `locale`.
+     */
+    rangeUnderflowMessage: string;
+    /** Refuses every change while read-only. See `readOnly`. */
+    requestValue(next: string): boolean;
     /**
      * Blocks changes to the time. The value is still submitted with the form.
      *
@@ -442,8 +472,6 @@ export declare class HelixHeadlessTimePicker extends HelixHeadlessTimePicker_bas
      * else set needs.
      */
     readOnly: boolean;
-    /** Refuses every change while read-only. See `readOnly`. */
-    requestValue(next: string): boolean;
     /**
      * Stops the form from submitting while no time is chosen.
      */
@@ -506,10 +534,6 @@ export declare class HelixHeadlessTimePicker extends HelixHeadlessTimePicker_bas
      * The validation message for a time that `disable-times` bars.
      */
     unavailableMessage: string;
-    /**
-     * The validation message for a required time picker with no time chosen.
-     */
-    valueMissingMessage: string;
     /**
      * What is wrong with a time the picker can read, as a validity flag and a
      * message, or nothing.
@@ -520,33 +544,9 @@ export declare class HelixHeadlessTimePicker extends HelixHeadlessTimePicker_bas
      */
     private fault;
     /**
-     * Shows the times as one `list`, or as `wheels` with a column for each part
-     * of the time.
-     *
-     * `list` is the default and offers whole times, which is what a product with
-     * opening hours or slots actually has. `wheels` splits them into an hour, a
-     * minute and, where the locale uses one, a meridiem: three short columns
-     * instead of ninety-six rows, and the only way to reach `23:45` without
-     * scrolling most of a day.
-     *
-     * The trade is that a wheel cannot say which *combinations* are on offer. A
-     * list of half hours from nine to five is seventeen rows and every one of them
-     * is a time the product has; the same thing as columns is an hour column and a
-     * minute column, and nothing in either says the two are only valid together.
-     * The bounds are still enforced, so a reader can be refused after the fact,
-     * which is worse than not being offered it.
-     *
-     * So: `list` where the set is the point, `wheels` where any time is allowed
-     * and the range is a whole day.
-     *
-     * **Optional rather than defaulted, which is not a style preference.** A
-     * reflecting property with a default writes its attribute onto every host the
-     * moment the element upgrades, including the ones a consumer rendered and did
-     * not touch, and React reads that as a hydration mismatch. The absent
-     * attribute *is* the list, which the stylesheet reads as the base rule, so
-     * only the departure has to be named.
+     * The validation message for a required time picker with no time chosen.
      */
-    variant?: 'list' | 'wheels';
+    valueMissingMessage: string;
     /**
      * Reports "required and empty", or clears it.
      *
@@ -679,7 +679,7 @@ export declare class HelixHeadlessTimePicker extends HelixHeadlessTimePicker_bas
     private readonly handleColumnsKeydown;
     private renderSpinner;
     /**
-     * The flat list of times, for the variant that is not wheels, behind a seam the styled tier can move.
+     * The flat list of times, for the picker that is not wheels, behind a seam the styled tier can move.
      *
      * A method rather than a fragment inline, so a tier above can render its own,
      * wrap this one, pass it a property the base does not know about, or leave it

package/dist/time-picker/root/time-picker-root.js

@@ -21,7 +21,6 @@ let HelixHeadlessTimePicker = class HelixHeadlessTimePicker extends MixinPickerF
         this.min = '00:00';
         this.nowLabel = 'Now';
         this.rangeOverflowMessage = 'Choose a time at or before {max}.';
-        this.rangeUnderflowMessage = 'Choose a time at or after {min}.';
         this.handleListInput = (event) => {
             event.stopPropagation();
         };
@@ -75,6 +74,7 @@ let HelixHeadlessTimePicker = class HelixHeadlessTimePicker extends MixinPickerF
             }
             this.requestValue(this.valueFor(nearest));
         };
+        this.rangeUnderflowMessage = 'Choose a time at or after {min}.';
         this.readOnly = false;
         this.required = false;
         this.seconds = false;
@@ -235,7 +235,7 @@ let HelixHeadlessTimePicker = class HelixHeadlessTimePicker extends MixinPickerF
         if (this.mode !== undefined) {
             return;
         }
-        if (this.variant !== 'wheels') {
+        if (this.picker !== 'wheels') {
             this.highlightNearest();
             this.partNamed('list')?.reveal?.();
             return;
@@ -385,7 +385,7 @@ let HelixHeadlessTimePicker = class HelixHeadlessTimePicker extends MixinPickerF
     updated(changed) {
         super.updated(changed);
         this.reportRequired();
-        if (this.variant === 'wheels') {
+        if (this.picker === 'wheels') {
             this.reveal();
             void this.revealWhenSettled();
         }
@@ -499,7 +499,7 @@ let HelixHeadlessTimePicker = class HelixHeadlessTimePicker extends MixinPickerF
     </${this.tag('listbox')}>`;
     }
     render() {
-        if (this.variant === 'wheels' && this.mode === undefined) {
+        if (this.picker === 'wheels' && this.mode === undefined) {
             return html `${this.renderSlottedLabel()}${this.renderSpinner()}${this.renderNow()}${this.renderHint()}${this.renderPickerFeedback()}`;
         }
         return html `${this.renderSlottedLabel()}${this.renderList()}${this.renderNow()}${this.renderHint()}${this.renderPickerFeedback()}`;
@@ -573,17 +573,20 @@ __decorate([
     words,
     property({ attribute: 'now-label' })
 ], HelixHeadlessTimePicker.prototype, "nowLabel", void 0);
+__decorate([
+    property({ reflect: true })
+], HelixHeadlessTimePicker.prototype, "picker", void 0);
 __decorate([
     words,
     property({ attribute: 'range-overflow-message' })
 ], HelixHeadlessTimePicker.prototype, "rangeOverflowMessage", void 0);
+__decorate([
+    state()
+], HelixHeadlessTimePicker.prototype, "previewed", void 0);
 __decorate([
     words,
     property({ attribute: 'range-underflow-message' })
 ], HelixHeadlessTimePicker.prototype, "rangeUnderflowMessage", void 0);
-__decorate([
-    state()
-], HelixHeadlessTimePicker.prototype, "previewed", void 0);
 __decorate([
     property({ attribute: 'readonly', reflect: true, type: Boolean })
 ], HelixHeadlessTimePicker.prototype, "readOnly", void 0);
@@ -617,9 +620,6 @@ __decorate([
     words,
     property({ attribute: 'value-missing-message' })
 ], HelixHeadlessTimePicker.prototype, "valueMissingMessage", void 0);
-__decorate([
-    property({ reflect: true })
-], HelixHeadlessTimePicker.prototype, "variant", void 0);
 __decorate([
     state()
 ], HelixHeadlessTimePicker.prototype, "hintSlotted", void 0);