fix: normalize yaml outputs to always use -1 lineWidth (#2098)

## PR Checklist

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

Whatever reason I had for having two different calls to `jsYaml.dump`
is, I think, no longer there. This normalizes all YAML printing to go
through the standard `formatYaml`. YAML files now always have a blank
line between root-level properties.

🎁

Author: JoshuaKGoldberg

.github/ISSUE_TEMPLATE/01-bug.yml

@@ -26,8 +26,12 @@ body:
       description: Any additional info you'd like to provide.
       label: Additional Info
     type: textarea
+
 description: Report a bug trying to run the code
+
 labels:
   - "type: bug"
+
 name: 🐛 Bug
+
 title: "🐛 Bug: <short description of the bug>"

.github/ISSUE_TEMPLATE/02-documentation.yml

@@ -18,8 +18,12 @@ body:
       description: Any additional info you'd like to provide.
       label: Additional Info
     type: textarea
+
 description: Report a typo or missing area of documentation
+
 labels:
   - "area: documentation"
+
 name: 📝 Documentation
+
 title: "📝 Documentation: <short description of the request>"

.github/ISSUE_TEMPLATE/03-feature.yml

@@ -18,8 +18,12 @@ body:
       description: Any additional info you'd like to provide.
       label: Additional Info
     type: textarea
+
 description: Request that a new feature be added or an existing feature improved
+
 labels:
   - "type: feature"
+
 name: 🚀 Feature
+
 title: "🚀 Feature: <short description of the feature>"

.github/ISSUE_TEMPLATE/04-tooling.yml

@@ -20,8 +20,12 @@ body:
       description: Any additional info you'd like to provide.
       label: Additional Info
     type: textarea
+
 description: Report a bug or request an enhancement in repository tooling
+
 labels:
   - "area: tooling"
+
 name: 🛠 Tooling
+
 title: "🛠 Tooling: <short description of the change>"

src/blocks/blockAllContributors.test.ts

@@ -68,8 +68,10 @@ describe("blockAllContributors", () => {
 			          GITHUB_TOKEN: \${{ secrets.ACCESS_TOKEN }}
 			        uses: JoshuaKGoldberg/[email protected]
 
+
 			name: Contributors
 
+
 			on:
 			  push:
 			    branches:
@@ -187,8 +189,10 @@ describe("blockAllContributors", () => {
 			          GITHUB_TOKEN: \${{ secrets.ACCESS_TOKEN }}
 			        uses: JoshuaKGoldberg/[email protected]
 
+
 			name: Contributors
 
+
 			on:
 			  push:
 			    branches:
@@ -305,8 +309,10 @@ describe("blockAllContributors", () => {
 			          GITHUB_TOKEN: \${{ secrets.ACCESS_TOKEN }}
 			        uses: JoshuaKGoldberg/[email protected]
 
+
 			name: Contributors
 
+
 			on:
 			  push:
 			    branches:

src/blocks/blockCTATransitions.test.ts

@@ -50,21 +50,15 @@ describe("blockCTATransitions", () => {
 			      uses: mshick/add-pr-comment@v2
 			      with:
 			        issue: \${{ github.event.pull_request.number }}
-			        message: >-
-			          🤖 Beep boop! I ran \`npx create-typescript-app\` and it updated some
-			          files.
+			        message: |-
+			          🤖 Beep boop! I ran \`npx create-typescript-app\` and it updated some files.
 
-			          I went ahead and checked those changes into this PR for you. Please
-			          review the latest commit to see if you want to merge it.
+			          I went ahead and checked those changes into this PR for you. Please review the latest commit to see if you want to merge it.
 
 			          Cheers!
 			           — _The Friendly Bingo Bot_ 💝
 
-			          > ℹ️ These automatic commits keep your repository up-to-date with new
-			          versions of
-			          [create-typescript-app](https://github.com/JoshuaKGoldberg/create-typescript-app).
-			          If you want to opt out, delete your
-			          \`.github/workflows/cta-transitions.yml\` file.
+			          > ℹ️ These automatic commits keep your repository up-to-date with new versions of [create-typescript-app](https://github.com/JoshuaKGoldberg/create-typescript-app). If you want to opt out, delete your \`.github/workflows/cta-transitions.yml\` file.
 			  using: composite
 			",
 			      },
@@ -87,13 +81,16 @@ describe("blockCTATransitions", () => {
 			      - if: steps.check.outcome == 'skipped'
 			        run: echo 'Skipping transition mode because the PR does not appear to be an automated or owner-created update to create-typescript-app.'
 
+
 			name: CTA
 
+
 			on:
 			  pull_request:
 			    branches:
 			      - main
 
+
 			permissions:
 			  pull-requests: write
 			",

src/blocks/blockCTATransitions.ts

@@ -4,7 +4,7 @@ import { resolveUses } from "./actions/resolveUses.js";
 import { blockPackageJson } from "./blockPackageJson.js";
 import { blockRepositoryBranchRuleset } from "./blockRepositoryBranchRuleset.js";
 import { createSoloWorkflowFile } from "./files/createSoloWorkflowFile.js";
-import { formatYamlAction } from "./files/formatYamlAction.js";
+import { formatYaml } from "./files/formatYaml.js";
 
 export const blockCTATransitions = base.createBlock({
 	about: {
@@ -28,7 +28,7 @@ export const blockCTATransitions = base.createBlock({
 				".github": {
 					actions: {
 						transition: {
-							"action.yml": formatYamlAction({
+							"action.yml": formatYaml({
 								description: "Runs create-typescript-app in transition mode",
 								name: "Transition",
 								runs: {
@@ -65,7 +65,9 @@ export const blockCTATransitions = base.createBlock({
 												issue: "${{ github.event.pull_request.number }}",
 												message: [
 													"🤖 Beep boop! I ran `npx create-typescript-app` and it updated some files.",
+													"",
 													"I went ahead and checked those changes into this PR for you. Please review the latest commit to see if you want to merge it.",
+													"",
 													"Cheers!",
 													" — _The Friendly Bingo Bot_ 💝",
 													"",

src/blocks/blockGitHubActionsCI.test.ts

@@ -49,8 +49,10 @@ describe("blockGitHubActionsCI", () => {
 			    steps:
 			      - uses: github/[email protected]
 
+
 			name: Accessibility Alt Text Bot
 
+
 			on:
 			  issue_comment:
 			    types:
@@ -65,6 +67,7 @@ describe("blockGitHubActionsCI", () => {
 			      - edited
 			      - opened
 
+
 			permissions:
 			  issues: write
 			  pull-requests: write
@@ -82,13 +85,16 @@ describe("blockGitHubActionsCI", () => {
 			          echo "Don't worry if the previous step failed."
 			          echo "See https://github.com/actions-ecosystem/action-remove-labels/issues/221."
 
+
 			name: PR Review Requested
 
+
 			on:
 			  pull_request_target:
 			    types:
 			      - review_requested
 
+
 			permissions:
 			  pull-requests: write
 			",
@@ -153,8 +159,10 @@ describe("blockGitHubActionsCI", () => {
 			    steps:
 			      - uses: github/[email protected]
 
+
 			name: Accessibility Alt Text Bot
 
+
 			on:
 			  issue_comment:
 			    types:
@@ -169,6 +177,7 @@ describe("blockGitHubActionsCI", () => {
 			      - edited
 			      - opened
 
+
 			permissions:
 			  issues: write
 			  pull-requests: write
@@ -186,13 +195,16 @@ describe("blockGitHubActionsCI", () => {
 			          echo "Don't worry if the previous step failed."
 			          echo "See https://github.com/actions-ecosystem/action-remove-labels/issues/221."
 
+
 			name: PR Review Requested
 
+
 			on:
 			  pull_request_target:
 			    types:
 			      - review_requested
 
+
 			permissions:
 			  pull-requests: write
 			",
@@ -264,8 +276,10 @@ describe("blockGitHubActionsCI", () => {
 			    steps:
 			      - uses: github/[email protected]
 
+
 			name: Accessibility Alt Text Bot
 
+
 			on:
 			  issue_comment:
 			    types:
@@ -280,6 +294,7 @@ describe("blockGitHubActionsCI", () => {
 			      - edited
 			      - opened
 
+
 			permissions:
 			  issues: write
 			  pull-requests: write
@@ -298,8 +313,10 @@ describe("blockGitHubActionsCI", () => {
 			        with:
 			          VAR_WITH: 'true'
 
+
 			name: CI
 
+
 			on:
 			  pull_request: ~
 			  push:
@@ -318,13 +335,16 @@ describe("blockGitHubActionsCI", () => {
 			          echo "Don't worry if the previous step failed."
 			          echo "See https://github.com/actions-ecosystem/action-remove-labels/issues/221."
 
+
 			name: PR Review Requested
 
+
 			on:
 			  pull_request_target:
 			    types:
 			      - review_requested
 
+
 			permissions:
 			  pull-requests: write
 			",

src/blocks/blockGitHubActionsCI.ts

@@ -6,7 +6,7 @@ import { blockRemoveFiles } from "./blockRemoveFiles.js";
 import { blockRepositoryBranchRuleset } from "./blockRepositoryBranchRuleset.js";
 import { createMultiWorkflowFile } from "./files/createMultiWorkflowFile.js";
 import { createSoloWorkflowFile } from "./files/createSoloWorkflowFile.js";
-import { formatYamlAction } from "./files/formatYamlAction.js";
+import { formatYaml } from "./files/formatYaml.js";
 
 export const zActionStep = z.intersection(
 	z.object({
@@ -46,7 +46,7 @@ export const blockGitHubActionsCI = base.createBlock({
 				".github": {
 					actions: {
 						prepare: {
-							"action.yml": formatYamlAction({
+							"action.yml": formatYaml({
 								description: "Prepares the repo for a typical CI job",
 								name: "Prepare",
 								runs: {

src/blocks/blockReleaseIt.test.ts

@@ -88,20 +88,24 @@ describe("blockReleaseIt", () => {
 
 			              Cheers! 📦🚀
 
+
 			name: Post Release
 
+
 			on:
 			  release:
 			    types:
 			      - published
 
+
 			permissions:
 			  issues: write
 			  pull-requests: write
 			",
 			        "release.yml": "concurrency:
 			  group: \${{ github.workflow }}
 
+
 			jobs:
 			  release:
 			    runs-on: ubuntu-latest
@@ -117,13 +121,16 @@ describe("blockReleaseIt", () => {
 			          NPM_TOKEN: \${{ secrets.NPM_TOKEN }}
 			        uses: JoshuaKGoldberg/[email protected]
 
+
 			name: Release
 
+
 			on:
 			  push:
 			    branches:
 			      - main
 
+
 			permissions:
 			  contents: write
 			  id-token: write
@@ -237,20 +244,24 @@ describe("blockReleaseIt", () => {
 
 			              Cheers! 📦🚀
 
+
 			name: Post Release
 
+
 			on:
 			  release:
 			    types:
 			      - published
 
+
 			permissions:
 			  issues: write
 			  pull-requests: write
 			",
 			        "release.yml": "concurrency:
 			  group: \${{ github.workflow }}
 
+
 			jobs:
 			  release:
 			    runs-on: ubuntu-latest
@@ -269,13 +280,16 @@ describe("blockReleaseIt", () => {
 			          NPM_TOKEN: \${{ secrets.NPM_TOKEN }}
 			        uses: JoshuaKGoldberg/[email protected]
 
+
 			name: Release
 
+
 			on:
 			  push:
 			    branches:
 			      - main
 
+
 			permissions:
 			  contents: write
 			  id-token: write

src/blocks/files/formatYaml.ts

@@ -23,5 +23,8 @@ const options: jsYaml.DumpOptions = {
 };
 
 export function formatYaml(value: unknown) {
-	return removeUsesQuotes(jsYaml.dump(value, options));
+	return removeUsesQuotes(jsYaml.dump(value, options)).replaceAll(
+		/\n(\S)/g,
+		"\n\n$1",
+	);
 }