@fusion.dev/helix-core 0.215.2 → 0.216.0

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

@@ -0,0 +1,20 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import { type ControlKind } from '../../utils/controls/controls.js';
+/**
+ * Puts a control on the page's list of controls while it is connected, which
+ * is where a command palette finds it by its name and a shortcut overlay finds
+ * its keys.
+ *
+ * Joins in `hostConnected`, which a server never calls, so a server render
+ * lists nothing. `unlisted` on the control or around it leaves it off the list
+ * without taking it out of the registry, so the attribute can be set and
+ * cleared at any time.
+ */
+export declare class ListedController implements ReactiveController {
+    private readonly host;
+    private readonly kind;
+    private readonly keys?;
+    constructor(host: ReactiveControllerHost & HTMLElement, kind: ControlKind | (() => ControlKind), keys?: (() => string | null | undefined) | undefined);
+    hostConnected(): void;
+    hostDisconnected(): void;
+}

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

@@ -0,0 +1,19 @@
+import { registerControl, unregisterControl, } from '../../utils/controls/controls.js';
+export class ListedController {
+    constructor(host, kind, keys) {
+        this.host = host;
+        this.kind = kind;
+        this.keys = keys;
+        host.addController(this);
+    }
+    hostConnected() {
+        registerControl({
+            element: this.host,
+            keys: this.keys,
+            kind: typeof this.kind === 'function' ? this.kind() : this.kind,
+        });
+    }
+    hostDisconnected() {
+        unregisterControl(this.host);
+    }
+}

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

