yoctomarkdown 0.0.2 → 0.0.4

package/.agents/commands/release.md

@@ -0,0 +1,31 @@
+---
+description: Create a new tagged npm release (patch/minor/major)
+---
+
+Create a new npm release for this repo. The bump type is: $1 (default to "patch" if not provided).
+
+Steps to follow exactly:
+
+1. Normalize bump type to one of `patch|minor|major`; if empty, use `patch`.
+2. Verify git state before doing anything:
+   - current branch must be `main`
+   - working tree must be clean
+   - run `git fetch origin --tags` and ensure `HEAD` equals `origin/main`
+     If any check fails, stop and report.
+3. Run the full repo check suit — stop and report failures.
+4. Read `package.json` and capture both `name` and current `version`.
+5. Compute the next semver version by bumping the selected part.
+6. Guardrails before mutating files:
+   - ensure git tag `v<new-version>` does not exist locally or on origin
+   - ensure npm version does not already exist: `npm view <package-name>@<new-version> version`
+     If either exists, stop and report.
+7. Update the `version` field in `package.json` to `<new-version>`.
+8. Run `bun run build`.
+9. Commit all staged and unstaged changes with message: `chore: release v<new-version>`.
+10. Create annotated tag: `git tag -a v<new-version> -m "<small-changelog>"`.
+11. Push explicitly to main and the exact tag:
+    - `git push origin main`
+    - `git push origin v<new-version>`
+12. Post-push verification: run `npm view <package-name>@<new-version> version`.
+    - If it already exists, report that publish already happened and do **not** ask user to publish again.
+    - If it does not exist, run `npm publish`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yoctomarkdown",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "module": "src/index.ts",
   "type": "module",
   "devDependencies": {
@@ -18,7 +18,7 @@
     "yoctocolors": "^2.1.2"
   },
   "bin": {
-    "yoctomarkdown": "./src/cli.ts"
+    "yoctomarkdown": "src/cli.ts"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/src/index.ts

@@ -129,6 +129,14 @@ export function createHighlighter(options?: Options): Highlighter {
 
   let hasPartial = false;
 
+  function redrawPartialPrefix(): string {
+    return hasPartial ? "\x1b8\x1b[J" : "";
+  }
+
+  function renderPartial(line: string, isPartial: boolean): string {
+    return `\x1b7${parseLine(line, isPartial)}`;
+  }
+
   return {
     write(chunk: string | Uint8Array): string {
       const text =
@@ -138,17 +146,14 @@ export function createHighlighter(options?: Options): Highlighter {
       const lines = buffer.split("\n");
       buffer = lines.pop() ?? "";
 
-      let out = "";
-      if (hasPartial) {
-        out += "\x1b[2K\r";
-      }
+      let out = redrawPartialPrefix();
 
       if (lines.length > 0) {
         out += `${lines.map((line) => parseLine(line, false)).join("\n")}\n`;
       }
 
       if (buffer.length > 0) {
-        out += parseLine(buffer, true);
+        out += renderPartial(buffer, true);
         hasPartial = true;
       } else {
         hasPartial = false;
@@ -160,7 +165,12 @@ export function createHighlighter(options?: Options): Highlighter {
       if (buffer.length > 0) {
         const out = parseLine(buffer, false);
         buffer = "";
-        return (hasPartial ? "\x1b[2K\r" : "") + out;
+        if (hasPartial) {
+          const redrawPrefix = redrawPartialPrefix();
+          hasPartial = false;
+          return redrawPrefix + out;
+        }
+        return out;
       }
       return "";
     },

package/tests/index.test.ts

@@ -32,10 +32,107 @@ describe("Programmatic Usage: highlightSync", () => {
   });
 });
 
+function renderTerminalOutput(
+  output: string,
+  columns = Number.POSITIVE_INFINITY,
+) {
+  const screen: string[][] = [[]];
+  let row = 0;
+  let column = 0;
+  let savedCursor: { row: number; column: number } | null = null;
+
+  function ensureRow(targetRow: number) {
+    while (screen.length <= targetRow) {
+      screen.push([]);
+    }
+  }
+
+  function writeChar(char: string) {
+    if (column >= columns) {
+      row += 1;
+      column = 0;
+    }
+
+    ensureRow(row);
+    if (!screen[row]) {
+      screen[row] = [];
+    }
+    const currentLine = screen[row];
+    if (!currentLine) {
+      return;
+    }
+    currentLine[column] = char;
+    column += 1;
+  }
+
+  for (let i = 0; i < output.length; i += 1) {
+    const rest = output.slice(i);
+
+    if (rest.startsWith("\x1b7")) {
+      savedCursor = { row, column };
+      i += 1;
+      continue;
+    }
+
+    if (rest.startsWith("\x1b8")) {
+      if (savedCursor) {
+        row = savedCursor.row;
+        column = savedCursor.column;
+      }
+      i += 1;
+      continue;
+    }
+
+    if (rest.startsWith("\x1b[J")) {
+      ensureRow(row);
+      screen[row] = (screen[row] ?? []).slice(0, column);
+      for (let clearRow = row + 1; clearRow < screen.length; clearRow += 1) {
+        screen[clearRow] = [];
+      }
+      i += 2;
+      continue;
+    }
+
+    if (rest.startsWith("\x1b[2K")) {
+      ensureRow(row);
+      screen[row] = [];
+      i += 3;
+      continue;
+    }
+
+    if (rest.startsWith("\x1b[1A")) {
+      row = Math.max(0, row - 1);
+      i += 3;
+      continue;
+    }
+
+    const char = output[i];
+    if (char === "\n") {
+      row += 1;
+      column = 0;
+      ensureRow(row);
+      continue;
+    }
+
+    if (char === "\r") {
+      column = 0;
+      continue;
+    }
+
+    if (char !== undefined && char !== "\x1b") {
+      writeChar(char);
+    }
+  }
+
+  return screen
+    .map((line) => line.join("").replace(/\s+$/u, ""))
+    .join("\n")
+    .replace(/\n+$/u, "");
+}
+
 function expectStreamMatch(res: string, markdown: string) {
   const expected = highlightSync(markdown, { theme: "none" });
-  // biome-ignore lint/suspicious/noControlCharactersInRegex: clear line ansi escape
-  expect(res.replace(/[^\n]*\x1b\[2K\r/g, "")).toBe(expected);
+  expect(renderTerminalOutput(res)).toBe(renderTerminalOutput(expected));
 }
 
 describe("Programmatic Usage: createHighlighter (Streaming)", () => {
@@ -81,4 +178,21 @@ describe("Programmatic Usage: createHighlighter (Streaming)", () => {
 
     expectStreamMatch(res, markdown);
   });
+
+  test("should redraw wrapped partial lines after an external prefix", () => {
+    const prefix = "◆ ";
+    const markdown =
+      "No `\\x1b[2K` or `\\r` sequences in the streamed text. The ANSI colour codes remain (intentional — those are static style codes from yoctocolors, not cursor-control sequences).\n";
+    const splitAt = 134;
+
+    const highlighter = createHighlighter({ theme: "none" });
+    let res = prefix;
+    res += highlighter.write(markdown.slice(0, splitAt));
+    res += highlighter.write(markdown.slice(splitAt));
+    res += highlighter.end();
+
+    expect(renderTerminalOutput(res, 120)).toBe(
+      renderTerminalOutput(`${prefix}${markdown}`, 120),
+    );
+  });
 });