Release 3.6.0

fisker · fisker · commit e1c8095fd070 · 2025-06-23T10:00:51.000+08:00
diff --git a/.github/ISSUE_TEMPLATE/formatting.md b/.github/ISSUE_TEMPLATE/formatting.md
@@ -26,7 +26,7 @@ Don't fill the form below manually! Let a program create a report for you:
 
 -->
 
-**Prettier 3.5.3**
+**Prettier 3.6.0**
 [Playground link](https://prettier.io/playground/#.....)
 
 ```sh
diff --git a/.github/ISSUE_TEMPLATE/integration.md b/.github/ISSUE_TEMPLATE/integration.md
@@ -20,7 +20,7 @@ BEFORE SUBMITTING AN ISSUE:
 
 **Environments:**
 
-- Prettier Version: 3.5.3
+- Prettier Version: 3.6.0
 - Running Prettier via: <!-- CLI, Node.js API, Browser API, etc. -->
 - Runtime: <!-- Node.js v14, Chrome v83, etc. -->
 - Operating System: <!-- Windows, Linux, macOS, etc. -->
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,9 @@
+# 3.6.0
+
+[diff](https://github.com/prettier/prettier/compare/3.5.3...3.6.0)
+
+🔗 [Release Notes](https://prettier.io/blog/2025/06/23/3.6.0)
+
 # 3.5.3
 
 [diff](https://github.com/prettier/prettier/compare/3.5.2...3.5.3)
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "prettier",
-  "version": "3.6.0-dev",
+  "version": "3.6.0",
   "description": "Prettier is an opinionated code formatter",
   "bin": "./bin/prettier.cjs",
   "repository": "prettier/prettier",
diff --git a/website/versioned_docs/version-stable/api.md b/website/versioned_docs/version-stable/api.md
@@ -99,7 +99,7 @@ Setting `options.ignorePath` (`string | URL | (string | URL)[]`) and `options.wi
 
 If the given `fileUrlOrPath` is ignored, the `inferredParser` is always `null`.
 
-Providing [plugin](plugins.md) paths in `options.plugins` (`string[]`) helps extract `inferredParser` for files that are not supported by Prettier core.
+Providing [plugin](plugins.md) paths in `options.plugins` (`(string | URL | Plugin)[]`) helps extract `inferredParser` for files that are not supported by Prettier core.
 
 When setting `options.resolveConfig` (`boolean`, default `true`) to `false`, Prettier will not search for configuration file. This can be useful if this function is only used to check if file is ignored.
 
@@ -124,10 +124,18 @@ The support information looks like this:
     filenames?: string[];
     linguistLanguageId?: number;
     vscodeLanguageIds?: string[];
+    isSupported?(options: { filepath: string }): boolean;
   }>;
 }
 ```
 
+:::note
+
+Prettier can not ensure that `filepath` exists on disk.\
+When using from APIs(eg: `prettier.format()`), Prettier can not ensure it's a valid path either.
+
+:::
+
 <a name="custom-parser-api"></a>
 
 ## Custom Parser API (removed)
diff --git a/website/versioned_docs/version-stable/browser.md b/website/versioned_docs/version-stable/browser.md
@@ -21,7 +21,7 @@ Required options:
 
 - **[`parser`](options.md#parser) (or [`filepath`](options.md#file-path))**: One of these options has to be specified for Prettier to know which parser to use.
 
-- **`plugins`**: Unlike the `format` function from the [Node.js-based API](api.md#prettierformatsource-options), this function doesn’t load plugins automatically. The `plugins` option is required because all the parsers included in the Prettier package come as plugins (for reasons of file size). These plugins are files in [https://unpkg.com/browse/prettier@3.5.3/plugins](https://unpkg.com/browse/prettier@3.5.3/plugins). Note that `estree` plugin should be loaded when printing JavaScript, TypeScript, Flow, or JSON.
+- **`plugins`**: Unlike the `format` function from the [Node.js-based API](api.md#prettierformatsource-options), this function doesn’t load plugins automatically. The `plugins` option is required because all the parsers included in the Prettier package come as plugins (for reasons of file size). These plugins are files in [https://unpkg.com/browse/prettier@3.6.0/plugins](https://unpkg.com/browse/prettier@3.6.0/plugins). Note that `estree` plugin should be loaded when printing JavaScript, TypeScript, Flow, or JSON.
 
   You need to load the ones that you’re going to use and pass them to `prettier.format` using the `plugins` option.
 
@@ -32,8 +32,8 @@ See below for examples.
 ### Global
 
 ```html
