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
;
;
```
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), 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.
This PR contains the following updates:
2.8.4->3.1.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 - At any time (no schedule defined), 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.
Codecov Report
Additional details and impacted files
```diff @@ Coverage Diff @@ ## master #7074 +/- ## ====================================== Coverage 8.67% 8.67% ====================================== Files 308 308 Lines 5270 5270 Branches 1417 1421 +4 ====================================== Hits 457 457 Misses 4786 4786 Partials 27 27 ```Edited/Blocked Notification
Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR.
You can manually request rebase by checking the rebase/retry box above.
⚠ Warning: custom changes will be lost.