buninu-linux 0.14.57 → 0.15.58

package/test/bunterm-vt-menu.test.js

@@ -0,0 +1,178 @@
+import { test, expect } from "bun:test";
+import { createVtMenu } from "../initramfs/lib/bunterm/vt-menu.js";
+import { createCommands } from "../initramfs/lib/bunterm/commands.js";
+const report = (x, y, pressed = [], released = []) => ({ x, y, pressed, released, buttons: {left: pressed.includes("left")}, wheel: 0, moved: false });
+function fixture(extra = {}) {
+  const selected = [];
+  const menu = createVtMenu({ width: 800, height: 600, rowHeight: 16,
+    list: () => [{number:1,label:"initial"}, {number:3,label:"bunterm"}],
+    select: n => selected.push(n), changed() {}, ...extra });
+  return {menu, selected};
+}
+test("new bunterm is below the tty list, inherits live font size, and prevents double launch", async () => {
+  let size=13, finish; const calls=[];
+  const {menu,selected}=fixture({controls:{fontSize:()=>size,execute:()=>""},
+    create:n=>{calls.push(n);return new Promise(resolve=>{finish=resolve;});}});
+  menu.pointer(report(0,0,["left"]));
+  const labels=[];
+  menu.draw({cellWidth:8,cellHeight:16,CanvasKit:{XYWHRect:(...r)=>r,ClipOp:{Intersect:0}},
+    paintFor:c=>c,drawText:text=>labels.push(text),
+    canvas:{save(){},restore(){},clipRect(){},drawRect(){}}});
+  expect(labels.indexOf("+ 新增 bunterm / New bunterm")).toBe(labels.indexOf("bunterm",2)+1);
+  size=20;
+  menu.input(Buffer.from("\x1b[B".repeat(5)+"\r\r"));
+  await Bun.sleep(0);
+  expect(calls).toEqual([20]);expect(selected).toEqual([]);
+  finish();await Bun.sleep(0);expect(menu.visible).toBe(false);
+});
+
+test("failed new bunterm launch keeps the menu usable", async () => {
+  const {menu}=fixture({controls:{fontSize:()=>13,execute:()=>""},create:()=>{throw Error("No next tty available");}});
+  menu.pointer(report(0,0,["left"]));
+  menu.input(Buffer.from("\x1b[B".repeat(5)+"\r"));
+  await Bun.sleep(0);expect(menu.visible).toBe(true);
+  const labels=[];
+  menu.draw({cellWidth:8,cellHeight:16,CanvasKit:{XYWHRect:(...r)=>r,ClipOp:{Intersect:0}},
+    paintFor:c=>c,drawText:text=>labels.push(text),
+    canvas:{save(){},restore(){},clipRect(){},drawRect(){}}});
+  expect(labels).toContain("No next tty available");
+  menu.input(Buffer.from("\x1b"));expect(menu.visible).toBe(false);
+});
+test("only the top-left four pixels open the menu; open and selection clicks never leak", () => {
+  const {menu,selected} = fixture();
+  expect(menu.pointer(report(2,1,["left"]))).toBe(false);
+  expect(menu.pointer(report(1,2,["left"]))).toBe(false);
+  expect(menu.pointer(report(1,1,["right"]))).toBe(false);
+  expect(menu.pointer(report(1,1,["left"]))).toBe(true);
+  expect(menu.visible).toBe(true);
+  expect(menu.pointer(report(1,1,[],["left"]))).toBe(true);
+  expect(menu.pointer(report(20,55,["left"]))).toBe(true);
+  expect(selected).toEqual([3]);
+  expect(menu.visible).toBe(false);
+  expect(menu.pointer(report(20,55,[],["left"]))).toBe(true);
+  expect(menu.pointer(report(30,60))).toBe(false);
+});
+test("menu consumes application input, supports keyboard selection and dismissal", () => {
+  const {menu,selected} = fixture();
+  menu.pointer(report(0,0,["left"]));
+  expect(menu.input(Buffer.from("shell command"))).toBe(true);
+  menu.input(Buffer.from("\x1b[B"));
+  menu.input(Buffer.from("\r"));
+  expect(selected).toEqual([3]);
+  menu.pointer(report(0,0,[],["left"]));
+  menu.pointer(report(0,0,["left"]));
+  menu.input(Buffer.from("\x1b"));
+  expect(menu.visible).toBe(false);
+  expect(menu.input(Buffer.from("x"))).toBe(false);
+});
+test("short screens scroll selection; renderer overlays are clipped", () => {
+  const {menu,selected} = fixture({height:72});
+  menu.pointer(report(0,0,["left"]));
+  menu.pointer({...report(10,10), wheel:-1});
+  const text=[];
+  menu.draw({cellWidth:8, cellHeight:16, CanvasKit:{XYWHRect:(...r)=>r,ClipOp:{Intersect:0}},
+    paintFor: c=>c, drawText: t=>text.push(t),
+    canvas:{save(){},restore(){},clipRect(){},drawRect(){}}});
+  expect(text).toContain("bunterm");
+  expect(text).not.toContain("initial");
+  menu.input(Buffer.from("\r"));
+  expect(selected).toEqual([3]);
+});
+test("outside click dismisses without selecting or leaking its release", () => {
+  const {menu,selected} = fixture();
+  menu.pointer(report(0,0,["left"]));
+  menu.pointer(report(0,0,[],["left"]));
+  expect(menu.pointer(report(700,300,["left"]))).toBe(true);
+  expect(menu.visible).toBe(false);
+  expect(menu.pointer(report(700,300,[],["left"]))).toBe(true);
+  expect(selected).toEqual([]);
+});
+
+test("Escape after releasing the opener does not eat the next application click", () => {
+  const {menu} = fixture();
+  menu.pointer(report(0,0,["left"]));
+  menu.pointer(report(0,0,[],["left"]));
+  menu.input(Buffer.from("\x1b"));
+  expect(menu.pointer(report(100,100,["left"]))).toBe(false);
+});
+
+test("font and clipboard buttons dispatch local commands; UTF-8 command editing survives split reads", async () => {
+  const calls=[];
+  const {menu}=fixture({controls:{fontSize:()=>13,execute:async line=>{calls.push(line);return "OK";}}});
+  menu.pointer(report(0,0,["left"]));
+  menu.pointer(report(0,0,[],["left"]));
+  for (const [x,y] of [[10,30],[400,30],[10,55],[300,55],[10,80]]) {
+    menu.pointer(report(x,y,["left"]));
+    menu.pointer(report(x,y,[],["left"]));
+  }
+  const bytes=Buffer.from("font 16中文");
+  menu.input(bytes.subarray(0,9)); menu.input(bytes.subarray(9));
+  menu.input(Buffer.from("\x7f\x7f\r")); // remove the two full code points
+  await new Promise(resolve=>setTimeout(resolve,0));
+  expect(calls).toEqual(["font -","font +","copy","paste","font 16"]);
+  expect(menu.visible).toBe(true);
+  menu.input(Buffer.from("\x1b"));
+});
+
+test("command registry validates font/VT arguments and is extensible", async () => {
+  let size=13; const calls=[];
+  const c=createCommands({fontSize:()=>size,setFontSize:n=>{if(!Number.isInteger(n)||n<6||n>96)throw Error("size");size=n;},
+    copy:()=>calls.push("copy"),paste:()=>calls.push("paste"),switchVT:n=>calls.push(n)});
+  expect(await c.execute("font +")).toBe("Font: 14");
+  await c.execute("font 18"); expect(size).toBe(18);
+  await expect(c.execute("font nope")).rejects.toThrow();
+  await expect(c.execute("vt 64")).rejects.toThrow();
+  await expect(c.execute("copy extra")).rejects.toThrow();
+  await expect(c.execute("unknown")).rejects.toThrow("try help");
+  await c.execute("copy"); await c.execute("paste"); await c.execute("vt 3");
+  expect(calls).toEqual(["copy","paste",3]);
+  c.commands.set("example", args=>args.join(" "));
+  expect(await c.execute("example hello world")).toBe("hello world");
+});
+
+test("menu labels current VT and renders a real left-aligned command field with centered font value", () => {
+  const {menu}=fixture({list:()=>[{number:1,label:"tty1 — initial console",current:true}],
+    controls:{fontSize:()=>13,execute:()=>""}});
+  menu.pointer(report(0,0,["left"]));
+  const labels=[];
+  menu.draw({cellWidth:8,cellHeight:16,CanvasKit:{XYWHRect:(...r)=>r,ClipOp:{Intersect:0}},
+    paintFor:c=>c,drawText:(text,x,y,cells,color,options)=>labels.push({text,align:options.align}),
+    canvas:{save(){},restore(){},clipRect(){},drawRect(){}}});
+  expect(labels).toContainEqual({text:"tty1 — initial console (current)",align:"left"});
+  expect(labels).toContainEqual({text:"Click to type a command…",align:"left"});
+  expect(labels).toContainEqual({text:"🔤 字體 Font 13",align:"center"});
+  expect(labels).toContainEqual({text:"📋 複製 Copy",align:"left"});
+  expect(labels).toContainEqual({text:"📥 貼上 Paste",align:"left"});
+  expect(labels.some(x=>x.text===">")).toBe(false);
+});
+
+test("font buttons fit equally and preserve the right margin as fonts grow", () => {
+  const {menu}=fixture({controls:{fontSize:()=>20,execute:()=>""}});
+  menu.pointer(report(0,0,["left"]));
+  for(const cellWidth of [8,12,19,58]) {
+    const labels=[];
+    menu.draw({cellWidth,cellHeight:24,CanvasKit:{XYWHRect:(...r)=>r,ClipOp:{Intersect:0}},
+      paintFor:c=>c,drawText:(text,x,y,cells,color,options)=>labels.push({text,x,cells,align:options.align}),
+      canvas:{save(){},restore(){},clipRect(){},drawRect(){}}});
+    const plus=labels.find(x=>x.text==="[+]"),minus=labels.find(x=>x.text==="[-]");
+    expect(plus.align).toBe("center");expect(minus.align).toBe("center");
+    expect(plus.cells).toBe(minus.cells);
+    expect(plus.x+plus.cells*cellWidth).toBe(412);
+    expect(minus.x).toBe(8);
+  }
+});
+
+test('header FPS control toggles without selecting a tty or leaking the click',()=>{
+ let enabled=false;
+ const {menu,selected}=fixture({controls:{fontSize:()=>13,execute:()=>'',fpsEnabled:()=>enabled,toggleFps:()=>{enabled=!enabled;}}});
+ menu.pointer(report(0,0,['left']));
+ menu.pointer(report(0,0,[],['left']));
+ expect(menu.pointer(report(380,12,['left']))).toBe(true);
+ expect(enabled).toBe(true);expect(menu.visible).toBe(true);expect(selected).toEqual([]);
+ menu.pointer(report(380,12,[],['left']));
+ const labels=[];
+ menu.draw({cellWidth:8,cellHeight:16,CanvasKit:{XYWHRect:(...r)=>r,ClipOp:{Intersect:0}},
+  paintFor:c=>c,drawText:text=>labels.push(text),canvas:{save(){},restore(){},clipRect(){},drawRect(){}}});
+ expect(labels).toContain('[FPS ✓]');
+ menu.pointer(report(380,12,['left']));expect(enabled).toBe(false);
+});

