Function parseReferences

frontend/src/shared/lib/citation-resolver.ts:223–263

(data: string | CSLReference[] | null | undefined)

 * Deduplicates by id when parsing JSONL.
 */
export function parseReferences(data: string | CSLReference[] | null | undefined): CSLReference[] | null {
  if (!data) return null
  if (Array.isArray(data)) return data

  const trimmed = data.trim()
  if (!trimmed) return null

  // Try JSON array first (starts with '[')
  if (trimmed.startsWith('[')) {
    try {
      return JSON.parse(trimmed) as CSLReference[]
    } catch {
      return null
    }
  }

  // Try JSONL format (one JSON object per line, starts with '{')
  if (trimmed.startsWith('{')) {
    const refs: CSLReference[] = []
    const seen = new Set<string>()

    for (const line of trimmed.split('\n')) {
      const stripped = line.trim()
      if (!stripped) continue
      try {
        const ref = JSON.parse(stripped) as CSLReference
        // Dedupe by id
        if (ref.id && !seen.has(ref.id)) {
          refs.push(ref)
          seen.add(ref.id)
        }
      } catch {
        // Skip malformed lines
        continue
      }
    }
    return refs.length > 0 ? refs : null
  }

  return null
}