@arsedizioni/ars-utils 22.6.85 → 22.6.88

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

@@ -1,187 +1,184 @@
-import * as i0 from '@angular/core';
-import { EventEmitter, PipeTransform, OnDestroy, Signal } from '@angular/core';
-import { SelectionModel } from '@angular/cdk/collections';
-import { Locale } from 'date-fns';
-import { SafeHtml, SafeResourceUrl } from '@angular/platform-browser';
-import { Observable } from 'rxjs';
-
-interface INode {
-    id: string;
-    name: string;
-    count?: number;
-    children?: INode[];
-    subFolders?: INode[];
-    parent?: INode;
-    level?: number;
-    bag?: unknown;
+import * as i0 from "@angular/core";
+import { EventEmitter, OnDestroy, PipeTransform, Signal } from "@angular/core";
+import { SelectionModel } from "@angular/cdk/collections";
+import { Locale } from "date-fns";
+import { SafeHtml, SafeResourceUrl } from "@angular/platform-browser";
+import { Observable } from "rxjs";
+export interface INode {
+  id: string;
+  name: string;
+  count?: number;
+  children?: INode[];
+  subFolders?: INode[];
+  parent?: INode;
+  level?: number;
+  bag?: unknown;
 }
-interface DoneResult<T> {
-    isNew?: boolean;
-    data?: T;
+export interface DoneResult<T> {
+  isNew?: boolean;
+  data?: T;
 }
-interface ApiResponse {
-    success: boolean;
-    message: string;
+export interface ApiResponse {
+  success: boolean;
+  message: string;
 }
-interface ApiResult<T> extends ApiResponse {
-    value: T;
+export interface ApiResult<T> extends ApiResponse {
+  value: T;
 }
-interface Folder extends INode {
-    teamId?: string;
-    parentId?: string;
-    position?: number;
-    isPrivate?: boolean;
-    itemsCount?: number;
-    subItemsCount?: number;
+export interface Folder extends INode {
+  teamId?: string;
+  parentId?: string;
+  position?: number;
+  isPrivate?: boolean;
+  itemsCount?: number;
+  subItemsCount?: number;
 }
-interface FolderTree extends Folder {
-    children?: Folder[];
-    path?: string;
+export interface FolderTree extends Folder {
+  children?: Folder[];
+  path?: string;
 }
-interface File<T> {
-    ownerId?: T;
-    id?: number;
-    fileName: string;
-    fileData: unknown;
+export interface File<T> {
+  ownerId?: T;
+  id?: number;
+  fileName: string;
+  fileData: unknown;
 }
-interface Validated {
-    isValid(): boolean;
+export interface Validated {
+  isValid(): boolean;
 }
-declare class FileInfo implements Validated {
-    file: any;
-    valid: boolean;
-    isValid(): boolean;
+export declare class FileInfo implements Validated {
+  file: any;
+  valid: boolean;
+  isValid(): boolean;
 }
-interface ErrorInfo {
-    invalidateSession?: boolean;
-    title?: string;
-    message?: string;
-    errorStatus?: number;
-    service?: string;
+export interface ErrorInfo {
+  invalidateSession?: boolean;
+  title?: string;
+  message?: string;
+  errorStatus?: number;
+  service?: string;
 }
-interface NameValueItem<T> {
-    name: string;
-    value: T;
-    shortName?: string;
-    parentName?: string;
-    parentValue?: T;
-    header?: string;
-    bag?: any;
-    bagInfo?: string;
-    disabled?: boolean;
-    selected?: boolean;
+export interface NameValueItem<T> {
+  name: string;
+  value: T;
+  shortName?: string;
+  parentName?: string;
+  parentValue?: T;
+  header?: string;
+  bag?: any;
+  bagInfo?: string;
+  disabled?: boolean;
+  selected?: boolean;
 }
-interface Checkable {
-    checked?: boolean;
-    bag: unknown;
-    getId(): unknown;
+export interface Checkable {
+  checked?: boolean;
+  bag: unknown;
+  getId(): unknown;
 }
-declare class ValueModel<T> {
-    value: T;
+export declare class ValueModel<T> {
+  value: T;
 }
-declare class IDModel<T = number> {
-    id: T;
+export declare class IDModel<T = number> {
+  id: T;
 }
-declare class GroupModel<T = number> {
-    ids: T[];
+export declare class GroupModel<T = number> {
+  ids: T[];
 }
-declare class DeleteModel<T = number> extends GroupModel<T> {
-    mode?: number;
-    parentId?: T;
+export declare class DeleteModel<T = number> extends GroupModel<T> {
+  mode?: number;
+  parentId?: T;
 }
-interface DeleteResultModel<T> {
-    items?: T[];
-    deleted: number;
-    total: number;
-    log?: string;
+export interface DeleteResultModel<T> {
+  items?: T[];
+  deleted: number;
+  total: number;
+  log?: string;
 }
-declare class RelationModel<T = number> {
-    id: T;
-    parentId: T;
+export declare class RelationModel<T = number> {
+  id: T;
+  parentId: T;
 }
-declare class UpdateRelationsModel<T = number> {
-    id: T;
-    relatedIds: T[];
+export 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
+export 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;
+export interface LoginOAuthResult {
+  type: LoginOAuthType;
+  token: string;
 }
-declare class QueryModel {
-    any?: string;
-    sortBy?: string;
-    sortDescending?: boolean;
-    first?: number;
-    count?: number;
+export declare class QueryModel {
+  any?: string;
+  sortBy?: string;
+  sortDescending?: boolean;
+  first?: number;
+  count?: number;
 }
-interface QueryResultModel<T> {
-    interval?: string;
-    items: T[];
-    total: number;
+export interface QueryResultModel<T> {
+  interval?: string;
+  items: T[];
+  total: number;
 }
-interface UpdateModel<T = number> {
-    parentId?: T;
-    ids: T[];
+export interface UpdateModel<T = number> {
+  parentId?: T;
+  ids: T[];
 }
-interface UpdateResultModel<T> {
-    items?: T[];
-    updated: number;
-    total: number;
-    log?: string;
+export interface UpdateResultModel<T> {
+  items?: T[];
+  updated: number;
+  total: number;
+  log?: string;
 }
-interface AddModel<T> extends UpdateModel<T> {
+export interface AddModel<T> extends UpdateModel<T> {}
+export interface AddResultModel<T> {
+  items?: T[];
+  added: number;
+  total: number;
+  log?: string;
 }
-interface AddResultModel<T> {
-    items?: T[];
-    added: number;
-    total: number;
-    log?: string;
+export declare class ImportModel {
+  origin: string;
+  dataFile: FileInfo;
+  jumpFirstLine?: boolean;
+  map?: unknown;
 }
-declare class ImportModel {
-    origin: string;
-    dataFile: FileInfo;
-    jumpFirstLine?: boolean;
-    map?: unknown;
+export interface EnableDisableModel {
+  value: boolean;
 }
-interface EnableDisableModel {
-    value: boolean;
+export interface SendToModel {
+  sendToRecipients?: string;
+  sendToSubject?: string;
+  sendToText?: string;
 }
-interface SendToModel {
-    sendToRecipients?: string;
-    sendToSubject?: string;
-    sendToText?: string;
+export interface SearchBag {
+  name: string;
 }
-interface SearchBag {
-    name: string;
+export interface Searchable {
+  searchBag: SearchBag;
 }
-interface Searchable {
-    searchBag: SearchBag;
+export interface SearchFilterMetadata {
+  total: number;
+  count: number;
 }
-interface SearchFilterMetadata {
-    total: number;
-    count: number;
+export declare class DateInterval {
+  from?: Date;
+  to?: Date;
+  get fromAsDate(): Date | undefined;
+  get toAsDate(): Date | undefined;
+  constructor(from?: Date, to?: Date);
+  clear(): void;
 }
-declare class DateInterval {
-    from?: Date;
-    to?: Date;
-    get fromAsDate(): Date | undefined;
-    get toAsDate(): Date | undefined;
-    constructor(from?: Date, to?: Date);
-    clear(): void;
+export interface LoginResult<T> extends ApiResult<boolean> {
+  context?: T;
+  oauth?: number;
+  requiresMfa?: boolean;
 }
-interface LoginResult<T> extends ApiResult<boolean> {
-    context?: T;
-    oauth?: number;
-    requiresMfa?: boolean;
-}
-
 /**
  * Conversions between the objects the API speaks (DTOs) and the models a signal form works with.
  *
@@ -245,71 +242,78 @@ interface LoginResult<T> extends ApiResult<boolean> {
  * `string` (which is what `''` widens to) narrows to `string`. That is the reason a date field is
  * `Date | null` and never `Date | string`: the latter could not be narrowed at all.
  */
-type Dto<TModel> = {
-    [K in keyof TModel]: Exclude<TModel[K], '' | null>;
-};
+export type Dto<TModel> = { [K in keyof TModel]: Exclude<TModel[K], '' | null>; };
 /** The two conversions between an API DTO and the model a signal form works with. */
-declare class DtoUtils {
-    /**
-     * Builds a form model from the object returned by the API.
-     *
-     * The shape of the result is decided by `empty`, never by the DTO: every key of `empty` is in
-     * the result, taken from the DTO when it carries a usable value and left at its empty value
-     * otherwise. A DTO field that is absent and one that is explicitly `null` are treated the same,
-     * because both mean "the record has no value here" and the form wants its empty value for both.
-     *
-     * Keys that exist only in the model (a multi-select decomposed from a bitmask, a checkbox
-     * extracted from a flags value) simply keep their empty value: fill them in around the call.
-     *
-     * @param empty - The neutral model: it declares every field the form owns, and the value each
-     *                one takes when the DTO does not carry it.
-     * @param dto   - The object coming from the API, or `undefined` when creating a new record.
-     * @returns A new model, never the same reference as `empty` nor as `dto`.
-     */
-    static toForm<TModel extends object>(empty: TModel, dto?: Partial<TModel> | null): TModel;
-    /**
-     * Builds the payload for the API from the current form model.
-     *
-     * Every empty value — `''`, `null` or `undefined` — is dropped, so a field the user never filled
-     * in travels as absent instead of reaching the backend as an empty string that would blank the
-     * record. `0` and `false` are NOT empty: an amount of zero and a switch left off are data, and a
-     * filter that wants an unticked box to mean "no filter" has to say so where it builds its query.
-     *
-     * The conversion is shallow: nested objects and arrays are passed through as they are, so a
-     * composite field (a bitmask to rebuild, a nested block to normalize) is handled around the call
-     * — usually by destructuring it out of the model first.
-     *
-     * The return type is {@link Dto}, the model without its empty values, so what the compiler sees
-     * matches what travels: a `coachLevel: CoachLevel | null` field arrives as `CoachLevel` and fits
-     * the optional `coachLevel?: CoachLevel` of the API model. At runtime the empty keys are simply
-     * not there, which is what `HttpClient` serializes anyway.
-     *
-     * @param model - The current form model.
-     * @returns A shallow copy without the empty fields.
-     */
-    static toPayload<TModel extends object>(model: TModel): Dto<TModel>;
+export declare class DtoUtils {
+  /**
+   * Builds a form model from the object returned by the API.
+   *
+   * The shape of the result is decided by `empty`, never by the DTO: every key of `empty` is in
+   * the result, taken from the DTO when it carries a usable value and left at its empty value
+   * otherwise. A DTO field that is absent and one that is explicitly `null` are treated the same,
+   * because both mean "the record has no value here" and the form wants its empty value for both.
+   *
+   * Keys that exist only in the model (a multi-select decomposed from a bitmask, a checkbox
+   * extracted from a flags value) simply keep their empty value: fill them in around the call.
+   *
+   * @param empty - The neutral model: it declares every field the form owns, and the value each
+   *                one takes when the DTO does not carry it.
+   * @param dto   - The object coming from the API, or `undefined` when creating a new record.
+   * @returns A new model, never the same reference as `empty` nor as `dto`.
+   */
+  static toForm<TModel extends object>(empty: TModel, dto?: Partial<TModel> | null): TModel;
+  /**
+   * Builds the payload for the API from the current form model.
+   *
+   * Every empty value — `''`, `null` or `undefined` — is dropped, so a field the user never filled
+   * in travels as absent instead of reaching the backend as an empty string that would blank the
+   * record. `0` and `false` are NOT empty: an amount of zero and a switch left off are data, and a
+   * filter that wants an unticked box to mean "no filter" has to say so where it builds its query.
+   *
+   * The conversion is shallow: nested objects and arrays are passed through as they are, so a
+   * composite field (a bitmask to rebuild, a nested block to normalize) is handled around the call
+   * — usually by destructuring it out of the model first.
+   *
+   * The return type is {@link Dto}, the model without its empty values, so what the compiler sees
+   * matches what travels: a `coachLevel: CoachLevel | null` field arrives as `CoachLevel` and fits
+   * the optional `coachLevel?: CoachLevel` of the API model. At runtime the empty keys are simply
+   * not there, which is what `HttpClient` serializes anyway.
+   *
+   * @param model - The current form model.
+   * @returns A shallow copy without the empty fields.
+   */
+  static toPayload<TModel extends object>(model: TModel): Dto<TModel>;
 }
-
-declare const UtilsMessages: {
-    /**
-     * Messages
-     */
-    UTILS_DIALOGS_SELECT_OPTIONS_CHANGED: string;
+export declare const UtilsMessages: {
+  /**
+   * Messages
+   */
+  UTILS_DIALOGS_SELECT_OPTIONS_CHANGED: string;
 };
-
-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
+export 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.
@@ -319,396 +323,395 @@ declare enum DateFormat {
  * 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;
+export type KeyOf<T> = Extract<keyof T, string> | (string & {});
+export 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;
-    /**
-     * Get a value from and array made of name|value items
-     * @param array   : the array to scan
-     * @param value   : the value to search for
-     * @returns       : the property value or null if not found
-     */
-    static arrayGetValue<T>(array: T[] | undefined, value: unknown): unknown;
-    /**
-     * Convert items to nodes into a tree structure
-     * @param items   : list of nodes
-     * @param parent  : parent node
-     * @returns       : an array of INode objects
-     */
-    static arrayToNodes(items: INode[], parent?: INode): INode[];
-    /**
-     * Comparator factory for sorting arrays of objects by a given property key.
-     * Pass the element type for compile-time key checking:
-     * `items.sort(SystemUtils.arraySortCompare<Employee>('lastName'))`.
-     * @param key   - Name of the property to sort by (autocompleted from `T` when provided).
-     * @param order - Sort direction: `'asc'` (default) or `'desc'`.
-     * @returns A comparator function that returns a negative, zero, or positive number.
-     */
-    static arraySortCompare<T extends object = Record<string, unknown>>(key: KeyOf<T>, order?: 'asc' | 'desc' | (string & {})): (a: T, b: T) => number;
-    /**
-     * Format weight
-     * @param gr    : grams
-     * @returns     : the formatted string
-     */
-    static formatWeight(gr: number): string;
-    /**
-     * Format file size
-     * @param bytes : number of bytes
-     * @returns     : the formatted string
-     */
-    static formatFileSize(bytes: number): string;
-    /**
-     * Compare two strings (case-insensitive, locale-aware, accent-insensitive).
-     * @param a   : string a
-     * @param b   : string b
-     * @returns   : 0 if equals, 1 if bigger, -1 if lower
-     */
-    static compareString(a?: string, b?: string): number;
-    /**
-     * Capitalize a string
-     * @param s   : the string to capitalize
-     * @returns   : the capitalized string
-     */
-    static capitalize(s?: string): string | undefined;
-    /**
-     * Truncate a string at the last word boundary before `max`.
-     * @param s     : the string to truncate
-     * @param max   : the max number of chars
-     * @returns     : the truncated string
-     */
-    static truncate(s?: string, max?: number): string | undefined;
-    /**
-     * Join a list of strings
-     * @param items     : the list of strings
-     * @param sep       : the separator string
-     * @param max       : the maximum resulting string
-     * @returns         : the joined string
-     */
-    static join(items?: string[], sep?: string, max?: number): string | undefined;
-    /**
-     * Normalize a string by converting it to lowercase and removing extra spaces, with special handling for acronyms and camelCase.
-     * @param s  : the string to normalize
-     * @returns  : The normalized string, or `undefined` if the input is falsy.
-     */
-    static normalizeDisplay(s?: string): string | undefined;
-    /**
-     * Wraps bare URLs in the given string with `<a>` anchor tags.
-     * @param s - The plain-text or HTML string to process.
-     * @returns The string with URLs replaced by clickable links, or `''` when `s` is falsy.
-     */
-    static replaceAsHtml(s?: string): string;
-    /**
-     * Compare two names
-     * @param a   : name a
-     * @param b   : name b
-     * @returns   : true if a equals b
-     */
-    static compareNames(a?: string, b?: string): boolean;
-    /**
-     * Obfuscate a text with a key-driven code point rotation.
-     *
-     * @deprecated This is OBFUSCATION, not cryptography: it hides values from
-     * casual inspection but offers no real security. Use {@link encrypt} /
-     * {@link decrypt} (AES-GCM via Web Crypto) for anything sensitive.
-     *
-     * The rotation operates on Unicode code points and skips the surrogate
-     * range, so the output is always a well-formed string: emoji and other
-     * astral characters round-trip correctly (the previous code-unit based
-     * version could emit lone surrogates and corrupt them).
-     *
-     * BREAKING CHANGE: values encoded with the previous code-unit algorithm
-     * cannot be decoded by this implementation.
-     *
-     * @param text    : the text to encode or decode
-     * @param key     : the key
-     * @param reverse : true to decode, false to encode
-     * @returns       : the obfuscated (or restored) text, or undefined when text/key are empty
-     */
-    static cipher(text: string, key: string, reverse?: boolean): string | undefined;
-    /** Payload format version, first byte of the binary envelope. */
-    private static readonly CIPHER_VERSION;
-    /** PBKDF2 salt length in bytes. */
-    private static readonly CIPHER_SALT_LENGTH;
-    /** AES-GCM IV length in bytes (96 bit, the recommended size for GCM). */
-    private static readonly CIPHER_IV_LENGTH;
-    /** PBKDF2-HMAC-SHA-256 iterations (OWASP recommendation). */
-    private static readonly CIPHER_ITERATIONS;
-    /**
-     * Derives an AES-GCM 256-bit key from a password using PBKDF2-HMAC-SHA-256.
-     * @param password : the user password / passphrase
-     * @param salt     : the random salt bound to this payload
-     * @returns        : a non-extractable AES-GCM CryptoKey
-     */
-    private static deriveKey;
-    /**
-     * Encodes bytes as URL-safe Base64 (no '+', '/' or trailing '=').
-     * @param bytes : the bytes to encode
-     * @returns     : the base64url string
-     */
-    private static toBase64Url;
-    /**
-     * Decodes a URL-safe Base64 string back to bytes.
-     * @param value : the base64url string
-     * @returns     : the decoded bytes
-     */
-    private static fromBase64Url;
-    /**
-     * Encrypts a text with a password using AES-GCM (256 bit) and a key derived
-     * via PBKDF2-HMAC-SHA-256 with a random per-message salt.
-     *
-     * The result is a self-contained, URL-safe Base64 payload:
-     * `version (1 byte) | salt (16 bytes) | iv (12 bytes) | ciphertext+tag`.
-     * GCM is authenticated: any tampering makes {@link decrypt} fail.
-     *
-     * Requires a secure context (HTTPS or localhost) for `crypto.subtle`.
-     *
-     * @param text     : the plain text to encrypt
-     * @param password : the password / passphrase
-     * @returns        : the base64url payload, or undefined when text/password are
-     *                   empty or the Web Crypto API is unavailable
-     */
-    static encrypt(text: string, password: string): Promise<string | undefined>;
-    /**
-     * Decrypts a payload produced by {@link encrypt}.
-     * Returns undefined when the password is wrong, the payload was tampered
-     * with, the format is unknown, or the Web Crypto API is unavailable.
-     *
-     * @param payload  : the base64url payload returned by {@link encrypt}
-     * @param password : the password / passphrase used to encrypt
-     * @returns        : the original plain text, or undefined on any failure
-     */
-    static decrypt(payload: string, password: string): Promise<string | undefined>;
-    /**
-     * Clone an object (deep copy).
-     * Uses native structuredClone: handles Date, Map, Set, typed arrays and circular references.
-     * @param obj : the object to clone
-     * @returns   : a new object
-     */
-    static clone<T>(obj: T): T;
-    /**
-     * Creates a deep clone of an object.
-     * @param obj  - The source object to clone.
-     * @param dest - Optional pre-allocated destination object to merge the clone into.
-     * @returns A deep copy of `obj`.
-     */
-    static deepClone<T extends object>(obj: T, dest?: T): T;
-    /**
-     * Returns `true` when `value` is a syntactically valid UUID string.
-     * @param value - The string to validate.
-     */
-    static parseUUID(value?: string): boolean;
-    /**
-     * Returns `true` when `value` is a valid, non-empty (non-zero) UUID.
-     * @param value - The string to validate.
-     */
-    static parseUUIDNotEmpty(value?: string): boolean;
-    /**
-     * Return an empty UUID
-     * @returns : the empty UUID
-     */
-    static emptyUUID(): string;
-    /**
-     * Create a new UUID
-     * @returns : the string UUID
-     */
-    static generateUUID(): string;
-    /**
-     * Reconstruct a standard UUID (with dashes) from a 32-char hex string without dashes.
-     * @param value : 32-character hex string
-     * @returns     : the formatted UUID or the original string if it doesn't match the expected format
-     */
-    static inflateUUID(value: string): string;
-    /** Precompiled validation patterns. */
-    private static readonly emailRegex;
-    private static readonly urlRegex;
-    /**
-     * Parse a text and return true if it is a valid email (or empty)
-     * @param value : email
-     * @returns     : true if the email is valid or empty
-     */
-    static parseEmail(value?: string): boolean;
-    /**
-     * Parse a text containing one or more email addresses separated by `;` or `,`
-     * and return true if all of them are valid (or the text is empty).
-     * Empty items caused by double or trailing separators are ignored.
-     * @param value : the email list to parse (e.g. "a@b.it; c@d.it")
-     * @returns     : true if all emails are valid or the value is empty
-     */
-    static parseEmails(value?: string): boolean;
-    /**
-     * Parse a text and return true if it is a valid url (or empty)
-     * @param value : the url to parse
-     * @returns     : true if the url is valid or empty
-     */
-    static parseUrl(value?: string): boolean;
-    /**
-     * Get date parts from a string value
-     * @param value   : the string to parse
-     * @returns       : an array of numbers with year, month, day
-     */
-    static getDateParts(value?: string): number[] | undefined;
-    /**
-     * Checks whether a value is a valid Date instance.
-     * Note: do not use `date.getTime()` as a truthiness test, it is 0 (falsy)
-     * for the Unix epoch (1970-01-01T00:00:00Z) even though the date is valid.
-     * @param d : the value to check
-     * @returns : true when `d` is a Date representing a valid point in time
-     */
-    static isValidDate(d: unknown): d is Date;
-    /**
-     * Parse a date
-     * @param value   : the value to check
-     * @param locale  : the locale to use
-     * @returns       : a valid Date object or undefined
-     */
-    static parseDate(value?: string | Date, locale?: Locale): Date | undefined;
-    /**
-     * 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,
-     * so the wall-clock value round-trips to the server unchanged. Use this instead of `new Date(...)`
-     * when reviving dates received from the API, to stay consistent with the DateFnsAdapter (values
-     * entered through the datepicker already behave this way).
-     * @param value : the source Date, Unix timestamp (ms) or ISO string
-     * @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
-     * @param interval    : DateInterval value to update
-     * @param end         : true if must be updated the first or the end value
-     * @param copy        : copy the same value (works only if not end element)
-     */
-    static changeDateInterval(value: string, interval: DateInterval, end?: boolean, copy?: boolean): void;
-    /** Cache of `Intl.NumberFormat` instances (their construction is expensive). */
-    private static readonly numberFormatCache;
-    /**
-     * Returns a cached `Intl.NumberFormat` for the given options, creating it on first use.
-     * @param locale  - BCP 47 locale tag.
-     * @param options - The `Intl.NumberFormat` options.
-     * @returns A shared formatter instance.
-     */
-    private static getNumberFormat;
-    /**
-     * Formats a number using a cached `Intl.NumberFormat`.
-     * @param value    - The number to format.
-     * @param decimals - Maximum decimal places (default: `2`).
-     * @param locale   - BCP 47 locale tag (default: `'it-IT'`).
-     * @returns The formatted number 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;
+export 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;
+  /**
+   * Get a value from and array made of name|value items
+   * @param array   : the array to scan
+   * @param value   : the value to search for
+   * @returns       : the property value or null if not found
+   */
+  static arrayGetValue<T>(array: T[] | undefined, value: unknown): unknown;
+  /**
+   * Convert items to nodes into a tree structure
+   * @param items   : list of nodes
+   * @param parent  : parent node
+   * @returns       : an array of INode objects
+   */
+  static arrayToNodes(items: INode[], parent?: INode): INode[];
+  /**
+   * Comparator factory for sorting arrays of objects by a given property key.
+   * Pass the element type for compile-time key checking:
+   * `items.sort(SystemUtils.arraySortCompare<Employee>('lastName'))`.
+   * @param key   - Name of the property to sort by (autocompleted from `T` when provided).
+   * @param order - Sort direction: `'asc'` (default) or `'desc'`.
+   * @returns A comparator function that returns a negative, zero, or positive number.
+   */
+  static arraySortCompare<T extends object = Record<string, unknown>>(key: KeyOf<T>, order?: 'asc' | 'desc' | (string & {})): (a: T, b: T) => number;
+  /**
+   * Format weight
+   * @param gr    : grams
+   * @returns     : the formatted string
+   */
+  static formatWeight(gr: number): string;
+  /**
+   * Format file size
+   * @param bytes : number of bytes
+   * @returns     : the formatted string
+   */
+  static formatFileSize(bytes: number): string;
+  /**
+   * Compare two strings (case-insensitive, locale-aware, accent-insensitive).
+   * @param a   : string a
+   * @param b   : string b
+   * @returns   : 0 if equals, 1 if bigger, -1 if lower
+   */
+  static compareString(a?: string, b?: string): number;
+  /**
+   * Capitalize a string
+   * @param s   : the string to capitalize
+   * @returns   : the capitalized string
+   */
+  static capitalize(s?: string): string | undefined;
+  /**
+   * Truncate a string at the last word boundary before `max`.
+   * @param s     : the string to truncate
+   * @param max   : the max number of chars
+   * @returns     : the truncated string
+   */
+  static truncate(s?: string, max?: number): string | undefined;
+  /**
+   * Join a list of strings
+   * @param items     : the list of strings
+   * @param sep       : the separator string
+   * @param max       : the maximum resulting string
+   * @returns         : the joined string
+   */
+  static join(items?: string[], sep?: string, max?: number): string | undefined;
+  /**
+   * Normalize a string by converting it to lowercase and removing extra spaces, with special handling for acronyms and camelCase.
+   * @param s  : the string to normalize
+   * @returns  : The normalized string, or `undefined` if the input is falsy.
+   */
+  static normalizeDisplay(s?: string): string | undefined;
+  /**
+   * Wraps bare URLs in the given string with `<a>` anchor tags.
+   * @param s - The plain-text or HTML string to process.
+   * @returns The string with URLs replaced by clickable links, or `''` when `s` is falsy.
+   */
+  static replaceAsHtml(s?: string): string;
+  /**
+   * Compare two names
+   * @param a   : name a
+   * @param b   : name b
+   * @returns   : true if a equals b
+   */
+  static compareNames(a?: string, b?: string): boolean;
+  /**
+   * Obfuscate a text with a key-driven code point rotation.
+   *
+   * @deprecated This is OBFUSCATION, not cryptography: it hides values from
+   * casual inspection but offers no real security. Use {@link encrypt} /
+   * {@link decrypt} (AES-GCM via Web Crypto) for anything sensitive.
+   *
+   * The rotation operates on Unicode code points and skips the surrogate
+   * range, so the output is always a well-formed string: emoji and other
+   * astral characters round-trip correctly (the previous code-unit based
+   * version could emit lone surrogates and corrupt them).
+   *
+   * BREAKING CHANGE: values encoded with the previous code-unit algorithm
+   * cannot be decoded by this implementation.
+   *
+   * @param text    : the text to encode or decode
+   * @param key     : the key
+   * @param reverse : true to decode, false to encode
+   * @returns       : the obfuscated (or restored) text, or undefined when text/key are empty
+   */
+  static cipher(text: string, key: string, reverse?: boolean): string | undefined;
+  /** Payload format version, first byte of the binary envelope. */
+  private static readonly CIPHER_VERSION;
+  /** PBKDF2 salt length in bytes. */
+  private static readonly CIPHER_SALT_LENGTH;
+  /** AES-GCM IV length in bytes (96 bit, the recommended size for GCM). */
+  private static readonly CIPHER_IV_LENGTH;
+  /** PBKDF2-HMAC-SHA-256 iterations (OWASP recommendation). */
+  private static readonly CIPHER_ITERATIONS;
+  /**
+   * Derives an AES-GCM 256-bit key from a password using PBKDF2-HMAC-SHA-256.
+   * @param password : the user password / passphrase
+   * @param salt     : the random salt bound to this payload
+   * @returns        : a non-extractable AES-GCM CryptoKey
+   */
+  private static deriveKey;
+  /**
+   * Encodes bytes as URL-safe Base64 (no '+', '/' or trailing '=').
+   * @param bytes : the bytes to encode
+   * @returns     : the base64url string
+   */
+  private static toBase64Url;
+  /**
+   * Decodes a URL-safe Base64 string back to bytes.
+   * @param value : the base64url string
+   * @returns     : the decoded bytes
+   */
+  private static fromBase64Url;
+  /**
+   * Encrypts a text with a password using AES-GCM (256 bit) and a key derived
+   * via PBKDF2-HMAC-SHA-256 with a random per-message salt.
+   *
+   * The result is a self-contained, URL-safe Base64 payload:
+   * `version (1 byte) | salt (16 bytes) | iv (12 bytes) | ciphertext+tag`.
+   * GCM is authenticated: any tampering makes {@link decrypt} fail.
+   *
+   * Requires a secure context (HTTPS or localhost) for `crypto.subtle`.
+   *
+   * @param text     : the plain text to encrypt
+   * @param password : the password / passphrase
+   * @returns        : the base64url payload, or undefined when text/password are
+   *                   empty or the Web Crypto API is unavailable
+   */
+  static encrypt(text: string, password: string): Promise<string | undefined>;
+  /**
+   * Decrypts a payload produced by {@link encrypt}.
+   * Returns undefined when the password is wrong, the payload was tampered
+   * with, the format is unknown, or the Web Crypto API is unavailable.
+   *
+   * @param payload  : the base64url payload returned by {@link encrypt}
+   * @param password : the password / passphrase used to encrypt
+   * @returns        : the original plain text, or undefined on any failure
+   */
+  static decrypt(payload: string, password: string): Promise<string | undefined>;
+  /**
+   * Clone an object (deep copy).
+   * Uses native structuredClone: handles Date, Map, Set, typed arrays and circular references.
+   * @param obj : the object to clone
+   * @returns   : a new object
+   */
+  static clone<T>(obj: T): T;
+  /**
+   * Creates a deep clone of an object.
+   * @param obj  - The source object to clone.
+   * @param dest - Optional pre-allocated destination object to merge the clone into.
+   * @returns A deep copy of `obj`.
+   */
+  static deepClone<T extends object>(obj: T, dest?: T): T;
+  /**
+   * Returns `true` when `value` is a syntactically valid UUID string.
+   * @param value - The string to validate.
+   */
+  static parseUUID(value?: string): boolean;
+  /**
+   * Returns `true` when `value` is a valid, non-empty (non-zero) UUID.
+   * @param value - The string to validate.
+   */
+  static parseUUIDNotEmpty(value?: string): boolean;
+  /**
+   * Return an empty UUID
+   * @returns : the empty UUID
+   */
+  static emptyUUID(): string;
+  /**
+   * Create a new UUID
+   * @returns : the string UUID
+   */
+  static generateUUID(): string;
+  /**
+   * Reconstruct a standard UUID (with dashes) from a 32-char hex string without dashes.
+   * @param value : 32-character hex string
+   * @returns     : the formatted UUID or the original string if it doesn't match the expected format
+   */
+  static inflateUUID(value: string): string;
+  /** Precompiled validation patterns. */
+  private static readonly emailRegex;
+  private static readonly urlRegex;
+  /**
+   * Parse a text and return true if it is a valid email (or empty)
+   * @param value : email
+   * @returns     : true if the email is valid or empty
+   */
+  static parseEmail(value?: string): boolean;
+  /**
+   * Parse a text containing one or more email addresses separated by `;` or `,`
+   * and return true if all of them are valid (or the text is empty).
+   * Empty items caused by double or trailing separators are ignored.
+   * @param value : the email list to parse (e.g. "a@b.it; c@d.it")
+   * @returns     : true if all emails are valid or the value is empty
+   */
+  static parseEmails(value?: string): boolean;
+  /**
+   * Parse a text and return true if it is a valid url (or empty)
+   * @param value : the url to parse
+   * @returns     : true if the url is valid or empty
+   */
+  static parseUrl(value?: string): boolean;
+  /**
+   * Get date parts from a string value
+   * @param value   : the string to parse
+   * @returns       : an array of numbers with year, month, day
+   */
+  static getDateParts(value?: string): number[] | undefined;
+  /**
+   * Checks whether a value is a valid Date instance.
+   * Note: do not use `date.getTime()` as a truthiness test, it is 0 (falsy)
+   * for the Unix epoch (1970-01-01T00:00:00Z) even though the date is valid.
+   * @param d : the value to check
+   * @returns : true when `d` is a Date representing a valid point in time
+   */
+  static isValidDate(d: unknown): d is Date;
+  /**
+   * Parse a date
+   * @param value   : the value to check
+   * @param locale  : the locale to use
+   * @returns       : a valid Date object or undefined
+   */
+  static parseDate(value?: string | Date, locale?: Locale): Date | undefined;
+  /**
+   * 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,
+   * so the wall-clock value round-trips to the server unchanged. Use this instead of `new Date(...)`
+   * when reviving dates received from the API, to stay consistent with the DateFnsAdapter (values
+   * entered through the datepicker already behave this way).
+   * @param value : the source Date, Unix timestamp (ms) or ISO string
+   * @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
+   * @param interval    : DateInterval value to update
+   * @param end         : true if must be updated the first or the end value
+   * @param copy        : copy the same value (works only if not end element)
+   */
+  static changeDateInterval(value: string, interval: DateInterval, end?: boolean, copy?: boolean): void;
+  /** Cache of `Intl.NumberFormat` instances (their construction is expensive). */
+  private static readonly numberFormatCache;
+  /**
+   * Returns a cached `Intl.NumberFormat` for the given options, creating it on first use.
+   * @param locale  - BCP 47 locale tag.
+   * @param options - The `Intl.NumberFormat` options.
+   * @returns A shared formatter instance.
+   */
+  private static getNumberFormat;
+  /**
+   * Formats a number using a cached `Intl.NumberFormat`.
+   * @param value    - The number to format.
+   * @param decimals - Maximum decimal places (default: `2`).
+   * @param locale   - BCP 47 locale tag (default: `'it-IT'`).
+   * @returns The formatted number 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.
@@ -716,191 +719,204 @@ declare class SystemUtils {
  * @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;
+export 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: import("@angular/core").Signal<boolean>;
+  /** Signal with the number of items currently tracked in the internal list. */
+  readonly count: import("@angular/core").Signal<number>;
+  /** Signal that is `true` when exactly one item is currently selected. */
+  readonly selectedOne: import("@angular/core").Signal<boolean>;
+  /** Signal that is `true` when two or more items are currently selected. */
+  readonly selectedMany: import("@angular/core").Signal<boolean>;
+  /** Signal that is `true` when at least one element is selected. */
+  readonly selectedAny: import("@angular/core").Signal<boolean>;
+  /** Signal that is `true` when no item is currently selected. */
+  readonly selectedNone: import("@angular/core").Signal<boolean>;
+  /** Signal with the first currently selected item, or `undefined` when none is selected. */
+  readonly first: import("@angular/core").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>;
+export 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>;
+export declare class DateIntervalChangeDirective {
+  /** The date interval model to update when the input value changes. */
+  readonly dateIntervalChange: import("@angular/core").InputSignal<DateInterval>;
+  /** When `true`, the directive updates the interval's end date; otherwise the start date. */
+  readonly end: import("@angular/core").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>;
+export declare class CopyClipboardDirective {
+  /** The text to copy to the clipboard. Bound via the `copyClipboard` attribute. */
+  readonly payload: import("@angular/core").InputSignal<string>;
+  /** Emits the copied text after a successful copy operation. */
+  readonly copied: import("@angular/core").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 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>;
+export 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>;
 }
-
 /**
  * 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>;
+export 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>;
 }
-
 /**
  * General-purpose formatting pipe that converts a raw value to a locale-aware string
  * based on the specified format type.
@@ -910,25 +926,24 @@ declare class FormatHtmlPipe implements PipeTransform {
  *
  * 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>;
+export 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,
@@ -936,57 +951,54 @@ declare class FormatPipe implements PipeTransform {
  *
  * 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>;
+export 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>;
+export 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>;
+export 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,
@@ -994,20 +1006,19 @@ declare class SafeUrlPipe implements PipeTransform {
  *
  * 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>;
+export 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
@@ -1024,41 +1035,35 @@ declare class SearchCallbackPipe implements PipeTransform {
  * <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>;
+export 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>;
 }
-
-/**
- * Standard Broadcast Messages Manager
- * https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel
- */
-
 /** The typed message payload exchanged over the broadcast channel. */
-interface BroadcastChannelMessageBag<T> {
-    /** Unique identifier for the message type. */
-    messageId: string;
-    /** Identifier of the sender. */
-    sender?: string;
-    /** Optional typed data attached to the message. */
-    data?: T;
+export interface BroadcastChannelMessageBag<T> {
+  /** Unique identifier for the message type. */
+  messageId: string;
+  /** Identifier of the sender. */
+  sender?: string;
+  /** Optional typed data attached to the message. */
+  data?: T;
 }
 /** Subscription descriptor that pairs a message type identifier with its handler. */
-interface BroadcastChannelSubscriberInfo<T> {
-    /** The message type identifier to listen for. */
-    messageId: string;
-    /** Callback invoked with the full message bag when a matching message is received. */
-    action: (bag: BroadcastChannelMessageBag<T>) => void;
+export interface BroadcastChannelSubscriberInfo<T> {
+  /** The message type identifier to listen for. */
+  messageId: string;
+  /** Callback invoked with the full message bag when a matching message is received. */
+  action: (bag: BroadcastChannelMessageBag<T>) => void;
 }
 /**
  * Wrapper around the native Web `BroadcastChannel` API that adds typed messaging,
@@ -1066,279 +1071,274 @@ interface BroadcastChannelSubscriberInfo<T> {
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel
  */
-declare class BroadcastChannelManager {
-    private channel?;
-    private readonly subject;
-    private subscriptions;
-    /**
-     * The name of the underlying `BroadcastChannel`, or `undefined` when the API
-     * is not supported by the current browser.
-     */
-    get currentBus(): string | undefined;
-    /**
-     * Observable that emits EVERY message bag received on the channel,
-     * regardless of `messageId`. Completed by {@link dispose}.
-     * Prefer {@link observe} to listen for a single message type.
-     */
-    get messages(): Observable<BroadcastChannelMessageBag<unknown>>;
-    /**
-     * Returns a typed Observable that emits only the messages with the given `messageId`.
-     *
-     * Unlike {@link subscribe} (one callback per id, replaced on re-registration),
-     * this supports any number of concurrent subscribers and integrates with the
-     * RxJS lifecycle (`takeUntilDestroyed`, `async` pipe, ...). Completed by {@link dispose}.
-     *
-     * @param messageId - The message type identifier to listen for.
-     * @returns An Observable of the matching typed message bags.
-     */
-    observe<T>(messageId: string): Observable<BroadcastChannelMessageBag<T>>;
-    /**
-     * Opens a `BroadcastChannel` with the given name (when the API is available).
-     * @param bus - The channel name to open (default: `'ARS-CHANNEL'`).
-     */
-    constructor(bus?: string);
-    /**
-     * Closes the underlying channel and completes the internal subject after a short delay
-     * to allow any in-flight messages to be delivered.
-     */
-    dispose(): void;
-    /**
-     * Sends a typed message bag immediately.
-     * @param bag - The message bag to send.
-     * @example
-     * channel.sendMessage({ messageId: 'my-message', sender: 'me', data: value });
-     */
-    sendMessage<T>(bag: BroadcastChannelMessageBag<T>): void;
-    /**
-     * Sends a typed message bag after an optional delay.
-     * @param bag   - The message bag to send.
-     * @param delay - Milliseconds to wait before posting the message.
-     * @example
-     * channel.sendMessage({ messageId: 'my-message', sender: 'me', data: value }, 250);
-     */
-    sendMessage<T>(bag: BroadcastChannelMessageBag<T>, delay?: number): void;
-    /**
-     * Sends a message identified by a string ID with optional data.
-     * @param messageId - The message type identifier.
-     * @param data      - Optional typed payload.
-     * @example
-     * channel.sendMessage('my-message', value);
-     */
-    sendMessage<T>(messageId: string, data?: T): void;
-    /**
-     * Sends a message identified by a string ID with optional data after an optional delay.
-     * @param messageId - The message type identifier.
-     * @param data      - Optional typed payload.
-     * @param delay     - Milliseconds to wait before posting the message.
-     * @example
-     * channel.sendMessage('my-message', value, 250);
-     */
-    sendMessage<T>(messageId: string, data?: T, delay?: number): void;
-    /**
-     * Registers a handler for messages with the given `messageId`.
-     * If a handler for the same `messageId` is already registered it is replaced.
-     * @param args - The subscription descriptor containing the message ID and handler.
-     */
-    subscribe<T>(args: BroadcastChannelSubscriberInfo<T>): void;
-    /**
-     * Removes the subscription for the given message ID, if one exists.
-     * @param messageId - The message type identifier whose subscription should be removed.
-     */
-    unsubscribe(messageId: string): void;
-    /**
-     * Removes all registered subscriptions.
-     */
-    unsubscribeAll(): void;
+export declare class BroadcastChannelManager {
+  private channel?;
+  private readonly subject;
+  private subscriptions;
+  /**
+   * The name of the underlying `BroadcastChannel`, or `undefined` when the API
+   * is not supported by the current browser.
+   */
+  get currentBus(): string | undefined;
+  /**
+   * Observable that emits EVERY message bag received on the channel,
+   * regardless of `messageId`. Completed by {@link dispose}.
+   * Prefer {@link observe} to listen for a single message type.
+   */
+  get messages(): Observable<BroadcastChannelMessageBag<unknown>>;
+  /**
+   * Returns a typed Observable that emits only the messages with the given `messageId`.
+   *
+   * Unlike {@link subscribe} (one callback per id, replaced on re-registration),
+   * this supports any number of concurrent subscribers and integrates with the
+   * RxJS lifecycle (`takeUntilDestroyed`, `async` pipe, ...). Completed by {@link dispose}.
+   *
+   * @param messageId - The message type identifier to listen for.
+   * @returns An Observable of the matching typed message bags.
+   */
+  observe<T>(messageId: string): Observable<BroadcastChannelMessageBag<T>>;
+  /**
+   * Opens a `BroadcastChannel` with the given name (when the API is available).
+   * @param bus - The channel name to open (default: `'ARS-CHANNEL'`).
+   */
+  constructor(bus?: string);
+  /**
+   * Closes the underlying channel and completes the internal subject after a short delay
+   * to allow any in-flight messages to be delivered.
+   */
+  dispose(): void;
+  /**
+   * Sends a typed message bag immediately.
+   * @param bag - The message bag to send.
+   * @example
+   * channel.sendMessage({ messageId: 'my-message', sender: 'me', data: value });
+   */
+  sendMessage<T>(bag: BroadcastChannelMessageBag<T>): void;
+  /**
+   * Sends a typed message bag after an optional delay.
+   * @param bag   - The message bag to send.
+   * @param delay - Milliseconds to wait before posting the message.
+   * @example
+   * channel.sendMessage({ messageId: 'my-message', sender: 'me', data: value }, 250);
+   */
+  sendMessage<T>(bag: BroadcastChannelMessageBag<T>, delay?: number): void;
+  /**
+   * Sends a message identified by a string ID with optional data.
+   * @param messageId - The message type identifier.
+   * @param data      - Optional typed payload.
+   * @example
+   * channel.sendMessage('my-message', value);
+   */
+  sendMessage<T>(messageId: string, data?: T): void;
+  /**
+   * Sends a message identified by a string ID with optional data after an optional delay.
+   * @param messageId - The message type identifier.
+   * @param data      - Optional typed payload.
+   * @param delay     - Milliseconds to wait before posting the message.
+   * @example
+   * channel.sendMessage('my-message', value, 250);
+   */
+  sendMessage<T>(messageId: string, data?: T, delay?: number): void;
+  /**
+   * Registers a handler for messages with the given `messageId`.
+   * If a handler for the same `messageId` is already registered it is replaced.
+   * @param args - The subscription descriptor containing the message ID and handler.
+   */
+  subscribe<T>(args: BroadcastChannelSubscriberInfo<T>): void;
+  /**
+   * Removes the subscription for the given message ID, if one exists.
+   * @param messageId - The message type identifier whose subscription should be removed.
+   */
+  unsubscribe(messageId: string): void;
+  /**
+   * Removes all registered subscriptions.
+   */
+  unsubscribeAll(): void;
 }
-
-declare const CHANNEL_NAME = "D2693418-B18F-41BB-BAE9-41BB5407957A-CHANNEL";
+export declare const CHANNEL_NAME = "D2693418-B18F-41BB-BAE9-41BB5407957A-CHANNEL";
 /** Payload carried by every in-process broadcast message. */
-interface BroadcastMessageInfo {
-    /** Unique identifier for the message type. */
-    id: string;
-    /** Optional data attached to the message. */
-    data?: any;
+export interface BroadcastMessageInfo {
+  /** Unique identifier for the message type. */
+  id: string;
+  /** Optional data attached to the message. */
+  data?: any;
 }
-interface BroadcastMessageToastData {
-    message: string;
-    icon?: string;
-    duration?: number;
+export interface BroadcastMessageToastData {
+  message: string;
+  icon?: string;
+  duration?: number;
 }
 /**
  * Application-level messaging service that combines two transports:
  * - An in-process RxJS `Subject` for same-tab communication (`sendMessage` / `getMessage`).
  * - A native `BroadcastChannel` for cross-tab communication (`sendChannelMessage` / `subscribeChannelMessage`).
  */
-declare class BroadcastService implements OnDestroy {
-    private readonly subject;
-    private readonly channel;
-    /**
-     * Creates a new standalone `BroadcastChannelManager` instance bound to the shared ARS channel.
-     * Useful when a caller needs direct channel access outside the service.
-     * @returns A new `BroadcastChannelManager` connected to the shared channel.
-     */
-    static createChannel(): BroadcastChannelManager;
-    ngOnDestroy(): void;
-    /**
-     * Publishes a message to the in-process subject, optionally after a delay.
-     * @param id    - The message type identifier.
-     * @param data  - Optional payload to attach to the message.
-     * @param delay - Milliseconds to wait before publishing (default: `0`).
-     */
-    sendMessage(id: string, data?: any, delay?: number): void;
-    /**
-     * Publishes a typed message over the native `BroadcastChannel` (cross-tab), optionally after a delay.
-     * @param id    - The message type identifier.
-     * @param data  - Optional typed payload to send.
-     * @param delay - Milliseconds to wait before sending (forwarded to the channel manager).
-     */
-    sendChannelMessage<T>(id: string, data?: T, delay?: number): void;
-    /**
-     * Registers a handler that is invoked whenever a channel message with the given `id` is received.
-     * @param id     - The message type identifier to listen for.
-     * @param action - Callback invoked with the full `BroadcastChannelMessageBag` when a matching message arrives.
-     */
-    subscribeChannelMessage<T>(id: string, action: (bag: BroadcastChannelMessageBag<T>) => void): void;
-    /**
-     * Removes the channel subscription previously registered for the given `id`, if any.
-     * @param id - The message type identifier whose subscription should be removed.
-     */
-    unsubscribeChannelMessage(id: string): void;
-    /**
-     * Returns a typed Observable of the cross-tab channel messages with the given `id`.
-     * Supports multiple concurrent subscribers and the RxJS lifecycle operators,
-     * unlike `subscribeChannelMessage` (single callback per id).
-     * @param id - The message type identifier to listen for.
-     * @returns An Observable of the matching typed message bags.
-     */
-    observeChannelMessage<T>(id: string): Observable<BroadcastChannelMessageBag<T>>;
-    /**
-     * Returns an `Observable` that emits every in-process message published via `sendMessage`.
-     * @returns An observable stream of `BroadcastMessageInfo` objects.
-     */
-    getMessage(): Observable<BroadcastMessageInfo>;
-    /**
-     * Returns a typed `Observable` of the in-process messages with the given `id`.
-     * @param id - The message type identifier to listen for.
-     * @returns An Observable emitting the typed `data` payload of each matching message.
-     */
-    observeMessage<T>(id: string): Observable<T | undefined>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BroadcastService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+export declare class BroadcastService implements OnDestroy {
+  private readonly subject;
+  private readonly channel;
+  /**
+   * Creates a new standalone `BroadcastChannelManager` instance bound to the shared ARS channel.
+   * Useful when a caller needs direct channel access outside the service.
+   * @returns A new `BroadcastChannelManager` connected to the shared channel.
+   */
+  static createChannel(): BroadcastChannelManager;
+  ngOnDestroy(): void;
+  /**
+   * Publishes a message to the in-process subject, optionally after a delay.
+   * @param id    - The message type identifier.
+   * @param data  - Optional payload to attach to the message.
+   * @param delay - Milliseconds to wait before publishing (default: `0`).
+   */
+  sendMessage(id: string, data?: any, delay?: number): void;
+  /**
+   * Publishes a typed message over the native `BroadcastChannel` (cross-tab), optionally after a delay.
+   * @param id    - The message type identifier.
+   * @param data  - Optional typed payload to send.
+   * @param delay - Milliseconds to wait before sending (forwarded to the channel manager).
+   */
+  sendChannelMessage<T>(id: string, data?: T, delay?: number): void;
+  /**
+   * Registers a handler that is invoked whenever a channel message with the given `id` is received.
+   * @param id     - The message type identifier to listen for.
+   * @param action - Callback invoked with the full `BroadcastChannelMessageBag` when a matching message arrives.
+   */
+  subscribeChannelMessage<T>(id: string, action: (bag: BroadcastChannelMessageBag<T>) => void): void;
+  /**
+   * Removes the channel subscription previously registered for the given `id`, if any.
+   * @param id - The message type identifier whose subscription should be removed.
+   */
+  unsubscribeChannelMessage(id: string): void;
+  /**
+   * Returns a typed Observable of the cross-tab channel messages with the given `id`.
+   * Supports multiple concurrent subscribers and the RxJS lifecycle operators,
+   * unlike `subscribeChannelMessage` (single callback per id).
+   * @param id - The message type identifier to listen for.
+   * @returns An Observable of the matching typed message bags.
+   */
+  observeChannelMessage<T>(id: string): Observable<BroadcastChannelMessageBag<T>>;
+  /**
+   * Returns an `Observable` that emits every in-process message published via `sendMessage`.
+   * @returns An observable stream of `BroadcastMessageInfo` objects.
+   */
+  getMessage(): Observable<BroadcastMessageInfo>;
+  /**
+   * Returns a typed `Observable` of the in-process messages with the given `id`.
+   * @param id - The message type identifier to listen for.
+   * @returns An Observable emitting the typed `data` payload of each matching message.
+   */
+  observeMessage<T>(id: string): Observable<T | undefined>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BroadcastService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-
 /**
  * Application-wide environment configuration service.
  * Exposes writable signals for the base URIs used throughout the application.
  * Values should be set once during application bootstrap (e.g. in `APP_INITIALIZER`).
  */
-declare class EnvironmentService {
-    /** Writable signal holding the base URI of the frontend application (e.g. `https://app.example.com`). */
-    readonly appUriSignal: i0.WritableSignal<string>;
-    /** Writable signal holding the base URI of the backend API service (e.g. `https://api.example.com`). */
-    readonly appServiceUriSignal: i0.WritableSignal<string>;
-    /**
-     * Writable signal holding the redirect URI used after login.
-     * When empty, `appLoginRedirectUri` falls back to `appUri`.
-     */
-    readonly appLoginRedirectUriSignal: i0.WritableSignal<string>;
-    /**
-     * Writable signal holding the login endpoint URI of the backend service.
-     * When empty, `appServiceLoginUri` falls back to `appServiceUri`.
-     */
-    readonly appServiceLoginUriSignal: i0.WritableSignal<string>;
-    private readonly _effectiveLoginRedirectUri;
-    private readonly _effectiveServiceLoginUri;
-    /** Base URI of the frontend application. */
-    get appUri(): string;
-    /** @param value - The base URI of the frontend application. */
-    set appUri(value: string);
-    /** Base URI of the backend API service. */
-    get appServiceUri(): string;
-    /** @param value - The base URI of the backend API service. */
-    set appServiceUri(value: string);
-    /**
-     * Effective login redirect URI.
-     * Returns the explicitly set value, or falls back to `appUri` when empty.
-     */
-    get appLoginRedirectUri(): string;
-    /** @param value - The redirect URI to use after login. */
-    set appLoginRedirectUri(value: string);
-    /**
-     * Effective service login URI.
-     * Returns the explicitly set value, or falls back to `appServiceUri` when empty.
-     */
-    get appServiceLoginUri(): string;
-    /** @param value - The login endpoint URI of the backend service. */
-    set appServiceLoginUri(value: string);
-    static ɵfac: i0.ɵɵFactoryDeclaration<EnvironmentService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+export declare class EnvironmentService {
+  /** Writable signal holding the base URI of the frontend application (e.g. `https://app.example.com`). */
+  readonly appUriSignal: import("@angular/core").WritableSignal<string>;
+  /** Writable signal holding the base URI of the backend API service (e.g. `https://api.example.com`). */
+  readonly appServiceUriSignal: import("@angular/core").WritableSignal<string>;
+  /**
+   * Writable signal holding the redirect URI used after login.
+   * When empty, `appLoginRedirectUri` falls back to `appUri`.
+   */
+  readonly appLoginRedirectUriSignal: import("@angular/core").WritableSignal<string>;
+  /**
+   * Writable signal holding the login endpoint URI of the backend service.
+   * When empty, `appServiceLoginUri` falls back to `appServiceUri`.
+   */
+  readonly appServiceLoginUriSignal: import("@angular/core").WritableSignal<string>;
+  private readonly _effectiveLoginRedirectUri;
+  private readonly _effectiveServiceLoginUri;
+  /** Base URI of the frontend application. */
+  get appUri(): string;
+  /** @param value - The base URI of the frontend application. */
+  set appUri(value: string);
+  /** Base URI of the backend API service. */
+  get appServiceUri(): string;
+  /** @param value - The base URI of the backend API service. */
+  set appServiceUri(value: string);
+  /**
+   * Effective login redirect URI.
+   * Returns the explicitly set value, or falls back to `appUri` when empty.
+   */
+  get appLoginRedirectUri(): string;
+  /** @param value - The redirect URI to use after login. */
+  set appLoginRedirectUri(value: string);
+  /**
+   * Effective service login URI.
+   * Returns the explicitly set value, or falls back to `appServiceUri` when empty.
+   */
+  get appServiceLoginUri(): string;
+  /** @param value - The login endpoint URI of the backend service. */
+  set appServiceLoginUri(value: string);
+  static ɵfac: i0.ɵɵFactoryDeclaration<EnvironmentService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-
 /**
  * Service that exposes reactive screen and device-capability information.
  */
-declare class ScreenService {
-    /**
-     * Writable signal that holds the current Material breakpoint alias
-     * (e.g. `'xs'`, `'sm'`, `'md'`, `'lg'`, `'xl'`).
-     * Updated externally by the breakpoint observer in the consuming component or module.
-     */
-    readonly mq: i0.WritableSignal<string>;
-    /**
-     * Returns `true` when the primary input mechanism can hover over elements
-     * with coarse pointer precision (i.e. a touch screen).
-     */
-    get isTouchable(): boolean;
-    /**
-     * Returns `true` when the current browser is Internet Explorer or the legacy Edge (EdgeHTML).
-     * Modern Chromium-based Edge reports a different user-agent and will return `false`.
-     */
-    get isIEOrEdge(): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ScreenService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+export declare class ScreenService {
+  /**
+   * Writable signal that holds the current Material breakpoint alias
+   * (e.g. `'xs'`, `'sm'`, `'md'`, `'lg'`, `'xl'`).
+   * Updated externally by the breakpoint observer in the consuming component or module.
+   */
+  readonly mq: import("@angular/core").WritableSignal<string>;
+  /**
+   * Returns `true` when the primary input mechanism can hover over elements
+   * with coarse pointer precision (i.e. a touch screen).
+   */
+  get isTouchable(): boolean;
+  /**
+   * Returns `true` when the current browser is Internet Explorer or the legacy Edge (EdgeHTML).
+   * Modern Chromium-based Edge reports a different user-agent and will return `false`.
+   */
+  get isIEOrEdge(): boolean;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ScreenService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-
-declare class SplashService {
-    private readonly isBrowser;
-    /**
-     * Resolve the global splash API exposed by index.html.
-     * @returns The API object, or `undefined` when the splash has already
-     *          been removed or when running in SSR.
-     */
-    private get api();
-    /**
-     * Update the splash message (e.g. "Accesso in corso...").
-     * No-op when the splash is gone or in SSR.
-     * @param text - The new message to display.
-     */
-    setMessage(text: string): void;
-    /**
-     * Defuse the watchdog: Angular bootstrap succeeded,
-     * no automatic reload will ever fire.
-     */
-    bootstrapped(): void;
-    /** Fade out and remove the splash overlay from the DOM. */
-    hide(): void;
-    /**
-     * Give up on loading, without taking the splash away.
-     *
-     * The splash stays where it is but stops pretending something is still happening: the progress
-     * bar goes and a reload button appears, so a user who would otherwise sit in front of an endless
-     * animation has something to do. Uncovering the page instead would be worse — whatever is
-     * underneath is, by definition, not ready.
-     *
-     * Falls back to {@link setMessage} where `index.html` does not publish `fail`: the user still
-     * reads what happened, only without the button.
-     * @param text - What to tell the user.
-     */
-    fail(text: string): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SplashService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+export declare class SplashService {
+  private readonly isBrowser;
+  /**
+   * Resolve the global splash API exposed by index.html.
+   * @returns The API object, or `undefined` when the splash has already
+   *          been removed or when running in SSR.
+   */
+  private get api();
+  /**
+   * Update the splash message (e.g. "Accesso in corso...").
+   * No-op when the splash is gone or in SSR.
+   * @param text - The new message to display.
+   */
+  setMessage(text: string): void;
+  /**
+   * Defuse the watchdog: Angular bootstrap succeeded,
+   * no automatic reload will ever fire.
+   */
+  bootstrapped(): void;
+  /** Fade out and remove the splash overlay from the DOM. */
+  hide(): void;
+  /**
+   * Give up on loading, without taking the splash away.
+   *
+   * The splash stays where it is but stops pretending something is still happening: the progress
+   * bar goes and a reload button appears, so a user who would otherwise sit in front of an endless
+   * animation has something to do. Uncovering the page instead would be worse — whatever is
+   * underneath is, by definition, not ready.
+   *
+   * Falls back to {@link setMessage} where `index.html` does not publish `fail`: the user still
+   * reads what happened, only without the button.
+   * @param text - What to tell the user.
+   */
+  fail(text: string): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SplashService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-
 /** The three available theme modes: follow system preference, force light, or force dark. */
-type ThemeType = 'auto' | 'light' | 'dark';
+export type ThemeType = 'auto' | 'light' | 'dark';
 /**
  * Application-level theme management service.
  *
@@ -1349,73 +1349,70 @@ type ThemeType = 'auto' | 'light' | 'dark';
  * - Synchronises theme changes across browser tabs via `BroadcastChannel`.
  * - Exposes reactive signals (`themeIcon`, `themeName`, `toggleTooltip`) for the UI.
  */
-declare class ThemeService implements OnDestroy {
-    private readonly broadcastChannel;
-    private readonly broadcastMessage;
-    private readonly prefersColorSchemeMediaQueryList;
-    /**
-     * Observable that emits the resolved (`'light'` or `'dark'`) theme whenever it changes.
-     * Useful for components that cannot consume signals directly (e.g. class-based guards).
-     * @example
-     * this.themeService.changed
-     *   .pipe(takeUntilDestroyed(this.destroyRef))
-     *   .subscribe(theme => { ... });
-     */
-    readonly changed: Observable<ThemeType>;
-    private readonly themeChanged;
-    private readonly renderFactory2;
-    private readonly renderer;
-    /** The currently selected `ThemeType` (may be `'auto'`). */
-    private readonly theme;
-    /** `true` when the theme is set to follow the system preference. */
-    private readonly auto;
-    private readonly themeInfo;
-    /** Reactive Material icon code for the current theme (use with `<mat-icon>`). */
-    readonly themeIcon: Signal<string>;
-    /** Reactive human-readable name of the current theme. */
-    readonly themeName: Signal<string>;
-    /** Reactive tooltip text for the theme toggle button. */
-    readonly toggleTooltip: Signal<string>;
-    constructor();
-    /**
-     * Initialises the service: loads the preferred theme, registers OS-change listener,
-     * and subscribes to cross-tab broadcast messages.
-     * Call this once during application bootstrap (e.g. in `APP_INITIALIZER`).
-     * @param theme - The initial theme to apply (defaults to the value stored in `localStorage`).
-     */
-    initialize(theme?: ThemeType): void;
-    ngOnDestroy(): void;
-    /**
-     * Advances the theme through the cycle: `auto` → `light` → `dark` → `auto`.
-     */
-    toggleTheme(): void;
-    /**
-     * Returns the resolved effective theme (`'light'` or `'dark'`), taking the OS preference
-     * into account when the current mode is `'auto'`.
-     * @returns `'light'` or `'dark'` — never `'auto'`.
-     */
-    getTheme(): ThemeType;
-    /**
-     * Reads the theme stored in `localStorage` and validates it.
-     * Falls back to `'auto'` when the stored value is missing or invalid.
-     * @returns The persisted `ThemeType`, or `'auto'` as default.
-     */
-    private getPreferredTheme;
-    /**
-     * Returns `true` when `value` is a valid `ThemeType` string.
-     * Acts as a TypeScript type guard.
-     * @param value - The string to check.
-     */
-    private isTheme;
-    /**
-     * Applies the given theme to `<body>` (CSS class), persists it to `localStorage`,
-     * notifies the `changed` observable, and broadcasts the change to other tabs.
-     * @param theme - The `ThemeType` to apply (defaults to `'auto'`).
-     */
-    private setTheme;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ThemeService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
-}
-
-export { AutoFocusDirective, BroadcastChannelManager, BroadcastService, CHANNEL_NAME, CopyClipboardDirective, DateFormat, DateInterval, DateIntervalChangeDirective, DeleteModel, DtoUtils, EnvironmentService, FileInfo, FormatHtmlPipe, FormatPipe, GroupModel, IDModel, ImportModel, LoginOAuthType, QueryModel, RelationModel, RemoveFocusDirective, ReplacePipe, SafeHtmlPipe, SafeUrlPipe, ScreenService, SearchCallbackPipe, SearchFilterPipe, SelectableModel, SplashService, SystemUtils, ThemeService, UpdateRelationsModel, UtilsMessages, ValueModel };
-export type { AddModel, AddResultModel, ApiResponse, ApiResult, BroadcastChannelMessageBag, BroadcastChannelSubscriberInfo, BroadcastMessageInfo, BroadcastMessageToastData, Checkable, DeleteResultModel, DoneResult, Dto, EnableDisableModel, ErrorInfo, File, Folder, FolderTree, INode, KeyOf, LoginOAuthResult, LoginResult, NameValueItem, PasswordStrength, QueryResultModel, SearchBag, SearchFilterMetadata, Searchable, SendToModel, ThemeType, UpdateModel, UpdateResultModel, Validated };
+export declare class ThemeService implements OnDestroy {
+  private readonly broadcastChannel;
+  private readonly broadcastMessage;
+  private readonly prefersColorSchemeMediaQueryList;
+  /**
+   * Observable that emits the resolved (`'light'` or `'dark'`) theme whenever it changes.
+   * Useful for components that cannot consume signals directly (e.g. class-based guards).
+   * @example
+   * this.themeService.changed
+   *   .pipe(takeUntilDestroyed(this.destroyRef))
+   *   .subscribe(theme => { ... });
+   */
+  readonly changed: Observable<ThemeType>;
+  private readonly themeChanged;
+  private readonly renderFactory2;
+  private readonly renderer;
+  /** The currently selected `ThemeType` (may be `'auto'`). */
+  private readonly theme;
+  /** `true` when the theme is set to follow the system preference. */
+  private readonly auto;
+  private readonly themeInfo;
+  /** Reactive Material icon code for the current theme (use with `<mat-icon>`). */
+  readonly themeIcon: Signal<string>;
+  /** Reactive human-readable name of the current theme. */
+  readonly themeName: Signal<string>;
+  /** Reactive tooltip text for the theme toggle button. */
+  readonly toggleTooltip: Signal<string>;
+  constructor();
+  /**
+   * Initialises the service: loads the preferred theme, registers OS-change listener,
+   * and subscribes to cross-tab broadcast messages.
+   * Call this once during application bootstrap (e.g. in `APP_INITIALIZER`).
+   * @param theme - The initial theme to apply (defaults to the value stored in `localStorage`).
+   */
+  initialize(theme?: ThemeType): void;
+  ngOnDestroy(): void;
+  /**
+   * Advances the theme through the cycle: `auto` → `light` → `dark` → `auto`.
+   */
+  toggleTheme(): void;
+  /**
+   * Returns the resolved effective theme (`'light'` or `'dark'`), taking the OS preference
+   * into account when the current mode is `'auto'`.
+   * @returns `'light'` or `'dark'` — never `'auto'`.
+   */
+  getTheme(): ThemeType;
+  /**
+   * Reads the theme stored in `localStorage` and validates it.
+   * Falls back to `'auto'` when the stored value is missing or invalid.
+   * @returns The persisted `ThemeType`, or `'auto'` as default.
+   */
+  private getPreferredTheme;
+  /**
+   * Returns `true` when `value` is a valid `ThemeType` string.
+   * Acts as a TypeScript type guard.
+   * @param value - The string to check.
+   */
+  private isTheme;
+  /**
+   * Applies the given theme to `<body>` (CSS class), persists it to `localStorage`,
+   * notifies the `changed` observable, and broadcasts the change to other tabs.
+   * @param theme - The `ThemeType` to apply (defaults to `'auto'`).
+   */
+  private setTheme;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ThemeService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}