@zpress/cli 0.3.3 → 0.4.0

package/dist/index.mjs

@@ -1,726 +1,2 @@
 #!/usr/bin/env node
-import { cli, command } from "@kidd-cli/core";
-import { configError, createPaths, generateAssets, loadConfig, loadManifest, resolveEntries, sync } from "@zpress/core";
-import { z } from "zod";
-import node_path from "node:path";
-import { execFileSync, spawn } from "node:child_process";
-import { platform } from "node:os";
-import { build, dev, serve } from "@rspress/core";
-import { createRspressConfig } from "@zpress/ui";
-import { match as external_ts_pattern_match } from "ts-pattern";
-import promises from "node:fs/promises";
-import node_fs from "node:fs";
-const DEFAULT_PORT = 6174;
-async function startDevServer(options) {
-    const { paths } = options;
-    let serverInstance = null;
-    async function startServer(config) {
-        const rspressConfig = createRspressConfig({
-            config,
-            paths
-        });
-        try {
-            serverInstance = await dev({
-                appDirectory: paths.repoRoot,
-                docDirectory: paths.contentDir,
-                config: rspressConfig,
-                configFilePath: '',
-                extraBuilderConfig: {
-                    server: {
-                        port: DEFAULT_PORT
-                    }
-                }
-            });
-        } catch (error) {
-            const errorMessage = (()=>{
-                if (error instanceof Error) return error.message;
-                return String(error);
-            })();
-            process.stderr.write(`Dev server error: ${errorMessage}\n`);
-            process.exit(1);
-        }
-    }
-    await startServer(options.config);
-    return async (newConfig)=>{
-        process.stdout.write('\n🔄 Config changed — restarting dev server...\n');
-        if (serverInstance) try {
-            await serverInstance.close();
-        } catch (error) {
-            const errorMessage = (()=>{
-                if (error instanceof Error) return error.message;
-                return String(error);
-            })();
-            process.stderr.write(`Error closing server: ${errorMessage}\n`);
-        }
-        await startServer(newConfig);
-        process.stdout.write('✅ Dev server restarted\n\n');
-    };
-}
-async function buildSite(options) {
-    const rspressConfig = createRspressConfig(options);
-    await build({
-        docDirectory: options.paths.contentDir,
-        config: rspressConfig,
-        configFilePath: ''
-    });
-}
-async function buildSiteForCheck(options) {
-    const rspressConfig = createRspressConfig(options);
-    await build({
-        docDirectory: options.paths.contentDir,
-        config: rspressConfig,
-        configFilePath: ''
-    });
-}
-async function serveSite(options) {
-    const rspressConfig = createRspressConfig(options);
-    await serve({
-        config: rspressConfig,
-        configFilePath: '',
-        port: DEFAULT_PORT
-    });
-}
-function openBrowser(url) {
-    const os = platform();
-    const { cmd, args } = external_ts_pattern_match(os).with('darwin', ()=>({
-            cmd: 'open',
-            args: [
-                url
-            ]
-        })).with('win32', ()=>({
-            cmd: 'cmd',
-            args: [
-                '/c',
-                'start',
-                url
-            ]
-        })).otherwise(()=>({
-            cmd: 'xdg-open',
-            args: [
-                url
-            ]
-        }));
-    spawn(cmd, args, {
-        stdio: 'ignore',
-        detached: true
-    }).unref();
-}
-const ANSI_PATTERN = /\u001B\[[0-9;]*m/g;
-function stripAnsi(text) {
-    return text.replace(ANSI_PATTERN, '');
-}
-function runConfigCheck(params) {
-    const { config, loadError } = params;
-    if (loadError) return {
-        passed: false,
-        errors: [
-            loadError
-        ]
-    };
-    if (!config) return {
-        passed: false,
-        errors: [
-            configError('empty_sections', 'Config is missing')
-        ]
-    };
-    return {
-        passed: true,
-        errors: []
-    };
-}
-function chunkToString(chunk) {
-    if ('string' == typeof chunk) return chunk;
-    return Buffer.from(chunk).toString('utf8');
-}
-function toError(value) {
-    if (value instanceof Error) return value;
-    return new Error(String(value));
-}
-function createInterceptor(chunks) {
-    return function(chunk, encodingOrCb, maybeCb) {
-        const text = chunkToString(chunk);
-        chunks.push(text);
-        if ('function' == typeof encodingOrCb) encodingOrCb();
-        else if ('function' == typeof maybeCb) maybeCb();
-        return true;
-    };
-}
-async function captureOutput(fn) {
-    const chunks = [];
-    const originalStdoutWrite = process.stdout.write;
-    const originalStderrWrite = process.stderr.write;
-    process.stdout.write = createInterceptor(chunks);
-    process.stderr.write = createInterceptor(chunks);
-    try {
-        const result = await fn();
-        return {
-            result,
-            error: null,
-            captured: chunks.join('')
-        };
-    } catch (error) {
-        return {
-            result: null,
-            error: toError(error),
-            captured: chunks.join('')
-        };
-    } finally{
-        process.stdout.write = originalStdoutWrite;
-        process.stderr.write = originalStderrWrite;
-    }
-}
-function flushGroup(results, file, links) {
-    if (file && links.length > 0) return [
-        ...results,
-        {
-            file,
-            links
-        }
-    ];
-    return results;
-}
-function parseDeadlinks(stderr) {
-    const clean = stripAnsi(stderr);
-    const lines = clean.split('\n');
-    const headerPattern = /Dead links found in (.+?):\s*$/;
-    const linkPattern = /"\[\.\.]\(([^)]+)\)"/;
-    const acc = lines.reduce((state, line)=>{
-        const headerMatch = headerPattern.exec(line);
-        if (headerMatch) {
-            const file = headerMatch[1] ?? '';
-            return {
-                results: flushGroup(state.results, state.currentFile, state.currentLinks),
-                currentFile: file,
-                currentLinks: []
-            };
-        }
-        const linkMatch = linkPattern.exec(line);
-        if (linkMatch && state.currentFile) {
-            const link = linkMatch[1] ?? '';
-            return {
-                ...state,
-                currentLinks: [
-                    ...state.currentLinks,
-                    link
-                ]
-            };
-        }
-        return state;
-    }, {
-        results: [],
-        currentFile: null,
-        currentLinks: []
-    });
-    return flushGroup(acc.results, acc.currentFile, acc.currentLinks);
-}
-async function runBuildCheck(params) {
-    const { error, captured } = await captureOutput(()=>buildSiteForCheck({
-            config: params.config,
-            paths: params.paths
-        }));
-    if (error) {
-        const { repoRoot } = params.paths;
-        const deadlinks = parseDeadlinks(captured).map((info)=>({
-                file: node_path.relative(repoRoot, info.file),
-                links: info.links
-            }));
-        if (deadlinks.length > 0) return {
-            status: 'failed',
-            deadlinks
-        };
-        return {
-            status: 'error',
-            message: error.message
-        };
-    }
-    return {
-        status: 'passed'
-    };
-}
-const RED = '\u001B[31m';
-const DIM = '\u001B[2m';
-const RESET = '\u001B[0m';
-function formatDeadlinkGroup(info) {
-    const header = `  ${RED}✖${RESET} ${info.file}`;
-    const links = info.links.map((link)=>`      ${DIM}→${RESET} ${link}`);
-    return [
-        header,
-        ...links
-    ].join('\n');
-}
-function presentResults(params) {
-    const { configResult, buildResult, logger } = params;
-    if (configResult.passed) logger.success('Config valid');
-    else {
-        logger.error('Config validation failed:');
-        configResult.errors.map((err)=>{
-            logger.message(`  ${err.message}`);
-            return null;
-        });
-    }
-    if ('passed' === buildResult.status) logger.success('No broken links');
-    else if ('skipped' === buildResult.status) ;
-    else if ('error' === buildResult.status) logger.error(`Build failed: ${buildResult.message}`);
-    else {
-        const totalLinks = buildResult.deadlinks.reduce((sum, info)=>sum + info.links.length, 0);
-        logger.error(`Found ${totalLinks} broken link(s):`);
-        const block = buildResult.deadlinks.map(formatDeadlinkGroup).join('\n');
-        logger.message(block);
-    }
-    return configResult.passed && 'passed' === buildResult.status;
-}
-function cleanTargets(paths) {
-    return [
-        {
-            dir: paths.cacheDir,
-            label: 'cache'
-        },
-        {
-            dir: paths.contentDir,
-            label: 'content'
-        },
-        {
-            dir: paths.distDir,
-            label: 'dist'
-        }
-    ];
-}
-async function clean_clean(paths) {
-    const results = await Promise.all(cleanTargets(paths).map(async ({ dir, label })=>{
-        const exists = await promises.stat(dir).catch(()=>null);
-        if (exists) {
-            await promises.rm(dir, {
-                recursive: true,
-                force: true
-            });
-            return label;
-        }
-        return null;
-    }));
-    return results.filter((label)=>null !== label);
-}
-const cleanCommand = command({
-    description: 'Remove build artifacts, synced content, and build cache',
-    handler: async (ctx)=>{
-        const paths = createPaths(process.cwd());
-        ctx.logger.intro('zpress clean');
-        const removed = await clean_clean(paths);
-        if (removed.length > 0) ctx.logger.success(`Removed: ${removed.join(', ')}`);
-        else ctx.logger.info('Nothing to clean');
-        ctx.logger.outro('Done');
-    }
-});
-const buildCommand = command({
-    description: 'Run sync and build the Rspress site',
-    args: z.object({
-        quiet: z.boolean().optional().default(false),
-        clean: z.boolean().optional().default(false),
-        check: z.boolean().optional().default(true)
-    }),
-    handler: async (ctx)=>{
-        const { quiet, check } = ctx.args;
-        const paths = createPaths(process.cwd());
-        ctx.logger.intro('zpress build');
-        if (ctx.args.clean) {
-            const removed = await clean_clean(paths);
-            if (removed.length > 0 && !quiet) ctx.logger.info(`Cleaned: ${removed.join(', ')}`);
-        }
-        const [configErr, config] = await loadConfig(paths.repoRoot);
-        if (configErr) {
-            ctx.logger.error(configErr.message);
-            if (configErr.errors && configErr.errors.length > 0) configErr.errors.map((err)=>{
-                const path = err.path.join('.');
-                return ctx.logger.error(`  ${path}: ${err.message}`);
-            });
-            process.exit(1);
-        }
-        if (check) {
-            ctx.logger.step('Validating config...');
-            const configResult = runConfigCheck({
-                config,
-                loadError: configErr
-            });
-            ctx.logger.step('Syncing content...');
-            await sync(config, {
-                paths,
-                quiet: true
-            });
-            ctx.logger.step('Building & checking for broken links...');
-            const buildResult = await runBuildCheck({
-                config,
-                paths
-            });
-            const passed = presentResults({
-                configResult,
-                buildResult,
-                logger: ctx.logger
-            });
-            if (!passed) {
-                ctx.logger.outro('Build failed');
-                process.exit(1);
-            }
-            ctx.logger.outro('Done');
-        } else {
-            await sync(config, {
-                paths,
-                quiet
-            });
-            await buildSite({
-                config,
-                paths
-            });
-            ctx.logger.outro('Done');
-        }
-    }
-});
-const checkCommand = command({
-    description: 'Validate config and check for broken links',
-    handler: async (ctx)=>{
-        const paths = createPaths(process.cwd());
-        ctx.logger.intro('zpress check');
-        ctx.logger.step('Validating config...');
-        const [configErr, config] = await loadConfig(paths.repoRoot);
-        const configResult = runConfigCheck({
-            config,
-            loadError: configErr
-        });
-        if (configErr || !config) {
-            const buildResult = {
-                status: 'skipped'
-            };
-            presentResults({
-                configResult,
-                buildResult,
-                logger: ctx.logger
-            });
-            ctx.logger.outro('Checks failed');
-            process.exit(1);
-        }
-        ctx.logger.step('Syncing content...');
-        const syncResult = await sync(config, {
-            paths,
-            quiet: true
-        });
-        ctx.logger.success(`Synced (${syncResult.pagesWritten} written, ${syncResult.pagesSkipped} unchanged)`);
-        ctx.logger.step('Checking for broken links...');
-        const buildResult = await runBuildCheck({
-            config,
-            paths
-        });
-        const passed = presentResults({
-            configResult,
-            buildResult,
-            logger: ctx.logger
-        });
-        if (passed) ctx.logger.outro('All checks passed');
-        else {
-            ctx.logger.outro('Checks failed');
-            process.exit(1);
-        }
-    }
-});
-const devCommand = command({
-    description: 'Run sync + watcher and start Rspress dev server',
-    args: z.object({
-        quiet: z.boolean().optional().default(false),
-        clean: z.boolean().optional().default(false)
-    }),
-    handler: async (ctx)=>{
-        const { quiet } = ctx.args;
-        const paths = createPaths(process.cwd());
-        ctx.logger.intro('zpress dev');
-        if (ctx.args.clean) {
-            const removed = await clean_clean(paths);
-            if (removed.length > 0 && !quiet) ctx.logger.info(`Cleaned: ${removed.join(', ')}`);
-        }
-        const [configErr, config] = await loadConfig(paths.repoRoot);
-        if (configErr) {
-            ctx.logger.error(configErr.message);
-            if (configErr.errors && configErr.errors.length > 0) configErr.errors.forEach((err)=>{
-                const path = err.path.join('.');
-                ctx.logger.error(`  ${path}: ${err.message}`);
-            });
-            process.exit(1);
-        }
-        await sync(config, {
-            paths,
-            quiet
-        });
-        const onConfigReload = await startDevServer({
-            config,
-            paths
-        });
-        const { createWatcher } = await import("./watcher.mjs");
-        const watcher = createWatcher(config, paths, onConfigReload);
-        function cleanup() {
-            watcher.close();
-        }
-        process.on('SIGINT', cleanup);
-        process.on('SIGTERM', cleanup);
-    }
-});
-function maybeLink(link) {
-    if (link) return {
-        link
-    };
-    return {};
-}
-function maybeCollapsible(collapsible) {
-    if (collapsible) return {
-        collapsible
-    };
-    return {};
-}
-function maybeHidden(hidden) {
-    if (hidden) return {
-        hidden
-    };
-    return {};
-}
-function maybeIsolated(isolated) {
-    if (isolated) return {
-        isolated
-    };
-    return {};
-}
-function maybeItems(items) {
-    if (items && items.length > 0) return {
-        items: toTree(items)
-    };
-    return {};
-}
-function toTree(entries) {
-    return entries.map(buildDumpEntry);
-}
-function buildDumpEntry(entry) {
-    return {
-        text: entry.title,
-        ...maybeLink(entry.link),
-        ...maybeCollapsible(entry.collapsible),
-        ...maybeHidden(entry.hidden),
-        ...maybeIsolated(entry.isolated),
-        ...maybeItems(entry.items)
-    };
-}
-const dumpCommand = command({
-    description: 'Resolve and print the full entry tree as JSON',
-    handler: async (ctx)=>{
-        const paths = createPaths(process.cwd());
-        const [configErr, config] = await loadConfig(paths.repoRoot);
-        if (configErr) {
-            ctx.logger.error(configErr.message);
-            if (configErr.errors && configErr.errors.length > 0) configErr.errors.map((err)=>{
-                const path = err.path.join('.');
-                return ctx.logger.error(`  ${path}: ${err.message}`);
-            });
-            process.exit(1);
-        }
-        const previousManifest = await loadManifest(paths.contentDir);
-        const syncCtx = {
-            repoRoot: paths.repoRoot,
-            outDir: paths.contentDir,
-            config,
-            previousManifest,
-            manifest: {
-                files: {},
-                timestamp: Date.now()
-            },
-            quiet: true
-        };
-        const [resolveErr, resolved] = await resolveEntries(config.sections, syncCtx);
-        if (resolveErr) {
-            ctx.logger.error(resolveErr.message);
-            process.exit(1);
-        }
-        const tree = toTree(resolved);
-        ctx.output.raw(`${JSON.stringify(tree, null, 2)}\n`);
-    }
-});
-function buildAssetConfig(config) {
-    if (!config.title) return null;
-    return {
-        title: config.title,
-        tagline: config.tagline
-    };
-}
-const generateCommand = command({
-    description: 'Generate banner, logo, and icon SVG assets from project title',
-    handler: async (ctx)=>{
-        ctx.logger.intro('zpress generate');
-        const paths = createPaths(process.cwd());
-        const [configErr, config] = await loadConfig(paths.repoRoot);
-        if (configErr) {
-            ctx.logger.error(configErr.message);
-            if (configErr.errors && configErr.errors.length > 0) configErr.errors.map((err)=>{
-                const path = err.path.join('.');
-                return ctx.logger.error(`  ${path}: ${err.message}`);
-            });
-            process.exit(1);
-        }
-        const assetConfig = buildAssetConfig(config);
-        if (!assetConfig) {
-            ctx.logger.warn('No title configured — skipping asset generation');
-            ctx.logger.outro('Done');
-            return;
-        }
-        await promises.mkdir(paths.publicDir, {
-            recursive: true
-        });
-        const [err, written] = await generateAssets({
-            config: assetConfig,
-            publicDir: paths.publicDir
-        });
-        if (err) {
-            ctx.logger.error(err.message);
-            ctx.logger.outro('Failed');
-            return;
-        }
-        if (0 === written.length) ctx.logger.info('All assets are user-customized — nothing to generate');
-        else ctx.logger.success(`Generated ${written.join(', ')}`);
-        ctx.logger.outro('Done');
-    }
-});
-const serveCommand = command({
-    description: 'Preview the built Rspress site',
-    args: z.object({
-        open: z.boolean().optional().default(true)
-    }),
-    handler: async (ctx)=>{
-        ctx.logger.intro('zpress serve');
-        const paths = createPaths(process.cwd());
-        const [configErr, config] = await loadConfig(paths.repoRoot);
-        if (configErr) {
-            ctx.logger.error(configErr.message);
-            if (configErr.errors && configErr.errors.length > 0) configErr.errors.map((err)=>{
-                const path = err.path.join('.');
-                return ctx.logger.error(`  ${path}: ${err.message}`);
-            });
-            process.exit(1);
-        }
-        if (ctx.args.open) setTimeout(()=>openBrowser(`http://localhost:${DEFAULT_PORT}`), 2000);
-        await serveSite({
-            config,
-            paths
-        });
-    }
-});
-const CONFIG_FILENAME = 'zpress.config.ts';
-function extractGitRepoName(cwd) {
-    const url = execSilent('git', [
-        'remote',
-        'get-url',
-        'origin'
-    ], cwd);
-    if (!url) return null;
-    const match = url.match(/[/:]([^/:]+?)(?:\.git)?$/);
-    if (!match) return null;
-    return match[1];
-}
-function execSilent(file, args, cwd) {
-    try {
-        return execFileSync(file, [
-            ...args
-        ], {
-            cwd,
-            stdio: 'pipe',
-            encoding: 'utf8'
-        }).trim();
-    } catch  {
-        return null;
-    }
-}
-function deriveTitle(cwd) {
-    const repoName = extractGitRepoName(cwd);
-    if (repoName) return repoName;
-    return node_path.basename(cwd);
-}
-function buildConfigTemplate(title) {
-    const escaped = title.replaceAll("'", String.raw`\'`);
-    return `import { defineConfig } from '@zpress/kit'
-
-export default defineConfig({
-  title: '${escaped}',
-  sections: [
-    {
-      text: 'Getting Started',
-      prefix: '/getting-started',
-      from: 'docs/*.md',
-    },
-  ],
-})
-`;
-}
-const setupCommand = command({
-    description: 'Initialize a zpress config in the current project',
-    handler: async (ctx)=>{
-        const cwd = process.cwd();
-        const paths = createPaths(cwd);
-        const configPath = node_path.join(paths.repoRoot, CONFIG_FILENAME);
-        ctx.logger.intro('zpress setup');
-        if (node_fs.existsSync(configPath)) {
-            ctx.logger.warn(`${CONFIG_FILENAME} already exists — skipping`);
-            ctx.logger.outro('Done');
-            return;
-        }
-        const title = deriveTitle(cwd);
-        node_fs.writeFileSync(configPath, buildConfigTemplate(title), 'utf8');
-        ctx.logger.success(`Created ${CONFIG_FILENAME} (title: "${title}")`);
-        await promises.mkdir(paths.publicDir, {
-            recursive: true
-        });
-        const [assetErr, written] = await generateAssets({
-            config: {
-                title,
-                tagline: void 0
-            },
-            publicDir: paths.publicDir
-        });
-        if (assetErr) {
-            ctx.logger.error(`Asset generation failed: ${assetErr.message}`);
-            process.exit(1);
-        }
-        if (written.length > 0) ctx.logger.success(`Generated ${written.join(', ')}`);
-        ctx.logger.outro('Done');
-    }
-});
-const syncCommand = command({
-    description: 'Sync documentation sources into .zpress/',
-    args: z.object({
-        quiet: z.boolean().optional().default(false)
-    }),
-    handler: async (ctx)=>{
-        const { quiet } = ctx.args;
-        const paths = createPaths(process.cwd());
-        if (!quiet) ctx.logger.intro('zpress sync');
-        const [configErr, config] = await loadConfig(paths.repoRoot);
-        if (configErr) {
-            ctx.logger.error(configErr.message);
-            if (configErr.errors && configErr.errors.length > 0) configErr.errors.map((err)=>{
-                const path = err.path.join('.');
-                return ctx.logger.error(`  ${path}: ${err.message}`);
-            });
-            process.exit(1);
-        }
-        await sync(config, {
-            paths,
-            quiet
-        });
-        if (!quiet) ctx.logger.outro('Done');
-    }
-});
-await cli({
-    name: 'zpress',
-    version: "0.3.3",
-    description: 'CLI for building and serving documentation',
-    commands: {
-        sync: syncCommand,
-        dev: devCommand,
-        build: buildCommand,
-        check: checkCommand,
-        serve: serveCommand,
-        clean: cleanCommand,
-        dump: dumpCommand,
-        setup: setupCommand,
-        generate: generateCommand
-    }
-});
+import "./145.mjs";