@raystack/chronicle 0.1.0-canary.a320792 → 0.1.0-canary.ac60f9f

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raystack/chronicle",
-  "version": "0.1.0-canary.a320792",
+  "version": "0.1.0-canary.ac60f9f",
   "description": "Config-driven documentation framework",
   "license": "Apache-2.0",
   "type": "module",
@@ -15,7 +15,8 @@
     "chronicle": "./bin/chronicle.js"
   },
   "scripts": {
-    "build:cli": "bun build-cli.ts"
+    "build:cli": "bun build-cli.ts",
+    "lint": "biome lint src/"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.13",
@@ -35,32 +36,35 @@
     "@codemirror/theme-one-dark": "^6.1.3",
     "@codemirror/view": "^6.39.14",
     "@heroicons/react": "^2.2.0",
-    "@mdx-js/rollup": "^3.1.1",
-    "@raystack/apsara": "^0.56.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-dom": "^7.13.1",
+    "react-router": "^7.13.1",
     "remark-directive": "^4.0.0",
-    "remark-gfm": "^4.0.1",
-    "@shikijs/rehype": "^4.0.2",
+    "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",
-    "sirv": "^3.0.1",
     "slugify": "^1.6.6",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0",
-    "minisearch": "^7.2.0",
     "vite": "^8.0.0",
     "yaml": "^2.8.2"
   }

package/src/cli/commands/build.ts

@@ -1,52 +1,34 @@
-import { Command } from 'commander'
-import path from 'path'
-import chalk from 'chalk'
-import { resolveContentDir } from '@/cli/utils/config'
-import { PACKAGE_ROOT } from '@/cli/utils/resolve'
+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('-o, --outDir <path>', 'Output directory', 'dist')
-  .action(async (options) => {
-    const contentDir = resolveContentDir(options.content)
-    const outDir = path.resolve(options.outDir)
-
-    process.env.CHRONICLE_PROJECT_ROOT = process.cwd()
-    process.env.CHRONICLE_CONTENT_DIR = contentDir
-
-    console.log(chalk.cyan('Building for production...'))
-
-    const { build } = await import('vite')
-    const { createViteConfig } = await import('@/server/vite-config')
-
-    const baseConfig = await createViteConfig({ root: PACKAGE_ROOT, contentDir })
-
-    // Build client bundle
-    console.log(chalk.gray('Building client...'))
-    await build({
-      ...baseConfig,
-      build: {
-        outDir: path.join(outDir, 'client'),
-        ssrManifest: true,
-        rolldownOptions: {
-          input: path.resolve(PACKAGE_ROOT, 'src/server/index.html'),
-        },
-      },
-    })
-
-    // Build server bundle (noExternal: true to bundle all deps for portability)
-    console.log(chalk.gray('Building server...'))
-    await build({
-      ...baseConfig,
-      ssr: {
-        noExternal: true,
-      },
-      build: {
-        outDir: path.join(outDir, 'server'),
-        ssr: path.resolve(PACKAGE_ROOT, 'src/server/entry-prod.ts'),
-      },
-    })
-
-    console.log(chalk.green('Build complete →'), outDir)
-  })
+  .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

@@ -1,21 +1,32 @@
-import { Command } from 'commander'
-import chalk from 'chalk'
-import { resolveContentDir } from '@/cli/utils/config'
-import { PACKAGE_ROOT } from '@/cli/utils/resolve'
+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)
+  .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
+    await linkContent(contentDir);
 
-    console.log(chalk.cyan('Starting dev server...'))
+    console.log(chalk.cyan('Starting dev server...'));
 
-    const { startDevServer } = await import('@/server/dev')
-    await startDevServer({ port, root: PACKAGE_ROOT, contentDir })
-  })
+    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

