restty 0.1.0

package/dist/input/index.d.ts

@@ -0,0 +1,6 @@
+import type { InputHandler, InputHandlerOptions } from "./types";
+/**
+ * Create a terminal input handler with key, IME, PTY, and mouse support.
+ */
+export declare function createInputHandler(options?: InputHandlerOptions): InputHandler;
+export type { CellPosition, CursorPosition, InputHandler, InputHandlerConfig, InputHandlerOptions, MouseMode, MouseStatus, } from "./types";

package/dist/input/keymap.d.ts

@@ -0,0 +1,24 @@
+import type { InputHandlerConfig } from "./types";
+/**
+ * Standard sequences used by terminal emulators.
+ */
+export declare const sequences: {
+    enter: string;
+    backspace: string;
+    delete: string;
+    tab: string;
+    shiftTab: string;
+    escape: string;
+};
+/**
+ * Encode a KeyboardEvent into a terminal byte sequence.
+ */
+export declare function encodeKeyEvent(event: KeyboardEvent, config?: InputHandlerConfig, kittyFlags?: number): string;
+/**
+ * Encode beforeinput events (IME/paste/backspace) into terminal sequences.
+ */
+export declare function encodeBeforeInput(event: InputEvent): string;
+/**
+ * Map input sequences to PTY expectations (e.g., DEL vs backspace).
+ */
+export declare function mapKeyForPty(seq: string): string;

package/dist/input/mouse.d.ts

@@ -0,0 +1,38 @@
+import type { CellPosition, MouseMode, MouseStatus } from "./types";
+export type MouseControllerOptions = {
+    sendReply: (data: string) => void;
+    positionToCell: (event: MouseEvent | PointerEvent | WheelEvent) => CellPosition;
+    positionToPixel?: (event: MouseEvent | PointerEvent | WheelEvent) => {
+        x: number;
+        y: number;
+    };
+};
+export declare class MouseController {
+    private mode;
+    private enabled;
+    private format;
+    private motion;
+    private pressed;
+    private button;
+    private flags;
+    private x10Event;
+    private sendReply;
+    private positionToCell;
+    private positionToPixel?;
+    constructor(options: MouseControllerOptions);
+    setReplySink(fn: (data: string) => void): void;
+    setPositionToCell(fn: (event: MouseEvent | PointerEvent | WheelEvent) => CellPosition): void;
+    setPositionToPixel(fn: (event: MouseEvent | PointerEvent | WheelEvent) => {
+        x: number;
+        y: number;
+    }): void;
+    setMode(mode: MouseMode): void;
+    handleModeSeq(seq: string): boolean;
+    isActive(): boolean;
+    getStatus(): MouseStatus;
+    sendMouseEvent(kind: "down" | "up" | "move" | "wheel", event: PointerEvent | WheelEvent): boolean;
+    private updateFlags;
+    private isX10EventMode;
+    private modifiers;
+    private sendMouse;
+}

package/dist/input/output.d.ts

@@ -0,0 +1,53 @@
+import type { CursorPosition, WindowOp } from "./types";
+import type { MouseController } from "./mouse";
+export type OutputFilterOptions = {
+    getCursorPosition: () => CursorPosition;
+    sendReply: (data: string) => void;
+    mouse: MouseController;
+    getDefaultColors?: () => {
+        fg?: [number, number, number];
+        bg?: [number, number, number];
+        cursor?: [number, number, number];
+    };
+    onClipboardWrite?: (text: string) => void | Promise<void>;
+    onClipboardRead?: () => string | null | Promise<string | null>;
+    onWindowOp?: (op: WindowOp) => void;
+    getWindowMetrics?: () => {
+        rows: number;
+        cols: number;
+        widthPx: number;
+        heightPx: number;
+        cellWidthPx: number;
+        cellHeightPx: number;
+    };
+};
+/**
+ * Parses output for control queries (CPR/DA) and mouse mode toggles,
+ * returning the sanitized output for rendering.
+ */
+export declare class OutputFilter {
+    private remainder;
+    private getCursorPosition;
+    private sendReply;
+    private mouse;
+    private altScreen;
+    private bracketedPaste;
+    private focusReporting;
+    private windowOpHandler?;
+    private getWindowMetrics?;
+    private clipboardWrite?;
+    private clipboardRead?;
+    private getDefaultColors?;
+    constructor(options: OutputFilterOptions);
+    setCursorProvider(fn: () => CursorPosition): void;
+    setReplySink(fn: (data: string) => void): void;
+    setWindowOpHandler(fn: (op: WindowOp) => void): void;
+    isAltScreen(): boolean;
+    isBracketedPaste(): boolean;
+    isFocusReporting(): boolean;
+    private replyOscColor;
+    private handleOsc;
+    private handleModeSeq;
+    private handleWindowOp;
+    filter(output: string): string;
+}

