[Shewart]

Table of contents on interactive sites

With <Routes @rendermode="InteractiveServer" /> (shellui.dev, shelldocs.shellui.dev, shellicons.shellui.dev), the "On this page" highlight stopped moving once the circuit started, and clicking an entry went to the home page.

• Highlight. The circuit replaced the prerendered TOC and headings, so the scroll-spy watched detached elements. shelldocs.js now re-attaches it when a render replaces the list or headings, or when data-toc-ids changes on navigation.
• Links. TOC links were bare #id, which resolves against <base href> to the home page. They now carry the page's base-relative path (docs/theming#dark-mode), which also works under --base-href.
• Same-page clicks. TOC links and [x](#id) links in content scroll in place and keep the full path in the address bar, before Blazor's router sees the click. A trailing slash (static hosts serve /docs/x/) doesn't count as another page.
• Page bottom. The last short sections can't scroll up into the scroll-spy band, so at the bottom of the page the last heading on screen is active.

Sites with their own toc.js workaround can drop it after upgrading.

Also

• Border utilities. The universal border-color: var(--border) rule in shelldocs-theme.css was unlayered, so it beat Tailwind's border-* utilities in previews and home pages. It's in @layer base now.
• llms.txt groups. Top-level pages on both sides of a folder gave two "## Pages" headings. Each group is listed once, in first-seen order.
• Page menu chat links. With SiteUrl set, the Claude / ChatGPT prompts name the published page, also when an export is previewed locally.

Checked

• Every commit builds in Release with 0 warnings and passes on its own (392 / 393 / 394 / 394 tests); new: TableOfContentsTests, ThemeCssTests, two in LlmsTxtTests.
• Example site, InteractiveServer:
  • six seconds after load the scroll-spy is still attached and follows the scroll
  • a TOC click and a bare #id link stay on the page
  • after sidebar navigation the TOC links and ids belong to the new page
• Export built with --base-href /sub/, served under /sub/:
  • a TOC click scrolls in the same document; the URL is /sub/docs/theming/#dark-mode
  • the last heading becomes active at the bottom
• In the browser, a layered border-destructive utility now wins over the base rule, and plain elements keep --border.