buninu-browser 0.4.0 → 0.5.0

package/test/manual-omastorm-software.mjs

@@ -0,0 +1,25 @@
+// Explicit experiment: copy the application and remove only its GPU policy.
+// Does not alter the checkout, fake GraphicsInfo, or bypass shader/pixel checks.
+import {mkdtemp,cp,readFile,writeFile} from 'node:fs/promises';
+import {resolve} from 'node:path';
+import {tmpdir} from 'node:os';
+const root=resolve(process.argv[2]||'../omastorm');
+const directory=await mkdtemp(resolve(tmpdir(),'omastorm-software-'));
+await cp(root+'/ui',directory+'/ui',{recursive:true});
+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/],
+];
+for(const [file,pattern] of replacements){
+ const path=directory+'/ui/'+file,source=await readFile(path,'utf8');
+ if(!pattern.test(source))throw Error('Upstream policy changed; review '+file+' before modifying it');
+ await writeFile(path,source.replace(pattern,''));
+}
+console.log('Software test copy: '+directory);
+console.log('Original engine must already be running in XDG_RUNTIME_DIR/omastorm.');
+if(process.argv.includes('--prepare-only'))process.exit(0);
+const child=Bun.spawn([process.execPath,new URL('../lib/qml/qswayland',import.meta.url).pathname,'-p',directory+'/ui/shell.qml'],{
+ env:{...process.env,OMASTORM_ROOT:root},stdin:'inherit',stdout:'inherit',stderr:'inherit',
+});
+for(const signal of ['SIGINT','SIGTERM','SIGHUP'])process.on(signal,()=>child.kill(signal));
+process.exitCode=await child.exited;

package/test/manual-pointer-scroll.html

