termdot 0.0.1

package/README.md

@@ -0,0 +1,121 @@
+# termdot
+
+Draw in the terminal with Unicode braille characters (U+2800–U+28FF). Each character is a 2×4 pixel grid — giving you 8 dots per cell for high-resolution terminal graphics.
+
+## Install
+
+```sh
+npm install termdot
+```
+
+## Usage
+
+```ts
+import {createCanvas, set, frame, line} from 'termdot';
+
+const c = createCanvas();
+
+// Draw a sine wave
+for (let x = 0; x < 100; x++) {
+  set(c, x, Math.sin(x / 10) * 10 + 10);
+}
+
+// Draw a line
+for (const pt of line(0, 0, 50, 20)) {
+  set(c, pt.x, pt.y);
+}
+
+console.log(frame(c));
+```
+
+## API
+
+### Sparse Canvas
+
+Auto-expanding canvas backed by a `Map`. Grows as you draw.
+
+```ts
+createCanvas(options?)     // Create a canvas
+set(canvas, x, y)          // Draw a pixel
+unset(canvas, x, y)        // Erase a pixel
+toggle(canvas, x, y)       // Toggle a pixel
+get(canvas, x, y)          // Check if pixel is set
+clear(canvas)              // Clear all pixels
+setText(canvas, x, y, str) // Overlay text at position
+frame(canvas, bounds?)     // Render to string
+rows(canvas, bounds?)      // Render to string[]
+```
+
+### Fixed Canvas
+
+Fixed-size canvas backed by a `Uint8Array`. Fast, predictable bounds.
+
+```ts
+createFixedCanvas(width, height) // Create fixed canvas
+fixedSet(canvas, x, y)           // Draw a pixel
+fixedUnset(canvas, x, y)         // Erase a pixel
+fixedToggle(canvas, x, y)        // Toggle a pixel
+fixedGet(canvas, x, y)           // Check if pixel is set
+fixedClear(canvas)               // Clear all pixels
+fixedFrame(canvas, delimiter?)   // Render to string
+```
+
+### Drawing
+
+```ts
+line(x1, y1, x2, y2)                    // Line generator (Bresenham)
+polygon(centerX, centerY, sides, radius) // Regular polygon generator
+```
+
+### Turtle Graphics
+
+```ts
+createTurtle(x?, y?)       // Create turtle at position
+turtleForward(t, step)     // Move forward
+turtleBack(t, step)        // Move backward
+turtleRight(t, angle)      // Rotate clockwise
+turtleLeft(t, angle)       // Rotate counter-clockwise
+turtleUp(t)                // Lift brush (stop drawing)
+turtleDown(t)              // Lower brush (start drawing)
+turtleMove(t, x, y)        // Move to absolute position
+```
+
+### Utilities
+
+```ts
+getTerminalSize()                    // Get terminal {width, height}
+animate(canvas, generator, options?) // Run animation loop
+normalize(coord)                     // Round to nearest int
+getPos(x, y)                        // Pixel → cell coords
+```
+
+## Braille Dot Layout
+
+Each character cell maps to a 2×4 pixel grid:
+
+```
+,___,
+|1 4|
+|2 5|
+|3 6|
+|7 8|
+`````
+```
+
+## Examples
+
+```sh
+npx tsx examples/basic.ts          # Sine waves, fills, toggles
+npx tsx examples/turtle.ts         # Spirograph
+npx tsx examples/clock.ts          # Animated analog clock
+npx tsx examples/sine-wave.ts      # Animated sine wave
+npx tsx examples/rotating-cube.ts  # 3D wireframe cube
+npx tsx examples/cube.ts           # Perspective-projected cube
+npx tsx examples/speed-test.ts     # Benchmark
+npx tsx examples/spinners.ts       # Braille status indicators
+npx tsx examples/kitchen-sink.ts   # Every feature demo
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,416 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BRAILLE_OFFSET: () => BRAILLE_OFFSET,
+  PIXEL_MAP: () => PIXEL_MAP,
+  animate: () => animate,
+  clear: () => clear,
+  createCanvas: () => createCanvas,
+  createFixedCanvas: () => createFixedCanvas,
+  createTurtle: () => createTurtle,
+  fixedClear: () => fixedClear,
+  fixedFrame: () => fixedFrame,
+  fixedGet: () => fixedGet,
+  fixedSet: () => fixedSet,
+  fixedToggle: () => fixedToggle,
+  fixedUnset: () => fixedUnset,
+  frame: () => frame,
+  get: () => get,
+  getPos: () => getPos,
+  getTerminalSize: () => getTerminalSize,
+  line: () => line,
+  normalize: () => normalize,
+  polygon: () => polygon,
+  rows: () => rows,
+  set: () => set,
+  setText: () => setText,
+  toggle: () => toggle,
+  turtleBack: () => turtleBack,
+  turtleDown: () => turtleDown,
+  turtleForward: () => turtleForward,
+  turtleLeft: () => turtleLeft,
+  turtleMove: () => turtleMove,
+  turtleRight: () => turtleRight,
+  turtleUp: () => turtleUp,
+  unset: () => unset
+});
+module.exports = __toCommonJS(index_exports);
+var BRAILLE_OFFSET = 10240;
+var PIXEL_MAP = [
+  [1, 8],
+  [2, 16],
+  [4, 32],
+  [64, 128]
+];
+function normalize(coord) {
+  return Math.round(coord);
+}
+function getPos(x, y) {
+  return [Math.floor(normalize(x) / 2), Math.floor(normalize(y) / 4)];
+}
+function createCanvas(options) {
+  return {
+    chars: /* @__PURE__ */ new Map(),
+    lineEnding: options?.lineEnding ?? "\n"
+  };
+}
+function clear(canvas) {
+  canvas.chars.clear();
+}
+function set(canvas, x, y) {
+  const nx = normalize(x);
+  const ny = normalize(y);
+  const [col, row] = getPos(nx, ny);
+  let rowMap = canvas.chars.get(row);
+  if (!rowMap) {
+    rowMap = /* @__PURE__ */ new Map();
+    canvas.chars.set(row, rowMap);
+  }
+  const current = rowMap.get(col);
+  if (current !== void 0 && typeof current !== "number") {
+    return;
+  }
+  const mask = PIXEL_MAP[ny % 4]?.[nx % 2];
+  if (mask === void 0) return;
+  rowMap.set(col, (current ?? 0) | mask);
+}
+function unset(canvas, x, y) {
+  const nx = normalize(x);
+  const ny = normalize(y);
+  const [col, row] = getPos(nx, ny);
+  const rowMap = canvas.chars.get(row);
+  if (!rowMap) return;
+  const current = rowMap.get(col);
+  if (current === void 0 || typeof current !== "number") return;
+  const mask = PIXEL_MAP[ny % 4]?.[nx % 2];
+  if (mask === void 0) return;
+  const updated = current & ~mask;
+  if (updated === 0) {
+    rowMap.delete(col);
+    if (rowMap.size === 0) {
+      canvas.chars.delete(row);
+    }
+    return;
+  }
+  rowMap.set(col, updated);
+}
+function toggle(canvas, x, y) {
+  const nx = normalize(x);
+  const ny = normalize(y);
+  const [col, row] = getPos(nx, ny);
+  const rowMap = canvas.chars.get(row);
+  const current = rowMap?.get(col);
+  const mask = PIXEL_MAP[ny % 4]?.[nx % 2];
+  if (mask === void 0) return;
+  if (current !== void 0 && (typeof current !== "number" || (current & mask) !== 0)) {
+    unset(canvas, x, y);
+  } else {
+    set(canvas, x, y);
+  }
+}
+function get(canvas, x, y) {
+  const nx = normalize(x);
+  const ny = normalize(y);
+  const [col, row] = getPos(nx, ny);
+  const rowMap = canvas.chars.get(row);
+  if (!rowMap) return false;
+  const cell = rowMap.get(col);
+  if (cell === void 0) return false;
+  if (typeof cell !== "number") return true;
+  const mask = PIXEL_MAP[ny % 4]?.[nx % 2];
+  if (mask === void 0) return false;
+  return (cell & mask) !== 0;
+}
+function setText(canvas, x, y, text) {
+  const [col, row] = getPos(x, y);
+  let rowMap = canvas.chars.get(row);
+  if (!rowMap) {
+    rowMap = /* @__PURE__ */ new Map();
+    canvas.chars.set(row, rowMap);
+  }
+  for (let i = 0; i < text.length; i++) {
+    rowMap.set(col + i, text[i]);
+  }
+}
+function rows(canvas, bounds) {
+  if (canvas.chars.size === 0) return [];
+  const allRows = [...canvas.chars.keys()];
+  const minRow = bounds?.minY != null ? Math.floor(bounds.minY / 4) : Math.min(...allRows);
+  const maxRow = bounds?.maxY != null ? Math.floor((bounds.maxY - 1) / 4) : Math.max(...allRows);
+  let globalMinCol;
+  if (bounds?.minX != null) {
+    globalMinCol = Math.floor(bounds.minX / 2);
+  } else {
+    let min = Number.POSITIVE_INFINITY;
+    for (const rowMap of canvas.chars.values()) {
+      for (const c of rowMap.keys()) {
+        if (c < min) min = c;
+      }
+    }
+    globalMinCol = min === Number.POSITIVE_INFINITY ? 0 : min;
+  }
+  const result = [];
+  for (let rowNum = minRow; rowNum <= maxRow; rowNum++) {
+    const rowMap = canvas.chars.get(rowNum);
+    if (!rowMap) {
+      result.push("");
+      continue;
+    }
+    let maxCol;
+    if (bounds?.maxX != null) {
+      maxCol = Math.floor((bounds.maxX - 1) / 2);
+    } else {
+      maxCol = Math.max(...rowMap.keys());
+    }
+    const chars = [];
+    for (let c = globalMinCol; c <= maxCol; c++) {
+      const cell = rowMap.get(c);
+      if (cell === void 0 || cell === 0) {
+        chars.push(" ");
+      } else if (typeof cell !== "number") {
+        chars.push(cell);
+      } else {
+        chars.push(String.fromCharCode(BRAILLE_OFFSET + cell));
+      }
+    }
+    result.push(chars.join(""));
+  }
+  return result;
+}
+function frame(canvas, bounds) {
+  return rows(canvas, bounds).join(canvas.lineEnding);
+}
+function* line(x1, y1, x2, y2) {
+  const nx1 = normalize(x1);
+  const ny1 = normalize(y1);
+  const nx2 = normalize(x2);
+  const ny2 = normalize(y2);
+  const xDiff = Math.abs(nx2 - nx1);
+  const yDiff = Math.abs(ny2 - ny1);
+  const xDir = nx1 <= nx2 ? 1 : -1;
+  const yDir = ny1 <= ny2 ? 1 : -1;
+  const steps = Math.max(xDiff, yDiff);
+  for (let i = 0; i <= steps; i++) {
+    let px = nx1;
+    let py = ny1;
+    if (yDiff) {
+      py += Math.round(i * yDiff / steps) * yDir;
+    }
+    if (xDiff) {
+      px += Math.round(i * xDiff / steps) * xDir;
+    }
+    yield { x: px, y: py };
+  }
+}
+function* polygon(centerX = 0, centerY = 0, sides = 4, radius = 4) {
+  const degree = 360 / sides;
+  for (let n = 0; n < sides; n++) {
+    const a = n * degree;
+    const b = (n + 1) * degree;
+    const x1 = (centerX + Math.cos(a * Math.PI / 180)) * ((radius + 1) / 2);
+    const y1 = (centerY + Math.sin(a * Math.PI / 180)) * ((radius + 1) / 2);
+    const x2 = (centerX + Math.cos(b * Math.PI / 180)) * ((radius + 1) / 2);
+    const y2 = (centerY + Math.sin(b * Math.PI / 180)) * ((radius + 1) / 2);
+    for (const pt of line(x1, y1, x2, y2)) {
+      yield pt;
+    }
+  }
+}
+function createTurtle(posX = 0, posY = 0) {
+  return {
+    canvas: createCanvas(),
+    posX,
+    posY,
+    rotation: 0,
+    brushOn: true
+  };
+}
+function turtleUp(t) {
+  t.brushOn = false;
+}
+function turtleDown(t) {
+  t.brushOn = true;
+}
+function turtleMove(t, x, y) {
+  if (t.brushOn) {
+    for (const pt of line(t.posX, t.posY, x, y)) {
+      set(t.canvas, pt.x, pt.y);
+    }
+  }
+  t.posX = x;
+  t.posY = y;
+}
+function turtleForward(t, step) {
+  const x = t.posX + Math.cos(t.rotation * Math.PI / 180) * step;
+  const y = t.posY + Math.sin(t.rotation * Math.PI / 180) * step;
+  const prevBrush = t.brushOn;
+  t.brushOn = true;
+  turtleMove(t, x, y);
+  t.brushOn = prevBrush;
+}
+function turtleBack(t, step) {
+  turtleForward(t, -step);
+}
+function turtleRight(t, angle) {
+  t.rotation += angle;
+}
+function turtleLeft(t, angle) {
+  t.rotation -= angle;
+}
+function getTerminalSize() {
+  const width = process.stdout?.columns ?? 80;
+  const height = process.stdout?.rows ?? 25;
+  return { width, height };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function animate(canvas, fn, options) {
+  const delay = options?.delay ?? 1e3 / 24;
+  for (const points of fn()) {
+    if (options?.signal?.aborted) break;
+    for (const pt of points) {
+      set(canvas, pt.x, pt.y);
+    }
+    const f = frame(canvas);
+    process.stdout.write(`\x1B[H\x1B[J${f}
+`);
+    if (delay > 0) {
+      await sleep(delay);
+    }
+    clear(canvas);
+  }
+}
+function createFixedCanvas(width, height) {
+  const w = Math.floor(width / 2) * 2;
+  const h = Math.floor(height / 4) * 4;
+  return {
+    width: w,
+    height: h,
+    content: new Uint8Array(w * h / 8)
+  };
+}
+function fixedClear(canvas) {
+  canvas.content.fill(0);
+}
+function fixedSet(canvas, x, y) {
+  if (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;
+  const fx = Math.floor(x);
+  const fy = Math.floor(y);
+  const nx = Math.floor(fx / 2);
+  const ny = Math.floor(fy / 4);
+  const coord = nx + canvas.width / 2 * ny;
+  const mask = PIXEL_MAP[fy % 4]?.[fx % 2];
+  if (mask === void 0) return;
+  const val = canvas.content[coord];
+  if (val === void 0) return;
+  canvas.content[coord] = val | mask;
+}
+function fixedUnset(canvas, x, y) {
+  if (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;
+  const fx = Math.floor(x);
+  const fy = Math.floor(y);
+  const nx = Math.floor(fx / 2);
+  const ny = Math.floor(fy / 4);
+  const coord = nx + canvas.width / 2 * ny;
+  const mask = PIXEL_MAP[fy % 4]?.[fx % 2];
+  if (mask === void 0) return;
+  const val = canvas.content[coord];
+  if (val === void 0) return;
+  canvas.content[coord] = val & ~mask;
+}
+function fixedToggle(canvas, x, y) {
+  if (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;
+  const fx = Math.floor(x);
+  const fy = Math.floor(y);
+  const nx = Math.floor(fx / 2);
+  const ny = Math.floor(fy / 4);
+  const coord = nx + canvas.width / 2 * ny;
+  const mask = PIXEL_MAP[fy % 4]?.[fx % 2];
+  if (mask === void 0) return;
+  const val = canvas.content[coord];
+  if (val === void 0) return;
+  canvas.content[coord] = val ^ mask;
+}
+function fixedGet(canvas, x, y) {
+  if (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height))
+    return false;
+  const fx = Math.floor(x);
+  const fy = Math.floor(y);
+  const nx = Math.floor(fx / 2);
+  const ny = Math.floor(fy / 4);
+  const coord = nx + canvas.width / 2 * ny;
+  const mask = PIXEL_MAP[fy % 4]?.[fx % 2];
+  if (mask === void 0) return false;
+  const val = canvas.content[coord];
+  if (val === void 0) return false;
+  return (val & mask) !== 0;
+}
+function fixedFrame(canvas, delimiter = "\n") {
+  const frameWidth = canvas.width / 2;
+  const parts = [];
+  for (let i = 0; i < canvas.content.length; i++) {
+    if (i % frameWidth === 0) {
+      parts.push(delimiter);
+    }
+    const val = canvas.content[i];
+    parts.push(val ? String.fromCharCode(BRAILLE_OFFSET + val) : " ");
+  }
+  parts.push(delimiter);
+  return parts.join("");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BRAILLE_OFFSET,
+  PIXEL_MAP,
+  animate,
+  clear,
+  createCanvas,
+  createFixedCanvas,
+  createTurtle,
+  fixedClear,
+  fixedFrame,
+  fixedGet,
+  fixedSet,
+  fixedToggle,
+  fixedUnset,
+  frame,
+  get,
+  getPos,
+  getTerminalSize,
+  line,
+  normalize,
+  polygon,
+  rows,
+  set,
+  setText,
+  toggle,
+  turtleBack,
+  turtleDown,
+  turtleForward,
+  turtleLeft,
+  turtleMove,
+  turtleRight,
+  turtleUp,
+  unset
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * btui — Braille TUI canvas for terminal drawing with Unicode braille characters.\n *\n * Braille dot layout per character cell:\n *   ,___,\n *   |1 4|\n *   |2 5|\n *   |3 6|\n *   |7 8|\n *   `````\n *\n * Each character maps to a 2x4 pixel grid.\n * Unicode braille characters: U+2800 to U+28FF.\n */\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst BRAILLE_OFFSET = 0x2800;\n\nconst PIXEL_MAP: readonly (readonly [number, number])[] = [\n\t[0x01, 0x08],\n\t[0x02, 0x10],\n\t[0x04, 0x20],\n\t[0x40, 0x80],\n] as const;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** A single cell can hold a braille bitmask (number) or a text character (string). */\ntype CellValue = number | string;\n\n/** Sparse row → col → cell storage. */\ninterface CanvasChars {\n\treadonly [row: number]: {readonly [col: number]: CellValue} | undefined;\n}\n\n/** The braille canvas data structure. */\ninterface Canvas {\n\tchars: Map<number, Map<number, CellValue>>;\n\treadonly lineEnding: string;\n}\n\n/** Options for creating a canvas. */\ninterface CreateCanvasOptions {\n\treadonly lineEnding?: string;\n}\n\n/** Bounds for frame/rows rendering. */\ninterface FrameBounds {\n\treadonly minX?: number;\n\treadonly minY?: number;\n\treadonly maxX?: number;\n\treadonly maxY?: number;\n}\n\n/** A 2D point. */\ninterface Point {\n\treadonly x: number;\n\treadonly y: number;\n}\n\n/** Turtle graphics state. */\ninterface TurtleState {\n\treadonly canvas: Canvas;\n\tposX: number;\n\tposY: number;\n\trotation: number;\n\tbrushOn: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Coordinate helpers\n// ---------------------------------------------------------------------------\n\n/** Normalize a coordinate to an integer. */\nfunction normalize(coord: number): number {\n\treturn Math.round(coord);\n}\n\n/** Convert pixel (x, y) to cell (col, row). */\nfunction getPos(x: number, y: number): readonly [number, number] {\n\treturn [Math.floor(normalize(x) / 2), Math.floor(normalize(y) / 4)];\n}\n\n// ---------------------------------------------------------------------------\n// Canvas — creation & mutation\n// ---------------------------------------------------------------------------\n\n/** Create a new braille canvas. */\nfunction createCanvas(options?: CreateCanvasOptions): Canvas {\n\treturn {\n\t\tchars: new Map(),\n\t\tlineEnding: options?.lineEnding ?? '\\n',\n\t};\n}\n\n/** Remove all pixels from the canvas. */\nfunction clear(canvas: Canvas): void {\n\tcanvas.chars.clear();\n}\n\n/** Set (draw) a pixel at (x, y). */\nfunction set(canvas: Canvas, x: number, y: number): void {\n\tconst nx = normalize(x);\n\tconst ny = normalize(y);\n\tconst [col, row] = getPos(nx, ny);\n\n\tlet rowMap = canvas.chars.get(row);\n\tif (!rowMap) {\n\t\trowMap = new Map();\n\t\tcanvas.chars.set(row, rowMap);\n\t}\n\n\tconst current = rowMap.get(col);\n\tif (current !== undefined && typeof current !== 'number') {\n\t\treturn;\n\t}\n\n\tconst mask = PIXEL_MAP[ny % 4]?.[nx % 2];\n\tif (mask === undefined) return;\n\n\trowMap.set(col, ((current as number | undefined) ?? 0) | mask);\n}\n\n/** Unset (erase) a pixel at (x, y). */\nfunction unset(canvas: Canvas, x: number, y: number): void {\n\tconst nx = normalize(x);\n\tconst ny = normalize(y);\n\tconst [col, row] = getPos(nx, ny);\n\n\tconst rowMap = canvas.chars.get(row);\n\tif (!rowMap) return;\n\n\tconst current = rowMap.get(col);\n\tif (current === undefined || typeof current !== 'number') return;\n\n\tconst mask = PIXEL_MAP[ny % 4]?.[nx % 2];\n\tif (mask === undefined) return;\n\n\tconst updated = current & ~mask;\n\tif (updated === 0) {\n\t\trowMap.delete(col);\n\t\tif (rowMap.size === 0) {\n\t\t\tcanvas.chars.delete(row);\n\t\t}\n\t\treturn;\n\t}\n\n\trowMap.set(col, updated);\n}\n\n/** Toggle a pixel at (x, y). */\nfunction toggle(canvas: Canvas, x: number, y: number): void {\n\tconst nx = normalize(x);\n\tconst ny = normalize(y);\n\tconst [col, row] = getPos(nx, ny);\n\n\tconst rowMap = canvas.chars.get(row);\n\tconst current = rowMap?.get(col);\n\n\tconst mask = PIXEL_MAP[ny % 4]?.[nx % 2];\n\tif (mask === undefined) return;\n\n\tif (\n\t\tcurrent !== undefined &&\n\t\t(typeof current !== 'number' || (current & mask) !== 0)\n\t) {\n\t\tunset(canvas, x, y);\n\t} else {\n\t\tset(canvas, x, y);\n\t}\n}\n\n/** Get the state of a pixel at (x, y). Returns true if set. */\nfunction get(canvas: Canvas, x: number, y: number): boolean {\n\tconst nx = normalize(x);\n\tconst ny = normalize(y);\n\tconst [col, row] = getPos(nx, ny);\n\n\tconst rowMap = canvas.chars.get(row);\n\tif (!rowMap) return false;\n\n\tconst cell = rowMap.get(col);\n\tif (cell === undefined) return false;\n\tif (typeof cell !== 'number') return true;\n\n\tconst mask = PIXEL_MAP[ny % 4]?.[nx % 2];\n\tif (mask === undefined) return false;\n\n\treturn (cell & mask) !== 0;\n}\n\n/** Set text at the given pixel coords. Each character occupies one cell column. */\nfunction setText(canvas: Canvas, x: number, y: number, text: string): void {\n\tconst [col, row] = getPos(x, y);\n\n\tlet rowMap = canvas.chars.get(row);\n\tif (!rowMap) {\n\t\trowMap = new Map();\n\t\tcanvas.chars.set(row, rowMap);\n\t}\n\n\tfor (let i = 0; i < text.length; i++) {\n\t\trowMap.set(col + i, text[i] as string);\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Canvas — rendering\n// ---------------------------------------------------------------------------\n\n/** Return the canvas content as an array of strings (one per row). */\nfunction rows(canvas: Canvas, bounds?: FrameBounds): readonly string[] {\n\tif (canvas.chars.size === 0) return [];\n\n\tconst allRows = [...canvas.chars.keys()];\n\tconst minRow =\n\t\tbounds?.minY != null\n\t\t\t? Math.floor(bounds.minY / 4)\n\t\t\t: Math.min(...allRows);\n\tconst maxRow =\n\t\tbounds?.maxY != null\n\t\t\t? Math.floor((bounds.maxY - 1) / 4)\n\t\t\t: Math.max(...allRows);\n\n\t// Global min col for left alignment\n\tlet globalMinCol: number;\n\tif (bounds?.minX != null) {\n\t\tglobalMinCol = Math.floor(bounds.minX / 2);\n\t} else {\n\t\tlet min = Number.POSITIVE_INFINITY;\n\t\tfor (const rowMap of canvas.chars.values()) {\n\t\t\tfor (const c of rowMap.keys()) {\n\t\t\t\tif (c < min) min = c;\n\t\t\t}\n\t\t}\n\t\tglobalMinCol = min === Number.POSITIVE_INFINITY ? 0 : min;\n\t}\n\n\tconst result: string[] = [];\n\n\tfor (let rowNum = minRow; rowNum <= maxRow; rowNum++) {\n\t\tconst rowMap = canvas.chars.get(rowNum);\n\t\tif (!rowMap) {\n\t\t\tresult.push('');\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet maxCol: number;\n\t\tif (bounds?.maxX != null) {\n\t\t\tmaxCol = Math.floor((bounds.maxX - 1) / 2);\n\t\t} else {\n\t\t\tmaxCol = Math.max(...rowMap.keys());\n\t\t}\n\n\t\tconst chars: string[] = [];\n\t\tfor (let c = globalMinCol; c <= maxCol; c++) {\n\t\t\tconst cell = rowMap.get(c);\n\t\t\tif (cell === undefined || cell === 0) {\n\t\t\t\tchars.push(' ');\n\t\t\t} else if (typeof cell !== 'number') {\n\t\t\t\tchars.push(cell);\n\t\t\t} else {\n\t\t\t\tchars.push(String.fromCharCode(BRAILLE_OFFSET + cell));\n\t\t\t}\n\t\t}\n\n\t\tresult.push(chars.join(''));\n\t}\n\n\treturn result;\n}\n\n/** Render the canvas as a string. */\nfunction frame(canvas: Canvas, bounds?: FrameBounds): string {\n\treturn rows(canvas, bounds).join(canvas.lineEnding);\n}\n\n// ---------------------------------------------------------------------------\n// Drawing utilities — line\n// ---------------------------------------------------------------------------\n\n/** Generate coordinates along a line from (x1, y1) to (x2, y2) using Bresenham-style interpolation. */\nfunction* line(\n\tx1: number,\n\ty1: number,\n\tx2: number,\n\ty2: number,\n): Generator<Point, void, unknown> {\n\tconst nx1 = normalize(x1);\n\tconst ny1 = normalize(y1);\n\tconst nx2 = normalize(x2);\n\tconst ny2 = normalize(y2);\n\n\tconst xDiff = Math.abs(nx2 - nx1);\n\tconst yDiff = Math.abs(ny2 - ny1);\n\tconst xDir = nx1 <= nx2 ? 1 : -1;\n\tconst yDir = ny1 <= ny2 ? 1 : -1;\n\n\tconst steps = Math.max(xDiff, yDiff);\n\n\tfor (let i = 0; i <= steps; i++) {\n\t\tlet px = nx1;\n\t\tlet py = ny1;\n\n\t\tif (yDiff) {\n\t\t\tpy += Math.round((i * yDiff) / steps) * yDir;\n\t\t}\n\t\tif (xDiff) {\n\t\t\tpx += Math.round((i * xDiff) / steps) * xDir;\n\t\t}\n\n\t\tyield {x: px, y: py};\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Drawing utilities — polygon\n// ---------------------------------------------------------------------------\n\n/** Generate coordinates for a regular polygon. */\nfunction* polygon(\n\tcenterX = 0,\n\tcenterY = 0,\n\tsides = 4,\n\tradius = 4,\n): Generator<Point, void, unknown> {\n\tconst degree = 360 / sides;\n\n\tfor (let n = 0; n < sides; n++) {\n\t\tconst a = n * degree;\n\t\tconst b = (n + 1) * degree;\n\t\tconst x1 =\n\t\t\t(centerX + Math.cos((a * Math.PI) / 180)) * ((radius + 1) / 2);\n\t\tconst y1 =\n\t\t\t(centerY + Math.sin((a * Math.PI) / 180)) * ((radius + 1) / 2);\n\t\tconst x2 =\n\t\t\t(centerX + Math.cos((b * Math.PI) / 180)) * ((radius + 1) / 2);\n\t\tconst y2 =\n\t\t\t(centerY + Math.sin((b * Math.PI) / 180)) * ((radius + 1) / 2);\n\n\t\tfor (const pt of line(x1, y1, x2, y2)) {\n\t\t\tyield pt;\n\t\t}\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Turtle graphics\n// ---------------------------------------------------------------------------\n\n/** Create a new turtle state. */\nfunction createTurtle(posX = 0, posY = 0): TurtleState {\n\treturn {\n\t\tcanvas: createCanvas(),\n\t\tposX,\n\t\tposY,\n\t\trotation: 0,\n\t\tbrushOn: true,\n\t};\n}\n\n/** Pull the brush up (stop drawing on move). */\nfunction turtleUp(t: TurtleState): void {\n\tt.brushOn = false;\n}\n\n/** Push the brush down (draw on move). */\nfunction turtleDown(t: TurtleState): void {\n\tt.brushOn = true;\n}\n\n/** Move the turtle to an absolute position, drawing if the brush is down. */\nfunction turtleMove(t: TurtleState, x: number, y: number): void {\n\tif (t.brushOn) {\n\t\tfor (const pt of line(t.posX, t.posY, x, y)) {\n\t\t\tset(t.canvas, pt.x, pt.y);\n\t\t}\n\t}\n\tt.posX = x;\n\tt.posY = y;\n}\n\n/** Move the turtle forward by `step` pixels in its current direction. */\nfunction turtleForward(t: TurtleState, step: number): void {\n\tconst x = t.posX + Math.cos((t.rotation * Math.PI) / 180) * step;\n\tconst y = t.posY + Math.sin((t.rotation * Math.PI) / 180) * step;\n\tconst prevBrush = t.brushOn;\n\tt.brushOn = true;\n\tturtleMove(t, x, y);\n\tt.brushOn = prevBrush;\n}\n\n/** Move the turtle backward by `step` pixels. */\nfunction turtleBack(t: TurtleState, step: number): void {\n\tturtleForward(t, -step);\n}\n\n/** Rotate the turtle right (clockwise) by `angle` degrees. */\nfunction turtleRight(t: TurtleState, angle: number): void {\n\tt.rotation += angle;\n}\n\n/** Rotate the turtle left (counter-clockwise) by `angle` degrees. */\nfunction turtleLeft(t: TurtleState, angle: number): void {\n\tt.rotation -= angle;\n}\n\n// ---------------------------------------------------------------------------\n// Terminal size\n// ---------------------------------------------------------------------------\n\n/** Terminal dimensions in characters. */\ninterface TerminalSize {\n\treadonly width: number;\n\treadonly height: number;\n}\n\n/** Get terminal width and height. Falls back to 80x25. */\nfunction getTerminalSize(): TerminalSize {\n\tconst width = process.stdout?.columns ?? 80;\n\tconst height = process.stdout?.rows ?? 25;\n\treturn {width, height};\n}\n\n// ---------------------------------------------------------------------------\n// Animation\n// ---------------------------------------------------------------------------\n\n/** Options for the animate function. */\ninterface AnimateOptions {\n\treadonly delay?: number;\n\treadonly signal?: AbortSignal;\n}\n\n/** Frame generator yields arrays of points per frame. */\ntype FrameGenerator = Generator<readonly Point[], void, unknown>;\n\n/** Sleep for the given number of milliseconds. */\nfunction sleep(ms: number): Promise<void> {\n\treturn new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/** Run an animation loop. Clears the canvas each frame, draws points from the generator, and writes to stdout. */\nasync function animate(\n\tcanvas: Canvas,\n\tfn: () => FrameGenerator,\n\toptions?: AnimateOptions,\n): Promise<void> {\n\tconst delay = options?.delay ?? 1000 / 24;\n\n\tfor (const points of fn()) {\n\t\tif (options?.signal?.aborted) break;\n\n\t\tfor (const pt of points) {\n\t\t\tset(canvas, pt.x, pt.y);\n\t\t}\n\n\t\tconst f = frame(canvas);\n\t\tprocess.stdout.write(`\\x1b[H\\x1b[J${f}\\n`);\n\n\t\tif (delay > 0) {\n\t\t\tawait sleep(delay);\n\t\t}\n\n\t\tclear(canvas);\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Fixed-size canvas (node-drawille style)\n// ---------------------------------------------------------------------------\n\n/** A fixed-size canvas backed by a Uint8Array buffer. */\ninterface FixedCanvas {\n\treadonly width: number;\n\treadonly height: number;\n\treadonly content: Uint8Array;\n}\n\n/** Create a fixed-size canvas with the given dimensions. Width rounds to multiple of 2, height to multiple of 4. */\nfunction createFixedCanvas(width: number, height: number): FixedCanvas {\n\tconst w = Math.floor(width / 2) * 2;\n\tconst h = Math.floor(height / 4) * 4;\n\treturn {\n\t\twidth: w,\n\t\theight: h,\n\t\tcontent: new Uint8Array((w * h) / 8),\n\t};\n}\n\n/** Clear all pixels from a fixed canvas. */\nfunction fixedClear(canvas: FixedCanvas): void {\n\tcanvas.content.fill(0);\n}\n\n/** Set a pixel on a fixed canvas. */\nfunction fixedSet(canvas: FixedCanvas, x: number, y: number): void {\n\tif (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;\n\tconst fx = Math.floor(x);\n\tconst fy = Math.floor(y);\n\tconst nx = Math.floor(fx / 2);\n\tconst ny = Math.floor(fy / 4);\n\tconst coord = nx + (canvas.width / 2) * ny;\n\tconst mask = PIXEL_MAP[fy % 4]?.[fx % 2];\n\tif (mask === undefined) return;\n\tconst val = canvas.content[coord];\n\tif (val === undefined) return;\n\tcanvas.content[coord] = val | mask;\n}\n\n/** Unset a pixel on a fixed canvas. */\nfunction fixedUnset(canvas: FixedCanvas, x: number, y: number): void {\n\tif (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;\n\tconst fx = Math.floor(x);\n\tconst fy = Math.floor(y);\n\tconst nx = Math.floor(fx / 2);\n\tconst ny = Math.floor(fy / 4);\n\tconst coord = nx + (canvas.width / 2) * ny;\n\tconst mask = PIXEL_MAP[fy % 4]?.[fx % 2];\n\tif (mask === undefined) return;\n\tconst val = canvas.content[coord];\n\tif (val === undefined) return;\n\tcanvas.content[coord] = val & ~mask;\n}\n\n/** Toggle a pixel on a fixed canvas. */\nfunction fixedToggle(canvas: FixedCanvas, x: number, y: number): void {\n\tif (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;\n\tconst fx = Math.floor(x);\n\tconst fy = Math.floor(y);\n\tconst nx = Math.floor(fx / 2);\n\tconst ny = Math.floor(fy / 4);\n\tconst coord = nx + (canvas.width / 2) * ny;\n\tconst mask = PIXEL_MAP[fy % 4]?.[fx % 2];\n\tif (mask === undefined) return;\n\tconst val = canvas.content[coord];\n\tif (val === undefined) return;\n\tcanvas.content[coord] = val ^ mask;\n}\n\n/** Get the state of a pixel on a fixed canvas. */\nfunction fixedGet(canvas: FixedCanvas, x: number, y: number): boolean {\n\tif (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height))\n\t\treturn false;\n\tconst fx = Math.floor(x);\n\tconst fy = Math.floor(y);\n\tconst nx = Math.floor(fx / 2);\n\tconst ny = Math.floor(fy / 4);\n\tconst coord = nx + (canvas.width / 2) * ny;\n\tconst mask = PIXEL_MAP[fy % 4]?.[fx % 2];\n\tif (mask === undefined) return false;\n\tconst val = canvas.content[coord];\n\tif (val === undefined) return false;\n\treturn (val & mask) !== 0;\n}\n\n/** Render a fixed canvas as a string. */\nfunction fixedFrame(canvas: FixedCanvas, delimiter = '\\n'): string {\n\tconst frameWidth = canvas.width / 2;\n\tconst parts: string[] = [];\n\n\tfor (let i = 0; i < canvas.content.length; i++) {\n\t\tif (i % frameWidth === 0) {\n\t\t\tparts.push(delimiter);\n\t\t}\n\t\tconst val = canvas.content[i];\n\t\tparts.push(val ? String.fromCharCode(BRAILLE_OFFSET + val) : ' ');\n\t}\n\tparts.push(delimiter);\n\n\treturn parts.join('');\n}\n\n// ---------------------------------------------------------------------------\n// Exports\n// ---------------------------------------------------------------------------\n\nexport {\n\t// Constants\n\tBRAILLE_OFFSET,\n\tPIXEL_MAP,\n\t// Types\n\ttype AnimateOptions,\n\ttype Canvas,\n\ttype CanvasChars,\n\ttype CellValue,\n\ttype CreateCanvasOptions,\n\ttype FixedCanvas,\n\ttype FrameBounds,\n\ttype FrameGenerator,\n\ttype Point,\n\ttype TerminalSize,\n\ttype TurtleState,\n\t// Coordinate helpers\n\tnormalize,\n\tgetPos,\n\t// Terminal\n\tgetTerminalSize,\n\t// Sparse canvas\n\tcreateCanvas,\n\tclear,\n\tset,\n\tunset,\n\ttoggle,\n\tget,\n\tsetText,\n\trows,\n\tframe,\n\t// Animation\n\tanimate,\n\t// Drawing utilities\n\tline,\n\tpolygon,\n\t// Turtle\n\tcreateTurtle,\n\tturtleUp,\n\tturtleDown,\n\tturtleMove,\n\tturtleForward,\n\tturtleBack,\n\tturtleRight,\n\tturtleLeft,\n\t// Fixed canvas\n\tcreateFixedCanvas,\n\tfixedClear,\n\tfixedSet,\n\tfixedUnset,\n\tfixedToggle,\n\tfixedGet,\n\tfixedFrame,\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,133 @@
+/**
+ * btui — Braille TUI canvas for terminal drawing with Unicode braille characters.
+ *
+ * Braille dot layout per character cell:
+ *   ,___,
+ *   |1 4|
+ *   |2 5|
+ *   |3 6|
+ *   |7 8|
+ *   `````
+ *
+ * Each character maps to a 2x4 pixel grid.
+ * Unicode braille characters: U+2800 to U+28FF.
+ */
+declare const BRAILLE_OFFSET = 10240;
+declare const PIXEL_MAP: readonly (readonly [number, number])[];
+/** A single cell can hold a braille bitmask (number) or a text character (string). */
+type CellValue = number | string;
+/** Sparse row → col → cell storage. */
+interface CanvasChars {
+    readonly [row: number]: {
+        readonly [col: number]: CellValue;
+    } | undefined;
+}
+/** The braille canvas data structure. */
+interface Canvas {
+    chars: Map<number, Map<number, CellValue>>;
+    readonly lineEnding: string;
+}
+/** Options for creating a canvas. */
+interface CreateCanvasOptions {
+    readonly lineEnding?: string;
+}
+/** Bounds for frame/rows rendering. */
+interface FrameBounds {
+    readonly minX?: number;
+    readonly minY?: number;
+    readonly maxX?: number;
+    readonly maxY?: number;
+}
+/** A 2D point. */
+interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+/** Turtle graphics state. */
+interface TurtleState {
+    readonly canvas: Canvas;
+    posX: number;
+    posY: number;
+    rotation: number;
+    brushOn: boolean;
+}
+/** Normalize a coordinate to an integer. */
+declare function normalize(coord: number): number;
+/** Convert pixel (x, y) to cell (col, row). */
+declare function getPos(x: number, y: number): readonly [number, number];
+/** Create a new braille canvas. */
+declare function createCanvas(options?: CreateCanvasOptions): Canvas;
+/** Remove all pixels from the canvas. */
+declare function clear(canvas: Canvas): void;
+/** Set (draw) a pixel at (x, y). */
+declare function set(canvas: Canvas, x: number, y: number): void;
+/** Unset (erase) a pixel at (x, y). */
+declare function unset(canvas: Canvas, x: number, y: number): void;
+/** Toggle a pixel at (x, y). */
+declare function toggle(canvas: Canvas, x: number, y: number): void;
+/** Get the state of a pixel at (x, y). Returns true if set. */
+declare function get(canvas: Canvas, x: number, y: number): boolean;
+/** Set text at the given pixel coords. Each character occupies one cell column. */
+declare function setText(canvas: Canvas, x: number, y: number, text: string): void;
+/** Return the canvas content as an array of strings (one per row). */
+declare function rows(canvas: Canvas, bounds?: FrameBounds): readonly string[];
+/** Render the canvas as a string. */
+declare function frame(canvas: Canvas, bounds?: FrameBounds): string;
+/** Generate coordinates along a line from (x1, y1) to (x2, y2) using Bresenham-style interpolation. */
+declare function line(x1: number, y1: number, x2: number, y2: number): Generator<Point, void, unknown>;
+/** Generate coordinates for a regular polygon. */
+declare function polygon(centerX?: number, centerY?: number, sides?: number, radius?: number): Generator<Point, void, unknown>;
+/** Create a new turtle state. */
+declare function createTurtle(posX?: number, posY?: number): TurtleState;
+/** Pull the brush up (stop drawing on move). */
+declare function turtleUp(t: TurtleState): void;
+/** Push the brush down (draw on move). */
+declare function turtleDown(t: TurtleState): void;
+/** Move the turtle to an absolute position, drawing if the brush is down. */
+declare function turtleMove(t: TurtleState, x: number, y: number): void;
+/** Move the turtle forward by `step` pixels in its current direction. */
+declare function turtleForward(t: TurtleState, step: number): void;
+/** Move the turtle backward by `step` pixels. */
+declare function turtleBack(t: TurtleState, step: number): void;
+/** Rotate the turtle right (clockwise) by `angle` degrees. */
+declare function turtleRight(t: TurtleState, angle: number): void;
+/** Rotate the turtle left (counter-clockwise) by `angle` degrees. */
+declare function turtleLeft(t: TurtleState, angle: number): void;
+/** Terminal dimensions in characters. */
+interface TerminalSize {
+    readonly width: number;
+    readonly height: number;
+}
+/** Get terminal width and height. Falls back to 80x25. */
+declare function getTerminalSize(): TerminalSize;
+/** Options for the animate function. */
+interface AnimateOptions {
+    readonly delay?: number;
+    readonly signal?: AbortSignal;
+}
+/** Frame generator yields arrays of points per frame. */
+type FrameGenerator = Generator<readonly Point[], void, unknown>;
+/** Run an animation loop. Clears the canvas each frame, draws points from the generator, and writes to stdout. */
+declare function animate(canvas: Canvas, fn: () => FrameGenerator, options?: AnimateOptions): Promise<void>;
+/** A fixed-size canvas backed by a Uint8Array buffer. */
+interface FixedCanvas {
+    readonly width: number;
+    readonly height: number;
+    readonly content: Uint8Array;
+}
+/** Create a fixed-size canvas with the given dimensions. Width rounds to multiple of 2, height to multiple of 4. */
+declare function createFixedCanvas(width: number, height: number): FixedCanvas;
+/** Clear all pixels from a fixed canvas. */
+declare function fixedClear(canvas: FixedCanvas): void;
+/** Set a pixel on a fixed canvas. */
+declare function fixedSet(canvas: FixedCanvas, x: number, y: number): void;
+/** Unset a pixel on a fixed canvas. */
+declare function fixedUnset(canvas: FixedCanvas, x: number, y: number): void;
+/** Toggle a pixel on a fixed canvas. */
+declare function fixedToggle(canvas: FixedCanvas, x: number, y: number): void;
+/** Get the state of a pixel on a fixed canvas. */
+declare function fixedGet(canvas: FixedCanvas, x: number, y: number): boolean;
+/** Render a fixed canvas as a string. */
+declare function fixedFrame(canvas: FixedCanvas, delimiter?: string): string;
+
+export { type AnimateOptions, BRAILLE_OFFSET, type Canvas, type CanvasChars, type CellValue, type CreateCanvasOptions, type FixedCanvas, type FrameBounds, type FrameGenerator, PIXEL_MAP, type Point, type TerminalSize, type TurtleState, animate, clear, createCanvas, createFixedCanvas, createTurtle, fixedClear, fixedFrame, fixedGet, fixedSet, fixedToggle, fixedUnset, frame, get, getPos, getTerminalSize, line, normalize, polygon, rows, set, setText, toggle, turtleBack, turtleDown, turtleForward, turtleLeft, turtleMove, turtleRight, turtleUp, unset };

package/dist/index.d.ts

@@ -0,0 +1,133 @@
+/**
+ * btui — Braille TUI canvas for terminal drawing with Unicode braille characters.
+ *
+ * Braille dot layout per character cell:
+ *   ,___,
+ *   |1 4|
+ *   |2 5|
+ *   |3 6|
+ *   |7 8|
+ *   `````
+ *
+ * Each character maps to a 2x4 pixel grid.
+ * Unicode braille characters: U+2800 to U+28FF.
+ */
+declare const BRAILLE_OFFSET = 10240;
+declare const PIXEL_MAP: readonly (readonly [number, number])[];
+/** A single cell can hold a braille bitmask (number) or a text character (string). */
+type CellValue = number | string;
+/** Sparse row → col → cell storage. */
+interface CanvasChars {
+    readonly [row: number]: {
+        readonly [col: number]: CellValue;
+    } | undefined;
+}
+/** The braille canvas data structure. */
+interface Canvas {
+    chars: Map<number, Map<number, CellValue>>;
+    readonly lineEnding: string;
+}
+/** Options for creating a canvas. */
+interface CreateCanvasOptions {
+    readonly lineEnding?: string;
+}
+/** Bounds for frame/rows rendering. */
+interface FrameBounds {
+    readonly minX?: number;
+    readonly minY?: number;
+    readonly maxX?: number;
+    readonly maxY?: number;
+}
+/** A 2D point. */
+interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+/** Turtle graphics state. */
+interface TurtleState {
+    readonly canvas: Canvas;
+    posX: number;
+    posY: number;
+    rotation: number;
+    brushOn: boolean;
+}
+/** Normalize a coordinate to an integer. */
+declare function normalize(coord: number): number;
+/** Convert pixel (x, y) to cell (col, row). */
+declare function getPos(x: number, y: number): readonly [number, number];
+/** Create a new braille canvas. */
+declare function createCanvas(options?: CreateCanvasOptions): Canvas;
+/** Remove all pixels from the canvas. */
+declare function clear(canvas: Canvas): void;
+/** Set (draw) a pixel at (x, y). */
+declare function set(canvas: Canvas, x: number, y: number): void;
+/** Unset (erase) a pixel at (x, y). */
+declare function unset(canvas: Canvas, x: number, y: number): void;
+/** Toggle a pixel at (x, y). */
+declare function toggle(canvas: Canvas, x: number, y: number): void;
+/** Get the state of a pixel at (x, y). Returns true if set. */
+declare function get(canvas: Canvas, x: number, y: number): boolean;
+/** Set text at the given pixel coords. Each character occupies one cell column. */
+declare function setText(canvas: Canvas, x: number, y: number, text: string): void;
+/** Return the canvas content as an array of strings (one per row). */
+declare function rows(canvas: Canvas, bounds?: FrameBounds): readonly string[];
+/** Render the canvas as a string. */
+declare function frame(canvas: Canvas, bounds?: FrameBounds): string;
+/** Generate coordinates along a line from (x1, y1) to (x2, y2) using Bresenham-style interpolation. */
+declare function line(x1: number, y1: number, x2: number, y2: number): Generator<Point, void, unknown>;
+/** Generate coordinates for a regular polygon. */
+declare function polygon(centerX?: number, centerY?: number, sides?: number, radius?: number): Generator<Point, void, unknown>;
+/** Create a new turtle state. */
+declare function createTurtle(posX?: number, posY?: number): TurtleState;
+/** Pull the brush up (stop drawing on move). */
+declare function turtleUp(t: TurtleState): void;
+/** Push the brush down (draw on move). */
+declare function turtleDown(t: TurtleState): void;
+/** Move the turtle to an absolute position, drawing if the brush is down. */
+declare function turtleMove(t: TurtleState, x: number, y: number): void;
+/** Move the turtle forward by `step` pixels in its current direction. */
+declare function turtleForward(t: TurtleState, step: number): void;
+/** Move the turtle backward by `step` pixels. */
+declare function turtleBack(t: TurtleState, step: number): void;
+/** Rotate the turtle right (clockwise) by `angle` degrees. */
+declare function turtleRight(t: TurtleState, angle: number): void;
+/** Rotate the turtle left (counter-clockwise) by `angle` degrees. */
+declare function turtleLeft(t: TurtleState, angle: number): void;
+/** Terminal dimensions in characters. */
+interface TerminalSize {
+    readonly width: number;
+    readonly height: number;
+}
+/** Get terminal width and height. Falls back to 80x25. */
+declare function getTerminalSize(): TerminalSize;
+/** Options for the animate function. */
+interface AnimateOptions {
+    readonly delay?: number;
+    readonly signal?: AbortSignal;
+}
+/** Frame generator yields arrays of points per frame. */
+type FrameGenerator = Generator<readonly Point[], void, unknown>;
+/** Run an animation loop. Clears the canvas each frame, draws points from the generator, and writes to stdout. */
+declare function animate(canvas: Canvas, fn: () => FrameGenerator, options?: AnimateOptions): Promise<void>;
+/** A fixed-size canvas backed by a Uint8Array buffer. */
+interface FixedCanvas {
+    readonly width: number;
+    readonly height: number;
+    readonly content: Uint8Array;
+}
+/** Create a fixed-size canvas with the given dimensions. Width rounds to multiple of 2, height to multiple of 4. */
+declare function createFixedCanvas(width: number, height: number): FixedCanvas;
+/** Clear all pixels from a fixed canvas. */
+declare function fixedClear(canvas: FixedCanvas): void;
+/** Set a pixel on a fixed canvas. */
+declare function fixedSet(canvas: FixedCanvas, x: number, y: number): void;
+/** Unset a pixel on a fixed canvas. */
+declare function fixedUnset(canvas: FixedCanvas, x: number, y: number): void;
+/** Toggle a pixel on a fixed canvas. */
+declare function fixedToggle(canvas: FixedCanvas, x: number, y: number): void;
+/** Get the state of a pixel on a fixed canvas. */
+declare function fixedGet(canvas: FixedCanvas, x: number, y: number): boolean;
+/** Render a fixed canvas as a string. */
+declare function fixedFrame(canvas: FixedCanvas, delimiter?: string): string;
+
+export { type AnimateOptions, BRAILLE_OFFSET, type Canvas, type CanvasChars, type CellValue, type CreateCanvasOptions, type FixedCanvas, type FrameBounds, type FrameGenerator, PIXEL_MAP, type Point, type TerminalSize, type TurtleState, animate, clear, createCanvas, createFixedCanvas, createTurtle, fixedClear, fixedFrame, fixedGet, fixedSet, fixedToggle, fixedUnset, frame, get, getPos, getTerminalSize, line, normalize, polygon, rows, set, setText, toggle, turtleBack, turtleDown, turtleForward, turtleLeft, turtleMove, turtleRight, turtleUp, unset };

package/dist/index.js

@@ -0,0 +1,360 @@
+// src/index.ts
+var BRAILLE_OFFSET = 10240;
+var PIXEL_MAP = [
+  [1, 8],
+  [2, 16],
+  [4, 32],
+  [64, 128]
+];
+function normalize(coord) {
+  return Math.round(coord);
+}
+function getPos(x, y) {
+  return [Math.floor(normalize(x) / 2), Math.floor(normalize(y) / 4)];
+}
+function createCanvas(options) {
+  return {
+    chars: /* @__PURE__ */ new Map(),
+    lineEnding: options?.lineEnding ?? "\n"
+  };
+}
+function clear(canvas) {
+  canvas.chars.clear();
+}
+function set(canvas, x, y) {
+  const nx = normalize(x);
+  const ny = normalize(y);
+  const [col, row] = getPos(nx, ny);
+  let rowMap = canvas.chars.get(row);
+  if (!rowMap) {
+    rowMap = /* @__PURE__ */ new Map();
+    canvas.chars.set(row, rowMap);
+  }
+  const current = rowMap.get(col);
+  if (current !== void 0 && typeof current !== "number") {
+    return;
+  }
+  const mask = PIXEL_MAP[ny % 4]?.[nx % 2];
+  if (mask === void 0) return;
+  rowMap.set(col, (current ?? 0) | mask);
+}
+function unset(canvas, x, y) {
+  const nx = normalize(x);
+  const ny = normalize(y);
+  const [col, row] = getPos(nx, ny);
+  const rowMap = canvas.chars.get(row);
+  if (!rowMap) return;
+  const current = rowMap.get(col);
+  if (current === void 0 || typeof current !== "number") return;
+  const mask = PIXEL_MAP[ny % 4]?.[nx % 2];
+  if (mask === void 0) return;
+  const updated = current & ~mask;
+  if (updated === 0) {
+    rowMap.delete(col);
+    if (rowMap.size === 0) {
+      canvas.chars.delete(row);
+    }
+    return;
+  }
+  rowMap.set(col, updated);
+}
+function toggle(canvas, x, y) {
+  const nx = normalize(x);
+  const ny = normalize(y);
+  const [col, row] = getPos(nx, ny);
+  const rowMap = canvas.chars.get(row);
+  const current = rowMap?.get(col);
+  const mask = PIXEL_MAP[ny % 4]?.[nx % 2];
+  if (mask === void 0) return;
+  if (current !== void 0 && (typeof current !== "number" || (current & mask) !== 0)) {
+    unset(canvas, x, y);
+  } else {
+    set(canvas, x, y);
+  }
+}
+function get(canvas, x, y) {
+  const nx = normalize(x);
+  const ny = normalize(y);
+  const [col, row] = getPos(nx, ny);
+  const rowMap = canvas.chars.get(row);
+  if (!rowMap) return false;
+  const cell = rowMap.get(col);
+  if (cell === void 0) return false;
+  if (typeof cell !== "number") return true;
+  const mask = PIXEL_MAP[ny % 4]?.[nx % 2];
+  if (mask === void 0) return false;
+  return (cell & mask) !== 0;
+}
+function setText(canvas, x, y, text) {
+  const [col, row] = getPos(x, y);
+  let rowMap = canvas.chars.get(row);
+  if (!rowMap) {
+    rowMap = /* @__PURE__ */ new Map();
+    canvas.chars.set(row, rowMap);
+  }
+  for (let i = 0; i < text.length; i++) {
+    rowMap.set(col + i, text[i]);
+  }
+}
+function rows(canvas, bounds) {
+  if (canvas.chars.size === 0) return [];
+  const allRows = [...canvas.chars.keys()];
+  const minRow = bounds?.minY != null ? Math.floor(bounds.minY / 4) : Math.min(...allRows);
+  const maxRow = bounds?.maxY != null ? Math.floor((bounds.maxY - 1) / 4) : Math.max(...allRows);
+  let globalMinCol;
+  if (bounds?.minX != null) {
+    globalMinCol = Math.floor(bounds.minX / 2);
+  } else {
+    let min = Number.POSITIVE_INFINITY;
+    for (const rowMap of canvas.chars.values()) {
+      for (const c of rowMap.keys()) {
+        if (c < min) min = c;
+      }
+    }
+    globalMinCol = min === Number.POSITIVE_INFINITY ? 0 : min;
+  }
+  const result = [];
+  for (let rowNum = minRow; rowNum <= maxRow; rowNum++) {
+    const rowMap = canvas.chars.get(rowNum);
+    if (!rowMap) {
+      result.push("");
+      continue;
+    }
+    let maxCol;
+    if (bounds?.maxX != null) {
+      maxCol = Math.floor((bounds.maxX - 1) / 2);
+    } else {
+      maxCol = Math.max(...rowMap.keys());
+    }
+    const chars = [];
+    for (let c = globalMinCol; c <= maxCol; c++) {
+      const cell = rowMap.get(c);
+      if (cell === void 0 || cell === 0) {
+        chars.push(" ");
+      } else if (typeof cell !== "number") {
+        chars.push(cell);
+      } else {
+        chars.push(String.fromCharCode(BRAILLE_OFFSET + cell));
+      }
+    }
+    result.push(chars.join(""));
+  }
+  return result;
+}
+function frame(canvas, bounds) {
+  return rows(canvas, bounds).join(canvas.lineEnding);
+}
+function* line(x1, y1, x2, y2) {
+  const nx1 = normalize(x1);
+  const ny1 = normalize(y1);
+  const nx2 = normalize(x2);
+  const ny2 = normalize(y2);
+  const xDiff = Math.abs(nx2 - nx1);
+  const yDiff = Math.abs(ny2 - ny1);
+  const xDir = nx1 <= nx2 ? 1 : -1;
+  const yDir = ny1 <= ny2 ? 1 : -1;
+  const steps = Math.max(xDiff, yDiff);
+  for (let i = 0; i <= steps; i++) {
+    let px = nx1;
+    let py = ny1;
+    if (yDiff) {
+      py += Math.round(i * yDiff / steps) * yDir;
+    }
+    if (xDiff) {
+      px += Math.round(i * xDiff / steps) * xDir;
+    }
+    yield { x: px, y: py };
+  }
+}
+function* polygon(centerX = 0, centerY = 0, sides = 4, radius = 4) {
+  const degree = 360 / sides;
+  for (let n = 0; n < sides; n++) {
+    const a = n * degree;
+    const b = (n + 1) * degree;
+    const x1 = (centerX + Math.cos(a * Math.PI / 180)) * ((radius + 1) / 2);
+    const y1 = (centerY + Math.sin(a * Math.PI / 180)) * ((radius + 1) / 2);
+    const x2 = (centerX + Math.cos(b * Math.PI / 180)) * ((radius + 1) / 2);
+    const y2 = (centerY + Math.sin(b * Math.PI / 180)) * ((radius + 1) / 2);
+    for (const pt of line(x1, y1, x2, y2)) {
+      yield pt;
+    }
+  }
+}
+function createTurtle(posX = 0, posY = 0) {
+  return {
+    canvas: createCanvas(),
+    posX,
+    posY,
+    rotation: 0,
+    brushOn: true
+  };
+}
+function turtleUp(t) {
+  t.brushOn = false;
+}
+function turtleDown(t) {
+  t.brushOn = true;
+}
+function turtleMove(t, x, y) {
+  if (t.brushOn) {
+    for (const pt of line(t.posX, t.posY, x, y)) {
+      set(t.canvas, pt.x, pt.y);
+    }
+  }
+  t.posX = x;
+  t.posY = y;
+}
+function turtleForward(t, step) {
+  const x = t.posX + Math.cos(t.rotation * Math.PI / 180) * step;
+  const y = t.posY + Math.sin(t.rotation * Math.PI / 180) * step;
+  const prevBrush = t.brushOn;
+  t.brushOn = true;
+  turtleMove(t, x, y);
+  t.brushOn = prevBrush;
+}
+function turtleBack(t, step) {
+  turtleForward(t, -step);
+}
+function turtleRight(t, angle) {
+  t.rotation += angle;
+}
+function turtleLeft(t, angle) {
+  t.rotation -= angle;
+}
+function getTerminalSize() {
+  const width = process.stdout?.columns ?? 80;
+  const height = process.stdout?.rows ?? 25;
+  return { width, height };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function animate(canvas, fn, options) {
+  const delay = options?.delay ?? 1e3 / 24;
+  for (const points of fn()) {
+    if (options?.signal?.aborted) break;
+    for (const pt of points) {
+      set(canvas, pt.x, pt.y);
+    }
+    const f = frame(canvas);
+    process.stdout.write(`\x1B[H\x1B[J${f}
+`);
+    if (delay > 0) {
+      await sleep(delay);
+    }
+    clear(canvas);
+  }
+}
+function createFixedCanvas(width, height) {
+  const w = Math.floor(width / 2) * 2;
+  const h = Math.floor(height / 4) * 4;
+  return {
+    width: w,
+    height: h,
+    content: new Uint8Array(w * h / 8)
+  };
+}
+function fixedClear(canvas) {
+  canvas.content.fill(0);
+}
+function fixedSet(canvas, x, y) {
+  if (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;
+  const fx = Math.floor(x);
+  const fy = Math.floor(y);
+  const nx = Math.floor(fx / 2);
+  const ny = Math.floor(fy / 4);
+  const coord = nx + canvas.width / 2 * ny;
+  const mask = PIXEL_MAP[fy % 4]?.[fx % 2];
+  if (mask === void 0) return;
+  const val = canvas.content[coord];
+  if (val === void 0) return;
+  canvas.content[coord] = val | mask;
+}
+function fixedUnset(canvas, x, y) {
+  if (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;
+  const fx = Math.floor(x);
+  const fy = Math.floor(y);
+  const nx = Math.floor(fx / 2);
+  const ny = Math.floor(fy / 4);
+  const coord = nx + canvas.width / 2 * ny;
+  const mask = PIXEL_MAP[fy % 4]?.[fx % 2];
+  if (mask === void 0) return;
+  const val = canvas.content[coord];
+  if (val === void 0) return;
+  canvas.content[coord] = val & ~mask;
+}
+function fixedToggle(canvas, x, y) {
+  if (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;
+  const fx = Math.floor(x);
+  const fy = Math.floor(y);
+  const nx = Math.floor(fx / 2);
+  const ny = Math.floor(fy / 4);
+  const coord = nx + canvas.width / 2 * ny;
+  const mask = PIXEL_MAP[fy % 4]?.[fx % 2];
+  if (mask === void 0) return;
+  const val = canvas.content[coord];
+  if (val === void 0) return;
+  canvas.content[coord] = val ^ mask;
+}
+function fixedGet(canvas, x, y) {
+  if (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height))
+    return false;
+  const fx = Math.floor(x);
+  const fy = Math.floor(y);
+  const nx = Math.floor(fx / 2);
+  const ny = Math.floor(fy / 4);
+  const coord = nx + canvas.width / 2 * ny;
+  const mask = PIXEL_MAP[fy % 4]?.[fx % 2];
+  if (mask === void 0) return false;
+  const val = canvas.content[coord];
+  if (val === void 0) return false;
+  return (val & mask) !== 0;
+}
+function fixedFrame(canvas, delimiter = "\n") {
+  const frameWidth = canvas.width / 2;
+  const parts = [];
+  for (let i = 0; i < canvas.content.length; i++) {
+    if (i % frameWidth === 0) {
+      parts.push(delimiter);
+    }
+    const val = canvas.content[i];
+    parts.push(val ? String.fromCharCode(BRAILLE_OFFSET + val) : " ");
+  }
+  parts.push(delimiter);
+  return parts.join("");
+}
+export {
+  BRAILLE_OFFSET,
+  PIXEL_MAP,
+  animate,
+  clear,
+  createCanvas,
+  createFixedCanvas,
+  createTurtle,
+  fixedClear,
+  fixedFrame,
+  fixedGet,
+  fixedSet,
+  fixedToggle,
+  fixedUnset,
+  frame,
+  get,
+  getPos,
+  getTerminalSize,
+  line,
+  normalize,
+  polygon,
+  rows,
+  set,
+  setText,
+  toggle,
+  turtleBack,
+  turtleDown,
+  turtleForward,
+  turtleLeft,
+  turtleMove,
+  turtleRight,
+  turtleUp,
+  unset
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * btui — Braille TUI canvas for terminal drawing with Unicode braille characters.\n *\n * Braille dot layout per character cell:\n *   ,___,\n *   |1 4|\n *   |2 5|\n *   |3 6|\n *   |7 8|\n *   `````\n *\n * Each character maps to a 2x4 pixel grid.\n * Unicode braille characters: U+2800 to U+28FF.\n */\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst BRAILLE_OFFSET = 0x2800;\n\nconst PIXEL_MAP: readonly (readonly [number, number])[] = [\n\t[0x01, 0x08],\n\t[0x02, 0x10],\n\t[0x04, 0x20],\n\t[0x40, 0x80],\n] as const;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** A single cell can hold a braille bitmask (number) or a text character (string). */\ntype CellValue = number | string;\n\n/** Sparse row → col → cell storage. */\ninterface CanvasChars {\n\treadonly [row: number]: {readonly [col: number]: CellValue} | undefined;\n}\n\n/** The braille canvas data structure. */\ninterface Canvas {\n\tchars: Map<number, Map<number, CellValue>>;\n\treadonly lineEnding: string;\n}\n\n/** Options for creating a canvas. */\ninterface CreateCanvasOptions {\n\treadonly lineEnding?: string;\n}\n\n/** Bounds for frame/rows rendering. */\ninterface FrameBounds {\n\treadonly minX?: number;\n\treadonly minY?: number;\n\treadonly maxX?: number;\n\treadonly maxY?: number;\n}\n\n/** A 2D point. */\ninterface Point {\n\treadonly x: number;\n\treadonly y: number;\n}\n\n/** Turtle graphics state. */\ninterface TurtleState {\n\treadonly canvas: Canvas;\n\tposX: number;\n\tposY: number;\n\trotation: number;\n\tbrushOn: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Coordinate helpers\n// ---------------------------------------------------------------------------\n\n/** Normalize a coordinate to an integer. */\nfunction normalize(coord: number): number {\n\treturn Math.round(coord);\n}\n\n/** Convert pixel (x, y) to cell (col, row). */\nfunction getPos(x: number, y: number): readonly [number, number] {\n\treturn [Math.floor(normalize(x) / 2), Math.floor(normalize(y) / 4)];\n}\n\n// ---------------------------------------------------------------------------\n// Canvas — creation & mutation\n// ---------------------------------------------------------------------------\n\n/** Create a new braille canvas. */\nfunction createCanvas(options?: CreateCanvasOptions): Canvas {\n\treturn {\n\t\tchars: new Map(),\n\t\tlineEnding: options?.lineEnding ?? '\\n',\n\t};\n}\n\n/** Remove all pixels from the canvas. */\nfunction clear(canvas: Canvas): void {\n\tcanvas.chars.clear();\n}\n\n/** Set (draw) a pixel at (x, y). */\nfunction set(canvas: Canvas, x: number, y: number): void {\n\tconst nx = normalize(x);\n\tconst ny = normalize(y);\n\tconst [col, row] = getPos(nx, ny);\n\n\tlet rowMap = canvas.chars.get(row);\n\tif (!rowMap) {\n\t\trowMap = new Map();\n\t\tcanvas.chars.set(row, rowMap);\n\t}\n\n\tconst current = rowMap.get(col);\n\tif (current !== undefined && typeof current !== 'number') {\n\t\treturn;\n\t}\n\n\tconst mask = PIXEL_MAP[ny % 4]?.[nx % 2];\n\tif (mask === undefined) return;\n\n\trowMap.set(col, ((current as number | undefined) ?? 0) | mask);\n}\n\n/** Unset (erase) a pixel at (x, y). */\nfunction unset(canvas: Canvas, x: number, y: number): void {\n\tconst nx = normalize(x);\n\tconst ny = normalize(y);\n\tconst [col, row] = getPos(nx, ny);\n\n\tconst rowMap = canvas.chars.get(row);\n\tif (!rowMap) return;\n\n\tconst current = rowMap.get(col);\n\tif (current === undefined || typeof current !== 'number') return;\n\n\tconst mask = PIXEL_MAP[ny % 4]?.[nx % 2];\n\tif (mask === undefined) return;\n\n\tconst updated = current & ~mask;\n\tif (updated === 0) {\n\t\trowMap.delete(col);\n\t\tif (rowMap.size === 0) {\n\t\t\tcanvas.chars.delete(row);\n\t\t}\n\t\treturn;\n\t}\n\n\trowMap.set(col, updated);\n}\n\n/** Toggle a pixel at (x, y). */\nfunction toggle(canvas: Canvas, x: number, y: number): void {\n\tconst nx = normalize(x);\n\tconst ny = normalize(y);\n\tconst [col, row] = getPos(nx, ny);\n\n\tconst rowMap = canvas.chars.get(row);\n\tconst current = rowMap?.get(col);\n\n\tconst mask = PIXEL_MAP[ny % 4]?.[nx % 2];\n\tif (mask === undefined) return;\n\n\tif (\n\t\tcurrent !== undefined &&\n\t\t(typeof current !== 'number' || (current & mask) !== 0)\n\t) {\n\t\tunset(canvas, x, y);\n\t} else {\n\t\tset(canvas, x, y);\n\t}\n}\n\n/** Get the state of a pixel at (x, y). Returns true if set. */\nfunction get(canvas: Canvas, x: number, y: number): boolean {\n\tconst nx = normalize(x);\n\tconst ny = normalize(y);\n\tconst [col, row] = getPos(nx, ny);\n\n\tconst rowMap = canvas.chars.get(row);\n\tif (!rowMap) return false;\n\n\tconst cell = rowMap.get(col);\n\tif (cell === undefined) return false;\n\tif (typeof cell !== 'number') return true;\n\n\tconst mask = PIXEL_MAP[ny % 4]?.[nx % 2];\n\tif (mask === undefined) return false;\n\n\treturn (cell & mask) !== 0;\n}\n\n/** Set text at the given pixel coords. Each character occupies one cell column. */\nfunction setText(canvas: Canvas, x: number, y: number, text: string): void {\n\tconst [col, row] = getPos(x, y);\n\n\tlet rowMap = canvas.chars.get(row);\n\tif (!rowMap) {\n\t\trowMap = new Map();\n\t\tcanvas.chars.set(row, rowMap);\n\t}\n\n\tfor (let i = 0; i < text.length; i++) {\n\t\trowMap.set(col + i, text[i] as string);\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Canvas — rendering\n// ---------------------------------------------------------------------------\n\n/** Return the canvas content as an array of strings (one per row). */\nfunction rows(canvas: Canvas, bounds?: FrameBounds): readonly string[] {\n\tif (canvas.chars.size === 0) return [];\n\n\tconst allRows = [...canvas.chars.keys()];\n\tconst minRow =\n\t\tbounds?.minY != null\n\t\t\t? Math.floor(bounds.minY / 4)\n\t\t\t: Math.min(...allRows);\n\tconst maxRow =\n\t\tbounds?.maxY != null\n\t\t\t? Math.floor((bounds.maxY - 1) / 4)\n\t\t\t: Math.max(...allRows);\n\n\t// Global min col for left alignment\n\tlet globalMinCol: number;\n\tif (bounds?.minX != null) {\n\t\tglobalMinCol = Math.floor(bounds.minX / 2);\n\t} else {\n\t\tlet min = Number.POSITIVE_INFINITY;\n\t\tfor (const rowMap of canvas.chars.values()) {\n\t\t\tfor (const c of rowMap.keys()) {\n\t\t\t\tif (c < min) min = c;\n\t\t\t}\n\t\t}\n\t\tglobalMinCol = min === Number.POSITIVE_INFINITY ? 0 : min;\n\t}\n\n\tconst result: string[] = [];\n\n\tfor (let rowNum = minRow; rowNum <= maxRow; rowNum++) {\n\t\tconst rowMap = canvas.chars.get(rowNum);\n\t\tif (!rowMap) {\n\t\t\tresult.push('');\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet maxCol: number;\n\t\tif (bounds?.maxX != null) {\n\t\t\tmaxCol = Math.floor((bounds.maxX - 1) / 2);\n\t\t} else {\n\t\t\tmaxCol = Math.max(...rowMap.keys());\n\t\t}\n\n\t\tconst chars: string[] = [];\n\t\tfor (let c = globalMinCol; c <= maxCol; c++) {\n\t\t\tconst cell = rowMap.get(c);\n\t\t\tif (cell === undefined || cell === 0) {\n\t\t\t\tchars.push(' ');\n\t\t\t} else if (typeof cell !== 'number') {\n\t\t\t\tchars.push(cell);\n\t\t\t} else {\n\t\t\t\tchars.push(String.fromCharCode(BRAILLE_OFFSET + cell));\n\t\t\t}\n\t\t}\n\n\t\tresult.push(chars.join(''));\n\t}\n\n\treturn result;\n}\n\n/** Render the canvas as a string. */\nfunction frame(canvas: Canvas, bounds?: FrameBounds): string {\n\treturn rows(canvas, bounds).join(canvas.lineEnding);\n}\n\n// ---------------------------------------------------------------------------\n// Drawing utilities — line\n// ---------------------------------------------------------------------------\n\n/** Generate coordinates along a line from (x1, y1) to (x2, y2) using Bresenham-style interpolation. */\nfunction* line(\n\tx1: number,\n\ty1: number,\n\tx2: number,\n\ty2: number,\n): Generator<Point, void, unknown> {\n\tconst nx1 = normalize(x1);\n\tconst ny1 = normalize(y1);\n\tconst nx2 = normalize(x2);\n\tconst ny2 = normalize(y2);\n\n\tconst xDiff = Math.abs(nx2 - nx1);\n\tconst yDiff = Math.abs(ny2 - ny1);\n\tconst xDir = nx1 <= nx2 ? 1 : -1;\n\tconst yDir = ny1 <= ny2 ? 1 : -1;\n\n\tconst steps = Math.max(xDiff, yDiff);\n\n\tfor (let i = 0; i <= steps; i++) {\n\t\tlet px = nx1;\n\t\tlet py = ny1;\n\n\t\tif (yDiff) {\n\t\t\tpy += Math.round((i * yDiff) / steps) * yDir;\n\t\t}\n\t\tif (xDiff) {\n\t\t\tpx += Math.round((i * xDiff) / steps) * xDir;\n\t\t}\n\n\t\tyield {x: px, y: py};\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Drawing utilities — polygon\n// ---------------------------------------------------------------------------\n\n/** Generate coordinates for a regular polygon. */\nfunction* polygon(\n\tcenterX = 0,\n\tcenterY = 0,\n\tsides = 4,\n\tradius = 4,\n): Generator<Point, void, unknown> {\n\tconst degree = 360 / sides;\n\n\tfor (let n = 0; n < sides; n++) {\n\t\tconst a = n * degree;\n\t\tconst b = (n + 1) * degree;\n\t\tconst x1 =\n\t\t\t(centerX + Math.cos((a * Math.PI) / 180)) * ((radius + 1) / 2);\n\t\tconst y1 =\n\t\t\t(centerY + Math.sin((a * Math.PI) / 180)) * ((radius + 1) / 2);\n\t\tconst x2 =\n\t\t\t(centerX + Math.cos((b * Math.PI) / 180)) * ((radius + 1) / 2);\n\t\tconst y2 =\n\t\t\t(centerY + Math.sin((b * Math.PI) / 180)) * ((radius + 1) / 2);\n\n\t\tfor (const pt of line(x1, y1, x2, y2)) {\n\t\t\tyield pt;\n\t\t}\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Turtle graphics\n// ---------------------------------------------------------------------------\n\n/** Create a new turtle state. */\nfunction createTurtle(posX = 0, posY = 0): TurtleState {\n\treturn {\n\t\tcanvas: createCanvas(),\n\t\tposX,\n\t\tposY,\n\t\trotation: 0,\n\t\tbrushOn: true,\n\t};\n}\n\n/** Pull the brush up (stop drawing on move). */\nfunction turtleUp(t: TurtleState): void {\n\tt.brushOn = false;\n}\n\n/** Push the brush down (draw on move). */\nfunction turtleDown(t: TurtleState): void {\n\tt.brushOn = true;\n}\n\n/** Move the turtle to an absolute position, drawing if the brush is down. */\nfunction turtleMove(t: TurtleState, x: number, y: number): void {\n\tif (t.brushOn) {\n\t\tfor (const pt of line(t.posX, t.posY, x, y)) {\n\t\t\tset(t.canvas, pt.x, pt.y);\n\t\t}\n\t}\n\tt.posX = x;\n\tt.posY = y;\n}\n\n/** Move the turtle forward by `step` pixels in its current direction. */\nfunction turtleForward(t: TurtleState, step: number): void {\n\tconst x = t.posX + Math.cos((t.rotation * Math.PI) / 180) * step;\n\tconst y = t.posY + Math.sin((t.rotation * Math.PI) / 180) * step;\n\tconst prevBrush = t.brushOn;\n\tt.brushOn = true;\n\tturtleMove(t, x, y);\n\tt.brushOn = prevBrush;\n}\n\n/** Move the turtle backward by `step` pixels. */\nfunction turtleBack(t: TurtleState, step: number): void {\n\tturtleForward(t, -step);\n}\n\n/** Rotate the turtle right (clockwise) by `angle` degrees. */\nfunction turtleRight(t: TurtleState, angle: number): void {\n\tt.rotation += angle;\n}\n\n/** Rotate the turtle left (counter-clockwise) by `angle` degrees. */\nfunction turtleLeft(t: TurtleState, angle: number): void {\n\tt.rotation -= angle;\n}\n\n// ---------------------------------------------------------------------------\n// Terminal size\n// ---------------------------------------------------------------------------\n\n/** Terminal dimensions in characters. */\ninterface TerminalSize {\n\treadonly width: number;\n\treadonly height: number;\n}\n\n/** Get terminal width and height. Falls back to 80x25. */\nfunction getTerminalSize(): TerminalSize {\n\tconst width = process.stdout?.columns ?? 80;\n\tconst height = process.stdout?.rows ?? 25;\n\treturn {width, height};\n}\n\n// ---------------------------------------------------------------------------\n// Animation\n// ---------------------------------------------------------------------------\n\n/** Options for the animate function. */\ninterface AnimateOptions {\n\treadonly delay?: number;\n\treadonly signal?: AbortSignal;\n}\n\n/** Frame generator yields arrays of points per frame. */\ntype FrameGenerator = Generator<readonly Point[], void, unknown>;\n\n/** Sleep for the given number of milliseconds. */\nfunction sleep(ms: number): Promise<void> {\n\treturn new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/** Run an animation loop. Clears the canvas each frame, draws points from the generator, and writes to stdout. */\nasync function animate(\n\tcanvas: Canvas,\n\tfn: () => FrameGenerator,\n\toptions?: AnimateOptions,\n): Promise<void> {\n\tconst delay = options?.delay ?? 1000 / 24;\n\n\tfor (const points of fn()) {\n\t\tif (options?.signal?.aborted) break;\n\n\t\tfor (const pt of points) {\n\t\t\tset(canvas, pt.x, pt.y);\n\t\t}\n\n\t\tconst f = frame(canvas);\n\t\tprocess.stdout.write(`\\x1b[H\\x1b[J${f}\\n`);\n\n\t\tif (delay > 0) {\n\t\t\tawait sleep(delay);\n\t\t}\n\n\t\tclear(canvas);\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Fixed-size canvas (node-drawille style)\n// ---------------------------------------------------------------------------\n\n/** A fixed-size canvas backed by a Uint8Array buffer. */\ninterface FixedCanvas {\n\treadonly width: number;\n\treadonly height: number;\n\treadonly content: Uint8Array;\n}\n\n/** Create a fixed-size canvas with the given dimensions. Width rounds to multiple of 2, height to multiple of 4. */\nfunction createFixedCanvas(width: number, height: number): FixedCanvas {\n\tconst w = Math.floor(width / 2) * 2;\n\tconst h = Math.floor(height / 4) * 4;\n\treturn {\n\t\twidth: w,\n\t\theight: h,\n\t\tcontent: new Uint8Array((w * h) / 8),\n\t};\n}\n\n/** Clear all pixels from a fixed canvas. */\nfunction fixedClear(canvas: FixedCanvas): void {\n\tcanvas.content.fill(0);\n}\n\n/** Set a pixel on a fixed canvas. */\nfunction fixedSet(canvas: FixedCanvas, x: number, y: number): void {\n\tif (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;\n\tconst fx = Math.floor(x);\n\tconst fy = Math.floor(y);\n\tconst nx = Math.floor(fx / 2);\n\tconst ny = Math.floor(fy / 4);\n\tconst coord = nx + (canvas.width / 2) * ny;\n\tconst mask = PIXEL_MAP[fy % 4]?.[fx % 2];\n\tif (mask === undefined) return;\n\tconst val = canvas.content[coord];\n\tif (val === undefined) return;\n\tcanvas.content[coord] = val | mask;\n}\n\n/** Unset a pixel on a fixed canvas. */\nfunction fixedUnset(canvas: FixedCanvas, x: number, y: number): void {\n\tif (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;\n\tconst fx = Math.floor(x);\n\tconst fy = Math.floor(y);\n\tconst nx = Math.floor(fx / 2);\n\tconst ny = Math.floor(fy / 4);\n\tconst coord = nx + (canvas.width / 2) * ny;\n\tconst mask = PIXEL_MAP[fy % 4]?.[fx % 2];\n\tif (mask === undefined) return;\n\tconst val = canvas.content[coord];\n\tif (val === undefined) return;\n\tcanvas.content[coord] = val & ~mask;\n}\n\n/** Toggle a pixel on a fixed canvas. */\nfunction fixedToggle(canvas: FixedCanvas, x: number, y: number): void {\n\tif (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height)) return;\n\tconst fx = Math.floor(x);\n\tconst fy = Math.floor(y);\n\tconst nx = Math.floor(fx / 2);\n\tconst ny = Math.floor(fy / 4);\n\tconst coord = nx + (canvas.width / 2) * ny;\n\tconst mask = PIXEL_MAP[fy % 4]?.[fx % 2];\n\tif (mask === undefined) return;\n\tconst val = canvas.content[coord];\n\tif (val === undefined) return;\n\tcanvas.content[coord] = val ^ mask;\n}\n\n/** Get the state of a pixel on a fixed canvas. */\nfunction fixedGet(canvas: FixedCanvas, x: number, y: number): boolean {\n\tif (!(x >= 0 && x < canvas.width && y >= 0 && y < canvas.height))\n\t\treturn false;\n\tconst fx = Math.floor(x);\n\tconst fy = Math.floor(y);\n\tconst nx = Math.floor(fx / 2);\n\tconst ny = Math.floor(fy / 4);\n\tconst coord = nx + (canvas.width / 2) * ny;\n\tconst mask = PIXEL_MAP[fy % 4]?.[fx % 2];\n\tif (mask === undefined) return false;\n\tconst val = canvas.content[coord];\n\tif (val === undefined) return false;\n\treturn (val & mask) !== 0;\n}\n\n/** Render a fixed canvas as a string. */\nfunction fixedFrame(canvas: FixedCanvas, delimiter = '\\n'): string {\n\tconst frameWidth = canvas.width / 2;\n\tconst parts: string[] = [];\n\n\tfor (let i = 0; i < canvas.content.length; i++) {\n\t\tif (i % frameWidth === 0) {\n\t\t\tparts.push(delimiter);\n\t\t}\n\t\tconst val = canvas.content[i];\n\t\tparts.push(val ? String.fromCharCode(BRAILLE_OFFSET + val) : ' ');\n\t}\n\tparts.push(delimiter);\n\n\treturn parts.join('');\n}\n\n// ---------------------------------------------------------------------------\n// Exports\n// ---------------------------------------------------------------------------\n\nexport {\n\t// Constants\n\tBRAILLE_OFFSET,\n\tPIXEL_MAP,\n\t// Types\n\ttype AnimateOptions,\n\ttype Canvas,\n\ttype CanvasChars,\n\ttype CellValue,\n\ttype CreateCanvasOptions,\n\ttype FixedCanvas,\n\ttype FrameBounds,\n\ttype FrameGenerator,\n\ttype Point,\n\ttype TerminalSize,\n\ttype TurtleState,\n\t// Coordinate helpers\n\tnormalize,\n\tgetPos,\n\t// Terminal\n\tgetTerminalSize,\n\t// Sparse canvas\n\tcreateCanvas,\n\tclear,\n\tset,\n\tunset,\n\ttoggle,\n\tget,\n\tsetText,\n\trows,\n\tframe,\n\t// Animation\n\tanimate,\n\t// Drawing utilities\n\tline,\n\tpolygon,\n\t// Turtle\n\tcreateTurtle,\n\tturtleUp,\n\tturtleDown,\n\tturtleMove,\n\tturtleForward,\n\tturtleBack,\n\tturtleRight,\n\tturtleLeft,\n\t// Fixed canvas\n\tcreateFixedCanvas,\n\tfixedClear,\n\tfixedSet,\n\tfixedUnset,\n\tfixedToggle,\n\tfixedGet,\n\tfixedFrame,\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "termdot",
+	"version": "0.0.1",
+	"description": "Braille TUI — draw in the terminal with Unicode braille characters",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		}
+	},
+	"files": ["dist"],
+	"scripts": {
+		"build": "tsup",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"lint": "biome check .",
+		"lint:fix": "biome check --fix .",
+		"typecheck": "tsc --noEmit"
+	},
+	"keywords": [
+		"braille",
+		"tui",
+		"terminal",
+		"canvas",
+		"draw",
+		"unicode",
+		"cli"
+	],
+	"license": "MIT",
+	"devDependencies": {
+		"@biomejs/biome": "^1.9.4",
+		"@types/node": "^25.2.3",
+		"tsup": "^8.4.0",
+		"typescript": "^5.7.3",
+		"vitest": "^3.0.5"
+	}
+}