fold-ng 0.23.0 → 0.25.0

package/CHANGELOG.md

@@ -8,6 +8,71 @@ All notable changes to **fold-ng** are documented here. The format follows
 
 _Nothing yet._
 
+## [0.25.0] - 2026-09-05
+
+### Added
+
+- **`fold-search` devient un contrôle, et non plus un capteur.** Sa `value` est
+  un `model()` : la boîte se pilote donc de l'extérieur. C'est ce qui manquait
+  pour qu'elle remplace une recherche écrite à la main — choisir un filtre
+  ailleurs doit pouvoir VIDER le champ, et une recherche en écriture seule
+  continuait d'afficher un terme que les résultats n'honoraient plus.
+
+  Deux façons de s'en servir, et elles répondent à deux questions : `[(value)]`
+  donne le terme comme **état**, à chaque frappe — c'est ce que veut un filtrage
+  d'un tableau déjà en mémoire, où l'anti-rebond n'ajoute que de la latence ;
+  `(searchChange)` le donne comme **événement**, une fois posé — c'est ce que
+  veut une requête au serveur. Les deux se composent. Écrire `value` de
+  l'extérieur n'émet jamais : celui qui écrit sait déjà.
+
+- **`fold-search` porte enfin sa loupe, sa croix et son compte.** Les trois
+  étaient recopiés dans chaque écran, avec le même oubli à chaque fois : le
+  compte de résultats change sous une recherche, donc il doit être **annoncé**.
+  Il porte `role="status"` et `aria-live="polite"`, et un utilisateur qui ne
+  voit pas la grille apprend enfin que quatre cents lignes sont devenues trois.
+
+  `resultCount` (rien tant qu'il vaut `null`), `resultLabel` (le mot après le
+  nombre — « pièces », "rows") et `placement` : `top`, `end` ou `bottom`.
+  `end` et non `right` — la bibliothèque se pose en propriétés **logiques**, et
+  le compte doit suivre le sens de lecture plutôt qu'un côté de l'écran.
+
+- **`fold-input` gagne deux affixes**, et c'est de là que `fold-search` tire les
+  siens : `leadingIcon` dessine un glyphe DANS la boîte, avant le texte (le
+  champ réserve la place lui-même, et le glyphe ne prend pas le clic) ;
+  `clearable` + `clearLabel` posent un `×` de fin tant qu'il y a quelque chose à
+  effacer, qui vide la valeur **et rend le focus** — sans quoi il faut un second
+  clic pour reprendre la saisie.
+
+  Les deux sont à `false` par défaut : un champ de formulaire qui s'efface tout
+  seul invite l'accident qu'il ne sait pas défaire. Le `×` ne paraît ni en
+  lecture seule ni désactivé — il promettrait un geste que le contrôle refuse —
+  et un mot de passe `revealable` garde la place de fin : perdre son œil casse
+  la saisie, perdre la croix la rend seulement moins commode.
+
+## [0.24.0] - 2026-08-29
+
+### Added
+
+- **`FoldTableColumn.numeric`** — la colonne tient des NOMBRES, et deux choses
+  suivent : chiffres tabulaires et alignement à droite. C'est la même chose dite
+  deux fois, d'où un drapeau et non deux propriétés — des chiffres
+  proportionnels alignés à droite ne s'alignent toujours pas sous eux-mêmes, et
+  des chiffres tabulaires en drapeau à gauche perdent leur raison d'être.
+
+  Une colonne de montants en chiffres proportionnels oblige l'œil à lire chaque
+  ligne au lieu de balayer la colonne — ce qui est la seule raison de mettre des
+  nombres dans un tableau. L'en-tête suit sans qu'on le lui dise ; un `align`
+  écrit à la main gagne toujours.
+
+### Docs
+
+- **`FoldTableColumn.cellClass` dit enfin où sa classe atterrit** : sur le
+  `<td>` de la table, qui porte l'encapsulation de la TABLE. Les styles de
+  composant du consommateur ne l'atteignent donc jamais — seule une classe
+  globale y fait quelque chose. Pour habiller une cellule depuis sa propre
+  feuille de style, il faut projeter un `<ng-template foldCell>` : ce qu'il rend
+  appartient au consommateur, attribut compris.
+
 ## [0.23.0] - 2026-08-29
 
 ### Added
