@vaadin/form-layout 22.0.0-alpha9 → 22.0.0

package/README.md

@@ -1,13 +1,10 @@
-# <vaadin-form-layout>
+# @vaadin/form-layout
 
-[Live Demo ↗](https://vaadin.com/components/vaadin-form-layout/html-examples)
-|
-[API documentation ↗](https://vaadin.com/components/vaadin-form-layout/html-api)
+A web component for building responsive forms with multiple columns.
 
-[<vaadin-form-layout>](https://vaadin.com/components/vaadin-form-layout) is a Web Component providing configurable responsive layout for form elements, part of the [Vaadin components](https://vaadin.com/components).
+[Documentation + Live Demo ↗](https://vaadin.com/docs/latest/ds/components/form-layout)
 
 [![npm version](https://badgen.net/npm/v/@vaadin/form-layout)](https://www.npmjs.com/package/@vaadin/form-layout)
-[![Published on Vaadin Directory](https://img.shields.io/badge/Vaadin%20Directory-published-00b4f0.svg)](https://vaadin.com/directory/component/vaadinvaadin-form-layout)
 [![Discord](https://img.shields.io/discord/732335336448852018?label=discord)](https://discord.gg/PHmkCKC)
 
 ```html
@@ -18,45 +15,44 @@
 </vaadin-form-layout>
 ```
 
-[<img src="https://raw.githubusercontent.com/vaadin/vaadin-form-layout/master/screenshot.png" width="880" alt="Screenshot of vaadin-form-layout">](https://vaadin.com/components/vaadin-form-layout)
+[<img src="https://raw.githubusercontent.com/vaadin/web-components/master/packages/form-layout/screenshot.png" width="880" alt="Screenshot of vaadin-form-layout">](https://vaadin.com/docs/latest/ds/components/form-layout)
 
 ## Installation
 
-Install `vaadin-form-layout`:
+Install the component:
 
 ```sh
-npm i @vaadin/form-layout --save
+npm i @vaadin/form-layout
 ```
 
-Once installed, import it in your application:
+Once installed, import the component in your application:
 
 ```js
-import '@vaadin/form-layout/vaadin-form-layout.js';
+import '@vaadin/form-layout';
 ```
 
-## Getting started
+## Themes
 
-Vaadin components use the Lumo theme by default.
+Vaadin components come with two built-in [themes](https://vaadin.com/docs/latest/ds/customization/using-themes), Lumo and Material.
+The [main entrypoint](https://github.com/vaadin/web-components/blob/master/packages/form-layout/vaadin-form-layout.js) of the package uses the Lumo theme.
 
-To use the Material theme, import the correspondent file from the `theme/material` folder.
+To use the Material theme, import the component from the `theme/material` folder:
 
-## Entry points
-
-- The components with the Lumo theme:
-
-  `theme/lumo/vaadin-form-layout.js`
-  `theme/lumo/vaadin-form-item.js`
+```js
+import '@vaadin/form-layout/theme/material/vaadin-form-layout.js';
+```
 
-- The components with the Material theme:
+You can also import the Lumo version of the component explicitly:
 
-  `theme/material/vaadin-form-layout.js`
-  `theme/material/vaadin-form-item.js`
+```js
+import '@vaadin/form-layout/theme/lumo/vaadin-form-layout.js';
+```
 
-- Alias for `theme/lumo/vaadin-form-layout.js`
-  `theme/lumo/vaadin-form-item.js`:
+Finally, you can import the un-themed component from the `src` folder to get a minimal starting point:
 
-  `vaadin-form-layout.js`
-  `vaadin-form-item.js`
+```js
+import '@vaadin/form-layout/src/vaadin-form-layout.js';
+```
 
 ## Contributing
 
@@ -66,4 +62,5 @@ Read the [contributing guide](https://vaadin.com/docs/latest/guide/contributing/
 
 Apache License 2.0
 
-Vaadin collects development time usage statistics to improve this product. For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.
+Vaadin collects usage statistics at development time to improve this product.
+For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/form-layout",
-  "version": "22.0.0-alpha9",
+  "version": "22.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -34,16 +34,16 @@
   "dependencies": {
     "@polymer/iron-resizable-behavior": "^3.0.0",
     "@polymer/polymer": "^3.0.0",
-    "@vaadin/component-base": "22.0.0-alpha9",
-    "@vaadin/vaadin-lumo-styles": "22.0.0-alpha9",
-    "@vaadin/vaadin-material-styles": "22.0.0-alpha9",
-    "@vaadin/vaadin-themable-mixin": "22.0.0-alpha9"
+    "@vaadin/component-base": "^22.0.0",
+    "@vaadin/vaadin-lumo-styles": "^22.0.0",
+    "@vaadin/vaadin-material-styles": "^22.0.0",
+    "@vaadin/vaadin-themable-mixin": "^22.0.0"
   },
   "devDependencies": {
     "@esm-bundle/chai": "^4.3.4",
-    "@vaadin/testing-helpers": "^0.3.0",
-    "@vaadin/text-field": "22.0.0-alpha9",
+    "@vaadin/testing-helpers": "^0.3.2",
+    "@vaadin/text-field": "^22.0.0",
     "sinon": "^9.2.1"
   },
-  "gitHead": "6e8c899dc65918f97e3c0acb2076122c4b2ef274"
+  "gitHead": "b668e9b1a975227fbe34beb70d1cd5b03dce2348"
 }

package/src/vaadin-form-item.js

@@ -3,7 +3,7 @@
  * Copyright (c) 2021 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { PolymerElement, html } from '@polymer/polymer/polymer-element.js';
+import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 /**
@@ -109,13 +109,7 @@ class FormItem extends ThemableMixin(PolymerElement) {
           display: inline-flex;
           flex-direction: row;
           align-items: baseline;
-
-          /* CSS API for host */
-          --vaadin-form-item-label-width: 8em;
-          --vaadin-form-item-label-spacing: 1em;
-          --vaadin-form-item-row-spacing: 1em;
-
-          margin: calc(0.5 * var(--vaadin-form-item-row-spacing)) 0;
+          margin: calc(0.5 * var(--vaadin-form-item-row-spacing, 1em)) 0;
         }
 
         :host([label-position='top']) {
@@ -128,7 +122,7 @@ class FormItem extends ThemableMixin(PolymerElement) {
         }
 
         #label {
-          width: var(--vaadin-form-item-label-width);
+          width: var(--vaadin-form-item-label-width, 8em);
           flex: 0 0 auto;
         }
 
@@ -137,7 +131,7 @@ class FormItem extends ThemableMixin(PolymerElement) {
         }
 
         #spacing {
-          width: var(--vaadin-form-item-label-spacing);
+          width: var(--vaadin-form-item-label-spacing, 1em);
           flex: 0 0 auto;
         }
 

package/src/vaadin-form-layout.js

@@ -3,11 +3,11 @@
  * Copyright (c) 2021 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { PolymerElement, html } from '@polymer/polymer/polymer-element.js';
-import { beforeNextRender } from '@polymer/polymer/lib/utils/render-status.js';
+import { IronResizableBehavior } from '@polymer/iron-resizable-behavior/iron-resizable-behavior.js';
 import { mixinBehaviors } from '@polymer/polymer/lib/legacy/class.js';
 import { FlattenedNodesObserver } from '@polymer/polymer/lib/utils/flattened-nodes-observer.js';
-import { IronResizableBehavior } from '@polymer/iron-resizable-behavior/iron-resizable-behavior.js';
+import { beforeNextRender } from '@polymer/polymer/lib/utils/render-status.js';
+import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
@@ -114,6 +114,9 @@ class FormLayout extends ElementMixin(ThemableMixin(mixinBehaviors([IronResizabl
           max-width: 100%;
           animation: 1ms vaadin-form-layout-appear;
           /* CSS API for host */
+          --vaadin-form-item-label-width: 8em;
+          --vaadin-form-item-label-spacing: 1em;
+          --vaadin-form-item-row-spacing: 1em;
           --vaadin-form-layout-column-spacing: 2em; /* (default) */
           align-self: stretch;
         }

package/theme/lumo/vaadin-form-item-styles.js

@@ -1,8 +1,8 @@
-import { registerStyles, css } from '@vaadin/vaadin-themable-mixin/register-styles.js';
 import '@vaadin/vaadin-lumo-styles/color.js';
 import '@vaadin/vaadin-lumo-styles/spacing.js';
 import '@vaadin/vaadin-lumo-styles/style.js';
 import '@vaadin/vaadin-lumo-styles/typography.js';
+import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 registerStyles(
   'vaadin-form-item',

package/theme/lumo/vaadin-form-layout-styles.js

@@ -1,5 +1,5 @@
-import { registerStyles, css } from '@vaadin/vaadin-themable-mixin/register-styles.js';
 import '@vaadin/vaadin-lumo-styles/spacing.js';
+import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 registerStyles(
   'vaadin-form-layout',

package/theme/material/vaadin-form-item-styles.js

@@ -1,6 +1,6 @@
-import { registerStyles, css } from '@vaadin/vaadin-themable-mixin/register-styles.js';
 import '@vaadin/vaadin-material-styles/color.js';
 import '@vaadin/vaadin-material-styles/typography.js';
+import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 registerStyles(
   'vaadin-form-item',