@servicemind.tis/angular-smart-data-table 1.0.0

package/lib/helpers/timeout-manager.helper.d.ts

@@ -0,0 +1,72 @@
+/**
+ * TimeoutManager - A utility class for managing timeouts to prevent memory leaks
+ *
+ * This class provides a centralized way to create, track, and clean up setTimeout calls.
+ * It automatically handles cleanup when component is destroyed to prevent memory leaks.
+ *
+ * @example
+ * ```typescript
+ * export class MyComponent implements OnDestroy {
+ *   private timeoutManager = new TimeoutManager();
+ *
+ *   someMethod() {
+ *     this.timeoutManager.createTimeout(() => {
+ *       console.log('Delayed execution');
+ *     }, 1000);
+ *   }
+ *
+ *   ngOnDestroy() {
+ *     this.timeoutManager.clearAll(); // Clean up all pending timeouts
+ *   }
+ * }
+ * ```
+ */
+export declare class TimeoutManager {
+    private activeTimeouts;
+    /**
+     * Creates a tracked timeout that will be automatically cleaned up
+     * @param callback - Function to execute after delay
+     * @param delay - Delay in milliseconds
+     * @returns The timeout ID (same as setTimeout return value)
+     */
+    createTimeout(callback: () => void, delay: number): ReturnType<typeof setTimeout>;
+    /**
+     * Manually clear a specific timeout
+     * @param timeoutId - The timeout ID returned from createTimeout
+     */
+    clearTimeout(timeoutId: ReturnType<typeof setTimeout>): void;
+    /**
+     * Clear all pending timeouts
+     * This should be called in ngOnDestroy to prevent memory leaks
+     */
+    clearAll(): void;
+    /**
+     * Get the number of active (pending) timeouts
+     * Useful for debugging and testing
+     */
+    get activeCount(): number;
+    /**
+     * Check if a specific timeout is still active
+     * @param timeoutId - The timeout ID to check
+     */
+    isActive(timeoutId: ReturnType<typeof setTimeout>): boolean;
+}
+/**
+ * Static helper functions for one-off timeout usage
+ * Use the TimeoutManager class for more comprehensive timeout management
+ */
+export declare class TimeoutHelper {
+    /**
+     * Create a single tracked timeout with external cleanup responsibility
+     * @param callback - Function to execute after delay
+     * @param delay - Delay in milliseconds
+     * @param trackingSet - Set to track the timeout for cleanup
+     * @returns The timeout ID
+     */
+    static createTrackedTimeout(callback: () => void, delay: number, trackingSet: Set<ReturnType<typeof setTimeout>>): ReturnType<typeof setTimeout>;
+    /**
+     * Clear all timeouts in a tracking set
+     * @param trackingSet - Set containing timeout IDs to clear
+     */
+    static clearAllTimeouts(trackingSet: Set<ReturnType<typeof setTimeout>>): void;
+}

package/lib/helpers/url.helper.d.ts

@@ -0,0 +1,78 @@
+import { Location } from '@angular/common';
+import { Router } from '@angular/router';
+/**
+ * Centralized URL and navigation utility helper.
+ * Provides common functions for URL manipulation and navigation.
+ */
+export declare class UrlHelper {
+    /**
+     * Extracts the home URL from current window location
+     * @returns Home URL path
+     */
+    static getHomeUrl(): string;
+    /**
+     * Safely navigates to a URL if it's valid
+     * @param router - Angular Router instance
+     * @param url - URL to navigate to
+     * @returns Promise<boolean> - Navigation result
+     */
+    static safeNavigate(router: Router, url: string): Promise<boolean> | null;
+    /**
+     * Updates the browser URL without navigation using Location service
+     * @param location - Angular Location service
+     * @param baseUrl - Base URL path
+     * @param queryString - Query string parameters
+     */
+    static updateUrl(location: Location, baseUrl: string, queryString: string): void;
+    /**
+     * Builds a complete URL with query parameters
+     * @param baseUrl - Base URL path
+     * @param queryParams - URLSearchParams object
+     * @returns Complete URL string
+     */
+    static buildUrl(baseUrl: string, queryParams: URLSearchParams): string;
+    /**
+     * Gets the base URL without query parameters
+     * @param router - Angular Router instance
+     * @returns Base URL string
+     */
+    static getBaseUrl(router: Router): string;
+    /**
+     * Checks if current URL differs from generated URL
+     * @param generatedUrl - Generated URL to compare
+     * @returns True if URLs are different
+     */
+    static hasUrlChanged(generatedUrl: string): boolean;
+    /**
+     * Extracts query parameters from a URL string
+     * @param url - Full URL string
+     * @returns URLSearchParams object
+     */
+    static extractQueryParams(url: string): URLSearchParams | null;
+    /**
+     * Handles button click actions (URL navigation or callback execution)
+     * @param router - Angular Router instance
+     * @param config - Button configuration object
+     * @param primaryUrlKey - Primary URL property name (default: 'btnUrl')
+     * @param primaryClickKey - Primary click handler property name (default: 'btnClick')
+     */
+    static handleButtonClick(router: Router, config: any, primaryUrlKey?: string, primaryClickKey?: string): void;
+    /**
+     * Handles secondary button click actions
+     * @param router - Angular Router instance
+     * @param config - Button configuration object
+     */
+    static handleSecondaryButtonClick(router: Router, config: any): void;
+    /**
+     * Validates if a URL string is properly formatted
+     * @param url - URL to validate
+     * @returns True if URL is valid
+     */
+    static isValidUrl(url: string): boolean;
+    /**
+     * Safely encodes URL parameters
+     * @param value - Value to encode
+     * @returns Encoded string
+     */
+    static encodeParam(value: any): string;
+}

