@competer/primeng-table 0.0.0-stage → 19.1.8

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

@@ -0,0 +1,34 @@
+import { HttpHeaders, HttpResponse } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * Abstract service for handling HTTP requests for **ECS Primeng table**.
+ *
+ * Provides a consistent interface for making GET and POST requests to the backend.
+ * Implementations must define how requests are executed, including error handling,
+ * headers, and response processing.
+ */
+export declare abstract class ECSPrimengTableHttpService {
+    /**
+     * Performs a GET request to the specified service endpoint.
+     *
+     * @template T The expected response type.
+     * @param servicePoint The endpoint URL or path for the GET request.
+     * @param responseType Optional. The type of response expected, either `'json'` (default) or `'blob'`.
+     * @returns An Observable of `HttpResponse<T>`, containing the full HTTP response.
+     */
+    abstract handleHttpGetRequest<T>(servicePoint: string, responseType?: 'json' | 'blob'): Observable<HttpResponse<T>>;
+    /**
+     * Performs a POST request to the specified service endpoint.
+     *
+     * @template T The expected response type.
+     * @param servicePoint The endpoint URL or path for the POST request.
+     * @param data The payload to send in the POST request body.
+     * @param httpOptions Optional HTTP headers to include in the request.
+     * @param responseType Optional. The type of response expected, either `'json'` (default) or `'blob'`.
+     * @returns An Observable of `HttpResponse<T>`, containing the full HTTP response.
+     */
+    abstract handleHttpPostRequest<T>(servicePoint: string, data: any, httpOptions?: HttpHeaders | null, responseType?: 'json' | 'blob'): Observable<HttpResponse<T>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ECSPrimengTableHttpService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ECSPrimengTableHttpService>;
+}

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

@@ -0,0 +1,18 @@
+import * as i0 from "@angular/core";
+/** Translates UI text only; never changes column keys, data or persisted view names. */
+export declare class ECSPrimengTableI18nService {
+    private readonly translate;
+    private readonly prime;
+    private readonly destroyRef;
+    private readonly parser;
+    private connected;
+    private primeDefaults;
+    private appliedPrimeTranslations;
+    readonly changes: import("rxjs").Observable<import("@ngx-translate/core").LangChangeEvent | import("@ngx-translate/core").TranslationChangeEvent | import("@ngx-translate/core").FallbackLangChangeEvent>;
+    text(key: string | null | undefined, params?: Record<string, any>): string;
+    /** Optional dictionary section "primeng" configures the application's shared PrimeNG locale. */
+    connectPrimeNG(): void;
+    private syncPrimeNG;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ECSPrimengTableI18nService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ECSPrimengTableI18nService>;
+}

package/lib/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./http.service";
+export * from "./notification.service";
+export * from "./table-state.service";
+export * from "./i18n.service";

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

