@mks2508/mks-ui 0.6.7 → 0.7.0

package/dist/react-ui/blocks/Terminal/restty/ResttySessionProvider.js

@@ -0,0 +1,60 @@
+'use client';
+
+import { createContext, useContext, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/react-ui/blocks/Terminal/restty/ResttySessionProvider.tsx
+/**
+* ResttySessionProvider — React Context for sharing WASM + WebGPU resources.
+*
+* Wrapping N `ResttyTerminal` instances in a single `ResttySessionProvider`
+* ensures they share one WASM module (~2 MB) and one WebGPU core instead of
+* loading duplicates.
+*
+* @example
+* ```tsx
+* <ResttySessionProvider>
+*   <ResttyTerminal wsUrl="ws://localhost:14421/terminal" />
+*   <ResttyTerminal wsUrl="ws://localhost:14421/terminal" />
+* </ResttySessionProvider>
+* ```
+*
+* @module Terminal/restty/ResttySessionProvider
+*/
+const ResttySessionContext = createContext(null);
+/**
+* Provides a shared ResttyAppSession to all descendant ResttyTerminal instances.
+*
+* The session is lazily created on first access via dynamic import to keep
+* the WASM + WebGPU initialization out of the critical render path and
+* to remain SSR-safe.
+*/
+function ResttySessionProvider({ session: externalSession, children }) {
+	const sessionRef = useRef(externalSession ?? null);
+	const promiseRef = useRef(null);
+	return /* @__PURE__ */ jsx(ResttySessionContext.Provider, {
+		value: { getSession: () => {
+			if (sessionRef.current) return Promise.resolve(sessionRef.current);
+			if (promiseRef.current) return promiseRef.current;
+			promiseRef.current = import("@mks2508/restty").then(({ createResttyAppSession }) => {
+				const s = createResttyAppSession();
+				sessionRef.current = s;
+				return s;
+			});
+			return promiseRef.current;
+		} },
+		children
+	});
+}
+/**
+* Access the shared ResttyAppSession from context.
+*
+* Returns `null` when called outside a `ResttySessionProvider` — in that
+* case `ResttyTerminal` will create its own session automatically.
+*/
+function useResttySession() {
+	return useContext(ResttySessionContext);
+}
+
+//#endregion
+export { ResttySessionProvider, useResttySession };

package/dist/react-ui/blocks/Terminal/restty/ResttyTerminal.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ResttyTerminal — first-class React component for restty GPU terminal.
+ *
+ * This is THE React frontend for restty. It exposes the full API:
+ * multi-pane splits, plugin system, session sharing, I/O hooks,
+ * theme catalog, font management, and GPU rendering control.
+ *
+ * @example
+ * ```tsx
+ * <ResttySessionProvider>
+ *   <ResttyTerminal
+ *     wsUrl="ws://localhost:14421/terminal"
+ *     fontSize={14}
+ *     resttyThemeName="Synthwave '84"
+ *     shortcuts
+ *     onResize={(cols, rows) => console.log(`${cols}x${rows}`)}
+ *   />
+ * </ResttySessionProvider>
+ * ```
+ *
+ * @module Terminal/restty/ResttyTerminal
+ */
+import type { IResttyTerminalProps, IResttyTerminalRef } from './ResttyTerminal.types';
+/**
+ * ResttyTerminal — full-featured React wrapper for the restty terminal engine.
+ *
+ * Handles lifecycle (dynamic WASM/WebGPU import, init, destroy), session
+ * sharing, pane management, plugin loading, theme application, and PTY
+ * connection via injectable transport.
+ */
+export declare const ResttyTerminal: import("react").ForwardRefExoticComponent<IResttyTerminalProps & import("react").RefAttributes<IResttyTerminalRef>>;
+//# sourceMappingURL=ResttyTerminal.d.ts.map

package/dist/react-ui/blocks/Terminal/restty/ResttyTerminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResttyTerminal.d.ts","sourceRoot":"","sources":["../../../../../src/react-ui/blocks/Terminal/restty/ResttyTerminal.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGvF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,qHA4V1B,CAAC"}

package/dist/react-ui/blocks/Terminal/restty/ResttyTerminal.js

@@ -0,0 +1,278 @@
+'use client';
+
+import { ResttyProvider } from "./ResttyContext.js";
+import { useResttySession } from "./ResttySessionProvider.js";
+import { getSynthwaveGhosttyTheme, xtermThemeToGhostty } from "../Terminal.theme.restty.js";
+import { forwardRef, useEffect, useImperativeHandle, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/react-ui/blocks/Terminal/restty/ResttyTerminal.tsx
+/**
+* ResttyTerminal — first-class React component for restty GPU terminal.
+*
+* This is THE React frontend for restty. It exposes the full API:
+* multi-pane splits, plugin system, session sharing, I/O hooks,
+* theme catalog, font management, and GPU rendering control.
+*
+* @example
+* ```tsx
+* <ResttySessionProvider>
+*   <ResttyTerminal
+*     wsUrl="ws://localhost:14421/terminal"
+*     fontSize={14}
+*     resttyThemeName="Synthwave '84"
+*     shortcuts
+*     onResize={(cols, rows) => console.log(`${cols}x${rows}`)}
+*   />
+* </ResttySessionProvider>
+* ```
+*
+* @module Terminal/restty/ResttyTerminal
+*/
+/**
+* ResttyTerminal — full-featured React wrapper for the restty terminal engine.
+*
+* Handles lifecycle (dynamic WASM/WebGPU import, init, destroy), session
+* sharing, pane management, plugin loading, theme application, and PTY
+* connection via injectable transport.
+*/
+const ResttyTerminal = forwardRef((props, ref) => {
+	const { wsUrl, createPtyTransport, fontSize = 14, theme, ghosttyTheme, resttyThemeName, gpuRenderer = "auto", fontSources, createInitialPane = true, shortcuts = false, defaultContextMenu = true, beforeInput, beforeRenderOutput, onPaneCreated, onPaneClosed, onPaneSplit, onActivePaneChange, onLayoutChanged, onReady, onResize, onPtyStatus, onConnect, onDisconnect, onError, onDesktopNotification, paused, plugins, pluginManifest, pluginRegistry, resttyOptions, className, style } = props;
+	const containerRef = useRef(null);
+	const resttyRef = useRef(null);
+	const didInitRef = useRef(false);
+	const activeThemeRef = useRef(null);
+	const destroyTimerRef = useRef(null);
+	const [isReady, setIsReady] = useState(false);
+	const cbRef = useRef({
+		onReady,
+		onResize,
+		onPtyStatus,
+		onConnect,
+		onDisconnect,
+		onError,
+		onDesktopNotification,
+		onPaneCreated,
+		onPaneClosed,
+		onPaneSplit,
+		onActivePaneChange,
+		onLayoutChanged,
+		beforeInput,
+		beforeRenderOutput
+	});
+	cbRef.current = {
+		onReady,
+		onResize,
+		onPtyStatus,
+		onConnect,
+		onDisconnect,
+		onError,
+		onDesktopNotification,
+		onPaneCreated,
+		onPaneClosed,
+		onPaneSplit,
+		onActivePaneChange,
+		onLayoutChanged,
+		beforeInput,
+		beforeRenderOutput
+	};
+	const sessionCtx = useResttySession();
+	useEffect(() => {
+		if (!containerRef.current) return;
+		if (didInitRef.current) return;
+		didInitRef.current = true;
+		let destroyed = false;
+		const init = async () => {
+			if (destroyTimerRef.current !== null) {
+				clearTimeout(destroyTimerRef.current);
+				destroyTimerRef.current = null;
+			}
+			const resttyModule = await import("@mks2508/restty");
+			if (destroyed || !containerRef.current) return;
+			const { Restty: ResttyClass, getBuiltinTheme, createResttyAppSession } = resttyModule;
+			let session;
+			if (sessionCtx) session = await sessionCtx.getSession();
+			else session = createResttyAppSession();
+			if (destroyed) return;
+			const appOptionsFactory = () => ({
+				renderer: gpuRenderer,
+				fontSize,
+				fontPreset: "default-cdn",
+				fontSources: fontSources ?? [{
+					type: "local",
+					matchers: [
+						"jetbrains mono",
+						"fira code",
+						"sf mono",
+						"cascadia code",
+						"meslo"
+					]
+				}],
+				autoResize: true,
+				...createPtyTransport ? { ptyTransport: createPtyTransport() } : {},
+				callbacks: {
+					onTermSize: (cols, rows) => cbRef.current.onResize?.(cols, rows),
+					onPtyStatus: (status) => cbRef.current.onPtyStatus?.(status)
+				},
+				beforeInput: cbRef.current.beforeInput ? (payload) => cbRef.current.beforeInput(payload) : void 0,
+				beforeRenderOutput: cbRef.current.beforeRenderOutput ? (payload) => cbRef.current.beforeRenderOutput(payload) : void 0,
+				...resttyOptions ?? {}
+			});
+			const restty = new ResttyClass({
+				root: containerRef.current,
+				session,
+				appOptions: appOptionsFactory,
+				onDesktopNotification: (n) => {
+					cbRef.current.onDesktopNotification?.(n);
+				},
+				onPaneCreated: (pane) => {
+					if (resttyRef.current) {
+						const handle = resttyRef.current.pane(pane.id);
+						if (handle) {
+							if (activeThemeRef.current) handle.applyTheme(activeThemeRef.current);
+							if (wsUrl) requestAnimationFrame(() => {
+								handle.connectPty(wsUrl);
+								handle.updateSize(true);
+							});
+						}
+					}
+					cbRef.current.onPaneCreated?.(pane.id);
+				},
+				onPaneClosed: (pane) => cbRef.current.onPaneClosed?.(pane.id),
+				onPaneSplit: (src, created, dir) => cbRef.current.onPaneSplit?.(src.id, created.id, dir),
+				onActivePaneChange: (pane) => cbRef.current.onActivePaneChange?.(pane?.id ?? null),
+				onLayoutChanged: () => cbRef.current.onLayoutChanged?.(),
+				createInitialPane,
+				shortcuts,
+				defaultContextMenu
+			});
+			if (destroyed) {
+				restty.destroy();
+				return;
+			}
+			resttyRef.current = restty;
+			let resolvedTheme;
+			if (resttyThemeName) resolvedTheme = getBuiltinTheme(resttyThemeName) ?? getSynthwaveGhosttyTheme();
+			else if (ghosttyTheme) resolvedTheme = ghosttyTheme;
+			else if (theme) resolvedTheme = xtermThemeToGhostty(theme);
+			else resolvedTheme = getSynthwaveGhosttyTheme();
+			activeThemeRef.current = resolvedTheme;
+			restty.applyTheme(resolvedTheme);
+			if (plugins?.length) for (const plugin of plugins) restty.use(plugin);
+			if (pluginManifest?.length && pluginRegistry) await restty.loadPlugins(pluginManifest, pluginRegistry);
+			if (wsUrl) restty.connectPty(wsUrl);
+			setIsReady(true);
+			cbRef.current.onReady?.(restty);
+		};
+		init().catch((err) => {
+			if (!destroyed) cbRef.current.onError?.(`Failed to initialize restty: ${err instanceof Error ? err.message : String(err)}`);
+		});
+		return () => {
+			destroyed = true;
+			const instance = resttyRef.current;
+			resttyRef.current = null;
+			setIsReady(false);
+			if (instance) destroyTimerRef.current = setTimeout(() => {
+				destroyTimerRef.current = null;
+				if (!didInitRef.current) instance.destroy();
+			}, 100);
+			didInitRef.current = false;
+		};
+	}, []);
+	const initialWsUrlRef = useRef(wsUrl);
+	useEffect(() => {
+		if (!isReady || !resttyRef.current) return;
+		if (wsUrl === initialWsUrlRef.current) {
+			initialWsUrlRef.current = "";
+			return;
+		}
+		if (wsUrl) {
+			resttyRef.current.disconnectPty();
+			resttyRef.current.connectPty(wsUrl);
+		} else resttyRef.current.disconnectPty();
+	}, [wsUrl, isReady]);
+	useEffect(() => {
+		if (!isReady || !resttyRef.current) return;
+		resttyRef.current.setFontSize(fontSize);
+	}, [fontSize, isReady]);
+	useEffect(() => {
+		if (!isReady || !resttyRef.current) return;
+		if (resttyThemeName) import("@mks2508/restty").then(({ getBuiltinTheme }) => {
+			const builtin = getBuiltinTheme(resttyThemeName);
+			if (builtin) resttyRef.current?.applyTheme(builtin);
+		});
+		else if (ghosttyTheme) resttyRef.current.applyTheme(ghosttyTheme);
+		else if (theme) resttyRef.current.applyTheme(xtermThemeToGhostty(theme));
+	}, [
+		theme,
+		ghosttyTheme,
+		resttyThemeName,
+		isReady
+	]);
+	useEffect(() => {
+		if (!isReady || !resttyRef.current || paused === void 0) return;
+		resttyRef.current.setPaused(paused);
+	}, [paused, isReady]);
+	useEffect(() => {
+		if (!isReady || !resttyRef.current || !fontSources) return;
+		resttyRef.current.setFontSources(fontSources);
+	}, [fontSources, isReady]);
+	useImperativeHandle(ref, () => ({
+		getRestty: () => resttyRef.current,
+		connectPty: (url) => resttyRef.current?.connectPty(url ?? ""),
+		disconnectPty: () => resttyRef.current?.disconnectPty(),
+		isPtyConnected: () => resttyRef.current?.isPtyConnected() ?? false,
+		sendInput: (text, source) => resttyRef.current?.sendInput(text, source),
+		sendKeyInput: (text, source) => resttyRef.current?.sendKeyInput(text, source),
+		splitActivePane: (dir) => {
+			const pane = resttyRef.current?.splitActivePane(dir) ?? null;
+			return pane ? resttyRef.current.pane(pane.id) : null;
+		},
+		splitPane: (id, dir) => {
+			const pane = resttyRef.current?.splitPane(id, dir) ?? null;
+			return pane ? resttyRef.current.pane(pane.id) : null;
+		},
+		closePane: (id) => resttyRef.current?.closePane(id) ?? false,
+		setActivePane: (id, opts) => resttyRef.current?.setActivePane(id, opts),
+		panes: () => resttyRef.current?.panes() ?? [],
+		activePane: () => resttyRef.current?.activePane() ?? null,
+		focusedPane: () => resttyRef.current?.focusedPane() ?? null,
+		setRenderer: (v) => resttyRef.current?.setRenderer(v),
+		setPaused: (v) => resttyRef.current?.setPaused(v),
+		togglePause: () => resttyRef.current?.togglePause(),
+		getBackend: () => resttyRef.current?.getBackend() ?? "none",
+		setFontSize: (s) => resttyRef.current?.setFontSize(s),
+		setFontSources: (s) => resttyRef.current?.setFontSources(s) ?? Promise.resolve(),
+		applyTheme: (t, l) => resttyRef.current?.applyTheme(t, l),
+		resetTheme: () => resttyRef.current?.resetTheme(),
+		clear: () => resttyRef.current?.clearScreen(),
+		focus: () => resttyRef.current?.focus(),
+		blur: () => resttyRef.current?.blur(),
+		resize: (c, r) => resttyRef.current?.resize(c, r),
+		updateSize: (f) => resttyRef.current?.updateSize(f),
+		copySelection: () => resttyRef.current?.copySelectionToClipboard() ?? Promise.resolve(false),
+		pasteClipboard: () => resttyRef.current?.pasteFromClipboard() ?? Promise.resolve(false),
+		use: (p, o) => resttyRef.current?.use(p, o),
+		unloadPlugin: (id) => resttyRef.current?.unuse(id) ?? false,
+		getActivePlugins: () => resttyRef.current?.pluginInfo() ?? [],
+		getPluginInfo: (id) => resttyRef.current?.pluginInfo(id) ?? null
+	}));
+	return /* @__PURE__ */ jsx(ResttyProvider, {
+		restty: resttyRef.current,
+		isReady,
+		children: /* @__PURE__ */ jsx("div", {
+			ref: containerRef,
+			className,
+			style: {
+				width: "100%",
+				height: "100%",
+				minHeight: 200,
+				...style
+			}
+		})
+	});
+});
+ResttyTerminal.displayName = "ResttyTerminal";
+
+//#endregion
+export { ResttyTerminal };

package/dist/react-ui/blocks/Terminal/restty/ResttyTerminal.types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Types for ResttyTerminal — the first-class React component for restty.
+ *
+ * @module Terminal/restty/ResttyTerminal.types
+ */
+import type { Restty, ResttyOptions, ResttyPlugin, ResttyPluginInfo, ResttyPluginManifestEntry, ResttyPluginRegistry, ResttyPaneHandle, ResttyFontSource, ResttyPaneSplitDirection, ResttyAppInputPayload, GhosttyTheme } from '@mks2508/restty';
+import type { ITerminalTheme, IPtyTransportFactory } from '../Terminal.types';
+export type { Restty, ResttyPlugin, ResttyPluginInfo, ResttyPaneHandle, ResttyFontSource, ResttyPaneSplitDirection, GhosttyTheme, };
+/**
+ * Props for ResttyTerminal.
+ *
+ * Covers the full restty API surface: connection, appearance, panes,
+ * plugins, I/O hooks, lifecycle callbacks, and rendering control.
+ */
+export interface IResttyTerminalProps {
+    /** PTY WebSocket URL. Triggers auto-connect on mount and reconnect on change. */
+    wsUrl?: string;
+    /** Factory to create a custom PTY transport (e.g., JsonWsPtyTransport). */
+    createPtyTransport?: IPtyTransportFactory;
+    /** Font size in CSS pixels (default: 14). */
+    fontSize?: number;
+    /** Terminal theme in xterm.js color format. Auto-converted to Ghostty format. */
+    theme?: ITerminalTheme;
+    /** Theme in native Ghostty format. Takes precedence over `theme`. */
+    ghosttyTheme?: GhosttyTheme;
+    /** Built-in restty theme name from the 458-theme catalog. Takes highest precedence. */
+    resttyThemeName?: string;
+    /**
+     * GPU renderer preference.
+     * - `auto`: WebGPU with WebGL2 fallback (default)
+     * - `webgpu`: Force WebGPU only
+     * - `webgl2`: Force WebGL2 only
+     */
+    gpuRenderer?: 'auto' | 'webgpu' | 'webgl2';
+    /** Font sources for the terminal. */
+    fontSources?: ResttyFontSource[];
+    /** Whether to create an initial pane (default: true). */
+    createInitialPane?: boolean | {
+        focus?: boolean;
+    };
+    /** Enable built-in keyboard shortcuts for pane splitting (default: false). */
+    shortcuts?: boolean;
+    /** Enable built-in right-click context menu (default: true). */
+    defaultContextMenu?: boolean;
+    /** Intercept terminal input before it's written. Return null to suppress. */
+    beforeInput?: (payload: ResttyAppInputPayload) => string | null | void;
+    /** Intercept PTY output before it's rendered. Return null to suppress. */
+    beforeRenderOutput?: (payload: ResttyAppInputPayload) => string | null | void;
+    /** Called after a new pane is created. */
+    onPaneCreated?: (paneId: number) => void;
+    /** Called after a pane is closed. */
+    onPaneClosed?: (paneId: number) => void;
+    /** Called after a pane is split. */
+    onPaneSplit?: (sourcePaneId: number, createdPaneId: number, direction: ResttyPaneSplitDirection) => void;
+    /** Called when the active pane changes. */
+    onActivePaneChange?: (paneId: number | null) => void;
+    /** Called when the pane layout changes (split/close/resize). */
+    onLayoutChanged?: () => void;
+    /** Called when the Restty instance is fully initialized. */
+    onReady?: (restty: Restty) => void;
+    /** Called when the terminal grid dimensions change. */
+    onResize?: (cols: number, rows: number) => void;
+    /** Called when PTY connection status changes. */
+    onPtyStatus?: (status: string) => void;
+    /** Called when PTY connection opens. */
+    onConnect?: () => void;
+    /** Called when PTY connection closes. */
+    onDisconnect?: () => void;
+    /** Called on errors during initialization or PTY connection. */
+    onError?: (message: string) => void;
+    /** Called when the terminal receives a desktop notification (OSC 9/777). */
+    onDesktopNotification?: (notification: {
+        title?: string;
+        body?: string;
+        paneId: number;
+    }) => void;
+    /** Pause GPU rendering (e.g., when the terminal is offscreen). */
+    paused?: boolean;
+    /** Plugins to load on initialization. */
+    plugins?: ResttyPlugin[];
+    /** Plugin manifest for registry-based loading. */
+    pluginManifest?: ResttyPluginManifestEntry[];
+    /** Plugin registry for manifest resolution. */
+    pluginRegistry?: ResttyPluginRegistry;
+    /** Escape hatch: raw ResttyOptions spread into the constructor. */
+    resttyOptions?: Partial<ResttyOptions>;
+    /** CSS class name for the container element. */
+    className?: string;
+    /** Inline styles for the container element. */
+    style?: React.CSSProperties;
+}
+/**
+ * Imperative ref for ResttyTerminal.
+ *
+ * Exposes the full Restty API: PTY control, pane management,
+ * appearance, plugins, and raw instance access.
+ */
+export interface IResttyTerminalRef {
+    /** Get the underlying Restty instance. */
+    getRestty: () => Restty | null;
+    /** Open a PTY connection (optionally to a specific URL). */
+    connectPty: (url?: string) => void;
+    /** Close the active PTY connection. */
+    disconnectPty: () => void;
+    /** Check if the PTY is connected. */
+    isPtyConnected: () => boolean;
+    /** Send raw input to the terminal PTY. */
+    sendInput: (text: string, source?: string) => void;
+    /** Encode and send a key sequence to the PTY. */
+    sendKeyInput: (text: string, source?: string) => void;
+    /** Split the active pane. Returns the new pane handle or null. */
+    splitActivePane: (direction: ResttyPaneSplitDirection) => ResttyPaneHandle | null;
+    /** Split a specific pane by ID. Returns the new pane handle or null. */
+    splitPane: (id: number, direction: ResttyPaneSplitDirection) => ResttyPaneHandle | null;
+    /** Close a pane by ID. Returns true if successful. */
+    closePane: (id: number) => boolean;
+    /** Set the active pane. */
+    setActivePane: (id: number, options?: {
+        focus?: boolean;
+    }) => void;
+    /** Get all pane handles. */
+    panes: () => ResttyPaneHandle[];
+    /** Get the active pane handle. */
+    activePane: () => ResttyPaneHandle | null;
+    /** Get the focused pane handle. */
+    focusedPane: () => ResttyPaneHandle | null;
+    /** Switch the GPU renderer at runtime. */
+    setRenderer: (value: 'auto' | 'webgpu' | 'webgl2') => void;
+    /** Pause or resume GPU rendering. */
+    setPaused: (value: boolean) => void;
+    /** Toggle the pause state. */
+    togglePause: () => void;
+    /** Get the active renderer backend name. */
+    getBackend: () => string;
+    /** Update the font size. */
+    setFontSize: (size: number) => void;
+    /** Replace the font sources. */
+    setFontSources: (sources: ResttyFontSource[]) => Promise<void>;
+    /** Apply a Ghostty theme. */
+    applyTheme: (theme: GhosttyTheme, sourceLabel?: string) => void;
+    /** Reset to the default theme. */
+    resetTheme: () => void;
+    /** Clear the terminal screen and scrollback. */
+    clear: () => void;
+    /** Focus the terminal for keyboard input. */
+    focus: () => void;
+    /** Remove focus from the terminal. */
+    blur: () => void;
+    /** Resize the terminal grid to explicit dimensions. */
+    resize: (cols: number, rows: number) => void;
+    /** Recalculate terminal dimensions from the canvas size. */
+    updateSize: (force?: boolean) => void;
+    /** Copy the current text selection to the clipboard. */
+    copySelection: () => Promise<boolean>;
+    /** Paste clipboard contents into the terminal. */
+    pasteClipboard: () => Promise<boolean>;
+    /** Load a plugin. */
+    use: (plugin: ResttyPlugin, options?: unknown) => void;
+    /** Unload a plugin by ID. */
+    unloadPlugin: (pluginId: string) => boolean;
+    /** Get info for all active plugins. */
+    getActivePlugins: () => ResttyPluginInfo[];
+    /** Get info for a specific plugin. Returns null if not found. */
+    getPluginInfo: (pluginId: string) => ResttyPluginInfo | null;
+}
+//# sourceMappingURL=ResttyTerminal.types.d.ts.map

package/dist/react-ui/blocks/Terminal/restty/ResttyTerminal.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResttyTerminal.types.d.ts","sourceRoot":"","sources":["../../../../../src/react-ui/blocks/Terminal/restty/ResttyTerminal.types.ts"],"names":[],"mappings":"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"}

package/dist/react-ui/blocks/Terminal/restty/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * First-class restty integration for React.
+ *
+ * @module Terminal/restty
+ */
+export { ResttyTerminal } from './ResttyTerminal';
+export { ResttySessionProvider, useResttySession } from './ResttySessionProvider';
+export type { IResttySessionProviderProps, IResttySessionContextValue } from './ResttySessionProvider';
+export { ResttyProvider, useRestty } from './ResttyContext';
+export type { IResttyContextValue } from './ResttyContext';
+export { useResttyPane } from './useResttyPane';
+export type { IUseResttyPaneReturn } from './useResttyPane';
+export { useResttyPanes } from './useResttyPanes';
+export type { IUseResttyPanesReturn } from './useResttyPanes';
+export { useResttyVisibility } from './useResttyVisibility';
+export type { IUseResttyVisibilityOptions } from './useResttyVisibility';
+export { useResttyPlugins } from './useResttyPlugins';
+export type { IUseResttyPluginsReturn } from './useResttyPlugins';
+export type { IResttyTerminalProps, IResttyTerminalRef, Restty, ResttyPlugin, ResttyPluginInfo, ResttyPaneHandle, ResttyFontSource, ResttyPaneSplitDirection, GhosttyTheme, } from './ResttyTerminal.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/react-ui/blocks/Terminal/restty/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react-ui/blocks/Terminal/restty/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAGvG,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGlE,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,MAAM,EACN,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,YAAY,GACb,MAAM,wBAAwB,CAAC"}

package/dist/react-ui/blocks/Terminal/restty/index.js

@@ -0,0 +1,7 @@
+import { ResttyProvider, useRestty } from "./ResttyContext.js";
+import { ResttySessionProvider, useResttySession } from "./ResttySessionProvider.js";
+import { ResttyTerminal } from "./ResttyTerminal.js";
+import { useResttyPane } from "./useResttyPane.js";
+import { useResttyPanes } from "./useResttyPanes.js";
+import { useResttyVisibility } from "./useResttyVisibility.js";
+import { useResttyPlugins } from "./useResttyPlugins.js";

package/dist/react-ui/blocks/Terminal/restty/useResttyPane.d.ts

@@ -0,0 +1,51 @@
+/**
+ * useResttyPane — per-pane operations hook.
+ *
+ * Operates on the active pane when no paneId is specified.
+ *
+ * @example
+ * ```tsx
+ * const { pane, split, close, sendInput } = useResttyPane();
+ * split("vertical");
+ * sendInput("ls -la\n");
+ * ```
+ *
+ * @module Terminal/restty/useResttyPane
+ */
+import type { ResttyPaneHandle, ResttyPaneSplitDirection } from '@mks2508/restty';
+/**
+ * Return type of the useResttyPane hook.
+ */
+export interface IUseResttyPaneReturn {
+    /** The resolved pane handle, or null if not found/ready. */
+    pane: ResttyPaneHandle | null;
+    /** Split this pane in the given direction. */
+    split: (direction: ResttyPaneSplitDirection) => ResttyPaneHandle | null;
+    /** Close this pane. */
+    close: () => boolean;
+    /** Focus this pane. */
+    focus: () => void;
+    /** Send raw input to this pane's PTY. */
+    sendInput: (text: string, source?: string) => void;
+    /** Send encoded key input to this pane's PTY. */
+    sendKeyInput: (text: string, source?: string) => void;
+    /** Pause or resume rendering for this pane. */
+    setPaused: (paused: boolean) => void;
+    /** Switch the renderer for this pane. */
+    setRenderer: (value: 'auto' | 'webgpu' | 'webgl2') => void;
+    /** Check if this pane's PTY is connected. */
+    isPtyConnected: () => boolean;
+    /** Connect this pane's PTY to a URL. */
+    connectPty: (url?: string) => void;
+    /** Disconnect this pane's PTY. */
+    disconnectPty: () => void;
+    /** Clear this pane's screen. */
+    clear: () => void;
+}
+/**
+ * Hook for operating on an individual restty pane.
+ *
+ * @param paneId - Target pane ID. If omitted, operates on the active pane.
+ */
+export declare function useResttyPane(paneId?: number): IUseResttyPaneReturn;
+//# sourceMappingURL=useResttyPane.d.ts.map

package/dist/react-ui/blocks/Terminal/restty/useResttyPane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResttyPane.d.ts","sourceRoot":"","sources":["../../../../../src/react-ui/blocks/Terminal/restty/useResttyPane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAGlF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,CAAC,SAAS,EAAE,wBAAwB,KAAK,gBAAgB,GAAG,IAAI,CAAC;IACxE,uBAAuB;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,uBAAuB;IACvB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,iDAAiD;IACjD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,+CAA+C;IAC/C,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,yCAAyC;IACzC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAC3D,6CAA6C;IAC7C,cAAc,EAAE,MAAM,OAAO,CAAC;IAC9B,wCAAwC;IACxC,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,kCAAkC;IAClC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAgCnE"}