bunmicro 0.9.30 → 1.0.0

package/runtime/jsplugins/cdp/cdp.js

@@ -0,0 +1,192 @@
+// No imports needed: `micro` is available as a global.
+
+/*
+
+# JS Plugin Documentation
+
+Available hooks (register with micro.on(hookName, fn)):
+
+  Lifecycle (no args):
+    "preinit"           — before plugins load
+    "init"              — main plugin setup, register commands/actions here
+    "postinit"          — after all plugins loaded
+
+  Buffer events:
+    "onBufferOpen"  (buffer)      — buffer opened (raw BufferModel, not pane adapter)
+    "onBufferClose" (buffer)      — buffer closed (raw BufferModel)
+    "onSetActive"   (bp)          — pane became active (tab switch, close, etc.)
+    "onSave"        (bp)          — buffer saved
+
+  Input events:
+    "onRune"           (bp, ch)   — printable character inserted (ch is the string)
+
+  Cancellable hooks (return false to cancel the action):
+    "preBackspace"     (bp)       — before backspace; return false to block
+    "preInsertNewline" (bp)       — before Enter/newline; return false to block
+
+bp is a pane adapter with:
+  bp.Buf.Line(n)  bp.Buf.LinesNum()  bp.Buf.FileType()
+  bp.Buf.Insert(loc, text)  bp.Buf.Replace(s, e, text)
+  bp.Cursor.X  bp.Cursor.Y  bp.Cursor.Loc  bp.Cursor.HasSelection()
+  bp.Save()  bp.Backspace()  bp.CursorLeft/Right()  bp.InsertNewline()
+
+Flat buffer helpers (all 1-based line numbers, omit → cursor line):
+  micro.getLine(n?)            micro.putLine(text, n?)     micro.delLine(n?)
+  micro.getLines(from?, to?)   micro.getLinesCount()
+  micro.getAllText()           — entire buffer as one string (lines joined by "\n")
+  micro.putAllText(text)       — replace entire buffer content; pushes undo
+  micro.getSelection()         micro.putSelection(text)
+
+Other micro APIs:
+  micro.CurPane()              — returns pane adapter for active pane
+  micro.MakeCommand(name, fn)  — register Ctrl+E command; fn(bp, args[])
+                                 args.raw = full original input string (bypass shellSplit)
+                                 e.g. for command "js 1+1": args.raw = "js 1+1", args.raw.slice(3) = "1+1"
+  micro.RegisterAction(name, fn) — register bindable action
+  micro.TermMessage(msg)       — show msg in editor status row
+  micro.alert(msg)             — suspend editor, print msg, wait for Enter
+  micro.Log(...args)           — console.log passthrough
+  micro.GetOption(name)        micro.SetOption(name, value)
+  micro.cmd.save()             — call any editor command via proxy
+  micro.action.CursorUp()      — run any registered action via proxy
+  micro.shell.CMD(...args)     — run CMD interactively (same as Ctrl-B); async
+                                 e.g. await micro.shell.ls('-l')
+                                      await micro.shell.git('diff', '--stat')
+
+*/
+
+micro.on("init", () => {
+  // Register a custom Ctrl+E command
+  micro.MakeCommand("cdp", async (bp, args) =>
+  {
+    const addrFlag = args.find(a => a.startsWith("--address="))?.slice("--address=".length);
+    const isPublic = args.includes("--public");
+    const port = parseInt(args.find(a => /^\d+$/.test(a))) || parseInt(Bun.env.CDP_PORT) || 9222;
+    const hostname = addrFlag ?? (isPublic ? "0.0.0.0" : "127.0.0.1");
+    const path = bp?.Buf?.Path || "(no path)";
+    
+    if(!micro.cdpContext)
+    {
+      micro.cdpContext={
+        title(){
+          return path;
+        },
+        async evaluate(txt){
+          return await eval(txt);
+        },
+        async navigate(url){
+          await micro.cmd.open('-f', url);
+        },
+        async click(x,y,opt){
+          x=x||1 ; y=y||1 ;
+          await micro.cmd.goto(y+':'+x);
+        },
+        async scroll(dx,dy){
+          const pane = micro.CurPane();
+          if (!pane) return;
+
+          dx = toInteger(dx);
+          dy = toInteger(dy);
+
+          const line = Math.max(1, pane.Cursor.Y + dy + 1);
+          const column = Math.max(1, pane.Cursor.X + dx + 1);
+          await micro.cmd.goto(`${line}:${column}`);
+        },
+        async scrollTo(selector){
+          const pattern = selectorToSearchPattern(selector);
+          await micro.cmd.find(pattern);
+        },
+        goBack(){
+          micro.action.PrevTab();
+        },
+        goForward(){
+          micro.action.NextTab();
+        },
+        async type(text){
+          const bp = micro.CurPane();
+          if (!bp) return;
+          bp.Insert(text);
+        },
+        async press(key, options){
+          const bp = micro.CurPane();
+          if (!bp) return;
+
+          // modifiers bitmask: Alt=1, Ctrl=2, Meta=4, Shift=8
+          const mod = options?.modifiers ?? 0;
+          const ctrl  = !!(mod & 2);
+          const shift = !!(mod & 8);
+
+          if (ctrl) {
+            const ctrlMap = {
+              a: () => micro.action.SelectAll(),
+              c: () => micro.action.Copy(),
+              x: () => micro.action.Cut(),
+              v: () => micro.action.Paste(),
+              z: () => micro.action.Undo(),
+              y: () => micro.action.Redo(),
+              s: () => micro.action.Save(),
+            };
+            const h = ctrlMap[key.toLowerCase()];
+            if (h) await h();
+            return;
+          }
+
+          const arrowAction = shift
+            ? { ArrowUp: 'SelectUp', ArrowDown: 'SelectDown', ArrowLeft: 'SelectLeft', ArrowRight: 'SelectRight' }
+            : { ArrowUp: 'CursorUp', ArrowDown: 'CursorDown', ArrowLeft: 'CursorLeft', ArrowRight: 'CursorRight' };
+
+          const keyMap = {
+            ...arrowAction,
+            Enter:     () => micro.action.InsertNewline(),
+            Backspace: () => micro.action.Backspace(),
+            Delete:    () => micro.action.Delete(),
+            Tab:       () => micro.action.InsertTab(),
+            Escape:    () => micro.action.Escape(),
+            Home:      () => shift ? micro.action.SelectToStartOfLine() : micro.action.StartOfLine(),
+            End:       () => shift ? micro.action.SelectToEndOfLine()   : micro.action.EndOfLine(),
+            PageUp:    () => shift ? micro.action.SelectPageUp()        : micro.action.CursorPageUp(),
+            PageDown:  () => shift ? micro.action.SelectPageDown()      : micro.action.CursorPageDown(),
+          };
+
+          const entry = keyMap[key];
+          if (typeof entry === 'string') {
+            await micro.action[entry]();
+          } else if (typeof entry === 'function') {
+            await entry();
+          } else if (key.length === 1) {
+            bp.Insert(key);
+          }
+        },
+      }
+    
+      let {CdpServer}=await import('./cdp-server.js');
+      
+      micro.cdpPort = port;
+      CdpServer
+        .create(micro.cdpContext)
+        .listen(port, hostname);
+
+      const addr = isPublic ? `0.0.0.0:${port}` : `127.0.0.1:${port}`;
+      micro.TermMessage(`CDP@${addr} server running 伺服器啟動了`)
+
+      //await micro.alert(CdpServer)
+    }  //  server not running
+    else
+    {
+      micro.TermMessage(`CDP@${micro.cdpPort} already running a server 已有伺服器啟動`)
+    }
+
+    
+  });
+  
+})
+
+function selectorToSearchPattern(selector) {
+  const value = String(selector ?? "");
+  return value.startsWith("#") ? value.slice(1) : value;
+}
+
+function toInteger(value) {
+  const number = Number(value);
+  return Number.isFinite(number) ? Math.trunc(number) : 0;
+}