package/dist/input/types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * 1-based cursor position (terminal coordinates).
+ */
+export type CursorPosition = {
+    row: number;
+    col: number;
+};
+/**
+ * 0-based cell coordinates (grid coordinates).
+ */
+export type CellPosition = {
+    row: number;
+    col: number;
+};
+/**
+ * Mouse reporting mode.
+ * - auto: follow app requests (DECSET/DECRST)
+ * - on: always report mouse
+ * - off: never report mouse
+ */
+export type MouseMode = "auto" | "on" | "off";
+/**
+ * Input handler configuration flags.
+ */
+export type InputHandlerConfig = {
+    /**
+     * Encode Ctrl+<key> combos to control characters (default true).
+     */
+    enableCtrlCombos?: boolean;
+};
+export type DefaultColors = {
+    fg?: [number, number, number];
+    bg?: [number, number, number];
+    cursor?: [number, number, number];
+};
+export type WindowMetrics = {
+    rows: number;
+    cols: number;
+    widthPx: number;
+    heightPx: number;
+    cellWidthPx: number;
+    cellHeightPx: number;
+};
+export type WindowOp = {
+    type: "resize";
+    rows: number;
+    cols: number;
+    params: number[];
+    raw: string;
+} | {
+    type: "unknown";
+    params: number[];
+    raw: string;
+};
+/**
+ * Input handler construction options.
+ */
+export type InputHandlerOptions = {
+    /**
+     * Configuration knobs for key encoding and feature flags.
+     */
+    config?: InputHandlerConfig;
+    /**
+     * Provide the current cursor position for CPR replies.
+     */
+    getCursorPosition?: () => CursorPosition;
+    /**
+     * Sink for output replies (CPR/DA/mouse).
+     */
+    sendReply?: (data: string) => void;
+    /**
+     * Map pointer events to cell coordinates.
+     */
+    positionToCell?: (event: MouseEvent | PointerEvent | WheelEvent) => CellPosition;
+    /**
+     * Map pointer events to pixel coordinates (1-based, terminal space).
+     */
+    positionToPixel?: (event: MouseEvent | PointerEvent | WheelEvent) => {
+        x: number;
+        y: number;
+    };
+    /**
+     * Provide default colors for OSC 10/11/12 queries (RGB 0-255).
+     */
+    getDefaultColors?: () => DefaultColors;
+    /**
+     * Optional handler for window manipulation sequences (CSI ... t).
+     */
+    onWindowOp?: (op: WindowOp) => void;
+    /**
+     * Optional provider for XTWINOPS report queries (CSI 14/16/18 t).
+     */
+    getWindowMetrics?: () => WindowMetrics;
+    /**
+     * Optional clipboard handlers for OSC 52.
+     */
+    onClipboardWrite?: (text: string) => void | Promise<void>;
+    onClipboardRead?: () => string | null | Promise<string | null>;
+    /**
+     * Return active Kitty keyboard protocol flags (CSI ? u query result).
+     */
+    getKittyKeyboardFlags?: () => number;
+};
+/**
+ * Exposed mouse status for UI debugging.
+ */
+export type MouseStatus = {
+    mode: MouseMode;
+    active: boolean;
+    detail: "sgr" | "x10" | "utf8" | "urxvt" | "sgr_pixels";
+    enabled: boolean;
+};
+/**
+ * Public input handler API.
+ */
+export type InputHandler = {
+    sequences: {
+        enter: string;
+        backspace: string;
+        delete: string;
+        tab: string;
+        shiftTab: string;
+        escape: string;
+    };
+    /**
+     * Encode a KeyboardEvent into a terminal byte sequence.
+     */
+    encodeKeyEvent: (event: KeyboardEvent) => string;
+    /**
+     * Encode a beforeinput event into a terminal byte sequence.
+     */
+    encodeBeforeInput: (event: InputEvent) => string;
+    /**
+     * Map encoded sequences to PTY-friendly forms.
+     */
+    mapKeyForPty: (seq: string) => string;
+    /**
+     * Filter PTY output and handle control queries (CPR/DA/mouse mode).
+     */
+    filterOutput: (output: string) => string;
+    setReplySink: (fn: (data: string) => void) => void;
+    setCursorProvider: (fn: () => CursorPosition) => void;
+    setPositionToCell: (fn: (event: MouseEvent | PointerEvent | WheelEvent) => CellPosition) => void;
+    setPositionToPixel: (fn: (event: MouseEvent | PointerEvent | WheelEvent) => {
+        x: number;
+        y: number;
+    }) => void;
+    setWindowOpHandler: (fn: (op: WindowOp) => void) => void;
+    setMouseMode: (mode: MouseMode) => void;
+    getMouseStatus: () => MouseStatus;
+    isMouseActive: () => boolean;
+    isBracketedPaste: () => boolean;
+    isFocusReporting: () => boolean;
+    isAltScreen: () => boolean;
+    /**
+     * Encode pointer input as terminal mouse events (SGR).
+     */
+    sendMouseEvent: (kind: "down" | "up" | "move" | "wheel", event: PointerEvent | WheelEvent) => boolean;
+};

package/dist/pty/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./pty";

package/dist/pty/pty.d.ts

@@ -0,0 +1,8 @@
+import type { PtyCallbacks, PtyConnectionState } from "./types";
+export declare function decodePtyBinary(decoder: TextDecoder, payload: ArrayBuffer | Uint8Array, stream?: boolean): string;
+export declare function createPtyConnection(): PtyConnectionState;
+export declare function connectPty(state: PtyConnectionState, url: string, callbacks: PtyCallbacks): void;
+export declare function disconnectPty(state: PtyConnectionState): void;
+export declare function sendPtyInput(state: PtyConnectionState, data: string): boolean;
+export declare function sendPtyResize(state: PtyConnectionState, cols: number, rows: number): boolean;
+export declare function isPtyConnected(state: PtyConnectionState): boolean;

package/dist/pty/types.d.ts

@@ -0,0 +1,36 @@
+export type PtyMessage = {
+    type: "input";
+    data: string;
+} | {
+    type: "resize";
+    cols: number;
+    rows: number;
+};
+export type PtyStatusMessage = {
+    type: "status";
+    shell?: string;
+};
+export type PtyErrorMessage = {
+    type: "error";
+    message?: string;
+    errors?: string[];
+};
+export type PtyExitMessage = {
+    type: "exit";
+    code?: number;
+};
+export type PtyServerMessage = PtyStatusMessage | PtyErrorMessage | PtyExitMessage;
+export type PtyConnectionState = {
+    socket: WebSocket | null;
+    connected: boolean;
+    url: string;
+    decoder: TextDecoder | null;
+};
+export type PtyCallbacks = {
+    onConnect?: () => void;
+    onDisconnect?: () => void;
+    onData?: (data: string) => void;
+    onStatus?: (shell: string) => void;
+    onError?: (message: string, errors?: string[]) => void;
+    onExit?: (code: number) => void;
+};

package/dist/renderer/box-drawing-map.d.ts

@@ -0,0 +1 @@
+export declare const BOX_LINE_MAP: Map<number, [number, number, number, number]>;

