@rushstack/package-extractor 0.12.13 → 0.12.14

package/CHANGELOG.json

@@ -1,6 +1,33 @@
 {
   "name": "@rushstack/package-extractor",
   "entries": [
+    {
+      "version": "0.12.14",
+      "tag": "@rushstack/package-extractor_v0.12.14",
+      "date": "Thu, 09 Apr 2026 00:15:07 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.22.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.5`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `5.3.5`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft-webpack5-plugin\" to `1.3.12`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.11`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/webpack-preserve-dynamic-require-plugin\" to `0.12.12`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.12.13",
       "tag": "@rushstack/package-extractor_v0.12.13",

package/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Change Log - @rushstack/package-extractor
 
-This log was last generated on Sat, 04 Apr 2026 00:14:00 GMT and should not be manually modified.
+This log was last generated on Thu, 09 Apr 2026 00:15:07 GMT and should not be manually modified.
+
+## 0.12.14
+Thu, 09 Apr 2026 00:15:07 GMT
+
+_Version update only_
 
 ## 0.12.13
 Sat, 04 Apr 2026 00:14:00 GMT

package/dist/scripts/create-links.js

@@ -56401,10 +56401,11 @@ class FileSystem {
      * Writes a text string to a file on disk, overwriting the file if it already exists.
      * Behind the scenes it uses `fs.writeFileSync()`.
      * @remarks
-     * Throws an error if the folder doesn't exist, unless ensureFolder=true.
+     * Throws an error if the folder doesn't exist, unless {@link IFileSystemWriteFileOptionsBase.ensureFolderExists}
+     * is set to `true`.
      * @param filePath - The absolute or relative path of the file.
      * @param contents - The text that should be written to the file.
-     * @param options - Optional settings that can change the behavior. Type: `IWriteFileOptions`
+     * @param options - Optional settings that can change the behavior.
      */
     static writeFile(filePath, contents, options) {
         FileSystem._wrapException(() => {
@@ -56441,7 +56442,8 @@ class FileSystem {
      * multiple sources.
      *
      * @remarks
-     * Throws an error if the folder doesn't exist, unless ensureFolder=true.
+     * Throws an error if the folder doesn't exist, unless {@link IFileSystemWriteFileOptionsBase.ensureFolderExists}
+     * is set to `true`.
      * @param filePath - The absolute or relative path of the file.
      * @param contents - The content that should be written to the file.
      * @param options - Optional settings that can change the behavior.
@@ -56573,10 +56575,11 @@ class FileSystem {
      * Writes a text string to a file on disk, appending to the file if it already exists.
      * Behind the scenes it uses `fs.appendFileSync()`.
      * @remarks
-     * Throws an error if the folder doesn't exist, unless ensureFolder=true.
+     * Throws an error if the folder doesn't exist, unless {@link IFileSystemWriteFileOptionsBase.ensureFolderExists}
+     * is set to `true`.
      * @param filePath - The absolute or relative path of the file.
      * @param contents - The text that should be written to the file.
-     * @param options - Optional settings that can change the behavior. Type: `IWriteFileOptions`
+     * @param options - Optional settings that can change the behavior.
      */
     static appendToFile(filePath, contents, options) {
         FileSystem._wrapException(() => {
@@ -56815,6 +56818,50 @@ class FileSystem {
             }
         });
     }
+    /**
+     * Creates a readable stream for an existing file.
+     * Behind the scenes it uses `fs.createReadStream()`.
+     *
+     * @param filePath - The path to the file. The path may be absolute or relative.
+     * @returns A new readable stream for the file.
+     */
+    static createReadStream(filePath) {
+        return FileSystem._wrapException(() => {
+            return fs.createReadStream(filePath);
+        });
+    }
+    /**
+     * Creates a writable stream for writing to a file.
+     * Behind the scenes it uses `fs.createWriteStream()`.
+     *
+     * @remarks
+     * Throws an error if the folder doesn't exist, unless {@link IFileSystemWriteFileOptionsBase.ensureFolderExists}
+     * is set to `true`.
+     * @param filePath - The path to the file. The path may be absolute or relative.
+     * @param options - Optional settings that can change the behavior.
+     * @returns A new writable stream for the file.
+     */
+    static createWriteStream(filePath, options) {
+        return FileSystem._wrapException(() => {
+            if (options === null || options === void 0 ? void 0 : options.ensureFolderExists) {
+                const folderPath = nodeJsPath.dirname(filePath);
+                FileSystem.ensureFolder(folderPath);
+            }
+            return fs.createWriteStream(filePath);
+        });
+    }
+    /**
+     * An async version of {@link FileSystem.createWriteStream}.
+     */
+    static async createWriteStreamAsync(filePath, options) {
+        return await FileSystem._wrapExceptionAsync(async () => {
+            if (options === null || options === void 0 ? void 0 : options.ensureFolderExists) {
+                const folderPath = nodeJsPath.dirname(filePath);
+                await FileSystem.ensureFolderAsync(folderPath);
+            }
+            return fs.createWriteStream(filePath);
+        });
+    }
     // ===============
     // LINK OPERATIONS
     // ===============
@@ -63167,19 +63214,13 @@ class ProblemCollector extends TerminalWritable_1.TerminalWritable {
     constructor(options) {
         super(options);
         this._problems = new Set();
-        if (!options ||
-            ((!options.matchers || options.matchers.length === 0) &&
-                (!options.matcherJson || options.matcherJson.length === 0))) {
-            throw new Error('ProblemCollector requires at least one problem matcher.');
-        }
-        const fromJson = options.matcherJson
-            ? (0, problem_matcher_1.parseProblemMatchersJson)(options.matcherJson)
-            : [];
-        this._matchers = [...(options.matchers || []), ...fromJson];
+        const { matchers = [], matcherJson = [], onProblem } = options;
+        const fromJson = matcherJson.length !== 0 ? (0, problem_matcher_1.parseProblemMatchersJson)(matcherJson) : [];
+        this._matchers = [...matchers, ...fromJson];
         if (this._matchers.length === 0) {
             throw new Error('ProblemCollector requires at least one problem matcher.');
         }
-        this._onProblem = options.onProblem;
+        this._onProblem = onProblem;
     }
     /**
      * {@inheritdoc IProblemCollector}
@@ -64413,14 +64454,15 @@ const NormalizeNewlinesTextRewriter_1 = __webpack_require__(/*! ./NormalizeNewli
 class TextRewriterTransform extends TerminalTransform_1.TerminalTransform {
     constructor(options) {
         super(options);
-        const textRewriters = options.textRewriters || [];
-        if (options.removeColors) {
+        const { textRewriters: inputTextRewriters = [], removeColors, normalizeNewlines, ensureNewlineAtEnd } = options;
+        const textRewriters = [...inputTextRewriters];
+        if (removeColors) {
             textRewriters.push(new RemoveColorsTextRewriter_1.RemoveColorsTextRewriter());
         }
-        if (options.normalizeNewlines) {
+        if (normalizeNewlines) {
             textRewriters.push(new NormalizeNewlinesTextRewriter_1.NormalizeNewlinesTextRewriter({
-                newlineKind: options.normalizeNewlines,
-                ensureNewlineAtEnd: options.ensureNewlineAtEnd
+                newlineKind: normalizeNewlines,
+                ensureNewlineAtEnd
             }));
         }
         if (textRewriters.length === 0) {
@@ -65735,19 +65777,19 @@ const BaseClasses_1 = __webpack_require__(/*! ../parameters/BaseClasses */ 97145
  */
 class AliasCommandLineAction extends CommandLineAction_1.CommandLineAction {
     constructor(options) {
-        const toolFilename = options.toolFilename;
-        const targetActionName = options.targetAction.actionName;
-        const defaultParametersString = (options.defaultParameters || []).join(' ');
+        const { toolFilename, targetAction, defaultParameters: defaultParams = [], aliasName } = options;
+        const targetActionName = targetAction.actionName;
+        const defaultParametersString = defaultParams.join(' ');
         const summary = `An alias for "${toolFilename} ${targetActionName}${defaultParametersString ? ` ${defaultParametersString}` : ''}".`;
         super({
-            actionName: options.aliasName,
+            actionName: aliasName,
             summary,
             documentation: `${summary} For more information on the aliased command, use ` +
                 `"${toolFilename} ${targetActionName} --help".`
         });
         this._parameterKeyMap = new Map();
-        this.targetAction = options.targetAction;
-        this.defaultParameters = options.defaultParameters || [];
+        this.targetAction = targetAction;
+        this.defaultParameters = defaultParams;
     }
     /** @internal */
     _registerDefinedParameters(state) {
@@ -65888,13 +65930,14 @@ const ACTION_NAME_REGEXP = /^[a-z][a-z0-9]*([-:][a-z0-9]+)*$/;
 class CommandLineAction extends CommandLineParameterProvider_1.CommandLineParameterProvider {
     constructor(options) {
         super();
-        if (!ACTION_NAME_REGEXP.test(options.actionName)) {
-            throw new Error(`Invalid action name "${options.actionName}". ` +
+        const { actionName, summary, documentation } = options;
+        if (!ACTION_NAME_REGEXP.test(actionName)) {
+            throw new Error(`Invalid action name "${actionName}". ` +
                 `The name must be comprised of lower-case words optionally separated by hyphens or colons.`);
         }
-        this.actionName = options.actionName;
-        this.summary = options.summary;
-        this.documentation = options.documentation;
+        this.actionName = actionName;
+        this.summary = summary;
+        this.documentation = documentation;
         this._argumentParser = undefined;
     }
     /**