buninu-linux 0.14.57 → 0.16.59

package/initramfs/lib/bunterm/commands.js

@@ -0,0 +1,37 @@
+// Local bunterm commands. Deliberately separate from the child shell.
+export function createCommands({fontSize, setFontSize, copy, paste, switchVT}) {
+  const commands = new Map([
+    ["help", () => "font SIZE / + / - | copy | paste | vt NUMBER | help"],
+    ["font", args => {
+      if (args.length !== 1) throw new Error("Usage: font SIZE / + / -");
+      const size = args[0] === "+" ? fontSize()+1 : args[0] === "-" ? fontSize()-1 : Number(args[0]);
+      setFontSize(size);
+      return `Font: ${fontSize()}`;
+    }],
+    ["copy", async args => {
+      if (args.length) throw new Error("Usage: copy");
+      await copy();
+      return "Copied";
+    }],
+    ["paste", async args => {
+      if (args.length) throw new Error("Usage: paste");
+      await paste();
+      return "Pasted";
+    }],
+    ["vt", async args => {
+      if (args.length !== 1 || !/^[1-9]\d*$/.test(args[0]) || Number(args[0]) > 63) throw new Error("Usage: vt 1..63");
+      await switchVT(Number(args[0]));
+      return "";
+    }],
+  ]);
+  return {
+    commands,
+    async execute(line) {
+      const [name, ...args] = line.trim().split(/\s+/);
+      if (!name) return "";
+      const command = commands.get(name);
+      if (!command) throw new Error(`Unknown command: ${name}; try help`);
+      return await command(args);
+    },
+  };
+}

package/initramfs/lib/bunterm/fps.js

@@ -0,0 +1,38 @@
+// Count newly presented Kitty images, not pointer, menu or counter repaints.
+export function createFpsMeter(now = () => performance.now()) {
+  let enabled = false, seen = new WeakSet(), frames = 0, since = 0, value = 0;
+  return {
+    get enabled() { return enabled; },
+    get value() { return value; },
+    toggle(images = []) {
+      enabled = !enabled;
+      seen = new WeakSet(images.map(({image}) => image)); frames = 0; value = 0; since = now();
+      return enabled;
+    },
+    presented(images) {
+      if (!enabled) return;
+      let fresh = false;
+      for (const {image} of images) {
+        if (!seen.has(image)) { seen.add(image); fresh = true; }
+      }
+      if (fresh) frames++;
+    },
+    sample() {
+      const time = now(), elapsed = time - since;
+      value = enabled && elapsed > 0 ? frames * 1000 / elapsed : 0;
+      frames = 0; since = time;
+      return value;
+    },
+    draw(renderer) {
+      if (!enabled) return;
+      const label = `FPS ${value.toFixed(1)}`;
+      const columns = Math.min(renderer.columns, label.length + 2);
+      const width = columns * renderer.cellWidth;
+      const x = renderer.offsetX + renderer.columns * renderer.cellWidth - width;
+      const y = renderer.offsetY;
+      renderer.canvas.drawRect(renderer.CanvasKit.XYWHRect(x,y,width,renderer.cellHeight),
+        renderer.paintFor([20,25,30]));
+      renderer.drawText(label,x,y,columns,[65,220,230],{align:"center"});
+    },
+  };
+}

package/initramfs/lib/bunterm/images.js

@@ -1,3 +1,4 @@
+import {createRawImage} from '../raw-image.js';
 // /lib/bunterm/images.js — kitty graphics protocol placements on the cell
 // grid.
 //
