buninu-linux 0.14.57 → 0.15.58

package/initramfs/buninu/apps/jsgotty/static/js/gotty.js

@@ -12543,6 +12543,12 @@
 	                toTerminal: (e) => this.term.write(e),
 	                toServer: (e) => this.sendInput(e),
 	              })),
+              (this.kittyKeyboard = new globalThis.GoTTYKittyKeyboard.KittyKeyboard(this.term, {
+                android: /Android/i.test(navigator.userAgent),
+              })),
+              this.term.attachCustomKeyEventHandler((event) =>
+                this.kittyKeyboard.handle(event) && this.handleAndroidAltKey(event),
+              ),
 	              this.setPreferences(t),
 	              (() => {
 	                try {
@@ -12594,12 +12600,73 @@
                     ));
               }),
               this.term.open(e),
+              this.kittyKeyboard.attach(this.term.textarea),
+              this.term.textarea?.addEventListener("blur", () => {
+                this.androidAltDownKeys?.clear();
+              }),
               this.term.focus(),
               this.resizeListener(),
               window.addEventListener("resize", () => {
                 this.resizeListener();
               }));
           }
+          // Android can translate physical Alt shortcuts into accent dead keys.
+          // Resolve printable physical keys before xterm's composition handling.
+          handleAndroidAltKey(event) {
+            if (!/Android/i.test(navigator.userAgent)) return true;
+            let code = event.code;
+            // Some Android IMEs omit code and swallow the dead-key keydown,
+            // but still deliver keyup with a usable legacy keyCode.
+            if (!code) {
+              if (event.keyCode >= 65 && event.keyCode <= 90)
+                code = "Key" + String.fromCharCode(event.keyCode);
+              else if (event.keyCode >= 48 && event.keyCode <= 57)
+                code = "Digit" + String.fromCharCode(event.keyCode);
+              else code = {
+                32: "Space", 186: "Semicolon", 187: "Equal", 188: "Comma",
+                189: "Minus", 190: "Period", 191: "Slash", 192: "Backquote",
+                219: "BracketLeft", 220: "Backslash", 221: "BracketRight", 222: "Quote",
+              }[event.keyCode];
+            }
+            this.androidAltDownKeys ??= new Set();
+            const alreadySent = event.type === "keyup" && this.androidAltDownKeys.delete(code);
+            if (
+              !["keydown", "keypress", "keyup"].includes(event.type) ||
+              !event.altKey || event.ctrlKey || event.metaKey ||
+              event.isComposing || event.getModifierState?.("AltGraph") ||
+              (event.type === "keyup" && event.key !== "Dead")
+            ) return true;
+
+            let character;
+            if (/^Key[A-Z]$/.test(code)) {
+              const letter = code.slice(3);
+              character = event.shiftKey ? letter : letter.toLowerCase();
+            } else if (/^Digit[0-9]$/.test(code)) {
+              const digit = code.slice(5);
+              character = event.shiftKey ? ")!@#$%^&*("[Number(digit)] : digit;
+            } else {
+              const punctuation = {
+                Backquote: ["`", "~"], Minus: ["-", "_"], Equal: ["=", "+"],
+                BracketLeft: ["[", "{"], BracketRight: ["]", "}"],
+                Backslash: ["\\", "|"], Semicolon: [";", ":"], Quote: ["'", '"'],
+                Comma: [",", "<"], Period: [".", ">"], Slash: ["/", "?"],
+                Space: [" ", " "],
+              };
+              character = Object.hasOwn(punctuation, code)
+                ? punctuation[code][event.shiftKey ? 1 : 0]
+                : undefined;
+            }
+            if (character === undefined) return true;
+            event.preventDefault();
+            event.stopPropagation();
+            if (event.type === "keydown") {
+              this.androidAltDownKeys.add(code);
+              this.term.input("\x1b" + character, true);
+            } else if (event.type === "keyup" && !alreadySent) {
+              this.term.input("\x1b" + character, true);
+            }
+            return false;
+          }
           info() {
             return { columns: this.term.cols, rows: this.term.rows };
           }
