Function linkifyModuleSpecifiers

server/utils/code-highlight.ts:170–242

(html: string, options?: LinkifyOptions)

 * @param options - Dependencies map and optional relative import resolver
 */
export function linkifyModuleSpecifiers(html: string, options?: LinkifyOptions): string {
  const { dependencies, resolveRelative } = options ?? {}

  const getHref = (moduleSpecifier: string): string | null => {
    const cleanSpec = moduleSpecifier.replace(/^['"]|['"]$/g, '').trim()

    // Try relative import resolution first
    if (cleanSpec.startsWith('.') && resolveRelative) {
      return resolveRelative(moduleSpecifier)
    }

    // Not a relative import - check if it's an npm package
    if (!isNpmPackage(moduleSpecifier)) {
      return null
    }

    const packageName = getPackageName(moduleSpecifier)
    const dep = dependencies?.[packageName]
    if (dep) {
      // Link to code browser with resolved version
      return `/package-code/${packageName}/v/${dep.version}`
    }
    // Fall back to package page if not a known dependency
    return `/package/${packageName}`
  }

  // Match: from keyword span followed by string span containing module specifier
  // Pattern: <span style="...">from</span><span style="..."> 'module'</span>
  let result = html.replace(
    /(<span[^>]*> ?from<\/span>)(<span[^>]*>) (['"][^'"]+['"])<\/span>/g,
    (match, fromSpan, stringSpanOpen, moduleSpecifier) => {
      const href = getHref(moduleSpecifier)
      if (!href) return match
      return `${fromSpan}${stringSpanOpen} <a href="${href}" class="import-link">${moduleSpecifier}</a></span>`
    },
  )

  // Match: side-effect imports like `import 'package'`
  // Pattern: <span>import</span><span> 'module'</span>
  // But NOT: import ... from, import(, or import {
  result = result.replace(
    /(<span[^>]*>import<\/span>)(<span[^>]*>) (['"][^'"]+['"])<\/span>/g,
    (match, importSpan, stringSpanOpen, moduleSpecifier) => {
      const href = getHref(moduleSpecifier)
      if (!href) return match
      return `${importSpan}${stringSpanOpen} <a href="${href}" class="import-link">${moduleSpecifier}</a></span>`
    },
  )

  // Match: require( or import( followed by string
  // Pattern: <span> require</span><span>(</span><span>'module'</span>
  // or: <span>import</span><span>(</span><span>'module'</span>
  // Note: require often has a leading space in the span from Shiki
  result = result.replace(
    /(<span[^>]*>)(\s*)(require|import)(<\/span>)(<span[^>]*>\(<\/span>)(<span[^>]*>)(['"][^'"]+['"])<\/span>/g,
    (
      match,
      spanOpen,