@sumaris-net/ngx-components 18.12.0 → 18.12.1

package/src/app/shared/platforms.ts

@@ -1,99 +0,0 @@
-/* ---
- * Source: https://github.com/ionic-team/ionic-framework/blob/b0d53ca73619585671d8cf4dc24e47f826495a0a/core/src/utils/platform.ts
- * --- */
-
-const _cache = {
-  userAgent: null,
-  mobile: null,
-  cordova: null,
-  capacitor: null,
-};
-
-export function matchMedia(win: Window, query: string): boolean {
-  return win.matchMedia(query).matches;
-}
-
-export function getUserAgent(win: Window): string {
-  if (!_cache.userAgent) {
-    _cache.userAgent = win.navigator.userAgent || win.navigator.vendor || (window as any).opera;
-  }
-  return _cache.userAgent;
-}
-
-export function testUserAgent(win: Window, expr: RegExp) {
-  const userAgent: string = getUserAgent(win);
-  return expr.test(userAgent);
-}
-
-export function isWindows(win?: Window) {
-  return testUserAgent(win, /windows/i);
-}
-
-export function isFirefox(win?: Window) {
-  return testUserAgent(win, / firefox\//i);
-}
-
-export function isSafari(win?: Window) {
-  return !isChrome(win) /*Exclude chromium*/ && testUserAgent(win, / safari\//i);
-}
-
-export function isChrome(win?: Window) {
-  return testUserAgent(win, / chrome\//i);
-}
-
-export function isEdge(win?: Window) {
-  return testUserAgent(win, /edge/i);
-}
-
-export function isTouchUi(win?: Window) {
-  return matchMedia(win, '(any-pointer:coarse)');
-}
-
-export function isIpad(win: Window) {
-  // iOS 12 and below
-  if (testUserAgent(win, /iPad/i)) {
-    return true;
-  }
-
-  // iOS 13+
-  if (testUserAgent(win, /Macintosh/i) && isTouchUi(win)) {
-    return true;
-  }
-
-  return false;
-}
-
-export function isMacOS(win: Window) {
-  // iOS (but not iPad)
-  return testUserAgent(win, /Macintosh/i) && !isTouchUi(win);
-}
-
-export function isIOS(win: Window) {
-  return testUserAgent(win, /iPhone|iPod/i) || isIpad(win);
-}
-
-export function isAndroid(win: Window) {
-  return testUserAgent(win, /android|sink/i);
-}
-
-export function isCapacitor(win: any): boolean {
-  if (_cache.capacitor === null || _cache.capacitor === undefined) {
-    _cache.capacitor = !!(win['Capacitor'] || win['capacitor']);
-  }
-  return _cache.capacitor;
-}
-
-export function isMobile(win: Window) {
-  if (_cache.mobile === null || _cache.mobile === undefined) {
-    _cache.mobile =
-      isAndroid(win) ||
-      (isIOS(window) && isTouchUi(win)) ||
-      // Workaround, for MS Windows touch screen (detected as mobile, but forced as desktop)
-      (isTouchUi(win) && !isWindows(win));
-  }
-  return _cache.mobile;
-}
-
-export function isPrint(win?: Window) {
-  return matchMedia(win, 'print');
-}

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

@@ -1,337 +0,0 @@
-import { ShowToastOptions, Toasts } from '../toast/toasts';
-import { OverlayEventDetail } from '@ionic/core';
-import { ToastController } from '@ionic/angular';
-import { TranslateService } from '@ngx-translate/core';
-import { Inject, Injectable } from '@angular/core';
-import { DOCUMENT } from '@angular/common';
-import { StorageService } from '../storage/storage.service';
-import { isNil, isNilOrBlank, isNotNil, isNotNilOrBlank } from '../functions';
-import { waitForTrue } from '../observables';
-import { mergeMap, timer } from 'rxjs';
-import { isChrome } from '../platforms';
-
-export interface PrintOptions {
-  id?: string | number;
-  title?: string;
-  showToast?: boolean;
-  toastMessage?: string;
-  style?: string;
-}
-
-export const PRINT_LOADING_STORAGE_KEY_PREFIX = 'print-loading-';
-export const PRINT_ID_QUERY_PARAM = 'print-id';
-
-@Injectable({ providedIn: 'root' })
-export class PrintService {
-  private _printId = 0;
-
-  constructor(
-    protected toastController: ToastController,
-    protected translate: TranslateService,
-    protected storage: StorageService,
-    @Inject(DOCUMENT) protected document: Document
-  ) {}
-
-  nextJobId(): number {
-    return ++this._printId;
-  }
-
-  /**
-   * Extracts and returns the job ID from a given URL.
-   *
-   * @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): string | undefined {
-    url = url || window.location.href;
-    const matches = url.match(/print-id=(\d+)/);
-    return matches?.[1] || undefined;
-  }
-
-  /**
-   * 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?: string, queryParam: string = 'print-id'): boolean {
-    let query: string;
-    if (isNotNilOrBlank(url)) query = new URL(url).search;
-    query = query || window.location.search || '?';
-    return query.indexOf(queryParam) !== -1;
-  }
-
-  async printElement(element: HTMLElement, opts?: PrintOptions): Promise<number | string> {
-    if (!element) throw new Error("Missing required 'element' argument");
-
-    return this.printHTML(element.innerHTML, opts);
-  }
-
-  async printHTML(html: string, opts?: PrintOptions): Promise<number | string> {
-    if (!html) throw new Error("Missing required 'html' argument");
-
-    // Create iframe
-    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: string, opts?: Omit<PrintOptions, 'style'>): Promise<number | string> {
-    if (isNilOrBlank(url)) throw new Error("Missing required 'url' argument");
-
-    const jobId = opts?.id ?? this.nextJobId();
-
-    // Create iframe
-    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: HTMLIFrameElement, opts?: PrintOptions): Promise<number | string> {
-    if (!iframe) throw new Error("Missing required 'iframe' argument");
-
-    const jobId = opts?.id ?? this.nextJobId();
-    const toastId = `printing-${jobId}`;
-    const showLoadingToast = opts?.showToast !== false;
-    if (showLoadingToast)
-      await this.showToast({
-        id: toastId,
-        message: opts?.toastMessage || 'COMMON.PLEASE_WAIT',
-        duration: 0,
-      });
-
-    try {
-      // Wait end of iframe load
-      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);
-    } finally {
-      iframe.remove();
-      if (showLoadingToast) await this.toastController.dismiss(null, null, toastId);
-    }
-  }
-
-  async markAsLoading(id: string | number) {
-    console.debug(`[print-service] Mark print job #${id} as loading`);
-    await this.storage.set(PRINT_LOADING_STORAGE_KEY_PREFIX + id, '1');
-  }
-
-  async markAsLoaded(id: string | number) {
-    console.debug(`[print-service] Mark print job #${id} as loaded`);
-    await this.storage.remove(PRINT_LOADING_STORAGE_KEY_PREFIX + id);
-  }
-
-  async isLoaded(id: string | number): Promise<boolean> {
-    const result = await this.storage.get(PRINT_LOADING_STORAGE_KEY_PREFIX + id);
-    return isNil(result);
-  }
-
-  async isLoading(id: string | number): Promise<boolean> {
-    return !(await this.isLoaded(id));
-  }
-
-  /* -- protected functions -- */
-
-  protected createPrintIframeByUrl(url: string, opts?: { id?: number | string }): HTMLIFrameElement {
-    // Make sure to add the job id inside the URL (e.g. to allow getJobIdFromUrl() to retrieve it)
-    if (isNotNil(opts?.id)) {
-      const newUrl = new URL(url);
-      newUrl.searchParams.set(PRINT_ID_QUERY_PARAM, '' + opts.id);
-      url = newUrl.href;
-    }
-
-    // Create a iframe with the given url
-    const iframe = this.document.createElement('iframe');
-    iframe.classList.add('cdk-visually-hidden');
-    iframe.style.width = '100%';
-    iframe.style.height = '100%';
-    this.document.body.appendChild(iframe);
-    iframe.src = url;
-    return iframe;
-  }
-
-  protected createPrintIframeByHtml(html: string, opts?: { title?: string; inlineStyle?: string }): HTMLIFrameElement {
-    if (!html) throw new Error("Missing required 'html' argument");
-
-    const lang = this.document.documentElement?.lang || 'en';
-
-    // Create an empty iframe
-    const iframe = this.document.createElement('iframe');
-    iframe.classList.add('cdk-visually-hidden');
-    iframe.style.width = '100%';
-    iframe.style.height = '100%';
-    this.document.body.appendChild(iframe);
-
-    // Write iframe content
-    const iframeDocument = iframe.contentDocument || iframe.contentWindow?.document;
-    if (iframeDocument) {
-      iframeDocument.open();
-      iframeDocument.write(`
-        <!DOCTYPE html>
-        <html lang="${lang}" class="print-pdf">
-          <head>
-            <title>${opts?.title || ''}</title>
-            <style>
-            @media print {
-              body {
-                font-family: 'Roboto', Helvetica, Arial, sans-serif;
-                margin: 0;
-                padding: 0;
-                overflow: hidden;
-              }
-              img {
-                max-width: 100%;
-                height: auto;
-                page-break-inside: avoid;
-              }
-            }
-            ${opts?.inlineStyle || ''}
-          </style>
-          </head>
-          <body>
-            ${html}
-          </body>
-        </html>
-      `);
-      iframeDocument.close();
-    }
-
-    // Set iframe style
-    // FIXME - Ignore style injection, because it failed in Firefox (e.g. on user manual) and Chrome (e.g. in privacy policy)
-    //         Nothing appear in the print dialog
-    //this.applyDocumentStyleToIframe(iframe);
-
-    return iframe;
-  }
-
-  /**
-   * Applies the styles from the provided document, including external stylesheets and inline styles,
-   * to the specified iframe's document.
-   *
-   * @param {HTMLIFrameElement} iframe - The iframe to which the styles are applied.
-   * @return {void} Does not return a value.
-   */
-  protected applyDocumentStyleToIframe(iframe: HTMLIFrameElement): void {
-    const iframeDocument = iframe.contentDocument || iframe.contentWindow?.document;
-    if (iframeDocument) {
-      // Récupérer tous les styles (liens CSS)
-      const links = Array.from(this.document.querySelectorAll('style,link[rel="stylesheet"]'));
-      links.forEach((element) => {
-        // Insert inline style
-        if (element.tagName === 'STYLE') {
-          const newStyle = iframeDocument.createElement('style');
-          newStyle.innerHTML = element.innerHTML;
-          iframeDocument.head.appendChild(newStyle);
-
-          console.debug('[print-service] Add style to iframe', newStyle);
-        }
-
-        // Insert link to stylesheet file
-        else if (element.tagName === 'LINK' && element.getAttribute('href')) {
-          const newLink = iframeDocument.createElement('link');
-          newLink.rel = 'stylesheet';
-          newLink.href = element.getAttribute('href');
-          iframeDocument.head.appendChild(newLink);
-
-          console.debug('[print-service] Add stylesheet to iframe: ', newLink.href);
-        }
-      });
-    }
-  }
-
-  protected async waitIdle(iframe: HTMLIFrameElement, opts?: { id?: number | string; timeout?: number }): Promise<void> {
-    // Wait job finished
-    const printId = opts?.id ?? this._printId;
-    await waitForTrue(timer(500, 500).pipe(mergeMap(() => this.isLoaded(printId))), { timeout: opts?.timeout });
-
-    // Wait end of iframe load
-    await new Promise<void>((resolve, reject) => {
-      const iframeWindow = iframe.contentWindow?.window || iframe.contentWindow;
-      if (iframeWindow.document.readyState === 'complete') {
-        resolve();
-      } else {
-        // Stop if timeout reached
-        if (opts?.timeout > 0) {
-          setTimeout(() => reject('timeout'), opts.timeout);
-        }
-
-        const readyListener = () => {
-          if (iframeWindow.document.readyState === 'complete') {
-            resolve();
-
-            iframeWindow.document.removeEventListener('readystatechange', readyListener);
-          }
-        };
-        iframeWindow.document.addEventListener('readystatechange', readyListener);
-      }
-    });
-  }
-
-  /**
-   * Triggers the print functionality of the given iframe and resolves or rejects based on the print completion or timeout.
-   *
-   * @param {HTMLIFrameElement} iframe - The iframe element to be printed.
-   * @param {{timeout?: number}} [opts] - An optional configuration object.
-   * @param {number} [opts.timeout] - The maximum time in milliseconds to wait for the print to complete before rejecting the promise.
-   * @return {Promise<void>} A promise that resolves after the print is completed or rejects if a timeout occurs.
-   */
-  protected print(iframe: HTMLIFrameElement, opts?: { timeout?: number }): Promise<void> {
-    return new Promise((resolve, reject) => {
-      const iframeWindow = iframe.contentWindow?.window || iframe.contentWindow;
-
-      // Stop if timeout reached
-      if (opts?.timeout > 0) {
-        setTimeout(() => reject('timeout'), opts.timeout);
-      }
-
-      // On Chrome
-      if (isChrome(window)) {
-        // Wait after print event, to resolve the promise
-        const afterPrintListener = () => {
-          console.debug('[print-service] After print');
-
-          resolve();
-
-          // Remove the listener
-          iframeWindow.removeEventListener('afterprint', afterPrintListener);
-        };
-        iframeWindow.addEventListener('afterprint', afterPrintListener);
-        iframe.contentWindow.window.print();
-      }
-
-      // Otherwise (e.g. Firefox)
-      else {
-        iframe.contentWindow.window.print();
-        resolve();
-      }
-    });
-  }
-
-  private async showToast<T = any>(opts: ShowToastOptions): Promise<OverlayEventDetail<T>> {
-    if (!this.toastController) throw new Error("Missing toastController in component's constructor");
-    return await Toasts.show(this.toastController, this.translate, opts);
-  }
-}

package/src/app/shared/regexps.ts

@@ -1,112 +0,0 @@
-export abstract class RegExpUtils {
-  private static _cachedSearchRegexps: { [key: string]: RegExp } = {};
-  private static _cachedSearchTexts: string[] = [];
-
-  private static MAX_CACHE_SIZE = 100;
-  private static SPECIAL_CHARACTERS_REGEXP = /[.\[\](){}\\$^|+*?]/g;
-  private static SPECIAL_CHARACTERS_REPLACEMENT_MAP = {
-    // Escape some characters
-    '.': '[.]', // Escape point
-    '(': '\\(', // Escape parenthesis
-    ')': '\\)', // Escape parenthesis
-    '[': '\\[', // Escape character class opening bracket
-    ']': '\\]', // Escape character class closing bracket
-    '{': '\\{', // Escape quantifier opening brace
-    '}': '\\}', // Escape quantifier closing brace
-    '\\': '\\\\', // Escape backslash itself
-    $: '\\$', // Escape dollar sign
-    '^': '\\^', // Escape caret
-    '|': '\\|', // Escape pipe (alternation)
-    '+': '\\+', // Escape plus
-
-    // Transform wildcard characters to regexp
-    '?': '.', // Exactly one character
-    '*': '.*', // Zero or more character
-  };
-
-  /**
-   * Cleans the provided search text by trimming whitespace and removing or condensing
-   * wildcard characters based on the specified options.
-   * (e.g. 'a**' becomes 'a', '*' becomes '', etc.)
-   *
-   * @param {string} searchText - The search text to be cleaned.
-   * @param {Object} [opts] - Optional settings for cleaning the search text.
-   * @param {boolean} [opts.anySearch] - If true, the search text is cleaned for any match. If false, search as a prefix
-   * @return {string} - The cleaned search text.
-   */
-  static cleanSearchText(searchText: string, opts: { trim?: boolean } = { trim: true }): string {
-    if (!searchText?.length) return searchText;
-
-    // DEBUG
-    //console.debug(`[regexp-utils] Cleaning searchText '${searchText}'`);
-
-    searchText = searchText.replace(/[*]{2,}/g, '*'); // Replace many '*' into only one
-
-    // Trim whitespace
-    if (opts?.trim !== false) {
-      searchText = searchText.trim();
-    }
-
-    // Remove trailing wildcard characters
-    searchText = searchText.replace(/^[*]+$/g, '');
-
-    // Clean any match expression
-    if (searchText === '*') return '';
-
-    return searchText;
-  }
-
-  /**
-   * Compiles a regular expression from the provided search text, using a static cache to store
-   * previously compiled regular expressions for faster retrieval.
-   *
-   * @param {string} searchText - The text to compile into a regular expression.
-   * @param flags
-   * @return {RegExp} - The compiled regular expression.
-   */
-  static compileSearchRegexp(searchText: string, flags = 'gi'): RegExp {
-    if (!searchText?.length) return null;
-
-    // Use cached regexp if exists
-    const cacheKey = searchText + '|' + flags;
-    const cachedRegexp = this._cachedSearchRegexps[cacheKey];
-    if (cachedRegexp) return cachedRegexp;
-
-    const searchRegexpText = searchText.replace(this.SPECIAL_CHARACTERS_REGEXP, (match) => this.SPECIAL_CHARACTERS_REPLACEMENT_MAP[match] || match);
-
-    // DEBUG
-    //console.debug(`[regexp-utils] Computing new regexp '${searchRegexpText}' from searchText '${searchText}'`);
-
-    const regexp = new RegExp(`[ ]*${searchRegexpText}`, flags);
-
-    // If cache is full: remove older cache element
-    if (this._cachedSearchTexts.length >= this.MAX_CACHE_SIZE) {
-      // DEBUG
-      //console.debug('[regexp-utils] Removing older cached regexp');
-
-      // Clear half cache's elements
-      while (this._cachedSearchTexts.length > this.MAX_CACHE_SIZE / 2) {
-        const cacheKeyToEvict = this._cachedSearchTexts.shift();
-        delete this._cachedSearchRegexps[cacheKeyToEvict];
-      }
-    }
-
-    // Add to static cache
-    this._cachedSearchRegexps[cacheKey] = regexp;
-    this._cachedSearchTexts.push(cacheKey);
-
-    return regexp;
-  }
-
-  static match(input: string, regexp: string | RegExp): boolean {
-    return !!input?.match(regexp) || false;
-  }
-
-  static matchUpperCase(input: string, regexp: string | RegExp): boolean {
-    return !!input?.toUpperCase().match(regexp) || false;
-  }
-
-  static hasWildcardCharacter(input: string): boolean {
-    return (input && (input.includes('*') || input.includes('?'))) || false;
-  }
-}