@vsn-ux/ngx-gaia 0.11.18 → 0.12.0

package/docs/checkbox.md

@@ -18,7 +18,8 @@ Checkbox component for boolean selections.
 - `aria-label: string | null` - ARIA label (default: null)
 - `aria-labelledby: string | null` - ARIA labelledby (default: null)
 - `aria-describedby: string | null` - ARIA describedby (default: null)
-- `aria-invalid: string | null` - ARIA invalid override (default: null)
+- `inError: boolean | null` - Manually overrides the error state. When omitted, derived from the form control (e.g. NgControl or signal forms) (default: null)
+- `aria-invalid: boolean | null` - Manually overrides the invalid ARIA state. When omitted, derived from inError (default: null)
 - `aria-errormessage: string | null` - ARIA error message ID (default: null)
 
 ### Outputs:

package/docs/data-select.md

@@ -23,7 +23,7 @@ Data select component that automatically generates options from an items array.
 - `placeholder: string` - Placeholder text (default: '')
 - `multiple: boolean` - Enable multi-select mode (default: false)
 - `disabled: boolean` - Disabled state (default: false)
-- `invalid: boolean | null` - Invalid state styling (default: null)
+- `inError: boolean | null` - Manually overrides the error state. When omitted, derived from the form control (e.g. NgControl or signal forms) (default: null)
 - `compareFn: (o1: any, o2: any) => boolean` - Comparison function for object values (default: (a, b) => a === b)
 - `searchable: boolean` - Enable search/filter functionality (default: false)
 - `customFilter: boolean` - Disable built-in filtering for custom implementation (default: false)

package/docs/form-field.md

@@ -67,6 +67,25 @@ Standalone directive for connecting form controls to form field labels. Import `
 
 - `provideGaFormErrors(config: GaFormErrorsConfig)` - Configure global error message templates. These messages are displayed when a validation error exists on the control (either from validators or `gaFormControlErrors`) and no specific `gaError` template is provided. This provider does not add errors to controls; it only defines how existing errors are displayed.
 
+## Signal Forms Support
+
+The form field works with Angular Signal Forms (`[formField]` directive). Use `gaFormControl` alongside `[formField]`:
+
+```html
+<ga-form-field>
+  <ga-label>Email</ga-label>
+  <input gaFormControl gaInput [formField]="myForm.email" />
+</ga-form-field>
+```
+
+Signal forms validators with a `message` option are automatically displayed without needing `gaError` templates or global errors.
+
+### Error Message Priority
+
+1. `gaError` template (local)
+2. Signal forms validator `message`
+3. `provideGaFormErrors()` (global)
+
 ## Examples
 
 Complete form field
@@ -142,3 +161,21 @@ Global error override behavior
   <!-- The 'minlength' error will use the global message if configured -->
 </ga-form-field>
 ```
+
+Signal forms with automatic error messages
+
+```typescript
+model = signal({ email: '' });
+emailForm = form(this.model, (schemaPath) => {
+  required(schemaPath.email, { message: 'Email is required.' });
+  minLength(schemaPath.email, 5, { message: 'At least 5 characters.' });
+});
+```
+
+```html
+<ga-form-field>
+  <ga-label>Email</ga-label>
+  <input gaFormControl gaInput [formField]="emailForm.email" />
+  <!-- No gaError templates needed — messages from validators are used automatically -->
+</ga-form-field>
+```

package/docs/input.md

@@ -14,7 +14,7 @@ Export: `gaInput`
 
 - `id: string` - Element ID (default: auto-generated)
 - `disabled: boolean` - Disabled state
-- `invalid: boolean` - Invalid state styling
+- `inError: boolean` - Manually overrides the error state. When omitted, derived from the form control (e.g. NgControl or signal forms)
 
 ### Methods
 

package/docs/radio.md

@@ -32,7 +32,8 @@ Individual radio button component.
 - `aria-label: string | null` - Accessibility label
 - `aria-labelledby: string | null` - ID of labelling element
 - `aria-describedby: string | null` - ID of describing element
-- `aria-invalid: string | null` - Invalid state for accessibility
+- `inError: boolean | null` - Manually overrides the error state. When omitted, derived from the form control (e.g. NgControl or signal forms) (default: null)
+- `aria-invalid: boolean | null` - Overrides the error state, takes precedence over `inError` (default: null)
 - `aria-errormessage: string | null` - ID of error message element
 
 ### Outputs

package/docs/select.md

@@ -13,7 +13,7 @@ Select component with dropdown functionality.
 - `value: any` - Selected value (single/multiple)
 - `placeholder: string` - Placeholder text
 - `disabled: boolean` - Disabled state (default: false)
-- `invalid: boolean` - Invalid state (default: null, derived from form control)
+- `inError: boolean` - Manually overrides the error state. When omitted, derived from the form control (e.g. NgControl or signal forms) (default: null)
 - `multiple: boolean` - Enable multiple selection (default: false)
 - `searchable: boolean` - Enable search functionality (default: false)
 - `searchInputLabel: string | null` - Label for search input (default: null)

package/docs/switch.md

@@ -17,7 +17,8 @@ Switch component for boolean toggle controls.
 - `aria-labelledby: string | null` - ID of labelling element (default: null)
 - `aria-describedby: string | null` - ID of describing element (default: null)
 - `aria-errormessage: string | null` - ID of error message element (default: null)
-- `aria-invalid: string | null` - Invalid state for accessibility (default: null)
+- `aria-invalid: boolean | null` - Manually marks the control as invalid (default: null)
+- `inError: boolean | null` - Manually overrides the error state. When omitted, derived from the form control (e.g. NgControl or signal forms) (default: null)
 
 ### Outputs
 

package/docs/text-area.md

@@ -12,7 +12,7 @@ Applies Gaia styling to textarea elements with automatic form field integration.
 
 - `id: string` - Custom ID for the textarea (default: auto-generated)
 - `disabled: boolean` - Whether the textarea is disabled (default: false)
-- `invalid: boolean` - Whether the textarea is in an invalid state (auto-set from NgControl)
+- `inError: boolean` - Manually overrides the error state. When omitted, derived from the form control (e.g. NgControl or signal forms)
 
 ## Examples