yoctomarkdown 0.0.1 → 0.0.3

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 "<new-version>\n<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/README.md

@@ -13,6 +13,8 @@ A small, fast, Bun-native Markdown highlighter for terminal output.
 
 ## Installation
 
+[npm package](https://www.npmjs.com/package/yoctomarkdown)
+
 ```bash
 bun add yoctomarkdown
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yoctomarkdown",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "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",
@@ -30,5 +30,13 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "bun test"
+  },
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
   }
 }

package/src/index.ts

@@ -83,17 +83,17 @@ export function createHighlighter(options?: Options): Highlighter {
     return result;
   }
 
-  function parseLine(line: string, _isLastLine: boolean): string {
+  function parseLine(line: string, isPartial: boolean): string {
     if (inCodeBlock) {
       if (line.trim().startsWith("```")) {
-        inCodeBlock = false;
+        if (!isPartial) inCodeBlock = false;
         return theme.codeBlock(line);
       }
       return theme.codeBlock(line);
     }
 
     if (line.trim().startsWith("```")) {
-      inCodeBlock = true;
+      if (!isPartial) inCodeBlock = true;
       return theme.codeBlock(line);
     }
 
@@ -127,6 +127,9 @@ export function createHighlighter(options?: Options): Highlighter {
     return parseInline(line);
   }
 
+  let hasPartial = false;
+  let partialLength = 0;
+
   return {
     write(chunk: string | Uint8Array): string {
       const text =
@@ -136,15 +139,50 @@ export function createHighlighter(options?: Options): Highlighter {
       const lines = buffer.split("\n");
       buffer = lines.pop() ?? "";
 
-      return (
-        lines.map((line) => parseLine(line, false)).join("\n") +
-        (lines.length > 0 ? "\n" : "")
-      );
+      let out = "";
+      if (hasPartial) {
+        const columns =
+          typeof process !== "undefined" && process.stdout?.columns
+            ? process.stdout.columns
+            : 80;
+        const linesToClear = Math.ceil(partialLength / columns) || 1;
+        out += "\x1b[2K\r";
+        if (linesToClear > 1) {
+          out += "\x1b[1A\x1b[2K".repeat(linesToClear - 1);
+        }
+      }
+
+      if (lines.length > 0) {
+        out += `${lines.map((line) => parseLine(line, false)).join("\n")}\n`;
+      }
+
+      if (buffer.length > 0) {
+        out += parseLine(buffer, true);
+        hasPartial = true;
+        partialLength = buffer.length;
+      } else {
+        hasPartial = false;
+        partialLength = 0;
+      }
+
+      return out;
     },
     end(): string {
       if (buffer.length > 0) {
-        const out = parseLine(buffer, true);
+        const out = parseLine(buffer, false);
         buffer = "";
+        if (hasPartial) {
+          const columns =
+            typeof process !== "undefined" && process.stdout?.columns
+              ? process.stdout.columns
+              : 80;
+          const linesToClear = Math.ceil(partialLength / columns) || 1;
+          let clearSeq = "\x1b[2K\r";
+          if (linesToClear > 1) {
+            clearSeq += "\x1b[1A\x1b[2K".repeat(linesToClear - 1);
+          }
+          return clearSeq + out;
+        }
         return out;
       }
       return "";

package/tests/index.test.ts

@@ -32,6 +32,12 @@ describe("Programmatic Usage: highlightSync", () => {
   });
 });
 
+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);
+}
+
 describe("Programmatic Usage: createHighlighter (Streaming)", () => {
   test("should handle chunks without breaking output", () => {
     const highlighter = createHighlighter({ theme: "none" });
@@ -55,8 +61,7 @@ describe("Programmatic Usage: createHighlighter (Streaming)", () => {
     }
     res += highlighter.end();
 
-    const expected = highlightSync(markdown, { theme: "none" });
-    expect(res).toBe(expected);
+    expectStreamMatch(res, markdown);
   });
 
   test("should handle random chunk sizes", () => {
@@ -74,7 +79,36 @@ describe("Programmatic Usage: createHighlighter (Streaming)", () => {
     }
     res += highlighter.end();
 
-    const expected = highlightSync(markdown, { theme: "none" });
-    expect(res).toBe(expected);
+    expectStreamMatch(res, markdown);
+  });
+
+  test("should clear multiple lines when wrapped", () => {
+    // Mock columns
+    const originalColumns = process.stdout.columns;
+    Object.defineProperty(process.stdout, "columns", {
+      value: 10,
+      configurable: true,
+    });
+
+    const highlighter = createHighlighter({ theme: "none" });
+    // 25 chars, columns = 10, so it takes 3 visual lines
+    const chunk1 = "1234567890123456789012345";
+    const chunk2 = "67890\n";
+
+    let res = highlighter.write(chunk1);
+    res += highlighter.write(chunk2);
+    res += highlighter.end();
+
+    // The first chunk is written, then cleared. Since it takes 3 lines,
+    // clear sequence should have \x1b[1A\x1b[2K repeated twice.
+    expect(res).toContain("\x1b[1A\x1b[2K\x1b[1A\x1b[2K");
+
+    // Restore
+    if (originalColumns !== undefined) {
+      Object.defineProperty(process.stdout, "columns", {
+        value: originalColumns,
+        configurable: true,
+      });
+    }
   });
 });