Function renderMergedSymbol

server/utils/docs/render.ts:96–175

* Render a merged symbol (with all its overloads).

(
  symbol: MergedSymbol,
  symbolLookup: SymbolLookup,
)

 * Render a merged symbol (with all its overloads).
 */
async function renderMergedSymbol(
  symbol: MergedSymbol,
  symbolLookup: SymbolLookup,
): Promise<string> {
  const primaryNode = symbol.nodes[0]
  if (!primaryNode) return '' // Safety check - should never happen

  const lines: string[] = []
  const id = createSymbolId(symbol.kind, symbol.name)
  const hasOverloads = symbol.nodes.length > 1

  lines.push(`<article class="docs-symbol" id="${id}">`)

  // Header
  lines.push(`<header class="docs-symbol-header">`)
  lines.push(
    `<a href="#${id}" class="docs-anchor" aria-label="Link to ${escapeHtml(symbol.name)}">#</a>`,
  )
  lines.push(`<h3 class="docs-symbol-name">${escapeHtml(symbol.name)}</h3>`)
  lines.push(`<span class="docs-badge docs-badge--${symbol.kind}">${symbol.kind}</span>`)
  if (primaryNode.functionDef?.isAsync) {
    lines.push(`<span class="docs-badge docs-badge--async">async</span>`)
  }
  if (hasOverloads) {
    lines.push(`<span class="docs-overload-count">${symbol.nodes.length} overloads</span>`)
  }
  lines.push(`</header>`)

  // Signatures
  const signatures = symbol.nodes
    .slice(0, hasOverloads ? MAX_OVERLOAD_SIGNATURES : 1)
    .map(n => getNodeSignature(n))
    .filter(Boolean) as string[]

  const description = symbol.jsDoc?.doc?.trim()
  const signaturePromise =
    signatures.length > 0 ? highlightCodeBlock(signatures.join('\n'), 'typescript') : null
  const descriptionPromise = description ? renderMarkdown(description, symbolLookup) : null
  const jsDocTagsPromise =
    symbol.jsDoc?.tags && symbol.jsDoc.tags.length > 0
      ? renderJsDocTags(symbol.jsDoc.tags, symbolLookup)
      : null
  const [highlightedSignature, renderedDescription, renderedJsDocTags] = await Promise.all([
    signaturePromise,
    descriptionPromise,
    jsDocTagsPromise,
  ])

  if (highlightedSignature) {
    lines.push(`<div class="docs-signature">${highlightedSignature}</div>`)

    if (symbol.nodes.length > MAX_OVERLOAD_SIGNATURES) {
      const remaining = symbol.nodes.length - MAX_OVERLOAD_SIGNATURES
      lines.push(`<p class="docs-more-overloads">+ ${remaining} more overloads</p>`)
    }
  }

  // Description