@raystack/chronicle 0.1.0-canary.111b55a

package/dist/cli/index.js

@@ -0,0 +1,963 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/server/vite-config.ts
+var exports_vite_config = {};
+__export(exports_vite_config, {
+  createViteConfig: () => createViteConfig
+});
+import path5 from "path";
+import react from "@vitejs/plugin-react";
+import mdx from "@mdx-js/rollup";
+import remarkDirective from "remark-directive";
+import remarkGfm from "remark-gfm";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkMdxFrontmatter from "remark-mdx-frontmatter";
+import rehypeShiki from "@shikijs/rehype";
+async function createViteConfig(options) {
+  const { root, contentDir, isDev = false } = options;
+  return {
+    root,
+    configFile: false,
+    resolve: {
+      alias: {
+        "@": path5.resolve(root, "src"),
+        "@content": contentDir
+      },
+      dedupe: ["react", "react-dom", "react/jsx-runtime", "react/jsx-dev-runtime"]
+    },
+    server: {
+      fs: {
+        allow: [root, contentDir]
+      }
+    },
+    plugins: [
+      mdx({
+        remarkPlugins: [
+          remarkFrontmatter,
+          remarkMdxFrontmatter,
+          remarkGfm,
+          remarkDirective
+        ],
+        rehypePlugins: [
+          [rehypeShiki, { themes: { light: "github-light", dark: "github-dark" }, defaultColor: false }]
+        ],
+        mdExtensions: [".md"],
+        mdxExtensions: [".mdx"]
+      }),
+      react()
+    ],
+    define: {
+      "process.env.CHRONICLE_CONTENT_DIR": JSON.stringify(contentDir),
+      "process.env.CHRONICLE_PROJECT_ROOT": JSON.stringify(root)
+    },
+    css: {
+      modules: {
+        localsConvention: "camelCase"
+      }
+    },
+    ssr: {
+      noExternal: ["@raystack/apsara"]
+    },
+    build: {
+      rolldownOptions: {
+        input: isDev ? undefined : {
+          client: path5.resolve(root, "src/server/index.html")
+        }
+      }
+    }
+  };
+}
+var init_vite_config = () => {};
+
+// src/server/dev.ts
+var exports_dev = {};
+__export(exports_dev, {
+  startDevServer: () => startDevServer
+});
+import { createServer as createViteServer } from "vite";
+import { createServer } from "http";
+import fsPromises from "fs/promises";
+import { createReadStream } from "fs";
+import path6 from "path";
+import chalk3 from "chalk";
+async function startDevServer(options) {
+  const { port, root, contentDir } = options;
+  const viteConfig = await createViteConfig({ root, contentDir, isDev: true });
+  const vite = await createViteServer({
+    ...viteConfig,
+    server: { middlewareMode: true },
+    appType: "custom"
+  });
+  const templatePath = path6.resolve(root, "src/server/index.html");
+  const server = createServer(async (req, res) => {
+    const url = req.url || "/";
+    try {
+      if (url.startsWith("/@") || url.startsWith("/__vite") || url.startsWith("/node_modules/")) {
+        vite.middlewares(req, res, () => {
+          res.statusCode = 404;
+          res.end();
+        });
+        return;
+      }
+      const contentFile = path6.join(contentDir, decodeURIComponent(url.split("?")[0]));
+      if (!url.endsWith(".md") && !url.endsWith(".mdx")) {
+        try {
+          const stat = await fsPromises.stat(contentFile);
+          if (stat.isFile()) {
+            const ext = path6.extname(contentFile).toLowerCase();
+            const mimeTypes = {
+              ".png": "image/png",
+              ".jpg": "image/jpeg",
+              ".jpeg": "image/jpeg",
+              ".gif": "image/gif",
+              ".svg": "image/svg+xml",
+              ".webp": "image/webp",
+              ".ico": "image/x-icon",
+              ".pdf": "application/pdf",
+              ".json": "application/json",
+              ".yaml": "text/yaml",
+              ".yml": "text/yaml",
+              ".txt": "text/plain"
+            };
+            res.setHeader("Content-Type", mimeTypes[ext] || "application/octet-stream");
+            createReadStream(contentFile).pipe(res);
+            return;
+          }
+        } catch {}
+      }
+      if (/\.(js|ts|tsx|css|map)(\?|$)/.test(url)) {
+        vite.middlewares(req, res, () => {
+          res.statusCode = 404;
+          res.end();
+        });
+        return;
+      }
+      const { matchRoute } = await vite.ssrLoadModule(path6.resolve(root, "src/server/router.ts"));
+      const routeHandler = matchRoute(new URL(url, `http://localhost:${port}`).href);
+      if (routeHandler) {
+        const request = new Request(new URL(url, `http://localhost:${port}`));
+        const response = await routeHandler(request);
+        res.statusCode = response.status;
+        response.headers.forEach((value, key) => res.setHeader(key, value));
+        const body = await response.text();
+        res.end(body);
+        return;
+      }
+      const pathname = new URL(url, `http://localhost:${port}`).pathname;
+      const slug = pathname === "/" ? [] : pathname.slice(1).split("/").filter(Boolean);
+      const source = await vite.ssrLoadModule(path6.resolve(root, "src/lib/source.ts"));
+      const { mdxComponents } = await vite.ssrLoadModule(path6.resolve(root, "src/components/mdx/index.tsx"));
+      const { loadConfig } = await vite.ssrLoadModule(path6.resolve(root, "src/lib/config.ts"));
+      const config = loadConfig();
+      const { loadApiSpecs } = await vite.ssrLoadModule(path6.resolve(root, "src/lib/openapi.ts"));
+      const apiSpecs = config.api?.length ? loadApiSpecs(config.api) : [];
+      const [tree, sourcePage] = await Promise.all([
+        source.buildPageTree(),
+        source.getPage(slug)
+      ]);
+      let pageData = null;
+      let embeddedData = { config, tree, slug, frontmatter: null, filePath: null };
+      if (sourcePage) {
+        const component = await source.loadPageComponent(sourcePage);
+        const React = await import("react");
+        const MDXBody = component;
+        pageData = {
+          slug,
+          frontmatter: sourcePage.frontmatter,
+          content: MDXBody ? React.createElement(MDXBody, { components: mdxComponents }) : null
+        };
+        embeddedData.frontmatter = sourcePage.frontmatter;
+        embeddedData.filePath = sourcePage.filePath;
+      }
+      let template = await fsPromises.readFile(templatePath, "utf-8");
+      template = await vite.transformIndexHtml(url, template);
+      const dataScript = `<script>window.__PAGE_DATA__ = ${JSON.stringify(embeddedData)}</script>`;
+      template = template.replace("<!--head-outlet-->", `<!--head-outlet-->${dataScript}`);
+      const { render } = await vite.ssrLoadModule(path6.resolve(root, "src/server/entry-server.tsx"));
+      const html = render(url, { config, tree, page: pageData, apiSpecs });
+      const finalHtml = template.replace("<!--ssr-outlet-->", html);
+      res.setHeader("Content-Type", "text/html");
+      res.statusCode = 200;
+      res.end(finalHtml);
+    } catch (e) {
+      vite.ssrFixStacktrace(e);
+      console.error(e);
+      res.statusCode = 500;
+      res.end(e.message);
+    }
+  });
+  server.listen(port, () => {
+    console.log(chalk3.cyan(`
+  Chronicle dev server running at:`));
+    console.log(chalk3.green(`  http://localhost:${port}
+`));
+  });
+  const shutdown = () => {
+    vite.close();
+    server.close();
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+  return { server, vite };
+}
+var init_dev = __esm(() => {
+  init_vite_config();
+});
+
+// src/lib/config.ts
+import fs3 from "fs";
+import path7 from "path";
+import { parse as parse2 } from "yaml";
+function resolveConfigPath() {
+  const projectRoot = process.env.CHRONICLE_PROJECT_ROOT;
+  if (projectRoot) {
+    const rootPath = path7.join(projectRoot, CONFIG_FILE);
+    if (fs3.existsSync(rootPath))
+      return rootPath;
+  }
+  const cwdPath = path7.join(process.cwd(), CONFIG_FILE);
+  if (fs3.existsSync(cwdPath))
+    return cwdPath;
+  const contentDir = process.env.CHRONICLE_CONTENT_DIR;
+  if (contentDir) {
+    const contentPath = path7.join(contentDir, CONFIG_FILE);
+    if (fs3.existsSync(contentPath))
+      return contentPath;
+  }
+  return null;
+}
+function loadConfig() {
+  const configPath = resolveConfigPath();
+  if (!configPath) {
+    return defaultConfig;
+  }
+  const raw = fs3.readFileSync(configPath, "utf-8");
+  const userConfig = parse2(raw);
+  return {
+    ...defaultConfig,
+    ...userConfig,
+    theme: {
+      name: userConfig.theme?.name ?? defaultConfig.theme.name,
+      colors: { ...defaultConfig.theme?.colors, ...userConfig.theme?.colors }
+    },
+    search: { ...defaultConfig.search, ...userConfig.search },
+    footer: userConfig.footer,
+    api: userConfig.api,
+    llms: { enabled: false, ...userConfig.llms },
+    analytics: { enabled: false, ...userConfig.analytics }
+  };
+}
+var CONFIG_FILE = "chronicle.yaml", defaultConfig;
+var init_config = __esm(() => {
+  defaultConfig = {
+    title: "Documentation",
+    theme: { name: "default" },
+    search: { enabled: true, placeholder: "Search..." }
+  };
+});
+// src/lib/openapi.ts
+import fs4 from "fs";
+import path8 from "path";
+import { parse as parseYaml } from "yaml";
+function loadApiSpecs(apiConfigs) {
+  const contentDir = process.env.CHRONICLE_CONTENT_DIR ?? process.cwd();
+  return apiConfigs.map((config) => loadApiSpec(config, contentDir));
+}
+function loadApiSpec(config, contentDir) {
+  const specPath = path8.resolve(contentDir, config.spec);
+  const raw = fs4.readFileSync(specPath, "utf-8");
+  const isYaml = specPath.endsWith(".yaml") || specPath.endsWith(".yml");
+  const doc = isYaml ? parseYaml(raw) : JSON.parse(raw);
+  let v3Doc;
+  if ("swagger" in doc && doc.swagger === "2.0") {
+    v3Doc = convertV2toV3(doc);
+  } else if ("openapi" in doc && doc.openapi.startsWith("3.")) {
+    v3Doc = resolveDocument(doc);
+  } else {
+    throw new Error(`Unsupported spec version in ${config.spec}`);
+  }
+  return {
+    name: config.name,
+    basePath: config.basePath,
+    server: config.server,
+    auth: config.auth,
+    document: v3Doc
+  };
+}
+function resolveRef(ref, root) {
+  const parts = ref.replace(/^#\//, "").split("/");
+  let current = root;
+  for (const part of parts) {
+    if (current && typeof current === "object" && !Array.isArray(current)) {
+      current = current[part];
+    } else {
+      throw new Error(`Cannot resolve $ref: ${ref}`);
+    }
+  }
+  return current;
+}
+function deepResolveRefs(obj, root, stack = new Set, cache = new Map) {
+  if (obj === null || obj === undefined || typeof obj !== "object")
+    return obj;
+  if (Array.isArray(obj)) {
+    return obj.map((item) => deepResolveRefs(item, root, stack, cache));
+  }
+  const record = obj;
+  if (typeof record.$ref === "string") {
+    const ref = record.$ref;
+    if (cache.has(ref))
+      return cache.get(ref);
+    if (stack.has(ref))
+      return { type: "object", description: "[circular]" };
+    stack.add(ref);
+    const resolved = deepResolveRefs(resolveRef(ref, root), root, stack, cache);
+    stack.delete(ref);
+    cache.set(ref, resolved);
+    return resolved;
+  }
+  const result = {};
+  for (const [key, value] of Object.entries(record)) {
+    result[key] = deepResolveRefs(value, root, stack, cache);
+  }
+  return result;
+}
+function resolveDocument(doc) {
+  const root = doc;
+  return deepResolveRefs(doc, root);
+}
+function convertV2toV3(doc) {
+  const root = doc;
+  const resolved = deepResolveRefs(doc, root);
+  const v3Paths = {};
+  for (const [pathStr, pathItem] of Object.entries(resolved.paths ?? {})) {
+    if (!pathItem)
+      continue;
+    const v3PathItem = {};
+    for (const method of ["get", "post", "put", "delete", "patch"]) {
+      const op = pathItem[method];
+      if (!op)
+        continue;
+      v3PathItem[method] = convertV2Operation(op);
+    }
+    v3Paths[pathStr] = v3PathItem;
+  }
+  return {
+    openapi: "3.0.0",
+    info: resolved.info,
+    paths: v3Paths,
+    tags: resolved.tags ?? []
+  };
+}
+function convertV2Operation(op) {
+  const params = op.parameters ?? [];
+  const v3Params = params.filter((p) => p.in !== "body").map((p) => ({
+    name: p.name,
+    in: p.in,
+    required: p.required ?? false,
+    description: p.description,
+    schema: { type: p.type ?? "string", format: p.format }
+  }));
+  const bodyParam = params.find((p) => p.in === "body");
+  let requestBody;
+  if (bodyParam?.schema) {
+    requestBody = {
+      required: bodyParam.required ?? false,
+      content: {
+        "application/json": {
+          schema: bodyParam.schema
+        }
+      }
+    };
+  }
+  const v3Responses = {};
+  for (const [status, resp] of Object.entries(op.responses ?? {})) {
+    const v2Resp = resp;
+    const v3Resp = {
+      description: v2Resp.description ?? ""
+    };
+    if (v2Resp.schema) {
+      v3Resp.content = {
+        "application/json": {
+          schema: v2Resp.schema
+        }
+      };
+    }
+    v3Responses[status] = v3Resp;
+  }
+  const result = {
+    operationId: op.operationId,
+    summary: op.summary,
+    description: op.description,
+    tags: op.tags,
+    parameters: v3Params,
+    responses: v3Responses
+  };
+  if (requestBody) {
+    result.requestBody = requestBody;
+  }
+  return result;
+}
+var init_openapi = () => {};
+
+// src/lib/api-routes.ts
+import slugify from "slugify";
+function getSpecSlug(spec) {
+  return slugify(spec.name, { lower: true, strict: true });
+}
+var init_api_routes = () => {};
+
+// src/server/build-search-index.ts
+var exports_build_search_index = {};
+__export(exports_build_search_index, {
+  generateSearchIndex: () => generateSearchIndex
+});
+import fs5 from "fs/promises";
+import path9 from "path";
+import matter from "gray-matter";
+function extractHeadings(markdown) {
+  const headingRegex = /^#{1,6}\s+(.+)$/gm;
+  const headings = [];
+  let match;
+  while ((match = headingRegex.exec(markdown)) !== null) {
+    headings.push(match[1].trim());
+  }
+  return headings.join(" ");
+}
+async function scanContent(contentDir) {
+  const docs = [];
+  async function scan(dir, prefix = []) {
+    let entries;
+    try {
+      entries = await fs5.readdir(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules")
+        continue;
+      const fullPath = path9.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await scan(fullPath, [...prefix, entry.name]);
+        continue;
+      }
+      if (!entry.name.endsWith(".mdx") && !entry.name.endsWith(".md"))
+        continue;
+      const raw = await fs5.readFile(fullPath, "utf-8");
+      const { data: fm, content } = matter(raw);
+      const baseName = entry.name.replace(/\.(mdx|md)$/, "");
+      const slugs = baseName === "index" ? prefix : [...prefix, baseName];
+      const url = slugs.length === 0 ? "/" : "/" + slugs.join("/");
+      docs.push({
+        id: url,
+        url,
+        title: fm.title ?? baseName,
+        content: extractHeadings(content),
+        type: "page"
+      });
+    }
+  }
+  await scan(contentDir);
+  return docs;
+}
+function buildApiDocs() {
+  const config = loadConfig();
+  if (!config.api?.length)
+    return [];
+  const docs = [];
+  const specs = loadApiSpecs(config.api);
+  for (const spec of specs) {
+    const specSlug = getSpecSlug(spec);
+    const paths = spec.document.paths ?? {};
+    for (const [, pathItem] of Object.entries(paths)) {
+      if (!pathItem)
+        continue;
+      for (const method of ["get", "post", "put", "delete", "patch"]) {
+        const op = pathItem[method];
+        if (!op?.operationId)
+          continue;
+        const url = `/apis/${specSlug}/${encodeURIComponent(op.operationId)}`;
+        docs.push({
+          id: url,
+          url,
+          title: `${method.toUpperCase()} ${op.summary ?? op.operationId}`,
+          content: op.description ?? "",
+          type: "api"
+        });
+      }
+    }
+  }
+  return docs;
+}
+async function generateSearchIndex(contentDir, outDir) {
+  const [contentDocs, apiDocs] = await Promise.all([
+    scanContent(contentDir),
+    Promise.resolve(buildApiDocs())
+  ]);
+  const documents = [...contentDocs, ...apiDocs];
+  const outPath = path9.join(outDir, "search-index.json");
+  await fs5.writeFile(outPath, JSON.stringify(documents));
+  return documents.length;
+}
+var init_build_search_index = __esm(() => {
+  init_config();
+  init_openapi();
+  init_api_routes();
+});
+
+// src/server/adapters/vercel.ts
+var exports_vercel = {};
+__export(exports_vercel, {
+  buildVercelOutput: () => buildVercelOutput
+});
+import path10 from "path";
+import fs6 from "fs/promises";
+import { existsSync } from "fs";
+import chalk5 from "chalk";
+async function buildVercelOutput(options) {
+  const { distDir, contentDir, projectRoot } = options;
+  const outputDir = path10.resolve(projectRoot, ".vercel/output");
+  console.log(chalk5.gray("Generating Vercel output..."));
+  await fs6.rm(outputDir, { recursive: true, force: true });
+  const staticDir = path10.resolve(outputDir, "static");
+  const funcDir = path10.resolve(outputDir, "functions/index.func");
+  await fs6.mkdir(staticDir, { recursive: true });
+  await fs6.mkdir(funcDir, { recursive: true });
+  const clientDir = path10.resolve(distDir, "client");
+  await copyDir(clientDir, staticDir);
+  console.log(chalk5.gray("  Copied client assets to static/"));
+  if (existsSync(contentDir)) {
+    await copyContentAssets(contentDir, staticDir);
+    console.log(chalk5.gray("  Copied content assets to static/"));
+  }
+  const serverDir = path10.resolve(distDir, "server");
+  await copyDir(serverDir, funcDir);
+  console.log(chalk5.gray("  Copied server bundle to functions/"));
+  const templateSrc = path10.resolve(clientDir, "src/server/index.html");
+  await fs6.copyFile(templateSrc, path10.resolve(funcDir, "index.html"));
+  await fs6.writeFile(path10.resolve(funcDir, "package.json"), JSON.stringify({ type: "module" }, null, 2));
+  await fs6.writeFile(path10.resolve(funcDir, ".vc-config.json"), JSON.stringify({
+    runtime: "nodejs24.x",
+    handler: "entry-vercel.js",
+    launcherType: "Nodejs"
+  }, null, 2));
+  await fs6.writeFile(path10.resolve(outputDir, "config.json"), JSON.stringify({
+    version: 3,
+    routes: [
+      { handle: "filesystem" },
+      { src: "/(.*)", dest: "/index" }
+    ]
+  }, null, 2));
+  console.log(chalk5.green("Vercel output generated →"), outputDir);
+}
+async function copyDir(src, dest) {
+  await fs6.mkdir(dest, { recursive: true });
+  const entries = await fs6.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path10.join(src, entry.name);
+    const destPath = path10.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath);
+    } else {
+      await fs6.copyFile(srcPath, destPath);
+    }
+  }
+}
+async function copyContentAssets(contentDir, staticDir) {
+  const entries = await fs6.readdir(contentDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path10.join(contentDir, entry.name);
+    if (entry.isDirectory()) {
+      const destSubDir = path10.join(staticDir, entry.name);
+      await copyContentAssetsRecursive(srcPath, destSubDir);
+    } else {
+      const ext = path10.extname(entry.name).toLowerCase();
+      if (CONTENT_EXTENSIONS.has(ext)) {
+        await fs6.copyFile(srcPath, path10.join(staticDir, entry.name));
+      }
+    }
+  }
+}
+async function copyContentAssetsRecursive(srcDir, destDir) {
+  const entries = await fs6.readdir(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path10.join(srcDir, entry.name);
+    if (entry.isDirectory()) {
+      await copyContentAssetsRecursive(srcPath, path10.join(destDir, entry.name));
+    } else {
+      const ext = path10.extname(entry.name).toLowerCase();
+      if (CONTENT_EXTENSIONS.has(ext)) {
+        await fs6.mkdir(destDir, { recursive: true });
+        await fs6.copyFile(srcPath, path10.join(destDir, entry.name));
+      }
+    }
+  }
+}
+var CONTENT_EXTENSIONS;
+var init_vercel = __esm(() => {
+  CONTENT_EXTENSIONS = new Set([
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".svg",
+    ".webp",
+    ".ico",
+    ".pdf",
+    ".json",
+    ".yaml",
+    ".yml",
+    ".txt"
+  ]);
+});
+
+// src/server/prod.ts
+var exports_prod = {};
+__export(exports_prod, {
+  startProdServer: () => startProdServer
+});
+import path12 from "path";
+import chalk7 from "chalk";
+async function startProdServer(options) {
+  const { port, distDir } = options;
+  const serverEntry = path12.resolve(distDir, "server/entry-prod.js");
+  const { startServer } = await import(serverEntry);
+  console.log(chalk7.cyan("Starting production server..."));
+  return startServer({ port, distDir });
+}
+var init_prod = () => {};
+
+// src/cli/index.ts
+import { Command as Command6 } from "commander";
+
+// src/cli/commands/init.ts
+import { Command } from "commander";
+import { execSync } from "child_process";
+import fs2 from "fs";
+import path3 from "path";
+import chalk from "chalk";
+import { stringify } from "yaml";
+
+// src/cli/utils/scaffold.ts
+import fs from "fs";
+import path2 from "path";
+
+// src/cli/utils/resolve.ts
+import path from "path";
+import { fileURLToPath } from "url";
+var PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+
+// src/cli/utils/scaffold.ts
+function detectPackageManager() {
+  if (process.env.npm_config_user_agent) {
+    return process.env.npm_config_user_agent.split("/")[0];
+  }
+  const cwd = process.cwd();
+  if (fs.existsSync(path2.join(cwd, "bun.lock")) || fs.existsSync(path2.join(cwd, "bun.lockb")))
+    return "bun";
+  if (fs.existsSync(path2.join(cwd, "pnpm-lock.yaml")))
+    return "pnpm";
+  if (fs.existsSync(path2.join(cwd, "yarn.lock")))
+    return "yarn";
+  return "npm";
+}
+function getChronicleVersion() {
+  const pkgPath = path2.join(PACKAGE_ROOT, "package.json");
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+  return pkg.version;
+}
+
+// src/cli/commands/init.ts
+function createConfig() {
+  return {
+    title: "My Documentation",
+    description: "Documentation powered by Chronicle",
+    theme: { name: "default" },
+    search: { enabled: true, placeholder: "Search documentation..." }
+  };
+}
+function createPackageJson(name) {
+  return {
+    name,
+    private: true,
+    type: "module",
+    scripts: {
+      dev: "chronicle dev",
+      build: "chronicle build",
+      start: "chronicle start"
+    },
+    dependencies: {
+      "@raystack/chronicle": `^${getChronicleVersion()}`
+    },
+    devDependencies: {
+      "@raystack/tools-config": "0.56.0",
+      "openapi-types": "^12.1.3",
+      typescript: "5.9.3",
+      "@types/react": "^19.2.10",
+      "@types/node": "^25.1.0"
+    }
+  };
+}
+var sampleMdx = `---
+title: Welcome
+description: Getting started with your documentation
+order: 1
+---
+
+# Welcome
+
+This is your documentation home page.
+`;
+var initCommand = new Command("init").description("Initialize a new Chronicle project").option("-c, --content <path>", "Content directory name", "content").action((options) => {
+  const projectDir = process.cwd();
+  const dirName = path3.basename(projectDir) || "docs";
+  const contentDir = path3.join(projectDir, options.content);
+  if (!fs2.existsSync(contentDir)) {
+    fs2.mkdirSync(contentDir, { recursive: true });
+    console.log(chalk.green("✓"), "Created", contentDir);
+  }
+  const packageJsonPath = path3.join(projectDir, "package.json");
+  if (!fs2.existsSync(packageJsonPath)) {
+    fs2.writeFileSync(packageJsonPath, JSON.stringify(createPackageJson(dirName), null, 2) + `
+`);
+    console.log(chalk.green("✓"), "Created", packageJsonPath);
+  } else {
+    const existing = JSON.parse(fs2.readFileSync(packageJsonPath, "utf-8"));
+    const template = createPackageJson(dirName);
+    let updated = false;
+    if (existing.type !== "module") {
+      existing.type = "module";
+      updated = true;
+    }
+    if (!existing.scripts)
+      existing.scripts = {};
+    for (const [key, value] of Object.entries(template.scripts)) {
+      if (!existing.scripts[key]) {
+        existing.scripts[key] = value;
+        updated = true;
+      }
+    }
+    if (!existing.dependencies)
+      existing.dependencies = {};
+    for (const [key, value] of Object.entries(template.dependencies)) {
+      if (!existing.dependencies[key]) {
+        existing.dependencies[key] = value;
+        updated = true;
+      }
+    }
+    if (!existing.devDependencies)
+      existing.devDependencies = {};
+    for (const [key, value] of Object.entries(template.devDependencies)) {
+      if (!existing.devDependencies[key]) {
+        existing.devDependencies[key] = value;
+        updated = true;
+      }
+    }
+    if (updated) {
+      fs2.writeFileSync(packageJsonPath, JSON.stringify(existing, null, 2) + `
+`);
+      console.log(chalk.green("✓"), "Updated", packageJsonPath);
+    } else {
+      console.log(chalk.yellow("⚠"), packageJsonPath, "already has all required entries");
+    }
+  }
+  const configPath = path3.join(projectDir, "chronicle.yaml");
+  if (!fs2.existsSync(configPath)) {
+    fs2.writeFileSync(configPath, stringify(createConfig()));
+    console.log(chalk.green("✓"), "Created", configPath);
+  } else {
+    console.log(chalk.yellow("⚠"), configPath, "already exists");
+  }
+  const contentFiles = fs2.readdirSync(contentDir);
+  if (contentFiles.length === 0) {
+    const indexPath = path3.join(contentDir, "index.mdx");
+    fs2.writeFileSync(indexPath, sampleMdx);
+    console.log(chalk.green("✓"), "Created", indexPath);
+  }
+  const gitignorePath = path3.join(projectDir, ".gitignore");
+  const gitignoreEntries = ["node_modules", "dist"];
+  if (fs2.existsSync(gitignorePath)) {
+    const existing = fs2.readFileSync(gitignorePath, "utf-8");
+    const missing = gitignoreEntries.filter((e) => !existing.includes(e));
+    if (missing.length > 0) {
+      fs2.appendFileSync(gitignorePath, `
+${missing.join(`
+`)}
+`);
+      console.log(chalk.green("✓"), "Added", missing.join(", "), "to .gitignore");
+    }
+  } else {
+    fs2.writeFileSync(gitignorePath, `${gitignoreEntries.join(`
+`)}
+`);
+    console.log(chalk.green("✓"), "Created .gitignore");
+  }
+  const pm = detectPackageManager();
+  console.log(chalk.cyan(`
+Installing dependencies with ${pm}...`));
+  execSync(`${pm} install`, { cwd: projectDir, stdio: "inherit" });
+  const runCmd = pm === "npm" ? "npx" : pm === "bun" ? "bunx" : `${pm} dlx`;
+  console.log(chalk.green(`
+✓ Chronicle initialized!`));
+  console.log(`
+Run`, chalk.cyan(`${runCmd} chronicle dev`), "to start development server");
+});
+
+// src/cli/commands/dev.ts
+import { Command as Command2 } from "commander";
+import chalk4 from "chalk";
+
+// src/cli/utils/config.ts
+import path4 from "path";
+import { parse } from "yaml";
+import chalk2 from "chalk";
+function resolveContentDir(contentFlag) {
+  if (contentFlag)
+    return path4.resolve(contentFlag);
+  if (process.env.CHRONICLE_CONTENT_DIR)
+    return path4.resolve(process.env.CHRONICLE_CONTENT_DIR);
+  return path4.resolve("content");
+}
+
+// src/cli/commands/dev.ts
+var devCommand = new Command2("dev").description("Start development server").option("-p, --port <port>", "Port number", "3000").option("-c, --content <path>", "Content directory").action(async (options) => {
+  const contentDir = resolveContentDir(options.content);
+  const port = parseInt(options.port, 10);
+  process.env.CHRONICLE_PROJECT_ROOT = process.cwd();
+  process.env.CHRONICLE_CONTENT_DIR = contentDir;
+  console.log(chalk4.cyan("Starting dev server..."));
+  const { startDevServer: startDevServer2 } = await Promise.resolve().then(() => (init_dev(), exports_dev));
+  await startDevServer2({ port, root: PACKAGE_ROOT, contentDir });
+});
+
+// src/cli/commands/build.ts
+import { Command as Command3 } from "commander";
+import path11 from "path";
+import chalk6 from "chalk";
+var buildCommand = new Command3("build").description("Build for production").option("-c, --content <path>", "Content directory").option("-o, --outDir <path>", "Output directory", "dist").option("--adapter <adapter>", "Deploy adapter (vercel)").action(async (options) => {
+  const contentDir = resolveContentDir(options.content);
+  const outDir = path11.resolve(options.outDir);
+  process.env.CHRONICLE_PROJECT_ROOT = process.cwd();
+  process.env.CHRONICLE_CONTENT_DIR = contentDir;
+  console.log(chalk6.cyan("Building for production..."));
+  const { build } = await import("vite");
+  const { createViteConfig: createViteConfig2 } = await Promise.resolve().then(() => (init_vite_config(), exports_vite_config));
+  const baseConfig = await createViteConfig2({ root: PACKAGE_ROOT, contentDir });
+  console.log(chalk6.gray("Building client..."));
+  await build({
+    ...baseConfig,
+    build: {
+      outDir: path11.join(outDir, "client"),
+      ssrManifest: true,
+      rolldownOptions: {
+        input: path11.resolve(PACKAGE_ROOT, "src/server/index.html")
+      }
+    }
+  });
+  const serverEntry = options.adapter === "vercel" ? path11.resolve(PACKAGE_ROOT, "src/server/entry-vercel.ts") : path11.resolve(PACKAGE_ROOT, "src/server/entry-prod.ts");
+  console.log(chalk6.gray("Building server..."));
+  await build({
+    ...baseConfig,
+    ssr: {
+      noExternal: true
+    },
+    build: {
+      outDir: path11.join(outDir, "server"),
+      ssr: serverEntry,
+      target: "node22"
+    }
+  });
+  console.log(chalk6.gray("Building search index..."));
+  const { generateSearchIndex: generateSearchIndex2 } = await Promise.resolve().then(() => (init_build_search_index(), exports_build_search_index));
+  const docCount = await generateSearchIndex2(contentDir, path11.join(outDir, "server"));
+  console.log(chalk6.gray(`  Indexed ${docCount} documents`));
+  console.log(chalk6.green("Build complete →"), outDir);
+  if (options.adapter === "vercel") {
+    const { buildVercelOutput: buildVercelOutput2 } = await Promise.resolve().then(() => (init_vercel(), exports_vercel));
+    await buildVercelOutput2({
+      distDir: outDir,
+      contentDir,
+      projectRoot: process.cwd()
+    });
+  }
+});
+
+// src/cli/commands/start.ts
+import { Command as Command4 } from "commander";
+import path13 from "path";
+import chalk8 from "chalk";
+var startCommand = new Command4("start").description("Start production server").option("-p, --port <port>", "Port number", "3000").option("-c, --content <path>", "Content directory").option("-d, --dist <path>", "Dist directory", "dist").action(async (options) => {
+  const contentDir = resolveContentDir(options.content);
+  const port = parseInt(options.port, 10);
+  const distDir = path13.resolve(options.dist);
+  process.env.CHRONICLE_PROJECT_ROOT = process.cwd();
+  process.env.CHRONICLE_CONTENT_DIR = contentDir;
+  console.log(chalk8.cyan("Starting production server..."));
+  const { startProdServer: startProdServer2 } = await Promise.resolve().then(() => (init_prod(), exports_prod));
+  await startProdServer2({ port, root: PACKAGE_ROOT, distDir });
+});
+
+// src/cli/commands/serve.ts
+import { Command as Command5 } from "commander";
+import path14 from "path";
+import chalk9 from "chalk";
+var serveCommand = new Command5("serve").description("Build and start production server").option("-p, --port <port>", "Port number", "3000").option("-c, --content <path>", "Content directory").option("-o, --outDir <path>", "Output directory", "dist").action(async (options) => {
+  const contentDir = resolveContentDir(options.content);
+  const port = parseInt(options.port, 10);
+  const outDir = path14.resolve(options.outDir);
+  process.env.CHRONICLE_PROJECT_ROOT = process.cwd();
+  process.env.CHRONICLE_CONTENT_DIR = contentDir;
+  console.log(chalk9.cyan("Building for production..."));
+  const { build } = await import("vite");
+  const { createViteConfig: createViteConfig2 } = await Promise.resolve().then(() => (init_vite_config(), exports_vite_config));
+  const baseConfig = await createViteConfig2({ root: PACKAGE_ROOT, contentDir });
+  await build({
+    ...baseConfig,
+    build: {
+      outDir: path14.join(outDir, "client"),
+      ssrManifest: true,
+      rolldownOptions: {
+        input: path14.resolve(PACKAGE_ROOT, "src/server/index.html")
+      }
+    }
+  });
+  await build({
+    ...baseConfig,
+    ssr: {
+      noExternal: true
+    },
+    build: {
+      outDir: path14.join(outDir, "server"),
+      ssr: path14.resolve(PACKAGE_ROOT, "src/server/entry-prod.ts")
+    }
+  });
+  console.log(chalk9.cyan("Starting production server..."));
+  const { startProdServer: startProdServer2 } = await Promise.resolve().then(() => (init_prod(), exports_prod));
+  await startProdServer2({ port, root: PACKAGE_ROOT, distDir: outDir });
+});
+
+// src/cli/index.ts
+var program = new Command6;
+program.name("chronicle").description("Config-driven documentation framework").version("0.1.0");
+program.addCommand(initCommand);
+program.addCommand(devCommand);
+program.addCommand(buildCommand);
+program.addCommand(startCommand);
+program.addCommand(serveCommand);
+program.parse();