umberto 8.3.5 → 8.4.0

package/CHANGELOG.md

@@ -1,6 +1,21 @@
 Changelog
 =========
 
+## [8.4.0](https://github.com/cksource/umberto/compare/v8.3.5...v8.4.0) (October 30, 2025)
+
+### Features
+
+* Minify output HTML to reduce file size and improve load performance.
+
+  The output is automatically minified during production builds to remove unnecessary whitespace and comments.
+
+  Minification is **disabled when using the `--dev` modifier**, ensuring the generated HTML remains readable for easier debugging and inspection.
+
+### Other changes
+
+* Umberto reads a project configuration once and passes it through the pipeline. Thanks to that, hooks can modify it, which affects a project's build.
+
+
 ## [8.3.5](https://github.com/cksource/umberto/compare/v8.3.4...v8.3.5) (October 29, 2025)
 
 ### Other changes
@@ -30,17 +45,6 @@ Changelog
 
 * Update to TypeScript 5.3.
 
-
-## [8.3.1](https://github.com/cksource/umberto/compare/v8.3.0...v8.3.1) (September 4, 2025)
-
-### Bug fixes
-
-* Fixed link styles not being applied to followup questions in `Kapa.ai` integration.
-
-### Other changes
-
-* Increased size of the modal in `Kapa.ai` integration.
-
 ---
 
 To see all releases, visit the [release page](https://github.com/cksource/umberto/releases).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "8.3.5",
+  "version": "8.4.0",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "files": [
@@ -17,6 +17,7 @@
     "@babel/core": "^7.18.10",
     "@babel/preset-env": "^7.18.10",
     "@ckeditor/jsdoc-plugins": "^43.0.0",
+    "@minify-html/node": "^0.17.1",
     "babel-loader": "^10.0.0",
     "cheerio": "^1.0.0",
     "escape-string-regexp": "^4.0.0",
@@ -28,8 +29,8 @@
     "hexo-generator-category": "^2.0.0",
     "hexo-generator-index": "^4.0.0",
     "hexo-generator-tag": "^2.0.0",
-    "hexo-renderer-pug": "^3.0.0",
     "hexo-renderer-markdown-it-plus": "^1.0.5",
+    "hexo-renderer-pug": "^3.0.0",
     "htmlparser2": "^10.0.0",
     "javascript-stringify": "^2.1.0",
     "jquery": "~3.7.1",
@@ -46,6 +47,7 @@
     "sass": "^1.54.0",
     "shiki": "^3.4.0",
     "sitemap": "^8.0.0",
+    "tinypool": "^2.0.0",
     "tippy.js": "^6.3.7",
     "tree-model": "^1.0.7",
     "upath": "^2.0.1",
@@ -71,6 +73,6 @@
     ]
   },
   "hexo": {
-    "version": "7.3.0"
+    "version": "8.0.0"
   }
 }

package/src/tasks/build-documentation.js

@@ -26,6 +26,7 @@ const createSitemapStep = require( './create-sitemap-step' );
 const buildSnippets = require( './build-snippets' );
 const copyProjectIcons = require( './copy-project-icons' );
 const executeHooks = require( './execute-hooks' );
+const minifyHtml = require( './minify-html' );
 const umbertoVersion = require( '../../package.json' ).version;
 
 const { parseLinks } = require( '../../scripts/utils/parselinks' );
