terminal-png 0.1.5 → 0.1.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Poe Platform
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -14,14 +14,22 @@ await renderTerminalPng(ansiText, {
 });
 ```
 
-Options:
+## Configuration Options
 
 - `output`: path to the output PNG file
 - `window`: include terminal window chrome
-- `padding`: padding around the rendered terminal content
+- `padding`: non-negative integer padding around the rendered terminal content
+
+The ANSI parser supports common SGR styling, cursor positioning and movement, save/restore cursor,
+erase-in-line/display, tabs, double-width characters, and combining marks. Parsed terminal state is
+bounded to 1000 rows by 1000 columns to avoid unbounded renders from hostile control sequences.
 
 ## CLI
 
 ```sh
 terminal-png <input.ansi> -o <output.png> [--window] [--padding 20]
 ```
+
+## Environment Variables
+
+This package does not read public environment variables. The comparison script inherits `PATH` only to locate the local CLI under test.

package/dist/svg-renderer.js

@@ -1,4 +1,5 @@
 import { FONT_FACE_CSS } from "./font.js";
+const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" });
 const ANSI_16_PALETTE = [
     "#282a2e",
     "#D74E6F",
@@ -117,7 +118,6 @@ function measureLines(lines) {
     return Math.max(...lines.map((line) => displayWidth(line.map((run) => run.text).join("")) * CHARACTER_WIDTH), 0);
 }
 function displayWidth(text, startColumn = 0) {
-    const segmenter = new Intl.Segmenter();
     let column = startColumn;
     for (const { segment } of segmenter.segment(text)) {
         if (segment === "\t") {
@@ -165,13 +165,38 @@ function renderLines(lines, textStartX, textStartY, lineHeightPx) {
     return lines
         .map((line, index) => {
         const y = formatNumber(textStartY + (index * lineHeightPx));
+        let column = 0;
         if (line.length === 0) {
             return `<text x="${formatNumber(textStartX)}" y="${y}" xml:space="preserve"/>`;
         }
         return [
             renderBackgrounds(line, textStartX, textStartY + (index * lineHeightPx) - lineHeightPx, lineHeightPx),
             `<text x="${formatNumber(textStartX)}" y="${y}" xml:space="preserve">`,
-            line.map(renderRun).join(""),
+            line.flatMap((run) => {
+                const spans = [];
+                let text = "";
+                let start = column;
+                for (const { segment } of segmenter.segment(run.text)) {
+                    const width = displayWidth(segment, column);
+                    if (width !== 1 || Array.from(segment).length !== 1) {
+                        if (text.length > 0)
+                            spans.push(renderRun({ ...run, text }, textStartX + start * CHARACTER_WIDTH));
+                        text = "";
+                        if (segment !== "\t" && width > 0) {
+                            spans.push(renderRun({ ...run, text: segment }, textStartX + column * CHARACTER_WIDTH));
+                        }
+                        column += width;
+                        start = column;
+                    }
+                    else {
+                        text += segment;
+                        column += 1;
+                    }
+                }
+                if (text.length > 0)
+                    spans.push(renderRun({ ...run, text }, textStartX + start * CHARACTER_WIDTH));
+                return spans;
+            }).join(""),
             "</text>"
         ].join("");
     })
@@ -190,7 +215,7 @@ function renderBackgrounds(line, startX, y, height) {
     }
     return rectangles.join("");
 }
-function renderRun(run) {
+function renderRun(run, x) {
     const attributes = ['xml:space="preserve"'];
     const color = resolveForegroundColor(run);
     const textDecorations = [];
@@ -216,6 +241,8 @@ function renderRun(run) {
         attributes.push('opacity="0.7"');
     }
     const text = run.conceal ? " ".repeat(displayWidth(run.text)) : run.text;
+    const positions = [...segmenter.segment(run.text)].map((_, index) => formatNumber(x + index * CHARACTER_WIDTH));
+    attributes.push(`x="${positions.join(" ")}"`);
     return `<tspan ${attributes.join(" ")}>${escapeXmlText(text)}</tspan>`;
 }
 function renderWindowControls() {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "terminal-png",
-  "version": "0.1.5",
+  "version": "0.1.7",
+  "license": "MIT",
   "description": "Render PNG images from ANSI terminal output.",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,6 +16,7 @@
     "compare": "tsx scripts/compare.ts"
   },
   "files": [
+    "LICENSE",
     "dist",
     "bin",
     "assets"
@@ -26,7 +28,7 @@
   },
   "dependencies": {
     "@resvg/resvg-js": "^2.6.2",
-    "commander": "^14.0.3",
+    "commander": "^13.1.0",
     "jetbrains-mono": "^1.0.6"
   }
 }