@clarify-labs/cli 0.1.0

package/output/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/output/cli/options.d.ts

@@ -0,0 +1,17 @@
+export type CliOptions = {
+    root?: string;
+    content?: string;
+    output?: string;
+    host?: string | boolean;
+    port?: string | number;
+    open?: boolean | string;
+};
+export type ResolvedCliOptions = {
+    root: string;
+    content: string;
+    output: string;
+    host?: string | boolean;
+    port?: number;
+    open?: boolean | string;
+};
+export declare function resolveCliOptions(options: CliOptions): ResolvedCliOptions;

package/output/cli/package.d.ts

@@ -0,0 +1 @@
+export declare function readPackageVersion(): string;

package/output/cli.cjs

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+const require_plugin = require("./plugin-CEyCiD5r.cjs");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let node_url = require("node:url");
+let vite = require("vite");
+let cac = require("cac");
+//#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) {
+	const projectHtmlPath = (0, node_path.resolve)(root, "index.html");
+	if ((0, node_fs.existsSync)(projectHtmlPath)) return projectHtmlPath;
+	const generatedHtmlPath = (0, node_path.resolve)(root, ".clarify/index.html");
+	(0, node_fs.mkdirSync)((0, node_path.dirname)(generatedHtmlPath), { recursive: true });
+	(0, node_fs.writeFileSync)(generatedHtmlPath, DEFAULT_HTML, "utf-8");
+	return generatedHtmlPath;
+}
+function createHtmlFallbackPlugin() {
+	return {
+		name: "clarify:cli-html-fallback",
+		configureServer(server) {
+			server.middlewares.use(async (req, res, next) => {
+				const requestPath = req.url?.split("?")[0] ?? "/";
+				const acceptsHtml = req.headers.accept?.includes("text/html") ?? false;
+				const hasFileExtension = /\.[^/]+$/.test(requestPath);
+				if (!acceptsHtml || hasFileExtension) {
+					next();
+					return;
+				}
+				try {
+					const html = await server.transformIndexHtml(requestPath, DEFAULT_HTML);
+					res.statusCode = 200;
+					res.setHeader("Content-Type", "text/html; charset=utf-8");
+					res.end(html);
+				} catch (error) {
+					next(error);
+				}
+			});
+		}
+	};
+}
+async function createViteConfig(options, env) {
+	const entryHtmlPath = ensureHtmlEntry(options.root);
+	const buildOptions = {
+		...await require_plugin.loadClarifyConfig(options.root, env),
+		projectRoot: options.root,
+		rootDirectory: options.content,
+		outputDirectory: options.output
+	};
+	return {
+		root: options.root,
+		configFile: false,
+		appType: "custom",
+		resolve: { alias: require_plugin.createClarifyRuntimeAliases() },
+		plugins: [require_plugin.clarifyPlugin(buildOptions), createHtmlFallbackPlugin()],
+		server: {
+			host: options.host,
+			port: options.port,
+			open: options.open
+		},
+		build: {
+			outDir: options.output,
+			rollupOptions: { input: { index: entryHtmlPath } }
+		}
+	};
+}
+//#endregion
+//#region source/cli/commands/build.ts
+async function runBuild(options) {
+	await (0, vite.build)(await createViteConfig(options, {
+		command: "build",
+		mode: "production"
+	}));
+}
+//#endregion
+//#region source/cli/commands/dev.ts
+async function runDev(options) {
+	const server = await (0, vite.createServer)(await createViteConfig(options, {
+		command: "serve",
+		mode: "development"
+	}));
+	await server.listen();
+	server.printUrls();
+	server.bindCLIShortcuts({ print: true });
+}
+//#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;
+}
+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" };
+	const scripts = typeof packageJson.scripts === "object" && packageJson.scripts !== null ? packageJson.scripts : {};
+	if (force || !scripts.dev) scripts.dev = "clarify dev";
+	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.1.0";
+	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: { primary: '#0ea5e9' },
+})
+`, 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`);
+	if (updatePackageJson(options.root, force)) created.push("package.json");
+	console.log("[clarify] Init complete.");
+	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 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,
+		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");
+}
+function resolveOptions(options) {
+	return resolveCliOptions(options);
+}
+async function main() {
+	const cli = (0, cac.cac)("clarify");
+	cli.version(readPackageVersion()).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);
+	});
+	const args = process.argv.slice(2);
+	cli.parse(process.argv, { run: false });
+	if (args.length === 0) {
+		cli.outputHelp();
+		return;
+	}
+	await cli.runMatchedCommand();
+}
+main().catch((error) => {
+	console.error(error instanceof Error ? error.message : error);
+	process.exitCode = 1;
+});
+//#endregion
+
+//# sourceMappingURL=cli.cjs.map