package/dist/renderer/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./shapes";
+export * from "./types";
+export * from "./shaders";
+export * from "./webgpu";
+export { BOX_LINE_MAP } from "./box-drawing-map";

package/dist/renderer/shaders.d.ts

@@ -0,0 +1,7 @@
+export declare const RECT_SHADER = "\nstruct Uniforms {\n  res: vec2f,\n  _pad: vec2f,\n  blend: vec2f,\n  _pad2: vec2f,\n};\n\n@group(0) @binding(0) var<uniform> uniforms: Uniforms;\n\nstruct VSIn {\n  @location(0) quad: vec2f,\n  @location(1) pos: vec2f,\n  @location(2) size: vec2f,\n  @location(3) color: vec4f,\n};\n\nstruct VSOut {\n  @builtin(position) position: vec4f,\n  @location(0) color: vec4f,\n};\n\n// sRGB to linear conversion for proper blending\nfn srgbToLinear(c: f32) -> f32 {\n  if (c <= 0.04045) {\n    return c / 12.92;\n  }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\n\nfn srgbToLinear3(c: vec3f) -> vec3f {\n  return vec3f(srgbToLinear(c.x), srgbToLinear(c.y), srgbToLinear(c.z));\n}\n\n@vertex\nfn vsMain(input: VSIn) -> VSOut {\n  let pixel = input.pos + input.quad * input.size;\n  let clip = vec2f(\n    (pixel.x / uniforms.res.x) * 2.0 - 1.0,\n    1.0 - (pixel.y / uniforms.res.y) * 2.0\n  );\n\n  var out: VSOut;\n  out.position = vec4f(clip.x, clip.y, 0.0, 1.0);\n  out.color = input.color;\n  return out;\n}\n\n@fragment\nfn fsMain(input: VSOut) -> @location(0) vec4f {\n  let useLinear = uniforms.blend.x > 0.5;\n  var color = input.color;\n  if (useLinear) {\n    color = vec4f(srgbToLinear3(color.rgb), color.a);\n  }\n  color = vec4f(color.rgb * color.a, color.a);\n  return color;\n}\n";
+export declare const RECT_SHADER_GL_VERT = "#version 300 es\nprecision highp float;\n\nuniform vec2 u_resolution;\n\nlayout(location = 0) in vec2 a_quad;\nlayout(location = 1) in vec2 a_pos;\nlayout(location = 2) in vec2 a_size;\nlayout(location = 3) in vec4 a_color;\n\nout vec4 v_color;\n\nvoid main() {\n  vec2 pixel = a_pos + a_quad * a_size;\n  vec2 clip = vec2(\n    (pixel.x / u_resolution.x) * 2.0 - 1.0,\n    1.0 - (pixel.y / u_resolution.y) * 2.0\n  );\n  gl_Position = vec4(clip, 0.0, 1.0);\n  v_color = a_color;\n}\n";
+export declare const RECT_SHADER_GL_FRAG = "#version 300 es\nprecision highp float;\n\nuniform vec2 u_blend;\n\nin vec4 v_color;\nout vec4 fragColor;\n\n// sRGB to linear conversion for proper blending\nfloat srgbToLinear(float c) {\n  if (c <= 0.04045) {\n    return c / 12.92;\n  }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\n\nvec3 srgbToLinear(vec3 c) {\n  return vec3(srgbToLinear(c.r), srgbToLinear(c.g), srgbToLinear(c.b));\n}\n\nvoid main() {\n  bool useLinear = u_blend.x > 0.5;\n  vec4 color = v_color;\n  if (useLinear) {\n    color.rgb = srgbToLinear(color.rgb);\n  }\n  color.rgb *= color.a;\n  fragColor = color;\n}\n";
+export declare const GLYPH_SHADER_GL_VERT = "#version 300 es\nprecision highp float;\n\nuniform vec2 u_resolution;\n\nlayout(location = 0) in vec2 a_quad;\nlayout(location = 1) in vec2 a_pos;\nlayout(location = 2) in vec2 a_size;\nlayout(location = 3) in vec2 a_uv0;\nlayout(location = 4) in vec2 a_uv1;\nlayout(location = 5) in vec4 a_color;\nlayout(location = 6) in vec4 a_bg;\nlayout(location = 7) in float a_slant;\nlayout(location = 8) in float a_mode;\n\nout vec2 v_uv;\nout vec4 v_color;\nout vec4 v_bg;\nout float v_mode;\n\nvoid main() {\n  vec2 pixel = a_pos + vec2(a_quad.x * a_size.x + a_slant * (1.0 - a_quad.y), a_quad.y * a_size.y);\n  vec2 clip = vec2(\n    (pixel.x / u_resolution.x) * 2.0 - 1.0,\n    1.0 - (pixel.y / u_resolution.y) * 2.0\n  );\n  v_uv = a_uv0 + (a_uv1 - a_uv0) * a_quad;\n  gl_Position = vec4(clip, 0.0, 1.0);\n  v_color = a_color;\n  v_bg = a_bg;\n  v_mode = a_mode;\n}\n";
+export declare const GLYPH_SHADER_GL_FRAG = "#version 300 es\nprecision highp float;\n\nuniform sampler2D u_atlas;\nuniform vec2 u_blend;\n\nin vec2 v_uv;\nin vec4 v_color;\nin vec4 v_bg;\nin float v_mode;\nout vec4 fragColor;\n\n// sRGB to linear conversion for proper blending\nfloat srgbToLinear(float c) {\n  if (c <= 0.04045) {\n    return c / 12.92;\n  }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\n\n// Linear to sRGB conversion\nfloat linearToSrgb(float c) {\n  if (c <= 0.0031308) {\n    return c * 12.92;\n  }\n  return 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\n\nvec3 srgbToLinear(vec3 c) {\n  return vec3(srgbToLinear(c.r), srgbToLinear(c.g), srgbToLinear(c.b));\n}\n\nvec3 linearToSrgb(vec3 c) {\n  return vec3(linearToSrgb(c.r), linearToSrgb(c.g), linearToSrgb(c.b));\n}\n\nfloat luminance(vec3 color) {\n  return dot(color, vec3(0.2126, 0.7152, 0.0722));\n}\n\nvoid main() {\n  vec4 sample = texture(u_atlas, v_uv);\n  bool useLinear = u_blend.x > 0.5;\n  bool useCorrection = u_blend.y > 0.5;\n\n  if (v_mode > 0.5) {\n    vec4 color = sample;\n    if (useLinear) {\n      color.rgb = srgbToLinear(color.rgb);\n    }\n    color.rgb *= color.a;\n    fragColor = color;\n    return;\n  }\n\n  vec4 fg = v_color;\n  vec4 bg = v_bg;\n  if (useLinear) {\n    fg.rgb = srgbToLinear(fg.rgb);\n    bg.rgb = srgbToLinear(bg.rgb);\n  }\n  fg.rgb *= fg.a;\n  bg.rgb *= bg.a;\n\n  float alpha = sample.a;\n  if (useCorrection && useLinear) {\n    float fg_l = luminance(fg.rgb);\n    float bg_l = luminance(bg.rgb);\n    if (abs(fg_l - bg_l) > 0.001) {\n      float blend_l = srgbToLinear(linearToSrgb(fg_l) * alpha + linearToSrgb(bg_l) * (1.0 - alpha));\n      alpha = clamp((blend_l - bg_l) / (fg_l - bg_l), 0.0, 1.0);\n    }\n  }\n\n  vec4 color = fg * alpha;\n  fragColor = color;\n}\n";
+export declare const GLYPH_SHADER = "\nstruct Uniforms {\n  res: vec2f,\n  _pad: vec2f,\n  blend: vec2f,\n  _pad2: vec2f,\n};\n\n@group(0) @binding(0) var<uniform> uniforms: Uniforms;\n@group(0) @binding(1) var atlasSampler: sampler;\n@group(0) @binding(2) var atlasTex: texture_2d<f32>;\n\nstruct VSIn {\n  @location(0) quad: vec2f,\n  @location(1) pos: vec2f,\n  @location(2) size: vec2f,\n  @location(3) uv0: vec2f,\n  @location(4) uv1: vec2f,\n  @location(5) color: vec4f,\n  @location(6) bg: vec4f,\n  @location(7) slant: f32,\n  @location(8) mode: f32,\n};\n\nstruct VSOut {\n  @builtin(position) position: vec4f,\n  @location(0) uv: vec2f,\n  @location(1) color: vec4f,\n  @location(2) bg: vec4f,\n  @location(3) mode: f32,\n};\n\n@vertex\nfn vsMain(input: VSIn) -> VSOut {\n  let pixel = input.pos +\n    vec2f(input.quad.x * input.size.x + input.slant * (1.0 - input.quad.y), input.quad.y * input.size.y);\n  let clip = vec2f(\n    (pixel.x / uniforms.res.x) * 2.0 - 1.0,\n    1.0 - (pixel.y / uniforms.res.y) * 2.0\n  );\n  let uv = input.uv0 + (input.uv1 - input.uv0) * input.quad;\n\n  var out: VSOut;\n  out.position = vec4f(clip.x, clip.y, 0.0, 1.0);\n  out.uv = uv;\n  out.color = input.color;\n  out.bg = input.bg;\n  out.mode = input.mode;\n  return out;\n}\n\n// sRGB to linear conversion for proper blending\nfn srgbToLinear(c: f32) -> f32 {\n  if (c <= 0.04045) {\n    return c / 12.92;\n  }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\n\n// Linear to sRGB conversion\nfn linearToSrgb(c: f32) -> f32 {\n  if (c <= 0.0031308) {\n    return c * 12.92;\n  }\n  return 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\n\nfn srgbToLinear3(c: vec3f) -> vec3f {\n  return vec3f(srgbToLinear(c.x), srgbToLinear(c.y), srgbToLinear(c.z));\n}\n\nfn linearToSrgb3(c: vec3f) -> vec3f {\n  return vec3f(linearToSrgb(c.x), linearToSrgb(c.y), linearToSrgb(c.z));\n}\n\nfn luminance(color: vec3f) -> f32 {\n  return dot(color, vec3f(0.2126, 0.7152, 0.0722));\n}\n\n@fragment\nfn fsMain(input: VSOut) -> @location(0) vec4f {\n  let sample = textureSample(atlasTex, atlasSampler, input.uv);\n  let useLinear = uniforms.blend.x > 0.5;\n  let useCorrection = uniforms.blend.y > 0.5;\n\n  if (input.mode > 0.5) {\n    var color = sample;\n    if (useLinear) {\n      color = vec4f(srgbToLinear3(color.rgb), color.a);\n    }\n    return vec4f(color.rgb * color.a, color.a);\n  }\n\n  var alpha = sample.a;\n\n  var fg = input.color;\n  var bg = input.bg;\n  if (useLinear) {\n    fg = vec4f(srgbToLinear3(fg.rgb), fg.a);\n    bg = vec4f(srgbToLinear3(bg.rgb), bg.a);\n  }\n  fg = vec4f(fg.rgb * fg.a, fg.a);\n  bg = vec4f(bg.rgb * bg.a, bg.a);\n\n  if (useCorrection && useLinear) {\n    let fg_l = luminance(fg.rgb);\n    let bg_l = luminance(bg.rgb);\n    if (abs(fg_l - bg_l) > 0.001) {\n      let blend_l = srgbToLinear(linearToSrgb(fg_l) * alpha + linearToSrgb(bg_l) * (1.0 - alpha));\n      alpha = clamp((blend_l - bg_l) / (fg_l - bg_l), 0.0, 1.0);\n    }\n  }\n\n  var color = fg * alpha;\n  return color;\n}\n";
+export declare const GLYPH_SHADER_NEAREST = "\nstruct Uniforms {\n  res: vec2f,\n  _pad: vec2f,\n  blend: vec2f,\n  _pad2: vec2f,\n};\n\n@group(0) @binding(0) var<uniform> uniforms: Uniforms;\n@group(0) @binding(1) var atlasSampler: sampler;\n@group(0) @binding(2) var atlasTex: texture_2d<f32>;\n\nstruct VSIn {\n  @location(0) quad: vec2f,\n  @location(1) pos: vec2f,\n  @location(2) size: vec2f,\n  @location(3) uv0: vec2f,\n  @location(4) uv1: vec2f,\n  @location(5) color: vec4f,\n  @location(6) bg: vec4f,\n  @location(7) slant: f32,\n  @location(8) mode: f32,\n};\n\nstruct VSOut {\n  @builtin(position) position: vec4f,\n  @location(0) uv: vec2f,\n  @location(1) color: vec4f,\n  @location(2) bg: vec4f,\n  @location(3) mode: f32,\n};\n\n@vertex\nfn vsMain(input: VSIn) -> VSOut {\n  let pixel = input.pos +\n    vec2f(input.quad.x * input.size.x + input.slant * (1.0 - input.quad.y), input.quad.y * input.size.y);\n  let clip = vec2f(\n    (pixel.x / uniforms.res.x) * 2.0 - 1.0,\n    1.0 - (pixel.y / uniforms.res.y) * 2.0\n  );\n  let uv = input.uv0 + (input.uv1 - input.uv0) * input.quad;\n\n  var out: VSOut;\n  out.position = vec4f(clip.x, clip.y, 0.0, 1.0);\n  out.uv = uv;\n  out.color = input.color;\n  out.bg = input.bg;\n  out.mode = input.mode;\n  return out;\n}\n\n// sRGB to linear conversion for proper blending\nfn srgbToLinear(c: f32) -> f32 {\n  if (c <= 0.04045) {\n    return c / 12.92;\n  }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\n\n// Linear to sRGB conversion\nfn linearToSrgb(c: f32) -> f32 {\n  if (c <= 0.0031308) {\n    return c * 12.92;\n  }\n  return 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\n\nfn srgbToLinear3(c: vec3f) -> vec3f {\n  return vec3f(srgbToLinear(c.x), srgbToLinear(c.y), srgbToLinear(c.z));\n}\n\nfn linearToSrgb3(c: vec3f) -> vec3f {\n  return vec3f(linearToSrgb(c.x), linearToSrgb(c.y), linearToSrgb(c.z));\n}\n\nfn luminance(color: vec3f) -> f32 {\n  return dot(color, vec3f(0.2126, 0.7152, 0.0722));\n}\n\n@fragment\nfn fsMain(input: VSOut) -> @location(0) vec4f {\n  let sample = textureSample(atlasTex, atlasSampler, input.uv);\n  let useLinear = uniforms.blend.x > 0.5;\n  let useCorrection = uniforms.blend.y > 0.5;\n\n  if (input.mode > 0.5) {\n    var color = sample;\n    if (useLinear) {\n      color = vec4f(srgbToLinear3(color.rgb), color.a);\n    }\n    return vec4f(color.rgb * color.a, color.a);\n  }\n\n  var alpha = sample.a;\n\n  var fg = input.color;\n  var bg = input.bg;\n  if (useLinear) {\n    fg = vec4f(srgbToLinear3(fg.rgb), fg.a);\n    bg = vec4f(srgbToLinear3(bg.rgb), bg.a);\n  }\n  fg = vec4f(fg.rgb * fg.a, fg.a);\n  bg = vec4f(bg.rgb * bg.a, bg.a);\n\n  if (useCorrection && useLinear) {\n    let fg_l = luminance(fg.rgb);\n    let bg_l = luminance(bg.rgb);\n    if (abs(fg_l - bg_l) > 0.001) {\n      let blend_l = srgbToLinear(linearToSrgb(fg_l) * alpha + linearToSrgb(bg_l) * (1.0 - alpha));\n      alpha = clamp((blend_l - bg_l) / (fg_l - bg_l), 0.0, 1.0);\n    }\n  }\n\n  var color = fg * alpha;\n  return color;\n}\n";