@@ -0,0 +1,43 @@
+<!doctype html>
+<html lang="zh-Hant">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>滑鼠與捲動測試</title>
+<style>
+*{box-sizing:border-box}body{margin:0;padding:16px;background:#101923;color:#e4edf5;font:16px sans-serif}h1{font-size:24px}h2{font-size:18px;margin:10px 0}section{padding:14px;margin:16px 0;background:#1c2a38;border:1px solid #446079;border-radius:8px}button,textarea{font:inherit}button{padding:10px;margin:4px;background:#bcebea;color:#102c35;border:0;border-radius:4px}code,pre{font:13px monospace}pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:240px;overflow:auto}p{line-height:1.5}.box{width:100%;height:220px;border:2px solid #69c7dd;background:#172431}.v{overflow-x:hidden;overflow-y:auto}.h{overflow-x:auto;overflow-y:hidden}.both{overflow:auto}.wide{width:1800px;height:180px;background:linear-gradient(90deg,#375f8b,#426e4d,#9c4f49);padding:20px}.plane{width:1800px;height:1200px;background:repeating-linear-gradient(0deg,transparent,transparent 99px,#7cabc4 100px),repeating-linear-gradient(90deg,#263d52,#263d52 99px,#7cabc4 100px);padding:20px}.row{padding:18px;border-bottom:1px solid #436479}.readout{color:#8de1e8;margin:8px 0}#target{display:block;width:100%;min-height:100px;background:#286a75;color:white}canvas{display:block;width:100%;height:220px;background:#f5fafb;touch-action:none}textarea{width:100%;height:110px}label{display:block;margin:8px 0}
+</style>
+<h1>滑鼠與捲動測試</h1>
+<p>各區獨立捲動。先把游標放在指定區域再操作，觀察位置與事件紀錄。Shift／Ctrl／Alt／Super 是否到達頁面取決於外層終端與系統；本頁不自行交換滾輪軸向。</p>
+<section><h2>1. 垂直捲動</h2><div class="readout" id="v-state"></div><div id="v" class="box v"></div></section>
+<section><h2>2. 水平捲動</h2><div class="readout" id="h-state"></div><div id="h" class="box h"><div class="wide">左端 0 ← 水平 1800 px → 右端<br><br>試水平手勢或 Shift＋滾輪；若事件仍是 deltaY，請看外層終端是否轉換。</div></div></section>
+<section><h2>3. 雙向捲動</h2><div class="readout" id="both-state"></div><div id="both" class="box both"><div class="plane">左上角 (0, 0) — 每格約 100 px；寬 1800、高 1200。</div></div><button id="reset">重設三區捲動</button></section>
+<section><h2>4. 按鍵、雙擊與修飾鍵</h2><p>此按鈕攔截原生右鍵選單，只在這裡記錄 contextmenu。中鍵不捲頁。可按住修飾鍵再點擊。</p><button id="target">左鍵／右鍵／中鍵／雙擊這裡</button><div id="counts" class="readout"></div></section>
+<section><h2>5. 按住左鍵拖曳畫線</h2><p>手機可雙擊並按住第二下拖曳。放開後再移動不應畫線；也可測移出畫布後放開。按住狀態與座標列在下方。</p><canvas id="paint" width="1000" height="300"></canvas><div id="drag" class="readout">尚未按下</div><button id="clear-paint">清除畫布</button></section>
+<section id="text-selection"><h2>6. 文字選取與編輯</h2><p>這段可拖曳選取：春天的河水流過城市，0123456789，The quick brown fox。</p><textarea>第一行：滑鼠點擊定位，Shift＋方向鍵選取。
+第二行：測試 Ctrl-C／Ctrl-V、原生長按貼上。
+第三行：這裡不自行實作 PRIMARY 選取或中鍵貼上。</textarea></section>
+<section><h2>事件紀錄（最多 40 筆）</h2><label><input id="moves" type="checkbox"> 記錄 mousemove（會產生大量事件）</label><button id="clear-log">清除紀錄</button><pre id="log" aria-live="off"></pre></section>
+<script>
+const $=id=>document.getElementById(id), records=[], counts={left:0,right:0,middle:0,double:0};
+function log(e){const mods=['shiftKey','ctrlKey','altKey','metaKey'].filter(k=>e[k]).map(k=>k.replace('Key','')).join('+')||'-';let msg=e.type+' target='+(e.target.id||e.target.tagName)+' button='+e.button+' buttons='+e.buttons+' xy='+Math.round(e.clientX||0)+','+Math.round(e.clientY||0)+' modifiers='+mods;if(e.type==='wheel')msg+=' delta='+e.deltaX+','+e.deltaY+' mode='+e.deltaMode;if(e.type==='click'||e.type==='dblclick'||e.type==='auxclick')msg+=' detail='+e.detail;records.unshift(msg);records.length=Math.min(40,records.length);$('log').textContent=records.join('\n')}
+for(const type of ['mousedown','mouseup','click','dblclick','auxclick','contextmenu','wheel'])document.addEventListener(type,log,{capture:true,passive:true});
+document.addEventListener('mousemove',e=>{if($('moves').checked)log(e)},{passive:true});
+for(let i=0;i<20;i++){const r=document.createElement('div');r.className='row';r.textContent='垂直第 '+(i+1)+' 列';$('v').appendChild(r)}
+for(const id of ['v','h','both']){const box=$(id),update=()=>{$(id+'-state').textContent='scrollLeft='+Math.round(box.scrollLeft)+' / '+Math.max(0,box.scrollWidth-box.clientWidth)+' · scrollTop='+Math.round(box.scrollTop)+' / '+Math.max(0,box.scrollHeight-box.clientHeight)};box.addEventListener('scroll',update);window.addEventListener('resize',update);update()}
+$('reset').onclick=()=>{for(const id of ['v','h','both']){$(id).scrollLeft=0;$(id).scrollTop=0}};
+const count=()=>{$('counts').textContent='左鍵 '+counts.left+' · 右鍵 '+counts.right+' · 中鍵 '+counts.middle+' · 雙擊 '+counts.double};count();
+$('target').onclick=e=>{if(e.button===0){counts.left++;count()}};
+$('target').oncontextmenu=e=>{e.preventDefault();counts.right++;count()};
+$('target').onauxclick=e=>{e.preventDefault();if(e.button===1){counts.middle++;count()}};
+$('target').onmousedown=e=>{if(e.button===1)e.preventDefault()};
+$('target').ondblclick=()=>{counts.double++;count()};
+const canvas=$('paint'),ctx=canvas.getContext('2d');let drawing=false,last=null;
+const point=e=>{const r=canvas.getBoundingClientRect();return [(e.clientX-r.left)*canvas.width/r.width,(e.clientY-r.top)*canvas.height/r.height]};
+canvas.onmousedown=e=>{if(e.button!==0)return;e.preventDefault();drawing=true;last=point(e);$('drag').textContent='按住左鍵'};
+document.addEventListener('mousemove',e=>{if(!drawing)return;if(!(e.buttons&1)){drawing=false;$('drag').textContent='左鍵已放開';return}const p=point(e);ctx.strokeStyle='#136a8b';ctx.lineWidth=3;ctx.beginPath();ctx.moveTo(...last);ctx.lineTo(...p);ctx.stroke();last=p;$('drag').textContent='拖曳 '+p.map(Math.round).join(',')});
+document.addEventListener('mouseup',e=>{if(e.button===0){drawing=false;$('drag').textContent='左鍵已放開'}});
+window.addEventListener('blur',()=>{drawing=false;$('drag').textContent='失焦，停止畫線'});
+$('clear-paint').onclick=()=>ctx.clearRect(0,0,canvas.width,canvas.height);
+$('clear-log').onclick=()=>{records.length=0;$('log').textContent=''};
+</script>
+</html>

package/test/pointer-drag.test.js

@@ -0,0 +1,104 @@
+import {test,expect} from 'bun:test';
+import {mkdtempSync,rmSync} from 'node:fs';
+import {createBrowser} from '../lib/headless-shell.js';
+import {CdpServer} from '../lib/cdp-server.js';
+import {CDP,launch} from '../tools/browser-lab.js';
+import {WaylandUrlBar} from '../frontends/wayland/urlbar.js';
+
+const source=`<style>body{margin:0}#box{width:300px;height:160px}#a,#b{display:inline-block;width:100px;height:100px}canvas{display:block}</style>
+<div id="box"><span id="a">A</span><span id="b">B</span></div><input id="field" value="hello"><canvas id="paint" width="300" height="100"></canvas>
+<script>
+globalThis.paint=document.getElementById("paint");globalThis.a=document.getElementById("a");globalThis.field=document.getElementById("field");
+globalThis.events=[];globalThis.cancelDown=false;globalThis.cancelPointer=false;
+for(const type of ['pointerdown','mousedown','pointermove','mousemove','pointerup','mouseup','click','auxclick'])document.addEventListener(type,e=>{events.push([type,e.target.id,e.button,e.buttons,e.shiftKey]);if(type==='mousedown'&&cancelDown)e.preventDefault();if(type==='pointerdown'&&cancelPointer)e.preventDefault()});
+let drawing=false;const ctx=paint.getContext('2d');paint.onmousedown=()=>drawing=true;document.addEventListener('mouseup',()=>drawing=false);paint.onmousemove=e=>{if(drawing&&(e.buttons&1)){ctx.fillStyle='red';ctx.fillRect(0,0,20,20)}};
+</script>`;
+async function check(c){
+ await c.send('Page.navigate',{url:'data:text/html,'+encodeURIComponent(source)});
+ for(let i=0;i<200;i++){if(await c.evaluate('!!document.getElementById("paint")'))break;await Bun.sleep(20)}
+ const send=(type,x=20,y=20,extra={})=>c.send('Input.dispatchMouseEvent',{type,x,y,button:'left',buttons:type==='mouseReleased'?0:1,clickCount:1,...extra});
+ await send('mouseMoved',20,20,{buttons:0,button:'none'});await c.evaluate('events=[]');
+ await send('mousePressed',20,20,{modifiers:8});
+ expect(await c.evaluate('events')).toEqual([['pointerdown','a',0,1,true],['mousedown','a',0,1,true]]);
+ await send('mouseMoved',40,40,{modifiers:8});
+ expect((await c.evaluate('events')).slice(-2)).toEqual([['pointermove','a',-1,1,true],['mousemove','a',0,1,true]]);
+ await send('mouseReleased',40,40,{modifiers:8});
+ expect((await c.evaluate('events')).slice(-3)).toEqual([['pointerup','a',0,0,true],['mouseup','a',0,0,true],['click','a',0,0,true]]);
+ // Sibling press/release activates the common ancestor, never the release sibling.
+ await c.evaluate('events=[]');await send('mousePressed');await send('mouseReleased',140,20);
+ expect((await c.evaluate('events')).at(-1)).toEqual(['click','box',0,0,false]);
+ // A disconnected press target cannot activate another element on release.
+ await send('mousePressed');await c.evaluate('a.remove();events=[]');await send('mouseReleased');
+ expect((await c.evaluate('events')).some(e=>e[0]==='click')).toBe(false);
+ // Canceled mousedown must not focus the editor; normal focus happens on press.
+ const rect=await c.evaluate('field.getBoundingClientRect().toJSON()');
+ await c.evaluate('cancelDown=true');await send('mousePressed',rect.x+10,rect.y+8);
+ expect(await c.evaluate('document.activeElement.id')).not.toBe('field');await send('mouseReleased',rect.x+10,rect.y+8);
+ await c.evaluate('cancelDown=false');await send('mousePressed',rect.x+10,rect.y+8);
+ expect(await c.evaluate('document.activeElement.id')).toBe('field');await send('mouseReleased',rect.x+10,rect.y+8);
+ // pointerdown cancellation suppresses compatibility mouse events, not click.
+ await c.evaluate('cancelPointer=true;events=[]');await send('mousePressed',20,20);await send('mouseMoved',30,30);await send('mouseReleased',30,30);
+ expect((await c.evaluate('events')).map(e=>e[0])).toEqual(['pointerdown','pointermove','pointerup','click']);
+ await c.evaluate('cancelPointer=false;events=[]');
+ // The same canvas drawing contract as the manual test, checked before release.
+ const paint=await c.evaluate('paint.getBoundingClientRect().toJSON()');
+ await send('mousePressed',paint.x+20,paint.y+20);await send('mouseMoved',paint.x+40,paint.y+40);
+ expect(await c.evaluate('Array.from(paint.getContext("2d").getImageData(5,5,1,1).data)')).toEqual([255,0,0,255]);
+ await send('mouseReleased',paint.x+40,paint.y+40);await send('mouseMoved',20,20,{buttons:0,button:'none'});
+ expect((await c.evaluate('events')).at(-1)[3]).toBe(0);
+}
+test('CDP real pointer phases preserve dragging, focus and click targets',async()=>{
+ const b=await createBrowser({spareRenderer:false}),server=CdpServer.create(b.context).listen(0),c=new CDP(`ws://127.0.0.1:${server.port}/devtools/browser/cdp-server`);
+ try{await check(c)}finally{c.close();server.stop(true);b.close()}
+},30000);
+test.skipIf(process.env.BUNINU_TEST_CHROMIUM!=='1')('Chromium reference uses the same pointer event contract',async()=>{
+ const dir=mkdtempSync('/tmp/pointer-chromium-');let app;
+ try{app=await launch('chromium',dir);await check(app.cdp)}finally{await app?.stop();rmSync(dir,{recursive:true,force:true})}
+},30000);
+test('Wayland toolbar sends real press and motion before release, including over chrome',async()=>{
+ const b=await createBrowser({spareRenderer:false});const bar=new WaylandUrlBar(b.context,{history:{list:()=>[],add(){}}});
+ try{
+  await b.context.navigate('data:text/html,'+encodeURIComponent(source));
+  await bar.pointerButton(20,bar.height+20,272,1,{clickCount:1});
+  expect((await b.context.evaluate('events')).map(e=>e[0])).toEqual(['pointerdown','mousedown']);
+  await bar.move(40,bar.height+40);
+  expect((await b.context.evaluate('events')).at(-1)[3]).toBe(1);
+  await bar.pointerButton(40,0,272,0,{clickCount:1});
+  await bar.move(40,bar.height+40);
+  expect((await b.context.evaluate('events')).at(-1)[3]).toBe(0);
+  expect(bar.editor.editing).toBe(false);
+ }finally{bar.dispose();b.close()}
+},30000);
+
+test.skipIf(process.env.BUNINU_TEST_WAYLAND!=='1')('real Wayland pointer draws on the unchanged manual test page',async()=>{
+ const {start}=await import('../../buninu-land/compositor.js');
+ const {launch:wayland}=await import('../frontends/wayland/index.js');
+ const dir=mkdtempSync('/tmp/pointer-wayland-'),saved=process.env.XDG_RUNTIME_DIR;
+ process.env.XDG_RUNTIME_DIR=dir;let land,app;
+ const until=async fn=>{for(let n=0;n<200;n++){if(await fn())return;await Bun.sleep(20)}throw Error('Wayland pointer timed out')};
+ try{
+  land=await start(['--remote-debugging-port=0','--window-size=800,700']);
+  app=await wayland({socket:dir+'/wayland-buninu',url:Bun.pathToFileURL(new URL('./manual-pointer-scroll.html',import.meta.url).pathname).href});
+  const c=app.browser.context;
+  await until(()=>land.compositor.wm.renderSurfaces().some(s=>s.pixels));
+  const top=await c.evaluate('document.getElementById("paint").getBoundingClientRect().top');
+  await c.scroll(0,top-100);
+  const rect=await c.evaluate('document.getElementById("paint").getBoundingClientRect().toJSON()');
+  const surface=land.compositor.wm.renderSurfaces().find(s=>s.pixels),origin=land.compositor.wm.origin(surface);
+  const x=origin.x+rect.x+40,y=origin.y+app.toolbar.height+rect.y+40;
+  land.context.dispatchMouseEvent({type:'mouseMoved',x,y});
+  land.context.dispatchMouseEvent({type:'mousePressed',x,y,button:'left',buttons:1});
+  await until(async()=>(await c.evaluate('document.getElementById("drag").textContent'))==='按住左鍵');
+  land.context.dispatchMouseEvent({type:'mouseMoved',x:x+80,y:y+40,button:'left',buttons:1});
+  await until(async()=>await c.evaluate('(()=>{const c=document.getElementById("paint");return c.getContext("2d").getImageData(0,0,c.width,c.height).data.some((v,i)=>i%4===3&&v>0)})()'));
+  land.context.dispatchMouseEvent({type:'mouseReleased',x:x+80,y:y+40,button:'left',buttons:0});
+  await until(async()=>(await c.evaluate('document.getElementById("drag").textContent'))==='左鍵已放開');
+  expect(await c.evaluate('document.getElementById("log").textContent')).toContain('mousedown');
+ }finally{app?.close();land?.close();if(saved===undefined)delete process.env.XDG_RUNTIME_DIR;else process.env.XDG_RUNTIME_DIR=saved;rmSync(dir,{recursive:true,force:true})}
+},30000);
+
+test('pointer bursts preserve drawing points while batching raster work',async()=>{
+ const child=Bun.spawn([process.execPath,new URL('./fixtures/pointer-paint-batching.js',import.meta.url).pathname],{stdout:'pipe',stderr:'pipe'});
+ const [exit,stderr]=await Promise.all([child.exited,new Response(child.stderr).text()]);
+ expect(stderr).toBe('');expect(exit).toBe(0);
+},15000);

package/test/qml-canvas.test.js

@@ -0,0 +1,21 @@
+import {test,expect} from 'bun:test';
+import {RendererHost} from '../lib/renderer/host.js';
+test('QML Canvas paints into HTML canvas and repaints after resize and property changes',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+  await host.start();
+  await host.call('loadDocument',{url:'data:text/x-qml,canvas',contentType:'text/x-qml',source:`import QtQuick
+Canvas {id: c; width:16;height:16;property color ink:"red"
+onInkChanged:requestPaint()
+onPaint:{var ctx=getContext("2d");ctx.reset();ctx.fillStyle=ink;ctx.fillRect(0,0,width,height);globalThis.paints=(globalThis.paints||0)+1;}
+Component.onCompleted:globalThis.canvasObject=c
+}`});
+  await host.call('whenLoaded');
+  for(let i=0;i<100;i++){if(await host.call('evaluate','globalThis.paints>0'))break;await Bun.sleep(10);}
+  expect(await host.call('evaluate','Array.from(document.querySelector("canvas").getContext("2d").getImageData(8,8,1,1).data)')).toEqual([255,0,0,255]);
+  await host.call('evaluate','canvasObject.ink="blue";canvasObject.width=32;canvasObject.requestPaint();canvasObject.requestPaint()');
+  for(let i=0;i<100;i++){if(await host.call('evaluate','document.querySelector("canvas").width===32 && globalThis.paints>1'))break;await Bun.sleep(10);}
+  expect(await host.call('evaluate','Array.from(document.querySelector("canvas").getContext("2d").getImageData(24,8,1,1).data)')).toEqual([0,0,255,255]);
+  expect(await host.call('evaluate','canvasObject.available')).toBe(true);
+ }finally{host.close();}
+},20000);

