Update APIs to support Prettier 3

Author: Mrtenz

package.json

@@ -44,18 +44,18 @@
     "@typescript-eslint/eslint-plugin": "^5.42.1",
     "@typescript-eslint/parser": "^5.42.1",
     "eslint": "^8.40.0",
-    "eslint-config-prettier": "^8.5.0",
+    "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-import": "^2.26.0",
     "eslint-plugin-jest": "^27.1.5",
     "eslint-plugin-jsdoc": "^39.6.2",
     "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-prettier": "^4.2.1",
-    "jest": "^26.4.2",
+    "eslint-plugin-prettier": "^5.2.1",
+    "jest": "^29.7.0",
     "outdent": "^0.8.0",
     "prettier": "^3.3.3",
     "prettier-plugin-packagejson": "^2.5.2",
     "rimraf": "^3.0.2",
-    "ts-jest": "^26.5.6",
+    "ts-jest": "^29.2.5",
     "typescript": "~4.8.4"
   },
   "peerDependencies": {

src/changelog.test.ts

@@ -12,18 +12,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 `;
 
 describe('Changelog', () => {
-  it('should allow creating an empty changelog', () => {
+  it('should allow creating an empty changelog', async () => {
     const changelog = new Changelog({
       repoUrl: 'fake://metamask.io',
     });
-    expect(changelog.toString()).toStrictEqual(emptyChangelog);
+
+    expect(await changelog.toString()).toStrictEqual(emptyChangelog);
   });
 
-  it('should allow creating an empty changelog with a custom tag prefix', () => {
+  it('should allow creating an empty changelog with a custom tag prefix', async () => {
     const changelog = new Changelog({
       repoUrl: 'fake://metamask.io',
       tagPrefix: 'example@v',
     });
-    expect(changelog.toString()).toStrictEqual(emptyChangelog);
+
+    expect(await changelog.toString()).toStrictEqual(emptyChangelog);
   });
 });

src/changelog.ts

@@ -1,3 +1,5 @@
+import * as markdown from 'prettier/plugins/markdown';
+import { format as formatWithPrettier } from 'prettier/standalone';
 import semver from 'semver';
 
 import {
@@ -8,6 +10,19 @@ import {
 } from './constants';
 import { PackageRename } from './shared-types';
 
+/**
+ * Format a Markdown changelog string.
+ *
+ * @param changelog - The changelog string to format.
+ * @returns The formatted changelog string.
+ */
+export async function format(changelog: string): Promise<string> {
+  return formatWithPrettier(changelog, {
+    parser: 'markdown',
+    plugins: [markdown],
+  });
+}
+
 /**
  * `Object.getOwnPropertyNames()` is intentionally generic: it returns the
  * immediate property names of an object, but it cannot make guarantees about
@@ -37,7 +52,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 /**
  * Formatter function that formats a Markdown changelog string.
  */
-export type Formatter = (changelog: string) => string;
+export type Formatter = (changelog: string) => string | Promise<string>;
 
 type ReleaseMetadata = {
   /**
@@ -571,7 +586,7 @@ export default class Changelog {
    *
    * @returns The stringified changelog.
    */
-  toString(): string {
+  async toString(): Promise<string> {
     const changelog = `${changelogTitle}
 ${changelogDescription}
 
@@ -584,6 +599,6 @@ ${stringifyLinkReferenceDefinitions(
   this.#packageRename,
 )}`;
 
-    return this.#formatter(changelog);
+    return await this.#formatter(changelog);
   }
 }

src/cli.ts

@@ -2,13 +2,12 @@
 
 import { promises as fs, constants as fsConstants } from 'fs';
 import path from 'path';
-import prettier from 'prettier';
 import semver from 'semver';
 import type { Argv } from 'yargs';
 import { hideBin } from 'yargs/helpers';
 import yargs from 'yargs/yargs';
 
-import { Formatter } from './changelog';
+import { format, Formatter } from './changelog';
 import { unreleased, Version } from './constants';
 import { generateDiff } from './generate-diff';
 import { createEmptyChangelog } from './init';
@@ -184,7 +183,7 @@ async function validate({
   const changelogContent = await readChangelog(changelogPath);
 
   try {
-    validateChangelog({
+    await validateChangelog({
       changelogContent,
       currentVersion,
       repoUrl,
@@ -239,7 +238,7 @@ type InitOptions = {
  * @param options.tagPrefix - The prefix used in tags before the version number.
  */
 async function init({ changelogPath, repoUrl, tagPrefix }: InitOptions) {
-  const changelogContent = createEmptyChangelog({ repoUrl, tagPrefix });
+  const changelogContent = await createEmptyChangelog({ repoUrl, tagPrefix });
   await saveChangelog(changelogPath, changelogContent);
 }
 
@@ -466,10 +465,8 @@ async function main() {
     }
   }
 
-  const formatter = (changelog: string) => {
-    return usePrettier
-      ? prettier.format(changelog, { parser: 'markdown' })
-      : changelog;
+  const formatter = async (changelog: string) => {
+    return usePrettier ? await format(changelog) : changelog;
   };
 
   if (command === 'update') {

src/generate-diff.test.ts

@@ -318,7 +318,7 @@ const testCases = [
 
 describe('generateDiff', () => {
   for (const { description, before, after, expected } of testCases) {
-    it(`${description}`, () => {
+    it(`${description}`, async () => {
       const diff = generateDiff(before, after);
       expect(diff).toStrictEqual(expected);
     });

src/init.test.ts

@@ -2,6 +2,7 @@ import { createEmptyChangelog } from './init';
 
 const exampleRepoUrl =
   'https://github.com/ExampleUsernameOrOrganization/ExampleRepository/';
+
 const emptyChangelog = `# Changelog
 All notable changes to this project will be documented in this file.
 
@@ -14,15 +15,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 `;
 
 describe('createEmptyChangelog', () => {
-  it('creates an empty changelog', () => {
-    expect(createEmptyChangelog({ repoUrl: exampleRepoUrl })).toStrictEqual(
-      emptyChangelog,
-    );
+  it('creates an empty changelog', async () => {
+    expect(
+      await createEmptyChangelog({ repoUrl: exampleRepoUrl }),
+    ).toStrictEqual(emptyChangelog);
   });
 
-  it('creates an empty changelog with a custom tag prefix', () => {
+  it('creates an empty changelog with a custom tag prefix', async () => {
     expect(
-      createEmptyChangelog({ repoUrl: exampleRepoUrl, tagPrefix: 'foo' }),
+      await createEmptyChangelog({ repoUrl: exampleRepoUrl, tagPrefix: 'foo' }),
     ).toStrictEqual(emptyChangelog);
   });
 });

src/init.ts

@@ -8,13 +8,13 @@ import Changelog from './changelog';
  * @param options.tagPrefix - The prefix used in tags before the version number.
  * @returns The initial changelog text.
  */
-export function createEmptyChangelog({
+export async function createEmptyChangelog({
   repoUrl,
   tagPrefix = 'v',
 }: {
   repoUrl: string;
   tagPrefix?: string;
 }) {
   const changelog = new Changelog({ repoUrl, tagPrefix });
-  return changelog.toString();
+  return await changelog.toString();
 }

src/update-changelog.ts

@@ -310,7 +310,7 @@ export async function updateChangelog({
     });
   }
 
-  const newChangelogContent = changelog.toString();
+  const newChangelogContent = await changelog.toString();
   const isChangelogUpdated = changelogContent !== newChangelogContent;
   return isChangelogUpdated ? newChangelogContent : undefined;
 }