@zakmandhro/bunti 0.1.3 → 0.1.5

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAkDvE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA+D7D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOpE"}

package/dist/utils.js

@@ -0,0 +1,157 @@
+/**
+ * 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;
+}
+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/package.json

@@ -1,20 +1,43 @@
 {
   "name": "@zakmandhro/bunti",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "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"
+    },
+    "./layout": {
+      "types": "./dist/layout.d.ts",
+      "import": "./dist/layout.js"
+    },
+    "./render": {
+      "types": "./dist/render.d.ts",
+      "import": "./dist/render.js"
+    }
   },
   "type": "module",
   "engines": {
     "bun": ">=1.0.0"
   },
   "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run typecheck && bun run lint && bun run test && bun run build",
     "test": "bun test",
     "bench": "bun scripts/bench.ts",
     "typecheck": "tsc --noEmit",
@@ -39,7 +62,9 @@
   "author": "Zak Mandhro <zakmandhro@gmail.com>",
   "license": "MIT",
   "files": [
-    "src"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "peerDependencies": {
     "picocolors": "^1.0.0"

package/src/colors.ts

@@ -1,255 +0,0 @@
-/**
- * Bunti Semantic & Palette Color System
- */
-
-import type { RGB } from './state';
-
-export interface Gradient {
-  colors: RGB[];
-  direction: 'vertical' | 'horizontal';
-  steps: number;
-}
-
-export const PALETTE = {
-  // Greyscale
-  slate: '235',
-  ash: '240',
-  gray: '244',
-  silver: '247',
-  white: '255',
-  black: '0',
-
-  // Deep Blues & Space
-  midnight: '17',
-  ocean: '24',
-  sky: '33',
-  'bunti-blue': '38',
-  'deep-navy': '17',
-  nebula: '61',
-  plasma: '165',
-
-  // Semantic
-  success: '40',
-  warning: '214',
-  error: '196',
-  info: '39',
-
-  // Accents
-  gold: '220',
-  rose: '211',
-  mint: '121',
-} as const;
-
-const RGB_REGISTRY: Record<string, RGB> = {
-  black: { r: 0, g: 0, b: 0 },
-  red: { r: 200, g: 50, b: 50 },
-  green: { r: 50, g: 200, b: 50 },
-  yellow: { r: 200, g: 200, b: 50 },
-  blue: { r: 50, g: 50, b: 200 },
-  magenta: { r: 200, g: 50, b: 200 },
-  cyan: { r: 50, g: 200, b: 200 },
-  white: { r: 255, g: 255, b: 255 },
-  gray: { r: 128, g: 128, b: 128 },
-  // Greyscale
-  slate: { r: 40, g: 44, b: 52 },
-  ash: { r: 75, g: 82, b: 99 },
-  silver: { r: 188, g: 192, b: 204 },
-  // Deep Blues & Space
-  midnight: { r: 15, g: 15, b: 35 },
-  ocean: { r: 20, g: 40, b: 80 },
-  sky: { r: 0, g: 135, b: 255 },
-  'bunti-blue': { r: 59, g: 188, b: 225 },
-  'deep-navy': { r: 0, g: 51, b: 102 },
-  nebula: { r: 95, g: 95, b: 175 },
-  plasma: { r: 201, g: 0, b: 255 },
-  // Semantic
-  success: { r: 0, g: 215, b: 0 },
-  warning: { r: 255, g: 175, b: 0 },
-  error: { r: 215, g: 0, b: 0 },
-  info: { r: 0, g: 175, b: 255 },
-  // Accents
-  gold: { r: 255, g: 215, b: 0 },
-  rose: { r: 255, g: 175, b: 175 },
-  mint: { r: 175, g: 255, b: 175 },
-};
-
-// Map standard names to ANSI-256 for basic compat
-const NAME_TO_ANSI: Record<string, string> = {
-  red: '160',
-  green: '40',
-  yellow: '220',
-  blue: '33',
-  magenta: '165',
-  cyan: '39',
-  white: '255',
-  black: '0',
-  gray: '244',
-};
-
-export type PaletteColor = keyof typeof PALETTE;
-
-/**
- * Parses a hex color string (#RRGGBB or #RGB) to an RGB object.
- */
-export function hexToRGB(hex: string): RGB {
-  const h = hex.replace('#', '');
-  if (h.length === 3) {
-    return {
-      r: parseInt(h[0]! + h[0]!, 16),
-      g: parseInt(h[1]! + h[1]!, 16),
-      b: parseInt(h[2]! + h[2]!, 16),
-    };
-  }
-  return {
-    r: parseInt(h.substring(0, 2), 16),
-    g: parseInt(h.substring(2, 4), 16),
-    b: parseInt(h.substring(4, 6), 16),
-  };
-}
-
-/**
- * Resolves a palette name, color code, or RGB object to a string for ANSI.
- */
-export function resolveColor(
-  color: PaletteColor | string | number | RGB,
-): string | number {
-  if (typeof color === 'object' && 'r' in color) {
-    return `2;${color.r};${color.g};${color.b}`;
-  }
-  if (typeof color === 'string') {
-    if (color.startsWith('#')) {
-      const rgb = hexToRGB(color);
-      return `2;${rgb.r};${rgb.g};${rgb.b}`;
-    }
-    return (PALETTE as any)[color] || NAME_TO_ANSI[color] || color;
-  }
-  return color;
-}
-
-/**
- * Creates a multi-stop gradient (array of RGB objects) between multiple colors.
- */
-export function createGradient(
-  arg1: (string | number | RGB)[] | string | number | RGB,
-  arg2?: string | number | RGB | number,
-  arg3?: number,
-): RGB[] {
-  let colors: (string | number | RGB)[] = [];
-  let steps = 5;
-
-  if (Array.isArray(arg1)) {
-    colors = arg1;
-    steps = typeof arg2 === 'number' ? arg2 : 5;
-  } else if (arg1 && arg2) {
-    colors = [arg1, arg2 as any];
-    steps = typeof arg3 === 'number' ? arg3 : 5;
-  }
-
-  if (colors.length === 0) return [];
-  if (colors.length === 1)
-    return Array(steps).fill(resolveColorToRGB(colors[0]));
-  if (steps <= 1) return [resolveColorToRGB(colors[0])];
-
-  const result: RGB[] = [];
-  const rgbColors = colors.map(resolveColorToRGB);
-
-  for (let i = 0; i < steps; i++) {
-    const globalT = i / (steps - 1);
-    const segmentCount = rgbColors.length - 1;
-    const segmentIdx = Math.min(
-      Math.floor(globalT * segmentCount),
-      segmentCount - 1,
-    );
-
-    const start = rgbColors[segmentIdx];
-    const end = rgbColors[segmentIdx + 1];
-    const t = globalT * segmentCount - segmentIdx;
-
-    result.push({
-      r: Math.round(start!.r + (end!.r - start!.r) * t),
-      g: Math.round(start!.g + (end!.g - start!.g) * t),
-      b: Math.round(start!.b + (end!.b - start!.b) * t),
-    });
-  }
-
-  return result;
-}
-
-/**
- * Helper to resolve any color type to an RGB object.
- */
-function resolveColorToRGB(color: any): RGB {
-  if (typeof color === 'object' && 'r' in color) return color;
-  if (typeof color === 'string' && color.startsWith('#'))
-    return hexToRGB(color);
-
-  // 1. Check registry
-  if (typeof color === 'string' && RGB_REGISTRY[color])
-    return RGB_REGISTRY[color];
-
-  // 2. Check Palette
-  const paletteValue = (PALETTE as any)[color];
-  if (paletteValue) {
-    // If palette value is a name, look it up in registry
-    const registered = RGB_REGISTRY[color];
-    if (registered) return registered;
-  }
-
-  // Fallback
-  return { r: 128, g: 128, b: 128 };
-}
-
-/**
- * Adjusts the brightness of a color.
- */
-export function adjustBrightness(color: any, amount: number): RGB {
-  const rgb = resolveColorToRGB(color);
-  const factor = 1 + amount / 100;
-  return {
-    r: Math.max(0, Math.min(255, Math.round(rgb.r * factor))),
-    g: Math.max(0, Math.min(255, Math.round(rgb.g * factor))),
-    b: Math.max(0, Math.min(255, Math.round(rgb.b * factor))),
-  };
-}
-
-/**
- * Returns a function that darkens a color and can be used as a style wrapper.
- */
-export function darken(color: any, amount: number = 20) {
-  const adjusted = adjustBrightness(color, -amount);
-  return (text: string) => fg(adjusted, text);
-}
-
-/**
- * Returns a function that lightens a color and can be used as a style wrapper.
- */
-export function lighten(color: any, amount: number = 20) {
-  const adjusted = adjustBrightness(color, amount);
-  return (text: string) => fg(adjusted, text);
-}
-
-/**
- * Returns an RGB object for TrueColor rendering.
- */
-export function rgb(r: number, g: number, b: number) {
-  return { r, g, b };
-}
-
-/**
- * Returns an ANSI escape sequence for a color.
- */
-export function fg(color: any, text: string): string {
-  const code = resolveColor(color);
-  const codeStr = String(code);
-  const prefix =
-    typeof color === 'object' || codeStr.startsWith('2;') ? '38' : '38;5';
-  return `\x1b[${prefix};${codeStr}m${text}\x1b[0m`;
-}
-
-export function bg(color: any, text: string): string {
-  const code = resolveColor(color);
-  const codeStr = String(code);
-  const prefix =
-    typeof color === 'object' || codeStr.startsWith('2;') ? '48' : '48;5';
-  return `\x1b[${prefix};${codeStr}m${text}\x1b[0m`;
-}

