@arsedizioni/ars-utils 22.5.15 → 22.5.17

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-evolution.common.d.ts

@@ -46,6 +46,20 @@ interface EvolutionLoginResult {
      */
     requiresPasswordChange?: boolean;
 }
+/**
+ * Answer of `GET /session/status`: whether this browser holds a live session towards the Evolution
+ * API.
+ *
+ * This is the probe behind the link state. The auth cookie is HttpOnly and belongs to the API's
+ * host, so nothing here can read it, and its presence would prove nothing anyway — the session also
+ * lives server-side and may have been revoked or evicted. The endpoint never answers 401, which is
+ * what makes it safe to call with no session at all: a probe that failed with a status code would be
+ * reported by the interceptor as an expired session.
+ */
+interface EvolutionSessionStatus {
+    /** True when the cookie this browser presented resolves to a live, validated session. */
+    connected: boolean;
+}
 /**
  * The session as this library holds it, persisted so a page refresh has something to validate.
  *
@@ -957,8 +971,8 @@ declare class LoginService {
      */
     clear(): void;
     /**
-     * Initialises the service with the back-end URI and optional feature flags, and revalidates a
-     * session that survived a page refresh instead of assuming it is still there.
+     * Initialises the service with the back-end URI and optional feature flags, and asks the API — the
+     * only party that can read the HttpOnly cookie — whether this browser still holds a session.
      *
      * Must be called once during application bootstrap, before any other method. What it used to do
      * on a refresh was announce `LOGIN_COMPLETED` on the strength of a value in local storage; the
@@ -1009,6 +1023,15 @@ declare class LoginService {
      * @returns An observable that emits the `ApiResult<EvolutionLoginResult>`.
      */
     confirmIdentity(code: string, email?: string): Observable<ApiResult<EvolutionLoginResult>>;
+    /**
+     * Asks the API whether this browser holds a live session, without ever failing with a 401: the
+     * route is anonymous and answers `connected: false` to a caller with no session. This is the one
+     * honest way to know the link state -- the auth cookie is HttpOnly and belongs to the API's host,
+     * so it cannot be read from here, and its presence would prove nothing anyway, since the session
+     * also lives server-side and may have been revoked or evicted.
+     * @returns An observable that emits the `ApiResult<EvolutionSessionStatus>`.
+     */
+    status(): Observable<ApiResult<EvolutionSessionStatus>>;
     /**
      * Reads the current session from the server, which resolves it from the auth cookie's claims.
      * Used to restore the state after a page refresh instead of trusting what local storage holds.
@@ -1020,13 +1043,17 @@ declare class LoginService {
      */
     me(): Observable<ApiResult<EvolutionLoginResult>>;
     /**
-     * Asks `/session/me` whether the restored session is still alive, and announces the login when it
-     * is.
+     * Asks `/session/status` whether this browser holds a live session, and hydrates the context
+     * through {@link me} when it does.
+     *
+     * The probe is silent by construction: `/session/status` never answers 401, so a visitor who
+     * never signed in -- or a cookie whose session has died -- comes back as `connected: false` with
+     * no error broadcast and no dialog. Only then is the stale stored context cleared, so the
+     * `loggedIn` signal tells the truth at every bootstrap.
      *
-     * Nothing is cleared on failure, and that is deliberate: a failure here is not proof of a dead
-     * session -- the API may be unreachable, the proxy may have answered 502, the device may be
-     * offline -- and clearing on any of those would sign the user out with a perfectly valid cookie.
-     * A genuine 401 is a different matter and the interceptor has already reported it.
+     * Nothing is cleared on a transport failure, and that is deliberate: an unreachable API is not
+     * proof of a dead session -- the proxy may have answered 502, the device may be offline -- and
+     * clearing on any of those would sign the user out with a perfectly valid cookie.
      * @returns void
      */
     private restoreSession;