package/dist/renderer/shapes.d.ts

@@ -0,0 +1,40 @@
+import type { NerdConstraint } from "../fonts/nerd-constraints";
+export type Color = [number, number, number, number];
+export type RectData = number[];
+export type NerdMetrics = {
+    cellWidth: number;
+    cellHeight: number;
+    faceWidth: number;
+    faceHeight: number;
+    faceY: number;
+    iconHeight: number;
+    iconHeightSingle: number;
+};
+export type GlyphBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export declare const BOX_STYLE_NONE = 0;
+export declare const BOX_STYLE_LIGHT = 1;
+export declare const BOX_STYLE_HEAVY = 2;
+export declare const BOX_STYLE_DOUBLE = 3;
+export declare function isPrivateUse(cp: number): boolean;
+export declare function isSpaceCp(cp: number): boolean;
+export declare function isBoxDrawing(cp: number): boolean;
+export declare function isBlockElement(cp: number): boolean;
+export declare function isLegacyComputing(cp: number): boolean;
+export declare function isPowerline(cp: number): boolean;
+export declare function isBraille(cp: number): boolean;
+export declare function isGraphicsElement(cp: number): boolean;
+export declare function isSymbolCp(cp: number): boolean;
+export declare function applyAlpha(color: Color, alpha: number): Color;
+export declare function pushRect(out: RectData, x: number, y: number, w: number, h: number, color: Color): void;
+export declare function pushRectSnapped(out: RectData, x: number, y: number, w: number, h: number, color: Color): void;
+export declare function pushRectBox(out: RectData, x: number, y: number, w: number, h: number, color: Color): void;
+export declare function drawBlockElement(cp: number, x: number, y: number, cellW: number, cellH: number, color: Color, out: RectData): boolean;
+export declare function drawBoxDrawing(cp: number, x: number, y: number, cellW: number, cellH: number, color: Color, out: RectData): boolean;
+export declare function drawBraille(cp: number, x: number, y: number, cellW: number, cellH: number, color: Color, out: RectData): boolean;
+export declare function drawPowerline(cp: number, x: number, y: number, cellW: number, cellH: number, color: Color, out: RectData): boolean;
+export declare function constrainGlyphBox(glyph: GlyphBox, constraint: NerdConstraint, metrics: NerdMetrics, constraintWidth: number): GlyphBox;