package/test/qml-connections-timing.test.js

@@ -71,3 +71,25 @@ Rectangle {
   expect(await host.call('evaluate',"Number(document.getElementById('status').textContent)")).toBe(0);
  }finally{host.close()}
 },30000);
+
+test('property Changed.connect synchronizes menu state before same-handler validation',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+  await host.start();
+  await host.call('loadDocument',{url:'data:text/x-qml,menu-validation',contentType:'text/x-qml',source:`import QtQuick
+Rectangle {
+ id:root;width:300;height:200;property int result:-1;property int changes:0
+ property bool preparing:false
+ readonly property bool live:root.preparing || menu.opened
+ Item {id:menu;property bool preparing:false;property bool opened:false;property int count:root.live ? 1 : 0}
+ Component.onCompleted:menu.preparingChanged.connect(function(){root.preparing=menu.preparing;root.changes++})
+ Text {id:status;text:root.result+":"+root.changes+":"+menu.count}
+ onClicked:{menu.preparing=true;root.result=menu.count;menu.preparing=false}
+}`});
+  await host.call('whenLoaded');
+  for(const changes of [2,4,6]){
+   await host.call('evaluate',"document.getElementById('root').click()");
+   expect(await host.call('evaluate',"document.getElementById('status').textContent")).toBe('1:'+changes+':0');
+  }
+ }finally{host.close()}
+},30000);

