@ai-matrx/design-system 0.42.1 → 0.43.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.43.0 (2026-09-26 — type-to-edit in spreadsheet mode)
+
+* **Type to edit, for every table in spreadsheet mode.** The grid's keyboard focus now lives in a
+  hidden TYPE CATCHER textarea inside the scroll container (`[data-matrx-type-catcher]`,
+  `inputMode="none"`), so text that never arrives as a one-character keydown — an IME
+  composition, an Option / AltGr character, a dead-key accent, dictation, insertText — still opens
+  the selected cell's editor seeded with it. A paste or drop into the catcher is never a seed; a
+  space alone opens nothing; a `readOnly` grid takes nothing. Grid keys still bubble to the
+  container exactly as before (`targetsAnEditor` excludes the catcher). New hook return
+  `typeCatcherProps` and `containerProps.onFocus` (Tab into the grid lands in the catcher).
+* **`spreadsheet.onEditRequest(address, seed)`** — a consumer whose cells carry their own editor
+  (no `editable` on the column) is asked to open it, with what was typed (`null` for Enter/F2).
+  Test: `MatrxDataTable.type-to-edit.test.tsx` (RED 6/6 on 0.42.1 → GREEN 6/6; data-table 667/667).
+
 ## 0.42.1
 ### Unreleased
 

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-q5ficDSo.cjs';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-CqU57qk8.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-afUz93xo.js';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-CUR8Hbt5.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-q5ficDSo.cjs';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-CqU57qk8.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-afUz93xo.js';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-CUR8Hbt5.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-q5ficDSo.cjs';
+import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-CqU57qk8.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-afUz93xo.js';
+import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-CUR8Hbt5.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

