prettier/prettier (prettier)
Compare Source
diff
Remove unnecessary parentheses around assignment inv-on
(#16887 by@fisker)
<!-- Input --><template> <button @​click="foo += 2">Click</button></template><!-- Prettier 3.4.0 --><template> <button @​click="(foo += 2)">Click</button></template><!-- Prettier 3.4.1 --><template> <button @​click="foo += 2">Click</button></template>
Compare Source
diff
🔗Release Notes
Compare Source
diff
Add parentheses for nullish coalescing in ternary (#16391 by@cdignam-segment)
This change adds clarity to operator precedence.
// Inputfoo ?bar??foo :baz;foo??bar ?a :b;a ?b :foo??bar;// Prettier 3.3.2foo ?bar??foo :baz;foo??bar ?a :b;a ?b :foo??bar;// Prettier 3.3.3foo ?(bar??foo) :baz;(foo??bar) ?a :b;a ?b :(foo??bar);
Add parentheses for decorator expressions (#16458 by@y-schneider)
Prevent parentheses around member expressions or tagged template literals from being removed to follow the stricter parsing rules of TypeScript 5.5.
// Input@​(foo`tagged template`)classX{}// Prettier 3.3.2@​foo`tagged template`classX{}// Prettier 3.3.3@​(foo`tagged template`)classX{}
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:
@​let name = 'Frodo';<h1>Dashboard for {{name}}</h1>Hello, {{name}}
For more details, please refer to the excellent blog post by the Angular Team:Introducing @let in Angular.
We also appreciate the Angular Team for kindly answering our questions to implement this feature.
Compare Source
diff
Fix handlebars path expressions starts with@
(#16358 by@Princeyadav05)
{{! Input }}<div>{{@​x.y.z}}</div>{{! Prettier 3.3.1 }}<div>{{@​x}}</div>{{! Prettier 3.3.2 }}<div>{{@​x.y.z}}</div>
Compare Source
diff
Preserve empty lines in front matter (#16347 by@fisker)
<!-- Input-->---foo:- bar1- bar2- bar3---Markdown<!-- Prettier 3.3.0-->---foo:- bar1- bar2- bar3---Markdown<!-- Prettier 3.3.1-->---foo:- bar1- bar2- bar3---Markdown
Preserve explicit language in front matter (#16348 by@fisker)
<!-- Input-->---yamltitle: Helloslug: home---<!-- Prettier 3.3.0-->---title: Helloslug: home---<!-- Prettier 3.3.1-->---yamltitle: Helloslug: home---
Avoid line breaks in import attributes (#16349 by@fisker)
// Inputimportsomethingfrom"./some-very-very-very-very-very-very-very-very-long-path.json"with{type:"json"};// Prettier 3.3.0importsomethingfrom"./some-very-very-very-very-very-very-very-very-long-path.json"with{type:"json"};// Prettier 3.3.1importsomethingfrom"./some-very-very-very-very-very-very-very-very-long-path.json"with{type:"json"};
Compare Source
diff
🔗Release Notes
Compare Source
diff
Support Angular inline styles as single template literal (#15968 by@sosukesuzuki)
Angular v17 supports single string inline styles.
// Input@​Component({template:`<div>...</div>`,styles:`h1 { color: blue; }`,})exportclassAppComponent{}// Prettier 3.2.4@​Component({template:`<div>...</div>`,styles:`h1 { color: blue; }`,})exportclassAppComponent{}// Prettier 3.2.5@​Component({template:`<div>...</div>`,styles:` h1 { color: blue; } `,})exportclassAppComponent{}
Unexpected embedded formatting for Angular template (#15969 by@JounQin)
Computed template should not be considered as Angular component template
// Inputconsttemplate="foobar";@​Component({[template]:`<h1>{{ hello }}</h1>`,})exportclassAppComponent{}// Prettier 3.2.4consttemplate="foobar";@​Component({[template]:`<h1>{{ hello }}</h1>`,})exportclassAppComponent{}// Prettier 3.2.5consttemplate="foobar";@​Component({[template]:`<h1>{{ hello }}</h1>`,})exportclassAppComponent{}
Use"json"
parser fortsconfig.json
by default (#16012 by@sosukesuzuki)
Inv2.3.0, we introduced"jsonc"
parser which adds trialing commaby default.
When adding a new parser we also define how it will be used based on thelinguist-languages
data.
tsconfig.json
is a special file used byTypeScript, it uses.json
file extension, but it actually uses theJSON 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 yourtsconfig.json
files, add the following to your.pretterrc
file
{"overrides": [ {"files": ["tsconfig.json","jsconfig.json"],"options": {"parser":"jsonc" } } ]}
Compare Source
diff
Fix incorrect parser inference (#15947 by@fisker)
Files like.eslintrc.json
were incorrectly formatted as JSONC files.
// Inputprettier--file-info.eslintrc.json{"ignored":false,"inferredParser":"jsonc"}// Prettier 3.2.4prettier--file-info.eslintrc.json{"ignored":false,"inferredParser":"json"}
Compare Source
diff
// Input1++;// Prettier 3.2.21++;// Prettier 3.2.3SyntaxError:Invalidleft-handsideexpressioninunaryoperation(1:1)>1|1++;|^
// Inputtry{}catch(error=1){}// Prettier 3.2.2try{}catch(error){}// Prettier 3.2.3SyntaxError:Catchclausevariablecannothaveaninitializer.(1:23)>1|try{}catch(error=1){}|^
// Prettier 3.2.2prettier --file-info tsconfig.json{ "ignored": false, "inferredParser": "json" }// Prettier 3.2.3prettier --file-info tsconfig.json{ "ignored": false, "inferredParser": "jsonc" }
Compare Source
diff
Fix crash when parsing template literal CSS in a JSX style tag using a spread attribute (#15896 by@eelco)
For example this code would crash before:
<style{...spread}>{`.{}`}</style>
Fix formatting error on optional call expression and member chain (#15920 by@sosukesuzuki)
// Inputa(()=>{},c?.d());// Prettier 3.2.1TypeError:Cannotreadpropertiesofundefined(reading'type')// Prettier 3.2.2a(()=>{},c?.d());
Compare Source
diff
// Inputtest().test2().test2(thing?.something);// Prettier 3.2.0TypeError:Cannotreadpropertiesofundefined(reading'type')// Prettier 3.2.1test().test2().test2(thing?.something);
Compare Source
diff
🔗Release Notes
Compare Source
diff
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.
├─ .prettierrc└─ test.js (A directory) └─ .prettierrc
// Prettier 3.1.0awaitprettier.resolveConfigFile(newURL("./test.js",import.meta.url));// <CWD>/test.js/.prettierrc// Prettier 3.1.1awaitprettier.resolveConfigFile(newURL("./test.js",import.meta.url));// <CWD>/.prettierrc
Skip explicitly passed symbolic links with--no-error-on-unmatched-pattern
(#15533 by@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 whenuseTabs
istrue
(#15662 by@auvred)
// Inputaaaaaaaaaaaaaaa?bbbbbbbbbbbbbbbbbb:ccccccccccccccc ?ddddddddddddddd :eeeeeeeeeeeeeee ?fffffffffffffff :gggggggggggggggg;// Prettier 3.1.0aaaaaaaaaaaaaaa?bbbbbbbbbbbbbbbbbb:ccccccccccccccc ?ddddddddddddddd :eeeeeeeeeeeeeee ?fffffffffffffff :gggggggggggggggg;// Prettier 3.1.1aaaaaaaaaaaaaaa?bbbbbbbbbbbbbbbbbb:ccccccccccccccc?ddddddddddddddd:eeeeeeeeeeeeeee?fffffffffffffff:gggggggggggggggg;
Improve config file search (#15663 by@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 by@sosukesuzuki)
// Inputconst{ foo,// bar// baz}:Foo=expr;// Prettier 3.1.0const{ foo1,}// bar// baz:Foo=expr;// Prettier 3.1.0 second outputconst{ foo1,// bar}// baz:Foo=expr;// Prettier 3.1.1const{ foo1,// bar// baz}:Foo=expr;
Support "Import Attributes" (#15718 by@fisker)
TypeScript 5.3 supports the latest updates to theimport attributes proposal.
importsomethingfrom"./something.json"with{type:"json"};
Fix false claim in docs that cursorOffset is incompatible with rangeStart/rangeEnd (#15750 by@ExplodingCabbage)
The cursorOffset option has in fact been compatible with rangeStart/rangeEnd for over 5 years, thanks to work by@ds300. However, Prettier's documentation (including the CLI--help
text) continued to claim otherwise, falsely. The documentation is now fixed.
Keep curly braces andfrom
keyword in emptyimport
statements (#15756 by@fisker)
// Inputimport{}from'foo';import{/* comment */}from'bar';// Prettier 3.1.0import{}from"foo";import/* comment */"bar";// Prettier 3.1.1import{}from"foo";import{}from/* comment */"bar";
Keep empty import attributes and assertions (#15757 by@fisker)
// Inputimportfoofrom"foo"with{};importbarfrom"bar"assert{};// Prettier 3.1.0importfoofrom"foo";importbarfrom"bar";// Prettier 3.1.1importfoofrom"foo"with{};importbarfrom"bar"assert{};
Compare Source
diff
🔗Release Notes
Compare Source
diff
AddpreferUnplugged: true
topackage.json
(#15169 by@fisker and@so1ve)
Prettier v3 uses dynamic imports, userwill need to unplug Prettier when Yarn's PnP mode is enabled, addpreferUnplugged: true
topackage.json
, so Yarn will install Prettier as unplug by default.
Support shared config that forbidsrequire()
(#15233 by@fisker)
If an external shared config package is used, and the packageexports
don't haverequire
ordefault
export.
In Prettier 3.0.2 Prettier fails when attempt torequire()
the package, and throws an error.
Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined in <packageName>/package.json
Allow argument ofrequire()
to break (#15256 by@fisker)
// Inputconstplugin=require(global.STANDALONE ?path.join(__dirname,"../standalone.js") :path.join(__dirname,".."));// Prettier 3.0.2constplugin=require(global.STANDALONE ?path.join(__dirname,"../standalone.js") :path.join(__dirname,".."));// Prettier 3.0.3constplugin=require(global.STANDALONE ?path.join(__dirname,"../standalone.js") :path.join(__dirname,".."));
Do not print trailing commas in arrow function type parameter lists ints
code blocks (#15286 by@sosukesuzuki)
<!-- Input-->```tsconst foo= <T>()=> {}```<!-- Prettier 3.0.2-->```tsconst foo= <T,>()=> {}```<!-- Prettier 3.0.3-->```tsconst foo= <T>()=> {}```
Support TypeScript 5.2using
/await using
declaration (#15321 by@sosukesuzuki)
Support for the upcoming Explicit Resource Management feature in ECMAScript.using
/await using
declaration
{ usingfoo=newFoo();await usingbar=newBar();}
Compare Source
diff
Break after=
of assignment if RHS is poorly breakable AwaitExpression or YieldExpression (#15204 by@seiyab)
// Inputconst{ section, rubric, authors, tags}=awaitutils.upsertCommonData(mainData);// Prettier 3.0.1const{ section, rubric, authors, tags}=awaitutils.upsertCommonData(mainData,);// Prettier 3.0.2const{ section, rubric, authors, tags}=awaitutils.upsertCommonData(mainData);
Do not add trailing comma for grouped scss comments (#15217 by@auvred)
/* 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);
Printdeclare
andexport
keywords for nested namespace (#15249 by@sosukesuzuki)
// Inputdeclarenamespaceabc1.def{}exportnamespaceabc2.def{}// Prettier 3.0.1namespaceabc1.def{}namespaceabc2.def{}// Prettier 3.0.2declarenamespaceabc1.def{}exportnamespaceabc2.def{}
Compare Source
diff
Fix cursor positioning for a special case (#14812 by@fisker)
// <|> 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 by@kingyue737)
Addexport {}
inplugins/estree.d.ts
to fix the "File is not a module" error
Add parenthesis around leading multiline comment in return statement (#15037 by@auvred)
// Inputfunctionfn(){return(/** * @​type {...} */expresssion)}// Prettier 3.0.0functionfn(){return/** * @​type {...} */expresssion;}// Prettier 3.0.1functionfn(){return(/** * @​type {...} */expresssion);}
Add support for Vue "Generic Components" (#15066 by@auvred)
https://blog.vuejs.org/posts/vue-3-3#generic-components
<!-- Input --><script setup lang="ts" generic="T extends Type1 & Type2 & (Type3 | Type4), U extends string | number | boolean"></script><!-- Prettier 3.0.0 --><script setup lang="ts" generic="T extends Type1 & Type2 & (Type3 | Type4), U extends string | number | boolean"></script><!-- Prettier 3.0.1 --><script setup lang="ts" generic=" T extends Type1 & Type2 & (Type3 | Type4), U extends string | number | boolean "></script>
Fix comments print inIfStatement
(#15076 by@fisker)
functiona(b){if(b)return1;// commentelsereturn2;}/* Prettier 3.0.0 */Error:Comment"comment"wasnotprinted.Pleasereportthiserror!/* Prettier 3.0.1 */functiona(b){if(b)return1;// commentelsereturn2;}
Add missing type definition forprinter.preprocess
(#15123 by@so1ve)
export interface Printer<T = any> { // ...+ preprocess?:+ | ((ast: T, options: ParserOptions<T>) => T | Promise<T>)+ | undefined;}
Add missinggetVisitorKeys
method type definition forPrinter
(#15125 by@auvred)
constprinter:Printer={print:()=>[],getVisitorKeys(node,nonTraversableKeys){return["body"];},};
Add typing to supportreadonly
array properties of AST Node (#15127 by@auvred)
// InputinterfaceTestNode{readonlyArray:readonlystring[];}declareconstpath:AstPath<TestNode>;path.map(()=>"","readonlyArray");// Prettier 3.0.0interfaceTestNode{readonlyArray:readonlystring[];}declareconstpath:AstPath<TestNode>;path.map(()=>"","readonlyArray");// ^ Argument of type '"readonlyArray"' is not assignable to parameter of type '"regularArray"'. ts(2345)// Prettier 3.0.1interfaceTestNode{readonlyArray:readonlystring[];}declareconstpath:AstPath<TestNode>;path.map(()=>"","readonlyArray");
Add space before unary minus followed by a function call (#15129 by@pamelalozano)
// Inputdiv {margin:- func();}// Prettier 3.0.0div {margin:-func();}// Prettier 3.0.1div {margin:- func();}
Compare Source
diff
🔗Release Notes
Compare Source
This version is a republished version of v2.8.7.
A bad version was accidentally published andit can't be unpublished, apologies for the churn.
Compare Source
diff
Allow multiple decorators on same getter/setter (#14584 by@fisker)
// InputclassA{ @​decorator()getfoo(){} @​decorator()setfoo(value){}}// Prettier 2.8.6SyntaxError:Decoratorscannotbeappliedtomultipleget/setaccessorsofthesamename.(5:3)3|getfoo(){}4|>5| @​decorator()|^^^^^^^^^^^^6|setfoo(value){}7|}// Prettier 2.8.7classA{ @​decorator()getfoo(){} @​decorator()setfoo(value){}}
Compare Source
diff
Allow decorators on private members and class expressions (#14548 by@fisker)
// InputclassA{ @​decorator() #privateMethod(){}}// Prettier 2.8.5SyntaxError:Decoratorsarenotvalidhere.(2:3)1|classA{>2| @​decorator()|^^^^^^^^^^^^3| #privateMethod(){}4|}// Prettier 2.8.6classA{ @​decorator() #privateMethod(){}}
Compare Source
diff
TypeScript 5.0 introduces two new syntactic features:
const
modifiers for type parametersexport type *
declarations
Add missing parentheses for decorator (#14393 by@fisker)
// InputclassPerson{ @​(myDecoratorArray[0])greet(){}}// Prettier 2.8.4classPerson{ @​myDecoratorArray[0]greet(){}}// Prettier 2.8.5classPerson{ @​(myDecoratorArray[0])greet(){}}
Add parentheses forTypeofTypeAnnotation
to improve readability (#14458 by@fisker)
// InputtypeA=(typeofnode.children)[];// Prettier 2.8.4typeA=typeofnode.children[];// Prettier 2.8.5typeA=(typeofnode.children)[];
Supportmax_line_length=off
when parsing.editorconfig
(#14516 by@josephfrazier)
If an .editorconfig file is in your project and it setsmax_line_length=off
for the file you're formatting,
it will be interpreted as aprintWidth
ofInfinity
rather than being ignored
(which previously resulted in the defaultprintWidth
of 80 being applied, if not overridden by Prettier-specific configuration).
<!-- Input --><divclassName='HelloWorld'title={`Youarevisitornumber${num}`}onMouseOver={onMouseOver}/><!-- Prettier 2.8.4 --><divclassName="HelloWorld"title={`Youarevisitornumber${num}`}onMouseOver={onMouseOver}/>;<!-- Prettier 2.8.5 --><divclassName="HelloWorld"title={`Youarevisitornumber${num}`}onMouseOver={onMouseOver}/>;
Compare Source
diff
// InputtypeType={// commentreadonly[keyinFoo];};// Prettier 2.8.3typeType={readonly// comment[keyinFoo];};// Prettier 2.8.4typeType={// commentreadonly[keyinFoo];};
Group params in opening block statements (#14067 by@jamescdavis)
This is a follow-up to#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.
{{! Input }}{{#blockparamparamparamparamparamparamparamparamparamparamas |blockParam|}} Hello{{else block param param param param param param param param param param as |blockParam|}} There{{/block}}{{! Prettier 2.8.3 }}{{#blockparamparamparamparamparamparamparamparamparamparamas |blockParam|}} Hello{{else block paramparamparamparamparamparamparamparamparamparam}} There{{/block}}{{! Prettier 2.8.4 }}{{#blockparamparamparamparamparamparamparamparamparamparamas |blockParam|}} Hello{{else block param param param param param param param param param param as |blockParam|}} There{{/block}}
InSapling SCM,.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 by@fisker)
// Inputconsta=/** @​satisfies {Record<string, string>} */({hello:1337});constb=/** @​type {Record<string, string>} */({hello:1337});// Prettier 2.8.3consta=/** @​satisfies {Record<string, string>} */{hello:1337};constb=/** @​type {Record<string, string>} */({hello:1337});// Prettier 2.8.4consta=/** @​satisfies {Record<string, string>} */({hello:1337});constb=/** @​type {Record<string, string>} */({hello:1337});
Fix parens in inferred function return types withextends
(#14279 by@fisker)
// InputtypeFoo<T>=Textends((a)=>a is inferRextendsstring) ?R :never;// Prettier 2.8.3 (First format)typeFoo<T>=Textends(a)=>a is inferRextendsstring ?R :never;// Prettier 2.8.3 (Second format)SyntaxError:'?'expected.// Prettier 2.8.4typeFoo<T>=Textends((a)=>ais inferRextendsstring) ?R :never;
Compare Source
diff
Allow self-closing tags on custom elements (#14170 by@fisker)
SeeAngular v15.1.0 release note for details.
// Input<app-test/>// Prettier 2.8.2SyntaxError: Only void and foreign elements can be self closed "app-test" (1:1)> 1 |<app-test/> | ^^^^^^^^^ 2 |// Prettier 2.8.3<app-test/>
Compare Source
diff
<!-- Input-->We now don't strictly follow the release notes format suggested by[Keep a Changelog].[Keep a Changelog]:https://example.com/<!-- Prettier 2.8.1-->We now don't strictly follow the release notes format suggested by[Keep a Changelog].[keep a changelog]:https://example.com/<!--^^^^^^^^^^^^^^^^^^ lowercased--><!-- Prettier 2.8.2--><Sameasinput>
{{! Input }}<div /><div></div><custom-component /><custom-component></custom-component><i /><i></i><Component /><Component></Component>{{! Prettier 2.8.1 }}<div></div><div></div><custom-component></custom-component><custom-component></custom-component><i></i><i></i><Component /><Component />{{! Prettier 2.8.2 }}<div /><div></div><custom-component /><custom-component></custom-component><i /><i></i><Component /><Component />
Allow custom "else if"-like blocks with block params (#13930 by@jamescdavis)
#13507 added support for custom block keywords used withelse
, but failed to allow block params. This updates printer-glimmer to allow block params with custom "else if"-like blocks.
{{! Input }}{{#whenisAtWorkas |work|}} Ship that{{work}}!{{else when isReading as |book|}} You can finish{{book}} eventually...{{else}} Go to bed!{{/when}}{{! Prettier 2.8.1 }}{{#whenisAtWorkas |work|}} Ship that{{work}}!{{else when isReading}} You can finish{{book}} eventually...{{else}} Go to bed!{{/when}}{{! Prettier 2.8.2 }}{{#whenisAtWorkas |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 by@jneander)
/* 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 withlet[
(#14000,#14044 by@fisker,@thorn0)
// Input(let[0]=2);// Prettier 2.8.1let[0]=2;// Prettier 2.8.1 (second format)SyntaxError:Unexpectedtoken(1:5)>1|let[0]=2;|^2|// Prettier 2.8.2(let)[0]=2;
Fix semicolon duplicated at the end of LESS file (#14007 by@mvorisek)
// 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 by@mvorisek)
// 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 by@mvorisek)
// 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 by@fisker)
// InputclassA{ @​dec()// commentaccessorb;}// Prettier 2.8.1classA{ @​dec()accessor// commentb;}// Prettier 2.8.1 (second format)classA{ @​dec()accessor;// commentb;}// Prettier 2.8.2classA{ @​dec()// commentaccessorb;}
Add parentheses for TSTypeQuery to improve readability (#14042 by@onishi-kohei)
// Inputaas(typeofnode.children)[number]aas(typeofnode.children)[]aas((typeofnode.children)[number])[]// Prettier 2.8.1aastypeofnode.children[number];aastypeofnode.children[];aastypeofnode.children[number][];// Prettier 2.8.2aas(typeofnode.children)[number];aas(typeofnode.children)[];aas(typeofnode.children)[number][];
Fix displacing of comments in default switch case (#14047 by@thorn0)
It was a regression in Prettier 2.6.0.
// Inputswitch(state){default:result=state;// no changebreak;}// Prettier 2.8.1switch(state){default:// no changeresult=state;break;}// Prettier 2.8.2switch(state){default:result=state;// no changebreak;}
Support type annotations on auto accessors viababel-ts
(#14049 by@sosukesuzuki)
The bug that@babel/parser
cannot parse auto accessors with type annotations has been fixed. So we now support it viababel-ts
parser.
classFoo{ accessorprop:number;}
Fix formatting of empty type parameters (#14073 by@fisker)
// Inputconstfoo:bar</* comment */> = () =>baz;// Prettier 2.8.1Error:Comment"comment"wasnotprinted.Pleasereportthiserror!// Prettier 2.8.2const foo:bar</* comment */>=()=>baz;
Add parentheses to head ofExpressionStatement
instead of the whole statement (#14077 by@fisker)
// 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 by@fisker)
// Input"use strict"/* comment */;// Prettier 2.8.1 (with other js parsers except `babel`)Error:Comment"comment"wasnotprinted.Pleasereportthiserror!// Prettier 2.8.2<Sameasinput>
Fix formatting for comments inside JSX attribute (#14082 by@fisker)
// InputfunctionMyFunctionComponent(){<buttonlabel=/*old*/"new">button</button>}// Prettier 2.8.1Error:Comment"old"wasnotprinted.Pleasereportthiserror!// Prettier 2.8.2functionMyFunctionComponent(){<buttonlabel=/*old*/"new">button</button>;}
Quote numeric keys for json-stringify parser (#14083 by@fisker)
// Input{0:'value'}// Prettier 2.8.1{0:"value"}// Prettier 2.8.2{"0":"value"}
Fix removing commas from function arguments in maps (#14089 by@sosukesuzuki)
/* 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 by@fisker)
// Inputa {color: @​colors[@​white];}// Prettier 2.8.1a {color: @​colors[ @​white];}// Prettier 2.8.2<Same asinput>
Compare Source
diff
// 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 forAuto Accessors Syntax landed in TypeScript 4.9.
(Doesn't work well withbabel-ts
parser)
classFoo{ accessorfoo:number=3;}
Compare Source
diff
🔗Release Notes
Compare Source
diff
Keep useful empty lines in description (#13013 by@chimurai)
Compare Source
"""
First line
Second Line
"""
type Person {
name: String
}
Compare Source
diff
Fix LESS/SCSS format error (#12536 by@fisker)
// Input.background-gradient(@​cut) {background:linear-gradient(toright, @​white0%, @​white (@​cut -0.01%), @​portal-background @​cut, @​portal-background100% );}// Prettier 2.6.1TypeError: Cannot read properties of undefined (reading'endOffset')// Prettier 2.6.2.background-gradient(@​cut) {background:linear-gradient(toright, @​white0%, @​white (@​cut -0.01%), @​portal-background @​cut, @​portal-background100% );}
Fixes bugs when parsing following valid code:
constelement=<p>{/w/.test(s)}</p>;
classAextendsB{ #privateMethod(){super.method();}}
Compare Source
diff
Ignoreloglevel
when printing information (#12477 by@fisker)
Compare Source
prettier --loglevel silent --find-config-path index.js
Uh oh!
There was an error while loading.Please reload this page.
This PR contains the following updates:
^2.5.1
->^3.0.0
Release Notes
prettier/prettier (prettier)
v3.4.1
Compare Source
diff
Remove unnecessary parentheses around assignment in
v-on
(#16887 by@fisker)<!-- Input --><template> <button @​click="foo += 2">Click</button></template><!-- Prettier 3.4.0 --><template> <button @​click="(foo += 2)">Click</button></template><!-- Prettier 3.4.1 --><template> <button @​click="foo += 2">Click</button></template>
v3.4.0
Compare Source
diff
🔗Release Notes
v3.3.3
Compare Source
diff
Add parentheses for nullish coalescing in ternary (#16391 by@cdignam-segment)
This change adds clarity to operator precedence.
Add parentheses for decorator expressions (#16458 by@y-schneider)
Prevent parentheses around member expressions or tagged template literals from being removed to follow the stricter parsing rules of TypeScript 5.5.
Support
@let
declaration syntax (#16474 by@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:For more details, please refer to the excellent blog post by the Angular Team:Introducing @let in Angular.
We also appreciate the Angular Team for kindly answering our questions to implement this feature.
v3.3.2
Compare Source
diff
Fix handlebars path expressions starts with
@
(#16358 by@Princeyadav05)v3.3.1
Compare Source
diff
Preserve empty lines in front matter (#16347 by@fisker)
Preserve explicit language in front matter (#16348 by@fisker)
Avoid line breaks in import attributes (#16349 by@fisker)
v3.3.0
Compare Source
diff
🔗Release Notes
v3.2.5
Compare Source
diff
Support Angular inline styles as single template literal (#15968 by@sosukesuzuki)
Angular v17 supports single string inline styles.
Unexpected embedded formatting for Angular template (#15969 by@JounQin)
Computed template should not be considered as Angular component template
Use
"json"
parser fortsconfig.json
by default (#16012 by@sosukesuzuki)Inv2.3.0, we introduced
"jsonc"
parser which adds trialing commaby default.When adding a new parser we also define how it will be used based on the
linguist-languages
data.tsconfig.json
is a special file used byTypeScript, it uses.json
file extension, but it actually uses theJSON 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 yourtsconfig.json
files, add the following to your.pretterrc
filev3.2.4
Compare Source
diff
Fix incorrect parser inference (#15947 by@fisker)
Files like
.eslintrc.json
were incorrectly formatted as JSONC files.v3.2.3
Compare Source
diff
Throw errors for invalid code (#15881 by@fisker,@Josh-Cena,@auvred)
Fix parser inference (#15927 by@fisker)
v3.2.2
Compare Source
diff
Fix crash when parsing template literal CSS in a JSX style tag using a spread attribute (#15896 by@eelco)
For example this code would crash before:
Fix formatting error on optional call expression and member chain (#15920 by@sosukesuzuki)
v3.2.1
Compare Source
diff
Fix formatting error on member chain (#15915 by@sosukesuzuki)
v3.2.0
Compare Source
diff
🔗Release Notes
v3.1.1
Compare Source
diff
Fix config file search (#15363 by@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.
Skip explicitly passed symbolic links with
--no-error-on-unmatched-pattern
(#15533 by@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
istrue
(#15662 by@auvred)Improve config file search (#15663 by@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 by@sosukesuzuki)
Support "Import Attributes" (#15718 by@fisker)
TypeScript 5.3 supports the latest updates to theimport attributes proposal.
Fix false claim in docs that cursorOffset is incompatible with rangeStart/rangeEnd (#15750 by@ExplodingCabbage)
The cursorOffset option has in fact been compatible with rangeStart/rangeEnd for over 5 years, thanks to work by@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 emptyimport
statements (#15756 by@fisker)Keep empty import attributes and assertions (#15757 by@fisker)
v3.1.0
Compare Source
diff
🔗Release Notes
v3.0.3
Compare Source
diff
Add
preferUnplugged: true
topackage.json
(#15169 by@fisker and@so1ve)Prettier v3 uses dynamic imports, userwill need to unplug Prettier when Yarn's PnP mode is enabled, add
preferUnplugged: true
topackage.json
, so Yarn will install Prettier as unplug by default.Support shared config that forbids
require()
(#15233 by@fisker)If an external shared config package is used, and the package
exports
don't haverequire
ordefault
export.In Prettier 3.0.2 Prettier fails when attempt to
require()
the package, and throws an error.Allow argument of
require()
to break (#15256 by@fisker)Do not print trailing commas in arrow function type parameter lists in
ts
code blocks (#15286 by@sosukesuzuki)Support TypeScript 5.2
using
/await using
declaration (#15321 by@sosukesuzuki)Support for the upcoming Explicit Resource Management feature in ECMAScript.
using
/await using
declarationv3.0.2
Compare Source
diff
Break after
=
of assignment if RHS is poorly breakable AwaitExpression or YieldExpression (#15204 by@seiyab)Do not add trailing comma for grouped scss comments (#15217 by@auvred)
Print
declare
andexport
keywords for nested namespace (#15249 by@sosukesuzuki)v3.0.1
Compare Source
diff
Fix cursor positioning for a special case (#14812 by@fisker)
Fix plugins/estree.d.ts to make it a module (#15018 by@kingyue737)
Add
export {}
inplugins/estree.d.ts
to fix the "File is not a module" errorAdd parenthesis around leading multiline comment in return statement (#15037 by@auvred)
Add support for Vue "Generic Components" (#15066 by@auvred)
https://blog.vuejs.org/posts/vue-3-3#generic-components
<!-- Input --><script setup lang="ts" generic="T extends Type1 & Type2 & (Type3 | Type4), U extends string | number | boolean"></script><!-- Prettier 3.0.0 --><script setup lang="ts" generic="T extends Type1 & Type2 & (Type3 | Type4), U extends string | number | boolean"></script><!-- Prettier 3.0.1 --><script setup lang="ts" generic=" T extends Type1 & Type2 & (Type3 | Type4), U extends string | number | boolean "></script>
Fix comments print in
IfStatement
(#15076 by@fisker)Add missing type definition for
printer.preprocess
(#15123 by@so1ve)Add missing
getVisitorKeys
method type definition forPrinter
(#15125 by@auvred)Add typing to support
readonly
array properties of AST Node (#15127 by@auvred)Add space before unary minus followed by a function call (#15129 by@pamelalozano)
v3.0.0
Compare Source
diff
🔗Release Notes
v2.8.8
Compare Source
This version is a republished version of v2.8.7.
A bad version was accidentally published andit can't be unpublished, apologies for the churn.
v2.8.7
Compare Source
diff
Allow multiple decorators on same getter/setter (#14584 by@fisker)
v2.8.6
Compare Source
diff
Allow decorators on private members and class expressions (#14548 by@fisker)
v2.8.5
Compare Source
diff
Support TypeScript 5.0 (#14391 by@fisker,#13819 by@fisker,@sosukesuzuki)
TypeScript 5.0 introduces two new syntactic features:
const
modifiers for type parametersexport type *
declarationsAdd missing parentheses for decorator (#14393 by@fisker)
Add parentheses for
TypeofTypeAnnotation
to improve readability (#14458 by@fisker)Support
max_line_length=off
when parsing.editorconfig
(#14516 by@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
ofInfinity
rather than being ignored(which previously resulted in the default
printWidth
of 80 being applied, if not overridden by Prettier-specific configuration).v2.8.4
Compare Source
diff
Fix leading comments in mapped types with
readonly
(#13427 by@thorn0,@sosukesuzuki)Group params in opening block statements (#14067 by@jamescdavis)
This is a follow-up to#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.
Ignore files in
.sl/
(#14206 by@bolinfest)InSapling SCM,
.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 by@fisker)Fix parens in inferred function return types with
extends
(#14279 by@fisker)v2.8.3
Compare Source
diff
Allow self-closing tags on custom elements (#14170 by@fisker)
SeeAngular v15.1.0 release note for details.
v2.8.2
Compare Source
diff
Don't lowercase link references (#13155 by@DerekNonGeneric &@fisker)
Preserve self-closing tags (#13691 by@dcyriller)
Allow custom "else if"-like blocks with block params (#13930 by@jamescdavis)
#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.Preserve empty lines between nested SCSS maps (#13931 by@jneander)
Fix missing parentheses when an expression statement starts with
let[
(#14000,#14044 by@fisker,@thorn0)Fix semicolon duplicated at the end of LESS file (#14007 by@mvorisek)
Fix no space after unary minus when followed by opening parenthesis in LESS (#14008 by@mvorisek)
Do not change case of property name if inside a variable declaration in LESS (#14034 by@mvorisek)
Fix formatting for auto-accessors with comments (#14038 by@fisker)
Add parentheses for TSTypeQuery to improve readability (#14042 by@onishi-kohei)
Fix displacing of comments in default switch case (#14047 by@thorn0)
It was a regression in Prettier 2.6.0.
Support type annotations on auto accessors via
babel-ts
(#14049 by@sosukesuzuki)The bug that
@babel/parser
cannot parse auto accessors with type annotations has been fixed. So we now support it viababel-ts
parser.Fix formatting of empty type parameters (#14073 by@fisker)
Add parentheses to head of
ExpressionStatement
instead of the whole statement (#14077 by@fisker)Fix comments after directive (#14081 by@fisker)
Fix formatting for comments inside JSX attribute (#14082 by@fisker)
Quote numeric keys for json-stringify parser (#14083 by@fisker)
Fix removing commas from function arguments in maps (#14089 by@sosukesuzuki)
Do not insert space in LESS property access (#14103 by@fisker)
v2.8.1
Compare Source
diff
Fix SCSS map in arguments (#9184 by@agamkrbit)
Support auto accessors syntax (#13919 by@sosukesuzuki)
Support forAuto Accessors Syntax landed in TypeScript 4.9.
(Doesn't work well with
babel-ts
parser)v2.8.0
Compare Source
diff
🔗Release Notes
v2.7.1
Compare Source
diff
Keep useful empty lines in description (#13013 by@chimurai)
v2.7.0
Compare Source
"""
First line
Second Line
"""
type Person {
name: String
}
v2.6.2
Compare Source
diff
Fix LESS/SCSS format error (#12536 by@fisker)
Update
meriyah
to fix several bugs (#12567 by@fisker, fixes inmeriyah
by@3cp)Fixes bugs when parsing following valid code:
v2.6.1
Compare Source
diff
Ignore
loglevel
when printing information (#12477 by@fisker)v2.6.0
Compare Source
prettier --loglevel silent --find-config-path index.js
Configuration
📅Schedule: Branch creation - "* 0-3 * * 1" (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 was generated byMend Renovate. View therepository job log.