buninu-browser 0.3.0 → 0.5.0

package/test/fixtures/flea-helpers/check-highlighting.mjs

@@ -0,0 +1,47 @@
+// Exercise the official backend, including bat path validation, sandbox and SGR parsing.
+import cases from './highlight-cases.json' with {type:'json'};
+import {mkdir,realpath} from 'node:fs/promises';
+const base='/root/flea-demo/code';
+await mkdir(base,{recursive:true});
+if(!(await realpath('/usr/local/bin/bat')).startsWith('/usr/'))throw Error('Flea requires bat realpath under /usr');
+const p=Bun.spawn(['/usr/bin/flea','--backend'],{stdin:'pipe',stdout:'pipe',stderr:'pipe'});
+const errors=new Response(p.stderr).text();
+let pending,token=0;
+const reader=(async()=>{
+ let buffer='';const decoder=new TextDecoder();
+ for await(const chunk of p.stdout){
+  buffer+=decoder.decode(chunk,{stream:true});let i;
+  while((i=buffer.indexOf('\n'))>=0){
+   const line=buffer.slice(0,i);buffer=buffer.slice(i+1);
+   const msg=JSON.parse(line);if(msg.t==='code'&&msg.token===token)pending?.(msg);
+  }
+ }
+})();
+async function ask(params){
+ token++;
+ let timer;
+ try{return await new Promise((resolve,reject)=>{
+  pending=resolve;timer=setTimeout(()=>reject(Error('Timed out: '+JSON.stringify(params))),15000);
+  p.stdin.write(JSON.stringify({c:'code',token,slot:'verify',first:1,count:400,...params})+'\n');
+ });}finally{clearTimeout(timer);pending=null;}
+}
+let checks=0;
+try{
+ for(const sample of cases){
+  const path=base+'/'+sample.name;await Bun.write(path,sample.text);
+  for(const query of [{path},{text:sample.text,name:sample.name,lang:sample.lang}]){
+   const result=await ask(query);
+   const colored=result.lines?.some(line=>line.some((v,i)=>i%2===0&&v>0));
+   if(result.state!=='styled'||!colored)throw Error(`${sample.name} (${query.path?'file':sample.lang}): ${JSON.stringify(result)}`);
+   const text=result.lines.map(line=>line.filter((_,i)=>i%2===1).join('')).join('\n');
+   if(text!==sample.text.trimEnd())throw Error('Text changed: '+sample.name);
+   checks++;
+  }
+ }
+ const plain=await ask({text:'plain text\n',name:'sample.unknown',lang:'not-a-real-language'});
+ if(plain.state!=='plain')throw Error('Unknown language must fall back to plain text');
+ console.log(`PASS: official Flea colored ${cases.length} formats, ${checks} file/language requests; unknown language falls back to plain`);
+}finally{
+ p.stdin.write('{"c":"quit"}\n');p.stdin.end();await p.exited;await reader;
+ const stderr=await errors;if(stderr)console.error(stderr);
+}

package/test/fixtures/flea-helpers/check-media.mjs

