toiljs 0.0.4 → 0.0.5

package/build/cli/create.js

@@ -1,23 +1,33 @@
-import { spawn } from 'node:child_process';
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { intro, outro, text, select, confirm, isCancel, cancel, spinner, note } from '@clack/prompts';
-import { TOIL_ENV_DTS } from 'toiljs/compiler';
+import { intro, outro, text, select, multiselect, confirm, isCancel, cancel, spinner, note, } from '@clack/prompts';
+import { AI_HELPERS, AI_HELPER_IDS, aiHelperFiles, TOIL_DOCS, TOIL_ENV_DTS } from 'toiljs/compiler';
 import pc from 'picocolors';
+import { PKG_VERSION, PREPROCESSORS, requiredPackages, styleEntry, styleImportLines, TAILWIND_CSS, TAILWIND_ENTRY, } from './features.js';
+import { run } from './proc.js';
 import { accent, dim, version } from './ui.js';
+import { isPackageManager, isValidName, resolveProjectDir } from './validate.js';
+const PREPROCESSOR_LABEL = {
+    css: 'Plain CSS',
+    sass: 'Sass (SCSS)',
+    less: 'Less',
+    stylus: 'Stylus',
+};
+const DEFAULT_STYLE_CONTENT = ':root {\n    color-scheme: dark;\n}\n\n' +
+    'body {\n    margin: 0;\n    background: #080d11;\n    color: #f5f6fa;\n' +
+    '    font-family: system-ui, -apple-system, sans-serif;\n    line-height: 1.6;\n}\n\n' +
+    'a {\n    color: #2563ff;\n    text-decoration: none;\n}\n\n' +
+    'a:hover {\n    color: #22e3ab;\n}\n\n' +
+    'code {\n    background: #11161f;\n    color: #22e3ab;\n    padding: 0.1rem 0.4rem;\n' +
+    '    border-radius: 4px;\n    font-size: 0.9em;\n}\n\n' +
+    'h1 {\n    background: linear-gradient(90deg, #2563ff, #7c3aed, #22e3ab);\n' +
+    '    -webkit-background-clip: text;\n    background-clip: text;\n    color: transparent;\n}\n';
 function bail(value) {
     if (isCancel(value)) {
         cancel('Scaffolding cancelled.');
         process.exit(0);
     }
 }
