@lemmo-lab/tokens 2.1.0 → 2.1.1

package/dist/cli/bin/cli.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+import { printBanner } from '../src/utils/banner.js';
+import { commandList } from '../src/commands/list.js';
+import { commandInstall } from '../src/commands/install.js';
+import { commandAddTheme } from '../src/commands/add-theme.js';
+import { commandDiff } from '../src/commands/diff.js';
+
+function printHelp() {
+  printBanner();
+  console.log(`Usage:
+  tokens <command> [options]
+  npx @lemmo-lab/tokens-cli <command> [options]
+
+Commands:
+  install, init, pull           Install token styles & themes (Interactive or Flags)
+  list, ls                      List available themes, formats, and token scales
+  add-theme <name>              Scaffold a new theme adhering to Tier 2 contract
+  diff <theme1> <theme2>        Compare two theme definitions and display differences
+  help                          Show this help message
+
+Options for 'install':
+  --interactive, -i             Launch the interactive installation wizard
+  --theme, -t <names>           Target theme(s): default, light, neon, midnight, all
+  --format, -f <formats>        Output format(s): css, tailwind, js, ts, all
+  --out, -o <dir>               Destination directory [default: ./tokens]
+  --yes, -y                     Accept all default configuration without prompting
+  --dry-run                     Preview files to be installed without writing
+
+Examples:
+  # Interactive wizard (Recommended for new projects):
+  tokens install
+
+  # Install only light theme CSS to ./src/styles/tokens:
+  tokens install --theme light --out ./src/styles/tokens
+
+  # Install default & neon themes with Tailwind preset:
+  tokens install --theme default,neon --format css,tailwind --out ./tokens
+
+  # Compare dark (default) and light themes:
+  tokens diff default light
+`);
+}
+
+function parseArgs(rawArgs) {
+  const parsed = {
+    command: null,
+    target: null,
+    target2: null,
+    theme: null,
+    format: null,
+    out: null,
+    interactive: false,
+    yes: false,
+    dryRun: false
+  };
+
+  let i = 0;
+  while (i < rawArgs.length) {
+    const arg = rawArgs[i];
+    if (!arg.startsWith('-')) {
+      if (!parsed.command) parsed.command = arg;
+      else if (!parsed.target) parsed.target = arg;
+      else if (!parsed.target2) parsed.target2 = arg;
+    } else if (arg === '--help' || arg === '-h') {
+      parsed.command = 'help';
+    } else if (arg === '--theme' || arg === '-t') {
+      parsed.theme = rawArgs[++i];
+    } else if (arg === '--format' || arg === '-f') {
+      parsed.format = rawArgs[++i];
+    } else if (arg === '--out' || arg === '-o') {
+      parsed.out = rawArgs[++i];
+    } else if (arg === '--interactive' || arg === '-i') {
+      parsed.interactive = true;
+    } else if (arg === '--yes' || arg === '-y') {
+      parsed.yes = true;
+    } else if (arg === '--dry-run') {
+      parsed.dryRun = true;
+    }
+    i++;
+  }
+  return parsed;
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const options = parseArgs(args);
+
+  switch (options.command) {
+    case 'list':
+    case 'ls':
+      commandList();
+      break;
+    case 'install':
+    case 'init':
+    case 'pull':
+      await commandInstall(options);
+      break;
+    case 'add-theme':
+      await commandAddTheme(options.target);
+      break;
+    case 'diff':
+      commandDiff(options.target, options.target2);
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      printHelp();
+      break;
+    default:
+      if (!options.command) {
+        // If run with no arguments, launch interactive installation
+        await commandInstall({ interactive: true });
+      } else {
+        printHelp();
+      }
+      break;
+  }
+}
+
+main().catch(err => {
+  console.error('\n❌ CLI Error:', err.message);
+  process.exit(1);
+});

