@raystack/chronicle 0.1.0-canary.0efaef0

package/bin/chronicle.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli/index.js'

package/dist/cli/index.js

@@ -0,0 +1,276 @@
+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 react from "@vitejs/plugin-react";
+import mdx from "fumadocs-mdx/vite";
+import { nitro } from "nitro/vite";
+import path4 from "node:path";
+async function createViteConfig(options) {
+  const { packageRoot, projectRoot, contentDir, preset } = options;
+  return {
+    root: packageRoot,
+    configFile: false,
+    plugins: [
+      nitro({
+        serverDir: path4.resolve(packageRoot, "src/server"),
+        ...preset && { preset }
+      }),
+      mdx({}, { index: false }),
+      react()
+    ],
+    resolve: {
+      alias: {
+        "@": path4.resolve(packageRoot, "src")
+      },
+      conditions: ["module-sync", "import", "node"],
+      dedupe: [
+        "react",
+        "react-dom",
+        "react/jsx-runtime",
+        "react/jsx-dev-runtime",
+        "react-router"
+      ]
+    },
+    server: {
+      fs: {
+        allow: [packageRoot, projectRoot, contentDir]
+      }
+    },
+    define: {
+      __CHRONICLE_CONTENT_DIR__: JSON.stringify(contentDir),
+      __CHRONICLE_PROJECT_ROOT__: JSON.stringify(projectRoot),
+      __CHRONICLE_PACKAGE_ROOT__: JSON.stringify(packageRoot)
+    },
+    css: {
+      modules: {
+        localsConvention: "camelCase"
+      }
+    },
+    ssr: {
+      noExternal: ["@raystack/apsara", "dayjs", "fumadocs-core"]
+    },
+    environments: {
+      client: {
+        build: {
+          rollupOptions: {
+            input: path4.resolve(packageRoot, "src/server/entry-client.tsx")
+          }
+        }
+      }
+    }
+  };
+}
+var init_vite_config = () => {};
+
+// src/cli/index.ts
+import { Command as Command6 } from "commander";
+
+// src/cli/commands/build.ts
+import chalk2 from "chalk";
+import { Command } from "commander";
+
+// src/cli/utils/config.ts
+import path from "node:path";
+import chalk from "chalk";
+import { parse } from "yaml";
+function resolveContentDir(contentFlag) {
+  if (contentFlag)
+    return path.resolve(contentFlag);
+  return path.resolve("content");
+}
+
+// src/cli/utils/resolve.ts
+import path2 from "path";
+import { fileURLToPath } from "url";
+var PACKAGE_ROOT = path2.resolve(path2.dirname(fileURLToPath(import.meta.url)), "..", "..");
+
+// src/cli/utils/scaffold.ts
+import fs from "node:fs/promises";
+import path3 from "node:path";
+async function linkContent(contentDir) {
+  const linkPath = path3.join(PACKAGE_ROOT, ".content");
+  const target = path3.resolve(contentDir);
+  try {
+    const existing = await fs.readlink(linkPath);
+    if (existing === target)
+      return;
+    await fs.unlink(linkPath);
+  } catch {}
+  await fs.symlink(target, linkPath);
+}
+
+// src/cli/commands/build.ts
+var buildCommand = new Command("build").description("Build for production").option("-c, --content <path>", "Content directory").option("--preset <preset>", "Deploy preset (vercel, cloudflare, node-server)").action(async (options) => {
+  const contentDir = resolveContentDir(options.content);
+  await linkContent(contentDir);
+  console.log(chalk2.cyan("Building for production..."));
+  const { createBuilder } = await import("vite");
+  const { createViteConfig: createViteConfig2 } = await Promise.resolve().then(() => (init_vite_config(), exports_vite_config));
+  const config = await createViteConfig2({
+    packageRoot: PACKAGE_ROOT,
+    projectRoot: process.cwd(),
+    contentDir,
+    preset: options.preset
+  });
+  const builder = await createBuilder({ ...config, builder: {} });
+  await builder.buildApp();
+  console.log(chalk2.green("Build complete"));
+});
+
+// src/cli/commands/dev.ts
+import chalk3 from "chalk";
+import { Command as Command2 } from "commander";
+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);
+  await linkContent(contentDir);
+  console.log(chalk3.cyan("Starting dev server..."));
+  const { createServer } = await import("vite");
+  const { createViteConfig: createViteConfig2 } = await Promise.resolve().then(() => (init_vite_config(), exports_vite_config));
+  const config = await createViteConfig2({ packageRoot: PACKAGE_ROOT, projectRoot: process.cwd(), contentDir });
+  const server = await createServer({
+    ...config,
+    server: { ...config.server, port }
+  });
+  await server.listen();
+  server.printUrls();
+});
+
+// src/cli/commands/init.ts
+import fs2 from "node:fs";
+import path5 from "node:path";
+import chalk4 from "chalk";
+import { Command as Command3 } from "commander";
+import { stringify } from "yaml";
+var defaultConfig = {
+  title: "My Documentation",
+  description: "Documentation powered by Chronicle",
+  theme: { name: "default" },
+  search: { enabled: true, placeholder: "Search documentation..." }
+};
+var sampleMdx = `---
+title: Welcome
+description: Getting started with your documentation
+order: 1
+---
+
+# Welcome
+
+This is your documentation home page.
+`;
+var initCommand = new Command3("init").description("Initialize a new Chronicle project").option("-c, --content <path>", "Content directory name", "content").action((options) => {
+  const projectDir = process.cwd();
+  const contentDir = path5.join(projectDir, options.content);
+  if (!fs2.existsSync(contentDir)) {
+    fs2.mkdirSync(contentDir, { recursive: true });
+    console.log(chalk4.green("✓"), "Created", contentDir);
+  }
+  const configPath = path5.join(projectDir, "chronicle.yaml");
+  if (!fs2.existsSync(configPath)) {
+    fs2.writeFileSync(configPath, stringify(defaultConfig));
+    console.log(chalk4.green("✓"), "Created", configPath);
+  } else {
+    console.log(chalk4.yellow("⚠"), configPath, "already exists");
+  }
+  const contentFiles = fs2.readdirSync(contentDir);
+  if (contentFiles.length === 0) {
+    const indexPath = path5.join(contentDir, "index.mdx");
+    fs2.writeFileSync(indexPath, sampleMdx);
+    console.log(chalk4.green("✓"), "Created", indexPath);
+  }
+  const gitignorePath = path5.join(projectDir, ".gitignore");
+  const gitignoreEntries = ["node_modules", "dist", ".output"];
+  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(chalk4.green("✓"), "Added", missing.join(", "), "to .gitignore");
+    }
+  } else {
+    fs2.writeFileSync(gitignorePath, `${gitignoreEntries.join(`
+`)}
+`);
+    console.log(chalk4.green("✓"), "Created .gitignore");
+  }
+  console.log(chalk4.green(`
+✓ Chronicle initialized!`));
+  console.log(`
+Run`, chalk4.cyan("chronicle dev"), "to start development server");
+});
+
+// src/cli/commands/serve.ts
+import chalk5 from "chalk";
+import { Command as Command4 } from "commander";
+var serveCommand = new Command4("serve").description("Build and start production server").option("-p, --port <port>", "Port number", "3000").option("-c, --content <path>", "Content directory").option("--preset <preset>", "Deploy preset (vercel, cloudflare, node-server)").action(async (options) => {
+  const contentDir = resolveContentDir(options.content);
+  const port = parseInt(options.port, 10);
+  await linkContent(contentDir);
+  const { build, preview } = await import("vite");
+  const { createViteConfig: createViteConfig2 } = await Promise.resolve().then(() => (init_vite_config(), exports_vite_config));
+  const config = await createViteConfig2({
+    packageRoot: PACKAGE_ROOT,
+    projectRoot: process.cwd(),
+    contentDir,
+    preset: options.preset
+  });
+  console.log(chalk5.cyan("Building for production..."));
+  await build(config);
+  console.log(chalk5.cyan("Starting production server..."));
+  const server = await preview({
+    ...config,
+    preview: { port }
+  });
+  server.printUrls();
+});
+
+// src/cli/commands/start.ts
+import chalk6 from "chalk";
+import { Command as Command5 } from "commander";
+var startCommand = new Command5("start").description("Start production 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);
+  await linkContent(contentDir);
+  console.log(chalk6.cyan("Starting production server..."));
+  const { preview } = await import("vite");
+  const { createViteConfig: createViteConfig2 } = await Promise.resolve().then(() => (init_vite_config(), exports_vite_config));
+  const config = await createViteConfig2({ packageRoot: PACKAGE_ROOT, projectRoot: process.cwd(), contentDir });
+  const server = await preview({
+    ...config,
+    preview: { port }
+  });
+  server.printUrls();
+});
+
+// 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();

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@raystack/chronicle",
+  "version": "0.1.0-canary.0efaef0",
+  "description": "Config-driven documentation framework",
+  "license": "Apache-2.0",
+  "type": "module",
+  "files": [
+    "bin",
+    "dist",
+    "src",
+    "templates",
+    "tsconfig.json"
+  ],
+  "bin": {
+    "chronicle": "./bin/chronicle.js"
+  },
+  "scripts": {
+    "build:cli": "bun build-cli.ts",
+    "lint": "biome lint src/"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.13",
+    "@raystack/tools-config": "0.56.0",
+    "@types/lodash": "^4.17.23",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "^25.1.0",
+    "@types/react": "^19.2.10",
+    "@types/react-dom": "^19.2.3",
+    "@types/semver": "^7.7.1",
+    "semver": "^7.7.4",
+    "typescript": "5.9.3"
+  },
+  "dependencies": {
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/state": "^6.5.4",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.39.14",
+    "@heroicons/react": "^2.2.0",
+    "@raystack/apsara": "0.55.1",
+    "@shikijs/rehype": "^4.0.2",
+    "@vitejs/plugin-react": "^6.0.1",
+    "chalk": "^5.6.2",
+    "class-variance-authority": "^0.7.1",
+    "codemirror": "^6.0.2",
+    "commander": "^14.0.2",
+    "fumadocs-core": "16.6.15",
+    "fumadocs-mdx": "^14.2.6",
+    "glob": "^11.0.0",
+    "gray-matter": "^4.0.3",
+    "h3": "^2.0.1-rc.16",
+    "lodash": "^4.17.23",
+    "mermaid": "^11.13.0",
+    "minisearch": "^7.2.0",
+    "nitro": "latest",
+    "openapi-types": "^12.1.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router": "^7.13.1",
+    "remark-directive": "^4.0.0",
+    "remark-parse": "^11.0.0",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-mdx-frontmatter": "^5.2.0",
+    "satori": "^0.25.0",
+    "slugify": "^1.6.6",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0",
+    "vite": "^8.0.0",
+    "yaml": "^2.8.2"
+  }
+}