@@ -8608,8 +8608,23 @@ function canRedo(stack) {
 function targetsAnEditor(target) {
   const element = target instanceof Element ? target : null;
   if (!element) return false;
+  if (element.closest(`[${TYPE_CATCHER_ATTR}]`)) return false;
   return element.closest("input, textarea, select, [contenteditable='true']") !== null;
 }
+var TYPE_CATCHER_ATTR = "data-matrx-type-catcher";
+var TYPE_CATCHER_STYLE = {
+  position: "fixed",
+  top: 0,
+  left: 0,
+  width: 1,
+  height: 1,
+  padding: 0,
+  border: 0,
+  opacity: 0,
+  overflow: "hidden",
+  resize: "none",
+  pointerEvents: "none"
+};
 function camePastAPortal(target, host) {
   if (typeof Element === "undefined") return false;
   const element = target instanceof Element ? target : null;
@@ -8629,6 +8644,8 @@ function useSpreadsheetGrid(options) {
   const [fillTarget, setFillTarget] = (0, import_react15.useState)(null);
   const [stack, setStack] = (0, import_react15.useState)(() => createUndoStack(options?.undoDepth ?? 100));
   const draggingRef = (0, import_react15.useRef)(null);
+  const catcherRef = (0, import_react15.useRef)(null);
+  const composingRef = (0, import_react15.useRef)(false);
   const optionsRef = (0, import_react15.useRef)(options);
   optionsRef.current = options;
   const rowIds = options?.rowIds ?? [];
@@ -9007,7 +9024,9 @@ function useSpreadsheetGrid(options) {
           event.preventDefault();
           const origin = event.currentTarget;
           if (typeof HTMLElement !== "undefined" && origin instanceof HTMLElement) {
-            origin.closest('[data-matrx-table-spreadsheet="true"]')?.focus({ preventScroll: true });
+            const container = origin.closest('[data-matrx-table-spreadsheet="true"]');
+            const catcher = container?.querySelector(`[${TYPE_CATCHER_ATTR}]`);
+            (catcher ?? container)?.focus({ preventScroll: true });
           }
           setRange(
             (previous) => event.shiftKey && previous ? { anchor: previous.anchor, focus: address } : { anchor: address, focus: address }
@@ -9078,11 +9097,58 @@ function useSpreadsheetGrid(options) {
     window.addEventListener("mouseup", commit);
     return () => window.removeEventListener("mouseup", commit);
   }, [options, fillRequestBase, applyPatches, announceSkips, screenPatches, refuseWrite]);
+  const takeTypedText = (0, import_react15.useCallback)(
+    (text) => {
+      if (catcherRef.current) catcherRef.current.value = "";
+      const current = optionsRef.current;
+      const focused = range?.focus;
+      if (!current || !focused || current.readOnly || !current.onEditRequest) return;
+      if (text.trim() === "") return;
+      current.onEditRequest(focused, text);
+    },
+    [range]
+  );
+  const typeCatcherProps = {
+    ref: (element) => {
+      catcherRef.current = element;
+    },
+    tabIndex: -1,
+    "aria-label": "Type to edit the selected cell",
+    inputMode: "none",
+    autoComplete: "off",
+    autoCorrect: "off",
+    autoCapitalize: "off",
+    spellCheck: false,
+    rows: 1,
+    [TYPE_CATCHER_ATTR]: "",
+    style: TYPE_CATCHER_STYLE,
+    onInput: (event) => {
+      const kind = event.nativeEvent?.inputType;
+      if (typeof kind === "string" && (kind.startsWith("insertFromPaste") || kind.startsWith("insertFromDrop"))) {
+        event.currentTarget.value = "";
+        return;
+      }
+      if (composingRef.current) return;
+      takeTypedText(event.currentTarget.value);
+    },
+    onCompositionStart: () => {
+      composingRef.current = true;
+    },
+    onCompositionEnd: (event) => {
+      composingRef.current = false;
+      takeTypedText(event.data || event.currentTarget.value);
+    }
+  };
   return {
     range,
     bounds,
     enabled: options !== null,
+    typeCatcherProps,
     containerProps: {
+      onFocus: (event) => {
+        if (event.target !== event.currentTarget) return;
+        catcherRef.current?.focus({ preventScroll: true });
+      },
       tabIndex: options ? 0 : -1,
       onKeyDown,
       onCopy,
@@ -14069,13 +14135,17 @@ function MatrxDataTableCore({
     }));
   };
   const requestCellEdit = (address, seed) => {
-    if (!editEnabled) return false;
+    if (!editEnabled && !spreadsheet?.onEditRequest) return false;
     const row = data.find((candidate) => getRowId(candidate) === address.rowId);
     if (!row) return false;
     const column = visibleColumns.find(
       (candidate) => columnId(candidate) === address.fieldName
     );
-    if (!column?.editable || !(column.editableIf?.(row) ?? true)) return false;
+    if (!column?.editable) {
+      const own = spreadsheet?.onEditRequest;
+      return own ? own({ rowId: address.rowId, columnId: address.fieldName }, seed) : false;
+    }
+    if (!(column.editableIf?.(row) ?? true)) return false;
     const field = column.accessorKey ? String(column.accessorKey) : columnId(column);
     setEditRequest((current) => ({
       rowId: address.rowId,
@@ -15204,6 +15274,7 @@ function MatrxDataTableCore({
                             onCopy: sheet.containerProps.onCopy,
                             onCut: sheet.containerProps.onCut,
                             onPaste: sheet.containerProps.onPaste,
+                            onFocus: sheet.containerProps.onFocus,
                             "data-matrx-table-spreadsheet": "true"
                           } : {},
                           "aria-busy": isLoading || isFetching,
@@ -15214,6 +15285,7 @@ function MatrxDataTableCore({
                             tableClassName
                           ),
                           children: [
+                            spreadsheetEnabled ? /* @__PURE__ */ (0, import_jsx_runtime43.jsx)("textarea", { ...sheet.typeCatcherProps }) : null,
                             hierarchy && draggedRow ? /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(
                               HierarchyRootDropTarget,
                               {