ansimax 1.1.0 → 1.1.2

package/examples/01-quick-smoke.ts

@@ -0,0 +1,121 @@
+/**
+ * 01 — Quick Smoke Test
+ *
+ * Verifies all major named exports from `ansimax` are importable and callable.
+ * This is the FIRST test to run — if it fails, the package is broken.
+ *
+ * Run: npx tsx examples/01-quick-smoke.ts
+ */
+
+import {
+  color,
+  gradient,
+  rainbow,
+  ascii,
+  loader,
+  animate,
+  frames,
+  components,
+  themes,
+  images,
+  trees,
+  tree,
+  configure,
+  getConfig,
+  // Utils
+  stripAnsi,
+  visibleLen,
+  hexToRgb,
+  rgbToHex,
+  clamp,
+  // ANSI primitives
+  cursor,
+  screen,
+  supportsColor,
+} from '../src/index.js';
+
+const pass = (msg: string): void => console.log(color.green('✓'), msg);
+const info = (label: string, value: unknown): void =>
+  console.log('  ' + color.dim(label.padEnd(20)), value);
+
+console.log();
+console.log(color.bold(color.cyan('━━━ Ansimax v1.1.0 Smoke Test ━━━')));
+console.log();
+
+// 1. Colors
+pass('color.red / color.green / color.blue');
+info('color.red:', color.red('red text'));
+info('color.green:', color.green('green text'));
+
+// 2. Gradient
+pass('gradient with multi-stop');
+info('gradient:', gradient('rainbow text', ['#ff0000', '#00ff00', '#0000ff']));
+
+// 3. Rainbow preset
+pass('rainbow preset');
+info('rainbow:', rainbow('hello rainbow!'));
+
+// 4. Style modifiers
+pass('color.bold / italic / underline');
+info('bold:', color.bold('bold text'));
+info('italic:', color.italic('italic text'));
+info('underline:', color.underline('underlined text'));
+
+// 5. Hex & RGB
+pass('color.hex / color.rgb');
+info('color.hex:', color.hex('#ff79c6')('Dracula pink'));
+info('color.rgb:', color.rgb(189, 147, 249)('Dracula purple'));
+
+// 6. ANSI utils
+pass('stripAnsi / visibleLen');
+const colored = color.red('hello');
+info('stripAnsi:', JSON.stringify(stripAnsi(colored)));
+info('visibleLen:', visibleLen(colored));
+
+// 7. hexToRgb / rgbToHex
+pass('hexToRgb / rgbToHex');
+info('hexToRgb #ff79c6:', JSON.stringify(hexToRgb('#ff79c6')));
+info('rgbToHex 189,147,249:', rgbToHex(189, 147, 249));
+
+// 8. clamp
+pass('clamp');
+info('clamp(15, 0, 10):', clamp(15, 0, 10));
+
+// 9. Capability detection
+pass('supportsColor');
+info('supportsColor():', supportsColor());
+
+// 10. Module namespaces
+pass('All namespaces accessible');
+info('color:', typeof color);
+info('ascii:', typeof ascii);
+info('loader:', typeof loader);
+info('animate:', typeof animate);
+info('frames:', typeof frames);
+info('components:', typeof components);
+info('themes:', typeof themes);
+info('images:', typeof images);
+info('trees:', typeof trees);
+
+// 11. tree() builder
+pass('tree() builder');
+const t = tree({ label: 'root', icon: '📦' });
+t.addLeaf({ label: 'child1', icon: '📄' });
+info('tree.render():', '\n' + t.render());
+
+// 12. configure
+pass('configure / getConfig');
+const cfg = getConfig();
+info('theme:', cfg.theme);
+info('colorMode:', cfg.colorMode);
+
+// 13. cursor / screen primitives
+pass('cursor / screen primitives');
+info('cursor.hide():', JSON.stringify(cursor.hide()));
+info('cursor.show():', JSON.stringify(cursor.show()));
+info('screen.clearLine():', JSON.stringify(screen.clearLine()));
+
+console.log();
+console.log(color.bold(color.green('✅ All smoke tests passed!')));
+console.log(color.dim('You have a working ansimax installation.'));
+console.log();

package/examples/02-colors-gradients.ts