package/dist/cli/src/commands/add-theme.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { printBanner } from '../utils/banner.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const CLI_ROOT = path.resolve(__dirname, '../../');
+const REPO_ROOT = path.resolve(CLI_ROOT, '../../');
+
+export async function commandAddTheme(themeName) {
+  printBanner();
+
+  if (!themeName) {
+    console.error('❌ Please provide a theme name: `tokens add-theme <theme-name>`');
+    process.exit(1);
+  }
+
+  const cleanName = themeName.toLowerCase().replace(/[^a-z0-9_-]/g, '');
+  const themesDir = path.join(REPO_ROOT, 'packages/tokens/src/themes');
+
+  if (!fs.existsSync(themesDir)) {
+    console.error('❌ Must be executed within the tokens monorepo to scaffold themes.');
+    process.exit(1);
+  }
+
+  const newThemePath = path.join(themesDir, `${cleanName}.json`);
+  if (fs.existsSync(newThemePath)) {
+    console.error(`❌ Theme '${cleanName}' already exists at: ${newThemePath}`);
+    process.exit(1);
+  }
+
+  // Load semantic contract template to pre-populate all required contract keys
+  const semanticContractPath = path.join(REPO_ROOT, 'packages/tokens/src/semantic/default.json');
+  const contract = JSON.parse(fs.readFileSync(semanticContractPath, 'utf8'));
+
+  // Scaffold theme conforming 100% to governance rules
+  const scaffoldTheme = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    theme: {
+      color: contract.semantic?.color || {},
+      gradient: contract.semantic?.gradient || {},
+      radius: {
+        base: { $type: 'dimension', $value: '0.5rem' }
+      }
+    }
+  };
+
+  fs.writeFileSync(newThemePath, JSON.stringify(scaffoldTheme, null, 2) + '\n', 'utf8');
+
+  console.log(`🎉 Theme \x1b[32m${cleanName}\x1b[0m scaffolded successfully!`);
+  console.log(`📁 File created: \x1b[36m${newThemePath}\x1b[0m`);
+  console.log(`\nNext Steps:`);
+  console.log(`  1. Open ${newThemePath} and update Tier 1 alias references.`);
+  console.log(`  2. Run \x1b[1mpnpm validate\x1b[0m to ensure it passes all 9 governance rules.`);
+  console.log(`  3. Run \x1b[1mpnpm build\x1b[0m to regenerate CSS and Tailwind outputs.`);
+}

package/dist/cli/src/commands/diff.js

@@ -0,0 +1,72 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { printBanner } from '../utils/banner.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const CLI_ROOT = path.resolve(__dirname, '../../');
+const REPO_ROOT = path.resolve(CLI_ROOT, '../../');
+
+function collectLeafTokens(obj, prefix = '') {
+  let res = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (k.startsWith('$')) continue;
+    const curPath = prefix ? `${prefix}.${k}` : k;
+    if (v && typeof v === 'object') {
+      if (v.$value !== undefined) {
+        res[curPath] = v.$value;
+      } else {
+        Object.assign(res, collectLeafTokens(v, curPath));
+      }
+    }
+  }
+  return res;
+}
+
+export function commandDiff(theme1, theme2) {
+  printBanner();
+
+  if (!theme1 || !theme2) {
+    console.error('❌ Usage: `tokens diff <theme1> <theme2>` (e.g. `tokens diff default light`)');
+    process.exit(1);
+  }
+
+  const themesDir = path.join(REPO_ROOT, 'packages/tokens/src/themes');
+  const t1File = path.join(themesDir, `${theme1.toLowerCase()}.json`);
+  const t2File = path.join(themesDir, `${theme2.toLowerCase()}.json`);
+
+  if (!fs.existsSync(t1File)) {
+    console.error(`❌ Theme '${theme1}' not found at: ${t1File}`);
+    process.exit(1);
+  }
+  if (!fs.existsSync(t2File)) {
+    console.error(`❌ Theme '${theme2}' not found at: ${t2File}`);
+    process.exit(1);
+  }
+
+  const t1Data = JSON.parse(fs.readFileSync(t1File, 'utf8'));
+  const t2Data = JSON.parse(fs.readFileSync(t2File, 'utf8'));
+
+  const t1Tokens = collectLeafTokens(t1Data.theme || {});
+  const t2Tokens = collectLeafTokens(t2Data.theme || {});
+
+  const allKeys = Array.from(new Set([...Object.keys(t1Tokens), ...Object.keys(t2Tokens)])).sort();
+
+  console.log(`📊 Comparing themes: \x1b[33m${theme1}\x1b[0m vs \x1b[36m${theme2}\x1b[0m\n`);
+
+  let diffCount = 0;
+  for (const k of allKeys) {
+    const v1 = t1Tokens[k];
+    const v2 = t2Tokens[k];
+    if (v1 !== v2) {
+      diffCount++;
+      console.log(`  • \x1b[1m${k}\x1b[0m:`);
+      console.log(`    \x1b[33m${theme1}\x1b[0m: ${v1 || '<undefined>'}`);
+      console.log(`    \x1b[36m${theme2}\x1b[0m: ${v2 || '<undefined>'}\n`);
+    }
+  }
+
+  console.log(`=============================================================`);
+  console.log(`Total differences found: ${diffCount} token(s).`);
+}

