toiljs 0.0.15 → 0.0.16

package/build/cli/create.js

@@ -1,420 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { cancel, confirm, intro, isCancel, multiselect, note, outro, select, spinner, text, } from '@clack/prompts';
-import { AI_HELPER_IDS, AI_HELPERS, aiHelperFiles, TOIL_DOCS, TOIL_ENV_DTS } from 'toiljs/compiler';
-import pc from 'picocolors';
-import { PKG_VERSION, PREPROCESSORS, requiredPackages, setStyleImports, 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);
-    }
-}
-async function isEmptyDir(dir) {
-    try {
-        const entries = await fs.readdir(dir);
-        return entries.length === 0;
-    }
-    catch {
-        return true;
-    }
-}
-function scaffold(name, template, features, aiTools, images) {
-    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 && toilscript --target release',
-            'build:client': 'toiljs build',
-            'build:server': 'toilscript --target release',
-            lint: 'eslint client',
-            typecheck: 'tsc --noEmit',
-            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,
-    };
-    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' +
-            '        // Optimize images at build time (resize/compress imported images).\n' +
-            `        images: ${String(images)},\n` +
-            '    },\n' +
-            '});\n',
-        'tsconfig.json': '{\n    "extends": "toiljs/tsconfig",\n    "include": ["client", "toil-env.d.ts", "toil-routes.d.ts"]\n}\n',
-        'eslint.config.js': "import toiljs from 'toiljs/eslint';\n\nexport default toiljs;\n",
-        '.prettierrc': '"toiljs/prettier"\n',
-        '.gitignore': 'node_modules\nbuild\n.toil\ntoil-env.d.ts\ntoil-routes.d.ts\n',
-        '.vscode/settings.json': JSON.stringify({ 'typescript.tsdk': 'node_modules/typescript/lib' }, null, 4) + '\n',
-        'toil-env.d.ts': TOIL_ENV_DTS,
-        'toil-routes.d.ts': '// AUTO-GENERATED by toil, do not edit.\nexport {};\n',
-        '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'),
-    };
-    if (template === 'minimal')
-        Object.assign(files, minimalClient(name, features));
-    Object.assign(files, aiHelperFiles(aiTools));
-    for (const [docName, content] of Object.entries(TOIL_DOCS)) {
-        files[`.toil/docs/${docName}`] = content;
-    }
-    return files;
-}
-function minimalClient(name, features) {
-    const files = {
-        '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, globalError, slots } from 'toiljs/routes';\n\n" +
-            styleImportLines(features).join('\n') +
-            '\n\n' +
-            'Toil.mount(routes, layout, notFound, globalError, slots);\n',
-        [`client/${styleEntry(features.preprocessor)}`]: DEFAULT_STYLE_CONTENT,
-        'client/components/.gitkeep': '# Place shared React components here.\n',
-        'client/layout.tsx': `import { type ReactNode } from 'react';
-
-export default function Layout({ children }: { children?: ReactNode }) {
-    return (
-        <div style={{ maxWidth: 680, margin: '0 auto', padding: '3rem 1.5rem' }}>
-            <header
-                style={{
-                    display: 'flex',
-                    gap: '1rem',
-                    alignItems: 'baseline',
-                    borderBottom: '1px solid #1b2330',
-                    paddingBottom: '0.75rem',
-                    marginBottom: '1.5rem',
-                }}>
-                <strong style={{ color: '#2563FF', fontSize: '1.1rem' }}>${path.basename(name)}</strong>
-                <nav style={{ display: 'flex', gap: '1rem' }}>
-                    <Toil.Link href="/">home</Toil.Link>
-                </nav>
-            </header>
-            {children}
-        </div>
-    );
-}
-`,
-        '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' +
-            '        </main>\n    );\n}\n',
-    };
-    if (features.tailwind)
-        files[`client/${TAILWIND_ENTRY}`] = TAILWIND_CSS;
-    return files;
-}
-function appClientDir() {
-    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'examples', 'basic', 'client');
-}
-async function applyStyling(clientDir, features) {
-    if (features.preprocessor === 'css' && !features.tailwind)
-        return;
-    const entry = styleEntry(features.preprocessor);
-    if (entry !== 'styles/main.css') {
-        await fs.rename(path.join(clientDir, 'styles', 'main.css'), path.join(clientDir, entry));
-    }
-    if (features.tailwind) {
-        await fs.writeFile(path.join(clientDir, TAILWIND_ENTRY), TAILWIND_CSS, 'utf8');
-    }
-    const toilPath = path.join(clientDir, 'toil.tsx');
-    await fs.writeFile(toilPath, setStyleImports(await fs.readFile(toilPath, 'utf8'), features), 'utf8');
-}
-async function writeFiles(dir, files) {
-    for (const [rel, contents] of Object.entries(files)) {
-        const full = path.join(dir, rel);
-        await fs.mkdir(path.dirname(full), { recursive: true });
-        await fs.writeFile(full, contents, 'utf8');
-    }
-}
-export async function runCreate(opts) {
-    intro(accent(' toiljs create '));
-    let name = opts.name;
-    if (!name) {
-        if (opts.yes) {
-            name = 'my-toil-app';
-        }
-        else {
-            const answer = await text({
-                message: 'Project name',
-                placeholder: 'my-toil-app',
-                defaultValue: 'my-toil-app',
-                validate: (v) => {
-                    const result = isValidName(v || 'my-toil-app');
-                    return result === true ? undefined : result;
-                },
-            });
-            bail(answer);
-            name = answer.trim() || 'my-toil-app';
-        }
-    }
-    const valid = isValidName(name);
-    if (valid !== true) {
-        cancel(valid);
-        process.exit(1);
-    }
-    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) {
-            cancel(`Directory ${pc.cyan(rel)} is not empty.`);
-            process.exit(1);
-        }
-        const proceed = await confirm({
-            message: `Directory ${pc.cyan(rel)} is not empty. Scaffold into it anyway?`,
-            initialValue: false,
-        });
-        bail(proceed);
-        if (!proceed) {
-            cancel('Scaffolding cancelled.');
-            process.exit(0);
-        }
-    }
-    let template = opts.template ?? 'app';
-    if (!opts.template && !opts.yes) {
-        const templateOptions = [
-            {
-                value: 'app',
-                label: 'App',
-                hint: 'the full ToilJS starter, landing page, layout, styles, demo routes',
-            },
-            { value: 'minimal', label: 'Minimal', hint: 'just a layout and a home route' },
-        ];
-        const choice = await select({
-            message: 'Which template?',
-            options: templateOptions,
-            initialValue: 'app',
-        });
-        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 })),
-                { value: 'none', label: 'None' },
-            ],
-            initialValues: [...AI_HELPER_IDS],
-            required: false,
-        });
-        bail(picked);
-        aiTools = picked.includes('none') ? [] : picked;
-    }
-    let images = opts.images ?? true;
-    if (opts.images === undefined && !opts.yes) {
-        const im = await confirm({ message: 'Optimize images at build time?', initialValue: true });
-        bail(im);
-        images = im;
-    }
-    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,
-            });
-            bail(g);
-            initGit = g;
-        }
-        if (opts.install === undefined) {
-            const i = await confirm({ message: 'Install dependencies now?', initialValue: false });
-            bail(i);
-            install = i;
-        }
-    }
-    const s = spinner();
-    s.start('Scaffolding project');
-    await writeFiles(targetDir, scaffold(name, template, features, aiTools, images));
-    if (template === 'app') {
-        await fs.cp(appClientDir(), path.join(targetDir, 'client'), { recursive: true });
-        const indexHtml = path.join(targetDir, 'client', 'public', 'index.html');
-        const html = await fs.readFile(indexHtml, 'utf8');
-        await fs.writeFile(indexHtml, html.replace(/<title>[^<]*<\/title>/, `<title>${path.basename(name)}</title>`));
-        await applyStyling(path.join(targetDir, 'client'), features);
-    }
-    s.stop(`Scaffolded ${pc.cyan(rel)}`);
-    if (initGit) {
-        const g = spinner();
-        g.start('Initializing git repository');
-        try {
-            await run('git', ['init', '-q'], targetDir);
-            await run('git', ['add', '-A'], targetDir);
-            g.stop('Initialized git repository');
-        }
-        catch {
-            g.stop(pc.yellow('Skipped git init (git not available)'));
-        }
-    }
-    if (install) {
-        const i = spinner();
-        i.start(`Installing dependencies with ${pm}`);
-        try {
-            await run(pm, ['install'], targetDir);
-            i.stop('Installed dependencies');
-        }
-        catch {
-            i.stop(pc.yellow(`Could not install with ${pm}, run it yourself later`));
-            install = false;
-        }
-    }
-    const steps = [];
-    if (rel !== '.')
-        steps.push(`cd ${rel}`);
-    if (!install)
-        steps.push('npm install');
-    steps.push(`${accent('npm run dev')}   ${dim('start the dev server')}`);
-    steps.push(`${accent('npm run build')} ${dim('build for production')}`);
-    note(steps.map((l) => dim('  ') + l).join('\n'), 'Next steps');
-    outro(`Created ${accent(path.basename(name))}, happy building! ${dim('· v' + version())}`);
-}