@@ -1,43 +1,16 @@
-import { Command } from 'commander'
-import { execSync } from 'child_process'
-import fs from 'fs'
-import path from 'path'
-import chalk from 'chalk'
-import { stringify } from 'yaml'
-import type { ChronicleConfig } from '@/types'
-import { detectPackageManager, getChronicleVersion } from '@/cli/utils/scaffold'
-
-function createConfig(): ChronicleConfig {
-  return {
-    title: 'My Documentation',
-    description: 'Documentation powered by Chronicle',
-    theme: { name: 'default' },
-    search: { enabled: true, placeholder: 'Search documentation...' },
-  }
-}
-
-function createPackageJson(name: string): Record<string, unknown> {
-  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',
-    },
-  }
-}
+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
@@ -48,107 +21,49 @@ 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 dirName = path.basename(projectDir) || 'docs'
-    const contentDir = path.join(projectDir, options.content)
+  .action(options => {
+    const projectDir = process.cwd();
+    const contentDir = path.join(projectDir, options.content);
 
-    // Create content directory
     if (!fs.existsSync(contentDir)) {
-      fs.mkdirSync(contentDir, { recursive: true })
-      console.log(chalk.green('\u2713'), 'Created', contentDir)
-    }
-
-    // Create or update package.json
-    const packageJsonPath = path.join(projectDir, 'package.json')
-    if (!fs.existsSync(packageJsonPath)) {
-      fs.writeFileSync(packageJsonPath, JSON.stringify(createPackageJson(dirName), null, 2) + '\n')
-      console.log(chalk.green('\u2713'), 'Created', packageJsonPath)
-    } else {
-      const existing = JSON.parse(fs.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 as Record<string, string>)) {
-        if (!existing.scripts[key]) {
-          existing.scripts[key] = value
-          updated = true
-        }
-      }
-
-      if (!existing.dependencies) existing.dependencies = {}
-      for (const [key, value] of Object.entries(template.dependencies as Record<string, string>)) {
-        if (!existing.dependencies[key]) {
-          existing.dependencies[key] = value
-          updated = true
-        }
-      }
-
-      if (!existing.devDependencies) existing.devDependencies = {}
-      for (const [key, value] of Object.entries(template.devDependencies as Record<string, string>)) {
-        if (!existing.devDependencies[key]) {
-          existing.devDependencies[key] = value
-          updated = true
-        }
-      }
-
-      if (updated) {
-        fs.writeFileSync(packageJsonPath, JSON.stringify(existing, null, 2) + '\n')
-        console.log(chalk.green('\u2713'), 'Updated', packageJsonPath)
-      } else {
-        console.log(chalk.yellow('\u26a0'), packageJsonPath, 'already has all required entries')
-      }
+      fs.mkdirSync(contentDir, { recursive: true });
+      console.log(chalk.green('\u2713'), 'Created', contentDir);
     }
 
-    // Create chronicle.yaml
-    const configPath = path.join(projectDir, 'chronicle.yaml')
+    const configPath = path.join(projectDir, 'chronicle.yaml');
     if (!fs.existsSync(configPath)) {
-      fs.writeFileSync(configPath, stringify(createConfig()))
-      console.log(chalk.green('\u2713'), 'Created', configPath)
+      fs.writeFileSync(configPath, stringify(defaultConfig));
+      console.log(chalk.green('\u2713'), 'Created', configPath);
     } else {
-      console.log(chalk.yellow('\u26a0'), configPath, 'already exists')
+      console.log(chalk.yellow('\u26a0'), configPath, 'already exists');
     }
 
-    // Create sample index.mdx
-    const contentFiles = fs.readdirSync(contentDir)
+    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 indexPath = path.join(contentDir, 'index.mdx');
+      fs.writeFileSync(indexPath, sampleMdx);
+      console.log(chalk.green('\u2713'), 'Created', indexPath);
     }
 
-    // Update .gitignore
-    const gitignorePath = path.join(projectDir, '.gitignore')
-    const gitignoreEntries = ['node_modules', 'dist']
+    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))
+      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')
+        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')
+      fs.writeFileSync(gitignorePath, `${gitignoreEntries.join('\n')}\n`);
+      console.log(chalk.green('\u2713'), 'Created .gitignore');
     }
 
-    // Install dependencies
-    const pm = detectPackageManager()
-    console.log(chalk.cyan(`\nInstalling dependencies with ${pm}...`))
-    execSync(`${pm} install`, { cwd: projectDir, stdio: 'inherit' })
-
-    const runCmd = pm === 'npm' ? 'npx' : pm === 'bun' ? 'bunx' : `${pm} dlx`
-    console.log(chalk.green('\n\u2713 Chronicle initialized!'))
-    console.log('\nRun', chalk.cyan(`${runCmd} chronicle dev`), 'to start development server')
-  })
+    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

