@fusion.dev/helix-core 0.146.0 → 0.147.0

package/dist/controllers/aria-forward-controller/aria-forward-controller.js

@@ -74,9 +74,11 @@ export class AriaForwardController {
                 continue;
             }
             const ids = (this.host.getAttribute(attribute) ?? '').split(/\s+/).filter(Boolean);
-            const referenced = ids
-                .map((id) => elementById(this.host, id))
-                .filter((element) => element !== null);
+            const referenced = ids.length > 0
+                ? ids
+                    .map((id) => elementById(this.host, id))
+                    .filter((element) => element !== null)
+                : [...(this.host[property] ?? [])];
             const elements = referenced.length === 0 && attribute === 'aria-labelledby'
                 ? this.hostLabels(target)
                 : referenced;

package/dist/controllers/chart-pointer-controller/chart-pointer-controller.d.ts

@@ -49,6 +49,12 @@ export interface ChartPointerHost extends ReactiveControllerHost, HTMLElement {
      * The keys pass over a hidden reading, as they pass over a hidden series.
      */
     showsReading?(at: number): boolean;
+    /**
+     * Where PageUp or PageDown goes from the reading at `at`, by place among the
+     * readings, for a chart whose page is no fixed count: a calendar's month.
+     * Undefined keeps the fixed page.
+     */
+    pageFrom?(at: number, forward: boolean): number | undefined;
     /**
      * The words for where a reading stands among them, with `{position}` and
      * `{count}` to fill. Absent or empty, no position is said.

package/dist/controllers/chart-pointer-controller/chart-pointer-controller.js

@@ -27,6 +27,19 @@ export class ChartPointerController {
                 }
                 return;
             }
+            const paged = (event.key === 'PageDown' || event.key === 'PageUp') && this.at >= 0
+                ? this.host.pageFrom?.(this.at, event.key === 'PageDown')
+                : undefined;
+            if (paged !== undefined && shown.includes(paged)) {
+                event.preventDefault();
+                if (paged !== this.at) {
+                    this.at = paged;
+                    this.keyed = true;
+                    this.moved = true;
+                    this.host.requestUpdate();
+                }
+                return;
+            }
             const next = stepReading(event.key, { at: shown.indexOf(this.at), series: this.series }, {
                 axis: this.axis,
                 count,

package/dist/controllers/copy-controller/copy-controller.d.ts

@@ -7,8 +7,11 @@ export interface CopyOptions {
      * On a timer rather than on the pointer leaving, so it survives a hand that
      * has already moved on: the press and the reading of it are two moments, and
      * a mark that vanishes with the cursor is one a fast reader never sees.
+     *
+     * A function is read at each copy, for a host whose duration is a property
+     * a page can change, as other controllers' options are.
      */
-    after?: number;
+    after?: number | (() => number);
 }
 /**
  * Puts text on the clipboard and holds a confirmation for a moment.

package/dist/controllers/copy-controller/copy-controller.js

@@ -1,5 +1,6 @@
 import { HelixCopyEvent } from '../../events/events.js';
 import { deepActiveElement } from '../../utils/focusable-elements/focusable-elements.js';
+const read = (option) => typeof option === 'function' ? option() : option;
 const write = async (text) => {
     try {
         await navigator.clipboard.writeText(text);
@@ -53,7 +54,7 @@ export class CopyController {
             this.copied = false;
             this.failed = false;
             this.host.requestUpdate();
-        }, this.options.after ?? 1200);
+        }, read(this.options.after) ?? 1200);
         return wrote;
     }
     hostDisconnected() {

package/dist/controllers/countdown-controller/countdown-controller.d.ts

@@ -46,7 +46,10 @@ export declare class CountdownController implements ReactiveController {
     pause(): void;
     /** Runs the clock again from where it stopped. */
     resume(): void;
