Introduce test projects for TSv2, TSv3, and TSv4.

Author: iclanton

build-tests/heft-typescript-v2-test/.gitignore

@@ -0,0 +1 @@
+lib-*

build-tests/heft-typescript-v2-test/config/api-extractor.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+
+  "mainEntryPointFilePath": "<projectFolder>/lib/index.d.ts",
+  "apiReport": {
+    "enabled": true,
+    "reportFolder": "<projectFolder>/etc"
+  },
+  "docModel": {
+    "enabled": true
+  },
+  "dtsRollup": {
+    "enabled": true,
+    "alphaTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-alpha.d.ts",
+    "betaTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>.d.ts"
+  }
+}

build-tests/heft-typescript-v2-test/config/heft.json

@@ -0,0 +1,58 @@
+/**
+ * Defines configuration used by core Heft.
+ */
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/heft/heft.schema.json",
+
+  "eventActions": [
+    {
+      /**
+       * The kind of built-in operation that should be performed.
+       * The "deleteGlobs" action deletes files or folders that match the
+       * specified glob patterns.
+       */
+      "actionKind": "deleteGlobs",
+
+      /**
+       * The stage of the Heft run during which this action should occur. Note that actions specified in heft.json
+       * occur at the end of the stage of the Heft run.
+       */
+      "heftEvent": "clean",
+
+      /**
+       * A user-defined tag whose purpose is to allow configs to replace/delete handlers that were added by other
+       * configs.
+       */
+      "actionId": "defaultClean",
+
+      /**
+       * Glob patterns to be deleted. The paths are resolved relative to the project folder.
+       */
+      "globsToDelete": ["dist", "lib", "lib-esnext", "lib-umd", "temp"]
+    }
+  ],
+
+  /**
+   * The list of Heft plugins to be loaded.
+   */
+  "heftPlugins": [
+    // {
+    //  /**
+    //   * The path to the plugin package.
+    //   */
+    //  "plugin": "path/to/my-plugin",
+    //
+    //  /**
+    //   * An optional object that provides additional settings that may be defined by the plugin.
+    //   */
+    //  // "options": { }
+    // }
+
+    {
+      /**
+       * The path to the plugin package.
+       */
+      "plugin": "@rushstack/heft-jest-plugin"
+    }
+  ]
+}

build-tests/heft-typescript-v2-test/config/jest.config.json

@@ -0,0 +1,3 @@
+{
+  "extends": "@rushstack/heft-jest-plugin/includes/jest-shared.config.json"
+}

build-tests/heft-typescript-v2-test/config/rush-project.json

@@ -0,0 +1,8 @@
+{
+  "operationSettings": [
+    {
+      "operationName": "build",
+      "outputFolderNames": ["dist", "lib", "lib-esnext", "lib-umd"]
+    }
+  ]
+}

build-tests/heft-typescript-v2-test/config/typescript.json

@@ -0,0 +1,32 @@
+/**
+ * Configures the TypeScript plugin for Heft.  This plugin also manages linting.
+ */
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/heft/typescript.schema.json",
+
+  /**
+   * If provided, emit these module kinds in addition to the modules specified in the tsconfig.
+   * Note that this option only applies to the main tsconfig.json configuration.
+   */
+  "additionalModuleKindsToEmit": [
+    {
+      "moduleKind": "esnext",
+      "outFolderName": "lib-esnext"
+    },
+    {
+      "moduleKind": "umd",
+      "outFolderName": "lib-umd"
+    }
+  ]
+
+  /**
+   * If set to "true", the TSlint task will not be invoked.
+   */
+  // "disableTslint": true,
+
+  /**
+   * Set this to change the maximum number of file handles that will be opened concurrently for writing.
+   * The default is 50.
+   */
+  // "maxWriteParallelism": 50
+}

build-tests/heft-typescript-v2-test/etc/heft-typescript-v2-test.api.md

@@ -0,0 +1,13 @@
+## API Report File for "heft-typescript-v2-test"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+// @public (undocumented)
+export class TestClass {
+}
+
+// (No @packageDocumentation comment for this package)
+
+```

build-tests/heft-typescript-v2-test/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "heft-typescript-v2-test",
+  "description": "Building this project tests building with TypeScript v2",
+  "version": "1.0.0",
+  "private": true,
+  "main": "lib/index.js",
+  "license": "MIT",
+  "scripts": {
+    "build": "heft build --clean",
+    "_phase:build": "heft build --clean",
+    "_phase:test": "heft test --no-build"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "workspace:*",
+    "@rushstack/heft": "workspace:*",
+    "@rushstack/heft-jest-plugin": "workspace:*",
+    "@types/jest": "ts2.9",
+    "@types/node": "ts2.9",
+    "tslint": "~5.20.1",
+    "tslint-microsoft-contrib": "~6.2.0",
+    "typescript": "~2.9.2"
+  }
+}

build-tests/heft-typescript-v2-test/src/index.ts

@@ -0,0 +1,7 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+
+/**
+ * @public
+ */
+export class TestClass {} // tslint:disable-line:export-name

build-tests/heft-typescript-v2-test/src/test/ExampleTest.test.ts

@@ -0,0 +1,23 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+
+interface IInterface {
+  element: string;
+}
+
+describe('Example Test', () => {
+  it('Correctly tests stuff', () => {
+    expect(true).toBeTruthy();
+  });
+
+  it('Correctly handles snapshots', () => {
+    expect({ a: 1, b: 2, c: 3 }).toMatchSnapshot();
+  });
+
+  it('Correctly handles TypeScript constructs', () => {
+    const interfaceInstance: IInterface = {
+      element: 'a'
+    };
+    expect(interfaceInstance).toBeTruthy();
+  });
+});