najm-kit 2.11.8 → 2.11.9

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 2.11.9 - 2026-08-30
+
+- Fixed card grids that paginate client-side rendering their entire dataset on
+  one page. `useTable` pinned an uncontrolled paged card list to `data.length`,
+  a branch that predates the container measurement added in 2.2.0 and was never
+  reconciled with it: `calculatedCardPageSize` was measured and published, but
+  only ever applied to a server-paginated grid. A 500-row list rendered 500
+  cards on page one, reported a single page, and showed 500 as the current
+  Rows/page value. The measured size is now applied to an uncontrolled card grid
+  too, through the guards that already keep a server-paginated one stable —
+  geometry bucketing, the per-container report budget, and the deferral until
+  real cards have been measured. That loop is a property of the measurement
+  rather than of fetching: page size decides which cards render, and rendered
+  cards are what card height is measured from. Rendering every supplied row
+  stays the behavior wherever there is nothing to measure against, so
+  `dynamicHeight={false}` and a container that has not yet reported a layout are
+  unchanged, and a controlled `pagination` prop or an explicit Rows/page choice
+  still wins.
+
 ## 2.11.8 - 2026-08-28
 
 - Fixed `NContextMenu` leaving keyboard focus on its opener after the menu

package/dist/index.mjs

@@ -12207,15 +12207,17 @@ function useTable(effectiveViewModeOverride) {
   useLayoutEffect(() => {
     if (manualPagination || isPaginationControlled || isPageSizeUserSelected) return;
     if (dynamicHeight && renderedMode === "table") table.setPageSize(calculatedPageSize);
-    if (viewMode === "cards" && cardPagination.mode === "paged") {
+    const cardsAreUnmeasured = !dynamicHeight || !hasMeasuredLayout;
+    if (viewMode === "cards" && cardPagination.mode === "paged" && cardsAreUnmeasured) {
       table.setPageSize(data.length || 9999);
     }
-  }, [calculatedPageSize, dynamicHeight, renderedMode, viewMode, cardPagination.mode, table, data.length, manualPagination, isPaginationControlled, isPageSizeUserSelected]);
+  }, [calculatedPageSize, dynamicHeight, hasMeasuredLayout, renderedMode, viewMode, cardPagination.mode, table, data.length, manualPagination, isPaginationControlled, isPageSizeUserSelected]);
   const dynamicPageSizeTarget = renderedMode === "cards" ? calculatedCardPageSize : calculatedPageSize;
   const geometryKey = `${Math.round(measuredBodyWidth / GEOMETRY_BUCKET_PX)}x${Math.round(measuredBodyHeight / GEOMETRY_BUCKET_PX)}`;
   const reportedGeometryRef = useRef(null);
   useLayoutEffect(() => {
-    if (!manualPagination || !dynamicHeight || isPageSizeUserSelected) return;
+    if (!dynamicHeight || isPageSizeUserSelected) return;
+    if (!manualPagination && (isPaginationControlled || renderedMode !== "cards")) return;
     if (cardPagination.mode !== "paged") return;
     if (!hasMeasuredLayout || measuredBodyHeight <= 0) return;
     if (!dynamicPageSizeTarget || dynamicPageSizeTarget < 1) return;
@@ -12237,6 +12239,7 @@ function useTable(effectiveViewModeOverride) {
     return () => clearTimeout(timer);
   }, [
     manualPagination,
+    isPaginationControlled,
     dynamicHeight,
     isPageSizeUserSelected,
     cardPagination.mode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "najm-kit",
-  "version": "2.11.8",
+  "version": "2.11.9",
   "license": "MIT",
   "type": "module",
   "description": "Reusable React UI component package for Najm framework",