@mediusinc/mng-commons 5.3.0-rc.2 → 5.3.0-rc.4

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

@@ -23,11 +23,15 @@ export declare class TableDescriptor extends TableDescriptorInst<any> {
      */
     static fromClassWithCustomAttrsDef<TableModel>(type: ClassType<TableModel>, attributes: TableClassAttributeDef[], idProperty?: keyof TableModel, titleProperty?: keyof TableModel): TableDescriptorInst<TableModel>;
 }
-export type TableDescriptorCreateOptsType<TableModel> = ModelDescriptorCreateOpts<TableModel>;
+export type TableDescriptorSortsFiltersCreateOptsType<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel> = {
+    filtersType?: TypeDescriptor<Filters>;
+    sortsType?: TypeDescriptor<Sorts>;
+};
+export type TableDescriptorCreateOptsType<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel> = TableDescriptorSortsFiltersCreateOptsType<TableModel, Sorts, Filters> & ModelDescriptorCreateOpts<TableModel>;
 export declare function tableDescriptor<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel>(): TableDescriptorInst<TableModel, Sorts, Filters>;
-export declare function tableDescriptor<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel>(opts: TableDescriptorCreateOptsType<TableModel>): TableDescriptorInst<TableModel, Sorts, Filters>;
-export declare function tableDescriptor<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel>(model: ModelDescriptor<TableModel>): TableDescriptorInst<TableModel, Sorts, Filters>;
-export declare function tableDescriptor<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel>(type: TypeDescriptor<TableModel>, opts?: TableDescriptorCreateOptsType<TableModel>): TableDescriptorInst<TableModel, Sorts, Filters>;
+export declare function tableDescriptor<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel>(opts: TableDescriptorCreateOptsType<TableModel, Sorts, Filters>): TableDescriptorInst<TableModel, Sorts, Filters>;
+export declare function tableDescriptor<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel>(model: ModelDescriptor<TableModel>, opts?: TableDescriptorSortsFiltersCreateOptsType<TableModel, Sorts, Filters>): TableDescriptorInst<TableModel, Sorts, Filters>;
+export declare function tableDescriptor<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel>(type: TypeDescriptor<TableModel>, opts?: TableDescriptorCreateOptsType<TableModel, Sorts, Filters>): TableDescriptorInst<TableModel, Sorts, Filters>;
 export declare function tableDescriptorFromClass<TableModel, Sorts = keyof TableModel, Filters = keyof TableModel>(type: ClassType<TableModel>, opts?: TableDescriptorCreateOptsType<TableModel>): TableDescriptorInst<TableModel, Sorts, Filters>;
 /**
  * generates descriptor based on type attribute definition

package/table/api/descriptors/table.descriptor.d.ts

@@ -1,7 +1,9 @@
+import { Type } from '@angular/core';
 import { DataListResult, EnumConstantType, ILookupDataProvider, ITableDescriptor } from '@mediusinc/mng-commons/core';
 import { FilterDescriptor, FilterDisplayTypeEnum, FilterLookupDescriptor, FilterLookupEnumDescriptor } from '@mediusinc/mng-commons/filter';
 import { EnumDescriptor, ModelDescriptor } from '@mediusinc/mng-commons/model';
 import { ColumnDisplayTypeEnum, ColumnTypeEnum } from '../models/column.model';
+import { IRowExpandableComponent } from '../models/row-expandable-component.model';
 import { IColumnsManageInterface } from '../models/table-columns.model';
 import { TableDynamicColumnsModeEnum, TablePaginationModeEnum, TableSizeEnum } from '../models/table.model';
 import { ColumnDescriptor, ColumnDynamicDescriptor } from './column.descriptor';
@@ -30,8 +32,6 @@ export declare class TableDescriptorInst<TableModel, Sorts = keyof TableModel, F
     private _headerClassName?;
     private _rowClassName?;
     private _rowClassNameMapFn?;
-    private _tableFullHeightOffset?;
-    private _rowHeight?;
     private _filters;
     private _sorts;
     private _isLocalized;
@@ -39,6 +39,7 @@ export declare class TableDescriptorInst<TableModel, Sorts = keyof TableModel, F
     private _rowExpandable;
     private _rowExpandableColSpan;
     private _rowExpandableProperty?;
+    private _rowExpandableComponentType?;
     private _rowReorderable;
     constructor(model: ModelDescriptor<TableModel>, autoGenerated?: boolean);
     get identifier(): string | undefined;
@@ -56,8 +57,6 @@ export declare class TableDescriptorInst<TableModel, Sorts = keyof TableModel, F
     get model(): ModelDescriptor<TableModel, import("@mediusinc/mng-commons/core").ClassOptType<TableModel>>;
     get className(): string;
     get size(): TableSizeEnum;
-    get tableFullHeightOffset(): number | undefined;
-    get rowHeight(): number | undefined;
     get hasHover(): boolean;
     get hasGridlines(): boolean;
     get hasResizableColumns(): boolean;
@@ -77,92 +76,494 @@ export declare class TableDescriptorInst<TableModel, Sorts = keyof TableModel, F
      */
     get rowExpandableProperty(): string | undefined;
     /**
-     * Track property is used for the purpose of combined saving user preferences in localstorage if 2 tables have the same track properties they will share the same localstorage entry.
+     * This property is used to define the type of the custom component that will be used to render the expanded row.
+     */
+    get rowExpandableComponentType(): Type<IRowExpandableComponent<TableModel>> | undefined;
+    /**
+     * Identifier is used for the purpose of combined saving user preferences in localstorage if 2 tables have the same track properties they will share the same localstorage entry.
      * Similarly, this property can also be used to differentiate two tables of the same model on the same url (so that they have separate entries in localstorage).
      * @param identifier
      */
     withIdentifier(identifier: string): this;