@@ -0,0 +1,108 @@
+/**
+ * 02 — Colors & Gradients
+ * Tests verified against actual ansimax@1.1.0 exports.
+ *
+ * Run: npx tsx examples/02-colors-gradients.ts
+ */
+
+import {
+  color,
+  gradient,
+  rainbow,
+  colorPresets,
+  presetNames,
+  compose,
+  chain,
+  registerPreset,
+  listPresets,
+} from '../src/index.js';
+
+console.log();
+console.log(color.bold('━━━ Basic Colors ━━━'));
+console.log();
+
+const basic = ['black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan', 'white'] as const;
+console.log('Basic 8 colors:');
+for (const c of basic) process.stdout.write(color[c](c.padEnd(8)) + ' ');
+console.log('\n');
+
+const bright = ['brightRed', 'brightGreen', 'brightYellow', 'brightBlue', 'brightMagenta', 'brightCyan'] as const;
+console.log('Bright variants:');
+for (const c of bright) process.stdout.write(color[c](c.padEnd(15)) + ' ');
+console.log('\n');
+
+const bg = ['bgRed', 'bgGreen', 'bgBlue', 'bgYellow', 'bgMagenta', 'bgCyan'] as const;
+console.log('Backgrounds:');
+for (const c of bg) process.stdout.write(color[c](` ${c} `) + ' ');
+console.log('\n');
+
+console.log('Modifiers:');
+console.log(' ',
+  color.bold('bold'),
+  color.italic('italic'),
+  color.underline('underline'),
+  color.dim('dim'),
+  color.inverse('inverse'),
+  color.strikethrough('strikethrough'),
+);
+console.log();
+
+console.log(color.bold('━━━ Hex / RGB / 256 ━━━'));
+console.log();
+
+const hexes = ['#ff79c6', '#bd93f9', '#8be9fd', '#50fa7b', '#ffb86c', '#ff5555'];
+console.log('Hex colors:');
+for (const hex of hexes) process.stdout.write(color.hex(hex)(hex) + ' ');
+console.log('\n');
+
+console.log('RGB:');
+console.log(' ', color.rgb(255, 121, 198)('rgb(255, 121, 198)'));
+console.log(' ', color.rgb(189, 147, 249)('rgb(189, 147, 249)'));
+console.log();
+
+console.log('256-color (palette indices):');
+for (const n of [196, 208, 226, 46, 51, 21, 201]) {
+  process.stdout.write(color.color256(n)(`[${n}]`) + ' ');
+}
+console.log('\n');
+
+console.log(color.bold('━━━ Gradients ━━━'));
+console.log();
+
+console.log('Multi-stop gradients:');
+console.log(' ', gradient('Hello gradient world!', ['#ff0000', '#00ff00', '#0000ff']));
+console.log(' ', gradient('Fire to ice', ['#ff6b6b', '#feca57', '#48dbfb']));
+console.log(' ', gradient('Dracula theme', ['#ff79c6', '#bd93f9', '#8be9fd']));
+console.log();
+
+console.log(color.bold('━━━ Built-in colorPresets ━━━'));
+console.log();
+console.log(' Available:', presetNames.join(', '));
+console.log();
+console.log(' rainbow: ', rainbow('rainbow text!'));
+console.log(' sunset:  ', colorPresets.sunset!('sunset preset'));
+console.log(' ocean:   ', colorPresets.ocean!('ocean preset'));
+console.log(' fire:    ', colorPresets.fire!('fire preset'));
+console.log(' neon:    ', colorPresets.neon!('neon preset'));
+console.log(' forest:  ', colorPresets.forest!('forest preset'));
+console.log(' aurora:  ', colorPresets.aurora!('aurora preset'));
+console.log(' candy:   ', colorPresets.candy!('candy preset'));
+console.log(' gold:    ', colorPresets.gold!('gold preset'));
+console.log();
+
+console.log(color.bold('━━━ Custom presets ━━━'));
+console.log();
+registerPreset('my-pink', ['#ff6b6b', '#ff79c6', '#ffb6c1']);
+console.log(' Registered. All presets now:', listPresets().join(', '));
+console.log(' my-pink: ', colorPresets['my-pink']!('My custom pink preset!'));
+console.log();
+
+console.log(color.bold('━━━ Compose & Chain ━━━'));
+console.log();
+const fancy = compose(color.red, color.bold, color.underline);
+console.log(' compose: ', fancy('red + bold + underline'));
+console.log(' chain:   ', chain().magenta().italic().underline().apply('chained styles'));
+console.log();
+
+console.log(color.bold(color.green('✓ Colors & gradients test complete')));
+console.log();

package/examples/03-ascii-banners.ts