@@ -12610,6 +12677,7 @@
             return this.message;
           }
           setDisconnected(e) {
+            if (e) this.kittyKeyboard.reset();
             this.disconnected = !!e;
           }
           setReconnectAction(e) {
@@ -12721,9 +12789,11 @@
             this.term.blur();
           }
           reset() {
+            this.kittyKeyboard.reset();
             (this.removeMessage(), this.term.clear());
           }
           close() {
+            this.kittyKeyboard.dispose();
             (window.removeEventListener("resize", this.resizeListener),
               this.term.dispose());
           }
@@ -26746,39 +26816,32 @@
                         case 37:
                           if (e.metaKey) break;
                           a
-                            ? ((o.key = r.C0.ESC + "[1;" + (a + 1) + "D"),
-                              o.key === r.C0.ESC + "[1;3D" &&
-                                (o.key = r.C0.ESC + (i ? "b" : "[1;5D")))
+                            ? (o.key = r.C0.ESC + "[1;" + (a + 1) + "D")
                             : (o.key = t ? r.C0.ESC + "OD" : r.C0.ESC + "[D");
                           break;
                         case 39:
                           if (e.metaKey) break;
                           a
-                            ? ((o.key = r.C0.ESC + "[1;" + (a + 1) + "C"),
-                              o.key === r.C0.ESC + "[1;3C" &&
-                                (o.key = r.C0.ESC + (i ? "f" : "[1;5C")))
+                            ? (o.key = r.C0.ESC + "[1;" + (a + 1) + "C")
                             : (o.key = t ? r.C0.ESC + "OC" : r.C0.ESC + "[C");
                           break;
                         case 38:
                           if (e.metaKey) break;
                           a
-                            ? ((o.key = r.C0.ESC + "[1;" + (a + 1) + "A"),
-                              i ||
-                                o.key !== r.C0.ESC + "[1;3A" ||
-                                (o.key = r.C0.ESC + "[1;5A"))
+                            ? (o.key = r.C0.ESC + "[1;" + (a + 1) + "A")
                             : (o.key = t ? r.C0.ESC + "OA" : r.C0.ESC + "[A");
                           break;
                         case 40:
                           if (e.metaKey) break;
                           a
-                            ? ((o.key = r.C0.ESC + "[1;" + (a + 1) + "B"),
-                              i ||
-                                o.key !== r.C0.ESC + "[1;3B" ||
-                                (o.key = r.C0.ESC + "[1;5B"))
+                            ? (o.key = r.C0.ESC + "[1;" + (a + 1) + "B")
                             : (o.key = t ? r.C0.ESC + "OB" : r.C0.ESC + "[B");
                           break;
                         case 45:
-                          e.shiftKey || e.ctrlKey || (o.key = r.C0.ESC + "[2~");
+                          e.shiftKey || e.ctrlKey ||
+                            (o.key = e.altKey
+                              ? r.C0.ESC + "[2;" + (a + 1) + "~"
+                              : r.C0.ESC + "[2~");
                           break;
                         case 46:
                           o.key = a
@@ -26802,14 +26865,14 @@
                         case 33:
                           e.shiftKey
                             ? (o.type = 2)
-                            : e.ctrlKey
+                            : e.ctrlKey || e.altKey
                               ? (o.key = r.C0.ESC + "[5;" + (a + 1) + "~")
                               : (o.key = r.C0.ESC + "[5~");
                           break;
                         case 34:
                           e.shiftKey
                             ? (o.type = 3)
-                            : e.ctrlKey
+                            : e.ctrlKey || e.altKey
                               ? (o.key = r.C0.ESC + "[6;" + (a + 1) + "~")
                               : (o.key = r.C0.ESC + "[6~");
                           break;
@@ -26927,6 +26990,8 @@
                                     ))
                                   : 56 === e.keyCode
                                     ? (o.key = r.C0.DEL)
+                                    : "/" === e.key
+                                      ? (o.key = r.C0.US)
                                     : 219 === e.keyCode
                                       ? (o.key = r.C0.ESC)
                                       : 220 === e.keyCode

package/initramfs/buninu/apps/jsgotty/static/js/kitty-keyboard.js

@@ -0,0 +1,193 @@
+// 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/buninu/apps/jsgotty/tests/android-alt.test.js

