@linzjs/step-ag-grid 29.2.4 → 29.3.0

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

@@ -2779,6 +2779,8 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
     const hasSetContentSizeEmpty = React.useRef(false);
     const needsAutoSize = React.useRef(true);
     const lastFullResize = React.useRef();
+    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,37 +2793,50 @@ 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()),
+                });
+            // 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);
+                    params.onContentSize?.(autoSizeResult);
                 }
             }
             else if (gridRendered === 'rows-visible') {
+                // we have rows now so callback grid size
                 if (!hasSetContentSize.current) {
-                    if (lastFullResize.current === result.width) {
+                    // Only callback if grid size has settled
+                    if (lastFullResize.current === autoSizeResult.width) {
                         hasSetContentSize.current = true;
-                        params.onContentSize?.(result);
+                        params.onContentSize?.(autoSizeResult);
                     }
                     else {
-                        needsAutoSize.current = true;
+                        // Need to retry callback when size has settelled
+                        lastFullResize.current = autoSizeResult.width;
+                        return;
                     }
-                    lastFullResize.current = result.width;
                 }
             }
             else {
@@ -2829,6 +2844,7 @@ const Grid = ({ 'data-testid': dataTestId, defaultPostSort = true, rowSelection
                 console.error('Unknown value returned from hasGridRendered');
             }
         }
+        // 2. Now we size columns to fit the grid width
         if (sizeColumns !== 'none') {
             sizeColumnsToFit();
         }
@@ -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,12 +3146,15 @@ 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 });
@@ -3158,12 +3179,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 +3286,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 +3332,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 +5167,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);