feat: rename existing aliased labels (#497)

## PR Checklist

- [x] Addresses an existing open issue: fixes #455
- [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

Adds an `getExistingEquivalentLabel` function to check for common label
aliases.

See the default labels here:
https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels

Author: JoshuaKGoldberg

src/setup/setupWithInformation.ts

@@ -8,8 +8,8 @@ import { InputValuesAndOctokit } from "../shared/inputs.js";
 import { addOwnerAsAllContributor } from "./settings/addOwnerAsAllContributor.js";
 import { clearChangelog } from "./steps/clearChangelog.js";
 import { hydrateBranchProtectionSettings } from "./steps/hydrateBranchProtectionSettings.js";
-import { hydrateRepositoryLabels } from "./steps/hydrateRepositoryLabels.js";
 import { hydrateRepositorySettings } from "./steps/hydrateRepositorySettings.js";
+import { hydrateRepositoryLabels } from "./steps/labels/hydrateRepositoryLabels.js";
 import { removeSetupScripts } from "./steps/removeSetupScripts.js";
 import { resetGitTags } from "./steps/resetGitTags.js";
 import { uninstallPackages } from "./steps/uninstallPackages.js";

src/setup/steps/labels/getExistingEquivalentLabel.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it } from "vitest";
+
+import { getExistingEquivalentLabel } from "./getExistingEquivalentLabel.js";
+
+describe("getExistingEquivalentLabel", () => {
+	it("returns undefined when there are no existing labels", () => {
+		const actual = getExistingEquivalentLabel([], "abc");
+
+		expect(actual).toBe(undefined);
+	});
+
+	it("returns undefined when no existing label matches", () => {
+		const actual = getExistingEquivalentLabel(["abc"], "def");
+
+		expect(actual).toBe(undefined);
+	});
+
+	it("returns the existing label when it matches by name", () => {
+		const actual = getExistingEquivalentLabel(["def", "abc", "ghi"], "abc");
+
+		expect(actual).toBe("abc");
+	});
+
+	it("returns the existing label when it matches excluding prefix", () => {
+		const actual = getExistingEquivalentLabel(
+			["abc: def", "abc", "ghi"],
+			"type: abc"
+		);
+
+		expect(actual).toBe("abc");
+	});
+
+	it("returns the existing label when it matches an alias", () => {
+		const actual = getExistingEquivalentLabel(
+			["abc: def", "enhancement", "ghi"],
+			"type: feature"
+		);
+
+		expect(actual).toBe("enhancement");
+	});
+});

src/setup/steps/labels/getExistingEquivalentLabel.ts

@@ -0,0 +1,16 @@
+const aliases = new Map([
+	["enhancement", "type: feature"],
+	["help wanted", "status: accepting prs"],
+]);
+
+export function getExistingEquivalentLabel(
+	existingLabels: string[],
+	outcomeLabel: string
+) {
+	const outcomeTrimmed = outcomeLabel.replace(/\w+: (\w+)/, "$1");
+
+	return existingLabels.find(
+		(existingLabel) =>
+			aliases.has(existingLabel) || existingLabel === outcomeTrimmed
+	);
+}

src/setup/steps/hydrateRepositoryLabels.ts renamed to src/setup/steps/labels/hydrateRepositoryLabels.ts

@@ -1,6 +1,7 @@
 import { $ } from "execa";
 
-import { readFileAsJSON } from "../readFileAsJSON.js";
+import { readFileAsJSON } from "../../readFileAsJSON.js";
+import { getExistingEquivalentLabel } from "./getExistingEquivalentLabel.js";
 
 interface GhLabelData {
 	name: string;
@@ -26,10 +27,15 @@ export async function hydrateRepositoryLabels() {
 	)) as FileLabelData[];
 
 	for (const outcome of outcomeLabels) {
-		const action = existingLabels.some((existing) => existing === outcome.name)
-			? "edit"
-			: "create";
-		await $`gh label ${action} ${outcome.name} --color ${outcome.color} --description ${outcome.description}`;
+		const existingEquivalent = getExistingEquivalentLabel(
+			existingLabels,
+			outcome.name
+		);
+		const [action, label] = existingEquivalent
+			? ["edit", existingEquivalent]
+			: ["create", outcome.name];
+
+		await $`gh label ${action} ${label} --color ${outcome.color} --description ${outcome.description}`;
 	}
 
 	const allowedLabels = new Set(outcomeLabels.map(getLabelName));