Remove declare to clean up global scope (#354)

* refactor(types): Remove dangerous `declare` so prettier types aren't polluted globally

* add docs example

* Update changelog

* Tweak readme

* Adjust internal types

---------

Co-authored-by: Jordan Pittman <[email protected]>

Author: drake-nathan

CHANGELOG.md

@@ -7,7 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-- Nothing yet!
+- Don't augment global Prettier `ParserOptions` and `RequiredOptions` types ([#354](https://github.com/tailwindlabs/prettier-plugin-tailwindcss/pull/354))
 
 ## [0.6.14] - 2025-07-09
 

README.md

@@ -19,6 +19,17 @@ Then add the plugin to your [Prettier configuration](https://prettier.io/docs/en
 }
 ```
 
+When using a JavaScript config, you can import the types for IntelliSense:
+
+```js
+// prettier.config.js
+
+/** @type {import('prettier').Config & import('prettier-plugin-tailwindcss').PluginOptions} */
+export default {
+  plugins: ["prettier-plugin-tailwindcss"],
+}
+```
+
 ## Upgrading to v0.5.x
 
 As of v0.5.x, this plugin now requires Prettier v3 and is ESM-only. This means it cannot be loaded via `require()`. For more information see our [upgrade guide](https://github.com/tailwindlabs/prettier-plugin-tailwindcss/issues/207#issuecomment-1698071122).

src/index.ts

@@ -1288,8 +1288,3 @@ export interface PluginOptions {
    */
   tailwindPreserveDuplicates?: boolean
 }
-
-declare module 'prettier' {
-  interface RequiredOptions extends PluginOptions {}
-  interface ParserOptions extends PluginOptions {}
-}

src/internal.d.ts

@@ -1,4 +1,6 @@
-export interface InternalOptions {
+import type { PluginOptions } from '.'
+
+export interface InternalOptions extends PluginOptions {
   printer: Printer<any>
 
   /**

src/options.ts

@@ -1,6 +1,5 @@
 import type { RequiredOptions, SupportOption } from 'prettier'
 import type { Customizations } from './types'
-import './index'
 
 export const options: Record<string, SupportOption> = {
   tailwindConfig: {