@@ -0,0 +1,29 @@
+// Real Flea media component, decoder and host PulseAudio connection.
+import {createBrowser} from '/opt/buninu-browser/lib/headless-shell.js';
+import {PulseClient} from '/opt/buninu-browser/lib/audio/pulse-client.js';
+import {mkdtemp,rm} from 'node:fs/promises';
+const dir=await mkdtemp('/tmp/flea-media-check-');
+Object.assign(process.env,{HOME:dir,XDG_CONFIG_HOME:dir+'/config',XDG_CACHE_HOME:dir+'/cache',QML_IMPORT_PATH:'/usr/share/omarchy',FLEA_BIN:'/usr/bin/flea',FLEA_PATH:'/root/flea-demo'});
+let b;
+try{
+ const pulse=await Promise.race([PulseClient.connect(),Bun.sleep(5000).then(()=>{throw Error('Pulse connection timeout')})]);
+ console.log('Pulse connected');pulse.close();
+ b=await createBrowser({spareRenderer:false});
+ await b.context.addInitScript(`globalThis.players=[];globalThis.panes=[];let rt;Object.defineProperty(globalThis,'__qmlRuntime',{get:()=>rt,set:r=>{rt=r;const d=r.describe;r.describe=(v,t,...a)=>{if(t.includes('Pane'))panes.push(v);if(t.includes('MediaPlayer'))players.push(v);return d(v,t,...a)}}});`);
+ await b.context.navigate('file:///usr/share/flea/ui/boot/shell.qml');
+ await Bun.sleep(1500);
+ await b.context.press('2',{code:'Digit2',modifiers:2});
+ await Bun.sleep(300);
+ const point=await b.context.evaluate(`(()=>{const e=[...document.querySelectorAll('[data-qml-type=Text]')].find(e=>e.textContent==='tone.mp3'&&e.getBoundingClientRect().width>0);const r=e.getBoundingClientRect();return [r.x+r.width/2,r.y+r.height/2]})()`);
+ await b.context.click(...point);await Bun.sleep(500);
+ console.log('before',await b.context.evaluate(`panes.map(p=>({mode:p.viewMode,path:p.previewColumnItem?.path,visible:p.previewColumnItem?.visible,allowed:p.previewColumnItem?.playerAllowed}))`));
+ await b.context.evaluate(`panes[0].previewColumnItem.mediaStripItem().toggled()`);
+
+ for(let i=0;i<8;i++){
+  await Bun.sleep(400);
+  console.log('column',await b.context.evaluate(`panes.map(p=>({wants:p.previewColumnItem?.wantsPlayback,loaded:p.previewColumnItem?.playerLoaded(),playing:p.previewColumnItem?.mediaPlaying(),position:p.previewColumnItem?.mediaPosition()}))`));
+  console.log(await b.context.evaluate(`players.map(p=>({source:p.source,error:p.error,message:p.errorString,position:p.position,duration:p.duration,state:p.playbackState,volume:p.audioOutput?.volume,muted:p.audioOutput?.muted}))`));
+ }
+}finally{b?.close();await rm(dir,{recursive:true,force:true});}
+
+process.exit(0);

package/test/fixtures/flea-helpers/check-preview.mjs

