jsmdcui 0.3.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/runtime/jsplugins/chapter/chapter.js

@@ -0,0 +1,108 @@
+// example.js — demonstrates the micro JS plugin API
+// 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[])
+  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("nextchapter", async (bp, args) =>
+  {
+     let fp=bp?.Buf?.Path
+     let i1=fp.lastIndexOf('/')- -1
+     let i2=fp.lastIndexOf('.')
+     let nb=fp.slice(i1,i2)
+     let nfp=fp.slice(0,i1)+(nb- -1)+fp.slice(i2)
+
+     await micro.cmd.open('-f',nfp)
+     
+     /*
+     await micro.cmd.replaceall('曰','日')
+     await micro.cmd.replaceall('修土','修士')
+     await micro.cmd.replaceall('<p>','\n')
+     await micro.cmd.replaceall('</p>','\n')
+     await micro.cmd.goto(48)
+     
+
+     micro.cmd.tts()
+     */
+
+  });
+
+  micro.MakeCommand("prevchapter", async (bp, args) =>
+  {
+     let fp=bp?.Buf?.Path
+     let i1=fp.lastIndexOf('/')- -1
+     let i2=fp.lastIndexOf('.')
+     let nb=fp.slice(i1,i2)
+     let nfp=fp.slice(0,i1)+(nb-1)+fp.slice(i2)
+
+     await micro.cmd.open('-f',nfp)
+     
+     /*
+     await micro.cmd.replaceall('曰','日')
+     await micro.cmd.replaceall('修土','修士')
+     await micro.cmd.replaceall('<p>','\n')
+     await micro.cmd.replaceall('</p>','\n')
+     await micro.cmd.goto(48)
+
+     micro.cmd.tts()
+     */
+
+  });
+
+});
+
+

package/runtime/jsplugins/diff/diff.js

@@ -0,0 +1,46 @@
+// diff.js — JS port of the Lua diff plugin (Go parity)
+// When diffgutter is enabled, fetches git HEAD content and sets it as the
+// diff base so the editor can show added/modified/removed gutter markers.
+//
+// Go behavior (diff.lua):
+//   1. Skip scratch buffers or buffers with no path.
+//   2. Check the file exists on disk; skip if not.
+//   3. Run: git -C <dir> show HEAD:./<file>
+//   4. On git failure (not tracked / no commits): set diffBase = current file
+//      content — this produces no gutter markers (base == current).
+//   5. On success: set diffBase = git HEAD content.
+
+import { dirname, basename } from "node:path";
+import { existsSync } from "node:fs";
+
+const _hasGit = await Bun.which("git") !== null;
+
+micro.on("onBufferOpen", async (buffer) => {
+  if (!_hasGit) return;
+  if (!buffer.Settings?.diffgutter) return;
+  if (buffer.Type?.Scratch) return;
+  const absPath = buffer.AbsPath || buffer.Path;
+  if (!absPath) return;
+
+  // Go: os.Stat check — only proceed if the file exists on disk
+  try { if (!existsSync(absPath)) return; } catch { return; }
+
+  const dir = dirname(absPath);
+  const file = basename(absPath);
+  try {
+    const proc = Bun.spawn(["git", "-C", dir, "show", `HEAD:./${file}`], {
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+    const exitCode = await proc.exited;
+    if (exitCode === 0) {
+      const text = await new Response(proc.stdout).text();
+      buffer.SetDiffBase(text);
+    } else {
+      // Go: on git failure set diffBase = current content (no markers shown)
+      buffer.SetDiffBase(buffer.Bytes ? buffer.Bytes() : "");
+    }
+  } catch (e) {
+    // Go: on error set diffBase = current content (no markers shown)
+    buffer.SetDiffBase(buffer.Bytes ? buffer.Bytes() : "");
+  }
+});

package/runtime/jsplugins/example/example.js

@@ -0,0 +1,110 @@
+// example.js — demonstrates the micro JS plugin API
+// 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("showpath", async (bp, args) =>
+  {
+    //micro.TermMessage("Hello from JS plugin! Args: " + args.join(", "));
+
+    //await micro.alert(micro.getLine())
+    const path = bp?.Buf?.Path || "(no path)";
+    const loc = bp?.CursorLocation?.() || "+1.0:1";
+    await micro.alert(`${path}\n${loc}`)
+    
+  });
+  
+
+  micro.MakeCommand("js", async (bp, args) =>
+  {
+    // args.raw is the full original input string, e.g. "js console.log('hi')"
+    // slice(3) skips the "js " prefix (2-char name + 1 space)
+    const scriptText = args.raw?.slice(3) ?? args.join(" ");
+    await micro.alert(await eval(scriptText));
+  });
+  
+
+  // greet: shows a message via micro.alert (leaves editor, shows text, Enter returns)
+  micro.MakeCommand("greet", async (bp, args) => 
+  {
+    const name = args.length ? 
+               args.join(" ") : "world";
+               
+    let s=Bun.markdown.ansi(
+      '# Hello\n- '+name
+    );
+    
+    await micro.alert(s);
+  });
+
+  // Register a custom action (can be bound to a key in keybindings.json)
+  micro.RegisterAction("ExampleDuplicateAndComment", async () => 
+  {
+    await micro.action.DuplicateLine();
+    await micro.action.ToggleComment();
+  });
+});
+
+micro.on("onSave", (bp) => 
+{
+  // bp is the BufPane adapter 
+  // (same as Lua's bp arg)
+  
+  const path = bp?.Buf?.Path || "(no path)";
+  //micro.Log("[example] saved:", path);
+});