@@ -1,55 +1,40 @@
-import { Command } from 'commander'
-import path from 'path'
-import chalk from 'chalk'
-import { resolveContentDir } from '@/cli/utils/config'
-import { PACKAGE_ROOT } from '@/cli/utils/resolve'
+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('-o, --outDir <path>', 'Output directory', 'dist')
-  .action(async (options) => {
-    const contentDir = resolveContentDir(options.content)
-    const port = parseInt(options.port, 10)
-    const outDir = path.resolve(options.outDir)
-
-    process.env.CHRONICLE_PROJECT_ROOT = process.cwd()
-    process.env.CHRONICLE_CONTENT_DIR = contentDir
-
-    // Build
-    console.log(chalk.cyan('Building for production...'))
-
-    const { build } = await import('vite')
-    const { createViteConfig } = await import('@/server/vite-config')
-
-    const baseConfig = await createViteConfig({ root: PACKAGE_ROOT, contentDir })
-
-    await build({
-      ...baseConfig,
-      build: {
-        outDir: path.join(outDir, 'client'),
-        ssrManifest: true,
-        rolldownOptions: {
-          input: path.resolve(PACKAGE_ROOT, 'src/server/index.html'),
-        },
-      },
-    })
-
-    await build({
-      ...baseConfig,
-      ssr: {
-        noExternal: true,
-      },
-      build: {
-        outDir: path.join(outDir, 'server'),
-        ssr: path.resolve(PACKAGE_ROOT, 'src/server/entry-prod.ts'),
-      },
-    })
-
-    // Start
-    console.log(chalk.cyan('Starting production server...'))
-
-    const { startProdServer } = await import('@/server/prod')
-    await startProdServer({ port, root: PACKAGE_ROOT, distDir: outDir })
-  })
+  .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

@@ -1,24 +1,28 @@
-import { Command } from 'commander'
-import path from 'path'
-import chalk from 'chalk'
-import { resolveContentDir } from '@/cli/utils/config'
-import { PACKAGE_ROOT } from '@/cli/utils/resolve'
+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')
-  .option('-d, --dist <path>', 'Dist directory', 'dist')
-  .action(async (options) => {
-    const contentDir = resolveContentDir(options.content)
-    const port = parseInt(options.port, 10)
-    const distDir = path.resolve(options.dist)
+  .action(async options => {
+    const contentDir = resolveContentDir(options.content);
+    const port = parseInt(options.port, 10);
+    await linkContent(contentDir);
 
-    process.env.CHRONICLE_PROJECT_ROOT = process.cwd()
-    process.env.CHRONICLE_CONTENT_DIR = contentDir
+    console.log(chalk.cyan('Starting production server...'));
 
-    console.log(chalk.cyan('Starting production server...'))
+    const { preview } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
 
-    const { startProdServer } = await import('@/server/prod')
-    await startProdServer({ port, root: PACKAGE_ROOT, distDir })
-  })
+    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

@@ -1,21 +1,21 @@
-import { Command } from 'commander'
-import { initCommand } from './commands/init'
-import { devCommand } from './commands/dev'
-import { buildCommand } from './commands/build'
-import { startCommand } from './commands/start'
-import { serveCommand } from './commands/serve'
+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()
+const program = new Command();
 
 program
   .name('chronicle')
   .description('Config-driven documentation framework')
-  .version('0.1.0')
+  .version('0.1.0');
 
-program.addCommand(initCommand)
-program.addCommand(devCommand)
-program.addCommand(buildCommand)
-program.addCommand(startCommand)
-program.addCommand(serveCommand)
+program.addCommand(initCommand);
+program.addCommand(devCommand);
+program.addCommand(buildCommand);
+program.addCommand(startCommand);
+program.addCommand(serveCommand);
 
-program.parse()
+program.parse();

package/src/cli/utils/config.ts

@@ -1,43 +1,42 @@
-import fs from 'fs'
-import path from 'path'
-import { parse } from 'yaml'
-import chalk from 'chalk'
-import type { ChronicleConfig } from '@/types'
+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
+  config: ChronicleConfig;
+  configPath: string;
+  contentDir: string;
 }
 
 export function resolveContentDir(contentFlag?: string): string {
-  if (contentFlag) return path.resolve(contentFlag)
-  if (process.env.CHRONICLE_CONTENT_DIR) return path.resolve(process.env.CHRONICLE_CONTENT_DIR)
-  return path.resolve('content')
+  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
+  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)
+  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)
+    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
+  const config = parse(fs.readFileSync(configPath, 'utf-8')) as ChronicleConfig;
 
-  return {
-    config,
-    configPath,
-    contentDir,
-  }
+  return { config, configPath, contentDir };
 }

package/src/cli/utils/index.ts

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

package/src/cli/utils/resolve.ts

@@ -1,6 +1,10 @@
-import path from 'path'
-import { fileURLToPath } from 'url'
+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)), '..', '..')
+export const PACKAGE_ROOT = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  '..',
+  '..'
+);