@@ -0,0 +1,81 @@
+/**
+ * 03 — ASCII Banners & Boxes
+ * Real box styles: single, double, rounded, heavy, dashed, ascii
+ *
+ * Run: npx tsx examples/03-ascii-banners.ts
+ */
+
+import { ascii, gradient, color, listFonts, hasFont } from '../src/index.js';
+
+console.log();
+console.log(color.bold('━━━ ASCII Banners ━━━'));
+console.log();
+
+console.log(color.dim('// Big font (default)'));
+console.log(ascii.banner('HELLO'));
+
+console.log(color.dim('// Small font'));
+console.log(ascii.banner('HELLO', { font: 'small' }));
+
+console.log(color.dim('// With gradient'));
+console.log(ascii.banner('ANSIMAX', {
+  font: 'big',
+  colorFn: (t) => gradient(t, ['#ff79c6', '#bd93f9', '#8be9fd']),
+}));
+
+console.log(color.dim('// Aligned center'));
+console.log(ascii.banner('CENTER', { align: 'center' }));
+
+console.log(color.dim('// Available fonts:'));
+console.log('  fonts:', listFonts().join(', '));
+console.log('  has "big":', hasFont('big'));
+console.log('  has "small":', hasFont('small'));
+console.log('  has "unicorn":', hasFont('unicorn'));
+console.log();
+
+console.log(color.bold('━━━ Boxes (6 real styles) ━━━'));
+console.log();
+
+// REAL box styles: single, double, rounded, heavy, dashed, ascii
+const boxStyles = ['single', 'double', 'rounded', 'heavy', 'dashed', 'ascii'] as const;
+for (const style of boxStyles) {
+  console.log(color.dim(`// borderStyle: ${style}`));
+  console.log(ascii.box(`This is a ${style} box`, {
+    padding: 1,
+    borderStyle: style,
+  }));
+}
+
+console.log(color.dim('// Multi-line box'));
+console.log(ascii.box(
+  'Line 1\nLine 2 with a bit longer text\nLine 3',
+  { padding: 1, borderStyle: 'rounded' },
+));
+
+console.log();
+console.log(color.bold('━━━ Dividers ━━━'));
+console.log();
+
+console.log(ascii.divider({ char: '─', width: 50 }));
+console.log(ascii.divider({ char: '═', width: 50 }));
+console.log(ascii.divider({ char: '━', width: 50, label: 'Section' }));
+console.log();
+
+console.log(color.bold('━━━ Logo composer ━━━'));
+console.log();
+
+console.log(ascii.logo('LOGO', {
+  font: 'big',
+  colorFn: (t) => gradient(t, ['#ff6b6b', '#feca57', '#48dbfb']),
+  borderStyle: 'rounded',
+}));
+
+console.log();
+console.log(color.bold('━━━ ascii.measure ━━━'));
+console.log();
+const dim = ascii.measure('Hello World', { font: 'big' });
+console.log(`  Banner dimensions: ${dim.width} × ${dim.height}`);
+console.log();
+
+console.log(color.bold(color.green('✓ ASCII test complete')));
+console.log();

package/examples/04-trees.ts

