umberto 10.7.0 → 10.7.1

package/CHANGELOG.md

@@ -1,6 +1,17 @@
 Changelog
 =========
 
+## [10.7.1](https://github.com/cksource/umberto/compare/v10.7.0...v10.7.1) (July 15, 2026)
+
+### Bug fixes
+
+* Fixed source links for CKEditor 5 packages in API documentation so they now point to the public repository. Links for the latest documentation point to the `master` branch, and links for LTS documentation point to the matching `release-v*` branch.
+
+### Other changes
+
+* Improved the performance of the documentation build. Pug templates of XML components used in Markdown are now compiled once and reused across pages, instead of being recompiled for every component occurrence. This shortens the page generation phase by about 20%.
+
+
 ## [10.7.0](https://github.com/cksource/umberto/compare/v10.6.1...v10.7.0) (July 2, 2026)
 
 ### Features
@@ -46,13 +57,6 @@ Changelog
 
 * Changed the call for feedback title from `<h3>` to `<div>` to prevent it from appearing in the table of contents.
 
-
-## [10.5.0](https://github.com/cksource/umberto/compare/v10.4.1...v10.5.0) (April 14, 2026)
-
-### Features
-
-* Added the Call for feedback component for documentation pages.
-
 ---
 
 To see all releases, visit the [release page](https://github.com/cksource/umberto/releases).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "10.7.0",
+  "version": "10.7.1",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "type": "module",
@@ -15,8 +15,8 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@babel/core": "^7.18.10",
-    "@babel/preset-env": "^7.29.5",
+    "@babel/core": "^7.29.7",
+    "@babel/preset-env": "^7.29.7",
     "@minify-html/node": "^0.17.1",
     "@vscode/markdown-it-katex": "^1.1.2",
     "babel-loader": "^10.0.0",
@@ -41,7 +41,7 @@
     "jquery": "~3.7.1",
     "js-beautify": "^1.14.4",
     "lodash": "^4.17.21",
-    "markdown-it": "^14.1.1",
+    "markdown-it": "^14.2.0",
     "markdown-it-abbr": "^1.0.4",
     "markdown-it-deflist": "^2.1.0",
     "markdown-it-emoji": "^2.0.2",

package/scripts/utils/pug-to-xml-binding/render-xml-pug-components-in-markdown.cjs

@@ -9,6 +9,39 @@ const transformXMLTreeToPug = require( './transform-xml-tree-to-pug.cjs' );
 const XMLComponentsParser = require( './parser/xml-components-parser.cjs' );
 const { walkXMLTree, TreeWalkActions } = require( './parser/walk-xml-tree.cjs' );
 
+// Compiled Pug templates of component mixin calls, keyed by the generated template text.
+// Compiling a template is expensive because Pug lexes and parses the whole `include` tree
+// on every compilation, and the same mixin calls repeat across pages. The compiled function
+// is not bound to any locals, so it can be safely reused with per-page locals.
+//
+// The cache lives for the whole process, like the cache in `createPrerenderPugTemplate()`,
+// so changes to component Pug files require a restart in the watch mode.
+const compiledTemplateCache = new Map();
+
+/**
+ * Compiles a Pug template through the Hexo Pug renderer, reusing previously compiled templates.
+ *
+ * Falls back to `null` when the renderer does not support compilation, in which case the caller
+ * should render through `hexo.render.renderSync()`.
+ */
+function getCompiledPugTemplate( hexo, text, path ) {
+	const cacheKey = `${ path }\n${ text }`;
+	let template = compiledTemplateCache.get( cacheKey );
+
+	if ( !template ) {
+		const pugRenderer = hexo.render.renderer?.get( 'pug' );
+
+		if ( !pugRenderer?.compile ) {
+			return null;
+		}
+
+		template = pugRenderer.compile( { text, path } );
+		compiledTemplateCache.set( cacheKey, template );
+	}
+
+	return template;
+}
+
 /**
  * Slices XML components from Markdown content and transforms them to Pug format.
  *
@@ -93,14 +126,18 @@ function renderXMLPugComponentsInMarkdown( xml, options ) {
 					let finalReplacement = null;
 
 					try {
-						finalReplacement = hexo.render.renderSync(
-							{
-								engine: 'pug',
-								text: content,
-								path: basePath
-							},
-							locals
-						).trim();
+						const template = getCompiledPugTemplate( hexo, content, basePath );
+
+						finalReplacement = template ?
+							template( locals ).trim() :
+							hexo.render.renderSync(
+								{
+									engine: 'pug',
+									text: content,
+									path: basePath
+								},
+								locals
+							).trim();
 					} catch ( error ) {
 						console.error( error );
 						console.error( `Error rendering component "${ node.name }" in file ${ sourceName }` );

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

@@ -19,6 +19,7 @@ import { getShortModulePath } from '../helpers/get-short-module-path.js';
 import { getDocsearchConfig as getDocSearchConfig } from '../helpers/get-docsearch-config.js';
 import { splitLongname } from '../helpers/split-longname.js';
 import { getIssueUrl, getFullGithubLink } from '../helpers/github-url.js';
+import { rewritePublicSourceUrl } from '../helpers/rewrite-public-source-url.js';
 import getReportIssueWidgetUrl from '../../scripts/utils/getreportissuewidgeturl.cjs';
 import { randomId } from '../../scripts/utils/random-id.cjs';
 import parseHref from '../../scripts/utils/parse-href.cjs';
@@ -521,6 +522,7 @@ export class ApiBuilder {
 					groups,
 					seeSourceRepositoryUrl: this._projectConfig.github !== undefined ? this._projectConfig.github.url : realImportPath,
 					getLinkToSource: getFullGithubLink.bind( this ),
+					rewritePublicSourceUrl: url => rewritePublicSourceUrl( url, this._projectConfig.ckeditor5SourceLinkBranch ),
 					docSearchConfig: getDocSearchConfig( this._docSearch, {
 						groups: this._groups,
 						slug: this._projectSlug,

package/src/helpers/rewrite-public-source-url.js

@@ -0,0 +1,42 @@
+/**
+ * @license Copyright (c) 2017-2026, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
+/**
+ * Rewrites CKEditor 5 public package source links generated from the commercial repository checkout.
+ *
+ * @param {String} sourceUrl
+ * @param {String} sourceBranch
+ * @returns {String}
+ */
+export function rewritePublicSourceUrl( sourceUrl, sourceBranch ) {
+	if ( !sourceUrl || !sourceBranch ) {
+		return sourceUrl;
+	}
+
+	let url;
+
+	try {
+		url = new URL( sourceUrl );
+	} catch {
+		return sourceUrl;
+	}
+
+	if ( url.hostname !== 'github.com' ) {
+		return sourceUrl;
+	}
+
+	const match = url.pathname.match( /^\/[^/]+\/ckeditor5-commercial\/blob\/[^/]+\/external\/ckeditor5\/(.+)$/ );
+
+	if ( !match ) {
+		return sourceUrl;
+	}
+
+	return [
+		'https://github.com/ckeditor/ckeditor5',
+		'blob',
+		sourceBranch,
+		match[ 1 ]
+	].join( '/' ) + url.search + url.hash;
+}

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

@@ -92,6 +92,7 @@ export const getProjectConfig = async ( rootPath, options = {} ) => {
 	validateConfiguration( config );
 
 	config.version = getProjectVersion( rootPath );
+	config.ckeditor5SourceLinkBranch = getCKEditor5SourceLinkBranch( rootPath, config );
 
 	parseGitHubUrls( config, rootPath );
 
@@ -304,6 +305,44 @@ function getProjectVersion( rootPath ) {
 	return version || 'latest';
 }
 
+/**
+ * Returns CKEditor 5 source link branch based on LTS metadata from `package.json`.
+ *
+ * @param {String} rootPath
+ * @param {Object} config
+ * @param {String} config.slug
+ * @param {String} config.version
+ * @return {String|undefined}
+ */
+function getCKEditor5SourceLinkBranch( rootPath, config ) {
+	if ( config.slug !== 'ckeditor5' ) {
+		return;
+	}
+
+	const packageJson = getPackageJson( rootPath );
+	const ltsVersions = packageJson ? packageJson[ 'ck-lts-versions' ] : null;
+	const releaseLine = getReleaseLine( config.version );
+	const ltsReleaseLines = Array.isArray( ltsVersions ) ? ltsVersions.map( Number ) : null;
+
+	if ( !ltsReleaseLines || releaseLine === null ) {
+		return;
+	}
+
+	const isLtsVersion = ltsReleaseLines.includes( releaseLine );
+
+	return isLtsVersion ? `release-v${ releaseLine }` : 'master';
+}
+
+/**
+ * @param {String} version
+ * @return {Number|null}
+ */
+function getReleaseLine( version ) {
+	const match = version.match( /^(\d+)\./ );
+
+	return match ? Number( match[ 1 ] ) : null;
+}
+
 /**
  * Tries to find a URL to the repository based on the value in `package.json`, under the "repository" object.
  *

package/themes/umberto/layout/gloria/_api-docs/_mixin/_api-see-source.pug

@@ -1,7 +1,8 @@
 mixin seeSource( item )
 	//- Do not render "See source" button if the module or the parsed item (e.g. a function) has the `@skipsource` annotation
 	if ( projectLocals.seeSourceRepositoryUrl && item.file && !( data.skipSource || item.skipSource ) )
-		- const link = item.file.url || projectLocals.getLinkToSource( projectLocals.seeSourceRepositoryUrl, item.file );
+		- const sourceLink = item.file.url || projectLocals.getLinkToSource( projectLocals.seeSourceRepositoryUrl, item.file );
+		- const link = projectLocals.rewritePublicSourceUrl( sourceLink );
 
 		if link
 			.see-source