Function renderToc

server/utils/docs/render.ts:444–482

(symbols: MergedSymbol[])

 * Render table of contents.
 */
export function renderToc(symbols: MergedSymbol[]): string {
  const grouped = groupMergedByKind(symbols)
  const lines: string[] = []

  lines.push(`<nav class="toc text-sm" aria-label="Table of contents">`)
  lines.push(`<ul class="space-y-3">`)

  for (const kind of KIND_DISPLAY_ORDER) {
    const kindSymbols = grouped[kind]
    if (!kindSymbols || kindSymbols.length === 0) continue

    const title = KIND_TITLES[kind] || kind
    lines.push(`<li>`)
    lines.push(
      `<a href="#section-${kind}" class="font-semibold text-fg-muted hover:text-fg block mb-1">${title} <span class="text-fg-subtle font-normal">(${kindSymbols.length})</span></a>`,
    )

    const showSymbols = kindSymbols.slice(0, MAX_TOC_ITEMS_PER_KIND)
    lines.push(`<ul class="ps-3 space-y-0.5 border-is border-border/50">`)
    for (const symbol of showSymbols) {
      const id = createSymbolId(symbol.kind, symbol.name)
      lines.push(
        `<li><a href="#${id}" class="text-fg-subtle hover:text-fg font-mono text-xs block py-0.5 truncate">${escapeHtml(symbol.name)}</a></li>`,
      )
    }
    if (kindSymbols.length > MAX_TOC_ITEMS_PER_KIND) {
      const remaining = kindSymbols.length - MAX_TOC_ITEMS_PER_KIND
      lines.push(`<li class="text-fg-subtle text-xs py-0.5">... and ${remaining} more</li>`)
    }
    lines.push(`</ul>`)

    lines.push(`</li>`)
  }

  lines.push(`</ul>`)
  lines.push(`</nav>`)

  return lines.join('\n')
}