restty 0.1.34 → 0.2.0

package/dist/surface/restty.d.ts

@@ -1,66 +1,53 @@
-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 { ResttyFontSource, ResttyShaderStage } from "../runtime/types";
-import { ResttyPaneHandle } from "./restty-pane-handle";
+import type { ResttyFontInput, ResttyShaderStage } from "../runtime/core/models";
+import type { ResttyManagedPaneManager, ResttyManagedPaneSearchUiStyleOptions, ResttyManagedPaneStyleOptions } from "./panes/managed-pane-types";
+import { ResttyPaneHandle } from "./restty/pane-handle";
 import { ResttyActivePaneApi } from "./restty/active-pane-api";
-import { type ResttyPluginInfo, type ResttyPluginManifestEntry, type ResttyPluginRegistry, type ResttyPluginLoadResult, type ResttyRenderStageHandle, type ResttyPlugin } from "./restty-plugin-types";
-export { ResttyPaneHandle } from "./restty-pane-handle";
-export type { ResttyPaneApi } from "./restty-pane-handle";
-export { RESTTY_PLUGIN_API_VERSION } from "./restty-plugin-types";
-export type { ResttyPluginApiRange, ResttyPluginRequires, ResttyPluginInfo, ResttyPluginManifestEntry, ResttyPluginRegistryEntry, ResttyPluginRegistry, ResttyPluginLoadStatus, ResttyPluginLoadResult, ResttyPluginEvents, ResttyPluginDisposable, ResttyPluginCleanup, ResttyInputInterceptorPayload, ResttyOutputInterceptorPayload, ResttyInputInterceptor, ResttyOutputInterceptor, ResttyLifecycleHookPayload, ResttyLifecycleHook, ResttyRenderHookPayload, ResttyRenderHook, ResttyInterceptorOptions, ResttyRenderStageHandle, ResttyPluginContext, ResttyPlugin, } from "./restty-plugin-types";
-/**
- * Top-level configuration for creating a Restty instance.
- */
-export type ResttyOptions = Omit<CreateResttyAppPaneManagerOptions, "appOptions"> & {
-    /** Per-pane app options, static or factory. */
-    appOptions?: CreateResttyAppPaneManagerOptions["appOptions"];
-    /** Font sources applied to every pane. */
-    fontSources?: ResttyPaneAppOptionsInput["fontSources"];
-    /** Global shader stages synchronized to all panes. */
-    shaderStages?: ResttyShaderStage[];
-    /** Global handler for desktop notifications emitted by any pane. */
-    onDesktopNotification?: (notification: DesktopNotification & {
-        paneId: number;
-    }) => void;
-    /** Whether to create the first pane automatically (default true). */
-    createInitialPane?: boolean | {
-        focus?: boolean;
-    };
-};
+import { type ResttyPluginInfo, type ResttyPluginManifestEntry, type ResttyPluginRegistry, type ResttyPluginLoadResult } from "./plugins/types";
+import type { ResttyRenderStageHandle, ResttyPlugin } from "./plugins/context.types";
+import type { ResttyConfig } from "./restty/config";
+import type { ResttySurfacePane } from "./restty/events";
+export { ResttyPaneHandle } from "./restty/pane-handle";
+export type { ResttyPaneApi } from "./restty/pane-handle";
+export { RESTTY_PLUGIN_API_VERSION } from "./plugins/types";
+export type { ResttyPluginApiRange, ResttyPluginRequires, ResttyPluginInfo, ResttyPluginManifestEntry, ResttyPluginRegistryEntry, ResttyPluginRegistry, ResttyPluginLoadStatus, ResttyPluginLoadResult, ResttyPluginEvents, ResttyPluginDisposable, ResttyPluginCleanup, ResttyPluginHostApi, ResttyInputInterceptorPayload, ResttyOutputInterceptorPayload, ResttyInputInterceptor, ResttyOutputInterceptor, ResttyLifecycleHookPayload, ResttyLifecycleHook, ResttyRenderHookPayload, ResttyRenderHook, ResttyInterceptorOptions, ResttyRenderStageHandle, ResttyPluginContext, ResttyPlugin, } from "./plugins/types";
+export type { ResttyConfig, ResttyServicesConfig, ResttyServicesConfigInput, ResttySurfaceConfig, } from "./restty/config";
+export type { ResttySurfaceEvents, ResttySurfacePane } from "./restty/events";
 /**
  * Main entry point for the restty terminal widget. Manages a set of
- * split panes, each running its own terminal app, and exposes
+ * split panes, each running its own terminal runtime, and exposes
  * convenience methods that operate on the active pane.
  */
 export declare class Restty extends ResttyActivePaneApi {
-    readonly paneManager: ResttyPaneManager<ResttyManagedAppPane>;
-    private fontSources;
+    readonly paneManager: ResttyManagedPaneManager;
+    private fonts;
     private readonly shaderOps;
-    private readonly pluginOps;
-    constructor(options: ResttyOptions);
-    getPanes(): ResttyManagedAppPane[];
-    getPaneById(id: number): ResttyManagedAppPane | null;
-    getActivePane(): ResttyManagedAppPane | null;
-    getFocusedPane(): ResttyManagedAppPane | null;
+    private readonly controller;
+    private readonly paneLookupOps;
+    constructor(options: ResttyConfig);
+    getPanes(): ResttySurfacePane[];
+    getPaneById(id: number): ResttySurfacePane | null;
+    getActivePane(): ResttySurfacePane | null;
+    getFocusedPane(): ResttySurfacePane | null;
     panes(): ResttyPaneHandle[];
     pane(id: number): ResttyPaneHandle | null;
     activePane(): ResttyPaneHandle | null;
     focusedPane(): ResttyPaneHandle | null;
     forEachPane(visitor: (pane: ResttyPaneHandle) => void): void;
-    setFontSources(sources: ResttyFontSource[]): Promise<void>;
+    setFonts(fonts: ResttyFontInput[]): Promise<void>;
     setShaderStages(stages: ResttyShaderStage[]): void;
     getShaderStages(): ResttyShaderStage[];
     addShaderStage(stage: ResttyShaderStage): ResttyRenderStageHandle;
     removeShaderStage(id: string): boolean;
     createInitialPane(options?: {
         focus?: boolean;
-    }): ResttyManagedAppPane;
-    splitActivePane(direction: ResttyPaneSplitDirection): ResttyManagedAppPane | null;
-    splitPane(id: number, direction: ResttyPaneSplitDirection): ResttyManagedAppPane | null;
+    }): ResttySurfacePane;
+    splitActivePane(direction: ResttyPaneSplitDirection): ResttySurfacePane | null;
+    splitPane(id: number, direction: ResttyPaneSplitDirection): ResttySurfacePane | null;
     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;
