ets-fe-ng-sdk 19.0.116 → 20.0.0

package/lib/Services/utility.service.d.ts

@@ -1,989 +0,0 @@
-import { CurrencyPipe, DatePipe, DecimalPipe, Location, TitleCasePipe } from '@angular/common';
-import { ResourceRef } from '@angular/core';
-import { MatDialog as MatDialog, MatDialogConfig as MatDialogConfig } from '@angular/material/dialog';
-import { MatSnackBar as MatSnackBar } from '@angular/material/snack-bar';
-import { Title } from '@angular/platform-browser';
-import { Router, NavigationExtras, ActivatedRoute } from '@angular/router';
-import { ETSReactiveFormInputService as IS1 } from './input.service';
-import jfd from 'js-file-download';
-import { PageLoaderService } from './page-loader.service';
-import { Config } from '../configs/index.config';
-import { AppRouteBase } from '../Shared/models/RouteItem.class';
-import { EValidationType, IStrictFormGroup, Status, TableCol } from '../Shared/models/index.model';
-import { PageService } from './page.service';
-import { AbstractControl, AsyncValidatorFn, FormArray, FormControl, FormControlOptions, FormGroup, UntypedFormArray, ValidatorFn } from '@angular/forms';
-import { LoggerService } from '../Reusables/reusable-pages/logger/logger.service';
-import { Observable, ReplaySubject, Subscription } from 'rxjs';
-import { EETSPageBtnID } from '../Shared/models/IMenuItem';
-import { SDKEnvironment } from '../Shared/models/environment.model';
-import { BreakpointObserver } from '@angular/cdk/layout';
-import { DebouncerService } from './debouncer.service';
-import { IFormSchema } from '../Shared/components/form-generator/form-generator.component';
-import { IInfoDialogBtn } from '../Shared/components/info-dialog/info-dialog.component';
-import { ToastNotificationsService } from '@serene-dev/toast-notifications';
-import { ErrorReporterService } from './error-reporter.service';
-import { ObjectSizeService } from './object-size.service';
-import { NumberFormatService } from './number-format.service';
-import * as i0 from "@angular/core";
-/**
- * A comprehensive utility service that provides various helper functions and services for Angular applications.
- * This service includes functionality for form handling, date formatting, file operations, and more.
- *
- * @template TEnvironment - The type of environment configuration to use, defaults to SDKEnvironment
- */
-export declare class UtilityService<TEnvironment extends SDKEnvironment = SDKEnvironment> {
-    /** Angular Material Dialog service for managing dialogs */
-    readonly dialog: MatDialog;
-    /** Angular Material SnackBar service for displaying notifications */
-    readonly snackBar: MatSnackBar;
-    /** Angular Router service for navigation */
-    readonly router: Router;
-    /** Angular Title service for managing page titles */
-    readonly titleS: Title;
-    /** Angular Location service for browser location management */
-    readonly location: Location;
-    /** Service for handling form input operations */
-    readonly inputService: IS1<any, any>;
-    /** Service for managing page loading states */
-    readonly pS: PageLoaderService;
-    /** Angular CurrencyPipe for currency formatting */
-    readonly currencyPipe: CurrencyPipe;
-    /** Angular TitleCasePipe for text case transformation */
-    readonly titleCasePipe: TitleCasePipe;
-    /** Service for logging operations */
-    readonly loggerService: LoggerService;
-    /** Service for error reporting */
-    readonly errorReporterService: ErrorReporterService;
-    /** Service for page-related operations */
-    readonly pageS: PageService;
-    /** Service for responsive design breakpoint observation */
-    readonly responsive: BreakpointObserver;
-    /** Angular DatePipe for date formatting */
-    readonly datePipe: DatePipe;
-    /** Service for number formatting operations */
-    readonly numberFormatService: NumberFormatService;
-    /** Service for debouncing operations */
-    readonly debouncerService: DebouncerService;
-    /** Angular DecimalPipe for decimal number formatting */
-    readonly numberPipe: DecimalPipe;
-    /** Service for calculating object sizes */
-    readonly objectSizeService: ObjectSizeService;
-    /** Service for toast notifications */
-    readonly toastNotificationService: ToastNotificationsService;
-    /** Base route configuration */
-    r: AppRouteBase;
-    /** File downloader utility using js-file-download */
-    downloader: typeof jfd;
-    /** Enum for validation types */
-    eValidationType: typeof EValidationType;
-    /** Application configuration */
-    config: typeof Config;
-    /** Current environment configuration */
-    environment: TEnvironment;
-    /** Enum for page button IDs */
-    pbid: typeof EETSPageBtnID;
-    /** jQuery reference */
-    $: any;
-    /** Flag indicating if the current device is mobile */
-    isMobile: boolean;
-    /** Emits true if the device is mobile */
-    mobileQueryChanged: ReplaySubject<boolean>;
-    /** Signal that emits true when the device is a mobile handset */
-    readonly isMobileSignal: import("@angular/core").Signal<boolean>;
-    /** Signal that emits true when the device is a tablet */
-    readonly isTabletSignal: import("@angular/core").Signal<boolean>;
-    /** Signal that emits true when the device is a desktop */
-    readonly isDesktopSignal: import("@angular/core").Signal<boolean>;
-    /** Available options for page size in paginated views */
-    pageSizeOptions: number[];
-    /** Date pipe format for full date display */
-    datePipeDate: string;
-    /** Date pipe format for compact date display */
-    datePipeDateLean: string;
-    /** Date pipe format for compact date and time display */
-    datePipeDateTimeLean: string;
-    /** Field name used for custom ID tracking */
-    readonly customIDField = "__id";
-    /** Delimiter used for string operations */
-    readonly delimiter = "~~~//~~~";
-    /** Non-nullable form builder instance */
-    formBuilder: import("@angular/forms").NonNullableFormBuilder;
-    constructor();
-    /**
-     * Creates a form control configuration array for use with FormBuilder
-     * @param value - Initial value for the control
-     * @param validatorOrOpts - Validators or options for the control
-     * @param asyncValidator - Async validators for the control
-     * @returns Array containing value, validators, and async validators
-     * @template T - Type of the form control value
-     */
-    formControl: <T>(value?: T | null, validatorOrOpts?: ValidatorFn | ValidatorFn[] | FormControlOptions, asyncValidator?: AsyncValidatorFn | AsyncValidatorFn[]) => (ValidatorFn | ValidatorFn[] | AsyncValidatorFn | AsyncValidatorFn[] | FormControlOptions | T)[];
-    /**
-     * Navigates back to the previous page using Angular's Location service
-     */
-    back: () => void;
-    /**
-     * Shortcut for toast notifications
-     */
-    readonly toast: {
-        add: (item: import("@serene-dev/toast-notifications").IAddToastNotification) => {
-            id: string;
-            update: (update: Partial<import("@serene-dev/toast-notifications").IAddToastNotification>) => void;
-            close: () => void;
-            loader: {
-                play: () => void;
-                stop: () => void;
-            };
-            closed: import("rxjs").Subject<{
-                manuallyClosed: boolean;
-            }>;
-        };
-        close: (id: string, manualDismissal: boolean) => void;
-        update: (id: string, item: Partial<import("@serene-dev/toast-notifications").IAddToastNotification>) => void;
-    };
-    /**
-     * Utility to calculate approximate size of an object
-     */
-    readonly roughSizeOfObject: (object: any, maxSize?: number) => {
-        bytes?: number;
-        crossedMaxSize?: boolean;
-    };
-    /**
-     * Ensures only one input from a group can be active at a time.
-     * When one input has a value, all others are disabled.
-     * @param inputs - Array of form controls to manage
-     * @returns Subscription that can be used to unsubscribe from the input changes
-     * @example
-     * // Create form controls
-     * const nameControl = new FormControl('');
-     * const idControl = new FormControl('');
-     * const emailControl = new FormControl('');
-     *
-     * // Make them mutually exclusive
-     * const subscription = utilityService.onlyOneInput([nameControl, idControl, emailControl]);
-     *
-     * // Later, unsubscribe when done
-     * subscription.unsubscribe();
-     */
-    onlyOneInput(inputs: FormControl[]): Subscription;
-    /**
-     * Copies a payload to clipboard in debug mode
-     * @param payload - Data to be copied to clipboard
-     * @example
-     * // Copy API response to clipboard in debug mode
-     * utilityService.copyPayload(apiResponse);
-     */
-    copyPayload(payload: any): Promise<void>;
-    /**
-     * Returns the value x if it's not null or undefined, otherwise returns y
-     * @param x - Primary value to return if not null/undefined
-     * @param y - Default value to return if x is null/undefined (defaults to '-')
-     * @returns x if not null/undefined, otherwise y
-     * @example
-     * // Returns "User" since the value exists
-     * utilityService.xOrY("User", "Guest"); // "User"
-     *
-     * // Returns "-" (default fallback) since value is null
-     * utilityService.xOrY(null); // "-"
-     *
-     * // Returns "N/A" (custom fallback) since value is undefined
-     * utilityService.xOrY(undefined, "N/A"); // "N/A"
-     */
-    xOrY: (x: any, y?: string) => string;
-    /**
-     * Converts text to title case using Angular's TitleCasePipe
-     * @param text - Text to convert to title case
-     * @returns Text in title case format
-     * @example
-     * utilityService.toTitleCase("hello world"); // "Hello World"
-     * utilityService.toTitleCase("USER_PROFILE"); // "User Profile"
-     */
-    toTitleCase(text: string): string;
-    /**
-     * Convert Date string to Date Time string
-     * @param dateStr - Date string
-     * @param config - Configuration for the conversion
-     * @returns Returns a Date Time string
-     * @example
-     * // Basic conversion with default time (00:00:00Z)
-     * utilityService.dateToDateTime('2022-01-25'); // '2022-01-25T00:00:00Z'
-     *
-     * // With custom time
-     * utilityService.dateToDateTime('2022-01-25', { time: '14:30:00Z' }); // '2022-01-25T14:30:00Z'
-     *
-     * // Without T separator
-     * utilityService.dateToDateTime('2022-01-25', { omitT: true }); // '2022-01-25 00:00:00'
-     */
-    dateToDateTime: (dateStr: string, config?: {
-        /**
-         * Use the yyyy-mm-dd hh:mm:ss format
-         */
-        omitT?: boolean;
-        /**Time to append to date. @example `12:00:00Z` */
-        time?: string;
-    }) => string;
-    /**
-     * Set an Object's field if the object exists or don't if the object doesn't
-     * @param obj - Object holding the field
-     * @param kvps - Partial<T> object containing the field and its value
-     * @returns Returns the object holding the data
-     * @example
-     * const user = { name: 'John', age: 30 };
-     *
-     * // Update user's age and add a new field
-     * utilityService.setterWithNull(user, { age: 31, role: 'Admin' });
-     * // user is now { name: 'John', age: 31, role: 'Admin' }
-     *
-     * // Returns null if object is null
-     * utilityService.setterWithNull(null, { name: 'Test' }); // null
-     */
-    setterWithNull<T>(obj: T, kvps: Partial<T>): T;
-    /**
-     * (Set an Object's field if the object exists or don't if the object doesn't) for multiple entries
-     * @param items - Array of objects and their modifications
-     */
-    setterWithNullArray<T>(items: {
-        obj: T;
-        kvps: Partial<T>;
-    }[]): void;
-    /**
-     * Handles the deletion of rows from a FormArray
-     * @param index - Index of the row to delete
-     * @param fa - The FormArray that holds the rows
-     * @param deleteService - The deletion service to be called (It should be an anonymous function)
-     * @param addRowFunc - The function (anonymous) that adds a new row to the FormArray
-     * @param extraConfig - Optional configuration for the deletion operation
-     * @returns Promise that resolves after deletion is complete
-     * @example
-     * // Delete a row from a form array of addresses
-     * const deleteAddress = (id) => this.apiService.deleteAddress(id);
-     * const addNewAddress = () => this.addressesFormArray.push(this.createAddressFormGroup());
-     *
-     * utilityService.handleFormRowDelete(
-     *   2, // Delete the third row (index 2)
-     *   this.addressesFormArray,
-     *   deleteAddress,
-     *   addNewAddress,
-     *   {
-     *     dontEmitEvent: true,
-     *     onDelete: (response) => console.log('Address deleted', response)
-     *   }
-     * );
-     */
-    handleFormRowDelete: (index: number, fa: UntypedFormArray, deleteService: (...args: any) => Promise<any> | Observable<any>, addRowFunc: (...args: any) => any, extraConfig?: {
-        dontEmitEvent?: boolean;
-        onDelete?: (res: any) => any;
-    }) => Promise<any>;
-    /**
-     * Opens an HTML element in fullscreen mode
-     * @param elem - HTML element to display in fullscreen
-     * @param metadata - Optional metadata to pass to the onLeave callback
-     * @param onLeave - Optional callback function when leaving fullscreen mode
-     * @example
-     * // Open an image viewer in fullscreen
-     * const imageViewer = document.getElementById('image-viewer');
-     * const imageData = { id: '123', url: 'https://example.com/image.jpg' };
-     *
-     * utilityService.openHTMLInFullscreen(
-     *   imageViewer,
-     *   imageData,
-     *   (data) => console.log('Left fullscreen view of image:', data.id)
-     * );
-     */
-    openHTMLInFullscreen<TMetadata>(elem: HTMLElement, metadata?: TMetadata, onLeave?: (metadata: TMetadata) => any): void;
-    /**
-     * Exits fullscreen mode
-     * @example
-     * // Exit fullscreen when a button is clicked
-     * closeButton.addEventListener('click', () => {
-     *   utilityService.closeFullscreen();
-     * });
-     */
-    closeFullscreen(): void;
-    /**
-     * Adds subscriptions to be automatically closed when navigating away
-     * @param sub - Subscriptions to be closed
-     * @example
-     * const dataSub = this.dataService.getData().subscribe(data => this.data = data);
-     * const statusSub = this.statusService.getStatus().subscribe(status => this.status = status);
-     *
-     * // These subscriptions will be automatically unsubscribed when navigating to another route
-     * this.utilityService.addToSubsToCloseOnRoute(dataSub, statusSub);
-     */
-    addToSubsToCloseOnRoute: (...sub: Subscription[]) => void;
-    /**
-     * Clears all subscriptions that were added to be closed on route change
-     */
-    clearSubsToCloseOnRoute: () => void;
-    /**
-     * Handles the deletion of rows from an array
-     * @param index - Index of the row to delete
-     * @param arr - The array that holds the rows
-     * @param deleteService - The deletion service to be called (It should be an anonymous function)
-     * @param addRowFunc - The function (anonymous) that adds a new row to the array
-     * @param cb - The function to callback with the response of the deletion service as the input parameter
-     */
-    handleRowDelete: <T>(index: number, arr: any[], deleteService: (...args: any) => Promise<T> | Observable<T>, addRowFunc: (...args: any) => any, cb?: (any: any) => any) => Promise<void>;
-    /**
-     * To handle the patching of a FormArray
-     * @param arr - The array that contains the data
-     * @param addFunc - The function that performs addition of single entries
-     * @param formArr - The FormArray that will hold the array's data
-     */
-    initPatchFormArray: <T>(arr: T[], addFunc: (i: number, data?: T, formArr?: FormArray) => void, formArr: FormArray) => void;
-    /**
-     * Checks if a value is a Promise
-     * @param func - Value to check
-     * @returns True if the value is a Promise
-     */
-    private isPromise;
-    /**
-     * Checks if a function is async
-     * @param func - Function to check
-     * @returns True if the function is async
-     */
-    isAsync: (func: any) => boolean;
-    /**
-     * Checks if a value is an Observable
-     * @param func - Value to check
-     * @returns True if the value is an Observable
-     */
-    isObservable: <T>(func: any) => func is Observable<unknown>;
-    /**
-     * Converts a value to a Promise
-     * @param val - Value to convert
-     * @returns Promise that resolves with the value
-     */
-    promisifyVal: <T>(val: T | Promise<T> | Observable<T>) => Promise<Awaited<T>>;
-    /**
-     * Merges multiple observables into a single observable
-     * @param arr - Array of observables to fetch
-     * @returns An array of the responses merged together. It emits the merged responses as they are fetched and closes once all the responses have been fetched
-     */
-    mergeArrObservables: <T>(arr: {
-        $func: Observable<T[]>;
-    }[]) => Observable<T[]>;
-    /**
-     * Removes duplicate items from an array based on a key field
-     * @param list - Array to remove duplicates from
-     * @param keyField - Field to use for comparison (defaults to 'code')
-     * @returns Array with duplicates removed
-     */
-    removeDuplicate<T>(list: T[], keyField?: string): T[];
-    /**
-     * Generates a random ID
-     */
-    get genRandomID(): number;
-    /**
-     * Picks a random item from an array
-     * @param array - Array to pick from
-     * @returns Random item or null if array is empty
-     */
-    pickRandomIndex: <T>(array: T[]) => T | null;
-    /**
-     * Stores a payload in the logger
-     */
-    storePayload: <T>(log: import("ets-fe-ng-sdk").ILog<T>) => void;
-    /**
-     * Checks if an object is empty, optionally excluding certain fields
-     * @param obj - Object to check
-     * @param exclusionFields - Fields to exclude from the check
-     * @returns True if the object is empty
-     */
-    objIsEmpty: (obj: any, exclusionFields?: string[]) => boolean;
-    /**
-     * Generates an array of objects with random string values for the specified keys.
-     * @param keys - Array of keys to include in each object.
-     * @param length - Number of objects to generate (default is 10).
-     * @returns An array of objects with random string values.
-     * @example
-     * utilityService.dataGen(['name', 'email'], 2);
-     * // [{ name: 'random123', email: 'random456' }, { name: 'random789', email: 'random101' }]
-     */
-    dataGen: <T = any>(keys: string[], length?: number) => T[];
-    /**
-     * Generates a random string value.
-     * @returns A random string in the format 'randomXXX'.
-     * @example
-     * utilityService.textGen(); // 'random123'
-     */
-    textGen: () => string;
-    /**
-     * TrackBy function for Angular lists using the 'code' property.
-     * @param index - Index of the item.
-     * @param item - The item object.
-     * @returns The 'code' property of the item.
-     * @example
-     * <div *ngFor="let item of items; trackBy: utilityService.trackByCode">...</div>
-     */
-    trackByCode(index: number, item: any): any;
-    /**
-     * TrackBy function for Angular lists using the 'id' property.
-     * @param index - Index of the item.
-     * @param item - The item object.
-     * @returns The 'id' property of the item.
-     * @example
-     * <div *ngFor="let item of items; trackBy: utilityService.trackByID">...</div>
-     */
-    trackByID(index: number, item: any): any;
-    /**
-     * Opens a dialog and handles the result with provided callbacks.
-     * @param comp - The component to open in the dialog.
-     * @param config - Dialog configuration.
-     * @param valueCB - Callback if a value is returned.
-     * @param noValueCB - Optional callback if no value is returned.
-     * @example
-     * utilityService.dialogOpener(MyDialogComponent, config, (result) => { ... });
-     */
-    dialogOpener: (comp: any, config: MatDialogConfig, valueCB: (r: any) => any, noValueCB?: any) => Subscription;
-    /**
-     * Opens a dialog and returns the dialog reference.
-     * @param comp - The component to open in the dialog.
-     * @param config - Dialog configuration.
-     * @returns The MatDialogRef instance.
-     * @example
-     * const ref = utilityService.dialogOpenerRef(MyDialogComponent, config);
-     */
-    dialogOpenerRef: (comp: any, config: MatDialogConfig) => import("@angular/material/dialog").MatDialogRef<unknown, any>;
-    /**
-     * Finds and formats a label for an item from an array, using a key and label field.
-     * @param item - The item value to find.
-     * @param arr - The array to search.
-     * @param labelField - The field to use for the label (default: 'title' or 'description').
-     * @param keyField - The field to use as the key (default: 'code').
-     * @returns A formatted string combining the item and its label, or the item if not found.
-     * @example
-     * utilityService.findLabelByItem('A1', [{ code: 'A1', title: 'Alpha' }]); // 'A1 - Alpha'
-     */
-    findLabelByItem: (item: any, arr: any[], labelField?: string, keyField?: string) => any;
-    formFieldsFromArr: <TFCInput>(inputs: TFCInput[]) => {
-        [key: string]: AbstractControl<any, any>;
-    };
-    objToFormControls: <T = any>(obj: T) => { [key in keyof T]: AbstractControl<T[key], T[key]>; };
-    formSchemaToFormControls: <TIFormSchema>(formFields: TIFormSchema[]) => {
-        [key: string]: AbstractControl<any, any>;
-    };
-    addFormSchemaToForm: <TIFormSchema>(formFields: TIFormSchema[], form: FormGroup) => FormGroup<any>;
-    bindFormControlToInputs: <TFCInput>(inputs: TFCInput[], form: FormGroup) => void;
-    go: (value: string, extra?: NavigationExtras) => void;
-    /**
-     * Route to component
-     * @param route Route of path to component
-     * @param extra
-     */
-    goR: (route: string, extra?: NavigationExtras) => void;
-    /**
-     * Provides a set of router utilities for relative navigation and parameter access.
-     * @returns An object containing the current route, router, navigation function, query params, and path params.
-     * @example
-     * const { navigate, queryParams, pathParams } = utilityService.relativeRouter();
-     * navigate('details', { queryParams: { id: 1 } });
-     */
-    relativeRouter(): {
-        route: ActivatedRoute;
-        router: Router;
-        navigate: (link: string, config?: NavigationExtras | undefined) => Promise<boolean>;
-        queryParams: import("@angular/router").Params;
-        pathParams: import("@angular/router").Params;
-    };
-    /**
-     * Formats a number as currency using the current locale.
-     * @param amount - The amount to format.
-     * @param currency - The currency code (default is a space for generic formatting).
-     * @returns The formatted currency string.
-     * @example
-     * utilityService.moneyParser(1000, 'USD'); // "$1,000.00"
-     */
-    moneyParser: (amount: string | number, currency?: string) => string;
-    /**
-     * Extracts uploaded files from an input event.
-     * @param event - The file input event.
-     * @returns An array of uploaded files, or an empty array if none found.
-     * @example
-     * const files = utilityService.extractUpload($event);
-     */
-    extractUpload(event: any): File[];
-    /**
-     * Converts seconds to an object containing hours, minutes, and seconds.
-     * @param seconds - The total number of seconds.
-     * @returns An object with hours, mins, and secs properties.
-     * @example
-     * utilityService.secondsToHourMinSec(3661); // { hours: 1, mins: 1, secs: 1 }
-     */
-    secondsToHourMinSec: (seconds: number) => {
-        hours: number;
-        mins: number;
-        secs: number;
-    };
-    /**
-     * Converts minutes to an object containing days, hours, and minutes.
-     * @param minutes - The total number of minutes.
-     * @returns An object with days, hours, and mins properties.
-     * @example
-     * utilityService.minutesToDayHourMin(1500); // { days: 1, hours: 1, mins: 0 }
-     */
-    minutesToDayHourMin: (minutes: number) => {
-        days: number;
-        hours: number;
-        mins: number;
-    };
-    /**
-     * Converts minutes to a string in the format "D H:M".
-     * @param minutes - The total number of minutes.
-     * @returns A formatted string or null if input is falsy.
-     * @example
-     * utilityService.minutesToDayHourMinStr(1500); // "1 1:0"
-     */
-    minutesToDayHourMinStr: (minutes: number) => string;
-    /**
-     * Converts minutes to a string in the format "Ddays Hhrs Mmins".
-     * @param minutes - The total number of minutes.
-     * @returns A formatted string or null if input is falsy.
-     * @example
-     * utilityService.minutesToDayHourMinStr2(1500); // "1days 1hrs 0mins"
-     */
-    minutesToDayHourMinStr2: (minutes: number) => string;
-    /**
-     * Converts days, hours, and minutes to a string in the format "HH:MM".
-     * @param dys - Number of days.
-     * @param hrs - Number of hours.
-     * @param mins - Number of minutes.
-     * @returns A string in the format "HH:MM" or an empty string if all inputs are falsy.
-     * @example
-     * utilityService.dayHourMinToHourMinutes(1, 2, 30); // "26:30"
-     */
-    dayHourMinToHourMinutes: (dys: number, hrs: number, mins: number) => string;
-    /**
-     * Enables or disables a collection of form controls
-     * @param controls Array of AbstractControls to enable or disable
-     * @param disable Whether to disable (true) or enable (false) the controls
-     */
-    disableOrEnableInputs: (controls: AbstractControl[], disable: boolean) => void;
-    /**
-     * Disables a collection of form controls
-     * @param controls Array of AbstractControls to disable
-     */
-    disableInputs: (controls: AbstractControl[]) => void;
-    /**
-     * Enables a collection of form controls
-     * @param controls Array of AbstractControls to enable
-     */
-    enableInputs: (controls: AbstractControl[]) => void;
-    /**
-     * Converts days, hours, and minutes to total minutes
-     * @param dys Number of days
-     * @param hrs Number of hours
-     * @param mins Number of minutes
-     * @returns Total minutes or 0 if all inputs are falsy
-     */
-    dayHourMinToMinutes: (dys: number, hrs: number, mins: number) => number;
-    /**
-     * Converts hours and minutes to total minutes
-     * @param hrs Number of hours
-     * @param mins Number of minutes
-     * @returns Total minutes or null if both inputs are falsy
-     */
-    hourMinToMinutes: (hrs: number, mins: number) => number;
-    /**
-     * Converts a time string in format "HH:MM" to total minutes
-     * @param hrsMins Time string in format "HH:MM"
-     * @returns Total minutes
-     */
-    hourMinToMinutes2: (hrsMins: string) => number;
-    /**
-     * Displays a notification message
-     * @param message Message to display
-     * @param cls Notification type: 0=error, 1=success, 2=info, 3=warning
-     * @param duration Duration in milliseconds
-     * @param title Optional title for the notification
-     * @returns Object with closed observable
-     * @example
-     * // Success notification
-     * utilityService.notify('Profile updated successfully', 1);
-     *
-     * // Error notification with custom duration
-     * utilityService.notify('Failed to save changes', 0, 10000);
-     *
-     * // Info notification with title
-     * utilityService.notify('Your session will expire in 5 minutes', 2, 5000, 'Session Expiry');
-     */
-    notify(message: string, cls?: 0 | 1 | 2 | 3, duration?: number, title?: string): {
-        closed: import("rxjs").Subject<{
-            manuallyClosed: boolean;
-        }>;
-    };
-    /**
-     * Scrolls the window to the top
-     */
-    scrollToTop: () => void;
-    /**
-     * Gets the current date and time in a format suitable for datetime-local inputs
-     * @returns Current datetime in ISO format without timezone
-     */
-    getLocalDateTimeNow: () => string;
-    /** @returns The current date local that can be used to set the date input */
-    localDateNow: () => string;
-    /**
-     * Formats a date in various formats
-     * @param date Date to format
-     * @param format Format option: 1=toDateString, 2=DD Month, 3=EEE MMM DD YYYY, hh:mm aa, 4=Month DD
-     * @returns Formatted date string or null if date is falsy
-     */
-    dateFormat: (date: any, format?: number) => string;
-    /**
-     * Converts an ISO date string to Java date string format
-     * @param isoDateString ISO date string, defaults to current date
-     * @returns Date string in Java format or null if input is falsy
-     */
-    toJavaDateString: (isoDateString?: string) => string;
-    /**
-     * Converts a date string to Java datetime format
-     * @param isoDateString Date string to convert
-     * @returns Datetime string in Java format or null if input is falsy
-     */
-    toJavaDatetimeString: (isoDateString: string) => string;
-    /**
-     * Formats a time string by removing seconds
-     * @param time Time string to format
-     * @returns Formatted time string
-     */
-    timeFormat: (time?: any) => string;
-    /**
-     * Formats a timestamp as a full date and time
-     * @param timestamp Timestamp to format
-     * @returns Formatted date and time string
-     */
-    fullDateTime: (timestamp: string | number) => string;
-    /**
-     * Formats a number of days into years, months, and days
-     * @param days Number of days to format
-     * @returns Formatted string or "-" if days is falsy
-     */
-    daysFormatter: (days: number) => string;
-    /**
-     * Formats a number of months into years and months
-     * @param months Number of months to format
-     * @returns Formatted string or "-" if months is falsy
-     */
-    monthsFormatter: (months: number) => string;
-    /**
-     * Adds appropriate plural suffix to a value
-     * @param val Numeric value
-     * @param txt Singular text
-     * @param plural Optional plural text (defaults to txt + 's')
-     * @returns Formatted string with value and appropriate suffix
-     */
-    pluarlizer: (val: number, txt: string, plural?: string) => string;
-    /**
-     * Converts a decimal to percentage string
-     * @param dec Decimal value to convert
-     * @returns Percentage string
-     */
-    decimalToPercentage: (dec: number) => string;
-    /**
-     * Logs form details to console
-     * @param form Form to log
-     */
-    logForm: (form: any) => void;
-    /**
-     * Converts data to CSV and triggers download
-     * @param data Array of data objects
-     * @param headerNames Array of header names
-     * @param filename Filename for the downloaded file
-     */
-    toCSV(data: any[], headerNames: string[], filename: string): void;
-    /**
-     * Checks if a filename has a picture format extension
-     * @param fileName Filename to check
-     * @returns True if filename has a picture format extension
-     */
-    isPictureFormat(fileName: string): boolean;
-    /**
-     * Converts an object to an array of its values
-     * @param obj Object to convert
-     * @returns Array of object values
-     */
-    objectToArray<T>(obj: any): T[];
-    /**
-     * Formats a field name to title case
-     * @param field Field name to format
-     * @returns Formatted field name
-     */
-    formatField(field: string): string;
-    /**
-     * Uses a web worker to perform a task
-     * @param worker Web worker object
-     * @param inputData Data to pass to the web worker
-     * @param conditions Optional conditions for stopping or error handling
-     * @returns Observable of worker results
-     */
-    useWebWorker<T = any>(worker: Worker, inputData: any, conditions?: {
-        stop: (res: any) => boolean;
-        error: (res: any) => boolean;
-    }): Observable<T>;
-    /**
-     * Creates a function that trims text to a specified length
-     * @param length Maximum length before trimming
-     * @returns Function that trims text
-     */
-    trim: (length?: number) => (text: string | undefined) => string;
-    /**
-     * Converts an array to CSV and triggers download
-     * @param data Array of data objects
-     * @param filename Filename for the downloaded file
-     * @param headerMap Optional column definitions
-     * @param extraConfig Optional configuration
-     */
-    arrayToCSV(data: any[], filename: string, headerMap?: TableCol[], extraConfig?: {
-        prefix?: string;
-        hideHeader?: boolean;
-        hideNotification?: boolean;
-    }): Promise<void>;
-    /**
-     * Type casting helper
-     * @param value Value to cast
-     * @returns The same value with type information
-     */
-    typeCaster: <T>(value: T) => T;
-    /**
-     * Joins multiple CSV strings with newlines
-     * @param CSVs CSV strings to join
-     * @returns Combined CSV string
-     */
-    joinCSVRows(...CSVs: string[]): string;
-    /**
-     * Converts an array to a CSV string
-     * @param data Array of data objects
-     * @param headerMap Optional column definitions
-     * @param extraConfig Optional configuration
-     * @returns CSV string
-     */
-    arrayToCSVString<T = any>(data: T[], headerMap?: TableCol<T>[], extraConfig?: {
-        prefix?: string;
-        hideHeader?: boolean;
-    }): Promise<string>;
-    /**
-     * Checks if a value is a date string in YYYY-MM-DD format
-     * @param v Value to check
-     * @returns True if value is a date string
-     */
-    isDateValue: (v: any) => boolean;
-    /**
-     * Checks if a value is a datetime string in ISO format
-     * @param v Value to check
-     * @returns True if value is a datetime string
-     */
-    isDatTimeValue: (v: any) => boolean;
-    /**
-     * Formats a boolean value as a colored "Yes" or "No" HTML span
-     * @param v Boolean value to format
-     * @returns HTML string with appropriate styling
-     */
-    yesNoCellFormatterColoured: (v: any) => string;
-    /**
-     * Formats a boolean value as "Yes" or "No"
-     * @param v Boolean value to format
-     * @returns "Yes" or "No" string
-     */
-    yesNoCellFormatter: (v: any) => string;
-    /**
-     * Formats a status value as a colored HTML span
-     * @param status Status value to format
-     * @returns HTML string with appropriate styling
-     */
-    statusCellFormatter: (status: Status) => string;
-    /**
-     * Creates a formatter function that applies styling based on value
-     * @param guide Object defining values for different styles
-     * @returns Formatter function that returns styled HTML
-     */
-    cellStatusFormatter: <T = any>(guide: {
-        successVal?: T;
-        pendingVal?: T;
-        errorVal?: T;
-        inertVal?: T;
-    }) => (v: any) => string;
-    /**
-     * Generates a UUID
-     */
-    generateUUID: () => string;
-    /**
-     * Shows an information dialog
-     * @param text Text to display
-     * @param status Optional status: 0=error, 1=success, 2=info
-     * @param heading Optional dialog heading
-     * @param btns Optional buttons configuration
-     * @param disableClose Whether to disable dialog closing
-     * @returns Promise resolving to boolean indicating user action
-     */
-    info: (text: string, status?: 0 | 2 | 1, heading?: string, btns?: IInfoDialogBtn[], disableClose?: boolean) => Promise<boolean>;
-    /**
-     * Creates a debounced function
-     */
-    debouncer: (config: {
-        uniqueKey: string;
-        callback: () => any;
-    }) => void;
-    /**
-     * Creates an async validator
-     */
-    asyncValidation: <TData extends {
-        response?: boolean;
-    } = any>(config: {
-        uniqueKey: string;
-        callback: () => Promise<TData>;
-        validationError?: import("../Shared/models/index.model").CustomValidationError;
-    }) => Promise<import("../Shared/models/index.model").CustomValidationError>;
-    /**
-     * Starts the page loader
-     */
-    startPl: (value?: number) => number;
-    /**
-     * Stops the page loader
-     */
-    stopPl: (value?: number) => number;
-    /**
-     * Creates a subscription manager to handle multiple subscriptions
-     * @param subs Initial subscriptions
-     * @returns Object with methods to manage subscriptions
-     * @example
-     * // Create a subscription manager
-     * const subManager = utilityService.createSubscriptionManager();
-     *
-     * // Add subscriptions to the manager
-     * subManager.push(
-     *   this.dataService.getData().subscribe(data => this.data = data),
-     *   this.userService.getUser().subscribe(user => this.user = user)
-     * );
-     *
-     * // Later, clear all subscriptions at once (e.g., in ngOnDestroy)
-     * ngOnDestroy() {
-     *   subManager.clear();
-     * }
-     */
-    createSubscriptionManager: (...subs: Subscription[]) => {
-        clear: () => void;
-        push: (...subs: Subscription[]) => number;
-        subs: () => Subscription[];
-    };
-    /**
-     * Creates a cache manager for storing and retrieving data
-     * @param config Configuration options
-     * @returns Object with methods to manage the cache
-     * @example
-     * // Create a cache for user data with custom key function
-     * const userCache = utilityService.createCacheManager<User, number>({
-     *   keyer: (userId) => `user_${userId}`,
-     *   maxSize: 50 // Store up to 50 users
-     * });
-     *
-     * // Save data to cache
-     * userCache.save(123, { id: 123, name: 'John Doe', email: 'john@example.com' });
-     *
-     * // Retrieve data from cache
-     * const user = userCache.get(123);
-     *
-     * // Clear cache when needed
-     * userCache.clear();
-     */
-    createCacheManager: <TData = any, TKey = any>(config: {
-        keyer?: (item: TKey) => string;
-        maxSize?: number;
-    }) => {
-        clear: () => void;
-        destroy: () => void;
-        get: (key: TKey) => TData;
-        save: (key: string | number | TKey, data: TData) => void;
-        cache: () => {
-            [key: string]: {
-                item: TData;
-            };
-        };
-    };
-    /**
-     * Track by function that uses a custom ID field
-     * @param index Index of the item
-     * @param item Item to track
-     * @returns Custom ID for the item
-     */
-    trackByCustomID: (index: any, item: any) => any;
-    /**
-     * Track by function for form groups
-     * @param index Index of the form group
-     * @param item Form group to track
-     * @returns Custom ID for the form group
-     */
-    trackByForForms: (index: any, item: FormGroup) => any;
-    /**
-     * Converts an object to a FormGroup
-     * @param data Object to convert
-     * @returns FormGroup with controls for each object property
-     */
-    objectToFormGroup: <T>(data: T) => FormGroup<IStrictFormGroup<T>>;
-    /**
-     * Converts a form schema to a FormGroup
-     * @param schema Form schema definition
-     * @param data Optional initial data
-     * @returns FormGroup built from the schema
-     */
-    formSchemaToFormGroup: <T extends {
-        [x: string]: any;
-    }>(schema: IFormSchema[], data?: T) => FormGroup<IStrictFormGroup<T>>;
-    /**
-     * Times the execution of a code block
-     * @param label Label for the timing log
-     * @param cb Callback function to execute and time
-     * @returns Result of the callback function
-     * @example
-     * // Time a data processing function
-     * const processedData = utilityService.timeCodeBlock('Process user data', () => {
-     *   const result = [];
-     *   for (let i = 0; i < 10000; i++) {
-     *     result.push(this.processUserData(this.users[i]));
-     *   }
-     *   return result;
-     * });
-     * // Console output: "Process user data 1621234567890 1621234568920 1.03sec"
-     */
-    timeCodeBlock: <T>(label: string, cb: () => T) => T;
-    /**
-     * Removes null, undefined, and empty string fields from an object
-     * @param obj Object to clean
-     * @returns New object without null, undefined, or empty string fields
-     * @example
-     * const userData = {
-     *   name: 'John',
-     *   email: 'john@example.com',
-     *   phone: '',
-     *   address: null,
-     *   age: 30
-     * };
-     *
-     * const cleanData = utilityService.deleteNull(userData);
-     * // cleanData = { name: 'John', email: 'john@example.com', age: 30 }
-     */
-    deleteNull: <T>(obj: T) => T;
-    /**
-     * Conditionally executes an observable-returning function based on request value
-     * @param req The request parameter to check
-     * @param observable Function that returns an Observable when given the request
-     * @returns The Observable from the function if req has a value, otherwise an Observable of null
-     * @template Q Request parameter type
-     * @template R Observable response type
-     */
-    nullRequestHandler: <Q, R>(req: Q, observable: (q: Q) => Observable<R>) => Observable<R>;
-    /**
-     * Handles errors from Angular's ResourceRef by displaying an error message
-     * @param res The ResourceRef object to check for errors
-     * @template T The type of data in the ResourceRef
-     */
-    resouceErrorHandler: <T>(res: ResourceRef<T>) => void;
-    /**
-     * Formats a time duration in milliseconds to hours, minutes, and seconds
-     * @param timeTaken Time in milliseconds
-     * @returns Formatted time string
-     */
-    formatTimeTaken: (timeTaken: number) => string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<UtilityService<any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<UtilityService<any>>;
-}