From c4ab460357478d2b847c60a1efb40098b1181931 Mon Sep 17 00:00:00 2001
From: Sosuke Suzuki <aosukeke@gmail.com>
Date: Sun, 2 Jun 2024 02:01:15 +0900
Subject: [PATCH] Release 3.3.0

---
 .github/ISSUE_TEMPLATE/formatting.md          |  2 +-
 .github/ISSUE_TEMPLATE/integration.md         |  2 +-
 CHANGELOG.md                                  |  6 ++++
 docs/browser.md                               | 32 +++++++++----------
 package.json                                  |  2 +-
 .../versioned_docs/version-stable/browser.md  | 32 +++++++++----------
 .../version-stable/configuration.md           | 16 +++++++---
 .../versioned_docs/version-stable/editors.md  |  2 +-
 .../versioned_docs/version-stable/install.md  |  2 +-
 .../versioned_docs/version-stable/plugins.md  |  6 ++--
 .../version-stable/precommit.md               | 21 ++----------
 11 files changed, 60 insertions(+), 63 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/formatting.md b/.github/ISSUE_TEMPLATE/formatting.md
index bda691f16..a5330db4c 100644
--- 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.2.5**
+**Prettier 3.3.0**
 [Playground link](https://prettier.io/playground/#.....)
 
 ```sh
diff --git a/.github/ISSUE_TEMPLATE/integration.md b/.github/ISSUE_TEMPLATE/integration.md
index 02019b0d4..e1e0e1bb7 100644
--- a/.github/ISSUE_TEMPLATE/integration.md
+++ b/.github/ISSUE_TEMPLATE/integration.md
@@ -20,7 +20,7 @@ BEFORE SUBMITTING AN ISSUE:
 
 **Environments:**
 
-- Prettier Version: 3.2.5
+- Prettier Version: 3.3.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
index 50a755ca7..3f419f156 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+# 3.3.0
+
+[diff](https://github.com/prettier/prettier/compare/3.2.5...3.3.0)
+
+🔗 [Release Notes](https://prettier.io/blog/2024/06/01/3.3.0.html)
+
 # 3.2.5
 
 [diff](https://github.com/prettier/prettier/compare/3.2.4...3.2.5)
diff --git a/docs/browser.md b/docs/browser.md
index dd27f80db..1b9651944 100644
--- a/docs/browser.md
+++ b/docs/browser.md
@@ -18,7 +18,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.2.5/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.3.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.
 
@@ -29,8 +29,8 @@ See below for examples.
 ### Global
 
 ```html
-<script src="https://unpkg.com/prettier@3.2.5/standalone.js"></script>
-<script src="https://unpkg.com/prettier@3.2.5/plugins/graphql.js"></script>
+<script src="https://unpkg.com/prettier@3.3.0/standalone.js"></script>
+<script src="https://unpkg.com/prettier@3.3.0/plugins/graphql.js"></script>
 <script>
   (async () => {
     const formatted = await prettier.format("type Query { hello: String }", {
@@ -47,8 +47,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.2.5/standalone.mjs";
-  import prettierPluginGraphql from "https://unpkg.com/prettier@3.2.5/plugins/graphql.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.3.0/standalone.mjs";
+  import prettierPluginGraphql from "https://unpkg.com/prettier@3.3.0/plugins/graphql.mjs";
 
   const formatted = await prettier.format("type Query { hello: String }", {
     parser: "graphql",
@@ -61,8 +61,8 @@ Note that the [`unpkg` field](https://unpkg.com/#examples) in Prettier’s `pack
 
 ```js
 define([
-  "https://unpkg.com/prettier@3.2.5/standalone.js",
-  "https://unpkg.com/prettier@3.2.5/plugins/graphql.js",
+  "https://unpkg.com/prettier@3.3.0/standalone.js",
+  "https://unpkg.com/prettier@3.3.0/plugins/graphql.js",
 ], async (prettier, ...plugins) => {
   const formatted = await prettier.format("type Query { hello: String }", {
     parser: "graphql",
@@ -90,8 +90,8 @@ This syntax doesn’t necessarily work in the browser, but it can be used when b
 ### Worker
 
 ```js
-importScripts("https://unpkg.com/prettier@3.2.5/standalone.js");
-importScripts("https://unpkg.com/prettier@3.2.5/plugins/graphql.js");
+importScripts("https://unpkg.com/prettier@3.3.0/standalone.js");
+importScripts("https://unpkg.com/prettier@3.3.0/plugins/graphql.js");
 
 (async () => {
   const formatted = await prettier.format("type Query { hello: String }", {
@@ -107,9 +107,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.2.5/standalone.mjs";
-  import prettierPluginBabel from "https://unpkg.com/prettier@3.2.5/plugins/babel.mjs";
-  import prettierPluginEstree from "https://unpkg.com/prettier@3.2.5/plugins/estree.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.3.0/standalone.mjs";
+  import prettierPluginBabel from "https://unpkg.com/prettier@3.3.0/plugins/babel.mjs";
+  import prettierPluginEstree from "https://unpkg.com/prettier@3.3.0/plugins/estree.mjs";
 
   console.log(
     await prettier.format("const html=/* HTML */ `<DIV> </DIV>`", {
@@ -125,10 +125,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.2.5/standalone.mjs";
-  import prettierPluginBabel from "https://unpkg.com/prettier@3.2.5/plugins/babel.mjs";
-  import prettierPluginEstree from "https://unpkg.com/prettier@3.2.5/plugins/estree.mjs";
-  import prettierPluginHtml from "https://unpkg.com/prettier@3.2.5/plugins/html.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.3.0/standalone.mjs";
+  import prettierPluginBabel from "https://unpkg.com/prettier@3.3.0/plugins/babel.mjs";
+  import prettierPluginEstree from "https://unpkg.com/prettier@3.3.0/plugins/estree.mjs";
+  import prettierPluginHtml from "https://unpkg.com/prettier@3.3.0/plugins/html.mjs";
 
   console.log(
     await prettier.format("const html=/* HTML */ `<DIV> </DIV>`", {
diff --git a/package.json b/package.json
index 98c559d15..ebb0ae158 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "prettier",
-  "version": "3.3.0-dev",
+  "version": "3.3.0",
   "description": "Prettier is an opinionated code formatter",
   "bin": "./bin/prettier.cjs",
   "repository": "prettier/prettier",
diff --git a/website/versioned_docs/version-stable/browser.md b/website/versioned_docs/version-stable/browser.md
index 3917f4d8e..d42184aed 100644
--- a/website/versioned_docs/version-stable/browser.md
+++ b/website/versioned_docs/version-stable/browser.md
@@ -19,7 +19,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.2.5/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.3.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.
 
@@ -30,8 +30,8 @@ See below for examples.
 ### Global
 
 ```html
-<script src="https://unpkg.com/prettier@3.2.5/standalone.js"></script>
-<script src="https://unpkg.com/prettier@3.2.5/plugins/graphql.js"></script>
+<script src="https://unpkg.com/prettier@3.3.0/standalone.js"></script>
+<script src="https://unpkg.com/prettier@3.3.0/plugins/graphql.js"></script>
 <script>
   (async () => {
     const formatted = await prettier.format("type Query { hello: String }", {
@@ -48,8 +48,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.2.5/standalone.mjs";
-  import prettierPluginGraphql from "https://unpkg.com/prettier@3.2.5/plugins/graphql.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.3.0/standalone.mjs";
+  import prettierPluginGraphql from "https://unpkg.com/prettier@3.3.0/plugins/graphql.mjs";
 
   const formatted = await prettier.format("type Query { hello: String }", {
     parser: "graphql",
@@ -62,8 +62,8 @@ Note that the [`unpkg` field](https://unpkg.com/#examples) in Prettier’s `pack
 
 ```js
 define([
-  "https://unpkg.com/prettier@3.2.5/standalone.js",
-  "https://unpkg.com/prettier@3.2.5/plugins/graphql.js",
+  "https://unpkg.com/prettier@3.3.0/standalone.js",
+  "https://unpkg.com/prettier@3.3.0/plugins/graphql.js",
 ], async (prettier, ...plugins) => {
   const formatted = await prettier.format("type Query { hello: String }", {
     parser: "graphql",
@@ -91,8 +91,8 @@ This syntax doesn’t necessarily work in the browser, but it can be used when b
 ### Worker
 
 ```js
-importScripts("https://unpkg.com/prettier@3.2.5/standalone.js");
-importScripts("https://unpkg.com/prettier@3.2.5/plugins/graphql.js");
+importScripts("https://unpkg.com/prettier@3.3.0/standalone.js");
+importScripts("https://unpkg.com/prettier@3.3.0/plugins/graphql.js");
 
 (async () => {
   const formatted = await prettier.format("type Query { hello: String }", {
@@ -108,9 +108,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.2.5/standalone.mjs";
-  import prettierPluginBabel from "https://unpkg.com/prettier@3.2.5/plugins/babel.mjs";
-  import prettierPluginEstree from "https://unpkg.com/prettier@3.2.5/plugins/estree.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.3.0/standalone.mjs";
+  import prettierPluginBabel from "https://unpkg.com/prettier@3.3.0/plugins/babel.mjs";
+  import prettierPluginEstree from "https://unpkg.com/prettier@3.3.0/plugins/estree.mjs";
 
   console.log(
     await prettier.format("const html=/* HTML */ `<DIV> </DIV>`", {
@@ -126,10 +126,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.2.5/standalone.mjs";
-  import prettierPluginBabel from "https://unpkg.com/prettier@3.2.5/plugins/babel.mjs";
-  import prettierPluginEstree from "https://unpkg.com/prettier@3.2.5/plugins/estree.mjs";
-  import prettierPluginHtml from "https://unpkg.com/prettier@3.2.5/plugins/html.mjs";
+  import * as prettier from "https://unpkg.com/prettier@3.3.0/standalone.mjs";
+  import prettierPluginBabel from "https://unpkg.com/prettier@3.3.0/plugins/babel.mjs";
+  import prettierPluginEstree from "https://unpkg.com/prettier@3.3.0/plugins/estree.mjs";
+  import prettierPluginHtml from "https://unpkg.com/prettier@3.3.0/plugins/html.mjs";
 
   console.log(
     await prettier.format("const html=/* HTML */ `<DIV> </DIV>`", {
diff --git a/website/versioned_docs/version-stable/configuration.md b/website/versioned_docs/version-stable/configuration.md
index 23a58f641..694e94810 100644
--- a/website/versioned_docs/version-stable/configuration.md
+++ b/website/versioned_docs/version-stable/configuration.md
@@ -6,7 +6,7 @@ original_id: configuration
 
 You can configure Prettier via (in order of precedence):
 
-- A `"prettier"` key in your `package.json` file.
+- A `"prettier"` key in your `package.json`, or [`package.yaml`](https://github.com/pnpm/pnpm/pull/1799) file.
 - A `.prettierrc` file written in JSON or YAML.
 - A `.prettierrc.json`, `.prettierrc.yml`, `.prettierrc.yaml`, or `.prettierrc.json5` file.
 - A `.prettierrc.js`, or `prettier.config.js` file that exports an object using `export default` or `module.exports` (depends on the [`type`](https://nodejs.org/api/packages.html#type) value in your `package.json`).
@@ -33,12 +33,15 @@ JSON:
 }
 ```
 
-JS(ESM):
+JS (ES Modules):
 
 ```js
 // prettier.config.js, .prettierrc.js, prettier.config.mjs, or .prettierrc.mjs
 
-/** @type {import("prettier").Config} */
+/**
+ * @see https://prettier.io/docs/en/configuration.html
+ * @type {import("prettier").Config}
+ */
 const config = {
   trailingComma: "es5",
   tabWidth: 4,
@@ -49,12 +52,15 @@ const config = {
 export default config;
 ```
 
-JS(CommonJS):
+JS (CommonJS):
 
 ```js
 // prettier.config.js, .prettierrc.js, prettier.config.cjs, or .prettierrc.cjs
 
-/** @type {import("prettier").Config} */
+/**
+ * @see https://prettier.io/docs/en/configuration.html
+ * @type {import("prettier").Config}
+ */
 const config = {
   trailingComma: "es5",
   tabWidth: 4,
diff --git a/website/versioned_docs/version-stable/editors.md b/website/versioned_docs/version-stable/editors.md
index 48ccf22f2..721360f5f 100644
--- a/website/versioned_docs/version-stable/editors.md
+++ b/website/versioned_docs/version-stable/editors.md
@@ -30,7 +30,7 @@ For more details see [the Vim setup guide](vim.md).
 
 A formatter can be specified in your [Helix language configuration](https://docs.helix-editor.com/languages.html#language-configuration), which will take precedence over any language servers.
 
-For more details see the [Helix external binary formatter configuration for Prettier](https://github.com/helix-editor/helix/wiki/External-binary-formatter-configuration#prettier).
+For more details see the [Helix external binary formatter configuration for Prettier](https://github.com/helix-editor/helix/wiki/External-formatter-configuration#prettier).
 
 ## Sublime Text
 
diff --git a/website/versioned_docs/version-stable/install.md b/website/versioned_docs/version-stable/install.md
index 3ea702512..90644b95f 100644
--- a/website/versioned_docs/version-stable/install.md
+++ b/website/versioned_docs/version-stable/install.md
@@ -163,7 +163,7 @@ For example, you can do the following to have Prettier run before each commit:
    ```bash
    bun add --dev husky lint-staged
    bunx husky init
-   bun --eval "fs.writeFileSync('.husky/pre-commit','pnpm exec lint-staged\n')"
+   bun --eval "fs.writeFileSync('.husky/pre-commit','bunx lint-staged\n')"
    ```
 
    <!--END_DOCUSAURUS_CODE_TABS-->
diff --git a/website/versioned_docs/version-stable/plugins.md b/website/versioned_docs/version-stable/plugins.md
index 9a6006052..4bfcab7b1 100644
--- a/website/versioned_docs/version-stable/plugins.md
+++ b/website/versioned_docs/version-stable/plugins.md
@@ -203,7 +203,7 @@ function print(
 
 The `print` function is passed the following parameters:
 
-- **`path`**: An object, which can be used to access nodes in the AST. It’s a stack-like data structure that maintains the current state of the recursion. It is called “path” because it represents the path to the current node from the root of the AST. The current node is returned by `path.getValue()`.
+- **`path`**: An object, which can be used to access nodes in the AST. It’s a stack-like data structure that maintains the current state of the recursion. It is called “path” because it represents the path to the current node from the root of the AST. The current node is returned by `path.node`.
 - **`options`**: A persistent object, which contains global options and which a plugin may mutate to store contextual data.
 - **`print`**: A callback for printing sub-nodes. This function contains the core printing logic that consists of steps whose implementation is provided by plugins. In particular, it calls the printer’s `print` function and passes itself to it. Thus, the two `print` functions – the one from the core and the one from the plugin – call each other while descending down the AST recursively.
 
@@ -215,7 +215,7 @@ import { doc } from "prettier";
 const { group, indent, join, line, softline } = doc.builders;
 
 function print(path, options, print) {
-  const node = path.getValue();
+  const node = path.node;
 
   switch (node.type) {
     case "list":
@@ -282,7 +282,7 @@ For example, a plugin that has nodes with embedded JavaScript might have the fol
 
 ```js
 function embed(path, options) {
-  const node = path.getValue();
+  const node = path.node;
   if (node.type === "javascript") {
     return async (textToDoc) => {
       return [
diff --git a/website/versioned_docs/version-stable/precommit.md b/website/versioned_docs/version-stable/precommit.md
index 214d75035..625d117c6 100644
--- a/website/versioned_docs/version-stable/precommit.md
+++ b/website/versioned_docs/version-stable/precommit.md
@@ -20,22 +20,7 @@ This will install [husky](https://github.com/typicode/husky) and [lint-staged](h
 
 Read more at the [lint-staged](https://github.com/okonet/lint-staged#configuration) repo.
 
-## Option 2. [pre-commit](https://github.com/pre-commit/pre-commit)
-
-**Use Case:** Great when working with multi-language projects.
-
-Copy the following config into your `.pre-commit-config.yaml` file:
-
-```yaml
-- repo: https://github.com/pre-commit/mirrors-prettier
-  rev: "" # Use the sha or tag you want to point at
-  hooks:
-    - id: prettier
-```
-
-Read more at [mirror of prettier package for pre-commit](https://github.com/pre-commit/mirrors-prettier) and the [pre-commit](https://pre-commit.com) website.
-
-## Option 3. [Husky.Net](https://github.com/alirezanet/Husky.Net)
+## Option 2. [Husky.Net](https://github.com/alirezanet/Husky.Net)
 
 **Use Case:** A dotnet solution to use Prettier along with other code quality tools (e.g. dotnet-format, ESLint, Stylelint, etc.). It supports multiple file states (staged - last-commit, git-files etc.)
 
@@ -56,7 +41,7 @@ after installation you can add prettier task to the `task-runner.json`.
 }
 ```
 
-## Option 4. [git-format-staged](https://github.com/hallettj/git-format-staged)
+## Option 3. [git-format-staged](https://github.com/hallettj/git-format-staged)
 
 **Use Case:** Great for when you want to format partially-staged files, and other options do not provide a good fit for your project.
 
@@ -108,7 +93,7 @@ Add or remove file extensions to suit your project. Note that regardless of whic
 
 To read about how git-format-staged works see [Automatic Code Formatting for Partially-Staged Files](https://www.olioapps.com/blog/automatic-code-formatting/).
 
-## Option 5. Shell script
+## Option 4. Shell script
 
 Alternately you can save this script as `.git/hooks/pre-commit` and give it execute permission: