@itwin/build-tools 5.0.0-dev.1 → 5.0.0-dev.100

package/CHANGELOG.md

@@ -1,6 +1,85 @@
 # Change Log - @itwin/build-tools
 
-This log was last generated on Tue, 05 Nov 2024 15:24:11 GMT and should not be manually modified.
+This log was last generated on Wed, 02 Apr 2025 19:38:36 GMT and should not be manually modified.
+
+## 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
+
+### Updates
+
+- Bump `typedoc` dependency to a version that supports typescript `5.6`.
+- Deprecate  unused --includes flag
+
+## 4.10.0
+Wed, 13 Nov 2024 15:23:38 GMT
+
+### Updates
+
+- Allow specifying a relative directory for the `entry` argument in the `extract-api` command.
+
+## 4.9.7
+Wed, 06 Nov 2024 19:23:04 GMT
+
+_Version update only_
 
 ## 4.9.6
 Tue, 05 Nov 2024 15:22:45 GMT

package/bin/betools.js

@@ -32,7 +32,7 @@ yargs.strict(true)
           describe: "Specify a baseUrl to resolve modules"
         },
         "includes": {
-          describe: "Specify a baseUrl to resolve modules"
+          describe: "Deprecated - this flag does nothing and will be removed in @itwin/build-tools 5.x"
         },
         "excludes": {
           describe: "Specify a directory, filename, or pattern to be excluded"
@@ -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) })
@@ -140,15 +143,16 @@ function docsCommand(options) {
   const outOpt = options.out ? ["--out", options.out] : [];
   const jsonOpt = options.json ? ["--json", options.json] : [];
   const baseUrlOpt = options.baseUrl ? ["--baseUrl", options.baseUrl] : [];
-  const includesOpt = options.includes ? ["--includes", options.includes] : [];
   const excludesOpt = options.excludes ? ["--excludes", options.excludes] : [];
   const excludesGlobOpt = options.excludeGlob ? ["--excludeGlob", options.excludeGlob] : [];
   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, ...includesOpt,
-  ...excludesOpt, ...excludesGlobOpt, ...testExcludeGlobOpt, ...indexFileOpt, ...onlyJsonOpt]);
+  ...sourceOpt, ...outOpt, ...jsonOpt, ...baseUrlOpt,
+  ...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.1",
+  "version": "5.0.0-dev.100",
   "description": "Bentley build tools",
   "license": "MIT",
   "repository": {
@@ -21,30 +21,30 @@
     "url": "http://www.bentley.com"
   },
   "dependencies": {
-    "@microsoft/api-extractor": "~7.47.10",
+    "@microsoft/api-extractor": "~7.49.1",
     "chalk": "^3.0.0",
-    "cpx2": "^3.0.0",
-    "cross-spawn": "^7.0.1",
+    "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.25.8",
-    "typedoc-plugin-merge-modules": "^5.1.0",
+    "typedoc": "^0.26.11",
+    "typedoc-plugin-merge-modules": "^6.0.3",
     "typescript": "~5.6.2",
     "wtfnode": "^0.9.1",
     "yargs": "^17.4.0"
   },
   "devDependencies": {
     "@itwin/eslint-plugin": "5.0.0-dev.1",
-    "@types/node": "~18.16.20",
+    "@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

@@ -27,7 +27,6 @@ const out = (argv.out === undefined) ? paths.appDocs : argv.out;
 const json = (argv.json === undefined) ? paths.appJsonDocs : argv.json;
 
 const baseUrlOptions = (argv.baseUrl === undefined) ? [] : ["--baseUrl", argv.baseUrl];
-const includeOptions = (argv.includes === undefined) ? [] : ["--includes", argv.includes];
 
 const testExclude = argv.testExcludeGlob ?? "**/*test*/**/*";
 const excludeInternalFolders = "**/internal/**/*"
@@ -51,14 +50,15 @@ if (argv.onlyJson === undefined)
 const readmeOption = (argv.readme === undefined) ? "none" : argv.readme;
 
 const options = [
-  "--excludePrivate",
   "--hideGenerator",
   "--logLevel",
-  "Error"
+  "Error",
+  "--cascadedModifierTags", // workaround for https://github.com/TypeStrong/typedoc/issues/2802
+  "@experimental"
 ];
 
 const pluginOptions = [
-  "--plugin", "typedoc-plugin-merge-modules",
+  "--plugin", require.resolve("typedoc-plugin-merge-modules"),
   "--mergeModulesMergeMode", "module",
 ];
 
@@ -66,15 +66,16 @@ 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,
   "--readme", readmeOption,
   ...pluginOptions,
   ...baseUrlOptions,
-  ...includeOptions
 ];
 
 console.log("Arguments to TypeDoc: " + JSON.stringify(args, null, 2));

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"]
   }
 }