package/src/cli/commands/build.ts

@@ -0,0 +1,34 @@
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { resolveContentDir } from '@/cli/utils/config';
+import { PACKAGE_ROOT } from '@/cli/utils/resolve';
+import { linkContent } from '@/cli/utils/scaffold';
+
+export const buildCommand = new Command('build')
+  .description('Build for production')
+  .option('-c, --content <path>', 'Content directory')
+  .option(
+    '--preset <preset>',
+    'Deploy preset (vercel, cloudflare, node-server)'
+  )
+  .action(async options => {
+    const contentDir = resolveContentDir(options.content);
+    await linkContent(contentDir);
+
+    console.log(chalk.cyan('Building for production...'));
+
+    const { createBuilder } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
+
+    const config = await createViteConfig({
+      packageRoot: PACKAGE_ROOT,
+      projectRoot: process.cwd(),
+      contentDir,
+      preset: options.preset
+    });
+
+    const builder = await createBuilder({ ...config, builder: {} });
+    await builder.buildApp();
+
+    console.log(chalk.green('Build complete'));
+  });

package/src/cli/commands/dev.ts

@@ -0,0 +1,32 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { resolveContentDir } from '@/cli/utils/config';
+import { PACKAGE_ROOT } from '@/cli/utils/resolve';
+import { linkContent } from '@/cli/utils/scaffold';
+
+export const devCommand = new Command('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);
+
+    await linkContent(contentDir);
+
+    console.log(chalk.cyan('Starting dev server...'));
+
+    const { createServer } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
+
+    const config = await createViteConfig({ packageRoot: PACKAGE_ROOT, projectRoot: process.cwd(), contentDir });
+    const server = await createServer({
+      ...config,
+      server: { ...config.server, port }
+    });
+
+    await server.listen();
+    server.printUrls();
+  });

