@ui5/builder 5.0.0-alpha.2 → 5.0.0-alpha.4

package/CHANGELOG.md

@@ -4,6 +4,54 @@ This project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html
 
 A list of unreleased changes can be found [here](https://github.com/SAP/ui5-builder/compare/v4.0.11...HEAD).
 
+## [5.0.0-alpha.4](https://github.com/UI5/cli/compare/builder-v5.0.0-alpha.3...builder-v5.0.0-alpha.4) (2026-03-24)
+
+
+### Features
+
+* **builder:** Add dynamic section for API reference during JSDoc build ([47970f7](https://github.com/UI5/cli/commit/47970f74c4adf63625e4f330f19090083f563f82))
+* **builder:** Add hierarchical subsection support for API reference sections ([49a3ef5](https://github.com/UI5/cli/commit/49a3ef569074ff84b5f6dfc2cfc619cd1654c2c8))
+* **builder:** Automatically add [@lends](https://github.com/lends) tag to extend calls during JSdoc build ([3547f42](https://github.com/UI5/cli/commit/3547f425b33663f7e5e2618a6d876fe018058d99))
+* **builder:** In JSDoc build, push the deprecation of namespaces down to the contained APIs ([71c08f2](https://github.com/UI5/cli/commit/71c08f2bb1d2cfee34ab9ca2e9e6042b5e67ae0c))
+* **builder:** Mark cross-references to typedefs in the api.json (SDK variant) ([a474700](https://github.com/UI5/cli/commit/a47470050e804192bfab857f6c224faa6e445e10))
+
+
+### Bug Fixes
+
+* **builder:** Improve JSDoc support for "module:" syntax ([aca05f0](https://github.com/UI5/cli/commit/aca05f0b75561f33842ccb30248ede3a82f2ae46))
+* **builder:** JSDoc: avoid errors when symbol has no events ([6e517e6](https://github.com/UI5/cli/commit/6e517e6c7f480784b93e37e94dcf74e0a689427f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @ui5/fs bumped from ^5.0.0-alpha.3 to ^5.0.0-alpha.4
+    * @ui5/logger bumped from ^5.0.0-alpha.3 to ^5.0.0-alpha.4
+  * devDependencies
+    * @ui5/project bumped from ^5.0.0-alpha.3 to ^5.0.0-alpha.4
+
+## [5.0.0-alpha.3](https://github.com/UI5/cli/compare/builder-v5.0.0-alpha.2...builder-v5.0.0-alpha.3) (2026-02-13)
+
+
+### Bug Fixes
+
+* Change Markdown syntax to [@example](https://github.com/example) in one place ([f7e2e73](https://github.com/UI5/cli/commit/f7e2e732570e3948d87c200ed5d64f65891a866d))
+* Fix gray code blocks in Markdown ([1cdd610](https://github.com/UI5/cli/commit/1cdd61060bd592b5c5f573635444d5ba37a8dc98))
+* Remove unnecessary space ([892ebca](https://github.com/UI5/cli/commit/892ebcadbd9ac4a3c0db84c7fb12c8c1e5daa1b6))
+
+
+### Dependencies
+
+* Bump escape-unicode from 0.2.0 to 0.3.0 ([#1160](https://github.com/UI5/cli/issues/1160)) ([90d07bd](https://github.com/UI5/cli/commit/90d07bdf9703e1072a8453a58302c00ac60ad83e))
+* Bump workerpool from 9.3.4 to 10.0.1 ([#1171](https://github.com/UI5/cli/issues/1171)) ([1f659b4](https://github.com/UI5/cli/commit/1f659b405038f91f6aa62d0cc29c32376e4e24d3))
+* The following workspace dependencies were updated
+  * dependencies
+    * @ui5/fs bumped from ^5.0.0-alpha.2 to ^5.0.0-alpha.3
+    * @ui5/logger bumped from ^5.0.0-alpha.2 to ^5.0.0-alpha.3
+  * devDependencies
+    * @ui5/project bumped from ^5.0.0-alpha.2 to ^5.0.0-alpha.3
+
 ## [5.0.0-alpha.2](https://github.com/UI5/cli/compare/builder-v5.0.0-alpha.1...builder-v5.0.0-alpha.2) (2025-12-15)
 
 

package/lib/lbt/bundle/Resolver.js

@@ -56,6 +56,7 @@ class BundleResolver {
 		 * in the resource pool.
 		 */
 		const missingModules = Object.create(null);
+		const ignoreMissingModules = pool.getIgnoreMissingModules();
 		/**
 		 * Names of modules that are included in non-decomposable bundles.
 		 * If they occur in the missingModules, then this is not an error.
@@ -123,7 +124,7 @@ class BundleResolver {
 					done = pool.findResourceWithInfo(resourceName)
 						.catch( (err) => {
 							// if the caller provided an error message, log it
-							if ( msg ) {
+							if ( msg && !ignoreMissingModules ) {
 								missingModules[resourceName] ??= [];
 								missingModules[resourceName].push(msg);
 							}

package/lib/lbt/resources/ModuleInfo.js

@@ -84,9 +84,10 @@ class ModuleInfo {
 		 * global scope. If a module declares global variables, all of them will be exported
 		 * with additional code of the form:
 		 *
-		 * <pre>
-		 *	 this["name"] = name;
-		 * </pre>
+		 * ```js
+		 * this["name"] = name;
+		 * ```
+		 *
 		 *
 		 * To avoid this, developers can either add "name" to the <code>ignoreGlobals</code>
 		 * attribute of a raw-module or they can completely suppress embedding of the module

package/lib/lbt/resources/ResourceFilterList.js

@@ -141,10 +141,11 @@ export default class ResourceFilterList {
 	 * and vice versa.
 	 *
 	 * Example:
-	 * <pre>
+	 * ```
 	 *	 !sap/ui/core/
 	*	 +sap/ui/core/utils/
-	* </pre>
+	 * ```
+	*
 	* excludes everything from sap/ui/core, but includes everything from the subpackage sap/ui/core/utils/.
 	*
 	* Note that the filter operates on the full name of each resource. If a resource name

package/lib/lbt/utils/JSTokenizer.js

@@ -29,10 +29,11 @@
 	 *
 	 * Contains functions to consume tokens on an input string.
 	 *
-	 * @example
+	 * ```js
 	 * sap.ui.require(["sap/base/util/JSTokenizer"], function(JSTokenizer){
 	 *      JSTokenizer().parseJS("{test:'123'}"); // {test:'123'}
 	 * });
+	 * ```
 	 *
 	 * @class sap/base/util/JSTokenizer
 	 * @since 1.58

package/lib/processors/bundlers/moduleBundler.js

@@ -57,7 +57,10 @@ const log = getLogger("builder:processors:bundlers:moduleBundler");
  *		denote an arbitrary number of characters or folder names.
  * 		Excludes should be marked with a leading exclamation mark '!'. The order of filters is relevant; a later
  *		exclusion overrides an earlier inclusion, and vice versa.
- * @example <caption>List of modules as glob patterns that should be in- or excluded</caption>
+ *
+ * <i>Example:</i>
+ *
+ * ```js
  * // Includes everything from "some/path/to/module/",
  * // but excludes the subfolder "some/path/to/module/to/be/excluded/"
  * const section = {
@@ -66,6 +69,7 @@ const log = getLogger("builder:processors:bundlers:moduleBundler");
  * 		"!some/path/to/module/to/be/excluded/"
  * 	]
  * };
+ * ```
  *
  * @property {boolean} [resolve=false] Whether (transitive) dependencies of modules that match the given filters
  *		should be resolved and added to the module set

package/lib/processors/jsdoc/lib/createIndexFiles.js

@@ -1,7 +1,7 @@
 /*
  * Node script to create cross-library API index files for use in the UI5 SDKs.
  *
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/lib/processors/jsdoc/lib/transformApiJson.js

@@ -1,7 +1,7 @@
 /**
  * Node script to preprocess api.json files for use in the UI5 SDKs.
  *
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -47,10 +47,10 @@ const typeParser = new TypeParser();
  * @param {string} sLibraryFile Path to the .library file of the library, used to extract further documentation information
  * @param {string|string[]} vDependencyAPIFiles Path of folder that contains api.json files of predecessor libs or
  *                 an array of paths of those files
- * @param {string} sFAQDir Path to the directory containing the sources for the FAQ section in APiRef
+ * @param {string} sSectionsDir Path to the directory containing the sources for the sections (FAQ, documentation, etc.) in the API Reference
  * @returns {Promise} A Promise that resolves after the transformation has been completed
  */
-function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles, sFAQDir, options) {
+function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles, sSectionsDir, options) {
 	const fs = options && options.fs || require("fs");
 	const returnOutputFiles = options && !!options.returnOutputFiles;
 
@@ -59,7 +59,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 	log.info("  output file: " + sOutputFile);
 	log.info("  library file: " + sLibraryFile);
 	log.info("  dependency dir: " + vDependencyAPIFiles);
-	log.info("  FAQ src dir: " + sFAQDir);
+	log.info("  sections src dir: " + sSectionsDir);
 	if (options && options.fs) {
 		log.info("Using custom fs.");
 	}
@@ -156,9 +156,10 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 	 *      UI5Types: ["sap.ui.core.Control"] // skip template if its value is "${0}" (default value)
 	 *    }
 	 * @param {string} sComplexType
+	 * @param {Object<string,object>} oAllDependentAPIs Map of entity names to their symbol
 	 * @returns {{template=: string, UI5Types=: string[]}}
 	 */
-	function parseUI5Types(sComplexType) {
+	function parseUI5Types(sComplexType, oAllDependentAPIs) {
 		let oParsed;
 		try {
 			oParsed = typeParser.parseSimpleTypes(sComplexType, isUI5Type);
@@ -176,6 +177,14 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 
 		if (oParsed.simpleTypes?.length) { // it can be empty if none of the included simple types satisfied the filter function
 			result.UI5Types = oParsed.simpleTypes;
+
+			// check whether the type refers to a typedef and set a marker
+			if (result.template == null && result.UI5Types.length === 1) {
+				const symbol = oAllDependentAPIs[result.UI5Types[0]];
+				if (symbol?.kind === "typedef" && Array.isArray(symbol.properties)) {
+					result.refersToTypedef = true;
+				}
+			}
 		}
 
 		return result;
@@ -266,6 +275,8 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 	 * @param {object} oChainObject chain object
 	 */
 	const transformApiJson = function (oChainObject) {
+		const {oAllDependentAPIs} = oChainObject;
+
 		// Function is a copy from: LibraryInfo.js => LibraryInfo.prototype._getActualComponent => "match" inline method
 		function matchComponent(sModuleName, sPattern) {
 			sModuleName = sModuleName.toLowerCase();
@@ -435,7 +446,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 						// Types
 						oParameter.types = [];
 						if (oParameter.type) {
-							oParameter.typeInfo = parseUI5Types(oParameter.type);
+							oParameter.typeInfo = parseUI5Types(oParameter.type, oAllDependentAPIs);
 							// Keep file size in check
 							delete oParameter.type;
 						}
@@ -520,7 +531,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 					// Type
 					if (oSymbol.kind !== "enum") { // enum properties don't have an own type
 						if (oProperty.type) {
-							oProperty.typeInfo = parseUI5Types(oProperty.type);
+							oProperty.typeInfo = parseUI5Types(oProperty.type, oAllDependentAPIs);
 							// Keep file size in check
 							delete oProperty.type;
 						}
@@ -560,7 +571,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 
 						// Type
 						if (oProperty.type) {
-							oProperty.typeInfo = parseUI5Types(oProperty.type);
+							oProperty.typeInfo = parseUI5Types(oProperty.type, oAllDependentAPIs);
 							// Keep file size in check
 							delete oProperty.type;
 						}
@@ -657,7 +668,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 							Object.keys(aParams).forEach((sParam) => {
 								const sSince = aParams[sParam].since;
 								const oDeprecated = aParams[sParam].deprecated;
-								const oEvtInSymbol = oSymbol.events.find((e) => e.name === oEvent.name);
+								const oEvtInSymbol = oSymbol.events?.find((e) => e.name === oEvent.name);
 								const oParamInSymbol = oEvtInSymbol && oEvtInSymbol.parameters[0] &&
 														oEvtInSymbol.parameters[0].parameterProperties &&
 														oEvtInSymbol.parameters[0].parameterProperties.getParameters &&
@@ -687,7 +698,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 
 						// Link Enabled
 						if (oSetting.type) {
-							oSetting.typeInfo = parseUI5Types(oSetting.type);
+							oSetting.typeInfo = parseUI5Types(oSetting.type, oAllDependentAPIs);
 							delete oSetting.type; // Keep file size in check
 						}
 
@@ -756,7 +767,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 						oEvent.parameters.forEach((oParameter) => {
 
 							if (oParameter.type) {
-								oParameter.typeInfo = parseUI5Types(oParameter.type);
+								oParameter.typeInfo = parseUI5Types(oParameter.type, oAllDependentAPIs);
 								delete oParameter.type; // Keep file size in check
 							}
 
@@ -789,7 +800,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 			if (oSymbol.methods) {
 
 				// Pre-process methods
-				methods.buildMethodsModel(oSymbol.methods);
+				methods.buildMethodsModel(oSymbol.methods, oAllDependentAPIs);
 
 				oSymbol.methods.forEach((oMethod) => {
 
@@ -950,6 +961,14 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 	}
 
 	function loadDependencyLibraryFiles (oChainObject) {
+		const oAllDependentAPIs = oChainObject.oAllDependentAPIs = Object.create(null);
+		// add symbols from current library
+		if (oChainObject.fileData.symbols) {
+			for (const oSymbol of oChainObject.fileData.symbols) {
+				oAllDependentAPIs[oSymbol.name] = oSymbol;
+			}
+		}
+
 		if (!oChainObject.aDependentLibraryFiles) {
 			return oChainObject;
 		}
@@ -978,6 +997,12 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 				// In this case we don't add it to the dependency list to skip double iteration.
 				if (oData && oChainObject.fileData.library !== oData.library) {
 					oDependentAPIs[oData.library] = oData.symbols;
+
+					if (Array.isArray(oData.symbols)) {
+						for (const oSymbol of oData.symbols) {
+							oAllDependentAPIs[oSymbol.name] = oSymbol;
+						}
+					}
 				}
 			});
 
@@ -987,22 +1012,69 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 	}
 
 	/**
-	 * Check for existence of FAQ data
-	 * (FAQ data must be defined as *.md files in the <code>sFAQDir</code>)
+	 * Check for existence of sections data
+	 * (Sections data must be defined as *.md files in the <code>sSectionsDir</code>)
 	 * and add a boolean flag in case it exists
 	 *
 	 * @param oChainObject chain object
 	 */
-	function addFlagsForFAQData(oChainObject) {
-		if (!sFAQDir) {
+	function addFlagsForSectionsData(oChainObject) {
+		if (!sSectionsDir) {
 			return oChainObject;
 		}
+
 		const slibName = oChainObject.fileData.library;
+
 		oChainObject.fileData.symbols.forEach(function(symbol) {
-			const sfile = symbol.name.replace(slibName, "").replace(/[.]/g, "/") + ".md";
-			if (fs.existsSync(path.join(sFAQDir, sfile))) {
-				symbol.hasFAQ = true;
+			const sComponentPath = symbol.name.replace(slibName, "").replace(/^[.]/, "").replace(/[.]/g, "/");
+			if (!sComponentPath) {
+				return;
 			}
+
+			const componentDir = path.join(sSectionsDir, sComponentPath);
+			if (fs.existsSync(componentDir)) {
+				try {
+				const dirContents = fs.readdirSync(componentDir, { withFileTypes: true });
+
+				// Separate files and directories in one pass
+				const mdFiles = [];
+				const dirNames = new Set();
+				dirContents.forEach((dirent) => {
+					if (dirent.isFile() && dirent.name.endsWith('.md')) {
+						mdFiles.push(dirent.name.replace(/\.md$/, ''));
+					} else if (dirent.isDirectory()) {
+						dirNames.add(dirent.name);
+					}
+				});
+
+				// Build customSections array with subsection support
+				const customSections = mdFiles.map(function(sectionName) {
+					// Check if there's a matching directory for this section
+					if (dirNames.has(sectionName)) {
+						try {
+							const subsectionFiles = fs.readdirSync(path.join(componentDir, sectionName), { withFileTypes: true })
+								.filter((dirent) => dirent.isFile() && dirent.name.endsWith('.md'))
+								.map((dirent) => dirent.name.replace(/\.md$/, ''));
+
+							if (subsectionFiles.length > 0) {
+								return { name: sectionName, hasSubsections: true, subsections: subsectionFiles };
+							}
+						} catch (error) {
+							log.error('Error scanning subsection directory:', path.join(componentDir, sectionName), error);
+						}
+					}
+					return sectionName;
+				});
+
+				if (customSections.length > 0) {
+					symbol.customSections = customSections;
+				}
+
+				} catch (error) {
+					log.error('Error scanning component sections directory:', componentDir, error);
+				}
+			}
+
 		});
 		return oChainObject;
 	}
@@ -2175,7 +2247,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 		 * Adjusts methods info so that it can be easily displayed in a table
 		 * @param aMethods - the methods array initially coming from the server
 		 */
-		buildMethodsModel: function (aMethods) {
+		buildMethodsModel: function (aMethods, oAllDependentAPIs) {
 			var fnExtractParameterProperties = function (oParameter, aParameters, iDepth, aPhoneName) {
 				if (oParameter.parameterProperties) {
 					Object.keys(oParameter.parameterProperties).forEach(function (sProperty) {
@@ -2185,7 +2257,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 
 						// Handle types
 						if (oProperty.type) {
-							oProperty.typeInfo = parseUI5Types(oProperty.type);
+							oProperty.typeInfo = parseUI5Types(oProperty.type, oAllDependentAPIs);
 							// Keep file size in check
 							delete oProperty.type;
 						}
@@ -2217,7 +2289,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 				if (oMethod.parameters) {
 					oMethod.parameters.forEach(function (oParameter) {
 						if (oParameter.type) {
-							oParameter.typeInfo = parseUI5Types(oParameter.type);
+							oParameter.typeInfo = parseUI5Types(oParameter.type, oAllDependentAPIs);
 							// Keep file size in check
 							delete oParameter.type;
 						}
@@ -2238,7 +2310,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 				// Handle return values
 				if (oMethod.returnValue && oMethod.returnValue.type) {
 					// Handle types
-					oMethod.returnValue.typeInfo = parseUI5Types(oMethod.returnValue.type);
+					oMethod.returnValue.typeInfo = parseUI5Types(oMethod.returnValue.type, oAllDependentAPIs);
 				}
 
 			});
@@ -2375,6 +2447,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 		inputFile: sInputFile,
 		outputFile: sOutputFile,
 		libraryFile: sLibraryFile,
+		sectionsDir: sSectionsDir,
 		aDependentLibraryFiles: Array.isArray(vDependencyAPIFiles) ? vDependencyAPIFiles : null
 	};
 
@@ -2387,7 +2460,7 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 		.then(getAPIJSONPromise)
 		.then(loadDependencyLibraryFiles)
 		.then(transformApiJson)
-		.then(addFlagsForFAQData)
+		.then(addFlagsForSectionsData)
 		.then(createApiRefApiJson);
 	return p;
 

package/lib/processors/jsdoc/lib/ui5/plugin.js

@@ -1,7 +1,7 @@
 /*
  * JSDoc3 plugin for UI5 documentation generation.
  *
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -73,7 +73,8 @@ const path = require('jsdoc/path');
 const logger = require('jsdoc/util/logger');
 const pluginConfig = (env.conf && env.conf.templates && env.conf.templates.ui5) || env.opts.sapui5 || {};
 const escope = require("escope");
-const {isSemVer} = require("./template/utils/versionUtil");
+const templatePath = path.getResourcePath(env.opts.template) || "./template";
+const {isSemVer} = require(`${templatePath}/utils/versionUtil`);
 
 /* ---- logging ---- */
 
@@ -1220,11 +1221,13 @@ function collectClassInfo(extendCall, classDoclet) {
 	if ( classDoclet && classDoclet.augments && classDoclet.augments.length === 1 ) {
 		baseType = classDoclet.augments[0];
 	}
+	const jsdocClassName = classDoclet?.kind === "class" ? classDoclet.alias || classDoclet.longname : undefined;
+
 	if ( isMemberExpression(extendCall.callee) ) {
 		const baseCandidate = getResolvedObjectName(extendCall.callee.object);
 		if ( baseCandidate && baseType == null ) {
 			baseType = baseCandidate;
-		} else if ( baseCandidate !== baseType ) {
+		} else if ( baseCandidate !== toRuntimeMetadataName(baseType) ) {
 			future(`documented base type '${baseType}' doesn't match technical base type '${baseCandidate}'`);
 		}
 	}
@@ -1283,6 +1286,32 @@ function collectClassInfo(extendCall, classDoclet) {
 	}
 
 	const classInfoNode = extendCall.arguments[1];
+	if (classInfoNode?.type === Syntax.ObjectExpression && jsdocClassName && addLeadingCommentNode) {
+		// Take care of the @lends comment only
+		// - when the class info is an object literal (otherwise lends makes no sense)
+		// - when a class name is found (it might differ from the runtime metadata name)
+		// - when the entity is documented as a class (or else '.prototype' would be wrong)
+		const classInfoComment = getLeadingCommentNode(classInfoNode);
+		if (classInfoComment == null) {
+			// If the class info object doesn't have a @lends tag, add it
+			const raw = `/** @lends ${jsdocClassName}.prototype */`;
+			info(`lends comment injected for class '${jsdocClassName}'`);
+			addLeadingCommentNode(classInfoNode, {
+				type: "CommentBlock",
+				raw,
+				value: raw.slice(2,-2),
+				loc: classInfoNode.loc
+			});
+		} else {
+			// Otherwise check whether the name matches the name of the described class
+			const doclet = new Doclet(getRawComment(classInfoComment), {});
+			// The name after the @lends is surprisingly stored in the 'alias' property
+			if (doclet.alias !== `${jsdocClassName}.prototype`) {
+				future(`lends comment '${doclet.alias}' doesn't match documented class name '${jsdocClassName}'`);
+			}
+		}
+	}
+
 	const classInfoMap = createPropertyMap(classInfoNode);
 	if ( classInfoMap && classInfoMap.metadata && classInfoMap.metadata.value.type !== Syntax.ObjectExpression ) {
 		warning(`class metadata exists but can't be analyzed. It is not of type 'ObjectExpression', but a '${classInfoMap.metadata.value.type}'.`);
@@ -1772,7 +1801,7 @@ function createAutoDoc(oClassInfo, classComment, doclet, node, parser, filename,
 	}
 
 	function name(prefix, n, _static) {
-		return oClassInfo.name + rname(prefix, n, _static);
+		return jsdocClassName + rname(prefix, n, _static);
 	}
 
 	/*
@@ -1884,6 +1913,18 @@ function createAutoDoc(oClassInfo, classComment, doclet, node, parser, filename,
 	const p = m ? m.index : -1;
 	const hasSettingsDocs = rawClassComment.indexOf("The supported settings are:") >= 0;
 	const classAccess = doclet?.access ?? "public";
+
+	// If doclet exists and has an alias or longname, use that when building the fully qualified
+	// names of methods or events.
+	// Do this only when the doclet is of kind "class". Many TypeScript classes unfortunately
+	// use a broken pattern with @namespace (needs to be deprecated in babel-plugin-transform-modules-ui5)
+	const jsdocClassName =
+		(doclet?.kind === "class" ? doclet.alias || doclet.longname : undefined) || oClassInfo.name;
+	if (jsdocClassName !== oClassInfo.name) {
+		info("jsdoc class name differs from runtime metadata name", jsdocClassName, oClassInfo.name);
+	}
+
+	const displayClassName = oClassInfo.name;
 	const visibility = createVisibilityTags(classAccess, doclet?.__ui5?.stakeholders);
 	const thisClass = 'this'; // oClassInfo.name
 
@@ -2007,7 +2048,7 @@ function createAutoDoc(oClassInfo, classComment, doclet, node, parser, filename,
 	}
 
 	newJSDoc([
-		"Returns a metadata object for class " + oClassInfo.name + ".",
+		"Returns a metadata object for class " + displayClassName + ".",
 		"",
 		"@returns {sap.ui.base.Metadata} Metadata object describing this class",
 		visibility,
@@ -2018,7 +2059,7 @@ function createAutoDoc(oClassInfo, classComment, doclet, node, parser, filename,
 
 	if ( !oClassInfo["final"] ) {
 		newJSDoc([
-			"Creates a new subclass of class " + oClassInfo.name + " with name <code>sClassName</code>",
+			"Creates a new subclass of class " + displayClassName + " with name <code>sClassName</code>",
 			"and enriches it with the information contained in <code>oClassInfo</code>.",
 			"",
 			"<code>oClassInfo</code> might contain the same kind of information as described in {@link " + (oClassInfo.baseType ? oClassInfo.baseType + ".extend" : "sap.ui.base.Object.extend Object.extend") + "}.",
@@ -2304,7 +2345,7 @@ function createAutoDoc(oClassInfo, classComment, doclet, node, parser, filename,
 			"",
 			info.enableEventBubbling ? "This event bubbles up the control hierarchy." : "",
 			"",
-			"@name " + oClassInfo.name + "#" + n,
+			"@name " + jsdocClassName + "#" + n,
 			"@event",
 			devStateTags,
 			"@param {sap.ui.base.Event} oControlEvent",
@@ -2321,10 +2362,10 @@ function createAutoDoc(oClassInfo, classComment, doclet, node, parser, filename,
 		newJSDoc(lines);
 
 		newJSDoc([
-			"Attaches event handler <code>fnFunction</code> to the " + link + " event of this <code>" + oClassInfo.name + "</code>.",
+			"Attaches event handler <code>fnFunction</code> to the " + link + " event of this <code>" + displayClassName + "</code>.",
 			"",
 			"When called, the context of the event handler (its <code>this</code>) will be bound to <code>oListener</code> if specified, ",
-			"otherwise it will be bound to this <code>" + oClassInfo.name + "</code> itself.",
+			"otherwise it will be bound to this <code>" + displayClassName + "</code> itself.",
 			"",
 			!newStyle && info.doc ? info.doc : "",
 			"",
@@ -2333,7 +2374,7 @@ function createAutoDoc(oClassInfo, classComment, doclet, node, parser, filename,
 			"@param {function(sap.ui.base.Event):void}",
 			"           fnFunction The function to be called when the event occurs",
 			"@param {object}",
-			"           [oListener] Context object to call the event handler with. Defaults to this <code>" + oClassInfo.name + "</code> itself",
+			"           [oListener] Context object to call the event handler with. Defaults to this <code>" + displayClassName + "</code> itself",
 			"",
 			"@returns {" + thisClass + "} Reference to <code>this</code> in order to allow method chaining",
 			devStateTags,
@@ -2342,7 +2383,7 @@ function createAutoDoc(oClassInfo, classComment, doclet, node, parser, filename,
 			"@function"
 		]);
 		newJSDoc([
-			"Detaches event handler <code>fnFunction</code> from the " + link + " event of this <code>" + oClassInfo.name + "</code>.",
+			"Detaches event handler <code>fnFunction</code> from the " + link + " event of this <code>" + displayClassName + "</code>.",
 			"",
 			"The passed function and listener object must match the ones used for event registration.",
 			"",
@@ -2439,6 +2480,7 @@ function toRuntimeMetadataName(longname) {
 
 let isDocComment;
 let getLeadingCommentNode;
+let addLeadingCommentNode;
 
 // JSDoc added the node type <code>Syntax.File</code> with the same change that activated Babylon
 // See https://github.com/jsdoc3/jsdoc/commit/ffec4a42291de6d68e6240f304b68d6abb82a869
@@ -2464,6 +2506,15 @@ if ( Syntax.File === 'File' ) {
 		return undefined;
 	};
 
+	addLeadingCommentNode = function(node, comment) {
+		node.leadingComments ??= [];
+		let index = node.leadingComments.length;
+		while (index > 0 && node.leadingComments[index - 1].type !== 'CommentBlock') {
+			index--;
+		}
+		node.leadingComments.splice(index, 0, comment);
+	}
+
 } else {
 
 	// JSDoc versions before 3.5.0
@@ -2498,6 +2549,9 @@ if ( Syntax.File === 'File' ) {
 
 		return comment;
 	};
+
+	// not implemented for espree (no automatic injection of @lends comments)
+	addLeadingCommentNode = undefined;
 }
 
 //--- comment related functions that are independent from the JSdoc version

package/lib/processors/jsdoc/lib/ui5/template/publish.js

@@ -1,7 +1,7 @@
 /*
  * JSDoc3 template for UI5 documentation generation.
  *
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -231,6 +231,7 @@ function publish(symbolSet) {
 
 	// now resolve relationships
 	const aRootNamespaces = createNamespaceTree(allSymbols);
+	pushDownDeprecations(allSymbols);
 	createInheritanceTree(allSymbols);
 	collectMembers(allSymbols);
 	mergeEventDocumentation(allSymbols);
@@ -374,6 +375,33 @@ function makeNamespace(memberof) {
 	]);
 }
 
+function pushDownDeprecations() {
+
+	function pushDown(oSymbol, sInheritedDeprecation) {
+		if (oSymbol == null || !isFirstClassSymbol(oSymbol)) {
+			return;
+		}
+		const sOwnDeprecation = oSymbol.deprecated;
+		if (sOwnDeprecation == null && sInheritedDeprecation != null) {
+			oSymbol.deprecated = sInheritedDeprecation;
+			info(`mark ${oSymbol.longname} as deprecated (${sInheritedDeprecation})`);
+		} else if (sOwnDeprecation != null) {
+			const info = extractSince(sOwnDeprecation);
+			const sinceBecause = info.since ? `As of version ${info.since}, because`: `Because`;
+			sInheritedDeprecation = `${sinceBecause} it is part of the deprecated package ${oSymbol.longname}`;
+		}
+		oSymbol.__ui5.children?.forEach((oChild) => pushDown(oChild, sInheritedDeprecation));
+	}
+
+	// w/o a library name we can't start with the library namespace
+	if (!templateConf.uilib) {
+		return;
+	}
+
+	// start the push down at the library namespace to ensure locality
+	pushDown(lookup(templateConf.uilib));
+}
+
 //---- inheritance hierarchy ----------------------------------------------------------------------------
 
 /*

package/lib/processors/jsdoc/lib/ui5/template/utils/typeParser.js

@@ -1,7 +1,7 @@
 /**
  * Node script to parse type strings.
  *
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/lib/processors/manifestCreator.js

@@ -491,11 +491,18 @@ async function createManifest(
 				}
 			}
 
-			return {
+			const libraryMetadata = {
 				i18n: i18n(),
 				css: css(),
 				content: content()
 			};
+
+			if (process.env.UI5_CLI_EXPERIMENTAL_BUNDLE_INFO_PRELOAD) {
+				// Add flag indicating that the (currently experimental) bundleVersion 2 preload bundling is used
+				libraryMetadata.bundleVersion = 2;
+			}
+
+			return libraryMetadata;
 		}
 
 		const sapUI5 = {

package/lib/processors/manifestEnhancer.js

@@ -441,6 +441,12 @@ class ManifestEnhancer {
 
 		if (this.manifest["sap.app"].type === "library") {
 			await this.processSapUi5LibraryI18n();
+
+			if (process.env.UI5_CLI_EXPERIMENTAL_BUNDLE_INFO_PRELOAD) {
+				// Add flag indicating that the (currently experimental) bundleVersion 2 preload bundling is used
+				this.manifest["sap.ui5"].library ??= {};
+				this.manifest["sap.ui5"].library.bundleVersion = 2;
+			}
 		} else {
 			await Promise.all([
 				this.processSapAppI18n(),

package/lib/processors/nonAsciiEscaper.js

@@ -1,4 +1,4 @@
-import escapeUnicode from "escape-unicode";
+import {escapeUnicode} from "escape-unicode";
 
 /**
  * @public
@@ -57,10 +57,10 @@ const escapeNonAscii = function(string) {
 /**
  * Escapes non ASCII characters with unicode escape sequences.
  *
- * @example
+ * ```js
  * const encoding = nonAsciiEscaper.getEncodingFromAlias("ISO-8859-1");
  * nonAsciiEscaper({resources, options: {encoding}});
- *
+ * ```
  *
  * @public
  * @function default

package/lib/processors/versionInfoGenerator.js

@@ -28,14 +28,14 @@ function getTimestamp() {
  * @typedef {Object<string, {lazy: boolean}>} ManifestLibraries
  *
  * sample:
- * <pre>
+ * ```json
  * {
  * 	"sap.chart": {
  * 		"lazy": true
  * 	},
  * 	"sap.f": { }
  * }
- * </pre>
+ * ```
  */
 
 /**
@@ -366,14 +366,16 @@ const processLibraryInfo = async (libraryInfo) => {
  * @param {string} parameters.options.rootProjectVersion Version of the root project
  * @param {module:@ui5/builder/processors/versionInfoGenerator~LibraryInfo[]} parameters.options.libraryInfos Array of
  *				objects representing libraries,
- *  e.g. <pre>
+ *  e.g.
+ *  ```json
  *   {
  *      name: "lib.x",
  *      version: "1.0.0",
  *      libraryManifest: @ui5/fs/Resource,
  *      embeddedManifests: @ui5/fs/Resource[]
  *   }
- * </pre>
+ *   ```
+ *
  * @returns {Promise<@ui5/fs/Resource[]>} Promise resolving with an array containing the versionInfo resource
  */
 

package/lib/tasks/bundlers/generateLibraryPreload.js

@@ -1,3 +1,4 @@
+import semver from "semver";
 import {getLogger} from "@ui5/logger";
 const log = getLogger("builder:tasks:bundlers:generateLibraryPreload");
 import moduleBundler from "../../processors/bundlers/moduleBundler.js";
@@ -32,6 +33,32 @@ function getDefaultLibraryPreloadFilters(namespace, excludes) {
 	return filters;
 }
 
+function getExperimentalDefaultLibraryPreloadFilters(namespace, excludes) {
+	const filters = [
+		`${namespace}/library.js`,
+		`!${namespace}/**/*-preload.js`, // exclude all bundles
+		`!${namespace}/designtime/`,
+		`!${namespace}/**/*.designtime.js`,
+		`!${namespace}/**/*.support.js`
+	];
+
+	if (Array.isArray(excludes)) {
+		const allFilterExcludes = negateFilters(excludes);
+		// Add configured excludes at the end of filter list
+		allFilterExcludes.forEach((filterExclude) => {
+			// Allow all excludes (!) and limit re-includes (+) to the library namespace
+			if (filterExclude.startsWith("!") || filterExclude.startsWith(`+${namespace}/`)) {
+				filters.push(filterExclude);
+			} else {
+				log.warn(`Configured preload exclude contains invalid re-include: !${filterExclude.substr(1)}. ` +
+				`Re-includes must start with the library's namespace ${namespace}`);
+			}
+		});
+	}
+
+	return filters;
+}
+
 function getBundleDefinition(namespace, excludes) {
 	// Note: This configuration is only used when no bundle definition in ui5.yaml exists (see "skipBundles" parameter)
 
@@ -106,6 +133,69 @@ function getBundleDefinition(namespace, excludes) {
 	};
 }
 
+function getBundleInfoPreloadDefinition(namespace, excludes, coreVersion) {
+	const sections = [{
+		mode: "preload",
+		filters: getExperimentalDefaultLibraryPreloadFilters(namespace, excludes),
+		resolve: true
+	},
+	{
+		mode: "bundleInfo",
+		name: `${namespace}/_library-content.js`,
+		filters: getDefaultLibraryPreloadFilters(namespace, excludes),
+		resolve: false,
+		resolveConditional: false,
+		renderer: true
+	}];
+
+	if (coreVersion) {
+		const parsedVersion = semver.parse(coreVersion);
+		let targetUi5CoreVersionMajor = parsedVersion.major;
+
+		// legacy-free versions include changes of the upcoming major version
+		// so we should treat them the same as the next major version
+		if (
+			parsedVersion.prerelease.includes("legacy-free") ||
+			parsedVersion.prerelease.includes("legacy-free-SNAPSHOT") // Maven snapshot version
+		) {
+			targetUi5CoreVersionMajor += 1;
+		}
+		if (parsedVersion) {
+			if (targetUi5CoreVersionMajor >= 2) {
+				// Do not include manifest.json in UI5 2.x and higher to allow for loading it upfront for all libraries
+				sections.unshift({
+					mode: "provided",
+					filters: [
+						`${namespace}/manifest.json`,
+					]
+				});
+			}
+		}
+	}
+
+	return {
+		name: `${namespace}/library-preload.js`,
+		sections,
+	};
+}
+
+function getContentBundleDefinition(namespace, excludes) {
+	return {
+		name: `${namespace}/_library-content.js`,
+		sections: [{
+			mode: "provided",
+			filters: getExperimentalDefaultLibraryPreloadFilters(namespace, excludes),
+			resolve: true
+		}, {
+			mode: "preload",
+			filters: getDefaultLibraryPreloadFilters(namespace, excludes),
+			resolve: false,
+			resolveConditional: false,
+			renderer: true
+		}]
+	};
+}
+
 function getDesigntimeBundleDefinition(namespace) {
 	return {
 		name: `${namespace}/designtime/library-preload.designtime.js`,
@@ -258,6 +348,7 @@ export default async function({workspace, taskUtil, options: {skipBundles = [],
 	}
 	const coreVersion = taskUtil?.getProject("sap.ui.core")?.getVersion();
 	const allowStringBundling = taskUtil?.getProject().getSpecVersion().lt("4.0");
+	const createBundleInfoPreload = !!process.env.UI5_CLI_EXPERIMENTAL_BUNDLE_INFO_PRELOAD;
 	const execModuleBundlerIfNeeded = ({options, resources}) => {
 		if (skipBundles.includes(options.bundleDefinition.name)) {
 			log.verbose(`Skipping generation of bundle ${options.bundleDefinition.name}`);
@@ -271,7 +362,9 @@ export default async function({workspace, taskUtil, options: {skipBundles = [],
 		return moduleBundler({options, resources});
 	};
 
-	return nonDbgWorkspace.byGlob("/**/*.{js,json,xml,html,properties,library,js.map}").then(async (resources) => {
+	return nonDbgWorkspace.byGlob(
+		"/resources/**/*.{js,json,xml,html,properties,library,js.map}"
+	).then(async (resources) => {
 		// Find all libraries and create a library-preload.js bundle
 
 		let p = Promise.resolve();
@@ -299,8 +392,8 @@ export default async function({workspace, taskUtil, options: {skipBundles = [],
 							return !taskUtil.getTag(resource, taskUtil.STANDARD_TAGS.HasDebugVariant);
 						}
 					});
-					unoptimizedResources =
-						await unoptimizedWorkspace.byGlob("/**/*.{js,json,xml,html,properties,library,js.map}");
+					unoptimizedResources = await unoptimizedWorkspace.byGlob(
+						"/resources/**/*.{js,json,xml,html,properties,library,js.map}");
 
 					unoptimizedModuleNameMapping = createModuleNameMapping({
 						resources: unoptimizedResources,
@@ -390,42 +483,117 @@ export default async function({workspace, taskUtil, options: {skipBundles = [],
 					const libraryNamespaceMatch = libraryIndicatorPath.match(libraryNamespacePattern);
 					if (libraryNamespaceMatch && libraryNamespaceMatch[1]) {
 						const libraryNamespace = libraryNamespaceMatch[1];
-						const results = await Promise.all([
-							execModuleBundlerIfNeeded({
-								options: {
-									bundleDefinition: getBundleDefinition(libraryNamespace, excludes),
-									bundleOptions: {
-										optimize: true,
-										ignoreMissingModules: true
-									}
-								},
-								resources
-							}),
-							execModuleBundlerIfNeeded({
-								options: {
-									bundleDefinition: getDesigntimeBundleDefinition(libraryNamespace),
-									bundleOptions: {
-										optimize: true,
-										ignoreMissingModules: true,
-										skipIfEmpty: true
-									}
-								},
-								resources
-							}),
-							execModuleBundlerIfNeeded({
-								options: {
-									bundleDefinition: getSupportFilesBundleDefinition(libraryNamespace),
-									bundleOptions: {
-										optimize: false,
-										ignoreMissingModules: true,
-										skipIfEmpty: true
-									}
-									// Note: Although the bundle uses optimize=false, there is
-									// no moduleNameMapping needed, as support files are excluded from minification.
-								},
-								resources
-							})
-						]);
+						let results;
+						if (!createBundleInfoPreload) {
+							// Regular bundling
+							results = await Promise.all([
+								execModuleBundlerIfNeeded({
+									options: {
+										bundleDefinition: getBundleDefinition(libraryNamespace, excludes),
+										bundleOptions: {
+											optimize: true,
+											ignoreMissingModules: true
+										}
+									},
+									resources
+								}),
+								execModuleBundlerIfNeeded({
+									options: {
+										bundleDefinition: getDesigntimeBundleDefinition(libraryNamespace),
+										bundleOptions: {
+											optimize: true,
+											ignoreMissingModules: true,
+											skipIfEmpty: true
+										}
+									},
+									resources
+								}),
+								execModuleBundlerIfNeeded({
+									options: {
+										bundleDefinition: getSupportFilesBundleDefinition(libraryNamespace),
+										bundleOptions: {
+											optimize: false,
+											ignoreMissingModules: true,
+											skipIfEmpty: true
+										}
+										// Note: Although the bundle uses optimize=false, there is
+										// no moduleNameMapping needed, as support files are excluded from minification.
+									},
+									resources
+								})
+							]);
+						} else {
+							log.info(
+								`Using experimental bundling with bundle info preload ` +
+								`for library ${libraryNamespace} in project ${projectName}`);
+							log.info(`Detected sap.ui.core version is ${coreVersion || "unknown"}`);
+
+
+							if (skipBundles.includes(`${libraryNamespace}/library-preload.js`) &&
+								!skipBundles.includes(`${libraryNamespace}/_library-content.js`)) {
+								// If the standard preload bundle is skipped, ensure to also skip the content bundle,
+								// since they depend on each other
+								skipBundles.push(`${libraryNamespace}/_library-content.js`);
+							}
+
+							if (skipBundles.includes(`${libraryNamespace}/_library-content.js`) &&
+								!skipBundles.includes(`${libraryNamespace}/library-preload.js`)) {
+								// If the content bundle is skipped, the default preload bundle must be skipped as well
+								throw new Error(
+									`A custom bundle '${libraryNamespace}/_library-content.js' has been defined, ` +
+									`but it also requires a corresponding custom bundle definition for ` +
+									`'${libraryNamespace}/library-preload.js'`);
+							}
+
+							// Experimental bundling with bundle info preload
+							results = await Promise.all([
+								execModuleBundlerIfNeeded({
+									options: {
+										bundleDefinition:
+											getBundleInfoPreloadDefinition(libraryNamespace, excludes, coreVersion),
+										bundleOptions: {
+											optimize: true,
+											ignoreMissingModules: true
+										}
+									},
+									resources
+								}),
+								execModuleBundlerIfNeeded({
+									options: {
+										bundleDefinition: getContentBundleDefinition(libraryNamespace, excludes),
+										bundleOptions: {
+											optimize: true,
+											ignoreMissingModules: true
+										}
+									},
+									resources
+								}),
+								execModuleBundlerIfNeeded({
+									options: {
+										bundleDefinition: getDesigntimeBundleDefinition(libraryNamespace),
+										bundleOptions: {
+											optimize: true,
+											ignoreMissingModules: true,
+											skipIfEmpty: true
+										}
+									},
+									resources
+								}),
+								execModuleBundlerIfNeeded({
+									options: {
+										bundleDefinition: getSupportFilesBundleDefinition(libraryNamespace),
+										bundleOptions: {
+											optimize: false,
+											ignoreMissingModules: true,
+											skipIfEmpty: true
+										}
+										// Note: Although the bundle uses optimize=false, there is
+										// no moduleNameMapping needed, as support files are excluded from minification.
+									},
+									resources
+								})
+							]);
+						}
 						const bundles = Array.prototype.concat.apply([], results).filter(Boolean);
 						return Promise.all(bundles.map(({bundle, sourceMap} = {}) => {
 							if (bundle) {

package/lib/tasks/generateResourcesJson.js

@@ -55,7 +55,9 @@ function getCreatorOptions(projectName) {
  * Therefore it is also not supported in combination with self-contained build.
  * </p>
  *
- * @example <caption>sample resources.json</caption>
+ * <i>sample resources.json</i>
+ *
+ * ```js
  * const resourcesJson = {
  * 	"_version": "1.1.0",
  * 	"resources": [
@@ -95,6 +97,7 @@ function getCreatorOptions(projectName) {
  * 		}
  * 	]
  * };
+ * ```
  *
  * @public
  * @function default

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ui5/builder",
-	"version": "5.0.0-alpha.2",
+	"version": "5.0.0-alpha.4",
 	"description": "UI5 CLI - Builder",
 	"author": {
 		"name": "SAP SE",
@@ -33,39 +33,19 @@
 		"npm": ">= 8"
 	},
 	"scripts": {
-		"test": "npm run lint && npm run coverage && npm run depcheck",
+		"test": "npm run lint && npm run coverage",
 		"lint": "eslint ./",
 		"unit": "rimraf test/tmp && ava",
 		"unit-verbose": "rimraf test/tmp && cross-env UI5_LOG_LVL=verbose ava --verbose --serial",
 		"unit-watch": "rimraf test/tmp && ava --watch",
 		"unit-inspect": "cross-env UI5_LOG_LVL=verbose ava debug --break",
-		"coverage": "rimraf test/tmp && nyc ava --node-arguments=\"--experimental-loader=@istanbuljs/esm-loader-hook\"",
-		"preversion": "npm test",
-		"version": "git-chglog --sort semver --next-tag v$npm_package_version -o CHANGELOG.md v4.0.0.. && git add CHANGELOG.md",
-		"prepublishOnly": "git push --follow-tags",
-		"release-note": "git-chglog --sort semver -c .chglog/release-config.yml v$npm_package_version",
-		"depcheck": "depcheck --ignores @ui5/builder,@istanbuljs/esm-loader-hook,catharsis,rimraf,jsdoc --parsers='**/*.js:es6,**/*.cjs:es6'"
+		"coverage": "rimraf test/tmp && nyc ava --node-arguments=\"--experimental-loader=@istanbuljs/esm-loader-hook\""
 	},
 	"files": [
 		"CHANGELOG.md",
 		"lib/**",
 		"LICENSES/**"
 	],
-	"ava": {
-		"files": [
-			"test/lib/**/*.js"
-		],
-		"watchMode": {
-			"ignoreChanges": [
-				"test/tmp/**"
-			]
-		},
-		"nodeArguments": [
-			"--loader=esmock",
-			"--no-warnings"
-		],
-		"workerThreads": false
-	},
 	"nyc": {
 		"reporter": [
 			"lcov",
@@ -111,10 +91,10 @@
 	},
 	"dependencies": {
 		"@jridgewell/sourcemap-codec": "^1.5.5",
-		"@ui5/fs": "^5.0.0-alpha.2",
-		"@ui5/logger": "^5.0.0-alpha.2",
+		"@ui5/fs": "^5.0.0-alpha.4",
+		"@ui5/logger": "^5.0.0-alpha.4",
 		"cheerio": "1.0.0",
-		"escape-unicode": "^0.2.0",
+		"escape-unicode": "^0.3.0",
 		"escope": "^4.0.0",
 		"espree": "^10.4.0",
 		"graceful-fs": "^4.2.11",
@@ -123,16 +103,15 @@
 		"pretty-data": "^0.40.0",
 		"semver": "^7.7.2",
 		"terser": "^5.44.0",
-		"workerpool": "^9.3.4",
+		"workerpool": "^10.0.1",
 		"xml2js": "^0.6.2"
 	},
 	"devDependencies": {
 		"@istanbuljs/esm-loader-hook": "^0.3.0",
 		"@jridgewell/trace-mapping": "^0.3.31",
-		"@ui5/project": "^5.0.0-alpha.2",
+		"@ui5/project": "^5.0.0-alpha.4",
 		"ava": "^6.4.1",
-		"cross-env": "^7.0.3",
-		"depcheck": "^1.4.7",
+		"cross-env": "^10.1.0",
 		"eslint": "^9.36.0",
 		"esmock": "^2.7.3",
 		"line-column": "^1.0.2",