@@ -2390,7 +2455,9 @@ design-token stylesheet.
   `currentColor`; `prefers-reduced-motion` + `forced-colors` are respected;
   strings localise via inputs / providers (`provideFoldPanelLabels`).
 
-[unreleased]: https://github.com/hugoheynard/fold-ng/compare/v0.23.0...HEAD
+[unreleased]: https://github.com/hugoheynard/fold-ng/compare/v0.25.0...HEAD
+[0.25.0]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.25.0
+[0.24.0]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.24.0
 [0.23.0]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.23.0
 [0.22.1]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.22.1
 [0.22.0]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.22.0

package/README.md

@@ -353,7 +353,7 @@ ships it.
 | `FoldFieldsetComponent`                                  | `fold-fieldset`                        | Named group of controls — a real `<fieldset>`/`<legend>` with the browser's margin/padding/3D border undone and the rhythm on tokens. `disabled` disables every control inside (the element's unique power); `hint` wired through `aria-describedby` (`hintPosition` `under`/`inline`); `legend` (empty renders none) or `ariaLabel`; `optional` marks the whole group (not each member); `legendVariant` (`eyebrow`/`heading` — the same two registers as a page-section's title), `direction` (`vertical`/`horizontal`), `appearance` (`plain`/`border`); `--fold-fieldset-gap`.                                                                                                                                                                          |
 | `FoldPasswordFieldComponent`                             | `fold-password-field`                  | Password input + a live requirements checklist (a dot/tick per rule). Rules injected via `FoldPasswordRule` (`{ label, test }` — regex/zod/anything); `revealable` eye (a `fold-input` capability); `marker` dot/check; `[rules]` slot to redesign the list; `validChange`; Signal Forms.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `FoldViewToggleComponent`                                | `fold-view-toggle`                     | Segmented single-select (Cards/Table, density, chart-mode…). Generic `options` (`{ value, icon?, label?, ariaLabel?, disabled? }`) + `[(value)]`; a real `role="radiogroup"` — roving tabindex, arrow keys, Home/End, disabled-skip; `size`, `iconOnly`, `activeStyle` (raised / accent).                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `FoldSearchComponent`                                    | `fold-search`                          | Debounced search box — an `fold-input` that emits `searchChange` once typing settles (`delayMs`), trimmed + de-duplicated.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `FoldSearchComponent`                                    | `fold-search`                          | Search box — magnifier, clear `×`, optional announced result count (`resultCount` / `resultLabel` / `placement`). `[(value)]` is the term as state (every keystroke); `searchChange` emits it once typing settles (`delayMs`), trimmed + de-duplicated.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | `FoldListboxComponent` / `FoldOptionComponent`           | `fold-listbox` / `fold-option`         | Styleable single-select — the richer sibling of `fold-select` (native `<select>`) for options that need custom rows (icon, second line, status). On `fold-popover`; `role="listbox"` + `aria-activedescendant`, full keyboard (↑/↓, `Home`/`End`, type-ahead, `Enter`). Signal Forms (`FormValueControl<string>`, `[formField]`/`[(value)]`); shares `fold-input`'s box chrome.                                                                                                                                                                                                                                                                                                                                                                             |
 | `FoldMultiselectComponent`                               | `fold-multiselect`                     | Multi-select sibling of `fold-listbox` (same popover + `fold-option` rows). Value is a set (`readonly string[]`); activating a row toggles it and the panel stays open. Separate component — not a `multiple` flag — so the Signal-Forms value type stays honest. `role="listbox"` + `aria-multiselectable`; the trigger summarises the picks.                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `FoldOptgroupComponent`                                  | `fold-optgroup`                        | Labelled group of `<fold-option>`s inside a `fold-listbox` / `fold-multiselect` — the styleable `<optgroup>`. Presentational: `role="group"` + `aria-labelledby` header (no `role="option"`, so keyboard nav skips it); the owner discovers grouped options in document order, so roving crosses groups seamlessly.                                                                                                                                                                                                                                                                                                                                                                                                                                         |