@fabio.buscaroli/scm-utils 22.0.1

package/fesm2022/fabio.buscaroli-scm-utils-core.mjs

@@ -0,0 +1,3293 @@
+import * as i0 from '@angular/core';
+import { Pipe, inject, makeEnvironmentProviders, Injectable, ElementRef, afterNextRender, Directive, input, DestroyRef, HostListener, output, forwardRef, EventEmitter, signal, computed, Service, RendererFactory2 } from '@angular/core';
+import { parseISO, parse, format, getYear, getMonth, getDate, getDay, getDaysInMonth, addYears, addMonths, addDays, formatISO, isDate, isValid, endOfDay } from 'date-fns';
+import { it } from 'date-fns/locale';
+import { TZDate } from '@date-fns/tz';
+import { DomSanitizer } from '@angular/platform-browser';
+import { DateAdapter, MAT_DATE_LOCALE, MAT_DATE_FORMATS } from '@angular/material/core';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import { Subject, BehaviorSubject } from 'rxjs';
+import { debounceTime } from 'rxjs/operators';
+import { NG_VALIDATORS } from '@angular/forms';
+import { SelectionModel } from '@angular/cdk/collections';
+
+/**
+ * Zero-dependency Markdown to HTML converter.
+ *
+ * Design goals:
+ * - Single line-based pass over blocks (no repeated full-string regex passes).
+ * - Inline formatting never touches code spans / code blocks (stash & restore).
+ * - No HTML entity escaping by default in normal text: the source passes as-is.
+ *   Exception: the content of code spans / code blocks is ALWAYS escaped, so
+ *   things like List<string> render correctly (the browser displays the
+ *   original characters; entities never reach the user or the clipboard).
+ *   Opt-in full escaping via { escapeHtml: true } for untrusted input.
+ * - URL sanitization on links/images (javascript:, vbscript:, data: are dropped).
+ * - Bounded result cache for repeated renders (Angular change detection friendly).
+ *
+ * Supported syntax: headings, paragraphs, hard/soft breaks, hr, blockquotes
+ * (nested), fenced code blocks, inline code, bold/italic/strikethrough, links
+ * (with title), images, autolinked bare URLs, ordered/unordered lists (nested,
+ * task lists, ordered start offset), GFM tables with alignment.
+ *
+ * Known simplifications (documented, by design):
+ * - A blank line terminates a list.
+ * - Setext headings (=== / ---) are not supported, use # syntax.
+ * - Reference-style links [text][ref] are not supported.
+ */
+class MarkdownUtils {
+    // #region Cache
+    static { this.cache = new Map(); }
+    static { this.CACHE_MAX = 200; }
+    /** Clears the internal result cache. */
+    static clearCache() {
+        this.cache.clear();
+    }
+    // #endregion
+    // #region Public API
+    /**
+     * Convert markdown to HTML.
+     * @param markdown : the markdown source
+     * @param options  : conversion options
+     * @returns        : the HTML string ('' when input is falsy)
+     */
+    static toHtml(markdown, options) {
+        if (!markdown)
+            return '';
+        const opts = { escapeHtml: false, breaks: true, ...options };
+        const key = `${opts.escapeHtml ? 1 : 0}${opts.breaks ? 1 : 0}|${markdown}`;
+        const hit = this.cache.get(key);
+        if (hit !== undefined)
+            return hit;
+        // Normalize line endings and fix glued sentence punctuation ("dettaglio!Ecco")
+        const source = markdown
+            .replace(/\r\n?/g, '\n')
+            .replace(/([A-Za-zÀ-ÿ][!?])([A-Za-zÀ-ÿ])/g, '$1 $2');
+        const html = this.parseBlocks(source.split('\n'), opts).trim();
+        if (this.cache.size >= this.CACHE_MAX) {
+            this.cache.delete(this.cache.keys().next().value); // FIFO eviction
+        }
+        this.cache.set(key, html);
+        return html;
+    }
+    // #endregion
+    // #region Block parser (single pass)
+    static parseBlocks(lines, opts) {
+        const out = [];
+        let paragraph = [];
+        const flush = () => {
+            if (paragraph.length > 0) {
+                const sep = opts.breaks ? '<br>' : ' ';
+                out.push(`<p>${paragraph.map(l => this.inline(l, opts)).join(sep)}</p>`);
+                paragraph = [];
+            }
+        };
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const trimmed = line.trim();
+            // --- Fenced code block -------------------------------------------------
+            const fence = trimmed.match(/^```([\w+-]+)?\s*$/);
+            if (fence) {
+                flush();
+                const lang = fence[1] ? ` class="language-${fence[1]}"` : '';
+                const code = [];
+                i++;
+                while (i < lines.length && !/^```\s*$/.test(lines[i].trim())) {
+                    code.push(lines[i]);
+                    i++;
+                }
+                out.push(`<pre><code${lang}>${this.escape(code.join('\n'))}</code></pre>`);
+                continue;
+            }
+            // --- Blank line --------------------------------------------------------
+            if (!trimmed) {
+                flush();
+                continue;
+            }
+            // --- ATX heading -------------------------------------------------------
+            const heading = trimmed.match(/^(#{1,6})\s+(.+?)\s*#*\s*$/);
+            if (heading) {
+                flush();
+                const level = heading[1].length;
+                out.push(`<h${level}>${this.inline(heading[2], opts)}</h${level}>`);
+                continue;
+            }
+            // --- Horizontal rule ---------------------------------------------------
+            if (/^(?:-{3,}|\*{3,}|_{3,})$/.test(trimmed)) {
+                flush();
+                out.push('<hr>');
+                continue;
+            }
+            // --- Blockquote (consecutive lines, one level stripped, recursive) ------
+            if (/^>\s?/.test(trimmed)) {
+                flush();
+                const quoted = [];
+                while (i < lines.length && /^>\s?/.test(lines[i].trim())) {
+                    quoted.push(lines[i].trim().replace(/^>\s?/, ''));
+                    i++;
+                }
+                i--;
+                out.push(`<blockquote>${this.parseBlocks(quoted, opts)}</blockquote>`);
+                continue;
+            }
+            // --- Table (header row + separator row) ---------------------------------
+            if (trimmed.includes('|') &&
+                i + 1 < lines.length &&
+                lines[i + 1].includes('-') &&
+                /^\|?[\s:\-|]+\|?$/.test(lines[i + 1].trim())) {
+                flush();
+                const aligns = this.tableAligns(lines[i + 1].trim());
+                const head = this.tableRow(trimmed, 'th', aligns, opts);
+                const body = [];
+                i += 2;
+                while (i < lines.length && lines[i].trim().includes('|')) {
+                    body.push(this.tableRow(lines[i].trim(), 'td', aligns, opts));
+                    i++;
+                }
+                i--;
+                out.push(`<table>\n<thead>\n${head}\n</thead>` +
+                    (body.length > 0 ? `\n<tbody>\n${body.join('\n')}\n</tbody>` : '') +
+                    `\n</table>`);
+                continue;
+            }
+            // --- List ---------------------------------------------------------------
+            if (MarkdownUtils.listItemRe.test(line)) {
+                flush();
+                const [html, last] = this.parseList(lines, i, opts);
+                out.push(html);
+                i = last;
+                continue;
+            }
+            // --- Plain text: accumulate into current paragraph ----------------------
+            paragraph.push(trimmed);
+        }
+        flush();
+        return out.join('\n');
+    }
+    // #endregion
+    // #region Lists
+    /** Matches "- item", "* item", "+ item", "1. item", "1) item" with leading indent. */
+    static { this.listItemRe = /^(\s*)([-*+]|\d+[.)])\s+(.*)$/; }
+    /**
+     * Gathers the contiguous list block starting at `start`, builds it (with
+     * nesting) and returns [html, indexOfLastConsumedLine].
+     */
+    static parseList(lines, start, opts) {
+        const block = [];
+        let i = start;
+        while (i < lines.length) {
+            const l = lines[i];
+            if (!l.trim())
+                break; // blank line ends the list
+            if (this.listItemRe.test(l) || /^\s{2,}\S/.test(l)) {
+                block.push(l);
+                i++;
+            }
+            else
+                break;
+        }
+        return [this.buildList(block, opts), i - 1];
+    }
+    static buildList(block, opts) {
+        const first = block[0].match(this.listItemRe);
+        const baseIndent = first[1].length;
+        const ordered = /^\d/.test(first[2]);
+        const startNum = ordered ? parseInt(first[2], 10) : 1;
+        const items = [];
+        for (const l of block) {
+            const m = l.match(this.listItemRe);
+            if (m && m[1].length <= baseIndent) {
+                items.push({ text: m[3], childLines: [] });
+            }
+            else if (items.length > 0) {
+                // Continuation or nested content: strip one nesting level of indent
+                items[items.length - 1].childLines.push(l.length > baseIndent + 2 ? l.slice(baseIndent + 2) : l.trim());
+            }
+        }
+        const lis = items.map(item => {
+            let inner;
+            // GFM task list: - [ ] / - [x]
+            const task = item.text.match(/^\[([ xX])\]\s+(.*)$/);
+            if (task) {
+                const checked = task[1] !== ' ' ? ' checked' : '';
+                inner = `<input type="checkbox" disabled${checked}> ${this.inline(task[2], opts)}`;
+            }
+            else {
+                inner = this.inline(item.text, opts);
+            }
+            if (item.childLines.length > 0) {
+                inner += '\n' + this.parseBlocks(item.childLines, opts);
+            }
+            return `<li>${inner}</li>`;
+        });
+        const tag = ordered ? 'ol' : 'ul';
+        const startAttr = ordered && startNum > 1 ? ` start="${startNum}"` : '';
+        return `<${tag}${startAttr}>\n${lis.join('\n')}\n</${tag}>`;
+    }
+    // #endregion
+    // #region Tables
+    static tableAligns(separator) {
+        return separator
+            .replace(/^\||\|$/g, '')
+            .split('|')
+            .map(cell => {
+            const t = cell.trim();
+            if (t.startsWith(':') && t.endsWith(':'))
+                return 'center';
+            if (t.endsWith(':'))
+                return 'right';
+            if (t.startsWith(':'))
+                return 'left';
+            return undefined;
+        });
+    }
+    static tableRow(row, tag, aligns, opts) {
+        const cells = row.replace(/^\||\|$/g, '').split('|').map(c => c.trim());
+        const cellsHtml = cells
+            .map((cell, j) => {
+            const align = aligns[j] ? ` align="${aligns[j]}"` : '';
+            return `<${tag}${align}>${this.inline(cell, opts)}</${tag}>`;
+        })
+            .join('');
+        return `<tr>${cellsHtml}</tr>`;
+    }
+    // #endregion
+    // #region Inline formatting
+    /**
+     * Applies inline markdown to a single text segment.
+     * Generated HTML (code, links, images, autolinks) is stashed behind \u0000
+     * placeholders so later regex passes can never corrupt it.
+     */
+    static inline(text, opts) {
+        const store = [];
+        const stash = (html) => `\u0000${store.push(html) - 1}\u0000`;
+        // 1. Inline code: stash first so later passes can't touch it.
+        //    Content is ALWAYS escaped so <, >, & inside code survive in the DOM
+        //    (the browser renders entities back to the original characters).
+        let s = text.replace(/`([^`]+)`/g, (_m, code) => stash(`<code>${this.escape(code)}</code>`));
+        // 2. Escape raw HTML as entities (opt-in only)
+        if (opts.escapeHtml)
+            s = this.escape(s);
+        // 3. Images: ![alt](url "title")
+        s = s.replace(/!\[([^\]]*)\]\(\s*([^)\s]+)(?:\s+(?:"|&quot;)(.+?)(?:"|&quot;))?\s*\)/g, (_m, alt, src, title) => {
+            const url = this.safeUrl(src);
+            if (!url)
+                return alt;
+            const t = title ? ` title="${title}"` : '';
+            return stash(`<img src="${url}" alt="${alt}"${t} loading="lazy">`);
+        });
+        // 4. Links: [text](url "title")
+        s = s.replace(/\[([^\]]+)\]\(\s*([^)\s]+)(?:\s+(?:"|&quot;)(.+?)(?:"|&quot;))?\s*\)/g, (_m, txt, href, title) => {
+            const url = this.safeUrl(href);
+            if (!url)
+                return txt;
+            const t = title ? ` title="${title}"` : '';
+            return stash(`<a href="${url}"${t} target="_blank" rel="noopener noreferrer">${txt}</a>`);
+        });
+        // 5. Autolink remaining bare URLs (markdown links are already stashed)
+        s = s.replace(/https?:\/\/[^\s<>"']+/g, url => stash(`<a href="${url}" target="_blank" rel="noopener noreferrer">${url}</a>`));
+        // 6. Bold / italic / strikethrough.
+        //    Delimiters must hug the text; underscore emphasis only at word
+        //    boundaries so identifiers like snake_case are left untouched.
+        s = s.replace(/\*\*\*(?=\S)([\s\S]*?\S)\*\*\*/g, '<strong><em>$1</em></strong>');
+        s = s.replace(/(?<![\w*])___(?=\S)([\s\S]*?\S)___(?![\w*])/g, '<strong><em>$1</em></strong>');
+        s = s.replace(/\*\*(?=\S)([\s\S]*?\S)\*\*/g, '<strong>$1</strong>');
+        s = s.replace(/(?<![\w*])__(?=\S)([\s\S]*?\S)__(?![\w*])/g, '<strong>$1</strong>');
+        s = s.replace(/\*(?=\S)([^*\n]*?\S)\*/g, '<em>$1</em>');
+        s = s.replace(/(?<![\w_])_(?=\S)([^_\n]*?\S)_(?![\w_])/g, '<em>$1</em>');
+        s = s.replace(/~~(?=\S)([\s\S]*?\S)~~/g, '<del>$1</del>');
+        // 7. Restore stashed HTML
+        return s.replace(/\u0000(\d+)\u0000/g, (_m, idx) => store[Number(idx)] ?? '');
+    }
+    // #endregion
+    // #region Security helpers
+    /** Escapes &, <, > and " for safe HTML interpolation. */
+    static escape(s) {
+        return s
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;');
+    }
+    /**
+     * Returns a sanitized URL or undefined when the scheme is dangerous.
+     * Blocks javascript:, vbscript: and data: (also when obfuscated with
+     * whitespace/control characters, e.g. "java\tscript:").
+     */
+    static safeUrl(url) {
+        const compact = url.replace(/[\s\u0000-\u001f]/g, '');
+        if (/^(javascript|vbscript|data):/i.test(compact))
+            return undefined;
+        return url.replace(/"/g, '%22');
+    }
+    // #endregion
+    // #region Clipboard
+    /**
+     * Copies markdown content to the clipboard in two flavors:
+     * - text/html  : the rendered HTML (rich paste into Word, Outlook, Gmail...)
+     * - text/plain : the original markdown source (paste into editors, IDEs...)
+     * @param markdown : the markdown source
+     * @param options  : conversion options for the HTML flavor
+     * @returns        : true on success
+     */
+    static async copyToClipboard(markdown, options) {
+        if (!markdown || typeof navigator === 'undefined' || !navigator.clipboard)
+            return false;
+        try {
+            if (typeof ClipboardItem !== 'undefined') {
+                const html = this.toHtml(markdown, options);
+                await navigator.clipboard.write([
+                    new ClipboardItem({
+                        'text/html': new Blob([html], { type: 'text/html' }),
+                        'text/plain': new Blob([markdown], { type: 'text/plain' }),
+                    }),
+                ]);
+            }
+            else {
+                // Older engines: plain text only
+                await navigator.clipboard.writeText(markdown);
+            }
+            return true;
+        }
+        catch {
+            // Clipboard API requires a secure context and user activation
+            return false;
+        }
+    }
+    /**
+     * Copies plain text (e.g. the content of a single code block) to the clipboard.
+     * @param text : the text to copy
+     * @returns    : true on success
+     */
+    static async copyText(text) {
+        if (!text || typeof navigator === 'undefined' || !navigator.clipboard)
+            return false;
+        try {
+            await navigator.clipboard.writeText(text);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Extracts the visible plain text from a rendered element
+     * (what the user sees, entities already decoded by the browser).
+     * @param element : the element hosting the rendered markdown
+     * @returns       : the plain text
+     */
+    static elementToText(element) {
+        return element.innerText ?? element.textContent ?? '';
+    }
+}
+
+var DateFormat;
+(function (DateFormat) {
+    DateFormat[DateFormat["Short"] = 1] = "Short";
+    DateFormat[DateFormat["Long"] = 2] = "Long";
+    DateFormat[DateFormat["LongWithShortMonth"] = 3] = "LongWithShortMonth";
+    DateFormat[DateFormat["LongWithWeekDay"] = 4] = "LongWithWeekDay";
+    DateFormat[DateFormat["LongWithShortWeekDay"] = 5] = "LongWithShortWeekDay";
+    DateFormat[DateFormat["MonthAndYear"] = 6] = "MonthAndYear";
+    DateFormat[DateFormat["LongMonthAndYear"] = 7] = "LongMonthAndYear";
+    DateFormat[DateFormat["WeekDay"] = 8] = "WeekDay";
+    DateFormat[DateFormat["LongWeekDay"] = 9] = "LongWeekDay";
+    DateFormat[DateFormat["DayAndMonth"] = 10] = "DayAndMonth";
+    DateFormat[DateFormat["ShortUS"] = 11] = "ShortUS";
+    DateFormat[DateFormat["ShortISO8601"] = 12] = "ShortISO8601"; // yyyy-mm-dd
+})(DateFormat || (DateFormat = {}));
+class SystemUtils {
+    /** Shared collator for locale-aware, case-insensitive string comparison. */
+    static { this.collator = new Intl.Collator('it', { sensitivity: 'base', numeric: true }); }
+    /**
+     * 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(array, key, value) {
+        if (!array)
+            return undefined;
+        for (const item of array) {
+            if (item[key] === value) {
+                return item;
+            }
+        }
+        return 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(array, key, value) {
+        if (!array)
+            return -1;
+        for (let i = 0; i < array.length; i++) {
+            if (array[i][key] === value) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    /**
+     * 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(array, value) {
+        if (!array)
+            return undefined;
+        for (const item of array) {
+            const i = item;
+            if (i['value'] === value) {
+                return i['name'] ?? i['id'];
+            }
+        }
+        return undefined;
+    }
+    /**
+     * 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, parent) {
+        const nodes = [];
+        items.forEach(n => {
+            const node = {
+                id: n.id.toString(),
+                name: n.name,
+                count: n.count ? n.count : 0,
+                children: undefined,
+                parent,
+                bag: n,
+            };
+            nodes.push(node);
+            node.children =
+                n.children && n.children.length > 0
+                    ? this.arrayToNodes(n.children, node)
+                    : [];
+        });
+        return nodes;
+    }
+    /**
+     * 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, order = 'asc') {
+        const dir = order === 'desc' ? -1 : 1;
+        return (a, b) => {
+            const varA = a[key];
+            const varB = b[key];
+            if (varA === varB)
+                return 0;
+            if (varA === undefined || varA === null)
+                return -1 * dir;
+            if (varB === undefined || varB === null)
+                return 1 * dir;
+            if (typeof varA === 'string' && typeof varB === 'string') {
+                return SystemUtils.collator.compare(varA, varB) * dir;
+            }
+            return (varA > varB ? 1 : varA < varB ? -1 : 0) * dir;
+        };
+    }
+    /**
+     * Format weight
+     * @param gr    : grams
+     * @returns     : the formatted string
+     */
+    static formatWeight(gr) {
+        if (gr > 1000000)
+            return `${(gr / 1000000).toFixed(2)} t`;
+        else if (gr > 100000)
+            return `${(gr / 100000).toFixed(2)} q`;
+        else if (gr > 1000)
+            return `${(gr / 1000).toFixed(2)} kg`;
+        else
+            return `${gr} gr`;
+    }
+    /**
+     * Format file size
+     * @param bytes : number of bytes
+     * @returns     : the formatted string
+     */
+    static formatFileSize(bytes) {
+        if (bytes > 1024000)
+            return `${(bytes / 1024000).toFixed(1)} MB`;
+        if (bytes > 1024)
+            return `${(bytes / 1024).toFixed(1)} Kb`;
+        return `${bytes} byte`;
+    }
+    /**
+     * 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, b) {
+        return this.collator.compare(a ?? '', b ?? '');
+    }
+    /**
+     * Capitalize a string
+     * @param s   : the string to capitalize
+     * @returns   : the capitalized string
+     */
+    static capitalize(s) {
+        if (!s)
+            return undefined;
+        let b = "";
+        let cap = true;
+        for (const char of s) {
+            if (char === " ") {
+                b += char;
+                cap = true;
+            }
+            else if (cap) {
+                b += char.toUpperCase();
+                cap = false;
+            }
+            else {
+                b += char.toLowerCase();
+            }
+        }
+        return b;
+    }
+    /**
+     * 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, max = 500) {
+        if (!s)
+            return undefined;
+        if (s.length < max)
+            return s;
+        const i = s.lastIndexOf(' ', max - 1);
+        return i > 0 ? s.slice(0, i) : s;
+    }
+    /**
+     * 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, sep = " ", max = 350) {
+        if (!items || items.length === 0)
+            return undefined;
+        if (items.length > 1) {
+            let l = 0;
+            let s = "";
+            while (s.length < max && items.length > l) {
+                if (l > 0) {
+                    s += sep;
+                }
+                s += items[l++];
+            }
+            if (items.length > l) {
+                s += "...";
+            }
+            return s;
+        }
+        return items[0];
+    }
+    /**
+     * 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) {
+        if (!s)
+            return s;
+        return s
+            .split(' ')
+            .map((word, wordIndex) => {
+            if (!word)
+                return word;
+            // If the word is all uppercase and contains at least one letter, we assume it's an acronym and leave it as is
+            if (word === word.toUpperCase() && /[A-Z]/.test(word)) {
+                return word;
+            }
+            // Otherwise, convert to lowercase letter by letter
+            const chars = word.split('');
+            return chars
+                .map((char, charIndex) => {
+                if (charIndex === 0 && wordIndex === 0) {
+                    // First letter of the first word:
+                    // remains uppercase only if the first 2 letters are both uppercase
+                    const secondChar = chars[1] ?? '';
+                    const keepUppercase = char === char.toUpperCase() &&
+                        secondChar === secondChar.toUpperCase() &&
+                        /[A-Z]/.test(char) &&
+                        /[A-Z]/.test(secondChar);
+                    return keepUppercase ? char : char.toLowerCase();
+                }
+                return char.toLowerCase();
+            })
+                .join('');
+        })
+            .join(' ');
+    }
+    /**
+     * 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) {
+        if (!s)
+            return '';
+        return s.replace(/https?:\/\/[^\s<]+/gi, v => `<a href="${v}" target="_blank" rel="noopener">${v}</a>`);
+    }
+    /**
+     * Convert markdown to html
+     * @param markdown : the markdown data
+     * @param escapeHtml : true to escape HTML. Default is false
+     * @returns the html
+     */
+    static markdownToHtml(markdown, escapeHtml = false) {
+        return MarkdownUtils.toHtml(markdown, { escapeHtml: escapeHtml });
+    }
+    /**
+     * Compare two names
+     * @param a   : name a
+     * @param b   : name b
+     * @returns   : true if a equals b
+     */
+    static compareNames(a, b) {
+        if (a)
+            a = a.trim();
+        if (b)
+            b = b.trim();
+        if (a && b && a.length !== b.length)
+            return false;
+        if (this.compareString(a, b) === 0)
+            return true;
+        const p1 = (a ?? '').split(' ');
+        const p2 = (b ?? '').split(' ');
+        if (p1.length !== p2.length)
+            return false;
+        let matches = p1.length;
+        for (const s1 of p1) {
+            for (const s2 of p2) {
+                if (this.compareString(s1, s2) === 0) {
+                    matches--;
+                    break;
+                }
+            }
+        }
+        return matches === 0;
+    }
+    /**
+     * 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, key, reverse = false) {
+        if (!text || !key)
+            return undefined;
+        // Surrogate pair limit
+        const bound = 0x10000;
+        const keyLen = key.length;
+        let result = '';
+        for (let i = 0; i < text.length; i++) {
+            let rotation = key.charCodeAt(i % keyLen);
+            if (reverse)
+                rotation = -rotation;
+            result += String.fromCharCode((text.charCodeAt(i) + rotation + bound) % bound);
+        }
+        return result;
+    }
+    /**
+     * 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(obj) {
+        if (!obj)
+            return {};
+        return structuredClone(obj);
+    }
+    /**
+     * 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(obj, dest) {
+        const cloned = structuredClone(obj);
+        if (dest) {
+            Object.assign(dest, cloned);
+            return dest;
+        }
+        return cloned;
+    }
+    /**
+     * Returns `true` when `value` is a syntactically valid UUID string.
+     * @param value - The string to validate.
+     */
+    static parseUUID(value) {
+        const regex = /^({|()?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}(}|))?$/;
+        return !!value && value.length > 0 && regex.test(value);
+    }
+    /**
+     * Returns `true` when `value` is a valid, non-empty (non-zero) UUID.
+     * @param value - The string to validate.
+     */
+    static parseUUIDNotEmpty(value) {
+        const regex = /^({|()?0{8}-(0{4}-){3}0{12}(}|))?$/;
+        return this.parseUUID(value) && !regex.test(value ?? '');
+    }
+    /**
+     * Return an empty UUID
+     * @returns : the empty UUID
+     */
+    static emptyUUID() { return "00000000-0000-0000-0000-000000000000"; }
+    ;
+    /**
+     * Create a new UUID
+     * @returns : the string UUID
+     */
+    static generateUUID() {
+        if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+            return crypto.randomUUID();
+        }
+        // Fallback (non-secure contexts)
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            const v = c === 'x' ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
+    }
+    /**
+     * 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) {
+        const s = value.trim();
+        if (s.length !== 32)
+            return s;
+        return `${s.slice(0, 8)}-${s.slice(8, 12)}-${s.slice(12, 16)}-${s.slice(16, 20)}-${s.slice(20)}`;
+    }
+    /** Precompiled validation patterns. */
+    static { this.emailRegex = /^(?:[a-z0-9+!#$%&'*+\/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+\/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$/i; }
+    static { this.urlRegex = /^(https?:\/\/)?([\da-z.-]+)\.([a-z.]{2,6})([/\w .-]*)\/?$/i; }
+    /**
+     * 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) {
+        if (!value)
+            return true;
+        return this.emailRegex.test(value.trim().toLowerCase());
+    }
+    /**
+     * 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) {
+        if (!value || value.trim().length === 0)
+            return true;
+        const items = value
+            .split(/[;,]/)
+            .map(e => e.trim().toLowerCase())
+            .filter(e => e.length > 0);
+        if (items.length === 0)
+            return false; // only separators, no addresses
+        return items.every(e => this.emailRegex.test(e));
+    }
+    /**
+     * 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) {
+        if (!value)
+            return true;
+        return this.urlRegex.test(value.trim().toLowerCase());
+    }
+    /**
+     * 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) {
+        if (!value)
+            return undefined;
+        let parts = [];
+        if (value.indexOf("-") !== -1) {
+            const p = value.split("-");
+            if (p.length !== 3)
+                return undefined;
+            parts = [parseInt(p[0]), parseInt(p[1]) - 1, parseInt(p[2])];
+        }
+        else if (value.indexOf("/") !== -1) {
+            const p = value.split("/");
+            if (p.length !== 3)
+                return undefined;
+            parts = [parseInt(p[2]), parseInt(p[1]) - 1, parseInt(p[0])];
+        }
+        return parts;
+    }
+    /**
+     * 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, locale = it) {
+        // No value at all
+        if (!value)
+            return undefined;
+        // A Date value
+        if (value instanceof Date && value.getTime())
+            return value;
+        // Parse known formats using date-fns
+        let d = parseISO(value);
+        if (d && d.getTime() && d.getFullYear() > 1750)
+            return d;
+        d = parse(value, 'dd/MM/yyyy', new Date(), { locale: locale });
+        if (d && d.getTime() && d.getFullYear() > 1750)
+            return d;
+        d = parse(value, 'yyyy-MM-dd', new Date(), { locale: locale });
+        if (d && d.getTime() && d.getFullYear() > 1750)
+            return d;
+        // Parse values manually
+        const parts = this.getDateParts(value);
+        if (!parts)
+            return undefined;
+        if (parts[0] < 100)
+            parts[0] += 2000;
+        if (isNaN(parts[0]) || parts[0] < 0 || parts[0] < 1750)
+            return undefined;
+        if (isNaN(parts[1]) || parts[1] < 0)
+            return undefined;
+        if (isNaN(parts[2]) || parts[2] < 0)
+            return undefined;
+        if (parts[1] > 11)
+            return undefined;
+        if (parts[1] === 1 && parts[2] > 29)
+            return undefined;
+        else if (parts[1] !== 1 && parts[2] > 31)
+            return undefined;
+        return new TZDate(parts[0], parts[1], parts[2], 12);
+    }
+    /**
+     * 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, fmt = DateFormat.Short, locale = it) {
+        // No value at all
+        if (!value)
+            return '';
+        // A string
+        if (typeof value === 'string' || value instanceof String)
+            value = this.parseDate(value);
+        // Not a date
+        if (!(value instanceof Date && value.getTime()))
+            return '';
+        // Format
+        switch (fmt) {
+            case DateFormat.Short: return format(value, "dd/MM/yyyy", { locale: locale });
+            case DateFormat.Long: return format(value, "d MMMM yyyy", { locale: locale });
+            case DateFormat.LongWithShortMonth: return format(value, "d MMM yyyy", { locale: locale });
+            case DateFormat.LongWithWeekDay: return format(value, "EEEE, d MMMM yyyy", { locale: locale });
+            case DateFormat.LongWithShortWeekDay: return format(value, "EEE, d MMMM yyyy", { locale: locale });
+            case DateFormat.MonthAndYear: return format(value, "MMM yyyy", { locale: locale });
+            case DateFormat.LongMonthAndYear: return format(value, "MMMM yyyy", { locale: locale });
+            case DateFormat.WeekDay: return format(value, "EEE, d", { locale: locale });
+            case DateFormat.LongWeekDay: return format(value, "EEEE, d", { locale: locale });
+            case DateFormat.DayAndMonth: return format(value, "d MMMM", { locale: locale });
+            case DateFormat.ShortUS: return format(value, "MM/dd/yyyy", { locale: locale });
+            case DateFormat.ShortISO8601: return format(value, "yyyy-MM-dd", { locale: locale });
+            default:
+                return format(value, fmt, { locale: locale });
+        }
+    }
+    /**
+     * Return an italian local date
+     * @param value  : the date
+     * @returns     : the new date
+     */
+    static toLocalDate(value) {
+        // No value at all
+        if (!value)
+            return undefined;
+        // A string
+        if (typeof value === 'string' || value instanceof String)
+            value = this.parseDate(value);
+        // Not a date
+        if (!(value instanceof Date && value.getTime()))
+            return undefined;
+        // Update date
+        return new TZDate(value, "Europe/Rome");
+    }
+    /**
+     * 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, interval, end = false, copy = false) {
+        if (value) {
+            let year = -1;
+            if (value.length === 4 && (year = parseInt(value)) > 1750) {
+                if (!end) {
+                    interval.from = new TZDate(new Date(year, 0, 1), 'Europe/Rome');
+                    interval.to = new TZDate(new Date(year, 11, 31), 'Europe/Rome');
+                }
+                else
+                    interval.to = new Date(year, 11, 31);
+            }
+            else {
+                let parts = this.getDateParts(value);
+                if (!parts || isNaN(parts[0]) || parts[0] < 0 || parts[0] < 1750)
+                    return;
+                const d = new TZDate(new Date(parts[0], parts[1], parts[2]), 'Europe/Rome');
+                if (end)
+                    interval.to = d;
+                else if (copy) {
+                    interval.from = d;
+                    interval.to = d;
+                }
+                else
+                    interval.from = d;
+            }
+        }
+    }
+    /**
+     * 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, decimals = 2, locale = 'it-IT') {
+        return Intl.NumberFormat(locale, { style: 'decimal', minimumFractionDigits: 0, maximumFractionDigits: decimals }).format(value);
+    }
+    /**
+     * 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, currency = 'EUR', decimals = 2, locale = 'it-IT') {
+        return Intl.NumberFormat(locale, { style: 'currency', currency, minimumFractionDigits: 0, maximumFractionDigits: decimals }).format(value);
+    }
+    /**
+     * 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) {
+        return value.length > 0
+            ? encodeURIComponent(value)
+            : 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) {
+        return value && value.length > 0
+            ? decodeURIComponent(value.replace(/\+/g, '%20'))
+            : 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) {
+        if (!this.isBrowser())
+            return undefined;
+        const v = new URLSearchParams(window.location.search).get(name);
+        return v && v !== 'null' ? v : undefined;
+    }
+    /**
+     * Generate a password
+     * @returns : the password string
+     */
+    static generatePassword() {
+        const random = "$" + Math.random().toString(36).slice(-11);
+        let password = "";
+        let hasUpperCase = false;
+        for (const rnd of random) {
+            if (!hasUpperCase && "abcdefghjilmnopqrstuvywxz".includes(rnd)) {
+                password += rnd.toUpperCase();
+                hasUpperCase = true;
+            }
+            else {
+                password += rnd;
+            }
+        }
+        if (!hasUpperCase)
+            password = password.substring(0, 11) + "M";
+        return password;
+    }
+    /**
+     * Calculate password strength
+     * @param password: the password to evaluate
+     * @returns the password strength info
+     */
+    static calculatePasswordStrength(password) {
+        if (password && password.length > 0) {
+            let score = 0;
+            const suggestions = [];
+            // Length
+            if (password.length >= 10)
+                score++;
+            else
+                suggestions.push('Usa almeno 10 caratteri.');
+            if (password.length >= 12)
+                score++;
+            else if (password.length >= 10)
+                suggestions.push('Considera di usare più di 12 caratteri.');
+            // Lowercase letters
+            if (/[a-z]/.test(password))
+                score++;
+            else
+                suggestions.push('Aggiungi lettere minuscole.');
+            // Uppercase letters
+            if (/[A-Z]/.test(password))
+                score++;
+            else
+                suggestions.push('Aggiungi lettere maiuscole.');
+            // Numbers
+            if (/\d/.test(password))
+                score++;
+            else
+                suggestions.push('Aggiungi numeri.');
+            // Special characters
+            if (/[!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?]/.test(password))
+                score++;
+            else
+                suggestions.push('Aggiungi caratteri speciali (!@#$%^&*).');
+            // Common patterns
+            if (/(.)\1{2,}/.test(password)) {
+                score = Math.max(0, score - 1);
+                suggestions.push('Evita di ripetere lo stesso carattere.');
+            }
+            if (/123|abc|qwe/i.test(password)) {
+                score = Math.max(0, score - 1);
+                suggestions.push('Evita sequenze comuni (123, abc, qwe).');
+            }
+            // Label and color
+            let label;
+            let color;
+            let isValid;
+            if (score <= 2) {
+                label = 'Molto debole';
+                color = '#f44336';
+                isValid = false;
+            }
+            else if (score <= 3) {
+                label = 'Debole';
+                color = '#ff9800';
+                isValid = false;
+            }
+            else if (score <= 4) {
+                label = 'Media';
+                color = '#ffc107';
+                isValid = true;
+            }
+            else if (score <= 5) {
+                label = 'Forte';
+                color = '#8bc34a';
+                isValid = true;
+            }
+            else {
+                label = 'Molto forte';
+                color = '#4caf50';
+                isValid = true;
+            }
+            return { score, label, color, suggestions, isValid };
+        }
+        else
+            return {
+                score: 0,
+                isValid: false,
+                suggestions: []
+            };
+    }
+    /**
+     * Check if current browser supports touch
+     * @returns : true if the display is touchable
+     */
+    static isTouchable() {
+        return (this.isBrowser() && ("ontouchstart" in window ||
+            navigator.maxTouchPoints > 0));
+    }
+    /**
+     * This check will prevent 'window' logic to be executed
+     * while executing the server rendering
+     * @returns : true if using the browser
+     */
+    static isBrowser() {
+        return typeof (window) !== 'undefined';
+    }
+    /**
+     * Convert folders in a tree of Node object.
+     * @param folders : the subfolders group or null to root
+     * @returns       : a node list
+     */
+    static toNodes(folders) {
+        return this._toNodes(folders, undefined);
+    }
+    /**
+     * 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
+     */
+    static _toNodes(folders, parent) {
+        const nodes = [];
+        folders.forEach((n) => {
+            const node = {
+                id: n.id,
+                name: n.name,
+                count: n.count,
+                parent: parent,
+                children: undefined,
+                bag: n,
+            };
+            const children = n.children ?? n.subFolders ?? [];
+            if (children.length > 0) {
+                node.children = this._toNodes(children, node);
+            }
+            nodes.push(node);
+        });
+        return nodes;
+    }
+    /**
+     * 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, max = 30) {
+        if (value !== 0) {
+            const items = [];
+            let v = 1;
+            const m = 1 << max;
+            while (v < m) {
+                if ((value & v) === v)
+                    items.push(v);
+                v = v << 1;
+            }
+            return items;
+        }
+        else
+            return [];
+    }
+    /** Cache for resolved color luminance results. */
+    static { this.colorLightCache = new Map(); }
+    /**
+     * 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, minimumLuminance = 186) {
+        if (!this.isBrowser())
+            return true; // SSR fallback
+        const cacheKey = `${color}|${minimumLuminance}`;
+        const cached = this.colorLightCache.get(cacheKey);
+        if (cached !== undefined)
+            return cached;
+        const tempDiv = document.createElement('div');
+        tempDiv.style.color = color;
+        document.body.appendChild(tempDiv);
+        const rgb = getComputedStyle(tempDiv).color;
+        document.body.removeChild(tempDiv);
+        const result = rgb.match(/\d+/g);
+        let light = true; // fallback
+        if (result && result.length >= 3) {
+            const r = parseInt(result[0], 10);
+            const g = parseInt(result[1], 10);
+            const b = parseInt(result[2], 10);
+            light = (0.299 * r + 0.587 * g + 0.114 * b) > minimumLuminance;
+        }
+        this.colorLightCache.set(cacheKey, light);
+        return light;
+    }
+}
+
+/**
+ * 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' }}`
+ */
+class FormatPipe {
+    /**
+     * 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, type = 'date', pattern = 'dd/MM/yyyy') {
+        if (value === undefined || value === null)
+            return undefined;
+        switch (type) {
+            case 'D':
+            case 'date': {
+                const d = SystemUtils.parseDate(value, it);
+                if (d)
+                    return format(d, pattern, { locale: it });
+                break;
+            }
+            case 'C':
+            case 'currency':
+                return new Intl.NumberFormat('it-IT', { style: 'currency', currency: 'EUR' }).format(value);
+            case 'N':
+            case 'number':
+                return new Intl.NumberFormat('it-IT', { style: 'decimal', minimumFractionDigits: 0, maximumFractionDigits: 2 }).format(value);
+            case 'N0':
+            case 'number0':
+                return new Intl.NumberFormat('it-IT', { style: 'decimal', minimumFractionDigits: 0, maximumFractionDigits: 0 }).format(value);
+            case 'P':
+            case 'percentage':
+                return new Intl.NumberFormat('it-IT', { style: 'percent', minimumFractionDigits: 0, maximumFractionDigits: 0 }).format(value);
+        }
+        return undefined;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: FormatPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "22.0.1", ngImport: i0, type: FormatPipe, isStandalone: true, name: "format" }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: FormatPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'format',
+                    standalone: 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':'' }}`
+ */
+class ReplacePipe {
+    constructor() {
+        this.sanitizer = inject(DomSanitizer);
+    }
+    /**
+     * 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, regexValue, replaceValue) {
+        if (!value)
+            return undefined;
+        const replacement = (regexValue === '\n' && !replaceValue) ? '<br>' : replaceValue;
+        return this.sanitizer.bypassSecurityTrustHtml(value.replace(new RegExp(regexValue, 'g'), replacement));
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ReplacePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "22.0.1", ngImport: i0, type: ReplacePipe, isStandalone: true, name: "replace" }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ReplacePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'replace',
+                    standalone: 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>`
+ */
+class SafeHtmlPipe {
+    constructor() {
+        this.sanitizer = inject(DomSanitizer);
+    }
+    /**
+     * 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) {
+        return this.sanitizer.bypassSecurityTrustHtml(value ?? '');
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SafeHtmlPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "22.0.1", ngImport: i0, type: SafeHtmlPipe, isStandalone: true, name: "safeHtml" }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SafeHtmlPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'safeHtml',
+                    standalone: 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>`
+ */
+class SafeUrlPipe {
+    constructor() {
+        this.sanitizer = inject(DomSanitizer);
+    }
+    /**
+     * 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) {
+        return this.sanitizer.bypassSecurityTrustResourceUrl(value ?? '');
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SafeUrlPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "22.0.1", ngImport: i0, type: SafeUrlPipe, isStandalone: true, name: "safeUrl" }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SafeUrlPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'safeUrl',
+                    standalone: 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"`
+ */
+class SearchCallbackPipe {
+    /**
+     * 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(items, callback) {
+        if (!items || !callback)
+            return items;
+        return items.filter(item => callback(item));
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SearchCallbackPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "22.0.1", ngImport: i0, type: SearchCallbackPipe, isStandalone: true, name: "callback", pure: false }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SearchCallbackPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'callback',
+                    pure: false,
+                    standalone: 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>
+ * ```
+ */
+class SearchFilterPipe {
+    /**
+     * 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, value, metadata) {
+        metadata ??= { total: 0, count: 0 };
+        if (!items || !value)
+            return items;
+        const query = value.toLowerCase();
+        const result = items.filter(item => {
+            if (!item)
+                return false;
+            const text = item.searchBag?.name ?? (typeof item === 'string' ? item : undefined);
+            return text?.toLowerCase().includes(query) ?? false;
+        });
+        metadata.total = items.length;
+        metadata.count = result.length;
+        return result;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SearchFilterPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "22.0.1", ngImport: i0, type: SearchFilterPipe, isStandalone: true, name: "search" }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SearchFilterPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'search',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * 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 }}`
+ */
+class FormatHtmlPipe {
+    constructor() {
+        this.sanitizer = inject(DomSanitizer);
+    }
+    /**
+     * 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) {
+        return this.sanitizer.bypassSecurityTrustHtml((value ?? '').replaceAll(/(?:\r\n|\r|\n)/g, '<br>'));
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: FormatHtmlPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "22.0.1", ngImport: i0, type: FormatHtmlPipe, isStandalone: true, name: "formatHtml" }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: FormatHtmlPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'formatHtml',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * 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()]
+ * });
+ */
+function provideSCMCore() {
+    return makeEnvironmentProviders([
+        SearchFilterPipe,
+        SearchCallbackPipe,
+        SafeHtmlPipe,
+        SafeUrlPipe,
+        ReplacePipe,
+        FormatPipe,
+        FormatHtmlPipe
+    ]);
+}
+
+/**
+ * Creates an array of the given length, filling each slot with the result of `valueFunction`.
+ * @param length        - Number of elements to create.
+ * @param valueFunction - Factory called with each index to produce the element value.
+ * @returns Typed array of `length` elements.
+ */
+function range(length, valueFunction) {
+    const valuesArray = Array(length);
+    for (let i = 0; i < length; i++) {
+        valuesArray[i] = valueFunction(i);
+    }
+    return valuesArray;
+}
+// date-fns doesn't have a way to read/print month names or days of the week directly,
+// so we get them by formatting a date with a format that produces the desired month/day.
+const MONTH_FORMATS = {
+    long: 'LLLL',
+    short: 'LLL',
+    narrow: 'LLLLL',
+};
+const DAY_OF_WEEK_FORMATS = {
+    long: 'EEEE',
+    short: 'EEE',
+    narrow: 'EEEEE',
+};
+const MAT_DATE_FNS_FORMATS = {
+    parse: {
+        dateInput: 'P',
+    },
+    display: {
+        dateInput: 'P',
+        monthYearLabel: 'LLL uuuu',
+        dateA11yLabel: 'PP',
+        monthYearA11yLabel: 'LLLL uuuu',
+    },
+};
+/**
+ * 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.
+ */
+class DateFnsAdapter extends DateAdapter {
+    constructor() {
+        super();
+        const matDateLocale = inject(MAT_DATE_LOCALE, { optional: true });
+        if (matDateLocale) {
+            this.setLocale(matDateLocale);
+        }
+    }
+    /**
+     * Returns the year component of the given date.
+     * @param date - The source date.
+     */
+    getYear(date) {
+        return getYear(date);
+    }
+    /**
+     * Returns the zero-based month index of the given date (0 = January).
+     * @param date - The source date.
+     */
+    getMonth(date) {
+        return getMonth(date);
+    }
+    /**
+     * Returns the day-of-month of the given date (1-based).
+     * @param date - The source date.
+     */
+    getDate(date) {
+        return getDate(date);
+    }
+    /**
+     * Returns the day-of-week of the given date (0 = Sunday).
+     * @param date - The source date.
+     */
+    getDayOfWeek(date) {
+        return getDay(date);
+    }
+    /**
+     * Returns an array of 12 month name strings formatted for the active locale.
+     * @param style - One of `'long'`, `'short'`, or `'narrow'`.
+     */
+    getMonthNames(style) {
+        const pattern = MONTH_FORMATS[style];
+        return range(12, i => this.format(new Date(2017, i, 1), pattern));
+    }
+    /**
+     * Returns an array of 31 day-of-month label strings formatted using `Intl.DateTimeFormat`
+     * when available, falling back to plain numeric strings.
+     */
+    getDateNames() {
+        const dtf = typeof Intl !== 'undefined'
+            ? new Intl.DateTimeFormat(this.locale?.code, {
+                day: 'numeric',
+                timeZone: 'utc',
+            })
+            : null;
+        return range(31, i => {
+            if (dtf) {
+                // date-fns doesn't appear to support this functionality.
+                // Fall back to `Intl` on supported browsers.
+                const date = new Date();
+                date.setUTCFullYear(2017, 0, i + 1);
+                date.setUTCHours(0, 0, 0, 0);
+                return dtf.format(date).replace(/[\u200e\u200f]/g, '');
+            }
+            return String(i + 1);
+        });
+    }
+    /**
+     * 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) {
+        const pattern = DAY_OF_WEEK_FORMATS[style];
+        return range(7, i => this.format(new Date(2017, 0, i + 1), pattern));
+    }
+    /**
+     * Returns the four-digit year string for the given date.
+     * @param date - The source date.
+     */
+    getYearName(date) {
+        return this.format(date, 'y');
+    }
+    /**
+     * Returns the first day of the week for the active locale (0 = Sunday, 1 = Monday, …).
+     */
+    getFirstDayOfWeek() {
+        return this.locale?.options?.weekStartsOn ?? 0;
+    }
+    /**
+     * Returns the number of days in the month of the given date.
+     * @param date - The source date.
+     */
+    getNumDaysInMonth(date) {
+        return getDaysInMonth(date);
+    }
+    /**
+     * Creates an independent copy of the given date.
+     * @param date - The date to clone.
+     */
+    clone(date) {
+        return new Date(date.getTime());
+    }
+    /**
+     * 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, month, date) {
+        if (month < 0 || month > 11) {
+            throw Error(`Invalid month index "${month}". Month index has to be between 0 and 11.`);
+        }
+        if (date < 1) {
+            throw Error(`Invalid date "${date}". Date has to be greater than 0.`);
+        }
+        // Passing the year to the constructor causes year numbers <100 to be converted to 19xx.
+        // To work around this we use `setFullYear` and `setHours` instead.
+        const result = new Date();
+        result.setFullYear(year, month, date);
+        result.setHours(0, 0, 0, 0);
+        const result2 = new TZDate(result, 'Europe/Rome');
+        if (result2.getMonth() !== month) {
+            throw Error(`Invalid date "${date}" for month with index "${month}".`);
+        }
+        return result2;
+    }
+    /**
+     * Returns today's date in the local timezone.
+     */
+    today() {
+        return new 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, parseFormat) {
+        if (typeof value === 'string' && value.length > 0) {
+            const iso8601Date = parseISO(value);
+            if (this.isValid(iso8601Date)) {
+                return new TZDate(iso8601Date, 'Europe/Rome');
+            }
+            const formats = Array.isArray(parseFormat) ? parseFormat : [parseFormat];
+            if (!formats.length) {
+                throw Error('Formats array must not be empty.');
+            }
+            for (const currentFormat of formats) {
+                const fromFormat = parse(value, currentFormat, new Date(), { locale: this.locale });
+                if (this.isValid(fromFormat)) {
+                    return new TZDate(fromFormat, 'Europe/Rome');
+                }
+            }
+            return this.invalid();
+        }
+        else if (typeof value === 'number') {
+            return new Date(value);
+        }
+        else if (value instanceof Date) {
+            return this.clone(value);
+        }
+        return 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, displayFormat) {
+        if (!this.isValid(date)) {
+            throw Error('DateFnsAdapter: Cannot format invalid date.');
+        }
+        return format(date, displayFormat, { locale: this.locale });
+    }
+    /**
+     * 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, years) {
+        return addYears(date, years);
+    }
+    /**
+     * 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, months) {
+        return addMonths(date, months);
+    }
+    /**
+     * 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, days) {
+        return addDays(date, days);
+    }
+    /**
+     * Serialises a date to an ISO 8601 date string (`yyyy-MM-dd`).
+     * @param date - The date to serialise.
+     */
+    toIso8601(date) {
+        return formatISO(date, { representation: 'date' });
+    }
+    /**
+     * 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) {
+        if (typeof value === 'string') {
+            if (!value) {
+                return null;
+            }
+            const date = parseISO(value);
+            if (this.isValid(date)) {
+                return date;
+            }
+        }
+        return super.deserialize(value);
+    }
+    /**
+     * Returns `true` when `obj` is an instance of `Date`.
+     * @param obj - The object to test.
+     */
+    isDateInstance(obj) {
+        return isDate(obj);
+    }
+    /**
+     * Returns `true` when `date` represents a valid point in time.
+     * @param date - The date to validate.
+     */
+    isValid(date) {
+        return isValid(date);
+    }
+    /**
+     * Returns a sentinel `Date` that represents an invalid date (`new Date(NaN)`).
+     */
+    invalid() {
+        return new Date(NaN);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: DateFnsAdapter, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: DateFnsAdapter }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: DateFnsAdapter, decorators: [{
+            type: Injectable
+        }], ctorParameters: () => [] });
+/**
+ * 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()]
+ * });
+ */
+function provideSCMDateFns() {
+    return makeEnvironmentProviders([
+        {
+            provide: DateAdapter,
+            useClass: DateFnsAdapter,
+            deps: [MAT_DATE_LOCALE],
+        },
+        { provide: MAT_DATE_FORMATS, useValue: MAT_DATE_FNS_FORMATS }
+    ]);
+}
+
+/**
+ * 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.
+ */
+class AutoFocusDirective {
+    constructor() {
+        this.elementRef = inject(ElementRef);
+        afterNextRender(() => {
+            this.elementRef.nativeElement?.focus();
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: AutoFocusDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: AutoFocusDirective, isStandalone: true, selector: "[autoFocus]", ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: AutoFocusDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[autoFocus]',
+                    standalone: true
+                }]
+        }], ctorParameters: () => [] });
+
+class FileInfo {
+    isValid() {
+        return this.valid;
+    }
+}
+class ValueModel {
+}
+class IDModel {
+}
+class GroupModel {
+}
+class DeleteModel extends GroupModel {
+}
+class RelationModel {
+}
+class UpdateRelationsModel {
+}
+class QueryModel {
+}
+class ImportModel {
+}
+class DateInterval {
+    get fromAsDate() {
+        if (this.from) {
+            if (!(this.from instanceof Date)) {
+                this.from = new Date(this.from);
+            }
+            if (this.from) {
+                return new Date(this.from.getFullYear(), this.from.getMonth(), this.from.getDate(), 2, 0, 0);
+            }
+        }
+        return undefined;
+    }
+    get toAsDate() {
+        if (this.to) {
+            if (!(this.to instanceof Date)) {
+                this.to = new Date(this.to);
+            }
+            if (this.to) {
+                return new Date(this.to.getFullYear(), this.to.getMonth(), this.to.getDate(), 2, 0, 0);
+            }
+        }
+        return undefined;
+    }
+    constructor(from, to) {
+        this.from = from;
+        this.to = to;
+    }
+    clear() {
+        this.from = undefined;
+        this.to = undefined;
+    }
+}
+
+/**
+ * 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.
+ */
+class DateIntervalChangeDirective {
+    constructor() {
+        /** The date interval model to update when the input value changes. */
+        this.dateIntervalChange = input(new DateInterval(null, null), /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "dateIntervalChange" }] : /* istanbul ignore next */ []));
+        /** When `true`, the directive updates the interval's end date; otherwise the start date. */
+        this.end = input(false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "end" }] : /* istanbul ignore next */ []));
+        this.subject = new Subject();
+        this.destroyRef = inject(DestroyRef);
+        this.subject
+            .pipe(debounceTime(100), takeUntilDestroyed(this.destroyRef))
+            .subscribe((e) => {
+            const value = e.target?.value;
+            if (value !== undefined) {
+                SystemUtils.changeDateInterval(value, this.dateIntervalChange(), this.end(), e.key === ' ');
+            }
+        });
+    }
+    /**
+     * 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) {
+        if (e.key === ' ') {
+            e.preventDefault();
+            e.stopPropagation();
+        }
+        this.subject.next(e);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: DateIntervalChangeDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: DateIntervalChangeDirective, isStandalone: true, selector: "[dateIntervalChange]", inputs: { dateIntervalChange: { classPropertyName: "dateIntervalChange", publicName: "dateIntervalChange", isSignal: true, isRequired: false, transformFunction: null }, end: { classPropertyName: "end", publicName: "end", isSignal: true, isRequired: false, transformFunction: null } }, host: { listeners: { "keyup": "onKeyup($event)" } }, ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: DateIntervalChangeDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[dateIntervalChange]',
+                    standalone: true,
+                }]
+        }], ctorParameters: () => [], propDecorators: { dateIntervalChange: [{ type: i0.Input, args: [{ isSignal: true, alias: "dateIntervalChange", required: false }] }], end: [{ type: i0.Input, args: [{ isSignal: true, alias: "end", required: false }] }], onKeyup: [{
+                type: HostListener,
+                args: ['keyup', ['$event']]
+            }] } });
+
+/**
+ * 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.
+ */
+class CopyClipboardDirective {
+    constructor() {
+        /** The text to copy to the clipboard. Bound via the `copyClipboard` attribute. */
+        this.payload = input(undefined, { ...(ngDevMode ? { debugName: "payload" } : /* istanbul ignore next */ {}), alias: 'copyClipboard' });
+        /** Emits the copied text after a successful copy operation. */
+        this.copied = output({ alias: 'copied' });
+    }
+    /**
+     * 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) {
+        e.preventDefault();
+        const payload = this.payload();
+        if (!payload)
+            return;
+        if (SystemUtils.isBrowser()) {
+            const listener = (clipEvent) => {
+                clipEvent.clipboardData?.setData('text/html', payload);
+                clipEvent.preventDefault();
+                this.copied.emit(payload);
+            };
+            document.addEventListener('copy', listener, false);
+            document.execCommand('copy');
+            document.removeEventListener('copy', listener, false);
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: CopyClipboardDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: CopyClipboardDirective, isStandalone: true, selector: "[copyClipboard]", inputs: { payload: { classPropertyName: "payload", publicName: "copyClipboard", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { copied: "copied" }, host: { listeners: { "click": "onClick($event)" } }, ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: CopyClipboardDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[copyClipboard]',
+                    standalone: true
+                }]
+        }], propDecorators: { payload: [{ type: i0.Input, args: [{ isSignal: true, alias: "copyClipboard", required: false }] }], copied: [{ type: i0.Output, args: ["copied"] }], onClick: [{
+                type: HostListener,
+                args: ['click', ['$event']]
+            }] } });
+
+/**
+ * Directive that validates a semicolon-separated list of email addresses.
+ * Apply `emails` to a text input containing one or more addresses separated by `;`.
+ */
+class EmailsValidatorDirective {
+    /**
+     * 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) {
+        const input = control.value;
+        if (!input || input.length === 0)
+            return null;
+        const parts = input.replaceAll(/\r\n/g, '').split(';');
+        const isValid = parts.every(part => part.length === 0 || !!SystemUtils.parseEmail(part));
+        return isValid ? null : { emails: "Elenco non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: EmailsValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: EmailsValidatorDirective, isStandalone: true, selector: "[emails]", providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => EmailsValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: EmailsValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[emails]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => EmailsValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * Directive that validates that the host control's value equals the value of another control.
+ * Bind `[equals]="otherControl"`.
+ */
+class EqualsValidatorDirective {
+    constructor() {
+        /** The control whose value must match the host control's value. */
+        this.equals = input(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "equals" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * 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) {
+        const eq = this.equals();
+        if (!eq)
+            return null;
+        return eq.value === control.value ? null : { equals: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: EqualsValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: EqualsValidatorDirective, isStandalone: true, selector: "[equals]", inputs: { equals: { classPropertyName: "equals", publicName: "equals", isSignal: true, isRequired: false, transformFunction: null } }, providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => EqualsValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: EqualsValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[equals]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => EqualsValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }], propDecorators: { equals: [{ type: i0.Input, args: [{ isSignal: true, alias: "equals", required: false }] }] } });
+
+/**
+ * Directive that validates a file size against configurable minimum and maximum bounds.
+ * Bind `[fileSize]` together with `[size]="fileSizeInMb"`, `[maxSizeMb]`, and `[minSizeMb]`.
+ */
+class FileSizeValidatorDirective {
+    constructor() {
+        /** Maximum allowed file size in megabytes. Defaults to 5. */
+        this.maxSizeMb = input(5, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "maxSizeMb" }] : /* istanbul ignore next */ []));
+        /** Minimum required file size in megabytes. Defaults to 0. */
+        this.minSizeMb = input(0, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "minSizeMb" }] : /* istanbul ignore next */ []));
+        /** The actual file size in megabytes to validate against the bounds. */
+        this.size = input(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * 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) {
+        const input = control.value;
+        if (!input)
+            return null;
+        const s = this.size() ?? 0;
+        const isValid = s <= this.maxSizeMb() && s >= this.minSizeMb();
+        return isValid ? null : { fileSize: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: FileSizeValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: FileSizeValidatorDirective, isStandalone: true, selector: "[fileSize]", inputs: { maxSizeMb: { classPropertyName: "maxSizeMb", publicName: "maxSizeMb", isSignal: true, isRequired: false, transformFunction: null }, minSizeMb: { classPropertyName: "minSizeMb", publicName: "minSizeMb", isSignal: true, isRequired: false, transformFunction: null }, size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null } }, providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => FileSizeValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: FileSizeValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[fileSize]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => FileSizeValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }], propDecorators: { maxSizeMb: [{ type: i0.Input, args: [{ isSignal: true, alias: "maxSizeMb", required: false }] }], minSizeMb: [{ type: i0.Input, args: [{ isSignal: true, alias: "minSizeMb", required: false }] }], size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }] } });
+
+/**
+ * Directive that validates a control value as a GUID / UUID string.
+ * Apply `guid` to a text input that expects a valid UUID.
+ */
+class GuidValidatorDirective {
+    /**
+     * 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) {
+        const input = control.value;
+        if (!input || input.length === 0)
+            return null;
+        return SystemUtils.parseUUID(input) ? null : { guid: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: GuidValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: GuidValidatorDirective, isStandalone: true, selector: "[guid]", providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => GuidValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: GuidValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[guid]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => GuidValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * 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.
+ */
+class MaxTermsValidatorDirective {
+    constructor() {
+        /** The maximum number of whitespace-separated terms allowed. */
+        this.maxTerms = input(0, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "maxTerms" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * 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) {
+        const input = control.value;
+        if (!input)
+            return null;
+        const terms = input.match(/\S+/g)?.length ?? 0;
+        return terms <= this.maxTerms() ? null : { maxTerms: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: MaxTermsValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: MaxTermsValidatorDirective, isStandalone: true, selector: "[maxTerms]", inputs: { maxTerms: { classPropertyName: "maxTerms", publicName: "maxTerms", isSignal: true, isRequired: false, transformFunction: null } }, providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => MaxTermsValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: MaxTermsValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[maxTerms]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => MaxTermsValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }], propDecorators: { maxTerms: [{ type: i0.Input, args: [{ isSignal: true, alias: "maxTerms", required: false }] }] } });
+
+/**
+ * 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.
+ */
+class NotEmptyValidatorDirective {
+    /**
+     * 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) {
+        const input = control?.value;
+        if (!input || typeof input !== 'string' || input.length === 0)
+            return null;
+        return input.trim().length > 0 ? null : { notEmpty: true };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: NotEmptyValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: NotEmptyValidatorDirective, isStandalone: true, selector: "[notEmpty]", providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => NotEmptyValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: NotEmptyValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[notEmpty]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => NotEmptyValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * Directive that validates that the host control's value is different from another control's value.
+ * Bind `[notEqual]="otherControl"`.
+ */
+class NotEqualValidatorDirective {
+    constructor() {
+        /** The control whose value must differ from the host control's value. */
+        this.notEqual = input(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "notEqual" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * 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) {
+        const notEqual = this.notEqual();
+        if (!notEqual)
+            return null;
+        const isValid = (!notEqual.value && !control.value) || (notEqual.value !== control.value);
+        const errors = isValid ? null : { notequal: true };
+        if (errors) {
+            control.markAsTouched();
+        }
+        else if (notEqual.hasError('notequal')) {
+            notEqual.setErrors({ notequal: null });
+            notEqual.updateValueAndValidity({ onlySelf: true, emitEvent: false });
+            notEqual.markAsTouched();
+            notEqual.markAsDirty();
+        }
+        return errors;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: NotEqualValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: NotEqualValidatorDirective, isStandalone: true, selector: "[notEqual]", inputs: { notEqual: { classPropertyName: "notEqual", publicName: "notEqual", isSignal: true, isRequired: false, transformFunction: null } }, providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => NotEqualValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: NotEqualValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[notEqual]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => NotEqualValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }], propDecorators: { notEqual: [{ type: i0.Input, args: [{ isSignal: true, alias: "notEqual", required: false }] }] } });
+
+/**
+ * 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.
+ */
+class NotFutureValidatorDirective {
+    /**
+     * 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) {
+        const input = control.value;
+        if (!input || input.length === 0)
+            return null;
+        const today = endOfDay(new Date());
+        const d = endOfDay(SystemUtils.parseDate(input));
+        return d <= today ? null : { notFuture: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: NotFutureValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: NotFutureValidatorDirective, isStandalone: true, selector: "[notFuture]", providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => NotFutureValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: NotFutureValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[notFuture]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => NotFutureValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * Directive that validates a control value as a sufficiently strong password.
+ * Apply `password` to a password input.
+ */
+class PasswordValidatorDirective {
+    /**
+     * Validates that the control value meets the minimum password-strength requirements.
+     * @param control - The form control to validate.
+     */
+    validate(control) {
+        const input = control.value ?? '';
+        const strength = SystemUtils.calculatePasswordStrength(input);
+        return strength.isValid ? null : { password: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: PasswordValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: PasswordValidatorDirective, isStandalone: true, selector: "[password]", providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => PasswordValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: PasswordValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[password]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => PasswordValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * 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).
+ */
+class RemoveFocusDirective {
+    constructor() {
+        this.elementRef = inject(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() {
+        const el = this.elementRef.nativeElement;
+        if (el && typeof el.blur === 'function') {
+            setTimeout(() => el.blur(), 0);
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: RemoveFocusDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: RemoveFocusDirective, isStandalone: true, selector: "[removeFocus]", host: { listeners: { "click": "onClick()" } }, ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: RemoveFocusDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[removeFocus]',
+                    standalone: true
+                }]
+        }], propDecorators: { onClick: [{
+                type: HostListener,
+                args: ['click']
+            }] } });
+
+/**
+ * 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.
+ */
+class SqlDateValidatorDirective {
+    /**
+     * 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) {
+        const input = control.value;
+        if (!input || input.length === 0)
+            return null;
+        const d = endOfDay(SystemUtils.parseDate(input));
+        return d.getFullYear() > 1750 ? null : { sqlDate: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SqlDateValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: SqlDateValidatorDirective, isStandalone: true, selector: "[sqlDate]", providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => SqlDateValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: SqlDateValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[sqlDate]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => SqlDateValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * 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).
+ */
+class TimeValidatorDirective {
+    constructor() {
+        /** Optional pipe-separated list of allowed time ranges, e.g. `"08:00-12:00|14:00-18:00"`. */
+        this.slots = input(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "slots" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * 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.
+     */
+    getTime(value) {
+        const p = value.split(':');
+        if (p.length !== 2)
+            return -1;
+        const hh = parseInt(p[0]);
+        if (hh < 0 || hh > 23)
+            return -1;
+        const mm = parseInt(p[1]);
+        if (mm < 0 || mm > 59)
+            return -1;
+        return parseInt(p[0] + p[1]);
+    }
+    /**
+     * 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) {
+        const input = control.value;
+        if (!input || input.length === 0)
+            return null;
+        const t = this.getTime(input);
+        if (t === -1)
+            return { time: "Non valido." };
+        const slotsValue = this.slots();
+        if (slotsValue) {
+            const isValid = slotsValue.split('|').some(s => {
+                const t1 = this.getTime(s.substring(0, 5));
+                const t2 = this.getTime(s.substring(6));
+                return t1 !== -1 && t2 !== -1 && t1 <= t && t2 >= t;
+            });
+            return isValid ? null : { time: "Non valido." };
+        }
+        return null;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: TimeValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: TimeValidatorDirective, isStandalone: true, selector: "[time]", inputs: { slots: { classPropertyName: "slots", publicName: "slots", isSignal: true, isRequired: false, transformFunction: null } }, providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => TimeValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: TimeValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[time]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => TimeValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }], propDecorators: { slots: [{ type: i0.Input, args: [{ isSignal: true, alias: "slots", required: false }] }] } });
+
+/**
+ * Directive that validates a control value as a well-formed URL.
+ * Apply `url` to a text input that expects a URL.
+ */
+class UrlValidatorDirective {
+    /**
+     * 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) {
+        const input = control.value;
+        if (!input || input.length === 0)
+            return null;
+        return SystemUtils.parseUrl(input) ? null : { url: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: UrlValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.1", type: UrlValidatorDirective, isStandalone: true, selector: "[url]", providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => UrlValidatorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: UrlValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[url]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => UrlValidatorDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * Directive that validates a control using the host object's `isValid()` method
+ * or a boolean expression passed via `[validIf]`.
+ */
+class ValidIfDirective {
+    constructor() {
+        /** When `true`, the control is considered valid regardless of the bound value. */
+        this.validIf = input(false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "validIf" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * Validates the control value against a boolean flag or the value's own `isValid()` method.
+     * @param control - The form control to validate.
+     */
+    validate(control) {
+        let isValid = false;
+        const c = control.value ? control.value : null;
+        if (!c) {
+            isValid = this.validIf() === true;
+        }
+        else {
+            try {
+                isValid = c.isValid();
+            }
+            catch { }
+        }
+        return isValid ? null : { validIf: "Non valido." };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ValidIfDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: ValidIfDirective, isStandalone: true, selector: "[validIf]", inputs: { validIf: { classPropertyName: "validIf", publicName: "validIf", isSignal: true, isRequired: false, transformFunction: null } }, providers: [
+            {
+                provide: NG_VALIDATORS,
+                useExisting: forwardRef(() => ValidIfDirective),
+                multi: true,
+            },
+        ], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ValidIfDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: "[validIf]",
+                    providers: [
+                        {
+                            provide: NG_VALIDATORS,
+                            useExisting: forwardRef(() => ValidIfDirective),
+                            multi: true,
+                        },
+                    ],
+                    standalone: true,
+                }]
+        }], propDecorators: { validIf: [{ type: i0.Input, args: [{ isSignal: true, alias: "validIf", required: false }] }] } });
+
+/**
+ * Directive that delegates validation to an externally provided validator function.
+ * Bind `[validator]="myFn"` where `myFn` is `(c: AbstractControl) => ValidationErrors | null`.
+ */
+class ValidatorDirective {
+    constructor() {
+        /** The custom validator function to apply. */
+        this.validator = input(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "validator" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * 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) {
+        const fn = this.validator();
+        return fn ? fn(control) : null;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ValidatorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.1", type: ValidatorDirective, isStandalone: true, selector: "[validator]", inputs: { validator: { classPropertyName: "validator", publicName: "validator", isSignal: true, isRequired: false, transformFunction: null } }, providers: [{ provide: NG_VALIDATORS, useExisting: ValidatorDirective, multi: true }], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ValidatorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[validator]',
+                    providers: [{ provide: NG_VALIDATORS, useExisting: ValidatorDirective, multi: true }],
+                    standalone: true,
+                }]
+        }], propDecorators: { validator: [{ type: i0.Input, args: [{ isSignal: true, alias: "validator", required: false }] }] } });
+
+/**
+ * Pipe that converts a Markdown string to sanitized HTML using `SystemUtils.markdownToHtml`.
+ *
+ * Usage: `{{ text | formatMarkdown }}`
+ */
+class FormatMarkdownPipe {
+    constructor() {
+        this.sanitizer = inject(DomSanitizer);
+    }
+    /**
+     * 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) {
+        return this.sanitizer.bypassSecurityTrustHtml(SystemUtils.markdownToHtml(value ?? ''));
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: FormatMarkdownPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "22.0.1", ngImport: i0, type: FormatMarkdownPipe, isStandalone: true, name: "formatMarkdown" }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: FormatMarkdownPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'formatMarkdown',
+                    standalone: true
+                }]
+        }] });
+
+const Breakpoints = {
+    XXSmall: '(max-width: 349.98px)',
+    XSmall: '(max-width: 599.98px)',
+    Small: '(min-width: 600px) and (max-width: 959.98px)',
+    SmallMedium: '(min-width: 600px) and (max-width: 1059.98px)',
+    Medium: '(min-width: 960px) and (max-width: 1279.98px)',
+    MediumLarge: '(min-width: 960px) and (max-width: 1459.98px)',
+    Large: '(min-width: 1460px) and (max-width: 1919.98px)'
+};
+
+const UtilsMessages = {
+    /**
+     * Messages
+     */
+    // Select dialog
+    UTILS_DIALOGS_SELECT_OPTIONS_CHANGED: '§utils-dialogs-select-options-changed'
+};
+
+/**
+ * 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.
+ */
+class SelectableModel {
+    /**
+     * 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() {
+        return this._all();
+    }
+    /** The underlying CDK `SelectionModel` (provides `.selected`, `.isSelected`, etc.). */
+    get current() {
+        return this._current;
+    }
+    /**
+     * @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 = true, lookupFieldName = 'id') {
+        /**
+         * Emits whenever the selection changes.
+         * Carries the affected item, or `undefined` when the whole selection is cleared.
+         */
+        this.changed = new EventEmitter();
+        this._all = signal([], /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "_all" }] : /* istanbul ignore next */ []));
+        /** Signal that is `true` when at least one item is selected. */
+        this.hasValue = computed(() => this._all().length > 0, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "hasValue" }] : /* istanbul ignore next */ []));
+        this._current = new SelectionModel(allowMultiSelect, []);
+        this._lookupFieldName = lookupFieldName;
+    }
+    /**
+     * 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, lookupValue) {
+        const p = SystemUtils.arrayFindIndexByKey(this._all(), this._lookupFieldName, lookupValue);
+        if (p !== -1) {
+            this._current.toggle(item);
+            this.changed.emit(item);
+        }
+    }
+    /**
+     * 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, lookupValue) {
+        if (lookupValue === undefined)
+            return;
+        const p = SystemUtils.arrayFindIndexByKey(this._all(), this._lookupFieldName, lookupValue);
+        if (p === -1) {
+            this._all.update(arr => [...arr, item]);
+        }
+        else {
+            this._all.update(arr => arr.filter((_, i) => i !== p));
+        }
+        this._current.toggle(item);
+        this.changed.emit(item);
+    }
+    /**
+     * 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, lookupValue) {
+        if (lookupValue === undefined)
+            return;
+        const p = SystemUtils.arrayFindIndexByKey(this._all(), this._lookupFieldName, lookupValue);
+        if (p === -1) {
+            this._all.update(arr => [...arr, item]);
+        }
+        this._current.select(item);
+        this.changed.emit(item);
+    }
+    /**
+     * 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, lookupValue) {
+        if (lookupValue === undefined)
+            return;
+        const p = SystemUtils.arrayFindIndexByKey(this._all(), this._lookupFieldName, lookupValue);
+        if (p !== -1) {
+            this._all.update(arr => arr.filter((_, i) => i !== p));
+            this._current.deselect(item);
+            this.changed.emit(item);
+        }
+    }
+    /**
+     * Deselects all items whose lookup key is contained in `lookupValues`.
+     * @param lookupValues - Array of key values identifying the items to deselect.
+     */
+    deselectByValues(lookupValues) {
+        if (lookupValues.length === 0)
+            return;
+        for (const key of lookupValues) {
+            const p = SystemUtils.arrayFindIndexByKey(this._all(), this._lookupFieldName, key);
+            if (p !== -1) {
+                const item = this._all()[p];
+                this._all.update(arr => arr.filter((_, i) => i !== p));
+                this._current.deselect(item);
+                this.changed.emit(item);
+            }
+        }
+    }
+    /**
+     * 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) {
+        for (const item of this._current.selected) {
+            clearFunc(item);
+        }
+        this._current.clear();
+        this.changed.emit(undefined);
+    }
+    /**
+     * Clears both the internal tracked list and the CDK selection.
+     */
+    clear() {
+        this._all.set([]);
+        this._current.clear();
+        this.changed.emit(undefined);
+    }
+    /**
+     * Returns `true` when the item identified by `lookupValue` is present in the tracked list.
+     * @param lookupValue - The key value to look up.
+     */
+    isSelected(lookupValue) {
+        return (lookupValue !== undefined &&
+            SystemUtils.arrayFindIndexByKey(this._all(), this._lookupFieldName, lookupValue) !== -1);
+    }
+}
+
+/**
+ * Standard Broadcast Messages Manager
+ * https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel
+ */
+/**
+ * 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
+ */
+class BroadcastChannelManager {
+    /**
+     * The name of the underlying `BroadcastChannel`, or `undefined` when the API
+     * is not supported by the current browser.
+     */
+    get currentBus() {
+        return this.channel?.name;
+    }
+    /**
+     * Opens a `BroadcastChannel` with the given name (when the API is available).
+     * @param bus - The channel name to open (default: `'ARS-CHANNEL'`).
+     */
+    constructor(bus = 'ARS-CHANNEL') {
+        this.subject = new Subject();
+        this.subscriptions = [];
+        if (typeof window !== 'undefined' && 'BroadcastChannel' in window) {
+            this.channel = new BroadcastChannel(bus);
+            this.channel.onmessageerror = (e) => {
+                console.error('[BroadcastChannelManager] Message receive error', e);
+            };
+            this.channel.onmessage = (e) => {
+                const bag = e.data;
+                if (!bag)
+                    return;
+                this.subject.next(bag);
+                const info = this.subscriptions.find(m => m.messageId === bag.messageId);
+                info?.action(bag);
+            };
+        }
+        else {
+            console.error('[BroadcastChannelManager] BroadcastChannel API is not supported in this browser');
+        }
+    }
+    /**
+     * Closes the underlying channel and completes the internal subject after a short delay
+     * to allow any in-flight messages to be delivered.
+     */
+    dispose() {
+        setTimeout(() => {
+            this.subscriptions = [];
+            this.channel?.close();
+            this.channel = undefined;
+            this.subject.complete();
+        }, 1000);
+    }
+    /** @internal Implementation that handles all overloads. */
+    sendMessage(messageIdOrBag, dataOrDelay, delay) {
+        // Disambiguate overloads based on the first argument:
+        //  - string  => (messageId, data?, delay?)
+        //  - object  => (bag, delay?)
+        let bag;
+        let effectiveDelay;
+        if (typeof messageIdOrBag === 'string') {
+            bag = { messageId: messageIdOrBag, data: dataOrDelay };
+            effectiveDelay = delay ?? 0;
+        }
+        else {
+            bag = messageIdOrBag;
+            effectiveDelay = (typeof dataOrDelay === 'number' ? dataOrDelay : 0);
+        }
+        const post = () => this.channel?.postMessage(bag);
+        if (effectiveDelay > 0) {
+            setTimeout(post, effectiveDelay);
+        }
+        else {
+            post();
+        }
+    }
+    /**
+     * 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(args) {
+        const i = this.subscriptions.findIndex(m => m.messageId === args.messageId);
+        if (i === -1) {
+            this.subscriptions.push(args);
+        }
+        else {
+            this.subscriptions[i].action = args.action;
+        }
+    }
+    /**
+     * Removes the subscription for the given message ID, if one exists.
+     * @param messageId - The message type identifier whose subscription should be removed.
+     */
+    unsubscribe(messageId) {
+        const i = this.subscriptions.findIndex(m => m.messageId === messageId);
+        if (i !== -1) {
+            this.subscriptions.splice(i, 1);
+        }
+    }
+    /**
+     * Removes all registered subscriptions.
+     */
+    unsubscribeAll() {
+        this.subscriptions = [];
+    }
+}
+
+/**
+ * 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`).
+ */
+class BroadcastService {
+    constructor() {
+        this.subject = new Subject();
+        this.channel = new BroadcastChannelManager('ARS-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() {
+        return new BroadcastChannelManager('ARS-CHANNEL');
+    }
+    ngOnDestroy() {
+        this.channel?.dispose();
+        this.subject.complete();
+    }
+    /**
+     * 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`).
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    sendMessage(id, data, delay = 0) {
+        if (delay > 0) {
+            setTimeout(() => this.subject.next({ id, data }), delay);
+        }
+        else {
+            this.subject.next({ id, data });
+        }
+    }
+    /**
+     * 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(id, data, delay) {
+        this.channel.sendMessage(id, data, delay);
+    }
+    /**
+     * 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(id, action) {
+        this.channel.subscribe({ messageId: id, action });
+    }
+    /**
+     * 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) {
+        this.channel.unsubscribe(id);
+    }
+    /**
+     * Returns an `Observable` that emits every in-process message published via `sendMessage`.
+     * @returns An observable stream of `BroadcastMessageInfo` objects.
+     */
+    getMessage() {
+        return this.subject.asObservable();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: BroadcastService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: BroadcastService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: BroadcastService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * 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`).
+ */
+class EnvironmentService {
+    constructor() {
+        /** Writable signal holding the base URI of the frontend application (e.g. `https://app.example.com`). */
+        this.appUriSignal = signal('', /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "appUriSignal" }] : /* istanbul ignore next */ []));
+        /** Writable signal holding the base URI of the backend API service (e.g. `https://api.example.com`). */
+        this.appServiceUriSignal = signal('', /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "appServiceUriSignal" }] : /* istanbul ignore next */ []));
+        /**
+         * Writable signal holding the redirect URI used after login.
+         * When empty, `appLoginRedirectUri` falls back to `appUri`.
+         */
+        this.appLoginRedirectUriSignal = signal('', /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "appLoginRedirectUriSignal" }] : /* istanbul ignore next */ []));
+        /**
+         * Writable signal holding the login endpoint URI of the backend service.
+         * When empty, `appServiceLoginUri` falls back to `appServiceUri`.
+         */
+        this.appServiceLoginUriSignal = signal('', /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "appServiceLoginUriSignal" }] : /* istanbul ignore next */ []));
+        // ── Computed: fallback logic ──────────────────────────────────────────────
+        this._effectiveLoginRedirectUri = computed(() => this.appLoginRedirectUriSignal() || this.appUriSignal(), /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "_effectiveLoginRedirectUri" }] : /* istanbul ignore next */ []));
+        this._effectiveServiceLoginUri = computed(() => this.appServiceLoginUriSignal() || this.appServiceUriSignal(), /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "_effectiveServiceLoginUri" }] : /* istanbul ignore next */ []));
+    }
+    // ── Getter / setter API (kept for backward compatibility) ─────────────────
+    /** Base URI of the frontend application. */
+    get appUri() { return this.appUriSignal(); }
+    /** @param value - The base URI of the frontend application. */
+    set appUri(value) { this.appUriSignal.set(value); }
+    /** Base URI of the backend API service. */
+    get appServiceUri() { return this.appServiceUriSignal(); }
+    /** @param value - The base URI of the backend API service. */
+    set appServiceUri(value) { this.appServiceUriSignal.set(value); }
+    /**
+     * Effective login redirect URI.
+     * Returns the explicitly set value, or falls back to `appUri` when empty.
+     */
+    get appLoginRedirectUri() { return this._effectiveLoginRedirectUri(); }
+    /** @param value - The redirect URI to use after login. */
+    set appLoginRedirectUri(value) { this.appLoginRedirectUriSignal.set(value); }
+    /**
+     * Effective service login URI.
+     * Returns the explicitly set value, or falls back to `appServiceUri` when empty.
+     */
+    get appServiceLoginUri() { return this._effectiveServiceLoginUri(); }
+    /** @param value - The login endpoint URI of the backend service. */
+    set appServiceLoginUri(value) { this.appServiceLoginUriSignal.set(value); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: EnvironmentService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: EnvironmentService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: EnvironmentService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Service that exposes reactive screen and device-capability information.
+ */
+class ScreenService {
+    constructor() {
+        /**
+         * 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.
+         */
+        this.mq = signal('', /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "mq" }] : /* istanbul ignore next */ []));
+    }
+    /**
+     * Returns `true` when the primary input mechanism can hover over elements
+     * with coarse pointer precision (i.e. a touch screen).
+     */
+    get isTouchable() {
+        return SystemUtils.isTouchable();
+    }
+    /**
+     * 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() {
+        return /msie\s|trident\/|edge\//i.test(window.navigator.userAgent);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ScreenService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ScreenService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ScreenService, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * 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.
+ */
+class ThemeService {
+    constructor() {
+        this.broadcastChannel = new BroadcastChannelManager('THEME-SERVICE');
+        this.broadcastMessage = '$theme-changed';
+        this.prefersColorSchemeMediaQueryList = window.matchMedia('(prefers-color-scheme: dark)');
+        this.themeChanged = new BehaviorSubject('auto');
+        this.renderFactory2 = inject(RendererFactory2);
+        this.renderer = this.renderFactory2.createRenderer(null, null);
+        /** The currently selected `ThemeType` (may be `'auto'`). */
+        this.theme = signal('light', /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "theme" }] : /* istanbul ignore next */ []));
+        /** `true` when the theme is set to follow the system preference. */
+        this.auto = computed(() => this.theme() === 'auto', /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "auto" }] : /* istanbul ignore next */ []));
+        this.themeInfo = {
+            auto: { icon: 'routine', name: 'Tema di sistema', next: 'light', tooltip: 'Passa a tema chiaro' },
+            light: { icon: 'light_mode', name: 'Tema chiaro', next: 'dark', tooltip: 'Passa a tema scuro' },
+            dark: { icon: 'dark_mode', name: 'Tema scuro', next: 'auto', tooltip: 'Passa a tema di sistema' },
+        };
+        /** Reactive Material icon code for the current theme (use with `<mat-icon>`). */
+        this.themeIcon = computed(() => this.themeInfo[this.theme()].icon, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "themeIcon" }] : /* istanbul ignore next */ []));
+        /** Reactive human-readable name of the current theme. */
+        this.themeName = computed(() => this.themeInfo[this.theme()].name, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "themeName" }] : /* istanbul ignore next */ []));
+        /** Reactive tooltip text for the theme toggle button. */
+        this.toggleTooltip = computed(() => this.themeInfo[this.theme()].tooltip, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "toggleTooltip" }] : /* istanbul ignore next */ []));
+        this.changed = this.themeChanged.asObservable();
+    }
+    /**
+     * 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 = this.getPreferredTheme()) {
+        this.prefersColorSchemeMediaQueryList.onchange = () => {
+            if (this.auto())
+                this.setTheme(this.theme());
+        };
+        this.broadcastChannel.subscribe({
+            messageId: this.broadcastMessage,
+            action: (bag) => {
+                if (bag.data && this.theme() !== bag.data) {
+                    this.setTheme(bag.data);
+                }
+            }
+        });
+        this.setTheme(theme);
+    }
+    ngOnDestroy() {
+        this.broadcastChannel.dispose();
+    }
+    /**
+     * Advances the theme through the cycle: `auto` → `light` → `dark` → `auto`.
+     */
+    toggleTheme() {
+        this.setTheme(this.themeInfo[this.theme()].next);
+    }
+    /**
+     * 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() {
+        if (this.auto()) {
+            return this.prefersColorSchemeMediaQueryList.matches ? 'dark' : 'light';
+        }
+        return this.getPreferredTheme();
+    }
+    /**
+     * 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.
+     */
+    getPreferredTheme() {
+        const stored = localStorage.getItem('preferred-theme');
+        return stored && this.isTheme(stored) ? stored : 'auto';
+    }
+    /**
+     * Returns `true` when `value` is a valid `ThemeType` string.
+     * Acts as a TypeScript type guard.
+     * @param value - The string to check.
+     */
+    isTheme(value) {
+        return value === 'auto' || value === 'light' || value === 'dark';
+    }
+    /**
+     * 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'`).
+     */
+    setTheme(theme = 'auto') {
+        this.renderer.removeClass(document.body, 'light');
+        this.renderer.removeClass(document.body, 'dark');
+        this.theme.set(theme);
+        localStorage.setItem('preferred-theme', theme);
+        const effectiveClass = this.auto()
+            ? (this.prefersColorSchemeMediaQueryList.matches ? 'dark' : 'light')
+            : theme;
+        this.renderer.addClass(document.body, effectiveClass);
+        this.themeChanged.next(this.getTheme());
+        this.broadcastChannel.sendMessage(this.broadcastMessage, theme);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ThemeService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.0.1", ngImport: i0, type: ThemeService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ThemeService, decorators: [{
+            type: Service
+        }], ctorParameters: () => [] });
+
+/*
+ * Public API Surface of scm-utils
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+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 };
+//# sourceMappingURL=fabio.buscaroli-scm-utils-core.mjs.map