-    /** Stops the clock where it is, as a dismissal does. */
+    /**
+     * Stops the clock for good, as a dismissal does: nothing is left to resume
+     * until the next `start`, so a hold and a release after it run nothing.
+     */
     cancel(): void;
     /** One more reason to hold the clock, such as a pointer arriving. */
     hold(): void;

package/dist/controllers/countdown-controller/countdown-controller.js

@@ -36,13 +36,15 @@ export class CountdownController {
         this.startedAt = Date.now();
         this.options.paused?.(false);
         this.timer = setTimeout(() => {
-            this.timer = undefined;
+            this.cancel();
             this.options.done();
         }, this.remaining);
     }
     cancel() {
         clearTimeout(this.timer);
         this.timer = undefined;
+        this.remaining = undefined;
+        this.startedAt = undefined;
     }
     hold() {
         this.holds += 1;

package/dist/controllers/keyboard-navigation-controller/keyboard-navigation-controller.d.ts

@@ -19,6 +19,11 @@ export interface NavigableItem {
     select(): void;
     /** Whether the item is the current one, which is where movement starts. */
     selected: boolean;
+    /**
+     * The words a reader types the start of, for a set that types ahead with
+     * `typeaheadByWords`.
+     */
+    readonly words?: string;
 }
 /** Where a move starts from: the item that has focus, or the chosen item. */
 export type KeyboardOrigin = 'focus' | 'selection';

package/dist/controllers/source-controller/source-controller.js

@@ -1,3 +1,4 @@
+import { auditSource } from '#audit-source';
 import { elementById } from '../../utils/element-by-id/element-by-id.js';
 import { readRows, readSeries, seriesKey, } from '../../utils/read-series/read-series.js';
 const HIDDEN = new WeakMap();
@@ -92,6 +93,7 @@ export class SourceController {
     }
     hostConnected() {
         this.watch();
+        auditSource(this.host, () => this.resolve());
     }
     hostUpdated() {
         if (this.deferred) {

package/dist/controllers/swipe-controller/swipe-controller.d.ts

@@ -10,6 +10,12 @@ export interface SwipeOptions {
     end: (dx: number, dy: number, vx: number, vy: number) => void;
     /** Called as the pointer moves, with how far it has gone from the press. */
     move: (dx: number, dy: number) => void;
+    /**
+     * How far a press travels before it is a swipe, in pixels: 8 where this is
+     * not given. A mouse drag that takes over sooner, such as Carousel's at 4,
+     * says so here.
+     */
+    slop?: number;
     /**
      * Whether a press may start a swipe, given the element it landed on. Every
      * press may where this is not given. A field, a scroller that has its own use
@@ -32,7 +38,10 @@ export interface SwipeOptions {
  * axis.** Before that it is still a press, so a tap on a button inside the
  * surface is a tap, and a drag across the axis, a reader scrolling, is left to
  * the page. Once it is a swipe, the click that ends it is swallowed, so a
- * swipe that started on a button does not also press it.
+ * swipe that started on a button does not also press it. The swallow is held on
+ * the window for one task after the release, so a spec that swipes and then
+ * presses a control in the same task sees that press swallowed: wait a task
+ * between them, as a reader's next press always does.
  *
  * The move and the release are heard on the window, so a pointer that leaves
  * the surface mid-swipe is still followed.

package/dist/controllers/swipe-controller/swipe-controller.js

@@ -34,7 +34,7 @@ export class SwipeController {
             if (!this.swiping) {
                 const along = Math.abs(axis === 'x' ? dx : dy);
                 const across = Math.abs(axis === 'x' ? dy : dx);
-                if (Math.max(along, across) < SLOP) {
+                if (Math.max(along, across) < (this.options.slop ?? SLOP)) {
                     return;
                 }
                 if (across >= along) {

package/dist/controllers/virtualize-controller/virtualize-controller.js

@@ -1,3 +1,4 @@
+import { endInSight } from '../../utils/load-more/load-more.js';
 import { reportRuntime } from '../../utils/report-runtime/report-runtime.js';
 import { Heights } from './heights.js';
 const UNSTABLE = 10;
@@ -159,12 +160,13 @@ export class VirtualizeController {
         return Math.max(0, length - Math.max(0, box.scrollTop) - box.clientHeight);
     }
     endInSight(length = Math.max(0, this.options.count())) {
-        const screen = this.options.container()?.clientHeight ?? 0;
-        if (length === 0 ||
-            screen <= 0 ||
-            this.askedAt === length ||
-            this.options.count() <= 0 ||
-            this.remaining() > screen) {
+        if (this.options.count() <= 0 ||
+            !endInSight({
+                askedAt: this.askedAt,
+                count: length,
+                remaining: this.remaining(),
+                screen: this.options.container()?.clientHeight ?? 0,
+            })) {
             return false;
         }
         this.askedAt = length;

package/dist/events/band.d.ts

@@ -0,0 +1,13 @@
+import type { BandDetail } from './details.js';
+/**
+ * A reading moved into another band: a meter whose value crossed `low`,
+ * `high` or `optimum` into `good`, `fair` or `poor`.
+ *
+ * Sent once for each crossing, not on every value, so a listener can say the
+ * change aloud or recolor something else on the page. Not cancelable, since
+ * the reading has already moved. Bubbles and is composed.
+ */
+export declare class HelixBandEvent extends CustomEvent<BandDetail> {
+    static readonly eventName = "helix-band";
+    constructor(detail: BandDetail);
+}

package/dist/events/band.js

@@ -0,0 +1,11 @@
+export class HelixBandEvent extends CustomEvent {
+    static { this.eventName = 'helix-band'; }
+    constructor(detail) {
+        super(HelixBandEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}

package/dist/events/details.d.ts

@@ -354,6 +354,11 @@ export interface PressDetail {
     /** What the press came from. */
     pointerType: PressPointerType;
 }
+/** Detail carried by `helix-band`. */
+export interface BandDetail {
+    /** The band the reading is in now, or `''` where it is in none. */
+    band: '' | 'fair' | 'good' | 'poor';
+}
 /** Detail carried by `helix-tour-status`. */
 export interface TourStatusDetail {
     /** The stop it happened at, counting from 0. */

package/dist/events/events.d.ts

@@ -31,6 +31,7 @@
 import { HelixActionEvent } from './action.js';
 import { HelixActivateEvent } from './activate.js';
 import { HelixAuraFallbackEvent } from './aura-fallback.js';
+import { HelixBandEvent } from './band.js';
 import { HelixBeforeActivateEvent } from './before-activate.js';
 import { HelixBeforeChangeEvent } from './before-change.js';
 import { HelixBeforeCloseEvent } from './before-close.js';
@@ -114,9 +115,9 @@ import { HelixToggleEvent } from './toggle.js';
 import { HelixTourAskEvent } from './tour-ask.js';
 import { HelixTourStatusEvent } from './tour-status.js';
 import { HelixTypingEvent } from './typing.js';
-export type { ActivateDetail, AuraFallbackDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DismissDetail, FacetDetail, FilterDetail, GraphFilterDetail, GraphLayoutDetail, GraphPartChangeDetail, GraphSignalDetail, MapClusterDetail, MapPanDetail, MapPartChangeDetail, MapRotateDetail, MapTiltDetail, MapZoomDetail, MoveDetail, NavigateDetail, OpenDetail, PressDetail, PressPointerType, RangeDetail, ReadDetail, ReconnectDetail, Refusal, RefusedFile, RejectDetail, RelabelDetail, RemoveDetail, ResizeDetail, ScrolledDetail, SelectDetail, SendDetail, ShortcutDetail, SkipDetail, SortDetail, ToggleDetail, TourAskDetail, TourStatusDetail, TypingDetail, ViewportPanDetail, ViewportZoomDetail, } from './details.js';
+export type { ActivateDetail, AuraFallbackDetail, BandDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DismissDetail, FacetDetail, FilterDetail, GraphFilterDetail, GraphLayoutDetail, GraphPartChangeDetail, GraphSignalDetail, MapClusterDetail, MapPanDetail, MapPartChangeDetail, MapRotateDetail, MapTiltDetail, MapZoomDetail, MoveDetail, NavigateDetail, OpenDetail, PressDetail, PressPointerType, RangeDetail, ReadDetail, ReconnectDetail, Refusal, RefusedFile, RejectDetail, RelabelDetail, RemoveDetail, ResizeDetail, ScrolledDetail, SelectDetail, SendDetail, ShortcutDetail, SkipDetail, SortDetail, ToggleDetail, TourAskDetail, TourStatusDetail, TypingDetail, ViewportPanDetail, ViewportZoomDetail, } from './details.js';
 export { helixEventNames } from './names.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
 /**
  * Every event class, and the one place a new one is registered: a class in a
  * module of its own, imported above, and named here and in `names.ts`.
@@ -133,6 +134,7 @@ declare const registry: {
     readonly HelixActionEvent: typeof HelixActionEvent;
     readonly HelixActivateEvent: typeof HelixActivateEvent;
     readonly HelixAuraFallbackEvent: typeof HelixAuraFallbackEvent;
+    readonly HelixBandEvent: typeof HelixBandEvent;
     readonly HelixBeforeActivateEvent: typeof HelixBeforeActivateEvent;
     readonly HelixBeforeChangeEvent: typeof HelixBeforeChangeEvent;
     readonly HelixBeforeCloseEvent: typeof HelixBeforeCloseEvent;

package/dist/events/events.js

@@ -1,6 +1,7 @@
 import { HelixActionEvent } from './action.js';
 import { HelixActivateEvent } from './activate.js';
 import { HelixAuraFallbackEvent } from './aura-fallback.js';
+import { HelixBandEvent } from './band.js';
 import { HelixBeforeActivateEvent } from './before-activate.js';
 import { HelixBeforeChangeEvent } from './before-change.js';
 import { HelixBeforeCloseEvent } from './before-close.js';
@@ -85,11 +86,12 @@ import { HelixTourAskEvent } from './tour-ask.js';
 import { HelixTourStatusEvent } from './tour-status.js';
 import { HelixTypingEvent } from './typing.js';
 export { helixEventNames } from './names.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
 const registry = {
     HelixActionEvent,
     HelixActivateEvent,
     HelixAuraFallbackEvent,
+    HelixBandEvent,
     HelixBeforeActivateEvent,
     HelixBeforeChangeEvent,
     HelixBeforeCloseEvent,

package/dist/events/names.d.ts

@@ -11,5 +11,8 @@
  * bundle: a Badge shipped all eighty of them. As strings, a family ships the
  * classes it dispatches and no others. `events.pure.spec.ts` holds this list to
  * the classes, so a class added without its name here fails.
+ *
+ * **Without the shared `helix-`, and separated by spaces.** Every element carries this
+ * list, and as quoted strings each paid its quotes, its comma and the prefix.
  */
 export declare const helixEventNames: ReadonlySet<string>;

package/dist/events/names.js

@@ -1,88 +1,13 @@
-export const helixEventNames = new Set([
-    'helix-action',
-    'helix-activate',
-    'helix-aura-fallback',
-    'helix-before-activate',
-    'helix-before-change',
-    'helix-before-close',
-    'helix-before-collapse',
-    'helix-before-edit',
-    'helix-before-move',
-    'helix-before-open',
-    'helix-before-panel-resize',
-    'helix-before-pin',
-    'helix-before-reconnect',
-    'helix-before-relabel',
-    'helix-before-resize',
-    'helix-before-split',
-    'helix-before-toggle',
-    'helix-canvas-edit',
-    'helix-canvas-pan',
-    'helix-canvas-view',
-    'helix-canvas-zoom',
-    'helix-caret',
-    'helix-clear',
-    'helix-collapse',
-    'helix-complete',
-    'helix-connect',
-    'helix-console',
-    'helix-copy',
-    'helix-copy-error',
-    'helix-create',
-    'helix-dismiss',
-    'helix-edit',
-    'helix-end',
-    'helix-expand',
-    'helix-facet',
-    'helix-filter',
-    'helix-filtered',
-    'helix-graph-filter',
-    'helix-graph-layout',
-    'helix-graph-pan',
-    'helix-graph-part-change',
-    'helix-graph-ready',
-    'helix-graph-signal',
-    'helix-graph-zoom',
-    'helix-history',
-    'helix-load',
-    'helix-load-more',
-    'helix-map-cluster',
-    'helix-map-pan',
-    'helix-map-part-change',
-    'helix-map-ready',
-    'helix-map-rotate',
-    'helix-map-tilt',
-    'helix-map-zoom',
-    'helix-move',
-    'helix-navigate',
-    'helix-next',
-    'helix-panel-resize',
-    'helix-pin',
-    'helix-press',
-    'helix-preview',
-    'helix-previous',
-    'helix-range-change',
-    'helix-read',
-    'helix-reconnect',
-    'helix-reject',
-    'helix-relabel',
-    'helix-remove',
-    'helix-reorder',
-    'helix-reordered',
-    'helix-resize',
-    'helix-resized',
-    'helix-sample-end',
-    'helix-sample-start',
-    'helix-scrolled',
-    'helix-select',
-    'helix-selected',
-    'helix-send',
-    'helix-shortcut',
-    'helix-sort',
-    'helix-sorted',
-    'helix-split',
-    'helix-toggle',
-    'helix-tour-ask',
-    'helix-tour-status',
-    'helix-typing',
-]);
+export const helixEventNames = new Set(('action activate aura-fallback band before-activate before-change before-close ' +
+    'before-collapse before-edit before-move before-open before-panel-resize before-pin ' +
+    'before-reconnect before-relabel before-resize before-split before-toggle ' +
+    'canvas-edit canvas-pan canvas-view canvas-zoom caret clear collapse complete ' +
+    'connect console copy copy-error create dismiss edit end expand facet filter ' +
+    'filtered graph-filter graph-layout graph-pan graph-part-change graph-ready ' +
+    'graph-signal graph-zoom history load load-more map-cluster map-pan map-part-change ' +
+    'map-ready map-rotate map-tilt map-zoom move navigate next panel-resize pin press ' +
+    'preview previous range-change read reconnect reject relabel remove reorder ' +
+    'reordered resize resized sample-end sample-start scrolled select selected send ' +
+    'shortcut sort sorted split toggle tour-ask tour-status typing')
+    .split(' ')
+    .map((name) => `helix-${name}`));

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

@@ -1,41 +1,15 @@
-import { css, LitElement } from 'lit';
+import { LitElement, unsafeCSS } from 'lit';
 import { unsafeStatic } from 'lit/static-html.js';
 import { measuring, reportRender } from '../utils/report-render/report-render.js';
 import { noteVersion, reportUsage } from '../utils/report-usage/report-usage.js';
 import { applyReactProperties, auditReactProps, bindReactHandler, reactPropsOf, } from './react-bridge.js';
-const BOX_SIZING = css `
-  *,
-  ::before,
-  ::after {
-    box-sizing: border-box;
-  }
-`;
-const HIDDEN = css `
-  :host([hidden]:not([hidden='until-found'])) {
-    display: none;
-  }
-`;
-const SCROLLER = css `
-  [data-scroller] {
-    overflow: auto;
-  }
-`;
-const VIRTUAL = css `
-  [data-virtual] {
-    overflow-anchor: none;
-  }
-`;
-const MIRROR = css `
-  :host(:dir(rtl)) [data-mirror] {
-    scale: -1 1;
-  }
-`;
-const SETTLED = css `
-  :host(:not(:state(settled))),
-  :host(:not(:state(settled))) * {
-    transition: none !important;
-  }
-`;
+const BOX_SIZING = '*,::before,::after{box-sizing:border-box}';
+const HIDDEN = ":host([hidden]:not([hidden='until-found'])){display:none}";
+const SCROLLER = '[data-scroller]{overflow:auto}';
+const VIRTUAL = '[data-virtual]{overflow-anchor:none}';
+const MIRROR = ':host(:dir(rtl)) [data-mirror]{scale:-1 1}';
+const SETTLED = ':host(:not(:state(settled))),:host(:not(:state(settled))) *{transition:none!important}';
+const BASE = unsafeCSS(BOX_SIZING + HIDDEN + SCROLLER + VIRTUAL + MIRROR + SETTLED);
 const LOOK_EVERY = 16;
 const LOOK_FOR = 96;
 export class HelixElement extends LitElement {
@@ -117,15 +91,7 @@ export class HelixElement extends LitElement {
         }));
     }
     static finalizeStyles(styles) {
-        return [
-            BOX_SIZING,
-            HIDDEN,
-            SCROLLER,
-            VIRTUAL,
-            MIRROR,
-            SETTLED,
-            ...LitElement.finalizeStyles(styles),
-        ];
+        return [BASE, ...LitElement.finalizeStyles(styles)];
     }
     performUpdate() {
         if (this.hasUpdated || !measuring()) {

package/dist/helix-element/react-bridge.d.ts

@@ -56,6 +56,19 @@ export declare const auditReactProps: (host: EventTarget, props: Record<string,
  * `reactNativeProp`.
  */
 export declare const reactPropFor: (event: Event) => string | undefined;
+/**
+ * React's casing for the native events whose names are two words run together.
+ *
+ * React spells these as two words, `onTimeUpdate` for `timeupdate`, and that
+ * is the prop its own `<video>` typings teach a consumer to write. The media
+ * names are the ones `Video` relays from its inner `<video>`; `scrollend` is
+ * `Scroll Area`'s. A single word needs no entry: its first letter is the whole
+ * of the rule.
+ *
+ * `@fusion.dev/helix-cem` keeps the same table for the typings it writes, and
+ * its spec holds that copy to this one.
+ */
+export declare const REACT_CASING: Readonly<Record<string, string>>;
 /**
  * The prop React reads for a native event: `onError` for `error`, and
  * `onTimeUpdate` for `timeupdate`.

package/dist/helix-element/react-bridge.js

@@ -78,7 +78,7 @@ export const reactPropFor = (event) => {
     }
     return reactNativeProp(event.type);
 };
-const REACT_CASING = {
+export const REACT_CASING = {
     canplay: 'onCanPlay',
     canplaythrough: 'onCanPlayThrough',
     durationchange: 'onDurationChange',

package/dist/index.d.ts

@@ -30,10 +30,10 @@ export { SwipeController, type SwipeOptions, } from './controllers/swipe-control
 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 ActivateDetail, type AuraFallbackDetail, 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, HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type PressDetail, type PressPointerType, type RangeDetail, 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 TourStatusDetail, type TypingDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
+export { type ActivateDetail, type AuraFallbackDetail, type BandDetail, 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, HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPinEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type PressDetail, type PressPointerType, type RangeDetail, 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 TourStatusDetail, type TypingDetail, 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';
+export { MixinChartSource, type MixinChartSourceInterface, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, POSITION_LABEL, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';
 export { type CollectionElement, MixinCollection, } from './mixins/mixin-collection/mixin-collection.js';
 export { MixinControllerActive, type MixinControllerActiveInterface, } from './mixins/mixin-controller-active/mixin-controller-active.js';
 export { MixinControllerChecked, type MixinControllerCheckedInterface, } from './mixins/mixin-controller-checked/mixin-controller-checked.js';
@@ -42,6 +42,7 @@ export { MixinControllerValue, type MixinControllerValueInterface, } from './mix
 export { type DismissibleElement, MixinDismissible, } from './mixins/mixin-dismissible/mixin-dismissible.js';
 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 { MixinPickerFeedback, type MixinPickerFeedbackInterface, } from './mixins/mixin-picker-feedback/mixin-picker-feedback.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';
@@ -51,7 +52,8 @@ 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 { ariaChord, type ChordPress, chordParts, matchesChord, printableChord, selectsAll, } from './utils/chord/chord.js';
+export { clamp } from './utils/clamp/clamp.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';
@@ -72,22 +74,28 @@ export { formatNumbers } from './utils/format-numbers/format-numbers.js';
 export { headingIn, headingsIn } from './utils/heading-in/heading-in.js';
 export { headingLevel } from './utils/heading-level/heading-level.js';
 export { type HostAria, hostAria } from './utils/host-aria/host-aria.js';
+export { hostWords } from './utils/host-words/host-words.js';
 export { defaultButton, submitImplicitly, submits, submitsOnEnter, } from './utils/implicit-submit/implicit-submit.js';
 export { type DisableableItem, forgetDisabled, inheritDisabled, } from './utils/inherit-disabled/inherit-disabled.js';
 export { inlineStep } from './utils/inline-step/inline-step.js';
 export { isRtl } from './utils/is-rtl/is-rtl.js';
 export { keyClaimed } from './utils/key-claimed/key-claimed.js';
 export { type Curve, linePath, type Point } from './utils/line-path/line-path.js';
+export { type EndInSight, endInSight } from './utils/load-more/load-more.js';
+export { localeOf } from './utils/locale-of/locale-of.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 { nameText } from './utils/name-text/name-text.js';
+export { nearest } from './utils/nearest/nearest.js';
+export { formatNumber, parseNumber, readingText } from './utils/number-format/number-format.js';
 export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
+export { applyOwnRule, type OwnRule } from './utils/own-rule/own-rule.js';
 export { plainClick } from './utils/plain-click/plain-click.js';
-export { appleTouch, onApple, type Platform } from './utils/platform/platform.js';
+export { appleTouch, onAndroid, onApple, type Platform } from './utils/platform/platform.js';
 export { pressType, type RecentPress } from './utils/press-type/press-type.js';
 export { rangeAdd } from './utils/range-add/range-add.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 { byRow, type Extremes, extremesOf, 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';
@@ -102,9 +110,10 @@ export { valueAt } from './utils/row-data/row-data.js';
 export { type Arranged, type Axis, arranged, cycle, type DataRow, filter, format, type Ordered, ordered, parse, type Sort, sort, window_, } from './utils/row-order/row-order.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 { type ScrollerOptions, type ScrollItemOptions, scrollItemIntoView, scrollingAncestor, } 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 { SlottedGlyph } from './utils/slotted-glyph/slotted-glyph.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';
@@ -112,10 +121,10 @@ 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 { type TreeArrow, type TreeArrowRow, treeArrow } from './utils/tree-arrow/tree-arrow.js';
-export { Typeahead, type TypeaheadBy, typeaheadBy, typesCharacter, } from './utils/typeahead/typeahead.js';
+export { Typeahead, type TypeaheadBy, typeaheadBy, typeaheadByWords, typesCharacter, } from './utils/typeahead/typeahead.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 { wordsConverter } from './utils/words-converter/words-converter.js';
 export { writeClock, writeTime } from './utils/write-time/write-time.js';
-export { commaList, pressedValue, prunedValue, type SelectionMode, toggleEvery, toggleValue, writtenList, writtenNumbers, } from './utils/written-list/written-list.js';
+export { anchorAt, commaList, everyState, inRowOrder, pressedValue, prunedValue, type SelectionMode, toggleEvery, toggleValue, writtenList, writtenNumbers, } from './utils/written-list/written-list.js';
 export { VERSION } from './version.js';