ngx-transforms 0.0.5 → 0.2.0

package/fesm2022/ngx-transforms.mjs

@@ -60,8 +60,6 @@ import * as QRCode from 'qrcode';
  * @example
  * // With inverted colors
  * {{ 'DARK' | asciiArt:{ inverted: true, charset: CharsetPreset.MINIMAL } }}
- *
- * @author Mofiro Jean
  */
 class AsciiArtPipe {
     generator;
@@ -118,59 +116,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
                 }]
         }], ctorParameters: () => [] });
 
-/**
- * BarcodePipe: Generates a barcode from a string value.
- *
- * @param {string} value - The value to encode (e.g., '123456789').
- * @param {BarcodeOptions} [options={}] - Configuration options.
- *
- * @returns {Promise<SafeHtml | SafeResourceUrl>} - SVG markup or image data URL.
- *
- * @example
- * <div [innerHTML]="'123456789' | barcode:{elementType:'svg',format:'CODE128'} | async"></div>
- * <img [src]="'123456789' | barcode:{elementType:'img'} | async" />
- *
- * @author Mofiro Jean
- */
-class BarcodePipe {
-    sanitizer = inject(DomSanitizer);
-    async transform(value, options = {}) {
-        const { elementType = 'svg', format = 'CODE128', lineColor = '#000000', width = 2, height = 100, displayValue = true, } = options;
-        if (!value) {
-            return '';
-        }
-        // Sanitize the value to prevent XSS
-        const sanitizedValue = value.replace(/</g, '&lt;').replace(/>/g, '&gt;');
-        try {
-            const config = { format, lineColor, width, height, displayValue };
-            if (elementType === 'svg') {
-                const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
-                JsBarcode(svg, sanitizedValue, config);
-                return this.sanitizer.bypassSecurityTrustHtml(svg.outerHTML);
-            }
-            else {
-                const canvas = document.createElement('canvas');
-                JsBarcode(canvas, sanitizedValue, config);
-                const dataUrl = canvas.toDataURL('image/png');
-                return this.sanitizer.bypassSecurityTrustResourceUrl(dataUrl);
-            }
-        }
-        catch (error) {
-            console.error('Barcode generation failed:', error);
-            return '';
-        }
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: BarcodePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: BarcodePipe, isStandalone: true, name: "barcode" });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: BarcodePipe, decorators: [{
-            type: Pipe,
-            args: [{
-                    name: 'barcode',
-                    standalone: true,
-                }]
-        }] });
-
 /**
  * CamelCasePipe: Converts text to camelCase (e.g., "hello world" → "helloWorld").
  *
@@ -181,8 +126,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
  * ```html
  * {{ 'hello world' | camelCase }} <!-- Outputs: helloWorld -->
  * ```
- *
- * @author Mofiro Jean
  */
 class CamelCasePipe {
     transform(value) {
@@ -210,48 +153,608 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
                 }]
         }] });
 
-// Pre-compiled regex patterns for performance
-const HEX_6_PATTERN = /^#([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})$/;
-const HEX_8_PATTERN = /^#([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})$/;
-const HEX_3_PATTERN = /^#([0-9A-Fa-f])([0-9A-Fa-f])([0-9A-Fa-f])$/;
-const HEX_4_PATTERN = /^#([0-9A-Fa-f])([0-9A-Fa-f])([0-9A-Fa-f])([0-9A-Fa-f])$/;
-const RGB_PATTERN = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/i;
-const RGBA_PATTERN = /^rgba\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*([\d.]+)\s*\)$/i;
 /**
- * Clamps a value between 0 and 255 for valid RGB channel values.
+ * HighlightPipe: Highlights occurrences of a search term within a string.
+ *
+ * This Angular pipe transforms a string input by wrapping all occurrences of a specified
+ * search term with a `<span>` element that has the class "highlight".
+ * It uses the Angular `DomSanitizer` to bypass security and render the highlighted HTML.
+ *
+ * @param {string} value - The input string in which to highlight the search term.
+ * @param {string} searchTerm - The string to search for and highlight.
+ * @returns {SafeHtml} - The input string with the search term highlighted, or an empty string if input or searchTerm are falsy.
+ *
+ * @example
+ * {{ 'This is a test string' | highlight: 'test' }} // Returns 'This is a <span class="highlight">test</span> string'
+ * {{ 'This is a test TEST string' | highlight: 'test' }} // Returns 'This is a <span class="highlight">test</span> <span class="highlight">TEST</span> string'
+ * {{ 'This is a test string' | highlight: '' }} // Returns 'This is a test string'
+ * {{ null | highlight: 'test' }} // Returns ''
+ * {{ undefined | highlight: 'test' }} // Returns ''
  */
-function clampChannel(value) {
-    return Math.max(0, Math.min(255, Math.round(value)));
+class HighlightPipe {
+    sanitizer = inject(DomSanitizer);
+    transform(value, searchTerm) {
+        if (!value || !searchTerm) {
+            return this.sanitizer.bypassSecurityTrustHtml(value || '');
+        }
+        const escapedSearch = searchTerm.replace(/[.*+?${}()|[\\]/g, '\\$&');
+        const regex = new RegExp(`(${escapedSearch})`, 'gi');
+        const highlighed = value.replace(regex, '<span class="highlight">$1</span>');
+        return this.sanitizer.bypassSecurityTrustHtml(highlighed);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HighlightPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: HighlightPipe, isStandalone: true, name: "highlight" });
 }
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HighlightPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'highlight',
+                    standalone: true
+                }]
+        }] });
+
 /**
- * Clamps alpha value between 0 and 1.
+ * InitialsPipe: Extracts initials from a name.
+ *
+ * @param {string} value - The full name.
+ *
+ * @returns {string} - The initials (e.g., 'John Doe' → 'JD').
+ *
+ * @example
+ * {{ 'John Doe' | initials }} // Outputs: JD
+ * {{ 'Mary Jane Watson' | initials }} // Outputs: MJW
  */
-function clampAlpha(value) {
-    return Math.max(0, Math.min(1, value));
+class InitialsPipe {
+    transform(value) {
+        if (!value)
+            return '';
+        return value
+            .trim()
+            .split(/\s+/)
+            .map(word => word.charAt(0).toUpperCase())
+            .join('');
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: InitialsPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: InitialsPipe, isStandalone: true, name: "initials" });
 }
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: InitialsPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'initials',
+                    standalone: true
+                }]
+        }] });
+
 /**
- * Converts a single hex character to its full two-character representation.
+ * KebabCasePipe: Converts text to kebab-case (e.g., "hello world" → "hello-world").
+ *
+ * @param {string} value - The input string to transform.
+ * @returns {string} The string in kebab-case, or an empty string if input is invalid.
+ *
+ * @example
+ * ```html
+ * {{ 'hello world' | kebabCase }} <!-- Outputs: hello-world -->
+ * ```
  */
-function expandHexChar(char) {
-    return char + char;
+class KebabCasePipe {
+    transform(value) {
+        if (!value || typeof value !== 'string')
+            return '';
+        return value
+            .trim()
+            .replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, '$1-$2') // Add hyphen between camelCase words
+            .toLowerCase()
+            .replace(/[^a-z0-9-]+/g, '-') // Replace non-alphanumeric (except hyphen) with hyphen
+            .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: KebabCasePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: KebabCasePipe, isStandalone: true, name: "kebabCase" });
 }
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: KebabCasePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'kebabCase',
+                    standalone: true
+                }]
+        }] });
+
 /**
- * Converts a number to a two-character hex string.
+ * MorseCodePipe: Converts text to Morse code.
+ *
+ * @param {string} value - The text to convert to Morse code.
+ *
+ * @returns {string} - The Morse code representation (e.g., 'SOS' → '... --- ...').
+ *
+ * @example
+ * {{ 'SOS' | morseCode }} // Outputs: '... --- ...'
+ * {{ 'HELP' | morseCode }} // Outputs: '.... . .-.. .--.'
+ * <p>{{ userInput | morseCode }}</p>
  */
-function toHex(value) {
-    return clampChannel(value).toString(16).padStart(2, '0').toUpperCase();
+class MorseCodePipe {
+    morseCodeMap = {
+        'A': '.-', 'B': '-...', 'C': '-.-.', 'D': '-..', 'E': '.', 'F': '..-.',
+        'G': '--.', 'H': '....', 'I': '..', 'J': '.---', 'K': '-.-', 'L': '.-..',
+        'M': '--', 'N': '-.', 'O': '---', 'P': '.--.', 'Q': '--.-', 'R': '.-.',
+        'S': '...', 'T': '-', 'U': '..-', 'V': '...-', 'W': '.--', 'X': '-..-',
+        'Y': '-.--', 'Z': '--..', '0': '-----', '1': '.----', '2': '..---',
+        '3': '...--', '4': '....-', '5': '.....', '6': '-....', '7': '--...',
+        '8': '---..', '9': '----.'
+    };
+    transform(value) {
+        if (!value || typeof value !== 'string') {
+            return '';
+        }
+        return value
+            .toUpperCase()
+            .split('')
+            .map(char => this.morseCodeMap[char] || '')
+            .filter(code => code)
+            .join(' ');
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: MorseCodePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: MorseCodePipe, isStandalone: true, name: "morseCode" });
 }
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: MorseCodePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'morseCode',
+                    standalone: true
+                }]
+        }] });
+
 /**
- * Converts alpha (0-1) to hex (00-FF).
+ * ReplacePipe: A custom Angular pipe that either highlights or replaces text based on a pattern.
+ *
+ * - If `isReplace` is `false`, it highlights occurrences of the pattern (if `highlightClass` is provided).
+ * - If `isReplace` is `true`, it replaces occurrences of the pattern with the replacement string, optionally highlighting the replacement.
+ *
+ * @param {string} value - The input string to transform.
+ * @param {string | RegExp} pattern - The pattern to match (string or RegExp). If an empty string, the value is returned as-is.
+ * @param {string} replacement - The string to replace matches with.
+ * @param {string} [highlightClass] - Optional CSS class for highlighting matched or replaced text (e.g., 'highlight').
+ * @param {boolean} [isReplace=true] - Whether to perform replacement (true) or only highlight matches (false).
+ *
+ * @returns {string | SafeHtml} - Returns the transformed string or SafeHtml with highlights.
  */
