@ai-matrx/design-system 0.19.0 → 0.19.1

package/dist/data-table/index.d.cts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { f as MatrxDataTableProps, g as TableViewSnapshot } from '../types-Di6QT0P1.cjs';
-export { A as AnyOfColumnSearch, h as CellEditType, i as CellEditsMap, d as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, M as MatrxColumnDef, e as MatrxDataTableCopyConfig, j as MatrxDataTableDetailConfig, k as MatrxDataTableEditConfig, l as MatrxDataTableEmptyState, m as MatrxDataTableFilterUi, n as MatrxDataTableHierarchyConfig, o as MatrxDataTableHierarchyMove, p as MatrxDataTableMobileCardControls, q as MatrxDataTableQueryControl, c as MatrxDataTableQueryState, r as MatrxDataTableRecordControls, s as MatrxDataTableSelectionConfig, t as MatrxDataTableSourceProcessing, u as MatrxDataTableToolbar, v as MatrxDataTableUrlStateConfig, w as MatrxDataTableWindowConfig, x as MatrxTablePagination, y as SortDirection, S as SortState, b as TableSavedViewsProps, T as TableSearchMatchMode, z as TableViewQuery, B as TextFilterMode, D as ToolbarFacet } from '../types-Di6QT0P1.cjs';
+import { f as MatrxDataTableProps, g as TableViewSnapshot } from '../types-BcIcmIxd.cjs';
+export { A as AnyOfColumnSearch, h as CellEditType, i as CellEditsMap, d as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, M as MatrxColumnDef, e as MatrxDataTableCopyConfig, j as MatrxDataTableDetailConfig, k as MatrxDataTableEditConfig, l as MatrxDataTableEmptyState, m as MatrxDataTableFilterUi, n as MatrxDataTableHierarchyConfig, o as MatrxDataTableHierarchyMove, p as MatrxDataTableMobileCardControls, q as MatrxDataTableQueryControl, c as MatrxDataTableQueryState, r as MatrxDataTableRecordControls, s as MatrxDataTableSelectionConfig, t as MatrxDataTableSourceProcessing, u as MatrxDataTableToolbar, v as MatrxDataTableUrlStateConfig, w as MatrxDataTableWindowConfig, x as MatrxTablePagination, y as SortDirection, S as SortState, b as TableSavedViewsProps, T as TableSearchMatchMode, z as TableViewQuery, B as TextFilterMode, D as ToolbarFacet } from '../types-BcIcmIxd.cjs';
 export { MatrxDataTableHost, MatrxDataTableProvider, TableDoors, TableEntityRefProps, TableLinkProps, TablePeekProps, TableSidePanelProps, TableToolbarActionProps, TableWindowPanelProps, useMatrxDataTableHost } from './host.cjs';
 export { DataRowInspector } from './data-row-inspector.cjs';
 export { DataRowWindow, DataRowWindowProps, DataRowWindowTab } from './data-row-window.cjs';