package/lib/helpers/validation.helper.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Centralized validation utility helper for common validation tasks.
+ * Provides reusable validation functions to avoid code duplication.
+ */
+export declare class ValidationHelper {
+    /**
+     * Checks if a value is not null, undefined, or empty string
+     * @param value - Value to check
+     * @returns True if value has content
+     */
+    static hasValue(value: any): boolean;
+    /**
+     * Checks if any values in an object are non-empty
+     * @param obj - Object to check
+     * @returns True if any value is non-empty
+     */
+    static hasNonEmptyValue(obj: any): boolean;
+    /**
+     * Checks if a form has any non-empty values
+     * @param formData - Form data object
+     * @returns True if form has any data
+     */
+    static hasFormData(formData: any): boolean;
+    /**
+     * Validates if an array has items
+     * @param array - Array to check
+     * @returns True if array exists and has items
+     */
+    static hasItems(array: any[]): boolean;
+    /**
+     * Checks if a URL is valid
+     * @param url - URL string to validate
+     * @returns True if URL is valid
+     */
+    static isValidUrl(url: string): boolean;
+    /**
+     * Validates if a string is a valid number
+     * @param value - Value to check
+     * @returns True if value is a valid number
+     */
+    static isValidNumber(value: any): boolean;
+    /**
+     * Checks if an object has a specific property with a valid value
+     * @param obj - Object to check
+     * @param property - Property name
+     * @returns True if property exists and has a value
+     */
+    static hasProperty(obj: any, property: string): boolean;
+    /**
+     * Validates if a selection model row has the required key
+     * @param row - Row object
+     * @param keyName - Key property name
+     * @returns True if row has the key property with a value
+     */
+    static hasRowKey(row: any, keyName: string): boolean;
+    /**
+     * Checks if a filter value should be processed (not null, empty, or invalid)
+     * @param value - Filter value
+     * @returns True if filter value is valid for processing
+     */
+    static isValidFilterValue(value: any): boolean;
+    /**
+     * Validates pagination parameters
+     * @param pageIndex - Page index
+     * @param pageSize - Page size
+     * @returns Object with validation results
+     */
+    static validatePagination(pageIndex: any, pageSize: any): {
+        isValid: boolean;
+        pageIndex: number;
+        pageSize: number;
+    };
+}

package/lib/interfaces/angular-selection-config.type.d.ts

@@ -0,0 +1,16 @@
+export type SelectedFilterDisplayValueType = {
+    value: any | any[] | null;
+    labelKey?: string | number | null;
+    valueKey: any | null;
+    formControlName: string;
+    formControlType: 'input' | 'radio' | 'date' | 'date-time' | 'toggle' | 'checkbox' | 'chip' | 'select' | 'search-select';
+    isSingleValue?: boolean;
+    selectedObjData?: any;
+};
+export type SelectedFilterDisplayValuesType = SelectedFilterDisplayValueType[];
+export type AnyKeyValueObject = Record<string, any>;
+export type SelectedFiltersGroupedValuesType = {
+    formControlName: string;
+    formControlType: string;
+    arrValues: SelectedFilterDisplayValueType[];
+};