-function alphaToHex(alpha) {
-    return Math.round(clampAlpha(alpha) * 255).toString(16).padStart(2, '0').toUpperCase();
+class ReplacePipe {
+    sanitizer = inject(DomSanitizer);
+    transform(value, pattern, replacement, highlightClass, isReplace = true) {
+        if (!value)
+            return '';
+        // handles empty string pattern
+        if (!pattern || (typeof pattern === 'string' && pattern.trim() === '')) {
+            return value;
+        }
+        const finalPattern = typeof pattern === 'string' ? new RegExp(pattern, 'gi') : pattern;
+        if (!highlightClass) {
+            return isReplace ? value.replace(finalPattern, replacement) : value;
+        }
+        // Sanitize the replacement to prevent XSS
+        const sanitizedReplacement = replacement.replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        if (isReplace) {
+            const highlightedReplacement = `<span class="${highlightClass}">${sanitizedReplacement}</span>`;
+            const replaced = value.replace(finalPattern, highlightedReplacement);
+            return this.sanitizer.bypassSecurityTrustHtml(replaced);
+        }
+        const highlightedMatch = `<span class="${highlightClass}">$&</span>`;
+        const result = value.replace(finalPattern, highlightedMatch);
+        return this.sanitizer.bypassSecurityTrustHtml(result);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ReplacePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: ReplacePipe, isStandalone: true, name: "replace" });
 }
