@ui5/builder 3.0.0-alpha.8 → 3.0.0-alpha.9

package/CHANGELOG.md

@@ -2,10 +2,16 @@
 All notable changes to this project will be documented in this file.  
 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/v3.0.0-alpha.8...HEAD).
+A list of unreleased changes can be found [here](https://github.com/SAP/ui5-builder/compare/v3.0.0-alpha.9...HEAD).
+
+<a name="v3.0.0-alpha.9"></a>
+## [v3.0.0-alpha.9] - 2022-07-27
+### Bug Fixes
+- **minify:** Change default to not omit source map resources [`6d75a49`](https://github.com/SAP/ui5-builder/commit/6d75a495224590097332fc061c66cfe0e8f4c151)
+
 
 <a name="v3.0.0-alpha.8"></a>
-## [v3.0.0-alpha.8] - 2022-07-14
+## [v3.0.0-alpha.8] - 2022-07-15
 
 <a name="v3.0.0-alpha.7"></a>
 ## [v3.0.0-alpha.7] - 2022-06-14
@@ -744,6 +750,7 @@ to load the custom bundle file instead.
 - Add ability to configure component preloads and custom bundles [`2241e5f`](https://github.com/SAP/ui5-builder/commit/2241e5ff98fd95f1f80cc74959655ae7a9c660e7)
 
 
+[v3.0.0-alpha.9]: https://github.com/SAP/ui5-builder/compare/v3.0.0-alpha.8...v3.0.0-alpha.9
 [v3.0.0-alpha.8]: https://github.com/SAP/ui5-builder/compare/v3.0.0-alpha.7...v3.0.0-alpha.8
 [v3.0.0-alpha.7]: https://github.com/SAP/ui5-builder/compare/v3.0.0-alpha.6...v3.0.0-alpha.7
 [v3.0.0-alpha.6]: https://github.com/SAP/ui5-builder/compare/v3.0.0-alpha.5...v3.0.0-alpha.6

package/index.js

@@ -152,10 +152,6 @@ module.exports = {
 		 * @type {import('./lib/tasks/taskRepository')}
 		 */
 		taskRepository: "./lib/tasks/taskRepository",
-		/**
-		 * @type {import('./lib/tasks/TaskUtil')}
-		 */
-		TaskUtil: "./lib/tasks/TaskUtil"
 	}
 };
 

package/lib/tasks/bundlers/generateBundle.js

@@ -10,7 +10,7 @@ const ReaderCollectionPrioritized = require("@ui5/fs").ReaderCollectionPrioritiz
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
  * @param {module:@ui5/fs.ReaderCollection} parameters.dependencies Collection to read dependency files
- * @param {module:@ui5/builder.tasks.TaskUtil|object} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} [parameters.taskUtil] TaskUtil
  * @param {object} parameters.options Options
  * @param {string} parameters.options.projectName Project name
  * @param {ModuleBundleDefinition} parameters.options.bundleDefinition Module bundle definition

package/lib/tasks/bundlers/generateComponentPreload.js

@@ -10,7 +10,7 @@ const {negateFilters} = require("../../lbt/resources/ResourceFilterList");
  * @alias module:@ui5/builder.tasks.generateComponentPreload
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
- * @param {module:@ui5/builder.tasks.TaskUtil|object} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} [parameters.taskUtil] TaskUtil
  * @param {object} parameters.options Options
  * @param {string} parameters.options.projectName Project name
  * @param {string[]} [parameters.options.excludes=[]] List of modules declared as glob patterns (resource name patterns)

package/lib/tasks/bundlers/generateFlexChangesBundle.js

@@ -15,7 +15,7 @@ const semver = require("semver");
  * @alias module:@ui5/builder.tasks.generateFlexChangesBundle
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
- * @param {module:@ui5/builder.tasks.TaskUtil|object} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} [parameters.taskUtil] TaskUtil
  * @param {object} [parameters.options] Options
  * @param {string} [parameters.options.projectNamespace] Project Namespace
  * @returns {Promise<undefined>} Promise resolving with <code>undefined</code> once data has been written

package/lib/tasks/bundlers/generateLibraryPreload.js

@@ -223,7 +223,7 @@ function getSapUiCoreBunDef(name, filters, preload) {
  * @alias module:@ui5/builder.tasks.generateLibraryPreload
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
- * @param {module:@ui5/builder.tasks.TaskUtil} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil} [parameters.taskUtil] TaskUtil
  * @param {object} parameters.options Options
  * @param {string} parameters.options.projectName Project name
  * @param {string[]} [parameters.options.skipBundles] Names of bundles that should not be created

package/lib/tasks/bundlers/generateStandaloneAppBundle.js

