@comitor/ui 1.10.0 → 1.11.0

package/dist/data-grid/use-data-grid-undo-redo.js

@@ -0,0 +1,345 @@
+"use client";
+import * as React from "react";
+import { msg } from "./messages.js";
+import { toastInfo, toastSuccess } from "./toast.js";
+import { useAsRef } from "./use-as-ref.js";
+import { useLazyRef } from "./use-lazy-ref.js";
+import { getIsInPopover } from "./utils.js";
+const DEFAULT_MAX_HISTORY = 100;
+const BATCH_TIMEOUT = 300;
+function useStore(store, selector) {
+  const getSnapshot = React.useCallback(() => selector(store.getState()), [store, selector]);
+  return React.useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);
+}
+function buildIndexById(data, getRowId) {
+  const map = /* @__PURE__ */ new Map();
+  for (let i = 0; i < data.length; i++) {
+    const row = data[i];
+    if (row) {
+      map.set(getRowId(row), i);
+    }
+  }
+  return map;
+}
+function getPendingKey(rowId, columnId) {
+  return `${rowId}\0${columnId}`;
+}
+function useDataGridUndoRedo({
+  data,
+  onDataChange,
+  getRowId,
+  maxHistory = DEFAULT_MAX_HISTORY,
+  enabled = true
+}) {
+  const propsRef = useAsRef({
+    data,
+    onDataChange,
+    getRowId,
+    maxHistory,
+    enabled
+  });
+  const listenersRef = useLazyRef(() => /* @__PURE__ */ new Set());
+  const stateRef = useLazyRef(() => ({
+    undoStack: [],
+    redoStack: [],
+    hasPendingChanges: false
+  }));
+  const pendingBatchRef = React.useRef({
+    byKey: /* @__PURE__ */ new Map(),
+    timeoutId: null
+  });
+  const pendingNotifyRef = React.useRef(false);
+  const store = React.useMemo(() => {
+    return {
+      subscribe: (callback) => {
+        listenersRef.current.add(callback);
+        return () => listenersRef.current.delete(callback);
+      },
+      getState: () => stateRef.current,
+      push: (entry) => {
+        const state = stateRef.current;
+        const newUndoStack = [...state.undoStack, entry];
+        if (newUndoStack.length > propsRef.current.maxHistory) {
+          newUndoStack.shift();
+        }
+        stateRef.current = {
+          undoStack: newUndoStack,
+          redoStack: [],
+          hasPendingChanges: false
+        };
+        store.notify();
+      },
+      undo: () => {
+        const state = stateRef.current;
+        if (state.undoStack.length === 0) return null;
+        const entry = state.undoStack[state.undoStack.length - 1];
+        if (!entry) return null;
+        stateRef.current = {
+          undoStack: state.undoStack.slice(0, -1),
+          redoStack: [...state.redoStack, entry],
+          hasPendingChanges: false
+        };
+        store.notify();
+        return entry;
+      },
+      redo: () => {
+        const state = stateRef.current;
+        if (state.redoStack.length === 0) return null;
+        const entry = state.redoStack[state.redoStack.length - 1];
+        if (!entry) return null;
+        stateRef.current = {
+          undoStack: [...state.undoStack, entry],
+          redoStack: state.redoStack.slice(0, -1),
+          hasPendingChanges: false
+        };
+        store.notify();
+        return entry;
+      },
+      clear: () => {
+        stateRef.current = {
+          undoStack: [],
+          redoStack: [],
+          hasPendingChanges: false
+        };
+        store.notify();
+      },
+      setPendingChanges: (value) => {
+        if (stateRef.current.hasPendingChanges === value) return;
+        stateRef.current = {
+          ...stateRef.current,
+          hasPendingChanges: value
+        };
+        if (!pendingNotifyRef.current) {
+          pendingNotifyRef.current = true;
+          queueMicrotask(() => {
+            pendingNotifyRef.current = false;
+            store.notify();
+          });
+        }
+      },
+      notify: () => {
+        for (const listener of listenersRef.current) {
+          listener();
+        }
+      }
+    };
+  }, [listenersRef, stateRef, propsRef]);
+  const canUndo = useStore(store, (state) => state.undoStack.length > 0 || state.hasPendingChanges);
+  const canRedo = useStore(store, (state) => state.redoStack.length > 0);
+  const onCommit = React.useCallback(() => {
+    const pending = pendingBatchRef.current;
+    if (pending.byKey.size === 0) return;
+    if (pending.timeoutId) {
+      clearTimeout(pending.timeoutId);
+      pending.timeoutId = null;
+    }
+    const updates = Array.from(pending.byKey.values());
+    pending.byKey.clear();
+    const { getRowId: getRowId2 } = propsRef.current;
+    const entry = {
+      variant: "cells_update",
+      count: updates.length,
+      timestamp: Date.now(),
+      undo: (currentData) => {
+        const newData = [...currentData];
+        const indexById = buildIndexById(newData, getRowId2);
+        for (const update of updates) {
+          const index = indexById.get(update.rowId);
+          if (index !== void 0) {
+            const row = newData[index];
+            if (row) {
+              newData[index] = {
+                ...row,
+                [update.columnId]: update.previousValue
+              };
+            }
+          }
+        }
+        return newData;
+      },
+      redo: (currentData) => {
+        const newData = [...currentData];
+        const indexById = buildIndexById(newData, getRowId2);
+        for (const update of updates) {
+          const index = indexById.get(update.rowId);
+          if (index !== void 0) {
+            const row = newData[index];
+            if (row) {
+              newData[index] = { ...row, [update.columnId]: update.newValue };
+            }
+          }
+        }
+        return newData;
+      }
+    };
+    store.push(entry);
+  }, [store, propsRef]);
+  const onUndo = React.useCallback(() => {
+    if (!propsRef.current.enabled) return;
+    onCommit();
+    const entry = store.undo();
+    if (!entry) {
+      toastInfo(msg.toast.nothingToUndo);
+      return;
+    }
+    const newData = entry.undo(propsRef.current.data);
+    propsRef.current.onDataChange(newData);
+    toastSuccess(msg.toast.undone(entry.count));
+  }, [store, propsRef, onCommit]);
+  const onRedo = React.useCallback(() => {
+    if (!propsRef.current.enabled) return;
+    onCommit();
+    const entry = store.redo();
+    if (!entry) {
+      toastInfo(msg.toast.nothingToRedo);
+      return;
+    }
+    const newData = entry.redo(propsRef.current.data);
+    propsRef.current.onDataChange(newData);
+    toastSuccess(msg.toast.redone(entry.count));
+  }, [store, propsRef, onCommit]);
+  const onClear = React.useCallback(() => {
+    const pending = pendingBatchRef.current;
+    if (pending.timeoutId) {
+      clearTimeout(pending.timeoutId);
+      pending.timeoutId = null;
+    }
+    pending.byKey.clear();
+    store.clear();
+  }, [store]);
+  const trackCellsUpdate = React.useCallback(
+    (updates) => {
+      if (!propsRef.current.enabled || updates.length === 0) return;
+      const filteredUpdates = updates.filter((u) => !Object.is(u.previousValue, u.newValue));
+      if (filteredUpdates.length === 0) return;
+      const pending = pendingBatchRef.current;
+      for (const update of filteredUpdates) {
+        const key = getPendingKey(update.rowId, update.columnId);
+        const existing = pending.byKey.get(key);
+        if (existing) {
+          pending.byKey.set(key, { ...existing, newValue: update.newValue });
+        } else {
+          pending.byKey.set(key, update);
+        }
+      }
+      store.setPendingChanges(true);
+      if (pending.timeoutId) {
+        clearTimeout(pending.timeoutId);
+      }
+      pending.timeoutId = setTimeout(onCommit, BATCH_TIMEOUT);
+    },
+    [store, propsRef, onCommit]
+  );
+  const trackRowsAdd = React.useCallback(
+    (rows) => {
+      if (!propsRef.current.enabled || rows.length === 0) return;
+      onCommit();
+      const { getRowId: getRowId2 } = propsRef.current;
+      const rowIds = new Set(rows.map((row) => getRowId2(row)));
+      const rowsCopy = rows.map((row) => ({ ...row }));
+      const entry = {
+        variant: "rows_add",
+        count: rows.length,
+        timestamp: Date.now(),
+        undo: (currentData) => {
+          return currentData.filter((row) => !rowIds.has(getRowId2(row)));
+        },
+        redo: (currentData) => {
+          return [...currentData, ...rowsCopy.map((row) => ({ ...row }))];
+        }
+      };
+      store.push(entry);
+    },
+    [store, propsRef, onCommit]
+  );
+  const trackRowsDelete = React.useCallback(
+    (rows) => {
+      if (!propsRef.current.enabled || rows.length === 0) return;
+      onCommit();
+      const { getRowId: getRowId2, data: currentData } = propsRef.current;
+      const indexById = buildIndexById(currentData, getRowId2);
+      const rowsWithPositions = [];
+      for (const row of rows) {
+        const rowId = getRowId2(row);
+        const currentIndex = indexById.get(rowId);
+        if (currentIndex !== void 0) {
+          rowsWithPositions.push({
+            index: currentIndex,
+            row: { ...row }
+          });
+        }
+      }
+      rowsWithPositions.sort((a, b) => a.index - b.index);
+      const rowIds = new Set(rows.map((row) => getRowId2(row)));
+      const entry = {
+        variant: "rows_delete",
+        count: rows.length,
+        timestamp: Date.now(),
+        undo: (currentData2) => {
+          const newData = [...currentData2];
+          for (const { index, row } of rowsWithPositions) {
+            const insertIndex = Math.min(index, newData.length);
+            newData.splice(insertIndex, 0, { ...row });
+          }
+          return newData;
+        },
+        redo: (currentData2) => {
+          return currentData2.filter((row) => !rowIds.has(getRowId2(row)));
+        }
+      };
+      store.push(entry);
+    },
+    [store, propsRef, onCommit]
+  );
+  React.useEffect(() => {
+    const pending = pendingBatchRef.current;
+    return () => {
+      if (pending.timeoutId) {
+        clearTimeout(pending.timeoutId);
+      }
+    };
+  }, []);
+  React.useEffect(() => {
+    if (!enabled) return;
+    function onKeyDown(event) {
+      const isCtrlOrCmd = event.ctrlKey || event.metaKey;
+      const key = event.key.toLowerCase();
+      if (!isCtrlOrCmd || key !== "z" && key !== "y") return;
+      const activeElement = document.activeElement;
+      if (activeElement) {
+        const isInput = activeElement.tagName === "INPUT" || activeElement.tagName === "TEXTAREA";
+        const isContentEditable = activeElement.getAttribute("contenteditable") === "true";
+        const isInPopover = getIsInPopover(activeElement);
+        if (isInput || isContentEditable || isInPopover) return;
+      }
+      if (key === "z" && !event.shiftKey) {
+        event.preventDefault();
+        onUndo();
+        return;
+      }
+      if (key === "z" && event.shiftKey || key === "y") {
+        event.preventDefault();
+        onRedo();
+      }
+    }
+    document.addEventListener("keydown", onKeyDown);
+    return () => document.removeEventListener("keydown", onKeyDown);
+  }, [enabled, onUndo, onRedo]);
+  return React.useMemo(
+    () => ({
+      canUndo,
+      canRedo,
+      onUndo,
+      onRedo,
+      onClear,
+      trackCellsUpdate,
+      trackRowsAdd,
+      trackRowsDelete
+    }),
+    [canUndo, canRedo, onUndo, onRedo, onClear, trackCellsUpdate, trackRowsAdd, trackRowsDelete]
+  );
+}
+export {
+  useDataGridUndoRedo
+};
+//# sourceMappingURL=use-data-grid-undo-redo.js.map

