Merge branch 'main' into regexp-bundledPackages

Author: Josmithr

apps/api-documenter/package.json

@@ -23,15 +23,15 @@
     "@microsoft/api-extractor-model": "workspace:*",
     "@microsoft/tsdoc": "0.14.2",
     "@rushstack/node-core-library": "workspace:*",
+    "@rushstack/terminal": "workspace:*",
     "@rushstack/ts-command-line": "workspace:*",
-    "colors": "~1.2.1",
     "js-yaml": "~3.13.1",
     "resolve": "~1.22.1"
   },
   "devDependencies": {
     "@rushstack/heft": "workspace:*",
-    "local-node-rig": "workspace:*",
     "@types/js-yaml": "3.12.1",
-    "@types/resolve": "1.20.2"
+    "@types/resolve": "1.20.2",
+    "local-node-rig": "workspace:*"
   }
 }

apps/api-documenter/src/cli/BaseAction.ts

@@ -3,7 +3,6 @@
 
 import * as path from 'path';
 import type * as tsdoc from '@microsoft/tsdoc';
-import colors from 'colors/safe';
 
 import {
   CommandLineAction,
@@ -18,6 +17,7 @@ import {
   ApiDocumentedItem,
   type IResolveDeclarationReferenceResult
 } from '@microsoft/api-extractor-model';
+import { Colorize } from '@rushstack/terminal';
 
 export interface IBuildApiModelResult {
   apiModel: ApiModel;
@@ -94,7 +94,7 @@ export abstract class BaseAction extends CommandLineAction {
 
           if (result.errorMessage) {
             console.log(
-              colors.yellow(
+              Colorize.yellow(
                 `Warning: Unresolved @inheritDoc tag for ${apiItem.displayName}: ` + result.errorMessage
               )
             );

apps/api-documenter/src/documenters/OfficeYamlDocumenter.ts

@@ -1,12 +1,12 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 
-import colors from 'colors';
 import * as path from 'path';
 import yaml = require('js-yaml');
 
 import type { ApiModel } from '@microsoft/api-extractor-model';
 import { FileSystem } from '@rushstack/node-core-library';
+import { Colorize } from '@rushstack/terminal';
 
 import type { IYamlTocItem } from '../yaml/IYamlTocFile';
 import type { IYamlItem } from '../yaml/IYamlApiFile';
@@ -59,7 +59,7 @@ export class OfficeYamlDocumenter extends YamlDocumenter {
     // After we generate everything, check for any unused snippets
     console.log();
     for (const apiName of Object.keys(this._snippets)) {
-      console.error(colors.yellow('Warning: Unused snippet ' + apiName));
+      console.error(Colorize.yellow('Warning: Unused snippet ' + apiName));
     }
   }
 

apps/api-documenter/src/markdown/CustomMarkdownEmitter.ts

@@ -1,10 +1,9 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 
-import colors from 'colors';
-
 import type { DocNode, DocLinkTag, StringBuilder } from '@microsoft/tsdoc';
 import type { ApiModel, IResolveDeclarationReferenceResult, ApiItem } from '@microsoft/api-extractor-model';
+import { Colorize } from '@rushstack/terminal';
 
 import { CustomDocNodeKind } from '../nodes/CustomDocNodeKind';
 import type { DocHeading } from '../nodes/DocHeading';
@@ -183,12 +182,12 @@ export class CustomMarkdownEmitter extends MarkdownEmitter {
           context.writer.write(encodedLinkText);
           context.writer.write(`](${filename!})`);
         } else {
-          console.log(colors.yellow('WARNING: Unable to determine link text'));
+          console.log(Colorize.yellow('WARNING: Unable to determine link text'));
         }
       }
     } else if (result.errorMessage) {
       console.log(
-        colors.yellow(
+        Colorize.yellow(
           `WARNING: Unable to resolve reference "${docLinkTag.codeDestination!.emitAsTsdoc()}": ` +
             result.errorMessage
         )

apps/api-documenter/src/start.ts

@@ -2,17 +2,19 @@
 // See LICENSE in the project root for license information.
 
 import * as os from 'os';
-import colors from 'colors';
 
 import { PackageJsonLookup } from '@rushstack/node-core-library';
+import { Colorize } from '@rushstack/terminal';
 
 import { ApiDocumenterCommandLine } from './cli/ApiDocumenterCommandLine';
 
 const myPackageVersion: string = PackageJsonLookup.loadOwnPackageJson(__dirname).version;
 
 console.log(
   os.EOL +
-    colors.bold(`api-documenter ${myPackageVersion} ` + colors.cyan(' - https://api-extractor.com/') + os.EOL)
+    Colorize.bold(
+      `api-documenter ${myPackageVersion} ` + Colorize.cyan(' - https://api-extractor.com/') + os.EOL
+    )
 );
 
 const parser: ApiDocumenterCommandLine = new ApiDocumenterCommandLine();

apps/api-extractor/package.json

@@ -38,12 +38,12 @@
   },
   "dependencies": {
     "@microsoft/api-extractor-model": "workspace:*",
-    "@microsoft/tsdoc": "0.14.2",
     "@microsoft/tsdoc-config": "~0.16.1",
+    "@microsoft/tsdoc": "0.14.2",
     "@rushstack/node-core-library": "workspace:*",
     "@rushstack/rig-package": "workspace:*",
+    "@rushstack/terminal": "workspace:*",
     "@rushstack/ts-command-line": "workspace:*",
-    "colors": "~1.2.1",
     "lodash": "~4.17.15",
     "minimatch": "~3.0.3",
     "resolve": "~1.22.1",
@@ -52,14 +52,14 @@
     "typescript": "5.3.3"
   },
   "devDependencies": {
-    "local-eslint-config": "workspace:*",
-    "@rushstack/heft": "0.64.0",
     "@rushstack/heft-node-rig": "2.4.0",
+    "@rushstack/heft": "0.64.0",
     "@types/heft-jest": "1.0.1",
     "@types/lodash": "4.14.116",
     "@types/minimatch": "3.0.5",
     "@types/node": "18.17.15",
     "@types/resolve": "1.20.2",
-    "@types/semver": "7.5.0"
+    "@types/semver": "7.5.0",
+    "local-eslint-config": "workspace:*"
   }
 }

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

@@ -3,12 +3,12 @@
 
 import * as path from 'path';
 import * as ts from 'typescript';
-import colors = require('colors');
 
 import { JsonFile } from '@rushstack/node-core-library';
 
 import { ExtractorConfig } from './ExtractorConfig';
 import type { IExtractorInvokeOptions } from './Extractor';
+import { Colorize } from '@rushstack/terminal';
 
 /**
  * Options for {@link CompilerState.create}
@@ -60,7 +60,7 @@ export class CompilerState {
     if (!commandLine.options.skipLibCheck && extractorConfig.skipLibCheck) {
       commandLine.options.skipLibCheck = true;
       console.log(
-        colors.cyan(
+        Colorize.cyan(
           'API Extractor was invoked with skipLibCheck. This is not recommended and may cause ' +
             'incorrect type analysis.'
         )

apps/api-extractor/src/cli/ApiExtractorCommandLine.ts

@@ -1,11 +1,11 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 
-import colors from 'colors';
 import * as os from 'os';
 
 import { CommandLineParser, type CommandLineFlagParameter } from '@rushstack/ts-command-line';
 import { InternalError } from '@rushstack/node-core-library';
+import { Colorize } from '@rushstack/terminal';
 
 import { RunAction } from './RunAction';
 import { InitAction } from './InitAction';
@@ -42,7 +42,7 @@ export class ApiExtractorCommandLine extends CommandLineParser {
       if (this._debugParameter.value) {
         console.error(os.EOL + error.stack);
       } else {
-        console.error(os.EOL + colors.red('ERROR: ' + error.message.trim()));
+        console.error(os.EOL + Colorize.red('ERROR: ' + error.message.trim()));
       }
 
       process.exitCode = 1;

apps/api-extractor/src/cli/InitAction.ts

@@ -1,10 +1,10 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 
-import colors from 'colors';
 import * as path from 'path';
 import { FileSystem } from '@rushstack/node-core-library';
 import { CommandLineAction } from '@rushstack/ts-command-line';
+import { Colorize } from '@rushstack/terminal';
 
 import type { ApiExtractorCommandLine } from './ApiExtractorCommandLine';
 import { ExtractorConfig } from '../api/ExtractorConfig';
@@ -27,12 +27,12 @@ export class InitAction extends CommandLineAction {
     const outputFilePath: string = path.resolve(ExtractorConfig.FILENAME);
 
     if (FileSystem.exists(outputFilePath)) {
-      console.log(colors.red('The output file already exists:'));
+      console.log(Colorize.red('The output file already exists:'));
       console.log('\n  ' + outputFilePath + '\n');
       throw new Error('Unable to write output file');
     }
 
-    console.log(colors.green('Writing file: ') + outputFilePath);
+    console.log(Colorize.green('Writing file: ') + outputFilePath);
     FileSystem.copyFile({
       sourcePath: inputFilePath,
       destinationPath: outputFilePath

apps/api-extractor/src/cli/RunAction.ts

@@ -1,19 +1,17 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 
-import colors from 'colors';
 import * as os from 'os';
 import * as path from 'path';
 import { PackageJsonLookup, FileSystem, type IPackageJson, Path } from '@rushstack/node-core-library';
-
+import { Colorize } from '@rushstack/terminal';
 import {
   CommandLineAction,
   type CommandLineStringParameter,
   type CommandLineFlagParameter
 } from '@rushstack/ts-command-line';
 
 import { Extractor, type ExtractorResult } from '../api/Extractor';
-
 import type { ApiExtractorCommandLine } from './ApiExtractorCommandLine';
 import { ExtractorConfig, type IExtractorConfigPrepareOptions } from '../api/ExtractorConfig';
 
@@ -144,9 +142,9 @@ export class RunAction extends CommandLineAction {
       process.exitCode = 1;
 
       if (extractorResult.errorCount > 0) {
-        console.log(os.EOL + colors.red('API Extractor completed with errors'));
+        console.log(os.EOL + Colorize.red('API Extractor completed with errors'));
       } else {
-        console.log(os.EOL + colors.yellow('API Extractor completed with warnings'));
+        console.log(os.EOL + Colorize.yellow('API Extractor completed with warnings'));
       }
     }
   }