+    /**
+     * Sets the track property (identifier of table row) for the table.
+     *
+     * @param {keyof TableModel} property - The property to track the row items by.
+     */
     withTrackProperty(property?: keyof TableModel): this;
+    /**
+     * Sets the track property (identifier of table row) for the table.
+     *
+     * This function is UNSAFE!
+     *
+     * @param {string} property - The property to set '_trackProperty' to.
+     */
     withTrackPropertyUnsafe(property?: string): this;
-    getColumn(property: keyof TableModel): ColumnDescriptor<any, TableModel, any> | null;
-    getColumnUnsafe(property: string): ColumnDescriptor<any, TableModel, any> | null;
+    /**
+     * Retrieves the column descriptor for the given property.
+     *
+     * @param {keyof TableModel} property - The property for column descriptor.
+     *
+     * @return The column descriptor.
+     */
+    getColumn<Property extends keyof TableModel, ColumnModel = NonNullable<TableModel[Property]>, ColumnValue = TableModel[Property]>(property: Property): ColumnDescriptor<ColumnModel, TableModel, ColumnValue> | null;
+    /**
+     * Retrieves the column descriptor for the given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param {keyof TableModel} property - The property for column descriptor.
+     *
+     * @return The column descriptor.
+     */
+    getColumnUnsafe<ColumnModel = any, ColumnValue = ColumnModel>(property: string): ColumnDescriptor<ColumnModel, TableModel, ColumnValue> | null;
+    /**
+     * Removes the column descriptor for the given property.
+     *
+     * @param {keyof TableModel} property - The property for column descriptor.
+     */
     removeColumn(property: keyof TableModel): void;
+    /**
+     * Removes the column descriptor for the given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param {keyof TableModel} property - The property for column descriptor.
+     */
     removeColumnUnsafe(property: string): void;
+    /**
+     * Adds column descriptor to table columns.
+     *
+     * @param {ColumnDescriptor<ColumnModel, TableModel, ColumnValue>} column - The property for column descriptor.
+     */
     withColumn<ColumnModel, ColumnValue = ColumnModel>(column: ColumnDescriptor<ColumnModel, TableModel, ColumnValue>): this;
+    /**
+     * Adds a column to the table.
+     *
+     * @param {PropertyKey} property - The property key of the column in the table model.
+     *
+     * @returns The newly added column descriptor.
+     */
     addColumn<PropertyKey extends keyof TableModel>(property: PropertyKey): ColumnDescriptor<NonNullable<TableModel[PropertyKey]>, TableModel, TableModel[PropertyKey]>;
