@arsedizioni/ars-utils 22.5.28 → 22.5.32

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

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
 import { Validator, AbstractControl, ValidationErrors } from '@angular/forms';
-import { PathKind, SchemaPath, SchemaPathRules, LogicFn } from '@angular/forms/signals';
+import { PathKind, LogicFn, SchemaPath, SchemaPathRules } from '@angular/forms/signals';
+import { Validated } from '@arsedizioni/ars-utils/core';
 
 /**
  * Directive that delegates validation to an externally provided validator function.
@@ -266,56 +267,6 @@ declare class NotEmptyValidatorDirective implements Validator {
     static ɵdir: i0.ɵɵDirectiveDeclaration<NotEmptyValidatorDirective, "[notEmpty]", never, {}, {}, never, never, true, never>;
 }
 
-/**
- * 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;
-
 /**
  * Options shared by the ARS signal-form validators.
  *
@@ -336,6 +287,22 @@ interface ArsValidatorConfig<TValue = string, TPathKind extends PathKind = PathK
      */
     when?: NoInfer<LogicFn<TValue, boolean, TPathKind>>;
 }
+/**
+ * Default texts of the rules declared here, in one place so that the validators and the fallback
+ * map of `SignalsUtils.getFieldErrorMessage` cannot drift apart: a rule added below without a
+ * message here would show "Errore", and one renamed here without touching the validator would
+ * leave the map with a kind nobody produces.
+ */
+/**
+ * Earliest date {@link date} and {@link dateRange} accept: 1 January 1970.
+ *
+ * Everything this application stores — events, certificates, payments, communications — happened
+ * after it, so an earlier value is always a typo (a two-digit year, a slipped keystroke) and never
+ * real data. The floor is deliberately higher than the one of {@link sqlDate}, which only asks
+ * what SQL Server can physically store.
+ */
+declare const MIN_VALID_YEAR = 1970;
+declare const ARS_VALIDATOR_MESSAGES: Record<string, string>;
 /**
  * Requires the value to be a well-formed GUID / UUID.
  *
@@ -379,6 +346,205 @@ declare function password<TPathKind extends PathKind = PathKind.Root>(path: Sche
  * const f = form(this.model, p => { required(p.city); notEmpty(p.city); });
  */
 declare function notEmpty<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to differ from the value of another field of the same form.
