create-typescript-app 1.75.1 → 1.77.0

package/lib/next/blocks/blockAllContributors.js

@@ -0,0 +1,59 @@
+import { createSoloWorkflowFile } from "../../steps/writing/creation/dotGitHub/createSoloWorkflowFile.js";
+import { base } from "../base.js";
+import { blockPrettier } from "./blockPrettier.js";
+const blockAllContributors = base.createBlock({
+  about: {
+    name: "AllContributors"
+  },
+  produce({ options }) {
+    return {
+      addons: [
+        blockPrettier({
+          ignores: ["/.all-contributorsrc"]
+        })
+      ],
+      commands: options.login === "JoshuaKGoldberg" ? [`npx -y all-contributors-cli add JoshuaKGoldberg tool`] : void 0,
+      files: {
+        ".all-contributorsrc": JSON.stringify({
+          badgeTemplate: '	<a href="#contributors" target="_blank"><img alt="\u{1F46A} All Contributors: <%= contributors.length %>" src="https://img.shields.io/badge/%F0%9F%91%AA_all_contributors-<%= contributors.length %>-21bb42.svg" /></a>',
+          commit: false,
+          commitConvention: "angular",
+          commitType: "docs",
+          contributors: options.contributors ?? [],
+          contributorsPerLine: 7,
+          contributorsSortAlphabetically: true,
+          files: ["README.md"],
+          imageSize: 100,
+          projectName: options.repository,
+          projectOwner: options.owner,
+          repoHost: "https://github.com",
+          repoType: "github"
+        }),
+        ".github": {
+          workflows: {
+            "contributors.yml": createSoloWorkflowFile({
+              name: "Contributors",
+              on: {
+                push: {
+                  branches: ["main"]
+                }
+              },
+              steps: [
+                { uses: "actions/checkout@v4", with: { "fetch-depth": 0 } },
+                { uses: "./.github/actions/prepare" },
+                {
+                  env: { GITHUB_TOKEN: "${{ secrets.ACCESS_TOKEN }}" },
+                  uses: `JoshuaKGoldberg/all-contributors-auto-action@v0.5.0`
+                }
+              ]
+            })
+          }
+        }
+      }
+    };
+  }
+});
+export {
+  blockAllContributors
+};
+//# sourceMappingURL=blockAllContributors.js.map

