umberto 10.7.3 → 10.7.5

package/CHANGELOG.md

@@ -1,53 +1,47 @@
 Changelog
 =========
 
-## [10.7.3](https://github.com/cksource/umberto/compare/v10.7.2...v10.7.3) (July 22, 2026)
+## [10.7.5](https://github.com/cksource/umberto/compare/v10.7.4...v10.7.5) (August 13, 2026)
 
 ### Bug fixes
 
-* Fixed live snippets failing to load in browsers that require import maps before module scripts.
-
-
-## [10.7.2](https://github.com/cksource/umberto/compare/v10.7.1...v10.7.2) (July 16, 2026)
+* The hierarchy of a class or an interface rendered in the API docs built from Typedoc output now contains the full inheritance chain instead of the first level only. Derived classes, derived interfaces, and implementing classes are also resolved transitively, so the "Subclasses", "Implemented by", and "Implements" lists match the behavior of the JSDoc-based pipeline.
 
 ### Other changes
 
-* Replaced webpack with Rolldown for building theme scripts. The theme bundles are now built as ES modules with code splitting and loaded via `<script type="module">`, keeping dynamically imported dependencies (such as the shiki grammars in the Gloria theme) in separate, lazily loaded chunks. The output targets ES2022 instead of the Babel-transpiled ES5, and `webpack`, `babel-loader`, `@babel/core`, and `@babel/preset-env` are no longer dependencies of the package.
-
-
-## [10.7.1](https://github.com/cksource/umberto/compare/v10.7.0...v10.7.1) (July 15, 2026)
+* Unified the rendering of optional properties and parameters in the API documentation in the Gloria theme. Optional members are now marked with the TypeScript question mark suffix, and the separator between a member name and its type no longer contains a space before the colon, matching the TypeScript syntax (for example `options?: Object` instead of `[ options ] : Object`). Previously, optional parameters were wrapped in square brackets and optional properties had the `undefined` type appended to their type lists.
 
-### 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.
+## [10.7.4](https://github.com/cksource/umberto/compare/v10.7.3...v10.7.4) (July 27, 2026)
 
 ### 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%.
+* This release does not include any user-facing changes. It was published solely to verify the release process.
 
 
-## [10.7.0](https://github.com/cksource/umberto/compare/v10.6.1...v10.7.0) (July 2, 2026)
+## [10.7.3](https://github.com/cksource/umberto/compare/v10.7.2...v10.7.3) (July 22, 2026)
 
-### Features
+### Bug fixes
 
-* Enabled MCP install menu in the Kapa widget.
+* Fixed live snippets failing to load in browsers that require import maps before module scripts.
 
-### Bug fixes
 
