prettier/prettier (prettier)
### [`v3.3.3`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#333)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.3.2...3.3.3)
[diff](https://togithub.com/prettier/prettier/compare/3.3.2...3.3.3)
##### Add parentheses for nullish coalescing in ternary ([#16391](https://togithub.com/prettier/prettier/pull/16391) by [@cdignam-segment](https://togithub.com/cdignam-segment))
This change adds clarity to operator precedence.
```js
// Input
foo ? bar ?? foo : baz;
foo ?? bar ? a : b;
a ? b : foo ?? bar;
// Prettier 3.3.2
foo ? bar ?? foo : baz;
foo ?? bar ? a : b;
a ? b : foo ?? bar;
// Prettier 3.3.3
foo ? (bar ?? foo) : baz;
(foo ?? bar) ? a : b;
a ? b : (foo ?? bar);
```
##### Add parentheses for decorator expressions ([#16458](https://togithub.com/prettier/prettier/pull/16458) by [@y-schneider](https://togithub.com/y-schneider))
Prevent parentheses around member expressions or tagged template literals from being removed to follow the stricter parsing rules of TypeScript 5.5.
```ts
// Input
@(foo`tagged template`)
class X {}
// Prettier 3.3.2
@foo`tagged template`
class X {}
// Prettier 3.3.3
@(foo`tagged template`)
class X {}
```
##### Support `@let` declaration syntax ([#16474](https://togithub.com/prettier/prettier/pull/16474) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
Adds support for Angular v18 `@let` declaration syntax.
Please see the following code example. The `@let` declaration allows you to define local variables within the template:
```html
@let name = 'Frodo';
Dashboard for {{name}}
Hello, {{name}}
```
For more details, please refer to the excellent blog post by the Angular Team: [Introducing @let in Angular](https://blog.angular.dev/introducing-let-in-angular-686f9f383f0f).
We also appreciate the Angular Team for kindly answering our questions to implement this feature.
### [`v3.3.2`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#332)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.3.1...3.3.2)
[diff](https://togithub.com/prettier/prettier/compare/3.3.1...3.3.2)
##### Fix handlebars path expressions starts with `@` ([#16358](https://togithub.com/prettier/prettier/pull/16358) by [@Princeyadav05](https://togithub.com/Princeyadav05))
```hbs
{{! Input }}
{{@x.y.z}}
{{! Prettier 3.3.1 }}
{{@x}}
{{! Prettier 3.3.2 }}
{{@x.y.z}}
```
### [`v3.3.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#331)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.3.0...3.3.1)
[diff](https://togithub.com/prettier/prettier/compare/3.3.0...3.3.1)
##### Preserve empty lines in front matter ([#16347](https://togithub.com/prettier/prettier/pull/16347) by [@fisker](https://togithub.com/fisker))
```markdown
---
foo:
- bar1
- bar2
- bar3
---
Markdown
---
foo:
- bar1
- bar2
- bar3
---
Markdown
---
foo:
- bar1
- bar2
- bar3
---
Markdown
```
##### Preserve explicit language in front matter ([#16348](https://togithub.com/prettier/prettier/pull/16348) by [@fisker](https://togithub.com/fisker))
```markdown
---yaml
title: Hello
slug: home
---
---
title: Hello
slug: home
---
---yaml
title: Hello
slug: home
---
```
##### Avoid line breaks in import attributes ([#16349](https://togithub.com/prettier/prettier/pull/16349) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
import something from "./some-very-very-very-very-very-very-very-very-long-path.json" with { type: "json" };
// Prettier 3.3.0
import something from "./some-very-very-very-very-very-very-very-very-long-path.json" with { type:
"json" };
// Prettier 3.3.1
import something from "./some-very-very-very-very-very-very-very-very-long-path.json" with { type: "json" };
```
### [`v3.3.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#330)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.2.5...3.3.0)
[diff](https://togithub.com/prettier/prettier/compare/3.2.5...3.3.0)
🔗 [Release Notes](https://prettier.io/blog/2024/06/01/3.3.0.html)
### [`v3.2.5`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#325)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.2.4...3.2.5)
[diff](https://togithub.com/prettier/prettier/compare/3.2.4...3.2.5)
##### Support Angular inline styles as single template literal ([#15968](https://togithub.com/prettier/prettier/pull/15968) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
[Angular v17](https://blog.angular.io/introducing-angular-v17-4d7033312e4b) supports single string inline styles.
```ts
// Input
@Component({
template: `
`,
})
export class AppComponent {}
```
##### Use `"json"` parser for `tsconfig.json` by default ([#16012](https://togithub.com/prettier/prettier/pull/16012) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
In [v2.3.0](https://prettier.io/blog/2024/01/12/3.2.0#new-jsonc-parser-added-15831httpsgithubcomprettierprettierpull15831-by-fiskerhttpsgithubcomfisker), we introduced `"jsonc"` parser which adds trialing comma **by default**.
When adding a new parser we also define how it will be used based on the [`linguist-languages`](https://www.npmjs.com/package/linguist-languages) data.
`tsconfig.json` is a special file used by [TypeScript](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html#using-tsconfigjson-or-jsconfigjson), it uses `.json` file extension, but it actually uses the [JSON with Comments](https://code.visualstudio.com/docs/languages/json#\_json-with-comments) syntax. However, we found that there are many third-party tools not recognize it correctly because of the confusing `.json` file extension.
We decide to treat it as a JSON file for now to avoid the extra configuration step.
To keep using the `"jsonc"` parser for your `tsconfig.json` files, add the following to your `.pretterrc` file
```json
{
"overrides": [
{
"files": ["tsconfig.json", "jsconfig.json"],
"options": {
"parser": "jsonc"
}
}
]
}
```
```
```
### [`v3.2.4`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#324)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.2.3...3.2.4)
[diff](https://togithub.com/prettier/prettier/compare/3.2.3...3.2.4)
##### Fix incorrect parser inference ([#15947](https://togithub.com/prettier/prettier/pull/15947) by [@fisker](https://togithub.com/fisker))
Files like `.eslintrc.json` were incorrectly formatted as JSONC files.
```jsx
// Input
prettier --file-info .eslintrc.json
{ "ignored": false, "inferredParser": "jsonc" }
// Prettier 3.2.4
prettier --file-info .eslintrc.json
{ "ignored": false, "inferredParser": "json" }
```
### [`v3.2.3`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#323)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.2.2...3.2.3)
[diff](https://togithub.com/prettier/prettier/compare/3.2.2...3.2.3)
##### Throw errors for invalid code ([#15881](https://togithub.com/prettier/prettier/pull/15881) by [@fisker](https://togithub.com/fisker), [@Josh-Cena](https://togithub.com/Josh-Cena), [@auvred](https://togithub.com/auvred))
```ts
// Input
1++;
// Prettier 3.2.2
1++;
// Prettier 3.2.3
SyntaxError: Invalid left-hand side expression in unary operation (1:1)
> 1 | 1++;
| ^
```
```ts
// Input
try {} catch (error = 1){}
// Prettier 3.2.2
try {
} catch (error) {}
// Prettier 3.2.3
SyntaxError: Catch clause variable cannot have an initializer. (1:23)
> 1 | try {} catch (error = 1){}
| ^
```
##### Fix parser inference ([#15927](https://togithub.com/prettier/prettier/pull/15927) by [@fisker](https://togithub.com/fisker))
```console
// Prettier 3.2.2
prettier --file-info tsconfig.json
{ "ignored": false, "inferredParser": "json" }
// Prettier 3.2.3
prettier --file-info tsconfig.json
{ "ignored": false, "inferredParser": "jsonc" }
```
### [`v3.2.2`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#322)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.2.1...3.2.2)
[diff](https://togithub.com/prettier/prettier/compare/3.2.1...3.2.2)
##### Fix crash when parsing template literal CSS in a JSX style tag using a spread attribute ([#15896](https://togithub.com/prettier/prettier/pull/15896) by [@eelco](https://togithub.com/eelco))
For example this code would crash before:
```jsx
```
##### Fix formatting error on optional call expression and member chain ([#15920](https://togithub.com/prettier/prettier/pull/15920) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
```jsx
// Input
a(() => {}, c?.d());
// Prettier 3.2.1
TypeError: Cannot read properties of undefined (reading 'type')
// Prettier 3.2.2
a(() => {}, c?.d());
```
### [`v3.2.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#321)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.2.0...3.2.1)
[diff](https://togithub.com/prettier/prettier/compare/3.2.0...3.2.1)
##### Fix formatting error on member chain ([#15915](https://togithub.com/prettier/prettier/pull/15915) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
```jsx
// Input
test().test2().test2(thing?.something);
// Prettier 3.2.0
TypeError: Cannot read properties of undefined (reading 'type')
// Prettier 3.2.1
test().test2().test2(thing?.something);
```
### [`v3.2.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#320)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.1.1...3.2.0)
[diff](https://togithub.com/prettier/prettier/compare/3.1.1...3.2.0)
🔗 [Release Notes](https://prettier.io/blog/2024/01/13/3.2.0.html)
### [`v3.1.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#311)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.1.0...3.1.1)
[diff](https://togithub.com/prettier/prettier/compare/3.1.0...3.1.1)
##### Fix config file search ([#15363](https://togithub.com/prettier/prettier/pull/15363) by [@fisker](https://togithub.com/fisker))
Previously, we start search for config files from the filePath as a directory, if it happened to be a directory and contains config file, it will be used by mistake.
```text
├─ .prettierrc
└─ test.js (A directory)
└─ .prettierrc
```
```js
// Prettier 3.1.0
await prettier.resolveConfigFile(new URL("./test.js", import.meta.url));
// /test.js/.prettierrc
// Prettier 3.1.1
await prettier.resolveConfigFile(new URL("./test.js", import.meta.url));
// /.prettierrc
```
##### Skip explicitly passed symbolic links with `--no-error-on-unmatched-pattern` ([#15533](https://togithub.com/prettier/prettier/pull/15533) by [@sanmai-NL](https://togithub.com/sanmai-NL))
Since Prettier v3, we stopped following symbolic links, however in some use cases, the symbolic link patterns can't be filtered out, and there is no way to prevent Prettier from throwing errors.
In Prettier 3.1.1, you can use `--no-error-on-unmatched-pattern` to simply skip symbolic links.
##### Consistently use tabs in ternaries when `useTabs` is `true` ([#15662](https://togithub.com/prettier/prettier/pull/15662) by [@auvred](https://togithub.com/auvred))
```jsx
// Input
aaaaaaaaaaaaaaa
? bbbbbbbbbbbbbbbbbb
: ccccccccccccccc
? ddddddddddddddd
: eeeeeeeeeeeeeee
? fffffffffffffff
: gggggggggggggggg;
// Prettier 3.1.0
aaaaaaaaaaaaaaa
? bbbbbbbbbbbbbbbbbb
: ccccccccccccccc
? ddddddddddddddd
: eeeeeeeeeeeeeee
? fffffffffffffff
: gggggggggggggggg;
// Prettier 3.1.1
aaaaaaaaaaaaaaa
? bbbbbbbbbbbbbbbbbb
: ccccccccccccccc
? ddddddddddddddd
: eeeeeeeeeeeeeee
? fffffffffffffff
: gggggggggggggggg;
```
##### Improve config file search ([#15663](https://togithub.com/prettier/prettier/pull/15663) by [@fisker](https://togithub.com/fisker))
The Prettier config file search performance has been improved by more effective cache strategy.
##### Fix unstable and ugly formatting for comments in destructuring patterns ([#15708](https://togithub.com/prettier/prettier/pull/15708) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
```tsx
// Input
const {
foo,
// bar
// baz
}: Foo = expr;
// Prettier 3.1.0
const {
foo1,
} // bar
// baz
: Foo = expr;
// Prettier 3.1.0 second output
const {
foo1, // bar
} // baz
: Foo = expr;
// Prettier 3.1.1
const {
foo1,
// bar
// baz
}: Foo = expr;
```
##### Support "Import Attributes" ([#15718](https://togithub.com/prettier/prettier/pull/15718) by [@fisker](https://togithub.com/fisker))
[TypeScript 5.3](https://devblogs.microsoft.com/typescript/announcing-typescript-5-3/#import-attributes) supports the latest updates to the [import attributes](https://togithub.com/tc39/proposal-import-attributes) proposal.
```tsx
import something from "./something.json" with { type: "json" };
```
##### Fix false claim in docs that cursorOffset is incompatible with rangeStart/rangeEnd ([#15750](https://togithub.com/prettier/prettier/pull/15750) by [@ExplodingCabbage](https://togithub.com/ExplodingCabbage))
The cursorOffset option has in fact been compatible with rangeStart/rangeEnd for over 5 years, thanks to work by [@ds300](https://togithub.com/ds300). However, Prettier's documentation (including the CLI `--help` text) continued to claim otherwise, falsely. The documentation is now fixed.
##### Keep curly braces and `from` keyword in empty `import` statements ([#15756](https://togithub.com/prettier/prettier/pull/15756) by [@fisker](https://togithub.com/fisker))
```js
// Input
import { } from 'foo';
import { /* comment */ } from 'bar';
// Prettier 3.1.0
import {} from "foo";
import /* comment */ "bar";
// Prettier 3.1.1
import {} from "foo";
import {} from /* comment */ "bar";
```
##### Keep empty import attributes and assertions ([#15757](https://togithub.com/prettier/prettier/pull/15757) by [@fisker](https://togithub.com/fisker))
```js
// Input
import foo from "foo" with {};
import bar from "bar" assert {};
// Prettier 3.1.0
import foo from "foo";
import bar from "bar";
// Prettier 3.1.1
import foo from "foo" with {};
import bar from "bar" assert {};
```
### [`v3.1.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#310)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.0.3...3.1.0)
[diff](https://togithub.com/prettier/prettier/compare/3.0.3...3.1.0)
🔗 [Release Notes](https://prettier.io/blog/2023/11/13/3.1.0.html)
### [`v3.0.3`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#303)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.0.2...3.0.3)
[diff](https://togithub.com/prettier/prettier/compare/3.0.2...3.0.3)
##### Add `preferUnplugged: true` to `package.json` ([#15169](https://togithub.com/prettier/prettier/pull/15169) by [@fisker](https://togithub.com/fisker) and [@so1ve](https://togithub.com/so1ve))
Prettier v3 uses dynamic imports, user [will need to unplug Prettier](https://togithub.com/yarnpkg/berry/pull/5411#issuecomment-1523502224) when Yarn's PnP mode is enabled, add [`preferUnplugged: true`](https://yarnpkg.com/configuration/manifest#preferUnplugged) to `package.json`, so Yarn will install Prettier as unplug by default.
##### Support shared config that forbids `require()` ([#15233](https://togithub.com/prettier/prettier/pull/15233) by [@fisker](https://togithub.com/fisker))
If an external shared config package is used, and the package `exports` don't have `require` or `default` export.
In Prettier 3.0.2 Prettier fails when attempt to `require()` the package, and throws an error.
```text
Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined in /package.json
```
##### Allow argument of `require()` to break ([#15256](https://togithub.com/prettier/prettier/pull/15256) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
const plugin = require(
global.STANDALONE
? path.join(__dirname, "../standalone.js")
: path.join(__dirname, "..")
);
// Prettier 3.0.2
const plugin = require(global.STANDALONE
? path.join(__dirname, "../standalone.js")
: path.join(__dirname, ".."));
// Prettier 3.0.3
const plugin = require(
global.STANDALONE
? path.join(__dirname, "../standalone.js")
: path.join(__dirname, "..")
);
```
##### Do not print trailing commas in arrow function type parameter lists in `ts` code blocks ([#15286](https://togithub.com/prettier/prettier/pull/15286) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
````md
```ts
const foo = () => {}
```
```ts
const foo = () => {}
```
```ts
const foo = () => {}
```
````
##### Support TypeScript 5.2 `using` / `await using` declaration ([#15321](https://togithub.com/prettier/prettier/pull/15321) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
Support for the upcoming Explicit Resource Management feature in ECMAScript. [`using` / `await using` declaration](https://devblogs.microsoft.com/typescript/announcing-typescript-5-2/#using-declarations-and-explicit-resource-management)
```tsx
{
using foo = new Foo();
await using bar = new Bar();
}
```
### [`v3.0.2`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#302)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.0.1...3.0.2)
[diff](https://togithub.com/prettier/prettier/compare/3.0.1...3.0.2)
##### Break after `=` of assignment if RHS is poorly breakable AwaitExpression or YieldExpression ([#15204](https://togithub.com/prettier/prettier/pull/15204) by [@seiyab](https://togithub.com/seiyab))
```js
// Input
const { section, rubric, authors, tags } = await utils.upsertCommonData(mainData);
// Prettier 3.0.1
const { section, rubric, authors, tags } = await utils.upsertCommonData(
mainData,
);
// Prettier 3.0.2
const { section, rubric, authors, tags } =
await utils.upsertCommonData(mainData);
```
##### Do not add trailing comma for grouped scss comments ([#15217](https://togithub.com/prettier/prettier/pull/15217) by [@auvred](https://togithub.com/auvred))
```scss
/* Input */
$foo: (
'property': (),
// comment 1
// comment 2
)
/* Prettier 3.0.1 */
$foo: (
"property": (),
// comment 1
// comment 2,
);
/* Prettier 3.0.2 */
$foo: (
"property": (),
// comment 1
// comment 2
);
```
##### Print `declare` and `export` keywords for nested namespace ([#15249](https://togithub.com/prettier/prettier/pull/15249) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
```tsx
// Input
declare namespace abc1.def {}
export namespace abc2.def {}
// Prettier 3.0.1
namespace abc1.def {}
namespace abc2.def {}
// Prettier 3.0.2
declare namespace abc1.def {}
export namespace abc2.def {}
```
### [`v3.0.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#301)
[Compare Source](https://togithub.com/prettier/prettier/compare/3.0.0...3.0.1)
[diff](https://togithub.com/prettier/prettier/compare/3.0.0...3.0.1)
##### Fix cursor positioning for a special case ([#14812](https://togithub.com/prettier/prettier/pull/14812) by [@fisker](https://togithub.com/fisker))
```js
// <|> is the cursor position
/* Input */
// All messages are represented in JSON.
// So, the prettier.py controls a subprocess which spawns "node {this_file}".
import {<|> } from "fs"
/* Prettier 3.0.0 */
// All messages are represented in JSON.
// So, the prettier.py <|>controls a subprocess which spawns "node {this_file}".
import {} from "fs"
/* Prettier 3.0.1 */
// All messages are represented in JSON.
// So, the prettier.py controls a subprocess which spawns "node {this_file}".
import {<|>} from "fs"
```
##### Fix plugins/estree.d.ts to make it a module ([#15018](https://togithub.com/prettier/prettier/pull/15018) by [@kingyue737](https://togithub.com/kingyue737))
Add `export {}` in `plugins/estree.d.ts` to fix the "File is not a module" error
##### Add parenthesis around leading multiline comment in return statement ([#15037](https://togithub.com/prettier/prettier/pull/15037) by [@auvred](https://togithub.com/auvred))
```jsx
// Input
function fn() {
return (
/**
* @type {...}
*/ expresssion
)
}
// Prettier 3.0.0
function fn() {
return /**
* @type {...}
*/ expresssion;
}
// Prettier 3.0.1
function fn() {
return (
/**
* @type {...}
*/ expresssion
);
}
```
##### Add support for Vue "Generic Components" ([#15066](https://togithub.com/prettier/prettier/pull/15066) by [@auvred](https://togithub.com/auvred))
https://blog.vuejs.org/posts/vue-3-3#generic-components
```vue
```
##### Fix comments print in `IfStatement` ([#15076](https://togithub.com/prettier/prettier/pull/15076) by [@fisker](https://togithub.com/fisker))
```js
function a(b) {
if (b) return 1; // comment
else return 2;
}
/* Prettier 3.0.0 */
Error: Comment "comment" was not printed. Please report this error!
/* Prettier 3.0.1 */
function a(b) {
if (b) return 1; // comment
else return 2;
}
```
##### Add missing type definition for `printer.preprocess` ([#15123](https://togithub.com/prettier/prettier/pull/15123) by [@so1ve](https://togithub.com/so1ve))
```diff
export interface Printer {
// ...
+ preprocess?:
+ | ((ast: T, options: ParserOptions) => T | Promise)
+ | undefined;
}
```
##### Add missing `getVisitorKeys` method type definition for `Printer` ([#15125](https://togithub.com/prettier/prettier/pull/15125) by [@auvred](https://togithub.com/auvred))
```tsx
const printer: Printer = {
print: () => [],
getVisitorKeys(node, nonTraversableKeys) {
return ["body"];
},
};
```
##### Add typing to support `readonly` array properties of AST Node ([#15127](https://togithub.com/prettier/prettier/pull/15127) by [@auvred](https://togithub.com/auvred))
```tsx
// Input
interface TestNode {
readonlyArray: readonly string[];
}
declare const path: AstPath;
path.map(() => "", "readonlyArray");
// Prettier 3.0.0
interface TestNode {
readonlyArray: readonly string[];
}
declare const path: AstPath;
path.map(() => "", "readonlyArray");
// ^ Argument of type '"readonlyArray"' is not assignable to parameter of type '"regularArray"'. ts(2345)
// Prettier 3.0.1
interface TestNode {
readonlyArray: readonly string[];
}
declare const path: AstPath;
path.map(() => "", "readonlyArray");
```
##### Add space before unary minus followed by a function call ([#15129](https://togithub.com/prettier/prettier/pull/15129) by [@pamelalozano](https://togithub.com/pamelalozano))
```less
// Input
div {
margin: - func();
}
// Prettier 3.0.0
div {
margin: -func();
}
// Prettier 3.0.1
div {
margin: - func();
}
```
### [`v3.0.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#300)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.8...3.0.0)
[diff](https://togithub.com/prettier/prettier/compare/3.0.0-alpha.6...3.0.0)
🔗 [Release Notes](https://prettier.io/blog/2023/07/05/3.0.0.html)
### [`v2.8.8`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#288)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.7...2.8.8)
This version is a republished version of v2.8.7.
A bad version was accidentally published and [it can't be unpublished](https://togithub.com/npm/cli/issues/1686), apologies for the churn.
### [`v2.8.7`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#287)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.6...2.8.7)
[diff](https://togithub.com/prettier/prettier/compare/2.8.6...2.8.7)
##### Allow multiple decorators on same getter/setter ([#14584](https://togithub.com/prettier/prettier/pull/14584) by [@fisker](https://togithub.com/fisker))
```ts
// Input
class A {
@decorator()
get foo () {}
@decorator()
set foo (value) {}
}
// Prettier 2.8.6
SyntaxError: Decorators cannot be applied to multiple get/set accessors of the same name. (5:3)
3 | get foo () {}
4 |
> 5 | @decorator()
| ^^^^^^^^^^^^
6 | set foo (value) {}
7 | }
// Prettier 2.8.7
class A {
@decorator()
get foo() {}
@decorator()
set foo(value) {}
}
```
### [`v2.8.6`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#286)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.5...2.8.6)
[diff](https://togithub.com/prettier/prettier/compare/2.8.5...2.8.6)
##### Allow decorators on private members and class expressions ([#14548](https://togithub.com/prettier/prettier/pull/14548) by [@fisker](https://togithub.com/fisker))
```ts
// Input
class A {
@decorator()
#privateMethod () {}
}
// Prettier 2.8.5
SyntaxError: Decorators are not valid here. (2:3)
1 | class A {
> 2 | @decorator()
| ^^^^^^^^^^^^
3 | #privateMethod () {}
4 | }
// Prettier 2.8.6
class A {
@decorator()
#privateMethod() {}
}
```
### [`v2.8.5`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#285)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.4...2.8.5)
[diff](https://togithub.com/prettier/prettier/compare/2.8.4...2.8.5)
##### Support TypeScript 5.0 ([#14391](https://togithub.com/prettier/prettier/pull/14391) by [@fisker](https://togithub.com/fisker), [#13819](https://togithub.com/prettier/prettier/pull/13819) by [@fisker](https://togithub.com/fisker), [@sosukesuzuki](https://togithub.com/sosukesuzuki))
TypeScript 5.0 introduces two new syntactic features:
- `const` modifiers for type parameters
- `export type *` declarations
##### Add missing parentheses for decorator ([#14393](https://togithub.com/prettier/prettier/pull/14393) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
class Person {
@(myDecoratorArray[0])
greet() {}
}
// Prettier 2.8.4
class Person {
@myDecoratorArray[0]
greet() {}
}
// Prettier 2.8.5
class Person {
@(myDecoratorArray[0])
greet() {}
}
```
##### Add parentheses for `TypeofTypeAnnotation` to improve readability ([#14458](https://togithub.com/prettier/prettier/pull/14458) by [@fisker](https://togithub.com/fisker))
```tsx
// Input
type A = (typeof node.children)[];
// Prettier 2.8.4
type A = typeof node.children[];
// Prettier 2.8.5
type A = (typeof node.children)[];
```
##### Support `max_line_length=off` when parsing `.editorconfig` ([#14516](https://togithub.com/prettier/prettier/pull/14516) by [@josephfrazier](https://togithub.com/josephfrazier))
If an .editorconfig file is in your project and it sets `max_line_length=off` for the file you're formatting,
it will be interpreted as a `printWidth` of `Infinity` rather than being ignored
(which previously resulted in the default `printWidth` of 80 being applied, if not overridden by Prettier-specific configuration).
```html
;
;
```
### [`v2.8.4`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#284)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.3...2.8.4)
[diff](https://togithub.com/prettier/prettier/compare/2.8.3...2.8.4)
##### Fix leading comments in mapped types with `readonly` ([#13427](https://togithub.com/prettier/prettier/pull/13427) by [@thorn0](https://togithub.com/thorn0), [@sosukesuzuki](https://togithub.com/sosukesuzuki))
```tsx
// Input
type Type = {
// comment
readonly [key in Foo];
};
// Prettier 2.8.3
type Type = {
readonly // comment
[key in Foo];
};
// Prettier 2.8.4
type Type = {
// comment
readonly [key in Foo];
};
```
##### Group params in opening block statements ([#14067](https://togithub.com/prettier/prettier/pull/14067) by [@jamescdavis](https://togithub.com/jamescdavis))
This is a follow-up to [#13930](https://togithub.com/prettier/prettier/issues/13930) to establish wrapping consistency between opening block statements and else blocks by
grouping params in opening blocks. This causes params to break to a new line together and not be split across lines
unless the length of params exceeds the print width. This also updates the else block wrapping to behave exactly the
same as opening blocks.
```hbs
{{! Input }}
{{#block param param param param param param param param param param as |blockParam|}}
Hello
{{else block param param param param param param param param param param as |blockParam|}}
There
{{/block}}
{{! Prettier 2.8.3 }}
{{#block
param
param
param
param
param
param
param
param
param
param
as |blockParam|
}}
Hello
{{else block param
param
param
param
param
param
param
param
param
param}}
There
{{/block}}
{{! Prettier 2.8.4 }}
{{#block
param param param param param param param param param param
as |blockParam|
}}
Hello
{{else block
param param param param param param param param param param
as |blockParam|
}}
There
{{/block}}
```
##### Ignore files in `.sl/` ([#14206](https://togithub.com/prettier/prettier/pull/14206) by [@bolinfest](https://togithub.com/bolinfest))
In [Sapling SCM](https://sapling-scm.com/), `.sl/` is the folder where it stores its state, analogous to `.git/` in Git. It should be ignored in Prettier like the other SCM folders.
##### Recognize `@satisfies` in Closure-style type casts ([#14262](https://togithub.com/prettier/prettier/pull/14262) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
const a = /** @satisfies {Record} */ ({hello: 1337});
const b = /** @type {Record} */ ({hello: 1337});
// Prettier 2.8.3
const a = /** @satisfies {Record} */ { hello: 1337 };
const b = /** @type {Record} */ ({ hello: 1337 });
// Prettier 2.8.4
const a = /** @satisfies {Record} */ ({hello: 1337});
const b = /** @type {Record} */ ({hello: 1337});
```
##### Fix parens in inferred function return types with `extends` ([#14279](https://togithub.com/prettier/prettier/pull/14279) by [@fisker](https://togithub.com/fisker))
```ts
// Input
type Foo = T extends ((a) => a is infer R extends string) ? R : never;
// Prettier 2.8.3 (First format)
type Foo = T extends (a) => a is infer R extends string ? R : never;
// Prettier 2.8.3 (Second format)
SyntaxError: '?' expected.
// Prettier 2.8.4
type Foo = T extends ((a) => a is infer R extends string) ? R : never;
```
### [`v2.8.3`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#283)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.2...2.8.3)
[diff](https://togithub.com/prettier/prettier/compare/2.8.2...2.8.3)
##### Allow self-closing tags on custom elements ([#14170](https://togithub.com/prettier/prettier/pull/14170) by [@fisker](https://togithub.com/fisker))
See [Angular v15.1.0 release note](https://togithub.com/angular/angular/releases/tag/15.1.0) for details.
```html
// Input
// Prettier 2.8.2
SyntaxError: Only void and foreign elements can be self closed "app-test" (1:1)
> 1 |
| ^^^^^^^^^
2 |
// Prettier 2.8.3
```
### [`v2.8.2`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#282)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.1...2.8.2)
[diff](https://togithub.com/prettier/prettier/compare/2.8.1...2.8.2)
##### Don't lowercase link references ([#13155](https://togithub.com/prettier/prettier/pull/13155) by [@DerekNonGeneric](https://togithub.com/DerekNonGeneric) & [@fisker](https://togithub.com/fisker))
```markdown
We now don't strictly follow the release notes format suggested by [Keep a Changelog].
[Keep a Changelog]: https://example.com/
We now don't strictly follow the release notes format suggested by [Keep a Changelog].
[keep a changelog]: https://example.com/
```
##### Preserve self-closing tags ([#13691](https://togithub.com/prettier/prettier/pull/13691) by [@dcyriller](https://togithub.com/dcyriller))
```hbs
{{! Input }}
{{! Prettier 2.8.1 }}
{{! Prettier 2.8.2 }}
```
##### Allow custom "else if"-like blocks with block params ([#13930](https://togithub.com/prettier/prettier/pull/13930) by [@jamescdavis](https://togithub.com/jamescdavis))
[#13507](https://togithub.com/prettier/prettier/issues/13507) added support for custom block keywords used with `else`, but failed to allow block params. This updates printer-glimmer to allow block params with custom "else if"-like blocks.
```hbs
{{! Input }}
{{#when isAtWork as |work|}}
Ship that
{{work}}!
{{else when isReading as |book|}}
You can finish
{{book}}
eventually...
{{else}}
Go to bed!
{{/when}}
{{! Prettier 2.8.1 }}
{{#when isAtWork as |work|}}
Ship that
{{work}}!
{{else when isReading}}
You can finish
{{book}}
eventually...
{{else}}
Go to bed!
{{/when}}
{{! Prettier 2.8.2 }}
{{#when isAtWork as |work|}}
Ship that
{{work}}!
{{else when isReading as |book|}}
You can finish
{{book}}
eventually...
{{else}}
Go to bed!
{{/when}}
```
##### Preserve empty lines between nested SCSS maps ([#13931](https://togithub.com/prettier/prettier/pull/13931) by [@jneander](https://togithub.com/jneander))
```scss
/* Input */
$map: (
'one': (
'key': 'value',
),
'two': (
'key': 'value',
),
)
/* Prettier 2.8.1 */
$map: (
'one': (
'key': 'value',
),
'two': (
'key': 'value',
),
)
/* Prettier 2.8.2 */
$map: (
'one': (
'key': 'value',
),
'two': (
'key': 'value',
),
)
```
##### Fix missing parentheses when an expression statement starts with `let[` ([#14000](https://togithub.com/prettier/prettier/pull/14000), [#14044](https://togithub.com/prettier/prettier/pull/14044) by [@fisker](https://togithub.com/fisker), [@thorn0](https://togithub.com/thorn0))
```jsx
// Input
(let[0] = 2);
// Prettier 2.8.1
let[0] = 2;
// Prettier 2.8.1 (second format)
SyntaxError: Unexpected token (1:5)
> 1 | let[0] = 2;
| ^
2 |
// Prettier 2.8.2
(let)[0] = 2;
```
##### Fix semicolon duplicated at the end of LESS file ([#14007](https://togithub.com/prettier/prettier/pull/14007) by [@mvorisek](https://togithub.com/mvorisek))
```less
// Input
@variable: {
field: something;
};
// Prettier 2.8.1
@variable: {
field: something;
}; ;
// Prettier 2.8.2
@variable: {
field: something;
};
```
##### Fix no space after unary minus when followed by opening parenthesis in LESS ([#14008](https://togithub.com/prettier/prettier/pull/14008) by [@mvorisek](https://togithub.com/mvorisek))
```less
// Input
.unary_minus_single {
margin: -(@a);
}
.unary_minus_multi {
margin: 0 -(@a);
}
.binary_minus {
margin: 0 - (@a);
}
// Prettier 2.8.1
.unary_minus_single {
margin: - (@a);
}
.unary_minus_multi {
margin: 0 - (@a);
}
.binary_minus {
margin: 0 - (@a);
}
// Prettier 2.8.2
.unary_minus_single {
margin: -(@a);
}
.unary_minus_multi {
margin: 0 -(@a);
}
.binary_minus {
margin: 0 - (@a);
}
```
##### Do not change case of property name if inside a variable declaration in LESS ([#14034](https://togithub.com/prettier/prettier/pull/14034) by [@mvorisek](https://togithub.com/mvorisek))
```less
// Input
@var: {
preserveCase: 0;
};
// Prettier 2.8.1
@var: {
preservecase: 0;
};
// Prettier 2.8.2
@var: {
preserveCase: 0;
};
```
##### Fix formatting for auto-accessors with comments ([#14038](https://togithub.com/prettier/prettier/pull/14038) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
class A {
@dec()
// comment
accessor b;
}
// Prettier 2.8.1
class A {
@dec()
accessor // comment
b;
}
// Prettier 2.8.1 (second format)
class A {
@dec()
accessor; // comment
b;
}
// Prettier 2.8.2
class A {
@dec()
// comment
accessor b;
}
```
##### Add parentheses for TSTypeQuery to improve readability ([#14042](https://togithub.com/prettier/prettier/pull/14042) by [@onishi-kohei](https://togithub.com/onishi-kohei))
```tsx
// Input
a as (typeof node.children)[number]
a as (typeof node.children)[]
a as ((typeof node.children)[number])[]
// Prettier 2.8.1
a as typeof node.children[number];
a as typeof node.children[];
a as typeof node.children[number][];
// Prettier 2.8.2
a as (typeof node.children)[number];
a as (typeof node.children)[];
a as (typeof node.children)[number][];
```
##### Fix displacing of comments in default switch case ([#14047](https://togithub.com/prettier/prettier/pull/14047) by [@thorn0](https://togithub.com/thorn0))
It was a regression in Prettier 2.6.0.
```jsx
// Input
switch (state) {
default:
result = state; // no change
break;
}
// Prettier 2.8.1
switch (state) {
default: // no change
result = state;
break;
}
// Prettier 2.8.2
switch (state) {
default:
result = state; // no change
break;
}
```
##### Support type annotations on auto accessors via `babel-ts` ([#14049](https://togithub.com/prettier/prettier/pull/14049) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
[The bug that `@babel/parser` cannot parse auto accessors with type annotations](https://togithub.com/babel/babel/issues/15205) has been fixed. So we now support it via `babel-ts` parser.
```tsx
class Foo {
accessor prop: number;
}
```
##### Fix formatting of empty type parameters ([#14073](https://togithub.com/prettier/prettier/pull/14073) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
const foo: bar = () => baz;
// Prettier 2.8.1
Error: Comment "comment" was not printed. Please report this error!
// Prettier 2.8.2
const foo: bar = () => baz;
```
##### Add parentheses to head of `ExpressionStatement` instead of the whole statement ([#14077](https://togithub.com/prettier/prettier/pull/14077) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
({}).toString.call(foo) === "[object Array]"
? foo.forEach(iterateArray)
: iterateObject(foo);
// Prettier 2.8.1
({}.toString.call(foo) === "[object Array]"
? foo.forEach(iterateArray)
: iterateObject(foo));
// Prettier 2.8.2
({}).toString.call(foo.forEach) === "[object Array]"
? foo.forEach(iterateArray)
: iterateObject(foo);
```
##### Fix comments after directive ([#14081](https://togithub.com/prettier/prettier/pull/14081) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
"use strict" /* comment */;
// Prettier 2.8.1 (with other js parsers except `babel`)
Error: Comment "comment" was not printed. Please report this error!
// Prettier 2.8.2
```
##### Fix formatting for comments inside JSX attribute ([#14082](https://togithub.com/prettier/prettier/pull/14082) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
function MyFunctionComponent() {
}
// Prettier 2.8.1
Error: Comment "old" was not printed. Please report this error!
// Prettier 2.8.2
function MyFunctionComponent() {
;
}
```
##### Quote numeric keys for json-stringify parser ([#14083](https://togithub.com/prettier/prettier/pull/14083) by [@fisker](https://togithub.com/fisker))
```jsx
// Input
{0: 'value'}
// Prettier 2.8.1
{
0: "value"
}
// Prettier 2.8.2
{
"0": "value"
}
```
##### Fix removing commas from function arguments in maps ([#14089](https://togithub.com/prettier/prettier/pull/14089) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
```scss
/* Input */
$foo: map-fn(
(
"#{prop}": inner-fn($first, $second),
)
);
/* Prettier 2.8.1 */
$foo: map-fn(("#{prop}": inner-fn($first $second)));
/* Prettier 2.8.2 */
$foo: map-fn(
(
"#{prop}": inner-fn($first, $second),
)
);
```
##### Do not insert space in LESS property access ([#14103](https://togithub.com/prettier/prettier/pull/14103) by [@fisker](https://togithub.com/fisker))
```less
// Input
a {
color: @colors[@white];
}
// Prettier 2.8.1
a {
color: @colors[ @white];
}
// Prettier 2.8.2
```
### [`v2.8.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#281)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.8.0...2.8.1)
[diff](https://togithub.com/prettier/prettier/compare/2.8.0...2.8.1)
##### Fix SCSS map in arguments ([#9184](https://togithub.com/prettier/prettier/pull/9184) by [@agamkrbit](https://togithub.com/agamkrbit))
```scss
// Input
$display-breakpoints: map-deep-merge(
(
"print-only": "only print",
"screen-only": "only screen",
"xs-only": "only screen and (max-width: #{map-get($grid-breakpoints, "sm")-1})",
),
$display-breakpoints
);
// Prettier 2.8.0
$display-breakpoints: map-deep-merge(
(
"print-only": "only print",
"screen-only": "only screen",
"xs-only": "only screen and (max-width: #{map-get($grid-breakpoints, " sm
")-1})",
),
$display-breakpoints
);
// Prettier 2.8.1
$display-breakpoints: map-deep-merge(
(
"print-only": "only print",
"screen-only": "only screen",
"xs-only": "only screen and (max-width: #{map-get($grid-breakpoints, "sm")-1})",
),
$display-breakpoints
);
```
##### Support auto accessors syntax ([#13919](https://togithub.com/prettier/prettier/pull/13919) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
Support for [Auto Accessors Syntax](https://devblogs.microsoft.com/typescript/announcing-typescript-4-9/#auto-accessors-in-classes) landed in TypeScript 4.9.
(Doesn't work well with `babel-ts` parser)
```tsx
class Foo {
accessor foo: number = 3;
}
```
### [`v2.8.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#280)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.7.1...2.8.0)
[diff](https://togithub.com/prettier/prettier/compare/2.7.1...2.8.0)
🔗 [Release Notes](https://prettier.io/blog/2022/11/23/2.8.0.html)
### [`v2.7.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#271)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.7.0...2.7.1)
[diff](https://togithub.com/prettier/prettier/compare/2.7.0...2.7.1)
##### Keep useful empty lines in description ([#13013](https://togithub.com/prettier/prettier/pull/13013) by [@chimurai](https://togithub.com/chimurai))
```graphql
```
### [`v2.7.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#Prettier-270)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.6.2...2.7.0)
"""
First line
Second Line
"""
type Person {
name: String
}
### [`v2.6.2`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#262)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.6.1...2.6.2)
[diff](https://togithub.com/prettier/prettier/compare/2.6.1...2.6.2)
##### Fix LESS/SCSS format error ([#12536](https://togithub.com/prettier/prettier/pull/12536) by [@fisker](https://togithub.com/fisker))
```less
// Input
.background-gradient(@cut) {
background: linear-gradient(
to right,
@white 0%,
@white (@cut - 0.01%),
@portal-background @cut,
@portal-background 100%
);
}
// Prettier 2.6.1
TypeError: Cannot read properties of undefined (reading 'endOffset')
// Prettier 2.6.2
.background-gradient(@cut) {
background: linear-gradient(
to right,
@white 0%,
@white (@cut - 0.01%),
@portal-background @cut,
@portal-background 100%
);
}
```
##### Update `meriyah` to fix several bugs ([#12567](https://togithub.com/prettier/prettier/pull/12567) by [@fisker](https://togithub.com/fisker), fixes in [`meriyah`](https://togithub.com/meriyah/meriyah/) by [@3cp](https://togithub.com/3cp))
Fixes bugs when parsing following valid code:
```js
foo(await bar());
```
```js
const regex = /.*/ms;
```
```js
const element =
{/w/.test(s)}
;
```
```js
class A extends B {
#privateMethod() {
super.method();
}
}
```
### [`v2.6.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#261)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.6.0...2.6.1)
[diff](https://togithub.com/prettier/prettier/compare/2.6.0...2.6.1)
##### Ignore `loglevel` when printing information ([#12477](https://togithub.com/prettier/prettier/pull/12477) by [@fisker](https://togithub.com/fisker))
```bash
```
### [`v2.6.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#Prettier-260)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.5.1...2.6.0)
prettier --loglevel silent --find-config-path index.js
### [`v2.5.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#251)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.5.0...2.5.1)
[diff](https://togithub.com/prettier/prettier/compare/2.5.0...2.5.1)
##### Improve formatting for empty tuple types ([#11884](https://togithub.com/prettier/prettier/pull/11884) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
```tsx
// Input
type Foo =
Foooooooooooooooooooooooooooooooooooooooooooooooooooooooooo extends []
? Foo3
: Foo4;
// Prettier 2.5.0
type Foo = Foooooooooooooooooooooooooooooooooooooooooooooooooooooooooo extends [
]
? Foo3
: Foo4;
// Prettier 2.5.0 (tailingCommma = all)
// Invalid TypeScript code
type Foo = Foooooooooooooooooooooooooooooooooooooooooooooooooooooooooo extends [
,
]
? Foo3
: Foo4;
// Prettier 2.5.1
type Foo =
Foooooooooooooooooooooooooooooooooooooooooooooooooooooooooo extends []
? Foo3
: Foo4;
```
##### Fix compatibility with Jest inline snapshot test ([#11892](https://togithub.com/prettier/prettier/pull/11892) by [@fisker](https://togithub.com/fisker))
A internal change in Prettier@v2.5.0 accidentally breaks the Jest inline snapshot test.
##### Support Glimmer's named blocks ([#11899](https://togithub.com/prettier/prettier/pull/11899) by [@duailibe](https://togithub.com/duailibe))
Prettier already supported this feature, but it converted empty named blocks to self-closing, which is not supported by the Glimmer compiler.
See: [Glimmer's named blocks](https://emberjs.github.io/rfcs/0460-yieldable-named-blocks.html).
```hbs
// Input
<:named>
// Prettier 2.5.0
<:named />
// Prettier 2.5.1
<:named>
```
### [`v2.5.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#250)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.4.1...2.5.0)
[diff](https://togithub.com/prettier/prettier/compare/2.4.1...2.5.0)
🔗 [Release Notes](https://prettier.io/blog/2021/11/25/2.5.0.html)
### [`v2.4.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#241)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.4.0...2.4.1)
[diff](https://togithub.com/prettier/prettier/compare/2.4.0...2.4.1)
##### Fix wildcard syntax in `@forward` ([#11482](https://togithub.com/prettier/prettier/pull/11482)) ([#11487](https://togithub.com/prettier/prettier/pull/11487) by [@niksy](https://togithub.com/niksy))
```scss
// Input
@forward "library" as btn-*;
// Prettier 2.4.0
@forward "library" as btn- *;
// Prettier 2.4.1
@forward "library" as btn-*;
```
##### Add new CLI option `debug-print-ast` ([#11514](https://togithub.com/prettier/prettier/pull/11514) by [@sosukesuzuki](https://togithub.com/sosukesuzuki))
A new `--debug-print-ast` CLI flag for debugging.
### [`v2.4.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#240)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.3.2...2.4.0)
[diff](https://togithub.com/prettier/prettier/compare/2.3.2...2.4.0)
🔗 [Release Notes](https://prettier.io/blog/2021/09/09/2.4.0.html)
### [`v2.3.2`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#232)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.3.1...2.3.2)
[diff](https://togithub.com/prettier/prettier/compare/2.3.1...2.3.2)
##### Fix failure on dir with trailing slash ([#11000](https://togithub.com/prettier/prettier/pull/11000) by [@fisker](https://togithub.com/fisker))
```console
$ ls
1.js 1.unknown
```
### [`v2.3.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#Prettier-231)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.3.0...2.3.1)
$ prettier . -l
1.js
$ prettier ./ -l
\[error] No supported files were found in the directory: "./".
### [`v2.3.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#230)
[Compare Source](https://togithub.com/prettier/prettier/compare/2.2.1...2.3.0)
[diff](https://togithub.com/prettier/prettier/compare/2.2.1...2.3.0)
🔗 [Release Notes](https://prettier.io/blog/2021/05/09/2.3.0.html)
Configuration
📅 Schedule: Branch creation - "after 10pm every weekday,before 5am every weekday,every weekend" in timezone Europe/Moscow, Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about these updates again.
[ ] If you want to rebase/retry this PR, check this box
Hey! Changelogs info seems to be missing or might be in incorrect format.
Please use the below template in PR description to ensure Changelogg can detect your changes:
- (tag) changelog_text
or
```
- tag: changelog_text
```
**OR**
You can add tag in PR header or while doing a commit too
```
(tag) PR header
```
or
```
tag: PR header
```
Valid tags: **added** / **feat**, **changed**, **deprecated**, **fixed** / **fix**, **removed**, **security**, **build**, **ci**, **chore**, **docs**, **perf**, **refactor**, **revert**, **style**, **test**
Thanks!
For more info, check out [changelogg docs](https://docs.changelogg.io/)
This PR contains the following updates:
^2.1.2->^3.0.0^2.1.5->^3.0.0Release Notes
prettier/prettier (prettier)
### [`v3.3.3`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#333) [Compare Source](https://togithub.com/prettier/prettier/compare/3.3.2...3.3.3) [diff](https://togithub.com/prettier/prettier/compare/3.3.2...3.3.3) ##### Add parentheses for nullish coalescing in ternary ([#16391](https://togithub.com/prettier/prettier/pull/16391) by [@cdignam-segment](https://togithub.com/cdignam-segment)) This change adds clarity to operator precedence. ```js // Input foo ? bar ?? foo : baz; foo ?? bar ? a : b; a ? b : foo ?? bar; // Prettier 3.3.2 foo ? bar ?? foo : baz; foo ?? bar ? a : b; a ? b : foo ?? bar; // Prettier 3.3.3 foo ? (bar ?? foo) : baz; (foo ?? bar) ? a : b; a ? b : (foo ?? bar); ``` ##### Add parentheses for decorator expressions ([#16458](https://togithub.com/prettier/prettier/pull/16458) by [@y-schneider](https://togithub.com/y-schneider)) Prevent parentheses around member expressions or tagged template literals from being removed to follow the stricter parsing rules of TypeScript 5.5. ```ts // Input @(foo`tagged template`) class X {} // Prettier 3.3.2 @foo`tagged template` class X {} // Prettier 3.3.3 @(foo`tagged template`) class X {} ``` ##### Support `@let` declaration syntax ([#16474](https://togithub.com/prettier/prettier/pull/16474) by [@sosukesuzuki](https://togithub.com/sosukesuzuki)) Adds support for Angular v18 `@let` declaration syntax. Please see the following code example. The `@let` declaration allows you to define local variables within the template: ```html @let name = 'Frodo';Dashboard for {{name}}
Hello, {{name}} ``` For more details, please refer to the excellent blog post by the Angular Team: [Introducing @let in Angular](https://blog.angular.dev/introducing-let-in-angular-686f9f383f0f). We also appreciate the Angular Team for kindly answering our questions to implement this feature. ### [`v3.3.2`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#332) [Compare Source](https://togithub.com/prettier/prettier/compare/3.3.1...3.3.2) [diff](https://togithub.com/prettier/prettier/compare/3.3.1...3.3.2) ##### Fix handlebars path expressions starts with `@` ([#16358](https://togithub.com/prettier/prettier/pull/16358) by [@Princeyadav05](https://togithub.com/Princeyadav05)) ```hbs {{! Input }}{{ hello }}
`, }) export class AppComponent {} // Prettier 3.2.4 const template = "foobar"; @Component({ [template]: `{{ hello }}
`, }) export class AppComponent {} // Prettier 3.2.5 const template = "foobar"; @Component({ [template]: `{{ hello }}
`, }) export class AppComponent {} ``` ##### Use `"json"` parser for `tsconfig.json` by default ([#16012](https://togithub.com/prettier/prettier/pull/16012) by [@sosukesuzuki](https://togithub.com/sosukesuzuki)) In [v2.3.0](https://prettier.io/blog/2024/01/12/3.2.0#new-jsonc-parser-added-15831httpsgithubcomprettierprettierpull15831-by-fiskerhttpsgithubcomfisker), we introduced `"jsonc"` parser which adds trialing comma **by default**. When adding a new parser we also define how it will be used based on the [`linguist-languages`](https://www.npmjs.com/package/linguist-languages) data. `tsconfig.json` is a special file used by [TypeScript](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html#using-tsconfigjson-or-jsconfigjson), it uses `.json` file extension, but it actually uses the [JSON with Comments](https://code.visualstudio.com/docs/languages/json#\_json-with-comments) syntax. However, we found that there are many third-party tools not recognize it correctly because of the confusing `.json` file extension. We decide to treat it as a JSON file for now to avoid the extra configuration step. To keep using the `"jsonc"` parser for your `tsconfig.json` files, add the following to your `.pretterrc` file ```json { "overrides": [ { "files": ["tsconfig.json", "jsconfig.json"], "options": { "parser": "jsonc" } } ] } ``` ``` ``` ### [`v3.2.4`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#324) [Compare Source](https://togithub.com/prettier/prettier/compare/3.2.3...3.2.4) [diff](https://togithub.com/prettier/prettier/compare/3.2.3...3.2.4) ##### Fix incorrect parser inference ([#15947](https://togithub.com/prettier/prettier/pull/15947) by [@fisker](https://togithub.com/fisker)) Files like `.eslintrc.json` were incorrectly formatted as JSONC files. ```jsx // Input prettier --file-info .eslintrc.json { "ignored": false, "inferredParser": "jsonc" } // Prettier 3.2.4 prettier --file-info .eslintrc.json { "ignored": false, "inferredParser": "json" } ``` ### [`v3.2.3`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#323) [Compare Source](https://togithub.com/prettier/prettier/compare/3.2.2...3.2.3) [diff](https://togithub.com/prettier/prettier/compare/3.2.2...3.2.3) ##### Throw errors for invalid code ([#15881](https://togithub.com/prettier/prettier/pull/15881) by [@fisker](https://togithub.com/fisker), [@Josh-Cena](https://togithub.com/Josh-Cena), [@auvred](https://togithub.com/auvred)) ```ts // Input 1++; // Prettier 3.2.2 1++; // Prettier 3.2.3 SyntaxError: Invalid left-hand side expression in unary operation (1:1) > 1 | 1++; | ^ ``` ```ts // Input try {} catch (error = 1){} // Prettier 3.2.2 try { } catch (error) {} // Prettier 3.2.3 SyntaxError: Catch clause variable cannot have an initializer. (1:23) > 1 | try {} catch (error = 1){} | ^ ``` ##### Fix parser inference ([#15927](https://togithub.com/prettier/prettier/pull/15927) by [@fisker](https://togithub.com/fisker)) ```console // Prettier 3.2.2 prettier --file-info tsconfig.json { "ignored": false, "inferredParser": "json" } // Prettier 3.2.3 prettier --file-info tsconfig.json { "ignored": false, "inferredParser": "jsonc" } ``` ### [`v3.2.2`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#322) [Compare Source](https://togithub.com/prettier/prettier/compare/3.2.1...3.2.2) [diff](https://togithub.com/prettier/prettier/compare/3.2.1...3.2.2) ##### Fix crash when parsing template literal CSS in a JSX style tag using a spread attribute ([#15896](https://togithub.com/prettier/prettier/pull/15896) by [@eelco](https://togithub.com/eelco)) For example this code would crash before: ```jsx ``` ##### Fix formatting error on optional call expression and member chain ([#15920](https://togithub.com/prettier/prettier/pull/15920) by [@sosukesuzuki](https://togithub.com/sosukesuzuki)) ```jsx // Input a(() => {}, c?.d()); // Prettier 3.2.1 TypeError: Cannot read properties of undefined (reading 'type') // Prettier 3.2.2 a(() => {}, c?.d()); ``` ### [`v3.2.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#321) [Compare Source](https://togithub.com/prettier/prettier/compare/3.2.0...3.2.1) [diff](https://togithub.com/prettier/prettier/compare/3.2.0...3.2.1) ##### Fix formatting error on member chain ([#15915](https://togithub.com/prettier/prettier/pull/15915) by [@sosukesuzuki](https://togithub.com/sosukesuzuki)) ```jsx // Input test().test2().test2(thing?.something); // Prettier 3.2.0 TypeError: Cannot read properties of undefined (reading 'type') // Prettier 3.2.1 test().test2().test2(thing?.something); ``` ### [`v3.2.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#320) [Compare Source](https://togithub.com/prettier/prettier/compare/3.1.1...3.2.0) [diff](https://togithub.com/prettier/prettier/compare/3.1.1...3.2.0) 🔗 [Release Notes](https://prettier.io/blog/2024/01/13/3.2.0.html) ### [`v3.1.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#311) [Compare Source](https://togithub.com/prettier/prettier/compare/3.1.0...3.1.1) [diff](https://togithub.com/prettier/prettier/compare/3.1.0...3.1.1) ##### Fix config file search ([#15363](https://togithub.com/prettier/prettier/pull/15363) by [@fisker](https://togithub.com/fisker)) Previously, we start search for config files from the filePath as a directory, if it happened to be a directory and contains config file, it will be used by mistake. ```text ├─ .prettierrc └─ test.js (A directory) └─ .prettierrc ``` ```js // Prettier 3.1.0 await prettier.resolveConfigFile(new URL("./test.js", import.meta.url)); //{/w/.test(s)}
; ``` ```js class A extends B { #privateMethod() { super.method(); } } ``` ### [`v2.6.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#261) [Compare Source](https://togithub.com/prettier/prettier/compare/2.6.0...2.6.1) [diff](https://togithub.com/prettier/prettier/compare/2.6.0...2.6.1) ##### Ignore `loglevel` when printing information ([#12477](https://togithub.com/prettier/prettier/pull/12477) by [@fisker](https://togithub.com/fisker)) ```bash ``` ### [`v2.6.0`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#Prettier-260) [Compare Source](https://togithub.com/prettier/prettier/compare/2.5.1...2.6.0) prettier --loglevel silent --find-config-path index.js ### [`v2.5.1`](https://togithub.com/prettier/prettier/blob/HEAD/CHANGELOG.md#251) [Compare Source](https://togithub.com/prettier/prettier/compare/2.5.0...2.5.1) [diff](https://togithub.com/prettier/prettier/compare/2.5.0...2.5.1) ##### Improve formatting for empty tuple types ([#11884](https://togithub.com/prettier/prettier/pull/11884) by [@sosukesuzuki](https://togithub.com/sosukesuzuki)) ```tsx // Input type Foo = Foooooooooooooooooooooooooooooooooooooooooooooooooooooooooo extends [] ? Foo3 : Foo4; // Prettier 2.5.0 type Foo = Foooooooooooooooooooooooooooooooooooooooooooooooooooooooooo extends [ ] ? Foo3 : Foo4; // Prettier 2.5.0 (tailingCommma = all) // Invalid TypeScript code type Foo = Foooooooooooooooooooooooooooooooooooooooooooooooooooooooooo extends [ , ] ? Foo3 : Foo4; // Prettier 2.5.1 type Foo = Foooooooooooooooooooooooooooooooooooooooooooooooooooooooooo extends [] ? Foo3 : Foo4; ``` ##### Fix compatibility with Jest inline snapshot test ([#11892](https://togithub.com/prettier/prettier/pull/11892) by [@fisker](https://togithub.com/fisker)) A internal change in Prettier@v2.5.0 accidentally breaks the Jest inline snapshot test. ##### Support Glimmer's named blocks ([#11899](https://togithub.com/prettier/prettier/pull/11899) by [@duailibe](https://togithub.com/duailibe)) Prettier already supported this feature, but it converted empty named blocks to self-closing, which is not supported by the Glimmer compiler. See: [Glimmer's named blocks](https://emberjs.github.io/rfcs/0460-yieldable-named-blocks.html). ```hbs // InputConfiguration
📅 Schedule: Branch creation - "after 10pm every weekday,before 5am every weekday,every weekend" in timezone Europe/Moscow, Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about these updates again.
This PR was generated by Mend Renovate. View the repository job log.
Hey! Changelogs info seems to be missing or might be in incorrect format. Please use the below template in PR description to ensure Changelogg can detect your changes:
Pull request by bot. No need to analyze
Thanks for the PR!
This section of the codebase is owner by https://github.com/AlexRogalskiy/ - if they write a comment saying "LGTM" then it will be merged.
Thanks for opening an issue! Make sure you've followed CONTRIBUTING.md.
Hello from PR Helper
Is your PR ready for review and processing? Mark the PR ready by including
#pr-readyin a comment.If you still have work to do, even after marking this ready. Put the PR on hold by including
#pr-onholdin a comment.New and removed dependencies detected. Learn more about Socket for GitHub ↗︎
000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000🚮 Removed packages: npm/@types/prettier@2.2.3
View full report↗︎