@arsedizioni/ars-utils 22.0.21 → 22.0.23

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

@@ -7,21 +7,6 @@ import { SafeHtml, SafeResourceUrl } from '@angular/platform-browser';
 import { SelectionModel } from '@angular/cdk/collections';
 import { Observable } from 'rxjs';
 
-/**
- * Standalone providers for the ars-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: [provideArsCore()]
- * });
- */
-declare function provideArsCore(): EnvironmentProviders;
-
 declare const MAT_DATE_FNS_FORMATS: MatDateFormats;
 /**
  * date-fns adapter that integrates Angular Material's date picker with the date-fns library,
@@ -207,6 +192,15 @@ declare enum DateFormat {
     ShortUS = 11,// mm/dd/yyyy
     ShortISO8601 = 12
 }
+/**
+ * Key selector with IDE autocomplete and compile-time checking.
+ *
+ * Suggests the string keys of `T` in the editor and flags obvious typos when
+ * `T` is known, while STILL accepting any plain string (the `string & {}`
+ * branch), so existing callers that pass dynamic or untyped keys keep
+ * compiling unchanged.
+ */
+type KeyOf<T> = Extract<keyof T, string> | (string & {});
 interface PasswordStrength {
     score: number;
     label?: string;
@@ -224,7 +218,7 @@ declare class SystemUtils {
      * @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;
+    static arrayFindByKey<T>(array: T[] | undefined, key: KeyOf<T>, value: unknown): T | undefined;
     /**
      * Array find index by key
      * @param array   : the array to scan
@@ -232,7 +226,7 @@ declare class SystemUtils {
      * @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;
+    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
@@ -249,11 +243,13 @@ declare class SystemUtils {
     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.
+     * 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(key: string, order?: string): (a: Record<string, unknown>, b: Record<string, unknown>) => 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
@@ -321,13 +317,79 @@ declare class SystemUtils {
      */
     static compareNames(a?: string, b?: string): boolean;
     /**
-     * Cipher a text
-     * @param text    : the text
+     * 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 ciphered text
+     * @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.
@@ -397,11 +459,19 @@ declare class SystemUtils {
      * @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 null
+     * @returns       : a valid Date object or undefined
      */
     static parseDate(value?: string | Date, locale?: Locale): Date | undefined;
     /**
@@ -426,8 +496,17 @@ declare class SystemUtils {
      * @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 `Intl.NumberFormat`.
+     * 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'`).
@@ -435,7 +514,7 @@ declare class SystemUtils {
      */
     static formatNumber(value: number, decimals?: number, locale?: string): string;
     /**
-     * Formats a number as a currency string using `Intl.NumberFormat`.
+     * 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`).
@@ -465,7 +544,7 @@ declare class SystemUtils {
      * Generate a password
      * @returns : the password string
      */
-    static generatePassword(): string;
+    static generatePassword(length?: number): string;
     /**
      * Calculate password strength
      * @param password: the password to evaluate
@@ -660,7 +739,7 @@ declare class DateInterval {
     from?: Date;
     to?: Date;
     get fromAsDate(): Date | undefined;
-    get toAsDate(): Date;
+    get toAsDate(): Date | undefined;
     constructor(from?: Date, to?: Date);
     clear(): void;
 }
@@ -684,8 +763,15 @@ declare class DateIntervalChangeDirective {
     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.
+     * 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;
@@ -730,14 +816,29 @@ declare class EmailsValidatorDirective implements Validator {
 /**
  * Directive that validates that the host control's value equals the value of another control.
  * Bind `[equals]="otherControl"`.
+ *
+ * The host control is re-validated whenever the OTHER control's value changes:
+ * without this, typing a new password AFTER the confirmation field was filled
+ * left the form incorrectly valid (the classic password/confirm bug).
  */
 declare class EqualsValidatorDirective implements Validator {
     /** The control whose value must match the host control's value. */
     readonly equals: i0.InputSignal<AbstractControl<any, any, any>>;
+    /** Callback registered by Angular forms to re-run validation on the host control. */
+    private onValidatorChange?;
+    /** Subscription to the other control's valueChanges. */
+    private subscription?;
+    constructor();
+    /**
+     * Registers the callback Angular invokes to re-run this validator.
+     * @param fn - The revalidation callback provided by the forms API.
+     */
+    registerOnValidatorChange(fn: () => void): void;
     /**
      * Validates that the host control value equals the bound control's value.
      * Returns `null` (valid) when no control is bound.
      * @param control - The form control to validate.
+     * @returns `null` when valid, `{ equals: ... }` otherwise.
      */
     validate(control: AbstractControl): ValidationErrors | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<EqualsValidatorDirective, never>;
@@ -815,15 +916,29 @@ declare class NotEmptyValidatorDirective implements Validator {
 /**
  * Directive that validates that the host control's value is different from another control's value.
  * Bind `[notEqual]="otherControl"`.
+ *
+ * The host control is re-validated whenever the OTHER control's value changes,
+ * so editing either field keeps both error states consistent.
  */
 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>>;
+    /** Callback registered by Angular forms to re-run validation on the host control. */
+    private onValidatorChange?;
+    /** Subscription to the other control's valueChanges. */
+    private subscription?;
+    constructor();
+    /**
+     * Registers the callback Angular invokes to re-run this validator.
+     * @param fn - The revalidation callback provided by the forms API.
+     */
+    registerOnValidatorChange(fn: () => void): void;
     /**
      * Validates that the host control value is not equal to the bound control's value.
      * Also clears the `notequal` error on the other control when the host becomes valid.
      * Returns `null` (valid) when no control is bound.
      * @param control - The form control to validate.
+     * @returns `null` when valid, `{ notequal: true }` otherwise.
      */
     validate(control: AbstractControl): ValidationErrors | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<NotEqualValidatorDirective, never>;
@@ -1008,6 +1123,11 @@ declare class FormatMarkdownPipe 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.
@@ -1038,7 +1158,7 @@ declare class ReplacePipe implements PipeTransform {
      * @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;
+    transform(value: string | undefined, regexValue: string, replaceValue?: string): SafeHtml | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<ReplacePipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<ReplacePipe, "replace", true>;
 }
@@ -1101,7 +1221,9 @@ declare class SearchCallbackPipe implements PipeTransform {
 }
 
 /**
- * Impure pipe that filters an array of searchable items against a text query.
+ * Pure pipe that filters an array of searchable items against a text query.
+ * Note: being pure, it re-runs only when the array REFERENCE or the query
+ * changes; mutate-in-place updates of the array are not detected.
  *
  * Each item is matched either via its `searchBag.name` property (when present)
  * or by converting the item itself to a lowercase string. The optional `metadata`
@@ -1129,16 +1251,6 @@ declare class SearchFilterPipe implements PipeTransform {
     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
@@ -1157,6 +1269,11 @@ 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;
@@ -1169,13 +1286,16 @@ declare class SelectableModel<T, V> {
     /** 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. */
+    /** 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>;
     /**
      * @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'`).
+     * @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?: string);
+    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.
@@ -1229,6 +1349,7 @@ declare class SelectableModel<T, V> {
  * 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. */
@@ -1260,6 +1381,23 @@ declare class BroadcastChannelManager {
      * 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'`).
@@ -1319,6 +1457,7 @@ declare class BroadcastChannelManager {
     unsubscribeAll(): void;
 }
 
+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. */
@@ -1342,7 +1481,7 @@ declare class BroadcastService implements OnDestroy {
     /**
      * 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'`.
+     * @returns A new `BroadcastChannelManager` connected to `'D2693418-B18F-41BB-BAE9-41BB5407957A-CHANNEL'`.
      */
     static createChannel(): BroadcastChannelManager;
     ngOnDestroy(): void;
@@ -1371,11 +1510,25 @@ declare class BroadcastService implements OnDestroy {
      * @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<BroadcastService>;
 }
@@ -1557,5 +1710,5 @@ declare class ThemeService implements OnDestroy {
     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, SplashService, SqlDateValidatorDirective, SystemUtils, ThemeService, TimeValidatorDirective, UpdateRelationsModel, UrlValidatorDirective, UtilsMessages, ValidIfDirective, ValidatorDirective, ValueModel, provideArsCore, provideArsDateFns };
-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 };
+export { AutoFocusDirective, BroadcastChannelManager, BroadcastService, CHANNEL_NAME, 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, SplashService, SqlDateValidatorDirective, SystemUtils, ThemeService, TimeValidatorDirective, UpdateRelationsModel, UrlValidatorDirective, UtilsMessages, ValidIfDirective, ValidatorDirective, ValueModel, provideArsDateFns };
+export type { AddModel, AddResultModel, ApiResponse, ApiResult, BroadcastChannelMessageBag, BroadcastChannelSubscriberInfo, BroadcastMessageInfo, BroadcastMessageToastData, Checkable, DeleteResultModel, DoneResult, EnableDisableModel, ErrorInfo, File, Folder, FolderTree, INode, KeyOf, LoginResult, NameValueItem, PasswordStrength, QueryResultModel, SearchBag, SearchFilterMetadata, Searchable, SendToModel, ThemeType, UpdateModel, UpdateResultModel, Validated };

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

@@ -1,6 +1,11 @@
 import * as _angular_core from '@angular/core';
 
 declare class TinymceUtils {
+    /**
+     * Returns `true` when the user agent currently prefers a dark color scheme.
+     * Evaluated on demand (not frozen at module load) and SSR-safe.
+     */
+    private static prefersDark;
     /** URL of the TinyMCE script hosted on the Tiny Cloud CDN. */
     static readonly CDN_URL = "https://cdn.tiny.cloud/1/5lnoc6ohmpjau6zyzgqyhyf52cueoennkcs8v1yfoak57ku9/tinymce/7/tinymce.min.js";
     /** URL of the locally bundled TinyMCE script. */
@@ -32,7 +37,6 @@ interface FullScreenEditorDialogData {
     infoButtonLabel?: string;
     onShowInfo?: Function;
     disabled?: boolean;
-    useCDN?: boolean;
 }
 declare class FullScreenEditorComponent {
     /** Emitted with the edited text when the user saves. */

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

@@ -1,7 +1,7 @@
-import * as _angular_core from '@angular/core';
-import { EnvironmentProviders, OnDestroy, AfterViewInit, DoCheck, ElementRef } from '@angular/core';
 import { INode, Searchable, SearchBag, NameValueItem, DateInterval, SearchFilterMetadata, FileInfo } from '@arsedizioni/ars-utils/core';
 import { MatFormFieldAppearance, MatFormFieldControl } from '@angular/material/form-field';
+import * as _angular_core from '@angular/core';
+import { OnDestroy, AfterViewInit, DoCheck, ElementRef } from '@angular/core';
 import { MatDialogRef } from '@angular/material/dialog';
 import { DialogService } from '@arsedizioni/ars-utils/ui';
 import * as rxjs from 'rxjs';
@@ -12,19 +12,6 @@ import { MatCheckboxChange } from '@angular/material/checkbox';
 import { MatSelectionList, MatSelectionListChange } from '@angular/material/list';
 import { MatPaginator, PageEvent } from '@angular/material/paginator';
 
-/**
- * Standalone providers for the ars-utils "application" UI layer.
- *
- * Single source of truth for the environment-level configuration of this entry point.
- * Use it in a standalone bootstrap instead of importing ArsUIApplicationModule:
- *
- * @example
- * bootstrapApplication(AppComponent, {
- *   providers: [provideArsUIApplication()]
- * });
- */
-declare function provideArsUIApplication(): EnvironmentProviders;
-
 interface SendToDialogData {
     count: number;
     canPopulate?: boolean;
@@ -860,6 +847,14 @@ declare class ButtonSelectorComponent implements OnDestroy, ControlValueAccessor
     private focused;
     private _value;
     set value(value: NameValueItem<any> | undefined);
+    /**
+     * Updates the internal state. Form propagation is skipped for model->view
+     * writes (writeValue) to avoid the CVA echo loop, and performed for
+     * user/programmatic changes via the `value` setter.
+     * @param value     - The new value to store and display.
+     * @param propagate - When `true`, notifies the registered onChange callback.
+     */
+    private setValue;
     /** The current value as the selected item. */
     get value(): NameValueItem<any> | undefined;
     private _disabled;
@@ -990,6 +985,8 @@ declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor
     private readonly stateChanges;
     private readonly destroyRef;
     private changesEnabled;
+    private destroyed;
+    private widthRetries;
     /** Observer that tracks size changes of the container element. */
     private resizeObserver?;
     /** Debounce bridge for `ResizeObserver` notifications. */
@@ -1030,6 +1027,12 @@ declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor
     get shouldLabelFloat(): boolean;
     private _value?;
     set value(value: NameValueItem<any>[] | undefined);
+    /**
+     * Updates the internal state and selection mirrors.
+     * @param value     - The new selection array.
+     * @param propagate - When `true`, notifies the registered onChange callback.
+     */
+    private setValue;
     /** The current value as an array of selected items. */
     get value(): NameValueItem<any>[] | undefined;
     /** True when no item is selected. */
@@ -1481,6 +1484,8 @@ declare class ResizeTableColumnDirective {
     private readonly column;
     private table;
     private pressed;
+    /** Unlisten callbacks returned by renderer.listen, disposed on destroy. */
+    private readonly unlisteners;
     constructor();
     /**
      * Record the drag start position and initial column width.
@@ -1500,5 +1505,5 @@ declare class ResizeTableColumnDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ResizeTableColumnDirective, "[resizeColumn]", never, { "resizable": { "alias": "resizeColumn"; "required": false; "isSignal": true; }; "index": { "alias": "index"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { ApplicationDialogService, ButtonSelectorComponent, ButtonToggleComponent, CalendarEmptyHeader, ChipsSelectorComponent, CurrentFilter, CurrentFilterChanged, CurrentFilterItem, FileInputComponent, FilePreviewComponent, FilterBarComponent, Filters, ItemNode, PromptDateDialogComponent, PromptDialogComponent, PromptDialogType, PromptOtpDialogComponent, PromptTimeDialogComponent, ResizeTableColumnDirective, SelectDialogComponent, SelectFileDialogComponent, SelectPictureDialogComponent, SelectTreeDialogComponent, SelectableItem, SelectableNode, SendToDialogComponent, TreeDataSource, TreePickerComponent, provideArsUIApplication };
+export { ApplicationDialogService, ButtonSelectorComponent, ButtonToggleComponent, CalendarEmptyHeader, ChipsSelectorComponent, CurrentFilter, CurrentFilterChanged, CurrentFilterItem, FileInputComponent, FilePreviewComponent, FilterBarComponent, Filters, ItemNode, PromptDateDialogComponent, PromptDialogComponent, PromptDialogType, PromptOtpDialogComponent, PromptTimeDialogComponent, ResizeTableColumnDirective, SelectDialogComponent, SelectFileDialogComponent, SelectPictureDialogComponent, SelectTreeDialogComponent, SelectableItem, SelectableNode, SendToDialogComponent, TreeDataSource, TreePickerComponent };
 export type { ButtonToggleInfo, FilePreviewDialogData, FilterGroup, FilterItem, ISelectableItem, PromptDateDialogResult, PromptDialogData, PromptDialogResult, PromptOtpDialogResult, PromptTimeDialogData, SelectDialogAppend, SelectDialogData, SelectDialogDelete, SelectDialogEdit, SelectDialogFilter, SelectDialogLookup, SelectDialogResult, SelectFile, SelectFileDialogData, SelectFileOption, SelectPictureFileDialogData, SelectTreeDialogAppend, SelectTreeDialogData, SelectTreeDialogResult, SelectableFilter, SendToDialogData, SendToDialogResult, SendToPopulateData };