@ecodev/natural 37.1.0 → 40.0.0

package/lib/classes/abstract-list.d.ts

@@ -22,7 +22,7 @@ declare type MaybeNavigable = Literal | NavigableItem<Literal>;
  * Components inheriting from this class can be used as standalone with input attributes.
  *
  * Usage :
- * <natural-my-listing [forcedVariables]="{filter:...}" [initialColumns]="['col1']" [persistSearch]="false">
+ * <natural-my-listing [forcedVariables]="{filter:...}" [selectedColumns]="['col1']" [persistSearch]="false">
  */
 export declare class NaturalAbstractList<TService extends NaturalAbstractModelService<any, any, PaginatedData<Literal>, QueryVariables, any, any, any, any, any, any>, Tall extends PaginatedData<MaybeNavigable> = ExtractTall<TService>> extends NaturalAbstractPanel implements OnInit, OnDestroy {
     readonly service: TService;
@@ -34,17 +34,15 @@ export declare class NaturalAbstractList<TService extends NaturalAbstractModelSe
     /**
      * Columns list after interaction with <natural-columns-picker>
      */
-    private _selectedColumns;
+    columnsForTable: string[];
     /**
      * The default column selection that automatically happened after <natural-columns-picker> initialization
      */
     private defaultSelectedColumns;
     /**
-     * Initial columns on component init
-     *
-     * Changing this value after initialization will have no effect at all
+     * Visible (checked) columns
      */
-    initialColumns?: string[];
+    selectedColumns?: string[];
     /**
      * Source of the list
      */
@@ -101,7 +99,7 @@ export declare class NaturalAbstractList<TService extends NaturalAbstractModelSe
     /**
      * Persist search and then launch whatever is required to refresh the list
      */
-    search(naturalSearchSelections: NaturalSearchSelections, navigationExtras?: NavigationExtras): void;
+    search(naturalSearchSelections: NaturalSearchSelections, navigationExtras?: NavigationExtras, resetPagination?: boolean): void;
     /**
      * Change sorting variables for query and persist the new value in url and local storage
      * The default value is not persisted
@@ -158,7 +156,7 @@ export declare class NaturalAbstractList<TService extends NaturalAbstractModelSe
      * Uses data provided by router such as:
      *
      * - `route.data.forcedVariables`
-     * - `route.data.initialColumns`
+     * - `route.data.selectedColumns`
      */
     protected initFromRoute(): void;
     protected getDataObservable(): Observable<Tall>;
@@ -174,7 +172,6 @@ export declare class NaturalAbstractList<TService extends NaturalAbstractModelSe
      */
     protected bulkDelete(): Observable<void>;
     private applyForcedVariables;
-    get selectedColumns(): string[];
-    set selectedColumns(columns: string[]);
+    selectColumns(columns: string[]): void;
 }
 export {};

package/lib/classes/abstract-navigable-list.d.ts

@@ -1,5 +1,5 @@
 import { Injector, OnDestroy, OnInit } from '@angular/core';
-import { RouterLink } from '@angular/router';
+import { NavigationExtras, RouterLink } from '@angular/router';
 import { NaturalSearchSelections } from '../modules/search/types/values';
 import { NaturalAbstractModelService } from '../services/abstract-model.service';
 import { NaturalAbstractList } from './abstract-list';
@@ -28,12 +28,14 @@ export declare class NaturalAbstractNavigableList<TService extends NaturalAbstra
      * Name of filter for child items to access ancestor item
      */
     ancestorRelationName: string;
+    private oldAncertorId;
     breadcrumbs: BreadcrumbItem[];
     constructor(service: TService, injector: Injector);
     ngOnInit(): void;
     protected getDataObservable(): Observable<PaginatedData<NavigableItem<ExtractTallOne<TService>>>>;
     protected translateSearchAndRefreshList(naturalSearchSelections: NaturalSearchSelections): void;