package/dist/renderer/types.d.ts

@@ -0,0 +1,80 @@
+import type { Color } from "./shapes";
+export type WebGPUState = {
+    device: GPUDevice;
+    context: GPUCanvasContext;
+    format: GPUTextureFormat;
+    srgbSwapchain: boolean;
+    rectPipeline: GPURenderPipeline;
+    glyphPipeline: GPURenderPipeline;
+    glyphPipelineNearest: GPURenderPipeline;
+    rectBindGroup: GPUBindGroup;
+    uniformBuffer: GPUBuffer;
+    vertexBuffer: GPUBuffer;
+    rectInstanceBuffer: GPUBuffer;
+    rectCapacity: number;
+    glyphInstanceBuffer: GPUBuffer;
+    glyphCapacity: number;
+    glyphAtlases: Map<number, AtlasState>;
+};
+export type AtlasState = {
+    texture: GPUTexture;
+    sampler?: GPUSampler;
+    samplerNearest?: GPUSampler;
+    samplerLinear?: GPUSampler;
+    bindGroup: GPUBindGroup;
+    bindGroupNearest?: GPUBindGroup;
+    bindGroupLinear?: GPUBindGroup;
+    width: number;
+    height: number;
+    inset: number;
+    colorGlyphs?: Set<number>;
+    constrainedGlyphWidths?: Map<number, number>;
+    nearest?: boolean;
+};
+export type WebGLState = {
+    gl: WebGL2RenderingContext;
+    rectProgram: WebGLProgram;
+    glyphProgram: WebGLProgram;
+    rectResolutionLoc: WebGLUniformLocation;
+    rectBlendLoc: WebGLUniformLocation;
+    glyphResolutionLoc: WebGLUniformLocation;
+    glyphBlendLoc: WebGLUniformLocation;
+    glyphAtlasLoc: WebGLUniformLocation;
+    quadBuffer: WebGLBuffer;
+    rectVao: WebGLVertexArrayObject;
+    glyphVao: WebGLVertexArrayObject;
+    rectInstanceBuffer: WebGLBuffer;
+    glyphInstanceBuffer: WebGLBuffer;
+    rectCapacity: number;
+    glyphCapacity: number;
+    glyphAtlases: Map<number, WebGLAtlasState>;
+};
+export type WebGLAtlasState = {
+    texture: WebGLTexture;
+    width: number;
+    height: number;
+    inset: number;
+    colorGlyphs?: Set<number>;
+    constrainedGlyphWidths?: Map<number, number>;
+    nearest?: boolean;
+};
+export type RendererState = WebGPUState | WebGLState | null;
+export type RendererConfig = {
+    defaultBg: Color;
+    defaultFg: Color;
+    selectionColor: Color;
+    cursorFallback: Color;
+};
+export type ResizeState = {
+    active: boolean;
+    lastAt: number;
+    cols: number;
+    rows: number;
+    dpr: number;
+};
+export type ScrollbarState = {
+    lastInputAt: number;
+    lastTotal: number;
+    lastOffset: number;
+    lastLen: number;
+};

