@3kles/kles-material-table-v2 21.2.0 → 21.4.0

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@3kles/kles-material-table-v2",
-  "version": "21.2.0",
+  "version": "21.4.0",
   "keywords": [
     "3KLES"
   ],
   "author": "3Kles Lab",
   "license": "ISC",
   "peerDependencies": {
-    "@3kles/kles-material-dynamicforms": "^21.0.1",
+    "@3kles/kles-material-dynamicforms": "^21.3.0",
     "@angular/animations": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/common": "^21.0.0",
@@ -16,7 +16,7 @@
     "@angular/material": "^21.0.0",
     "@angular/platform-browser": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "rxjs": "^7.8.0"
+    "rxjs": "^6.5.3 || ^7.4.0"
   },
   "dependencies": {
     "tslib": "^2.0.0"

package/types/3kles-kles-material-table-v2.d.ts

@@ -7,7 +7,7 @@ import * as i4 from '@3kles/kles-material-dynamicforms';
 import { IKlesFieldConfig, GroupUiState, ArrayUiState, AbstractUiState } from '@3kles/kles-material-dynamicforms';
 import { SortHeaderArrowPosition, SortDirection, Sort, MatSort } from '@angular/material/sort';
 import * as rxjs from 'rxjs';
-import { Observable } from 'rxjs';
+import { Observable, Subject } from 'rxjs';
 import { PageEvent, MatPaginatorIntl, MatPaginatorSelectConfig, MatPaginator } from '@angular/material/paginator';
 import { CdkDrag, CdkDragDrop } from '@angular/cdk/drag-drop';
 import { DataSource } from '@angular/cdk/table';
@@ -40,7 +40,7 @@ interface IKlesHeaderFieldConfig {
 interface IKlesCellFieldConfig {
     executeAfterChange?: (property?: string, row?: any, group?: FormGroup<any> | FormArray<any>) => Observable<any>;
     style?: IStyle;
-    field: C;
+    field?: C;
 }
 interface IKlesFooterFieldConfig {
     style?: IStyle;
@@ -74,8 +74,8 @@ interface KlesColumnConfig {
     sortable?: boolean;
     sortArrowPosition?: SortHeaderArrowPosition;
     resizable?: boolean;
-    headerCell: IKlesHeaderFieldConfig;
-    cell: IKlesCellFieldConfig;
+    headerCell?: IKlesHeaderFieldConfig;
+    cell?: IKlesCellFieldConfig;
     footerCell?: IKlesFooterFieldConfig;
     align?: AlignCell;
     width?: string;
@@ -131,7 +131,7 @@ interface ScrollbarApi {
     toBottom(sb?: ScrollBehavior): void;
     toRight(sb?: ScrollBehavior): void;
     to(top: number, left: number, sb?: ScrollBehavior): void;
-    getTop(): number;
+    getTop(): number | undefined;
 }
 
 declare enum KlesSelectionModelState {
@@ -348,7 +348,20 @@ type Brand<K extends string> = {
 type SelectionConfig<T> = SelectionConfigDef<T> & Brand<'SelectionConfig'>;
 declare const selectionConfig: <T>(l: SelectionConfigDef<T>) => SelectionConfig<T>;
 
+declare class KlesTableIntl {
+    readonly changes: Subject<void>;
+    emptyStateTitle: string;
+    emptyStateDescription: string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<KlesTableIntl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<KlesTableIntl>;
+}
+
 type TableElevationLevel = 0 | 1 | 2 | 3 | 4 | 5;
+interface EmptyStateConfig {
+    enabled?: boolean;
+    component?: Type<unknown>;
+    intl?: Type<KlesTableIntl>;
+}
 interface DefaultTableConfig {
     id?: string;
     columns: KlesColumnConfig[];
@@ -358,6 +371,7 @@ interface DefaultTableConfig {
     sortConfig?: Sort;
     columnSeparator?: boolean | ColumnSeparatorConfig;
     elevation?: TableElevationLevel;
+    emptyState?: boolean | EmptyStateConfig;
 }
 interface PaginatorConfig {
     paginator?: boolean;
@@ -455,8 +469,12 @@ declare class DragDropService extends DragDropBase {
 declare class ScrollbarService {
     private element;
     private default;
+    private readonly hiddenClass;
     register(el: HTMLElement): void;
     unregister(): void;
+    setScrollbarVisible(visible: boolean): void;
+    hideScrollbar(): void;
+    showScrollbar(): void;
     toTop(sb?: ScrollBehavior): void;
     toBottom(sb?: ScrollBehavior): void;
     toLeft(sb?: ScrollBehavior): void;
@@ -789,32 +807,51 @@ declare class KlesDataSource extends MatTableDataSource<FormGroup, MatPaginator>
     constructor();
 }
 
+interface KlesRowContext<TSource = unknown> {
+    source: TSource;
+    _id: string | number;
+    meta: {
+        depth: number;
+        parentId: string | null;
+    };
+}
+
+interface KlesCreatedRow<TSource = unknown> {
+    formGroup: FormGroup;
+    groupUi: GroupUiState;
+    context: KlesRowContext<TSource>;
+}
 declare class RowFormFactory {
     createControl(field: IKlesFieldConfig, value?: any): {
         control: AbstractControl;
         ui: AbstractUiState;
     };
-    createRow(fields: IKlesFieldConfig[], record: any, meta?: {
+    createRow<TSource extends Record<string, any>>(fields: IKlesFieldConfig[], record: TSource, meta?: {
         depth: number;
         parentId: string | null;
-    }): {
-        formGroup: FormGroup;
-        groupUi: GroupUiState;
-    };
-    createRows(fields: IKlesFieldConfig[], records: any[], meta?: {
+    }): KlesCreatedRow<TSource>;
+    createRows<TSource extends Record<string, any>>(fields: IKlesFieldConfig[], records: TSource[], meta?: {
         depth: number;
         parentId: string | null;
-    }): {
-        formGroup: FormGroup;
-        groupUi: GroupUiState;
-    }[];
+    }): KlesCreatedRow<TSource>[];
     static ɵfac: i0.ɵɵFactoryDeclaration<RowFormFactory, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<RowFormFactory>;
 }
 
+declare class RowContextStore {
+    private readonly contexts;
+    set<TSource>(row: AbstractControl, context: KlesRowContext<TSource>): void;
+    get<TSource = unknown>(row: AbstractControl): Signal<KlesRowContext<TSource> | null> | null;
+    updateSource<TSource>(row: AbstractControl, source: TSource): void;
+    delete(row: AbstractControl): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RowContextStore, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<RowContextStore>;
+}
+
 declare class KlesForm {
     private columnsService;
     private rowFactory;
+    private rowContextStore;
     readonly form: FormGroup<{
         header: FormGroup<{}>;
         rows: FormArray<FormGroup<any>>;
@@ -828,31 +865,22 @@ declare class KlesForm {
     readonly uiStore: WeakMap<AbstractControl<any, any, any>, AbstractUiState<any, any>>;
     private readonly rowsStructureChangedSubject;
     readonly rowsStructureChanged$: rxjs.Observable<void>;
-    constructor(columnsService: ColumnsService, rowFactory: RowFormFactory);
+    constructor(columnsService: ColumnsService, rowFactory: RowFormFactory, rowContextStore: RowContextStore);
     getRows(): FormArray<FormGroup>;
     getUiRows(): ArrayUiState;
     getUiHeader(): GroupUiState;
     getUiFooter(): GroupUiState;
     getHeader(): FormGroup;
     getFooter(): FormGroup;
-    setRows(rows: {
-        formGroup: FormGroup;
-        groupUi: GroupUiState;
-    }[]): void;
+    setRows(rows: KlesCreatedRow[]): void;
     private insertRowAndNotify;
-    insertRow(row: {
-        formGroup: FormGroup;
-        groupUi: GroupUiState;
-    }, index?: number, options?: {
+    insertRow(row: KlesCreatedRow, index?: number, options?: {
         emitEvent?: boolean;
     }): {
         formGroup: FormGroup;
         groupUi: GroupUiState;
     };
-    insertRows(rows: {
-        formGroup: FormGroup;
-        groupUi: GroupUiState;
-    }[], index?: number): void;
+    insertRows(rows: KlesCreatedRow[], index?: number): void;
     updateRow(_id: number | string, value: any, options?: {
         emitEvent?: boolean;
         onlySelf?: boolean;
@@ -911,6 +939,7 @@ declare class ValidationService {
 
 interface IDatasourceService {
     get datasource(): IKlesDataSource;
+    readonly isEmpty: Signal<boolean>;
     register(): void;
 }
 declare class DatasourceService implements IDatasourceService {
@@ -920,6 +949,8 @@ declare class DatasourceService implements IDatasourceService {
     private validationService;
     private _datasource;
     private readonly destroyRef;
+    private readonly _isEmpty;
+    readonly isEmpty: Signal<boolean>;
     constructor(fm: KlesForm, columnsService: ColumnsService, cellValueChangeService: CellValueChangeService, validationService: ValidationService);
     register(): void;
     get datasource(): KlesDataSource;
@@ -1023,6 +1054,7 @@ interface ILinesService {
     register(): void;
     total(): number;
     loaded(): EventEmitter<void>;
+    loading(): EventEmitter<void>;
 }
 
 interface ISelectionService {
@@ -1094,6 +1126,27 @@ declare class CellService {
     static ɵprov: i0.ɵɵInjectableDeclaration<CellService>;
 }
 
+declare class KlesTableEmptyStateComponent {
+    readonly intl: KlesTableIntl;
+    private readonly changeDetectorRef;
+    private readonly destroyRef;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<KlesTableEmptyStateComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<KlesTableEmptyStateComponent, "kles-table-empty-state", never, {}, {}, never, never, true, never>;
+}
+
+declare class EmptyStateService {
+    private readonly _enabled;
+    readonly enabled: i0.Signal<boolean>;
+    readonly component: Type<unknown>;
+    constructor(config: boolean | EmptyStateConfig | undefined);
+    enable(): void;
+    disable(): void;
+    toggle(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EmptyStateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EmptyStateService>;
+}
+
 type TableSection = 'header' | 'body' | 'footer';
 declare class TableComponent implements ITable, OnInit, AfterViewInit, OnDestroy {
     private readonly host;
@@ -1117,6 +1170,7 @@ declare class TableComponent implements ITable, OnInit, AfterViewInit, OnDestroy
     private readonly eventsService;
     readonly rowService: RowService;
     readonly cellService: CellService;
+    readonly emptyStateService: EmptyStateService;
     table: MatTable<FormGroup>;
     matSort: MatSort;
     formElemRef: ElementRef<HTMLElement>;
@@ -1131,12 +1185,15 @@ declare class TableComponent implements ITable, OnInit, AfterViewInit, OnDestroy
     extraRows: Signal<(ExtraRowConfig & {
         displayedColumns: string[];
     })[]>;
+    readonly isEmpty: Signal<boolean>;
     private ro?;
     private readonly destroyRef;
     private rafId?;
     private _cleanup?;
-    constructor(host: ElementRef<HTMLElement>, connectorService: KlesTableConnectorService, loader: ILoader<any>, datasourceService: IDatasourceService, tableService: ITableService, dragDropRowService: DragDropService, selectionService: ISelectionService, columnsService: ColumnsService, loadingService: LoadingService, paginatorService: PaginatorService, scrollbarService: ScrollbarService, footerService: FooterService, extraRowService: ExtraRowService, renderService: RenderService, sortService: ISortService, filterService: FilterService, expandedRowStore: ExpandedRowStore, rowFactory: RowFormFactory, eventsService: EventsService, rowService: RowService, cellService: CellService);
+    emptyStateComponent: typeof KlesTableEmptyStateComponent;
+    constructor(host: ElementRef<HTMLElement>, connectorService: KlesTableConnectorService, loader: ILoader<any>, datasourceService: IDatasourceService, tableService: ITableService, dragDropRowService: DragDropService, selectionService: ISelectionService, columnsService: ColumnsService, loadingService: LoadingService, paginatorService: PaginatorService, scrollbarService: ScrollbarService, footerService: FooterService, extraRowService: ExtraRowService, renderService: RenderService, sortService: ISortService, filterService: FilterService, expandedRowStore: ExpandedRowStore, rowFactory: RowFormFactory, eventsService: EventsService, rowService: RowService, cellService: CellService, emptyStateService: EmptyStateService);
     get isLoadingClass(): boolean;
+    get isEmptyClass(): boolean;
     get events(): EventsApi;
     get form(): FormApi;
     get scrollbar(): ScrollbarApi;
@@ -1161,7 +1218,7 @@ declare class TableComponent implements ITable, OnInit, AfterViewInit, OnDestroy
     getStickyEndSeparator(column: KlesColumnConfig, section: TableSection): string | null;
     private getSeparatorStyle;
     private calculHeaderHeight;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TableComponent, [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }, null, null, null, null, null]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TableComponent, [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }, null, null, null, null, null, null]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TableComponent, "kles-table", never, {}, {}, never, never, true, never>;
 }
 
@@ -1239,6 +1296,7 @@ declare const SELECTION_SERVICE: InjectionToken<ISelectionService>;
 declare const SORT_SERVICE: InjectionToken<ISortService>;
 declare const SCROLLBAR_ORCHESTRATOR_SERVICE: InjectionToken<IScrollbarOrchestratorService>;
 declare const TABLE_SERVICE: InjectionToken<ITableService>;
+declare const EMPTY_STATE_CONFIG: InjectionToken<boolean | EmptyStateConfig>;
 
-export { AlignCell, COLUMNS, DATASOURCE_SERVICE, DRAG_DROP_CONFIG, EXTRA_ROWS, FOOTER, HEADER_SERVICE, KlesMaterialTableModule, KlesTableComponent, LINES_SERVICE, LOADER_CONFIG, LOADER_SERVICE, PAGINATOR_CONFIG, ROW_DRAG_DROP, SCROLLBAR_ORCHESTRATOR_SERVICE, SELECTION_CONFIG, SELECTION_SERVICE, SORT_CONFIG, SORT_SERVICE, Span, TABLE_SERVICE, TableComponent, linesLazyLoader, linesLoader, selectionConfig };
-export type { ColumnSeparatorConfig, ColumnSeparatorStyle, DefaultTableConfig, DragDrop, DragDropConfig, ExtraRow, ExtraRowConfig, ExtraRowMode, IKlesCellFieldConfig, IKlesFooterFieldConfig, IKlesHeaderFieldConfig, ITable, InfiniteScrollConfig, KlesColumnConfig, KlesExtraCellFieldConfig, KlesTableApi, KlesTableConfig, LinesLazyLoader, LinesLoader, LoaderConfig, LoaderLazyResult, LoaderResult, NgStyleInput, PaginatorConfig, RowId, Selection, SelectionAllResponse, SelectionConfig, SelectionResponse, SelectionState, TableElevationLevel };
+export { AlignCell, COLUMNS, DATASOURCE_SERVICE, DRAG_DROP_CONFIG, EMPTY_STATE_CONFIG, EXTRA_ROWS, FOOTER, HEADER_SERVICE, KlesMaterialTableModule, KlesTableComponent, KlesTableEmptyStateComponent, KlesTableIntl, LINES_SERVICE, LOADER_CONFIG, LOADER_SERVICE, PAGINATOR_CONFIG, ROW_DRAG_DROP, SCROLLBAR_ORCHESTRATOR_SERVICE, SELECTION_CONFIG, SELECTION_SERVICE, SORT_CONFIG, SORT_SERVICE, Span, TABLE_SERVICE, TableComponent, linesLazyLoader, linesLoader, selectionConfig };
+export type { ColumnSeparatorConfig, ColumnSeparatorStyle, DefaultTableConfig, DragDrop, DragDropConfig, EmptyStateConfig, ExtraRow, ExtraRowConfig, ExtraRowMode, IKlesCellFieldConfig, IKlesFooterFieldConfig, IKlesHeaderFieldConfig, ITable, InfiniteScrollConfig, KlesColumnConfig, KlesExtraCellFieldConfig, KlesTableApi, KlesTableConfig, LinesLazyLoader, LinesLoader, LoaderConfig, LoaderLazyResult, LoaderResult, NgStyleInput, PaginatorConfig, RowId, Selection, SelectionAllResponse, SelectionConfig, SelectionResponse, SelectionState, TableElevationLevel };