@itwin/build-tools 5.0.0-dev.11 → 5.0.0-dev.111

package/CHANGELOG.md

@@ -1,6 +1,85 @@
 # Change Log - @itwin/build-tools
 
-This log was last generated on Thu, 14 Nov 2024 18:13:56 GMT and should not be manually modified.
+This log was last generated on Wed, 30 Apr 2025 13:14:48 GMT and should not be manually modified.
+
+## 4.11.1
+Wed, 30 Apr 2025 13:13:21 GMT
+
+_Version update only_
+
+## 4.11.0
+Wed, 16 Apr 2025 15:50:28 GMT
+
+### Updates
+
+- Bump `typedoc` dependency to a version that supports typescript `5.6`.
+- Deprecate  unused --includes flag
+- add temporary fix for typedoc@0.26 issue #2802
+- Bumped `cross-spawn` to `7.0.5`
+
+## 4.10.13
+Thu, 10 Apr 2025 17:47:21 GMT
+
+_Version update only_
+
+## 4.10.12
+Wed, 02 Apr 2025 19:35:47 GMT
+
+_Version update only_
+
+## 4.10.11
+Wed, 19 Mar 2025 15:30:39 GMT
+
+_Version update only_
+
+## 4.10.10
+Tue, 11 Mar 2025 15:25:11 GMT
+
+_Version update only_
+
+## 4.10.9
+Tue, 11 Mar 2025 05:17:33 GMT
+
+_Version update only_
+
+## 4.10.8
+Thu, 06 Mar 2025 14:13:37 GMT
+
+_Version update only_
+
+## 4.10.7
+Tue, 18 Feb 2025 17:27:03 GMT
+
+_Version update only_
+
+## 4.10.6
+Fri, 24 Jan 2025 08:02:40 GMT
+
+_Version update only_
+
+## 4.10.5
+Tue, 21 Jan 2025 21:56:45 GMT
+
+_Version update only_
+
+## 4.10.4
+Mon, 13 Jan 2025 14:06:43 GMT
+
+_Version update only_
+
+## 4.10.3
+Mon, 06 Jan 2025 14:00:13 GMT
+
+### Updates
+
+- add temporary fix for typedoc@0.26 issue #2802
+
+## 4.10.2
+Thu, 21 Nov 2024 15:22:20 GMT
+
+### Updates
+
+- Bumped `cross-spawn` to `7.0.5`
 
 ## 4.10.1
 Thu, 14 Nov 2024 18:11:00 GMT

package/bin/betools.js

@@ -48,7 +48,10 @@ yargs.strict(true)
         },
         "onlyJson": {
           describe: "Specify a baseUrl to resolve modules"
-        }
+        },
+        "tsconfig": {
+          describe: "Specify a path to `tsconfig.json` configuration file used to build the package. Defaults to `./tsconfig.json`"
+        },
       })
     },
     (argv) => { docsCommand(argv) })
