Initial work on TypeScript compiler in rush-stack-compiler.

Author: iclanton

libraries/node-core-library/package.json

@@ -20,7 +20,8 @@
     "@types/z-schema": "3.16.31",
     "fs-extra": "~5.0.0",
     "jju": "~1.3.0",
-    "z-schema": "~3.18.3"
+    "z-schema": "~3.18.3",
+    "colors": "~1.2.1"
   },
   "devDependencies": {
     "tslint-microsoft-contrib": "~5.2.1",

libraries/node-core-library/src/Terminal/ConsoleTerminalProvider.ts

@@ -0,0 +1,32 @@
+import * as x from 'colors';
+import { ITerminalProvider, Severity } from "./ITerminalProvider";
+
+export class ConsoleTerminalProvider implements ITerminalProvider {
+  public write(data: string, severity: Severity) {
+    switch (severity) {
+      case Severity.error: {
+        console.error(data);
+        break;
+      }
+
+      case Severity.warn: {
+        console.warn(data);
+        break;
+      }
+
+      case Severity.log:
+      default: {
+        console.log(data);
+        break;
+      }
+    }
+  }
+
+  public get width(): number {
+    return 0;
+  }
+
+  public get supportsColor(): boolean {
+    x.
+  }
+}

libraries/node-core-library/src/Terminal/ITerminalProvider.ts

@@ -0,0 +1,11 @@
+export enum Severity {
+  log,
+  warn,
+  error
+}
+
+export interface ITerminalProvider {
+  write(data: string, severity: Severity);
+  supportsColor: boolean;
+  width: number;
+}

libraries/node-core-library/src/Terminal/Terminal.ts

@@ -0,0 +1,14 @@
+import { ITerminalProvider } from "./ITerminalProvider";
+
+export class Terminal {
+  private _provider;
+
+  public constructor(provider: ITerminalProvider) {
+    this._provider = provider;
+  }
+
+  public write(message: string) {}
+  public writeWarning(message: string) {}
+  public writeError(message: string) {}
+  public writeVerbose(message: string) {}
+}

stack/rush-stack-compiler/src/BaseCmdTask.ts

@@ -0,0 +1,177 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+
+import * as childProcess from 'child_process';
+import * as path from 'path';
+import * as os from 'os';
+
+import {
+  JsonFile,
+  IPackageJson,
+  FileSystem,
+  PackageJsonLookup
+} from '@microsoft/node-core-library';
+import { Constants } from './Constants';
+
+export interface IBaseCmdTaskConfig {
+  /**
+   * Optional list of custom args to pass to the tool
+   */
+  customArgs?: string[];
+
+  /**
+   * The path to the package if the task should override the version of the package.
+   */
+  overridePackagePath?: string;
+
+  /**
+   * The directory in which the tool should be invoked.
+   */
+  buildDirectory?: string;
+}
+
+/**
+ * Options for a CmdTask.
+ * @public
+ */
+export interface IBaseTaskOptions<TTaskConfig> {
+  /**
+   * The initial config of the task.
+   */
+  initialTaskConfig?: TTaskConfig;
+
+  /**
+   * The name of the package to resolve.
+   */
+  packageName: string;
+
+  /**
+   * The path to the binary to invoke inside the package.
+   */
+  packageBinPath: string;
+}
+
+/**
+ * This base task provides support for finding and then executing a binary in a node package.
+ *
+ * @alpha
+ */
+export abstract class BaseCmdTask<TTaskConfig extends IBaseCmdTaskConfig> {
+  private static __nodePath: string | undefined; // tslint:disable-line:variable-name
+  private static get _nodePath(): string | undefined {
+    if (!BaseCmdTask.__nodePath) {
+      try {
+        if (os.platform() === 'win32') {
+          // We're on Windows
+          const whereOutput: string = childProcess.execSync('where node', { stdio: [] }).toString();
+          const lines: string[] = whereOutput.split(os.EOL).filter((line) => !!line);
+
+          // take the first result, see https://github.com/Microsoft/web-build-tools/issues/759
+          BaseCmdTask.__nodePath = lines[0];
+        } else {
+          // We aren't on Windows - assume we're on *NIX or Darwin
+          BaseCmdTask.__nodePath = childProcess.execSync('which node', { stdio: [] }).toString();
+        }
+      } catch (e) {
+        return undefined;
+      }
+
+      BaseCmdTask.__nodePath = BaseCmdTask.__nodePath.trim();
+      if (!FileSystem.exists(BaseCmdTask.__nodePath)) {
+        return undefined;
+      }
+    }
+
+    return BaseCmdTask.__nodePath;
+  }
+
+  protected _constants: Constants;
+
+  private _packageName: string;
+  private _packageBinPath: string;
+  private _errorHasBeenLogged: boolean;
+
+  public static getPackagePath(packageName: string): string | undefined {
+    const packageJsonPath: string | undefined = BaseCmdTask._getPackageJsonPath(packageName);
+    return packageJsonPath ? path.dirname(packageJsonPath) : undefined;
+  }
+
+  private static _getPackageJsonPath(packageName: string): string | undefined {
+    const lookup: PackageJsonLookup = new PackageJsonLookup();
+    const mainEntryPath: string = require.resolve(packageName);
+    return lookup.tryGetPackageJsonFilePathFor(mainEntryPath);
+  }
+
+  constructor(constants: Constants, packageName: string, packageBinPath: string) {
+    this._constants = constants;
+  }
+
+  protected invokeCmd(): Promise<void> {
+    let packageJsonPath: string | undefined = BaseCmdTask._getPackageJsonPath(this._packageName);
+
+    if (!packageJsonPath) {
+      return Promise.reject(new Error(`Unable to find the package.json file for ${this._packageName}.`));
+    }
+
+    const binaryPackagePath: string = path.dirname(packageJsonPath);
+
+    // Print the version
+    const packageJson: IPackageJson = JsonFile.load(packageJsonPath);
+    console.log(`${this._packageName} version: ${packageJson.version}`);
+
+    const binaryPath: string = path.resolve(binaryPackagePath, this._packageBinPath);
+    if (!FileSystem.exists(binaryPath)) {
+      return Promise.reject(new Error(
+        `The binary is missing. This indicates that ${this._packageName} is not ` +
+        'installed correctly.'
+      ));
+    }
+
+    return new Promise((resolve: () => void, reject: (error: Error) => void) => {
+      const nodePath: string | undefined = BaseCmdTask._nodePath;
+      if (!nodePath) {
+        reject(new Error('Unable to find node executable'));
+        return;
+      }
+
+      // Invoke the tool and watch for log messages
+      const spawnResult: childProcess.ChildProcess = childProcess.spawn(
+        nodePath,
+        [binaryPath, ...this._getArgs()],
+        {
+          cwd: this._constants.projectFolderPath,
+          env: process.env,
+          stdio: 'pipe'
+        }
+      );
+
+      spawnResult.stdout.on('data', this._onData.bind(this));
+      spawnResult.stderr.on('data', (data: Buffer) => {
+        this._errorHasBeenLogged = true;
+        this._onError(data);
+      });
+
+      spawnResult.on('close', (code) => this._onClose(code, this._errorHasBeenLogged, resolve, reject));
+    });
+  }
+
+  protected _onData(data: Buffer): void {
+    console.log(data.toString().trim());
+  }
+
+  protected _onError(data: Buffer): void {
+    console.error(data.toString().trim());
+  }
+
+  protected _onClose(code: number, hasErrors: boolean, resolve: () => void, reject: (error: Error) => void): void {
+    if (code !== 0 || hasErrors) {
+      reject(new Error(`exited with code ${code}`));
+    } else {
+      resolve();
+    }
+  }
+
+  protected _getArgs(): string[] {
+    return [];
+  }
+}

stack/rush-stack-compiler/src/Constants.ts

@@ -0,0 +1,47 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+
+import * as path from 'path';
+
+const SRC_FOLDER_NAME: string = 'src';
+const LIB_FOLDER_NAME: string = 'lib';
+const DIST_FOLDER_NAME: string = 'dist';
+
+export class Constants {
+  private _projectFolderPath: string;
+  private _srcFolderPath: string;
+  private _libFolderPath: string;
+  private _distFolderPath: string;
+
+  public constructor(projectFolderPath: string) {
+    this._projectFolderPath = projectFolderPath;
+  }
+
+  public get projectFolderPath(): string {
+    return this._projectFolderPath;
+  }
+
+  public get srcFolderPath(): string {
+    if (!this._srcFolderPath) {
+      this._srcFolderPath = path.join(this._projectFolderPath, SRC_FOLDER_NAME);
+    }
+
+    return this._srcFolderPath;
+  }
+
+  public get libFolderPath(): string {
+    if (!this._libFolderPath) {
+      this._libFolderPath = path.join(this._projectFolderPath, LIB_FOLDER_NAME);
+    }
+
+    return this._libFolderPath;
+  }
+
+  public get distFolderPath(): string {
+    if (!this._distFolderPath) {
+      this._distFolderPath = path.join(this._projectFolderPath, DIST_FOLDER_NAME);
+    }
+
+    return this._distFolderPath;
+  }
+}

stack/rush-stack-compiler/src/TscCmdTask.ts

@@ -0,0 +1,63 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+
+import * as path from 'path';
+import {
+  JsonFile,
+  FileSystem,
+  LegacyAdapters
+} from '@microsoft/node-core-library';
+import * as glob from 'glob';
+import * as globEscape from 'glob-escape';
+import * as typescript from 'typescript';
+import * as decomment from 'decomment';
+
+import {
+  BaseCmdTask,
+  IBaseCmdTaskConfig
+} from './BaseCmdTask';
+import { TsParseConfigHost } from './TsParseConfigHost';
+import { Constants } from './Constants';
+
+/**
+ * @public
+ */
+export interface ITscCmdTaskConfig extends IBaseCmdTaskConfig {
+}
+
+/**
+ * @alpha
+ */
+export class TscCmdTask extends BaseCmdTask<ITscCmdTaskConfig> {
+  constructor(constants: Constants) {
+    super(
+      constants,
+      'typescript',
+      path.join('bin', 'tsc')
+    );
+  }
+
+  public loadSchema(): Object {
+    return JsonFile.load(path.resolve(__dirname, 'schemas', 'tsc-cmd.schema.json'));
+  }
+
+  public invoke(): Promise<void> {
+    return super.invokeCmd();
+  }
+
+  protected _onData(data: Buffer): void {
+    // Log lines separately
+    const dataLines: (string | undefined)[] = data.toString().split('\n');
+    for (const dataLine of dataLines) {
+      const trimmedLine: string = (dataLine || '').trim();
+      if (!!trimmedLine) {
+        if (trimmedLine.match(/\serror\s/i)) {
+          // If the line looks like an error, log it as an error
+          console.error(trimmedLine);
+        } else {
+          console.log(trimmedLine);
+        }
+      }
+    }
+  }
+}

stack/rush-stack-compiler/src/index.ts

@@ -0,0 +1,24 @@
+{
+  "extends": "./includes/tsconfig-node.json",
+
+  "compilerOptions": {
+    "outDir": "lib",
+
+    "forceConsistentCasingInFileNames": true,
+    "jsx": "react",
+    "declaration": true,
+    "sourceMap": true,
+    "inlineSources": true,
+    "experimentalDecorators": true,
+    "strictNullChecks": true,
+    "types": []
+  },
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.tsx"
+  ],
+  "exclude": [
+    "node_modules",
+    "lib"
+  ]
+}

stack/rush-stack-compiler/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "./includes/tslint.json"
+}