@ornery/ui-grid-react 0.1.4 → 0.1.5

package/dist/index.mjs

@@ -1,13 +1,39 @@
 // src/useGridState.ts
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+// src/gridStateMath.ts
+import { gridColumnWidth } from "@ornery/ui-grid";
+function orderVisibleColumns(columns, order) {
+  return [...columns].filter((column) => column.visible !== false).sort((left, right) => order.indexOf(left.name) - order.indexOf(right.name));
+}
+function buildGridTemplateColumns(columns) {
+  return columns.map((column) => gridColumnWidth(column)).join(" ");
+}
+function resolveBenchmarkIterations(iterations, configuredIterations) {
+  return Math.max(1, iterations ?? configuredIterations ?? 25);
+}
+function formatPaginationSummary(totalItems, firstRowIndex, lastRowIndex) {
+  if (totalItems === 0) {
+    return "0-0 of 0";
+  }
+  return `${firstRowIndex + 1}-${lastRowIndex + 1} of ${totalItems}`;
+}
+function computeViewportHeightPx(viewportHeight, autoViewportHeight) {
+  return `${viewportHeight ?? autoViewportHeight ?? 560}px`;
+}
+function computeViewportRows(viewportHeight, rowHeight) {
+  return Math.max(1, Math.ceil((viewportHeight ?? 560) / (rowHeight ?? 44)));
+}
+
+// src/useGridState.ts
 import {
   createGridApi,
   getCellValue as getCellValue2,
   setPathValue,
   SORT_DIRECTIONS as SORT_DIRECTIONS2,
-  buildGridPipeline,
+  defaultGridEngine,
   resolveGridLabels,
-  gridColumnWidth,
+  gridColumnWidth as gridColumnWidth2,
   headerLabel as coreHeaderLabel,
   gridSortButtonLabel,
   gridSortAriaSort,
@@ -59,7 +85,8 @@ import {
   FEATURE_INFINITE_SCROLL,
   FEATURE_COLUMN_MOVING,
   FEATURE_CSV_EXPORT,
-  FEATURE_AUTO_RESIZE
+  FEATURE_AUTO_RESIZE,
+  FEATURE_PINNING
 } from "@ornery/ui-grid";
 
 // ../ui-grid/src/lib/grid/grid.core.pagination.ts
@@ -240,12 +267,15 @@ function normalizeGridSavedState(state) {
     );
   }
   if (state.filters && typeof state.filters === "object") {
-    normalized.filters = Object.entries(state.filters).reduce((accumulator, [key, value]) => {
-      if (typeof key === "string" && isSafeStateKey(key) && typeof value === "string") {
-        accumulator[key] = value;
-      }
-      return accumulator;
-    }, {});
+    normalized.filters = Object.entries(state.filters).reduce(
+      (accumulator, [key, value]) => {
+        if (typeof key === "string" && isSafeStateKey(key) && typeof value === "string") {
+          accumulator[key] = value;
+        }
+        return accumulator;
+      },
+      {}
+    );
   }
   if (state.sort && typeof state.sort === "object") {
     normalized.sort = {
@@ -272,6 +302,17 @@ function normalizeGridSavedState(state) {
   if (state.treeView && typeof state.treeView === "object") {
     normalized.treeView = normalizeBooleanMap(state.treeView);
   }
+  if (state.pinning && typeof state.pinning === "object") {
+    normalized.pinning = Object.entries(state.pinning).reduce(
+      (acc, [key, value]) => {
+        if (typeof key === "string" && isSafeStateKey(key) && (value === "left" || value === "right")) {
+          acc[key] = value;
+        }
+        return acc;
+      },
+      {}
+    );
+  }
   return normalized;
 }
 function normalizeBooleanMap(value) {
@@ -286,6 +327,69 @@ function isSafeStateKey(value) {
   return value !== "__proto__" && value !== "constructor" && value !== "prototype";
 }
 
+// ../ui-grid/src/lib/grid/grid.core.pinning.ts
+function isPinningEnabled(options) {
+  return options.enablePinning === true;
+}
+function isColumnPinnable(options, column) {
+  return isPinningEnabled(options) && column.enablePinning !== false;
+}
+function pinColumnState(current, columnName, direction) {
+  const next = { ...current };
+  if (direction === "none") {
+    delete next[columnName];
+  } else {
+    next[columnName] = direction;
+  }
+  return next;
+}
+function buildInitialPinnedState(columns) {
+  const state = {};
+  for (const col of columns) {
+    if (col.pinnedLeft) state[col.name] = "left";
+    else if (col.pinnedRight) state[col.name] = "right";
+  }
+  return state;
+}
+function computePinnedOffset(visibleColumns, pinnedColumns, column) {
+  const direction = pinnedColumns[column.name];
+  if (!direction) return null;
+  function resolveColumnWidthForOffset(column2) {
+    const w = column2.width;
+    if (!w) return "11rem";
+    if (w.includes("fr") || w.includes("minmax")) return "11rem";
+    return w;
+  }
+  if (direction === "left") {
+    const offsetParts = [];
+    for (const col of visibleColumns) {
+      if (col.name === column.name) break;
+      if (pinnedColumns[col.name] === "left") {
+        offsetParts.push(resolveColumnWidthForOffset(col));
+      }
+    }
+    return {
+      side: "left",
+      offset: offsetParts.length > 0 ? `calc(${offsetParts.join(" + ")})` : "0px"
+    };
+  }
+  if (direction === "right") {
+    const offsetParts = [];
+    const reversed = [...visibleColumns].reverse();
+    for (const col of reversed) {
+      if (col.name === column.name) break;
+      if (pinnedColumns[col.name] === "right") {
+        offsetParts.push(resolveColumnWidthForOffset(col));
+      }
+    }
+    return {
+      side: "right",
+      offset: offsetParts.length > 0 ? `calc(${offsetParts.join(" + ")})` : "0px"
+    };
+  }
+  return null;
+}
+
 // ../ui-grid/src/lib/grid/ui-grid.events.ts
 function raiseGridRenderingComplete(gridApi) {
   gridApi.core.raise.renderingComplete(gridApi);
@@ -352,6 +456,9 @@ function raiseGridAfterCellEdit(gridApi, rowEntity, column, newValue, oldValue)
 function raiseGridCancelCellEdit(gridApi, rowEntity, column) {
   gridApi.edit.raise.cancelCellEdit(rowEntity, column);
 }
+function raiseGridColumnPinned(gridApi, columnName, direction) {
+  gridApi.pinning.raise.columnPinned(columnName, direction);
+}
 
 // ../ui-grid/src/lib/grid/ui-grid.state.ts
 function moveArrayItem(items, fromIndex, toIndex) {
@@ -393,6 +500,9 @@ function createGridRestoreMutationPlan(state) {
   if (normalizedState.treeView) {
     plan.treeView = normalizedState.treeView;
   }
+  if (normalizedState.pinning) {
+    plan.pinning = normalizedState.pinning;
+  }
   return plan;
 }
 
@@ -433,6 +543,12 @@ function moveGridColumnCommand(gridApi, canMoveColumns, updateColumnOrder, fromI
     return next;
   });
 }
+function pinGridColumnCommand(gridApi, isPinningEnabled2, setPinnedColumns, getCurrentPinnedColumns, columnName, direction) {
+  if (!isPinningEnabled2) return;
+  const next = pinColumnState(getCurrentPinnedColumns(), columnName, direction);
+  setPinnedColumns(next);
+  raiseGridColumnPinned(gridApi, columnName, direction);
+}
 function seekGridPaginationCommand(gridApi, setCurrentPage, getTotalPages, getEffectivePageSize, page) {
   const nextPage = seekGridPage(page, getTotalPages());
   setCurrentPage(nextPage);
@@ -466,7 +582,11 @@ function restoreGridStateCommand(gridApi, state, access) {
   if (restorePlan.pagination) {
     access.setCurrentPage(restorePlan.pagination.currentPage);
     access.setPageSize(restorePlan.pagination.pageSize);
-    raiseGridPaginationChanged(gridApi, restorePlan.pagination.currentPage, access.getEffectivePageSize());
+    raiseGridPaginationChanged(
+      gridApi,
+      restorePlan.pagination.currentPage,
+      access.getEffectivePageSize()
+    );
   }
   if (restorePlan.expandable) {
     access.setExpandedRows(restorePlan.expandable);
@@ -474,6 +594,12 @@ function restoreGridStateCommand(gridApi, state, access) {
   if (restorePlan.treeView) {
     access.setExpandedTreeRows(restorePlan.treeView);
   }
+  if (restorePlan.pinning && typeof access.setPinnedColumns === "function") {
+    access.setPinnedColumns(restorePlan.pinning);
+    for (const [col, dir] of Object.entries(restorePlan.pinning)) {
+      raiseGridColumnPinned(gridApi, col, dir);
+    }
+  }
 }
 function toggleGridRowExpansionCommand(gridApi, canExpandRows, currentExpandedRows, rowId, setExpandedRows, findRowById) {
   if (!canExpandRows) {
@@ -495,7 +621,10 @@ function collapseAllGridRowsCommand(setExpandedRows) {
   setExpandedRows({});
 }
 function toggleGridTreeRowCommand(gridApi, currentExpandedTreeRows, rowId, setExpandedTreeRows, findRowById) {
-  const { expanded, nextExpandedTreeRows } = toggleGridTreeRowExpanded(currentExpandedTreeRows, rowId);
+  const { expanded, nextExpandedTreeRows } = toggleGridTreeRowExpanded(
+    currentExpandedTreeRows,
+    rowId
+  );
   setExpandedTreeRows(nextExpandedTreeRows);
   const gridRow = findRowById(rowId);
   if (gridRow) {
@@ -630,13 +759,45 @@ function downloadGridCsvFile(csv, filename) {
 }
 
 // src/useGridState.ts
+function escapeCssSelectorValue(value) {
+  const nativeEscape = globalThis.CSS?.escape;
+  if (typeof nativeEscape === "function") {
+    return nativeEscape(value);
+  }
+  let output = "";
+  for (let index = 0; index < value.length; index += 1) {
+    const codePoint = value.charCodeAt(index);
+    const character = value.charAt(index);
+    if (codePoint === 0) {
+      output += "\uFFFD";
+      continue;
+    }
+    const isControlCharacter = codePoint >= 1 && codePoint <= 31 || codePoint === 127;
+    const startsWithDigit = index === 0 && codePoint >= 48 && codePoint <= 57;
+    const secondCharDigitAfterHyphen = index === 1 && codePoint >= 48 && codePoint <= 57 && value.charCodeAt(0) === 45;
+    if (isControlCharacter || startsWithDigit || secondCharDigitAfterHyphen) {
+      output += `\\${codePoint.toString(16)} `;
+      continue;
+    }
+    if (index === 0 && value.length === 1 && codePoint === 45) {
+      output += `\\${character}`;
+      continue;
+    }
+    const isSafeCharacter = codePoint >= 128 || codePoint === 45 || codePoint === 95 || codePoint >= 48 && codePoint <= 57 || codePoint >= 65 && codePoint <= 90 || codePoint >= 97 && codePoint <= 122;
+    output += isSafeCharacter ? character : `\\${character}`;
+  }
+  return output;
+}
 function useGridState(options, onRegisterApi) {
   const [activeFilters, setActiveFilters] = useState({});
   const [groupByColumns, setGroupByColumns] = useState([]);
   const [collapsedGroups, setCollapsedGroups] = useState({});
   const [columnOrder, setColumnOrder] = useState([]);
   const [hiddenRowReasons, setHiddenRowReasons] = useState({});
-  const [sortState, setSortState] = useState({ columnName: null, direction: SORT_DIRECTIONS2.none });
+  const [sortState, setSortState] = useState({
+    columnName: null,
+    direction: SORT_DIRECTIONS2.none
+  });
   const [focusedCell, setFocusedCell] = useState(null);
   const [editingCell, setEditingCell] = useState(null);
   const [editingValue, setEditingValue] = useState("");
@@ -652,6 +813,7 @@ function useGridState(options, onRegisterApi) {
     previousVisibleRows: 0
   });
   const [autoViewportHeight, setAutoViewportHeight] = useState(null);
+  const [pinnedColumns, setPinnedColumns] = useState({});
   const gridContainerRef = useRef(null);
   const initializedGridIdRef = useRef(null);
   const lastCanvasHeightRef = useRef(0);
@@ -683,6 +845,8 @@ function useGridState(options, onRegisterApi) {
   expandedRowsRef.current = expandedRows;
   const expandedTreeRowsRef = useRef(expandedTreeRows);
   expandedTreeRowsRef.current = expandedTreeRows;
+  const pinnedColumnsRef = useRef(pinnedColumns);
+  pinnedColumnsRef.current = pinnedColumns;
   const currentPageRef = useRef(currentPage);
   currentPageRef.current = currentPage;
   const pageSizeRef = useRef(pageSize);
@@ -693,13 +857,12 @@ function useGridState(options, onRegisterApi) {
   optionsRef.current = options;
   const rowSize = options.rowHeight ?? 44;
   const visibleColumns = useMemo(() => {
-    const order = columnOrder;
-    return [...options.columnDefs].filter((column) => column.visible !== false).sort((left, right) => order.indexOf(left.name) - order.indexOf(right.name));
+    return orderVisibleColumns(options.columnDefs, columnOrder);
   }, [options.columnDefs, columnOrder]);
   const visibleColumnsRef = useRef(visibleColumns);
   visibleColumnsRef.current = visibleColumns;
   const pipeline = useMemo(() => {
-    return buildGridPipeline({
+    return defaultGridEngine.buildPipeline({
       options,
       columns: visibleColumns,
       activeFilters,
@@ -713,14 +876,39 @@ function useGridState(options, onRegisterApi) {
       pageSize,
       rowSize
     });
-  }, [options, visibleColumns, activeFilters, sortState, groupByColumns, collapsedGroups, hiddenRowReasons, expandedRows, expandedTreeRows, currentPage, pageSize, rowSize]);
+  }, [
+    options,
+    visibleColumns,
+    activeFilters,
+    sortState,
+    groupByColumns,
+    collapsedGroups,
+    hiddenRowReasons,
+    expandedRows,
+    expandedTreeRows,
+    currentPage,
+    pageSize,
+    rowSize
+  ]);
   const pipelineRef = useRef(pipeline);
   pipelineRef.current = pipeline;
   const labels = useMemo(() => resolveGridLabels(options.labels), [options.labels]);
   const gridTemplateColumns = useMemo(
-    () => visibleColumns.map((column) => gridColumnWidth(column)).join(" "),
+    () => buildGridTemplateColumns(visibleColumns),
     [visibleColumns]
   );
+  const isPinningEnabledFn = useCallback(() => {
+    return isPinningEnabled(optionsRef.current);
+  }, []);
+  const isColumnPinnableFn = useCallback((column) => {
+    return isColumnPinnable(optionsRef.current, column);
+  }, []);
+  const isPinnedFn = useCallback((column) => {
+    return pinnedColumnsRef.current[column.name] !== void 0;
+  }, []);
+  const pinnedOffsetFn = useCallback((column) => {
+    return computePinnedOffset(visibleColumnsRef.current, pinnedColumnsRef.current, column);
+  }, []);
   const resolveRowId = useCallback((row) => {
     return coreResolveGridRowId(optionsRef.current, row);
   }, []);
@@ -732,9 +920,12 @@ function useGridState(options, onRegisterApi) {
       expandedRowsRef.current
     );
   }, []);
-  const findRowById = useCallback((rowId) => {
-    return coreFindGridRowById(buildRowsFromData(optionsRef.current.data), rowId);
-  }, [buildRowsFromData]);
+  const findRowById = useCallback(
+    (rowId) => {
+      return coreFindGridRowById(buildRowsFromData(optionsRef.current.data), rowId);
+    },
+    [buildRowsFromData]
+  );
   const canExpandRowsFn = useCallback(() => {
     return FEATURE_EXPANDABLE && canGridExpandRows(optionsRef.current);
   }, []);
@@ -743,7 +934,12 @@ function useGridState(options, onRegisterApi) {
   }, []);
   const getCurrentPageValueFn = useCallback((totalItems) => {
     const ti = totalItems ?? pipelineRef.current.totalItems;
-    return coreGetCurrentPageValue(optionsRef.current, currentPageRef.current, ti, pageSizeRef.current);
+    return coreGetCurrentPageValue(
+      optionsRef.current,
+      currentPageRef.current,
+      ti,
+      pageSizeRef.current
+    );
   }, []);
   const getTotalPagesValueFn = useCallback((totalItems) => {
     const ti = totalItems ?? pipelineRef.current.totalItems;
@@ -751,32 +947,45 @@ function useGridState(options, onRegisterApi) {
   }, []);
   const getFirstRowIndexValueFn = useCallback((totalItems) => {
     const ti = totalItems ?? pipelineRef.current.totalItems;
-    return coreGetFirstRowIndexValue(optionsRef.current, currentPageRef.current, ti, pageSizeRef.current);
+    return coreGetFirstRowIndexValue(
+      optionsRef.current,
+      currentPageRef.current,
+      ti,
+      pageSizeRef.current
+    );
   }, []);
   const getLastRowIndexValueFn = useCallback((totalItems) => {
     const ti = totalItems ?? pipelineRef.current.totalItems;
-    return coreGetLastRowIndexValue(optionsRef.current, currentPageRef.current, ti, pageSizeRef.current);
-  }, []);
-  const isCellEditable = useCallback((row, column, triggerEvent) => {
-    if (!FEATURE_CELL_EDIT) return false;
-    const editable = column.enableCellEdit ?? optionsRef.current.enableCellEdit ?? false;
-    if (!editable) return false;
-    const condition = column.cellEditableCondition ?? optionsRef.current.cellEditableCondition ?? true;
-    if (typeof condition === "boolean") return condition;
-    const context = {
-      row: row.entity,
-      column,
-      rowIndex: row.index,
-      triggerEvent
-    };
-    return condition(context);
+    return coreGetLastRowIndexValue(
+      optionsRef.current,
+      currentPageRef.current,
+      ti,
+      pageSizeRef.current
+    );
   }, []);
+  const isCellEditable = useCallback(
+    (row, column, triggerEvent) => {
+      if (!FEATURE_CELL_EDIT) return false;
+      const editable = column.enableCellEdit ?? optionsRef.current.enableCellEdit ?? false;
+      if (!editable) return false;
+      const condition = column.cellEditableCondition ?? optionsRef.current.cellEditableCondition ?? true;
+      if (typeof condition === "boolean") return condition;
+      const context = {
+        row: row.entity,
+        column,
+        rowIndex: row.index,
+        triggerEvent
+      };
+      return condition(context);
+    },
+    []
+  );
   const shouldEditOnFocusFn = useCallback((column) => {
     return column.enableCellEditOnFocus ?? optionsRef.current.enableCellEditOnFocus ?? false;
   }, []);
   const focusRenderedCell = useCallback((position) => {
     const focusToken = ++renderedCellFocusTokenRef.current;
-    const selector = `.body-cell[data-row-id="${position.rowId}"][data-col-name="${position.columnName}"]`;
+    const selector = `.body-cell[data-row-id="${escapeCssSelectorValue(position.rowId)}"][data-col-name="${escapeCssSelectorValue(position.columnName)}"]`;
     const doFocus = (retry = true) => {
       if (focusToken !== renderedCellFocusTokenRef.current) return;
       const container = gridContainerRef.current;
@@ -797,11 +1006,12 @@ function useGridState(options, onRegisterApi) {
     if (focusToken !== editorFocusTokenRef.current) return;
     const ec = editingCellRef.current;
     if (!ec) return;
-    const selector = `.cell-editor[data-row-id="${ec.rowId}"][data-col-name="${ec.columnName}"]`;
+    const selector = `.cell-editor[data-row-id="${escapeCssSelectorValue(ec.rowId)}"][data-col-name="${escapeCssSelectorValue(ec.columnName)}"]`;
     const doFocus = (retry = true) => {
       if (focusToken !== editorFocusTokenRef.current) return;
       const currentEc = editingCellRef.current;
-      if (!currentEc || currentEc.rowId !== ec.rowId || currentEc.columnName !== ec.columnName) return;
+      if (!currentEc || currentEc.rowId !== ec.rowId || currentEc.columnName !== ec.columnName)
+        return;
       const container = gridContainerRef.current;
       if (!container) return;
       const input = container.querySelector(selector);
@@ -862,7 +1072,11 @@ function useGridState(options, onRegisterApi) {
         gridApiRef.current.core.raise.groupingChanged(next);
       },
       clearGrouping: () => {
-        clearGridGroupingCommand(gridApiRef.current, (grouping) => setGroupByColumns(grouping), false);
+        clearGridGroupingCommand(
+          gridApiRef.current,
+          (grouping) => setGroupByColumns(grouping),
+          false
+        );
       },
       benchmark: (iterations) => {
         return runBenchmarkFn(iterations);
@@ -957,7 +1171,8 @@ function useGridState(options, onRegisterApi) {
           pageSize: pageSizeRef.current,
           totalItems: pipelineRef.current.totalItems,
           expandedRows: expandedRowsRef.current,
-          expandedTreeRows: expandedTreeRowsRef.current
+          expandedTreeRows: expandedTreeRowsRef.current,
+          pinnedColumns: pinnedColumnsRef.current
         });
       },
       restoreState: (state) => {
@@ -970,6 +1185,7 @@ function useGridState(options, onRegisterApi) {
           setPageSize: (ps) => setPageSize(ps),
           setExpandedRows: (e) => setExpandedRows(e),
           setExpandedTreeRows: (e) => setExpandedTreeRows(e),
+          setPinnedColumns: (p) => setPinnedColumns(p),
           getEffectivePageSize: () => effectivePageSizeFn(pipelineRef.current.totalItems)
         });
       },
@@ -982,20 +1198,45 @@ function useGridState(options, onRegisterApi) {
       },
       endCellEdit: () => commitCellEditFn(),
       cancelCellEdit: () => cancelCellEditFn(),
-      getEditingCell: () => editingCellRef.current
+      getEditingCell: () => editingCellRef.current,
+      pinColumn: (columnName, direction) => {
+        pinGridColumnCommand(
+          gridApiRef.current,
+          isPinningEnabledFn(),
+          (v) => setPinnedColumns(v),
+          () => pinnedColumnsRef.current,
+          columnName,
+          direction
+        );
+      }
     };
     gridApiRef.current = createGridApi(bindings);
   }
   const gridApi = gridApiRef.current;
-  const seekPageFn = useCallback((page) => {
-    seekGridPaginationCommand(
+  const seekPageFn = useCallback(
+    (page) => {
+      seekGridPaginationCommand(
+        gridApiRef.current,
+        (nextPage) => setCurrentPage(nextPage),
+        () => getTotalPagesValueFn(),
+        () => effectivePageSizeFn(pipelineRef.current.totalItems),
+        page
+      );
+    },
+    [getTotalPagesValueFn, effectivePageSizeFn]
+  );
+  const togglePinFn = useCallback((column) => {
+    const current = pinnedColumnsRef.current[column.name];
+    const next = current === "left" ? "right" : current === "right" ? "none" : "left";
+    pinGridColumnCommand(
       gridApiRef.current,
-      (nextPage) => setCurrentPage(nextPage),
-      () => getTotalPagesValueFn(),
-      () => effectivePageSizeFn(pipelineRef.current.totalItems),
-      page
+      isPinningEnabledFn(),
+      (v) => setPinnedColumns(v),
+      () => pinnedColumnsRef.current,
+      column.name,
+      next
     );
-  }, [getTotalPagesValueFn, effectivePageSizeFn]);
+  }, []);
   const setPaginationPageSizeFn = useCallback((ps) => {
     setGridPaginationPageSizeCommand(
       gridApiRef.current,
@@ -1004,17 +1245,20 @@ function useGridState(options, onRegisterApi) {
       ps
     );
   }, []);
-  const toggleRowExpansionByRefFn = useCallback((row) => {
-    const rowId = coreResolveGridRowId(optionsRef.current, row);
-    toggleGridRowExpansionCommand(
-      gridApiRef.current,
-      FEATURE_EXPANDABLE && canGridExpandRows(optionsRef.current),
-      expandedRowsRef.current,
-      rowId,
-      (e) => setExpandedRows(e),
-      (resolvedRowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), resolvedRowId)
-    );
-  }, [buildRowsFromData]);
+  const toggleRowExpansionByRefFn = useCallback(
+    (row) => {
+      const rowId = coreResolveGridRowId(optionsRef.current, row);
+      toggleGridRowExpansionCommand(
+        gridApiRef.current,
+        FEATURE_EXPANDABLE && canGridExpandRows(optionsRef.current),
+        expandedRowsRef.current,
+        rowId,
+        (e) => setExpandedRows(e),
+        (resolvedRowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), resolvedRowId)
+      );
+    },
+    [buildRowsFromData]
+  );
   const expandAllRowsFn = useCallback(() => {
     if (!canGridExpandRows(optionsRef.current)) return;
     expandAllGridRowsCommand(
@@ -1024,88 +1268,106 @@ function useGridState(options, onRegisterApi) {
     );
   }, [buildRowsFromData]);
   const toggleAllRowsFn = useCallback(() => {
-    const allExpanded = areAllGridRowsExpanded(buildRowsFromData(optionsRef.current.data), expandedRowsRef.current);
+    const allExpanded = areAllGridRowsExpanded(
+      buildRowsFromData(optionsRef.current.data),
+      expandedRowsRef.current
+    );
     if (allExpanded) {
       collapseAllGridRowsCommand((e) => setExpandedRows(e));
     } else {
       expandAllRowsFn();
     }
   }, [buildRowsFromData, expandAllRowsFn]);
-  const toggleTreeRowByRefFn = useCallback((row) => {
-    const rowId = coreResolveGridRowId(optionsRef.current, row);
-    toggleGridTreeRowCommand(
-      gridApiRef.current,
-      expandedTreeRowsRef.current,
-      rowId,
-      (e) => setExpandedTreeRows(e),
-      (resolvedRowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), resolvedRowId)
-    );
-  }, [buildRowsFromData]);
-  const expandTreeRowByRefFn = useCallback((row) => {
-    const rowId = coreResolveGridRowId(optionsRef.current, row);
-    setGridTreeRowExpandedCommand(
-      gridApiRef.current,
-      expandedTreeRowsRef.current,
-      rowId,
-      true,
-      (e) => setExpandedTreeRows(e),
-      (resolvedRowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), resolvedRowId)
-    );
-  }, [buildRowsFromData]);
-  const collapseTreeRowByRefFn = useCallback((row) => {
-    const rowId = coreResolveGridRowId(optionsRef.current, row);
-    setGridTreeRowExpandedCommand(
-      gridApiRef.current,
-      expandedTreeRowsRef.current,
-      rowId,
-      false,
-      (e) => setExpandedTreeRows(e),
-      (resolvedRowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), resolvedRowId)
-    );
-  }, [buildRowsFromData]);
-  const startCellEditFn = useCallback((row, column, triggerEvent, initialValue) => {
-    const currentValue = getCellValue2(row.entity, column);
-    const focusToken = ++editorFocusTokenRef.current;
-    const ec = beginGridCellEditCommand(
-      gridApiRef.current,
-      {
-        setFocusedCell: (fc) => setFocusedCell(fc),
-        setEditingCell: (ec2) => setEditingCell(ec2),
-        setEditingValue: (ev) => setEditingValue(ev)
-      },
-      row,
-      column,
-      currentValue,
-      triggerEvent,
-      initialValue
-    );
-    if (ec) {
-      queueMicrotask(() => focusEditorInput(focusToken));
-    }
-  }, [focusEditorInput]);
-  const commitCellEditFn = useCallback((direction, restoreFocus = true) => {
-    const result = commitGridCellEditCommand(gridApiRef.current, {
-      getEditingCell: () => editingCellRef.current,
-      getEditingValue: () => editingValueRef.current,
-      setEditingCell: (ec) => setEditingCell(ec),
-      setEditingValue: (ev) => setEditingValue(ev),
-      findRowById: (rowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), rowId),
-      findColumnByName: (columnName) => visibleColumnsRef.current.find((c) => c.name === columnName),
-      parseEditedValue: (column, value, oldValue) => parseGridEditedValue(column, value, oldValue),
-      setCellValue: (rowEntity, column, value) => {
-        const fieldPath = column.editModelField ?? column.field ?? column.name;
-        setPathValue(rowEntity, fieldPath, value);
+  const toggleTreeRowByRefFn = useCallback(
+    (row) => {
+      const rowId = coreResolveGridRowId(optionsRef.current, row);
+      toggleGridTreeRowCommand(
+        gridApiRef.current,
+        expandedTreeRowsRef.current,
+        rowId,
+        (e) => setExpandedTreeRows(e),
+        (resolvedRowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), resolvedRowId)
+      );
+    },
+    [buildRowsFromData]
+  );
+  const expandTreeRowByRefFn = useCallback(
+    (row) => {
+      const rowId = coreResolveGridRowId(optionsRef.current, row);
+      setGridTreeRowExpandedCommand(
+        gridApiRef.current,
+        expandedTreeRowsRef.current,
+        rowId,
+        true,
+        (e) => setExpandedTreeRows(e),
+        (resolvedRowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), resolvedRowId)
+      );
+    },
+    [buildRowsFromData]
+  );
+  const collapseTreeRowByRefFn = useCallback(
+    (row) => {
+      const rowId = coreResolveGridRowId(optionsRef.current, row);
+      setGridTreeRowExpandedCommand(
+        gridApiRef.current,
+        expandedTreeRowsRef.current,
+        rowId,
+        false,
+        (e) => setExpandedTreeRows(e),
+        (resolvedRowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), resolvedRowId)
+      );
+    },
+    [buildRowsFromData]
+  );
+  const startCellEditFn = useCallback(
+    (row, column, triggerEvent, initialValue) => {
+      const currentValue = getCellValue2(row.entity, column);
+      const focusToken = ++editorFocusTokenRef.current;
+      const ec = beginGridCellEditCommand(
+        gridApiRef.current,
+        {
+          setFocusedCell: (fc) => setFocusedCell(fc),
+          setEditingCell: (ec2) => setEditingCell(ec2),
+          setEditingValue: (ev) => setEditingValue(ev)
+        },
+        row,
+        column,
+        currentValue,
+        triggerEvent,
+        initialValue
+      );
+      if (ec) {
+        queueMicrotask(() => focusEditorInput(focusToken));
       }
-    });
-    if (!result.committed || !result.row || !result.column || !result.focusTarget) return;
-    editorFocusTokenRef.current += 1;
-    if (direction) {
-      const moved = moveFocusFn(result.row, result.column, direction);
-      if (!moved) focusRenderedCell(result.focusTarget);
-    } else if (restoreFocus) {
-      focusRenderedCell(result.focusTarget);
-    }
-  }, [buildRowsFromData, focusRenderedCell]);
+    },
+    [focusEditorInput]
+  );
+  const commitCellEditFn = useCallback(
+    (direction, restoreFocus = true) => {
+      const result = commitGridCellEditCommand(gridApiRef.current, {
+        getEditingCell: () => editingCellRef.current,
+        getEditingValue: () => editingValueRef.current,
+        setEditingCell: (ec) => setEditingCell(ec),
+        setEditingValue: (ev) => setEditingValue(ev),
+        findRowById: (rowId) => coreFindGridRowById(buildRowsFromData(optionsRef.current.data), rowId),
+        findColumnByName: (columnName) => visibleColumnsRef.current.find((c) => c.name === columnName),
+        parseEditedValue: (column, value, oldValue) => parseGridEditedValue(column, value, oldValue),
+        setCellValue: (rowEntity, column, value) => {
+          const fieldPath = column.editModelField ?? column.field ?? column.name;
+          setPathValue(rowEntity, fieldPath, value);
+        }
+      });
+      if (!result.committed || !result.row || !result.column || !result.focusTarget) return;
+      editorFocusTokenRef.current += 1;
+      if (direction) {
+        const moved = moveFocusFn(result.row, result.column, direction);
+        if (!moved) focusRenderedCell(result.focusTarget);
+      } else if (restoreFocus) {
+        focusRenderedCell(result.focusTarget);
+      }
+    },
+    [buildRowsFromData, focusRenderedCell]
+  );
   const cancelCellEditFn = useCallback(() => {
     const hadEditingCell = editingCellRef.current !== null;
     const result = cancelGridCellEditCommand(gridApiRef.current, {
@@ -1119,26 +1381,32 @@ function useGridState(options, onRegisterApi) {
     editorFocusTokenRef.current += 1;
     if (result.focusTarget) focusRenderedCell(result.focusTarget);
   }, [buildRowsFromData, focusRenderedCell]);
-  const moveFocusFn = useCallback((row, column, direction, triggerEvent) => {
-    const nextCell = findNextGridCell({
-      rows: pipelineRef.current.visibleRows,
-      columns: visibleColumnsRef.current,
-      rowId: row.id,
-      columnName: column.name,
-      direction
-    });
-    if (!nextCell) return false;
-    setFocusedCell({ rowId: nextCell.row.id, columnName: nextCell.column.name });
-    focusRenderedCell({ rowId: nextCell.row.id, columnName: nextCell.column.name });
-    if (shouldEditOnFocusFn(nextCell.column) && isCellEditable(nextCell.row, nextCell.column, triggerEvent)) {
-      startCellEditFn(nextCell.row, nextCell.column, triggerEvent);
-    }
-    return true;
-  }, [focusRenderedCell, isCellEditable, shouldEditOnFocusFn, startCellEditFn]);
+  const moveFocusFn = useCallback(
+    (row, column, direction, triggerEvent) => {
+      const nextCell = findNextGridCell({
+        rows: pipelineRef.current.visibleRows,
+        columns: visibleColumnsRef.current,
+        rowId: row.id,
+        columnName: column.name,
+        direction
+      });
+      if (!nextCell) return false;
+      setFocusedCell({ rowId: nextCell.row.id, columnName: nextCell.column.name });
+      focusRenderedCell({ rowId: nextCell.row.id, columnName: nextCell.column.name });
+      if (shouldEditOnFocusFn(nextCell.column) && isCellEditable(nextCell.row, nextCell.column, triggerEvent)) {
+        startCellEditFn(nextCell.row, nextCell.column, triggerEvent);
+      }
+      return true;
+    },
+    [focusRenderedCell, isCellEditable, shouldEditOnFocusFn, startCellEditFn]
+  );
   const runBenchmarkFn = useCallback((iterations) => {
-    const safeIterations = Math.max(1, iterations ?? optionsRef.current.benchmark?.iterations ?? 25);
+    const safeIterations = resolveBenchmarkIterations(
+      iterations,
+      optionsRef.current.benchmark?.iterations
+    );
     const startedAt = performance.now();
-    let lastResult = buildGridPipeline({
+    let lastResult = defaultGridEngine.buildPipeline({
       options: optionsRef.current,
       columns: visibleColumnsRef.current,
       activeFilters: activeFiltersRef.current,
@@ -1153,7 +1421,7 @@ function useGridState(options, onRegisterApi) {
       rowSize: optionsRef.current.rowHeight ?? 44
     });
     for (let i = 1; i < safeIterations; i++) {
-      lastResult = buildGridPipeline({
+      lastResult = defaultGridEngine.buildPipeline({
         options: optionsRef.current,
         columns: visibleColumnsRef.current,
         activeFilters: activeFiltersRef.current,
@@ -1199,6 +1467,7 @@ function useGridState(options, onRegisterApi) {
     setExpandedTreeRows({});
     setColumnOrder(options.columnDefs.map((column) => column.name));
     setGroupByColumns(options.grouping?.groupBy ?? []);
+    setPinnedColumns(buildInitialPinnedState(options.columnDefs));
     setCurrentPage(options.paginationCurrentPage ?? 1);
     setPageSize(coreGetEffectivePageSize(options, 0, options.data.length));
     setInfiniteScrollState({
@@ -1231,8 +1500,15 @@ function useGridState(options, onRegisterApi) {
     const container = gridContainerRef.current;
     if (!container) return;
     const observer = observeGridHostSize(container, ({ height: nextHeight, width: nextWidth }) => {
-      if (nextHeight === lastGridHeightRef.current && nextWidth === lastGridWidthRef.current) return;
-      raiseGridDimensionChanged(gridApi, lastGridHeightRef.current, lastGridWidthRef.current, nextHeight, nextWidth);
+      if (nextHeight === lastGridHeightRef.current && nextWidth === lastGridWidthRef.current)
+        return;
+      raiseGridDimensionChanged(
+        gridApi,
+        lastGridHeightRef.current,
+        lastGridWidthRef.current,
+        nextHeight,
+        nextWidth
+      );
       lastGridHeightRef.current = nextHeight;
       lastGridWidthRef.current = nextWidth;
       if (!options.viewportHeight && nextHeight > 0) {
@@ -1250,42 +1526,75 @@ function useGridState(options, onRegisterApi) {
   const paginationCurrentPage = getCurrentPageValueFn();
   const paginationTotalPages = getTotalPagesValueFn();
   const paginationSelectedPageSize = effectivePageSizeFn(pipeline.totalItems);
-  const viewportHeightPx = `${options.viewportHeight ?? autoViewportHeight ?? 560}px`;
+  const viewportHeightPx = computeViewportHeightPx(options.viewportHeight, autoViewportHeight);
   const headerLabelFn = useCallback((column) => coreHeaderLabel(column), []);
-  const isGroupItemFn = useCallback((item) => item.kind === "group", []);
-  const isExpandableItemFn = useCallback((item) => item.kind === "expandable", []);
+  const isGroupItemFn = useCallback(
+    (item) => item.kind === "group",
+    []
+  );
+  const isExpandableItemFn = useCallback(
+    (item) => item.kind === "expandable",
+    []
+  );
   const isRowItemFn = useCallback((item) => item.kind === "row", []);
-  const isOddStripedRowFn = useCallback((item) => item.kind === "row" && item.visibleIndex % 2 === 0, []);
+  const isOddStripedRowFn = useCallback(
+    (item) => item.kind === "row" && item.visibleIndex % 2 === 0,
+    []
+  );
   const sortDirectionFn = useCallback((column) => {
     return sortStateRef.current.columnName === column.name ? sortStateRef.current.direction : SORT_DIRECTIONS2.none;
   }, []);
-  const sortButtonLabelFn = useCallback((column) => {
-    return gridSortButtonLabel(sortDirectionFn(column), labels);
-  }, [labels, sortDirectionFn]);
-  const sortAriaSortFn = useCallback((column) => {
-    return gridSortAriaSort(sortDirectionFn(column));
-  }, [sortDirectionFn]);
-  const groupingButtonLabelFn = useCallback((column) => {
-    return gridGroupingButtonLabel(isGridColumnGrouped(groupByColumnsRef.current, column), labels);
-  }, [labels]);
+  const sortButtonLabelFn = useCallback(
+    (column) => {
+      return gridSortButtonLabel(sortDirectionFn(column), labels);
+    },
+    [labels, sortDirectionFn]
+  );
+  const sortAriaSortFn = useCallback(
+    (column) => {
+      return gridSortAriaSort(sortDirectionFn(column));
+    },
+    [sortDirectionFn]
+  );
+  const groupingButtonLabelFn = useCallback(
+    (column) => {
+      return gridGroupingButtonLabel(
+        isGridColumnGrouped(groupByColumnsRef.current, column),
+        labels
+      );
+    },
+    [labels]
+  );
   const filterValueFn = useCallback((columnName) => {
     return activeFiltersRef.current[columnName] ?? "";
   }, []);
-  const filterPlaceholderFn = useCallback((column) => {
-    return gridFilterPlaceholder(isGridColumnFilterable(optionsRef.current, column), labels);
-  }, [labels]);
+  const filterPlaceholderFn = useCallback(
+    (column) => {
+      return gridFilterPlaceholder(isGridColumnFilterable(optionsRef.current, column), labels);
+    },
+    [labels]
+  );
   const isFilterInputDisabledFn = useCallback((column) => {
     return !isGridColumnFilterable(optionsRef.current, column);
   }, []);
-  const groupDisclosureLabelFn = useCallback((item) => {
-    return gridGroupDisclosureLabel(item.collapsed, labels);
-  }, [labels]);
-  const cellContextFn = useCallback((row, column) => {
-    return buildGridCellContext(row, column);
-  }, []);
-  const displayValueFn = useCallback((row, column) => {
-    return formatGridCellDisplayValue(cellContextFn(row, column));
-  }, [cellContextFn]);
+  const groupDisclosureLabelFn = useCallback(
+    (item) => {
+      return gridGroupDisclosureLabel(item.collapsed, labels);
+    },
+    [labels]
+  );
+  const cellContextFn = useCallback(
+    (row, column) => {
+      return buildGridCellContext(row, column);
+    },
+    []
+  );
+  const displayValueFn = useCallback(
+    (row, column) => {
+      return formatGridCellDisplayValue(cellContextFn(row, column));
+    },
+    [cellContextFn]
+  );
   const isFocusedCellFn = useCallback((row, column) => {
     return isGridCellPosition(focusedCellRef.current, row.id, column.name);
   }, []);
@@ -1295,16 +1604,19 @@ function useGridState(options, onRegisterApi) {
   const editorInputTypeFn = useCallback((column) => {
     return gridEditorInputType(column);
   }, []);
-  const expandedContextFn = useCallback((row) => {
-    return {
-      $implicit: row.entity,
-      row: row.entity,
-      rowIndex: row.index,
-      expanded: true,
-      ...optionsRef.current.expandableRowScope ?? {}
-    };
-  }, []);
-  const columnWidthFn = useCallback((column) => gridColumnWidth(column), []);
+  const expandedContextFn = useCallback(
+    (row) => {
+      return {
+        $implicit: row.entity,
+        row: row.entity,
+        rowIndex: row.index,
+        expanded: true,
+        ...optionsRef.current.expandableRowScope ?? {}
+      };
+    },
+    []
+  );
+  const columnWidthFn = useCallback((column) => gridColumnWidth2(column), []);
   const isColumnSortableFn = useCallback((column) => {
     return isGridColumnSortable(optionsRef.current, column);
   }, []);
@@ -1314,15 +1626,21 @@ function useGridState(options, onRegisterApi) {
   const cellIndentFn = useCallback((row, column) => {
     return gridCellIndent(optionsRef.current, visibleColumnsRef.current, row, column);
   }, []);
-  const treeToggleLabelFn = useCallback((row) => {
-    return gridTreeToggleLabelForRow(expandedTreeRowsRef.current, row, labels);
-  }, [labels]);
+  const treeToggleLabelFn = useCallback(
+    (row) => {
+      return gridTreeToggleLabelForRow(expandedTreeRowsRef.current, row, labels);
+    },
+    [labels]
+  );
   const isTreeRowExpandedFn = useCallback((row) => {
     return isGridTreeRowExpanded(expandedTreeRowsRef.current, row);
   }, []);
-  const expandToggleLabelFn = useCallback((row) => {
-    return gridExpandToggleLabelForRow(row, labels);
-  }, [labels]);
+  const expandToggleLabelFn = useCallback(
+    (row) => {
+      return gridExpandToggleLabelForRow(row, labels);
+    },
+    [labels]
+  );
   const isGroupedFn = useCallback((column) => {
     return isGridColumnGrouped(groupByColumnsRef.current, column);
   }, []);
@@ -1337,8 +1655,7 @@ function useGridState(options, onRegisterApi) {
   }, []);
   const paginationSummaryFn = useCallback(() => {
     const ti = pipelineRef.current.totalItems;
-    if (ti === 0) return "0-0 of 0";
-    return `${getFirstRowIndexValueFn(ti) + 1}-${getLastRowIndexValueFn(ti) + 1} of ${ti}`;
+    return formatPaginationSummary(ti, getFirstRowIndexValueFn(ti), getLastRowIndexValueFn(ti));
   }, [getFirstRowIndexValueFn, getLastRowIndexValueFn]);
   const pageSizeOptionsFn = useCallback(() => {
     return optionsRef.current.paginationPageSizes ?? [];
@@ -1385,108 +1702,130 @@ function useGridState(options, onRegisterApi) {
       [item.id]: !current[item.id]
     }));
   }, []);
-  const focusCellFn = useCallback((row, column, triggerEvent) => {
-    const nextFocusResult = buildGridFocusCellResult({
-      currentFocusedCell: focusedCellRef.current,
-      currentEditingCell: editingCellRef.current,
-      rowId: row.id,
-      columnName: column.name,
-      shouldEditOnFocus: shouldEditOnFocusFn(column),
-      isCellEditable: isCellEditable(row, column, triggerEvent)
-    });
-    setFocusedCell(nextFocusResult.focusedCell);
-    if (nextFocusResult.shouldBeginEdit) {
-      startCellEditFn(row, column, triggerEvent);
-    }
-  }, [isCellEditable, shouldEditOnFocusFn, startCellEditFn]);
-  const handleCellKeyDownFn = useCallback((row, column, event) => {
-    focusCellFn(row, column, event.nativeEvent);
-    switch (event.key) {
-      case "ArrowLeft":
-        event.preventDefault();
-        moveFocusFn(row, column, "left", event.nativeEvent);
-        return;
-      case "ArrowRight":
-        event.preventDefault();
-        moveFocusFn(row, column, "right", event.nativeEvent);
-        return;
-      case "ArrowUp":
-        event.preventDefault();
-        moveFocusFn(row, column, "up", event.nativeEvent);
-        return;
-      case "ArrowDown":
+  const focusCellFn = useCallback(
+    (row, column, triggerEvent) => {
+      const nextFocusResult = buildGridFocusCellResult({
+        currentFocusedCell: focusedCellRef.current,
+        currentEditingCell: editingCellRef.current,
+        rowId: row.id,
+        columnName: column.name,
+        shouldEditOnFocus: shouldEditOnFocusFn(column),
+        isCellEditable: isCellEditable(row, column, triggerEvent)
+      });
+      setFocusedCell(nextFocusResult.focusedCell);
+      if (nextFocusResult.shouldBeginEdit) {
+        startCellEditFn(row, column, triggerEvent);
+      }
+    },
+    [isCellEditable, shouldEditOnFocusFn, startCellEditFn]
+  );
+  const handleCellKeyDownFn = useCallback(
+    (row, column, event) => {
+      focusCellFn(row, column, event.nativeEvent);
+      switch (event.key) {
+        case "ArrowLeft":
+          event.preventDefault();
+          moveFocusFn(row, column, "left", event.nativeEvent);
+          return;
+        case "ArrowRight":
+          event.preventDefault();
+          moveFocusFn(row, column, "right", event.nativeEvent);
+          return;
+        case "ArrowUp":
+          event.preventDefault();
+          moveFocusFn(row, column, "up", event.nativeEvent);
+          return;
+        case "ArrowDown":
+          event.preventDefault();
+          moveFocusFn(row, column, "down", event.nativeEvent);
+          return;
+        case "Tab":
+          event.preventDefault();
+          moveFocusFn(row, column, event.shiftKey ? "left" : "right", event.nativeEvent);
+          return;
+        case "Enter":
+          event.preventDefault();
+          moveFocusFn(row, column, event.shiftKey ? "up" : "down", event.nativeEvent);
+          return;
+        case "F2":
+          event.preventDefault();
+          if (isCellEditable(row, column, event.nativeEvent)) {
+            startCellEditFn(row, column, event.nativeEvent);
+          }
+          return;
+        case "Backspace":
+        case "Delete":
+          if (isCellEditable(row, column, event.nativeEvent)) {
+            event.preventDefault();
+            startCellEditFn(row, column, event.nativeEvent, "");
+          }
+          return;
+        default:
+          break;
+      }
+      if (isPrintableGridKey(event.key, event.ctrlKey, event.metaKey, event.altKey) && isCellEditable(row, column, event.nativeEvent)) {
         event.preventDefault();
-        moveFocusFn(row, column, "down", event.nativeEvent);
-        return;
-      case "Tab":
+        startCellEditFn(row, column, event.nativeEvent, event.key);
+      }
+    },
+    [focusCellFn, moveFocusFn, isCellEditable, startCellEditFn]
+  );
+  const handleCellDoubleClickFn = useCallback(
+    (row, column, event) => {
+      focusCellFn(row, column, event.nativeEvent);
+      if (isCellEditable(row, column, event.nativeEvent)) {
+        startCellEditFn(row, column, event.nativeEvent);
+      }
+    },
+    [focusCellFn, isCellEditable, startCellEditFn]
+  );
+  const updateEditingValueFn = useCallback((value) => {
+    setEditingValue(value);
+  }, []);
+  const handleEditorKeyDownFn = useCallback(
+    (event) => {
+      if (event.key === "Escape") {
         event.preventDefault();
-        moveFocusFn(row, column, event.shiftKey ? "left" : "right", event.nativeEvent);
+        cancelCellEditFn();
         return;
-      case "Enter":
+      }
+      if (event.key === "Enter") {
         event.preventDefault();
-        moveFocusFn(row, column, event.shiftKey ? "up" : "down", event.nativeEvent);
+        commitCellEditFn(event.shiftKey ? "up" : "down");
         return;
-      case "F2":
+      }
+      if (event.key === "Tab") {
         event.preventDefault();
-        if (isCellEditable(row, column, event.nativeEvent)) {
-          startCellEditFn(row, column, event.nativeEvent);
-        }
-        return;
-      case "Backspace":
-      case "Delete":
-        if (isCellEditable(row, column, event.nativeEvent)) {
-          event.preventDefault();
-          startCellEditFn(row, column, event.nativeEvent, "");
-        }
+        commitCellEditFn(event.shiftKey ? "left" : "right");
+      }
+    },
+    [cancelCellEditFn, commitCellEditFn]
+  );
+  const handleEditorBlurFn = useCallback(
+    (event) => {
+      const ec = editingCellRef.current;
+      const target = event.target;
+      if (!ec || !target) return;
+      if (target.dataset["rowId"] !== ec.rowId || target.dataset["colName"] !== ec.columnName)
         return;
-      default:
-        break;
-    }
-    if (isPrintableGridKey(event.key, event.ctrlKey, event.metaKey, event.altKey) && isCellEditable(row, column, event.nativeEvent)) {
-      event.preventDefault();
-      startCellEditFn(row, column, event.nativeEvent, event.key);
-    }
-  }, [focusCellFn, moveFocusFn, isCellEditable, startCellEditFn]);
-  const handleCellDoubleClickFn = useCallback((row, column, event) => {
-    focusCellFn(row, column, event.nativeEvent);
-    if (isCellEditable(row, column, event.nativeEvent)) {
-      startCellEditFn(row, column, event.nativeEvent);
-    }
-  }, [focusCellFn, isCellEditable, startCellEditFn]);
-  const updateEditingValueFn = useCallback((value) => {
-    setEditingValue(value);
-  }, []);
-  const handleEditorKeyDownFn = useCallback((event) => {
-    if (event.key === "Escape") {
-      event.preventDefault();
-      cancelCellEditFn();
-      return;
-    }
-    if (event.key === "Enter") {
-      event.preventDefault();
-      commitCellEditFn(event.shiftKey ? "up" : "down");
-      return;
-    }
-    if (event.key === "Tab") {
-      event.preventDefault();
-      commitCellEditFn(event.shiftKey ? "left" : "right");
-    }
-  }, [cancelCellEditFn, commitCellEditFn]);
-  const handleEditorBlurFn = useCallback((event) => {
-    const ec = editingCellRef.current;
-    const target = event.target;
-    if (!ec || !target) return;
-    if (target.dataset["rowId"] !== ec.rowId || target.dataset["colName"] !== ec.columnName) return;
-    commitCellEditFn(void 0, false);
-  }, [commitCellEditFn]);
-  const toggleRowExpansionFn = useCallback((row, event) => {
-    event?.stopPropagation();
-    toggleRowExpansionByRefFn(row);
-  }, [toggleRowExpansionByRefFn]);
-  const toggleTreeRowFn = useCallback((row, event) => {
-    event?.stopPropagation();
-    toggleTreeRowByRefFn(row);
-  }, [toggleTreeRowByRefFn]);
+      commitCellEditFn(void 0, false);
+    },
+    [commitCellEditFn]
+  );
+  const toggleRowExpansionFn = useCallback(
+    (row, event) => {
+      event?.stopPropagation();
+      toggleRowExpansionByRefFn(row);
+    },
+    [toggleRowExpansionByRefFn]
+  );
+  const toggleTreeRowFn = useCallback(
+    (row, event) => {
+      event?.stopPropagation();
+      toggleTreeRowByRefFn(row);
+    },
+    [toggleTreeRowByRefFn]
+  );
   const moveColumnFn = useCallback((fromIndex, toIndex) => {
     moveGridColumnCommand(
       gridApiRef.current,
@@ -1502,9 +1841,12 @@ function useGridState(options, onRegisterApi) {
   const previousPageFn = useCallback(() => {
     seekPageFn(getCurrentPageValueFn() - 1);
   }, [seekPageFn, getCurrentPageValueFn]);
-  const onPageSizeChangeFn = useCallback((value) => {
-    setPaginationPageSizeFn(Number(value));
-  }, [setPaginationPageSizeFn]);
+  const onPageSizeChangeFn = useCallback(
+    (value) => {
+      setPaginationPageSizeFn(Number(value));
+    },
+    [setPaginationPageSizeFn]
+  );
   const onViewportScrollFn = useCallback((startIndex) => {
     if (!scrollingRef.current) {
       scrollingRef.current = true;
@@ -1524,7 +1866,10 @@ function useGridState(options, onRegisterApi) {
       state: infiniteScrollStateRef.current,
       startIndex,
       visibleRows: pipelineRef.current.visibleRows.length,
-      viewportRows: Math.max(1, Math.ceil((optionsRef.current.viewportHeight ?? 560) / (optionsRef.current.rowHeight ?? 44))),
+      viewportRows: computeViewportRows(
+        optionsRef.current.viewportHeight,
+        optionsRef.current.rowHeight
+      ),
       threshold: optionsRef.current.infiniteScrollRowsFromEnd ?? 20,
       setState: (state) => setInfiniteScrollState(state)
     });
@@ -1624,29 +1969,60 @@ function useGridState(options, onRegisterApi) {
     onPageSizeChange: onPageSizeChangeFn,
     runBenchmark: runBenchmarkFn,
     exportCsv: exportCsvFn,
-    onViewportScroll: onViewportScrollFn
+    onViewportScroll: onViewportScrollFn,
+    // Pinning
+    isPinned: isPinnedFn,
+    pinnedOffset: pinnedOffsetFn,
+    isPinningEnabled: isPinningEnabledFn,
+    isColumnPinnable: isColumnPinnableFn,
+    togglePin: togglePinFn,
+    pinningFeature: FEATURE_PINNING
   };
 }
 
 // src/useVirtualScroll.ts
 import { useCallback as useCallback2, useRef as useRef2, useState as useState2 } from "react";
+
+// src/virtualScrollMath.ts
+function calculateVirtualWindow(request) {
+  const overscan = request.overscan ?? 3;
+  if (request.itemCount <= 0 || request.itemSize <= 0) {
+    return {
+      visibleRange: { start: 0, end: 0 },
+      totalHeight: Math.max(0, request.itemCount) * Math.max(0, request.itemSize),
+      offsetY: 0
+    };
+  }
+  const rawStart = Math.floor(request.scrollTop / request.itemSize) - overscan;
+  const start = Math.max(0, rawStart);
+  const rawEnd = rawStart + Math.ceil(request.viewportHeight / request.itemSize) + 2 * overscan;
+  const end = Math.min(request.itemCount, rawEnd);
+  return {
+    visibleRange: { start, end },
+    totalHeight: request.itemCount * request.itemSize,
+    offsetY: start * request.itemSize
+  };
+}
+
+// src/useVirtualScroll.ts
 function useVirtualScroll(options) {
   const { itemCount, itemSize, viewportHeight, overscan = 3 } = options;
   const [scrollTop, setScrollTop] = useState2(0);
   const viewportRef = useRef2(null);
-  const rawStart = Math.floor(scrollTop / itemSize) - overscan;
-  const start = Math.max(0, rawStart);
-  const rawEnd = rawStart + Math.ceil(viewportHeight / itemSize) + 2 * overscan;
-  const end = Math.min(itemCount, rawEnd);
-  const totalHeight = itemCount * itemSize;
-  const offsetY = start * itemSize;
+  const virtualWindow = calculateVirtualWindow({
+    itemCount,
+    itemSize,
+    viewportHeight,
+    overscan,
+    scrollTop
+  });
   const onScroll = useCallback2((event) => {
     setScrollTop(event.currentTarget.scrollTop);
   }, []);
   return {
-    visibleRange: { start, end },
-    totalHeight,
-    offsetY,
+    visibleRange: virtualWindow.visibleRange,
+    totalHeight: virtualWindow.totalHeight,
+    offsetY: virtualWindow.offsetY,
     onScroll,
     viewportRef,
     scrollTop
@@ -1655,7 +2031,13 @@ function useVirtualScroll(options) {
 
 // src/UiGrid.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
-function UiGrid({ options, onRegisterApi, cellRenderer, expandableRenderer, className }) {
+function UiGrid({
+  options,
+  onRegisterApi,
+  cellRenderer,
+  expandableRenderer,
+  className
+}) {
   const state = useGridState(options, onRegisterApi);
   const {
     pipeline,
@@ -1719,7 +2101,16 @@ function UiGrid({ options, onRegisterApi, cellRenderer, expandableRenderer, clas
               " ",
               labels.groupRowsSuffix
             ] }),
-            /* @__PURE__ */ jsx("svg", { className: "toggle-icon group-disclosure-icon", viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: item.collapsed ? "M10 7l5 5-5 5z" : "M7 10l5 5 5-5z" }) }),
+            /* @__PURE__ */ jsx(
+              "svg",
+              {
+                className: "toggle-icon group-disclosure-icon",
+                viewBox: "0 0 24 24",
+                "aria-hidden": "true",
+                focusable: false,
+                children: /* @__PURE__ */ jsx("path", { d: item.collapsed ? "M10 7l5 5-5 5z" : "M7 10l5 5 5-5z" })
+              }
+            ),
             /* @__PURE__ */ jsx("span", { className: "sr-only ui-grid-sr-only", children: state.groupDisclosureLabel(item) })
           ]
         },
@@ -1741,62 +2132,84 @@ function UiGrid({ options, onRegisterApi, cellRenderer, expandableRenderer, clas
     }
     if (item.kind !== "row") return null;
     const rowItem = item;
-    return visibleColumns.map((column) => /* @__PURE__ */ jsx(
-      "div",
-      {
-        className: cellClassName(rowItem, column),
-        "data-part": "body-cell",
-        role: "gridcell",
-        tabIndex: 0,
-        "data-row-id": rowItem.row.id,
-        "data-col-name": column.name,
-        onFocus: () => state.focusCell(rowItem.row, column),
-        onClick: () => state.focusCell(rowItem.row, column),
-        onDoubleClick: (e) => state.handleCellDoubleClick(rowItem.row, column, e),
-        onKeyDown: (e) => state.handleCellKeyDown(rowItem.row, column, e),
-        children: /* @__PURE__ */ jsxs("div", { className: "cell-shell", style: { paddingInlineStart: state.cellIndent(rowItem.row, column) }, children: [
-          treeViewFeature && state.showTreeToggle(rowItem.row, column) && /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              className: "row-toggle row-toggle-tree",
-              "data-part": "tree-toggle",
-              "aria-label": state.treeToggleLabel(rowItem.row),
-              "aria-expanded": state.isTreeRowExpanded(rowItem.row),
-              onClick: (e) => state.toggleTreeRow(rowItem.row, e),
-              children: /* @__PURE__ */ jsx("svg", { className: "toggle-icon", viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: state.isTreeRowExpanded(rowItem.row) ? "M7 10l5 5 5-5z" : "M10 7l5 5-5 5z" }) })
-            }
-          ),
-          expandableFeature && state.showExpandToggle(rowItem.row, column) && /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              className: "row-toggle row-toggle-expand",
-              "data-part": "expand-toggle",
-              "aria-label": state.expandToggleLabel(rowItem.row),
-              "aria-expanded": rowItem.row.expanded,
-              onClick: (e) => state.toggleRowExpansion(rowItem.row, e),
-              children: /* @__PURE__ */ jsx("svg", { className: "toggle-icon", viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: rowItem.row.expanded ? "M7 10l5 5 5-5z" : "M10 7l5 5-5 5z" }) })
-            }
-          ),
-          /* @__PURE__ */ jsx("span", { className: "cell-value", children: cellEditFeature && state.isEditingCell(rowItem.row, column) ? /* @__PURE__ */ jsx(
-            "input",
+    return visibleColumns.map((column) => {
+      const pinned = state.isPinned(column);
+      const pinOffset = pinned ? state.pinnedOffset(column) : null;
+      return /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: `${cellClassName(rowItem, column)}${pinned ? " is-pinned" : ""}`,
+          "data-part": "body-cell",
+          role: "gridcell",
+          tabIndex: 0,
+          "data-row-id": rowItem.row.id,
+          "data-col-name": column.name,
+          onFocus: () => state.focusCell(rowItem.row, column),
+          onClick: () => state.focusCell(rowItem.row, column),
+          onDoubleClick: (e) => state.handleCellDoubleClick(rowItem.row, column, e),
+          onKeyDown: (e) => state.handleCellKeyDown(rowItem.row, column, e),
+          style: {
+            position: pinned ? "sticky" : void 0,
+            left: pinOffset?.side === "left" ? pinOffset.offset : void 0,
+            right: pinOffset?.side === "right" ? pinOffset.offset : void 0,
+            zIndex: pinned ? 2 : void 0
+          },
+          children: /* @__PURE__ */ jsxs(
+            "div",
             {
-              className: "cell-editor",
-              "data-row-id": rowItem.row.id,
-              "data-col-name": column.name,
-              "aria-label": state.headerLabel(column),
-              type: state.editorInputType(column),
-              defaultValue: editingValue,
-              onChange: (e) => state.updateEditingValue(e.target.value),
-              onKeyDown: (e) => state.handleEditorKeyDown(e),
-              onBlur: (e) => state.handleEditorBlur(e)
+              className: "cell-shell",
+              style: { paddingInlineStart: state.cellIndent(rowItem.row, column) },
+              children: [
+                treeViewFeature && state.showTreeToggle(rowItem.row, column) && /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: "row-toggle row-toggle-tree",
+                    "data-part": "tree-toggle",
+                    "aria-label": state.treeToggleLabel(rowItem.row),
+                    "aria-expanded": state.isTreeRowExpanded(rowItem.row),
+                    onClick: (e) => state.toggleTreeRow(rowItem.row, e),
+                    children: /* @__PURE__ */ jsx("svg", { className: "toggle-icon", viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx(
+                      "path",
+                      {
+                        d: state.isTreeRowExpanded(rowItem.row) ? "M7 10l5 5 5-5z" : "M10 7l5 5-5 5z"
+                      }
+                    ) })
+                  }
+                ),
+                expandableFeature && state.showExpandToggle(rowItem.row, column) && /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: "row-toggle row-toggle-expand",
+                    "data-part": "expand-toggle",
+                    "aria-label": state.expandToggleLabel(rowItem.row),
+                    "aria-expanded": rowItem.row.expanded,
+                    onClick: (e) => state.toggleRowExpansion(rowItem.row, e),
+                    children: /* @__PURE__ */ jsx("svg", { className: "toggle-icon", viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: rowItem.row.expanded ? "M7 10l5 5 5-5z" : "M10 7l5 5-5 5z" }) })
+                  }
+                ),
+                /* @__PURE__ */ jsx("span", { className: "cell-value", children: cellEditFeature && state.isEditingCell(rowItem.row, column) ? /* @__PURE__ */ jsx(
+                  "input",
+                  {
+                    className: "cell-editor",
+                    "data-row-id": rowItem.row.id,
+                    "data-col-name": column.name,
+                    "aria-label": state.headerLabel(column),
+                    type: state.editorInputType(column),
+                    defaultValue: editingValue,
+                    onChange: (e) => state.updateEditingValue(e.target.value),
+                    onKeyDown: (e) => state.handleEditorKeyDown(e),
+                    onBlur: (e) => state.handleEditorBlur(e)
+                  }
+                ) : cellRenderer ? cellRenderer(state.cellContext(rowItem.row, column)) ?? state.displayValue(rowItem.row, column) : state.displayValue(rowItem.row, column) })
+              ]
             }
-          ) : cellRenderer ? cellRenderer(state.cellContext(rowItem.row, column)) ?? state.displayValue(rowItem.row, column) : state.displayValue(rowItem.row, column) })
-        ] })
-      },
-      `${rowItem.row.id}-${column.name}`
-    ));
+          )
+        },
+        `${rowItem.row.id}-${column.name}`
+      );
+    });
   }
   function cellClassName(item, column) {
     const classes = ["body-cell", "ui-grid-cell"];
@@ -1826,225 +2239,364 @@ function UiGrid({ options, onRegisterApi, cellRenderer, expandableRenderer, clas
         /* @__PURE__ */ jsx("p", { className: "deck", children: "Familiar `gridOptions` and `onRegisterApi`, built with React hooks, virtualization, grouping, sorting, filtering, and column ordering." })
       ] }),
       /* @__PURE__ */ jsxs("div", { className: "hero-actions", children: [
-        /* @__PURE__ */ jsx("button", { type: "button", className: "action action-secondary", "data-part": "action benchmark-action", onClick: () => state.runBenchmark(), children: "Benchmark" }),
-        csvExportFeature && /* @__PURE__ */ jsx("button", { type: "button", className: "action action-secondary", "data-part": "action export-action", onClick: () => state.exportCsv(), children: "Export CSV" }),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: "action action-secondary",
+            "data-part": "action benchmark-action",
+            onClick: () => state.runBenchmark(),
+            children: "Benchmark"
+          }
+        ),
+        csvExportFeature && /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: "action action-secondary",
+            "data-part": "action export-action",
+            onClick: () => state.exportCsv(),
+            children: "Export CSV"
+          }
+        ),
         /* @__PURE__ */ jsxs("div", { className: "stats-card", "data-part": "stats-card", children: [
           /* @__PURE__ */ jsx("span", { children: visibleRowCount }),
           /* @__PURE__ */ jsx("small", { children: labels.statsVisibleRows })
         ] })
       ] })
     ] }),
-    /* @__PURE__ */ jsxs("section", { className: "metrics-strip", "data-part": "metrics", "aria-label": "Grid performance metrics", children: [
-      /* @__PURE__ */ jsxs("article", { "data-part": "metric-card", children: [
-        /* @__PURE__ */ jsxs("strong", { children: [
-          pipelineMs.toFixed(2),
-          " ms"
-        ] }),
-        /* @__PURE__ */ jsx("span", { children: "pipeline" })
-      ] }),
-      /* @__PURE__ */ jsxs("article", { "data-part": "metric-card", children: [
-        /* @__PURE__ */ jsx("strong", { children: virtualizationEnabled ? "On" : "Off" }),
-        /* @__PURE__ */ jsx("span", { children: "virtualization" })
-      ] }),
-      /* @__PURE__ */ jsxs("article", { "data-part": "metric-card", children: [
-        /* @__PURE__ */ jsx("strong", { children: state.groupByColumns.length }),
-        /* @__PURE__ */ jsx("span", { children: "group columns" })
-      ] }),
-      /* @__PURE__ */ jsxs("article", { "data-part": "metric-card", children: [
-        /* @__PURE__ */ jsx("strong", { children: benchmarkResult?.averageMs?.toFixed(2) || "\u2014" }),
-        /* @__PURE__ */ jsx("span", { children: "benchmark avg" })
-      ] })
-    ] }),
-    /* @__PURE__ */ jsxs("section", { className: "grid-frame ui-grid", "data-part": "grid-frame", role: "grid", "aria-label": options.title ?? "Data grid", children: [
-      /* @__PURE__ */ jsxs("div", { className: "grid-toolbar", "data-part": "grid-toolbar", children: [
-        /* @__PURE__ */ jsxs("div", { children: [
-          /* @__PURE__ */ jsx("strong", { children: visibleRowCount }),
-          /* @__PURE__ */ jsxs("span", { children: [
-            labels.toolbarOf,
-            " ",
-            totalRows,
-            " ",
-            labels.toolbarRows
+    /* @__PURE__ */ jsxs(
+      "section",
+      {
+        className: "metrics-strip",
+        "data-part": "metrics",
+        "aria-label": "Grid performance metrics",
+        children: [
+          /* @__PURE__ */ jsxs("article", { "data-part": "metric-card", children: [
+            /* @__PURE__ */ jsxs("strong", { children: [
+              pipelineMs.toFixed(2),
+              " ms"
+            ] }),
+            /* @__PURE__ */ jsx("span", { children: "pipeline" })
+          ] }),
+          /* @__PURE__ */ jsxs("article", { "data-part": "metric-card", children: [
+            /* @__PURE__ */ jsx("strong", { children: virtualizationEnabled ? "On" : "Off" }),
+            /* @__PURE__ */ jsx("span", { children: "virtualization" })
+          ] }),
+          /* @__PURE__ */ jsxs("article", { "data-part": "metric-card", children: [
+            /* @__PURE__ */ jsx("strong", { children: state.groupByColumns.length }),
+            /* @__PURE__ */ jsx("span", { children: "group columns" })
+          ] }),
+          /* @__PURE__ */ jsxs("article", { "data-part": "metric-card", children: [
+            /* @__PURE__ */ jsx("strong", { children: benchmarkResult?.averageMs?.toFixed(2) || "\u2014" }),
+            /* @__PURE__ */ jsx("span", { children: "benchmark avg" })
           ] })
-        ] }),
-        /* @__PURE__ */ jsx("p", { children: "`gridOptions` compatibility layer: sorting, filtering, grouping, column moving, templating, and virtualized rendering." })
-      ] }),
-      /* @__PURE__ */ jsxs("div", { className: "grid-table ui-grid-contents-wrapper", "data-part": "grid-table", children: [
-        /* @__PURE__ */ jsx(
-          "div",
-          {
-            className: "header-grid ui-grid-header ui-grid-header-canvas",
-            "data-part": "header",
-            role: "row",
-            style: { gridTemplateColumns },
-            children: visibleColumns.map((column) => /* @__PURE__ */ jsxs(
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsxs(
+      "section",
+      {
+        className: "grid-frame ui-grid",
+        "data-part": "grid-frame",
+        role: "grid",
+        "aria-label": options.title ?? "Data grid",
+        children: [
+          /* @__PURE__ */ jsxs("div", { className: "grid-toolbar", "data-part": "grid-toolbar", children: [
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("strong", { children: visibleRowCount }),
+              /* @__PURE__ */ jsxs("span", { children: [
+                labels.toolbarOf,
+                " ",
+                totalRows,
+                " ",
+                labels.toolbarRows
+              ] })
+            ] }),
+            /* @__PURE__ */ jsx("p", { children: "`gridOptions` compatibility layer: sorting, filtering, grouping, column moving, templating, and virtualized rendering." })
+          ] }),
+          /* @__PURE__ */ jsxs("div", { className: "grid-table ui-grid-contents-wrapper", "data-part": "grid-table", children: [
+            /* @__PURE__ */ jsx(
+              "div",
+              {
+                className: "header-grid ui-grid-header ui-grid-header-canvas",
+                "data-part": "header",
+                role: "row",
+                style: { gridTemplateColumns },
+                children: visibleColumns.map((column) => {
+                  const pinned = state.isPinned(column);
+                  const pinOffset = pinned ? state.pinnedOffset(column) : null;
+                  return /* @__PURE__ */ jsxs(
+                    "div",
+                    {
+                      className: `header-cell ui-grid-header-cell${sortingFeature && state.sortDirection(column) !== "none" ? " is-active" : ""}${pinned ? " is-pinned" : ""}`,
+                      "data-part": "header-cell",
+                      role: "columnheader",
+                      "aria-sort": sortingFeature ? state.sortAriaSort(column) : void 0,
+                      style: {
+                        position: pinned ? "sticky" : void 0,
+                        left: pinOffset?.side === "left" ? pinOffset.offset : void 0,
+                        right: pinOffset?.side === "right" ? pinOffset.offset : void 0,
+                        zIndex: pinned ? 2 : void 0
+                      },
+                      children: [
+                        /* @__PURE__ */ jsx("span", { className: "header-label", children: state.headerLabel(column) }),
+                        /* @__PURE__ */ jsxs("div", { className: "header-actions", children: [
+                          sortingFeature && /* @__PURE__ */ jsxs(
+                            "button",
+                            {
+                              type: "button",
+                              className: `header-action${!state.isColumnSortable(column) ? " header-action-disabled" : ""}`,
+                              disabled: !state.isColumnSortable(column),
+                              "aria-label": state.sortButtonLabel(column),
+                              title: state.sortButtonLabel(column),
+                              onClick: () => state.toggleSort(column),
+                              children: [
+                                renderSortIcon(column),
+                                /* @__PURE__ */ jsx("span", { className: "sr-only ui-grid-sr-only", children: state.sortButtonLabel(column) })
+                              ]
+                            }
+                          ),
+                          groupingFeature && state.isGroupingEnabled() && column.enableGrouping !== false && /* @__PURE__ */ jsxs(
+                            "button",
+                            {
+                              type: "button",
+                              className: `chip-action${state.isGrouped(column) ? " chip-action-active" : ""}`,
+                              "data-part": "group-toggle",
+                              "aria-label": state.groupingButtonLabel(column),
+                              title: state.groupingButtonLabel(column),
+                              onClick: (e) => state.toggleGrouping(column, e),
+                              children: [
+                                /* @__PURE__ */ jsx("svg", { viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: "M4 6h8v4H4V6Zm0 8h8v4H4v-4Zm10-8h6v4h-6V6Zm0 8h6v4h-6v-4Z" }) }),
+                                /* @__PURE__ */ jsx("span", { className: "sr-only ui-grid-sr-only", children: state.groupingButtonLabel(column) })
+                              ]
+                            }
+                          ),
+                          state.pinningFeature && state.isPinningEnabled() && state.isColumnPinnable(column) && /* @__PURE__ */ jsxs(
+                            "button",
+                            {
+                              type: "button",
+                              className: `chip-action${pinned ? " chip-action-active" : ""}`,
+                              "data-part": "pin-toggle",
+                              "aria-label": pinned ? labels.unpin : labels.pinLeft,
+                              title: pinned ? labels.unpin : labels.pinLeft,
+                              onClick: () => state.togglePin(column),
+                              children: [
+                                /* @__PURE__ */ jsx("svg", { viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: "M16 12V4h1V2H7v2h1v8l-2 2v2h5v6l1 1 1-1v-6h5v-2l-2-2z" }) }),
+                                /* @__PURE__ */ jsx("span", { className: "sr-only ui-grid-sr-only", children: pinned ? labels.unpin : labels.pinLeft })
+                              ]
+                            }
+                          )
+                        ] })
+                      ]
+                    },
+                    column.name
+                  );
+                })
+              }
+            ),
+            filteringFeature && state.isFilteringEnabled() && /* @__PURE__ */ jsx(
+              "div",
+              {
+                className: "filter-grid ui-grid-header",
+                "data-part": "filters",
+                style: { gridTemplateColumns },
+                children: visibleColumns.map((column) => {
+                  const pinned = state.isPinned(column);
+                  const pinOffset = pinned ? state.pinnedOffset(column) : null;
+                  return /* @__PURE__ */ jsxs(
+                    "label",
+                    {
+                      className: `filter-cell ui-grid-filter-container${pinned ? " is-pinned" : ""}`,
+                      "data-part": "filter-cell",
+                      style: {
+                        position: pinned ? "sticky" : void 0,
+                        left: pinOffset?.side === "left" ? pinOffset.offset : void 0,
+                        right: pinOffset?.side === "right" ? pinOffset.offset : void 0,
+                        zIndex: pinned ? 2 : void 0
+                      },
+                      children: [
+                        /* @__PURE__ */ jsxs("span", { className: "sr-only ui-grid-sr-only", children: [
+                          labels.filterColumn,
+                          " ",
+                          state.headerLabel(column)
+                        ] }),
+                        /* @__PURE__ */ jsx(
+                          "input",
+                          {
+                            className: "ui-grid-filter-input",
+                            type: "text",
+                            defaultValue: state.filterValue(column.name),
+                            placeholder: state.filterPlaceholder(column),
+                            disabled: state.isFilterInputDisabled(column),
+                            onChange: (e) => state.updateFilter(column.name, e.target.value)
+                          }
+                        )
+                      ]
+                    },
+                    column.name
+                  );
+                })
+              }
+            ),
+            displayItems.length > 0 ? virtualizationEnabled ? /* @__PURE__ */ jsx(
               "div",
               {
-                className: `header-cell ui-grid-header-cell${sortingFeature && state.sortDirection(column) !== "none" ? " is-active" : ""}`,
-                "data-part": "header-cell",
-                role: "columnheader",
-                "aria-sort": sortingFeature ? state.sortAriaSort(column) : void 0,
+                className: "grid-viewport ui-grid-viewport",
+                "data-part": "viewport",
+                ref: virtualScroll.viewportRef,
+                style: { height: viewportHeightPx, overflow: "auto", position: "relative" },
+                onScroll: onViewportScroll,
+                children: /* @__PURE__ */ jsx("div", { style: { height: `${virtualScroll.totalHeight}px`, position: "relative" }, children: /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    className: "body-grid ui-grid-canvas",
+                    "data-part": "body",
+                    role: "rowgroup",
+                    style: {
+                      gridTemplateColumns,
+                      position: "absolute",
+                      top: 0,
+                      left: 0,
+                      right: 0,
+                      transform: `translateY(${virtualScroll.offsetY}px)`
+                    },
+                    children: itemsToRender.map(renderDisplayItem)
+                  }
+                ) })
+              }
+            ) : /* @__PURE__ */ jsx(
+              "div",
+              {
+                className: "body-grid ui-grid-canvas",
+                "data-part": "body",
+                role: "rowgroup",
+                style: { gridTemplateColumns },
+                children: displayItems.map(renderDisplayItem)
+              }
+            ) : /* @__PURE__ */ jsxs("div", { className: "empty-state ui-grid-no-row-overlay", "data-part": "empty-state", children: [
+              /* @__PURE__ */ jsx("strong", { children: options.emptyMessage ?? labels.emptyHeading }),
+              /* @__PURE__ */ jsx("p", { children: labels.emptyDescription })
+            ] }),
+            paginationFeature && state.showPaginationControls() && /* @__PURE__ */ jsxs(
+              "footer",
+              {
+                className: "pagination-bar ui-grid-pagination",
+                "data-part": "pagination",
+                role: "navigation",
+                "aria-label": labels.paginationPage,
                 children: [
-                  /* @__PURE__ */ jsx("span", { className: "header-label", children: state.headerLabel(column) }),
-                  /* @__PURE__ */ jsxs("div", { className: "header-actions", children: [
-                    sortingFeature && /* @__PURE__ */ jsxs(
+                  /* @__PURE__ */ jsx("p", { children: state.paginationSummary() }),
+                  /* @__PURE__ */ jsxs("div", { className: "pagination-controls", children: [
+                    /* @__PURE__ */ jsxs(
                       "button",
                       {
                         type: "button",
-                        className: `header-action${!state.isColumnSortable(column) ? " header-action-disabled" : ""}`,
-                        disabled: !state.isColumnSortable(column),
-                        "aria-label": state.sortButtonLabel(column),
-                        title: state.sortButtonLabel(column),
-                        onClick: () => state.toggleSort(column),
+                        className: "action action-secondary pagination-button",
+                        "aria-label": labels.paginationPrevious,
+                        disabled: paginationCurrentPage <= 1,
+                        onClick: () => state.previousPage(),
                         children: [
-                          renderSortIcon(column),
-                          /* @__PURE__ */ jsx("span", { className: "sr-only ui-grid-sr-only", children: state.sortButtonLabel(column) })
+                          /* @__PURE__ */ jsx(
+                            "svg",
+                            {
+                              className: "pagination-icon",
+                              viewBox: "0 0 24 24",
+                              "aria-hidden": "true",
+                              focusable: false,
+                              children: /* @__PURE__ */ jsx("path", { d: "M15.41 7.41L14 6l-6 6 6 6 1.41-1.41L10.83 12z" })
+                            }
+                          ),
+                          /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.paginationPrevious })
                         ]
                       }
                     ),
-                    groupingFeature && state.isGroupingEnabled() && column.enableGrouping !== false && /* @__PURE__ */ jsxs(
+                    /* @__PURE__ */ jsxs("span", { children: [
+                      labels.paginationPage,
+                      " ",
+                      paginationCurrentPage,
+                      " ",
+                      labels.paginationOf,
+                      " ",
+                      paginationTotalPages
+                    ] }),
+                    /* @__PURE__ */ jsxs(
                       "button",
                       {
                         type: "button",
-                        className: `chip-action${state.isGrouped(column) ? " chip-action-active" : ""}`,
-                        "data-part": "group-toggle",
-                        "aria-label": state.groupingButtonLabel(column),
-                        title: state.groupingButtonLabel(column),
-                        onClick: (e) => state.toggleGrouping(column, e),
+                        className: "action action-secondary pagination-button",
+                        "aria-label": labels.paginationNext,
+                        disabled: paginationCurrentPage >= paginationTotalPages,
+                        onClick: () => state.nextPage(),
                         children: [
-                          /* @__PURE__ */ jsx("svg", { viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: "M4 6h8v4H4V6Zm0 8h8v4H4v-4Zm10-8h6v4h-6V6Zm0 8h6v4h-6v-4Z" }) }),
-                          /* @__PURE__ */ jsx("span", { className: "sr-only ui-grid-sr-only", children: state.groupingButtonLabel(column) })
+                          /* @__PURE__ */ jsx(
+                            "svg",
+                            {
+                              className: "pagination-icon",
+                              viewBox: "0 0 24 24",
+                              "aria-hidden": "true",
+                              focusable: false,
+                              children: /* @__PURE__ */ jsx("path", { d: "M8.59 16.59L10 18l6-6-6-6-1.41 1.41L13.17 12z" })
+                            }
+                          ),
+                          /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.paginationNext })
                         ]
                       }
-                    )
+                    ),
+                    state.pageSizeOptions().length > 0 && /* @__PURE__ */ jsxs("label", { className: "pagination-size", children: [
+                      /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.paginationRows }),
+                      /* @__PURE__ */ jsx(
+                        "select",
+                        {
+                          "aria-label": labels.paginationRows,
+                          value: paginationSelectedPageSize,
+                          onChange: (e) => state.onPageSizeChange(e.target.value),
+                          children: state.pageSizeOptions().map((size) => /* @__PURE__ */ jsx("option", { value: size, children: size }, size))
+                        }
+                      )
+                    ] })
                   ] })
                 ]
-              },
-              column.name
-            ))
-          }
-        ),
-        filteringFeature && state.isFilteringEnabled() && /* @__PURE__ */ jsx("div", { className: "filter-grid ui-grid-header", "data-part": "filters", style: { gridTemplateColumns }, children: visibleColumns.map((column) => /* @__PURE__ */ jsxs("label", { className: "filter-cell ui-grid-filter-container", "data-part": "filter-cell", children: [
-          /* @__PURE__ */ jsxs("span", { className: "sr-only ui-grid-sr-only", children: [
-            labels.filterColumn,
-            " ",
-            state.headerLabel(column)
-          ] }),
-          /* @__PURE__ */ jsx(
-            "input",
-            {
-              className: "ui-grid-filter-input",
-              type: "text",
-              defaultValue: state.filterValue(column.name),
-              placeholder: state.filterPlaceholder(column),
-              disabled: state.isFilterInputDisabled(column),
-              onChange: (e) => state.updateFilter(column.name, e.target.value)
-            }
-          )
-        ] }, column.name)) }),
-        displayItems.length > 0 ? virtualizationEnabled ? /* @__PURE__ */ jsx(
-          "div",
-          {
-            className: "grid-viewport ui-grid-viewport",
-            "data-part": "viewport",
-            ref: virtualScroll.viewportRef,
-            style: { height: viewportHeightPx, overflow: "auto", position: "relative" },
-            onScroll: onViewportScroll,
-            children: /* @__PURE__ */ jsx("div", { style: { height: `${virtualScroll.totalHeight}px`, position: "relative" }, children: /* @__PURE__ */ jsx(
-              "div",
-              {
-                className: "body-grid ui-grid-canvas",
-                "data-part": "body",
-                role: "rowgroup",
-                style: {
-                  gridTemplateColumns,
-                  position: "absolute",
-                  top: 0,
-                  left: 0,
-                  right: 0,
-                  transform: `translateY(${virtualScroll.offsetY}px)`
-                },
-                children: itemsToRender.map(renderDisplayItem)
-              }
-            ) })
-          }
-        ) : /* @__PURE__ */ jsx(
-          "div",
-          {
-            className: "body-grid ui-grid-canvas",
-            "data-part": "body",
-            role: "rowgroup",
-            style: { gridTemplateColumns },
-            children: displayItems.map(renderDisplayItem)
-          }
-        ) : /* @__PURE__ */ jsxs("div", { className: "empty-state ui-grid-no-row-overlay", "data-part": "empty-state", children: [
-          /* @__PURE__ */ jsx("strong", { children: options.emptyMessage ?? labels.emptyHeading }),
-          /* @__PURE__ */ jsx("p", { children: labels.emptyDescription })
-        ] }),
-        paginationFeature && state.showPaginationControls() && /* @__PURE__ */ jsxs("footer", { className: "pagination-bar ui-grid-pagination", "data-part": "pagination", role: "navigation", "aria-label": labels.paginationPage, children: [
-          /* @__PURE__ */ jsx("p", { children: state.paginationSummary() }),
-          /* @__PURE__ */ jsxs("div", { className: "pagination-controls", children: [
-            /* @__PURE__ */ jsxs(
-              "button",
-              {
-                type: "button",
-                className: "action action-secondary pagination-button",
-                "aria-label": labels.paginationPrevious,
-                disabled: paginationCurrentPage <= 1,
-                onClick: () => state.previousPage(),
-                children: [
-                  /* @__PURE__ */ jsx("svg", { className: "pagination-icon", viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: "M15.41 7.41L14 6l-6 6 6 6 1.41-1.41L10.83 12z" }) }),
-                  /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.paginationPrevious })
-                ]
               }
-            ),
-            /* @__PURE__ */ jsxs("span", { children: [
-              labels.paginationPage,
-              " ",
-              paginationCurrentPage,
-              " ",
-              labels.paginationOf,
-              " ",
-              paginationTotalPages
-            ] }),
-            /* @__PURE__ */ jsxs(
-              "button",
-              {
-                type: "button",
-                className: "action action-secondary pagination-button",
-                "aria-label": labels.paginationNext,
-                disabled: paginationCurrentPage >= paginationTotalPages,
-                onClick: () => state.nextPage(),
-                children: [
-                  /* @__PURE__ */ jsx("svg", { className: "pagination-icon", viewBox: "0 0 24 24", "aria-hidden": "true", focusable: false, children: /* @__PURE__ */ jsx("path", { d: "M8.59 16.59L10 18l6-6-6-6-1.41 1.41L13.17 12z" }) }),
-                  /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.paginationNext })
-                ]
-              }
-            ),
-            state.pageSizeOptions().length > 0 && /* @__PURE__ */ jsxs("label", { className: "pagination-size", children: [
-              /* @__PURE__ */ jsx("span", { className: "sr-only", children: labels.paginationRows }),
-              /* @__PURE__ */ jsx(
-                "select",
-                {
-                  "aria-label": labels.paginationRows,
-                  value: paginationSelectedPageSize,
-                  onChange: (e) => state.onPageSizeChange(e.target.value),
-                  children: state.pageSizeOptions().map((size) => /* @__PURE__ */ jsx("option", { value: size, children: size }, size))
-                }
-              )
-            ] })
+            )
           ] })
-        ] })
-      ] })
-    ] })
+        ]
+      }
+    )
   ] }) });
 }
 
+// src/rustWasmGridEngine.ts
+import { registerRustWasmGridEngine } from "@ornery/ui-grid";
+var uiGridWasmModulePath = "../../../dist/ui-grid-wasm/ui_grid_wasm.js";
+function registerReactUiGridWasmEngineFromModule(module) {
+  registerRustWasmGridEngine({
+    buildPipeline(context) {
+      return module.build_pipeline_js(context);
+    }
+  });
+}
+async function enableReactUiGridWasmEngine() {
+  const module = await import(
+    /* @vite-ignore */
+    uiGridWasmModulePath
+  );
+  registerReactUiGridWasmEngineFromModule(module);
+}
+
 // src/index.ts
 import { DEFAULT_GRID_LABELS } from "@ornery/ui-grid";
 export {
   DEFAULT_GRID_LABELS,
   UiGrid,
+  buildGridTemplateColumns,
+  computeViewportHeightPx,
+  computeViewportRows,
+  enableReactUiGridWasmEngine,
+  formatPaginationSummary,
+  orderVisibleColumns,
+  registerReactUiGridWasmEngineFromModule,
+  resolveBenchmarkIterations,
   useGridState,
   useVirtualScroll
 };