@@ -1239,8 +1266,9 @@ declare class EvolutionService {
     get user(): EvolutionUserInfo | undefined;
     /**
      * `true` when this browser has a session the API has accepted. It starts from the stored context
-     * and is confirmed -- or left to the interceptor's 401 handling -- by the `/session/me` call
-     * {@link initialize} makes.
+     * and is settled -- raised or cleared -- by the silent `/session/status` probe {@link initialize}
+     * makes, which is the one honest way to read a state that lives in an HttpOnly cookie plus a
+     * server-side lease. This signal IS the link state: bind it, do not poll it.
      */
     get loggedIn(): Signal<boolean>;
     /** `true` while an authentication is in flight. */
@@ -1262,4 +1290,4 @@ declare class EvolutionService {
 }
 
 export { AccountService, ComplianceService, ERPComplianceActivityState, ERPComplianceLawOrigin, ERPComplianceLawState, ERPComplianceLawsSelectionType, ERPComplianceNotificationLimit, ERPComplianceProfileFlags, ERPComplianceProfileRole, ERPComplianceRegisterNotificationType, ERPComplianceRegisterSiteImportOptions, ERPComplianceScope, ERPExportFormat, ERPExportPart, ERPExportSource, ERPExportType, ERPModule, ERPPlace, ERPPlacePermission, ERPRecurrenceFrequencyType, EVOLUTION_ACTIVE_ACCOUNT_KEY, EvolutionComplianceActivityStates, EvolutionComplianceContextInfo, EvolutionComplianceLawChangeStates, EvolutionComplianceLawOrigins, EvolutionComplianceLawStates, EvolutionComplianceNotificationLimits, EvolutionComplianceNotifications, EvolutionComplianceObligationAuthorities, EvolutionComplianceObligationTypes, EvolutionComplianceProfileFlags, EvolutionComplianceProfileRoles, EvolutionComplianceScopes, EvolutionMessages, EvolutionRecurrenceFrequencyTypes, EvolutionService, EvolutionServiceFlags, LoginService, evolutionAuthInterceptor };
-export type { ComplianceRegisterUsersResultModel, EvolutionChangeContextModel, EvolutionChangeContextResultModel, EvolutionComplianceActivitiesAddParams, EvolutionComplianceActivity, EvolutionComplianceLaswExportParams, EvolutionComplianceLaw, EvolutionComplianceLawDocumentInfo, EvolutionComplianceLawReference, EvolutionComplianceLawsAddParams, EvolutionComplianceRegister, EvolutionComplianceRegisterProfile, EvolutionComplianceRegisterSite, EvolutionContextInfo, EvolutionExportModel, EvolutionLicenceModuleInfo, EvolutionLoginInfo, EvolutionLoginResult, EvolutionPermission, EvolutionPlacePermission, EvolutionPlaceable, EvolutionQueryRegisterProfilesModel, EvolutionRecoverPasswordModel, EvolutionRegisterProfileSiteInfo, EvolutionRegisterProfileUserInfo, EvolutionResetPasswordModel, EvolutionUpdateUserSettingsModel, EvolutionUserInfo, EvolutionUserLink, EvolutionUserModuleInfo };
+export type { ComplianceRegisterUsersResultModel, EvolutionChangeContextModel, EvolutionChangeContextResultModel, EvolutionComplianceActivitiesAddParams, EvolutionComplianceActivity, EvolutionComplianceLaswExportParams, EvolutionComplianceLaw, EvolutionComplianceLawDocumentInfo, EvolutionComplianceLawReference, EvolutionComplianceLawsAddParams, EvolutionComplianceRegister, EvolutionComplianceRegisterProfile, EvolutionComplianceRegisterSite, EvolutionContextInfo, EvolutionExportModel, EvolutionLicenceModuleInfo, EvolutionLoginInfo, EvolutionLoginResult, EvolutionPermission, EvolutionPlacePermission, EvolutionPlaceable, EvolutionQueryRegisterProfilesModel, EvolutionRecoverPasswordModel, EvolutionRegisterProfileSiteInfo, EvolutionRegisterProfileUserInfo, EvolutionResetPasswordModel, EvolutionSessionStatus, EvolutionUpdateUserSettingsModel, EvolutionUserInfo, EvolutionUserLink, EvolutionUserModuleInfo };

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.
      */