@ecodev/natural 45.4.2 → 46.0.0

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

@@ -8,7 +8,6 @@ import * as i0 from "@angular/core";
  */
 export declare class NaturalAbstractController implements OnDestroy {
     protected readonly ngUnsubscribe: Subject<void>;
-    constructor();
     ngOnDestroy(): void;
     back(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalAbstractController, never>;

package/lib/modules/avatar/service/avatar.service.d.ts

@@ -12,7 +12,6 @@ export declare class AvatarService {
     private readonly sourceCreators;
     private readonly avatarColors;
     private readonly failedSources;
-    constructor();
     getRandomColor(avatarText: string): string;
     getCreators(): IterableIterator<[keyof AvatarComponent, SourceCreator]>;
     private getSourceKey;

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

@@ -4,22 +4,25 @@ import { BehaviorSubject } from 'rxjs';
 import { FilterGroupConditionField } from '../../search/classes/graphql-doctrine.types';
 import { NaturalDropdownData } from '../../search/dropdown-container/dropdown.service';
 import { DropdownComponent } from '../../search/types/dropdown-component';
+import { NaturalAbstractController } from '../../../classes/abstract-controller';
 import * as i0 from "@angular/core";
-export interface TypeDateConfiguration<D = any> {
+export interface TypeDateConfiguration<D = Date> {
     min?: D | null;
     max?: D | null;
 }
-export declare class TypeDateComponent<D = any> implements DropdownComponent {
+export declare class TypeDateComponent<D = any> extends NaturalAbstractController implements DropdownComponent {
     private dateAdapter;
     private dateFormats;
     readonly renderedValue: BehaviorSubject<string>;
     readonly configuration: Required<TypeDateConfiguration<D>>;
     readonly operatorCtrl: FormControl<"equal" | "greater" | "greaterOrEqual" | "less" | "lessOrEqual">;
     readonly valueCtrl: FormControl<D | null>;
+    readonly todayCtrl: FormControl<boolean | null>;
     readonly operators: import("../types").PossibleComparableOperator[];
     readonly form: FormGroup<{
         operator: FormControl<"equal" | "greater" | "greaterOrEqual" | "less" | "lessOrEqual">;
         value: FormControl<D | null>;
+        today: FormControl<boolean | null>;
     }>;
     private readonly defaults;
     constructor(data: NaturalDropdownData<TypeDateConfiguration<D>>, dateAdapter: DateAdapter<D>, dateFormats: MatDateFormats);
@@ -27,6 +30,7 @@ export declare class TypeDateComponent<D = any> implements DropdownComponent {
     isValid(): boolean;
     isDirty(): boolean;
     private reloadCondition;
+    private setTodayOrDate;
     private initValidators;
     private getDayAfter;
     private getRenderedValue;

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

@@ -15,7 +15,7 @@ declare class InvalidWithValueStateMatcher implements ErrorStateMatcher {
 /**
  * Date range with mandatory bounding dates.
  *
- * If you need ooptional bounding date, then use `TypeDateComponent` instead.
+ * If you need optional bounding date, then use `TypeDateComponent` instead.
  */
 export declare class TypeDateRangeComponent<D = any> implements DropdownComponent {
     private dateAdapter;

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

@@ -10,8 +10,7 @@ export interface HierarchicFilterConfiguration<T = Literal> {
     service: NaturalHierarchicConfiguration['service'];
     filter: T;
 }
-export interface HierarchicFiltersConfiguration<T = Literal> extends Array<HierarchicFilterConfiguration<T>> {
-}
+export declare type HierarchicFiltersConfiguration<T = Literal> = Array<HierarchicFilterConfiguration<T>>;
 export interface TypeHierarchicSelectorConfiguration {
     key: string;
     service: NaturalAbstractModelService<any, any, any, any, any, any, any, any, any, any>;

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

@@ -1,4 +1,4 @@
-import { FormControl, FormGroupDirective, NgForm } from '@angular/forms';
+import { FormControl } from '@angular/forms';
 import { ErrorStateMatcher } from '@angular/material/core';
 import { BehaviorSubject } from 'rxjs';
 import { FilterGroupConditionField } from '../../search/classes/graphql-doctrine.types';
@@ -7,7 +7,7 @@ import { NaturalDropdownData } from '../../search/dropdown-container/dropdown.se
 import { DropdownComponent } from '../../search/types/dropdown-component';
 import * as i0 from "@angular/core";
 export declare class InvalidWithValueStateMatcher implements ErrorStateMatcher {
-    isErrorState(control: FormControl | null, form: FormGroupDirective | NgForm | null): boolean;
+    isErrorState(control: FormControl | null): boolean;
 }
 export declare class TypeTextComponent implements DropdownComponent {
     protected dropdownRef: NaturalDropdownRef;

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

@@ -36,7 +36,7 @@ export declare abstract class NaturalAbstractFile extends NaturalAbstractControl
     multiple: boolean;
     /**
      * Comma-separated list of unique file type specifiers. Like the native element
-     * it can be a mixed of mime-type and file extensions.
+     * it can be a mix of mime-type and file extensions.
      *
      * See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept
      */

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

@@ -1,38 +1,61 @@
 import { EventEmitter, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { DomSanitizer, SafeStyle } from '@angular/platform-browser';
+import { Observable } from 'rxjs';
 import { NaturalFileService } from '../file.service';
-import { NaturalAbstractModelService } from '../../../services/abstract-model.service';
 import { FileModel } from '../types';
+import { NaturalAlertService } from '../../alert/alert.service';
 import * as i0 from "@angular/core";
-export declare class FileComponent<TService extends NaturalAbstractModelService<any, any, any, any, FileModel, any, any, any, any, any>> implements OnInit, OnChanges {
+export declare class FileComponent implements OnInit, OnChanges {
     private readonly naturalFileService;
+    private readonly alertService;
     private readonly sanitizer;
     private readonly document;
     height: number;
     action: 'upload' | 'download' | null;
     backgroundSize: string;
     /**
-     * Comma separated list of accepted mimetypes
+     * Comma-separated list of unique file type specifiers. Like the native element
+     * it can be a mix of mime-type and file extensions.
+     *
+     * See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept
      */
     accept: string;
-    service?: TService;
+    /**
+     * If given it will be called when a new file is selected. The callback should typically upload the file
+     * to the server and link the newly uploaded file to the existing related object.
+     *
+     * The callback **must** be able to run even if the calling component has been destroyed. That means in most
+     * cases you **must** `bind()` the callback explicitly, like so:
+     *
+     * ```html
+     * <natural-file [uploader]="myCallback.bind(this)"></natural-file>
+     * ```
+     *
+     * Also, you probably **should** set a `[formCtrl]` so that the form is updated automatically, instead of doing
+     * it manually within the callback.
+     */
+    uploader?: (file: File) => Observable<FileModel>;
     model: FileModel | null;
     /**
-     * If provided, get updated on change
-     * Is not used for reading -> use [model]
+     * If provided, its value will get updated when the model changes.
+     * But its value is never read, so if you want to set a value use `[model]` instead.
      */
     formCtrl: AbstractControl | null | undefined;
+    /**
+     * This **must not** be used to mutate the server, because it is very likely it will never be called if the
+     * human navigates away from the page before the upload is finished. Instead, you should use `[uploader]`.
+     */
     readonly modelChange: EventEmitter<FileModel>;
     imagePreview: SafeStyle | null;
     filePreview: string | null;
-    constructor(naturalFileService: NaturalFileService, sanitizer: DomSanitizer, document: Document);
+    constructor(naturalFileService: NaturalFileService, alertService: NaturalAlertService, sanitizer: DomSanitizer, document: Document);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     upload(file: File): void;
     getDownloadLink(): null | string;
     private updateImage;
     private getBase64;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FileComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FileComponent<any>, "natural-file", never, { "height": "height"; "action": "action"; "backgroundSize": "backgroundSize"; "accept": "accept"; "service": "service"; "model": "model"; "formCtrl": "formCtrl"; }, { "modelChange": "modelChange"; }, never, never, false>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FileComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FileComponent, "natural-file", never, { "height": "height"; "action": "action"; "backgroundSize": "backgroundSize"; "accept": "accept"; "uploader": "uploader"; "model": "model"; "formCtrl": "formCtrl"; }, { "modelChange": "modelChange"; }, never, never, false>;
 }

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

@@ -6,7 +6,6 @@ export declare class NaturalFixedButtonComponent {
     link: RouterLink['routerLink'];
     color: ThemePalette;
     disabled: boolean;
-    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalFixedButtonComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NaturalFixedButtonComponent, "natural-fixed-button", never, { "icon": "icon"; "link": "link"; "color": "color"; "disabled": "disabled"; }, {}, never, never, false>;
 }

package/lib/modules/hierarchic-selector/classes/hierarchic-filters-configuration.d.ts

@@ -4,5 +4,4 @@ export interface HierarchicFilterConfiguration<T = Literal> {
     service: NaturalHierarchicConfiguration['service'];
     filter: T;
 }
-export interface HierarchicFiltersConfiguration<T = Literal> extends Array<HierarchicFilterConfiguration<T>> {
-}
+export declare type HierarchicFiltersConfiguration<T = Literal> = Array<HierarchicFilterConfiguration<T>>;

package/lib/modules/panels/types.d.ts

@@ -61,6 +61,5 @@ export interface NaturalPanelsBeforeOpenPanel {
 export interface NaturalPanelsHooksConfig {
     beforeOpenPanel?: (injector: Injector, naturalPanelsBeforeOpenPanel: NaturalPanelsBeforeOpenPanel) => NaturalPanelData;
 }
-export interface NaturalPanelsRoutesConfig extends Array<NaturalPanelsRouterRule> {
-}
+export declare type NaturalPanelsRoutesConfig = Array<NaturalPanelsRouterRule>;
 export declare const PanelsHooksConfig: InjectionToken<NaturalPanelsHooksConfig>;

package/lib/modules/relations/relations.component.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter, OnChanges, OnDestroy, OnInit, SimpleChanges, TemplateRef } from '@angular/core';
+import { EventEmitter, OnChanges, OnDestroy, OnInit, TemplateRef } from '@angular/core';
 import { PageEvent } from '@angular/material/paginator';
 import { NaturalAbstractController } from '../../classes/abstract-controller';
 import { NaturalDataSource, PaginatedData } from '../../classes/data-source';
@@ -90,7 +90,7 @@ export declare class NaturalRelationsComponent<TService extends NaturalAbstractM
      */
     set filter(filter: Filter);
     ngOnInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
+    ngOnChanges(): void;
     /**
      * Unlink action
      * Refetch result to display it in table

package/lib/modules/search/classes/transformers.d.ts

@@ -37,3 +37,18 @@ export declare function replaceOperatorByField(selection: NaturalSearchSelection
  *     {field: 'myFieldName',  name:'myConfigName', condition: {myConfigName: {values: [1, 2, 3]}}}
  */
 export declare function replaceOperatorByName(selection: NaturalSearchSelection): NaturalSearchSelection;
+/**
+ * Replace `"today"` and `"tomorrow"` by their real value right now.
+ *
+ * This transformer is applied automatically and should **not** be part
+ * of Natural public API.
+ *
+ * So:
+ *
+ *     {field: 'myFieldName', condition: {greater: {value: 'today'}}}
+ *
+ * will become
+ *
+ *     {field: 'myFieldName', condition: {greater: {value: '2023-01-03'}}}
+ */
+export declare function replaceToday(selection: NaturalSearchSelection): NaturalSearchSelection;

package/lib/modules/search/input/input.component.d.ts

@@ -1,12 +1,12 @@
-import { ElementRef, EnvironmentInjector, EventEmitter, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
-import { FormControl, FormGroupDirective, NgForm } from '@angular/forms';
+import { ElementRef, EnvironmentInjector, EventEmitter, OnChanges, OnDestroy, OnInit } from '@angular/core';
+import { FormControl } from '@angular/forms';
 import { ErrorStateMatcher, MatRipple } from '@angular/material/core';
 import { NaturalDropdownService } from '../dropdown-container/dropdown.service';
 import { Facet, NaturalSearchFacets } from '../types/facet';
 import { NaturalSearchSelection } from '../types/values';
 import * as i0 from "@angular/core";
-export declare class AlwaysErrorStateMatcher implements ErrorStateMatcher {
-    isErrorState(control: FormControl<unknown> | null, form: FormGroupDirective | NgForm | null): boolean;
+declare class AlwaysErrorStateMatcher implements ErrorStateMatcher {
+    isErrorState(control: FormControl<unknown> | null): boolean;
 }
 export declare class NaturalInputComponent implements OnInit, OnChanges, OnDestroy {
     private readonly element;
@@ -88,7 +88,7 @@ export declare class NaturalInputComponent implements OnInit, OnChanges, OnDestr
     constructor(element: ElementRef<HTMLElement>, dropdownService: NaturalDropdownService, injector: EnvironmentInjector);
     ngOnInit(): void;
     ngOnDestroy(): void;
-    ngOnChanges(changes: SimpleChanges): void;
+    ngOnChanges(): void;
     search(event: Event): void;
     clear(): void;
     openDropdown(): void;
@@ -105,3 +105,4 @@ export declare class NaturalInputComponent implements OnInit, OnChanges, OnDestr
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalInputComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NaturalInputComponent, "natural-input", never, { "placeholder": "placeholder"; "searchFieldName": "searchFieldName"; "selection": "selection"; "facets": "facets"; }, { "selectionChange": "selectionChange"; "cleared": "cleared"; }, never, never, false>;
 }
+export {};

package/lib/modules/search/public-api.d.ts

@@ -8,5 +8,5 @@ export { NATURAL_DROPDOWN_DATA } from './dropdown-container/dropdown.service';
 export { NaturalSearchModule } from './search.module';
 export { toGraphQLDoctrineFilter } from './classes/graphql-doctrine';
 export { fromUrl, toUrl, toNavigationParameters } from './classes/url';
-export * from './classes/transformers';
+export { replaceOperatorByName, wrapLike, replaceOperatorByField } from './classes/transformers';
 export { NaturalSearchComponent } from './search/search.component';

package/lib/modules/search/search/search.component.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { EventEmitter, OnChanges } from '@angular/core';
 import { NaturalSearchFacets } from '../types/facet';
 import { GroupSelections, NaturalSearchSelections } from '../types/values';
 import * as i0 from "@angular/core";
@@ -27,7 +27,7 @@ export declare class NaturalSearchComponent implements OnChanges {
      * Input to display at component initialisation
      */
     set selections(selections: NaturalSearchSelections);
-    ngOnChanges(changes: SimpleChanges): void;
+    ngOnChanges(): void;
     updateGroup(groupSelections: GroupSelections, groupIndex: number): void;
     addGroup(): void;
     removeGroup(index: number): void;

package/lib/modules/search/types/facet.d.ts

@@ -71,6 +71,5 @@ export declare type Facet = DropdownFacet<any> | FlagFacet;
 /**
  * Exhaustive list of facets
  */
-export interface NaturalSearchFacets extends Array<Facet> {
-}
+export declare type NaturalSearchFacets = Array<Facet>;
 export {};

package/lib/modules/search/types/values.d.ts

@@ -16,14 +16,12 @@ export interface NaturalSearchSelection {
 /**
  * Groups are a list of values, that should be interpreted with AND condition
  */
-export interface GroupSelections extends Array<NaturalSearchSelection> {
-}
+export declare type GroupSelections = Array<NaturalSearchSelection>;
 /**
  * List of groups, that should be interpreted with OR condition
  * Final input / output format
  */
-export interface NaturalSearchSelections extends Array<GroupSelections> {
-}
+export declare type NaturalSearchSelections = Array<GroupSelections>;
 /**
  * Consolidated type for a selection and it's matching facet
  * Used internally for dropdown

package/lib/modules/select/abstract-select.component.d.ts

@@ -1,5 +1,5 @@
 import { DoCheck, EventEmitter, OnDestroy, OnInit } from '@angular/core';
-import { ControlValueAccessor, FormControl, FormGroupDirective, NgControl, NgForm } from '@angular/forms';
+import { ControlValueAccessor, FormControl, NgControl } from '@angular/forms';
 import { ErrorStateMatcher } from '@angular/material/core';
 import { FloatLabelType } from '@angular/material/form-field';
 import { NaturalAbstractController } from '../../classes/abstract-controller';
@@ -13,7 +13,7 @@ import * as i0 from "@angular/core";
 declare class ExternalFormControlMatcher<T, I> extends ErrorStateMatcher {
     private readonly component;
     constructor(component: AbstractSelect<T, I>);
-    isErrorState(control: FormControl<unknown> | null, form: FormGroupDirective | NgForm | null): boolean;
+    isErrorState(): boolean;
 }
 export declare abstract class AbstractSelect<V, I> extends NaturalAbstractController implements OnInit, OnDestroy, ControlValueAccessor, DoCheck {
     readonly ngControl: NgControl | null;

package/lib/modules/select/select-enum/select-enum.component.d.ts

@@ -7,7 +7,6 @@ import * as i0 from "@angular/core";
 declare type V = IEnum['value'] | IEnum['value'][];
 export declare class NaturalSelectEnumComponent extends AbstractSelect<V, V> implements OnInit, ControlValueAccessor {
     private readonly enumService;
-    readonly ngControl: NgControl | null;
     /**
      * The name of the enum type, eg: `"ActionStatus"`
      */

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

@@ -1,6 +1,5 @@
 import * as i0 from "@angular/core";
 export declare class NaturalSidenavComponent {
-    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalSidenavComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NaturalSidenavComponent, "natural-sidenav", never, {}, {}, never, ["*"], false>;
 }

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

@@ -1,6 +1,5 @@
 import * as i0 from "@angular/core";
 export declare class NaturalSidenavContentComponent {
-    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalSidenavContentComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NaturalSidenavContentComponent, "natural-sidenav-content", never, {}, {}, never, ["*"], false>;
 }

package/lib/modules/table-button/table-button.component.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { EventEmitter, OnChanges } from '@angular/core';
 import { Params, QueryParamsHandling, RouterLink } from '@angular/router';
 import { ThemePalette } from '@angular/material/core';
 import * as i0 from "@angular/core";
@@ -25,7 +25,7 @@ export declare class NaturalTableButtonComponent implements OnChanges {
     color: ThemePalette;
     readonly buttonClick: EventEmitter<MouseEvent>;
     type: 'routerLink' | 'href' | 'click' | 'none';
-    ngOnChanges(changes: SimpleChanges): void;
+    ngOnChanges(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalTableButtonComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NaturalTableButtonComponent, "natural-table-button", never, { "queryParams": "queryParams"; "queryParamsHandling": "queryParamsHandling"; "label": "label"; "icon": "icon"; "href": "href"; "navigate": "navigate"; "fragment": "fragment"; "preserveFragment": "preserveFragment"; "raised": "raised"; "color": "color"; }, { "buttonClick": "buttonClick"; }, never, never, false>;
 }

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

@@ -25,7 +25,7 @@ export declare class NaturalDebounceService {
      * keep the same debouncing timeline.
      */
     debounce<T>(key: Key, id: string, source: Observable<T>): Observable<T>;
-    cancel<T>(key: Key, id: string): void;
+    cancel(key: Key, id: string): void;
     /**
      * Immediately execute all pending updates.
      *

package/package.json

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