+    /**
+     * Adds a column with enum display to the table.
+     *
+     * @param {PropertyKey} property - The property key of the table model.
+     * @param {EnumDescriptor<Enum>} enumDesc - The enum descriptor for column display.
+     * @return {ColumnDescriptor<Enum, TableModel, TableModel[PropertyKey]>} - The added column descriptor.
+     */
     addColumnEnum<PropertyKey extends keyof TableModel, Enum extends NonNullable<TableModel[PropertyKey]>>(property: PropertyKey, enumDesc: EnumDescriptor<Enum>): ColumnDescriptor<Enum, TableModel, TableModel[PropertyKey]>;
+    /**
+     * Adds a column to the table.
+     *
+     * This function is UNSAFE!
+     *
+     * @param {string} property - The property key of the column in the table model.
+     *
+     * @returns The newly added column descriptor.
+     */
     addColumnUnsafe<ColumnModel = unknown>(property: string): ColumnDescriptor<ColumnModel, TableModel>;
+    /**
+     * Adds one or more columns to the table model.
+     *
+     * @param properties - An array of property names to add as columns.
+     */
     withColumns(...properties: (keyof TableModel)[]): this;
-    withColumnDescriptors(...descriptors: ColumnDescriptor<any, TableModel>[]): this;
+    /**
+     * Set the pagination mode for the table.
+     *
+     * @param {TablePaginationModeEnum} paginationMode - The pagination mode to set. Must be one of the values from the TablePaginationModeEnum.
+     */
     withPaginationMode(paginationMode: TablePaginationModeEnum): this;
+    /**
+     * Sets the number of rows per page for a paginated display.
+     *
+     * @param {number} rows - The default number of rows to display per page.
+     * @param {Array<number>} [options] - Rows per page options to be available in table paginator.
+     */
     withRowsPerPage(rows: number, options?: Array<number>): this;
-    withTitle(title: string | undefined): this;
+    /**
+     * Sets the title for an instance of the class.
+     *
+     * @param {string} [title] - The title value to be set. It undefiend, no title will be displayed.
+     */
+    withTitle(title?: string): this;
+    /**
+     * Shows/hides the header row with column titles.
+     *
+     * @param {boolean} hideHeader - A boolean value indicating whether to hide the header.
+     */
     withHideHeader(hideHeader?: boolean): this;
-    withLoading(text?: string, icon?: string | null): this;
     /**
-     * Helper method that enables/disables reorderable property on all columns currently in the descriptor.
-     * @param columnsReorderable
+     * Adjusts loading display with custom text and/or icon.
+     *
+     * @param {string} [text] - Text to be displayed when loading indicator is shown.
+     * @param {string | null} [icon] - Icon to be used when loading indicator is shown.
      */
-    withCurrentColumnsReorderable(columnsReorderable?: boolean): this;
+    withLoading(text?: string, icon?: string | null): this;
     /**
-     * Helper method that enables/disables toggleable property on all columns currently in the descriptor.
-     * @param columnsToggleable
+     * Retrieves the sort descriptor for a given property.
+     *
+     * @param {Sorts} property - The property to retrieve the sort for.
+     *
+     * @return {SortDescriptor<TableModel> | null} The sort descriptor or null.
      */
-    withCurrentColumnsToggleable(columnsToggleable?: boolean): this;
     getSort(property: Sorts): SortDescriptor<TableModel> | null;
+    /**
+     * Retrieves the sort descriptor for a given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param {Sorts} property - The property to retrieve the sort for.
+     *
+     * @return {SortDescriptor<TableModel> | null} The sort descriptor or null.
+     */
     getSortUnsafe(property: string): SortDescriptor<TableModel> | null;
+    /**
+     * Removes the sort for a given property.
+     *
+     * @param {Sorts} property - The property to remove the sort for.
+     */
     removeSort(property: Sorts): void;
+    /**
+     * Removes the sort for a given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param {Sorts} property - The property to remove the sort for.
+     */
     removeSortUnsafe(property: string): void;
+    /**
+     * Adds sort for the given property.
+     *
+     * @param property Property to add the sort for.
+     * @param isDefault If default sorting is enabled.
+     * @param ascending If default sort should be ascending.
+     *
+     * @return Created sort descriptor.
+     */
     addSort(property: Sorts, isDefault?: boolean, ascending?: boolean): SortDescriptor<TableModel>;
