keyvoid 1.0.0

package/src/utils/big-digits.js

@@ -0,0 +1,130 @@
+// ─── Big Digit Renderer ──────────────────────────────────────────────
+// Renders large 5-line tall digits for the keystroke counter display.
+// Each digit is 6 characters wide. Looks premium in terminal.
+
+const DIGIT_PATTERNS = {
+  '0': [
+    ' ████ ',
+    '██  ██',
+    '██  ██',
+    '██  ██',
+    ' ████ ',
+  ],
+  '1': [
+    '  ██  ',
+    ' ███  ',
+    '  ██  ',
+    '  ██  ',
+    '██████',
+  ],
+  '2': [
+    ' ████ ',
+    '██  ██',
+    '  ██  ',
+    ' ██   ',
+    '██████',
+  ],
+  '3': [
+    '█████ ',
+    '    ██',
+    ' ████ ',
+    '    ██',
+    '█████ ',
+  ],
+  '4': [
+    '██  ██',
+    '██  ██',
+    '██████',
+    '    ██',
+    '    ██',
+  ],
+  '5': [
+    '██████',
+    '██    ',
+    '█████ ',
+    '    ██',
+    '█████ ',
+  ],
+  '6': [
+    ' ████ ',
+    '██    ',
+    '█████ ',
+    '██  ██',
+    ' ████ ',
+  ],
+  '7': [
+    '██████',
+    '   ██ ',
+    '  ██  ',
+    ' ██   ',
+    ' ██   ',
+  ],
+  '8': [
+    ' ████ ',
+    '██  ██',
+    ' ████ ',
+    '██  ██',
+    ' ████ ',
+  ],
+  '9': [
+    ' ████ ',
+    '██  ██',
+    ' █████',
+    '    ██',
+    ' ████ ',
+  ],
+  ',': [
+    '      ',
+    '      ',
+    '      ',
+    '  ██  ',
+    ' ██   ',
+  ],
+  '.': [
+    '      ',
+    '      ',
+    '      ',
+    '      ',
+    '  ██  ',
+  ],
+  ' ': [
+    '   ',
+    '   ',
+    '   ',
+    '   ',
+    '   ',
+  ],
+};
+
+// Render a number string as big 5-line text
+// Returns an array of 5 strings (one per line)
+export function renderBigNumber(numStr) {
+  const digits = String(numStr).split('');
+  const lines = ['', '', '', '', ''];
+
+  for (let i = 0; i < digits.length; i++) {
+    const pattern = DIGIT_PATTERNS[digits[i]] || DIGIT_PATTERNS[' '];
+    for (let row = 0; row < 5; row++) {
+      lines[row] += pattern[row] + (i < digits.length - 1 ? ' ' : '');
+    }
+  }
+
+  return lines;
+}
+
+// Get the total visible width of a big number string
+export function bigNumberWidth(numStr) {
+  const digits = String(numStr).split('');
+  let width = 0;
+  for (let i = 0; i < digits.length; i++) {
+    const pattern = DIGIT_PATTERNS[digits[i]] || DIGIT_PATTERNS[' '];
+    width += pattern[0].length;
+    if (i < digits.length - 1) width += 1; // gap
+  }
+  return width;
+}
+
+// Format a number with comma separation for readability
+export function formatCount(n) {
+  return n.toLocaleString('en-US');
+}

package/src/utils/colors.js

