restty 0.1.35 → 0.2.0

package/dist/surface/restty.d.ts

@@ -1,63 +1,48 @@
-import type { DesktopNotification } from "../input";
-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 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: ResttyAppPaneManager;
-    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;
@@ -83,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/{pane-search-ui.d.ts → search-ui/types.d.ts}

@@ -1,16 +1,14 @@
-import type { ResttySearchState } from "../runtime/types";
-type SearchUiPaneApp = {
-    setSearchQuery: (query: string) => void;
-    clearSearch: () => void;
-    searchNext: () => void;
-    searchPrevious: () => void;
-    getSearchState: () => ResttySearchState;
-};
+import type { ResttyRuntimeSearchApi } from "../../runtime/core/api";
+import type { ResttySearchState } from "../../runtime/core/models";
 export type ResttyPaneSearchUiPane = {
     id: number;
     container: HTMLDivElement;
     focusTarget?: HTMLElement | null;
-    app: SearchUiPaneApp;
+    setSearchQuery: ResttyRuntimeSearchApi["setQuery"];
+    clearSearch: ResttyRuntimeSearchApi["clear"];
+    searchNext: ResttyRuntimeSearchApi["next"];
+    searchPrevious: ResttyRuntimeSearchApi["previous"];
+    getSearchState: ResttyRuntimeSearchApi["getState"];
 };
 export type ResttyPaneSearchUiStyleOptions = {
     offsetTopPx?: number;
@@ -69,7 +67,7 @@ export type PaneSearchUiController = {
     setStyleOptions: (options: ResttyPaneSearchUiStyleOptions) => void;
     destroy: () => void;
 };
-export declare function createPaneSearchUiController(options: {
+export type CreatePaneSearchUiControllerOptions = {
     root: HTMLElement;
     enabled?: boolean;
     placeholder?: string;
@@ -80,8 +78,19 @@ export declare function createPaneSearchUiController(options: {
     statusFormatter?: (state: ResttySearchState) => string;
     shortcut?: boolean | ResttyPaneSearchUiShortcutOptions;
     styles?: ResttyPaneSearchUiStyleOptions;
-    getPaneById: (paneId: number) => ResttyPaneSearchUiPane | null;
     getActivePane: () => ResttyPaneSearchUiPane | null;
     getFocusedPane: () => ResttyPaneSearchUiPane | null;
-}): PaneSearchUiController;
-export {};
+};
+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/wasm/embedded.d.ts

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

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

@@ -141,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;

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-zqscavsh.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.35",
+  "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,25 +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"
-    },
-    "./esm/internal": {
-      "types": "./dist/internal.d.ts",
-      "import": "./dist/internal.esm.js",
-      "default": "./dist/internal.esm.js"
-    },
-    "./esm/xterm": {
-      "types": "./dist/xterm.d.ts",
-      "import": "./dist/xterm.esm.js",
-      "default": "./dist/xterm.esm.js"
     }
   },
   "scripts": {
@@ -77,8 +82,8 @@
     "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:esm && bun run build:types",
-    "build:playground-app": "bun run playground/build-playground-app.ts",
-    "build:assets": "bun run build:playground-app",
+    "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",
@@ -87,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.22"
+    "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": {