ng-hub-ui-forms 22.25.0 → 22.27.0

package/README.md

@@ -92,7 +92,7 @@ mode — no Bootstrap dependency.
 
 ## 🎯 Features
 
-- **Fields** — `hub-input` (text/number/email/password/color/switch/checkbox/counter, with input-group addons & masks, projected in-field affixes, a built-in `clearable` button and debounced typeahead `search`; the `file` format is **deprecated** → use `hub-file-input`), `hub-otp-input`, `hub-textarea` (+ `hubAutoresize`), `hub-slider` (single / dual thumb, gradient fill), `hub-segmented` (segmented control field — single & multiple selection, horizontal & vertical, with label + validation), `hub-select` (dropdown format, grouping, client-side search via `searchable` **and** server-side async typeahead via a `typeahead` Subject, tag creation with `addTag`, custom templates, `prepend` / `append` group addons and attached icons/buttons via `hubPrepend` / `hubAppend`; the `buttons` / `checkbox` / `radio` formats are **deprecated** → use `hub-segmented`), `hub-datepicker` (single & range at any granularity from a year to a second, time picking, min/max down to the minute, keyboard nav, i18n), `hub-file-input` (drag & drop, clipboard paste, type/size limits, previews, optional upload progress).
+- **Fields** — `hub-input` (text/number/email/password/color/switch/checkbox/counter, with input-group addons & masks, projected in-field affixes, a built-in `clearable` button, the mixed `indeterminate` state on checkboxes and debounced typeahead `search`; the `file` format is **deprecated** → use `hub-file-input`), `hub-otp-input`, `hub-textarea` (+ `hubAutoresize`), `hub-slider` (single / dual thumb, gradient fill), `hub-segmented` (segmented control field — single & multiple selection, horizontal & vertical, with label + validation), `hub-select` (dropdown format, grouping, client-side search via `searchable` **and** server-side async typeahead via a `typeahead` Subject, tag creation with `addTag`, custom templates, `prepend` / `append` group addons and attached icons/buttons via `hubPrepend` / `hubAppend`; the `buttons` / `checkbox` / `radio` formats are **deprecated** → use `hub-segmented`), `hub-datepicker` (single & range at any granularity from a year to a second, time picking, min/max down to the minute, keyboard nav, i18n), `hub-file-input` (drag & drop, clipboard paste, type/size limits, previews, optional upload progress).
 - **Automatic error display** — bind a field and its control errors render below it; `hub-fieldset`, `form[hubForm]` and `hub-legend` surface group- and form-level (cross-field) errors the same way, with zero wiring.
 - **Containers** — `hub-fieldset` / `form[hubForm]` group fields and show their group errors; `hub-legend` renders an accessible legend.
 - **Configurable** — `provideHubForms({ … })` sets the invalid-feedback templates, datepicker locale/labels, file-input labels and more, app-wide or per instance.
@@ -179,6 +179,7 @@ Project a leading / trailing icon **inside** the field, emit a debounced term on
 ```
 
 - Project a `<hub-icon>` (or any element) into `hubInputPrefix` / `hubInputSuffix`; the field themes it with its `--hub-input-icon-*` tokens.
+- `[(indeterminate)]` puts a `checkbox` in the mixed state — the honest answer for a "select all" over a partially selected list. It reflects the native DOM property, so it is announced as mixed, and it is two-way: clicking a mixed checkbox picks a side, so the component clears it and tells you. The `switch` format ignores it.
 - `[clearable]` renders an internal ✕ button once the field holds a value — it resets the control and emits an empty `search` term (no manual suffix wiring). The glyph is the swappable `--hub-input-clear-icon` token.
 - The control reserves inline padding automatically so its text never sits under the affix.
 - Affixes use logical CSS properties, so `start`/`end` follow the writing direction and **flip automatically under `dir="rtl"`**.
@@ -258,8 +259,8 @@ one place: `--hub-field-floating-inset` (how far the value drops), `--hub-field-
 #### Addons and attached content
 
 `prepend` / `append` are group addons carrying **text** — a currency, a unit, a protocol.
-Available on `hub-input`, `hub-select`, `hub-textarea` and `hub-datepicker`: every field that
-renders as a box with a value.
+Available on `hub-input`, `hub-select`, `hub-textarea`, `hub-datepicker` and `hub-timepicker`:
+every field that renders as a box with a value.
 
 ```html
 <hub-input formControlName="amount" label="Amount" prepend="€" append=".00" />
@@ -299,8 +300,8 @@ reader put it back together on every row.
 </hub-input>
 ```
 
-`hub-input`, `hub-select`, `hub-textarea` and `hub-datepicker` are the four that close flush, and
-only as a **direct child** of the template — wrap one in a `<div>` and it falls back to the
+`hub-input`, `hub-select`, `hub-textarea`, `hub-datepicker` and `hub-timepicker` are the five that
+close flush, and only as a **direct child** of the template — wrap one in a `<div>` and it falls back to the
 treatment an action gets.
 
 Whatever is projected wears the field's border, radius and height rather than its own, so a