package/lib/interfaces/data-not-found-config.type.d.ts

@@ -0,0 +1,12 @@
+export type DataNotFoundConfig = {
+    title: string;
+    desc?: string;
+    /** Optional custom icon/image URL. If provided, this image will be displayed instead of the default SVG. */
+    iconUrl?: string | null;
+    btnText?: string | null;
+    btnUrl?: string | null;
+    btnClick?: null | ((rec: any, event?: MouseEvent) => void);
+    secondBtnText?: string | null;
+    secondBtnUrl?: string | null;
+    secondBtnClick?: null | ((rec: any, event?: MouseEvent) => void);
+};

package/lib/interfaces/index.d.ts

@@ -0,0 +1,4 @@
+export * from './smart-data-table-wrapper-columns-config.type';
+export * from './angular-selection-config.type';
+export * from './data-not-found-config.type';
+export * from './url-config.type';

package/lib/interfaces/smart-data-table-wrapper-columns-config.type.d.ts

@@ -0,0 +1,38 @@
+import { TemplateRef } from "@angular/core";
+export interface SmartTableWrapperColumnsConfig {
+    name: string;
+    columnName?: string;
+    columnDef?: string;
+    type: 'string' | 'number' | 'quantity' | 'money' | 'date' | 'date-time' | 'date-time-with-seconds' | 'action' | 'expand';
+    align?: 'left' | 'right' | 'center' | null;
+    serverKeyCode: string;
+    valueKey?: string;
+    template?: TemplateRef<any>;
+    sort: boolean;
+    clickFn?: (rec: any, event?: MouseEvent) => void;
+    /** Function that returns routerLink value - enables right-click "Open in new tab" */
+    linkFn?: (row: any) => string | any[];
+    filterFormKey?: string;
+    transformQueryParamFn?: Function;
+}
+/**
+ * Maps column value types to their custom format strings.
+ * - For 'date' / 'date-time' / 'date-time-with-seconds': Luxon format string (e.g. 'yyyy/MM/dd', 'dd-MM-yyyy HH:mm')
+ * - For 'quantity': Angular DecimalPipe digitsInfo string (e.g. '1.2-2', '1.0-0')
+ * - For 'money': number of decimal places (e.g. '4', '0')
+ * - For 'number': Angular DecimalPipe digitsInfo string
+ * - For 'string': unused (reserved for future use)
+ *
+ * Example:
+ * {
+ *   'date': 'yyyy/MM/dd',
+ *   'date-time': 'dd-MM-yyyy HH:mm',
+ *   'money': '2',
+ *   'quantity': '1.4-4',
+ *   'number': '1.1-1'
+ * }
+ */
+export type ColumnValueTypeFormats = Partial<Record<'number' | 'quantity' | 'money' | 'date' | 'date-time' | 'date-time-with-seconds', string>>;
+export interface SmartTableWrapperRowsConfig {
+    backgroundApplyFunction?: (row: any) => string | null;
+}

package/lib/interfaces/url-config.type.d.ts

@@ -0,0 +1,8 @@
+export interface ColumnCustomizationUrlConfig {
+    list: string;
+    add: string;
+    update: string;
+    delete: string;
+    getSelectedTemplate: string;
+    updateSelectedTemplate: string;
+}

