@mediusinc/mng-commons 0.12.2 → 0.12.3-rc.1

package/lib/descriptors/column.descriptor.d.ts

@@ -1,82 +1,116 @@
-import { Type } from '@angular/core';
-import { IColumnValueComponent } from '../models';
-import { ClassType, EnumConstantType, EnumType } from '../types';
-import { FilterDescriptor, FilterLookupDescriptor, FilterLookupEnumDescriptor } from './filter.descriptor';
-import { TableDescriptor } from './table.descriptor';
-import { ColumnTypeEnum } from './types';
-export declare class ColumnDescriptor<T, TT> {
-    private readonly _table;
-    private readonly _property;
-    private _columnType;
-    private _title?;
-    private _jsonPath?;
-    private _isSortEnabled;
-    private _filterDescriptor?;
-    private _displayFormat?;
-    private _locale?;
-    private _headerClassName;
-    private _className;
-    private _width;
-    private _minWidth;
-    private _maxWidth;
-    private _enumType?;
-    private _enumTitlePath?;
-    private _enumNameAsValue;
-    private _booleanAsIcon;
-    private _booleanYes?;
-    private _booleanNo?;
-    private _objectModelType?;
-    private _objectTitleProperty?;
-    private _currencyCode?;
-    private _currencyFromProperty?;
-    private _currencyDisplay?;
-    private _customComponentType?;
-    private _hasCopyToClipboard;
-    constructor(table: TableDescriptor<TT>, property: string);
-    get columnType(): ColumnTypeEnum;
-    get title(): string | undefined;
-    get jsonPath(): string | undefined;
-    get isSortEnabled(): boolean;
-    get filterDescriptor(): FilterDescriptor<T> | undefined;
-    get displayFormat(): string | undefined;
-    get table(): TableDescriptor<TT>;
-    get property(): string;
-    get headerClassName(): string;
-    get className(): string;
-    get width(): number | null;
-    get minWidth(): number | null;
-    get maxWidth(): number | null;
-    get enumType(): EnumType | undefined;
-    get enumTitlePath(): string | null | undefined;
-    get enumNameAsValue(): boolean;
-    get booleanAsIcon(): boolean;
-    get booleanYes(): string | undefined;
-    get booleanNo(): string | undefined;
-    get objectModelType(): ClassType<unknown> | undefined;
-    get objectTitleProperty(): string | undefined;
-    get customComponentType(): Type<IColumnValueComponent<TT>> | undefined;
-    get locale(): string | undefined;
-    get currencyCode(): string | undefined;
-    get currencyDisplay(): "symbol" | "code" | "name" | undefined;
-    get currencyFromProperty(): string | undefined;
-    get hasCopyToClipboard(): boolean;
-    asType(type?: ColumnTypeEnum): this;
-    asNumber(displayFormat?: string, locale?: string): this;
-    asCurrency(currencyCode?: string, currencyFromProperty?: string, currencyDisplay?: 'symbol' | 'code' | 'name', displayFormat?: string, locale?: string): this;
-    asDate(displayFormat?: string): this;
-    asBoolean(yes?: string, no?: string, asIcon?: boolean): this;
-    asEnum(enumType: EnumType, nameAsValue?: boolean, titlePath?: string | null): this;
-    asCustomComponent(customComponentType: Type<IColumnValueComponent<TT>>): this;
-    withClassName(className?: string, headerClassName?: string): this;
-    withWidth(width?: number, minWidth?: number, maxWidth?: number): this;
-    withObjectProperty<MT>(modelType: ClassType<MT>, titleProperty?: string): this;
-    withTitle(title: string): this;
-    withJsonPath(path: string): this;
-    withFilter(forceSimple?: boolean): FilterDescriptor<T>;
-    withFilterLookup(): FilterLookupDescriptor<unknown>;
-    withFilterLookupEnum(options?: Array<EnumConstantType>): FilterLookupEnumDescriptor;
-    withSort(isEnabled?: boolean): this;
-    withDefaultSort(asc?: boolean): this;
-    withCopyToClipboard(hasCopyToCliboard?: boolean): this;
-    copy(): ColumnDescriptor<T, TT>;
-}
+import { Type } from '@angular/core';
+import { IColumnValueComponent } from '../models';
+import { ClassType, EnumConstantType, EnumType } from '../types';
+import { FilterDescriptor, FilterLookupDescriptor, FilterLookupEnumDescriptor } from './filter.descriptor';
+import { TableDescriptor, TableDynamicDescriptor } from './table.descriptor';
+import { ColumnTypeEnum } from './types';
+export declare class ColumnDescriptor<T, TT> {
+    protected readonly _table: TableDescriptor<TT>;
+    protected readonly _property: string;
+    private _columnType;
+    protected _title?: string;
+    private _jsonPath?;
+    private _isSortEnabled;
+    private _filterDescriptor?;
+    private _displayFormat?;
+    private _locale?;
+    private _headerClassName;
+    private _className;
+    private _width;
+    private _minWidth;
+    private _maxWidth;
+    private _enumType?;
+    private _enumTitlePath?;
+    private _enumNameAsValue;
+    private _booleanAsIcon;
+    private _booleanYes?;
+    private _booleanNo?;
+    private _objectModelType?;
+    private _objectTitleProperty?;
+    private _currencyCode?;
+    private _currencyFromProperty?;
+    private _currencyDisplay?;
+    private _customComponentType?;
+    private _hasCopyToClipboard;
+    constructor(table: TableDescriptor<TT>, property: string);
+    get columnType(): ColumnTypeEnum;
+    get title(): string | undefined;
+    get jsonPath(): string | undefined;
+    get isSortEnabled(): boolean;
+    get filterDescriptor(): FilterDescriptor<T> | undefined;
+    get displayFormat(): string | undefined;
+    get table(): TableDescriptor<TT>;
+    get property(): string;
+    get headerClassName(): string;
+    get className(): string;
+    get width(): number | null;
+    get minWidth(): number | null;
+    get maxWidth(): number | null;
+    get enumType(): EnumType | undefined;
+    get enumTitlePath(): string | null | undefined;
+    get enumNameAsValue(): boolean;
+    get booleanAsIcon(): boolean;
+    get booleanYes(): string | undefined;
+    get booleanNo(): string | undefined;
+    get objectModelType(): ClassType<unknown> | undefined;
+    get objectTitleProperty(): string | undefined;
+    get customComponentType(): Type<IColumnValueComponent<TT>> | undefined;
+    get locale(): string | undefined;
+    get currencyCode(): string | undefined;
+    get currencyDisplay(): "symbol" | "code" | "name" | undefined;
+    get currencyFromProperty(): string | undefined;
+    get hasCopyToClipboard(): boolean;
+    /**
+     * converts column to given type with additional arguments
+     * @param type column type enum
+     * @param args any additional arguments for column (optional)
+     */
+    asType(type: ColumnTypeEnum, ...args: any[]): this;
+    asNumber(displayFormat?: string, locale?: string): this;
+    asCurrency(currencyCode?: string, currencyFromProperty?: string, currencyDisplay?: 'symbol' | 'code' | 'name', displayFormat?: string, locale?: string): this;
+    asDate(displayFormat?: string): this;
+    asBoolean(yes?: string, no?: string, asIcon?: boolean): this;
+    asEnum(enumType: EnumType, nameAsValue?: boolean, titlePath?: string | null): this;
+    asCustomComponent(customComponentType: Type<IColumnValueComponent<TT>>): this;
+    withClassName(className?: string, headerClassName?: string): this;
+    withWidth(width?: number, minWidth?: number, maxWidth?: number): this;
+    withObjectProperty<MT>(modelType: ClassType<MT>, titleProperty?: string): this;
+    withTitle(title: string): this;
+    withJsonPath(path: string): this;
+    withFilter(forceSimple?: boolean): FilterDescriptor<T>;
+    withFilterLookup(): FilterLookupDescriptor<unknown>;
+    withFilterLookupEnum(options?: Array<EnumConstantType>): FilterLookupEnumDescriptor;
+    withSort(isEnabled?: boolean): this;
+    withDefaultSort(asc?: boolean): this;
+    withCopyToClipboard(hasCopyToCliboard?: boolean): this;
+    copy(): ColumnDescriptor<T, TT>;
+    protected copyFieldsTo(obj: ColumnDescriptor<T, TT>): void;
+}
+export declare class ColumnDynamicDescriptor extends ColumnDescriptor<any, any> {
+    protected _table: TableDynamicDescriptor;
+    protected _title: string | undefined;
+    private _visibility;
+    constructor(table: TableDynamicDescriptor, property: string);
+    get visibility(): boolean;
+    /**
+     * sets column's title and returns this column
+     * @param title title to be set
+     * @param override should column title if all ready set?
+     */
+    withTitle(title: string, override?: boolean): this;
+    /**
+     * defines automatic type and returns this column
+     * @param value
+     */
+    withAutomaticType(value: string): this;
+    /**
+     * sets visibility state for column and returns this column
+     * @param visibility
+     */
+    withVisibility(visibility: boolean): this;
+    /**
+     * creates deep copy of column dynamic descriptor
+     */
+    copy(): ColumnDynamicDescriptor;
+    toColumnDescriptor(tableDescriptor: TableDescriptor<any>): ColumnDescriptor<any, any>;
+}

