@clarify-labs/cli 0.4.0 → 0.5.0

package/output/cli/commands/init.d.ts

@@ -1,2 +1,2 @@
 import { ResolvedCliOptions } from '../options.js';
-export declare function runInit(options: ResolvedCliOptions, force: boolean): void;
+export declare function runInit(options: ResolvedCliOptions, force: boolean, template?: string): void;

package/output/cli/package.d.ts

@@ -1 +1,6 @@
+export declare const cliPackageJson: {
+    version?: string;
+};
+export declare const cliPackageVersion: string;
+export declare const cliPackageVersionWithCaret: string;
 export declare function readPackageVersion(): string;

package/output/cli.cjs

@@ -1,10 +1,83 @@
 #!/usr/bin/env node
-const require_plugin = require("./plugin-BSPUvgb3.cjs");
+const require_plugin = require("./plugin-DnD0L83F.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_url = require("node:url");
 let vite = require("vite");
+let node_module = require("node:module");
 let cac = require("cac");
+let node_fs_promises = require("node:fs/promises");
+let _clarify_labs_templates = require("@clarify-labs/templates");
+//#region source/core/log.ts
+var LOG_FILE_NAME = ".clarify.log";
+var DEFAULT_LOG_ENTRIES = 50;
+var ENTRY_SEPARATOR = "\n\n---\n\n";
+function getMaxLogEntries() {
+	const envValue = process.env.CLARIFY_LOG_MAX_ENTRIES;
+	if (!envValue) return DEFAULT_LOG_ENTRIES;
+	const parsed = Number(envValue);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_LOG_ENTRIES;
+}
+function normalizeErrorMessage(error) {
+	if (error === void 0) return "undefined";
+	if (error === null) return "null";
+	if (error instanceof Error) return error.message;
+	if (typeof error === "object") {
+		if ("message" in error && typeof error.message === "string") return error.message;
+		try {
+			return JSON.stringify(error);
+		} catch {
+			return String(error);
+		}
+	}
+	return String(error);
+}
+function normalizeErrorStack(error) {
+	if (error instanceof Error) return error.stack;
+}
+function formatLogEntry(root, error) {
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	const message = normalizeErrorMessage(error);
+	const stack = normalizeErrorStack(error);
+	return [
+		`=== Clarify build error ===`,
+		`Timestamp: ${timestamp}`,
+		`Project root: ${root}`,
+		`Error: ${message}`,
+		stack ? `Stack:\n${stack}` : void 0
+	].filter(Boolean).join("\n");
+}
+async function logBuildError(root, error, maxEntries) {
+	const logPath = (0, node_path.join)(root, LOG_FILE_NAME);
+	const entry = formatLogEntry(root, error);
+	const max = maxEntries ?? getMaxLogEntries();
+	let entries = [];
+	if ((0, node_fs.existsSync)(logPath)) try {
+		entries = (await (0, node_fs_promises.readFile)(logPath, "utf8")).split(ENTRY_SEPARATOR).map((item) => item.trim()).filter(Boolean);
+	} catch {
+		entries = [];
+	}
+	entries.push(entry);
+	if (entries.length > max) entries = entries.slice(-max);
+	(0, node_fs.mkdirSync)((0, node_path.dirname)(logPath), { recursive: true });
+	await (0, node_fs_promises.writeFile)(logPath, entries.join(ENTRY_SEPARATOR) + "\n", "utf8");
+}
+function logBuildErrorSync(root, error, maxEntries) {
+	const logPath = (0, node_path.join)(root, LOG_FILE_NAME);
+	const entry = formatLogEntry(root, error);
+	const max = maxEntries ?? getMaxLogEntries();
+	let entries = [];
+	if ((0, node_fs.existsSync)(logPath)) try {
+		entries = (0, node_fs.readFileSync)(logPath, "utf8").split(ENTRY_SEPARATOR).map((item) => item.trim()).filter(Boolean);
+	} catch {
+		entries = [];
+	}
+	entries.push(entry);
+	if (entries.length > max) entries = entries.slice(-max);
+	(0, node_fs.mkdirSync)((0, node_path.dirname)(logPath), { recursive: true });
+	(0, node_fs.writeFileSync)(logPath, entries.join(ENTRY_SEPARATOR) + "\n", "utf8");
+}
+//#endregion
 //#region source/core/vite-config.ts
 var DEFAULT_HTML = "<!doctype html><html lang=\"en\"><head><meta charset=\"UTF-8\" /><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" /><title>Clarify</title></head><body><div id=\"root\"></div></body></html>";
 function ensureHtmlEntry(root) {
@@ -15,6 +88,35 @@ function ensureHtmlEntry(root) {
 	(0, node_fs.writeFileSync)(generatedHtmlPath, DEFAULT_HTML, "utf-8");
 	return generatedHtmlPath;
 }
+function createClarifyLogger(root, env, level) {
+	if (env.command !== "build") return void 0;
+	const baseLogger = (0, vite.createLogger)(level, { allowClearScreen: true });
+	return {
+		info(msg, options) {
+			baseLogger.info(msg, options);
+		},
+		warn(msg, options) {
+			baseLogger.warn(msg, options);
+		},
+		warnOnce(msg, options) {
+			baseLogger.warnOnce(msg, options);
+		},
+		error(msg, options) {
+			baseLogger.error(msg, options);
+			if (options?.error) logBuildErrorSync(root, options.error);
+			else logBuildErrorSync(root, typeof msg === "string" ? new Error(msg) : msg);
+		},
+		clearScreen(type) {
+			baseLogger.clearScreen(type);
+		},
+		hasErrorLogged(error) {
+			return baseLogger.hasErrorLogged(error);
+		},
+		get hasWarned() {
+			return baseLogger.hasWarned;
+		}
+	};
+}
 function createHtmlFallbackPlugin() {
 	return {
 		name: "clarify:cli-html-fallback",
@@ -52,6 +154,7 @@ async function createViteConfig(options, env) {
 		configFile: false,
 		appType: "custom",
 		resolve: { alias: require_plugin.createClarifyRuntimeAliases() },
+		customLogger: createClarifyLogger(options.root, env, "info"),
 		plugins: [require_plugin.clarifyPlugin(buildOptions), createHtmlFallbackPlugin()],
 		server: {
 			host: options.host,
@@ -92,10 +195,15 @@ async function createViteConfig(options, env) {
 //#endregion
 //#region source/cli/commands/build.ts
 async function runBuild(options) {
-	await (0, vite.build)(await createViteConfig(options, {
-		command: "build",
-		mode: "production"
-	}));
+	try {
+		await (0, vite.build)(await createViteConfig(options, {
+			command: "build",
+			mode: "production"
+		}));
+	} catch (error) {
+		await logBuildError(options.root, error);
+		throw error;
+	}
 }
 //#endregion
 //#region source/cli/commands/dev.ts
@@ -108,14 +216,86 @@ async function runDev(options) {
 	server.printUrls();
 	server.bindCLIShortcuts({ print: true });
 }
+var cliPackageVersion = {
+	name: "@clarify-labs/cli",
+	version: "0.5.0",
+	license: "AGPL-3.0-only",
+	type: "module",
+	repository: {
+		"type": "git",
+		"url": "https://github.com/taicode-labs/clarify",
+		"directory": "packages/cli"
+	},
+	main: "output/index.cjs",
+	module: "output/index.js",
+	types: "output/index.d.ts",
+	bin: { "clarify": "bin/clarify.js" },
+	exports: {
+		".": {
+			"types": "./output/index.d.ts",
+			"import": "./output/index.js",
+			"require": "./output/index.cjs",
+			"default": "./output/index.js"
+		},
+		"./package.json": "./package.json"
+	},
+	files: [
+		"LICENSE",
+		"bin",
+		"output"
+	],
+	scripts: {
+		"dev": "vite build --watch",
+		"build": "vite build",
+		"lint": "eslint source/",
+		"lint:fix": "eslint source/ --fix",
+		"typecheck": "tsc -p tsconfig.json --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest"
+	},
+	dependencies: {
+		"@apidevtools/swagger-parser": "^12.1.0",
+		"@clarify-labs/renderer": "workspace:*",
+		"@clarify-labs/templates": "workspace:*",
+		"@mdx-js/rollup": "^3.1.1",
+		"@tailwindcss/vite": "^4.1.11",
+		"@vitejs/plugin-react": "^6.0.2",
+		"cac": "^7.0.0",
+		"github-slugger": "^2.0.0",
+		"gray-matter": "^4.0.3",
+		"mdast-util-to-string": "^4.0.0",
+		"openapi-types": "^12.1.3",
+		"react": "^19.1.0",
+		"react-dom": "^19.1.0",
+		"react-router-dom": "^7.0.0",
+		"remark": "^15.0.1",
+		"remark-gfm": "^4.0.1",
+		"shiki": "0.14.7",
+		"unist-util-visit": "^5.1.0",
+		"vite": "^8.0.15",
+		"zod": "^4.4.3"
+	},
+	devDependencies: {
+		"@mdx-js/mdx": "^3.1.1",
+		"typescript": "^5.8.3",
+		"vite-plugin-dts": "^4.5.4",
+		"vitest": "^4.1.9"
+	}
+}.version ?? "0.0.0";
+var cliPackageVersionWithCaret = `^${cliPackageVersion}`;
 //#endregion
 //#region source/cli/commands/init.ts
-function writeTextFile(filePath, content, force) {
-	if ((0, node_fs.existsSync)(filePath) && !force) return false;
-	(0, node_fs.mkdirSync)((0, node_path.dirname)(filePath), { recursive: true });
-	(0, node_fs.writeFileSync)(filePath, content, "utf-8");
-	return true;
+var require$1 = (0, node_module.createRequire)({}.url);
+function findTemplatesPackagePath() {
+	try {
+		return require$1.resolve("@clarify-labs/templates/package.json");
+	} catch {
+		const workspacePackagePath = (0, node_path.resolve)((0, node_path.dirname)((0, node_url.fileURLToPath)({}.url)), "../../../../templates/package.json");
+		if ((0, node_fs.existsSync)(workspacePackagePath)) return workspacePackagePath;
+		throw new Error("[clarify] Templates package not found.");
+	}
 }
+var templatesDirectory = (0, node_path.dirname)(findTemplatesPackagePath());
 function updatePackageJson(root, force) {
 	const packageJsonPath = (0, node_path.resolve)(root, "package.json");
 	const packageJson = (0, node_fs.existsSync)(packageJsonPath) ? JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8")) : { type: "module" };
@@ -124,58 +304,40 @@ function updatePackageJson(root, force) {
 	if (force || !scripts.build) scripts.build = "clarify build";
 	packageJson.scripts = scripts;
 	const devDependencies = typeof packageJson.devDependencies === "object" && packageJson.devDependencies !== null ? packageJson.devDependencies : {};
-	if (!devDependencies["@clarify-labs/cli"]) devDependencies["@clarify-labs/cli"] = "^0.2.0";
+	if (!devDependencies["@clarify-labs/cli"]) devDependencies["@clarify-labs/cli"] = cliPackageVersionWithCaret;
 	packageJson.devDependencies = devDependencies;
 	(0, node_fs.writeFileSync)(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, "utf-8");
 	return true;
 }
-function runInit(options, force) {
-	const created = [];
-	const skipped = [];
-	(writeTextFile((0, node_path.resolve)(options.root, "clarify.ts"), `import { defineConfig } from '@clarify-labs/cli'
-
-export default defineConfig({
-  title: 'Clarify Docs',
-  description: 'Documentation powered by Clarify',
-  theme: { preset: 'default' },
-})
-`, force) ? created : skipped).push("clarify.ts");
-	(writeTextFile((0, node_path.resolve)(options.root, options.content, "index.mdx"), `---
-title: Welcome
----
-
-# Welcome to Clarify
-
-Start writing your documentation in \`${options.content}\`.
-`, force) ? created : skipped).push(`${options.content}/index.mdx`);
+function runInit(options, force, template) {
+	const selectedTemplate = (0, _clarify_labs_templates.resolveTemplate)(template);
+	const { created } = (0, _clarify_labs_templates.copyTemplateDirectory)((0, _clarify_labs_templates.getTemplateDirectory)(templatesDirectory, selectedTemplate), options.root, {
+		contentDir: options.content,
+		force
+	});
 	if (updatePackageJson(options.root, force)) created.push("package.json");
-	console.log("[clarify] Init complete.");
+	console.log(`[clarify] Init complete with ${selectedTemplate} template.`);
 	if (created.length > 0) console.log(`[clarify] Created or updated: ${created.join(", ")}`);
-	if (skipped.length > 0) console.log(`[clarify] Skipped existing files: ${skipped.join(", ")}. Use --force to overwrite.`);
 }
 //#endregion
 //#region source/cli/options.ts
+function resolvePort(port) {
+	if (port === void 0) return void 0;
+	const parsedPort = typeof port === "string" ? Number(port) : port;
+	if (!Number.isInteger(parsedPort) || parsedPort < 1 || parsedPort > 65535) throw new Error("[clarify] --port must be an integer between 1 and 65535");
+	return parsedPort;
+}
 function resolveCliOptions(options) {
 	return {
 		root: (0, node_path.resolve)(options.root ?? process.cwd()),
 		content: options.content ?? "source",
 		output: options.output ?? "output",
 		host: options.host,
-		port: typeof options.port === "string" ? Number.parseInt(options.port, 10) : options.port,
+		port: resolvePort(options.port),
 		open: options.open
 	};
 }
 //#endregion
-//#region source/cli/package.ts
-function readPackageVersion() {
-	try {
-		const packageJsonPath = (0, node_path.resolve)((0, node_path.dirname)((0, node_url.fileURLToPath)({}.url)), "../package.json");
-		return JSON.parse((0, node_fs.readFileSync)(packageJsonPath, "utf-8")).version ?? "0.0.0";
-	} catch {
-		return "0.0.0";
-	}
-}
-//#endregion
 //#region source/cli/index.ts
 function withSharedOptions(command) {
 	return command.option("--root <dir>", "Project root directory").option("--content <dir>", "Content directory relative to root").option("--output <dir>", "Build output directory relative to root");
@@ -185,15 +347,15 @@ function resolveOptions(options) {
 }
 async function main() {
 	const cli = (0, cac.cac)("clarify");
-	cli.version(readPackageVersion()).help();
+	cli.version(cliPackageVersion).help();
 	withSharedOptions(cli.command("dev", "Start the local documentation server")).option("--host [host]", "Dev server host").option("--port <port>", "Dev server port").option("--open [path]", "Open the dev server in a browser").action(async (options) => {
 		await runDev(resolveOptions(options));
 	});
 	withSharedOptions(cli.command("build", "Build the static documentation site")).action(async (options) => {
 		await runBuild(resolveOptions(options));
 	});
-	withSharedOptions(cli.command("init", "Create a minimal Clarify project scaffold")).option("--force", "Overwrite files created by init").action((options) => {
-		runInit(resolveOptions(options), options.force === true);
+	withSharedOptions(cli.command("init", "Create a Clarify project scaffold")).option("--force", "Overwrite files created by init").option("--template <name>", "Template to use: minimal, standard, or complete").action((options) => {
+		runInit(resolveOptions(options), options.force === true, options.template);
 	});
 	const args = process.argv.slice(2);
 	cli.parse(process.argv, { run: false });
@@ -204,7 +366,7 @@ async function main() {
 	await cli.runMatchedCommand();
 }
 main().catch((error) => {
-	console.error(error instanceof Error ? error.message : error);
+	console.error(error instanceof Error ? error.stack ?? error.message : String(error));
 	process.exitCode = 1;
 });
 //#endregion

package/output/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.cjs","names":[],"sources":["../source/core/vite-config.ts","../source/cli/commands/build.ts","../source/cli/commands/dev.ts","../source/cli/commands/init.ts","../source/cli/options.ts","../source/cli/package.ts","../source/cli/index.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\n\nimport type { ConfigEnv, InlineConfig, Plugin } from 'vite'\n\nimport type { ClarifyBuildOptions } from './options.js'\nimport { clarifyPlugin } from './plugin.js'\nimport { createClarifyRuntimeAliases } from './runtime-deps.js'\nimport { loadClarifyConfig } from './user-config.js'\n\nexport type ClarifyViteConfigOptions = {\n  root: string\n  content: string\n  output: string\n  host?: string | boolean\n  port?: number\n  open?: boolean | string\n}\n\nconst DEFAULT_HTML = '<!doctype html><html lang=\"en\"><head><meta charset=\"UTF-8\" /><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" /><title>Clarify</title></head><body><div id=\"root\"></div></body></html>'\n\nfunction ensureHtmlEntry(root: string): string {\n  const projectHtmlPath = resolve(root, 'index.html')\n  if (existsSync(projectHtmlPath)) return projectHtmlPath\n\n  const generatedHtmlPath = resolve(root, '.clarify/index.html')\n  mkdirSync(dirname(generatedHtmlPath), { recursive: true })\n  writeFileSync(generatedHtmlPath, DEFAULT_HTML, 'utf-8')\n  return generatedHtmlPath\n}\n\nfunction createHtmlFallbackPlugin(): Plugin {\n  return {\n    name: 'clarify:cli-html-fallback',\n    configureServer(server) {\n      server.middlewares.use(async (req, res, next) => {\n        const requestPath = req.url?.split('?')[0] ?? '/'\n        const acceptsHtml = req.headers.accept?.includes('text/html') ?? false\n        const hasFileExtension = /\\.[^/]+$/.test(requestPath)\n        if (!acceptsHtml || hasFileExtension) {\n          next()\n          return\n        }\n\n        try {\n          const html = await server.transformIndexHtml(requestPath, DEFAULT_HTML)\n          res.statusCode = 200\n          res.setHeader('Content-Type', 'text/html; charset=utf-8')\n          res.end(html)\n        } catch (error) {\n          next(error)\n        }\n      })\n    },\n  }\n}\n\nexport async function createViteConfig(options: ClarifyViteConfigOptions, env: ConfigEnv): Promise<InlineConfig> {\n  const entryHtmlPath = ensureHtmlEntry(options.root)\n  const userConfig = await loadClarifyConfig(options.root, env)\n  const buildOptions: ClarifyBuildOptions = {\n    ...userConfig,\n    projectRoot: options.root,\n    rootDirectory: options.content,\n    outputDirectory: options.output,\n  }\n\n  return {\n    root: options.root,\n    configFile: false,\n    appType: 'custom',\n    resolve: {\n      alias: createClarifyRuntimeAliases(),\n    },\n    plugins: [\n      clarifyPlugin(buildOptions),\n      createHtmlFallbackPlugin(),\n    ],\n    server: {\n      host: options.host,\n      port: options.port,\n      open: options.open,\n    },\n    build: {\n      outDir: options.output,\n      rolldownOptions: {\n        input: {\n          index: entryHtmlPath,\n        },\n        checks: {\n          pluginTimings: false,\n        },\n        output: {\n          codeSplitting: {\n            groups: [\n              {\n                name: 'react-vendor',\n                test: /node_modules[\\\\/](react|react-dom|react-router|react-router-dom)[\\\\/]/,\n                priority: 40,\n              },\n              {\n                name: 'icons-vendor',\n                test: /node_modules[\\\\/]lucide-react[\\\\/]/,\n                priority: 35,\n              },\n              {\n                name: 'ui-vendor',\n                test: /node_modules[\\\\/](@headlessui|framer-motion)[\\\\/]/,\n                priority: 30,\n              },\n              {\n                name: 'vendor',\n                test: /node_modules[\\\\/]/,\n                priority: 10\n              },\n            ],\n          },\n        },\n      },\n    },\n  }\n}\n","import { build as viteBuild } from 'vite'\n\nimport { createViteConfig } from '../../core/vite-config.js'\nimport type { ResolvedCliOptions } from '../options.js'\n\nexport async function runBuild(options: ResolvedCliOptions): Promise<void> {\n  await viteBuild(await createViteConfig(options, { command: 'build', mode: 'production' }))\n}\n","import { createServer } from 'vite'\n\nimport { createViteConfig } from '../../core/vite-config.js'\nimport type { ResolvedCliOptions } from '../options.js'\n\nexport async function runDev(options: ResolvedCliOptions): Promise<void> {\n  const server = await createServer(await createViteConfig(options, { command: 'serve', mode: 'development' }))\n  await server.listen()\n  server.printUrls()\n  server.bindCLIShortcuts({ print: true })\n}\n","import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\n\nimport type { ResolvedCliOptions } from '../options.js'\n\nfunction writeTextFile(filePath: string, content: string, force: boolean): boolean {\n  if (existsSync(filePath) && !force) return false\n  mkdirSync(dirname(filePath), { recursive: true })\n  writeFileSync(filePath, content, 'utf-8')\n  return true\n}\n\nfunction updatePackageJson(root: string, force: boolean): boolean {\n  const packageJsonPath = resolve(root, 'package.json')\n  const packageJson = existsSync(packageJsonPath)\n    ? JSON.parse(readFileSync(packageJsonPath, 'utf-8')) as Record<string, unknown>\n    : { type: 'module' }\n\n  const scripts = typeof packageJson.scripts === 'object' && packageJson.scripts !== null\n    ? packageJson.scripts as Record<string, string>\n    : {}\n\n  if (force || !scripts.dev) scripts.dev = 'clarify dev'\n  if (force || !scripts.build) scripts.build = 'clarify build'\n  packageJson.scripts = scripts\n\n  const devDependencies = typeof packageJson.devDependencies === 'object' && packageJson.devDependencies !== null\n    ? packageJson.devDependencies as Record<string, string>\n    : {}\n  if (!devDependencies['@clarify-labs/cli']) devDependencies['@clarify-labs/cli'] = '^0.2.0'\n  packageJson.devDependencies = devDependencies\n\n  writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`, 'utf-8')\n  return true\n}\n\nexport function runInit(options: ResolvedCliOptions, force: boolean): void {\n  const created: string[] = []\n  const skipped: string[] = []\n\n  const clarifyConfigCreated = writeTextFile(resolve(options.root, 'clarify.ts'), `import { defineConfig } from '@clarify-labs/cli'\n\nexport default defineConfig({\n  title: 'Clarify Docs',\n  description: 'Documentation powered by Clarify',\n  theme: { preset: 'default' },\n})\n`, force)\n  ;(clarifyConfigCreated ? created : skipped).push('clarify.ts')\n\n  const contentCreated = writeTextFile(resolve(options.root, options.content, 'index.mdx'), `---\ntitle: Welcome\n---\n\n# Welcome to Clarify\n\nStart writing your documentation in \\`${options.content}\\`.\n`, force)\n  ;(contentCreated ? created : skipped).push(`${options.content}/index.mdx`)\n\n  const packageJsonUpdated = updatePackageJson(options.root, force)\n  if (packageJsonUpdated) created.push('package.json')\n\n  console.log('[clarify] Init complete.')\n  if (created.length > 0) console.log(`[clarify] Created or updated: ${created.join(', ')}`)\n  if (skipped.length > 0) console.log(`[clarify] Skipped existing files: ${skipped.join(', ')}. Use --force to overwrite.`)\n}\n","import { resolve } from 'node:path'\n\nexport type CliOptions = {\n  root?: string\n  content?: string\n  output?: string\n  host?: string | boolean\n  port?: string | number\n  open?: boolean | string\n}\n\nexport type ResolvedCliOptions = {\n  root: string\n  content: string\n  output: string\n  host?: string | boolean\n  port?: number\n  open?: boolean | string\n}\n\nexport function resolveCliOptions(options: CliOptions): ResolvedCliOptions {\n  return {\n    root: resolve(options.root ?? process.cwd()),\n    content: options.content ?? 'source',\n    output: options.output ?? 'output',\n    host: options.host,\n    port: typeof options.port === 'string' ? Number.parseInt(options.port, 10) : options.port,\n    open: options.open,\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nexport function readPackageVersion(): string {\n  try {\n    const packageJsonPath = resolve(dirname(fileURLToPath(import.meta.url)), '../package.json')\n    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8')) as { version?: string }\n    return packageJson.version ?? '0.0.0'\n  } catch {\n    return '0.0.0'\n  }\n}\n","#!/usr/bin/env node\nimport { cac } from 'cac'\n\nimport { runBuild } from './commands/build.js'\nimport { runDev } from './commands/dev.js'\nimport { runInit } from './commands/init.js'\nimport { resolveCliOptions, type CliOptions, type ResolvedCliOptions } from './options.js'\nimport { readPackageVersion } from './package.js'\n\nfunction withSharedOptions(command: ReturnType<ReturnType<typeof cac>['command']>) {\n  return command\n    .option('--root <dir>', 'Project root directory')\n    .option('--content <dir>', 'Content directory relative to root')\n    .option('--output <dir>', 'Build output directory relative to root')\n}\n\nfunction resolveOptions(options: CliOptions): ResolvedCliOptions {\n  return resolveCliOptions(options)\n}\n\nasync function main(): Promise<void> {\n  const cli = cac('clarify')\n\n  cli\n    .version(readPackageVersion())\n    .help()\n\n  withSharedOptions(cli.command('dev', 'Start the local documentation server'))\n    .option('--host [host]', 'Dev server host')\n    .option('--port <port>', 'Dev server port')\n    .option('--open [path]', 'Open the dev server in a browser')\n    .action(async (options: CliOptions) => {\n      await runDev(resolveOptions(options))\n    })\n\n  withSharedOptions(cli.command('build', 'Build the static documentation site'))\n    .action(async (options: CliOptions) => {\n      await runBuild(resolveOptions(options))\n    })\n\n  withSharedOptions(cli.command('init', 'Create a minimal Clarify project scaffold'))\n    .option('--force', 'Overwrite files created by init')\n    .action((options: CliOptions & { force?: boolean }) => {\n      runInit(resolveOptions(options), options.force === true)\n    })\n\n  const args = process.argv.slice(2)\n  cli.parse(process.argv, { run: false })\n\n  if (args.length === 0) {\n    cli.outputHelp()\n    return\n  }\n\n  await cli.runMatchedCommand()\n}\n\nmain().catch(error => {\n  console.error(error instanceof Error ? error.message : error)\n  process.exitCode = 1\n})\n"],"mappings":"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"}
+{"version":3,"file":"cli.cjs","names":[],"sources":["../source/core/log.ts","../source/core/vite-config.ts","../source/cli/commands/build.ts","../source/cli/commands/dev.ts","../package.json","../source/cli/package.ts","../source/cli/commands/init.ts","../source/cli/options.ts","../source/cli/index.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { readFile, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\n\nconst LOG_FILE_NAME = '.clarify.log'\nconst DEFAULT_LOG_ENTRIES = 50\nconst ENTRY_SEPARATOR = '\\n\\n---\\n\\n'\n\nfunction getMaxLogEntries(): number {\n  const envValue = process.env.CLARIFY_LOG_MAX_ENTRIES\n  if (!envValue) return DEFAULT_LOG_ENTRIES\n  const parsed = Number(envValue)\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_LOG_ENTRIES\n}\n\nfunction normalizeErrorMessage(error: unknown): string {\n  if (error === undefined) return 'undefined'\n  if (error === null) return 'null'\n  if (error instanceof Error) return error.message\n  if (typeof error === 'object') {\n    if ('message' in error && typeof (error as { message?: unknown }).message === 'string') {\n      return (error as { message: string }).message\n    }\n    try {\n      return JSON.stringify(error)\n    } catch {\n      return String(error)\n    }\n  }\n  return String(error)\n}\n\nfunction normalizeErrorStack(error: unknown): string | undefined {\n  if (error instanceof Error) {\n    return error.stack\n  }\n  return undefined\n}\n\nfunction formatLogEntry(root: string, error: unknown): string {\n  const timestamp = new Date().toISOString()\n  const message = normalizeErrorMessage(error)\n  const stack = normalizeErrorStack(error)\n\n  return [`=== Clarify build error ===`, `Timestamp: ${timestamp}`, `Project root: ${root}`, `Error: ${message}`, stack ? `Stack:\\n${stack}` : undefined]\n    .filter(Boolean)\n    .join('\\n')\n}\n\nexport async function logBuildError(root: string, error: unknown, maxEntries?: number): Promise<void> {\n  const logPath = join(root, LOG_FILE_NAME)\n  const entry = formatLogEntry(root, error)\n  const max = maxEntries ?? getMaxLogEntries()\n\n  let entries: string[] = []\n  if (existsSync(logPath)) {\n    try {\n      const content = await readFile(logPath, 'utf8')\n      entries = content\n        .split(ENTRY_SEPARATOR)\n        .map((item) => item.trim())\n        .filter(Boolean)\n    } catch {\n      entries = []\n    }\n  }\n\n  entries.push(entry)\n  if (entries.length > max) {\n    entries = entries.slice(-max)\n  }\n\n  mkdirSync(dirname(logPath), { recursive: true })\n  await writeFile(logPath, entries.join(ENTRY_SEPARATOR) + '\\n', 'utf8')\n}\n\nexport function logBuildErrorSync(root: string, error: unknown, maxEntries?: number): void {\n  const logPath = join(root, LOG_FILE_NAME)\n  const entry = formatLogEntry(root, error)\n  const max = maxEntries ?? getMaxLogEntries()\n\n  let entries: string[] = []\n  if (existsSync(logPath)) {\n    try {\n      const content = readFileSync(logPath, 'utf8')\n      entries = content\n        .split(ENTRY_SEPARATOR)\n        .map((item) => item.trim())\n        .filter(Boolean)\n    } catch {\n      entries = []\n    }\n  }\n\n  entries.push(entry)\n  if (entries.length > max) {\n    entries = entries.slice(-max)\n  }\n\n  mkdirSync(dirname(logPath), { recursive: true })\n  writeFileSync(logPath, entries.join(ENTRY_SEPARATOR) + '\\n', 'utf8')\n}\n","import { existsSync, mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\n\nimport { createLogger } from 'vite'\nimport type { ConfigEnv, InlineConfig, Plugin, LogLevel, Logger, LogOptions, LogErrorOptions, LogType } from 'vite'\n\nimport { logBuildErrorSync } from './log.js'\nimport type { ClarifyBuildOptions } from './options.js'\nimport { clarifyPlugin } from './plugin.js'\nimport { createClarifyRuntimeAliases } from './runtime-deps.js'\nimport { loadClarifyConfig } from './user-config.js'\n\nexport type ClarifyViteConfigOptions = {\n  root: string\n  content: string\n  output: string\n  host?: string | boolean\n  port?: number\n  open?: boolean | string\n}\n\nconst DEFAULT_HTML = '<!doctype html><html lang=\"en\"><head><meta charset=\"UTF-8\" /><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" /><title>Clarify</title></head><body><div id=\"root\"></div></body></html>'\n\nfunction ensureHtmlEntry(root: string): string {\n  const projectHtmlPath = resolve(root, 'index.html')\n  if (existsSync(projectHtmlPath)) return projectHtmlPath\n\n  const generatedHtmlPath = resolve(root, '.clarify/index.html')\n  mkdirSync(dirname(generatedHtmlPath), { recursive: true })\n  writeFileSync(generatedHtmlPath, DEFAULT_HTML, 'utf-8')\n  return generatedHtmlPath\n}\n\nfunction createClarifyLogger(root: string, env: ConfigEnv, level: LogLevel): Logger | undefined {\n  if (env.command !== 'build') return undefined\n\n  const baseLogger = createLogger(level, { allowClearScreen: true })\n\n  return {\n    info(msg: string, options?: LogOptions) {\n      baseLogger.info(msg, options)\n    },\n    warn(msg: string, options?: LogOptions) {\n      baseLogger.warn(msg, options)\n    },\n    warnOnce(msg: string, options?: LogOptions) {\n      baseLogger.warnOnce(msg, options)\n    },\n    error(msg: string, options?: LogErrorOptions) {\n      baseLogger.error(msg, options)\n      if (options?.error) {\n        logBuildErrorSync(root, options.error)\n      } else {\n        logBuildErrorSync(root, typeof msg === 'string' ? new Error(msg) : msg)\n      }\n    },\n    clearScreen(type: LogType) {\n      baseLogger.clearScreen(type)\n    },\n    hasErrorLogged(error: Error | unknown) {\n      return baseLogger.hasErrorLogged(error as Error)\n    },\n    get hasWarned() {\n      return baseLogger.hasWarned\n    },\n  }\n}\n\nfunction createHtmlFallbackPlugin(): Plugin {\n  return {\n    name: 'clarify:cli-html-fallback',\n    configureServer(server) {\n      server.middlewares.use(async (req, res, next) => {\n        const requestPath = req.url?.split('?')[0] ?? '/'\n        const acceptsHtml = req.headers.accept?.includes('text/html') ?? false\n        const hasFileExtension = /\\.[^/]+$/.test(requestPath)\n        if (!acceptsHtml || hasFileExtension) {\n          next()\n          return\n        }\n\n        try {\n          const html = await server.transformIndexHtml(requestPath, DEFAULT_HTML)\n          res.statusCode = 200\n          res.setHeader('Content-Type', 'text/html; charset=utf-8')\n          res.end(html)\n        } catch (error) {\n          next(error)\n        }\n      })\n    },\n  }\n}\n\nexport async function createViteConfig(options: ClarifyViteConfigOptions, env: ConfigEnv): Promise<InlineConfig> {\n  const entryHtmlPath = ensureHtmlEntry(options.root)\n  const userConfig = await loadClarifyConfig(options.root, env)\n  const buildOptions: ClarifyBuildOptions = {\n    ...userConfig,\n    projectRoot: options.root,\n    rootDirectory: options.content,\n    outputDirectory: options.output,\n  }\n\n  return {\n    root: options.root,\n    configFile: false,\n    appType: 'custom',\n    resolve: {\n      alias: createClarifyRuntimeAliases(),\n    },\n    customLogger: createClarifyLogger(options.root, env, 'info'),\n    plugins: [\n      clarifyPlugin(buildOptions),\n      createHtmlFallbackPlugin(),\n    ],\n    server: {\n      host: options.host,\n      port: options.port,\n      open: options.open,\n    },\n    build: {\n      outDir: options.output,\n      rolldownOptions: {\n        input: {\n          index: entryHtmlPath,\n        },\n        checks: {\n          pluginTimings: false,\n        },\n        output: {\n          codeSplitting: {\n            groups: [\n              {\n                name: 'react-vendor',\n                test: /node_modules[\\\\/](react|react-dom|react-router|react-router-dom)[\\\\/]/,\n                priority: 40,\n              },\n              {\n                name: 'icons-vendor',\n                test: /node_modules[\\\\/]lucide-react[\\\\/]/,\n                priority: 35,\n              },\n              {\n                name: 'ui-vendor',\n                test: /node_modules[\\\\/](@headlessui|framer-motion)[\\\\/]/,\n                priority: 30,\n              },\n              {\n                name: 'vendor',\n                test: /node_modules[\\\\/]/,\n                priority: 10\n              },\n            ],\n          },\n        },\n      },\n    },\n  }\n}\n","import { build as viteBuild } from 'vite'\n\nimport { logBuildError } from '../../core/log.js'\nimport { createViteConfig } from '../../core/vite-config.js'\nimport type { ResolvedCliOptions } from '../options.js'\n\nexport async function runBuild(options: ResolvedCliOptions): Promise<void> {\n  try {\n    await viteBuild(await createViteConfig(options, { command: 'build', mode: 'production' }))\n  } catch (error) {\n    await logBuildError(options.root, error)\n    throw error\n  }\n}\n","import { createServer } from 'vite'\n\nimport { createViteConfig } from '../../core/vite-config.js'\nimport type { ResolvedCliOptions } from '../options.js'\n\nexport async function runDev(options: ResolvedCliOptions): Promise<void> {\n  const server = await createServer(await createViteConfig(options, { command: 'serve', mode: 'development' }))\n  await server.listen()\n  server.printUrls()\n  server.bindCLIShortcuts({ print: true })\n}\n","{\n  \"name\": \"@clarify-labs/cli\",\n  \"version\": \"0.5.0\",\n  \"license\": \"AGPL-3.0-only\",\n  \"type\": \"module\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/taicode-labs/clarify\",\n    \"directory\": \"packages/cli\"\n  },\n  \"main\": \"output/index.cjs\",\n  \"module\": \"output/index.js\",\n  \"types\": \"output/index.d.ts\",\n  \"bin\": {\n    \"clarify\": \"bin/clarify.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./output/index.d.ts\",\n      \"import\": \"./output/index.js\",\n      \"require\": \"./output/index.cjs\",\n      \"default\": \"./output/index.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"LICENSE\",\n    \"bin\",\n    \"output\"\n  ],\n  \"scripts\": {\n    \"dev\": \"vite build --watch\",\n    \"build\": \"vite build\",\n    \"lint\": \"eslint source/\",\n    \"lint:fix\": \"eslint source/ --fix\",\n    \"typecheck\": \"tsc -p tsconfig.json --noEmit\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\"\n  },\n  \"dependencies\": {\n    \"@apidevtools/swagger-parser\": \"^12.1.0\",\n    \"@clarify-labs/renderer\": \"workspace:*\",\n    \"@clarify-labs/templates\": \"workspace:*\",\n    \"@mdx-js/rollup\": \"^3.1.1\",\n    \"@tailwindcss/vite\": \"^4.1.11\",\n    \"@vitejs/plugin-react\": \"^6.0.2\",\n    \"cac\": \"^7.0.0\",\n    \"github-slugger\": \"^2.0.0\",\n    \"gray-matter\": \"^4.0.3\",\n    \"mdast-util-to-string\": \"^4.0.0\",\n    \"openapi-types\": \"^12.1.3\",\n    \"react\": \"^19.1.0\",\n    \"react-dom\": \"^19.1.0\",\n    \"react-router-dom\": \"^7.0.0\",\n    \"remark\": \"^15.0.1\",\n    \"remark-gfm\": \"^4.0.1\",\n    \"shiki\": \"0.14.7\",\n    \"unist-util-visit\": \"^5.1.0\",\n    \"vite\": \"^8.0.15\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"devDependencies\": {\n    \"@mdx-js/mdx\": \"^3.1.1\",\n    \"typescript\": \"^5.8.3\",\n    \"vite-plugin-dts\": \"^4.5.4\",\n    \"vitest\": \"^4.1.9\"\n  }\n}\n","import packageJson from '../../package.json' with { type: 'json' }\n\nexport const cliPackageJson = packageJson as { version?: string }\nexport const cliPackageVersion = cliPackageJson.version ?? '0.0.0'\nexport const cliPackageVersionWithCaret = `^${cliPackageVersion}`\n\nexport function readPackageVersion(): string {\n  return cliPackageVersion\n}\n","import { existsSync, readFileSync, writeFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { copyTemplateDirectory, getTemplateDirectory, resolveTemplate } from '@clarify-labs/templates'\n\nimport type { ResolvedCliOptions } from '../options.js'\nimport { cliPackageVersionWithCaret } from '../package.js'\n\nconst require = createRequire(import.meta.url)\n\nfunction findTemplatesPackagePath(): string {\n  try {\n    return require.resolve('@clarify-labs/templates/package.json')\n  } catch {\n    const currentDirectory = dirname(fileURLToPath(import.meta.url))\n    const workspacePackagePath = resolve(currentDirectory, '../../../../templates/package.json')\n    if (existsSync(workspacePackagePath)) return workspacePackagePath\n    throw new Error('[clarify] Templates package not found.')\n  }\n}\n\nconst templatesPackagePath = findTemplatesPackagePath()\nconst templatesDirectory = dirname(templatesPackagePath)\n\nfunction updatePackageJson(root: string, force: boolean): boolean {\n  const packageJsonPath = resolve(root, 'package.json')\n  const packageJson = existsSync(packageJsonPath)\n    ? JSON.parse(readFileSync(packageJsonPath, 'utf-8')) as Record<string, unknown>\n    : { type: 'module' }\n\n  const scripts = typeof packageJson.scripts === 'object' && packageJson.scripts !== null\n    ? packageJson.scripts as Record<string, string>\n    : {}\n\n  if (force || !scripts.dev) scripts.dev = 'clarify dev'\n  if (force || !scripts.build) scripts.build = 'clarify build'\n  packageJson.scripts = scripts\n\n  const devDependencies = typeof packageJson.devDependencies === 'object' && packageJson.devDependencies !== null\n    ? packageJson.devDependencies as Record<string, string>\n    : {}\n  if (!devDependencies['@clarify-labs/cli']) devDependencies['@clarify-labs/cli'] = cliPackageVersionWithCaret\n  packageJson.devDependencies = devDependencies\n\n  writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`, 'utf-8')\n  return true\n}\n\nexport function runInit(options: ResolvedCliOptions, force: boolean, template?: string): void {\n  const selectedTemplate = resolveTemplate(template)\n  const templateDirectory = getTemplateDirectory(templatesDirectory, selectedTemplate)\n  const { created } = copyTemplateDirectory(templateDirectory, options.root, {\n    contentDir: options.content,\n    force,\n  })\n\n  const packageJsonUpdated = updatePackageJson(options.root, force)\n  if (packageJsonUpdated) created.push('package.json')\n\n  console.log(`[clarify] Init complete with ${selectedTemplate} template.`)\n  if (created.length > 0) console.log(`[clarify] Created or updated: ${created.join(', ')}`)\n}\n","import { resolve } from 'node:path'\n\nexport type CliOptions = {\n  root?: string\n  content?: string\n  output?: string\n  host?: string | boolean\n  port?: string | number\n  open?: boolean | string\n}\n\nexport type ResolvedCliOptions = {\n  root: string\n  content: string\n  output: string\n  host?: string | boolean\n  port?: number\n  open?: boolean | string\n}\n\nfunction resolvePort(port: CliOptions['port']): number | undefined {\n  if (port === undefined) return undefined\n\n  const parsedPort = typeof port === 'string' ? Number(port) : port\n  if (!Number.isInteger(parsedPort) || parsedPort < 1 || parsedPort > 65535) {\n    throw new Error('[clarify] --port must be an integer between 1 and 65535')\n  }\n\n  return parsedPort\n}\n\nexport function resolveCliOptions(options: CliOptions): ResolvedCliOptions {\n  return {\n    root: resolve(options.root ?? process.cwd()),\n    content: options.content ?? 'source',\n    output: options.output ?? 'output',\n    host: options.host,\n    port: resolvePort(options.port),\n    open: options.open,\n  }\n}\n","#!/usr/bin/env node\nimport { cac } from 'cac'\n\nimport { runBuild } from './commands/build.js'\nimport { runDev } from './commands/dev.js'\nimport { runInit } from './commands/init.js'\nimport { resolveCliOptions, type CliOptions, type ResolvedCliOptions } from './options.js'\nimport { cliPackageVersion } from './package.js'\n\ntype InitCommandOptions = CliOptions & {\n  force?: boolean\n  template?: string\n}\n\nfunction withSharedOptions(command: ReturnType<ReturnType<typeof cac>['command']>) {\n  return command\n    .option('--root <dir>', 'Project root directory')\n    .option('--content <dir>', 'Content directory relative to root')\n    .option('--output <dir>', 'Build output directory relative to root')\n}\n\nfunction resolveOptions(options: CliOptions): ResolvedCliOptions {\n  return resolveCliOptions(options)\n}\n\nasync function main(): Promise<void> {\n  const cli = cac('clarify')\n\n  cli\n    .version(cliPackageVersion)\n    .help()\n\n  withSharedOptions(cli.command('dev', 'Start the local documentation server'))\n    .option('--host [host]', 'Dev server host')\n    .option('--port <port>', 'Dev server port')\n    .option('--open [path]', 'Open the dev server in a browser')\n    .action(async (options: CliOptions) => {\n      await runDev(resolveOptions(options))\n    })\n\n  withSharedOptions(cli.command('build', 'Build the static documentation site'))\n    .action(async (options: CliOptions) => {\n      await runBuild(resolveOptions(options))\n    })\n\n  withSharedOptions(cli.command('init', 'Create a Clarify project scaffold'))\n    .option('--force', 'Overwrite files created by init')\n    .option('--template <name>', 'Template to use: minimal, standard, or complete')\n    .action((options: InitCommandOptions) => {\n      runInit(resolveOptions(options), options.force === true, options.template)\n    })\n\n  const args = process.argv.slice(2)\n  cli.parse(process.argv, { run: false })\n\n  if (args.length === 0) {\n    cli.outputHelp()\n    return\n  }\n\n  await cli.runMatchedCommand()\n}\n\nmain().catch(error => {\n  console.error(error instanceof Error ? error.stack ?? error.message : String(error))\n  process.exitCode = 1\n})\n"],"mappings":"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"}