@vaadin/form-layout 24.7.0-rc1 → 24.8.0-alpha2

package/src/vaadin-form-layout.d.ts

@@ -90,6 +90,88 @@ export * from './vaadin-form-layout-mixin.js';
  * </vaadin-form-layout>
  * ```
  *
+ * ### Auto Responsive Mode
+ *
+ * To avoid manually dealing with responsive breakpoints, Form Layout provides an auto-responsive mode
+ * that automatically creates and adjusts fixed-width columns based on the container's available space.
+ * The [`columnWidth`](#/elements/vaadin-form-layout#property-columnWidth) and
+ * [`maxColumns`](#/elements/vaadin-form-layout#property-maxColumns) properties control the column width
+ * (13em by default) and the maximum number of columns (10 by default) that the Form Layout can create.
+ *
+ * ```html
+ * <vaadin-form-layout auto-responsive>
+ *   <vaadin-text-field label="First Name"></vaadin-text-field>
+ *   <vaadin-text-field label="Last Name"></vaadin-text-field>
+ *   <vaadin-text-area label="Address" colspan="2"></vaadin-text-area>
+ * </vaadin-form-layout>
+ * ```
+ *
+ * #### Organizing Fields into Rows
+ *
+ * By default, each field is placed on a new row. To organize fields into rows, you can either:
+ *
+ * 1. Manually wrap fields into [`<vaadin-form-row>`](#/elements/vaadin-form-row) elements.
+ *
+ * 2. Enable the [`autoRows`](#/elements/vaadin-form-layout#property-autoRows) property to
+ *    let Form Layout automatically arrange fields in available columns, wrapping to a new
+ *    row when necessary. `<br>` elements can be used to force a new row.
+ *
+ * Here is an example of using `<vaadin-form-row>`:
+ *
+ * ```html
+ * <vaadin-form-layout auto-responsive>
+ *   <vaadin-form-row>
+ *     <vaadin-text-field label="First Name"></vaadin-text-field>
+ *     <vaadin-text-field label="Last Name"></vaadin-text-field>
+ *   </vaadin-form-row>
+ *   <vaadin-form-row>
+ *     <vaadin-text-area label="Address" colspan="2"></vaadin-text-area>
+ *   </vaadin-form-row>
+ * </vaadin-form-layout>
+ * ```
+ *
+ * #### Expanding Columns and Fields
+ *
+ * You can configure Form Layout to expand columns to evenly fill any remaining space after
+ * all fixed-width columns have been created.
+ * To enable this, set the [`expandColumns`](#/elements/vaadin-form-layout#property-expandColumns)
+ * property to `true`.
+ *
+ * Also, Form Layout can stretch fields to make them take up all available space within columns.
+ * To enable this, set the [`expandFields`](#/elements/vaadin-form-layout#property-expandFields)
+ * property to `true`.
+ *
+ * #### Customizing Label Position
+ *
+ * By default, Form Layout displays labels above the fields. To position labels beside fields, you
+ * need to wrap each field in a `<vaadin-form-item>` element and define its labels on the wrapper.
+ * Then, you can enable the [`labelsAside`](#/elements/vaadin-form-layout#property-labelsAside)
+ * property:
+ *
+ * ```html
+ * <vaadin-form-layout auto-responsive labels-aside>
+ *   <vaadin-form-row>
+ *     <vaadin-form-item>
+ *       <label slot="label">First Name</label>
+ *       <vaadin-text-field></vaadin-text-field>
+ *    </vaadin-form-item>
+ *    <vaadin-form-item>
+ *      <label slot="label">Last Name</label>
+ *       <vaadin-text-field></vaadin-text-field>
+ *     </vaadin-form-item>
+ *   </vaadin-form-row>
+ *   <vaadin-form-row>
+ *     <vaadin-form-item colspan="2">
+ *       <label slot="label">Address</label>
+ *       <vaadin-text-area></vaadin-text-area>
+ *     </vaadin-form-item>
+ *   </vaadin-form-row>
+ * </vaadin-form-layout>
+ * ```
+ *
+ * With this, FormLayout will display labels beside fields, falling back to
+ * the default position above the fields only when there isn't enough space.
+ *
  * ### CSS Properties Reference
  *
  * The following custom CSS properties are available on the `<vaadin-form-layout>`

package/src/vaadin-form-layout.js

@@ -93,6 +93,88 @@ registerStyles('vaadin-form-layout', formLayoutStyles, { moduleId: 'vaadin-form-
  * </vaadin-form-layout>
  * ```
  *
