coneko-term 0.0.0-stage → 0.1.0

package/dist/keyboard.js

@@ -0,0 +1,278 @@
+// キーを PTY へ送るバイト列にする。xterm.js 6.0.0 の `src/common/input/Keyboard.ts`
+// （`evaluateKeyboardEvent`）と同じ値を返す。xterm.js と同じく `keyCode` で決める。
+import { formatKittyKey, KITTY_DISAMBIGUATE, KITTY_REPORT_ALL_KEYS, KITTY_REPORT_EVENT_TYPES, kittyKeyOf, MOD_ALT, MOD_CTRL, MOD_SHIFT, MOD_SUPER, } from "./kitty-keyboard.js";
+export { KITTY_DISAMBIGUATE, KITTY_REPORT_ALL_KEYS, KITTY_REPORT_ALTERNATE_KEYS, KITTY_REPORT_EVENT_TYPES, KITTY_REPORT_TEXT, } from "./kitty-keyboard.js";
+const ESC = "\x1b";
+// 数字と記号のキーの、そのまま・Shift つきの字
+const KEYCODE_KEY_MAPPINGS = {
+    48: ["0", ")"],
+    49: ["1", "!"],
+    50: ["2", "@"],
+    51: ["3", "#"],
+    52: ["4", "$"],
+    53: ["5", "%"],
+    54: ["6", "^"],
+    55: ["7", "&"],
+    56: ["8", "*"],
+    57: ["9", "("],
+    186: [";", ":"],
+    187: ["=", "+"],
+    188: [",", "<"],
+    189: ["-", "_"],
+    190: [".", ">"],
+    191: ["/", "?"],
+    192: ["`", "~"],
+    219: ["[", "{"],
+    220: ["\\", "|"],
+    221: ["]", "}"],
+    222: ["'", '"'],
+};
+// F1〜F4 は `SS3 P`〜`SS3 S`（修飾キーつきは `CSI 1;m P`〜`S`）、F5〜F12 は `CSI n ~`
+const FUNCTION_KEYS = {
+    112: ["P", true],
+    113: ["Q", true],
+    114: ["R", true],
+    115: ["S", true],
+    116: [15, false],
+    117: [17, false],
+    118: [18, false],
+    119: [19, false],
+    120: [20, false],
+    121: [21, false],
+    122: [23, false],
+    123: [24, false],
+};
+/** 矢印・Home・End。修飾キーが無ければ、アプリケーションカーソルキーで `SS3`、そうでなければ `CSI`。 */
+function cursorKey(letter, modifiers, applicationCursorMode) {
+    if (modifiers)
+        return `${ESC}[1;${modifiers + 1}${letter}`;
+    return applicationCursorMode ? `${ESC}O${letter}` : `${ESC}[${letter}`;
+}
+/**
+ * キーが押された（離された）とき、PTY へ送る文字列を決める。kitty のフラグが 0 なら、
+ * xterm.js 6.0.0 の `evaluateKeyboardEvent` と同じ。
+ *
+ * - `applicationCursorMode`: DECCKM（#5）。矢印・Home・End が `CSI` か `SS3` かを決める。
+ * - `kittyFlags`: kitty keyboard protocol のフラグ（`Terminal.keyboardFlags`）。
+ *   - 1: Esc や、Ctrl・Alt つきの字などを `CSI ... u` で送る。
+ *   - 2: `eventType` を `CSI` の形で送る（繰り返し・離す）。
+ *   - 4: `CSI` の形の字のキーに、Shift をかけた字とベースのレイアウトの字を添える。
+ *   - 8: すべてのキー（字・Enter・Tab・修飾キーだけ…）を `CSI` の形で送る。
+ *   - 16: フラグ 8 のとき、字を作るキーにその字を添える。
+ * - `eventType`: 1 押す、2 繰り返し、3 離す。フラグ 2 が無ければ無視する（繰り返しも押すとして扱う）。
+ *   離すときは、`CSI` の形で送るキーだけ `key` が入る。Enter・Tab・Backspace の離すは、フラグ 8 のときだけ。
+ * - `isMac`: macOS か。Option は `macOptionIsMeta` が false なら字を打つキーとして扱い、ここでは送らない。
+ * - Cmd（`metaKey`）つきのキーをアプリに任せるかどうかは呼ぶ側が決める（`KeyHandler` が送らない）。
+ */
+export function evaluateKeyboardEvent(ev, applicationCursorMode, isMac, macOptionIsMeta, kittyFlags = 0, eventType = 1) {
+    const modifiers = (ev.shiftKey ? MOD_SHIFT : 0) |
+        (ev.altKey ? MOD_ALT : 0) |
+        (ev.ctrlKey ? MOD_CTRL : 0) |
+        (ev.metaKey ? MOD_SUPER : 0);
+    const legacy = () => legacyKeyboardEvent(ev, applicationCursorMode, isMac, macOptionIsMeta, modifiers);
+    const all = (kittyFlags & KITTY_REPORT_ALL_KEYS) !== 0;
+    if (!(kittyFlags & (KITTY_DISAMBIGUATE | KITTY_REPORT_EVENT_TYPES | KITTY_REPORT_ALL_KEYS))) {
+        return legacy();
+    }
+    const et = kittyFlags & KITTY_REPORT_EVENT_TYPES ? eventType : 1;
+    const nothing = () => ({ type: "send", cancel: false, key: undefined });
+    const k = kittyKeyOf(ev, modifiers, kittyFlags, isMac, macOptionIsMeta);
+    if (!k)
+        return et === 3 ? nothing() : legacy();
+    // Enter・Tab・Backspace の離すは、フラグ 8 のときだけ（プログラムが戻さずに終わっても、
+    // シェルで reset と打てるように）
+    if (et === 3 && !all && k.final === "u" && (k.num === 13 || k.num === 9 || k.num === 127)) {
+        return nothing();
+    }
+    if (k.final !== "u") {
+        // 矢印・Home・F5 など。従来は送らないもの（Shift+PageUp のスクロール、Ctrl・Shift+Insert、
+        // Cmd+矢印）は、フラグがあっても送らない
+        const l = legacy();
+        if (l.key === undefined)
+            return et === 3 ? nothing() : l;
+        if (et === 1 && !all && !k.escapedOnPress)
+            return l;
+    }
+    return { type: "send", cancel: true, key: formatKittyKey(k, modifiers, et) };
+}
+function legacyKeyboardEvent(ev, applicationCursorMode, isMac, macOptionIsMeta, modifiers) {
+    const result = { type: "send", cancel: false, key: undefined };
+    switch (ev.keyCode) {
+        case 0: {
+            // iOS の矢印
+            const letter = {
+                UIKeyInputUpArrow: "A",
+                UIKeyInputDownArrow: "B",
+                UIKeyInputRightArrow: "C",
+                UIKeyInputLeftArrow: "D",
+            }[ev.key];
+            if (letter)
+                result.key = cursorKey(letter, 0, applicationCursorMode);
+            break;
+        }
+        case 8:
+            // Backspace: ^H か ^?
+            result.key = ev.ctrlKey ? "\b" : "\x7f";
+            if (ev.altKey)
+                result.key = ESC + result.key;
+            break;
+        case 9:
+            // Tab
+            if (ev.shiftKey) {
+                result.key = `${ESC}[Z`;
+                break;
+            }
+            result.key = "\t";
+            result.cancel = true;
+            break;
+        case 13:
+            // Enter
+            result.key = ev.altKey ? `${ESC}\r` : "\r";
+            result.cancel = true;
+            break;
+        case 27:
+            // Esc
+            result.key = ev.altKey ? ESC + ESC : ESC;
+            result.cancel = true;
+            break;
+        case 37: // 左
+        case 38: // 上
+        case 39: // 右
+        case 40: // 下
+            if (ev.metaKey)
+                break;
+            result.key = cursorKey({ 37: "D", 38: "A", 39: "C", 40: "B" }[ev.keyCode], modifiers, applicationCursorMode);
+            break;
+        case 45:
+            // Insert。Ctrl・Shift つきはコピーと貼り付けに使われることがあるので送らない
+            if (!ev.shiftKey && !ev.ctrlKey)
+                result.key = `${ESC}[2~`;
+            break;
+        case 46:
+            // Delete
+            result.key = modifiers
+                ? `${ESC}[3;${modifiers + 1}~`
+                : `${ESC}[3~`;
+            break;
+        case 36:
+            result.key = cursorKey("H", modifiers, applicationCursorMode);
+            break;
+        case 35:
+            result.key = cursorKey("F", modifiers, applicationCursorMode);
+            break;
+        case 33:
+            if (ev.shiftKey)
+                result.type = "pageUp";
+            else if (ev.ctrlKey)
+                result.key = `${ESC}[5;${modifiers + 1}~`;
+            else
+                result.key = `${ESC}[5~`;
+            break;
+        case 34:
+            if (ev.shiftKey)
+                result.type = "pageDown";
+            else if (ev.ctrlKey)
+                result.key = `${ESC}[6;${modifiers + 1}~`;
+            else
+                result.key = `${ESC}[6~`;
+            break;
+        default: {
+            const fn = FUNCTION_KEYS[ev.keyCode];
+            if (fn) {
+                const [id, ss3] = fn;
+                if (ss3) {
+                    result.key = modifiers
+                        ? `${ESC}[1;${modifiers + 1}${id}`
+                        : `${ESC}O${id}`;
+                }
+                else {
+                    result.key = modifiers
+                        ? `${ESC}[${id};${modifiers + 1}~`
+                        : `${ESC}[${id}~`;
+                }
+                break;
+            }
+            // a-z、空白、記号
+            if (ev.ctrlKey && !ev.shiftKey && !ev.altKey && !ev.metaKey) {
+                if (ev.keyCode >= 65 && ev.keyCode <= 90) {
+                    result.key = String.fromCharCode(ev.keyCode - 64);
+                }
+                else if (ev.keyCode === 32) {
+                    result.key = "\0";
+                }
+                else if (ev.keyCode >= 51 && ev.keyCode <= 55) {
+                    // ESC・FS・GS・RS・US
+                    result.key = String.fromCharCode(ev.keyCode - 51 + 27);
+                }
+                else if (ev.keyCode === 56) {
+                    result.key = "\x7f";
+                }
+                else if (ev.keyCode === 219) {
+                    result.key = ESC;
+                }
+                else if (ev.keyCode === 220) {
+                    result.key = "\x1c";
+                }
+                else if (ev.keyCode === 221) {
+                    result.key = "\x1d";
+                }
+            }
+            else if ((!isMac || macOptionIsMeta) && ev.altKey && !ev.metaKey) {
+                // macOS で macOptionIsMeta が false のときの Option は、字を打つ 3 段目のシフト。
+                // ここでは ESC の前置きにする
+                const mapping = KEYCODE_KEY_MAPPINGS[ev.keyCode];
+                const key = mapping?.[ev.shiftKey ? 1 : 0];
+                if (key) {
+                    result.key = ESC + key;
+                }
+                else if (ev.keyCode >= 65 && ev.keyCode <= 90) {
+                    const code = ev.ctrlKey ? ev.keyCode - 64 : ev.keyCode + 32;
+                    let s = String.fromCharCode(code);
+                    if (ev.shiftKey)
+                        s = s.toUpperCase();
+                    result.key = ESC + s;
+                }
+                else if (ev.keyCode === 32) {
+                    result.key = ESC + (ev.ctrlKey ? "\0" : " ");
+                }
+                else if (ev.key === "Dead" && ev.code.startsWith("Key")) {
+                    // US 配列の Alt+N・E・U などは、変換の途中の字（dead key）になる
+                    // （https://github.com/xtermjs/xterm.js/issues/3725）
+                    let s = ev.code.slice(3, 4);
+                    if (!ev.shiftKey)
+                        s = s.toLowerCase();
+                    result.key = ESC + s;
+                    result.cancel = true;
+                }
+            }
+            else if (isMac && !ev.altKey && !ev.ctrlKey && !ev.shiftKey && ev.metaKey) {
+                // Cmd+A などは送らない（xterm.js はここで「すべて選択」にする。選択は #10）
+            }
+            else if (ev.key &&
+                !ev.ctrlKey &&
+                !ev.altKey &&
+                !ev.metaKey &&
+                ev.keyCode >= 48 &&
+                ev.key.length === 1) {
+                // 1 字になるキーだけ（NumLock や音量などは含めない）
+                result.key = ev.key;
+            }
+            else if (ev.key && ev.ctrlKey) {
+                if (ev.key === "_")
+                    result.key = "\x1f"; // ^_
+                if (ev.key === "@")
+                    result.key = "\0"; // Ctrl+Shift+2
+            }
+            break;
+        }
+    }
+    return result;
+}
+/** 貼り付ける文字の改行を `\r` にそろえる（xterm.js の `prepareTextForTerminal`）。 */
+export function prepareTextForTerminal(text) {
+    return text.replace(/\r?\n/g, "\r");
+}
+/** bracketed paste（2004）が有効なら、`ESC [200~` と `ESC [201~` で囲む（xterm.js の `bracketTextForPaste`）。 */
+export function bracketTextForPaste(text, bracketedPasteMode) {
+    return bracketedPasteMode ? `\x1b[200~${text}\x1b[201~` : text;
+}

