@arsedizioni/ars-utils 22.0.15 → 22.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arsedizioni/ars-utils",
-  "version": "22.0.15",
+  "version": "22.0.16",
   "author": {
     "email": "software@arsedizioni.it",
     "name": "Fabio Buscaroli, Alberto Doria"

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

@@ -1053,7 +1053,7 @@ declare class ClipperDocumentMenuComponent {
     /** Internal counter incremented on each external selection-model change to drive signal re-evaluation. */
     private readonly selectionChangeTick;
     readonly useSelections: _angular_core.InputSignal<boolean>;
-    readonly selectionSource: _angular_core.InputSignal<"none" | "selection" | "bag">;
+    readonly selectionSource: _angular_core.InputSignal<"selection" | "none" | "bag">;
     /**
      * Computed signal that returns the current effective document selection.
      * Re-evaluates when any input signal or the underlying selection model changes.

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

@@ -215,6 +215,8 @@ interface PasswordStrength {
     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
@@ -249,7 +251,7 @@ declare class SystemUtils {
      * 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 `0`, `1`, or `-1`.
+     * @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;
     /**
@@ -265,7 +267,7 @@ declare class SystemUtils {
      */
     static formatFileSize(bytes: number): string;
     /**
-     * Compare two 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
@@ -278,7 +280,7 @@ declare class SystemUtils {
      */
     static capitalize(s?: string): string | undefined;
     /**
-     * Truncate a string
+     * 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
@@ -307,42 +309,10 @@ declare class SystemUtils {
     /**
      * Convert markdown to html
      * @param markdown : the markdown data
-     * @param escapeEntities : true to escape entities. Default is false
+     * @param escapeHtml : true to escape HTML. Default is false
      * @returns the html
      */
-    static markdownToHtml(markdown: string, escapeEntities?: boolean): string;
-    /**
-     * Convert markdown table to html
-     * @param markdown: the markdown string
-     * @returns : the html
-     */
-    private static markdownConvertTables;
-    /**
-     * Convert a markdown table row to html
-     * @param row : the markdown row
-     * @param isHeader : true if is header
-     * @returns the html
-     */
-    private static markdownConvertTableRow;
-    /**
-     * Convert a markdown list to html
-     * @param markdown : the markdown list
-     * @returns the html
-     */
-    private static markdownConvertLists;
-    /**
-     * Wrap a list
-     * @param type: the list type
-     * @param items : the item list
-     * @returns the html
-     */
-    private static markdownWrapList;
-    /**
-     * Convert markdown paragraphs to html
-     * @param markdown : the markdown paragraphs
-     * @returns the html
-     */
-    private static markdownConvertParagraphs;
+    static markdownToHtml(markdown: string, escapeHtml?: boolean): string;
     /**
      * Compare two names
      * @param a   : name a
@@ -359,15 +329,16 @@ declare class SystemUtils {
      */
     static cipher(text: string, key: string, reverse?: boolean): string | undefined;
     /**
-     * Clone an object using JSON
-     * @param obj : the oblect to clone
+     * 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 by recursively copying all own properties.
+     * Creates a deep clone of an object.
      * @param obj  - The source object to clone.
-     * @param dest - Optional pre-allocated destination object; a new instance is created when omitted.
+     * @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;
@@ -397,14 +368,25 @@ declare class SystemUtils {
      * @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 is a valid email or null
+     * 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 and return true if is a valid url or null
+     * 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
      */
@@ -521,6 +503,8 @@ declare class SystemUtils {
      * @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

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

@@ -999,7 +999,7 @@ declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor
     /** Minimum width in pixels when collapsed. Use `-1` for automatic. */
     readonly collapsedWidth: _angular_core.InputSignal<number>;
     /** Display mode used when the selector is in collapsed state. */
-    readonly collapsedDisplayMode: _angular_core.InputSignal<"button" | "dropdown">;
+    readonly collapsedDisplayMode: _angular_core.InputSignal<"dropdown" | "button">;
     /** Pixel threshold below which the selector collapses. Use `-1` to disable. */
     readonly collapseAt: _angular_core.InputSignal<number>;
     /** When `true`, `collapseAt` is compared against the container width rather than the window width. */
@@ -1012,7 +1012,7 @@ declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor
     /** When `true`, at least one item must remain selected. */
     readonly mustSelect: _angular_core.InputSignal<boolean>;
     /** Layout mode: `'collapsed'` forces dropdown mode, `'dynamic'` collapses based on `collapseAt`. */
-    readonly mode: _angular_core.InputSignal<"dynamic" | "collapsed">;
+    readonly mode: _angular_core.InputSignal<"collapsed" | "dynamic">;
     /** When `true`, chips are stacked vertically instead of wrapping horizontally. */
     readonly stacked: _angular_core.InputSignal<boolean>;
     /** Chips below this index receive extra padding to align with other UI elements. */

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

@@ -393,7 +393,7 @@ declare class BusyDialogComponent {
     /** Current progress value (0–100). Used when `progressMode` is `'determinate'`. */
     readonly progress: _angular_core.WritableSignal<number>;
     /** Progress mode passed to the Material progress components. */
-    readonly progressMode: _angular_core.WritableSignal<"indeterminate" | "determinate">;
+    readonly progressMode: _angular_core.WritableSignal<"determinate" | "indeterminate">;
     /** Message displayed above the progress indicator. */
     readonly message: _angular_core.WritableSignal<string>;
     /**