From 2b9efd5bf15b6d218b997753c239ae9fc97ede99 Mon Sep 17 00:00:00 2001
From: Ray <i@mk1.io>
Date: Sat, 22 Jul 2023 00:45:15 +0800
Subject: [PATCH] fix: add missing `printer.preprocess` definition (#15123)

* fix: allow preprocess to return a promise

* fix: types

* chore: format

* chore: changelog

* Update changelog_unreleased/api/15123.md

Co-authored-by: fisker Cheung <lionkay@gmail.com>

* apply changes

* Update 15123.md

* Update 15123.md

* Simplify changelog

---------

Co-authored-by: fisker Cheung <lionkay@gmail.com>
---
 changelog_unreleased/api/15123.md | 10 ++++++++++
 src/index.d.ts                    |  3 +++
 2 files changed, 13 insertions(+)
 create mode 100644 changelog_unreleased/api/15123.md

diff --git a/changelog_unreleased/api/15123.md b/changelog_unreleased/api/15123.md
new file mode 100644
index 000000000..27646c626
--- /dev/null
+++ b/changelog_unreleased/api/15123.md
@@ -0,0 +1,10 @@
+#### Add missing type definition for `printer.preprocess` (#15123 by @so1ve)
+
+```diff
+export interface Printer<T = any> {
+  // ...
++ preprocess?:
++   | ((ast: T, options: ParserOptions<T>) => T | Promise<T>)
++   | undefined;
+}
+```
diff --git a/src/index.d.ts b/src/index.d.ts
index c4a160ca2..4200e7ba4 100644
--- a/src/index.d.ts
+++ b/src/index.d.ts
@@ -485,6 +485,9 @@ export interface Printer<T = any> {
         | Doc
         | null)
     | undefined;
+  preprocess?:
+    | ((ast: T, options: ParserOptions<T>) => T | Promise<T>)
+    | undefined;
   insertPragma?: (text: string) => string;
   /**
    * @returns `null` if you want to remove this node