package/dist/data-grid/use-data-grid-undo-redo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data-grid/use-data-grid-undo-redo.ts"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\n\nimport { msg } from \"./messages.js\";\nimport { toastInfo, toastSuccess } from \"./toast.js\";\nimport { useAsRef } from \"./use-as-ref.js\";\nimport { useLazyRef } from \"./use-lazy-ref.js\";\nimport { getIsInPopover } from \"./utils.js\";\n\nconst DEFAULT_MAX_HISTORY = 100;\nconst BATCH_TIMEOUT = 300;\n\ninterface HistoryEntry<TData> {\n  variant: \"cells_update\" | \"rows_add\" | \"rows_delete\";\n  count: number;\n  timestamp: number;\n  undo: (currentData: TData[]) => TData[];\n  redo: (currentData: TData[]) => TData[];\n}\n\ninterface UndoRedoCellUpdate {\n  rowId: string;\n  columnId: string;\n  previousValue: unknown;\n  newValue: unknown;\n}\n\ninterface StoreState<TData> {\n  undoStack: HistoryEntry<TData>[];\n  redoStack: HistoryEntry<TData>[];\n  hasPendingChanges: boolean;\n}\n\ninterface Store<TData> {\n  subscribe: (callback: () => void) => () => void;\n  getState: () => StoreState<TData>;\n  push: (entry: HistoryEntry<TData>) => void;\n  undo: () => HistoryEntry<TData> | null;\n  redo: () => HistoryEntry<TData> | null;\n  clear: () => void;\n  setPendingChanges: (value: boolean) => void;\n  notify: () => void;\n}\n\nfunction useStore<T>(store: Store<T>, selector: (state: StoreState<T>) => boolean): boolean {\n  const getSnapshot = React.useCallback(() => selector(store.getState()), [store, selector]);\n\n  return React.useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);\n}\n\nfunction buildIndexById<TData>(data: TData[], getRowId: (row: TData) => string): Map<string, number> {\n  const map = new Map<string, number>();\n  for (let i = 0; i < data.length; i++) {\n    const row = data[i];\n    if (row) {\n      map.set(getRowId(row), i);\n    }\n  }\n  return map;\n}\n\nfunction getPendingKey(rowId: string, columnId: string): string {\n  return `${rowId}\\0${columnId}`;\n}\n\n/**\n * Tuỳ chọn của {@link useDataGridUndoRedo}. Lịch sử nằm hoàn toàn ở phía trình duyệt:\n * hook tính ra mảng dữ liệu trước/sau rồi trả về qua `onDataChange` — ứng dụng tự\n * đồng bộ lên máy chủ (hoặc bỏ qua nếu chỉ làm việc với state cục bộ).\n */\ninterface UseDataGridUndoRedoProps<TData> {\n  data: TData[];\n  onDataChange: (data: TData[]) => void;\n  /** Khoá định danh bản ghi — phải khớp với `getRowId` của lưới */\n  getRowId: (row: TData) => string;\n  /** Số thao tác giữ trong lịch sử (mặc định 100) */\n  maxHistory?: number;\n  enabled?: boolean;\n}\n\ninterface UseDataGridUndoRedoReturn<TData> {\n  canUndo: boolean;\n  canRedo: boolean;\n  onUndo: () => void;\n  onRedo: () => void;\n  onClear: () => void;\n  trackCellsUpdate: (updates: UndoRedoCellUpdate[]) => void;\n  trackRowsAdd: (rows: TData[]) => void;\n  trackRowsDelete: (rows: TData[]) => void;\n}\n\nfunction useDataGridUndoRedo<TData>({\n  data,\n  onDataChange,\n  getRowId,\n  maxHistory = DEFAULT_MAX_HISTORY,\n  enabled = true\n}: UseDataGridUndoRedoProps<TData>): UseDataGridUndoRedoReturn<TData> {\n  const propsRef = useAsRef({\n    data,\n    onDataChange,\n    getRowId,\n    maxHistory,\n    enabled\n  });\n\n  const listenersRef = useLazyRef(() => new Set<() => void>());\n\n  const stateRef = useLazyRef<StoreState<TData>>(() => ({\n    undoStack: [],\n    redoStack: [],\n    hasPendingChanges: false\n  }));\n\n  const pendingBatchRef = React.useRef<{\n    byKey: Map<string, UndoRedoCellUpdate>;\n    timeoutId: ReturnType<typeof setTimeout> | null;\n  }>({\n    byKey: new Map(),\n    timeoutId: null\n  });\n\n  const pendingNotifyRef = React.useRef(false);\n\n  const store = React.useMemo<Store<TData>>(() => {\n    return {\n      subscribe: (callback) => {\n        listenersRef.current.add(callback);\n        return () => listenersRef.current.delete(callback);\n      },\n      getState: () => stateRef.current,\n      push: (entry) => {\n        const state = stateRef.current;\n        const newUndoStack = [...state.undoStack, entry];\n\n        if (newUndoStack.length > propsRef.current.maxHistory) {\n          newUndoStack.shift();\n        }\n\n        stateRef.current = {\n          undoStack: newUndoStack,\n          redoStack: [],\n          hasPendingChanges: false\n        };\n        store.notify();\n      },\n      undo: () => {\n        const state = stateRef.current;\n        if (state.undoStack.length === 0) return null;\n\n        const entry = state.undoStack[state.undoStack.length - 1];\n        if (!entry) return null;\n\n        stateRef.current = {\n          undoStack: state.undoStack.slice(0, -1),\n          redoStack: [...state.redoStack, entry],\n          hasPendingChanges: false\n        };\n        store.notify();\n        return entry;\n      },\n      redo: () => {\n        const state = stateRef.current;\n        if (state.redoStack.length === 0) return null;\n\n        const entry = state.redoStack[state.redoStack.length - 1];\n        if (!entry) return null;\n\n        stateRef.current = {\n          undoStack: [...state.undoStack, entry],\n          redoStack: state.redoStack.slice(0, -1),\n          hasPendingChanges: false\n        };\n        store.notify();\n        return entry;\n      },\n      clear: () => {\n        stateRef.current = {\n          undoStack: [],\n          redoStack: [],\n          hasPendingChanges: false\n        };\n        store.notify();\n      },\n      setPendingChanges: (value) => {\n        if (stateRef.current.hasPendingChanges === value) return;\n        stateRef.current = {\n          ...stateRef.current,\n          hasPendingChanges: value\n        };\n\n        if (!pendingNotifyRef.current) {\n          pendingNotifyRef.current = true;\n          queueMicrotask(() => {\n            pendingNotifyRef.current = false;\n            store.notify();\n          });\n        }\n      },\n      notify: () => {\n        for (const listener of listenersRef.current) {\n          listener();\n        }\n      }\n    };\n  }, [listenersRef, stateRef, propsRef]);\n\n  const canUndo = useStore(store, (state) => state.undoStack.length > 0 || state.hasPendingChanges);\n  const canRedo = useStore(store, (state) => state.redoStack.length > 0);\n\n  const onCommit = React.useCallback(() => {\n    const pending = pendingBatchRef.current;\n    if (pending.byKey.size === 0) return;\n\n    if (pending.timeoutId) {\n      clearTimeout(pending.timeoutId);\n      pending.timeoutId = null;\n    }\n\n    const updates = Array.from(pending.byKey.values());\n    pending.byKey.clear();\n\n    const { getRowId } = propsRef.current;\n\n    const entry: HistoryEntry<TData> = {\n      variant: \"cells_update\",\n      count: updates.length,\n      timestamp: Date.now(),\n      undo: (currentData) => {\n        const newData = [...currentData];\n        const indexById = buildIndexById(newData, getRowId);\n\n        for (const update of updates) {\n          const index = indexById.get(update.rowId);\n          if (index !== undefined) {\n            const row = newData[index];\n            if (row) {\n              newData[index] = {\n                ...row,\n                [update.columnId]: update.previousValue\n              };\n            }\n          }\n        }\n        return newData;\n      },\n      redo: (currentData) => {\n        const newData = [...currentData];\n        const indexById = buildIndexById(newData, getRowId);\n\n        for (const update of updates) {\n          const index = indexById.get(update.rowId);\n          if (index !== undefined) {\n            const row = newData[index];\n            if (row) {\n              newData[index] = { ...row, [update.columnId]: update.newValue };\n            }\n          }\n        }\n        return newData;\n      }\n    };\n\n    store.push(entry);\n  }, [store, propsRef]);\n\n  const onUndo = React.useCallback(() => {\n    if (!propsRef.current.enabled) return;\n\n    onCommit();\n\n    const entry = store.undo();\n    if (!entry) {\n      toastInfo(msg.toast.nothingToUndo);\n      return;\n    }\n\n    const newData = entry.undo(propsRef.current.data);\n    propsRef.current.onDataChange(newData);\n\n    toastSuccess(msg.toast.undone(entry.count));\n  }, [store, propsRef, onCommit]);\n\n  const onRedo = React.useCallback(() => {\n    if (!propsRef.current.enabled) return;\n\n    onCommit();\n\n    const entry = store.redo();\n    if (!entry) {\n      toastInfo(msg.toast.nothingToRedo);\n      return;\n    }\n\n    const newData = entry.redo(propsRef.current.data);\n    propsRef.current.onDataChange(newData);\n\n    toastSuccess(msg.toast.redone(entry.count));\n  }, [store, propsRef, onCommit]);\n\n  const onClear = React.useCallback(() => {\n    const pending = pendingBatchRef.current;\n    if (pending.timeoutId) {\n      clearTimeout(pending.timeoutId);\n      pending.timeoutId = null;\n    }\n    pending.byKey.clear();\n\n    store.clear();\n  }, [store]);\n\n  const trackCellsUpdate = React.useCallback(\n    (updates: UndoRedoCellUpdate[]) => {\n      if (!propsRef.current.enabled || updates.length === 0) return;\n\n      const filteredUpdates = updates.filter((u) => !Object.is(u.previousValue, u.newValue));\n      if (filteredUpdates.length === 0) return;\n\n      const pending = pendingBatchRef.current;\n\n      for (const update of filteredUpdates) {\n        const key = getPendingKey(update.rowId, update.columnId);\n        const existing = pending.byKey.get(key);\n\n        if (existing) {\n          pending.byKey.set(key, { ...existing, newValue: update.newValue });\n        } else {\n          pending.byKey.set(key, update);\n        }\n      }\n\n      store.setPendingChanges(true);\n\n      if (pending.timeoutId) {\n        clearTimeout(pending.timeoutId);\n      }\n      pending.timeoutId = setTimeout(onCommit, BATCH_TIMEOUT);\n    },\n    [store, propsRef, onCommit]\n  );\n\n  const trackRowsAdd = React.useCallback(\n    (rows: TData[]) => {\n      if (!propsRef.current.enabled || rows.length === 0) return;\n\n      onCommit();\n\n      const { getRowId } = propsRef.current;\n\n      const rowIds = new Set(rows.map((row) => getRowId(row)));\n      const rowsCopy = rows.map((row) => ({ ...row }));\n\n      const entry: HistoryEntry<TData> = {\n        variant: \"rows_add\",\n        count: rows.length,\n        timestamp: Date.now(),\n        undo: (currentData) => {\n          return currentData.filter((row) => !rowIds.has(getRowId(row)));\n        },\n        redo: (currentData) => {\n          return [...currentData, ...rowsCopy.map((row) => ({ ...row }))];\n        }\n      };\n\n      store.push(entry);\n    },\n    [store, propsRef, onCommit]\n  );\n\n  const trackRowsDelete = React.useCallback(\n    (rows: TData[]) => {\n      if (!propsRef.current.enabled || rows.length === 0) return;\n\n      onCommit();\n\n      const { getRowId, data: currentData } = propsRef.current;\n\n      const indexById = buildIndexById(currentData, getRowId);\n\n      const rowsWithPositions: Array<{ index: number; row: TData }> = [];\n      for (const row of rows) {\n        const rowId = getRowId(row);\n        const currentIndex = indexById.get(rowId);\n        if (currentIndex !== undefined) {\n          rowsWithPositions.push({\n            index: currentIndex,\n            row: { ...row }\n          });\n        }\n      }\n\n      rowsWithPositions.sort((a, b) => a.index - b.index);\n\n      const rowIds = new Set(rows.map((row) => getRowId(row)));\n\n      const entry: HistoryEntry<TData> = {\n        variant: \"rows_delete\",\n        count: rows.length,\n        timestamp: Date.now(),\n        undo: (currentData) => {\n          const newData = [...currentData];\n          for (const { index, row } of rowsWithPositions) {\n            const insertIndex = Math.min(index, newData.length);\n            newData.splice(insertIndex, 0, { ...row });\n          }\n          return newData;\n        },\n        redo: (currentData) => {\n          return currentData.filter((row) => !rowIds.has(getRowId(row)));\n        }\n      };\n\n      store.push(entry);\n    },\n    [store, propsRef, onCommit]\n  );\n\n  React.useEffect(() => {\n    const pending = pendingBatchRef.current;\n    return () => {\n      if (pending.timeoutId) {\n        clearTimeout(pending.timeoutId);\n      }\n    };\n  }, []);\n\n  React.useEffect(() => {\n    if (!enabled) return;\n\n    function onKeyDown(event: KeyboardEvent) {\n      const isCtrlOrCmd = event.ctrlKey || event.metaKey;\n      const key = event.key.toLowerCase();\n\n      if (!isCtrlOrCmd || (key !== \"z\" && key !== \"y\")) return;\n\n      const activeElement = document.activeElement;\n      if (activeElement) {\n        const isInput = activeElement.tagName === \"INPUT\" || activeElement.tagName === \"TEXTAREA\";\n        const isContentEditable = activeElement.getAttribute(\"contenteditable\") === \"true\";\n        const isInPopover = getIsInPopover(activeElement);\n\n        if (isInput || isContentEditable || isInPopover) return;\n      }\n\n      if (key === \"z\" && !event.shiftKey) {\n        event.preventDefault();\n        onUndo();\n        return;\n      }\n\n      if ((key === \"z\" && event.shiftKey) || key === \"y\") {\n        event.preventDefault();\n        onRedo();\n      }\n    }\n\n    document.addEventListener(\"keydown\", onKeyDown);\n    return () => document.removeEventListener(\"keydown\", onKeyDown);\n  }, [enabled, onUndo, onRedo]);\n\n  return React.useMemo(\n    () => ({\n      canUndo,\n      canRedo,\n      onUndo,\n      onRedo,\n      onClear,\n      trackCellsUpdate,\n      trackRowsAdd,\n      trackRowsDelete\n    }),\n    [canUndo, canRedo, onUndo, onRedo, onClear, trackCellsUpdate, trackRowsAdd, trackRowsDelete]\n  );\n}\n\nexport {\n  //\n  type UndoRedoCellUpdate,\n  useDataGridUndoRedo\n};\n"],"mappings":"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","names":["getRowId","currentData"]}