+ *
+ * The signal-form counterpart of `NotEqualValidatorDirective`, with its exact rule: two empty
+ * values are considered different, so an untouched pair of fields does not start out in error.
+ * Reactive on both fields — editing either one re-validates this one, which is what the
+ * directive needed a `valueChanges` subscription (and a re-entrancy guard) to achieve.
+ *
+ * @param path   - Path of the field to validate.
+ * @param other  - Path of the field whose value must differ.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function notEqual<TValue, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, other: SchemaPath<TValue, SchemaPathRules.Supported>, config?: ArsValidatorConfig<TValue, TPathKind>): void;
+/**
+ * Requires the value to be a date the backend can store: parseable, and after 1750.
+ *
+ * The signal-form counterpart of `SqlDateValidatorDirective`. The year floor is not arbitrary —
+ * it is what separates a real date from the 01/01/0001 that a mistyped year produces, which SQL
+ * Server rejects with an error nobody can read.
+ *
+ * @param path   - Path of the field to validate.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function sqlDate<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to be a real date, as {@link SystemUtils.parseDate} understands one.
+ *
+ * This is the rule for anything a user picks or types as a date: it accepts both the `Date` a
+ * Material datepicker or timepicker writes into the model and the text of a plain input, since
+ * `parseDate` handles the shapes this codebase produces (ISO, `dd/MM/yyyy`, `yyyy-MM-dd`, and the
+ * shorthand forms). Empty passes — saying "obbligatorio" is the job of `required()`.
+ *
+ * A date earlier than {@link MIN_VALID_YEAR} (1 January 1970) is rejected: nothing this
+ * application stores predates it, so an earlier value is a typo rather than data.
+ *
+ * Distinct from {@link sqlDate} on purpose: that one is about what the DATABASE can store (the
+ * 1750 floor), this one is about whether the value is a date at all. Pair them when both matter.
+ *
+ * @param path   - Path of the field to validate.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ * @example
+ * const f = form(this.model, p => { required(p.expiry); date(p.expiry); });
+ */
+declare function date<TValue extends string | Date | null | undefined, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<TValue, TPathKind>): void;
+/**
+ * Requires the two ends of a date range to be real dates and to be in order.
+ *
+ * Written for the two inputs of a `mat-date-range-input`, whose start and end live in two
+ * separate fields of the model. Each end is checked with the same rule as {@link date}, and the
+ * ordering is checked only when BOTH ends are filled in — a half-open range ("from today
+ * onwards") is a legitimate filter, not an error. The 1 January 1970 floor of {@link date}
+ * applies to both ends.
+ *
+ * The rule is bound to BOTH paths, so the error appears on whichever end the user is looking at
+ * and a single `<mat-error>` under the range can read either one. Comparison is made on the end
+ * of the day, so picking the same day for both ends is valid.
+ *
+ * @param from   - Path of the field holding the start of the range.
+ * @param to     - Path of the field holding the end of the range.
+ * @param config - Optional message override (used for the ordering error) and `when` condition.
+ * @returns void
+ * @example
+ * const f = form(this.model, p => { dateRange(p.sentFrom, p.sentTo); });
+ */
+declare function dateRange<TValue extends string | Date | null | undefined, TPathKind extends PathKind = PathKind.Root>(from: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, to: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<TValue, TPathKind>): void;
+/**
+ * Requires the value to be a date that is not in the future.
+ *
+ * The signal-form counterpart of `NotFutureValidatorDirective`. Today counts as valid: the
+ * comparison is made on the end of the day, so a date entered this morning does not become
+ * invalid because the clock says 09:00.
+ *
+ * @param path   - Path of the field to validate.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function notFuture<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to be a well-formed URL. An empty value passes, as everywhere else here.
+ *
+ * The signal-form counterpart of `UrlValidatorDirective`.
+ *
+ * @param path   - Path of the field to validate.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function url<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to hold no more than `max` whitespace-separated terms.
+ *
+ * The signal-form counterpart of `MaxTermsValidatorDirective`, used on the search boxes where
+ * the backend refuses a query past a certain number of words.
+ *
+ * @param path   - Path of the field to validate.
+ * @param max    - The maximum number of terms, as a number or a reactive function.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function maxTerms<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, max: number | (() => number), config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the size of the picked file to fall within the allowed range.
+ *
+ * The signal-form counterpart of `FileSizeValidatorDirective`, and it keeps its shape: the field
+ * itself holds the file NAME, while the size arrives from outside — the control that picked the
+ * file knows it, the form does not. An empty field passes, so "no file" is `required()`'s call
+ * and not a size error.
+ *
+ * @param path      - Path of the field holding the file name.
+ * @param sizeMb    - The size of the picked file in megabytes, as a reactive function.
+ * @param maxSizeMb - The maximum allowed size in megabytes. Defaults to `5`.
+ * @param minSizeMb - The minimum required size in megabytes. Defaults to `0`.
+ * @param config    - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function fileSize<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, sizeMb: () => number | undefined, maxSizeMb?: number | (() => number), minSizeMb?: number | (() => number), config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to declare itself valid.
+ *
+ * The signal-form counterpart of `ValidIfDirective`: when the field holds an object implementing
+ * `Validated` the verdict is its own `isValid()`, and when the field is empty the verdict is the
+ * `flag`. It is the escape hatch for the composite controls whose validity only they can judge.
+ *
+ * @param path   - Path of the field to validate.
+ * @param flag   - Verdict used while the field is empty, as a boolean or a reactive function.
+ *                 Defaults to `false`.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function validIf<TValue extends Partial<Validated>, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, flag?: boolean | (() => boolean), config?: ArsValidatorConfig<TValue, TPathKind>): void;
+/**
+ * Requires the value to be a semicolon-separated list of valid e-mail addresses.
+ *
+ * The signal-form counterpart of `EmailsValidatorDirective`. An empty value passes, and so does
+ * an empty entry between two semicolons: the list is typed by hand and a trailing `;` is not a
+ * mistake worth an error.
+ *
+ * @param path   - Path of the field to validate.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function emails<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to be a `"HH:MM"` time and, when slots are given, to fall inside one of them.
+ *
+ * The signal-form counterpart of `TimeValidatorDirective`. An empty value passes.
+ *
+ * @param path   - Path of the 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 no restriction.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function time<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, slots?: () => string | undefined, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to equal the value of another field of the same form.
+ *
+ * The signal-form counterpart of `EqualsValidatorDirective`. Reactive on both fields, which is
+ * what the directive needed a `valueChanges` subscription to obtain: retyping the first password
+ * re-validates the confirmation without anyone wiring the two together.
+ *
+ * @param path   - Path of the field to validate.
+ * @param other  - Path of the field whose value must match.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function equals<TValue, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, other: SchemaPath<TValue, SchemaPathRules.Supported>, config?: ArsValidatorConfig<TValue, TPathKind>): void;
+/**
+ * Requires the value to be either empty or a complete six-digit one-time code.
+ *
+ * The schema-level counterpart of the validator inside `OtpInputComponent`: a partial code is an
+ * error, an empty one is `required()`'s business.
+ *
+ * @param path   - Path of the field to validate.
+ * @param config - Optional message override and `when` condition.
+ * @returns void
+ */
+declare function otp<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/** Helpers around signal forms that are not validators themselves. */
+declare class SignalsUtils {
+    /**
+     * Builds the error text for a signal-forms field.
+     *
+     * Deliberately dumb: the wording lives in the schema, next to the rule that produces it
+     * (`required(p.x, { message: ... })`), so a field says what is wrong with it in one place
+     * instead of here in a switch that has to guess from the error kind. The map below is only
+     * the safety net for the rules declared without a message — the Angular built-ins, plus
+     * {@link ARS_VALIDATOR_MESSAGES} for the ones declared in this file.
+     * @param errors  - The errors currently on the field, from `f.x().errors()`.
+     * @param message - Optional override applied to every error of the field.
+     * @returns The first relevant error text, or `undefined` when the field has no errors.
+     */
+    static getFieldErrorMessage(errors: readonly {
+        kind: string;
+        message?: string;
+    }[], message?: string): string | undefined;
+}
 
