Function extractCodeBlocks

tests/snippet-validation.test.cjs:120–160

* Extract code blocks from markdown/mdx files * @param {string} filePath - Path to the markdown file * @returns {Array} Array of code block objects

(filePath)

 * @returns {Array} Array of code block objects
 */
function extractCodeBlocks(filePath) {
  const content = fs.readFileSync(filePath, 'utf8');
  const blocks = [];

  // Check if page has testable: true in frontmatter
  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
  const isTestablePage = frontmatterMatch && /testable:\s*true/i.test(frontmatterMatch[1]);

  // Regex to match code blocks with optional metadata
  const codeBlockRegex = /```(\w+)([^\n]*)\n([\s\S]*?)```/g;

  let match;
  let blockIndex = 0;

  while ((match = codeBlockRegex.exec(content)) !== null) {
    const language = match[1];
    const metadata = match[2];
    const code = match[3];

    // Test if:
    // 1. Page has testable: true in frontmatter, OR
    // 2. Individual block has test=true or testable marker (legacy)
    // 3. BUT NOT if block has test=false marker (explicit opt-out)
    const isExplicitlyDisabled = /\btest=false\b/.test(metadata);
    const shouldTest = !isExplicitlyDisabled && (
                      isTestablePage ||
                      /\btest=true\b/.test(metadata) ||
                      /\btestable\b/.test(metadata));

    blocks.push({
      file: filePath,
      language,
      shouldTest,
      code: code.trim(),
      index: blockIndex++,
      line: content.substring(0, match.index).split('\n').length
    });
  }

  return blocks;
}

/**
 * Find all documentation files