package/src/cli/commands/init.ts

@@ -0,0 +1,69 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { stringify } from 'yaml';
+import type { ChronicleConfig } from '@/types';
+
+const defaultConfig: ChronicleConfig = {
+  title: 'My Documentation',
+  description: 'Documentation powered by Chronicle',
+  theme: { name: 'default' },
+  search: { enabled: true, placeholder: 'Search documentation...' }
+};
+
+const sampleMdx = `---
+title: Welcome
+description: Getting started with your documentation
+order: 1
+---
+
+# Welcome
+
+This is your documentation home page.
+`;
+
+export const 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 contentDir = path.join(projectDir, options.content);
+
+    if (!fs.existsSync(contentDir)) {
+      fs.mkdirSync(contentDir, { recursive: true });
+      console.log(chalk.green('\u2713'), 'Created', contentDir);
+    }
+
+    const configPath = path.join(projectDir, 'chronicle.yaml');
+    if (!fs.existsSync(configPath)) {
+      fs.writeFileSync(configPath, stringify(defaultConfig));
+      console.log(chalk.green('\u2713'), 'Created', configPath);
+    } else {
+      console.log(chalk.yellow('\u26a0'), configPath, 'already exists');
+    }
+
+    const contentFiles = fs.readdirSync(contentDir);
+    if (contentFiles.length === 0) {
+      const indexPath = path.join(contentDir, 'index.mdx');
+      fs.writeFileSync(indexPath, sampleMdx);
+      console.log(chalk.green('\u2713'), 'Created', indexPath);
+    }
+
+    const gitignorePath = path.join(projectDir, '.gitignore');
+    const gitignoreEntries = ['node_modules', 'dist', '.output'];
+    if (fs.existsSync(gitignorePath)) {
+      const existing = fs.readFileSync(gitignorePath, 'utf-8');
+      const missing = gitignoreEntries.filter(e => !existing.includes(e));
+      if (missing.length > 0) {
+        fs.appendFileSync(gitignorePath, `\n${missing.join('\n')}\n`);
+        console.log(chalk.green('\u2713'), 'Added', missing.join(', '), 'to .gitignore');
+      }
+    } else {
+      fs.writeFileSync(gitignorePath, `${gitignoreEntries.join('\n')}\n`);
+      console.log(chalk.green('\u2713'), 'Created .gitignore');
+    }
+
+    console.log(chalk.green('\n\u2713 Chronicle initialized!'));
+    console.log('\nRun', chalk.cyan('chronicle dev'), 'to start development server');
+  });

package/src/cli/commands/serve.ts

@@ -0,0 +1,40 @@
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { resolveContentDir } from '@/cli/utils/config';
+import { PACKAGE_ROOT } from '@/cli/utils/resolve';
+import { linkContent } from '@/cli/utils/scaffold';
+
+export const serveCommand = new Command('serve')
+  .description('Build and start production server')
+  .option('-p, --port <port>', 'Port number', '3000')
+  .option('-c, --content <path>', 'Content directory')
+  .option(
+    '--preset <preset>',
+    'Deploy preset (vercel, cloudflare, node-server)'
+  )
+  .action(async options => {
+    const contentDir = resolveContentDir(options.content);
+    const port = parseInt(options.port, 10);
+    await linkContent(contentDir);
+
+    const { build, preview } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
+
+    const config = await createViteConfig({
+      packageRoot: PACKAGE_ROOT,
+      projectRoot: process.cwd(),
+      contentDir,
+      preset: options.preset
+    });
+
+    console.log(chalk.cyan('Building for production...'));
+    await build(config);
+
+    console.log(chalk.cyan('Starting production server...'));
+    const server = await preview({
+      ...config,
+      preview: { port }
+    });
+
+    server.printUrls();
+  });

package/src/cli/commands/start.ts

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { resolveContentDir } from '@/cli/utils/config';
+import { PACKAGE_ROOT } from '@/cli/utils/resolve';
+import { linkContent } from '@/cli/utils/scaffold';
+
+export const startCommand = new Command('start')
+  .description('Start production 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);
+    await linkContent(contentDir);
+
+    console.log(chalk.cyan('Starting production server...'));
+
+    const { preview } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
+
+    const config = await createViteConfig({ packageRoot: PACKAGE_ROOT, projectRoot: process.cwd(), contentDir });
+    const server = await preview({
+      ...config,
+      preview: { port }
+    });
+
+    server.printUrls();
+  });