@@ -0,0 +1,27 @@
+// Actual Flea UI + backend, isolated settings, without changing the user's Land.
+import {mkdtemp,rm} from 'node:fs/promises';
+import {createBrowser} from '/opt/buninu-browser/lib/headless-shell.js';
+const dir=await mkdtemp('/tmp/flea-color-ui-');
+Object.assign(process.env,{HOME:dir,XDG_CONFIG_HOME:dir+'/config',XDG_CACHE_HOME:dir+'/cache',XDG_DATA_HOME:dir+'/data',XDG_STATE_HOME:dir+'/state',QML_IMPORT_PATH:'/usr/share/omarchy',FLEA_BIN:'/usr/bin/flea',FLEA_PATH:'/root/flea-demo'});
+let browser;
+try{
+ browser=await createBrowser({spareRenderer:false,rendererTimeout:30000});
+ await browser.context.resize(900,600);
+ await browser.context.addInitScript(`globalThis.codeReaders=[];let rt;Object.defineProperty(globalThis,'__qmlRuntime',{get:()=>rt,set:r=>{rt=r;const d=r.describe;r.describe=(v,t,...a)=>{if(t.includes('CodeLines'))codeReaders.push(v);return d(v,t,...a)}}});`);
+ await browser.context.navigate('file:///usr/share/flea/ui/boot/shell.qml');
+ async function waitFor(expression){for(let i=0;i<200;i++){if(await browser.context.evaluate(expression))return;await Bun.sleep(50)}throw Error('UI timeout: '+expression);}
+ await waitFor(`document.body.innerText.includes('hello.js')`);
+ for(const [name,text] of [['sample.jsonl','{"answer":42}\n'],['sample.html','<html><body><h1>Hello</h1></body></html>\n']])await Bun.write('/root/flea-demo/'+name,text);
+ for(const name of ['hello.js','sample.jsonl','sample.html']){
+ await waitFor(`document.body.innerText.includes(${JSON.stringify(name)})`);
+ const point=await browser.context.evaluate(`(()=>{const e=[...document.querySelectorAll('[data-qml-type=Text]')].find(e=>e.textContent===${JSON.stringify(name)}&&e.getBoundingClientRect().width>0);const r=e.getBoundingClientRect();return [r.x+r.width/2,r.y+r.height/2]})()`);
+ await browser.context.click(...point);
+ await browser.context.press(' ',{code:'Space'});
+ if(name.endsWith('.html')){await Bun.sleep(800);await browser.context.press('r',{code:'KeyR'});}
+ if(name.endsWith('.html')) await waitFor(`Array.from(document.querySelectorAll('[data-qml-type=Text]')).some(e=>e.textContent.includes('<html>')&&Array.from(e.querySelectorAll('span')).some(s=>s.style.color))`);
+ else await waitFor(`codeReaders.some(v=>v.active&&v.path.endsWith(${JSON.stringify(name)})&&v.answer==='styled'&&Object.values(v.held).some(l=>l.some((r,i)=>i%2===0&&r>0)))`);
+ await Bun.write('/tmp/flea-js-preview.png',Buffer.from(await browser.context.screenshot({format:'png'}),'base64'));
+ console.log('PASS: official Flea UI preview styled: '+name);
+ await browser.context.press('Escape',{code:'Escape'});
+ }
+}catch(error){await Bun.write('/tmp/flea-html-preview.png',Buffer.from(await browser.context.screenshot({format:'png'}),'base64'));console.error(await browser.context.evaluate(`({text:document.body.innerText,html:Array.from(document.querySelectorAll('[data-qml-type=Text]')).filter(e=>e.textContent.includes('<html>')).map(e=>e.innerHTML),readers:codeReaders.map(v=>({active:v.active,path:v.path,answer:v.answer}))})`));throw error;}finally{browser?.close();await rm(dir,{recursive:true,force:true});}

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

@@ -0,0 +1,36 @@
+// Build smoke test: actual tools, real Flea backend, no compositor required.
+import {mkdtemp,rm} from 'node:fs/promises';
+const assert=(ok,message)=>{if(!ok)throw Error(message);};
+async function run(args,input='',env={}){
+ const p=Bun.spawn(args,{env:{...process.env,PATH:'/usr/local/bin:/usr/bin:/bin',...env},stdin:'pipe',stdout:'pipe',stderr:'pipe'});
+ p.stdin.write(input);
+ p.stdin.end();
+ const [out,err,code]=await Promise.all([new Response(p.stdout).text(),new Response(p.stderr).text(),p.exited]);
+ assert(code===0,`${args.join(' ')} exited ${code}: ${err}`);return out;
+}
+assert(Bun.version==='1.4.4',`Expected Bun 1.4.4, got ${Bun.version}`);
+assert(await Bun.file('/usr/share/mime/globs2').exists(),'Missing MIME database');
+assert(await Bun.file('/usr/share/omarchy/qs/Commons/Style.qml').exists(),'Missing Omarchy Commons');
+const ansi=await run(['bat','--color=always','--style=plain','--paging=never','--file-name=sample.js','-'],'const answer = 42;\n');
+assert(ansi.includes('\x1b[')&&Bun.stripANSI(ansi).includes('const answer = 42;'),'bat adapter did not highlight input');
+await run([process.execPath,new URL('./check-highlighting.mjs',import.meta.url).pathname]).then(text=>process.stdout.write(text));
+const cache=await mkdtemp('/tmp/flea-build-check-');
+try{
+ const out=await run(['/usr/bin/flea','--backend'],[
+  {c:'list',path:'/root/flea-demo',first:20},{c:'thumb',rows:[0,1,2]},{c:'quit'}
+ ].map(x=>JSON.stringify(x)+'\n').join(''),{XDG_CACHE_HOME:cache});
+ const replies=out.trim().split('\n').map(x=>JSON.parse(x));
+ const thumb=replies.find(x=>x.t==='thumbed'&&x.file);
+ assert(thumb,'Flea did not accept placeholder thumbnail: '+out);
+ assert((await Bun.file(thumb.file).bytes()).subarray(1,4).toString()==='80,78,71','Invalid PNG');
+ const {createBrowser}=await import('/opt/buninu-browser/lib/headless-shell.js');
+ const page=await createBrowser({spareRenderer:false});
+ try {
+  const qml=cache+'/check.qml';
+  await Bun.write(qml,'import QtQuick\nRectangle {width:320;height:120;color:"white";Text {text:"Flea QML ready";color:"black"}}');
+  await page.context.navigate(Bun.pathToFileURL(qml).href);
+  assert((await page.context.evaluate('document.body.innerText')).includes('Flea QML ready'),'QML runtime did not render text');
+  assert((await page.context.screenshot({format:'png'})).length>100,'QML screenshot is empty');
+ } finally {page.close();}
+ console.log('PASS: Bun 1.4.4, MIME, Omarchy imports, jsmdcui ANSI and official Flea thumbnail backend, QML rendering');
+}finally{await rm(cache,{recursive:true,force:true});}

