umberto 10.1.3 → 10.2.0

package/CHANGELOG.md

@@ -1,45 +1,49 @@
 Changelog
 =========
 
-## [10.1.3](https://github.com/cksource/umberto/compare/v10.1.2...v10.1.3) (March 10, 2026)
+## [10.2.0](https://github.com/cksource/umberto/compare/v10.1.4...v10.2.0) (April 2, 2026)
+
+### Features
+
+* Added support for configuring Kapa AI source groups via the `sourceGroupIds` option. The option can be set globally in `kapa.default` or per project to filter the widget's knowledge base to specific source groups.
 
 ### Bug fixes
 
-* Fix regression introduced in `v10.1.2` affecting slugs generated for headings. Slugs generated now should be the same as in `v10.1.1` and previous versions of Umberto.
+* Fixed a console error thrown when hovering over a CKEditor bookmark element. The `links-prefetch` module now silently ignores anchor elements with no `href` instead of calling `new URL( '' )` and logging a spurious error.
 
+### Other changes
 
-## [10.1.2](https://github.com/cksource/umberto/compare/v10.1.1...v10.1.2) (March 9, 2026)
+* Removed the legacy warning banner.
+* Added cyan LTS banner at the top of the page on LTS branch.
+* Updated the colour of nightly banner to yellow.
 
-### Bug fixes
 
-* Removed unmaintained `hexo-renderer-markdown-it-plus` and `@ckeditor/jsdoc-plugins` dependencies by replacing them with maintained and local implementations, resolving the reported `markdown-it`-related vulnerabilities in Umberto's dependency tree.
+## [10.1.4](https://github.com/cksource/umberto/compare/v10.1.3...v10.1.4) (March 20, 2026)
 
+### Other changes
 
-## [10.1.1](https://github.com/cksource/umberto/compare/v10.1.0...v10.1.1) (March 4, 2026)
+* Filter search results from Algolia to match the current docs version: `latest` or `lts-v47`. Filtering remains backward-compatible: hits without the docs version are still allowed.
 
-### Bug fixes
 
-* Fixed a deprecation warning displayed during documentation builds by migrating Sass compilation to the modern Dart Sass JavaScript API. The `legacy-js-api` warning is no longer emitted.
+## [10.1.3](https://github.com/cksource/umberto/compare/v10.1.2...v10.1.3) (March 10, 2026)
 
+### Bug fixes
 
-## [10.1.0](https://github.com/cksource/umberto/compare/v10.0.0...v10.1.0) (March 4, 2026)
+* Fix regression introduced in `v10.1.2` affecting slugs generated for headings. Slugs generated now should be the same as in `v10.1.1` and previous versions of Umberto.
 
-### Features
 
-* Add support for experimental features in the callout component and in the badges normalization script.
+## [10.1.2](https://github.com/cksource/umberto/compare/v10.1.1...v10.1.2) (March 9, 2026)
 
 ### Bug fixes
 
-* Fixed the deprecation warning regarding the `Sass if() syntax` thrown during building docs.
-* Disabled inserting a space between the anchor link and heading when converting a document from Markdown to HTML.
+* Removed unmaintained `hexo-renderer-markdown-it-plus` and `@ckeditor/jsdoc-plugins` dependencies by replacing them with maintained and local implementations, resolving the reported `markdown-it`-related vulnerabilities in Umberto's dependency tree.
 
 
-## [10.0.0](https://github.com/cksource/umberto/compare/v9.4.0...v10.0.0) (February 16, 2026)
+## [10.1.1](https://github.com/cksource/umberto/compare/v10.1.0...v10.1.1) (March 4, 2026)
 
-### BREAKING CHANGES
+### Bug fixes
 
-* Migrate the package to [ESM](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules).
-* Remove the `validateW3C` option.
+* Fixed a deprecation warning displayed during documentation builds by migrating Sass compilation to the modern Dart Sass JavaScript API. The `legacy-js-api` warning is no longer emitted.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "10.1.3",
+  "version": "10.2.0",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "type": "module",

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

@@ -193,8 +193,8 @@ export const projectLocals = ( ctx, {
 		// `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.isLts = /\/ckeditor5\/(lts-v\d+)(?:\/|$)/.test( `/${ locals.path }` );
 
 		locals.mainOg = og || {};
 	} );

package/src/tasks/build-documentation.js

