toiljs 0.0.11 → 0.0.12

package/src/cli/index.ts

@@ -1,211 +1,242 @@
-#!/usr/bin/env node
-/**
- * toiljs CLI. Routes `create` / `dev` / `build` and wraps them in the toiljs brand banner.
- * The compiler stays presentation-free (imported via the package's own `toiljs/compiler`
- * export); the epic bits, banner, the Clack scaffolding wizard, live here.
- */
-import { build, dev, start } from 'toiljs/compiler';
-
-import { runConfigure } from './configure.js';
-import { runCreate, type Template } from './create.js';
-import { PREPROCESSORS, type Preprocessor } from './features.js';
-import { accent, banner, bold, danger, dim, success, version } from './ui.js';
-
-interface Flags {
-    root?: string;
-    port?: number;
-    name?: string;
-    template?: Template;
-    preprocessor?: Preprocessor;
-    tailwind?: boolean;
-    ai?: boolean;
-    images?: boolean;
-    install?: boolean;
-    git?: boolean;
-    pm?: string;
-    yes?: boolean;
-}
-
-function parseArgs(argv: string[]): Flags {
-    const flags: Flags = {};
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        switch (arg) {
-            case '--root':
-                flags.root = argv[++i];
-                break;
-            case '--port': {
-                const port = Number(argv[++i]);
-                if (!Number.isNaN(port)) flags.port = port;
-                break;
-            }
-            case '--template':
-            case '-t': {
-                const t = argv[++i];
-                if (t === 'app' || t === 'minimal') flags.template = t;
-                break;
-            }
-            case '--pm':
-                flags.pm = argv[++i];
-                break;
-            case '--style': {
-                const s = argv[++i];
-                if ((PREPROCESSORS as readonly string[]).includes(s)) flags.preprocessor = s as Preprocessor;
-                break;
-            }
-            case '--tailwind':
-                flags.tailwind = true;
-                break;
-            case '--no-tailwind':
-                flags.tailwind = false;
-                break;
-            case '--ai':
-                flags.ai = true;
-                break;
-            case '--no-ai':
-                flags.ai = false;
-                break;
-            case '--images':
-                flags.images = true;
-                break;
-            case '--no-images':
-                flags.images = false;
-                break;
-            case '--install':
-                flags.install = true;
-                break;
-            case '--no-install':
-                flags.install = false;
-                break;
-            case '--git':
-                flags.git = true;
-                break;
-            case '--no-git':
-                flags.git = false;
-                break;
-            case '-y':
-            case '--yes':
-                flags.yes = true;
-                break;
-            default:
-                if (!arg.startsWith('-') && flags.name === undefined) flags.name = arg;
-        }
-    }
-    return flags;
-}
-
-function printHelp(): void {
-    const cmd = (name: string, desc: string): string => `  ${accent(name.padEnd(15))}${dim(desc)}`;
-    process.stdout.write(
-        [
-            `${bold('Usage')}  ${dim('toiljs')} <command> [options]`,
-            '',
-            bold('Commands'),
-            cmd('create [name]', 'scaffold a new toiljs app'),
-            cmd('configure', 'toggle styling features (Sass/Less/Stylus, Tailwind)'),
-            cmd('dev', 'start the dev server with HMR'),
-            cmd('build', 'build the optimized production bundle'),
-            cmd('start', 'self-host the built app (hyper-express / uWS)'),
-            '',
-            bold('Options'),
-            cmd('--root <dir>', 'project root (default: current directory)'),
-            cmd('--port <n>', 'dev server port'),
-            cmd('-t, --template', 'create: app | minimal'),
-            cmd('--style <name>', 'create/configure: css | sass | less | stylus'),
-            cmd('--tailwind', 'create/configure: enable Tailwind (--no-tailwind to remove)'),
-            cmd('--no-ai', 'create: skip AI assistant files (CLAUDE.md, etc.)'),
-            cmd('-y, --yes', 'create: accept defaults (non-interactive)'),
-            cmd('--no-install', "create: don't install dependencies"),
-            cmd('-v, --version', 'print the toiljs version'),
-            '',
-        ].join('\n') + '\n',
-    );
-}
-
-async function main(): Promise<void> {
-    const [command, ...rest] = process.argv.slice(2);
-
-    if (command === '--version' || command === '-v') {
-        process.stdout.write(version() + '\n');
-        return;
-    }
-
-    const flags = parseArgs(rest);
-
-    switch (command) {
-        case 'create':
-            banner();
-            await runCreate({
-                name: flags.name,
-                template: flags.template,
-                preprocessor: flags.preprocessor,
-                tailwind: flags.tailwind,
-                ai: flags.ai,
-                images: flags.images,
-                install: flags.install,
-                git: flags.git,
-                pm: flags.pm,
-                yes: flags.yes,
-                cwd: process.cwd(),
-            });
-            break;
-
-        case 'configure':
-            banner();
-            await runConfigure({
-                root: flags.root,
-                preprocessor: flags.preprocessor,
-                tailwind: flags.tailwind,
-                images: flags.images,
-                install: flags.install,
-                cwd: process.cwd(),
-            });
-            break;
-
-        case 'dev':
-            banner();
-            process.stdout.write(dim('  starting dev server…') + '\n\n');
-            await dev({ root: flags.root, port: flags.port });
-            break;
-
-        case 'build':
-            banner();
-            process.stdout.write(dim('  building for production…') + '\n\n');
-            await build({ root: flags.root });
-            process.stdout.write('\n' + success('  ✓ ') + bold('build complete') + '\n\n');
-            break;
-
-        case 'start': {
-            banner();
-            process.stdout.write(dim('  self-hosting the built app…') + '\n\n');
-            const server = await start({ root: flags.root, port: flags.port });
-            process.stdout.write(
-                accent('  ➜ ') +
-                    bold(`http://localhost:${String(server.port)}`) +
-                    dim(`   ws channel: ${server.wsPath}`) +
-                    '\n\n',
-            );
-            break;
-        }
-
-        case 'help':
-        case '--help':
-        case '-h':
-        case undefined:
-            banner();
-            printHelp();
-            break;
-
-        default:
-            banner();
-            process.stdout.write(dim(`  unknown command: ${command}`) + '\n\n');
-            printHelp();
-            process.exitCode = 1;
-    }
-}
-
-main().catch((err: unknown) => {
-    const message = err instanceof Error ? err.message : String(err);
-    process.stderr.write('\n' + danger('  ✗ ') + message + '\n');
-    process.exitCode = 1;
-});
+#!/usr/bin/env node
+/**
+ * toiljs CLI. Routes `create` / `dev` / `build` and wraps them in the toiljs brand banner.
+ * The compiler stays presentation-free (imported via the package's own `toiljs/compiler`
+ * export); the epic bits, banner, the Clack scaffolding wizard, live here.
+ */
+import { build, dev, start } from 'toiljs/compiler';
+
+import { runConfigure } from './configure.js';
+import { runCreate, type Template } from './create.js';
+import { runDoctor } from './doctor.js';
+import { runUpdate } from './update.js';
+import { type Preprocessor, PREPROCESSORS } from './features.js';
+import { accent, banner, bold, danger, dim, success, version } from './ui.js';
+
+interface Flags {
+    root?: string;
+    port?: number;
+    name?: string;
+    template?: Template;
+    preprocessor?: Preprocessor;
+    tailwind?: boolean;
+    ai?: boolean;
+    images?: boolean;
+    install?: boolean;
+    git?: boolean;
+    pm?: string;
+    yes?: boolean;
+    json?: boolean;
+    target?: string;
+}
+
+function parseArgs(argv: string[]): Flags {
+    const flags: Flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--root':
+                flags.root = argv[++i];
+                break;
+            case '--port': {
+                const port = Number(argv[++i]);
+                if (!Number.isNaN(port)) flags.port = port;
+                break;
+            }
+            case '--template':
+            case '-t': {
+                const t = argv[++i];
+                if (t === 'app' || t === 'minimal') flags.template = t;
+                break;
+            }
+            case '--pm':
+                flags.pm = argv[++i];
+                break;
+            case '--style': {
+                const s = argv[++i];
+                if ((PREPROCESSORS as readonly string[]).includes(s))
+                    flags.preprocessor = s as Preprocessor;
+                break;
+            }
+            case '--tailwind':
+                flags.tailwind = true;
+                break;
+            case '--no-tailwind':
+                flags.tailwind = false;
+                break;
+            case '--ai':
+                flags.ai = true;
+                break;
+            case '--no-ai':
+                flags.ai = false;
+                break;
+            case '--images':
+                flags.images = true;
+                break;
+            case '--no-images':
+                flags.images = false;
+                break;
+            case '--install':
+                flags.install = true;
+                break;
+            case '--no-install':
+                flags.install = false;
+                break;
+            case '--git':
+                flags.git = true;
+                break;
+            case '--no-git':
+                flags.git = false;
+                break;
+            case '-y':
+            case '--yes':
+                flags.yes = true;
+                break;
+            case '--json':
+                flags.json = true;
+                break;
+            case '--target':
+                flags.target = argv[++i];
+                break;
+            default:
+                if (!arg.startsWith('-') && flags.name === undefined) flags.name = arg;
+        }
+    }
+    return flags;
+}
+
+function printHelp(): void {
+    const cmd = (name: string, desc: string): string => `  ${accent(name.padEnd(15))}${dim(desc)}`;
+    process.stdout.write(
+        [
+            `${bold('Usage')}  ${dim('toiljs')} <command> [options]`,
+            '',
+            bold('Commands'),
+            cmd('create [name]', 'scaffold a new toiljs app'),
+            cmd('configure', 'toggle styling features (Sass/Less/Stylus, Tailwind)'),
+            cmd('dev', 'start the dev server with HMR'),
+            cmd('build', 'build the optimized production bundle'),
+            cmd('start', 'self-host the built app (hyper-express / uWS)'),
+            cmd('doctor', 'diagnose project setup and dependencies'),
+            cmd('update', 'check for and apply dependency updates'),
+            '',
+            bold('Options'),
+            cmd('--root <dir>', 'project root (default: current directory)'),
+            cmd('--port <n>', 'dev server port'),
+            cmd('-t, --template', 'create: app | minimal'),
+            cmd('--style <name>', 'create/configure: css | sass | less | stylus'),
+            cmd('--tailwind', 'create/configure: enable Tailwind (--no-tailwind to remove)'),
+            cmd('--no-ai', 'create: skip AI assistant files (CLAUDE.md, etc.)'),
+            cmd('-y, --yes', 'create: accept defaults (non-interactive)'),
+            cmd('--no-install', "create: don't install dependencies"),
+            cmd('--json', 'doctor: machine-readable output'),
+            cmd('--target <t>', 'update: latest | minor | patch | newest | greatest'),
+            cmd('-v, --version', 'print the toiljs version'),
+            '',
+        ].join('\n') + '\n',
+    );
+}
+
+async function main(): Promise<void> {
+    const [command, ...rest] = process.argv.slice(2);
+
+    if (command === '--version' || command === '-v') {
+        process.stdout.write(version() + '\n');
+        return;
+    }
+
+    const flags = parseArgs(rest);
+
+    switch (command) {
+        case 'create':
+            banner();
+            await runCreate({
+                name: flags.name,
+                template: flags.template,
+                preprocessor: flags.preprocessor,
+                tailwind: flags.tailwind,
+                ai: flags.ai,
+                images: flags.images,
+                install: flags.install,
+                git: flags.git,
+                pm: flags.pm,
+                yes: flags.yes,
+                cwd: process.cwd(),
+            });
+            break;
+
+        case 'configure':
+            banner();
+            await runConfigure({
+                root: flags.root,
+                preprocessor: flags.preprocessor,
+                tailwind: flags.tailwind,
+                images: flags.images,
+                install: flags.install,
+                cwd: process.cwd(),
+            });
+            break;
+
+        case 'dev':
+            banner();
+            process.stdout.write(dim('  starting dev server…') + '\n\n');
+            await dev({ root: flags.root, port: flags.port });
+            break;
+
+        case 'build':
+            banner();
+            process.stdout.write(dim('  building for production…') + '\n\n');
+            await build({ root: flags.root });
+            process.stdout.write('\n' + success('  ✓ ') + bold('build complete') + '\n\n');
+            break;
+
+        case 'start': {
+            banner();
+            process.stdout.write(dim('  self-hosting the built app…') + '\n\n');
+            const server = await start({ root: flags.root, port: flags.port });
+            process.stdout.write(
+                accent('  ➜ ') +
+                    bold(`http://localhost:${String(server.port)}`) +
+                    dim(`   ws channel: ${server.wsPath}`) +
+                    '\n\n',
+            );
+            break;
+        }
+
+        case 'doctor':
+            // Skip the banner for --json so stdout stays valid JSON.
+            if (!flags.json) banner();
+            await runDoctor({ root: flags.root, cwd: process.cwd(), json: flags.json });
+            break;
+
+        case 'update':
+            banner();
+            await runUpdate({
+                root: flags.root,
+                cwd: process.cwd(),
+                yes: flags.yes,
+                target: flags.target,
+            });
+            break;
+
+        case 'help':
+        case '--help':
+        case '-h':
+        case undefined:
+            banner();
+            printHelp();
+            break;
+
+        default:
+            banner();
+            process.stdout.write(dim(`  unknown command: ${command}`) + '\n\n');
+            printHelp();
+            process.exitCode = 1;
+    }
+}
+
+main().catch((err: unknown) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write('\n' + danger('  ✗ ') + message + '\n');
+    process.exitCode = 1;
+});

package/src/cli/proc.ts

@@ -18,3 +18,33 @@ export function run(cmd: string, args: string[], cwd: string): Promise<void> {
         );
     });
 }
+
+/**
+ * Like {@link run}, but captures stdout/stderr and resolves with them plus the exit code (it never
+ * rejects on a non-zero exit, the caller decides). Used to read JSON from tools like
+ * `npm-check-updates`. Same Windows shell handling as {@link run}; args are fixed/allowlisted.
+ */
+export function capture(
+    cmd: string,
+    args: string[],
+    cwd: string,
+): Promise<{ stdout: string; stderr: string; code: number }> {
+    return new Promise((resolve, reject) => {
+        const onWindows = process.platform === 'win32';
+        const child = onWindows
+            ? spawn([cmd, ...args].join(' '), { cwd, shell: true })
+            : spawn(cmd, args, { cwd });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (d: Buffer) => {
+            stdout += d.toString();
+        });
+        child.stderr?.on('data', (d: Buffer) => {
+            stderr += d.toString();
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            resolve({ stdout, stderr, code: code ?? 1 });
+        });
+    });
+}