package/dist/cli/src/commands/install.js

@@ -0,0 +1,275 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { printBanner } from '../utils/banner.js';
+import { createPromptSession } from '../utils/prompts.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const CLI_ROOT = path.resolve(__dirname, '../../');
+const REPO_ROOT = path.resolve(CLI_ROOT, '../../');
+
+const GITHUB_RAW_BASE = 'https://raw.githubusercontent.com/lemmo-lab/tokens/main/packages/tokens-build/dist';
+
+const ALL_THEMES = ['default', 'light', 'neon', 'midnight'];
+const ALL_FORMATS = ['css', 'tailwind', 'js', 'ts'];
+
+async function getAssetContent(relPath) {
+  // 1. Direct dist folder (when bundled inside @lemmo-lab/tokens package)
+  const distDirect = path.resolve(__dirname, '../../../');
+  if (fs.existsSync(path.join(distDirect, relPath))) {
+    return fs.readFileSync(path.join(distDirect, relPath), 'utf8');
+  }
+
+  // 2. Check local assets dir inside CLI package
+  const cliAssetPath = path.join(CLI_ROOT, 'assets', relPath);
+  if (fs.existsSync(cliAssetPath)) {
+    return fs.readFileSync(cliAssetPath, 'utf8');
+  }
+
+  // 3. Check monorepo dist
+  const distPath = path.join(REPO_ROOT, 'packages/tokens-build/dist', relPath);
+  if (fs.existsSync(distPath)) {
+    return fs.readFileSync(distPath, 'utf8');
+  }
+
+  // 3. Fallback to remote GitHub raw
+  const remoteUrl = `${GITHUB_RAW_BASE}/${relPath}`;
+  try {
+    const res = await fetch(remoteUrl);
+    if (!res.ok) throw new Error(`HTTP ${res.status} ${res.statusText}`);
+    return await res.text();
+  } catch (err) {
+    throw new Error(`Failed to load asset ${relPath}: ${err.message}`);
+  }
+}
+
+export async function commandInstall(options) {
+  printBanner();
+
+  let targetOut = options.out || './tokens';
+  let targetThemes = [];
+  let targetFormats = [];
+  let generateRootIndex = true;
+  let isDryRun = options.dryRun || false;
+
+  // Determine if interactive session is needed
+  const isInteractive = options.interactive || (!options.theme && !options.format && !options.yes);
+
+  if (isInteractive) {
+    console.log('🔮 \x1b[1mInteractive Lemmo Tokens Installation Wizard\x1b[0m\n');
+    const prompts = await createPromptSession();
+
+    try {
+      // 1. Output directory
+      targetOut = await prompts.askText('📁 Where should the tokens be installed?', targetOut);
+
+      // 2. Format selection
+      targetFormats = await prompts.askMultiChoice(
+        '📦 Select the formats you want to install:',
+        [
+          { label: 'CSS Variables (variables.css & theme overrides)', value: 'css' },
+          { label: 'Tailwind CSS Preset (tailwind.preset.js)', value: 'tailwind' },
+          { label: 'JavaScript / TypeScript Dictionaries (tokens.js & tokens.d.ts)', value: 'js' }
+        ],
+        [0] // default CSS
+      );
+
+      // 3. Theme selection
+      targetThemes = await prompts.askMultiChoice(
+        '🎨 Select which theme presets to install:',
+        [
+          { label: 'All themes (Default Dark, Light Day, Neon, Midnight)', value: 'all' },
+          { label: 'Default (Dark theme — #131517 canvas)', value: 'default' },
+          { label: 'Light (Day theme — #f8f9fa canvas, high contrast lime)', value: 'light' },
+          { label: 'Neon (Cyberpunk high contrast — #00ff66 & #00f0ff)', value: 'neon' },
+          { label: 'Midnight (OLED Pure Black — #000000)', value: 'midnight' }
+        ],
+        [0]
+      );
+
+      if (targetThemes.includes('all')) {
+        targetThemes = ['default', 'light', 'neon', 'midnight'];
+      }
+
+      // 4. Generate root index.css
+      if (targetFormats.includes('css')) {
+        generateRootIndex = await prompts.askConfirm('📄 Generate unified index.css with all selected imports?', true);
+      }
+
+      console.log('\nConfiguration Summary:');
+      console.log(`  • Output:   ${targetOut}`);
+      console.log(`  • Formats:  ${targetFormats.join(', ')}`);
+      console.log(`  • Themes:   ${targetThemes.join(', ')}`);
+
+      const proceed = await prompts.askConfirm('Proceed with installation?', true);
+      if (!proceed) {
+        console.log('Installation aborted.');
+        prompts.close();
+        return;
+      }
+    } finally {
+      prompts.close();
+    }
+  } else {
+    // Non-interactive / CLI flag mode
+    if (options.theme) {
+      if (options.theme === 'all') {
+        targetThemes = ALL_THEMES;
+      } else {
+        targetThemes = options.theme.split(',').map(s => s.trim().toLowerCase());
+      }
+    } else {
+      targetThemes = ALL_THEMES;
+    }
+
+    if (options.format) {
+      if (options.format === 'all') {
+        targetFormats = ['css', 'tailwind', 'js'];
+      } else {
+        targetFormats = options.format.split(',').map(s => s.trim().toLowerCase());
+      }
+    } else {
+      targetFormats = ['css'];
+    }
+  }
+
+  // Normalize JS/TS
+  if (targetFormats.includes('js') || targetFormats.includes('ts')) {
+    if (!targetFormats.includes('js')) targetFormats.push('js');
+    if (!targetFormats.includes('ts')) targetFormats.push('ts');
+  }
+
+  console.log(`\n🚀 Installing tokens to: \x1b[36m${path.resolve(process.cwd(), targetOut)}\x1b[0m\n`);
+
+  const destRoot = path.resolve(process.cwd(), targetOut);
+  if (!isDryRun && !fs.existsSync(destRoot)) {
+    fs.mkdirSync(destRoot, { recursive: true });
+  }
+
+  const installedFiles = [];
+
+  // ==========================================================================
+  // 1. Install CSS Variables & Selected Themes
+  // ==========================================================================
+  if (targetFormats.includes('css')) {
+    const cssDestDir = path.join(destRoot, 'css');
+    const themesDestDir = path.join(cssDestDir, 'themes');
+
+    if (!isDryRun) {
+      fs.mkdirSync(themesDestDir, { recursive: true });
+    }
+
+    // A. Base variables.css (includes Tier 1 primitives, Tier 2 semantic roles, and Default Dark theme)
+    const varContent = await getAssetContent('css/variables.css');
+    const varDestFile = path.join(cssDestDir, 'variables.css');
+    if (!isDryRun) {
+      fs.writeFileSync(varDestFile, varContent, 'utf8');
+    }
+    installedFiles.push({ path: varDestFile, label: 'Base CSS Custom Properties' });
+
+    // B. Selected Themes
+    const themeImports = [];
+    themeImports.push(`@import './variables.css';`);
+
+    for (const t of targetThemes) {
+      if (t === 'default') {
+        // default theme is baked directly into variables.css :root
+        continue;
+      }
+      const themeFileName = `${t}.css`;
+      try {
+        const themeContent = await getAssetContent(`css/themes/${themeFileName}`);
+        const themeDestFile = path.join(themesDestDir, themeFileName);
+        if (!isDryRun) {
+          fs.writeFileSync(themeDestFile, themeContent, 'utf8');
+        }
+        installedFiles.push({ path: themeDestFile, label: `Theme override: ${t}` });
+        themeImports.push(`@import './themes/${themeFileName}';`);
+      } catch (e) {
+        console.warn(`  ⚠️ Could not find theme file for: ${t}`);
+      }
+    }
+
+    // C. Unified index.css
+    if (generateRootIndex) {
+      const indexContent = `/**\n * Lemmo Design Tokens — Selected Theme Entry\n * Auto-generated by @lemmo-lab/tokens-cli\n */\n\n` +
+        themeImports.join('\n') + '\n';
+      const indexDestFile = path.join(cssDestDir, 'index.css');
+      if (!isDryRun) {
+        fs.writeFileSync(indexDestFile, indexContent, 'utf8');
+      }
+      installedFiles.push({ path: indexDestFile, label: 'Master CSS Entry Point' });
+    }
+  }
+
+  // ==========================================================================
+  // 2. Install Tailwind Preset
+  // ==========================================================================
+  if (targetFormats.includes('tailwind')) {
+    const tailwindDestDir = path.join(destRoot, 'tailwind');
+    if (!isDryRun) {
+      fs.mkdirSync(tailwindDestDir, { recursive: true });
+    }
+    const twContent = await getAssetContent('tailwind/preset.js');
+    const twDestFile = path.join(tailwindDestDir, 'preset.js');
+    if (!isDryRun) {
+      fs.writeFileSync(twDestFile, twContent, 'utf8');
+    }
+    installedFiles.push({ path: twDestFile, label: 'Tailwind CSS Preset' });
+  }
+
+  // ==========================================================================
+  // 3. Install JavaScript / TypeScript Tokens
+  // ==========================================================================
+  if (targetFormats.includes('js') || targetFormats.includes('ts')) {
+    const jsDestDir = path.join(destRoot, 'js');
+    if (!isDryRun) {
+      fs.mkdirSync(jsDestDir, { recursive: true });
+    }
+
+    const jsContent = await getAssetContent('js/tokens.js');
+    const jsDestFile = path.join(jsDestDir, 'tokens.js');
+    if (!isDryRun) {
+      fs.writeFileSync(jsDestFile, jsContent, 'utf8');
+    }
+    installedFiles.push({ path: jsDestFile, label: 'JavaScript ESM Tokens' });
+
+    const dtsContent = await getAssetContent('js/tokens.d.ts');
+    const dtsDestFile = path.join(jsDestDir, 'tokens.d.ts');
+    if (!isDryRun) {
+      fs.writeFileSync(dtsDestFile, dtsContent, 'utf8');
+    }
+    installedFiles.push({ path: dtsDestFile, label: 'TypeScript Token Definitions' });
+  }
+
+  // Summary
+  console.log('=============================================================');
+  console.log(`🎉 \x1b[32mInstallation complete!\x1b[0m ${installedFiles.length} file(s) installed:\n`);
+  for (const f of installedFiles) {
+    const rel = path.relative(process.cwd(), f.path);
+    console.log(`  ✓ \x1b[36m${rel}\x1b[0m \x1b[90m(${f.label})\x1b[0m`);
+  }
+
+  console.log('\n💡 \x1b[1mQuick Start Integration Guide:\x1b[0m');
+  if (targetFormats.includes('css')) {
+    console.log(`  In your global CSS file:`);
+    console.log(`  \x1b[33m@import './${path.posix.join(targetOut, 'css/index.css')}';\x1b[0m\n`);
+    console.log(`  To activate a theme on a container or page:`);
+    for (const t of targetThemes) {
+      if (t === 'default') {
+        console.log(`  <html data-theme="default">  <!-- Dark Mode (Default) -->`);
+      } else {
+        console.log(`  <html data-theme="${t}">     <!-- ${t.toUpperCase()} Mode -->`);
+      }
+    }
+  }
+
+  if (targetFormats.includes('tailwind')) {
+    console.log(`\n  In your tailwind.config.js:`);
+    console.log(`  module.exports = {`);
+    console.log(`    presets: [require('./${path.posix.join(targetOut, 'tailwind/preset.js')}')],`);
+    console.log(`    // ...`);
+    console.log(`  };`);
+  }
+}

