@raystack/chronicle 0.1.0-canary.5a2be79 → 0.1.0-canary.6511afe

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raystack/chronicle",
-  "version": "0.1.0-canary.5a2be79",
+  "version": "0.1.0-canary.6511afe",
   "description": "Config-driven documentation framework",
   "license": "Apache-2.0",
   "type": "module",
@@ -9,15 +9,14 @@
     "dist",
     "src",
     "templates",
-    "next.config.mjs",
-    "source.config.ts",
     "tsconfig.json"
   ],
   "bin": {
     "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",
@@ -37,27 +36,36 @@
     "@codemirror/theme-one-dark": "^6.1.3",
     "@codemirror/view": "^6.39.14",
     "@heroicons/react": "^2.2.0",
-    "@raystack/apsara": "^0.56.0",
-    "@types/unist": "^3.0.3",
+    "@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",
-    "next": "16.1.6",
+    "minisearch": "^7.2.0",
+    "nitro": "latest",
+    "openapi-types": "^12.1.3",
     "react": "^19.0.0",
-    "react-device-detect": "^2.2.3",
     "react-dom": "^19.0.0",
-    "remark-attr": "^0.11.1",
+    "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",
-    "openapi-types": "^12.1.3",
-    "yaml": "^2.8.2",
-    "zod": "^4.3.6"
+    "vite": "^8.0.0",
+    "yaml": "^2.8.2"
   }
 }

package/src/cli/commands/build.ts

@@ -1,32 +1,34 @@
-import { Command } from 'commander'
-import { spawn } from 'child_process'
-import path from 'path'
-import fs from 'fs'
-import chalk from 'chalk'
-import { attachLifecycleHandlers, resolveNextCli } from '@/cli/utils'
+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')
-  .action(() => {
-    const scaffoldPath = path.join(process.cwd(), '.chronicle')
-    if (!fs.existsSync(scaffoldPath)) {
-      console.log(chalk.red('Error: .chronicle/ not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+  .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);
 
-    const nextCli = resolveNextCli()
+    console.log(chalk.cyan('Building for production...'));
 
-    console.log(chalk.cyan('Building for production...'))
+    const { createBuilder } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
 
-    const child = spawn(process.execPath, [nextCli, 'build'], {
-      stdio: 'inherit',
-      cwd: scaffoldPath,
-      env: {
-        ...process.env,
-        CHRONICLE_PROJECT_ROOT: process.cwd(),
-        CHRONICLE_CONTENT_DIR: './content',
-      },
-    })
+    const config = await createViteConfig({
+      packageRoot: PACKAGE_ROOT,
+      projectRoot: process.cwd(),
+      contentDir,
+      preset: options.preset
+    });
 
-    attachLifecycleHandlers(child)
-  })
+    const builder = await createBuilder({ ...config, builder: {} });
+    await builder.buildApp();
+
+    console.log(chalk.green('Build complete'));
+  });

package/src/cli/commands/dev.ts

@@ -1,33 +1,32 @@
-import { Command } from 'commander'
-import { spawn } from 'child_process'
-import path from 'path'
-import fs from 'fs'
-import chalk from 'chalk'
-import { attachLifecycleHandlers, resolveNextCli } from '@/cli/utils'
+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')
-  .action((options) => {
-    const scaffoldPath = path.join(process.cwd(), '.chronicle')
-    if (!fs.existsSync(scaffoldPath)) {
-      console.log(chalk.red('Error: .chronicle/ not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+  .option('-c, --content <path>', 'Content directory')
+  .action(async options => {
+    const contentDir = resolveContentDir(options.content);
+    const port = parseInt(options.port, 10);
 
-    const nextCli = resolveNextCli()
+    await linkContent(contentDir);
 
-    console.log(chalk.cyan('Starting dev server...'))
+    console.log(chalk.cyan('Starting dev server...'));
 
-    const child = spawn(process.execPath, [nextCli, 'dev', '-p', options.port], {
-      stdio: 'inherit',
-      cwd: scaffoldPath,
-      env: {
-        ...process.env,
-        CHRONICLE_PROJECT_ROOT: process.cwd(),
-        CHRONICLE_CONTENT_DIR: './content',
-      },
-    })
+    const { createServer } = await import('vite');
+    const { createViteConfig } = await import('@/server/vite-config');
 
-    attachLifecycleHandlers(child)
-  })
+    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 { loadCLIConfig, scaffoldDir, detectPackageManager } from '@/cli/utils'
-
-
-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,
-    scripts: {
-      dev: 'chronicle dev',
-      build: 'chronicle build',
-      start: 'chronicle start',
-    },
-    dependencies: {
-      '@raystack/chronicle': 'latest',
-    },
-    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,108 +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 it doesn't exist
     if (!fs.existsSync(contentDir)) {
-      fs.mkdirSync(contentDir, { recursive: true })
-      console.log(chalk.green('✓'), 'Created', contentDir)
-    }
-
-    // Create or update package.json in project root
-    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('✓'), 'Created', packageJsonPath)
-    } else {
-      const existing = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'))
-      const template = createPackageJson(dirName)
-      let updated = false
-
-      // Merge missing scripts
-      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
-        }
-      }
-
-      // Merge missing dependencies
-      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
-        }
-      }
-
-      // Merge missing devDependencies
-      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('✓'), 'Updated', packageJsonPath, 'with missing scripts/deps')
-      } else {
-        console.log(chalk.yellow('⚠'), packageJsonPath, 'already has all required entries')
-      }
+      fs.mkdirSync(contentDir, { recursive: true });
+      console.log(chalk.green('\u2713'), 'Created', contentDir);
     }
 
