@supersoniks/concorde 5.0.4 → 5.1.0

package/src/core/components/ui/form/form-layout/form-layout.md

@@ -1,44 +1,119 @@
-# Form-layout
+# Form layout
+
+**`sonic-form-layout`** arranges slotted form controls in a **responsive CSS grid** with consistent vertical spacing. Pair **`sonic-input`** · **`sonic-select`** and **`sonic-input-autocomplete`** fields side by side when the host is wider than **440px**; **textareas**, **toggles**, **dividers**, and **`sonic-form-actions`** span the full width. Wrap a **`form`** or **`sonic-fieldset`** body—no attributes are required.
+
+## Basic example
+
+Typical registration-style form: short fields flow in two columns on wide layouts; long or grouped blocks stay full width.
+
+<sonic-code>
+  <template>
+    <form>
+      <sonic-form-layout>
+        <sonic-input autocomplete="family-name" label="Last name" name="last_name"></sonic-input>
+        <sonic-input autocomplete="given-name" label="First name" name="first_name"></sonic-input>
+        <sonic-select autocomplete="sex" label="Gender" name="gender">
+          <option value="" selected="selected">— Select —</option>
+          <option value="prefer-not">Prefer not to say</option>
+          <option value="male">Male</option>
+          <option value="female">Female</option>
+        </sonic-select>
+        <sonic-input autocomplete="bday" label="Date of birth" name="birth_date" type="date"></sonic-input>
+        <sonic-divider></sonic-divider>
+        <sonic-input autocomplete="email" label="Email" name="email" type="email"></sonic-input>
+        <sonic-input
+          autocomplete="email"
+          label="Confirm email"
+          name="email_confirmation"
+          type="email"
+        ></sonic-input>
+        <sonic-input autocomplete="new-password" label="Password" name="password" type="password"></sonic-input>
+        <sonic-input
+          autocomplete="new-password"
+          label="Confirm password"
+          name="password_confirmation"
+          type="password"
+        ></sonic-input>
+        <sonic-divider></sonic-divider>
+        <sonic-textarea label="Message" rows="5"></sonic-textarea>
+        <sonic-switch>Enable optional feature</sonic-switch>
+        <sonic-checkbox>Subscribe to newsletter</sonic-checkbox>
+        <sonic-checkbox>
+          I accept the
+          <sonic-link href="#" class="underline">terms and conditions</sonic-link>
+        </sonic-checkbox>
+        <sonic-form-actions>
+          <sonic-button type="success">Submit</sonic-button>
+        </sonic-form-actions>
+      </sonic-form-layout>
+    </form>
+  </template>
+</sonic-code>
+
+## Responsive columns
+
+When the host **`offsetWidth`** is **greater than 440px**, the grid uses **two equal columns** with slightly larger gap (**1.75rem**). Below that breakpoint, fields stack in a **single column** (**1.5rem** gap).
+
+If the slot contains **exactly one** direct **`sonic-input`**, **`sonic-select`**, or **`sonic-input-autocomplete`**, the layout stays **one column** even above the breakpoint so a lone field does not sit in half an empty row.
+
+<sonic-code>
+  <template>
+    <div class="grid gap-8 md:grid-cols-2 mb-6">
+      <div>
+        <sonic-form-layout style="max-width: 20rem">
+        <sonic-divider align="left">Narrow host (single column)</sonic-divider>
+          <sonic-input label="Email" name="email_narrow" type="email"></sonic-input>
+          <sonic-input label="Confirm email" name="email_confirm_narrow" type="email"></sonic-input>
+        </sonic-form-layout>
+      </div>
+    </div>
+    <div>
+      <sonic-form-layout>
+      <sonic-divider align="left">Wide host (two columns for inputs)</sonic-divider>
+        <sonic-input label="Email" name="email_wide" type="email"></sonic-input>
+        <sonic-input label="Confirm email" name="email_confirm_wide" type="email"></sonic-input>
+      </sonic-form-layout>
+    </div>
+  </template>
+</sonic-code>
+
+## Full-width slotted blocks
+
+Everything except **`sonic-input`**, **`sonic-select`**, **`sonic-input-autocomplete`**, and slotted elements with class **`form-item-container`** is assigned **`grid-column: 1 / -1`**. Use this for **`sonic-textarea`**, **`sonic-checkbox`**, **`sonic-switch`**, **`sonic-form-actions`**, **`sonic-divider`**, and similar blocks.
+
+Slotted **`sonic-divider`** sets **`--sc-divider-my: 0`** so divider spacing matches the grid rhythm. Slotted **`sonic-submit`** uses **`display: contents`** so submit controls participate in the grid without an extra wrapper box.
 
 <sonic-code>
   <template>
-  <form>
     <sonic-form-layout>
-      <sonic-input autocomplete="family-name" label="Nom" name="nom"></sonic-input>
-      <sonic-input autocomplete="given-name" label="Prénom" name="prenom"></sonic-input>
-      <sonic-select autocomplete="sex" label="Sexe" name="sexe">
-        <option value="" selected="selected">- Sélectionner -</option>
-        <option value="-">Je préfère ne pas le dire</option>
-        <option value="Homme">Homme</option>
-        <option value="Femme">Femme</option>
-      </sonic-select>
-      <sonic-input autocomplete="bday" label="Date de naissance" name="date_naissance" type="date"></sonic-input>
-      <sonic-divider></sonic-divider>
-      <sonic-input autocomplete="email" label="e-mail" name="email" type="email"></sonic-input>
-      <sonic-input
-        autocomplete="email"
-        label="Confirmer votre e-mail"
-        name="email_confirmation"
-        type="email"
-      ></sonic-input>
-      <sonic-input autocomplete="new-password" label="Mot de passe" name="password" type="password"></sonic-input>
-      <sonic-input
-        autocomplete="new-password"
-        label="Confirmer votre mot de passe"
-        name="password_confirmation"
-        type="password"
-      ></sonic-input>
-      <sonic-divider></sonic-divider>
-      <sonic-textarea label="Message" rows="5">
-      </sonic-textarea>
-      <sonic-switch>Activer une superbe option</sonic-switch>
-      <sonic-checkbox>Inscription à la newsletter</sonic-checkbox>
-      <sonic-checkbox>J'ai lu et accepte les <sonic-link href="#" class="underline">Conditions générales de ventes</sonic-link></sonic-checkbox>
+      <sonic-input label="Subject" name="subject"></sonic-input>
+      <sonic-textarea label="Details" rows="4"></sonic-textarea>
       <sonic-form-actions>
-        <sonic-button type="success">Valider</sonic-button> 
+        <sonic-button type="primary">Send</sonic-button>
       </sonic-form-actions>
     </sonic-form-layout>
-  </form >
   </template>
 </sonic-code>
 
+## Custom column wrapper
+
+Add class **`form-item-container`** on a slotted wrapper (for example a **`div`**) when a field is not a direct **`sonic-input`** / **`sonic-select`** / **`sonic-input-autocomplete`** but should still share the two-column flow with short inputs.
+
+<sonic-code>
+  <template>
+    <sonic-form-layout>
+      <sonic-input label="City" name="city"></sonic-input>
+      <div class="form-item-container">
+        <sonic-input label="Postal code" name="postal_code"></sonic-input>
+      </div>
+    </sonic-form-layout>
+  </template>
+</sonic-code>
+
+## API reference
+
+No public attributes — layout follows slotted children and host width.
+
+| Slot | Description |
+|------|-------------|
+| *(default)* | Form fields and blocks in visual order; column vs full-width rules apply per slotted tag or **`form-item-container`** class |

package/src/core/components/ui/form/form-layout/form-layout.ts