-/**
- * Converts hex alpha (00-FF) to decimal (0-1).
- */
-function hexToAlpha(hex) {
-    return Math.round((parseInt(hex, 16) / 255) * 100) / 100;
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ReplacePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'replace',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * SnakeCasePipe: Converts text to snake_case (e.g., "hello world" → "hello_world").
+ *
+ * @param {string} value - The input string to transform.
+ * @returns {string} The string in snake_case, or an empty string if input is invalid.
+ *
+ * @example
+ * ```html
+ * {{ 'hello world' | snakeCase }} <!-- Outputs: hello_world -->
+ * ```
+ */
+class SnakeCasePipe {
+    transform(value) {
+        if (!value || typeof value !== 'string')
+            return '';
+        return value
+            .trim()
+            .replace(/([A-Z])/g, '_$1') // Convert camelCase to snake_case (e.g., helloWorld -> hello_World)
+            .toLowerCase() // Convert everything to lowercase
+            .replace(/[\s-]+/g, '_') // Replace spaces and hyphens with underscores
+            .replace(/[^a-z0-9_]+/g, '') // Remove all non-alphanumeric and non-underscore characters
+            .replace(/_+/g, '_') // Collapse multiple underscores
+            .replace(/^_|_$/g, ''); // Remove leading/trailing underscores
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: SnakeCasePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: SnakeCasePipe, isStandalone: true, name: "snakeCase" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: SnakeCasePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'snakeCase',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * TitleCasePipe: Capitalizes the first letter of each word in a string.
+ *
+ * @param {string} value - The input string to transform.
+ * @returns {string} The string with each word capitalized, or an empty string if input is invalid.
+ *
+ * @example
+ * ```html
+ * {{ 'hello world' | titleCase }} <!-- Outputs: Hello World -->
+ * ```
+ */
+class TitleCasePipe {
+    transform(value) {
+        if (!value || typeof value !== 'string')
+            return '';
+        return value
+            .split(' ')
+            .filter(word => word.length > 0)
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join(' ');
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TitleCasePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TitleCasePipe, isStandalone: true, name: "titleCase" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TitleCasePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'titleCase',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * TruncatePipe: Truncates a string to a specified maximum length, optionally preserving words.
+ *
+ * This Angular pipe transforms a string input by truncating it to the given `maxLength`.
+ * It provides options to customize the ellipsis and preserve word boundaries.
+ *
+ * @param {string} value - The input string to be truncated.
+ * @param {number} [maxLength=10] - The maximum length of the truncated string. Defaults to 10.
+ * @param {string} [ellipsis='...'] - The string to append to the truncated portion. Defaults to '...'.
+ * @param {boolean} [preserveWords=false] - If true, truncates at the last space before `maxLength` to avoid cutting words. Defaults to false.
+ * @returns {string} - The truncated string. Returns an empty string if the input is null, undefined, or not a string.
+ *
+ * @example
+ * {{ 'This is a long sentence' | truncate }} // Returns 'This is a...'
+ * {{ 'This is a long sentence' | truncate: 20 }} // Returns 'This is a long sente...'
+ * {{ 'This is a long sentence' | truncate: 15: ' [more]' }} // Returns 'This is a long [more]'
+ * {{ 'This is a long sentence' | truncate: 15: '...' : true }} // Returns 'This is a...'
+ * {{ 'This is a long sentence' | truncate: 20: '...' : true }} // Returns 'This is a long...'
+ * {{ null | truncate }} // Returns ''
+ * {{ undefined | truncate }} // Returns ''
+ */
+class TruncatePipe {
+    transform(value, maxLength = 10, ellipsis = '...', preserveWords = false) {
+        if (!value || typeof value !== 'string') {
+            return '';
+        }
+        if (value.length <= maxLength) {
+            return value;
+        }
+        const charsToKeep = maxLength - ellipsis.length;
+        // If maxLength is too small to even include the ellipsis, just return the ellipsis.
+        if (charsToKeep < 0) {
+            return ellipsis;
+        }
+        let truncated = value.substring(0, charsToKeep);
+        if (preserveWords) {
+            const lastSpaceIndex = truncated.lastIndexOf(' ');
+            // If a space is found and it's not the very beginning of the string
+            if (lastSpaceIndex !== -1 && lastSpaceIndex !== 0) {
+                truncated = truncated.substring(0, lastSpaceIndex);
+            }
+        }
+        return truncated.trim() + ellipsis;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TruncatePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TruncatePipe, isStandalone: true, name: "truncate" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TruncatePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'truncate',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * CreditCardMaskPipe: Masks all but the last four digits of a string, optionally controlled by a boolean flag.
+ * By default, masking is applied.
+ *
+ * @param {string} value - The input string to mask (e.g., credit card number).
+ * @param {boolean} shouldMask - (Optional) Determines if masking should be applied. Defaults to true.
+ * @returns {string} - The masked string or the original value if `shouldMask` is false or the value is too short.
+ *
+ * @example
+ * {{ '1234567890123456' | creditCardMask }} // Outputs: **** **** **** 3456
+ * {{ '1234-5678-9012-3456' | creditCardMask }} // Outputs: **** **** **** 3456
+ * {{ '1234567890123456' | creditCardMask: true }} // Outputs: **** **** **** 3456
+ * {{ '1234567890123456' | creditCardMask: false }} // Outputs: 1234567890123456
+ */
+class CreditCardMaskPipe {
+    transform(value, shouldMask = true) {
+        if (!value) {
+            return value;
+        }
+        if (shouldMask) {
+            const cleanedValue = value.replace(/[\s-]/g, '');
+            const cleanedLength = cleanedValue.length;
+            if (cleanedLength < 4) {
+                return value;
+            }
+            const visibleDigits = cleanedValue.slice(-4);
+            const maskedSection = '*'.repeat(cleanedLength - 4);
+            const groupedMask = maskedSection.match(/.{1,4}/g)?.join(' ') ?? '';
+            return `${groupedMask} ${visibleDigits}`.trim();
+        }
+        return value;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: CreditCardMaskPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: CreditCardMaskPipe, isStandalone: true, name: "creditCardMask" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: CreditCardMaskPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'creditCardMask',
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * EmailMaskPipe: Masks the local part of an email address, revealing only the first and last characters.
+ *
+ * This Angular pipe transforms an email address string by replacing the characters between the first and last characters of the local part (before the '@') with "***".
+ * If the local part is 2 characters or less, it masks all characters except the first.
+ *
+ * @param {string} value - The email address string to be masked.
+ * @returns {string} - The masked email address, or the original value if it's not a valid email or falsy.
+ *
+ * @example
+ * {{ 'test@example.com' | emailMask }} // Returns 't***t@example.com'
+ * {{ 'te@example.com' | emailMask }} // Returns 't***@example.com'
+ * {{ 't@example.com' | emailMask }} // Returns 't***@example.com'
+ * {{ 'example.com' | emailMask }} // Returns 'example.com'
+ * {{ null | emailMask }} // Returns ''
+ * {{ undefined | emailMask }} // Returns ''
+ */
+class EmailMaskPipe {
+    transform(value) {
+        if (!value || !value.includes('@')) {
+            return value || '';
+        }
+        const [local, domain] = value.split('@');
+        if (local.length <= 2) {
+            return `${local[0]}***@${domain}`;
+        }
+        const firstChar = local[0];
+        const lastChar = local[local.length - 1];
+        return `${firstChar}***${lastChar}@${domain}`;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: EmailMaskPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: EmailMaskPipe, isStandalone: true, name: "emailMask" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: EmailMaskPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'emailMask',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * Converts special HTML characters in a string to their corresponding HTML entities.
+ * This prevents the browser from interpreting the input as HTML, rendering it as plain text.
+ *
+ * @param {string} value - The input string containing HTML to escape.
+ * @returns {string} The string with special HTML characters escaped, or an empty string if input is invalid.
+ *
+ * @example
+ * ```html
+ * {{ '<p>Hello</p>' | htmlEscape }} <!-- Outputs: &lt;p&gt;Hello&lt;/p&gt; -->
+ * ```
+ */
+class HtmlEscapePipe {
+    transform(value) {
+        if (!value || typeof value !== 'string')
+            return '';
+        const escapeMap = {
+            '&': '&amp;',
+            '<': '&lt;',
+            '>': '&gt;',
+            '"': '&quot;',
+            "'": '&apos;'
+        };
+        return value.replace(/[&<>"']/g, char => escapeMap[char]);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HtmlEscapePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: HtmlEscapePipe, isStandalone: true, name: "htmlEscape" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HtmlEscapePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'htmlEscape',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * Sanitizes HTML input to remove unsafe elements while allowing safe HTML to be rendered.
+ * Uses Angular's DomSanitizer to mark the output as trusted for use in [innerHTML].
+ *
+ * @param {string} value - The input string containing HTML to sanitize.
+ * @returns {SafeHtml} The sanitized HTML marked as safe, or an empty string if input is invalid.
+ *
+ * @remarks
+ * WARNING: Use with caution. Only apply to trusted input to avoid XSS risks.
+ * Ensure input is pre-validated or sourced from a secure origin (e.g., a controlled rich-text editor).
+ *
+ * @example
+ * ```html
+ * <div [innerHTML]="'<p>Hello</p><script>alert(1)</script>' | htmlSanitize"></div>
+ * <!-- Renders: <p>Hello</p> (script tag removed) -->
+ * ```
+ */
+class HtmlSanitizePipe {
+    sanitizer = inject(DomSanitizer);
+    transform(value) {
+        if (!value || typeof value !== 'string')
+            return this.sanitizer.bypassSecurityTrustHtml('');
+        return this.sanitizer.sanitize(0, value) || this.sanitizer.bypassSecurityTrustHtml('');
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HtmlSanitizePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: HtmlSanitizePipe, isStandalone: true, name: "htmlSanitize" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HtmlSanitizePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'htmlSanitize',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * IpAddressMaskPipe: Masks the last two octets of an IPv4 address.
+ *
+ * @param {string} value - The IPv4 address (e.g., 192.168.1.1).
+ * @param {boolean} shouldMask - (Optional) Determines if masking should be applied. Defaults to true..
+ *
+ * @returns {string} - The masked IP address (e.g., 192.168.*.*).
+ *
+ * @example
+ * {{ '192.168.1.1' | ipAddressMask }} // Outputs: 192.168.*.*
+ * {{ '10.0.0.255' | ipAddressMask }} // Outputs: 10.0.*.*
+ */
+class IpAddressMaskPipe {
+    transform(value, shouldMask = true) {
+        if (!value || !/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(value)) {
+            return value;
+        }
+        if (shouldMask) {
+            const parts = value.split('.');
+            return `${parts[0]}.${parts[1]}.*.*`;
+        }
+        return value;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: IpAddressMaskPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: IpAddressMaskPipe, isStandalone: true, name: "ipAddressMask" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: IpAddressMaskPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'ipAddressMask',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * BarcodePipe: Generates a barcode from a string value.
+ *
+ * @param {string} value - The value to encode (e.g., '123456789').
+ * @param {BarcodeOptions} [options={}] - Configuration options.
+ *
+ * @returns {Promise<SafeHtml | SafeResourceUrl>} - SVG markup or image data URL.
+ *
+ * @example
+ * <div [innerHTML]="'123456789' | barcode:{elementType:'svg',format:'CODE128'} | async"></div>
+ * <img [src]="'123456789' | barcode:{elementType:'img'} | async" />
+ */
+class BarcodePipe {
+    sanitizer = inject(DomSanitizer);
+    async transform(value, options = {}) {
+        const { elementType = 'svg', format = 'CODE128', lineColor = '#000000', width = 2, height = 100, displayValue = true, } = options;
+        if (!value) {
+            return '';
+        }
+        // Sanitize the value to prevent XSS
+        const sanitizedValue = value.replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        try {
+            const config = { format, lineColor, width, height, displayValue };
+            if (elementType === 'svg') {
+                const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+                JsBarcode(svg, sanitizedValue, config);
+                return this.sanitizer.bypassSecurityTrustHtml(svg.outerHTML);
+            }
+            else {
+                const canvas = document.createElement('canvas');
+                JsBarcode(canvas, sanitizedValue, config);
+                const dataUrl = canvas.toDataURL('image/png');
+                return this.sanitizer.bypassSecurityTrustResourceUrl(dataUrl);
+            }
+        }
+        catch (error) {
+            console.error('Barcode generation failed:', error);
+            return '';
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: BarcodePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: BarcodePipe, isStandalone: true, name: "barcode" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: BarcodePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'barcode',
+                    standalone: true,
+                }]
+        }] });
+
+// Pre-compiled regex patterns for performance
+const HEX_6_PATTERN = /^#([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})$/;
+const HEX_8_PATTERN = /^#([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})$/;
+const HEX_3_PATTERN = /^#([0-9A-Fa-f])([0-9A-Fa-f])([0-9A-Fa-f])$/;
+const HEX_4_PATTERN = /^#([0-9A-Fa-f])([0-9A-Fa-f])([0-9A-Fa-f])([0-9A-Fa-f])$/;
+const RGB_PATTERN = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/i;
+const RGBA_PATTERN = /^rgba\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*([\d.]+)\s*\)$/i;
+/**
+ * Clamps a value between 0 and 255 for valid RGB channel values.
+ */
+function clampChannel(value) {
+    return Math.max(0, Math.min(255, Math.round(value)));
+}
+/**
+ * Clamps alpha value between 0 and 1.
+ */
+function clampAlpha(value) {
+    return Math.max(0, Math.min(1, value));
+}
+/**
+ * Converts a single hex character to its full two-character representation.
+ */
+function expandHexChar(char) {
+    return char + char;
+}
+/**
+ * Converts a number to a two-character hex string.
+ */
+function toHex(value) {
+    return clampChannel(value).toString(16).padStart(2, '0').toUpperCase();
+}
+/**
+ * Converts alpha (0-1) to hex (00-FF).
+ */
+function alphaToHex(alpha) {
+    return Math.round(clampAlpha(alpha) * 255).toString(16).padStart(2, '0').toUpperCase();
+}
+/**
+ * Converts hex alpha (00-FF) to decimal (0-1).
+ */
+function hexToAlpha(hex) {
+    return Math.round((parseInt(hex, 16) / 255) * 100) / 100;
 }
 /**
  * Parses any supported color format into RGBA components.
@@ -361,8 +864,6 @@ function parseColor(value) {
  * // Alpha channel support
  * {{ '#FF000080' | colorConvert:'rgba' }}   // rgba(255, 0, 0, 0.5)
  * {{ 'rgba(255, 0, 0, 0.5)' | colorConvert:'hex' }} // #FF000080
- *
- * @author Mofiro Jean
  */
 class ColorConvertPipe {
     transform(value, target) {
@@ -395,8 +896,66 @@ class ColorConvertPipe {
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ColorConvertPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'colorConvert',
-                    standalone: true,
+                    name: 'colorConvert',
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * GravatarPipe: Generates Gravatar URLs from email addresses.
+ *
+ * @param {string} value - The email address.
+ * @param {number} [size=80] - The avatar size in pixels.
+ *
+ * @returns {string} - The Gravatar URL.
+ *
+ * @example
+ * <img [src]="'user@example.com' | gravatar:100" />
+ */
+class GravatarPipe {
+    transform(value, size = 80) {
+        if (!value)
+            return `https://www.gravatar.com/avatar/?s=${size}`;
+        const hash = md5(value.trim().toLowerCase());
+        return `https://www.gravatar.com/avatar/${hash}?s=${size}`;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GravatarPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: GravatarPipe, isStandalone: true, name: "gravatar" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GravatarPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'gravatar',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * QrCodePipe: Generates a QR code from a string.
+ *
+ * @param {string} value - The string to encode.
+ * @param {QrCodeOptions} [options] - The QR code options.
+ *
+ * @returns {Promise<string>} - A promise that resolves with the QR code data URL.
+ *
+ * @example
+ * <img [src]="'Hello, World!' | qrCode | async" />
+ */
+class QrCodePipe {
+    transform(value, options) {
+        if (!value) {
+            return Promise.resolve('');
+        }
+        return QRCode.toDataURL(value, options);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: QrCodePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: QrCodePipe, isStandalone: true, name: "qrCode" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: QrCodePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'qrCode',
+                    standalone: true
                 }]
         }] });
 
@@ -424,51 +983,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
                 }]
         }] });
 
-/**
- * CreditCardMaskPipe: Masks all but the last four digits of a string, optionally controlled by a boolean flag.
- * By default, masking is applied.
- *
- * @param {string} value - The input string to mask (e.g., credit card number).
- * @param {boolean} shouldMask - (Optional) Determines if masking should be applied. Defaults to true.
- * @returns {string} - The masked string or the original value if `shouldMask` is false or the value is too short.
- *
- * @example
- * {{ '1234567890123456' | creditCardMask }} // Outputs: **** **** **** 3456
- * {{ '1234-5678-9012-3456' | creditCardMask }} // Outputs: **** **** **** 3456
- * {{ '1234567890123456' | creditCardMask: true }} // Outputs: **** **** **** 3456
- * {{ '1234567890123456' | creditCardMask: false }} // Outputs: 1234567890123456
- *
- * @author Mofiro Jean
- */
-class CreditCardMaskPipe {
-    transform(value, shouldMask = true) {
-        if (!value) {
-            return value;
-        }
-        if (shouldMask) {
-            const cleanedValue = value.replace(/[\s-]/g, '');
-            const cleanedLength = cleanedValue.length;
-            if (cleanedLength < 4) {
-                return value;
-            }
-            const visibleDigits = cleanedValue.slice(-4);
-            const maskedSection = '*'.repeat(cleanedLength - 4);
-            const groupedMask = maskedSection.match(/.{1,4}/g)?.join(' ') ?? '';
-            return `${groupedMask} ${visibleDigits}`.trim();
-        }
-        return value;
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: CreditCardMaskPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: CreditCardMaskPipe, isStandalone: true, name: "creditCardMask" });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: CreditCardMaskPipe, decorators: [{
-            type: Pipe,
-            args: [{
-                    name: 'creditCardMask',
-                    standalone: true,
-                }]
-        }] });
-
 /**
  * DeviceTypePipe: Detects the device type based on the user agent string.
  *
@@ -505,741 +1019,1088 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
         }] });
 
 /**
- * EmailMaskPipe: Masks the local part of an email address, revealing only the first and last characters.
+ * JsonPrettyPipe: Formats JSON data with indentation and syntax highlighting.
  *
- * This Angular pipe transforms an email address string by replacing the characters between the first and last characters of the local part (before the '@') with "***".
- * If the local part is 2 characters or less, it masks all characters except the first.
+ * @param {string | object} value - The JSON string or object to format.
+ * @param {number} [spaces=2] - Number of spaces for indentation.
  *
- * @param {string} value - The email address string to be masked.
- * @returns {string} - The masked email address, or the original value if it's not a valid email or falsy.
+ * @returns {SafeHtml} - Formatted HTML with color-coded JSON.
  *
  * @example
- * {{ 'test@example.com' | emailMask }} // Returns 't***t@example.com'
- * {{ 'te@example.com' | emailMask }} // Returns 't***@example.com'
- * {{ 't@example.com' | emailMask }} // Returns 't***@example.com'
- * {{ 'example.com' | emailMask }} // Returns 'example.com'
- * {{ null | emailMask }} // Returns ''
- * {{ undefined | emailMask }} // Returns ''
+ * {{ '{"name": "John", "age": 30}' | jsonPretty }} // Outputs: Colorful, indented JSON
+ * <pre [innerHTML]="data | jsonPretty:4"></pre> // 4-space indentation
+ */
+class JsonPrettyPipe {
+    sanitizer = inject(DomSanitizer);
+    transform(value, spaces = 2, highlightProperty) {
+        let jsonString;
+        try {
+            if (typeof value === 'object') {
+                jsonString = JSON.stringify(value, null, spaces);
+            }
+            else if (value && typeof value === 'string') {
+                jsonString = JSON.stringify(JSON.parse(value), null, spaces);
+            }
+            else {
+                throw new Error('Invalid or empty input');
+            }
+        }
+        catch (e) {
+            return this.sanitizer.bypassSecurityTrustHtml('<span class="json-error">Invalid JSON: ' + (e instanceof Error ? e.message : 'Unknown error') + '</span>');
+        }
+        const escapedJson = jsonString
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;');
+        let finalJson = this.highlightJson(escapedJson);
+        if (highlightProperty) {
+            const lines = finalJson.split('\n');
+            const highlightedLines = lines.map(line => {
+                const searchString = `<span class="json-key">"${highlightProperty}"</span>`;
+                if (line.includes(searchString)) {
+                    return `<span class="highlight-line">${line}</span>`;
+                }
+                return line;
+            });
+            finalJson = highlightedLines.join('\n');
+        }
+        return this.sanitizer.bypassSecurityTrustHtml(`<pre class="json-pretty">${finalJson}</pre>`);
+    }
+    highlightJson(json) {
+        let result = json.replace(/"([^"\\]*(?:\\.[^"\\]*)*)"/g, (match, p1, offset) => {
+            const remainingString = json.substring(offset + match.length);
+            const isKey = /^\s*:/.test(remainingString);
+            return isKey
+                ? `<span class="json-key">${match}</span>`
+                : `<span class="json-string">${match}</span>`;
+        });
+        // Highlight numbers
+        result = result.replace(/\b-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b/g, '<span class="json-number">$&</span>');
+        // Highlight booleans
+        result = result.replace(/\b(true|false)\b/g, '<span class="json-boolean">$&</span>');
+        // Highlight null
+        result = result.replace(/\bnull\b/g, '<span class="json-null">$&</span>');
+        // Highlight punctuation
+        result = result.replace(/[{}[\]]/g, '<span class="json-punctuation">$&</span>');
+        return result;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: JsonPrettyPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: JsonPrettyPipe, isStandalone: true, name: "jsonPretty" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: JsonPrettyPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'jsonPretty',
+                    standalone: true
+                }]
+        }] });
+
+/**
+ * TextToSpeechPipe: Converts text to speech using the Web Speech API.
+ *
+ * @param {string} value - The text to convert to speech.
+ * @param {string} [lang='en-US'] - The language (local) for speech synthesis.
+ *
+ * @returns {void} - Triggers speech synthesis (no return value).
  *
- * @author Mofiro Jean
+ * @example
+ * <div>{{ Hello World' | textToSpeech }}</div>
+ * <div>{{ 'Bonjour' | textToSpeech:'fr-FR' }}h</div>
  */
-class EmailMaskPipe {
-    transform(value) {
-        if (!value || !value.includes('@')) {
-            return value || '';
+class TextToSpeechPipe {
+    transform(value, lang = 'en-US') {
+        if (!value || typeof window === 'undefined' || !window.speechSynthesis)
+            return;
+        const uttrance = new SpeechSynthesisUtterance(value);
+        uttrance.lang = lang;
+        window.speechSynthesis.speak(uttrance);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TextToSpeechPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TextToSpeechPipe, isStandalone: true, name: "textToSpeech" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TextToSpeechPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'textToSpeech',
+                    standalone: true
+                }]
+        }] });
+
+/**
+* TimeAgo: Converts a date into a localized time string.
+ *
+ * Use the in-built Intl.RelativeTimeFormat to convert a date into a localized time string.
+ * It was chosen over moment.js because it's more lightweight and supports more locales.
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat
+ *
+ * @param {Date | number | string} value - The date to convert.
+ * @param {string} [local='en'] - BCP 47 local code (e.g., 'en', 'fr', 'es').
+ *
+ * @returns {string} - The localized time string.
+ *
+ * @example
+ * {{ date | timeAgo }}       // '5 minutes ago'
+ * {{ date | timeAgo:'fr' }}   // 'il y a 5 minutes'
+ *
+ * @note Pure pipe - output won't automatically update as time passes.
+ * Use signals or periodic change detection to re-trigger.
+* */
+class TimeAgoPipePipe {
+    static THRESHOLDS = [
+        [60, 1, 'second'],
+        [3600, 60, 'minute'],
+        [86400, 3600, 'hour'],
+        [604800, 86400, 'day'],
+        [2592000, 604800, 'week'],
+        [31536000, 2592000, 'month'],
+        [Infinity, 31536000, 'year'],
+    ];
+    cacheLocal = '';
+    rtf;
+    transform(value, local = 'en') {
+        if (value === null || value === undefined || value === "") {
+            return "";
         }
-        const [local, domain] = value.split('@');
-        if (local.length <= 2) {
-            return `${local[0]}***@${domain}`;
+        const date = new Date(value);
+        if (isNaN(date.getTime())) {
+            return "";
         }
-        const firstChar = local[0];
-        const lastChar = local[local.length - 1];
-        return `${firstChar}***${lastChar}@${domain}`;
+        if (local !== this.cacheLocal) {
+            this.rtf = new Intl.RelativeTimeFormat(local, { numeric: "auto" });
+            this.cacheLocal = local;
+        }
+        const seconds = Math.floor((date.getTime() - Date.now()) / 1000);
+        for (const [max, divisor, unit] of TimeAgoPipePipe.THRESHOLDS) {
+            if (Math.abs(seconds) < max) {
+                return this.rtf.format(Math.round(seconds / divisor), unit);
+            }
+        }
+        return "";
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: EmailMaskPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: EmailMaskPipe, isStandalone: true, name: "emailMask" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TimeAgoPipePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TimeAgoPipePipe, isStandalone: true, name: "timeAgo" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: EmailMaskPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TimeAgoPipePipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'emailMask',
+                    name: 'timeAgo',
                     standalone: true
                 }]
         }] });
 
 /**
- * GravatarPipe: Generates Gravatar URLs from email addresses.
+ * DiffPipe: Returns elements present in the first array but not in the second.
  *
- * @param {string} value - The email address.
- * @param {number} [size=80] - The avatar size in pixels.
+ * Supports primitives and objects by property key with dot notation.
  *
- * @returns {string} - The Gravatar URL.
+ * @param {unknown[]} value - The source array.
+ * @param {unknown[]} compared - The array to compare against.
+ * @param {string} [key] - Optional property path for object comparison (supports dot notation).
+ *
+ * @returns {unknown[]} - Elements in value that are not in compared.
  *
  * @example
- * <img [src]="'user@example.com' | gravatar:100" />
+ * {{ [1, 2, 3, 4, 5] | diff:[3, 4, 5, 6] }}              // [1, 2]
+ * {{ allUsers | diff:activeUsers:'id' }}                    // inactive users
+ * {{ orders | diff:shipped:'meta.trackingId' }}             // unshipped orders
+ */
+class DiffPipe {
+    transform(value, compared, key) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        if (!Array.isArray(compared) || compared.length === 0) {
+            return [...value];
+        }
+        if (!key) {
+            const comparedSet = new Set(compared);
+            return value.filter(item => !comparedSet.has(item));
+        }
+        const comparedSet = new Set(compared.map(item => this.getNestedValue(item, key)));
+        return value.filter(item => {
+            const val = this.getNestedValue(item, key);
+            return !comparedSet.has(val);
+        });
+    }
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: DiffPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: DiffPipe, isStandalone: true, name: "diff" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: DiffPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'diff',
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * EveryPipe: Checks if all elements in an array satisfy a condition.
+ *
+ * Supports primitives (equality check) and objects by property key with dot notation.
+ *
+ * @param {unknown[]} value - The array to check.
+ * @param {unknown} match - The value to match against.
+ * @param {string} [key] - Optional property path to check (supports dot notation).
+ *
+ * @returns {boolean} - True if all elements match, false otherwise.
  *
- * @author Mofiro Jean
+ * @example
+ * {{ [true, true, true] | every:true }}                     // true
+ * {{ users | every:'active':'status' }}                     // are all users active?
+ * {{ orders | every:'shipped':'meta.state' }}               // are all orders shipped?
  */
-class GravatarPipe {
-    transform(value, size = 80) {
-        if (!value)
-            return `https://www.gravatar.com/avatar/?s=${size}`;
-        const hash = md5(value.trim().toLowerCase());
-        return `https://www.gravatar.com/avatar/${hash}?s=${size}`;
+class EveryPipe {
+    transform(value, match, key) {
+        if (!Array.isArray(value) || value.length === 0) {
+            return false;
+        }
+        if (!key) {
+            return value.every(item => item === match);
+        }
+        return value.every(item => this.getNestedValue(item, key) === match);
+    }
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: EveryPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: EveryPipe, isStandalone: true, name: "every" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: EveryPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'every',
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * IntersectionPipe: Returns elements common to both arrays.
+ *
+ * Supports primitives and objects by property key with dot notation.
+ *
+ * @param {unknown[]} value - The first array.
+ * @param {unknown[]} compared - The second array.
+ * @param {string} [key] - Optional property path for object comparison (supports dot notation).
+ *
+ * @returns {unknown[]} - Elements present in both arrays.
+ *
+ * @example
+ * {{ [1, 2, 3, 4] | intersection:[3, 4, 5, 6] }}              // [3, 4]
+ * {{ teamA | intersection:teamB:'id' }}                         // shared members
+ * {{ required | intersection:granted:'meta.scope' }}            // matched permissions
+ */
+class IntersectionPipe {
+    transform(value, compared, key) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        if (!Array.isArray(compared) || compared.length === 0) {
+            return [];
+        }
+        if (!key) {
+            const comparedSet = new Set(compared);
+            return value.filter(item => comparedSet.has(item));
+        }
+        const comparedSet = new Set(compared.map(item => this.getNestedValue(item, key)));
+        return value.filter(item => {
+            const val = this.getNestedValue(item, key);
+            return comparedSet.has(val);
+        });
+    }
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: IntersectionPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: IntersectionPipe, isStandalone: true, name: "intersection" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: IntersectionPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'intersection',
+                    standalone: true,
+                }]
+        }] });
+
+/**
+ * ChunkPipe: Splits an array into smaller arrays of a specified size.
+ *
+ * @param {unknown[]} value - The array to split.
+ * @param {number} [size=1] - The size of each chunk.
+ *
+ * @returns {unknown[][]} - An array of chunks.
+ *
+ * @example
+ * {{ [1, 2, 3, 4, 5] | chunk:2 }}     // [[1, 2], [3, 4], [5]]
+ * {{ [1, 2, 3, 4, 5, 6] | chunk:3 }}  // [[1, 2, 3], [4, 5, 6]]
+ */
+class ChunkPipe {
+    transform(value, size = 1) {
+        if (!Array.isArray(value) || value.length === 0) {
+            return [];
+        }
+        if (size <= 0) {
+            return [];
+        }
+        const result = [];
+        for (let i = 0; i < value.length; i += size) {
+            result.push(value.slice(i, i + size));
+        }
+        return result;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GravatarPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: GravatarPipe, isStandalone: true, name: "gravatar" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ChunkPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: ChunkPipe, isStandalone: true, name: "chunk" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GravatarPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ChunkPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'gravatar',
+                    name: 'chunk',
                     standalone: true
                 }]
         }] });
 
 /**
- * HighlightPipe: Highlights occurrences of a search term within a string.
+ * FlattenPipe: Flattens nested arrays to a specified depth.
  *
- * This Angular pipe transforms a string input by wrapping all occurrences of a specified
- * search term with a `<span>` element that has the class "highlight".
- * It uses the Angular `DomSanitizer` to bypass security and render the highlighted HTML.
+ * @param {unknown[]} value - The nested array to flatten.
+ * @param {number} [depth=Infinity] - How many levels of nesting to flatten.
  *
- * @param {string} value - The input string in which to highlight the search term.
- * @param {string} searchTerm - The string to search for and highlight.
- * @returns {SafeHtml} - The input string with the search term highlighted, or an empty string if input or searchTerm are falsy.
+ * @returns {unknown[]} - A new flattened array.
  *
  * @example
- * {{ 'This is a test string' | highlight: 'test' }} // Returns 'This is a <span class="highlight">test</span> string'
- * {{ 'This is a test TEST string' | highlight: 'test' }} // Returns 'This is a <span class="highlight">test</span> <span class="highlight">TEST</span> string'
- * {{ 'This is a test string' | highlight: '' }} // Returns 'This is a test string'
- * {{ null | highlight: 'test' }} // Returns ''
- * {{ undefined | highlight: 'test' }} // Returns ''
- *
- * @author Mofiro Jean
+ * {{ [[1, 2], [3, 4]] | flatten }}         // [1, 2, 3, 4]
+ * {{ [[1, [2, [3]]]] | flatten:1 }}        // [1, 2, [3]]
+ * {{ [['a', 'b'], ['c']] | flatten }}      // ['a', 'b', 'c']
  */