package/lib/descriptors/editor.descriptor.d.ts

@@ -1,37 +1,102 @@
-import { ClassType, EnumConstantType, EnumType, MngFieldValidationMessage, MngFieldValidator } from '../types';
-import { AFieldDescriptor, FieldGroupDescriptor, FieldInputDescriptor, FieldLookupDescriptor, FieldLookupEnumDescriptor, FieldManyEditorDescriptor, FieldManyToManyEditorDescriptor, FieldTabGroupDescriptor, ModelDescriptor, TableDescriptor, TableviewDescriptor } from './';
-import { TableviewTypeEnum } from './types';
-export declare class EditorDescriptor<T> {
-    static readonly defaultGroupName = "_default";
-    private readonly _model;
-    private readonly _tableviewEditorType;
-    private readonly _tabs;
-    private readonly _groups;
-    private readonly _fields;
-    private _currentTabGroup?;
-    private _currentGroup?;
-    private _disabled;
-    constructor(modelType: ClassType<T>, idProperty?: string, titleProperty?: string, tableviewEditorType?: TableviewTypeEnum);
-    get model(): ModelDescriptor<T>;
-    get tabs(): FieldTabGroupDescriptor<T>[];
-    get fields(): AFieldDescriptor<any, T>[];
-    get tableviewEditorType(): boolean;
-    get disabled(): boolean;
-    createTabGroup(name: string, title?: string): FieldTabGroupDescriptor<T>;
-    createFieldGroup(name: string, title?: string | null): FieldGroupDescriptor<T>;
-    addFieldDescriptor<FT>(field: AFieldDescriptor<FT, T>): this;
-    addField(property: string): FieldInputDescriptor<T>;
-    removeField(property: string): this;
-    getField(property: string): AFieldDescriptor<any, T> | null;
-    addFieldLookup<FT>(property: string, modelType: ClassType<FT>): FieldLookupDescriptor<FT, T>;
-    addFieldLookupEnum(property: string, enumType: EnumType, options?: Array<EnumConstantType>, nameAsValue?: boolean, optionsTitlePath?: string | null): FieldLookupEnumDescriptor<T>;
-    addFieldManyEditor<FT>(property: string, tableviewDescriptor: TableviewDescriptor<FT>): FieldManyEditorDescriptor<FT, T>;
-    addFieldManyToManyEditor<FT>(property: string, mainTableDescriptor: TableDescriptor<FT>, lookupTableDescriptor: TableDescriptor<FT>): FieldManyToManyEditorDescriptor<FT, T>;
-    withDisabled(disabled?: boolean): this;
-    addValidation(name: string, validator?: MngFieldValidator, message?: MngFieldValidationMessage): void;
-    copy(): EditorDescriptor<T>;
-    createFieldGroupDescriptor(fieldGroup: FieldGroupDescriptor<T>): this;
-    private createTabGroupDescriptor;
-    private createDefaultGroup;
-    private createDefaultTabGroup;
-}
+import { ILookupDataProvider } from '../data-providers';
+import { ClassType, EnumConstantType, EnumType, MngFieldValidationMessage, MngFieldValidator } from '../types';
+import { AFieldDescriptor, FieldGroupDescriptor, FieldInputDescriptor, FieldLookupDescriptor, FieldLookupEnumDescriptor, FieldManyEditorDescriptor, FieldManyToManyEditorDescriptor, FieldTabGroupDescriptor, ModelDescriptor, TableDescriptor, TableviewDescriptor } from './';
+import { FieldInputTypeEnum, TableviewTypeEnum } from './types';
+import { TableviewAttributeDef } from './types/tableview-attr.model';
+export declare class EditorDescriptor<T> {
+    static readonly defaultGroupName = "_default";
+    protected readonly _model: ModelDescriptor<T>;
+    protected readonly _tableviewEditorType: TableviewTypeEnum;
+    protected readonly _tabs: Array<FieldTabGroupDescriptor<T>>;
+    protected readonly _groups: Array<FieldGroupDescriptor<T>>;
+    protected _fields: Array<AFieldDescriptor<any, T>>;
+    protected _currentTabGroup?: FieldTabGroupDescriptor<T>;
+    protected _currentGroup?: FieldGroupDescriptor<T>;
+    protected _disabled: boolean;
+    constructor(modelType: ClassType<T>, idProperty?: string, titleProperty?: string, tableviewEditorType?: TableviewTypeEnum);
+    get model(): ModelDescriptor<T>;
+    get tabs(): FieldTabGroupDescriptor<T>[];
+    get fields(): AFieldDescriptor<any, T>[];
+    get tableviewEditorType(): boolean;
+    get disabled(): boolean;
+    createTabGroup(name: string, title?: string): FieldTabGroupDescriptor<T>;
+    createFieldGroup(name: string, title?: string | null): FieldGroupDescriptor<T>;
+    addFieldDescriptor<FT>(field: AFieldDescriptor<FT, T>): this;
+    addField(property: string): FieldInputDescriptor<T>;
+    removeField(property: string): void;
+    getField(property: string): AFieldDescriptor<any, T> | null;
+    addFieldLookup<FT>(property: string, modelType: ClassType<FT>): FieldLookupDescriptor<FT, T>;
+    addFieldLookupEnum(property: string, enumType: EnumType, options?: Array<EnumConstantType>, nameAsValue?: boolean, optionsTitlePath?: string | null): FieldLookupEnumDescriptor<T>;
+    addFieldManyEditor<FT>(property: string, tableviewDescriptor: TableviewDescriptor<FT>): FieldManyEditorDescriptor<FT, T>;
+    addFieldManyToManyEditor<FT>(property: string, mainTableDescriptor: TableDescriptor<FT>, lookupTableDescriptor: TableDescriptor<FT>): FieldManyToManyEditorDescriptor<FT, T>;
+    withDisabled(disabled?: boolean): this;
+    addValidation(name: string, validator?: MngFieldValidator, message?: MngFieldValidationMessage): void;
+    copy(): EditorDescriptor<T>;
+    createFieldGroupDescriptor(fieldGroup: FieldGroupDescriptor<T>): this;
+    protected createTabGroupDescriptor(tabGroup: FieldTabGroupDescriptor<T>): this;
+    private createDefaultGroup;
+    private createDefaultTabGroup;
+}
+export declare class EditorAutoDescriptor<T> extends EditorDescriptor<T> {
+    private _attributes;
+    private constructor();
+    /**
+     * creates editor with all attributes defined in model type
+     * @param modelType
+     * @param idProperty
+     * @param titleProperty
+     * @param tableEditorType
+     */
+    static generateFullFrom<T>(modelType: ClassType<T>, idProperty?: string, titleProperty?: string, tableEditorType?: TableviewTypeEnum): EditorAutoDescriptor<T>;
+    /**
+     * creates empty editor wrapper
+     * @param modelType
+     * @param tableviewEditorType
+     * @param idProperty
+     * @param titleProperty
+     */
+    static generateFrom<T>(modelType: ClassType<T>, tableviewEditorType?: TableviewTypeEnum, idProperty?: string, titleProperty?: string): EditorAutoDescriptor<T>;
+    /**
+     * add field defined in attributes
+     * use with customBuild()
+     * @param attributes fields to be added
+     */
+    withFields(attributes: TableviewAttributeDef[]): this;
+    /**
+     * modifies field properties
+     * @param property field name to be modified
+     * @param args additional parameters
+     */
+    withModifiedProperty(property: string, ...args: any[]): this;
+    /**
+     * modifies field type
+     * @param property field name to be modified
+     * @param fieldType
+     */
+    withModifiedType(property: string, fieldType: FieldInputTypeEnum): this;
+    /**
+     * modifies field type to enum
+     * @param property field name to be modified
+     * @param enumType
+     */
+    withCustomEnumType(property: string, enumType?: EnumType): this;
+    /**
+     * adds field with class lookup
+     * @param property field name to be modified
+     * @param modelType
+     * @param lookupProvider
+     * @param titleProperty
+     */
+    withClassLookupProvider<MT>(property: string, modelType: ClassType<MT>, lookupProvider: ILookupDataProvider<any, any>, titleProperty?: string): this;
+    /**
+     * creates deep copy
+     */
+    copy(): EditorAutoDescriptor<T>;
+    /**
+     * generates field
+     * @param attribute
+     * @param field
+     * @param args
+     */
+    private generateField;
+}