package/build/cli/diagnostics.d.ts

@@ -1,55 +0,0 @@
-import { type Preprocessor } from './features.js';
-export type CheckStatus = 'pass' | 'warn' | 'fail';
-export interface Check {
-    readonly id: string;
-    readonly label: string;
-    readonly status: CheckStatus;
-    readonly detail?: string;
-    readonly fix?: string;
-}
-export interface CheckGroup {
-    readonly title: string;
-    readonly checks: Check[];
-}
-export interface DoctorSummary {
-    readonly pass: number;
-    readonly warn: number;
-    readonly fail: number;
-}
-export declare function satisfiesMin(version: string, range: string): boolean;
-export declare function checkNode(current: string, requiredRange: string): Check;
-export declare function checkPeer(name: string, installed: string | null, range: string): Check;
-export declare function checkPackageManager(lockfiles: readonly string[]): Check;
-export declare function checkToiljsInstalled(version: string | null): Check;
-export declare function checkDir(id: string, label: string, exists: boolean, fix: string): Check;
-export declare function checkMountSlots(entrySource: string | null): Check;
-export declare function checkRootElement(indexHtml: string | null): Check;
-export declare function checkRoutesPresent(routeCount: number): Check;
-export declare function checkDuplicatePatterns(patterns: readonly string[]): Check;
-export interface SourceFile {
-    readonly path: string;
-    readonly source: string;
-}
-export interface AssetIssue {
-    readonly file: string;
-    readonly line: number;
-    readonly value: string;
-}
-export declare function findRelativeAssets(files: readonly SourceFile[]): AssetIssue[];
-export declare function checkRelativeAssets(issues: readonly AssetIssue[]): Check;
-export declare function checkConfigLoads(loaded: boolean, error?: string): Check;
-export declare function checkBasePath(base: string): Check;
-export declare function checkSeoUrl(seoConfigured: boolean, hasUrl: boolean): Check;
-export interface StylingFacts {
-    readonly preprocessorImported: Preprocessor | null;
-    readonly preprocessorInstalled: boolean;
-    readonly tailwindImported: boolean;
-    readonly tailwindInstalled: boolean;
-}
-export declare function checkStyling(f: StylingFacts): Check;
-export declare function checkToilconfig(present: boolean): Check;
-export declare function checkServerEntry(missing: readonly string[]): Check;
-export declare function checkToilscriptInstalled(installed: boolean): Check;
-export declare function checkWasmBuilt(exists: boolean): Check;
-export declare function summarize(groups: readonly CheckGroup[]): DoctorSummary;
-export declare function hasFailures(summary: DoctorSummary): boolean;