github biomejs/biome @biomejs/biome@2.1.0
Biome CLI v2.1.0

2.1.0

Minor Changes

  • #6512 0c0bf82 Thanks @arendjr! - The rule noFloatingPromises can now detect floating arrays of Promises.

    Invalid examples

    // This gets flagged because the Promises are not handled.
    [1, 2, 3].map(async (x) => x + 1);

    Valid examples

    await Promise.all([1, 2, 3].map(async (x) => x + 1));
  • #6637 6918085 Thanks @arendjr! - Type inference is now able to handle the sequence operator (,), as well as post- and pre-update operators: ++.

    Example

    let x = 5;
    
    // We now infer that `x++` resolves to a number, while the expression as a whole
    // becomes a Promise:
    x++, new Promise((resolve) => resolve("comma"));
  • #6752 c9eaca4 Thanks @arendjr! - Fixed #6646: .gitignore files are now picked up even when running Biome from a nested directory, or when the ignore file itself is ignored through files.includes.

  • #6746 90aeead Thanks @arendjr! - biome migrate no longer enables style rules that were recommended in v1, because that would be undesirable for users upgrading from 2.0.

    Users who are upgrading from Biome 1.x are therefore advised to first upgrade to Biome 2.0, and run the migration, before continuing to Biome 2.1 or later.

  • #6583 d415a3f Thanks @arendjr! - Added the nursery rule noMisusedPromises.

    It signals Promises in places where conditionals or iterables are expected.

    Invalid examples

    const promise = Promise.resolve("value");
    
    // Using a `Promise` as conditional is always truthy:
    if (promise) {
      /* ... */
    }
    
    // Spreading a `Promise` has no effect:
    console.log({ foo: 42, ...promise });
    
    // This does not `await` the `Promise`s from the callbacks,
    // so it does not behave as you may expect:
    [1, 2, 3].forEach(async (value) => {
      await fetch(`/${value}`);
    });

    Valid examples

    const promise = Promise.resolve("value");
    
    if (await promise) {
      /* ... */
    }
    
    console.log({ foo: 42, ...(await promise) });
  • #6405 cd4a9bb Thanks @vladimir-ivanov! - Added the ignoreRestSiblings option to the noUnusedFunctionParameters rule.

    This option is used to ignore unused function parameters that are siblings of the rest parameter.

    The default is false, which means that unused function parameters that are siblings of the rest parameter will be reported.

    Example

    {
      "rules": {
        "noUnusedFunctionParameters": ["error", { "ignoreRestSiblings": true }]
      }
    }
  • #6614 0840021 Thanks @arendjr! - We have implemented a more targeted version of the scanner, which ensures that if you provide file paths to handle on the CLI, the scanner will exclude directories that are not relevant to those paths.

    Note that for many commands, such as biome check and biome format, the file paths to handle are implicitly set to the current working directory if you do not provide any path explicitly. The targeted scanner also works with such implicit paths, which means that if you run Biome from a subfolder, other folders that are part of the project are automatically exempted.

    Use cases where you invoke Biome from the root of the project without providing a path, as well as those where project rules are enabled, are not expected to see performance benefits from this.

    Implemented #6234, and fixed #6483 and #6563.

  • #6488 c5ee385 Thanks @ianzone! - nx.json and project.json have been added to the list of well-known files.

  • #6720 52e36ae Thanks @minht11! - Added # @biomejs/biome symbol to [organizeImports](https://biomejs.dev/assist/actions/organize-imports) :ALIAS:` group.

    import { action } from '$lib' will be treated as alias import.

