Function shouldSkipFragment

scripts/docs-validation/extract.ts:168–204

* Detect code fragments that can't be validated as standalone files. * These are typically partial snippets showing configuration options * or code that's meant to be part of a larger context.

(block: CodeBlock)

 * or code that's meant to be part of a larger context.
 */
function shouldSkipFragment(block: CodeBlock): boolean {
  const code = block.code.trim();

  // TypeScript/JavaScript: Skip bare object literals (config snippets)
  if (block.language === "typescript") {
    // Starts with property: value pattern (e.g., "provider: {")
    if (/^[a-zA-Z_]+\s*:\s*[\{\[]/.test(code)) {
      return true;
    }
    // Starts with just an object/array that's not assigned
    if (/^\{[\s\S]*\}$/.test(code) && !code.includes("import ") && !code.includes("export ")) {
      return true;
    }
  }

  // Go: Skip fragments that are just type definitions without package
  if (block.language === "go") {
    // Function signatures without bodies (interface definitions shown in docs)
    if (/^func\s+\w+\([^)]*\)\s*\([^)]*\)\s*$/.test(code)) {
      return true;
    }
  }

  // Java: Skip interface definitions, annotations-only, or method signatures without bodies
  if (block.language === "java") {
    // Just an annotation
    if (/^@\w+/.test(code) && !code.includes("{")) {
      return true;
    }
    // Method signature without body
    if (/^(public|private|protected)?\s*(static\s+)?[\w<>\[\]]+\s+\w+\([^)]*\)\s*(throws\s+[\w,\s]+)?;\s*$/.test(code)) {
      return true;
    }
  }

  return false;
}

function wrapCodeForValidation(block: CodeBlock): string {
  let code = block.code;