phokus/src/changelog.ts

// Parses the project CHANGELOG.md (imported raw at build time) into structured
// data so the "What's New" UI can render it nicely instead of dumping markdown.
// Keeping the changelog as the single source of truth means there's no separate
// per-release copy to maintain — whatever ships in CHANGELOG.md is what users see.
import changelogRaw from '../CHANGELOG.md?raw'

export interface ChangelogItem {
  /** The bold lead-in at the start of a bullet (e.g. "Custom multi-folder picker"), if any. */
  lead: string | null
  /** The remaining descriptive text. May still contain inline `code` / **bold** markers. */
  body: string
}

export interface ChangelogSection {
  /** "Added" | "Changed" | "Fixed" | "Removed" | "Deprecated" | "Security" */
  title: string
  items: ChangelogItem[]
}

export interface ChangelogEntry {
  version: string
  date: string | null
  sections: ChangelogSection[]
}

// "## [0.1.1] — 2026-06-23" / "## [Unreleased]"
const VERSION_HEADING = /^##\s+\[([^\]]+)\]\s*(?:[—–-]\s*(.+?)\s*)?$/
// "### Added"
const SECTION_HEADING = /^###\s+(.+?)\s*$/
// "- bullet text"
const BULLET = /^[-*]\s+(.*)$/
// Leading "**Title**" optionally followed by an em dash, used as the item's lead-in.
// (Item text is whitespace-collapsed before matching, so no dotAll flag needed.)
const LEAD = /^\*\*(.+?)\*\*\s*(?:[—–-]\s*)?(.*)$/

function toItem(text: string): ChangelogItem {
  const collapsed = text.replace(/\s+/g, ' ').trim()
  const match = collapsed.match(LEAD)
  if (match) {
    return { lead: match[1].trim(), body: match[2].trim() }
  }
  return { lead: null, body: collapsed }
}

function parseChangelog(raw: string): ChangelogEntry[] {
  const lines = raw.split(/\r?\n/)
  const entries: ChangelogEntry[] = []

  let entry: ChangelogEntry | null = null
  let section: ChangelogSection | null = null
  let buffer: string[] = []

  const flushItem = () => {
    if (section && buffer.length > 0) {
      section.items.push(toItem(buffer.join(' ')))
    }
    buffer = []
  }

  for (const line of lines) {
    const versionMatch = line.match(VERSION_HEADING)
    if (versionMatch) {
      flushItem()
      section = null
      entry = {
        version: versionMatch[1].trim(),
        date: versionMatch[2]?.trim() ?? null,
        sections: [],
      }
      entries.push(entry)
      continue
    }

    // Stop collecting once we leave the changelog body (e.g. link-reference defs at EOF).
    if (!entry) continue

    const sectionMatch = line.match(SECTION_HEADING)
    if (sectionMatch) {
      flushItem()
      section = { title: sectionMatch[1].trim(), items: [] }
      entry.sections.push(section)
      continue
    }

    const bulletMatch = line.match(BULLET)
    if (bulletMatch) {
      flushItem()
      buffer.push(bulletMatch[1])
      continue
    }

    if (line.trim() === '') {
      // A blank line ends a (possibly wrapped) multi-line bullet.
      flushItem()
      continue
    }

    // Indented continuation of the current wrapped bullet.
    if (buffer.length > 0) {
      buffer.push(line.trim())
    }
  }

  flushItem()
  return entries.map((e) => ({ ...e, sections: e.sections.filter((s) => s.items.length > 0) }))
}

const ENTRIES = parseChangelog(changelogRaw)

export function getChangelogForVersion(version: string | null | undefined): ChangelogEntry | null {
  if (!version) return null
  // Strip leading "v" and any build suffix (e.g. "-ui", "-dev", "-beta.1") so
  // dev/UI-lab builds still resolve to the correct changelog entry.
  const normalized = version.replace(/^v/, '').replace(/-[a-z].*/i, '')
  // Never surface the in-progress [Unreleased] section to users.
  if (normalized.toLowerCase() === 'unreleased') return null
  return ENTRIES.find((e) => e.version.replace(/^v/, '') === normalized) ?? null
}