@arsedizioni/ars-utils 22.5.16 → 22.5.17

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