package/dist/kitty-keyboard.d.ts

@@ -0,0 +1,55 @@
+import type { KeyEventLike } from "./keyboard.js";
+/** フラグ 1。disambiguate escape codes。 */
+export declare const KITTY_DISAMBIGUATE = 1;
+/** フラグ 2。report event types（押す・繰り返し・離す）。 */
+export declare const KITTY_REPORT_EVENT_TYPES = 2;
+/** フラグ 4。report alternate keys（shift を押したときのキーと、ベースのレイアウトのキー）。 */
+export declare const KITTY_REPORT_ALTERNATE_KEYS = 4;
+/** フラグ 8。report all keys as escape codes。 */
+export declare const KITTY_REPORT_ALL_KEYS = 8;
+/** フラグ 16。report associated text。 */
+export declare const KITTY_REPORT_TEXT = 16;
+/** キーの動き。1 押す、2 繰り返し、3 離す（仕様の event-type の値）。 */
+export type KeyEventType = 1 | 2 | 3;
+/** 修飾キーのビット。modifiers の値は 1 + ビットの和。Shift。 */
+export declare const MOD_SHIFT = 1;
+/** 修飾キーのビット。Alt（Option）。 */
+export declare const MOD_ALT = 2;
+/** 修飾キーのビット。Ctrl。 */
+export declare const MOD_CTRL = 4;
+/** 修飾キーのビット。Super（`metaKey`）。 */
+export declare const MOD_SUPER = 8;
+/** エンコードするキー 1 つ。 */
+export interface KittyKey {
+    /** `u` ならキーの番号（Unicode か、仕様の私用領域の番号）。ほかの終端なら、パラメーターの数。 */
+    num: number;
+    /** 終端。`u`・`~`、または `A B C D H F P Q S`。 */
+    final: string;
+    /**
+     * フラグ 8 が無くても、押したときに `CSI` で送るか。送らない（今までの送り方のまま）キーは
+     * 繰り返し・離すだけを `CSI` で送る。
+     */
+    escapedOnPress: boolean;
+    /** `:` で続ける別のキー（フラグ 4）。例: `:65`、`::99`、`:65:99`。 */
+    alternates?: string;
+    /** 添える字のコードポイント（フラグ 16）。`:` で区切る。 */
+    text?: string;
+}
+/**
+ * このキーイベントを、kitty のどのキーにするか。エンコードしないキーは `undefined`
+ * （従来の送り方に任せる）。`flags` はいまの kitty のフラグ。
+ *
+ * - フラグ 8: すべてのキー（修飾キーだけ・テンキー・Enter・Tab・Backspace・字のキーを含む）。
+ * - フラグ 8 が無い: Esc（フラグ 1）、修飾キーつきの Enter・Tab・Backspace（フラグ 1）、
+ *   Ctrl・Alt・Super つきの字（フラグ 1）、F3（フラグ 1）。矢印・Home・F5 などは押すときは従来のまま
+ *   （`escapedOnPress` が false）で、繰り返し・離すだけがここを通る。
+ */
+export declare function kittyKeyOf(ev: KeyEventLike, modifiers: number, flags: number, isMac: boolean, macOptionIsMeta: boolean): KittyKey | undefined;
+/**
+ * `CSI ... final` を作る。`modifiers` は `MOD_*` の和（0 なら無し）。
+ *
+ * - 修飾キーが無く、押す動きで、字も無ければ、その欄は省く（`CSI 97 u`、`CSI A`）。
+ * - 字だけがあるときは、修飾キーの欄を空にする（`CSI 97 ; ; 97 u`）。
+ * - `A` `B` `C` `D` `H` `F` `P` `Q` `S` は、欄が要るときだけ番号 `1` を付ける（`CSI 1 ; 1:3 A`）。
+ */
+export declare function formatKittyKey(k: KittyKey, modifiers: number, eventType: KeyEventType): string;

