buninu-browser 0.4.0 → 0.5.0

package/test/computed-style.test.js

@@ -859,3 +859,15 @@ test("a linked style sheet's url()s resolve against the sheet", () => {
   )).toBe(`a { background: url(https://site.test/css/img/a.png) } b { background: url("https://site.test/b.png") } c { background: url(data:image/png;base64,AA) }
      d { background: url(https://cdn.test/d.png) } e { mask: url(#m) }`);
 });
+
+test("form controls default to readable dark text but author colors still win", () => {
+  const {document,window}=parseHTMLDocument(`<body style="color:lightblue"><textarea></textarea><input><button>Button</button><select><option>Option</option></select><textarea id="inherit" style="color:inherit"></textarea><input id="custom" style="color:red"></body>`);
+  try {
+    const styles=new StyleEngine().compute(document);
+    for(const e of document.querySelectorAll('textarea,input,button,select')) {
+      if(!e.id)expect(styles.get(e).color).toBe('rgba(0, 0, 0, 1)');
+    }
+    expect(styles.get(document.querySelector('#inherit')).color).toBe(styles.get(document.body).color);
+    expect(styles.get(document.querySelector('#custom')).color).toBe('rgba(255, 0, 0, 1)');
+  } finally {window.happyDOM.abort()}
+});

package/test/document-selection.test.js

@@ -0,0 +1,27 @@
+import {test,expect} from 'bun:test';
+import {createBrowser} from '../lib/headless-shell.js';
+test('drag selects document text and controls without stealing canceled mouse gestures',async()=>{
+ let copied='';const b=await createBrowser({spareRenderer:false,clipboard:{read:async()=>copied,write:async text=>{copied=text}}});
+ const c=b.context,run=s=>c.evaluate(s);
+ const down=(x,y)=>c.pointerButton(x,y,272,1),up=(x,y)=>c.pointerButton(x,y,272,0);
+ try{
+ await c.resize(500,300,1);await c.navigate('data:text/html,'+encodeURIComponent('<style>body{margin:0;font:20px monospace}p{margin:0;height:30px}input{font:20px monospace;padding:0;border:0}</style><p id=a>abcdefghij</p><p id=b>klmnopqrst</p><input value="abcdefghij">'));
+ await down(12,12);await c.move(60,12);await up(60,12);
+ expect(await run('getSelection().toString()')).toBe('bcde');
+ await c.press('c',{modifiers:2});for(let i=0;i<50&&!copied;i++)await Bun.sleep(10);expect(copied).toBe('bcde');
+ await down(60,12);await c.move(12,12);await up(12,12);expect(await run('getSelection().toString()')).toBe('bcde');
+ await down(12,12);await c.move(36,42);await up(36,42);expect(await run('getSelection().toString()')).toContain('klm');
+ await down(12,72);await c.move(60,72);await up(60,72);
+ expect(await run('(()=>{const e=document.querySelector("input");return [e.selectionStart,e.selectionEnd]})()')).toEqual([1,5]);
+ await run('document.getElementById("a").onmousedown=e=>e.preventDefault();getSelection().removeAllRanges()');
+ await down(12,12);await c.move(60,12);await up(60,12);expect(await run('getSelection().toString()')).toBe('');
+ await run('getSelection().selectAllChildren(document.getElementById("a"))');expect(await run('getSelection().toString()')).toBe('abcdefghij');
+ expect(await run('document.getSelection()===window.getSelection()')).toBe(true);
+ await run('document.getElementById("a").onmousedown=null;document.getElementById("a").style.userSelect="none";getSelection().removeAllRanges()');
+ await down(12,12);await c.move(60,12);await up(60,12);expect(await run('getSelection().toString()')).toBe('');
+ await run('document.getElementById("a").style.userSelect="text";getSelection().selectAllChildren(document.getElementById("a"))');
+ await run('globalThis.selectedRange=getSelection().getRangeAt(0);getSelection().removeAllRanges();getSelection().addRange(selectedRange)');
+ expect(await run('getSelection().toString()')).toBe('abcdefghij');
+ await Bun.write('/tmp/document-selection.png'  ,Buffer.from(await c.screenshot({format:'png'}),'base64'));
+ }finally{b.close()}
+},30000);

package/test/double-click.test.js