package/test/fixtures/flea-helpers/highlight-cases.json

@@ -0,0 +1,227 @@
+[
+  {
+    "name": "sample.js",
+    "lang": "js",
+    "text": "const answer = 42; // comment\n"
+  },
+  {
+    "name": "sample.mjs",
+    "lang": "JavaScript",
+    "text": "export const answer = 42;\n"
+  },
+  {
+    "name": "sample.cjs",
+    "lang": "node",
+    "text": "const answer = require(\"fs\");\n"
+  },
+  {
+    "name": "sample.jsx",
+    "lang": "jsx",
+    "text": "const answer = 42;\n"
+  },
+  {
+    "name": "sample.ts",
+    "lang": "ts",
+    "text": "const answer: number = 42;\n"
+  },
+  {
+    "name": "sample.tsx",
+    "lang": "tsx",
+    "text": "const answer: number = 42;\n"
+  },
+  {
+    "name": "sample.mts",
+    "lang": "typescript",
+    "text": "export const answer: number = 42;\n"
+  },
+  {
+    "name": "sample.py",
+    "lang": "python3",
+    "text": "def answer():\n    return 42 # comment\n"
+  },
+  {
+    "name": "sample.sh",
+    "lang": "bash",
+    "text": "#!/bin/sh\necho \"$HOME\" # comment\n"
+  },
+  {
+    "name": "sample.zsh",
+    "lang": "zsh",
+    "text": "#!/bin/zsh\necho \"$HOME\"\n"
+  },
+  {
+    "name": "sample.fish",
+    "lang": "fish",
+    "text": "echo \"$HOME\"\n"
+  },
+  {
+    "name": "sample.json",
+    "lang": "json",
+    "text": "{\"answer\":42,\"ok\":true}\n"
+  },
+  {
+    "name": "sample.jsonc",
+    "lang": "jsonc",
+    "text": "{\"answer\":42} // comment\n"
+  },
+  {
+    "name": "sample.json5",
+    "lang": "json5",
+    "text": "{\"answer\":42}\n"
+  },
+  {
+    "name": "sample.jsonl",
+    "lang": "jsonl",
+    "text": "{\"answer\":42}\n"
+  },
+  {
+    "name": "sample.yaml",
+    "lang": "yml",
+    "text": "answer: 42 # comment\n"
+  },
+  {
+    "name": "sample.toml",
+    "lang": "toml",
+    "text": "answer = 42 # comment\n"
+  },
+  {
+    "name": "sample.ini",
+    "lang": "ini",
+    "text": "[section]\nanswer = 42\n"
+  },
+  {
+    "name": ".env",
+    "lang": "dotenv",
+    "text": "ANSWER=\"hello\" # comment\n"
+  },
+  {
+    "name": "sample.html",
+    "lang": "HTML",
+    "text": "<div class=\"hello\">world</div>\n"
+  },
+  {
+    "name": "sample.xml",
+    "lang": "xml",
+    "text": "<hello answer=\"42\"/>\n"
+  },
+  {
+    "name": "sample.css",
+    "lang": "css",
+    "text": "body { color: red; margin: 42px; }\n"
+  },
+  {
+    "name": "sample.scss",
+    "lang": "css",
+    "text": "body { color: red; }\n"
+  },
+  {
+    "name": "sample.sql",
+    "lang": "sql",
+    "text": "SELECT * FROM users WHERE id = 42;\n"
+  },
+  {
+    "name": "sample.c",
+    "lang": "c",
+    "text": "int main(void) { return 42; }\n"
+  },
+  {
+    "name": "sample.cpp",
+    "lang": "cpp",
+    "text": "int main() { return 42; }\n"
+  },
+  {
+    "name": "sample.cs",
+    "lang": "c#",
+    "text": "public class Hello { int answer = 42; }\n"
+  },
+  {
+    "name": "sample.go",
+    "lang": "golang",
+    "text": "package main\nfunc main() { println(42) }\n"
+  },
+  {
+    "name": "sample.rs",
+    "lang": "rs",
+    "text": "fn main() { let answer = 42; }\n"
+  },
+  {
+    "name": "sample.java",
+    "lang": "java",
+    "text": "public class Hello { int answer = 42; }\n"
+  },
+  {
+    "name": "sample.kt",
+    "lang": "kt",
+    "text": "val answer = 42\n"
+  },
+  {
+    "name": "sample.rb",
+    "lang": "rb",
+    "text": "def answer\n  return 42\nend\n"
+  },
+  {
+    "name": "sample.php",
+    "lang": "php",
+    "text": "<?php echo \"hello\"; ?>\n"
+  },
+  {
+    "name": "sample.lua",
+    "lang": "lua",
+    "text": "local answer = 42 -- comment\n"
+  },
+  {
+    "name": "sample.pl",
+    "lang": "perl",
+    "text": "my $answer = 42; # comment\n"
+  },
+  {
+    "name": "sample.ps1",
+    "lang": "pwsh",
+    "text": "$answer = \"hello\" # comment\n"
+  },
+  {
+    "name": "sample.bat",
+    "lang": "cmd",
+    "text": "@echo off\nset ANSWER=42\nREM comment\n"
+  },
+  {
+    "name": "Dockerfile",
+    "lang": "docker",
+    "text": "FROM debian:13\nRUN echo hello\n"
+  },
+  {
+    "name": "Makefile",
+    "lang": "make",
+    "text": "all:\n\techo \"hello\" # comment\n"
+  },
+  {
+    "name": "CMakeLists.txt",
+    "lang": "cmake",
+    "text": "set(ANSWER 42) # comment\n"
+  },
+  {
+    "name": "sample.md",
+    "lang": "md",
+    "text": "# Heading\n**bold** and `code`\n"
+  },
+  {
+    "name": "sample.diff",
+    "lang": "diff",
+    "text": "--- a/file\n+++ b/file\n@@ -1 +1 @@\n-old\n+new\n"
+  },
+  {
+    "name": "sample.tf",
+    "lang": "tf",
+    "text": "variable \"answer\" { default = 42 }\n"
+  },
+  {
+    "name": "sample.vue",
+    "lang": "vue",
+    "text": "<template><div class=\"hello\">Hello</div></template>\n"
+  },
+  {
+    "name": "sample.svelte",
+    "lang": "svelte",
+    "text": "<script>const answer = 42;</script>\n"
+  }
+]