+ * ### Auto Responsive Mode
+ *
+ * To avoid manually dealing with responsive breakpoints, Form Layout provides an auto-responsive mode
+ * that automatically creates and adjusts fixed-width columns based on the container's available space.
+ * The [`columnWidth`](#/elements/vaadin-form-layout#property-columnWidth) and
+ * [`maxColumns`](#/elements/vaadin-form-layout#property-maxColumns) properties control the column width
+ * (13em by default) and the maximum number of columns (10 by default) that the Form Layout can create.
+ *
+ * ```html
+ * <vaadin-form-layout auto-responsive>
+ *   <vaadin-text-field label="First Name"></vaadin-text-field>
+ *   <vaadin-text-field label="Last Name"></vaadin-text-field>
+ *   <vaadin-text-area label="Address" colspan="2"></vaadin-text-area>
+ * </vaadin-form-layout>
+ * ```
+ *
+ * #### Organizing Fields into Rows
+ *
+ * By default, each field is placed on a new row. To organize fields into rows, you can either:
+ *
+ * 1. Manually wrap fields into [`<vaadin-form-row>`](#/elements/vaadin-form-row) elements.
+ *
+ * 2. Enable the [`autoRows`](#/elements/vaadin-form-layout#property-autoRows) property to
+ *    let Form Layout automatically arrange fields in available columns, wrapping to a new
+ *    row when necessary. `<br>` elements can be used to force a new row.
+ *
+ * Here is an example of using `<vaadin-form-row>`:
+ *
+ * ```html
+ * <vaadin-form-layout auto-responsive>
+ *   <vaadin-form-row>
+ *     <vaadin-text-field label="First Name"></vaadin-text-field>
+ *     <vaadin-text-field label="Last Name"></vaadin-text-field>
+ *   </vaadin-form-row>
+ *   <vaadin-form-row>
+ *     <vaadin-text-area label="Address" colspan="2"></vaadin-text-area>
+ *   </vaadin-form-row>
+ * </vaadin-form-layout>
+ * ```
+ *
+ * #### Expanding Columns and Fields
+ *
+ * You can configure Form Layout to expand columns to evenly fill any remaining space after
+ * all fixed-width columns have been created.
+ * To enable this, set the [`expandColumns`](#/elements/vaadin-form-layout#property-expandColumns)
+ * property to `true`.
+ *
+ * Also, Form Layout can stretch fields to make them take up all available space within columns.
+ * To enable this, set the [`expandFields`](#/elements/vaadin-form-layout#property-expandFields)
+ * property to `true`.
+ *
+ * #### Customizing Label Position
+ *
+ * By default, Form Layout displays labels above the fields. To position labels beside fields, you
+ * need to wrap each field in a `<vaadin-form-item>` element and define its labels on the wrapper.
+ * Then, you can enable the [`labelsAside`](#/elements/vaadin-form-layout#property-labelsAside)
+ * property:
+ *
+ * ```html
+ * <vaadin-form-layout auto-responsive labels-aside>
+ *   <vaadin-form-row>
+ *     <vaadin-form-item>
+ *       <label slot="label">First Name</label>
+ *       <vaadin-text-field></vaadin-text-field>
+ *    </vaadin-form-item>
+ *    <vaadin-form-item>
+ *      <label slot="label">Last Name</label>
+ *       <vaadin-text-field></vaadin-text-field>
+ *     </vaadin-form-item>
+ *   </vaadin-form-row>
+ *   <vaadin-form-row>
+ *     <vaadin-form-item colspan="2">
+ *       <label slot="label">Address</label>
+ *       <vaadin-text-area></vaadin-text-area>
+ *     </vaadin-form-item>
+ *   </vaadin-form-row>
+ * </vaadin-form-layout>
+ * ```
+ *
+ * With this, FormLayout will display labels beside fields, falling back to
+ * the default position above the fields only when there isn't enough space.
+ *
  * ### CSS Properties Reference
  *
  * The following custom CSS properties are available on the `<vaadin-form-layout>`

package/src/vaadin-form-row.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
+
+/**
+ * `<vaadin-form-row>` is a web component for arranging fields into rows
+ * inside a `<vaadin-form-layout>` that is set to autoResponsive mode.
+ *
+ * Each `<vaadin-form-row>` always starts on a new row. Fields that exceed
+ * the available columns wrap to a new row, which then remains reserved
+ * exclusively for the fields of that `<vaadin-form-row>` element.
+ */
+declare class FormRow extends ThemableMixin(HTMLElement) {}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'vaadin-form-row': FormRow;
+  }
+}
+
+export { FormRow };

package/src/vaadin-form-row.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
+import { defineCustomElement } from '@vaadin/component-base/src/define.js';
+import { registerStyles, ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
+import { formRowStyles } from './vaadin-form-layout-styles.js';
+
+registerStyles('vaadin-form-row', formRowStyles, { moduleId: 'vaadin-form-row-styles' });
+
+/**
+ * `<vaadin-form-row>` is a web component for arranging fields into rows
+ * inside a `<vaadin-form-layout>` that is set to autoResponsive mode.
+ *
+ * Each `<vaadin-form-row>` always starts on a new row. Fields that exceed
+ * the available columns wrap to a new row, which then remains reserved
+ * exclusively for the fields of that `<vaadin-form-row>` element.
+ *
+ * @customElement
+ * @extends HTMLElement
+ * @mixes ThemableMixin
+ */
+class FormRow extends ThemableMixin(PolymerElement) {
+  static get is() {
+    return 'vaadin-form-row';
+  }
+
+  static get template() {
+    return html`<slot></slot>`;
+  }
+}
+
+defineCustomElement(FormRow);
+
+export { FormRow };

package/src/vaadin-lit-form-row.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+export * from './vaadin-form-row.js';

package/src/vaadin-lit-form-row.js

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import { html, LitElement } from 'lit';
+import { defineCustomElement } from '@vaadin/component-base/src/define.js';
+import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
+import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
+import { formRowStyles } from './vaadin-form-layout-styles.js';
+
+/**
+ * LitElement based version of `<vaadin-form-row>` web component.
+ *
+ * ## Disclaimer
+ *
+ * This component is an experiment and not yet a part of Vaadin platform.
+ * There is no ETA regarding specific Vaadin version where it'll land.
+ * Feel free to try this code in your apps as per Apache 2.0 license.
+ */
+class FormRow extends ThemableMixin(PolylitMixin(LitElement)) {
+  static get is() {
+    return 'vaadin-form-row';
+  }
+
+  static get styles() {
+    return formRowStyles;
+  }
+
+  /** @protected */
+  render() {
+    return html`<slot></slot>`;
+  }
+}
+
+defineCustomElement(FormRow);
+
+export { FormRow };

package/theme/lumo/vaadin-form-row.d.ts

@@ -0,0 +1 @@
+import '../../src/vaadin-form-row.js';

package/theme/lumo/vaadin-form-row.js

@@ -0,0 +1 @@
+import '../../src/vaadin-form-row.js';

package/theme/lumo/vaadin-lit-form-row.d.ts

@@ -0,0 +1 @@
+import '../../src/vaadin-lit-form-row.js';

package/theme/lumo/vaadin-lit-form-row.js

@@ -0,0 +1 @@
+import '../../src/vaadin-lit-form-row.js';

package/theme/material/vaadin-form-row.d.ts

@@ -0,0 +1 @@
+import '../../src/vaadin-form-row.js';

package/theme/material/vaadin-form-row.js

@@ -0,0 +1 @@
+import '../../src/vaadin-form-row.js';

package/theme/material/vaadin-lit-form-row.d.ts

@@ -0,0 +1 @@
+import '../../src/vaadin-lit-form-row.js';

package/theme/material/vaadin-lit-form-row.js

@@ -0,0 +1 @@
+import '../../src/vaadin-lit-form-row.js';

package/vaadin-form-row.d.ts

@@ -0,0 +1 @@
+export * from './src/vaadin-form-row.js';

package/vaadin-form-row.js

@@ -0,0 +1,2 @@
+import './theme/lumo/vaadin-form-row.js';
+export * from './src/vaadin-form-row.js';

package/vaadin-lit-form-row.d.ts

@@ -0,0 +1 @@
+export * from './vaadin-form-row.js';

package/vaadin-lit-form-row.js

@@ -0,0 +1,2 @@
+import './theme/lumo/vaadin-lit-form-row.js';
+export * from './src/vaadin-lit-form-row.js';

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/form-layout",
-  "version": "24.7.0-rc1",
+  "version": "24.8.0-alpha2",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -29,8 +29,85 @@
         },
         {
           "name": "vaadin-form-layout",
-          "description": "`<vaadin-form-layout>` is a Web Component providing configurable responsive\nlayout for form elements.\n\n```html\n<vaadin-form-layout>\n\n  <vaadin-form-item>\n    <label slot=\"label\">First Name</label>\n    <input class=\"full-width\" value=\"Jane\">\n  </vaadin-form-item>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Last Name</label>\n    <input class=\"full-width\" value=\"Doe\">\n  </vaadin-form-item>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Email</label>\n    <input class=\"full-width\" value=\"jane.doe@example.com\">\n  </vaadin-form-item>\n\n</vaadin-form-layout>\n```\n\nIt supports any child elements as layout items.\n\nBy default, it makes a layout of two columns if the element width is equal or\nwider than 40em, and a single column layout otherwise.\n\nThe number of columns and the responsive behavior are customizable with\nthe `responsiveSteps` property.\n\n### Spanning Items on Multiple Columns\n\nYou can use `colspan` or `data-colspan` attribute on the items.\nIn the example below, the first text field spans on two columns:\n\n```html\n<vaadin-form-layout>\n\n  <vaadin-form-item colspan=\"2\">\n    <label slot=\"label\">Address</label>\n    <input class=\"full-width\">\n  </vaadin-form-item>\n\n  <vaadin-form-item>\n    <label slot=\"label\">First Name</label>\n    <input class=\"full-width\" value=\"Jane\">\n  </vaadin-form-item>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Last Name</label>\n    <input class=\"full-width\" value=\"Doe\">\n  </vaadin-form-item>\n\n</vaadin-form-layout>\n```\n\n### Explicit New Row\n\nUse the `<br>` line break element to wrap the items on a new row:\n\n```html\n<vaadin-form-layout>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Email</label>\n    <input class=\"full-width\">\n  </vaadin-form-item>\n\n  <br>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Confirm Email</label>\n    <input class=\"full-width\">\n  </vaadin-form-item>\n\n</vaadin-form-layout>\n```\n\n### CSS Properties Reference\n\nThe following custom CSS properties are available on the `<vaadin-form-layout>`\nelement:\n\nCustom CSS property | Description | Default\n---|---|---\n`--vaadin-form-layout-column-spacing` | Length of the spacing between columns | `2em`\n`--vaadin-form-layout-row-spacing` | Length of the spacing between rows | `1em`\n`--vaadin-form-layout-label-width` | Width of the label when labels are displayed aside | `8em`\n`--vaadin-form-layout-label-spacing` | Length of the spacing between the label and the input when labels are displayed aside | `1em`",
+          "description": "`<vaadin-form-layout>` is a Web Component providing configurable responsive\nlayout for form elements.\n\n```html\n<vaadin-form-layout>\n\n  <vaadin-form-item>\n    <label slot=\"label\">First Name</label>\n    <input class=\"full-width\" value=\"Jane\">\n  </vaadin-form-item>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Last Name</label>\n    <input class=\"full-width\" value=\"Doe\">\n  </vaadin-form-item>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Email</label>\n    <input class=\"full-width\" value=\"jane.doe@example.com\">\n  </vaadin-form-item>\n\n</vaadin-form-layout>\n```\n\nIt supports any child elements as layout items.\n\nBy default, it makes a layout of two columns if the element width is equal or\nwider than 40em, and a single column layout otherwise.\n\nThe number of columns and the responsive behavior are customizable with\nthe `responsiveSteps` property.\n\n### Spanning Items on Multiple Columns\n\nYou can use `colspan` or `data-colspan` attribute on the items.\nIn the example below, the first text field spans on two columns:\n\n```html\n<vaadin-form-layout>\n\n  <vaadin-form-item colspan=\"2\">\n    <label slot=\"label\">Address</label>\n    <input class=\"full-width\">\n  </vaadin-form-item>\n\n  <vaadin-form-item>\n    <label slot=\"label\">First Name</label>\n    <input class=\"full-width\" value=\"Jane\">\n  </vaadin-form-item>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Last Name</label>\n    <input class=\"full-width\" value=\"Doe\">\n  </vaadin-form-item>\n\n</vaadin-form-layout>\n```\n\n### Explicit New Row\n\nUse the `<br>` line break element to wrap the items on a new row:\n\n```html\n<vaadin-form-layout>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Email</label>\n    <input class=\"full-width\">\n  </vaadin-form-item>\n\n  <br>\n\n  <vaadin-form-item>\n    <label slot=\"label\">Confirm Email</label>\n    <input class=\"full-width\">\n  </vaadin-form-item>\n\n</vaadin-form-layout>\n```\n\n### Auto Responsive Mode\n\nTo avoid manually dealing with responsive breakpoints, Form Layout provides an auto-responsive mode\nthat automatically creates and adjusts fixed-width columns based on the container's available space.\nThe [`columnWidth`](https://cdn.vaadin.com/vaadin-web-components/24.8.0-alpha2/#/elements/vaadin-form-layout#property-columnWidth) and\n[`maxColumns`](https://cdn.vaadin.com/vaadin-web-components/24.8.0-alpha2/#/elements/vaadin-form-layout#property-maxColumns) properties control the column width\n(13em by default) and the maximum number of columns (10 by default) that the Form Layout can create.\n\n```html\n<vaadin-form-layout auto-responsive>\n  <vaadin-text-field label=\"First Name\"></vaadin-text-field>\n  <vaadin-text-field label=\"Last Name\"></vaadin-text-field>\n  <vaadin-text-area label=\"Address\" colspan=\"2\"></vaadin-text-area>\n</vaadin-form-layout>\n```\n\n#### Organizing Fields into Rows\n\nBy default, each field is placed on a new row. To organize fields into rows, you can either:\n\n1. Manually wrap fields into [`<vaadin-form-row>`](https://cdn.vaadin.com/vaadin-web-components/24.8.0-alpha2/#/elements/vaadin-form-row) elements.\n\n2. Enable the [`autoRows`](https://cdn.vaadin.com/vaadin-web-components/24.8.0-alpha2/#/elements/vaadin-form-layout#property-autoRows) property to\n   let Form Layout automatically arrange fields in available columns, wrapping to a new\n   row when necessary. `<br>` elements can be used to force a new row.\n\nHere is an example of using `<vaadin-form-row>`:\n\n```html\n<vaadin-form-layout auto-responsive>\n  <vaadin-form-row>\n    <vaadin-text-field label=\"First Name\"></vaadin-text-field>\n    <vaadin-text-field label=\"Last Name\"></vaadin-text-field>\n  </vaadin-form-row>\n  <vaadin-form-row>\n    <vaadin-text-area label=\"Address\" colspan=\"2\"></vaadin-text-area>\n  </vaadin-form-row>\n</vaadin-form-layout>\n```\n\n#### Expanding Columns and Fields\n\nYou can configure Form Layout to expand columns to evenly fill any remaining space after\nall fixed-width columns have been created.\nTo enable this, set the [`expandColumns`](https://cdn.vaadin.com/vaadin-web-components/24.8.0-alpha2/#/elements/vaadin-form-layout#property-expandColumns)\nproperty to `true`.\n\nAlso, Form Layout can stretch fields to make them take up all available space within columns.\nTo enable this, set the [`expandFields`](https://cdn.vaadin.com/vaadin-web-components/24.8.0-alpha2/#/elements/vaadin-form-layout#property-expandFields)\nproperty to `true`.\n\n#### Customizing Label Position\n\nBy default, Form Layout displays labels above the fields. To position labels beside fields, you\nneed to wrap each field in a `<vaadin-form-item>` element and define its labels on the wrapper.\nThen, you can enable the [`labelsAside`](https://cdn.vaadin.com/vaadin-web-components/24.8.0-alpha2/#/elements/vaadin-form-layout#property-labelsAside)\nproperty:\n\n```html\n<vaadin-form-layout auto-responsive labels-aside>\n  <vaadin-form-row>\n    <vaadin-form-item>\n      <label slot=\"label\">First Name</label>\n      <vaadin-text-field></vaadin-text-field>\n   </vaadin-form-item>\n   <vaadin-form-item>\n     <label slot=\"label\">Last Name</label>\n      <vaadin-text-field></vaadin-text-field>\n    </vaadin-form-item>\n  </vaadin-form-row>\n  <vaadin-form-row>\n    <vaadin-form-item colspan=\"2\">\n      <label slot=\"label\">Address</label>\n      <vaadin-text-area></vaadin-text-area>\n    </vaadin-form-item>\n  </vaadin-form-row>\n</vaadin-form-layout>\n```\n\nWith this, FormLayout will display labels beside fields, falling back to\nthe default position above the fields only when there isn't enough space.\n\n### CSS Properties Reference\n\nThe following custom CSS properties are available on the `<vaadin-form-layout>`\nelement:\n\nCustom CSS property | Description | Default\n---|---|---\n`--vaadin-form-layout-column-spacing` | Length of the spacing between columns | `2em`\n`--vaadin-form-layout-row-spacing` | Length of the spacing between rows | `1em`\n`--vaadin-form-layout-label-width` | Width of the label when labels are displayed aside | `8em`\n`--vaadin-form-layout-label-spacing` | Length of the spacing between the label and the input when labels are displayed aside | `1em`",
           "attributes": [
+            {
+              "name": "auto-responsive",
+              "description": "Enables the auto responsive mode in which the component automatically creates and adjusts\ncolumns based on the container's width. Columns have a fixed width defined by `columnWidth`\nand their number increases up to the limit set by `maxColumns`. The component dynamically\nadjusts the number of columns as the container size changes. When this mode is enabled,\nthe `responsiveSteps` are ignored.\n\nBy default, each field is placed on a new row. To organize fields into rows, there are\ntwo options:\n\n1. Use `<vaadin-form-row>` to explicitly group fields into rows.\n\n2. Enable the `autoRows` property to automatically arrange fields in available columns,\n   wrapping to a new row when necessary. `<br>` elements can be used to force a new row.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "column-width",
+              "description": "When `autoResponsive` is enabled, defines the width of each column.\nThe value must be defined in CSS length units, e.g., `100px` or `13em`.\nThe default value is `13em`.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "max-columns",
+              "description": "When `autoResponsive` is enabled, defines the maximum number of columns\nthat the layout can create. The layout will create columns up to this\nlimit based on the available container width. The default value is `10`.",
+              "value": {
+                "type": [
+                  "number",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "auto-rows",
+              "description": "When enabled with `autoResponsive`, distributes fields across columns\nby placing each field in the next available column and wrapping to\nthe next row when the current row is full. `<br>` elements can be\nused to force a new row.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "labels-aside",
+              "description": "When enabled with `autoResponsive`, `<vaadin-form-item>` prefers positioning\nlabels beside the fields. If the layout is too narrow to fit a single column\nwith side labels, they revert to their default position above the fields.\n\nTo customize the label width and the gap between the label and the field,\nuse the following CSS properties:\n\n- `--vaadin-form-layout-label-width`\n- `--vaadin-form-layout-label-spacing`",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "expand-columns",
+              "description": "When `autoResponsive` is enabled, specifies whether the columns should expand\nin width to evenly fill any remaining space after the layout has created as\nmany fixed-width (`columnWidth`) columns as possible within the `maxColumns`\nlimit. The default value is `false`.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
+            {
+              "name": "expand-fields",
+              "description": "When `autoResponsive` is enabled, specifies whether fields should stretch\nto take up all available space within columns. This setting also applies\nto fields inside `<vaadin-form-item>` elements. The default value is `false`.",
+              "value": {
+                "type": [
+                  "boolean",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
             {
               "name": "theme",
               "description": "The theme variants to apply to the component.",
@@ -53,10 +130,108 @@
                     "Array.<FormLayoutResponsiveStep>"
                   ]
                 }
+              },
+              {
+                "name": "autoResponsive",
+                "description": "Enables the auto responsive mode in which the component automatically creates and adjusts\ncolumns based on the container's width. Columns have a fixed width defined by `columnWidth`\nand their number increases up to the limit set by `maxColumns`. The component dynamically\nadjusts the number of columns as the container size changes. When this mode is enabled,\nthe `responsiveSteps` are ignored.\n\nBy default, each field is placed on a new row. To organize fields into rows, there are\ntwo options:\n\n1. Use `<vaadin-form-row>` to explicitly group fields into rows.\n\n2. Enable the `autoRows` property to automatically arrange fields in available columns,\n   wrapping to a new row when necessary. `<br>` elements can be used to force a new row.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "columnWidth",
+                "description": "When `autoResponsive` is enabled, defines the width of each column.\nThe value must be defined in CSS length units, e.g., `100px` or `13em`.\nThe default value is `13em`.",
+                "value": {
+                  "type": [
+                    "string",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "maxColumns",
+                "description": "When `autoResponsive` is enabled, defines the maximum number of columns\nthat the layout can create. The layout will create columns up to this\nlimit based on the available container width. The default value is `10`.",
+                "value": {
+                  "type": [
+                    "number",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "autoRows",
+                "description": "When enabled with `autoResponsive`, distributes fields across columns\nby placing each field in the next available column and wrapping to\nthe next row when the current row is full. `<br>` elements can be\nused to force a new row.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "labelsAside",
+                "description": "When enabled with `autoResponsive`, `<vaadin-form-item>` prefers positioning\nlabels beside the fields. If the layout is too narrow to fit a single column\nwith side labels, they revert to their default position above the fields.\n\nTo customize the label width and the gap between the label and the field,\nuse the following CSS properties:\n\n- `--vaadin-form-layout-label-width`\n- `--vaadin-form-layout-label-spacing`",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "expandColumns",
+                "description": "When `autoResponsive` is enabled, specifies whether the columns should expand\nin width to evenly fill any remaining space after the layout has created as\nmany fixed-width (`columnWidth`) columns as possible within the `maxColumns`\nlimit. The default value is `false`.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
+              },
+              {
+                "name": "expandFields",
+                "description": "When `autoResponsive` is enabled, specifies whether fields should stretch\nto take up all available space within columns. This setting also applies\nto fields inside `<vaadin-form-item>` elements. The default value is `false`.",
+                "value": {
+                  "type": [
+                    "boolean",
+                    "null",
+                    "undefined"
+                  ]
+                }
               }
             ],
             "events": []
           }
+        },
+        {
+          "name": "vaadin-form-row",
+          "description": "`<vaadin-form-row>` is a web component for arranging fields into rows\ninside a `<vaadin-form-layout>` that is set to autoResponsive mode.\n\nEach `<vaadin-form-row>` always starts on a new row. Fields that exceed\nthe available columns wrap to a new row, which then remains reserved\nexclusively for the fields of that `<vaadin-form-row>` element.",
+          "attributes": [
+            {
+              "name": "theme",
+              "description": "The theme variants to apply to the component.",
+              "value": {
+                "type": [
+                  "string",
+                  "null",
+                  "undefined"
+                ]
+              }
+            }
+          ],
+          "js": {
+            "properties": [],
+            "events": []
+          }
         }
       ]
     }