restty 0.1.34 → 0.1.35

package/dist/restty.js

@@ -8,7 +8,7 @@ import {
   isBuiltinThemeName,
   listBuiltinThemeNames,
   parseGhosttyTheme
-} from "./chunk-meqn8xtd.js";
+} from "./chunk-zqscavsh.js";
 export {
   parseGhosttyTheme,
   listBuiltinThemeNames,

package/dist/runtime/create-runtime/font-runtime-grid-helpers.d.ts

@@ -19,6 +19,7 @@ type CreateFontRuntimeGridHelpersOptions = {
     getWasmHandle: () => number;
     ptyTransport: PtyTransport;
     setNeedsRender: () => void;
+    markSearchDirty?: () => void;
     shapeClusterWithFont: (entry: FontEntry, text: string) => {
         advance: number;
     };

package/dist/runtime/create-runtime/font-runtime-helpers.types.d.ts

@@ -69,6 +69,7 @@ export type CreateRuntimeFontRuntimeHelpersOptions = {
     getWasmHandle: () => number;
     ptyTransport: PtyTransport;
     setNeedsRender: () => void;
+    markSearchDirty?: () => void;
     getFontHinting: () => boolean;
     getFontHintTarget: () => ResttyFontHintTarget;
     fontScaleOverrides: Array<{

package/dist/runtime/create-runtime/highlight-terminal-color-utils.d.ts

@@ -0,0 +1,13 @@
+import { type ThemeTerminalColor } from "../../theme";
+import type { Color } from "../../renderer";
+export type RuntimeTerminalColor = {
+    kind: "color";
+    color: Color;
+} | {
+    kind: "cell-foreground";
+} | {
+    kind: "cell-background";
+};
+export declare function runtimeTerminalColorFromTheme(value: ThemeTerminalColor): RuntimeTerminalColor;
+export declare function resolveHighlightBackgroundColor(value: RuntimeTerminalColor, cellFg: Color, cellBg: Color, inverse: boolean): Color;
+export declare function resolveHighlightForegroundColor(value: RuntimeTerminalColor, cellFg: Color, cellBg: Color, inverse: boolean): Color;

package/dist/runtime/create-runtime/interaction-runtime/bind-pointer-aux-handlers.d.ts

@@ -1,9 +1,9 @@
 import type { InputHandler } from "../../../input";
-import type { RuntimeCell, RuntimeDesktopSelectionState, RuntimeGridState, RuntimeScrollbarDragState, RuntimeSelectionState, RuntimeTouchSelectionState } from "./types";
+import type { RuntimeCell, RuntimeDesktopSelectionState, RuntimeGridState, RuntimeSelectionState, RuntimeTouchSelectionState } from "./types";
 type CreatePointerAuxHandlersOptions = {
     inputHandler: InputHandler;
     shouldRoutePointerToAppMouse: (shiftKey: boolean) => boolean;
-    scrollViewportByLines: (lines: number) => void;
+    scrollViewportByWheel?: (event: WheelEvent) => void;
     getWasmReady: () => boolean;
     getWasmHandle: () => number;
     getGridState: () => RuntimeGridState;
@@ -14,7 +14,6 @@ type CreatePointerAuxHandlersOptions = {
     selectionState: RuntimeSelectionState;
     touchSelectionState: RuntimeTouchSelectionState;
     desktopSelectionState: RuntimeDesktopSelectionState;
-    scrollbarDragState: RuntimeScrollbarDragState;
     updateCanvasCursor: () => void;
     markNeedsRender: () => void;
 };

package/dist/runtime/create-runtime/interaction-runtime/bind-pointer-events.d.ts

@@ -1,5 +1,4 @@
-import { type OverlayScrollbarLayout } from "../../overlay-scrollbar";
-import type { BindCanvasEventsOptions, RuntimeCell, RuntimeDesktopSelectionState, RuntimeGridState, RuntimeLinkState, RuntimeScrollbarDragState, RuntimeSelectionState, RuntimeTouchSelectionState } from "./types";
+import type { BindCanvasEventsOptions, RuntimeCell, RuntimeDesktopSelectionState, RuntimeGridState, RuntimeLinkState, RuntimeSelectionState, RuntimeTouchSelectionState } from "./types";
 export type BindPointerEventsOptions = {
     canvas: HTMLCanvasElement;
     bindOptions: BindCanvasEventsOptions;
@@ -9,7 +8,6 @@ export type BindPointerEventsOptions = {
     selectionState: RuntimeSelectionState;
     touchSelectionState: RuntimeTouchSelectionState;
     desktopSelectionState: RuntimeDesktopSelectionState;
-    scrollbarDragState: RuntimeScrollbarDragState;
     linkState: RuntimeLinkState;
     cleanupCanvasFns: Array<() => void>;
     isTouchPointer: (event: PointerEvent) => boolean;
@@ -17,13 +15,9 @@ export type BindPointerEventsOptions = {
     clearPendingDesktopSelection: () => void;
     tryActivatePendingTouchSelection: (pointerId: number) => boolean;
     beginSelectionDrag: (cell: RuntimeCell, pointerId: number) => void;
-    noteScrollActivity: () => void;
-    getOverlayScrollbarLayout: () => OverlayScrollbarLayout | null;
-    pointerToCanvasPx: (event: PointerEvent) => {
-        x: number;
-        y: number;
-    };
-    setViewportScrollOffset: (nextOffset: number) => void;
+    selectWordAtCell?: (cell: RuntimeCell) => boolean;
+    selectLineAtCell?: (cell: RuntimeCell) => boolean;
+    scrollViewportByWheel?: (event: WheelEvent) => void;
     normalizeSelectionCell: (cell: RuntimeCell) => RuntimeCell;
     positionToCell: (event: {
         clientX: number;

package/dist/runtime/create-runtime/interaction-runtime/bind-pointer-up-handler.d.ts

@@ -1,10 +1,9 @@
 import type { InputHandler } from "../../../input";
-import type { RuntimeCell, RuntimeDesktopSelectionState, RuntimeLinkState, RuntimeScrollbarDragState, RuntimeSelectionState, RuntimeTouchSelectionState } from "./types";
+import type { RuntimeCell, RuntimeDesktopSelectionState, RuntimeLinkState, RuntimeSelectionState, RuntimeTouchSelectionState } from "./types";
 type CreatePointerUpHandlerOptions = {
     inputHandler: InputHandler;
     sendKeyInput: (text: string) => void;
     openLink: (url: string) => void;
-    scrollbarDragState: RuntimeScrollbarDragState;
     isTouchPointer: (event: PointerEvent) => boolean;
     touchSelectionState: RuntimeTouchSelectionState;
     selectionState: RuntimeSelectionState;
@@ -17,6 +16,8 @@ type CreatePointerUpHandlerOptions = {
     clearPendingDesktopSelection: () => void;
     desktopSelectionState: RuntimeDesktopSelectionState;
     clearSelection: () => void;
+    selectWordAtCell?: (cell: RuntimeCell) => boolean;
+    selectLineAtCell?: (cell: RuntimeCell) => boolean;
     updateCanvasCursor: () => void;
     markNeedsRender: () => void;
     shouldRoutePointerToAppMouse: (shiftKey: boolean) => boolean;

package/dist/runtime/create-runtime/interaction-runtime/desktop-word-selection.d.ts

@@ -0,0 +1,8 @@
+import type { RenderState } from "../../../wasm";
+import type { RuntimeCell } from "./types";
+type DesktopWordSelectionRange = {
+    start: number;
+    end: number;
+};
+export declare function resolveDesktopWordSelectionRange(render: RenderState | null, cell: RuntimeCell): DesktopWordSelectionRange | null;
+export {};

package/dist/runtime/create-runtime/interaction-runtime/scrollbar-runtime.d.ts

@@ -1,13 +1,10 @@
-import { type OverlayScrollbarLayout } from "../../overlay-scrollbar";
 import type { RuntimeGridState, RuntimeLinkState, RuntimeScrollbarState, RuntimeSelectionState } from "./types";
 import type { ResttyWasm, ResttyWasmExports } from "../../../wasm";
 export type CreateScrollbarRuntimeOptions = {
-    showOverlayScrollbar: boolean;
     scrollbarState: RuntimeScrollbarState;
     selectionState: RuntimeSelectionState;
     linkState: RuntimeLinkState;
     getCanvas: () => HTMLCanvasElement;
-    getCurrentDpr: () => number;
     getGridState: () => RuntimeGridState;
     getWasmReady: () => boolean;
     getWasm: () => ResttyWasm | null;
@@ -15,16 +12,13 @@ export type CreateScrollbarRuntimeOptions = {
     getWasmExports: () => ResttyWasmExports | null;
     updateLinkHover: (cell: null) => void;
     markNeedsRender: () => void;
+    markSearchDirty?: () => void;
 };
 export type ScrollbarRuntime = {
+    destroy: () => void;
     noteScrollActivity: () => void;
     scrollViewportByLines: (lines: number) => void;
-    setViewportScrollOffset: (nextOffset: number) => void;
-    pointerToCanvasPx: (event: PointerEvent) => {
-        x: number;
-        y: number;
-    };
-    getOverlayScrollbarLayout: () => OverlayScrollbarLayout | null;
-    appendOverlayScrollbar: (overlayData: number[], total: number, offset: number, len: number) => void;
+    scrollViewportByWheel: (event: WheelEvent) => void;
+    syncScrollbar: (total: number, offset: number, len: number) => void;
 };
 export declare function createScrollbarRuntime(options: CreateScrollbarRuntimeOptions): ScrollbarRuntime;

package/dist/runtime/create-runtime/interaction-runtime/types.d.ts

@@ -32,6 +32,9 @@ export type RuntimeDesktopSelectionState = {
     pendingPointerId: number | null;
     pendingCell: RuntimeCell | null;
     startedWithActiveSelection: boolean;
+    lastPrimaryClickAt: number;
+    lastPrimaryClickCell: RuntimeCell | null;
+    lastPrimaryClickCount: number;
 };
 export type RuntimeLinkState = {
     hoverId: number;
@@ -43,10 +46,6 @@ export type RuntimeScrollbarState = {
     lastOffset: number;
     lastLen: number;
 };
-export type RuntimeScrollbarDragState = {
-    pointerId: number | null;
-    thumbGrabRatio: number;
-};
 export type RuntimeSelectionState = ReturnType<typeof createSelectionState>;
 export type BindCanvasEventsOptions = {
     inputHandler: InputHandler;
@@ -63,7 +62,6 @@ export type CreateRuntimeInteractionOptions = {
     touchSelectionMode: "off" | "drag" | "long-press";
     touchSelectionLongPressMs: number;
     touchSelectionMoveThresholdPx: number;
-    showOverlayScrollbar: boolean;
     imeInput: HTMLTextAreaElement | null;
     cleanupCanvasFns: Array<() => void>;
     getCanvas: () => HTMLCanvasElement;
@@ -76,6 +74,7 @@ export type CreateRuntimeInteractionOptions = {
     getWasmExports: () => ResttyWasmExports | null;
     updateLinkHover: (cell: RuntimeCell | null) => void;
     markNeedsRender: () => void;
+    markSearchDirty?: () => void;
 };
 export type RuntimeInteraction = {
     selectionState: RuntimeSelectionState;
@@ -95,11 +94,12 @@ export type RuntimeInteraction = {
         x: number;
         y: number;
     };
+    selectWordAtClientPoint: (clientX: number, clientY: number) => boolean;
     clearSelection: () => void;
     updateImePosition: (cursor: {
         row: number;
         col: number;
     } | null | undefined, cellW: number, cellH: number) => void;
-    appendOverlayScrollbar: (overlayData: number[], total: number, offset: number, len: number) => void;
+    syncScrollbar: (total: number, offset: number, len: number) => void;
     bindCanvasEvents: (bindOptions: BindCanvasEventsOptions) => void;
 };

package/dist/runtime/create-runtime/lifecycle-theme-size.types.d.ts

@@ -2,6 +2,7 @@ import type { InputHandler } from "../../input";
 import type { FontManagerState } from "../../fonts";
 import type { Color, WebGLState, WebGPUState } from "../../renderer";
 import type { GhosttyTheme } from "../../theme";
+import type { RuntimeTerminalColor } from "./highlight-terminal-color-utils";
 import type { ResttyWasm } from "../../wasm";
 import type { ResttyAppCallbacks } from "../types";
 export type ActiveState = WebGPUState | WebGLState | null;
@@ -44,7 +45,12 @@ export type LifecycleThemeSizeDeps = {
     fontState: FontManagerState;
     defaultBgBase: Color;
     defaultFgBase: Color;
-    selectionBase: Color;
+    selectionBackgroundBase: RuntimeTerminalColor;
+    selectionForegroundBase: RuntimeTerminalColor | null;
+    searchMatchBackgroundBase: RuntimeTerminalColor;
+    searchCurrentMatchBackgroundBase: RuntimeTerminalColor;
+    searchMatchTextBase: RuntimeTerminalColor;
+    searchCurrentMatchTextBase: RuntimeTerminalColor;
     cursorBase: Color;
     getCanvas: () => HTMLCanvasElement;
     setCanvas: (canvas: HTMLCanvasElement) => void;
@@ -58,7 +64,12 @@ export type LifecycleThemeSizeDeps = {
     setActiveTheme: (theme: GhosttyTheme | null) => void;
     setDefaultBg: (value: Color) => void;
     setDefaultFg: (value: Color) => void;
-    setSelectionColor: (value: Color) => void;
+    setSelectionBackgroundColor: (value: RuntimeTerminalColor) => void;
+    setSelectionForegroundColor: (value: RuntimeTerminalColor | null) => void;
+    setSearchMatchBackgroundColor: (value: RuntimeTerminalColor) => void;
+    setSearchCurrentMatchBackgroundColor: (value: RuntimeTerminalColor) => void;
+    setSearchMatchTextColor: (value: RuntimeTerminalColor) => void;
+    setSearchCurrentMatchTextColor: (value: RuntimeTerminalColor) => void;
     setCursorFallback: (value: Color) => void;
     getWasmReady: () => boolean;
     getWasm: () => ResttyWasm | null;

package/dist/runtime/create-runtime/ligature-runs.d.ts

@@ -0,0 +1,52 @@
+type CellCluster = {
+    cp: number;
+    text: string;
+    span: number;
+};
+type CursorCell = {
+    row: number;
+    col: number;
+    wide: boolean;
+};
+type ResolveLigatureRunOptions = {
+    idx: number;
+    row: number;
+    col: number;
+    cols: number;
+    contentTags: Uint8Array | null;
+    styleFlags: Uint16Array | null;
+    linkIds: Uint32Array | null;
+    fgBytes: Uint8Array;
+    bgBytes: Uint8Array | null;
+    ulBytes: Uint8Array | null;
+    ulStyle: Uint8Array | null;
+    cursorBlock: boolean;
+    cursorCell: CursorCell | null;
+    readCellCluster: (cellIndex: number) => CellCluster | null;
+};
+type LigatureRun = {
+    text: string;
+    span: number;
+    indices: number[];
+};
+type ShapedGlyphLike = {
+    glyphId: number;
+    xAdvance: number;
+    xOffset: number;
+};
+type ShapedClusterLike = {
+    glyphs: ShapedGlyphLike[];
+    advance: number;
+};
+type ResolveRenderableLigatureRunOptions<FontEntry> = {
+    ligatureRun: LigatureRun;
+    stylePreference: string;
+    fonts: FontEntry[];
+    pickFontIndexForText: (text: string, expectedSpan?: number, stylePreference?: string) => number;
+    shapeClusterWithFont: (entry: FontEntry, text: string) => ShapedClusterLike;
+    readCellCluster: (cellIndex: number) => CellCluster | null;
+};
+export declare function resolveLigatureRun(options: ResolveLigatureRunOptions): LigatureRun | null;
+export declare function shouldUseLigatureShape(combined: ShapedClusterLike, singles: ShapedClusterLike[]): boolean;
+export declare function resolveRenderableLigatureRun<FontEntry>(options: ResolveRenderableLigatureRunOptions<FontEntry>): LigatureRun | null;
+export {};

package/dist/runtime/create-runtime/native-scrollbar-host.d.ts

@@ -0,0 +1,15 @@
+type CreateNativeScrollbarHostOptions = {
+    canvas: HTMLCanvasElement;
+    getGridState: () => {
+        cellH: number;
+    };
+    noteScrollActivity: () => void;
+    setViewportScrollOffset: (nextOffset: number) => void;
+};
+export type NativeScrollbarHost = {
+    flash: () => void;
+    sync: (total: number, offset: number, len: number) => void;
+    destroy: () => void;
+};
+export declare function createNativeScrollbarHost(options: CreateNativeScrollbarHostOptions): NativeScrollbarHost;
+export {};

package/dist/runtime/create-runtime/render-tick-webgpu.types.d.ts

@@ -1,9 +1,10 @@
 import type { FontEntry, FontManagerState } from "../../fonts";
 import type { NerdConstraint } from "../../fonts/nerd-constraints";
 import type { Color, WebGPUState } from "../../renderer";
+import type { RuntimeTerminalColor } from "./highlight-terminal-color-utils";
 import type { CompiledWebGPUShaderStage, WebGPUStageTargets } from "../create-app-types";
 import type { GlyphConstraintMeta } from "../atlas-builder";
-import type { KittyPlacement, RenderState, ResttyWasm, ResttyWasmExports } from "../../wasm";
+import type { KittyPlacement, RenderState, ResttyWasm, ResttyWasmExports, SearchViewportMatch } from "../../wasm";
 import type { KittyDrawPlan, KittyDrawSlice } from "./kitty-render-runtime";
 import type { ResttyFontHintTarget } from "../types";
 export type CursorPosition = {
@@ -99,6 +100,7 @@ export type SharedTickDeps = {
         match: RegExp;
         scale: number;
     }>;
+    getLigatures: () => boolean;
     getFontHinting: () => boolean;
     getFontHintTarget: () => ResttyFontHintTarget;
     isSymbolFont: (entry: FontEntry) => boolean;
@@ -117,9 +119,15 @@ export type SharedTickDeps = {
         start: number;
         end: number;
     } | null;
+    getSearchViewportMatches: () => readonly SearchViewportMatch[];
     pushRect: (target: number[], x: number, y: number, width: number, height: number, color: Color) => void;
     pushRectBox: (target: number[], x: number, y: number, width: number, height: number, color: Color) => void;
-    selectionColor: Color;
+    selectionBackgroundColor: RuntimeTerminalColor;
+    selectionForegroundColor: RuntimeTerminalColor | null;
+    searchMatchBackgroundColor: RuntimeTerminalColor;
+    searchCurrentMatchBackgroundColor: RuntimeTerminalColor;
+    searchMatchTextColor: RuntimeTerminalColor;
+    searchCurrentMatchTextColor: RuntimeTerminalColor;
     STYLE_BOLD: number;
     STYLE_ITALIC: number;
     STYLE_FAINT: number;
@@ -197,7 +205,7 @@ export type SharedTickDeps = {
         lastOffset: number;
         lastLen: number;
     };
-    appendOverlayScrollbar: (target: number[], total: number, offset: number, len: number) => void;
+    syncScrollbar: (total: number, offset: number, len: number) => void;
     webgpuUniforms: Float32Array;
     ensureInstanceBuffer: (state: WebGPUState, kind: "rect" | "glyph", minBytes: number) => void;
     GLYPH_INSTANCE_FLOATS: number;

package/dist/runtime/create-runtime/runtime-app-api.d.ts

@@ -25,10 +25,16 @@ type RuntimeSendInput = (text: string, source?: string, options?: {
 }) => void;
 type RuntimePublicApiOptions = {
     setFontSize: ResttyApp["setFontSize"];
+    setLigatures: ResttyApp["setLigatures"];
     setFontHinting: ResttyApp["setFontHinting"];
     setFontHintTarget: ResttyApp["setFontHintTarget"];
     setFontSources: ResttyApp["setFontSources"];
     resetTheme: ResttyApp["resetTheme"];
+    setSearchQuery: ResttyApp["setSearchQuery"];
+    clearSearch: ResttyApp["clearSearch"];
+    searchNext: ResttyApp["searchNext"];
+    searchPrevious: ResttyApp["searchPrevious"];
+    getSearchState: ResttyApp["getSearchState"];
     dumpAtlasForCodepoint: ResttyApp["dumpAtlasForCodepoint"];
     resize: ResttyApp["resize"];
     focus: ResttyApp["focus"];
@@ -100,6 +106,8 @@ type CreateRuntimeAppApiOptions = {
     destroyWebGPUStageTargets: () => void;
     clearWebGLShaderStages: (state?: WebGLState) => void;
     destroyWebGLStageTargets: (state?: WebGLState) => void;
+    markSearchDirty: () => void;
+    handleSearchWasmReset: () => void;
 };
 export declare function createRuntimeAppApi(options: CreateRuntimeAppApiOptions): RuntimeAppApiRuntime;
 export {};

package/dist/runtime/create-runtime/search-highlight-utils.d.ts

@@ -0,0 +1,21 @@
+import type { Color } from "../../renderer";
+import type { ResttySearchViewportMatch } from "../types";
+export type SearchCellHighlightKind = 0 | 1 | 2;
+type AppendSearchHighlightsOptions = {
+    target: number[];
+    matches: ResttySearchViewportMatch[];
+    rows: number;
+    cols: number;
+    cellW: number;
+    cellH: number;
+    inactiveColor: Color;
+    activeColor: Color;
+    pushRect: (target: number[], x: number, y: number, width: number, height: number, color: Color) => void;
+};
+export declare function appendSearchHighlightsForRow(target: number[], matches: readonly ResttySearchViewportMatch[], startIndex: number, row: number, rowY: number, cols: number, cellW: number, cellH: number, inactiveColor: Color, activeColor: Color, pushRect: (target: number[], x: number, y: number, width: number, height: number, color: Color) => void): number;
+export declare function appendSearchHighlights(options: AppendSearchHighlightsOptions): void;
+export declare function searchHighlightForColumn(matches: readonly ResttySearchViewportMatch[], startIndex: number, endIndex: number, col: number, cols: number): {
+    nextIndex: number;
+    kind: SearchCellHighlightKind;
+};
+export {};

package/dist/runtime/create-runtime/search-runtime.d.ts

@@ -0,0 +1,22 @@
+import type { ResttyWasm, SearchViewportMatch } from "../../wasm";
+import type { ResttyAppCallbacks, ResttySearchState } from "../types";
+type CreateRuntimeSearchOptions = {
+    callbacks?: ResttyAppCallbacks;
+    cleanupFns: Array<() => void>;
+    getWasmReady: () => boolean;
+    getWasm: () => ResttyWasm | null;
+    getWasmHandle: () => number;
+    markNeedsRender: () => void;
+};
+type RuntimeSearch = {
+    setQuery: (query: string) => void;
+    clear: () => void;
+    next: () => void;
+    previous: () => void;
+    getState: () => ResttySearchState;
+    getViewportMatches: () => SearchViewportMatch[];
+    markDirty: () => void;
+    handleWasmReset: () => void;
+};
+export declare function createRuntimeSearch(options: CreateRuntimeSearchOptions): RuntimeSearch;
+export {};

package/dist/runtime/overlay-scrollbar.d.ts

@@ -1,9 +1,7 @@
-import { type Color } from "../renderer";
 export declare const OVERLAY_SCROLLBAR_WIDTH_CSS_PX = 7;
 export declare const OVERLAY_SCROLLBAR_MARGIN_CSS_PX = 4;
 export declare const OVERLAY_SCROLLBAR_INSET_Y_CSS_PX = 2;
 export declare const OVERLAY_SCROLLBAR_MIN_THUMB_CSS_PX = 28;
-export declare const OVERLAY_SCROLLBAR_CAP_SUPERSAMPLE = 8;
 export type OverlayScrollbarLayout = {
     total: number;
     offset: number;
@@ -17,8 +15,3 @@ export type OverlayScrollbarLayout = {
     thumbH: number;
 };
 export declare function computeOverlayScrollbarLayout(total: number, offset: number, len: number, canvasWidth: number, canvasHeight: number, currentDpr: number): OverlayScrollbarLayout | null;
-export declare function isPointInScrollbarHitArea(layout: OverlayScrollbarLayout, x: number, y: number): boolean;
-export declare function isPointInScrollbarThumb(layout: OverlayScrollbarLayout, x: number, y: number): boolean;
-export declare function scrollbarOffsetForPointerY(layout: OverlayScrollbarLayout, pointerY: number, thumbGrabRatio: number): number;
-export declare function pushRoundedVerticalBar(out: number[], x: number, y: number, w: number, h: number, color: Color, capSupersample?: number): void;
-export declare function resolveOverlayScrollbarAlpha(now: number, lastInputAt: number): number;

package/dist/runtime/types.d.ts

@@ -3,9 +3,19 @@ import type { PtyTransport } from "../pty";
 import type { WebGPUCoreState } from "../renderer";
 import type { GhosttyTheme } from "../theme";
 import type { ResttyWasm } from "../wasm";
+import type { SearchViewportMatch } from "../wasm";
 import type { Font as TextShaperFont } from "text-shaper";
 /** Callback for WASM log messages. */
 export type ResttyWasmLogListener = (message: string) => void;
+export type ResttySearchState = {
+    query: string;
+    active: boolean;
+    pending: boolean;
+    complete: boolean;
+    total: number;
+    selectedIndex: number | null;
+};
+export type ResttySearchViewportMatch = SearchViewportMatch;
 /** Shared parsed font face reused across panes within a session. */
 export type ResttyFontResourceFace = {
     /** Human-readable label for debug/log output. */
@@ -109,6 +119,8 @@ export type ResttyAppCallbacks = {
     onMouseStatus?: (status: string) => void;
     /** Terminal requested a desktop notification via OSC 9 / OSC 777. */
     onDesktopNotification?: (notification: DesktopNotification) => void;
+    /** Terminal search state changed. */
+    onSearchState?: (state: ResttySearchState) => void;
 };
 /** Raw font data as an ArrayBuffer or typed-array view. */
 export type ResttyFontBufferData = ArrayBuffer | ArrayBufferView;
@@ -215,6 +227,8 @@ export type ResttyAppOptions = {
     renderer?: "auto" | "webgpu" | "webgl2";
     /** Font size in CSS pixels. */
     fontSize?: number;
+    /** Enable programming ligature shaping across adjacent operator cells (default true). */
+    ligatures?: boolean;
     /** Enable TrueType hinting during atlas rasterization (default false). */
     fontHinting?: boolean;
     /**
@@ -316,6 +330,8 @@ export type ResttyApp = {
     togglePause: () => void;
     /** Update the terminal font size in CSS pixels. */
     setFontSize: (value: number) => void;
+    /** Enable or disable programming ligature shaping. */
+    setLigatures: (value: boolean) => void;
     /** Enable or disable TrueType hinting for atlas glyph rasterization. */
     setFontHinting: (value: boolean) => void;
     /** Update hinting target mode used when hinting is enabled. */
@@ -346,6 +362,18 @@ export type ResttyApp = {
     copySelectionToClipboard: () => Promise<boolean>;
     /** Paste clipboard contents into the terminal. */
     pasteFromClipboard: () => Promise<boolean>;
+    /** Select the word at a viewport client coordinate. */
+    selectWordAtClientPoint: (clientX: number, clientY: number) => boolean;
+    /** Update the active terminal search query. */
+    setSearchQuery: (query: string) => void;
+    /** Clear terminal search state and visible highlights. */
+    clearSearch: () => void;
+    /** Navigate to the next terminal search match. */
+    searchNext: () => void;
+    /** Navigate to the previous terminal search match. */
+    searchPrevious: () => void;
+    /** Get the current terminal search state. */
+    getSearchState: () => ResttySearchState;
     /** Dump the glyph atlas entry for a given Unicode codepoint. */
     dumpAtlasForCodepoint: (cp: number) => void;
     /** Resize terminal grid to explicit columns/rows. */

package/dist/surface/pane-app-manager.d.ts

@@ -1,5 +1,6 @@
 import { type ResttyPaneStyleOptions, type ResttyPaneStylesOptions, type ResttyPaneContextMenuOptions, type ResttyPaneManager, type ResttyPaneShortcutsOptions, type ResttyPaneWithApp } from "./panes-types";
 import type { ResttyAppOptions, ResttyAppSession } from "../runtime/types";
+import { type ResttyPaneSearchUiCloseOptions, type ResttyPaneSearchUiOpenOptions, type ResttyPaneSearchUiOptions, type ResttyPaneSearchUiStyleOptions } from "./pane-search-ui";
 /**
  * A pane created by the app pane manager, extending the base pane
  * with DOM elements needed by the terminal app.
@@ -25,8 +26,20 @@ export type ResttyPaneDomDefaults = {
 export type ResttyManagedPaneStyleOptions = ResttyPaneStyleOptions;
 /** Style configuration including enabled flag (alias for ResttyPaneStylesOptions). */
 export type ResttyManagedPaneStylesOptions = ResttyPaneStylesOptions;
+/** Style configuration for the built-in pane search UI. */
+export type ResttyManagedPaneSearchUiStyleOptions = ResttyPaneSearchUiStyleOptions;
+/** Built-in pane search UI configuration. */
+export type ResttyManagedPaneSearchUiOptions = ResttyPaneSearchUiOptions;
 /** App options minus the DOM/session fields that the pane manager provides. */
 export type ResttyPaneAppOptionsInput = Omit<ResttyAppOptions, "canvas" | "imeInput" | "session">;
+export type ResttyAppPaneManager = ResttyPaneManager<ResttyManagedAppPane> & {
+    openPaneSearch: (id: number, options?: ResttyPaneSearchUiOpenOptions) => void;
+    closePaneSearch: (id: number, options?: ResttyPaneSearchUiCloseOptions) => void;
+    togglePaneSearch: (id: number, options?: ResttyPaneSearchUiOpenOptions & ResttyPaneSearchUiCloseOptions) => void;
+    isPaneSearchOpen: (id: number) => boolean;
+    getSearchUiStyleOptions: () => Readonly<Required<ResttyPaneSearchUiStyleOptions>>;
+    setSearchUiStyleOptions: (options: ResttyPaneSearchUiStyleOptions) => void;
+};
 /**
  * Configuration for the built-in default context menu.
  */
@@ -65,6 +78,8 @@ export type CreateResttyAppPaneManagerOptions = {
     minPaneSize?: number;
     /** Enable or configure built-in pane CSS styles. */
     paneStyles?: boolean | ResttyManagedPaneStylesOptions;
+    /** Enable or configure the built-in pane search UI. */
+    searchUi?: boolean | ResttyManagedPaneSearchUiOptions;
     /** Enable or configure keyboard shortcuts for splitting. */
     shortcuts?: boolean | ResttyPaneShortcutsOptions;
     /** Custom context menu implementation (overrides defaultContextMenu). */
@@ -86,4 +101,4 @@ export type CreateResttyAppPaneManagerOptions = {
  * Create an app-aware pane manager that automatically constructs
  * canvas, IME input, and terminal app instances for each pane.
  */
-export declare function createResttyAppPaneManager(options: CreateResttyAppPaneManagerOptions): ResttyPaneManager<ResttyManagedAppPane>;
+export declare function createResttyAppPaneManager(options: CreateResttyAppPaneManagerOptions): ResttyAppPaneManager;

package/dist/surface/pane-search-ui.d.ts

@@ -0,0 +1,87 @@
+import type { ResttySearchState } from "../runtime/types";
+type SearchUiPaneApp = {
+    setSearchQuery: (query: string) => void;
+    clearSearch: () => void;
+    searchNext: () => void;
+    searchPrevious: () => void;
+    getSearchState: () => ResttySearchState;
+};
+export type ResttyPaneSearchUiPane = {
+    id: number;
+    container: HTMLDivElement;
+    focusTarget?: HTMLElement | null;
+    app: SearchUiPaneApp;
+};
+export type ResttyPaneSearchUiStyleOptions = {
+    offsetTopPx?: number;
+    offsetRightPx?: number;
+    minWidthPx?: number;
+    maxWidthPx?: number;
+    zIndex?: number;
+    borderRadiusPx?: number;
+    backdropBlurPx?: number;
+    panelBackground?: string;
+    panelBorderColor?: string;
+    panelTextColor?: string;
+    panelShadow?: string;
+    inputBackground?: string;
+    inputTextColor?: string;
+    inputPlaceholderColor?: string;
+    buttonBackground?: string;
+    buttonTextColor?: string;
+    buttonHoverBackground?: string;
+    buttonDisabledOpacity?: number;
+    statusTextColor?: string;
+    statusActiveTextColor?: string;
+    statusCompleteTextColor?: string;
+};
+export type ResttyPaneSearchUiShortcutOptions = {
+    enabled?: boolean;
+    canOpen?: (event: KeyboardEvent, paneId: number) => boolean;
+};
+export type ResttyPaneSearchUiOptions = {
+    enabled?: boolean;
+    placeholder?: string;
+    previousButtonText?: string;
+    nextButtonText?: string;
+    clearButtonText?: string;
+    closeButtonText?: string;
+    statusFormatter?: (state: ResttySearchState) => string;
+    shortcut?: boolean | ResttyPaneSearchUiShortcutOptions;
+    styles?: ResttyPaneSearchUiStyleOptions;
+};
+export type ResttyPaneSearchUiOpenOptions = {
+    selectAll?: boolean;
+};
+export type ResttyPaneSearchUiCloseOptions = {
+    restoreFocus?: boolean;
+};
+export type PaneSearchUiController = {
+    registerPane: (pane: ResttyPaneSearchUiPane) => void;
+    unregisterPane: (paneId: number) => void;
+    handleSearchState: (paneId: number, state: ResttySearchState) => void;
+    handleActivePaneChange: (paneId: number | null) => void;
+    open: (paneId: number, options?: ResttyPaneSearchUiOpenOptions) => void;
+    close: (paneId: number, options?: ResttyPaneSearchUiCloseOptions) => void;
+    toggle: (paneId: number, options?: ResttyPaneSearchUiOpenOptions & ResttyPaneSearchUiCloseOptions) => void;
+    isOpen: (paneId: number) => boolean;
+    getStyleOptions: () => Readonly<Required<ResttyPaneSearchUiStyleOptions>>;
+    setStyleOptions: (options: ResttyPaneSearchUiStyleOptions) => void;
+    destroy: () => void;
+};
+export declare function createPaneSearchUiController(options: {
+    root: HTMLElement;
+    enabled?: boolean;
+    placeholder?: string;
+    previousButtonText?: string;
+    nextButtonText?: string;
+    clearButtonText?: string;
+    closeButtonText?: string;
+    statusFormatter?: (state: ResttySearchState) => string;
+    shortcut?: boolean | ResttyPaneSearchUiShortcutOptions;
+    styles?: ResttyPaneSearchUiStyleOptions;
+    getPaneById: (paneId: number) => ResttyPaneSearchUiPane | null;
+    getActivePane: () => ResttyPaneSearchUiPane | null;
+    getFocusedPane: () => ResttyPaneSearchUiPane | null;
+}): PaneSearchUiController;
+export {};