-    // Create chronicle.yaml in project root
-    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('✓'), 'Created', configPath)
+      fs.writeFileSync(configPath, stringify(defaultConfig));
+      console.log(chalk.green('\u2713'), 'Created', configPath);
     } else {
-      console.log(chalk.yellow('⚠'), configPath, 'already exists')
+      console.log(chalk.yellow('\u26a0'), configPath, 'already exists');
     }
 
-    // Create sample index.mdx only if content dir is empty
-    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('✓'), 'Created', indexPath)
+      const indexPath = path.join(contentDir, 'index.mdx');
+      fs.writeFileSync(indexPath, sampleMdx);
+      console.log(chalk.green('\u2713'), 'Created', indexPath);
     }
 
-    // Add .chronicle to .gitignore
-    const gitignorePath = path.join(projectDir, '.gitignore')
-    const chronicleEntry = '.chronicle'
+    const gitignorePath = path.join(projectDir, '.gitignore');
+    const gitignoreEntries = ['node_modules', 'dist', '.output'];
     if (fs.existsSync(gitignorePath)) {
-      const existing = fs.readFileSync(gitignorePath, 'utf-8')
-      if (!existing.includes(chronicleEntry)) {
-        fs.appendFileSync(gitignorePath, `\n${chronicleEntry}\n`)
-        console.log(chalk.green('✓'), 'Added .chronicle to .gitignore')
+      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, `${chronicleEntry}\n`)
-      console.log(chalk.green('✓'), 'Created .gitignore with .chronicle')
+      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' })
-
-    // Scaffold .chronicle/ directory
-    loadCLIConfig(contentDir)
-    scaffoldDir(contentDir)
-
-    const runCmd = pm === 'npm' ? 'npx' : pm === 'bun' ? 'bunx' : `${pm} dlx`
-    console.log(chalk.green('\n✓ 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,53 +1,40 @@
-import { Command } from 'commander'
-import { spawn } from 'child_process'
-import path from 'path'
-import fs from 'fs'
-import chalk from 'chalk'
-import { attachLifecycleHandlers, resolveNextCli } from '@/cli/utils'
+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')
-  .action((options) => {
-    const scaffoldPath = path.join(process.cwd(), '.chronicle')
-    if (!fs.existsSync(scaffoldPath)) {
-      console.log(chalk.red('Error: .chronicle/ not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
-
-    const nextCli = resolveNextCli()
-
-    const env = {
-      ...process.env,
-      CHRONICLE_PROJECT_ROOT: process.cwd(),
-      CHRONICLE_CONTENT_DIR: './content',
-    }
-
-    console.log(chalk.cyan('Building for production...'))
-
-    const buildChild = spawn(process.execPath, [nextCli, 'build'], {
-      stdio: 'inherit',
-      cwd: scaffoldPath,
-      env,
-    })
-
-    process.once('SIGINT', () => buildChild.kill('SIGINT'))
-    process.once('SIGTERM', () => buildChild.kill('SIGTERM'))
-
-    buildChild.on('close', (code) => {
-      if (code !== 0) {
-        console.log(chalk.red('Build failed'))
-        process.exit(code ?? 1)
-      }
-
-      console.log(chalk.cyan('Starting production server...'))
-
-      const startChild = spawn(process.execPath, [nextCli, 'start', '-p', options.port], {
-        stdio: 'inherit',
-        cwd: scaffoldPath,
-        env,
-      })
-
-      attachLifecycleHandlers(startChild)
-    })
-  })
+  .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

@@ -1,33 +1,28 @@
-import { Command } from 'commander'
-import { spawn } from 'child_process'
-import path from 'path'
-import fs from 'fs'
-import chalk from 'chalk'
-import { attachLifecycleHandlers, resolveNextCli } from '@/cli/utils'
+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')
-  .action((options) => {
-    const scaffoldPath = path.join(process.cwd(), '.chronicle')
-    if (!fs.existsSync(scaffoldPath)) {
-      console.log(chalk.red('Error: .chronicle/ not found. Run'), chalk.cyan('chronicle init'), chalk.red('first.'))
-      process.exit(1)
-    }
+  .option('-c, --content <path>', 'Content directory')
+  .action(async options => {
+    const contentDir = resolveContentDir(options.content);
+    const port = parseInt(options.port, 10);
+    await linkContent(contentDir);
 
-    const nextCli = resolveNextCli()
+    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 child = spawn(process.execPath, [nextCli, 'start', '-p', options.port], {
-      stdio: 'inherit',
-      cwd: scaffoldPath,
-      env: {
-        ...process.env,
-        CHRONICLE_PROJECT_ROOT: process.cwd(),
-        CHRONICLE_CONTENT_DIR: './content',
-      },
-    })
+    const config = await createViteConfig({ packageRoot: PACKAGE_ROOT, projectRoot: process.cwd(), contentDir });
+    const server = await preview({
+      ...config,
+      preview: { port }
+    });
 
-    attachLifecycleHandlers(child)
-  })
+    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,3 +1,3 @@
-export * from './config'
-export * from './process'
-export * from './scaffold'
+export * from './config';
+export * from './resolve';
+export * from './scaffold';