package/test/qml-controls-window.test.js

@@ -0,0 +1,182 @@
+import {test,expect} from 'bun:test';
+import {RendererHost} from '../lib/renderer/host.js';
+import {qmlWindowConstraints} from '../lib/qml/window-constraints.js';
+test('window constraints normalize and update Wayland size hints',async()=>{
+ const calls=[];let hints=['[360,240]','[200,0]'];
+ const sync=qmlWindowConstraints({request:(...args)=>calls.push(args)},{toplevel:8,surface:6},{url:'file:///test.qml',evaluate:async()=>hints});
+ await sync();await sync();
+ expect(calls).toEqual([[8,'set_min_size',360,240],[8,'set_max_size',360,0],[6,'commit']]);
+ hints=null;await sync();expect(calls.slice(3)).toEqual([[8,'set_min_size',0,0],[8,'set_max_size',0,0],[6,'commit']]);
+});
+test('FloatingWindow minimum size, attached window notifications and Button slots',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+ await host.start();
+ await host.call('loadDocument',{url:'data:text/x-qml,controls',contentType:'text/x-qml',source:`import QtQuick
+import Quickshell
+ShellRoot {
+ FloatingWindow {id:a;minimumSize:Qt.size(1500,1200)
+  Button {id:b;width:100;height:40;padding:5;focusPolicy:Qt.NoFocus
+   contentItem:Text {id:label;text:"hello"}
+   background:Rectangle {id:bg;color:"red"}
+   Window.onWindowChanged:globalThis.changes=(globalThis.changes||0)+1
+  }
+ }
+ FloatingWindow{id:c}
+ Component.onCompleted:{globalThis.a=a;globalThis.b=b;globalThis.c=c;globalThis.label=label;globalThis.bg=bg;}
+}`});
+ await host.call('whenLoaded');
+ expect(await host.call('evaluate','[a.width,a.height]')).toEqual([1500,1200]);
+ expect(await host.call('evaluate','[label.x,label.y,label.width,label.height,bg.width,bg.height,b.activeFocusOnTab]')).toEqual([5,5,90,30,100,40,false]);
+ expect(await host.call('evaluate','b.Window.window===a')).toBe(true);
+ const before=await host.call('evaluate','globalThis.changes');
+ await host.call('evaluate','b.parent=c');await Bun.sleep(20);
+ expect(await host.call('evaluate','b.Window.window===c')).toBe(true);
+ expect(await host.call('evaluate','globalThis.changes')).toBe(before+1);
+ }finally{host.close();}
+},20000);
+
+test('ListModel roles populate required Repeater properties and remain reactive',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+ await host.start();await host.call('loadDocument',{url:'data:text/x-qml,roles',contentType:'text/x-qml',source:`import QtQuick
+Item {
+ ListModel{id:model}
+ Repeater{id:rep;model:model;delegate:Text {required property string key;required property int amount;text:key+amount}}
+ Component.onCompleted:{globalThis.rep=rep;globalThis.rows=model;model.append({key:"a",amount:2});}
+}`});await host.call('whenLoaded');
+ expect(await host.call('evaluate','[rep.count,rep.itemAt(0).text]')).toEqual([1,'a2']);
+ await host.call('evaluate','rows.setProperty(0,"amount",3)');await Bun.sleep(20);
+ expect(await host.call('evaluate','rep.itemAt(0).text')).toBe('a3');
+ }finally{host.close();}
+},20000);
+
+test('nested Loader startup preserves outer property notifications',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+ await host.start();await host.call('loadDocument',{url:'data:text/x-qml,nested-notifications',contentType:'text/x-qml',source:`import QtQuick
+Item {id:root
+ property int counter:0
+ onCounterChanged:globalThis.changes=(globalThis.changes||[]).concat([counter])
+ Loader {sourceComponent:Item {property size dimensions;property real side:dimensions.width;Component.onCompleted:globalThis.initialSide=side}}
+ Component.onCompleted:{globalThis.root=root;counter=1;}
+}`});await host.call('whenLoaded');
+ expect(await host.call('evaluate','globalThis.initialSide')).toBe(0);
+ expect(await host.call('evaluate','globalThis.changes')).toEqual([1]);
+ await host.call('evaluate','root.counter=2');await Bun.sleep(20);
+ expect(await host.call('evaluate','globalThis.changes')).toEqual([1,2]);
+ }finally{host.close();}
+},20000);
+
+import {createQt} from '../lib/qml/builtins.js';
+test('Qt date/time formatting uses local date fields and locale format order',()=>{
+ const qt=createQt(),date=new Date(2024,10,23,17,45,36);
+ expect(qt.formatTime(date,'HH:mm')).toBe('17:45');
+ expect(qt.formatTime(date,'h:mm AP')).toBe('5:45 PM');
+ expect(qt.formatDateTime(date,"yyyy-MM-dd 'at' HH:mm")).toBe('2024-11-23 at 17:45');
+ expect(qt.locale('en_US').measurementSystem).toBe(1);
+ expect(qt.locale('zh_TW').measurementSystem).toBe(0);
+ expect(qt.locale('en_US').dateFormat(1).indexOf('M')).toBeLessThan(qt.locale('en_US').dateFormat(1).indexOf('d'));
+});
+
+test('createObject does not make the owning binding depend on new child state',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+ await host.start();await host.call('loadDocument',{url:'data:text/x-qml,factory-tracking',contentType:'text/x-qml',source:`import QtQuick
+Item {id:root
+ property var child:factory.createObject(root)
+ property Component factory:Component {Item {property int counter:0;property int derived:counter+1;Component.onCompleted:globalThis.created=(globalThis.created||0)+1}}
+ Component.onCompleted:{globalThis.root=root;globalThis.first=child;}
+}`});await host.call('whenLoaded');
+ expect(await host.call('evaluate','globalThis.created')).toBe(1);
+ await host.call('evaluate','first.counter=9');await Bun.sleep(20);
+ expect(await host.call('evaluate','[root.child===first,root.child.derived,globalThis.created]')).toEqual([true,10,1]);
+ }finally{host.close();}
+},20000);
+
+test('Button custom content sizes its RowLayout slot and reacts without a width cycle',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try {
+  await host.start();
+  await host.call('loadDocument',{url:'data:text/x-qml,button-size',contentType:'text/x-qml',source:`import QtQuick
+import QtQuick.Layouts
+import Quickshell
+FloatingWindow {
+ RowLayout { width:500; height:60; spacing:8
+  Button {id:button;padding:4
+   contentItem: RowLayout {spacing:6
+    Rectangle {id:first;implicitWidth:80;implicitHeight:20}
+    Rectangle {implicitWidth:100;implicitHeight:24}
+   }
+   background: Rectangle {implicitWidth:120;implicitHeight:30}
+  }
+  Rectangle {id:next;implicitWidth:30;implicitHeight:30}
+  Item {Layout.fillWidth:true}
+ }
+ Component.onCompleted:{globalThis.button=button;globalThis.first=first;globalThis.next=next;}
+}`});
+  await host.call('whenLoaded');
+  expect(await host.call('evaluate','[button.implicitWidth,button.implicitHeight,button.width,next.x]')).toEqual([194,32,194,202]);
+  await host.call('evaluate','first.implicitWidth=120');await Bun.sleep(20);
+  expect(await host.call('evaluate','[button.implicitWidth,button.width,next.x]')).toEqual([234,234,242]);
+ }finally{host.close();}
+},20000);
+
+test('Layouts retain explicit item dimensions for status dots and palette strips',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try {
+  await host.start();
+  await host.call('loadDocument',{url:'data:text/x-qml,layout-fallback',contentType:'text/x-qml',source:`import QtQuick
+import QtQuick.Layouts
+import Quickshell
+FloatingWindow {
+ RowLayout {id:row;width:300;height:30
+  Rectangle {id:dot;width:8;height:8;radius:4;color:"green"}
+  Item {Layout.fillWidth:true}
+ }
+ ColumnLayout {id:column;y:40;width:300;height:22;spacing:4
+  Rectangle {id:strip;Layout.fillWidth:true;height:6;color:"red"}
+  Item {implicitHeight:12;Layout.fillWidth:true}
+ }
+ GridLayout {y:80;columns:1
+  Rectangle {id:cell;width:11;height:7}
+ }
+ Component.onCompleted:{globalThis.dot=dot;globalThis.strip=strip;globalThis.cell=cell;globalThis.row=row;globalThis.column=column;}
+}`});
+  await host.call('whenLoaded');
+  expect(await host.call('evaluate','[dot.width,dot.height,strip.width,strip.height,cell.width,cell.height]')).toEqual([8,8,300,6,11,7]);
+  await host.call('evaluate','row.width=500;column.width=500');await Bun.sleep(20);
+  expect(await host.call('evaluate','[dot.width,dot.height,strip.width,strip.height]')).toEqual([8,8,500,6]);
+  await host.call('evaluate','row.width=300;column.width=300');await Bun.sleep(20);
+  expect(await host.call('evaluate','[dot.width,dot.height,strip.width,strip.height]')).toEqual([8,8,300,6]);
+ }finally{host.close();}
+},20000);
+
+test('Nested Layout receives explicit size bindings even when the dot starts hidden',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try {
+  await host.start();
+  await host.call('loadDocument',{url:'data:text/x-qml,late-dot',contentType:'text/x-qml',source:`import QtQuick
+import QtQuick.Layouts
+import Quickshell
+FloatingWindow {
+ property bool ready:false
+ id:root
+ ColumnLayout {anchors.fill:parent
+  RowLayout {Layout.fillWidth:true
+   Text {text:"TITLE"}
+   Item {Layout.fillWidth:true}
+   RowLayout {
+    spacing:8
+    Rectangle {id:dot;width:8;height:8;radius:4;visible:root.ready;Layout.alignment:Qt.AlignVCenter;color:"blue"}
+    Text {text:"LIVE"}
+   }
+  }
+ }
+ Component.onCompleted:{globalThis.root=root;globalThis.dot=dot;}
+}`});
+  await host.call('whenLoaded');
+  await host.call('evaluate','root.ready=true');await Bun.sleep(20);
+  expect(await host.call('evaluate','[dot.width,dot.height,dot.visible]')).toEqual([8,8,true]);
+ }finally{host.close();}
+},20000);

