@sumaris-net/ngx-components 18.12.0 → 18.12.1

package/src/app/shared/pipes/pipes.module.ts

@@ -1,162 +0,0 @@
-import { NgModule } from '@angular/core';
-import { CommonModule } from '@angular/common';
-import { TranslateModule } from '@ngx-translate/core';
-import { IonicModule } from '@ionic/angular';
-import { DateFormatPipe } from './date-format.pipe';
-import { DateDiffDurationPipe } from './date-diff-duration.pipe';
-import { DateFromNowPipe } from './date-from-now.pipe';
-import { LatitudeFormatPipe, LatLongFormatPipe, LongitudeFormatPipe } from './latlong-format.pipe';
-import { NumberFormatPipe } from './number-format.pipe';
-import { HighlightPipe } from './highlight.pipe';
-import { FileSizePipe } from './file-size.pipe';
-import { DurationPipe } from './duration.pipe';
-import { EvenPipe, MathAbsPipe, OddPipe, RoundPipe } from './math.pipes';
-import {
-  ArrayDistinctPipe,
-  ArrayFilterPipe,
-  ArrayFirstPipe,
-  ArrayIncludesPipe,
-  ArrayJoinPipe,
-  ArrayLastPipe,
-  ArrayLengthPipe,
-  ArrayPluckPipe,
-  ArrayFindByPropertyPipe,
-  SplitArrayInChunksPipe,
-  EmptyArrayPipe,
-  NotEmptyArrayPipe,
-} from './arrays.pipe';
-import { MapGetPipe, MapKeysPipe, MapValuesPipe } from './maps.pipe';
-import { TranslatablePipe, TranslateContextPipe } from './translate-context.pipe';
-import { NgInitDirective } from './ng-init.pipe';
-import {
-  FormErrorPipe,
-  FormErrorTranslatePipe,
-  FormGetArrayPipe,
-  FormGetControlPipe,
-  FormGetGroupPipe,
-  FormGetPipe,
-  FormGetValuePipe,
-} from './form.pipes';
-import { BooleanFormatPipe, PropertyFormatPipe, PropertyGetPipe, ValueFormatPipe } from './property.pipes';
-import { MatColorPipe } from './colors.pipe';
-import { AsAnyPipe, AsArrayPipe, AsBooleanPipe, AsFloatLabelTypePipe, AsObservablePipe } from './types.pipes';
-import { MaskitoPlaceholderPipe } from './maskito.pipe';
-import {
-  IsEmptySelectionPipe,
-  IsMultipleSelectionPipe,
-  IsNotEmptySelectionPipe,
-  IsSelectedPipe,
-  IsSingleSelectionPipe,
-  SelectionLengthPipe,
-} from './selection.pipes';
-import { BadgeNumberPipe } from './badge.pipes';
-import {
-  CapitalizePipe,
-  IsNilOrBlankPipe,
-  IsNilOrNaNPipe,
-  IsNilPipe,
-  IsNotNilOrBlankPipe,
-  IsNotNilOrNaNPipe,
-  IsNotNilPipe,
-  StrIncludesPipe,
-  StrLengthPipe,
-  StrReplacePipe,
-  ToStringPipe,
-  TruncHtmlPipe,
-  TruncTextPipe,
-} from './string.pipes';
-import { NoHtmlPipe, SafeHtmlPipe, SafeStylePipe } from './html.pipes';
-import { DisplayWithPipe } from './display-with.pipe';
-import { IsValidDatePipe } from './dates.pipe';
-import { FirstFalsePipe, FirstPipe, FirstTruePipe, MapPipe } from './observable.pipes';
-import { AppendQueryParamsPipePipe } from './url.pipes';
-
-const components = [
-  PropertyGetPipe,
-  PropertyFormatPipe,
-  ValueFormatPipe,
-  DateFormatPipe,
-  DateDiffDurationPipe,
-  DurationPipe,
-  DateFromNowPipe,
-  LatLongFormatPipe,
-  LatitudeFormatPipe,
-  LongitudeFormatPipe,
-  HighlightPipe,
-  NumberFormatPipe,
-  FileSizePipe,
-  MathAbsPipe,
-  OddPipe,
-  EvenPipe,
-  RoundPipe,
-  NotEmptyArrayPipe,
-  EmptyArrayPipe,
-  ArrayLengthPipe,
-  ArrayFirstPipe,
-  ArrayLastPipe,
-  ArrayPluckPipe,
-  ArrayIncludesPipe,
-  ArrayFilterPipe,
-  ArrayJoinPipe,
-  ArrayDistinctPipe,
-  ArrayFindByPropertyPipe,
-  SplitArrayInChunksPipe,
-  MapGetPipe,
-  MapKeysPipe,
-  MapValuesPipe,
-  IsNilOrBlankPipe,
-  IsNotNilOrBlankPipe,
-  IsNilOrNaNPipe,
-  IsNotNilOrNaNPipe,
-  IsNotNilPipe,
-  IsNilPipe,
-  IsValidDatePipe,
-  ToStringPipe,
-  CapitalizePipe,
-  StrLengthPipe,
-  StrIncludesPipe,
-  StrReplacePipe,
-  TruncHtmlPipe,
-  TruncTextPipe,
-  AppendQueryParamsPipePipe,
-  BooleanFormatPipe,
-  TranslateContextPipe,
-  TranslatablePipe,
-  NgInitDirective,
-  FormErrorPipe,
-  FormErrorTranslatePipe,
-  FormGetPipe,
-  FormGetControlPipe,
-  FormGetArrayPipe,
-  FormGetGroupPipe,
-  FormGetValuePipe,
-  MatColorPipe,
-  AsAnyPipe,
-  AsArrayPipe,
-  AsObservablePipe,
-  AsFloatLabelTypePipe,
-  MaskitoPlaceholderPipe,
-  IsSelectedPipe,
-  IsNotEmptySelectionPipe,
-  IsEmptySelectionPipe,
-  SelectionLengthPipe,
-  IsMultipleSelectionPipe,
-  IsSingleSelectionPipe,
-  BadgeNumberPipe,
-  AsBooleanPipe,
-  SafeHtmlPipe,
-  SafeStylePipe,
-  NoHtmlPipe,
-  DisplayWithPipe,
-  FirstTruePipe,
-  FirstFalsePipe,
-  FirstPipe,
-  MapPipe,
-];
-
-@NgModule({
-  imports: [CommonModule, IonicModule, TranslateModule],
-  declarations: components,
-  exports: components,
-})
-export class SharedPipesModule {}