package/test/fixtures/flea-helpers/source-mime.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
+  <!-- Low priority: retain the distribution's more specific MIME definitions. -->
+  <mime-type type="text/x-buninu-source">
+    <comment>Source code</comment>
+    <sub-class-of type="text/plain"/>
+    <generic-icon name="text-x-script"/>
+    <glob pattern="*.jsonl" weight="10"/>
+    <glob pattern="*.ndjson" weight="10"/>
+    <glob pattern="*.jsonc" weight="10"/>
+    <glob pattern="*.json5" weight="10"/>
+    <glob pattern="*.jsx" weight="10"/>
+    <glob pattern="Dockerfile" weight="10"/>
+    <glob pattern="*.cjs" weight="10"/>
+    <glob pattern="*.ini" weight="10"/>
+    <glob pattern="*.mts" weight="10"/>
+    <glob pattern="*.cts" weight="10"/>
+    <glob pattern="*.vue" weight="10"/>
+    <glob pattern="*.svelte" weight="10"/>
+  </mime-type>
+  <!-- TSX is ambiguous: prefer TypeScript JSX over Debian's Tiled tileset rule (50). -->
+  <mime-type type="text/x-buninu-tsx">
+    <comment>TypeScript JSX source</comment>
+    <sub-class-of type="text/plain"/>
+    <generic-icon name="text-x-script"/>
+    <glob pattern="*.tsx" weight="60"/>
+  </mime-type>
+</mime-info>

