@dereekb/dbx-web 13.4.1 → 13.4.2

package/fesm2022/dereekb-dbx-web-table.mjs

@@ -61,6 +61,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
                     standalone: true
                 }]
         }] });
+/**
+ * Creates a factory that produces injection component configs for rendering date column headers.
+ *
+ * The factory initializes each {@link DbxTableDateHeaderComponent} with the column's date metadata.
+ *
+ * @returns a factory function that maps a date column to its header injection config
+ */
 function dbxTableDateHeaderInjectionFactory() {
     return (column) => {
         const config = {
@@ -74,6 +81,14 @@ function dbxTableDateHeaderInjectionFactory() {
 }
 
 const NO_GROUPS_ID = 'none';
+/**
+ * Creates a default (ungrouped) table item group that wraps all items under the {@link NO_GROUPS_ID} identifier.
+ *
+ * Used when no explicit grouping function is provided to the table.
+ *
+ * @param items - the array of items to include in the default group
+ * @returns a default group containing all the provided items
+ */
 function defaultDbxTableItemGroup(items) {
     return {
         groupId: NO_GROUPS_ID,
@@ -82,6 +97,7 @@ function defaultDbxTableItemGroup(items) {
         default: true
     };
 }
+/* eslint-enable @typescript-eslint/no-explicit-any */
 
 class DbxTableStore extends ComponentStore {
     constructor() {
@@ -272,6 +288,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
                     imports: [MatDatepickerModule, ReactiveFormsModule, MatButtonModule]
                 }]
         }], ctorParameters: () => [] });
+/**
+ * Creates an injection component config for a date-range day-distance input cell.
+ *
+ * Initializes the component with the provided configuration for day distance, date bounds, and button format.
+ *
+ * @param componentConfig - optional configuration for the date range input (day distance, min/max dates, button format)
+ * @returns an injection component config that renders a {@link DbxTableDateRangeDayDistanceInputCellInputComponent}
+ */
 function dbxTableDateRangeDayDistanceInputCellInput(componentConfig) {
     const config = {
         componentClass: DbxTableDateRangeDayDistanceInputCellInputComponent,
@@ -553,6 +577,7 @@ class DbxColumnSizeColumnDirective {
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxColumnSizeColumnDirective, decorators: [{
             type: Directive,
             args: [{
+                    // eslint-disable-next-line @angular-eslint/directive-selector
                     selector: '[dbx-column-size-column]',
                     standalone: true
                 }]
@@ -746,9 +771,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 
 const DBX_TABLE_ITEMS_COLUMN_NAME = '_items';
 const DBX_TABLE_ACTIONS_COLUMN_NAME = '_actions';
+/**
+ * Type guard that checks whether a table view element is a group element (header or footer).
+ *
+ * @param element - the table view element to check
+ * @returns `true` if the element represents a group header or footer row
+ */
 function isDbxTableViewGroupElement(element) {
     return element.type === 'group';
 }
+/**
+ * Type guard that checks whether a table view element is an item data element.
+ *
+ * @param element - the table view element to check
+ * @returns `true` if the element represents an item data row
+ */
 function isDbxTableViewItemElement(element) {
     return element.type === 'item';
 }
@@ -774,8 +811,7 @@ class DbxTableViewComponent {
             const { groupHeader: inputGroupHeader, groupFooter: inputGroupFooter } = viewDelegate;
             const hasGroupHeader = inputGroupHeader != null ? (group) => inputGroupHeader(group) != null : () => false;
             const hasGroupFooter = inputGroupFooter != null ? (group) => inputGroupFooter(group) != null : () => false;
-            return groups
-                .map((group) => {
+            return groups.flatMap((group) => {
                 const { items } = group;
                 const itemElements = items.map((item) => ({
                     type: 'item',
@@ -806,8 +842,7 @@ class DbxTableViewComponent {
                     }
                 }
                 return elements;
-            })
-                .flat();
+            });
         }));
     })), shareReplay(1));
     elements$ = this.elementsState$.pipe(valueFromFinishedLoadingState(() => []), throttleTime(50, undefined, { leading: true, trailing: true }), shareReplay(1));
@@ -853,8 +888,7 @@ class DbxTableViewComponent {
     }
     showFooterRowSignal = computed(() => {
         const viewDelegate = this.viewDelegateSignal();
-        const showFooterRow = viewDelegate && (viewDelegate.summaryRowHeader != null || viewDelegate.columnFooter != null || viewDelegate.summaryRowEnd != null);
-        return showFooterRow;
+        return viewDelegate && (viewDelegate.summaryRowHeader != null || viewDelegate.columnFooter != null || viewDelegate.summaryRowEnd != null);
     }, ...(ngDevMode ? [{ debugName: "showFooterRowSignal" }] : []));
     showFullSummaryRowSignal = computed(() => {
         const viewDelegate = this.viewDelegateSignal();
@@ -945,6 +979,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  * @returns
  */
 const DEFAULT_DBX_TABLE_READER_COLUMN_TRACK_BY = (column) => column.columnName;
+/**
+ * Creates a {@link DbxTableReader} that provides reactive access to cell data across all columns and items in the table.
+ *
+ * @param config The reader configuration containing the delegate and table store
+ * @returns A {@link DbxTableReader} instance with observable accessors for cell data
+ */
 function dbxTableReader(config) {
     const { delegate, tableStore } = config;
     const { items$ } = tableStore;
@@ -999,11 +1039,10 @@ function dbxTableReader(config) {
         return allColumnsData$.pipe(map((columnsData) => columnsData.record[columnKey]), shareReplay(1));
     };
     const loadCellDataPairsForColumn = (column) => {
-        const columnsData$ = _columnAccessorForColumn(column).pipe(switchMap((accessor) => {
+        return _columnAccessorForColumn(column).pipe(switchMap((accessor) => {
             // when visibility changes, the data will change to be an empty array
             return accessor ? accessor.cellData$ : of([]);
         }), shareReplay(1));
-        return columnsData$;
     };
     const cellDataPairsForColumn = (column) => {
         return loadCellDataPairsForColumn(column);
@@ -1013,7 +1052,7 @@ function dbxTableReader(config) {
     };
     const cellDataPairForColumnAndItem = (column, item) => {
         const itemKey = trackItem(item);
-        const columnsData$ = _columnAccessorForColumn(column).pipe(switchMap((columnsData) => {
+        return _columnAccessorForColumn(column).pipe(switchMap((columnsData) => {
             return columnsData
                 ? columnsData.cellDataAccessors$.pipe(switchMap((cellDataAccessor) => {
                     const itemAccessor = cellDataAccessor.accessorsRecord[itemKey];
@@ -1022,7 +1061,6 @@ function dbxTableReader(config) {
                 }))
                 : of(null);
         }), shareReplay(1));
-        return columnsData$;
     };
     const cellDataForColumnAndItem = (column, item) => {
         return cellDataPairForColumnAndItem(column, item).pipe(map((pair) => pair?.value));