change log generation

.chglog/consolidate-changelogs.js

@@ -1,13 +1,18 @@
-const readline = require("readline");
-const path = require("path");
-const fs = require("fs");
+import readline from "node:readline";
+import path from "node:path";
+import fs from "node:fs";
+import {pathToFileURL} from "node:url";
+
+// Using CommonsJS require.resolve as long as import.meta.resolve is experimental
+import {createRequire} from "node:module";
+const require = createRequire(import.meta.url);
 
 function handleDependencyBump(line) {
 	line = line.replace("[@ui5](https://github.com/ui5)", "@ui5");
-	const moduleMatch = line.match(/Bump (@ui5\/[^\s]+).*to ([0-9.]+)/);
+	const moduleMatch = line.match(/Bump (@ui5\/[^\s]+).*to ([^ ]+)/);
 	if (moduleMatch) {
 		const [, moduleName, moduleVersion] = moduleMatch;
-		const moduleDir = path.dirname(require.resolve(moduleName));
+		const moduleDir = path.dirname(pathToFileURL(require.resolve(moduleName)));
 		const changelogPath = path.join(moduleDir, "CHANGELOG.md");
 		const changelog = fs.readFileSync(changelogPath, {
 			encoding: "utf8"

.chglog/release-config.yml

@@ -3,6 +3,7 @@ template: RELEASE.tpl.md
 info:
   repository_url: https://github.com/SAP/ui5-cli
 options:
+  tag_filter_pattern: '^v[^012]' # For release notes ignore versions below v3 to that we always compare the _last v3+_ tag with the current release
   commits:
     filters:
       Type:

.eslintrc.js → .eslintrc.cjs

@@ -1,14 +1,15 @@
 module.exports = {
+	"parserOptions": {
+		"sourceType": "module",
+	},
 	"env": {
 		"node": true,
-		"es6": true
-	},
-	"parserOptions": {
-		"ecmaVersion": 8
+		"es2021": true
 	},
-	"extends": ["eslint:recommended", "google"],
+	"extends": ["eslint:recommended", "plugin:ava/recommended", "google"],
 	"plugins": [
-		"jsdoc"
+		"jsdoc",
+		"ava"
 	],
 	"rules": {
 		"indent": [
@@ -47,7 +48,11 @@ module.exports = {
 		"no-tabs": "off",
 		"no-console": "off", // sometimes needed by CLI
 		"valid-jsdoc": 0,
-		"jsdoc/check-examples": 2,
+		// jsdoc/check-examples is temporarily set to "warn" as the rule causes issues in our CI
+		// See: https://github.com/gajus/eslint-plugin-jsdoc/issues/508
+		// Starting with ESLint v8, it needs to be disabled as it currently can't be supported
+		// See: https://github.com/eslint/eslint/issues/14745
+		"jsdoc/check-examples": 0,
 		"jsdoc/check-param-names": 2,
 		"jsdoc/check-tag-names": 2,
 		"jsdoc/check-types": 2,
@@ -64,12 +69,16 @@ module.exports = {
 		"jsdoc/require-returns": 0,
 		"jsdoc/require-returns-description": 0,
 		"jsdoc/require-returns-type": 2,
-		"jsdoc/valid-types": 0
+		"jsdoc/valid-types": 0,
+		// ava/assertion-arguments reports concatenated strings in a assertion message as an issue
+		// See: https://github.com/avajs/eslint-plugin-ava/issues/332
+		"ava/assertion-arguments": 0
 	},
 	"settings": {
 		"jsdoc": {
 			"tagNamePreference": {
-				"return": "returns"
+				"return": "returns",
+				"augments": "extends"
 			}
 		}
 	},

.github/dependabot.yml

@@ -13,5 +13,5 @@ updates:
     timezone: Etc/UCT
   reviewers:
   - RandomByte
-  - svbender
+  - matz3
   versioning-strategy: increase

.github/workflows/codeql-analysis.yml

@@ -2,9 +2,15 @@ name: "CodeQL"
 
 on:
   push:
-    branches: [ master ]
+    branches:
+      - master
+      - main
+      - next
   pull_request:
-    branches: [ master ]
+    branches:
+      - master
+      - main
+      - next
 
   # Execute at least once per week to get new findings without active development taking place
   schedule:
@@ -17,11 +23,11 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v2
+      uses: actions/checkout@v3
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v1
+      uses: github/codeql-action/init@v2
       with:
         languages: 'javascript'
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -33,4 +39,4 @@ jobs:
     # 📚 https://git.io/JvXDl
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v1
+      uses: github/codeql-action/analyze@v2

.github/workflows/github-ci.yml

@@ -2,22 +2,28 @@ name: GitHub CI
 
 on:
   push:
-    branches: [ master ]
+    branches:
+      - master
+      - main
+      - next
   pull_request:
-    branches: [ master ]
+    branches:
+      - master
+      - main
+      - next
 
 jobs:
   test:
     name: General checks, tests and coverage reporting
     runs-on: ubuntu-latest
     steps:
 
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
 
-    - name: Use Node.js LTS 14.x
-      uses: actions/setup-node@v2.4.1
+    - name: Use Node.js LTS 16.x
+      uses: actions/setup-node@v3.3.0
       with:
-        node-version: 14.x
+        node-version: 16.x
 
     - name: Install dependencies
       run: npm ci

.github/workflows/reuse-compliance.yml

@@ -2,15 +2,21 @@ name: REUSE
 
 on:
   push:
-    branches: [ master ]
+    branches:
+      - master
+      - main
+      - next
   pull_request:
-    branches: [ master ]
+    branches:
+      - master
+      - main
+      - next
 
 jobs:
   compliance-check:
     name: Compliance Check
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Execute REUSE Compliance Check
       uses: fsfe/[email protected]

CHANGELOG.md

@@ -2,7 +2,145 @@
 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-cli/compare/v2.14.1...HEAD).
+A list of unreleased changes can be found [here](https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.15...HEAD).
+
+<a name="v3.0.0-alpha.15"></a>
+## [v3.0.0-alpha.15] - 2022-10-25
+### Breaking Changes
+- Transform to native ESM ([#529](https://github.com/SAP/ui5-cli/issues/529)) [`8e15daf`](https://github.com/SAP/ui5-cli/commit/8e15daf0e949becbd49d60fc1532642aae7f733e)
+
+### BREAKING CHANGE
+
+This package has been transformed to native ESM. Therefore it no longer provides a CommonJS export.
+If your project uses CommonJS, it needs to be converted to ESM or use a dynamic import.
+
+For more information see also:
+- https://sap.github.io/ui5-tooling/updates/migrate-v3/
+- https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+
+<a name="v3.0.0-alpha.14"></a>
+## [v3.0.0-alpha.14] - 2022-10-20
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.10 to 3.0.0-alpha.11 [`b73f97f`](https://github.com/SAP/ui5-cli/commit/b73f97f7bc7e54747062640dd6db751e125ea9c9)
+
+
+<a name="v3.0.0-alpha.13"></a>
+## [v3.0.0-alpha.13] - 2022-08-10
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/project from 3.0.0-alpha.8 to 3.0.0-alpha.9 [`3c2b9dc`](https://github.com/SAP/ui5-cli/commit/3c2b9dc8bc4b1c82f8969d491af7f5bc3025a3ac)
+
+
+<a name="v3.0.0-alpha.12"></a>
+## [v3.0.0-alpha.12] - 2022-08-09
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/project from 3.0.0-alpha.7 to 3.0.0-alpha.8 [`0e1049e`](https://github.com/SAP/ui5-cli/commit/0e1049e12f929881ce160c756e011e41bf41af95)
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.9 to 3.0.0-alpha.10 [`ae07c21`](https://github.com/SAP/ui5-cli/commit/ae07c21dffdaf6c2fd176807c441e914306d4f30)
+- Bump [@ui5](https://github.com/ui5)/fs from 3.0.0-alpha.5 to 3.0.0-alpha.6 [`4a2c667`](https://github.com/SAP/ui5-cli/commit/4a2c6675b038e30f31c78e84140833837f87e18f)
+- Bump [@ui5](https://github.com/ui5)/logger from 3.0.1-alpha.1 to 3.0.1-alpha.2 [`60f4129`](https://github.com/SAP/ui5-cli/commit/60f4129f4a312b22c562e55920d1204e14f3b4f0)
+
+
+<a name="v3.0.0-alpha.11"></a>
+## [v3.0.0-alpha.11] - 2022-07-27
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/project from 3.0.0-alpha.6 to 3.0.0-alpha.7 [`cac5ae4`](https://github.com/SAP/ui5-cli/commit/cac5ae40a4dbb879e6cd982776ace26340ee8f60)
+- Bump [@ui5](https://github.com/ui5)/server from 3.0.0-alpha.2 to 3.0.0-alpha.3 [`95fd053`](https://github.com/SAP/ui5-cli/commit/95fd0538f7ad23be18a7dd10cc49b37af554eb65)
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.8 to 3.0.0-alpha.9 [`4363588`](https://github.com/SAP/ui5-cli/commit/4363588b138812797ed8c53c18771284b1c38b7a)
+
+
+<a name="v3.0.0-alpha.10"></a>
+## [v3.0.0-alpha.10] - 2022-07-26
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/project from 3.0.0-alpha.4 to 3.0.0-alpha.5 [`8d43873`](https://github.com/SAP/ui5-cli/commit/8d438736375debb54853b61b01696e6fbf3cbbc2)
+
+
+<a name="v3.0.0-alpha.9"></a>
+## [v3.0.0-alpha.9] - 2022-07-15
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.8 to 3.0.0-alpha.8 [`fa048a3`](https://github.com/SAP/ui5-cli/commit/fa048a3ea063374d886724e582a5162a9f450a83)
+- Bump [@ui5](https://github.com/ui5)/project from 3.0.0-alpha.3 to 3.0.0-alpha.4 [`a1aa75a`](https://github.com/SAP/ui5-cli/commit/a1aa75a4d79770d265822ef136390cc38898d4bd)
+
+
+<a name="v3.0.0-alpha.8"></a>
+## [v3.0.0-alpha.8] - 2022-06-14
+### Breaking Changes
+- Adapt to Project Graph APIs ([#413](https://github.com/SAP/ui5-cli/issues/413)) [`945b82b`](https://github.com/SAP/ui5-cli/commit/945b82bc775dc0a711529057908e9f36d8fadb62)
+
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/server from 3.0.0-alpha.1 to 3.0.0-alpha.2 [`5b959b3`](https://github.com/SAP/ui5-cli/commit/5b959b3903b93b0c7c693f2785d26532c8e78d53)
+- Bump [@ui5](https://github.com/ui5)/project from 3.0.0-alpha.2 to 3.0.0-alpha.3 [`780b1c1`](https://github.com/SAP/ui5-cli/commit/780b1c17b9a6b23397b74ef52fbe707aabf21edb)
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.6 to 3.0.0-alpha.7 [`37a7062`](https://github.com/SAP/ui5-cli/commit/37a7062521e08085560ea96a27d15e5f4c5d5574)
+- Bump [@ui5](https://github.com/ui5)/fs from 3.0.0-alpha.3 to 3.0.0-alpha.4 [`ae07607`](https://github.com/SAP/ui5-cli/commit/ae076071ccf4dd9d6a58933d7d6aa0a1fdb9d283)
+
+
+<a name="v3.0.0-alpha.7"></a>
+## [v3.0.0-alpha.7] - 2022-04-26
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/project from 3.0.0-alpha.1 to 3.0.0-alpha.2 [`aac8f7f`](https://github.com/SAP/ui5-cli/commit/aac8f7f5f204660010c42ed428542e01a988d5c6)
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.5 to 3.0.0-alpha.6 [`027e4df`](https://github.com/SAP/ui5-cli/commit/027e4dfba2bbbb9bcf209d82d85ecff7a2acb6a9)
+- Bump [@ui5](https://github.com/ui5)/fs from 3.0.0-alpha.2 to 3.0.0-alpha.3 [`1f43c4e`](https://github.com/SAP/ui5-cli/commit/1f43c4ed2699e66b0d6c50ca3738a6f61c060734)
+
+
+<a name="v3.0.0-alpha.6"></a>
+## [v3.0.0-alpha.6] - 2022-04-14
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.4 to 3.0.0-alpha.5 [`87c4136`](https://github.com/SAP/ui5-cli/commit/87c413627696365eb94de9fccdd7798a05543933)
+
+
+<a name="v3.0.0-alpha.5"></a>
+## [v3.0.0-alpha.5] - 2022-04-05
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.3 to 3.0.0-alpha.4 [`91d3bbd`](https://github.com/SAP/ui5-cli/commit/91d3bbdd01ec1cc80f21094434fa0f7da37ca242)
+
+### Features
+- Add build flag "--experimental-css-variables" ([#501](https://github.com/SAP/ui5-cli/issues/501)) [`0b099db`](https://github.com/SAP/ui5-cli/commit/0b099db193ee94aa0bde8373e883fbc54098cd89)
+
+
+<a name="v3.0.0-alpha.4"></a>
+## [v3.0.0-alpha.4] - 2022-03-10
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.2 to 3.0.0-alpha.3 [`7f836aa`](https://github.com/SAP/ui5-cli/commit/7f836aad558b16eaf05dde2c2a5aa409b1ba7111)
+
+
+<a name="v3.0.0-alpha.3"></a>
+## [v3.0.0-alpha.3] - 2022-02-25
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.1 to 3.0.0-alpha.2 [`617f0f0`](https://github.com/SAP/ui5-cli/commit/617f0f06b29e81f384186c88c07da85be55d2970)
+
+
+<a name="v3.0.0-alpha.2"></a>
+## [v3.0.0-alpha.2] - 2022-01-31
+
+<a name="v3.0.0-alpha.1"></a>
+## [v3.0.0-alpha.1] - 2022-01-25
+### Breaking Changes
+- Require Node.js >= 16.13.2 / npm >= 8 [`71a2696`](https://github.com/SAP/ui5-cli/commit/71a2696ecc056ccfa695bd560d59bb31c7dbeb65)
+
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/project from 3.0.0-alpha.0 to 3.0.0-alpha.1 [`23601ce`](https://github.com/SAP/ui5-cli/commit/23601ce6330f5427960ae40316a8569e641cdf55)
+- Bump [@ui5](https://github.com/ui5)/server from 3.0.0-alpha.0 to 3.0.0-alpha.1 [`61a8714`](https://github.com/SAP/ui5-cli/commit/61a8714a55cb18ba384feee50ddd52f91810f4d0)
+- Bump [@ui5](https://github.com/ui5)/builder from 3.0.0-alpha.0 to 3.0.0-alpha.1 [`e7fcc14`](https://github.com/SAP/ui5-cli/commit/e7fcc14a97d9b89e5b8e958e41e74d0300e45771)
+- Bump [@ui5](https://github.com/ui5)/fs from 3.0.0-alpha.1 to 3.0.0-alpha.2 [`511f3c8`](https://github.com/SAP/ui5-cli/commit/511f3c8044b1f41840c15fcbdca95da5d159d207)
+- Bump [@ui5](https://github.com/ui5)/logger from 3.0.1-alpha.0 to 3.0.1-alpha.1 [`85f5657`](https://github.com/SAP/ui5-cli/commit/85f565781ebe0286ba61601c744c6239e26df6a7)
+- Bump [@ui5](https://github.com/ui5)/fs from 3.0.0-alpha.0 to 3.0.0-alpha.1 [`f629e31`](https://github.com/SAP/ui5-cli/commit/f629e31c22ca375ddf4282bafcd38ff45ea5a4bc)
+
+### BREAKING CHANGE
+
+Support for older Node.js and npm releases has been dropped.
+Only Node.js v16.13.2 and npm v8 or higher are supported.
+
+
+<a name="v3.0.0-alpha.0"></a>
+## [v3.0.0-alpha.0] - 2021-12-14
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/logger from 3.0.0-next.0 to 3.0.1-alpha.0 [`2fa522c`](https://github.com/SAP/ui5-cli/commit/2fa522c5b33766703a14261dc1aa4256fe6be999)
+- Bump [@ui5](https://github.com/ui5)/project from 2.6.0 to 3.0.0-alpha.0 [`2879975`](https://github.com/SAP/ui5-cli/commit/2879975d917423eb4cca7ceccbc209f861c179e0)
+- Bump [@ui5](https://github.com/ui5)/server from 2.4.0 to 3.0.0-alpha.0 [`f850407`](https://github.com/SAP/ui5-cli/commit/f850407871396f151ffddd98ec6a879ded88541d)
+- Bump [@ui5](https://github.com/ui5)/builder from 2.11.3 to 3.0.0-alpha.0 [`7ac03ba`](https://github.com/SAP/ui5-cli/commit/7ac03baf0fd46028aa01cedb0a16763bc3d86cfd)
+- Bump [@ui5](https://github.com/ui5)/fs from 2.0.6 to 3.0.0-alpha.0 [`46bbb4d`](https://github.com/SAP/ui5-cli/commit/46bbb4da942527fe8d9c0a4ece102d951d3b254c)
+- Bump [@ui5](https://github.com/ui5)/logger from 3.0.0-next.0 to 3.0.0-alpha.0 [`e011b86`](https://github.com/SAP/ui5-cli/commit/e011b862c85ba7388c00d3ae0cc86396671b1e2d)
+- Bump [@ui5](https://github.com/ui5)/logger from 2.0.1 to 3.0.0-next.0 [`32a2bcc`](https://github.com/SAP/ui5-cli/commit/32a2bcc47d16bd255d6bd9f6a76a29496782b357)
+
 
 <a name="v2.14.1"></a>
 ## [v2.14.1] - 2021-11-17
@@ -702,6 +840,22 @@ Only Node.js v10 or higher is supported.
 <a name="v0.0.1"></a>
 ## v0.0.1 - 2018-06-06
 
+[v3.0.0-alpha.15]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.14...v3.0.0-alpha.15
+[v3.0.0-alpha.14]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.13...v3.0.0-alpha.14
+[v3.0.0-alpha.13]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.12...v3.0.0-alpha.13
+[v3.0.0-alpha.12]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.11...v3.0.0-alpha.12
+[v3.0.0-alpha.11]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.10...v3.0.0-alpha.11
+[v3.0.0-alpha.10]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.9...v3.0.0-alpha.10
+[v3.0.0-alpha.9]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.8...v3.0.0-alpha.9
+[v3.0.0-alpha.8]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.7...v3.0.0-alpha.8
+[v3.0.0-alpha.7]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.6...v3.0.0-alpha.7
+[v3.0.0-alpha.6]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.5...v3.0.0-alpha.6
+[v3.0.0-alpha.5]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.4...v3.0.0-alpha.5
+[v3.0.0-alpha.4]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.3...v3.0.0-alpha.4
+[v3.0.0-alpha.3]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.2...v3.0.0-alpha.3
+[v3.0.0-alpha.2]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.1...v3.0.0-alpha.2
+[v3.0.0-alpha.1]: https://github.com/SAP/ui5-cli/compare/v3.0.0-alpha.0...v3.0.0-alpha.1
+[v3.0.0-alpha.0]: https://github.com/SAP/ui5-cli/compare/v2.14.1...v3.0.0-alpha.0
 [v2.14.1]: https://github.com/SAP/ui5-cli/compare/v2.14.0...v2.14.1
 [v2.14.0]: https://github.com/SAP/ui5-cli/compare/v2.13.0...v2.14.0
 [v2.13.0]: https://github.com/SAP/ui5-cli/compare/v2.12.1...v2.13.0