@fabio.buscaroli/scm-utils 22.0.1

package/types/abv-scm-utils-core.d.ts

@@ -0,0 +1,1536 @@
+import * as i0 from '@angular/core';
+import { EnvironmentProviders, PipeTransform, EventEmitter, OnDestroy, Signal } from '@angular/core';
+import { DateAdapter, MatDateFormats } from '@angular/material/core';
+import { Locale } from 'date-fns';
+import { Validator, AbstractControl, ValidationErrors } from '@angular/forms';
+import { SafeHtml, SafeResourceUrl } from '@angular/platform-browser';
+import { SelectionModel } from '@angular/cdk/collections';
+import { Observable } from 'rxjs';
+
+/**
+ * Standalone providers for the scm-utils "core" layer.
+ *
+ * Registers the core pipes as injectable services so they can be used
+ * via `inject()` in services, guards, and resolvers — not only in templates.
+ * Components that use these pipes only in templates should import them
+ * directly via `imports: [FormatPipe, SafeHtmlPipe, ...]` instead.
+ *
+ * @example
+ * bootstrapApplication(AppComponent, {
+ *   providers: [provideSCMCore()]
+ * });
+ */
+declare function provideSCMCore(): EnvironmentProviders;
+
+declare const MAT_DATE_FNS_FORMATS: MatDateFormats;
+/**
+ * date-fns adapter that integrates Angular Material's date picker with the date-fns library,
+ * applying `Europe/Rome` timezone for all parsed and created dates.
+ */
+declare class DateFnsAdapter extends DateAdapter<Date, Locale> {
+    constructor(...args: unknown[]);
+    /**
+     * Returns the year component of the given date.
+     * @param date - The source date.
+     */
+    getYear(date: Date): number;
+    /**
+     * Returns the zero-based month index of the given date (0 = January).
+     * @param date - The source date.
+     */
+    getMonth(date: Date): number;
+    /**
+     * Returns the day-of-month of the given date (1-based).
+     * @param date - The source date.
+     */
+    getDate(date: Date): number;
+    /**
+     * Returns the day-of-week of the given date (0 = Sunday).
+     * @param date - The source date.
+     */
+    getDayOfWeek(date: Date): number;
+    /**
+     * Returns an array of 12 month name strings formatted for the active locale.
+     * @param style - One of `'long'`, `'short'`, or `'narrow'`.
+     */
+    getMonthNames(style: 'long' | 'short' | 'narrow'): string[];
+    /**
+     * Returns an array of 31 day-of-month label strings formatted using `Intl.DateTimeFormat`
+     * when available, falling back to plain numeric strings.
+     */
+    getDateNames(): string[];
+    /**
+     * Returns an array of 7 day-of-week name strings formatted for the active locale.
+     * @param style - One of `'long'`, `'short'`, or `'narrow'`.
+     */
+    getDayOfWeekNames(style: 'long' | 'short' | 'narrow'): string[];
+    /**
+     * Returns the four-digit year string for the given date.
+     * @param date - The source date.
+     */
+    getYearName(date: Date): string;
+    /**
+     * Returns the first day of the week for the active locale (0 = Sunday, 1 = Monday, …).
+     */
+    getFirstDayOfWeek(): number;
+    /**
+     * Returns the number of days in the month of the given date.
+     * @param date - The source date.
+     */
+    getNumDaysInMonth(date: Date): number;
+    /**
+     * Creates an independent copy of the given date.
+     * @param date - The date to clone.
+     */
+    clone(date: Date): Date;
+    /**
+     * Creates a `Date` in the `Europe/Rome` timezone for the given year, month, and day.
+     * Throws an `Error` when any component is out of range.
+     * @param year  - Full four-digit year.
+     * @param month - Zero-based month index (0 = January, 11 = December).
+     * @param date  - Day-of-month (1-based).
+     */
+    createDate(year: number, month: number, date: number): Date;
+    /**
+     * Returns today's date in the local timezone.
+     */
+    today(): Date;
+    /**
+     * Parses a value into a `Date`.
+     * - Strings are first attempted as ISO 8601, then matched against each format in `parseFormat`.
+     * - Numbers are treated as Unix timestamps (milliseconds).
+     * - Existing `Date` instances are cloned.
+     * @param value       - The value to parse.
+     * @param parseFormat - A format string or an array of format strings (date-fns tokens).
+     * @returns A valid `Date` in `Europe/Rome`, an invalid sentinel, or `null` for unrecognised input.
+     */
+    parse(value: unknown, parseFormat: string | string[]): Date | null;
+    /**
+     * Formats a `Date` using the given date-fns display format string.
+     * Throws an `Error` when `date` is not valid.
+     * @param date          - The date to format.
+     * @param displayFormat - A date-fns format string (e.g. `'P'`, `'LLL uuuu'`).
+     */
+    format(date: Date, displayFormat: string): string;
+    /**
+     * Adds the given number of whole years to a date.
+     * @param date  - The base date.
+     * @param years - Number of years to add (can be negative).
+     */
+    addCalendarYears(date: Date, years: number): Date;
+    /**
+     * Adds the given number of whole months to a date.
+     * @param date   - The base date.
+     * @param months - Number of months to add (can be negative).
+     */
+    addCalendarMonths(date: Date, months: number): Date;
+    /**
+     * Adds the given number of whole days to a date.
+     * @param date - The base date.
+     * @param days - Number of days to add (can be negative).
+     */
+    addCalendarDays(date: Date, days: number): Date;
+    /**
+     * Serialises a date to an ISO 8601 date string (`yyyy-MM-dd`).
+     * @param date - The date to serialise.
+     */
+    toIso8601(date: Date): string;
+    /**
+     * Returns the given value when it is a valid `Date`, or `null` for an empty string.
+     * Deserialises valid ISO 8601 strings into `Date` instances.
+     * Delegates all other values to the base-class implementation.
+     * @param value - The raw value to deserialise.
+     */
+    deserialize(value: unknown): Date | null;
+    /**
+     * Returns `true` when `obj` is an instance of `Date`.
+     * @param obj - The object to test.
+     */
+    isDateInstance(obj: unknown): boolean;
+    /**
+     * Returns `true` when `date` represents a valid point in time.
+     * @param date - The date to validate.
+     */
+    isValid(date: Date): boolean;
+    /**
+     * Returns a sentinel `Date` that represents an invalid date (`new Date(NaN)`).
+     */
+    invalid(): Date;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DateFnsAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DateFnsAdapter>;
+}
+/**
+ * Standalone providers for the scm-utils date-fns adapter.
+ *
+ * Configures Angular Material to use {@link DateFnsAdapter} (Europe/Rome timezone)
+ * and the matching {@link MAT_DATE_FNS_FORMATS}.
+ *
+ * @example
+ * bootstrapApplication(AppComponent, {
+ *   providers: [provideSCMDateFns()]
+ * });
+ */
+declare function provideSCMDateFns(): EnvironmentProviders;
+
+/**
+ * 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>;
+}
+
+interface INode {
+    id: string;
+    name: string;
+    count?: number;
+    children?: INode[];
+    subFolders?: INode[];
+    parent?: INode;
+    level?: number;
+    bag?: unknown;
+}
+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
+}
+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: string, 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: string, 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.
+     * @param key   - Name of the property to sort by.
+     * @param order - Sort direction: `'asc'` (default) or `'desc'`.
+     * @returns A comparator function that returns a negative, zero, or positive number.
+     */
+    static arraySortCompare(key: string, order?: string): (a: Record<string, unknown>, b: Record<string, unknown>) => 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;
+    /**
+     * Convert markdown to html
+     * @param markdown : the markdown data
+     * @param escapeHtml : true to escape HTML. Default is false
+     * @returns the html
+     */
+    static markdownToHtml(markdown: string, escapeHtml?: boolean): string;
+    /**
+     * Compare two names
+     * @param a   : name a
+     * @param b   : name b
+     * @returns   : true if a equals b
+     */
+    static compareNames(a?: string, b?: string): boolean;
+    /**
+     * Cipher a text
+     * @param text    : the text
+     * @param key     : the key
+     * @param reverse : true to decode, false to encode
+     * @returns       :the ciphered text
+     */
+    static cipher(text: string, key: string, reverse?: boolean): 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;
+    /**
+     * Parse a date
+     * @param value   : the value to check
+     * @param locale  : the locale to use
+     * @returns       : a valid Date object or null
+     */
+    static parseDate(value?: string | Date, locale?: Locale): Date | undefined;
+    /**
+     * Format a date
+     * @param value     : the date or string to format
+     * @param fmt       : the DateFormat to use or the string pattern
+     * @param locale    : the locale to use (default is IT)
+     * @returns         : the formatted string
+     */
+    static formatDate(value?: Date | string, fmt?: DateFormat | string, locale?: Locale): string;
+    /**
+     * Return an italian local date
+     * @param value  : the date
+     * @returns     : the new date
+     */
+    static toLocalDate(value?: Date | string): Date | undefined;
+    /**
+     * 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;
+    /**
+     * Formats a number using `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 `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(): 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;
+}
+
+interface DoneResult<T> {
+    isNew?: boolean;
+    data?: T;
+}
+interface ApiResponse {
+    success: boolean;
+    message: string;
+}
+interface ApiResult<T> extends ApiResponse {
+    value: T;
+}
+interface Folder extends INode {
+    teamId?: string;
+    parentId?: string;
+    position?: number;
+    isPrivate?: boolean;
+    itemsCount?: number;
+    subItemsCount?: number;
+}
+interface FolderTree extends Folder {
+    children?: Folder[];
+    path?: string;
+}
+interface File<T> {
+    ownerId?: T;
+    id?: number;
+    fileName: string;
+    fileData: unknown;
+}
+interface Validated {
+    isValid(): boolean;
+}
+declare class FileInfo implements Validated {
+    file: any;
+    valid: boolean;
+    isValid(): boolean;
+}
+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;
+}
+interface Checkable {
+    checked?: boolean;
+    bag: unknown;
+    getId(): unknown;
+}
+declare class ValueModel<T> {
+    value: T;
+}
+declare class IDModel<T = number> {
+    id: T;
+}
+declare class GroupModel<T = number> {
+    ids: T[];
+}
+declare class DeleteModel<T = number> extends GroupModel<T> {
+    mode?: number;
+    parentId?: T;
+}
+interface DeleteResultModel<T> {
+    items?: T[];
+    deleted: number;
+    total: number;
+    log?: string;
+}
+declare class RelationModel<T = number> {
+    id: T;
+    parentId: T;
+}
+declare class UpdateRelationsModel<T = number> {
+    id: T;
+    relatedIds: T[];
+}
+declare class QueryModel {
+    any?: string;
+    sortBy?: string;
+    sortDescending?: boolean;
+    first?: number;
+    count?: number;
+}
+interface QueryResultModel<T> {
+    interval?: string;
+    items: T[];
+    total: number;
+}
+interface UpdateModel<T = number> {
+    parentId?: T;
+    ids: T[];
+}
+interface UpdateResultModel<T> {
+    items?: T[];
+    updated: number;
+    total: number;
+    log?: string;
+}
+interface AddModel<T> extends UpdateModel<T> {
+}
+interface AddResultModel<T> {
+    items?: T[];
+    added: number;
+    total: number;
+    log?: string;
+}
+declare class ImportModel {
+    origin: string;
+    dataFile: FileInfo;
+    jumpFirstLine?: boolean;
+    map?: unknown;
+}
+interface EnableDisableModel {
+    value: boolean;
+}
+interface SendToModel {
+    sendToRecipients?: string;
+    sendToSubject?: string;
+    sendToText?: string;
+}
+interface SearchBag {
+    name: string;
+}
+interface Searchable {
+    searchBag: SearchBag;
+}
+interface SearchFilterMetadata {
+    total: number;
+    count: number;
+}
+declare class DateInterval {
+    from?: Date;
+    to?: Date;
+    get fromAsDate(): Date | undefined;
+    get toAsDate(): Date;
+    constructor(from?: Date, to?: Date);
+    clear(): void;
+}
+interface LoginResult<T> extends ApiResult<boolean> {
+    context: T;
+    oauth?: number;
+    requiresMfa?: boolean;
+}
+
+/**
+ * Directive that listens to `keyup` events on a date input and debounces changes
+ * into a {@link DateInterval} model, converting shorthand strings (e.g. "d/m") to dates.
+ * Apply `[dateIntervalChange]="interval"` to the host `<input>` element.
+ */
+declare class DateIntervalChangeDirective {
+    /** The date interval model to update when the input value changes. */
+    readonly dateIntervalChange: i0.InputSignal<DateInterval>;
+    /** When `true`, the directive updates the interval's end date; otherwise the start date. */
+    readonly end: i0.InputSignal<boolean>;
+    private readonly subject;
+    private readonly destroyRef;
+    constructor();
+    /**
+     * Handles `keyup` events on the host element.
+     * Prevents default browser behaviour for the space key and forwards the event to the debounce pipeline.
+     * @param e - The keyboard event emitted by the host input.
+     */
+    onKeyup(e: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DateIntervalChangeDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<DateIntervalChangeDirective, "[dateIntervalChange]", never, { "dateIntervalChange": { "alias": "dateIntervalChange"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that copies a string payload to the clipboard when the host element is clicked.
+ * Bind `[copyClipboard]="text"` to provide the content to copy and listen to `(copied)` for confirmation.
+ */
+declare class CopyClipboardDirective {
+    /** The text to copy to the clipboard. Bound via the `copyClipboard` attribute. */
+    readonly payload: i0.InputSignal<string>;
+    /** Emits the copied text after a successful copy operation. */
+    readonly copied: i0.OutputEmitterRef<string>;
+    /**
+     * Handles click events on the host element and copies the payload to the clipboard.
+     * Emits `copied` with the copied text on success.
+     * @param e - The mouse click event.
+     */
+    onClick(e: MouseEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CopyClipboardDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CopyClipboardDirective, "[copyClipboard]", never, { "payload": { "alias": "copyClipboard"; "required": false; "isSignal": true; }; }, { "copied": "copied"; }, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a semicolon-separated list of email addresses.
+ * Apply `emails` to a text input containing one or more addresses separated by `;`.
+ */
+declare class EmailsValidatorDirective implements Validator {
+    /**
+     * Validates each address in a semicolon-separated email list.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EmailsValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<EmailsValidatorDirective, "[emails]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that the host control's value equals the value of another control.
+ * Bind `[equals]="otherControl"`.
+ */
+declare class EqualsValidatorDirective implements Validator {
+    /** The control whose value must match the host control's value. */
+    readonly equals: i0.InputSignal<AbstractControl<any, any, any>>;
+    /**
+     * Validates that the host control value equals the bound control's value.
+     * Returns `null` (valid) when no control is bound.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EqualsValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<EqualsValidatorDirective, "[equals]", never, { "equals": { "alias": "equals"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a file size against configurable minimum and maximum bounds.
+ * Bind `[fileSize]` together with `[size]="fileSizeInMb"`, `[maxSizeMb]`, and `[minSizeMb]`.
+ */
+declare class FileSizeValidatorDirective implements Validator {
+    /** Maximum allowed file size in megabytes. Defaults to 5. */
+    readonly maxSizeMb: i0.InputSignal<number>;
+    /** Minimum required file size in megabytes. Defaults to 0. */
+    readonly minSizeMb: i0.InputSignal<number>;
+    /** The actual file size in megabytes to validate against the bounds. */
+    readonly size: i0.InputSignal<number>;
+    /**
+     * Validates that the bound file size falls within the configured min/max range.
+     * Returns `null` when no control value is present.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FileSizeValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<FileSizeValidatorDirective, "[fileSize]", never, { "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "minSizeMb": { "alias": "minSizeMb"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a control value as a GUID / UUID string.
+ * Apply `guid` to a text input that expects a valid UUID.
+ */
+declare class GuidValidatorDirective implements Validator {
+    /**
+     * Validates that the control value is a well-formed GUID / UUID.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GuidValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<GuidValidatorDirective, "[guid]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that a control value does not exceed a maximum word count.
+ * Bind `[maxTerms]="10"` to allow at most 10 whitespace-separated terms.
+ */
+declare class MaxTermsValidatorDirective implements Validator {
+    /** The maximum number of whitespace-separated terms allowed. */
+    readonly maxTerms: i0.InputSignal<number>;
+    /**
+     * Validates that the control value contains no more than the configured number of terms.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MaxTermsValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MaxTermsValidatorDirective, "[maxTerms]", never, { "maxTerms": { "alias": "maxTerms"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that a string control value is not blank (whitespace-only).
+ * Apply `notEmpty` to a text input where non-blank content is required.
+ */
+declare class NotEmptyValidatorDirective implements Validator {
+    /**
+     * Validates that the control value is a non-blank string.
+     * Returns `null` when the control is empty or not a string.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotEmptyValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NotEmptyValidatorDirective, "[notEmpty]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that the host control's value is different from another control's value.
+ * Bind `[notEqual]="otherControl"`.
+ */
+declare class NotEqualValidatorDirective implements Validator {
+    /** The control whose value must differ from the host control's value. */
+    readonly notEqual: i0.InputSignal<AbstractControl<any, any, any>>;
+    /**
+     * Validates that the host control value is not equal to the bound control's value.
+     * Also clears the `notequal` error on the other control when the host becomes valid.
+     * Returns `null` (valid) when no control is bound.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotEqualValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NotEqualValidatorDirective, "[notEqual]", never, { "notEqual": { "alias": "notEqual"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates that a control value is not a future date.
+ * Apply `notFuture` to a text input that expects a date on or before today.
+ */
+declare class NotFutureValidatorDirective implements Validator {
+    /**
+     * Validates that the control value represents a date that is not in the future.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotFutureValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NotFutureValidatorDirective, "[notFuture]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a control value as a sufficiently strong password.
+ * Apply `password` to a password input.
+ */
+declare class PasswordValidatorDirective implements Validator {
+    /**
+     * Validates that the control value meets the minimum password-strength requirements.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PasswordValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PasswordValidatorDirective, "[password]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that removes focus from the host element after it is clicked,
+ * preventing the browser from keeping a visible focus ring post-interaction.
+ * Apply `removeFocus` to any focusable element (e.g. a button).
+ */
+declare class RemoveFocusDirective {
+    private readonly elementRef;
+    /**
+     * Handles click events on the host element and blurs it on the next event-loop tick
+     * so that the click action completes before focus is removed.
+     */
+    onClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RemoveFocusDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RemoveFocusDirective, "[removeFocus]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a control value as a parseable SQL-compatible date string.
+ * Apply `sqlDate` to a text input that expects a date after year 1750.
+ */
+declare class SqlDateValidatorDirective implements Validator {
+    /**
+     * Validates that the control value can be parsed as a date after 1750.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SqlDateValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SqlDateValidatorDirective, "[sqlDate]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a time string against optional allowed time slot ranges.
+ * Bind `[time]` and optionally `[slots]="'08:00-12:00|14:00-18:00'"` (pipe-separated ranges).
+ */
+declare class TimeValidatorDirective implements Validator {
+    /** Optional pipe-separated list of allowed time ranges, e.g. `"08:00-12:00|14:00-18:00"`. */
+    readonly slots: i0.InputSignal<string>;
+    /**
+     * Parses a `"HH:MM"` time string into a comparable integer (e.g. `"09:30"` -> `930`).
+     * Returns `-1` when the string is not a valid time.
+     * @param value - The time string to parse.
+     */
+    private getTime;
+    /**
+     * Validates that the control value is a valid time string and, when slots are configured,
+     * that it falls within at least one of the allowed ranges.
+     * Returns `null` when the control is empty.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TimeValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<TimeValidatorDirective, "[time]", never, { "slots": { "alias": "slots"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a control value as a well-formed URL.
+ * Apply `url` to a text input that expects a URL.
+ */
+declare class UrlValidatorDirective implements Validator {
+    /**
+     * Validates that the control value is a well-formed URL.
+     * Returns `null` (valid) when the control is empty.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UrlValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<UrlValidatorDirective, "[url]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that validates a control using the host object's `isValid()` method
+ * or a boolean expression passed via `[validIf]`.
+ */
+declare class ValidIfDirective implements Validator {
+    /** When `true`, the control is considered valid regardless of the bound value. */
+    readonly validIf: i0.InputSignal<boolean>;
+    /**
+     * Validates the control value against a boolean flag or the value's own `isValid()` method.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ValidIfDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ValidIfDirective, "[validIf]", never, { "validIf": { "alias": "validIf"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Directive that delegates validation to an externally provided validator function.
+ * Bind `[validator]="myFn"` where `myFn` is `(c: AbstractControl) => ValidationErrors | null`.
+ */
+declare class ValidatorDirective implements Validator {
+    /** The custom validator function to apply. */
+    readonly validator: i0.InputSignal<(control: AbstractControl) => ValidationErrors | null>;
+    /**
+     * Invokes the provided validator function against the given control.
+     * Returns `null` (valid) when no function is bound.
+     * @param control - The form control to validate.
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ValidatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ValidatorDirective, "[validator]", never, { "validator": { "alias": "validator"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Pipe that converts plain-text newlines (`\r\n`, `\r`, `\n`) to HTML `<br>` tags
+ * and marks the result as trusted HTML so Angular does not escape it.
+ *
+ * Usage: `{{ text | formatHtml }}`
+ */
+declare class FormatHtmlPipe implements PipeTransform {
+    private readonly sanitizer;
+    /**
+     * Transforms a plain-text string into sanitized HTML by replacing newline characters
+     * with `<br>` tags.
+     * @param value - The input string to transform. Treated as an empty string when `undefined`.
+     * @returns A `SafeHtml` value that can be rendered with `[innerHTML]`.
+     */
+    transform(value?: string): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormatHtmlPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<FormatHtmlPipe, "formatHtml", true>;
+}
+
+/**
+ * Pipe that converts a Markdown string to sanitized HTML using `SystemUtils.markdownToHtml`.
+ *
+ * Usage: `{{ text | formatMarkdown }}`
+ */
+declare class FormatMarkdownPipe implements PipeTransform {
+    private readonly sanitizer;
+    /**
+     * Transforms a Markdown string into sanitized HTML.
+     * @param value - The Markdown input to convert. Treated as an empty string when `undefined`.
+     * @returns A `SafeHtml` value that can be rendered with `[innerHTML]`.
+     */
+    transform(value?: string): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormatMarkdownPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<FormatMarkdownPipe, "formatMarkdown", true>;
+}
+
+/**
+ * General-purpose formatting pipe that converts a raw value to a locale-aware string
+ * based on the specified format type.
+ *
+ * Supported types: `'date'` / `'D'`, `'currency'` / `'C'`, `'number'` / `'N'`,
+ * `'number0'` / `'N0'`, `'percentage'` / `'P'`.
+ *
+ * Usage: `{{ value | format:'currency' }}`
+ */
+declare class FormatPipe implements PipeTransform {
+    /**
+     * Formats a value according to the specified type and optional pattern.
+     * Returns `undefined` when the value is `null` or `undefined`, or when the type is unrecognised.
+     * @param value   - The raw value to format.
+     * @param type    - The format type identifier (default: `'date'`).
+     * @param pattern - The date pattern used when `type` is `'date'` (default: `'dd/MM/yyyy'`).
+     * @returns A formatted string, or `undefined` when the value cannot be formatted.
+     */
+    transform(value?: unknown, type?: string, pattern?: string): string | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormatPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<FormatPipe, "format", true>;
+}
+
+/**
+ * Pipe that applies a global regex replacement on a string and returns the result
+ * as sanitized HTML. When `regexValue` is `'\n'` and no `replaceValue` is given,
+ * newlines are replaced with `<br>` tags.
+ *
+ * Usage: `{{ text | replace:'\n':'' }}`
+ */
+declare class ReplacePipe implements PipeTransform {
+    private readonly sanitizer;
+    /**
+     * Replaces all occurrences of `regexValue` in `value` with `replaceValue`.
+     * Returns `undefined` when `value` is empty or `undefined`.
+     * @param value        - The source string to process.
+     * @param regexValue   - The regex pattern string to match (applied with the global flag).
+     * @param replaceValue - The replacement string. Defaults to `'<br>'` when `regexValue` is `'\n'` and this is falsy.
+     * @returns A `SafeHtml` value with all matches replaced, or `undefined` when the input is empty.
+     */
+    transform(value: string | undefined, regexValue: string, replaceValue: string): SafeHtml | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReplacePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ReplacePipe, "replace", true>;
+}
+
+/**
+ * Pipe that marks an HTML string as trusted so Angular does not escape it when
+ * bound via `[innerHTML]`.
+ *
+ * Usage: `<div [innerHTML]="html | safeHtml"></div>`
+ */
+declare class SafeHtmlPipe implements PipeTransform {
+    private readonly sanitizer;
+    /**
+     * Bypasses Angular's HTML sanitization and returns a `SafeHtml` instance.
+     * @param value - The raw HTML string to trust. Treated as an empty string when `undefined`.
+     * @returns A `SafeHtml` value that can be bound to `[innerHTML]` without escaping.
+     */
+    transform(value?: string): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SafeHtmlPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SafeHtmlPipe, "safeHtml", true>;
+}
+
+/**
+ * Pipe that marks a URL string as a trusted resource URL so Angular does not block it
+ * when bound to attributes such as `[src]` or `[href]` on iframes, objects, or embeds.
+ *
+ * Usage: `<iframe [src]="url | safeUrl"></iframe>`
+ */
+declare class SafeUrlPipe implements PipeTransform {
+    private readonly sanitizer;
+    /**
+     * Bypasses Angular's resource-URL sanitization and returns a `SafeResourceUrl` instance.
+     * @param value - The URL string to trust. Treated as an empty string when `undefined`.
+     * @returns A `SafeResourceUrl` that can be bound to resource URL attributes without blocking.
+     */
+    transform(value?: string): SafeResourceUrl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SafeUrlPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SafeUrlPipe, "safeUrl", true>;
+}
+
+/**
+ * Impure pipe that filters an array using a caller-provided predicate function.
+ * Because the pipe is impure it re-evaluates on every change-detection cycle,
+ * which is necessary when the predicate's captured state changes.
+ *
+ * Usage: `*ngFor="let item of items | callback:myFilter"`
+ */
+declare class SearchCallbackPipe implements PipeTransform {
+    /**
+     * Filters `items` by applying `callback` to each element.
+     * Returns the original array unchanged when either argument is falsy.
+     * @param items    - The source array to filter. May be `undefined`.
+     * @param callback - A predicate function that returns `true` for items to keep.
+     * @returns A new filtered array, the original array when no callback is provided,
+     *          or `undefined` when `items` is `undefined`.
+     */
+    transform<T>(items: T[] | undefined, callback: ((item: T) => boolean) | undefined): T[] | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SearchCallbackPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SearchCallbackPipe, "callback", true>;
+}
+
+/**
+ * Impure pipe that filters an array of searchable items against a text query.
+ *
+ * Each item is matched either via its `searchBag.name` property (when present)
+ * or by converting the item itself to a lowercase string. The optional `metadata`
+ * argument is updated in-place with the total item count and the filtered count,
+ * making it usable in the template alongside `*ngFor`.
+ *
+ * Usage:
+ * ```html
+ * <div *ngFor="let item of items | search:filterText:meta">...</div>
+ * <div>Showing {{ meta.count }} of {{ meta.total }}</div>
+ * ```
+ */
+declare class SearchFilterPipe implements PipeTransform {
+    /**
+     * Filters `items` by performing a case-insensitive substring match against `value`.
+     * When `items` or `value` is falsy the original array is returned unfiltered.
+     * @param items    - The source array to filter. May be `undefined`.
+     * @param value    - The search text to match against each item. May be `undefined`.
+     * @param metadata - Optional object that is updated with `total` and `count` after filtering.
+     * @returns The filtered array, the original array when no filter text is given,
+     *          or `undefined` when `items` is `undefined`.
+     */
+    transform(items?: any[], value?: string, metadata?: SearchFilterMetadata): any[] | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SearchFilterPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SearchFilterPipe, "search", true>;
+}
+
+declare const Breakpoints: {
+    XXSmall: string;
+    XSmall: string;
+    Small: string;
+    SmallMedium: string;
+    Medium: string;
+    MediumLarge: string;
+    Large: string;
+};
+
+declare const UtilsMessages: {
+    /**
+     * Messages
+     */
+    UTILS_DIALOGS_SELECT_OPTIONS_CHANGED: string;
+};
+
+/**
+ * Generic selection model that tracks a set of selected items identified by a lookup field.
+ * Wraps Angular CDK's `SelectionModel` and adds lookup-based add/remove logic.
+ *
+ * @typeParam T - The item type held in the selection.
+ * @typeParam V - The type of the lookup key used to identify items.
+ */
+declare class SelectableModel<T, V> {
+    /**
+     * Emits whenever the selection changes.
+     * Carries the affected item, or `undefined` when the whole selection is cleared.
+     */
+    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 selected. */
+    readonly hasValue: i0.Signal<boolean>;
+    /**
+     * @param allowMultiSelect - When `true` (default), multiple items can be selected simultaneously.
+     * @param lookupFieldName  - Name of the note used as the unique key when searching the internal list (default: `'id'`).
+     */
+    constructor(allowMultiSelect?: boolean, lookupFieldName?: string);
+    /**
+     * 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;
+}
+
+/**
+ * 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;
+}
+/** 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;
+}
+/**
+ * Wrapper around the native Web `BroadcastChannel` API that adds typed messaging,
+ * multiple named subscriptions, and a graceful disposal mechanism.
+ *
+ * @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;
+    /**
+     * 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;
+}
+
+/** 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;
+}
+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 `'ARS-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 an `Observable` that emits every in-process message published via `sendMessage`.
+     * @returns An observable stream of `BroadcastMessageInfo` objects.
+     */
+    getMessage(): Observable<BroadcastMessageInfo>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BroadcastService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BroadcastService>;
+}
+
+/**
+ * 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<EnvironmentService>;
+}
+
+/**
+ * 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<ScreenService>;
+}
+
+/** The three available theme modes: follow system preference, force light, or force dark. */
+type ThemeType = 'auto' | 'light' | 'dark';
+/**
+ * Application-level theme management service.
+ *
+ * Responsibilities:
+ * - Persists the user's preferred theme in `localStorage`.
+ * - Applies `'light'` or `'dark'` CSS class to `<body>`.
+ * - Reacts to OS-level colour-scheme changes when the theme is set to `'auto'`.
+ * - 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<ThemeService>;
+}
+
+export { AutoFocusDirective, Breakpoints, BroadcastChannelManager, BroadcastService, CopyClipboardDirective, DateFnsAdapter, DateFormat, DateInterval, DateIntervalChangeDirective, DeleteModel, EmailsValidatorDirective, EnvironmentService, EqualsValidatorDirective, FileInfo, FileSizeValidatorDirective, FormatHtmlPipe, FormatMarkdownPipe, FormatPipe, GroupModel, GuidValidatorDirective, IDModel, ImportModel, MAT_DATE_FNS_FORMATS, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, QueryModel, RelationModel, RemoveFocusDirective, ReplacePipe, SafeHtmlPipe, SafeUrlPipe, ScreenService, SearchCallbackPipe, SearchFilterPipe, SelectableModel, SqlDateValidatorDirective, SystemUtils, ThemeService, TimeValidatorDirective, UpdateRelationsModel, UrlValidatorDirective, UtilsMessages, ValidIfDirective, ValidatorDirective, ValueModel, provideSCMCore, provideSCMDateFns };
+export type { AddModel, AddResultModel, ApiResponse, ApiResult, BroadcastChannelMessageBag, BroadcastChannelSubscriberInfo, BroadcastMessageInfo, BroadcastMessageToastData, Checkable, DeleteResultModel, DoneResult, EnableDisableModel, ErrorInfo, File, Folder, FolderTree, INode, LoginResult, NameValueItem, PasswordStrength, QueryResultModel, SearchBag, SearchFilterMetadata, Searchable, SendToModel, ThemeType, UpdateModel, UpdateResultModel, Validated };