buninu-linux 0.13.56 → 0.15.58

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);

package/initramfs/lib/bunterm/raw-protocol.js

@@ -0,0 +1,33 @@
+// Buninu private extension; not a registered Kitty pixel format.
+export const BGRA_FORMAT = 0x42475241;
+export function preferredPixelFormat(display, littleEndian = new Uint8Array(new Uint32Array([1]).buffer)[0] === 1) {
+  if (!littleEndian || display?.bitsPerPixel !== 32) return 'png';
+  const f=display.fields;
+  const channel=(field,offset)=>field?.offset===offset&&field.length===8&&!field.msbRight;
+  const alpha=f?.transp;
+  if(alpha?.length && !channel(alpha,24))return 'png';
+  if(!channel(f?.green,8))return 'png';
+  if(channel(f?.red,16)&&channel(f?.blue,0))return 'bgra';
+  if(channel(f?.red,0)&&channel(f?.blue,16))return 'rgba';
+  return 'png';
+}
+// Only the native renderer advertises these formats; browser jsgotty is unchanged.
+export function bgraParser(Base,display) {
+  return class extends Base {
+    _resolveImageData(control,payload) {
+      const bytes=super._resolveImageData(control,payload);
+      if(Number(control.f)===BGRA_FORMAT){
+        const w=Number(control.s),h=Number(control.v);
+        if(!Number.isInteger(w)||!Number.isInteger(h)||w<1||h<1||w*h>16777216||bytes.length!==w*h*4)
+          throw Error('Invalid BGRA dimensions or byte count');
+      }
+      return bytes;
+    }
+    _parsePacket(packet,cursor) {
+      const result=super._parsePacket(packet,cursor);
+      if(result?.kind==='query'&&Number(result.control.f)===BGRA_FORMAT&&result.responseMessage==='OK')
+        result.responseMessage='OK Buninu1 '+preferredPixelFormat(display);
+      return result;
+    }
+  };
+}