@@ -67,7 +67,7 @@ function getBundleDefinition(config) {
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
  * @param {module:@ui5/fs.AbstractReader} parameters.dependencies Reader or Collection to read dependency files
- * @param {module:@ui5/builder.tasks.TaskUtil|object} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} [parameters.taskUtil] TaskUtil
  * @param {object} parameters.options Options
  * @param {string} parameters.options.projectName Project name
  * @param {string} [parameters.options.projectNamespace] Project namespace

package/lib/tasks/bundlers/utils/createModuleNameMapping.js

@@ -11,7 +11,7 @@ const ModuleName = require("../../../lbt/utils/ModuleName");
  * @private
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.Resource[]} parameters.resources List of resources
- * @param {module:@ui5/builder.tasks.TaskUtil|object} parameters.taskUtil TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} parameters.taskUtil TaskUtil
  * @returns {object} Module name mapping
  */
 module.exports = function({resources, taskUtil}) {

package/lib/tasks/generateLibraryManifest.js

@@ -11,7 +11,7 @@ const manifestCreator = require("../processors/manifestCreator");
  * @alias module:@ui5/builder.tasks.generateLibraryManifest
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
- * @param {module:@ui5/builder.tasks.TaskUtil|object} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} [parameters.taskUtil] TaskUtil
  * @param {object} parameters.options Options
  * @param {string} parameters.options.projectName Project name
  * @returns {Promise<undefined>} Promise resolving with <code>undefined</code> once data has been written

package/lib/tasks/generateResourcesJson.js

@@ -97,7 +97,7 @@ function getCreatorOptions(projectName) {
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
  * @param {module:@ui5/fs.AbstractReader} parameters.dependencies Reader or Collection to read dependency files
- * @param {module:@ui5/builder.tasks.TaskUtil|object} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} [parameters.taskUtil] TaskUtil
  * @param {object} parameters.options Options
  * @param {string} parameters.options.projectName Project name
  * @returns {Promise<undefined>} Promise resolving with <code>undefined</code> once data has been written

package/lib/tasks/jsdoc/generateJsdoc.js

@@ -28,7 +28,7 @@ const {resourceFactory} = require("@ui5/fs");
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
  * @param {module:@ui5/fs.AbstractReader} parameters.dependencies Reader or Collection to read dependency files
  * @param {GenerateJsdocOptions} parameters.options Options
- * @param {module:@ui5/builder.tasks.TaskUtil|object} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} [parameters.taskUtil] TaskUtil
  * @param {object} [parameters.buildContext] Internal, deprecated parameter
  * @returns {Promise<undefined>} Promise resolving with <code>undefined</code> once data has been written
  */

package/lib/tasks/minify.js

@@ -7,14 +7,14 @@ const minifier = require("../processors/minifier");
  * @alias module:@ui5/builder.tasks.minify
  * @param {object} parameters Parameters
  * @param {module:@ui5/fs.DuplexCollection} parameters.workspace DuplexCollection to read and write files
- * @param {module:@ui5/builder.tasks.TaskUtil|object} [parameters.taskUtil] TaskUtil
+ * @param {module:@ui5/project.build.helpers.TaskUtil|object} [parameters.taskUtil] TaskUtil
  * @param {object} parameters.options Options
  * @param {string} parameters.options.pattern Pattern to locate the files to be processed
- * @param {boolean} [parameters.options.omitSourceMapResources=true] Whether source map resources shall
+ * @param {boolean} [parameters.options.omitSourceMapResources=false] Whether source map resources shall
  * 		be tagged as "OmitFromBuildResult" and no sourceMappingURL shall be added to the minified resource
  * @returns {Promise<undefined>} Promise resolving with <code>undefined</code> once data has been written
  */