+    /**
+     * Adds sort for the given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property Property to add the sort for.
+     * @param isDefault If default sorting is enabled.
+     * @param ascending If default sort should be ascending.
+
+     * @return Created sort descriptor.
+     */
     addSortUnsafe(property: string, isDefault?: boolean, ascending?: boolean): SortDescriptor<TableModel>;
+    /**
+     * Adds sort for the given property.
+     *
+     * @param property Property to add the sort for.
+     * @param isDefault If default sorting is enabled.
+     * @param ascending If default sort should be ascending.
+     */
     withSort(property: Sorts, isDefault?: boolean, ascending?: boolean): this;
+    /**
+     * Adds sort for the given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property Property to add the sort for.
+     * @param isDefault If default sorting is enabled.
+     * @param ascending If default sort should be ascending.
+     */
     withSortUnsafe(property: string, isDefault?: boolean, ascending?: boolean): this;
+    /**
+     * Sets the default sorting for the property.
+     *
+     * @param property - The property to set default sort for.
+     * @param ascending - If the sorting should be ascending (default: true).
+     * @param order - The order for this default sort (default: 0).
+     * @param enabled - Enables/disabled the default sort.
+     */
     withDefaultSort(property: Sorts, ascending?: boolean, order?: number, enabled?: boolean): this;
+    /**
+     * Sets the default sorting for the property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property - The property to set default sort for.
+     * @param ascending - If the sorting should be ascending (default: true).
+     * @param order - The order for this default sort (default: 0).
+     * @param enabled - Enables/disabled the default sort.
+     */
     withDefaultSortUnsafe(property: string, ascending?: boolean, order?: number, enabled?: boolean): this;
+    /**
+     * Add sorts for more properties.
+     *
+     * @param properties Properties to add the sorts for.
+     */
     withSorts(...properties: Sorts[]): this;
+    /**
+     * Add sorts for more properties.
+     *
+     * This function is UNSAFE!
+     *
+     * @param properties Properties to add the sorts for.
+     */
     withSortsUnsafe(...properties: string[]): this;
-    getFilter(property: Filters): FilterDescriptor<any, TableModel> | null;
-    getFilterUnsafe(property: string): FilterDescriptor<any, TableModel> | null;
+    /**
+     * Gets filter descriptor for given property.
+     *
+     * @param property Filter property
+     *
+     * @return Filter descriptor for property or null if not exists.
+     */
+    getFilter<FilterModel = Filters extends keyof TableModel ? NonNullable<TableModel[Filters]> : any>(property: Filters): FilterDescriptor<FilterModel, TableModel> | null;
+    /**
+     * Gets filter descriptor for given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property Filter property
+     *
+     * @return Filter descriptor for property or null if not exists.
+     */
+    getFilterUnsafe<FilterModel = any>(property: string): FilterDescriptor<FilterModel, TableModel> | null;
+    /**
+     * Removes filter descriptor for given property.
+     *
+     * @param property Filter property
+     */
     removeFilter(property: Filters): void;
+    /**
+     * Removes filter descriptor for given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property Filter property
+     */
     removeFilterUnsafe(property: string): void;
+    /**
+     * Creates filter descriptor for the given property.
+     *
+     * @param property Filter property.
+     *
+     * @return Created filter descriptor.
+     */
     addFilter<FilterModel = Filters extends keyof TableModel ? TableModel[Filters] : never>(property: Filters): FilterDescriptor<FilterModel, TableModel>;
+    /**
+     * Creates filter descriptor for the given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property Filter property.
+     *
+     * @return Created filter descriptor.
+     */
     addFilterUnsafe<FilterModel>(property: string): FilterDescriptor<FilterModel, TableModel>;
+    /**
+     * Creates filter lookup descriptor for the given property.
+     *
+     * @param property Filter property.
+     * @param provider Lookup provider.
+     * @param optionsValueProperty Property on lookup provider's item (FilterModel) that will be used as filter value.
+     *
+     * @return Created filter lookup descriptor.
+     */
     addFilterLookup<FilterModel = Filters extends keyof TableModel ? NonNullable<TableModel[Filters]> : never, Service = undefined>(property: Filters, provider?: ILookupDataProvider<FilterModel, Service>, optionsValueProperty?: keyof FilterModel): FilterLookupDescriptor<FilterModel, TableModel, Service>;
