ansimax 1.0.0 → 1.1.0

package/examples/animations.ts

@@ -0,0 +1,172 @@
+// ─────────────────────────────────────────────────────────────
+//  ANSIMAX — Animations Showcase
+//
+//  Designed for screen recording. Each animation has:
+//   - A clear label before
+//   - A pause to capture the start
+//   - The animation itself
+//   - A pause to capture the end
+//
+//  Run with:
+//    npx tsx examples/animations.ts
+// ─────────────────────────────────────────────────────────────
+
+import {
+  color, gradient, rainbow,
+  animate,
+  ascii,
+  sleep, write, writeln, screen,
+} from '../dist/index.js';
+
+// ── Helper: clear screen and show section header ─────────────
+const showHeader = async (num: number, name: string, description: string): Promise<void> => {
+  write(screen.clear());
+  writeln('');
+  writeln(ascii.banner('ANIMATIONS', { font: 'small', colorFn: rainbow, align: 'center' }));
+  writeln('');
+  writeln(ascii.divider({ width: 60 }));
+  writeln('  ' + color.bold(color.cyan(`${num}. ${name}`)));
+  writeln('  ' + color.dim(description));
+  writeln(ascii.divider({ width: 60 }));
+  writeln('');
+  await sleep(1500); // pause to capture title
+};
+
+const main = async (): Promise<void> => {
+  write(screen.clear());
+
+  // ── INTRO ─────────────────────────────────────────────────
+  writeln('');
+  writeln(ascii.banner('ANSIMAX', { font: 'big', colorFn: rainbow, align: 'center' }));
+  writeln('');
+  writeln('  ' + color.bold('  All 7 animation effects'));
+  writeln('  ' + color.dim('  Watch each one in action'));
+  writeln('');
+  await sleep(2500);
+
+  // ── 1. TYPEWRITER ─────────────────────────────────────────
+  await showHeader(1, 'TYPEWRITER', 'Types each character one by one');
+  await animate.typewriter('  Welcome to Ansimax — typing character by character...', { speed: 60 });
+  writeln('');
+  await animate.typewriter('  ' + color.cyan('Perfect for intros and storytelling.'), { speed: 50 });
+  await sleep(2000);
+
+  // ── 2. FADE IN ────────────────────────────────────────────
+  await showHeader(2, 'FADE IN', 'Smooth color fade from black to full brightness');
+  await animate.fadeIn('  Fading in gracefully into view...', {
+    duration: 1500, steps: 20, color: '#48dbfb',
+  });
+  writeln('');
+  await animate.fadeIn('  Use it for elegant reveals.', {
+    duration: 1200, color: '#feca57',
+  });
+  await sleep(2000);
+
+  // ── 3. FADE OUT ───────────────────────────────────────────
+  await showHeader(3, 'FADE OUT', 'Disappears smoothly into the background');
+  writeln('  Watch this text fade away...');
+  await sleep(800);
+  await animate.fadeOut('  Watch this text fade away...', {
+    duration: 1500, steps: 20, color: '#ff6b6b',
+  });
+  await sleep(1500);
+
+  // ── 4. SLIDE ──────────────────────────────────────────────
+  await showHeader(4, 'SLIDE', 'Slides in from a direction');
+  await animate.slide('  Sliding in from the left...', {
+    direction: 'left', duration: 800,
+  });
+  writeln('');
+  await sleep(500);
+  await animate.slide('  And from the right...', {
+    direction: 'right', duration: 800,
+  });
+  await sleep(2000);
+
+  // ── 5. PULSE ──────────────────────────────────────────────
+  await showHeader(5, 'PULSE', 'Pulses between two colors — great for alerts');
+  await animate.pulse('  ⚠️  IMPORTANT NOTIFICATION', {
+    times: 4, interval: 350,
+    color1: { r: 255, g: 100, b: 100 },
+    color2: { r: 255, g: 220, b: 100 },
+  });
+  writeln('');
+  await animate.pulse('  ✓ SUCCESS — Operation complete', {
+    times: 3, interval: 400,
+    color1: { r: 100, g: 255, b: 150 },
+    color2: { r: 100, g: 200, b: 255 },
+  });
+  await sleep(2000);
+
+  // ── 6. WAVE ───────────────────────────────────────────────
+  await showHeader(6, 'WAVE', 'Color wave flowing across each character');
+  await animate.wave('  WAVE OF COLORS FLOWING ACROSS LETTERS', {
+    duration: 2500, steps: 40,
+    colors: ['#ff0000', '#ff7f00', '#ffff00', '#00ff00', '#0000ff', '#8b00ff'],
+  });
+  writeln('');
+  await animate.wave('  Custom palette: ocean tones', {
+    duration: 2000, steps: 30,
+    colors: ['#0070f3', '#48dbfb', '#7928ca', '#ff0080'],
+  });
+  await sleep(2000);
+
+  // ── 7. GLITCH ─────────────────────────────────────────────
+  await showHeader(7, 'GLITCH', 'Random character corruption — perfect for cyberpunk vibes');
+  await animate.glitch('  S Y S T E M   E R R O R', {
+    duration: 1500, intensity: 5,
+  });
+  writeln('');
+  await animate.glitch('  Hacking the mainframe...', {
+    duration: 1800, intensity: 4,
+  });
+  writeln('');
+  await animate.glitch('  ACCESS GRANTED', {
+    duration: 1200, intensity: 6,
+  });
+  await sleep(2000);
+
+  // ── 8. REVEAL ─────────────────────────────────────────────
+  await showHeader(8, 'REVEAL', 'Decrypts random characters into the real text');
+  await animate.reveal('  TOP SECRET — CLASSIFIED INFORMATION', {
+    duration: 2000,
+  });
+  writeln('');
+  await animate.reveal('  Decoding transmission...', {
+    duration: 1500,
+    charset: '0123456789ABCDEF',
+  });
+  writeln('');
+  await animate.reveal('  Welcome to the future', {
+    duration: 1800,
+  });
+  await sleep(2000);
+
+  // ── COMBO ─────────────────────────────────────────────────
+  await showHeader(9, 'COMBINING EFFECTS', 'All animations work together');
+  await animate.typewriter('  Step 1: Typewriter intro...', { speed: 40 });
+  await sleep(500);
+  await animate.fadeIn('  Step 2: Fade in confirmation', { duration: 1000, color: '#00ff88' });
+  await sleep(500);
+  await animate.pulse('  Step 3: Pulse alert', { times: 2, interval: 400 });
+  await sleep(500);
+  await animate.glitch('  Step 4: Final glitch', { duration: 1000, intensity: 4 });
+  await sleep(2000);
+
+  // ── OUTRO ─────────────────────────────────────────────────
+  write(screen.clear());
+  writeln('');
+  writeln(ascii.banner('THANKS!', { font: 'big', colorFn: rainbow, align: 'center' }));
+  writeln('');
+  writeln('  ' + color.bold(color.cyan('  All 7 animations covered.')));
+  writeln('  ' + color.dim('  Each one supports AbortSignal + reducedMotion.'));
+  writeln('');
+  writeln('  ' + color.dim('  $ npm install ansimax'));
+  writeln('');
+  await sleep(3000);
+};
+
+main().catch((err: unknown) => {
+  console.error(color.red('Demo failed:'), err);
+  process.exit(1);
+});

