@sumaris-net/ngx-components 18.6.32 → 18.6.34

package/fesm2022/sumaris-net.ngx-components.mjs

@@ -670,6 +670,12 @@ function sleep(ms) {
 function isPromise(value) {
     return typeof value?.['then'] === 'function' && typeof value?.['catch'] === 'function';
 }
+/**
+ * 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.
+ */
 function round(value) {
     if (isNotNilOrNaN(value)) {
         return Math.round((value + Number.EPSILON) * 100) / 100;
@@ -27707,7 +27713,7 @@ class PrintService {
     translate;
     storage;
     document;
-    printId = 0;
+    _printId = 0;
     constructor(toastController, translate, storage, document) {
         this.toastController = toastController;
         this.translate = translate;
@@ -27715,7 +27721,7 @@ class PrintService {
         this.document = document;
     }
     nextJobId() {
-        return ++this.printId;
+        return ++this._printId;
     }
     /**
      * Extracts and returns the job ID from a given URL.
@@ -27726,16 +27732,22 @@ class PrintService {
     getJobId(url) {
         url = url || window.location.href;
         const matches = url.match(/print-id=(\d+)/);
-        return toNumber(matches?.[1], undefined);
+        return matches?.[1] || undefined;
     }
-    isPrintingUrl(url) {
+    /**
+     * Determines whether the provided URL or the current page's URL contains
+     * a specific query parameter, indicating it's a printing-related URL.
+     *
+     * @param {string} [url] - The optional URL to check. If not provided, the current page's URL is used.
+     * @param {string} [queryParam='print-id'] - The query parameter to look for, defaulting to 'print-id'.
+     * @return {boolean} Returns true if the query parameter is found in the URL; otherwise, false.
+     */
+    isPrintingUrl(url, queryParam = 'print-id') {
         let query;
         if (isNotNilOrBlank(url))
             query = new URL(url).search;
         query = query || window.location.search || '?';
-        return (query.indexOf('print-id=') !== -1 ||
-            // For compatibility
-            query.indexOf('print-pdf') !== -1);
+        return query.indexOf(queryParam) !== -1;
     }
     async printElement(element, opts) {
         if (!element)
@@ -27749,18 +27761,35 @@ class PrintService {
         const iframe = this.createPrintIframeByHtml(html, opts);
         return this.printIframe(iframe, opts);
     }
+    /**
+     * 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.
+     */
     async printUrl(url, opts) {
         if (isNilOrBlank(url))
             throw new Error("Missing required 'url' argument");
+        const jobId = opts?.id ?? this.nextJobId();
         // Create iframe
-        const iframe = this.createPrintIframeByUrl(url, opts);
+        const iframe = this.createPrintIframeByUrl(url, { id: jobId });
+        // Launch the print job
         return this.printIframe(iframe, opts);
     }
+    /**
+     * 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.
+     */
     async printIframe(iframe, opts) {
         if (!iframe)
             throw new Error("Missing required 'iframe' argument");
-        const printId = opts?.id ?? this.printId++;
-        const toastId = `printing-${printId}`;
+        const jobId = opts?.id ?? this.nextJobId();
+        const toastId = `printing-${jobId}`;
         const showLoadingToast = opts?.showToast !== false;
         if (showLoadingToast)
             await this.showToast({
@@ -27770,9 +27799,10 @@ class PrintService {
             });
         try {
             // Wait end of iframe load
-            await this.waitIdle(iframe, { id: printId });
+            await this.waitIdle(iframe, { id: jobId });
             // Print (and wait end of print)
             await this.print(iframe);
+            return jobId;
         }
         catch (err) {
             console.error('[print-service] Failed to create hidden iframe', err);
@@ -27897,7 +27927,7 @@ class PrintService {
     }
     async waitIdle(iframe, opts) {
         // Wait job finished
-        const printId = opts?.id || this.printId;
+        const printId = opts?.id || this._printId;
         await waitForTrue(timer(500, 500).pipe(mergeMap$1(() => this.isLoaded(printId))), { timeout: opts?.timeout });
         // Wait end of iframe load
         await new Promise((resolve, reject) => {