package/lib/pipes/angular-currency.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class AngularCurrencyPipe implements PipeTransform {
+    transform(value: number | string | null | undefined, decimals?: number | string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AngularCurrencyPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<AngularCurrencyPipe, "angularCurrency", false>;
+}

package/lib/pipes/angular-date-time-with-seconds.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class AngularDateTimeWithSecondsPipe implements PipeTransform {
+    transform(value: unknown, format?: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AngularDateTimeWithSecondsPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<AngularDateTimeWithSecondsPipe, "angularDateTimeWithSeconds", false>;
+}

package/lib/pipes/angular-date-time.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class AngularDateTimePipe implements PipeTransform {
+    transform(value: unknown, format?: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AngularDateTimePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<AngularDateTimePipe, "angularDateTime", false>;
+}

package/lib/pipes/angular-date.pipe.d.ts

@@ -0,0 +1,7 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class AngularDatePipe implements PipeTransform {
+    transform(value: unknown, format?: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AngularDatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<AngularDatePipe, "angularDate", false>;
+}

package/lib/pipes/money.pipe.d.ts

@@ -0,0 +1,9 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class Money implements PipeTransform {
+    decimalPoints: number;
+    transform(value: number | string): any;
+    roundNumber(number: number, decimals?: number): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Money, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<Money, "money", false>;
+}

package/lib/pipes/quantity.pipe.d.ts

@@ -0,0 +1,9 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class Quantity implements PipeTransform {
+    decimalPoints: number;
+    transform(value: number | string): any;
+    roundNumber(number: number, decimals?: number): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Quantity, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<Quantity, "qty", false>;
+}

package/lib/services/angular-helper.service.d.ts

@@ -0,0 +1,17 @@
+import { HttpClient, HttpErrorResponse } from '@angular/common/http';
+import { MatDialog, MatDialogRef } from '@angular/material/dialog';
+import { MatSnackBar, MatSnackBarRef, TextOnlySnackBar } from '@angular/material/snack-bar';
+import { AngularSmartDataTableErrorDialogComponent } from '../components/angular-smart-data-table-error-dialog/angular-smart-data-table-error-dialog.component';
+import * as i0 from "@angular/core";
+export declare class AngularHelperService {
+    private snackBar;
+    private dialog;
+    private http;
+    constructor(snackBar: MatSnackBar, dialog: MatDialog, http: HttpClient);
+    showHttpErrorMsg(error: HttpErrorResponse, duration?: number): MatDialogRef<AngularSmartDataTableErrorDialogComponent, any> | MatSnackBarRef<TextOnlySnackBar>;
+    showSuccessMsg(message: string, title: string, duration?: number): void;
+    showErrorMsg(message: string, title: string, duration?: number): void;
+    sortArrayByOrder(A: string[], B: string[]): string[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<AngularHelperService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AngularHelperService>;
+}

package/lib/services/api.service.d.ts

@@ -0,0 +1,11 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+export declare class ApiService {
+    private http;
+    private token;
+    constructor(http: HttpClient);
+    getList(apiUrl: string, currentPage?: number, limit?: number, search?: string, filters?: object, sortFilter?: object): Observable<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ApiService>;
+}

package/lib/services/user-customization.service.d.ts

@@ -0,0 +1,16 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+export declare class UserCustomizationService {
+    private http;
+    private token;
+    constructor(http: HttpClient);
+    getColumnsTemplates(url: string, listComponent: string): Observable<any>;
+    addColumnsTemplate(url: string, body: any): Observable<any>;
+    updateColumnsTemplate(url: string, body: any): Observable<any>;
+    deleteColumnsTemplate(url: string, body: any): Observable<any>;
+    getSelectedColumnsTemplate(url: string, listComponent: string): Observable<any>;
+    updateSelectedColumnsTemplate(url: string, body: any): Observable<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UserCustomizationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UserCustomizationService>;
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@servicemind.tis/angular-smart-data-table",
+  "version": "1.0.0",
+  "description": "Configurable Angular Material data table with server-side pagination, sorting, URL-synced filters, column customization, and custom cell templates.",
+  "keywords": [
+    "angular",
+    "angular-material",
+    "data-table",
+    "datatable",
+    "table",
+    "pagination",
+    "sorting",
+    "filtering",
+    "column-customization"
+  ],
+  "author": "Thai Informatics System",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Thai-Informatics-System/angular-smart-data-table.git"
+  },
+  "homepage": "https://github.com/Thai-Informatics-System/angular-smart-data-table#readme",
+  "bugs": {
+    "url": "https://github.com/Thai-Informatics-System/angular-smart-data-table/issues"
+  },
+  "peerDependencies": {
+    "@angular/common": "^19.2.0",
+    "@angular/core": "^19.2.0",
+    "@angular/material": "^19.2.8",
+    "@angular/cdk": "^19.2.8"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "fesm2022/servicemind.tis-angular-smart-data-table.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/servicemind.tis-angular-smart-data-table.mjs"
+    }
+  }
+}

package/public-api.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/angular-smart-data-table.service';
+export * from './lib/angular-smart-data-table.module';
+export * from './lib/components/angular-smart-data-table/angular-smart-data-table.component';
+export * from './lib/interfaces';