Function main

scripts/docs-validation/validate.ts:581–647

()

}

async function main() {
  const args = process.argv.slice(2);
  const langArg = args.find((a) => a.startsWith("--lang="));
  const targetLang = langArg?.split("=")[1];

  console.log("🔍 Validating documentation code blocks...\n");

  if (!fs.existsSync(VALIDATION_DIR)) {
    console.error("❌ No extracted code found. Run extraction first:");
    console.error("   npm run extract");
    process.exit(1);
  }

  let totalFailed = 0;
  const summaryData: {
    language: string;
    passed: number;
    failed: number;
    failures: ValidationResult[];
  }[] = [];

  const validators: [string, () => Promise<ValidationResult[]>][] = [
    ["TypeScript", validateTypeScript],
    ["Python", validatePython],
    ["Go", validateGo],
    ["C#", validateCSharp],
    ["Java", validateJava],
  ];

  for (const [name, validator] of validators) {
    const langKey = name.toLowerCase().replace("#", "sharp");
    if (targetLang && langKey !== targetLang) continue;

    console.log(`\n${name}:`);
    const results = await validator();
    const { failed, passed, failures } = printResults(results, name);
    totalFailed += failed;
    summaryData.push({ language: name, passed, failed, failures });
  }

  // Write GitHub Actions summary
  writeGitHubSummary(summaryData);

  console.log("\n" + "─".repeat(40));

  if (totalFailed > 0) {
    console.log(`\n❌ Validation failed: ${totalFailed} file(s) have errors`);
    console.log("\nTo fix:");
    console.log("  1. Check the error messages above");
    console.log("  2. Update the code blocks in the markdown files");
    console.log("  3. Re-run: npm run validate");
    console.log("\nTo skip a code block, add before it:");
    console.log("  <!-- docs-validate: skip -->");
    console.log("\nTo validate a complete version while showing a snippet:");
    console.log("  <!-- docs-validate: hidden -->");
    console.log("  ```lang");
    console.log("  // full compilable code");
    console.log("  ```");