package/src/components/Button.ts

@@ -1,104 +0,0 @@
-import type { BuntiContext } from '../dsl';
-import type { StyleOptions } from '../layout';
-
-export interface ButtonProps extends StyleOptions {
-  id: string;
-  label: string;
-  icon?: string;
-  variant?: 'primary' | 'secondary' | 'danger';
-  onClick?: () => void;
-}
-
-/**
- * Tactical Button Component
- * Fully reactive to keyboard focus and action events.
- */
-export function Button(ctx: BuntiContext, props: ButtonProps) {
-  const {
-    box,
-    color,
-    focusable,
-    state,
-    offsetX,
-    offsetY,
-    mouseX,
-    mouseY,
-    isMouseDown,
-  } = ctx;
-
-  // 1. Register in the global focus loop (for TAB navigation)
-  const isSelected = focusable(props.id);
-
-  // 2. Resolve final dimensions to perform Mouse Hit-Testing
-  const finalLabel = props.icon ? `${props.icon} ${props.label}` : props.label;
-  const w = props.width || Math.max(12, finalLabel.length + 4);
-  const h = props.height || 3;
-
-  const resolvedW = typeof w === 'number' ? w : ctx.width;
-  const absX =
-    props.width === '100%'
-      ? offsetX
-      : offsetX + Math.max(0, Math.floor((ctx.width - resolvedW) / 2));
-  const absY = offsetY + ctx.cursorY;
-
-  const isHovered =
-    mouseX >= absX &&
-    mouseX < absX + resolvedW &&
-    mouseY >= absY &&
-    mouseY < absY + (h as number);
-
-  // 3. Resolve Theme & State
-  let bg: any = 254; // Near white
-  let fg: any = 'black';
-  let borderCol: any = { r: 217, g: 216, b: 213 };
-
-  if (props.variant === 'primary') {
-    bg = 'black';
-    fg = 'white';
-    borderCol = 'black';
-  } else if (props.variant === 'danger') {
-    bg = 'error';
-    borderCol = color.lighten('error', 20);
-    fg = 'white';
-  }
-
-  // Active Interactive State
-  const isActive = isSelected || isHovered;
-
-  if (isActive) {
-    if (props.variant === 'primary') {
-      bg = 'ash'; // Hover state for primary
-    } else {
-      borderCol = 'black';
-      if (isMouseDown && isHovered) {
-        bg = color.darken(bg, 5); // Pressed state
-      }
-    }
-  }
-
-  // 4. Handle Interaction
-  const wasClicked = isHovered && isMouseDown && state.mouseButton === 0;
-  const wasActivated =
-    isSelected && (state.lastKey === 'enter' || state.lastKey === ' ');
-
-  if (wasClicked || wasActivated) {
-    if (props.onClick) props.onClick();
-  }
-
-  // 5. Render the Primitive
-  return box(
-    {
-      width: w,
-      height: h,
-      border: props.variant === 'primary' ? 'none' : props.border || 'rounded',
-      borderColor: borderCol,
-      bgColor: bg,
-      align: props.align || 'center',
-      valign: props.valign || 'middle',
-      padding: props.padding || [0, 1],
-    },
-    ({ text }) => {
-      text(color.fg(fg, isActive ? color.bold(finalLabel) : finalLabel));
-    },
-  );
-}