@@ -0,0 +1,85 @@
+import {test,expect} from 'bun:test';
+import {createBrowser} from '../lib/headless-shell.js';
+import {CdpServer} from '../lib/cdp-server.js';
+import {CDP} from '../tools/browser-lab.js';
+import {attachInput} from '../frontends/wayland/input.js';
+import {mkdtempSync,rmSync} from 'node:fs';
+import {join} from 'node:path';
+const html=`<body style="margin:0"><div id="box" style="width:200px;height:100px">Double click</div><script>globalThis.events=[];for(const type of ['mousedown','mouseup','click','dblclick'])document.getElementById('box').addEventListener(type,e=>{globalThis.events.push(type+':'+e.detail);e.preventDefault()})</script>`;
+function pointer(context){
+ let seat,ptr;const errors=[];
+ const client={globals:new Map([['wl_seat',1]]),connection:{closed:false},bind:(n,v,cb)=>{seat=cb;return 1},object:(n,cb)=>{ptr=cb;return 2},request(){}};
+ attachInput(client,{surface:3,closed:false},context,e=>errors.push(e));seat('capabilities',[1]);ptr('enter',[1,3,20,20]);
+ return {event:ptr,errors,tap(time,x=20,y=20){ptr('motion',[time,x,y]);ptr('button',[1,time,272,1]);ptr('button',[2,time+30,272,0]);}};
+}
+const until=async(fn)=>{for(let i=0;i<100;i++){if(await fn())return;await Bun.sleep(20)}throw Error('input did not settle')};
+
+test('CDP clickCount reaches DOM clicks and dblclick after cancelled click',async()=>{
+ const b=await createBrowser({spareRenderer:false});const server=CdpServer.create(b.context).listen(0);
+ const cdp=new CDP(`ws://127.0.0.1:${server.port}/devtools/browser/cdp-server`);
+ try{
+  await cdp.ready;
+  const {targetId}=await cdp.send('Target.createTarget',{url:'data:text/html,'+encodeURIComponent(html)});
+  const {sessionId}=await cdp.send('Target.attachToTarget',{targetId,flatten:true});cdp.sessionId=sessionId;
+  await b.context.navigate('data:text/html,'+encodeURIComponent(html));
+  for(const clickCount of [1,2,3])for(const type of ['mousePressed','mouseReleased'])await cdp.send('Input.dispatchMouseEvent',{type,x:20,y:20,button:'left',clickCount});
+  expect(await b.context.evaluate('events')).toEqual(['mousedown:1','mouseup:1','click:1','mousedown:2','mouseup:2','click:2','dblclick:2','mousedown:3','mouseup:3','click:3']);
+ }finally{cdp.close();server.stop(true);b.close()}
+},30000);
+
+test('Wayland clicks reach HTML and QML double-tap handlers',async()=>{
+ const b=await createBrowser({spareRenderer:false});const dir=mkdtempSync('/tmp/double-click-');
+ try{
+  await b.context.navigate('data:text/html,'+encodeURIComponent(html));
+  const p=pointer(b.context);p.tap(1000);p.tap(1180,28,24);
+  await until(async()=>(await b.context.evaluate('events.length'))===7);
+  expect(await b.context.evaluate('events.at(-1)')).toBe('dblclick:2');expect(p.errors).toEqual([]);
+  await Bun.write(join(dir,'main.qml'),`import QtQuick
+Rectangle {width:200;height:100;color:"white";property int doubles:0
+ Text {id:status;text:"doubles="+parent.doubles}
+ TapHandler {onDoubleTapped:parent.doubles++}
+}`);
+  await b.context.navigate(Bun.pathToFileURL(join(dir,'main.qml')).href);
+  const q=pointer(b.context);q.tap(2000,60,60);q.tap(2180,65,63);
+  await until(async()=>(await b.context.evaluate('document.getElementById("status").textContent'))==='doubles=1');
+  expect(q.errors).toEqual([]);
+ }finally{b.close();rmSync(dir,{recursive:true,force:true})}
+},30000);
+
+test('Wayland count resets on timeout, distance and leave and handles timestamp wrap',async()=>{
+ const counts=[];const p=pointer({click:(x,y,o)=>counts.push(o.clickCount),move(){}});
+ p.tap(0xffffff00);p.tap(0x20);p.tap(1000);p.tap(1100,100,100);
+ p.event('leave',[]);p.event('enter',[1,3,100,100]);p.tap(1150,100,100);
+ await Bun.sleep(0);expect(counts).toEqual([1,2,1,1,1]);
+});
+
+test('CDP and Wayland preserve non-primary buttons without primary activation',async()=>{
+ const b=await createBrowser({spareRenderer:false});const server=CdpServer.create(b.context).listen(0);
+ const cdp=new CDP(`ws://127.0.0.1:${server.port}/devtools/browser/cdp-server`);
+ const dir=mkdtempSync('/tmp/nonprimary-click-');
+ try {
+  await cdp.ready;
+  const url='data:text/html,'+encodeURIComponent(`<body style="margin:0"><a id="box" href="https://example.invalid/" style="display:block;width:200px;height:100px">link</a><script>globalThis.events=[];const box=document.getElementById("box");for(const t of ['mousedown','mouseup','click','auxclick','contextmenu'])box.addEventListener(t,e=>events.push([t,e.button,e.buttons]));box.onauxclick=e=>events.push(['property',e.button]);</script>`);
+  const {targetId}=await cdp.send('Target.createTarget',{url});
+  const {sessionId}=await cdp.send('Target.attachToTarget',{targetId,flatten:true});cdp.sessionId=sessionId;
+  await b.context.navigate(url);
+  for(const type of ['mousePressed','mouseReleased'])await cdp.send('Input.dispatchMouseEvent',{type,x:30,y:40,button:'right',clickCount:1});
+  expect(await b.context.evaluate('events')).toEqual([['mousedown',2,2],['contextmenu',2,2],['mouseup',2,0],['auxclick',2,0],['property',2]]);
+  expect(b.context.url).toBe(url);
+  await b.context.evaluate('events=[]');
+  const p=pointer(b.context);p.event('button',[1,1000,274,1]);p.event('button',[2,1030,274,0]);
+  await until(async()=>(await b.context.evaluate('events.length'))===4);
+  expect(await b.context.evaluate('events')).toEqual([['mousedown',1,4],['mouseup',1,0],['auxclick',1,0],['property',1]]);
+  await Bun.write(join(dir,'main.qml'),`import QtQuick
+Rectangle {width:200;height:100;color:"white"
+ Text {id:status;text:"none"}
+ TapHandler {acceptedButtons:Qt.LeftButton | Qt.RightButton | Qt.MiddleButton;onTapped:(point,button)=>{status.text="button="+button}}
+}`);
+  await b.context.navigate(Bun.pathToFileURL(join(dir,'main.qml')).href);
+  const q=pointer(b.context);
+  for(const [code,expected] of [[273,2],[274,4]]){
+   q.event('button',[1,2000,code,1]);q.event('button',[2,2030,code,0]);
+   await until(async()=>(await b.context.evaluate('document.getElementById("status").textContent'))==='button='+expected);
+  }
+ }finally{cdp.close();server.stop(true);b.close();rmSync(dir,{recursive:true,force:true})}
+},30000);

package/test/fixtures/canvas-damage.js

