@3kles/kles-material-table-v2 21.8.0 → 21.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3kles/kles-material-table-v2",
-  "version": "21.8.0",
+  "version": "21.9.0",
   "keywords": [
     "3KLES"
   ],

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

@@ -355,20 +355,29 @@ declare class KlesTableIntl {
     static ɵprov: i0.ɵɵInjectableDeclaration<KlesTableIntl>;
 }
 
+interface KlesRowContext<TSource = unknown> {
+    source: TSource;
+    _id: string | number;
+    meta: {
+        depth: number;
+        parentId: string | number | null;
+    };
+}
+
 type TableElevationLevel = 0 | 1 | 2 | 3 | 4 | 5;
 type RowClassValue = string | string[] | Set<string> | Record<string, boolean | null | undefined>;
-type RowStyleInput = KlesStyleMap | ((row: Record<string, unknown>, status: FormControlStatus, index: number) => KlesStyleMap);
-type RowClassInput = RowClassValue | ((row: Record<string, unknown>, status: FormControlStatus, index: number) => RowClassValue);
-interface RowAppearanceConfig {
-    rowStyle?: RowStyleInput;
-    rowClass?: RowClassInput;
+type RowStyleInput<TSource = unknown> = KlesStyleMap | ((row: Record<string, unknown>, status: FormControlStatus, index: number, context: KlesRowContext<TSource>) => KlesStyleMap);
+type RowClassInput<TSource = unknown> = RowClassValue | ((row: Record<string, unknown>, status: FormControlStatus, index: number, context: KlesRowContext<TSource>) => RowClassValue);
+interface RowAppearanceConfig<TSource = unknown> {
+    rowStyle?: RowStyleInput<TSource>;
+    rowClass?: RowClassInput<TSource>;
 }
 interface EmptyStateConfig {
     enabled?: boolean;
     component?: Type<unknown>;
     intl?: Type<KlesTableIntl>;
 }
-interface DefaultTableConfig extends RowAppearanceConfig {
+interface DefaultTableConfig<TSource = unknown> extends RowAppearanceConfig<TSource> {
     id?: string;
     columns: KlesColumnConfig[];
     /** Reserved for row-level validation configuration; not applied yet. */
@@ -440,9 +449,12 @@ interface DragDrop<TValue = unknown> {
     dragDropColumns?: DragDropConfig<TValue>;
 }
 type ExtraRowMode = 'expand' | 'always';
+type ExtraRowWidth = 'table' | 'viewport';
 interface ExtraRowConfig {
     cells: KlesExtraCellFieldConfig[];
     mode?: ExtraRowMode;
+    /** Controls whether the content uses the full table width or only the visible scroll viewport. Defaults to `table`. */
+    width?: ExtraRowWidth;
     when?: (index: number, rowData: FormGroup) => boolean;
 }
 interface ExtraRow {
@@ -465,7 +477,7 @@ type Exclusive<T, U> = (T & {
 }) | (U & {
     [K in Exclude<keyof T, keyof U>]?: never;
 });
-type KlesTableConfig<T = unknown, R = unknown> = DefaultTableConfig & Exclusive<PaginatorConfig, InfiniteScrollConfig> & LoaderConfig<T, R> & DragDrop<R> & Selection<T> & ExtraRow;
+type KlesTableConfig<T = unknown, R = unknown> = DefaultTableConfig<R> & Exclusive<PaginatorConfig, InfiniteScrollConfig> & LoaderConfig<T, R> & DragDrop<R> & Selection<T> & ExtraRow;
 
 type AggregationType = 'sum' | 'avg' | 'min' | 'max' | 'count';
 interface SortPayload {
@@ -876,15 +888,6 @@ declare class ColumnsService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ColumnsService>;
 }
 
-interface KlesRowContext<TSource = unknown> {
-    source: TSource;
-    _id: string | number;
-    meta: {
-        depth: number;
-        parentId: string | number | null;
-    };
-}
-
 interface KlesCreatedRow<TSource = unknown> {
     formGroup: FormGroup;
     groupUi: GroupUiState;
@@ -1434,12 +1437,15 @@ declare class TableComponent implements ITable, OnInit, AfterViewInit, OnDestroy
     readonly cellService: CellService;
     readonly emptyStateService: EmptyStateService;
     private readonly treeService;
+    private readonly rowContextStore;
     table: MatTable<FormGroup>;
     matSort: MatSort;
     formElemRef: ElementRef<HTMLElement>;
     headerHeightPx: i0.WritableSignal<number>;
     scrollHeightPx: i0.WritableSignal<number>;
     footerHeightPx: i0.WritableSignal<number>;
+    viewportWidthPx: i0.WritableSignal<number>;
+    viewportScrollRangePx: i0.WritableSignal<number>;
     dataSource: IKlesDataSource;
     columns: Signal<KlesColumnConfig[]>;
     displayedColumns: Signal<string[]> | undefined;
@@ -1454,7 +1460,8 @@ declare class TableComponent implements ITable, OnInit, AfterViewInit, OnDestroy
     private rafId?;
     private _cleanup?;
     emptyStateComponent: typeof KlesTableEmptyStateComponent;
-    constructor(host: ElementRef<HTMLElement>, connectorService: KlesTableConnectorService, loader: ILoader<unknown>, datasourceService: IDatasourceService, tableService: ITableService, dragDropRowService: DragDropService, rowAppearance: RowAppearanceConfig, 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, treeService: TreeService<unknown, unknown>);
+    constructor(host: ElementRef<HTMLElement>, connectorService: KlesTableConnectorService, loader: ILoader<unknown>, datasourceService: IDatasourceService, tableService: ITableService, dragDropRowService: DragDropService, rowAppearance: RowAppearanceConfig, 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, treeService: TreeService<unknown, unknown>, rowContextStore: RowContextStore);
+    getRowContext(row: FormGroup): KlesRowContext;
     get isLoadingClass(): boolean;
     get isEmptyClass(): boolean;
     get events(): EventsApi;
@@ -1484,7 +1491,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, null, { optional: true; }, null, null, 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, null, { optional: true; }, null, null, null, null, null, null, null, null]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TableComponent, "kles-table", never, {}, {}, never, never, true, never>;
 }
 
@@ -1576,7 +1583,7 @@ declare const COLUMNS: InjectionToken<WritableSignal<KlesColumnConfig[]>>;
 declare const FOOTER: InjectionToken<WritableSignal<boolean>>;
 declare const EXTRA_ROWS: InjectionToken<WritableSignal<ExtraRowConfig[]>>;
 declare const MULTI_UNFOLD: InjectionToken<boolean>;
-declare const ROW_APPEARANCE_CONFIG: InjectionToken<RowAppearanceConfig>;
+declare const ROW_APPEARANCE_CONFIG: InjectionToken<RowAppearanceConfig<unknown>>;
 declare const ROW_DRAG_DROP: InjectionToken<DragDropService>;
 declare const DRAG_DROP_CONFIG: InjectionToken<DragDropConfig<unknown>>;
 declare const KLES_DRAG_DROP_ROW_CONTEXT: InjectionToken<DragDropRowContext<unknown>>;
@@ -1594,4 +1601,4 @@ declare const TABLE_SERVICE: InjectionToken<ITableService>;
 declare const EMPTY_STATE_CONFIG: InjectionToken<boolean | EmptyStateConfig>;
 
 export { AlignCell, COLUMNS, DATASOURCE_SERVICE, DRAG_DROP_CONFIG, EMPTY_STATE_CONFIG, EXTRA_ROWS, FOOTER, HEADER_SERVICE, INFINITE_SCROLL_CONFIG, KLES_DRAG_DROP_ROW_CONTEXT, KlesMaterialTableModule, KlesTableComponent, KlesTableEmptyStateComponent, KlesTableIntl, LINES_SERVICE, LOADER_CONFIG, LOADER_SERVICE, MULTI_UNFOLD, PAGINATOR_CONFIG, ROW_APPEARANCE_CONFIG, ROW_DRAG_DROP, SCROLLBAR_ORCHESTRATOR_SERVICE, SELECTION_CONFIG, SELECTION_SERVICE, SORT_CONFIG, SORT_SERVICE, Span, TABLE_SERVICE, TableComponent, linesLazyLoader, linesLoader, selectionConfig };
-export type { AggregationType, BulkActionClickPayload, CellMousePayload, CellPayload, CellValueChangePayload, ColumnApi, ColumnClass, ColumnDropPayload, ColumnOrderChangePayload, ColumnPayload, ColumnResizePayload, ColumnSeparatorConfig, ColumnSeparatorStyle, ColumnVisibilityChangePayload, DefaultTableConfig, DragDrop, DragDropConfig, DragDropRowChange, DragDropRowContext, EmptyStateApi, EmptyStateChangePayload, EmptyStateConfig, EventsApi, ExpansionPayload, ExtraRow, ExtraRowConfig, ExtraRowMode, FilterChangePayload, FooterApi, FooterFormApi, FormApi, FormValue, GlobalSearchPayload, HeaderFormApi, IKlesCellFieldConfig, IKlesFooterFieldConfig, IKlesHeaderFieldConfig, ITable, InfiniteScrollConfig, KlesColumnConfig, KlesExtraCellFieldConfig, KlesStyleMap, KlesStyleValue, KlesTableApi, KlesTableConfig, LinesLazyLoader, LinesLoader, LoadErrorPayload, LoadSuccessPayload, LoaderConfig, LoaderLazyResult, LoaderResult, LoadingApi, LoadingChangePayload, NgStyleInput, PageChangePayload, PaginationApi, PaginatorConfig, RenderApi, RowActionClickPayload, RowAppearanceConfig, RowClassInput, RowClassValue, RowDropErrorPayload, RowDropPayload, RowId, RowMousePayload, RowPayload, RowStyleInput, RowValidatePayload, RowsFormApi, ScrollbarApi, Selection, SelectionAllResponse, SelectionApi, SelectionChangePayload, SelectionConfig, SelectionErrorPayload, SelectionResponse, SelectionState, SortApi, SortPayload, StateChangePayload, SummaryChangePayload, TableElevationLevel, TableEvent, TableEventMap, TableEventPayload, TableEventType, TableFormValue, TreeApi, TreeNodeId, TreePayload, ValidationErrorPayload, VisibilityChangePayload };
+export type { AggregationType, BulkActionClickPayload, CellMousePayload, CellPayload, CellValueChangePayload, ColumnApi, ColumnClass, ColumnDropPayload, ColumnOrderChangePayload, ColumnPayload, ColumnResizePayload, ColumnSeparatorConfig, ColumnSeparatorStyle, ColumnVisibilityChangePayload, DefaultTableConfig, DragDrop, DragDropConfig, DragDropRowChange, DragDropRowContext, EmptyStateApi, EmptyStateChangePayload, EmptyStateConfig, EventsApi, ExpansionPayload, ExtraRow, ExtraRowConfig, ExtraRowMode, ExtraRowWidth, FilterChangePayload, FooterApi, FooterFormApi, FormApi, FormValue, GlobalSearchPayload, HeaderFormApi, IKlesCellFieldConfig, IKlesFooterFieldConfig, IKlesHeaderFieldConfig, ITable, InfiniteScrollConfig, KlesColumnConfig, KlesExtraCellFieldConfig, KlesRowContext, KlesStyleMap, KlesStyleValue, KlesTableApi, KlesTableConfig, LinesLazyLoader, LinesLoader, LoadErrorPayload, LoadSuccessPayload, LoaderConfig, LoaderLazyResult, LoaderResult, LoadingApi, LoadingChangePayload, NgStyleInput, PageChangePayload, PaginationApi, PaginatorConfig, RenderApi, RowActionClickPayload, RowAppearanceConfig, RowClassInput, RowClassValue, RowDropErrorPayload, RowDropPayload, RowId, RowMousePayload, RowPayload, RowStyleInput, RowValidatePayload, RowsFormApi, ScrollbarApi, Selection, SelectionAllResponse, SelectionApi, SelectionChangePayload, SelectionConfig, SelectionErrorPayload, SelectionResponse, SelectionState, SortApi, SortPayload, StateChangePayload, SummaryChangePayload, TableElevationLevel, TableEvent, TableEventMap, TableEventPayload, TableEventType, TableFormValue, TreeApi, TreeNodeId, TreePayload, ValidationErrorPayload, VisibilityChangePayload };