@@ -0,0 +1,117 @@
+/**
+ * 04 — Trees
+ *
+ * Run: npx tsx examples/04-trees.ts
+ */
+
+import {
+  tree,
+  renderTree,
+  walkTree,
+  findInTree,
+  countNodes,
+  mapTree,
+  filterTree,
+  measureTree,
+  color,
+  type TreeData,
+} from '../src/index.js';
+
+console.log();
+console.log(color.bold('━━━ Builder API ━━━'));
+console.log();
+
+const project = tree({ label: 'my-app', icon: '📦', color: color.bold });
+const src = project.add({ label: 'src', icon: '📁' });
+src.addLeaf({ label: 'index.ts', icon: '📄' });
+src.addLeaf({ label: 'app.ts', icon: '📄' });
+const utils = src.add({ label: 'utils', icon: '📁' });
+utils.addLeaf({ label: 'helpers.ts', icon: '📄' });
+utils.addLeaf({ label: 'logger.ts', icon: '📄' });
+project.addLeaf({ label: 'package.json', icon: '📦' });
+project.addLeaf({ label: 'README.md', icon: '📝' });
+
+console.log(project.render());
+console.log();
+
+console.log(color.bold('━━━ Tree styles ━━━'));
+console.log();
+
+const styles = ['rounded', 'classic', 'thick', 'double', 'ascii', 'heavy'] as const;
+for (const style of styles) {
+  console.log(color.dim(`// style: ${style}`));
+  console.log(project.render({ style }));
+}
+
+console.log(color.bold('━━━ Palette colors ━━━'));
+console.log();
+
+console.log(project.render({
+  style: 'rounded',
+  palette: [color.cyan, color.green, color.magenta, color.yellow],
+  guideColor: color.dim,
+}));
+console.log();
+
+console.log(color.bold('━━━ Plain-data API ━━━'));
+console.log();
+
+const tree2: TreeData = {
+  label: 'dependencies',
+  icon: '📦',
+  children: [
+    {
+      label: 'production',
+      icon: '🔒',
+      children: [
+        { label: 'react@18.2.0', icon: '⚛️' },
+        { label: 'tailwind@3.4.1', icon: '🎨' },
+      ],
+    },
+    {
+      label: 'development',
+      icon: '🛠️',
+      children: [
+        { label: 'typescript@5.4.0', icon: '🔷' },
+        { label: 'jest@29.7.0', icon: '🧪' },
+        { label: 'eslint@8.57.0', icon: '✅' },
+      ],
+    },
+  ],
+};
+
+console.log(renderTree(tree2));
+console.log();
+
+console.log(color.bold('━━━ maxDepth truncation ━━━'));
+console.log();
+console.log(color.dim('// maxDepth: 1'));
+console.log(renderTree(tree2, { maxDepth: 1 }));
+console.log();
+
+console.log(color.bold('━━━ Algorithms ━━━'));
+console.log();
+console.log('  countNodes:', countNodes(tree2));
+
+const found = findInTree(tree2, (n) => n.label.includes('react'));
+console.log('  findInTree (react):', found?.label);
+
+console.log('  walkTree paths:');
+walkTree(tree2, (node, depth) => {
+  if (depth > 0) console.log('    ' + '  '.repeat(depth) + '→ ' + node.label);
+});
+
+const upper = mapTree(tree2, (node) => ({ ...node, label: node.label.toUpperCase() }));
+console.log('\n  mapTree (uppercase):');
+console.log(renderTree(upper));
+
+const onlyDev = filterTree(tree2, (n) => n.label !== 'production', { prune: true });
+console.log('  filterTree (no production):');
+if (onlyDev) console.log(renderTree(onlyDev));
+
+const dim = measureTree(tree2);
+console.log(`  measureTree: ${dim.width} × ${dim.height}`);
+console.log();
+
+console.log(color.bold(color.green('✓ Trees test complete')));
+console.log();

package/examples/05-components.ts

@@ -0,0 +1,96 @@
+/**
+ * 05 — Components (NO interactive menu — tested separately)
+ *
+ * Run: npx tsx examples/05-components.ts
+ */
+
+import { components, box, color } from '../src/index.js';
+
+console.log();
+console.log(color.bold('━━━ Tables ━━━'));
+console.log();
+
+console.log(components.table([
+  ['Module', 'Status', 'Coverage', 'Tests'],
+  ['colors', color.green('● ready'), '100%', '180'],
+  ['animations', color.green('● ready'), '99%', '245'],
+  ['loaders', color.green('● ready'), '99%', '210'],
+  ['frames', color.green('● ready'), '99%', '125'],
+  ['components', color.green('● ready'), '100%', '198'],
+  ['themes', color.green('● ready'), '100%', '94'],
+  ['trees', color.green('● ready'), '100%', '87'],
+], { borderStyle: 'rounded' }));
+console.log();
+
+console.log(color.dim('// Table with double border'));
+console.log(components.table([
+  ['Name', 'Age', 'City'],
+  ['Ana', '25', 'Madrid'],
+  ['Carlos', '30', 'Lima'],
+], { borderStyle: 'double' }));
+console.log();
+
+console.log(color.bold('━━━ Badges ━━━'));
+console.log();
+console.log(' ',
+  components.badge('VERSION', 'v1.1.0'),
+  components.badge('BUILD', 'passing'),
+  components.badge('LICENSE', 'Apache 2.0'),
+  components.badge('NPM', 'ansimax'),
+);
+console.log();
+
+console.log(color.bold('━━━ Status ━━━'));
+console.log();
+console.log(components.status('Build started', { type: 'info' }));
+console.log(components.status('Linting passed', { type: 'success' }));
+console.log(components.status('5 deprecation warnings', { type: 'warning' }));
+console.log(components.status('Build failed', { type: 'error' }));
+console.log();
+
+console.log(color.bold('━━━ Section ━━━'));
+console.log();
+console.log(components.section('Installation Steps', { width: 60 }));
+console.log();
+console.log(components.section('Configuration', { width: 60 }));
+console.log();
+
+console.log(color.bold('━━━ Columns ━━━'));
+console.log();
+console.log(components.columns([
+  'Lorem ipsum dolor sit amet',
+  'Consectetur adipiscing elit',
+  'Sed do eiusmod tempor',
+], { cols: 3, gap: 2, width: 60 }));
+console.log();
+
+console.log(color.bold('━━━ Timeline ━━━'));
+console.log();
+console.log(components.timeline([
+  { label: 'Project initialized', done: true, time: '10:00' },
+  { label: 'Dependencies installed', done: true, time: '10:05' },
+  { label: 'Build pipeline configured', done: true, time: '10:15' },
+  { label: 'Tests running', done: false, time: '10:32' },
+  { label: 'Deploy to npm', done: false },
+]));
+console.log();
+
+console.log(color.bold('━━━ Static progress bars ━━━'));
+console.log();
+for (const pct of [10, 25, 50, 75, 90, 100]) {
+  console.log(' ', `${pct.toString().padStart(3)}%`, components.progressBar(pct, { width: 30 }));
+}
+console.log();
+
+console.log(color.bold('━━━ box utility ━━━'));
+console.log();
+console.log(box('Simple box utility', { padding: 1 }));
+console.log();
+console.log(box('Padded + bordered\nwith multiple lines', {
+  padding: 2,
+  borderStyle: 'rounded',
+}));
+console.log();
+
+console.log(color.bold(color.green('✓ Components test complete')));
+console.log();

