jsmdcui 0.4.0 → 0.6.3

package/src/index.js

@@ -98,6 +98,8 @@ import { mkdir } from "node:fs/promises";
 import { dirname, basename, join, resolve, sep } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import process from "node:process";
+import { toggleTaskCheckboxBeforeColumn } from "./cui/task-checkbox.mjs";
+import { checkMarkdownIdCollisions, formatMarkdownIdCheckAnsi } from "./cui/id-collision.mjs";
 import { Config } from "./config/config.js";
 import { defaultAllSettings, OPTION_CHOICES, LOCAL_SETTINGS } from "./config/defaults.js";
 import { cleanConfig } from "./config/clean.js";
@@ -195,7 +197,7 @@ const DEFAULT_SETTINGS = {
   backup: true,
   backupdir: "",
   permbackup: false,
-  softwrap: false,
+  softwrap: true,
   wordwrap: false,
   pageoverlap: 2,
   scrollmargin: 3,
@@ -538,6 +540,70 @@ function mdcuiCellPayload(buf, y, x, trigger = "unknown") {
   };
 }
 
+function resizeMdcuiTextBlock(buf, y, x) {
+  if (!buf || !isMdcuiEncoding(buf.encoding) || x !== 0) return null;
+  const line = String(buf.lines?.[y] ?? "");
+  const top = line.match(/^(\s*)(┌─|╭─|\+-)\s*text(?:[#.][A-Za-z_][\w:.-]*)*\s*$/);
+  const bottom = line.match(/^(\s*)(└─|╰─|\+-)\s*$/);
+  if (!top && !bottom) return null;
+
+  let insertAt = -1;
+  let removeAt = -1;
+  let bodyLine = "";
+
+  if (bottom) {
+    for (let row = y - 1; row >= 0; row--) {
+      const header = String(buf.lines[row] ?? "").match(/^(\s*)(┌─|╭─|\+-)\s*text(?:[#.][A-Za-z_][\w:.-]*)*\s*$/);
+      if (!header || header[1] !== bottom[1]) continue;
+      const marker = header[2] === "+-" ? "|" : "│";
+      insertAt = y;
+      bodyLine = header[1] + marker + " ";
+      break;
+    }
+  } else if (top) {
+    const marker = top[2] === "+-" ? "|" : "│";
+    for (let row = y + 1; row < buf.lines.length; row++) {
+      const rest = String(buf.lines[row] ?? "").slice(top[1].length);
+      if (/^(?:└─|╰─|\+-)\s*$/.test(rest)) {
+        const candidate = row - 1;
+        if (candidate > y && String(buf.lines[candidate] ?? "") === top[1] + marker + " ")
+          removeAt = candidate;
+        break;
+      }
+    }
+  }
+
+  if (insertAt < 0 && removeAt < 0) return "unchanged";
+  buf.pushUndo?.(true);
+
+  const row = insertAt >= 0 ? insertAt : removeAt;
+  const deleteCount = removeAt >= 0 ? 1 : 0;
+  const replacement = insertAt >= 0 ? [bodyLine] : [];
+  buf.lines.splice(row, deleteCount, ...replacement);
+
+  if (Array.isArray(buf._ansiStyleLines)) {
+    const template = buf._ansiStyleLines[Math.max(0, row - 1)] ?? null;
+    buf._ansiStyleLines.splice(row, deleteCount, ...replacement.map(() => template));
+  }
+  if (typeof buf._mdcuiAnsiText === "string") {
+    const ansiLines = buf._mdcuiAnsiText.split("\n");
+    ansiLines.splice(row, deleteCount, ...replacement);
+    buf._mdcuiAnsiText = ansiLines.join("\n");
+  }
+
+  if (insertAt >= 0) {
+    if (buf.cursor.y >= insertAt) buf.cursor.y++;
+  } else if (buf.cursor.y > removeAt) {
+    buf.cursor.y--;
+  } else if (buf.cursor.y === removeAt) {
+    buf.cursor.y = Math.max(0, removeAt - 1);
+  }
+  buf.invalidateHighlightFrom?.(row, { force: true });
+  buf.modified = true;
+  buf.ensureCursor?.();
+  return insertAt >= 0 ? "added" : "removed";
+}
+
 function detectFileFormat(text, fallback = DEFAULT_SETTINGS.fileformat) {
   if (text.length === 0) return fallback === "dos" ? "dos" : "unix";
   const newlineIdx = text.indexOf("\n");
@@ -557,6 +623,24 @@ function isReadonlyBuffer(buf) {
   return Boolean(buf?.readonly || buf?.Settings?.readonly || buf?.Type?.Readonly);
 }
 
+function mdcuiEditablePrefixLength(buf, y = buf?.cursor?.y ?? 0) {
+  if (!isMdcuiEncoding(buf?.encoding ?? buf?.Settings?.encoding)) return 0;
+  const line = String(buf?.lines?.[y] ?? "");
+  return /^(?:│|\|) /.test(line) ? 2 : 0;
+}
+
+function canEditMdcuiAtCursor(buf) {
+  const prefixLength = mdcuiEditablePrefixLength(buf);
+  return prefixLength > 0 && (buf?.cursor?.x ?? 0) >= prefixLength;
+}
+
+function canEditMdcuiSelection(buf, selection) {
+  if (!selection) return true;
+  const { first, last } = selectionBounds(selection);
+  const prefixLength = mdcuiEditablePrefixLength(buf, first.y);
+  return first.y === last.y && prefixLength > 0 && first.x >= prefixLength;
+}
+
 function isEditLockedBuffer(buf) {
   return isMdcuiEncoding(buf?.encoding ?? buf?.Settings?.encoding);
 }
@@ -865,11 +949,16 @@ function parseArgs(argv) {
     options: false,
     help: false,
     clean: false,
+    check: false,
     cat: false,
     docs: false,
+    exportReadme: false,
     changelog: false,
     testapp: false,
     demo: false,
+    demoSelect: false,
+    demoImgtool: false,
+    demoImgtoolZh: false,
     allowUrl: false,
     buildExe: false,
     buildFor: "",
@@ -889,6 +978,7 @@ function parseArgs(argv) {
     else if (arg === "-options") flags.options = true;
     else if (arg === "-help" || arg === "--help" || arg === "-h") flags.help = true;
     else if (arg === "-clean") flags.clean = true;
+    else if (arg === "--check") flags.check = true;
     else if (arg === "--cat" || arg === "-cat" || arg === "--ccat" || arg === "-ccat" || arg === "--bat" || arg === "-bat" || arg === "--glow" || arg === "-glow") flags.cat = true;
     else if (arg === "--xxd" || arg === "--hexdump") {
       flags.cat = true;
@@ -907,9 +997,13 @@ function parseArgs(argv) {
       flags.settings.set("encoding", "utf-8");
     }
     else if (arg === "--docs" || arg === "--readme") flags.docs = true;
+    else if (arg === "--export-readme") flags.exportReadme = true;
     else if (arg === "--changelog") flags.changelog = true;
     else if (arg === "--testapp.md") flags.testapp = true;
     else if (arg === "--demo") flags.demo = true;
+    else if (arg === "--demo-select") flags.demoSelect = true;
+    else if (arg === "--demo-imgtool") flags.demoImgtool = true;
+    else if (arg === "--demo-imgtool-zh") flags.demoImgtoolZh = true;
     else if (arg === "--allow-url") flags.allowUrl = true;
     else if (arg === "--build-exe") flags.buildExe = true;
     else if (arg === "--build-for") flags.buildFor = argv[++i] ?? "";
@@ -942,9 +1036,13 @@ function usage() {
   ${pkg.name} --wui [FILE.md]
 
 Modes:
+  --check FILE.md
+      Check heading and fenced-block IDs for collisions, print details, and exit
+      Exits 0 when IDs are unique, 1 on collisions, and 2 on usage/read errors
   --wui [FILE.md]
       Generate or overwrite Markdown UI files beside FILE.md and start the server
-      Without FILE.md, use testapp.md and write generated files in the current directory
+      Without FILE.md, use the existing ./testapp.md without overwriting it
+      If ./testapp.md is missing, write the bundled demo there first
   --cat, --ccat, --bat, --glow
       Render file(s) and write to stdout, then exit (.md uses mdcui/createTui)
       A local .md file also writes or overwrites five generated files beside it
@@ -978,6 +1076,8 @@ Information:
       Show version+backend info & exit
   --docs, --readme
       Show ${pkg.name}'s README.md & exit
+  --export-readme
+      Write or overwrite ./README.md with the bundled README.md & exit
   --changelog
       Show CHANGELOG.md & exit
   -profile, --profile
@@ -987,7 +1087,17 @@ Demo:
   --testapp.md
       Write the bundled testapp.md to stdout & exit
   --demo
-      Outputs & overwrites ./testapp.md, opens it in the TUI, and writes 5 generated files
+      Use the existing ./testapp.md without overwriting it, or write the bundled demo if missing
+      Open it in the TUI and write 5 generated files beside it
+  --demo-select
+      Use the existing ./select.md without overwriting it, or write the bundled demo if missing
+      Open it in the TUI and write 5 generated files beside it
+  --demo-imgtool
+      Use the existing ./image-processor.md without overwriting it, or write the bundled demo if missing
+      Open the Bun.Image processor in the TUI and write 5 generated files beside it
+  --demo-imgtool-zh
+      Use the existing ./image-processor.zh-TW.md without overwriting it, or write the bundled demo if missing
+      Open the Traditional Chinese Bun.Image processor in the TUI and write 5 generated files beside it
 
 Remote Markdown:
   --allow-url
@@ -1198,7 +1308,8 @@ class BufferModel {
   }
 
   insert(text) {
-    if (this.isEditLocked()) return false;
+    if (this.isEditLocked() && !canEditMdcuiAtCursor(this)) return false;
+    if (isMdcuiEncoding(this.encoding) && /[\r\n]/.test(String(text))) return false;
     for (const ch of text) {
       if (ch === "\r" || ch === "\n") this.newline(false);
       else if (ch >= " " || ch === "\t") this.insertChar(ch);
@@ -1207,7 +1318,7 @@ class BufferModel {
   }
 
   insertChar(ch) {
-    if (this.isEditLocked()) return false;
+    if (this.isEditLocked() && !canEditMdcuiAtCursor(this)) return false;
     if (ch === "\t" && DEFAULT_SETTINGS.tabstospaces) ch = " ".repeat(DEFAULT_SETTINGS.tabsize);
     const line = this.line();
     this.lines[this.cursor.y] = line.slice(0, this.cursor.x) + ch + line.slice(this.cursor.x);
@@ -1218,6 +1329,7 @@ class BufferModel {
   }
 
   newline(autoindent = true) {
+    if (isMdcuiEncoding(this.encoding)) return false;
     if (this.isEditLocked()) return false;
     const line = this.line();
     const left = line.slice(0, this.cursor.x);
@@ -1236,7 +1348,9 @@ class BufferModel {
   }
 
   backspace() {
-    if (this.isEditLocked()) return false;
+    if (this.isEditLocked() && !canEditMdcuiAtCursor(this)) return false;
+    const mdcuiPrefixLength = mdcuiEditablePrefixLength(this);
+    if (mdcuiPrefixLength > 0 && this.cursor.x <= mdcuiPrefixLength) return false;
     if (this.cursor.x > 0) {
       const line = this.line();
       let start = this.cursor.x - 1;
@@ -1263,7 +1377,7 @@ class BufferModel {
   }
 
   deleteForward() {
-    if (this.isEditLocked()) return false;
+    if (this.isEditLocked() && !canEditMdcuiAtCursor(this)) return false;
     const line = this.line();
     if (this.cursor.x < line.length) {
       const cp = line.codePointAt(this.cursor.x);
@@ -1272,6 +1386,8 @@ class BufferModel {
       this.invalidateHighlightFrom(this.cursor.y);
       this.modified = true;
       return true;
+    } else if (isMdcuiEncoding(this.encoding)) {
+      return false;
     } else if (this.cursor.y < this.lines.length - 1) {
       this.lines[this.cursor.y] += this.lines[this.cursor.y + 1];
       this.lines.splice(this.cursor.y + 1, 1);
@@ -1401,8 +1517,8 @@ class BufferModel {
     this.cursor.x = x;
   }
 
-  pushUndo() {
-    if (this.isEditLocked()) return;
+  pushUndo(force = false) {
+    if (!force && this.isEditLocked() && !canEditMdcuiAtCursor(this)) return;
     this.undoStack.push({ lines: this.lines.slice(), cursor: { ...this.cursor }, serial: this._undoSerial });
     this._undoSerial = (this._undoSerial ?? 0) + 1;
     if (this.undoStack.length > 500) this.undoStack.shift();
@@ -1410,7 +1526,7 @@ class BufferModel {
   }
 
   undo() {
-    if (this.isEditLocked()) return false;
+    if (this.isEditLocked() && !isMdcuiEncoding(this.encoding)) return false;
     if (!this.undoStack.length) return false;
     this.redoStack.push({ lines: this.lines.slice(), cursor: { ...this.cursor }, serial: this._undoSerial });
     const s = this.undoStack.pop();
@@ -1423,7 +1539,7 @@ class BufferModel {
   }
 
   redo() {
-    if (this.isEditLocked()) return false;
+    if (this.isEditLocked() && !isMdcuiEncoding(this.encoding)) return false;
     if (!this.redoStack.length) return false;
     this.undoStack.push({ lines: this.lines.slice(), cursor: { ...this.cursor }, serial: this._undoSerial });
     const s = this.redoStack.pop();
@@ -2302,6 +2418,7 @@ class App {
     this._messageRowY = null;
     this._messageRowClickZone = null;
     this._resizeRenderSeq = 0;
+    this._mdcuiExitNotified = new WeakSet();
   }
 
   get tab()    { return this.tabs[this.activeTabIdx]; }
@@ -2445,6 +2562,8 @@ class App {
   }
 
   async stop(code = 0) {
+    for (const buf of this.buffers)
+      await this.notifyMdcuiExit(buf, "exit");
     this.running = false;
     if (this._backupTimer) { clearInterval(this._backupTimer); this._backupTimer = null; }
     await Promise.allSettled(this.buffers.map((buf) => buf._backupWritePromise).filter(Boolean));
@@ -3488,7 +3607,15 @@ class App {
     }
 
     if (event.type === "paste") {
-      if (isEditLockedBuffer(buf)) {
+      if (
+        (isEditLockedBuffer(buf) && !isMdcuiEncoding(buf?.encoding))
+        || (isMdcuiEncoding(buf?.encoding) && (
+          !canEditMdcuiAtCursor(buf)
+          ||
+          /[\r\n]/.test(event.text)
+          || !canEditMdcuiSelection(buf, this.pane?.selection)
+        ))
+      ) {
         this.message = "Buffer is read-only";
         this.render();
         return;
@@ -3866,13 +3993,17 @@ class App {
         break;
       default:
         if (text >= " " || text.includes("\n")) {
-          if (isMdcuiEncoding(buf?.encoding) && text === " ") {
+          if (isMdcuiEncoding(buf?.encoding) && text === " " && !canEditMdcuiAtCursor(buf)) {
             await this.handleMdcuiCellCallback(buf, buf.cursor.y, buf.cursor.x, "space");
             break;
           }
           if (!this._undoInsertChain || this.pane?.selection) {
             buf.pushUndo();
           }
+          if (isMdcuiEncoding(buf?.encoding) && !canEditMdcuiSelection(buf, this.pane?.selection)) {
+            this.message = "Protected mdcui prefix";
+            break;
+          }
           this._undoInsertChain = true;
           if (this.pane?.selection) deleteSelection(buf, this.pane);
           await this.insertTextWithHooks(text);
@@ -3885,6 +4016,12 @@ class App {
   async handleMdcuiCellCallback(buf, y = buf?.cursor?.y ?? 0, x = buf?.cursor?.x ?? 0, trigger = "unknown") {
     const payload = mdcuiCellPayload(buf, y, x, trigger);
     if (!payload) return false;
+    const resizeResult = resizeMdcuiTextBlock(buf, y, x);
+    if (resizeResult) {
+      if (resizeResult === "added") this.message = "Added text row";
+      else if (resizeResult === "removed") this.message = "Removed empty text row";
+      return true;
+    }
     const callback = this.context?.mdcuiCallback ?? globalThis.mdcuiCallback;
     if (typeof callback === "function") {
       try {
@@ -3953,6 +4090,12 @@ class App {
           return true;
         }
       }
+
+      const checkboxResult = toggleTaskCheckboxBeforeColumn(payload.line, x);
+      if (checkboxResult.toggled) {
+        buf.lines[y] = checkboxResult.line;
+        buf.modified = true;
+      }
     
       this.message = `event ${payload.trigger}:`+
       `(${payload.row},${payload.col})`+
@@ -4751,6 +4894,11 @@ class App {
 
   async quit() {
     const buffer = this.buffer;
+    if (isMdcuiEncoding(buffer?.encoding)) {
+      await this.notifyMdcuiExit(buffer, "quit");
+      await this._doCloseCurrentPane();
+      return;
+    }
     if (buffer.modified) {
       if (!this.prompt) {
         this.openYNPrompt(
@@ -4771,6 +4919,7 @@ class App {
   // Close only the current pane; if it's the last pane in the tab, close the tab.
   async _doCloseCurrentPane() {
     if (this.tab.panes().length > 1) {
+      await this.notifyMdcuiExit(this.buffer, "close-pane");
       this.closePane(this.pane);
       this.render();
     } else {
@@ -4788,6 +4937,32 @@ class App {
     if (!this.prompt && !this.buffer.modified) await this.closeCurrentTab({ force: true });
   }
 
+  async notifyMdcuiExit(buffer, reason = "exit") {
+    if (
+      !buffer
+      || !isMdcuiEncoding(buffer.encoding)
+      || this._mdcuiExitNotified.has(buffer)
+    ) return;
+    this._mdcuiExitNotified.add(buffer);
+
+    const frontPath = buffer.path && !isHttpUrl(buffer.path)
+      ? `${buffer.path}.front.js`
+      : "";
+    if (!frontPath || !existsSync(frontPath)) return;
+
+    try {
+      const frontMod = await import(localModuleUrl(frontPath));
+      if (typeof frontMod.onMdcuiExit !== "function") return;
+      await frontMod.onMdcuiExit({
+        reason,
+        path: buffer.path,
+        $: globalThis.$,
+      });
+    } catch (error) {
+      console.error(`[mdcui] onMdcuiExit: ${error?.message || error}`);
+    }
+  }
+
   async toggleHelp() {
     const cur = this.pane;
     if (cur?.isHelp) {
@@ -4886,11 +5061,14 @@ class App {
   async closeCurrentTab({ force = false } = {}) {
     if (!force && this.buffer?.modified) return await this.quit();
     if (this.tabs.length <= 1) {
+      await this.notifyMdcuiExit(this.buffer, "close-tab");
       await this.stop(0);
       return;
     }
     const closingBuffers = [...new Set(this.tab.panes().flatMap((pane) => [pane.buffer, pane.prevBuffer]).filter(Boolean))];
     const closing = this.buffer;
+    for (const buffer of closingBuffers)
+      await this.notifyMdcuiExit(buffer, "close-tab");
     this.tabs.splice(this.activeTabIdx, 1);
     this.activeTabIdx = Math.min(this.activeTabIdx, this.tabs.length - 1);
     this.message = "";
@@ -5674,6 +5852,14 @@ class App {
         this._freshClip = false;
         const pasted = this.clipboard.read();
         if (pasted) {
+          if (isMdcuiEncoding(buf?.encoding) && (
+            /[\r\n]/.test(pasted)
+            || !canEditMdcuiAtCursor(buf)
+            || !canEditMdcuiSelection(buf, this.pane?.selection)
+          )) {
+            this.message = "Protected mdcui content";
+            break;
+          }
           buf.pushUndo();
           if (this.pane?.selection) deleteSelection(buf, this.pane);
           buf.insert(pasted);
@@ -7346,8 +7532,17 @@ async function loadBuffers(files, command) {
 }
 
 async function printReadmeDocs() {
-  const readme = readInternalAssetText("README.md") ?? await Bun.file(join(REPO_ROOT, "README.md")).text();
-  process.stdout.write(Bun.markdown.ansi(readme, { hyperlinks: true }));
+  process.stdout.write(Bun.markdown.ansi(await bundledReadmeSource(), { hyperlinks: true }));
+}
+
+async function bundledReadmeSource() {
+  return readInternalAssetText("README.md") ?? await Bun.file(join(REPO_ROOT, "README.md")).text();
+}
+
+async function exportReadme() {
+  const readmePath = resolve("README.md");
+  await Bun.write(readmePath, await bundledReadmeSource());
+  console.log(`Wrote ${readmePath}`);
 }
 
 async function printChangelogDocs() {
@@ -7356,11 +7551,11 @@ async function printChangelogDocs() {
 }
 
 async function printTestappSource() {
-  process.stdout.write(await bundledTestappSource());
+  process.stdout.write(await bundledMarkdownSource("testapp.md"));
 }
 
-async function bundledTestappSource() {
-  return readInternalAssetText("testapp.md") ?? await Bun.file(join(REPO_ROOT, "testapp.md")).text();
+async function bundledMarkdownSource(filename) {
+  return readInternalAssetText(filename) ?? await Bun.file(join(REPO_ROOT, filename)).text();
 }
 
 async function main() {
@@ -7406,10 +7601,33 @@ async function main() {
     console.log("Clipboard:", backends);
     return;
   }
+  if (flags.check) {
+    if (rawFiles.length !== 1) {
+      console.error("Usage: jsmdcui --check FILE.md");
+      process.exitCode = 2;
+      return;
+    }
+    const checkPath = resolve(rawFiles[0]);
+    try {
+      const file = Bun.file(checkPath);
+      if (!(await file.exists())) throw new Error("file not found");
+      const result = checkMarkdownIdCollisions(await file.text());
+      process.stdout.write(formatMarkdownIdCheckAnsi(checkPath, result));
+      if (result.collisions.length) process.exitCode = 1;
+    } catch (error) {
+      console.error(`Cannot check ${checkPath}: ${error?.message || error}`);
+      process.exitCode = 2;
+    }
+    return;
+  }
   if (flags.docs) {
     await printReadmeDocs();
     return;
   }
+  if (flags.exportReadme) {
+    await exportReadme();
+    return;
+  }
   if (flags.changelog) {
     await printChangelogDocs();
     return;
@@ -7418,9 +7636,20 @@ async function main() {
     await printTestappSource();
     return;
   }
-  if (flags.demo) {
-    const demoPath = resolve("testapp.md");
-    await Bun.write(demoPath, await bundledTestappSource());
+  const demoFilename = flags.demo
+    ? "testapp.md"
+    : flags.demoSelect
+      ? "select.md"
+      : flags.demoImgtool
+        ? "image-processor.md"
+        : flags.demoImgtoolZh
+          ? "image-processor.zh-TW.md"
+          : "";
+  if (demoFilename) {
+    const demoPath = resolve(demoFilename);
+    if (!(await Bun.file(demoPath).exists())) {
+      await Bun.write(demoPath, await bundledMarkdownSource(demoFilename));
+    }
     rawFiles.splice(0, rawFiles.length, demoPath);
   }
   if (flags.options) {
@@ -7902,11 +8131,16 @@ function outdentLine(buf, _ctx) {
 }
 
 function deleteSelection(buf, pane) {
-  if (isEditLockedBuffer(buf)) return "";
   const selection = pane?.selection;
   if (!selection || !buf) return "";
   const text = getSelectionText(buf, selection);
   const { first, last } = selectionBounds(selection);
+  if (isMdcuiEncoding(buf?.encoding)) {
+    const prefixLength = mdcuiEditablePrefixLength(buf, first.y);
+    if (first.y !== last.y || prefixLength === 0 || first.x < prefixLength) return "";
+  } else if (isEditLockedBuffer(buf)) {
+    return "";
+  }
   if (first.y === last.y) {
     const line = buf.lines[first.y] ?? "";
     buf.lines[first.y] = line.slice(0, first.x) + line.slice(last.x);