build: handle empty releases in namespace packages and include section comments

Author: Planeshifter

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

@@ -54,7 +54,7 @@ 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/g );
+	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 ) {

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

@@ -318,22 +318,26 @@ function generate( pkg, releaseType ) {
 	if ( isNamespacePkg ) {
 		str += releaseSectionStart( nextVersion );
 		str += '## ' + ( nextVersion || 'Unreleased' ) + ' (' + formatDate() + ')\n\n';
-		bySubpackage = groupBySubPackage( commits.unreleased, pkg );
-		pkgNames = objectKeys( bySubpackage ).sort();
-		str += sectionStart( 'packages' );
-		str += heading( 'Packages', 3 );
-		for ( i = 0; i < pkgNames.length; i++ ) {
-			name = pkgNames[ i ];
-			unreleased = releaseSummary( bySubpackage[ name ], true, true );
-			if ( unreleased ) {
-				str += packageSummaryWrapper( pkg, '', name, unreleased );
+		if ( commits.unreleased.length > 0 ) {
+			bySubpackage = groupBySubPackage( commits.unreleased, pkg );
+			pkgNames = objectKeys( bySubpackage ).sort();
+			str += sectionStart( 'packages' );
+			str += heading( 'Packages', 3 );
+			for ( i = 0; i < pkgNames.length; i++ ) {
+				name = pkgNames[ i ];
+				unreleased = releaseSummary( bySubpackage[ name ], true, true );
+				if ( unreleased ) {
+					str += packageSummaryWrapper( pkg, '', name, unreleased );
+				}
 			}
+			str += sectionEnd( 'packages' );
+			str += breakingChanges( commits.unreleased );
+			str += closedIssues( commits.unreleased );
+			str += formatContributors( commits.unreleased );
+			str += formatCommits( commits.unreleased );
+		} else {
+			str += PLACEHOLDER_SUMMARY;
 		}
-		str += sectionEnd( 'packages' );
-		str += breakingChanges( commits.unreleased );
-		str += closedIssues( commits.unreleased );
-		str += formatContributors( commits.unreleased );
-		str += formatCommits( commits.unreleased );
 		str += sectionEnd( 'release' );
 	} else {
 		unreleased = releaseSummary( commits.unreleased );
@@ -347,27 +351,30 @@ function generate( pkg, releaseType ) {
 	if ( isNamespacePkg ) {
 		for ( i = releases.length-1; i >= 0; i-- ) {
 			version = releases[ i ][ 0 ];
-			releaseCommits = commits[ version ];
-			if ( !releaseCommits ) {
-				releaseCommits = [];
-			}
+			str += releaseSectionStart( version );
 			str += '## ' + version + ' (' + formatDate( releases[ i ][ 1 ] ) + ')\n\n';
-			bySubpackage = groupBySubPackage( releaseCommits, pkg );
-			pkgNames = objectKeys( bySubpackage ).sort();
-			str += sectionStart( 'packages' );
-			str += heading( 'Packages', 3 );
-			for ( j = 0; j < pkgNames.length; j++ ) {
-				name = pkgNames[ j ];
-				summary = releaseSummary( bySubpackage[ name ], true, true );
-				if ( summary ) {
-					str += packageSummaryWrapper( pkg, version, name, summary );
+			releaseCommits = commits[ version ];
+			if ( releaseCommits && releaseCommits.length > 0 ) {
+				bySubpackage = groupBySubPackage( releaseCommits, pkg );
+				pkgNames = objectKeys( bySubpackage ).sort();
+				str += sectionStart( 'packages' );
+				str += heading( 'Packages', 3 );
+				for ( j = 0; j < pkgNames.length; j++ ) {
+					name = pkgNames[ j ];
+					summary = releaseSummary( bySubpackage[ name ], true, true );
+					if ( summary ) {
+						str += packageSummaryWrapper( pkg, version, name, summary );
+					}
 				}
+				str += sectionEnd( 'packages' );
+				str += breakingChanges( releaseCommits );
+				str += closedIssues( releaseCommits );
+				str += formatContributors( releaseCommits );
+				str += formatCommits( releaseCommits );
+			} else {
+				str += PLACEHOLDER_SUMMARY;
 			}
-			str += sectionEnd( 'packages' );
-			str += breakingChanges( releaseCommits );
-			str += closedIssues( releaseCommits );
-			str += formatContributors( releaseCommits );
-			str += formatCommits( releaseCommits );
+			str += sectionEnd( 'release' );
 		}
 	} else {
 		for ( i = releases.length-1; i >= 0; i-- ) {