@@ -145,9 +148,11 @@ function docsCommand(options) {
   const testExcludeGlobOpt = options.testExcludeGlob ? ["--testExcludeGlob", options.testExcludeGlob] : [];
   const indexFileOpt = options.tsIndexFile ? ["--tsIndexFile", options.tsIndexFile] : [];
   const onlyJsonOpt = options.onlyJson ? ["--onlyJson"] : [];
+  const tsconfigOpt = options.tsconfig ? ["--tsconfig", options.tsconfig] : [];
   exec("node", [getScriptPath("docs.js"),
   ...sourceOpt, ...outOpt, ...jsonOpt, ...baseUrlOpt,
-  ...excludesOpt, ...excludesGlobOpt, ...testExcludeGlobOpt, ...indexFileOpt, ...onlyJsonOpt]);
+  ...excludesOpt, ...excludesGlobOpt, ...testExcludeGlobOpt,
+  ...indexFileOpt, ...onlyJsonOpt, ...tsconfigOpt]);
 }
 
 function extractCommand(options) {

package/mocha-reporter/index.js

@@ -56,6 +56,7 @@ Object.defineProperty(Base, "color", {
     set: () => { },
 });
 class BentleyMochaReporter extends Spec {
+    _junitReporter;
     constructor(_runner, _options) {
         super(...arguments);
         this._junitReporter = new MochaJUnitReporter(...arguments);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/build-tools",
-  "version": "5.0.0-dev.11",
+  "version": "5.0.0-dev.111",
   "description": "Bentley build tools",
   "license": "MIT",
   "repository": {
@@ -21,15 +21,15 @@
     "url": "http://www.bentley.com"
   },
   "dependencies": {
-    "@microsoft/api-extractor": "~7.47.10",
+    "@microsoft/api-extractor": "~7.52.3",
     "chalk": "^3.0.0",
-    "cpx2": "^3.0.0",
+    "cpx2": "^8.0.0",
     "cross-spawn": "^7.0.5",
     "fs-extra": "^8.1.0",
     "glob": "^10.3.12",
-    "mocha": "^10.2.0",
+    "mocha": "^11.1.0",
     "mocha-junit-reporter": "^2.0.2",
-    "rimraf": "^3.0.2",
+    "rimraf": "^6.0.1",
     "tree-kill": "^1.2.2",
     "typedoc": "^0.26.11",
     "typedoc-plugin-merge-modules": "^6.0.3",
@@ -39,12 +39,12 @@
   },
   "devDependencies": {
     "@itwin/eslint-plugin": "5.0.0-dev.1",
-    "@types/node": "~20.9.5",
+    "@types/node": "~20.17.0",
     "eslint": "^9.13.0"
   },
   "scripts": {
     "build": "tsc 1>&2",
-    "clean": "rimraf ../../modules .rush/temp/package-deps*.json",
+    "clean": "rimraf -g ../../modules .rush/temp/package-deps*.json",
     "docs": "",
     "lint": "eslint \"./src/**/*.ts\" 1>&2",
     "test": "",

package/scripts/docs.js

@@ -52,7 +52,9 @@ const readmeOption = (argv.readme === undefined) ? "none" : argv.readme;
 const options = [
   "--hideGenerator",
   "--logLevel",
-  "Error"
+  "Error",
+  "--cascadedModifierTags", // workaround for https://github.com/TypeStrong/typedoc/issues/2802
+  "@experimental"
 ];
 
 const pluginOptions = [
@@ -64,8 +66,10 @@ if (argv.name) options.push("--name", argv.name);
 
 if (argv.theme) options.push("--theme", argv.theme);
 
+if (argv.tsconfig) options.push("--tsconfig", argv.tsconfig);
+
 const args = [
-  "--entryPointStrategy", "expand", path.resolve(process.cwd(), source),
+  "--entryPointStrategy", "expand", path.resolve(process.cwd(), source).replaceAll("\\", "/"),
   ...options,
   ...excludeArray,
   ...outputOptions,

package/scripts/extract-api-summary.js

@@ -80,8 +80,8 @@ fs.readFile(argv.apiSignature, function (error, data) {
 
     previousLines.push(match[1]);
 
-    // handle deprecated separate since it can be used together with the other release tags
-    match = line.match(/\s@(deprecated)/);
+    // handle deprecated and preview separately since they can be used together with the other release tags
+    match = line.match(/\s@(deprecated|preview)/);
     if (null !== match) {
       previousLines.push(match[1]);
       return;

package/scripts/extract-api.js

@@ -60,9 +60,13 @@ const config = {
   mainEntryPointFilePath: `${entryPointFileName}.d.ts`,
   apiReport: {
     enabled: true,
+    reportFileName: `${entryPointFileName}.api.md`,
     reportFolder: path.resolve(apiReportFolder),
     reportTempFolder: path.resolve(apiReportTempFolder),
     includeForgottenExports: !!includeUnexportedApis,
+    tagsToReport: {
+      "@preview": true
+    },
   },
   docModel: {
     enabled: false

package/tsconfig-base.json

@@ -23,6 +23,7 @@
     "strict": true,
     "strictNullChecks": true,
     "stripInternal": false,
-    "target": "ES2021"
+    "target": "ES2023",
+    "lib": ["ES2023", "DOM", "DOM.Iterable", "ESNext.Disposable"]
   }
 }