-class HighlightPipe {
-    sanitizer = inject(DomSanitizer);
-    transform(value, searchTerm) {
-        if (!value || !searchTerm) {
-            return this.sanitizer.bypassSecurityTrustHtml(value || '');
+class Flatten {
+    transform(value, depth = Infinity) {
+        if (!Array.isArray(value)) {
+            return [];
         }
-        const escapedSearch = searchTerm.replace(/[.*+?${}()|[\\]/g, '\\$&');
-        const regex = new RegExp(`(${escapedSearch})`, 'gi');
-        const highlighed = value.replace(regex, '<span class="highlight">$1</span>');
-        return this.sanitizer.bypassSecurityTrustHtml(highlighed);
+        return value.flat(depth);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HighlightPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: HighlightPipe, isStandalone: true, name: "highlight" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: Flatten, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: Flatten, isStandalone: true, name: "flatten" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HighlightPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: Flatten, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'highlight',
+                    name: 'flatten',
                     standalone: true
                 }]
         }] });
 
 /**
- * Converts special HTML characters in a string to their corresponding HTML entities.
- * This prevents the browser from interpreting the input as HTML, rendering it as plain text.
+ * GroupByPipe: Groups array elements by a property value.
  *
- * @param {string} value - The input string containing HTML to escape.
- * @returns {string} The string with special HTML characters escaped, or an empty string if input is invalid.
+ * @param {unknown[]} value - The array to group.
+ * @param {string} key - Property path to group by (supports dot notation).
+ *
+ * @returns {Record<string, unknown[]>} - An object where keys are group names and values are arrays.
  *
  * @example
- * ```html
- * {{ '<p>Hello</p>' | htmlEscape }} <!-- Outputs: &lt;p&gt;Hello&lt;/p&gt; -->
- * ```
+ * {{ users | groupBy:'role' }}              // { admin: [...], editor: [...] }
+ * {{ orders | groupBy:'customer.city' }}    // { 'New York': [...], 'London': [...] }
  */