package/src/app/shared/pipes/property.pipes.ts

@@ -1,115 +0,0 @@
-import { inject, Injectable, Pipe, PipeTransform } from '@angular/core';
-import { booleanToString, getPropertyByPath, isNil, isNotNil, joinPropertiesPath } from '../functions';
-import { DateFormatService } from './date-format.pipe';
-import { FormFieldDefinition } from '../form/field.model';
-import { TranslateService } from '@ngx-translate/core';
-import { DateUtils } from '../dates';
-
-@Pipe({ name: 'propertyGet' })
-export class PropertyGetPipe implements PipeTransform {
-  transform(obj: any, args: string | Array<string | number> | { key: string; defaultValue?: any }): any {
-    return getPropertyByPath(
-      obj,
-      // Path
-      args && (typeof args === 'string' || Array.isArray(args) ? args : args.key),
-      // Default value
-      args && (args as any)?.defaultValue
-    );
-  }
-}
-
-abstract class AbstractValueFormatPipe {
-  private _i18nYes: string;
-  private _i18nNo: string;
-
-  private dateFormat = inject(DateFormatService);
-  private translate = inject(TranslateService);
-
-  get i18nYes(): string {
-    if (!this._i18nYes) {
-      this._i18nYes = this.translate.instant('COMMON.YES');
-    }
-    return this._i18nYes;
-  }
-
-  get i18nNo(): string {
-    if (!this._i18nNo) {
-      this._i18nNo = this.translate.instant('COMMON.NO');
-    }
-    return this._i18nNo;
-  }
-
-  protected valueToString(value: any, definition?: Partial<FormFieldDefinition>): string {
-    if (isNil(value)) return value;
-    const type = definition?.type || typeof value;
-    switch (type) {
-      case 'date':
-        const date = DateUtils.fromDateISOString(value);
-        return this.dateFormat.transform(date) as string;
-      case 'dateTime':
-        const dateTime = DateUtils.fromDateISOString(value);
-        return this.dateFormat.transform(dateTime, { time: true }) as string;
-      case 'enum': {
-        // DEBUG
-        // console.debug('formatProperty by definition (type='enum', key=' +definition.key+ '):', value );
-        const key = value.key ?? value;
-        const item = ((definition?.values as any[]) || [value]).find((item) => (isNotNil(item?.key) ? item.key : item) === key);
-        return item?.value ?? item ?? value;
-      }
-      case 'object':
-      case 'entity': {
-        if (typeof definition?.autocomplete?.displayWith === 'function') {
-          return definition.autocomplete.displayWith(value);
-        }
-        return joinPropertiesPath(value, definition?.autocomplete?.attributes || ['label', 'name']) || undefined;
-      }
-      case 'entities':
-      case 'enums': {
-        const values = Array.isArray(value) ? value : [value];
-        return values.map((val) => this.valueToString(val, { type: 'enum' })).join(', ');
-      }
-      case 'boolean':
-        return booleanToString(value, { yesLabel: this.i18nYes, noLabel: this.i18nNo });
-      case 'integer':
-      case 'double':
-      case 'string':
-      default:
-        return value;
-    }
-  }
-}
-
-@Pipe({
-  name: 'propertyFormat',
-})
-@Injectable({ providedIn: 'root' })
-export class PropertyFormatPipe extends AbstractValueFormatPipe implements PipeTransform {
-  transform(obj: any, args: string | Array<string | number> | FormFieldDefinition): string | Promise<string> {
-    if (!obj) return '';
-    const definition = typeof args === 'object' ? (args as FormFieldDefinition) : undefined;
-    const path = definition ? definition.key : (args as (string | number)[]);
-    const value = getPropertyByPath(obj, path);
-    return this.valueToString(value, definition);
-  }
-}
-
-@Pipe({
-  name: 'valueFormat',
-})
-@Injectable({ providedIn: 'root' })
-export class ValueFormatPipe extends AbstractValueFormatPipe implements PipeTransform {
-  transform(value: any, definition: FormFieldDefinition): string | Promise<string> {
-    return this.valueToString(value, definition);
-  }
-}
-
-@Pipe({
-  name: 'booleanFormat',
-})
-export class BooleanFormatPipe extends AbstractValueFormatPipe implements PipeTransform {
-  transform(value: any, opts?: { yesLabel: string; noLabel: string }): string {
-    if (isNil(value)) return value;
-    if (!opts) opts = { yesLabel: this.i18nYes, noLabel: this.i18nNo };
-    return booleanToString(value, opts);
-  }
-}

