@linzjs/step-ag-grid 29.2.4 → 29.3.1

package/dist/src/components/GridCell.d.ts

@@ -13,7 +13,6 @@ export interface ColDefT<TData extends GridBaseRow, ValueType = any> extends Col
     editable?: boolean | EditableCallback<TData, ValueType>;
     valueGetter?: string | ValueGetterFunc<TData, ValueType>;
     valueFormatter?: string | ValueFormatterFunc<TData, ValueType>;
-    maxInitialWidth?: number;
     cellRenderer?: ((props: ICellRendererParams<TData, ValueType>) => ReactElement | string | false | null | undefined) | string;
     cellRendererParams?: {
         rightHoverElement?: ReactElement;

package/dist/src/components/GridWrapper.d.ts

@@ -1,5 +1,7 @@
-import { PropsWithChildren } from 'react';
 export interface GridWrapperProps {
+    className?: string | undefined;
     maxHeight?: number | string;
 }
-export declare const GridWrapper: ({ children, maxHeight }: PropsWithChildren<GridWrapperProps>) => import("react/jsx-runtime").JSX.Element;
+export declare const GridWrapper: import("react").ForwardRefExoticComponent<GridWrapperProps & {
+    children?: import("react").ReactNode | undefined;
+} & import("react").RefAttributes<HTMLDivElement>>;

package/dist/step-ag-grid.cjs

@@ -2778,7 +2778,9 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
     const hasSetContentSize = React.useRef(false);
     const hasSetContentSizeEmpty = React.useRef(false);
     const needsAutoSize = React.useRef(true);
-    const lastFullResize = React.useRef();
+    const requiresInitialSizeToFitRef = React.useRef(true);
+    const autoSizeResultRef = React.useRef(null);
+    const prevRowsVisibleRef = React.useRef(false);
     const setInitialContentSize = React.useCallback(() => {
         if (!gridDivRef.current?.clientWidth || rowData == null) {
             // Don't resize grids if they are offscreen as it doesn't work.
@@ -2791,46 +2793,60 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
             needsAutoSize.current = true;
             return;
         }
-        const skipHeader = sizeColumns === 'auto-skip-headers' && gridRendered === 'rows-visible';
-        if (sizeColumns === 'auto' || skipHeader) {
-            const result = autoSizeColumns({
-                skipHeader,
-                userSizedColIds: new Set(userSizedColIds.current.keys()),
-                includeFlex: true,
-            });
-            if (!result) {
+        // 1. First we autosize to get the size of the columns on an infinite grid.
+        if (sizeColumns === 'auto' || sizeColumns === 'auto-skip-headers') {
+            // You can't skip headers until the grid has content
+            const rowsVisible = gridRendered === 'rows-visible';
+            const skipHeader = sizeColumns === 'auto-skip-headers' && rowsVisible;
+            // If grid was empty and now has content we need to autosize
+            if (rowsVisible !== prevRowsVisibleRef.current && rowsVisible) {
+                prevRowsVisibleRef.current = rowsVisible;
+                autoSizeResultRef.current = null;
+            }
+            const autoSizeResult = autoSizeResultRef.current ??
+                autoSizeColumns({
+                    skipHeader,
+                    userSizedColIds: new Set(userSizedColIds.current.keys()),
+                    includeFlex: true,
+                });
+            // Auto-size failed retry later
+            if (!autoSizeResult) {
                 needsAutoSize.current = true;
                 return;
             }
-            // Default max intial width is 256x initial visible column count, max of 80% window width
-            const maxWidth = maxInitialWidth ||
-                lodashEs.sum(params.columnDefs.map((c) => (!c.hide ? c.maxInitialWidth || 128 : 0)));
-            result.width = Math.min(result.width, maxWidth);
+            autoSizeResultRef.current = autoSizeResult;
+            // Calculate the auto-sized width, limit it to maxInitialWidth
+            autoSizeResult.width = maxInitialWidth ? Math.min(autoSizeResult.width, maxInitialWidth) : autoSizeResult.width;
             if (gridRendered === 'empty') {
+                // If the grid is empty we still do an onContentSize callback, we will do another callback when grid has data
+                // We don't do this callback if we have previously had row data, or have already called back for empty
                 if (!hasSetContentSizeEmpty.current && !hasSetContentSize.current) {
                     hasSetContentSizeEmpty.current = true;
-                    params.onContentSize?.(result);
+                    requiresInitialSizeToFitRef.current = true;
+                    params.onContentSize?.(autoSizeResult);
                 }
             }
             else if (gridRendered === 'rows-visible') {
+                // we have rows now so callback grid size
                 if (!hasSetContentSize.current) {
-                    if (lastFullResize.current === result.width) {
-                        hasSetContentSize.current = true;
-                        params.onContentSize?.(result);
-                    }
-                    else {
-                        needsAutoSize.current = true;
-                    }
-                    lastFullResize.current = result.width;
+                    hasSetContentSize.current = true;
+                    requiresInitialSizeToFitRef.current = true;
+                    params.onContentSize?.(autoSizeResult);
                 }
             }
             else {
                 // It should be impossible to get here
                 console.error('Unknown value returned from hasGridRendered');
             }
-        }
-        if (sizeColumns !== 'none') {
-            sizeColumnsToFit();
+            // If there's no contentSize callback there'll be on onGridResize callback
+            // which is required to run sizeColumnsToFit.
+            // There's also the possibility that the panel was already the right size so didn't trigger onGridResize.
+            lodashEs.delay(() => {
+                if (requiresInitialSizeToFitRef.current) {
+                    requiresInitialSizeToFitRef.current = false;
+                    sizeColumnsToFit();
+                }
+            }, 50);
         }
         setAutoSized(true);
         needsAutoSize.current = false;
@@ -2986,6 +3002,8 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
     const onRowDataChanged = React.useCallback(() => {
         const length = rowData?.length ?? 0;
         if (previousRowDataLength.current !== length) {
+            // We need to autosize all cells again
+            autoSizeResultRef.current = null;
             setInitialContentSize();
             previousRowDataLength.current = length;
         }
@@ -3128,15 +3146,19 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
     /**
      * Resize columns to fit if required on window/container resize
      */
-    const onGridSizeChanged = React.useCallback((event) => {
+    const onGridResize = React.useCallback((event) => {
         if (sizeColumns !== 'none') {
+            // Flex columns can expand to fit after resize, but they cannot shrink less than use resized value
+            // Double click column resize handle to reset this behaviour
             const columnLimits = [
                 ...userSizedColIds.current.entries().map(([c, w]) => ({
                     key: c,
                     minWidth: w,
+                    maxWidth: w,
                 })),
             ];
-            event.api.sizeColumnsToFit({ columnLimits });
+            requiresInitialSizeToFitRef.current = false;
+            lodashEs.defer(() => event.api.sizeColumnsToFit({ columnLimits }));
         }
     }, [sizeColumns]);
     /**
@@ -3158,12 +3180,17 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
         switch (e.source) {
             case 'uiColumnResized':
                 userSizedColIds.current.set(colId, width);
+                const colDef = e.column?.getColDef();
+                if (!colDef?.flex) {
+                    onGridResize(e);
+                }
                 break;
             case 'autosizeColumns':
                 userSizedColIds.current.delete(colId);
+                onGridResize(e);
                 break;
         }
-    }, []);
+    }, [onGridResize]);
     const gridContextMenu = useGridContextMenu({ contextMenu: params.contextMenu, contextMenuSelectRow });
     const startDragYRef = React.useRef(null);
     const clearHighlightRowClasses = React.useCallback(() => {
@@ -3260,6 +3287,7 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
         return (jsxRuntime.jsx(GridNoRowsOverlay, { loading: !rowData || params.loading === true, rowCount: rowCount, headerRowHeight: headerRowCount * rowHeight, filteredRowCount: event.api.getDisplayedRowCount(), noRowsOverlayText: params.noRowsOverlayText, noRowsMatchingOverlayText: params.noRowsMatchingOverlayText }));
     }, [columnDefs, params.loading, params.noRowsMatchingOverlayText, params.noRowsOverlayText, rowData, rowHeight]);
     const selectionColumnDef = React.useMemo(() => {
+        // Note this has to be 1 for hidden otherwise ag-grid does crazy things whilst resizing
         const selectWidth = params.hideSelectColumn ? 0 : selectable && params.onRowDragEnd ? 76 : 48;
         return {
             suppressNavigable: params.hideSelectColumn,
@@ -3305,7 +3333,7 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
                             enableClickSelection: params.enableClickSelection ?? false,
                             mode: rowSelection == 'single' ? 'singleRow' : 'multiRow',
                         }
-                        : undefined, rowHeight: rowHeight, animateRows: params.animateRows ?? false, rowClassRules: params.rowClassRules, getRowId: getRowId, onGridSizeChanged: onGridSizeChanged, suppressColumnVirtualisation: suppressColumnVirtualization, suppressClickEdit: true, onColumnVisible: setInitialContentSize, onRowDataUpdated: onRowDataChanged, onCellFocused: onCellFocused, onCellKeyDown: onCellKeyPress, onCellClicked: onCellClicked, onCellDoubleClicked: onCellDoubleClick, domLayout: params.domLayout, onColumnResized: onColumnResized, defaultColDef: defaultColDef, columnDefs: columnDefsAdjusted, selectionColumnDef: selectionColumnDef, rowData: rowData, postSortRows: params.onRowDragEnd || !defaultPostSort ? undefined : postSortRows, onModelUpdated: onModelUpdated, onGridReady: onGridReady, onSortChanged: ensureSelectedRowIsVisible, quickFilterParser: quickFilterParser, onSelectionChanged: synchroniseExternalStateToGridSelection, onColumnMoved: params.onColumnMoved, noRowsOverlayComponent: noRowsOverlayComponent, alwaysShowVerticalScroll: params.alwaysShowVerticalScroll, isExternalFilterPresent: isExternalFilterPresent, doesExternalFilterPass: doesExternalFilterPass, maintainColumnOrder: true, preventDefaultOnContextMenu: true, onCellContextMenu: gridContextMenu.cellContextMenu, rowDragText: params.rowDragText, onRowDragCancel: clearHighlightRowClasses, onRowDragMove: onRowDragMove, onRowDragEnd: onRowDragEnd, suppressCellFocus: params.suppressCellFocus, pinnedTopRowData: params.pinnedTopRowData, pinnedBottomRowData: params.pinnedBottomRowData, onRowClicked: params.onRowClicked, onRowDoubleClicked: params.onRowDoubleClicked, suppressStartEditOnTab: true }) })] }));
+                        : undefined, rowHeight: rowHeight, animateRows: params.animateRows ?? false, rowClassRules: params.rowClassRules, getRowId: getRowId, onGridSizeChanged: onGridResize, suppressColumnVirtualisation: suppressColumnVirtualization, suppressClickEdit: true, onColumnVisible: setInitialContentSize, onRowDataUpdated: onRowDataChanged, onCellFocused: onCellFocused, onCellKeyDown: onCellKeyPress, onCellClicked: onCellClicked, onCellDoubleClicked: onCellDoubleClick, domLayout: params.domLayout, onColumnResized: onColumnResized, defaultColDef: defaultColDef, columnDefs: columnDefsAdjusted, selectionColumnDef: selectionColumnDef, rowData: rowData, postSortRows: params.onRowDragEnd || !defaultPostSort ? undefined : postSortRows, onModelUpdated: onModelUpdated, onGridReady: onGridReady, onSortChanged: ensureSelectedRowIsVisible, quickFilterParser: quickFilterParser, onSelectionChanged: synchroniseExternalStateToGridSelection, onColumnMoved: params.onColumnMoved, noRowsOverlayComponent: noRowsOverlayComponent, alwaysShowVerticalScroll: params.alwaysShowVerticalScroll, isExternalFilterPresent: isExternalFilterPresent, doesExternalFilterPass: doesExternalFilterPass, maintainColumnOrder: true, preventDefaultOnContextMenu: true, onCellContextMenu: gridContextMenu.cellContextMenu, rowDragText: params.rowDragText, onRowDragCancel: clearHighlightRowClasses, onRowDragMove: onRowDragMove, onRowDragEnd: onRowDragEnd, suppressCellFocus: params.suppressCellFocus, pinnedTopRowData: params.pinnedTopRowData, pinnedBottomRowData: params.pinnedBottomRowData, onRowClicked: params.onRowClicked, onRowDoubleClicked: params.onRowDoubleClicked, suppressStartEditOnTab: true }) })] }));
 };
 const quickFilterParser = (filterStr) => {
     // filter is exact matches exactly groups separated by commas
@@ -5140,7 +5168,9 @@ const GridPopoverTextInput = (colDef, params) => GridCell(colDef, {
     ...params,
 });
 
-const GridWrapper = ({ children, maxHeight }) => (jsxRuntime.jsx("div", { className: 'Grid-wrapper', style: { maxHeight }, children: children }));
+const GridWrapper = React.forwardRef(function GridWrapperFr({ children, maxHeight, className }, ref) {
+    return (jsxRuntime.jsx("div", { className: clsx('Grid-wrapper', className), style: { maxHeight }, ref: ref, children: children }));
+});
 
 const getColId = (colDef) => colDef.colId ?? '';
 const isFlexColumn = (colDef) => !!colDef.flex && !isGridCellFiller(colDef);