coneko-term 0.0.0-stage → 0.1.0

package/dist/terminal.d.ts

@@ -0,0 +1,1006 @@
+import { type SelectionRange } from "./selection.js";
+import { type CellSize } from "./renderer.js";
+/** セル 1 つが使う `u32` の数。`RowView.cells` の並びは README を参照。 */
+export declare const CELL_STRIDE = 7;
+/** セルの字（並びの 0 番目）にこのビットが立っていたら、残りのビットが `RowView.cluster` の番号。 */
+export declare const CLUSTER_FLAG = 2147483648;
+/** プログラムの状態（kitty の OSC 7501）。 */
+export type ProgramState = "idle" | "working" | "done" | "blocked" | "error";
+/** `blocked` の理由。 */
+export type ProgramKind = "permission" | "question" | "auth";
+/** プログラムが報告した状態の記録 1 つ。 */
+export interface ProgramStatus {
+    /** 記録の id。根の記録は空の文字列。 */
+    id: string;
+    state: ProgramState;
+    /** `blocked` のときの理由。 */
+    kind?: ProgramKind;
+    /** 0 から 100。無ければ、動いているが割合は分からない。 */
+    progress?: number;
+    /** プログラムの識別子。報告に無ければ、いちばん近い親の記録のもの。 */
+    app?: string;
+    /** 短い名札。 */
+    title?: string;
+    /** 1 行の説明。 */
+    msg?: string;
+}
+/** `onProgramStatus` に渡す、記録の変化。 */
+export interface ProgramStatusChange {
+    /** 変わった記録の id（根の記録は空）。 */
+    id: string;
+    /** 新しい中身。記録が消えたときは `undefined`。 */
+    status?: ProgramStatus;
+}
+/** `Terminal.handleMouse` に渡すポインターのイベント。 */
+export interface MouseInput {
+    /** 押した、離した、動かした、窓から出た（`leave`。kitty の拡張）。 */
+    type: "down" | "up" | "move" | "leave";
+    /** DOM の `MouseEvent.button` と同じ（0 左、1 真ん中、2 右、3 戻る、4 進む）。`down` だけが使う。 */
+    button: number;
+    /** 見えている画面の列（0 始まり）。範囲の外は端に寄せる。 */
+    col: number;
+    /** 見えている画面の行（0 始まり）。範囲の外は端に寄せる。 */
+    row: number;
+    /** 画面の左端からの CSS ピクセル（`CSI ? 1016 h` のときだけ使う）。 */
+    x?: number;
+    /** 画面の上端からの CSS ピクセル（`CSI ? 1016 h` のときだけ使う）。 */
+    y?: number;
+    /** Shift を押している。 */
+    shiftKey?: boolean;
+    /** Alt（Option）を押している。 */
+    altKey?: boolean;
+    /** Ctrl を押している。 */
+    ctrlKey?: boolean;
+    /** 連続して押した回数（DOM の `MouseEvent.detail`）。1 は範囲、2 は単語、3 は行。`down` だけが使う。 */
+    clickCount?: number;
+}
+/** `Terminal.handleWheel` に渡すホイールのイベント。 */
+export interface WheelInput {
+    /** 縦の量（DOM の `WheelEvent.deltaY`）。負が上。 */
+    deltaY: number;
+    /** 0 がピクセル、1 が行、2 がページ（DOM の `WheelEvent.deltaMode`）。 */
+    deltaMode?: number;
+    /** 見えている画面の列（0 始まり）。報告が有効なときだけ使う（無ければ 0）。 */
+    col?: number;
+    /** 見えている画面の行（0 始まり）。報告が有効なときだけ使う（無ければ 0）。 */
+    row?: number;
+    /** 画面の左端からの CSS ピクセル（`CSI ? 1016 h` の報告だけが使う）。 */
+    x?: number;
+    /** 画面の上端からの CSS ピクセル（`CSI ? 1016 h` の報告だけが使う）。 */
+    y?: number;
+    /** Shift を押している。押していると縦に動かさない。 */
+    shiftKey?: boolean;
+    /** Alt（Option）を押している。 */
+    altKey?: boolean;
+    /** Ctrl を押している。 */
+    ctrlKey?: boolean;
+}
+/** 後始末ができるもの。 */
+export interface Disposable {
+    dispose(): void;
+}
+/** 色。`#rgb` か `#rrggbb`。 */
+export interface Theme {
+    /** 文字の色（OSC 10 の問い合わせに返す）。 */
+    foreground?: string;
+    /** 背景の色（OSC 11）。 */
+    background?: string;
+    /** カーソルの色（OSC 12）。 */
+    cursor?: string;
+    /** 選択範囲の背景。`#rgb`、`#rgba`、`#rrggbb`、`#rrggbbaa`。字はこの色の下に見えるので、半透明にする。既定は `#ffffff4d`（xterm.js と同じ）。 */
+    selectionBackground?: string;
+    black?: string;
+    red?: string;
+    green?: string;
+    yellow?: string;
+    blue?: string;
+    magenta?: string;
+    cyan?: string;
+    white?: string;
+    brightBlack?: string;
+    brightRed?: string;
+    brightGreen?: string;
+    brightYellow?: string;
+    brightBlue?: string;
+    brightMagenta?: string;
+    brightCyan?: string;
+    brightWhite?: string;
+}
+/** `Terminal` を作るときの設定。 */
+export interface TerminalOptions {
+    /** 列の数。既定は 80。 */
+    cols?: number;
+    /** 行の数。既定は 24。 */
+    rows?: number;
+    /** 描画に使うフォント（CSS の `font-family`）。既定は `monospace`。 */
+    fontFamily?: string;
+    /** 字の大きさ（CSS ピクセル）。既定は 15（xterm.js と同じ）。 */
+    fontSize?: number;
+    /** 行の高さ。字の高さに掛ける倍率（xterm.js と同じ）。既定は 1。 */
+    lineHeight?: number;
+    /** カーソルを点滅させるか。`CSI Ps SP q` で変わる。既定は false。 */
+    cursorBlink?: boolean;
+    /** スクロールバックの行数。既定は 1000。 */
+    scrollback?: number;
+    /** テーマ。 */
+    theme?: Theme;
+    /** ダブルクリックで単語を選ぶときの区切りの字。既定は xterm.js と同じ（空白と ``()[]{}',"`` ）。 */
+    wordSeparator?: string;
+    /**
+     * macOS で Option を Meta（ESC の前置き）として送るか。既定は false（xterm.js と同じ。
+     * Option は字を打つキーとして扱う）。
+     */
+    macOptionIsMeta?: boolean;
+    /** キーを打ったとき、さかのぼって見ていたら一番下へ戻すか。既定は true（xterm.js と同じ）。 */
+    scrollOnUserInput?: boolean;
+}
+/**
+ * 組み立て終わった通知（kitty の desktop notifications、OSC 99）。
+ * 仕様のキーを読んだ形で持つ。OS の通知につなぐのは呼ぶ側。
+ */
+export interface TerminalNotification {
+    /** `i`。無ければ空文字列。 */
+    id: string;
+    /** 題名（`p=title`）。 */
+    title: string;
+    /** 本文（`p=body`）。 */
+    body: string;
+    /** 緊急度（`u`）。指定が無ければ `undefined`。 */
+    urgency?: 0 | 1 | 2;
+    /** 押されたときの動き（`a`）。既定は `{ focus: true, report: false }`。 */
+    actions: {
+        focus: boolean;
+        report: boolean;
+    };
+    /** いつ出すか（`o`）。 */
+    when: "always" | "unfocused" | "invisible";
+    /** 閉じられたときに知らせるか（`c=1`）。 */
+    reportClose: boolean;
+    /** アプリケーションの名前（`f`）。 */
+    appName?: string;
+    /** 通知の種類（`t`）。 */
+    types: string[];
+    /** 消えるまでの時間（`w`、ミリ秒。-1 は OS の既定、0 は消えない）。指定が無ければ `undefined`。 */
+    timeout?: number;
+    /** 音（`s`）。 */
+    sound?: string;
+    /** アイコンの名前（`n`）。 */
+    iconNames: string[];
+    /** アイコンの画像を指す ID（`g`）。画像そのものは読まない。 */
+    iconCacheId?: string;
+    /** ボタンの文字（`p=buttons`）。 */
+    buttons: string[];
+}
+/** `p=?` への返事に書く、対応していることの一覧。省いた項目は既定（下記）。 */
+export interface NotificationSupport {
+    /** 対応する `a` の値。既定は `["focus", "report"]`。 */
+    actions?: string[];
+    /** 対応する `o` の値。既定は `["always", "unfocused", "invisible"]`。 */
+    when?: string[];
+    /** 対応する `p` の値。既定は `["title", "body", "?", "close", "alive"]`。 */
+    payloads?: string[];
+    /** 対応する `u` の値。既定は `[0, 1, 2]`。 */
+    urgencies?: number[];
+    /** `c=1` に対応するか。既定は `true`。 */
+    closeReport?: boolean;
+    /** `w` に対応するか。既定は `false`。 */
+    timeout?: boolean;
+    /** 対応する `s` の値。既定は無し。 */
+    sounds?: string[];
+    /** 対応する `t` の値。既定は無し。 */
+    types?: string[];
+}
+/** どちらのクリップボードか。 */
+export type ClipboardLocation = "clipboard" | "primary";
+/** クリップボードの、ある MIME の種類のデータ。 */
+export interface ClipboardItem {
+    /** MIME の種類（`text/plain` など）。 */
+    mime: string;
+    /** データ（base64 を戻したあとのバイト列）。 */
+    data: Uint8Array;
+}
+/** クリップボードへの書き込み（kitty の clipboard protocol、OSC 5522）。 */
+export interface ClipboardWriteRequest {
+    /** `id`。無ければ空文字列。`replyClipboardWrite` に渡す。 */
+    id: string;
+    /** 書き込み先。 */
+    location: ClipboardLocation;
+    /** MIME の種類ごとのデータ。別名（`walias`）は、別名ごとの項目に広げてある。 */
+    items: ClipboardItem[];
+}
+/** クリップボードの読み取りの頼み（OSC 5522 の `type=read`）。 */
+export interface ClipboardReadRequest {
+    /** `id`。無ければ空文字列。答えに渡す。 */
+    id: string;
+    /** 読む先。 */
+    location: ClipboardLocation;
+    /** 真なら、あるデータの種類の一覧がほしい（`mimes` は空）。許可を求めなくてよい（仕様）。 */
+    list: boolean;
+    /** 頼まれた MIME の種類（先に書いたものほど優先）。 */
+    mimes: string[];
+}
+/** 書き込みの答え。`DONE` は成功。 */
+export type ClipboardWriteStatus = "DONE" | "EIO" | "EINVAL" | "ENOSYS" | "EPERM" | "EBUSY" | "EFBIG";
+/** 読み取りを断る・失敗を知らせる答え。 */
+export type ClipboardReadError = "ENOSYS" | "EPERM" | "EBUSY";
+/** ドロップやドラッグの操作。 */
+export type DndOperation = "copy" | "move";
+/** 許す操作の組。 */
+export interface DndOperations {
+    copy?: boolean;
+    move?: boolean;
+}
+/** ドラッグの位置（kitty の drag and drop protocol）。セルは左上が (0, 0)、画素は左上からのずれ。 */
+export interface DndLocation {
+    x: number;
+    y: number;
+    pixelX: number;
+    pixelY: number;
+}
+/** ターミナルが答えるエラーの、POSIX の記号名。知らない値は `EIO`。 */
+export type DndErrorName = "ENOENT" | "EINVAL" | "EUNKNOWN" | "EPERM" | "EIO" | "EMFILE" | "ENOMEM" | "EFBIG";
+/** ドロップされたデータの頼み（`DropRequestEvent`）。鍵は仕様の `x`・`y`・`Y`。 */
+export type DropRequest = 
+/** `t=r:x=idx`: 落とされた一覧の `index` 番目（1 始まり）の MIME の種類のデータ。 */
+{
+    type: "data";
+    index: number;
+}
+/** `t=r:x=idx:y=subidx`: `text/uri-list`（`index` 番目の種類）の `subIndex` 番目の項目。遠くの機械からのドロップ。 */
+ | {
+    type: "entry";
+    index: number;
+    subIndex: number;
+}
+/** `t=r:Y=handle:x=num`: ディレクトリ（`handle`）の `index` 番目（1 始まり）の項目。 */
+ | {
+    type: "dirEntry";
+    handle: number;
+    index: number;
+}
+/** `t=r:Y=handle`: ディレクトリを読み終えた。`handle` を捨ててよい。答えは要らない。 */
+ | {
+    type: "dirClose";
+    handle: number;
+};
+/** ドロップのデータの答えの形（`X` 鍵）。 */
+export type DropDataForm = 
+/** MIME の種類のデータ。`remote` は、送り元がプログラムとは別の機械か（`text/uri-list` の答えにだけ付ける）。 */
+{
+    kind: "mime";
+    remote?: boolean;
+}
+/** 普通のファイルの中身。 */
+ | {
+    kind: "file";
+}
+/** シンボリックリンク。データはリンク先。 */
+ | {
+    kind: "symlink";
+}
+/** ディレクトリ。データは、中の項目を NUL で区切った一覧。`handle` は 0 と 1 以外。 */
+ | {
+    kind: "directory";
+    handle: number;
+};
+/** ドラッグの画像（サムネイル）。 */
+export interface DragImage {
+    /** 形式。`text` は UTF-8 のテキストで、ターミナルが描く。 */
+    format: "rgb" | "rgba" | "png" | "text";
+    /** 幅（画素）。`text` では、文字の大きさの割合の分子（`基本の大きさ * width / height`）。 */
+    width: number;
+    /** 高さ（画素）。`text` では、同じ割合の分母。 */
+    height: number;
+    /** 背景の不透明度（0 から 1024）。`text` のときだけ意味がある。 */
+    opacity: number;
+    /** 画像のデータ（base64 を戻したあと）。 */
+    data: Uint8Array;
+}
+/**
+ * kitty の drag and drop protocol（OSC 72）のイベント。`onDnd` で受ける。
+ *
+ * ドロップを受ける側:
+ * - `dropEnabled` / `dropDisabled`: プログラムがドロップを受け付ける・やめた。ドロップの途中でやめたら、先に `dropFinished`（`operation` が null）が来る。
+ * - `dropResponse`: ドラッグが窓の上にある間のプログラムの答え。OS に、受けるか・どの操作かを伝える。
+ * - `dropRequest`: ドロップされたデータの頼み。`replyDropData` か `replyDropError` で答える。
+ * - `dropFinished`: プログラムがドロップを読み終えた。OS にドロップの完了を伝える。`operation` が null なら取り消し。
+ *
+ * ドラッグを始める側:
+ * - `dragEnabled` / `dragDisabled`: プログラムがドラッグを始められると言った・やめた。
+ * - `dragStart`: ドラッグを始める求め。OS のドラッグを始め、`dragStarted` か `dragError` で答える。
+ * - `dragImage`: ドラッグの画像を変える。`index` が null なら外す（範囲外の番号も null にそろえてある）。
+ * - `dragData` / `dragDataError`: `requestDragData` で頼んだ MIME の種類（0 始まり）のデータ・エラー。分けて届いたデータは、終わり（空のパケット）でそろえて 1 回だけ来る。
+ * - `dragEntry`: 遠くの機械へのドラッグで、`requestDragEntry` で頼んだ項目のデータ。
+ * - `dragCanceled` / `dragAborted`: プログラムがドラッグを取り消した・エラーで止めた。
+ */
+export type DndEvent = {
+    type: "dropEnabled";
+    mimes: string[];
+} | {
+    type: "dropDisabled";
+} | {
+    type: "dropResponse";
+    operation: DndOperation | null;
+    /** 受けたい MIME の種類（好む順）。null は、一覧を変えない。 */
+    mimes: string[] | null;
+} | {
+    type: "dropRequest";
+    request: DropRequest;
+} | {
+    type: "dropFinished";
+    operation: DndOperation | null;
+} | {
+    type: "dragEnabled";
+    machineId: string | null;
+} | {
+    type: "dragDisabled";
+} | {
+    type: "dragStart";
+    /** プログラムが許す操作。 */
+    operations: {
+        copy: boolean;
+        move: boolean;
+    };
+    /** 申し出た MIME の種類（順番が番号になる）。 */
+    mimes: string[];
+    /** 先に送られたデータ。`mimes` と同じ並びで、送られていないものは null。 */
+    data: (Uint8Array | null)[];
+    images: DragImage[];
+    /** 始めるときに使う画像の番号（0 始まり）。無ければ null。 */
+    image: number | null;
+    /** プログラムの機械の ID。 */
+    machineId: string | null;
+} | {
+    type: "dragImage";
+    index: number | null;
+} | {
+    type: "dragData";
+    index: number;
+    data: Uint8Array;
+} | {
+    type: "dragDataError";
+    index: number;
+    error: string;
+    description: string;
+} | {
+    type: "dragEntry";
+    /** `text/uri-list` の中の番号（1 始まり）。 */
+    index: number;
+    /** ディレクトリの中の番号（1 始まり）。トップの項目なら 0。 */
+    subIndex: number;
+    /** 親のディレクトリの handle。トップの項目なら 0。 */
+    parent: number;
+    form: "file" | "symlink" | "directory";
+    /** `form` が `directory` のときの handle。 */
+    handle: number;
+    data: Uint8Array;
+} | {
+    type: "dragCanceled";
+} | {
+    type: "dragAborted";
+    error: string;
+    description: string;
+};
+/** ファイル転送のセッションの始まり（`send` と `receive`）。 */
+export interface FileTransferStart {
+    /** セッションの `id`。答えに渡す。 */
+    id: string;
+    /** `pw` を戻した文字列（仕様では `sha256:<hash>`）。比べるのは呼ぶ側。無ければ `null`。 */
+    bypass: string | null;
+    /** `q`。0 は全部返す、1 はエラーだけ、2 は何も返さない。省くのは coneko-term がする。 */
+    quiet: 0 | 1 | 2;
+    /** `sz`。`receive` が頼むパスの数。 */
+    paths: number | null;
+}
+/** ファイルの種類。 */
+export type FileTransferFileType = "regular" | "directory" | "symlink" | "link";
+/** ファイル転送のエラーの記号名。知らない値は `EIO`。 */
+export type FileTransferErrorName = "EPERM" | "ENOENT" | "EEXIST" | "EISDIR" | "ENOTDIR" | "EACCES" | "EINVAL" | "EIO" | "EFBIG" | "ENOSPC";
+/**
+ * kitty の file transfer protocol（OSC 5113）で、クライアントが送った命令。`onFileTransfer` で受ける。
+ * データの圧縮（`compression: "zlib"`）と rsync の署名・差分は読み解かず、バイト列のまま渡す。
+ */
+export type FileTransferEvent = 
+/** `ac=send`: ファイルを送りたい。`replyFileTransferOk` か `refuseFileTransfer` で答える。 */
+({
+    type: "send";
+} & FileTransferStart)
+/** `ac=receive`: ファイルを受け取りたい。答え方は `send` と同じ。 */
+ | ({
+    type: "receive";
+} & FileTransferStart)
+/** `ac=file`: 送るファイルの情報、または受け取るパスの頼み。 */
+ | {
+    type: "file";
+    id: string;
+    fileId: string;
+    /** 戻したパス（UTF-8。`~/` はホームからの相対）。coneko-term は検査しない。 */
+    name: string;
+    fileType: FileTransferFileType;
+    compression: "none" | "zlib";
+    transmission: "simple" | "rsync";
+    /** 更新時刻（ナノ秒）。指定なしは `null`。 */
+    mtime: bigint | null;
+    permissions: number | null;
+    size: number | null;
+    parent: string | null;
+}
+/** `ac=data` と `ac=end_data`（`end` が真）。 */
+ | {
+    type: "data";
+    id: string;
+    fileId: string;
+    data: Uint8Array;
+    end: boolean;
+}
+/** `ac=finish`: クライアントがセッションを閉じた。 */
+ | {
+    type: "finish";
+    id: string;
+}
+/** `ac=cancel`: クライアントが取り消した。`replyFileTransferCanceled` で答える。 */
+ | {
+    type: "cancel";
+    id: string;
+};
+/** 受け取りの一覧の 1 項目。 */
+export interface FileTransferListing {
+    /** クライアントの頼み（`file`）の `fileId`。ディレクトリを広げた項目も、頼みと同じ値。 */
+    requestId: string;
+    /** この項目自身の `fid`。 */
+    entryId: string;
+    /** 絶対パス。 */
+    name: string;
+    fileType: FileTransferFileType;
+    mtime?: bigint;
+    permissions?: number;
+    size?: number;
+    /** 入っているディレクトリの `entryId`。 */
+    parent?: string;
+    /** リンクの先（一覧にある先なら、その `entryId` の UTF-8。シンボリックリンクで一覧に無ければ、先のパス）。 */
+    data?: Uint8Array;
+}
+/** カーソルの状態。 */
+export interface CursorState {
+    x: number;
+    y: number;
+    visible: boolean;
+    blinking: boolean;
+    shape: "block" | "underline" | "bar";
+}
+/** 追加のカーソル（位置と形）。 */
+export interface ExtraCursorState {
+    x: number;
+    y: number;
+    shape: "block" | "underline" | "bar";
+}
+/**
+ * 1 行ぶんのセル。`cells` は WASM のメモリの上の見え方で、次に `readRow` などを呼ぶか
+ * 書き込みで画面が変わるまでしか使えない。セルの並びは `CELL_STRIDE` 個ずつ:
+ * 字、幅、前景色、背景色、属性と下線の形、下線の色、複数のセルにまたがる字の印。
+ * 複数のセルにまたがる字のセルは、字が 0、幅が 1。印は、下位 16 ビットが `sized` の番号 + 1
+ * （0 ならそうではない）、ビット 16 から 23 が四角の左上から右へ何セル目か、ビット 24 から 31 が
+ * 下へ何セル目か。
+ */
+export interface RowView {
+    /** セルの数。 */
+    readonly length: number;
+    /** `length * CELL_STRIDE` 個の値。 */
+    readonly cells: Uint32Array;
+    /** 次の行へ折り返されているか。 */
+    readonly wrapped: boolean;
+    /** `CLUSTER_FLAG` つきの字の番号から、書記素を引く。 */
+    cluster(index: number): string;
+    /**
+     * 複数のセルにまたがる字（OSC 66）の四角。番号は、セルの並びの 6 番目の下位 16 ビットから 1 を引いたもの。
+     */
+    sized(index: number): SizedInfo;
+}
+/** 複数のセルにまたがる字（kitty の text sizing、OSC 66）の四角。 */
+export interface SizedInfo {
+    /** 字。 */
+    readonly text: string;
+    /** 四角の幅（セルの数）。 */
+    readonly cols: number;
+    /** 大きさ `s`。四角の高さ（セルの数）でもある。 */
+    readonly scale: number;
+    /** 分数の大きさの分子。 */
+    readonly numerator: number;
+    /** 分数の大きさの分母（0 なら分数の大きさは無い）。 */
+    readonly denominator: number;
+    /** 縦の寄せ方（0 上、1 下、2 中央）。分数の大きさのときだけ効く。 */
+    readonly vertical: number;
+    /** 横の寄せ方（0 左、1 右、2 中央）。分数の大きさのときだけ効く。 */
+    readonly horizontal: number;
+}
+/**
+ * ターミナル。VT のバイト列を `write` で受け、画面の中身を持つ。DOM を使わないので
+ * Node.js でも動く（`open` を呼ぶまで DOM に触らない）。`open` すると Canvas 2D で描く。
+ *
+ * 使う前に `init()` を呼ぶこと。
+ */
+export declare class Terminal {
+    readonly options: Readonly<TerminalOptions>;
+    private resolvedTheme;
+    private renderer?;
+    private scrollbar?;
+    private focused;
+    /** 画面の一番下から何行さかのぼって見ているか。0 なら一番下。 */
+    private viewOffset;
+    private lastScrollback;
+    private scrollListeners;
+    private cellSizeListeners;
+    private wasm;
+    private selectionColor;
+    /** `theme.selectionBackground` で決めた選択範囲の色（プログラムが OSC 21 で変える前の色）。 */
+    private configuredSelection;
+    /** プログラムが OSC で変えた 256 色の表と、カーソルの下の字の色（変えていなければ `undefined`）。`open` の前の変更も、ここに残って最初の描画に入る。 */
+    private colorTable?;
+    private cursorTextColor?;
+    private selection;
+    private selectionListeners;
+    private lastSelectionKey;
+    private lastTrimmed;
+    private lastAlt;
+    /** 押してから離すまで、マウスのイベントを受け持つもの。 */
+    private mouseOwner?;
+    private reportButton;
+    private wheelPartial;
+    /** `dispose` のあとに触ると、分かりやすい例外にする。 */
+    private get core();
+    private queue;
+    private pumping;
+    private disposed;
+    private dataListeners;
+    private titleListeners;
+    private bellListeners;
+    private notificationListeners;
+    private notificationCloseListeners;
+    private notificationQueryListeners;
+    private notificationAliveListeners;
+    private clipboardWriteListeners;
+    private clipboardReadListeners;
+    private dndListeners;
+    private fileTransferListeners;
+    private programStatusListeners;
+    private oscHandlers;
+    private element?;
+    private cleanups;
+    private textarea?;
+    private composition?;
+    private customKeyHandler?;
+    private decoder;
+    private encoder;
+    constructor(options?: TerminalOptions);
+    private selectionHost;
+    private get wordSeparator();
+    private applyTheme;
+    private get fontFamily();
+    private get fontSize();
+    /** 列の数。 */
+    get cols(): number;
+    /** 行の数。 */
+    get rows(): number;
+    /** スクロールバックに入っている行の数。 */
+    get scrollbackLength(): number;
+    /** カーソルの状態。 */
+    get cursor(): CursorState;
+    /**
+     * 追加のカーソル（kitty の multiple cursors protocol）。上の行から、左の列の順。
+     * `shape` は、主のカーソルに従うものも、いまの主のカーソルの形にしてある。
+     */
+    get extraCursors(): ExtraCursorState[];
+    /** 追加のカーソルの `[x, y, 形]` の並び（描画が使う。形は 3 が主のカーソルに従う）。 */
+    readExtraCursors(): Uint32Array;
+    /** 追加のカーソルの色の語 `[字の色, カーソルの色]`（描画が使う。上位 8 ビットが 0 主のカーソルと同じ、1 パレット、2 RGB、3 反転）。 */
+    readExtraCursorColors(): Uint32Array;
+    /** 代替画面にいるか。 */
+    get isAlternateScreen(): boolean;
+    /** bracketed paste（2004）が有効か。`paste` が使う。 */
+    get bracketedPaste(): boolean;
+    /**
+     * kitty keyboard protocol のいまのフラグ（アプリが `CSI > u` などで決める）。
+     * ビットは 1 disambiguate、2 report event types、4 report alternate keys、
+     * 8 report all keys as escape codes、16 report associated text。
+     */
+    get keyboardFlags(): number;
+    /** アプリケーションカーソルキー（DECCKM）か。矢印・Home・End の送り方が変わる。 */
+    get applicationCursorKeys(): boolean;
+    /**
+     * データを書く。文字列は UTF-8 にする。大きなデータは小分けにして処理し、間でブラウザーに
+     * 制御を返す。処理は呼んだ順に行い、このデータを処理し終えたら `done` を呼ぶ。
+     * `write` から戻った時点では、まだ画面に反映されていない。
+     */
+    write(data: string | Uint8Array, done?: () => void): void;
+    private pump;
+    private guard;
+    /**
+     * プログラムが OSC 4・10・11・12・21 などで色を変えていたら、描画の色の表を作り直す。
+     * 選択範囲の背景は、字が見えるように設定済みの色と同じ透明度（`4d`）にする。
+     */
+    private syncColors;
+    /** PTY へ送るバイト列とイベントを、聞き手に渡す。 */
+    private flush;
+    /**
+     * キーボードやマウスなどの入力を、返事と同じ出口（`onData`）から出す。
+     * 文字列は UTF-8 にする。
+     */
+    input(data: string | Uint8Array): void;
+    /**
+     * ユーザーの入力（キー・変換の確定・貼り付け）を出口から出す。`scrollOnUserInput` が false でなく、
+     * さかのぼって見ていたら、一番下へ戻す。
+     */
+    private sendUserInput;
+    /**
+     * 貼り付ける。改行は `\r` にそろえ（xterm.js と同じ）、bracketed paste（2004）が有効なら
+     * `ESC [200~` と `ESC [201~` で囲んで、出口から出す。`paste` イベントも、これを呼ぶ。
+     */
+    paste(text: string): void;
+    /**
+     * キーのイベントを、ターミナルより先に見るハンドラー（xterm.js の `attachCustomKeyEventHandler`）。
+     * `false` を返したキーは、ターミナルが処理しない。外すには `undefined`。
+     */
+    attachCustomKeyEventHandler(handler: ((ev: KeyboardEvent) => boolean) | undefined): void;
+    /**
+     * PTY へ送るバイト列の出口。問い合わせへの返事（DSR など）と、`input` に渡したものが出る。
+     * 渡す `Uint8Array` は聞き手のもの（コピー済み）。
+     */
+    onData(listener: (data: Uint8Array) => void): Disposable;
+    /** 題名が変わった（OSC 0、OSC 2）。 */
+    onTitleChange(listener: (title: string) => void): Disposable;
+    /** BEL が来た。 */
+    onBell(listener: () => void): Disposable;
+    /**
+     * 通知（kitty の desktop notifications、OSC 99）がそろった。分けて送られた通知は、
+     * そろった時点で 1 回だけ呼ぶ。OS の通知を出すのは呼ぶ側。聞き手がいなければ何もしない。
+     */
+    onNotification(listener: (n: TerminalNotification) => void): Disposable;
+    /**
+     * プログラムが自分の状態（kitty の Program Status Protocol、OSC 7501）を報告し、記録が変わった、または
+     * 消えた。何をどう見せるかは呼ぶ側が決める。消えるのは、`state=clear`、RIS、新しいシェルのプロンプト
+     * （OSC 133 の `A`。working・blocked・idle）、窓がフォーカスを得たこととキーを押したこと（done・error）、
+     * 記録の数の上限（256）のとき。プロセスの終了は端末の外のことなので、`programStatusProcessExited` で知らせる。
+     */
+    onProgramStatus(listener: (c: ProgramStatusChange) => void): Disposable;
+    /** いま持っている状態の記録。更新が古い順。 */
+    get programStatus(): ProgramStatus[];
+    /** 端末につないだプロセスが終わったことを知らせる。動いている・待っている状態の記録（working・blocked・idle）を消す。 */
+    programStatusProcessExited(): void;
+    /** アプリケーションが通知を閉じるよう求めた（`p=close`）。`id` は `i`。 */
+    onNotificationClose(listener: (id: string) => void): Disposable;
+    /**
+     * アプリケーションが対応を尋ねた（`p=?`）。`replyNotificationQuery` で答える。
+     * `id` は `i`（無ければ空文字列）。
+     */
+    onNotificationQuery(listener: (id: string) => void): Disposable;
+    /**
+     * アプリケーションが生きている通知を尋ねた（`p=alive`）。`replyNotificationAlive` で答える。
+     */
+    onNotificationAlive(listener: (id: string) => void): Disposable;
+    /**
+     * 通知が押されたことをアプリケーションへ返す（`onData` から出る）。通知の `actions.report` が
+     * 真のときだけ呼ぶ。`button` はボタンを押したときの番号（1 始まり）。`id` が空なら `i=0` で送る（仕様）。
+     */
+    notificationActivated(id: string, button?: number): void;
+    /** 通知が閉じられたことを返す。通知の `reportClose` が真のときだけ呼ぶ。 */
+    notificationClosed(id: string): void;
+    /** `p=?` の問い合わせ（`onNotificationQuery`）に答える。 */
+    replyNotificationQuery(id: string, support?: NotificationSupport): void;
+    /** `p=alive` の問い合わせ（`onNotificationAlive`）に答える。`ids` はまだ生きている通知の `i`。 */
+    replyNotificationAlive(id: string, ids: string[]): void;
+    /**
+     * クリップボードへの書き込み（kitty の clipboard protocol、OSC 5522）がそろった。分けて
+     * 送られたデータは、そろった時点で 1 回だけ呼ぶ。OS のクリップボードに書くかどうかは呼ぶ側が決め、
+     * どちらにしても `replyClipboardWrite` で答える。聞き手がいなければ、`EPERM` で答える。
+     */
+    onClipboardWrite(listener: (r: ClipboardWriteRequest) => void): Disposable;
+    /**
+     * クリップボードの読み取りの頼み（OSC 5522 の `type=read`）が来た。読ませるかどうかは呼ぶ側が決め、
+     * `replyClipboardReadTypes`・`replyClipboardReadData`・`replyClipboardReadError` のどれかで答える。
+     * 聞き手がいなければ、`EPERM`（許されない）で答える。
+     */
+    onClipboardRead(listener: (r: ClipboardReadRequest) => void): Disposable;
+    /** 書き込み（`onClipboardWrite`）に答える。`status` の既定は成功（`DONE`）。 */
+    replyClipboardWrite(id: string, status?: ClipboardWriteStatus): void;
+    /** 種類の一覧の頼み（`list` が真）に答える。`mimes` が空なら、データの無い OK と DONE だけを返す。 */
+    replyClipboardReadTypes(id: string, mimes: string[]): void;
+    /**
+     * データの頼みに答える。`items` は、頼まれた種類のうち渡せるもの。空なら、データの無い OK と DONE だけを返す。
+     * 4096 バイトごとのパケットに分けて送る。
+     */
+    replyClipboardReadData(id: string, items: ClipboardItem[]): void;
+    /** 読み取りの頼みを断る・失敗を知らせる。読ませないなら `EPERM`。 */
+    replyClipboardReadError(id: string, error: ClipboardReadError): void;
+    /**
+     * kitty の drag and drop protocol（OSC 72）のイベントを受ける。種類は `DndEvent` を見ること。
+     * OS のドラッグとドロップにつなぐのは呼ぶ側の仕事。聞き手がいないとき、ドロップされたデータの
+     * 頼みには `EPERM` で、ドラッグを始める求めにも `EPERM` で答える。
+     */
+    onDnd(listener: (e: DndEvent) => void): Disposable;
+    /**
+     * kitty の file transfer protocol（OSC 5113）の、クライアントからの命令を受ける。種類は
+     * `FileTransferEvent` を見ること。許すかどうかと、OS のファイルの読み書きは呼ぶ側の仕事で、
+     * `replyFileTransfer*`・`refuseFileTransfer` で答える。聞き手がいないとき、`send` と `receive` には
+     * `EPERM`（断る）で、`cancel` には `CANCELED` で答える。
+     */
+    onFileTransfer(listener: (e: FileTransferEvent) => void): Disposable;
+    /**
+     * 成功の知らせ（`status=OK`）。セッションの始まり（`send`・`receive`）を許すときは `id` だけ。
+     * ディレクトリの受け付けと、`end_data` のあとの完了は `fileId`（完了には `size` に書いたバイト数）。
+     * 受け取りの一覧を並べ終えたら、`name` にホームディレクトリを付ける。`q` に従って省くことがある。
+     */
+    replyFileTransferOk(id: string, opts?: {
+        fileId?: string;
+        size?: number;
+        name?: string;
+    }): void;
+    /** ファイルを受け付けた（`status=STARTED`）。`rsync` は、署名を送れるとき。 */
+    replyFileTransferStarted(id: string, fileId: string, rsync?: boolean): void;
+    /** データを書いた（`status=PROGRESS`）。`written` はここまでに書いたバイト数。 */
+    replyFileTransferProgress(id: string, fileId: string, written: number): void;
+    /** エラーで答える。`fileId` を省くと、セッション全体のエラー。 */
+    replyFileTransferError(id: string, error: FileTransferErrorName, opts?: {
+        fileId?: string;
+        message?: string;
+    }): void;
+    /** セッションの始まりを断る（`EPERM`）。 */
+    refuseFileTransfer(id: string): void;
+    /** 取り消し（`cancel`）に答える（`status=CANCELED`）。 */
+    replyFileTransferCanceled(id: string): void;
+    /** 受け取りの一覧に項目を足す。全部並べたら `replyFileTransferOk(id, { name: ホーム })` で終える。 */
+    replyFileTransferListing(id: string, entry: FileTransferListing): void;
+    /**
+     * 受け取るファイルのデータを送る。4096 バイトごとのパケットに分ける。`end` が真なら最後を
+     * `end_data` にする（`data` が空でも送る）。圧縮や rsync の差分は、作ったバイト列をそのまま渡す。
+     */
+    replyFileTransferData(id: string, fileId: string, data: Uint8Array, end?: boolean): void;
+    /** プログラムがドロップを受け付けると言っているか。偽の間、`dropMove` などは何もしない。 */
+    get dropAccepting(): boolean;
+    /** プログラムが受け付けると言った MIME の種類（空でもよい）。 */
+    get dropAcceptedMimes(): string[];
+    /**
+     * プログラムが渡した機械の ID（ドロップ側）。自分の機械の ID と比べて別の機械なら、
+     * `text/uri-list` の答えに `remote: true` を付ける。知らない版の ID は別の機械として扱う。
+     */
+    get dropMachineId(): string | null;
+    /**
+     * ドラッグが窓の上を動いた。`mimes` はドラッグされているものの MIME の種類。MIME の一覧は、
+     * 最初の移動と変わったときだけ PTY へ付ける。受け付けていないとき・位置が負のときは何もせず、false を返す。
+     */
+    dropMove(location: DndLocation, mimes: string[], allowed?: DndOperations): boolean;
+    /** ドラッグが窓から出た（位置が -1 の移動を送る）。窓の上に無かったときは何もせず、false を返す。 */
+    dropLeave(): boolean;
+    /**
+     * ドロップされた。`mimes` は落とされたものの MIME の種類で、空ではいけない。`fromThisWindow` は、
+     * ドラッグがこの窓から始まったか（真なら、遠くの機械向けのファイルの読み取りを `EPERM` で断る）。
+     */
+    dropDrop(location: DndLocation, mimes: string[], allowed?: DndOperations, fromThisWindow?: boolean): boolean;
+    /**
+     * `dropRequest` に、データで答える。データは全部を一度に渡す。4096 バイトのパケットに分け、
+     * 終わりの空のパケットまで送る。
+     */
+    replyDropData(request: DropRequest, form: DropDataForm, data: Uint8Array): void;
+    /** `dropRequest` に、エラーで答える。`error` は POSIX の記号名。 */
+    replyDropError(request: DropRequest, error: DndErrorName, description?: string): void;
+    /** プログラムがドラッグを始められると言っているか。 */
+    get dragOffersEnabled(): boolean;
+    /** プログラムが渡した機械の ID（ドラッグ側）。 */
+    get dragMachineId(): string | null;
+    /**
+     * ドラッグの身振りを見つけた。プログラムへ位置を送り、続く申し出を 1 回だけ受ける。申し出ていない
+     * とき・ドラッグの途中のときは何もせず、false を返す。
+     */
+    dragGesture(location: DndLocation): boolean;
+    /** `dragStart` に答える: OS のドラッグが始まった。 */
+    dragStarted(): boolean;
+    /**
+     * `dragStart` に失敗で答える、またはドラッグを止める。すでにユーザーが取り消していたら
+     * `EPERM`、画像が大きすぎれば `EFBIG`。ドラッグの状態は捨てる。
+     */
+    dragError(error: DndErrorName, description?: string): boolean;
+    /** ドラッグが受け入れられた。`index` は、相手が欲しがりそうな MIME の種類（0 始まり）。 */
+    dragAccepted(index: number): boolean;
+    /** 相手が行いそうな操作が変わった。null は受け付けない。 */
+    dragAction(operation: DndOperation | null): boolean;
+    /** ドラッグが相手に落とされた。このあと `requestDragData` で、データを頼む。 */
+    dragDropped(): boolean;
+    /** ドラッグが終わった。`canceled` が真ならユーザーが取り消した。ドラッグの状態は捨てる。 */
+    dragFinished(canceled?: boolean): boolean;
+    /** MIME の種類 `index`（0 始まり）のデータをプログラムに頼む。答えは `dragData` か `dragDataError`。 */
+    requestDragData(index: number): boolean;
+    /** 遠くの機械へのドラッグで、`text/uri-list` の `index` 番目（1 始まり）の項目を頼む。答えは `dragEntry`。 */
+    requestDragEntry(index: number): boolean;
+    /**
+     * OSC の番号 `ident` のハンドラーを登録する（xterm.js の `parser.registerOscHandler` に当たる）。
+     * `data` は `OSC ident ;` のあとの文字列（UTF-8）。登録した番号は、ターミナルの内蔵の処理の
+     * 代わりにハンドラーが受ける。同じ番号に複数登録できる。
+     */
+    registerOscHandler(ident: number, handler: (data: string) => void): Disposable;
+    /** 初期状態に戻す。書き込み待ちのデータは捨てる（`done` は呼ばない）。 */
+    reset(): void;
+    /** 大きさを変える。 */
+    resize(cols: number, rows: number): void;
+    /**
+     * 欄（`open` に渡した要素）の大きさに合わせて列と行の数を決め、大きさを変える
+     * （xterm.js の FitAddon の `fit()` と同じ式。スクロールバーの幅を引く）。
+     * 返すのは変えたあとの大きさ。`open` の前や、欄が見えていない（大きさが 0）ときや、
+     * フォントの大きさがまだ測れていないときは、何もせず、いまの大きさを返す。
+     */
+    fit(): {
+        cols: number;
+        rows: number;
+    };
+    /** `fit()` が使う列と行の数を、変えずに出す。 */
+    proposeDimensions(): {
+        cols: number;
+        rows: number;
+    } | undefined;
+    /** フォーカスがあるか（`setFocused` か、要素のフォーカスで決まる）。 */
+    get isFocused(): boolean;
+    /** ウィンドウの代わりに、フォーカスを得た・失ったことを知らせる。 */
+    setFocused(focused: boolean): void;
+    /**
+     * 欄の要素に付ける。canvas・スクロールバー・見えない `textarea`（フォーカスを受ける）を持つ要素を作り、
+     * Canvas 2D で描き始める。字の幅と高さは、フォントを読み終えてから測り直す。
+     * 欄の大きさに合わせるには `fit()` を呼ぶ。
+     */
+    open(host: HTMLElement): void;
+    /**
+     * 見えない `textarea` を置いて、キー・変換・貼り付け・フォーカスを受ける。
+     * 変換中の字は、カーソルの位置に重ねて見せる。
+     */
+    private setupInput;
+    /** 変換中の字を出す位置。さかのぼって見ていて、カーソルが見えないときは `undefined`。 */
+    private compositionAnchor;
+    private createKeyHandler;
+    private bindInputEvents;
+    /** フォントを読み終えてから測り直す（読む前は代わりのフォントの大きさになる）。戻り値は後始末。 */
+    private watchFonts;
+    /** `devicePixelRatio` が変わったら（別のディスプレイへ動かした、ズームした）測り直す。戻り値は後始末。 */
+    private watchDevicePixelRatio;
+    private renderOptions;
+    /** セルの大きさ（CSS ピクセル）。`open` の前は `undefined`。 */
+    get cellSize(): CellSize | undefined;
+    /** セルの大きさが変わった（フォントを読み終えた、`devicePixelRatio` が変わった）。`fit()` を呼び直す目印に使う。 */
+    onCellSizeChange(listener: (size: CellSize) => void): Disposable;
+    /** 実際に使う、さかのぼっている行数。代替画面では常に 0。 */
+    get viewportOffset(): number;
+    /** 一番上に見えている行の番号。0 がスクロールバックの一番古い行で、一番下を見ているときは `scrollbackLength`。 */
+    get viewportY(): number;
+    /** 一番下を見ているか（新しい出力に付いていく状態）。 */
+    get isAtBottom(): boolean;
+    /** `n` 行ぶん動かす。負の数で上（古い方）、正の数で下。 */
+    scrollLines(n: number): void;
+    /** 一番上に見える行を `line`（0 がスクロールバックの一番古い行）にする。 */
+    scrollToLine(line: number): void;
+    /** 一番古い行へ。 */
+    scrollToTop(): void;
+    /** 一番下へ。 */
+    scrollToBottom(): void;
+    /** 表示位置が変わった。引数は新しい `viewportY`。 */
+    onScroll(listener: (viewportY: number) => void): Disposable;
+    private setViewOffset;
+    /** 書き込みでスクロールバックが増えたとき、さかのぼって見ているなら同じ内容を見続ける。 */
+    private syncViewport;
+    /** 描画とスクロールバーに、画面が変わったことを知らせる。 */
+    private afterChange;
+    /**
+     * プログラムが OSC 22（kitty の mouse pointer shapes）で決めた、ポインターの形。CSS の `cursor` の値で、
+     * 決まっていなければ `undefined`。マウスの報告が有効かどうかには関わらない。
+     * `open` した要素の `cursor` には、これが自動で反映される。
+     */
+    get pointerShape(): string | undefined;
+    private syncPointerShape;
+    /** 画面の `y` 行目（表示位置を考えた、いま見えている行）のセル。 */
+    readViewportRow(y: number): RowView;
+    /** 欄の要素。 */
+    private host?;
+    /** `open` で作った要素。`open` の前は `undefined`。 */
+    get hostElement(): HTMLElement | undefined;
+    /** 見えない `textarea` にフォーカスを当てる。`open` の前は何もしない。 */
+    focus(): void;
+    /** フォーカスを外す。`open` の前は何もしない。 */
+    blur(): void;
+    /** セルの画素の大きさをコアに教える（`c`・`r` が無い画像の置く大きさを決めるのに使う）。 */
+    private syncCellSize;
+    /** 画像の配置の並び（描画が使う）。`PLACEMENT_STRIDE` 個ずつ。 */
+    readPlacements(): Float64Array;
+    /** 持っている画像の `[ID, 通し番号]` の並び（描画が使う）。 */
+    imageSerials(): Float64Array;
+    /** 画像の情報 `[通し番号, 形式, 圧縮, 幅, 高さ]`（描画が使う）。画像が無ければ空。 */
+    imageInfo(id: number): Float64Array;
+    /** 画像のバイト列（描画が使う）。 */
+    imageData(id: number): Uint8Array;
+    /** 画像のアニメーションの状態 `[コマの数, いまのコマ, 再生の状態（1 止まる、2 待ちながら回す、3 回す）, いまのコマの表示時間（ミリ秒）, 操作の数]`（描画が使う）。画像が無ければ空。 */
+    animationInfo(id: number): Float64Array;
+    /** いまのコマの表示時間が過ぎたと知らせ、次のコマへ進める（描画が使う）。進んだら `true`。 */
+    animationStep(id: number): boolean;
+    /** コマを作る `index` 番目の操作（描画が使う）。並びは `WasmTerminal.frame_op` の説明を参照。 */
+    frameOp(id: number, index: number): Float64Array;
+    /** `frameOp` の「データを置く」操作のバイト列（描画が使う）。 */
+    frameOpData(id: number, index: number): Uint8Array;
+    /** 変わった行（見えている画面の行番号）を返し、「変わった」の印を消す。 */
+    takeDirtyRows(): number[];
+    /** 見えている画面の `y` 行目のセル。 */
+    readRow(y: number): RowView;
+    /** スクロールバックの `i` 行目（0 が一番古い）のセル。 */
+    readScrollbackRow(i: number): RowView;
+    /** 見えている画面の `y` 行目の字（空のセルは空白）。末尾の空白は残す。 */
+    getRowText(y: number): string;
+    private view;
+    /** 選択範囲が変わった（広げた、消えた、書き込みで行がずれた）。 */
+    onSelectionChange(listener: () => void): Disposable;
+    /** 選択があるか。 */
+    hasSelection(): boolean;
+    /**
+     * 選択範囲。位置は、スクロールバックの一番古い行を 0 とした行と列で、`end` は含まない
+     * （代替画面では画面の 0 行目が 0）。選択が無ければ `undefined`。
+     */
+    getSelectionRange(): SelectionRange | undefined;
+    /**
+     * 選択した字。折り返しでつながった行は改行を入れずにつなぎ、行末の空のセルは捨てる。
+     * 選択が無ければ空文字列。
+     */
+    getSelection(): string;
+    /** 全部（スクロールバックも）を選ぶ。 */
+    selectAll(): void;
+    /** 選択を消す。 */
+    clearSelection(): void;
+    /**
+     * 選択した字をクリップボードのデータに入れる（`copy` イベントの `clipboardData` を渡す）。
+     * 選択が無ければ何もせず `false`。`open` した要素は、自分で `copy` イベントを受けて
+     * これを呼ぶ（xterm.js と同じ）ので、ふつうは呼ばなくてよい。
+     */
+    copySelection(data: {
+        setData(format: string, data: string): void;
+    }): boolean;
+    /** 選択範囲が変わっていたら、描き直して、聞き手に知らせる。書き込みのあとにも呼ぶ。 */
+    private syncSelection;
+    /** 表示位置を考えた、いま見えている `y` 行目の選択範囲 `[開始の列, 終わりの列)`（描画が使う）。 */
+    selectionSpan(y: number): [number, number] | undefined;
+    /** マウスの報告が有効か（アプリが `CSI ? 1000 h` などで頼んだ）。 */
+    get mouseReporting(): boolean;
+    /**
+     * ポインターのイベントを渡す。`open` した要素は、自分で DOM のイベントを受けて、これを呼ぶ。
+     *
+     * - マウスの報告が有効なら、押した・離した・動かした（ボタンを押したまま、または何も押さずに。
+     *   モードによる）を PTY へ送るバイト列にして、`onData` の出口から出す。Shift を押して押した
+     *   ときは報告せず、選択になる（xterm.js と同じ）。
+     * - そうでなければ、左ボタンのドラッグで範囲、ダブルクリックで単語、トリプルクリックで行を選ぶ。
+     *   Shift を押してクリックすると、いまの選択を広げる。
+     *
+     * 押してから離すまでは、押したときに決めた側が受け持つ。受け持った（ブラウザーの既定の動きを
+     * 止めてよい）ときは `true`。
+     */
+    handleMouse(ev: MouseInput): boolean;
+    /**
+     * ホイールのイベントを渡す。`open` した要素は、自分で DOM のイベントを受けて、これを呼ぶ。
+     *
+     * - マウスの報告が有効なら、ホイールとして報告する（1 回の `wheel` に 1 つ）。
+     * - 代替画面でマウスの報告が無効なら、動かした行の数だけ上下の矢印キーを送る
+     *   （アプリケーションカーソルキーなら `ESC O A`、そうでなければ `ESC [ A`）。
+     * - 通常の画面なら、表示位置を動かす。
+     *
+     * 縦に回さないとき（`deltaY` が 0 か Shift つき）は何もしない。ブラウザーの既定の動きを
+     * 止めてよいときは `true`。
+     */
+    handleWheel(ev: WheelInput): boolean;
+    /** ホイールが動かす行の数（上が負）。Shift つきは 0。xterm.js の `getLinesScrolled` と同じ式。 */
+    private wheelLines;
+    /** DOM のマウスのイベントを `MouseInput` にする。 */
+    private pointerInput;
+    /** 選択中に画面の外へ出たとき、その向きにスクロールし続ける。`move` を渡し続け、`stop` で止める。 */
+    private autoScroller;
+    /** 押す・動かす・離すを受ける。戻り値は後始末。 */
+    private bindPointer;
+    /** ホイールを受ける。戻り値は後始末。 */
+    private bindWheel;
+    /**
+     * `copy` を受ける。ブラウザーは `copy` を、編集できる要素か選択の始点か `body` に送り、
+     * 欄の要素には送らないことがあるので、document で受けて、フォーカスが欄の中にあるときだけ扱う
+     * （別の入力欄でのコピーは邪魔しない）。戻り値は後始末。
+     */
+    private bindCopy;
+    /** 後始末をする。書き込み待ちのデータは捨てる（`done` は呼ばない）。 */
+    dispose(): void;
+}