package/dist/data-table/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { f as MatrxDataTableProps, g as TableViewSnapshot } from '../types-D1m14boM.js';
-export { A as AnyOfColumnSearch, h as CellEditType, i as CellEditsMap, d as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, M as MatrxColumnDef, e as MatrxDataTableCopyConfig, j as MatrxDataTableDetailConfig, k as MatrxDataTableEditConfig, l as MatrxDataTableEmptyState, m as MatrxDataTableFilterUi, n as MatrxDataTableHierarchyConfig, o as MatrxDataTableHierarchyMove, p as MatrxDataTableMobileCardControls, q as MatrxDataTableQueryControl, c as MatrxDataTableQueryState, r as MatrxDataTableRecordControls, s as MatrxDataTableSelectionConfig, t as MatrxDataTableSourceProcessing, u as MatrxDataTableToolbar, v as MatrxDataTableUrlStateConfig, w as MatrxDataTableWindowConfig, x as MatrxTablePagination, y as SortDirection, S as SortState, b as TableSavedViewsProps, T as TableSearchMatchMode, z as TableViewQuery, B as TextFilterMode, D as ToolbarFacet } from '../types-D1m14boM.js';
+import { f as MatrxDataTableProps, g as TableViewSnapshot } from '../types-xTXSqmR7.js';
+export { A as AnyOfColumnSearch, h as CellEditType, i as CellEditsMap, d as ColumnFilterKind, a as ColumnFilterValue, C as ColumnFiltersState, M as MatrxColumnDef, e as MatrxDataTableCopyConfig, j as MatrxDataTableDetailConfig, k as MatrxDataTableEditConfig, l as MatrxDataTableEmptyState, m as MatrxDataTableFilterUi, n as MatrxDataTableHierarchyConfig, o as MatrxDataTableHierarchyMove, p as MatrxDataTableMobileCardControls, q as MatrxDataTableQueryControl, c as MatrxDataTableQueryState, r as MatrxDataTableRecordControls, s as MatrxDataTableSelectionConfig, t as MatrxDataTableSourceProcessing, u as MatrxDataTableToolbar, v as MatrxDataTableUrlStateConfig, w as MatrxDataTableWindowConfig, x as MatrxTablePagination, y as SortDirection, S as SortState, b as TableSavedViewsProps, T as TableSearchMatchMode, z as TableViewQuery, B as TextFilterMode, D as ToolbarFacet } from '../types-xTXSqmR7.js';
 export { MatrxDataTableHost, MatrxDataTableProvider, TableDoors, TableEntityRefProps, TableLinkProps, TablePeekProps, TableSidePanelProps, TableToolbarActionProps, TableWindowPanelProps, useMatrxDataTableHost } from './host.js';
 export { DataRowInspector } from './data-row-inspector.js';
 export { DataRowWindow, DataRowWindowProps, DataRowWindowTab } from './data-row-window.js';

package/dist/data-table/index.js

@@ -1034,12 +1034,16 @@ function isVerticallyScrollable(element) {
   return (overflowY === "auto" || overflowY === "scroll" || overflowY === "overlay") && element.scrollHeight > element.clientHeight;
 }
 function resolveScrollOwner(source) {
+  const documentOwner = document.scrollingElement instanceof HTMLElement ? document.scrollingElement : document.documentElement;
   for (let node = source; node; node = node.parentElement) {
+    if (node === documentOwner || node === document.documentElement || node === document.body) {
+      return { element: documentOwner, document: true };
+    }
     if (node === source && node.scrollHeight > node.clientHeight || isVerticallyScrollable(node)) {
       return { element: node, document: false };
     }
   }
-  return { element: document.scrollingElement instanceof HTMLElement ? document.scrollingElement : document.documentElement, document: true };
+  return { element: documentOwner, document: true };
 }
 function ownerScrollTop(owner) {
   return owner.document ? window.scrollY || document.documentElement.scrollTop || document.body.scrollTop || 0 : owner.element.scrollTop;
@@ -1166,7 +1170,7 @@ function useScrollPagination({
         else owner.element.removeEventListener("scroll", onOwnerScroll);
       });
     };