@@ -0,0 +1,114 @@
+// ─── Color Palettes for KeyVoid Skins ────────────────────────────────
+// Each palette is carefully curated for visual harmony and readability.
+
+export const palettes = {
+  clean: {
+    bg:           '\x1b[48;2;10;10;18m',     // Deep space black
+    primary:      '\x1b[38;2;0;255;224m',     // Electric cyan
+    secondary:    '\x1b[38;2;180;180;200m',   // Soft silver
+    accent:       '\x1b[38;2;191;64;191m',    // Neon purple
+    dim:          '\x1b[38;2;60;60;80m',      // Muted gray
+    success:      '\x1b[38;2;0;255;136m',     // Neon green
+    warning:      '\x1b[38;2;255;200;0m',     // Warm gold
+    border:       '\x1b[38;2;40;40;60m',      // Subtle border
+    highlight:    '\x1b[38;2;120;120;255m',   // Soft blue
+    gradientStart:'\x1b[38;2;0;255;224m',     // Cyan
+    gradientEnd:  '\x1b[38;2;191;64;255m',    // Purple
+  },
+
+  toddler: {
+    bg:           '\x1b[48;2;30;15;40m',      // Dark purple
+    primary:      '\x1b[38;2;255;120;200m',   // Hot pink
+    secondary:    '\x1b[38;2;255;220;100m',   // Warm yellow
+    accent:       '\x1b[38;2;100;220;255m',   // Sky blue
+    dim:          '\x1b[38;2;80;50;90m',      // Muted purple
+    fun1:         '\x1b[38;2;255;100;100m',   // Coral
+    fun2:         '\x1b[38;2;100;255;180m',   // Mint
+    fun3:         '\x1b[38;2;200;130;255m',   // Lavender
+    fun4:         '\x1b[38;2;255;180;50m',    // Orange
+  },
+
+  cat: {
+    bg:           '\x1b[48;2;20;14;8m',       // Dark charcoal brown
+    primary:      '\x1b[38;2;255;140;0m',     // Warm orange
+    secondary:    '\x1b[38;2;255;179;0m',     // Amber gold
+    accent:       '\x1b[38;2;255;60;60m',     // Alert red
+    dim:          '\x1b[38;2;80;55;30m',      // Muted brown
+    fur:          '\x1b[38;2;200;150;80m',    // Cat fur color
+    eyes:         '\x1b[38;2;120;255;120m',   // Green cat eyes
+    whiskers:     '\x1b[38;2;180;180;180m',   // Silver whiskers
+  },
+
+  prank: {
+    bg:           '\x1b[48;2;0;120;212m',     // Windows blue
+    primary:      '\x1b[38;2;255;255;255m',   // Pure white
+    secondary:    '\x1b[38;2;200;220;255m',   // Light blue-white
+    dim:          '\x1b[38;2;130;180;240m',   // Soft light blue
+    progress:     '\x1b[38;2;255;255;255m',   // White progress
+    progressBg:   '\x1b[38;2;0;80;160m',      // Dark progress bg
+    error:        '\x1b[38;2;255;200;0m',     // Warning yellow
+  },
+
+  hacker: {
+    bg:           '\x1b[48;2;5;5;5m',         // True black/dark grey
+    primary:      '\x1b[38;2;0;255;0m',       // Pure neon green
+    secondary:    '\x1b[38;2;0;180;0m',       // Matrix string green
+    accent:       '\x1b[38;2;200;255;200m',   // White/green flash
+    dim:          '\x1b[38;2;0;80;0m',        // Faded dark green
+    error:        '\x1b[38;2;255;0;0m',       // Fatal red
+    terminalBg:   '\x1b[48;2;20;20;20m',      // Slightly lighter black for "windows"
+  },
+
+  arcade: {
+    bg:           '\x1b[48;2;10;10;30m',      // Deep arcade navy
+    primary:      '\x1b[38;2;0;255;255m',     // Neon cyan
+    secondary:    '\x1b[38;2;255;0;255m',     // Neon magenta
+    accent:       '\x1b[38;2;255;255;0m',     // Neon yellow
+    dim:          '\x1b[38;2;100;100;150m',   // Faded purple/blue
+    laser:        '\x1b[38;2;255;50;50m',     // Bright red laser
+    alien:        '\x1b[38;2;50;255;50m',     // Classic green alien
+    explosion:    '\x1b[38;2;255;150;0m',     // Orange explosion
+  },
+
+  zen: {
+    bg:           '\x1b[48;2;15;15;25m',      // Very dark twilight blue
+    primary:      '\x1b[38;2;180;180;255m',   // Soft lavender
+    secondary:    '\x1b[38;2;120;200;220m',   // Soft teal
+    accent:       '\x1b[38;2;255;200;200m',   // Soft peach
+    dim:          '\x1b[38;2;60;60;90m',      // Faded twilight
+    ripple:       '\x1b[38;2;255;255;255m',   // Bright wave peak
+  },
+};
+
+// Rainbow colors for toddler mode cycling
+export const rainbow = [
+  '\x1b[48;2;150;70;70m',    // Soft Red
+  '\x1b[48;2;150;110;60m',   // Soft Orange
+  '\x1b[48;2;140;140;60m',   // Soft Yellow
+  '\x1b[48;2;70;140;70m',    // Soft Green
+  '\x1b[48;2;70;110;160m',   // Soft Blue
+  '\x1b[48;2;110;70;150m',   // Soft Indigo
+  '\x1b[48;2;150;70;120m',   // Soft Violet
+];
+
+// ANSI reset code
+export const RESET = '\x1b[0m';
+export const BOLD  = '\x1b[1m';
+export const DIM   = '\x1b[2m';
+export const BLINK = '\x1b[5m';
+
+// Gradient interpolation between two RGB colors
+export function interpolateColor(r1, g1, b1, r2, g2, b2, t) {
+  const r = Math.round(r1 + (r2 - r1) * t);
+  const g = Math.round(g1 + (g2 - g1) * t);
+  const b = Math.round(b1 + (b2 - b1) * t);
+  return `\x1b[38;2;${r};${g};${b}m`;
+}
+
+export function bgColor(r, g, b) {
+  return `\x1b[48;2;${r};${g};${b}m`;
+}
+
+export function fgColor(r, g, b) {
+  return `\x1b[38;2;${r};${g};${b}m`;
+}