package/lib/next/blocks/blockAllContributors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/next/blocks/blockAllContributors.ts"],"sourcesContent":["import { createSoloWorkflowFile } from \"../../steps/writing/creation/dotGitHub/createSoloWorkflowFile.js\";\nimport { base } from \"../base.js\";\nimport { blockPrettier } from \"./blockPrettier.js\";\n\nexport const blockAllContributors = base.createBlock({\n\tabout: {\n\t\tname: \"AllContributors\",\n\t},\n\tproduce({ options }) {\n\t\treturn {\n\t\t\taddons: [\n\t\t\t\tblockPrettier({\n\t\t\t\t\tignores: [\"/.all-contributorsrc\"],\n\t\t\t\t}),\n\t\t\t],\n\t\t\tcommands:\n\t\t\t\toptions.login === \"JoshuaKGoldberg\"\n\t\t\t\t\t? [`npx -y all-contributors-cli add JoshuaKGoldberg tool`]\n\t\t\t\t\t: undefined,\n\t\t\tfiles: {\n\t\t\t\t\".all-contributorsrc\": JSON.stringify({\n\t\t\t\t\tbadgeTemplate:\n\t\t\t\t\t\t'\t<a href=\"#contributors\" target=\"_blank\"><img alt=\"👪 All Contributors: <%= contributors.length %>\" src=\"https://img.shields.io/badge/%F0%9F%91%AA_all_contributors-<%= contributors.length %>-21bb42.svg\" /></a>',\n\t\t\t\t\tcommit: false,\n\t\t\t\t\tcommitConvention: \"angular\",\n\t\t\t\t\tcommitType: \"docs\",\n\t\t\t\t\tcontributors: options.contributors ?? [],\n\t\t\t\t\tcontributorsPerLine: 7,\n\t\t\t\t\tcontributorsSortAlphabetically: true,\n\t\t\t\t\tfiles: [\"README.md\"],\n\t\t\t\t\timageSize: 100,\n\t\t\t\t\tprojectName: options.repository,\n\t\t\t\t\tprojectOwner: options.owner,\n\t\t\t\t\trepoHost: \"https://github.com\",\n\t\t\t\t\trepoType: \"github\",\n\t\t\t\t}),\n\t\t\t\t\".github\": {\n\t\t\t\t\tworkflows: {\n\t\t\t\t\t\t\"contributors.yml\": createSoloWorkflowFile({\n\t\t\t\t\t\t\tname: \"Contributors\",\n\t\t\t\t\t\t\ton: {\n\t\t\t\t\t\t\t\tpush: {\n\t\t\t\t\t\t\t\t\tbranches: [\"main\"],\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tsteps: [\n\t\t\t\t\t\t\t\t{ uses: \"actions/checkout@v4\", with: { \"fetch-depth\": 0 } },\n\t\t\t\t\t\t\t\t{ uses: \"./.github/actions/prepare\" },\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tenv: { GITHUB_TOKEN: \"${{ secrets.ACCESS_TOKEN }}\" },\n\t\t\t\t\t\t\t\t\tuses: `JoshuaKGoldberg/all-contributors-auto-action@v0.5.0`,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t}),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t},\n});\n"],"mappings":"AAAA,SAAS,8BAA8B;AACvC,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAEvB,MAAM,uBAAuB,KAAK,YAAY;AAAA,EACpD,OAAO;AAAA,IACN,MAAM;AAAA,EACP;AAAA,EACA,QAAQ,EAAE,QAAQ,GAAG;AACpB,WAAO;AAAA,MACN,QAAQ;AAAA,QACP,cAAc;AAAA,UACb,SAAS,CAAC,sBAAsB;AAAA,QACjC,CAAC;AAAA,MACF;AAAA,MACA,UACC,QAAQ,UAAU,oBACf,CAAC,sDAAsD,IACvD;AAAA,MACJ,OAAO;AAAA,QACN,uBAAuB,KAAK,UAAU;AAAA,UACrC,eACC;AAAA,UACD,QAAQ;AAAA,UACR,kBAAkB;AAAA,UAClB,YAAY;AAAA,UACZ,cAAc,QAAQ,gBAAgB,CAAC;AAAA,UACvC,qBAAqB;AAAA,UACrB,gCAAgC;AAAA,UAChC,OAAO,CAAC,WAAW;AAAA,UACnB,WAAW;AAAA,UACX,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,UACtB,UAAU;AAAA,UACV,UAAU;AAAA,QACX,CAAC;AAAA,QACD,WAAW;AAAA,UACV,WAAW;AAAA,YACV,oBAAoB,uBAAuB;AAAA,cAC1C,MAAM;AAAA,cACN,IAAI;AAAA,gBACH,MAAM;AAAA,kBACL,UAAU,CAAC,MAAM;AAAA,gBAClB;AAAA,cACD;AAAA,cACA,OAAO;AAAA,gBACN,EAAE,MAAM,uBAAuB,MAAM,EAAE,eAAe,EAAE,EAAE;AAAA,gBAC1D,EAAE,MAAM,4BAA4B;AAAA,gBACpC;AAAA,kBACC,KAAK,EAAE,cAAc,8BAA8B;AAAA,kBACnD,MAAM;AAAA,gBACP;AAAA,cACD;AAAA,YACD,CAAC;AAAA,UACF;AAAA,QACD;AAAA,MACD;AAAA,IACD;AAAA,EACD;AACD,CAAC;","names":[]}

package/lib/next/blocks/blockAreTheTypesWrong.d.ts

@@ -0,0 +1,48 @@
+import * as create from 'create';
+
+declare const blockAreTheTypesWrong: create.BlockWithoutAddons<{
+    description: string;
+    email: {
+        github: string;
+        npm: string;
+    };
+    title: string;
+    owner: string;
+    repository: string;
+    access?: "public" | "restricted" | undefined;
+    author?: string | undefined;
+    bin?: string | undefined;
+    login?: string | undefined;
+    contributors?: {
+        name: string;
+        avatar_url: string;
+        contributions: string[];
+        login: string;
+        profile: string;
+    }[] | undefined;
+    documentation?: string | undefined;
+    funding?: string | undefined;
+    guide?: {
+        href: string;
+        title: string;
+    } | undefined;
+    hideTemplatedBy?: boolean | undefined;
+    keywords?: string[] | undefined;
+    logo?: {
+        alt: string;
+        src: string;
+    } | undefined;
+    node?: {
+        minimum: string;
+        pinned?: string | undefined;
+    } | undefined;
+    packageData?: {
+        dependencies?: Record<string, string> | undefined;
+        devDependencies?: Record<string, string> | undefined;
+        scripts?: Record<string, string> | undefined;
+    } | undefined;
+    preserveGeneratedFrom?: boolean | undefined;
+    version?: string | undefined;
+}>;
+
+export { blockAreTheTypesWrong };