package/src/app/shared/pipes/selection.pipes.ts

@@ -1,165 +0,0 @@
-import { ChangeDetectorRef, OnDestroy, Pipe, PipeTransform } from '@angular/core';
-import { SelectionChange, SelectionModel } from '@angular/cdk/collections';
-import { Subscription } from 'rxjs';
-import { filter } from 'rxjs/operators';
-import { equals } from '../functions';
-
-@Pipe({
-  name: 'abstract-selection',
-})
-export abstract class AbstractSelectionModelPipe<T, R, O = void> implements PipeTransform, OnDestroy {
-  protected _result: R = undefined;
-
-  private _lastSelection: SelectionModel<any> | null = null;
-  private _lastValue: T;
-  private _lastOpts: O;
-  protected _shouldSubscribeToChanges = true;
-  private _onSelectionChanges: Subscription | undefined;
-
-  protected constructor(protected _ref: ChangeDetectorRef) {}
-
-  transform(selection: SelectionModel<any>, value?: T, opts?: O): R {
-    if (!selection) {
-      this._dispose();
-      return undefined;
-    }
-
-    // if we ask another time for the same form and opts, return the last value
-    if (selection === this._lastSelection && value === this._lastValue && equals(opts, this._lastOpts)) {
-      return this._result;
-    }
-
-    // store the query, in case it changes
-    this._lastSelection = selection;
-
-    // store the params, in case they change
-    this._lastValue = value;
-    this._lastOpts = opts;
-
-    // set the result
-    this._result = this._transform(selection, value, opts);
-
-    // if there is already a subscription, clean it
-    this._dispose();
-
-    // subscribe to valueChanges event
-    if (this._shouldSubscribeToChanges) {
-      this._onSelectionChanges = this._subscribe(selection, value, opts);
-    }
-
-    return this._result;
-  }
-
-  ngOnDestroy(): void {
-    this._dispose();
-  }
-
-  protected _subscribe(selection: SelectionModel<T>, value: T, opts?: O): Subscription {
-    // subscribe to valueChanges event
-    return selection.changed.pipe(filter((selectionChange) => this._filterSelectionChange(selectionChange, value, opts))).subscribe((_) => {
-      const result = this._transform(selection, value);
-      if (this._result !== result) {
-        this._result = result;
-        this._ref.markForCheck();
-      }
-    });
-  }
-
-  /**
-   * Clean any existing subscription to change events
-   */
-  protected _dispose(): void {
-    this._onSelectionChanges?.unsubscribe();
-    this._onSelectionChanges = undefined;
-  }
-
-  protected abstract _transform(selection: SelectionModel<T>, value?: T, opts?: O): R;
-
-  protected _filterSelectionChange(selectionChange: SelectionChange<any>, value?: T, opts?: O): boolean {
-    return true;
-  }
-}
-
-@Pipe({
-  name: 'isSelected',
-  pure: false,
-})
-export class IsSelectedPipe extends AbstractSelectionModelPipe<any, boolean> implements PipeTransform, OnDestroy {
-  constructor(_ref: ChangeDetectorRef) {
-    super(_ref);
-  }
-  protected _transform(selection: SelectionModel<any>, value: any): boolean {
-    return selection.isSelected(value);
-  }
-
-  protected _filterSelectionChange(selectionChange: SelectionChange<any>, value: any) {
-    return selectionChange?.added?.includes(value) || selectionChange?.removed?.includes(value) || false;
-  }
-}
-
-@Pipe({
-  name: 'isNotEmptySelection',
-  pure: false,
-})
-export class IsNotEmptySelectionPipe extends AbstractSelectionModelPipe<void, boolean> implements PipeTransform, OnDestroy {
-  constructor(_ref: ChangeDetectorRef) {
-    super(_ref);
-  }
-  protected _transform(selection: SelectionModel<any>): boolean {
-    return selection.hasValue();
-  }
-}
-
-@Pipe({
-  name: 'isEmptySelection',
-  pure: false,
-})
-export class IsEmptySelectionPipe extends AbstractSelectionModelPipe<void, boolean> {
-  constructor(_ref: ChangeDetectorRef) {
-    super(_ref);
-  }
-  protected _transform(selection: SelectionModel<any>): boolean {
-    return selection.isEmpty();
-  }
-}
-
-@Pipe({
-  name: 'selectionLength',
-  pure: false,
-})
-export class SelectionLengthPipe extends AbstractSelectionModelPipe<void, number> implements PipeTransform, OnDestroy {
-  constructor(_ref: ChangeDetectorRef) {
-    super(_ref);
-  }
-  protected _transform(selection: SelectionModel<any>): number {
-    return selection.selected.length;
-  }
-}
-
-@Pipe({
-  name: 'isMultipleSelection',
-  pure: false,
-})
-export class IsMultipleSelectionPipe extends AbstractSelectionModelPipe<void, boolean> implements PipeTransform, OnDestroy {
-  constructor(_ref: ChangeDetectorRef) {
-    super(_ref);
-    this._shouldSubscribeToChanges = false;
-  }
-  protected _transform(selection: SelectionModel<any>): boolean {
-    return selection.isMultipleSelection();
-  }
-}
-
-@Pipe({
-  name: 'isSingleSelection',
-  pure: false,
-})
-export class IsSingleSelectionPipe extends AbstractSelectionModelPipe<void, boolean> {
-  constructor(_ref: ChangeDetectorRef) {
-    super(_ref);
-    this._shouldSubscribeToChanges = false;
-  }
-  protected _transform(selection: SelectionModel<any>): boolean {
-    return !selection.isMultipleSelection();
-  }
-}

