@itwin/build-tools 3.6.0-dev.8 → 4.0.0-dev.1

package/CHANGELOG.md

@@ -1,6 +1,31 @@
 # Change Log - @itwin/build-tools
 
-This log was last generated on Wed, 07 Dec 2022 19:12:36 GMT and should not be manually modified.
+This log was last generated on Thu, 26 Jan 2023 22:53:27 GMT and should not be manually modified.
+
+## 3.5.5
+Thu, 26 Jan 2023 22:53:27 GMT
+
+_Version update only_
+
+## 3.5.4
+Wed, 18 Jan 2023 15:27:15 GMT
+
+_Version update only_
+
+## 3.5.3
+Fri, 13 Jan 2023 17:23:07 GMT
+
+_Version update only_
+
+## 3.5.2
+Wed, 11 Jan 2023 16:46:30 GMT
+
+_Version update only_
+
+## 3.5.1
+Thu, 15 Dec 2022 16:38:28 GMT
+
+_Version update only_
 
 ## 3.5.0
 Wed, 07 Dec 2022 19:12:36 GMT

package/LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright © 2017-2022 Bentley Systems, Incorporated. All rights reserved.
+Copyright © 2017-2023 Bentley Systems, Incorporated. All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/bin/betools.js

@@ -40,6 +40,9 @@ yargs.strict(true)
         "excludeGlob": {
           describe: "Specify a directory, filename, or pattern to be excluded"
         },
+        "testExcludeGlob": {
+          describe: "Specify a directory, filename, or pattern to exclude tests. Default value: '**/*test*/**/*'"
+        },
         "tsIndexFile": {
           describe: "The barrel file containing the module documentation. This file is copied to the output folder for parsing."
         },
@@ -92,6 +95,21 @@ yargs.strict(true)
       })
     },
     (argv) => { pseudolocalizeCommand(argv) })
+  .command("copy-assets", "copy assets from @itwin or @bentley dependencies into a destination directory",
+    function (yargs) {
+      return yargs.options({
+        "packageJsonDir": {
+          describe: "The path at which the package.json listing deps that need their assets copied can be found. defaults to '.'"
+        },
+        "nodeModulesDir": {
+          describe: "The path to the node_modules directory where the deps that need their assets copied can be found. defaults to '.'"
+        },
+        "destinationDir": {
+          describe: "the location to copy the assets to. defaults to './lib/assets'"
+        },
+      })
+    },
+    (argv) => { copyAssetsCommand(argv) })
   .help()
   .argv;
 
@@ -100,6 +118,10 @@ function testCommand(options) {
   process.exit(1);
 }
 