-function isValidName(name) {
-    if (!name.trim())
-        return 'Please enter a project name.';
-    if (!/^[a-z0-9._@/-]+$/i.test(name))
-        return 'Use letters, numbers, dashes, dots or slashes.';
-    return true;
-}
 async function isEmptyDir(dir) {
     try {
         const entries = await fs.readdir(dir);
@@ -27,59 +37,128 @@ async function isEmptyDir(dir) {
         return true;
     }
 }
-function scaffold(name, template) {
+function scaffold(name, template, features, aiTools) {
     const toilVersion = version();
+    const devDependencies = {
+        '@types/react': '^19.2.15',
+        '@types/react-dom': '^19.2.3',
+        eslint: '^10.2.0',
+        prettier: '^3.8.1',
+        toilscript: '^0.1.2',
+        typescript: '^6.0.3',
+    };
+    for (const dep of requiredPackages(features).sort()) {
+        devDependencies[dep] = PKG_VERSION[dep] ?? 'latest';
+    }
     const pkg = {
         name: path.basename(name),
         private: true,
         type: 'module',
         scripts: {
             dev: 'toiljs dev',
-            build: 'toiljs build',
+            build: 'toiljs build && toilscript --target release',
+            'build:client': 'toiljs build',
+            'build:server': 'toilscript --target release',
             lint: 'eslint client',
             typecheck: 'tsc --noEmit',
-            format: 'prettier --write "client/**/*.{ts,tsx}"',
+            format: 'prettier --write "client/**/*.{ts,tsx,css,scss,less}" "client/public/**/*.html"',
         },
         dependencies: {
             toiljs: `^${toilVersion}`,
             react: '^19.2.6',
             'react-dom': '^19.2.6',
         },
-        devDependencies: {
-            '@types/react': '^19.2.15',
-            '@types/react-dom': '^19.2.3',
-            eslint: '^10.2.0',
-            prettier: '^3.8.1',
-            typescript: '^6.0.3',
-        },
+        devDependencies,
     };
     const files = {
         'package.json': JSON.stringify(pkg, null, 4) + '\n',
         'toil.config.ts': "import { defineConfig } from 'toiljs/compiler';\n\n" +
-            'export default defineConfig({\n    client: {\n        outDir: \'dist\',\n    },\n});\n',
+            'export default defineConfig({});\n',
         'tsconfig.json': '{\n    "extends": "toiljs/tsconfig",\n    "include": ["client", "toil-env.d.ts"]\n}\n',
         'eslint.config.js': "import toiljs from 'toiljs/eslint';\n\nexport default toiljs;\n",
         '.prettierrc': '"toiljs/prettier"\n',
-        '.gitignore': 'node_modules\ndist\n.toil\ntoil-env.d.ts\n',
+        '.gitignore': 'node_modules\nbuild\n.toil\ntoil-env.d.ts\n',
+        'client/public/index.html': '<!doctype html>\n<html lang="en">\n  <head>\n' +
+            '    <meta charset="utf-8" />\n' +
+            '    <meta name="viewport" content="width=device-width, initial-scale=1" />\n' +
+            '    <meta name="theme-color" content="#080D11" />\n' +
+            '    <meta name="description" content="" />\n' +
+            '    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />\n' +
+            '    <link rel="manifest" href="/manifest.webmanifest" />\n' +
+            `    <title>${path.basename(name)}</title>\n` +
+            '  </head>\n  <body>\n    <div id="root"></div>\n  </body>\n</html>\n',
+        'client/public/favicon.svg': '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">\n' +
+            '  <defs>\n' +
+            '    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">\n' +
+            '      <stop offset="0" stop-color="#2563FF" />\n' +
+            '      <stop offset="0.5" stop-color="#7C3AED" />\n' +
+            '      <stop offset="1" stop-color="#22E3AB" />\n' +
+            '    </linearGradient>\n' +
+            '  </defs>\n' +
+            '  <rect width="32" height="32" rx="7" fill="#080D11" />\n' +
+            '  <path d="M9 10h14v3.2h-5.4V24h-3.2V13.2H9z" fill="url(#g)" />\n' +
+            '</svg>\n',
+        'client/public/robots.txt': 'User-agent: *\nAllow: /\n',
+        'client/public/manifest.webmanifest': JSON.stringify({
+            name: path.basename(name),
+            short_name: path.basename(name),
+            start_url: '/',
+            display: 'standalone',
+            background_color: '#080D11',
+            theme_color: '#080D11',
+            icons: [{ src: '/favicon.svg', type: 'image/svg+xml', sizes: 'any' }],
+        }, null, 4) + '\n',
+        'client/public/images/.gitkeep': '# Place images and other static assets here; served at /images/*.\n',
+        'client/toil.tsx': "import { routes, layout, notFound } from 'toiljs/routes';\n\n" +
+            styleImportLines(features).join('\n') +
+            '\n\n' +
+            'Toil.mount(routes, layout, notFound);\n',
+        [`client/${styleEntry(features.preprocessor)}`]: DEFAULT_STYLE_CONTENT,
+        'client/components/.gitkeep': '# Place shared React components here.\n',
         'toil-env.d.ts': TOIL_ENV_DTS,
+        'toilconfig.json': JSON.stringify({
+            entries: ['server/main.ts'],
+            targets: {
+                release: {
+                    outFile: 'build/server/release.wasm',
+                    textFile: 'build/server/release.wat',
+                },
+            },
+            options: {
+                sourceMap: false,
+                optimizeLevel: 3,
+                shrinkLevel: 1,
+                converge: true,
+                noAssert: false,
+                enable: [
+                    'sign-extension',
+                    'mutable-globals',
+                    'nontrapping-f2i',
+                    'bulk-memory',
+                    'simd',
+                    'reference-types',
+                    'multi-value',
+                ],
+                runtime: 'stub',
+                memoryBase: 0,
+                initialMemory: 1,
+                debug: false,
+                trapMode: 'allow',
+            },
+        }, null, 4) + '\n',
+        'server/tsconfig.json': JSON.stringify({
+            extends: 'toilscript/std/assembly.json',
+            include: ['./**/*.ts'],
+        }, null, 4) + '\n',
+        'server/index.ts': 'export function add(a: i32, b: i32): i32 {\n    return a + b;\n}\n',
+        'server/main.ts': "import { add } from './index';\n\n" +
+            '@main\nfunction run(): i32 {\n    return add(40, 2);\n}\n',
         'README.md': ['# ' + path.basename(name), '', 'A [toiljs](https://toil.org) app.', '', '## Develop', '', '    npm install', '    npm run dev', '', '## Build', '', '    npm run build', ''].join('\n'),
         'client/layout.tsx': `import { type ReactNode } from 'react';
 
-import { Link } from 'toiljs/client';
-
-const styles = \`
-  :root { color-scheme: dark; }
-  body { margin: 0; background: #080D11; color: #F5F6FA; font-family: system-ui, -apple-system, sans-serif; line-height: 1.6; }
-  a { color: #2563FF; text-decoration: none; }
-  a:hover { color: #22E3AB; }
-  code { background: #11161f; color: #22E3AB; padding: 0.1rem 0.4rem; border-radius: 4px; font-size: 0.9em; }
-  h1 { background: linear-gradient(90deg, #2563FF, #7C3AED, #22E3AB); -webkit-background-clip: text; background-clip: text; color: transparent; }
-\`;
-
 export default function Layout({ children }: { children?: ReactNode }) {
     return (
         <div style={{ maxWidth: 680, margin: '0 auto', padding: '3rem 1.5rem' }}>
-            <style>{styles}</style>
             <header
                 style={{
                     display: 'flex',
@@ -91,7 +170,7 @@ export default function Layout({ children }: { children?: ReactNode }) {
                 }}>
                 <strong style={{ color: '#2563FF', fontSize: '1.1rem' }}>${path.basename(name)}</strong>
                 <nav style={{ display: 'flex', gap: '1rem' }}>
-                    <Link href="/">home</Link>${template === 'app' ? '\n                    <Link href="/about">about</Link>' : ''}
+                    <Toil.Link href="/">home</Toil.Link>${template === 'app' ? '\n                    <Toil.Link href="/about">about</Toil.Link>' : ''}
                 </nav>
             </header>
             {children}
@@ -99,30 +178,34 @@ export default function Layout({ children }: { children?: ReactNode }) {
     );
 }
 `,
-        'client/routes/index.tsx': "import { Link } from 'toiljs/client';\n\n" +
-            'export default function Home() {\n' +
+        'client/routes/index.tsx': 'export default function Home() {\n' +
             '    return (\n        <main>\n' +
             '            <h1>Welcome to toiljs</h1>\n' +
             '            <p>File-based routing, bundled by Vite, zero config.</p>\n' +
             (template === 'app'
-                ? '            <p>\n                <Link href="/about">About</Link> · <Link href="/blog/42">Blog post 42</Link>\n            </p>\n'
+                ? '            <p>\n                <Toil.Link href="/about">About</Toil.Link> · <Toil.Link href="/blog/42">Blog post 42</Toil.Link>\n            </p>\n'
                 : '') +
             '        </main>\n    );\n}\n',
     };
     if (template === 'app') {
         files['client/routes/about.tsx'] =
-            "import { Link } from 'toiljs/client';\n\n" +
-                'export default function About() {\n' +
+            'export default function About() {\n' +
                 '    return (\n        <main>\n            <h1>About</h1>\n' +
                 '            <p>\n                This page is served by <code>client/routes/about.tsx</code>.\n            </p>\n' +
-                '            <Link href="/">Back home</Link>\n        </main>\n    );\n}\n';
+                '            <Toil.Link href="/">Back home</Toil.Link>\n        </main>\n    );\n}\n';
         files['client/routes/blog/[id].tsx'] =
-            "import { Link, useParams } from 'toiljs/client';\n\n" +
-                'export default function BlogPost() {\n' +
-                '    const { id } = useParams();\n' +
+            'export default function BlogPost() {\n' +
+                '    const { id } = Toil.useParams();\n' +
                 '    return (\n        <main>\n            <h1>Blog post {id}</h1>\n' +
                 '            <p>\n                Dynamic route from <code>client/routes/blog/[id].tsx</code>.\n            </p>\n' +
-                '            <Link href="/">Back home</Link>\n        </main>\n    );\n}\n';
+                '            <Toil.Link href="/">Back home</Toil.Link>\n        </main>\n    );\n}\n';
+    }
+    if (features.tailwind) {
+        files[`client/${TAILWIND_ENTRY}`] = TAILWIND_CSS;
+    }
+    Object.assign(files, aiHelperFiles(aiTools));
+    for (const [name, content] of Object.entries(TOIL_DOCS)) {
+        files[`.toil/docs/${name}`] = content;
     }
     return files;
 }
@@ -133,16 +216,6 @@ async function writeFiles(dir, files) {
         await fs.writeFile(full, contents, 'utf8');
     }
 }
-function run(cmd, args, cwd) {
-    return new Promise((resolve, reject) => {
-        const onWindows = process.platform === 'win32';
-        const child = onWindows
-            ? spawn([cmd, ...args].join(' '), { cwd, stdio: 'ignore', shell: true })
-            : spawn(cmd, args, { cwd, stdio: 'ignore' });
-        child.on('error', reject);
-        child.on('close', (code) => code === 0 ? resolve() : reject(new Error(`${cmd} exited with code ${String(code)}`)));
-    });
-}
 export async function runCreate(opts) {
     intro(accent(' toiljs create '));
     let name = opts.name;
@@ -169,7 +242,11 @@ export async function runCreate(opts) {
         cancel(valid);
         process.exit(1);
     }
-    const targetDir = path.resolve(opts.cwd, name);
+    const targetDir = resolveProjectDir(opts.cwd, name);
+    if (targetDir === null) {
+        cancel('Project name must stay inside the current directory (no "..", no absolute paths).');
+        process.exit(1);
+    }
     const rel = path.relative(opts.cwd, targetDir) || '.';
     if (!(await isEmptyDir(targetDir))) {
         if (opts.yes) {
@@ -196,9 +273,43 @@ export async function runCreate(opts) {
         bail(choice);
         template = choice === 'minimal' ? 'minimal' : 'app';
     }
+    let preprocessor = opts.preprocessor ?? 'css';
+    let tailwind = opts.tailwind ?? false;
+    if (!opts.yes) {
+        if (opts.preprocessor === undefined) {
+            const choice = await select({
+                message: 'Styling',
+                options: PREPROCESSORS.map((value) => ({ value, label: PREPROCESSOR_LABEL[value] })),
+                initialValue: 'css',
+            });
+            bail(choice);
+            preprocessor = choice;
+        }
+        if (opts.tailwind === undefined) {
+            const tw = await confirm({ message: 'Add Tailwind CSS?', initialValue: false });
+            bail(tw);
+            tailwind = tw;
+        }
+    }
+    const features = { preprocessor, tailwind };
+    let aiTools = opts.ai === false ? [] : [...AI_HELPER_IDS];
+    if (opts.ai === undefined && !opts.yes) {
+        const picked = await multiselect({
+            message: 'AI assistant files (read by Claude, Cursor, Codex, Copilot)',
+            options: AI_HELPERS.map((h) => ({ value: h.id, label: h.label })),
+            initialValues: [...AI_HELPER_IDS],
+            required: false,
+        });
+        bail(picked);
+        aiTools = picked;
+    }
     let initGit = opts.git ?? false;
     let install = opts.install ?? false;
     const pm = opts.pm ?? 'npm';
+    if (!isPackageManager(pm)) {
+        cancel(`Unsupported package manager: ${pm} (use npm, pnpm, yarn, or bun).`);
+        process.exit(1);
+    }
     if (!opts.yes) {
         if (opts.git === undefined) {
             const g = await confirm({ message: 'Initialize a git repository?', initialValue: true });
@@ -213,7 +324,7 @@ export async function runCreate(opts) {
     }
     const s = spinner();
     s.start('Scaffolding project');
-    await writeFiles(targetDir, scaffold(name, template));
+    await writeFiles(targetDir, scaffold(name, template, features, aiTools));
     s.stop(`Scaffolded ${pc.cyan(rel)}`);
     if (initGit) {
         const g = spinner();

package/build/cli/features.d.ts

@@ -0,0 +1,23 @@
+export type Preprocessor = 'css' | 'sass' | 'less' | 'stylus';
+export interface StyleFeatures {
+    readonly preprocessor: Preprocessor;
+    readonly tailwind: boolean;
+}
+export declare const PREPROCESSORS: readonly Preprocessor[];
+export declare const STYLE_EXT: Record<Preprocessor, string>;
+export declare const PREPROCESSOR_PKG: Record<Preprocessor, string | null>;
+export declare const TAILWIND_PKGS: readonly string[];
+export declare const PKG_VERSION: Record<string, string>;
+export declare const TAILWIND_ENTRY = "styles/tailwind.css";
+export declare const TAILWIND_CSS = "@import 'tailwindcss';\n";
+export declare function styleEntry(p: Preprocessor): string;
+export declare function preprocessorForExt(ext: string): Preprocessor | null;
+export declare function requiredPackages(f: StyleFeatures): string[];
+export declare function packageDiff(from: StyleFeatures, to: StyleFeatures): {
+    add: string[];
+    remove: string[];
+};
+export declare function styleImportLines(f: StyleFeatures): string[];
+export declare function setStyleImports(source: string, f: StyleFeatures): string;
+export declare function detectPreprocessor(deps: Record<string, string>): Preprocessor;
+export declare function detectTailwind(deps: Record<string, string>): boolean;

package/build/cli/features.js

@@ -0,0 +1,85 @@
+export const PREPROCESSORS = ['css', 'sass', 'less', 'stylus'];
+export const STYLE_EXT = {
+    css: 'css',
+    sass: 'scss',
+    less: 'less',
+    stylus: 'styl',
+};
+export const PREPROCESSOR_PKG = {
+    css: null,
+    sass: 'sass',
+    less: 'less',
+    stylus: 'stylus',
+};
+export const TAILWIND_PKGS = ['tailwindcss', '@tailwindcss/vite'];
+export const PKG_VERSION = {
+    sass: '^1.83.0',
+    less: '^4.2.1',
+    stylus: '^0.64.0',
+    tailwindcss: '^4.0.0',
+    '@tailwindcss/vite': '^4.0.0',
+};
+export const TAILWIND_ENTRY = 'styles/tailwind.css';
+export const TAILWIND_CSS = `@import 'tailwindcss';\n`;
+export function styleEntry(p) {
+    return `styles/main.${STYLE_EXT[p]}`;
+}
+export function preprocessorForExt(ext) {
+    const e = ext.replace(/^\./, '');
+    if (e === 'sass')
+        return 'sass';
+    return PREPROCESSORS.find((p) => STYLE_EXT[p] === e) ?? null;
+}
+export function requiredPackages(f) {
+    const pkgs = [];
+    const pp = PREPROCESSOR_PKG[f.preprocessor];
+    if (pp)
+        pkgs.push(pp);
+    if (f.tailwind)
+        pkgs.push(...TAILWIND_PKGS);
+    return pkgs;
+}
+export function packageDiff(from, to) {
+    const want = new Set(requiredPackages(to));
+    const had = new Set(requiredPackages(from));
+    return {
+        add: [...want].filter((p) => !had.has(p)),
+        remove: [...had].filter((p) => !want.has(p)),
+    };
+}
+export function styleImportLines(f) {
+    const lines = [];
+    if (f.tailwind)
+        lines.push(`import './${TAILWIND_ENTRY}';`);
+    lines.push(`import './${styleEntry(f.preprocessor)}';`);
+    return lines;
+}
+export function setStyleImports(source, f) {
+    const stripped = source.replace(/^[ \t]*import\s+['"]\.\/styles\/[^'"]+['"];?[ \t]*\r?\n/gm, '');
+    const block = styleImportLines(f).join('\n') + '\n';
+    const lines = stripped.split('\n');
+    const routesIdx = lines.findIndex((l) => /from\s+['"]toiljs\/routes['"]/.test(l));
+    let insertAt;
+    if (routesIdx !== -1) {
+        insertAt = routesIdx + 1;
+    }
+    else {
+        const lastImport = lines.reduce((acc, l, i) => (/^\s*import\s/.test(l) ? i : acc), -1);
+        insertAt = lastImport + 1;
+    }
+    const head = lines.slice(0, insertAt).join('\n');
+    const tail = lines.slice(insertAt).join('\n');
+    return `${head}\n\n${block}\n${tail}`.replace(/\n{3,}/g, '\n\n');
+}
+export function detectPreprocessor(deps) {
+    if ('sass' in deps)
+        return 'sass';
+    if ('less' in deps)
+        return 'less';
+    if ('stylus' in deps)
+        return 'stylus';
+    return 'css';
+}
+export function detectTailwind(deps) {
+    return '@tailwindcss/vite' in deps || 'tailwindcss' in deps;
+}

package/build/cli/index.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import { build, dev, start } from 'toiljs/compiler';
+import { runConfigure } from './configure.js';
 import { runCreate } from './create.js';
+import { PREPROCESSORS } from './features.js';
 import { accent, banner, bold, danger, dim, success, version } from './ui.js';
 function parseArgs(argv) {
     const flags = {};
@@ -10,9 +12,12 @@ function parseArgs(argv) {
             case '--root':
                 flags.root = argv[++i];
                 break;
-            case '--port':
-                flags.port = Number(argv[++i]);
+            case '--port': {
+                const port = Number(argv[++i]);
+                if (!Number.isNaN(port))
+                    flags.port = port;
                 break;
+            }
             case '--template':
             case '-t': {
                 const t = argv[++i];
@@ -23,6 +28,24 @@ function parseArgs(argv) {
             case '--pm':
                 flags.pm = argv[++i];
                 break;
+            case '--style': {
+                const s = argv[++i];
+                if (PREPROCESSORS.includes(s))
+                    flags.preprocessor = s;
+                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 '--install':
                 flags.install = true;
                 break;
@@ -53,6 +76,7 @@ function printHelp() {
         '',
         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)'),
@@ -61,6 +85,9 @@ function printHelp() {
         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'),
@@ -80,6 +107,9 @@ async function main() {
             await runCreate({
                 name: flags.name,
                 template: flags.template,
+                preprocessor: flags.preprocessor,
+                tailwind: flags.tailwind,
+                ai: flags.ai,
                 install: flags.install,
                 git: flags.git,
                 pm: flags.pm,
@@ -87,6 +117,16 @@ async function main() {
                 cwd: process.cwd(),
             });
             break;
+        case 'configure':
+            banner();
+            await runConfigure({
+                root: flags.root,
+                preprocessor: flags.preprocessor,
+                tailwind: flags.tailwind,
+                install: flags.install,
+                cwd: process.cwd(),
+            });
+            break;
         case 'dev':
             banner();
             process.stdout.write(dim('  starting dev server…') + '\n\n');

package/build/cli/proc.d.ts

@@ -0,0 +1 @@
+export declare function run(cmd: string, args: string[], cwd: string): Promise<void>;

package/build/cli/proc.js

@@ -0,0 +1,11 @@
+import { spawn } from 'node:child_process';
+export function run(cmd, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const onWindows = process.platform === 'win32';
+        const child = onWindows
+            ? spawn([cmd, ...args].join(' '), { cwd, stdio: 'ignore', shell: true })
+            : spawn(cmd, args, { cwd, stdio: 'ignore' });
+        child.on('error', reject);
+        child.on('close', (code) => code === 0 ? resolve() : reject(new Error(`${cmd} exited with code ${String(code)}`)));
+    });
+}

package/build/cli/ui.js

@@ -63,8 +63,7 @@ export function version() {
         if (match && match[1])
             return match[1];
     }
-    catch {
-    }
+    catch { }
     return '0.0.0';
 }
 export function banner() {

package/build/cli/validate.d.ts

@@ -0,0 +1,4 @@
+export declare const PACKAGE_MANAGERS: string[];
+export declare function isValidName(name: string): true | string;
+export declare function resolveProjectDir(cwd: string, name: string): string | null;
+export declare function isPackageManager(pm: string): boolean;

package/build/cli/validate.js

@@ -0,0 +1,19 @@
+import path from 'node:path';
+export const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'];
+export function isValidName(name) {
+    if (!name.trim())
+        return 'Please enter a project name.';
+    if (!/^[a-z0-9._@/-]+$/i.test(name))
+        return 'Use letters, numbers, dashes, dots or slashes.';
+    return true;
+}
+export function resolveProjectDir(cwd, name) {
+    const target = path.resolve(cwd, name);
+    const rel = path.relative(cwd, target);
+    if (rel.startsWith('..') || path.isAbsolute(rel))
+        return null;
+    return target;
+}
+export function isPackageManager(pm) {
+    return PACKAGE_MANAGERS.includes(pm);
+}