package/src/app/shared/pipes/string.pipes.ts

@@ -1,128 +0,0 @@
-import { Pipe, PipeTransform } from '@angular/core';
-import { capitalizeFirstLetter, isNil, isNilOrBlank, isNilOrNaN, isNotNil, isNotNilOrBlank, isNotNilOrNaN } from '../functions';
-import { DisplayFn } from '../form/field.model';
-
-@Pipe({
-  name: 'isNotNilOrBlank',
-})
-export class IsNotNilOrBlankPipe implements PipeTransform {
-  transform(value: string): boolean {
-    return isNotNilOrBlank(value);
-  }
-}
-
-@Pipe({
-  name: 'isNilOrBlank',
-})
-export class IsNilOrBlankPipe implements PipeTransform {
-  transform(value: string): boolean {
-    return isNilOrBlank(value);
-  }
-}
-
-@Pipe({
-  name: 'isNilOrNaN',
-})
-export class IsNilOrNaNPipe implements PipeTransform {
-  transform(value: number): boolean {
-    return isNilOrNaN(value);
-  }
-}
-
-@Pipe({
-  name: 'isNotNilOrNaN',
-})
-export class IsNotNilOrNaNPipe implements PipeTransform {
-  transform(value: number): boolean {
-    return isNotNilOrNaN(value);
-  }
-}
-
-@Pipe({
-  name: 'isNotNil',
-})
-export class IsNotNilPipe implements PipeTransform {
-  transform(value: any): boolean {
-    return isNotNil(value);
-  }
-}
-
-@Pipe({
-  name: 'isNil',
-})
-export class IsNilPipe implements PipeTransform {
-  transform(value: any): boolean {
-    return isNil(value);
-  }
-}
-
-@Pipe({
-  name: 'toString',
-})
-export class ToStringPipe implements PipeTransform {
-  transform(value: number | object, displayWith?: DisplayFn): string {
-    if (displayWith) return displayWith(value);
-    return value !== null && value !== undefined ? value.toString() : '';
-  }
-}
-
-@Pipe({
-  name: 'capitalize',
-})
-export class CapitalizePipe implements PipeTransform {
-  transform(value: string): string {
-    return capitalizeFirstLetter(value);
-  }
-}
-
-@Pipe({
-  name: 'strLength',
-})
-export class StrLengthPipe implements PipeTransform {
-  transform(value: string): number {
-    return (value && value.length) || 0;
-  }
-}
-
-@Pipe({
-  name: 'strIncludes',
-})
-export class StrIncludesPipe implements PipeTransform {
-  transform(value: string, searchString: string, position?: number): boolean {
-    return value?.includes(searchString, position) || false;
-  }
-}
-
-@Pipe({
-  name: 'replace',
-})
-export class StrReplacePipe implements PipeTransform {
-  transform(input: string, searchValue: string | RegExp, replacement: string): any {
-    if (typeof input !== 'string' || isNilOrBlank(searchValue) || isNil(replacement)) {
-      return input;
-    }
-
-    return input.replace(searchValue, replacement);
-  }
-}
-
-@Pipe({
-  name: 'truncText',
-})
-export class TruncTextPipe implements PipeTransform {
-  transform(input: string, size = 60, ellipsis = true, ellipsisText = '...'): any {
-    if (!(input?.length > 3) || input.length <= size) return input;
-    return input.substring(0, size - 3) + (ellipsis ? ellipsisText : '');
-  }
-}
-
-@Pipe({
-  name: 'truncHtml',
-})
-export class TruncHtmlPipe implements PipeTransform {
-  transform(input: string, size = 500, ellipsis = true, ellipsisText = ' (...)'): any {
-    if (!(input?.length > 3) || input.length <= size) return input;
-    const endIndex = Math.max(input.lastIndexOf(' ', size), input.lastIndexOf('<', size));
-    return input.substring(0, endIndex) + (ellipsis ? ellipsisText : '');
-  }
-}

