@fusion.dev/helix-core 0.144.0 → 0.145.0

package/dist/events/events.d.ts

@@ -827,6 +827,17 @@ export declare class HelixBeforeSplitEvent extends CustomEvent<ChangeDetail> {
     static readonly eventName = "helix-before-split";
     constructor(detail: ChangeDetail);
 }
+/**
+ * The divider between a sandbox's panes settled somewhere new.
+ *
+ * The notification half of `helix-before-split`, sent once `split` has moved,
+ * with the lead pane's new share. Not cancelable: the decision was the
+ * request's.
+ */
+export declare class HelixSplitEvent extends CustomEvent<ChangeDetail> {
+    static readonly eventName = "helix-split";
+    constructor(detail: ChangeDetail);
+}
 /**
  * A sandbox's panel is about to change height, and can be refused.
  *
@@ -839,6 +850,17 @@ export declare class HelixBeforePanelResizeEvent extends CustomEvent<ChangeDetai
     static readonly eventName = "helix-before-panel-resize";
     constructor(detail: ChangeDetail);
 }
+/**
+ * A sandbox's panel settled at a new height.
+ *
+ * The notification half of `helix-before-panel-resize`, sent once `panelSize`
+ * has moved, with the height in pixels. Not cancelable: the decision was the
+ * request's.
+ */
+export declare class HelixPanelResizeEvent extends CustomEvent<ChangeDetail> {
+    static readonly eventName = "helix-panel-resize";
+    constructor(detail: ChangeDetail);
+}
 /** A pane is about to collapse or reopen, and can be refused. */
 export declare class HelixBeforeCollapseEvent extends CustomEvent<ChangeDetail> {
     static readonly eventName = "helix-before-collapse";
@@ -860,6 +882,17 @@ export declare class HelixBeforeEditEvent extends CustomEvent<ChangeDetail> {
     static readonly eventName = "helix-before-edit";
     constructor(detail: ChangeDetail);
 }
+/**
+ * Source was edited.
+ *
+ * The notification half of `helix-before-edit`, sent once the pane holds the
+ * new source, with that source. Not cancelable: the decision was the
+ * request's.
+ */
+export declare class HelixEditEvent extends CustomEvent<ChangeDetail> {
+    static readonly eventName = "helix-edit";
+    constructor(detail: ChangeDetail);
+}
 /**
  * A value is about to change, and the change can be refused.
  *
@@ -942,6 +975,145 @@ export declare class HelixCreateEvent extends CustomEvent<CreateDetail> {
     static readonly eventName = "helix-create";
     constructor(detail: CreateDetail);
 }
+/** Detail carried by `helix-aura-fallback`. */
+export interface AuraFallbackDetail {
+    /**
+     * Why the gradient shows: `software` for a renderer that draws on the CPU,
+     * `unavailable` for no WebGL or a shader the browser refused, and `lost` for
+     * a context the browser took back, on a GPU reset or past its limit of about
+     * sixteen.
+     */
+    reason: 'lost' | 'software' | 'unavailable';
+}
+/**
+ * An aura stopped drawing its shader and shows its gradient, and says why.
+ *
+ * Sent each time it falls back, from the aura, which then matches
+ * `:state(fallback)` until it draws again. Not cancelable: there is nothing
+ * left to refuse.
+ */
+export declare class HelixAuraFallbackEvent extends CustomEvent<AuraFallbackDetail> {
+    static readonly eventName = "helix-aura-fallback";
+    constructor(detail: AuraFallbackDetail);
+}
+/**
+ * A reader cleared the value: an input's clear button emptied the field, or a
+ * clearable rating went back to unrated.
+ *
+ * Sent after the value is cleared, and after the `input` and `change` the
+ * clear sends. Carries nothing, because the value is the cleared one.
+ */
+export declare class HelixClearEvent extends Event {
+    static readonly eventName = "helix-clear";
+    constructor();
+}
+/**
+ * A press put nothing on the clipboard: the browser did not allow the write,
+ * such as on a page without the clipboard permission, or there was nothing to
+ * copy.
+ */
+export declare class HelixCopyErrorEvent extends Event {
+    static readonly eventName = "helix-copy-error";
+    constructor();
+}
+/**
+ * A reader asked for more items: a feed's or a table's `load-more` button, or
+ * a list scrolled near its end. Append them, and set `loading` while they are
+ * on their way.
+ *
+ * Carries nothing, because what comes next is the consumer's to know. Not
+ * cancelable: nothing is loaded until the consumer loads it.
+ */
+export declare class HelixLoadMoreEvent extends Event {
+    static readonly eventName = "helix-load-more";
+    constructor();
+}
+/**
+ * A lazy branch opened and asks for its children: a tree item with `lazy`.
+ * Sent from the item, so `target` is the branch to fill.
+ *
+ * Carries nothing, because the children are the consumer's to fetch. Not
+ * cancelable: the branch is already open, and says it is busy until children
+ * arrive.
+ */
+export declare class HelixLoadEvent extends Event {
+    static readonly eventName = "helix-load";
+    constructor();
+}
+/** Detail carried by `helix-range-change`. */
+export interface RangeDetail {
+    /** The index of the first item on screen. */
+    first: number;
+    /** One past the index of the last item on screen. */
+    last: number;
+}
+/**
+ * The items on screen changed: a virtual list was scrolled or resized, or its
+ * items changed. Carries the new range, which the list's `range` also holds.
+ * Not cancelable: the list has already moved.
+ */
+export declare class HelixRangeChangeEvent extends CustomEvent<RangeDetail> {
+    static readonly eventName = "helix-range-change";
+    constructor(detail: RangeDetail);
+}
+/**
+ * Rows opened or closed in place: a data table's tree of rows. Carries every
+ * open row's key, separated by commas, which the table's `expanded` also
+ * holds. Not cancelable: the rows have already moved.
+ */
+export declare class HelixExpandEvent extends CustomEvent<ChangeDetail> {
+    static readonly eventName = "helix-expand";
+    constructor(detail: ChangeDetail);
+}
+/**
+ * A sequence played to its last entry and stopped there: a video playlist
+ * with no `repeat`. Carries nothing, because the playlist still holds the last
+ * entry. Not cancelable: playback has already ended.
+ */
+export declare class HelixEndEvent extends Event {
+    static readonly eventName = "helix-end";
+    constructor();
+}
+/** Detail carried by `helix-typing`. */
+export interface TypingDetail {
+    /** Whether the user is writing now, as a boolean and not a word that reads like one. */
+    typing: boolean;
+}
+/**
+ * The user started or stopped writing: a chat composer, for a typing
+ * indicator on the other side. Carries which, as the composer's `typing` does.
+ * Not cancelable: it reports what the user did.
+ */
+export declare class HelixTypingEvent extends CustomEvent<TypingDetail> {
+    static readonly eventName = "helix-typing";
+    constructor(detail: TypingDetail);
+}
+/**
+ * A reader acted on a row: Enter on a list row, or a press in a list that
+ * selects nothing. Sent from the row, so `target` is the row acted on.
+ *
+ * Carries nothing, because the row is the whole of the answer. Not cancelable:
+ * a row with a link follows it and sends nothing, so there is no default left
+ * to refuse.
+ */
+export declare class HelixActionEvent extends Event {
+    static readonly eventName = "helix-action";
+    constructor();
+}
+/**
+ * A checked state changed after `helix-before-toggle` let it: a map layer
+ * shown or hidden from the layers menu. Sent from what changed, with the state
+ * it now holds.
+ *
+ * **Not the native `toggle`.** That one is a `ToggleEvent` saying a popover or
+ * a `<details>` opened or closed, with `newState` of `open` or `closed`, and a
+ * layer shown on a map is neither: it is the request's own verb without
+ * `before`, carrying the same `checked` the request did.
+ */
+export declare class HelixToggleEvent extends CustomEvent<ToggleDetail> {
+    static readonly eventName = "helix-toggle";
+    constructor(detail: ToggleDetail);
+}
 /** Detail carried by `helix-copy`. */
 export interface CopyDetail {
     /** What was put on the clipboard. */
@@ -1319,7 +1491,9 @@ export declare class HelixHistoryEvent extends CustomEvent<Record<string, never>
  * forgotten.
  */
 declare const registry: {
+    readonly HelixActionEvent: typeof HelixActionEvent;
     readonly HelixActivateEvent: typeof HelixActivateEvent;
+    readonly HelixAuraFallbackEvent: typeof HelixAuraFallbackEvent;
     readonly HelixBeforeActivateEvent: typeof HelixBeforeActivateEvent;
     readonly HelixBeforeChangeEvent: typeof HelixBeforeChangeEvent;
     readonly HelixBeforeCloseEvent: typeof HelixBeforeCloseEvent;
@@ -1339,13 +1513,18 @@ declare const registry: {
     readonly HelixCanvasViewEvent: typeof HelixCanvasViewEvent;
     readonly HelixCanvasZoomEvent: typeof HelixCanvasZoomEvent;
     readonly HelixCaretEvent: typeof HelixCaretEvent;
+    readonly HelixClearEvent: typeof HelixClearEvent;
     readonly HelixCollapseEvent: typeof HelixCollapseEvent;
     readonly HelixCompleteEvent: typeof HelixCompleteEvent;
     readonly HelixConnectEvent: typeof HelixConnectEvent;
     readonly HelixConsoleEvent: typeof HelixConsoleEvent;
+    readonly HelixCopyErrorEvent: typeof HelixCopyErrorEvent;
     readonly HelixCopyEvent: typeof HelixCopyEvent;
     readonly HelixCreateEvent: typeof HelixCreateEvent;
     readonly HelixDismissEvent: typeof HelixDismissEvent;
+    readonly HelixEditEvent: typeof HelixEditEvent;
+    readonly HelixEndEvent: typeof HelixEndEvent;
+    readonly HelixExpandEvent: typeof HelixExpandEvent;
     readonly HelixFacetEvent: typeof HelixFacetEvent;
     readonly HelixFilterEvent: typeof HelixFilterEvent;
     readonly HelixFilteredEvent: typeof HelixFilteredEvent;
@@ -1357,6 +1536,8 @@ declare const registry: {
     readonly HelixGraphSignalEvent: typeof HelixGraphSignalEvent;
     readonly HelixGraphZoomEvent: typeof HelixGraphZoomEvent;
     readonly HelixHistoryEvent: typeof HelixHistoryEvent;
+    readonly HelixLoadEvent: typeof HelixLoadEvent;
+    readonly HelixLoadMoreEvent: typeof HelixLoadMoreEvent;
     readonly HelixMapClusterEvent: typeof HelixMapClusterEvent;
     readonly HelixMapPanEvent: typeof HelixMapPanEvent;
     readonly HelixMapPartChangeEvent: typeof HelixMapPartChangeEvent;
@@ -1367,8 +1548,10 @@ declare const registry: {
     readonly HelixMoveEvent: typeof HelixMoveEvent;
     readonly HelixNavigateEvent: typeof HelixNavigateEvent;
     readonly HelixNextEvent: typeof HelixNextEvent;
+    readonly HelixPanelResizeEvent: typeof HelixPanelResizeEvent;
     readonly HelixPinEvent: typeof HelixPinEvent;
     readonly HelixPreviousEvent: typeof HelixPreviousEvent;
+    readonly HelixRangeChangeEvent: typeof HelixRangeChangeEvent;
     readonly HelixReadEvent: typeof HelixReadEvent;
     readonly HelixReconnectEvent: typeof HelixReconnectEvent;
     readonly HelixRejectEvent: typeof HelixRejectEvent;
@@ -1387,7 +1570,10 @@ declare const registry: {
     readonly HelixShortcutEvent: typeof HelixShortcutEvent;
     readonly HelixSortEvent: typeof HelixSortEvent;
     readonly HelixSortedEvent: typeof HelixSortedEvent;
+    readonly HelixSplitEvent: typeof HelixSplitEvent;
+    readonly HelixToggleEvent: typeof HelixToggleEvent;
     readonly HelixTourAskEvent: typeof HelixTourAskEvent;
+    readonly HelixTypingEvent: typeof HelixTypingEvent;
 };
 /**
  * Every name this library dispatches.

package/dist/events/events.js

@@ -440,6 +440,17 @@ export class HelixBeforeSplitEvent extends CustomEvent {
         });
     }
 }
+export class HelixSplitEvent extends CustomEvent {
+    static { this.eventName = 'helix-split'; }
+    constructor(detail) {
+        super(HelixSplitEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
 export class HelixBeforePanelResizeEvent extends CustomEvent {
     static { this.eventName = 'helix-before-panel-resize'; }
     constructor(detail) {
@@ -451,6 +462,17 @@ export class HelixBeforePanelResizeEvent extends CustomEvent {
         });
     }
 }
+export class HelixPanelResizeEvent extends CustomEvent {
+    static { this.eventName = 'helix-panel-resize'; }
+    constructor(detail) {
+        super(HelixPanelResizeEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
 export class HelixBeforeCollapseEvent extends CustomEvent {
     static { this.eventName = 'helix-before-collapse'; }
     constructor(detail) {
@@ -484,6 +506,17 @@ export class HelixBeforeEditEvent extends CustomEvent {
         });
     }
 }
+export class HelixEditEvent extends CustomEvent {
+    static { this.eventName = 'helix-edit'; }
+    constructor(detail) {
+        super(HelixEditEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
 export class HelixBeforeChangeEvent extends CustomEvent {
     static { this.eventName = 'helix-before-change'; }
     constructor(detail) {
@@ -517,6 +550,97 @@ export class HelixCreateEvent extends CustomEvent {
         });
     }
 }
+export class HelixAuraFallbackEvent extends CustomEvent {
+    static { this.eventName = 'helix-aura-fallback'; }
+    constructor(detail) {
+        super(HelixAuraFallbackEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
+export class HelixClearEvent extends Event {
+    static { this.eventName = 'helix-clear'; }
+    constructor() {
+        super(HelixClearEvent.eventName, { bubbles: true, cancelable: false, composed: true });
+    }
+}
+export class HelixCopyErrorEvent extends Event {
+    static { this.eventName = 'helix-copy-error'; }
+    constructor() {
+        super(HelixCopyErrorEvent.eventName, { bubbles: true, cancelable: false, composed: true });
+    }
+}
+export class HelixLoadMoreEvent extends Event {
+    static { this.eventName = 'helix-load-more'; }
+    constructor() {
+        super(HelixLoadMoreEvent.eventName, { bubbles: true, cancelable: false, composed: true });
+    }
+}
+export class HelixLoadEvent extends Event {
+    static { this.eventName = 'helix-load'; }
+    constructor() {
+        super(HelixLoadEvent.eventName, { bubbles: true, cancelable: false, composed: true });
+    }
+}
+export class HelixRangeChangeEvent extends CustomEvent {
+    static { this.eventName = 'helix-range-change'; }
+    constructor(detail) {
+        super(HelixRangeChangeEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
+export class HelixExpandEvent extends CustomEvent {
+    static { this.eventName = 'helix-expand'; }
+    constructor(detail) {
+        super(HelixExpandEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
+export class HelixEndEvent extends Event {
+    static { this.eventName = 'helix-end'; }
+    constructor() {
+        super(HelixEndEvent.eventName, { bubbles: true, cancelable: false, composed: true });
+    }
+}
+export class HelixTypingEvent extends CustomEvent {
+    static { this.eventName = 'helix-typing'; }
+    constructor(detail) {
+        super(HelixTypingEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
+export class HelixActionEvent extends Event {
+    static { this.eventName = 'helix-action'; }
+    constructor() {
+        super(HelixActionEvent.eventName, { bubbles: true, cancelable: false, composed: true });
+    }
+}
+export class HelixToggleEvent extends CustomEvent {
+    static { this.eventName = 'helix-toggle'; }
+    constructor(detail) {
+        super(HelixToggleEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
 export class HelixCopyEvent extends CustomEvent {
     static { this.eventName = 'helix-copy'; }
     constructor(detail) {
@@ -737,7 +861,9 @@ export class HelixHistoryEvent extends CustomEvent {
     }
 }
 const registry = {
+    HelixActionEvent,
     HelixActivateEvent,
+    HelixAuraFallbackEvent,
     HelixBeforeActivateEvent,
     HelixBeforeChangeEvent,
     HelixBeforeCloseEvent,
@@ -757,13 +883,18 @@ const registry = {
     HelixCanvasViewEvent,
     HelixCanvasZoomEvent,
     HelixCaretEvent,
+    HelixClearEvent,
     HelixCollapseEvent,
     HelixCompleteEvent,
     HelixConnectEvent,
     HelixConsoleEvent,
+    HelixCopyErrorEvent,
     HelixCopyEvent,
     HelixCreateEvent,
     HelixDismissEvent,
+    HelixEditEvent,
+    HelixEndEvent,
+    HelixExpandEvent,
     HelixFacetEvent,
     HelixFilterEvent,
     HelixFilteredEvent,
@@ -775,6 +906,8 @@ const registry = {
     HelixGraphSignalEvent,
     HelixGraphZoomEvent,
     HelixHistoryEvent,
+    HelixLoadEvent,
+    HelixLoadMoreEvent,
     HelixMapClusterEvent,
     HelixMapPanEvent,
     HelixMapPartChangeEvent,
@@ -785,8 +918,10 @@ const registry = {
     HelixMoveEvent,
     HelixNavigateEvent,
     HelixNextEvent,
+    HelixPanelResizeEvent,
     HelixPinEvent,
     HelixPreviousEvent,
+    HelixRangeChangeEvent,
     HelixReadEvent,
     HelixReconnectEvent,
     HelixRejectEvent,
@@ -805,6 +940,9 @@ const registry = {
     HelixShortcutEvent,
     HelixSortEvent,
     HelixSortedEvent,
+    HelixSplitEvent,
+    HelixToggleEvent,
     HelixTourAskEvent,
+    HelixTypingEvent,
 };
 export const helixEventNames = new Set(Object.values(registry).map((event) => event.eventName));

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

@@ -20,6 +20,11 @@ const SCROLLER = css `
     overflow: auto;
   }
 `;
+const VIRTUAL = css `
+  [data-virtual] {
+    overflow-anchor: none;
+  }
+`;
 const MIRROR = css `
   :host(:dir(rtl)) [data-mirror] {
     scale: -1 1;
@@ -112,7 +117,15 @@ export class HelixElement extends LitElement {
         }));
     }
     static finalizeStyles(styles) {
-        return [BOX_SIZING, HIDDEN, SCROLLER, MIRROR, SETTLED, ...LitElement.finalizeStyles(styles)];
+        return [
+            BOX_SIZING,
+            HIDDEN,
+            SCROLLER,
+            VIRTUAL,
+            MIRROR,
+            SETTLED,
+            ...LitElement.finalizeStyles(styles),
+        ];
     }
     performUpdate() {
         if (this.hasUpdated || !measuring()) {

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

@@ -52,12 +52,17 @@ export declare const auditReactProps: (host: EventTarget, props: Record<string,
  * declared public API and all of them otherwise silent in React.
  *
  * The name is React's own casing, `onError` rather than `onerror`, because that
- * is what a consumer writes and therefore what is in the props bag. Every
- * native we relay is a single word, so capitalising the first letter is the
- * whole of the rule; a two-word name like `loadeddata` would be `onLoadedData`
- * and needs the list extending rather than the rule generalising.
+ * is what a consumer writes and therefore what is in the props bag. See
+ * `reactNativeProp`.
  */
 export declare const reactPropFor: (event: Event) => string | undefined;
+/**
+ * The prop React reads for a native event: `onError` for `error`, and
+ * `onTimeUpdate` for `timeupdate`.
+ *
+ * The JSX typings name the same props, so a consumer writes what this binds.
+ */
+export declare const reactNativeProp: (type: string) => string;
 export declare const bindReactHandler: (host: EventTarget, event: Event) => void;
 /**
  * Assigns the object and function properties React is holding and never applied.

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

@@ -76,8 +76,21 @@ export const reactPropFor = (event) => {
     if (event.bubbles || REACT_WIRES.has(event.type)) {
         return undefined;
     }
-    return `on${event.type.charAt(0).toUpperCase()}${event.type.slice(1)}`;
+    return reactNativeProp(event.type);
 };
+const REACT_CASING = {
+    canplay: 'onCanPlay',
+    canplaythrough: 'onCanPlayThrough',
+    durationchange: 'onDurationChange',
+    loadeddata: 'onLoadedData',
+    loadedmetadata: 'onLoadedMetadata',
+    loadstart: 'onLoadStart',
+    ratechange: 'onRateChange',
+    scrollend: 'onScrollEnd',
+    timeupdate: 'onTimeUpdate',
+    volumechange: 'onVolumeChange',
+};
+export const reactNativeProp = (type) => REACT_CASING[type] ?? `on${type.charAt(0).toUpperCase()}${type.slice(1)}`;
 const lowercasePropFor = (event) => event.type.includes('-') || REACT_WIRES.has(event.type) ? undefined : `on${event.type}`;
 export const bindReactHandler = (host, event) => {
     const props = reactPropsOf(host);

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { ArrivalController, type ArrivalOptions, } from './controllers/arrival-c
 export { ChartPointerController, type ChartPointerHost, } from './controllers/chart-pointer-controller/chart-pointer-controller.js';
 export { CommandController, type CommandOptions, HelixFallbackCommandEvent, supportsInvokers, } from './controllers/command-controller/command-controller.js';
 export { CopyController, type CopyOptions, } from './controllers/copy-controller/copy-controller.js';
+export { CountdownController, type CountdownOptions, } from './controllers/countdown-controller/countdown-controller.js';
 export { activeCue, adoptTrack, type Caption, CueController, captionsAmong, captionTracks, showCaption, } from './controllers/cue-controller/cue-controller.js';
 export { DelayController, type DelayOptions, } from './controllers/delay-controller/delay-controller.js';
 export { DisabledCascadeController, type DisabledCascadeOptions, } from './controllers/disabled-cascade-controller/disabled-cascade-controller.js';
@@ -14,7 +15,7 @@ export { FullscreenController } from './controllers/fullscreen-controller/fullsc
 export { HostClickController } from './controllers/host-click-controller/host-click-controller.js';
 export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, type IndicatorOptions, } from './controllers/indicator-controller/indicator-controller.js';
-export { KeyboardNavigationController, type KeyboardNavigationOptions, type NavigableItem, Typeahead, typesCharacter, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
+export { KeyboardNavigationController, type KeyboardNavigationOptions, type KeyboardOrigin, type NavigableItem, Typeahead, typesCharacter, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
 export { MediaSessionController, type SessionHandlers, SKIP_SECONDS, } from './controllers/media-session-controller/media-session-controller.js';
 export { animationsSettled, type OpenPhase, OpenPhaseController, type OpenPhaseOptions, } from './controllers/open-phase-controller/open-phase-controller.js';
 export { MAX_FRAME_STEP, PaintGateController, type PaintGateOptions, } from './controllers/paint-gate-controller/paint-gate-controller.js';
@@ -27,7 +28,7 @@ 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 CanvasView, type CaretDetail, type ChangeDetail, type CompleteDetail, type ConnectDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, type GraphFilterDetail, type GraphLayoutDetail, type GraphPartChangeDetail, type GraphSignalDetail, HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPinEvent, HelixPreviousEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixTourAskEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, type ReadDetail, type ReconnectDetail, type Refusal, type RefusedFile, type RejectDetail, type RelabelDetail, type RemoveDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type ToggleDetail, type ViewportPanDetail, type ViewportZoomDetail, } from './events/events.js';
+export { 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, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTypingEvent, type MapClusterDetail, type MapPanDetail, type MapPartChangeDetail, type MapRotateDetail, type MapTiltDetail, type MapZoomDetail, type MoveDetail, type NavigateDetail, type OpenDetail, 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 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';
@@ -77,6 +78,7 @@ export { copiesOf, type MediaCopy, sameCopies, } from './utils/media-copy/media-
 export { formatNumber, parseNumber } from './utils/number-format/number-format.js';
 export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
 export { appleTouch, onApple, type Platform } from './utils/platform/platform.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 { type ElementsProperty, linkDescription, reflectElements, unlinkDescription, } from './utils/reflect-elements/reflect-elements.js';

package/dist/index.js

@@ -3,6 +3,7 @@ export { ArrivalController, } from './controllers/arrival-controller/arrival-con
 export { ChartPointerController, } from './controllers/chart-pointer-controller/chart-pointer-controller.js';
 export { CommandController, HelixFallbackCommandEvent, supportsInvokers, } from './controllers/command-controller/command-controller.js';
 export { CopyController, } from './controllers/copy-controller/copy-controller.js';
+export { CountdownController, } from './controllers/countdown-controller/countdown-controller.js';
 export { activeCue, adoptTrack, CueController, captionsAmong, captionTracks, showCaption, } from './controllers/cue-controller/cue-controller.js';
 export { DelayController, } from './controllers/delay-controller/delay-controller.js';
 export { DisabledCascadeController, } from './controllers/disabled-cascade-controller/disabled-cascade-controller.js';
@@ -27,7 +28,7 @@ export { SwipeController, } from './controllers/swipe-controller/swipe-controlle
 export { TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
 export { VirtualizeController, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeMoveEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeReconnectEvent, HelixBeforeRelabelEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCanvasEditEvent, HelixCanvasPanEvent, HelixCanvasViewEvent, HelixCanvasZoomEvent, HelixCaretEvent, HelixCollapseEvent, HelixCompleteEvent, HelixConnectEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixFilteredEvent, HelixGraphFilterEvent, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, HelixHistoryEvent, HelixMapClusterEvent, HelixMapPanEvent, HelixMapPartChangeEvent, HelixMapReadyEvent, HelixMapRotateEvent, HelixMapTiltEvent, HelixMapZoomEvent, HelixMoveEvent, HelixNavigateEvent, HelixNextEvent, HelixPinEvent, HelixPreviousEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixTourAskEvent, } from './events/events.js';
+export { 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, HelixPreviousEvent, HelixRangeChangeEvent, HelixReadEvent, HelixReconnectEvent, HelixRejectEvent, HelixRelabelEvent, HelixRemoveEvent, HelixReorderEvent, HelixReorderedEvent, HelixResizedEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSelectedEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixSortedEvent, HelixSplitEvent, HelixToggleEvent, HelixTourAskEvent, HelixTypingEvent, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { MixinChartSource, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';
@@ -77,6 +78,7 @@ export { copiesOf, sameCopies, } from './utils/media-copy/media-copy.js';
 export { formatNumber, parseNumber } from './utils/number-format/number-format.js';
 export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
 export { appleTouch, onApple } from './utils/platform/platform.js';
+export { rangeAdd } from './utils/range-add/range-add.js';
 export { readColor, rgbOf } from './utils/read-color/read-color.js';
 export { byRow, readRows, readSeries, seriesKey, unbroken, } from './utils/read-series/read-series.js';
 export { linkDescription, reflectElements, unlinkDescription, } from './utils/reflect-elements/reflect-elements.js';

package/dist/utils/draw-icon/draw-icon.d.ts

@@ -10,16 +10,17 @@ export interface DrawIconOptions {
 /**
  * Draws an icon that was imported by name, rather than looked up by string.
  *
- * **`<helix-icon name="play">` indexes the whole icon set at runtime.** Its
- * render is `icons[this.name]`, and no bundler can shake a dynamic index, so
- * every consumer of any component that renders one ships all of the generated
- * path data: measured at 50,814 bytes raw and 15,010 gzipped for 102 icons, and
+ * **`<helix-icon name="play">` looks its glyph up in a registry at runtime.**
+ * The registry holds the whole set once `@fusion.dev/helix-headless/icon`
+ * registers it, and no bundler can shake a lookup by string, so every consumer
+ * of any component that renders one ships all of the generated path data: measured at 50,814 bytes raw and 15,010 gzipped for 102 icons, and
  * growing about 147 gzipped bytes per icon added. A named import ships one path
  * and is checked when the package compiles rather than by a name lookup later.
  *
  * That element still earns its place as *public* API, where a consumer writes a
- * name in markup and a lookup is the only thing that can work. What it should
- * not be is how this library draws its own marks.
+ * name in markup and a lookup is the only thing that can work, and
+ * `@fusion.dev/helix-headless/icon/root` names glyphs without registering the
+ * set. What it should not be is how this library draws its own marks.
  *
  * **There is no `part` option, and there cannot be.** A part name behind an
  * interpolation is a part the manifest cannot see, so the component's own

package/dist/utils/range-add/range-add.d.ts

@@ -0,0 +1,19 @@
+/**
+ * What a range adds to a selection of many, as arithmetic over the items on
+ * show.
+ *
+ * Pure and in core, because Listbox (Shift with Home or End) and Data Table
+ * (Shift with an arrow, Home or End, over rows) take in a range the same way,
+ * and a spec can hold it without a page.
+ */
+/**
+ * The selection after Shift with Home or End: every option shown from the
+ * highlight to the end the key went to, added after what was selected, or
+ * `null` where nothing new is taken in.
+ *
+ * `from` is where the highlight was, as an index into `shown`, or `-1` for no
+ * highlight, which takes in the end alone. `to` is the end the key went to.
+ * APG's multiple-selection listbox, and the same rule over a data table's
+ * rows.
+ */
+export declare const rangeAdd: (values: readonly string[], shown: readonly string[], from: number, to: number) => string[] | null;

package/dist/utils/range-add/range-add.js

@@ -0,0 +1,5 @@
+export const rangeAdd = (values, shown, from, to) => {
+    const [start, end] = from < 0 ? [to, to] : [Math.min(from, to), Math.max(from, to)];
+    const added = shown.slice(start, end + 1).filter((value) => !values.includes(value));
+    return added.length > 0 ? [...values, ...added] : null;
+};