package/lib/descriptors/field-validation.descriptor.d.ts

@@ -1,18 +1,18 @@
-import { FormlyFieldConfig } from '@ngx-formly/core';
-import { Observable } from 'rxjs';
-import { MngFieldAsyncValidator, MngFieldValidationMessage, MngFieldValidator } from '../types';
-export declare class FieldValidationDescriptor {
-    private readonly _name;
-    private readonly _validator?;
-    private readonly _message?;
-    private readonly _options?;
-    constructor(name: string, validator?: MngFieldValidator | MngFieldAsyncValidator, message?: string | ((error: any, field: FormlyFieldConfig) => string | Observable<string>), options?: {
-        errorPath: string;
-    });
-    get name(): string;
-    get validator(): MngFieldValidator | MngFieldAsyncValidator | undefined;
-    get message(): MngFieldValidationMessage | undefined;
-    get options(): {
-        errorPath: string;
-    } | undefined;
-}
+import { FormlyFieldConfig } from '@ngx-formly/core';
+import { Observable } from 'rxjs';
+import { MngFieldAsyncValidator, MngFieldValidationMessage, MngFieldValidator } from '../types';
+export declare class FieldValidationDescriptor {
+    private readonly _name;
+    private readonly _validator?;
+    private readonly _message?;
+    private readonly _options?;
+    constructor(name: string, validator?: MngFieldValidator | MngFieldAsyncValidator, message?: string | ((error: any, field: FormlyFieldConfig) => string | Observable<string>), options?: {
+        errorPath: string;
+    });
+    get name(): string;
+    get validator(): MngFieldValidator | MngFieldAsyncValidator | undefined;
+    get message(): MngFieldValidationMessage | undefined;
+    get options(): {
+        errorPath: string;
+    } | undefined;
+}