umberto 7.0.2 → 8.0.1

package/scripts/utils/toc.js

@@ -0,0 +1,71 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
+'use strict';
+
+const cheerio = require( 'cheerio' );
+
+module.exports = function toc( data, options = {} ) {
+	const $ = cheerio.load( data, null, false );
+
+	let usedHeadings = [ 'h2', 'h3', 'h4', 'h5', 'h6' ];
+
+	if ( options.tocLimit >= 0 ) {
+		usedHeadings = usedHeadings.slice( 0, options.tocLimit );
+	}
+
+	usedHeadings = usedHeadings.join( ',' );
+
+	const headings = $( usedHeadings )
+		.filter( function() {
+			return !$( this ).parents( '.live-snippet, .collapsing-list__item' ).length;
+		} );
+	const className = options.class || 'secondary-navigation';
+
+	if ( !headings.length ) {
+		return '';
+	}
+
+	const $r = cheerio.load( `<nav class=${ className }><h3>Table of contents</h3></nav>`, null, false ); // result object
+	const tocLastLevels = [ $r( 'nav' ), 0, 0, 0, 0, 0, 0 ];
+
+	headings.each( function() {
+		const hLevel = Number( this.name[ 1 ] );
+		const id = $r( this ).attr( 'id' );
+		const text = $r( this ).find( '.headerlink' ).remove().end().text().trim()
+			// Replace the chevrons with their HTML escape characters to avoid rendering HTML in ToC.
+			.replace( /</g, '&lt;' )
+			.replace( />/g, '&gt;' );
+
+		const newItem = `<li><a class="a11y-focusable" href="#${ id }" title="${ text }">${ text }</a></li>`;
+
+		if ( tocLastLevels[ hLevel ] ) {
+			// If there already is a parent node for current heading level, append the new toc item there.
+			tocLastLevels[ hLevel ].append( newItem );
+		} else {
+			// If there's no parent node for current heading level, create it and append.
+			if ( $r( 'li' ).length ) {
+				$r( 'li' ).last().append( `<ol>${ newItem }</ol>` );
+			} else {
+				$r( 'nav' ).append( `<ol>${ newItem }</ol>` );
+			}
+
+			// Assign new created <ol> element to the helper array.
+			tocLastLevels[ hLevel ] = $r( 'ol' ).last();
+		}
+
+		// After adding new toc item, lower heading levels in helper array must be cleared.
+		// If e.g. level 2 <ol> was added, then level 3 nd lower <ol>s are no longer needed because they belong to upper toc nodes.
+		clearLowerLevels( tocLastLevels, hLevel );
+	} );
+
+	return $r.html();
+};
+
+function clearLowerLevels( levels, current ) {
+	for ( let i = current + 1; i < levels.length; i++ ) {
+		levels[ i ] = 0;
+	}
+}

package/scripts/utils/transform-markdown-admonitions.js

@@ -0,0 +1,98 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
+'use strict';
+
+const ParserCursor = require( './parser-cursor' );
+
+/**
+ * Transforms Github style admonitions in markdown to a rendered callouts.
+ *
+ * For example:
+ *
+ * > [!IMPORTANT]
+ * > This is an important message.
+ * > It should be highlighted.
+ *
+ * @param mapperFn - A function that takes an admonition object and returns a string.
+ * @param str - The string to transform.
+ * @returns The transformed string with admonitions replaced by the result of the mapper function.
+ */
+function transformMarkdownAdmonitions( mapperFn, str ) {
+	const cursor = new ParserCursor( str );
+	let acc = '';
+
+	for ( ; cursor.index < cursor.text.length; ) {
+		const ch = cursor.text[ cursor.index ];
+
+		if ( ch === '>' ) {
+			const maybeAdmonition = cursor.try( eatAdmonition );
+
+			if ( maybeAdmonition ) {
+				acc += mapperFn( maybeAdmonition );
+				continue;
+			}
+		}
+
+		acc += ch;
+		cursor.index++;
+	}
+
+	return acc;
+};
+
+/**
+ * Fast check if the string contains an admonition block.
+ */
+function fastCheckIfContainsAdmonition( str ) {
+	return str.includes( '> [!' ) && str.includes( ']' );
+}
+
+/**
+ * Eats an admonition block if it matches the expected pattern.
+ *
+ * @param cursor - The cursor to use for parsing.
+ * @returns An object representing the admonition type and content, or undefined (if not matched)
+ */
+function eatAdmonition( cursor ) {
+	if ( !cursor.eatTerminals( '> [!' ) ) {
+		return;
+	}
+
+	const type = cursor.eatUntilTerminal( ']' ).trim();
+
+	cursor.eatAllNextTerminals( ' \t\n ' );
+
+	const content = cursor.accumulateEaters( eatAdmonitionLine );
+
+	// Let's revert cursor back to the ending newline if it was consumed.
+	if ( content.length > 0 && cursor.text[ cursor.index - 1 ] === '\n' ) {
+		cursor.index--;
+	}
+
+	return {
+		type,
+		content
+	};
+}
+
+/**
+ * Eats a line of an admonition block.
+ *
+ * @param cursor - The cursor to use for parsing.
+ * @returns The content of the admonition line, or undefined if not matched.
+ */
+function eatAdmonitionLine( cursor ) {
+	cursor.eatIndent();
+
+	if ( !cursor.eatTerminal( '>' ) ) {
+		return;
+	}
+
+	return cursor.eatUntilEOL().trim();
+}
+
+exports.transformMarkdownAdmonitions = transformMarkdownAdmonitions;
+exports.fastCheckIfContainsAdmonition = fastCheckIfContainsAdmonition;

