feat: switch bin to Bingo's runTemplateCLI (#1943)

JoshuaKGoldberg · web-flow · commit 64e33ca014d3 · 2025-02-20T15:52:27.000-05:00
## PR Checklist - [x] Addresses an existing open issue: fixes #1941 - [x] That issue was marked as [`status: accepting prs`](https://github.com/JoshuaKGoldberg/create-typescript-app/issues?q=is%3Aopen+is%3Aissue+label%3A%22status%3A+accepting+prs%22) - [x] Steps in [CONTRIBUTING.md](https://github.com/JoshuaKGoldberg/create-typescript-app/blob/main/.github/CONTRIBUTING.md) were taken ## Overview Corresponding PR to JoshuaKGoldberg/bingo#214. 🎁
diff --git a/README.md b/README.md
@@ -38,11 +38,9 @@ First make sure you have the following installed:
 Then in an existing repository or in your directory where you'd like to make a new repository:
 
 ```shell
-npx bingo typescript-app@beta
+npx create-typescript-app@beta
 ```
 
-That will launch `create-typescript-app` using the [`bingo` runner](https://create.bingo).
-
 You can read more about the supported setup modes in their docs pages:
 
 - [**Creating from the terminal**](./docs/Creation.md): creating a new repository locally on the command-line _(recommended)_
diff --git a/bin/index.js b/bin/index.js
@@ -1,16 +1,6 @@
 #!/usr/bin/env node
-import chalk from "chalk";
+import { runTemplateCLI } from "bingo";
 
-console.log(
-	[
-		"create-typescript-app is now run using ",
-		chalk.bold("bingo"),
-		".\n\nRun:\n  ",
-		chalk.bold("npx bingo", process.argv.slice(2).join(" ")),
-		"\n\nYou can read more on:\n  https://",
-		chalk.bold("create.bingo"),
-		"\n\nThanks for using create-typescript-app! 🎁",
-	].join(""),
-);
+import { template } from "../lib/index.js";
 
-process.exitCode = 1;
+process.exitCode = await runTemplateCLI(template);
diff --git a/docs/Creation.md b/docs/Creation.md
@@ -1,9 +1,9 @@
 # Creating from the Terminal
 
-You can run `npx bingo typescript-app@beta` in your terminal to interactively create a new repository:
+You can run `npx create-typescript-app@beta` in your terminal to interactively create a new repository:
 
 ```shell
-npx bingo typescript-app@beta
+npx create-typescript-app@beta
 ```
 
 The creation script will by default:
@@ -34,7 +34,7 @@ See [Options.md](./Options.md).
 For example, skipping the _"This package was templated with..."_ block:
 
 ```shell
-npx bingo typescript-app@beta --mode create --exclude-templated-with
+npx create-typescript-app@beta --mode create --exclude-templated-with
 ```
 
 See [Blocks.md](./Blocks.md) for details on the tooling pieces and which presets they're included in.
diff --git a/docs/FAQs.md b/docs/FAQs.md
@@ -173,18 +173,6 @@ Each of the included tools exists for a good reason and provides real value.
 
 If you don't want to use any particular tool, you can always remove it manually.
 
-### What tooling does this package use that isn't part of created repositories?
-
-Glad you asked!
-These are the projects used across many parts of `create-typescript-app`:
-
-- [Chalk](https://github.com/chalk/chalk): Makes it easier to print colored characters in the terminal.
-- [Clack](https://www.clack.cc): Provides interactive terminal prompts and loading spinners.
-- [execa](https://github.com/sindresorhus/execa): Makes it easier to run child processes.
-- [Octokit](https://github.com/octokit/octokit.js#octokitjs):
-- [tsx](https://github.com/esbuild-kit/tsx): Quickly runs TypeScript files with ESBuild.
-- [Zod](https://zod.dev): TypeScript-first schema validation with static type inference.
-
 ## Why tabs?
 
 This repository template configures `"useTabs": true` in the root-level `.prettierrc.json`.
diff --git a/docs/Initialization.md b/docs/Initialization.md
@@ -1,12 +1,12 @@
 # Initializing from the Template
 
-As an alternative to [creating with `npx bingo typescript-app@beta`](./Creation.md), the [_Use this template_](https://github.com/JoshuaKGoldberg/create-typescript-app/generate) button on GitHub can be used to quickly create a new repository from the template.
+As an alternative to [creating with `npx create-typescript-app@beta`](./Creation.md), the [_Use this template_](https://github.com/JoshuaKGoldberg/create-typescript-app/generate) button on GitHub can be used to quickly create a new repository from the template.
 You can set up the new repository locally by cloning it and installing packages:
 
 ```shell
 git clone https://github.com/YourUsername/YourRepositoryName
 cd YourRepositoryName
-npx bingo typescript-app@beta
+npx create-typescript-app@beta
 ```
 
 You'll then need to manually go through the following two steps to set up tooling on GitHub:
@@ -29,7 +29,7 @@ See [Options.md](./Options.md).
 For example, skipping the _"This package was templated with..."_ block:
 
 ```shell
-npx bingo typescript-app@beta --exclude-templated-with
+npx create-typescript-app@beta --exclude-templated-with
 ```
 
 See [Blocks.md](./Blocks.md) for details on the tooling pieces and which presets they're included in.
diff --git a/docs/Migration.md b/docs/Migration.md
@@ -1,9 +1,9 @@
 # Migrating an Existing Repository
 
-If you have an existing repository that you'd like to give the files from this repository, you can run `npx bingo typescript-app@beta` in it to "migrate" its tooling to this template's.
+If you have an existing repository that you'd like to give the files from this repository, you can run `npx create-typescript-app@beta` in it to "migrate" its tooling to this template's.
 
 ```shell
-npx bingo typescript-app@beta
+npx create-typescript-app@beta
 ```
 
 The migration script will:
@@ -46,7 +46,7 @@ See [Options.md](./Options.md).
 For example, skipping the _"This package was templated with..."_ block:
 
 ```shell
-npx bingo typescript-app@beta --exclude-templated-with
+npx create-typescript-app@beta --exclude-templated-with
 ```
 
 See [Blocks.md](./Blocks.md) for details on the tooling pieces and which presets they're included in.
diff --git a/docs/Options.md b/docs/Options.md
@@ -1,17 +1,18 @@
 # Options
 
 `create-typescript-app` is built on top of [Bingo](https://create.bingo).
-`npx bingo typescript-app@beta` supports all the flags defined by the [`bingo` CLI](https://www.create.bingo/cli).
-It provides three Presets:
+It supports all the flags supported by [Bingo CLIs](https://www.create.bingo/cli).
+
+`npx create-typescript-app@beta` provides three `--preset` options:
 
 1. **Minimal**: Just bare starter tooling: building, formatting, linting, and type checking.
 2. **Common**: Bare starters plus testing and automation for all-contributors and releases.
 3. **Everything**: The most comprehensive tooling imaginable: sorting, spellchecking, and more!
 
-For example, to create a new repository on the _everything_ preset:
+For example, to create a new repository with the _Everything_ preset:
 
 ```shell
-npx bingo typescript-app@beta --preset everything
+npx create-typescript-app@beta --preset everything
 ```
 
 `create-typescript-app` itself adds in two sections of flags:
@@ -34,7 +35,7 @@ Each will be prompted for when creating a new repository if not explicitly provi
 For example, pre-populating both required base options:
 
 ```shell
-npx bingo typescript-app@beta --description "My awesome TypeScript app! 💖" --title "My TypeScript App"
+npx create-typescript-app@beta --description "My awesome TypeScript app! 💖" --title "My TypeScript App"
 ```
 
 That script will run completely autonomously, no prompted inputs required. ✨
@@ -56,16 +57,19 @@ They will be inferred from the running user, and if migrating an existing reposi
 For example, customizing the npm author and funding source:
 
 ```shell
-npx bingo typescript-app@beta --author my-npm-username --funding MyGitHubOrganization
+npx create-typescript-app@beta --author my-npm-username --funding MyGitHubOrganization
 ```
 
 ## Block Exclusions
 
+> TODO: This is not implemented yet!
+> <https://github.com/JoshuaKGoldberg/bingo/issues/215>
+
 Per [Bingo > Stratum > Configurations > `blocks`](https://www.create.bingo/engines/stratum/details/configurations#blocks), individual Blocks may be excluded from running.
 For example, initializing with all tooling except for Renovate:
 
 ```shell
-npx bingo typescript-app@beta --exclude-renovate
+npx create-typescript-app@beta --exclude-renovate
 ```
 
 See [Blocks.md](./Blocks.md) for the list of blocks and their corresponding presets.
diff --git a/package.json b/package.json
@@ -37,19 +37,18 @@
 		"*": "prettier --ignore-unknown --write"
 	},
 	"dependencies": {
-		"bingo": "^0.4.1",
-		"bingo-fs": "^0.4.1",
-		"bingo-stratum": "^0.4.1",
-		"chalk": "^5.4.1",
+		"bingo": "^0.5.0",
+		"bingo-fs": "^0.5.0",
+		"bingo-stratum": "^0.5.0",
 		"cspell-populate-words": "^0.3.0",
 		"execa": "^9.5.2",
 		"git-remote-origin-url": "^4.0.0",
 		"git-url-parse": "^16.0.1",
 		"html-to-text": "^9.0.5",
 		"image-size": "^1.2.0",
-		"input-from-file": "^0.4.1",
-		"input-from-file-json": "^0.4.1",
-		"input-from-script": "^0.4.1",
+		"input-from-file": "^0.5.0",
+		"input-from-file-json": "^0.5.0",
+		"input-from-script": "^0.5.0",
 		"js-yaml": "^4.1.0",
 		"lazy-value": "^3.0.0",
 		"lodash": "^4.17.21",
@@ -79,8 +78,8 @@
 		"@vitest/coverage-v8": "3.0.6",
 		"@vitest/eslint-plugin": "1.1.31",
 		"all-contributors-cli": "6.26.1",
-		"bingo-stratum-testers": "0.4.1",
-		"bingo-testers": "0.4.1",
+		"bingo-stratum-testers": "0.5.0",
+		"bingo-testers": "0.5.0",
 		"console-fail-test": "0.5.0",
 		"cspell": "8.17.3",
 		"eslint": "9.20.1",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/src/index.ts b/src/index.ts
diff --git a/src/template.ts b/src/template.ts