package/src/app/shared/pipes/translate-context.pipe.ts

@@ -1,27 +0,0 @@
-import { Injectable, Pipe, PipeTransform } from '@angular/core';
-import { TranslateContextService } from '../services/translate-context.service';
-import { changeCaseToUnderscore } from '../functions';
-
-@Injectable()
-@Pipe({
-  name: 'translateContext',
-})
-export class TranslateContextPipe implements PipeTransform {
-  constructor(private translate: TranslateContextService) {}
-
-  transform(query: string, context?: string, interpolateParams?: any): string {
-    if (!query || !query.length) return query;
-    return this.translate.instant(query, context, interpolateParams);
-  }
-}
-
-@Pipe({
-  name: 'translatable',
-})
-@Injectable()
-export class TranslatablePipe implements PipeTransform {
-  transform(value: string): string {
-    // transform a string to a i18n compatible string (ex: QualitativeValue -> QUALITATIVE_VALUE)
-    return changeCaseToUnderscore(value)?.toUpperCase();
-  }
-}

package/src/app/shared/pipes/types.pipes.ts

@@ -1,52 +0,0 @@
-import { Pipe, PipeTransform } from '@angular/core';
-import { isObservable, Observable } from 'rxjs';
-import { FloatLabelType } from '@angular/material/form-field';
-import { AppFloatLabelType } from '../form/field.model';
-import { toBoolean } from '../functions';
-
-@Pipe({
-  name: 'asAny',
-})
-export class AsAnyPipe implements PipeTransform {
-  transform<T = any>(value: unknown | any): T | null {
-    if (value === null || value === undefined) return null;
-    return value as T;
-  }
-}
-
-@Pipe({
-  name: 'asArray',
-})
-export class AsArrayPipe implements PipeTransform {
-  transform<T = any>(value: unknown): T[] | null {
-    return Array.isArray(value) ? (value as any[]) : null;
-  }
-}
-
-@Pipe({
-  name: 'asObservable',
-})
-export class AsObservablePipe implements PipeTransform {
-  transform<T = any>(value: unknown): Observable<T> | null {
-    return isObservable(value) ? (value as Observable<T>) : null;
-  }
-}
-
-@Pipe({
-  name: 'asFloatLabelType',
-})
-export class AsFloatLabelTypePipe implements PipeTransform {
-  transform(value: AppFloatLabelType): FloatLabelType | null {
-    return value === 'never' ? null : value;
-  }
-}
-
-@Pipe({
-  name: 'asBoolean',
-})
-export class AsBooleanPipe implements PipeTransform {
-  transform(value: any, opts?: boolean | ((value: any, ...args: any[]) => boolean), ...args: any[]): boolean {
-    if (typeof opts === 'function') return opts(value, ...args);
-    return toBoolean(value, opts);
-  }
-}