@@ -81,13 +68,7 @@ export declare class Restty extends ResttyActivePaneApi {
     resize(cols: number, rows: number): void;
     focus(): void;
     blur(): void;
-    private paneLookup;
-    private lifecycleHooks;
-    private lifecycleAndPluginHooks;
     protected requireActivePaneHandle(): ResttyPaneHandle;
-    private runLifecycleHooks;
-    private runRenderHooks;
-    private emitPluginEvent;
 }
 /** Create a new Restty instance with the given options. */
-export declare function createRestty(options: ResttyOptions): Restty;
+export declare function createRestty(options: ResttyConfig): Restty;

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

@@ -0,0 +1,2 @@
+import type { CreatePaneSearchUiControllerOptions, PaneSearchUiController } from "./types";
+export declare function createPaneSearchUiController(options: CreatePaneSearchUiControllerOptions): PaneSearchUiController;

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

@@ -0,0 +1,2 @@
+export { createPaneSearchUiController } from "./controller";
+export type { CreatePaneSearchUiControllerOptions, PaneSearchUiController, ResttyPaneSearchUiCloseOptions, ResttyPaneSearchUiOpenOptions, ResttyPaneSearchUiOptions, ResttyPaneSearchUiPane, ResttyPaneSearchUiShortcutOptions, ResttyPaneSearchUiStyleOptions, } from "./types";

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