package/lib/next/blocks/blockAreTheTypesWrong.js

@@ -0,0 +1,29 @@
+import { base } from "../base.js";
+import { blockGitHubActionsCI } from "./blockGitHubActionsCI.js";
+const blockAreTheTypesWrong = base.createBlock({
+  about: {
+    name: "README.md"
+  },
+  produce() {
+    return {
+      addons: [
+        blockGitHubActionsCI({
+          jobs: [
+            {
+              name: "Are The Types Wrong?",
+              steps: [
+                {
+                  run: "npx --yes @arethetypeswrong/cli --pack . --ignore-rules cjs-resolves-to-esm"
+                }
+              ]
+            }
+          ]
+        })
+      ]
+    };
+  }
+});
+export {
+  blockAreTheTypesWrong
+};
+//# sourceMappingURL=blockAreTheTypesWrong.js.map

package/lib/next/blocks/blockAreTheTypesWrong.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/next/blocks/blockAreTheTypesWrong.ts"],"sourcesContent":["import { base } from \"../base.js\";\nimport { blockGitHubActionsCI } from \"./blockGitHubActionsCI.js\";\n\nexport const blockAreTheTypesWrong = base.createBlock({\n\tabout: {\n\t\tname: \"README.md\",\n\t},\n\tproduce() {\n\t\treturn {\n\t\t\taddons: [\n\t\t\t\tblockGitHubActionsCI({\n\t\t\t\t\tjobs: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tname: \"Are The Types Wrong?\",\n\t\t\t\t\t\t\tsteps: [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\trun: \"npx --yes @arethetypeswrong/cli --pack . --ignore-rules cjs-resolves-to-esm\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t}),\n\t\t\t],\n\t\t};\n\t},\n});\n"],"mappings":"AAAA,SAAS,YAAY;AACrB,SAAS,4BAA4B;AAE9B,MAAM,wBAAwB,KAAK,YAAY;AAAA,EACrD,OAAO;AAAA,IACN,MAAM;AAAA,EACP;AAAA,EACA,UAAU;AACT,WAAO;AAAA,MACN,QAAQ;AAAA,QACP,qBAAqB;AAAA,UACpB,MAAM;AAAA,YACL;AAAA,cACC,MAAM;AAAA,cACN,OAAO;AAAA,gBACN;AAAA,kBACC,KAAK;AAAA,gBACN;AAAA,cACD;AAAA,YACD;AAAA,UACD;AAAA,QACD,CAAC;AAAA,MACF;AAAA,IACD;AAAA,EACD;AACD,CAAC;","names":[]}

package/lib/next/blocks/blockCSpell.d.ts

@@ -0,0 +1,51 @@
+import * as create from 'create';
+
+declare const blockCSpell: create.BlockWithAddons<{
+    ignores: string[];
+    words: string[];
+}, {
+    description: string;
+    email: {
+        github: string;
+        npm: string;
+    };
+    title: string;
+    owner: string;
+    repository: string;
+    access?: "public" | "restricted" | undefined;
+    author?: string | undefined;
+    bin?: string | undefined;
+    login?: string | undefined;
+    contributors?: {
+        name: string;
+        avatar_url: string;
+        contributions: string[];
+        login: string;
+        profile: string;
+    }[] | undefined;
+    documentation?: string | undefined;
+    funding?: string | undefined;
+    guide?: {
+        href: string;
+        title: string;
+    } | undefined;
+    hideTemplatedBy?: boolean | undefined;
+    keywords?: string[] | undefined;
+    logo?: {
+        alt: string;
+        src: string;
+    } | undefined;
+    node?: {
+        minimum: string;
+        pinned?: string | undefined;
+    } | undefined;
+    packageData?: {
+        dependencies?: Record<string, string> | undefined;
+        devDependencies?: Record<string, string> | undefined;
+        scripts?: Record<string, string> | undefined;
+    } | undefined;
+    preserveGeneratedFrom?: boolean | undefined;
+    version?: string | undefined;
+}>;
+
+export { blockCSpell };