+function getScriptPath(name) {
+  return `"${path.resolve(__dirname, path.join("..", "scripts", name))}"`;
+}
+
 function docsCommand(options) {
   const sourceOpt = options.source ? ["--source", options.source] : [];
   const outOpt = options.out ? ["--out", options.out] : [];
@@ -108,11 +130,12 @@ function docsCommand(options) {
   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"] : [];
-  exec(["node", path.resolve(__dirname, "../scripts/docs.js"),
+  exec(["node", getScriptPath("docs.js"),
     ...sourceOpt, ...outOpt, ...jsonOpt, ...baseUrlOpt, ...includesOpt,
-    ...excludesOpt, ...excludesGlobOpt, ...indexFileOpt, ...onlyJsonOpt]);
+    ...excludesOpt, ...excludesGlobOpt, ...testExcludeGlobOpt, ...indexFileOpt, ...onlyJsonOpt]);
 }
 
 function extractCommand(options) {
@@ -120,19 +143,26 @@ function extractCommand(options) {
   const outOpt = options.out ? ["--out", options.out] : [];
   const fileExt = options.fileExt ? ["--fileExt", options.fileExt] : [];
   const recursive = options.recursive ? ["--recursive"] : [];
-  exec(["node", path.resolve(__dirname, "../scripts/extract.js"), ...extractOpt, ...outOpt, ...fileExt, ...recursive]);
+  exec(["node", getScriptPath("extract.js"), ...extractOpt, ...outOpt, ...fileExt, ...recursive]);
 }
 
 function extractApiCommand(options) {
   const entryOpt = options.entry ? ["--entry", options.entry] : [];
   const ignoreTagsOpt = options.ignoreMissingTags ? ["--ignoreMissingTags"] : [];
-  exec(["node", path.resolve(__dirname, "../scripts/extract-api.js"), ...entryOpt, ...ignoreTagsOpt]);
+  exec(["node", getScriptPath("extract-api.js"), ...entryOpt, ...ignoreTagsOpt]);
 }
 
 function pseudolocalizeCommand(options) {
   const englishDir = options.englishDir ? ["--englishDir", options.englishDir] : [];
   const outOpt = options.out ? ["--out", options.out] : [];
-  exec(["node", path.resolve(__dirname, "../scripts/pseudolocalize"), ...englishDir, ...outOpt]);
+  exec(["node", getScriptPath("pseudolocalize"), ...englishDir, ...outOpt]);
+}
+
+function copyAssetsCommand(options) {
+  const packageJsonDir = options.packageJsonDir ? ["--packageJsonDir", options.packageJsonDir] : [];
+  const nodeModulesDir = options.nodeModulesDir ? ["--nodeModulesDir", options.nodeModulesDir] : [];
+  const destinationDir = options.destinationDir ? ["--destinationDir", options.destinationDir] : [];
+  exec(["node", path.resolve(__dirname, "../scripts/copy-assets.js"), ...packageJsonDir, ...nodeModulesDir, ...destinationDir]);
 }
 
 function exec(cmd) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/build-tools",
-  "version": "3.6.0-dev.8",
+  "version": "4.0.0-dev.1",
   "description": "Bentley build tools",
   "license": "MIT",
   "repository": {
@@ -37,7 +37,7 @@
     "yargs": "^17.4.0"
   },
   "devDependencies": {
-    "@itwin/eslint-plugin": "3.6.0-dev.8",
+    "@itwin/eslint-plugin": "4.0.0-dev.1",
     "@types/node": "18.11.5",
     "eslint": "^7.11.0"
   },

package/scripts/copy-assets.js

@@ -0,0 +1,61 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+
+"use strict"
+
+const argv = require("yargs").argv;
+const fs = require("fs-extra");
+const path = require("path");
+
+// example usage
+// betools copy-assets --nodeModulesDir=../../../../
+
+const packageJsonDir = argv.packageJsonDir ?? ".";
+const nodeModulesDir = argv.nodeModulesDir ?? ".";
+const destinationDir = argv.destinationDir ?? "./lib/assets";
+
+// find all dependencies that should have their assets copied from
+// currently this logic will find only packages with the @itwin or @bentley scope
+const getBentleyPackageDeps = () => {
+  const packageJsonPath = `${packageJsonDir}/package.json`;
+  const packageJsonRaw = fs.readFileSync(packageJsonPath);
+  const packageJson = JSON.parse(packageJsonRaw);
+  const deps = new Set();
+
+  for (const packageName in packageJson.dependencies) {
+    if (packageName.includes("@itwin") || packageName.includes("@bentley")) {
+      deps.add(packageName);
+    }
+  }
+
+  return Array.from(deps);
+}
+
+const copySync = (fromPath, toPath) => {
+  if (fs.existsSync(fromPath)) {
+    try {
+      fs.copySync(fromPath, toPath);
+      console.log(`successfully copied from ${fromPath} to ${toPath}`)
+    } catch (ex) {
+      console.error(`failed to copy from ${fromPath} to ${toPath}`, ex);
+    }
+  }
+}
+
+// finds all applicable dependences with assets and copies them into the destination folder
+const copyBentleyPackageDepAssets = () => {
+  if (!fs.existsSync(destinationDir)) {
+    fs.mkdirSync(destinationDir, { recursive: true });
+  }
+
+  // check for assets found in lib as well as lib/cjs
+  for (const target of getBentleyPackageDeps()) {
+    copySync(path.join(nodeModulesDir, "node_modules", target, "lib/assets"), destinationDir);
+    copySync(path.join(nodeModulesDir, "node_modules", target, "lib/cjs/assets"), destinationDir);
+  }
+}
+
+copyBentleyPackageDepAssets();
+console.log("finished copying assets");

package/scripts/docs.js

@@ -29,7 +29,8 @@ 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];
 
-let excludeList = "**/node_modules/**/*,**/*test*/**/*";
+const testExclude = argv.testExcludeGlob ?? "**/*test*/**/*";
+let excludeList = `**/node_modules/**/*,${testExclude}`;
 if (argv.excludes !== undefined)
   excludeList += ",**/" + argv.excludes + "/**/*";
 if (argv.excludeGlob !== undefined)