Function extractFirstPurposeLine

src/core/references.ts:86–121

(markdown: string)

 * tolerant of CommonMark closing hashes (`## Purpose ##`).
 */
export function extractFirstPurposeLine(markdown: string): string {
  const lines = markdown.split(/\r?\n/);
  let inPurpose = false;
  let fenceMarker: string | null = null;

  for (const line of lines) {
    // CommonMark: a fence closes only with its own marker kind.
    const fence = line.match(/^\s*(```|~~~)/);
    if (fence) {
      if (fenceMarker === null) {
        fenceMarker = fence[1];
      } else if (fence[1] === fenceMarker) {
        fenceMarker = null;
      }
      continue;
    }
    if (fenceMarker !== null) {
      continue;
    }

    const heading = line.match(/^(#{1,6})\s+(.*)$/);
    if (heading) {
      if (inPurpose) {
        return '';
      }
      const title = heading[2].replace(/\s+#+\s*$/, '').trim();
      inPurpose = title.toLowerCase() === 'purpose';
      continue;
    }
    if (inPurpose && line.trim().length > 0) {
      return line.trim();
    }
  }

  return '';
}

async function collectSpecEntries(referencedRoot: string): Promise<ReferenceSpecEntry[]> {
  const specIds = await getSpecIds(referencedRoot);