package/test/chroot-bind.test.js

@@ -39,8 +39,21 @@ async function invoke(argumentsFor,env={}) {
  const mock=join(dir,'libc.js');
  writeFileSync(mock,`import {appendFileSync} from 'node:fs';
  const record=(name,...args)=>appendFileSync(${JSON.stringify(log)},JSON.stringify([name,...args.map(a=>typeof a==='bigint'?String(a):a)])+'\\n');
- export const ptr=x=>x,cString=x=>x,errno=()=>1,strerror=()=> 'mock mount denied',Errno={EINVAL:22,EPERM:1};
- export const libc={symbols:{mount:(...a)=>{record('mount',...a);return a[0]?.endsWith('/fail')?-1:0;},umount2:(...a)=>{record('umount',...a);return 0;},chroot:(...a)=>{record('chroot',...a);return 0;}}};`);
+ let entered=false;
+ const bound=new Map();
+ const functions={mount:(...a)=>{record('mount',...a);return a[0]?.endsWith('/fail')?-1:0;},
+ umount2:(...a)=>{record('umount',...a);return process.env.MOCK_UNMOUNT_FAIL?-1:0;},
+ chroot:(...a)=>{record('chroot',...a);entered=true;return 0;},
+ strerror:()=> 'mock mount denied',errno:()=>process.env.MOCK_UNMOUNT_FAIL?5:1};
+ export const libc={symbols:new Proxy({}, {get(_target,name){
+   if(!bound.has(name)){
+     record('resolve',name);
+     if(entered||process.env.MOCK_MISSING_SYMBOL===name)throw Error('Cannot load libc symbol '+name);
+     bound.set(name,functions[name]);
+   }
+   return bound.get(name);
+ }})};
+ export const ptr=x=>x,cString=x=>x,errno=()=>libc.symbols.errno(),strerror=code=>libc.symbols.strerror(code),Errno={EINVAL:22,EPERM:1};`);
  const source=readFileSync(new URL('../initramfs/bin/chroot',import.meta.url),'utf8')
   .replace('"../lib/dlopen.js"',JSON.stringify(mock))
   .replace('"../lib/chroot-options.js"',JSON.stringify(new URL('../initramfs/lib/chroot-options.js',import.meta.url).pathname))
@@ -68,3 +81,28 @@ test('shared tmp replaces default tmpfs and bind failure cleans up even with -k'
  expect(failure.calls.some(c=>c[0]==='chroot')).toBe(false);
  expect(failure.calls.filter(c=>c[0]==='umount').map(c=>c[1])).toEqual([failure.root+'/first']);
 });
+
+test('cleanup symbols are resolved before mounting and remain usable after chroot',async()=>{
+ const r=await invoke(({host})=>['-n','-b',`${host}:/work`],{MOCK_UNMOUNT_FAIL:'1'});
+ expect(r.status).toBe(0);
+ expect(r.stderr).toContain('chroot: unmount /work: mock mount denied');
+ expect(r.stderr).not.toContain('Cannot load libc symbol');
+ const firstMount=r.calls.findIndex(c=>c[0]==='mount');
+ for(const name of ['umount2','strerror','errno']){
+   const index=r.calls.findIndex(c=>c[0]==='resolve'&&c[1]===name);
+   expect(index).toBeGreaterThanOrEqual(0);expect(index).toBeLessThan(firstMount);
+ }
+ expect(r.calls.filter(c=>c[0]==='umount').map(c=>c[2])).toEqual([0,2]);
+});
+
+test('missing cleanup symbol fails before any mount, including keep-mounts',async()=>{
+ const r=await invoke(({host})=>['-n','-k','-b',`${host}:/work`],{MOCK_MISSING_SYMBOL:'umount2'});
+ expect(r.status).toBe(125);expect(r.stderr).toContain('Cannot load libc symbol umount2');
+ expect(r.calls.some(c=>['mount','chroot','umount'].includes(c[0]))).toBe(false);
+});
+
+test('no-mount chroot without binds does not require umount2',async()=>{
+ const r=await invoke(()=>['-n'],{MOCK_MISSING_SYMBOL:'umount2'});
+ expect(r.status).toBe(0);
+ expect(r.calls.some(c=>c[0]==='resolve'&&c[1]==='umount2')).toBe(false);
+});

package/test/chvt.test.js

@@ -0,0 +1,46 @@
+import { test, expect } from "bun:test";
+import { parseChvt, switchVt } from "../initramfs/lib/chvt.js";
+
+test("chvt accepts VT numbers and help, rejects invalid input before opening devices", async () => {
+  expect(parseChvt(["2"])).toEqual({ number: 2 });
+  expect(parseChvt(["63"])).toEqual({ number: 63 });
+  for (const flag of ["-h", "--help"]) expect(parseChvt([flag]).help).toBe(true);
+  for (const args of [[], ["0"], ["64"], ["-1"], ["2x"], ["1", "2"]]) expect(() => parseChvt(args)).toThrow();
+  await expect(switchVt(0, {})).rejects.toThrow();
+});
+
+test("chvt skips PTY/non-VT consoles, activates only a validated VT and closes descriptors", async () => {
+  const events = [];
+  await switchVt(2, {
+    openConsole([path]) {
+      events.push(path);
+      if (path === "/dev/tty0") throw Error("missing");
+      return { path, close: () => events.push(`close ${path}`) };
+    },
+    activeConsole(device) { if (device.path === "/dev/tty") throw Error("not a VT"); },
+    activateConsole(device, number) { events.push(`activate ${device.path} ${number}`); },
+  });
+  expect(events).toEqual(["/dev/tty0", "/dev/tty", "close /dev/tty", "/dev/console", "activate /dev/console 2", "close /dev/console"]);
+});
+
+test("chvt closes console on failed switch without overriding VT owner or trying another switch", async () => {
+  let closed = 0, opened = 0;
+  await expect(switchVt(1, {
+    openConsole() { opened++; return { close() { closed++; } }; },
+    activeConsole() { return 2; },
+    activateConsole() { throw Error("switch denied"); },
+  })).rejects.toThrow("switch denied");
+  expect(opened).toBe(1);
+  expect(closed).toBe(1);
+});
+
+test("chvt CLI help and invalid arguments work without a Linux console", () => {
+  for (const flag of ["-h", "--help"]) {
+    const result = Bun.spawnSync([process.execPath, "initramfs/bin/chvt", flag]);
+    expect(result.exitCode).toBe(0);
+    expect(result.stdout.toString()).toContain("bunterm");
+  }
+  const invalid = Bun.spawnSync([process.execPath, "initramfs/bin/chvt", "0"]);
+  expect(invalid.exitCode).toBe(1);
+  expect(invalid.stderr.toString()).toContain("usage:");
+});

package/test/fbdev-sync.test.js

@@ -0,0 +1,33 @@
+import { test, expect } from "bun:test";
+import { syncFramebuffer, flush } from "../initramfs/lib/fbdev.js";
+const display = () => ({ address: 0x10000, memoryLength: 4096, path: "/dev/fb0" });
+test("unsupported framebuffer msync is probed once per mapping", () => {
+  for (const code of [22, 95]) {
+    const fb = display(); let calls = 0;
+    const native = { msync(...args) { calls++; expect(args).toEqual([0x10000, 4096, 4]); return -1; }, errno: () => code };
+    syncFramebuffer(fb, native); syncFramebuffer(fb, native);
+    expect(calls).toBe(1);
+    expect(fb.msyncUnsupported).toBe(true);
+  }
+});
+test("supported sync continues every frame and retries EINTR", () => {
+  const fb = display(); let calls = 0;
+  const native = { msync() { return ++calls === 1 ? -1 : 0; }, errno: () => 4 };
+  syncFramebuffer(fb, native); syncFramebuffer(fb, native);
+  expect(calls).toBe(3);
+  expect(fb.msyncUnsupported).toBeUndefined();
+});
+test("real mapping and I/O failures remain visible", () => {
+  for (const code of [5, 12, 9]) {
+    const fb = display();
+    expect(() => syncFramebuffer(fb, {msync: () => -1, errno: () => code, strerror: () => `error ${code}`})).toThrow(`error ${code}`);
+    expect(fb.msyncUnsupported).toBeUndefined();
+  }
+});
+test("pixel writes continue on unsupported sync and respect framebuffer offsets and stride", () => {
+  const fb = {...display(), msyncUnsupported: true, width: 2, height: 2, bytesPerPixel: 1,
+    stride: 4, xOffset: 1, yOffset: 1, pixels: new Uint8Array([1,2,0,0,3,4,0,0]), memory: new Uint8Array(16)};
+  flush(fb);
+  expect([...fb.memory]).toEqual([0,0,0,0,0,1,2,0,0,3,4,0,0,0,0,0]);
+  fb.pixels[0] = 9; flush(fb); expect(fb.memory[5]).toBe(9);
+});

package/test/gpu.test.js

@@ -0,0 +1,155 @@
+import { test, expect, afterEach } from "bun:test";
+import * as fs from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { configureGpu, framebufferUsers, isGpuPath } from "../initramfs/lib/gpu.js";
+import { extractFirmware, firmwareLinkTarget } from "../scripts/fetch-gpu.js";
+import { readTar } from "../scripts/fetch.js";
+import { requests, select } from "../scripts/modules.js";
+
+const dirs = [];
+const temporary = () => { const p = fs.mkdtempSync(join(tmpdir(), "buninu-gpu-test-")); dirs.push(p); return p; };
+afterEach(() => { for (const dir of dirs.splice(0)) fs.rmSync(dir, { recursive: true, force: true }); });
+const archive = (files, links = {}) => ({ entries: () => Object.entries(files).map(([n,b]) => [n, Buffer.from(b)]), links: () => Object.entries(links) });
+const soft = target => ({ target, hard: false });
+
+test("firmware preserves directory aliases, cross-package links and hardlinks", () => {
+  const root = temporary();
+  const files = extractFirmware([
+    archive({ "lib/firmware/nvidia/ad102/gsp.bin.zst": "firmware", "lib/firmware/amdgpu/a.bin.zst": "amd" }),
+    archive({}, {
+      "lib/firmware/nvidia/ad103": soft("ad102"),
+      "lib/firmware/nvidia/alias.bin.zst": soft("ad103/gsp.bin.zst"),
+      "lib/firmware/radeon/alias.bin.zst": soft("../amdgpu/a.bin.zst"),
+      "lib/firmware/nvidia/hard.bin.zst": { target: "lib/firmware/nvidia/ad102/gsp.bin.zst", hard: true },
+    }),
+  ], root);
+  expect(files).toHaveLength(6);
+  expect(fs.readFileSync(join(root, "lib/firmware/nvidia/ad103/gsp.bin.zst"), "utf8")).toBe("firmware");
+  expect(fs.readFileSync(join(root, "lib/firmware/nvidia/alias.bin.zst"), "utf8")).toBe("firmware");
+  expect(fs.readFileSync(join(root, "lib/firmware/nvidia/hard.bin.zst"), "utf8")).toBe("firmware");
+  expect(fs.readFileSync(join(root, "lib/firmware/radeon/alias.bin.zst"), "utf8")).toBe("amd");
+});
+
+test("firmware rejects escaping, missing and cyclic links before extraction", () => {
+  for (const target of ["/etc/passwd", "../../../etc/passwd", "..\\etc\\passwd"])
+    expect(() => firmwareLinkTarget("lib/firmware/nvidia/x", soft(target))).toThrow();
+  for (const links of [
+    { "lib/firmware/a": soft("missing") },
+    { "lib/firmware/a": soft("b"), "lib/firmware/b": soft("a") },
+    { "lib/firmware/a": soft("a/child") },
+  ]) expect(() => extractFirmware([archive({}, links)], temporary())).toThrow();
+  expect(() => extractFirmware([archive({"lib/firmware/../../escape": "bad"})], temporary())).toThrow();
+});
+
+test.skipIf(!Bun.which("tar"))("APK tar reader retains GNU long symlinks and hardlinks", () => {
+  const root = temporary(), tree = join(root, "tree"); fs.mkdirSync(tree);
+  const name = "x".repeat(120);
+  fs.writeFileSync(join(tree, name), "firmware");
+  fs.linkSync(join(tree, name), join(tree, "hard"));
+  fs.symlinkSync(name, join(tree, "alias"));
+  const pkg = join(root, "package.tar.gz");
+  expect(Bun.spawnSync(["tar", "--format=gnu", "-czf", pkg, "-C", tree, name, "hard", "alias"]).exitCode).toBe(0);
+  const tar = readTar(pkg), links = new Map(tar.links());
+  expect(tar.get(name).toString()).toBe("firmware");
+  expect(links.get("alias")).toEqual({ target: name, hard: false });
+  expect(links.get("hard")).toEqual({ target: name, hard: true });
+});
+
+const runtime = () => {
+  const root = temporary(), calls = [], logs = [];
+  fs.mkdirSync(join(root, "proc/1/fd"), { recursive:true });
+  fs.writeFileSync(join(root, "proc/1/maps"), "");
+  fs.mkdirSync(join(root, "dev/dri"), { recursive:true });
+  fs.writeFileSync(join(root, "dev/dri/renderD129"), "node");
+  fs.writeFileSync(join(root, "dev/fb0"), "node");
+  const io = {...fs,
+    statSync: path => path.includes("renderD") ? { isCharacterDevice: () => true } : fs.statSync(path),
+    chownSync: (path, uid, gid) => calls.push(["chown", uid, gid]),
+    chmodSync: (path, mode) => calls.push(["chmod", mode]),
+  };
+  const options = { root, io, env: {}, log: s => logs.push(s),
+    tryModprobe: name => calls.push(["transport", name]),
+    autoload: options => {
+      const candidates = [ ["amdgpu", "kernel/drivers/gpu/drm/amd/amdgpu/amdgpu.ko"], ["simpledrm", "kernel/drivers/gpu/drm/sysfb/simpledrm.ko"], ["e1000", "kernel/drivers/net/e1000.ko"] ];
+      const modules = candidates.filter(x => options.acceptModule(...x)).map(x => x[0]);
+      calls.push(["autoload", modules]);
+      return [{ bus:"pci", device:"0000:01:00.0", modules, loaded:modules, error:null }];
+    },
+  };
+  return { root, calls, logs, options };
+};
+
+test("cfg.gpu matches only GPU leaf drivers and configures actual render node names", () => {
+  const { options, calls } = runtime(); options.env.BUNINU_RENDER_GID = "107";
+  const result = configureGpu(options);
+  expect(result.errors).toEqual([]);
+  expect(result.renderNodes).toEqual([{path:"/dev/dri/renderD129", driver:"unknown", gid:107}]);
+  expect(calls).toContainEqual(["autoload", ["amdgpu"]]);
+  expect(calls).toContainEqual(["chown", 0, 107]);
+  expect(calls).toContainEqual(["chmod", 0o660]);
+});
+
+test("virtio render nodes report the GPU child driver rather than the PCI transport", () => {
+  const { root, options } = runtime();
+  const device = join(root, "sys/class/drm/renderD129/device");
+  fs.mkdirSync(join(device, "virtio0"), {recursive:true});
+  fs.symlinkSync("/sys/bus/pci/drivers/virtio-pci", join(device, "driver"));
+  fs.symlinkSync("/sys/bus/virtio/drivers/virtio_gpu", join(device, "virtio0/driver"));
+  expect(configureGpu(options).renderNodes[0].driver).toBe("virtio_gpu");
+});
+
+test("no matching GPU and no render node is diagnosed without claiming acceleration", () => {
+  const { root, options, logs } = runtime();
+  fs.unlinkSync(join(root, "dev/dri/renderD129"));
+  options.autoload = () => [];
+  const result = configureGpu(options);
+  expect(result.errors).toEqual([]);
+  expect(result.renderNodes).toEqual([]);
+  expect(logs.some(s=>s.includes("no accessible render node"))).toBe(true);
+});
+
+test("framebuffer fd or surviving mmap prevents GPU takeover before loading anything", () => {
+  for (const mapped of [false, true]) {
+    const { root, options, calls } = runtime();
+    if (mapped) fs.writeFileSync(join(root, "proc/1/maps"), "abc-def rw-s 00000000 00:01 3 /dev/fb0\n");
+    else fs.symlinkSync("/dev/fb0", join(root, "proc/1/fd/4"));
+    expect(framebufferUsers(options)).toEqual(["1"]);
+    expect(configureGpu(options).blocked).toBe(true);
+    expect(calls).toEqual([]);
+  }
+});
+
+test("missing hardware, driver failure and invalid permissions do not escape cfg.gpu", () => {
+  const { options, calls } = runtime();
+  options.env.BUNINU_RENDER_GID = "bad";
+  expect(configureGpu(options).errors.length).toBe(1); expect(calls).toEqual([]);
+  options.env = {};
+  options.autoload = () => { throw Error("driver failed"); };
+  expect(configureGpu(options).errors).toEqual(["driver failed"]);
+  options.autoload = () => []; options.io.chownSync = () => { throw Error("permission denied"); };
+  expect(configureGpu(options).errors[0]).toContain("permission denied");
+});
+
+test("cfg.all's actual loader excludes GPU modules and still loads network/sound", () => {
+  const source = fs.readFileSync(new URL("../initramfs/init.js", import.meta.url), "utf8");
+  const body = source.match(/const configureModules = \(\) => \{([\s\S]*?)\n\};/)[1];
+  const chosen = [];
+  const require = () => ({ isGpuPath, modprobeAll: ({accept}) => {
+    for (const path of ["kernel/drivers/gpu/drm/amd/amdgpu/amdgpu.ko", "kernel/drivers/net/e1000.ko", "kernel/sound/snd.ko"])
+      if (accept("",path)) chosen.push(path);
+    return {inserted:chosen,errors:[]};
+  }});
+  new Function("require", "console", body)(require, {log(){}});
+  expect(chosen).toEqual(["kernel/drivers/net/e1000.ko", "kernel/sound/snd.ko"]);
+  expect(source).toContain("gpu: { enumerable: true, get: configureGraphics }");
+});
+
+test("GPU leaves are optional for kernels without them and their dependencies are selected", () => {
+  const target = {arch:"x86_64",flavor:"lts",real:false};
+  const dep = requests(target).filter(x=>!x.optional).map(({name})=>`kernel/${name}.ko.gz:`);
+  dep.push("kernel/drivers/gpu/drm/amd/amdgpu/amdgpu.ko.gz: kernel/drivers/gpu/drm/ttm/ttm.ko.gz", "kernel/drivers/gpu/drm/ttm/ttm.ko.gz:");
+  const result = select({...target,dep:dep.join("\n"),builtin:"",packageName:"test"});
+  expect(result.selected).toContain("kernel/drivers/gpu/drm/ttm/ttm.ko.gz");
+  expect(result.notes.some(x=>x.includes("i915"))).toBe(true);
+});

package/test/image-size.test.js

@@ -0,0 +1,17 @@
+import { test, expect } from "bun:test";
+import { imageBytes } from "../scripts/build.js";
+import { layout } from "../initramfs/lib/fat.js";
+const MiB = 1024 * 1024;
+test("image sizing preserves small images and fits GPU firmware payloads plus FAT metadata", () => {
+  expect(imageBytes(80 * MiB)).toBe(128 * MiB);
+  // Actual no-gpu EFI: the former 16 MiB reserve incorrectly made this 192 MiB.
+  expect(imageBytes(113646592)).toBe(128 * MiB);
+  expect(imageBytes(266 * MiB)).toBe(320 * MiB);
+  for (const payload of [0, 100 * MiB, 120 * MiB, 240 * MiB, 266 * MiB, 512 * MiB, 0xffffffff]) {
+    const size = imageBytes(payload);
+    const geometry = layout(size / 512 - 34 - 2048 + 1);
+    expect((geometry.clusters - 3) * geometry.perCluster * 512).toBeGreaterThan(payload);
+    expect(size % (64 * MiB)).toBe(0);
+  }
+  expect(() => imageBytes(0x100000000)).toThrow("FAT32");
+});

package/test/manual-bunterm-image-paths.js

@@ -0,0 +1,31 @@
+import {runGraphics} from '/lib/fbdev.js';
+import {loadCanvasKit,openCanvas} from '/lib/canvas.js';
+import {claimVirtualConsole} from '/lib/bunterm/vt.js';
+// Manual native Linux benchmark; takes over tty6 temporarily.
+// bun test/manual-bunterm-image-paths.js /path/to/1920x1080.png
+if(!process.argv[2])throw Error('Pass a 1920x1080 PNG filename');
+const CK=await loadCanvasKit(), results=[];
+await runGraphics(async(display,{onRelease,onAcquire})=>{
+ const screen=openCanvas(CK,display);let active=true;onRelease(()=>active=false);onAcquire(()=>active=true);
+ const bytes=await Bun.file(process.argv[2]).bytes();
+ const image=CK.MakeImageFromEncoded(bytes),w=image.width(),h=image.height();
+ if(w!==1920||h!==1080||display.width!==1920||display.height!==1080||display.bitsPerPixel!==32)throw Error("This comparison requires a 1920x1080 image and 32-bit 1920x1080 framebuffer");
+ const src=CK.LTRBRect(0,0,w,h), native=CK.LTRBRect(0,0,w,h),scaled=CK.LTRBRect(0,26,1920,1066);
+ const info={width:w,height:h,colorType:CK.ColorType.RGBA_8888,alphaType:CK.AlphaType.Unpremul,colorSpace:CK.ColorSpace.SRGB};
+ const start=performance.now(),pixels=image.readPixels(0,0,info);
+ if(!pixels)throw Error('readPixels failed');
+ if(screen.colorType===CK.ColorType.BGRA_8888)for(let i=0;i<pixels.length;i+=4){const r=pixels[i];pixels[i]=pixels[i+2];pixels[i+2]=r;}results.push({readPixelsMs:performance.now()-start,width:w,height:h,bytes:pixels?.length});
+ const actions={
+  'rows-scaled':()=>{for(let y=0;y<1080;y+=26){screen.canvas.save();screen.canvas.clipRect(CK.LTRBRect(0,y,1920,Math.min(1080,y+26)),CK.ClipOp.Intersect,false);screen.canvas.drawImageRectOptions(image,src,scaled,CK.FilterMode.Linear,CK.MipmapMode.Linear,null);screen.canvas.restore();}},
+  'single-scaled':()=>screen.canvas.drawImageRectOptions(image,src,scaled,CK.FilterMode.Linear,CK.MipmapMode.Linear,null),
+  'single-1to1':()=>screen.canvas.drawImageRectOptions(image,src,native,CK.FilterMode.Linear,CK.MipmapMode.Linear,null),
+  'drawImage-1to1':()=>screen.canvas.drawImage(image,0,0),
+  'decode-copy-1to1':()=>{const fresh=CK.MakeImageFromEncoded(bytes);try{const p=fresh.readPixels(0,0,info);if(!p)throw Error('decode failed');if(screen.colorType===CK.ColorType.BGRA_8888)for(let i=0;i<p.length;i+=4){const r=p[i];p[i]=p[i+2];p[i+2]=r;}screen.restoreRegion({x:0,y:0,height:Math.min(h,1080),rowBytes:w*4,pixels:p});}finally{fresh.delete();}},
+  'copy-1to1':()=>screen.restoreRegion({x:0,y:0,height:Math.min(h,1080),rowBytes:w*4,pixels}),
+ };
+ try {for(const [name,draw] of Object.entries(actions)){
+   screen.canvas.clear(CK.BLACK);draw();screen.flush();
+   const t=performance.now();let count=0,total=0;while(performance.now()-t<2500){if(!active)throw Error('VT switched');const t0=performance.now();draw();screen.flush();total+=performance.now()-t0;count++;await Bun.sleep(16);}
+   results.push({name,ms:total/count,count});await Bun.write('/tmp/bunterm-image-paths.json',JSON.stringify(results,null,2));
+ }}finally{image.delete();screen.close();}
+},{console:['/dev/tty6'],prepareConsole:claimVirtualConsole});process.exit(0);

package/test/mount-libc-lifetime.test.js

@@ -0,0 +1,50 @@
+import {test,expect} from 'bun:test';
+import {mkdtempSync,writeFileSync,readFileSync,rmSync} from 'node:fs';
+import {tmpdir} from 'node:os';
+import {join} from 'node:path';
+
+// Run the real command with a libc whose path disappears after the first
+// successful mount change. Never mount or unmount anything on the host.
+async function invoke(name,args){
+ const dir=mkdtempSync(join(tmpdir(),'buninu-mount-libc-'));
+ const mock=join(dir,'libc.mjs');
+ writeFileSync(mock,`
+ let hidden=false;
+ const bound=new Map();
+ const functions={mount:()=>{if(hidden)return -1;hidden=true;return 0;},
+ umount2:()=>{if(hidden)return -1;hidden=true;return 0;},
+ errno:()=>5,strerror:()=> 'mock I/O error'};
+ export const libc={symbols:new Proxy({}, {get(_target,name){
+   if(!bound.has(name)){
+     if(hidden)throw Error('Cannot load libc symbol '+name);
+     bound.set(name,functions[name]);
+   }
+   return bound.get(name);
+ }})};
+ export const ptr=x=>x,cString=x=>x,errno=()=>libc.symbols.errno(),
+ strerror=code=>libc.symbols.strerror(code),Errno={},SysError=class extends Error{};
+ `);
+ const source=readFileSync(new URL('../initramfs/bin/'+name,import.meta.url),'utf8')
+ .replace('"../lib/dlopen.js"',JSON.stringify(mock))
+ .replace('import { showDocument } from "../lib/document.js";','const showDocument=async()=>{};')
+ .replace('import { modprobe, tryModprobe, modulesDirectory, ModuleNotFound } from "../lib/modprobe.js";',
+ 'const modprobe=()=>[],tryModprobe=()=>[],modulesDirectory=()=>"";class ModuleNotFound extends Error{}');
+ const entry=join(dir,'command.mjs');writeFileSync(entry,source);
+ try{
+   const child=Bun.spawn([process.execPath,entry,...args],{stdout:'pipe',stderr:'pipe'});
+   const stderr=new Response(child.stderr).text();
+   return {status:await child.exited,stderr:await stderr};
+ }finally{rmSync(dir,{recursive:true,force:true});}
+}
+
+test('read-only bind reports remount failure after the libc path is hidden',async()=>{
+ const r=await invoke('mount',['--bind','-o','ro','/fake-source','/fake-target']);
+ expect(r.status).toBe(32);expect(r.stderr).toContain('mount: mock I/O error');
+ expect(r.stderr).not.toContain('Cannot load libc symbol');
+});
+
+test('later unmount failure reports strerror after an earlier target hides libc',async()=>{
+ const r=await invoke('umount',['/fake-lib','/fake-missing']);
+ expect(r.status).toBe(32);expect(r.stderr).toContain('umount: /fake-missing: mock I/O error.');
+ expect(r.stderr).not.toContain('Cannot load libc symbol');
+});

package/test/no-gpu.test.js

@@ -0,0 +1,43 @@
+import {test,expect} from "bun:test";
+import {mkdtempSync,mkdirSync,writeFileSync,existsSync,rmSync} from "node:fs";
+import {tmpdir} from "node:os";
+import {join} from "node:path";
+import {requests,select} from "../scripts/modules.js";
+import {config} from "../scripts/arch.js";
+import {fetchGpuFirmware,gpuReady} from "../scripts/fetch-gpu.js";
+const additions=new Set(["virtio-gpu","vmwgfx","i915","xe","amdgpu","radeon","nouveau"]);
+test("no-gpu only removes new explicit requests across target configurations",()=>{
+ for(const arch of ["x86_64","aarch64"])for(const flavor of ["lts","virt"])for(const real of [true,false]){
+   const cfg={arch,flavor,real};
+   expect(requests({...cfg,noGpu:true})).toEqual(requests(cfg).filter(r=>!additions.has(r.name)));
+ }
+ expect(config({noGpu:true}).noGpu).toBe(true);
+});
+test("no-gpu retains a GPU-directory dependency when an original module needs it",()=>{
+ const cfg={arch:"x86_64",flavor:"lts",real:false,noGpu:true};
+ const dep=requests(cfg).map(({name})=>`kernel/test/${name}.ko.gz:${name==="snd-hda-intel"?" kernel/drivers/gpu/drm/shared.ko.gz":""}`).join("\n")+"\nkernel/drivers/gpu/drm/shared.ko.gz:";
+ expect(select({...cfg,dep,builtin:"",packageName:"test"}).selected).toContain("kernel/drivers/gpu/drm/shared.ko.gz");
+});
+test("no-gpu clears generated firmware and caches cannot cross GPU modes",async()=>{
+ const root=mkdtempSync(join(tmpdir(),"no-gpu-"));
+ try{
+   const cfg={...config({arch:"x86_64",flavor:"lts",real:true,noGpu:true}),nativeDir:root,modulesRoot:join(root,"modules")};
+   mkdirSync(cfg.modulesRoot,{recursive:true});
+   writeFileSync(join(cfg.modulesRoot,"modules.dep"),"");
+   writeFileSync(join(cfg.modulesRoot,"modules.builtin"),"kernel/drivers/gpu/drm/i915/i915.ko\n");
+   mkdirSync(join(root,"lib/firmware"),{recursive:true});
+   writeFileSync(join(root,"lib/firmware/stale"),"old firmware");
+   await fetchGpuFirmware(cfg);
+   expect(existsSync(join(root,"lib/firmware"))).toBe(false);
+   expect(gpuReady(cfg)).toBe(true);
+   expect(gpuReady({...cfg,noGpu:false})).toBe(false);
+   mkdirSync(join(root,"lib/firmware"));
+   expect(gpuReady(cfg)).toBe(false);
+ }finally{rmSync(root,{recursive:true,force:true});}
+});
+test("launcher documents no-gpu and rejects it without fetch/build",()=>{
+ const help=Bun.spawnSync([process.execPath,"index.js","--help"]);
+ expect(help.exitCode).toBe(0);expect(help.stdout.toString()).toContain("--no-gpu");
+ const invalid=Bun.spawnSync([process.execPath,"index.js","-r","--no-gpu"]);
+ expect(invalid.exitCode).not.toBe(0);expect(invalid.stderr.toString()).toContain("only make sense");
+});

package/test/readme-cli.test.js

@@ -0,0 +1,29 @@
+import { expect, test } from "bun:test";
+import { fileURLToPath } from "node:url";
+
+const entry = fileURLToPath(new URL("../index.js", import.meta.url));
+
+for (const [flag, filename] of [
+  ["--readme", "README.md"],
+  ["--readme-zh", "README.zh.md"],
+  ["--docs", "README.zh.md"],
+]) {
+  test(`${flag} flushes the complete document to a pipe before exiting`, async () => {
+    const markdown = await Bun.file(new URL(`../${filename}`, import.meta.url)).text();
+    const rendered = Bun.markdown.ansi(markdown, { hyperlinks: true });
+    const expected = rendered.endsWith("\n") ? rendered : `${rendered}\n`;
+    // Both real documents exceed the pipe chunk that was previously truncated.
+    expect(Buffer.byteLength(expected)).toBeGreaterThan(65536);
+    const child = Bun.spawn([process.execPath, entry, flag], {
+      stdout: "pipe", stderr: "pipe",
+    });
+    const [output, errors, status] = await Promise.all([
+      new Response(child.stdout).text(),
+      new Response(child.stderr).text(),
+      child.exited,
+    ]);
+    expect(status).toBe(0);
+    expect(errors).toBe("");
+    expect(output).toBe(expected);
+  });
+}