Releases · biomejs/biome

@arendjr

CLI

New features

GritQL queries that match functions or methods will now match async functions or methods as well.

If this is not what you want, you can capture the async keyword (or its absence) in a metavariable and assert its emptiness:
```
$async function foo() {} where $async <: .
```
Contributed by @arendjr

Bug fixes

Fix #4077: Grit queries no longer need to match the statement's trailing semicolon. Contributed by @arendjr
Fix #4102. Now the CLI command lint doesn't exit with an error code when using --write/--fix. Contributed by @ematipico

Configuration

Bug fixes

Fix #4125, where noLabelWithoutControl options where incorrectly marked as mandatory. Contributed by @ematipico

Editors

Fix a case where CSS files weren't correctly linted using the default configuration. Contributed by @ematipico

Formatter

Bug fixes

Fix #3924 where GraphQL formatter panics in block comments with empty line. Contributed by @vohoanglong0107

Fix a case where raw values inside url() functions weren't properly trimmed.

.value {
-  background: url(
-   whitespace-around-string
-  );
+ background: url(whitespace-around-string);
}

Contributed by @ematipico

Fixed #4076, where a media query wasn't correctly formatted:

.class {
-  @media (1024px <= width <=1280px) {
+  @media (1024px <= width <= 1280px) {
   color: red;
   }
}

Contributed by @blaze-d83

JavaScript API

Bug fixes

Fix #3881, by updating the APIs to use the latest WASM changes. Contributed by @ematipico

Linter

New features

Add noDescendingSpecificity. Contributed by @tunamaguro
Add noNestedTernary. Contributed by @kaykdm
Add noTemplateCurlyInString. Contributed by @fireairforce
Add noOctalEscape. Contributed by @fireairforce

Bug fixes

noControlCharactersInRegex no longer panics on regexes with incomplete escape sequences. Contributed by @Conaclos
noMisleadingCharacterClass no longer reports issues outside of character classes.

The following code is no longer reported:
```
/[a-z]👍/;
```
Contributed by @Conaclos
noUndeclaredDependencies no longer reports Node.js builtin modules as undeclared dependencies.

The rule no longer reports the following code:
```
import * as fs from "fs";
```
Contributed by @Conaclos
noUnusedVariables no longer panics when suggesting the renaming of a variable at the start of a file (#4114). Contributed by @Conaclos
noUselessEscapeInRegex no longer panics on regexes that start with an empty character class. Contributed by @Conaclos
noUselessStringConcat no longer panics when it encounters malformed code. Contributed by @Conaclos
noUnusedFunctionParameters no longer reports unused parameters inside an object pattern with a rest parameter.

In the following code, the rule no longer reports a as unused.
```
function f({ a, ...rest }) {
  return rest;
}
```
This matches the behavior of noUnusedVariables.

Contributed by @Conaclos
useButtonType no longer reports dynamically created button with a valid type (#4072).

The following code is no longer reported:
```
React.createElement("button", { type: "button" }, "foo")
```
Contributed by @Conaclos
useSemanticElements now ignores elements with the img role (#3994).

MDN recommends using role="img" for grouping images or creating an image from other elements.
The following code is no longer reported:
```
<div role="img" aria-label="That cat is so cute">
  <p>&#x1F408; &#x1F602;</p>
</div>
```
Contributed by @Conaclos
useSemanticElements now ignores alert and alertdialog roles (#3858). Contributed by @Conaclos
noUselessFragments don't create invaild JSX code when Fragments children contains JSX Expression and in a LogicalExpression. Contributed by @fireairforce

Parser

Bug fixes

Forbid undefined as type name for typescript parser. Contributed by @fireairforce

What's Changed

Other changes

fix(bench): typo in .prettierignore by @Jayllyz in #4134
feat(formatter): implement formatting for GritQL root node by @arendjr in #4128
feat(useExhaustiveDependencies): add option to disable errors for unecessary dependencies by @simon-paris in #4135
perf(linter): remove unneeded memory allocation for str by @togami2864 in #4142
fix: add missing word by @lanker in #4150

New Contributors

@blaze-d83 made their first contribution in #4083
@simon-paris made their first contribution in #4135

Full Changelog: cli/v1.9.3-nightly.75b4387...cli/v1.9.3

@arendjr

Analyzer

CLI

New features

GritQL queries that match functions or methods will now match async functions or methods as well.

If this is not what you want, you can capture the async keyword (or its absence) in a metavariable and assert its emptiness:
```
$async function foo() {} where $async <: .
```
Contributed by @arendjr

Bug fixes

Fix #4077: Grit queries no longer need to match the statement's trailing semicolon. Contributed by @arendjr

Configuration

Editors

Formatter

Bug fixes

Fix #3924 where GraphQL formatter panics in block comments with empty line. Contributed by @vohoanglong0107

JavaScript API

Linter

New features

Add noTemplateCurlyInString. Contributed by @fireairforce
Add NoOctalEscape. Contributed by @fireairforce

Bug fixes

noMisleadingCharacterClass no longer reports issues outside of character classes.

The following code is no longer reported:
```
/[a-z]👍/;
```
Contributed by @Conaclos
noUndeclaredDependencies no longer reports Node.js builtin modules as undeclared dependencies.

The rule no longer reports the following code:
```
import * as fs from "fs";
```
Contributed by @Conaclos
noUselessEscapeInRegex no longer panics on regexes that start with an empty character class. Contributed by @Conaclos
noUselessStringConcat no longer panics when it encounters malformed code. Contributed by @Conaclos
noUnusedFunctionParameters no longer reports unused parameters inside an object pattern with a rest parameter.

In the following code, the rule no longer reports a as unused.
```
function f({ a, ...rest }) {
  return rest;
}
```
This matches the behavior of noUnusedVariables.

Contributed by @Conaclos
useButtonType no longer reports dynamically created button with a valid type (#4072).

The following code is no longer reported:
```
React.createElement("button", { type: "button" }, "foo")
```
Contributed by @Conaclos
useSemanticElements now ignores elements with the img role (#3994).

MDN recommends using role="img" for grouping images or creating an image from other elements.
The following code is no longer reported:
```
<div role="img" aria-label="That cat is so cute">
  <p>&#x1F408; &#x1F602;</p>
</div>
```
Contributed by @Conaclos
useSemanticElements now ignores alert and alertdialog roles (#3858). Contributed by @Conaclos
noUselessFragments don't create invaild JSX code when Fragments children contains JSX Expression and in a LogicalExpression. Contributed by @fireairforce

Parser

Bug fixes

Forbid undefined as type name for typescript parser. Contributed by @fireairforce

What's Changed

Other changes

test(format/html): reenable snapshot tests by @dyc3 in #3979
refactor(lint): set version field for new rules by @Conaclos in #3995
docs: improve documentation of rule by @ematipico in #3999
feat(linter): implement noOctalEscape by @fireairforce in #3986
feat(grit): implement GritQL log() function by @arendjr in #4003
fix(html/parser): support root element list by @suxin2017 in #3985
feat(html/formatter): self close tag add slash char by @suxin2017 in #3984
chore(readme): use polar shield by @ematipico in #4000
feat: add additional FeatureKind entries for debug features by @dyc3 in #3892
feat(formatter/html): add line break at the end of files by @dyc3 in #4010
fix(parser/html): fix incorrect parsing when text starts with a quote by @dyc3 in #4011
chore(cli): replace PanicInfo -> PanicHookInfo by @minht11 in #4015
chore: enforce usage of to_ascii_lowercase_cow by @minht11 in #4014
chore: fix udeps failure by @dyc3 in #4016
feat(linter): implement useExplicitFunctionReturnType by @kaykdm in #3990
fix(parser/html): allow multi line attribute values by @dyc3 in #4018
feat(lsp): noExcessiveCognitiveComplexity diagnostic shows levels by @chrisgrieser in #4028
feat(html): implement debug features for html by @dyc3 in #4019
fix(parser/html): add param to void elements list by @dyc3 in #4020
feat(html): resolve format options by @dyc3 in #4017
test(format/grit): add tests for grit formatter by @branberry in #3937
perf(grit): use to_ascii_lowercase_cow by @dyc3 in #4053
perf(linter): performance improvement for css semantic model by @togami2864 in #4044
refactor(aria_metadata): generate ARIA metadata from specification by @Conaclos in #4055
refactor(parser/html): refactor comments to be nodes in the tree by @dyc3 in #4056
feat(markdown/parser): support thematic break block parser by @suxin2017 in #3982
feat(linter): implement no-nested-ternary by @kaykdm in #4067
fix(format/html): keep at most 1 empty line between elements by @dyc3 in #4057
fix(schema): make optional the options JSON schema field by @Conaclos in #4080
feat(grit): implement disregarded snippet nodes by @arendjr in #4084
chore: to_lowercase -> to_lowercase_cow by @minht11 in #4030
docs: fix isNan to isNaN by @Omochice in #4106

New Contributors

@kaykdm made their first contribution in #3990
@chrisgrieser made their first contribution in #4028
@Omochice made their first contribution in #4106

Full Changelog: cli/v1.9.2...cli/v1.9.3-nightly.75b4387

@arendjr

CLI

New features

Added support for custom GritQL definitions, including:
- Pattern and predicate definitions: https://docs.grit.io/guides/patterns
- Function definitions: https://docs.grit.io/language/functions#function-definitions
Contributed by @arendjr

Bug fixes

Fix #3917, where the fixed files were incorrectly computed. Contributed by @ematipico
Fixed an issue that caused GritQL contains queries to report false positives when the matched
node appeared inside a sibling node. Contributed by @arendjr

Editors

Bug fixes

Fix #3923. Now the .editorconfig is correctly parsed by the LSP, and the options are correctly applied to files when formatting is triggered.
Plus, the Biome LSP now watches for any change to the .editorconfig, and updates the formatting settings.
Reduced the number of log files generated by the LSP server. Now the maximum number of logs saved on disk is seven. Contributed by @ematipico
Fix the code actions capabilities available in the LSP Biome server. Before, the LSP was using the default capabilities, which resulted in pulling code actions even when they were disabled by the editor.

This means that the code actions are pulled by the client only when the editor enables quickfix.biome, source.organizeImports.biome and source.fixAll.biome.

Now, if you enable organizeImports.enabled: true in the biome.json, and then you configure your editor with the following code action source.organizeImports.biome: false, the editor won't sort the imports.

Contributed by @ematipico

Linter

New features

Add nursery/noMissingVarFunction. Contributed by @michellocana
Add nursery/useComponentExportOnlyModules. Use this rule in React projects to enforce a code styling that fits React Refresh. Contributed by @GunseiKPaseri

Bug fixes

noLabelWithoutControl now accept JSX expression as label value (#3875). Contributed by @Conaclos
useFilenamingConvention no longer suggests names with a disallowed case (#3952). Contributed by @Conaclos
useFilenamingConvention now recognizes file names starting with ASCII digits as lowercase (#3952).

Thus, 2024-09-17-filename, 2024_09_17_filename and 20240917FileName are in kebab-case, snake_case, and camelCase respectively.

Contributed by @Conaclos
useFilenamingConvention now applies the configured formats to the file extensions (#3650). Contributed by @Conaclos

Parser

Bug fixes

useStrictMode now reports Script files with some directives, but without the use strict directive. Contributed by @Conaclos
The CSS parser now accepts the characters U+FFDCF and U+FFFD in identifiers. Contributed by @Conaclos

What's Changed

Other changes

chore: update biome version of rules by @nhedger in #3901
chore(ci): add gh token for setup-rust by @Jayllyz in #3902
fix(deps): update rust crates by @renovate in #3910
chore(deps): update rust crate serde_json to 1.0.128 by @renovate in #3909
feat(format/grit): grit formatter initial configuration by @branberry in #3885
docs(readme): add zh-tw readme translation by @jacklee814 in #3894
chore(deps): update dependency eslint to v9.10.0 by @renovate in #3913
chore(deps): update rust crate tokio to 1.40.0 by @renovate in #3918
chore(deps): update rust docker tag to v1.81.0 by @renovate in #3919
fix: re-implement #3856 to improve correctness by @anthonyshew in #3865
chore(deps): update rust crate insta to 1.40.0 by @renovate in #3916
chore(deps): update rust crate dashmap to 6.1.0 by @renovate in #3915
chore(deps): update dependency @typescript-eslint/eslint-plugin to v8.5.0 by @renovate in #3912
chore(deps): update @biomejs packages by @renovate in #3911
chore(deps): update rust crate serde to 1.0.210 by @renovate in #3906
chore(deps): update rust crate anyhow to 1.0.89 by @renovate in #3905
fix(parser/html): fix whitespace being lexed as html literal by @dyc3 in #3908
fix(config): handle unset and off values in editorconfig files by @dyc3 in #3907
fix: preserve other children in useConsistentCurlyBraces by @suzak in #3925
test: fix outdated snapshot tests by @ematipico in #3953
feat(format/html): port JsxChildList formatting to HtmlElementList by @dyc3 in #3782
chore(deps): update dependency vite to v5.4.6 [security] by @renovate in #3963
fix(parser/html): check void element names case insensitively by @dyc3 in #3959
fix(format/html): keep single quotes if string contains a double quote by @dyc3 in #3960
fix(format/html): fix doctype formatting by @dyc3 in #3961
feat(markdown): support markdown grammar code generation by @suxin2017 in #3775
feat(parser/html): lex and parse unquoted attribute values by @dyc3 in #3951
feat(parser/html): parse doctype declarations by @dyc3 in #3962
feat(parser/html): handle script and style tags by @dyc3 in #3970
build: upgrade to Rust 1.81 by @Conaclos in #3972
feat(html): add experimental-html feature flag to enable html file handler by @dyc3 in #3967
feat(grit): support for Grit pattern, predicate and function definitions by @arendjr in #3983
feat(grit): implement Grit built-ins by @arendjr in #3987
fix(grit): fix node walking by @arendjr in #3988

New Contributors

@branberry made their first contribution in #3885
@jacklee814 made their first contribution in #3894
@suzak made their first contribution in #3925

Full Changelog: cli/v1.9.1...cli/v1.9.2

@dyc3

Analyzer

CLI

Bug fixes

useEditorConfig now loads the editorconfig when running biome ci #3864. Contributed by @dyc3
Revert #3731 to fix broken quick fixes and code actions. Contributed by @nhedger

Linter

New Features

Add nursery/noProcessEnv. Contributed by @unvalley

Bug fixes

useSemanticElements now ignores alert and alertdialog roles (3858). Contributed by @Conaclos
noUndeclaredDependencies now ignores @/ imports and recognizes type imports from Definitely Typed and bun imports. Contributed by @Conaclos

What's Changed

Other changes

docs: update snippet ignore file on useFilenamingConvention rule by @iamyuu in #3884
feat(format/html): attribute formatting by @dyc3 in #3783
chore: add noConsole options documentation by @mrazauskas in #3888
chore: tweak useConsistentArrayType rule documentation by @mrazauskas in #3891
chore: remove sponsor by @nhedger in #3896

New Contributors

@iamyuu made their first contribution in #3884

Full Changelog: cli/v1.9.1-nightly.12688b6...cli/v1.9.1

@dyc3

Analyzer

CLI

Bug fixes

useEditorConfig now loads the editorconfig when running biome ci #3864. Contributed by @dyc3

Configuration

Editors

Formatter

JavaScript APIs

Linter

Bug fixes

useSemanticElements: ignore alert and alertdialog roles (3858). Controbuted by @Conaclos

Parser

What's Changed

Other changes

chore: fix docs comments by @tiaoxizhan in #3857
feat(parser/html): correctly parse void elements by @dyc3 in #3854
fix: update eslint-plugin-solid docs position by @JamBalaya56562 in #3866
chore: add more logs for #3839 by @dyc3 in #3880

New Contributors

@tiaoxizhan made their first contribution in #3857
@JamBalaya56562 made their first contribution in #3866

Full Changelog: cli/v1.9.0...cli/v1.9.1-nightly.12688b6

@togami2864

Analyzer

Implement the semantic model for CSS. Contributed by @togami2864

CLI

New features

Add --graphql-linter-enabled option, to control whether the linter should be enabled or not for GraphQL files. Contributed by @ematipico
New EXPERIMENTAL search command. The search command allows you to search a Biome project using GritQL syntax.

GritQL is a powerful language that lets you do structural searches on your codebase. This means that trivia such as whitespace or even the type of strings quotes used will be ignored in your search query. It also has many features for querying the structure of your code, making it much more elegant for searching code than regular expressions.

While we believe this command may already be useful to users in some situations (especially when integrated in the IDE extensions!), we also had an ulterior motive for adding this command: We intend to utilize GritQL for our plugin efforts, and by allowing our users to try it out in a first iteration, we hope to gain insight in the type of queries you want to do, as well as the bugs we need to focus on.

For now, the search command is explicitly marked as EXPERIMENTAL, since many bugs remain. Keep this in mind when you try it out, and please let us know your issues!

Note: GritQL escapes code snippets using backticks, but most shells interpret backticks as command invocations. To avoid this, it's best to put single quotes around your Grit queries.
```
biome search '`console.log($message)`' # find all `console.log` invocations
```
Contributed by @arendjr and @BackupMiles

The option --max-diagnostics now accept a none value, which lifts the limit of diagnostics shown. Contributed by @ematipico

Add a new reporter --reporter=gitlab, that emits diagnostics for using the GitLab Code Quality report.

[
  {
    "description": "Use === instead of ==. == is only allowed when comparing against `null`",
    "check_name": "lint/suspicious/noDoubleEquals",
    "fingerprint": "6143155163249580709",
    "severity": "critical",
    "location": {
      "path": "main.ts",
      "lines": {
        "begin": 4
      }
    }
  }
]

Contributed by @NiclasvanEyk

Add new options to the lsp-proxy and start commands:
- --log-path: a directory where to store the daemon logs. The commands also accepts the environment variable BIOME_LOG_PATH.
- --log-prefix-name: a prefix that's added to the file name of the logs. It defaults to server.log. The commands also accepts the environment variable BIOME_LOG_PREFIX_NAME.
@contributed by @ematipico

Enhancements

When a --reporter is provided, and it's different from the default one, the value provided by via --max-diagnostics is ignored and the limit is lifted. Contributed by @ematipico
biome init now generates a new config file with more options set.
This change intends to improve discoverability of the options and to set the more commonly used options to their default values.
Contributed by @Conaclos

The --verbose flag now reports the list of files that were evaluated, and the list of files that were fixed.
The evaluated files are the those files that can be handled by Biome, files that are ignored, don't have an extension or have an extension that Biome can't evaluate are excluded by this list.
The fixed files are those files that were handled by Biome and changed. Files that stays the same after the process are excluded from this list.

 VERBOSE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Files processed:

  - biome/biome.json
  - biome/packages/@biomejs/cli-win32-arm64/package.json
  - biome/packages/tailwindcss-config-analyzer/package.json

 VERBOSE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Files fixed:

  - biome/biome/packages/tailwindcss-config-analyzer/src/generate-tailwind-preset.ts

Contributed by @ematipico

Allow passing nursery to the --only and --skip filters.

The --only option allows you to run a given rule or rule group.
The --skip option allows you to skip the execution of a given group or a given rule.

Previously, it was not possible to pass nursery.
This restriction is now removed, as it may make sense to skip the nursery rules that a project has enabled.

Contributed by @Conaclos
The CLI now returns an error code when calling a command in stdin mode, and the contents of the files aren't fixed. For example, the following example will result in an error code of 1 because the lint command triggers some lint rules:
```
echo "let x = 1" | biome lint --stdin-file-path=stdin.js
```
Contributed by @ematipico

Bug fixes

biome lint --write now takes --only and --skip into account (#3470). Contributed by @Conaclos
Fix #3368, now the reporter github tracks the diagnostics that belong to formatting and organize imports. Contributed by @ematipico
Fix #3545, display a warning, 'Avoid using unnecessary Fragment,' when a Fragment contains only one child element that is placed on a new line. Contributed by @satojin219
Migrating from Prettier or ESLint no longer overwrite the overrides field from the configuration (#3544). Contributed by @Conaclos
Fix JSX expressions for noAriaHiddenOnFocusable (#3708). Contributed by @anthonyshew
Fix edge case for <canvas> elements that use role="img" (#3728). Contributed by @anthonyshew
Fix #3633, where diagnostics where incorrectly printed if the code has errors. Contributed by @ematipico
Allow aria-label on heading to prevent useHeadingContent diagnostic (#3767). Contributed by @anthonyshew
Fix edge case #3791 for rule noFocusedTests being used with non-string-like expressions (#3793). Contributed by @h-a-n-a
Fix optional ARIA properties for role="separator" in useAriaPropsForRole (#3856). Contributed by @anthonyshew

Configuration

Add support for loading configuration from .editorconfig files (#1724).

Configuration supplied in .editorconfig will be overridden by the configuration in biome.json. Support is disabled by default and can be enabled by adding the following to your formatter configuration in biome.json:
```
{
  "formatter": {
    "useEditorconfig": true
  }
}
```
Contributed by @dyc3

overrides from an extended configuration is now merged with the overrides of the extension.

Given the following shared configuration biome.shared.json:

{
  "overrides": [
    {
      "include": ["**/*.json"],
      // ...
    }
  ]
}

and the following configuration:

{
  "extends": ["./biome.shared.json"],
  "overrides": [
    {
      "include": ["**/*.ts"],
      // ...
    }
  ]
}

Previously, the overrides from biome.shared.json was overwritten.
It is now merged and results in the following configuration:

{
  "extends": ["./biome.shared.json"],
  "overrides": [
    {
      "include": ["**/*.json"],
      // ...
    },
    {
      "include": ["**/*.ts"],
      // ...
    }
  ]
}

Contributed by @Conaclos

Editors

Fix #3577, where the update of the configuration file was resulting in the creation of a new internal project. Contributed by @ematipico
Fix #3696, where biome.jsonc was incorrectly parsed with incorrect options. Contributed by @ematipico

Formatter

The CSS formatter is enabled by default. Which means that you don't need to opt-in anymore using the configuration file biome.json:
```
{
-  "css": {
-    "formatter": {
-      "enabled": true
-    }
-  }
}
```
Contributed by @ematipico
Add parentheses for nullcoalescing in ternaries.

This change aligns on Prettier 3.3.3.
This adds clarity to operator precedence.
```
- foo ? bar ?? foo : baz;
+ foo ? (bar ?? foo) : baz;
```
Contributed by @Conaclos
Keep the parentheses around infer ... extends declarations in type unions and type intersections (#3419). Contributed by @Conaclos
Keep parentheses around a yield expression inside a type assertion.

Previously, Biome removed parentheses around some expressions that require them inside a type assertion.
For example, in the following code, Biome now preserves the parentheses.
```
function* f() {
  return <T>(yield 0);
}
```
Contributed by @Conaclos
Remove parentheses around expressions that don't need them inside a decorator.

Biome now matches Pr...

@seitarof

Analyzer

New features

Implement nursery/useConsistentMemberAccessibility. Contributed by @seitarof

Enhancements

Implement css suppression action. Contributed by @togami2864
Add support of comments in turbo.json. Contributed by @Netail
Implement semantic model for CSS. Contributed by @togami2864
Integrate CSS semantic model into the analyzer. Contributed by @togami2864

CLI

New features

Add --graphql-linter-enabled option, to control whether the linter should be enabled or not for GraphQL files. Contributed by @ematipico
New EXPERIMENTAL search command. The search command allows you to search a Biome project using GritQL syntax.

GritQL is a powerful language that lets you do structural searches on your codebase. This means that trivia such as whitespace or even the type of strings quotes used will be ignored in your search query. It also has many features for querying the structure of your code, making it much more elegant for searching code than regular expressions.

While we believe this command may already be useful to users in some situations (especially when integrated in the IDE extensions!), we also had an ulterior motive for adding this command: We intend to utilize GritQL for our plugin efforts, and by allowing our users to try it out in a first iteration, we hope to gain insight in the type of queries you want to do, as well as the bugs we need to focus on.

For now, the search command is explicitly marked as EXPERIMENTAL, since many bugs remain. Keep this in mind when you try it out, and please let us know your issues!

Note: GritQL escapes code snippets using backticks, but most shells interpret backticks as command invocations. To avoid this, it's best to put single quotes around your Grit queries.
```
biome search '`console.log($message)`' # find all `console.log` invocations
```
Contributed by @arendjr and @BackupMiles

The option --max-diagnostics now accept a none value, which lifts the limit of diagnostics shown. Contributed by @ematipico

Add a new reporter --reporter=gitlab, that emits diagnostics for using the GitLab Code Quality report.

[
  {
    "description": "Use === instead of ==. == is only allowed when comparing against `null`",
    "check_name": "lint/suspicious/noDoubleEquals",
    "fingerprint": "6143155163249580709",
    "severity": "critical",
    "location": {
      "path": "main.ts",
      "lines": {
        "begin": 4
      }
    }
  }
]

Contributed by @NiclasvanEyk

Add new options to the lsp-proxy and start commands:
- --log-path: a directory where to store the daemon logs. The commands also accepts the environment variable BIOME_LOG_PATH.
- --log-prefix-name: a prefix that's added to the file name of the logs. It defaults to server.log. The commands also accepts the environment variable BIOME_LOG_PREFIX_NAME.
@contributed by @ematipico

Enhancements

When a --reporter is provided, and it's different from the default one, the value provided by via --max-diagnostics is ignored and the limit is lifted. Contributed by @ematipico
biome init now generates a new config file with more options set.
This change intends to improve discoverability of the options and to set the more commonly used options to their default values.
Contributed by @Conaclos

The --verbose flag now reports the list of files that were evaluated, and the list of files that were fixed.
The evaluated files are the those files that can be handled by Biome, files that are ignored, don't have an extension or have an extension that Biome can't evaluate are excluded by this list.
The fixed files are those files that were handled by Biome and changed. Files that stays the same after the process are excluded from this list.

 VERBOSE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Files processed:

  - biome/biome.json
  - biome/packages/@biomejs/cli-win32-arm64/package.json
  - biome/packages/tailwindcss-config-analyzer/package.json

 VERBOSE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Files fixed:

  - biome/biome/packages/tailwindcss-config-analyzer/src/generate-tailwind-preset.ts

Contributed by @ematipico

Allow passing nursery to the --only and --skip filters.

The --only option allows you to run a given rule or rule group.
The --skip option allows you to skip the execution of a given group or a given rule.

Previously, it was not possible to pass nursery.
This restriction is now removed, as it may make sense to skip the nursery rules that a project has enabled.

Contributed by @Conaclos
The CLI now returns an error code when calling a command in stdin mode, and the contents of the files aren't fixed. For example, the following example will result in an error code of 1 because the lint command triggers some lint rules:
```
echo "let x = 1" | biome lint --stdin-file-path=stdin.js
```
Contributed by @ematipico

Bug fixes

biome lint --write now takes --only and --skip into account (#3470). Contributed by @Conaclos
Fix #3368, now the reporter github tracks the diagnostics that belong to formatting and organize imports. Contributed by @ematipico
Fix #3545, display a warning, 'Avoid using unnecessary Fragment,' when a Fragment contains only one child element that is placed on a new line. Contributed by @satojin219
Migrating from Prettier or ESLint no longer overwrite the overrides field from the configuration (#3544). Contributed by @Conaclos
Fix JSX expressions for noAriaHiddenOnFocusable (#3708). Contributed by @anthonyshew
Fix edge case for <canvas> elements that use role="img" (#3728). Contributed by @anthonyshew
Fix #3633, where diagnostics where incorrectly printed if the code has errors. Contributed by @ematipico
Allow aria-label on heading to prevent useHeadingContent diagnostic (#3767). Contributed by @anthonyshew
Fix edge case #3791 for rule noFocusedTests being used with non-string-like expressions (#3793). Contributed by @h-a-n-a

Configuration

Add support for loading configuration from .editorconfig files (#1724).

Configuration supplied in .editorconfig will be overridden by the configuration in biome.json. Support is disabled by default and can be enabled by adding the following to your formatter configuration in biome.json:
```
{
  "formatter": {
    "useEditorconfig": true
  }
}
```
Contributed by @dyc3

overrides from an extended configuration is now merged with the overrides of the extension.

Given the following shared configuration biome.shared.json:

{
  "overrides": [
    {
      "include": ["**/*.json"],
      // ...
    }
  ]
}

and the following configuration:

{
  "extends": ["./biome.shared.json"],
  "overrides": [
    {
      "include": ["**/*.ts"],
      // ...
    }
  ]
}

Previously, the overrides from biome.shared.json was overwritten.
It is now merged and results in the following configuration:

{
  "extends": ["./biome.shared.json"],
  "overrides": [
    {
      "include": ["**/*.json"],
      // ...
    },
    {
      "include": ["**/*.ts"],
      // ...
    }
  ]
}

Contributed by @Conaclos

Editors

Bug fixes

Fix #3577, where the update of the configuration file was resulting in the creation of a new internal project. Contributed by @ematipico
Fix #3696, where biome.jsonc was incorrectly parsed with incorrect options. Contributed by @ematipico

Formatter

Enhancements

Add parentheses for nullcoalescing in ternaries.

This change aligns on Prettier 3.3.3.
This adds clarity to operator precedence.
```
- foo ? bar ?? foo : baz;
+ foo ? (bar ?? foo) : baz;
```
Contributed by @Conaclos
The CSS formatter is enabled by default. Which means that you don't need to opt-in anymore using the configuration file biome.json:
```
{
-  "css": {
-    "formatter": {
-      "enabled": true
-    }
-  }
}
```
Contributed by @ematipico

Bug fixes

Keep the parentheses around infer ... extends declarations in type unions and type intersections (#3419). Contributed by @Conaclos
Keep parentheses around a yield expression inside a type assertion.

Previously, Biome removed parentheses around some expressions that require them inside a type assertion.
For example, in the following code, Biome now preserves the parentheses.
```
function* f() {
  return <T>(yield 0);
}
```
Contributed by @Conaclos
Remove parentheses around expressions ...

@togami2864

Analyzer

Enhancements

Implement css suppression action. Contributed by @togami2864
Add support of comments in turbo.json. Contributed by @Netail

CLI

New features

Add --graphql-linter-enabled option, to control whether the linter should be enabled or not for GraphQL files. Contributed by @ematipico
The option --max-diagnostics now accept a none value, which lifts the limit of diagnostics shown. Contributed by @ematipico

Enhancements

When a --reporter is provided, and it's different from the default one, the value provided by via --max-diagnostics is ignored and the limit is lifted. Contributed by @ematipico
biome init now generates a new config file with more options set.
This change intends to improve discoverability of the options and to set the more commonly used options to their default values.
Contributed by Conaclos

Bug fixes

biome lint --write now takes --only and --skip into account (#3470). Contributed by Conaclos

Configuration

Add support for loading configuration from .editorconfig files (#1724). Contributed by @dyc3
Configuration supplied in .editorconfig will be overridden by the configuration in biome.json. Support is disabled by default and can be enabled by adding the following to your formatter configuration in biome.json:
```
{
  "formatter": {
    "useEditorconfig": true
  }
}
```

Formatter

Enhancements

Add parentheses for nullcoalescing in ternaries.

This change aligns on Prettier 3.3.3.
This adds clarity to operator precedence.
```
- foo ? bar ?? foo : baz;
+ foo ? (bar ?? foo) : baz;
```
Contributed by @Conaclos

Bug fixes

Keep the parentheses around infer declarations in type unions and type intersections (#3419). Contributed by @Conaclos
Keep parentheses around a yield expression inside a type assertion.

Previously, Biome removed parentheses around some expressions that require them inside a type assertion.
For example, in the following code, Biome now preserves the parentheses.
```
function* f() {
  return <T>(yield 0);
}
```
Contributed by @Conaclos

Remove parentheses around expressions that don't need them inside a decorator.

Biome now matches Prettier in the following cases:

  class {
-   @(decorator)
+   @decorator
    method() {}
  },
  class {
-   @(decorator())
+   @decorator()
    method() {}
  },
  class {
    @(decorator?.())
    method() {}
  },

Contributed by @Conaclos

Keep parentheses around objects preceded with a @satisfies comment.

In the following example, parentheses are no longer removed.
```
export const PROPS = /** @satisfies {Record<string, string>} */ ({
  prop: 0,
});
```
Contributed by @Conaclos

Linter

New features

Add support for GraphQL linting. Contributed by @ematipico
Add nursery/noDynamicNamespaceImportAccess. Contributed by @minht11
noUndeclaredVariables no longer reports a direct reference to an enum member (#2974).

In the following code, the A reference is no longer reported as an undeclared variable.
```
enum E {
  A = 1,
  B = A << 1,
}
```
Contributed by @Conaclos
Add nursery/noIrregularWhitespace. Contributed by @michellocana
Implement noIrreguluarWhitespace for CSS. Contributed by @DerTimonius
Add nursery/useTrimStartEnd. Contributed by @chansuke

Enhancements

noInvalidUseBeforeDeclaration now reports direct use of an enum member before its declaration.

In the following code, A is reported as use before its declaration.
```
enum E {
  B = A << 1,
  A = 1,
}
```
Contributed by @Conaclos
useFilenamingConvention now supports unicase letters.

unicase letters have a single case: they are neither uppercase nor lowercase.
Biome now accepts filenames in unicase.
For example, the filename 안녕하세요 is now accepted.

We still reject a name that mixes unicase characters with lowercase or uppercase characters.
For example, the filename A안녕하세요 is rejected.

This change also fixes #3353.
Filenames consisting only of numbers are now accepted.

Contributed by @Conaclos
useFilenamingConvention now supports Next.js/Nuxt/Astro dynamic routes (#3465).

Next.js, SolidStart, Nuxt, and Astro support dynamic routes such as [...slug].js and [[...slug]].js.

Biome now recognizes this syntax. slug must contain only alphanumeric characters.

Contributed by @Conaclos
useExportType no longer report empty export (#3535).

An empty export {} allows you to force TypeScript to consider a file with no imports and exports as an EcmaScript module.
While export type {} is valid, it is more common to use export {}.
Users may find it confusing that the linter asks them to convert it to export type {}.
Also, a bundler should be able to remove export {} as well as export type {}.
So it is not so useful to report export {}.

Contributed by @Conaclos
noUnusedVariables now checks TypeScript declaration files.

This allows to report a type that is unused because it isn't exported.
Global declarations files (declarations files without exports and imports) are still ignored.

Contributed by @Conaclos

Bug fixes

Don't request alt text for elements hidden from assistive technologies (#3316). Contributed by @robintown
Fix [#3149] crashes that occurred when applying the noUselessFragments unsafe fixes in certain scenarios. Contributed by @unvalley
noExcessiveNestedTestSuites: Fix another edge case where the rule would alert on heavily nested zod schemas. Contributed by @dyc3
noExtraNonNullAssertion no longer reports a single non-null assertion enclosed in parentheses (#3352). Contributed by @Conaclos
useAdjacentOverloadSignatures no longer reports a #private class member and a public class member that share the same name (#3309).

The following code is no longer reported:
```
class C {
  #f() {}
  g() {}
  f() {}
}
```
Contributed by @Conaclos
useNamingConvention now accepts applying custom convention on abstract classes. Contributed by @Conaclos
useNamingConvention no longer suggests an empty fix when a name doesn't match strict Pascal case (#3561).

Previously the following code led useNamingConvention to suggest an empty fix.
The rule no longer provides a fix for this case.
```
type AAb = any
```
Contributed by @Conaclos
useNamingConvention no longer provides fixes for global TypeScript declaration files.

Global TypeScript declaration files have no epxorts and no imports.
All the declared types are available in all files of the project.
Thus, it is not safe to propose renaming only in the declaration file.

Contributed by @Conaclos

Parser

Bug fixes

Fix #3287 nested selectors with pseudo-classes. Contributed by @denbezrukov
Fix #3349 allow CSS multiple ampersand support. Contributed by @denbezrukov

.class {
  && {
    color: red;
  }
}

Fix #3410 by correctly parsing break statements containing keywords.
```
out: while (true) {
  break out;
}
```
Contributed by @ah-yu

What's Changed

Other changes

fix(codegen): create output directory if it doesn't exist by @dyc3 in #3389
refactor(codegen): generate most functions on LanguageKind with a macro by @dyc3 in #3380
chore(grit): add auto-wrap + integrate with search command by @arendjr in #3288
refactor(formatter_test...

@SuperchupuDev

CLI

Bug fixes

Fix #3104 by suppressing node warnings when using biome migrate. Contributed by @SuperchupuDev
Force colors to be off when using the GitHub reporter to properly create annotations in GitHub actions (#3148). Contributed by @Sec-ant

Parser

Bug fixes

Implement CSS unicode range. Contributed by @denbezrukov

Formatter

Bug fixes

Fix #3184 CSS formatter converts custom identifiers to lowercase. Contributed by @denbezrukov
Fix #3256 constant crashes when editing css files #3256. Contributed by @denbezrukov

Linter

New features

Add nursery/useDeprecatedReason rule. Contributed by @vohoanglong0107.
Add nursery/noExportedImports. Contributed by @Conaclos

Bug fixes

useConsistentArrayType and useShorthandArrayType now ignore Array in the extends and implements clauses. Fix #3247. Contributed by @Conaclos
Fixes #3066 by taking into account the dependencies declared in the package.json. Contributed by @ematipico
The code action of the useArrowFunction rule now preserves a trailing comma when there is only a single type parameter in the arrow function and JSX is enabled. Fixes #3292. Contributed by @Sec-ant

Enhancements

Enhance tailwind sorting lint rule #1274 with variant support.

Every preconfigured variant is assigned a weight that concurs on establishing the output sorting order.
Since nesting variants on the same utility class is possible, the resulting weight is the Bitwise XOR of all the variants weight for that class.
Dynamic variants (e.g. has-[.custom-class], group-[:checked]) are also supported and they take the weight of their base variant name the custom value attached (e.g. has-[.custom-class] takes has weight).
Arbitrary variants (e.g. [&nth-child(2)]) don't have a weight assigned and they are placed after every known variant.
Classes with the same amount of arbitrary variants follow lexicographical order. The class that has the highest number of nested arbitrary variants is placed last.
Screen variants (e.g. sm:, max-md:, min-lg:) are not supported yet.

Contributed by @lutaok

What's Changed

Other changes

feat(workspace): adds GraphQL parsing capabilities via feature by @ematipico in #3238
feat(editorconfig): expand unknown globs into known globs by @dyc3 in #3218
chore(core): implement pull_diagnostics for graphql by @ematipico in #3248
chore(linter): add a rule source of noUnknownProperty by @togami2864 in #3252
feat: tailwind variant sorting by @lutaok in #3208
test(parse/json): add test for bug where overrides erroneously override special parsing options by @dyc3 in #3260
docs(analyzer): improve contributing guide for rules with multiple signals by @minht11 in #3245
chore(lint): initialise biome_graphql_analyze by @ematipico in #3276
chore(deps): update @biomejs packages by @renovate in #3266
docs(useNamingConvention): add examples and improve explanations by @Conaclos in #3277
refactor(parse/json): change fields in JsonParserSettings to Option by @dyc3 in #3272
feat(search-output-formatter): initialize search output formatter by @BackupMiles in #3258
chore(grit): implement node-like compilers + fixes by @arendjr in #3253
feat: enable linting for graphql by @ematipico in #3295
refactor(parse/css): change fields in CssParserSettings to Option by @dyc3 in #3273
refactor: add variables to format strings directly by @hamirmahal in #3299
chore: update codegen to include GraphQL by @ematipico in #3301

New Contributors

@BackupMiles made their first contribution in #3258
@hamirmahal made their first contribution in #3299

Full Changelog: cli/v1.8.2...cli/v1.8.3

@ematipico

CLI

Bug fixes

Fix #3201 by correctly injecting the source code of the file when printing the diagnostics. Contributed by @ematipico
Fix #3179 where comma separators are not correctly removed after running biome migrate and thus choke the parser. Contributed by @Sec-ant
Fix #3232 by correctly using the colors set by the user. Contributed by @ematipico

Enhancement

Reword the reporter message No fixes needed to No fixes applied.

The former message is misleading when there're still errors or warnings in the files that should be taken care of manually. For example:
```
Checked 2 files in <TIME>. No fixes needed.
Found 2 errors.
```
The new message suits better in these cases.

Contributed by @Sec-ant

Configuration

Bug fixes

Don't conceal previous overrides (#3176).

Previously, each override inherited the unset configuration of the base configuration.
This means that setting a configuration in an override can be concealed by a subsequent override that inherits of the value from the base configuration.

For example, in the next example, noDebugger was disabled for the index.js file.

{
  "linter": {
    "rules": {
      "suspicious": { "noDebugger": "off" }
    }
  },
  "overrides": [
    {
      "include": ["index.js"],
      "linter": {
        "rules": {
          "suspicious": { "noDebugger": "warn" }
        }
      }
    }, {
      "include": ["index.js"],
      "linter": {
        "rules": {
          "suspicious": { "noDoubleEquals": "off" }
        }
      }
    }
  ]
}

The rule is now correctly enabled for the index.js file.

Contributed by @Conaclos

Formatter

Bug fixes

Fix #3103 by correctly resolving CSS formatter options. Contributed by @ah-yu
Fix #3192 don't add an extra whitespace within :has. Contributed by @denbezrukov

JavaScript APIs

Bug fixes

Fix a regression introduced by the release of v1.8.0

Linter

New features

Add nursery/useValidAutocomplete. Contributed by @unvalley

Bug fixes

Add nursery/noShorthandPropertyOverrides. #2958 Contributed by @neokidev
Fix [#3084] false positive by correctly recognize parenthesized return statement. Contributed by @unvalley
useImportExtensions now suggests a correct fix for import '.' and import './.'. Contributed by @minht11
Fix useDateNow false positive when new Date object has arguments new Date(0).getTime(). Contributed by @minht11.
The noUnmatchableAnbSelector rule is now able to catch unmatchable an+b selectors like 0n+0 or -0n+0. Contributed by @Sec-ant.
The useHookAtTopLevel rule now recognizes properties named as hooks like foo.useFoo(). Contributed by @ksnyder9801
Fix #3092, prevent warning for Custom properties (--*). Contributed by @chansuke
Fix a false positive in the useLiteralKeys rule. (#3160)

This rule now ignores the following kind of computed member name:
```
const a = {
  [`line1
  line2`]: true,
};
```
Contributed by @Sec-ant
The noUnknownProperty rule now ignores the composes property often used in css modules. #3000 Contributed by @chansuke
Fix false positives of the useExhaustiveDependencies rule.

The component itself is considered stable when it is used recursively inside a hook closure defined inside of it:
```
import { useMemo } from "react";

function MyRecursiveComponent() {
  // MyRecursiveComponent is stable, we don't need to add it to the dependencies list.
  const children = useMemo(() => <MyRecursiveComponent />, []);
  return <div>{children}</div>;
}
```
Also, export default function and export default class are considered stable now because they can only appear at the top level of a module.

Contributed by @Sec-ant
Fix missing withDefaults macro in vue files for globals variables. Contributed by @Shyam-Chen

Parser

Bug fixes

Fix CSS modules settings mapping. Contributed by @denbezrukov

What's Changed

Other changes

chore(ci): improve rules_check task by @Sec-ant in #3165
chore: change js code blocks containing JSX elements to jsx by @Sec-ant in #3168
feat(biome_js_analyzer): noSubstr by @chansuke in #3125
chore(deps): update rust crate tokio to 1.38.0 by @renovate in #3146
chore(grit): implement Grit snippet bindings by @arendjr in #3162
chore(deps): update @biomejs packages by @renovate in #3145
feat(analyzer): useSortedKeys for JSON objects by @ematipico in #2412
docs(useImportType): add docs about TypeScript settings by @Conaclos in #3171
docs(noUndeclaredDependencies,useImportExtensions): add note about LSP configs by @Conaclos in #3173
docs(no_undeclared_dependencies): follow up fix of #3173 by @Sec-ant in #3175
chore(ci): try enable --compact flag for pkg.pr.new by @Sec-ant in #3180
chore(ci): remove --compact flag by @Sec-ant in #3181
fix(formatter): escape double quotes when printing formatter IR by @dyc3 in #3036
fix: remove unnecessary example by @lanker in #3185
chore: move maintainers to past maintainers by @ematipico in #3189
chore: removes old files by @ematipico in #3188
chore: move Sec-ant to core contributor by @Sec-ant in #3190
chore: add minht11 to the maintainers team by @minht11 in #3191
chore: add chansuke to maintainers list by @chansuke in #3206
chore: rust 1.79.0 by @ematipico in #3222
chore(deps): update github-actions by @renovate in #3225
chore(deps): update @biomejs packages by @renovate in #3224
chore(grit): improve snippet compiler by @arendjr in #3223
refactor(analyzer): use enumflags2 by @ematipico in #3230
feat(biome_css_analyzer): implement function-linear-gradient-no-nonstandard-direction by @mdm317 in #2911
chore(deps): update dependency eslint to v9.5.0 by @renovate in #3227
fix(deps): update rust crates by @renovate in #3226

New Contributors

@ksnyder9801 made their first contribution in #3140
@lanker made their first contribution in #3185
@aldahick made their first contribution in #3239

Full Changelog: cli/v1.8.1...cli/v1.8.2

Uh oh!

Releases: biomejs/biome

CLI v1.9.3

CLI

New features

Bug fixes

Configuration

Bug fixes

Editors

Formatter

Bug fixes

JavaScript API

Bug fixes

Linter

New features

Bug fixes

Parser

Bug fixes

What's Changed

Other changes

New Contributors

Contributors

Uh oh!

CLI v1.9.3-nightly.75b4387

Analyzer

CLI

New features

Bug fixes

Configuration

Editors

Formatter

Bug fixes

JavaScript API

Linter

New features

Bug fixes

Parser

Bug fixes

What's Changed

Other changes

New Contributors

Contributors

Uh oh!

CLI v1.9.2

CLI

New features

Bug fixes

Editors

Bug fixes

Linter

New features

Bug fixes

Parser

Bug fixes

What's Changed

Other changes

New Contributors

Contributors

Uh oh!

CLI v1.9.1

Analyzer

CLI

Bug fixes

Linter

New Features

Bug fixes

What's Changed

Other changes

New Contributors

Contributors

Uh oh!

CLI v1.9.1-nightly.12688b6

Analyzer

CLI

Bug fixes

Configuration

Editors

Formatter

JavaScript APIs

Linter