package/dist/renderer/webgpu.d.ts

@@ -0,0 +1,19 @@
+import type { WebGPUState, WebGLState } from "./types";
+export declare function initWebGPU(canvas: HTMLCanvasElement): Promise<WebGPUState | null>;
+export declare function initWebGL(canvas: HTMLCanvasElement): WebGLState | null;
+export declare function ensureInstanceBuffer(state: WebGPUState, kind: "rect" | "glyph", byteLength: number): void;
+export declare function configureContext(state: WebGPUState): void;
+export declare function ensureGLInstanceBuffer(state: WebGLState, kind: "rect" | "glyph", byteLength: number): void;
+export declare function createResizeState(): {
+    active: boolean;
+    lastAt: number;
+    cols: number;
+    rows: number;
+    dpr: number;
+};
+export declare function createScrollbarState(): {
+    lastInputAt: number;
+    lastTotal: number;
+    lastOffset: number;
+    lastLen: number;
+};

package/dist/restty-input.d.ts

@@ -0,0 +1 @@
+export * from "./input/index";

package/dist/selection/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./selection";

package/dist/selection/selection.d.ts

@@ -0,0 +1,13 @@
+import type { CellPosition, SelectionRange, SelectionState } from "./types";
+export declare function createSelectionState(): SelectionState;
+export declare function clearSelection(state: SelectionState): void;
+export declare function startSelection(state: SelectionState, cell: CellPosition): void;
+export declare function updateSelection(state: SelectionState, cell: CellPosition): void;
+export declare function endSelection(state: SelectionState, cell: CellPosition): boolean;
+export declare function selectionForRow(state: SelectionState, row: number, cols: number): SelectionRange | null;
+export type CellTextGetter = (idx: number) => string;
+export declare function getSelectionText(state: SelectionState, rows: number, cols: number, getCellText: CellTextGetter): string;
+export declare function normalizeSelectionCell(cell: CellPosition | null, rows: number, cols: number, wideFlags?: Uint8Array | null): CellPosition | null;
+export declare function positionToCell(clientX: number, clientY: number, canvasRect: DOMRect, dpr: number, cellW: number, cellH: number, cols: number, rows: number): CellPosition;
+export declare function copyToClipboard(text: string): Promise<boolean>;
+export declare function pasteFromClipboard(): Promise<string | null>;

package/dist/selection/types.d.ts

