gespenst API - v0.1.0
    Preparing search index...

    The stable xterm.js 6 public API backed by Ghostty's VT implementation. Use ready whenever work must wait for the asynchronous WASM startup.

    Index

    xterm-compatible normal, alternate, and active buffer views.

    native: Promise<GespenstTerminal>

    Resolves to the underlying native Gespenst terminal.

    onBell: IEvent<void, void> = ...

    Fires when the terminal processes a bell control character.

    onBinary: IEvent<string, void> = ...

    Fires for binary input emitted by the compatibility layer.

    onCursorMove: IEvent<void, void> = ...

    Fires when the active buffer cursor moves.

    onData: IEvent<string, void> = ...

    Fires when user input should be forwarded to the PTY.

    onKey: IEvent<XtermKeyEvent, void> = ...

    Fires with both encoded input and the originating browser key event.

    onLineFeed: IEvent<void, void> = ...

    Fires when parsed output advances to a new line.

    onRender: IEvent<XtermRenderEvent, void> = ...

    Fires when an inclusive viewport row range needs rendering.

    onResize: IEvent<XtermResizeEvent, void> = ...

    Fires when terminal character geometry changes.

    onScroll: IEvent<number, void> = ...

    Fires with the current viewport scroll position.

    onSelectionChange: IEvent<void, void> = ...

    Fires when the current text selection changes.

    onTitleChange: IEvent<string, void> = ...

    Fires when a VT title sequence changes the terminal title.

    onWriteParsed: IEvent<void, void> = ...

    Fires after a queued write has been parsed and synchronized.

    parser: IParser

    xterm-compatible parser registration API applied before bytes reach Ghostty.

    ready: Promise<void>

    Resolves after the Ghostty WASM runtime is initialized and native listeners are installed.

    Unicode-width provider namespace; Ghostty remains the authoritative width engine.

    strings: ILocalizableStrings = ...

    Localizable strings used by accessibility helpers.

    • get element(): HTMLElement | undefined

      The root xterm-compatible element after open has been called.

      Returns HTMLElement | undefined

    • get textarea(): HTMLTextAreaElement | undefined

      The native terminal's input textarea after asynchronous startup.

      Returns HTMLTextAreaElement | undefined

    • Installs a keyboard event filter invoked before the native input handler.

      Parameters

      • handler: (event: KeyboardEvent) => boolean

      Returns void

    • Installs a wheel event filter invoked before native scrolling.

      Parameters

      • handler: (event: WheelEvent) => boolean

      Returns void

    • Sends user input to the PTY-facing native input stream.

      Parameters

      • data: string
      • wasUserInput: boolean = true

      Returns void

    • Mounts the terminal in parent; repeated calls after a successful open are no-ops.

      Parameters

      • parent: HTMLElement

      Returns void

    • Sends pasted text through Ghostty's paste input path.

      Parameters

      • data: string

      Returns void

    • Emits an xterm-compatible render event for the inclusive row range.

      Parameters

      • start: number
      • end: number

      Returns void

    • Character joiners cannot replace Ghostty's internal shaping and throw when invoked.

      Parameters

      • _handler: (text: string) => [number, number][]

      Returns number

    • Resizes the terminal to the requested character geometry.

      Parameters

      • columns: number
      • rows: number

      Returns void

    • Scrolls the viewport by a signed row count.

      Parameters

      • amount: number

      Returns void

    • Scrolls the viewport by a signed page count.

      Parameters

      • pageCount: number

      Returns void

    • Scrolls to an absolute zero-based buffer row.

      Parameters

      • line: number

      Returns void

    • Selects length characters from a zero-based buffer coordinate.

      Parameters

      • column: number
      • row: number
      • length: number

      Returns void

    • Selects a contiguous range of zero-based buffer rows.

      Parameters

      • start: number
      • end: number

      Returns void

    • Queues text or bytes for Ghostty parsing and invokes callback after synchronization.

      Parameters

      • data: string | Uint8Array<ArrayBufferLike>
      • Optionalcallback: () => void

      Returns void

    • Writes text or bytes followed by carriage return and line feed.

      Parameters

      • data: string | Uint8Array<ArrayBufferLike>
      • Optionalcallback: () => void

      Returns void