-* 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`.
+## [10.7.2](https://github.com/cksource/umberto/compare/v10.7.1...v10.7.2) (July 16, 2026)
 
 ### Other changes
 
-* 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.
+* Replaced webpack with Rolldown for building theme scripts. The theme bundles are now built as ES modules with code splitting and loaded via `<script type="module">`, keeping dynamically imported dependencies (such as the shiki grammars in the Gloria theme) in separate, lazily loaded chunks. The output targets ES2022 instead of the Babel-transpiled ES5, and `webpack`, `babel-loader`, `@babel/core`, and `@babel/preset-env` are no longer dependencies of the package.
+
+
+## [10.7.1](https://github.com/cksource/umberto/compare/v10.7.0...v10.7.1) (July 15, 2026)
 
+### Bug fixes
 
-## [10.6.1](https://github.com/cksource/umberto/compare/v10.6.0...v10.6.1) (June 18, 2026)
+* 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
 
-* Updated homepage link.
-* Restored the web-based Google Tag Manager snippets in both Gloria and legacy Umberto themes.
+* 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%.
 
 ---
 

package/package.json

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

package/scripts/filter/after-post-render/process-variables.cjs

@@ -61,4 +61,3 @@ function onError( match, source ) {
 
 	return match;
 }
-

package/scripts/helper/mark-empty-categories.cjs

@@ -34,4 +34,3 @@ hexo.extend.helper.register( 'markEmptyCategories', ( () => {
 		return categories;
 	} );
 } )() );
-

package/scripts/utils/markdown-it-toc-and-anchor.cjs

@@ -200,8 +200,6 @@ module.exports = function markdownItTocAndAnchor( md, options ) {
 		}
 
 		const tocArray = [];
-		let tocMarkdown = '';
-		let tocTokens = [];
 
 		const slugifyFn = typeof options.slugify === 'function' ? options.slugify : defaultSlugify;
 
@@ -242,8 +240,8 @@ module.exports = function markdownItTocAndAnchor( md, options ) {
 			} );
 		}
 
-		tocMarkdown = generateTocMarkdownFromArray( tocArray, options );
-		tocTokens = markdownItSecondInstance.parse( tocMarkdown, {} );
+		const tocMarkdown = generateTocMarkdownFromArray( tocArray, options );
+		const tocTokens = markdownItSecondInstance.parse( tocMarkdown, {} );
 
 		if ( typeof tocTokens[ 0 ] === 'object' && tocTokens[ 0 ].type === 'bullet_list_open' ) {
 			const attrs = ( tocTokens[ 0 ].attrs = tocTokens[ 0 ].attrs || [] );
@@ -280,11 +278,11 @@ module.exports = function markdownItTocAndAnchor( md, options ) {
 			return false;
 		}
 
-		let token = state.push( 'toc_open', 'toc', 1 );
+		const token = state.push( 'toc_open', 'toc', 1 );
 
 		token.markup = TOC;
-		token = state.push( 'toc_body', '', 0 );
-		token = state.push( 'toc_close', 'toc', -1 );
+		state.push( 'toc_body', '', 0 );
+		state.push( 'toc_close', 'toc', -1 );
 
 		state.pos += match[ 0 ].length;
 

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

@@ -123,7 +123,7 @@ function renderXMLPugComponentsInMarkdown( xml, options ) {
 					);
 
 					// Render component wrapper
-					let finalReplacement = null;
+					let finalReplacement;
 
 					try {
 						const template = getCompiledPugTemplate( hexo, content, basePath );

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

@@ -65,7 +65,7 @@ export function findTargetDoclet( docletCollection, options ) {
 	}
 
 	if ( collection.isEmpty ) {
-		const typedefCollection = collection = docletCollection.get( `ln:${ structure }` );
+		const typedefCollection = docletCollection.get( `ln:${ structure }` );
 
 		if ( typedefCollection.isEmpty ) {
 			return null;

package/src/data-converter/converters/jsduck2umberto.js

@@ -71,13 +71,13 @@ const keyNameMap = {
  * @returns {Array}
  */
 export const jsduck2umberto = data => {
-	let parsed = {};
+	let parsed;
 	const doclets = [];
 
 	try {
 		parsed = JSON.parse( data );
 	} catch ( err ) {
-		throw new Error( `Failed to convert JSDuck docs to Umberto format. ${ err.stack }` );
+		throw new Error( `Failed to convert JSDuck docs to Umberto format. ${ err.stack }`, { cause: err } );
 	}
 
 	const mainDoclet = parsed;

package/src/data-converter/converters/typedoc/typedocconverter.js

@@ -89,6 +89,9 @@ export class TypedocConverter {
 			this._convertChild( child );
 		}
 
+		// Resolve full inheritance chains while all doclets still carry their original signatures.
+		this._buildHierarchy();
+
 		// Then, when all doclets are specified, let's align types.
 		for ( const doclet of this._doclets ) {
 			// Skip source if the `file` property is not specified.
@@ -101,28 +104,6 @@ export class TypedocConverter {
 				continue;
 			}
 
-			// TODO: Could we get a deep list of all inheritance/derived?
-			// Map parent references of classes and interfaces...
-			if ( 'augmentsNested' in doclet ) {
-				const extendedTypes = doclet._signature.extendedTypes || [];
-
-				doclet.augmentsNested = extendedTypes.flatMap( getHierarchyCallback( this._typeConverter ) );
-			}
-
-			// ...but also, the derived instances...
-			if ( 'descendants' in doclet ) {
-				const extendedBy = doclet._signature.extendedBy || [];
-
-				doclet.descendants = extendedBy.flatMap( getHierarchyCallback( this._typeConverter ) );
-			}
-
-			// ...and implemented interfaces.
-			if ( 'implementsNested' in doclet ) {
-				const implementedTypes = doclet._signature.implementedTypes || [];
-
-				doclet.implementsNested = implementedTypes.flatMap( getHierarchyCallback( this._typeConverter ) );
-			}
-
 			// Unify the `_signature` tuple, so all doclets use the same algorithm.
 			if ( !Array.isArray( doclet._signature ) ) {
 				doclet._signature = [ doclet._signature, doclet._signature ];
@@ -185,6 +166,92 @@ export class TypedocConverter {
 			} );
 	}
 
+	/**
+	 * Fills the `augmentsNested`, `implementsNested`, and `descendants` properties of class and interface doclets
+	 * with full inheritance chains. Typedoc signatures (`extendedTypes`, `implementedTypes`, `extendedBy`) describe
+	 * only the first level of the hierarchy, so ancestor references are followed transitively through the converted
+	 * doclets.
+	 *
+	 * The `augmentsNested` chain continues only through ancestors of the same kind. Ancestors of an interface mixed
+	 * into a class hierarchy (an intersection in `extendedTypes`) extend the list of implemented interfaces instead
+	 * of the inheritance chain rendered on a page. Descendants are calculated by inverting the resolved ancestor
+	 * relations, so both directions of the hierarchy stay consistent.
+	 *
+	 * @protected
+	 */
+	_buildHierarchy() {
+		const docletsByLongname = new Map( this._doclets.map( doclet => [ doclet.longname, doclet ] ) );
+		const hierarchyDoclets = this._doclets.filter( doclet => doclet._signature && 'augmentsNested' in doclet );
+		const relationsCache = new Map();
+
+		const resolveRelations = doclet => {
+			if ( relationsCache.has( doclet ) ) {
+				return relationsCache.get( doclet );
+			}
+
+			const relations = { augmentsNested: [], implementsNested: [] };
+
+			// Fill the cache upfront to break potential reference cycles.
+			relationsCache.set( doclet, relations );
+
+			const collect = ( references, relationName ) => {
+				for ( const reference of references.flatMap( flattenHierarchyReference ) ) {
+					const longname = this._typeConverter.convertReference( reference );
+
+					relations[ relationName ].push( longname );
+
+					const ancestor = docletsByLongname.get( longname );
+
+					if ( !ancestor || !ancestor._signature || !( 'augmentsNested' in ancestor ) ) {
+						continue;
+					}
+
+					const ancestorRelations = resolveRelations( ancestor );
+
+					if ( relationName === 'augmentsNested' && ancestor.kind === doclet.kind ) {
+						relations.augmentsNested.push( ...ancestorRelations.augmentsNested );
+						relations.implementsNested.push( ...ancestorRelations.implementsNested );
+					} else {
+						relations.implementsNested.push( ...ancestorRelations.augmentsNested, ...ancestorRelations.implementsNested );
+					}
+				}
+			};
+
+			collect( doclet._signature.extendedTypes || [], 'augmentsNested' );
+			collect( doclet._signature.implementedTypes || [], 'implementsNested' );
+
+			relations.augmentsNested = [ ...new Set( relations.augmentsNested ) ].filter( name => name !== doclet.longname );
+			relations.implementsNested = [ ...new Set( relations.implementsNested ) ].filter( name => name !== doclet.longname );
+
+			return relations;
+		};
+
+		for ( const doclet of hierarchyDoclets ) {
+			const relations = resolveRelations( doclet );
+
+			doclet.augmentsNested = relations.augmentsNested;
+
+			if ( 'implementsNested' in doclet ) {
+				doclet.implementsNested = relations.implementsNested;
+			}
+
+			doclet.descendants = [];
+		}
+
+		for ( const doclet of hierarchyDoclets ) {
+			const relations = resolveRelations( doclet );
+			const ancestors = new Set( [ ...relations.augmentsNested, ...relations.implementsNested ] );
+
+			for ( const longname of ancestors ) {
+				const ancestor = docletsByLongname.get( longname );
+
+				if ( ancestor && 'descendants' in ancestor && ancestor.descendants ) {
+					ancestor.descendants.push( doclet.longname );
+				}
+			}
+		}
+	}
+
 	/**
 	 * @protected
 	 * @param {BaseReflection} reflection
@@ -964,17 +1031,18 @@ class TypeConverter {
 }
 
 /**
- * @param {TypeConverter} converter
- * @returns {Function}
+ * Flattens an intersection found in a hierarchy relation (for example, `class Foo extends Mixin( Base )` produces
+ * `Base & SomeInterface` in `extendedTypes`) into a list of plain references.
+ *
+ * @param {AvailableTypes} reference
+ * @returns {Array.<ReferenceType>}
  */
-function getHierarchyCallback( converter ) {
-	return reference => {
-		if ( reference.type === 'intersection' ) {
-			return reference.types.map( ref => converter.convertReference( ref ) );
-		}
+function flattenHierarchyReference( reference ) {
+	if ( reference.type === 'intersection' ) {
+		return reference.types;
+	}
 
-		return converter.convertReference( reference );
-	};
+	return [ reference ];
 }
 
 function mapIndexSignatureObject( subItem, index ) {

package/src/data-converter/data-collection.js

@@ -52,4 +52,3 @@ export class DataCollection {
 		return this._allData;
 	}
 }
-

package/src/data-converter/doclet-collection.js

@@ -112,4 +112,3 @@ function sortByName( a, b ) {
 
 	return 0;
 }
-

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

@@ -137,7 +137,7 @@ function getConfigurationFile( configPath ) {
 		// The configuration file should be a proper JSON object.
 		return JSON.parse( fs.readFileSync( configPath, 'utf8' ) );
 	} catch ( err ) {
-		throw new Error( 'Error when reading umberto.json: ' + err );
+		throw new Error( 'Error when reading umberto.json: ' + err, { cause: err } );
 	}
 }
 

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

@@ -26,17 +26,19 @@ mixin method( met )
 					code.api-item-heading__code
 						a.doc.b-link( class="member-name" href="#" + id ) #{ met.name }
 
-						//- params ( param1, [param2] )
+						//- params ( param1, param2? )
 						| (
 						if isNonEmptyArray( met.params )
 							each param, index in met.params
 								if param.optional
-									|  [ #{ param.name } ]
+									|  #{ param.name }?
 								else
 									|  #{ param.name }
 								if ( param.subParamsString )
 									//- Allow rendering HTML from the `subParamsString` as it may contain links to other pages.
-									| !{ param.subParamsString }
+									//- The string is prebuilt by the shared `api-builder` with the legacy `[name]`
+									//- convention for optional members, so convert it to the `name?` syntax here.
+									| !{ param.subParamsString.replace( /\[([\w$.]+)\]/g, '$1?' ) }
 								if index < met.params.length - 1
 									|,
 								else

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

@@ -14,21 +14,28 @@ mixin paramsMixin ( params, level, title )
 
             dt
                 code
+                    //- Consecutive piped text lines are joined with a newline, which renders as
+                    //- a space. To keep the TypeScript-style `name?: Type` notation, the colon
+                    //- must live in the same text node as the name.
+                    - const hasTypes = isNonEmptyArray( param.types );
+
                     if isComputedProperty
                         - const [ parentParam, nestedParam ] = param.name.split( '.' );
 
                         | #{ parentParam }
                         i
                             | #{ nestedParam }
-                    else if param.optional
-                        | [ #{ param.name } ]
+                        if hasTypes
+                            | :!{ ' ' }
+                            +type( param.types )
                     else
-                        | #{ param.name }
+                        - const displayName = param.optional ? `${ param.name }?` : param.name;
 
-                    if isNonEmptyArray( param.types )
-                        | :
-                        | !{ ' ' }
-                        +type( param.types )
+                        if hasTypes
+                            | #{ displayName }:!{ ' ' }
+                            +type( param.types )
+                        else
+                            | #{ displayName }
 
             dd
                 if ( param.description )

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

@@ -19,11 +19,11 @@ mixin property( prop )
 			h3
 				div.api-item-heading
 					code.api-item-heading__code
-						a.doc.b-link( class="member-name" href="#" + prop.id ) #{ prop.name }
+						a.doc.b-link( class="member-name" href="#" + prop.id ) #{ prop.optional ? prop.name + '?' : prop.name }
 
 						if isNonEmptyArray( prop.types )
-							|  :!{' '}
-							+type( prop.types, prop.optional )
+							| :!{' '}
+							+type( prop.types )
 					if isNonEmptyArray( prop.badges )
 						+tagWrapper()
 							each badge in prop.badges

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

@@ -1,16 +1,12 @@
 include ./_link-or-text.pug
 
-mixin type( types, isOptional = false )
+mixin type( types )
 	each nameOrObject, index in types
 		+renderType( nameOrObject )
 
 		if index < types.length - 1
 			| !{ ' | ' }
 
-	if ( isOptional && !types.includes( 'undefined' ) )
-		| !{ ' | ' }
-		+renderType( 'undefined' )
-
 //- TODO: Description.
 //-
 //- @param {String|*} inlineObjectOrType

package/themes/umberto/layout/gloria/_api-docs/_mixin/type-parameter.pug

@@ -8,7 +8,7 @@ mixin typeParameter( type )
 			//- We mark most TypeScript types as `object`, as their structure is complex.
 			//- Hence, it does not really make sense to show that a type extends an unknown `object`.
 			if ( type.value && type.value[ 0 ] !== 'object' )
-				| !{' : '}
+				| !{': '}
 				if ( type.isExtending )
 					i !{ 'extends ' }
 				+type( type.value )

package/themes/umberto/layout/gloria/_api-docs/_partial/type-parameters.pug

@@ -18,7 +18,7 @@ if isNonEmptyArray( data.typeParameters )
 								//- We mark most TypeScript types as `object`, as their structure is complex.
 								//- Hence, it does not really make sense to show that a type extends an unknown `object`.
 								if ( type.value && type.value[ 0 ] !== 'object' )
-									| !{' : '}
+									| !{': '}
 									if ( type.isExtending )
 										i !{ 'extends ' }
 									+type( type.value )

package/themes/umberto/layout/gloria/_modules/kapa/custom_kapa_styles.css

@@ -1,3 +1,8 @@
+/**
+ * @license Copyright (c) 2017-2026, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+
 /* Style for the floating button. */
 #kapa-button div > img + p {
 	position: relative;
@@ -11,9 +16,9 @@
 
 /* Style for hyperlinks inside the AI's answer. */
 #kapa-modal-content
-	.scrollable-container
-	.mantine-Title-root + div
-	a
+.scrollable-container
+.mantine-Title-root + div
+a
 {
 	font-weight: normal !important;
 	color: #743CCD !important;

package/themes/umberto/src/gloria/js/components/fake-devtools.js

@@ -570,7 +570,7 @@ class ObjectViewer extends HTMLElement {
 	}
 
 	createObjectPreview( data, isArray ) {
-		let previewContent = '';
+		let previewContent;
 
 		if ( isArray ) {
 			previewContent = html.span( { class: 'c-object-viewer__preview' },
@@ -640,8 +640,8 @@ class ObjectViewer extends HTMLElement {
 	}
 
 	formatPrimitiveValue( value ) {
-		let className = '';
-		let textContent = '';
+		let className;
+		let textContent;
 
 		switch ( typeof value ) {
 			case 'string':

package/themes/umberto/src/umberto/js/_apitree.js

@@ -44,7 +44,7 @@ export function scrollApiTree() {
 	const sideNavScrollTop = Number( window.localStorage.getItem( storageKey ) );
 	const activeTreeItemClass = 'tree__item__wrapper--active';
 	const activeTreeItem = $( `div.side-navigation .${ activeTreeItemClass }` );
-	let activeTreeItemTop = 0;
+	let activeTreeItemTop;
 	const bound = 50; // Offset from top and bottom of side nav.
 
 	if ( activeTreeItem.length ) {

package/themes/umberto/src/umberto/js/_pagenavigation.js

@@ -90,4 +90,3 @@ export function pageNavigation() {
 		}
 	}
 }
-