package/test/fixtures/flea-helpers/syntax-compat.mjs

@@ -0,0 +1,23 @@
+// jsmdcui 0.19.2's Micro rules contain Go regex flags/boundaries unsupported by JS.
+// Adapt those rule objects locally; do not modify the installed npm package.
+export function adaptSyntaxRules(definitions, SyntaxDefinition) {
+ function compile(pattern, original) {
+  if(typeof pattern!=='string'||!(/\(\?[ims]+\)|\\[<>]/.test(pattern)))return original;
+  const flags=new Set();
+  const source=pattern.replace(/\(\?([ims]+)\)/g,(_,letters)=>{for(const flag of letters)flags.add(flag);return '';})
+   .replaceAll('\\<','\\b(?=\\w)').replaceAll('\\>','(?<=\\w)\\b');
+  const regex=new SyntaxDefinition({}, {rules:[{compat:source}]}).rules[0]?.regex;
+  if(!regex)return original;
+  try{return new RegExp(regex.source,[...new Set([...regex.flags,...flags])].join(''));}catch{return original;}
+ }
+ function visit(rules) {
+  for(const rule of rules){
+   if(rule.type==='pattern')rule.regex=compile(rule.source,rule.regex);
+   if(rule.type==='region'){
+    for(const key of ['start','end','skip'])rule[key]=compile(rule.source?.[key],rule[key]);
+    visit(rule.rules);
+   }
+  }
+ }
+ for(const definition of definitions)visit(definition.rules);
+}

package/test/fixtures/flea-thumbnail-stub/flea-placeholder.thumbnailer

@@ -0,0 +1,4 @@
+[Thumbnailer Entry]
+TryExec=/usr/local/bin/flea-thumbnail-stub
+Exec=/usr/local/bin/flea-thumbnail-stub %i %o %s
+MimeType=video/mp4;video/webm;video/x-matroska;video/quicktime;video/x-msvideo;video/mpeg;video/ogg;

package/test/fixtures/flea-thumbnail-stub/flea-thumbnail-stub

@@ -0,0 +1,3 @@
+#!/bin/sh
+# Placeholder only: every video gets the same opaque PNG. Args: input output size.
+printf '%s' 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGMwsHAAAAFEAKn1rVKOAAAAAElFTkSuQmCC' | /usr/bin/base64 -d > "$2"

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/flea/EscapeHint.qml

@@ -0,0 +1,11 @@
+import QtQuick
+
+// The word that closes a surface, in the corner every surface puts it in: Dialogs rule 7, and the
+// spelling ui/SettingsPanel.qml already uses, so no two dialogs can name the way out differently.
+Text {
+    text: "esc"
+    color: Theme.color.muted
+    font.family: Theme.font.family
+    font.pixelSize: Theme.font.caption
+    textFormat: Text.PlainText
+}