@@ -15,12 +16,13 @@ const number = (value, fallback = 0) => {
 // Decodes a transferred image into a Skia Image. Format 100 is PNG (or any
 // encoded format Skia knows); 24 and 32 are raw RGB / RGBA. Bun.Image, when
 // present, transcodes encodings Skia cannot read on its own.
-export const decodeImage = async (CanvasKit, image) => {
+export const decodeImage = async (CanvasKit, image, {deferRaw = false} = {}) => {
   // The local parser supplies bytes; retain compatibility with base64 callers.
   const bytes = typeof image.data === "string" ? Buffer.from(image.data, "base64") : image.data;
-  if (image.format === 24 || image.format === 32) {
+  if (image.format === 24 || image.format === 32 || image.format === 0x42475241) {
     const { width, height } = image;
-    if (!width || !height) throw new Error("raw image without dimensions");
+    if (!Number.isInteger(width)||!Number.isInteger(height)||width<1||height<1||width*height>16777216
+      ||bytes.byteLength!==width*height*(image.format===24?3:4)) throw new Error("invalid raw image dimensions or byte count");
     let pixels = bytes;
     if (image.format === 24) {
       pixels = Buffer.alloc(width * height * 4, 255);
@@ -30,9 +32,11 @@ export const decodeImage = async (CanvasKit, image) => {
         pixels[o + 2] = bytes[i + 2];
       }
     }
+    const colorType = image.format === 0x42475241 ? CanvasKit.ColorType.BGRA_8888 : CanvasKit.ColorType.RGBA_8888;
+    if (deferRaw) return createRawImage(CanvasKit, pixels, width, height, colorType);
     const decoded = CanvasKit.MakeImage({
       width, height,
-      colorType: CanvasKit.ColorType.RGBA_8888,
+      colorType: image.format === 0x42475241 ? CanvasKit.ColorType.BGRA_8888 : CanvasKit.ColorType.RGBA_8888,
       alphaType: CanvasKit.AlphaType.Unpremul,
       colorSpace: CanvasKit.ColorSpace.SRGB,
     }, pixels, width * 4);
@@ -57,6 +61,7 @@ export class ImageStore {
     this.imageSources = new Map(); // image id → parser image object
     this.placements = new Map();  // placement key → placement
     this.counter = 0;
+    this.closed = false;
     this.coveredKey = "";
     this.coveredRows = new Set();
   }
@@ -64,7 +69,7 @@ export class ImageStore {
   // Handles one parsed graphic. Returns the control sequence that moves the
   // cursor past a placement (to be written to the terminal), or "".
   async handle(graphic) {
-    if (!graphic) return "";
+    if (this.closed || !graphic) return "";
     if (graphic.kind === "delete") {
       this.remove(graphic.delete);
       return "";
@@ -75,7 +80,8 @@ export class ImageStore {
     const replacesImage = decoded && this.imageSources.get(image.id) !== image;
     if (!decoded || replacesImage) {
       try {
-        const replacement = await decodeImage(this.CanvasKit, image);
+        const replacement = await decodeImage(this.CanvasKit, image, {deferRaw: true});
+        if (this.closed) { replacement.delete(); return ""; }
         if (replacesImage) {
           // Kitty requires retransmitting a non-zero image id to delete the
           // old image and all its placements.  Screen-streaming clients such
@@ -232,6 +238,8 @@ export class ImageStore {
   }
 
   delete() {
+    if (this.closed) return;
+    this.closed = true;
     for (const placement of [...this.placements.values()]) placement.marker?.dispose();
     this.placements.clear();
     for (const image of this.images.values()) image.delete();

package/initramfs/lib/bunterm/input.js

@@ -6,8 +6,9 @@
 // "linux" console sequences for a few keys are rewritten into the xterm
 // forms that programs seeing TERM=xterm-256color expect.
 
-import { closeSync, openSync, read } from "node:fs";
+import { closeSync, openSync, readSync, constants } from "node:fs";
 import { libc, ptr, errno, strerror } from "../dlopen.js";
+import { ConsoleKeys, MediumRawDecoder } from "./keycodes.js";
 
 const TCGETS = 0x5401;
 const TCSETS = 0x5402;
@@ -108,33 +109,75 @@ export const translateKeys = (text, { applicationCursorKeys = false } = {}) => {
 // Opens the keyboard: `device` names a console such as /dev/tty1; without
 // it the process's own stdin is used (it must be a terminal). `onData`
 // receives Buffers. close() restores the previous terminal settings.
-export const openKeyboard = ({ device = null, onData, onError = () => {} }) => {
-  const fd = device ? openSync(device, "r+") : 0;
-  const saved = getTermios(fd);
-  setTermios(fd, rawTermios(saved));
+export const openKeyboard = ({ device = null, onData, onKey = () => {}, onError = () => {} }) => {
+  // Own a nonblocking file description: no outstanding async read can deliver
+  // bytes from the previous keyboard mode after a protocol transition.
+  const fd = openSync(device || "/proc/self/fd/0", constants.O_RDWR | constants.O_NONBLOCK);
+  let saved;
+  try {
+    saved = getTermios(fd);
+    setTermios(fd, rawTermios(saved));
+  } catch (error) {
+    closeSync(fd);
+    throw error;
+  }
+  const originalMode = new Int32Array(1);
+  const canReadMode = libc.symbols.ioctl(fd, 0x4b44, ptr(originalMode)) === 0;
+  let enhanced = false, decoder, keys;
+  const setEnhanced = (enabled) => {
+    if (enabled === enhanced) return;
+    if (!canReadMode) throw new Error("Kitty keyboard needs a Linux virtual console (KDGKBMODE)");
+    const maps = [];
+    if (enabled) {
+      // Unicode keysyms can only be queried while the console is still in
+      // K_UNICODE, before switching to K_MEDIUMRAW.
+      for (let table = 0; table < 4; table++) {
+        maps[table] = [];
+        for (let number = 0; number < 256; number++) {
+          const entry = new Uint8Array([table,number,0,0]);
+          maps[table][number] = libc.symbols.ioctl(fd,0x4b46,ptr(entry)) === 0
+            ? new DataView(entry.buffer).getUint16(2,true) : null;
+        }
+      }
+    }
+    // Discard only console typeahead at the mode boundary, never PTY input.
+    if (libc.symbols.ioctl(fd, 0x540b, 0) === -1) fail("TCFLSH");
+    if (libc.symbols.ioctl(fd, 0x4b45, enabled ? 2 : originalMode[0]) === -1) fail("KDSKBMODE");
+    enhanced = enabled;
+    decoder = new MediumRawDecoder();
+    const leds = new Uint8Array(1);
+    libc.symbols.ioctl(fd, 0x4b64, ptr(leds));
+    keys = new ConsoleKeys({ leds: leds[0], lookup: (table, number) => maps[table]?.[number] });
+  };
   let open = true;
+  let timer;
   const chunk = Buffer.alloc(4096);
   const pump = () => {
     if (!open) return;
-    read(fd, chunk, 0, chunk.length, null, (error, count) => {
-      if (!open) return;
-      if (error) {
-        if (error.code === "EAGAIN") { setTimeout(pump, 10); return; }
-        onError(error);
-        return;
+    try {
+      for (let batch = 0; batch < 16; batch++) {
+        const count = readSync(fd, chunk, 0, chunk.length, null);
+        if (!count) break;
+          if (enhanced) decoder.feed(chunk.subarray(0, count), (code, down) => onKey(keys.event(code, down)));
+          else onData(Buffer.from(chunk.subarray(0, count)));
       }
-      if (count > 0) onData(Buffer.from(chunk.subarray(0, count)));
-      pump();
-    });
+    } catch (error) {
+      if (error.code !== "EAGAIN" && error.code !== "EWOULDBLOCK") { onError(error); return; }
+    }
+    timer = setTimeout(pump, 4);
   };
   pump();
   return {
     fd,
+    setEnhanced,
+    clearHeld() { keys?.held.clear(); },
     close() {
       if (!open) return;
       open = false;
+      clearTimeout(timer);
+      try { setEnhanced(false); } catch (error) { onError(error); }
       try { setTermios(fd, saved); } catch {}
-      if (device) closeSync(fd);
+      closeSync(fd);
     },
   };
 };

package/initramfs/lib/bunterm/keyboard.js

@@ -0,0 +1,62 @@
+import { createRequire } from "node:module";
+import { legacyKey } from "./keycodes.js";
+const { KittyKeyboard } = createRequire(import.meta.url)("./kitty-keyboard.cjs");
+
+// The same protocol engine as jsgotty, with a console-mode notification.
+// Wait for the console to exist before installing handlers/advertising support.
+export function attachKeyboard({term, write, setEnhanced, localInput = () => false,
+  switchVT = () => {}, switchRelative = () => {}, onError = () => {}}) {
+  let keyboard, enhanced = false;
+  const sync = () => {
+    const next = Boolean(keyboard?.flags);
+    if (next === enhanced) return;
+    try {
+      setEnhanced(next);
+      enhanced = next;
+      keyboard.clearHeld(false);
+    } catch (error) {
+      keyboard.reset();
+      onError(error);
+    }
+  };
+  const wrap = name => (id, fn) => term.parser[name](id, params => {
+    const result = fn(params);
+    sync();
+    return result;
+  });
+  keyboard = new KittyKeyboard({
+    parser: {registerCsiHandler:wrap("registerCsiHandler"),registerEscHandler:wrap("registerEscHandler")},
+    buffer:term.buffer,options:term.options,
+    input: text => write(text),
+  });
+  const bufferChange = term.buffer.onBufferChange(sync);
+  const reserved = new Set();
+  return {
+    get flags() { return keyboard.flags; },
+    event(event) {
+      // Mediumraw disables the kernel's console shortcuts. Keep Ctrl-Alt-Fn
+      // available even when a client has requested all keys.
+      if (event.type === "keydown" && event.ctrlKey && event.altKey && /^F([1-9]|1[0-2])$/.test(event.key)) {
+        reserved.add(event.code);
+        if (!event.repeat) switchVT(Number(event.key.slice(1)));
+        return;
+      }
+      if (event.type === "keydown" && event.altKey && !event.ctrlKey && !event.shiftKey && !event.metaKey &&
+          ["ArrowLeft","ArrowRight"].includes(event.key)) {
+        reserved.add(event.code);
+        if (!event.repeat) switchRelative(event.key === "ArrowLeft" ? -1 : 1);
+        return;
+      }
+      if (event.type === "keyup" && reserved.delete(event.code)) return;
+      const text = legacyKey(event, Boolean(term._core?.coreService?.decPrivateModes?.applicationCursorKeys));
+      if (localInput(event, text)) { keyboard.clearHeld(); return; }
+      if (keyboard.handle(event) && text) write(text);
+    },
+    blur() { keyboard.clearHeld(); reserved.clear(); },
+    dispose() {
+      bufferChange.dispose();
+      keyboard.dispose();
+      if (enhanced) setEnhanced(false);
+    },
+  };
+}

package/initramfs/lib/bunterm/keycodes.js

@@ -0,0 +1,104 @@
+// Linux K_MEDIUMRAW -> browser-shaped key events for the shared Kitty encoder.
+// The kernel keymap supplies text; these names identify physical/function keys.
+const keys = {};
+const row = (start, names) => names.split(" ").forEach((name, i) => { keys[start + i] = name; });
+row(1, "Escape Digit1 Digit2 Digit3 Digit4 Digit5 Digit6 Digit7 Digit8 Digit9 Digit0 Minus Equal Backspace Tab");
+row(16, "KeyQ KeyW KeyE KeyR KeyT KeyY KeyU KeyI KeyO KeyP BracketLeft BracketRight Enter ControlLeft");
+row(30, "KeyA KeyS KeyD KeyF KeyG KeyH KeyJ KeyK KeyL Semicolon Quote Backquote ShiftLeft Backslash");
+row(44, "KeyZ KeyX KeyC KeyV KeyB KeyN KeyM Comma Period Slash ShiftRight NumpadMultiply AltLeft Space CapsLock");
+row(59, "F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 NumLock ScrollLock Numpad7 Numpad8 Numpad9 NumpadSubtract Numpad4 Numpad5 Numpad6 NumpadAdd Numpad1 Numpad2 Numpad3 Numpad0 NumpadDecimal");
+row(86, "IntlBackslash F11 F12");
+row(96, "NumpadEnter ControlRight NumpadDivide PrintScreen AltRight");
+row(102, "Home ArrowUp PageUp ArrowLeft ArrowRight End ArrowDown PageDown Insert Delete");
+Object.assign(keys, {113:"AudioVolumeMute",114:"AudioVolumeDown",115:"AudioVolumeUp",
+  117:"NumpadEqual",119:"Pause",121:"NumpadComma",125:"MetaLeft",126:"MetaRight",
+  127:"ContextMenu",163:"MediaTrackNext",164:"MediaPlayPause",165:"MediaTrackPrevious",
+  166:"MediaStop",167:"MediaRecord",168:"MediaRewind",208:"MediaFastForward"});
+row(183, "F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24");
+const special = {NumpadEnter:"Enter",NumpadDivide:"/",NumpadMultiply:"*",NumpadAdd:"+",
+  NumpadSubtract:"-",NumpadDecimal:".",NumpadEqual:"=",NumpadComma:","};
+const navigation = ["Insert","End","ArrowDown","PageDown","ArrowLeft","Clear","ArrowRight","Home","ArrowUp","PageUp"];
+
+// Mediumraw encodes >=128 as prefix (0 or 128), then two 7-bit groups
+// with bit 7 set. Preserve incomplete triples across read() boundaries.
+export class MediumRawDecoder {
+  pending = [];
+  feed(bytes, emit) {
+    for (const byte of bytes) {
+      this.pending.push(byte);
+      const first = this.pending[0];
+      if ((first & 127) !== 0) {
+        emit(first & 127, !(first & 128));
+        this.pending = [];
+      } else if (this.pending.length === 3) {
+        emit(((this.pending[1] & 127) << 7) | (this.pending[2] & 127), !(first & 128));
+        this.pending = [];
+      }
+    }
+  }
+}
+
+export class ConsoleKeys {
+  constructor({ lookup, leds = 0 } = {}) {
+    this.lookup = lookup;
+    this.held = new Set();
+    this.caps = Boolean(leds & 4);
+    this.num = Boolean(leds & 2);
+  }
+  event(number, down) {
+    const repeat = down && this.held.has(number);
+    if (down) this.held.add(number); else this.held.delete(number);
+    if (down && !repeat && number === 58) this.caps = !this.caps;
+    if (down && !repeat && number === 69) this.num = !this.num;
+    const shiftKey = this.held.has(42) || this.held.has(54);
+    const ctrlKey = this.held.has(29) || this.held.has(97);
+    const altKey = this.held.has(56);
+    const altgr = this.held.has(100);
+    const metaKey = this.held.has(125) || this.held.has(126);
+    const code = keys[number] || `LinuxKey${number}`;
+    let key = code.replace(/^(Shift|Control|Alt|Meta)(Left|Right)$/, "$1");
+    if (number === 100) key = "AltGraph";
+    else if (special[code]) key = special[code];
+    else if (/^Numpad\d$/.test(code)) key = this.num !== shiftKey ? code.slice(6) : navigation[Number(code.slice(6))];
+    else if (/^(Key|Digit|Intl)/.test(code) || ["Space","Minus","Equal","BracketLeft","BracketRight",
+      "Backslash","Semicolon","Quote","Backquote","Comma","Period","Slash"].includes(code)) {
+      // Exclude Ctrl/Alt from translation: the encoder needs the character,
+      // not an already-collapsed control byte or an ESC prefix.
+      const table = (shiftKey ? 1 : 0) | (altgr ? 2 : 0);
+      let symbol = this.lookup?.(table, number);
+      if ((symbol >> 8) === 11 && this.caps) symbol = this.lookup?.(table ^ 1, number);
+      const type = symbol >> 8;
+      key = symbol == null ? "Unidentified"
+        : type === 0 || type === 11 ? String.fromCodePoint(symbol & 255)
+        : type >= 16 ? String.fromCodePoint(symbol ^ 0xf000)
+        : type === 4 || type === 13 ? "Dead" : "Unidentified";
+    }
+    return {type:down?"keydown":"keyup",code,key,repeat,shiftKey,ctrlKey,altKey,metaKey,
+      location:/^Numpad/.test(code)?3:/Right$/.test(code)?2:/Left$/.test(code)?1:0,
+      getModifierState: name => name === "CapsLock" ? this.caps : name === "NumLock" ? this.num : name === "AltGraph" && altgr,
+      preventDefault() {}, stopPropagation() {}};
+  }
+}
+
+// Recovery/plain-text path when the negotiated enhancements leave a key in
+// legacy form. Used only in Kitty mode; normal console input stays unchanged.
+export function legacyKey(event, applicationCursorKeys = false) {
+  if (event.type !== "keydown") return "";
+  const { key, ctrlKey, altKey, shiftKey } = event;
+  let text = ({Enter:"\r",Tab:shiftKey?"\x1b[Z":"\t",Backspace:"\x7f",Escape:"\x1b"})[key];
+  const cursor = {ArrowUp:"A",ArrowDown:"B",ArrowRight:"C",ArrowLeft:"D",Home:"H",End:"F"}[key];
+  if (cursor) text = `\x1b${applicationCursorKeys?"O":"["}${cursor}`;
+  const tilde = {Insert:2,Delete:3,PageUp:5,PageDown:6}[key];
+  if (tilde) text = `\x1b[${tilde}~`;
+  if (text === undefined && [...key].length === 1) {
+    text = key;
+    if (ctrlKey) {
+      const n = key.toUpperCase().codePointAt(0);
+      if (n >= 64 && n <= 95) text = String.fromCharCode(n & 31);
+      else if (key === " " || key === "2") text = "\0";
+      else if (key === "/" || key === "?") text = "\x1f";
+      else if (key === "8") text = "\x7f";
+    }
+  }
+  return text === undefined ? "" : (altKey ? "\x1b" : "") + text;
+}

package/initramfs/lib/bunterm/kitty-keyboard.cjs

@@ -0,0 +1,195 @@
+// Vendored from jsgotty 1.2.0, static/js/kitty-keyboard.js (MIT).
+// Keep protocol behavior aligned with the browser terminal.
+// Kitty keyboard transport for the shipped xterm wrapper (no build step).
+// Spec: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+(function (root) {
+  'use strict';
+  // Supported progressive enhancements: disambiguation, event types, all keys.
+  // Do not advertise alternate-layout/text reporting until those are implemented.
+  const SUPPORTED = 1 | 2 | 8;
+  const functional = {
+    Escape:[27,'u'], Enter:[13,'u'], Tab:[9,'u'], Backspace:[127,'u'],
+    Insert:[2,'~'], Delete:[3,'~'], ArrowLeft:[1,'D'], ArrowRight:[1,'C'],
+    ArrowUp:[1,'A'], ArrowDown:[1,'B'], PageUp:[5,'~'], PageDown:[6,'~'],
+    Home:[1,'H'], End:[1,'F'], CapsLock:[57358,'u'], ScrollLock:[57359,'u'],
+    NumLock:[57360,'u'], PrintScreen:[57361,'u'], Pause:[57362,'u'], ContextMenu:[57363,'u'],
+    MediaPlay:[57428,'u'], MediaPause:[57429,'u'], MediaPlayPause:[57430,'u'],
+    MediaStop:[57432,'u'], MediaFastForward:[57433,'u'], MediaRewind:[57434,'u'],
+    MediaTrackNext:[57435,'u'], MediaTrackPrevious:[57436,'u'], MediaRecord:[57437,'u'],
+    AudioVolumeDown:[57438,'u'], AudioVolumeUp:[57439,'u'], AudioVolumeMute:[57440,'u'],
+  };
+  [11,12,13,14,15,17,18,19,20,21,23,24].forEach((n,i) => functional['F'+(i+1)] = [n,'~']);
+  for (let i=13;i<=35;i++) functional['F'+i] = [57376+i-13,'u'];
+  const punctuation = {
+    Backquote:['`','~'], Minus:['-','_'], Equal:['=','+'], BracketLeft:['[','{'],
+    BracketRight:[']','}'], Backslash:['\\','|'], Semicolon:[';',':'], Quote:["'",'"'],
+    Comma:[',','<'], Period:['.','>'], Slash:['/','?'], Space:[' ',' '],
+  };
+  const modifiers = {Shift:[1,57441], Control:[4,57442], Alt:[2,57443], Meta:[8,57444],
+    OS:[8,57444], Super:[8,57444], Hyper:[16,57445], AltGraph:[0,57453]};
+  const has = (object,key) => Object.prototype.hasOwnProperty.call(object,key);
+  const lock = (e,name) => Boolean(e.getModifierState?.(name));
+  function physicalCode(e) {
+    if (e.code && e.code !== 'Unidentified') return e.code;
+    if (e.keyCode>=65 && e.keyCode<=90) return 'Key'+String.fromCharCode(e.keyCode);
+    if (e.keyCode>=48 && e.keyCode<=57) return 'Digit'+String.fromCharCode(e.keyCode);
+    return ({32:'Space',186:'Semicolon',187:'Equal',188:'Comma',189:'Minus',190:'Period',
+      191:'Slash',192:'Backquote',219:'BracketLeft',220:'Backslash',221:'BracketRight',222:'Quote'})[e.keyCode] || '';
+  }
+  function baseCharacter(e, android) {
+    const code=physicalCode(e);
+    // Android's Alt accent conversion must not turn an E/I/N/U shortcut into a dead key.
+    const recover=android && e.altKey && !lock(e,'AltGraph');
+    if (recover || ([...e.key || ''].length===1 && e.key.codePointAt(0)<32)) {
+      if (/^Key[A-Z]$/.test(code)) return code.slice(3).toLowerCase();
+      if (/^Digit[0-9]$/.test(code)) return code.slice(5);
+      if (has(punctuation,code)) return punctuation[code][0];
+    }
+    if ([...e.key || ''].length!==1) return null;
+    if (e.shiftKey) {
+      if (has(punctuation,code) && punctuation[code][1]===e.key) return punctuation[code][0];
+      if (/^Digit[0-9]$/.test(code) && ')!@#$%^&*('[Number(code.slice(5))]===e.key) return code.slice(5);
+    }
+    const lower=e.key.toLowerCase();
+    return [...lower].length===1 ? lower : e.key;
+  }
+  function keyDefinition(e, flags, android) {
+    if (has(modifiers,e.key)) {
+      const [bit,left]=modifiers[e.key];
+      const right=e.location===2 || /Right$/.test(e.code || '');
+      return {number:left+(right && e.key!=='AltGraph'?6:0),suffix:'u',modifier:bit};
+    }
+    if ((flags & 9) && (e.location===3 || /^Numpad/.test(e.code || ''))) {
+      const numpad={NumpadDecimal:57409,NumpadDivide:57410,NumpadMultiply:57411,
+        NumpadSubtract:57412,NumpadAdd:57413,NumpadEnter:57414,NumpadEqual:57415,
+        NumpadComma:57416};
+      const nav={ArrowLeft:57417,ArrowRight:57418,ArrowUp:57419,ArrowDown:57420,
+        PageUp:57421,PageDown:57422,Home:57423,End:57424,Insert:57425,Delete:57426,Clear:57427};
+      const number=has(nav,e.key)?nav[e.key]:/^Numpad[0-9]$/.test(e.code || '')
+        ?57399+Number(e.code.slice(6)):numpad[e.code];
+      if (number) return {number,suffix:'u'};
+    }
+    if (has(functional,e.key)) {
+      const [number,suffix]=functional[e.key];
+      return {number,suffix,recovery:['Enter','Tab','Backspace'].includes(e.key)};
+    }
+    const ch=baseCharacter(e,android);
+    return ch===null?null:{number:ch.codePointAt(0),suffix:'u',text:true};
+  }
+  class KittyKeyboard {
+    constructor(term, {android=false}={}) {
+      this.term=term; this.android=android; this.disposables=[];
+      this.metaKeys=new Set(); this.down=new Map(); this.suppressed=new Set(); this.reset();
+      const register=(prefix,fn) => this.disposables.push(term.parser.registerCsiHandler({prefix,final:'u'},p=>{fn(p);return true;}));
+      const value=(p,i,fallback=0) => Number.isInteger(p[i])?p[i]:fallback;
+      register('?',()=>term.input(`\x1b[?${this.flags}u`,false));
+      register('>',p=>{const s=this.state;s.stack.push(s.flags);if(s.stack.length>32)s.stack.shift();s.flags=value(p,0)&SUPPORTED;});
+      register('<',p=>{const s=this.state;let count=Math.min(value(p,0)||1,33);while(count--)s.flags=s.stack.pop()??0;});
+      register('=',p=>{const s=this.state,f=value(p,0)&SUPPORTED,m=value(p,1)||1;if(m===1)s.flags=f;else if(m===2)s.flags|=f;else if(m===3)s.flags&=~f;});
+      this.disposables.push(term.parser.registerEscHandler({final:'c'},()=>{this.reset();return false;}));
+      this.disposables.push(term.parser.registerCsiHandler({intermediates:'!',final:'p'},()=>{this.reset();return false;}));
+    }
+    get state() { return this.states[this.term.buffer.active.type==='alternate'?'alternate':'normal']; }
+    get flags() { return this.state.flags; }
+    reset() {
+      this.states={normal:{flags:0,stack:[]},alternate:{flags:0,stack:[]}};
+      this.clearHeld(false);
+    }
+    clearHeld(report=true) {
+      // Release keys reported to the client before losing focus, avoiding stuck remote keys.
+      if (report && (this.flags & 2)) for (const key of this.down.values()) {
+        if(key.reported) this.term.input(this.sequence(key.def,0,3),true);
+      }
+      this.metaKeys.clear();this.down.clear();this.suppressed.clear();this.suppressKeypress=false;
+    }
+    attach(element) {
+      const doc=element.ownerDocument, win=doc.defaultView;
+      const blur=()=>this.clearHeld();
+      const visibility=()=>{if(doc.hidden)this.clearHeld();};
+      element.addEventListener('blur',blur);win.addEventListener('blur',blur);
+      doc.addEventListener('visibilitychange',visibility);
+      this.disposables.push({dispose:()=>{element.removeEventListener('blur',blur);win.removeEventListener('blur',blur);doc.removeEventListener('visibilitychange',visibility);}});
+    }
+    dispose() {this.clearHeld(false);for(const d of this.disposables)d.dispose();}
+    sequence(def,bits,type) {
+      const event=(this.flags&2) && type!==1?':'+type:'';
+      const mods=bits+1;
+      if(def.suffix!=='u' && mods===1 && !event)
+        return '\x1b['+(def.number===1?'':def.number)+def.suffix;
+      return `\x1b[${def.number}${mods!==1||event?';'+mods+event:''}${def.suffix}`;
+    }
+    handle(event) {
+      if (!['keydown','keyup','keypress'].includes(event.type)) return true;
+      const identity=physicalCode(event)||event.key;
+      const metaKey=['Meta','OS','Super'].includes(event.key);
+      if(this.android && metaKey) {
+        if(event.type==='keydown')this.metaKeys.add(event.code||String(event.location||0));
+        if(event.type==='keyup')this.metaKeys.delete(event.code||String(event.location||0));
+      }
+      // Patch only this terminal's Android event, preserving the native DOM event.
+      if(this.android && this.metaKeys.size && !event.metaKey) {
+        const original=event.getModifierState?.bind(event);
+        Object.defineProperties(event,{
+          metaKey:{configurable:true,value:true},
+          getModifierState:{configurable:true,value:name=>name==='Meta'||Boolean(original?.(name))},
+        });
+      }
+      if(!this.flags || this.term.options.disableStdin) return true;
+      const consume=()=>{event.preventDefault();event.stopPropagation();return false;};
+      if(event.type==='keypress')return this.suppressKeypress?consume():true;
+      let previous=this.down.get(identity);
+      if(event.type==='keyup') {
+        // Some Android IMEs emit only the release of an Alt dead key. Recover
+        // that chord here too, never falling back to legacy ESC text in Kitty mode.
+        if(!previous && this.android && event.altKey && event.key==='Dead' &&
+           !event.isComposing && !lock(event,'AltGraph') && (this.flags&9)) {
+          const def=keyDefinition(event,this.flags,this.android);
+          if(def) {
+            this.term.input(this.sequence(def,this.bits(event),1),true);
+            previous={def,reported:true};this.suppressed.add(identity);
+          }
+        }
+        this.down.delete(identity);
+        const suppressed=this.suppressed.delete(identity);
+        this.suppressKeypress=false;
+        if(previous?.reported && (this.flags&2)) {
+          let bits=this.bits(event);
+          if(previous.def.modifier && ![...this.down.values()].some(k=>k.def.modifier===previous.def.modifier)) bits &= ~previous.def.modifier;
+          if(metaKey && this.metaKeys.size) bits|=8;
+          this.term.input(this.sequence(previous.def,bits,3),true);
+        }
+        return suppressed?consume():true;
+      }
+      this.suppressKeypress=false;
+      if(event.isComposing || event.keyCode===229 && event.key==='Unidentified')return true;
+      if(event.key==='Dead' && !(this.android && event.altKey && !lock(event,'AltGraph')))return true;
+      const def=keyDefinition(event,this.flags,this.android);
+      if(!def)return true;
+      let bits=this.bits(event);
+      if(def.modifier!==undefined) {
+        if(!(this.flags&8))return true;
+        bits|=def.modifier;
+      }
+      const all=Boolean(this.flags&8);
+      // Enter/Tab/Backspace remain recovery keys unless modified or report-all is requested.
+      if(!all && def.recovery && !(bits&~192))return true;
+      const shortcut=Boolean(bits&62);
+      if(def.text && !all && !(this.flags&1 && shortcut))return true;
+      // With only event reporting requested, leave legacy printable shortcuts untouched.
+      if(def.text && !all && !(this.flags&1))return true;
+      const type=event.repeat?2:1;
+      this.down.set(identity,{def,reported:!(def.recovery && !all)});this.suppressed.add(identity);this.suppressKeypress=true;
+      this.term.input(this.sequence(def,bits,type),true);
+      return consume();
+    }
+    bits(e) {
+      const altgr=lock(e,'AltGraph');
+      return (e.shiftKey?1:0)|(!altgr&&e.altKey?2:0)|(!altgr&&e.ctrlKey?4:0)|
+        (e.metaKey || this.android&&this.metaKeys.size?8:0)|
+        (lock(e,'Hyper')?16:0)|(lock(e,'CapsLock')?64:0)|(lock(e,'NumLock')?128:0);
+    }
+  }
+  const api={KittyKeyboard,SUPPORTED};
+  if(typeof module==='object' && module.exports)module.exports=api;
+  else root.GoTTYKittyKeyboard=api;
+})(globalThis);