@@ -1,14 +1,12 @@
-import {html, LitElement, css} from "lit";
-import {customElement, property, queryAssignedElements} from "lit/decorators.js";
-import {ResizeController} from "@lit-labs/observers/resize-controller.js";
-import {classMap} from "lit/directives/class-map.js";
-
-import Subscriber from "@supersoniks/concorde/core/mixins/Subscriber";
+import { html, LitElement, css } from "lit";
+import { customElement, state, queryAssignedElements } from "lit/decorators.js";
+import { ResizeController } from "@lit-labs/observers/resize-controller.js";
+import { classMap } from "lit/directives/class-map.js";
 
 const tagName = "sonic-form-layout";
 
 @customElement(tagName)
-export class FormLayout extends Subscriber(LitElement) {
+export class FormLayout extends LitElement {
   static styles = [
     css`
       :host {
@@ -17,52 +15,57 @@ export class FormLayout extends Subscriber(LitElement) {
 
       div {
         display: grid;
-        grid-gap: 1.5rem;
+        grid-gap: 1.25rem;
         align-items: flex-start;
       }
 
       .cq--md {
-        grid-gap: 1.75rem;
+        grid-gap: 1.35rem;
         grid-template-columns: repeat(2, minmax(0, 1fr));
       }
       .one-form-element {
         grid-template-columns: 1fr;
       }
-      /*::slotted(sonic-radio),
-      ::slotted(sonic-checkbox),
-      ::slotted(sonic-form-actions),
-      ::slotted(sonic-divider),
-      ::slotted(sonic-textarea) {
-        grid-column: 1 / -1;
-      }*/
       ::slotted(sonic-submit) {
         display: contents;
       }
-      ::slotted(:not(sonic-input):not(sonic-select):not(sonic-input-autocomplete):not(.form-item-container)) {
+      ::slotted(
+        :not(sonic-input):not(sonic-select):not(sonic-input-autocomplete):not(
+            .form-item-container
+          )
+      ) {
         grid-column: 1 / -1;
       }
 
       ::slotted(sonic-divider) {
-        --sc-divider-my: 0;
+        margin-top: 0;
+        margin-bottom: 0;
       }
     `,
   ];
   _resizeController = new ResizeController(this, {});
 
-  @queryAssignedElements({flatten: true}) slottedElements!: HTMLElement[];
-  @property({type: Boolean}) oneFormElement = false;
+  @queryAssignedElements({ flatten: true }) slottedElements!: HTMLElement[];
+  @state() _oneFormElement = false;
 
   onSlotChange() {
     let elements = this.slottedElements;
-    const formElementColumns = ["sonic-input", "sonic-select", "sonic-input-autocomplete", ".form-item-container"];
+    const formElementColumns = [
+      "sonic-input",
+      "sonic-select",
+      "sonic-input-autocomplete",
+      ".form-item-container",
+    ];
     // keep only form elements
-    elements = elements.filter((elt) => formElementColumns.includes(elt.nodeName.toLowerCase()));
-    this.oneFormElement = elements.length == 1;
+    elements = elements.filter((elt) =>
+      formElementColumns.includes(elt.nodeName.toLowerCase()),
+    );
+    this._oneFormElement = elements.length == 1;
   }
   render() {
     const classes = {
       "cq--md": this.offsetWidth > 440,
-      "one-form-element": this.oneFormElement,
+      "one-form-element": this._oneFormElement,
     };
     return html`<div class=${classMap(classes)}>
       <slot @slotchange=${this.onSlotChange}></slot>

package/src/core/components/ui/form/textarea/textarea.ts

@@ -84,7 +84,7 @@ export class Textarea extends FormInput(FormElement(LitElement)) {
 
   validateFormElement() {
     const textarea: HTMLTextAreaElement = this.shadowRoot?.querySelector(
-      "textarea"
+      "textarea",
     ) as HTMLTextAreaElement;
     if (!textarea || textarea.checkValidity()) return;
     const formPublisher = this.getFormPublisher();
@@ -103,7 +103,7 @@ export class Textarea extends FormInput(FormElement(LitElement)) {
       <label
         for="${this.id || "form-element"}"
         class="${this.hasLabel ? "form-label" : "hidden"}"
-        >${this.label ? unsafeHTML(this.label /*+ labelStarSuffix*/) : ""}<slot
+        >${this.label ? unsafeHTML(this.label) : ""}<slot
           name="label"
           @slotchange=${this.hasSlotOrProps}
         ></slot
@@ -115,6 +115,8 @@ export class Textarea extends FormInput(FormElement(LitElement)) {
           id="${this.id || "form-element"}"
           @input=${this.handleChange}
           @blur=${this.handleBlur}
+          .name=${this.name}
+          .value=${this.value}
           ?disabled=${this.disabled}
           ?required=${this.required}
           ?autofocus=${this.autofocus}
@@ -123,7 +125,6 @@ export class Textarea extends FormInput(FormElement(LitElement)) {
           maxlength=${ifDefined(this.maxlength)}
           minlength=${ifDefined(this.minlength)}
           ?readonly=${this.readonly}
-          spellcheck=${ifDefined(this.spellcheck)}
           autocomplete=${ifDefined(this.autocomplete)}
           tabindex=${ifDefined(this.tabindex)}
           wrap=${ifDefined(this.wrap)}

package/src/core/components/ui/group/group.md

@@ -1,6 +1,11 @@
 # Group
 
+**`sonic-group`** lays out slotted **`sonic-button`** · **`sonic-input`** and **`sonic-select`** controls in a single horizontal row with **shared corner radius** (first / middle / last items). Optional **`label`** and **`description`** follow form field styling. Use it for **button groups**, **radio rows**, or **input + action** toolbars.
+
 ## Radio group
+
+Pair with **`sonic-button`** **`radio`** and a shared **`name`**; ancestor **`formDataProvider`** stores the selected **`value`**.
+
 <sonic-code>
   <template>
     <sonic-group formDataProvider="subscriptionData">
@@ -12,10 +17,13 @@
 </sonic-code>
 
 ## Button group
+
+Adjacent link or action buttons without merging into one control.
+
 <sonic-code>
   <template>
     <sonic-group>
-      <sonic-button type="info" target="_blank" href="https://wwws.airfrance.fr/">🗼Air France</sonic-button>
+      <sonic-button type="info" target="_blank" href="https://wwws.airfrance.fr/">🗼 Air France</sonic-button>
       <sonic-button type="success" target="_blank" href="https://www.airtahitinui.com/">🌴 Air Tahiti</sonic-button>
       <sonic-button type="danger" target="_blank" href="https://www.aircorsica.com/">💣 Air Corsica</sonic-button>
     </sonic-group>
@@ -23,53 +31,45 @@
 </sonic-code>
 
 ## Input actions prefix
+
+Action control before the field. **`label`** or **`description`** on **`sonic-group`** annotate the row.
+
 <sonic-code>
   <template>
-    <div class="grid grid-cols-3 gap-3">
-      <sonic-group>
-        <sonic-button type="info" shape="square">
-          <sonic-icon library="iconoir" library="iconoir" name="info-empty"></sonic-icon>
-        </sonic-button>
-        <sonic-input placeholder="placeholder" ></sonic-input>
-      </sonic-group>
-      <sonic-group label="Label">
-        <sonic-button type="info" shape="square">
-          <sonic-icon library="iconoir" library="iconoir" name="info-empty"></sonic-icon>
-        </sonic-button>
-        <sonic-input  ></sonic-input>
-      </sonic-group>
-      <sonic-group description="Description">
+      <sonic-group label="Label" description="Description">
         <sonic-button type="info" shape="square">
-          <sonic-icon library="iconoir" library="iconoir" name="info-empty"></sonic-icon>
+          <sonic-icon library="iconoir" name="info-empty"></sonic-icon>
         </sonic-button>
-        <sonic-input ></sonic-input>
+        <sonic-input></sonic-input>
       </sonic-group>
-    </div>
   </template>
 </sonic-code>
 
 ## Input actions suffix
+
+Field first, action after (submit, validate, etc.).
+
 <sonic-code>
   <template>
-    <div class="grid grid-cols-3 gap-3">
-      <sonic-group>
-        <sonic-input placeholder="placeholder" ></sonic-input>
-        <sonic-button type="primary" shape="square">
-          <sonic-icon library="iconoir" library="iconoir" name="check"></sonic-icon>
-        </sonic-button>
-      </sonic-group>
-      <sonic-group label="Label">
-        <sonic-input  ></sonic-input>
-        <sonic-button type="primary" shape="square">
-          <sonic-icon library="iconoir" library="iconoir" name="check"></sonic-icon>
-        </sonic-button>
-      </sonic-group>
-      <sonic-group description="Description">
-        <sonic-input ></sonic-input>
+      <sonic-group label="Label" description="Description">
+        <sonic-input></sonic-input>
         <sonic-button type="primary" shape="square">
-          <sonic-icon library="iconoir" library="iconoir" name="check"></sonic-icon>
+          <sonic-icon library="iconoir" name="check"></sonic-icon>
         </sonic-button>
       </sonic-group>
-    </div>
   </template>
-</sonic-code>
+</sonic-code>
+
+## API reference
+
+| Attribute | Values | Description |
+|----------|---------|-------------|
+| `label` | string (HTML) | Label above the row; **`slot="label"`** overrides / extends |
+| `description` | string (HTML) | Help text below the row; **`slot="description"`** overrides / extends |
+| `alignItems` | CSS align-items (default `center`) | Cross-axis alignment of the main flex row |
+
+| Slot | Description |
+|------|-------------|
+| *(default)* | **`sonic-button`** · **`sonic-input`** · **`sonic-select`** in visual order |
+| `label` | Custom label markup |
+| `description` | Custom description markup |

package/src/core/components/ui/group/group.ts

@@ -1,4 +1,4 @@
-import { html, LitElement, css, PropertyValues } from "lit";
+import { html, LitElement, css, PropertyValues, nothing } from "lit";
 import { styleMap } from "lit/directives/style-map.js";
 import {
   customElement,
@@ -58,7 +58,7 @@ export class Group extends LitElement {
 
   updated(): void {
     const children = this.querySelectorAll(
-      "sonic-input, sonic-button, sonic-select"
+      "sonic-input, sonic-button, sonic-select",
     );
     const nbChildren = children.length;
 
@@ -81,14 +81,9 @@ export class Group extends LitElement {
     }
   }
 
-  connectedCallback() {
-    super.connectedCallback();
-    this.hasSlotOrProps();
-  }
-
   willUpdate(changedProperties: PropertyValues) {
-    this.hasSlotOrProps();
     super.willUpdate(changedProperties);
+    this.hasSlotOrProps();
   }
 
   hasSlotOrProps() {
@@ -103,7 +98,7 @@ export class Group extends LitElement {
     };
 
     return html`<span class="${this.hasLabel ? "form-label" : "hidden"}"
-        >${this.label ? unsafeHTML(this.label /*+ labelStarSuffix*/) : ""}<slot
+        >${this.label ? unsafeHTML(this.label) : nothing}<slot
           name="label"
           @slotchange=${this.hasSlotOrProps}
         ></slot
@@ -114,7 +109,7 @@ export class Group extends LitElement {
         @slotchange=${this.hasSlotOrProps}
         class="${this.hasDescription ? "form-description" : "hidden"}"
       >
-        ${this.description ? html`${unsafeHTML(this.description)}` : ""}
+        ${this.description ? html`${unsafeHTML(this.description)}` : nothing}
       </slot>`;
   }
 }