package/lib/next/blocks/blockCSpell.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { base } from "../base.js";
+import { blockDevelopmentDocs } from "./blockDevelopmentDocs.js";
+import { blockGitHubActionsCI } from "./blockGitHubActionsCI.js";
+import { blockPackageJson } from "./blockPackageJson.js";
+import { blockVSCode } from "./blockVSCode.js";
+import { getPackageDependencies } from "./packageData.js";
+const blockCSpell = base.createBlock({
+  about: {
+    name: "CSpell"
+  },
+  addons: {
+    ignores: z.array(z.string()).default([]),
+    words: z.array(z.string()).default([])
+  },
+  produce({ addons }) {
+    const { ignores, words } = addons;
+    return {
+      addons: [
+        blockDevelopmentDocs({
+          sections: {
+            Linting: {
+              contents: {
+                items: [
+                  `- \`pnpm lint:spelling\` ([cspell](https://cspell.org)): Spell checks across all source files`
+                ]
+              }
+            }
+          }
+        }),
+        blockVSCode({
+          extensions: ["streetsidesoftware.code-spell-checker"]
+        }),
+        blockGitHubActionsCI({
+          jobs: [
+            {
+              name: "Lint Spelling",
+              steps: [{ run: "pnpm lint:spelling" }]
+            }
+          ]
+        }),
+        blockPackageJson({
+          properties: {
+            devDependencies: getPackageDependencies("cspell"),
+            scripts: {
+              "lint:spelling": 'cspell "**" ".github/**/*"'
+            }
+          }
+        })
+      ],
+      files: {
+        "cspell.json": JSON.stringify({
+          dictionaries: ["npm", "node", "typescript"],
+          ignorePaths: [
+            ".github",
+            "CHANGELOG.md",
+            "lib",
+            "node_modules",
+            "pnpm-lock.yaml",
+            ...ignores
+          ].sort(),
+          ...words.length && { words: words.sort() }
+        })
+      },
+      package: {
+        devDependencies: getPackageDependencies("cspell"),
+        scripts: {
+          "lint:spelling": 'cspell "**" ".github/**/*"'
+        }
+      }
+    };
+  }
+});
+export {
+  blockCSpell
+};
+//# sourceMappingURL=blockCSpell.js.map

package/lib/next/blocks/blockCSpell.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/next/blocks/blockCSpell.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { base } from \"../base.js\";\nimport { blockDevelopmentDocs } from \"./blockDevelopmentDocs.js\";\nimport { blockGitHubActionsCI } from \"./blockGitHubActionsCI.js\";\nimport { blockPackageJson } from \"./blockPackageJson.js\";\nimport { blockVSCode } from \"./blockVSCode.js\";\nimport { getPackageDependencies } from \"./packageData.js\";\n\nexport const blockCSpell = base.createBlock({\n\tabout: {\n\t\tname: \"CSpell\",\n\t},\n\taddons: {\n\t\tignores: z.array(z.string()).default([]),\n\t\twords: z.array(z.string()).default([]),\n\t},\n\tproduce({ addons }) {\n\t\tconst { ignores, words } = addons;\n\n\t\treturn {\n\t\t\taddons: [\n\t\t\t\tblockDevelopmentDocs({\n\t\t\t\t\tsections: {\n\t\t\t\t\t\tLinting: {\n\t\t\t\t\t\t\tcontents: {\n\t\t\t\t\t\t\t\titems: [\n\t\t\t\t\t\t\t\t\t`- \\`pnpm lint:spelling\\` ([cspell](https://cspell.org)): Spell checks across all source files`,\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t\tblockVSCode({\n\t\t\t\t\textensions: [\"streetsidesoftware.code-spell-checker\"],\n\t\t\t\t}),\n\t\t\t\tblockGitHubActionsCI({\n\t\t\t\t\tjobs: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tname: \"Lint Spelling\",\n\t\t\t\t\t\t\tsteps: [{ run: \"pnpm lint:spelling\" }],\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t}),\n\t\t\t\tblockPackageJson({\n\t\t\t\t\tproperties: {\n\t\t\t\t\t\tdevDependencies: getPackageDependencies(\"cspell\"),\n\t\t\t\t\t\tscripts: {\n\t\t\t\t\t\t\t\"lint:spelling\": 'cspell \"**\" \".github/**/*\"',\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t],\n\t\t\tfiles: {\n\t\t\t\t\"cspell.json\": JSON.stringify({\n\t\t\t\t\tdictionaries: [\"npm\", \"node\", \"typescript\"],\n\t\t\t\t\tignorePaths: [\n\t\t\t\t\t\t\".github\",\n\t\t\t\t\t\t\"CHANGELOG.md\",\n\t\t\t\t\t\t\"lib\",\n\t\t\t\t\t\t\"node_modules\",\n\t\t\t\t\t\t\"pnpm-lock.yaml\",\n\t\t\t\t\t\t...ignores,\n\t\t\t\t\t].sort(),\n\t\t\t\t\t...(words.length && { words: words.sort() }),\n\t\t\t\t}),\n\t\t\t},\n\t\t\tpackage: {\n\t\t\t\tdevDependencies: getPackageDependencies(\"cspell\"),\n\t\t\t\tscripts: {\n\t\t\t\t\t\"lint:spelling\": 'cspell \"**\" \".github/**/*\"',\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t},\n});\n"],"mappings":"AAAA,SAAS,SAAS;AAElB,SAAS,YAAY;AACrB,SAAS,4BAA4B;AACrC,SAAS,4BAA4B;AACrC,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAC5B,SAAS,8BAA8B;AAEhC,MAAM,cAAc,KAAK,YAAY;AAAA,EAC3C,OAAO;AAAA,IACN,MAAM;AAAA,EACP;AAAA,EACA,QAAQ;AAAA,IACP,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,IACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EACtC;AAAA,EACA,QAAQ,EAAE,OAAO,GAAG;AACnB,UAAM,EAAE,SAAS,MAAM,IAAI;AAE3B,WAAO;AAAA,MACN,QAAQ;AAAA,QACP,qBAAqB;AAAA,UACpB,UAAU;AAAA,YACT,SAAS;AAAA,cACR,UAAU;AAAA,gBACT,OAAO;AAAA,kBACN;AAAA,gBACD;AAAA,cACD;AAAA,YACD;AAAA,UACD;AAAA,QACD,CAAC;AAAA,QACD,YAAY;AAAA,UACX,YAAY,CAAC,uCAAuC;AAAA,QACrD,CAAC;AAAA,QACD,qBAAqB;AAAA,UACpB,MAAM;AAAA,YACL;AAAA,cACC,MAAM;AAAA,cACN,OAAO,CAAC,EAAE,KAAK,qBAAqB,CAAC;AAAA,YACtC;AAAA,UACD;AAAA,QACD,CAAC;AAAA,QACD,iBAAiB;AAAA,UAChB,YAAY;AAAA,YACX,iBAAiB,uBAAuB,QAAQ;AAAA,YAChD,SAAS;AAAA,cACR,iBAAiB;AAAA,YAClB;AAAA,UACD;AAAA,QACD,CAAC;AAAA,MACF;AAAA,MACA,OAAO;AAAA,QACN,eAAe,KAAK,UAAU;AAAA,UAC7B,cAAc,CAAC,OAAO,QAAQ,YAAY;AAAA,UAC1C,aAAa;AAAA,YACZ;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA,GAAG;AAAA,UACJ,EAAE,KAAK;AAAA,UACP,GAAI,MAAM,UAAU,EAAE,OAAO,MAAM,KAAK,EAAE;AAAA,QAC3C,CAAC;AAAA,MACF;AAAA,MACA,SAAS;AAAA,QACR,iBAAiB,uBAAuB,QAAQ;AAAA,QAChD,SAAS;AAAA,UACR,iBAAiB;AAAA,QAClB;AAAA,MACD;AAAA,IACD;AAAA,EACD;AACD,CAAC;","names":[]}

