@retrovm/terminal 0.1.0 → 0.1.1

package/README.md

@@ -38,13 +38,21 @@ term.red('Hello ').bgBlue(' world ').reset().println()
 
 `Terminal.out` and `Terminal.err` are ready-made instances wired to `Bun.stdout` and `Bun.stderr`. Both are `ITerminal | undefined` — use `Terminal.out!` if you know stdout is available.
 
-### Any runtime (Node.js, xterm.js, custom)
+### Node.js
 
 ```typescript
-import { createTerminal } from '@retrovm/terminal'
+import { Terminal } from '@retrovm/terminal'
+
+const term = Terminal.out   // pre-wired to process.stdout
+term.red('Hello ').bgBlue(' world ').reset().println()
+```
 
-// Node.js writable
-const term = createTerminal(process.stdout)
+`Terminal.out` and `Terminal.err` are pre-wired to `process.stdout` and `process.stderr` via the `"node"` export condition — no configuration needed.
+
+### Any sink (xterm.js, custom, test)
+
+```typescript
+import { createTerminal } from '@retrovm/terminal'
 
 // xterm.js
 import { Terminal as XTerm } from '@xterm/xterm'
@@ -266,21 +274,35 @@ Named shortcuts (`term.red`, `term.bgBlue`, …) are built from the static `Colo
 {
   "exports": {
     ".": {
-      "bun":    "./src/bun.ts",
-      "types":  "./src/bun.ts",
-      "import": "./src/terminal.ts"
+      "bun":  "./src/bun.ts",
+      "node": { "types": "./dist/node.d.ts", "default": "./dist/node.js" },
+      "types": "./dist/node.d.ts",
+      "import": "./dist/terminal.js"
     }
   }
 }
 ```
 
-| Condition | File | Used by |
+| Condition | Resolved to | Used by |
 |---|---|---|
-| `bun` | `src/bun.ts` | Bun runtime — exports pre-wired `Terminal.out` / `Terminal.err` plus re-exports everything from `terminal.ts` |
-| `types` | `src/bun.ts` | TypeScript language server (VSCode, tsc) |
-| `import` | `src/terminal.ts` | Node.js ESM, bundlers |
+| `bun` | `src/bun.ts` | Bun runtime — TS source, `Terminal.out/err` via `Bun.stdout/stderr` |
+| `node` | `dist/node.js` + `dist/node.d.ts` | Node.js — `Terminal.out/err` via `process.stdout/stderr` |
+| `types` | `dist/node.d.ts` | TypeScript language server (VSCode, tsc) in other environments |
+| `import` | `dist/terminal.js` | Bundlers, ESM environments without a specific condition |
 
-When running under Bun, `import { Terminal } from '@retrovm/terminal'` resolves to `src/bun.ts`. In Node.js it resolves to `src/terminal.ts`, which exports `createTerminal` and the `Terminal` class directly.
+## Building
+
+The package distributes TypeScript source for Bun and compiled output for Node.js. To build:
+
+```sh
+bun run build
+```
+
+This runs two steps:
+1. **`bun build`** — compiles `terminal.ts` and `node.ts` to `dist/` targeting Node.js
+2. **`tsc`** — generates `dist/terminal.d.ts` and `dist/node.d.ts` via `tsconfig.build.json`
+
+`prepublishOnly` runs the build automatically before `bun publish` / `npm publish`.
 
 ---
 
@@ -364,4 +386,26 @@ NO_COLOR=1 bun run sample/rainbow.ts   # plain text, no color
 
 ## License
 
-MIT © Juan Carlos González Amestoy
+```
+MIT License
+
+Copyright (c) 2026 Juan Carlos González Amestoy
+
+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/dist/node.d.ts

@@ -0,0 +1,5 @@
+export { createTerminal, type ITerminal, type ITerminalWriter } from "./terminal";
+export declare const Terminal: {
+    out: import("./terminal").ITerminal;
+    err: import("./terminal").ITerminal;
+};

package/dist/node.js