package/dist/cli/src/commands/list.js

@@ -0,0 +1,31 @@
+import { printBanner } from '../utils/banner.js';
+
+export function commandList() {
+  printBanner();
+  console.log(`Available Themes & Formats in @lemmo-lab/tokens v2.0.0:\n`);
+
+  console.log(`🎨 \x1b[1m\x1b[36mShipped Themes (Tier 3 Presets):\x1b[0m`);
+  console.log(`  1. \x1b[33mdefault\x1b[0m   - Official Dark Mode (#131517 canvas, dark elevated surfaces, WCAG AA contrast)`);
+  console.log(`  2. \x1b[33mlight\x1b[0m     - Day / Light Mode (#f8f9fa canvas, #ffffff cards, limeContrast #386b00)`);
+  console.log(`  3. \x1b[33mneon\x1b[0m      - High-energy Cyberpunk preset (electric green #00ff66, cyan #00f0ff glow)`);
+  console.log(`  4. \x1b[33mmidnight\x1b[0m  - OLED Pure Black minimal theme (#000000 canvas, ultra-high contrast)\n`);
+
+  console.log(`📦 \x1b[1m\x1b[36mSupported Output Formats:\x1b[0m`);
+  console.log(`  • \x1b[32mcss\x1b[0m       - Standard CSS Custom Properties (--lemmo-*) with responsive themes`);
+  console.log(`  • \x1b[32mtailwind\x1b[0m  - Tailwind CSS v3 & v4 compatible preset (preset.js)`);
+  console.log(`  • \x1b[32mjs / ts\x1b[0m   - Type-safe JavaScript / TypeScript token dictionary\n`);
+
+  console.log(`📐 \x1b[1m\x1b[36mToken Scales Included:\x1b[0m`);
+  console.log(`  • Colors: Brand, Surface, Text, Border, Status, Alpha overlays`);
+  console.log(`  • Gradients: All 26 fully-tokenized gradients`);
+  console.log(`  • Typography: Satoshi, IRANSans, Morabba, Oddval with unitless leading ratios`);
+  console.log(`  • Spacing: 4px rhythmic scale (0 to 2400)`);
+  console.log(`  • Radius: Relative scale computed from base (--radius)`);
+  console.log(`  • Elevation: Ambient & drop shadows, inner rims, glass reflections`);
+  console.log(`  • Motion: Fast, Normal, Slow durations and cubic bezier curves\n`);
+
+  console.log(`Usage:`);
+  console.log(`  \x1b[1mtokens install\x1b[0m                        # Interactive setup`);
+  console.log(`  \x1b[1mtokens install --theme light\x1b[0m          # Install only light theme`);
+  console.log(`  \x1b[1mtokens install --theme neon,midnight\x1b[0m # Install specific themes`);
+}