-export { EmailsValidatorDirective, EqualsValidatorDirective, FileSizeValidatorDirective, GuidValidatorDirective, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, SqlDateValidatorDirective, TimeValidatorDirective, UrlValidatorDirective, ValidIfDirective, ValidatorDirective, emailsValidator, equalsValidator, guid, notEmpty, otpValidator, password, passwordValidator, timeValidator };
+export { ARS_VALIDATOR_MESSAGES, EmailsValidatorDirective, EqualsValidatorDirective, FileSizeValidatorDirective, GuidValidatorDirective, MIN_VALID_YEAR, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, SignalsUtils, SqlDateValidatorDirective, TimeValidatorDirective, UrlValidatorDirective, ValidIfDirective, ValidatorDirective, date, dateRange, emails, equals, fileSize, guid, maxTerms, notEmpty, notEqual, notFuture, otp, password, sqlDate, time, url, validIf };
 export type { ArsValidatorConfig };

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

@@ -5,6 +5,7 @@ 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';
+import { SignalsUtils } from '@arsedizioni/ars-utils/core.validators';
 
 declare class OtpInputComponent implements ControlValueAccessor, Validator {
     /** Signal-based query for all individual OTP digit input elements. */
@@ -124,6 +125,8 @@ interface CredentialsDialogData {
     appearance?: MatFormFieldAppearance;
 }
 declare class CredentialsDialogComponent {
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
     /** Emitted when the user submits the form. Carries the entered credentials. */
     readonly done: _angular_core.OutputEmitterRef<CredentialsDialogResult>;
     /** Emitted when the user requests a password-recovery flow. */
@@ -169,6 +172,8 @@ interface ResetPasswordDialogData {
     appearance?: MatFormFieldAppearance;
 }
 declare class ResetPasswordDialogComponent {
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
     /** Emitted when the user submits the new password. Carries the entered password data. */
     readonly done: _angular_core.OutputEmitterRef<ResetPasswordDialogResult>;
     private readonly dialogService;
@@ -208,6 +213,8 @@ interface RecoverPasswordDialogData {
     appearance?: MatFormFieldAppearance;
 }
 declare class RecoverPasswordDialogComponent {
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
     /** Emitted when the user submits the recovery request. Carries the entered email and recaptcha state. */
     readonly done: _angular_core.OutputEmitterRef<RecoverPasswordDialogResult>;
     /** Dialog configuration with defaults applied at construction time. */

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

@@ -2,9 +2,14 @@ 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 { DialogResult, DialogOption, SelectDialogData, PromptDialogType } from '@arsedizioni/ars-utils/ui';
+import { SendToDialogComponent, SelectTreeDialogComponent, SelectDialogComponent } from '@arsedizioni/ars-utils/ui.dialogs.select';
+import { SelectPictureDialogComponent, SelectFileDialogComponent } from '@arsedizioni/ars-utils/ui.files';
+import { PromptDialogComponent, PromptDateDialogComponent, PromptTimeDialogComponent } from '@arsedizioni/ars-utils/ui.dialogs.prompt';
+import { PromptOtpDialogComponent } from '@arsedizioni/ars-utils/ui.dialogs.auth';
 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 { SignalsUtils } from '@arsedizioni/ars-utils/core.validators';
 import { MatFormFieldAppearance } from '@angular/material/form-field';
 
 interface ConfirmDialogOption extends DialogOption {
@@ -56,6 +61,8 @@ interface DeleteDialogData {
     appearance?: MatFormFieldAppearance;
 }
 declare class DeleteDialogComponent {
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
     /** Emitted when the user makes a choice. Carries the selected result. */
     readonly choosen: i0.OutputEmitterRef<DialogResult>;
     private readonly dialogRef;
@@ -228,6 +235,117 @@ 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;
+    /**
+     * Open a send-to-email dialog.
+     * @param title - Dialog title.
+     * @param text - Pre-filled message body.
+     * @param subject - Pre-filled subject line.
+     * @param canPopulate - Whether the populate-recipients action is available.
+     * @param count - Number of documents being sent.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @returns The opened dialog reference.
+     */
+    sendTo(title?: string, text?: string, subject?: string, canPopulate?: boolean, count?: number, options?: any, width?: number): Promise<MatDialogRef<SendToDialogComponent, any> | null>;
+    /**
+     * Open a tree-node selection dialog.
+     * @param nodes - The tree nodes to display.
+     * @param title - Dialog title.
+     * @param description - Optional description shown below the title.
+     * @param initialFilter - Pre-applied filter text.
+     * @param width - Maximum dialog width in pixels.
+     * @param okCaption - Label for the confirm button.
+     * @param canAppend - Whether the append-node action is available.
+     * @returns The opened dialog reference.
+     */
+    selectTree(nodes: any, title?: string, description?: string, initialFilter?: string, width?: number, okCaption?: string, canAppend?: boolean): Promise<MatDialogRef<SelectTreeDialogComponent, any> | null>;
+    /**
+     * Open a picture-selection dialog.
+     * @param title - Dialog title.
+     * @param description - Brief description shown in the dialog.
+     * @param okCaption - Label for the confirm button.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param maxSize - Maximum accepted file size in MB.
+     * @param maxPictureWidth - Maximum accepted picture width in pixels.
+     * @param maxPictureHeight - Maximum accepted picture height in pixels.
+     * @returns The opened dialog reference.
+     */
+    selectPicture(title?: string, description?: string, okCaption?: string, options?: any, width?: number, maxSize?: number, maxPictureWidth?: number, maxPictureHeight?: number): Promise<MatDialogRef<SelectPictureDialogComponent, any> | null>;
+    /**
+     * Open a file-selection dialog.
+     * @param title - Dialog title.
+     * @param description - Brief description shown in the dialog.
+     * @param okCaption - Label for the confirm button.
+     * @param helpLink - URL for the help link.
+     * @param helpCaption - Display text for the help link.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param maxSize - Maximum accepted file size in MB.
+     * @param accept - Accepted file extensions (e.g. `.pdf,.docx`).
+     * @returns The opened dialog reference.
+     */
+    selectFile(title?: string, description?: string, okCaption?: string, helpLink?: string, helpCaption?: string, options?: any, width?: number, maxSize?: number, accept?: string): Promise<MatDialogRef<SelectFileDialogComponent, any> | null>;
+    /**
+     * Open a multipurpose selection and CRUD dialog.
+     * @param data - The dialog configuration model.
+     * @param disableClose - Whether the dialog can be closed by clicking outside.
+     * @param closeOnNavigation - Whether the dialog closes on route navigation.
+     * @returns The opened dialog reference.
+     */
+    select(data: SelectDialogData, disableClose?: boolean, closeOnNavigation?: boolean): Promise<MatDialogRef<SelectDialogComponent, any> | null>;
+    /**
+     * Prompt the user to enter a value.
+     * @param title - Dialog title.
+     * @param type - The input type (default, text, number, etc.).
+     * @param description - Placeholder or description text.
+     * @param initialValue - Pre-filled value.
+     * @param okCaption - Label for the confirm button.
+     * @param cancelCaption - Label for the cancel button.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param required - Whether the input is required.
+     * @returns The opened dialog reference.
+     */
+    prompt(title: string, type?: PromptDialogType, description?: string, initialValue?: any, okCaption?: string, cancelCaption?: string, options?: any, width?: number, required?: boolean): Promise<MatDialogRef<PromptDialogComponent> | null>;
+    /**
+     * Prompt the user to enter a date or date interval.
+     * @param title - Dialog title.
+     * @param type - Date or DateInterval.
+     * @param description - Placeholder or description text.
+     * @param initialValue - Pre-filled value.
+     * @param okCaption - Label for the confirm button.
+     * @param cancelCaption - Label for the cancel button.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param required - Whether the input is required.
+     * @returns The opened dialog reference.
+     */
+    promptDate(title: string, type?: PromptDialogType.Date | PromptDialogType.DateInterval, description?: string, initialValue?: any, okCaption?: string, cancelCaption?: string, options?: any, width?: number, required?: boolean): Promise<MatDialogRef<PromptDateDialogComponent> | null>;
+    /**
+     * Prompt the user to enter a time value.
+     * @param title - Dialog title.
+     * @param description - Placeholder or description text.
+     * @param slots - Optional time slots string.
+     * @param initialValue - Pre-filled value.
+     * @param okCaption - Label for the confirm button.
+     * @param cancelCaption - Label for the cancel button.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param required - Whether the input is required.
+     * @returns The opened dialog reference.
+     */
+    promptTime(title: string, description?: string, slots?: string, initialValue?: any, okCaption?: string, cancelCaption?: string, options?: any, width?: number, required?: boolean): Promise<MatDialogRef<PromptTimeDialogComponent> | null>;
+    /**
+     * Prompt the user to enter an OTP code.
+     * @param title - Dialog title.
+     * @param description - Description text shown in the dialog.
+     * @param okCaption - Label for the confirm button.
+     * @param cancelCaption - Label for the cancel button.
+     * @param width - Maximum dialog width in pixels.
+     * @returns The opened dialog reference.
+     */
+    promptOtp(title?: string, description?: string, okCaption?: string, cancelCaption?: string, width?: number): Promise<MatDialogRef<PromptOtpDialogComponent> | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DialogService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<DialogService>;
 }

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

@@ -1,8 +1,11 @@
 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 { SignalsUtils } from '@arsedizioni/ars-utils/core.validators';
 
 declare class PromptDialogComponent {
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
     readonly done: _angular_core.OutputEmitterRef<PromptDialogResult>;
     private readonly dialogService;
     protected readonly dialogData: _angular_core.WritableSignal<PromptDialogData>;
@@ -24,6 +27,21 @@ declare class PromptDialogComponent {
 }
 
 declare class PromptDateDialogComponent {
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
+    /**
+     * Error text for a date range: whichever end is in error speaks for the pair.
+     * @param from - Errors of the start field, from `f.from().errors()`.
+     * @param to   - Errors of the end field, from `f.to().errors()`.
+     * @returns The text to show under the range, or `undefined` when neither end is in error.
+     */
+    protected rangeErrorMessage(from: readonly {
+        kind: string;
+        message?: string;
+    }[], to: readonly {
+        kind: string;
+        message?: string;
+    }[]): string | undefined;
     readonly done: _angular_core.OutputEmitterRef<PromptDateDialogResult>;
     private readonly dialogService;
     protected readonly dialogData: _angular_core.WritableSignal<PromptDialogData>;
@@ -73,6 +91,8 @@ declare class PromptDateDialogComponent {
 }
 
 declare class PromptTimeDialogComponent {
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
     readonly done: _angular_core.OutputEmitterRef<PromptDialogResult>;
     private readonly dialogService;
     protected readonly dialogData: _angular_core.WritableSignal<PromptTimeDialogData>;

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

@@ -9,6 +9,7 @@ import { SelectDialogData, SelectDialogResult, SelectDialogEdit, SelectableItem,
 import * as rxjs from 'rxjs';
 import { MatTree } from '@angular/material/tree';
 import { MatFormFieldAppearance } from '@angular/material/form-field';
+import { SignalsUtils } from '@arsedizioni/ars-utils/core.validators';
 
 declare class SelectDialogComponent {
     readonly paginator: _angular_core.Signal<MatPaginator>;
@@ -283,6 +284,8 @@ interface SendToDialogData {
     options?: any;
 }
 declare class SendToDialogComponent implements ISendToDialog {
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
     /** Emitted when the user confirms and sends the message. */
     readonly done: _angular_core.OutputEmitterRef<SendToDialogResult>;
     /** Emitted when the user requests to populate the recipient list. */

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

@@ -2,6 +2,7 @@ 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';
+import { SignalsUtils } from '@arsedizioni/ars-utils/core.validators';
 import { MatFormFieldControl } from '@angular/material/form-field';
 import { FileInfo } from '@arsedizioni/ars-utils/core';
 import { Subject } from 'rxjs';
@@ -9,6 +10,8 @@ import { SelectFile, SelectFileDialogData, SelectPictureFileDialogData } from '@
 
 declare class FileInputComponent implements OnDestroy, DoCheck, MatFormFieldControl<FileInfo>, ControlValueAccessor {
     ngControl: NgControl;
+    /** Error text of a field: the message declared in the schema, or the shared fallback. */
+    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
     /** Reference to the hidden native file input element. */
     protected readonly __file: _angular_core.Signal<ElementRef<any>>;
     private readonly renderer;

package/ui.application/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/arsedizioni-ars-utils-ui.application.mjs",
+  "typings": "../types/arsedizioni-ars-utils-ui.application.d.ts"
+}