@ecodev/natural 38.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
      */
@@ -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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecodev/natural",
-  "version": "38.1.0",
+  "version": "40.0.0",
   "license": "MIT",
   "repository": "github:Ecodev/natural",
   "sideEffects": false,