-class HtmlEscapePipe {
-    transform(value) {
-        if (!value || typeof value !== 'string')
-            return '';
-        const escapeMap = {
-            '&': '&amp;',
-            '<': '&lt;',
-            '>': '&gt;',
-            '"': '&quot;',
-            "'": '&apos;'
-        };
-        return value.replace(/[&<>"']/g, char => escapeMap[char]);
+class GroupByPipe {
+    transform(value, key) {
+        if (!Array.isArray(value) || !key) {
+            return {};
+        }
+        return value.reduce((groups, item) => {
+            const groupKey = String(this.getNestedValue(item, key) ?? 'undefined');
+            if (!groups[groupKey]) {
+                groups[groupKey] = [];
+            }
+            groups[groupKey].push(item);
+            return groups;
+        }, {});
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HtmlEscapePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: HtmlEscapePipe, isStandalone: true, name: "htmlEscape" });
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GroupByPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: GroupByPipe, isStandalone: true, name: "groupBy" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HtmlEscapePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GroupByPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'htmlEscape',
-                    standalone: true
+                    name: 'groupBy',
+                    standalone: true,
                 }]
         }] });
 
 /**
- * Sanitizes HTML input to remove unsafe elements while allowing safe HTML to be rendered.
- * Uses Angular's DomSanitizer to mark the output as trusted for use in [innerHTML].
+ * InitialPipe: Returns all elements except the last n.
  *
- * @param {string} value - The input string containing HTML to sanitize.
- * @returns {SafeHtml} The sanitized HTML marked as safe, or an empty string if input is invalid.
+ * @param {unknown[]} value - The array to slice.
+ * @param {number} [n=1] - Number of elements to exclude from the end.
  *
- * @remarks
- * WARNING: Use with caution. Only apply to trusted input to avoid XSS risks.
- * Ensure input is pre-validated or sourced from a secure origin (e.g., a controlled rich-text editor).
+ * @returns {unknown[]} - A new array without the last n elements.
  *
  * @example
- * ```html
- * <div [innerHTML]="'<p>Hello</p><script>alert(1)</script>' | htmlSanitize"></div>
- * <!-- Renders: <p>Hello</p> (script tag removed) -->
- * ```
+ * {{ [1, 2, 3, 4, 5] | initial }}       // [1, 2, 3, 4]
+ * {{ [1, 2, 3, 4, 5] | initial:2 }}     // [1, 2, 3]
+ * {{ ['a', 'b', 'c'] | initial }}        // ['a', 'b']
  */
-class HtmlSanitizePipe {
-    sanitizer = inject(DomSanitizer);
-    transform(value) {
-        if (!value || typeof value !== 'string')
-            return this.sanitizer.bypassSecurityTrustHtml('');
-        return this.sanitizer.sanitize(0, value) || this.sanitizer.bypassSecurityTrustHtml('');
+class InitialPipe {
+    transform(value, n = 1) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        if (n <= 0) {
+            return [...value];
+        }
+        if (n >= value.length) {
+            return [];
+        }
+        return value.slice(0, -n);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HtmlSanitizePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: HtmlSanitizePipe, isStandalone: true, name: "htmlSanitize" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: InitialPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: InitialPipe, isStandalone: true, name: "initial" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: HtmlSanitizePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: InitialPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'htmlSanitize',
+                    name: 'initial',
                     standalone: true
                 }]
         }] });
 
 /**
- * InitialsPipe: Extracts initials from a name.
+ * OrderByPipe: Sorts an array by a property value.
  *
- * @param {string} value - The full name.
+ * @param {unknown[]} value - The array to sort.
+ * @param {string} key - Property path to sort by (supports dot notation).
+ * @param {string} [direction='asc'] - Sort direction: 'asc' or 'desc'.
  *
- * @returns {string} - The initials (e.g., 'John Doe' → 'JD').
+ * @returns {unknown[]} - A new sorted array.
  *
  * @example
- * {{ 'John Doe' | initials }} // Outputs: JD
- * {{ 'Mary Jane Watson' | initials }} // Outputs: MJW
- *
- * @author Mofiro Jean
+ * {{ users | orderBy:'name' }}            // sorted A-Z
+ * {{ users | orderBy:'name':'desc' }}     // sorted Z-A
+ * {{ users | orderBy:'age':'asc' }}       // sorted by age
  */
-class InitialsPipe {
-    transform(value) {
-        if (!value)
-            return '';
-        return value
-            .trim()
-            .split(/\s+/)
-            .map(word => word.charAt(0).toUpperCase())
-            .join('');
+class OrderByPipe {
+    transform(value, key, direction = 'asc') {
+        if (!Array.isArray(value) || value.length <= 1 || !key) {
+            return Array.isArray(value) ? [...value] : [];
+        }
+        const dir = direction === 'desc' ? -1 : 1;
+        return [...value].sort((a, b) => {
+            const valA = this.getNestedValue(a, key);
+            const valB = this.getNestedValue(b, key);
+            if (valA === valB)
+                return 0;
+            if (valA === null || valA === undefined)
+                return 1;
+            if (valB === null || valB === undefined)
+                return -1;
+            if (typeof valA === 'string' && typeof valB === 'string') {
+                return valA.localeCompare(valB) * dir;
+            }
+            if (typeof valA === 'number' && typeof valB === 'number') {
+                return (valA - valB) * dir;
+            }
+            return String(valA).localeCompare(String(valB)) * dir;
+        });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: InitialsPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: InitialsPipe, isStandalone: true, name: "initials" });
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: OrderByPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: OrderByPipe, isStandalone: true, name: "orderBy" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: InitialsPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: OrderByPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'initials',
-                    standalone: true
+                    name: 'orderBy',
+                    standalone: true,
                 }]
         }] });
 
 /**
- * IpAddressMaskPipe: Masks the last two octets of an IPv4 address.
+ * PluckPipe: Extracts a property value from every object in an array.
  *
- * @param {string} value - The IPv4 address (e.g., 192.168.1.1).
- * @param {boolean} shouldMask - (Optional) Determines if masking should be applied. Defaults to true..
+ * @param {unknown[]} value - The array of objects.
+ * @param {string} key - Property path to extract (supports dot notation).
  *
- * @returns {string} - The masked IP address (e.g., 192.168.*.*).
+ * @returns {unknown[]} - An array of the extracted values.
  *
  * @example
- * {{ '192.168.1.1' | ipAddressMask }} // Outputs: 192.168.*.*
- * {{ '10.0.0.255' | ipAddressMask }} // Outputs: 10.0.*.*
- *
- * @author Mofiro Jean
+ * {{ users | pluck:'name' }}                // ['Alice', 'Bob', 'Carol']
+ * {{ orders | pluck:'customer.email' }}     // ['a@test.com', 'b@test.com']
  */