package/lib/next/blocks/blockContributingDocs.d.ts

@@ -0,0 +1,48 @@
+import * as create from 'create';
+
+declare const blockContributingDocs: create.BlockWithoutAddons<{
+    description: string;
+    email: {
+        github: string;
+        npm: string;
+    };
+    title: string;
+    owner: string;
+    repository: string;
+    access?: "public" | "restricted" | undefined;
+    author?: string | undefined;
+    bin?: string | undefined;
+    login?: string | undefined;
+    contributors?: {
+        name: string;
+        avatar_url: string;
+        contributions: string[];
+        login: string;
+        profile: string;
+    }[] | undefined;
+    documentation?: string | undefined;
+    funding?: string | undefined;
+    guide?: {
+        href: string;
+        title: string;
+    } | undefined;
+    hideTemplatedBy?: boolean | undefined;
+    keywords?: string[] | undefined;
+    logo?: {
+        alt: string;
+        src: string;
+    } | undefined;
+    node?: {
+        minimum: string;
+        pinned?: string | undefined;
+    } | undefined;
+    packageData?: {
+        dependencies?: Record<string, string> | undefined;
+        devDependencies?: Record<string, string> | undefined;
+        scripts?: Record<string, string> | undefined;
+    } | undefined;
+    preserveGeneratedFrom?: boolean | undefined;
+    version?: string | undefined;
+}>;
+
+export { blockContributingDocs };

package/lib/next/blocks/blockContributingDocs.js