@@ -0,0 +1,5 @@
+import type { ResttyPaneSearchUiStyleOptions } from "./types";
+export declare function normalizeSearchUiStyleOptions(options: ResttyPaneSearchUiStyleOptions | undefined): Required<ResttyPaneSearchUiStyleOptions>;
+export declare function ensurePaneSearchUiStyles(doc: Document): void;
+export declare function applySearchUiStyleOptions(root: HTMLElement, options: Readonly<Required<ResttyPaneSearchUiStyleOptions>>): void;
+export declare function clearSearchUiStyleOptions(root: HTMLElement): void;

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

@@ -0,0 +1,96 @@
+import type { ResttyRuntimeSearchApi } from "../../runtime/core/api";
+import type { ResttySearchState } from "../../runtime/core/models";
+export type ResttyPaneSearchUiPane = {
+    id: number;
+    container: HTMLDivElement;
+    focusTarget?: HTMLElement | null;
+    setSearchQuery: ResttyRuntimeSearchApi["setQuery"];
+    clearSearch: ResttyRuntimeSearchApi["clear"];
+    searchNext: ResttyRuntimeSearchApi["next"];
+    searchPrevious: ResttyRuntimeSearchApi["previous"];
+    getSearchState: ResttyRuntimeSearchApi["getState"];
+};
+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 type CreatePaneSearchUiControllerOptions = {
+    root: HTMLElement;
+    enabled?: boolean;
+    placeholder?: string;
+    previousButtonText?: string;
+    nextButtonText?: string;
+    clearButtonText?: string;
+    closeButtonText?: string;
+    statusFormatter?: (state: ResttySearchState) => string;
+    shortcut?: boolean | ResttyPaneSearchUiShortcutOptions;
+    styles?: ResttyPaneSearchUiStyleOptions;
+    getActivePane: () => ResttyPaneSearchUiPane | null;
+    getFocusedPane: () => ResttyPaneSearchUiPane | null;
+};
+export type PaneSearchUiState = {
+    pane: ResttyPaneSearchUiPane;
+    root: HTMLDivElement;
+    input: HTMLInputElement;
+    prevButton: HTMLButtonElement;
+    nextButton: HTMLButtonElement;
+    clearButton: HTMLButtonElement;
+    closeButton: HTMLButtonElement;
+    status: HTMLDivElement;
+    cleanupFns: Array<() => void>;
+    state: ResttySearchState;
+    open: boolean;
+};

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/embedded.d.ts