+    /**
+     * Creates filter lookup descriptor for the given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property Filter property.
+     * @param provider Lookup provider.
+     * @param optionsValueProperty Property on lookup provider's item (FilterModel) that will be used as filter value.
+     *
+     * @return Created filter lookup descriptor.
+     */
     addFilterLookupUnsafe<FilterModel, Service = undefined>(property: string, provider?: ILookupDataProvider<FilterModel, Service>, optionsValueProperty?: string): FilterLookupDescriptor<FilterModel, TableModel, Service>;
+    /**
+     * Creates filter lookup enum descriptor for the given property.
+     *
+     * @param property Filter property.
+     * @param enumDesc Descriptor for enum.
+     * @param options Optional options of enum values to be available to filter by.
+     *
+     * @return Created filter lookup enum descriptor.
+     */
     addFilterLookupEnum<Enum>(property: Filters, enumDesc: EnumDescriptor<Enum>, options?: Array<Enum>): FilterLookupEnumDescriptor<Enum, unknown>;
+    /**
+     * Creates filter lookup enum descriptor for the given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property Filter property.
+     * @param enumDesc Descriptor for enum.
+     * @param options Optional options of enum values to be available to filter by.
+     *
+     * @return Created filter lookup enum descriptor.
+     */
     addFilterLookupEnumUnsafe<Enum = EnumConstantType>(property: string, enumDesc: EnumDescriptor<Enum>, options?: Array<Enum>): FilterLookupEnumDescriptor<Enum, unknown>;
-    addFilterFromColumn(property: Extract<Filters, keyof TableModel>, displayType?: FilterDisplayTypeEnum, forceSimple?: boolean): FilterDescriptor<any, TableModel>;
+    /**
+     * Creates filter descriptor from column. The column must exist on table descriptor.
+     *
+     * @param property Column property to add filter for.
+     * @param displayType Optional display type setting.
+     * @param forceSimple Forces simple creation of filter (no lookup or lookup enum filters).
+     *
+     * @throws {CommonsInternalError} If column for property doesn't exist.
+     *
+     * @return Created filter descriptor
+     */
+    addFilterFromColumn<Property extends keyof TableModel, FilterModel = NonNullable<TableModel[Property]>>(property: Extract<Filters, Property>, displayType?: FilterDisplayTypeEnum, forceSimple?: boolean): FilterDescriptor<FilterModel, TableModel>;
+    /**
+     * Creates filter descriptors from columns. The columns must exist on table descriptor.
+     *
+     * @param properties Column properties to add filters for.
+     *
+     * @throws {CommonsInternalError} If column for property doesn't exist.
+     */
     withFiltersFromColumns(...properties: Extract<Filters, keyof TableModel>[]): this;
+    /**
+     * Creates filter descriptors from columns. The columns must exist on table descriptor.
+     *
+     * This function is UNSAFE!
+     *
+     * @param properties Column properties to add filters for.
+     *
+     * @throws {CommonsInternalError} If column for property doesn't exist.
+     */
     withFiltersFromColumnsUnsafe(...properties: string[]): this;
-    addFilterFromColumnUnsafe(property: string, displayType?: FilterDisplayTypeEnum, forceSimple?: boolean): FilterDescriptor<any, TableModel>;
-    addFilterFromColumnDescriptorUnsafe<ColumnModel, ColumnValue>(column: ColumnDescriptor<ColumnModel, TableModel, ColumnValue>, forceSimple?: boolean): FilterDescriptor<any, TableModel>;
+    /**
+     * Creates filter descriptor from column. The column must exist on table descriptor.
+     *
+     * This function is UNSAFE!
+     *
+     * @param property Column property to add filter for.
+     * @param displayType Optional display type setting.
+     * @param forceSimple Forces simple creation of filter (no lookup or lookup enum filters).
+     *
+     * @throws {CommonsInternalError} If column for property doesn't exist.
+     *
+     * @return Created filter descriptor
+     */
+    addFilterFromColumnUnsafe<FilterModel = any>(property: string, displayType?: FilterDisplayTypeEnum, forceSimple?: boolean): FilterDescriptor<FilterModel, TableModel>;
+    /**
+     * Creates filter descriptor from provided column descriptor.
+     *
+     * This function is UNSAFE!
+     *
+     * @param column Column descriptor.
+     * @param forceSimple Forces simple creation of filter (no lookup or lookup enum filters).
+     *
+     * @throws {CommonsInternalError} If column for property doesn't exist.
+     *
+     * @return Created filter descriptor
+     */
+    addFilterFromColumnDescriptorUnsafe<FilterModel>(column: ColumnDescriptor<FilterModel, TableModel, any>, forceSimple?: boolean): FilterDescriptor<FilterModel, TableModel>;
+    /**
+     * Adds filter descriptor for the given property.
+     *
+     * @param property Filter property.
+     * @param filter Descriptor for property.
+     */
     withFilter<FilterModel>(property: Filters, filter: FilterDescriptor<FilterModel, TableModel>): this;
