@fusion.dev/helix-core 0.219.0 → 0.220.0

package/dist/events/details.d.ts

@@ -194,6 +194,13 @@ export interface FilterDetail {
     /** What the list is being narrowed to. */
     value: string;
 }
+/** Detail carried by `helix-found`. */
+export interface FoundDetail {
+    /** How many matches the search found. */
+    count: number;
+    /** Which match is current, counting from 0, or -1 for none. */
+    index: number;
+}
 /**
  * Detail carried by `helix-facet`.
  *

package/dist/events/events.d.ts

@@ -77,6 +77,7 @@ import { HelixExpandEvent } from './expand.js';
 import { HelixFacetEvent } from './facet.js';
 import { HelixFilterEvent } from './filter.js';
 import { HelixFilteredEvent } from './filtered.js';
+import { HelixFoundEvent } from './found.js';
 import { HelixGraphFilterEvent } from './graph-filter.js';
 import { HelixGraphLayoutEvent } from './graph-layout.js';
 import { HelixGraphPanEvent } from './graph-pan.js';
@@ -140,9 +141,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, 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 type { ActivateDetail, AuraFallbackDetail, BandDetail, CanvasView, CaretDetail, ChangeDetail, CompleteDetail, ConnectDetail, ConsoleDetail, CopyDetail, CreateDetail, DeviceButton, DeviceButtonDetail, DeviceKeyDetail, DeviceScrollDetail, DeviceSwipeDetail, DeviceTapDetail, DeviceTextDetail, DeviceTouchDetail, DismissDetail, FacetDetail, FilterDetail, FoundDetail, 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, 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, HelixStopEvent, 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, HelixFoundEvent, 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, HelixStopEvent, 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`.
@@ -205,6 +206,7 @@ declare const registry: {
     readonly HelixFacetEvent: typeof HelixFacetEvent;
     readonly HelixFilterEvent: typeof HelixFilterEvent;
     readonly HelixFilteredEvent: typeof HelixFilteredEvent;
+    readonly HelixFoundEvent: typeof HelixFoundEvent;
     readonly HelixGraphFilterEvent: typeof HelixGraphFilterEvent;
     readonly HelixGraphLayoutEvent: typeof HelixGraphLayoutEvent;
     readonly HelixGraphPanEvent: typeof HelixGraphPanEvent;

package/dist/events/events.js

@@ -47,6 +47,7 @@ import { HelixExpandEvent } from './expand.js';
 import { HelixFacetEvent } from './facet.js';
 import { HelixFilterEvent } from './filter.js';
 import { HelixFilteredEvent } from './filtered.js';
+import { HelixFoundEvent } from './found.js';
 import { HelixGraphFilterEvent } from './graph-filter.js';
 import { HelixGraphLayoutEvent } from './graph-layout.js';
 import { HelixGraphPanEvent } from './graph-pan.js';
@@ -111,7 +112,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, 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, HelixStopEvent, 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, HelixFoundEvent, 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, HelixStopEvent, HelixStrandsFallbackEvent, HelixTerminalBellEvent, HelixTerminalInputEvent, HelixTerminalLinkEvent, HelixTerminalResizeEvent, HelixTerminalRestartEvent, HelixTerminalTitleEvent, HelixToggleEvent, HelixTourAskEvent, HelixTourStatusEvent, HelixTypingEvent, };
 const registry = {
     HelixActionEvent,
     HelixActivateEvent,
@@ -162,6 +163,7 @@ const registry = {
     HelixFacetEvent,
     HelixFilterEvent,
     HelixFilteredEvent,
+    HelixFoundEvent,
     HelixGraphFilterEvent,
     HelixGraphLayoutEvent,
     HelixGraphPanEvent,

package/dist/events/found.d.ts

@@ -0,0 +1,14 @@
+import type { FoundDetail } from './details.js';
+/**
+ * A search found its matches, or moved among them, with how many there are
+ * and which is current.
+ *
+ * Sent by Find after each search and each move, and again when content that
+ * changed under an open search is searched again. Not cancelable: it reports
+ * matches already marked, as `helix-filtered` reports a list already
+ * narrowed.
+ */
+export declare class HelixFoundEvent extends CustomEvent<FoundDetail> {
+    static readonly eventName = "helix-found";
+    constructor(detail: FoundDetail);
+}

package/dist/events/found.js

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

package/dist/events/names.js