@@ -0,0 +1,115 @@
+const assert = require('node:assert/strict');
+const test = require('node:test');
+const fs = require('node:fs');
+const vm = require('node:vm');
+const path = require('node:path');
+
+// Exercise the shipped bundle's wrapper method, without a DOM or new dependencies.
+const bundle = fs.readFileSync(path.join(__dirname, '../static/js/gotty.js'), 'utf8');
+const start = bundle.indexOf('          handleAndroidAltKey(event) {');
+assert.ok(start >= 0);
+const end = bundle.indexOf('          info() {', start);
+assert.ok(end > start);
+const method = bundle.slice(start, end);
+function setup(userAgent = 'Mozilla/5.0 (Linux; Android 15) AppleWebKit/537.36 wv') {
+  const handler = vm.runInNewContext(`({${method}}).handleAndroidAltKey`, {
+    navigator: { userAgent },
+  });
+  const sent = [];
+  const target = { term: { input: (text, userInput) => sent.push([text, userInput]) } };
+  function dispatch(overrides = {}) {
+    const event = {
+      type: 'keydown', code: 'KeyE', key: 'Dead', keyCode: 69,
+      altKey: true, ctrlKey: false, metaKey: false, shiftKey: false,
+      isComposing: false, getModifierState: () => false,
+      prevented: false, stopped: false,
+      preventDefault() { this.prevented = true; },
+      stopPropagation() { this.stopped = true; },
+      ...overrides,
+    };
+    return { result: handler.call(target, event), event };
+  }
+  return { sent, dispatch };
+}
+
+test('Android accent shortcuts emit one ESC sequence; keypress/keyup do not duplicate it', () => {
+  for (const letter of ['E', 'I', 'N', 'U']) {
+    for (const keyCode of [letter.charCodeAt(0), 229]) {
+      const { sent, dispatch } = setup();
+      const { event, result } = dispatch({ code: `Key${letter}`, keyCode });
+      assert.equal(result, false);
+      assert.equal(event.prevented, true);
+      assert.equal(event.stopped, true);
+      dispatch({ type: 'keypress', code: `Key${letter}`, keyCode });
+      dispatch({ type: 'keyup', code: `Key${letter}`, keyCode });
+      assert.deepEqual(sent, [[`\x1b${letter.toLowerCase()}`, true]]);
+      // No dead-key state is retained in this handler for the next ordinary key.
+      assert.equal(dispatch({ altKey: false, key: 'e' }).result, true);
+      assert.equal(sent.length, 1);
+    }
+  }
+});
+
+test('all printable physical Alt keys bypass dead-key handling, including Shift and repeat', () => {
+  const { sent, dispatch } = setup();
+  for (const [code, shiftKey, expected] of [
+    ['KeyA', false, 'a'], ['KeyE', true, 'E'], ['Digit0', false, '0'],
+    ['Digit1', true, '!'], ['Digit0', true, ')'], ['Quote', false, "'"],
+    ['Backquote', true, '~'], ['Backslash', false, '\\'], ['Space', false, ' '],
+  ]) {
+    dispatch({ code, shiftKey, key: 'Dead' });
+    assert.deepEqual(sent.at(-1), [`\x1b${expected}`, true]);
+  }
+  dispatch({ code: 'KeyE', key: 'é', repeat: true });
+  assert.deepEqual(sent.at(-1), ['\x1be', true]);
+});
+
+test('composition, AltGr, other modifiers, and unmapped keys retain existing handling', () => {
+  for (const overrides of [
+    { isComposing: true, keyCode: 229 }, { getModifierState: key => key === 'AltGraph' },
+    { altKey: false }, { ctrlKey: true }, { metaKey: true },
+    { code: '', keyCode: 229 }, { code: 'ArrowLeft' }, { code: 'Enter' },
+    { code: 'Unidentified', keyCode: 229 }, { code: 'toString' },
+    { type: 'keyup', key: 'e' },
+  ]) {
+    const { sent, dispatch } = setup();
+    const { result, event } = dispatch(overrides);
+    assert.equal(result, true);
+    assert.equal(event.prevented, false);
+    assert.deepEqual(sent, []);
+  }
+});
+
+test('non-Android browsers retain existing Alt/dead-key handling', () => {
+  for (const ua of ['Mozilla/5.0 (X11; Linux x86_64)', 'Mozilla/5.0 (Macintosh)', 'Windows']) {
+    const { sent, dispatch } = setup(ua);
+    assert.equal(dispatch().result, true);
+    assert.deepEqual(sent, []);
+  }
+});
+
+// Replay the actual Android 16 WebView trace: no letter keydown and empty code.
+test('Android keyup-only dead keys use legacy keyCode, and ordinary IME input stays untouched', () => {
+  const { sent, dispatch } = setup();
+  for (const keyCode of [69, 78, 85, 73]) {
+    dispatch({ type: 'keydown', code: '', key: 'Alt', keyCode: 18 });
+    assert.equal(dispatch({ type: 'keyup', code: '', key: 'Dead', keyCode }).result, false);
+    dispatch({ type: 'keyup', code: '', key: 'Alt', keyCode: 18 });
+  }
+  assert.deepEqual(sent, ['e', 'n', 'u', 'i'].map(c => ['\x1b' + c, true]));
+  assert.equal(dispatch({ code: '', key: 'Unidentified', keyCode: 229, altKey: false }).result, true);
+  assert.equal(sent.length, 4);
+});
+
+test('legacy keydown plus dead keyup emits once, even with different code availability', () => {
+  for (const [downCode, upCode] of [['', ''], ['KeyE', ''], ['', 'KeyE']]) {
+    const { sent, dispatch } = setup();
+    dispatch({ code: downCode, keyCode: 69 });
+    dispatch({ type: 'keypress', code: downCode, keyCode: 69 });
+    dispatch({ type: 'keyup', code: upCode, keyCode: 69 });
+    assert.deepEqual(sent, [['\x1be', true]]);
+    // The next keyup-only shortcut must not be suppressed by the preceding press.
+    dispatch({ type: 'keyup', code: '', keyCode: 69 });
+    assert.equal(sent.length, 2);
+  }
+});

