@ecodev/natural 44.0.6 → 45.1.0

package/lib/modules/dropdown-components/type-date/type-date.component.d.ts

@@ -13,7 +13,7 @@ export declare class TypeDateComponent<D = any> implements DropdownComponent {
     private dateAdapter;
     private dateFormats;
     readonly renderedValue: BehaviorSubject<string>;
-    readonly configuration: TypeDateConfiguration<D>;
+    readonly configuration: Required<TypeDateConfiguration<D>>;
     readonly operatorCtrl: FormControl<"equal" | "greater" | "greaterOrEqual" | "less" | "lessOrEqual">;
     readonly valueCtrl: FormControl<D | null>;
     readonly operators: import("../types").PossibleComparableOperator[];

package/lib/modules/dropdown-components/type-date-range/type-date-range.component.d.ts

@@ -21,7 +21,7 @@ export declare class TypeDateRangeComponent<D = any> implements DropdownComponen
     private dateAdapter;
     private dateFormats;
     readonly renderedValue: BehaviorSubject<string>;
-    readonly configuration: TypeDateRangeConfiguration<D>;
+    readonly configuration: Required<TypeDateRangeConfiguration<D>>;
     readonly matcher: InvalidWithValueStateMatcher;
     readonly fromCtrl: FormControl<D | null>;
     readonly toCtrl: FormControl<D | null>;

package/lib/modules/dropdown-components/type-number/type-number.component.d.ts

@@ -14,7 +14,7 @@ export interface TypeNumberConfiguration {
 export declare class TypeNumberComponent implements DropdownComponent {
     protected dropdownRef: NaturalDropdownRef;
     readonly renderedValue: BehaviorSubject<string>;
-    readonly configuration: TypeNumberConfiguration;
+    readonly configuration: Required<TypeNumberConfiguration>;
     readonly operatorCtrl: FormControl<"equal" | "greater" | "greaterOrEqual" | "less" | "lessOrEqual">;
     readonly valueCtrl: FormControl<any>;
     readonly matcher: InvalidWithValueStateMatcher;
@@ -23,6 +23,7 @@ export declare class TypeNumberComponent implements DropdownComponent {
         value: FormControl<any>;
     }>;
     readonly operators: import("../types").PossibleComparableOperator[];
+    private readonly defaults;
     constructor(data: NaturalDropdownData<TypeNumberConfiguration>, dropdownRef: NaturalDropdownRef);
     getCondition(): FilterGroupConditionField;
     isValid(): boolean;

package/lib/modules/dropdown-components/type-select/type-select.component.d.ts

@@ -6,7 +6,7 @@ import { NaturalDropdownData } from '../../search/dropdown-container/dropdown.se
 import { DropdownComponent } from '../../search/types/dropdown-component';
 import { FormControl, FormGroup } from '@angular/forms';
 import { NaturalAbstractController } from '../../../classes/abstract-controller';
-import { PossibleDiscreteOperator, PossibleDiscreteOperatorKeys } from '../types';
+import { PossibleDiscreteOperatorKeys } from '../types';
 import * as i0 from "@angular/core";
 export declare type TypeSelectItem = Scalar | {
     id: Scalar;
@@ -18,12 +18,16 @@ export declare type TypeSelectItem = Scalar | {
 export interface TypeSelectConfiguration {
     items: TypeSelectItem[] | Observable<TypeSelectItem[]>;
     multiple?: boolean;
+    /**
+     * If true (default) a selectbox allows to choose an operator. Otherwise, the selectbox is hidden and the operator will always be `is`.
+     */
+    operators?: boolean;
 }
 export declare class TypeSelectComponent extends NaturalAbstractController implements DropdownComponent, AfterViewInit, OnDestroy {
     readonly renderedValue: BehaviorSubject<string>;
     list: MatSelectionList;
     requireValueCtrl: boolean;
-    readonly operators: PossibleDiscreteOperator[];
+    readonly operators: import("../types").PossibleDiscreteOperator[];
     readonly operatorCtrl: FormControl<PossibleDiscreteOperatorKeys>;
     readonly valueCtrl: FormControl<any>;
     readonly form: FormGroup<{
@@ -31,7 +35,7 @@ export declare class TypeSelectComponent extends NaturalAbstractController imple
         value: FormControl<any>;
     }>;
     items: TypeSelectItem[];
-    private readonly configuration;
+    readonly configuration: Required<TypeSelectConfiguration>;
     private readonly defaults;
     constructor(data: NaturalDropdownData<TypeSelectConfiguration>);
     ngAfterViewInit(): void;

package/lib/modules/file/abstract-file.d.ts

@@ -30,7 +30,6 @@ export declare abstract class NaturalAbstractFile extends NaturalAbstractControl
     protected readonly naturalFileService: NaturalFileService;
     private readonly document;
     private fileElement?;
-    private readonly validators;
     /**
      * Whether we should accept a single file or multiple files
      */
@@ -90,8 +89,6 @@ export declare abstract class NaturalAbstractFile extends NaturalAbstractControl
     private beforeSelect;
     onChange(event: Event): void;
     private validate;
-    private acceptValidator;
-    private fileSizeValidator;
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalAbstractFile, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<NaturalAbstractFile, never, never, { "multiple": "multiple"; "accept": "accept"; "maxSize": "maxSize"; "fileSelectionDisabled": "fileSelectionDisabled"; "selectable": "selectable"; "broadcast": "broadcast"; }, { "fileChange": "fileChange"; "filesChange": "filesChange"; }, never, never, false>;
 }

package/lib/modules/file/utils.d.ts

@@ -2,6 +2,7 @@ export declare function acceptType(accept: string, type: string, filename: strin
 export declare function isFileInput(elm: HTMLElement): elm is HTMLInputElement;
 export declare function detectSwipe(event: Event | TouchEvent): boolean;
 export declare function createInvisibleFileInputWrap(document: Document): HTMLLabelElement;
+export declare function isDirectory(file: File): Promise<boolean>;
 export declare function stopEvent(event: Event): void;
 export declare function fileListToArray(fileList: FileList): File[];
 export declare function eventToFiles(event: Event | DragEvent): File[];

package/lib/modules/fixed-button-detail/fixed-button-detail.component.d.ts

@@ -1,18 +1,26 @@
 import { EventEmitter } from '@angular/core';
 import { FormGroup } from '@angular/forms';
+import { ActivatedRoute } from '@angular/router';
 import * as i0 from "@angular/core";
-export declare class NaturalFixedButtonDetailComponent {
-    model: {
-        id?: string;
-        permissions?: {
-            delete: boolean;
-        };
+declare type Model = {
+    id?: string;
+    permissions?: {
+        delete: boolean;
     };
+};
+export declare class NaturalFixedButtonDetailComponent {
+    private canChange;
+    isCreation: boolean;
+    get model(): Model;
+    set model(value: Model);
+    private _model;
     form: FormGroup;
     readonly create: EventEmitter<void>;
     readonly delete: EventEmitter<void>;
+    constructor(route: ActivatedRoute);
     clickCreate(): void;
     clickDelete(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalFixedButtonDetailComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NaturalFixedButtonDetailComponent, "natural-fixed-button-detail", never, { "model": "model"; "form": "form"; }, { "create": "create"; "delete": "delete"; }, never, never, false>;
 }
+export {};

package/lib/modules/hierarchic-selector/hierarchic-selector/hierarchic-selector.component.d.ts

@@ -2,7 +2,6 @@ import { SelectionModel } from '@angular/cdk/collections';
 import { FlatTreeControl } from '@angular/cdk/tree';
 import { EventEmitter, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { MatTreeFlatDataSource, MatTreeFlattener } from '@angular/material/tree';
-import { Observable } from 'rxjs';
 import { NaturalAbstractController } from '../../../classes/abstract-controller';
 import { NaturalSearchFacets } from '../../search/types/facet';
 import { NaturalSearchSelections } from '../../search/types/values';
@@ -96,20 +95,20 @@ export declare class NaturalHierarchicSelectorComponent extends NaturalAbstractC
     /**
      * Created to collapse all children when closing a parent, but not sure it's good.
      */
-    getChildren(): (node: HierarchicModelNode) => Observable<HierarchicModelNode[]>;
+    private getChildren;
     /**
      * Transforms a HierarchicModelNode into a FlatNode
      */
-    transformer(): (node: HierarchicModelNode, level: number) => HierarchicFlatNode;
+    private transformer;
     /**
      * Return deep of the node in the tree
      */
-    getLevel(): (node: HierarchicFlatNode) => number;
+    private getLevel;
     /**
      * Is always expandable because we load on demand, we don't know if there are children yet
      */
-    isExpandable(): (node: HierarchicFlatNode) => boolean;
-    getOrCreateFlatNode(node: HierarchicModelNode, level: number): HierarchicFlatNode;
+    private isExpandable;
+    private getOrCreateFlatNode;
     search(selections: NaturalSearchSelections): void;
     private loadRoots;
     /**

package/lib/modules/hierarchic-selector/hierarchic-selector/hierarchic-selector.service.d.ts

@@ -1,18 +1,14 @@
 import { Injector } from '@angular/core';
 import { BehaviorSubject, Observable } from 'rxjs';
-import { NaturalQueryVariablesManager, QueryVariables } from '../../../classes/query-variable-manager';
+import { QueryVariables } from '../../../classes/query-variable-manager';
 import { HierarchicFlatNode } from '../classes/flat-node';
-import { NaturalHierarchicConfiguration, NaturalHierarchicServiceConfiguration } from '../classes/hierarchic-configuration';
+import { NaturalHierarchicConfiguration } from '../classes/hierarchic-configuration';
 import { HierarchicFiltersConfiguration } from '../classes/hierarchic-filters-configuration';
 import { HierarchicModelNode } from '../classes/model-node';
 import * as i0 from "@angular/core";
 export interface OrganizedModelSelection {
     [key: string]: any[];
 }
-interface ContextualizedConfig {
-    configuration: NaturalHierarchicServiceConfiguration;
-    variablesManager: NaturalQueryVariablesManager;
-}
 export declare class NaturalHierarchicSelectorService {
     private readonly injector;
     /**
@@ -20,7 +16,7 @@ export declare class NaturalHierarchicSelectorService {
      * This observable contains Node.
      * When it's updated, the TreeController and TreeFlattener process the new array to generate the flat tree.
      */
-    dataChange: BehaviorSubject<HierarchicModelNode[]>;
+    readonly dataChange: BehaviorSubject<HierarchicModelNode[]>;
     /**
      * Configuration for relations and selection constraints
      *
@@ -43,13 +39,9 @@ export declare class NaturalHierarchicSelectorService {
      * Retrieve elements from the server
      * Get root elements if node is null, or child elements if node is given
      */
-    getList(node?: HierarchicFlatNode | null, contextFilters?: HierarchicFiltersConfiguration | null, searchVariables?: QueryVariables | null): Observable<HierarchicModelNode[]>;
+    private getList;
     countItems(node: HierarchicFlatNode, contextFilters?: HierarchicFiltersConfiguration | null): void;
-    getContextualizedConfigs(node?: HierarchicFlatNode | null, contextFilters?: HierarchicFiltersConfiguration | null, searchVariables?: QueryVariables | null): ContextualizedConfig[];
-    /**
-     * Check configuration to return a boolean that allows or denies the selection for the given element
-     */
-    isSelectable(node: HierarchicFlatNode): boolean;
+    private getContextualizedConfigs;
     /**
      * Return models matching given FlatNodes
      * Returns a Literal of models grouped by their configuration attribute "selectableAtKey"
@@ -87,4 +79,3 @@ export declare class NaturalHierarchicSelectorService {
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalHierarchicSelectorService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<NaturalHierarchicSelectorService>;
 }
-export {};

package/lib/services/abstract-model.service.d.ts

@@ -6,6 +6,7 @@ import { Observable, OperatorFunction } from 'rxjs';
 import { NaturalQueryVariablesManager, QueryVariables } from '../classes/query-variable-manager';
 import { Literal } from '../types/types';
 import { PaginatedData } from '../classes/data-source';
+import { NaturalDebounceService } from './debounce.service';
 export interface FormValidators {
     [key: string]: ValidatorFn[];
 }
@@ -33,21 +34,18 @@ export declare abstract class NaturalAbstractModelService<Tone, Vone extends {
     ids: string[];
 }> {
     protected readonly apollo: Apollo;
+    protected readonly naturalDebounceService: NaturalDebounceService;
     protected readonly name: string;
     protected readonly oneQuery: DocumentNode | null;
     protected readonly allQuery: DocumentNode | null;
     protected readonly createMutation: DocumentNode | null;
     protected readonly updateMutation: DocumentNode | null;
     protected readonly deleteMutation: DocumentNode | null;
-    /**
-     * Stores the debounced update function
-     */
-    private debouncedUpdateCache;
     /**
      * Store the creation mutations that are pending
      */
     private readonly creatingCache;
-    constructor(apollo: Apollo, name: string, oneQuery: DocumentNode | null, allQuery: DocumentNode | null, createMutation: DocumentNode | null, updateMutation: DocumentNode | null, deleteMutation: DocumentNode | null);
+    constructor(apollo: Apollo, naturalDebounceService: NaturalDebounceService, name: string, oneQuery: DocumentNode | null, allQuery: DocumentNode | null, createMutation: DocumentNode | null, updateMutation: DocumentNode | null, deleteMutation: DocumentNode | null);
     getConsolidatedForClient(): Literal;
     /**
      * List of individual fields validators
@@ -139,7 +137,7 @@ export declare abstract class NaturalAbstractModelService<Tone, Vone extends {
      */
     getInput(object: Literal): Vcreate['input'] | Vupdate['input'];
     /**
-     * Return the number of objects matching the query
+     * Return the number of objects matching the query. It may never complete.
      *
      * This is used for the unique validator
      */

package/lib/services/debounce.service.d.ts

@@ -0,0 +1,46 @@
+import { Observable } from 'rxjs';
+import { NaturalAbstractModelService } from './abstract-model.service';
+import * as i0 from "@angular/core";
+declare type Key = NaturalAbstractModelService<unknown, any, any, any, unknown, any, unknown, any, unknown, any>;
+/**
+ * Debounce subscriptions to observable, with possibility to cancel one, or flush all of them. Typically,
+ * observables are object updates, so `NaturalAbstractModelService.updateNow()`.
+ *
+ * `key` must be an instance of `NaturalAbstractModelService` to separate objects by their types. So User with ID 1 is
+ * not confused with Product with ID 1. It has no other purpose.
+ *
+ * `id` should be the ID of the object that will be updated.
+ */
+export declare class NaturalDebounceService {
+    private readonly flusher;
+    /**
+     * Stores the debounced update function
+     */
+    private readonly allDebouncedUpdateCache;
+    /**
+     * Debounce the given source observable for a short time. If called multiple times with the same key and id,
+     * it will postpone the subscription to the source observable.
+     *
+     * Giving the same key and id but a different source observable will replace the original observable, but
+     * keep the same debouncing timeline.
+     */
+    debounce<T>(key: Key, id: string, source: Observable<T>): Observable<T>;
+    cancel<T>(key: Key, id: string): void;
+    /**
+     * Immediately execute all pending updates.
+     *
+     * It should typically be called before login out.
+     *
+     * The returned observable will complete when all updates complete, even if some of them error.
+     */
+    flush(): Observable<void>;
+    /**
+     * Count of pending updates
+     */
+    get count(): number;
+    private getMap;
+    private delete;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NaturalDebounceService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NaturalDebounceService>;
+}
+export {};

package/package.json

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

package/public-api.d.ts

@@ -12,6 +12,7 @@ export * from './lib/classes/utility';
 export * from './lib/classes/validators';
 export { validTlds } from './lib/classes/tld';
 export * from './lib/services/abstract-model.service';
+export { NaturalDebounceService } from './lib/services/debounce.service';
 export * from './lib/services/enum.service';
 export * from './lib/services/link-mutation.service';
 export * from './lib/services/persistence.service';