package/src/cli/index.ts

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+import { buildCommand } from './commands/build';
+import { devCommand } from './commands/dev';
+import { initCommand } from './commands/init';
+import { serveCommand } from './commands/serve';
+import { startCommand } from './commands/start';
+
+const program = new Command();
+
+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();

package/src/cli/utils/config.ts

@@ -0,0 +1,42 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { parse } from 'yaml';
+import type { ChronicleConfig } from '@/types';
+
+export interface CLIConfig {
+  config: ChronicleConfig;
+  configPath: string;
+  contentDir: string;
+}
+
+export function resolveContentDir(contentFlag?: string): string {
+  if (contentFlag) return path.resolve(contentFlag);
+  return path.resolve('content');
+}
+
+function resolveConfigPath(contentDir: string): string | null {
+  const cwdPath = path.join(process.cwd(), 'chronicle.yaml');
+  if (fs.existsSync(cwdPath)) return cwdPath;
+  const contentPath = path.join(contentDir, 'chronicle.yaml');
+  if (fs.existsSync(contentPath)) return contentPath;
+  return null;
+}
+
+export function loadCLIConfig(contentDir: string): CLIConfig {
+  const configPath = resolveConfigPath(contentDir);
+
+  if (!configPath) {
+    console.log(
+      chalk.red(
+        `Error: chronicle.yaml not found in '${process.cwd()}' or '${contentDir}'`
+      )
+    );
+    console.log(chalk.gray("Run 'chronicle init' to create one"));
+    process.exit(1);
+  }
+
+  const config = parse(fs.readFileSync(configPath, 'utf-8')) as ChronicleConfig;
+
+  return { config, configPath, contentDir };
+}

package/src/cli/utils/index.ts

@@ -0,0 +1,3 @@
+export * from './config';
+export * from './resolve';
+export * from './scaffold';

package/src/cli/utils/resolve.ts

@@ -0,0 +1,10 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// After bundling: dist/cli/index.js → ../.. = package root
+// After install: node_modules/@raystack/chronicle/dist/cli/index.js → ../.. = package root
+export const PACKAGE_ROOT = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  '..',
+  '..'
+);

package/src/cli/utils/scaffold.ts

@@ -0,0 +1,18 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { PACKAGE_ROOT } from './resolve';
+
+export async function linkContent(contentDir: string): Promise<void> {
+  const linkPath = path.join(PACKAGE_ROOT, '.content');
+  const target = path.resolve(contentDir);
+
+  try {
+    const existing = await fs.readlink(linkPath);
+    if (existing === target) return;
+    await fs.unlink(linkPath);
+  } catch {
+    // link doesn't exist
+  }
+
+  await fs.symlink(target, linkPath);
+}

package/src/components/api/code-snippets.module.css

@@ -0,0 +1,7 @@
+.snippets {
+  width: 100%;
+}
+
+.snippets :global([class*="code-block-module_header"]) {
+  justify-content: space-between;
+}