feat(CLI): v2

Author: bitjson

.vscode/launch.json

@@ -0,0 +1,65 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Debug CLI",
+      "program": "${workspaceFolder}/src/cli/cli.ts",
+      "outFiles": ["${workspaceFolder}/build/main/**/*.js"],
+      "skipFiles": [
+        "<node_internals>/**/*.js",
+        "${workspaceFolder}/node_modules/**/*.js"
+      ],
+      "preLaunchTask": "npm: build",
+      "stopOnEntry": true,
+      "smartStep": true,
+      "runtimeArgs": ["--nolazy"],
+      "env": {
+        "TYPESCRIPT_STARTER_REPO_URL": "${workspaceFolder}"
+      },
+      "console": "externalTerminal"
+    },
+    {
+      /// Usage: set appropriate breakpoints in a *.spec.ts file, then open the
+      // respective *.spec.js file to run this task. Once a breakpoint is hit,
+      // the debugger will open the source *.spec.ts file for debugging.
+      "type": "node",
+      "request": "launch",
+      "name": "Debug Compiled Test File",
+      "program": "${workspaceFolder}/node_modules/ava/profile.js",
+      "args": [
+        "${file}"
+        // TODO: VSCode's launch.json variable substitution
+        // (https://code.visualstudio.com/docs/editor/variables-reference)
+        // doesn't quite allow us to go from:
+        // `./src/path/to/file.ts` to `./build/main/path/to/file.js`
+        // so the user has to navigate to the compiled file manually. (Close:)
+        // "${workspaceFolder}/build/main/lib/${fileBasenameNoExtension}.js"
+      ],
+      "skipFiles": ["<node_internals>/**/*.js"],
+      // Consider using `npm run watch` or `yarn watch` for faster debugging
+      // "preLaunchTask": "npm: build",
+      // "smartStep": true,
+      "runtimeArgs": ["--nolazy"]
+    }
+    // TODO: Simpler test debugging option. Discussion:
+    // https://github.com/avajs/ava/issues/1505#issuecomment-370654427
+    // {
+    //   "type": "node",
+    //   "request": "launch",
+    //   "name": "Debug Current Test File",
+    //   "program": "${file}",
+    //   "outFiles": ["${workspaceFolder}/build/main/**/*.js"],
+    //   "skipFiles": ["<node_internals>/**/*.js"],
+    //   // Consider using `npm run watch` or `yarn watch` for faster debugging
+    //   // "preLaunchTask": "npm: build",
+    //   // "stopOnEntry": true,
+    //   // "smartStep": true,
+    //   "runtimeArgs": ["--nolazy"],
+    //   "env": {
+    //     "AVA_DEBUG_MODE": "1"
+    //   }
+    // }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "typescript.implementationsCodeLens.enabled": true,
+  "typescript.referencesCodeLens.enabled": true
+}

README-starter.md

@@ -1 +1,3 @@
 # package-name
+
+description

README.md

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+/**
+ * This file needs the 'x' permission to be spawned by tests. Since TypeScript
+ * doesn't currently offer a way to set permissions of generated files
+ * (https://github.com/Microsoft/TypeScript/issues/16667), we track this file
+ * with Git, and simply require the generated CLI.
+ */
+require('../build/main/cli/cli.js');