package/scripts/utils/uniq-by-last.js

@@ -0,0 +1,32 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
+'use strict';
+
+/**
+ * Returns a new array with unique elements based on a specified property.
+ * When duplicates are found, the last occurrence is preferred.
+ *
+ * @param array - The array to process
+ * @param key - The property name to check for uniqueness or a function that extracts the value
+ * @returns A new array with unique elements
+ */
+module.exports = function uniqByLast( key, array ) {
+	const seen = new Map();
+
+	// Process from right to left to keep last occurrences
+	return array
+		.slice()
+		.reverse()
+		.filter( item => {
+			const value = typeof key === 'function' ? key( item ) : item[ key ];
+			if ( seen.has( value ) ) {
+				return false;
+			}
+			seen.set( value, true );
+			return true;
+		} )
+		.reverse();
+};

package/src/api-builder/api-builder.js

@@ -19,8 +19,15 @@ const getDocSearchConfig = require( '../helpers/get-docsearch-config' );
 const splitLongname = require( '../helpers/split-longname' );
 const githubUrlUtils = require( '../helpers/github-url' );
 const getReportIssueWidgetUrl = require( '../../scripts/utils/getreportissuewidgeturl' );
-
+const getPageGroupHelper = require( '../../src/hexo/helper/get-page-group' );
 const findTargetDoclet = require( './utils/findtargetdoclet' );
+const writeHtmlFiles = require( '../../src/tasks/write-html-files' );
+
+const { randomId } = require( '../../scripts/utils/random-id' );
+const spritesheetSvg = require( '../../scripts/utils/spritesheet-svg' );
+const inlineSvg = require( '../../scripts/utils/inline-svg' );
+const parseHref = require( '../../scripts/utils/parse-href' );
+const hexoManager = require( '../hexo-manager' );
 
 /**
  * Renders HTML for every module, class, mixin etc.
@@ -117,7 +124,7 @@ module.exports = class ApiBuilder {
 		this.macrosVariables = config.macrosVariables;
 
 		const descriptionParser = new DescriptionParser( this._fileNameManager, this._dataCollection, {
-			macrosVariables: Object.assign( {}, config.projectConfig.variables, config.macrosVariables )
+			macrosVariables: Object.assign( {}, config.projectConfig.variables, config.macrosVariables, config.projectConfig )
 		} );
 
 		/**
@@ -156,6 +163,19 @@ module.exports = class ApiBuilder {
 		this._tmplCol.addHelper( 'getRealImportPath', this._getRealImportPath );
 		this._tmplCol.addHelper( 'getUrlAddressFromLongname', this._getUrlAddressFromLongname.bind( this ) );
 
+		this._tmplCol.addHelper( 'uParseHref', ( str, data ) => parseHref( str, {
+			path: data.path,
+			projectName: data.projectName,
+			projectGlobals: hexoManager.hexo.projectGlobals,
+			BASE_PATH: data.BASE_PATH
+		}, hexoManager.hexo, {
+			relativeUrlHelper: hexoManager.hexo.extend.helper.store.relative_url,
+			isSilentError: true
+		} ) );
+
+		this._tmplCol.addHelper( 'uRandomId', randomId );
+		this._tmplCol.addHelper( 'uCapitalize', capitalize );
+
 		this.canonicalUrlBeginning = config.canonicalUrlBeginning;
 	}
 
@@ -163,7 +183,7 @@ module.exports = class ApiBuilder {
 	 * Main function of this class. Renders HTML for all API items.
 	 * Also creates a JSON file, with entity names, used for additional API docs search.
 	 */