-class IpAddressMaskPipe {
-    transform(value, shouldMask = true) {
-        if (!value || !/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(value)) {
-            return value;
+class PluckPipe {
+    transform(value, key) {
+        if (!Array.isArray(value) || !key) {
+            return [];
         }
-        if (shouldMask) {
-            const parts = value.split('.');
-            return `${parts[0]}.${parts[1]}.*.*`;
-        }
-        return value;
+        return value.map(item => this.getNestedValue(item, key));
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: IpAddressMaskPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: IpAddressMaskPipe, isStandalone: true, name: "ipAddressMask" });
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: PluckPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: PluckPipe, isStandalone: true, name: "pluck" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: IpAddressMaskPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: PluckPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'ipAddressMask',
-                    standalone: true
+                    name: 'pluck',
+                    standalone: true,
                 }]
         }] });
 
 /**
- * JsonPrettyPipe: Formats JSON data with indentation and syntax highlighting.
+ * RangePipe: Generates a numeric sequence array.
  *
- * @param {string | object} value - The JSON string or object to format.
- * @param {number} [spaces=2] - Number of spaces for indentation.
+ * @param {number} value - The number of items to generate (or the end value when start is provided).
+ * @param {number} [start=0] - The starting number.
+ * @param {number} [step=1] - The increment between each number.
  *
- * @returns {SafeHtml} - Formatted HTML with color-coded JSON.
+ * @returns {number[]} - An array of sequential numbers.
  *
  * @example
- * {{ '{"name": "John", "age": 30}' | jsonPretty }} // Outputs: Colorful, indented JSON
- * <pre [innerHTML]="data | jsonPretty:4"></pre> // 4-space indentation
- *
- * @author Mofiro Jean
+ * {{ 5 | range }}            // [0, 1, 2, 3, 4]
+ * {{ 5 | range:1 }}          // [1, 2, 3, 4, 5]
+ * {{ 10 | range:0:2 }}       // [0, 2, 4, 6, 8]
  */
-class JsonPrettyPipe {
-    sanitizer = inject(DomSanitizer);
-    transform(value, spaces = 2, highlightProperty) {
-        let jsonString;
-        try {
-            if (typeof value === 'object') {
-                jsonString = JSON.stringify(value, null, spaces);
-            }
-            else if (value && typeof value === 'string') {
-                jsonString = JSON.stringify(JSON.parse(value), null, spaces);
-            }
-            else {
-                throw new Error('Invalid or empty input');
-            }
+class RangePipe {
+    transform(value, start = 0, step = 1) {
+        if (typeof value !== 'number' || isNaN(value) || value <= 0) {
+            return [];
         }
-        catch (e) {
-            return this.sanitizer.bypassSecurityTrustHtml('<span class="json-error">Invalid JSON: ' + (e instanceof Error ? e.message : 'Unknown error') + '</span>');
+        if (step === 0) {
+            return [];
         }
-        const escapedJson = jsonString
-            .replace(/&/g, '&amp;')
-            .replace(/</g, '&lt;')
-            .replace(/>/g, '&gt;');
-        let finalJson = this.highlightJson(escapedJson);
-        if (highlightProperty) {
-            const lines = finalJson.split('\n');
-            const highlightedLines = lines.map(line => {
-                const searchString = `<span class="json-key">"${highlightProperty}"</span>`;
-                if (line.includes(searchString)) {
-                    return `<span class="highlight-line">${line}</span>`;
-                }
-                return line;
-            });
-            finalJson = highlightedLines.join('\n');
+        const result = [];
+        for (let i = 0; i < value; i++) {
+            result.push(start + i * step);
         }
-        return this.sanitizer.bypassSecurityTrustHtml(`<pre class="json-pretty">${finalJson}</pre>`);
-    }
-    highlightJson(json) {
-        let result = json.replace(/"([^"\\]*(?:\\.[^"\\]*)*)"/g, (match, p1, offset) => {
-            const remainingString = json.substring(offset + match.length);
-            const isKey = /^\s*:/.test(remainingString);
-            return isKey
-                ? `<span class="json-key">${match}</span>`
-                : `<span class="json-string">${match}</span>`;
-        });
-        // Highlight numbers
-        result = result.replace(/\b-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b/g, '<span class="json-number">$&</span>');
-        // Highlight booleans
-        result = result.replace(/\b(true|false)\b/g, '<span class="json-boolean">$&</span>');
-        // Highlight null
-        result = result.replace(/\bnull\b/g, '<span class="json-null">$&</span>');
-        // Highlight punctuation
-        result = result.replace(/[{}[\]]/g, '<span class="json-punctuation">$&</span>');
         return result;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: JsonPrettyPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: JsonPrettyPipe, isStandalone: true, name: "jsonPretty" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: RangePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: RangePipe, isStandalone: true, name: "range" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: JsonPrettyPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: RangePipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'jsonPretty',
-                    standalone: true
+                    name: 'range',
+                    standalone: true,
                 }]
         }] });
 
 /**
- * KebabCasePipe: Converts text to kebab-case (e.g., "hello world" → "hello-world").
+ * ReversePipe: Reverses the characters in a string.
  *
- * @param {string} value - The input string to transform.
- * @returns {string} The string in kebab-case, or an empty string if input is invalid.
+ * @param {string} value - The string to reverse.
  *
- * @example
- * ```html
- * {{ 'hello world' | kebabCase }} <!-- Outputs: hello-world -->
- * ```
+ * @returns {string} - The reversed string (e.g., 'hello' → 'olleh').
  *
- * @author Mofiro Jean
+ * @example
+ * {{ 'hello' | reverse }} // Outputs: 'olleh'
+ * {{ '12345' | reverse }} // Outputs: '54321'
+ * <p>{{ userInput | reverse }}</p>
  */
-class KebabCasePipe {
+class ReversePipe {
     transform(value) {
-        if (!value || typeof value !== 'string')
-            return '';
-        return value
-            .trim()
-            .replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, '$1-$2') // Add hyphen between camelCase words
-            .toLowerCase()
-            .replace(/[^a-z0-9-]+/g, '-') // Replace non-alphanumeric (except hyphen) with hyphen
-            .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens
+        if (Array.isArray(value)) {
+            return [...value].reverse();
+        }
+        if (typeof value === 'string') {
+            return value.split('').reverse().join('');
+        }
+        return '';
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: KebabCasePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: KebabCasePipe, isStandalone: true, name: "kebabCase" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ReversePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: ReversePipe, isStandalone: true, name: "reverse" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: KebabCasePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ReversePipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'kebabCase',
+                    name: 'reverse',
                     standalone: true
                 }]
         }] });
 
 /**
- * MorseCodePipe: Converts text to Morse code.
+ * SamplePipe: Randomly selects n items from an array.
  *
- * @param {string} value - The text to convert to Morse code.
+ * Uses Fisher-Yates partial shuffle for unbiased selection.
+ * Returns a single item when n=1 (default), or an array when n>1.
  *
- * @returns {string} - The Morse code representation (e.g., 'SOS' → '... --- ...').
+ * @param {unknown[]} value - The array to sample from.
+ * @param {number} [n=1] - Number of items to select.
+ *
+ * @returns {unknown | unknown[]} - A single random item (n=1) or array of random items (n>1).
  *
  * @example
- * {{ 'SOS' | morseCode }} // Outputs: '... --- ...'
- * {{ 'HELP' | morseCode }} // Outputs: '.... . .-.. .--.'
- * <p>{{ userInput | morseCode }}</p>
+ * {{ [1, 2, 3, 4, 5] | sample }}       // 3 (random single)
+ * {{ [1, 2, 3, 4, 5] | sample:3 }}     // [5, 1, 3] (random 3)
+ * {{ users | sample:5 }}               // 5 random users
  *
- * @author Mofiro Jean
+ * @note Impure pipe — returns different results on each change detection cycle.
+ * Bind the result to a signal to control when it re-samples.
  */
-class MorseCodePipe {
-    morseCodeMap = {
-        'A': '.-', 'B': '-...', 'C': '-.-.', 'D': '-..', 'E': '.', 'F': '..-.',
-        'G': '--.', 'H': '....', 'I': '..', 'J': '.---', 'K': '-.-', 'L': '.-..',
-        'M': '--', 'N': '-.', 'O': '---', 'P': '.--.', 'Q': '--.-', 'R': '.-.',
-        'S': '...', 'T': '-', 'U': '..-', 'V': '...-', 'W': '.--', 'X': '-..-',
-        'Y': '-.--', 'Z': '--..', '0': '-----', '1': '.----', '2': '..---',
-        '3': '...--', '4': '....-', '5': '.....', '6': '-....', '7': '--...',
-        '8': '---..', '9': '----.'
-    };
-    transform(value) {
-        if (!value || typeof value !== 'string') {
-            return '';
+class SamplePipe {
+    transform(value, n = 1) {
+        if (!Array.isArray(value) || value.length === 0) {
+            return n === 1 ? undefined : [];
         }
-        return value
-            .toUpperCase()
-            .split('')
-            .map(char => this.morseCodeMap[char] || '')
-            .filter(code => code)
-            .join(' ');
+        if (n <= 0) {
+            return [];
+        }
+        // Clamp n to array length
+        const count = Math.min(n, value.length);
+        // Fisher-Yates partial shuffle — only shuffle `count` positions
+        const arr = [...value];
+        for (let i = arr.length - 1; i > arr.length - 1 - count; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [arr[i], arr[j]] = [arr[j], arr[i]];
+        }
+        const result = arr.slice(arr.length - count);
+        // Return single item for n=1, array otherwise
+        return n === 1 ? result[0] : result;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: MorseCodePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: MorseCodePipe, isStandalone: true, name: "morseCode" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: SamplePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: SamplePipe, isStandalone: true, name: "sample", pure: false });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: MorseCodePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: SamplePipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'morseCode',
-                    standalone: true
+                    name: 'sample',
+                    standalone: true,
+                    pure: false,
                 }]
         }] });
 
 /**
- * QrCodePipe: Generates a QR code from a string.
+ * ShufflePipe: Randomly reorders elements in an array using the Fisher-Yates
+ algorithm.
  *
- * @param {string} value - The string to encode.
- * @param {QrCodeOptions} [options] - The QR code options.
+ * Uses the Fisher-Yates (Knuth) shuffle for unbiased randomization,
+ * guaranteeing every permutation has equal probability.
  *
- * @returns {Promise<string>} - A promise that resolves with the QR code data URL.
+ * @param {unknown[]} value - The array to shuffle.
+ *
+ * @returns {unknown[]} - A new array with elements in random order.
  *
  * @example
- * <img [src]="'Hello, World!' | qrCode | async" />
+ * {{ [1, 2, 3, 4, 5] | shuffle }}         // [3, 1, 5, 2, 4]
+ * {{ ['a', 'b', 'c'] | shuffle }}          // ['c', 'a', 'b']
  *
- * @author Mofiro Jean
+ * @note Impure pipe — runs on every change detection cycle.
+ * Avoid using in performance-critical templates or bind the result
+ * to a signal/variable to control when it re-shuffles.
  */
