Add markdown parsing..

Author: dd32

lib/runner.php

@@ -360,11 +360,7 @@ function export_docblock_from_data( $docblock_data ) {
 	$long_description = $docblock_data['description'] ?? '';
 
 	if ( $long_description ) {
-		// Remove linebreaks and normalize whitespace
-		$long_description = preg_replace( '/\s+/', ' ', trim( $long_description ) );
-		if ( ! str_contains( $long_description, '<p>' ) ) {
-			$long_description = '<p>' . $long_description . '</p>';
-		}
+		$long_description = apply_markup( $long_description );
 	}
 
 	return array(
@@ -468,5 +464,85 @@ function export_parse_tag( $tag_name, $value ) {
 		);
 	}
 
+	foreach ( array( 'content', 'description' ) as $field ) {
+		if ( isset( $result[ $field ] ) ) {
+			$result[ $field ] = apply_markup( $result[ $field ], false );
+		}
+	}
+
 	return $result;
 }
+
+/**
+ * Apply simple markup to a string for legacy long_description.
+ *
+ * Marks up `code` and >quoted text along with paragraphs.
+ *
+ * TODO: This should be the markdown parser, but AI coded this up pretty quickly.
+ *
+ * @param string $string Input string.
+ * @return string Marked up string.
+ */
+function apply_markup( $string, $paragraphs = true ) {
+	if ( ! $string ) {
+		return '';
+	}
+
+	// HTML Entities
+	$string = htmlspecialchars( $string, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8' );
+
+	// Convert `code` to <code>code</code>
+	$string = preg_replace_callback(
+		'/`([^`]+?)`/',
+		static function( $matches ) {
+			$code_content = html_entity_decode( $matches[1], ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8' );
+			return '<code>' . $code_content . '</code>';
+		},
+		$string
+	);
+
+	// Italics
+	$string = preg_replace( '/\b_([^_]+?)_\b/', '<em>$1</em>', $string );
+
+	// Bold
+	$string = preg_replace( '/\b\*([^\*]+?)\*\b/', '<strong>$1</strong>', $string );
+
+	// Convert >quoted text to <blockquote>quoted text</blockquote>
+	$string = preg_replace( '/^(>|&gt;)\s*(.+)/m', '<blockquote>$2</blockquote>', $string );
+	$string = preg_replace( '#</blockquote>(\s*)<blockquote>#', '$1', $string ); // Merge adjacent blockquotes
+
+	// Headings
+	$string = preg_replace( '/^######\s*(.+)$/m', '<h6>$1</h6>', $string );
+	$string = preg_replace( '/^#####\s*(.+)$/m', '<h5>$1</h5>', $string );
+	$string = preg_replace( '/^####\s*(.+)$/m', '<h4>$1</h4>', $string );
+	$string = preg_replace( '/^###\s*(.+)$/m', '<h3>$1</h3>', $string );
+	$string = preg_replace( '/^##\s*(.+)$/m', '<h2>$1</h2>', $string );
+	$string = preg_replace( '/^#\s*(.+)$/m', '<h1>$1</h1>', $string );
+
+	// Lists.
+	$string = preg_replace( '/^\s*[\*\-\+]\s+(.+)$/m', '<li>$1</li>', $string );
+	$string = preg_replace( '/(<li>.*<\/li>)/sU', '<ul>$1</ul>', $string );
+	$string = preg_replace( '/<\/ul>\s*<ul>/', '', $string ); // Merge adjacent lists
+
+	// Convert blocks to paragraps.
+	$string = str_replace( "\n\n", "\nPARAGRAPHBREAKHERE", $string );
+	$string = str_replace( "\n", ' ', $string );
+	$string = str_replace( 'PARAGRAPHBREAKHERE', "\n", $string );
+
+	// Wrap paragraphs in <p> tags
+	if ( $paragraphs ) {
+		$paragraphs = explode( "\n", trim( $string ) );
+		$paragraphs = array_map( 'trim', $paragraphs );
+		$paragraphs = array_filter( $paragraphs ); // Remove empty paragraphs
+		$paragraphs = array_map( function( $p ) {
+			if ( str_starts_with( $p, '<blockquote>' ) && str_ends_with( $p, '</blockquote>' ) ) {
+				// Paragraph goes inside the block quote. Probably an error.
+				return str_replace( array( '<blockquote>', '</blockquote>' ), array( '<blockquote><p>', '</p></blockquote>' ), $p );
+			}
+			return '<p>' . $p . '</p>';
+		}, $paragraphs );
+		$string = implode( ' ', $paragraphs );
+	}
+
+	return $string;
+}