ngx-recipe-forms 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-recipe-forms",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "license": "Apache-2.0",
   "description": "Generic recipe-based form engine for Angular Signal Forms, styled with Tailwind",
   "keywords": [

package/types/ngx-recipe-forms.d.ts

@@ -868,6 +868,8 @@ export type RecipeUiTemplateType = RecipeTemplatedControlType | RecipeUiPartEnum
 export interface ResolveMessageInput {
   readonly errors: readonly RecipeValidationError[];
   readonly touched: boolean;
+  /** Valeur changée par la personne (`dirty()` de Signal Forms) ; `reset` la remet à faux. */
+  readonly dirty: boolean;
   readonly submitted: boolean;
   readonly fieldMessages?: Readonly<Partial<Record<string, string>>>;
   readonly recipeMessages?: Readonly<Partial<Record<string, string>>>;
@@ -1092,7 +1094,7 @@ export declare class RecipeLayout {
 }
 /**
  * Résolution des messages. Priorités : champ, puis recette, puis défaut, puis message brut, puis `unknown`.
- * Un champ non touché n'affiche rien avant une tentative de soumission ; seule la première erreur est affichée.
+ * Un champ ni modifié ni touché n'affiche rien avant une tentative de soumission ; seule la première erreur est affichée.
  * Erreur serveur : son `message`, que l'appelant a déjà traduit ; sans message, la clé `errors.<code>`.
  */
 export declare class RecipeMessages {
@@ -1172,7 +1174,7 @@ export declare class RecipeSections {
   /** Clés de chaque section (identifiant → clés), sous-sections comprises ; une section sans champ a une liste vide. */
   static index(nodes: readonly FormNode<AnyModel>[]): ReadonlyMap<string, readonly string[]>;
   /**
-   * Nombre de champs en erreur : champs touchés ou après une tentative de soumission, champs cachés ignorés,
+   * Nombre de champs en erreur : champs modifiés ou touchés, ou après une tentative de soumission, champs cachés ignorés,
    * erreur d'un groupe lié comptée une fois, erreurs serveur comprises.
    */
   static errorCount(input: SectionErrorCountInput): number;
@@ -1409,7 +1411,10 @@ export declare class RecipeFormComponent<TModel extends object> {
   private readonly placedErrors;
   private readonly placedWarnings;
   constructor();
-  /** Après un `reset` du formulaire par l'appelant, les messages redeviennent conditionnés au `touched`. */
+  /**
+   * À appeler après un `reset` du formulaire par l'appelant : les messages restent alors cachés tant que le champ
+   * n'est ni modifié (`dirty`), ni touché, ni soumis.
+   */
   resetSubmitAttempt(): void;
   /** Pas de `submit()` de Signal Forms : il renvoie une Promise, que les règles du dépôt interdisent. */
   protected onSubmit(event: Event): void;
@@ -1514,8 +1519,8 @@ export declare class RecipeNodeComponent {
   /** Les champs d'un contrôle lié sont rendus comme des champs ordinaires, construits à partir du contrôle. */
   protected readonly linkedFieldNodes: Signal<readonly FieldNode<AnyModel, string, AnyModel>[]>;
   /**
-   * L'erreur posée sur `errorTarget` apparaît dès que ce champ est touché, comme la bordure rouge de son wrapper
-   * (`showInvalid` = invalide et touché) ; celle du groupe, quand tous les champs liés ont été touchés.
+   * L'erreur posée sur `errorTarget` apparaît dès que ce champ est modifié ou touché, comme la bordure rouge de son
+   * wrapper (invalide, et modifié ou touché) ; celle du groupe, quand chaque champ lié a été modifié ou touché.
    * Après une soumission, elle apparaît dans les deux cas.
    */
   protected readonly linkedMessage: Signal<FieldMessage | undefined>;
@@ -1918,6 +1923,7 @@ export declare class CheckboxComponent implements FormCheckboxControl {
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly invalid: import("@angular/core").InputSignal<boolean>;
   readonly touched: import("@angular/core").InputSignal<boolean>;
+  readonly dirty: import("@angular/core").InputSignal<boolean>;
   readonly describedBy: import("@angular/core").InputSignal<string | undefined>;
   readonly touch: import("@angular/core").OutputEmitterRef<void>;
   private readonly control;
@@ -1963,6 +1969,11 @@ export declare class CheckboxComponent implements FormCheckboxControl {
       "required": false;
       "isSignal": true;
     };
+    "dirty": {
+      "alias": "dirty";
+      "required": false;
+      "isSignal": true;
+    };
     "describedBy": {
       "alias": "describedBy";
       "required": false;
@@ -1990,6 +2001,7 @@ export declare class DatePickerMultipleComponent implements FormValueControl<rea
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly invalid: import("@angular/core").InputSignal<boolean>;
   readonly touched: import("@angular/core").InputSignal<boolean>;
+  readonly dirty: import("@angular/core").InputSignal<boolean>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   /** Nom du groupe que forme le contrôle (le libellé du champ), posé en `aria-label`. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
@@ -2053,6 +2065,11 @@ export declare class DatePickerMultipleComponent implements FormValueControl<rea
       "required": false;
       "isSignal": true;
     };
+    "dirty": {
+      "alias": "dirty";
+      "required": false;
+      "isSignal": true;
+    };
     "required": {
       "alias": "required";
       "required": false;
@@ -2097,6 +2114,7 @@ export declare class DatePickerComponent implements FormValueControl<Date | null
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly invalid: import("@angular/core").InputSignal<boolean>;
   readonly touched: import("@angular/core").InputSignal<boolean>;
+  readonly dirty: import("@angular/core").InputSignal<boolean>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly describedBy: import("@angular/core").InputSignal<string | undefined>;
   readonly touch: import("@angular/core").OutputEmitterRef<void>;
@@ -2143,6 +2161,11 @@ export declare class DatePickerComponent implements FormValueControl<Date | null
       "required": false;
       "isSignal": true;
     };
+    "dirty": {
+      "alias": "dirty";
+      "required": false;
+      "isSignal": true;
+    };
     "required": {
       "alias": "required";
       "required": false;
@@ -2172,6 +2195,7 @@ export declare class InputNumberComponent implements FormValueControl<number | n
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly invalid: import("@angular/core").InputSignal<boolean>;
   readonly touched: import("@angular/core").InputSignal<boolean>;
+  readonly dirty: import("@angular/core").InputSignal<boolean>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   /** Pas des flèches du clavier ; 1 quand il n'est pas fourni. */
   readonly step: import("@angular/core").InputSignal<number | undefined>;
@@ -2231,6 +2255,11 @@ export declare class InputNumberComponent implements FormValueControl<number | n
       "required": false;
       "isSignal": true;
     };
+    "dirty": {
+      "alias": "dirty";
+      "required": false;
+      "isSignal": true;
+    };
     "required": {
       "alias": "required";
       "required": false;
@@ -2264,7 +2293,7 @@ export declare class InputNumberComponent implements FormValueControl<number | n
 /**
  * Wrapper par défaut d'un champ texte, `FormValueControl<string>`.
  * L'application hôte peut le remplacer par celui de son design system, de même sélecteur et de même contrat
- * (`value`, `disabled`, `invalid`, `touched`, `touch`).
+ * (`value`, `disabled`, `invalid`, `touched`, `dirty`, `touch`).
  */
 export declare class InputTextComponent implements FormValueControl<string> {
   readonly value: import("@angular/core").ModelSignal<string>;
@@ -2274,6 +2303,7 @@ export declare class InputTextComponent implements FormValueControl<string> {
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly invalid: import("@angular/core").InputSignal<boolean>;
   readonly touched: import("@angular/core").InputSignal<boolean>;
+  readonly dirty: import("@angular/core").InputSignal<boolean>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly placeholder: import("@angular/core").InputSignal<string>;
   /** Clavier proposé ; `text` quand il n'est pas fourni. */
@@ -2329,6 +2359,11 @@ export declare class InputTextComponent implements FormValueControl<string> {
       "required": false;
       "isSignal": true;
     };
+    "dirty": {
+      "alias": "dirty";
+      "required": false;
+      "isSignal": true;
+    };
     "required": {
       "alias": "required";
       "required": false;
@@ -2478,6 +2513,7 @@ export declare class SelectComponent<T> implements FormValueControl<T | null> {
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly invalid: import("@angular/core").InputSignal<boolean>;
   readonly touched: import("@angular/core").InputSignal<boolean>;
+  readonly dirty: import("@angular/core").InputSignal<boolean>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly showClear: import("@angular/core").InputSignal<boolean>;
   /**
@@ -2544,6 +2580,11 @@ export declare class SelectComponent<T> implements FormValueControl<T | null> {
       "required": false;
       "isSignal": true;
     };
+    "dirty": {
+      "alias": "dirty";
+      "required": false;
+      "isSignal": true;
+    };
     "required": {
       "alias": "required";
       "required": false;