@@ -1 +1 @@
-export declare const WASM_BASE64: string;
+export declare const WASM_BINARY: string;

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;
@@ -125,12 +141,6 @@ export type ResttyWasmExports = WebAssembly.Exports & {
     restty_link_buffer_len?: (handle: number) => number;
     restty_active_cursor_x?: (handle: number) => number;
     restty_active_cursor_y?: (handle: number) => number;
-    restty_debug_scroll_left?: (handle: number) => number;
-    restty_debug_scroll_right?: (handle: number) => number;
-    restty_debug_term_cols?: (handle: number) => number;
-    restty_debug_term_rows?: (handle: number) => number;
-    restty_debug_page_cols?: (handle: number) => number;
-    restty_debug_page_rows?: (handle: number) => number;
     restty_output_ptr?: (handle: number) => number;
     restty_output_len?: (handle: number) => number;
     restty_output_consume?: (handle: number, len: number) => number;
@@ -138,6 +148,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 = {

package/dist/xterm/compat-services.d.ts

@@ -0,0 +1,2 @@
+import type { ResttyConfig } from "../surface/restty";
+export declare function createCompatServicesConfig(userServicesConfig: ResttyConfig["services"], emitData: (data: string) => void): ResttyConfig["services"];

package/dist/xterm.d.ts

@@ -1,4 +1,4 @@
-import { type Restty, type ResttyOptions } from "./surface/restty";
+import { type Restty, type ResttyConfig } from "./surface/restty";
 export type IDisposable = {
     dispose: () => void;
 };
@@ -20,7 +20,7 @@ export type TerminalAddon = {
  * Additional unknown keys are accepted for migration ergonomics and kept in
  * the terminal option bag, but are not forwarded to restty internals.
  */
-export type TerminalOptions = Omit<ResttyOptions, "root"> & {
+export type TerminalOptions = Omit<ResttyConfig, "root"> & {
     cols?: number;
     rows?: number;
     [key: string]: unknown;
@@ -32,7 +32,8 @@ export type TerminalOptions = Omit<ResttyOptions, "root"> & {
  */
 export declare class Terminal {
     private readonly resttyOptionsBase;
-    private readonly userAppOptions;
+    private readonly userTerminalConfig;
+    private readonly userServicesConfig;
     private readonly addons;
     private readonly pendingOutput;
     private readonly dataListeners;

package/dist/xterm.js

@@ -1,11 +1,14 @@
 import {
   createRestty
-} from "./chunk-meqn8xtd.js";
+} from "./chunk-wdme6j9c.js";
+import"./chunk-y6hfk43b.js";
+import"./chunk-db9dt7pr.js";
+import"./chunk-s26trws6.js";
 
-// src/xterm/app-options.ts
-function createCompatAppOptions(userAppOptions, emitData) {
+// src/xterm/compat-services.ts
+function createCompatServicesConfig(userServicesConfig, emitData) {
   return (context) => {
-    const resolved = typeof userAppOptions === "function" ? userAppOptions(context) : userAppOptions ?? {};
+    const resolved = typeof userServicesConfig === "function" ? userServicesConfig(context) : userServicesConfig ?? {};
     const userBeforeInput = resolved.beforeInput;
     return {
       ...resolved,
@@ -53,7 +56,8 @@ function emitWithGuard(bucket, payload, label) {
 // src/xterm.ts
 class Terminal {
   resttyOptionsBase;
-  userAppOptions;
+  userTerminalConfig;
+  userServicesConfig;
   addons = new Set;
   pendingOutput = [];
   dataListeners = new Set;
@@ -67,9 +71,10 @@ class Terminal {
   cols;
   rows;
   constructor(options = {}) {
-    const { cols, rows, appOptions, ...resttyOptionsBase } = options;
+    const { cols, rows, terminal, services, ...resttyOptionsBase } = options;
     this.resttyOptionsBase = resttyOptionsBase;
-    this.userAppOptions = appOptions;
+    this.userTerminalConfig = terminal;
+    this.userServicesConfig = services;
     this.optionValues = { ...options };
     delete this.optionValues.cols;
     delete this.optionValues.rows;
@@ -105,7 +110,8 @@ class Terminal {
     this.elementRef = parent;
     this.resttyInstance = createRestty({
       ...this.resttyOptionsBase,
-      appOptions: createCompatAppOptions(this.userAppOptions, (data) => {
+      terminal: this.userTerminalConfig,
+      services: createCompatServicesConfig(this.userServicesConfig, (data) => {
         emitWithGuard(this.dataListeners, data, "onData");
       }),
       root: parent

package/package.json

@@ -1,32 +1,32 @@
 {
   "name": "restty",
-  "version": "0.1.34",
+  "version": "0.2.0",
   "description": "Browser terminal rendering library powered by WASM, WebGPU/WebGL2, and TypeScript text shaping.",
   "keywords": [
-    "terminal",
-    "terminal-emulator",
-    "tty",
     "ansi",
-    "vt",
+    "font-shaping",
     "ghostty",
-    "webgpu",
-    "webgl2",
-    "wasm",
+    "terminal",
+    "terminal-emulator",
     "text-shaper",
     "text-shaping",
+    "tty",
+    "typescript",
     "unicode",
-    "font-shaping",
-    "typescript"
+    "vt",
+    "wasm",
+    "webgl2",
+    "webgpu"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/wiedymi/restty"
-  },
+  "homepage": "https://github.com/wiedymi/restty#readme",
   "bugs": {
     "url": "https://github.com/wiedymi/restty/issues"
   },
-  "homepage": "https://github.com/wiedymi/restty#readme",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wiedymi/restty"
+  },
   "files": [
     "dist",
     "README.md",
@@ -47,10 +47,30 @@
       "import": "./dist/internal.js",
       "default": "./dist/internal.js"
     },
+    "./internal/runtime": {
+      "types": "./dist/internal/runtime.d.ts",
+      "import": "./dist/internal/runtime.js",
+      "default": "./dist/internal/runtime.js"
+    },
+    "./internal/surface": {
+      "types": "./dist/internal/surface.d.ts",
+      "import": "./dist/internal/surface.js",
+      "default": "./dist/internal/surface.js"
+    },
     "./xterm": {
       "types": "./dist/xterm.d.ts",
       "import": "./dist/xterm.js",
       "default": "./dist/xterm.js"
+    },
+    "./headless": {
+      "types": "./dist/headless.d.ts",
+      "import": "./dist/headless.js",
+      "default": "./dist/headless.js"
+    },
+    "./esm": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/restty.esm.js",
+      "default": "./dist/restty.esm.js"
     }
   },
   "scripts": {
@@ -59,10 +79,11 @@
     "build:themes": "bun run scripts/generate-builtin-themes.ts",
     "build:wasm": "bun run scripts/build-wasm.ts",
     "build:lib": "bun run scripts/build-lib.ts",
+    "build:esm": "bun run scripts/build-esm.ts",
     "build:types": "tsc -p tsconfig.build.json",
-    "build": "bun run build:themes && bun run clean:dist && bun run build:lib && bun run build:types",
-    "build:playground-app": "bun run playground/build-playground-app.ts",
-    "build:assets": "bun run build:playground-app",
+    "build": "bun run build:themes && bun run clean:dist && bun run build:lib && bun run build:esm && bun run build:types",
+    "playground:build": "bunx vite build --config playground/vite.config.ts",
+    "pages:build": "bun run playground:build",
     "check:themes": "bun run build:themes && git diff --exit-code -- src/theme/builtin-themes.ts",
     "lint": "oxlint src playground scripts tests",
     "format:base": "oxfmt src --config .oxfmtrc.json --ignore-path .gitignore --ignore-path .oxfmtignore",
@@ -71,19 +92,33 @@
     "prepublishOnly": "bun run build",
     "test": "bun test ./tests",
     "test:ci": "bun test $(find tests -name '*.test.ts' ! -name 'webgpu-glyph.test.ts' | sort)",
-    "pty": "bun run playground/pty-server.ts",
     "playground": "bun run scripts/playground-dev.ts",
-    "playground:static": "bun run playground/server.ts"
+    "playground:pty": "bun run playground/pty-server.ts",
+    "playground:preview": "bun run playground/server.ts"
   },
   "dependencies": {
-    "text-shaper": "^0.1.18"
+    "text-shaper": "0.1.23"
   },
   "devDependencies": {
-    "@webcontainer/api": "^1.6.1",
+    "@tailwindcss/vite": "^4.2.4",
+    "@types/mdx": "^2.0.13",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@webcontainer/api": "^1.6.4",
     "@webgpu/types": "^0.1.69",
-    "oxfmt": "^0.28.0",
-    "oxlint": "^1.19.0",
+    "fumadocs-core": "^16.8.7",
+    "fumadocs-mdx": "^14.3.2",
+    "fumadocs-ui": "^16.8.7",
+    "just-bash": "^2.14.4",
+    "oxfmt": "^0.47.0",
+    "oxlint": "^1.62.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-router": "^7.14.2",
+    "tailwindcss": "^4.2.4",
     "typescript": "^5.9.3",
+    "vite": "^8.0.10",
     "wgpu-polyfill": "^0.1.0"
   },
   "engines": {