-class QrCodePipe {
-    transform(value, options) {
-        if (!value) {
-            return Promise.resolve('');
+class ShufflePipe {
+    transform(value) {
+        if (!Array.isArray(value)) {
+            return [];
         }
-        return QRCode.toDataURL(value, options);
+        const arr = [...value];
+        for (let i = arr.length - 1; i >= 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [arr[i], arr[j]] = [arr[j], arr[i]];
+        }
+        return arr;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: QrCodePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: QrCodePipe, isStandalone: true, name: "qrCode" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ShufflePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: ShufflePipe, isStandalone: true, name: "shuffle", pure: false });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: QrCodePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ShufflePipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'qrCode',
+                    name: 'shuffle',
+                    pure: false,
                     standalone: true
                 }]
         }] });
 
 /**
- * ReplacePipe: A custom Angular pipe that either highlights or replaces text based on a pattern.
+ * TailPipe: Returns all elements except the first n.
  *
- * - If `isReplace` is `false`, it highlights occurrences of the pattern (if `highlightClass` is provided).
- * - If `isReplace` is `true`, it replaces occurrences of the pattern with the replacement string, optionally highlighting the replacement.
- *
- * @param {string} value - The input string to transform.
- * @param {string | RegExp} pattern - The pattern to match (string or RegExp). If an empty string, the value is returned as-is.
- * @param {string} replacement - The string to replace matches with.
- * @param {string} [highlightClass] - Optional CSS class for highlighting matched or replaced text (e.g., 'highlight').
- * @param {boolean} [isReplace=true] - Whether to perform replacement (true) or only highlight matches (false).
+ * @param {unknown[]} value - The array to slice.
+ * @param {number} [n=1] - Number of elements to exclude from the start.
  *
- * @returns {string | SafeHtml} - Returns the transformed string or SafeHtml with highlights.
+ * @returns {unknown[]} - A new array without the first n elements.
  *
  * @example
- * {{ 'Hello World' | replace:'World':'Universe' }}
- * // Output: Hello Universe
- *
- * {{ 'test123' | replace:/\d+/g:'X':'highlight' }}
- * // Output: test<span class="highlight">X</span>
+ * {{ [1, 2, 3, 4, 5] | tail }}       // [2, 3, 4, 5]
+ * {{ [1, 2, 3, 4, 5] | tail:2 }}     // [3, 4, 5]
+ * {{ ['a', 'b', 'c'] | tail }}        // ['b', 'c']
+ */
+class TailPipe {
+    transform(value, n = 1) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        // n = 0 means keep everything
+        if (n <= 0)
+            return [...value];
+        // n >= length means remove everything
+        if (n >= value.length)
+            return [];
+        return value.slice(n);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TailPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TailPipe, isStandalone: true, name: "tail" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TailPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'tail',
+                }]
+        }] });
+
+/**
+ * TruthifyPipe: Removes all falsy values from an array.
  *
- * {{ 'Angular is great' | replace:'great':'awesome':'highlight':true }}
- * // Output: Angular is <span class="highlight">awesome</span>
+ * Falsy values: false, 0, -0, '', null, undefined, NaN
  *
- * {{ 'Angular is great' | replace:'great':'awesome':'highlight':false }}
- * // Output: Angular is <span class="highlight">great</span>
+ * @param {unknown[]} value - The array to filter.
  *
- * <div [innerHTML]="'Angular is great' | replace:'great':'awesome':'highlight':false"></div>
- * // Renders: Angular is <span class="highlight">great</span>
+ * @returns {unknown[]} - A new array with only truthy values.
  *
- * @author Mofiro Jean
+ * @example
+ * {{ [0, 1, '', 'hello', null, true] | truthify }}   // [1, 'hello', true]
+ * {{ ['', 'a', '', 'b'] | truthify }}                 // ['a', 'b']
  */
-class ReplacePipe {
-    sanitizer = inject(DomSanitizer);
-    transform(value, pattern, replacement, highlightClass, isReplace = true) {
-        if (!value)
-            return '';
-        // handles empty string pattern
-        if (!pattern || (typeof pattern === 'string' && pattern.trim() === '')) {
-            return value;
-        }
-        const finalPattern = typeof pattern === 'string' ? new RegExp(pattern, 'gi') : pattern;
-        if (!highlightClass) {
-            return isReplace ? value.replace(finalPattern, replacement) : value;
-        }
-        // Sanitize the replacement to prevent XSS
-        const sanitizedReplacement = replacement.replace(/</g, '&lt;').replace(/>/g, '&gt;');
-        if (isReplace) {
-            const highlightedReplacement = `<span class="${highlightClass}">${sanitizedReplacement}</span>`;
-            const replaced = value.replace(finalPattern, highlightedReplacement);
-            return this.sanitizer.bypassSecurityTrustHtml(replaced);
+class TruthifyPipe {
+    transform(value) {
+        if (!Array.isArray(value)) {
+            return [];
         }
-        const highlightedMatch = `<span class="${highlightClass}">$&</span>`;
-        const result = value.replace(finalPattern, highlightedMatch);
-        return this.sanitizer.bypassSecurityTrustHtml(result);
+        return value.filter(Boolean);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ReplacePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: ReplacePipe, isStandalone: true, name: "replace" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TruthifyPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TruthifyPipe, isStandalone: true, name: "truthify" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ReplacePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TruthifyPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'replace',
-                    standalone: true
+                    name: 'truthify',
+                    standalone: true,
                 }]
         }] });
 
 /**
- * ReversePipe: Reverses the characters in a string.
+ * UniquePipe: Removes duplicate values from an array.
  *
- * @param {string} value - The string to reverse.
+ * Supports primitives, objects by property key, and deep nested keys via dot notation.
  *
- * @returns {string} - The reversed string (e.g., 'hello' → 'olleh').
+ * @param {unknown[]} value - The array to deduplicate.
+ * @param {string} [key] - Optional property path to compare objects by (e.g., 'id', 'user.email').
  *
- * @example
- * {{ 'hello' | reverse }} // Outputs: 'olleh'
- * {{ '12345' | reverse }} // Outputs: '54321'
- * <p>{{ userInput | reverse }}</p>
+ * @returns {unknown[]} - A new array with duplicates removed, preserving first occurrence.
  *
- * @author Mofiro Jean
+ * @example
+ * {{ [1, 2, 2, 3] | unique }}                  // [1, 2, 3]
+ * {{ users | unique:'email' }}                  // unique by email
+ * {{ orders | unique:'customer.email' }}        // unique by nested property
  */
-class ReversePipe {
-    transform(value) {
-        if (!value || typeof value !== 'string') {
-            return '';
+class UniquePipe {
+    transform(value, key) {
+        if (!Array.isArray(value)) {
+            return [];
         }
-        return value.split('').reverse().join('');
+        if (!key) {
+            return [...new Set(value)];
+        }
+        const seen = new Set();
+        return value.filter(item => {
+            const val = this.getNestedValue(item, key);
+            if (seen.has(val))
+                return false;
+            seen.add(val);
+            return true;
+        });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ReversePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: ReversePipe, isStandalone: true, name: "reverse" });
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: UniquePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: UniquePipe, isStandalone: true, name: "unique" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ReversePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: UniquePipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'reverse',
+                    name: 'unique',
                     standalone: true
                 }]
         }] });
 
 /**
- * SnakeCasePipe: Converts text to snake_case (e.g., "hello world" → "hello_world").
+ * WithoutPipe: Excludes specified elements from an array.
  *
- * @param {string} value - The input string to transform.
- * @returns {string} The string in snake_case, or an empty string if input is invalid.
+ * Supports primitives and objects by property key with dot notation.
  *
- * @example
- * ```html
- * {{ 'hello world' | snakeCase }} <!-- Outputs: hello_world -->
- * ```
+ * @param {unknown[]} value - The array to filter.
+ * @param {unknown[]} excludes - Values to exclude.
+ * @param {string} [key] - Optional property path for object comparison (supports dot notation).
  *
- * @author Mofiro Jean
+ * @returns {unknown[]} - A new array without the excluded elements.
+ *
+ * @example
+ * {{ [1, 2, 3, 4, 5] | without:[2, 4] }}                   // [1, 3, 5]
+ * {{ users | without:['banned']:'status' }}                  // active users
+ * {{ orders | without:['cancelled']:'meta.status' }}         // non-cancelled orders
  */
-class SnakeCasePipe {
-    transform(value) {
-        if (!value || typeof value !== 'string')
-            return '';
-        return value
-            .trim()
-            .replace(/([A-Z])/g, '_$1') // Convert camelCase to snake_case (e.g., helloWorld -> hello_World)
-            .toLowerCase() // Convert everything to lowercase
-            .replace(/[\s-]+/g, '_') // Replace spaces and hyphens with underscores
-            .replace(/[^a-z0-9_]+/g, '') // Remove all non-alphanumeric and non-underscore characters
-            .replace(/_+/g, '_') // Collapse multiple underscores
-            .replace(/^_|_$/g, ''); // Remove leading/trailing underscores
+class WithoutPipe {
+    transform(value, excludes, key) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        if (!Array.isArray(excludes) || excludes.length === 0) {
+            return [...value];
+        }
+        const excludeSet = new Set(excludes);
+        if (!key) {
+            return value.filter(item => !excludeSet.has(item));
+        }
+        return value.filter(item => {
+            const val = this.getNestedValue(item, key);
+            return !excludeSet.has(val);
+        });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: SnakeCasePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: SnakeCasePipe, isStandalone: true, name: "snakeCase" });
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: WithoutPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: WithoutPipe, isStandalone: true, name: "without" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: SnakeCasePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: WithoutPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'snakeCase',
-                    standalone: true
+                    name: 'without',
+                    standalone: true,
                 }]
         }] });
 
 /**
- * TextToSpeechPipe: Converts text to speech using the Web Speech API.
+ * SomePipe: Checks if at least one element in an array satisfies a condition.
  *
- * @param {string} value - The text to convert to speech.
- * @param {string} [lang='en-US'] - The language (local) for speech synthesis.
+ * Supports primitives (equality check) and objects by property key with dot notation.
  *
- * @returns {void} - Triggers speech synthesis (no return value).
+ * @param {unknown[]} value - The array to check.
+ * @param {unknown} match - The value to match against.
+ * @param {string} [key] - Optional property path to check (supports dot notation).
  *
- * @example
- * <div>{{ Hello World' | textToSpeech }}</div>
- * <div>{{ 'Bonjour' | textToSpeech:'fr-FR' }}h</div>
+ * @returns {boolean} - True if at least one element matches, false otherwise.
  *
- * @author Mofiro Jean
+ * @example
+ * {{ [false, false, true] | some:true }}                    // true
+ * {{ users | some:'admin':'role' }}                          // any admins?
+ * {{ orders | some:'failed':'meta.status' }}                 // any failures?
  */