@@ -4,7 +4,7 @@ export const helixEventNames = new Set(('action activate aura-fallback band befo
     '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 ' +
+    'filtered found graph-filter graph-layout graph-pan graph-part-change graph-ready ' +
     '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 ' +

package/dist/index.d.ts

@@ -41,7 +41,7 @@ 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, 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, HelixStopEvent, 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 { 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 FoundDetail, 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, HelixFoundEvent, 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, HelixStopEvent, 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 { 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';
@@ -100,6 +100,7 @@ export { type ElementByIdOptions, elementById, searchableById, } from './utils/e
 export { exportParts } from './utils/export-parts/export-parts.js';
 export { fillTemplate, labelWith } from './utils/fill-template/fill-template.js';
 export { FILTER_MARK, filterKeeps, markMatches, rangeOf, } from './utils/filter-marks/filter-marks.js';
+export { FIND_CURRENT, FIND_MATCH, type FindDirection, type Finder, type FindQuery, type FindResult, findPattern, findRanges, findTextRanges, type TextFinderOptions, textFinder, } from './utils/find-text/find-text.js';
 export { focusTarget } from './utils/focus-target/focus-target.js';
 export { deepActiveElement, deepContains, focusableElements, PRESSABLE, pressedOwnControl, } from './utils/focusable-elements/focusable-elements.js';
 export { afterLinkFollowed, followLink, type LinkModifiers, type LinkTarget, } from './utils/follow-link/follow-link.js';

package/dist/index.js

@@ -41,7 +41,7 @@ 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, 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, HelixStopEvent, 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, HelixFoundEvent, 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, HelixStopEvent, 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 { 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';
@@ -100,6 +100,7 @@ export { elementById, searchableById, } from './utils/element-by-id/element-by-i
 export { exportParts } from './utils/export-parts/export-parts.js';
 export { fillTemplate, labelWith } from './utils/fill-template/fill-template.js';
 export { FILTER_MARK, filterKeeps, markMatches, rangeOf, } from './utils/filter-marks/filter-marks.js';
+export { FIND_CURRENT, FIND_MATCH, findPattern, findRanges, findTextRanges, textFinder, } from './utils/find-text/find-text.js';
 export { focusTarget } from './utils/focus-target/focus-target.js';
 export { deepActiveElement, deepContains, focusableElements, PRESSABLE, pressedOwnControl, } from './utils/focusable-elements/focusable-elements.js';
 export { afterLinkFollowed, followLink, } from './utils/follow-link/follow-link.js';

package/dist/utils/find-text/find-text.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Finding words in what a page shows, as ranges over its text, and painting
+ * them with the Custom Highlight API: the query every finder takes, and the
+ * finder Find uses for the content its `for` names.
+ *
+ * **Painted, and nothing is inserted.** The text is the page's own light DOM,
+ * often written by React or by another Helix family, and a `<mark>` wrapped
+ * around a match would be undone by the next render or would break it, as
+ * `filter-marks` explains for a filtered list.
+ */
+/** What every match is painted as, in `CSS.highlights` and in `base.css`. */
+export declare const FIND_MATCH = "helix-find-match";
+/** What the current match is painted as, over the others. */
+export declare const FIND_CURRENT = "helix-find-current";
+/** The search Find hands a finder. */
+export interface FindQuery {
+    /** Whether case has to match, so "Error" does not find "error". */
+    caseSensitive: boolean;
+    /** Whether `search` is a regular expression, in JavaScript's syntax. */
+    regex: boolean;
+    /** What Replace puts in place of a match. */
+    replace: string;
+    /** What the reader typed. */
+    search: string;
+    /** Whether a match has to be a whole word. */
+    wholeWord: boolean;
+}
+/** Where a search stands: how many matches, and which is current, counting from 0, or -1 for none. */
+export interface FindResult {
+    count: number;
+    index: number;
+}
+/**
+ * Which match a search makes current. `first` stays on the current match
+ * where it still matches, as while the reader types, and otherwise takes the
+ * next one from there. `next` and `previous` move one match either way, and
+ * wrap around at the ends.
+ */
+export type FindDirection = 'first' | 'next' | 'previous';
+/**
+ * Whatever searches content for Find: the text finder Find makes for the
+ * content `for` names, or one a frame or a page attaches, as Terminal's
+ * emulator and Code Editor's engine are.
+ */
+export interface Finder {
+    /** Takes away the marks a search drew, as Find closes or its field empties. */
+    end(): void;
+    /**
+     * Finds `query`, marks every match, and makes one current by `direction`.
+     * Returns where the search stands, or `undefined` from a finder that reports
+     * it later through the sink `attach` returned, as one that searches in a
+     * worker does.
+     */
+    find(query: FindQuery, direction: FindDirection): FindResult | undefined;
+    /**
+     * Replaces the current match, or every match with `all`, and returns where
+     * the search stands after. Find offers replacing only to a finder that has
+     * this.
+     */
+    replace?(query: FindQuery, all: boolean): FindResult | undefined;
+}
+/** The pattern a query reads as, or nothing for an empty search or a regular expression that cannot be read. */
+export declare const findPattern: (query: FindQuery) => RegExp | undefined;
+/** Where a query matches in a text, as `[from, to]` offsets, with no empty match. */
+export declare const findRanges: (text: string, query: FindQuery) => Array<[number, number]>;
+/**
+ * Every place the text under `root` matches `query`, as ranges in the order
+ * they come. A match may run across the elements inside one block, as
+ * "**bold** words" does, and never from one block into the next.
+ */
+export declare const findTextRanges: (root: Element, query: FindQuery, skip?: string) => Range[];
+/** What `textFinder` takes beside its root. */
+export interface TextFinderOptions {
+    /**
+     * Called with where the search stands once the content has changed under
+     * it, as a log that keeps writing does. A search that `find` returned is
+     * not reported again here.
+     */
+    found?: ((result: FindResult) => void) | undefined;
+    /**
+     * Elements under the root whose text is not searched, as a selector, such
+     * as line numbers or the buttons beside each message.
+     */
+    skip?: string | undefined;
+}
+/**
+ * A finder over the text a reader sees under `root`, in its light DOM and
+ * what is slotted there: Find's own, for the content its `for` names.
+ *
+ * Every match is painted as `helix-find-match`, and the current one as
+ * `helix-find-current`, by the Custom Highlight API. The first search starts
+ * at the first match in sight. The current match is scrolled into the middle
+ * of its scroller unless it is already in sight, and what hides it until found
+ * is opened first. While a search is open, a change to the content searches
+ * again once it has been still for 150ms, staying on the current match, and
+ * reports through `found`.
+ *
+ * Nothing is painted where the API is missing, as on a server or in a test
+ * DOM, and the count is still right there.
+ */
+export declare const textFinder: (root: Element, options?: TextFinderOptions) => Finder;

package/dist/utils/find-text/find-text.js

@@ -0,0 +1,330 @@
+export const FIND_MATCH = 'helix-find-match';
+export const FIND_CURRENT = 'helix-find-current';
+export const findPattern = (query) => {
+    if (query.search === '') {
+        return undefined;
+    }
+    const source = query.regex ? query.search : query.search.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    try {
+        return new RegExp(query.wholeWord ? `\\b(?:${source})\\b` : source, query.caseSensitive ? 'gu' : 'giu');
+    }
+    catch {
+        return undefined;
+    }
+};
+export const findRanges = (text, query) => {
+    const pattern = findPattern(query);
+    if (!pattern) {
+        return [];
+    }
+    return [...text.matchAll(pattern)]
+        .filter((match) => match[0] !== '')
+        .map((match) => [match.index, match.index + match[0].length]);
+};
+const NEVER = 'script, style, template, noscript, textarea, select, [inert], [aria-hidden="true"], [hidden]:not([hidden="until-found"])';
+const BETWEEN = '\u0000';
+const flatParent = (node) => {
+    const slot = node.assignedSlot;
+    if (slot) {
+        return slot;
+    }
+    const parent = node.parentNode;
+    if (parent?.nodeType === Node.ELEMENT_NODE) {
+        return parent;
+    }
+    return parent !== null && 'host' in parent ? parent.host : null;
+};
+const revealers = (node) => {
+    const found = [];
+    let below = node;
+    for (let element = flatParent(node); element !== null; element = flatParent(element)) {
+        const closed = element.localName === 'details' &&
+            !element.open &&
+            !(below instanceof Element && below.localName === 'summary');
+        if (closed || element.getAttribute('hidden') === 'until-found') {
+            found.unshift(element);
+        }
+        below = element;
+    }
+    return found;
+};
+const seen = (element) => {
+    if (typeof element.checkVisibility !== 'function') {
+        for (let at = element; at !== null; at = flatParent(at)) {
+            const hidden = at.getAttribute('hidden');
+            if (hidden !== null && hidden !== 'until-found') {
+                return false;
+            }
+        }
+        return true;
+    }
+    if (element.checkVisibility({ visibilityProperty: true })) {
+        return true;
+    }
+    const outer = revealers(element)[0];
+    return (outer && flatParent(outer)?.checkVisibility({ visibilityProperty: true })) ?? false;
+};
+const INLINE = /^(?:inline|contents|ruby|$)/;
+const blockOf = (text, root, inline) => {
+    const view = root.ownerDocument.defaultView;
+    for (let element = text.parentElement; element !== null && element !== root; element = element.parentElement) {
+        let flows = inline.get(element);
+        if (flows === undefined) {
+            flows = view ? INLINE.test(view.getComputedStyle(element).display) : false;
+            inline.set(element, flows);
+        }
+        if (!flows) {
+            return element;
+        }
+    }
+    return root;
+};
+const textsOf = (root, skip) => {
+    const nodes = [];
+    let joined = '';
+    if (root.closest(NEVER)) {
+        return { joined, nodes };
+    }
+    const never = skip === '' ? NEVER : `${NEVER}, ${skip}`;
+    const shown = new Map();
+    const inline = new Map();
+    const walker = root.ownerDocument.createTreeWalker(root, NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_TEXT, {
+        acceptNode: (node) => {
+            if (node.nodeType === Node.ELEMENT_NODE) {
+                const element = node;
+                if (element.matches(never)) {
+                    return NodeFilter.FILTER_REJECT;
+                }
+                return element.localName === 'br' ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP;
+            }
+            const parent = node.parentElement;
+            if (parent === null || node.nodeValue === '') {
+                return NodeFilter.FILTER_REJECT;
+            }
+            let visible = shown.get(parent);
+            if (visible === undefined) {
+                visible = seen(parent);
+                shown.set(parent, visible);
+            }
+            return visible ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_REJECT;
+        },
+    });
+    let block;
+    for (let node = walker.nextNode(); node !== null; node = walker.nextNode()) {
+        if (node.nodeType === Node.ELEMENT_NODE) {
+            joined += BETWEEN;
+            continue;
+        }
+        const text = node;
+        const here = blockOf(text, root, inline);
+        if (block !== undefined && here !== block) {
+            joined += BETWEEN;
+        }
+        block = here;
+        nodes.push([text, joined.length]);
+        joined += text.data;
+    }
+    return { joined, nodes };
+};
+const placed = (nodes, at, end) => {
+    let low = 0;
+    let high = nodes.length - 1;
+    while (low < high) {
+        const middle = Math.ceil((low + high) / 2);
+        const from = nodes[middle]?.[1] ?? 0;
+        if (from < at || (!end && from === at)) {
+            low = middle;
+        }
+        else {
+            high = middle - 1;
+        }
+    }
+    const [node, from] = nodes[low];
+    return [node, at - from];
+};
+export const findTextRanges = (root, query, skip = '') => {
+    if (findPattern(query) === undefined) {
+        return [];
+    }
+    const { joined, nodes } = textsOf(root, skip);
+    return findRanges(joined, query)
+        .filter(([from, to]) => !joined.slice(from, to).includes(BETWEEN))
+        .map(([from, to]) => {
+        const range = root.ownerDocument.createRange();
+        range.setStart(...placed(nodes, from, false));
+        range.setEnd(...placed(nodes, to, true));
+        return range;
+    });
+};
+const painted = new Map();
+const paint = (owner, ranges, current) => {
+    const registry = globalThis.CSS?.highlights;
+    if (registry === undefined) {
+        return;
+    }
+    if (ranges.length === 0) {
+        painted.delete(owner);
+    }
+    else {
+        painted.set(owner, { current, others: ranges.filter((range) => range !== current) });
+    }
+    const entries = [...painted.values()];
+    const layers = [
+        [FIND_MATCH, entries.flatMap((entry) => entry.others), 0],
+        [FIND_CURRENT, entries.flatMap((entry) => (entry.current ? [entry.current] : [])), 1],
+    ];
+    for (const [name, ranges, priority] of layers) {
+        if (ranges.length === 0) {
+            registry.delete(name);
+        }
+        else {
+            const highlight = new Highlight(...ranges);
+            highlight.priority = priority;
+            registry.set(name, highlight);
+        }
+    }
+};
+const against = (range, anchor) => {
+    try {
+        return range.compareBoundaryPoints(Range.START_TO_START, anchor);
+    }
+    catch {
+        return 1;
+    }
+};
+const firstInView = (ranges, root) => {
+    const top = Math.max(0, root.getBoundingClientRect().top);
+    const at = ranges.findIndex((range) => typeof range.getBoundingClientRect === 'function' &&
+        range.getBoundingClientRect().bottom > top);
+    return Math.max(at, 0);
+};
+const pick = (ranges, anchor, direction, root) => {
+    if (ranges.length === 0) {
+        return -1;
+    }
+    if (anchor === undefined) {
+        const first = firstInView(ranges, root);
+        return direction === 'previous' ? (first - 1 + ranges.length) % ranges.length : first;
+    }
+    const index = direction === 'previous'
+        ? ranges.findLastIndex((range) => against(range, anchor) < 0)
+        : ranges.findIndex((range) => direction === 'next' ? against(range, anchor) > 0 : against(range, anchor) >= 0);
+    if (index !== -1) {
+        return index;
+    }
+    return direction === 'previous' ? ranges.length - 1 : 0;
+};
+const scrollerOf = (element) => {
+    const view = element.ownerDocument.defaultView;
+    for (let at = flatParent(element); at !== null; at = flatParent(at)) {
+        if (at === element.ownerDocument.documentElement || at === element.ownerDocument.body) {
+            return null;
+        }
+        const overflow = view?.getComputedStyle(at).overflowY ?? '';
+        if (/auto|scroll/.test(overflow) && at.scrollHeight > at.clientHeight) {
+            return at;
+        }
+    }
+    return null;
+};
+const bringIntoView = (range) => {
+    const element = range.startContainer.parentElement;
+    if (element === null || typeof range.getBoundingClientRect !== 'function') {
+        return;
+    }
+    const scroller = scrollerOf(element);
+    const box = scroller?.getBoundingClientRect() ?? {
+        bottom: innerHeight,
+        left: 0,
+        right: innerWidth,
+        top: 0,
+    };
+    const rect = range.getBoundingClientRect();
+    if (rect.top >= box.top &&
+        rect.bottom <= box.bottom &&
+        rect.left >= box.left &&
+        rect.right <= box.right) {
+        return;
+    }
+    element.scrollIntoView?.({ behavior: 'instant', block: 'center', inline: 'nearest' });
+    const after = range.getBoundingClientRect();
+    if (scroller && (after.top < box.top || after.bottom > box.bottom)) {
+        scroller.scrollTop += after.top + after.height / 2 - (box.top + (box.bottom - box.top) / 2);
+    }
+};
+const reveal = (range) => {
+    const hiding = revealers(range.startContainer);
+    for (const element of hiding) {
+        if (element.localName === 'details') {
+            ;
+            element.open = true;
+        }
+        else {
+            element.dispatchEvent(new Event('beforematch', { bubbles: true }));
+            if (element.getAttribute('hidden') === 'until-found') {
+                element.removeAttribute('hidden');
+            }
+        }
+    }
+    return hiding.length > 0;
+};
+const SETTLE = 150;
+export const textFinder = (root, options = {}) => {
+    const owner = {};
+    let ranges = [];
+    let current;
+    let query;
+    let observer;
+    let settling;
+    const search = (direction, show) => {
+        ranges = query ? findTextRanges(root, query, options.skip ?? '') : [];
+        const index = pick(ranges, current, direction, root);
+        current = ranges[index];
+        paint(owner, ranges, current);
+        const shown = current;
+        if (shown && show) {
+            if (reveal(shown)) {
+                setTimeout(() => bringIntoView(shown));
+            }
+            else {
+                bringIntoView(shown);
+            }
+        }
+        return { count: ranges.length, index };
+    };
+    const watch = () => {
+        if (observer !== undefined || typeof MutationObserver === 'undefined') {
+            return;
+        }
+        observer = new MutationObserver(() => {
+            clearTimeout(settling);
+            settling = setTimeout(() => {
+                if (query) {
+                    options.found?.(search('first', false));
+                }
+            }, SETTLE);
+        });
+        observer.observe(root, {
+            attributeFilter: ['aria-hidden', 'hidden', 'inert'],
+            characterData: true,
+            childList: true,
+            subtree: true,
+        });
+    };
+    return {
+        end() {
+            observer?.disconnect();
+            observer = undefined;
+            clearTimeout(settling);
+            query = undefined;
+            ranges = [];
+            current = undefined;
+            paint(owner, ranges, current);
+        },
+        find(next, direction) {
+            query = next;
+            watch();
+            return search(direction, true);
+        },
+    };
+};

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  * release, so the two never disagree; a spec beside this holds them to it.
  * Nothing else in the running code knows which release it is.
  */
-export declare const VERSION = "0.219.0";
+export declare const VERSION = "0.220.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.219.0';
+export const VERSION = '0.220.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.219.0",
+  "version": "0.220.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -81,12 +81,12 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.219.0",
+    "@fusion.dev/helix-icons": "0.220.0",
     "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.219.0",
-    "@fusion.dev/helix-testing": "0.219.0",
+    "@fusion.dev/helix-cem": "0.220.0",
+    "@fusion.dev/helix-testing": "0.220.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },