umberto 10.6.0 → 10.7.0

package/CHANGELOG.md

@@ -1,47 +1,57 @@
 Changelog
 =========
 
-## [10.6.0](https://github.com/cksource/umberto/compare/v10.5.1...v10.6.0) (June 8, 2026)
+## [10.7.0](https://github.com/cksource/umberto/compare/v10.6.1...v10.7.0) (July 2, 2026)
 
 ### Features
 
-* Improved rendering of complex TypeScript types in API docs.
+* Enabled MCP install menu in the Kapa widget.
 
-  Intersection (`A & B`), tuple (`[ key: T, value: U ]`), and conditional (`T extends U ? X : Y`) types now render with their full structure preserved and each reference linkable, instead of collapsing to a generic `object` or `tuple` placeholder. Optional tuple elements display the trailing `?` from the source. The `infer X` keyword inside conditionals renders as such and no longer triggers "unsupported type" warnings during the docs build.
+### Bug fixes
 
-  Properties tables on intersection type aliases now list the fields from the inline-literal half — including nested cases like `abc: A & { b: T }`, which now exposes `abc.b` as a sub-row, and cases where the inline literal is wrapped in `Partial<...>`, `Readonly<...>`, or `Required<...>`, where the wrapper's modifier is applied to each field. Per-field inline TSDoc comments (`/** ... */`) above each field render their descriptions in the Properties table, where they were previously dropped.
+* Fixed scrolling to a section in the Gloria theme when navigating to an anchor without a full page reload — for example, changing the anchor in the address bar, using the browser's back/forward buttons, or opening a link to a section on the current page. The target heading is now offset below the sticky header instead of being hidden beneath it.
+* Moved `chokidar` from `devDependencies` to `dependencies`. It is imported at runtime by the file watcher (`src/tasks/watcher.js`), which ships with the package, so it must be installed for consumers. Previously it resolved only by chance through a hoisted copy in the consumer's tree, which fails when the consumer enables pnpm's `enableGlobalVirtualStore` and the package is linked from the global store, outside the consumer's `node_modules`.
 
 ### Other changes
 
-* Updated the GTM integration to use the new server-side setup in both Gloria and legacy Umberto themes.
+* The tabbed content component now sets a `data-tab-label` attribute on each tab panel, carrying the label of its tab. This exposes the label to tools that process the rendered HTML, where it otherwise lives only inside the tab button.
 
 
-## [10.5.1](https://github.com/cksource/umberto/compare/v10.5.0...v10.5.1) (May 14, 2026)
+## [10.6.1](https://github.com/cksource/umberto/compare/v10.6.0...v10.6.1) (June 18, 2026)
 
-### Bug fixes
+### Other changes
 
-* Changed the call for feedback title from `<h3>` to `<div>` to prevent it from appearing in the table of contents.
+* Updated homepage link.
+* Restored the web-based Google Tag Manager snippets in both Gloria and legacy Umberto themes.
 
 
-## [10.5.0](https://github.com/cksource/umberto/compare/v10.4.1...v10.5.0) (April 14, 2026)
+## [10.6.0](https://github.com/cksource/umberto/compare/v10.5.1...v10.6.0) (June 8, 2026)
 
 ### Features
 
-* Added the Call for feedback component for documentation pages.
+* Improved rendering of complex TypeScript types in API docs.
+
+  Intersection (`A & B`), tuple (`[ key: T, value: U ]`), and conditional (`T extends U ? X : Y`) types now render with their full structure preserved and each reference linkable, instead of collapsing to a generic `object` or `tuple` placeholder. Optional tuple elements display the trailing `?` from the source. The `infer X` keyword inside conditionals renders as such and no longer triggers "unsupported type" warnings during the docs build.
 
+  Properties tables on intersection type aliases now list the fields from the inline-literal half — including nested cases like `abc: A & { b: T }`, which now exposes `abc.b` as a sub-row, and cases where the inline literal is wrapped in `Partial<...>`, `Readonly<...>`, or `Required<...>`, where the wrapper's modifier is applied to each field. Per-field inline TSDoc comments (`/** ... */`) above each field render their descriptions in the Properties table, where they were previously dropped.
 
-## [10.4.1](https://github.com/cksource/umberto/compare/v10.4.0...v10.4.1) (April 13, 2026)
+### Other changes
+
+* Updated the GTM integration to use the new server-side setup in both Gloria and legacy Umberto themes.
+
+
+## [10.5.1](https://github.com/cksource/umberto/compare/v10.5.0...v10.5.1) (May 14, 2026)
 
 ### Bug fixes
 
-* Fixed URL in the dropdown for LTS item to have absolute URL to pass documentation validation.
+* Changed the call for feedback title from `<h3>` to `<div>` to prevent it from appearing in the table of contents.
 
 
-## [10.4.0](https://github.com/cksource/umberto/compare/v10.3.0...v10.4.0) (April 9, 2026)
+## [10.5.0](https://github.com/cksource/umberto/compare/v10.4.1...v10.5.0) (April 14, 2026)
 
 ### Features
 
-* Added the LTS edition to the docs product picker.
+* Added the Call for feedback component for documentation pages.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "10.6.0",
+  "version": "10.7.0",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "type": "module",
@@ -20,6 +20,7 @@
     "@minify-html/node": "^0.17.1",
     "@vscode/markdown-it-katex": "^1.1.2",
     "babel-loader": "^10.0.0",
+    "chokidar": "^4.0.3",
     "css-select": "^6.0.0",
     "dom-serializer": "^2.0.0",
     "domhandler": "^5.0.3",

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

@@ -70,6 +70,7 @@ mixin tabs({ id: tabsId, ariaLabel = 'Tabbed content', className, align = 'left'
 				aria-labelledby=`${idPrefix}-${ id }-tab`
 				aria-hidden=tab.active ? 'false' : 'true'
 				data-tab-id=id
+				data-tab-label=tab.label
 				class={
 					[className]: !!className,
 					'is-spaced': tab.spaced,

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

@@ -12,8 +12,8 @@ mixin header({ withChooseProject = true, className = '' } = {})
 		.c-header__mobile.l-hide-desktop
 			.c-header__mobile-brand
 				a.b-link.u-display-inline-flex(
-					title='Navigate to the CKEditor Ecosystem Documentation homepage',
-					href=relative_url(page.path, 'index.html')
+					title='Navigate to the CKEditor homepage',
+					href='https://ckeditor.com'
 				)
 					+inline-svg({ file: 'ckeditor-logo', ariaHidden: true, className: 'c-header__brand-logo' })
 
@@ -39,8 +39,8 @@ mixin header({ withChooseProject = true, className = '' } = {})
 			.c-header__brand-row
 				.c-header__brand-row-selector.u-flex-horizontal.u-align-items-center
 					a.b-link.u-display-inline-flex(
-						title='Navigate to the CKEditor Ecosystem Documentation homepage',
-						href=relative_url(page.path, 'index.html')
+						title='Navigate to the CKEditor homepage',
+						href='https://ckeditor.com'
 					)
 						+inline-svg({ file: 'ckeditor-logo', ariaHidden: true, className: 'c-header__brand-logo' })
 

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

@@ -139,11 +139,32 @@ mixin load-kapa-script( kapa )
 			return projectConfig.sourceGroupIds.join( ',' );
 		}
 
+		function getMcpServerUrl() {
+			const defaultMcpServerUrl = kapa.default.mcpServerUrl || null;
+
+			if ( !projectConfig ) {
+				return defaultMcpServerUrl;
+			}
+
+			if ( !projectConfig.mcpServerUrl ) {
+				return defaultMcpServerUrl;
+			}
+
+			return projectConfig.mcpServerUrl;
+		}
+
 		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();
 
+		const mcpServerUrl = getMcpServerUrl();
+
+		if ( mcpServerUrl ) {
+			attributes[ 'data-mcp-enabled' ] = 'true';
+			attributes[ 'data-mcp-server-url' ] = mcpServerUrl;
+		}
+
 	script&attributes(attributes)
 
 	style#custom_kapa_styles

package/themes/umberto/layout/gloria/_trackers/google-tag-manager-noscript.pug

@@ -1,4 +1,4 @@
 mixin google-tag-manager-noscript()
 	if googletagmanager && googletagmanager.gtm
 		noscript
-			iframe( src='https://load.site.ckeditor.com/ns.html?id=' + googletagmanager.gtm height='0' width='0' style='display:none;visibility:hidden' )
+			iframe( src='https://www.googletagmanager.com/ns.html?id=' + googletagmanager.gtm height='0' width='0' style='display:none;visibility:hidden' )

package/themes/umberto/layout/gloria/_trackers/google-tag-manager.pug

@@ -1,38 +1,14 @@
 if googletagmanager
 	script.
 		if (!{ JSON.stringify(googletagmanager.domains) }.indexOf(location.hostname) !== -1) {
-			!function() {
-				"use strict";
-				function l(e) { for (var t = e, r = 0, n = document.cookie.split(";"); r < n.length; r++) { var o = n[r].split("="); if (o[0].trim() === t) return o[1]; } }
-				function s(e) { return localStorage.getItem(e); }
-				function u(e) { return window[e]; }
-				function A(e, t) { e = document.querySelector(e); return t ? null == e ? void 0 : e.getAttribute(t) : null == e ? void 0 : e.textContent; }
-				var e = window, t = document, r = "script", n = "dataLayer",
-					o = "https://site.ckeditor.com",
-					a = "https://load.site.ckeditor.com",
-					i = "9ao1wxbphqbpj",
-					c = "dy7f4ho=AxRfNjw9TzMsIzFHJFYURVheU1cMHl8bARUGGBwfEFYJHw8%3D",
-					g = "cookie", v = "_stape_uid", E = "", d = !1;
-				try {
-					var d = !!g && (m = navigator.userAgent, !!(m = new RegExp("Version/([0-9._]+)(.*Mobile)?.*Safari.*").exec(m))) && 16.4 <= parseFloat(m[1]),
-						f = "stapeUserId" === g,
-						I = d && !f
-							? function(e, t, r) {
-								void 0 === t && (t = "");
-								var n = { cookie: l, localStorage: s, jsVariable: u, cssSelector: A }, t = Array.isArray(t) ? t : [t];
-								if (e && n[e]) { for (var o = n[e], a = 0, i = t; a < i.length; a++) { var c = i[a], c = r ? o(c, r) : o(c); if (c) return c; } }
-								else { console.warn("invalid uid source", e); }
-							}(g, v, E)
-							: void 0;
-					d = d && (!!I || f);
-				} catch(e) { console.error(e); }
-				var m = e,
-					g = (m[n] = m[n] || [], m[n].push({ "gtm.start": (new Date).getTime(), event: "gtm.js" }), t.getElementsByTagName(r)[0]),
-					v = I ? "&bi=" + encodeURIComponent(I) : "",
-					E = t.createElement(r),
-					f = (d && (i = 8 < i.length ? i.replace(/([a-z]{8}$)/, "kp$1") : "kp" + i), !d && a ? a : o);
-				E.async = !0;
-				E.src = f + "/" + i + ".js?" + c + v;
-				null != (e = g.parentNode) && e.insertBefore(E, g);
-			}();
+			(function (w, d, s, l, i) {
+				w[l] = w[l] || [];
+				w[l].push({'gtm.start': new Date().getTime(), event: 'gtm.js'});
+				var f = d.getElementsByTagName(s)[0],
+					j = d.createElement(s),
+					dl = l != 'dataLayer' ? '&l=' + l : '';
+				j.async = true;
+				j.src = 'https://www.googletagmanager.com/gtm.js?id=' + i + dl;
+				f.parentNode.insertBefore(j, f);
+			})( window, document, 'script', 'dataLayer', '!{ googletagmanager.gtm }' );
 		}

package/themes/umberto/layout/umberto/_partial/google-tag-manager.pug

@@ -1,38 +1,14 @@
 if googletagmanager
 	script.
 		if (!{ JSON.stringify(googletagmanager.domains) }.indexOf(location.hostname) !== -1) {
-			!function() {
-				"use strict";
-				function l(e) { for (var t = e, r = 0, n = document.cookie.split(";"); r < n.length; r++) { var o = n[r].split("="); if (o[0].trim() === t) return o[1]; } }
-				function s(e) { return localStorage.getItem(e); }
-				function u(e) { return window[e]; }
-				function A(e, t) { e = document.querySelector(e); return t ? null == e ? void 0 : e.getAttribute(t) : null == e ? void 0 : e.textContent; }
-				var e = window, t = document, r = "script", n = "dataLayer",
-					o = "https://site.ckeditor.com",
-					a = "https://load.site.ckeditor.com",
-					i = "9ao1wxbphqbpj",
-					c = "dy7f4ho=AxRfNjw9TzMsIzFHJFYURVheU1cMHl8bARUGGBwfEFYJHw8%3D",
-					g = "cookie", v = "_stape_uid", E = "", d = !1;
-				try {
-					var d = !!g && (m = navigator.userAgent, !!(m = new RegExp("Version/([0-9._]+)(.*Mobile)?.*Safari.*").exec(m))) && 16.4 <= parseFloat(m[1]),
-						f = "stapeUserId" === g,
-						I = d && !f
-							? function(e, t, r) {
-								void 0 === t && (t = "");
-								var n = { cookie: l, localStorage: s, jsVariable: u, cssSelector: A }, t = Array.isArray(t) ? t : [t];
-								if (e && n[e]) { for (var o = n[e], a = 0, i = t; a < i.length; a++) { var c = i[a], c = r ? o(c, r) : o(c); if (c) return c; } }
-								else { console.warn("invalid uid source", e); }
-							}(g, v, E)
-							: void 0;
-					d = d && (!!I || f);
-				} catch(e) { console.error(e); }
-				var m = e,
-					g = (m[n] = m[n] || [], m[n].push({ "gtm.start": (new Date).getTime(), event: "gtm.js" }), t.getElementsByTagName(r)[0]),
-					v = I ? "&bi=" + encodeURIComponent(I) : "",
-					E = t.createElement(r),
-					f = (d && (i = 8 < i.length ? i.replace(/([a-z]{8}$)/, "kp$1") : "kp" + i), !d && a ? a : o);
-				E.async = !0;
-				E.src = f + "/" + i + ".js?" + c + v;
-				null != (e = g.parentNode) && e.insertBefore(E, g);
-			}();
+			(function (w, d, s, l, i) {
+				w[l] = w[l] || [];
+				w[l].push({'gtm.start': new Date().getTime(), event: 'gtm.js'});
+				var f = d.getElementsByTagName(s)[0],
+					j = d.createElement(s),
+					dl = l != 'dataLayer' ? '&l=' + l : '';
+				j.async = true;
+				j.src = 'https://www.googletagmanager.com/gtm.js?id=' + i + dl;
+				f.parentNode.insertBefore(j, f);
+			})( window, document, 'script', 'dataLayer', '!{ googletagmanager.gtm }' );
 		}

package/themes/umberto/layout/umberto/_partial/header.pug

@@ -4,7 +4,7 @@ if googletagmanager && googletagmanager.gtm
 
 	//- Google Tag Manager (noscript)
 	noscript
-		iframe( src="https://load.site.ckeditor.com/ns.html?id=" + googletagmanager.gtm height="0" width="0" style="display:none;visibility:hidden" )
+		iframe( src="https://www.googletagmanager.com/ns.html?id=" + googletagmanager.gtm height="0" width="0" style="display:none;visibility:hidden" )
 	//- End Google Tag Manager (noscript)
 
 header.top( data-project= projectLocals ? projectLocals.projectSlug : undefined )

package/themes/umberto/src/gloria/css/layout/_base.scss

@@ -5,6 +5,10 @@
 		height: 100%;
 		overscroll-behavior-y: none; /* Prevent vertical bounce, allow horizontal trackpad gestures. */
 		overflow-x: hidden;
+
+		/* Offset native fragment navigation (anchor jumps, pasting a hash URL) below the
+		   sticky header. `--header-height` is kept up to date by the header module. */
+		scroll-padding-top: calc(var(--header-height, 0px) + 32px);
 	}
 
 	body {

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

@@ -18,6 +18,10 @@ export class HashLink extends BaseComponent {
 		// Handle initial hash link navigation if present in the URL
 		this._handleInitialHash();
 
+		// Handle hash changes on an already-loaded page (e.g. editing the hash in the
+		// address bar or browser back/forward navigation).
+		this._handleHashChange();
+
 		// Add click event listener to handle hash link clicks
 		document.addEventListener( 'click', event => {
 			const target = event.target.closest( 'a[href^="#"]' );
@@ -57,4 +61,30 @@ export class HashLink extends BaseComponent {
 			} );
 		}, { once: true } );
 	}
+
+	/**
+	 * Handles hash changes that happen without a full page reload, e.g. editing the
+	 * hash in the address bar or navigating with the browser's back/forward buttons.
+	 *
+	 * In these cases the browser performs native fragment navigation, which scrolls
+	 * the target to the very top of the viewport without accounting for the sticky
+	 * header. Re-running the scroll with the proper offset keeps the heading visible.
+	 *
+	 * Clicking an `a[href^="#"]` link does not trigger this handler, because the click
+	 * handler updates the URL via `history.pushState()`, which does not emit a
+	 * `hashchange` event.
+	 *
+	 * @private
+	 */
+	static _handleHashChange() {
+		window.addEventListener( 'hashchange', () => {
+			if ( !window.location.hash ) {
+				return;
+			}
+
+			scrollToHash( window.location.hash.substring( 1 ), {
+				pushState: false
+			} );
+		} );
+	}
 }

package/themes/umberto/src/gloria/js/modules/header.js

@@ -83,6 +83,11 @@ export class Header extends BaseComponent {
 			this.element.classList.toggle( 'is-on-top-overlay', state.isOnOverlay );
 			this.dispatchHeaderResizeEvent();
 		} else if ( prevState?.height !== state.height && state.height !== null ) {
+			// Expose the header height on the document root so that native fragment navigation
+			// (e.g. pasting a URL with a hash, which fires no `hashchange` or `load` event) can
+			// offset the target below the sticky header via `scroll-padding-top`. See `_base.scss`.
+			document.documentElement.style.setProperty( '--header-height', `${ state.height }px` );
+
 			this.dispatchHeaderResizeEvent();
 		}
 	}
@@ -128,7 +133,7 @@ export class Header extends BaseComponent {
 	}
 
 	/**
-	 * Sets the header height variable on the body element.
+	 * Tracks the header height and updates the component state.
 	 */
 	_trackHeight() {
 		this.setState( {