package/initramfs/buninu/apps/jsgotty/tests/arrow-modifiers.test.js

@@ -0,0 +1,80 @@
+const assert = require('node:assert/strict');
+const test = require('node:test');
+const fs = require('node:fs');
+const path = require('node:path');
+const vm = require('node:vm');
+
+// Exercise the keyboard encoder shipped in the frontend bundle.
+const bundle = fs.readFileSync(path.join(__dirname, '../static/js/gotty.js'), 'utf8');
+const marker = 't.evaluateKeyboardEvent = function (e, t, i, n) {';
+const start = bundle.indexOf(marker);
+assert.ok(start >= 0);
+const end = bundle.indexOf('\n                  },\n                  482:', start);
+assert.ok(end > start);
+const source = bundle.slice(start + 't.evaluateKeyboardEvent = '.length, end).trim().replace(/;$/, '');
+const evaluate = vm.runInNewContext(`(${source})`, { r: { C0: { ESC: '\x1b', US: '\x1f' } }, s: {} });
+const arrows = [[37, 'D'], [38, 'A'], [39, 'C'], [40, 'B']];
+
+for (const isMac of [false, true]) {
+  test(`arrow modifiers stay distinct (isMac=${isMac})`, () => {
+    for (const [keyCode, suffix] of arrows) {
+      for (const applicationCursorMode of [false, true]) {
+        const sequences = new Set();
+        for (let mask = 0; mask < 8; mask++) {
+          const result = evaluate({
+            keyCode, metaKey: false,
+            shiftKey: Boolean(mask & 1), altKey: Boolean(mask & 2), ctrlKey: Boolean(mask & 4),
+          }, applicationCursorMode, isMac, false);
+          const expected = mask
+            ? `\x1b[1;${mask + 1}${suffix}`
+            : `\x1b${applicationCursorMode ? 'O' : '['}${suffix}`;
+          assert.equal(result.key, expected);
+          sequences.add(result.key);
+        }
+        assert.equal(sequences.size, 8);
+      }
+    }
+  });
+}
+
+test('Alt Insert/PageUp/PageDown keep Alt while preserving existing shortcuts', () => {
+  for (const isMac of [false, true]) {
+    const encode = (keyCode, modifiers = {}) => evaluate({
+      keyCode, shiftKey: false, altKey: false, ctrlKey: false, metaKey: false,
+      ...modifiers,
+    }, false, isMac, false);
+    for (const [keyCode, parameter] of [[45, 2], [33, 5], [34, 6]]) {
+      assert.equal(encode(keyCode).key, `\x1b[${parameter}~`);
+      assert.equal(encode(keyCode, { altKey: true }).key, `\x1b[${parameter};3~`);
+    }
+    for (const [keyCode, parameter, scrollType] of [[33, 5, 2], [34, 6, 3]]) {
+      assert.equal(encode(keyCode, { ctrlKey: true }).key, `\x1b[${parameter};5~`);
+      assert.equal(encode(keyCode, { ctrlKey: true, altKey: true }).key, `\x1b[${parameter};7~`);
+      for (const ctrlKey of [false, true]) {
+        for (const altKey of [false, true]) {
+          const result = encode(keyCode, { shiftKey: true, ctrlKey, altKey });
+          assert.equal(result.type, scrollType);
+          assert.equal(result.key, undefined);
+        }
+      }
+    }
+    for (const modifiers of [
+      { ctrlKey: true }, { shiftKey: true }, { ctrlKey: true, shiftKey: true },
+      { ctrlKey: true, altKey: true }, { shiftKey: true, altKey: true },
+    ]) assert.equal(encode(45, modifiers).key, undefined);
+  }
+});
+
+
+test('Ctrl slash sends US like Ctrl underscore, including alternate layout keyCodes', () => {
+  for (const isMac of [false, true]) {
+    for (const keyCode of [191, 226]) {
+      const result = evaluate({ key: '/', keyCode, ctrlKey: true,
+        shiftKey: false, altKey: false, metaKey: false }, false, isMac, false);
+      assert.equal(result.key, '\x1f');
+    }
+    const plain = evaluate({ key: '/', keyCode: 191, ctrlKey: false,
+      shiftKey: false, altKey: false, metaKey: false }, false, isMac, false);
+    assert.equal(plain.key, '/');
+  }
+});

