@arsedizioni/ars-utils 22.5.16 → 22.5.18

package/types/arsedizioni-ars-utils-clipper.ui.d.ts

@@ -1,3 +1,4 @@
+import * as _angular_forms_signals from '@angular/forms/signals';
 import * as _angular_core from '@angular/core';
 import { DestroyRef, ChangeDetectorRef } from '@angular/core';
 import { ScrollDispatcher } from '@angular/cdk/scrolling';
@@ -471,11 +472,57 @@ declare class ClipperSearchResultManager extends ClipperDocumentManager {
      * @param id - The storage key to read from.
      * @param storage - The Web Storage instance to use. Defaults to `sessionStorage`.
      */
+    /**
+     * Hook invoked just before the component state is serialised by save().
+     * Subclasses that keep a separate form model can commit it to filterParams here.
+     */
+    protected onStateSaving(): void;
+    /**
+     * Hook invoked after restore() has fully re-hydrated filterParams.
+     * Subclasses that keep a separate form model can rebuild it from filterParams here.
+     */
+    protected onStateRestored(): void;
     restore(id: string, storage?: Storage): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperSearchResultManager, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperSearchResultManager, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Shape of the browser filter-pane form model. Text fields use '' when empty,
+ * numeric/select/date fields use null, list fields use null — never undefined,
+ * because signal forms only create child fields for defined values.
+ */
+interface BrowserFilterModel {
+    modules: NameValueItem<ClipperModule>[] | null;
+    tags: NameValueItem<string>[] | null;
+    topics: NameValueItem<string>[] | null;
+    sectors: NameValueItem<string>[] | null;
+    authors: NameValueItem<string>[] | null;
+    channels: NameValueItem<any>[] | null;
+    number: string;
+    year: number | null;
+    from: Date | null;
+    to: Date | null;
+    text: string;
+    titleOnly: boolean;
+    showNotAbrogatedDocumentsOnly: boolean;
+    showCommentedDocumentsOnly: boolean;
+    showUnreadDocumentsOnly: boolean;
+    sourceNumber: string;
+    sourceYear: number | null;
+    sourceFrom: Date | null;
+    sourceTo: Date | null;
+    source: string | null;
+    author: string | null;
+    type: string | null;
+    changedNumber: string;
+    changedYear: number | null;
+    changedTitle: string;
+    modifierNumber: string;
+    modifierYear: number | null;
+    modifierTitle: string;
+    changeReason: number | null;
+}
 declare class ClipperBrowserComponent extends ClipperSearchResultManager {
     readonly filterByNumber: _angular_core.Signal<MatInput>;
     readonly filterByText: _angular_core.Signal<MatInput>;
@@ -567,9 +614,46 @@ declare class ClipperBrowserComponent extends ClipperSearchResultManager {
      * Falls back to all modules when `selectableModules` is empty or null.
      */
     protected readonly filteredModules: _angular_core.Signal<NameValueItem<ClipperModule>[]>;
-    protected interval: DateInterval;
-    protected sourceInterval: DateInterval;
     protected user: ClipperUserInfo | undefined;
+    /**
+     * Model backing the filter-pane signal form. This is the single source of truth
+     * for every filter value bound in the template; `filterParams` only carries the
+     * assembled query DTO (see syncParams/loadFilter). Empty values are '' / null /
+     * false / null-array — never undefined, so every child field exists.
+     */
+    protected readonly filterModel: _angular_core.WritableSignal<BrowserFilterModel>;
+    /**
+     * Signal form for the filter pane. The four year fields accept values from 1750
+     * (previously the native min attribute on the inputs).
+     */
+    protected readonly filterForm: _angular_forms_signals.FieldTree<BrowserFilterModel, string | number, "writable">;
+    /** Root signal form for the sort-mode button selector. */
+    protected readonly sortForm: _angular_forms_signals.FieldTree<NameValueItem<ClipperSort>, string | number, "writable">;
+    /** Debounced stream of keyup events on the interval inputs (shorthand typing support). */
+    private readonly intervalKeyup;
+    /**
+     * Applies a partial update to the filter model.
+     * @param patch - The fields to change.
+     */
+    private patchFilter;
+    /**
+     * Blocks the space key on the interval inputs; it is reserved as the
+     * "copy the other bound" shortcut handled by onIntervalKeyup.
+     * @param event - The keydown event from a start or end date input.
+     */
+    protected onIntervalKeydown(event: KeyboardEvent): void;
+    /**
+     * Forwards keyup events of the interval inputs to the debounced shorthand parser.
+     * @param event  - The keyup event from a start or end date input.
+     * @param source - `true` when the event comes from the source-publication range.
+     * @param end    - `true` when the event comes from an end-date input.
+     */
+    protected onIntervalKeyup(event: KeyboardEvent, source: boolean, end: boolean): void;
+    /**
+     * Clears one of the two publication ranges.
+     * @param source - `true` to clear the source-publication range.
+     */
+    protected clearInterval(source?: boolean): void;
     private _viewReady;
     constructor();
     /**
@@ -638,8 +722,29 @@ declare class ClipperBrowserComponent extends ClipperSearchResultManager {
      */
     protected clearFilter(): void;
     /**
-   * Load selected filter
-   */
+     * Copies the filter model into `filterParams`, normalizing empty values back
+     * to the undefined-based convention of ClipperSearchParams.
+     */
+    private syncParams;
+    /**
+     * Commits the form model to filterParams before the component state is serialised.
+     */
+    protected onStateSaving(): void;
+    /**
+     * Rebuilds the form model from filterParams after a state restore.
+     * The publication intervals are intentionally not rebuilt from fromDate/toDate,
+     * matching the historical behavior where the range inputs were not restored.
+     */
+    protected onStateRestored(): void;
+    /**
+     * Builds a DateInterval for the publication range of the current model.
+     * @param source - When true, uses the source-publication range instead.
+     * @returns The interval, with raw (non-normalized) bounds.
+     */
+    private modelInterval;
+    /**
+     * Load selected filter
+     */
     private loadFilter;
     /**
     * Apply current filter params
@@ -1226,11 +1331,16 @@ interface SearchFreeTextQueryParams {
 declare class ClipperSearchFreeTextQueryBuilderComponent {
     readonly done: _angular_core.OutputEmitterRef<SearchFreeTextQueryParams>;
     private readonly dialogService;
-    protected queryAnd: string;
-    protected queryOr: string;
-    protected queryNot: string;
-    protected queryPhrase: string;
-    protected queryStart: string;
+    /** Model backing the signal form: one entry per query operator field. */
+    private readonly model;
+    /** Signal form for the query fields; every field is capped at 200 characters. */
+    protected readonly form: _angular_forms_signals.FieldTree<{
+        queryPhrase: string;
+        queryAnd: string;
+        queryOr: string;
+        queryStart: string;
+        queryNot: string;
+    }, string | number, "writable">;
     /**
      * Resets all query fields to empty strings.
      */

package/types/arsedizioni-ars-utils-core.validators.d.ts

@@ -1,5 +1,6 @@
 import * as i0 from '@angular/core';
 import { Validator, AbstractControl, ValidationErrors } from '@angular/forms';
+import { PathKind, SchemaPath, SchemaPathRules } from '@angular/forms/signals';
 
 /**
  * Directive that delegates validation to an externally provided validator function.
@@ -265,4 +266,54 @@ declare class NotEmptyValidatorDirective implements Validator {
     static ɵdir: i0.ɵɵDirectiveDeclaration<NotEmptyValidatorDirective, "[notEmpty]", never, {}, {}, never, never, true, never>;
 }
 
-export { EmailsValidatorDirective, EqualsValidatorDirective, FileSizeValidatorDirective, GuidValidatorDirective, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, SqlDateValidatorDirective, TimeValidatorDirective, UrlValidatorDirective, ValidIfDirective, ValidatorDirective };
+/**
+ * Signal-forms counterparts of the classic validator directives in this entry point.
+ *
+ * The `[formField]` directive only honours `NG_VALIDATORS` providers on ControlValueAccessor
+ * hosts (custom controls); on native inputs the attribute directives (`password`, `emails`,
+ * `time`, `equals`) are ignored. Schemas built with `form()` must therefore use these
+ * functions instead. Error kinds and messages match the directive versions one to one.
+ */
+/**
+ * Binds a validator requiring the value to be a semicolon-separated list of valid
+ * email addresses. An empty value is considered valid (pair with `required` if needed).
+ * Signal-forms counterpart of `EmailsValidatorDirective`.
+ * @param path - Path of the string field to validate.
+ */
+declare function emailsValidator<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>): void;
+/**
+ * Binds a validator requiring the value to meet the minimum password-strength
+ * requirements (see `SystemUtils.calculatePasswordStrength`). An empty value is
+ * INVALID, exactly like the classic directive.
+ * Signal-forms counterpart of `PasswordValidatorDirective`.
+ * @param path - Path of the string field to validate.
+ */
+declare function passwordValidator<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>): void;
+/**
+ * Binds a validator requiring the value to be a valid `"HH:MM"` time string and,
+ * when slots are provided, to fall within at least one of the allowed ranges.
+ * An empty value is considered valid (pair with `required` if needed).
+ * Signal-forms counterpart of `TimeValidatorDirective`.
+ * @param path  - Path of the string field to validate.
+ * @param slots - Optional reactive function returning the pipe-separated allowed
+ *                ranges (e.g. `"08:00-12:00|14:00-18:00"`), or `undefined` for none.
+ */
+declare function timeValidator<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, slots?: () => string | undefined): void;
+/**
+ * Binds a validator requiring the value to strictly equal the value of another field
+ * of the same form. Reactive on both fields, so the host field re-validates when the
+ * other field changes (this replaces the `valueChanges` subscription of the directive).
+ * Signal-forms counterpart of `EqualsValidatorDirective`.
+ * @param path  - Path of the field to validate.
+ * @param other - Path of the field whose value must match.
+ */
+declare function equalsValidator<TValue, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, other: SchemaPath<TValue, SchemaPathRules.Supported>): void;
+/**
+ * Binds a validator requiring the value to be either empty or a complete 6-digit
+ * OTP code. A partial code (e.g. `"12"`) is invalid; emptiness is left to `required`.
+ * Schema-level counterpart of the `OtpInputComponent` internal validator.
+ * @param path - Path of the string field to validate.
+ */
+declare function otpValidator<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>): void;
+
+export { EmailsValidatorDirective, EqualsValidatorDirective, FileSizeValidatorDirective, GuidValidatorDirective, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, SqlDateValidatorDirective, TimeValidatorDirective, UrlValidatorDirective, ValidIfDirective, ValidatorDirective, emailsValidator, equalsValidator, otpValidator, passwordValidator, timeValidator };