package/dist/data-grid/use-data-grid.d.ts

@@ -0,0 +1,92 @@
+import * as _tanstack_react_virtual from '@tanstack/react-virtual';
+import * as _tanstack_react_table from '@tanstack/react-table';
+import { TableOptions, TableMeta, ColumnDef } from '@tanstack/react-table';
+import * as React from 'react';
+import { CellPosition, CellUpdate, FileCellData, RowHeightValue, Direction, SearchState, ContextMenuState, PasteDialogState } from './types.js';
+
+/**
+ * Tuỳ chọn của {@link useDataGrid} — mở rộng `TableOptions` của TanStack Table v8.
+ *
+ * Hook KHÔNG tự gọi API nào: mọi thay đổi dữ liệu đều đi ra ngoài qua callback
+ * (`onDataChange`, `onRowAdd`, `onRowsDelete`, `onFilesUpload`…) để ứng dụng tự
+ * quyết định lưu ở đâu (REST, GraphQL, state cục bộ…).
+ */
+interface UseDataGridProps<TData> extends Omit<TableOptions<TData>, "pageCount" | "getCoreRowModel"> {
+    /**
+     * Nhận MẢNG DỮ LIỆU MỚI sau mỗi lần sửa ô/dán/xoá nội dung.
+     * Ứng dụng tự setState + gọi API lưu (thường lưu lạc quan rồi rollback khi lỗi).
+     */
+    onDataChange?: (data: TData[]) => void;
+    /**
+     * Người dùng bấm "Thêm dòng" (hoặc Shift+Enter). Trả về ô cần focus sau khi thêm
+     * (`{ rowIndex, columnId }`), hoặc `null` để lưới không cuộn/focus.
+     */
+    onRowAdd?: (event?: React.MouseEvent<HTMLDivElement>) => Partial<CellPosition> | Promise<Partial<CellPosition> | null> | null;
+    /** Dán nhiều dòng hơn số dòng hiện có → thêm `count` dòng trong MỘT lần gọi API */
+    onRowsAdd?: (count: number) => void | Promise<void>;
+    /** Xoá dòng (menu chuột phải hoặc Ctrl+Backspace) — nhận cả bản ghi lẫn chỉ số dòng */
+    onRowsDelete?: (rows: TData[], rowIndices: number[]) => void | Promise<void>;
+    /** Chạy TRƯỚC khi áp dụng dữ liệu dán — dùng để gọi API bulk update nếu cần */
+    onPaste?: (updates: Array<CellUpdate>) => void | Promise<void>;
+    /**
+     * Tải tệp lên cho ô `variant: "file"`. Không truyền thì tệp chỉ nằm trong bộ nhớ
+     * trình duyệt (blob URL) và mất khi tải lại trang.
+     */
+    onFilesUpload?: (params: {
+        files: File[];
+        rowIndex: number;
+        columnId: string;
+    }) => Promise<FileCellData[]>;
+    onFilesDelete?: (params: {
+        fileIds: string[];
+        rowIndex: number;
+        columnId: string;
+    }) => void | Promise<void>;
+    /** Chiều cao dòng ban đầu (mặc định "short" = 36px) */
+    rowHeight?: RowHeightValue;
+    onRowHeightChange?: (rowHeight: RowHeightValue) => void;
+    /** Số dòng render thêm ngoài vùng nhìn thấy (mặc định 6) */
+    overscan?: number;
+    dir?: Direction;
+    /** Tự focus ô đầu tiên (hoặc ô chỉ định) khi có dữ liệu */
+    autoFocus?: boolean | Partial<CellPosition>;
+    /** Bấm chuột vào ô là chọn luôn ô đó (mặc định chỉ focus) */
+    enableSingleCellSelection?: boolean;
+    /** Bấm tiêu đề cột để chọn cả cột */
+    enableColumnSelection?: boolean;
+    /** Bật tìm trong bảng (Ctrl+F) */
+    enableSearch?: boolean;
+    /** Bật dán từ clipboard (Ctrl+V) */
+    enablePaste?: boolean;
+    /** Chỉ xem: khoá mọi thao tác sửa/xoá/dán */
+    readOnly?: boolean;
+}
+declare function useDataGrid<TData>({ data, columns, rowHeight: rowHeightProp, overscan, dir: dirProp, initialState, ...props }: UseDataGridProps<TData>): {
+    dataGridRef: React.RefObject<HTMLDivElement | null>;
+    headerRef: React.RefObject<HTMLDivElement | null>;
+    rowMapRef: React.RefObject<Map<number, HTMLDivElement>>;
+    footerRef: React.RefObject<HTMLDivElement | null>;
+    dir: "ltr" | "rtl";
+    table: _tanstack_react_table.Table<TData>;
+    tableMeta: TableMeta<TData>;
+    virtualTotalSize: number;
+    virtualItems: _tanstack_react_virtual.VirtualItem[];
+    measureElement: (node: Element | null) => void;
+    columns: ColumnDef<TData, any>[];
+    columnSizeVars: {
+        [key: string]: number;
+    };
+    searchState: SearchState | undefined;
+    searchMatchesByRow: Map<number, Set<string>> | null;
+    activeSearchMatch: CellPosition | null;
+    cellSelectionMap: Map<number, Set<string>> | null;
+    focusedCell: CellPosition | null;
+    editingCell: CellPosition | null;
+    rowHeight: RowHeightValue;
+    contextMenu: ContextMenuState;
+    pasteDialog: PasteDialogState;
+    onRowAdd: ((event?: React.MouseEvent<HTMLDivElement>) => Promise<void>) | undefined;
+    adjustLayout: boolean;
+};
+
+export { type UseDataGridProps, useDataGrid };