@@ -0,0 +1,116 @@
+import { base } from "../base.js";
+const blockContributingDocs = base.createBlock({
+  about: {
+    name: "Contributing Docs"
+  },
+  produce({ options }) {
+    return {
+      files: {
+        ".github": {
+          "CONTRIBUTING.md": `# Contributing
+
+Thanks for your interest in contributing to \`${options.repository}\`! \u{1F496}
+
+> After this page, see [DEVELOPMENT.md](./DEVELOPMENT.md) for local development instructions.
+
+## Code of Conduct
+
+This project contains a [Contributor Covenant code of conduct](./CODE_OF_CONDUCT.md) all contributors are expected to follow.
+
+## Reporting Issues
+
+Please do [report an issue on the issue tracker](https://github.com/${options.owner}/${options.repository}/issues/new/choose) if there's any bugfix, documentation improvement, or general enhancement you'd like to see in the repository! Please fully fill out all required fields in the most appropriate issue form.
+
+## Sending Contributions
+
+Sending your own changes as contribution is always appreciated!
+There are two steps involved:
+
+1. [Finding an Issue](#finding-an-issue)
+2. [Sending a Pull Request](#sending-a-pull-request)
+
+### Finding an Issue
+
+With the exception of very small typos, all changes to this repository generally need to correspond to an [unassigned open issue marked as \`status: accepting prs\` on the issue tracker](https://github.com/${options.owner}/${options.repository}/issues?q=is%3Aissue+is%3Aopen+label%3A%22status%3A+accepting+prs%22+no%3Aassignee+).
+If this is your first time contributing, consider searching for [unassigned issues that also have the \`good first issue\` label](https://github.com/${options.owner}/${options.repository}/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22+label%3A%22status%3A+accepting+prs%22+no%3Aassignee+).
+If the issue you'd like to fix isn't found on the issue, see [Reporting Issues](#reporting-issues) for filing your own (please do!).
+
+#### Issue Claiming
+
+We don't use any kind of issue claiming system.
+We've found in the past that they result in accidental ["licked cookie"](https://devblogs.microsoft.com/oldnewthing/20091201-00/?p=15843) situations where contributors claim an issue but run out of time or energy trying before sending a PR.
+
+If an unassigned issue has been marked as \`status: accepting prs\` and an open PR does not exist, feel free to send a PR.
+Please don't post comments asking for permission or stating you will work on an issue.
+
+### Sending a Pull Request
+
+Once you've identified an open issue accepting PRs that doesn't yet have a PR sent, you're free to send a pull request.
+Be sure to fill out the pull request template's requested information -- otherwise your PR will likely be closed.
+
+PRs are also expected to have a title that adheres to [conventional commits](https://www.conventionalcommits.org/en/v1.0.0).
+Only PR titles need to be in that format, not individual commits.
+Don't worry if you get this wrong: you can always change the PR title after sending it.
+Check [previously merged PRs](https://github.com/${options.owner}/${options.repository}/pulls?q=is%3Apr+is%3Amerged+-label%3Adependencies+) for reference.
+
+#### Draft PRs
+
+If you don't think your PR is ready for review, [set it as a draft](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft).
+Draft PRs won't be reviewed.
+
+#### Granular PRs
+
+Please keep pull requests single-purpose: in other words, don't attempt to solve multiple unrelated problems in one pull request.
+Send one PR per area of concern.
+Multi-purpose pull requests are harder and slower to review, block all changes from being merged until the whole pull request is reviewed, and are difficult to name well with semantic PR titles.
+
+#### Pull Request Reviews
+
+When a PR is not in draft, it's considered ready for review.
+Please don't manually \`@\` tag anybody to request review.
+A maintainer will look at it when they're next able to.
+
+PRs should have passing [GitHub status checks](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks) before review is requested (unless there are explicit questions asked in the PR about any failures).
+
+#### Asking Questions
+
+If you need help and/or have a question, posting a comment in the PR is a great way to do so.
+There's no need to tag anybody individually.
+One of us will drop by and help when we can.
+
+Please post comments as [line comments](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request) when possible, so that they can be threaded.
+You can [resolve conversations](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request#resolving-conversations) on your own when you feel they're resolved - no need to comment explicitly and/or wait for a maintainer.
+
+#### Requested Changes
+
+After a maintainer reviews your PR, they may request changes on it.
+Once you've made those changes, [re-request review on GitHub](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews#re-requesting-a-review).
+
+Please try not to force-push commits to PRs that have already been reviewed.
+Doing so makes it harder to review the changes.
+We squash merge all commits so there's no need to try to preserve Git history within a PR branch.
+
+Once you've addressed all our feedback by making code changes and/or started a followup discussion, [re-request review](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews#re-requesting-a-review) from each maintainer whose feedback you addressed.
+
+Once all feedback is addressed and the PR is approved, we'll ensure the branch is up to date with \`main\` and merge it for you.
+
+#### Post-Merge Recognition
+
+Once your PR is merged, if you haven't yet been added to the [_Contributors_ table in the README.md](../README.md#contributors) for its [type of contribution](https://allcontributors.org/docs/en/emoji-key "Allcontributors emoji key"), you should be soon.
+Please do ping the maintainer who merged your PR if that doesn't happen within 24 hours - it was likely an oversight on our end!
+
+## Emojis & Appreciation
+
+If you made it all the way to the end, bravo dear user, we love you.
+Please include your favorite emoji in the bottom of your issues and PRs to signal to us that you did in fact read this file and are trying to conform to it as best as possible.
+\u{1F496} is a good starter if you're not sure which to use.
+`
+        }
+      }
+    };
+  }
+});
+export {
+  blockContributingDocs
+};
+//# sourceMappingURL=blockContributingDocs.js.map

