@fusion.dev/helix-core 0.142.1 → 0.144.0

package/dist/helix-form-element/helix-form-element.js

@@ -6,13 +6,55 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { property, state } from 'lit/decorators.js';
 import { HelixElement } from '../helix-element/helix-element.js';
-export class HelixFormElement extends HelixElement {
-    constructor() {
-        super(...arguments);
-        this.disabled = false;
-        this.formDisabled = false;
-        this.name = '';
+const VALIDITY_FLAGS = [
+    'badInput',
+    'customError',
+    'patternMismatch',
+    'rangeOverflow',
+    'rangeUnderflow',
+    'stepMismatch',
+    'tooLong',
+    'tooShort',
+    'typeMismatch',
+    'valueMissing',
+];
+const BLOCKING_TYPES = new Set([
+    'date',
+    'datetime-local',
+    'email',
+    'month',
+    'number',
+    'password',
+    'search',
+    'tel',
+    'text',
+    'time',
+    'url',
+    'week',
+]);
+const takesFocus = (element) => (element.tabIndex >= 0 || element.hasAttribute('tabindex')) &&
+    !element.disabled &&
+    (typeof element.checkVisibility !== 'function' || element.checkVisibility());
+const isTabStop = (element) => element instanceof HTMLElement &&
+    element.tabIndex >= 0 &&
+    !element.disabled &&
+    !element.hidden &&
+    !element.inert &&
+    (typeof element.checkVisibility !== 'function' || element.checkVisibility());
+const firstTabStop = (node) => {
+    const children = node instanceof HTMLSlotElement ? node.assignedElements({ flatten: true }) : [...node.children];
+    for (const child of children) {
+        if (isTabStop(child)) {
+            return child;
+        }
+        const found = (child.shadowRoot ? firstTabStop(child.shadowRoot) : null) ?? firstTabStop(child);
+        if (found) {
+            return found;
+        }
     }
+    return null;
+};
+export class HelixFormElement extends HelixElement {
     static { this.formAssociated = true; }
     get isDisabled() {
         return this.disabled || this.formDisabled;
@@ -20,10 +62,27 @@ export class HelixFormElement extends HelixElement {
     formDisabledCallback(disabled) {
         this.formDisabled = disabled && !this.disabled;
     }
+    get heldByFieldset() {
+        let fieldset = this.parentElement?.closest('fieldset[disabled]') ?? null;
+        while (fieldset) {
+            const legend = fieldset.querySelector(':scope > legend');
+            if (!legend?.contains(this)) {
+                return true;
+            }
+            fieldset = fieldset.parentElement?.closest('fieldset[disabled]') ?? null;
+        }
+        return false;
+    }
     formResetCallback() { }
     willUpdate(changed) {
         super.willUpdate(changed);
+        if (changed.get('disabled') === true && !this.disabled && this.isConnected) {
+            this.formDisabled = this.heldByFieldset;
+        }
         this.internals.ariaDisabled = this.isDisabled ? 'true' : null;
+        if (this.validityFeedback !== this.appliedFeedback) {
+            this.applyValidity();
+        }
     }
     announceInput() {
         this.dispatchEvent(new Event('input', { bubbles: true, composed: true }));
@@ -31,6 +90,157 @@ export class HelixFormElement extends HelixElement {
     announceChange() {
         this.dispatchEvent(new Event('change', { bubbles: true, composed: false }));
     }
+    constructor() {
+        super();
+        this.disabled = false;
+        this.formDisabled = false;
+        this.name = '';
+        this.reported = { anchor: undefined, flags: {}, message: '' };
+        this.customValidity = '';
+        this.appliedFeedback = '';
+        this.focusFromLabel = (event) => {
+            if (!event.isTrusted || event.composedPath()[0] !== this || this.isDisabled) {
+                return;
+            }
+            if (!this.matches(':focus-within')) {
+                this.focus();
+            }
+        };
+        this.refreshAnchor = () => {
+            if (!this.internals.validity.valid) {
+                this.applyValidity();
+            }
+        };
+        const internals = this.internals;
+        const report = internals.setValidity.bind(internals);
+        this.reportValidityTo = report;
+        internals.setValidity = (flags, message, anchor) => {
+            this.reported = { anchor, flags: flags ?? {}, message: message ?? '' };
+            this.applyValidity();
+        };
+    }
+    get validityFeedback() {
+        return '';
+    }
+    applyValidity() {
+        const feedback = this.validityFeedback;
+        this.appliedFeedback = feedback;
+        const custom = this.customValidity || feedback;
+        const flags = {};
+        for (const flag of VALIDITY_FLAGS) {
+            if (this.reported.flags[flag] === true) {
+                flags[flag] = true;
+            }
+        }
+        if (custom !== '') {
+            flags.customError = true;
+        }
+        if (Object.keys(flags).length === 0) {
+            this.reportValidityTo({});
+            return;
+        }
+        this.reportValidityTo(flags, custom || this.reported.message, this.validationAnchor(this.reported.anchor));
+    }
+    validationAnchor(anchor) {
+        if (anchor && takesFocus(anchor)) {
+            return anchor;
+        }
+        return this.focusTarget ?? anchor;
+    }
+    get validity() {
+        return this.internals.validity;
+    }
+    get validationMessage() {
+        return this.internals.validationMessage;
+    }
+    get willValidate() {
+        return this.internals.willValidate;
+    }
+    checkValidity() {
+        return this.internals.checkValidity();
+    }
+    reportValidity() {
+        this.applyValidity();
+        return this.internals.reportValidity();
+    }
+    setCustomValidity(message) {
+        this.customValidity = message;
+        this.applyValidity();
+        this.requestUpdate();
+    }
+    get focusTarget() {
+        const root = this.shadowRoot;
+        return root ? firstTabStop(root) : null;
+    }
+    focus(options) {
+        const target = this.focusTarget;
+        if (target) {
+            target.focus(options);
+            return;
+        }
+        super.focus(options);
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.addEventListener('click', this.focusFromLabel);
+        this.addEventListener('invalid', this.refreshAnchor);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.removeEventListener('click', this.focusFromLabel);
+        this.removeEventListener('invalid', this.refreshAnchor);
+    }
+    get blocksImplicitSubmission() {
+        return false;
+    }
+    get submitsForm() {
+        return false;
+    }
+    activate() {
+        this.click();
+    }
+    submitImplicitly() {
+        const { form } = this;
+        if (!form) {
+            return;
+        }
+        const elements = [...form.elements];
+        const button = HelixFormElement.defaultButton(form);
+        if (button) {
+            if (button.matches(':disabled')) {
+                return;
+            }
+            if (button instanceof HelixFormElement) {
+                button.activate();
+            }
+            else {
+                ;
+                button.click();
+            }
+            return;
+        }
+        const blocking = elements.filter((element) => element instanceof HelixFormElement
+            ? element.blocksImplicitSubmission
+            : element instanceof HTMLInputElement && BLOCKING_TYPES.has(element.type));
+        if (blocking.length <= 1) {
+            form.requestSubmit();
+        }
+    }
+    static defaultButton(form) {
+        return [...form.elements].find((element) => HelixFormElement.submits(element));
+    }
+    static submitsOnEnter(target, form) {
+        return (target instanceof HTMLInputElement && target.form === form && BLOCKING_TYPES.has(target.type));
+    }
+    static submits(element) {
+        if (element instanceof HelixFormElement) {
+            return element.submitsForm;
+        }
+        if (element instanceof HTMLButtonElement) {
+            return element.type === 'submit';
+        }
+        return (element instanceof HTMLInputElement && (element.type === 'submit' || element.type === 'image'));
+    }
     get form() {
         return this.internals.form;
     }

package/dist/index.d.ts

@@ -4,25 +4,30 @@ export { ChartPointerController, type ChartPointerHost, } from './controllers/ch
 export { CommandController, type CommandOptions, HelixFallbackCommandEvent, supportsInvokers, } from './controllers/command-controller/command-controller.js';
 export { CopyController, type CopyOptions, } from './controllers/copy-controller/copy-controller.js';
 export { activeCue, adoptTrack, type Caption, CueController, captionsAmong, captionTracks, showCaption, } from './controllers/cue-controller/cue-controller.js';
+export { DelayController, type DelayOptions, } from './controllers/delay-controller/delay-controller.js';
 export { DisabledCascadeController, type DisabledCascadeOptions, } from './controllers/disabled-cascade-controller/disabled-cascade-controller.js';
 export { DismissController, type DismissOptions, } from './controllers/dismiss-controller/dismiss-controller.js';
 export { DrilldownController, type DrilldownOptions, } from './controllers/drilldown-controller/drilldown-controller.js';
 export { FloatingController, type FloatingOptions, type Placement, type Side, } from './controllers/floating-controller/floating-controller.js';
+export { controlsIn, FocusScopeController, type FocusScopeOptions, } from './controllers/focus-scope-controller/focus-scope-controller.js';
 export { FullscreenController } from './controllers/fullscreen-controller/fullscreen-controller.js';
 export { HostClickController } from './controllers/host-click-controller/host-click-controller.js';
 export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, type IndicatorOptions, } from './controllers/indicator-controller/indicator-controller.js';
-export { KeyboardNavigationController, type KeyboardNavigationOptions, type NavigableItem, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
+export { KeyboardNavigationController, type KeyboardNavigationOptions, type NavigableItem, Typeahead, typesCharacter, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
 export { MediaSessionController, type SessionHandlers, SKIP_SECONDS, } from './controllers/media-session-controller/media-session-controller.js';
+export { animationsSettled, type OpenPhase, OpenPhaseController, type OpenPhaseOptions, } from './controllers/open-phase-controller/open-phase-controller.js';
 export { MAX_FRAME_STEP, PaintGateController, type PaintGateOptions, } from './controllers/paint-gate-controller/paint-gate-controller.js';
 export { PlacementController } from './controllers/placement-controller/placement-controller.js';
 export { PopoverController, type PopoverOptions, } from './controllers/popover-controller/popover-controller.js';
 export { RemotePlaybackController, type RemoteReport, } from './controllers/remote-playback-controller/remote-playback-controller.js';
 export { SourceController, type SourceHost, } from './controllers/source-controller/source-controller.js';
+export { drawStatus, type SayOptions, StatusController, } from './controllers/status-controller/status-controller.js';
+export { SwipeController, type SwipeOptions, } from './controllers/swipe-controller/swipe-controller.js';
 export { type TokenColor, TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
 export { type Rendered, VirtualizeController, type VirtualizeOptions, type Window as VirtualizeWindow, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { type CanvasView, type CaretDetail, type ChangeDetail, type CompleteDetail, type ConnectDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, type GraphFilterDetail, type GraphLayoutDetail, type GraphPartChangeDetail, type GraphSignalDetail, HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPreviousEvent, HelixReadEvent, HelixReconnectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixTourAskEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type ReadDetail, type ReconnectDetail, type RelabelDetail, type RemoveDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type ToggleDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
+export { type CanvasView, type CaretDetail, type ChangeDetail, type CompleteDetail, type ConnectDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, type GraphFilterDetail, type GraphLayoutDetail, type GraphPartChangeDetail, type GraphSignalDetail, HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPinEvent, HelixPreviousEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixTourAskEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type ReadDetail, type ReconnectDetail, type Refusal, type RefusedFile, type RejectDetail, type RelabelDetail, type RemoveDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type ToggleDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { MixinChartSource, type MixinChartSourceInterface, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';
@@ -35,22 +40,32 @@ export { type DismissibleElement, MixinDismissible, } from './mixins/mixin-dismi
 export { MixinField, type MixinFieldInterface } from './mixins/mixin-field/mixin-field.js';
 export { MixinPickerEditing, type MixinPickerEditingInterface, } from './mixins/mixin-picker-editing/mixin-picker-editing.js';
 export { MixinPickerField, type MixinPickerFieldInterface, } from './mixins/mixin-picker-field/mixin-picker-field.js';
+export { MixinSegmentedField, type MixinSegmentedFieldInterface, } from './mixins/mixin-segmented-field/mixin-segmented-field.js';
 export { MixinSelectableItem, type MixinSelectableItemInterface, } from './mixins/mixin-selectable-item/mixin-selectable-item.js';
 export { MixinTokens, type MixinTokensInterface } from './mixins/mixin-tokens/mixin-tokens.js';
 export { MixinViewport, type ViewportControlsPlacement, type ViewportElement, type ViewportGestureLabels, type ViewportGestureMode, type ViewportGestures, type ViewportWay, } from './mixins/mixin-viewport/mixin-viewport.js';
 export { anchorElement } from './utils/anchor-element/anchor-element.js';
+export { arrowReach, sideOf } from './utils/arrow/arrow.js';
+export { addDays, addMonths, type Barring, barredBy, type CalendarView, localToday, monthOf, monthOut, type PeriodCell, type PeriodPage, periodCells, periodKey, periodMove, sameMonth, weekStartOf, YEARS_SHOWN, yearOut, yearPageOf, } from './utils/calendar/calendar.js';
 export { capturePointer } from './utils/capture-pointer/capture-pointer.js';
+export { ariaChord, type ChordPress, chordParts, matchesChord, printableChord, } from './utils/chord/chord.js';
+export { clockLocale, dayPeriod, type HourCycle, isTwelveHour, nearestTime, offeredTimes, type TimeFault, type TimeRules, timeBarred, timeFault, wheelParts, wholeHour, } from './utils/clock/clock.js';
 export { closestInstance } from './utils/closest-instance/closest-instance.js';
+export { type ColorWords, colorName, hueName } from './utils/color-name/color-name.js';
+export { countLabel } from './utils/count-label/count-label.js';
 export { createSheet } from './utils/create-sheet/create-sheet.js';
-export { type Color, type ColorFormat, formatColor, parseColor, toCss, } from './utils/css-color/css-color.js';
+export { type Color, type ColorFormat, formatColor, parseColor, toCss, toHsl, toRgb, } from './utils/css-color/css-color.js';
 export { customElement, definedTags, duplicateRegistrations, } from './utils/custom-element/custom-element.js';
+export { type DrawDismissOptions, drawDismiss, drawDismissGlyph, } from './utils/draw-dismiss/draw-dismiss.js';
 export { type DrawIconOptions, drawIcon } from './utils/draw-icon/draw-icon.js';
 export { CHART_PLOT, drawTooltip } from './utils/draw-tooltip/draw-tooltip.js';
 export { elapsedTime } from './utils/elapsed-time/elapsed-time.js';
 export { type ElementByIdOptions, elementById, searchableById, } from './utils/element-by-id/element-by-id.js';
 export { fillTemplate } from './utils/fill-template/fill-template.js';
 export { deepActiveElement, deepContains, focusableElements, } from './utils/focusable-elements/focusable-elements.js';
+export { afterLinkFollowed, followLink, type LinkModifiers, type LinkTarget, } from './utils/follow-link/follow-link.js';
 export { formatNumbers } from './utils/format-numbers/format-numbers.js';
+export { headingIn, headingsIn } from './utils/heading-in/heading-in.js';
 export { type HostAria, hostAria } from './utils/host-aria/host-aria.js';
 export { type DisableableItem, forgetDisabled, inheritDisabled, } from './utils/inherit-disabled/inherit-disabled.js';
 export { inlineStep } from './utils/inline-step/inline-step.js';
@@ -59,10 +74,13 @@ export { keyClaimed } from './utils/key-claimed/key-claimed.js';
 export { type Curve, linePath, type Point } from './utils/line-path/line-path.js';
 export { markRegion, type RegionOptions } from './utils/mark-region/mark-region.js';
 export { copiesOf, type MediaCopy, sameCopies, } from './utils/media-copy/media-copy.js';
+export { formatNumber, parseNumber } from './utils/number-format/number-format.js';
 export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
-export { type ColorBytes, readColor } from './utils/read-color/read-color.js';
-export { type Row, type RowCell, readRows, readSeries, type Series, type SeriesPoint, } from './utils/read-series/read-series.js';
-export { type Relative, relativeTime, } from './utils/relative-time/relative-time.js';
+export { appleTouch, onApple, type Platform } from './utils/platform/platform.js';
+export { type ColorBytes, readColor, rgbOf } from './utils/read-color/read-color.js';
+export { byRow, type Row, type RowCell, readRows, readSeries, type Series, type SeriesPoint, seriesKey, unbroken, } from './utils/read-series/read-series.js';
+export { type ElementsProperty, linkDescription, reflectElements, unlinkDescription, } from './utils/reflect-elements/reflect-elements.js';
+export { type Relative, type RelativeOptions, relativeTime, } from './utils/relative-time/relative-time.js';
 export { measuring, RENDER_SLOT, reportRender } from './utils/report-render/report-render.js';
 export { RUNTIME_LOG, RUNTIME_SLOT, type RuntimeEvent, type RuntimeKind, reportRuntime, } from './utils/report-runtime/report-runtime.js';
 export { noteVersion, reportUsage, USAGE_SLOT, VERSIONS_SLOT, } from './utils/report-usage/report-usage.js';
@@ -70,17 +88,20 @@ export { reportValues } from './utils/report-values/report-values.js';
 export { type ChangeRequestOptions, requestChange, } from './utils/request-change/request-change.js';
 export { type ActivatableItem, resolveActiveItem, } from './utils/resolve-active-item/resolve-active-item.js';
 export { holdCaret, restoreValue } from './utils/restore-value/restore-value.js';
+export { type RovingOptions, rovingStop } from './utils/roving-stop/roving-stop.js';
 export { extent, linear, type Scale } from './utils/scale/scale.js';
 export { ticks } from './utils/scale/ticks.js';
 export { type ScrollItemOptions, scrollItemIntoView, } from './utils/scroll-item-into-view/scroll-item-into-view.js';
+export { lockScroll, scrollHolders, unlockScroll } from './utils/scroll-lock/scroll-lock.js';
 export { slotFilled } from './utils/slot-filled/slot-filled.js';
 export { slottedWords } from './utils/slotted-words/slotted-words.js';
 export { splitValues } from './utils/split-values/split-values.js';
+export { edgeOffset, FLING, parseSnapPoints, type SwipeAxis, type SwipeEdge, type SwipeRelease, settleSwipe, snapTravel, swipeAxis, swipeEdge, swipeStep, towardEdge, } from './utils/swipe/swipe.js';
 export { tellDisclosure } from './utils/tell-disclosure/tell-disclosure.js';
 export { subscribe } from './utils/ticker/ticker.js';
 export { type HelixStatusTone, TONE_MARKS, type ToneMark, toneMark, } from './utils/tone-marks/tone-marks.js';
-export { dateAsValue, isDateValue, isTimeValue, minutesAsValue, numberAsValue, timeAsValue, valueAsDate, valueAsMinutes, valueAsNumber, valueAsTime, } from './utils/value-as/value-as.js';
+export { dateAsValue, isClockValue, isDateValue, isTimeValue, minutesAsValue, numberAsValue, secondsAsValue, timeAsValue, valueAsDate, valueAsMinutes, valueAsNumber, valueAsSeconds, valueAsTime, } from './utils/value-as/value-as.js';
 export { watchTheme } from './utils/watch-theme/watch-theme.js';
-export { writeTime } from './utils/write-time/write-time.js';
-export { writtenList, writtenNumbers } from './utils/written-list/written-list.js';
+export { writeClock, writeTime } from './utils/write-time/write-time.js';
+export { commaList, toggleValue, writtenList, writtenNumbers, } from './utils/written-list/written-list.js';
 export { VERSION } from './version.js';

package/dist/index.js

@@ -4,25 +4,30 @@ export { ChartPointerController, } from './controllers/chart-pointer-controller/
 export { CommandController, HelixFallbackCommandEvent, supportsInvokers, } from './controllers/command-controller/command-controller.js';
 export { CopyController, } from './controllers/copy-controller/copy-controller.js';
 export { activeCue, adoptTrack, CueController, captionsAmong, captionTracks, showCaption, } from './controllers/cue-controller/cue-controller.js';
+export { DelayController, } from './controllers/delay-controller/delay-controller.js';
 export { DisabledCascadeController, } from './controllers/disabled-cascade-controller/disabled-cascade-controller.js';
 export { DismissController, } from './controllers/dismiss-controller/dismiss-controller.js';
 export { DrilldownController, } from './controllers/drilldown-controller/drilldown-controller.js';
 export { FloatingController, } from './controllers/floating-controller/floating-controller.js';
+export { controlsIn, FocusScopeController, } from './controllers/focus-scope-controller/focus-scope-controller.js';
 export { FullscreenController } from './controllers/fullscreen-controller/fullscreen-controller.js';
 export { HostClickController } from './controllers/host-click-controller/host-click-controller.js';
 export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, } from './controllers/indicator-controller/indicator-controller.js';
-export { KeyboardNavigationController, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
+export { KeyboardNavigationController, Typeahead, typesCharacter, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
 export { MediaSessionController, SKIP_SECONDS, } from './controllers/media-session-controller/media-session-controller.js';
+export { animationsSettled, OpenPhaseController, } from './controllers/open-phase-controller/open-phase-controller.js';
 export { MAX_FRAME_STEP, PaintGateController, } from './controllers/paint-gate-controller/paint-gate-controller.js';
 export { PlacementController } from './controllers/placement-controller/placement-controller.js';
 export { PopoverController, } from './controllers/popover-controller/popover-controller.js';
 export { RemotePlaybackController, } from './controllers/remote-playback-controller/remote-playback-controller.js';
 export { SourceController, } from './controllers/source-controller/source-controller.js';
+export { drawStatus, StatusController, } from './controllers/status-controller/status-controller.js';
+export { SwipeController, } from './controllers/swipe-controller/swipe-controller.js';
 export { TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
 export { VirtualizeController, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPreviousEvent, HelixReadEvent, HelixReconnectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixTourAskEvent, } from './events/events.js';
+export { HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPinEvent, HelixPreviousEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixTourAskEvent, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { MixinChartSource, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';
@@ -35,22 +40,32 @@ export { MixinDismissible, } from './mixins/mixin-dismissible/mixin-dismissible.
 export { MixinField } from './mixins/mixin-field/mixin-field.js';
 export { MixinPickerEditing, } from './mixins/mixin-picker-editing/mixin-picker-editing.js';
 export { MixinPickerField, } from './mixins/mixin-picker-field/mixin-picker-field.js';
+export { MixinSegmentedField, } from './mixins/mixin-segmented-field/mixin-segmented-field.js';
 export { MixinSelectableItem, } from './mixins/mixin-selectable-item/mixin-selectable-item.js';
 export { MixinTokens } from './mixins/mixin-tokens/mixin-tokens.js';
 export { MixinViewport, } from './mixins/mixin-viewport/mixin-viewport.js';
 export { anchorElement } from './utils/anchor-element/anchor-element.js';
+export { arrowReach, sideOf } from './utils/arrow/arrow.js';
+export { addDays, addMonths, barredBy, localToday, monthOf, monthOut, periodCells, periodKey, periodMove, sameMonth, weekStartOf, YEARS_SHOWN, yearOut, yearPageOf, } from './utils/calendar/calendar.js';
 export { capturePointer } from './utils/capture-pointer/capture-pointer.js';
+export { ariaChord, chordParts, matchesChord, printableChord, } from './utils/chord/chord.js';
+export { clockLocale, dayPeriod, isTwelveHour, nearestTime, offeredTimes, timeBarred, timeFault, wheelParts, wholeHour, } from './utils/clock/clock.js';
 export { closestInstance } from './utils/closest-instance/closest-instance.js';
+export { colorName, hueName } from './utils/color-name/color-name.js';
+export { countLabel } from './utils/count-label/count-label.js';
 export { createSheet } from './utils/create-sheet/create-sheet.js';
-export { formatColor, parseColor, toCss, } from './utils/css-color/css-color.js';
+export { formatColor, parseColor, toCss, toHsl, toRgb, } from './utils/css-color/css-color.js';
 export { customElement, definedTags, duplicateRegistrations, } from './utils/custom-element/custom-element.js';
+export { drawDismiss, drawDismissGlyph, } from './utils/draw-dismiss/draw-dismiss.js';
 export { drawIcon } from './utils/draw-icon/draw-icon.js';
 export { CHART_PLOT, drawTooltip } from './utils/draw-tooltip/draw-tooltip.js';
 export { elapsedTime } from './utils/elapsed-time/elapsed-time.js';
 export { elementById, searchableById, } from './utils/element-by-id/element-by-id.js';
 export { fillTemplate } from './utils/fill-template/fill-template.js';
 export { deepActiveElement, deepContains, focusableElements, } from './utils/focusable-elements/focusable-elements.js';
+export { afterLinkFollowed, followLink, } from './utils/follow-link/follow-link.js';
 export { formatNumbers } from './utils/format-numbers/format-numbers.js';
+export { headingIn, headingsIn } from './utils/heading-in/heading-in.js';
 export { hostAria } from './utils/host-aria/host-aria.js';
 export { forgetDisabled, inheritDisabled, } from './utils/inherit-disabled/inherit-disabled.js';
 export { inlineStep } from './utils/inline-step/inline-step.js';
@@ -59,9 +74,12 @@ export { keyClaimed } from './utils/key-claimed/key-claimed.js';
 export { linePath } from './utils/line-path/line-path.js';
 export { markRegion } from './utils/mark-region/mark-region.js';
 export { copiesOf, sameCopies, } from './utils/media-copy/media-copy.js';
+export { formatNumber, parseNumber } from './utils/number-format/number-format.js';
 export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
-export { readColor } from './utils/read-color/read-color.js';
-export { readRows, readSeries, } from './utils/read-series/read-series.js';
+export { appleTouch, onApple } from './utils/platform/platform.js';
+export { readColor, rgbOf } from './utils/read-color/read-color.js';
+export { byRow, readRows, readSeries, seriesKey, unbroken, } from './utils/read-series/read-series.js';
+export { linkDescription, reflectElements, unlinkDescription, } from './utils/reflect-elements/reflect-elements.js';
 export { relativeTime, } from './utils/relative-time/relative-time.js';
 export { measuring, RENDER_SLOT, reportRender } from './utils/report-render/report-render.js';
 export { RUNTIME_LOG, RUNTIME_SLOT, reportRuntime, } from './utils/report-runtime/report-runtime.js';
@@ -70,17 +88,20 @@ export { reportValues } from './utils/report-values/report-values.js';
 export { requestChange, } from './utils/request-change/request-change.js';
 export { resolveActiveItem, } from './utils/resolve-active-item/resolve-active-item.js';
 export { holdCaret, restoreValue } from './utils/restore-value/restore-value.js';
+export { rovingStop } from './utils/roving-stop/roving-stop.js';
 export { extent, linear } from './utils/scale/scale.js';
 export { ticks } from './utils/scale/ticks.js';
 export { scrollItemIntoView, } from './utils/scroll-item-into-view/scroll-item-into-view.js';
+export { lockScroll, scrollHolders, unlockScroll } from './utils/scroll-lock/scroll-lock.js';
 export { slotFilled } from './utils/slot-filled/slot-filled.js';
 export { slottedWords } from './utils/slotted-words/slotted-words.js';
 export { splitValues } from './utils/split-values/split-values.js';
+export { edgeOffset, FLING, parseSnapPoints, settleSwipe, snapTravel, swipeAxis, swipeEdge, swipeStep, towardEdge, } from './utils/swipe/swipe.js';
 export { tellDisclosure } from './utils/tell-disclosure/tell-disclosure.js';
 export { subscribe } from './utils/ticker/ticker.js';
 export { TONE_MARKS, toneMark, } from './utils/tone-marks/tone-marks.js';
-export { dateAsValue, isDateValue, isTimeValue, minutesAsValue, numberAsValue, timeAsValue, valueAsDate, valueAsMinutes, valueAsNumber, valueAsTime, } from './utils/value-as/value-as.js';
+export { dateAsValue, isClockValue, isDateValue, isTimeValue, minutesAsValue, numberAsValue, secondsAsValue, timeAsValue, valueAsDate, valueAsMinutes, valueAsNumber, valueAsSeconds, valueAsTime, } from './utils/value-as/value-as.js';
 export { watchTheme } from './utils/watch-theme/watch-theme.js';
-export { writeTime } from './utils/write-time/write-time.js';
-export { writtenList, writtenNumbers } from './utils/written-list/written-list.js';
+export { writeClock, writeTime } from './utils/write-time/write-time.js';
+export { commaList, toggleValue, writtenList, writtenNumbers, } from './utils/written-list/written-list.js';
 export { VERSION } from './version.js';

package/dist/mixins/mixin-chart-source/mixin-chart-source.d.ts

@@ -1,6 +1,6 @@
 import { ChartPointerController } from '../../controllers/chart-pointer-controller/chart-pointer-controller.js';
 import type { HelixElement } from '../../helix-element/helix-element.js';
-import type { Row, Series } from '../../utils/read-series/read-series.js';
+import { type Row, type Series } from '../../utils/read-series/read-series.js';
 type Constructor<T> = new (...args: any[]) => T;
 /**
  * How many colors the series palette has, and so where it starts over.
@@ -45,7 +45,7 @@ export declare const PLOT_HEIGHT = 100;
  * nothing to read off the page that says why.
  *
  * `writtenList` is the split, and carries the argument for accepting a comma.
- * What this adds is the lowercase, the headings being matched
+ * What this adds is `seriesKey`, the headings being matched
  * case-insensitively.
  */
 export declare const seriesNames: (list: string | undefined) => string[];
@@ -128,6 +128,14 @@ export declare class MixinChartSourceInterface {
      * words and is already written.
      */
     label: string;
+    /**
+     * The locale the chart's own numbers are written in: its axis, its
+     * percentages and its totals, such as `de` for `1.240` and `32 %`.
+     *
+     * Absent uses the runtime's own. The table's cells are shown as the table
+     * writes them, whatever this says.
+     */
+    locale: string;
     /**
      * The table's columns, one series each. Empty when there is no table.
      */
@@ -150,6 +158,11 @@ export declare class MixinChartSourceInterface {
      * when no series was read from that column.
      */
     seriesOf(cell: number): number | undefined;
+    /**
+     * Whether the series of this name is drawn, which it is unless a legend
+     * reading the same table hid it.
+     */
+    showsSeries(name: string): boolean;
     /**
      * The number of readings, which the pointer position maps onto.
      */

package/dist/mixins/mixin-chart-source/mixin-chart-source.js

@@ -7,12 +7,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { property } from 'lit/decorators.js';
 import { ChartPointerController } from '../../controllers/chart-pointer-controller/chart-pointer-controller.js';
 import { SourceController } from '../../controllers/source-controller/source-controller.js';
+import { seriesKey } from '../../utils/read-series/read-series.js';
 import { writtenList } from '../../utils/written-list/written-list.js';
 export const PALETTE = 24;
 export const seriesIndex = (depth) => (depth % PALETTE) + 1;
 export const PLOT_WIDTH = 100;
 export const PLOT_HEIGHT = 100;
-export const seriesNames = (list) => writtenList(list).map((name) => name.toLowerCase());
+export const seriesNames = (list) => writtenList(list).map(seriesKey);
 export const MixinChartSource = (Base) => {
     class ChartSourceElement extends Base {
         constructor() {
@@ -21,6 +22,7 @@ export const MixinChartSource = (Base) => {
             this.pointer = new ChartPointerController(this);
             this.for = '';
             this.label = '';
+            this.locale = '';
         }
         willUpdate(changed) {
             super.willUpdate(changed);
@@ -46,6 +48,9 @@ export const MixinChartSource = (Base) => {
             const depth = this.plottedColumns.indexOf(cell);
             return depth < 0 ? undefined : seriesIndex(depth);
         }
+        showsSeries(name) {
+            return !this.source.hidden.has(seriesKey(name));
+        }
         get readings() {
             return this.sourceRows.length;
         }
@@ -56,5 +61,8 @@ export const MixinChartSource = (Base) => {
     __decorate([
         property()
     ], ChartSourceElement.prototype, "label", void 0);
+    __decorate([
+        property()
+    ], ChartSourceElement.prototype, "locale", void 0);
     return ChartSourceElement;
 };

package/dist/mixins/mixin-collection/mixin-collection.d.ts

@@ -16,9 +16,11 @@ export declare class CollectionElement {
     /**
      * The status line, or nothing where the collection has content to show.
      *
-     * Rendered by the component wherever its rows would be.
+     * Rendered by the component wherever its rows would be. `cell` makes the line
+     * a row holding one cell of that role, for a table or a grid, whose children
+     * may only be rows.
      */
-    protected renderStatus(hasContent: boolean): TemplateResult | typeof nothing;
+    protected renderStatus(hasContent: boolean, cell?: 'cell' | 'gridcell'): TemplateResult | typeof nothing;
     /**
      * The same words for a screen reader, in a region that is always there.
      *

package/dist/mixins/mixin-collection/mixin-collection.js

@@ -42,14 +42,16 @@ export const MixinCollection = (Base) => {
             super.firstUpdated(changed);
             this.finishHydration();
         }
-        renderStatus(hasContent) {
-            if (this.loading) {
-                return html `<p part="loading">${this.loadingText}</p>`;
-            }
-            if (hasContent) {
+        renderStatus(hasContent, cell) {
+            if (!this.loading && hasContent) {
                 return nothing;
             }
-            return html `<p part="empty">${this.emptyText}</p>`;
+            const text = this.loading ? this.loadingText : this.emptyText;
+            const words = cell ? html `<span role=${cell}>${text}</span>` : text;
+            const row = cell ? 'row' : nothing;
+            return this.loading
+                ? html `<p part="loading" role=${row}>${words}</p>`
+                : html `<p part="empty" role=${row}>${words}</p>`;
         }
         renderLive(hasContent) {
             const said = this.loading ? this.loadingText : hasContent ? this.announced : this.emptyText;

package/dist/mixins/mixin-controller-checked/mixin-controller-checked.d.ts

@@ -20,6 +20,16 @@ export declare class MixinControllerCheckedInterface {
      * Whether the control starts checked. A form reset returns it to this state.
      */
     defaultChecked: boolean;
+    /**
+     * Whether a reader can see and focus the control and cannot change it. A
+     * read-only control still submits its value.
+     */
+    readOnly: boolean;
+    /**
+     * Refuses a press on the inner control while the control is read-only,
+     * bound to its `click`.
+     */
+    protected readonly holdReadOnly: (event: Event) => void;
     /**
      * Requests a change to `checked`, and returns whether it was applied.
      *