package/test/qml-fonts.test.js

@@ -0,0 +1,31 @@
+import {test,expect} from 'bun:test';
+import {mkdtemp,mkdir,copyFile,symlink,rm} from 'node:fs/promises';
+import {tmpdir} from 'node:os';
+import {join} from 'node:path';
+import {loadGraphics} from '../lib/renderer/page-renderer.js';
+import {qmlFontFiles,loadQmlFonts} from '../lib/qml/fonts.js';
+
+test('Qt font directory: recursive, symlink-safe, cached, isolated and invalid-font tolerant',async()=>{
+ const root=await mkdtemp(join(tmpdir(),'qml-fonts-'));
+ try {
+  await mkdir(join(root,'nested'));
+  await copyFile(new URL('../usr/share/fonts/DejaVuSansMono.ttf',import.meta.url),join(root,'nested','Regular.ttf'));
+  await symlink(root,join(root,'nested','cycle'));
+  await symlink(join(root,'nested','Regular.ttf'),join(root,'duplicate.ttf'));
+  await Bun.write(join(root,'invalid.otf'),'not a font');
+  await Bun.write(join(root,'ignored.txt'),'ignore');
+  expect((await qmlFontFiles(root)).length).toBe(2);
+  const base=await loadGraphics(),families=[...base.fontFamilies],warn=[];
+  const qml=await loadQmlFonts(base,m=>warn.push(m),root);
+  expect(qml).not.toBe(base);
+  expect(qml.fontFamilies.length).toBe(families.length+1);
+  expect(base.fontFamilies).toEqual(families);
+  const face=qml.builtinTypefaces.at(-1);
+  expect(face.typeface.getGlyphIDs('A')[0]).toBeGreaterThan(0);
+  expect(face.typeface.getGlyphIDs('\u{f040a}')[0]).toBe(0);
+  expect(warn.length).toBe(1);
+  expect(await loadQmlFonts(base,()=>{},root)).toBe(qml);
+  expect(await loadQmlFonts(base,()=>{},'')).toBe(base);
+  expect(await loadQmlFonts(base,()=>{},join(root,'missing'))).toBe(base);
+ }finally{await rm(root,{recursive:true,force:true});}
+});

