@trackunit/react-table 2.11.10-alpha-e1e6a0f33ce.0 → 2.11.11-alpha-7afddbbe4cc.0

package/index.cjs.js

@@ -1784,11 +1784,6 @@ const computeMergedPinning = (initialPinning, columnConfigPinning) => {
  */
 const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProps }) => {
     const stableColumns = react.useMemo(() => JSON.stringify(columns), [columns]);
-    // The column definitions are the single source of defaults: `meta.hiddenByDefault`, definition
-    // order, `meta.pinned`, and `size`. They seed the state when `initialState` says nothing, and
-    // they are the baseline for what `onTableStateChange` reports (see `persistTableState`).
-    // Consumers that want a different default should set it on the column, not in `initialState`:
-    // a value in `initialState` is treated as saved state.
     const columnDefaults = react.useMemo(() => {
         const columnsList = JSON.parse(stableColumns);
         const visibilityById = {};
@@ -1887,13 +1882,9 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
     // A ref exposes the latest derived state to the change callbacks without making them depend on
     // it (callbacks run on user events, outside render). Every managed key on `state` is always
     // defined — it originates from `baseState` — so the callbacks read it directly.
-    //
-    // `applyUpdate` resolves a TanStack updater against that ref and advances the ref at once, so
-    // several updaters fired from one event (the column menu's Reset toggles every column that
-    // differs from its default in a single click) build on each other instead of each starting
-    // from the state as of the last render.
     const stateRef = react.useRef(state);
     stateRef.current = state;
+    // Advances the ref at once so several updaters from one event (Reset) build on each other.
     const applyUpdate = (key, value) => {
         const current = stateRef.current[key];
         const next = typeof value === "function" ? value(current) : value;
@@ -1901,13 +1892,8 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
         setUserEdits(prev => ({ ...prev, [key]: next }));
         return next;
     };
-    // Reports only the field that changed — `useTablePersistence` merges partial reports — so a
-    // change can never store another field's unsettled or transient value. Within a field, only
-    // what differs from the column defaults is reported: visibility entries equal to
-    // `hiddenByDefault`, sizes equal to the default size, an order equal to the definition order and
-    // a pinning equal to `meta.pinned` all read back the same when absent, so storing them would only
-    // freeze today's defaults under the user's layout and bloat what is shared. A field with nothing
-    // left is reported empty so the store can drop it.
+    // Reports only what differs from the column defaults (see the hook's JSDoc); storing a default
+    // would freeze it under the user's layout.
     const persistTableState = react.useCallback((nextState) => {
         if (!onTableStateChange) {
             return;
@@ -1927,9 +1913,6 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
         }
         onTableStateChange(reported);
     }, [onTableStateChange, columnDefaults, defaultColumnSizingById, stableUpdatedInitialColumnPinning]);
-    // Whether a column-resize drag is in progress, as of the last render (TanStack
-    // flags it at pointer-down, before the first move arrives), and whether a
-    // sizing change was held back during one.
     const isResizingColumnRef = react.useRef(false);
     const sizingReportPendingRef = react.useRef(false);
     const table = reactTable.useReactTable({
@@ -1945,10 +1928,7 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
         },
         onColumnSizingChange: value => {
             const next = applyUpdate("columnSizing", value);
-            // A drag updates the sizing on every pointer move (`columnResizeMode:
-            // "onChange"`); the store would write every move. The report waits for
-            // the drag to end (see the effect below). Anything else — `resetSize`,
-            // `setColumnSizing` — is reported at once.
+            // A drag fires this on every pointer move; report it once, when the drag ends (effect below).
             if (isResizingColumnRef.current) {
                 sizingReportPendingRef.current = true;
             }
@@ -1981,8 +1961,7 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
     });
     const isResizingColumn = table.getState().columnSizingInfo.isResizingColumn !== false;
     isResizingColumnRef.current = isResizingColumn;
-    // The drag has ended: report the sizing it left behind, once. TanStack
-    // applies the final size before it clears the flag, so the ref holds it.
+    // TanStack applies the final size before it clears the flag, so `stateRef` already holds it.
     react.useEffect(() => {
         if (!isResizingColumn && sizingReportPendingRef.current) {
             sizingReportPendingRef.current = false;

package/index.esm.js

@@ -1783,11 +1783,6 @@ const computeMergedPinning = (initialPinning, columnConfigPinning) => {
  */
 const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProps }) => {
     const stableColumns = useMemo(() => JSON.stringify(columns), [columns]);
-    // The column definitions are the single source of defaults: `meta.hiddenByDefault`, definition
-    // order, `meta.pinned`, and `size`. They seed the state when `initialState` says nothing, and
-    // they are the baseline for what `onTableStateChange` reports (see `persistTableState`).
-    // Consumers that want a different default should set it on the column, not in `initialState`:
-    // a value in `initialState` is treated as saved state.
     const columnDefaults = useMemo(() => {
         const columnsList = JSON.parse(stableColumns);
         const visibilityById = {};
@@ -1886,13 +1881,9 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
     // A ref exposes the latest derived state to the change callbacks without making them depend on
     // it (callbacks run on user events, outside render). Every managed key on `state` is always
     // defined — it originates from `baseState` — so the callbacks read it directly.
-    //
-    // `applyUpdate` resolves a TanStack updater against that ref and advances the ref at once, so
-    // several updaters fired from one event (the column menu's Reset toggles every column that
-    // differs from its default in a single click) build on each other instead of each starting
-    // from the state as of the last render.
     const stateRef = useRef(state);
     stateRef.current = state;
+    // Advances the ref at once so several updaters from one event (Reset) build on each other.
     const applyUpdate = (key, value) => {
         const current = stateRef.current[key];
         const next = typeof value === "function" ? value(current) : value;
@@ -1900,13 +1891,8 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
         setUserEdits(prev => ({ ...prev, [key]: next }));
         return next;
     };
-    // Reports only the field that changed — `useTablePersistence` merges partial reports — so a
-    // change can never store another field's unsettled or transient value. Within a field, only
-    // what differs from the column defaults is reported: visibility entries equal to
-    // `hiddenByDefault`, sizes equal to the default size, an order equal to the definition order and
-    // a pinning equal to `meta.pinned` all read back the same when absent, so storing them would only
-    // freeze today's defaults under the user's layout and bloat what is shared. A field with nothing
-    // left is reported empty so the store can drop it.
+    // Reports only what differs from the column defaults (see the hook's JSDoc); storing a default
+    // would freeze it under the user's layout.
     const persistTableState = useCallback((nextState) => {
         if (!onTableStateChange) {
             return;
@@ -1926,9 +1912,6 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
         }
         onTableStateChange(reported);
     }, [onTableStateChange, columnDefaults, defaultColumnSizingById, stableUpdatedInitialColumnPinning]);
-    // Whether a column-resize drag is in progress, as of the last render (TanStack
-    // flags it at pointer-down, before the first move arrives), and whether a
-    // sizing change was held back during one.
     const isResizingColumnRef = useRef(false);
     const sizingReportPendingRef = useRef(false);
     const table = useReactTable({
@@ -1944,10 +1927,7 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
         },
         onColumnSizingChange: value => {
             const next = applyUpdate("columnSizing", value);
-            // A drag updates the sizing on every pointer move (`columnResizeMode:
-            // "onChange"`); the store would write every move. The report waits for
-            // the drag to end (see the effect below). Anything else — `resetSize`,
-            // `setColumnSizing` — is reported at once.
+            // A drag fires this on every pointer move; report it once, when the drag ends (effect below).
             if (isResizingColumnRef.current) {
                 sizingReportPendingRef.current = true;
             }
@@ -1980,8 +1960,7 @@ const useTable = ({ onTableStateChange, initialState, columns, ...reactTableProp
     });
     const isResizingColumn = table.getState().columnSizingInfo.isResizingColumn !== false;
     isResizingColumnRef.current = isResizingColumn;
-    // The drag has ended: report the sizing it left behind, once. TanStack
-    // applies the final size before it clears the flag, so the ref holds it.
+    // TanStack applies the final size before it clears the flag, so `stateRef` already holds it.
     useEffect(() => {
         if (!isResizingColumn && sizingReportPendingRef.current) {
             sizingReportPendingRef.current = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-table",
-  "version": "2.11.10-alpha-e1e6a0f33ce.0",
+  "version": "2.11.11-alpha-7afddbbe4cc.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
@@ -11,15 +11,15 @@
     "react-dnd": "16.0.1",
     "react-dnd-html5-backend": "16.0.1",
     "tailwind-merge": "^2.0.0",
-    "@trackunit/react-components": "3.8.3-alpha-e1e6a0f33ce.0",
-    "@trackunit/react-core-hooks": "1.25.6-alpha-e1e6a0f33ce.0",
-    "@trackunit/shared-utils": "1.19.6-alpha-e1e6a0f33ce.0",
-    "@trackunit/css-class-variance-utilities": "2.3.6-alpha-e1e6a0f33ce.0",
-    "@trackunit/ui-icons": "1.17.6-alpha-e1e6a0f33ce.0",
-    "@trackunit/react-table-base-components": "2.12.10-alpha-e1e6a0f33ce.0",
-    "@trackunit/react-form-components": "2.10.10-alpha-e1e6a0f33ce.0",
-    "@trackunit/i18n-library-translation": "2.8.6-alpha-e1e6a0f33ce.0",
-    "@trackunit/iris-app-runtime-core-api": "1.21.6-alpha-e1e6a0f33ce.0",
+    "@trackunit/react-components": "3.8.4-alpha-7afddbbe4cc.0",
+    "@trackunit/react-core-hooks": "1.25.7-alpha-7afddbbe4cc.0",
+    "@trackunit/shared-utils": "1.19.7-alpha-7afddbbe4cc.0",
+    "@trackunit/css-class-variance-utilities": "2.3.7-alpha-7afddbbe4cc.0",
+    "@trackunit/ui-icons": "1.17.7-alpha-7afddbbe4cc.0",
+    "@trackunit/react-table-base-components": "2.12.11-alpha-7afddbbe4cc.0",
+    "@trackunit/react-form-components": "2.10.11-alpha-7afddbbe4cc.0",
+    "@trackunit/i18n-library-translation": "2.8.7-alpha-7afddbbe4cc.0",
+    "@trackunit/iris-app-runtime-core-api": "1.21.7-alpha-7afddbbe4cc.0",
     "zod": "^3.25.76"
   },
   "peerDependencies": {