-module.exports = async function({workspace, taskUtil, options: {pattern, omitSourceMapResources = true}}) {
+module.exports = async function({workspace, taskUtil, options: {pattern, omitSourceMapResources = false}}) {
 	const resources = await workspace.byGlob(pattern);
 	const processedResources = await minifier({
 		resources,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ui5/builder",
-	"version": "3.0.0-alpha.8",
+	"version": "3.0.0-alpha.9",
 	"description": "UI5 Tooling - Builder",
 	"author": {
 		"name": "SAP SE",
@@ -125,7 +125,7 @@
 		"yazl": "^2.5.1"
 	},
 	"devDependencies": {
-		"@ui5/project": "github:SAP/ui5-project#178dedbfe80ab890d134ce12ccb29fc709595a52",
+		"@ui5/project": "^3.0.0-alpha.6",
 		"ava": "^3.15.0",
 		"chai": "^4.3.4",
 		"chai-fs": "^2.0.0",

package/lib/tasks/TaskUtil.js

@@ -1,237 +0,0 @@
-/**
- * Convenience functions for UI5 Builder tasks.
- * An instance of this class is passed to every standard UI5 Builder task that requires it.
- *
- * Custom tasks that define a specification version >= 2.2 will receive an interface
- * to an instance of this class when called.
- * The set of available functions on that interface depends on the specification
- * version defined for the extension.
- *
- * @public
- * @memberof module:@ui5/builder.tasks
- */
-class TaskUtil {
-	/**
-	 * Standard Build Tags. See UI5 Tooling
-	 * [RFC 0008]{@link https://github.com/SAP/ui5-tooling/blob/master/rfcs/0008-resource-tagging-during-build.md}
-	 * for details.
-	 *
-	 * @public
-	 * @typedef {object} module:@ui5/builder.tasks.TaskUtil~StandardBuildTags
-	 * @property {string} OmitFromBuildResult
-	 * 		Setting this tag to true will prevent the resource from being written to the build target directory
-	 * @property {string} IsBundle
-	 * 		This tag identifies resources that contain (i.e. bundle) multiple other resources
-	 * @property {string} IsDebugVariant
-	 * 		This tag identifies resources that are a debug variant (typically named with a "-dbg" suffix)
-	 * 		of another resource. This tag is part of the build manifest.
-	 * @property {string} HasDebugVariant
-	 * 		This tag identifies resources for which a debug variant has been created.
-	 * 		This tag is part of the build manifest.
-	 */
-
-	/**
-	 * Since <code>@ui5/builder.builder.ProjectBuildContext</code> is a private class, TaskUtil must not be
-	 * instantiated by modules other than @ui5/builder itself.
-	 *
-	 * @param {object} parameters
-	 * @param {module:@ui5/builder.builder.ProjectBuildContext} parameters.projectBuildContext ProjectBuildContext
-	 * @public
-	 */
-	constructor({projectBuildContext}) {
-		this._projectBuildContext = projectBuildContext;
-		/**
-		 * @member {module:@ui5/builder.tasks.TaskUtil~StandardBuildTags}
-		 * @public
-		*/
-		this.STANDARD_TAGS = Object.freeze({
-			// "Project" tags:
-			// Will be stored on project instance and are hence part of the build manifest
-			IsDebugVariant: "ui5:IsDebugVariant",
-			HasDebugVariant: "ui5:HasDebugVariant",
-
-			// "Build" tags:
-			// Will be stored on the project build context
-			// They are only available to the build tasks of a single project
-			OmitFromBuildResult: "ui5:OmitFromBuildResult",
-			IsBundle: "ui5:IsBundle"
-		});
-	}
-
-	/**
-	 * Stores a tag with value for a given resource's path. Note that the tag is independent of the supplied
-	 * resource instance. For two resource instances with the same path, the same tag value is returned.
-	 * If the path of a resource is changed, any tag information previously stored for that resource is lost.
-	 *
-	 * </br></br>
-	 * This method is only available to custom task extensions defining
-	 * <b>Specification Version 2.2 and above</b>.
-	 *
-	 * @param {module:@ui5/fs.Resource} resource Resource-instance the tag should be stored for
-	 * @param {string} tag Name of the tag.
-	 * 		Currently only the [STANDARD_TAGS]{@link module:@ui5/builder.tasks.TaskUtil#STANDARD_TAGS} are allowed
-	 * @param {string|boolean|integer} [value=true] Tag value. Must be primitive
-	 * @public
-	 */
-	setTag(resource, tag, value) {
-		if (typeof resource === "string") {
-			throw new Error("Deprecated parameter: " +
-				"Since UI5 Tooling 3.0, #setTag requires a resource instance. Strings are no longer accepted");
-		}
-
-		const collection = this._projectBuildContext.getResourceTagCollection(resource, tag);
-		return collection.setTag(resource, tag, value);
-	}
-
-	/**
-	 * Retrieves the value for a stored tag. If no value is stored, <code>undefined</code> is returned.
-	 *
-	 * </br></br>
-	 * This method is only available to custom task extensions defining
-	 * <b>Specification Version 2.2 and above</b>.
-	 *
-	 * @param {module:@ui5/fs.Resource} resource Resource-instance the tag should be retrieved for
-	 * @param {string} tag Name of the tag
-	 * @returns {string|boolean|integer|undefined} Tag value for the given resource.
-	 * 										<code>undefined</code> if no value is available
-	 * @public
-	 */
-	getTag(resource, tag) {
-		if (typeof resource === "string") {
-			throw new Error("Deprecated parameter: " +
-				"Since UI5 Tooling 3.0, #getTag requires a resource instance. Strings are no longer accepted");
-		}
-		const collection = this._projectBuildContext.getResourceTagCollection(resource, tag);
-		return collection.getTag(resource, tag);
-	}
-
-	/**
-	 * Clears the value of a tag stored for the given resource's path.
-	 * It's like the tag was never set for that resource.
-	 *
-	 * </br></br>
-	 * This method is only available to custom task extensions defining
-	 * <b>Specification Version 2.2 and above</b>.
-	 *
-	 * @param {module:@ui5/fs.Resource} resource Resource-instance the tag should be cleared for
-	 * @param {string} tag Tag
-	 * @public
-	 */
-	clearTag(resource, tag) {
-		if (typeof resource === "string") {
-			throw new Error("Deprecated parameter: " +
-				"Since UI5 Tooling 3.0, #clearTag requires a resource instance. Strings are no longer accepted");
-		}
-		const collection = this._projectBuildContext.getResourceTagCollection(resource, tag);
-		return collection.clearTag(resource, tag);
-	}
-
-	/**
-	 * Check whether the project currently being built is the root project.
-	 *
-	 * </br></br>
-	 * This method is only available to custom task extensions defining
-	 * <b>Specification Version 2.2 and above</b>.
-	 *
-	 * @returns {boolean} <code>true</code> if the currently built project is the root project
-	 * @public
-	 */
-	isRootProject() {
-		return this._projectBuildContext.isRootProject();
-	}
-
-	/**
-	 * Retrieves a build option defined by its <code>key</code.
-	 * If no option with the given <code>key</code> is stored, <code>undefined</code> is returned.
-	 *
-	 * @param {string} key The option key
-	 * @returns {any|undefined} The build option (or undefined)
-	 * @private
-	 */
-	getBuildOption(key) {
-		return this._projectBuildContext.getOption(key);
-	}
-
-	/**
-	 * Register a function that must be executed once the build is finished. This can be used to, for example,
-	 * clean up files temporarily created on the file system. If the callback returns a Promise, it will be waited for.
-	 * It will also be executed in cases where the build has failed or has been aborted.
-	 *
-	 * </br></br>
-	 * This method is only available to custom task extensions defining
-	 * <b>Specification Version 2.2 and above</b>.
-	 *
-	 * @param {Function} callback Callback to register. If it returns a Promise, it will be waited for
-	 * @public
-	 */
-	registerCleanupTask(callback) {
-		return this._projectBuildContext.registerCleanupTask(callback);
-	}
-
-	/**
-	 * Retrieve a single project from the dependency graph
-	 *
-	 * </br></br>
-	 * This method is only available to custom task extensions defining
-	 * <b>Specification Version 3.0 and above</b>.
-	 *
-	 * @param {string} projectName Name of the project to retrieve
-	 * @returns {module:@ui5/project.specifications.Project|undefined}
-	 *					project instance or undefined if the project is unknown to the graph
-	 * @public
-	 */
-	getProject(projectName) {
-		return this._projectBuildContext.getProject(projectName);
-	}
-
-	/**
-	 * Get an interface to an instance of this class that only provides those functions
-	 * that are supported by the given custom task extension specification version.
-	 *
-	 * @param {string} specVersion Specification version of custom task extension
-	 * @returns {object} An object with bound instance methods supported by the given specification version
-	 */
-	getInterface(specVersion) {
-		if (["0.1", "1.0", "1.1", "2.0", "2.1"].includes(specVersion)) {
-			return undefined;
-		}
-
-		const baseInterface = {
-			STANDARD_TAGS: this.STANDARD_TAGS,
-		};
-		bindFunctions(this, baseInterface, [
-			"setTag", "clearTag", "getTag", "isRootProject", "registerCleanupTask"
-		]);
-		switch (specVersion) {
-		case "2.2":
-		case "2.3":
-		case "2.4":
-		case "2.5":
-		case "2.6":
-			return baseInterface;
-		case "3.0":
-			baseInterface.getProject = (projectName) => {
-				const project = this.getProject(projectName);
-				const baseProjectInterface = {};
-				bindFunctions(project, baseProjectInterface, [
-					"getName", "getVersion", "getNamespace"
-				]);
-				switch (specVersion) {
-				case "3.0":
-					return baseProjectInterface;
-				}
-			};
-			return baseInterface;
-		default:
-			throw new Error(`TaskUtil: Unknown or unsupported Specification Version ${specVersion}`);
-		}
-	}
-}
-
-function bindFunctions(sourceObject, targetObject, funcNames) {
-	funcNames.forEach((funcName) => {
-		targetObject[funcName] = sourceObject[funcName].bind(sourceObject);
-	});
-}
-
-module.exports = TaskUtil;