@webilix/ngx-helper-m3 0.0.12 → 0.0.14

package/lib/components/loader/ngx-helper-loader.component.d.ts

@@ -1,13 +1,16 @@
-import { OnChanges, SimpleChanges } from '@angular/core';
+import { OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import * as i0 from "@angular/core";
-export declare class NgxHelperLoaderComponent implements OnChanges {
+export declare class NgxHelperLoaderComponent implements OnInit, OnChanges {
     loaderSize: string;
     loaderColor: string;
     mode: 'SPINNER' | 'DOTS-SPINNER' | 'WHEEL-SPINNER';
     size: number;
     color: string;
     padding?: string;
+    margin?: string;
+    ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    init(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxHelperLoaderComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NgxHelperLoaderComponent, "ngx-helper-loader", never, { "mode": { "alias": "mode"; "required": true; }; "size": { "alias": "size"; "required": false; }; "color": { "alias": "color"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NgxHelperLoaderComponent, "ngx-helper-loader", never, { "mode": { "alias": "mode"; "required": false; }; "size": { "alias": "size"; "required": false; }; "color": { "alias": "color"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; "margin": { "alias": "margin"; "required": false; }; }, {}, never, never, true, never>;
 }

package/lib/components/progress/ngx-helper-progress.component.d.ts

@@ -0,0 +1,20 @@
+import { OnChanges, SimpleChanges } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class NgxHelperProgressComponent implements OnChanges {
+    private className;
+    borderRadiusCSS: string;
+    backgroundColorCSS: string;
+    value: number | {
+        done: number;
+        total: number;
+    };
+    align: 'LR' | 'RL' | 'TB' | 'BT';
+    borderRadius: string;
+    progressColor: string;
+    backgroundColor?: string;
+    size: string;
+    direction: 'H' | 'V';
+    ngOnChanges(changes: SimpleChanges): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxHelperProgressComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NgxHelperProgressComponent, "ngx-helper-progress", never, { "value": { "alias": "value"; "required": true; }; "align": { "alias": "align"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "progressColor": { "alias": "progressColor"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; }, {}, never, ["*"], true, never>;
+}

package/lib/http/download/download.component.d.ts

@@ -0,0 +1,25 @@
+import { AfterViewInit } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { NgxHelperToastService } from '../../toast/ngx-helper-toast.service';
+import { INgxHelperHttpDownloadConfig } from '../ngx-helper-http.interface';
+import * as i0 from "@angular/core";
+export declare class DownloadComponent implements AfterViewInit {
+    private readonly httpClient;
+    private readonly ngxHelperToastService;
+    private host;
+    private className;
+    bottom: string;
+    id: string;
+    path: string;
+    title: string;
+    config: Partial<INgxHelperHttpDownloadConfig>;
+    onSuccess: (arrayBuffer: ArrayBuffer) => void;
+    onError: () => void;
+    close: () => void;
+    progress: number;
+    constructor(httpClient: HttpClient, ngxHelperToastService: NgxHelperToastService);
+    ngAfterViewInit(): void;
+    download(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DownloadComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DownloadComponent, "ng-component", never, {}, {}, never, never, true, never>;
+}

package/lib/http/ngx-helper-http.interface.d.ts

@@ -1,3 +1,9 @@
+export interface INgxHelperHttpDownloadConfig {
+    readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH';
+    readonly header: {
+        [key: string]: any;
+    };
+}
 export interface INgxHelperHttpUploadConfig {
     readonly method: 'POST' | 'PUT' | 'PATCH';
     readonly header: {

package/lib/http/ngx-helper-http.service.d.ts

@@ -1,16 +1,27 @@
 import { ApplicationRef, Injector } from '@angular/core';
 import { HttpStatusCode } from '@angular/common/http';
-import { INgxHelperHttpUploadConfig } from './ngx-helper-http.interface';
+import { NgxHelperToastService } from '../toast/ngx-helper-toast.service';
+import { INgxHelperHttpDownloadConfig, INgxHelperHttpUploadConfig } from './ngx-helper-http.interface';
 import * as i0 from "@angular/core";
 export declare class NgxHelperHttpService {
     private readonly applicationRef;
     private readonly injector;
+    private readonly ngxHelperToastService;
     private components;
-    constructor(applicationRef: ApplicationRef, injector: Injector);
+    constructor(applicationRef: ApplicationRef, injector: Injector, ngxHelperToastService: NgxHelperToastService);
     private getId;
     private updatePositions;
+    private getBuffer;
+    download(path: string, title: string): void;
+    download(path: string, title: string, config: Partial<INgxHelperHttpDownloadConfig>): void;
     upload<R, E>(file: File, url: string, onSuccess: (response: R | undefined, status: HttpStatusCode) => void, onError: (error: E | undefined, status: HttpStatusCode) => void): void;
     upload<R, E>(file: File, url: string, config: Partial<INgxHelperHttpUploadConfig>, onSuccess: (response: R, status: HttpStatusCode) => void, onError: (error: E, status: HttpStatusCode) => void): void;
+    printPDF(url: string): void;
+    printPDF(url: string, config: Partial<INgxHelperHttpDownloadConfig>): void;
+    printPDF(buffer: ArrayBuffer): void;
+    printPDF(buffer: ArrayBuffer, config: Partial<INgxHelperHttpDownloadConfig>): void;
+    printPDF(blob: Blob): void;
+    printPDF(blob: Blob, config: Partial<INgxHelperHttpDownloadConfig>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxHelperHttpService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<NgxHelperHttpService>;
 }

package/lib/http/upload/upload.component.d.ts

@@ -4,8 +4,8 @@ import { INgxHelperHttpUploadConfig } from '../ngx-helper-http.interface';
 import * as i0 from "@angular/core";
 export declare class UploadComponent<R, E> implements AfterViewInit {
     private readonly httpClient;
-    private className;
     private host;
+    private className;
     bottom: string;
     id: string;
     file: File;

package/lib/ngx-helper.config.d.ts

@@ -2,6 +2,11 @@ import { EnvironmentProviders, InjectionToken } from '@angular/core';
 export interface INgxHelperConfig {
     readonly mobileWidth: number;
     readonly pageGroupSidebarWidth: string;
+    readonly toastTimeout: number;
+    readonly toastXPosition: 'LEFT' | 'CENTER' | 'RIGHT';
+    readonly toastAllowDuplicates: boolean;
+    readonly toastResetDuplicates: boolean;
+    readonly toastProgressAnimation: 'DECREASE' | 'INCREASE';
     readonly stickyView: {
         readonly top?: string | {
             readonly desktopView: string;

package/lib/toast/ngx-helper-toast.interface.d.ts

@@ -0,0 +1,4 @@
+export interface INgxHelperToastConfig {
+    readonly timeout: number;
+    readonly showClose: boolean;
+}

package/lib/toast/ngx-helper-toast.service.d.ts

@@ -0,0 +1,41 @@
+import { ApplicationRef, Injector } from '@angular/core';
+import { INgxHelperConfig } from '../ngx-helper.config';
+import { INgxHelperToastConfig } from './ngx-helper-toast.interface';
+import * as i0 from "@angular/core";
+interface IToast {
+    readonly icon: string;
+    readonly textColor: string;
+    readonly backgroundColor: string;
+}
+export declare class NgxHelperToastService {
+    private readonly applicationRef;
+    private readonly injector;
+    private readonly config?;
+    private components;
+    constructor(applicationRef: ApplicationRef, injector: Injector, config?: Partial<INgxHelperConfig> | undefined);
+    private getId;
+    private updatePositions;
+    toast(toast: IToast, message: string | string[]): void;
+    toast(toast: IToast, message: string | string[], config: Partial<INgxHelperToastConfig>): void;
+    toast(toast: IToast, message: string | string[], onClose: () => void): void;
+    toast(toast: IToast, message: string | string[], config: Partial<INgxHelperToastConfig>, onClose: () => void): void;
+    info(message: string | string[]): void;
+    info(message: string | string[], config: Partial<INgxHelperToastConfig>): void;
+    info(message: string | string[], onClose: () => void): void;
+    info(message: string | string[], config: Partial<INgxHelperToastConfig>, onClose: () => void): void;
+    success(message: string | string[]): void;
+    success(message: string | string[], config: Partial<INgxHelperToastConfig>): void;
+    success(message: string | string[], onClose: () => void): void;
+    success(message: string | string[], config: Partial<INgxHelperToastConfig>, onClose: () => void): void;
+    warning(message: string | string[]): void;
+    warning(message: string | string[], config: Partial<INgxHelperToastConfig>): void;
+    warning(message: string | string[], onClose: () => void): void;
+    warning(message: string | string[], config: Partial<INgxHelperToastConfig>, onClose: () => void): void;
+    error(message: string | string[]): void;
+    error(message: string | string[], config: Partial<INgxHelperToastConfig>): void;
+    error(message: string | string[], onClose: () => void): void;
+    error(message: string | string[], config: Partial<INgxHelperToastConfig>, onClose: () => void): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxHelperToastService, [null, null, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NgxHelperToastService>;
+}
+export {};

package/lib/toast/toast/toast.component.d.ts

@@ -0,0 +1,35 @@
+import { AfterViewInit, ElementRef, OnDestroy, OnInit } from '@angular/core';
+import { INgxHelperConfig } from '../../ngx-helper.config';
+import { INgxHelperToastConfig } from '../ngx-helper-toast.interface';
+import * as i0 from "@angular/core";
+export declare class ToastComponent implements OnInit, OnDestroy, AfterViewInit {
+    readonly elementRef: ElementRef;
+    private onClick;
+    private host;
+    private className;
+    top: string;
+    textColor: string;
+    borderColor: string;
+    backgroundColor: string;
+    id: string;
+    icon: string;
+    messages: string[];
+    config: {
+        helper?: Partial<INgxHelperConfig>;
+        toast: Partial<INgxHelperToastConfig>;
+    };
+    init: () => void;
+    close: () => void;
+    timeout: number;
+    showClose: boolean;
+    animation: 'DECREASE' | 'INCREASE';
+    progress: number;
+    start: number;
+    private interval?;
+    constructor(elementRef: ElementRef);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    ngAfterViewInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToastComponent, "ng-component", never, {}, {}, never, never, true, never>;
+}

package/ngx-helper-m3.css

@@ -109,9 +109,21 @@
             flex: 1;
 
             font-size: 90%;
-
             text-align: left;
             direction: ltr;
+            font-family: Roboto, 'Helvetica Neue', sans-serif;
+
+            white-space: nowrap;
+            overflow: hidden;
+            text-overflow: ellipsis;
+        }
+
+        .title {
+            flex: 1;
+
+            font-size: 90%;
+            text-align: right;
+            direction: rtl;
 
             white-space: nowrap;
             overflow: hidden;
@@ -137,6 +149,93 @@
     }
 }
 
+/* NGX HELPER TOAST */
+.ngx-helper-m3-toast {
+    position: fixed;
+
+    display: block;
+    direction: rtl;
+    width: calc(100vw - 4rem);
+    max-width: 350px;
+    transition: top 0.35s ease-out;
+    z-index: 5000;
+    border-radius: 8px;
+    cursor: pointer;
+    box-sizing: border-box;
+    overflow: hidden;
+    border: 1px solid transparent;
+
+    .content {
+        display: flex;
+        align-items: flex-start;
+        column-gap: 0.5rem;
+
+        .toast {
+            flex: 1;
+
+            display: flex;
+            align-items: center;
+            column-gap: 1rem;
+
+            padding-right: 1rem;
+
+            ul {
+                flex: 1;
+                list-style: none;
+                margin: 0;
+                padding: 1rem 0 1rem 1rem;
+
+                li {
+                    margin: 0;
+                    padding: 0;
+                    font-weight: 500;
+                    line-height: 1.45;
+                    padding-top: 0.25rem;
+                }
+
+                li:first-of-type {
+                    padding-top: 0;
+                }
+            }
+
+            mat-icon.icon {
+                font-size: 26px;
+            }
+        }
+
+        mat-icon.close {
+            padding: 1rem 0 0 1rem;
+        }
+    }
+
+    .progress-container {
+        width: 100%;
+        height: 4px;
+        position: relative;
+
+        .progress-value {
+            position: absolute;
+            top: 0;
+            bottom: 0;
+            left: 0;
+
+            transition: all 0.35s ease-out;
+        }
+    }
+}
+.ngx-helper-m3-toast.center {
+    left: 50%;
+    transform: translate(-50%, 0);
+}
+
+.ngx-helper-m3-toast.left {
+    left: 1rem;
+}
+
+.ngx-helper-m3-toast.right {
+    right: 1rem;
+}
+
 /* NGX HELPER VALUE LIST */
 .ngx-helper-m3-box {
     display: block;
@@ -404,6 +503,63 @@
     }
 }
 
+/* NGX HELPER PROGRESS */
+.ngx-helper-m3-progress {
+    display: block;
+    position: relative;
+    direction: rtl;
+    overflow: hidden;
+
+    .progress {
+        position: absolute;
+        transition: width 0.35s ease-out, height 0.35s ease-out;
+    }
+
+    .content {
+        position: relative;
+    }
+}
+
+.ngx-helper-m3-progress.LR,
+.ngx-helper-m3-progress.RL {
+    .progress {
+        top: 0;
+        bottom: 0;
+    }
+}
+
+.ngx-helper-m3-progress.LR {
+    .progress {
+        left: 0;
+    }
+}
+
+.ngx-helper-m3-progress.RL {
+    .progress {
+        right: 0;
+    }
+}
+
+.ngx-helper-m3-progress.TB,
+.ngx-helper-m3-progress.BT {
+    .progress {
+        right: 0;
+        left: 0;
+    }
+}
+
+.ngx-helper-m3-progress.TB {
+    .progress {
+        top: 0;
+    }
+}
+
+.ngx-helper-m3-progress.BT {
+    .progress {
+        bottom: 0;
+    }
+}
+
 /* NGX HELPER VALUE BOX */
 .ngx-helper-m3-value-box {
     display: grid;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webilix/ngx-helper-m3",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "author": "Ali Amirnezhad",
   "description": "Helper library for Angular and Material 3",
   "repository": {
@@ -20,9 +20,9 @@
   },
   "homepage": "https://github.com/webilix/ngx-helper-m3#readme",
   "peerDependencies": {
-    "@angular/common": ">=19.0.4",
-    "@angular/core": ">=19.0.4",
-    "@angular/material": ">=19.0.3",
+    "@angular/common": ">=19.0.5",
+    "@angular/core": ">=19.0.5",
+    "@angular/material": ">=19.0.4",
     "@webilix/helper-library": ">=6.0.2",
     "@webilix/jalali-date-time": ">=2.0.5"
   },

package/public-api.d.ts

@@ -6,6 +6,7 @@ export * from './lib/components/card/ngx-helper-card.interface';
 export * from './lib/components/loader/ngx-helper-loader.component';
 export * from './lib/components/page-group/ngx-helper-page-group.component';
 export * from './lib/components/page-group/ngx-helper-page-group.interface';
+export * from './lib/components/progress/ngx-helper-progress.component';
 export * from './lib/components/section/ngx-helper-section-sticky.directive';
 export * from './lib/components/section/ngx-helper-section.component';
 export * from './lib/components/section/column/ngx-helper-section-column.component';
@@ -31,3 +32,5 @@ export * from './lib/container/container.interface';
 export * from './lib/container/container.service';
 export * from './lib/http/ngx-helper-http.interface';
 export * from './lib/http/ngx-helper-http.service';
+export * from './lib/toast/ngx-helper-toast.interface';
+export * from './lib/toast/ngx-helper-toast.service';