package/types/arsedizioni-ars-utils-ui.controls.d.ts

@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
 import { OnDestroy } from '@angular/core';
 import { ControlValueAccessor, NgControl } from '@angular/forms';
 import { NameValueItem, INode } from '@arsedizioni/ars-utils/core';
+import * as _angular_forms_signals from '@angular/forms/signals';
 
 declare class ButtonSelectorComponent implements OnDestroy, ControlValueAccessor {
     ngControl: NgControl;
@@ -196,10 +197,18 @@ declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor
     private propagateTouched;
     private readonly renderer;
     private readonly cdr;
-    /** Currently selected items (may contain multiple entries when `multiple` is `true`). */
-    protected selection: NameValueItem<any>[];
+    /**
+     * Currently selected items. Kept loosely typed on purpose: in multi-select mode the
+     * bound controls write an array, while in single-select mode mat-select / the chip
+     * listbox write a single item; `getSelection()` normalizes both shapes.
+     */
+    protected readonly selection: _angular_core.WritableSignal<any>;
     /** The single selected item — used in `button` collapsed-display mode. */
-    protected singleSelection?: NameValueItem<any>;
+    protected readonly singleSelection: _angular_core.WritableSignal<NameValueItem<any>>;
+    /** Root signal form bound to the internal mat-select / chip listbox. */
+    protected readonly selectionForm: _angular_forms_signals.FieldTree<any, string | number, "writable">;
+    /** Root signal form bound to the internal button-selector in `button` collapsed mode. */
+    protected readonly singleForm: _angular_forms_signals.FieldTree<NameValueItem<any>, string | number, "writable">;
     constructor(ngControl: NgControl);
     ngOnDestroy(): void;
     /**
@@ -214,7 +223,8 @@ declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor
      */
     private getSelection;
     /**
-     * Schedules a value update after a short delay, giving the template time to sync `ngModel`.
+     * Schedules a value update after a short delay, coalescing rapid selection changes
+     * before the value is propagated to the outer form.
      */
     updateValue(): void;
     /**
@@ -319,6 +329,8 @@ declare class TreePickerComponent {
     private _isSelectableNode;
     /** Current filter text. */
     protected readonly filterText: _angular_core.WritableSignal<string>;
+    /** Root signal form bound to the filter text input. */
+    protected readonly filterForm: _angular_forms_signals.FieldTree<string, string | number, "writable">;
     /** Nodes matching the current filter text, in nodeMap iteration order. */
     protected readonly filteredItems: _angular_core.WritableSignal<INode[]>;
     /** Index of the currently highlighted filtered node (-1 = none). */

package/types/arsedizioni-ars-utils-ui.dialogs.auth.d.ts

@@ -1,7 +1,8 @@
 import * as _angular_core from '@angular/core';
 import { ElementRef } from '@angular/core';
-import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors, NgForm } from '@angular/forms';
+import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
 import { PasswordStrength } from '@arsedizioni/ars-utils/core';
