@jspreadsheet/install 1.0.1 → 1.1.0

package/index.js

@@ -1,326 +1,459 @@
-#!/usr/bin/env node
-
-const prompts = require('prompts');
-const { execSync } = require('child_process');
-const https = require('https');
-
-const PACKAGES = {
-    pro: {
-        vanilla: 'jspreadsheet',
-        react: '@jspreadsheet/react',
-        vue: '@jspreadsheet/vue',
-        angular: 'jspreadsheet',
-    },
-    ce: {
-        vanilla: 'jspreadsheet-ce',
-        react: '@jspreadsheet-ce/react',
-        vue: '@jspreadsheet-ce/vue',
-        angular: 'jspreadsheet-ce',
-    },
-};
-
-/**
- * Detect the package manager used in the current project
- * @returns {string}
- */
-function detectPackageManager() {
-    const fs = require('fs');
-    const path = require('path');
-    const cwd = process.cwd();
-
-    if (fs.existsSync(path.join(cwd, 'yarn.lock'))) {
-        return 'yarn';
-    }
-    if (fs.existsSync(path.join(cwd, 'pnpm-lock.yaml'))) {
-        return 'pnpm';
-    }
-    if (fs.existsSync(path.join(cwd, 'bun.lockb'))) {
-        return 'bun';
-    }
-    return 'npm';
-}
-
-/**
- * Build the install command for a given package
- * @param {string} pkg
- * @returns {string}
- */
-function getInstallCommand(pkg) {
-    const pm = detectPackageManager();
-    if (pm === 'yarn') {
-        return `yarn add ${pkg}`;
-    }
-    if (pm === 'pnpm') {
-        return `pnpm add ${pkg}`;
-    }
-    if (pm === 'bun') {
-        return `bun add ${pkg}`;
-    }
-    return `npm install ${pkg}`;
-}
-
-/**
- * Register email and get a trial license
- * @param {string} email
- * @returns {Promise<string|null>}
- */
-function registerEmail(email) {
-    return new Promise((resolve) => {
-        const data = JSON.stringify({ email });
-
-        const options = {
-            hostname: 'jspreadsheet.com',
-            port: 443,
-            path: '/me/register',
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'Content-Length': Buffer.byteLength(data),
-            },
-        };
-
-        const req = https.request(options, (res) => {
-            let body = '';
-            res.on('data', (chunk) => body += chunk);
-            res.on('end', () => {
-                try {
-                    const result = JSON.parse(body);
-                    resolve(result.license || null);
-                } catch (e) {
-                    resolve(null);
-                }
-            });
-        });
-
-        req.on('error', () => resolve(null));
-        req.write(data);
-        req.end();
-    });
-}
-
-async function main() {
-    console.log('');
-    console.log('');
-    console.log('  Welcome to Jspreadsheet');
-    console.log('');
-    console.log('  The JavaScript data grid component for building');
-    console.log('  enterprise-grade spreadsheet applications.');
-    console.log('');
-    console.log('');
-
-    // Step 1: Choose distribution
-    const { distribution } = await prompts({
-        type: 'select',
-        name: 'distribution',
-        message: 'Which edition would you like to install?',
-        choices: [
-            {
-                title: `Pro \x1b[0m\x1b[90m\u2014 Full-featured commercial spreadsheet\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m 500+ Excel-compatible formulas\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m XLSX, CSV & clipboard import/export\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m AI integration & real-time collaboration\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m Toolbar, context menu & 30+ plugins\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m Persistence, history & cross-sheet references\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m Priority support & regular updates\x1b[0m\n` +
-                    `     \x1b[90mFree on localhost or 30-day free trial for production\x1b[0m`,
-                value: 'pro',
-            },
-            {
-                title: `CE \x1b[0m\x1b[90m\u2014 Community Edition (MIT license)\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m Core spreadsheet rendering & editing\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m Basic formulas (SUM, AVG, etc.)\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m CSV import/export\x1b[0m\n` +
-                    `     \x1b[32m\u2713\x1b[0m\x1b[37m Fully open-source, no watermark\x1b[0m\n` +
-                    `     \x1b[90mCommunity support via GitHub issues\x1b[0m`,
-                value: 'ce',
-            },
-        ],
-    });
-
-    if (!distribution) {
-        console.log('\nSetup cancelled.');
-        process.exit(0);
-    }
-
-    console.log('');
-
-    // Step 2: Choose framework
-    const { framework } = await prompts({
-        type: 'select',
-        name: 'framework',
-        message: 'Select your framework',
-        choices: [
-            { title: 'React', value: 'react' },
-            { title: 'Vue', value: 'vue' },
-            { title: 'Angular', value: 'angular' },
-            { title: 'Vanilla JavaScript', value: 'vanilla' },
-            { title: 'Other', value: 'vanilla' },
-        ],
-    });
-
-    if (!framework) {
-        console.log('\nSetup cancelled.');
-        process.exit(0);
-    }
-
-    const pkg = PACKAGES[distribution][framework];
-
-    // Step 3: Pro-specific registration flow
-    let license = null;
-
-    if (distribution === 'pro') {
-        console.log('');
-        const { support } = await prompts({
-            type: 'select',
-            name: 'support',
-            message: 'Get free dedicated technical support for 30 days?',
-            choices: [
-                {
-                    title: 'Yes, register with my email',
-                    description: 'Receive a license key and priority support from the Jspreadsheet team.',
-                    value: 'register',
-                },
-                {
-                    title: 'No thanks, start evaluation without registration',
-                    description: 'You can register anytime later.',
-                    value: 'skip',
-                },
-            ],
-        });
-
-        if (!support) {
-            console.log('\nSetup cancelled.');
-            process.exit(0);
-        }
-
-        if (support === 'register') {
-            const { email } = await prompts({
-                type: 'text',
-                name: 'email',
-                message: 'Your email',
-                validate: (value) => {
-                    if (!value) {
-                        return 'Email is required';
-                    }
-                    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) {
-                        return 'Please enter a valid email address';
-                    }
-                    return true;
-                },
-            });
-
-            if (!email) {
-                console.log('\nSetup cancelled.');
-                process.exit(0);
-            }
-
-            console.log('\n  Registering...');
-            license = await registerEmail(email);
-
-            if (license) {
-                console.log('  Done! Your license key has been generated.\n');
-            } else {
-                console.log('  Could not register at this time. You can register later at:');
-                console.log('  https://jspreadsheet.com/me\n');
-                console.log('  Continuing with evaluation mode.\n');
-            }
-        }
-    }
-
-    // Step 4: Install the package
-    const cmd = getInstallCommand(pkg);
-    console.log('');
-    console.log(`  Installing ${pkg}...`);
-    console.log(`  > ${cmd}`);
-    console.log('');
-
-    try {
-        execSync(cmd, { stdio: 'inherit' });
-    } catch (e) {
-        console.error(`\n  Installation failed. Try running manually:`);
-        console.error(`  ${cmd}\n`);
-        process.exit(1);
-    }
-
-    // Step 5: Show post-install summary
-    const isPro = distribution === 'pro';
-    const mainPkg = isPro ? 'jspreadsheet' : 'jspreadsheet-ce';
-
-    console.log('');
-    console.log('');
-
-    if (isPro) {
-        console.log(`  \x1b[32m\u2713\x1b[0m Jspreadsheet Pro installed`);
-        console.log('');
-        console.log(`    Edition:      Pro`);
-        if (license) {
-            console.log(`    License:      ${license}`);
-        } else {
-            console.log(`    Mode:         evaluation (free on localhost)`);
-            console.log(`    Time limit:   none on localhost`);
-        }
-        console.log('');
-        console.log('');
-        console.log('  Getting started:');
-        console.log('');
-
-        if (framework === 'react') {
-            console.log(`    import { Spreadsheet, Worksheet } from '@jspreadsheet/react';`);
-            console.log(`    import jspreadsheet from '${mainPkg}';`);
-            console.log('');
-            console.log(`    jspreadsheet.setLicense('${license || 'evaluation'}');`);
-        } else if (framework === 'vue') {
-            console.log(`    import { Spreadsheet, Worksheet } from '@jspreadsheet/vue';`);
-            console.log(`    import jspreadsheet from '${mainPkg}';`);
-            console.log('');
-            console.log(`    jspreadsheet.setLicense('${license || 'evaluation'}');`);
-        } else {
-            console.log(`    import jspreadsheet from '${mainPkg}';`);
-            console.log('');
-            console.log(`    jspreadsheet.setLicense('${license || 'evaluation'}');`);
-        }
-
-        console.log('');
-        console.log('');
-        console.log('  Next steps:');
-        console.log(`    \u2192 Start building:    npm run dev`);
-        console.log(`    \u2192 Docs:             https://jspreadsheet.com/docs`);
-        if (!license) {
-            console.log(`    \u2192 Get a license:    https://jspreadsheet.com/me`);
-        }
-        console.log(`    \u2192 Pricing:          https://jspreadsheet.com/pricing`);
-    } else {
-        console.log(`  \x1b[32m\u2713\x1b[0m Jspreadsheet CE installed`);
-        console.log('');
-        console.log(`    Edition:      Community (MIT license)`);
-        console.log('');
-        console.log('');
-        console.log('  Getting started:');
-        console.log('');
-
-        if (framework === 'react') {
-            console.log(`    import { Spreadsheet, Worksheet } from '@jspreadsheet-ce/react';`);
-        } else if (framework === 'vue') {
-            console.log(`    import { Spreadsheet, Worksheet } from '@jspreadsheet-ce/vue';`);
-        } else {
-            console.log(`    import jspreadsheet from '${mainPkg}';`);
-        }
-
-        console.log('');
-        console.log('');
-        console.log('  Next steps:');
-        console.log(`    \u2192 Start building:    npm run dev`);
-        console.log(`    \u2192 Docs:             https://bossanova.uk/jspreadsheet/docs`);
-        console.log('');
-        console.log('  Need advanced formulas, file import/export, or more features?');
-        console.log('  Try Jspreadsheet Pro: https://jspreadsheet.com');
-    }
-
-    console.log('');
-    console.log('');
-}
-
-main().catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
+#!/usr/bin/env node
+
+const { select, input, Separator } = require('@inquirer/prompts');
+const { execSync } = require('child_process');
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+// Colors — use yoctocolors-cjs (transitive dep of @inquirer)
+let c;
+try {
+    c = require('yoctocolors-cjs');
+} catch {
+    const esc = (code) => (s) => `\x1b[${code[0]}m${s}\x1b[${code[1]}m`;
+    c = {
+        bold: esc([1, 22]), dim: esc([2, 22]), italic: esc([3, 23]),
+        green: esc([32, 39]), red: esc([31, 39]), yellow: esc([33, 39]),
+        blue: esc([34, 39]), cyan: esc([36, 39]), gray: esc([90, 39]),
+        magenta: esc([35, 39]),
+    };
+}
+
+// ─── Constants ───────────────────────────────────────────────────────
+
+const PACKAGES = {
+    pro: {
+        vanilla: 'jspreadsheet',
+        react: '@jspreadsheet/react',
+        vue: '@jspreadsheet/vue',
+        angular: 'jspreadsheet',
+    },
+    ce: {
+        vanilla: 'jspreadsheet-ce',
+        react: '@jspreadsheet-ce/react',
+        vue: '@jspreadsheet-ce/vue',
+        angular: 'jspreadsheet-ce',
+    },
+};
+
+const VALID_EDITIONS = ['pro', 'ce'];
+const VALID_FRAMEWORKS = ['react', 'vue', 'angular', 'vanilla'];
+
+// ─── Arg Parsing ─────────────────────────────────────────────────────
+
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const flags = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === '--edition' || arg === '-e') && args[i + 1]) {
+            flags.edition = args[++i].toLowerCase();
+        } else if ((arg === '--framework' || arg === '-f') && args[i + 1]) {
+            flags.framework = args[++i].toLowerCase();
+        } else if (arg === '--email' && args[i + 1]) {
+            flags.email = args[++i];
+        } else if (arg === '--skip-registration' || arg === '--no-register') {
+            flags.skipRegistration = true;
+        } else if (arg === '--dry-run') {
+            flags.dryRun = true;
+        } else if (arg === '--help' || arg === '-h') {
+            flags.help = true;
+        } else if (arg === '--version' || arg === '-v') {
+            flags.version = true;
+        }
+    }
+    return flags;
+}
+
+function printHelp() {
+    console.log('');
+    console.log(`  ${c.bold('Jspreadsheet Installer')}`);
+    console.log('');
+    console.log('  Usage:');
+    console.log(`    ${c.dim('$')} npx @jspreadsheet/install ${c.dim('[options]')}`);
+    console.log('');
+    console.log('  Options:');
+    console.log(`    ${c.cyan('--edition, -e')} ${c.dim('<pro|ce>')}        Edition to install`);
+    console.log(`    ${c.cyan('--framework, -f')} ${c.dim('<name>')}       Framework: react, vue, angular, vanilla`);
+    console.log(`    ${c.cyan('--email')} ${c.dim('<email>')}               Register for free trial (Pro only)`);
+    console.log(`    ${c.cyan('--skip-registration')}            Skip registration prompt (Pro only)`);
+    console.log(`    ${c.cyan('--dry-run')}                      Preview the flow without installing`);
+    console.log(`    ${c.cyan('--version, -v')}                  Show version number`);
+    console.log(`    ${c.cyan('--help, -h')}                     Show this help message`);
+    console.log('');
+    console.log('  Examples:');
+    console.log(`    ${c.dim('$')} npx @jspreadsheet/install --edition pro --framework react`);
+    console.log(`    ${c.dim('$')} npx @jspreadsheet/install -e ce -f vanilla`);
+    console.log(`    ${c.dim('$')} npx @jspreadsheet/install --edition pro --email dev@co.com`);
+    console.log('');
+}
+
+// ─── Display Helpers ─────────────────────────────────────────────────
+
+function printBanner() {
+    console.log('');
+    console.log(`  ${c.cyan('┌')}  ${c.bold('Jspreadsheet Installer')}`);
+    console.log(`  ${c.cyan('│')}`);
+    console.log(`  ${c.cyan('│')}  The JavaScript data grid for building`);
+    console.log(`  ${c.cyan('│')}  enterprise-grade spreadsheet applications.`);
+    console.log(`  ${c.cyan('└')}`);
+    console.log('');
+}
+
+function printFeatureComparison() {
+    const W = 52;
+    const b = c.gray('│');
+    const strip = (s) => s.replace(/\x1b\[[0-9;]*m/g, '');
+    const row = (content) => {
+        const visible = strip(content).length;
+        const pad = Math.max(0, W - visible);
+        return `  ${b}${content}${' '.repeat(pad)}${b}`;
+    };
+
+    const lines = [
+        c.gray(`  ┌${'─'.repeat(W)}┐`),
+        row(''),
+        row(`  ${c.bold('Pro')} ${c.dim('— Full-featured commercial spreadsheet')}`),
+        row(`  ${c.green('✓')} 500+ Excel-compatible formulas`),
+        row(`  ${c.green('✓')} XLSX, CSV & clipboard import/export`),
+        row(`  ${c.green('✓')} AI integration & real-time collaboration`),
+        row(`  ${c.green('✓')} Toolbar, context menu & 30+ plugins`),
+        row(`  ${c.green('✓')} Persistence, history & cross-sheet refs`),
+        row(`  ${c.green('✓')} Priority support & regular updates`),
+        row(`  ${c.dim('Free on localhost · 30-day free trial')}`),
+        row(''),
+        row(`  ${c.bold('CE')} ${c.dim('— Community Edition (MIT license)')}`),
+        row(`  ${c.green('✓')} Core spreadsheet rendering & editing`),
+        row(`  ${c.green('✓')} Basic formulas (SUM, AVG, etc.)`),
+        row(`  ${c.green('✓')} CSV import/export`),
+        row(`  ${c.green('✓')} Fully open-source, no watermark`),
+        row(`  ${c.dim('Community support via GitHub issues')}`),
+        row(''),
+        c.gray(`  └${'─'.repeat(W)}┘`),
+    ];
+
+    for (const line of lines) {
+        console.log(line);
+    }
+    console.log('');
+}
+
+function printSummary(edition, framework, license, dryRun) {
+    const isPro = edition === 'pro';
+    const mainPkg = isPro ? 'jspreadsheet' : 'jspreadsheet-ce';
+
+    console.log('');
+    const label = dryRun ? 'ready to install' : 'installed';
+    console.log(`  ${c.green('◇')}  ${isPro ? 'Jspreadsheet Pro' : 'Jspreadsheet CE'} ${label}`);
+    console.log(`  ${c.dim('│')}`);
+    console.log(`  ${c.dim('│')}  Edition:   ${c.bold(isPro ? 'Pro' : 'Community (MIT)')}`);
+
+    if (isPro) {
+        if (license) {
+            console.log(`  ${c.dim('│')}  License:   ${c.green(license)}`);
+        } else {
+            console.log(`  ${c.dim('│')}  Mode:      ${c.dim('evaluation — free on localhost')}`);
+        }
+    }
+
+    console.log(`  ${c.dim('│')}`);
+    console.log(`  ${c.dim('│')}  ${c.bold('Getting started:')}`);
+    console.log(`  ${c.dim('│')}`);
+
+    if (isPro) {
+        if (framework === 'react') {
+            console.log(`  ${c.dim('│')}  ${c.cyan("import { Spreadsheet, Worksheet } from '@jspreadsheet/react';")}`);
+            console.log(`  ${c.dim('│')}  ${c.cyan(`import jspreadsheet from '${mainPkg}';`)}`);
+            console.log(`  ${c.dim('│')}`);
+            console.log(`  ${c.dim('│')}  ${c.cyan(`jspreadsheet.setLicense('${license || 'evaluation'}');`)}`);
+        } else if (framework === 'vue') {
+            console.log(`  ${c.dim('│')}  ${c.cyan("import { Spreadsheet, Worksheet } from '@jspreadsheet/vue';")}`);
+            console.log(`  ${c.dim('│')}  ${c.cyan(`import jspreadsheet from '${mainPkg}';`)}`);
+            console.log(`  ${c.dim('│')}`);
+            console.log(`  ${c.dim('│')}  ${c.cyan(`jspreadsheet.setLicense('${license || 'evaluation'}');`)}`);
+        } else if (framework === 'angular') {
+            console.log(`  ${c.dim('│')}  ${c.cyan(`import jspreadsheet from '${mainPkg}';`)}`);
+            console.log(`  ${c.dim('│')}`);
+            console.log(`  ${c.dim('│')}  ${c.cyan(`jspreadsheet.setLicense('${license || 'evaluation'}');`)}`);
+            console.log(`  ${c.dim('│')}  ${c.cyan(`jspreadsheet(divRef, { worksheets: [{ minDimensions: [10, 10] }] });`)}`);
+            console.log(`  ${c.dim('│')}`);
+            console.log(`  ${c.dim('│')}  ${c.dim('Use CUSTOM_ELEMENTS_SCHEMA or call jspreadsheet in ngAfterViewInit')}`);
+        } else {
+            console.log(`  ${c.dim('│')}  ${c.cyan(`import jspreadsheet from '${mainPkg}';`)}`);
+            console.log(`  ${c.dim('│')}`);
+            console.log(`  ${c.dim('│')}  ${c.cyan(`jspreadsheet.setLicense('${license || 'evaluation'}');`)}`);
+        }
+    } else {
+        if (framework === 'react') {
+            console.log(`  ${c.dim('│')}  ${c.cyan("import { Spreadsheet, Worksheet } from '@jspreadsheet-ce/react';")}`);
+        } else if (framework === 'vue') {
+            console.log(`  ${c.dim('│')}  ${c.cyan("import { Spreadsheet, Worksheet } from '@jspreadsheet-ce/vue';")}`);
+        } else if (framework === 'angular') {
+            console.log(`  ${c.dim('│')}  ${c.cyan(`import jspreadsheet from '${mainPkg}';`)}`);
+            console.log(`  ${c.dim('│')}`);
+            console.log(`  ${c.dim('│')}  ${c.cyan(`jspreadsheet(divRef, { worksheets: [{ minDimensions: [10, 10] }] });`)}`);
+            console.log(`  ${c.dim('│')}`);
+            console.log(`  ${c.dim('│')}  ${c.dim('Use CUSTOM_ELEMENTS_SCHEMA or call jspreadsheet in ngAfterViewInit')}`);
+        } else {
+            console.log(`  ${c.dim('│')}  ${c.cyan(`import jspreadsheet from '${mainPkg}';`)}`);
+        }
+    }
+
+    console.log(`  ${c.dim('│')}`);
+    console.log(`  ${c.dim('│')}  ${c.bold('Next steps:')}`);
+    console.log(`  ${c.dim('│')}  → Start building:  ${c.blue('npm run dev')}`);
+
+    if (isPro) {
+        console.log(`  ${c.dim('│')}  → Docs:            ${c.blue('https://jspreadsheet.com/docs')}`);
+        if (!license) {
+            console.log(`  ${c.dim('│')}  → Get a license:   ${c.blue('https://jspreadsheet.com/me')}`);
+        }
+        console.log(`  ${c.dim('│')}  → Pricing:         ${c.blue('https://jspreadsheet.com/pricing')}`);
+    } else {
+        console.log(`  ${c.dim('│')}  → Docs:            ${c.blue('https://bossanova.uk/jspreadsheet/docs')}`);
+        console.log(`  ${c.dim('│')}`);
+        console.log(`  ${c.dim('│')}  Need advanced formulas, import/export, or more?`);
+        console.log(`  ${c.dim('│')}  Try ${c.bold('Jspreadsheet Pro')}: ${c.blue('https://jspreadsheet.com')}`);
+    }
+
+    console.log(`  ${c.dim('│')}`);
+    console.log(`  ${c.dim('└')}  Happy building!`);
+    console.log('');
+}
+
+// ─── Utilities ───────────────────────────────────────────────────────
+
+function detectPackageManager() {
+    const cwd = process.cwd();
+    if (fs.existsSync(path.join(cwd, 'yarn.lock'))) return 'yarn';
+    if (fs.existsSync(path.join(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
+    if (fs.existsSync(path.join(cwd, 'bun.lockb'))) return 'bun';
+    return 'npm';
+}
+
+function getInstallCommand(pkg) {
+    const pm = detectPackageManager();
+    if (pm === 'yarn') return `yarn add ${pkg}`;
+    if (pm === 'pnpm') return `pnpm add ${pkg}`;
+    if (pm === 'bun') return `bun add ${pkg}`;
+    return `npm install ${pkg}`;
+}
+
+function registerEmail(email) {
+    return new Promise((resolve) => {
+        const data = JSON.stringify({ email });
+
+        const options = {
+            hostname: 'jspreadsheet.com',
+            port: 443,
+            path: '/me/register',
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(data),
+            },
+        };
+
+        const req = https.request(options, (res) => {
+            let body = '';
+            res.on('data', (chunk) => body += chunk);
+            res.on('end', () => {
+                try {
+                    const result = JSON.parse(body);
+                    resolve(result.license || null);
+                } catch (e) {
+                    resolve(null);
+                }
+            });
+        });
+
+        req.on('error', () => resolve(null));
+        req.write(data);
+        req.end();
+    });
+}
+
+// ─── Main ────────────────────────────────────────────────────────────
+
+async function main() {
+    const flags = parseArgs();
+
+    // Version
+    if (flags.version) {
+        const { version } = require('./package.json');
+        console.log(version);
+        process.exit(0);
+    }
+
+    // Help
+    if (flags.help) {
+        printHelp();
+        process.exit(0);
+    }
+
+    // Validate flags
+    if (flags.edition && !VALID_EDITIONS.includes(flags.edition)) {
+        console.error(`\n  ${c.red('✗')} Invalid edition: ${flags.edition}`);
+        console.error(`  ${c.dim('Valid options: pro, ce')}\n`);
+        process.exit(1);
+    }
+    if (flags.framework && !VALID_FRAMEWORKS.includes(flags.framework)) {
+        console.error(`\n  ${c.red('✗')} Invalid framework: ${flags.framework}`);
+        console.error(`  ${c.dim('Valid options: react, vue, angular, vanilla')}\n`);
+        process.exit(1);
+    }
+
+    const isInteractive = process.stdin.isTTY && !process.env.CI;
+
+    // Non-interactive with missing required flags
+    if (!isInteractive && !flags.edition) {
+        console.error(`\n  ${c.red('✗')} --edition is required in non-interactive mode`);
+        console.error(`  ${c.dim('Run with --help for usage info')}\n`);
+        process.exit(1);
+    }
+
+    // ── Banner ──
+    printBanner();
+
+    // ── Step 1: Edition ──
+    let edition = flags.edition;
+    if (!edition) {
+        printFeatureComparison();
+        edition = await select({
+            message: 'Which edition would you like to install?',
+            choices: [
+                {
+                    name: `Pro ${c.dim('— Commercial, full-featured')}`,
+                    value: 'pro',
+                    short: 'Pro',
+                },
+                {
+                    name: `CE  ${c.dim('— Community Edition, MIT license')}`,
+                    value: 'ce',
+                    short: 'CE',
+                },
+            ],
+        });
+    }
+
+    // ── Step 2: Framework ──
+    let framework = flags.framework;
+    if (!framework) {
+        if (!isInteractive) {
+            framework = 'vanilla';
+            console.log(`  ${c.dim('No --framework specified, defaulting to vanilla')}`);
+        } else {
+            console.log('');
+            framework = await select({
+                message: 'Select your framework',
+                choices: [
+                    { name: 'React', value: 'react' },
+                    { name: 'Vue', value: 'vue' },
+                    { name: 'Angular', value: 'angular' },
+                    { name: 'Vanilla JavaScript', value: 'vanilla' },
+                    new Separator(),
+                    { name: `Other ${c.dim('(vanilla JS package)')}`, value: 'vanilla' },
+                ],
+            });
+        }
+    }
+
+    const pkg = PACKAGES[edition][framework];
+
+    // ── Step 3: Registration (Pro only) ──
+    let license = null;
+
+    if (edition === 'pro' && !flags.skipRegistration) {
+        if (flags.email) {
+            // Non-interactive registration
+            console.log(`  ${c.dim('Registering')} ${flags.email}${c.dim('...')}`);
+            license = await registerEmail(flags.email);
+            if (license) {
+                console.log(`  ${c.green('✓')} License key generated`);
+            } else {
+                console.log(`  ${c.yellow('!')} Could not register. You can register later at:`);
+                console.log(`  ${c.blue('https://jspreadsheet.com/me')}`);
+            }
+        } else if (isInteractive) {
+            console.log('');
+            const support = await select({
+                message: 'Get a free 30-day trial license for production deployment and support?',
+                choices: [
+                    {
+                        name: `Yes, register with my email`,
+                        value: 'register',
+                        description: 'Get a license key for deployment + priority support',
+                    },
+                    {
+                        name: `No thanks, continue in evaluation mode`,
+                        value: 'skip',
+                        description: 'Free on localhost — register anytime later for production',
+                    },
+                ],
+            });
+
+            if (support === 'register') {
+                console.log('');
+                const email = await input({
+                    message: 'Your email',
+                    required: true,
+                    validate: (value) => {
+                        if (!value) return 'Email is required';
+                        if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) {
+                            return 'Please enter a valid email address';
+                        }
+                        return true;
+                    },
+                });
+
+                console.log(`\n  ${c.dim('Registering...')}`);
+                license = await registerEmail(email);
+
+                if (license) {
+                    console.log(`  ${c.green('✓')} Done! Your license key has been generated.`);
+                } else {
+                    console.log(`  ${c.yellow('!')} Could not register at this time.`);
+                    console.log(`  ${c.dim('You can register later at:')} ${c.blue('https://jspreadsheet.com/me')}`);
+                    console.log(`  ${c.dim('Continuing with evaluation mode.')}`);
+                }
+            }
+        }
+    }
+
+    // ── Step 4: Install ──
+    const cmd = getInstallCommand(pkg);
+
+    console.log('');
+    if (flags.dryRun) {
+        console.log(`  ${c.yellow('●')} Dry run — would install ${c.bold(pkg)}`);
+        console.log(`  ${c.dim('$')} ${c.dim(cmd)}`);
+    } else {
+        console.log(`  ${c.cyan('●')} Installing ${c.bold(pkg)}...`);
+        console.log(`  ${c.dim('$')} ${c.dim(cmd)}`);
+        console.log('');
+
+        try {
+            execSync(cmd, { stdio: 'inherit' });
+        } catch (e) {
+            console.error(`\n  ${c.red('✗')} Installation failed. Try running manually:`);
+            console.error(`  ${c.dim('$')} ${cmd}\n`);
+            process.exit(1);
+        }
+    }
+
+    // ── Step 5: Summary ──
+    printSummary(edition, framework, license, flags.dryRun);
+}
+
+// ─── Entry Point ─────────────────────────────────────────────────────
+
+main().catch((err) => {
+    // Graceful exit on Ctrl+C
+    if (err.name === 'ExitPromptError') {
+        console.log(`\n  ${c.dim('Setup cancelled.')}\n`);
+        process.exit(0);
+    }
+    console.error(err);
+    process.exit(1);
+});

package/package.json

@@ -1,21 +1,23 @@
-{
-  "name": "@jspreadsheet/install",
-  "version": "1.0.1",
-  "description": "Interactive installer for Jspreadsheet",
-  "bin": {
-    "@jspreadsheet/install": "index.js",
-    "jspreadsheet-install": "index.js"
-  },
-  "main": "index.js",
-  "keywords": [
-    "jspreadsheet",
-    "spreadsheet",
-    "installer",
-    "cli"
-  ],
-  "author": "Jspreadsheet",
-  "license": "MIT",
-  "dependencies": {
-    "prompts": "^2.4.2"
-  }
-}
+{
+  "name": "@jspreadsheet/install",
+  "version": "1.1.0",
+  "description": "Interactive installer for Jspreadsheet",
+  "bin": {
+    "@jspreadsheet/install": "index.js",
+    "jspreadsheet-install": "index.js"
+  },
+  "main": "index.js",
+  "keywords": [
+    "jspreadsheet",
+    "spreadsheet",
+    "installer",
+    "cli"
+  ],
+  "author": "Jspreadsheet",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.10.1",
+    "@jspreadsheet-ce/react": "^5.0.2",
+    "@jspreadsheet/vue": "^12.4.2"
+  }
+}