package/src/utils/terminal.js

@@ -0,0 +1,119 @@
+// ─── Terminal Utilities ──────────────────────────────────────────────
+// Low-level ANSI escape helpers for full-screen terminal control.
+
+export const ESC = '\x1b';
+
+// Cursor movement
+export const moveTo    = (x, y) => `${ESC}[${y};${x}H`;
+export const moveUp    = (n = 1) => `${ESC}[${n}A`;
+export const moveDown  = (n = 1) => `${ESC}[${n}B`;
+export const moveRight = (n = 1) => `${ESC}[${n}C`;
+export const moveLeft  = (n = 1) => `${ESC}[${n}D`;
+
+// Screen control
+export const clearScreen     = `${ESC}[2J${ESC}[H`;
+export const clearLine       = `${ESC}[2K`;
+export const saveCursor      = `${ESC}[s`;
+export const restoreCursor   = `${ESC}[u`;
+export const hideCursor      = `${ESC}[?25l`;
+export const showCursor      = `${ESC}[?25h`;
+
+// Alternate screen buffer (preserves the user's terminal content)
+export const enterAltScreen  = `${ESC}[?1049h`;
+export const exitAltScreen   = `${ESC}[?1049l`;
+
+// Mouse tracking (SGR extended format for coordinates > 223)
+export const enableMouse     = `${ESC}[?1000h${ESC}[?1006h`;
+export const disableMouse    = `${ESC}[?1000l${ESC}[?1006l`;
+
+// Get terminal dimensions
+export function getSize() {
+  return {
+    cols: process.stdout.columns || 80,
+    rows: process.stdout.rows || 24,
+  };
+}
+
+// Center text within a given width
+export function centerText(text, width, padChar = ' ') {
+  const stripped = stripAnsi(text);
+  const pad = Math.max(0, Math.floor((width - stripped.length) / 2));
+  return padChar.repeat(pad) + text + padChar.repeat(Math.max(0, width - stripped.length - pad));
+}
+
+// Right-align text within a given width
+export function rightAlign(text, width) {
+  const stripped = stripAnsi(text);
+  const pad = Math.max(0, width - stripped.length);
+  return ' '.repeat(pad) + text;
+}
+
+// Strip ANSI codes from a string (for measuring visible length)
+export function stripAnsi(str) {
+  return str.replace(/\x1b\[[0-9;]*[a-zA-Z]|\x1b\[?[0-9;]*[a-zA-Z]/g, '');
+}
+
+// Measure visible length of a string (ignoring ANSI codes)
+export function visibleLength(str) {
+  return stripAnsi(str).length;
+}
+
+// Pad a string to a visible width (respecting ANSI codes)
+export function padEnd(str, width, char = ' ') {
+  const vLen = visibleLength(str);
+  return str + char.repeat(Math.max(0, width - vLen));
+}
+
+// Create a horizontal line
+export function horizontalLine(width, char = '─') {
+  return char.repeat(width);
+}
+
+// Write directly to stdout without buffering newlines
+export function write(str) {
+  process.stdout.write(str);
+}
+
+// Box-drawing characters (Unicode)
+export const box = {
+  topLeft:     '╭',
+  topRight:    '╮',
+  bottomLeft:  '╰',
+  bottomRight: '╯',
+  horizontal:  '─',
+  vertical:    '│',
+  teeRight:    '├',
+  teeLeft:     '┤',
+  cross:       '┼',
+};
+
+// Draw a box outline with optional title
+export function drawBox(x, y, width, height, borderColor = '', resetColor = '\x1b[0m') {
+  const lines = [];
+  // Top
+  lines.push(moveTo(x, y) + borderColor + box.topLeft + box.horizontal.repeat(width - 2) + box.topRight + resetColor);
+  // Sides
+  for (let i = 1; i < height - 1; i++) {
+    lines.push(moveTo(x, y + i) + borderColor + box.vertical + resetColor);
+    lines.push(moveTo(x + width - 1, y + i) + borderColor + box.vertical + resetColor);
+  }
+  // Bottom
+  lines.push(moveTo(x, y + height - 1) + borderColor + box.bottomLeft + box.horizontal.repeat(width - 2) + box.bottomRight + resetColor);
+  return lines.join('');
+}
+
+// Smooth block characters for progress bars
+export const blocks = {
+  full:    '█',
+  seven:   '▉',
+  six:     '▊',
+  five:    '▋',
+  four:    '▌',
+  three:   '▍',
+  two:     '▎',
+  one:     '▏',
+  light:   '░',
+  medium:  '▒',
+  dark:    '▓',
+  empty:   ' ',
+};