+import * as _angular_forms_signals from '@angular/forms/signals';
 import { CredentialsDialogResult, ResetPasswordDialogResult, RecoverPasswordDialogResult, PromptOtpDialogResult, PromptDialogData } from '@arsedizioni/ars-utils/ui';
 import { MatFormFieldAppearance } from '@angular/material/form-field';
 
@@ -129,8 +130,15 @@ declare class CredentialsDialogComponent {
     readonly recoveringPassword: _angular_core.OutputEmitterRef<CredentialsDialogResult>;
     /** Dialog configuration with defaults applied at construction time. */
     protected readonly dialogData: _angular_core.WritableSignal<CredentialsDialogData>;
-    /** Current form model, pre-filled with the user name from dialog data when provided. */
-    protected item: CredentialsDialogResult;
+    /** Model backing the signal form, pre-filled with the user name from dialog data when provided. */
+    private readonly model;
+    /**
+     * Signal form for the credentials. Validators follow the active mode: the user
+     * field is a required email in `email` mode and plain required in `user` mode,
+     * the password is required outside `otp` mode, and the OTP code is a required
+     * complete 6-digit code in `otp` mode.
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<CredentialsDialogResult, string | number, "writable">;
     /** Whether the password field is currently shown as plain text. */
     protected readonly showPassword: _angular_core.WritableSignal<boolean>;
     /**
@@ -167,8 +175,16 @@ declare class ResetPasswordDialogComponent {
     private readonly dialogRef;
     /** Dialog configuration with defaults applied at construction time. */
     protected readonly dialogData: _angular_core.WritableSignal<ResetPasswordDialogData>;
-    /** Current form model bound to the template inputs. */
-    protected item: ResetPasswordDialogResult;
+    /** Model backing the signal form. */
+    private readonly model;
+    /**
+     * Signal form for the password reset. Validators follow the active mode:
+     * the email is required in `forgot` mode, the old password in `old` mode,
+     * a complete 6-digit OTP code in `otp` mode; the new password is always
+     * required, at least 10 characters and strong enough, and its confirmation
+     * (required outside `admin` mode) must match it.
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<ResetPasswordDialogResult, string | number, "writable">;
     /** Whether the old-password field is currently shown as plain text. */
     protected readonly showOldPassword: _angular_core.WritableSignal<boolean>;
     /** Whether the new-password field is currently shown as plain text. */
@@ -196,8 +212,12 @@ declare class RecoverPasswordDialogComponent {
     readonly done: _angular_core.OutputEmitterRef<RecoverPasswordDialogResult>;
     /** Dialog configuration with defaults applied at construction time. */
     protected readonly dialogData: _angular_core.WritableSignal<RecoverPasswordDialogData>;
-    /** Current form model bound to the template inputs. */
-    protected item: RecoverPasswordDialogResult;
+    /** Model backing the signal form. */
+    private readonly model;
+    /**
+     * Signal form for the recovery request: the email is required and must be valid.
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<RecoverPasswordDialogResult, string | number, "writable">;
     /**
      * Emits the current form result to trigger the password-recovery flow.
      */
@@ -207,11 +227,19 @@ declare class RecoverPasswordDialogComponent {
 }
 
 declare class PromptOtpDialogComponent {
-    readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<PromptOtpDialogResult>;
     private readonly dialogService;
     protected readonly dialogData: _angular_core.WritableSignal<PromptDialogData>;
-    protected value: any;
+    /** Model backing the signal form. `value` holds the 6-digit OTP code. */
+    private readonly model;
+    /**
+     * Signal form for the OTP code. The code is always required here; the
+     * "complete 6 digits" rule comes from the OtpInputComponent validator,
+     * honoured through the ControlValueAccessor interop.
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<{
+        value: string;
+    }, string | number, "writable">;
     /**
      * Validates the form and emits the OTP result, or shows an error if validation fails.
      */

package/types/arsedizioni-ars-utils-ui.dialogs.d.ts

@@ -1,9 +1,10 @@
-import * as _angular_core from '@angular/core';
+import * as i0 from '@angular/core';
 import { ComponentType } from '@angular/cdk/portal';
 import { MatDialogConfig, MatDialogRef } from '@angular/material/dialog';
 import { MatSnackBarRef } from '@angular/material/snack-bar';
 import { ShellService } from '@arsedizioni/ars-utils/ui.shell';
 import { DialogResult, DialogOption } from '@arsedizioni/ars-utils/ui';
+import * as _angular_forms_signals from '@angular/forms/signals';
 import { MatFormFieldAppearance } from '@angular/material/form-field';
 
 interface ConfirmDialogOption extends DialogOption {
@@ -19,10 +20,10 @@ interface ConfirmDialogData {
 }
 declare class ConfirmDialogComponent {
     /** Emitted when the user makes a choice. Carries the selected result and any option state. */
-    readonly choosen: _angular_core.OutputEmitterRef<DialogResult>;
+    readonly choosen: i0.OutputEmitterRef<DialogResult>;
     private readonly dialogRef;
     /** Dialog configuration, with sensible defaults applied at construction time. */
-    protected readonly dialogData: _angular_core.WritableSignal<ConfirmDialogData>;
+    protected readonly dialogData: i0.WritableSignal<ConfirmDialogData>;
     constructor();
     /**
      * Confirms the dialog, emitting `'ok'` together with the current option selections.
@@ -36,8 +37,8 @@ declare class ConfirmDialogComponent {
      * Triggers the tertiary action, emitting `'other'`.
      */
     other(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConfirmDialogComponent, "ng-component", never, {}, { "choosen": "choosen"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConfirmDialogComponent, "ng-component", never, {}, { "choosen": "choosen"; }, never, never, true, never>;
 }
 
 declare enum DeleteDialogConfirmMode {
@@ -56,17 +57,24 @@ interface DeleteDialogData {
 }
 declare class DeleteDialogComponent {
     /** Emitted when the user makes a choice. Carries the selected result. */
-    readonly choosen: _angular_core.OutputEmitterRef<DialogResult>;
+    readonly choosen: i0.OutputEmitterRef<DialogResult>;
     private readonly dialogRef;
     /** Dialog configuration with defaults applied at construction time. */
-    protected readonly dialogData: _angular_core.WritableSignal<DeleteDialogData>;
+    protected readonly dialogData: i0.WritableSignal<DeleteDialogData>;
     /**
-     * Whether the user has confirmed the deletion.
-     * Starts as `true` for all modes except `Simple`, which requires explicit checkbox confirmation.
+     * Model backing the signal form: `confirmed` starts as `true` for all modes
+     * except `Simple`, which requires explicit checkbox confirmation, and
+     * `confirmValue` is the strong-confirmation text.
      */
-    protected readonly confirmed: _angular_core.WritableSignal<boolean>;
-    /** Current value typed into the strong-confirmation text field. */
-    protected confirmValue?: string;
+    private readonly model;
+    /**
+     * Signal form for the confirmation. In `Simple` mode the checkbox must be
+     * checked; in `Strong` mode the text must be exactly the word "elimina".
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<{
+        confirmed: boolean;
+        confirmValue: string;
+    }, string | number, "writable">;
     /**
      * Confirms the deletion, emitting `'ok'` and closing the dialog.
      */
@@ -75,8 +83,8 @@ declare class DeleteDialogComponent {
      * Cancels the operation, emitting `'cancel'` and closing the dialog.
      */
     cancel(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DeleteDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DeleteDialogComponent, "ng-component", never, {}, { "choosen": "choosen"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DeleteDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DeleteDialogComponent, "ng-component", never, {}, { "choosen": "choosen"; }, never, never, true, never>;
 }
 
 interface ToastData {
@@ -86,15 +94,15 @@ interface ToastData {
 }
 declare class ToastComponent {
     /** Emitted when the user clicks the optional action button. */
-    readonly action: _angular_core.OutputEmitterRef<void>;
+    readonly action: i0.OutputEmitterRef<void>;
     /** Snack-bar payload with a safe fallback to an empty message when no data is injected. */
-    protected readonly dialogData: _angular_core.WritableSignal<ToastData>;
+    protected readonly dialogData: i0.WritableSignal<ToastData>;
     /**
      * Emits the `action` event to notify the caller that the action button was clicked.
      */
     protected do(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "ng-component", never, {}, { "action": "action"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToastComponent, "ng-component", never, {}, { "action": "action"; }, never, never, true, never>;
 }
 
 interface IDialogService {
@@ -110,7 +118,7 @@ declare class DialogService extends ShellService {
      * which knows nothing about Material and must not, so the two members every caller uses of
      * `UIService` are re-exposed here.
      */
-    readonly appearance: _angular_core.WritableSignal<"fill" | "outline">;
+    readonly appearance: i0.WritableSignal<"fill" | "outline">;
     /**
      * Updates the global form-field appearance.
      * @param value - The new appearance value. Falls back to `'fill'` when `undefined` is passed.
@@ -220,8 +228,8 @@ declare class DialogService extends ShellService {
      * @returns The dialog reference, or `null` outside the browser.
      */
     delete(message: string, title?: string, confirmMode?: DeleteDialogConfirmMode, okCaption?: string, cancelCaption?: string, width?: number, details?: string): MatDialogRef<DeleteDialogComponent> | null;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DialogService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DialogService>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DialogService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DialogService>;
 }
 
 export { ConfirmDialogComponent, DeleteDialogComponent, DeleteDialogConfirmMode, DialogService, ToastComponent };

package/types/arsedizioni-ars-utils-ui.dialogs.prompt.d.ts

@@ -1,13 +1,20 @@
+import * as _angular_forms_signals from '@angular/forms/signals';
 import * as _angular_core from '@angular/core';
 import { PromptDialogResult, PromptDialogData, PromptDateDialogResult, PromptTimeDialogData } from '@arsedizioni/ars-utils/ui';
-import { NgForm } from '@angular/forms';
 
 declare class PromptDialogComponent {
-    readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<PromptDialogResult>;
     private readonly dialogService;
     protected readonly dialogData: _angular_core.WritableSignal<PromptDialogData>;
-    protected value: any;
+    /** Model backing the signal form. `value` type depends on the prompt type. */
+    private readonly model;
+    /**
+     * Signal form for the prompt value. Validators mirror the previous template-driven
+     * form: `required` follows the dialog data, `min`/`max` apply to the Number type.
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<{
+        value: any;
+    }, string | number, "writable">;
     /**
      * Validates the form and emits the result, or shows an error if validation fails.
      */
@@ -17,11 +24,46 @@ declare class PromptDialogComponent {
 }
 
 declare class PromptDateDialogComponent {
-    readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<PromptDateDialogResult>;
     private readonly dialogService;
     protected readonly dialogData: _angular_core.WritableSignal<PromptDialogData>;
-    protected value: any;
+    /**
+     * Model backing the signal form: `date` serves the single-date type, while
+     * `from`/`to` serve the date-interval type. Empty values are `null` (not
+     * `undefined`) because signal forms only build child fields for keys whose
+     * value is defined, and Material's datepicker accessors report an empty
+     * input as `null` anyway; values are normalized to `undefined` on emit.
+     */
+    private readonly model;
+    /**
+     * Signal form for the date value(s). `required` follows the dialog data and only
+     * applies to the fields of the active prompt type; the datepicker's own parse
+     * validators are picked up through the ControlValueAccessor interop.
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<{
+        date: Date | null;
+        from: Date | null;
+        to: Date | null;
+    }, string | number, "writable">;
+    /** Debounced stream of keyup events on the interval inputs (shorthand typing support). */
+    private readonly intervalKeyup;
+    constructor();
+    /**
+     * Blocks the space key on the interval inputs; it is reserved as the
+     * "copy the other bound" shortcut handled by onIntervalKeyup.
+     * @param event - The keydown event from the start or end date input.
+     */
+    protected onIntervalKeydown(event: KeyboardEvent): void;
+    /**
+     * Forwards keyup events of the interval inputs to the debounced shorthand parser.
+     * @param event - The keyup event from the start or end date input.
+     * @param end   - `true` when the event comes from the end-date input.
+     */
+    protected onIntervalKeyup(event: KeyboardEvent, end: boolean): void;
+    /**
+     * Clears both bounds of the date interval.
+     */
+    protected clearInterval(): void;
     /**
      * Validates the form and emits the result, or shows an error if validation fails.
      */
@@ -31,11 +73,18 @@ declare class PromptDateDialogComponent {
 }
 
 declare class PromptTimeDialogComponent {
-    readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<PromptDialogResult>;
     private readonly dialogService;
     protected readonly dialogData: _angular_core.WritableSignal<PromptTimeDialogData>;
-    protected value: any;
+    /** Model backing the signal form. The value is a `"HH:MM"` time string. */
+    private readonly model;
+    /**
+     * Signal form for the time value: `required` follows the dialog data and the
+     * time validator enforces format and the optional allowed slots.
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<{
+        value: string;
+    }, string | number, "writable">;
     /**
      * Validates the form and emits the result, or shows an error if validation fails.
      */

package/types/arsedizioni-ars-utils-ui.dialogs.select.d.ts

@@ -1,3 +1,4 @@
+import * as _angular_forms_signals from '@angular/forms/signals';
 import * as _angular_core from '@angular/core';
 import { OnDestroy } from '@angular/core';
 import { MatCheckboxChange } from '@angular/material/checkbox';
@@ -31,7 +32,9 @@ declare class SelectDialogComponent {
     protected canPaginate: _angular_core.WritableSignal<boolean>;
     protected okDisabled: _angular_core.WritableSignal<boolean>;
     protected filterMetadata: SearchFilterMetadata;
-    protected filterText: string;
+    protected readonly filterText: _angular_core.WritableSignal<string>;
+    /** Root signal form bound to the filter text input. */
+    protected readonly filterForm: _angular_forms_signals.FieldTree<string, string | number, "writable">;
     protected readonly filterOptions: _angular_core.WritableSignal<SelectableFilter[]>;
     protected filterOptionsInfo: _angular_core.WritableSignal<string>;
     protected lookupField: string;
@@ -190,6 +193,8 @@ declare class SelectTreeDialogComponent {
     protected readonly currentNode: _angular_core.WritableSignal<ItemNode>;
     /** Current filter text. */
     protected readonly filterText: _angular_core.WritableSignal<string>;
+    /** Root signal form bound to the filter text input. */
+    protected readonly filterForm: _angular_forms_signals.FieldTree<string, string | number, "writable">;
     /** Nodes matching the current filter text. */
     protected readonly filteredItems: _angular_core.WritableSignal<ItemNode[]>;
     /** Index of the currently highlighted filtered node (-1 = none). */
@@ -282,11 +287,15 @@ declare class SendToDialogComponent implements ISendToDialog {
     readonly done: _angular_core.OutputEmitterRef<SendToDialogResult>;
     /** Emitted when the user requests to populate the recipient list. */
     readonly populate: _angular_core.OutputEmitterRef<SendToPopulateData>;
-    private readonly cdr;
     /** Dialog configuration, injected and exposed as a signal. */
     protected readonly dialogData: _angular_core.WritableSignal<SendToDialogData>;
-    /** Form model for the send-to form fields. */
-    protected item: SendToDialogResult;
+    /** Model backing the signal form. */
+    private readonly model;
+    /**
+     * Signal form for the send-to fields: recipients (a required, valid,
+     * semicolon-separated email list), subject and text are all required.
+     */
+    protected readonly form: _angular_forms_signals.FieldTree<SendToDialogResult, string | number, "writable">;
     /**
      * Confirm the form and emit the result.
      */

package/types/arsedizioni-ars-utils-ui.files.d.ts

@@ -1,3 +1,4 @@
+import * as _angular_forms_signals from '@angular/forms/signals';
 import * as _angular_core from '@angular/core';
 import { OnDestroy, DoCheck, ElementRef } from '@angular/core';
 import { ControlValueAccessor, NgControl } from '@angular/forms';
@@ -34,10 +35,12 @@ declare class FileInputComponent implements OnDestroy, DoCheck, MatFormFieldCont
     private setValue;
     get value(): FileInfo;
     get size(): any;
-    private _required;
+    /** Backing signal so the internal form schema reacts to `required` changes. */
+    private readonly _required;
     get required(): boolean;
     set required(value: boolean);
-    private _disabled;
+    /** Backing signal so the internal form schema reacts to `disabled` changes. */
+    private readonly _disabled;
     get disabled(): boolean;
     set disabled(value: boolean);
     get placeholder(): string;
@@ -60,6 +63,16 @@ declare class FileInputComponent implements OnDestroy, DoCheck, MatFormFieldCont
     readonly changed: _angular_core.OutputEmitterRef<FileInfo>;
     readonly download: _angular_core.OutputEmitterRef<void>;
     readonly preview: _angular_core.OutputEmitterRef<void>;
+    /** Model backing the internal display form: the (readonly) file-name text. */
+    private readonly nameModel;
+    /**
+     * Internal signal form for the file-name input. It reproduces the previous
+     * template-driven validators: `required` follows the `required` input and the
+     * size rule mirrors FileSizeValidatorDirective (empty name is left to `required`).
+     */
+    protected readonly nameForm: _angular_forms_signals.FieldTree<{
+        name: string;
+    }, string | number, "writable">;
     private propagateChange;
     private propagateTouched;
     constructor(ngControl: NgControl);