@mediusinc/mng-commons 5.5.0 → 6.0.0-rc.3

package/tableview/api/action/descriptors/action-link.descriptor.d.ts

@@ -1,7 +1,7 @@
 import { Params, QueryParamsHandling } from '@angular/router';
 import { ActionDescriptorConstructorOptsType, ActionDescriptorInst } from './action.descriptor';
 export type ActionLinkDescriptorConstructorOpts<Model> = Omit<ActionDescriptorConstructorOptsType<Model, undefined>, 'serviceType' | 'dataProvider'>;
-export declare class ActionLinkDescriptorInst<Model> extends ActionDescriptorInst<Model, undefined> {
+export declare class ActionLinkDescriptorInst<Item, ValidationInputItem = Item> extends ActionDescriptorInst<Item, undefined, undefined, undefined, ValidationInputItem> {
     private _url;
     private _pathSegments;
     private _queryParams?;
@@ -9,7 +9,7 @@ export declare class ActionLinkDescriptorInst<Model> extends ActionDescriptorIns
     private _replaceUrl;
     private _target;
     private _isStyleLink;
-    constructor(actionName?: string, cfg?: ActionLinkDescriptorConstructorOpts<Model>);
+    constructor(actionName?: string, cfg?: ActionLinkDescriptorConstructorOpts<Item>);
     get url(): string;
     get pathSegments(): string[];
     get queryParams(): Params | undefined;
@@ -23,5 +23,5 @@ export declare class ActionLinkDescriptorInst<Model> extends ActionDescriptorIns
     withReplaceUrl(replaceUrl?: boolean): this;
     withTarget(target?: '_self' | '_blank'): this;
     withStyleLink(isStyleLink: boolean): this;
-    copy(): ActionLinkDescriptorInst<Model>;
+    copy(): ActionLinkDescriptorInst<Item, ValidationInputItem>;
 }

package/tableview/api/action/descriptors/action.descriptor.d.ts

@@ -1,12 +1,12 @@
 import { InjectionToken, Type } from '@angular/core';
 import { APermissions, ClassType, IActionDescriptor, IDataProvider, ServiceClassType, StyleLevelEnum } from '@mediusinc/mng-commons/core';
-import { ActionButtonDescriptor } from '@mediusinc/mng-commons/form/api';
+import { IActionButtonDescriptor } from '@mediusinc/mng-commons/form/api';
 import { ModelDescriptor } from '@mediusinc/mng-commons/model';
 import { IActionComponent } from '../models/action-component.model';
-import { ActionRunFnType, ActionValidationFnType } from '../models/action-descriptor.types';
+import { ActionConfirmation } from '../models/action-confirmation.model';
+import { ActionNotificationType, ActionRunFnType, ActionValidationFnType } from '../models/action-descriptor.types';
 import { ActionActivationTriggerEnum, ActionPositionEnum, ActionTypeEnum } from '../models/action.type';
 import { IActionContext } from '../models/execution/action-context.model';
-import { ActionConfirmationDescriptor } from './action-confirmation.descriptor';
 export type ActionDescriptorCreateOptsProviderType<Item, Service> = {
     serviceType?: ServiceClassType<Service>;
     dataProvider?: IDataProvider<Item, Service>;
@@ -18,7 +18,9 @@ export type ActionDescriptorCreateOptsParentType = {
 export type ActionDescriptorConstructorOptsType<Item, Service> = ActionDescriptorCreateOptsParentType & ActionDescriptorCreateOptsProviderType<Item, Service> & {
     model?: ModelDescriptor<Item>;
 };
-export declare class ActionDescriptorInst<Item, Service = any, ReturnItem = Item> implements IActionDescriptor<Item, Service> {
+type AfterRunActionType<RunReturnItem> = ActionDescriptorInst<any, any, RunReturnItem, any, undefined>;
+type OnErrorActionType<RunInputItem> = ActionDescriptorInst<any, any, RunInputItem, any, undefined>;
+export declare class ActionDescriptorInst<Item, Service = any, RunInputItem = Item, RunReturnItem = Item, ValidationInputItem = RunInputItem> implements IActionDescriptor<Item, Service> {
     protected readonly _model?: ModelDescriptor<Item>;
     protected readonly _actionName: string;
     protected readonly _actionNameLong: string;
@@ -33,97 +35,84 @@ export declare class ActionDescriptorInst<Item, Service = any, ReturnItem = Item
     private _positionTableviewCategories?;
     protected _tableviewCategory?: string;
     protected _routeUrl: string | null;
-    protected _runFunction?: ActionRunFnType<Item, Service, ReturnItem>;
-    protected _isVisibleFunction?: ActionValidationFnType<Item, Service>;
-    protected _isEnabledFunction?: ActionValidationFnType<Item, Service>;
-    protected _runConfirmationDialogDescriptor?: ActionConfirmationDescriptor<Item>;
-    protected _hasRunNotificationSuccess: boolean;
-    protected _runNotificationSuccessTitle?: string;
-    protected _runNotificationSuccessMessage?: string;
-    protected _hasRunNotificationError: boolean;
-    protected _runNotificationErrorTitle?: string;
-    protected _runNotificationErrorMessage?: string;
-    protected _afterRunAction?: ActionDescriptorInst<any> | ((ctx: IActionContext<Item, any>) => ActionDescriptorInst<any>);
-    protected _onRunErrorAction?: ActionDescriptorInst<Item> | ((ctx: IActionContext<Item, any>) => ActionDescriptorInst<Item>);
+    protected _runFunction?: ActionRunFnType<Item, Service, RunInputItem, RunReturnItem>;
+    protected _isVisibleFunction?: ActionValidationFnType<ValidationInputItem, Service>;
+    protected _isEnabledFunction?: ActionValidationFnType<ValidationInputItem, Service>;
+    protected _runConfirmation?: ActionConfirmation<RunInputItem>;
+    protected _runNotificationOnSuccess?: ActionNotificationType | boolean;
+    protected _runNotificationOnError?: ActionNotificationType | boolean;
+    protected _afterRunAction?: AfterRunActionType<RunReturnItem> | ((ctx: IActionContext<Item, RunInputItem, any>) => AfterRunActionType<RunReturnItem>);
+    protected _onRunErrorAction?: OnErrorActionType<RunInputItem> | ((ctx: IActionContext<Item, RunInputItem, any>) => OnErrorActionType<RunInputItem>);
     protected _permissions?: APermissions;
-    protected _button: ActionButtonDescriptor;
+    protected _button?: IActionButtonDescriptor;
     protected _hasItemsSelection: boolean;
     protected _component?: Type<IActionComponent<Item>>;
     protected _componentFromDi?: InjectionToken<Type<any>>;
     protected _subactionsAsMenu: boolean;
-    protected _subactions: Array<ActionDescriptorInst<Item>>;
+    protected _subactions: Array<ActionDescriptorInst<Item, any, RunInputItem, any>>;
     constructor(actionName: string, cfg?: ActionDescriptorConstructorOptsType<Item, Service>);
-    get model(): ModelDescriptor<Item, import("@mediusinc/mng-commons/core").ClassOptType<Item>> | undefined;
-    get parentModel(): ModelDescriptor<any, import("@mediusinc/mng-commons/core").ClassOptType<any>> | undefined;
+    get model(): ModelDescriptor<Item> | undefined;
+    get parentModel(): ModelDescriptor<any> | undefined;
     get parentProperty(): string | undefined;
     get i18nModelActionBaseKey(): string | undefined;
     get type(): ActionTypeEnum;
     get activationTrigger(): ActionActivationTriggerEnum;
     get position(): ActionPositionEnum;
-    get level(): StyleLevelEnum;
     get routeUrl(): string | null;
     get dataProvider(): IDataProvider<Item, Service> | undefined;
     get hasRunFunction(): boolean;
-    get runFunction(): ActionRunFnType<Item, Service, ReturnItem>;
-    get isVisibleFunction(): ActionValidationFnType<Item, Service> | undefined;
-    get isEnabledFunction(): ActionValidationFnType<Item, Service> | undefined;
+    get runFunction(): ActionRunFnType<Item, Service, RunInputItem, RunReturnItem>;
+    get isVisibleFunction(): ActionValidationFnType<ValidationInputItem, Service> | undefined;
+    get isEnabledFunction(): ActionValidationFnType<ValidationInputItem, Service> | undefined;
     get actionName(): string;
     get actionNameLong(): string;
-    get className(): string | undefined;
-    get runConfirmationDialogDescriptor(): ActionConfirmationDescriptor<Item> | undefined;
-    get hasRunConfirmation(): boolean;
-    get hasRunNotificationSuccess(): boolean;
-    get runNotificationSuccessTitle(): string | undefined;
-    get runNotificationSuccessMessage(): string | undefined;
-    get hasRunNotificationError(): boolean;
-    get runNotificationErrorTitle(): string | undefined;
-    get runNotificationErrorMessage(): string | undefined;
-    get afterRunAction(): ActionDescriptorInst<any, any, any> | ((ctx: IActionContext<Item, any>) => ActionDescriptorInst<any>) | undefined;
-    get onRunErrorAction(): ActionDescriptorInst<Item, any, Item> | ((ctx: IActionContext<Item, any>) => ActionDescriptorInst<Item>) | undefined;
+    get runConfirmation(): ActionConfirmation<RunInputItem> | undefined;
+    get runNotificationOnSuccess(): boolean | ActionNotificationType | undefined;
+    get runNotificationOnError(): boolean | ActionNotificationType | undefined;
+    get afterRunAction(): AfterRunActionType<RunReturnItem> | ((ctx: IActionContext<Item, RunInputItem, any>) => AfterRunActionType<RunReturnItem>) | undefined;
+    get onRunErrorAction(): OnErrorActionType<RunInputItem> | ((ctx: IActionContext<Item, RunInputItem, any>) => OnErrorActionType<RunInputItem>) | undefined;
     get permissions(): APermissions | undefined;
     get tableviewCategory(): string | undefined;
     get hasItemsSelection(): boolean;
-    get button(): ActionButtonDescriptor;
+    get button(): IActionButtonDescriptor | undefined;
     get component(): Type<IActionComponent<Item, undefined>> | undefined;
     get componentFromDi(): InjectionToken<Type<any>> | undefined;
     get positionTableviewCategories(): string[] | undefined;
     get subactionsAsMenu(): boolean;
-    get subactions(): ActionDescriptorInst<Item, any, Item>[];
+    get subactions(): ActionDescriptorInst<Item, any, RunInputItem, any, RunInputItem>[];
     protected setI18nModelActionBaseKey(base?: string): void;
-    withRunFunction(fn: ActionRunFnType<Item, Service, ReturnItem>): this;
-    withIsVisibleFunction(fn?: ActionValidationFnType<Item, Service>): this;
-    withIsEnabledFunction(fn?: ActionValidationFnType<Item, Service>): this;
+    withRunFunction(fn: ActionRunFnType<Item, Service, RunInputItem, RunReturnItem>): this;
+    withIsVisibleFunction(fn?: ActionValidationFnType<ValidationInputItem, Service>): this;
+    withIsEnabledFunction(fn?: ActionValidationFnType<ValidationInputItem, Service>): this;
     withRouteTrigger(routeUrl: string): this;
     withPosition(position: ActionPositionEnum): this;
     /**
-     * creates confirmation action with default style based on action descriptor
+     * Creates confirmation action with default style based on action descriptor
      */
-    withRunConfirmation(): ActionConfirmationDescriptor<Item>;
+    withRunConfirmation(opts?: boolean | ActionConfirmation<RunInputItem>): this;
     /**
-     * Add a configuration dialogue to action using ActionConfigurationDescriptor
-     * @param runConfirmationDialogDescriptor descriptor with customizable information for dialog
+     * Override default notifications setup. Notifications can either be overridden with custom text or turned on/off.
+     *
+     * @param opts Provide config for texts or on/off flag for run success/error notifications.
      */
-    withRunConfirmationDescriptor(runConfirmationDialogDescriptor?: ActionConfirmationDescriptor<Item>): this;
-    withRunNotificationSuccess(title?: string, message?: string, hasNotification?: boolean): this;
-    withRunNotificationError(title?: string, message?: string, hasNotification?: boolean): this;
-    withAfterRunAction<Return, Service = any>(action?: ActionDescriptorInst<Return> | ((ctx: IActionContext<Item, Service>) => ActionDescriptorInst<Return>)): this;
-    withOnRunErrorAction<S = any>(action?: ActionDescriptorInst<Item> | ((ctx: IActionContext<Item, S>) => ActionDescriptorInst<Item>)): this;
+    withNotifications(opts?: {
+        runOnSuccess?: ActionNotificationType | boolean;
+        runOnError?: ActionNotificationType | boolean;
+    } | boolean): this;
+    withAfterRunAction(action?: AfterRunActionType<RunReturnItem> | ((ctx: IActionContext<Item, RunInputItem, any>) => AfterRunActionType<RunReturnItem>)): this;
+    withOnRunErrorAction(action?: OnErrorActionType<RunInputItem> | ((ctx: IActionContext<Item, RunInputItem, any>) => OnErrorActionType<RunInputItem>)): this;
     withPermissions(permissions: APermissions): this;
-    withTableviewCategory(permissionsRouteType: string): this;
-    withButtonDescriptor(button: ActionButtonDescriptor): this;
-    withButton(label?: string | null, icon?: string | null, styleLevel?: StyleLevelEnum, styleText?: boolean): this;
+    withTableviewCategory(category: string): this;
+    withButtonOpts(button?: IActionButtonDescriptor): this;
+    withButton(label?: string | null, icon?: string | null, level?: StyleLevelEnum): this;
     withItemsSelection(hasSelection?: boolean): this;
     withComponent(component: Type<IActionComponent<Item>>): this;
     withComponentFromDi(injectionToken: InjectionToken<Type<any>>): this;
     withPositionTableviewCategories(positionTableviewCategories: string[]): this;
     withI18nBase(base: ClassType<unknown> | string): this;
     withSubactionsAsMenu(subactionsAsMenu?: boolean): this;
-    withSubactions(...subactions: Array<ActionDescriptorInst<Item>>): this;
-    copyFieldsTo(descriptor: ActionDescriptorInst<Item, Service, ReturnItem>): ActionDescriptorInst<Item, Service, ReturnItem>;
-    copy(): ActionDescriptorInst<Item, Service, ReturnItem>;
-}
-export declare class ActionDeleteDescriptorInst<Item, Service = any> extends ActionDescriptorInst<Item, Service> {
-    static readonly ACTION_NAME = "delete";
-    constructor(model: ModelDescriptor<Item>, cfg?: ActionDescriptorCreateOptsProviderType<Item, Service>);
-    copy(): ActionDeleteDescriptorInst<Item, Service>;
+    withSubactions(...subactions: Array<ActionDescriptorInst<Item, any, RunInputItem, any>>): this;
+    copyFieldsTo(descriptor: ActionDescriptorInst<Item, Service, RunInputItem, RunReturnItem, ValidationInputItem>): ActionDescriptorInst<Item, Service, RunInputItem, RunReturnItem, ValidationInputItem>;
+    copy(): ActionDescriptorInst<Item, Service, RunInputItem, RunReturnItem, ValidationInputItem>;
 }
+export {};

package/tableview/api/action/descriptors/editor-action-descriptor.factory.d.ts

@@ -0,0 +1,21 @@
+import { ModelDescriptor } from '@mediusinc/mng-commons/model';
+import { EditorDescriptorInst } from '../../editor/descriptors/editor.descriptor';
+import { ActionPositionEnum } from '../models/action.type';
+import { ActionProviderType } from './action-descriptor.factory';
+import { ActionDescriptorInst } from './action.descriptor';
+/**
+ * Defines an action to be positioned on a specified editor with editor-specific execution context.
+ *
+ * @param {string} actionName - The name identifying the action to be performed.
+ * @param {EditorDescriptorInst<EditorModel>} editor - The descriptor of the editor on which the action will be placed and executed.
+ * @param {Object} [opts] - Options for configuring the action behavior.
+ * @param {ModelDescriptor<Model>} [opts.model] - The model descriptor associated with the action.
+ * @param {ActionProviderType<Model, Service>} [opts.serviceProvider] - The service provider type for execution context.
+ * @param {ActionPositionEnum.FooterLeft | ActionPositionEnum.FooterRight | ActionPositionEnum.ToolbarLeft | ActionPositionEnum.ToolbarRight} [opts.position] - The position of action on editor.
+ * @return {ActionDescriptorInst<Model, Service, EditorModel, Model, EditorModel>} - An instance representing the configured action descriptor for the specified editor and model.
+ */
+export declare function actionOnEditor<Model, EditorModel, Service = undefined>(actionName: string, editor: EditorDescriptorInst<EditorModel>, opts?: {
+    model?: ModelDescriptor<Model>;
+    serviceProvider?: ActionProviderType<Model, Service>;
+    position?: ActionPositionEnum.FooterLeft | ActionPositionEnum.FooterRight | ActionPositionEnum.ToolbarLeft | ActionPositionEnum.ToolbarRight;
+}): ActionDescriptorInst<Model, Service, EditorModel, Model, EditorModel>;

package/tableview/api/action/descriptors/editor-action-editor-descriptor.factory.d.ts

@@ -0,0 +1,21 @@
+import { ModelDescriptor } from '@mediusinc/mng-commons/model';
+import { EditorDescriptorInst } from '../../editor/descriptors/editor.descriptor';
+import { ActionPositionEnum } from '../models/action.type';
+import { ActionEditorProviderType } from './action-editor-descriptor.factory';
+import { ActionEditorDescriptorInst } from './action-editor.descriptor';
+/**
+ * Creates and returns an instance of `ActionEditorDescriptorInst` when positioned on another (parent) editor.
+ *
+ * @param {string} actionName - The name of the action associated with the editor.
+ * @param {EditorDescriptorInst<EditorModel, ParentEditor>} editor - The editor descriptor defining editor on action.
+ * @param {Object} [opts] - Optional parameters for configuring the action editor.
+ * @param {ModelDescriptor<Model>} [opts.model] - The descriptor for the model associated with the action.
+ * @param {ActionEditorProviderType<Model, Service>} [opts.serviceProvider] - The service provider type for the action editor.
+ * @param {ActionPositionEnum.FooterLeft | ActionPositionEnum.FooterRight | ActionPositionEnum.ToolbarLeft | ActionPositionEnum.ToolbarRight} [opts.position] - The desired position of action on the editor.
+ * @return {ActionEditorDescriptorInst<Model, Service, EditorModel, ParentEditor, EditorModel, ParentEditor>} A configured instance of `ActionEditorDescriptorInst` representing the action editor.
+ */
+export declare function actionEditorOnEditor<EditorModel, ParentEditor, Model = EditorModel, Service = undefined>(actionName: string, editor: EditorDescriptorInst<EditorModel, ParentEditor>, opts?: {
+    model?: ModelDescriptor<Model>;
+    serviceProvider?: ActionEditorProviderType<Model, Service>;
+    position?: ActionPositionEnum.FooterLeft | ActionPositionEnum.FooterRight | ActionPositionEnum.ToolbarLeft | ActionPositionEnum.ToolbarRight;
+}): ActionEditorDescriptorInst<Model, Service, EditorModel, ParentEditor, EditorModel, ParentEditor>;

package/tableview/api/action/descriptors/table-action-descriptor.factory.d.ts

@@ -0,0 +1,36 @@
+import { ModelDescriptor } from '@mediusinc/mng-commons/model';
+import { TableDescriptorInst } from '@mediusinc/mng-commons/table/api';
+import { ActionPositionEnum } from '../models/action.type';
+import { ActionProviderType } from './action-descriptor.factory';
+import { ActionDescriptorInst } from './action.descriptor';
+/**
+ * Defines an action to be positioned on a specified table with table row execution context.
+ *
+ * @param {string} actionName - The name identifying the action to be performed.
+ * @param {TableDescriptorInst<TableModel, any, any>} table - The descriptor of the table on which the action will be placed and executed.
+ * @param {Object} [opts] - Options for configuring the action behavior.
+ * @param {ModelDescriptor<Model>} [opts.model] - The model descriptor associated with the action.
+ * @param {ActionProviderType<Model, Service>} [opts.serviceProvider] - The service provider type for execution context.
+ * @param {ActionPositionEnum.RowInline | ActionPositionEnum.RowClick} [opts.position] - The position of action on table.
+ * @return {ActionDescriptorInst<Model, Service, TableModel, Model, TableModel>} - An instance representing the configured action descriptor for the specified table row and model.
+ */
+export declare function actionOnTableRow<Model, TableModel, Service = undefined>(actionName: string, table: TableDescriptorInst<TableModel, any, any>, opts?: {
+    model?: ModelDescriptor<Model>;
+    serviceProvider?: ActionProviderType<Model, Service>;
+    position?: ActionPositionEnum.RowInline | ActionPositionEnum.RowClick;
+}): ActionDescriptorInst<Model, Service, TableModel, Model, TableModel>;
+/**
+ * Defines an action to be positioned on a specified table with table header or footer execution context.
+ *
+ * @param {string} actionName - The name identifying the action to be performed.
+ * @param {Object} [opts] - Options for configuring the action behavior.
+ * @param {ModelDescriptor<Model>} [opts.model] - The model descriptor associated with the action.
+ * @param {ActionProviderType<Model, Service>} [opts.serviceProvider] - The service provider type for execution context.
+ * @param {ActionPositionEnum.ToolbarLeft | ActionPositionEnum.ToolbarRight | ActionPositionEnum.TableHeader} [opts.position] - The position of action on table.
+ * @return {ActionDescriptorInst<Model, Service, TableModel, Model, TableModel>} - An instance representing the configured action descriptor for the specified table top and model.
+ */
+export declare function actionOnTableTop<Model, Service = undefined>(actionName: string, opts?: {
+    model?: ModelDescriptor<Model>;
+    serviceProvider?: ActionProviderType<Model, Service>;
+    position?: ActionPositionEnum.ToolbarLeft | ActionPositionEnum.ToolbarRight | ActionPositionEnum.TableHeader;
+}): ActionDescriptorInst<Model, Service, undefined, Model, undefined>;

package/tableview/api/action/descriptors/table-action-editor-descriptor.factory.d.ts

@@ -0,0 +1,40 @@
+import { ModelDescriptor } from '@mediusinc/mng-commons/model';
+import { TableDescriptorInst } from '@mediusinc/mng-commons/table/api';
+import { EditorDescriptorInst } from '../../editor/descriptors/editor.descriptor';
+import { ActionPositionEnum } from '../models/action.type';
+import { ActionEditorProviderType } from './action-editor-descriptor.factory';
+import { ActionEditorDescriptorInst } from './action-editor.descriptor';
+/**
+ * Creates and returns an ActionEditorDescriptorInst for displaying editor action on table row.
+ *
+ * @param {string} actionName - The name of the action.
+ * @param {EditorDescriptorInst<EditorModel, any>} editor - The editor descriptor instance responsible for configuring the editor behavior.
+ * @param {TableDescriptorInst<TableModel, any, any>} table - The table descriptor instance representing the table on which the action is positioned.
+ * @param {Object} [opts] - Optional configurations for the action editor.
+ * @param {ModelDescriptor<Model>} [opts.model] - The model descriptor associated with the action editor.
+ * @param {ActionEditorProviderType<Model, Service>} [opts.serviceProvider] - The service provider for additional configurations or services for the action editor.
+ * @param {ActionPositionEnum.RowInline | ActionPositionEnum.RowClick} [opts.position] - The position where the action should be displayed on the table row.
+ * @return {ActionEditorDescriptorInst<Model, Service, EditorModel, TableModel, EditorModel, TableModel>} The configured action editor descriptor instance.
+ */
+export declare function actionEditorOnTableRow<EditorModel, TableModel, Model = EditorModel, Service = undefined>(actionName: string, editor: EditorDescriptorInst<EditorModel, any>, table: TableDescriptorInst<TableModel, any, any>, opts?: {
+    model?: ModelDescriptor<Model>;
+    serviceProvider?: ActionEditorProviderType<Model, Service>;
+    position?: ActionPositionEnum.RowInline | ActionPositionEnum.RowClick;
+}): ActionEditorDescriptorInst<Model, Service, EditorModel, TableModel, EditorModel, TableModel>;
+/**
+ * Creates and returns an action editor descriptor configured with the given parameters.
+ * This is used to define an action editor positioned relative to a table.
+ *
+ * @param {string} actionName - The name of the action.
+ * @param {EditorDescriptorInst<EditorModel, any>} editor - The editor descriptor instance responsible for configuring the editor behavior.
+ * @param {Object} [opts] - Optional configurations for the action editor.
+ * @param {ModelDescriptor<Model>} [opts.model] - The model descriptor associated with the action editor.
+ * @param {ActionEditorProviderType<Model, Service>} [opts.serviceProvider] - The service provider for additional configurations or services for the action editor.
+ * @param {ActionPositionEnum.ToolbarLeft | ActionPositionEnum.ToolbarRight | ActionPositionEnum.TableHeader} [opts.position] - The position of the action on the table.
+ * @return {ActionEditorDescriptorInst<Model, Service, EditorModel, undefined, EditorModel, undefined>} The configured action editor descriptor instance.
+ */
+export declare function actionEditorOnTableTop<EditorModel, Model = EditorModel, Service = undefined>(actionName: string, editor: EditorDescriptorInst<EditorModel, any>, opts?: {
+    model?: ModelDescriptor<Model>;
+    serviceProvider?: ActionEditorProviderType<Model, Service>;
+    position?: ActionPositionEnum.ToolbarLeft | ActionPositionEnum.ToolbarRight | ActionPositionEnum.TableHeader;
+}): ActionEditorDescriptorInst<Model, Service, EditorModel, undefined, EditorModel, undefined>;

package/tableview/api/action/helpers/data-provider-executors.d.ts

@@ -1,14 +1,19 @@
 import { Injector } from '@angular/core';
 import { Observable } from 'rxjs';
-import { DataListResult, IDataProvider } from '@mediusinc/mng-commons/core';
+import { DataListResult, IDataProvider, Nullable } from '@mediusinc/mng-commons/core';
 import { IActionContext } from '../models/execution/action-context.model';
-export declare function runFnFromDataProviderOrFallback<Item, Service, Return, FallbackReturn = Return>(ctx: IActionContext<Item, Service>, fn: (ctx: IActionContext<Item, Service>) => Observable<Return> | null, fallback: Observable<FallbackReturn>): Observable<Return | FallbackReturn>;
-export declare function runFnFromDataProviderOrFail<Item, Service, Return>(ctx: IActionContext<Item, Service>, fn: (ctx: IActionContext<Item, Service>) => Observable<Return> | null): Observable<Return>;
-export declare function runGetAllFromDataProvider<Item, Service>(ctx: IActionContext<Item, Service>): Observable<DataListResult<Item>> | null;
-export declare function runFetchFromDataProvider<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item> | null;
-export declare function runCreateFromDataProvider<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item> | null;
-export declare function runUpdateFromDataProvider<Item, service>(ctx: IActionContext<Item, service>): Observable<Item> | null;
-export declare function runDeleteFromDataProvider<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item | null> | null;
+export declare function runFnFromDataProviderOrFallback<Item, ParameterItem, Service, Return, FallbackReturn = Return>(ctx: IActionContext<Item, ParameterItem, Service>, fn: (ctx: IActionContext<Item, ParameterItem, Service>) => Observable<Return> | null, fallback: Observable<FallbackReturn>): Observable<Return | FallbackReturn>;
+export declare function runFnFromDataProviderOrFail<Item, ParameterItem, Service, Return>(ctx: IActionContext<Item, ParameterItem, Service>, fn: (ctx: IActionContext<Item, ParameterItem, Service>) => Observable<Return> | null): Observable<Return>;
+export declare function runGetAllFromDataProvider<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<DataListResult<Item>> | null;
+export type RunFetchFromDataProviderOptsType = {
+    strict?: boolean;
+    reason?: RunFetchFromDataProviderReasonType;
+};
+export type RunFetchFromDataProviderReasonType = 'create' | 'update' | 'fetch';
+export declare function runFetchFromDataProvider<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, opts?: RunFetchFromDataProviderOptsType): Observable<Item> | null;
+export declare function runCreateFromDataProvider<Item, ParameterItem, Service>(ctx: IActionContext<Item, ParameterItem, Service>): Observable<Nullable<Item>> | null;
+export declare function runUpdateFromDataProvider<Item, ParameterItem, service>(ctx: IActionContext<Item, ParameterItem, service>): Observable<Nullable<Item>> | null;
+export declare function runDeleteFromDataProvider<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<Nullable<Item>> | null;
 /**
  * Gets service instance of data provider.
  *

package/tableview/api/action/models/action-confirmation.model.d.ts

@@ -0,0 +1,14 @@
+import { Confirmation } from 'primeng/api';
+import { IActionButtonDescriptor } from '@mediusinc/mng-commons/form/api';
+import { IActionContext } from './execution/action-context.model';
+export interface ActionConfirmation<Model> {
+    icon?: string | null;
+    title?: string | null;
+    message?: string | null;
+    acceptButton?: IActionButtonDescriptor;
+    rejectButton?: IActionButtonDescriptor | false;
+    closeOnEscape?: boolean;
+    closable?: boolean;
+    configMapFn?: ConfigurationConfigMapFn<Model>;
+}
+export type ConfigurationConfigMapFn<Item> = (ctx: IActionContext<any, Item, any>, confirmConfig: Confirmation) => Confirmation;

package/tableview/api/action/models/action-descriptor.types.d.ts

@@ -1,5 +1,9 @@
 import { ItemOrObservable, Nullable } from '@mediusinc/mng-commons/core';
 import { ActionContextValidation } from './execution/action-context-validation.model';
 import { IActionContext } from './execution/action-context.model';
-export type ActionRunFnType<Item, Service = undefined, ReturnItem = Item, Return = ItemOrObservable<Nullable<ReturnItem>>> = (ctx: IActionContext<Item, Service>) => Return;
-export type ActionValidationFnType<Item, Service = undefined, Return = ItemOrObservable<boolean>> = (ctx: ActionContextValidation<Item, Service>) => Return;
+export type ActionRunFnType<Item, Service = undefined, InputItem = Item, ReturnItem = Item, Return = ItemOrObservable<Nullable<ReturnItem>>> = (ctx: IActionContext<Item, InputItem, Service>) => Return;
+export type ActionValidationFnType<Item, Service = undefined, InputItem = Item, Return = ItemOrObservable<boolean>> = (ctx: ActionContextValidation<Item, InputItem, Service>) => Return;
+export type ActionNotificationType = {
+    title?: string;
+    message?: string;
+};

package/tableview/api/action/models/action-error.model.d.ts

@@ -2,7 +2,7 @@ import { HttpErrorResponse } from '@angular/common/http';
 import { ACommonsErrorBase, CommonsErrorBaseOptions, ICommonsActionError } from '@mediusinc/mng-commons/core';
 import { IActionContext } from './execution/action-context.model';
 export interface CommonsActionErrorOptions extends CommonsErrorBaseOptions {
-    actionContext?: IActionContext<any, any>;
+    actionContext?: IActionContext<any, any, any>;
     httpError?: HttpErrorResponse;
 }
 export declare class CommonsActionError extends ACommonsErrorBase implements ICommonsActionError {

package/tableview/api/action/models/execution/action-context-validation.model.d.ts

@@ -3,9 +3,9 @@ import { ActionDescriptorInst } from '../../descriptors/action.descriptor';
 /**
  * Class containing all main data for action validations (enabled/visible) to be executed in validation states.
  */
-export interface ActionContextValidation<Item, Service = undefined> {
+export interface ActionContextValidation<Item, ParametersItem, Service = undefined> {
     descriptor: ActionDescriptorInst<Item, Service>;
-    parameters: ActionParameters<Item>;
+    parameters: ActionParameters<ParametersItem>;
     serviceInstance: Service;
     dataProvider?: IDataProvider<Item, Service>;
 }

package/tableview/api/action/models/execution/action-context.model.d.ts

@@ -7,10 +7,10 @@ import { IViewContainer } from './view-container.model';
 /**
  * Class containing all main data for action to be executed in run/fetch/submit states.
  */
-export interface IActionContext<Item, Service = undefined, Instance extends IActionInstance<Item, Service> = IActionInstance<Item, Service>, ViewContainer extends IViewContainer<Item, Service, Instance> = IViewContainer<Item, Service, Instance>> {
+export interface IActionContext<Item, ParametersItem, Service = undefined, Instance extends IActionInstance<Item, Service> = IActionInstance<Item, Service>, ViewContainer extends IViewContainer<Item, Service, Instance> = IViewContainer<Item, Service, Instance>> {
     contextLongName: string;
     instance: Instance;
-    parameters: ActionParameters<Item>;
+    parameters: ActionParameters<ParametersItem>;
     functionName: 'run' | 'fetch' | 'submit';
     serviceInstance: Service;
     dataProvider?: IDataProvider<Item, Service>;

package/tableview/api/action/models/execution/action-instance.model.d.ts

@@ -8,7 +8,7 @@ import { ActionInstanceStateEnum } from './action-instance-state.model';
 export interface IActionInstance<Item, Service> {
     instanceId: string;
     instanceLongName: string;
-    action: ActionDescriptorInst<Item>;
+    action: ActionDescriptorInst<Item, any, any, any, any>;
     createdDate: Date;
     triggerParameters?: ActionParameters<Item>;
     activationParameters?: ActionParameters<Item>;

package/tableview/api/action/models/tableview-action-default-categories.model.d.ts

@@ -2,9 +2,9 @@
  * Default categories for tableview actions
  */
 export declare class TableviewActionDefaultCategories {
-    static readonly READ = "read";
-    static readonly ADD = "add";
-    static readonly EDIT = "edit";
-    static readonly DELETE = "delete";
-    static readonly DETAILS = "details";
+    static readonly READ = "_defaultTwRead";
+    static readonly ADD = "_defaultTwAdd";
+    static readonly EDIT = "_defaultTwEdit";
+    static readonly DELETE = "_defaultTwDelete";
+    static readonly DETAILS = "_defaultTwDetails";
 }

package/tableview/api/action/services/data-provider-executor.service.d.ts

@@ -1,33 +1,34 @@
 import { Injector } from '@angular/core';
 import { Observable } from 'rxjs';
 import { DataListResult, IDataProvider, Nullable } from '@mediusinc/mng-commons/core';
+import { RunFetchFromDataProviderReasonType } from '../helpers/data-provider-executors';
 import { IActionContext } from '../models/execution/action-context.model';
 export declare abstract class DataProviderExecutor {
-    runGetAllOrFail<Item, Service>(ctx: IActionContext<Item, Service>): Observable<DataListResult<Item>>;
-    abstract runGetAll<Item, Service>(ctx: IActionContext<Item, Service>): Observable<DataListResult<Item>> | null;
-    abstract runGetAll<Item, Service>(ctx: IActionContext<Item, Service>, fallback: Observable<DataListResult<Item>>): Observable<DataListResult<Item>>;
-    abstract runGetAll<Item, Service>(ctx: IActionContext<Item, Service>, fallback: undefined): Observable<DataListResult<Item>> | null;
-    abstract runGetAll<Item, Service>(ctx: IActionContext<Item, Service>, fallback?: Observable<DataListResult<Item>>): Observable<DataListResult<Item>> | null;
-    runFetchOrFail<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item>;
-    abstract runFetch<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item> | null;
-    abstract runFetch<Item, Service>(ctx: IActionContext<Item, Service>, fallback: Observable<Nullable<Item>>): Observable<Nullable<Item>>;
-    abstract runFetch<Item, Service>(ctx: IActionContext<Item, Service>, fallback: undefined): Observable<Nullable<Item>> | null;
-    abstract runFetch<Item, Service>(ctx: IActionContext<Item, Service>, fallback?: Observable<Nullable<Item>>): Observable<Nullable<Item>> | null;
-    runCreateOrFail<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item>;
-    abstract runCreate<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item> | null;
-    abstract runCreate<Item, Service>(ctx: IActionContext<Item, Service>, fallback: Observable<Nullable<Item>>): Observable<Nullable<Item>>;
-    abstract runCreate<Item, Service>(ctx: IActionContext<Item, Service>, fallback: undefined): Observable<Nullable<Item>> | null;
-    abstract runCreate<Item, Service>(ctx: IActionContext<Item, Service>, fallback?: Observable<Nullable<Item>>): Observable<Nullable<Item>> | null;
-    runUpdateOrFail<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item>;
-    abstract runUpdate<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item> | null;
-    abstract runUpdate<Item, Service>(ctx: IActionContext<Item, Service>, fallback: Observable<Nullable<Item>>): Observable<Nullable<Item>>;
-    abstract runUpdate<Item, Service>(ctx: IActionContext<Item, Service>, fallback: undefined): Observable<Nullable<Item>> | null;
-    abstract runUpdate<Item, Service>(ctx: IActionContext<Item, Service>, fallback?: Observable<Nullable<Item>>): Observable<Nullable<Item>> | null;
-    runDeleteOrFail<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Item | null>;
-    abstract runDelete<Item, Service>(ctx: IActionContext<Item, Service>): Observable<Nullable<Item>> | null;
-    abstract runDelete<Item, Service>(ctx: IActionContext<Item, Service>, fallback: Observable<Nullable<Item>>): Observable<Nullable<Item>>;
-    abstract runDelete<Item, Service>(ctx: IActionContext<Item, Service>, fallback: undefined): Observable<Nullable<Item>> | null;
-    abstract runDelete<Item, Service>(ctx: IActionContext<Item, Service>, fallback?: Observable<Nullable<Item>>): Observable<Nullable<Item>> | null;
+    runGetAllOrFail<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<DataListResult<Item>>;
+    abstract runGetAll<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<DataListResult<Item>> | null;
+    abstract runGetAll<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback: Observable<DataListResult<Item>>): Observable<DataListResult<Item>>;
+    abstract runGetAll<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback: undefined): Observable<DataListResult<Item>> | null;
+    abstract runGetAll<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback?: Observable<DataListResult<Item>>): Observable<DataListResult<Item>> | null;
+    runFetchOrFail<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fetchReason?: RunFetchFromDataProviderReasonType): Observable<Item>;
+    abstract runFetch<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fetchReason?: RunFetchFromDataProviderReasonType): Observable<Item> | null;
+    abstract runFetch<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fetchReason: RunFetchFromDataProviderReasonType | undefined, fallback: Observable<Nullable<Item>>): Observable<Nullable<Item>>;
+    abstract runFetch<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fetchReason: RunFetchFromDataProviderReasonType | undefined, fallback: undefined): Observable<Nullable<Item>> | null;
+    abstract runFetch<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fetchReason: RunFetchFromDataProviderReasonType | undefined, fallback?: Observable<Nullable<Item>>): Observable<Nullable<Item>> | null;
+    runCreateOrFail<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<Item>;
+    abstract runCreate<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<Item> | null;
+    abstract runCreate<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback: Observable<Nullable<Item>>): Observable<Nullable<Item>>;
+    abstract runCreate<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback: undefined): Observable<Nullable<Item>> | null;
+    abstract runCreate<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback?: Observable<Nullable<Item>>): Observable<Nullable<Item>> | null;
+    runUpdateOrFail<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<Item>;
+    abstract runUpdate<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<Item> | null;
+    abstract runUpdate<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback: Observable<Nullable<Item>>): Observable<Nullable<Item>>;
+    abstract runUpdate<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback: undefined): Observable<Nullable<Item>> | null;
+    abstract runUpdate<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback?: Observable<Nullable<Item>>): Observable<Nullable<Item>> | null;
+    runDeleteOrFail<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<Item | null>;
+    abstract runDelete<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>): Observable<Nullable<Item>> | null;
+    abstract runDelete<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback: Observable<Nullable<Item>>): Observable<Nullable<Item>>;
+    abstract runDelete<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback: undefined): Observable<Nullable<Item>> | null;
+    abstract runDelete<Item, ParametersItem, Service>(ctx: IActionContext<Item, ParametersItem, Service>, fallback?: Observable<Nullable<Item>>): Observable<Nullable<Item>> | null;
     /**
      * Gets service instance of data provider.
      *

package/tableview/api/class/README.md

@@ -0,0 +1,13 @@
+# @mediusinc/mng-commons/tableview/api
+
+Secondary entry point of `@mediusinc/mng-commons`. It can be used by importing from `@mediusinc/mng-commons/tableview/api/class`.
+
+## Dependencies within commons
+
+- `@mediusinc/mng-commons/core`
+- `@mediusinc/mng-commons/model`
+- `@mediusinc/mng-commons/model/class`
+- `@mediusinc/mng-commons/filter`
+- `@mediusinc/mng-commons/form/api`
+- `@mediusinc/mng-commons/table/api`
+- `@mediusinc/mng-commons/tableview/api`

package/tableview/api/{editor/helpers/class-attribute-converter.d.ts → class/editor/class-editor-attribute-converter.d.ts}

@@ -1,7 +1,7 @@
 import { ClassAttributeDef, ClassType } from '@mediusinc/mng-commons/core';
 import { ColumnDisplayTypeEnum, ColumnTypeEnum } from '@mediusinc/mng-commons/table/api';
-import { EditorClassAttributeDef } from '../models/class-tableview-attribute.model';
-import { FieldInputTypeEnum } from '../models/field.model';
+import { FieldInputTypeEnum } from '@mediusinc/mng-commons/tableview/api';
+import { EditorClassAttributeDef } from './class-editor-attribute.model';
 /**
  * converts string type to type enum, default is text
  * @param attributeType

package/tableview/api/{editor/models/class-tableview-attribute.model.d.ts → class/editor/class-editor-attribute.model.d.ts}

@@ -1,5 +1,5 @@
 import { ClassAttributeDef, ClassType, EnumType } from '@mediusinc/mng-commons/core';
-import { FieldInputTypeEnum } from '../../editor/models/field.model';
+import { FieldInputTypeEnum } from '@mediusinc/mng-commons/tableview/api';
 export interface EditorClassAttributeDef extends ClassAttributeDef {
     classType?: ClassType<any>;
     fieldType?: FieldInputTypeEnum;

package/tableview/api/class/editor/class-editor-data-provider.factory.d.ts

@@ -0,0 +1,4 @@
+import { ClassType, ServiceClassType } from '@mediusinc/mng-commons/core';
+import { EditorDataProviderInst } from '@mediusinc/mng-commons/tableview/api';
+export declare function editorDataProviderFromClass<Model>(type: ClassType<Model>): EditorDataProviderInst<Model, undefined, undefined>;
+export declare function editorDataProviderFromClass<Model, Service = any>(type: ClassType<Model>, serviceType: ServiceClassType<Service>): EditorDataProviderInst<Model, Service, ServiceClassType<Service>>;

package/tableview/api/{editor/helpers/editor-descriptor-helpers.d.ts → class/editor/class-editor-descriptor-helpers.d.ts}

@@ -1,10 +1,7 @@
 import { ILookupDataProvider } from '@mediusinc/mng-commons/core';
 import { EnumDescriptor } from '@mediusinc/mng-commons/model';
-import { EditorDescriptorInst } from '../descriptors/editor.descriptor';
-import { AFieldDescriptor } from '../descriptors/field-base.descriptor';
-import { FieldLookupDescriptor } from '../descriptors/field-lookup.descriptor';
-import { EditorClassAttributeDef } from '../models/class-tableview-attribute.model';
-import { FieldInputTypeEnum } from '../models/field.model';
+import { AFieldDescriptor, EditorDescriptorInst, FieldInputTypeEnum, FieldLookupDescriptor } from '@mediusinc/mng-commons/tableview/api';
+import { EditorClassAttributeDef } from './class-editor-attribute.model';
 /**
  * Generates field based on attribute definition, used for auto model
  * @param descriptor Editor descriptor instance.

package/tableview/api/class/editor/class-editor-descriptor.factory.d.ts

@@ -0,0 +1,11 @@
+import { ClassType } from '@mediusinc/mng-commons/core';
+import { EditorDescriptorCreateOptsType, EditorDescriptorInst } from '@mediusinc/mng-commons/tableview/api';
+import { EditorClassAttributeDef } from './class-editor-attribute.model';
+export declare function editorDescriptorFromClass<EditorModel, ParentEditorModel = undefined>(type: ClassType<EditorModel>, opts?: EditorDescriptorCreateOptsType<EditorModel, ParentEditorModel>): EditorDescriptorInst<EditorModel, ParentEditorModel>;
+/**
+ * Generates descriptor based on type attribute definition
+ * @param type class type
+ * @param attributes
+ * @param opts
+ */
+export declare function editorDescriptorFromClassAttrsDef<EditorModel, ParentEditorModel = undefined>(type: ClassType<EditorModel>, attributes?: EditorClassAttributeDef[], opts?: EditorDescriptorCreateOptsType<EditorModel, ParentEditorModel>): EditorDescriptorInst<EditorModel, ParentEditorModel>;

package/tableview/api/class/index.d.ts

@@ -0,0 +1,10 @@
+export * from './editor/class-editor-attribute.model';
+export * from './editor/class-editor-attribute-converter';
+export * from './editor/class-editor-data-provider.factory';
+export * from './editor/class-editor-descriptor.factory';
+export * from './editor/class-editor-descriptor-helpers';
+export * from './tableview/class-tableview-attribute.model';
+export * from './tableview/class-tableview-attribute-converter';
+export * from './tableview/class-tableview-descriptor.factory';
+export * from './tableview/class-tableview-descriptor-helpers';
+export * from './tableview/class-tableview-data-provider.factory';