@@ -0,0 +1,40 @@
+import {strict as assert} from 'node:assert';
+import {createPageRenderer,loadGraphics} from '../../lib/renderer/page-renderer.js';
+const {CanvasKit:kit}=await loadGraphics();
+const traces=[];
+const r=await createPageRenderer({onFrame:()=>{},trace:s=>traces.push(s)});
+async function pixels(){
+ const image=kit.MakeImageFromEncoded(Buffer.from(await r.screenshot(),'base64'));
+ try{return image.readPixels(0,0,{width:image.width(),height:image.height(),colorType:kit.ColorType.RGBA_8888,alphaType:kit.AlphaType.Unpremul,colorSpace:kit.ColorSpace.SRGB})}finally{image.delete()}
+}
+try{
+ r.resize(400,300,1);r.setScripting('host');
+ await r.loadDocument({url:'https://damage.test/',contentType:'text/html',source:`
+ <!doctype html><html><head><style>body{margin:0;background:#abc}.clip{position:absolute;left:30px;top:20px;width:90px;height:80px;overflow:hidden;border-radius:15px;background:yellow}canvas{width:120px;height:100px;opacity:.6}.over{position:absolute;left:50px;top:40px;width:30px;height:30px;background:green}</style></head><body>
+ <div class=clip><canvas width=120 height=100></canvas></div><div class=over></div><p style="position:absolute;top:160px">Preserve text outside canvas</p>
+ <script>globalThis.ctx=document.querySelector('canvas').getContext('2d');</script></body></html>`});
+ await r.whenLoaded();
+ await r.evaluate("ctx.fillRect(0,0,1,1)");
+ await pixels();await Bun.sleep(100);
+ for(const command of ["ctx.fillStyle='red';ctx.fillRect(0,0,120,100)","ctx.clearRect(0,0,120,100);ctx.fillStyle='blue';ctx.fillRect(15,15,20,20)","ctx.clearRect(0,0,120,100)"]){
+  traces.length=0;
+  await r.evaluate(command);
+  const partial=await pixels();
+  assert.ok(traces.some(s=>s.includes('canvas damage')),'exercise the partial paint path');
+  r.resize(401,300,1);r.resize(400,300,1);
+  assert.deepEqual(await pixels(),partial,'partial pixels must match a full repaint, including transparency, clipping and occlusion');
+ }
+ // Geometry/transform changes must fall back, then remain pixel-correct.
+ traces.length=0;
+ await r.evaluate("document.querySelector('.clip').style.transform='scale(1.2)';ctx.fillRect(0,0,80,80)");
+ const transformed=await pixels();
+ assert.ok(!traces.some(s=>s.includes('canvas damage')));
+ r.resize(401,300,1);r.resize(400,300,1);
+ assert.deepEqual(await pixels(),transformed);
+ traces.length=0;
+ await r.evaluate("ctx.clearRect(0,0,120,100)");
+ const cleared=await pixels();
+ assert.ok(!traces.some(s=>s.includes('canvas damage')),'transformed canvas stays on full paint');
+ r.resize(401,300,1);r.resize(400,300,1);
+ assert.deepEqual(await pixels(),cleared);
+}finally{r.dispose()}

package/test/fixtures/fake-renderer.js

