📝 stripping parenthesis breaks jsdoc types

[JakobJingleheimer]

Environment information

CLI:
  Version:                      1.9.4
  Color support:                true

Platform:
  CPU Architecture:             aarch64
  OS:                           macos

Environment:
  BIOME_LOG_PATH:               unset
  BIOME_LOG_PREFIX_NAME:        unset
  BIOME_CONFIG_PATH:            unset
  NO_COLOR:                     unset
  TERM:                         "xterm-256color"
  JS_RUNTIME_VERSION:           "v23.5.0"
  JS_RUNTIME_NAME:              "node"
  NODE_PACKAGE_MANAGER:         "npm/10.9.2"

Biome Configuration:
  Status:                       Loaded successfully
  Formatter disabled:           false
  Linter disabled:              false
  Organize imports disabled:    true
  VCS disabled:                 false

Formatter:
  Format with errors:           false
  Indent style:                 Tab
  Indent width:                 2
  Line ending:                  Lf
  Line width:                   80
  Attribute position:           Auto
  Bracket spacing:              BracketSpacing(true)
  Ignore:                       []
  Include:                      []

JavaScript Formatter:
  Enabled:                      false
  JSX quote style:              Double
  Quote properties:             AsNeeded
  Trailing commas:              All
  Semicolons:                   Always
  Arrow parentheses:            Always
  Bracket spacing:              unset
  Bracket same line:            false
  Quote style:                  Single
  Indent style:                 unset
  Indent width:                 unset
  Line ending:                  unset
  Line width:                   unset
  Attribute position:           unset

JSON Formatter:
  Enabled:                      true
  Indent style:                 unset
  Indent width:                 unset
  Line ending:                  unset
  Line width:                   unset
  Trailing Commas:              unset

CSS Formatter:
  Enabled:                      true
  Indent style:                 unset
  Indent width:                 unset
  Line ending:                  unset
  Line width:                   unset
  Quote style:                  Double

GraphQL Formatter:
  Enabled:                      false
  Indent style:                 unset
  Indent width:                 unset
  Line ending:                  unset
  Line width:                   unset
  Bracket spacing:              unset
  Quote style:                  unset

Workspace:
  Open Documents:               0

Configuration

{
	"$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
	"files": {
		"ignore": ["**/fixture/**", "**/fixture.*"],
		"include": ["**/*.js", "**/*.mjs", "**/*.cjs", "**/*.css", "**/*.json"]
	},
	"formatter": {
		"enabled": true,
		"useEditorconfig": true
	},
	"linter": {
		"rules": {
			"style": {
				"useImportType": "error",
				"useNodeAssertStrict": "error",
				"useNodejsImportProtocol": "error",
				"useTemplate": "off"
			},
			"suspicious": {
				"noExplicitAny": "error",
				"noEmptyBlock": "error",
				"noDuplicateAtImportRules": "error",
				"noDuplicateObjectKeys": "error"
			},
			"correctness": {
				"noUnusedVariables": "off",
				"useArrayLiterals": "off",
				"noUnknownFunction": "error"
			}
		}
	},
	"javascript": {
		"formatter": {
			"arrowParentheses": "always",
			"semicolons": "always",
			"quoteStyle": "single",
			"trailingCommas": "all"
		},
		"linter": {
			"enabled": true
		}
	},
	"organizeImports": {
		"enabled": false
	},
	"json": {
		"formatter": {
			"enabled": true
		}
	},
	"vcs": {
		"enabled": true,
		"clientKind": "git"
	}
}

Playground link