-    clearSearch(): void;
+    clearSearch(resetPagination?: boolean): void;
+    search(naturalSearchSelections: NaturalSearchSelections, navigationExtras?: NavigationExtras, resetPagination?: boolean): void;
     /**
      * Return an array for router link usage
      */

package/lib/classes/rxjs.d.ts

@@ -1,4 +1,4 @@
-import { Observable } from 'rxjs';
+import { MonoTypeOperatorFunction, Observable } from 'rxjs';
 /**
  * Behave like setTimeout(), but with a mandatory cancel mechanism.
  *
@@ -28,3 +28,8 @@ import { Observable } from 'rxjs';
  * ```
  */
 export declare function cancellableTimeout(canceller: Observable<unknown>, milliSeconds?: number): Observable<void>;
+/**
+ * For debugging purpose only, will dump in console everything that happen to
+ * the observable
+ */
+export declare function debug<T>(debugName: string): MonoTypeOperatorFunction<T>;

package/lib/classes/validators.d.ts

@@ -5,6 +5,13 @@ import { NaturalAbstractModelService } from '../services/abstract-model.service'
  * Returns an async validator function that checks that the form control value is unique
  */
 export declare function unique<TService extends NaturalAbstractModelService<any, any, any, any, any, any, any, any, any, any>>(fieldName: string, excludedId: string | null | undefined, modelService: TService): AsyncValidatorFn;
+/**
+ * Returns an async validator function that checks that the form control value is available
+ *
+ * Similar to `unique` validator, but allows to use a custom query for when the client does
+ * not have permissions for `modelService.count()`.
+ */
+export declare function available(getAvailableQuery: (value: string, excludedId: string | null) => Observable<boolean>, excludedId?: string | null): AsyncValidatorFn;
 /**
  * Return all errors recursively for the given Form or control
  */

package/lib/modules/columns-picker/columns-picker.component.d.ts