package/test/qml-grid-multiline.test.js

@@ -0,0 +1,48 @@
+import {test,expect} from 'bun:test';
+import {RendererHost} from '../lib/renderer/host.js';
+test('GridLayout fills columns and reflows; PathMultiline creates independent SVG subpaths',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+  await host.start();
+  await host.call('loadDocument',{url:'data:text/x-qml,grid',contentType:'text/x-qml',source:`import QtQuick
+import QtQuick.Layouts
+import QtQuick.Shapes
+Item {width:200;height:100
+ GridLayout {id:g;width:200;columns:2;columnSpacing:20;rowSpacing:5
+ Rectangle {id:a;implicitWidth:30;implicitHeight:10;Layout.fillWidth:true}
+ Rectangle {id:b;implicitWidth:30;implicitHeight:20;Layout.fillWidth:true}
+ Rectangle {id:c;implicitWidth:30;implicitHeight:10;Layout.fillWidth:true}
+ }
+ Shape {ShapePath {strokeColor:"red";fillColor:"transparent";PathMultiline {id:p;paths:[[Qt.point(1,2),Qt.point(3,4)],[Qt.point(5,6),Qt.point(7,8)]]}}}
+ Component.onCompleted:{globalThis.g=g;globalThis.cells=[a,b,c];globalThis.pathObject=p;}
+}`});
+  await host.call('whenLoaded');
+  expect(await host.call('evaluate','cells.map(c=>[c.x,c.y,c.width,c.height])')).toEqual([[0,0,90,10],[110,0,90,20],[0,25,90,10]]);
+  expect(await host.call('evaluate','document.querySelector("path").getAttribute("d")')).toBe('M1 2 L3 4 M5 6 L7 8');
+  await host.call('evaluate','g.width=60');
+  await Bun.sleep(20);
+  expect(await host.call('evaluate','cells.map(c=>c.width)')).toEqual([20,20,20]);
+  await host.call('evaluate','g.width=200;g.columns=1;pathObject.paths=[[{x:9,y:10},{x:11,y:12}]]');
+  await Bun.sleep(20);
+  expect(await host.call('evaluate','cells.map(c=>[c.x,c.y,c.width])')).toEqual([[0,0,200],[0,15,200],[0,40,200]]);
+  expect(await host.call('evaluate','document.querySelector("path").getAttribute("d")')).toBe('M9 10 L11 12');
+ }finally{host.close();}
+},20000);
+
+test('nested fill layouts retain intrinsic widths when a parent resizes',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+  await host.start();
+  await host.call('loadDocument',{url:'data:text/x-qml,nested-grid',contentType:'text/x-qml',source:`import QtQuick
+import QtQuick.Layouts
+GridLayout {id:g;width:200;columns:2;columnSpacing:20
+ ColumnLayout {id:a;Layout.fillWidth:true;Rectangle {implicitWidth:30;implicitHeight:10;Layout.fillWidth:true}}
+ ColumnLayout {id:b;Layout.fillWidth:true;Rectangle {implicitWidth:30;implicitHeight:10;Layout.fillWidth:true}}
+ Component.onCompleted:{globalThis.grid=g;globalThis.columns=[a,b]}
+}`});
+  await host.call('whenLoaded');
+  expect(await host.call('evaluate','columns.map(c=>[c.width,c.implicitWidth])')).toEqual([[90,30],[90,30]]);
+  await host.call('evaluate','grid.width=400');await Bun.sleep(20);
+  expect(await host.call('evaluate','columns.map(c=>[c.width,c.implicitWidth])')).toEqual([[190,30],[190,30]]);
+ }finally{host.close();}
+},20000);