@@ -0,0 +1,442 @@
+// node_modules/@retrovm/color/dist/color.js
+var _colors;
+var fract = (x) => {
+  return x - Math.floor(x);
+};
+var interpolate = (a, b, t) => {
+  return a + (b - a) * t;
+};
+var clamp = (x, min = 0, max = 1) => {
+  const c = x > min ? x : min;
+  return max < c ? max : c;
+};
+
+class Color {
+  _r;
+  _g;
+  _b;
+  _a;
+  _h;
+  _s;
+  _v;
+  _ansiFg;
+  _ansiBg;
+  constructor(rs, g, b, a = 1) {
+    if (typeof rs === "number" && g !== undefined && b !== undefined) {
+      this._r = rs;
+      this._g = g;
+      this._b = b;
+      this._a = a;
+    } else if (typeof rs === "string") {
+      const match = rs.match(/^#?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?$/i);
+      if (match) {
+        this._r = parseInt(match[1], 16) / 255;
+        this._g = parseInt(match[2], 16) / 255;
+        this._b = parseInt(match[3], 16) / 255;
+        this._a = match[4] ? parseInt(match[4], 16) / 255 : 1;
+      } else {
+        const match2 = rs.match(/^#?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?$/i);
+        if (match2) {
+          this._r = parseInt(match2[1], 16) / 15;
+          this._g = parseInt(match2[2], 16) / 15;
+          this._b = parseInt(match2[3], 16) / 15;
+          this._a = match2[4] ? parseInt(match2[4], 16) / 15 : 1;
+        } else {
+          throw new Error("Invalid color string");
+        }
+      }
+    } else {
+      throw new Error("Invalid arguments");
+    }
+  }
+  get r() {
+    return this._r;
+  }
+  get g() {
+    return this._g;
+  }
+  get b() {
+    return this._b;
+  }
+  get a() {
+    return this._a;
+  }
+  get h() {
+    if (this._h === undefined) {
+      const M = Math.max(this._r, this._g, this._b);
+      const m = Math.min(this._r, this._g, this._b);
+      const c = M - m;
+      if (c === 0) {
+        this._h = 0;
+      } else if (M === this._r) {
+        this._h = (this._g - this._b) / c % 6;
+      } else if (M === this._g) {
+        this._h = (this._b - this._r) / c + 2;
+      } else {
+        this._h = (this._r - this._g) / c + 4;
+      }
+      this._h *= 60;
+      if (this._h < 0) {
+        this._h += 360;
+      }
+    }
+    return this._h / 360;
+  }
+  get s() {
+    if (this._s === undefined) {
+      const M = Math.max(this._r, this._g, this._b);
+      const m = Math.min(this._r, this._g, this._b);
+      this._s = M !== 0 ? (M - m) / M : 0;
+    }
+    return this._s;
+  }
+  get v() {
+    if (this._v === undefined) {
+      this._v = Math.max(this._r, this._g, this._b);
+    }
+    return this._v;
+  }
+  add(c) {
+    return new Color(this._r + c._r, this._g + c._g, this._b + c._b, this._a + c._a);
+  }
+  sub(c) {
+    return new Color(this._r - c._r, this._g - c._g, this._b - c._b, this._a - c._a);
+  }
+  mul(n) {
+    return new Color(this._r * n, this._g * n, this._b * n, this._a * n);
+  }
+  div(n) {
+    return new Color(this._r / n, this._g / n, this._b / n, this._a / n);
+  }
+  interpolate(c, t) {
+    return new Color(this._r + (c._r - this._r) * t, this._g + (c._g - this._g) * t, this._b + (c._b - this._b) * t, this._a + (c._a - this._a) * t);
+  }
+  interpolateIn(c, t) {
+    this._r += (c._r - this._r) * t;
+    this._g += (c._g - this._g) * t;
+    this._b += (c._b - this._b) * t;
+    this._a += (c._a - this._a) * t;
+    this._invalidateCaches();
+    return this;
+  }
+  _invalidateCaches() {
+    this._h = undefined;
+    this._s = undefined;
+    this._v = undefined;
+    this._ansiFg = undefined;
+    this._ansiBg = undefined;
+  }
+  toString() {
+    return `#${Math.round(this._r * 255).toString(16).padStart(2, "0")}${Math.round(this._g * 255).toString(16).padStart(2, "0")}${Math.round(this._b * 255).toString(16).padStart(2, "0")}${Math.round(this._a * 255).toString(16).padStart(2, "0")}`;
+  }
+  toAnsiRGB() {
+    return this._ansiFg ??= `\x1B[38;2;${Math.floor(this._r * 255)};${Math.floor(this._g * 255)};${Math.floor(this._b * 255)}m`;
+  }
+  toAnsiBackgroundRGB() {
+    return this._ansiBg ??= `\x1B[48;2;${Math.floor(this._r * 255)};${Math.floor(this._g * 255)};${Math.floor(this._b * 255)}m`;
+  }
+  static fromHSV(h, s, v, a = 1) {
+    let r = h + 1;
+    let g = h + 2 / 3;
+    let b = h + 1 / 3;
+    r = Math.abs(fract(r) * 6 - 3);
+    g = Math.abs(fract(g) * 6 - 3);
+    b = Math.abs(fract(b) * 6 - 3);
+    r = v * interpolate(1, clamp(r - 1), s);
+    g = v * interpolate(1, clamp(g - 1), s);
+    b = v * interpolate(1, clamp(b - 1), s);
+    r = Math.round(r * 1e4) / 1e4;
+    g = Math.round(g * 1e4) / 1e4;
+    b = Math.round(b * 1e4) / 1e4;
+    return new Color(r, g, b, a);
+  }
+  static aliceBlue = new Color(0.941176, 0.972549, 1, 1);
+  static antiqueWhite = new Color(0.980392, 0.921569, 0.843137, 1);
+  static aqua = new Color(0, 1, 1, 1);
+  static aquamarine = new Color(0.498039, 1, 0.831373, 1);
+  static azure = new Color(0.941176, 1, 1, 1);
+  static beige = new Color(0.960784, 0.960784, 0.862745, 1);
+  static bisque = new Color(1, 0.894118, 0.768627, 1);
+  static black = new Color(0, 0, 0, 1);
+  static blanchedAlmond = new Color(1, 0.921569, 0.803922, 1);
+  static blue = new Color(0, 0, 1, 1);
+  static blueViolet = new Color(0.541176, 0.168627, 0.886275, 1);
+  static brown = new Color(0.647059, 0.164706, 0.164706, 1);
+  static burlyWood = new Color(0.870588, 0.721569, 0.529412, 1);
+  static cadetBlue = new Color(0.372549, 0.619608, 0.627451, 1);
+  static chartreuse = new Color(0.498039, 1, 0, 1);
+  static chocolate = new Color(0.823529, 0.411765, 0.117647, 1);
+  static coral = new Color(1, 0.498039, 0.313725, 1);
+  static cornflowerBlue = new Color(0.392157, 0.584314, 0.929412, 1);
+  static cornsilk = new Color(0.882353, 0.972549, 0.862745, 1);
+  static crimson = new Color(0.862745, 0.078431, 0.235294, 1);
+  static cyan = new Color(0, 1, 1, 1);
+  static darkBlue = new Color(0, 0, 0.545098, 1);
+  static darkCyan = new Color(0, 0.545098, 0.545098, 1);
+  static darkGoldenrod = new Color(0.721569, 0.52549, 0.043137, 1);
+  static darkGray = new Color(0.662745, 0.662745, 0.662745, 1);
+  static darkGreen = new Color(0, 0.392157, 0, 1);
+  static darkKhaki = new Color(0.741176, 0.717647, 0.419608, 1);
+  static darkMagenta = new Color(0.545098, 0, 0.545098, 1);
+  static darkOliveGreen = new Color(0.333333, 0.419608, 0.184314, 1);
+  static darkOrange = new Color(1, 0.54902, 0, 1);
+  static darkOrchid = new Color(0.6, 0.196078, 0.8, 1);
+  static darkRed = new Color(0.545098, 0, 0, 1);
+  static darkSalmon = new Color(0.913725, 0.588235, 0.478431, 1);
+  static darkSeaGreen = new Color(0.560784, 0.737255, 0.560784, 1);
+  static darkSlateBlue = new Color(0.282353, 0.239216, 0.545098, 1);
+  static darkSlateGray = new Color(0.184314, 0.309804, 0.309804, 1);
+  static darkTurquoise = new Color(0, 0.807843, 0.819608, 1);
+  static darkViolet = new Color(0.580392, 0, 0.827451, 1);
+  static deepPink = new Color(1, 0.078431, 0.576471, 1);
+  static deepSkyBlue = new Color(0, 0.74902, 1, 1);
+  static dimGray = new Color(0.411765, 0.411765, 0.411765, 1);
+  static dodgerBlue = new Color(0.117647, 0.564706, 1, 1);
+  static fireBrick = new Color(0.698039, 0.133333, 0.133333, 1);
+  static floralWhite = new Color(1, 0.980392, 0.941176, 1);
+  static forestGreen = new Color(0.133333, 0.545098, 0.133333, 1);
+  static fuchsia = new Color(1, 0, 1, 1);
+  static gainsboro = new Color(0.862745, 0.862745, 0.862745, 1);
+  static ghostWhite = new Color(0.972549, 0.972549, 1, 1);
+  static gold = new Color(1, 0.843137, 0, 1);
+  static goldenrod = new Color(0.854902, 0.647059, 0.12549, 1);
+  static gray = new Color(0.501961, 0.501961, 0.501961, 1);
+  static green = new Color(0, 0.501961, 0, 1);
+  static greenYellow = new Color(0.678431, 1, 0.184314, 1);
+  static honeydew = new Color(0.941176, 1, 0.941176, 1);
+  static hotPink = new Color(1, 0.411765, 0.705882, 1);
+  static indianRed = new Color(0.803922, 0.360784, 0.360784, 1);
+  static indigo = new Color(0.294118, 0, 0.509804, 1);
+  static ivory = new Color(1, 1, 0.941176, 1);
+  static khaki = new Color(0.941176, 0.901961, 0.54902, 1);
+  static lavender = new Color(0.901961, 0.901961, 0.980392, 1);
+  static lavenderBlush = new Color(1, 0.941176, 0.960784, 1);
+  static lawnGreen = new Color(0.486275, 0.988235, 0, 1);
+  static lemonChiffon = new Color(1, 0.980392, 0.803922, 1);
+  static lightBlue = new Color(0.678431, 0.847059, 0.901961, 1);
+  static lightCoral = new Color(0.941176, 0.501961, 0.501961, 1);
+  static lightCyan = new Color(0.878431, 1, 1, 1);
+  static lightGoldenrodYellow = new Color(0.980392, 0.980392, 0.823529, 1);
+  static lightGreen = new Color(0.564706, 0.933333, 0.564706, 1);
+  static lightGrey = new Color(0.827451, 0.827451, 0.827451, 1);
+  static lightPink = new Color(1, 0.713725, 0.756863, 1);
+  static lightSalmon = new Color(1, 0.627451, 0.478431, 1);
+  static lightSeaGreen = new Color(0.12549, 0.698039, 0.666667, 1);
+  static lightSkyBlue = new Color(0.529412, 0.807843, 0.980392, 1);
+  static lightSlateGray = new Color(0.466667, 0.533333, 0.6, 1);
+  static lightSteelBlue = new Color(0.690196, 0.768627, 0.870588, 1);
+  static lightYellow = new Color(1, 1, 0.878431, 1);
+  static lime = new Color(0, 1, 0, 1);
+  static limeGreen = new Color(0.196078, 0.803922, 0.196078, 1);
+  static linen = new Color(0.980392, 0.941176, 0.901961, 1);
+  static magenta = new Color(1, 0, 1, 1);
+  static maroon = new Color(0.501961, 0, 0, 1);
+  static mediumAquamarine = new Color(0.4, 0.803922, 0.666667, 1);
+  static mediumBlue = new Color(0, 0, 0.803922, 1);
+  static mediumOrchid = new Color(0.729412, 0.333333, 0.827451, 1);
+  static mediumPurple = new Color(0.576471, 0.439216, 0.858824, 1);
+  static mediumSeaGreen = new Color(0.235294, 0.701961, 0.443137, 1);
+  static mediumSlateBlue = new Color(0.482353, 0.407843, 0.933333, 1);
+  static mediumSpringGreen = new Color(0, 0.980392, 0.603922, 1);
+  static mediumTurquoise = new Color(0.282353, 0.819608, 0.8, 1);
+  static mediumVioletRed = new Color(0.780392, 0.082353, 0.521569, 1);
+  static midnightBlue = new Color(0.098039, 0.098039, 0.439216, 1);
+  static mintCream = new Color(0.960784, 1, 0.980392, 1);
+  static mistyRose = new Color(1, 0.894118, 0.882353, 1);
+  static moccasin = new Color(1, 0.894118, 0.709804, 1);
+  static navajoWhite = new Color(1, 0.870588, 0.678431, 1);
+  static navy = new Color(0, 0, 0.501961, 1);
+  static oldLace = new Color(0.992157, 0.960784, 0.901961, 1);
+  static olive = new Color(0.501961, 0.501961, 0, 1);
+  static oliveDrab = new Color(0.419608, 0.556863, 0.137255, 1);
+  static orange = new Color(1, 0.647059, 0, 1);
+  static orangeRed = new Color(1, 0.270588, 0, 1);
+  static orchid = new Color(0.854902, 0.439216, 0.839216, 1);
+  static paleGoldenrod = new Color(0.933333, 0.909804, 0.666667, 1);
+  static paleGreen = new Color(0.596078, 0.984314, 0.596078, 1);
+  static paleTurquoise = new Color(0.686275, 0.933333, 0.933333, 1);
+  static paleVioletRed = new Color(0.858824, 0.439216, 0.576471, 1);
+  static papayaWhip = new Color(1, 0.937255, 0.835294, 1);
+  static peachPuff = new Color(1, 0.854902, 0.72549, 1);
+  static peru = new Color(0.803922, 0.521569, 0.247059, 1);
+  static pink = new Color(1, 0.752941, 0.796078, 1);
+  static plum = new Color(0.866667, 0.627451, 0.866667, 1);
+  static powderBlue = new Color(0.690196, 0.878431, 0.901961, 1);
+  static purple = new Color(0.501961, 0, 0.501961, 1);
+  static red = new Color(1, 0, 0, 1);
+  static rosyBrown = new Color(0.737255, 0.560784, 0.560784, 1);
+  static royalBlue = new Color(0.254902, 0.411765, 0.882353, 1);
+  static saddleBrown = new Color(0.545098, 0.270588, 0.07451, 1);
+  static salmon = new Color(0.980392, 0.501961, 0.447059, 1);
+  static sandyBrown = new Color(0.956863, 0.643137, 0.376471, 1);
+  static seaGreen = new Color(0.180392, 0.545098, 0.380392, 1);
+  static seashell = new Color(1, 0.960784, 0.933333, 1);
+  static sienna = new Color(0.627451, 0.321569, 0.176471, 1);
+  static silver = new Color(0.752941, 0.752941, 0.752941, 1);
+  static skyBlue = new Color(0.529412, 0.807843, 0.921569, 1);
+  static slateBlue = new Color(0.415686, 0.352941, 0.803922, 1);
+  static slateGray = new Color(0.466667, 0.533333, 0.6, 1);
+  static snow = new Color(1, 0.980392, 0.980392, 1);
+  static springGreen = new Color(0, 1, 0.498039, 1);
+  static steelBlue = new Color(0.27451, 0.509804, 0.705882, 1);
+  static tan = new Color(0.823529, 0.705882, 0.54902, 1);
+  static teal = new Color(0, 0.501961, 0.501961, 1);
+  static thistle = new Color(0.847059, 0.74902, 0.847059, 1);
+  static tomato = new Color(1, 0.388235, 0.278431, 1);
+  static transparent = new Color(0, 0, 0, 0);
+  static turquoise = new Color(0.25098, 0.878431, 0.815686, 1);
+  static violet = new Color(0.933333, 0.509804, 0.933333, 1);
+  static wheat = new Color(0.960784, 0.870588, 0.701961, 1);
+  static white = new Color(1, 1, 1, 1);
+  static whiteSmoke = new Color(0.960784, 0.960784, 0.960784, 1);
+  static yellow = new Color(1, 1, 0, 1);
+  static yellowGreen = new Color(0.603922, 0.803922, 0.196078, 1);
+  static names = ["aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenrod", "darkGray", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenrod", "gray", "green", "greenYellow", "honeydew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenrodYellow", "lightGreen", "lightGrey", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquamarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenrod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seashell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "transparent", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen"];
+  static get colors() {
+    if (_colors === undefined) {
+      _colors = {};
+      const _c = _colors;
+      const o = Color;
+      Color.names.forEach((name) => {
+        _c[name] = o[name];
+      });
+    }
+    return _colors;
+  }
+}
+
+// src/terminal.ts
+import { format } from "node:util";
+
+class TerminalCore {
+  writer;
+  plain;
+  constructor(writer, options = {}) {
+    this.writer = writer;
+    const envNoColor = typeof process !== "undefined" && !!process?.env?.NO_COLOR;
+    this.plain = options.plain ?? envNoColor;
+  }
+  emit(data) {
+    this.writer.write(data);
+  }
+  style(seq, fmt, args) {
+    const text = format(fmt, ...args);
+    this.emit(this.plain ? text : seq + text);
+    return this;
+  }
+  print(fmt = "", ...args) {
+    this.emit(format(fmt, ...args));
+    return this;
+  }
+  println(fmt = "", ...args) {
+    this.emit(format(fmt, ...args) + `\r
+`);
+    return this;
+  }
+  ink(c, fmt = "", ...args) {
+    const color = typeof c === "string" ? new Color(c) : c;
+    return this.style(color.toAnsiRGB(), fmt, args);
+  }
+  paper(c, fmt = "", ...args) {
+    const color = typeof c === "string" ? new Color(c) : c;
+    return this.style(color.toAnsiBackgroundRGB(), fmt, args);
+  }
+  reset(fmt = "", ...args) {
+    return this.style("\x1B[0m", fmt, args);
+  }
+  resetInk(fmt = "", ...args) {
+    return this.style("\x1B[39m", fmt, args);
+  }
+  resetPaper(fmt = "", ...args) {
+    return this.style("\x1B[49m", fmt, args);
+  }
+  cls() {
+    this.emit("\x1B[2J\x1B[H");
+    return this;
+  }
+  clearLine() {
+    this.emit("\x1B[K");
+    return this;
+  }
+  up(n = 1) {
+    this.emit(`\x1B[${n}A`);
+    return this;
+  }
+  down(n = 1) {
+    this.emit(`\x1B[${n}B`);
+    return this;
+  }
+  right(n = 1) {
+    this.emit(`\x1B[${n}C`);
+    return this;
+  }
+  left(n = 1) {
+    this.emit(`\x1B[${n}D`);
+    return this;
+  }
+  column(n = 1) {
+    this.emit(`\x1B[${n}G`);
+    return this;
+  }
+  row(n = 1) {
+    this.emit(`\x1B[${n}d`);
+    return this;
+  }
+  moveTo(row, col) {
+    this.emit(`\x1B[${row};${col}H`);
+    return this;
+  }
+  saveCursor() {
+    this.emit("\x1B[s");
+    return this;
+  }
+  restoreCursor() {
+    this.emit("\x1B[u");
+    return this;
+  }
+  cursor(visible = true) {
+    this.emit(visible ? "\x1B[?25h" : "\x1B[?25l");
+    return this;
+  }
+  alt(b = true) {
+    this.emit(`\x1B[?1049${b ? "h" : "l"}`);
+    return this;
+  }
+  autoWrap(b = true) {
+    this.emit(`\x1B[?7${b ? "h" : "l"}`);
+    return this;
+  }
+  scrollRegion(top, bottom) {
+    this.emit(`\x1B[${top};${bottom}r`);
+    return this;
+  }
+}
+function installColorMethods() {
+  const proto = TerminalCore.prototype;
+  const cap = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+  for (const key of Object.keys(Color)) {
+    const value = Color[key];
+    if (!(value instanceof Color))
+      continue;
+    const name = key;
+    proto[name] = function(fmt = "", ...args) {
+      return this.ink(value, fmt, ...args);
+    };
+    proto[`bg${cap(name)}`] = function(fmt = "", ...args) {
+      return this.paper(value, fmt, ...args);
+    };
+  }
+}
+installColorMethods();
+function createTerminal(writer, options = {}) {
+  return new TerminalCore(writer, options);
+}
+// src/node.ts
+var Terminal = {
+  out: createTerminal(process.stdout),
+  err: createTerminal(process.stderr)
+};
+export {
+  createTerminal,
+  Terminal
+};

package/dist/terminal.d.ts

@@ -0,0 +1,110 @@
+import { Color } from '@retrovm/color';
+/**
+ * Minimal sink interface. Anything with a `write(data: string)` method works:
+ * an xterm.js Terminal instance, a Node Writable, a Bun writer wrapper, or a
+ * test double that pushes to an array.
+ */
+export interface ITerminalWriter {
+    write(data: string): void;
+}
+/**
+ * Extracts from `Color` only the keys whose value is an instance of `Color`,
+ * so the generated method names exactly match the available named colors.
+ * Add a color to the `Color` class and both `ink<Name>` and `bg<Name>` methods
+ * appear automatically with full type safety and autocompletion.
+ */
+type ColorName = {
+    [K in keyof typeof Color]: typeof Color[K] extends Color ? K : never;
+}[keyof typeof Color];
+type ColorMethod = (fmt?: string, ...args: unknown[]) => ITerminal;
+type InkMethods = {
+    [K in ColorName]: ColorMethod;
+};
+type BgMethods = {
+    [K in ColorName as `bg${Capitalize<string & K>}`]: ColorMethod;
+};
+/**
+ * Public type of a Terminal instance: core methods plus all the auto-generated
+ * color shortcuts. Consumers see one cohesive type with autocompletion.
+ */
+export type ITerminal = TerminalCore & InkMethods & BgMethods;
+/**
+ * Core terminal output. Wraps any object with a `write(string)` method and
+ * exposes a fluent API for ANSI styling and cursor control.
+ *
+ * Color shortcut methods (e.g. `red`, `bgBlue`) are attached at construction
+ * time from the `Color` registry. They are declared via the `ITerminal` type
+ * and dispatched through an index signature on the class.
+ */
+declare class TerminalCore {
+    private readonly writer;
+    /** ANSI is suppressed when true; styling/cursor methods become no-ops. */
+    plain: boolean;
+    [key: string]: unknown;
+    constructor(writer: ITerminalWriter, options?: {
+        plain?: boolean;
+    });
+    /** Internal write helper. Single point of contact with the sink. */
+    private emit;
+    /** Internal style helper: skips ANSI when `plain` is enabled. */
+    private style;
+    /** Prints formatted text. Uses `util.format` semantics (`%s`, `%d`, …). */
+    print(fmt?: string, ...args: unknown[]): this;
+    /** Prints formatted text followed by a newline. */
+    println(fmt?: string, ...args: unknown[]): this;
+    /** Sets the foreground color and optionally writes formatted text. */
+    ink(c: string | Color, fmt?: string, ...args: unknown[]): this;
+    /** Sets the background color and optionally writes formatted text. */
+    paper(c: string | Color, fmt?: string, ...args: unknown[]): this;
+    /** Resets all attributes (color, background, intensity, …). */
+    reset(fmt?: string, ...args: unknown[]): this;
+    /** Resets only the foreground color. */
+    resetInk(fmt?: string, ...args: unknown[]): this;
+    /** Resets only the background color. */
+    resetPaper(fmt?: string, ...args: unknown[]): this;
+    /** Clears the screen and homes the cursor. */
+    cls(): this;
+    /** Clears from cursor to end of line. */
+    clearLine(): this;
+    up(n?: number): this;
+    down(n?: number): this;
+    right(n?: number): this;
+    left(n?: number): this;
+    /** Moves the cursor to the given column (1-based). */
+    column(n?: number): this;
+    /** Moves the cursor to the given row (1-based). */
+    row(n?: number): this;
+    /** Moves the cursor to the given (row, col), both 1-based. */
+    moveTo(row: number, col: number): this;
+    /** Saves the current cursor position. */
+    saveCursor(): this;
+    /** Restores the previously saved cursor position. */
+    restoreCursor(): this;
+    /** Shows or hides the cursor. */
+    cursor(visible?: boolean): this;
+    /** Enables or disables the alternate screen buffer. */
+    alt(b?: boolean): this;
+    /**
+     * Enables or disables auto-wrap (DECAWM, mode 7).
+     * Note: this is the rename of the old `scroll()` method, which was
+     * misnamed — DEC private mode 7 controls wrapping, not scrolling.
+     */
+    autoWrap(b?: boolean): this;
+    /** Sets the scrolling region (DECSTBM), both rows 1-based and inclusive. */
+    scrollRegion(top: number, bottom: number): this;
+}
+/**
+ * Public constructor. Accepts any object with a `write(string)` method —
+ * an xterm.js `Terminal`, a Node `Writable`, a Bun writer wrapper, or a mock.
+ *
+ * @example
+ * import { Terminal as XTerm } from '@xterm/xterm'
+ * const xterm = new XTerm()
+ * xterm.open(document.getElementById('term')!)
+ * const term = createTerminal(xterm)
+ * term.red('Hello ').bgBlue(' world ').reset().println()
+ */
+export declare function createTerminal(writer: ITerminalWriter, options?: {
+    plain?: boolean;
+}): ITerminal;
+export { TerminalCore };

package/dist/terminal.js

@@ -0,0 +1,437 @@
+// node_modules/@retrovm/color/dist/color.js
+var _colors;
+var fract = (x) => {
+  return x - Math.floor(x);
+};
+var interpolate = (a, b, t) => {
+  return a + (b - a) * t;
+};
+var clamp = (x, min = 0, max = 1) => {
+  const c = x > min ? x : min;
+  return max < c ? max : c;
+};
+
+class Color {
+  _r;
+  _g;
+  _b;
+  _a;
+  _h;
+  _s;
+  _v;
+  _ansiFg;
+  _ansiBg;
+  constructor(rs, g, b, a = 1) {
+    if (typeof rs === "number" && g !== undefined && b !== undefined) {
+      this._r = rs;
+      this._g = g;
+      this._b = b;
+      this._a = a;
+    } else if (typeof rs === "string") {
+      const match = rs.match(/^#?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?$/i);
+      if (match) {
+        this._r = parseInt(match[1], 16) / 255;
+        this._g = parseInt(match[2], 16) / 255;
+        this._b = parseInt(match[3], 16) / 255;
+        this._a = match[4] ? parseInt(match[4], 16) / 255 : 1;
+      } else {
+        const match2 = rs.match(/^#?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?$/i);
+        if (match2) {
+          this._r = parseInt(match2[1], 16) / 15;
+          this._g = parseInt(match2[2], 16) / 15;
+          this._b = parseInt(match2[3], 16) / 15;
+          this._a = match2[4] ? parseInt(match2[4], 16) / 15 : 1;
+        } else {
+          throw new Error("Invalid color string");
+        }
+      }
+    } else {
+      throw new Error("Invalid arguments");
+    }
+  }
+  get r() {
+    return this._r;
+  }
+  get g() {
+    return this._g;
+  }
+  get b() {
+    return this._b;
+  }
+  get a() {
+    return this._a;
+  }
+  get h() {
+    if (this._h === undefined) {
+      const M = Math.max(this._r, this._g, this._b);
+      const m = Math.min(this._r, this._g, this._b);
+      const c = M - m;
+      if (c === 0) {
+        this._h = 0;
+      } else if (M === this._r) {
+        this._h = (this._g - this._b) / c % 6;
+      } else if (M === this._g) {
+        this._h = (this._b - this._r) / c + 2;
+      } else {
+        this._h = (this._r - this._g) / c + 4;
+      }
+      this._h *= 60;
+      if (this._h < 0) {
+        this._h += 360;
+      }
+    }
+    return this._h / 360;
+  }
+  get s() {
+    if (this._s === undefined) {
+      const M = Math.max(this._r, this._g, this._b);
+      const m = Math.min(this._r, this._g, this._b);
+      this._s = M !== 0 ? (M - m) / M : 0;
+    }
+    return this._s;
+  }
+  get v() {
+    if (this._v === undefined) {
+      this._v = Math.max(this._r, this._g, this._b);
+    }
+    return this._v;
+  }
+  add(c) {
+    return new Color(this._r + c._r, this._g + c._g, this._b + c._b, this._a + c._a);
+  }
+  sub(c) {
+    return new Color(this._r - c._r, this._g - c._g, this._b - c._b, this._a - c._a);
+  }
+  mul(n) {
+    return new Color(this._r * n, this._g * n, this._b * n, this._a * n);
+  }
+  div(n) {
+    return new Color(this._r / n, this._g / n, this._b / n, this._a / n);
+  }
+  interpolate(c, t) {
+    return new Color(this._r + (c._r - this._r) * t, this._g + (c._g - this._g) * t, this._b + (c._b - this._b) * t, this._a + (c._a - this._a) * t);
+  }
+  interpolateIn(c, t) {
+    this._r += (c._r - this._r) * t;
+    this._g += (c._g - this._g) * t;
+    this._b += (c._b - this._b) * t;
+    this._a += (c._a - this._a) * t;
+    this._invalidateCaches();
+    return this;
+  }
+  _invalidateCaches() {
+    this._h = undefined;
+    this._s = undefined;
+    this._v = undefined;
+    this._ansiFg = undefined;
+    this._ansiBg = undefined;
+  }
+  toString() {
+    return `#${Math.round(this._r * 255).toString(16).padStart(2, "0")}${Math.round(this._g * 255).toString(16).padStart(2, "0")}${Math.round(this._b * 255).toString(16).padStart(2, "0")}${Math.round(this._a * 255).toString(16).padStart(2, "0")}`;
+  }
+  toAnsiRGB() {
+    return this._ansiFg ??= `\x1B[38;2;${Math.floor(this._r * 255)};${Math.floor(this._g * 255)};${Math.floor(this._b * 255)}m`;
+  }
+  toAnsiBackgroundRGB() {
+    return this._ansiBg ??= `\x1B[48;2;${Math.floor(this._r * 255)};${Math.floor(this._g * 255)};${Math.floor(this._b * 255)}m`;
+  }
+  static fromHSV(h, s, v, a = 1) {
+    let r = h + 1;
+    let g = h + 2 / 3;
+    let b = h + 1 / 3;
+    r = Math.abs(fract(r) * 6 - 3);
+    g = Math.abs(fract(g) * 6 - 3);
+    b = Math.abs(fract(b) * 6 - 3);
+    r = v * interpolate(1, clamp(r - 1), s);
+    g = v * interpolate(1, clamp(g - 1), s);
+    b = v * interpolate(1, clamp(b - 1), s);
+    r = Math.round(r * 1e4) / 1e4;
+    g = Math.round(g * 1e4) / 1e4;
+    b = Math.round(b * 1e4) / 1e4;
+    return new Color(r, g, b, a);
+  }
+  static aliceBlue = new Color(0.941176, 0.972549, 1, 1);
+  static antiqueWhite = new Color(0.980392, 0.921569, 0.843137, 1);
+  static aqua = new Color(0, 1, 1, 1);
+  static aquamarine = new Color(0.498039, 1, 0.831373, 1);
+  static azure = new Color(0.941176, 1, 1, 1);
+  static beige = new Color(0.960784, 0.960784, 0.862745, 1);
+  static bisque = new Color(1, 0.894118, 0.768627, 1);
+  static black = new Color(0, 0, 0, 1);
+  static blanchedAlmond = new Color(1, 0.921569, 0.803922, 1);
+  static blue = new Color(0, 0, 1, 1);
+  static blueViolet = new Color(0.541176, 0.168627, 0.886275, 1);
+  static brown = new Color(0.647059, 0.164706, 0.164706, 1);
+  static burlyWood = new Color(0.870588, 0.721569, 0.529412, 1);
+  static cadetBlue = new Color(0.372549, 0.619608, 0.627451, 1);
+  static chartreuse = new Color(0.498039, 1, 0, 1);
+  static chocolate = new Color(0.823529, 0.411765, 0.117647, 1);
+  static coral = new Color(1, 0.498039, 0.313725, 1);
+  static cornflowerBlue = new Color(0.392157, 0.584314, 0.929412, 1);
+  static cornsilk = new Color(0.882353, 0.972549, 0.862745, 1);
+  static crimson = new Color(0.862745, 0.078431, 0.235294, 1);
+  static cyan = new Color(0, 1, 1, 1);
+  static darkBlue = new Color(0, 0, 0.545098, 1);
+  static darkCyan = new Color(0, 0.545098, 0.545098, 1);
+  static darkGoldenrod = new Color(0.721569, 0.52549, 0.043137, 1);
+  static darkGray = new Color(0.662745, 0.662745, 0.662745, 1);
+  static darkGreen = new Color(0, 0.392157, 0, 1);
+  static darkKhaki = new Color(0.741176, 0.717647, 0.419608, 1);
+  static darkMagenta = new Color(0.545098, 0, 0.545098, 1);
+  static darkOliveGreen = new Color(0.333333, 0.419608, 0.184314, 1);
+  static darkOrange = new Color(1, 0.54902, 0, 1);
+  static darkOrchid = new Color(0.6, 0.196078, 0.8, 1);
+  static darkRed = new Color(0.545098, 0, 0, 1);
+  static darkSalmon = new Color(0.913725, 0.588235, 0.478431, 1);
+  static darkSeaGreen = new Color(0.560784, 0.737255, 0.560784, 1);
+  static darkSlateBlue = new Color(0.282353, 0.239216, 0.545098, 1);
+  static darkSlateGray = new Color(0.184314, 0.309804, 0.309804, 1);
+  static darkTurquoise = new Color(0, 0.807843, 0.819608, 1);
+  static darkViolet = new Color(0.580392, 0, 0.827451, 1);
+  static deepPink = new Color(1, 0.078431, 0.576471, 1);
+  static deepSkyBlue = new Color(0, 0.74902, 1, 1);
+  static dimGray = new Color(0.411765, 0.411765, 0.411765, 1);
+  static dodgerBlue = new Color(0.117647, 0.564706, 1, 1);
+  static fireBrick = new Color(0.698039, 0.133333, 0.133333, 1);
+  static floralWhite = new Color(1, 0.980392, 0.941176, 1);
+  static forestGreen = new Color(0.133333, 0.545098, 0.133333, 1);
+  static fuchsia = new Color(1, 0, 1, 1);
+  static gainsboro = new Color(0.862745, 0.862745, 0.862745, 1);
+  static ghostWhite = new Color(0.972549, 0.972549, 1, 1);
+  static gold = new Color(1, 0.843137, 0, 1);
+  static goldenrod = new Color(0.854902, 0.647059, 0.12549, 1);
+  static gray = new Color(0.501961, 0.501961, 0.501961, 1);
+  static green = new Color(0, 0.501961, 0, 1);
+  static greenYellow = new Color(0.678431, 1, 0.184314, 1);
+  static honeydew = new Color(0.941176, 1, 0.941176, 1);
+  static hotPink = new Color(1, 0.411765, 0.705882, 1);
+  static indianRed = new Color(0.803922, 0.360784, 0.360784, 1);
+  static indigo = new Color(0.294118, 0, 0.509804, 1);
+  static ivory = new Color(1, 1, 0.941176, 1);
+  static khaki = new Color(0.941176, 0.901961, 0.54902, 1);
+  static lavender = new Color(0.901961, 0.901961, 0.980392, 1);
+  static lavenderBlush = new Color(1, 0.941176, 0.960784, 1);
+  static lawnGreen = new Color(0.486275, 0.988235, 0, 1);
+  static lemonChiffon = new Color(1, 0.980392, 0.803922, 1);
+  static lightBlue = new Color(0.678431, 0.847059, 0.901961, 1);
+  static lightCoral = new Color(0.941176, 0.501961, 0.501961, 1);
+  static lightCyan = new Color(0.878431, 1, 1, 1);
+  static lightGoldenrodYellow = new Color(0.980392, 0.980392, 0.823529, 1);
+  static lightGreen = new Color(0.564706, 0.933333, 0.564706, 1);
+  static lightGrey = new Color(0.827451, 0.827451, 0.827451, 1);
+  static lightPink = new Color(1, 0.713725, 0.756863, 1);
+  static lightSalmon = new Color(1, 0.627451, 0.478431, 1);
+  static lightSeaGreen = new Color(0.12549, 0.698039, 0.666667, 1);
+  static lightSkyBlue = new Color(0.529412, 0.807843, 0.980392, 1);
+  static lightSlateGray = new Color(0.466667, 0.533333, 0.6, 1);
+  static lightSteelBlue = new Color(0.690196, 0.768627, 0.870588, 1);
+  static lightYellow = new Color(1, 1, 0.878431, 1);
+  static lime = new Color(0, 1, 0, 1);
+  static limeGreen = new Color(0.196078, 0.803922, 0.196078, 1);
+  static linen = new Color(0.980392, 0.941176, 0.901961, 1);
+  static magenta = new Color(1, 0, 1, 1);
+  static maroon = new Color(0.501961, 0, 0, 1);
+  static mediumAquamarine = new Color(0.4, 0.803922, 0.666667, 1);
+  static mediumBlue = new Color(0, 0, 0.803922, 1);
+  static mediumOrchid = new Color(0.729412, 0.333333, 0.827451, 1);
+  static mediumPurple = new Color(0.576471, 0.439216, 0.858824, 1);
+  static mediumSeaGreen = new Color(0.235294, 0.701961, 0.443137, 1);
+  static mediumSlateBlue = new Color(0.482353, 0.407843, 0.933333, 1);
+  static mediumSpringGreen = new Color(0, 0.980392, 0.603922, 1);
+  static mediumTurquoise = new Color(0.282353, 0.819608, 0.8, 1);
+  static mediumVioletRed = new Color(0.780392, 0.082353, 0.521569, 1);
+  static midnightBlue = new Color(0.098039, 0.098039, 0.439216, 1);
+  static mintCream = new Color(0.960784, 1, 0.980392, 1);
+  static mistyRose = new Color(1, 0.894118, 0.882353, 1);
+  static moccasin = new Color(1, 0.894118, 0.709804, 1);
+  static navajoWhite = new Color(1, 0.870588, 0.678431, 1);
+  static navy = new Color(0, 0, 0.501961, 1);
+  static oldLace = new Color(0.992157, 0.960784, 0.901961, 1);
+  static olive = new Color(0.501961, 0.501961, 0, 1);
+  static oliveDrab = new Color(0.419608, 0.556863, 0.137255, 1);
+  static orange = new Color(1, 0.647059, 0, 1);
+  static orangeRed = new Color(1, 0.270588, 0, 1);
+  static orchid = new Color(0.854902, 0.439216, 0.839216, 1);
+  static paleGoldenrod = new Color(0.933333, 0.909804, 0.666667, 1);
+  static paleGreen = new Color(0.596078, 0.984314, 0.596078, 1);
+  static paleTurquoise = new Color(0.686275, 0.933333, 0.933333, 1);
+  static paleVioletRed = new Color(0.858824, 0.439216, 0.576471, 1);
+  static papayaWhip = new Color(1, 0.937255, 0.835294, 1);
+  static peachPuff = new Color(1, 0.854902, 0.72549, 1);
+  static peru = new Color(0.803922, 0.521569, 0.247059, 1);
+  static pink = new Color(1, 0.752941, 0.796078, 1);
+  static plum = new Color(0.866667, 0.627451, 0.866667, 1);
+  static powderBlue = new Color(0.690196, 0.878431, 0.901961, 1);
+  static purple = new Color(0.501961, 0, 0.501961, 1);
+  static red = new Color(1, 0, 0, 1);
+  static rosyBrown = new Color(0.737255, 0.560784, 0.560784, 1);
+  static royalBlue = new Color(0.254902, 0.411765, 0.882353, 1);
+  static saddleBrown = new Color(0.545098, 0.270588, 0.07451, 1);
+  static salmon = new Color(0.980392, 0.501961, 0.447059, 1);
+  static sandyBrown = new Color(0.956863, 0.643137, 0.376471, 1);
+  static seaGreen = new Color(0.180392, 0.545098, 0.380392, 1);
+  static seashell = new Color(1, 0.960784, 0.933333, 1);
+  static sienna = new Color(0.627451, 0.321569, 0.176471, 1);
+  static silver = new Color(0.752941, 0.752941, 0.752941, 1);
+  static skyBlue = new Color(0.529412, 0.807843, 0.921569, 1);
+  static slateBlue = new Color(0.415686, 0.352941, 0.803922, 1);
+  static slateGray = new Color(0.466667, 0.533333, 0.6, 1);
+  static snow = new Color(1, 0.980392, 0.980392, 1);
+  static springGreen = new Color(0, 1, 0.498039, 1);
+  static steelBlue = new Color(0.27451, 0.509804, 0.705882, 1);
+  static tan = new Color(0.823529, 0.705882, 0.54902, 1);
+  static teal = new Color(0, 0.501961, 0.501961, 1);
+  static thistle = new Color(0.847059, 0.74902, 0.847059, 1);
+  static tomato = new Color(1, 0.388235, 0.278431, 1);
+  static transparent = new Color(0, 0, 0, 0);
+  static turquoise = new Color(0.25098, 0.878431, 0.815686, 1);
+  static violet = new Color(0.933333, 0.509804, 0.933333, 1);
+  static wheat = new Color(0.960784, 0.870588, 0.701961, 1);
+  static white = new Color(1, 1, 1, 1);
+  static whiteSmoke = new Color(0.960784, 0.960784, 0.960784, 1);
+  static yellow = new Color(1, 1, 0, 1);
+  static yellowGreen = new Color(0.603922, 0.803922, 0.196078, 1);
+  static names = ["aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenrod", "darkGray", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenrod", "gray", "green", "greenYellow", "honeydew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenrodYellow", "lightGreen", "lightGrey", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquamarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenrod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seashell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "transparent", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen"];
+  static get colors() {
+    if (_colors === undefined) {
+      _colors = {};
+      const _c = _colors;
+      const o = Color;
+      Color.names.forEach((name) => {
+        _c[name] = o[name];
+      });
+    }
+    return _colors;
+  }
+}
+
+// src/terminal.ts
+import { format } from "node:util";
+
+class TerminalCore {
+  writer;
+  plain;
+  constructor(writer, options = {}) {
+    this.writer = writer;
+    const envNoColor = typeof process !== "undefined" && !!process?.env?.NO_COLOR;
+    this.plain = options.plain ?? envNoColor;
+  }
+  emit(data) {
+    this.writer.write(data);
+  }
+  style(seq, fmt, args) {
+    const text = format(fmt, ...args);
+    this.emit(this.plain ? text : seq + text);
+    return this;
+  }
+  print(fmt = "", ...args) {
+    this.emit(format(fmt, ...args));
+    return this;
+  }
+  println(fmt = "", ...args) {
+    this.emit(format(fmt, ...args) + `\r
+`);
+    return this;
+  }
+  ink(c, fmt = "", ...args) {
+    const color = typeof c === "string" ? new Color(c) : c;
+    return this.style(color.toAnsiRGB(), fmt, args);
+  }
+  paper(c, fmt = "", ...args) {
+    const color = typeof c === "string" ? new Color(c) : c;
+    return this.style(color.toAnsiBackgroundRGB(), fmt, args);
+  }
+  reset(fmt = "", ...args) {
+    return this.style("\x1B[0m", fmt, args);
+  }
+  resetInk(fmt = "", ...args) {
+    return this.style("\x1B[39m", fmt, args);
+  }
+  resetPaper(fmt = "", ...args) {
+    return this.style("\x1B[49m", fmt, args);
+  }
+  cls() {
+    this.emit("\x1B[2J\x1B[H");
+    return this;
+  }
+  clearLine() {
+    this.emit("\x1B[K");
+    return this;
+  }
+  up(n = 1) {
+    this.emit(`\x1B[${n}A`);
+    return this;
+  }
+  down(n = 1) {
+    this.emit(`\x1B[${n}B`);
+    return this;
+  }
+  right(n = 1) {
+    this.emit(`\x1B[${n}C`);
+    return this;
+  }
+  left(n = 1) {
+    this.emit(`\x1B[${n}D`);
+    return this;
+  }
+  column(n = 1) {
+    this.emit(`\x1B[${n}G`);
+    return this;
+  }
+  row(n = 1) {
+    this.emit(`\x1B[${n}d`);
+    return this;
+  }
+  moveTo(row, col) {
+    this.emit(`\x1B[${row};${col}H`);
+    return this;
+  }
+  saveCursor() {
+    this.emit("\x1B[s");
+    return this;
+  }
+  restoreCursor() {
+    this.emit("\x1B[u");
+    return this;
+  }
+  cursor(visible = true) {
+    this.emit(visible ? "\x1B[?25h" : "\x1B[?25l");
+    return this;
+  }
+  alt(b = true) {
+    this.emit(`\x1B[?1049${b ? "h" : "l"}`);
+    return this;
+  }
+  autoWrap(b = true) {
+    this.emit(`\x1B[?7${b ? "h" : "l"}`);
+    return this;
+  }
+  scrollRegion(top, bottom) {
+    this.emit(`\x1B[${top};${bottom}r`);
+    return this;
+  }
+}
+function installColorMethods() {
+  const proto = TerminalCore.prototype;
+  const cap = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+  for (const key of Object.keys(Color)) {
+    const value = Color[key];
+    if (!(value instanceof Color))
+      continue;
+    const name = key;
+    proto[name] = function(fmt = "", ...args) {
+      return this.ink(value, fmt, ...args);
+    };
+    proto[`bg${cap(name)}`] = function(fmt = "", ...args) {
+      return this.paper(value, fmt, ...args);
+    };
+  }
+}
+installColorMethods();
+function createTerminal(writer, options = {}) {
+  return new TerminalCore(writer, options);
+}
+export {
+  createTerminal,
+  TerminalCore
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retrovm/terminal",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Fluent ANSI terminal library — 24-bit color, cursor control and screen management for Bun and Node.js",
   "author": "Juan Carlos González Amestoy",
   "license": "MIT",
@@ -20,18 +20,29 @@
   },
   "type": "module",
   "module": "src/terminal.ts",
+  "scripts": {
+    "build": "bun build src/terminal.ts src/node.ts --outdir dist --target node && tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build"
+  },
   "exports": {
     ".": {
       "bun": "./src/bun.ts",
-      "types": "./src/bun.ts",
-      "import": "./src/terminal.ts"
+      "node": {
+        "types": "./dist/node.d.ts",
+        "default": "./dist/node.js"
+      },
+      "types": "./dist/node.d.ts",
+      "import": "./dist/terminal.js"
     }
   },
   "files": [
-    "src"
+    "src",
+    "dist"
   ],
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "latest",
+    "@types/node": "^25.8.0",
+    "typescript": "^5"
   },
   "peerDependencies": {
     "typescript": "^5"

package/src/node.ts

@@ -0,0 +1,7 @@
+import { createTerminal } from "./terminal"
+export { createTerminal, type ITerminal, type ITerminalWriter } from "./terminal"
+
+export const Terminal = {
+  out: createTerminal(process.stdout),
+  err: createTerminal(process.stderr),
+}