add fix-toc script

[Telucero]

Description

This script improves the table of contents (TOC) behavior for MkDocs-based documentation sites. It ensures that both the left and right navigation TOCs highlight the correct heading as the user scrolls or clicks anchor links.

Related to Tanssi Mkdocs 87

Checklist

• I have added a label to this PR 🏷️
• I have run my changes through Grammarly
• If this page requires a disclaimer, I have added one
• If pages have been moved around, I have created an additional PR in tanssi-mkdocs to update redirects

[Copilot]

Pull Request Overview

This PR adds a JavaScript script to fix table of contents (TOC) scrolling behavior for MkDocs-based documentation sites. The script ensures proper highlighting of TOC items and smooth scrolling with header offset compensation.

• Implements smooth scrolling with header offset when clicking anchor links
• Updates TOC highlighting based on current scroll position
• Adds periodic verification to handle delayed rendering scenarios

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[github-actions]

Style Guide Violations Summary

js/fix-toc-scroll.js (Line 1)

• Issue:
  JavaScript should use single quotes for string literals per style guide

• Correction:

document.addEventListener('DOMContentLoaded', () => {

---

js/fix-toc-scroll.js (Line 2)

• Issue:
  Non-exported constants should use camelCase per style guide

• Correction:

const scrollOffset = 80; // Adjust based on your header height

---

js/fix-toc-scroll.js (Line 3)

• Issue:
  Non-exported constants should use camelCase per style guide

• Correction:

const tocSelectorLeft = '.md-nav__link'; // Left nav links

---

js/fix-toc-scroll.js (Line 4)

• Issue:
  Non-exported constants should use camelCase per style guide

• Correction:

const tocSelectorRight = '.md-nav__item--active ~ .md-nav__link'; // Adjust for right nav if you have one

---

[github-actions]

Verification Review

This review focuses on style guide claims, justifications, and confidence scores in the provided documents.

---

Unknown (Line -1)

• Claim:

• Context:

• Justification:

(none provided)

• Requires Verification: No
• Confidence Score: 0

---