ngx-transforms 0.0.1

package/types/ngx-transforms.d.ts

@@ -0,0 +1,658 @@
+import * as i0 from '@angular/core';
+import { PipeTransform, Provider } from '@angular/core';
+import { AsciiConfig, TextToAsciiOptions } from 'ts-ascii-engine';
+export { CharsetPreset } from 'ts-ascii-engine';
+import { SafeHtml, SafeResourceUrl } from '@angular/platform-browser';
+import * as QRCode from 'qrcode';
+
+/**
+ * Configuration options for ASCII art generation
+ */
+interface AsciiArtOptions extends Partial<AsciiConfig> {
+    /**
+     * Text rendering options (only used when converting text to ASCII)
+     */
+    textOptions?: TextToAsciiOptions;
+    /**
+     * Return format: 'html' returns formatted HTML, 'text' returns plain text
+     * @default 'html'
+     */
+    format?: 'html' | 'text';
+}
+/**
+ * AsciiArtPipe: Converts text into ASCII art using ts-ascii-engine.
+ *
+ * This pipe leverages the high-performance ts-ascii-engine library to convert
+ * text into visually appealing ASCII art with various customization options.
+ *
+ * @param {string} value - The text to convert to ASCII art.
+ * @param {AsciiArtOptions} [options] - Configuration options for ASCII generation.
+ *
+ * @returns {string} - The ASCII art as HTML or plain text based on format option.
+ *
+ * @security
+ * The pipe returns HTML by default. When using with [innerHTML], Angular's
+ * DomSanitizer automatically sanitizes the output. For additional safety,
+ * you can explicitly sanitize:
+ * ```typescript
+ * import { DomSanitizer } from '@angular/platform-browser';
+ * this.safeHtml = this.sanitizer.sanitize(SecurityContext.HTML, asciiOutput);
+ * ```
+ *
+ * @performance
+ * - The AsciiGenerator instance is reused across transformations for optimal performance
+ * - Use smaller charset and width values for faster rendering
+ * - Consider format: 'text' for simple use cases (faster than HTML formatting)
+ * - The library is optimized with typed arrays and minimal garbage collection
+ *
+ * @example
+ * // Basic usage with default options
+ * {{ 'HELLO' | asciiArt }}
+ *
+ * @example
+ * // Custom charset and width
+ * {{ 'CODE' | asciiArt:{ charset: CharsetPreset.BLOCK, width: 60 } }}
+ *
+ * @example
+ * // Plain text output
+ * {{ 'ASCII' | asciiArt:{ format: 'text' } }}
+ *
+ * @example
+ * // Advanced text rendering with custom font
+ * {{ 'WELCOME' | asciiArt:{
+ *   charset: CharsetPreset.STANDARD,
+ *   width: 80,
+ *   textOptions: {
+ *     font: 'Arial',
+ *     fontSize: 72,
+ *     fontWeight: 'bold'
+ *   }
+ * }}}
+ *
+ * @example
+ * // With inverted colors
+ * {{ 'DARK' | asciiArt:{ inverted: true, charset: CharsetPreset.MINIMAL } }}
+ *
+ * @author Mofiro Jean
+ */
+declare class AsciiArtPipe implements PipeTransform {
+    private generator;
+    constructor();
+    transform(value: string, options?: AsciiArtOptions): string;
+    /**
+     * Escapes HTML special characters to prevent XSS
+     * @private
+     */
+    private escapeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AsciiArtPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<AsciiArtPipe, "asciiArt", true>;
+}
+
+/**
+ * BarcodeElementType: Defines the type of element to render the barcode.
+ *
+ * @typedef {'svg' | 'img' | 'canvas'} BarcodeElementType
+ */
+type BarcodeElementType = 'svg' | 'img' | 'canvas';
+/**
+ * BarcodeFormat: Defines supported barcode formats.
+ *
+ * @typedef {'CODE128' | 'EAN13' | 'CODE39'} BarcodeFormat
+ */
+type BarcodeFormat = 'CODE128' | 'EAN13' | 'CODE39';
+/**
+ * BarcodeOptions: Configuration options for barcode generation.
+ *
+ * @interface BarcodeOptions
+ * @property {BarcodeElementType} [elementType='svg'] - Output type (svg, img, canvas).
+ * @property {BarcodeFormat} [format='CODE128'] - Barcode format.
+ * @property {number} [width=2] - Bar width in pixels.
+ * @property {number} [height=100] - Barcode height in pixels.
+ * @property {string} [lineColor='#000000'] - Color of bars.
+ * @property {boolean} [displayValue=true] - Show value below barcode.
+ */
+interface BarcodeOptions {
+    elementType?: BarcodeElementType;
+    format?: BarcodeFormat;
+    width?: number;
+    height?: number;
+    lineColor?: string;
+    displayValue?: boolean;
+}
+/**
+ * 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
+ */
+declare class BarcodePipe implements PipeTransform {
+    private sanitizer;
+    transform(value: string, options?: BarcodeOptions): Promise<SafeHtml | SafeResourceUrl | ''>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BarcodePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<BarcodePipe, "barcode", true>;
+}
+
+/**
+ * CamelCasePipe: Converts text to camelCase (e.g., "hello world" → "helloWorld").
+ *
+ * @param {string} value - The input string to transform.
+ * @returns {string} The string in camelCase, or an empty string if input is invalid.
+ *
+ * @example
+ * ```html
+ * {{ 'hello world' | camelCase }} <!-- Outputs: helloWorld -->
+ * ```
+ *
+ * @author Mofiro Jean
+ */
+declare class CamelCasePipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CamelCasePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<CamelCasePipe, "camelCase", true>;
+}
+
+/**
+ * ColorTargetType: Defines the target color format for conversion.
+ *
+ * @typedef {'hex' | 'rgb' | 'rgba'} ColorTargetType
+ *
+ * @description
+ * Specifies the output format for color conversion:
+ * - 'hex': Hexadecimal format (#RRGGBB or #RRGGBBAA)
+ * - 'rgb': RGB format rgb(r, g, b)
+ * - 'rgba': RGBA format rgba(r, g, b, a)
+ */
+type ColorTargetType = 'hex' | 'rgb' | 'rgba';
+/**
+ * ColorConvertPipe: Converts colors between HEX, RGB, and RGBA formats.
+ *
+ * @description
+ * A versatile color conversion pipe that supports multiple input formats
+ * and can convert to hex, rgb, or rgba output formats.
+ *
+ * **Supported Input Formats:**
+ * - 3-digit HEX: #RGB (e.g., #F00)
+ * - 4-digit HEX with alpha: #RGBA (e.g., #F00F)
+ * - 6-digit HEX: #RRGGBB (e.g., #FF0000)
+ * - 8-digit HEX with alpha: #RRGGBBAA (e.g., #FF0000FF)
+ * - RGB: rgb(r, g, b) with flexible whitespace
+ * - RGBA: rgba(r, g, b, a) with flexible whitespace
+ *
+ * **Output Formats:**
+ * - 'hex': Returns #RRGGBB or #RRGGBBAA (if alpha < 1)
+ * - 'rgb': Returns rgb(r, g, b) - alpha is discarded
+ * - 'rgba': Returns rgba(r, g, b, a)
+ *
+ * @param {string} value - The input color string
+ * @param {ColorTargetType} target - The desired output format
+ * @returns {string} The converted color string, or original value if invalid
+ *
+ * @example
+ * // Basic conversions
+ * {{ '#FF0000' | colorConvert:'rgb' }}      // rgb(255, 0, 0)
+ * {{ 'rgb(0, 255, 0)' | colorConvert:'hex' }} // #00FF00
+ *
+ * @example
+ * // Short hex support
+ * {{ '#F00' | colorConvert:'rgb' }}         // rgb(255, 0, 0)
+ *
+ * @example
+ * // Alpha channel support
+ * {{ '#FF000080' | colorConvert:'rgba' }}   // rgba(255, 0, 0, 0.5)
+ * {{ 'rgba(255, 0, 0, 0.5)' | colorConvert:'hex' }} // #FF000080
+ *
+ * @author Mofiro Jean
+ */
+declare class ColorConvertPipe implements PipeTransform {
+    transform(value: string, target: ColorTargetType): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ColorConvertPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ColorConvertPipe, "colorConvert", true>;
+}
+
+declare class CountPipe implements PipeTransform {
+    transform(value: any): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CountPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<CountPipe, "count", 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
+ *
+ * @author Mofiro Jean
+ */
+declare class CreditCardMaskPipe implements PipeTransform {
+    transform(value: string | null | undefined, shouldMask?: boolean): string | null | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CreditCardMaskPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<CreditCardMaskPipe, "creditCardMask", true>;
+}
+
+/**
+ * DeviceType: Defines the type of element to render the QR code.
+ *
+ * @typedef {'mobile' | 'tablet' | 'desktop' | 'unknown'} DeviceType
+ *
+ * @description
+ * This type specifies the type of device in which the program is currently running on.
+ * - 'mobile': Indicates that the device is mobile.
+ * - 'tablet': Indicates that the device is a tablet.
+ * - 'desktop': Indicates that the device is a desktop.
+ * - 'unknown': Indicates an invalid or empty input.
+ */
+type DeviceType = 'mobile' | 'tablet' | 'desktop' | 'unknown';
+/**
+ * DeviceTypePipe: Detects the device type based on the user agent string.
+ *
+ * @param {string} value - The user agent string (defaults to navigator.userAgent).
+ *
+ * @returns {'mobile' | 'tablet' | 'desktop' | 'unknown'} - The detected device type.
+ *
+ * @example
+ * {{ '' | device }} // Outputs: 'mobile' (on a mobile device)
+ * <div *ngIf="'' | device === 'desktop'">Desktop-only content</div>
+ */
+declare class DeviceTypePipe implements PipeTransform {
+    transform(value?: string): DeviceType;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DeviceTypePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<DeviceTypePipe, "device", 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 ''
+ *
+ * @author Mofiro Jean
+ */
+declare class EmailMaskPipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EmailMaskPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<EmailMaskPipe, "emailMask", 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" />
+ *
+ * @author Mofiro Jean
+ */
+declare class GravatarPipe implements PipeTransform {
+    transform(value: string, size?: number): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GravatarPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<GravatarPipe, "gravatar", true>;
+}
+
+/**
+ * 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 ''
+ *
+ * @author Mofiro Jean
+ */
+declare class HighlightPipe implements PipeTransform {
+    private sanitizer;
+    transform(value: string, searchTerm: string): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HighlightPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<HighlightPipe, "highlight", 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; -->
+ * ```
+ */
+declare class HtmlEscapePipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HtmlEscapePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<HtmlEscapePipe, "htmlEscape", 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) -->
+ * ```
+ */
+declare class HtmlSanitizePipe implements PipeTransform {
+    private sanitizer;
+    transform(value: string): SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HtmlSanitizePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<HtmlSanitizePipe, "htmlSanitize", true>;
+}
+
+/**
+ * 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
+ *
+ * @author Mofiro Jean
+ */
+declare class InitialsPipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InitialsPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<InitialsPipe, "initials", 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.*.*
+ *
+ * @author Mofiro Jean
+ */
+declare class IpAddressMaskPipe implements PipeTransform {
+    transform(value: string, shouldMask?: boolean): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IpAddressMaskPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<IpAddressMaskPipe, "ipAddressMask", true>;
+}
+
+/**
+ * JsonPrettyPipe: Formats JSON data with indentation and syntax highlighting.
+ *
+ * @param {string | object} value - The JSON string or object to format.
+ * @param {number} [spaces=2] - Number of spaces for indentation.
+ *
+ * @returns {SafeHtml} - Formatted HTML with color-coded JSON.
+ *
+ * @example
+ * {{ '{"name": "John", "age": 30}' | jsonPretty }} // Outputs: Colorful, indented JSON
+ * <pre [innerHTML]="data | jsonPretty:4"></pre> // 4-space indentation
+ *
+ * @author Mofiro Jean
+ */
+declare class JsonPrettyPipe implements PipeTransform {
+    private sanitizer;
+    transform(value: string | object, spaces?: number, highlightProperty?: string | null): SafeHtml;
+    private highlightJson;
+    static ɵfac: i0.ɵɵFactoryDeclaration<JsonPrettyPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<JsonPrettyPipe, "jsonPretty", true>;
+}
+
+/**
+ * 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 -->
+ * ```
+ *
+ * @author Mofiro Jean
+ */
+declare class KebabCasePipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<KebabCasePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<KebabCasePipe, "kebabCase", true>;
+}
+
+/**
+ * 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>
+ *
+ * @author Mofiro Jean
+ */
+declare class MorseCodePipe implements PipeTransform {
+    private readonly morseCodeMap;
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MorseCodePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<MorseCodePipe, "morseCode", true>;
+}
+
+/**
+ * QrCodePipe: Generates a QR code from a string.
+ *
+ * @param {string} value - The string to encode.
+ * @param {QRCode.QRCodeToDataURLOptions} [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" />
+ *
+ * @author Mofiro Jean
+ */
+declare class QrCodePipe implements PipeTransform {
+    transform(value: string, options?: QRCode.QRCodeToDataURLOptions): Promise<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<QrCodePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<QrCodePipe, "qrCode", true>;
+}
+
+/**
+ * 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.
+ *
+ * @example
+ * {{ 'Hello World' | replace:'World':'Universe' }}
+ * // Output: Hello Universe
+ *
+ * {{ 'test123' | replace:/\d+/g:'X':'highlight' }}
+ * // Output: test<span class="highlight">X</span>
+ *
+ * {{ 'Angular is great' | replace:'great':'awesome':'highlight':true }}
+ * // Output: Angular is <span class="highlight">awesome</span>
+ *
+ * {{ 'Angular is great' | replace:'great':'awesome':'highlight':false }}
+ * // Output: Angular is <span class="highlight">great</span>
+ *
+ * <div [innerHTML]="'Angular is great' | replace:'great':'awesome':'highlight':false"></div>
+ * // Renders: Angular is <span class="highlight">great</span>
+ *
+ * @author Mofiro Jean
+ */
+declare class ReplacePipe implements PipeTransform {
+    private sanitizer;
+    transform(value: string, pattern: string | RegExp, replacement: string, highlightClass?: string, isReplace?: boolean): string | SafeHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReplacePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ReplacePipe, "replace", true>;
+}
+
+/**
+ * ReversePipe: Reverses the characters in a string.
+ *
+ * @param {string} value - The string to reverse.
+ *
+ * @returns {string} - The reversed string (e.g., 'hello' → 'olleh').
+ *
+ * @example
+ * {{ 'hello' | reverse }} // Outputs: 'olleh'
+ * {{ '12345' | reverse }} // Outputs: '54321'
+ * <p>{{ userInput | reverse }}</p>
+ *
+ * @author Mofiro Jean
+ */
+declare class ReversePipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReversePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ReversePipe, "reverse", 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 -->
+ * ```
+ *
+ * @author Mofiro Jean
+ */
+declare class SnakeCasePipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SnakeCasePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SnakeCasePipe, "snakeCase", 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).
+ *
+ * @example
+ * <div>{{ Hello World' | textToSpeech }}</div>
+ * <div>{{ 'Bonjour' | textToSpeech:'fr-FR' }}h</div>
+ *
+ * @author Mofiro Jean
+ */
+declare class TextToSpeechPipe implements PipeTransform {
+    transform(value: string, lang?: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TextToSpeechPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<TextToSpeechPipe, "textToSpeech", 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 -->
+ * ```
+ */
+declare class TitleCasePipe implements PipeTransform {
+    transform(value: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TitleCasePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<TitleCasePipe, "titleCase", 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 ''
+ *
+ * @author Mofiro Jean
+ */
+declare class TruncatePipe implements PipeTransform {
+    transform(value: string, maxLength?: number, ellipsis?: string, preserveWords?: boolean): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TruncatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<TruncatePipe, "truncate", true>;
+}
+
+declare const ALL_PIPES: Provider[];
+
+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 type { AsciiArtOptions, BarcodeElementType, BarcodeFormat, BarcodeOptions, ColorTargetType, DeviceType };