@revealui/cli 0.0.1-pre.1

package/dist/commands/fix.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Auto-fix command that applies fixes for detected issues
+ */
+export declare function runFix(): Promise<void>;
+//# sourceMappingURL=fix.d.ts.map

package/dist/commands/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../src/commands/fix.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAoD5C"}

package/dist/commands/fix.js

@@ -0,0 +1,129 @@
+import prompts from "prompts";
+import pc from "@brillout/picocolors";
+import { runDiagnostics } from "./doctor/index.js";
+import { applyFixes } from "./doctor/fixes/index.js";
+import * as fixes from "./doctor/fixes/index.js";
+/**
+ * Auto-fix command that applies fixes for detected issues
+ */
+export async function runFix() {
+    console.log(pc.cyan("\n🔧 RevealUI Auto-Fix\n"));
+    console.log(pc.gray("Running diagnostics...\n"));
+    // Run diagnostics first
+    const results = await runDiagnostics();
+    // Find fixable issues
+    const fixableResults = results.filter((r) => r.status === "fail" || r.status === "warn");
+    if (fixableResults.length === 0) {
+        console.log(pc.green("✓ No issues found that need fixing!\n"));
+        return;
+    }
+    // Enhance results with fix functions
+    const enhancedResults = await enhanceResultsWithFixes(results);
+    // Show issues that can be fixed
+    console.log(pc.cyan("Issues found:\n"));
+    for (const result of fixableResults) {
+        const icon = result.status === "fail" ? pc.red("✗") : pc.yellow("⚠");
+        console.log(`${icon} ${result.check}`);
+        console.log(`  ${result.message}`);
+        if (result.suggestion) {
+            console.log(pc.gray(`  → ${result.suggestion}`));
+        }
+    }
+    console.log();
+    // Ask for confirmation
+    const response = await prompts({
+        type: "confirm",
+        name: "apply",
+        message: "Apply automatic fixes?",
+        initial: true,
+    });
+    if (!response.apply) {
+        console.log(pc.yellow("\nFix cancelled."));
+        return;
+    }
+    // Apply fixes
+    console.log(pc.cyan("\nApplying fixes...\n"));
+    await applyFixes(enhancedResults);
+    console.log(pc.green("\n✅ Fix complete!\n"));
+    console.log(pc.cyan("Run 'reveal doctor' again to verify all issues are resolved.\n"));
+}
+/**
+ * Enhance diagnostic results with fix functions
+ */
+async function enhanceResultsWithFixes(results) {
+    const cwd = process.cwd();
+    return results.map((result) => {
+        // Add fix functions based on check type
+        if (result.check === "reveal.config.ts exists" && result.status === "fail") {
+            return {
+                ...result,
+                fix: () => fixes.fixMissingRevealConfig(cwd),
+            };
+        }
+        if (result.check === "required dependencies" && result.status === "fail") {
+            const missingDeps = extractMissingDependencies(result.message);
+            if (missingDeps.length > 0) {
+                return {
+                    ...result,
+                    fix: () => fixes.fixMissingDependencies(cwd, missingDeps),
+                };
+            }
+        }
+        if (result.check === "pages directory" && result.status === "fail") {
+            return {
+                ...result,
+                fix: () => fixes.fixMissingDirectories(cwd, ["src/pages"]),
+            };
+        }
+        if (result.check === "components directory" && result.status === "warn") {
+            return {
+                ...result,
+                fix: () => fixes.fixMissingDirectories(cwd, ["src/components"]),
+            };
+        }
+        if (result.check === "public directory" && result.status === "warn") {
+            return {
+                ...result,
+                fix: () => fixes.fixMissingDirectories(cwd, ["public"]),
+            };
+        }
+        if (result.check === ".gitignore configuration" &&
+            result.status === "warn") {
+            const missingPatterns = extractMissingPatterns(result.message);
+            if (missingPatterns.length > 0) {
+                return {
+                    ...result,
+                    fix: () => fixes.fixGitignore(cwd, missingPatterns),
+                };
+            }
+        }
+        if (result.check === "Environment template" &&
+            result.status === "warn") {
+            return {
+                ...result,
+                fix: () => fixes.fixMissingEnvTemplate(cwd),
+            };
+        }
+        return result;
+    });
+}
+/**
+ * Extract missing dependencies from diagnostic message
+ */
+function extractMissingDependencies(message) {
+    const match = message.match(/Missing dependencies: (.+)/);
+    if (match && match[1]) {
+        return match[1].split(", ").map((d) => d.trim());
+    }
+    return [];
+}
+/**
+ * Extract missing patterns from diagnostic message
+ */
+function extractMissingPatterns(message) {
+    const match = message.match(/missing patterns: (.+)/i);
+    if (match && match[1]) {
+        return match[1].split(", ").map((p) => p.trim());
+    }
+    return [];
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,35 @@
+/**
+ * reveal init command
+ * Interactive project setup for RevealUI Framework
+ */
+/**
+ * Options for project initialization
+ */
+export interface InitOptions {
+    /** Project name (defaults to current directory name) */
+    projectName?: string;
+    /** Project template to use */
+    template?: "basic" | "blog" | "e-commerce" | "portfolio";
+    /** Whether to use TypeScript */
+    useTypeScript?: boolean;
+    /** Whether to use Tailwind CSS */
+    useTailwind?: boolean;
+    /** Whether to include PayloadCMS */
+    usePayload?: boolean;
+}
+/**
+ * Interactive project initialization
+ * Creates a new RevealUI project with the specified configuration
+ *
+ * @param options - Initialization options
+ * @example
+ * ```ts
+ * await initProject({
+ *   template: 'blog',
+ *   useTypeScript: true,
+ *   useTailwind: true,
+ * })
+ * ```
+ */
+export declare function initProject(options?: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC;IACzD,gCAAgC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kCAAkC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyG1E"}

package/dist/commands/init.js

@@ -0,0 +1,104 @@
+/**
+ * reveal init command
+ * Interactive project setup for RevealUI Framework
+ */
+import pc from "@brillout/picocolors";
+import fs from "node:fs/promises";
+import path from "node:path";
+/**
+ * Interactive project initialization
+ * Creates a new RevealUI project with the specified configuration
+ *
+ * @param options - Initialization options
+ * @example
+ * ```ts
+ * await initProject({
+ *   template: 'blog',
+ *   useTypeScript: true,
+ *   useTailwind: true,
+ * })
+ * ```
+ */
+export async function initProject(options = {}) {
+    console.log(pc.cyan("Welcome to RevealUI!"));
+    console.log("Let's set up your project.\n");
+    // Determine project name
+    const projectName = options.projectName || path.basename(process.cwd()) || "my-revealui-app";
+    // Create basic project structure
+    const projectDir = process.cwd();
+    // Create directories
+    const dirs = [
+        "src/pages",
+        "src/components",
+        "src/lib",
+        "src/styles",
+        "public",
+    ];
+    for (const dir of dirs) {
+        await fs.mkdir(path.join(projectDir, dir), { recursive: true });
+    }
+    // Create reveal.config.ts
+    const configContent = `import { defineConfig } from "@revealui/core/config";
+import react from "@revealui/core/plugins/react";
+${options.usePayload ? 'import payload from "@revealui/core/plugins/payload";' : ""}
+import vercel from "@revealui/core/plugins/vercel";
+
+export default defineConfig({
+  plugins: [
+    react(),
+    ${options.usePayload ? "payload()," : ""}
+    vercel(),
+  ],
+  vike: {
+    prerender: true,
+  },
+});
+`;
+    await fs.writeFile(path.join(projectDir, "reveal.config.ts"), configContent, "utf-8");
+    // Create package.json if it doesn't exist
+    try {
+        await fs.access(path.join(projectDir, "package.json"));
+    }
+    catch {
+        const packageJson = {
+            name: projectName,
+            version: "0.1.0",
+            type: "module",
+            scripts: {
+                dev: "vike dev",
+                build: "vike build",
+                preview: "vike preview",
+            },
+            dependencies: {
+                reveal: "latest",
+                react: "^19.0.0",
+                "react-dom": "^19.0.0",
+                vike: "latest",
+                "vike-react": "latest",
+            },
+            devDependencies: {
+                "@types/react": "^19.0.0",
+                "@types/react-dom": "^19.0.0",
+                typescript: "^5.7.0",
+                vite: "^6.0.0",
+            },
+        };
+        await fs.writeFile(path.join(projectDir, "package.json"), JSON.stringify(packageJson, null, 2), "utf-8");
+    }
+    // Create basic page
+    const pageContent = `export default function Page() {
+  return (
+    <div>
+      <h1>Welcome to RevealUI</h1>
+      <p>Your project is ready to go!</p>
+    </div>
+  );
+}
+`;
+    await fs.writeFile(path.join(projectDir, "src/pages/index.page.tsx"), pageContent, "utf-8");
+    console.log(pc.green("✓ Project initialized successfully!"));
+    console.log("\nNext steps:");
+    console.log(`  1. Run ${pc.cyan("pnpm install")} to install dependencies`);
+    console.log(`  2. Run ${pc.cyan("pnpm dev")} to start the dev server`);
+    console.log(`  3. Visit ${pc.cyan("http://localhost:3000")} to see your app`);
+}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Check for available updates for the reveal package
+ */
+export declare function runUpgrade(): Promise<void>;
+/**
+ * Check for dependency updates across the project
+ */
+export declare function checkDependencyUpdates(): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAqFhD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc5D"}

package/dist/commands/upgrade.js

@@ -0,0 +1,85 @@
+import { execSync } from "child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import prompts from "prompts";
+import pc from "@brillout/picocolors";
+/**
+ * Check for available updates for the reveal package
+ */
+export async function runUpgrade() {
+    console.log(pc.cyan("\n🔄 RevealUI Framework Upgrade\n"));
+    console.log(pc.gray("Checking for updates...\n"));
+    const cwd = process.cwd();
+    const packageJsonPath = path.join(cwd, "package.json");
+    try {
+        const packageJsonContent = await fs.readFile(packageJsonPath, "utf-8");
+        const packageJson = JSON.parse(packageJsonContent);
+        const currentVersion = packageJson.dependencies?.reveal ||
+            packageJson.devDependencies?.reveal ||
+            "not found";
+        console.log(pc.cyan(`Current version: ${currentVersion}\n`));
+        // Check for latest version
+        try {
+            const latestVersion = execSync("npm view reveal version", {
+                encoding: "utf-8",
+            }).trim();
+            console.log(pc.cyan(`Latest version: ${latestVersion}\n`));
+            if (currentVersion === latestVersion || currentVersion.includes(latestVersion)) {
+                console.log(pc.green("✓ You're already on the latest version!\n"));
+                return;
+            }
+            // Show changelog info
+            console.log(pc.yellow("New version available!\n"));
+            console.log(pc.gray("To see what's new, visit: https://github.com/RevealUIStudio/reveal/releases\n"));
+            // Ask for confirmation
+            const response = await prompts({
+                type: "confirm",
+                name: "upgrade",
+                message: `Upgrade from ${currentVersion} to ${latestVersion}?`,
+                initial: true,
+            });
+            if (!response.upgrade) {
+                console.log(pc.yellow("\nUpgrade cancelled."));
+                return;
+            }
+            // Perform upgrade
+            console.log(pc.cyan("\nUpgrading...\n"));
+            const isDevDependency = packageJson.devDependencies?.reveal;
+            const command = isDevDependency
+                ? `pnpm add -D reveal@${latestVersion}`
+                : `pnpm add reveal@${latestVersion}`;
+            execSync(command, {
+                cwd,
+                stdio: "inherit",
+            });
+            console.log(pc.green("\n✅ Upgrade complete!\n"));
+            console.log(pc.cyan("Next steps:"));
+            console.log(pc.gray("  1. Review the changelog for breaking changes"));
+            console.log(pc.gray("  2. Run 'reveal doctor' to check for any issues"));
+            console.log(pc.gray("  3. Update your code if necessary\n"));
+        }
+        catch (error) {
+            console.log(pc.yellow("\n⚠ Could not check for latest version. Make sure you're connected to the internet."));
+            console.log(pc.gray("You can manually upgrade by running:\n"));
+            console.log(pc.cyan("  pnpm add reveal@latest\n"));
+        }
+    }
+    catch (error) {
+        console.error(pc.red("Error reading package.json"), error);
+        process.exit(1);
+    }
+}
+/**
+ * Check for dependency updates across the project
+ */
+export async function checkDependencyUpdates() {
+    console.log(pc.cyan("\n📦 Checking for dependency updates...\n"));
+    try {
+        execSync("pnpm outdated", {
+            stdio: "inherit",
+        });
+    }
+    catch {
+        console.log(pc.yellow("Run 'pnpm outdated' manually to see all dependency updates."));
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,128 @@
+import pc from "@brillout/picocolors";
+import { assertUsage } from "@revealui/core/cli/assertions";
+import { assertWarning } from "@revealui/core/cli/assertions/warning";
+// Import from CLI-specific exports (these are properly configured)
+import { runPrerender_forceExit, runPrerenderFromCLI, } from "@revealui/core/cli/prerender";
+import { generateTypes, watchTypes } from "@revealui/core/cli/types";
+import { cac } from "cac";
+import { resolve } from "path";
+import { addPlugin } from "./commands/add.js";
+import { runCheck } from "./commands/check.js";
+import { printDiagnostics, runDiagnostics } from "./commands/doctor/index.js";
+import { runFix } from "./commands/fix.js";
+import { initProject } from "./commands/init.js";
+import { runUpgrade } from "./commands/upgrade.js";
+import { projectInfo } from "./utils.js";
+const cli = cac(projectInfo.projectName);
+cli
+    .command("prerender", "Pre-render the HTML of your pages", {
+    allowUnknownOptions: true,
+})
+    .option("--configFile <path>", "[string] Path to vite.config.js")
+    .action(async (options) => {
+    assertOptions();
+    const { partial, noExtraDir, base, parallel, outDir, configFile } = options;
+    const root = options.root && resolve(options.root);
+    await runPrerenderFromCLI({
+        partial,
+        noExtraDir,
+        base,
+        root,
+        parallel,
+        outDir,
+        configFile,
+    });
+    runPrerender_forceExit();
+});
+cli
+    .command("generate", "Generate types from routes and PayloadCMS collections")
+    .option("--watch", "[boolean] Watch for changes and regenerate types")
+    .option("--output <dir>", "[string] Output directory for generated types")
+    .action(async (options) => {
+    const outputDir = options.output
+        ? resolve(options.output)
+        : resolve(process.cwd(), ".reveal", "types");
+    if (options.watch) {
+        console.log(pc.cyan("Watching for changes..."));
+        await watchTypes(outputDir, () => {
+            console.log(pc.green("Types regenerated"));
+        });
+    }
+    else {
+        await generateTypes(outputDir);
+    }
+});
+cli
+    .command("init", "Initialize a new RevealUI project")
+    .option("--template <name>", "[string] Project template (basic, blog, e-commerce, portfolio)")
+    .option("--typescript", "[boolean] Use TypeScript")
+    .option("--tailwind", "[boolean] Use Tailwind CSS")
+    .option("--payload", "[boolean] Include PayloadCMS")
+    .action(async (options) => {
+    await initProject({
+        template: options.template,
+        useTypeScript: options.typescript,
+        useTailwind: options.tailwind,
+        usePayload: options.payload,
+    });
+});
+cli
+    .command("add <plugin>", "Add a plugin to your project")
+    .action(async (pluginName) => {
+    if (!pluginName) {
+        console.error(pc.red("Error: Plugin name is required"));
+        console.log("Usage: reveal add <plugin-name>");
+        process.exit(1);
+    }
+    await addPlugin({ pluginName });
+});
+cli
+    .command("doctor", "Run health diagnostics on your project")
+    .action(async () => {
+    const results = await runDiagnostics();
+    printDiagnostics(results);
+    const hasFailures = results.some((r) => r.status === "fail");
+    if (hasFailures) {
+        process.exit(1);
+    }
+});
+cli.command("check", "Quick health check (for CI/CD)").action(async () => {
+    const exitCode = await runCheck();
+    process.exit(exitCode);
+});
+cli.command("fix", "Automatically fix common issues").action(async () => {
+    await runFix();
+});
+cli
+    .command("upgrade", "Upgrade RevealUI Framework to the latest version")
+    .action(async () => {
+    await runUpgrade();
+});
+function assertOptions() {
+    // Using process.argv because cac convert names to camelCase
+    const rawOptions = process.argv.slice(3);
+    Object.values(rawOptions).forEach((option) => {
+        assertUsage(!option.startsWith("--") ||
+            [
+                "--root",
+                "--partial",
+                "--noExtraDir",
+                "--clientRouter",
+                "--base",
+                "--parallel",
+                "--outDir",
+                "--configFile",
+            ].includes(option), "Unknown option: " + option);
+        assertWarning(false, `You set ${pc.cyan(option)}, but passing options to ${pc.cyan("$ reveal prerender")} is deprecated: use the config file instead. See https://reveal.dev/command-prerender.`, { onlyOnce: true });
+    });
+}
+// Listen to unknown commands
+cli.on("command:*", () => {
+    assertUsage(false, "Unknown command: " + cli.args.join(" "));
+});
+cli.help();
+cli.version(projectInfo.projectVersion);
+cli.parse(process.argv.length === 2 ? [...process.argv, "--help"] : process.argv);
+process.on("unhandledRejection", (rejectValue) => {
+    throw rejectValue;
+});

package/dist/onLoad.d.ts

@@ -0,0 +1,3 @@
+export { onLoad };
+declare function onLoad(): void;
+//# sourceMappingURL=onLoad.d.ts.map

package/dist/onLoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onLoad.d.ts","sourceRoot":"","sources":["../src/onLoad.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,iBAAS,MAAM,SAEd"}

package/dist/onLoad.js

@@ -0,0 +1,5 @@
+import { assertIsNotBrowser } from "@revealui/core/cli/assertions/assertIsNotBrowser";
+export { onLoad };
+function onLoad() {
+    assertIsNotBrowser();
+}

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+export * from "@revealui/core/cli/assertions/assert";
+export { projectInfo } from "@revealui/core/cli/projectInfo";
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAKA,cAAc,sCAAsC,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/utils.js

@@ -0,0 +1,6 @@
+// We assume all runtime entries will load this utils.ts file
+import { onLoad } from "./onLoad.js";
+onLoad();
+// Export from CLI-specific exports (these avoid directory import issues)
+export * from "@revealui/core/cli/assertions/assert";
+export { projectInfo } from "@revealui/core/cli/projectInfo";

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@revealui/cli",
+  "version": "0.0.1-pre.1",
+  "description": "Command-line interface for RevealUI Framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "revealui": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "cac": "^6.7.14",
+    "@brillout/picocolors": "^1.0.29",
+    "prompts": "^2.4.2",
+    "@revealui/core": "0.0.1-pre.4"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@types/prompts": "^2.4.9",
+    "rimraf": "^6.1.2",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RevealUIStudio/reveal.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://revealui.com",
+  "bugs": {
+    "url": "https://github.com/RevealUIStudio/reveal/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "RevealUI Team",
+  "keywords": [
+    "revealui",
+    "cli",
+    "command-line",
+    "framework",
+    "tool"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "clean": "rimraf ./dist",
+    "build": "pnpm run clean && pnpm run build:ts",
+    "build:ts": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}