ansimax 1.1.0 → 1.1.2

package/examples/07-animations.ts

@@ -0,0 +1,68 @@
+/**
+ * 07 — Animations
+ *
+ * Tests typewriter, fadeIn, fadeOut, slide, pulse, wave, glitch, reveal.
+ *
+ * Run: npx tsx examples/07-animations.ts
+ */
+
+import { animate, gradient, color } from '../src/index.js';
+
+console.log();
+console.log(color.bold('━━━ Animations Demo ━━━'));
+console.log();
+
+// Helper to add pause between animations
+const pause = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms));
+
+// 1. Typewriter
+console.log(color.dim('// 1. Typewriter'));
+await animate.typewriter('Welcome to the ansimax demo...', { speed: 30 });
+await pause(300);
+
+// 2. Typewriter with gradient
+console.log(color.dim('\n// 2. Typewriter + gradient'));
+await animate.typewriter('Colorful typewriter effect!', {
+  speed: 35,
+  colorFn: (t) => gradient(t, ['#ff79c6', '#bd93f9', '#8be9fd']),
+});
+await pause(300);
+
+// 3. FadeIn
+console.log(color.dim('\n// 3. FadeIn'));
+await animate.fadeIn('Fading in smoothly', { duration: 600 });
+await pause(300);
+
+// 4. FadeOut
+console.log(color.dim('\n// 4. FadeOut'));
+await animate.fadeOut('Fading out now...', { duration: 600 });
+await pause(300);
+
+// 5. Slide
+console.log(color.dim('\n// 5. Slide from left'));
+await animate.slide('Sliding into view', { duration: 400, direction: 'left' });
+await pause(300);
+
+// 6. Pulse
+console.log(color.dim('\n// 6. Pulse'));
+await animate.pulse('Pulsing text...', { cycles: 3, duration: 1500 });
+await pause(300);
+
+// 7. Wave
+console.log(color.dim('\n// 7. Wave'));
+await animate.wave('Wave animation!', { duration: 1500 });
+await pause(300);
+
+// 8. Glitch
+console.log(color.dim('\n// 8. Glitch'));
+await animate.glitch('GLITCHED TEXT', { duration: 1000 });
+await pause(300);
+
+// 9. Reveal
+console.log(color.dim('\n// 9. Reveal'));
+await animate.reveal('Revealing secret message', { duration: 1000 });
+await pause(300);
+
+console.log();
+console.log(color.bold(color.green('✓ Animations test complete')));
+console.log();

package/examples/08-loaders.ts

@@ -0,0 +1,98 @@
+/**
+ * 08 — Loaders
+ * Real spinner types: dots, dots2, line, arrow, bounce, star, moon, clock, pong, aesthetic, blocks
+ *
+ * Run: npx tsx examples/08-loaders.ts
+ */
+
+import { loader, SPINNERS, color } from '../src/index.js';
+
+const sleep = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms));
+
+console.log();
+console.log(color.bold('━━━ Available Spinners ━━━'));
+console.log();
+console.log(' ', Object.keys(SPINNERS).join(', '));
+console.log();
+
+console.log(color.bold('━━━ Basic spinner with success ━━━'));
+let stop = loader.spin('Loading data...', { color: '#bd93f9' });
+await sleep(1500);
+stop('Data loaded!', true);
+
+console.log(color.dim('\n// Spinner with failure'));
+stop = loader.spin('Connecting to API...', { color: '#ff5555' });
+await sleep(1500);
+stop('Connection failed', false);
+
+console.log(color.bold('\n━━━ Different spinner types ━━━'));
+const types = ['dots', 'line', 'arrow', 'star', 'bounce', 'moon'] as const;
+for (const type of types) {
+  stop = loader.spin(`Type: ${type}`, { type, color: '#50fa7b' });
+  await sleep(1000);
+  stop();
+}
+
+console.log(color.bold('\n━━━ Static progress bar ━━━'));
+console.log();
+console.log(' ', loader.progress(0, { width: 30 }));
+console.log(' ', loader.progress(33, { width: 30 }));
+console.log(' ', loader.progress(66, { width: 30 }));
+console.log(' ', loader.progress(100, { width: 30 }));
+console.log();
+
+console.log(color.bold('━━━ Animated progress ━━━'));
+console.log();
+await loader.progressAnimate(100, 'Downloading file', {
+  color: '#50fa7b',
+  delay: 15,
+});
+
+console.log(color.bold('\n━━━ Sequential tasks ━━━'));
+console.log();
+await loader.tasks([
+  { text: 'Cloning repository', fn: async () => await sleep(800) },
+  { text: 'Installing dependencies', fn: async () => await sleep(1200) },
+  { text: 'Building project', fn: async () => await sleep(900) },
+  { text: 'Running tests', fn: async () => await sleep(700) },
+]);
+
+console.log(color.bold('\n━━━ Parallel tasks ━━━'));
+console.log();
+await loader.tasks([
+  { text: 'Type check', fn: async () => await sleep(1000) },
+  { text: 'Lint', fn: async () => await sleep(1500) },
+  { text: 'Bundle', fn: async () => await sleep(800) },
+  { text: 'Generate types', fn: async () => await sleep(1200) },
+], { parallel: true });
+
+console.log(color.bold('\n━━━ Hierarchical tasks ━━━'));
+console.log();
+await loader.tasks([
+  {
+    text: 'Build',
+    fn: async () => await sleep(500),
+    subtasks: [
+      { text: 'TypeScript', fn: async () => await sleep(800) },
+      { text: 'Bundle ESM', fn: async () => await sleep(600) },
+      { text: 'Bundle CJS', fn: async () => await sleep(600) },
+    ],
+  },
+  {
+    text: 'Test',
+    fn: async () => await sleep(500),
+    subtasks: [
+      { text: 'Unit tests', fn: async () => await sleep(900) },
+      { text: 'Integration tests', fn: async () => await sleep(700) },
+    ],
+  },
+]);
+
+console.log(color.bold('\n━━━ Countdown ━━━'));
+console.log();
+await loader.countdown(3, { color: '#ff79c6', prefix: 'Starting in ', suffix: 's' });
+console.log(color.green('  Started!'));
+
+console.log();
+console.log(color.bold(color.green('✓ Loaders test complete')));
+console.log();