-	buildApi() {
+	async buildApi() {
 		const modulesData = this._dataCollection.get( 'module' ).getAll();
 		const classesData = this._dataCollection.get( 'class' ).getAll();
 		const interfacesData = this._dataCollection.get( 'interface' ).getAll();
@@ -183,14 +203,15 @@ module.exports = class ApiBuilder {
 		this._registerFilenames( concated );
 		this._buildNavTree( concated );
 		this._filterHtml = this._tmplCol.renderTemplate( '_partial/filter' );
-		const modules = this._getPages( modulesData, 'module' );
-		const classes = this._getPages( classesData, 'class' );
-		const interfaces = this._getPages( interfacesData, 'interface' );
-		const typedefs = this._getPages( typedefsData, 'typedef' );
-		const mixins = this._getPages( mixinsData, 'mixin' );
-		const namespaces = this._getPages( namespacesData, 'namespace' );
 
-		this._renderedFiles = [].concat( modules, classes, interfaces, typedefs, mixins, namespaces );
+		await this._getPages( modulesData, 'module' );
+		await this._getPages( classesData, 'class' );
+		await this._getPages( interfacesData, 'interface' );
+		await this._getPages( typedefsData, 'typedef' );
+		await this._getPages( mixinsData, 'mixin' );
+		await this._getPages( namespacesData, 'namespace' );
+
+		this._renderedFiles = [];
 
 		// Build API json data for search engine.
 		this._createApiSearchJson( [].concat(
@@ -358,20 +379,20 @@ module.exports = class ApiBuilder {
 			}
 		}
 
-		this._navTreeHtml = this._tmplCol.renderTemplate(
+		this._navTreeHtml = spritesheetSvg( this._tmplCol.renderTemplate(
 			'_partial/navtree',
 			{
 				projectLocals: {
 					apiTree: this._navTree
 				}
 			}
-		);
+		), false );
 	}
 
 	/**
 	 * Renders HTML of each API docs page and creates an HtmlFile instance for that page.
 	 */
-	_getPages( items, type ) {
+	async _getPages( items, type ) {
 		const views = [];
 
 		for ( const i of items ) {
@@ -396,7 +417,7 @@ module.exports = class ApiBuilder {
 				if ( data.kind === 'module' ) {
 					title = `${ capitalize( data.kind ) } ${ data.longname.replace( 'module:', '' ) }`;
 				} else {
-					title = `${ capitalize( data.kind ) } ${ capitalize( split.name ) } (${ data.longname.replace( 'module:', '' ) })`;
+					title = `${ capitalize( data.kind ) } ${ capitalize( split.name ) }`;
 				}
 
 				const $ = data.description ? cheerio.load( data.description.content, null, false ) : cheerio.load( '', null, false );
@@ -404,7 +425,7 @@ module.exports = class ApiBuilder {
 				html.find( 'pre' ).remove();
 				const desc = html.text().trim().replace( /\n/g, ' ' ).replace( / +/g, ' ' );
 
-				// eslint-disable-next-line max-len
+				// eslint-disable-next-line @stylistic/max-len
 				const metaDescription = `${ this._projectName } API Documentation. The ${ capitalize( data.kind ) } ${ data.kind === 'module' ? data.longname.replace( 'module:', '' ) : capitalize( split.name ) }.${ desc.length ? ' ' + desc : '' }`;
 
 				// Page properties needed by pug templates. They match page properties of guides generated by hexo.
@@ -442,23 +463,33 @@ module.exports = class ApiBuilder {
 						slug: this._projectSlug,
 						customRanking: this._projectConfig.docsearch ? this._projectConfig.docsearch.customRanking : []
 					} ),
-					projectVersion: this._projectConfig.version
+					projectVersion: this._projectConfig.version,
+					getPageGroup: getPageGroupHelper
 				};
+
 				const view = new HtmlFile(
 					this._tmplCol.renderTemplate(
 						type,
 						{
 							data,
-							navTree: this._navTreeHtml,
+							navTree: '%%_RENDERED_NAV_TREE_%%',
 							filter: this._filterHtml,
 							page,
 							projectLocals,
+							sitemap: this._projectConfig.sitemap,
 							docSearchConfig: getDocSearchConfig( this._docSearch )
 						}
 					),
 					filePath
 				);
-				views.push( view );
+
+				let content = inlineSvg( view.content );
+
+				content = spritesheetSvg( content );
+
+				view.content = content.replaceAll( '%%_RENDERED_NAV_TREE_%%', this._navTreeHtml );
+
+				await writeHtmlFiles( [ view ] );
 			}
 		}
 

package/src/api-builder/classes/description-parser.js

@@ -12,6 +12,25 @@ const macroReplacer = require( '../../tasks/macro-replacer' );
 const findTargetDoclet = require( '../utils/findtargetdoclet' );
 const { hasDedicatedApiPages, LONG_NAME_LABEL_REGEXP, LONG_NAME_MEMBER_SEPARATOR_REGEXP } = require( '../utils/utils' );
 const logCrossProjectReference = require( '../../../scripts/utils/logcrossprojectreference' );
+const createPrerenderPugTemplate = require( '../../../scripts/utils/pug-renderer/create-prerender-pug-template' );
+
+const renderCodeBlockPug = createPrerenderPugTemplate( {
+	requires: [
+		'_components/svg/index',
+		'_components/icon/index',
+		'_components/tooltip-popover/index',
+		'_components/skeleton/index',
+		'_components/code-block/index'
+	],
+	component: 'code-block',
+	componentAttrs: {
+		static: {
+			copyable: true
+		},
+		dynamic: [ 'copyable', 'language' ],
+		mask: [ 'code' ]
+	}
+} );
 
 /**
  * Class responsible for parsing doc descriptions.
@@ -29,6 +48,12 @@ module.exports = class DescriptionParser {
 			return;
 		}
 
+		const theme = {
+			theme: this._macrosVariables.slug === 'ckeditor4' ? 'umberto' : 'gloria'
+		};
+
+		Object.assign( options, theme );
+
 		return composeFunctions(
 			this._cleanTabs,
 			this._changeHeaders,
@@ -353,25 +378,51 @@ module.exports = class DescriptionParser {
 	 * @param str
 	 * @returns {String}
 	 */
-	_cleanTabs( str ) {
+	_cleanTabs( str, options = {} ) {
 		if ( str.indexOf( '<pre' ) === -1 ) {
 			return str;
 		}
 
 		const $ = cheerio.load( str, null, false );
+		const theme = options.theme;
 
-		$( 'pre[class~="source"]' ).each( function() {
-			let code = $( this ).html();
-			const begin = /<code> {4}/.exec( code );
+		if ( theme === 'gloria' ) {
+			const $code = $( 'pre code' );
 
-			if ( begin ) {
-				code = code.replace( /(?:<code>|\n) {4}/g, match => {
-					return match.replace( '    ', '' );
-				} );
+			if ( !$code.length ) {
+				return null;
 			}
 
-			$( this ).html( code );
-		} );
+			// Get the language from the class (e.g., "language-js" -> "js")
+			const language = $code.attr( 'class' ) ?
+				$code.attr( 'class' ).replace( 'doc', '' ).replace( 'language-', '' ).replace( 'ts', 'typescript' ).trim() :
+				null;
+
+			// Get the code content
+			const code = $code.html();
+
+			// Use the render-pug-component utility
+			const html = renderCodeBlockPug( {
+				language,
+				code
+			} );
+
+			$( this ).html( html );
+			$( 'pre' ).replaceWith( html );
+		} else {
+			$( 'pre[class~="source"]' ).each( function() {
+				let code = $( this ).html();
+				const begin = /<code> {4}/.exec( code );
+
+				if ( begin ) {
+					code = code.replace( /(?:<code>|\n) {4}/g, match => {
+						return match.replace( '    ', '' );
+					} );
+				}
+
+				$( this ).html( code );
+			} );
+		}
 
 		return $.html();
 	}

package/src/api-builder/classes/doc-data-factory.js

@@ -188,11 +188,11 @@ module.exports = class DocDataFactory {
 		augmentsNested.reverse();
 		const properties = this._getMembers( doclet.properties, { parentDoclet: doclet } ) || [];
 
-		/* eslint-disable max-len */
+		/* eslint-disable @stylistic/max-len */
 		// For all "typedef" doclets - copy property name as its id. Thanks to that we will be able to make a directly link to specified property. See #796.
 		// "member-" as a static string must be the same as defined in `addTypedefProperties()` helper in the `@ckeditor/jsdoc-plugins` package.
 		// See: https://github.com/ckeditor/ckeditor5-dev/blob/aa905a702d337db001445efc1036ab2b33069d44/packages/jsdoc-plugins/lib/relation-fixer/addtypedefproperties.js#L95
-		/* eslint-enable max-len */
+		/* eslint-enable @stylistic/max-len */
 		if ( doclet.kind == 'typedef' ) {
 			for ( const property of properties ) {
 				if ( !property.id ) {

package/src/helpers/github-url.js

@@ -106,7 +106,7 @@ const utils = {
 			return null;
 		}
 
-		// eslint-disable-next-line max-len
+		// eslint-disable-next-line @stylistic/max-len
 		return `https://github.com/ckeditor/${ projectName }/blob/${ gitHash }${ pathSuffix }#L${ file.lineNr }-L${ file.lineNr + file.len }`;
 	}
 };

package/src/helpers/templates/scripts/default.js

@@ -51,4 +51,4 @@ function defaultScript( hits ) {
 	} );
 
 	return result;
-}
+}

package/src/helpers/templates/scripts/group.js

@@ -66,4 +66,4 @@ function groupScript( hits ) {
 	} );
 
 	return result;
-}
+}

package/src/hexo/filter/project-locals.js

@@ -25,6 +25,7 @@ const umbertoVersion = require( '../../../package.json' ).version;
  * @param {Array} extraStylePaths Paths to extra external css.
  * @param {Array} extraScriptsPaths Paths to extra external js.
  * @param {Boolean} disableSearch Extra flag for disabling docsearch if needed.
+ * @param {Array} quickNavigationProjects Projects to display in the quick navigation dropdown.
  * @param {Boolean} navigationShowEmptyCategories If set on true, empty categories will be displayed.
  * @param {Object} og Open Graph config.
  */
@@ -35,12 +36,14 @@ module.exports = ( ctx, {
 	googleoptimize,
 	googletagmanager,
 	googleanalytics,
+	promobar,
 	vwo,
 	feedbackWidget,
 	extraStylePaths,
 	extraScriptsPaths,
 	disableSearch,
 	og,
+	quickNavigationProjects,
 	navigationShowEmptyCategories
 } = {} ) => {
 	ctx.extend.filter.register( 'template_locals', locals => {
@@ -83,6 +86,7 @@ module.exports = ( ctx, {
 			locals.projectsData = [];
 		}
 
+		locals.quickNavigationProjects = quickNavigationProjects;
 		locals.projectsData.push( {
 			name: projectName,
 			slug: projectSlug,
@@ -95,17 +99,25 @@ module.exports = ( ctx, {
 			locals.docSearchConfig = getDocSearchConfig( docSearch );
 		}
 
+		locals.sitemap = config.sitemap;
 		locals.umbertoVersion = umbertoVersion;
 		locals.disableSearch = disableSearch;
 		locals.googleoptimize = googleoptimize;
 		locals.googletagmanager = googletagmanager;
 		locals.googleanalytics = googleanalytics;
+		locals.promobar = promobar;
 		locals.vwo = vwo;
 		locals.feedbackWidget = feedbackWidget;
 		locals.mainName = ctx.projectGlobals.common.mainName ? ctx.projectGlobals.common.mainName : '';
 		locals.mainLogo = ctx.projectGlobals.common.mainLogo ? ctx.projectGlobals.common.mainLogo : '';
 		locals.pathJoin = upath.join;
 
+		// `sitemap` entry is not consistent across building methods of Umberto.
+		// It's often defined in the API, but it's not always available in the hexo locals.
+		// In order to make it available, it's safer to use `docSearch.indexName` which is always defined.
+		locals.isLegacy = locals.path.includes( '/legacy/' );
+		locals.isNightly = docSearch.indexName?.includes( 'nightly' ) || false;
+
 		locals.mainOg = og || {};
 	} );
 };

package/src/hexo/get-repo-urls.js

@@ -55,7 +55,7 @@ function getPackageJson( srcDir ) {
 
 	try {
 		packageJson = require( upath.join( srcDir, 'package.json' ) );
-	} catch ( err ) {
+	} catch {
 		console.warn( `Warning: Cannot read package.json from ${ srcDir }.` );
 	}
 

package/src/hexo/project-globals.js

@@ -54,6 +54,8 @@ module.exports = ( ctx, {
 			for ( const cat of data.categories ) {
 				const newPathToCategory = upath.join( pathToCategory, cat.slug || '' );
 				projectData.categoryIds.set( cat.id, {
+					category: cat,
+					parentCategoryId: data.id,
 					groupId,
 					groupSlug,
 					path: newPathToCategory
@@ -66,6 +68,8 @@ module.exports = ( ctx, {
 	for ( const g of groups ) {
 		const pathToCategory = upath.join( basePath, g.slug );
 		projectData.categoryIds.set( g.id, {
+			category: null,
+			parentCategoryId: null,
 			groupId: g.id,
 			groupSlug: g.slug,
 			path: pathToCategory

package/src/hexo-manager.js

@@ -10,6 +10,7 @@ const upath = require( 'upath' );
 const fs = require( 'fs-extra' );
 const { globSync } = require( 'glob' );
 const Hexo = require( '../hexo-shim' );
+
 const getHexoConfig = require( './tasks/get-hexo-config' );
 const extendConfig = require( './hexo/filter/extend-config' );
 
@@ -43,6 +44,10 @@ class HexoManager {
 			silent: options.silent,
 			debug: false
 		} );
+
+		// Enforce hexo to show errors.
+		this.hexo.log.level = 50;
+
 		extendConfig( this.hexo, this.config );
 		this.isInit = true;
 	}
@@ -96,12 +101,12 @@ class HexoManager {
 	 *
 	 * @returns {Promise<>}
 	 */
-	generate( { watch = false } = {} ) {
+	generate( { watch = false, concurrency } = {} ) {
 		if ( !this.isInit ) {
 			throw new Error( 'Hexo manager is not initialized' );
 		}
 
-		return this.hexo.call( 'generate', { watch } )
+		return this.hexo.call( 'generate', { watch, concurrency } )
 			.then( () => {
 				return this.hexo.exit();
 			} )

package/src/sdk-builder/sdk-builder.js

@@ -168,7 +168,7 @@ module.exports = class SdkBuilder {
 					config: this.projectConfig,
 					projectLocals,
 					content: tools.replaceMacros( sdkItem.content ),
-					getPages: ( function( pages ) { // eslint-disable-line wrap-iife
+					getPages: ( function( pages ) {
 						return function( category ) {
 							return pages
 								.filter( element => element.meta && element.meta.category && element.meta.category === category )
@@ -183,7 +183,7 @@ module.exports = class SdkBuilder {
 									}
 								} );
 						};
-					} )( this.sdkCollection ),
+					}( this.sdkCollection ) ),
 					docSearchConfig: getDocSearchConfig( this._docSearch )
 				}
 			), upath.join( this.destinationPath, slug, sdkItem.name + '.html' ) ) );
@@ -244,7 +244,7 @@ ${ bodyBlocks.join( '\n' ) }
 			{
 				data: this.sdkCollection,
 				config: this.projectConfig,
-				getPages: ( function( pages ) { // eslint-disable-line wrap-iife
+				getPages: ( function( pages ) {
 					return function( category ) {
 						return pages
 							.filter( element => element.meta && element.meta.category && element.meta.category === category )
@@ -259,7 +259,7 @@ ${ bodyBlocks.join( '\n' ) }
 								}
 							} );
 					};
-				} )( this.sdkCollection )
+				}( this.sdkCollection ) )
 			}
 		);
 	}

package/src/tasks/build-api-docs.js

@@ -18,9 +18,9 @@ const TemplateCollection = require( '../template/template-collection' );
  * Creates ApiBuilder instance to process doclets and render HTML.
  *
  * @param config
- * @returns {ApiBuilder}
+ * @returns {Promise<ApiBuilder>}
  */
-module.exports = config => {
+module.exports = async config => {
 	const {
 		src,
 		projectDst, // e.g.: ckeditor5/latest/api
@@ -64,10 +64,10 @@ module.exports = config => {
 		}
 	);
 
-	console.log( `Building API docs of ${ projectConfig.name }...` );
-	console.time( 'Built API docs in' );
-	const buildInfo = apiBuilder.buildApi();
-	console.timeEnd( 'Built API docs in' );
+	console.log( `Building API docs of ${ projectConfig.name } ...` );
+	console.time( `Built API docs of ${ projectConfig.name } in` );
+	const buildInfo = await apiBuilder.buildApi();
+	console.timeEnd( `Built API docs of ${ projectConfig.name } in` );
 
 	if ( process.argv.includes( '--strict' ) && buildInfo.warningCount > 0 ) {
 		console.log( `There were ${ buildInfo.warningCount } warnings reported in strict mode. Aborting.` );