+    /**
+     * Adds filter descriptor for the given property.
+     *
+     * This function is UNSAFE!
+     *
+     * @param filter Descriptor for property.
+     */
     withFilterUnsafe<FilterModel>(filter: FilterDescriptor<FilterModel, TableModel>): this;
+    /**
+     * Sets classes for table component.
+     *
+     * @param className Class names.
+     */
     withClassName(className: string): this;
+    /**
+     * Sets table sizing.
+     *
+     * @param size Table size.
+     */
     withSize(size?: TableSizeEnum): this;
-    withTableFullHeightOffset(tableFullHeightOffset: number): this;
-    withRowHeight(rowHeight: number): this;
-    withHover(hover: boolean): this;
-    withGridlines(gridlines: boolean): this;
     /**
-     * Method that enables/disabled column resize feature with columnResizeMode on all columns.
+     * Enables hover effect on table rows.
+     *
+     * @param hover Enables/disables the hover.
+     */
+    withHover(hover?: boolean): this;
+    /**
+     * Enables gridlines on table.
+     *
+     * @param gridlines Enables/disables the gridlines.
+     */
+    withGridlines(gridlines?: boolean): this;
+    /**
+     * Enables/disables reorderable property on all columns currently in the descriptor.
+     *
+     * @param {boolean} [columnsReorderable] - Boolean flag to set reordering on columns to.
+     */
+    withCurrentColumnsReorderable(columnsReorderable?: boolean): this;
+    /**
+     * Enables/disables toggleable property on all columns currently in the descriptor.
+     *
+     * @param {boolean} [columnsToggleable] - Boolean flag to set toggleable on columns to.
+     */
+    withCurrentColumnsToggleable(columnsToggleable?: boolean): this;
+    /**
+     * Enables/disabled column resize feature with columnResizeMode on all columns.
+     *
      * @param resizableColumns True if enabled
      * @param columnResizeMode 'fit' or 'expand' mode
      */
     withColumnsResizable(resizableColumns?: boolean, columnResizeMode?: 'fit' | 'expand'): this;
     /**
      * Sets column to (un)frozen.
+     *
      * @param selectionColumnFrozen True to freeze selection column, false to unfreeze it.
      * @param actionColumnFrozen True to freeze action column, false to unfreeze it.
      */
     withColumnFrozen(selectionColumnFrozen?: boolean, actionColumnFrozen?: boolean): this;
+    /**
+     * Sets the class name for rows in the table.
+     *
+     * @param {string} rowClassName - The CSS class name to be applied to each row.
+     * @param {function} [classNameMapFn] - Optional function to map the class name dynamically based on row's item and current class name.
+     */
     withRowClassName(rowClassName?: string, classNameMapFn?: (className?: string, item?: TableModel) => string): this;
+    /**
+     * Sets header row class name.
+     *
+     * @param headerClassName Class name.
+     */
     withHeaderClassName(headerClassName: string): this;
+    /**
+     * Enables localization of the table.
+     */
     withLocalized(): this;