package/dist/kitty-keyboard.js

@@ -0,0 +1,332 @@
+// kitty keyboard protocol（https://sw.kovidgoyal.net/kitty/keyboard-protocol/ ）のキーのエンコード。
+// 形は `CSI unicode-key-code:alternate-key-codes ; modifiers:event-type ; text-as-codepoints u`。
+// 矢印・Home・F5 などの「機能キー」は、`u` の代わりに今までの終端（`A`・`~` など）を使う。
+//
+// 呼ぶ側は `keyboard.ts` の `evaluateKeyboardEvent`。ここは「どのキーか」と「どう書くか」だけを決め、
+// 従来の（xterm.js と同じ）バイト列には触らない。
+/** フラグ 1。disambiguate escape codes。 */
+export const KITTY_DISAMBIGUATE = 1;
+/** フラグ 2。report event types（押す・繰り返し・離す）。 */
+export const KITTY_REPORT_EVENT_TYPES = 2;
+/** フラグ 4。report alternate keys（shift を押したときのキーと、ベースのレイアウトのキー）。 */
+export const KITTY_REPORT_ALTERNATE_KEYS = 4;
+/** フラグ 8。report all keys as escape codes。 */
+export const KITTY_REPORT_ALL_KEYS = 8;
+/** フラグ 16。report associated text。 */
+export const KITTY_REPORT_TEXT = 16;
+/** 修飾キーのビット。modifiers の値は 1 + ビットの和。Shift。 */
+export const MOD_SHIFT = 1;
+/** 修飾キーのビット。Alt（Option）。 */
+export const MOD_ALT = 2;
+/** 修飾キーのビット。Ctrl。 */
+export const MOD_CTRL = 4;
+/** 修飾キーのビット。Super（`metaKey`）。 */
+export const MOD_SUPER = 8;
+// ---- 字を打つキー ----
+// `KeyboardEvent.code` から、ベースのレイアウト（PC-101 の US 配列）の字。[そのまま, Shift つき]
+const BASE_LAYOUT = {
+    Minus: ["-", "_"],
+    Equal: ["=", "+"],
+    BracketLeft: ["[", "{"],
+    BracketRight: ["]", "}"],
+    Backslash: ["\\", "|"],
+    Semicolon: [";", ":"],
+    Quote: ["'", '"'],
+    Backquote: ["`", "~"],
+    Comma: [",", "<"],
+    Period: [".", ">"],
+    Slash: ["/", "?"],
+    Space: [" ", " "],
+};
+for (let i = 0; i < 26; i++) {
+    const c = String.fromCharCode(97 + i);
+    BASE_LAYOUT[`Key${c.toUpperCase()}`] = [c, c.toUpperCase()];
+}
+")!@#$%^&*(".split("").forEach((s, i) => {
+    BASE_LAYOUT[`Digit${i}`] = [String(i), s];
+});
+// `code` が空のとき（古いブラウザーやテスト）の代わりに、`keyCode` から `code` を決める
+const CODE_BY_KEYCODE = {
+    32: "Space",
+    186: "Semicolon",
+    187: "Equal",
+    188: "Comma",
+    189: "Minus",
+    190: "Period",
+    191: "Slash",
+    192: "Backquote",
+    219: "BracketLeft",
+    220: "Backslash",
+    221: "BracketRight",
+    222: "Quote",
+};
+function baseLayoutOf(ev) {
+    let code = ev.code;
+    if (!code) {
+        const kc = ev.keyCode;
+        if (kc >= 65 && kc <= 90)
+            code = `Key${String.fromCharCode(kc)}`;
+        else if (kc >= 48 && kc <= 57)
+            code = `Digit${kc - 48}`;
+        else
+            code = CODE_BY_KEYCODE[kc] ?? "";
+    }
+    return BASE_LAYOUT[code];
+}
+/** 印字できる 1 コードポイントならその字。キーの名前（"Enter" など）や制御文字は `undefined`。 */
+function singleChar(key) {
+    if (!key)
+        return undefined;
+    const cps = Array.from(key);
+    if (cps.length !== 1)
+        return undefined;
+    const cp = cps[0].codePointAt(0);
+    return cp < 0x20 || cp === 0x7f ? undefined : cps[0];
+}
+function lowerSingle(s) {
+    const l = s.toLowerCase();
+    return Array.from(l).length === 1 ? l : s;
+}
+function upperSingle(s) {
+    const u = s.toUpperCase();
+    return Array.from(u).length === 1 ? u : s;
+}
+const cp = (s) => s.codePointAt(0);
+/** Shift なしの字。Shift の英字は小文字、記号は US 配列で戻し、戻せなければそのまま。 */
+function unshiftedOf(k, lower, shift, us) {
+    if (!shift)
+        return lower;
+    if (lower !== k)
+        return lower;
+    if (us && us[1] === k)
+        return us[0];
+    return k;
+}
+/**
+ * 字を打つキーの番号と、別のキー。`undefined` なら字を打つキーではない（テンキーも含む。
+ * テンキーは `numpadKey`）。
+ *
+ * 番号は、いまの配列でそのキーが Shift なしで出す字。ブラウザーは Shift をかけた字を `key` に
+ * 入れるので、英字は小文字にし、それ以外は US 配列の対応（`code` から決める）で戻す。US 配列と
+ * 違う配列の記号は戻せないので、`key` そのままになる。
+ */
+function textKey(ev) {
+    if (ev.code.startsWith("Numpad"))
+        return undefined;
+    const shift = ev.shiftKey;
+    const us = baseLayoutOf(ev);
+    // dead key の途中は、合成を止めないように従来の送り方に任せる
+    if (ev.key === "Dead")
+        return undefined;
+    const k = singleChar(ev.key) ?? us?.[shift ? 1 : 0];
+    if (k === undefined)
+        return undefined;
+    const lower = lowerSingle(k);
+    const unshifted = unshiftedOf(k, lower, shift, us);
+    const out = { code: cp(unshifted) };
+    if (shift) {
+        const shifted = k !== unshifted ? k : upperSingle(unshifted);
+        if (shifted !== unshifted)
+            out.shifted = cp(shifted);
+    }
+    if (us && us[0] !== unshifted)
+        out.base = cp(us[0]);
+    return out;
+}
+// 従来のバイト列があるキー（`keyboard.ts` の switch と同じ keyCode）
+const LEGACY_FUNCTIONAL = {
+    37: { num: 1, final: "D" },
+    38: { num: 1, final: "A" },
+    39: { num: 1, final: "C" },
+    40: { num: 1, final: "B" },
+    36: { num: 1, final: "H" },
+    35: { num: 1, final: "F" },
+    45: { num: 2, final: "~" },
+    46: { num: 3, final: "~" },
+    33: { num: 5, final: "~" },
+    34: { num: 6, final: "~" },
+    112: { num: 1, final: "P" },
+    113: { num: 1, final: "Q" },
+    // F3 の `CSI R` はカーソル位置の報告とぶつかるので `CSI 13 ~`
+    114: { num: 13, final: "~" },
+    115: { num: 1, final: "S" },
+    116: { num: 15, final: "~" },
+    117: { num: 17, final: "~" },
+    118: { num: 18, final: "~" },
+    119: { num: 19, final: "~" },
+    120: { num: 20, final: "~" },
+    121: { num: 21, final: "~" },
+    122: { num: 23, final: "~" },
+    123: { num: 24, final: "~" },
+};
+// 従来のバイト列が無いキー（フラグ 8 のときだけ送る）。keyCode から
+const EXTRA_BY_KEYCODE = {
+    20: 57358, // Caps Lock
+    145: 57359, // Scroll Lock
+    144: 57360, // Num Lock
+    44: 57361, // Print Screen
+    19: 57362, // Pause
+    93: 57363, // Menu
+};
+for (let n = 13; n <= 24; n++)
+    EXTRA_BY_KEYCODE[124 + n - 13] = 57376 + n - 13; // F13〜F24
+// 修飾キーそのもの。`code` から
+const MODIFIER_BY_CODE = {
+    ShiftLeft: 57441,
+    ControlLeft: 57442,
+    AltLeft: 57443,
+    MetaLeft: 57444,
+    OSLeft: 57444,
+    ShiftRight: 57447,
+    ControlRight: 57448,
+    AltRight: 57449,
+    MetaRight: 57450,
+    OSRight: 57450,
+    ContextMenu: 57363,
+};
+// `code` が空のときの代わり（左側として扱う）
+const MODIFIER_BY_KEYCODE = {
+    16: 57441,
+    17: 57442,
+    18: 57443,
+    91: 57444,
+    224: 57444,
+    92: 57450,
+};
+// テンキー。`code` から
+const NUMPAD_BY_CODE = {
+    NumpadDecimal: 57409,
+    NumpadDivide: 57410,
+    NumpadMultiply: 57411,
+    NumpadSubtract: 57412,
+    NumpadAdd: 57413,
+    NumpadEnter: 57414,
+    NumpadEqual: 57415,
+    NumpadComma: 57416,
+};
+// NumLock が切れているとき、テンキーは矢印などの keyCode になる
+const NUMPAD_NAV_BY_KEYCODE = {
+    37: 57417,
+    39: 57418,
+    38: 57419,
+    40: 57420,
+    33: 57421,
+    34: 57422,
+    36: 57423,
+    35: 57424,
+    45: 57425,
+    46: 57426,
+    12: 57427, // 5（NumLock なし）
+};
+function numpadKey(ev) {
+    if (!ev.code.startsWith("Numpad"))
+        return undefined;
+    if (ev.code === "NumpadEnter")
+        return NUMPAD_BY_CODE.NumpadEnter;
+    const nav = NUMPAD_NAV_BY_KEYCODE[ev.keyCode];
+    if (nav !== undefined)
+        return nav;
+    const digit = /^Numpad(\d)$/.exec(ev.code);
+    if (digit)
+        return 57399 + Number(digit[1]);
+    return NUMPAD_BY_CODE[ev.code];
+}
+function pressKey(num, final = "u", escapedOnPress = true) {
+    return { num, final, escapedOnPress };
+}
+/**
+ * このキーイベントを、kitty のどのキーにするか。エンコードしないキーは `undefined`
+ * （従来の送り方に任せる）。`flags` はいまの kitty のフラグ。
+ *
+ * - フラグ 8: すべてのキー（修飾キーだけ・テンキー・Enter・Tab・Backspace・字のキーを含む）。
+ * - フラグ 8 が無い: Esc（フラグ 1）、修飾キーつきの Enter・Tab・Backspace（フラグ 1）、
+ *   Ctrl・Alt・Super つきの字（フラグ 1）、F3（フラグ 1）。矢印・Home・F5 などは押すときは従来のまま
+ *   （`escapedOnPress` が false）で、繰り返し・離すだけがここを通る。
+ */
+export function kittyKeyOf(ev, modifiers, flags, isMac, macOptionIsMeta) {
+    const all = (flags & KITTY_REPORT_ALL_KEYS) !== 0;
+    const disambiguate = all || (flags & KITTY_DISAMBIGUATE) !== 0;
+    const withText = (flags & KITTY_REPORT_TEXT) !== 0;
+    const withAlternates = (flags & KITTY_REPORT_ALTERNATE_KEYS) !== 0;
+    // 修飾キーそのもの・ロックキーなど（フラグ 8 のときだけ）
+    if (all) {
+        const mod = MODIFIER_BY_CODE[ev.code] ?? (ev.code ? undefined : MODIFIER_BY_KEYCODE[ev.keyCode]);
+        if (mod !== undefined)
+            return pressKey(ev.key === "AltGraph" ? 57453 : mod);
+        if (ev.key === "AltGraph")
+            return pressKey(57453);
+        const extra = EXTRA_BY_KEYCODE[ev.keyCode];
+        if (extra !== undefined)
+            return pressKey(extra);
+        const kp = numpadKey(ev);
+        if (kp !== undefined) {
+            const k = pressKey(kp);
+            const ch = singleChar(ev.key);
+            if (withText && ch !== undefined && !(modifiers & (MOD_CTRL | MOD_ALT | MOD_SUPER))) {
+                k.text = String(cp(ch));
+            }
+            return k;
+        }
+    }
+    switch (ev.keyCode) {
+        case 27:
+            return disambiguate ? pressKey(27) : undefined;
+        case 8:
+            return all || (disambiguate && modifiers) ? pressKey(127) : undefined;
+        case 9:
+            return all || (disambiguate && modifiers) ? pressKey(9) : undefined;
+        case 13:
+            return all || (disambiguate && modifiers) ? pressKey(13) : undefined;
+    }
+    const fn = LEGACY_FUNCTIONAL[ev.keyCode];
+    if (fn) {
+        // F3 は フラグ 1 以上なら `CSI 13 ~` で送る。ほかは今までのまま
+        return pressKey(fn.num, fn.final, all || (disambiguate && ev.keyCode === 114));
+    }
+    // 字を打つキー
+    if (!all && !(disambiguate && modifiers & (MOD_ALT | MOD_CTRL | MOD_SUPER)))
+        return undefined;
+    // macOS の Option（macOptionIsMeta が false）は字を打つキー。Windows の AltGr は呼ぶ側が除く
+    if (isMac && !macOptionIsMeta && ev.altKey && !ev.ctrlKey && !ev.metaKey)
+        return undefined;
+    const tk = textKey(ev);
+    if (!tk)
+        return undefined;
+    // どのキーか分からない字だけのイベント（keyCode 0 で code が空）は、仕様どおり番号 0
+    const k = pressKey(ev.code === "" && ev.keyCode === 0 ? 0 : tk.code);
+    if (withAlternates && (tk.shifted !== undefined || tk.base !== undefined)) {
+        k.alternates = `:${tk.shifted ?? ""}${tk.base !== undefined ? `:${tk.base}` : ""}`;
+    }
+    // 字を添えるのは、修飾キーが字を作るのを邪魔していない（Shift だけ）ときの、押す・繰り返し
+    if (withText && !(modifiers & (MOD_ALT | MOD_CTRL | MOD_SUPER))) {
+        const ch = singleChar(ev.key);
+        if (ch !== undefined)
+            k.text = String(cp(ch));
+    }
+    return k;
+}
+/**
+ * `CSI ... final` を作る。`modifiers` は `MOD_*` の和（0 なら無し）。
+ *
+ * - 修飾キーが無く、押す動きで、字も無ければ、その欄は省く（`CSI 97 u`、`CSI A`）。
+ * - 字だけがあるときは、修飾キーの欄を空にする（`CSI 97 ; ; 97 u`）。
+ * - `A` `B` `C` `D` `H` `F` `P` `Q` `S` は、欄が要るときだけ番号 `1` を付ける（`CSI 1 ; 1:3 A`）。
+ */
+export function formatKittyKey(k, modifiers, eventType) {
+    const text = eventType !== 3 ? k.text : undefined;
+    const modField = modifiers || eventType !== 1
+        ? `${modifiers + 1}${eventType !== 1 ? `:${eventType}` : ""}`
+        : "";
+    const needsField = modField !== "" || text !== undefined;
+    let code;
+    if (k.final === "u" || k.final === "~")
+        code = `${k.num}${k.alternates ?? ""}`;
+    else
+        code = needsField ? String(k.num) : "";
+    let params = code;
+    if (needsField)
+        params += `;${modField}`;
+    if (text !== undefined)
+        params += `;${text}`;
+    return `\x1b[${params}${k.final}`;
+}

package/dist/memory.d.ts

@@ -0,0 +1,4 @@
+/** `init()` が WASM のメモリを渡す。 */
+export declare function setMemory(m: WebAssembly.Memory): void;
+/** WASM のメモリ。`init()` の前は例外。 */
+export declare function getMemory(): WebAssembly.Memory;

package/dist/memory.js

@@ -0,0 +1,12 @@
+let memory;
+/** `init()` が WASM のメモリを渡す。 */
+export function setMemory(m) {
+    memory = m;
+}
+/** WASM のメモリ。`init()` の前は例外。 */
+export function getMemory() {
+    if (memory === undefined) {
+        throw new Error("coneko-term: call init() before using Terminal");
+    }
+    return memory;
+}