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 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

JavaScript APIs

Linter

New features

• Add nursery/noRestrictedTypes. Contributed by @minht11

• 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

• Add nursery/noUselessEscapeInRegex. Contributed by @Conaclos

• Add nursery/useConsistentMemberAccessibility. Contributed by @seitarof

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

• noUndeclaredVariables recognized Svelte 5 runes in Svelte components and svelte files.

  Svelte 5 introduced runes. The rule now recognizes Svelte 5 runes in files ending with the .svelte, .svelte.js or .svelte.ts extensions.

  Contributed by @Conaclos

• noBlankTarget now supports an array of allowed domains.

  The following configuration allows example.com and example.org as blank targets.

  "linter": {
    "rules": {
      "a11y": {
        "noBlankTarget": {
        "level": "error",
          "options": {
             "allowDomains": ["example.com", "example.org"]
            }
          }
        }
      }
    }
  

  Contributed by @Jayllyz

• noNodejsModules now ignores type-only imports (#1674).

  The rule no longer reports type-only imports such as:

  import type assert from "assert";
  import type * as assert2 from "assert";
  

  Contributed by @Conaclos

• noNodejsModules now ignores imports of a package which has the same name as a Node.js module. Contributed by @Conaclos

• Add an ignoreNull option for noDoubleEquals. Contributed by @peaBerberian.

• The rule noDuplicateObjectKeys now works for JSON and JSONC files. Contributed by @ematipico

• The CSS linter is now enabled by default. Which means that you don't need to opt-in anymore using the configuration file biome.json:

  {
  -  "css": {
  -    "linter": {
  -      "enabled": true
  -    }
  -  }
  }
  

  Contributed by @ematipico

• The rule noRedundantUseStrict no longer reports use strict when the package.json marks the file as a script using the field "type": "commonjs". Contributed by @ematipico

• noConsole now accepts an option that specifies some allowed calls on console. 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

• noRedeclare no longer report redeclartions for lexically scoped function declarations #3664.

  In JavaScript strict mode, function declarations are lexically scoped: they cannot be accessed outside the block where they are declared.

  In non-strict mode, function declarations are hoisted to the top of the enclosing function or global scope.

  Previously Biome always hoisted function declarations. It now takes into account whether the code is in strict or non strict mode.

  Contributed by @Conaclos

• noRedeclare no longer report a variable named as the function expression where it is declared. Contributed by @Conaclos

• noMultipleSpacesInRegularExpressionLiterals now correctly provides a code fix when Unicode characters are used. Contributed by @Conaclos

• useValidAriaValues now correctly check property types (3748).

  Properties that expect a string now accept arbitrary text. An identifiers can now be made up of any characters except ASCII whitespace. An identifier list can now be separated by any ASCII whitespace.

  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

• noControlCharactersInRegex now corretcly handle \u escapes in unicode-aware regexes.

  Previously, the rule didn't consider regex with the v flags as unicode-aware regexes. Moreover, \uhhhh was not handled in unicode-aware regexes.

  Contributed by @Conaclos

• noControlCharactersInRegex now reports control characters and escape sequence of control characters in string regexes. Contributed by @Conaclos

• useSortedClasses lint error with Template literals (#3394). Contributed by @hangaoke1

• noUndeclaredDependencies now ignores self package imports. Contributed by @Conaclos

Parser

Enhancements

• The JSON parser now allows comments in files with the .json extension under the .vscode and .zed directories.

  Biome recognizes are well known JSON files that allows comments and/or trailing commas. Previously, Biome did not recognize JSON files under the .vscode and the .zed directories as JSON files that allow comments. You had to configure Biome to recognize them:

  {
    "overrides": [
      {
        "include": ["**/.vscode/*.json", "**/.zed/*.json"],
        "json": { "parser": { "allowComments": true } }
      }
    ]
  }
  

  This override is no longer needed! Note that JSON files under the .vscode and the .zed directories don't accept trailing commas.

  Contributed by @Conaclos

• The JSON parser now allows comments in jest.config.json. Contributed by @Conaclos

Bug fixes

• The CSS parser now accepts emoji in identifiers (3627).

  The following code is now corretcly parsed:

  p {
    --🥔-color: red;
    color: var(--🥔-color);
  }
  

  Contributed by @Conaclos

• 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

• Fix #3464 by enabling JSX in .vue files that use the lang='jsx' or lang='tsx' attribute. Contributed by @ematipico

What's Changed

Other changes

• fix(ci): missing codegen check by @Jayllyz in https://github.com/biomejs/biome/pull/3692
• fix(console): print <br /> when having a newline by @ematipico in https://github.com/biomejs/biome/pull/3701
• fix(console): regression for #3701 by @ematipico in https://github.com/biomejs/biome/pull/3703
• feat: adds an option to HTML printer for MDX by @ematipico in https://github.com/biomejs/biome/pull/3711
• fix: another quick fix to escape some other chars that make MDX go nuts by @ematipico in https://github.com/biomejs/biome/pull/3712
• fix: escape backslash when printing HTML in mdx by @ematipico in https://github.com/biomejs/biome/pull/3713
• feat(grit): support as keyword by @arendjr in https://github.com/biomejs/biome/pull/3719
• refactor(diagnostics): indentation by @ematipico in https://github.com/biomejs/biome/pull/3722
• feat(lint/useAriaPropsSupportedByRole): add rule by @ryo-ebata in https://github.com/biomejs/biome/pull/3644
• chore(deps): update @biomejs packages by @renovate in https://github.com/biomejs/biome/pull/3714
• chore(deps): update rust crate serde_json to 1.0.127 by @renovate in https://github.com/biomejs/biome/pull/3717
• chore(deps): update rust crate serde to 1.0.209 by @renovate in https://github.com/biomejs/biome/pull/3716
• chore(deps): update rust crate quote to 1.0.37 by @renovate in https://github.com/biomejs/biome/pull/3715
• refactor(core): ordered paths, project manifest, tsconfig by @ematipico in https://github.com/biomejs/biome/pull/3699
• feat(yaml): lexer that can lex very simple examples by @dyc3 in https://github.com/biomejs/biome/pull/3430
• perf(ci): speedup free disk space action by @Jayllyz in https://github.com/biomejs/biome/pull/3694
• feat(js_analyze): add lint/noEnum by @nickfla1 in https://github.com/biomejs/biome/pull/3653
• feat(biome_js_analyzer): useJsxSortProps by @vohoanglong0107 in https://github.com/biomejs/biome/pull/2652
• fix(docs): typo in no_double_equals.rs by @shubh73 in https://github.com/biomejs/biome/pull/3730
• refactor(js_analyze): add TypeScript 5.5 and 5.6 globals by @Conaclos in https://github.com/biomejs/biome/pull/3735
• refactor: avoid UTF-8 validation of file extensions by @Conaclos in https://github.com/biomejs/biome/pull/3737
• fix(core): ser/de for FileKind by @ematipico in https://github.com/biomejs/biome/pull/3736
• feat(lsp): add codeActionKinds by @suxin2017 in https://github.com/biomejs/biome/pull/3731
• refactor: update bench by @Conaclos in https://github.com/biomejs/biome/pull/3739
• chore(deps): update dependency eslint to v9.9.1 by @renovate in https://github.com/biomejs/biome/pull/3642
• fix(lsp): update diagnostics only for supported files by @ematipico in https://github.com/biomejs/biome/pull/3741
• chore(css_semantic): allow an empty at-property declation by @togami2864 in https://github.com/biomejs/biome/pull/3744
• chore(deps): update rust crate indexmap to 2.5.0 by @renovate in https://github.com/biomejs/biome/pull/3754
• chore(deps): update pnpm to v9.9.0 by @renovate in https://github.com/biomejs/biome/pull/3753
• chore(deps): update rust crate oxc_resolver to 1.11.0 by @renovate in https://github.com/biomejs/biome/pull/3755
• chore(deps): update dependency @types/node to v20.16.3 by @renovate in https://github.com/biomejs/biome/pull/3750
• chore(deps): update actions/upload-artifact action to v4.4.0 - autoclosed by @renovate in https://github.com/biomejs/biome/pull/3752
• refactor(summary-reporter): order reported paths by @Conaclos in https://github.com/biomejs/biome/pull/3757
• feat(search): add matches number to summary by @BackupMiles in https://github.com/biomejs/biome/pull/3747
• feat(css_semantic): implement rule hierarchy tracking and enhance rule lookup by @togami2864 in https://github.com/biomejs/biome/pull/3746
• fix(useExhaustiveDependencies): make stableResult optional by @Conaclos in https://github.com/biomejs/biome/pull/3764
• fix(js_formatter): add parens for nullish coalescing in ternary by @Conaclos in https://github.com/biomejs/biome/pull/3765
• fix(css_parser): fix is at unicode range check by @suxin2017 in https://github.com/biomejs/biome/pull/3745
• fix: don't panic in debug mode when encountring complex variable declaration by @Conaclos in https://github.com/biomejs/biome/pull/3769
• perf(css_parser): avoid expensive check when parsing an id by @Conaclos in https://github.com/biomejs/biome/pull/3774
• chore(bench): pin bench libs by @pnodet in https://github.com/biomejs/biome/pull/3772
• feat(html): set up biome_html_formatter by @dyc3 in https://github.com/biomejs/biome/pull/3773
• fix(parser/html): fix parsing html keyword in doctype by @dyc3 in https://github.com/biomejs/biome/pull/3776
• feat(format/html): add quick_test to formatter crate by @dyc3 in https://github.com/biomejs/biome/pull/3777
• fix(js_format): fix js template element parentheses issue by @suxin2017 in https://github.com/biomejs/biome/pull/3780
• refactor(biome_diagnostics): use enumflags2 for DiagnosticTag by @Javimtib92 in https://github.com/biomejs/biome/pull/3785
• refactor(biome_js_parser/lexer): use enumflags2 for RegexFlag by @Javimtib92 in https://github.com/biomejs/biome/pull/3788
• refactor(biome_js_parser/syntax): use enumflags2 for TypeContext by @Javimtib92 in https://github.com/biomejs/biome/pull/3789
• fix(grit): fix matching names in Grit queries by @arendjr in https://github.com/biomejs/biome/pull/3792
• fix(deps): update rust crates by @renovate in https://github.com/biomejs/biome/pull/3751
• refactor(biome_js_parser/syntax): use enumflags2 for ModifierFlag by @Javimtib92 in https://github.com/biomejs/biome/pull/3796
• fix(grit): fix matching multiple args by @arendjr in https://github.com/biomejs/biome/pull/3797
• refactor(biome_js_parser/state): use enumflags2 for SignatureFlag and ParsingContextFlag by @Javimtib92 in https://github.com/biomejs/biome/pull/3800
• refactor(biome_js_parser/syntax): use enumflags2 for ExpressionContextFlag by @Javimtib92 in https://github.com/biomejs/biome/pull/3799
• refactor(biome_parser): use enumflags2 for TokenFlag and remove bitflags by @Javimtib92 in https://github.com/biomejs/biome/pull/3802
• ci: fix broken CLI binary copy step for NPM publish by @benjamincburns in https://github.com/biomejs/biome/pull/3805
• chore(ci): auto label HTML PRs by @dyc3 in https://github.com/biomejs/biome/pull/3803

New Contributors

• @peaBerberian made their first contribution in https://github.com/biomejs/biome/pull/3702
• @anthonyshew made their first contribution in https://github.com/biomejs/biome/pull/3708
• @nickfla1 made their first contribution in https://github.com/biomejs/biome/pull/3653
• @shubh73 made their first contribution in https://github.com/biomejs/biome/pull/3730
• @pnodet made their first contribution in https://github.com/biomejs/biome/pull/3772
• @Javimtib92 made their first contribution in https://github.com/biomejs/biome/pull/3785
• @h-a-n-a made their first contribution in https://github.com/biomejs/biome/pull/3793
• @benjamincburns made their first contribution in https://github.com/biomejs/biome/pull/3805

Full Changelog: https://github.com/biomejs/biome/compare/cli/v1.8.4-nightly.d079e53...cli/v1.8.4-nightly.7aaf0ce