@@ -510,8 +510,8 @@ async function buildApis( projectConfigs, options = {} ) {
 				feedbackWidget: options.feedbackWidget,
 				pathJoin: upath.join,
 				mainOg: options.og || {},
-				isLegacy: false,
-				isNightly: options.docSearch?.indexName?.includes( 'nightly' ) || false
+				isNightly: options.docSearch?.indexName?.includes( 'nightly' ) || false,
+				isLts: /\/ckeditor5\/(lts-v\d+)(?:\/|$)/.test( `/${ BASE_PATH }` )
 			},
 			projectConfig: config,
 			canonicalUrlBeginning: getCanonicalBeginning( { config, options, hexoManager } )

package/themes/umberto/layout/gloria/404.pug

@@ -20,7 +20,7 @@ html(lang='en')
 
 	body.l-layout.l-layout--muted.js-layout
 		+header-nightly-info
-		+header-legacy-warning
+		+header-lts-info
 		+header-promobar
 		+header({ className: 'l-layout__header', withChooseProject: false })
 

package/themes/umberto/layout/gloria/_modules/header-bar/_style.scss

@@ -27,6 +27,29 @@
 		color: var(--color-common-white);
 	}
 
+	&--lts {
+		--a11y-focus-ring-color: color-mix(in srgb, var(--color-cyan-500) 40%, transparent);
+		--a11y-focus-border-color: var(--color-common-white);
+
+		background-color: var(--color-cyan-500);
+		color: var(--color-common-white);
+	}
+
+	&--warning,
+	&--lts {
+		font-size: var(--font-size-sm);
+
+		.c-icon-message {
+			line-height: 1;
+		}
+
+		.c-icon-message__content {
+			flex: none;
+			display: inline-flex;
+			align-items: center;
+		}
+	}
+
 	&--info-gradient {
 		background: linear-gradient(240deg, var(--color-info-800), var(--color-info-500));
 		color: var(--color-common-white);
@@ -37,6 +60,42 @@
 		}
 	}
 
+	.b-prose a,
+	.b-link {
+		color: inherit;
+		text-decoration-color: currentColor;
+
+		&:hover,
+		&:focus,
+		&:active {
+			color: inherit;
+			text-decoration-color: currentColor;
+		}
+	}
+
+	&__label {
+		flex-shrink: 0;
+		padding: 0.15rem 0.55rem;
+		border: 1px solid currentColor;
+		border-radius: 999px;
+		background-color: color-mix(in srgb, currentColor 12%, transparent);
+		font-size: var(--font-size-xs);
+		font-weight: var(--font-weight-bold);
+		letter-spacing: 0.08em;
+		text-transform: uppercase;
+	}
+
+	&__label-text {
+		font-weight: inherit;
+	}
+
+	&__message {
+		display: flex;
+		flex-wrap: wrap;
+		align-items: center;
+		font-weight: var(--font-weight-medium);
+	}
+
 	@include mobile {
 		gap: var(--spacing-2);
 		justify-content: flex-start;

package/themes/umberto/layout/gloria/_modules/header-lts-info/index.pug

@@ -0,0 +1,69 @@
+mixin header-lts-info()
+	+preload-svg-spritesheet-icon({ icon: 'exclamation-circle' })
+	if isLts
+		-
+			const latestUrl = `${ page.canonicalUrlBeginning }${ page.path }`
+				.replace('ckeditor5.github.io/', 'ckeditor.com/')
+				.replace(/\/ckeditor5\/lts-v\d+(?=\/|$)/, '/ckeditor5/latest')
+				.replace(projectLocals.projectVersion, 'latest')
+				.replace(/\/+$/, '');
+
+		+header-bar({ variant: 'lts', ariaLabel: 'LTS documentation' })
+			span.c-icon-message.u-font-weight--bold
+				span.c-icon-message__icon
+					+svg-icon({ icon: 'exclamation-circle', size: 'lg', ariaHidden: true })
+				span.c-icon-message__content LTS
+
+			span.c-header-bar__message
+				span You're in the Long Term Support Edition documentation.
+				|  
+				a.b-link.u-text-decoration--underline(href=latestUrl) Go to the latest version of the standard edition.
+
+	script.
+		(function() {
+			document.addEventListener( 'DOMContentLoaded', () => {
+				if ( !/\/ckeditor5\/lts-v\d+(?:\/|$)/.test( window.location.pathname ) ) {
+					return;
+				}
+
+				if ( document.querySelector( '.c-header-bar--lts' ) ) {
+					return;
+				}
+
+				document.querySelector( '.c-header-bar[aria-label="Legacy documentation warning"]' )?.remove();
+
+				const insertionPoint = document.querySelector( '.js-header-bar, .js-header' );
+
+				if ( !insertionPoint?.parentNode ) {
+					return;
+				}
+
+				const latestUrl = new URL( window.location.href );
+
+				latestUrl.pathname = latestUrl.pathname.replace( /\/ckeditor5\/lts-v\d+(?=\/|$)/, '/ckeditor5/latest' );
+				latestUrl.hash = '';
+
+				const banner = document.createElement( 'div' );
+
+				banner.innerHTML = `
+					<div class="c-header-bar c-header-bar--lts js-header-bar" role="region" aria-label="LTS documentation">
+						<span class="c-icon-message u-font-weight--bold">
+							<span class="c-icon-message__icon">
+								<svg-icon icon="exclamation-circle" size="lg" aria-hidden="true"></svg-icon>
+							</span>
+							<span class="c-icon-message__content">LTS</span>
+						</span>
+						<span class="c-header-bar__message">
+							<span>You're in the Long Term Support Edition documentation.&nbsp;</span>
+							<a class="b-link u-text-decoration--underline" href="${ latestUrl.toString() }">Go to the latest version of the standard edition.</a>
+						</span>
+					</div>
+				`.trim();
+
+				insertionPoint.parentNode.insertBefore( banner.firstElementChild, insertionPoint );
+
+				if ( window.umberto?.Header?.the ) {
+					window.umberto.Header.the.dispatchHeaderResizeEvent();
+				}
+			}, { once: true } );
+		})();

package/themes/umberto/layout/gloria/_modules/header-nightly-info/index.pug

@@ -1,4 +1,5 @@
 mixin header-nightly-info()
+	+preload-svg-spritesheet-icon({ icon: 'exclamation-circle' })
 	if isNightly
 		-
 			const stableUrl = `${ page.canonicalUrlBeginning }${ page.path }`
@@ -7,15 +8,13 @@ mixin header-nightly-info()
 				.replace(projectLocals.projectVersion, 'latest')
 				.replace(/\/+$/, '');
 
-		+header-bar({ variant: 'info', ariaLabel: 'Nightly build documentation' })
-			+icon-message({
-				icon: 'info-circle',
-				iconSize: 'lg',
-				className: 'font-weight--bold'
-			})
-				| NIGHTLY
+		+header-bar({ variant: 'warning', ariaLabel: 'Nightly build documentation' })
+			span.c-icon-message.u-font-weight--bold
+				span.c-icon-message__icon
+					+svg-icon({ icon: 'exclamation-circle', size: 'lg', ariaHidden: true })
+				span.c-icon-message__content NIGHTLY
 
-			span
+			span.c-header-bar__message
 				span You're viewing the nightly build documentation.
 				|  
-				a.b-link.u-color--white.u-text-decoration--underline(href=stableUrl) Go to the stable version.
+				a.b-link.u-text-decoration--underline(href=stableUrl) Go to the stable version.

package/themes/umberto/layout/gloria/_modules/index.pug

@@ -6,8 +6,8 @@ include ./sidebar/index
 include ./sidebar-api/index
 include ./mobile-nav/index
 include ./header-bar/index
-include ./header-legacy-warning/index
 include ./header-nightly-info/index
+include ./header-lts-info/index
 include ./header-promobar/index
 include ./breadcrumbs/index
 include ./algolia-search/index

package/themes/umberto/layout/gloria/_modules/kapa/index.pug

@@ -121,9 +121,28 @@ mixin load-kapa-script( kapa )
 			return projectConfig.exampleQuestions.join( ',' );
 		}
 
+		function getSourceGroupIds() {
+			const defaultSourceGroupIds = ( kapa.default.sourceGroupIds || [] ).join( ',' );
+
+			if ( !projectConfig ) {
+				return defaultSourceGroupIds;
+			}
+
+			if ( !projectConfig.sourceGroupIds ) {
+				return defaultSourceGroupIds;
+			}
+
+			if ( !projectConfig.sourceGroupIds.length ) {
+				return defaultSourceGroupIds;
+			}
+
+			return projectConfig.sourceGroupIds.join( ',' );
+		}
+
 		attributes[ 'data-modal-title' ] = getModalTitle( projectConfig );
 		attributes[ 'data-modal-ask-ai-input-placeholder' ] = getQuestionPlaceholder();
 		attributes[ 'data-modal-example-questions' ] = getExampleQuestions();
+		attributes[ 'data-source-group-ids-include' ] = getSourceGroupIds();
 
 	script&attributes(attributes)
 

package/themes/umberto/layout/gloria/api.pug

@@ -8,7 +8,7 @@ html(lang='en')
 		include _head/index
 	body.l-layout.js-layout
 		+header-nightly-info
-		+header-legacy-warning
+		+header-lts-info
 		+header-promobar
 		+header({ className: 'l-layout__header' })
 

package/themes/umberto/layout/gloria/base.pug

@@ -7,7 +7,7 @@ html(lang='en')
 		include _head/index
 	body.l-layout.js-layout
 		+header-nightly-info
-		+header-legacy-warning
+		+header-lts-info
 		+header-promobar
 		+header({ className: 'l-layout__header' })
 

package/themes/umberto/layout/gloria/index.pug

@@ -8,6 +8,7 @@ html(lang='en')
 
 	body.l-layout.l-layout--muted.js-layout
 		+header-nightly-info
+		+header-lts-info
 		+header-promobar
 		+header({
 			className: 'l-layout__header',

package/themes/umberto/src/gloria/js/modules/algolia-search.js

@@ -9,6 +9,7 @@ import { injectScript } from '../helpers/inject-script.js';
 import { compose } from '../helpers/compose.js';
 
 const DOCSEARCH_JS_URL = 'https://cdn.jsdelivr.net/npm/@docsearch/js@3.9.0/dist/umd/index.min.js';
+const LTS_DOC_VERSION_REGEXP = /\/ckeditor5\/(lts-v\d+)(?:\/|$)/;
 
 /**
  * Component responsible for binding the algolia search component to the header.
@@ -60,6 +61,8 @@ export class AlgoliaSearch extends BaseComponent {
 		const { boost, filters } = this;
 		const { slug, tags } = filters;
 
+		const docVersion = window.location.pathname.match( LTS_DOC_VERSION_REGEXP )?.[ 1 ] || 'latest';
+
 		window.docsearch( {
 			container: this.elements.wrapper,
 			...this.config,
@@ -73,7 +76,7 @@ export class AlgoliaSearch extends BaseComponent {
 				client.search = async ( options, ...rest ) => {
 					const { results: [ firstResult ] } = await originalSearch( options, ...rest );
 					const mappedResults = compose(
-						filterByTags( { slug, tags } ),
+						filterResults( { slug, tags, docVersion } ),
 						boostByTags( boost.tags )
 					)( firstResult.hits );
 
@@ -136,14 +139,15 @@ export class AlgoliaSearch extends BaseComponent {
 }
 
 /**
- * Crates filters for Algolia that allow to filter out results from different projects.
- * Algolia shares the same index for all projects, so we need to filter results
+ * Creates filters for Algolia that allow to filter out results from different projects and types of the documentation (latest vs. LTS).
+ * Algolia shares the same index for all projects, so we need to filter results.
  */
-function filterByTags( { slug, tags } ) {
+function filterResults( { slug, tags, docVersion } ) {
 	return hits => hits.filter(
 		hit =>
 			( !slug || hit.tags.includes( slug ) ) &&
-			( !tags || hit.tags.some( tag => tags.includes( tag ) ) )
+			( !tags || hit.tags.some( tag => tags.includes( tag ) ) ) &&
+			( !hit.docVersion || hit.docVersion === docVersion )
 	);
 }
 

package/themes/umberto/src/gloria/js/modules/links-prefetch.js

@@ -124,6 +124,10 @@ export class LinksPrefetch {
  * @returns Whether the URL should be preloaded
  */
 function isPreloadable( url ) {
+	if ( !url ) {
+		return false;
+	}
+
 	try {
 		const urlObj = new URL( url );
 		const currentDomain = window.location.hostname;

package/themes/umberto/layout/gloria/_modules/header-legacy-warning/index.pug

@@ -1,11 +0,0 @@
-mixin header-legacy-warning()
-	if isLegacy && (!sitemap || !isNightly)
-		+header-bar({ variant: 'warning', ariaLabel: 'Legacy documentation warning' })
-			+icon-message({
-				icon: 'exclamation-circle',
-				iconSize: 'lg',
-				className: 'u-font-weight--bold'
-			})
-				| WARNING
-
-			span You're reading the legacy documentation.