@@ -0,0 +1,23 @@
+import * as i0 from "@angular/core";
+/**
+ * Abstract service for handling notifications in **ECS Primeng table**.
+ *
+ * Provides a consistent interface for displaying and clearing toast notifications.
+ * Implementations must define how the notifications are managed.
+ */
+export declare abstract class ECSPrimengTableNotificationService {
+    /**
+     * Displays a toast notification.
+     *
+     * @param severity The severity level of the notification (e.g., 'success', 'info', 'warn', 'error').
+     * @param title The title of the toast message.
+     * @param message The detailed message of the toast.
+     */
+    abstract showToast(severity: string, title: string, message: string): void;
+    /**
+     * Clears all currently displayed toast notifications.
+     */
+    abstract clearToasts(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ECSPrimengTableNotificationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ECSPrimengTableNotificationService>;
+}

package/lib/services/table-state.service.d.ts

@@ -0,0 +1,28 @@
+import { OnDestroy } from '@angular/core';
+import { FilterMetadata, SortMeta } from 'primeng/api';
+import * as i0 from "@angular/core";
+/** Transient query state only; rows and row selections are never cached. */
+export interface ITableNavigationState {
+    configurationUrl: string;
+    dataUrl: string;
+    filters: Record<string, FilterMetadata | FilterMetadata[]>;
+    multiSortMeta: SortMeta[];
+    globalSearchText: string | null;
+    currentPage: number;
+    currentRowsPerPage: number;
+}
+/**
+ * Provide on the parent COMPONENT containing the list and detail router outlet.
+ * Do not provide at application/root level or on the list component itself.
+ * Destroying that parent ends the scope and discards all its table states.
+ */
+export declare class ECSPrimengTableStateService implements OnDestroy {
+    private readonly states;
+    private destroyed;
+    get(key: string): ITableNavigationState | undefined;
+    set(key: string, state: ITableNavigationState): void;
+    clear(key?: string): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ECSPrimengTableStateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ECSPrimengTableStateService>;
+}

package/lib/utils/create-table-options.d.ts

@@ -0,0 +1,5 @@
+import { ITableOptions } from '../interfaces';
+/**
+ * Create table options based on defaults, with optional overrides.
+ */
+export declare function createTableOptions(overrides?: Partial<ITableOptions>): ITableOptions;

package/lib/utils/data-align-horizontal-as-text.d.ts

@@ -0,0 +1,11 @@
+import { DataAlignHorizontal } from "../enums";
+/**
+ * Converts a `DataAlignHorizontal` enum value to its corresponding CSS text alignment string.
+ *
+ * @param dataAlignHorizontal - The horizontal alignment enum value.
+ * @returns The CSS text alignment string ('left', 'center', or 'right').
+ *
+ * @remarks
+ * If an unknown value is provided, the function defaults to 'center'.
+ */
+export declare function dataAlignHorizontalAsText(dataAlignHorizontal: DataAlignHorizontal): string;

package/lib/utils/data-align-vertical-as-text.d.ts

@@ -0,0 +1,11 @@
+import { DataAlignVertical } from "../enums";
+/**
+ * Converts a `DataAlignVertical` enum value to its corresponding CSS vertical alignment string.
+ *
+ * @param dataAlignVertical - The vertical alignment enum value.
+ * @returns The CSS vertical alignment string ('top', 'middle', or 'bottom').
+ *
+ * @remarks
+ * If an unknown value is provided, the function defaults to 'middle'.
+ */
+export declare function dataAlignVerticalAsText(dataAlignVertical: DataAlignVertical): string;

package/lib/utils/data-type-as-text.d.ts

@@ -0,0 +1,11 @@
+import { DataType } from "../enums";
+/**
+ * Converts a `DataType` enum value to its corresponding string representation.
+ *
+ * @param dataType - The data type enum value.
+ * @returns The string representation of the data type ('text', 'numeric', 'boolean', or 'date').
+ *
+ * @remarks
+ * If an unknown value is provided, the function defaults to 'text'.
+ */
+export declare function dataTypeAsText(dataType: DataType): string;

package/lib/utils/frozen-column-align-as-text.d.ts

@@ -0,0 +1,11 @@
+import { FrozenColumnAlign } from "../enums";
+/**
+ * Converts a `FrozenColumnAlign` enum value to its corresponding CSS alignment string.
+ *
+ * @param frozenColumnAlign - The frozen column alignment enum value.
+ * @returns The CSS alignment string ('left' or 'right').
+ *
+ * @remarks
+ * If an unknown value is provided, the function defaults to 'left'.
+ */
+export declare function frozenColumnAlignAsText(frozenColumnAlign: FrozenColumnAlign): string;

package/lib/utils/highlight-text.d.ts

@@ -0,0 +1,17 @@
+import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
+import { IColumnMetadata } from "../interfaces";
+/**
+ * Generates sanitized HTML (`SafeHtml`) with highlighted text based on a global search term.
+ *
+ * @remarks
+ * This utility safely creates HTML content where occurrences of the provided global search text
+ * within the cell value are wrapped in a `<span class="highlighted-text">` tag for visual emphasis.
+ * If the cell does not match the search text or is of type `Boolean`, the original value is returned as safe HTML.
+ *
+ * @param {any} cellValue - The cell's value that may contain the text to highlight.
+ * @param {IColumnMetadata} colMetadata - Metadata configuration of the column that defines its data type and filtering behavior.
+ * @param {string | null} globalSearchText - The search text to highlight if found within the cell's content.
+ * @param {DomSanitizer} sanitizer - Angular's sanitizer used to safely produce trusted HTML content.
+ * @returns {SafeHtml} A `SafeHtml` instance containing highlighted HTML when a match is found, or the original sanitized text otherwise.
+ */
+export declare function highlightText(cellValue: any, colMetadata: IColumnMetadata, globalSearchText: string | null, sanitizer: DomSanitizer): SafeHtml;

package/lib/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./create-table-options";
+export * from "./data-align-horizontal-as-text";
+export * from "./data-align-vertical-as-text";
+export * from "./data-type-as-text";
+export * from "./frozen-column-align-as-text";
+export * from "./highlight-text";

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@competer/primeng-table",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "19.1.8",
+  "description": "Community-maintained fork of ECS. Reusable Angular PrimeNG table component with advanced server-side filters. Designed to offload filtering logic to any backend API.",
+  "author": "ECS (Eternal CODE Studio); ComPeter",
+  "license": "MIT",
+  "keywords": [
+    "angular",
+    "primeng",
+    "table",
+    "ecs",
+    "datatable",
+    "component",
+    "ui"
+  ],
+  "peerDependencies": {
+    "@angular/common": ">=19.0.0",
+    "@angular/core": ">=19.0.0",
+    "@angular/animations": ">=19.0.0",
+    "primeng": ">=19.0.0",
+    "primeicons": ">=7.0.0",
+    "@ngx-translate/core": "^17.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/competergiga/ECSPrimengTable.git"
+  },
+  "bugs": {
+    "url": "https://github.com/competergiga/ECSPrimengTable/issues"
+  },
+  "homepage": "https://github.com/competergiga/ECSPrimengTable/tree/Angular19-publish",
+  "sideEffects": false,
+  "module": "fesm2022/competer-primeng-table.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/competer-primeng-table.mjs"
+    }
+  }
 }

package/public-api.d.ts

@@ -0,0 +1,9 @@
+export * from './lib/enums';
+export * from './lib/interfaces/columns-metadata.interface';
+export * from './lib/interfaces/predefined-filter.interface';
+export * from './lib/interfaces/table-button.interface';
+export * from './lib/interfaces/table-options.interface';
+export * from "./lib/utils/create-table-options";
+export * from './lib/services';
+export * from './lib/components/ecs-primeng-table/ecs-primeng-table';
+export * from './lib/components/ecs-primeng-table/ecs-primeng-table.service';