projen 0.101.26 → 0.101.28

package/lib/javascript/biome/biome-config.d.ts

@@ -1,5 +1,5 @@
 /**
- * The configuration that is contained inside the file `biome.json`
+ * The configuration contained in `biome.json`.
  *
  * @schema BiomeConfiguration
  */
@@ -11,13 +11,13 @@ export interface BiomeConfiguration {
      */
     readonly schema?: string;
     /**
-     * Specific configuration for assists
+     * The assist configuration.
      *
      * @schema BiomeConfiguration#assist
      */
     readonly assist?: AssistConfiguration;
     /**
-     * Specific configuration for the Css language
+     * Configuration specific to CSS.
      *
      * @schema BiomeConfiguration#css
      */
@@ -29,55 +29,55 @@ export interface BiomeConfiguration {
      */
     readonly extends?: string[];
     /**
-     * The configuration of the filesystem
+     * The file handling configuration.
      *
      * @schema BiomeConfiguration#files
      */
     readonly files?: FilesConfiguration;
     /**
-     * The configuration of the formatter
+     * The formatter configuration.
      *
      * @schema BiomeConfiguration#formatter
      */
     readonly formatter?: FormatterConfiguration;
     /**
-     * Specific configuration for the GraphQL language
+     * Configuration specific to GraphQL.
      *
      * @schema BiomeConfiguration#graphql
      */
     readonly graphql?: GraphqlConfiguration;
     /**
-     * Specific configuration for the GraphQL language
+     * Configuration specific to GritQL.
      *
      * @schema BiomeConfiguration#grit
      */
     readonly grit?: GritConfiguration;
     /**
-     * Specific configuration for the HTML language
+     * Configuration specific to HTML.
      *
      * @schema BiomeConfiguration#html
      */
     readonly html?: HtmlConfiguration;
     /**
-     * Specific configuration for the JavaScript language
+     * Configuration specific to JavaScript.
      *
      * @schema BiomeConfiguration#javascript
      */
     readonly javascript?: JsConfiguration;
     /**
-     * Specific configuration for the Json language
+     * Configuration specific to JSON.
      *
      * @schema BiomeConfiguration#json
      */
     readonly json?: JsonConfiguration;
     /**
-     * The configuration for the linter
+     * The linter configuration.
      *
      * @schema BiomeConfiguration#linter
      */
     readonly linter?: LinterConfiguration;
     /**
-     * A list of granular patterns that should be applied only to a sub set of files
+     * A list of granular patterns applied only to a subset of files.
      *
      * @schema BiomeConfiguration#overrides
      */
@@ -96,7 +96,7 @@ export interface BiomeConfiguration {
      */
     readonly root?: boolean;
     /**
-     * The configuration of the VCS integration
+     * The version control integration configuration.
      *
      * @schema BiomeConfiguration#vcs
      */
@@ -137,37 +137,37 @@ export interface AssistConfiguration {
  */
 export declare function toJson_AssistConfiguration(obj: AssistConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options applied to CSS files
+ * Options applied to CSS files.
  *
  * @schema CssConfiguration
  */
 export interface CssConfiguration {
     /**
-     * CSS assist options
+     * CSS assist options.
      *
      * @schema CssConfiguration#assist
      */
     readonly assist?: CssAssistConfiguration;
     /**
-     * CSS formatter options
+     * CSS formatter options.
      *
      * @schema CssConfiguration#formatter
      */
     readonly formatter?: CssFormatterConfiguration;
     /**
-     * CSS globals
+     * CSS globals.
      *
      * @schema CssConfiguration#globals
      */
     readonly globals?: string[];
     /**
-     * CSS linter options
+     * CSS linter options.
      *
      * @schema CssConfiguration#linter
      */
     readonly linter?: CssLinterConfiguration;
     /**
-     * CSS parsing options
+     * CSS parsing options.
      *
      * @schema CssConfiguration#parser
      */
@@ -179,7 +179,7 @@ export interface CssConfiguration {
  */
 export declare function toJson_CssConfiguration(obj: CssConfiguration | undefined): Record<string, any> | undefined;
 /**
- * The configuration of the filesystem
+ * The file handling configuration.
  *
  * @schema FilesConfiguration
  */
@@ -195,23 +195,22 @@ export interface FilesConfiguration {
      */
     readonly experimentalScannerIgnores?: string[];
     /**
-     * Tells Biome to not emit diagnostics when handling files that it doesn't know
+     * Prevents Biome from emitting diagnostics for unrecognized file types.
      *
      * @schema FilesConfiguration#ignoreUnknown
      */
     readonly ignoreUnknown?: boolean;
     /**
-     * A list of glob patterns. Biome will handle only those files/folders that will
-     * match these patterns.
+     * A list of glob patterns. Biome handles only files and directories that match these
+     * patterns.
      *
      * @schema FilesConfiguration#includes
      */
     readonly includes?: string[];
     /**
-     * The maximum allowed size for source code files in bytes. Files above
-     * this limit will be ignored for performance reasons. Defaults to 1 MiB
+     * The maximum source file size in bytes. Biome ignores larger files. Defaults to `1 MiB`.
      *
-     * @default 1 MiB
+     * @default 1 MiB`.
      * @schema FilesConfiguration#maxSize
      */
     readonly maxSize?: number;
@@ -228,33 +227,34 @@ export declare function toJson_FilesConfiguration(obj: FilesConfiguration | unde
  */
 export interface FormatterConfiguration {
     /**
-     * The attribute position style in HTML-ish languages. Defaults to auto.
+     * The attribute position style in HTML-like languages. Defaults to `auto`.
      *
-     * @default auto.
+     * @default auto`.
      * @schema FormatterConfiguration#attributePosition
      */
     readonly attributePosition?: AttributePosition;
     /**
-     * Put the `>` of a multi-line HTML or JSX element at the end of the last line instead of being alone on the next line (does not apply to self closing elements).
+     * Places the `>` of a multiline HTML or JSX element at the end of the last line instead of on
+     * the next line. Self-closing elements are unaffected. Defaults to `false`.
      *
+     * @default false`.
      * @schema FormatterConfiguration#bracketSameLine
      */
     readonly bracketSameLine?: boolean;
     /**
-     * Whether to insert spaces around brackets in object literals. Defaults to true.
+     * Whether to insert spaces inside braces in object literals. Defaults to `true`.
      *
-     * @default true.
+     * @default true`.
      * @schema FormatterConfiguration#bracketSpacing
      */
     readonly bracketSpacing?: boolean;
     /**
-     * Whether to insert spaces inside delimiters (after the opening delimiter and before the
-     * closing delimiter), such as parentheses, brackets, angle brackets, and template literal
-     * interpolations. Spaces are not added before the opening delimiter, and empty delimiters
-     * are not affected. Only applies when the content fits on a single line. The specific
-     * delimiters affected depend on the language. Defaults to false.
+     * Controls spaces immediately inside supported delimiters when their content fits on one line.
+     * It doesn't add spaces before opening delimiters or inside empty delimiters.
+     *
+     * The affected delimiters vary by language. Defaults to `false`.
      *
-     * @default false.
+     * @default false`.
      * @schema FormatterConfiguration#delimiterSpacing
      */
     readonly delimiterSpacing?: boolean;
@@ -263,21 +263,27 @@ export interface FormatterConfiguration {
      */
     readonly enabled?: boolean;
     /**
-     * Whether to expand arrays and objects on multiple lines.
-     * When set to `auto`, object literals are formatted on multiple lines if the first property has a newline,
-     * and array literals are formatted on a single line if it fits in the line.
-     * When set to `always`, these literals are formatted on multiple lines, regardless of length of the list.
-     * When set to `never`, these literals are formatted on a single line if it fits in the line.
-     * When formatting `package.json`, Biome will use `always` unless configured otherwise. Defaults to "auto".
+     * Controls whether arrays and objects are formatted on one line or multiple lines.
+     *
+     * `auto` formats objects on multiple lines if the first property has a newline, and arrays on
+     * one line if they fit.
+     *
+     * `always` formats arrays and objects on multiple lines.
+     *
+     * `never` formats arrays and objects on one line if they fit.
+     *
+     * Defaults to `auto`.
      *
-     * @default auto".
+     * When formatting `package.json`, Biome uses `always` unless configured otherwise.
+     *
+     * @default auto`.
      * @schema FormatterConfiguration#expand
      */
     readonly expand?: Expand;
     /**
-     * Whether formatting should be allowed to proceed if a given file
-     * has syntax errors
+     * Allows formatting files that contain syntax errors when set to `true`. Defaults to `false`.
      *
+     * @default false`.
      * @schema FormatterConfiguration#formatWithErrors
      */
     readonly formatWithErrors?: boolean;
@@ -289,52 +295,46 @@ export interface FormatterConfiguration {
      */
     readonly includes?: string[];
     /**
-     * The indent style.
+     * Uses tabs or spaces for indentation. Defaults to `tab`.
      *
+     * @default tab`.
      * @schema FormatterConfiguration#indentStyle
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The size of the indentation, 2 by default
+     * The indentation width. Defaults to `2`.
      *
+     * @default 2`.
      * @schema FormatterConfiguration#indentWidth
      */
     readonly indentWidth?: number;
     /**
-     * The type of line ending.
+     * Selects the line ending. `auto` uses the platform convention. Defaults to `lf`.
      *
+     * @default lf`.
      * @schema FormatterConfiguration#lineEnding
      */
     readonly lineEnding?: LineEnding;
     /**
-     * What's the max width of a line. Defaults to 80.
+     * The maximum line width. Defaults to `80`.
      *
-     * @default 80.
+     * @default 80`.
      * @schema FormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * Whether to add a trailing newline at the end of the file.
-     *
-     * Setting this option to `false` is **highly discouraged** because it could cause many problems with other tools:
-     * - https://thoughtbot.com/blog/no-newline-at-end-of-file
-     * - https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804
-     * - https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files
-     *
-     * Disable the option at your own risk.
-     *
-     * Defaults to true.
+     * Whether to add a trailing newline at the end of the file. Defaults to `true`; disabling
+     * this option can cause compatibility problems with other tools.
      *
-     * @default true.
+     * @default true`; disabling
      * @schema FormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
     /**
-     * Use any `.editorconfig` files to configure the formatter. Configuration
-     * in `biome.json` will override `.editorconfig` configuration.
-     *
-     * Default: `false`.
+     * Uses `.editorconfig` files to configure the formatter. Settings in `biome.json` or
+     * `biome.jsonc` override `.editorconfig` settings. Defaults to `false`.
      *
+     * @default false`.
      * @schema FormatterConfiguration#useEditorconfig
      */
     readonly useEditorconfig?: boolean;
@@ -345,24 +345,26 @@ export interface FormatterConfiguration {
  */
 export declare function toJson_FormatterConfiguration(obj: FormatterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options applied to GraphQL files
+ * Options applied to GraphQL files.
  *
  * @schema GraphqlConfiguration
  */
 export interface GraphqlConfiguration {
     /**
-     * Assist options
+     * GraphQL assist options.
      *
      * @schema GraphqlConfiguration#assist
      */
     readonly assist?: GraphqlAssistConfiguration;
     /**
-     * GraphQL formatter options
+     * GraphQL formatter options.
      *
      * @schema GraphqlConfiguration#formatter
      */
     readonly formatter?: GraphqlFormatterConfiguration;
     /**
+     * GraphQL linter options.
+     *
      * @schema GraphqlConfiguration#linter
      */
     readonly linter?: GraphqlLinterConfiguration;
@@ -373,25 +375,25 @@ export interface GraphqlConfiguration {
  */
 export declare function toJson_GraphqlConfiguration(obj: GraphqlConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options applied to GritQL files
+ * Options applied to GritQL files.
  *
  * @schema GritConfiguration
  */
 export interface GritConfiguration {
     /**
-     * Assist options
+     * GritQL assist options.
      *
      * @schema GritConfiguration#assist
      */
     readonly assist?: GritAssistConfiguration;
     /**
-     * Formatting options
+     * GritQL formatter options.
      *
      * @schema GritConfiguration#formatter
      */
     readonly formatter?: GritFormatterConfiguration;
     /**
-     * Formatting options
+     * GritQL linter options.
      *
      * @schema GritConfiguration#linter
      */
@@ -403,35 +405,37 @@ export interface GritConfiguration {
  */
 export declare function toJson_GritConfiguration(obj: GritConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options applied to HTML files
+ * Options applied to HTML files.
  *
  * @schema HtmlConfiguration
  */
 export interface HtmlConfiguration {
     /**
+     * HTML assist options.
+     *
      * @schema HtmlConfiguration#assist
      */
     readonly assist?: HtmlAssistConfiguration;
     /**
-     * Enables full support for HTML, Vue, Svelte and Astro files.
+     * Enables full support for HTML, Vue, Svelte, and Astro files.
      *
      * @schema HtmlConfiguration#experimentalFullSupportEnabled
      */
     readonly experimentalFullSupportEnabled?: boolean;
     /**
-     * HTML formatter options
+     * HTML formatter options.
      *
      * @schema HtmlConfiguration#formatter
      */
     readonly formatter?: HtmlFormatterConfiguration;
     /**
-     * HTML linter options
+     * HTML linter options.
      *
      * @schema HtmlConfiguration#linter
      */
     readonly linter?: HtmlLinterConfiguration;
     /**
-     * HTML parsing options
+     * HTML parsing options.
      *
      * @schema HtmlConfiguration#parser
      */
@@ -661,43 +665,45 @@ export interface OverridePattern {
  */
 export declare function toJson_OverridePattern(obj: OverridePattern | undefined): Record<string, any> | undefined;
 /**
- * Set of properties to integrate Biome with a VCS software.
+ * Settings for integrating Biome with version control.
  *
  * @schema VcsConfiguration
  */
 export interface VcsConfiguration {
     /**
-     * The kind of client.
+     * The version control client.
      *
      * @schema VcsConfiguration#clientKind
      */
     readonly clientKind?: VcsClientKind;
     /**
-     * The main branch of the project
+     * The project's default branch.
      *
      * @schema VcsConfiguration#defaultBranch
      */
     readonly defaultBranch?: string;
     /**
-     * Whether Biome should integrate itself with the VCS client
+     * Whether Biome should integrate with the version control client.
      *
      * @schema VcsConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * The folder where Biome should check for VCS files. By default, Biome will use the same
-     * folder where `biome.json` was found.
+     * Sets the directory where Biome checks for version control files.
      *
-     * If Biome can't find the configuration, it will attempt to use the current working directory.
-     * If no current working directory can't be found, Biome won't use the VCS integration, and a diagnostic
-     * will be emitted
+     * Defaults to the directory containing `biome.json` or `biome.jsonc`. If no configuration is
+     * found, Biome uses the current working directory.
      *
+     * If neither directory is available, Biome disables version control integration and emits a
+     * diagnostic.
+     *
+     * @default the directory containing `biome.json` or `biome.jsonc`. If no configuration is
      * @schema VcsConfiguration#root
      */
     readonly root?: string;
     /**
-     * Whether Biome should use VCS ignore files. When [true], Biome will ignore files
-     * specified in `.gitignore`, `.ignore`, and Git's local exclude file.
+     * When `true`, Biome ignores files listed in `.gitignore`, `.ignore`, and Git's local
+     * exclude file.
      *
      * @schema VcsConfiguration#useIgnoreFile
      */
@@ -735,13 +741,13 @@ export interface Actions {
  */
 export declare function toJson_Actions(obj: Actions | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the CSS assist behaves
+ * Options that change how CSS assist behaves.
  *
  * @schema CssAssistConfiguration
  */
 export interface CssAssistConfiguration {
     /**
-     * Control the assist for CSS files.
+     * Controls assist actions for CSS files.
      *
      * @schema CssAssistConfiguration#enabled
      */
@@ -753,73 +759,66 @@ export interface CssAssistConfiguration {
  */
 export declare function toJson_CssAssistConfiguration(obj: CssAssistConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the CSS formatter behaves
+ * Options that change how the CSS formatter behaves.
  *
  * @schema CssFormatterConfiguration
  */
 export interface CssFormatterConfiguration {
     /**
-     * Whether to insert spaces inside delimiters (after the opening delimiter and before the
-     * closing delimiter). Only applies when the content fits on a single line, and empty
-     * delimiters are not affected. For CSS, affects parentheses (e.g., `rgb( 0, 0, 0 )`) and
-     * square brackets (e.g., `[ data-attr ]`). Defaults to false.
+     * Controls spaces inside CSS parentheses and square brackets when their content fits on one
+     * line. When enabled, `rgb(0, 0, 0)` becomes `rgb( 0, 0, 0 )` and `[data-attr]` becomes
+     * `[ data-attr ]`. Empty delimiters are unchanged.
+     *
+     * If unset, inherits the global delimiter spacing setting.
      *
-     * @default false.
      * @schema CssFormatterConfiguration#delimiterSpacing
      */
     readonly delimiterSpacing?: boolean;
     /**
-     * Control the formatter for CSS (and its super languages) files.
+     * Controls the formatter for CSS and languages that extend it.
      *
      * @schema CssFormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * The indent style applied to CSS (and its super languages) files.
+     * The indent style applied to CSS and languages that extend it. If unset, inherits the global
+     * indentation style.
      *
      * @schema CssFormatterConfiguration#indentStyle
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The size of the indentation applied to CSS (and its super languages) files. Default to 2.
+     * The indentation width applied to CSS and languages that extend it. If unset, inherits the
+     * global indentation width.
      *
-     * @default 2.
      * @schema CssFormatterConfiguration#indentWidth
      */
     readonly indentWidth?: number;
     /**
-     * The type of line ending applied to CSS (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+     * The line ending applied to CSS and languages that extend it. If unset, inherits the global
+     * line ending.
      *
      * @schema CssFormatterConfiguration#lineEnding
      */
     readonly lineEnding?: LineEnding;
     /**
-     * What's the max width of a line applied to CSS (and its super languages) files. Defaults to 80.
+     * The maximum line width for CSS and languages that extend it. If unset, inherits the global
+     * line width.
      *
-     * @default 80.
      * @schema CssFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * The type of quotes used in CSS code. Defaults to double.
+     * The type of quotes used in CSS code. Defaults to `double`.
      *
-     * @default double.
+     * @default double`.
      * @schema CssFormatterConfiguration#quoteStyle
      */
     readonly quoteStyle?: QuoteStyle;
     /**
-     * Whether to add a trailing newline at the end of the file.
-     *
-     * Setting this option to `false` is **highly discouraged** because it could cause many problems with other tools:
-     * - https://thoughtbot.com/blog/no-newline-at-end-of-file
-     * - https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804
-     * - https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files
-     *
-     * Disable the option at your own risk.
-     *
-     * Defaults to true.
+     * Whether to add a trailing newline at the end of the file. If unset, inherits the global
+     * trailing newline setting.
      *
-     * @default true.
      * @schema CssFormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
@@ -830,13 +829,13 @@ export interface CssFormatterConfiguration {
  */
 export declare function toJson_CssFormatterConfiguration(obj: CssFormatterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the CSS linter behaves
+ * Options that change how the CSS linter behaves.
  *
  * @schema CssLinterConfiguration
  */
 export interface CssLinterConfiguration {
     /**
-     * Control the linter for CSS files.
+     * Controls the linter for CSS files.
      *
      * @schema CssLinterConfiguration#enabled
      */
@@ -848,19 +847,19 @@ export interface CssLinterConfiguration {
  */
 export declare function toJson_CssLinterConfiguration(obj: CssLinterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the CSS parser behaves
+ * Options that change how the CSS parser behaves.
  *
  * @schema CssParserConfiguration
  */
 export interface CssParserConfiguration {
     /**
-     * Allow comments to appear on incorrect lines in `.css` files
+     * Allows comments to appear on incorrect lines in `.css` files.
      *
      * @schema CssParserConfiguration#allowWrongLineComments
      */
     readonly allowWrongLineComments?: boolean;
     /**
-     * Enables parsing of CSS Modules specific features. Enable this feature only
+     * Enables parsing of CSS Modules-specific features. Enable this feature only
      * when your files don't end in `.module.css`.
      *
      * @schema CssParserConfiguration#cssModules
@@ -891,12 +890,12 @@ export declare enum AttributePosition {
  * @schema Expand
  */
 export declare enum Expand {
-    /** Objects are expanded when the first property has a leading newline. Arrays are always
-  expanded if they are shorter than the line width. (auto) */
+    /** Objects are expanded when the first property has a leading newline. Arrays remain on one
+  line if they fit. (auto) */
     AUTO = "auto",
     /** Objects and arrays are always expanded. (always) */
     ALWAYS = "always",
-    /** Objects and arrays are never expanded, if they are shorter than the line width. (never) */
+    /** Objects and arrays remain on one line if they fit. (never) */
     NEVER = "never"
 }
 /**
@@ -922,13 +921,13 @@ export declare enum LineEnding {
     AUTO = "auto"
 }
 /**
- * Options that changes how the GraphQL linter behaves
+ * Options that change how GraphQL assist behaves.
  *
  * @schema GraphqlAssistConfiguration
  */
 export interface GraphqlAssistConfiguration {
     /**
-     * Control the formatter for GraphQL files.
+     * Controls assist actions for GraphQL files.
      *
      * @schema GraphqlAssistConfiguration#enabled
      */
@@ -940,70 +939,60 @@ export interface GraphqlAssistConfiguration {
  */
 export declare function toJson_GraphqlAssistConfiguration(obj: GraphqlAssistConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the GraphQL formatter behaves
+ * Options that change how the GraphQL formatter behaves.
  *
  * @schema GraphqlFormatterConfiguration
  */
 export interface GraphqlFormatterConfiguration {
     /**
-     * Whether to insert spaces around brackets in object literals. Defaults to true.
+     * Whether to insert spaces inside braces in object literals. If unset, inherits the global
+     * bracket spacing setting.
      *
-     * @default true.
      * @schema GraphqlFormatterConfiguration#bracketSpacing
      */
     readonly bracketSpacing?: boolean;
     /**
-     * Control the formatter for GraphQL files.
+     * Controls the formatter for GraphQL files.
      *
      * @schema GraphqlFormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * The indent style applied to GraphQL files.
+     * The indent style applied to GraphQL files. If unset, inherits the global indentation style.
      *
      * @schema GraphqlFormatterConfiguration#indentStyle
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The size of the indentation applied to GraphQL files. Default to 2.
+     * The indentation width applied to GraphQL files. If unset, inherits the global indentation
+     * width.
      *
-     * @default 2.
      * @schema GraphqlFormatterConfiguration#indentWidth
      */
     readonly indentWidth?: number;
     /**
-     * The type of line ending applied to GraphQL files. `auto` uses CRLF on Windows and LF on other platforms.
+     * The line ending applied to GraphQL files. If unset, inherits the global line ending.
      *
      * @schema GraphqlFormatterConfiguration#lineEnding
      */
     readonly lineEnding?: LineEnding;
     /**
-     * What's the max width of a line applied to GraphQL files. Defaults to 80.
+     * The maximum line width for GraphQL files. If unset, inherits the global line width.
      *
-     * @default 80.
      * @schema GraphqlFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * The type of quotes used in GraphQL code. Defaults to double.
+     * The type of quotes used in GraphQL code. Defaults to `double`.
      *
-     * @default double.
+     * @default double`.
      * @schema GraphqlFormatterConfiguration#quoteStyle
      */
     readonly quoteStyle?: QuoteStyle;
     /**
-     * Whether to add a trailing newline at the end of the file.
+     * Whether to add a trailing newline at the end of the file. If unset, inherits the global
+     * trailing newline setting.
      *
-     * Setting this option to `false` is **highly discouraged** because it could cause many problems with other tools:
-     * - https://thoughtbot.com/blog/no-newline-at-end-of-file
-     * - https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804
-     * - https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files
-     *
-     * Disable the option at your own risk.
-     *
-     * Defaults to true.
-     *
-     * @default true.
      * @schema GraphqlFormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
@@ -1020,7 +1009,7 @@ export declare function toJson_GraphqlFormatterConfiguration(obj: GraphqlFormatt
  */
 export interface GraphqlLinterConfiguration {
     /**
-     * Control the formatter for GraphQL files.
+     * Controls the linter for GraphQL files.
      *
      * @schema GraphqlLinterConfiguration#enabled
      */
@@ -1032,11 +1021,13 @@ export interface GraphqlLinterConfiguration {
  */
 export declare function toJson_GraphqlLinterConfiguration(obj: GraphqlLinterConfiguration | undefined): Record<string, any> | undefined;
 /**
+ * Options that change how GritQL assist behaves.
+ *
  * @schema GritAssistConfiguration
  */
 export interface GritAssistConfiguration {
     /**
-     * Control the assist functionality for Grit files.
+     * Controls assist actions for GritQL files.
      *
      * @schema GritAssistConfiguration#enabled
      */
@@ -1048,54 +1039,46 @@ export interface GritAssistConfiguration {
  */
 export declare function toJson_GritAssistConfiguration(obj: GritAssistConfiguration | undefined): Record<string, any> | undefined;
 /**
+ * Options that change how the GritQL formatter behaves.
+ *
  * @schema GritFormatterConfiguration
  */
 export interface GritFormatterConfiguration {
     /**
-     * Control the formatter for Grit files.
+     * Controls the formatter for GritQL files.
      *
      * @schema GritFormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * The indent style applied to Grit files.
+     * The indent style applied to GritQL files. If unset, inherits the global indentation style.
      *
      * @schema GritFormatterConfiguration#indentStyle
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The size of the indentation applied to Grit files. Default to 2.
+     * The indentation width applied to GritQL files. If unset, inherits the global indentation
+     * width.
      *
-     * @default 2.
      * @schema GritFormatterConfiguration#indentWidth
      */
     readonly indentWidth?: number;
     /**
-     * The type of line ending applied to Grit files.
+     * The line ending applied to GritQL files. If unset, inherits the global line ending.
      *
      * @schema GritFormatterConfiguration#lineEnding
      */
     readonly lineEnding?: LineEnding;
     /**
-     * What's the max width of a line applied to Grit files. Defaults to 80.
+     * The maximum line width for GritQL files. If unset, inherits the global line width.
      *
-     * @default 80.
      * @schema GritFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * Whether to add a trailing newline at the end of the file.
-     *
-     * Setting this option to `false` is **highly discouraged** because it could cause many problems with other tools:
-     * - https://thoughtbot.com/blog/no-newline-at-end-of-file
-     * - https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804
-     * - https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files
-     *
-     * Disable the option at your own risk.
+     * Whether to add a trailing newline at the end of the file. If unset, inherits the global
+     * trailing newline setting.
      *
-     * Defaults to true.
-     *
-     * @default true.
      * @schema GritFormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
@@ -1106,11 +1089,13 @@ export interface GritFormatterConfiguration {
  */
 export declare function toJson_GritFormatterConfiguration(obj: GritFormatterConfiguration | undefined): Record<string, any> | undefined;
 /**
+ * Options that change how the GritQL linter behaves.
+ *
  * @schema GritLinterConfiguration
  */
 export interface GritLinterConfiguration {
     /**
-     * Control the linter for Grit files.
+     * Controls the linter for GritQL files.
      *
      * @schema GritLinterConfiguration#enabled
      */
@@ -1122,13 +1107,13 @@ export interface GritLinterConfiguration {
  */
 export declare function toJson_GritLinterConfiguration(obj: GritLinterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the HTML assist behaves
+ * Options that change how HTML assist behaves.
  *
  * @schema HtmlAssistConfiguration
  */
 export interface HtmlAssistConfiguration {
     /**
-     * Control the assist for HTML (and its super languages) files.
+     * Controls assist actions for HTML and languages that extend it.
      *
      * @schema HtmlAssistConfiguration#enabled
      */
@@ -1140,91 +1125,87 @@ export interface HtmlAssistConfiguration {
  */
 export declare function toJson_HtmlAssistConfiguration(obj: HtmlAssistConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the HTML formatter behaves
+ * Options that change how the HTML formatter behaves.
  *
  * @schema HtmlFormatterConfiguration
  */
 export interface HtmlFormatterConfiguration {
     /**
-     * The attribute position style in HTML elements. Defaults to auto.
+     * The attribute position style in HTML elements. If unset, inherits the global attribute
+     * position setting.
      *
-     * @default auto.
      * @schema HtmlFormatterConfiguration#attributePosition
      */
     readonly attributePosition?: AttributePosition;
     /**
-     * Whether to hug the closing bracket of multiline HTML tags to the end of the last line, rather than being alone on the following line. Defaults to false.
+     * Whether to place the closing bracket of a multiline HTML tag at the end of the last line
+     * instead of on its own line. If unset, inherits the global `bracketSameLine` setting.
      *
-     * @default false.
      * @schema HtmlFormatterConfiguration#bracketSameLine
      */
     readonly bracketSameLine?: boolean;
     /**
-     * Control the formatter for HTML (and its super languages) files.
+     * Controls the formatter for HTML and languages that extend it.
      *
      * @schema HtmlFormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * Whether to indent the `<script>` and `<style>` tags for HTML (and its super languages). Defaults to false.
+     * Whether to indent `<script>` and `<style>` tags in HTML and languages that extend it.
+     * Defaults to `false`.
      *
-     * @default false.
+     * @default false`.
      * @schema HtmlFormatterConfiguration#indentScriptAndStyle
      */
     readonly indentScriptAndStyle?: boolean;
     /**
-     * The indent style applied to HTML (and its super languages) files.
+     * The indent style applied to HTML and languages that extend it. If unset, inherits the global
+     * indentation style.
      *
      * @schema HtmlFormatterConfiguration#indentStyle
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The size of the indentation applied to HTML (and its super languages) files. Default to 2.
+     * The indentation width applied to HTML and languages that extend it. If unset, inherits the
+     * global indentation width.
      *
-     * @default 2.
      * @schema HtmlFormatterConfiguration#indentWidth
      */
     readonly indentWidth?: number;
     /**
-     * The type of line ending applied to HTML (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+     * The line ending applied to HTML and languages that extend it. If unset, inherits the global
+     * line ending.
      *
      * @schema HtmlFormatterConfiguration#lineEnding
      */
     readonly lineEnding?: LineEnding;
     /**
-     * What's the max width of a line applied to HTML (and its super languages) files. Defaults to 80.
+     * The maximum line width for HTML and languages that extend it. If unset, inherits the global
+     * line width.
      *
-     * @default 80.
      * @schema HtmlFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * Whether void elements should be self-closed. Defaults to never.
+     * Controls whether void elements are self-closed. Defaults to `never`.
      *
-     * @default never.
+     * @default never`.
      * @schema HtmlFormatterConfiguration#selfCloseVoidElements
      */
     readonly selfCloseVoidElements?: SelfCloseVoidElements;
     /**
-     * Whether to add a trailing newline at the end of the file.
-     *
-     * Setting this option to `false` is **highly discouraged** because it could cause many problems with other tools:
-     * - https://thoughtbot.com/blog/no-newline-at-end-of-file
-     * - https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804
-     * - https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files
+     * Whether to add a trailing newline at the end of the file. Unlike other language-specific
+     * trailing newline settings, this option defaults to `true` instead of inheriting the global
+     * setting.
      *
-     * Disable the option at your own risk.
-     *
-     * Defaults to true.
-     *
-     * @default true.
      * @schema HtmlFormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
     /**
-     * Whether to account for whitespace sensitivity when formatting HTML (and its super languages). Defaults to "css".
+     * Whether to account for whitespace sensitivity when formatting HTML and languages that
+     * extend it. Defaults to `css`.
      *
-     * @default css".
+     * @default css`.
      * @schema HtmlFormatterConfiguration#whitespaceSensitivity
      */
     readonly whitespaceSensitivity?: WhitespaceSensitivity;
@@ -1235,13 +1216,13 @@ export interface HtmlFormatterConfiguration {
  */
 export declare function toJson_HtmlFormatterConfiguration(obj: HtmlFormatterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the HTML linter behaves
+ * Options that change how the HTML linter behaves.
  *
  * @schema HtmlLinterConfiguration
  */
 export interface HtmlLinterConfiguration {
     /**
-     * Control the linter for HTML (and its super languages) files.
+     * Controls the linter for HTML and languages that extend it.
      *
      * @schema HtmlLinterConfiguration#enabled
      */
@@ -1253,19 +1234,20 @@ export interface HtmlLinterConfiguration {
  */
 export declare function toJson_HtmlLinterConfiguration(obj: HtmlLinterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the HTML parser behaves
+ * Options that change how the HTML parser behaves.
  *
  * @schema HtmlParserConfiguration
  */
 export interface HtmlParserConfiguration {
     /**
-     * Enables the parsing of double text expressions such as `{{ expression }}` inside `.html` files
+     * Enables parsing double text expressions such as `{{ expression }}` inside `.html` files.
      *
      * @schema HtmlParserConfiguration#interpolation
      */
     readonly interpolation?: boolean;
     /**
-     * Enables parsing of Vue syntax (v-if, v-bind, etc.) in `.html` files. If this option is enabled, it also enables `interpolation` implicitly.
+     * Enables parsing Vue syntax (`v-if`, `v-bind`, etc.) in `.html` files. Enabling this option
+     * also enables `interpolation` implicitly.
      *
      * Biome will already automatically enable Vue parsing in `.vue` files, so you probably don't need
      * to enable this option. This only affects `.html` files, and does not change how `.vue`, `.svelte`,
@@ -1287,7 +1269,7 @@ export declare function toJson_HtmlParserConfiguration(obj: HtmlParserConfigurat
  */
 export interface JsAssistConfiguration {
     /**
-     * Control the assist for JavaScript (and its super languages) files.
+     * Controls assist actions for JavaScript and languages that extend it.
      *
      * @schema JsAssistConfiguration#enabled
      */
@@ -1305,146 +1287,140 @@ export declare function toJson_JsAssistConfiguration(obj: JsAssistConfiguration
  */
 export interface JsFormatterConfiguration {
     /**
-     * Whether to add non-necessary parentheses to arrow functions. Defaults to "always".
+     * Whether to add parentheses around arrow function parameters. Defaults to `always`.
      *
-     * @default always".
+     * @default always`.
      * @schema JsFormatterConfiguration#arrowParentheses
      */
     readonly arrowParentheses?: ArrowParentheses;
     /**
-     * The attribute position style in JSX elements. Defaults to auto.
+     * The attribute position style in JSX elements. If unset, inherits the global attribute
+     * position setting.
      *
-     * @default auto.
      * @schema JsFormatterConfiguration#attributePosition
      */
     readonly attributePosition?: AttributePosition;
     /**
-     * Whether to hug the closing bracket of multiline HTML/JSX tags to the end of the last line, rather than being alone on the following line. Defaults to false.
+     * Whether to hug the closing bracket of multiline HTML/JSX tags to the end of the last line,
+     * rather than being alone on the following line. If unset, inherits the global bracket
+     * placement setting.
      *
-     * @default false.
      * @schema JsFormatterConfiguration#bracketSameLine
      */
     readonly bracketSameLine?: boolean;
     /**
-     * Whether to insert spaces around brackets in object literals. Defaults to true.
+     * Whether to insert spaces inside braces in object literals. If unset, inherits the global
+     * bracket spacing setting.
      *
-     * @default true.
      * @schema JsFormatterConfiguration#bracketSpacing
      */
     readonly bracketSpacing?: boolean;
     /**
-     * Whether to insert spaces inside delimiters (after the opening delimiter and before the
-     * closing delimiter). Only applies when the content fits on a single line. Spaces are not
-     * added before the opening delimiter (e.g., `function f()` stays `function f()`, not
-     * `function f ()`), and empty delimiters are not affected (e.g., `fn()` stays `fn()`).
-     * For JavaScript and TypeScript, affects parentheses (e.g., `foo( a, b )`), square brackets
-     * (e.g., `[ a, b ]`), template literal interpolations (e.g., `${ expr }`), TypeScript angle
-     * brackets (e.g., `foo< T >()`), JSX expression braces (e.g., `{ value }`), and the logical
-     * NOT operator (e.g., `! x`, but in chains only after the last one: `!! x`). Defaults to
-     * false.
-     *
-     * @default false.
+     * Controls spaces immediately inside supported JavaScript and TypeScript delimiters when their
+     * content fits on one line. It doesn't add spaces before opening delimiters or inside empty
+     * delimiters.
+     *
+     * It affects parentheses, square brackets, template interpolations, TypeScript angle brackets,
+     * JSX expression braces, and logical NOT. In operator chains, only the final operator receives
+     * a following space.
+     *
+     * If unset, inherits the global delimiter spacing setting.
+     *
      * @schema JsFormatterConfiguration#delimiterSpacing
      */
     readonly delimiterSpacing?: boolean;
     /**
-     * Control the formatter for JavaScript (and its super languages) files.
+     * Controls the formatter for JavaScript and languages that extend it.
      *
      * @schema JsFormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * Whether to expand arrays and objects on multiple lines.
-     * When set to `auto`, object literals are formatted on multiple lines if the first property has a newline,
-     * and array literals are formatted on a single line if it fits in the line.
-     * When set to `always`, these literals are formatted on multiple lines, regardless of length of the list.
-     * When set to `never`, these literals are formatted on a single line if it fits in the line.
-     * When formatting `package.json`, Biome will use `always` unless configured otherwise. Defaults to "auto".
+     * Uses the same `auto`, `always`, and `never` behavior as the global expansion setting.
+     *
+     * If unset, inherits the global expansion setting.
      *
-     * @default auto".
      * @schema JsFormatterConfiguration#expand
      */
     readonly expand?: Expand;
     /**
-     * The indent style applied to JavaScript (and its super languages) files.
+     * The indent style applied to JavaScript and languages that extend it. If unset, inherits the
+     * global indentation style.
      *
      * @schema JsFormatterConfiguration#indentStyle
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The size of the indentation applied to JavaScript (and its super languages) files. Default to 2.
+     * The indentation width applied to JavaScript and languages that extend it. If unset,
+     * inherits the global indentation width.
      *
-     * @default 2.
      * @schema JsFormatterConfiguration#indentWidth
      */
     readonly indentWidth?: number;
     /**
-     * The type of quotes used in JSX. Defaults to double.
+     * The type of quotes used in JSX. Defaults to `double`.
      *
-     * @default double.
+     * @default double`.
      * @schema JsFormatterConfiguration#jsxQuoteStyle
      */
     readonly jsxQuoteStyle?: QuoteStyle;
     /**
-     * The type of line ending applied to JavaScript (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+     * The line ending applied to JavaScript and languages that extend it. If unset, inherits the
+     * global line ending.
      *
      * @schema JsFormatterConfiguration#lineEnding
      */
     readonly lineEnding?: LineEnding;
     /**
-     * What's the max width of a line applied to JavaScript (and its super languages) files. Defaults to 80.
+     * The maximum line width applied to JavaScript and languages that extend it. If unset,
+     * inherits the global line width.
      *
-     * @default 80.
      * @schema JsFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * When breaking binary expressions into multiple lines, whether to break them before or after the binary operator. Defaults to "after".
+     * When breaking binary expressions into multiple lines, whether to break them before or after
+     * the binary operator. Defaults to `after`.
      *
-     * @default after".
+     * @default after`.
      * @schema JsFormatterConfiguration#operatorLinebreak
      */
     readonly operatorLinebreak?: OperatorLinebreak;
     /**
-     * When properties in objects are quoted. Defaults to asNeeded.
+     * Controls when object properties are quoted. Defaults to `asNeeded` in configuration
+     * (`as-needed` on the CLI).
      *
-     * @default asNeeded.
+     * @default asNeeded` in configuration
      * @schema JsFormatterConfiguration#quoteProperties
      */
     readonly quoteProperties?: QuoteProperties;
     /**
-     * The type of quotes used in JavaScript code. Defaults to double.
+     * The type of quotes used in JavaScript code. Defaults to `double`.
      *
-     * @default double.
+     * @default double`.
      * @schema JsFormatterConfiguration#quoteStyle
      */
     readonly quoteStyle?: QuoteStyle;
     /**
-     * Whether the formatter prints semicolons for all statements or only in for statements where it is necessary because of ASI.
+     * Prints semicolons after every statement or only where needed to avoid automatic semicolon
+     * insertion hazards. Defaults to `always`.
      *
+     * @default always`.
      * @schema JsFormatterConfiguration#semicolons
      */
     readonly semicolons?: Semicolons;
     /**
-     * Print trailing commas wherever possible in multi-line comma-separated syntactic structures. Defaults to "all".
+     * Prints trailing commas wherever possible in multiline comma-separated structures. Defaults
+     * to `all`.
      *
-     * @default all".
+     * @default all`.
      * @schema JsFormatterConfiguration#trailingCommas
      */
     readonly trailingCommas?: JsTrailingCommas;
     /**
-     * Whether to add a trailing newline at the end of the file.
+     * Whether to add a trailing newline at the end of the file. If unset, inherits the global
+     * trailing newline setting.
      *
-     * Setting this option to `false` is **highly discouraged** because it could cause many problems with other tools:
-     * - https://thoughtbot.com/blog/no-newline-at-end-of-file
-     * - https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804
-     * - https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files
-     *
-     * Disable the option at your own risk.
-     *
-     * Defaults to true.
-     *
-     * @default true.
      * @schema JsFormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
@@ -1481,7 +1457,7 @@ export declare enum JsxRuntime {
  */
 export interface JsLinterConfiguration {
     /**
-     * Control the linter for JavaScript (and its super languages) files.
+     * Controls the linter for JavaScript and languages that extend it.
      *
      * @schema JsLinterConfiguration#enabled
      */
@@ -1493,7 +1469,7 @@ export interface JsLinterConfiguration {
  */
 export declare function toJson_JsLinterConfiguration(obj: JsLinterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the JavaScript parser behaves
+ * Options that change how the JavaScript parser behaves.
  *
  * @schema JsParserConfiguration
  */
@@ -1507,9 +1483,8 @@ export interface JsParserConfiguration {
      */
     readonly gritMetavariables?: boolean;
     /**
-     * When enabled, files like `.js`/`.mjs`/`.cjs` may contain JSX syntax.
-     *
-     * Defaults to `true`.
+     * When enabled, files such as `.js`, `.mjs`, and `.cjs` may contain JSX syntax. Defaults to
+     * `true`.
      *
      * @default true`.
      * @schema JsParserConfiguration#jsxEverywhere
@@ -1558,8 +1533,9 @@ export interface JsResolverConfiguration {
      * - Biome only reads top-level `catalog` / `catalogs` mappings and scalar
      * string entries.
      *
-     * Default: `false`.
+     * Defaults to `false`.
      *
+     * @default false`.
      * @schema JsResolverConfiguration#experimentalPnpmCatalogs
      */
     readonly experimentalPnpmCatalogs?: boolean;
@@ -1576,7 +1552,7 @@ export declare function toJson_JsResolverConfiguration(obj: JsResolverConfigurat
  */
 export interface JsonAssistConfiguration {
     /**
-     * Control the assist for JSON (and its super languages) files.
+     * Controls assist actions for JSON and languages that extend it.
      *
      * @schema JsonAssistConfiguration#enabled
      */
@@ -1592,86 +1568,77 @@ export declare function toJson_JsonAssistConfiguration(obj: JsonAssistConfigurat
  */
 export interface JsonFormatterConfiguration {
     /**
-     * Whether to insert spaces around brackets in object literals. Defaults to true.
+     * Whether to insert spaces inside braces in object literals. If unset, inherits the global
+     * bracket spacing setting.
      *
-     * @default true.
      * @schema JsonFormatterConfiguration#bracketSpacing
      */
     readonly bracketSpacing?: boolean;
     /**
-     * Whether to insert spaces inside delimiters (after the opening delimiter and before the
-     * closing delimiter). Only applies when the content fits on a single line, and empty
-     * brackets are not affected. For JSON, affects square brackets (e.g., `[ 1, 2, 3 ]`).
-     * Defaults to false.
+     * Controls spaces inside JSON square brackets when their content fits on one line. When
+     * enabled, `[1, 2, 3]` becomes `[ 1, 2, 3 ]`. Empty brackets are unchanged.
+     *
+     * If unset, inherits the global delimiter spacing setting.
      *
-     * @default false.
      * @schema JsonFormatterConfiguration#delimiterSpacing
      */
     readonly delimiterSpacing?: boolean;
     /**
-     * Control the formatter for JSON (and its super languages) files.
+     * Controls the formatter for JSON and languages that extend it.
      *
      * @schema JsonFormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * Whether to expand arrays and objects on multiple lines.
-     * When set to `auto`, object literals are formatted on multiple lines if the first property has a newline,
-     * and array literals are formatted on a single line if it fits in the line.
-     * When set to `always`, these literals are formatted on multiple lines, regardless of length of the list.
-     * When set to `never`, these literals are formatted on a single line if it fits in the line.
-     * When formatting `package.json`, Biome will use `always` unless configured otherwise. Defaults to "auto".
+     * Uses the same `auto`, `always`, and `never` behavior as the global expansion setting.
+     *
+     * If unset, inherits the global expansion setting.
+     *
+     * When formatting `package.json`, Biome uses `always` unless configured otherwise.
      *
-     * @default auto".
      * @schema JsonFormatterConfiguration#expand
      */
     readonly expand?: Expand;
     /**
-     * The indent style applied to JSON (and its super languages) files.
+     * The indent style applied to JSON and languages that extend it. If unset, inherits the global
+     * indentation style.
      *
      * @schema JsonFormatterConfiguration#indentStyle
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The size of the indentation applied to JSON (and its super languages) files. Default to 2.
+     * The indentation width applied to JSON and languages that extend it. If unset, inherits the
+     * global indentation width.
      *
-     * @default 2.
      * @schema JsonFormatterConfiguration#indentWidth
      */
     readonly indentWidth?: number;
     /**
-     * The type of line ending applied to JSON (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+     * The line ending applied to JSON and languages that extend it. If unset, inherits the global
+     * line ending.
      *
      * @schema JsonFormatterConfiguration#lineEnding
      */
     readonly lineEnding?: LineEnding;
     /**
-     * What's the max width of a line applied to JSON (and its super languages) files. Defaults to 80.
+     * The maximum line width applied to JSON and languages that extend it. If unset, inherits the
+     * global line width.
      *
-     * @default 80.
      * @schema JsonFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * Print trailing commas wherever possible in multi-line comma-separated syntactic structures. Defaults to "none".
+     * Prints trailing commas wherever possible in multiline comma-separated structures. Defaults
+     * to `none`.
      *
-     * @default none".
+     * @default none`.
      * @schema JsonFormatterConfiguration#trailingCommas
      */
     readonly trailingCommas?: JsonTrailingCommas;
     /**
-     * Whether to add a trailing newline at the end of the file.
+     * Whether to add a trailing newline at the end of the file. If unset, inherits the global
+     * trailing newline setting.
      *
-     * Setting this option to `false` is **highly discouraged** because it could cause many problems with other tools:
-     * - https://thoughtbot.com/blog/no-newline-at-end-of-file
-     * - https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804
-     * - https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files
-     *
-     * Disable the option at your own risk.
-     *
-     * Defaults to true.
-     *
-     * @default true.
      * @schema JsonFormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
@@ -1688,7 +1655,7 @@ export declare function toJson_JsonFormatterConfiguration(obj: JsonFormatterConf
  */
 export interface JsonLinterConfiguration {
     /**
-     * Control the linter for JSON (and its super languages) files.
+     * Controls the linter for JSON and languages that extend it.
      *
      * @schema JsonLinterConfiguration#enabled
      */
@@ -1700,19 +1667,19 @@ export interface JsonLinterConfiguration {
  */
 export declare function toJson_JsonLinterConfiguration(obj: JsonLinterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options that changes how the JSON parser behaves
+ * Options that change how the JSON parser behaves.
  *
  * @schema JsonParserConfiguration
  */
 export interface JsonParserConfiguration {
     /**
-     * Allow parsing comments in `.json` files
+     * Allows parsing comments in `.json` files.
      *
      * @schema JsonParserConfiguration#allowComments
      */
     readonly allowComments?: boolean;
     /**
-     * Allow parsing trailing commas in `.json` files
+     * Allows parsing trailing commas in `.json` files.
      *
      * @schema JsonParserConfiguration#allowTrailingCommas
      */
@@ -1850,13 +1817,11 @@ export interface OverrideFormatterConfiguration {
      */
     readonly bracketSpacing?: boolean;
     /**
-     * Whether to insert spaces inside delimiters (after the opening delimiter and before the
-     * closing delimiter), such as parentheses, brackets, angle brackets, and template literal
-     * interpolations. Spaces are not added before the opening delimiter, and empty delimiters
-     * are not affected. Only applies when the content fits on a single line. The specific
-     * delimiters affected depend on the language. Defaults to false.
+     * Controls spaces immediately inside supported delimiters when their content fits on one line.
+     * It doesn't add spaces before opening delimiters or inside empty delimiters.
+     *
+     * The affected delimiters vary by language. If unset, uses the configured formatter setting.
      *
-     * @default false.
      * @schema OverrideFormatterConfiguration#delimiterSpacing
      */
     readonly delimiterSpacing?: boolean;
@@ -1865,14 +1830,19 @@ export interface OverrideFormatterConfiguration {
      */
     readonly enabled?: boolean;
     /**
-     * Whether to expand arrays and objects on multiple lines.
-     * When set to `auto`, object literals are formatted on multiple lines if the first property has a newline,
-     * and array literals are formatted on a single line if it fits in the line.
-     * When set to `always`, these literals are formatted on multiple lines, regardless of length of the list.
-     * When set to `never`, these literals are formatted on a single line if it fits in the line.
-     * When formatting `package.json`, Biome will use `always` unless configured otherwise. Defaults to "auto".
+     * Controls whether arrays and objects are formatted on one line or multiple lines.
+     *
+     * `auto` formats objects on multiple lines if the first property has a newline, and arrays on
+     * one line if they fit.
+     *
+     * `always` formats arrays and objects on multiple lines.
+     *
+     * `never` formats arrays and objects on one line if they fit.
+     *
+     * If unset, uses the configured formatter setting.
+     *
+     * When formatting `package.json`, Biome uses `always` unless configured otherwise.
      *
-     * @default auto".
      * @schema OverrideFormatterConfiguration#expand
      */
     readonly expand?: Expand;
@@ -1973,7 +1943,7 @@ export interface OverrideLinterConfiguration {
  */
 export declare function toJson_OverrideLinterConfiguration(obj: OverrideLinterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Integration with the git client as VCS
+ * Integration with Git as the version control client.
  *
  * @schema VcsClientKind
  */