package/examples/demo.js

@@ -0,0 +1,213 @@
+// ─────────────────────────────────────────────────────────────
+//  ANSIMAX — JavaScript Demo (CommonJS)
+//
+//  Run after build:
+//    npm run build
+//    node examples/demo.js
+//
+//  This file imports from the compiled output in dist/ so it works
+//  with plain Node.js — no TypeScript or transpiler required.
+// ─────────────────────────────────────────────────────────────
+
+const ansimax = require('../dist/index.js').default;
+const {
+  color, gradient, rainbow, compose,
+  animate,
+  ascii,
+  loader,
+  frames,
+  components,
+  themes,
+  images, createCanvas,
+  sleep, writeln,
+  hexToRgb, isHexColor, truncateAnsi, wordWrap,
+} = require('../dist/index.js');
+
+// ── Section divider ──────────────────────────────────────────
+const section = (title) => {
+  writeln('');
+  writeln(ascii.divider({ label: color.bold(color.cyan(title)), width: 60 }));
+  writeln('');
+};
+
+const main = async () => {
+  // ── 0 · INTRO ─────────────────────────────────────────────
+  writeln('');
+  writeln(ascii.banner('ANSIMAX', { font: 'big', colorFn: rainbow, align: 'center' }));
+  writeln(color.dim('       JavaScript demo — all modules'));
+  await sleep(800);
+
+  // ── 1 · COLORS ────────────────────────────────────────────
+  section('1 · Colors');
+  writeln('  ' + color.red('red') + '  ' + color.green('green') + '  ' + color.blue('blue') +
+              '  ' + color.yellow('yellow') + '  ' + color.magenta('magenta'));
+  writeln('  ' + color.bold('bold') + '  ' + color.italic('italic') + '  ' +
+              color.underline('underline') + '  ' + color.strikethrough('strike'));
+  writeln('  ' + color.gray('gray') + '  ' + color.orange('orange') + '  ' + color.purple('purple'));
+  writeln('  rgb:      ' + color.rgb(255, 100, 50)('custom RGB'));
+  writeln('  hex:      ' + color.hex('#ff6b6b')('#ff6b6b'));
+  writeln('  bgHex:    ' + color.bgHex('#0575e6')(color.white('  background  ')));
+  writeln('  compose:  ' + compose(color.bold, color.red, color.underline)('CRITICAL'));
+  writeln('  gradient: ' + gradient('Smooth color transitions', ['#ff6b6b', '#feca57', '#48dbfb']));
+  writeln('  rainbow:  ' + rainbow('Taste the rainbow!'));
+  await sleep(800);
+
+  // ── 2 · ASCII ART ─────────────────────────────────────────
+  section('2 · ASCII Art');
+  writeln(ascii.big('HELLO'));
+  writeln('');
+  writeln(ascii.small('small font'));
+  writeln('');
+  writeln(ascii.box('Rounded box with padding', { borderStyle: 'rounded', padding: 1 }));
+  writeln('');
+  writeln(ascii.box(rainbow('Rainbow inside box'), { borderStyle: 'double', padding: 2 }));
+  await sleep(800);
+
+  // ── 3 · ANIMATIONS ────────────────────────────────────────
+  section('3 · Animations');
+  await animate.typewriter('  Typewriter effect — typing one char at a time...', { speed: 25 });
+  await animate.fadeIn('  Fading in...', { duration: 500, color: '#48dbfb' });
+  await animate.slide('  Sliding in', { direction: 'left', duration: 400 });
+  await animate.pulse('  Pulsing color', { times: 2, interval: 200 });
+  await animate.wave('  Wave through letters', { duration: 800, steps: 20 });
+  await animate.glitch('  Glitch effect!', { duration: 500, intensity: 4 });
+  await animate.reveal('  Revealing hidden text', { duration: 700 });
+
+  // ── 4 · LOADERS ───────────────────────────────────────────
+  section('4 · Loaders & Progress');
+
+  const spin = loader.spin('Processing data...', { type: 'dots', color: '#00ff88' });
+  await sleep(1500);
+  spin('Data processed', true);
+
+  await loader.progressAnimate(25, 'Installing packages', { delay: 30, color: '#48dbfb' });
+
+  const taskResults = await loader.tasks([
+    { text: 'Fetching dependencies', fn: async () => { await sleep(400); return 'ok'; } },
+    { text: 'Compiling sources',     fn: async () => { await sleep(600); return 'ok'; } },
+    { text: 'Running tests',         fn: async () => { await sleep(300); return 'ok'; } },
+  ]);
+  writeln(color.dim(`  → ${taskResults.length} tasks completed`));
+
+  writeln('');
+  await loader.countdown(3, { label: 'Launching in', color: '#ffd700' });
+  writeln(color.green('  🚀 Launched!'));
+
+  // ── 5 · FRAMES ────────────────────────────────────────────
+  section('5 · Frame Engine');
+
+  await frames.play(frames.presets.loadingBar({ width: 30 }), { interval: 40, repeat: 1 });
+  await frames.play(frames.presets.ball({ width: 25 }), { interval: 60, repeat: 2 });
+
+  // Morph — unique ansimax feature
+  const morphed = frames.morph('LOADING', 'COMPLETE', 12);
+  await frames.play(morphed, { interval: 80, repeat: 1 });
+  writeln('');
+
+  // ── 6 · COMPONENTS ────────────────────────────────────────
+  section('6 · UI Components');
+
+  writeln(components.table([
+    ['Name',    'Status',      'Score'],
+    ['Alice',   '✓ active',    '95'],
+    ['Bob',     '⚠ pending',   '78'],
+    ['Charlie', '✗ inactive',  '42'],
+  ], { header: true, borderStyle: 'rounded' }));
+  writeln('');
+
+  writeln(components.status('success', 'All tests passed'));
+  writeln(components.status('error',   'Build failed'));
+  writeln(components.status('warn',    'Deprecation notice'));
+  writeln(components.status('info',    'Update available'));
+  writeln(components.status('wait',    'Syncing...'));
+  writeln('');
+
+  writeln('  ' + components.badge('VERSION', 'v1.0.0') + '  ' +
+                components.badge('BUILD', 'passing') + '  ' +
+                components.badge('LICENSE', 'MIT'));
+  writeln('');
+
+  writeln(components.timeline([
+    { label: 'Setup',  done: true,  time: '10:00' },
+    { label: 'Build',  done: true,  time: '10:15' },
+    { label: 'Test',   done: true,  time: '10:32' },
+    { label: 'Deploy', done: false, time: 'pending' },
+    { label: 'Notify', done: false },
+  ]));
+  await sleep(600);
+
+  // ── 7 · THEMES ────────────────────────────────────────────
+  section('7 · Themes');
+
+  themes.list().forEach((name) => {
+    themes.use(name);
+    const t = themes.current();
+    writeln('  ' +
+      color.hex(t.primary)(name.padEnd(12)) +
+      color.hex(t.primary)('●') +
+      color.hex(t.secondary)('●') +
+      color.hex(t.accent)('●') +
+      color.hex(t.error)('●') +
+      color.hex(t.warning)('●'));
+  });
+  themes.use('dracula');
+
+  // ── 8 · IMAGES & CANVAS ───────────────────────────────────
+  section('8 · Pixel Art & Canvas');
+
+  writeln('  Built-in sprites:');
+  writeln(images.sprite('heart'));
+  writeln(images.sprite('star'));
+  writeln('');
+
+  writeln('  Sprite transforms (original / flipped):');
+  const heart = images.sprites.heart.pixels;
+  writeln(images.render(heart, { halfBlock: true }));
+  writeln(images.render(images.flipHorizontal(heart), { halfBlock: true }));
+  writeln('');
+
+  writeln('  Custom canvas:');
+  const canvas = createCanvas(20, 8);
+  canvas.drawRect(0, 0, 20, 8, { r: 30, g: 30, b: 40 }, true);
+  canvas.drawCircle(10, 4, 3, { r: 255, g: 200, b: 0 }, true);
+  canvas.drawRect(5, 2, 10, 4, { r: 255, g: 100, b: 100 });
+  writeln(canvas.render({ halfBlock: true }));
+  writeln('');
+
+  writeln('  Gradient rectangle:');
+  writeln(images.gradientRect({
+    width: 40, height: 6,
+    colors: ['#ff0080', '#7928ca', '#0070f3'],
+    style: 'horizontal',
+  }));
+
+  // ── 9 · UTILITIES ─────────────────────────────────────────
+  section('9 · Utilities');
+
+  writeln(`  isHexColor('#ff0000'):           ${color.green(String(isHexColor('#ff0000')))}`);
+  writeln(`  isHexColor('banana'):            ${color.red(String(isHexColor('banana')))}`);
+  writeln(`  hexToRgb('#48dbfb'):             ${JSON.stringify(hexToRgb('#48dbfb'))}`);
+  writeln(`  truncateAnsi('hello world', 8):  ${truncateAnsi('hello world', 8)}`);
+  writeln('');
+  writeln('  wordWrap demo (width 20):');
+  for (const line of wordWrap('Lorem ipsum dolor sit amet consectetur adipiscing', 20)) {
+    writeln('    ' + color.dim('│') + ' ' + line);
+  }
+
+  // ── 10 · DEFAULT EXPORT ───────────────────────────────────
+  section('10 · Default export');
+  writeln('  ansimax.color.cyan : ' + ansimax.color.cyan('reachable via default export'));
+  writeln('  ansimax.themes.list: ' + JSON.stringify(ansimax.themes.list()));
+
+  // ── CLOSING ───────────────────────────────────────────────
+  section('DONE');
+  writeln(ascii.banner('ALL MODULES OK', { font: 'small', colorFn: rainbow, align: 'center' }));
+  writeln('');
+  writeln(color.dim('  Built with JavaScript + Ansimax · MIT License'));
+  writeln('');
+};
+
+main().catch((err) => {
+  console.error(color.red('Demo failed:'), err);
+  process.exit(1);
+});

