Function updateTableOfContents

scripts/changes/version.ts:278–331

* Regenerates the Table of Contents in the root CHANGELOG.md. * Uses GitHub's heading anchor algorithm with duplicate tracking.

()

 * Uses GitHub's heading anchor algorithm with duplicate tracking.
 */
function updateTableOfContents() {
  let changelogPath = path.join(getRootDir(), "CHANGELOG.md");

  if (preview) {
    console.log("  • Would update Table of Contents");
    return;
  }

  let content = readFile(changelogPath);

  // Strip the existing <details> block before parsing headings so that
  // links inside the TOC don't skew the duplicate-anchor counters
  let contentWithoutDetails = content.replace(
    /<details>[\s\S]*?<\/details>/,
    "",
  );

  // Build TOC: include h1, h2 (versions), and h4+ items nested under
  // "What's Changed" h3 sections (shown at h3 indent level).
  let tocLines: string[] = [];
  let inWhatsChanged = false;

  for (let line of contentWithoutDetails.split("\n")) {
    let match = line.match(/^(#{1,6})\s+(.+)$/);
    if (!match) continue;

    let level = match[1].length;
    let text = match[2].trim();
    let anchor = text
      .toLowerCase()
      .replace(/[^\w\s-]/g, "")
      .trim()
      .replace(/\s+/g, "-");

    if (level <= 2) {
      inWhatsChanged = false;
      tocLines.push(`${"  ".repeat(level - 1)}- [${text}](#${anchor})`);
    } else if (level === 3) {
      inWhatsChanged = text.toLowerCase() === "what's changed";
    } else if (inWhatsChanged) {
      // Render at indent level 2 (child of version, same depth h3 used to occupy)
      tocLines.push(`    - [${text}](#${anchor})`);
    }
  }

  let newDetails =
    `<details>\n  <summary>Table of Contents</summary>\n\n` +
    tocLines.join("\n") +
    `\n\n</details>`;

  let updated = content.replace(/<details>[\s\S]*?<\/details>/, newDetails);
  writeFile(changelogPath, updated);
  console.log("  ✓ Updated Table of Contents");
}

/**
 * Stages and commits changes, or prints the commit message in preview mode