package/src/app/shared/pipes/url.pipes.ts

@@ -1,36 +0,0 @@
-import { Pipe, PipeTransform } from '@angular/core';
-import { isNilOrBlank, isNotNil } from '../functions';
-
-/**
- * Pipe permettant d'ajouter des paramètres de requête à une URL.
- *
- * Cette pipe prend une URL de base et un objet contenant des paires clé-valeur
- * représentant les paramètres de requête à ajouter. Elle encode correctement les
- * paramètres et s'assure de les ajouter avec le séparateur approprié ('?' ou '&').
- * Les paramètres avec des valeurs nulles ou undefined sont automatiquement filtrés.
- *
- * @example
- * // Dans un template
- * <a [href]="'https://example.com' | appendQueryParams:{id: 123, name: 'test'}">Lien</a>
- * // Résultat: https://example.com?id=123&name=test
- *
- * @example
- * // Si l'URL contient déjà des paramètres
- * <a [href]="'https://example.com?page=1' | appendQueryParams:{sort: 'asc'}">Lien</a>
- * // Résultat: https://example.com?page=1&sort=asc
- */
-
-@Pipe({
-  name: 'appendQueryParams',
-})
-export class AppendQueryParamsPipePipe implements PipeTransform {
-  transform(url: string, queryParams: { [key: string]: any }): any {
-    if (isNilOrBlank(url) || !queryParams) return url;
-    let queryString = Object.entries(queryParams)
-      .filter(([_, value]) => isNotNil(value))
-      .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
-      .join('&');
-    if (isNilOrBlank(queryString)) return url;
-    return url + (url.includes('?') ? '&' : '?') + queryString;
-  }
-}