@arsedizioni/ars-utils 22.1.5 → 22.5.2

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

@@ -1,319 +1,10 @@
 import * as i0 from '@angular/core';
-import { EnvironmentProviders, InjectionToken, PipeTransform, EventEmitter, OnDestroy, Signal } from '@angular/core';
-import { DateAdapter, MatDateFormats } from '@angular/material/core';
+import { EventEmitter, PipeTransform, OnDestroy, Signal } from '@angular/core';
+import { SelectionModel } from '@angular/cdk/collections';
 import { Locale } from 'date-fns';
-import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpInterceptorFn } from '@angular/common/http';
-import { Observable } from 'rxjs';
 import { Validator, AbstractControl, ValidationErrors } from '@angular/forms';
 import { SafeHtml, SafeResourceUrl } from '@angular/platform-browser';
-import { SelectionModel } from '@angular/cdk/collections';
-
-declare const MAT_DATE_FNS_FORMATS: MatDateFormats;
-/**
- * date-fns adapter that integrates Angular Material's date picker with the date-fns library,
- * applying `Europe/Rome` timezone for all parsed and created dates.
- */
-declare class DateFnsAdapter extends DateAdapter<Date, Locale> {
-    constructor();
-    /**
-     * Wraps a date/instant into a Europe/Rome TZDate whose JSON serialisation emits a
-     * naive local datetime string ("yyyy-MM-dd'T'HH:mm:ss") instead of a UTC instant,
-     * so the wall-clock value the user entered is preserved end-to-end (no timezone shift).
-     * @param value - The source Date or Unix timestamp in milliseconds.
-     * @returns a Europe/Rome TZDate whose toJSON yields a naive local datetime string.
-     */
-    private static toLocal;
-    /**
-     * Returns the year component of the given date.
-     * @param date - The source date.
-     */
-    getYear(date: Date): number;
-    /**
-     * Returns the zero-based month index of the given date (0 = January).
-     * @param date - The source date.
-     */
-    getMonth(date: Date): number;
-    /**
-     * Returns the day-of-month of the given date (1-based).
-     * @param date - The source date.
-     */
-    getDate(date: Date): number;
-    /**
-     * Returns the day-of-week of the given date (0 = Sunday).
-     * @param date - The source date.
-     */
-    getDayOfWeek(date: Date): number;
-    /**
-     * Returns an array of 12 month name strings formatted for the active locale.
-     * @param style - One of `'long'`, `'short'`, or `'narrow'`.
-     */
-    getMonthNames(style: 'long' | 'short' | 'narrow'): string[];
-    /**
-     * Returns an array of 31 day-of-month label strings formatted using `Intl.DateTimeFormat`
-     * when available, falling back to plain numeric strings.
-     */
-    getDateNames(): string[];
-    /**
-     * Returns an array of 7 day-of-week name strings formatted for the active locale.
-     * @param style - One of `'long'`, `'short'`, or `'narrow'`.
-     */
-    getDayOfWeekNames(style: 'long' | 'short' | 'narrow'): string[];
-    /**
-     * Returns the four-digit year string for the given date.
-     * @param date - The source date.
-     */
-    getYearName(date: Date): string;
-    /**
-     * Returns the first day of the week for the active locale (0 = Sunday, 1 = Monday, …).
-     */
-    getFirstDayOfWeek(): number;
-    /**
-     * Returns the number of days in the month of the given date.
-     * @param date - The source date.
-     */
-    getNumDaysInMonth(date: Date): number;
-    /**
-     * Creates an independent copy of the given date.
-     * @param date - The date to clone.
-     */
-    clone(date: Date): Date;
-    /**
-     * Creates a `Date` in the `Europe/Rome` timezone for the given year, month, and day.
-     * Throws an `Error` when any component is out of range.
-     * @param year  - Full four-digit year.
-     * @param month - Zero-based month index (0 = January, 11 = December).
-     * @param date  - Day-of-month (1-based).
-     */
-    createDate(year: number, month: number, date: number): Date;
-    /**
-     * Returns the current date and time in the Europe/Rome timezone, preserving the wall-clock value.
-     */
-    today(): Date;
-    /**
-     * Parses a value into a `Date`.
-     * - Strings are first attempted as ISO 8601, then matched against each format in `parseFormat`.
-     * - Numbers are treated as Unix timestamps (milliseconds).
-     * - Existing `Date` instances are cloned.
-     * @param value       - The value to parse.
-     * @param parseFormat - A format string or an array of format strings (date-fns tokens).
-     * @returns A valid `Date` in `Europe/Rome`, an invalid sentinel, or `null` for unrecognised input.
-     */
-    parse(value: unknown, parseFormat: string | string[]): Date | null;
-    /**
-     * Formats a `Date` using the given date-fns display format string.
-     * Throws an `Error` when `date` is not valid.
-     * @param date          - The date to format.
-     * @param displayFormat - A date-fns format string (e.g. `'P'`, `'LLL uuuu'`).
-     */
-    format(date: Date, displayFormat: string): string;
-    /**
-     * Adds the given number of whole years to a date.
-     * @param date  - The base date.
-     * @param years - Number of years to add (can be negative).
-     */
-    addCalendarYears(date: Date, years: number): Date;
-    /**
-     * Adds the given number of whole months to a date.
-     * @param date   - The base date.
-     * @param months - Number of months to add (can be negative).
-     */
-    addCalendarMonths(date: Date, months: number): Date;
-    /**
-     * Adds the given number of whole days to a date.
-     * @param date - The base date.
-     * @param days - Number of days to add (can be negative).
-     */
-    addCalendarDays(date: Date, days: number): Date;
-    /**
-     * Serialises a date to an ISO 8601 date-only string (`yyyy-MM-dd`) using its Europe/Rome calendar day,
-     * independent of the browser timezone.
-     * @param date - The date to serialise.
-     * @returns the yyyy-MM-dd string for the date in Europe/Rome.
-     */
-    toIso8601(date: Date): string;
-    /**
-     * Returns the given value when it is a valid `Date`, or `null` for an empty string.
-     * Deserialises valid ISO 8601 strings into `Date` instances.
-     * Delegates all other values to the base-class implementation.
-     * @param value - The raw value to deserialise.
-     */
-    deserialize(value: unknown): Date | null;
-    /**
-     * Returns `true` when `obj` is an instance of `Date`.
-     * @param obj - The object to test.
-     */
-    isDateInstance(obj: unknown): boolean;
-    /**
-     * Returns `true` when `date` represents a valid point in time.
-     * @param date - The date to validate.
-     */
-    isValid(date: Date): boolean;
-    /**
-     * Returns a sentinel `Date` that represents an invalid date (`new Date(NaN)`).
-     */
-    invalid(): Date;
-    /**
-     * Returns the hours component (0-23) of the given date.
-     * @param date - The source date.
-     */
-    getHours(date: Date): number;
-    /**
-     * Returns the minutes component (0-59) of the given date.
-     * @param date - The source date.
-     */
-    getMinutes(date: Date): number;
-    /**
-     * Returns the seconds component (0-59) of the given date.
-     * @param date - The source date.
-     */
-    getSeconds(date: Date): number;
-    /**
-     * Returns a clone of `target` with its time-of-day set to the given hours/minutes/seconds,
-     * keeping the date part unchanged.
-     * @param target  - The date whose time should be set.
-     * @param hours   - New hours (0-23).
-     * @param minutes - New minutes (0-59).
-     * @param seconds - New seconds (0-59).
-     */
-    setTime(target: Date, hours: number, minutes: number, seconds: number): Date;
-    /**
-     * Adds the given number of seconds to a date.
-     * @param date   - The base date.
-     * @param amount - Number of seconds to add (can be negative).
-     */
-    addSeconds(date: Date, amount: number): Date;
-    /**
-     * Parses a time-only value into a `Date` (today's date, in `Europe/Rome`, with the parsed
-     * time-of-day set). The wall-clock time is preserved exactly as entered.
-     * @param value       - The value to parse (a string, or an existing `Date`).
-     * @param parseFormat - A format string or an array of format strings (date-fns tokens).
-     * @returns the parsed Date, an invalid sentinel, or null for unrecognised input.
-     */
-    parseTime(value: unknown, parseFormat: string | string[]): Date | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DateFnsAdapter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<DateFnsAdapter>;
-}
-/**
- * Standalone providers for the ARS date-fns adapter.
- *
- * Configures Angular Material to use {@link DateFnsAdapter} (Europe/Rome timezone)
- * and the matching {@link MAT_DATE_FNS_FORMATS}. Also supports `mat-timepicker` since
- * {@link DateFnsAdapter} implements the time-related `DateAdapter` methods.
- *
- * @example
- * bootstrapApplication(AppComponent, {
- *   providers: [provideArsDateFns()]
- * });
- */
-declare function provideArsDateFns(): EnvironmentProviders;
-
-/** Default application timezone: all dates are serialised as Europe/Rome wall-clock values. */
-declare const DEFAULT_TIME_ZONE = "Europe/Rome";
-/**
- * IANA timezone used to serialise dates towards the backend.
- * Override it in the application providers to run the same code in another zone:
- * `{ provide: ARS_TIME_ZONE, useValue: 'Europe/Zurich' }`.
- */
-declare const ARS_TIME_ZONE: InjectionToken<string>;
-/**
- * Functional interceptor that serialises every `Date` in an outgoing request
- * body as a naive local datetime string (`yyyy-MM-ddTHH:mm:ss`: no `Z`, no offset).
- *
- * WHY: `JSON.stringify` calls `Date.prototype.toJSON`, which emits a UTC instant.
- * A date picked as 29/07/2026 00:00 in Rome (UTC+2) becomes
- * `2026-07-28T22:00:00.000Z`, so the server stores the 28th — the classic
- * "off by one day" bug. Sending the wall-clock value instead makes
- * System.Text.Json produce a `DateTime` with `Kind = Unspecified` and the exact
- * day/time the user selected.
- *
- * This is the single serialisation boundary of the application: no call site has
- * to convert anything, and it also covers dates that lost a per-instance
- * `toJSON` along the way (e.g. after `structuredClone`).
- *
- * Register it explicitly in `provideHttpClient(withInterceptors([...]))`.
- * If you would rather have the library register it for you, use
- * {@link provideArsLocalDates} instead.
- *
- * @example
- * provideHttpClient(withInterceptors([
- *   arsLocalDateInterceptor,
- *   evolutionAuthInterceptor(...),
- * ]));
- */
-declare const arsLocalDateInterceptor: HttpInterceptorFn;
-/**
- * Class-based twin of {@link arsLocalDateInterceptor}.
- *
- * Exists because a functional `HttpInterceptorFn` can ONLY be registered inside
- * `provideHttpClient(withInterceptors([...]))`, while a class registered on the
- * `HTTP_INTERCEPTORS` multi-token can be contributed by any `EnvironmentProviders` —
- * which is what lets {@link provideArsLocalDates} (and `provideArsDateFns`) wire it up
- * on their own.
- *
- * REQUIRES `withInterceptorsFromDi()` in the application's `provideHttpClient()`:
- * without it Angular never reads `HTTP_INTERCEPTORS` and this interceptor is
- * silently skipped.
- */
-declare class ArsLocalDateInterceptor implements HttpInterceptor {
-    private readonly timeZone;
-    /**
-     * Normalises the request body before handing it to the next handler.
-     * @param req  - The outgoing request.
-     * @param next - The next handler in the chain.
-     */
-    intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ArsLocalDateInterceptor, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ArsLocalDateInterceptor>;
-}
-/**
- * Standalone providers for date serialisation towards the backend.
- *
- * Registers {@link ArsLocalDateInterceptor} so that every `Date` in a request
- * body travels as a naive local datetime string instead of a UTC instant.
- *
- * IMPORTANT: the application MUST call `withInterceptorsFromDi()`, otherwise
- * these providers have no effect at all (no error is raised).
- *
- * @param timeZone - IANA timezone name (default: `Europe/Rome`).
- *
- * @example
- * providers: [
- *   provideArsLocalDates(),
- *   provideHttpClient(withInterceptors([evolutionAuthInterceptor(...)]), withInterceptorsFromDi()),
- * ]
- */
-declare function provideArsLocalDates(timeZone?: string): EnvironmentProviders;
-/**
- * Formats a date as a date-only ISO string (`yyyy-MM-dd`) using its wall-clock
- * calendar day in the given timezone. Use it for query-string parameters and for
- * DTO fields mapped to a .NET `DateOnly`, which the interceptor cannot detect.
- *
- * @param value    - The date to serialise.
- * @param timeZone - IANA timezone name (default: `Europe/Rome`).
- * @returns The `yyyy-MM-dd` string, or `undefined` for empty/invalid input.
- */
-declare function toLocalDateOnlyString(value?: Date | null, timeZone?: string): string | undefined;
-/**
- * Formats a date as a naive local datetime string (`yyyy-MM-ddTHH:mm:ss`), the
- * same representation produced by the interceptor. Useful for query-string
- * parameters, which never pass through the request body.
- *
- * @param value    - The date to serialise.
- * @param timeZone - IANA timezone name (default: `Europe/Rome`).
- * @returns The naive datetime string, or `undefined` for empty/invalid input.
- */
-declare function toLocalDateTimeString(value?: Date | null, timeZone?: string): string | undefined;
-
-/**
- * Directive that moves browser focus to the host element after the first render cycle.
- * Apply `autoFocus` to any focusable element to set focus automatically on initialisation.
- */
-declare class AutoFocusDirective {
-    private readonly elementRef;
-    constructor();
-    static ɵfac: i0.ɵɵFactoryDeclaration<AutoFocusDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<AutoFocusDirective, "[autoFocus]", never, {}, {}, never, never, true, never>;
-}
+import { Observable } from 'rxjs';
 
 interface INode {
     id: string;
@@ -413,11 +104,13 @@ declare class UpdateRelationsModel<T = number> {
     id: T;
     relatedIds: T[];
 }
+/** Identifies the external identity provider used for an OAuth login. */
 declare enum LoginOAuthType {
     None = 0,
     Microsoft = 1,
     Google = 2
 }
+/** Payload emitted by the OAuth login components once the provider returned a token. */
 interface LoginOAuthResult {
     type: LoginOAuthType;
     token: string;
@@ -490,558 +183,62 @@ interface LoginResult<T> extends ApiResult<boolean> {
     requiresMfa?: boolean;
 }
 
-/**
- * Directive that listens to `keyup` events on a date input and debounces changes
- * into a {@link DateInterval} model, converting shorthand strings (e.g. "d/m") to dates.
- * Apply `[dateIntervalChange]="interval"` to the host `<input>` element.
- */
-declare class DateIntervalChangeDirective {
-    /** The date interval model to update when the input value changes. */
-    readonly dateIntervalChange: i0.InputSignal<DateInterval>;
-    /** When `true`, the directive updates the interval's end date; otherwise the start date. */
-    readonly end: i0.InputSignal<boolean>;
-    private readonly subject;
-    private readonly destroyRef;
-    constructor();
-    /**
-     * Handles `keydown` events on the host element.
-     * The space key must be blocked HERE: by the time `keyup` fires the character
-     * has already been inserted into the input, so `preventDefault` on `keyup`
-     * cannot stop it.
-     * @param e - The keyboard event emitted by the host input.
-     */
-    onKeydown(e: KeyboardEvent): void;
+declare const UtilsMessages: {
     /**
-     * Handles `keyup` events on the host element and forwards them to the debounce pipeline.
-     * @param e - The keyboard event emitted by the host input.
+     * Messages
      */
-    onKeyup(e: KeyboardEvent): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DateIntervalChangeDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<DateIntervalChangeDirective, "[dateIntervalChange]", never, { "dateIntervalChange": { "alias": "dateIntervalChange"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
+    UTILS_DIALOGS_SELECT_OPTIONS_CHANGED: string;
+};
 
-/**
- * Directive that copies a string payload to the clipboard when the host element is clicked.
- * Bind `[copyClipboard]="text"` to provide the content to copy and listen to `(copied)` for confirmation.
- */
-declare class CopyClipboardDirective {
-    /** The text to copy to the clipboard. Bound via the `copyClipboard` attribute. */
-    readonly payload: i0.InputSignal<string>;
-    /** Emits the copied text after a successful copy operation. */
-    readonly copied: i0.OutputEmitterRef<string>;
-    /**
-     * Handles click events on the host element and copies the payload to the clipboard.
-     * Emits `copied` with the copied text on success.
-     * @param e - The mouse click event.
-     */
-    onClick(e: MouseEvent): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CopyClipboardDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<CopyClipboardDirective, "[copyClipboard]", never, { "payload": { "alias": "copyClipboard"; "required": false; "isSignal": true; }; }, { "copied": "copied"; }, never, never, true, never>;
+declare enum DateFormat {
+    Short = 1,// dd/mm/yyyy
+    Long = 2,// d mmmm yyyy
+    LongWithShortMonth = 3,// d mmm yyyy
+    LongWithWeekDay = 4,// wwww, d mmmm yyyy
+    LongWithShortWeekDay = 5,// www, d mmmm yyyy
+    MonthAndYear = 6,// mmm yyyy
+    LongMonthAndYear = 7,// mmmm yyyy
+    WeekDay = 8,// www d
+    LongWeekDay = 9,// wwww d
+    DayAndMonth = 10,// d mmmm
+    ShortUS = 11,// mm/dd/yyyy
+    ShortISO8601 = 12
 }
-
 /**
- * Directive that validates a semicolon-separated list of email addresses.
- * Apply `emails` to a text input containing one or more addresses separated by `;`.
+ * Key selector with IDE autocomplete and compile-time checking.
+ *
+ * Suggests the string keys of `T` in the editor and flags obvious typos when
+ * `T` is known, while STILL accepting any plain string (the `string & {}`
+ * branch), so existing callers that pass dynamic or untyped keys keep
+ * compiling unchanged.
  */
-declare class EmailsValidatorDirective implements Validator {
+type KeyOf<T> = Extract<keyof T, string> | (string & {});
+interface PasswordStrength {
+    score: number;
+    label?: string;
+    color?: string;
+    suggestions?: string[];
+    isValid: boolean;
+}
+declare class SystemUtils {
+    /** Shared collator for locale-aware, case-insensitive string comparison. */
+    private static readonly collator;
     /**
-     * Validates each address in a semicolon-separated email list.
-     * Returns `null` when the control is empty.
-     * @param control - The form control to validate.
+     * Array find by key
+     * @param array     : the array to scan
+     * @param key       : key name
+     * @param value     : the value to search for
+     * @returns         : the property value or null
      */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<EmailsValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<EmailsValidatorDirective, "[emails]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates that the host control's value equals the value of another control.
- * Bind `[equals]="otherControl"`.
- *
- * The host control is re-validated whenever the OTHER control's value changes:
- * without this, typing a new password AFTER the confirmation field was filled
- * left the form incorrectly valid (the classic password/confirm bug).
- *
- * IMPORTANT (reciprocal-binding safety): the re-validation triggered from the
- * other control's `valueChanges` runs with `{ emitEvent: false }`. Calling
- * Angular's `onValidatorChange` instead would re-emit valueChanges, so a
- * reciprocal setup (A [equals]=B and B [equals]=A) would overflow the stack.
- */
-declare class EqualsValidatorDirective implements Validator {
-    /** The control whose value must match the host control's value. */
-    readonly equals: i0.InputSignal<AbstractControl<any, any, any>>;
-    /** The host control, captured on the first validate() call. */
-    private hostControl?;
-    /** Subscription to the other control's valueChanges. */
-    private subscription?;
-    constructor();
+    static arrayFindByKey<T>(array: T[] | undefined, key: KeyOf<T>, value: unknown): T | undefined;
     /**
-     * Validates that the host control value equals the bound control's value.
-     * Returns `null` (valid) when no control is bound.
-     * @param control - The form control to validate.
-     * @returns `null` when valid, `{ equals: ... }` otherwise.
+     * Array find index by key
+     * @param array   : the array to scan
+     * @param key     : the key name
+     * @param value   : the value to search for
+     * @returns       : the array index or -1 if not found
      */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<EqualsValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<EqualsValidatorDirective, "[equals]", never, { "equals": { "alias": "equals"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates a file size against configurable minimum and maximum bounds.
- * Bind `[fileSize]` together with `[size]="fileSizeInMb"`, `[maxSizeMb]`, and `[minSizeMb]`.
- */
-declare class FileSizeValidatorDirective implements Validator {
-    /** Maximum allowed file size in megabytes. Defaults to 5. */
-    readonly maxSizeMb: i0.InputSignal<number>;
-    /** Minimum required file size in megabytes. Defaults to 0. */
-    readonly minSizeMb: i0.InputSignal<number>;
-    /** The actual file size in megabytes to validate against the bounds. */
-    readonly size: i0.InputSignal<number>;
-    /**
-     * Validates that the bound file size falls within the configured min/max range.
-     * Returns `null` when no control value is present.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FileSizeValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<FileSizeValidatorDirective, "[fileSize]", never, { "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "minSizeMb": { "alias": "minSizeMb"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates a control value as a GUID / UUID string.
- * Apply `guid` to a text input that expects a valid UUID.
- */
-declare class GuidValidatorDirective implements Validator {
-    /**
-     * Validates that the control value is a well-formed GUID / UUID.
-     * Returns `null` when the control is empty.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<GuidValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<GuidValidatorDirective, "[guid]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates that a control value does not exceed a maximum word count.
- * Bind `[maxTerms]="10"` to allow at most 10 whitespace-separated terms.
- */
-declare class MaxTermsValidatorDirective implements Validator {
-    /** The maximum number of whitespace-separated terms allowed. */
-    readonly maxTerms: i0.InputSignal<number>;
-    /**
-     * Validates that the control value contains no more than the configured number of terms.
-     * Returns `null` when the control is empty.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MaxTermsValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MaxTermsValidatorDirective, "[maxTerms]", never, { "maxTerms": { "alias": "maxTerms"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates that a string control value is not blank (whitespace-only).
- * Apply `notEmpty` to a text input where non-blank content is required.
- */
-declare class NotEmptyValidatorDirective implements Validator {
-    /**
-     * Validates that the control value is a non-blank string.
-     * Returns `null` when the control is empty or not a string.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NotEmptyValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NotEmptyValidatorDirective, "[notEmpty]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates that the host control's value is different from another control's value.
- * Bind `[notEqual]="otherControl"`.
- *
- * The host control is re-validated whenever the OTHER control's value changes,
- * so editing either field keeps both error states consistent.
- *
- * IMPORTANT (reciprocal-binding safety): the re-validation triggered from the
- * other control's `valueChanges` is run with `{ emitEvent: false }`. Using
- * Angular's `onValidatorChange` here instead would call `host.updateValueAndValidity()`
- * WITH events, so a reciprocal setup (A [notEqual]=B and B [notEqual]=A) would
- * ping-pong valueChanges between the two controls and overflow the stack.
- */
-declare class NotEqualValidatorDirective implements Validator {
-    /** The control whose value must differ from the host control's value. */
-    readonly notEqual: i0.InputSignal<AbstractControl<any, any, any>>;
-    /** The host control, captured on the first validate() call. */
-    private hostControl?;
-    /** Subscription to the other control's valueChanges. */
-    private subscription?;
-    constructor();
-    /**
-     * Validates that the host control value is not equal to the bound control's value.
-     * Also clears the `notequal` error on the other control when the host becomes valid.
-     * Returns `null` (valid) when no control is bound.
-     * @param control - The form control to validate.
-     * @returns `null` when valid, `{ notequal: true }` otherwise.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NotEqualValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NotEqualValidatorDirective, "[notEqual]", never, { "notEqual": { "alias": "notEqual"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates that a control value is not a future date.
- * Apply `notFuture` to a text input that expects a date on or before today.
- */
-declare class NotFutureValidatorDirective implements Validator {
-    /**
-     * Validates that the control value represents a date that is not in the future.
-     * Returns `null` when the control is empty.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NotFutureValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NotFutureValidatorDirective, "[notFuture]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates a control value as a sufficiently strong password.
- * Apply `password` to a password input.
- */
-declare class PasswordValidatorDirective implements Validator {
-    /**
-     * Validates that the control value meets the minimum password-strength requirements.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PasswordValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PasswordValidatorDirective, "[password]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Directive that removes focus from the host element after it is clicked,
- * preventing the browser from keeping a visible focus ring post-interaction.
- * Apply `removeFocus` to any focusable element (e.g. a button).
- */
-declare class RemoveFocusDirective {
-    private readonly elementRef;
-    /**
-     * Handles click events on the host element and blurs it on the next event-loop tick
-     * so that the click action completes before focus is removed.
-     */
-    onClick(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<RemoveFocusDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<RemoveFocusDirective, "[removeFocus]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates a control value as a parseable SQL-compatible date string.
- * Apply `sqlDate` to a text input that expects a date after year 1750.
- */
-declare class SqlDateValidatorDirective implements Validator {
-    /**
-     * Validates that the control value can be parsed as a date after 1750.
-     * Returns `null` when the control is empty.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SqlDateValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<SqlDateValidatorDirective, "[sqlDate]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates a time string against optional allowed time slot ranges.
- * Bind `[time]` and optionally `[slots]="'08:00-12:00|14:00-18:00'"` (pipe-separated ranges).
- */
-declare class TimeValidatorDirective implements Validator {
-    /** Optional pipe-separated list of allowed time ranges, e.g. `"08:00-12:00|14:00-18:00"`. */
-    readonly slots: i0.InputSignal<string>;
-    /**
-     * Parses a `"HH:MM"` time string into a comparable integer (e.g. `"09:30"` -> `930`).
-     * Returns `-1` when the string is not a valid time.
-     * @param value - The time string to parse.
-     */
-    private getTime;
-    /**
-     * Validates that the control value is a valid time string and, when slots are configured,
-     * that it falls within at least one of the allowed ranges.
-     * Returns `null` when the control is empty.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TimeValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<TimeValidatorDirective, "[time]", never, { "slots": { "alias": "slots"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates a control value as a well-formed URL.
- * Apply `url` to a text input that expects a URL.
- */
-declare class UrlValidatorDirective implements Validator {
-    /**
-     * Validates that the control value is a well-formed URL.
-     * Returns `null` (valid) when the control is empty.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<UrlValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<UrlValidatorDirective, "[url]", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * Directive that validates a control using the host object's `isValid()` method
- * or a boolean expression passed via `[validIf]`.
- */
-declare class ValidIfDirective implements Validator {
-    /** When `true`, the control is considered valid regardless of the bound value. */
-    readonly validIf: i0.InputSignal<boolean>;
-    /**
-     * Validates the control value against a boolean flag or the value's own `isValid()` method.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ValidIfDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ValidIfDirective, "[validIf]", never, { "validIf": { "alias": "validIf"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Directive that delegates validation to an externally provided validator function.
- * Bind `[validator]="myFn"` where `myFn` is `(c: AbstractControl) => ValidationErrors | null`.
- */
-declare class ValidatorDirective implements Validator {
-    /** The custom validator function to apply. */
-    readonly validator: i0.InputSignal<(control: AbstractControl) => ValidationErrors | null>;
-    /**
-     * Invokes the provided validator function against the given control.
-     * Returns `null` (valid) when no function is bound.
-     * @param control - The form control to validate.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ValidatorDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ValidatorDirective, "[validator]", never, { "validator": { "alias": "validator"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * Pipe that converts plain-text newlines (`\r\n`, `\r`, `\n`) to HTML `<br>` tags
- * and marks the result as trusted HTML so Angular does not escape it.
- *
- * Usage: `{{ text | formatHtml }}`
- */
-declare class FormatHtmlPipe implements PipeTransform {
-    private readonly sanitizer;
-    /**
-     * Transforms a plain-text string into sanitized HTML by replacing newline characters
-     * with `<br>` tags.
-     * @param value - The input string to transform. Treated as an empty string when `undefined`.
-     * @returns A `SafeHtml` value that can be rendered with `[innerHTML]`.
-     */
-    transform(value?: string): SafeHtml;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormatHtmlPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<FormatHtmlPipe, "formatHtml", true>;
-}
-
-/**
- * Pipe that converts a Markdown string to sanitized HTML using `SystemUtils.markdownToHtml`.
- *
- * Usage: `{{ text | formatMarkdown }}`
- */
-declare class FormatMarkdownPipe implements PipeTransform {
-    private readonly sanitizer;
-    /**
-     * Transforms a Markdown string into sanitized HTML.
-     * @param value - The Markdown input to convert. Treated as an empty string when `undefined`.
-     * @returns A `SafeHtml` value that can be rendered with `[innerHTML]`.
-     */
-    transform(value?: string): SafeHtml;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormatMarkdownPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<FormatMarkdownPipe, "formatMarkdown", true>;
-}
-
-/**
- * General-purpose formatting pipe that converts a raw value to a locale-aware string
- * based on the specified format type.
- *
- * Supported types: `'date'` / `'D'`, `'currency'` / `'C'`, `'number'` / `'N'`,
- * `'number0'` / `'N0'`, `'percentage'` / `'P'`.
- *
- * Usage: `{{ value | format:'currency' }}`
- */
-declare class FormatPipe implements PipeTransform {
-    /** Shared formatters: building an `Intl.NumberFormat` per call is expensive. */
-    private static readonly currencyFormat;
-    private static readonly numberFormat;
-    private static readonly number0Format;
-    private static readonly percentFormat;
-    /**
-     * Formats a value according to the specified type and optional pattern.
-     * Returns `undefined` when the value is `null` or `undefined`, or when the type is unrecognised.
-     * @param value   - The raw value to format.
-     * @param type    - The format type identifier (default: `'date'`).
-     * @param pattern - The date pattern used when `type` is `'date'` (default: `'dd/MM/yyyy'`).
-     * @returns A formatted string, or `undefined` when the value cannot be formatted.
-     */
-    transform(value?: unknown, type?: string, pattern?: string): string | undefined;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormatPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<FormatPipe, "format", true>;
-}
-
-/**
- * Pipe that applies a global regex replacement on a string and returns the result
- * as sanitized HTML. When `regexValue` is `'\n'` and no `replaceValue` is given,
- * newlines are replaced with `<br>` tags.
- *
- * Usage: `{{ text | replace:'\n':'' }}`
- */
-declare class ReplacePipe implements PipeTransform {
-    private readonly sanitizer;
-    /**
-     * Replaces all occurrences of `regexValue` in `value` with `replaceValue`.
-     * Returns `undefined` when `value` is empty or `undefined`.
-     * @param value        - The source string to process.
-     * @param regexValue   - The regex pattern string to match (applied with the global flag).
-     * @param replaceValue - The replacement string. Defaults to `'<br>'` when `regexValue` is `'\n'` and this is falsy.
-     * @returns A `SafeHtml` value with all matches replaced, or `undefined` when the input is empty.
-     */
-    transform(value: string | undefined, regexValue: string, replaceValue?: string): SafeHtml | undefined;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ReplacePipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<ReplacePipe, "replace", true>;
-}
-
-/**
- * Pipe that marks an HTML string as trusted so Angular does not escape it when
- * bound via `[innerHTML]`.
- *
- * Usage: `<div [innerHTML]="html | safeHtml"></div>`
- */
-declare class SafeHtmlPipe implements PipeTransform {
-    private readonly sanitizer;
-    /**
-     * Bypasses Angular's HTML sanitization and returns a `SafeHtml` instance.
-     * @param value - The raw HTML string to trust. Treated as an empty string when `undefined`.
-     * @returns A `SafeHtml` value that can be bound to `[innerHTML]` without escaping.
-     */
-    transform(value?: string): SafeHtml;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SafeHtmlPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<SafeHtmlPipe, "safeHtml", true>;
-}
-
-/**
- * Pipe that marks a URL string as a trusted resource URL so Angular does not block it
- * when bound to attributes such as `[src]` or `[href]` on iframes, objects, or embeds.
- *
- * Usage: `<iframe [src]="url | safeUrl"></iframe>`
- */
-declare class SafeUrlPipe implements PipeTransform {
-    private readonly sanitizer;
-    /**
-     * Bypasses Angular's resource-URL sanitization and returns a `SafeResourceUrl` instance.
-     * @param value - The URL string to trust. Treated as an empty string when `undefined`.
-     * @returns A `SafeResourceUrl` that can be bound to resource URL attributes without blocking.
-     */
-    transform(value?: string): SafeResourceUrl;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SafeUrlPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<SafeUrlPipe, "safeUrl", true>;
-}
-
-/**
- * Impure pipe that filters an array using a caller-provided predicate function.
- * Because the pipe is impure it re-evaluates on every change-detection cycle,
- * which is necessary when the predicate's captured state changes.
- *
- * Usage: `*ngFor="let item of items | callback:myFilter"`
- */
-declare class SearchCallbackPipe implements PipeTransform {
-    /**
-     * Filters `items` by applying `callback` to each element.
-     * Returns the original array unchanged when either argument is falsy.
-     * @param items    - The source array to filter. May be `undefined`.
-     * @param callback - A predicate function that returns `true` for items to keep.
-     * @returns A new filtered array, the original array when no callback is provided,
-     *          or `undefined` when `items` is `undefined`.
-     */
-    transform<T>(items: T[] | undefined, callback: ((item: T) => boolean) | undefined): T[] | undefined;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SearchCallbackPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<SearchCallbackPipe, "callback", true>;
-}
-
-/**
- * Pure pipe that filters an array of searchable items against a text query.
- * Note: being pure, it re-runs only when the array REFERENCE or the query
- * changes; mutate-in-place updates of the array are not detected.
- *
- * Each item is matched either via its `searchBag.name` property (when present)
- * or by converting the item itself to a lowercase string. The optional `metadata`
- * argument is updated in-place with the total item count and the filtered count,
- * making it usable in the template alongside `*ngFor`.
- *
- * Usage:
- * ```html
- * <div *ngFor="let item of items | search:filterText:meta">...</div>
- * <div>Showing {{ meta.count }} of {{ meta.total }}</div>
- * ```
- */
-declare class SearchFilterPipe implements PipeTransform {
-    /**
-     * Filters `items` by performing a case-insensitive substring match against `value`.
-     * When `items` or `value` is falsy the original array is returned unfiltered.
-     * @param items    - The source array to filter. May be `undefined`.
-     * @param value    - The search text to match against each item. May be `undefined`.
-     * @param metadata - Optional object that is updated with `total` and `count` after filtering.
-     * @returns The filtered array, the original array when no filter text is given,
-     *          or `undefined` when `items` is `undefined`.
-     */
-    transform(items?: any[], value?: string, metadata?: SearchFilterMetadata): any[] | undefined;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SearchFilterPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<SearchFilterPipe, "search", true>;
-}
-
-declare enum DateFormat {
-    Short = 1,// dd/mm/yyyy
-    Long = 2,// d mmmm yyyy
-    LongWithShortMonth = 3,// d mmm yyyy
-    LongWithWeekDay = 4,// wwww, d mmmm yyyy
-    LongWithShortWeekDay = 5,// www, d mmmm yyyy
-    MonthAndYear = 6,// mmm yyyy
-    LongMonthAndYear = 7,// mmmm yyyy
-    WeekDay = 8,// www d
-    LongWeekDay = 9,// wwww d
-    DayAndMonth = 10,// d mmmm
-    ShortUS = 11,// mm/dd/yyyy
-    ShortISO8601 = 12
-}
-/**
- * Key selector with IDE autocomplete and compile-time checking.
- *
- * Suggests the string keys of `T` in the editor and flags obvious typos when
- * `T` is known, while STILL accepting any plain string (the `string & {}`
- * branch), so existing callers that pass dynamic or untyped keys keep
- * compiling unchanged.
- */
-type KeyOf<T> = Extract<keyof T, string> | (string & {});
-interface PasswordStrength {
-    score: number;
-    label?: string;
-    color?: string;
-    suggestions?: string[];
-    isValid: boolean;
-}
-declare class SystemUtils {
-    /** Shared collator for locale-aware, case-insensitive string comparison. */
-    private static readonly collator;
-    /**
-     * Array find by key
-     * @param array     : the array to scan
-     * @param key       : key name
-     * @param value     : the value to search for
-     * @returns         : the property value or null
-     */
-    static arrayFindByKey<T>(array: T[] | undefined, key: KeyOf<T>, value: unknown): T | undefined;
-    /**
-     * Array find index by key
-     * @param array   : the array to scan
-     * @param key     : the key name
-     * @param value   : the value to search for
-     * @returns       : the array index or -1 if not found
-     */
-    static arrayFindIndexByKey<T>(array: T[] | undefined, key: KeyOf<T>, value: unknown): number;
+    static arrayFindIndexByKey<T>(array: T[] | undefined, key: KeyOf<T>, value: unknown): number;
     /**
      * Get a value from and array made of name|value items
      * @param array   : the array to scan
@@ -1117,13 +314,6 @@ declare class SystemUtils {
      * @returns The string with URLs replaced by clickable links, or `''` when `s` is falsy.
      */
     static replaceAsHtml(s?: string): string;
-    /**
-     * Convert markdown to html
-     * @param markdown : the markdown data
-     * @param escapeHtml : true to escape HTML. Default is false
-     * @returns the html
-     */
-    static markdownToHtml(markdown: string, escapeHtml?: boolean): string;
     /**
      * Compare two names
      * @param a   : name a
@@ -1289,14 +479,6 @@ declare class SystemUtils {
      * @returns       : a valid Date object or undefined
      */
     static parseDate(value?: string | Date, locale?: Locale): Date | undefined;
-    /**
-     * Format a date
-     * @param value     : the date or string to format
-     * @param fmt       : the DateFormat to use or the string pattern
-     * @param locale    : the locale to use (default is IT)
-     * @returns         : the formatted string
-     */
-    static formatDate(value?: Date | string, fmt?: DateFormat | string, locale?: Locale): string;
     /**
      * Converts a Date, timestamp or ISO string into a Europe/Rome Date whose JSON serialisation
      * emits a naive local datetime string ("yyyy-MM-dd'T'HH:mm:ss"), with no timezone designator,
@@ -1307,6 +489,14 @@ declare class SystemUtils {
      * @returns     : a Europe/Rome Date serialising as naive local time, or undefined for empty/invalid input
      */
     static toLocalDate(value?: Date | number | string): Date | undefined;
+    /**
+     * Format a date
+     * @param value     : the date or string to format
+     * @param fmt       : the DateFormat to use or the string pattern
+     * @param locale    : the locale to use (default is IT)
+     * @returns         : the formatted string
+     */
+    static formatDate(value?: Date | string, fmt?: DateFormat | string, locale?: Locale): string;
     /**
      * Update a DateInterval object according to a string
      * @param value       : string value
@@ -1331,189 +521,679 @@ declare class SystemUtils {
      * @param locale   - BCP 47 locale tag (default: `'it-IT'`).
      * @returns The formatted number string.
      */
-    static formatNumber(value: number, decimals?: number, locale?: string): string;
+    static formatNumber(value: number, decimals?: number, locale?: string): string;
+    /**
+     * Formats a number as a currency string using a cached `Intl.NumberFormat`.
+     * @param value    - The number to format.
+     * @param currency - ISO 4217 currency code (default: `'EUR'`).
+     * @param decimals - Maximum decimal places (default: `2`).
+     * @param locale   - BCP 47 locale tag (default: `'it-IT'`).
+     * @returns The formatted currency string.
+     */
+    static formatCurrency(value: number, currency?: string, decimals?: number, locale?: string): string;
+    /**
+     * Percent-encodes a string for safe inclusion in a URL.
+     * @param value - The string to encode.
+     * @returns The encoded string, or `undefined` when `value` is empty.
+     */
+    static urlEncode(value: string): string | undefined;
+    /**
+     * Decodes a percent-encoded URL string, treating `+` as a space.
+     * @param value - The encoded string to decode.
+     * @returns The decoded string, or `undefined` when `value` is empty or absent.
+     */
+    static urlDecode(value?: string): string | undefined;
+    /**
+     * Reads a query string parameter value from the current page URL.
+     * @param name - The parameter name to look up.
+     * @returns The decoded parameter value, or `undefined` when absent or running server-side.
+     */
+    static getQueryStringValueByName(name: string): string | undefined;
+    /**
+     * Generate a password
+     * @returns : the password string
+     */
+    static generatePassword(length?: number): string;
+    /**
+     * Calculate password strength
+     * @param password: the password to evaluate
+     * @returns the password strength info
+     */
+    static calculatePasswordStrength(password?: string): PasswordStrength;
+    /**
+     * Check if current browser supports touch
+     * @returns : true if the display is touchable
+     */
+    static isTouchable(): boolean;
+    /**
+     * This check will prevent 'window' logic to be executed
+     * while executing the server rendering
+     * @returns : true if using the browser
+     */
+    static isBrowser(): boolean;
+    /**
+     * Convert folders in a tree of Node object.
+     * @param folders : the subfolders group or null to root
+     * @returns       : a node list
+     */
+    static toNodes(folders: INode[]): INode[];
+    /**
+     * Convert folders in a tree of Node object.
+     * @param folders : the children group or null to root
+     * @param parent  : the parent node
+     * @returns       : a node list
+     */
+    private static _toNodes;
+    /**
+     * Returns an array of individual power-of-2 flag values that are set in `value`.
+     * @param value - The bitmask to decompose.
+     * @param max   - Upper-bound exponent: checks flags from `1` up to `1 << max` (default: `30`).
+     * @returns Array of set flag values, or an empty array when `value` is `0`.
+     */
+    static getFlags(value: number, max?: number): number[];
+    /** Cache for resolved color luminance results. */
+    private static readonly colorLightCache;
+    /**
+     * Check if a color is light or dark
+     * @param color : the color
+     * @param minimumLuminance : the lumimance to consider
+     * @returns true if the color is light
+     */
+    static isColorLight(color: string, minimumLuminance?: number): boolean;
+}
+
+/**
+ * Generic selection model that tracks a set of selected items identified by a lookup field.
+ * Wraps Angular CDK's `SelectionModel` and adds lookup-based add/remove logic.
+ *
+ * @typeParam T - The item type held in the selection.
+ * @typeParam V - The type of the lookup key used to identify items.
+ */
+declare class SelectableModel<T, V> {
+    /**
+     * Emits whenever the selection changes.
+     * Carries the affected item, or `undefined` when the whole selection is cleared.
+     *
+     * Note: kept as `EventEmitter` (instead of a plain RxJS `Subject`) for
+     * backward compatibility with existing consumers; `EventEmitter` extends
+     * `Subject`, so `.subscribe()`, `pipe(...)` and `takeUntilDestroyed` all
+     * work as expected.
+     */
+    readonly changed: EventEmitter<T>;
+    private readonly _all;
+    /**
+     * Snapshot of all items currently tracked by this model (selected or previously toggled).
+     * Backed by a signal — reads are always up to date.
+     */
+    get all(): T[];
+    private readonly _current;
+    /** The underlying CDK `SelectionModel` (provides `.selected`, `.isSelected`, etc.). */
+    get current(): SelectionModel<T>;
+    private readonly _lookupFieldName;
+    /** Signal that is `true` when at least one item is tracked in the internal list. */
+    readonly hasValue: i0.Signal<boolean>;
+    /** Signal with the number of items currently tracked in the internal list. */
+    readonly count: i0.Signal<number>;
+    /** Signal that is `true` when exactly one item is currently selected. */
+    readonly selectedOne: i0.Signal<boolean>;
+    /** Signal that is `true` when two or more items are currently selected. */
+    readonly selectedMany: i0.Signal<boolean>;
+    /** Signal that is `true` when at least one element is selected. */
+    readonly selectedAny: i0.Signal<boolean>;
+    /** Signal that is `true` when no item is currently selected. */
+    readonly selectedNone: i0.Signal<boolean>;
+    /** Signal with the first currently selected item, or `undefined` when none is selected. */
+    readonly first: i0.Signal<T>;
+    /**
+     * @param allowMultiSelect - When `true` (default), multiple items can be selected simultaneously.
+     * @param lookupFieldName  - Name of the field used as the unique key when searching the internal list
+     *                           (default: `'id'`). Keys of `T` are autocompleted; plain strings remain accepted.
+     */
+    constructor(allowMultiSelect?: boolean, lookupFieldName?: KeyOf<T>);
+    /**
+     * Toggles the CDK selection state of an item that already exists in the tracked list.
+     * Has no effect when `lookupValue` does not match any tracked item.
+     * @param item        - The item whose selection state should be toggled.
+     * @param lookupValue - The key value used to locate the item in the internal list.
+     */
+    updateCurrent(item: T, lookupValue: V): void;
+    /**
+     * Toggles an item in both the internal list and the CDK selection.
+     * Adds the item when it is not yet tracked; removes it when it is.
+     * @param item        - The item to toggle.
+     * @param lookupValue - The key value used to locate or register the item.
+     */
+    toggle(item: T, lookupValue?: V): void;
+    /**
+     * Adds an item to the internal list (when not already present) and marks it as selected.
+     * @param item        - The item to select.
+     * @param lookupValue - The key value used to locate or register the item.
+     */
+    select(item: T, lookupValue?: V): void;
+    /**
+     * Removes an item from the internal list and deselects it in the CDK model.
+     * Has no effect when the item is not currently tracked.
+     * @param item        - The item to deselect.
+     * @param lookupValue - The key value used to locate the item in the internal list.
+     */
+    deselect(item: T, lookupValue?: V): void;
+    /**
+     * Deselects all items whose lookup key is contained in `lookupValues`.
+     * @param lookupValues - Array of key values identifying the items to deselect.
+     */
+    deselectByValues(lookupValues: V[]): void;
+    /**
+     * Runs `clearFunc` against every currently selected item, then clears the CDK selection.
+     * The internal tracked list is **not** affected; only the CDK selection is cleared.
+     * @param clearFunc - Callback invoked for each currently selected item before clearing.
+     */
+    clearCurrent(clearFunc: (item: T) => void): void;
+    /**
+     * Clears both the internal tracked list and the CDK selection.
+     */
+    clear(): void;
+    /**
+     * Returns `true` when the item identified by `lookupValue` is present in the tracked list.
+     * @param lookupValue - The key value to look up.
+     */
+    isSelected(lookupValue?: V): boolean;
+}
+
+/**
+ * Directive that moves browser focus to the host element after the first render cycle.
+ * Apply `autoFocus` to any focusable element to set focus automatically on initialisation.
+ */
+declare class AutoFocusDirective {
+    private readonly elementRef;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AutoFocusDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AutoFocusDirective, "[autoFocus]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that listens to `keyup` events on a date input and debounces changes
+ * into a {@link DateInterval} model, converting shorthand strings (e.g. "d/m") to dates.
+ * Apply `[dateIntervalChange]="interval"` to the host `<input>` element.
+ */
+declare class DateIntervalChangeDirective {
+    /** The date interval model to update when the input value changes. */
+    readonly dateIntervalChange: i0.InputSignal<DateInterval>;
+    /** When `true`, the directive updates the interval's end date; otherwise the start date. */
+    readonly end: i0.InputSignal<boolean>;
+    private readonly subject;
+    private readonly destroyRef;
+    constructor();
+    /**
+     * Handles `keydown` events on the host element.
+     * The space key must be blocked HERE: by the time `keyup` fires the character
+     * has already been inserted into the input, so `preventDefault` on `keyup`
+     * cannot stop it.
+     * @param e - The keyboard event emitted by the host input.
+     */
+    onKeydown(e: KeyboardEvent): void;
+    /**
+     * Handles `keyup` events on the host element and forwards them to the debounce pipeline.
+     * @param e - The keyboard event emitted by the host input.
+     */
+    onKeyup(e: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DateIntervalChangeDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<DateIntervalChangeDirective, "[dateIntervalChange]", never, { "dateIntervalChange": { "alias": "dateIntervalChange"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that copies a string payload to the clipboard when the host element is clicked.
+ * Bind `[copyClipboard]="text"` to provide the content to copy and listen to `(copied)` for confirmation.
+ */
+declare class CopyClipboardDirective {
+    /** The text to copy to the clipboard. Bound via the `copyClipboard` attribute. */
+    readonly payload: i0.InputSignal<string>;
+    /** Emits the copied text after a successful copy operation. */
+    readonly copied: i0.OutputEmitterRef<string>;
+    /**
+     * Handles click events on the host element and copies the payload to the clipboard.
+     * Emits `copied` with the copied text on success.
+     * @param e - The mouse click event.
+     */
+    onClick(e: MouseEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CopyClipboardDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CopyClipboardDirective, "[copyClipboard]", never, { "payload": { "alias": "copyClipboard"; "required": false; "isSignal": true; }; }, { "copied": "copied"; }, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a semicolon-separated list of email addresses.
+ * Apply `emails` to a text input containing one or more addresses separated by `;`.
+ */
+declare class EmailsValidatorDirective implements Validator {
+    /**
+     * Validates each address in a semicolon-separated email list.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EmailsValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<EmailsValidatorDirective, "[emails]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that the host control's value equals the value of another control.
+ * Bind `[equals]="otherControl"`.
+ *
+ * The host control is re-validated whenever the OTHER control's value changes:
+ * without this, typing a new password AFTER the confirmation field was filled
+ * left the form incorrectly valid (the classic password/confirm bug).
+ *
+ * IMPORTANT (reciprocal-binding safety): the re-validation triggered from the
+ * other control's `valueChanges` runs with `{ emitEvent: false }`. Calling
+ * Angular's `onValidatorChange` instead would re-emit valueChanges, so a
+ * reciprocal setup (A [equals]=B and B [equals]=A) would overflow the stack.
+ */
+declare class EqualsValidatorDirective implements Validator {
+    /** The control whose value must match the host control's value. */
+    readonly equals: i0.InputSignal<AbstractControl<any, any, any>>;
+    /** The host control, captured on the first validate() call. */
+    private hostControl?;
+    /** Subscription to the other control's valueChanges. */
+    private subscription?;
+    constructor();
     /**
-     * Formats a number as a currency string using a cached `Intl.NumberFormat`.
-     * @param value    - The number to format.
-     * @param currency - ISO 4217 currency code (default: `'EUR'`).
-     * @param decimals - Maximum decimal places (default: `2`).
-     * @param locale   - BCP 47 locale tag (default: `'it-IT'`).
-     * @returns The formatted currency string.
+     * Validates that the host control value equals the bound control's value.
+     * Returns `null` (valid) when no control is bound.
+     * @param control - The form control to validate.
+     * @returns `null` when valid, `{ equals: ... }` otherwise.
      */
-    static formatCurrency(value: number, currency?: string, decimals?: number, locale?: string): string;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EqualsValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<EqualsValidatorDirective, "[equals]", never, { "equals": { "alias": "equals"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a file size against configurable minimum and maximum bounds.
+ * Bind `[fileSize]` together with `[size]="fileSizeInMb"`, `[maxSizeMb]`, and `[minSizeMb]`.
+ */
+declare class FileSizeValidatorDirective implements Validator {
+    /** Maximum allowed file size in megabytes. Defaults to 5. */
+    readonly maxSizeMb: i0.InputSignal<number>;
+    /** Minimum required file size in megabytes. Defaults to 0. */
+    readonly minSizeMb: i0.InputSignal<number>;
+    /** The actual file size in megabytes to validate against the bounds. */
+    readonly size: i0.InputSignal<number>;
     /**
-     * Percent-encodes a string for safe inclusion in a URL.
-     * @param value - The string to encode.
-     * @returns The encoded string, or `undefined` when `value` is empty.
+     * Validates that the bound file size falls within the configured min/max range.
+     * Returns `null` when no control value is present.
+     * @param control - The form control to validate.
      */
-    static urlEncode(value: string): string | undefined;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FileSizeValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<FileSizeValidatorDirective, "[fileSize]", never, { "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "minSizeMb": { "alias": "minSizeMb"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a control value as a GUID / UUID string.
+ * Apply `guid` to a text input that expects a valid UUID.
+ */
+declare class GuidValidatorDirective implements Validator {
     /**
-     * Decodes a percent-encoded URL string, treating `+` as a space.
-     * @param value - The encoded string to decode.
-     * @returns The decoded string, or `undefined` when `value` is empty or absent.
+     * Validates that the control value is a well-formed GUID / UUID.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
      */
-    static urlDecode(value?: string): string | undefined;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GuidValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<GuidValidatorDirective, "[guid]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that a control value does not exceed a maximum word count.
+ * Bind `[maxTerms]="10"` to allow at most 10 whitespace-separated terms.
+ */
+declare class MaxTermsValidatorDirective implements Validator {
+    /** The maximum number of whitespace-separated terms allowed. */
+    readonly maxTerms: i0.InputSignal<number>;
     /**
-     * Reads a query string parameter value from the current page URL.
-     * @param name - The parameter name to look up.
-     * @returns The decoded parameter value, or `undefined` when absent or running server-side.
+     * Validates that the control value contains no more than the configured number of terms.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
      */
-    static getQueryStringValueByName(name: string): string | undefined;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MaxTermsValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MaxTermsValidatorDirective, "[maxTerms]", never, { "maxTerms": { "alias": "maxTerms"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that a string control value is not blank (whitespace-only).
+ * Apply `notEmpty` to a text input where non-blank content is required.
+ */
+declare class NotEmptyValidatorDirective implements Validator {
     /**
-     * Generate a password
-     * @returns : the password string
+     * Validates that the control value is a non-blank string.
+     * Returns `null` when the control is empty or not a string.
+     * @param control - The form control to validate.
      */
-    static generatePassword(length?: number): string;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotEmptyValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NotEmptyValidatorDirective, "[notEmpty]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that the host control's value is different from another control's value.
+ * Bind `[notEqual]="otherControl"`.
+ *
+ * The host control is re-validated whenever the OTHER control's value changes,
+ * so editing either field keeps both error states consistent.
+ *
+ * IMPORTANT (reciprocal-binding safety): the re-validation triggered from the
+ * other control's `valueChanges` is run with `{ emitEvent: false }`. Using
+ * Angular's `onValidatorChange` here instead would call `host.updateValueAndValidity()`
+ * WITH events, so a reciprocal setup (A [notEqual]=B and B [notEqual]=A) would
+ * ping-pong valueChanges between the two controls and overflow the stack.
+ */
+declare class NotEqualValidatorDirective implements Validator {
+    /** The control whose value must differ from the host control's value. */
+    readonly notEqual: i0.InputSignal<AbstractControl<any, any, any>>;
+    /** The host control, captured on the first validate() call. */
+    private hostControl?;
+    /** Subscription to the other control's valueChanges. */
+    private subscription?;
+    constructor();
     /**
-     * Calculate password strength
-     * @param password: the password to evaluate
-     * @returns the password strength info
+     * Validates that the host control value is not equal to the bound control's value.
+     * Also clears the `notequal` error on the other control when the host becomes valid.
+     * Returns `null` (valid) when no control is bound.
+     * @param control - The form control to validate.
+     * @returns `null` when valid, `{ notequal: true }` otherwise.
      */
-    static calculatePasswordStrength(password?: string): PasswordStrength;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotEqualValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NotEqualValidatorDirective, "[notEqual]", never, { "notEqual": { "alias": "notEqual"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that a control value is not a future date.
+ * Apply `notFuture` to a text input that expects a date on or before today.
+ */
+declare class NotFutureValidatorDirective implements Validator {
     /**
-     * Check if current browser supports touch
-     * @returns : true if the display is touchable
+     * Validates that the control value represents a date that is not in the future.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
      */
-    static isTouchable(): boolean;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotFutureValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NotFutureValidatorDirective, "[notFuture]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a control value as a sufficiently strong password.
+ * Apply `password` to a password input.
+ */
+declare class PasswordValidatorDirective implements Validator {
     /**
-     * This check will prevent 'window' logic to be executed
-     * while executing the server rendering
-     * @returns : true if using the browser
+     * Validates that the control value meets the minimum password-strength requirements.
+     * @param control - The form control to validate.
      */
-    static isBrowser(): boolean;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PasswordValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PasswordValidatorDirective, "[password]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that removes focus from the host element after it is clicked,
+ * preventing the browser from keeping a visible focus ring post-interaction.
+ * Apply `removeFocus` to any focusable element (e.g. a button).
+ */
+declare class RemoveFocusDirective {
+    private readonly elementRef;
     /**
-     * Convert folders in a tree of Node object.
-     * @param folders : the subfolders group or null to root
-     * @returns       : a node list
+     * Handles click events on the host element and blurs it on the next event-loop tick
+     * so that the click action completes before focus is removed.
      */
-    static toNodes(folders: INode[]): INode[];
+    onClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RemoveFocusDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RemoveFocusDirective, "[removeFocus]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a control value as a parseable SQL-compatible date string.
+ * Apply `sqlDate` to a text input that expects a date after year 1750.
+ */
+declare class SqlDateValidatorDirective implements Validator {
     /**
-     * Convert folders in a tree of Node object.
-     * @param folders : the children group or null to root
-     * @param parent  : the parent node
-     * @returns       : a node list
+     * Validates that the control value can be parsed as a date after 1750.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
      */
-    private static _toNodes;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SqlDateValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SqlDateValidatorDirective, "[sqlDate]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a time string against optional allowed time slot ranges.
+ * Bind `[time]` and optionally `[slots]="'08:00-12:00|14:00-18:00'"` (pipe-separated ranges).
+ */
+declare class TimeValidatorDirective implements Validator {
+    /** Optional pipe-separated list of allowed time ranges, e.g. `"08:00-12:00|14:00-18:00"`. */
+    readonly slots: i0.InputSignal<string>;
     /**
-     * Returns an array of individual power-of-2 flag values that are set in `value`.
-     * @param value - The bitmask to decompose.
-     * @param max   - Upper-bound exponent: checks flags from `1` up to `1 << max` (default: `30`).
-     * @returns Array of set flag values, or an empty array when `value` is `0`.
+     * Parses a `"HH:MM"` time string into a comparable integer (e.g. `"09:30"` -> `930`).
+     * Returns `-1` when the string is not a valid time.
+     * @param value - The time string to parse.
      */
-    static getFlags(value: number, max?: number): number[];
-    /** Cache for resolved color luminance results. */
-    private static readonly colorLightCache;
+    private getTime;
     /**
-     * Check if a color is light or dark
-     * @param color : the color
-     * @param minimumLuminance : the lumimance to consider
-     * @returns true if the color is light
+     * Validates that the control value is a valid time string and, when slots are configured,
+     * that it falls within at least one of the allowed ranges.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
      */
-    static isColorLight(color: string, minimumLuminance?: number): boolean;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TimeValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<TimeValidatorDirective, "[time]", never, { "slots": { "alias": "slots"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare const UtilsMessages: {
+/**
+ * Directive that validates a control value as a well-formed URL.
+ * Apply `url` to a text input that expects a URL.
+ */
+declare class UrlValidatorDirective implements Validator {
     /**
-     * Messages
+     * Validates that the control value is a well-formed URL.
+     * Returns `null` (valid) when the control is empty.
+     * @param control - The form control to validate.
      */
-    UTILS_DIALOGS_SELECT_OPTIONS_CHANGED: string;
-};
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UrlValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<UrlValidatorDirective, "[url]", never, {}, {}, never, never, true, never>;
+}
 
 /**
- * Generic selection model that tracks a set of selected items identified by a lookup field.
- * Wraps Angular CDK's `SelectionModel` and adds lookup-based add/remove logic.
- *
- * @typeParam T - The item type held in the selection.
- * @typeParam V - The type of the lookup key used to identify items.
+ * Directive that validates a control using the host object's `isValid()` method
+ * or a boolean expression passed via `[validIf]`.
  */
-declare class SelectableModel<T, V> {
-    /**
-     * Emits whenever the selection changes.
-     * Carries the affected item, or `undefined` when the whole selection is cleared.
-     *
-     * Note: kept as `EventEmitter` (instead of a plain RxJS `Subject`) for
-     * backward compatibility with existing consumers; `EventEmitter` extends
-     * `Subject`, so `.subscribe()`, `pipe(...)` and `takeUntilDestroyed` all
-     * work as expected.
-     */
-    readonly changed: EventEmitter<T>;
-    private readonly _all;
-    /**
-     * Snapshot of all items currently tracked by this model (selected or previously toggled).
-     * Backed by a signal — reads are always up to date.
-     */
-    get all(): T[];
-    private readonly _current;
-    /** The underlying CDK `SelectionModel` (provides `.selected`, `.isSelected`, etc.). */
-    get current(): SelectionModel<T>;
-    private readonly _lookupFieldName;
-    /** Signal that is `true` when at least one item is tracked in the internal list. */
-    readonly hasValue: i0.Signal<boolean>;
-    /** Signal with the number of items currently tracked in the internal list. */
-    readonly count: i0.Signal<number>;
-    /** Signal that is `true` when exactly one item is currently selected. */
-    readonly selectedOne: i0.Signal<boolean>;
-    /** Signal that is `true` when two or more items are currently selected. */
-    readonly selectedMany: i0.Signal<boolean>;
-    /** Signal that is `true` when no item is currently selected. */
-    readonly selectedNone: i0.Signal<boolean>;
-    /** Signal with the first currently selected item, or `undefined` when none is selected. */
-    readonly selectedFirst: i0.Signal<T>;
-    /** Signal with a snapshot of all currently selected items. */
-    readonly selectedAll: i0.Signal<T[]>;
+declare class ValidIfDirective implements Validator {
+    /** When `true`, the control is considered valid regardless of the bound value. */
+    readonly validIf: i0.InputSignal<boolean>;
     /**
-     * @param allowMultiSelect - When `true` (default), multiple items can be selected simultaneously.
-     * @param lookupFieldName  - Name of the field used as the unique key when searching the internal list
-     *                           (default: `'id'`). Keys of `T` are autocompleted; plain strings remain accepted.
+     * Validates the control value against a boolean flag or the value's own `isValid()` method.
+     * @param control - The form control to validate.
      */
-    constructor(allowMultiSelect?: boolean, lookupFieldName?: KeyOf<T>);
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ValidIfDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ValidIfDirective, "[validIf]", never, { "validIf": { "alias": "validIf"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that delegates validation to an externally provided validator function.
+ * Bind `[validator]="myFn"` where `myFn` is `(c: AbstractControl) => ValidationErrors | null`.
+ */
+declare class ValidatorDirective implements Validator {
+    /** The custom validator function to apply. */
+    readonly validator: i0.InputSignal<(control: AbstractControl) => ValidationErrors | null>;
     /**
-     * Toggles the CDK selection state of an item that already exists in the tracked list.
-     * Has no effect when `lookupValue` does not match any tracked item.
-     * @param item        - The item whose selection state should be toggled.
-     * @param lookupValue - The key value used to locate the item in the internal list.
+     * Invokes the provided validator function against the given control.
+     * Returns `null` (valid) when no function is bound.
+     * @param control - The form control to validate.
      */
-    updateCurrent(item: T, lookupValue: V): void;
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ValidatorDirective, "[validator]", never, { "validator": { "alias": "validator"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Pipe that converts plain-text newlines (`\r\n`, `\r`, `\n`) to HTML `<br>` tags
+ * and marks the result as trusted HTML so Angular does not escape it.
+ *
+ * Usage: `{{ text | formatHtml }}`
+ */
+declare class FormatHtmlPipe implements PipeTransform {
+    private readonly sanitizer;
     /**
-     * Toggles an item in both the internal list and the CDK selection.
-     * Adds the item when it is not yet tracked; removes it when it is.
-     * @param item        - The item to toggle.
-     * @param lookupValue - The key value used to locate or register the item.
+     * Transforms a plain-text string into sanitized HTML by replacing newline characters
+     * with `<br>` tags.
+     * @param value - The input string to transform. Treated as an empty string when `undefined`.
+     * @returns A `SafeHtml` value that can be rendered with `[innerHTML]`.
      */
-    toggle(item: T, lookupValue?: V): void;
+    transform(value?: string): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormatHtmlPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<FormatHtmlPipe, "formatHtml", true>;
+}
+
+/**
+ * General-purpose formatting pipe that converts a raw value to a locale-aware string
+ * based on the specified format type.
+ *
+ * Supported types: `'date'` / `'D'`, `'currency'` / `'C'`, `'number'` / `'N'`,
+ * `'number0'` / `'N0'`, `'percentage'` / `'P'`.
+ *
+ * Usage: `{{ value | format:'currency' }}`
+ */
+declare class FormatPipe implements PipeTransform {
+    /** Shared formatters: building an `Intl.NumberFormat` per call is expensive. */
+    private static readonly currencyFormat;
+    private static readonly numberFormat;
+    private static readonly number0Format;
+    private static readonly percentFormat;
     /**
-     * Adds an item to the internal list (when not already present) and marks it as selected.
-     * @param item        - The item to select.
-     * @param lookupValue - The key value used to locate or register the item.
+     * Formats a value according to the specified type and optional pattern.
+     * Returns `undefined` when the value is `null` or `undefined`, or when the type is unrecognised.
+     * @param value   - The raw value to format.
+     * @param type    - The format type identifier (default: `'date'`).
+     * @param pattern - The date pattern used when `type` is `'date'` (default: `'dd/MM/yyyy'`).
+     * @returns A formatted string, or `undefined` when the value cannot be formatted.
      */
-    select(item: T, lookupValue?: V): void;
+    transform(value?: unknown, type?: string, pattern?: string): string | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormatPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<FormatPipe, "format", true>;
+}
+
+/**
+ * Pipe that applies a global regex replacement on a string and returns the result
+ * as sanitized HTML. When `regexValue` is `'\n'` and no `replaceValue` is given,
+ * newlines are replaced with `<br>` tags.
+ *
+ * Usage: `{{ text | replace:'\n':'' }}`
+ */
+declare class ReplacePipe implements PipeTransform {
+    private readonly sanitizer;
     /**
-     * Removes an item from the internal list and deselects it in the CDK model.
-     * Has no effect when the item is not currently tracked.
-     * @param item        - The item to deselect.
-     * @param lookupValue - The key value used to locate the item in the internal list.
+     * Replaces all occurrences of `regexValue` in `value` with `replaceValue`.
+     * Returns `undefined` when `value` is empty or `undefined`.
+     * @param value        - The source string to process.
+     * @param regexValue   - The regex pattern string to match (applied with the global flag).
+     * @param replaceValue - The replacement string. Defaults to `'<br>'` when `regexValue` is `'\n'` and this is falsy.
+     * @returns A `SafeHtml` value with all matches replaced, or `undefined` when the input is empty.
      */
-    deselect(item: T, lookupValue?: V): void;
+    transform(value: string | undefined, regexValue: string, replaceValue?: string): SafeHtml | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReplacePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ReplacePipe, "replace", true>;
+}
+
+/**
+ * Pipe that marks an HTML string as trusted so Angular does not escape it when
+ * bound via `[innerHTML]`.
+ *
+ * Usage: `<div [innerHTML]="html | safeHtml"></div>`
+ */
+declare class SafeHtmlPipe implements PipeTransform {
+    private readonly sanitizer;
     /**
-     * Deselects all items whose lookup key is contained in `lookupValues`.
-     * @param lookupValues - Array of key values identifying the items to deselect.
+     * Bypasses Angular's HTML sanitization and returns a `SafeHtml` instance.
+     * @param value - The raw HTML string to trust. Treated as an empty string when `undefined`.
+     * @returns A `SafeHtml` value that can be bound to `[innerHTML]` without escaping.
      */
-    deselectByValues(lookupValues: V[]): void;
+    transform(value?: string): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SafeHtmlPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SafeHtmlPipe, "safeHtml", true>;
+}
+
+/**
+ * Pipe that marks a URL string as a trusted resource URL so Angular does not block it
+ * when bound to attributes such as `[src]` or `[href]` on iframes, objects, or embeds.
+ *
+ * Usage: `<iframe [src]="url | safeUrl"></iframe>`
+ */
+declare class SafeUrlPipe implements PipeTransform {
+    private readonly sanitizer;
     /**
-     * Runs `clearFunc` against every currently selected item, then clears the CDK selection.
-     * The internal tracked list is **not** affected; only the CDK selection is cleared.
-     * @param clearFunc - Callback invoked for each currently selected item before clearing.
+     * Bypasses Angular's resource-URL sanitization and returns a `SafeResourceUrl` instance.
+     * @param value - The URL string to trust. Treated as an empty string when `undefined`.
+     * @returns A `SafeResourceUrl` that can be bound to resource URL attributes without blocking.
      */
-    clearCurrent(clearFunc: (item: T) => void): void;
+    transform(value?: string): SafeResourceUrl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SafeUrlPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SafeUrlPipe, "safeUrl", true>;
+}
+
+/**
+ * Impure pipe that filters an array using a caller-provided predicate function.
+ * Because the pipe is impure it re-evaluates on every change-detection cycle,
+ * which is necessary when the predicate's captured state changes.
+ *
+ * Usage: `*ngFor="let item of items | callback:myFilter"`
+ */
+declare class SearchCallbackPipe implements PipeTransform {
     /**
-     * Clears both the internal tracked list and the CDK selection.
+     * Filters `items` by applying `callback` to each element.
+     * Returns the original array unchanged when either argument is falsy.
+     * @param items    - The source array to filter. May be `undefined`.
+     * @param callback - A predicate function that returns `true` for items to keep.
+     * @returns A new filtered array, the original array when no callback is provided,
+     *          or `undefined` when `items` is `undefined`.
      */
-    clear(): void;
+    transform<T>(items: T[] | undefined, callback: ((item: T) => boolean) | undefined): T[] | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SearchCallbackPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SearchCallbackPipe, "callback", true>;
+}
+
+/**
+ * Pure pipe that filters an array of searchable items against a text query.
+ * Note: being pure, it re-runs only when the array REFERENCE or the query
+ * changes; mutate-in-place updates of the array are not detected.
+ *
+ * Each item is matched either via its `searchBag.name` property (when present)
+ * or by converting the item itself to a lowercase string. The optional `metadata`
+ * argument is updated in-place with the total item count and the filtered count,
+ * making it usable in the template alongside `*ngFor`.
+ *
+ * Usage:
+ * ```html
+ * <div *ngFor="let item of items | search:filterText:meta">...</div>
+ * <div>Showing {{ meta.count }} of {{ meta.total }}</div>
+ * ```
+ */
+declare class SearchFilterPipe implements PipeTransform {
     /**
-     * Returns `true` when the item identified by `lookupValue` is present in the tracked list.
-     * @param lookupValue - The key value to look up.
+     * Filters `items` by performing a case-insensitive substring match against `value`.
+     * When `items` or `value` is falsy the original array is returned unfiltered.
+     * @param items    - The source array to filter. May be `undefined`.
+     * @param value    - The search text to match against each item. May be `undefined`.
+     * @param metadata - Optional object that is updated with `total` and `count` after filtering.
+     * @returns The filtered array, the original array when no filter text is given,
+     *          or `undefined` when `items` is `undefined`.
      */
-    isSelected(lookupValue?: V): boolean;
+    transform(items?: any[], value?: string, metadata?: SearchFilterMetadata): any[] | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SearchFilterPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SearchFilterPipe, "search", true>;
 }
 
 /**
@@ -1894,5 +1574,5 @@ declare class ThemeService implements OnDestroy {
     static ɵprov: i0.ɵɵInjectableDeclaration<ThemeService>;
 }
 
-export { ARS_TIME_ZONE, ArsLocalDateInterceptor, AutoFocusDirective, BroadcastChannelManager, BroadcastService, CHANNEL_NAME, CopyClipboardDirective, DEFAULT_TIME_ZONE, DateFnsAdapter, DateFormat, DateInterval, DateIntervalChangeDirective, DeleteModel, EmailsValidatorDirective, EnvironmentService, EqualsValidatorDirective, FileInfo, FileSizeValidatorDirective, FormatHtmlPipe, FormatMarkdownPipe, FormatPipe, GroupModel, GuidValidatorDirective, IDModel, ImportModel, LoginOAuthType, MAT_DATE_FNS_FORMATS, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, QueryModel, RelationModel, RemoveFocusDirective, ReplacePipe, SafeHtmlPipe, SafeUrlPipe, ScreenService, SearchCallbackPipe, SearchFilterPipe, SelectableModel, SplashService, SqlDateValidatorDirective, SystemUtils, ThemeService, TimeValidatorDirective, UpdateRelationsModel, UrlValidatorDirective, UtilsMessages, ValidIfDirective, ValidatorDirective, ValueModel, arsLocalDateInterceptor, provideArsDateFns, provideArsLocalDates, toLocalDateOnlyString, toLocalDateTimeString };
+export { AutoFocusDirective, BroadcastChannelManager, BroadcastService, CHANNEL_NAME, CopyClipboardDirective, DateFormat, DateInterval, DateIntervalChangeDirective, DeleteModel, EmailsValidatorDirective, EnvironmentService, EqualsValidatorDirective, FileInfo, FileSizeValidatorDirective, FormatHtmlPipe, FormatPipe, GroupModel, GuidValidatorDirective, IDModel, ImportModel, LoginOAuthType, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, QueryModel, RelationModel, RemoveFocusDirective, ReplacePipe, SafeHtmlPipe, SafeUrlPipe, ScreenService, SearchCallbackPipe, SearchFilterPipe, SelectableModel, SplashService, SqlDateValidatorDirective, SystemUtils, ThemeService, TimeValidatorDirective, UpdateRelationsModel, UrlValidatorDirective, UtilsMessages, ValidIfDirective, ValidatorDirective, ValueModel };
 export type { AddModel, AddResultModel, ApiResponse, ApiResult, BroadcastChannelMessageBag, BroadcastChannelSubscriberInfo, BroadcastMessageInfo, BroadcastMessageToastData, Checkable, DeleteResultModel, DoneResult, EnableDisableModel, ErrorInfo, File, Folder, FolderTree, INode, KeyOf, LoginOAuthResult, LoginResult, NameValueItem, PasswordStrength, QueryResultModel, SearchBag, SearchFilterMetadata, Searchable, SendToModel, ThemeType, UpdateModel, UpdateResultModel, Validated };