prettier/prettier (prettier)
### [`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;
```
Configuration
📅 Schedule: Branch creation - "before 4am on Monday" (UTC), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
â™» Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
Because you closed this PR without merging, Renovate will ignore this update. You will not get PRs for any future 3.x releases. But if you manually upgrade to 3.x then Renovate will re-enable minor and patch updates automatically.
If you accidentally closed this PR, or if you changed your mind: rename this PR to get a fresh replacement PR.
This PR contains the following updates:
^2.8.3->^3.0.0Release Notes
prettier/prettier (prettier)
### [`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 inConfiguration
📅 Schedule: Branch creation - "before 4am on Monday" (UTC), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
â™» Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.
Kudos, SonarCloud Quality Gate passed!
Renovate Ignore Notification
Because you closed this PR without merging, Renovate will ignore this update. You will not get PRs for any future
3.xreleases. But if you manually upgrade to3.xthen Renovate will re-enableminorandpatchupdates automatically.If you accidentally closed this PR, or if you changed your mind: rename this PR to get a fresh replacement PR.