ngx-material-entity 0.1.2 → 0.1.5

package/components/table/table-data.builder.d.ts

@@ -1,40 +1,51 @@
-import { EntityService } from '../../classes/entity-service.class';
-import { Entity } from '../../classes/entity-model.class';
+import { EntityService } from '../../classes/entity.service';
 import { CreateDialogDataInternal } from './create-dialog/create-dialog-data.builder';
 import { EditDialogDataInternal } from './edit-dialog/edit-dialog-data.builder';
 import { BaseData, DisplayColumn, MultiSelectAction, TableData } from './table-data';
 import { HttpClient } from '@angular/common/http';
-export declare class TableDataInternal<EntityType extends Entity> implements TableData<EntityType> {
+import { BaseBuilder } from '../../classes/base.builder';
+import { BaseEntityType, EntityClassNewable } from '../../classes/entity.model';
+/**
+ * The internal TableData. Requires all default values the user can leave out.
+ */
+export declare class TableDataInternal<EntityType extends BaseEntityType<EntityType>> implements TableData<EntityType> {
     baseData: BaseDataInternal<EntityType>;
     createDialogData: CreateDialogDataInternal;
     editDialogData: EditDialogDataInternal<EntityType>;
     constructor(baseData: BaseDataInternal<EntityType>, createDialogData: CreateDialogDataInternal, editDialogData: EditDialogDataInternal<EntityType>);
 }
-export declare class BaseDataBuilder<EntityType extends Entity> {
-    baseData: BaseDataInternal<EntityType>;
-    private readonly dataInput;
+/**
+ * The Builder for the table BaseData. Sets default values.
+ */
+export declare class BaseDataBuilder<EntityType extends BaseEntityType<EntityType>> extends BaseBuilder<BaseDataInternal<EntityType>, BaseData<EntityType>> {
     constructor(data: BaseData<EntityType>);
+    protected generateBaseData(data: BaseData<EntityType>): BaseDataInternal<EntityType>;
 }
-export declare class BaseDataInternal<EntityType extends Entity> implements BaseData<EntityType> {
+/**
+ * The internal TableData. Requires all default values the user can leave out.
+ */
+export declare class BaseDataInternal<EntityType extends BaseEntityType<EntityType>> implements BaseData<EntityType> {
     title: string;
     displayColumns: DisplayColumn<EntityType>[];
     EntityServiceClass: new (httpClient: HttpClient) => EntityService<EntityType>;
     searchLabel: string;
     createButtonLabel: string;
-    searchString: (enity: EntityType) => string;
+    searchString: (entity: EntityType) => string;
     allowCreate: boolean;
     allowEdit: (entity: EntityType) => boolean;
     allowDelete: (entity: EntityType) => boolean;
     multiSelectActions: MultiSelectAction<EntityType>[];
     multiSelectLabel: string;
-    EntityClass?: new (entity?: EntityType) => EntityType;
+    EntityClass?: EntityClassNewable<EntityType>;
     edit?: (entity: EntityType) => unknown;
     create?: (entity: EntityType) => unknown;
-    constructor(title: string, displayColumns: DisplayColumn<EntityType>[], EntityServiceClass: new (httpClient: HttpClient) => EntityService<EntityType>, searchLabel: string, createButtonLabel: string, searchString: (enity: EntityType) => string, allowCreate: boolean, allowEdit: (entity: EntityType) => boolean, allowDelete: (entity: EntityType) => boolean, multiSelectActions: MultiSelectAction<EntityType>[], multiSelectLabel: string, EntityClass?: new (entity?: EntityType) => EntityType, edit?: (entity: EntityType) => unknown, create?: (entity: EntityType) => unknown);
+    constructor(title: string, displayColumns: DisplayColumn<EntityType>[], EntityServiceClass: new (httpClient: HttpClient) => EntityService<EntityType>, searchLabel: string, createButtonLabel: string, searchString: (entity: EntityType) => string, allowCreate: boolean, allowEdit: (entity: EntityType) => boolean, allowDelete: (entity: EntityType) => boolean, multiSelectActions: MultiSelectAction<EntityType>[], multiSelectLabel: string, EntityClass?: EntityClassNewable<EntityType>, edit?: (entity: EntityType) => unknown, create?: (entity: EntityType) => unknown);
 }
-export declare class TableDataBuilder<EntityType extends Entity> {
-    tableData: TableDataInternal<EntityType>;
-    private readonly dataInput;
+/**
+ * The Builder for the complete TableData. Sets default values and validates user input.
+ */
+export declare class TableDataBuilder<EntityType extends BaseEntityType<EntityType>> extends BaseBuilder<TableDataInternal<EntityType>, TableData<EntityType>> {
     constructor(data: TableData<EntityType>);
-    private validateInput;
+    protected generateBaseData(data: TableData<EntityType>): TableDataInternal<EntityType>;
+    protected validateInput(data: TableData<EntityType>): void;
 }

package/components/table/table-data.d.ts

@@ -1,11 +1,11 @@
 import { HttpClient } from '@angular/common/http';
-import { Entity } from '../../classes/entity-model.class';
-import { EntityService } from '../../classes/entity-service.class';
+import { EntityService } from '../../classes/entity.service';
+import { BaseEntityType, EntityClassNewable } from '../../classes/entity.model';
 import { ConfirmDialogData } from '../confirm-dialog/confirm-dialog-data';
 /**
  * The Definition of a Column inside the table.
  */
-export interface DisplayColumn<EntityType extends Entity> {
+export interface DisplayColumn<EntityType extends BaseEntityType<EntityType>> {
     /**
      * The name inside the header.
      */
@@ -18,7 +18,7 @@ export interface DisplayColumn<EntityType extends Entity> {
 /**
  * The Definition of an Action that can be run on multiple selected entities.
  */
-export interface MultiSelectAction<EntityType extends Entity> {
+export interface MultiSelectAction<EntityType extends BaseEntityType<EntityType>> {
     /**
      * The name of the action.
      */
@@ -40,11 +40,14 @@ export interface MultiSelectAction<EntityType extends Entity> {
      */
     requireConfirmDialog?: (selectedEntities: EntityType[]) => boolean;
     /**
-     * The data used to generate a confirmation dialog for the multiselect action.
+     * The data used to generate a confirmation dialog for the multiSelect action.
      */
     confirmDialogData?: ConfirmDialogData;
 }
-export interface BaseData<EntityType extends Entity> {
+/**
+ * The base data of the ngx-mat-entity-table.
+ */
+export interface BaseData<EntityType extends BaseEntityType<EntityType>> {
     /**
      * The title of the table.
      */
@@ -62,7 +65,7 @@ export interface BaseData<EntityType extends Entity> {
     /**
      * The Class of the entities to manage.
      */
-    EntityClass?: new (entity?: EntityType) => EntityType;
+    EntityClass?: EntityClassNewable<EntityType>;
     /**
      * The label on the search bar. Defaults to "Search".
      */
@@ -86,7 +89,7 @@ export interface BaseData<EntityType extends Entity> {
     /**
      * Defines how the search string of entities is generated.
      */
-    searchString?: (enity: EntityType) => string;
+    searchString?: (entity: EntityType) => string;
     /**
      * Defines whether or not the user can add new entities.
      *
@@ -113,6 +116,9 @@ export interface BaseData<EntityType extends Entity> {
      */
     multiSelectLabel?: string;
 }
+/**
+ * The data of the default create-dialog.
+ */
 export interface CreateDialogData {
     /**
      * The title of the default create-dialog.
@@ -135,7 +141,10 @@ export interface CreateDialogData {
      */
     confirmCreateDialogData?: ConfirmDialogData;
 }
-export interface EditDialogData<EntityType extends Entity> {
+/**
+ * The data of the default edit-dialog.
+ */
+export interface EditDialogData<EntityType extends BaseEntityType<EntityType>> {
     /**
      * The title of the default edit-dialog.
      */
@@ -169,7 +178,10 @@ export interface EditDialogData<EntityType extends Entity> {
      */
     confirmEditDialogData?: ConfirmDialogData;
 }
-export interface TableData<EntityType extends Entity> {
+/**
+ * All the configuration data required to display a ngx-mat-entity-table.
+ */
+export interface TableData<EntityType extends BaseEntityType<EntityType>> {
     /**
      * The base data for the table-component.
      * Includes stuff like the title for the table, what to display inside the rows etc.

package/components/table/table.component.d.ts

@@ -2,13 +2,19 @@ import { Injector, OnDestroy, OnInit } from '@angular/core';
 import { MatPaginator } from '@angular/material/paginator';
 import { MatSort } from '@angular/material/sort';
 import { MatTableDataSource } from '@angular/material/table';
-import { Entity } from '../../classes/entity-model.class';
 import { SelectionModel } from '@angular/cdk/collections';
 import { MatDialog } from '@angular/material/dialog';
 import { MultiSelectAction, TableData } from './table-data';
 import { TableDataInternal } from './table-data.builder';
+import { BaseEntityType } from '../../classes/entity.model';
 import * as i0 from "@angular/core";
-export declare class NgxMatEntityTableComponent<EntityType extends Entity> implements OnInit, OnDestroy {
+/**
+ * Generates a fully functional table for displaying, creating, updating and deleting entities
+ * based on the configuration passed in the @Input "tableData".
+ *
+ * It offers a lot of customization options which can be found in "TableData".
+ */
+export declare class NgxMatEntityTableComponent<EntityType extends BaseEntityType<EntityType>> implements OnInit, OnDestroy {
     private readonly dialog;
     private readonly injector;
     /**
@@ -25,17 +31,57 @@ export declare class NgxMatEntityTableComponent<EntityType extends Entity> imple
     dataSource: MatTableDataSource<EntityType>;
     selection: SelectionModel<EntityType>;
     constructor(dialog: MatDialog, injector: Injector);
+    /**
+     * Sets up all the configuration for the table and the EntityService.
+     */
     ngOnInit(): void;
+    /**
+     * Edits an entity. This either calls the edit-Method provided by the user or uses a default edit-dialog.
+     *
+     * @param entity - The entity that should be updated.
+     * @throws When no EntityClass was provided, as a new call is needed to initialize metadata.
+     */
     editEntity(entity: EntityType): void;
     private editDefault;
+    /**
+     * Creates a new Entity. This either calls the create-Method provided by the user or uses a default create-dialog.
+     *
+     * @throws When no EntityClass was provided, as a new call is needed to initialize metadata.
+     */
     createEntity(): void;
     private createDefault;
+    /**
+     * Runs the MultiAction for all selected entries.
+     * Also handles confirmation with an additional dialog if configured.
+     *
+     * @param action - The MultiAction to run.
+     */
     runMultiAction(action: MultiSelectAction<EntityType>): void;
     private confirmRunMultiAction;
+    /**
+     * Checks if an MultiAction is disabled (e.g. Because no entries have been selected).
+     *
+     * @param action - The MultiAction to check.
+     * @returns Whether or not the Action can be used.
+     */
     multiActionDisabled(action: MultiSelectAction<EntityType>): boolean;
+    /**
+     * Toggles all entries in the table.
+     */
     masterToggle(): void;
+    /**
+     * Checks if all entries in the table have been selected.
+     * This is needed to display the "masterToggle"-checkbox correctly.
+     *
+     * @returns Whether or not all entries in the table have been selected.
+     */
     isAllSelected(): boolean;
     ngOnDestroy(): void;
+    /**
+     * Applies the search input to filter the table entries.
+     *
+     * @param event - The keyup-event which contains the search-string of the user.
+     */
     applyFilter(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxMatEntityTableComponent<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NgxMatEntityTableComponent<any>, "ngx-mat-entity-table", never, { "tableData": "tableData"; }, {}, never, never>;

package/components/table/table.module.d.ts

@@ -10,8 +10,10 @@ import * as i8 from "@angular/material/paginator";
 import * as i9 from "@angular/material/button";
 import * as i10 from "@angular/material/menu";
 import * as i11 from "@angular/material/dialog";
+import * as i12 from "./create-dialog/create-entity-dialog.module";
+import * as i13 from "./edit-dialog/edit-entity-dialog.module";
 export declare class NgxMatEntityTableModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxMatEntityTableModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<NgxMatEntityTableModule, [typeof i1.NgxMatEntityTableComponent], [typeof i2.CommonModule, typeof i3.MatInputModule, typeof i4.FormsModule, typeof i5.MatFormFieldModule, typeof i6.MatCheckboxModule, typeof i7.MatTableModule, typeof i8.MatPaginatorModule, typeof i9.MatButtonModule, typeof i10.MatMenuModule, typeof i11.MatDialogModule], [typeof i1.NgxMatEntityTableComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<NgxMatEntityTableModule, [typeof i1.NgxMatEntityTableComponent], [typeof i2.CommonModule, typeof i3.MatInputModule, typeof i4.FormsModule, typeof i5.MatFormFieldModule, typeof i6.MatCheckboxModule, typeof i7.MatTableModule, typeof i8.MatPaginatorModule, typeof i9.MatButtonModule, typeof i10.MatMenuModule, typeof i11.MatDialogModule, typeof i12.NgxMatEntityCreateDialogModule, typeof i13.NgxMatEntityEditDialogModule], [typeof i1.NgxMatEntityTableComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<NgxMatEntityTableModule>;
 }

package/decorators/array/array-decorator-internal.data.d.ts

@@ -1,32 +1,108 @@
-import { Entity } from '../../classes/entity-model.class';
 import { CreateDialogData } from '../../components/table/table-data';
+import { BaseEntityType, EntityClassNewable } from '../../classes/entity.model';
 import { DecoratorTypes } from '../base/decorator-types.enum';
 import { PropertyDecoratorConfigInternal } from '../base/property-decorator-internal.data';
-import { ArrayTableDisplayColumn, AutocompleteStringChipsArrayDecoratorConfig, EntityArrayDecoratorConfig, StringChipsArrayDecoratorConfig } from './array-decorator.data';
-export declare class EntityArrayDecoratorConfigInternal<EntityType extends Entity> extends PropertyDecoratorConfigInternal implements EntityArrayDecoratorConfig<EntityType> {
+import { ArrayTableDisplayColumn, AutocompleteStringChipsArrayDecoratorConfig, DateArrayDecoratorConfig, DateRangeArrayDecoratorConfig, DateTimeArrayDecoratorConfig, EntityArrayDecoratorConfig, StringChipsArrayDecoratorConfig } from './array-decorator.data';
+import { DateFilterFn } from '@angular/material/datepicker';
+import { Time } from '@angular/common';
+import { DropdownValue } from '../base/dropdown-value.interface';
+import { DateRange } from '../date/date-decorator.data';
+import { ConfirmDialogData } from '../../components/confirm-dialog/confirm-dialog-data';
+/**
+ * The internal EntityArrayDecoratorConfig. Sets default values.
+ */
+export declare class EntityArrayDecoratorConfigInternal<EntityType extends BaseEntityType<EntityType>> extends PropertyDecoratorConfigInternal implements EntityArrayDecoratorConfig<EntityType> {
     itemType: DecoratorTypes.OBJECT;
-    displayStyle: 'table';
-    EntityClass: new (entity?: EntityType) => EntityType;
+    allowDuplicates: boolean;
+    duplicatesErrorDialog: ConfirmDialogData;
+    EntityClass: EntityClassNewable<EntityType>;
     displayColumns: ArrayTableDisplayColumn<EntityType>[];
     createDialogData?: CreateDialogData;
     createInline: boolean;
     missingErrorMessage: string;
+    addButtonLabel: string;
+    removeButtonLabel: string;
     constructor(data: EntityArrayDecoratorConfig<EntityType>);
 }
+/**
+ * The internal DateArrayDecoratorConfig. Sets default values.
+ */
+export declare class DateArrayDecoratorConfigInternal extends PropertyDecoratorConfigInternal implements DateArrayDecoratorConfig {
+    itemType: DecoratorTypes.DATE;
+    allowDuplicates: boolean;
+    duplicatesErrorDialog: ConfirmDialogData;
+    displayColumns: ArrayTableDisplayColumn<Date>[];
+    addButtonLabel: string;
+    removeButtonLabel: string;
+    missingErrorMessage: string;
+    min?: (date?: Date) => Date;
+    max?: (date?: Date) => Date;
+    filter?: DateFilterFn<Date | null | undefined>;
+    constructor(data: DateArrayDecoratorConfig);
+}
+/**
+ * The internal DateTimeArrayDecoratorConfig. Sets default values.
+ */
+export declare class DateTimeArrayDecoratorConfigInternal extends PropertyDecoratorConfigInternal implements DateTimeArrayDecoratorConfig {
+    itemType: DecoratorTypes.DATE_TIME;
+    allowDuplicates: boolean;
+    duplicatesErrorDialog: ConfirmDialogData;
+    displayColumns: ArrayTableDisplayColumn<Date>[];
+    addButtonLabel: string;
+    removeButtonLabel: string;
+    missingErrorMessage: string;
+    times: DropdownValue<Time>[];
+    timeDisplayName: string;
+    minDate?: (date?: Date) => Date;
+    maxDate?: (date?: Date) => Date;
+    filterDate?: DateFilterFn<Date | null | undefined>;
+    minTime?: (date?: Date) => Time;
+    maxTime?: (date?: Date) => Time;
+    filterTime?: ((time: Time) => boolean) | (() => boolean);
+    constructor(data: DateTimeArrayDecoratorConfig);
+}
+/**
+ * The internal DateRangeArrayDecoratorConfig. Sets default values.
+ */
+export declare class DateRangeArrayDecoratorConfigInternal extends PropertyDecoratorConfigInternal implements DateRangeArrayDecoratorConfig {
+    itemType: DecoratorTypes.DATE_RANGE;
+    allowDuplicates: boolean;
+    duplicatesErrorDialog: ConfirmDialogData;
+    displayColumns: ArrayTableDisplayColumn<DateRange>[];
+    addButtonLabel: string;
+    removeButtonLabel: string;
+    missingErrorMessage: string;
+    placeholderStart: string;
+    placeholderEnd: string;
+    minStart?: (date?: Date) => Date;
+    maxStart?: (date?: Date) => Date;
+    minEnd?: (date?: Date) => Date;
+    maxEnd?: (date?: Date) => Date;
+    filter?: DateFilterFn<Date>;
+    constructor(data: DateRangeArrayDecoratorConfig);
+}
+/**
+ * The internal StringChipsArrayDecoratorConfig. Sets default values.
+ */
 export declare class StringChipsArrayDecoratorConfigInternal extends PropertyDecoratorConfigInternal implements StringChipsArrayDecoratorConfig {
     itemType: DecoratorTypes.STRING;
-    displayStyle: 'chips';
-    deleteHtml?: string;
+    allowDuplicates: boolean;
+    duplicatesErrorDialog: ConfirmDialogData;
+    deleteIcon: string;
     minLength?: number;
     maxLength?: number;
     regex?: RegExp;
     constructor(data: StringChipsArrayDecoratorConfig);
 }
+/**
+ * The internal AutocompleteStringChipsArrayDecoratorConfig. Sets default values.
+ */
 export declare class AutocompleteStringChipsArrayDecoratorConfigInternal extends PropertyDecoratorConfigInternal implements AutocompleteStringChipsArrayDecoratorConfig {
     autocompleteValues: string[];
     itemType: DecoratorTypes.STRING_AUTOCOMPLETE;
-    displayStyle: 'chips';
-    deleteHtml?: string;
+    allowDuplicates: boolean;
+    duplicatesErrorDialog: ConfirmDialogData;
+    deleteIcon: string;
     minLength?: number;
     maxLength?: number;
     regex?: RegExp;

package/decorators/array/array-decorator.data.d.ts

@@ -1,8 +1,16 @@
-import { Entity } from '../../classes/entity-model.class';
 import { CreateDialogData } from '../../components/table/table-data';
+import { BaseEntityType, EntityClassNewable } from '../../classes/entity.model';
 import { DecoratorTypes } from '../base/decorator-types.enum';
 import { PropertyDecoratorConfig } from '../base/property-decorator.data';
-export interface ArrayTableDisplayColumn<EntityType extends Entity> {
+import { DateFilterFn } from '@angular/material/datepicker';
+import { Time } from '@angular/common';
+import { DropdownValue } from '../base/dropdown-value.interface';
+import { DateRange } from '../date/date-decorator.data';
+import { ConfirmDialogData } from '../../components/confirm-dialog/confirm-dialog-data';
+/**
+ * The configuration options for an array property displayed as a table.
+ */
+export interface ArrayTableDisplayColumn<EntityType extends BaseEntityType<EntityType>> {
     /**
      * The name inside the header.
      */
@@ -15,26 +23,31 @@ export interface ArrayTableDisplayColumn<EntityType extends Entity> {
 /**
  * Interface definition for the @array metadata.
  */
-declare abstract class ArrayDecoratorConfig extends PropertyDecoratorConfig {
-    /**
-     * How to display the string.
-     */
-    displayStyle: 'table' | 'chips';
+export declare abstract class ArrayDecoratorConfig extends PropertyDecoratorConfig {
     /**
      * The type of the items inside the array.
      */
     itemType: DecoratorTypes;
+    /**
+     * Whether or not duplicate values are allowed inside the array.
+     *
+     * @default false
+     */
+    allowDuplicates?: boolean;
+    /**
+     * The error dialog to display when the user tries to add a duplicate entry.
+     */
+    duplicatesErrorDialog?: ConfirmDialogData;
 }
 /**
  * Definition for an array of Entities.
  */
-export interface EntityArrayDecoratorConfig<EntityType extends Entity> extends ArrayDecoratorConfig {
+export interface EntityArrayDecoratorConfig<EntityType extends BaseEntityType<EntityType>> extends ArrayDecoratorConfig {
     itemType: DecoratorTypes.OBJECT;
-    displayStyle: 'table';
     /**
      * The EntityClass used for generating the create inputs.
      */
-    EntityClass: new (entity?: EntityType) => EntityType;
+    EntityClass: EntityClassNewable<EntityType>;
     /**
      * The definition of the columns to display. Consists of the displayName to show in the header of the row
      * and the value, which is a function that generates the value to display inside a column.
@@ -52,26 +65,193 @@ export interface EntityArrayDecoratorConfig<EntityType extends Entity> extends A
      * @default true
      */
     createInline?: boolean;
+    /**
+     * The label for the add button when createInline is true.
+     *
+     * @default 'Add'
+     */
+    addButtonLabel?: string;
+    /**
+     * The label for the remove button when createInline is true.
+     *
+     * @default 'Remove'
+     */
+    removeButtonLabel?: string;
     /**
      * The error-message to display when the array is required but contains no values.
      */
     missingErrorMessage?: string;
 }
+/**
+ * Definition for an array of Dates.
+ */
+export interface DateArrayDecoratorConfig extends ArrayDecoratorConfig {
+    itemType: DecoratorTypes.DATE;
+    /**
+     * The definition of the columns to display. Consists of the displayName to show in the header of the row
+     * and the value, which is a function that generates the value to display inside a column.
+     */
+    displayColumns: ArrayTableDisplayColumn<Date>[];
+    /**
+     * The label for the add button.
+     *
+     * @default 'Add'
+     */
+    addButtonLabel?: string;
+    /**
+     * The label for the remove button.
+     *
+     * @default 'Remove'
+     */
+    removeButtonLabel?: string;
+    /**
+     * The error-message to display when the array is required but contains no values.
+     */
+    missingErrorMessage?: string;
+    /**
+     * A function to get the minimum value of the date.
+     */
+    min?: (date?: Date) => Date;
+    /**
+     * A function to get the maximum value of the date.
+     */
+    max?: (date?: Date) => Date;
+    /**
+     * A filter function to do more specific filtering. This could be the removal of e.g. All weekends.
+     */
+    filter?: DateFilterFn<Date | null | undefined>;
+}
+/**
+ * Definition for an array of DateTimes.
+ */
+export interface DateTimeArrayDecoratorConfig extends ArrayDecoratorConfig {
+    itemType: DecoratorTypes.DATE_TIME;
+    /**
+     * The definition of the columns to display. Consists of the displayName to show in the header of the row
+     * and the value, which is a function that generates the value to display inside a column.
+     */
+    displayColumns: ArrayTableDisplayColumn<Date>[];
+    /**
+     * The label for the add button.
+     *
+     * @default 'Add'
+     */
+    addButtonLabel?: string;
+    /**
+     * The label for the remove button.
+     *
+     * @default 'Remove'
+     */
+    removeButtonLabel?: string;
+    /**
+     * The error-message to display when the array is required but contains no values.
+     */
+    missingErrorMessage?: string;
+    /**
+     * The selectable times.
+     */
+    times?: DropdownValue<Time>[];
+    /**
+     * The name to use as a label for the time form field.
+     *
+     * @default 'Time'
+     */
+    timeDisplayName?: string;
+    /**
+     * A function to get the minimum value of the date.
+     */
+    minDate?: (date?: Date) => Date;
+    /**
+     * A function to get the maximum value of the date.
+     */
+    maxDate?: (date?: Date) => Date;
+    /**
+     * A filter function to do more specific date filtering. This could be the removal of e.g. All weekends.
+     */
+    filterDate?: DateFilterFn<Date | null | undefined>;
+    /**
+     * A function to get the minimum value of the time.
+     */
+    minTime?: (date?: Date) => Time;
+    /**
+     * A function to get the maximum value of the time.
+     */
+    maxTime?: (date?: Date) => Time;
+    /**
+     * A filter function to do more specific time filtering. This could be e.g. The removal of lunch breaks.
+     */
+    filterTime?: ((time: Time) => boolean) | (() => boolean);
+}
+/**
+ * Definition for an array of DateRanges.
+ */
+export interface DateRangeArrayDecoratorConfig extends ArrayDecoratorConfig {
+    itemType: DecoratorTypes.DATE_RANGE;
+    /**
+     * The definition of the columns to display. Consists of the displayName to show in the header of the row
+     * and the value, which is a function that generates the value to display inside a column.
+     */
+    displayColumns: ArrayTableDisplayColumn<DateRange>[];
+    /**
+     * The label for the add button.
+     *
+     * @default 'Add'
+     */
+    addButtonLabel?: string;
+    /**
+     * The label for the remove button.
+     *
+     * @default 'Remove'
+     */
+    removeButtonLabel?: string;
+    /**
+     * The error-message to display when the array is required but contains no values.
+     */
+    missingErrorMessage?: string;
+    /**
+     * A function to get the minimum value of the start date.
+     */
+    minStart?: (date?: Date) => Date;
+    /**
+     * A function to get the maximum value of the start date.
+     */
+    maxStart?: (date?: Date) => Date;
+    /**
+     * A function to get the minimum value of the end date.
+     */
+    minEnd?: (date?: Date) => Date;
+    /**
+     * A function to get the maximum value of the end date.
+     */
+    maxEnd?: (date?: Date) => Date;
+    /**
+     * A filter function to do more specific filtering on the disallowed end date values. This could be the removal of e.g. All weekends.
+     */
+    filter?: DateFilterFn<Date>;
+    /**
+     * The placeholder for the start date of the date range picker.
+     *
+     * @default "Start"
+     */
+    placeholderStart?: string;
+    /**
+     * The placeholder for the end date of the date range picker.
+     *
+     * @default "End"
+     */
+    placeholderEnd?: string;
+}
 /**
  * Definition for an array of strings displayed as a chips list.
  */
 export interface StringChipsArrayDecoratorConfig extends ArrayDecoratorConfig {
     itemType: DecoratorTypes.STRING;
-    displayStyle: 'chips';
     /**
-     * The html inside the delete-button.
-     * Please note that custom tags such as <mat-icon></mat-icon>
-     * need to be defined as known elements, otherwise the sanitizer will remove them.
-     * You can however work around this by using `<span class="material-icons"></span>`.
+     * The class for the <i> tag used to remove an entry from the array.
      *
-     * @default <mat-icon>cancel</mat-icon>
+     * @default 'fas fa-circle-minus'
      */
-    deleteHtml?: string;
+    deleteIcon?: string;
     /**
      * The minimum required length of the string.
      */
@@ -90,16 +270,12 @@ export interface StringChipsArrayDecoratorConfig extends ArrayDecoratorConfig {
  */
 export interface AutocompleteStringChipsArrayDecoratorConfig extends ArrayDecoratorConfig {
     itemType: DecoratorTypes.STRING_AUTOCOMPLETE;
-    displayStyle: 'chips';
     /**
-     * The html inside the delete-button.
-     * Please note that custom tags such as <mat-icon></mat-icon>
-     * need to be defined as known elements, otherwise the sanitizer will remove them.
-     * You can however work around this by using `<span class="material-icons"></span>`.
+     * The class for the <i> tag used to remove an entry from the array.
      *
-     * @default <mat-icon>cancel</mat-icon>
+     * @default 'fas fa-circle-minus'
      */
-    deleteHtml?: string;
+    deleteIcon?: string;
     /**
      * The autocomplete values.
      */
@@ -117,4 +293,3 @@ export interface AutocompleteStringChipsArrayDecoratorConfig extends ArrayDecora
      */
     regex?: RegExp;
 }
-export {};

package/decorators/array/array.decorator.d.ts

@@ -1,10 +1,10 @@
-import { Entity } from '../../classes/entity-model.class';
-import { AutocompleteStringChipsArrayDecoratorConfig, EntityArrayDecoratorConfig, StringChipsArrayDecoratorConfig } from './array-decorator.data';
+import { BaseEntityType } from '../../classes/entity.model';
+import { AutocompleteStringChipsArrayDecoratorConfig, DateArrayDecoratorConfig, DateRangeArrayDecoratorConfig, DateTimeArrayDecoratorConfig, EntityArrayDecoratorConfig, StringChipsArrayDecoratorConfig } from './array-decorator.data';
 /**
- * Decorator for setting and getting array propery metadata.
+ * Decorator for setting and getting array property metadata.
  *
  * @param metadata - The metadata of the array property.
  * @returns The method that defines the metadata.
  * @throws When the given type of the array-items is unknown.
  */
-export declare function array<EntityType extends Entity>(metadata: EntityArrayDecoratorConfig<EntityType> | StringChipsArrayDecoratorConfig | AutocompleteStringChipsArrayDecoratorConfig): (target: object, propertyKey: string) => void;
+export declare function array<EntityType extends BaseEntityType<EntityType>>(metadata: EntityArrayDecoratorConfig<EntityType> | StringChipsArrayDecoratorConfig | AutocompleteStringChipsArrayDecoratorConfig | DateArrayDecoratorConfig | DateTimeArrayDecoratorConfig | DateRangeArrayDecoratorConfig): (target: object, propertyKey: string) => void;