package/test/qml-locale.test.js

@@ -0,0 +1,45 @@
+import {test,expect} from 'bun:test';
+import {createQt} from '../lib/qml/builtins.js';
+
+test('C/POSIX locale is metric and uses Qt date order and 24-hour time',()=>{
+ for(const name of ['C','C.UTF-8','POSIX']) {
+  const qt=createQt({LC_ALL:name,LANG:'en_US.UTF-8',LC_TIME:'en_US.UTF-8',LC_MEASUREMENT:'en_US.UTF-8'});
+  const l=qt.locale();
+  expect(l.name).toBe('C');expect(l.measurementSystem).toBe(0);
+  expect(l.dateFormat(1)).toBe('d MM yyyy');expect(l.timeFormat(1)).toBe('HH:mm');
+  expect(qt.locale('en_US.UTF-8').measurementSystem).toBe(1);
+ }
+});
+test('locale categories override LANG but explicit locale ignores environment',()=>{
+ const qt=createQt({LANG:'en_US.UTF-8',LC_TIME:'en_GB.UTF-8',LC_MEASUREMENT:'zh_TW.UTF-8'});
+ expect(qt.locale().name).toBe('en_US');expect(qt.locale().measurementSystem).toBe(0);
+ expect(qt.locale().timeFormat(1)).not.toContain('AP');
+ expect(qt.locale().dateFormat(1).indexOf('d')).toBeLessThan(qt.locale().dateFormat(1).indexOf('M'));
+ expect(qt.locale('en_US').timeFormat(1)).toContain('AP');
+ expect(qt.locale('en_GB').measurementSystem).toBe(2);
+ expect(qt.locale('C').timeFormat(1)).toBe('HH:mm');
+ expect(qt.locale('not_a_valid_locale').name).toBe('C');
+});
+test('empty overrides inherit LANG; unset system defaults to C',()=>{
+ const qt=createQt({LC_ALL:'',LC_TIME:'',LANG:'zh_TW.UTF-8'});
+ expect(qt.locale().name).toBe('zh_TW');expect(qt.locale().measurementSystem).toBe(0);
+ expect(qt.locale().dateFormat(1).indexOf('y')).toBeLessThan(qt.locale().dateFormat(1).indexOf('M'));
+ expect(createQt({}).locale().name).toBe('C');
+ const d=new Date(2024,10,23,17,45,36);
+ expect(createQt({LANG:'C.UTF-8'}).formatTime(d,'HH:mm')).toBe('17:45');
+ expect(createQt({LANG:'C.UTF-8'}).formatDate(d,'MMMM')).toBe('November');
+});
+
+test('local QML host receives locale categories through its host capability',async()=>{
+ for(const [env,expected] of [
+  [{LC_ALL:'C.UTF-8',LANG:'en_US.UTF-8'},{name:'C',measurement:0,date:'d MM yyyy',time:'HH:mm'}],
+  [{LC_ALL:'',LANG:'en_US.UTF-8',LC_MESSAGES:'',LC_TIME:'en_GB.UTF-8',LC_MEASUREMENT:'zh_TW.UTF-8'},null],
+ ]) {
+  const child=Bun.spawn([process.execPath,new URL('./fixtures/qml-locale/check.mjs',import.meta.url).pathname],{env:{...process.env,...env},stdout:'pipe',stderr:'pipe'});
+  const [output,error,code]=await Promise.all([new Response(child.stdout).text(),new Response(child.stderr).text(),child.exited]);
+  expect({code,error}).toEqual({code:0,error:''});
+  const result=JSON.parse(output.trim());
+  if(expected)expect(result).toEqual(expected);
+  else {expect(result.name).toBe('en_US');expect(result.measurement).toBe(0);expect(result.time).toBe('HH:mm');}
+ }
+},15000);