@@ -0,0 +1,14 @@
+export type CellPosition = {
+    row: number;
+    col: number;
+};
+export type SelectionState = {
+    active: boolean;
+    dragging: boolean;
+    anchor: CellPosition | null;
+    focus: CellPosition | null;
+};
+export type SelectionRange = {
+    start: number;
+    end: number;
+};

package/dist/theme/builtin-themes.d.ts

@@ -0,0 +1,3 @@
+export declare const BUILTIN_THEME_NAMES: readonly ["0x96f", "12-bit Rainbow", "3024 Day", "3024 Night", "Aardvark Blue", "Abernathy", "Adventure", "Adventure Time", "Adwaita", "Adwaita Dark", "Afterglow", "Aizen Dark", "Aizen Light", "Alabaster", "Alien Blood", "Andromeda", "Apple Classic", "Apple System Colors", "Apple System Colors Light", "Arcoiris", "Ardoise", "Argonaut", "Arthur", "Atelier Sulphurpool", "Atom", "Atom One Dark", "Atom One Light", "Aura", "Aurora", "Ayu", "Ayu Light", "Ayu Mirage", "Banana Blueberry", "Batman", "Belafonte Day", "Belafonte Night", "Birds Of Paradise", "Black Metal", "Black Metal (Bathory)", "Black Metal (Burzum)", "Black Metal (Dark Funeral)", "Black Metal (Gorgoroth)", "Black Metal (Immortal)", "Black Metal (Khold)", "Black Metal (Marduk)", "Black Metal (Mayhem)", "Black Metal (Nile)", "Black Metal (Venom)", "Blazer", "Blue Berry Pie", "Blue Dolphin", "Blue Matrix", "Bluloco Dark", "Bluloco Light", "Borland", "Box", "branch", "Breadog", "Breeze", "Bright Lights", "Broadcast", "Brogrammer", "Builtin Dark", "Builtin Light", "Builtin Pastel Dark", "Builtin Tango Dark", "Builtin Tango Light", "C64", "Calamity", "Carbonfox", "Catppuccin Frappe", "Catppuccin Latte", "Catppuccin Macchiato", "Catppuccin Mocha", "CGA", "Chalk", "Chalkboard", "Challenger Deep", "Chester", "Ciapre", "Citruszest", "CLRS", "Cobalt Neon", "Cobalt Next", "Cobalt Next Dark", "Cobalt Next Minimal", "Cobalt2", "Coffee Theme", "Crayon Pony Fish", "Cursor Dark", "Cutie Pro", "Cyberdyne", "Cyberpunk", "Cyberpunk Scarlet Protocol", "Dark Modern", "Dark Pastel", "Dark+", "Darkermatrix", "Darkmatrix", "Darkside", "Dawnfox", "Dayfox", "Deep", "Desert", "Detuned", "Dimidium", "Dimmed Monokai", "Django", "Django Reborn Again", "Django Smooth", "Doom One", "Doom Peacock", "Dot Gov", "Dracula", "Dracula+", "Duckbones", "Duotone Dark", "Duskfox", "Earthsong", "Electron Highlighter", "Elegant", "Elemental", "Elementary", "Embark", "Embers Dark", "ENCOM", "Espresso", "Espresso Libre", "Everblush", "Everforest Dark Hard", "Everforest Light Med", "Fahrenheit", "Fairyfloss", "Farmhouse Dark", "Farmhouse Light", "Fideloper", "Firefly Traditional", "Firefox Dev", "Firewatch", "Fish Tank", "Flat", "Flatland", "Flexoki Dark", "Flexoki Light", "Floraverse", "Forest Blue", "Framer", "Front End Delight", "Fun Forrest", "Galaxy", "Galizur", "Ghostty Default Style Dark", "GitHub", "GitHub Dark", "GitHub Dark Colorblind", "GitHub Dark Default", "GitHub Dark Dimmed", "GitHub Dark High Contrast", "GitHub Light Colorblind", "GitHub Light Default", "GitHub Light High Contrast", "GitLab Dark", "GitLab Dark Grey", "GitLab Light", "Glacier", "Grape", "Grass", "Grey Green", "Gruber Darker", "Gruvbox Dark", "Gruvbox Dark Hard", "Gruvbox Light", "Gruvbox Light Hard", "Gruvbox Material", "Gruvbox Material Dark", "Gruvbox Material Light", "Guezwhoz", "Hacktober", "Hardcore", "Harper", "Havn Daggry", "Havn Skumring", "HaX0R Blue", "HaX0R Gr33N", "HaX0R R3D", "Heeler", "Highway", "Hipster Green", "Hivacruz", "Homebrew", "Hopscotch", "Hopscotch.256", "Horizon", "Horizon Bright", "Hot Dog Stand", "Hot Dog Stand (Mustard)", "Hurtado", "Hybrid", "IBM 5153 CGA", "IBM 5153 CGA (Black)", "IC Green PPL", "IC Orange PPL", "Iceberg Dark", "Iceberg Light", "Idea", "Idle Toes", "IR Black", "IRIX Console", "IRIX Terminal", "iTerm2 Dark Background", "iTerm2 Default", "iTerm2 Light Background", "iTerm2 Pastel Dark Background", "iTerm2 Smoooooth", "iTerm2 Solarized Dark", "iTerm2 Solarized Light", "iTerm2 Tango Dark", "iTerm2 Tango Light", "Jackie Brown", "Japanesque", "Jellybeans", "JetBrains Darcula", "Jubi", "Kanagawa Dragon", "Kanagawa Lotus", "Kanagawa Wave", "Kanagawabones", "Kanso Ink", "Kanso Mist", "Kanso Pearl", "Kanso Zen", "Kibble", "Kitty Default", "Kitty Low Contrast", "Kolorit", "Konsolas", "Kurokula", "Lab Fox", "Laser", "Later This Evening", "Lavandula", "Light Owl", "Liquid Carbon", "Liquid Carbon Transparent", "Lovelace", "Man Page", "Mariana", "Material", "Material Dark", "Material Darker", "Material Design Colors", "Material Ocean", "Mathias", "Matrix", "Matte Black", "Medallion", "Melange Dark", "Melange Light", "Mellifluous", "Mellow", "Miasma", "Midnight In Mojave", "Mirage", "Misterioso", "Molokai", "Mona Lisa", "Monokai Classic", "Monokai Pro", "Monokai Pro Light", "Monokai Pro Light Sun", "Monokai Pro Machine", "Monokai Pro Octagon", "Monokai Pro Ristretto", "Monokai Pro Spectrum", "Monokai Remastered", "Monokai Soda", "Monokai Vivid", "Moonfly", "N0Tch2K", "Neobones Dark", "Neobones Light", "Neon", "Neopolitan", "Neutron", "Night Lion V1", "Night Lion V2", "Night Owl", "Night Owlish Light", "Nightfox", "Niji", "No Clown Fiesta", "No Clown Fiesta Light", "Nocturnal Winter", "Nord", "Nord Light", "Nord Wave", "Nordfox", "Novel", "novmbr", "Nvim Dark", "Nvim Light", "Obsidian", "Ocean", "Oceanic Material", "Oceanic Next", "Ollie", "One Dark Two", "One Double Dark", "One Double Light", "One Half Dark", "One Half Light", "Onenord", "Onenord Light", "Operator Mono Dark", "Overnight Slumber", "owl", "Oxocarbon", "Pale Night Hc", "Pandora", "Paraiso Dark", "Paul Millr", "Pencil Dark", "Pencil Light", "Peppermint", "Phala Green Dark", "Piatto Light", "Pnevma", "Poimandres", "Poimandres Darker", "Poimandres Storm", "Poimandres White", "Popping And Locking", "Powershell", "Primary", "Pro", "Pro Light", "Purple Rain", "Purplepeter", "Rapture", "Raycast Dark", "Raycast Light", "Rebecca", "Red Alert", "Red Planet", "Red Sands", "Relaxed", "Retro", "Retro Legends", "Rippedcasts", "Rose Pine", "Rose Pine Dawn", "Rose Pine Moon", "Rouge 2", "Royal", "Ryuuko", "Sakura", "Scarlet Protocol", "Sea Shells", "Seafoam Pastel", "Selenized Black", "Selenized Dark", "Selenized Light", "Seoulbones Dark", "Seoulbones Light", "Seti", "Shades Of Purple", "Shaman", "Slate", "Sleepy Hollow", "Smyck", "Snazzy", "Snazzy Soft", "Soft Server", "Solarized Darcula", "Solarized Dark Higher Contrast", "Solarized Dark Patched", "Solarized Osaka Night", "Sonokai", "Spacedust", "Spacegray", "Spacegray Bright", "Spacegray Eighties", "Spacegray Eighties Dull", "Spiderman", "Spring", "Square", "Squirrelsong Dark", "Srcery", "Starlight", "Sublette", "Subliminal", "Sugarplum", "Sundried", "Symfonic", "Synthwave", "Synthwave Alpha", "Synthwave Everything", "Tango Adapted", "Tango Half Adapted", "Tearout", "Teerb", "Terafox", "Terminal Basic", "Terminal Basic Dark", "Thayer Bright", "The Hulk", "Tinacious Design Dark", "Tinacious Design Light", "TokyoNight", "TokyoNight Day", "TokyoNight Moon", "TokyoNight Night", "TokyoNight Storm", "Tomorrow", "Tomorrow Night", "Tomorrow Night Blue", "Tomorrow Night Bright", "Tomorrow Night Burns", "Tomorrow Night Eighties", "Toy Chest", "traffic", "Treehouse", "Twilight", "Ubuntu", "Ultra Dark", "Ultra Violent", "Under The Sea", "Unikitty", "urban", "Urple", "Vague", "Vaughn", "Vercel", "Vesper", "Vibrant Ink", "Vimbones", "Violet Dark", "Violet Light", "Violite", "Warm Neon", "Wez", "Whimsy", "Wild Cherry", "Wilmersdorf", "Wombat", "Wryan", "Xcode Dark", "Xcode Dark hc", "Xcode Light", "Xcode Light hc", "Xcode WWDC", "Zenbones", "Zenbones Dark", "Zenbones Light", "Zenburn", "Zenburned", "Zenwritten Dark", "Zenwritten Light"];
+export type BuiltinThemeName = (typeof BUILTIN_THEME_NAMES)[number];
+export declare const BUILTIN_THEME_SOURCES: Record<BuiltinThemeName, string>;