package/src/components/Card.ts

@@ -1,53 +0,0 @@
-import type { BuntiContext, DSLBoxOptions } from '../dsl';
-
-export interface CardProps extends DSLBoxOptions {
-  title?: string;
-  theme?: 'default' | 'accent' | 'danger';
-}
-
-/**
- * Tactical Card Component
- * A structural container with an integrated header.
- */
-export function Card(
-  ctx: BuntiContext,
-  props: CardProps,
-  callback: (sub: BuntiContext) => void,
-) {
-  const { box, color } = ctx;
-
-  const neutralGray = { r: 217, g: 216, b: 213 };
-  let borderColor: any = neutralGray;
-  let titleColor: any = neutralGray;
-
-  if (props.theme === 'accent') {
-    titleColor = 'black';
-    // Border remains neutral gray
-  } else if (props.theme === 'danger') {
-    borderColor = 'error';
-    titleColor = 'error';
-  }
-
-  return box(
-    {
-      x: props.x,
-      y: props.y,
-      anchor: props.anchor,
-      width: props.width || '100%',
-      height: props.height,
-      minHeight: props.minHeight,
-      border: props.border || 'frame',
-      borderColor: props.borderColor || borderColor,
-      padding: props.padding || [1, 2],
-      bgColor: props.bgColor,
-    },
-    (sub) => {
-      if (props.title) {
-        sub.text(
-          color.fg(titleColor, color.bold(`${props.title.toUpperCase()}\n\n`)),
-        );
-      }
-      callback(sub);
-    },
-  );
-}