@zakmandhro/bunti 0.1.4 → 0.2.0

package/dist/utils.js

@@ -0,0 +1,158 @@
+/**
+ * Bunti Utility Suite - Bun-Native High Performance Edition
+ */
+/**
+ * Strips ANSI escape sequences from a string to allow accurate width measurement.
+ */
+export function stripAnsi(str) {
+    if (!str)
+        return '';
+    return str.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, '');
+}
+/**
+ * Calculates the visible width of a string using Bun's SIMD-optimized API.
+ */
+export function visibleWidth(str) {
+    if (!str)
+        return 0;
+    const lines = str.split('\n');
+    if (lines.length > 1) {
+        return Math.max(...lines.map(visibleWidth));
+    }
+    return Bun.stringWidth(stripAnsi(str));
+}
+/**
+ * Returns the width of a single character or grapheme.
+ */
+export function charWidth(char) {
+    const clean = stripAnsi(char);
+    if (clean.length === 0)
+        return 0;
+    return Bun.stringWidth(clean);
+}
+/**
+ * Truncates a string to a visible width while preserving ANSI codes.
+ * GUARANTEE: Never slices an ANSI escape sequence in half.
+ */
+export function truncate(str, width, tail = '…') {
+    const visible = visibleWidth(str);
+    if (visible <= width)
+        return str;
+    const targetWidth = width - visibleWidth(tail);
+    if (targetWidth <= 0)
+        return '';
+    let currentWidth = 0;
+    let out = '';
+    // Custom parsing loop to isolate ANSI sequences from text
+    const regex = /\x1B\[[0-9;]*[a-zA-Z]/g;
+    let lastIndex = 0;
+    let match = null;
+    while ((match = regex.exec(str)) !== null) {
+        // 1. Process text before the ANSI code
+        const textSegment = str.substring(lastIndex, match.index);
+        if (textSegment.length > 0) {
+            const segmenter = new Intl.Segmenter('en', { granularity: 'grapheme' });
+            for (const { segment } of segmenter.segment(textSegment)) {
+                const w = charWidth(segment);
+                if (currentWidth + w > targetWidth) {
+                    return `${out}\x1b[0m${tail}`; // Return immediately upon hitting limit
+                }
+                out += segment;
+                currentWidth += w;
+            }
+        }
+        // 2. Append the ANSI code itself (zero width)
+        out += match[0];
+        lastIndex = regex.lastIndex;
+    }
+    // 3. Process remaining text after the last ANSI code
+    const remainingText = str.substring(lastIndex);
+    if (remainingText.length > 0) {
+        const segmenter = new Intl.Segmenter('en', { granularity: 'grapheme' });
+        for (const { segment } of segmenter.segment(remainingText)) {
+            const w = charWidth(segment);
+            if (currentWidth + w > targetWidth) {
+                return `${out}\x1b[0m${tail}`;
+            }
+            out += segment;
+            currentWidth += w;
+        }
+    }
+    return `${out}\x1b[0m`;
+}
+/**
+ * Wraps text to a specific visible width, preserving ANSI codes.
+ * Implements word-based wrapping with fallback to char-breaking for long tokens.
+ */
+export function wrapText(str, width) {
+    if (width <= 0)
+        return [str];
+    const result = [];
+    const rawLines = str.split('\n');
+    for (const rawLine of rawLines) {
+        if (visibleWidth(rawLine) <= width) {
+            result.push(rawLine);
+            continue;
+        }
+        // Split into tokens: words and whitespaces
+        const tokens = rawLine.split(/(\s+)/).filter((t) => t.length > 0);
+        let currentLine = '';
+        let currentWidth = 0;
+        for (const token of tokens) {
+            const tokenWidth = visibleWidth(token);
+            const isWhitespace = /^\s+$/.test(stripAnsi(token));
+            // If token itself is too wide, we MUST break it by character
+            if (tokenWidth > width) {
+                // Flush current line if it exists
+                if (currentLine) {
+                    result.push(`${currentLine}\x1b[0m`);
+                    currentLine = '';
+                    currentWidth = 0;
+                }
+                // Segmented break of the long token
+                const segmenter = new Intl.Segmenter('en', { granularity: 'grapheme' });
+                for (const { segment } of segmenter.segment(token)) {
+                    const sw = charWidth(segment);
+                    if (currentWidth + sw > width) {
+                        result.push(`${currentLine}\x1b[0m`);
+                        currentLine = segment;
+                        currentWidth = sw;
+                    }
+                    else {
+                        currentLine += segment;
+                        currentWidth += sw;
+                    }
+                }
+                continue;
+            }
+            // Normal word wrap
+            if (currentWidth + tokenWidth > width) {
+                if (isWhitespace) {
+                    // Swallow leading whitespace on new lines
+                    continue;
+                }
+                result.push(`${currentLine.trimEnd()}\x1b[0m`);
+                currentLine = token;
+                currentWidth = tokenWidth;
+            }
+            else {
+                currentLine += token;
+                currentWidth += tokenWidth;
+            }
+        }
+        if (currentLine)
+            result.push(currentLine.trimEnd());
+    }
+    return result;
+}
+/** Prefixes every line of a block with `columns` spaces. */
+export function indentBlock(content, columns) {
+    if (columns <= 0)
+        return content;
+    const prefix = ' '.repeat(columns);
+    return content
+        .split('\n')
+        .map((line) => prefix + line)
+        .join('\n');
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/dist/vendor/colors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Bunti Vendored ANSI Colors
+ *
+ * Adapted from picocolors (https://github.com/alexeyraspopov/picocolors)
+ * Copyright (c) 2021-2024 Oleksii Raspopov, Kostiantyn Denysov, Anton Verinov
+ * MIT License.
+ *
+ * Vendored (and typed) so Bunti ships with zero runtime dependencies. It
+ * keeps picocolors' wrap semantics: each formatter wraps text in open/close
+ * ANSI codes and re-opens the style after any nested close code, so nested
+ * styles compose correctly.
+ */
+/** Wraps input in ANSI codes. Non-strings are coerced via string conversion. */
+export type ColorFormatter = (input: string | number | null | undefined) => string;
+/**
+ * The color surface Bunti exposes on `ctx.color` (minus Bunti's own RGB
+ * helpers, which are layered on top in the DSL context).
+ */
+export interface BuntiColor {
+    isColorSupported: boolean;
+    reset: ColorFormatter;
+    bold: ColorFormatter;
+    dim: ColorFormatter;
+    italic: ColorFormatter;
+    underline: ColorFormatter;
+    black: ColorFormatter;
+    red: ColorFormatter;
+    green: ColorFormatter;
+    yellow: ColorFormatter;
+    blue: ColorFormatter;
+    magenta: ColorFormatter;
+    cyan: ColorFormatter;
+    white: ColorFormatter;
+    gray: ColorFormatter;
+    bgBlack: ColorFormatter;
+    bgRed: ColorFormatter;
+    bgGreen: ColorFormatter;
+    bgYellow: ColorFormatter;
+    bgBlue: ColorFormatter;
+    bgMagenta: ColorFormatter;
+    bgCyan: ColorFormatter;
+    bgWhite: ColorFormatter;
+}
+export declare const colors: BuntiColor;
+//# sourceMappingURL=colors.d.ts.map

package/dist/vendor/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/vendor/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KACtC,MAAM,CAAC;AAEZ;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;CACzB;AAoDD,eAAO,MAAM,MAAM,EAAE,UAwBpB,CAAC"}

package/dist/vendor/colors.js

@@ -0,0 +1,72 @@
+/**
+ * Bunti Vendored ANSI Colors
+ *
+ * Adapted from picocolors (https://github.com/alexeyraspopov/picocolors)
+ * Copyright (c) 2021-2024 Oleksii Raspopov, Kostiantyn Denysov, Anton Verinov
+ * MIT License.
+ *
+ * Vendored (and typed) so Bunti ships with zero runtime dependencies. It
+ * keeps picocolors' wrap semantics: each formatter wraps text in open/close
+ * ANSI codes and re-opens the style after any nested close code, so nested
+ * styles compose correctly.
+ */
+const env = process.env ?? {};
+const argv = process.argv ?? [];
+const isColorSupported = !(env.NO_COLOR || argv.includes('--no-color')) &&
+    Boolean(env.FORCE_COLOR ||
+        argv.includes('--color') ||
+        process.platform === 'win32' ||
+        (process.stdout?.isTTY && env.TERM !== 'dumb') ||
+        env.CI);
+/**
+ * Replaces every occurrence of `close` inside `text` with `replace`, so an
+ * inner style's reset re-opens the outer style instead of ending it.
+ */
+function replaceClose(text, close, replace, index) {
+    let result = '';
+    let cursor = 0;
+    do {
+        result += text.substring(cursor, index) + replace;
+        cursor = index + close.length;
+        index = text.indexOf(close, cursor);
+    } while (index !== -1);
+    return result + text.substring(cursor);
+}
+function formatter(open, close, replace = open) {
+    if (!isColorSupported) {
+        return (input) => `${input}`;
+    }
+    return (input) => {
+        const text = `${input}`;
+        const index = text.indexOf(close, open.length);
+        return index !== -1
+            ? open + replaceClose(text, close, replace, index) + close
+            : open + text + close;
+    };
+}
+export const colors = {
+    isColorSupported,
+    reset: formatter('\x1b[0m', '\x1b[0m'),
+    bold: formatter('\x1b[1m', '\x1b[22m', '\x1b[22m\x1b[1m'),
+    dim: formatter('\x1b[2m', '\x1b[22m', '\x1b[22m\x1b[2m'),
+    italic: formatter('\x1b[3m', '\x1b[23m'),
+    underline: formatter('\x1b[4m', '\x1b[24m'),
+    black: formatter('\x1b[30m', '\x1b[39m'),
+    red: formatter('\x1b[31m', '\x1b[39m'),
+    green: formatter('\x1b[32m', '\x1b[39m'),
+    yellow: formatter('\x1b[33m', '\x1b[39m'),
+    blue: formatter('\x1b[34m', '\x1b[39m'),
+    magenta: formatter('\x1b[35m', '\x1b[39m'),
+    cyan: formatter('\x1b[36m', '\x1b[39m'),
+    white: formatter('\x1b[37m', '\x1b[39m'),
+    gray: formatter('\x1b[90m', '\x1b[39m'),
+    bgBlack: formatter('\x1b[40m', '\x1b[49m'),
+    bgRed: formatter('\x1b[41m', '\x1b[49m'),
+    bgGreen: formatter('\x1b[42m', '\x1b[49m'),
+    bgYellow: formatter('\x1b[43m', '\x1b[49m'),
+    bgBlue: formatter('\x1b[44m', '\x1b[49m'),
+    bgMagenta: formatter('\x1b[45m', '\x1b[49m'),
+    bgCyan: formatter('\x1b[46m', '\x1b[49m'),
+    bgWhite: formatter('\x1b[47m', '\x1b[49m'),
+};
+//# sourceMappingURL=colors.js.map

package/dist/vendor/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/vendor/colors.ts"],"names":[],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,79 @@
+# Bunti
+
+> A Bun-native terminal UI engine with zero dependencies: 60fps
+> double-buffered diff rendering, an immediate-mode contextual DSL,
+> semantic themes (6 VS Code presets), mouse + keyboard input, motion
+> helpers, and a 10.7k-name Nerd Font icon registry. Built to be the
+> easiest TUI library for coding agents.
+
+Requires the Bun runtime (>= 1.0); Node.js is not supported.
+
+## Install
+
+```bash
+bun add @zakmandhro/bunti
+```
+
+## Mental model
+
+- render — Starts a Bunti app: runs `callback` every frame (immediate mode — redraw the whole screen from state each call) and flushes only the changed cells to the terminal.
+- One frame = one callback: read input, derive state with
+  ctx.useState(key, initial), draw everything. Never mutate the
+  terminal yourself.
+- Coordinates are terminal cells, local to the current context (the
+  whole screen at the root; the padded interior inside a box).
+  padding is [vertical, horizontal]. ctx.elapsedTime is milliseconds.
+- Root-level boxes paint directly to the screen and CENTER themselves
+  unless given x/y. Anything that must overlap other content goes in
+  ctx.layer(zIndex, cb) — draw order alone does not stack.
+- Keyboard input ({ keyboard: true }) needs a real TTY on stdin; piped
+  input is ignored. Printable keys arrive as the literal character,
+  specials as lowercase names ('up', 'enter'), mouse as
+  'click'/'wheel_up'/'wheel_down'.
+
+## Core API (ctx is the object your render callback receives)
+
+- ctx.box — Draws a styled box and renders the callback inside its padded interior (a fresh sub-context).
+- ctx.text — Appends text to the current flow at the cursor.
+- ctx.icon — Resolves an icon name to its glyph (Nerd Font, or ASCII fallback on plain terminals).
+- ctx.blit — Paints a (possibly multi-line, ANSI-styled) string directly into the screen buffer at absolute cell coordinates — exact-position text, sprites, labels, and ASCII art.
+- ctx.rect — Fills a w×h cell rectangle at absolute coordinates with a style — bars, panels, charts, and backgrounds.
+- ctx.layer — Renders the callback into a transparent buffer composited above the base content by z-index — THE primitive for modals, HUDs, popovers, and anything that must overlap other content.
+- ctx.wallpaper — Fills the whole screen background with a color or gradient.
+- ctx.gradient — Builds a multi-stop Gradient value for `wallpaper`/`bgColor`.
+- ctx.split — Splits the current area into tracks from fixed sizes, percentages, and 'fr' fill units — the layout workhorse for dashboards.
+- ctx.useState — Frame-persistent state.
+- ctx.useAsync — Fetches async data without blocking the render loop: kicks off the fetcher (re-running every `interval` ms when set) and returns the latest { data, loading, error } snapshot each frame.
+- ctx.lastKey — First unmodified key name of this frame, or undefined when no key arrived.
+- ctx.keyPressed — True if `name` was pressed (or auto-repeated) this frame.
+- ctx.isKeyHeld — True from a key's first press until its repeat stream expires (~150ms hold window) — smooth held-key movement on legacy terminals.
+- ctx.hitbox — Registers a clickable region and returns its interaction snapshot for this frame.
+- ctx.isClicked — True exactly one frame per click (SGR release at the press origin) — fire actions here, not on isPressed.
+- ctx.isHovered — True while the mouse is inside the hitbox registered for `id`.
+- ctx.list — Renders a selectable list with built-in up/down keyboard navigation, mouse hover/click selection, and theme-token highlighting.
+- ctx.table — Renders rows of cells as an aligned table with shared borders.
+- ctx.theme — The active semantic theme for this subtree.
+- ctx.setTheme — Swaps the active theme live and requests a rerender.
+- ctx.animate — 0→1 progress over `duration` ms.
+- ctx.transition — Enter/exit progress keyed on a visibility flag.
+- ctx.stagger — Cascading entrance progress: item `index` starts index*delay ms into the timeline and animates for `duration` ms.
+- ctx.elapsedTime — Milliseconds elapsed since render() started.
+- ctx.requestStop — Stops the render loop and restores the terminal (the promise returned by render() then resolves).
+
+## Components ('@zakmandhro/bunti/components')
+
+Box, Card, Button, Input, Modal, Spinner, Progress, Link, Header —
+call as functions: Button(ctx, { id, label, onClick }).
+
+## Themes ('@zakmandhro/bunti/themes')
+
+dracula, tokyoNight, catppuccinMocha, nord, oneDarkPro, githubLight;
+ctx.setTheme(dracula) swaps live. createTheme({...}) derives full
+themes from sparse color specs.
+
+## More
+
+- Full typed API with examples ships in the package's dist/*.d.ts.
+- Agent playbook: AGENTS.md (in this package).
+- Starter template: https://github.com/zakmandhro/bunti/blob/main/examples/starter.ts
+- Docs: https://zakmandhro.github.io/bunti/

package/package.json

@@ -1,21 +1,57 @@
 {
   "name": "@zakmandhro/bunti",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "A Bun-native terminal layout engine with zero dependencies, 60fps rendering, and an agent-optimized functional API.",
-  "module": "src/index.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./components": "./src/components/index.ts",
-    "./icons": "./src/icons.ts",
-    "./layout": "./src/layout.ts",
-    "./render": "./src/render.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.js"
+    },
+    "./geometry": {
+      "types": "./dist/geometry.d.ts",
+      "import": "./dist/geometry.js"
+    },
+    "./icons": {
+      "types": "./dist/icons.d.ts",
+      "import": "./dist/icons.js"
+    },
+    "./icons-full": {
+      "types": "./dist/icons-full.d.ts",
+      "import": "./dist/icons-full.js"
+    },
+    "./layout": {
+      "types": "./dist/layout.d.ts",
+      "import": "./dist/layout.js"
+    },
+    "./render": {
+      "types": "./dist/render.d.ts",
+      "import": "./dist/render.js"
+    },
+    "./themes": {
+      "types": "./dist/themes/index.d.ts",
+      "import": "./dist/themes/index.js"
+    }
   },
   "type": "module",
+  "bin": {
+    "bunti": "dist/cli.js"
+  },
   "engines": {
     "bun": ">=1.0.0"
   },
   "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && bun scripts/build-demos.ts",
+    "gen:llms": "bun scripts/gen-llms.ts",
+    "prepublishOnly": "bun run typecheck && bun run lint && bun run test && bun run gen:llms && bun run build",
     "test": "bun test",
+    "smoke": "bun scripts/smoke-demos.ts",
     "bench": "bun scripts/bench.ts",
     "typecheck": "tsc --noEmit",
     "type-check": "tsc --noEmit",
@@ -24,6 +60,10 @@
     "format": "biome format --write .",
     "demo": "bun demo/runner.ts",
     "example": "bun demo/runner.ts",
+    "record": "vhs tapes/2048.tape",
+    "record:animation": "vhs tapes/animation.tape",
+    "record:mission-control": "vhs tapes/mission-control.tape",
+    "record:all": "vhs tapes/2048.tape && vhs tapes/animation.tape && vhs tapes/mission-control.tape",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs"
@@ -39,11 +79,12 @@
   "author": "Zak Mandhro <zakmandhro@gmail.com>",
   "license": "MIT",
   "files": [
-    "src"
+    "dist",
+    "README.md",
+    "LICENSE",
+    "AGENTS.md",
+    "llms.txt"
   ],
-  "peerDependencies": {
-    "picocolors": "^1.0.0"
-  },
   "devDependencies": {
     "@biomejs/biome": "^2.4.15",
     "@types/bun": "^1.3.13",