package/output/cli.cjs.map

@@ -0,0 +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      rollupOptions: {\n        input: {\n          index: entryHtmlPath,\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.1.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: { primary: '#0ea5e9' },\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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"}

package/output/cli.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+import { i as createClarifyRuntimeAliases, r as loadClarifyConfig, t as clarifyPlugin } from "./plugin-BUWojlPv.js";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { build, createServer } from "vite";
+import { cac } from "cac";
+//#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) {
+	const projectHtmlPath = resolve(root, "index.html");
+	if (existsSync(projectHtmlPath)) return projectHtmlPath;
+	const generatedHtmlPath = resolve(root, ".clarify/index.html");
+	mkdirSync(dirname(generatedHtmlPath), { recursive: true });
+	writeFileSync(generatedHtmlPath, DEFAULT_HTML, "utf-8");
+	return generatedHtmlPath;
+}
+function createHtmlFallbackPlugin() {
+	return {
+		name: "clarify:cli-html-fallback",
+		configureServer(server) {
+			server.middlewares.use(async (req, res, next) => {
+				const requestPath = req.url?.split("?")[0] ?? "/";
+				const acceptsHtml = req.headers.accept?.includes("text/html") ?? false;
+				const hasFileExtension = /\.[^/]+$/.test(requestPath);
+				if (!acceptsHtml || hasFileExtension) {
+					next();
+					return;
+				}
+				try {
+					const html = await server.transformIndexHtml(requestPath, DEFAULT_HTML);
+					res.statusCode = 200;
+					res.setHeader("Content-Type", "text/html; charset=utf-8");
+					res.end(html);
+				} catch (error) {
+					next(error);
+				}
+			});
+		}
+	};
+}
+async function createViteConfig(options, env) {
+	const entryHtmlPath = ensureHtmlEntry(options.root);
+	const buildOptions = {
+		...await loadClarifyConfig(options.root, env),
+		projectRoot: options.root,
+		rootDirectory: options.content,
+		outputDirectory: options.output
+	};
+	return {
+		root: options.root,
+		configFile: false,
+		appType: "custom",
+		resolve: { alias: createClarifyRuntimeAliases() },
+		plugins: [clarifyPlugin(buildOptions), createHtmlFallbackPlugin()],
+		server: {
+			host: options.host,
+			port: options.port,
+			open: options.open
+		},
+		build: {
+			outDir: options.output,
+			rollupOptions: { input: { index: entryHtmlPath } }
+		}
+	};
+}
+//#endregion
+//#region source/cli/commands/build.ts
+async function runBuild(options) {
+	await build(await createViteConfig(options, {
+		command: "build",
+		mode: "production"
+	}));
+}
+//#endregion
+//#region source/cli/commands/dev.ts
+async function runDev(options) {
+	const server = await createServer(await createViteConfig(options, {
+		command: "serve",
+		mode: "development"
+	}));
+	await server.listen();
+	server.printUrls();
+	server.bindCLIShortcuts({ print: true });
+}
+//#endregion
+//#region source/cli/commands/init.ts
+function writeTextFile(filePath, content, force) {
+	if (existsSync(filePath) && !force) return false;
+	mkdirSync(dirname(filePath), { recursive: true });
+	writeFileSync(filePath, content, "utf-8");
+	return true;
+}
+function updatePackageJson(root, force) {
+	const packageJsonPath = resolve(root, "package.json");
+	const packageJson = existsSync(packageJsonPath) ? JSON.parse(readFileSync(packageJsonPath, "utf-8")) : { type: "module" };
+	const scripts = typeof packageJson.scripts === "object" && packageJson.scripts !== null ? packageJson.scripts : {};
+	if (force || !scripts.dev) scripts.dev = "clarify dev";
+	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.1.0";
+	packageJson.devDependencies = devDependencies;
+	writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, "utf-8");
+	return true;
+}
+function runInit(options, force) {
+	const created = [];
+	const skipped = [];
+	(writeTextFile(resolve(options.root, "clarify.ts"), `import { defineConfig } from '@clarify-labs/cli'
+
+export default defineConfig({
+  title: 'Clarify Docs',
+  description: 'Documentation powered by Clarify',
+  theme: { primary: '#0ea5e9' },
+})
+`, force) ? created : skipped).push("clarify.ts");
+	(writeTextFile(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`);
+	if (updatePackageJson(options.root, force)) created.push("package.json");
+	console.log("[clarify] Init complete.");
+	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 resolveCliOptions(options) {
+	return {
+		root: 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,
+		open: options.open
+	};
+}
+//#endregion
+//#region source/cli/package.ts
+function readPackageVersion() {
+	try {
+		const packageJsonPath = resolve(dirname(fileURLToPath(import.meta.url)), "../package.json");
+		return JSON.parse(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");
+}
+function resolveOptions(options) {
+	return resolveCliOptions(options);
+}
+async function main() {
+	const cli = cac("clarify");
+	cli.version(readPackageVersion()).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);
+	});
+	const args = process.argv.slice(2);
+	cli.parse(process.argv, { run: false });
+	if (args.length === 0) {
+		cli.outputHelp();
+		return;
+	}
+	await cli.runMatchedCommand();
+}
+main().catch((error) => {
+	console.error(error instanceof Error ? error.message : error);
+	process.exitCode = 1;
+});
+//#endregion
+
+//# sourceMappingURL=cli.js.map

package/output/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","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      rollupOptions: {\n        input: {\n          index: entryHtmlPath,\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.1.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: { primary: '#0ea5e9' },\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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"}

package/output/core/config-schema.d.ts

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+export declare const clarifyLogoConfigSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    light: z.ZodOptional<z.ZodString>;
+    dark: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export declare const clarifyFaviconConfigSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    light: z.ZodOptional<z.ZodString>;
+    dark: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export declare const clarifyLocalizedTextSchema: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+export declare const clarifyLocaleConfigSchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    dir: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"ltr">, z.ZodLiteral<"rtl">]>>;
+}, z.core.$strip>;
+export declare const clarifyI18nConfigSchema: z.ZodObject<{
+    defaultLocale: z.ZodOptional<z.ZodString>;
+    missing: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"fallback">, z.ZodLiteral<"404">, z.ZodLiteral<"hide">]>>;
+    locales: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        dir: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"ltr">, z.ZodLiteral<"rtl">]>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const clarifyNavbarLinkSchema: z.ZodObject<{
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    href: z.ZodString;
+    external: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const clarifyBannerConfigSchema: z.ZodObject<{
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    dismissible: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const clarifyFooterConfigSchema: z.ZodObject<{
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        href: z.ZodString;
+        external: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    socials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    copyright: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+}, z.core.$strip>;
+export declare const clarifyPagesItemSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    page: z.ZodString;
+    title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    icon: z.ZodOptional<z.ZodString>;
+    redirect: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    openapi: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+}, z.core.$strip>]>;
+export declare const clarifyPagesGroupSchema: z.ZodObject<{
+    group: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    icon: z.ZodOptional<z.ZodString>;
+    pages: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        page: z.ZodString;
+        title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        icon: z.ZodOptional<z.ZodString>;
+        redirect: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        openapi: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export declare const clarifyPagesConfigSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    group: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    icon: z.ZodOptional<z.ZodString>;
+    pages: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        page: z.ZodString;
+        title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        icon: z.ZodOptional<z.ZodString>;
+        redirect: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        openapi: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>>, z.ZodLiteral<"FileTree">]>;
+export declare const clarifyProjectConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        light: z.ZodOptional<z.ZodString>;
+        dark: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    favicon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        light: z.ZodOptional<z.ZodString>;
+        dark: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    theme: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    routePrefix: z.ZodOptional<z.ZodString>;
+    navbar: z.ZodOptional<z.ZodObject<{
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+            href: z.ZodString;
+            external: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    banner: z.ZodOptional<z.ZodObject<{
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        dismissible: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    footer: z.ZodOptional<z.ZodObject<{
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+            href: z.ZodString;
+            external: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        socials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        copyright: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    }, z.core.$strip>>;
+    i18n: z.ZodOptional<z.ZodObject<{
+        defaultLocale: z.ZodOptional<z.ZodString>;
+        missing: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"fallback">, z.ZodLiteral<"404">, z.ZodLiteral<"hide">]>>;
+        locales: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+            dir: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"ltr">, z.ZodLiteral<"rtl">]>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    pages: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+        group: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        icon: z.ZodOptional<z.ZodString>;
+        pages: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            page: z.ZodString;
+            title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+            icon: z.ZodOptional<z.ZodString>;
+            redirect: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            openapi: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>, z.ZodLiteral<"FileTree">]>>;
+}, z.core.$strip>;
+export type ClarifyProjectConfigInput = z.input<typeof clarifyProjectConfigSchema>;

package/output/core/config.d.ts

@@ -0,0 +1,3 @@
+import { ClarifyProjectConfig, ResolvedProjectConfig } from '../types.js';
+export declare function validateProjectConfig(value: unknown): ClarifyProjectConfig;
+export declare function resolveProjectConfig(config?: ClarifyProjectConfig): ResolvedProjectConfig;

package/output/core/hooks.d.ts

@@ -0,0 +1,5 @@
+import { ViteDevServer } from 'vite';
+import { ClarifyHookContext, ClarifyHooks, ClarifyPlugin } from '../types.js';
+export declare function runHooks<K extends Exclude<keyof ClarifyHooks, 'build:done' | 'dev:configureServer'>>(plugins: ClarifyPlugin[], hookName: K, input: Parameters<NonNullable<ClarifyHooks[K]>>[0], ctx: ClarifyHookContext): Promise<Parameters<NonNullable<ClarifyHooks[K]>>[0]>;
+export declare function runDevConfigureServerHooks(plugins: ClarifyPlugin[], server: ViteDevServer, ctx: ClarifyHookContext): Promise<void>;
+export declare function runBuildDoneHooks(plugins: ClarifyPlugin[], ctx: ClarifyHookContext): Promise<void>;

package/output/core/options.d.ts

@@ -0,0 +1,24 @@
+import { ClarifyPlugin, ClarifyProjectConfig } from '../types.js';
+export type ClarifyBuildOptions = ClarifyProjectConfig & {
+    /** Project root directory. Defaults to the current working directory. */
+    projectRoot?: string;
+    /** Root directory for MDX content. Default: 'source' */
+    rootDirectory?: string;
+    /** Output directory for the built docs site. When omitted, Vite's build.outDir is used. */
+    outputDirectory?: string;
+    /** Static generation behavior. */
+    ssg?: {
+        /** Fail the build when SSG fails. Default: true. */
+        failOnError?: boolean;
+    };
+    /** Clarify plugin extensions for translation, search, and other build-time features. */
+    plugins?: ClarifyPlugin[];
+};
+export type ResolvedBuildOptions = {
+    rootDirectory: string;
+    outputDirectory?: string;
+    ssg: {
+        failOnError: boolean;
+    };
+};
+export declare function resolveBuildOptions(options?: ClarifyBuildOptions): ResolvedBuildOptions;

package/output/core/plugin.d.ts

@@ -0,0 +1,4 @@
+import { Plugin } from 'vite';
+import { ClarifyBuildOptions } from './options.js';
+export declare function clarifyPlugin(options?: ClarifyBuildOptions): Plugin[];
+export type { Plugin } from 'vite';