@sumaris-net/ngx-components 18.6.33 → 18.6.34

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sumaris-net/ngx-components",
   "description": "SUMARiS Angular components",
-  "version": "18.6.33",
+  "version": "18.6.34",
   "author": "contact@e-is.pro",
   "license": "AGPL-3.0",
   "readmeFilename": "README.md",

package/src/app/shared/functions.d.ts

@@ -88,6 +88,12 @@ export declare function getPropertyByPathAsString(obj: any, path: string | strin
 export declare function setPropertyByPath<T = any>(obj: T, path: string | string[], value: any): T;
 export declare function sleep(ms: number): Promise<void>;
 export declare function isPromise<T>(value: T | Promise<T>): value is Promise<T>;
+/**
+ * Rounds a numeric value to two decimal places.
+ *
+ * @param {number | undefined | null} value - The value to be rounded. Can be a number, undefined, or null.
+ * @return {number} The rounded value with two decimal places if the input value is a valid number; otherwise, returns the input value.
+ */
 export declare function round(value: number | undefined | null): number;
 export declare function equalsOrNil(value1: any, value2: any): boolean;
 /**

package/src/app/shared/print/print.service.d.ts

@@ -16,7 +16,7 @@ export declare class PrintService {
     protected translate: TranslateService;
     protected storage: StorageService;
     protected document: Document;
-    private printId;
+    private _printId;
     constructor(toastController: ToastController, translate: TranslateService, storage: StorageService, document: Document);
     nextJobId(): number;
     /**
@@ -25,7 +25,7 @@ export declare class PrintService {
      * @param {string} [url] - The URL from which to extract the job ID. If not provided, `window.location.href` will be used.
      * @return {number | undefined} The extracted job ID as a number, or `undefined` if the job ID is not present or invalid.
      */
-    getJobId(url?: string): number | undefined;
+    getJobId(url?: string): string | undefined;
     /**
      * Determines whether the provided URL or the current page's URL contains
      * a specific query parameter, indicating it's a printing-related URL.
@@ -35,10 +35,25 @@ export declare class PrintService {
      * @return {boolean} Returns true if the query parameter is found in the URL; otherwise, false.
      */
     isPrintingUrl(url?: string, queryParam?: string): boolean;
-    printElement(element: HTMLElement, opts?: PrintOptions): Promise<void>;
-    printHTML(html: string, opts?: PrintOptions): Promise<void>;
-    printUrl(url: string, opts?: Omit<PrintOptions, 'style'>): Promise<void>;
-    printIframe(iframe: HTMLIFrameElement, opts?: PrintOptions): Promise<void>;
+    printElement(element: HTMLElement, opts?: PrintOptions): Promise<number | string>;
+    printHTML(html: string, opts?: PrintOptions): Promise<number | string>;
+    /**
+     * Prints the content of a URL by rendering it in an iframe.
+     *
+     * @param {string} url The URL of the content to print. This parameter is required.
+     * @param {Omit<PrintOptions, 'style'>} [opts] Optional settings for printing, excluding the 'style' option.
+     * @return {Promise<number>} A promise that resolves to the ID of the print job.
+     */
+    printUrl(url: string, opts?: Omit<PrintOptions, 'style'>): Promise<number | string>;
+    /**
+     * Prints the content of the specified iframe element.
+     *
+     * @param {HTMLIFrameElement} iframe - The iframe element whose content needs to be printed. Must be a valid and loaded iframe element.
+     * @param {PrintOptions} [opts] - Optional parameters for the print operation, which may include options for toast messages and job configuration.
+     * @return {Promise<number>} A promise that resolves to the unique ID of the print job.
+     * @throws Will throw an error if the required 'iframe' argument is missing or invalid.
+     */
+    printIframe(iframe: HTMLIFrameElement, opts?: PrintOptions): Promise<number | string>;
     markAsLoading(id: string | number): Promise<void>;
     markAsLoaded(id: string | number): Promise<void>;
     isLoaded(id: string | number): Promise<boolean>;

package/src/assets/manifest.json

@@ -2,7 +2,7 @@
   "name": "ngx-sumaris-components",
   "short_name": "ngx-sumaris-components",
   "manifest_version": 1,
-  "version": "18.6.33",
+  "version": "18.6.34",
   "default_locale": "fr",
   "description": "Angular components for building beautiful and responsive Apps",
   "icons": [{