package/examples/06-pixel-art.ts

@@ -0,0 +1,116 @@
+/**
+ * 06 — Pixel Art & Canvas
+ *
+ * Tests sprites, custom canvas, gradient rectangles, transforms.
+ *
+ * Run: npx tsx examples/06-pixel-art.ts
+ */
+
+import {
+  images,
+  createCanvas,
+  gradientRect,
+  SPRITES,
+  flipHorizontal,
+  flipVertical,
+  rotate90,
+  color,
+} from '../src/index.js';
+
+console.log();
+console.log(color.bold('━━━ Built-in Sprites ━━━'));
+console.log();
+
+// List available sprites
+console.log(color.dim('Available sprites:'), Object.keys(SPRITES).join(', '));
+console.log();
+
+// Render a couple
+console.log(color.dim('// heart sprite'));
+console.log(images.sprite('heart'));
+console.log();
+
+console.log(color.dim('// star sprite'));
+console.log(images.sprite('star'));
+console.log();
+
+console.log(color.bold('━━━ Gradient Rectangles ━━━'));
+console.log();
+
+console.log(color.dim('// Linear gradient'));
+console.log(gradientRect({
+  width: 50,
+  height: 3,
+  colors: ['#ff6b6b', '#feca57', '#48dbfb'],
+}));
+console.log();
+
+console.log(color.dim('// Linear with Bayer dither'));
+console.log(gradientRect({
+  width: 50,
+  height: 4,
+  colors: ['#ff6b6b', '#feca57', '#48dbfb'],
+  dither: 'bayer',
+}));
+console.log();
+
+console.log(color.dim('// Diagonal gradient'));
+console.log(gradientRect({
+  width: 40,
+  height: 4,
+  colors: ['#bd93f9', '#8be9fd'],
+  angle: 45,
+}));
+console.log();
+
+console.log(color.dim('// Radial gradient'));
+console.log(gradientRect({
+  width: 30,
+  height: 8,
+  colors: ['#ff79c6', '#282a36'],
+  type: 'radial',
+}));
+console.log();
+
+console.log(color.bold('━━━ Custom Canvas ━━━'));
+console.log();
+
+const c = createCanvas(40, 10);
+
+// Background
+c.fill({ r: 18, g: 18, b: 38 });
+
+// Some shapes
+c.drawRect(2, 2, 8, 4, { r: 255, g: 100, b: 100 }, true);
+c.drawRect(15, 2, 8, 4, { r: 100, g: 255, b: 100 }, true);
+c.drawRect(28, 2, 8, 4, { r: 100, g: 100, b: 255 }, true);
+
+// Circle
+c.drawCircle(20, 7, 2, { r: 255, g: 220, b: 100 }, true);
+
+c.print();
+console.log();
+
+console.log(color.bold('━━━ Sprite transforms ━━━'));
+console.log();
+
+const star = SPRITES.star!.pixels;
+
+console.log(color.dim('// Original'));
+console.log(images.render(star));
+console.log();
+
+console.log(color.dim('// Flipped horizontal'));
+console.log(images.render(flipHorizontal(star)));
+console.log();
+
+console.log(color.dim('// Flipped vertical'));
+console.log(images.render(flipVertical(star)));
+console.log();
+
+console.log(color.dim('// Rotated 90°'));
+console.log(images.render(rotate90(star)));
+console.log();
+
+console.log(color.bold(color.green('✓ Pixel art test complete')));
+console.log();