package/lib/next/blocks/blockContributingDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/next/blocks/blockContributingDocs.ts"],"sourcesContent":["import { base } from \"../base.js\";\n\nexport const blockContributingDocs = base.createBlock({\n\tabout: {\n\t\tname: \"Contributing Docs\",\n\t},\n\tproduce({ options }) {\n\t\treturn {\n\t\t\tfiles: {\n\t\t\t\t\".github\": {\n\t\t\t\t\t\"CONTRIBUTING.md\": `# Contributing\n\nThanks for your interest in contributing to \\`${options.repository}\\`! 💖\n\n> After this page, see [DEVELOPMENT.md](./DEVELOPMENT.md) for local development instructions.\n\n## Code of Conduct\n\nThis project contains a [Contributor Covenant code of conduct](./CODE_OF_CONDUCT.md) all contributors are expected to follow.\n\n## Reporting Issues\n\nPlease do [report an issue on the issue tracker](https://github.com/${options.owner}/${options.repository}/issues/new/choose) if there's any bugfix, documentation improvement, or general enhancement you'd like to see in the repository! Please fully fill out all required fields in the most appropriate issue form.\n\n## Sending Contributions\n\nSending your own changes as contribution is always appreciated!\nThere are two steps involved:\n\n1. [Finding an Issue](#finding-an-issue)\n2. [Sending a Pull Request](#sending-a-pull-request)\n\n### Finding an Issue\n\nWith the exception of very small typos, all changes to this repository generally need to correspond to an [unassigned open issue marked as \\`status: accepting prs\\` on the issue tracker](https://github.com/${options.owner}/${options.repository}/issues?q=is%3Aissue+is%3Aopen+label%3A%22status%3A+accepting+prs%22+no%3Aassignee+).\nIf this is your first time contributing, consider searching for [unassigned issues that also have the \\`good first issue\\` label](https://github.com/${options.owner}/${options.repository}/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22+label%3A%22status%3A+accepting+prs%22+no%3Aassignee+).\nIf the issue you'd like to fix isn't found on the issue, see [Reporting Issues](#reporting-issues) for filing your own (please do!).\n\n#### Issue Claiming\n\nWe don't use any kind of issue claiming system.\nWe've found in the past that they result in accidental [\"licked cookie\"](https://devblogs.microsoft.com/oldnewthing/20091201-00/?p=15843) situations where contributors claim an issue but run out of time or energy trying before sending a PR.\n\nIf an unassigned issue has been marked as \\`status: accepting prs\\` and an open PR does not exist, feel free to send a PR.\nPlease don't post comments asking for permission or stating you will work on an issue.\n\n### Sending a Pull Request\n\nOnce you've identified an open issue accepting PRs that doesn't yet have a PR sent, you're free to send a pull request.\nBe sure to fill out the pull request template's requested information -- otherwise your PR will likely be closed.\n\nPRs are also expected to have a title that adheres to [conventional commits](https://www.conventionalcommits.org/en/v1.0.0).\nOnly PR titles need to be in that format, not individual commits.\nDon't worry if you get this wrong: you can always change the PR title after sending it.\nCheck [previously merged PRs](https://github.com/${options.owner}/${options.repository}/pulls?q=is%3Apr+is%3Amerged+-label%3Adependencies+) for reference.\n\n#### Draft PRs\n\nIf you don't think your PR is ready for review, [set it as a draft](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft).\nDraft PRs won't be reviewed.\n\n#### Granular PRs\n\nPlease keep pull requests single-purpose: in other words, don't attempt to solve multiple unrelated problems in one pull request.\nSend one PR per area of concern.\nMulti-purpose pull requests are harder and slower to review, block all changes from being merged until the whole pull request is reviewed, and are difficult to name well with semantic PR titles.\n\n#### Pull Request Reviews\n\nWhen a PR is not in draft, it's considered ready for review.\nPlease don't manually \\`@\\` tag anybody to request review.\nA maintainer will look at it when they're next able to.\n\nPRs should have passing [GitHub status checks](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks) before review is requested (unless there are explicit questions asked in the PR about any failures).\n\n#### Asking Questions\n\nIf you need help and/or have a question, posting a comment in the PR is a great way to do so.\nThere's no need to tag anybody individually.\nOne of us will drop by and help when we can.\n\nPlease post comments as [line comments](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request) when possible, so that they can be threaded.\nYou can [resolve conversations](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request#resolving-conversations) on your own when you feel they're resolved - no need to comment explicitly and/or wait for a maintainer.\n\n#### Requested Changes\n\nAfter a maintainer reviews your PR, they may request changes on it.\nOnce you've made those changes, [re-request review on GitHub](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews#re-requesting-a-review).\n\nPlease try not to force-push commits to PRs that have already been reviewed.\nDoing so makes it harder to review the changes.\nWe squash merge all commits so there's no need to try to preserve Git history within a PR branch.\n\nOnce you've addressed all our feedback by making code changes and/or started a followup discussion, [re-request review](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews#re-requesting-a-review) from each maintainer whose feedback you addressed.\n\nOnce all feedback is addressed and the PR is approved, we'll ensure the branch is up to date with \\`main\\` and merge it for you.\n\n#### Post-Merge Recognition\n\nOnce your PR is merged, if you haven't yet been added to the [_Contributors_ table in the README.md](../README.md#contributors) for its [type of contribution](https://allcontributors.org/docs/en/emoji-key \"Allcontributors emoji key\"), you should be soon.\nPlease do ping the maintainer who merged your PR if that doesn't happen within 24 hours - it was likely an oversight on our end!\n\n## Emojis & Appreciation\n\nIf you made it all the way to the end, bravo dear user, we love you.\nPlease include your favorite emoji in the bottom of your issues and PRs to signal to us that you did in fact read this file and are trying to conform to it as best as possible.\n💖 is a good starter if you're not sure which to use.\n`,\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t},\n});\n"],"mappings":"AAAA,SAAS,YAAY;AAEd,MAAM,wBAAwB,KAAK,YAAY;AAAA,EACrD,OAAO;AAAA,IACN,MAAM;AAAA,EACP;AAAA,EACA,QAAQ,EAAE,QAAQ,GAAG;AACpB,WAAO;AAAA,MACN,OAAO;AAAA,QACN,WAAW;AAAA,UACV,mBAAmB;AAAA;AAAA,gDAEwB,QAAQ,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sEAUI,QAAQ,KAAK,IAAI,QAAQ,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gNAYuG,QAAQ,KAAK,IAAI,QAAQ,UAAU;AAAA,uJAC5F,QAAQ,KAAK,IAAI,QAAQ,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mDAmBvI,QAAQ,KAAK,IAAI,QAAQ,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAsDlF;AAAA,MACD;AAAA,IACD;AAAA,EACD;AACD,CAAC;","names":[]}

