fix: moved hydrate to bin (#553)

## PR Checklist

- [x] Addresses an existing open issue: fixes #552
- [x] That issue was marked as [`status: accepting
prs`](https://github.com/JoshuaKGoldberg/template-typescript-node-package/issues?q=is%3Aopen+is%3Aissue+label%3A%22status%3A+accepting+prs%22)
- [x] Steps in
[CONTRIBUTING.md](https://github.com/JoshuaKGoldberg/template-typescript-node-package/blob/main/.github/CONTRIBUTING.md)
were taken

## Overview

Uses a proper `bin/` file with a `#!` hashbang comment.

Author: JoshuaKGoldberg

.github/workflows/lint-knip.yml

@@ -4,6 +4,7 @@ jobs:
     steps:
       - uses: actions/checkout@v3
       - uses: ./.github/actions/prepare
+      - run: pnpm build || true
       - run: pnpm lint:knip
 
 name: Lint Knip

.github/workflows/lint.yml

@@ -4,6 +4,7 @@ jobs:
     steps:
       - uses: actions/checkout@v3
       - uses: ./.github/actions/prepare
+      - run: pnpm build || true
       - run: pnpm lint
 
 name: Lint

bin/hydrate.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { hydrate } from "../lib/hydrate/index.js";
+
+process.exitCode = await hydrate(process.argv.slice(2));

package.json

@@ -13,8 +13,9 @@
 	},
 	"type": "module",
 	"main": "./lib/index.js",
-	"bin": "./lib/hydrate/index.js",
+	"bin": "./bin/hydrate.js",
 	"files": [
+		"bin/",
 		"lib/",
 		"package.json",
 		"LICENSE.md",

script/hydrate-test-e2e.js

@@ -9,7 +9,7 @@ const title = "Template TypeScript Node Package";
 
 await $({
 	stdio: "inherit",
-})`c8 -o ./coverage-hydrate -r html -r lcov node ./lib/hydrate/index.js  --description ${description} --owner ${owner} --title ${title} --repository ${repository} --skip-api --skip-install --skip-setup`;
+})`c8 -o ./coverage-hydrate -r html -r lcov node ./bin/hydrate.js  --description ${description} --owner ${owner} --title ${title} --repository ${repository} --skip-api --skip-install --skip-setup`;
 
 const { stdout: gitStatus } = await $`git status`;
 console.log(`Stdout from running \`git status\`:\n${gitStatus}`);
@@ -33,6 +33,8 @@ const filesExpectedToBeChanged = new Set([
 	".eslintrc.cjs",
 	".github/DEVELOPMENT.md",
 	".github/workflows/release.yml",
+	".github/workflows/lint.yml",
+	".github/workflows/lint-knip.yml",
 	".github/workflows/test.yml",
 	".gitignore",
 	".prettierignore",

src/hydrate/hydrate.ts

@@ -1,3 +1,75 @@
-import { hydrate } from "./hydrate.js";
+import { parseArgs } from "node:util";
 
-process.exitCode = await hydrate(process.argv.slice(2));
+import { setupWithInformation } from "../setup/setupWithInformation.js";
+import {
+	skipSpinnerBlock,
+	successSpinnerBlock,
+	withSpinner,
+} from "../shared/cli/spinners.js";
+import { runOrRestore } from "../shared/runOrRestore.js";
+import { clearUnnecessaryFiles } from "./steps/clearUnnecessaryFiles.js";
+import { finalizeDependencies as finalizeDependencies } from "./steps/finalizeDependencies.js";
+import { runCommand } from "./steps/runCommand.js";
+import { writeReadme } from "./steps/writeReadme.js";
+import { writeStructure } from "./steps/writing/writeStructure.js";
+import { getHydrationDefaults } from "./values/getHydrationDefaults.js";
+import { augmentWithHydrationValues } from "./values/hydrationInputValues.js";
+
+export async function hydrate(args: string[]) {
+	const { values: hydrationSkips } = parseArgs({
+		args,
+		options: {
+			"skip-install": { type: "boolean" },
+			"skip-setup": { type: "boolean" },
+		},
+		strict: false,
+		tokens: true,
+	});
+
+	return await runOrRestore({
+		args,
+		defaults: await getHydrationDefaults(),
+		label: "hydration",
+		run: async ({ octokit, values }) => {
+			const hydrationValues = await augmentWithHydrationValues(values);
+
+			await withSpinner(clearUnnecessaryFiles, "clearing unnecessary files");
+
+			await withSpinner(
+				() => writeStructure(hydrationValues),
+				"writing new repository structure"
+			);
+
+			await withSpinner(
+				() => writeReadme(hydrationValues),
+				"writing README.md"
+			);
+
+			if (hydrationSkips["skip-install"]) {
+				skipSpinnerBlock(`Skipping package installations.`);
+			} else {
+				await withSpinner(
+					() => finalizeDependencies(hydrationValues),
+					"finalizing dependencies"
+				);
+			}
+
+			await runCommand("pnpm lint --fix", "auto-fixing lint rules");
+			await runCommand("pnpm format --write", "formatting files");
+
+			if (hydrationSkips["skip-setup"]) {
+				skipSpinnerBlock(`Done hydrating, and skipping setup command.`);
+			} else {
+				successSpinnerBlock("Done hydrating. Starting setup command...");
+
+				await setupWithInformation({
+					octokit,
+					values: {
+						...hydrationValues,
+						skipUninstalls: true,
+					},
+				});
+			}
+		},
+	});
+}