-class TextToSpeechPipe {
-    transform(value, lang = 'en-US') {
-        if (!value || typeof window === 'undefined' || !window.speechSynthesis)
-            return;
-        const uttrance = new SpeechSynthesisUtterance(value);
-        uttrance.lang = lang;
-        window.speechSynthesis.speak(uttrance);
+class SomePipe {
+    transform(value, match, key) {
+        if (!Array.isArray(value) || value.length === 0) {
+            return false;
+        }
+        if (!key) {
+            return value.some(item => item === match);
+        }
+        return value.some(item => this.getNestedValue(item, key) === match);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TextToSpeechPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TextToSpeechPipe, isStandalone: true, name: "textToSpeech" });
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: SomePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: SomePipe, isStandalone: true, name: "some" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TextToSpeechPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: SomePipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'textToSpeech',
-                    standalone: true
+                    name: 'some',
+                    standalone: true,
                 }]
         }] });
 
 /**
- * TitleCasePipe: Capitalizes the first letter of each word in a string.
+ * UnionPipe: Combines two arrays, keeping only unique elements.
  *
- * @param {string} value - The input string to transform.
- * @returns {string} The string with each word capitalized, or an empty string if input is invalid.
+ * Supports primitives and objects by property key with dot notation.
+ *
+ * @param {unknown[]} value - The first array.
+ * @param {unknown[]} other - The second array.
+ * @param {string} [key] - Optional property path for uniqueness check (supports dot notation).
+ *
+ * @returns {unknown[]} - A merged array with duplicates removed.
  *
  * @example
- * ```html
- * {{ 'hello world' | titleCase }} <!-- Outputs: Hello World -->
- * ```
+ * {{ [1, 2, 3] | union:[3, 4, 5] }}                        // [1, 2, 3, 4, 5]
+ * {{ admins | union:editors:'id' }}                          // all unique users
+ * {{ local | union:remote:'meta.uuid' }}                     // merged records
  */
-class TitleCasePipe {
-    transform(value) {
-        if (!value || typeof value !== 'string')
-            return '';
-        return value
-            .split(' ')
-            .filter(word => word.length > 0)
-            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-            .join(' ');
+class UnionPipe {
+    transform(value, other, key) {
+        if (!Array.isArray(value) && !Array.isArray(other)) {
+            return [];
+        }
+        const first = Array.isArray(value) ? value : [];
+        const second = Array.isArray(other) ? other : [];
+        if (!key) {
+            const seen = new Set();
+            const result = [];
+            for (const item of [...first, ...second]) {
+                if (!seen.has(item)) {
+                    seen.add(item);
+                    result.push(item);
+                }
+            }
+            return result;
+        }
+        const seen = new Set();
+        const result = [];
+        for (const item of [...first, ...second]) {
+            const val = this.getNestedValue(item, key);
+            if (!seen.has(val)) {
+                seen.add(val);
+                result.push(item);
+            }
+        }
+        return result;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TitleCasePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TitleCasePipe, isStandalone: true, name: "titleCase" });
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: UnionPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: UnionPipe, isStandalone: true, name: "union" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TitleCasePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: UnionPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'titleCase',
-                    standalone: true
+                    name: 'union',
+                    standalone: true,
                 }]
         }] });
 
 /**
- * TruncatePipe: Truncates a string to a specified maximum length, optionally preserving words.
+ * FilterByPipe: Filters an array by matching a search term against object
+ properties.
  *
- * This Angular pipe transforms a string input by truncating it to the given `maxLength`.
- * It provides options to customize the ellipsis and preserve word boundaries.
+ * @param {unknown[]} value - The array to filter.
+ * @param {string} search - The search term.
+ * @param {string} [key] - Property to search in. If omitted, searches all string
+ properties.
  *
- * @param {string} value - The input string to be truncated.
- * @param {number} [maxLength=10] - The maximum length of the truncated string. Defaults to 10.
- * @param {string} [ellipsis='...'] - The string to append to the truncated portion. Defaults to '...'.
- * @param {boolean} [preserveWords=false] - If true, truncates at the last space before `maxLength` to avoid cutting words. Defaults to false.
- * @returns {string} - The truncated string. Returns an empty string if the input is null, undefined, or not a string.
+ * @returns {unknown[]} - Filtered array with matching items.
  *
  * @example
- * {{ 'This is a long sentence' | truncate }} // Returns 'This is a...'
- * {{ 'This is a long sentence' | truncate: 20 }} // Returns 'This is a long sente...'
- * {{ 'This is a long sentence' | truncate: 15: ' [more]' }} // Returns 'This is a long [more]'
- * {{ 'This is a long sentence' | truncate: 15: '...' : true }} // Returns 'This is a...'
- * {{ 'This is a long sentence' | truncate: 20: '...' : true }} // Returns 'This is a long...'
- * {{ null | truncate }} // Returns ''
- * {{ undefined | truncate }} // Returns ''
- *
- * @author Mofiro Jean
+ * {{ users | filterBy:'alice':'name' }}     // users with 'alice' in name
+ * {{ users | filterBy:'admin':'role' }}     // users with role 'admin'
+ * {{ users | filterBy:'bob' }}              // search all properties for 'bob'
  */
-class TruncatePipe {
-    transform(value, maxLength = 10, ellipsis = '...', preserveWords = false) {
-        if (!value || typeof value !== 'string') {
-            return '';
+class FilterByPipe {
+    transform(value, search, key) {
+        if (!Array.isArray(value) || !search) {
+            return Array.isArray(value) ? [...value] : [];
         }
-        if (value.length <= maxLength) {
-            return value;
-        }
-        const charsToKeep = maxLength - ellipsis.length;
-        // If maxLength is too small to even include the ellipsis, just return the ellipsis.
-        if (charsToKeep < 0) {
-            return ellipsis;
+        const term = String(search).toLowerCase();
+        if (key) {
+            return value.filter(item => {
+                const val = this.getNestedValue(item, key);
+                return val !== undefined && val !== null
+                    && String(val).toLowerCase().includes(term);
+            });
         }
-        let truncated = value.substring(0, charsToKeep);
-        if (preserveWords) {
-            const lastSpaceIndex = truncated.lastIndexOf(' ');
-            // If a space is found and it's not the very beginning of the string
-            if (lastSpaceIndex !== -1 && lastSpaceIndex !== 0) {
-                truncated = truncated.substring(0, lastSpaceIndex);
+        return value.filter(item => {
+            if (typeof item === 'object' && item !== null) {
+                return this.searchObject(item, term);
             }
-        }
-        return truncated.trim() + ellipsis;
+            return String(item).toLowerCase().includes(term);
+        });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TruncatePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: TruncatePipe, isStandalone: true, name: "truncate" });
+    searchObject(obj, term) {
+        return Object.values(obj).some(val => {
+            if (typeof val === 'string') {
+                return val.toLowerCase().includes(term);
+            }
+            if (typeof val === 'number' || typeof val === 'boolean') {
+                return String(val).toLowerCase().includes(term);
+            }
+            if (typeof val === 'object' && val !== null) {
+                return this.searchObject(val, term);
+            }
+            return false;
+        });
+    }
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, segment) => current?.[segment], obj);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: FilterByPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.3", ngImport: i0, type: FilterByPipe, isStandalone: true, name: "filterBy" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: TruncatePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: FilterByPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'truncate',
-                    standalone: true
+                    name: 'filterBy',
+                    standalone: true,
                 }]
         }] });
 
+// Text
 const ALL_PIPES = [
+    // Text
     AsciiArtPipe,
-    BarcodePipe,
     CamelCasePipe,
-    ColorConvertPipe,
-    CreditCardMaskPipe,
-    DeviceTypePipe,
-    EmailMaskPipe,
-    GravatarPipe,
     HighlightPipe,
-    HtmlEscapePipe,
-    HtmlSanitizePipe,
     InitialsPipe,
-    IpAddressMaskPipe,
-    JsonPrettyPipe,
     KebabCasePipe,
     MorseCodePipe,
-    QrCodePipe,
     ReplacePipe,
-    ReversePipe,
     SnakeCasePipe,
-    TextToSpeechPipe,
     TitleCasePipe,
     TruncatePipe,
-    CountPipe
+    // Security & Privacy
+    CreditCardMaskPipe,
+    EmailMaskPipe,
+    HtmlEscapePipe,
+    HtmlSanitizePipe,
+    IpAddressMaskPipe,
+    // Media & Visual
+    BarcodePipe,
+    ColorConvertPipe,
+    GravatarPipe,
+    QrCodePipe,
+    // Data & Utility
+    CountPipe,
+    DeviceTypePipe,
+    JsonPrettyPipe,
+    TextToSpeechPipe,
+    TimeAgoPipePipe,
+    // Array
+    ChunkPipe,
+    DiffPipe,
+    EveryPipe,
+    IntersectionPipe,
+    Flatten,
+    GroupByPipe,
+    InitialPipe,
+    OrderByPipe,
+    PluckPipe,
+    RangePipe,
+    ReversePipe,
+    SamplePipe,
+    ShufflePipe,
+    TailPipe,
+    TruthifyPipe,
+    UniquePipe,
+    WithoutPipe,
+    SomePipe,
+    UnionPipe,
+    FilterByPipe
 ];
 
+// Text
+
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { ALL_PIPES, AsciiArtPipe, BarcodePipe, CamelCasePipe, ColorConvertPipe, CountPipe, CreditCardMaskPipe, DeviceTypePipe, EmailMaskPipe, GravatarPipe, HighlightPipe, HtmlEscapePipe, HtmlSanitizePipe, InitialsPipe, IpAddressMaskPipe, JsonPrettyPipe, KebabCasePipe, MorseCodePipe, QrCodePipe, ReplacePipe, ReversePipe, SnakeCasePipe, TextToSpeechPipe, TitleCasePipe, TruncatePipe };
+export { ALL_PIPES, AsciiArtPipe, BarcodePipe, CamelCasePipe, ChunkPipe, ColorConvertPipe, CountPipe, CreditCardMaskPipe, DeviceTypePipe, DiffPipe, EmailMaskPipe, EveryPipe, FilterByPipe, Flatten, GravatarPipe, GroupByPipe, HighlightPipe, HtmlEscapePipe, HtmlSanitizePipe, InitialPipe, InitialsPipe, IntersectionPipe, IpAddressMaskPipe, JsonPrettyPipe, KebabCasePipe, MorseCodePipe, OrderByPipe, PluckPipe, QrCodePipe, RangePipe, ReplacePipe, ReversePipe, SamplePipe, ShufflePipe, SnakeCasePipe, SomePipe, TailPipe, TextToSpeechPipe, TimeAgoPipePipe, TitleCasePipe, TruncatePipe, TruthifyPipe, UnionPipe, UniquePipe, WithoutPipe };
 //# sourceMappingURL=ngx-transforms.mjs.map