build: strip YAML frontmatter from breaking changes in changelog

lib/node_modules/@stdlib/_tools/changelog/generate/lib/breaking_changes.js

@@ -1,4 +1,3 @@
-
 /**
 * @license Apache-2.0
 *
@@ -24,6 +23,7 @@
 var filter = require( '@stdlib/array/base/filter' );
 var trim = require( '@stdlib/string/trim' );
 var map = require( '@stdlib/utils/map' );
+var reEOL = require( '@stdlib/regexp/eol' );
 var collectField = require( './collect_field.js' );
 var sectionStart = require( './section_start.js' );
 var sectionEnd = require( './section_end.js' );
@@ -33,10 +33,42 @@ var heading = require( './heading.js' );
 // VARIABLES //
 
 var STDLIB_GITHUB_URL = 'https://github.com/stdlib-js/stdlib/commit';
+var RE_YAML_DELIMITER = /^\s*---\s*$/;
 
 
 // FUNCTIONS //
 
+/**
+* Strips YAML frontmatter blocks from text lines.
+*
+* @private
+* @param {Array<string>} lines - text lines to process
+* @returns {Array<string>} text lines without YAML blocks
+*/
+function stripYamlBlocks( lines ) {
+	var result;
+	var inYaml;
+	var i;
+
+	result = [];
+	inYaml = false;
+
+	for ( i = 0; i < lines.length; i++ ) {
+		// Check for YAML delimiter (---) with optional whitespace:
+		if ( RE_YAML_DELIMITER.test( lines[i] ) ) {
+			inYaml = !inYaml; // Toggle YAML block state
+			continue;
+		}
+
+		// Only include lines that are not part of YAML blocks:
+		if ( !inYaml ) {
+			result.push( lines[i] );
+		}
+	}
+
+	return result;
+}
+
 /**
 * Formats a breaking change.
 *
@@ -54,13 +86,39 @@ var STDLIB_GITHUB_URL = 'https://github.com/stdlib-js/stdlib/commit';
 * // returns '-   [`abcdef1`](https://github.com/stdlib-js/stdlib/commit/abcdef1234567890): beep'
 */
 function formatBreakingChange( note ) {
-	var parts = note.text.split( '\n' );
-	var hash = trim( note.hash );
-	var out = '-   [`'+hash.substring( 0, 7 )+'`]('+STDLIB_GITHUB_URL+'/'+hash+'): '+parts[ 0 ];
-	if ( parts.length > 1 ) {
-		out +='\n\n';
-		out += '    -   ';
-		out += parts.slice( 1 ).join( '\n        ' );
+	var contentLines;
+	var trimmedLine;
+	var firstLine;
+	var restLines;
+	var textLines;
+	var hash;
+	var out;
+	var i;
+
+	textLines = note.text.split( reEOL.REGEXP );
+	contentLines = stripYamlBlocks( textLines );
+	firstLine = '';
+	restLines = [];
+	hash = trim( note.hash );
+
+	for ( i = 0; i < contentLines.length; i++ ) {
+		trimmedLine = trim( contentLines[i] );
+		if ( trimmedLine !== '' ) {
+			// If this is our first non-empty line, it's the firstLine...
+			if ( firstLine === '' ) {
+				firstLine = trimmedLine;
+			} else {
+				restLines.push( trimmedLine );
+			}
+		}
+	}
+
+	// Construct output string - use a single string concatenation when possible
+	out = '-   [`' + hash.substring( 0, 7 ) + '`](' + STDLIB_GITHUB_URL + '/' + hash + '): ' + firstLine;
+
+	if ( restLines.length > 0 ) {
+		out += '\n\n';
+		out += '    -   ' + restLines.join( '\n        ' );
 		out += '\n';
 	}
 	return out;