@@ -2,17 +2,27 @@ import { AfterViewInit, ChangeDetectorRef, EventEmitter, OnDestroy, QueryList }
 import { NaturalColumnsPickerColumnDirective } from './columns-picker-column.directive';
 export declare class NaturalColumnsPickerComponent implements AfterViewInit, OnDestroy {
     private readonly changeDetectorRef;
-    set selection(columns: string[]);
+    private _selections?;
     /**
-     * Emit a list of column keys whenever the selection changes
+     * Set the columns that are wanted but might be unavailable.
+     *
+     * If a column is unavailable it will be ignored silently. To know what columns were actually applied
+     * you should use `selectionChange`.
+     *
+     * It is often set once on component initialization, but it can also be set again later in the lifespan of the component.
+     */
+    set selections(columns: string[] | undefined);
+    /**
+     * Emit a list of valid and selected column keys whenever the selection changes
      */
     readonly selectionChange: EventEmitter<string[]>;
-    readonly defaultSelectionChange: EventEmitter<string[]>;
     /**
-     * Filter available columns
+     * Available columns are defined by options in the template
      */
-    initialSelection?: string[];
     availableColumns: QueryList<NaturalColumnsPickerColumnDirective> | null;
+    /**
+     * Displayed options in the dropdown menu
+     */
     displayedColumns: NaturalColumnsPickerColumnDirective[];
     private ngUnsubscribe;
     constructor(changeDetectorRef: ChangeDetectorRef);

package/lib/modules/search/dropdown-container/dropdown-container.component.d.ts

@@ -3,7 +3,6 @@ import { ConfigurableFocusTrapFactory } from '@angular/cdk/a11y';
 import { BasePortalOutlet, CdkPortalOutlet, ComponentPortal, TemplatePortal } from '@angular/cdk/portal';
 import { ComponentRef, ElementRef, EmbeddedViewRef, InjectionToken, OnDestroy, TemplateRef } from '@angular/core';
 import { Subject } from 'rxjs';
-import { DropdownResult } from '../types/values';
 export declare function throwMatDialogContentAlreadyAttachedError(): void;
 export interface NaturalDropdownContainerData {
     showValidateButton: boolean;
@@ -15,7 +14,7 @@ export declare class NaturalDropdownContainerComponent extends BasePortalOutlet
     data: NaturalDropdownContainerData;
     portalOutlet: CdkPortalOutlet;
     templateRef: TemplateRef<any>;
-    readonly closed: Subject<DropdownResult>;
+    readonly closed: Subject<void>;
     /** Current state of the panel animation. */
     panelAnimationState: 'void' | 'enter';
     /** Emits whenever an animation on the menu completes. */

package/lib/modules/sidenav/sidenav-container/sidenav-container.component.d.ts

@@ -1,4 +1,5 @@
 import { ElementRef, OnDestroy, OnInit } from '@angular/core';
+import { MatDrawer } from '@angular/material/sidenav';
 import { NaturalSidenavService } from '../sidenav.service';
 export declare class NaturalSidenavContainerComponent implements OnInit, OnDestroy {
     readonly sidenavService: NaturalSidenavService;
@@ -8,9 +9,9 @@ export declare class NaturalSidenavContainerComponent implements OnInit, OnDestr
      */
     name: string;
     /**
-     * Unique identifier used for the local storage
+     * The side that the drawer is attached to
      */
-    position: 'start' | 'end';
+    position: MatDrawer['position'];
     /**
      * If true listens to route changes to close side nav after a route change if mobile view is active
      * Actually a navigation to current route does not emit a route change, and the sidenav don't close.

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@ecodev/natural",
-  "version": "37.1.0",
+  "version": "40.0.0",
   "license": "MIT",
   "repository": "github:Ecodev/natural",
   "sideEffects": false,
   "dependencies": {
-    "ts-md5": "^1.2.8",
-    "tslib": "^2.2.0"
+    "ts-md5": "^1.2.9",
+    "tslib": "^2.3.1"
   },
   "peerDependencies": {
     "@angular/common": "^12.0.1",
     "@angular/core": "^12.0.1",
     "@angular/localize": "^12.0.1",
     "@angular/material": "^12.0.1",
-    "apollo-angular": "^2.5.0",
+    "apollo-angular": "^2.6.0",
     "lodash-es": "^4.17.21",
-    "rxjs": "^6.5.4"
+    "rxjs": "^7.4.0"
   },
   "main": "bundles/ecodev-natural.umd.js",
   "module": "fesm2015/ecodev-natural.js",

package/src/lib/modules/alert/_alert.theme.scss

@@ -1,4 +1,4 @@
-@use "sass:map";
+@use 'sass:map';
 @use '~@angular/material' as mat;
 @mixin natural-alert($theme) {
     $primary: map.get($theme, primary);

package/src/lib/modules/file/component/_file.theme.scss

@@ -1,4 +1,4 @@
-@use "sass:map";
+@use 'sass:map';
 @use '~@angular/material' as mat;
 @mixin natural-file($theme) {
     $primary: map.get($theme, primary);

package/src/lib/modules/icon/_icon.theme.scss

@@ -1,4 +1,4 @@
-@use "sass:map";
+@use 'sass:map';
 @use '~@angular/material' as mat;
 @mixin natural-icon($theme) {
     $primary: map.get($theme, primary);

package/src/lib/modules/search/dropdown-container/_dropdown-container.theme.scss

@@ -1,4 +1,4 @@
-@use "sass:map";
+@use 'sass:map';
 @use '~@angular/material' as mat;
 @mixin natural-dropdown-container($theme) {
     $background: map.get($theme, background);

package/src/lib/modules/sidenav/_sidenav.theme.scss

@@ -1,4 +1,4 @@
-@use "sass:map";
+@use 'sass:map';
 @mixin natural-sidenav($theme) {
     $primary: map.get($theme, primary);
     $accent: map.get($theme, accent);

package/src/lib/styles/_table.scss

@@ -1,4 +1,4 @@
-@use "sass:map";
+@use 'sass:map';
 @use '~@angular/material' as mat;
 @mixin natural-table($theme) {
     $primary: map.get($theme, primary);