Skip to content

CLI v1.8.0
Compare
Choose a tag to compare
@github-actions github-actions released this 04 Jun 11:45
· 915 commits to main since this release
cli/v1.8.0
378c05e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.

Analyzer

New features

  • Allow suppression comments to suppress individual instances of rules. This is
    used for the lint rule useExhaustiveDependencies, which is now able to
    suppress specific dependencies. Fixes #2509. Contributed by @arendjr

Enhancements

  • Assume Astro object is always a global when processing .astro files. Contributed by @minht11
  • Assume Vue compiler macros are globals when processing .vue files. (#2771) Contributed by @dyc3

CLI

New features

  • New clean command. Use this new command to clean after the biome-logs directory, and remove all the log files.

    biome clean

  • Add two new options --only and --skip to the command biome lint (#58).

    The --only option allows you to run a given rule or rule group,
    For example, the following command runs only the style/useNamingConvention and style/noInferrableTypes rules.
    If the rule is disabled in the configuration, then its severity level is set to error for a recommended rule or warn otherwise.

    biome lint --only=style/useNamingConvention --only=style/noInferrableTypes

    Passing a group does not change the severity level of the rules in the group.
    All the disabled rules in the group will remain disabled.
    To ensure that the group is run, the recommended field of the group is enabled.
    The nursery group cannot be passed, as no rules are enabled by default in the nursery group.

    The --skip option allows you to skip the execution of a given group or a given rule.
    For example, the following command skips the style group and the suspicious/noExplicitAny rule.

    biome lint --skip=style --skip=suspicious/noExplicitAny

    You can also use --only and --skip together. --skip oevrrides --only.
    The following command executes only the rules from the style group, but the style/useNamingConvention rule.

    biome lint --only=style --skip=style/useNamingConvention

    These options are compatible with other options such as --write (previously --apply), and --reporter.

    Contributed by @Conaclos

  • Add new command biome clean. Use this command to purge all the logs emitted by the Biome daemon. This command is really useful, because the Biome daemon tends
    log many files and contents during its lifecycle. This means that if your editor is open for hours (or even days), the biome-logs folder could become quite heavy. Contributed by @ematipico

  • Add support for formatting and linting CSS files from the CLI. These operations are opt-in for the time being.

    If you don't have a configuration file, you can enable these features with --css-formatter-enabled and --css-linter-enabled:

    biome check --css-formatter-enabled=true --css-linter-enabled=true ./

    Contributed by @ematipico

  • Add new CLI options to control the CSS formatting. Check the CLI reference page for more details. Contributed by @ematipico

  • Add new options --write, --fix (alias of --write) and --unsafe to the command biome lint and biome check.
    Add a new option --fix (alias of --write) to the command biome format and biome migrate.

    biome <lint|check> --<write|fix> [--unsafe]
biome format --<write|fix>
biome migrate --<write|fix>

    The biome <lint|check> --<write|fix> has the same behavior as biome <lint|check> --apply.
    The biome <lint|check> --<write|fix> --unsafe has the same behavior as biome <lint|check> --apply-unsafe.
    The biome format --fix has the same behavior as biome format --write.
    The biome migrate --fix has the same behavior as biome migrate --write.

    This change allows these commands to write modifications in the same options.
    With this change, the --apply and --apply-unsafe options are deprecated.

    Contributed by @unvalley

Enhancements

  • Biome now executes commands (lint, format, check and ci) on the working directory by default. #2266 Contributed by @unvalley

    - biome check .
+ biome check    # You can run the command without the path

  • biome migrate eslint now tries to convert ESLint ignore patterns into Biome ignore patterns.

    ESLint uses gitignore patterns.
    Biome now tries to convert these patterns into Biome ignore patterns.

    For example, the gitignore pattern /src is a relative path to the file in which it appears.
    Biome now recognizes this and translates this pattern to ./src.

    Contributed by @Conaclos

  • biome migrate eslint now supports the eslintIgnore field in package.json.

    ESLint allows the use of package.json as an ESLint configuration file.
    ESLint supports two fields: eslintConfig and eslintIgnore.
    Biome only supported the former. It now supports both.

    Contributed by @Conaclos

  • biome migrate eslint now propagates NodeJS errors to the user.

    This will help users to identify why Biome is unable to load some ESLint configurations.

    Contributed by @Conaclos

  • Add a new --reporter called summary. This reporter will print diagnostics in a different way, based on the tools (formatter, linter, etc.) that are executed.
    Import sorting and formatter shows the name of the files that require formatting. Instead, the linter will group the number of rules triggered and the number of errors/warnings:

    Formatter ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
The following files needs to be formatted:
main.ts
index.ts

Organize Imports ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
The following files needs to have their imports sorted:
main.ts
index.ts

Analyzer ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Some analyzer rules were triggered

Rule Name                                               Diagnostics
lint/suspicious/noImplicitAnyLet                        12 (12 error(s), 0 warning(s), 0 info(s))
lint/suspicious/noDoubleEquals                          8 (8 error(s), 0 warning(s), 0 info(s))
lint/suspicious/noRedeclare                             12 (12 error(s), 0 warning(s), 0 info(s))
lint/suspicious/noDebugger                              20 (20 error(s), 0 warning(s), 0 info(s))

    Contributed by @ematipico

  • biome ci now enforces printing the output using colours. If you were previously using --colors=force, you can remove it because it's automatically set. Contributed by @ematipico

  • Add a new --reporter called github. This reporter will print diagnostics using GitHub workflow commands:

    ::error title=lint/suspicious/noDoubleEquals,file=main.ts,line=4,endLine=4,col=3,endColumn=5::Use === instead of ==
::error title=lint/suspicious/noDebugger,file=main.ts,line=6,endLine=6,col=1,endColumn=9::This is an unexpected use of the debugger statement.
::error title=lint/nursery/noEvolvingAny,file=main.ts,line=8,endLine=8,col=5,endColumn=6::This variable's type is not allowed to evolve implicitly, leading to potential any types.

    Contributed by @ematipico

  • Add a new --reporter called junit. This reporter will print diagnostics using GitHub workflow commands:

    <?xml version="1.0" encoding="UTF-8"?>
<testsuites name="Biome" tests="16" failures="16" errors="20" time="<TIME>">
  <testsuite name="main.ts" tests="1" disabled="0" errors="0" failures="1" package="org.biome">
      <testcase name="org.biome.lint.suspicious.noDoubleEquals" line="4" column="3">
          <failure message="Use === instead of ==. == is only allowed when comparing against `null`">line 3, col 2, Use === instead of ==. == is only allowed when comparing against `null`</failure>
      </testcase>
  </testsuite>
  <testsuite name="main.ts" tests="1" disabled="0" errors="0" failures="1" package="org.biome">
      <testcase name="org.biome.lint.suspicious.noDebugger" line="6" column="1">
          <failure message="This is an unexpected use of the debugger statement.">line 5, col 0, This is an unexpected use of the debugger statement.</failure>
      </testcase>
  </testsuite>
  <testsuite name="main.ts" tests="1" disabled="0" errors="0" failures="1" package="org.biome">
      <testcase name="org.biome.lint.nursery.noEvolvingAny" line="8" column="5">
          <failure message="This variable&apos;s type is not allowed to evolve implicitly, leading to potential any types.">line 7, col 4, This variable&apos;s type is not allowed to evolve implicitly, leading to potential any types.</failure>
      </testcase>
  </testsuite>
</testsuites>

    Contributed by @ematipico

Bug fixes

  • Fix #3024, where running biome init would create biome.json even if biome.jsonc already exists. Contributed by @minht11

Configuration

New features

  • Add an rule option fix to override the code fix kind of a rule (#2882).

    A rule can provide a safe or an unsafe code action.
    You can now tune the kind of code actions thanks to the fix option.
    This rule option takes a value among:

    • none: the rule no longer emits code actions.
    • safe: the rule emits safe code action.
    • unsafe: the rule emits unsafe code action.

    The following configuration disables the code actions of noUnusedVariables, makes the emitted code actions of style/useConst and style/useTemplate unsafe and safe respectively.

    {
  "linter": {
    "rules": {
      "correctness": {
        "noUnusedVariables": {
          "level": "error",
          "fix": "none"
        },
        "style": {
          "useConst": {
            "level": "warn",
            "fix": "unsafe"
          },
          "useTemplate": {
            "level": "warn",
            "fix": "safe"
          }
        }
      }
    }
  }
}

    Contributed by @Conaclos

  • Add option javascript.linter.enabled to control the linter for JavaScript (and its super languages) files. Contributed by @ematipico

  • Add option json.linter.enabled to control the linter for JSON (and its super languages) files. Contributed by @ematipico

  • Add option css.linter.enabled to control the linter for CSS (and its super languages) files. Contributed by @ematipico

  • Add option css.formatter, to control the formatter options for CSS (and its super languages) files. Contributed by @ematipico

  • You can now change the severity of lint rules down to "info". The "info" severity doesn't emit error codes, and it isn't affected by other options like --error-on-warnings:

    {
  "linter": {
    "rules": {
      "suspicious": {
        "noDebugger": "info"
      }
    }
  }
}

    Contributed by @ematipico

Enhancements

  • The javascript.formatter.trailingComma option is deprecated and renamed to javascript.formatter.trailingCommas. The corresponding CLI option --trailing-comma is also deprecated and renamed to --trailing-commas. Details can be checked in #2492. Contributed by @Sec-ant

Bug fixes

  • Fix a bug where if the formatter was disabled at the language level, it could be erroneously enabled by an
    override that did not specify the formatter section #2924. Contributed by @dyc3
  • Fix #2990, now Biome doesn't add a trailing comma when formatting biome.json. Contributed by @dyc3

Editors

New features

  • Add support for LSP Workspaces

Enhancements

  • The LSP doesn't crash anymore when the configuration file contains errors. If the configuration contains errors, Biome now shows a pop-up to the user, and it will only parse files using the default configuration.
    Formatting and linting is disabled until the configuration file is fixed. Contributed by @ematipico

Bug fixes

  • Fixes #2781, by correctly computing the configuration to apply to a specific file. Contributed by @ematipico

Formatter

Bug fixes

  • Fix #2470 by avoid introducing linebreaks in single line string interpolations. Contributed by @ah-yu
  • Resolve deadlocks by narrowing the scope of locks. Contributed by @mechairoi
  • Fix #2782 by computing the enabled rules by taking the override settings into consideration. Contributed by @ematipico
  • Fix [https://github.com//issues/2877] by correctly handling line terminators in JSX string. Contributed by @ah-yu

JavaScript APIs

Linter

Promoted rules

New rules are incubated in the nursery group. Once stable, we promote them to a stable group. The following rules are promoted:

New features

Enhancements

Bug fixes

  • noUndeclaredVariables and noUnusedImports now correctly handle import namespaces (#2796).

    Previously, Biome bound unqualified type to import namespaces.
    Import namespaces can only be used as qualified names in a type (ambient) context.

    // Unused import
import * as Ns1 from "";
// This doesn't reference the import namespace `Ns1`
type T1 = Ns1; // Undeclared variable `Ns1`

// Unused import
import type * as Ns2 from "";
// This doesn't reference the import namespace `Ns2`
type T2 = Ns2; // Undeclared variable `Ns2`

import type * as Ns3 from "";
// This references the import namespace because it is a qualified name.
type T3 = Ns3.Inner;
// This also references the import namespace.
export type { Ns3 }

    Contributed by @Conaclos

  • noUndeclaredVariables now correctly handle ambient computed member names (#2975).

    A constant can be imported as a type and used in a computed member name of a member signature.
    Previously, Biome was unable to bind the value imported as a type to the computed member name.

    import type { NAME } from "./constants.js";
type X = { [NAME]: number };

    Contributed by @Conaclos

  • noUndeclaredVariables now ignores this in JSX components (#2636).

    The rule no longer reports this as undeclared in following code.

    import { Component } from 'react';

export class MyComponent extends Component {
  render() {
    return <this.foo />
  }
}

    Contributed by @printfn and @Conaclos

  • useJsxKeyInIterable now handles more cases involving fragments. See the snippets below. Contributed by @dyc3

// valid
[].map((item) => {
	return <>{item.condition ? <div key={item.id} /> : <div key={item.id}>foo</div>}</>;
});

// invalid
[].map((item) => {
	return <>{item.condition ? <div /> : <div>foo</div>}</>;
});
  • noExcessiveNestedTestSuites no longer erroneously alerts on describe calls that are not invoking the global describe function. #2599 Contributed by @dyc3
// now valid
z.object({})
  .describe('')
  .describe('')
  .describe('')
  .describe('')
  .describe('')
  .describe('');

  • noEmptyBlockStatements no longer reports empty constructors using typescript parameter properties. #3005 Contributed by @dyc3

  • noEmptyBlockStatements no longer reports empty private or protected constructors. Contributed by @dyc3

  • noExportsInTest rule no longer treats files with in-source testing as test files #2859. Contributed by @ah-yu

  • useSortedClasses now keeps leading and trailing spaces when applying the code action inside template literals:

    i Unsafe fix: Sort the classes.

  1 1 │   <>
  2   │ - → <div·class={`${variable}·px-2·foo·p-4·bar`}/>
    2 │ + → <div·class={`${variable}·foo·bar·p-4·px-2`}/>
  3 3 │   	<div class={`px-2 foo p-4 bar ${variable}`}/>
  4 4 │   </>

  • noUndeclaredDependencies is correctly triggered when running biome ci. Contributed by @ematipico

  • noUnusedVariables no longer panics when a certain combination of characters is typed. Contributed by @ematipico

  • noUndeclaredVariables no logger alerts on arguments object in a function scope. Contributed by @ah-yu

Parser

Enhancements

  • lang="tsx" is now supported in Vue Single File Components. #2765 Contributed by @dyc3

Bug fixes

  • The const modifier for type parameters is now accepted for TypeScript new signatures (#2825).

    The following code is now correctly parsed:

    interface I {
  new<const T>(x: T): T
}

    Contributed by @Conaclos

  • Some invalid TypeScript syntax caused the Biome parser to crash.

    The following invalid syntax no longer causes the Biome parser to crash:

    declare using x: null;
declare qwait using x: null;

    Contributed by @Conaclos

What's Changed

Other changes

  • ci: create workflow to enable CD for @biomejs/wasm-web by @ematipico in #2954
  • refactor: make suppression action generic via trait by @ematipico in #2955
  • release(crates): biome_deserialize and biome_deserialize_macros by @Conaclos in #2979
  • feat(css_parser): add parsing css modules @value at rule by @denbezrukov in #2985
  • chore(deps): update rust crate schemars to 0.8.21 by @renovate in #2997
  • chore(deps): update rust crate proc-macro2 to 1.0.84 by @renovate in #2996
  • chore(deps): update rust crate serde to 1.0.203 by @renovate in #2998
  • chore(deps): update actions/setup-node action to v4.0.2 by @renovate in #2993
  • chore(deps): update rust crate anyhow to 1.0.86 by @renovate in #2995
  • feat(biome_graphql_parser): parse interface type extension by @vohoanglong0107 in #2942
  • docs(noUselessConstructor): update outdated link to external docs by @dyc3 in #3008
  • refactor(biome_js_analyze): use rustc_hash::FxHashSet; and reduce allocation by @chansuke in #3004
  • feat(configuration): add support for {a,b} glob patterns, gated behind an internal flag by @dyc3 in #2989
  • fix(formatter): never format biome.json with trailing commas by @dyc3 in #3007
  • feat(css_parser): add :local and :global pseudo class. #3011 by @denbezrukov in #3012
  • feat(lsp): improve DX when the configuration has syntax errors by @ematipico in #2982
  • feat(biome_graphql_parser): parse union extension by @vohoanglong0107 in #3010
  • feat(cli): rage now prints all enabled rules by @ematipico in #2946
  • ci: move wasm build to dispatch by @ematipico in #3018
  • feat(css_parser): css modules composes by @denbezrukov in #3017
  • docs(bench): update docs of benchmark by @chansuke in #3022
  • feat: add noLabelWithoutControl rule by @michellocana in #2987
  • fix(lint/useJsxKeyInIterable): fix a false positive when key is in the return statement, but not any variable declarations by @dyc3 in #3031
  • chore(deps): update docker/login-action action to v3.2.0 by @renovate in #3045
  • chore(deps): update dependency eslint to v9.4.0 by @renovate in #3043
  • chore(deps): update rust crate proc-macro2 to 1.0.85 by @renovate in #3040
  • chore(deps): update rust crate smallvec to 1.13.2 by @renovate in #3048
  • chore(deps): update rust crate insta to 1.39.0 by @renovate in #3046
  • chore(deps): update rust crate oxc_resolver to 1.8.1 by @renovate in #3047
  • refactor(noUnusedTemplateLiteral): remove rule sources by @Conaclos in #3052
  • refactor(useThrowOnlyError): fix sources by @Conaclos in #3053
  • chore: remove git modules for better internal experience by @ematipico in #3054

New Contributors

Full Changelog: cli/v1.7.4-nightly.125f34b...cli/v1.8.0

Contributors

mechairoi, chansuke, and 23 other contributors
Assets 10
Loading