https://biomejs.dev/playground/?code=aQBtAHAAbwByAHQAIAB7ACAAcwBwAGEAdwBuACAAfQAgAGYAcgBvAG0AIAAnAG4AbwBkAGUAOgBjAGgAaQBsAGQAXwBwAHIAbwBjAGUAcwBzACcAOwAKAAoALwAqACoACgAgACoAIABAAHAAYQByAGEAbQAgAHsALgAuAC4AUABhAHIAYQBtAGUAdABlAHIAcwA8AHQAeQBwAGUAbwBmACAAcwBwAGEAdwBuAD4AfQAgAGEAcgBnAHMACgAgACoALwAKAGUAeABwAG8AcgB0ACAAZgB1AG4AYwB0AGkAbwBuACAAcwBwAGEAdwBuAFAAcgBvAG0AaQBzAGkAZgBpAGUAZAAoAC4ALgAuAGEAcgBnAHMAKQAgAHsACgAJAGwAZQB0ACAAcwB0AGQAZQByAHIAIAA9ACAAJwAnADsACgAJAGwAZQB0ACAAcwB0AGQAbwB1AHQAIAA9ACAAJwAnADsACgAKAAkAYwBvAG4AcwB0ACAAYwBoAGkAbABkACAAPQAgAHMAcABhAHcAbgAoAC4ALgAuAGEAcgBnAHMAKQA7AAoACQBjAGgAaQBsAGQALgBzAHQAZABlAHIAcgA%2FAC4AcwBlAHQARQBuAGMAbwBkAGkAbgBnACgAJwB1AHQAZgA4ACcAKQA7AAoACQBjAGgAaQBsAGQALgBzAHQAZABlAHIAcgA%2FAC4AbwBuACgAJwBkAGEAdABhACcALAAgACgAZABhAHQAYQApACAAPQA%2BACAAewAKAAkACQBzAHQAZABlAHIAcgAgACsAPQAgAGQAYQB0AGEAOwAKAAkAfQApADsACgAJAGMAaABpAGwAZAAuAHMAdABkAG8AdQB0AD8ALgBzAGUAdABFAG4AYwBvAGQAaQBuAGcAKAAnAHUAdABmADgAJwApADsACgAJAGMAaABpAGwAZAAuAHMAdABkAG8AdQB0AD8ALgBvAG4AKAAnAGQAYQB0AGEAJwAsACAAKABkAGEAdABhACkAIAA9AD4AIAB7AAoACQAJAHMAdABkAG8AdQB0ACAAKwA9ACAAZABhAHQAYQA7AAoACQB9ACkAOwAKAAoACQAvACoAKgAKAAkAIAAqACAAQAB0AHkAcABlACAAewBQAHIAbwBtAGkAcwBlADwAewAgAGMAbwBkAGUAOgAgAG4AdQBtAGIAZQByACAAfAAgAG4AdQBsAGwALAAgAHMAaQBnAG4AYQBsADoAIABOAG8AZABlAEoAUwAuAFMAaQBnAG4AYQBsAHMAIAB8ACAAbgB1AGwAbAAsACAAcwB0AGQAZQByAHIAOgAgAHMAdAByAGkAbgBnACwAIABzAHQAZABvAHUAdAA6ACAAcwB0AHIAaQBuAGcAIAB9AD4AfQAKAAkAIAAqAC8ACgAJAHIAZQB0AHUAcgBuACAAKABuAGUAdwAgAFAAcgBvAG0AaQBzAGUAKAAoAHIAZQBzAG8AbAB2AGUALAAgAHIAZQBqAGUAYwB0ACkAIAA9AD4AIAB7AAoACQAJAGMAaABpAGwAZAAuAG8AbgAoACcAYwBsAG8AcwBlACcALAAgACgAYwBvAGQAZQAsACAAcwBpAGcAbgBhAGwAKQAgAD0APgAgAHsACgAJAAkACQByAGUAcwBvAGwAdgBlACgAewAKAAkACQAJAAkAYwBvAGQAZQAsAAoACQAJAAkACQBzAGkAZwBuAGEAbAAsAAoACQAJAAkACQBzAHQAZABlAHIAcgAsAAoACQAJAAkACQBzAHQAZABvAHUAdAAsAAoACQAJAAkAfQApADsACgAJAAkAfQApADsACgAJAAkAYwBoAGkAbABkAC4AbwBuACgAJwBlAHIAcgBvAHIAJwAsACAAKABjAG8AZABlACwAIABzAGkAZwBuAGEAbAApACAAPQA%2BACAAewAKAAkACQAJAHIAZQBqAGUAYwB0ACgAewAKAAkACQAJAAkAYwBvAGQAZQAsAAoACQAJAAkACQBzAGkAZwBuAGEAbAAsAAoACQAJAAkACQBzAHQAZABlAHIAcgAsAAoACQAJAAkACQBzAHQAZABvAHUAdAAsAAoACQAJAAkAfQApADsACgAJAAkAfQApADsACgAJAH0AKQApADsACgB9AAoA

Code of Conduct

• I agree to follow Biome's Code of Conduct

[JakobJingleheimer]

But also, this behaviour is obnoxious in general, and I want to globally disable it. Sometimes extra parentheses greatly improve legibility, and I do not want to fight tooling to get get out of the way.

[arendjr]

I'm not sure how exactly this breaks JSDoc types, but we don't have special support for JSDoc in any case, and we don't intend to add new formatter options: https://biomejs.dev/formatter/option-philosophy/

I don't think this issue will be picked up any time soon, sorry.

[JakobJingleheimer]

Seemingly unnecessary parentheses are required around whatever is be casted in TypeScript via jsdocs:

https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#casts

Your formatter removes them, breaking the types.

JSDocs and TypeScript are huge—way bigger than biome, and they're already used in millions of projects. If you force a choice between them and biome, you'll surely lose.

This is not about one preference versus another—biome's opinion breaks things, which makes it objectively wrong.