roadmap-gen/index.ts

Professional HTML roadmap generator from YAML data with multiple themes

#!/usr/bin/env bun

/**
 * Main entrypoint for roadmap-gen CLI tool
 *
 * This file serves as the primary entry point for the application,
 * delegating to the build module for actual functionality.
 */

export * from './src/core/types.ts';
export * from './src/core/config.ts';
export * from './src/data/parser.ts';
export * from './src/template/html-generator.ts';
export * from './src/template/template.ts';
export * from './src/template/template-loader.ts';
export * from './src/template/html-utils.ts';

// Main CLI execution
import { parse } from '@bomb.sh/args';
import { build } from './src/core/build.ts';
import { CONFIG } from './src/core/config.ts';

function showHelp(): void {
  console.log(`
🗺️  roadmap-gen - Professional HTML roadmap generator from YAML data

Usage:
  roadmap-gen [options]
  roadmap-gen --source <file>
  roadmap-gen -s <file>

Options:
  -s, --source <file>    Source YAML file path (default: ${CONFIG.INPUT_FILE})
  -t, --template <dir>   Template directory path (default: ${CONFIG.TEMPLATE_DIR})
  -o, --output <dir>     Output directory path (default: ${CONFIG.OUTPUT_DIR})
  --with-internal        Include internal projects and details in output
  -h, --help            Show this help message

Examples:
  roadmap-gen                           # Use default ${CONFIG.INPUT_FILE} (public view)
  roadmap-gen --source my-roadmap.yaml  # Use custom file
  roadmap-gen -s ./config/roadmap.yaml  # Use custom file (short)
  roadmap-gen --with-internal           # Include internal content
  roadmap-gen --template ./themes/corporate  # Use custom template
  roadmap-gen -t ./themes/minimal -s data.yml  # Custom template and source
  roadmap-gen -o ./public --with-internal      # Output to public directory with internal data
  roadmap-gen -t themes/executive -o reports   # Custom template and output

Documentation: https://github.com/davlgd/roadmap-gen
`);
}

// Execute if called directly
if (import.meta.main) {
  const args = parse(process.argv, {
    boolean: ['help', 'h', 'with-internal'],
    string: ['source', 's', 'template', 't', 'output', 'o'],
    alias: {
      h: 'help',
      s: 'source',
      t: 'template',
      o: 'output',
    },
  });

  if (args.help) {
    showHelp();
    process.exit(0);
  }

  const sourceFile = args.source || CONFIG.INPUT_FILE;
  const templateDir = args.template || CONFIG.TEMPLATE_DIR;
  const outputDir = args.output || CONFIG.OUTPUT_DIR;
  const withInternal = args['with-internal'] || false;

  await build(sourceFile, templateDir, outputDir, withInternal);
}

// Export main function for programmatic use
export { build };