package/examples/09-themes.ts

@@ -0,0 +1,90 @@
+/**
+ * 09 — Themes
+ *
+ * Run: npx tsx examples/09-themes.ts
+ */
+
+import { themes, createTheme, color } from '../src/index.js';
+
+console.log();
+console.log(color.bold('━━━ Built-in Themes ━━━'));
+console.log();
+
+const builtIns = ['dracula', 'nord', 'monokai', 'cyberpunk', 'pastel', 'matrix', 'ocean', 'sunset'];
+for (const name of builtIns) {
+  themes.use(name);
+  console.log(' ', name.padEnd(12),
+    themes.primary('primary'),
+    themes.secondary('secondary'),
+    themes.accent('accent'),
+    themes.success('success'),
+    themes.warning('warning'),
+    themes.error('error'),
+    themes.info('info'),
+  );
+}
+console.log();
+
+console.log(color.bold('━━━ Background helpers ━━━'));
+console.log();
+themes.use('dracula');
+console.log(' ',
+  themes.bgPrimary(' bgPrimary '), '',
+  themes.bgAccent(' bgAccent '), '',
+);
+console.log();
+
+console.log(color.bold('━━━ Theme info ━━━'));
+console.log();
+console.log('  themes.list():', themes.list().join(', '));
+console.log('  themes.current().name:', themes.current().name);
+console.log();
+
+console.log(color.bold('━━━ Listener (onChange) ━━━'));
+console.log();
+const off = themes.onChange((newTheme, oldTheme) => {
+  console.log(`  ${color.dim('event:')} ${oldTheme.name} → ${color.bold(newTheme.name)}`);
+});
+themes.use('nord');
+themes.use('matrix');
+themes.use('cyberpunk');
+off();
+console.log();
+
+console.log(color.bold('━━━ Register custom theme ━━━'));
+console.log();
+themes.register('custom-blue', {
+  name: 'Custom Blue',
+  primary: '#3b82f6',
+  secondary: '#2563eb',
+  accent: '#60a5fa',
+  success: '#10b981',
+  warning: '#fbbf24',
+  error: '#ef4444',
+  info: '#06b6d4',
+  muted: '#6b7280',
+  bg: '#1e293b',
+  surface: '#334155',
+  text: '#f1f5f9',
+  gradient: ['#3b82f6', '#60a5fa', '#93c5fd'],
+});
+themes.use('custom-blue');
+console.log(' ', themes.primary('Custom theme is now active'));
+console.log(' ', themes.gradient('Theme gradient!'));
+console.log('  current:', themes.current().name);
+console.log();
+
+console.log(color.bold('━━━ Per-instance isolation ━━━'));
+console.log();
+const tenantA = createTheme('nord');
+const tenantB = createTheme('matrix');
+console.log('  tenantA current:', tenantA.current().name);
+console.log('  tenantB current:', tenantB.current().name);
+console.log('  (Each instance has its own state)');
+console.log();
+
+themes.use('dracula');
+themes.unregister('custom-blue');
+
+console.log(color.bold(color.green('✓ Themes test complete')));
+console.log();

