$released HTML; } $featuresLink = ''; if ($whatsNew !== '') { $featuresLink = '' . $whatsNew . ''; } if (!str_starts_with($subtitle, '

')) { $subtitle = '

' . $subtitle . '

'; } return <<

$releasedBadge $logoSvg

$title

$subtitle

$featuresLink $upgradeNow

HTML; } public static function getPrefooter(string $title, string $upgradeNow, string $description, string $extraCredit = ''): string { $currentYear = date('Y'); return <<

$title

$description

HTML; } /** * @param FeatureComparison[] $comparisons */ public static function getFeatureComparisons(array $comparisons, string $version, string $previousVersion, string $newText = ''): string { $html = ''; $lastKey = array_key_last($comparisons); foreach ($comparisons as $key => $feature) { $html .= self::getFeatureComparison( feat: $feature, version: $version, previousVersion: $previousVersion, isLast: $key === $lastKey, newText: $newText, ) . "\n"; } return $html; } private static function getFeatureComparison( FeatureComparison $feat, string $version, string $previousVersion, bool $isLast, string $newText = '', ): string { $codeBlock = self::getCodeBlock($feat->before, $feat->after, $version, $previousVersion, $feat->highlightCode, $newText, $feat->links); $code2Block = ''; if ($feat->after2 !== '') { $code2Block = self::getCodeBlock($feat->before2, $feat->after2, $version, $previousVersion, $feat->highlightCode); } $last = $isLast ? ' last' : ''; $description = $feat->description; if (!str_starts_with($description, '

')) { $description = '

' . $description . '

'; } return <<

{$feat->title}

$description

$codeBlock $code2Block HTML; } private static function getCodeBlock( string $beforeCode, string $afterCode, string $version, string $previousVersion, bool $highlightCode, string $newText = '', array $links = [], ): string { $links = array_map(self::getRfcLink(...), $links); $linksHtml = implode("\n", $links); $newBadge = ''; if ($newText !== '') { $newBadge = '' . htmlspecialchars($newText) . ''; } $noBeforeCode = $beforeCode === ''; if ($highlightCode) { $beforeCode = highlight_php_trimmed($beforeCode, true); $afterCode = highlight_php_trimmed($afterCode, true); } else { $beforeCode = "

$beforeCode

"; $afterCode = "

$afterCode

"; } $version = htmlspecialchars($version); $previousVersion = htmlspecialchars($previousVersion); $copyCodeButton = self::getCopyCodeButton(); if ($noBeforeCode) { $codeMarkup = << $afterCode HTML; } else { $codeMarkup = << $beforeCode

$afterCode

HTML; } $singleClass = $noBeforeCode ? ' single' : ''; return <<

$codeMarkup

HTML; } private static function getRfcLink(string $namedLink): string { // Use 'title|link' string since multiple links may have the same title preg_match('!^((.+)\|)?(.+)$!', $namedLink, $matches); $link = $matches[3]; $title = $matches[2] ?: 'Link'; return '' . $title . ' ↗'; } private static function getCopyCodeButton(): string { return <<<'HTML' HTML; } }