najm-kit 2.2.0 → 2.2.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 2.2.1
+
+- Fixed a regression in 2.2.0: the dynamic page size reported under `manualPagination` could oscillate. Card row height is measured from rendered cards, so it grows as images decode; feeding that back into the page size refetched, re-rendered, re-measured, and refetched again. A list visibly settled from one page size to another with the loading skeleton flashing twice. The report is now allowed once per container geometry, which does not depend on the rows inside it, so it terminates. A resize still re-arms it, and the debounce still waits for the measurement to settle before reporting.
+
 ## 2.2.0
 
 - Added `cardPagination` mode `infinite`: card lists continue on scroll instead of behind a button. No control and no end-of-list element render while the list is healthy. The continuation button appears only after an append failure, as the retry target.

package/dist/index.mjs

@@ -12566,6 +12566,7 @@ function useTable(effectiveViewModeOverride) {
   const calculatedPageSize = useTableStore.use.calculatedPageSize();
   const calculatedCardPageSize = useTableStore.use.calculatedCardPageSize();
   const measuredBodyHeight = useTableStore.use.bodyHeight();
+  const measuredBodyWidth = useTableStore.use.bodyWidth();
   const syncWithProps = useTableStore.use.syncWithProps();
   const onStateChange = useTableStore.use.onStateChange();
   const getRowId = useTableStore.use.getRowId();
@@ -12693,16 +12694,17 @@ function useTable(effectiveViewModeOverride) {
     }
   }, [calculatedPageSize, dynamicHeight, renderedMode, viewMode, cardPagination.mode, table, data.length, manualPagination]);
   const dynamicPageSizeTarget = renderedMode === "cards" ? calculatedCardPageSize : calculatedPageSize;
-  const lastRequestedDynamicSizeRef = useRef(null);
+  const geometryKey = `${renderedMode}:${measuredBodyWidth}x${measuredBodyHeight}`;
+  const reportedGeometryRef = useRef(null);
   useEffect(() => {
     if (!manualPagination || !dynamicHeight) return;
     if (cardPagination.mode !== "paged") return;
     if (measuredBodyHeight <= 0) return;
     if (!dynamicPageSizeTarget || dynamicPageSizeTarget < 1) return;
     if (dynamicPageSizeTarget === storePagination.pageSize) return;
-    if (lastRequestedDynamicSizeRef.current === dynamicPageSizeTarget) return;
+    if (reportedGeometryRef.current === geometryKey) return;
     const timer = setTimeout(() => {
-      lastRequestedDynamicSizeRef.current = dynamicPageSizeTarget;
+      reportedGeometryRef.current = geometryKey;
       setPagination({ pageIndex: storePagination.pageIndex, pageSize: dynamicPageSizeTarget });
     }, DYNAMIC_PAGE_SIZE_DEBOUNCE_MS);
     return () => clearTimeout(timer);
@@ -12711,6 +12713,7 @@ function useTable(effectiveViewModeOverride) {
     dynamicHeight,
     cardPagination.mode,
     measuredBodyHeight,
+    geometryKey,
     dynamicPageSizeTarget,
     storePagination.pageIndex,
     storePagination.pageSize,

package/package.json

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