Patch Changes

  • #6712 2649ac6 Thanks @sterliakov! - Fixed #6595: Biome now supports // biome-ignore-all file-level suppressions in files that start with a shebang (#!).

  • #6758 28dc49e Thanks @arendjr! - Fixed #6573: Grit plugins can now match bare imports.

    Example

    The following snippet:

    `import $source`
    

    will now match:

    import "main.css";
  • #6550 b424f46 Thanks @arendjr! - Type inference is now able to handle logical expressions: &&, ||, and ??.

    Examples

    // We can now infer that because `true` is truthy, the entire expression
    // evaluates to a `Promise`.
    true && Promise.reject("logical operator bypass");
    
    // And we know that this doesn't:
    false && Promise.reject("logical operator bypass");
    
    // Truthiness, falsiness, and non-nullishness can all be determined on more
    // complex expressions as well. So the following also works:
    type Nullish = null | undefined;
    
    type Params = {
      booleanOption: boolean | Nullish;
      falsyOption: false | Nullish;
    };
    
    function foo({ booleanOption, falsyOption }: Params) {
      // This may be a Promise:
      booleanOption ?? Promise.reject("logical operator bypass");
    
      // But this never is:
      falsyOption && Promise.reject("logical operator bypass");
    }
  • #6413 4aa0e50 Thanks @wojtekmaj! - Improved error message in useDateNow rule.

  • #6673 341e062 Thanks @dyc3! - Fixed a case where the HTML formatter would mangle embedded language tags if whitespaceSensitivity was set to strict

  • #6642 a991229 Thanks @unvalley! - Fixed #4494: The noSecrets rule now correctly uses the entropyThreshold option to detect secret like strings.

  • #6520 0c43545 Thanks @arendjr! - Type inference is now able to handle ternary conditions in type aliases.

    Note that we don't attempt to evaluate the condition itself. The resulting type is simply a union of both conditional outcomes.

    Example

    type MaybeResult<T> = T extends Function ? Promise<string> : undefined;
    
    // We can now detect this function _might_ return a `Promise`:
    function doStuff<T>(input: T): MaybeResult<T> {
      /* ... */
    }
  • #6711 1937691 Thanks @sterliakov! - Fixed #6654: Fixed range highlighting of <explanation> placeholder in inline suppression block comments.

  • #6756 d12b26f Thanks @dyc3! - Fixed #6669: Added an exception to noUnusedImports to allow type augmentation imports.

    import type {} from "@mui/lab/themeAugmentation";
  • #6643 df15ad6 Thanks @skewb1k! - Fixed #4994: LSP server registered some capabilities even when the client did not support dynamic registration.

  • #6599 5e611fa Thanks @vladimir-ivanov! - Fixed #6380: The noFocusedTests rule now correctly displays the function name in the diagnostic message when a test is focused.

    Every instance of a focused test function (like fdescribe, fit, ftest and only) had the word 'only' hardcoded. This has been updated to use the actual function name, so the message is now more accurate and specific.

    Example for fdescribe:

      i The 'fdescribe' method is often used for debugging or during implementation.
    
      i Consider removing 'f' prefix from 'fdescribe' to ensure all tests are executed.
    
  • #6671 0c9ab43 Thanks @vladimir-ivanov! - Fixed #6634: The useReadonlyClassProperties rule now correctly flags mutations in class getters and in arrow functions within class properties.

    Examples:

    class GetterWithMutationValue {
      #value: string;
    
      get value() {
        if (!this.#value) {
          this.#value = "defaultValue";
        }
    
        return this.#value;
      }
    }
    class ClassPropertyArrowFunctionWithMutation {
      private bar: string | null = null;
    
      readonly action = () => {
        this.bar = "init";
      };
    }
  • #6682 ca04cea Thanks @ematipico! - Fixed #6668: Biome Assist is now enabled by default for CSS files.

  • #6525 66b089c Thanks @arendjr! - Type inference can now infer the return types of functions and methods without annotations.

    Examples

    const sneakyObject = {
      doSomething() {
        return Promise.resolve("This is a floating promise!");
      },
    };
    
    // We can now detect that `doSomething()` returns a `Promise`.
    sneakyObject.doSomething();
  • #6531 c06df79 Thanks @arendjr! - Biome's type inference now detects the type of properties with getters.

    Examples

    const sneakyObject2 = {
      get something() {
        return new Promise((_, reject) => reject("This is a floating promise!"));
      },
    };
    // We now detect this is a Promise:
    sneakyObject2.something;
  • #6587 a330fcc Thanks @Conaclos! - organizeImports is now able to sort named specifiers and import attributes with bogus nodes.

  • #6618 6174869 Thanks @Shinyaigeek! - Fixed #6610: JSON import attributes are now correctly detected when they contain extra whitespace.

  • #6753 fce5d2c Thanks @dyc3! - Improved the error messages when Biome is provided incompatible arguments on the CLI.

  • #6587 a330fcc Thanks @Conaclos! - Fixed #6491: The action of useSortedKeys removed comments or wrongly transferred them to distinct nodes.

  • #6696 92964a7 Thanks @unvalley! - Fixed #6633: The noImplicitCoercion rule no longer reports diagnostics for 1 / value expressions.

    1 / value; // no error
  • #6683 43d871e Thanks @ematipico! - Fixed #6537: Biome no longer removes the trailing comma from JSON files when formatter.json.trailingCommas is explicitly set to "all".

  • #6693 bfdce0b Thanks @dyc3! - Fixed #6691: The HTML parser will now consider . to be a valid character for tag names.

  • #6716 ead03d1 Thanks @siketyan! - The Biome LSP server no longer responds with an error for a textDocument/codeActions request when Biome doesn't support a feature for the file (e.g. Code actions aren't supported in GritQL files).

  • #6679 7bf9a60 Thanks @marko-hologram! - Fixed #6638: JavaScript formatter overrides options now correctly override expand option. JSON formatter overrides options now correctly override bracketSpacing and expand options.

  • #6717 7f5b541 Thanks @siketyan! - Fixed #6688: the noUselessFragments no longer reports <Fragment /> elements that includes HTML character entities.

  • #6600 853e1b5 Thanks @daivinhtran! - Fixed #4677: The noUnusedImports rule won't produce diagnostics for types used in comments of static members anymore.

  • #6662 3afc804 Thanks @arendjr! - If a nested configuration file is ignored by the root configuration, it will now actually be ignored.

    Biome has an exception in place for configuration files so they cannot be ignored, because the configuration files are vital to Biome itself. But this exception was incorrectly applied to nested configurations as well. Now only the root configuration is exempt from being ignored.

  • #6596 c0718ca Thanks @ematipico! - Fixed #6566: Biome no longer errors when using the option --files-ignore-unknown=true in stdin mode.

    Biome has also become less strict when using --stdin-file-path in stdin mode. It will no longer error if the file path doesn't contain an extension, but instead it will return the original content.

  • #6562 153eda7 Thanks @vladimir-ivanov! - Added the nursery rule noMagicNumbers. The rule detects and reports the use of "magic numbers" — numeric literals that are used directly in code without being assigned to a named constant.

    Example

    let total = price * 1.23; // Magic number for tax rate will highlight 1.23 as magic number
  • #6663 af78d6d Thanks @ematipico! - Fixed #6656: Biome now correctly formats HTML void elements such as <meta> when they contain a self-closing slash.

    - <meta foo="bar" />
    + <meta foo="bar">
  • #6732 31e4396 Thanks @vladimir-ivanov! - Resolved #6281: Improved performance of handling package.json files in the scanner.

  • #6625 19cb475 Thanks @arendjr! - Fixed #6616: Fixed an issue with extending configurations that contained an explicit root field while the configuration in the project did not.

  • #6650 19aab18 Thanks @sterliakov! - Fixed #6621: Improved handling of multiple adjacent line suppressions. Biome now handles such suppressions separately, tracking whether each one is used.

  • #6700 cdd6e17 Thanks @denbezrukov! - Fixed #6680: Biome incorrectly formatted container-style queries by inserting misplaced spaces.

    - @container style (--responsive: true) {}
    + @container style(--responsive: true) {}
  • #6709 ecf3954 Thanks @dyc3! - Fixed #6038: Fixed a false positive in noShadow where a function parameter in a type definition was erroneously flagged as a violation.

  • #6593 a4acbb7 Thanks @arendjr! - Type inference is now able to handle ternary conditions in expressions.

    Examples

    const condition = Math.random() > -1; // Always true, but dynamic to linter
    
    // We now detect that this may return a `Promise`.
    condition ? Promise.reject("ternary bypass") : null;
    
    // On the other hand, we know the following is never a `Promise`:
    const alwaysFalsy = 0;
    alwaysFalsy ? Promise.reject("ternary bypass") : null;
  • #6428 4b501d3 Thanks @siketyan! - Added MemoryFileSystem to the WASM API.

    You can now insert a file from your JS code:

    import { MemoryFileSystem, Workspace } from "@biomejs/wasm-web";
    
    const fs = new MemoryFileSystem();
    const workspace = Workspace.withFileSystem(fs);
    
    fs.insert("/index.js", new TextEncoder().encode("let foo = 1;"));
    fs.remove("/index.js");
  • #6594 626d4a1 Thanks @ematipico! - Fixed #6528: Biome didn't return the correct output when applying source.fixAll.biome inside Astro/Vue/Svelte files that contained safe fixed.