@@ -264,6 +264,11 @@ export declare class VirtualizeController implements ReactiveController {
      * last move is out of date.
      */
     scrolling(): boolean;
+    /**
+     * Whether a slotted row must stay assigned: the box is moving under a
+     * touch. Adding or taking a slotted row ends the touch on iOS.
+     */
+    holdsSlot(): boolean;
     /**
      * Takes the offset as the box's own where the box moved it up only because
      * the set below it got shorter, which the browser does to keep the offset
@@ -324,8 +329,10 @@ export declare class VirtualizeController implements ReactiveController {
      * Whether the rows already drawn are kept for now: the screen is touched, the
      * box is moving, and the rows drawn cover all of it.
      *
-     * Not in a waterfall, where an item measured moves the items under it and
-     * the host draws them again.
+     * A waterfall uses the same hold. Coverage is how far the drawn items reach
+     * down the set, the furthest of their ends, because an item yet to be drawn
+     * can start in a short column above the bottom of a tall one. Adding or
+     * taking a slotted row is what ends the touch.
      */
     private holds;
     /** The window with the rows `first` to `last`, and the spacers that stand in for the rest. */

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

@@ -132,6 +132,9 @@ export class VirtualizeController {
     scrolling() {
         return this.touching || this.resting !== undefined || this.scrolledNow() !== this.lastTop;
     }
+    holdsSlot() {
+        return this.touched && this.scrolling();
+    }
     noteClamp(box) {
         const was = this.lastTop;
         if (!this.touching &&
@@ -208,19 +211,24 @@ export class VirtualizeController {
         this.host.requestUpdate();
     }
     holds(box, total) {
-        if (!this.touched || !this.scrolling() || this.laned(total)) {
+        if (!this.touched || !this.scrolling()) {
             return false;
         }
         const { first, last, before } = this.window;
         if (last <= first || last > total) {
             return false;
         }
+        const top = this.scrolled(box);
+        const bottom = top + this.span(box);
+        const lanes = this.laned(total);
+        if (lanes) {
+            return top >= this.startOf(first, total) && bottom <= lanes.reachThrough(last - 1);
+        }
         const size = this.line();
         const drawn = this.measuring()
             ? this.startOf(last, total) - this.startOf(first, total)
             : (last - first) * size;
-        const top = this.scrolled(box);
-        return top >= before && top + this.span(box) <= before + drawn;
+        return top >= before && bottom <= before + drawn;
     }
     frame(first, last, total, size) {
         return this.measuring()

package/dist/controllers/virtualize-controller/waterfall.d.ts

@@ -43,6 +43,11 @@ export declare class Waterfall {
     lane(index: number): number;
     /** How long the set is, where its longest column ends. */
     length(): number;
+    /**
+     * How far down the set the items from the start through `index` reach: the
+     * furthest of their ends, which is the bottom of the columns they occupy.
+     */
+    reachThrough(index: number): number;
     /** The first item that reaches past `offset`, or the count where none does. */
     from(offset: number): number;
     /** The first item that starts at or past `offset`, so every item before it starts above. */

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

@@ -49,6 +49,9 @@ export class Waterfall {
     length() {
         return this.extent;
     }
+    reachThrough(index) {
+        return index < 0 ? 0 : (this.reach[index] ?? this.extent);
+    }
     from(offset) {
         return this.search(this.reach, offset);
     }

package/dist/events/before-listen.d.ts

@@ -0,0 +1,5 @@
+/** A field is about to start listening for dictation, and can be refused. */
+export declare class HelixBeforeListenEvent extends Event {
+    static readonly eventName = "helix-before-listen";
+    constructor();
+}

package/dist/events/before-listen.js

@@ -0,0 +1,10 @@
+export class HelixBeforeListenEvent extends Event {
+    static { this.eventName = 'helix-before-listen'; }
+    constructor() {
+        super(HelixBeforeListenEvent.eventName, {
+            bubbles: true,
+            cancelable: true,
+            composed: true,
+        });
+    }
+}

package/dist/events/details.d.ts

@@ -666,6 +666,11 @@ export interface CompleteDetail {
     /** What the control now holds, in full. */
     value: string;
 }
+/** Detail carried by `helix-listen`. */
+export interface ListenDetail {
+    /** The phrase the field settled on, as it went into the value. */
+    text: string;
+}
 /** What a shortcut reports when its chord is pressed. */
 export interface ShortcutDetail {
     /**

package/dist/events/events.d.ts

@@ -37,6 +37,7 @@ import { HelixBeforeChangeEvent } from './before-change.js';
 import { HelixBeforeCloseEvent } from './before-close.js';
 import { HelixBeforeCollapseEvent } from './before-collapse.js';
 import { HelixBeforeEditEvent } from './before-edit.js';
+import { HelixBeforeListenEvent } from './before-listen.js';
 import { HelixBeforeMoveEvent } from './before-move.js';
 import { HelixBeforeOpenEvent } from './before-open.js';
 import { HelixBeforePanelResizeEvent } from './before-panel-resize.js';
@@ -84,6 +85,7 @@ import { HelixGraphReadyEvent } from './graph-ready.js';
 import { HelixGraphSignalEvent } from './graph-signal.js';
 import { HelixGraphZoomEvent } from './graph-zoom.js';
 import { HelixHistoryEvent } from './history.js';
+import { HelixListenEvent } from './listen.js';
 import { HelixLoadEvent } from './load.js';
 import { HelixLoadMoreEvent } from './load-more.js';
 import { HelixMapClusterEvent } from './map-cluster.js';
@@ -137,9 +139,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, BandDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DeviceButton, DeviceButtonDetail, DeviceKeyDetail, DeviceScrollDetail, DeviceSwipeDetail, DeviceTapDetail, DeviceTextDetail, DeviceTouchDetail, DismissDetail, FacetDetail, FilterDetail, GraphFilterDetail, GraphLayoutDetail, GraphPartChangeDetail, GraphSignalDetail, MapClusterDetail, MapPanDetail, MapPartChangeDetail, MapRotateDetail, MapTiltDetail, MapZoomDetail, MoveDetail, NavigateDetail, OpenDetail, PasteDetail, PlotChangeDetail, PlotTurnDetail, PressDetail, PressPointerType, RangeDetail, ReadDetail, ReadingDetail, ReconnectDetail, Refusal, RefusedFile, RejectDetail, RelabelDetail, RemoveDetail, ReorderDetail, ResizeDetail, ScrolledDetail, SelectDetail, SendDetail, ShortcutDetail, SkipDetail, SortDetail, StrandsFallbackDetail, TerminalInputDetail, TerminalLinkDetail, TerminalResizeDetail, TerminalTitleDetail, ToggleDetail, TourAskDetail, TourStatusDetail, TypingDetail, ViewportPanDetail, ViewportZoomDetail, } from './details.js';
+export type { ActivateDetail, AuraFallbackDetail, BandDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DeviceButton, DeviceButtonDetail, DeviceKeyDetail, DeviceScrollDetail, DeviceSwipeDetail, DeviceTapDetail, DeviceTextDetail, DeviceTouchDetail, DismissDetail, FacetDetail, FilterDetail, GraphFilterDetail, GraphLayoutDetail, GraphPartChangeDetail, GraphSignalDetail, ListenDetail, MapClusterDetail, MapPanDetail, MapPartChangeDetail, MapRotateDetail, MapTiltDetail, MapZoomDetail, MoveDetail, NavigateDetail, OpenDetail, PasteDetail, PlotChangeDetail, PlotTurnDetail, PressDetail, PressPointerType, RangeDetail, ReadDetail, ReadingDetail, ReconnectDetail, Refusal, RefusedFile, RejectDetail, RelabelDetail, RemoveDetail, ReorderDetail, ResizeDetail, ScrolledDetail, SelectDetail, SendDetail, ShortcutDetail, SkipDetail, SortDetail, StrandsFallbackDetail, TerminalInputDetail, TerminalLinkDetail, TerminalResizeDetail, TerminalTitleDetail, ToggleDetail, TourAskDetail, TourStatusDetail, TypingDetail, ViewportPanDetail, ViewportZoomDetail, } from './details.js';
 export { helixEventNames } from './names.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDeviceButtonEvent, HelixDeviceKeyEvent, HelixDeviceScreenshotEvent, HelixDeviceScrollEvent, HelixDeviceSwipeEvent, HelixDeviceTapEvent, HelixDeviceTextEvent, HelixDeviceTouchEvent, 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, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeListenEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDeviceButtonEvent, HelixDeviceKeyEvent, HelixDeviceScreenshotEvent, HelixDeviceScrollEvent, HelixDeviceSwipeEvent, HelixDeviceTapEvent, HelixDeviceTextEvent, HelixDeviceTouchEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixListenEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, 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`.
@@ -162,6 +164,7 @@ declare const registry: {
     readonly HelixBeforeCloseEvent: typeof HelixBeforeCloseEvent;
     readonly HelixBeforeCollapseEvent: typeof HelixBeforeCollapseEvent;
     readonly HelixBeforeEditEvent: typeof HelixBeforeEditEvent;
+    readonly HelixBeforeListenEvent: typeof HelixBeforeListenEvent;
     readonly HelixBeforeMoveEvent: typeof HelixBeforeMoveEvent;
     readonly HelixBeforeOpenEvent: typeof HelixBeforeOpenEvent;
     readonly HelixBeforePanelResizeEvent: typeof HelixBeforePanelResizeEvent;
@@ -209,6 +212,7 @@ declare const registry: {
     readonly HelixGraphSignalEvent: typeof HelixGraphSignalEvent;
     readonly HelixGraphZoomEvent: typeof HelixGraphZoomEvent;
     readonly HelixHistoryEvent: typeof HelixHistoryEvent;
+    readonly HelixListenEvent: typeof HelixListenEvent;
     readonly HelixLoadEvent: typeof HelixLoadEvent;
     readonly HelixLoadMoreEvent: typeof HelixLoadMoreEvent;
     readonly HelixMapClusterEvent: typeof HelixMapClusterEvent;

package/dist/events/events.js

@@ -7,6 +7,7 @@ import { HelixBeforeChangeEvent } from './before-change.js';
 import { HelixBeforeCloseEvent } from './before-close.js';
 import { HelixBeforeCollapseEvent } from './before-collapse.js';
 import { HelixBeforeEditEvent } from './before-edit.js';
+import { HelixBeforeListenEvent } from './before-listen.js';
 import { HelixBeforeMoveEvent } from './before-move.js';
 import { HelixBeforeOpenEvent } from './before-open.js';
 import { HelixBeforePanelResizeEvent } from './before-panel-resize.js';
@@ -54,6 +55,7 @@ import { HelixGraphReadyEvent } from './graph-ready.js';
 import { HelixGraphSignalEvent } from './graph-signal.js';
 import { HelixGraphZoomEvent } from './graph-zoom.js';
 import { HelixHistoryEvent } from './history.js';
+import { HelixListenEvent } from './listen.js';
 import { HelixLoadEvent } from './load.js';
 import { HelixLoadMoreEvent } from './load-more.js';
 import { HelixMapClusterEvent } from './map-cluster.js';
@@ -108,7 +110,7 @@ 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, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDeviceButtonEvent, HelixDeviceKeyEvent, HelixDeviceScreenshotEvent, HelixDeviceScrollEvent, HelixDeviceSwipeEvent, HelixDeviceTapEvent, HelixDeviceTextEvent, HelixDeviceTouchEvent, 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, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeListenEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDeviceButtonEvent, HelixDeviceKeyEvent, HelixDeviceScreenshotEvent, HelixDeviceScrollEvent, HelixDeviceSwipeEvent, HelixDeviceTapEvent, HelixDeviceTextEvent, HelixDeviceTouchEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixListenEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
 const registry = {
     HelixActionEvent,
     HelixActivateEvent,
@@ -119,6 +121,7 @@ const registry = {
     HelixBeforeCloseEvent,
     HelixBeforeCollapseEvent,
     HelixBeforeEditEvent,
+    HelixBeforeListenEvent,
     HelixBeforeMoveEvent,
     HelixBeforeOpenEvent,
     HelixBeforePanelResizeEvent,
@@ -166,6 +169,7 @@ const registry = {
     HelixGraphSignalEvent,
     HelixGraphZoomEvent,
     HelixHistoryEvent,
+    HelixListenEvent,
     HelixLoadEvent,
     HelixLoadMoreEvent,
     HelixMapClusterEvent,

package/dist/events/listen.d.ts

@@ -0,0 +1,11 @@
+import type { ListenDetail } from './details.js';
+/**
+ * A field settled on a phrase it heard and put it in its value.
+ *
+ * Sent after the field's own `input`, for a page that keeps what was said
+ * apart from what was typed.
+ */
+export declare class HelixListenEvent extends CustomEvent<ListenDetail> {
+    static readonly eventName = "helix-listen";
+    constructor(detail: ListenDetail);
+}

package/dist/events/listen.js

@@ -0,0 +1,10 @@
+export class HelixListenEvent extends CustomEvent {
+    static { this.eventName = 'helix-listen'; }
+    constructor(detail) {
+        super(HelixListenEvent.eventName, {
+            bubbles: true,
+            composed: true,
+            detail,
+        });
+    }
+}

package/dist/events/names.js

@@ -1,11 +1,11 @@
 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-paste before-pin ' +
+    'before-collapse before-edit before-listen before-move before-open before-panel-resize before-paste before-pin ' +
     'before-reconnect before-relabel before-reorder before-resize before-split before-toggle ' +
     'canvas-edit canvas-pan canvas-view canvas-zoom caret clear collapse complete ' +
     'connect console copy copy-error create device-button device-key device-screenshot ' +
     'device-scroll device-swipe device-tap device-text device-touch 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 ' +
+    'graph-signal graph-zoom history listen load load-more map-cluster map-pan map-part-change ' +
     'map-ready map-rotate map-tilt map-zoom move navigate next panel-resize pasted pin plot-change ' +
     'plot-turn press ' +
     'preview previous range-change read reading-change reading-press reconnect reject ' +

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

@@ -1,6 +1,7 @@
 import { LitElement, unsafeCSS } from 'lit';
 import { measuring, reportRender } from '../utils/report-render/report-render.js';
 import { noteVersion, reportUsage } from '../utils/report-usage/report-usage.js';
+import { exposeStateIfAsked } from '../utils/state/state.js';
 import { applyReactProperties, bindReactHandler, lookForReact } from './react-bridge.js';
 const BOX_SIZING = '*,::before,::after{box-sizing:border-box}';
 const HIDDEN = ":host([hidden]:not([hidden='until-found'])){display:none}";
@@ -127,3 +128,4 @@ export const whenHydrated = (element, write) => {
     }
 };
 noteVersion();
+exposeStateIfAsked();

package/dist/helix-element/mark-rules.d.ts

@@ -60,6 +60,31 @@ export declare const SCROLLER_RULE = "[data-scroller]{overflow:auto}";
  * where they belong, so anchoring has nothing left to do here but move them.
  */
 export declare const VIRTUAL_RULE = "[data-virtual]{overflow-anchor:none}";
+/**
+ * Two layers drawn in one place, one exactly over the other, which a
+ * component marks `data-layers`: Code Input draws its highlighted text under a
+ * `<textarea>` whose own text is transparent, so the reader types in the
+ * platform's field and sees the colors.
+ *
+ * **Every layer takes the same box and the same text metrics**, or the caret
+ * drifts off the letters it sits between: one grid cell, no margin, border or
+ * padding of a layer's own, and the font, spacing and tab stops of the box
+ * around them. Lines keep their length, or wrap the way a soft-wrapped
+ * `<textarea>` does where the box is marked `data-wrap`. The box grows with
+ * the layer under the text, and the field fills it and never scrolls by
+ * itself: whatever holds the box scrolls both.
+ *
+ * **Named by the layer under the text, `aria-hidden`, and the `<textarea>`**,
+ * which outranks the `[part]` rule a field's sheet resets its control with:
+ * its `all: unset` took the textarea out of the cell and gave it the field's
+ * face, a row below the text and in another font.
+ *
+ * The placeholder keeps its own color, which a transparent fill would take.
+ * The caret takes the page's text color here, at no specificity, so a sheet
+ * names its own. Everything else is the mechanism, and a sheet that unsets
+ * the field's styles does not undo it.
+ */
+export declare const LAYERS_RULE: string;
 /**
  * Words a screen reader reads where the eye reads something else, which a
  * component marks `data-spoken`: `⇧⌘P` in Kbd is read as `Shift Command P`.

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

@@ -1,5 +1,12 @@
 export const SCROLLER_RULE = '[data-scroller]{overflow:auto}';
 export const VIRTUAL_RULE = '[data-virtual]{overflow-anchor:none}';
+export const LAYERS_RULE = '[data-layers]{display:grid}' +
+    '[data-layers]>[aria-hidden],[data-layers]>textarea{grid-area:1/1;box-sizing:border-box;margin:0;border:0;padding:0;min-inline-size:0;font:inherit;letter-spacing:inherit;line-height:inherit;tab-size:inherit;white-space:pre;overflow-wrap:normal}' +
+    '[data-layers][data-wrap]>[aria-hidden],[data-layers][data-wrap]>textarea{white-space:pre-wrap;overflow-wrap:break-word}' +
+    '[data-layers]>[aria-hidden]{pointer-events:none;user-select:none}' +
+    '[data-layers]>textarea{inline-size:100%;block-size:100%;overflow:hidden;resize:none;background:none;color:transparent;-webkit-text-fill-color:transparent}' +
+    '[data-layers]>textarea::placeholder{-webkit-text-fill-color:currentColor}' +
+    ':where([data-layers])>textarea{caret-color:CanvasText}';
 export const SPOKEN_RULE = '[data-spoken]{position:absolute;inline-size:1px;block-size:1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap}';
 export const MIRROR_RULE = ':host(:dir(rtl)) [data-mirror]{scale:-1 1}';
 export const TOUCHES_RULE = '[data-touches]{touch-action:none}';

package/dist/index.d.ts

@@ -22,6 +22,7 @@ export { HostClickController } from './controllers/host-click-controller/host-cl
 export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, type IndicatorOptions, } from './controllers/indicator-controller/indicator-controller.js';
 export { type FocusItemOptions, focusItemOf, KeyboardNavigationController, type KeyboardNavigationOptions, type KeyboardOrigin, type NavigableItem, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
+export { ListedController } from './controllers/listed-controller/listed-controller.js';
 export { MediaSessionController, type SessionHandlers, SKIP_SECONDS, } from './controllers/media-session-controller/media-session-controller.js';
 export { animationsFinished, animationsSettled, type OpenPhase, OpenPhaseController, type OpenPhaseOptions, } from './controllers/open-phase-controller/open-phase-controller.js';
 export { OptionWindowController, type OptionWindowOptions, } from './controllers/option-window-controller/option-window-controller.js';
@@ -40,9 +41,9 @@ export { UpgradeController, type UpgradeOptions, } from './controllers/upgrade-c
 export { type Rendered, VirtualizeController, type VirtualizeOptions, type Window as VirtualizeWindow, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { Waterfall } from './controllers/virtualize-controller/waterfall.js';
 export { eventsForTag, registerElementEvents } from './events/element-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 DeviceButton, type DeviceButtonDetail, type DeviceKeyDetail, type DeviceScrollDetail, type DeviceSwipeDetail, type DeviceTapDetail, type DeviceTextDetail, type DeviceTouchDetail, 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, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDeviceButtonEvent, HelixDeviceKeyEvent, HelixDeviceScreenshotEvent, HelixDeviceScrollEvent, HelixDeviceSwipeEvent, HelixDeviceTapEvent, HelixDeviceTextEvent, HelixDeviceTouchEvent, 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, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type PasteDetail, type PlotChangeDetail, type PlotTurnDetail, type PressDetail, type PressPointerType, type RangeDetail, type ReadDetail, type ReadingDetail, type ReconnectDetail, type Refusal, type RefusedFile, type RejectDetail, type RelabelDetail, type RemoveDetail, type ReorderDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type StrandsFallbackDetail, type TerminalInputDetail, type TerminalLinkDetail, type TerminalResizeDetail, type TerminalTitleDetail, 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 DeviceButton, type DeviceButtonDetail, type DeviceKeyDetail, type DeviceScrollDetail, type DeviceSwipeDetail, type DeviceTapDetail, type DeviceTextDetail, type DeviceTouchDetail, type DismissDetail, type FacetDetail, type FilterDetail, type GraphFilterDetail, type GraphLayoutDetail, type GraphPartChangeDetail, type GraphSignalDetail, HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeListenEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDeviceButtonEvent, HelixDeviceKeyEvent, HelixDeviceScreenshotEvent, HelixDeviceScrollEvent, HelixDeviceSwipeEvent, HelixDeviceTapEvent, HelixDeviceTextEvent, HelixDeviceTouchEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixListenEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, type ListenDetail, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type PasteDetail, type PlotChangeDetail, type PlotTurnDetail, type PressDetail, type PressPointerType, type RangeDetail, type ReadDetail, type ReadingDetail, type ReconnectDetail, type Refusal, type RefusedFile, type RejectDetail, type RelabelDetail, type RemoveDetail, type ReorderDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type StrandsFallbackDetail, type TerminalInputDetail, type TerminalLinkDetail, type TerminalResizeDetail, type TerminalTitleDetail, type ToggleDetail, type TourStatusDetail, type TypingDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
-export { MIRROR_RULE, SCROLLER_RULE, SPOKEN_RULE, TOUCHES_RULE, VIRTUAL_RULE, } from './helix-element/mark-rules.js';
+export { LAYERS_RULE, MIRROR_RULE, SCROLLER_RULE, SPOKEN_RULE, TOUCHES_RULE, VIRTUAL_RULE, } from './helix-element/mark-rules.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { HelixFormElementBase } from './helix-form-element/helix-form-element-base.js';
 export { MixinChartSource, type MixinChartSourceInterface, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, POSITION_LABEL, READINGS_PAGE, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';
@@ -61,6 +62,7 @@ export { MixinSegmentedField, type MixinSegmentedFieldInterface, } from './mixin
 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 ViewportControlAxes, type ViewportControlsPlacement, type ViewportElement, type ViewportGestureLabels, type ViewportGestureMode, type ViewportGestures, type ViewportWay, } from './mixins/mixin-viewport/mixin-viewport.js';
+export { MixinVoice, type VoiceElement } from './mixins/mixin-voice/mixin-voice.js';
 export { anchorElement } from './utils/anchor-element/anchor-element.js';
 export { arrowReach, sideOf } from './utils/arrow/arrow.js';
 export { assignSlot, assignSlots } from './utils/assign-slots/assign-slots.js';
@@ -80,6 +82,7 @@ export { closestName } from './utils/closest-name/closest-name.js';
 export { type ColorWords, colorName, hueName } from './utils/color-name/color-name.js';
 export { columnStep } from './utils/column-step/column-step.js';
 export { contextBudget, type Holder, LIVE, pageBudget, } from './utils/context-budget/context-budget.js';
+export { type ControlEntry, type ControlKind, chordOfAria, controlName, controlReachable, type ListedControl, listControls, listShortcuts, registerControl, registerShortcut, runControl, type ShortcutEntry, unregisterControl, } from './utils/controls/controls.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, toHsl, toOklch, toRgb, } from './utils/css-color/css-color.js';
@@ -154,7 +157,10 @@ export { lockScroll, scrollHolders, unlockScroll } from './utils/scroll-lock/scr
 export { slotFilled, slotNamed } 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 { ChartSound, HIGH, LOW, panOf, pitchOf, type Sound, type SoundSeries, sweepPlan, TIMBRES, } from './utils/sonify/sonify.js';
+export { browserSpeech, pageSpeechEngine, registerSpeechEngine, type SpeechEngine, type SpeechListener, type SpeechSession, } from './utils/speech/speech.js';
 export { splitValues } from './utils/split-values/split-values.js';
+export { captureState, type ElementState, elementAt, exposeState, type PageState, pathOf, type RestoreReport, restoreOn, restoreState, STATE_SLOT, snapshotOf, } from './utils/state/state.js';
 export { stopPress } from './utils/stop-press/stop-press.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';

package/dist/index.js

@@ -22,6 +22,7 @@ export { HostClickController } from './controllers/host-click-controller/host-cl
 export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, } from './controllers/indicator-controller/indicator-controller.js';
 export { focusItemOf, KeyboardNavigationController, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
+export { ListedController } from './controllers/listed-controller/listed-controller.js';
 export { MediaSessionController, SKIP_SECONDS, } from './controllers/media-session-controller/media-session-controller.js';
 export { animationsFinished, animationsSettled, OpenPhaseController, } from './controllers/open-phase-controller/open-phase-controller.js';
 export { OptionWindowController, } from './controllers/option-window-controller/option-window-controller.js';
@@ -40,9 +41,9 @@ export { UpgradeController, } from './controllers/upgrade-controller/upgrade-con
 export { VirtualizeController, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { Waterfall } from './controllers/virtualize-controller/waterfall.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDeviceButtonEvent, HelixDeviceKeyEvent, HelixDeviceScreenshotEvent, HelixDeviceScrollEvent, HelixDeviceSwipeEvent, HelixDeviceTapEvent, HelixDeviceTextEvent, HelixDeviceTouchEvent, 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, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, } from './events/events.js';
+export { HelixActionEvent, HelixActivateEvent, HelixAuraFallbackEvent, HelixBandEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeListenEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePasteEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeReorderEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixClearEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyErrorEvent, HelixCopyEvent, HelixCreateEvent, HelixDeviceButtonEvent, HelixDeviceKeyEvent, HelixDeviceScreenshotEvent, HelixDeviceScrollEvent, HelixDeviceSwipeEvent, HelixDeviceTapEvent, HelixDeviceTextEvent, HelixDeviceTouchEvent, HelixDismissEvent, HelixEditEvent, HelixEndEvent, HelixExpandEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixListenEvent, HelixLoadEvent, HelixLoadMoreEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPanelResizeEvent, HelixPastedEvent, HelixPinEvent, HelixPlotChangeEvent, HelixPlotTurnEvent, HelixPressEvent, HelixPreviewEvent, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReadingChangeEvent, HelixReadingPressEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
-export { MIRROR_RULE, SCROLLER_RULE, SPOKEN_RULE, TOUCHES_RULE, VIRTUAL_RULE, } from './helix-element/mark-rules.js';
+export { LAYERS_RULE, MIRROR_RULE, SCROLLER_RULE, SPOKEN_RULE, TOUCHES_RULE, VIRTUAL_RULE, } from './helix-element/mark-rules.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { HelixFormElementBase } from './helix-form-element/helix-form-element-base.js';
 export { MixinChartSource, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, POSITION_LABEL, READINGS_PAGE, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';
@@ -61,6 +62,7 @@ export { MixinSegmentedField, } from './mixins/mixin-segmented-field/mixin-segme
 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 { MixinVoice } from './mixins/mixin-voice/mixin-voice.js';
 export { anchorElement } from './utils/anchor-element/anchor-element.js';
 export { arrowReach, sideOf } from './utils/arrow/arrow.js';
 export { assignSlot, assignSlots } from './utils/assign-slots/assign-slots.js';
@@ -80,6 +82,7 @@ export { closestName } from './utils/closest-name/closest-name.js';
 export { colorName, hueName } from './utils/color-name/color-name.js';
 export { columnStep } from './utils/column-step/column-step.js';
 export { contextBudget, LIVE, pageBudget, } from './utils/context-budget/context-budget.js';
+export { chordOfAria, controlName, controlReachable, listControls, listShortcuts, registerControl, registerShortcut, runControl, unregisterControl, } from './utils/controls/controls.js';
 export { countLabel } from './utils/count-label/count-label.js';
 export { createSheet } from './utils/create-sheet/create-sheet.js';
 export { formatColor, parseColor, toCss, toHsl, toOklch, toRgb, } from './utils/css-color/css-color.js';
@@ -154,7 +157,10 @@ export { lockScroll, scrollHolders, unlockScroll } from './utils/scroll-lock/scr
 export { slotFilled, slotNamed } 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 { ChartSound, HIGH, LOW, panOf, pitchOf, sweepPlan, TIMBRES, } from './utils/sonify/sonify.js';
+export { browserSpeech, pageSpeechEngine, registerSpeechEngine, } from './utils/speech/speech.js';
 export { splitValues } from './utils/split-values/split-values.js';
+export { captureState, elementAt, exposeState, pathOf, restoreOn, restoreState, STATE_SLOT, snapshotOf, } from './utils/state/state.js';
 export { stopPress } from './utils/stop-press/stop-press.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';

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

@@ -224,6 +224,28 @@ export declare class MixinChartSourceInterface {
      * `data`: there is then no table on the page to read. Nothing otherwise.
      */
     protected renderTable(): TemplateResult | typeof nothing;
+    /**
+     * Draws a Listen button that plays the chart as sound, and plays each
+     * reading's tone as the arrow keys step to it. L plays it too while the
+     * chart has focus, and Escape stops it.
+     */
+    sonify: boolean;
+    /** How long each series takes to play, in milliseconds or as `3s`. */
+    sonifyDuration: number;
+    /** The Listen button's words. */
+    sonifyLabel: string;
+    /** The Listen button's words while the chart plays. */
+    sonifyStopLabel: string;
+    /** Whether the chart is playing as sound now. */
+    get sounding(): boolean;
+    /** `visible` draws the chart's text summary under it, as one line, and `hidden`, as absent does, gives it to a screen reader alone. */
+    summary?: 'hidden' | 'visible';
+    /** Plays every shown series as sound, one after another, and resolves when it ends or is stopped. */
+    playReadings(): Promise<void>;
+    /** Stops the sound. */
+    stopReadings(): void;
+    /** The Listen button, under `sonify`, behind a seam a chart places. */
+    protected renderSonify(): TemplateResult | typeof nothing;
 }
 /**
  * How many readings the table drawn from `data` holds at once.