@ai-matrx/design-system 0.17.1 → 0.17.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.17.2 — 2026-09-12
+
+`MatrxDataTable` now resets the vertical scroll position of both its desktop
+table and mobile card scrollers before paint when a non-initial
+`controlled-append` source key changes. Same-source appends and horizontal
+scroll position remain untouched in both automatic and manual modes.
+
+### Consumer action
+
+Update to 0.17.2 so refreshed or replaced append sources begin at their first
+row instead of retaining the previous source's bottom position. No API or
+configuration change is required.
+
 ## 0.17.1 — 2026-09-12
 
 `useScrollPagination` now retains each container's last observed scroll position

package/dist/data-table/index.cjs

@@ -5469,6 +5469,16 @@ function MatrxDataTableCore({
   ]);
   const scrollRef = (0, import_react14.useRef)(null);
   const cardsScrollRef = (0, import_react14.useRef)(null);
+  const previousAppendKeyForScrollReset = (0, import_react14.useRef)(appendQueryKey);
+  (0, import_react14.useLayoutEffect)(() => {
+    const previous = previousAppendKeyForScrollReset.current;
+    previousAppendKeyForScrollReset.current = appendQueryKey;
+    if (previous === null || appendQueryKey === null || previous === appendQueryKey) {
+      return;
+    }
+    if (scrollRef.current) scrollRef.current.scrollTop = 0;
+    if (cardsScrollRef.current) cardsScrollRef.current.scrollTop = 0;
+  }, [appendQueryKey]);
   const scrollPagination = useScrollPagination({
     containers: [scrollRef, cardsScrollRef],
     queryKey: appendQuery?.pagination.queryKey ?? "",