What's Changed

  • feat(core): support import namespaces by @arendjr in #6303
  • feat(core): support export * syntax by @arendjr in #6311
  • fix(linter): prevent false positives in noMisusedPromises by @arendjr in #6315
  • perf: use TypeStore in global resolver by @arendjr in #6318
  • perf: resolve and map types in single pass by @arendjr in #6319
  • perf: deduplicate types by @arendjr in #6324
  • chore: add swr fixtures by @arendjr in #6339
  • fix(resolver): resolve type definitions for JavaScript files by @arendjr in #6343
  • feat(core): flatten intersections + call signatures by @arendjr in #6404
  • perf: preallocate type store by @arendjr in #6421
  • perf: store types behind Arcs by @arendjr in #6442
  • feat: add nx.json project.json to Well-known files by @ianzone in #6488
  • feat(linter): handle arrays of Promises in noFloatingPromises by @arendjr in #6512
  • fix(core): handle ternary in type alias by @arendjr in #6520
  • fix(core): infer method return types by @arendjr in #6525
  • fix(core): infer types of properties with getters by @arendjr in #6531
  • chore: add test case by @arendjr in #6532
  • feat(core): handle logical operators by @arendjr in #6550
  • ci: fix JSON payload release dispatch by @ematipico in #6580
  • chore: remove disclaimer on noFloatingPromises by @arendjr in #6579
  • chore: update next by @arendjr in #6581
  • feat(biome_js_analyse): added new rule noMagicNumbers by @vladimir-ivanov in #6562
  • chore(justfile): adjust indentation and remove extra blank lines in justfile by @paulo9mv in #6568
  • refactor(useSortedKeys): transfer trailing separator upon sorting by @Conaclos in #6587
  • fix(lsp): fix all should check for embedded languages by @ematipico in #6594
  • feat(core): implement conditional handling by @arendjr in #6593
  • chore: update contribution guide to include vladimir ivanov as a maintainer by @vladimir-ivanov in #6564
  • fix(biome_js_analyze): fix JsDocTypeCollectorVisitior to also walk on JsStaticMemberAssignment by @daivinhtran in #6600
  • docs: add mdevils to maintainers by @mdevils in #6612
  • chore(lint): fix document of the noMagicNumbers rule that produces invalid MDX by @siketyan in #6598
  • refactor: extract out a biome_line_index crate by @DavisVaughan in #6222
  • fix(biome-js-analyze): fixed the diagnostic message for noFocusedTests to display the offending fn name by @vladimir-ivanov in #6599
  • chore: add syntax parser directive to Dockerfile by @JamBalaya56562 in #6619
  • feat(core): port SyntaxNodePtr and AstPtr from rowan by @rmehri01 in #6534
  • fix(biome-js-analyze): detect json import attribute with trimmed text value instead of plain text value by @Shinyaigeek in #6618
  • feat(core): targeted file scanner by @arendjr in #6614
  • fix(core): fix extending configs with root field by @arendjr in #6625
  • chore(deps): pin docker/dockerfile docker tag to 9857836 by @renovate in #6626
  • chore(deps): update dependency @types/node to v22.15.34 by @renovate in #6627
  • fix(deps): update @biomejs packages by @renovate in #6632
  • chore(deps): update rust crate papaya to 0.2.3 by @renovate in #6630
  • chore(deps): update rust crate ureq to 3.0.12 by @renovate in #6631
  • fix(cli): lax stdin strictness by @ematipico in #6596
  • feat(core): infer sequence operator and update operators by @arendjr in #6637
  • feat(yaml): overhauling YAML lexer by @vohoanglong0107 in #6481
  • feat(wasm): expose MemoryFileSystem via WASM API by @siketyan in #6428
  • fix(core): fix inference for boolean that must be truthy by @arendjr in #6641
  • fix(biome-js-analyze): update changes by @vladimir-ivanov in #6636
  • fix(lsp): add missing checks for capability dynamic registration support by @skewb1k in #6643
  • fix(js-api): don't use types of others modules by @regseb in #6535
  • refactor: share lint rule options by @ematipico in #5543
  • perf: optimise ignore checking by @arendjr in #6659
  • chore: merge next into main by @arendjr in #6583
  • feat(core): offset parsing by @ematipico in #6652
  • fix(formatter): void elements with slash by @ematipico in #6663
  • fix(lint/noSecrets): calculate entropy with entropyThreshold option by @unvalley in #6642
  • fix(biome-js-analyze): move no_secrets options inside biome-rules-opt… by @vladimir-ivanov in #6672
  • fix(core): css assist by @ematipico in #6682
  • fix(format/html): fix mangling of embedded language tags if whitespaceSensitivity is strict by @dyc3 in #6673
  • feat(parser): parse Astro frontmatter by @ematipico in #6689
  • chore(core): add resource to diagnostic by @ematipico in #6685
  • fix(parse/html): make . a valid char in tag names by @dyc3 in #6693
  • fix(formatter): trailing commas in json files by @ematipico in #6683
  • feat: make enum can be transform in scope by @cqh963852 in #6678
  • fix(biome-js-analyze): useReadonlyClassProperties check class getters… by @vladimir-ivanov in #6671
  • feat(biome_js_analyse): added new option to rule to ignore unused function parameters by @vladimir-ivanov in #6405
  • fix(core): ignore nested configs by @arendjr in #6662
  • fix(lint/noImplicitCoercion): false positive for 1 / value by @unvalley in #6696
  • fix(css_formatter): correct spacing in container style queries by @denbezrukov in #6700
  • fix(biome_analyze): stop squashing multiple line suppression comments. by @sterliakov in #6650
  • fix(noShadow): fix a false positive related to function parameters inside type definitions by @dyc3 in #6709
  • fix(biome_js_analyze): correct text range of suppression reason by @sterliakov in #6711
  • fix(service): biome/file_features still should return a map instead of an array by @siketyan in #6718
  • fix(lint/complexity/useDateNow): improve error message by @wojtekmaj in #6413
  • docs: fix typos in CHANGELOG & CONTRIBUTING by @noritaka1166 in #6721
  • docs: update analyzer contribution guide by @ematipico in #6651
  • fix(lsp): do not response error on pulling actions from GritQL files by @siketyan in #6716
  • feat(linter): add $ to organize imports :ALIAS: group by @minht11 in #6720
  • fix(biome-service): override all formatter options with user configured overrides by @marko-hologram in #6679
  • chore(deps): update dependency dprint to v0.50.1 by @renovate in #6734
  • chore(deps): update dependency @types/node to v22.16.0 by @renovate in #6735
  • chore(deps): update dependency eslint to v9.30.1 by @renovate in #6738
  • chore(deps): update dependency @types/node to v22.16.0 by @renovate in #6737
  • chore(deps): update github-actions by @renovate in #6741
  • chore(deps): update dependency rust to v1.88.0 by @renovate in #6740
  • chore(deps): update rust crate indexmap to 2.10.0 by @renovate in #6742
  • chore(deps): update rust crate rust-lapper to 1.2.0 by @renovate in #6743
  • chore: update contribution and changesets by @ematipico in #6748
  • chore: remove style rule migration by @arendjr in #6746
  • feat(biome_analyzer): support shebang together with // biome-ignore-all file-level suppressions by @sterliakov in #6712
  • perf(biome_package): improve performance of biome_package by @vladimir-ivanov in #6732
  • fix(core): .gitignore is discovered in more scenarios by @arendjr in #6752
  • fix(lint/noUselessFragments): apply the same logic for shorthand fragments and Fragment elements by @siketyan in #6717
  • chore: reduce PackageJson size by @arendjr in #6754
  • fix(grit): match bare imports by @arendjr in #6758
  • fix(cli): improve error messages when given incompatible arguments by @dyc3 in #6753
  • fix(noUnusedImports): formally make an exception for type augmentation imports by @dyc3 in #6756
  • perf(biome_package): updated incorrect generic passed to deserialize_… by @vladimir-ivanov in #6760
  • chore: clean up changesets by @arendjr in #6768
  • chore: set versions for new rules by @arendjr in #6769
  • chore: don't break up paragraphs in changesets by @arendjr in #6770
  • ci: release by @github-actions in #6582

New Contributors

Full Changelog: https://github.com/biomejs/biome/compare/@biomejs/biome@2.0.6...@biomejs/biome@2.1.0

Don't miss a new biome release

NewReleases is sending notifications on new releases.