package/examples/10-everything.ts

@@ -0,0 +1,133 @@
+/**
+ * 10 — Everything Together
+ *
+ * Run: npx tsx examples/10-everything.ts
+ */
+
+import {
+  color,
+  gradient,
+  ascii,
+  loader,
+  animate,
+  components,
+  themes,
+  images,
+  gradientRect,
+  tree,
+} from '../src/index.js';
+
+const sleep = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms));
+
+console.clear();
+
+// 1. Banner with gradient
+console.log(ascii.banner('ANSIMAX', {
+  font: 'big',
+  align: 'center',
+  colorFn: (t) => gradient(t, ['#ff79c6', '#bd93f9', '#8be9fd']),
+}));
+console.log();
+
+themes.use('dracula');
+
+// 2. Typewriter intro
+await animate.typewriter('Welcome to the comprehensive ansimax showcase...', {
+  speed: 25,
+  colorFn: (t) => themes.primary(t),
+});
+console.log();
+await sleep(500);
+
+// 3. Section header
+console.log(components.section('📦 Project Setup', { width: 60 }));
+console.log();
+
+// 4. Tree
+const project = tree({ label: 'my-microservices', icon: '📦', color: color.bold });
+const api = project.add({ label: 'api', icon: '🌐' });
+api.addLeaf({ label: 'auth-service', icon: '🔐' });
+api.addLeaf({ label: 'user-service', icon: '👤' });
+api.addLeaf({ label: 'payment-service', icon: '💳' });
+const infra = project.add({ label: 'infra', icon: '☁️' });
+infra.addLeaf({ label: 'database', icon: '🗄️' });
+infra.addLeaf({ label: 'cache', icon: '⚡' });
+project.addLeaf({ label: 'docs', icon: '📝' });
+
+console.log(project.render({
+  style: 'rounded',
+  palette: [themes.primary, themes.accent, themes.success],
+  guideColor: themes.muted,
+}));
+console.log();
+
+// 5. Badges
+console.log(components.section('🏷️  Status', { width: 60 }));
+console.log();
+console.log(' ',
+  components.badge('VERSION', 'v1.1.0'),
+  components.badge('BUILD', 'passing'),
+  components.badge('TESTS', '1848 ✓'),
+  components.badge('LICENSE', 'Apache 2.0'),
+);
+console.log();
+await sleep(500);
+
+// 6. Hierarchical tasks
+console.log(components.section('🚀 Deployment', { width: 60 }));
+console.log();
+await loader.tasks([
+  {
+    text: 'Build services',
+    fn: async () => await sleep(300),
+    subtasks: [
+      { text: 'auth-service', fn: async () => await sleep(800) },
+      { text: 'user-service', fn: async () => await sleep(600) },
+      { text: 'payment-service', fn: async () => await sleep(900) },
+    ],
+  },
+  {
+    text: 'Deploy to staging',
+    fn: async () => await sleep(1200),
+  },
+]);
+
+// 7. Service status
+console.log();
+console.log(components.section('📊 Service Status', { width: 60 }));
+console.log();
+console.log(components.table([
+  ['Service', 'Status', 'Version', 'Latency'],
+  ['auth-service', themes.success('● healthy'), 'v2.1.0', '14ms'],
+  ['user-service', themes.success('● healthy'), 'v1.8.3', '22ms'],
+  ['payment-service', themes.warning('● degraded'), 'v1.2.0', '180ms'],
+  ['database', themes.success('● healthy'), 'pg-15.4', '3ms'],
+  ['cache', themes.success('● healthy'), 'redis-7', '1ms'],
+], { borderStyle: 'rounded' }));
+console.log();
+
+// 8. Pixel art
+console.log(components.section('🎉 Complete', { width: 60 }));
+console.log();
+console.log('  ', images.sprite('star'), '   ', images.sprite('heart'), '   ', images.sprite('star'));
+console.log();
+
+// 9. Gradient bar (using top-level gradientRect — verified works)
+console.log(gradientRect({
+  width: 60,
+  height: 2,
+  colors: ['#ff6b6b', '#feca57', '#48dbfb', '#a29bfe', '#fd79a8'],
+  dither: 'bayer',
+}));
+console.log();
+
+// 10. Final summary
+console.log(ascii.box(
+  themes.primary('✨ All systems deployed successfully ✨') + '\n' +
+  themes.muted('Total time: 7.2s · Services: 6 · Tests: 1848'),
+  { padding: 1, borderStyle: 'rounded' },
+));
+console.log();
+
+await animate.fadeOut('Thank you for using ansimax!', { duration: 800 });
+console.log();