package/dist/cli/src/utils/banner.js

@@ -0,0 +1,8 @@
+export function printBanner() {
+  console.log(`
+┌─────────────────────────────────────────────────────────────┐
+│  ⚡ Lemmo Design Tokens CLI Tool (v2.0.0)                     │
+│  Enterprise asset generator, theme installer & synchronizer │
+└─────────────────────────────────────────────────────────────┘
+`);
+}

package/dist/cli/src/utils/prompts.js

@@ -0,0 +1,67 @@
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+
+export async function createPromptSession() {
+  const rl = readline.createInterface({ input, output });
+
+  return {
+    async askText(question, defaultValue = '') {
+      const promptStr = defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `;
+      const answer = await rl.question(promptStr);
+      return answer.trim() || defaultValue;
+    },
+
+    async askConfirm(question, defaultYes = true) {
+      const hint = defaultYes ? '(Y/n)' : '(y/N)';
+      const answer = await rl.question(`${question} ${hint} `);
+      const cleaned = answer.trim().toLowerCase();
+      if (!cleaned) return defaultYes;
+      return cleaned === 'y' || cleaned === 'yes';
+    },
+
+    async askChoice(question, options, defaultIndex = 0) {
+      console.log(`\n${question}`);
+      options.forEach((opt, idx) => {
+        const marker = idx === defaultIndex ? '➔' : ' ';
+        console.log(`  ${marker} ${idx + 1}) ${opt.label || opt}`);
+      });
+      const answer = await rl.question(`Select [1-${options.length}] (default: ${defaultIndex + 1}): `);
+      const num = parseInt(answer.trim(), 10);
+      if (isNaN(num) || num < 1 || num > options.length) {
+        return options[defaultIndex].value !== undefined ? options[defaultIndex].value : options[defaultIndex];
+      }
+      const sel = options[num - 1];
+      return sel.value !== undefined ? sel.value : sel;
+    },
+
+    async askMultiChoice(question, options, defaultSelectedIndices = []) {
+      console.log(`\n${question} (enter comma-separated numbers, e.g. 1,2 or hit enter for default):`);
+      options.forEach((opt, idx) => {
+        const isDef = defaultSelectedIndices.includes(idx);
+        const marker = isDef ? '✓' : ' ';
+        console.log(`  [${marker}] ${idx + 1}) ${opt.label || opt}`);
+      });
+
+      const answer = await rl.question(`Select numbers (default: ${defaultSelectedIndices.map(i => i + 1).join(',')}): `);
+      const cleaned = answer.trim();
+      if (!cleaned) {
+        return defaultSelectedIndices.map(i => options[i].value !== undefined ? options[i].value : options[i]);
+      }
+
+      const indices = cleaned
+        .split(',')
+        .map(s => parseInt(s.trim(), 10) - 1)
+        .filter(i => !isNaN(i) && i >= 0 && i < options.length);
+
+      if (indices.length === 0) {
+        return defaultSelectedIndices.map(i => options[i].value !== undefined ? options[i].value : options[i]);
+      }
+
+      return indices.map(i => options[i].value !== undefined ? options[i].value : options[i]);
+    },
+
+    close() {
+      rl.close();
+    }
+  };
+}

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@lemmo-lab/tokens",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Single source of truth design tokens for Lemmo products",
   "type": "module",
   "main": "./dist/js/tokens.js",
   "module": "./dist/js/tokens.js",
   "types": "./dist/js/tokens.d.ts",
+  "bin": {
+    "lemmo-tokens": "./dist/cli/bin/cli.js",
+    "tokens": "./dist/cli/bin/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/js/tokens.d.ts",