-    const setIntent = (source, startTop) => {
+    const setIntent = (source) => {
       const current = latestRef.current;
       const owner = resolveScrollOwner(source);
       if (!isVisibleContainer(source) || current.loading || current.isFetchingNextPage || inFlightGenerationRef.current !== null) return;
@@ -1179,9 +1183,8 @@ function useScrollPagination({
     };
     const cleanups = attachable.map((source) => {
       if (!observedTopRef.current.has(source)) observedTopRef.current.set(source, source.scrollTop);
-      const lastObservedTop = () => observedTopRef.current.get(source) ?? source.scrollTop;
       const onWheel = (event) => {
-        if (event.deltaY > 0 && Math.abs(event.deltaY) > Math.abs(event.deltaX)) setIntent(source, lastObservedTop());
+        if (event.deltaY > 0 && Math.abs(event.deltaY) > Math.abs(event.deltaX)) setIntent(source);
       };
       const onTouchStart = (event) => {
         const touch = event.touches.item(0);
@@ -1190,16 +1193,16 @@ function useScrollPagination({
       const onTouchMove = (event) => {
         const touch = event.touches.item(0);
         const startY = Number(source.dataset.matrxPaginationTouchY);
-        if (touch && Number.isFinite(startY) && startY - touch.clientY > 0) setIntent(source, lastObservedTop());
+        if (touch && Number.isFinite(startY) && startY - touch.clientY > 0) setIntent(source);
       };
       const onTouchEnd = () => {
         delete source.dataset.matrxPaginationTouchY;
       };
       const onKeyDown = (event) => {
-        if (isDownwardKeyboardInput(event)) setIntent(source, lastObservedTop());
+        if (isDownwardKeyboardInput(event)) setIntent(source);
       };
       const onPointerDown = (event) => {
-        if (isNativeScrollbarPointer(event, source)) setIntent(source, lastObservedTop());
+        if (isNativeScrollbarPointer(event, source)) setIntent(source);
       };
       const onScroll = () => {
         handleScroll(source, { element: source, document: false });
@@ -5969,6 +5972,8 @@ function ColumnResizeHandle({
   minWidth,
   maxWidth,
   disabled = false,
+  onResizeStart,
+  onResizeCancel,
   onResizeCommit
 }) {
   const handleRef = useRef7(null);
@@ -6013,6 +6018,7 @@ function ColumnResizeHandle({
     if (!commit) {
       if (active.priorPreview) table?.style.setProperty(cssVar, active.priorPreview);
       else table?.style.removeProperty(cssVar);
+      onResizeCancel?.();
     } else {
       writePreview(width);
       setAnnouncedWidth(width);
@@ -6021,7 +6027,7 @@ function ColumnResizeHandle({
     if (handleRef.current?.hasPointerCapture(active.pointerId)) {
       handleRef.current.releasePointerCapture(active.pointerId);
     }
-  }, [clearQueuedPreview, columnId2, cssVar, onResizeCommit, tableRef, writePreview]);
+  }, [clearQueuedPreview, columnId2, cssVar, onResizeCancel, onResizeCommit, tableRef, writePreview]);
   useEffect8(() => () => clearQueuedPreview(), [clearQueuedPreview]);
   const onPointerDown = (event) => {
     if (disabled || event.button !== 0 || !event.isPrimary) return;
@@ -6029,6 +6035,7 @@ function ColumnResizeHandle({
     event.stopPropagation();
     const startWidth = readWidth();
     keyboardWidthRef.current = startWidth;
+    onResizeStart?.();
     activeResizeRef.current = {
       pointerId: event.pointerId,
       startX: event.clientX,
@@ -6068,6 +6075,7 @@ function ColumnResizeHandle({
     event.stopPropagation();
     const nextWidth = clampColumnWidth(width, bounds);
     keyboardWidthRef.current = nextWidth;
+    onResizeStart?.();
     writePreview(nextWidth);
     setAnnouncedWidth(nextWidth);
     onResizeCommit(columnId2, nextWidth);
@@ -8330,6 +8338,7 @@ function MatrxDataTableCore({
     if (scrollRef.current) scrollRef.current.scrollTop = 0;
     if (cardsScrollRef.current) cardsScrollRef.current.scrollTop = 0;
   }, [appendQueryKey]);
+  const appendScrollPolicy = appendQuery?.scroll;
   const scrollPagination = useScrollPagination({
     containers: [scrollRef, cardsScrollRef],
     queryKey: appendQuery?.pagination.queryKey ?? "",
@@ -8339,7 +8348,11 @@ function MatrxDataTableCore({
     error: appendQuery?.pagination.error ?? null,
     loadNextPage: appendQuery?.pagination.loadNextPage ?? (() => void 0),
     enabled: appendQuery !== null,
-    ...appendQuery?.scroll
+    // Suspended policy is deliberately manual at the hook boundary: its
+    // reason remains visible in the footer while automatic listeners stay off.
+    mode: appendScrollPolicy?.mode === "suspended" ? "manual" : appendScrollPolicy?.mode ?? "scroll",
+    ...appendScrollPolicy?.mode === "scroll" && appendScrollPolicy.thresholdPx !== void 0 ? { thresholdPx: appendScrollPolicy.thresholdPx } : {},
+    ...appendScrollPolicy?.mode === "scroll" && appendScrollPolicy.intentTimeoutMs !== void 0 ? { intentTimeoutMs: appendScrollPolicy.intentTimeoutMs } : {}
   });
   const rootRef = useRef9(null);
   const actionDiagnosticObserver = useRef9(null);
@@ -8481,6 +8494,7 @@ function MatrxDataTableCore({
     () => normalizeColumnWidthsForColumns(columnState?.widths ?? columnWidths, columns),
     [columns, columnState?.widths, columnWidths]
   );
+  const resizeGestureSnapshotRef = useRef9(null);
   const measureVisibleColumnWidths = useCallback5(() => {
     const measured = {};
     const headers = tableRef.current ? Array.from(tableRef.current.querySelectorAll(
@@ -8515,13 +8529,25 @@ function MatrxDataTableCore({
       ...actionsWidth === void 0 ? {} : { actionsWidth }
     };
   }, []);
+  const captureResizeGestureSnapshot = useCallback5(() => {
+    resizeGestureSnapshotRef.current = {
+      widths: measureVisibleColumnWidths(),
+      geometry: measureFixedTableGeometry()
+    };
+  }, [measureFixedTableGeometry, measureVisibleColumnWidths]);
+  const clearResizeGestureSnapshot = useCallback5(() => {
+    resizeGestureSnapshotRef.current = null;
+  }, []);
   const commitColumnWidths = useCallback5((next, captureInitialWidths = false) => {
+    const gestureSnapshot = captureInitialWidths ? resizeGestureSnapshotRef.current : null;
+    resizeGestureSnapshotRef.current = null;
     const normalized = normalizeColumnWidthsForColumns(
-      captureInitialWidths ? { ...measureVisibleColumnWidths(), ...next } : next,
+      captureInitialWidths ? { ...gestureSnapshot?.widths ?? measureVisibleColumnWidths(), ...next } : next,
       columns
     );
-    if (captureInitialWidths) setFixedTableGeometry(measureFixedTableGeometry());
-    else setFixedTableGeometry(null);
+    if (captureInitialWidths) {
+      setFixedTableGeometry(gestureSnapshot?.geometry ?? measureFixedTableGeometry());
+    } else setFixedTableGeometry(null);
     for (const id of columnIds) {
       tableRef.current?.style.removeProperty(columnResizeCssVar(id));
     }
@@ -9983,6 +10009,8 @@ function MatrxDataTableCore({
                                             tableRef,
                                             minWidth: col.minWidth,
                                             maxWidth: col.maxWidth,
+                                            onResizeStart: captureResizeGestureSnapshot,
+                                            onResizeCancel: clearResizeGestureSnapshot,
                                             onResizeCommit: (columnId2, width) => commitColumnWidths(
                                               { ...effectiveColumnWidths, [columnId2]: width },
                                               true
@@ -10325,7 +10353,11 @@ function MatrxDataTableCore({
                                 "."
                               ] }) : null,
                               !isLoading && !isFetching && !appendQuery.pagination.loadAll?.isLoading && !scrollPagination.error && !appendQuery.pagination.hasNextPage && appendQuery.pagination.totalItems !== void 0 && data.length === appendQuery.pagination.totalItems ? /* @__PURE__ */ jsx38("p", { children: "All source rows are loaded." }) : appendUsesLocalProcessing ? /* @__PURE__ */ jsx38("p", { children: "Local search and filters cover loaded rows." }) : null,
-                              scrollPagination.error ? /* @__PURE__ */ jsx38("p", { role: "alert", className: "break-words text-destructive", children: scrollPagination.error.message }) : null
+                              scrollPagination.error ? /* @__PURE__ */ jsx38("p", { role: "alert", className: "break-words text-destructive", children: scrollPagination.error.message }) : null,
+                              appendScrollPolicy?.mode === "suspended" ? /* @__PURE__ */ jsxs28("p", { role: "status", className: "break-words", children: [
+                                appendScrollPolicy.reason,
+                                " Load more remains available."
+                              ] }) : null
                             ] })
                           ]
                         }