package/src/index.js

@@ -516,6 +516,8 @@ function parseArgs(argv) {
     debug: false,
     profile: false,
     plugin: "",
+    cdpPort: 0,
+    cdpAddress: "",
     settings: new Map(),
   };
   const files = [];
@@ -532,7 +534,15 @@ function parseArgs(argv) {
     else if (arg === "-profile") flags.profile = true;
     else if (arg === "-config-dir") flags.configDir = argv[++i] ?? "";
     else if (arg === "-plugin") flags.plugin = argv[++i] ?? "";
-    else if (arg.startsWith("-") && arg.length > 1 && i + 1 < argv.length) {
+    else if (arg.startsWith("--remote-debugging-port=")) {
+      flags.cdpPort = parseInt(arg.slice("--remote-debugging-port=".length)) || 9222;
+    } else if (arg === "--remote-debugging-port") {
+      flags.cdpPort = parseInt(argv[++i]) || 9222;
+    } else if (arg.startsWith("--remote-debugging-address=")) {
+      flags.cdpAddress = arg.slice("--remote-debugging-address=".length);
+    } else if (arg === "--remote-debugging-address") {
+      flags.cdpAddress = argv[++i] ?? "";
+    } else if (arg.startsWith("-") && arg.length > 1 && i + 1 < argv.length) {
       flags.settings.set(arg.slice(1), argv[++i]);
     } else {
       files.push(arg);
@@ -576,7 +586,11 @@ function usage() {
     "    Show version+backend info & exit",
     "--docs, --readme",
     `    Show ${pkg.name}'s README.md & exit`,
-
+    "",
+    "--remote-debugging-port=PORT",
+    "    Start CDP (Chrome DevTools Protocol) server on PORT at launch",
+    "--remote-debugging-address=ADDRESS",
+    "    Bind CDP server to ADDRESS (default: 127.0.0.1); use 0.0.0.0 for all interfaces",
 
   ].join("\n");
 }
@@ -5811,7 +5825,7 @@ function detectTtsCmd() {
   Bun.env.TTS_LANG = lang ;
 
   if (platform === "android") {
-    if (runSync(["sh", "-c", "command -v termux-tts-speak"], { stdout: "ignore", stderr: "ignore" }).ok)
+    if (Bun.which("termux-tts-speak"))
       return { cmd: ["termux-tts-speak", "-p", String(pitch), "-r", String(speed)], via: "arg" };
   }
 
@@ -5832,7 +5846,7 @@ function detectTtsCmd() {
     const pitchPct = Math.round((pitch - 1) * 100);
     const pitchAttr = (pitchPct >= 0 ? "+" : "") + pitchPct + "%";
     for (const shell of ["pwsh.exe", "powershell.exe"]) {
-      if (runSync(["where.exe", shell], { stdout: "ignore", stderr: "ignore" }).ok) {
+      if (Bun.which(shell)) {
         const psCmd =
           "Add-Type -AssemblyName System.Speech; " +
           `$s = New-Object System.Speech.Synthesis.SpeechSynthesizer; $s.Rate = ${rate}; ` +
@@ -5847,7 +5861,7 @@ function detectTtsCmd() {
   // Linux / Android fallback: espeak-ng / espeak
   // Speed: -s <wpm> (175 = normal), Pitch: -p <n> (0-99, 50 = normal)
   for (const bin of ["espeak-ng", "espeak"]) {
-    if (runSync(["sh", "-c", `command -v ${bin}`], { stdout: "ignore", stderr: "ignore" }).ok) {
+    if (Bun.which(bin)) {
       const spd = Math.round(175 * speed);
       const pit = Math.max(0, Math.min(99, Math.round(50 * pitch)));
       return { cmd: [bin, '-s', spd, '-p', pit], via: "arg" };
@@ -6725,6 +6739,11 @@ async function main() {
     for (const buffer of buffers) await plugins.run("onBufferOpen", buffer);
   }
   for (const buffer of buffers) await jsPlugins.run("onBufferOpen", buffer);
+  if (flags.cdpPort) {
+    const cdpArgs = [flags.cdpPort];
+    if (flags.cdpAddress) cdpArgs.push(`--address=${flags.cdpAddress}`);
+    await app.handleCommand(`cdp ${cdpArgs.join(" ")}`);
+  }
   await app.start();
 }
 

package/src/platform/commands.js

@@ -118,10 +118,7 @@ export async function runBytes(command, options = {}) {
 }
 
 export function hasCommand(name) {
-  if (platformId() === "win32") {
-    return runSync(["where.exe", name], { stdout: "ignore", stderr: "ignore" }).ok;
-  }
-  return runSync(["sh", "-c", `command -v ${shellQuote(name)}`], { stdout: "ignore", stderr: "ignore" }).ok;
+  return Bun.which(name);
 }
 
 export function firstCommand(names) {

package/src/plugins/js-bridge.js

@@ -455,10 +455,7 @@ function registerBuiltinActions() {
         if (pane?.buffer?.modified) try { await pane.buffer.save?.(); } catch {}
     await app.stop?.(0);
   });
-  reg("Escape", (app) => {
-    if (app.pane) app.pane.selection = null;
-    if (app.buffer) app.buffer.searchPattern = "";
-  });
+  reg("Escape", (app) => app._dispatchInput?.(new TextEncoder().encode("\x1b")));
 
   // Toggle settings
   reg("ToggleDiffGutter", (app) => {
@@ -768,7 +765,9 @@ export function buildMicroGlobal(jsManager) {
         return async (...args) => {
           const app = getApp();
           if (!app) return;
-          return app.handleCommand(buildCmdString(name, args));
+          const result = await app.handleCommand(buildCmdString(name, args));
+          app.render?.();
+          return result;
         };
       },
     }),
@@ -872,6 +871,7 @@ function _makePaneAPI(buffer, app) {
     EndOfLine:   () => buffer.moveEnd(),
     InsertNewline: () => buffer.newline(),
     InsertTab:   () => buffer.insertTab(),
+    Insert:      (text) => { buffer.pushUndo?.(); buffer.insert(text); app?.render?.(); },
     HandleCommand: (cmd) => app?.handleCommand?.(cmd),
 
     // Run a named action on this pane

package/tests/wv-client.js

@@ -0,0 +1,96 @@
+const cdpUrl = Bun.argv[2] ?? "ws://127.0.0.1:9222";
+
+const view = new Bun.WebView({
+  backend: {
+    type: "chrome",
+    url: cdpUrl,
+  },
+});
+
+view.onNavigated = (url, title) => {
+  console.log(`[navigated] ${title || "(no title)"} — ${url.slice(0, 80)}`);
+};
+
+const delay = Bun.sleep
+
+try {
+
+  await delay(2000);
+  
+  // 1. navigate to first page
+  console.log("\n--- navigate: https://example.com ---");
+  await view.navigate("https://example.com");
+  await delay(2000);
+
+
+  // 2. navigate to second page
+  console.log("\n--- evaluate: micro.cmd.tab() ---");
+  await view.evaluate("micro.cmd.tab()");
+  await delay(500);
+  
+  console.log("\n--- navigate: github bunmicro hlw.md ---");
+  await view.navigate("https://raw.githubusercontent.com/jjtseng93/bunmicro/refs/heads/main/hlw.md");
+  await delay(2000);
+
+
+  // 3. navigate to third page
+  console.log("\n--- evaluate: micro.cmd.tab() ---");
+  await view.evaluate("micro.cmd.tab()");
+  await delay(500);
+  
+  console.log("\n--- navigate: https://bun.sh/docs dns ---");
+  await view.navigate("https://bun.com/docs/runtime/networking/dns");
+  await delay(2000);
+
+
+  // 4. go back twice
+  console.log("\n--- goBack (dns → hlw) ---");
+  await view.goBack();
+  await delay(2000);
+
+  console.log("\n--- goBack (hlw → example.com) ---");
+  await view.goBack();
+  await delay(2000);
+
+
+  // 5. go forward
+  console.log("\n--- goForward (example.com → hlw) ---");
+  await view.goForward();
+  await delay(2000);
+
+
+  // 6. type before # hello & click
+  console.log("\n--- click #hello to focus ---");
+  await view.scrollTo("#hello");
+  await view.evaluate('micro.action.StartOfLine()');
+  await delay(2000);
+
+  console.log("\n--- type: '# Bun is great' ---");
+  await view.type("# Bun is great");
+  await delay(2000);
+  
+
+  console.log("\n--- press Enter ---");
+  await view.press("Enter");
+  await delay(2000);
+  
+  
+  console.log("\n--- Click 3,3 ---");  
+  await view.click(3,3); //點33
+  await delay(2000);
+
+
+  // 7. resize
+  console.log("\n--- resize 1280x720 ---");
+  await view.resize(1280, 720);
+  await delay(2000);
+
+  // 8. go forward to dns
+  console.log("\n--- goForward (hlw → dns) ---");
+  await view.goForward();
+  await delay(2000);
+
+  console.log("\nAll done.");
+} finally {
+  view.close();
+}