package/test/qml-nonvisual-visible.test.js

@@ -0,0 +1,19 @@
+import {test,expect} from 'bun:test';
+import {mkdtempSync,rmSync} from 'node:fs';
+import {tmpdir} from 'node:os';
+import {join} from 'node:path';
+import {createBrowser} from '../lib/headless-shell.js';
+
+test('dynamic QtObject readonly visible does not abort singleton initialization',async()=>{
+ const dir=mkdtempSync(join(tmpdir(),'qml-nonvisual-'));let browser;
+ try{
+  await Bun.write(join(dir,'qmldir'),'singleton Sound 1.0 Sound.qml\n');
+  await Bun.write(join(dir,'Sound.qml'),'pragma Singleton\nimport QtQuick\nQtObject { property int held: -1; readonly property real gain: held < 0 ? 1 : 0 }');
+  await Bun.write(join(dir,'Panel.qml'),'import QtQuick\nimport "."\nItem { QtObject { id:meta; readonly property bool visible: true; readonly property real gain: Sound.gain } Text { text: "gain="+meta.gain+" visible="+meta.visible } }');
+  await Bun.write(join(dir,'main.qml'),'import QtQuick\nItem { width:200;height:80; Loader { id:loader;source:"Panel.qml" } }');
+  browser=await createBrowser({spareRenderer:false});
+  await browser.context.navigate(Bun.pathToFileURL(join(dir,'main.qml')).href);
+  expect(await browser.context.evaluate('Array.from(document.querySelectorAll("[data-qml-type=Text]")).map(e=>e.textContent).join(" ")')).toContain('gain=1 visible=true');
+  expect(await browser.context.evaluate('Array.from(document.querySelectorAll("[data-qml-type=QtObject]")).every(e=>e.style.display==="none")')).toBe(true);
+ }finally{browser?.close();rmSync(dir,{recursive:true,force:true});}
+},30000);

package/test/qml-shader-runtime.test.js

@@ -0,0 +1,6 @@
+import {test,expect} from 'bun:test';
+for(const mode of ['shader','grab','texture'])test('local QML software canvas: '+mode,async()=>{
+ const child=Bun.spawn([process.execPath,new URL('./fixtures/qml-shader-check.mjs',import.meta.url).pathname,mode],{stdout:'pipe',stderr:'pipe'});
+ const [exit,stdout,stderr]=await Promise.all([child.exited,new Response(child.stdout).text(),new Response(child.stderr).text()]);
+ expect({exit,stderr}).toEqual({exit:0,stderr:''});
+},30000);

package/test/qml-shortcuts.test.js

@@ -0,0 +1,39 @@
+import {test,expect} from 'bun:test';
+import {RendererHost} from '../lib/renderer/host.js';
+test('Instantiator owns Shortcut delegates and deactivation removes keyboard handlers',async()=>{
+ const host=new RendererHost({timeout:20000});
+ try{
+  await host.start();
+  await host.call('loadDocument',{url:'data:text/x-qml,shortcuts',contentType:'text/x-qml',source:`import QtQuick
+import QtQml.Models
+Item {
+ property int hits:0
+ Instantiator {id:inst;model:["Ctrl+L", "Shift+N", "?", "Ctrl+K, Ctrl+C"]
+ delegate:Shortcut {autoRepeat:false;sequence:modelData;onActivated:globalThis.pressed.push(index)}
+ }
+ Shortcut {sequence:"X";onActivated:globalThis.bad=true;onActivatedAmbiguously:globalThis.amb=(globalThis.amb||0)+1}
+ Shortcut {sequence:"X";onActivated:globalThis.bad=true;onActivatedAmbiguously:globalThis.amb=(globalThis.amb||0)+1}
+ Shortcut {id:probe;enabled:false;sequence:"ctrl+l"}
+ Component.onCompleted:{globalThis.pressed=[];globalThis.inst=inst;globalThis.probe=probe;}
+}`});
+  await host.call('whenLoaded');
+  const key=async(key,mods={})=>host.call('evaluate',`document.body.dispatchEvent(new KeyboardEvent('keydown',{key:${JSON.stringify(key)},bubbles:true,cancelable:true,...${JSON.stringify(mods)}}))`);
+  expect(await host.call('evaluate','inst.count')).toBe(4);
+  expect(await host.call('evaluate','probe.portableText')).toBe('Ctrl+L');
+  expect(await host.call('evaluate','inst.objectAt(0).parent===inst')).toBe(true);
+  await key('l',{ctrlKey:true,repeat:true});
+  expect(await host.call('evaluate','pressed')).toEqual([]);
+  await key('x');
+  expect(await host.call('evaluate','[globalThis.amb,!!globalThis.bad]')).toEqual([2,false]);
+  await key('l',{ctrlKey:true});await key('N',{shiftKey:true});await key('?',{shiftKey:true});
+  await key('k',{ctrlKey:true});await key('c',{ctrlKey:true});
+  expect(await host.call('evaluate','pressed')).toEqual([0,1,2,3]);
+  await host.call('evaluate','inst.active=false');
+  await Bun.sleep(20);await key('l',{ctrlKey:true});
+  expect(await host.call('evaluate','inst.count')).toBe(0);
+  expect(await host.call('evaluate','inst.object')).toBe(null);
+  expect(await host.call('evaluate','pressed')).toEqual([0,1,2,3]);
+  await host.call('evaluate','inst.active=true');await Bun.sleep(20);await key('l',{ctrlKey:true});
+  expect(await host.call('evaluate','pressed')).toEqual([0,1,2,3,0]);
+ }finally{host.close();}
+},20000);