@0xbigboss/ghostty-web 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -699,27 +699,43 @@ export declare interface ILinkProvider {
  */
 export declare function init(): Promise<void>;
 
-/**
- * InputHandler class
- * Attaches keyboard event listeners to a container and converts
- * keyboard events to terminal input data
- */
 export declare class InputHandler {
     private encoder;
     private container;
+    private inputElement?;
     private onDataCallback;
     private onBellCallback;
     private onKeyCallback?;
     private customKeyEventHandler?;
     private getModeCallback?;
+    private onCopyCallback?;
+    private mouseConfig?;
+    private macOptionIsMeta;
+    private isMac;
     private keydownListener;
     private keypressListener;
     private pasteListener;
+    private beforeInputListener;
     private compositionStartListener;
     private compositionUpdateListener;
     private compositionEndListener;
+    private mousedownListener;
+    private mouseupListener;
+    private mousemoveListener;
+    private wheelListener;
     private isComposing;
     private isDisposed;
+    private mouseButtonsPressed;
+    private lastKeyDownData;
+    private lastKeyDownTime;
+    private lastPasteData;
+    private lastPasteTime;
+    private lastPasteSource;
+    private lastCompositionData;
+    private lastCompositionTime;
+    private lastBeforeInputData;
+    private lastBeforeInputTime;
+    private static readonly BEFORE_INPUT_IGNORE_MS;
     /**
      * Create a new InputHandler
      * @param ghostty - Ghostty instance (for creating KeyEncoder)
@@ -729,8 +745,12 @@ export declare class InputHandler {
      * @param onKey - Optional callback for raw key events
      * @param customKeyEventHandler - Optional custom key event handler
      * @param getMode - Optional callback to query terminal mode state (for application cursor mode)
+     * @param onCopy - Optional callback to handle copy (Cmd+C/Ctrl+C with selection)
+     * @param inputElement - Optional input element for beforeinput events
+     * @param mouseConfig - Optional mouse tracking configuration
+     * @param macOptionIsMeta - Treat Option key as Meta on Mac (sends ESC prefix)
      */
-    constructor(ghostty: Ghostty, container: HTMLElement, onData: (data: string) => void, onBell: () => void, onKey?: (keyEvent: IKeyEvent) => void, customKeyEventHandler?: (event: KeyboardEvent) => boolean | undefined, getMode?: (mode: number) => boolean);
+    constructor(ghostty: Ghostty, container: HTMLElement, onData: (data: string) => void, onBell: () => void, onKey?: (keyEvent: IKeyEvent) => void, customKeyEventHandler?: (event: KeyboardEvent) => boolean | undefined, getMode?: (mode: number) => boolean, onCopy?: () => boolean, inputElement?: HTMLElement, mouseConfig?: MouseTrackingConfig, macOptionIsMeta?: boolean);
     /**
      * Set custom key event handler (for runtime updates)
      * Returns: true = terminal handles it, false = let it bubble, undefined = default processing
@@ -763,11 +783,23 @@ export declare class InputHandler {
      * @param event - KeyboardEvent
      */
     private handleKeyDown;
+    /**
+     * Handle Option key as Meta on Mac (sends ESC prefix)
+     * This enables word navigation shortcuts like Option+Left/Right
+     * @param event - KeyboardEvent with altKey pressed
+     * @returns true if the event was handled
+     */
+    private handleOptionAsMeta;
     /**
      * Handle paste event from clipboard
      * @param event - ClipboardEvent
      */
     private handlePaste;
+    /**
+     * Handle beforeinput event (mobile/IME input)
+     * @param event - InputEvent
+     */
+    private handleBeforeInput;
     /**
      * Handle compositionstart event
      */
@@ -780,6 +812,88 @@ export declare class InputHandler {
      * Handle compositionend event
      */
     private handleCompositionEnd;
+    /**
+     * Cleanup text nodes in container after composition
+     */
+    private cleanupCompositionTextNodes;
+    /**
+     * Convert pixel coordinates to terminal cell coordinates
+     */
+    private pixelToCell;
+    /**
+     * Get modifier flags for mouse event
+     */
+    private getMouseModifiers;
+    /**
+     * Encode mouse event as SGR sequence
+     * SGR format: \x1b[<Btn;Col;RowM (press/motion) or \x1b[<Btn;Col;Rowm (release)
+     */
+    private encodeMouseSGR;
+    /**
+     * Encode mouse event as X10/normal sequence (legacy format)
+     * Format: \x1b[M<Btn+32><Col+32><Row+32>
+     */
+    private encodeMouseX10;
+    /**
+     * Send mouse event to terminal
+     */
+    private sendMouseEvent;
+    /**
+     * Handle mousedown event
+     */
+    private handleMouseDown;
+    /**
+     * Handle mouseup event
+     */
+    private handleMouseUp;
+    /**
+     * Handle mousemove event
+     */
+    private handleMouseMove;
+    /**
+     * Handle wheel event (scroll)
+     */
+    private handleWheel;
+    /**
+     * Emit paste data with bracketed paste support
+     */
+    private emitPasteData;
+    /**
+     * Record keydown data for beforeinput de-duplication
+     */
+    private recordKeyDownData;
+    /**
+     * Record paste data for beforeinput de-duplication
+     */
+    private recordPasteData;
+    /**
+     * Check if beforeinput should be ignored due to a recent keydown
+     */
+    private shouldIgnoreBeforeInput;
+    /**
+     * Check if beforeinput text should be ignored due to a recent composition end
+     */
+    private shouldIgnoreBeforeInputFromComposition;
+    /**
+     * Check if composition end should be ignored due to a recent beforeinput text
+     */
+    private shouldIgnoreCompositionEnd;
+    /**
+     * Record beforeinput text for composition de-duplication
+     */
+    private recordBeforeInputData;
+    /**
+     * Record composition end data for beforeinput de-duplication
+     */
+    private recordCompositionData;
+    /**
+     * Check if paste should be ignored due to a recent paste event from another source
+     */
+    private shouldIgnorePasteEvent;
+    /**
+     * Get current time in milliseconds
+     */
+    private getNow;
     /**
      * Dispose the InputHandler and remove event listeners
      */
@@ -896,6 +1010,7 @@ export declare interface ITerminalOptions {
     convertEol?: boolean;
     disableStdin?: boolean;
     smoothScrollDuration?: number;
+    macOptionIsMeta?: boolean;
     onLinkClick?: (url: string, event: MouseEvent) => boolean;
     ghostty?: Ghostty;
 }
@@ -1237,6 +1352,31 @@ export declare enum Mods {
     NUMLOCK = 32
 }
 
+/**
+ * InputHandler class
+ * Attaches keyboard event listeners to a container and converts
+ * keyboard events to terminal input data
+ */
+/**
+ * Mouse tracking configuration
+ */
+declare interface MouseTrackingConfig {
+    /** Check if any mouse tracking mode is enabled */
+    hasMouseTracking: () => boolean;
+    /** Check if SGR extended mouse mode is enabled (mode 1006) */
+    hasSgrMouseMode: () => boolean;
+    /** Get cell dimensions for pixel to cell conversion */
+    getCellDimensions: () => {
+        width: number;
+        height: number;
+    };
+    /** Get canvas/container offset for accurate position calculation */
+    getCanvasOffset: () => {
+        left: number;
+        top: number;
+    };
+}
+
 /**
  * OSC 8 Hyperlink Provider
  *
@@ -1317,7 +1457,6 @@ export declare class SelectionManager {
     private selectionEnd;
     private isSelecting;
     private mouseDownTarget;
-    private mouseButtonsPressed;
     private dirtySelectionRows;
     private selectionChangedEmitter;
     private boundMouseUpHandler;
@@ -1351,6 +1490,11 @@ export declare class SelectionManager {
      * Check if there's an active selection
      */
     hasSelection(): boolean;
+    /**
+     * Copy the current selection to clipboard
+     * @returns true if there was text to copy, false otherwise
+     */
+    copySelection(): boolean;
     /**
      * Clear the selection
      */
@@ -1412,42 +1556,6 @@ export declare class SelectionManager {
      * Cleanup resources
      */
     dispose(): void;
-    /**
-     * Check if SGR mouse format (DEC mode 1006) is enabled.
-     * When 1006 is not enabled, applications expect X10 format which we don't yet support.
-     * Returns true if SGR mode is enabled, false otherwise.
-     */
-    private hasSGRMouseMode;
-    /**
-     * Check if motion events should be reported based on tracking mode.
-     * - Mode 1000 (NORMAL): Only button press/release, no motion
-     * - Mode 1002 (BUTTON): Motion only while button is held
-     * - Mode 1003 (ANY): All motion events
-     */
-    private shouldReportMotion;
-    /**
-     * Map browser button codes to SGR button codes.
-     * Only buttons 0, 1, 2 are valid; others return null.
-     */
-    private mapButton;
-    /**
-     * Encode modifier keys into button code.
-     * Shift: +4, Alt/Meta: +8, Ctrl: +16
-     */
-    private encodeModifiers;
-    /**
-     * Generate SGR mouse sequence and send to terminal.
-     * SGR format: CSI < button ; col ; row M (press) or m (release)
-     * Button code includes: base button (0-2) + motion flag (32) + modifiers (4/8/16) + scroll (64/65)
-     *
-     * Only sends if DEC mode 1006 (SGR) is enabled. Without 1006, applications expect
-     * X10 format which encodes differently and has coordinate limits.
-     */
-    private sendMouseEvent;
-    /**
-     * Send scroll wheel event with modifiers.
-     */
-    private sendScrollEvent;
     /**
      * Attach mouse event listeners to canvas
      */
@@ -1483,8 +1591,22 @@ export declare class SelectionManager {
     private getWordAtCell;
     /**
      * Copy text to clipboard
+     *
+     * Strategy (modern APIs first):
+     * 1. Try ClipboardItem API (works in Safari and modern browsers)
+     *    - Safari requires the ClipboardItem to be created synchronously within user gesture
+     * 2. Try navigator.clipboard.writeText (modern async API, may fail in Safari)
+     * 3. Fall back to execCommand (legacy, for older browsers)
      */
     private copyToClipboard;
+    /**
+     * Copy using navigator.clipboard.writeText
+     */
+    private copyWithWriteText;
+    /**
+     * Copy using legacy execCommand (fallback for older browsers)
+     */
+    private copyWithExecCommand;
     /**
      * Request a render update (triggers selection overlay redraw)
      */
@@ -1536,9 +1658,6 @@ export declare class Terminal implements ITerminalCore {
     private isOpen;
     private isDisposed;
     private animationFrameId?;
-    private _isResizing;
-    private _writeQueue;
-    private _resizeFlushFrameId?;
     private addons;
     private customKeyEventHandler?;
     private currentTitle;
@@ -1610,17 +1729,8 @@ export declare class Terminal implements ITerminalCore {
     input(data: string, wasUserInput?: boolean): void;
     /**
      * Resize terminal
-     *
-     * Note: We pause the render loop and queue writes during resize to prevent
-     * race conditions. The WASM terminal reallocates internal buffers during
-     * resize, and if the render loop or writes access those buffers concurrently,
-     * it can cause a crash.
      */
     resize(cols: number, rows: number): void;
-    /**
-     * Flush queued writes that were blocked during resize
-     */
-    private flushWriteQueue;
     /**
      * Clear terminal screen
      */
@@ -1653,6 +1763,11 @@ export declare class Terminal implements ITerminalCore {
      * Clear the current selection
      */
     clearSelection(): void;
+    /**
+     * Copy the current selection to clipboard
+     * @returns true if there was text to copy, false otherwise
+     */
+    copySelection(): boolean;
     /**
      * Select all text in the terminal
      */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@0xbigboss/ghostty-web",
-  "version": "0.4.0",
-  "description": "Web-based terminal emulator using Ghostty's VT100 parser via WebAssembly. Fork with enhanced selection handling.",
+  "version": "0.5.0",
+  "description": "Web-based terminal emulator using Ghostty's VT100 parser via WebAssembly",
   "type": "module",
   "main": "./dist/ghostty-web.umd.cjs",
   "module": "./dist/ghostty-web.js",
@@ -29,20 +29,16 @@
     "wasm",
     "webassembly",
     "ansi",
-    "tty",
-    "vscode"
+    "tty"
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/0xBigBoss/ghostty-web.git"
+    "url": "https://github.com/coder/ghostty-web.git"
   },
-  "bugs": "https://github.com/0xBigBoss/ghostty-web/issues",
-  "homepage": "https://github.com/0xBigBoss/ghostty-web#readme",
+  "bugs": "https://github.com/coder/ghostty-web/issues",
+  "homepage": "https://github.com/coder/ghostty-web#readme",
   "license": "MIT",
-  "author": "0xBigBoss",
-  "contributors": [
-    "Coder (https://github.com/coder)"
-  ],
+  "author": "Coder",
   "publishConfig": {
     "access": "public"
   },