Merge remote-tracking branch 'remotes/origin/main' into empty-paragra…

…ph-bug-fix

# Conflicts:
#	build-tests/install-test-workspace/workspace/common/pnpm-lock.yaml

apps/api-documenter/CHANGELOG.json

@@ -1,6 +1,75 @@
 {
   "name": "@microsoft/api-documenter",
   "entries": [
+    {
+      "version": "7.17.26",
+      "tag": "@microsoft/api-documenter_v7.17.26",
+      "date": "Tue, 28 Jun 2022 22:47:13 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor-model\" to `7.20.3`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.49.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `0.46.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft-node-rig\" to `1.9.16`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "7.17.25",
+      "tag": "@microsoft/api-documenter_v7.17.25",
+      "date": "Tue, 28 Jun 2022 00:23:32 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor-model\" to `7.20.2`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.48.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `4.12.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/eslint-config\" to `2.6.2`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `0.45.14`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft-node-rig\" to `1.9.15`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "7.17.24",
+      "tag": "@microsoft/api-documenter_v7.17.24",
+      "date": "Mon, 27 Jun 2022 18:43:09 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor-model\" to `7.20.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.47.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `0.45.13`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft-node-rig\" to `1.9.14`"
+          }
+        ]
+      }
+    },
     {
       "version": "7.17.23",
       "tag": "@microsoft/api-documenter_v7.17.23",

apps/api-documenter/CHANGELOG.md

@@ -1,6 +1,21 @@
 # Change Log - @microsoft/api-documenter
 
-This log was last generated on Sat, 25 Jun 2022 21:00:40 GMT and should not be manually modified.
+This log was last generated on Tue, 28 Jun 2022 22:47:13 GMT and should not be manually modified.
+
+## 7.17.26
+Tue, 28 Jun 2022 22:47:13 GMT
+
+_Version update only_
+
+## 7.17.25
+Tue, 28 Jun 2022 00:23:32 GMT
+
+_Version update only_
+
+## 7.17.24
+Mon, 27 Jun 2022 18:43:09 GMT
+
+_Version update only_
 
 ## 7.17.23
 Sat, 25 Jun 2022 21:00:40 GMT

apps/api-documenter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/api-documenter",
-  "version": "7.17.23",
+  "version": "7.17.26",
   "description": "Read JSON files from api-extractor, generate documentation pages",
   "repository": {
     "type": "git",

apps/api-extractor/CHANGELOG.json

@@ -1,6 +1,65 @@
 {
   "name": "@microsoft/api-extractor",
   "entries": [
+    {
+      "version": "7.28.1",
+      "tag": "@microsoft/api-extractor_v7.28.1",
+      "date": "Tue, 28 Jun 2022 22:47:13 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor-model\" to `7.20.3`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.49.0`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "7.28.0",
+      "tag": "@microsoft/api-extractor_v7.28.0",
+      "date": "Tue, 28 Jun 2022 00:23:32 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Add support for the \"ignoreMissingEntryPoint\" ExtractorConfig option to allow for loading an ExtractorConfig before the target project is built."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor-model\" to `7.20.2`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.48.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/rig-package\" to `0.3.13`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `4.12.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/eslint-config\" to `2.6.2`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "7.27.1",
+      "tag": "@microsoft/api-extractor_v7.27.1",
+      "date": "Mon, 27 Jun 2022 18:43:09 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor-model\" to `7.20.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.47.0`"
+          }
+        ]
+      }
+    },
     {
       "version": "7.27.0",
       "tag": "@microsoft/api-extractor_v7.27.0",

apps/api-extractor/CHANGELOG.md

@@ -1,6 +1,23 @@
 # Change Log - @microsoft/api-extractor
 
-This log was last generated on Sat, 25 Jun 2022 21:00:40 GMT and should not be manually modified.
+This log was last generated on Tue, 28 Jun 2022 22:47:13 GMT and should not be manually modified.
+
+## 7.28.1
+Tue, 28 Jun 2022 22:47:13 GMT
+
+_Version update only_
+
+## 7.28.0
+Tue, 28 Jun 2022 00:23:32 GMT
+
+### Minor changes
+
+- Add support for the "ignoreMissingEntryPoint" ExtractorConfig option to allow for loading an ExtractorConfig before the target project is built.
+
+## 7.27.1
+Mon, 27 Jun 2022 18:43:09 GMT
+
+_Version update only_
 
 ## 7.27.0
 Sat, 25 Jun 2022 21:00:40 GMT

apps/api-extractor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/api-extractor",
-  "version": "7.27.0",
+  "version": "7.28.1",
   "description": "Analyze the exported API for a TypeScript library and generate reviews, documentation, and .d.ts rollups",
   "keywords": [
     "typescript",
@@ -52,8 +52,8 @@
   },
   "devDependencies": {
     "@rushstack/eslint-config": "workspace:*",
-    "@rushstack/heft": "0.45.6",
-    "@rushstack/heft-node-rig": "1.9.7",
+    "@rushstack/heft": "0.45.14",
+    "@rushstack/heft-node-rig": "1.9.15",
     "@types/heft-jest": "1.0.1",
     "@types/lodash": "4.14.116",
     "@types/node": "12.20.24",

apps/api-extractor/src/api/ExtractorConfig.ts

@@ -136,6 +136,14 @@ export interface IExtractorConfigPrepareOptions {
    * `@microsoft/api-extractor/extends/tsdoc-base.json`.
    */
   tsdocConfigFile?: TSDocConfigFile;
+
+  /**
+   * When preparing the configuration object, folder and file paths referenced in the configuration are checked
+   * for existence, and an error is reported if they are not found.  This option can be used to disable this
+   * check for the main entry point module. This may be useful when preparing a configuration file for an
+   * un-built project.
+   */
+  ignoreMissingEntryPoint?: boolean;
 }
 
 interface IExtractorConfigParameters {
@@ -811,7 +819,7 @@ export class ExtractorConfig {
         );
       }
 
-      if (!FileSystem.exists(mainEntryPointFilePath)) {
+      if (!options.ignoreMissingEntryPoint && !FileSystem.exists(mainEntryPointFilePath)) {
         throw new Error('The "mainEntryPointFilePath" path does not exist: ' + mainEntryPointFilePath);
       }
 

apps/heft/CHANGELOG.json

@@ -1,6 +1,74 @@
 {
   "name": "@rushstack/heft",
   "entries": [
+    {
+      "version": "0.46.0",
+      "tag": "@rushstack/heft_v0.46.0",
+      "date": "Tue, 28 Jun 2022 22:47:13 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "(BREAKING CHANGE) Update the --locale build parameter to support multiple values and replace the `locale?: string` parameter in `IBuildStageProperties` with a `locales?: readonly string[]` parameter."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/heft-config-file\" to `0.8.10`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.49.0`"
+          },
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor\" to `7.28.1`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.45.14",
+      "tag": "@rushstack/heft_v0.45.14",
+      "date": "Tue, 28 Jun 2022 00:23:32 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/heft-config-file\" to `0.8.9`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.48.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/rig-package\" to `0.3.13`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `4.12.1`"
+          },
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor\" to `7.28.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/eslint-config\" to `2.6.2`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.45.13",
+      "tag": "@rushstack/heft_v0.45.13",
+      "date": "Mon, 27 Jun 2022 18:43:09 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/heft-config-file\" to `0.8.8`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `3.47.0`"
+          },
+          {
+            "comment": "Updating dependency \"@microsoft/api-extractor\" to `7.27.1`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.45.12",
       "tag": "@rushstack/heft_v0.45.12",

apps/heft/CHANGELOG.md

@@ -1,6 +1,23 @@
 # Change Log - @rushstack/heft
 
-This log was last generated on Sat, 25 Jun 2022 21:00:40 GMT and should not be manually modified.
+This log was last generated on Tue, 28 Jun 2022 22:47:13 GMT and should not be manually modified.
+
+## 0.46.0
+Tue, 28 Jun 2022 22:47:13 GMT
+
+### Minor changes
+
+- (BREAKING CHANGE) Update the --locale build parameter to support multiple values and replace the `locale?: string` parameter in `IBuildStageProperties` with a `locales?: readonly string[]` parameter.
+
+## 0.45.14
+Tue, 28 Jun 2022 00:23:32 GMT
+
+_Version update only_
+
+## 0.45.13
+Mon, 27 Jun 2022 18:43:09 GMT
+
+_Version update only_
 
 ## 0.45.12
 Sat, 25 Jun 2022 21:00:40 GMT

apps/heft/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/heft",
-  "version": "0.45.12",
+  "version": "0.46.0",
   "description": "Build all your JavaScript projects the same way: A way that works.",
   "keywords": [
     "toolchain",
@@ -52,8 +52,8 @@
   "devDependencies": {
     "@microsoft/api-extractor": "workspace:*",
     "@rushstack/eslint-config": "workspace:*",
-    "@rushstack/heft": "0.45.6",
-    "@rushstack/heft-node-rig": "1.9.7",
+    "@rushstack/heft": "0.45.14",
+    "@rushstack/heft-node-rig": "1.9.15",
     "@types/argparse": "1.0.38",
     "@types/eslint": "8.2.0",
     "@types/glob": "7.1.1",

apps/heft/src/plugins/NodeServicePlugin.ts

@@ -4,15 +4,14 @@
 import * as child_process from 'child_process';
 import * as process from 'process';
 import { performance } from 'perf_hooks';
-import { InternalError } from '@rushstack/node-core-library';
+import { InternalError, SubprocessTerminator } from '@rushstack/node-core-library';
 
 import { HeftSession } from '../pluginFramework/HeftSession';
 import { HeftConfiguration } from '../configuration/HeftConfiguration';
 import { IBuildStageContext, ICompileSubstage, IPostBuildSubstage } from '../stages/BuildStage';
 import { ScopedLogger } from '../pluginFramework/logging/ScopedLogger';
 import { IHeftPlugin } from '../pluginFramework/IHeftPlugin';
 import { CoreConfigFiles } from '../utilities/CoreConfigFiles';
-import { SubprocessTerminator } from '../utilities/subprocess/SubprocessTerminator';
 
 const PLUGIN_NAME: string = 'NodeServicePlugin';