-    withLocalizationLocaleProperty(localizationLocaleProperty: string): this;
-    withRowExpandable(property?: keyof TableModel, colSpan?: number): this;
+    /**
+     * Sets locale property for localization.
+     *
+     * @param property Locale property
+     */
+    withLocalizationLocaleProperty(property: string): this;
+    /**
+     * Enables row expanding.
+     *
+     * @param property Property to check if row can be expanded.
+     * @param colSpan set custom row span for expanded row.
+     * @param componentType Component to be displayed on row expand.
+     */
+    withRowExpandable(property?: keyof TableModel, colSpan?: number, componentType?: Type<IRowExpandableComponent<TableModel>>): this;
+    /**
+     * Enables row reordering.
+     *
+     * @param reordable Enables/disables feature.
+     */
     withRowReorderable(reordable?: boolean): this;
     protected copyFieldsTo(obj: TableDescriptorInst<any, any, any>): void;
+    /**
+     * Copies current descriptor to a new instance.
+     */
     copy(): TableDescriptorInst<TableModel, Sorts, Filters>;
 }
 export declare class TableDynamicDescriptorInst extends TableDescriptorInst<any> {

package/table/api/helpers/table-data-provider-descriptor-convert.d.ts

@@ -0,0 +1,20 @@
+import { ServiceClassType } from '@mediusinc/mng-commons/core';
+import { TableDataProviderInst } from '../data-providers/table.data-provider';
+import { TableDescriptorInst } from '../descriptors/table.descriptor';
+/**
+ * Creates a data provider for from descriptor. DO NOT use if the model is class, because the type (from model descriptor) will not be set in data provider.
+ *
+ * @param {TableDescriptorInst<Model, Sorts, Filters>} descriptor - The table descriptor.
+ *
+ * @return {TableDataProviderInst<Model, undefined, Sorts, Filters, undefined, undefined>} - The data provider for the table component.
+ */
+export declare function tableToDataProvider<Model, Sorts = keyof Model, Filters extends keyof any = keyof Model>(descriptor: TableDescriptorInst<Model, Sorts, Filters>): TableDataProviderInst<Model, undefined, Sorts, Filters, undefined, undefined>;
+/**
+ * Creates a data provider for from descriptor. DO NOT use if the model is class, because the type (from model descriptor) will not be set in data provider.
+ *
+ * @param {TableDescriptorInst<Model, Sorts, Filters>} descriptor - The table descriptor.
+ * @param {ServiceClassType<Service>} serviceClass - The service class type.
+ *
+ * @return {TableDataProviderInst<Model, Service, Sorts, Filters, undefined, ServiceClassType<Service>>} - The data provider for the table component.
+ */
+export declare function tableToDataProvider<Model, Service = any, Sorts = keyof Model, Filters extends keyof any = keyof Model>(descriptor: TableDescriptorInst<Model, Sorts, Filters>, serviceClass: ServiceClassType<Service>): TableDataProviderInst<Model, Service, Sorts, Filters, undefined, ServiceClassType<Service>>;

package/table/api/index.d.ts

@@ -5,6 +5,7 @@ export * from './descriptors/sort.descriptor';
 export * from './descriptors/table.descriptor';
 export * from './descriptors/table-descriptor.factory';
 export * from './helpers/class-attribute-converter';
+export * from './helpers/table-data-provider-descriptor-convert';
 export * from './helpers/table-descriptor-helpers';
 export * from './models/class-table-attribute.model';
 export * from './models/column.model';
@@ -12,3 +13,4 @@ export * from './models/column-value.model';
 export * from './models/table.model';
 export * from './models/table-columns.model';
 export * from './models/table-event.model';
+export * from './models/row-expandable-component.model';

package/table/api/models/row-expandable-component.model.d.ts

@@ -0,0 +1,4 @@
+import { InputSignal } from '@angular/core';
+export interface IRowExpandableComponent<Item = unknown> {
+    item: InputSignal<Item>;
+}

package/table/api/models/table-columns.model.d.ts

@@ -4,8 +4,8 @@ import { EnumDescriptor } from '@mediusinc/mng-commons/model';
 import { ColumnDescriptor } from '../descriptors/column.descriptor';
 import { SortDescriptor } from '../descriptors/sort.descriptor';
 export interface IColumnsManageInterface<TableModel, Sorts, Filters> {
-    getColumn(property: keyof TableModel): ColumnDescriptor<any, TableModel> | null;
-    getColumnUnsafe(property: string): ColumnDescriptor<any, TableModel> | null;
+    getColumn<Property extends keyof TableModel, ColumnModel = NonNullable<TableModel[Property]>, ColumnValue = TableModel[Property]>(property: Property): ColumnDescriptor<ColumnModel, TableModel, ColumnValue> | null;
+    getColumnUnsafe<ColumnModel = any, ColumnValue = ColumnModel>(property: string): ColumnDescriptor<ColumnModel, TableModel, ColumnValue> | null;
     removeColumn(property: keyof TableModel): void;
     removeColumnUnsafe(property: string): void;
     withColumn<ColumnModel, ColumnValue = ColumnModel>(column: ColumnDescriptor<ColumnModel, TableModel, ColumnValue>): this;
@@ -23,8 +23,8 @@ export interface IColumnsManageInterface<TableModel, Sorts, Filters> {
     withSortUnsafe(property: string, isDefault: boolean, ascending?: boolean): this;
     withSorts(...properties: Sorts[]): this;
     withSortsUnsafe(...properties: string[]): this;
-    getFilter(property: Filters): FilterDescriptor<any, TableModel> | null;
-    getFilterUnsafe(property: string): FilterDescriptor<any, TableModel> | null;
+    getFilter<FilterModel = Filters extends keyof TableModel ? NonNullable<TableModel[Filters]> : any>(property: Filters): FilterDescriptor<FilterModel, TableModel> | null;
+    getFilterUnsafe<FilterModel = any>(property: string): FilterDescriptor<FilterModel, TableModel> | null;
     removeFilter(property: Filters): void;
     removeFilterUnsafe(property: string): void;
     addFilter<FilterModel = Filters extends keyof TableModel ? TableModel[Filters] : never>(property: Filters): FilterDescriptor<FilterModel, TableModel>;
@@ -33,8 +33,8 @@ export interface IColumnsManageInterface<TableModel, Sorts, Filters> {
     addFilterLookupUnsafe<FilterModel, Service = undefined>(property: string, provider?: ILookupDataProvider<FilterModel, Service>, optionsValueProperty?: string): FilterLookupDescriptor<FilterModel, TableModel, Service>;
     addFilterLookupEnum<Enum>(property: Filters, enumDesc: EnumDescriptor<any>, options?: Array<Enum>): FilterLookupEnumDescriptor<Enum, TableModel>;
     addFilterLookupEnumUnsafe<Enum = EnumConstantType>(property: string, enumDesc: EnumDescriptor<Enum>, options?: Array<Enum>): FilterLookupEnumDescriptor<Enum, TableModel>;
-    addFilterFromColumn(property: Extract<Filters, keyof TableModel>, displayType?: FilterDisplayTypeEnum, forceSimple?: boolean): FilterDescriptor<any, TableModel>;
-    addFilterFromColumnUnsafe(property: string, displayType?: FilterDisplayTypeEnum, forceSimple?: boolean): FilterDescriptor<any, TableModel>;
+    addFilterFromColumn<Property extends keyof TableModel, FilterModel = NonNullable<TableModel[Property]>>(property: Extract<Filters, Property>, displayType?: FilterDisplayTypeEnum, forceSimple?: boolean): FilterDescriptor<FilterModel, TableModel>;
+    addFilterFromColumnUnsafe<FilterModel = any>(property: string, displayType?: FilterDisplayTypeEnum, forceSimple?: boolean): FilterDescriptor<FilterModel, TableModel>;
     withFiltersFromColumns(...properties: Extract<Filters, keyof TableModel>[]): this;
     withFiltersFromColumnsUnsafe(...properties: string[]): this;
     withFilter<FilterModel>(property: Filters, filter: FilterDescriptor<FilterModel, TableModel>): this;

package/table/components/column-filter/column-filter.component.d.ts

@@ -22,7 +22,7 @@ export declare class TableColumnFilterComponent implements OnDestroy {
     private readonly destroyRef;
     private readonly document;
     descriptor: import("@angular/core").InputSignal<FilterDescriptor<any, any>>;
-    descriptorAsLookup: import("@angular/core").Signal<FilterLookupDescriptor<any, any, any> | undefined>;
+    descriptorAsLookup: import("@angular/core").Signal<FilterLookupDescriptor<any, any, any, string | number | symbol, string | number | symbol> | undefined>;
     private icon;
     private translationObserver;
     matchModes: import("@angular/core").Signal<import("primeng/api").SelectItem<any>[]>;