package/dist/theme/catalog.d.ts

@@ -0,0 +1,7 @@
+import { type GhosttyTheme } from "./ghostty";
+import { type BuiltinThemeName } from "./builtin-themes";
+export type ResttyBuiltinThemeName = BuiltinThemeName;
+export declare function listBuiltinThemeNames(): ResttyBuiltinThemeName[];
+export declare function isBuiltinThemeName(name: string): name is ResttyBuiltinThemeName;
+export declare function getBuiltinThemeSource(name: string): string | null;
+export declare function getBuiltinTheme(name: string): GhosttyTheme | null;

package/dist/theme/ghostty.d.ts

@@ -0,0 +1,23 @@
+export type ThemeColor = {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+};
+export type GhosttyTheme = {
+    name?: string;
+    colors: {
+        background?: ThemeColor;
+        foreground?: ThemeColor;
+        cursor?: ThemeColor;
+        cursorText?: ThemeColor;
+        selectionBackground?: ThemeColor;
+        selectionForeground?: ThemeColor;
+        palette: Array<ThemeColor | undefined>;
+    };
+    raw: Record<string, string>;
+};
+export declare function parseGhosttyColor(value: string): ThemeColor | null;
+export declare function colorToFloats(color: ThemeColor, alphaOverride?: number): [number, number, number, number];
+export declare function colorToRgbU32(color: ThemeColor): number;
+export declare function parseGhosttyTheme(text: string): GhosttyTheme;

package/dist/theme/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./ghostty";
+export * from "./catalog";