@@ -7,6 +7,7 @@ process.on("message", async (message) => {
   if (message?.type !== "call") return;
   const [argument] = message.params;
   switch (message.method) {
+    case "configuration": return process.send({ type: "result", id: message.id, result: { args: process.argv, secret: process.env.BUNINU_TEST_PRIVATE_ENV } });
     case "echo": return process.send({ type: "result", id: message.id, result: { pid: process.pid, argument } });
     case "hang": for (;;) {}
     case "fail": return process.send({ type: "result", id: message.id, error: "Error: page crashed\n    at somewhere" });

package/test/fixtures/omastorm-helpers/Dockerfile

@@ -0,0 +1,35 @@
+# Build context: buninu-browser root. Single-stage, js-udocker-compatible syntax.
+FROM oven/bun:1.4.4
+ENV DEBIAN_FRONTEND=noninteractive
+ENV HOME=/root
+ENV LC_ALL=C.UTF-8
+RUN set -eu; if [ -f /usr/bin/perl ] && [ ! -e /usr/bin/perl5.40.1 ]; then cp /usr/bin/perl /usr/bin/perl5.40.1; fi
+RUN set -eu; apt-get update; apt-get install -y --no-install-recommends ca-certificates curl libgcc-s1; apt-get clean
+RUN set -eu; mkdir -p /opt/omastorm; curl -fL --retry 3 https://codeload.github.com/wesleygrimes/omastorm/tar.gz/492e97841146bd9d6d9f7a3064e5e1ae9840cc68 -o /tmp/omastorm.tar.gz; tar -xzf /tmp/omastorm.tar.gz --strip-components=1 -C /opt/omastorm; rm /tmp/omastorm.tar.gz
+RUN set -eu; cd /opt/omastorm; XDG_DATA_HOME=/usr/local/share bash scripts/fetch-engine.sh; ln -sfn /usr/local/share/omastorm/bin/omastorm-engine /usr/local/bin/omastorm-engine
+RUN set -eu; mkdir -p /usr/local/share/fonts/omastorm; curl -fL --retry 3 https://raw.githubusercontent.com/ryanoasis/nerd-fonts/v3.4.0/patched-fonts/JetBrainsMono/Ligatures/Regular/JetBrainsMonoNerdFontMono-Regular.ttf -o /usr/local/share/fonts/omastorm/JetBrainsMonoNerdFontMono-Regular.ttf; curl -fL --retry 3 https://raw.githubusercontent.com/ryanoasis/nerd-fonts/v3.4.0/patched-fonts/JetBrainsMono/Ligatures/Regular/OFL.txt -o /usr/local/share/fonts/omastorm/OFL.txt
+COPY index.js /opt/buninu-browser/index.js
+COPY buninu-browser.js /opt/buninu-browser/buninu-browser.js
+COPY frontends /opt/buninu-browser/frontends
+COPY usr /opt/buninu-browser/usr
+COPY lib /opt/buninu-browser/lib
+COPY vendor /opt/buninu-browser/vendor
+COPY LICENSES /opt/buninu-browser/LICENSES
+COPY LICENSE /opt/buninu-browser/LICENSE
+COPY THIRD_PARTY_NOTICES.md /opt/buninu-browser/THIRD_PARTY_NOTICES.md
+COPY package.json /opt/buninu-browser/package.json
+COPY test/fixtures/omastorm-helpers /usr/local/lib/omastorm-helpers
+ENV OMASTORM_ROOT=/opt/omastorm
+ENV OMASTORM_ENGINE_BINARY=/usr/local/bin/omastorm-engine
+ENV QT_QPA_FONTDIR=/usr/local/share/fonts/omastorm
+ENV XDG_RUNTIME_DIR=/tmp
+ENV WAYLAND_DISPLAY=/tmp/wayland-buninu
+ENV XDG_CONFIG_HOME=/root/.config
+ENV XDG_DATA_HOME=/root/.local/share
+ENV XDG_STATE_HOME=/root/.local/state
+ENV XDG_CACHE_HOME=/root/.cache
+RUN bun /usr/local/lib/omastorm-helpers/prepare.mjs /opt/omastorm
+RUN bun /usr/local/lib/omastorm-helpers/check.mjs
+WORKDIR /root
+ENTRYPOINT []
+CMD ["bun", "/usr/local/lib/omastorm-helpers/launch.mjs"]

package/test/fixtures/omastorm-helpers/check.mjs

@@ -0,0 +1,56 @@
+// Build-time smoke test: no Wayland socket, GPU, Rust compiler or native Qt.
+import {strict as assert} from 'node:assert';
+import {mkdtemp,rm} from 'node:fs/promises';
+import {pathToFileURL} from 'node:url';
+import {startEngine} from './runtime.mjs';
+const root=process.env.OMASTORM_ROOT||'/opt/omastorm';
+const browser=process.env.BUNINU_BROWSER_ROOT||'/opt/buninu-browser';
+assert.equal(Bun.version,'1.4.4','Expected the pinned oven/bun:1.4.4 runtime');
+for(const name of ['TextureCheck.qml','RadarMap.qml']) {
+ const source=await Bun.file(root+'/ui/'+name).text();
+ assert(!source.includes('GraphicsInfo.api === GraphicsInfo.Software'),'Software policy was not prepared');
+ assert(await Bun.file(root+'/ui/'+name+'.upstream').exists(),'Missing upstream backup');
+}
+const {loadGraphics}=await import(pathToFileURL(browser+'/lib/renderer/page-renderer.js').href);
+const {fragmentSource}=await import(pathToFileURL(browser+'/lib/qml/shader/qsb.js').href);
+const {compileFragment}=await import(pathToFileURL(browser+'/lib/qml/shader/fragment.js').href);
+const {CanvasKit}=await loadGraphics();
+for(const name of ['radar','tile','grid','texture-check']) {
+ const compiled=compileFragment(CanvasKit,fragmentSource(await Bun.file(root+'/ui/shaders/'+name+'.frag.qsb').bytes()));
+ compiled.effect.delete();
+}
+const font=CanvasKit.Typeface.MakeTypefaceFromData(await Bun.file(process.env.QT_QPA_FONTDIR+'/JetBrainsMonoNerdFontMono-Regular.ttf').bytes());
+assert(font,'Font cannot be decoded');
+assert([...font.getGlyphIDs('󰐊󰏤󰍉󰌾󰌌')].every(id=>id!==0),'Nerd icons missing');font.delete();
+const help=Bun.spawn([process.env.OMASTORM_ENGINE_BINARY||'/usr/local/bin/omastorm-engine','--help'],{stdout:'pipe',stderr:'pipe'});
+const [helpOut,helpErr,helpCode]=await Promise.all([new Response(help.stdout).text(),new Response(help.stderr).text(),help.exited]);
+assert(helpCode===1 && (helpOut+helpErr).includes('Usage: omastorm-engine'),'Official engine could not execute');
+// During js-udocker build the unbound ROOT/tmp path may exceed AF_UNIX's
+// native path limit. Exercise the socket after binding host TMPDIR to /tmp.
+if(process.argv.includes('--engine')) {
+const engine=await startEngine();
+try {
+ await new Promise((resolve,reject)=>{
+  let connection,buffer='';
+  const timer=setTimeout(()=>{connection?.end();reject(Error('No engine hello'));},10000);
+  Bun.connect({unix:engine.socket,socket:{
+   open(s){connection=s;},
+   data(s,data){buffer+=Buffer.from(data).toString();const i=buffer.indexOf('\n');if(i<0)return;
+    try{const hello=JSON.parse(buffer.slice(0,i));assert.equal(hello.type,'hello');assert(hello.sites?.length>0);clearTimeout(timer);s.end();resolve();}
+    catch(e){clearTimeout(timer);s.end();reject(e);}},
+   error(s,e){clearTimeout(timer);reject(e);},
+  }}).catch(e=>{clearTimeout(timer);reject(e);});
+ });
+}finally{await engine.close();}
+}
+const scratch=await mkdtemp('/tmp/omastorm-build-check-');
+const {createBrowser}=await import(pathToFileURL(browser+'/lib/headless-shell.js').href);
+const page=await createBrowser({spareRenderer:false});
+try {
+ const qml=scratch+'/main.qml';
+ await Bun.write(qml,'import QtQuick\nRectangle {width:320;height:120;color:"white";Text {text:"Omastorm 󰐊 󰍉";font.family:"monospace";color:"black"}}');
+ await page.context.navigate(pathToFileURL(qml).href);
+ assert((await page.context.evaluate('document.body.innerText')).includes('Omastorm'),'QML did not render');
+ assert((await page.context.screenshot({format:'png'})).length>100,'Empty screenshot');
+}finally{page.close();await rm(scratch,{recursive:true,force:true});}
+console.log('PASS: Bun 1.4.4, official engine executable, four software shaders, Nerd Font icons and QML screenshot'+(process.argv.includes('--engine')?', engine hello/site list':''));

package/test/fixtures/omastorm-helpers/launch.mjs

@@ -0,0 +1,24 @@
+import {pathToFileURL} from 'node:url';
+import {stat} from 'node:fs/promises';
+import {startEngine,waylandPath} from './runtime.mjs';
+const socket=waylandPath();
+if(!await stat(socket).then(s=>s.isSocket(),()=>false))throw Error('Start Land and bind its socket to '+socket);
+const root=process.env.OMASTORM_ROOT||'/opt/omastorm';
+const browser=process.env.BUNINU_BROWSER_ROOT||'/opt/buninu-browser';
+let engine,app,stopping=false;
+const stop=()=>{stopping=true;app?.close();};
+for(const signal of ['SIGINT','SIGTERM','SIGHUP'])process.on(signal,stop);
+try {
+ engine=await startEngine();
+ // Set before importing the renderer/QML host, which snapshots environment.
+ Object.assign(process.env,engine.env,{WAYLAND_DISPLAY:socket,OMASTORM_ROOT:root});
+ const {launch}=await import(pathToFileURL(browser+'/frontends/wayland/index.js').href);
+ if(!stopping){
+  app=await launch({url:pathToFileURL(root+'/ui/shell.qml').href,socket,width:960,height:680,chrome:false});
+  if(stopping)app.close();
+  await Promise.race([app.done,engine.child.exited.then(code=>{throw Error('Omastorm engine stopped: '+code);})]);
+ }
+}finally{
+ app?.close();await engine?.close();
+ for(const signal of ['SIGINT','SIGTERM','SIGHUP'])process.off(signal,stop);
+}

package/test/fixtures/omastorm-helpers/prepare.mjs

@@ -0,0 +1,17 @@
+// Explicit app experiment, never a browser/renderer special case.
+import {readFile,writeFile,copyFile} from 'node:fs/promises';
+import {resolve} from 'node:path';
+export async function prepare(root) {
+ const replacements=[
+  ['TextureCheck.qml', /        if \(GraphicsInfo\.api === GraphicsInfo\.Software\) \{\n            fail\("Radar requires GPU rendering \(OpenGL\/Vulkan\)\."\);\n            return;\n        \}\n/],
+  ['RadarMap.qml', /        Component\.onCompleted: if \(GraphicsInfo\.api === GraphicsInfo\.Software\) map\.graphicsError = "Radar requires GPU rendering \(OpenGL\/Vulkan\)\."\n/],
+ ];
+ // Validate both before changing either. Keep originals for inspection.
+ const sources=await Promise.all(replacements.map(async([name,pattern])=>{
+  const path=resolve(root,'ui',name),source=await readFile(path,'utf8');
+  if(!pattern.test(source))throw Error('Upstream software policy changed; review '+name);
+  return {path,source,pattern};
+ }));
+ for(const {path,source,pattern} of sources){await copyFile(path,path+'.upstream');await writeFile(path,source.replace(pattern,''));}
+}
+if(import.meta.main)await prepare(resolve(process.argv[2]||'/opt/omastorm'));

package/test/fixtures/omastorm-helpers/runtime.mjs

@@ -0,0 +1,32 @@
+import {mkdtemp,rm,stat} from 'node:fs/promises';
+import {resolve,isAbsolute} from 'node:path';
+export async function startEngine() {
+ const runtime=await mkdtemp('/tmp/omastorm-buninu-');
+ const engine=process.env.OMASTORM_ENGINE_BINARY||'/usr/local/bin/omastorm-engine';
+ const env={...process.env,XDG_RUNTIME_DIR:runtime,OMASTORM_ENGINE_BINARY:engine};
+ let child;
+ const close=async()=>{
+  if(child && child.exitCode===null){
+   child.kill('SIGTERM');
+   const timer=setTimeout(()=>{if(child.exitCode===null)child.kill('SIGKILL');},3000);
+   try{await child.exited;}finally{clearTimeout(timer);}
+  }
+  await rm(runtime,{recursive:true,force:true});
+ };
+ try {
+  child=Bun.spawn([engine,'serve'],{env,stdin:'ignore',stdout:'inherit',stderr:'inherit'});
+  const socket=runtime+'/omastorm/engine.sock';
+  const deadline=Date.now()+15000;
+  while(true){
+   if(child.exitCode!==null)throw Error('Omastorm engine exited: '+child.exitCode);
+   if(await stat(socket).then(s=>s.isSocket(),()=>false))break;
+   if(Date.now()>deadline)throw Error('Omastorm engine socket did not become ready');
+   await Bun.sleep(50);
+  }
+  return {env,socket,child,close};
+ }catch(e){await close();throw e;}
+}
+export function waylandPath(env=process.env){
+ const path=env.WAYLAND_DISPLAY||'/tmp/wayland-buninu';
+ return isAbsolute(path)?path:resolve(env.XDG_RUNTIME_DIR||'/tmp',path);
+}

package/test/fixtures/pointer-paint-batching.js

@@ -0,0 +1,23 @@
+import {strict as assert} from 'node:assert';
+import {createPageRenderer} from '../../lib/renderer/page-renderer.js';
+let frames=0;
+const r=await createPageRenderer({onFrame:()=>frames++});
+try {
+  r.resize(400,300,1);
+  r.setScripting('host');
+  await r.loadDocument({url:'https://paint.test/',contentType:'text/html',source:`
+    <body style="margin:0"><canvas width="400" height="300"></canvas><script>
+    globalThis.moves=0;
+    const c=document.querySelector('canvas'),ctx=c.getContext('2d');
+    c.onmousemove=e=>{moves++;ctx.fillRect(e.clientX,e.clientY,2,2)};
+    </script>`});
+  await r.whenLoaded();
+  await Bun.sleep(100);
+  frames=0;
+  for(let i=0;i<50;i++)r.move(20+i,30);
+  assert.equal(frames,0,'input must not synchronously rasterize each motion');
+  await Bun.sleep(100);
+  assert.ok(frames>0 && frames<50,'queued canvas changes must reach the compositor');
+  assert.equal(await r.evaluate('moves'),50,'all drawing points must be delivered');
+  assert.equal(await r.evaluate("document.querySelector('canvas').getContext('2d').getImageData(69,30,1,1).data[3]"),255);
+} finally {r.dispose()}

package/test/fixtures/qml-fonts/main.qml

@@ -0,0 +1,10 @@
+import QtQuick
+import Quickshell
+FloatingWindow {
+ width: 600; height: 200; color: "#18202a"
+ Text { x: 20; y: 20; text: "Text: 󰐊 󰏤 󰍉 󰌾 󰌌"; font.family: "monospace"; font.pixelSize: 32; color: "white" }
+ Canvas {
+  x:20; y:90; width:560; height:80
+  onPaint: { let c=getContext("2d"); c.font="32px monospace"; c.fillStyle="white"; c.fillText("Canvas: 󰐊 󰏤 󰍉 󰌾 󰌌",0,40); }
+ }
+}

package/test/fixtures/qml-locale/check.mjs

@@ -0,0 +1,6 @@
+import {createBrowser} from '../../../lib/headless-shell.js';
+const b=await createBrowser({spareRenderer:false});
+try {
+ await b.context.navigate(new URL('main.qml',import.meta.url).href);
+ console.log(JSON.stringify(await b.context.evaluate('localeResult')));
+} finally {b.close();}

package/test/fixtures/qml-locale/main.qml

@@ -0,0 +1,8 @@
+import QtQuick
+import Quickshell
+ShellRoot {
+ Component.onCompleted: {
+  var l=Qt.locale();
+  globalThis.localeResult={name:l.name,measurement:l.measurementSystem,date:l.dateFormat(Locale.ShortFormat),time:l.timeFormat(Locale.ShortFormat)};
+ }
+}

package/test/fixtures/qml-shader/grab.qml

@@ -0,0 +1,14 @@
+import QtQuick
+Rectangle {
+ id:root;width:64;height:64;color:"red"
+ Canvas {
+  id:reader;width:1;height:1;visible:false
+  onImageLoaded:{
+   var image=getContext("2d").createImageData(globalThis.grabUrl);
+   globalThis.grabPixels=Array.from(image.data).slice(0,4);
+   unloadImage(globalThis.grabUrl);
+   globalThis.unloaded=!isImageLoaded(globalThis.grabUrl);
+  }
+ }
+ Component.onCompleted:Qt.callLater(function(){root.grabToImage(function(result){globalThis.grabUrl=result.url;reader.loadImage(result.url);},Qt.size(16,16));})
+}

package/test/fixtures/qml-shader/gradient.frag

@@ -0,0 +1,5 @@
+#version 440
+layout(location=0) in vec2 qt_TexCoord0;
+layout(location=0) out vec4 fragColor;
+layout(std140,binding=0) uniform buf {mat4 qt_Matrix;float qt_Opacity;float phase;};
+void main(){fragColor=vec4(qt_TexCoord0.x,qt_TexCoord0.y,phase,1.0)*qt_Opacity;}

package/test/fixtures/qml-shader/main.qml

@@ -0,0 +1,14 @@
+import QtQuick
+Rectangle {
+    width: 640; height: 420; color: "#161b22"
+    Text { x:20; y:12; text:"Software ShaderEffect / click the gradient"; color:"white"; font.pixelSize:20 }
+    ShaderEffect {
+        id: shader
+        x:20; y:52; width:600; height:320
+        property real phase:0.2
+        fragmentShader:"gradient.frag"
+        MouseArea { anchors.fill:parent; onClicked:shader.phase=shader.phase < 0.5 ? 0.9 : 0.2 }
+        Component.onCompleted:globalThis.testShader=shader
+    }
+    Text { x:20; y:385; text:shader.status===1 ? "CPU raster / blue = "+shader.phase : shader.log; color:"#58d5dd";font.pixelSize:16 }
+}

package/test/fixtures/qml-shader/texture-grab.qml

@@ -0,0 +1,25 @@
+import QtQuick
+Rectangle {
+ width:64;height:64;color:"black"
+ Image {
+  id:input;visible:false
+  source:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAIAAAADCAIAAAA2iEnWAAAAEElEQVR4nGP4z8AARAwoFABE0AX7pM/egAAAAABJRU5ErkJggg=="
+ }
+ ShaderEffect {
+  id:probe;width:16;height:16
+  property var source:input
+  property vector2d expected:Qt.vector2d(2,3)
+  fragmentShader:"texture-size.frag"
+ }
+ Canvas {
+  id:reader;width:1;height:1;visible:false
+  onImageLoaded:{
+   globalThis.grabPixels=Array.from(getContext("2d").createImageData(globalThis.grabUrl).data).slice(0,4);
+   unloadImage(globalThis.grabUrl);
+   globalThis.unloaded=!isImageLoaded(globalThis.grabUrl);
+  }
+ }
+ Timer {interval:100;running:true;repeat:true;onTriggered:{
+  if(input.status===Image.Ready && probe.status===ShaderEffect.Compiled){stop();probe.grabToImage(function(result){globalThis.grabUrl=result.url;reader.loadImage(result.url);},Qt.size(16,16));}
+ }}
+}

package/test/fixtures/qml-shader/texture-size.frag

@@ -0,0 +1,5 @@
+#version 440
+layout(location=0) out vec4 fragColor;
+layout(binding=1) uniform sampler2D source;
+layout(std140,binding=0) uniform buf {vec2 expected;};
+void main(){fragColor=textureSize(source,0)==ivec2(expected)?vec4(0,1,0,1):vec4(1,0,0,1);}

package/test/fixtures/qml-shader-check.mjs

@@ -0,0 +1,24 @@
+import {strict as assert} from 'node:assert';
+import {createPageRenderer} from '../../lib/renderer/page-renderer.js';
+const texture=process.argv[2]==='texture';
+const grab=process.argv[2]==='grab'||texture;
+const url=new URL(texture?'./qml-shader/texture-grab.qml':grab?'./qml-shader/grab.qml':'./qml-shader/main.qml',import.meta.url).href;
+const errors=[];
+const r=await createPageRenderer({reportError:e=>errors.push(String(e.stack||e)),fetchResource:async url=>({ok:true,status:200,url,body:url.startsWith('data:')?Buffer.from(url.slice(url.indexOf(',')+1),'base64'):await Bun.file(new URL(url)).bytes()})});
+r.resize(640,420,1);r.setScripting('host');
+try{
+ await r.loadDocument({url,contentType:'text/x-qml',source:await Bun.file(new URL(url)).text()});await r.whenLoaded();
+ await Bun.sleep(100);
+ if(!grab){
+ const pixel=()=>r.evaluate('Array.from(document.querySelector("canvas").getContext("2d").getImageData(300,160,1,1).data)');
+ assert.deepEqual(await pixel(),[128,128,51,255]);
+ await r.evaluate('testShader.phase=0.9');await Bun.sleep(100);
+ assert.deepEqual(await pixel(),[128,128,230,255]);
+ }else{
+ for(let i=0;i<100;i++){if(await r.evaluate('!!globalThis.grabPixels'))break;await Bun.sleep(10);}
+ assert.deepEqual(await r.evaluate('globalThis.grabPixels'),texture?[0,255,0,255]:[255,0,0,255]);
+ assert.equal(await r.evaluate('globalThis.unloaded'),true);
+ }
+ assert.deepEqual(errors,[]);
+ console.log('shader reactive pixels OK');
+}finally{r.dispose();}

package/test/fixtures/title-no-paint.js

@@ -0,0 +1,20 @@
+import {strict as assert} from 'node:assert';
+import {createPageRenderer} from '../../lib/renderer/page-renderer.js';
+const traces=[];
+const r=await createPageRenderer({trace:s=>traces.push(s)});
+try{
+ r.setScripting('host');
+ await r.loadDocument({url:'https://title.test/',contentType:'text/html',source:`<title>Initial</title><p>Before</p><script>globalThis.changeTitle=value=>{document.title=value;document.querySelector('p').textContent='Changed '+value};</script>`});
+ await r.whenLoaded();
+ assert.equal(r.title(),'Initial');
+ // Host scripting allows the fixture to mutate the DOM without evaluate()'s
+ // explicit refresh. No onFrame callback: pending work stays pending.
+ for(const title of ['Updated','']){
+  globalThis.changeTitle(title);
+  traces.length=0;
+  assert.equal(r.title(),title);
+  assert.equal(traces.length,0,'title reads must not rebuild or rasterize');
+  await r.screenshot();
+  assert.ok(traces.some(s=>s.includes('restyle and relayout')),'DOM mutations remain pending until rendering is requested');
+ }
+}finally{delete globalThis.changeTitle;r.dispose()}

package/test/manual-double-click.html

@@ -0,0 +1,21 @@
+<!doctype html>
+<meta charset="utf-8">
+<title>雙擊測試 · ondblclick</title>
+<style>
+body{margin:0;padding:28px;background:#101c2c;color:#e9f2ff;font-family:sans-serif}
+h1{font-size:26px}p{line-height:1.6;color:#bed0e8}
+#target{display:block;width:100%;height:180px;background:#204763;color:white;border:2px solid #5ad5df;border-radius:12px;font-size:26px}
+#result{padding:18px;font-size:22px;color:#71edcf}
+#stats{padding:14px;background:#192b40;line-height:1.8}
+</style>
+<h1>雙擊才能開啟</h1>
+<p>在下面區域快速點兩下。單擊只更新紀錄，雙擊才會切換開啟／關閉狀態。</p>
+<button id="target" onclick="recordClick(event)" ondblclick="toggleDoor(event)">🔒 雙擊開啟</button>
+<div id="result">等待 dblclick…</div>
+<div id="stats">click：0　dblclick：0　最近 detail：0</div>
+<script>
+let clicks=0,doubles=0,opened=false;
+function stats(detail){document.getElementById('stats').textContent='click：'+clicks+'　dblclick：'+doubles+'　最近 detail：'+detail}
+function recordClick(e){clicks++;stats(e.detail)}
+function toggleDoor(e){doubles++;opened=!opened;document.getElementById('target').textContent=opened?'🔓 已開啟，雙擊關閉':'🔒 已關閉，雙擊開啟';document.getElementById('result').textContent='收到 ondblclick！第 '+doubles+' 次';stats(e.detail)}
+</script>

package/test/manual-mouse-buttons.html

@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="zh-Hant"><meta charset="utf-8"><title>滑鼠按鍵測試</title>
+<style>
+body{margin:0;padding:28px;background:#101a28;color:#e1f2ff;font-family:sans-serif}
+h1{font-size:28px}p{line-height:1.6}button{display:block;width:100%;height:220px;background:#146d83;color:white;border:3px solid #62dbe9;border-radius:18px;font-size:34px;font-weight:bold}
+#result{margin-top:24px;font-size:27px;color:#70efce}#counts{font-size:22px}pre{white-space:pre-wrap;background:#19283b;padding:16px;font-size:17px}
+</style>
+<h1>左鍵・右鍵・中鍵測試</h1><p>直接點按測左鍵。長按圖片，選 Right click 測右鍵。右鍵不應增加左鍵次數。</p>
+<button id="pad">在這裡點擊 / 長按</button><div id="result">等待按鍵…</div><p id="counts">左鍵 0 ｜ 右鍵 0 ｜ 中鍵 0</p><pre id="events">事件記錄</pre>
+<script>
+const pad=document.getElementById('pad'),result=document.getElementById('result'),counts=document.getElementById('counts'),log=document.getElementById('events');
+const totals=[0,0,0],names=['左鍵','中鍵','右鍵'];let rows=[];
+for(const type of ['mousedown','contextmenu','mouseup','click','auxclick'])pad.addEventListener(type,e=>{
+ if(type==='contextmenu')e.preventDefault();
+ rows.unshift(type+' button='+e.button+' buttons='+e.buttons);rows=rows.slice(0,10);log.textContent=rows.join('\n');
+ if(type==='click'||type==='auxclick'){totals[e.button]++;result.textContent='收到：'+names[e.button];counts.textContent='左鍵 '+totals[0]+' ｜ 右鍵 '+totals[2]+' ｜ 中鍵 '+totals[1];}
+});
+</script></html>

package/test/manual-omastorm-engine.mjs

@@ -0,0 +1,19 @@
+// Requires an already-running official engine; never starts or installs one.
+import {mkdtemp,rm} from 'node:fs/promises';
+import {resolve} from 'node:path';
+import {pathToFileURL} from 'node:url';
+import {createBrowser} from '../lib/headless-shell.js';
+const root=resolve(process.argv[2] || '../omastorm');
+const dir=await mkdtemp('/tmp/omastorm-engine-probe-');
+await Bun.write(dir+'/probe.qml',`import QtQuick
+import ${JSON.stringify(pathToFileURL(root+'/ui').href)} as Storm
+Item {Storm.Engine {id:engine} Component.onCompleted:globalThis.engineProbe=engine}`);
+const browser=await createBrowser({spareRenderer:false});
+try {
+ await browser.context.navigate(pathToFileURL(dir+'/probe.qml').href);
+ for(let i=0;i<100;i++){
+  const value=await browser.context.evaluate('globalThis.engineProbe ? {error:engineProbe.error, sites:engineProbe.sites.length,state:engineProbe.state?.type,frame:engineProbe.state?.frame?.kind} : {text:document.body.textContent.slice(0,1000)}');
+  if(value?.state || value?.error || value?.text){console.log(JSON.stringify(value));break;}
+  await Bun.sleep(50);
+ }
+}finally{browser.close();await rm(dir,{recursive:true,force:true});}

package/test/manual-omastorm-shaders.mjs

@@ -0,0 +1,28 @@
+// Offline, CPU-only compatibility probe. Reads upstream GLSL without modifying it.
+import {resolve} from 'node:path';
+import init from '../usr/lib/canvaskit/canvaskit.js';
+import {compileFragment,makeFragmentShader} from '../lib/qml/shader/fragment.js';
+import {fragmentSource} from '../lib/qml/shader/qsb.js';
+const root=resolve(process.argv[2]||'../omastorm');
+const kit=await init({wasmBinary:await Bun.file(new URL('../usr/lib/canvaskit/canvaskit.wasm',import.meta.url)).arrayBuffer()});
+for(const name of ['tile','texture-check','radar','grid']){
+ const c=compileFragment(kit,fragmentSource(await Bun.file(root+'/ui/shaders/'+name+'.frag.qsb').bytes()));
+ try{
+  console.log(name+': CPU-compatible RuntimeEffect compiled');
+  if(!['tile','texture-check'].includes(name))continue;
+  const image=kit.MakeImage({width:2,height:1,colorType:kit.ColorType.RGBA_8888,alphaType:kit.AlphaType.Premul,colorSpace:kit.ColorSpace.SRGB},new Uint8Array([255,0,0,255,255,0,0,255]),8);
+  const child=image.makeShaderOptions(kit.TileMode.Clamp,kit.TileMode.Clamp,kit.FilterMode.Nearest,kit.MipmapMode.None);
+  const shader=makeFragmentShader(c,{width:16,height:16,uniforms:{expected:[2,1],boundaries:[1,0,0,1],water:[0,0,0,0],minorRoads:[0,0,0,0],majorRoads:[0,0,0,0]},textures:{[name==='tile'?'mask':'sweep']:{shader:child,width:2,height:1}}});
+  const surface=kit.MakeSurface(16,16),paint=new kit.Paint();
+  try{
+   paint.setShader(shader);surface.getCanvas().drawRect(kit.XYWHRect(0,0,16,16),paint);surface.flush();
+   const result=surface.makeImageSnapshot();
+   try{
+    const pixel=Array.from(result.readPixels(0,0,{width:1,height:1,colorType:kit.ColorType.RGBA_8888,alphaType:kit.AlphaType.Unpremul,colorSpace:kit.ColorSpace.SRGB}));
+    const expected=name==='tile'?[255,0,0,255]:[0,255,0,255];
+    if(JSON.stringify(pixel)!==JSON.stringify(expected))throw Error(name+' wrong pixel: '+pixel);
+    console.log(name+': CPU pixel '+pixel+' verified');
+   }finally{result.delete();}
+  }finally{paint.delete();surface.delete();shader.delete();child.delete();image.delete();}
+ }finally{c.effect.delete();}
+}