projen 0.104.14 → 0.104.16

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

@@ -1,11 +1,13 @@
 /**
- * The configuration contained in `biome.json`.
+ * The configuration contained in `biome.json` or `biome.jsonc`.
  *
  * @schema BiomeConfiguration
  */
 export interface BiomeConfiguration {
     /**
-     * A field for the JSON schema specification: https://json-schema.org/
+     * The JSON Schema used to validate the configuration and provide editor completion. Biome
+     * emits a diagnostic when a `biomejs.dev` schema URL specifies a version that differs from the
+     * running CLI version.
      *
      * @schema BiomeConfiguration#$schema
      */
@@ -23,19 +25,24 @@ export interface BiomeConfiguration {
      */
     readonly css?: CssConfiguration;
     /**
-     * A list of paths to other JSON files, used to extend the current configuration.
+     * Extends the current configuration with settings from one or more other Biome configurations.
+     * Use `"//"` in a nested configuration to extend the root configuration at any nesting depth.
+     * Use an array to extend configurations by relative path or installed package specifier.
+     *
+     * Biome merges configurations from left to right. Later configurations take precedence for
+     * single-value options, list entries are combined, and the current file is applied last.
      *
      * @schema BiomeConfiguration#extends
      */
-    readonly extends?: string[];
+    readonly extends?: any;
     /**
-     * The file handling configuration.
+     * Configures which files Biome can discover and process.
      *
      * @schema BiomeConfiguration#files
      */
     readonly files?: FilesConfiguration;
     /**
-     * The formatter configuration.
+     * Configures formatting for selected files.
      *
      * @schema BiomeConfiguration#formatter
      */
@@ -77,30 +84,54 @@ export interface BiomeConfiguration {
      */
     readonly linter?: LinterConfiguration;
     /**
-     * A list of granular patterns applied only to a subset of files.
+     * Configuration specific to Markdown.
+     *
+     * @schema BiomeConfiguration#markdown
+     */
+    readonly markdown?: MarkdownConfiguration;
+    /**
+     * Configures settings for files selected by each override. When multiple overrides configure
+     * the same single-value setting, the last matching override takes precedence.
      *
      * @schema BiomeConfiguration#overrides
      */
     readonly overrides?: OverridePattern[];
     /**
-     * List of plugins to load.
+     * A list of GritQL plugins to load.
      *
      * @schema BiomeConfiguration#plugins
      */
     readonly plugins?: any[];
     /**
-     * Indicates whether this configuration file is at the root of a Biome
-     * project. By default, this is `true`.
+     * Marks whether this file is the root configuration for a Biome project. The root configuration
+     * establishes the project's base settings, while `false` marks a configuration found inside the
+     * project as nested rather than a second project root.
+     *
+     * Defaults to `true`. Biome implicitly treats `root` as `false` when a nested configuration uses
+     * `"extends": "//"`. All other nested configurations must explicitly set `root` to `false`.
      *
+     * @default true`. Biome implicitly treats `root` as `false` when a nested configuration uses
      * @schema BiomeConfiguration#root
      */
     readonly root?: boolean;
+    /**
+     * Configures how Biome recognizes Tailwind class strings.
+     *
+     * @schema BiomeConfiguration#tailwind
+     */
+    readonly tailwind?: TailwindConfiguration;
     /**
      * The version control integration configuration.
      *
      * @schema BiomeConfiguration#vcs
      */
     readonly vcs?: VcsConfiguration;
+    /**
+     * Configuration specific to YAML.
+     *
+     * @schema BiomeConfiguration#yaml
+     */
+    readonly yaml?: YamlConfiguration;
 }
 /**
  * Converts an object of type 'BiomeConfiguration' to JSON representation.
@@ -112,20 +143,22 @@ export declare function toJson_BiomeConfiguration(obj: BiomeConfiguration | unde
  */
 export interface AssistConfiguration {
     /**
-     * Whether Biome should fail in CLI if the assist were not applied to the code.
+     * The assist-action configuration.
      *
      * @schema AssistConfiguration#actions
      */
     readonly actions?: Actions;
     /**
-     * Whether Biome should enable assist via LSP and CLI.
+     * Enables configured assist actions in the CLI and editor integrations. Defaults to `true`.
      *
+     * @default true`.
      * @schema AssistConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * A list of glob patterns. Biome will include files/folders that will
-     * match these patterns.
+     * A list of glob patterns selecting files on which assist actions can run. If omitted, all files
+     * selected by `files.includes` remain eligible for assist actions. An empty list selects no
+     * files. This option can only narrow the files selected by `files.includes`.
      *
      * @schema AssistConfiguration#includes
      */
@@ -137,7 +170,10 @@ export interface AssistConfiguration {
  */
 export declare function toJson_AssistConfiguration(obj: AssistConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options applied to CSS files.
+ * Options applied to CSS and languages that extend it.
+ *
+ * Language-specific settings take precedence over corresponding global settings. Global settings
+ * apply when their language-specific counterparts are omitted, unless stated otherwise.
  *
  * @schema CssConfiguration
  */
@@ -155,7 +191,7 @@ export interface CssConfiguration {
      */
     readonly formatter?: CssFormatterConfiguration;
     /**
-     * CSS globals.
+     * Reserved for future CSS analyzer support. This option currently has no effect.
      *
      * @schema CssConfiguration#globals
      */
@@ -188,27 +224,38 @@ export interface FilesConfiguration {
      * **Deprecated:** Please use _force-ignore syntax_ in `files.includes`
      * instead: <https://biomejs.dev/reference/configuration/#filesincludes>
      *
-     * Set of file and folder names that should be unconditionally ignored by
-     * Biome's scanner.
+     * File or directory names that the scanner ignores unconditionally while crawling. Each value
+     * matches a complete path component, not a glob. Ignored files are not added to the module graph,
+     * so types are not inferred from them.
      *
      * @schema FilesConfiguration#experimentalScannerIgnores
      */
     readonly experimentalScannerIgnores?: string[];
     /**
-     * Prevents Biome from emitting diagnostics for unrecognized file types.
+     * Prevents Biome from emitting diagnostics for unrecognized file types. Defaults to `false`.
      *
+     * @default false`.
      * @schema FilesConfiguration#ignoreUnknown
      */
     readonly ignoreUnknown?: boolean;
     /**
-     * A list of glob patterns. Biome handles only files and directories that match these
-     * patterns.
+     * A list of glob patterns selecting which files and directories Biome can process. If omitted,
+     * this option does not further restrict the supported files Biome can process. An empty list
+     * selects no files. Biome ignores files under `node_modules` even when they match a pattern.
+     *
+     * The scanner uses these patterns and, when enabled, VCS ignore files while discovering nested
+     * configuration and ignore files. When enabled rules use the `project` or `types` domains, it
+     * also indexes source files and project dependencies. It may still discover required metadata or
+     * index excluded source files needed for analysis. A pattern beginning with `!!` prevents the
+     * scanner from indexing matching paths. Patterns are evaluated in order, and a pattern beginning
+     * with `!` excludes matches.
      *
      * @schema FilesConfiguration#includes
      */
     readonly includes?: string[];
     /**
-     * The maximum source file size in bytes. Biome ignores larger files. Defaults to `1 MiB`.
+     * The maximum source-file size in bytes. Biome skips larger files and emits a warning
+     * diagnostic. Defaults to `1 MiB`.
      *
      * @default 1 MiB`.
      * @schema FilesConfiguration#maxSize
@@ -221,7 +268,7 @@ export interface FilesConfiguration {
  */
 export declare function toJson_FilesConfiguration(obj: FilesConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Generic options applied to all files
+ * Configures formatting for selected files.
  *
  * @schema FormatterConfiguration
  */
@@ -234,15 +281,18 @@ export interface FormatterConfiguration {
      */
     readonly attributePosition?: AttributePosition;
     /**
-     * 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`.
+     * Controls the placement of the closing bracket for multiline HTML and JSX opening tags. Biome
+     * places the bracket at the end of the last attribute line when enabled and on its own line when
+     * disabled. This also affects self-closing HTML elements, but self-closing JSX elements are
+     * unaffected. Defaults to `false`.
      *
      * @default false`.
      * @schema FormatterConfiguration#bracketSameLine
      */
     readonly bracketSameLine?: boolean;
     /**
-     * Whether to insert spaces inside braces in object literals. Defaults to `true`.
+     * Controls spaces inside braces in supported single-line structures. The affected structures
+     * vary by language. Defaults to `true`.
      *
      * @default true`.
      * @schema FormatterConfiguration#bracketSpacing
@@ -259,6 +309,9 @@ export interface FormatterConfiguration {
      */
     readonly delimiterSpacing?: boolean;
     /**
+     * Enables or disables the formatter. Defaults to `true`.
+     *
+     * @default true`.
      * @schema FormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
@@ -288,8 +341,9 @@ export interface FormatterConfiguration {
      */
     readonly formatWithErrors?: boolean;
     /**
-     * A list of glob patterns. The formatter will include files/folders that will
-     * match these patterns.
+     * A list of glob patterns selecting files to format. If omitted, all files selected by
+     * `files.includes` remain eligible for formatting. An empty list selects no files. This option
+     * can only narrow the files selected by `files.includes`.
      *
      * @schema FormatterConfiguration#includes
      */
@@ -302,7 +356,10 @@ export interface FormatterConfiguration {
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The indentation width. Defaults to `2`.
+     * Sets the indentation width. With space indentation, this is the number of spaces emitted per
+     * indentation level. With tab indentation, Biome emits one tab per level and uses this value as
+     * the tab's display width when calculating line length. Accepted values are `0` through `24`.
+     * Defaults to `2`.
      *
      * @default 2`.
      * @schema FormatterConfiguration#indentWidth
@@ -316,23 +373,28 @@ export interface FormatterConfiguration {
      */
     readonly lineEnding?: LineEnding;
     /**
-     * The maximum line width. Defaults to `80`.
+     * Sets the preferred maximum line width used when deciding where to wrap code. Some content,
+     * such as long unbreakable strings, may still exceed this width. Accepted values are `1` through
+     * `320`. Defaults to `80`.
      *
      * @default 80`.
      * @schema FormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * Whether to add a trailing newline at the end of the file. Defaults to `true`; disabling
+     * 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`; disabling
+     * @default true`. Disabling
      * @schema FormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
     /**
-     * Uses `.editorconfig` files to configure the formatter. Settings in `biome.json` or
-     * `biome.jsonc` override `.editorconfig` settings. Defaults to `false`.
+     * Controls whether Biome loads formatter settings from an `.editorconfig` file. Biome reads
+     * `indent_style`, `indent_size`, `end_of_line`, and `insert_final_newline`. Settings in
+     * `biome.json` or `biome.jsonc` take precedence. Biome loads only one `.editorconfig`. Nested
+     * cascading configurations and the EditorConfig `root` property are not supported. Defaults to
+     * `false`.
      *
      * @default false`.
      * @schema FormatterConfiguration#useEditorconfig
@@ -347,6 +409,9 @@ export declare function toJson_FormatterConfiguration(obj: FormatterConfiguratio
 /**
  * Options applied to GraphQL files.
  *
+ * Language-specific settings take precedence over corresponding global settings. Global settings
+ * apply when their language-specific counterparts are omitted, unless stated otherwise.
+ *
  * @schema GraphqlConfiguration
  */
 export interface GraphqlConfiguration {
@@ -377,6 +442,9 @@ export declare function toJson_GraphqlConfiguration(obj: GraphqlConfiguration |
 /**
  * Options applied to GritQL files.
  *
+ * Language-specific settings take precedence over corresponding global settings. Global settings
+ * apply when their language-specific counterparts are omitted, unless stated otherwise.
+ *
  * @schema GritConfiguration
  */
 export interface GritConfiguration {
@@ -405,7 +473,13 @@ export interface GritConfiguration {
  */
 export declare function toJson_GritConfiguration(obj: GritConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options applied to HTML files.
+ * Options applied to HTML and languages that extend it.
+ *
+ * Full HTML support and the HTML formatter are experimental. Biome aims to minimize breaking
+ * changes, but bug fixes and new features may change formatting output or diagnostics.
+ *
+ * Language-specific settings take precedence over corresponding global settings. Global settings
+ * apply when their language-specific counterparts are omitted, unless stated otherwise.
  *
  * @schema HtmlConfiguration
  */
@@ -417,8 +491,17 @@ export interface HtmlConfiguration {
      */
     readonly assist?: HtmlAssistConfiguration;
     /**
-     * Enables full support for HTML, Vue, Svelte, and Astro files.
+     * Enables Biome's experimental full support for `.html`, `.vue`, `.svelte`, and `.astro` files.
+     * In this mode, Biome parses the complete document and can analyze or format its markup and
+     * supported embedded languages.
+     *
+     * When disabled, `.vue`, `.svelte`, and `.astro` files use legacy handling, which extracts their
+     * JavaScript or TypeScript portions and leaves the rest unchanged. This option selects how
+     * these files are processed. It does not enable the HTML formatter. Set
+     * `html.formatter.enabled` to `true` to format complete HTML, Vue, Svelte, and Astro files.
+     * Defaults to `false`.
      *
+     * @default false`.
      * @schema HtmlConfiguration#experimentalFullSupportEnabled
      */
     readonly experimentalFullSupportEnabled?: boolean;
@@ -447,57 +530,71 @@ export interface HtmlConfiguration {
  */
 export declare function toJson_HtmlConfiguration(obj: HtmlConfiguration | undefined): Record<string, any> | undefined;
 /**
- * A set of options applied to the JavaScript files
+ * Options applied to JavaScript, TypeScript, JSX, TSX, and supported languages that embed
+ * JavaScript.
+ *
+ * Language-specific settings take precedence over corresponding global settings. Global settings
+ * apply when their language-specific counterparts are omitted, unless stated otherwise.
  *
  * @schema JsConfiguration
  */
 export interface JsConfiguration {
     /**
-     * Assist options
+     * JavaScript assist options.
      *
      * @schema JsConfiguration#assist
      */
     readonly assist?: JsAssistConfiguration;
     /**
-     * Enables support for embedding snippets.
+     * Enables experimental parsing, formatting, linting, diagnostics, and fixes for CSS and
+     * GraphQL snippets embedded in JavaScript and TypeScript template literals.
+     *
+     * Biome recognizes CSS in `css` and `styled` templates and GraphQL in `gql` and `graphql`
+     * templates or calls. Templates containing interpolations are not currently supported.
+     * Defaults to `false`.
      *
+     * @default false`.
      * @schema JsConfiguration#experimentalEmbeddedSnippetsEnabled
      */
     readonly experimentalEmbeddedSnippetsEnabled?: boolean;
     /**
-     * Formatting options
+     * JavaScript formatter options.
      *
      * @schema JsConfiguration#formatter
      */
     readonly formatter?: JsFormatterConfiguration;
     /**
-     * A list of global bindings that should be ignored by the analyzers
+     * A list of additional names that Biome's JavaScript linter treats as predefined global
+     * bindings.
      *
-     * If defined here, they should not emit diagnostics.
+     * Use this for globals supplied by a runtime, framework, or external script that are not
+     * declared in the source file.
      *
      * @schema JsConfiguration#globals
      */
     readonly globals?: string[];
     /**
-     * Indicates the type of runtime or transformation used for interpreting JSX.
+     * Configures how the analyzer accounts for imports used by JSX. This option does not transform
+     * JSX or select a runtime for a build tool. Defaults to `transparent`.
      *
+     * @default transparent`.
      * @schema JsConfiguration#jsxRuntime
      */
     readonly jsxRuntime?: JsxRuntime;
     /**
-     * Linter options
+     * JavaScript linter options.
      *
      * @schema JsConfiguration#linter
      */
     readonly linter?: JsLinterConfiguration;
     /**
-     * Parsing options
+     * JavaScript parser options.
      *
      * @schema JsConfiguration#parser
      */
     readonly parser?: JsParserConfiguration;
     /**
-     * Module/dependency resolver options
+     * JavaScript module and dependency resolver options.
      *
      * @schema JsConfiguration#resolver
      */
@@ -509,7 +606,10 @@ export interface JsConfiguration {
  */
 export declare function toJson_JsConfiguration(obj: JsConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Options applied to JSON files
+ * Options applied to JSON, JSONC, and recognized JSON-based configuration files.
+ *
+ * Language-specific settings take precedence over corresponding global settings. Global settings
+ * apply when their language-specific counterparts are omitted, unless stated otherwise.
  *
  * @schema JsonConfiguration
  */
@@ -549,26 +649,31 @@ export declare function toJson_JsonConfiguration(obj: JsonConfiguration | undefi
  */
 export interface LinterConfiguration {
     /**
-     * An object where the keys are the names of the domains, and the values are `all`, `recommended`, or `none`.
+     * Configures rules associated with a framework, library, project-wide analysis, or type
+     * analysis. Keys are domain names and values are `all`, `recommended`, or `none`.
+     * Enabling rules from the `project` or `types` domains activates project and dependency
+     * scanning. The `types` domain also enables type-aware resolution.
      *
      * @schema LinterConfiguration#domains
      */
     readonly domains?: RuleDomains;
     /**
-     * if `false`, it disables the feature and the linter won't be executed. `true` by default
+     * Enables or disables the linter. Defaults to `true`.
      *
+     * @default true`.
      * @schema LinterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * A list of glob patterns. The analyzer will handle only those files/folders that will
-     * match these patterns.
+     * A list of glob patterns selecting files to lint. If omitted, all files selected by
+     * `files.includes` remain eligible for linting. An empty list selects no files. This option can
+     * only narrow the files selected by `files.includes`.
      *
      * @schema LinterConfiguration#includes
      */
     readonly includes?: string[];
     /**
-     * List of rules
+     * The lint-rule configuration.
      *
      * @schema LinterConfiguration#rules
      */
@@ -579,83 +684,133 @@ export interface LinterConfiguration {
  * @internal
  */
 export declare function toJson_LinterConfiguration(obj: LinterConfiguration | undefined): Record<string, any> | undefined;
+/**
+ * Options applied to Markdown files
+ *
+ * @schema MarkdownConfiguration
+ */
+export interface MarkdownConfiguration {
+    /**
+     * Runs the linter and assist actions on the code inside fenced code blocks, frontmatter, and
+     * HTML blocks, with the rules and actions of the code's language. Defaults to `false`.
+     *
+     * @default false`.
+     * @schema MarkdownConfiguration#analyzeEmbeds
+     */
+    readonly analyzeEmbeds?: boolean;
+    /**
+     * Formatter options
+     *
+     * @schema MarkdownConfiguration#formatter
+     */
+    readonly formatter?: MarkdownFormatterConfiguration;
+    /**
+     * Linter options
+     *
+     * @schema MarkdownConfiguration#linter
+     */
+    readonly linter?: MarkdownLinterConfiguration;
+    /**
+     * Parsing options
+     *
+     * @schema MarkdownConfiguration#parser
+     */
+    readonly parser?: MarkdownParserConfiguration;
+}
+/**
+ * Converts an object of type 'MarkdownConfiguration' to JSON representation.
+ * @internal
+ */
+export declare function toJson_MarkdownConfiguration(obj: MarkdownConfiguration | undefined): Record<string, any> | undefined;
 /**
  * @schema OverridePattern
  */
 export interface OverridePattern {
     /**
-     * Specific configuration for the Json language
+     * Assist settings for matched files.
      *
      * @schema OverridePattern#assist
      */
     readonly assist?: OverrideAssistConfiguration;
     /**
-     * Specific configuration for the CSS language
+     * CSS-specific settings for matched files.
      *
      * @schema OverridePattern#css
      */
     readonly css?: CssConfiguration;
     /**
-     * Specific configuration for the filesystem
+     * File-handling settings for matched files.
      *
      * @schema OverridePattern#files
      */
     readonly files?: OverrideFilesConfiguration;
     /**
-     * Specific configuration for the Json language
+     * Formatter settings for matched files.
      *
      * @schema OverridePattern#formatter
      */
     readonly formatter?: OverrideFormatterConfiguration;
     /**
-     * Specific configuration for the Graphql language
+     * GraphQL-specific settings for matched files.
      *
      * @schema OverridePattern#graphql
      */
     readonly graphql?: GraphqlConfiguration;
     /**
-     * Specific configuration for the GritQL language
+     * GritQL-specific settings for matched files.
      *
      * @schema OverridePattern#grit
      */
     readonly grit?: GritConfiguration;
     /**
-     * Specific configuration for the GritQL language
+     * HTML-specific settings for matched files.
      *
      * @schema OverridePattern#html
      */
     readonly html?: HtmlConfiguration;
     /**
-     * A list of glob patterns. Biome will include files/folders that will
-     * match these patterns.
+     * A list of glob patterns selecting the files to which this override applies. If omitted, the
+     * override applies to every file. An empty list applies to no files.
      *
      * @schema OverridePattern#includes
      */
     readonly includes?: string[];
     /**
-     * Specific configuration for the JavaScript language
+     * JavaScript-specific settings for matched files.
      *
      * @schema OverridePattern#javascript
      */
     readonly javascript?: JsConfiguration;
     /**
-     * Specific configuration for the Json language
+     * JSON-specific settings for matched files.
      *
      * @schema OverridePattern#json
      */
     readonly json?: JsonConfiguration;
     /**
-     * Specific configuration for the Json language
+     * Linter settings for matched files.
      *
      * @schema OverridePattern#linter
      */
     readonly linter?: OverrideLinterConfiguration;
     /**
-     * Specific configuration for additional plugins
+     * Specific configuration for the Markdown language
+     *
+     * @schema OverridePattern#markdown
+     */
+    readonly markdown?: MarkdownConfiguration;
+    /**
+     * Additional plugins for matched files.
      *
      * @schema OverridePattern#plugins
      */
     readonly plugins?: any[];
+    /**
+     * Specific configuration for the YAML language
+     *
+     * @schema OverridePattern#yaml
+     */
+    readonly yaml?: YamlConfiguration;
 }
 /**
  * Converts an object of type 'OverridePattern' to JSON representation.
@@ -663,31 +818,126 @@ export interface OverridePattern {
  */
 export declare function toJson_OverridePattern(obj: OverridePattern | undefined): Record<string, any> | undefined;
 /**
- * Settings for integrating Biome with version control.
+ * Tells Biome where your code lists Tailwind CSS classes, so the Tailwind
+ * lint rules know which strings to check.
+ *
+ * @schema TailwindConfiguration
+ */
+export interface TailwindConfiguration {
+    /**
+     * Attributes whose values are Tailwind classes, such as `class` in
+     * `<div class="px-2 py-2">`.
+     *
+     * Defaults to `class` and `className`. In HTML, they are case-insensitive.
+     *
+     * @default class` and `className`. In HTML, they are case-insensitive.
+     * @schema TailwindConfiguration#attributes
+     */
+    readonly attributes?: string[];
+    /**
+     * Functions that combine Tailwind classes, such as `clsx` and `cn`.
+     *
+     * Biome checks every string passed to these functions, like both strings
+     * in `cn("px-2", "py-2")`. When an object is passed, Biome checks its
+     * keys: in `cn({ "px-2": isActive })`, it checks `"px-2"`.
+     *
+     * Properties of these functions are checked too, so listing `tw` also
+     * covers `` tw.div`px-2` `` and `tw.div("px-2")`.
+     *
+     * Defaults to `clsx`, `tw`, `twMerge`, `twJoin`, `cn`, `cc`, `cnb`, and
+     * `ctl`.
+     *
+     * @default clsx`, `tw`, `twMerge`, `twJoin`, `cn`, `cc`, `cnb`, and
+     * @schema TailwindConfiguration#mergeFunctions
+     */
+    readonly mergeFunctions?: string[];
+    /**
+     * The CSS file that holds your Tailwind CSS configuration, such as
+     * `"./src/app.css"`. A relative path starts from the folder of the Biome
+     * configuration file.
+     *
+     * Biome reads the `@theme`, `@utility`, and `@custom-variant` rules in
+     * this file and in the files it imports with `@import`, so that the
+     * Tailwind rules know your theme values, utilities, and variants.
+     *
+     * To read the file, Biome scans your project when a Tailwind rule is
+     * enabled. Setting this option also turns on `css.parser.tailwindDirectives`,
+     * unless you set that option yourself.
+     *
+     * @schema TailwindConfiguration#stylesheet
+     */
+    readonly stylesheet?: string;
+    /**
+     * Functions that describe a component's styles with an object, such as
+     * `cva` and `tv`.
+     *
+     * Biome checks every string passed directly to these functions. In an
+     * object passed to them, Biome checks the classes under these properties:
+     *
+     * - `base`, `class`, and `className`: classes that always apply.
+     * - `variants`: classes for each version of the component, such as each
+     * button size.
+     * - `slots`: classes for each part of the component, such as its icon.
+     * - `compoundVariants` and `compoundSlots`: only the `class` and
+     * `className` of each entry.
+     *
+     * Other properties, such as `defaultVariants`, hold names rather than
+     * classes, so Biome skips them. For example, Biome checks `"rounded"`,
+     * `"px-2"`, and `"px-4"` here, but not `"small"`:
+     *
+     * ```js
+     * cva("rounded", {
+     * variants: {
+     * size: { small: "px-2", large: "px-4" },
+     * },
+     * defaultVariants: { size: "small" },
+     * });
+     * ```
+     *
+     * Defaults to `cva` and `tv`.
+     *
+     * @default cva` and `tv`.
+     * @schema TailwindConfiguration#variantFunctions
+     */
+    readonly variantFunctions?: string[];
+}
+/**
+ * Converts an object of type 'TailwindConfiguration' to JSON representation.
+ * @internal
+ */
+export declare function toJson_TailwindConfiguration(obj: TailwindConfiguration | undefined): Record<string, any> | undefined;
+/**
+ * Configures how Biome integrates with a version control system.
  *
  * @schema VcsConfiguration
  */
 export interface VcsConfiguration {
     /**
-     * The version control client.
+     * Selects the version-control client. Currently, only `git` is supported.
      *
      * @schema VcsConfiguration#clientKind
      */
     readonly clientKind?: VcsClientKind;
     /**
-     * The project's default branch.
+     * Sets the base branch used by `--changed` when `--since` is not provided. If neither this option
+     * nor `--since` is set, commands using `--changed` fail because Biome cannot determine the
+     * comparison base.
      *
      * @schema VcsConfiguration#defaultBranch
      */
     readonly defaultBranch?: string;
     /**
-     * Whether Biome should integrate with the version control client.
+     * Enables or disables version-control integration. Defaults to `false`. Enabling integration
+     * requires `vcs.clientKind` to be set.
      *
+     * @default false`. Enabling integration
      * @schema VcsConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * Sets the directory where Biome checks for version control files.
+     * Sets the directory where Biome looks for version-control files. A relative value is resolved
+     * from the directory containing the current configuration file, while an absolute path is used
+     * directly.
      *
      * Defaults to the directory containing `biome.json` or `biome.jsonc`. If no configuration is
      * found, Biome uses the current working directory.
@@ -700,9 +950,12 @@ export interface VcsConfiguration {
      */
     readonly root?: string;
     /**
-     * When `true`, Biome ignores files listed in `.gitignore`, `.ignore`, and Git's local
-     * exclude file.
+     * Controls whether Biome applies patterns from `.gitignore`, Git's local `.git/info/exclude`,
+     * and supported `.ignore` files, including nested ignore files. Patterns in the root ignore file
+     * are resolved from `vcs.root`. Patterns in nested ignore files are resolved from the directory
+     * containing that file. Defaults to `false`.
      *
+     * @default false`.
      * @schema VcsConfiguration#useIgnoreFile
      */
     readonly useIgnoreFile?: boolean;
@@ -712,23 +965,53 @@ export interface VcsConfiguration {
  * @internal
  */
 export declare function toJson_VcsConfiguration(obj: VcsConfiguration | undefined): Record<string, any> | undefined;
+/**
+ * Options applied to Yaml files
+ *
+ * @schema YamlConfiguration
+ */
+export interface YamlConfiguration {
+    /**
+     * Formatter options
+     *
+     * @schema YamlConfiguration#formatter
+     */
+    readonly formatter?: YamlFormatterConfiguration;
+    /**
+     * @schema YamlConfiguration#linter
+     */
+    readonly linter?: YamlLinterConfiguration;
+}
+/**
+ * Converts an object of type 'YamlConfiguration' to JSON representation.
+ * @internal
+ */
+export declare function toJson_YamlConfiguration(obj: YamlConfiguration | undefined): Record<string, any> | undefined;
 /**
  * @schema Actions
  */
 export interface Actions {
     /**
-     * The actions preset to use.
+     * Selects the baseline set of assist actions. `recommended` enables Biome's
+     * recommended actions, `all` enables all actions, and `none` starts with no actions
+     * enabled. Group presets and explicit action settings override this preset.
+     * Defaults to `recommended`.
      *
+     * @default recommended`.
      * @schema Actions#preset
      */
     readonly preset?: PresetConfig;
     /**
-     * It enables the assist actions recommended by Biome. `true` by default.
+     * Enables or disables Biome's recommended assist actions across all action groups.
+     * Defaults to `true`.
      *
+     * @default true`.
      * @schema Actions#recommended
      */
     readonly recommended?: boolean;
     /**
+     * Configures source-level actions such as organizing imports and sorting declarations. These actions are exposed through editor source actions and through CLI checking and application.
+     *
      * @schema Actions#source
      */
     readonly source?: Source;
@@ -745,7 +1028,7 @@ export declare function toJson_Actions(obj: Actions | undefined): Record<string,
  */
 export interface CssAssistConfiguration {
     /**
-     * Controls assist actions for CSS files.
+     * Enables or disables assist actions for CSS.
      *
      * @schema CssAssistConfiguration#enabled
      */
@@ -773,7 +1056,7 @@ export interface CssFormatterConfiguration {
      */
     readonly delimiterSpacing?: boolean;
     /**
-     * Controls the formatter for CSS and languages that extend it.
+     * Enables or disables the formatter for CSS and languages that extend it.
      *
      * @schema CssFormatterConfiguration#enabled
      */
@@ -800,14 +1083,16 @@ export interface CssFormatterConfiguration {
      */
     readonly lineEnding?: LineEnding;
     /**
-     * The maximum line width for CSS and languages that extend it. If unset, inherits the global
-     * line width.
+     * The preferred maximum line width for CSS and languages that extend it. If unset, inherits
+     * the global line width.
      *
      * @schema CssFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * The type of quotes used in CSS code. Defaults to `double`.
+     * Selects the preferred quote style for CSS strings. Biome may use the alternate quote when
+     * that avoids additional escaping. Quotes in `@charset` rules are currently preserved.
+     * Defaults to `double`.
      *
      * @default double`.
      * @schema CssFormatterConfiguration#quoteStyle
@@ -833,7 +1118,7 @@ export declare function toJson_CssFormatterConfiguration(obj: CssFormatterConfig
  */
 export interface CssLinterConfiguration {
     /**
-     * Controls the linter for CSS files.
+     * Enables or disables the linter for CSS.
      *
      * @schema CssLinterConfiguration#enabled
      */
@@ -851,21 +1136,28 @@ export declare function toJson_CssLinterConfiguration(obj: CssLinterConfiguratio
  */
 export interface CssParserConfiguration {
     /**
-     * Allows comments to appear on incorrect lines in `.css` files.
+     * Enables `//` line comments in plain CSS. Standard CSS treats `//` as delimiter characters
+     * rather than as a comment, and SCSS accepts `//` comments independently of this option.
+     * Defaults to `false`.
      *
+     * @default false`.
      * @schema CssParserConfiguration#allowWrongLineComments
      */
     readonly allowWrongLineComments?: boolean;
     /**
-     * Enables parsing of CSS Modules-specific features. Enable this feature only
-     * when your files don't end in `.module.css`.
+     * Enables CSS Modules-specific syntax such as `:local`, `:global`, `composes`, and `@value`.
+     * When unset, Biome enables this syntax automatically for files whose names end in
+     * `.module.css` or `.module.scss; otherwise, it defaults to `false`. Enable it explicitly when CSS Module files
+     * use another naming convention.
      *
      * @schema CssParserConfiguration#cssModules
      */
     readonly cssModules?: boolean;
     /**
-     * Enables parsing of Tailwind CSS 4.0 directives and functions.
+     * Enables parsing Tailwind CSS 4.0 directives and functions, including `@theme`, `@utility`,
+     * `@variant`, `@source`, and `@apply`. Defaults to `false`.
      *
+     * @default false`.
      * @schema CssParserConfiguration#tailwindDirectives
      */
     readonly tailwindDirectives?: boolean;
@@ -876,12 +1168,14 @@ export interface CssParserConfiguration {
  */
 export declare function toJson_CssParserConfiguration(obj: CssParserConfiguration | undefined): Record<string, any> | undefined;
 /**
+ * Controls attribute placement in HTML-like languages.
+ *
  * @schema AttributePosition
  */
 export declare enum AttributePosition {
-    /** auto */
+    /** Places attributes automatically and wraps them when needed. (auto) */
     AUTO = "auto",
-    /** multiline */
+    /** Places each attribute on its own line when an element has multiple attributes. (multiline) */
     MULTILINE = "multiline"
 }
 /**
@@ -900,9 +1194,9 @@ export declare enum Expand {
  * @schema IndentStyle
  */
 export declare enum IndentStyle {
-    /** Indent with Tab (tab) */
+    /** Uses tabs for indentation. (tab) */
     TAB = "tab",
-    /** Indent with Space (space) */
+    /** Uses spaces for indentation. (space) */
     SPACE = "space"
 }
 /**
@@ -925,8 +1219,9 @@ export declare enum LineEnding {
  */
 export interface GraphqlAssistConfiguration {
     /**
-     * Controls assist actions for GraphQL files.
+     * Enables or disables assist actions for GraphQL. Defaults to `false`.
      *
+     * @default false`.
      * @schema GraphqlAssistConfiguration#enabled
      */
     readonly enabled?: boolean;
@@ -943,14 +1238,15 @@ export declare function toJson_GraphqlAssistConfiguration(obj: GraphqlAssistConf
  */
 export interface GraphqlFormatterConfiguration {
     /**
-     * Whether to insert spaces inside braces in object literals. If unset, inherits the global
-     * bracket spacing setting.
+     * Controls spaces inside the braces of single-line GraphQL object values. Biome formats
+     * `{name: "Biome"}` when disabled and `{ name: "Biome" }` when enabled. If unset, inherits the
+     * global bracket spacing setting.
      *
      * @schema GraphqlFormatterConfiguration#bracketSpacing
      */
     readonly bracketSpacing?: boolean;
     /**
-     * Controls the formatter for GraphQL files.
+     * Enables or disables the formatter for GraphQL.
      *
      * @schema GraphqlFormatterConfiguration#enabled
      */
@@ -975,15 +1271,16 @@ export interface GraphqlFormatterConfiguration {
      */
     readonly lineEnding?: LineEnding;
     /**
-     * The maximum line width for GraphQL files. If unset, inherits the global line width.
+     * The preferred maximum line width for GraphQL files. If unset, inherits the global line
+     * width.
      *
      * @schema GraphqlFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * The type of quotes used in GraphQL code. Defaults to `double`.
+     * Reserved for future formatter support. The current formatter preserves standard
+     * double-quoted GraphQL strings and does not use this setting.
      *
-     * @default double`.
      * @schema GraphqlFormatterConfiguration#quoteStyle
      */
     readonly quoteStyle?: QuoteStyle;
@@ -1007,7 +1304,7 @@ export declare function toJson_GraphqlFormatterConfiguration(obj: GraphqlFormatt
  */
 export interface GraphqlLinterConfiguration {
     /**
-     * Controls the linter for GraphQL files.
+     * Enables or disables the linter for GraphQL.
      *
      * @schema GraphqlLinterConfiguration#enabled
      */
@@ -1025,7 +1322,7 @@ export declare function toJson_GraphqlLinterConfiguration(obj: GraphqlLinterConf
  */
 export interface GritAssistConfiguration {
     /**
-     * Controls assist actions for GritQL files.
+     * Enables or disables assist actions for GritQL.
      *
      * @schema GritAssistConfiguration#enabled
      */
@@ -1043,7 +1340,7 @@ export declare function toJson_GritAssistConfiguration(obj: GritAssistConfigurat
  */
 export interface GritFormatterConfiguration {
     /**
-     * Controls the formatter for GritQL files.
+     * Enables or disables the formatter for GritQL.
      *
      * @schema GritFormatterConfiguration#enabled
      */
@@ -1068,7 +1365,7 @@ export interface GritFormatterConfiguration {
      */
     readonly lineEnding?: LineEnding;
     /**
-     * The maximum line width for GritQL files. If unset, inherits the global line width.
+     * The preferred maximum line width for GritQL files. If unset, inherits the global line width.
      *
      * @schema GritFormatterConfiguration#lineWidth
      */
@@ -1093,7 +1390,7 @@ export declare function toJson_GritFormatterConfiguration(obj: GritFormatterConf
  */
 export interface GritLinterConfiguration {
     /**
-     * Controls the linter for GritQL files.
+     * Enables or disables the linter for GritQL.
      *
      * @schema GritLinterConfiguration#enabled
      */
@@ -1111,7 +1408,7 @@ export declare function toJson_GritLinterConfiguration(obj: GritLinterConfigurat
  */
 export interface HtmlAssistConfiguration {
     /**
-     * Controls assist actions for HTML and languages that extend it.
+     * Enables or disables assist actions for HTML and languages that extend it.
      *
      * @schema HtmlAssistConfiguration#enabled
      */
@@ -1136,21 +1433,25 @@ export interface HtmlFormatterConfiguration {
      */
     readonly attributePosition?: AttributePosition;
     /**
-     * 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.
+     * Controls the placement of the closing bracket for multiline HTML opening tags. Biome places
+     * the bracket at the end of the last attribute line when enabled and on its own line after the
+     * last attribute when disabled. This option also affects self-closing HTML elements. If unset,
+     * inherits the global `bracketSameLine` setting.
      *
      * @schema HtmlFormatterConfiguration#bracketSameLine
      */
     readonly bracketSameLine?: boolean;
     /**
-     * Controls the formatter for HTML and languages that extend it.
+     * Enables or disables the formatter for HTML and languages that extend it. The formatter is
+     * experimental and disabled by default. Formatting complete HTML, Vue, Svelte, and Astro files
+     * requires `html.experimentalFullSupportEnabled` to be `true`.
      *
      * @schema HtmlFormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * Whether to indent `<script>` and `<style>` tags in HTML and languages that extend it.
-     * Defaults to `false`.
+     * Controls whether the content of `<script>` and `<style>` tags is indented by one level in
+     * HTML, Vue, Svelte, and Astro files. Defaults to `false`.
      *
      * @default false`.
      * @schema HtmlFormatterConfiguration#indentScriptAndStyle
@@ -1178,8 +1479,8 @@ export interface HtmlFormatterConfiguration {
      */
     readonly lineEnding?: LineEnding;
     /**
-     * The maximum line width for HTML and languages that extend it. If unset, inherits the global
-     * line width.
+     * The preferred maximum line width for HTML and languages that extend it. If unset, inherits
+     * the global line width.
      *
      * @schema HtmlFormatterConfiguration#lineWidth
      */
@@ -1200,8 +1501,9 @@ export interface HtmlFormatterConfiguration {
      */
     readonly trailingNewline?: boolean;
     /**
-     * Whether to account for whitespace sensitivity when formatting HTML and languages that
-     * extend it. Defaults to `css`.
+     * Controls how the formatter treats whitespace around text and child elements in HTML, Vue,
+     * Svelte, and Astro markup. The `ignore` setting should be used only when whitespace cannot
+     * affect rendered output. Defaults to `css`.
      *
      * @default css`.
      * @schema HtmlFormatterConfiguration#whitespaceSensitivity
@@ -1220,7 +1522,7 @@ export declare function toJson_HtmlFormatterConfiguration(obj: HtmlFormatterConf
  */
 export interface HtmlLinterConfiguration {
     /**
-     * Controls the linter for HTML and languages that extend it.
+     * Enables or disables the linter for HTML and languages that extend it.
      *
      * @schema HtmlLinterConfiguration#enabled
      */
@@ -1238,8 +1540,10 @@ export declare function toJson_HtmlLinterConfiguration(obj: HtmlLinterConfigurat
  */
 export interface HtmlParserConfiguration {
     /**
-     * Enables parsing double text expressions such as `{{ expression }}` inside `.html` files.
+     * Enables double-curly interpolation expressions such as `{{ expression }}` in `.html` files.
+     * Defaults to `false`.
      *
+     * @default false`.
      * @schema HtmlParserConfiguration#interpolation
      */
     readonly interpolation?: boolean;
@@ -1249,8 +1553,9 @@ export interface HtmlParserConfiguration {
      *
      * 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`,
-     * or `.astro` files are parsed.
+     * or `.astro` files are parsed. Defaults to `false`.
      *
+     * @default false`.
      * @schema HtmlParserConfiguration#vue
      */
     readonly vue?: boolean;
@@ -1267,7 +1572,7 @@ export declare function toJson_HtmlParserConfiguration(obj: HtmlParserConfigurat
  */
 export interface JsAssistConfiguration {
     /**
-     * Controls assist actions for JavaScript and languages that extend it.
+     * Enables or disables assist actions for JavaScript and languages that extend it.
      *
      * @schema JsAssistConfiguration#enabled
      */
@@ -1279,13 +1584,15 @@ export interface JsAssistConfiguration {
  */
 export declare function toJson_JsAssistConfiguration(obj: JsAssistConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Formatting options specific to the JavaScript files
+ * Formatting options specific to JavaScript and languages that extend it.
  *
  * @schema JsFormatterConfiguration
  */
 export interface JsFormatterConfiguration {
     /**
-     * Whether to add parentheses around arrow function parameters. Defaults to `always`.
+     * Controls parentheses around arrow-function parameters. `always` always prints parentheses,
+     * while `asNeeded` omits them when an arrow function has one parameter and the syntax permits
+     * it. Defaults to `always`.
      *
      * @default always`.
      * @schema JsFormatterConfiguration#arrowParentheses
@@ -1299,28 +1606,31 @@ export interface JsFormatterConfiguration {
      */
     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. If unset, inherits the global bracket
-     * placement setting.
+     * Controls the placement of the closing bracket for multiline JSX opening tags. Biome places
+     * the bracket at the end of the last attribute line when enabled and on its own line after the
+     * last attribute when disabled. Self-closing JSX elements are unaffected. If unset, inherits
+     * the global bracket placement setting.
      *
      * @schema JsFormatterConfiguration#bracketSameLine
      */
     readonly bracketSameLine?: boolean;
     /**
-     * Whether to insert spaces inside braces in object literals. If unset, inherits the global
-     * bracket spacing setting.
+     * Controls spaces inside the braces of single-line object literals. Biome formats `{value: 1}`
+     * when disabled and `{ value: 1 }` when enabled. If unset, inherits the global bracket spacing
+     * setting.
      *
      * @schema JsFormatterConfiguration#bracketSpacing
      */
     readonly bracketSpacing?: boolean;
     /**
      * 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.
+     * content fits on one line. This affects parentheses, square brackets, template
+     * interpolations, TypeScript angle brackets, and JSX expression braces. Empty delimiters are
+     * unchanged.
      *
-     * 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.
+     * It also controls spacing after logical NOT operators. In a chain of logical NOT operators,
+     * only the final operator receives a following space. Biome doesn't add spaces before opening
+     * delimiters.
      *
      * If unset, inherits the global delimiter spacing setting.
      *
@@ -1328,7 +1638,7 @@ export interface JsFormatterConfiguration {
      */
     readonly delimiterSpacing?: boolean;
     /**
-     * Controls the formatter for JavaScript and languages that extend it.
+     * Enables or disables the formatter for JavaScript and languages that extend it.
      *
      * @schema JsFormatterConfiguration#enabled
      */
@@ -1356,7 +1666,7 @@ export interface JsFormatterConfiguration {
      */
     readonly indentWidth?: number;
     /**
-     * The type of quotes used in JSX. Defaults to `double`.
+     * Selects the preferred quote style for JSX attribute values. Defaults to `double`.
      *
      * @default double`.
      * @schema JsFormatterConfiguration#jsxQuoteStyle
@@ -1370,8 +1680,8 @@ export interface JsFormatterConfiguration {
      */
     readonly lineEnding?: LineEnding;
     /**
-     * The maximum line width applied to JavaScript and languages that extend it. If unset,
-     * inherits the global line width.
+     * The preferred maximum line width applied to JavaScript and languages that extend it. If
+     * unset, inherits the global line width.
      *
      * @schema JsFormatterConfiguration#lineWidth
      */
@@ -1385,7 +1695,9 @@ export interface JsFormatterConfiguration {
      */
     readonly operatorLinebreak?: OperatorLinebreak;
     /**
-     * Controls when object properties are quoted. Defaults to `asNeeded` in configuration
+     * Controls whether quotes around object property names are preserved. `asNeeded` removes
+     * quotes when the property name is valid without them, while `preserve` keeps quotes around
+     * property names that were quoted in the input. Defaults to `asNeeded` in configuration
      * (`as-needed` on the CLI).
      *
      * @default asNeeded` in configuration
@@ -1393,7 +1705,8 @@ export interface JsFormatterConfiguration {
      */
     readonly quoteProperties?: QuoteProperties;
     /**
-     * The type of quotes used in JavaScript code. Defaults to `double`.
+     * Selects the preferred quote style for JavaScript and TypeScript string literals. Biome may
+     * use the alternate quote when that avoids additional escaping. Defaults to `double`.
      *
      * @default double`.
      * @schema JsFormatterConfiguration#quoteStyle
@@ -1408,8 +1721,11 @@ export interface JsFormatterConfiguration {
      */
     readonly semicolons?: Semicolons;
     /**
-     * Prints trailing commas wherever possible in multiline comma-separated structures. Defaults
-     * to `all`.
+     * Controls trailing commas in multiline comma-separated structures. `all` adds trailing commas
+     * wherever syntax permits, including function parameters and calls. `es5` adds them only in
+     * constructs supported by ES5, such as array and object literals, and excludes function
+     * parameters, function calls, and TypeScript type parameters. `none` removes trailing commas.
+     * Defaults to `all`.
      *
      * @default all`.
      * @schema JsFormatterConfiguration#trailingCommas
@@ -1429,15 +1745,15 @@ export interface JsFormatterConfiguration {
  */
 export declare function toJson_JsFormatterConfiguration(obj: JsFormatterConfiguration | undefined): Record<string, any> | undefined;
 /**
- * Indicates the type of runtime or transformation used for interpreting JSX.
+ * How Biome's analyzer accounts for imports used by JSX.
  *
  * @schema JsxRuntime
  */
 export declare enum JsxRuntime {
-    /** Indicates a modern or native JSX environment, that doesn't require
-  special handling by Biome. (transparent) */
+    /** An automatic or native JSX environment that doesn't require an in-scope factory import. (transparent) */
     TRANSPARENT = "transparent",
-    /** Indicates a classic React environment that requires the `React` import.
+    /** A classic React environment that requires the React import, or custom JSX factory imports
+  configured in `tsconfig.json`.
   
   Corresponds to the `react` value for the `jsx` option in TypeScript's
   `tsconfig.json`.
@@ -1455,7 +1771,7 @@ export declare enum JsxRuntime {
  */
 export interface JsLinterConfiguration {
     /**
-     * Controls the linter for JavaScript and languages that extend it.
+     * Enables or disables the linter for JavaScript and languages that extend it.
      *
      * @schema JsLinterConfiguration#enabled
      */
@@ -1473,26 +1789,18 @@ export declare function toJson_JsLinterConfiguration(obj: JsLinterConfiguration
  */
 export interface JsParserConfiguration {
     /**
-     * Enables parsing of Grit metavariables.
-     * Defaults to `false`.
-     *
-     * @default false`.
-     * @schema JsParserConfiguration#gritMetavariables
-     */
-    readonly gritMetavariables?: boolean;
-    /**
-     * When enabled, files such as `.js`, `.mjs`, and `.cjs` may contain JSX syntax. Defaults to
-     * `true`.
+     * Controls whether `.js`, `.mjs`, and `.cjs` files may contain JSX syntax. Disabling this
+     * option causes JSX in those files to raise a diagnostic. Defaults to `true`.
      *
      * @default true`.
      * @schema JsParserConfiguration#jsxEverywhere
      */
     readonly jsxEverywhere?: boolean;
     /**
-     * It enables the experimental and unsafe parsing of parameter decorators
-     *
-     * These decorators belong to an old proposal, and they are subject to change.
+     * Enables parsing decorators on class parameters. This syntax belongs to an old experimental
+     * proposal and may change. Defaults to `false`.
      *
+     * @default false`.
      * @schema JsParserConfiguration#unsafeParameterDecoratorsEnabled
      */
     readonly unsafeParameterDecoratorsEnabled?: boolean;
@@ -1550,7 +1858,7 @@ export declare function toJson_JsResolverConfiguration(obj: JsResolverConfigurat
  */
 export interface JsonAssistConfiguration {
     /**
-     * Controls assist actions for JSON and languages that extend it.
+     * Enables or disables assist actions for JSON and languages that extend it.
      *
      * @schema JsonAssistConfiguration#enabled
      */
@@ -1582,7 +1890,7 @@ export interface JsonFormatterConfiguration {
      */
     readonly delimiterSpacing?: boolean;
     /**
-     * Controls the formatter for JSON and languages that extend it.
+     * Enables or disables the formatter for JSON and languages that extend it.
      *
      * @schema JsonFormatterConfiguration#enabled
      */
@@ -1619,15 +1927,17 @@ export interface JsonFormatterConfiguration {
      */
     readonly lineEnding?: LineEnding;
     /**
-     * The maximum line width applied to JSON and languages that extend it. If unset, inherits the
-     * global line width.
+     * The preferred maximum line width applied to JSON and languages that extend it. If unset,
+     * inherits the global line width.
      *
      * @schema JsonFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * Prints trailing commas wherever possible in multiline comma-separated structures. Defaults
-     * to `none`.
+     * Controls trailing commas in multiline JSON arrays and objects. `none` removes trailing
+     * commas, while `all` adds them wherever the JSON formatter supports them. Use `all` only for
+     * JSON variants that allow trailing commas, and ensure `json.parser.allowTrailingCommas` is
+     * enabled or automatically detected for those files. Defaults to `none`.
      *
      * @default none`.
      * @schema JsonFormatterConfiguration#trailingCommas
@@ -1653,7 +1963,7 @@ export declare function toJson_JsonFormatterConfiguration(obj: JsonFormatterConf
  */
 export interface JsonLinterConfiguration {
     /**
-     * Controls the linter for JSON and languages that extend it.
+     * Enables or disables the linter for JSON and languages that extend it.
      *
      * @schema JsonLinterConfiguration#enabled
      */
@@ -1671,13 +1981,17 @@ export declare function toJson_JsonLinterConfiguration(obj: JsonLinterConfigurat
  */
 export interface JsonParserConfiguration {
     /**
-     * Allows parsing comments in `.json` files.
+     * Controls whether comments are allowed in files parsed as JSON. When unset, Biome follows the
+     * file type's default behavior. An explicit value overrides that behavior, except that
+     * `biome.jsonc` always allows comments.
      *
      * @schema JsonParserConfiguration#allowComments
      */
     readonly allowComments?: boolean;
     /**
-     * Allows parsing trailing commas in `.json` files.
+     * Controls whether trailing commas are allowed in files parsed as JSON. When unset, Biome
+     * follows the file type's default behavior. An explicit value overrides that behavior, except
+     * that `biome.jsonc` always allows trailing commas.
      *
      * @schema JsonParserConfiguration#allowTrailingCommas
      */
@@ -1783,14 +2097,22 @@ export interface Rules {
      */
     readonly performance?: any;
     /**
-     * The rule presets to use.
+     * Selects the baseline set of lint rules. `recommended` enables Biome's recommended
+     * non-nursery rules, `all` enables all non-nursery rules, and `none` starts with no
+     * rules enabled. Group-level settings and explicit rule settings override this
+     * preset. Defaults to `recommended`.
      *
+     * @default recommended`.
      * @schema Rules#preset
      */
     readonly preset?: PresetConfig;
     /**
-     * It enables the lint rules recommended by Biome. `true` by default.
+     * Enables or disables Biome's recommended non-nursery rules. Defaults to `true`.
      *
+     * **Deprecated:** This option will be removed in the next major version. Use
+     * `linter.rules.preset` instead, or run `biome migrate` to update the configuration.
+     *
+     * @default true`.
      * @schema Rules#recommended
      */
     readonly recommended?: boolean;
@@ -1812,18 +2134,171 @@ export interface Rules {
  * @internal
  */
 export declare function toJson_Rules(obj: Rules | undefined): Record<string, any> | undefined;
+/**
+ * Options that change how the Markdown formatter behaves
+ *
+ * @schema MarkdownFormatterConfiguration
+ */
+export interface MarkdownFormatterConfiguration {
+    /**
+     * Control the formatter for Markdown (and its super languages) files.
+     *
+     * @schema MarkdownFormatterConfiguration#enabled
+     */
+    readonly enabled?: boolean;
+    /**
+     * Formats the code inside fenced code blocks, frontmatter, and HTML blocks with the formatter
+     * of the code's language. Defaults to `true`.
+     *
+     * A block with a syntax error stays as written, and Biome still formats the rest of the file.
+     *
+     * When this option is `false`, Biome keeps every block as written.
+     *
+     * @default true`.
+     * @schema MarkdownFormatterConfiguration#formatEmbeds
+     */
+    readonly formatEmbeds?: boolean;
+    /**
+     * The indent style applied to Markdown files.
+     *
+     * @schema MarkdownFormatterConfiguration#indentStyle
+     */
+    readonly indentStyle?: IndentStyle;
+    /**
+     * The size of the indentation applied to Markdown files. Defaults to 2.
+     *
+     * @default 2.
+     * @schema MarkdownFormatterConfiguration#indentWidth
+     */
+    readonly indentWidth?: number;
+    /**
+     * The type of line ending applied to Markdown (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+     *
+     * @schema MarkdownFormatterConfiguration#lineEnding
+     */
+    readonly lineEnding?: LineEnding;
+    /**
+     * What's the max width of a line applied to Markdown files. Defaults to 80.
+     *
+     * @default 80.
+     * @schema MarkdownFormatterConfiguration#lineWidth
+     */
+    readonly lineWidth?: number;
+    /**
+     * Controls whether Biome keeps, adds, or removes line breaks in Markdown paragraphs.
+     *
+     * Manual line breaks are always kept. In Markdown, a manual line break is created by ending a
+     * line with two spaces or a backslash.
+     *
+     * @schema MarkdownFormatterConfiguration#proseWrap
+     */
+    readonly proseWrap?: ProseWrap;
+    /**
+     * 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.
+     *
+     * @default true.
+     * @schema MarkdownFormatterConfiguration#trailingNewline
+     */
+    readonly trailingNewline?: boolean;
+}
+/**
+ * Converts an object of type 'MarkdownFormatterConfiguration' to JSON representation.
+ * @internal
+ */
+export declare function toJson_MarkdownFormatterConfiguration(obj: MarkdownFormatterConfiguration | undefined): Record<string, any> | undefined;
+/**
+ * Options that change how the Markdown linter behaves
+ *
+ * @schema MarkdownLinterConfiguration
+ */
+export interface MarkdownLinterConfiguration {
+    /**
+     * Control the linter for Markdown files.
+     *
+     * @schema MarkdownLinterConfiguration#enabled
+     */
+    readonly enabled?: boolean;
+}
+/**
+ * Converts an object of type 'MarkdownLinterConfiguration' to JSON representation.
+ * @internal
+ */
+export declare function toJson_MarkdownLinterConfiguration(obj: MarkdownLinterConfiguration | undefined): Record<string, any> | undefined;
+/**
+ * Options that change how the Markdown parser behaves
+ *
+ * @schema MarkdownParserConfiguration
+ */
+export interface MarkdownParserConfiguration {
+    /**
+     * Recognizes bold, italic, and strikethrough markers placed directly next to Chinese, Japanese, or Korean text. Defaults to `false`.
+     *
+     * Standard Markdown doesn't treat `**テスト。**テスト` as bold text, because the closing `**`
+     * is between a punctuation mark and a letter with no space around it. Languages that don't
+     * put spaces between words run into this often. When enabled, Biome follows the
+     * [CommonMark CJK-friendly amendments](https://github.com/tats-u/markdown-cjk-friendly/blob/main/specification.md)
+     * and treats such text as bold or italic. The option applies to `*`, `_`, and `~~` markers.
+     * After a variation selector (an invisible character that picks a glyph style for the
+     * character before it), Biome classifies a marker by the character before the selector.
+     *
+     * The option can also change markers that aren't next to Chinese, Japanese, or Korean text,
+     * because a marker that can now open or close formatting can take another marker's partner
+     * in the same paragraph, heading, or table cell. For example, standard Markdown shows
+     * `**テスト。**テスト a**` with `テスト a` in bold. With the option enabled, `テスト。` is bold
+     * and the last `**` is shown as written.
+     *
+     * The formatter and the linter both use this reading of the document. Enable the option only
+     * when the tool that renders your Markdown also supports these amendments. Otherwise, Biome
+     * treats as bold some text that your renderer shows with literal `**`, and formatting can
+     * change what your renderer shows. For example, the option makes `__` after a variation
+     * selector a bold marker, and the formatter rewrites it as `**`, which standard Markdown
+     * shows as bold even where it showed the original `__` as written.
+     *
+     * @default false`.
+     * @schema MarkdownParserConfiguration#cjkFriendlyEmphasis
+     */
+    readonly cjkFriendlyEmphasis?: boolean;
+    /**
+     * Enables parsing frontmatter at the start of the file. Defaults to `false`.
+     *
+     * @default false`.
+     * @schema MarkdownParserConfiguration#frontmatter
+     */
+    readonly frontmatter?: boolean;
+    /**
+     * Enables GitHub Flavored Markdown extensions. Defaults to `true`.
+     *
+     * @default true`.
+     * @schema MarkdownParserConfiguration#gfm
+     */
+    readonly gfm?: boolean;
+}
+/**
+ * Converts an object of type 'MarkdownParserConfiguration' to JSON representation.
+ * @internal
+ */
+export declare function toJson_MarkdownParserConfiguration(obj: MarkdownParserConfiguration | undefined): Record<string, any> | undefined;
 /**
  * @schema OverrideAssistConfiguration
  */
 export interface OverrideAssistConfiguration {
     /**
-     * List of actions
+     * The assist-action configuration for matched files.
      *
      * @schema OverrideAssistConfiguration#actions
      */
     readonly actions?: Actions;
     /**
-     * if `false`, it disables the feature and the assist won't be executed. `true` by default
+     * Enables or disables assist actions for matched files.
      *
      * @schema OverrideAssistConfiguration#enabled
      */
@@ -1839,7 +2314,7 @@ export declare function toJson_OverrideAssistConfiguration(obj: OverrideAssistCo
  */
 export interface OverrideFilesConfiguration {
     /**
-     * File size limit in bytes
+     * The maximum source-file size in bytes for matched files.
      *
      * @schema OverrideFilesConfiguration#maxSize
      */
@@ -1855,21 +2330,24 @@ export declare function toJson_OverrideFilesConfiguration(obj: OverrideFilesConf
  */
 export interface OverrideFormatterConfiguration {
     /**
-     * The attribute position style.
+     * The attribute position style in HTML-like languages.
      *
      * @schema OverrideFormatterConfiguration#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).
+     * Controls the placement of the closing bracket for multiline HTML and JSX opening tags. Biome
+     * places the bracket at the end of the last attribute line when enabled and on its own line when
+     * disabled. This also affects self-closing HTML elements, but self-closing JSX elements are
+     * unaffected.
      *
      * @schema OverrideFormatterConfiguration#bracketSameLine
      */
     readonly bracketSameLine?: boolean;
     /**
-     * Whether to insert spaces around brackets in object literals. Defaults to true.
+     * Controls spaces inside braces in supported single-line structures. The affected structures
+     * vary by language.
      *
-     * @default true.
      * @schema OverrideFormatterConfiguration#bracketSpacing
      */
     readonly bracketSpacing?: boolean;
@@ -1883,6 +2361,8 @@ export interface OverrideFormatterConfiguration {
      */
     readonly delimiterSpacing?: boolean;
     /**
+     * Enables or disables the formatter for matched files.
+     *
      * @schema OverrideFormatterConfiguration#enabled
      */
     readonly enabled?: boolean;
@@ -1904,62 +2384,56 @@ export interface OverrideFormatterConfiguration {
      */
     readonly expand?: Expand;
     /**
-     * Stores whether formatting should be allowed to proceed if a given file
-     * has syntax errors
+     * Allows formatting matched files that contain syntax errors.
      *
      * @schema OverrideFormatterConfiguration#formatWithErrors
      */
     readonly formatWithErrors?: boolean;
     /**
-     * The size of the indentation, 2 by default (deprecated, use `indent-width`)
+     * The indentation width. Deprecated, use `indentWidth` instead.
      *
      * @schema OverrideFormatterConfiguration#indentSize
      */
     readonly indentSize?: number;
     /**
-     * The indent style.
+     * Uses tabs or spaces for indentation.
      *
      * @schema OverrideFormatterConfiguration#indentStyle
      */
     readonly indentStyle?: IndentStyle;
     /**
-     * The size of the indentation, 2 by default
+     * Sets the indentation width. With space indentation, this is the number of spaces emitted per
+     * indentation level. With tab indentation, Biome emits one tab per level and uses this value as
+     * the tab's display width when calculating line length. Accepted values are `0` through `24`.
      *
      * @schema OverrideFormatterConfiguration#indentWidth
      */
     readonly indentWidth?: number;
     /**
-     * The type of line ending.
+     * The line ending.
      *
      * @schema OverrideFormatterConfiguration#lineEnding
      */
     readonly lineEnding?: LineEnding;
     /**
-     * What's the max width of a line. Defaults to 80.
+     * Sets the preferred maximum line width used when deciding where to wrap code. Some content,
+     * such as long unbreakable strings, may still exceed this width. Accepted values are `1` through
+     * `320`.
      *
-     * @default 80.
      * @schema OverrideFormatterConfiguration#lineWidth
      */
     readonly lineWidth?: number;
     /**
-     * Print trailing commas wherever possible in multi-line comma-separated syntactic structures.
+     * Prints trailing commas wherever possible in multiline comma-separated structures. This is a
+     * legacy override option. Prefer `javascript.formatter.trailingCommas`.
      *
      * @schema OverrideFormatterConfiguration#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 matched files. Disabling this option can
+     * cause compatibility problems with other tools.
      *
-     * 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 OverrideFormatterConfiguration#trailingNewline
      */
     readonly trailingNewline?: boolean;
@@ -1974,19 +2448,19 @@ export declare function toJson_OverrideFormatterConfiguration(obj: OverrideForma
  */
 export interface OverrideLinterConfiguration {
     /**
-     * List of rules
+     * The lint-domain configuration for matched files.
      *
      * @schema OverrideLinterConfiguration#domains
      */
     readonly domains?: RuleDomains;
     /**
-     * if `false`, it disables the feature and the linter won't be executed. `true` by default
+     * Enables or disables the linter for matched files.
      *
      * @schema OverrideLinterConfiguration#enabled
      */
     readonly enabled?: boolean;
     /**
-     * List of rules
+     * The lint-rule configuration for matched files.
      *
      * @schema OverrideLinterConfiguration#rules
      */
@@ -2006,6 +2480,94 @@ export declare enum VcsClientKind {
     /** git */
     GIT = "git"
 }
+/**
+ * Options that change how the Yaml formatter behaves
+ *
+ * @schema YamlFormatterConfiguration
+ */
+export interface YamlFormatterConfiguration {
+    /**
+     * Whether to insert spaces inside non-empty flow mappings (`{ key: value }`)
+     * and sequences (`[ item ]`) that fit on one line. If unset, inherits the
+     * global bracket spacing setting. When neither is set, mappings have spaces
+     * and sequences do not.
+     *
+     * @schema YamlFormatterConfiguration#bracketSpacing
+     */
+    readonly bracketSpacing?: boolean;
+    /**
+     * Control the formatter for Yaml (and its super languages) files.
+     *
+     * @schema YamlFormatterConfiguration#enabled
+     */
+    readonly enabled?: boolean;
+    /**
+     * The size of the indentation applied to Yaml files. Defaults to 2.
+     *
+     * @default 2.
+     * @schema YamlFormatterConfiguration#indentWidth
+     */
+    readonly indentWidth?: number;
+    /**
+     * The type of line ending applied to Yaml (and its super languages) files. `auto` uses CRLF on Windows and LF on other platforms.
+     *
+     * @schema YamlFormatterConfiguration#lineEnding
+     */
+    readonly lineEnding?: LineEnding;
+    /**
+     * What's the max width of a line applied to Yaml files. Defaults to 80.
+     *
+     * @default 80.
+     * @schema YamlFormatterConfiguration#lineWidth
+     */
+    readonly lineWidth?: number;
+    /**
+     * The type of quotes used in YAML code. Defaults to `double`.
+     *
+     * @default double`.
+     * @schema YamlFormatterConfiguration#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.
+     *
+     * @default true.
+     * @schema YamlFormatterConfiguration#trailingNewline
+     */
+    readonly trailingNewline?: boolean;
+}
+/**
+ * Converts an object of type 'YamlFormatterConfiguration' to JSON representation.
+ * @internal
+ */
+export declare function toJson_YamlFormatterConfiguration(obj: YamlFormatterConfiguration | undefined): Record<string, any> | undefined;
+/**
+ * Options that change how the Yaml linter behaves
+ *
+ * @schema YamlLinterConfiguration
+ */
+export interface YamlLinterConfiguration {
+    /**
+     * Control the linter for Yaml files.
+     *
+     * @schema YamlLinterConfiguration#enabled
+     */
+    readonly enabled?: boolean;
+}
+/**
+ * Converts an object of type 'YamlLinterConfiguration' to JSON representation.
+ * @internal
+ */
+export declare function toJson_YamlLinterConfiguration(obj: YamlLinterConfiguration | undefined): Record<string, any> | undefined;
 /**
  * A preset configuration for enabling a set of rules.
  *
@@ -2020,60 +2582,85 @@ export declare enum PresetConfig {
     NONE = "none"
 }
 /**
- * A list of rules that belong to this group
+ * Configures one group of assist actions.
  *
  * @schema Source
  */
 export interface Source {
     /**
-     * Remove duplicate CSS classes.
+     * Remove repeated CSS class names from HTML class attributes.
      * See https://biomejs.dev/assist/actions/no-duplicate-classes
      *
      * @schema Source#noDuplicateClasses
      */
     readonly noDuplicateClasses?: any;
     /**
-     * Sorts imports and exports in your JavaScript and TypeScript files.
+     * Organize imports and exports in JavaScript and TypeScript files.
      * See https://biomejs.dev/assist/actions/organize-imports
      *
      * @schema Source#organizeImports
      */
     readonly organizeImports?: any;
     /**
-     * Enables a particular rule preset
+     * Selects the baseline set of assist actions for this group. `recommended` enables
+     * the group's recommended actions, `all` enables all actions in the group, and
+     * `none` starts with no actions enabled in the group. Explicit action settings
+     * override this group preset, which overrides `assist.actions.preset` for the group.
      *
      * @schema Source#preset
      */
     readonly preset?: PresetConfig;
     /**
-     * Enables the recommended rules for this group
+     * Enables or disables the recommended actions in this group. The group's `preset`
+     * setting takes precedence when both options are set.
      *
      * @schema Source#recommended
      */
     readonly recommended?: boolean;
     /**
-     * Enforce attribute sorting in HTML elements.
+     * Sort the arguments of GraphQL fields and directives in natural order.
+     * See https://biomejs.dev/assist/actions/use-graphql-sorted-arguments
+     *
+     * @schema Source#useGraphqlSortedArguments
+     */
+    readonly useGraphqlSortedArguments?: any;
+    /**
+     * Sort the named definitions in a GraphQL document.
+     * See https://biomejs.dev/assist/actions/use-graphql-sorted-definitions
+     *
+     * @schema Source#useGraphqlSortedDefinitions
+     */
+    readonly useGraphqlSortedDefinitions?: any;
+    /**
+     * Sort the variable definitions of GraphQL operations in natural order.
+     * See https://biomejs.dev/assist/actions/use-graphql-sorted-variables
+     *
+     * @schema Source#useGraphqlSortedVariables
+     */
+    readonly useGraphqlSortedVariables?: any;
+    /**
+     * Sort HTML attributes and framework directives into a consistent order.
      * See https://biomejs.dev/assist/actions/use-sorted-attributes
      *
      * @schema Source#useSortedAttributes
      */
     readonly useSortedAttributes?: any;
     /**
-     * Sort the members of an enum in natural order.
+     * Sort GraphQL enum values in natural order.
      * See https://biomejs.dev/assist/actions/use-sorted-enum-members
      *
      * @schema Source#useSortedEnumMembers
      */
     readonly useSortedEnumMembers?: any;
     /**
-     * Sort interface members by key.
+     * Sort named members of a TypeScript interface.
      * See https://biomejs.dev/assist/actions/use-sorted-interface-members
      *
      * @schema Source#useSortedInterfaceMembers
      */
     readonly useSortedInterfaceMembers?: any;
     /**
-     * Sort the keys of a JSON object in natural order.
+     * Sort keys in a JSON object.
      * See https://biomejs.dev/assist/actions/use-sorted-keys
      *
      * @schema Source#useSortedKeys
@@ -2087,21 +2674,21 @@ export interface Source {
      */
     readonly useSortedPackageJson?: any;
     /**
-     * Enforce ordering of CSS properties and nested rules.
+     * Sort CSS properties and nested rules into a consistent order.
      * See https://biomejs.dev/assist/actions/use-sorted-properties
      *
      * @schema Source#useSortedProperties
      */
     readonly useSortedProperties?: any;
     /**
-     * Sort GraphQL selection sets.
+     * Sort selections inside GraphQL operations and fragments.
      * See https://biomejs.dev/assist/actions/use-sorted-selection-set
      *
      * @schema Source#useSortedSelectionSet
      */
     readonly useSortedSelectionSet?: any;
     /**
-     * Sort fields in GraphQL type definitions alphabetically.
+     * Sort fields in GraphQL type definitions by name.
      * See https://biomejs.dev/assist/actions/use-sorted-type-fields
      *
      * @schema Source#useSortedTypeFields
@@ -2123,18 +2710,19 @@ export declare enum QuoteStyle {
     SINGLE = "single"
 }
 /**
- * Controls whether void-elements should be self closed
+ * Controls whether HTML void elements such as `<img>` and `<input>` include a slash before `>`.
  *
  * @schema SelfCloseVoidElements
  */
 export declare enum SelfCloseVoidElements {
-    /** The `/` inside void elements is removed by the formatter (never) */
+    /** Removes the slash, for example `<img src="image.png">`. (never) */
     NEVER = "never",
-    /** The `/` inside void elements is always added (always) */
+    /** Adds the slash, for example `<img src="image.png" />`. (always) */
     ALWAYS = "always"
 }
 /**
- * Whitespace sensitivity for HTML formatting.
+ * Controls how the formatter treats whitespace around text and child elements in HTML, Vue,
+ * Svelte, and Astro markup.
  *
  * The following two cases won't produce the same output:
  *
@@ -2161,13 +2749,10 @@ export declare enum SelfCloseVoidElements {
  * @schema WhitespaceSensitivity
  */
 export declare enum WhitespaceSensitivity {
-    /** The formatter considers whitespace significant for elements that have an "inline" display style by default in
-  browser's user agent style sheets. (css) */
+    /** Treats whitespace as significant for elements that browsers display inline by default. (css) */
     CSS = "css",
-    /** Leading and trailing whitespace in content is considered significant for all elements.
-  
-  The formatter should leave at least one whitespace character if whitespace is present.
-  Otherwise, if there is no whitespace, it should not add any after `>` or before `<`. In other words, if there's no whitespace, the text content should hug the tags.
+    /** Treats leading and trailing whitespace as significant for every element. Existing whitespace
+  is preserved as at least one character and absent whitespace is not added.
   
   Example of text hugging the tags:
   ```html
@@ -2176,16 +2761,17 @@ export declare enum WhitespaceSensitivity {
   >
   ``` (strict) */
     STRICT = "strict",
-    /** Whitespace is considered insignificant. The formatter is free to remove or add whitespace as it sees fit. (ignore) */
+    /** Treats whitespace as insignificant, allowing the formatter to add or remove it. Use this only
+  when whitespace cannot affect rendered output. (ignore) */
     IGNORE = "ignore"
 }
 /**
  * @schema ArrowParentheses
  */
 export declare enum ArrowParentheses {
-    /** always */
+    /** Always prints parentheses around arrow-function parameters. (always) */
     ALWAYS = "always",
-    /** asNeeded */
+    /** Omits parentheses when an arrow function has one parameter and the syntax permits it. (asNeeded) */
     AS_NEEDED = "asNeeded"
 }
 /**
@@ -2201,9 +2787,9 @@ export declare enum OperatorLinebreak {
  * @schema QuoteProperties
  */
 export declare enum QuoteProperties {
-    /** asNeeded */
+    /** Removes quotes when the property name is valid without them. (asNeeded) */
     AS_NEEDED = "asNeeded",
-    /** preserve */
+    /** Preserves quotes around property names that were quoted in the input. (preserve) */
     PRESERVE = "preserve"
 }
 /**
@@ -2229,7 +2815,7 @@ export declare enum JsTrailingCommas {
     NONE = "none"
 }
 /**
- * Print trailing commas wherever possible in multi-line comma-separated syntactic structures for JSON files.
+ * Controls trailing commas in multiline JSON arrays and objects. Use `all` only for JSON variants that allow trailing commas, and ensure `json.parser.allowTrailingCommas` is enabled or automatically detected for those files.
  *
  * @schema JsonTrailingCommas
  */
@@ -2243,10 +2829,26 @@ export declare enum JsonTrailingCommas {
  * @schema RuleDomainValue
  */
 export declare enum RuleDomainValue {
-    /** Enables all the rules that belong to this domain (all) */
+    /** Enables all rules in the domain. (all) */
     ALL = "all",
-    /** Disables all the rules that belong to this domain (none) */
+    /** Disables the domain. (none) */
     NONE = "none",
-    /** Enables only the recommended rules for this domain (recommended) */
+    /** Enables the domain's recommended non-nursery rules. (recommended) */
     RECOMMENDED = "recommended"
 }
+/**
+ * Controls whether Biome keeps, adds, or removes line breaks in Markdown paragraphs.
+ *
+ * Manual line breaks are always kept. In Markdown, a manual line break is created by ending a
+ * line with two spaces or a backslash.
+ *
+ * @schema ProseWrap
+ */
+export declare enum ProseWrap {
+    /** Keep line breaks as written in the source file. This is the default. (preserve) */
+    PRESERVE = "preserve",
+    /** Wrap paragraphs to fit the configured `lineWidth`. (always) */
+    ALWAYS = "always",
+    /** Remove line breaks from paragraphs so that each paragraph is on one line. (never) */
+    NEVER = "never"
+}