@@ -49,6 +50,7 @@ const getFilePatternsToProcess = require( '../helpers/get-file-patterns-to-proce
  * clean option can be used to clear the build directory or not.
  * @param {Boolean} options.dev If true, it indicates a local build, skips minification, reuses already built files, allows to skip webpack.
  * @param {Boolean} options.skipApi Skip rendering API docs.
+ * @param {Boolean} options.skipSdk Skip building SDK docs.
  * @param {Boolean} options.skipLiveSnippets Skip building live code snippets.
  * @param {Array.<String>|String} options.extraStyles Path/s to extra css.
  * @param {Array.<String>|String} options.extraScripts Path/s to extra js.
@@ -69,6 +71,7 @@ module.exports = options => {
 		clean = !options.dev,
 		dev = false,
 		skipApi = false,
+		skipSdk = false,
 		skipLiveSnippets = false,
 		extraStyles = [],
 		extraScripts = [],
@@ -127,13 +130,14 @@ module.exports = options => {
 			} );
 		} )
 		.then( async () => {
-			const configs = await getProjectConfigs( rootPath, projectPaths );
+			const configs = await getProjectConfigs( rootPath, projectPaths, { skipLiveSnippets } );
 
 			return executeHooks( configs, 'beforeHexo' );
 		} )
 		.then( () => {
 			return buildProjects( rootPath, projectPaths, {
 				skipApi,
+				skipSdk,
 				skipLiveSnippets,
 				dev,
 				docSearch: mainConfig.docsearch,
@@ -205,6 +209,16 @@ module.exports = options => {
 
 			return Promise.resolve();
 		} )
+		// Minify HTML files.
+		.then( async () => {
+			if ( options.dev ) {
+				return Promise.resolve();
+			}
+
+			const outputDir = upath.relative( process.cwd(), hexoManager.getPublicDir() );
+
+			return minifyHtml( outputDir );
+		} )
 		// Links validation.
 		.then( async () => {
 			const projectConfigs = await getProjectConfigs( rootPath, projectPaths, {
@@ -233,12 +247,12 @@ module.exports = options => {
 			} );
 		} )
 		.then( async () => {
-			const projectConfigs = await getProjectConfigs( rootPath, projectPaths );
+			const projectConfigs = await getProjectConfigs( rootPath, projectPaths, { skipLiveSnippets } );
 
 			return createSitemapStep( { projectConfigs, verbose, mainConfig } );
 		} )
 		.then( async () => {
-			const configs = await getProjectConfigs( rootPath, projectPaths );
+			const configs = await getProjectConfigs( rootPath, projectPaths, { skipLiveSnippets } );
 
 			return executeHooks( configs, 'afterHexo' );
 		} )
@@ -396,15 +410,9 @@ async function getProjectConfigs( rootPath, projectPaths, options = {} ) {
 	const promises = projectPaths.map( async pPath => {
 		const projectRootPath = upath.join( rootPath, pPath );
 
-		return Object.assign(
-			{},
-			{
-				...await getProjectConfig( projectRootPath, {
-					skipLiveSnippets: options.skipLiveSnippets
-				} ),
-				projectRootPath
-			}
-		);
+		return getProjectConfig( projectRootPath, {
+			skipLiveSnippets: options.skipLiveSnippets
+		} );
 	} );
 
 	return Promise.all( promises );

package/src/tasks/get-project-config.js

@@ -32,6 +32,7 @@ module.exports = async ( rootPath, options = {} ) => {
 
 	const config = getConfigurationFile( configPath );
 
+	config.projectRootPath = rootPath;
 	config.__configPath = configPath;
 
 	// Get the `realImportPath()` function. It displays an import path of a class below the class title.

package/src/tasks/minify-html.js

@@ -0,0 +1,54 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
+'use strict';
+
+const { join } = require( 'path' );
+const { globSync } = require( 'fs' );
+const { styleText } = require( 'util' );
+const { default: TinyPool } = require( 'tinypool' );
+
+/**
+ * Minifies all HTML files under outputDir in parallel using tinypool.
+ *
+ * @param {string} outputDir - base directory to search for *.html files
+ */
+module.exports = async function minifyHtml( outputDir ) {
+	const files = globSync( join( outputDir, '**', 'api', '**', '*.html' ) );
+
+	const pool = new TinyPool( {
+		runtime: 'child_process',
+		filename: require.resolve( './minify-worker.js' )
+	} );
+
+	try {
+		console.log( 'Started HTML minification.' );
+
+		const results = await Promise.allSettled(
+			files.map( async file => {
+				try {
+					return await pool.run( file );
+				} catch ( err ) {
+					err.file = file;
+					throw err;
+				}
+			} )
+		);
+
+		const failed = results.filter( r => r.status === 'rejected' );
+
+		if ( failed.length > 0 ) {
+			failed.forEach( ( { reason } ) => {
+				console.error( styleText( 'redBright', `Minification failed for "${ reason.file }": ${ reason.message }` ) );
+			} );
+
+			throw new Error( `Minification failed for ${ failed.length } file(s).` );
+		}
+	} finally {
+		await pool.destroy();
+
+		console.log( 'Finished HTML minification.' );
+	}
+};

package/src/tasks/minify-worker.js

@@ -0,0 +1,27 @@
+/**
+ * @license Copyright (c) 2017-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
+'use strict';
+
+const { readFileSync, writeFileSync } = require( 'fs' );
+const minifier = require( '@minify-html/node' );
+
+/**
+ * Minifies HTML content.
+ *
+ * @param {string} file - Path to the HTML file to minify.
+ * @returns {void}
+ */
+module.exports = function( file ) {
+	const html = readFileSync( file );
+
+	const minified = minifier.minify( html, {
+		keep_comments: true,
+		minify_css: true,
+		minify_js: true
+	} );
+
+	writeFileSync( file, minified );
+};

package/src/tasks/validate-links.js

@@ -55,7 +55,11 @@ function collectLinks( pathsToFiles, options ) {
 		links.add( upath.resolve( filePath + '#' ) );
 
 		const content = fs.readFileSync( filePath, 'utf-8' );
-		const ids = ( content.match( /id="[^"]+"/g ) || [] ).map( el => el.replace( /^id="/, '' ).replace( /"$/, '' ) );
+		// Extract both quoted and unquoted "id" attributes.
+		const ids = [
+			...Array.from( content.matchAll( /id="([^"]+)"/g ), m => m[ 1 ] ),
+			...Array.from( content.matchAll( /id=([^\s"'/>]+)/g ), m => m[ 1 ] )
+		];
 
 		for ( const id of ids ) {
 			if ( !isMaskedID( id ) && !ids.includes( 'icons-' ) ) {

package/themes/umberto/src/gloria/js/components/hash-link.js

@@ -22,7 +22,7 @@ export class HashLink extends BaseComponent {
 		document.addEventListener( 'click', event => {
 			const target = event.target.closest( 'a[href^="#"]' );
 
-			if ( !target ) {
+			if ( !target || event.defaultPrevented ) {
 				return;
 			}