package/examples/all-in-one.cjs

@@ -0,0 +1,210 @@
+/**
+ * all-in-one.cjs
+ *
+ * Comprehensive ansimax demo — CommonJS (require).
+ *
+ * This example uses `require('ansimax')` directly so it works in
+ * any CommonJS project after `npm install ansimax`.
+ *
+ * Run:
+ *   node examples/all-in-one.cjs
+ *
+ * (Requires `ansimax` installed: `npm install ansimax`)
+ */
+
+const {
+  color,
+  gradient,
+  rainbow,
+  colorPresets,
+  ascii,
+  loader,
+  animate,
+  components,
+  themes,
+  images,
+  gradientRect,
+  tree,
+  box,
+} = require('ansimax');
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+async function main() {
+  console.clear();
+
+  // ── 1. Banner with gradient ───────────────────────────────
+  console.log(ascii.banner('ANSIMAX', {
+    font: 'big',
+    align: 'center',
+    colorFn: (t) => gradient(t, ['#ff79c6', '#bd93f9', '#8be9fd']),
+  }));
+  console.log();
+
+  // ── 2. Setup theme + intro typewriter ────────────────────
+  themes.use('dracula');
+  await animate.typewriter('  All ansimax features in one script — CommonJS edition', {
+    speed: 25,
+    colorFn: (t) => themes.primary(t),
+  });
+  console.log('\n');
+  await sleep(400);
+
+  // ── 3. Colors ─────────────────────────────────────────────
+  console.log(components.section('🎨 Colors', { width: 60 }));
+  console.log();
+  console.log(' Basic:    ',
+    color.red('red'), color.green('green'), color.blue('blue'),
+    color.yellow('yellow'), color.magenta('magenta'), color.cyan('cyan'));
+  console.log(' Bright:   ',
+    color.brightRed('red'), color.brightGreen('green'), color.brightBlue('blue'),
+    color.brightYellow('yellow'), color.brightMagenta('magenta'), color.brightCyan('cyan'));
+  console.log(' Modifiers:',
+    color.bold('bold'), color.italic('italic'),
+    color.underline('underline'), color.dim('dim'), color.inverse('inverse'));
+  console.log(' Hex:      ',
+    color.hex('#ff79c6')('#ff79c6'),
+    color.hex('#bd93f9')('#bd93f9'),
+    color.hex('#8be9fd')('#8be9fd'),
+    color.hex('#50fa7b')('#50fa7b'));
+  console.log();
+
+  // ── 4. Gradients ──────────────────────────────────────────
+  console.log(components.section('🌈 Gradients', { width: 60 }));
+  console.log();
+  console.log(' Rainbow:', rainbow('Rainbow text with multiple colors'));
+  console.log(' Sunset: ', colorPresets.sunset('Beautiful sunset gradient'));
+  console.log(' Ocean:  ', colorPresets.ocean('Deep ocean gradient'));
+  console.log(' Fire:   ', colorPresets.fire('Burning fire gradient'));
+  console.log(' Custom: ', gradient('Custom multi-stop gradient', ['#ff6b6b', '#feca57', '#48dbfb']));
+  console.log();
+
+  // ── 5. ASCII boxes ────────────────────────────────────────
+  console.log(components.section('📦 Boxes', { width: 60 }));
+  console.log();
+  console.log(ascii.box('Single border', { padding: 1, borderStyle: 'single' }));
+  console.log(ascii.box('Rounded border', { padding: 1, borderStyle: 'rounded' }));
+  console.log(ascii.box('Heavy border', { padding: 1, borderStyle: 'heavy' }));
+  console.log();
+
+  // ── 6. Trees ──────────────────────────────────────────────
+  console.log(components.section('🌳 Trees', { width: 60 }));
+  console.log();
+  const proj = tree({ label: 'project', icon: '📦', color: color.bold });
+  const src = proj.add({ label: 'src', icon: '📁' });
+  src.addLeaf({ label: 'index.js', icon: '📄' });
+  src.addLeaf({ label: 'utils.js', icon: '📄' });
+  proj.addLeaf({ label: 'package.json', icon: '📦' });
+  proj.addLeaf({ label: 'README.md', icon: '📝' });
+  console.log(proj.render({
+    style: 'rounded',
+    palette: [color.cyan, color.green, color.magenta],
+    guideColor: color.dim,
+  }));
+  console.log();
+
+  // ── 7. Tables ─────────────────────────────────────────────
+  console.log(components.section('📊 Tables', { width: 60 }));
+  console.log();
+  console.log(components.table([
+    ['Module', 'Status', 'Tests'],
+    ['colors', color.green('● ready'), '180'],
+    ['ascii',  color.green('● ready'), '125'],
+    ['trees',  color.green('● ready'),  '87'],
+  ], { borderStyle: 'rounded' }));
+  console.log();
+
+  // ── 8. Badges & Status ────────────────────────────────────
+  console.log(components.section('🏷️  Badges & Status', { width: 60 }));
+  console.log();
+  console.log(' ',
+    components.badge('VERSION', 'v1.1.2'),
+    components.badge('BUILD', 'passing'),
+    components.badge('LICENSE', 'Apache 2.0'));
+  console.log();
+  console.log(components.status('Build started', { type: 'info' }));
+  console.log(components.status('Tests passed', { type: 'success' }));
+  console.log(components.status('1 deprecation', { type: 'warning' }));
+  console.log(components.status('Build failed', { type: 'error' }));
+  console.log();
+
+  // ── 9. Loaders ────────────────────────────────────────────
+  console.log(components.section('⏳ Loaders', { width: 60 }));
+  console.log();
+  let stop = loader.spin('Loading data...', { color: '#bd93f9' });
+  await sleep(1200);
+  stop('Data loaded successfully!', true);
+
+  await loader.tasks([
+    { text: 'Compiling sources',    fn: async () => await sleep(700) },
+    { text: 'Bundling modules',     fn: async () => await sleep(900) },
+    { text: 'Generating type defs', fn: async () => await sleep(600) },
+  ]);
+  console.log();
+
+  // ── 10. Pixel art ─────────────────────────────────────────
+  console.log(components.section('🎨 Pixel Art', { width: 60 }));
+  console.log();
+  console.log(' Heart sprite:  ', images.sprite('heart'));
+  console.log();
+  console.log(' Gradient bar:');
+  console.log(gradientRect({
+    width: 50,
+    height: 2,
+    colors: ['#ff6b6b', '#feca57', '#48dbfb', '#a29bfe'],
+    dither: 'bayer',
+  }));
+  console.log();
+
+  // ── 11. Animations ────────────────────────────────────────
+  console.log(components.section('✨ Animations', { width: 60 }));
+  console.log();
+  await animate.fadeIn('  Smooth fade-in animation', { duration: 500 });
+  console.log();
+  await animate.typewriter('  Typewriter effect typing one char at a time...', { speed: 25 });
+  console.log('\n');
+
+  // ── 12. Timeline ──────────────────────────────────────────
+  console.log(components.section('📅 Timeline', { width: 60 }));
+  console.log();
+  console.log(components.timeline([
+    { label: 'Project created',        done: true,  time: 'Mon' },
+    { label: 'Dependencies installed', done: true,  time: 'Tue' },
+    { label: 'Tests passing',          done: true,  time: 'Wed' },
+    { label: 'Documentation written',  done: false, time: 'Thu' },
+    { label: 'Published to npm',       done: false },
+  ]));
+  console.log();
+
+  // ── 13. Themes ────────────────────────────────────────────
+  console.log(components.section('🎭 Themes', { width: 60 }));
+  console.log();
+  for (const name of ['dracula', 'nord', 'monokai', 'cyberpunk', 'matrix']) {
+    themes.use(name);
+    console.log(' ', name.padEnd(12),
+      themes.primary('primary'),
+      themes.accent('accent'),
+      themes.success('success'),
+      themes.warning('warning'),
+      themes.error('error'));
+  }
+  console.log();
+
+  // ── 14. Final box ─────────────────────────────────────────
+  themes.use('dracula');
+  console.log(box(
+    themes.primary('✨ Ansimax demo complete ✨') + '\n' +
+    themes.muted('CommonJS · require · Zero deps'),
+    { padding: 1, borderStyle: 'rounded' },
+  ));
+  console.log();
+
+  // ── 15. Farewell ──────────────────────────────────────────
+  await animate.fadeOut('Thanks for trying ansimax!', { duration: 800 });
+  console.log();
+}
+
+main().catch((err) => {
+  console.error('Error:', err);
+  process.exit(1);
+});