package/initramfs/buninu/apps/jsgotty/tests/kitty-keyboard-browser.test.js

@@ -0,0 +1,53 @@
+// Opt-in real bundled-xterm integration; no browser/dependency downloads.
+// CHROMIUM_HEADLESS=/path/to/chromium-headless-shell node --test tests/kitty-keyboard-browser.test.js
+const test=require('node:test');
+const assert=require('node:assert/strict');
+const fs=require('node:fs');
+const path=require('node:path');
+const http=require('node:http');
+const {spawn}=require('node:child_process');
+const {once}=require('node:events');
+const WebSocket=require('ws');
+const root=path.join(__dirname,'../static');
+test('shipped xterm parses Kitty modes and delivers one encoded DOM event per key', {skip:!process.env.CHROMIUM_HEADLESS,timeout:60000},async()=>{
+ const bundle=fs.readFileSync(path.join(root,'js/gotty.js'),'utf8').replace('(i.nc = void 0));','(i.nc = void 0)); window.TestGoTTYXterm = i(634).GoTTYXterm;');
+ const server=http.createServer((req,res)=>{
+  if(req.url==='/bundle.js'){res.setHeader('Content-Type','text/javascript');res.end(bundle);}
+  else if(req.url==='/keyboard.js'){res.setHeader('Content-Type','text/javascript');res.end(fs.readFileSync(path.join(root,'js/kitty-keyboard.js')));}
+  else res.end('<!doctype html><div id="fixture" style="width:800px;height:600px"></div><script src="/keyboard.js"></script><script src="/bundle.js"></script><script>window.wrapper=new TestGoTTYXterm(document.getElementById("fixture"));window.sent=[];wrapper.onInput(b=>sent.push(new TextDecoder().decode(b)));wrapper.kittyKeyboard.android=true;</script>');
+ });
+ server.listen(0,'127.0.0.1');await once(server,'listening');
+ const child=spawn(process.env.CHROMIUM_HEADLESS,['--no-sandbox','--disable-gpu','--remote-debugging-port=0','http://127.0.0.1:'+server.address().port],{detached:true,stdio:['ignore','ignore','pipe']});
+ let ws;
+ try{
+  const endpoint=await new Promise((resolve,reject)=>{let log='';const timer=setTimeout(()=>reject(Error('Browser startup timeout: '+log)),15000);child.on('error',reject);child.on('exit',code=>{clearTimeout(timer);reject(Error('Browser exited '+code+': '+log));});child.stderr.on('data',b=>{log+=b;const m=log.match(/DevTools listening on (ws:\/\/[^\s]+)/);if(m){clearTimeout(timer);resolve(m[1]);}});});
+  const u=new URL(endpoint);let tab;
+  for(let i=0;i<50;i++){tab=(await (await fetch('http://'+u.host+'/json/list')).json()).find(x=>x.type==='page');if(tab)break;await new Promise(r=>setTimeout(r,100));}
+  ws=new WebSocket(tab.webSocketDebuggerUrl);await once(ws,'open');let id=0;const pending=new Map();ws.on('message',data=>{const m=JSON.parse(data);if(pending.has(m.id)){const {resolve,reject}=pending.get(m.id);pending.delete(m.id);m.error?reject(m.error):resolve(m.result);}});
+  const call=(method,params)=>new Promise((resolve,reject)=>{pending.set(++id,{resolve,reject});ws.send(JSON.stringify({id,method,params}));});
+  for(let i=0;i<50;i++){const r=await call('Runtime.evaluate',{expression:'Boolean(window.wrapper)',returnByValue:true});if(r.result.value)break;await new Promise(r=>setTimeout(r,100));}
+  const result=await call('Runtime.evaluate',{awaitPromise:true,returnByValue:true,expression:`(async()=>{
+   const term=wrapper.term, kb=wrapper.kittyKeyboard;
+   const write=s=>new Promise(r=>term.write(s,r));
+   const equal=(a,b)=>{if(JSON.stringify(a)!==JSON.stringify(b))throw Error(JSON.stringify({actual:a,expected:b}));};
+   const key=(type,key,code,mods={})=>term.textarea.dispatchEvent(new KeyboardEvent(type,{key,code,bubbles:true,cancelable:true,...mods}));
+   await write('\\x1b[?u');equal(sent.splice(0),['\\x1b[?0u']);
+   // Split escape sequence across writes: only the parser may enable the mode.
+   await write('\\x1b[>');await write('11u');equal(kb.flags,11);
+   key('keydown','Meta','MetaLeft');key('keydown','x','KeyX',{ctrlKey:true,shiftKey:true});
+   key('keypress','x','KeyX',{ctrlKey:true,shiftKey:true});key('keyup','x','KeyX',{ctrlKey:true,shiftKey:true});key('keyup','Meta','MetaLeft');
+   equal(sent.splice(0),['\\x1b[57444;9u','\\x1b[120;14u','\\x1b[120;14:3u','\\x1b[57444;1:3u']);
+   await write('\\x1b[?1049h');equal(kb.flags,0);await write('\\x1b[>1u');equal(kb.flags,1);
+   await write('\\x1b[?1049l');equal(kb.flags,11);
+   await write('\\x1b[<u');equal(kb.flags,0);
+   key('keydown','c','KeyC',{ctrlKey:true,keyCode:67});key('keyup','c','KeyC',{ctrlKey:true,keyCode:67});equal(sent.splice(0),['\\x03']);
+   await write('\\x1b[>11u');await write('\\x1bc');equal(kb.flags,0);
+   await write('\\x1b[?u');equal(sent.splice(0),['\\x1b[?0u']);
+   wrapper.close();return 'ok';
+  })()`});
+  assert.equal(result.exceptionDetails,undefined,JSON.stringify(result.exceptionDetails));assert.equal(result.result.value,'ok');
+ }finally{
+  ws?.close();if(child.pid){try{process.kill(-child.pid,'SIGTERM');}catch{}}
+  server.closeAllConnections();await new Promise(r=>server.close(r));
+ }
+});