@ai-matrx/design-system 0.48.6 → 0.48.8

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.48.8
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/design-system/v0.48.7..npm/design-system/v0.48.8 -- apps/shared/design-system`).
+No source changes intended and no consumer action required.
+
+## 0.48.7
+### Unreleased
+
+### DATA-V2-BASICS (2026-09-27): a click off the table lets go
+
+- **`useSpreadsheetGrid`: while a range is held, a pointerdown outside the table (its `[data-matrx-table]` root) and outside every layer it may have opened (menu, listbox, dialog, popper, toast) clears the range and takes the keyboard off the grid.** An open cell editor loses focus with it and saves as a Tab away would. Before, a 12-cell range survived a click on the page header or the sidebar while the keyboard fell to `<body>`, so Escape could not clear it either (Arman: "that's often the easiest way you get yourself out of strange state conditions").
+- Proof: `data-table/MatrxDataTable.outside-click-lets-go.test.tsx` (red on the previous hook: the range survived).
+
 ## 0.48.6
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/data-table/copy-helpers.d.cts

@@ -1,5 +1,5 @@
 import { AgentPayloadInput } from './copy-types.cjs';
-import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-Dh3wRc0N.cjs';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-ufKpwnVR.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';

package/dist/data-table/copy-helpers.d.ts

@@ -1,5 +1,5 @@
 import { AgentPayloadInput } from './copy-types.js';
-import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-hMqC2Fwn.js';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-BqLsZ2o1.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';

package/dist/data-table/filter-engine.d.cts

@@ -1,4 +1,4 @@
-import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-Dh3wRc0N.cjs';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-ufKpwnVR.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';

package/dist/data-table/filter-engine.d.ts

@@ -1,4 +1,4 @@
-import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-hMqC2Fwn.js';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-BqLsZ2o1.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';

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

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ComponentType, ReactNode, MouseEventHandler } from 'react';
 import { CopyControlProps } from './copy-types.cjs';
 export { AgentPayloadInput, AiCustomSource, AiVariant, CopyExportConfig } from './copy-types.cjs';
-import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-Dh3wRc0N.cjs';
+import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-ufKpwnVR.cjs';
 import { MatrxTableMenuTarget, MatrxTableMenuPayload, MatrxTableMenuSectionsResolver, MatrxTableMenuIconName } from './menu-targets.cjs';
 export { MatrxTableMenuItem, MatrxTableMenuSection } from './menu-targets.cjs';
 import '../content-transfer.cjs';

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

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ComponentType, ReactNode, MouseEventHandler } from 'react';
 import { CopyControlProps } from './copy-types.js';
 export { AgentPayloadInput, AiCustomSource, AiVariant, CopyExportConfig } from './copy-types.js';
-import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-hMqC2Fwn.js';
+import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-BqLsZ2o1.js';
 import { MatrxTableMenuTarget, MatrxTableMenuPayload, MatrxTableMenuSectionsResolver, MatrxTableMenuIconName } from './menu-targets.js';
 export { MatrxTableMenuItem, MatrxTableMenuSection } from './menu-targets.js';
 import '../content-transfer.js';

package/dist/data-table/index.cjs

@@ -36601,7 +36601,7 @@ function GenericTablePagination({
         }
       ) }),
       /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(TooltipContent, { children: "Show more already-loaded rows" })
-    ] }) : null : showPageControls && (unknownTotal ? currentPage > 1 || unknownTotal.hasNextPage : totalPages > 1) && /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(
+    ] }) : null : showPageControls && /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(
       "div",
       {
         className: cn(
@@ -43019,6 +43019,7 @@ function camePastAPortalIntoTheContainer(target) {
   if (!element) return false;
   return element.closest('[data-matrx-table-spreadsheet="true"]') === null;
 }
+var LAYERS_THE_GRID_OPENS = '[data-radix-popper-content-wrapper], [data-radix-portal], [role="menu"], [role="listbox"], [role="dialog"], [role="alertdialog"], [data-sonner-toaster]';
 var READ_ONLY_REASON = "This table is view-only \u2014 you can select and copy, but not change cells.";
 function useSpreadsheetGrid(options) {
   const [range, setRange] = (0, import_react15.useState)(null);
@@ -43273,6 +43274,23 @@ function useSpreadsheetGrid(options) {
     },
     [endEdit, focusIsLost]
   );
+  const holdsARange = range !== null;
+  (0, import_react15.useEffect)(() => {
+    if (!holdsARange || typeof document === "undefined") return;
+    const onPointerDown = (event) => {
+      const target = event.target instanceof Element ? event.target : null;
+      const container = catcherRef.current?.closest('[data-matrx-table-spreadsheet="true"]');
+      if (!target || !container || !container.isConnected) return;
+      const table = container.closest("[data-matrx-table]") ?? container;
+      if (table.contains(target) || target.closest(LAYERS_THE_GRID_OPENS)) return;
+      setRange(null);
+      setFillTarget(null);
+      const active = document.activeElement;
+      if (active instanceof HTMLElement && container.contains(active)) active.blur();
+    };
+    document.addEventListener("pointerdown", onPointerDown, true);
+    return () => document.removeEventListener("pointerdown", onPointerDown, true);
+  }, [holdsARange]);
   const controller = (0, import_react15.useMemo)(() => ({ endEdit, select, focusGrid }), [endEdit, select, focusGrid]);
   const onKeyDown = (0, import_react15.useCallback)(
     (event) => {
@@ -48510,7 +48528,7 @@ function MatrxDataTableCore(coreProps) {
   const pageCount = Math.max(1, Math.ceil(totalItems / effectivePageSize));
   const safePage = appendQuery ? 1 : remoteQuery ? safeQueryPage(page, totalItems, effectivePageSize) : Math.min(page, pageCount);
   const sourceOwnsProcessing = sourceOwnsSearch || sourceOwnsSort || sourceOwnsColumnFilters;
-  const localProgressiveEnabled = !remoteQuery && !hidePagination && allRowsAreLoaded && (!sourceOwnsProcessing || sourceTotal !== void 0) && localPagination?.mode !== "numbered";
+  const localProgressiveEnabled = !remoteQuery && !hidePagination && allRowsAreLoaded && (!sourceOwnsProcessing || sourceTotal !== void 0) && localPagination?.mode === "progressive";
   const progressiveRows = useProgressiveTableRows({
     rows: processed,
     pageSize,
@@ -48531,7 +48549,7 @@ function MatrxDataTableCore(coreProps) {
     }),
     containers: [scrollRef, cardsScrollRef],
     enabled: localProgressiveEnabled,
-    numberedPageHasMore: !hidePagination && !isLoading && !isFetching && processed.length > 0 && safePage < pageCount && (remoteQuery?.mode === "controlled" || !remoteQuery && localPagination?.mode === "numbered"),
+    numberedPageHasMore: !hidePagination && !isLoading && !isFetching && processed.length > 0 && safePage < pageCount && (remoteQuery?.mode === "controlled" || !remoteQuery),
     onPageAdvance: setPage
   });
   const paginated = (0, import_react22.useMemo)(() => {
@@ -51433,7 +51451,7 @@ function MatrxDataTableCore(coreProps) {
                           ] }) : !isLoading && appendQuery.pagination.totalItems !== void 0 && data.length === appendQuery.pagination.totalItems ? /* @__PURE__ */ (0, import_jsx_runtime48.jsx)("span", { className: "min-w-0 max-w-full break-words whitespace-normal px-3 text-xs text-muted-foreground sm:text-sm", children: "All rows loaded" }) : null
                         ]
                       }
-                    ) : !hidePagination && (totalItems > 0 || sourceTotal !== void 0) ? /* @__PURE__ */ (0, import_jsx_runtime48.jsx)(MatrxTableChrome, { part: "pagination", epoch: paginationEpoch, render: () => /* @__PURE__ */ (0, import_jsx_runtime48.jsx)("div", { className: "shrink-0", children: /* @__PURE__ */ (0, import_jsx_runtime48.jsx)(
+                    ) : !hidePagination ? /* @__PURE__ */ (0, import_jsx_runtime48.jsx)(MatrxTableChrome, { part: "pagination", epoch: paginationEpoch, render: () => /* @__PURE__ */ (0, import_jsx_runtime48.jsx)("div", { className: "shrink-0", children: /* @__PURE__ */ (0, import_jsx_runtime48.jsx)(
                       GenericTablePagination,
                       {
                         totalItems,