restty 0.1.34 → 0.1.35

package/dist/surface/restty/active-pane-api.d.ts

@@ -1,6 +1,8 @@
 import type { InputHandler, MouseMode } from "../../input";
 import type { GhosttyTheme } from "../../theme";
 import type { ResttyPaneHandle } from "../restty-pane-handle";
+import type { ResttyPaneSearchUiCloseOptions, ResttyPaneSearchUiOpenOptions } from "../pane-search-ui";
+import type { ResttyManagedPaneSearchUiStyleOptions } from "../pane-app-manager";
 export declare abstract class ResttyActivePaneApi {
     protected abstract requireActivePaneHandle(): ResttyPaneHandle;
     isPtyConnected(): boolean;
@@ -17,6 +19,12 @@ export declare abstract class ResttyActivePaneApi {
     getMouseStatus(): ReturnType<InputHandler["getMouseStatus"]>;
     copySelectionToClipboard(): Promise<boolean>;
     pasteFromClipboard(): Promise<boolean>;
+    openSearch(options?: ResttyPaneSearchUiOpenOptions): void;
+    closeSearch(options?: ResttyPaneSearchUiCloseOptions): void;
+    toggleSearch(options?: ResttyPaneSearchUiOpenOptions & ResttyPaneSearchUiCloseOptions): void;
+    isSearchOpen(): boolean;
+    getSearchUiStyleOptions(): Readonly<Required<ResttyManagedPaneSearchUiStyleOptions>>;
+    setSearchUiStyleOptions(options: ResttyManagedPaneSearchUiStyleOptions): void;
     dumpAtlasForCodepoint(cp: number): void;
     updateSize(force?: boolean): void;
     getBackend(): string;

package/dist/surface/restty/pane-ops.d.ts

@@ -1,25 +1,32 @@
-import type { ResttyManagedAppPane, ResttyManagedPaneStyleOptions } from "../pane-app-manager";
+import type { ResttyAppPaneManager, ResttyManagedAppPane, ResttyManagedPaneStyleOptions, ResttyManagedPaneSearchUiStyleOptions } from "../pane-app-manager";
 import type { ResttyPaneManager, ResttyPaneSplitDirection } from "../panes-types";
 import { ResttyPaneHandle } from "../restty-pane-handle";
 import type { ResttyLifecycleHookPayload, ResttyPluginEvents } from "../restty-plugin-types";
+import type { ResttyPaneSearchUiCloseOptions, ResttyPaneSearchUiOpenOptions } from "../pane-search-ui";
 type ResttyPaneLookup = {
     getPanes: () => ResttyManagedAppPane[];
     getPaneById: (id: number) => ResttyManagedAppPane | null;
     getActivePane: () => ResttyManagedAppPane | null;
     getFocusedPane: () => ResttyManagedAppPane | null;
+    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<ResttyManagedPaneSearchUiStyleOptions>>;
+    setSearchUiStyleOptions: (options: ResttyManagedPaneSearchUiStyleOptions) => void;
 };
 type ResttyLifecycleEmitter = {
     runLifecycleHooks: (payload: ResttyLifecycleHookPayload) => void;
     emitPluginEvent: <E extends keyof ResttyPluginEvents>(event: E, payload: ResttyPluginEvents[E]) => void;
 };
 export declare function requirePaneById(getPaneById: (id: number) => ResttyManagedAppPane | null, id: number): ResttyManagedAppPane;
-export declare function makePaneHandle(getPaneById: (id: number) => ResttyManagedAppPane | null, id: number): ResttyPaneHandle;
-export declare function requireActivePaneHandle(lookup: Pick<ResttyPaneLookup, "getActivePane" | "getPaneById">): ResttyPaneHandle;
-export declare function panes(lookup: Pick<ResttyPaneLookup, "getPanes" | "getPaneById">): ResttyPaneHandle[];
-export declare function pane(lookup: Pick<ResttyPaneLookup, "getPaneById">, id: number): ResttyPaneHandle | null;
-export declare function activePane(lookup: Pick<ResttyPaneLookup, "getActivePane" | "getPaneById">): ResttyPaneHandle | null;
-export declare function focusedPane(lookup: Pick<ResttyPaneLookup, "getFocusedPane" | "getPaneById">): ResttyPaneHandle | null;
-export declare function forEachPane(lookup: Pick<ResttyPaneLookup, "getPanes" | "getPaneById">, visitor: (pane: ResttyPaneHandle) => void): void;
+export declare function makePaneHandle(lookup: Pick<ResttyPaneLookup, "getPaneById" | "openPaneSearch" | "closePaneSearch" | "togglePaneSearch" | "isPaneSearchOpen" | "getSearchUiStyleOptions" | "setSearchUiStyleOptions">, id: number): ResttyPaneHandle;
+export declare function requireActivePaneHandle(lookup: Pick<ResttyPaneLookup, "getActivePane" | "getPaneById" | "openPaneSearch" | "closePaneSearch" | "togglePaneSearch" | "isPaneSearchOpen" | "getSearchUiStyleOptions" | "setSearchUiStyleOptions">): ResttyPaneHandle;
+export declare function panes(lookup: Pick<ResttyPaneLookup, "getPanes" | "getPaneById" | "openPaneSearch" | "closePaneSearch" | "togglePaneSearch" | "isPaneSearchOpen" | "getSearchUiStyleOptions" | "setSearchUiStyleOptions">): ResttyPaneHandle[];
+export declare function pane(lookup: Pick<ResttyPaneLookup, "getPaneById" | "openPaneSearch" | "closePaneSearch" | "togglePaneSearch" | "isPaneSearchOpen" | "getSearchUiStyleOptions" | "setSearchUiStyleOptions">, id: number): ResttyPaneHandle | null;
+export declare function activePane(lookup: Pick<ResttyPaneLookup, "getActivePane" | "getPaneById" | "openPaneSearch" | "closePaneSearch" | "togglePaneSearch" | "isPaneSearchOpen" | "getSearchUiStyleOptions" | "setSearchUiStyleOptions">): ResttyPaneHandle | null;
+export declare function focusedPane(lookup: Pick<ResttyPaneLookup, "getFocusedPane" | "getPaneById" | "openPaneSearch" | "closePaneSearch" | "togglePaneSearch" | "isPaneSearchOpen" | "getSearchUiStyleOptions" | "setSearchUiStyleOptions">): ResttyPaneHandle | null;
+export declare function forEachPane(lookup: Pick<ResttyPaneLookup, "getPanes" | "getPaneById" | "openPaneSearch" | "closePaneSearch" | "togglePaneSearch" | "isPaneSearchOpen" | "getSearchUiStyleOptions" | "setSearchUiStyleOptions">, visitor: (pane: ResttyPaneHandle) => void): void;
 export declare function createInitialPane(paneManager: ResttyPaneManager<ResttyManagedAppPane>, hooks: Pick<ResttyLifecycleEmitter, "runLifecycleHooks">, options?: {
     focus?: boolean;
 }): ResttyManagedAppPane;
@@ -39,4 +46,6 @@ export declare function focus(lookup: Pick<ResttyPaneLookup, "getActivePane" | "
 export declare function blur(lookup: Pick<ResttyPaneLookup, "getActivePane" | "getPaneById">, hooks: ResttyLifecycleEmitter): void;
 export declare function getPaneStyleOptions(paneManager: ResttyPaneManager<ResttyManagedAppPane>): Readonly<Required<ResttyManagedPaneStyleOptions>>;
 export declare function setPaneStyleOptions(paneManager: ResttyPaneManager<ResttyManagedAppPane>, options: ResttyManagedPaneStyleOptions): void;
+export declare function getSearchUiStyleOptions(paneManager: Pick<ResttyAppPaneManager, "getSearchUiStyleOptions">): Readonly<Required<ResttyManagedPaneSearchUiStyleOptions>>;
+export declare function setSearchUiStyleOptions(paneManager: Pick<ResttyAppPaneManager, "setSearchUiStyleOptions">, options: ResttyManagedPaneSearchUiStyleOptions): void;
 export {};

package/dist/surface/restty-pane-handle.d.ts

@@ -1,7 +1,16 @@
 import type { InputHandler, MouseMode } from "../input";
 import type { GhosttyTheme } from "../theme";
-import type { ResttyManagedAppPane } from "./pane-app-manager";
-import type { ResttyShaderStage } from "../runtime/types";
+import type { ResttyManagedAppPane, ResttyManagedPaneSearchUiStyleOptions } from "./pane-app-manager";
+import type { ResttySearchState, ResttyShaderStage } from "../runtime/types";
+import type { ResttyPaneSearchUiCloseOptions, ResttyPaneSearchUiOpenOptions } from "./pane-search-ui";
+type PaneSearchUiHandleOps = {
+    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<ResttyManagedPaneSearchUiStyleOptions>>;
+    setStyleOptions: (options: ResttyManagedPaneSearchUiStyleOptions) => void;
+};
 /**
  * Public API surface exposed by each pane handle.
  */
@@ -23,12 +32,24 @@ export type ResttyPaneApi = {
     getMouseStatus: () => ReturnType<InputHandler["getMouseStatus"]>;
     copySelectionToClipboard: () => Promise<boolean>;
     pasteFromClipboard: () => Promise<boolean>;
+    selectWordAtClientPoint: (clientX: number, clientY: number) => boolean;
+    setSearchQuery: (query: string) => void;
+    clearSearch: () => void;
+    searchNext: () => void;
+    searchPrevious: () => void;
+    getSearchState: () => ResttySearchState;
+    openSearch: (options?: ResttyPaneSearchUiOpenOptions) => void;
+    closeSearch: (options?: ResttyPaneSearchUiCloseOptions) => void;
+    toggleSearch: (options?: ResttyPaneSearchUiOpenOptions & ResttyPaneSearchUiCloseOptions) => void;
+    isSearchOpen: () => boolean;
     dumpAtlasForCodepoint: (cp: number) => void;
     resize: (cols: number, rows: number) => void;
     focus: () => void;
     blur: () => void;
     updateSize: (force?: boolean) => void;
     getBackend: () => string;
+    getSearchUiStyleOptions: () => Readonly<Required<ResttyManagedPaneSearchUiStyleOptions>>;
+    setSearchUiStyleOptions: (options: ResttyManagedPaneSearchUiStyleOptions) => void;
     setShaderStages: (stages: ResttyShaderStage[]) => void;
     getShaderStages: () => ResttyShaderStage[];
     getRawPane: () => ResttyManagedAppPane;
@@ -40,7 +61,8 @@ export type ResttyPaneApi = {
  */
 export declare class ResttyPaneHandle implements ResttyPaneApi {
     private readonly resolvePane;
-    constructor(resolvePane: () => ResttyManagedAppPane);
+    private readonly searchUiOps;
+    constructor(resolvePane: () => ResttyManagedAppPane, searchUiOps: PaneSearchUiHandleOps);
     get id(): number;
     setRenderer(value: "auto" | "webgpu" | "webgl2"): void;
     setPaused(value: boolean): void;
@@ -58,13 +80,26 @@ export declare class ResttyPaneHandle implements ResttyPaneApi {
     getMouseStatus(): ReturnType<InputHandler["getMouseStatus"]>;
     copySelectionToClipboard(): Promise<boolean>;
     pasteFromClipboard(): Promise<boolean>;
+    selectWordAtClientPoint(clientX: number, clientY: number): boolean;
+    setSearchQuery(query: string): void;
+    clearSearch(): void;
+    searchNext(): void;
+    searchPrevious(): void;
+    getSearchState(): ResttySearchState;
+    openSearch(options?: ResttyPaneSearchUiOpenOptions): void;
+    closeSearch(options?: ResttyPaneSearchUiCloseOptions): void;
+    toggleSearch(options?: ResttyPaneSearchUiOpenOptions & ResttyPaneSearchUiCloseOptions): void;
+    isSearchOpen(): boolean;
     dumpAtlasForCodepoint(cp: number): void;
     resize(cols: number, rows: number): void;
     focus(): void;
     blur(): void;
     updateSize(force?: boolean): void;
     getBackend(): string;
+    getSearchUiStyleOptions(): Readonly<Required<ResttyManagedPaneSearchUiStyleOptions>>;
+    setSearchUiStyleOptions(options: ResttyManagedPaneSearchUiStyleOptions): void;
     setShaderStages(stages: ResttyShaderStage[]): void;
     getShaderStages(): ResttyShaderStage[];
     getRawPane(): ResttyManagedAppPane;
 }
+export {};

package/dist/surface/restty.d.ts

@@ -1,6 +1,6 @@
 import type { DesktopNotification } from "../input";
-import { type CreateResttyAppPaneManagerOptions, type ResttyManagedAppPane, type ResttyManagedPaneStyleOptions, type ResttyPaneAppOptionsInput } from "./pane-app-manager";
-import type { ResttyPaneManager, ResttyPaneSplitDirection } from "./panes-types";
+import { type ResttyAppPaneManager, type CreateResttyAppPaneManagerOptions, type ResttyManagedAppPane, type ResttyManagedPaneStyleOptions, type ResttyManagedPaneSearchUiStyleOptions, type ResttyPaneAppOptionsInput } from "./pane-app-manager";
+import type { ResttyPaneSplitDirection } from "./panes-types";
 import type { ResttyFontSource, ResttyShaderStage } from "../runtime/types";
 import { ResttyPaneHandle } from "./restty-pane-handle";
 import { ResttyActivePaneApi } from "./restty/active-pane-api";
@@ -34,7 +34,7 @@ export type ResttyOptions = Omit<CreateResttyAppPaneManagerOptions, "appOptions"
  * convenience methods that operate on the active pane.
  */
 export declare class Restty extends ResttyActivePaneApi {
-    readonly paneManager: ResttyPaneManager<ResttyManagedAppPane>;
+    readonly paneManager: ResttyAppPaneManager;
     private fontSources;
     private readonly shaderOps;
     private readonly pluginOps;
@@ -61,6 +61,8 @@ export declare class Restty extends ResttyActivePaneApi {
     closePane(id: number): boolean;
     getPaneStyleOptions(): Readonly<Required<ResttyManagedPaneStyleOptions>>;
     setPaneStyleOptions(options: ResttyManagedPaneStyleOptions): void;
+    getSearchUiStyleOptions(): Readonly<Required<ResttyManagedPaneSearchUiStyleOptions>>;
+    setSearchUiStyleOptions(options: ResttyManagedPaneSearchUiStyleOptions): void;
     setActivePane(id: number, options?: {
         focus?: boolean;
     }): void;

package/dist/theme/ghostty.d.ts

@@ -5,6 +5,7 @@ export type ThemeColor = {
     b: number;
     a?: number;
 };
+export type ThemeTerminalColor = ThemeColor | "cell-foreground" | "cell-background";
 /**
  * Parsed Ghostty terminal theme with semantic colors and full 256-color palette.
  */
@@ -22,9 +23,17 @@ export type GhosttyTheme = {
         /** Text color under the cursor. */
         cursorText?: ThemeColor;
         /** Selection background color. */
-        selectionBackground?: ThemeColor;
+        selectionBackground?: ThemeTerminalColor;
         /** Selection foreground (text) color. */
-        selectionForeground?: ThemeColor;
+        selectionForeground?: ThemeTerminalColor;
+        /** Search match background color. */
+        searchBackground?: ThemeTerminalColor;
+        /** Search match foreground color. */
+        searchForeground?: ThemeTerminalColor;
+        /** Active search match background color. */
+        searchSelectedBackground?: ThemeTerminalColor;
+        /** Active search match foreground color. */
+        searchSelectedForeground?: ThemeTerminalColor;
         /** 256-color palette (indices 0-255). */
         palette: Array<ThemeColor | undefined>;
     };
@@ -33,6 +42,8 @@ export type GhosttyTheme = {
 };
 /** Parse a Ghostty color value (hex, rgb/rgba, or named color). */
 export declare function parseGhosttyColor(value: string): ThemeColor | null;
+/** Parse a Ghostty TerminalColor value. */
+export declare function parseGhosttyTerminalColor(value: string): ThemeTerminalColor | null;
 /** Convert ThemeColor to normalized RGBA floats (0.0-1.0). */
 export declare function colorToFloats(color: ThemeColor, alphaOverride?: number): [number, number, number, number];
 /** Convert ThemeColor to packed 24-bit RGB integer (0xRRGGBB). */

package/dist/wasm/index.d.ts

@@ -1,2 +1,2 @@
-export type { CursorInfo, KittyPlacement, RenderState, ResttyWasmExports, ResttyWasmOptions, WasmAbi, WasmAbiKind, } from "./runtime/types";
+export type { CursorInfo, KittyPlacement, RenderState, SearchStatus, SearchViewportMatch, ResttyWasmExports, ResttyWasmOptions, WasmAbi, WasmAbiKind, } from "./runtime/types";
 export { ResttyWasm, loadResttyWasm } from "./runtime/restty-wasm";

package/dist/wasm/runtime/restty-wasm.d.ts

@@ -1,4 +1,4 @@
-import type { KittyPlacement, RenderState, ResttyWasmExports, ResttyWasmOptions, WasmAbi } from "./types";
+import type { KittyPlacement, RenderState, ResttyWasmExports, ResttyWasmOptions, SearchStatus, SearchViewportMatch, WasmAbi } from "./types";
 /** WASM terminal core runtime with memory management and typed array caching. */
 export declare class ResttyWasm {
     readonly exports: ResttyWasmExports;
@@ -25,6 +25,20 @@ export declare class ResttyWasm {
     drainOutput(handle: number): string;
     /** Get active Kitty keyboard protocol flags. */
     getKittyKeyboardFlags(handle: number): number;
+    /** Set the active terminal search query. */
+    setSearchQuery(handle: number, query: string): void;
+    /** Clear the active terminal search query and results. */
+    clearSearch(handle: number): void;
+    /** Advance terminal search work by a bounded budget. */
+    stepSearch(handle: number, budget: number): void;
+    /** Select the next search match. */
+    searchNext(handle: number): void;
+    /** Select the previous search match. */
+    searchPrevious(handle: number): void;
+    /** Get the current terminal search status. */
+    getSearchStatus(handle: number): SearchStatus;
+    /** Get visible search-highlight spans for the current viewport. */
+    getSearchViewportMatches(handle: number): SearchViewportMatch[];
     /** Get all active Kitty graphics placements. */
     getKittyPlacements(handle: number): KittyPlacement[];
     /** Write text to terminal for processing. */

package/dist/wasm/runtime/types.d.ts

@@ -19,6 +19,22 @@ export type CursorInfo = {
     wideTail: number;
     color: number;
 };
+/** Search status snapshot from the WASM terminal core. */
+export type SearchStatus = {
+    active: boolean;
+    pending: boolean;
+    complete: boolean;
+    generation: number;
+    totalMatches: number;
+    selectedIndex: number | null;
+};
+/** Visible search-highlight span in viewport coordinates. */
+export type SearchViewportMatch = {
+    row: number;
+    startCol: number;
+    endCol: number;
+    selected: boolean;
+};
 /** Kitty graphics protocol image placement descriptor. */
 export type KittyPlacement = {
     imageId: number;
@@ -138,6 +154,14 @@ export type ResttyWasmExports = WebAssembly.Exports & {
     restty_kitty_placement_stride?: () => number;
     restty_kitty_placement_count?: (handle: number) => number;
     restty_kitty_placements_ptr?: (handle: number) => number;
+    restty_search_set_query?: (handle: number, ptr: number, len: number) => number;
+    restty_search_clear?: (handle: number) => number;
+    restty_search_step?: (handle: number, budget: number) => number;
+    restty_search_status_ptr?: (handle: number) => number;
+    restty_search_viewport_match_count?: (handle: number) => number;
+    restty_search_viewport_matches_ptr?: (handle: number) => number;
+    restty_search_select_next?: (handle: number) => number;
+    restty_search_select_prev?: (handle: number) => number;
 };
 /** Construction options for WASM runtime. */
 export type ResttyWasmOptions = {