package/examples/demo.ts

@@ -0,0 +1,212 @@
+// ─────────────────────────────────────────────────────────────
+//  ANSIMAX — TypeScript Demo
+//
+//  Run after build:
+//    npm run build
+//    npx tsx examples/demo.ts
+//
+//  Or:
+//    npm run build
+//    node --loader ts-node/esm examples/demo.ts
+// ─────────────────────────────────────────────────────────────
+
+import ansimax, {
+  color, gradient, rainbow, compose,
+  animate,
+  ascii,
+  loader,
+  frames,
+  components,
+  themes,
+  images, createCanvas,
+  sleep, writeln,
+  hexToRgb, isHexColor, truncateAnsi, wordWrap,
+} from '../dist/index.js';
+
+const section = (title: string): void => {
+  writeln('');
+  writeln(ascii.divider({ label: color.bold(color.cyan(title)), width: 60 }));
+  writeln('');
+};
+
+const main = async (): Promise<void> => {
+  // ── 0 · INTRO ─────────────────────────────────────────────
+  writeln('');
+  writeln(ascii.banner('ANSIMAX', { font: 'big', colorFn: rainbow, align: 'center' }));
+  writeln(color.dim('       TypeScript demo — all modules'));
+  await sleep(800);
+
+  // ── 1 · COLORS ────────────────────────────────────────────
+  section('1 · Colors');
+  writeln('  ' + color.red('red') + '  ' + color.green('green') + '  ' + color.blue('blue') +
+              '  ' + color.yellow('yellow') + '  ' + color.magenta('magenta'));
+  writeln('  ' + color.bold('bold') + '  ' + color.italic('italic') + '  ' +
+              color.underline('underline') + '  ' + color.strikethrough('strike'));
+  writeln('  ' + color.gray('gray') + '  ' + color.orange('orange') + '  ' + color.purple('purple'));
+  writeln('  rgb:      ' + color.rgb(255, 100, 50)('custom RGB'));
+  writeln('  hex:      ' + color.hex('#ff6b6b')('#ff6b6b'));
+  writeln('  bgHex:    ' + color.bgHex('#0575e6')(color.white('  background  ')));
+  writeln('  compose:  ' + compose(color.bold, color.red, color.underline)('CRITICAL'));
+  writeln('  gradient: ' + gradient('Smooth color transitions', ['#ff6b6b', '#feca57', '#48dbfb']));
+  writeln('  rainbow:  ' + rainbow('Taste the rainbow!'));
+  await sleep(800);
+
+  // ── 2 · ASCII ART ─────────────────────────────────────────
+  section('2 · ASCII Art');
+  writeln(ascii.big('HELLO'));
+  writeln('');
+  writeln(ascii.small('small font'));
+  writeln('');
+  writeln(ascii.box('Rounded box with padding', { borderStyle: 'rounded', padding: 1 }));
+  writeln('');
+  writeln(ascii.box(rainbow('Rainbow inside box'), { borderStyle: 'double', padding: 2 }));
+  await sleep(800);
+
+  // ── 3 · ANIMATIONS ────────────────────────────────────────
+  section('3 · Animations');
+  await animate.typewriter('  Typewriter effect — typing one char at a time...', { speed: 25 });
+  await animate.fadeIn('  Fading in...', { duration: 500, color: '#48dbfb' });
+  await animate.slide('  Sliding in', { direction: 'left', duration: 400 });
+  await animate.pulse('  Pulsing color', { times: 2, interval: 200 });
+  await animate.wave('  Wave through letters', { duration: 800, steps: 20 });
+  await animate.glitch('  Glitch effect!', { duration: 500, intensity: 4 });
+  await animate.reveal('  Revealing hidden text', { duration: 700 });
+
+  // ── 4 · LOADERS ───────────────────────────────────────────
+  section('4 · Loaders & Progress');
+
+  const spin = loader.spin('Processing data...', { type: 'dots', color: '#00ff88' });
+  await sleep(1500);
+  spin('Data processed', true);
+
+  await loader.progressAnimate(25, 'Installing packages', { delay: 30, color: '#48dbfb' });
+
+  const taskResults = await loader.tasks([
+    { text: 'Fetching dependencies', fn: async () => { await sleep(400); return 'ok'; } },
+    { text: 'Compiling sources',     fn: async () => { await sleep(600); return 'ok'; } },
+    { text: 'Running tests',         fn: async () => { await sleep(300); return 'ok'; } },
+  ]);
+  writeln(color.dim(`  → ${taskResults.length} tasks completed`));
+
+  writeln('');
+  await loader.countdown(3, { label: 'Launching in', color: '#ffd700' });
+  writeln(color.green('  🚀 Launched!'));
+
+  // ── 5 · FRAMES ────────────────────────────────────────────
+  section('5 · Frame Engine');
+
+  await frames.play(frames.presets.loadingBar({ width: 30 }), { interval: 40, repeat: 1 });
+  await frames.play(frames.presets.ball({ width: 25 }), { interval: 60, repeat: 2 });
+
+  // Morph — unique ansimax feature
+  const morphed = frames.morph('LOADING', 'COMPLETE', 12);
+  await frames.play(morphed, { interval: 80, repeat: 1 });
+  writeln('');
+
+  // ── 6 · COMPONENTS ────────────────────────────────────────
+  section('6 · UI Components');
+
+  writeln(components.table([
+    ['Name',    'Status',      'Score'],
+    ['Alice',   '✓ active',    '95'],
+    ['Bob',     '⚠ pending',   '78'],
+    ['Charlie', '✗ inactive',  '42'],
+  ], { header: true, borderStyle: 'rounded' }));
+  writeln('');
+
+  writeln(components.status('success', 'All tests passed'));
+  writeln(components.status('error',   'Build failed'));
+  writeln(components.status('warn',    'Deprecation notice'));
+  writeln(components.status('info',    'Update available'));
+  writeln(components.status('wait',    'Syncing...'));
+  writeln('');
+
+  writeln('  ' + components.badge('VERSION', 'v1.0.0') + '  ' +
+                components.badge('BUILD', 'passing') + '  ' +
+                components.badge('LICENSE', 'MIT'));
+  writeln('');
+
+  writeln(components.timeline([
+    { label: 'Setup',  done: true,  time: '10:00' },
+    { label: 'Build',  done: true,  time: '10:15' },
+    { label: 'Test',   done: true,  time: '10:32' },
+    { label: 'Deploy', done: false, time: 'pending' },
+    { label: 'Notify', done: false },
+  ]));
+  await sleep(600);
+
+  // ── 7 · THEMES ────────────────────────────────────────────
+  section('7 · Themes');
+
+  themes.list().forEach((name) => {
+    themes.use(name);
+    const t = themes.current();
+    writeln('  ' +
+      color.hex(t.primary)(name.padEnd(12)) +
+      color.hex(t.primary)('●') +
+      color.hex(t.secondary)('●') +
+      color.hex(t.accent)('●') +
+      color.hex(t.error)('●') +
+      color.hex(t.warning)('●'));
+  });
+  themes.use('dracula');
+
+  // ── 8 · IMAGES & CANVAS ───────────────────────────────────
+  section('8 · Pixel Art & Canvas');
+
+  writeln('  Built-in sprites:');
+  writeln(images.sprite('heart'));
+  writeln(images.sprite('star'));
+  writeln('');
+
+  writeln('  Sprite transforms (original / flipped):');
+  const heart = images.sprites.heart.pixels;
+  writeln(images.render(heart, { halfBlock: true }));
+  writeln(images.render(images.flipHorizontal(heart), { halfBlock: true }));
+  writeln('');
+
+  writeln('  Custom canvas:');
+  const canvas = createCanvas(20, 8);
+  canvas.drawRect(0, 0, 20, 8, { r: 30, g: 30, b: 40 }, true);
+  canvas.drawCircle(10, 4, 3, { r: 255, g: 200, b: 0 }, true);
+  canvas.drawRect(5, 2, 10, 4, { r: 255, g: 100, b: 100 });
+  writeln(canvas.render({ halfBlock: true }));
+  writeln('');
+
+  writeln('  Gradient rectangle:');
+  writeln(images.gradientRect({
+    width: 40, height: 6,
+    colors: ['#ff0080', '#7928ca', '#0070f3'],
+    style: 'horizontal',
+  }));
+
+  // ── 9 · UTILITIES ─────────────────────────────────────────
+  section('9 · Utilities');
+
+  writeln(`  isHexColor('#ff0000'):           ${color.green(String(isHexColor('#ff0000')))}`);
+  writeln(`  isHexColor('banana'):            ${color.red(String(isHexColor('banana')))}`);
+  writeln(`  hexToRgb('#48dbfb'):             ${JSON.stringify(hexToRgb('#48dbfb'))}`);
+  writeln(`  truncateAnsi('hello world', 8):  ${truncateAnsi('hello world', 8)}`);
+  writeln('');
+  writeln('  wordWrap demo (width 20):');
+  for (const line of wordWrap('Lorem ipsum dolor sit amet consectetur adipiscing', 20)) {
+    writeln('    ' + color.dim('│') + ' ' + line);
+  }
+
+  // ── 10 · DEFAULT EXPORT ───────────────────────────────────
+  section('10 · Default export');
+  writeln('  ansimax.color.cyan : ' + ansimax.color.cyan('reachable via default export'));
+  writeln('  ansimax.themes.list: ' + JSON.stringify(ansimax.themes.list()));
+
+  // ── CLOSING ───────────────────────────────────────────────
+  section('DONE');
+  writeln(ascii.banner('ALL MODULES OK', { font: 'small', colorFn: rainbow, align: 'center' }));
+  writeln('');
+  writeln(color.dim('  Built with TypeScript + Ansimax · MIT License'));
+  writeln('');
+};
+
+main().catch((err: unknown) => {
+  console.error(color.red('Demo failed:'), err);
+  process.exit(1);
+});