markdansi 0.1.5 → 0.1.7

package/README.md

@@ -6,7 +6,7 @@
 
 ![npm](https://img.shields.io/npm/v/markdansi) ![license MIT](https://img.shields.io/badge/license-MIT-blue.svg) ![node >=22](https://img.shields.io/badge/node-%3E%3D22-brightgreen) ![tests vitest](https://img.shields.io/badge/tests-vitest-blue?logo=vitest)
 
-Tiny, dependency-light Markdown → ANSI renderer and CLI for modern Node (>=22). Focuses on readable terminal output with sensible wrapping, GFM support (tables, task lists, strikethrough), optional OSC‑8 hyperlinks, and zero built‑in syntax highlighting (pluggable hook). Written in TypeScript, ships ESM.
+Tiny, dependency-light Markdown → ANSI renderer and CLI for modern Node (>=22). Focuses on readable terminal output with sensible wrapping, GFM support (tables, task lists, strikethrough), optional OSC‑8 hyperlinks, and zero built‑in syntax highlighting (pluggable hook). Includes live in-place terminal rendering for streaming updates (`createLiveRenderer`). Written in TypeScript, ships ESM.
 
 Published on npm as `markdansi`.
 
@@ -46,6 +46,25 @@ const { render } = await import('markdansi');
 console.log(render('# hello'));
 ```
 
+### Live streaming / in-place rendering
+For streaming output (LLM responses, logs, progress), use `createLiveRenderer` to re-render and redraw in-place. Uses terminal “synchronized output” when supported.
+
+```js
+import { createLiveRenderer, render } from 'markdansi';
+
+const live = createLiveRenderer({
+  renderFrame: (markdown) => render(markdown),
+  write: process.stdout.write.bind(process.stdout),
+});
+
+let buffer = '';
+buffer += '# Hello\\n';
+live.render(buffer);
+buffer += '\\nMore…\\n';
+live.render(buffer);
+live.finish();
+```
+
 ```js
 import { render, createRenderer, strip, themes } from 'markdansi';
 

package/dist/render.js

@@ -322,7 +322,7 @@ function renderNode(node, ctx, indentLevel, isTightList) {
     }
 }
 function renderParagraph(node, ctx, indentLevel) {
-    const text = renderInline(node.children, ctx);
+    const text = normalizeParagraphInlineText(renderInline(node.children, ctx));
     const prefix = " ".repeat(ctx.options.listIndent * indentLevel);
     const rawLines = text.split("\n");
     const normalized = [];
@@ -489,7 +489,7 @@ function renderInline(children, ctx) {
                 out += renderLink(node, ctx);
                 break;
             case "break":
-                out += "\n";
+                out += HARD_BREAK;
                 break;
             default:
                 if ("value" in node && typeof node.value === "string")
@@ -498,6 +498,47 @@ function renderInline(children, ctx) {
     }
     return out;
 }
+const HARD_BREAK = "\u000B";
+function normalizeParagraphInlineText(text) {
+    if (!text.includes("\n") && !text.includes(HARD_BREAK))
+        return text;
+    const segments = [];
+    let current = "";
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (ch === "\n" || ch === HARD_BREAK) {
+            segments.push({
+                text: current,
+                breakAfter: ch === HARD_BREAK ? "hard" : "soft",
+            });
+            current = "";
+            continue;
+        }
+        current += ch;
+    }
+    segments.push({ text: current });
+    const defPattern = /^\[[^\]]+]:\s+\S/;
+    let out = segments[0]?.text ?? "";
+    for (let i = 0; i < segments.length - 1; i += 1) {
+        const kind = segments[i]?.breakAfter ?? "soft";
+        const left = segments[i]?.text ?? "";
+        const right = segments[i + 1]?.text ?? "";
+        if (kind === "hard") {
+            out += "\n";
+            out += right;
+            continue;
+        }
+        const leftTrim = left.trimStart();
+        const rightTrim = right.trimStart();
+        const keepNewline = left === "" ||
+            right === "" ||
+            defPattern.test(leftTrim) ||
+            defPattern.test(rightTrim);
+        out += keepNewline ? "\n" : " ";
+        out += rightTrim;
+    }
+    return out;
+}
 function renderLink(node, ctx) {
     const label = renderInline(node.children, ctx) || node.url;
     const url = node.url || "";

package/dist/wrap.js

@@ -17,11 +17,36 @@ export function wrapText(text, width, wrap) {
     const lines = [];
     let current = "";
     let currentWidth = 0;
+    const trimEndSpaces = (s) => s.replace(/\s+$/, "");
+    const orphanPhraseTail = (s) => {
+        const trimmed = trimEndSpaces(s);
+        const phrase = trimmed.match(/\b(with|in|on|of|to|for)\s+(a|an|the)$/i);
+        if (phrase) {
+            const preposition = phrase[1];
+            const article = phrase[2];
+            if (preposition && article)
+                return `${preposition} ${article}`;
+        }
+        const single = trimmed.match(/\b(a|an|the|to|of|with|and|or|in|on|for)$/i);
+        return single?.[1] ?? null;
+    };
     for (const word of words) {
         const w = visibleWidth(word);
         if (current !== "" && currentWidth + w > width && !/^\s+$/.test(word)) {
-            lines.push(current);
-            current = word.replace(/^\s+/, "");
+            const nextWord = word.replace(/^\s+/, "");
+            const currentNoTrail = trimEndSpaces(current);
+            const tail = orphanPhraseTail(currentNoTrail);
+            if (tail && currentNoTrail.length > tail.length) {
+                const base = trimEndSpaces(currentNoTrail.slice(0, currentNoTrail.length - tail.length));
+                if (base !== "") {
+                    lines.push(base);
+                    current = `${tail} ${nextWord}`;
+                    currentWidth = visibleWidth(current);
+                    continue;
+                }
+            }
+            lines.push(currentNoTrail);
+            current = nextWord;
             currentWidth = visibleWidth(current);
             continue;
         }
@@ -29,7 +54,7 @@ export function wrapText(text, width, wrap) {
         currentWidth = visibleWidth(current);
     }
     if (current !== "")
-        lines.push(current);
+        lines.push(trimEndSpaces(current));
     if (lines.length === 0)
         lines.push("");
     return lines;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "markdansi",
-	"version": "0.1.5",
+	"version": "0.1.7",
 	"description": "Tiny dependency-light markdown to ANSI converter.",
 	"type": "module",
 	"main": "dist/index.js",
@@ -67,12 +67,17 @@
 		"supports-hyperlinks": "^4.3.0"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.3.5",
+		"@biomejs/biome": "^2.3.10",
 		"@types/mdast": "^4.0.4",
-		"@types/node": "^24.10.1",
-		"@vitest/coverage-v8": "^4.0.9",
-		"tsx": "^4.20.6",
+		"@types/node": "^25.0.3",
+		"@vitest/coverage-v8": "^4.0.16",
+		"tsx": "^4.21.0",
 		"typescript": "^5.9.3",
-		"vitest": "^4.0.9"
+		"vitest": "^4.0.16"
+	},
+	"pnpm": {
+		"onlyBuiltDependencies": [
+			"esbuild"
+		]
 	}
 }