package/lib/next/blocks/blockContributorCovenant.d.ts

@@ -0,0 +1,48 @@
+import * as create from 'create';
+
+declare const blockContributorCovenant: create.BlockWithoutAddons<{
+    description: string;
+    email: {
+        github: string;
+        npm: string;
+    };
+    title: string;
+    owner: string;
+    repository: string;
+    access?: "public" | "restricted" | undefined;
+    author?: string | undefined;
+    bin?: string | undefined;
+    login?: string | undefined;
+    contributors?: {
+        name: string;
+        avatar_url: string;
+        contributions: string[];
+        login: string;
+        profile: string;
+    }[] | undefined;
+    documentation?: string | undefined;
+    funding?: string | undefined;
+    guide?: {
+        href: string;
+        title: string;
+    } | undefined;
+    hideTemplatedBy?: boolean | undefined;
+    keywords?: string[] | undefined;
+    logo?: {
+        alt: string;
+        src: string;
+    } | undefined;
+    node?: {
+        minimum: string;
+        pinned?: string | undefined;
+    } | undefined;
+    packageData?: {
+        dependencies?: Record<string, string> | undefined;
+        devDependencies?: Record<string, string> | undefined;
+        scripts?: Record<string, string> | undefined;
+    } | undefined;
+    preserveGeneratedFrom?: boolean | undefined;
+    version?: string | undefined;
+}>;
+
+export { blockContributorCovenant };