-<script src="https://unpkg.com/prettier@3.5.3/standalone.js"></script>
-<script src="https://unpkg.com/prettier@3.5.3/plugins/graphql.js"></script>
+<script src="https://unpkg.com/prettier@3.6.0/standalone.js"></script>
+<script src="https://unpkg.com/prettier@3.6.0/plugins/graphql.js"></script>
 <script>
   (async () => {
     const formatted = await prettier.format("type Query { hello: String }", {
@@ -50,8 +50,8 @@ Note that the [`unpkg` field](https://unpkg.com/#examples) in Prettier’s `pack
 
 ```html
 <script type="module">
-  import * as prettier from "https://unpkg.com/prettier@3.5.3/standalone.mjs";
-  import * as prettierPluginGraphql from "https://unpkg.com/prettier@3.5.3/plugins/graphql.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.6.0/standalone.mjs";
+  import * as prettierPluginGraphql from "https://unpkg.com/prettier@3.6.0/plugins/graphql.mjs";
 
   const formatted = await prettier.format("type Query { hello: String }", {
     parser: "graphql",
@@ -64,8 +64,8 @@ Note that the [`unpkg` field](https://unpkg.com/#examples) in Prettier’s `pack
 
 ```js
 define([
-  "https://unpkg.com/prettier@3.5.3/standalone.js",
-  "https://unpkg.com/prettier@3.5.3/plugins/graphql.js",
+  "https://unpkg.com/prettier@3.6.0/standalone.js",
+  "https://unpkg.com/prettier@3.6.0/plugins/graphql.js",
 ], async (prettier, ...plugins) => {
   const formatted = await prettier.format("type Query { hello: String }", {
     parser: "graphql",
@@ -96,8 +96,8 @@ This syntax doesn’t necessarily work in the browser, but it can be used when b
 <TabItem value="module" label="Module worker">
 
 ```js
-import * as prettier from "https://unpkg.com/prettier@3.5.3/standalone.mjs";
-import * as prettierPluginGraphql from "https://unpkg.com/prettier@3.5.31/plugins/graphql.mjs";
+import * as prettier from "https://unpkg.com/prettier@3.6.0/standalone.mjs";
+import * as prettierPluginGraphql from "https://unpkg.com/prettier@3.6.01/plugins/graphql.mjs";
 
 const formatted = await prettier.format("type Query { hello: String }", {
   parser: "graphql",
@@ -110,8 +110,8 @@ const formatted = await prettier.format("type Query { hello: String }", {
 
 ```js
 importScripts(
-  "https://unpkg.com/prettier@3.5.3/standalone.js",
-  "https://unpkg.com/prettier@3.5.3/plugins/graphql.js",
+  "https://unpkg.com/prettier@3.6.0/standalone.js",
+  "https://unpkg.com/prettier@3.6.0/plugins/graphql.js",
 );
 
 (async () => {
@@ -131,9 +131,9 @@ If you want to format [embedded code](options.md#embedded-language-formatting),
 
 ```html
 <script type="module">
-  import * as prettier from "https://unpkg.com/prettier@3.5.3/standalone.mjs";
-  import * as prettierPluginBabel from "https://unpkg.com/prettier@3.5.3/plugins/babel.mjs";
-  import * as prettierPluginEstree from "https://unpkg.com/prettier@3.5.3/plugins/estree.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.6.0/standalone.mjs";
+  import * as prettierPluginBabel from "https://unpkg.com/prettier@3.6.0/plugins/babel.mjs";
+  import * as prettierPluginEstree from "https://unpkg.com/prettier@3.6.0/plugins/estree.mjs";
 
   console.log(
     await prettier.format("const html=/* HTML */ `<DIV> </DIV>`", {
@@ -149,10 +149,10 @@ The HTML code embedded in JavaScript stays unformatted because the `html` parser
 
 ```html
 <script type="module">
-  import * as prettier from "https://unpkg.com/prettier@3.5.3/standalone.mjs";
-  import * as prettierPluginBabel from "https://unpkg.com/prettier@3.5.3/plugins/babel.mjs";
-  import * as prettierPluginEstree from "https://unpkg.com/prettier@3.5.3/plugins/estree.mjs";
-  import * as prettierPluginHtml from "https://unpkg.com/prettier@3.5.3/plugins/html.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.6.0/standalone.mjs";
+  import * as prettierPluginBabel from "https://unpkg.com/prettier@3.6.0/plugins/babel.mjs";
+  import * as prettierPluginEstree from "https://unpkg.com/prettier@3.6.0/plugins/estree.mjs";
+  import * as prettierPluginHtml from "https://unpkg.com/prettier@3.6.0/plugins/html.mjs";
 
   console.log(
     await prettier.format("const html=/* HTML */ `<DIV> </DIV>`", {
diff --git a/website/versioned_docs/version-stable/options.md b/website/versioned_docs/version-stable/options.md
@@ -325,6 +325,7 @@ Valid options:
 - `"vue"` (same parser as `"html"`, but also formats vue-specific syntax) _First available in 1.10.0_
 - `"angular"` (same parser as `"html"`, but also formats angular-specific syntax via [angular-estree-parser](https://github.com/ikatyang/angular-estree-parser)) _First available in 1.15.0_
 - `"lwc"` (same parser as `"html"`, but also formats LWC-specific syntax for unquoted template attributes) _First available in 1.17.0_
+- `"mjml"` (same parser as `"html"`, but also formats MJML-specific syntax) _First available in 3.6.0_
 - `"yaml"` (via [yaml](https://github.com/eemeli/yaml) and [yaml-unist-parser](https://github.com/ikatyang/yaml-unist-parser)) _First available in 1.14.0_
 
 | Default | CLI Override        | API Override         |
@@ -393,6 +394,34 @@ Note that “in tandem” doesn’t mean “at the same time”. When the two op
 
 [adoption strategy]: https://prettier.io/blog/2017/05/03/1.3.0.html#facebook-adoption-update
 
+## Check Ignore Pragma
+
+_First available in v3.6.0_
+
+Prettier can allow individual files to opt out of formatting if they contain a special comment, called a pragma, at the top of the file.
+
+Checking for these markers incurs a small upfront cost during formatting, so it's not enabled by default.
+
+A file with the following as its first comment will **not** be formatted when `--check-ignore-pragma` is supplied:
+
+```js
+/**
+ * @noprettier
+ */
+```
+
+or
+
+```js
+/**
+ * @noformat
+ */
+```
+
+| Default | CLI Override            | API Override                |
+| ------- | ----------------------- | --------------------------- |
+| `false` | `--check-ignore-pragma` | `checkIgnorePragma: <bool>` |
+
 ## Prose Wrap
 
 _First available in v1.8.2_
diff --git a/website/versioned_docs/version-stable/plugins.md b/website/versioned_docs/version-stable/plugins.md
@@ -70,7 +70,7 @@ Strings provided to `plugins` are ultimately passed to [`import()` expression](h
 - [`prettier-plugin-sql-cst`](https://github.com/nene/prettier-plugin-sql-cst) by [**@nene**](https://github.com/nene)
 - [`prettier-plugin-solidity`](https://github.com/prettier-solidity/prettier-plugin-solidity) by [**@mattiaerre**](https://github.com/mattiaerre)
 - [`prettier-plugin-svelte`](https://github.com/sveltejs/prettier-plugin-svelte) by [**@sveltejs**](https://github.com/sveltejs)
-- [`prettier-plugin-toml`](https://github.com/bd82/toml-tools/tree/master/packages/prettier-plugin-toml) by [**@bd82**](https://github.com/bd82)
+- [`prettier-plugin-toml`](https://github.com/un-ts/prettier/tree/master/packages/toml) by [**@JounQin**](https://github.com/JounQin) and [**@so1ve**](https://github.com/so1ve)
 
 ## Developing Plugins
 
@@ -113,6 +113,7 @@ export const parsers = {
     // The name of the AST that the parser produces.
     astFormat: "dance-ast",
     hasPragma,
+    hasIgnorePragma,
     locStart,
     locEnd,
     preprocess,
@@ -138,6 +139,12 @@ _(Optional)_ The pragma detection function (`hasPragma`) should return if the te
 function hasPragma(text: string): boolean;
 ```
 
+_(Optional)_ The "ignore pragma" detection function (`hasIgnorePragma`) should return if the text contains a pragma indicating the text should not be formatted.
+
+```ts
+function hasIgnorePragma(text: string): boolean;
+```
+
 _(Optional)_ The preprocess function can process the input text before passing into `parse` function.
 
 ```ts

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "prettier",`
`3`		`- "version": "3.6.0-dev",`
	`3`	`+ "version": "3.6.0",`
`4`	`4`	`"description": "Prettier is an opinionated code formatter",`
`5`	`5`	`"bin": "./bin/prettier.cjs",`
`6`	`6`	`"repository": "prettier/prettier",`