@tanstack/table-core 9.0.0-alpha.8 → 9.0.0-beta.10

package/dist/features/column-resizing/columnResizingFeature.d.cts

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.cjs";
+
+//#region src/features/column-resizing/columnResizingFeature.d.ts
+/**
+ * Feature that adds column resizing state, options, and resize handlers.
+ */
+declare const columnResizingFeature: TableFeature;
+//#endregion
+export { columnResizingFeature };
+//# sourceMappingURL=columnResizingFeature.d.cts.map

package/dist/features/column-resizing/columnResizingFeature.d.ts

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.js";
+
+//#region src/features/column-resizing/columnResizingFeature.d.ts
+/**
+ * Feature that adds column resizing state, options, and resize handlers.
+ */
+declare const columnResizingFeature: TableFeature;
+//#endregion
+export { columnResizingFeature };
+//# sourceMappingURL=columnResizingFeature.d.ts.map

package/dist/features/column-resizing/columnResizingFeature.js

@@ -0,0 +1,41 @@
+import { assignPrototypeAPIs, assignTableAPIs, makeStateUpdater } from "../../utils.js";
+import { column_getCanResize, column_getIsResizing, getDefaultColumnResizingState, header_getResizeHandler, table_resetHeaderSizeInfo, table_setColumnResizing } from "./columnResizingFeature.utils.js";
+
+//#region src/features/column-resizing/columnResizingFeature.ts
+/**
+* Feature that adds column resizing state, options, and resize handlers.
+*/
+const columnResizingFeature = {
+	getInitialState: (initialState) => {
+		return {
+			columnResizing: getDefaultColumnResizingState(),
+			...initialState
+		};
+	},
+	getDefaultTableOptions: (table) => {
+		return {
+			columnResizeMode: "onEnd",
+			columnResizeDirection: "ltr",
+			onColumnResizingChange: makeStateUpdater("columnResizing", table)
+		};
+	},
+	assignColumnPrototype: (prototype, table) => {
+		assignPrototypeAPIs("columnResizingFeature", prototype, table, {
+			column_getCanResize: { fn: (column) => column_getCanResize(column) },
+			column_getIsResizing: { fn: (column) => column_getIsResizing(column) }
+		});
+	},
+	assignHeaderPrototype: (prototype, table) => {
+		assignPrototypeAPIs("columnResizingFeature", prototype, table, { header_getResizeHandler: { fn: (header, _contextDocument) => header_getResizeHandler(header, _contextDocument) } });
+	},
+	constructTableAPIs: (table) => {
+		assignTableAPIs("columnResizingFeature", table, {
+			table_setColumnResizing: { fn: (updater) => table_setColumnResizing(table, updater) },
+			table_resetHeaderSizeInfo: { fn: (defaultState) => table_resetHeaderSizeInfo(table, defaultState) }
+		});
+	}
+};
+
+//#endregion
+export { columnResizingFeature };
+//# sourceMappingURL=columnResizingFeature.js.map

package/dist/features/column-resizing/columnResizingFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnResizingFeature.js","names":[],"sources":["../../../src/features/column-resizing/columnResizingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  column_getCanResize,\n  column_getIsResizing,\n  getDefaultColumnResizingState,\n  header_getResizeHandler,\n  table_resetHeaderSizeInfo,\n  table_setColumnResizing,\n} from './columnResizingFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds column resizing state, options, and resize handlers.\n */\nexport const columnResizingFeature: TableFeature = {\n  getInitialState: (initialState) => {\n    return {\n      columnResizing: getDefaultColumnResizingState(),\n      ...initialState,\n    }\n  },\n\n  getDefaultTableOptions: (table) => {\n    return {\n      columnResizeMode: 'onEnd',\n      columnResizeDirection: 'ltr',\n      onColumnResizingChange: makeStateUpdater('columnResizing', table),\n    }\n  },\n\n  assignColumnPrototype: (prototype, table) => {\n    assignPrototypeAPIs('columnResizingFeature', prototype, table, {\n      column_getCanResize: {\n        fn: (column) => column_getCanResize(column),\n      },\n      column_getIsResizing: {\n        fn: (column) => column_getIsResizing(column),\n      },\n    })\n  },\n\n  assignHeaderPrototype: (prototype, table) => {\n    assignPrototypeAPIs('columnResizingFeature', prototype, table, {\n      header_getResizeHandler: {\n        fn: (header, _contextDocument) =>\n          header_getResizeHandler(header, _contextDocument),\n      },\n    })\n  },\n\n  constructTableAPIs: (table) => {\n    assignTableAPIs('columnResizingFeature', table, {\n      table_setColumnResizing: {\n        fn: (updater) => table_setColumnResizing(table, updater),\n      },\n      table_resetHeaderSizeInfo: {\n        fn: (defaultState) => table_resetHeaderSizeInfo(table, defaultState),\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAkBA,MAAa,wBAAsC;CACjD,kBAAkB,iBAAiB;EACjC,OAAO;GACL,gBAAgB,8BAA8B;GAC9C,GAAG;EACL;CACF;CAEA,yBAAyB,UAAU;EACjC,OAAO;GACL,kBAAkB;GAClB,uBAAuB;GACvB,wBAAwB,iBAAiB,kBAAkB,KAAK;EAClE;CACF;CAEA,wBAAwB,WAAW,UAAU;EAC3C,oBAAoB,yBAAyB,WAAW,OAAO;GAC7D,qBAAqB,EACnB,KAAK,WAAW,oBAAoB,MAAM,EAC5C;GACA,sBAAsB,EACpB,KAAK,WAAW,qBAAqB,MAAM,EAC7C;EACF,CAAC;CACH;CAEA,wBAAwB,WAAW,UAAU;EAC3C,oBAAoB,yBAAyB,WAAW,OAAO,EAC7D,yBAAyB,EACvB,KAAK,QAAQ,qBACX,wBAAwB,QAAQ,gBAAgB,EACpD,EACF,CAAC;CACH;CAEA,qBAAqB,UAAU;EAC7B,gBAAgB,yBAAyB,OAAO;GAC9C,yBAAyB,EACvB,KAAK,YAAY,wBAAwB,OAAO,OAAO,EACzD;GACA,2BAA2B,EACzB,KAAK,iBAAiB,0BAA0B,OAAO,YAAY,EACrE;EACF,CAAC;CACH;AACF"}

package/dist/features/column-resizing/columnResizingFeature.types.d.cts

@@ -0,0 +1,81 @@
+import { OnChangeFn, Updater } from "../../types/type-utils.cjs";
+
+//#region src/features/column-resizing/columnResizingFeature.types.d.ts
+interface TableState_ColumnResizing {
+  columnResizing: columnResizingState;
+}
+interface columnResizingState {
+  columnSizingStart: Array<[string, number]>;
+  deltaOffset: null | number;
+  deltaPercentage: null | number;
+  isResizingColumn: false | string;
+  startOffset: null | number;
+  startSize: null | number;
+}
+type ColumnResizeMode = 'onChange' | 'onEnd';
+type ColumnResizeDirection = 'ltr' | 'rtl';
+interface TableOptions_ColumnResizing {
+  /**
+   * Determines when committed `columnSizing` values are updated. `onChange`
+   * commits sizes while the resize handle is dragged; `onEnd` commits when the
+   * resize interaction finishes.
+   */
+  columnResizeMode?: ColumnResizeMode;
+  /**
+   * Enables or disables column resizing for the whole table.
+   */
+  enableColumnResizing?: boolean;
+  /**
+   * Sets the resize direction used to calculate drag offsets. Defaults to `ltr`.
+   */
+  columnResizeDirection?: ColumnResizeDirection;
+  /**
+   * Called with an updater when the transient `columnResizing` state changes.
+   * Pair this with `state.columnResizing` when using external state; external
+   * atoms can own the slice without this callback.
+   */
+  onColumnResizingChange?: OnChangeFn<columnResizingState>;
+}
+type ColumnResizingDefaultOptions = Pick<TableOptions_ColumnResizing, 'columnResizeMode' | 'onColumnResizingChange' | 'columnResizeDirection'>;
+interface Table_ColumnResizing {
+  /**
+   * Resets `columnResizing` to `initialState.columnResizing`.
+   *
+   * Pass `true` to ignore initial state and reset to the no-drag default state.
+   */
+  resetHeaderSizeInfo: (defaultState?: boolean) => void;
+  /**
+   * Updates transient resize interaction state with a next state or updater function.
+   *
+   * The lowercase `c` in this API name matches the current generated v9 table
+   * API for the `columnResizing` state slice.
+   */
+  setcolumnResizing: (updater: Updater<columnResizingState>) => void;
+}
+interface ColumnDef_ColumnResizing {
+  /**
+   * Enables or disables column resizing for the column.
+   */
+  enableResizing?: boolean;
+}
+interface Column_ColumnResizing {
+  /**
+   * Checks whether this column can start a resize interaction.
+   */
+  getCanResize: () => boolean;
+  /**
+   * Checks whether this column is the active resize target.
+   */
+  getIsResizing: () => boolean;
+}
+interface Header_ColumnResizing {
+  /**
+   * Creates the `onMouseDown`/`onTouchStart` handler for a resize handle.
+   *
+   * Dragging and release listeners are installed and cleaned up automatically.
+   */
+  getResizeHandler: (context?: Document) => (event: unknown) => void;
+}
+//#endregion
+export { ColumnDef_ColumnResizing, ColumnResizeDirection, ColumnResizeMode, ColumnResizingDefaultOptions, Column_ColumnResizing, Header_ColumnResizing, TableOptions_ColumnResizing, TableState_ColumnResizing, Table_ColumnResizing, columnResizingState };
+//# sourceMappingURL=columnResizingFeature.types.d.cts.map

package/dist/features/column-resizing/columnResizingFeature.types.d.ts

@@ -0,0 +1,81 @@
+import { OnChangeFn, Updater } from "../../types/type-utils.js";
+
+//#region src/features/column-resizing/columnResizingFeature.types.d.ts
+interface TableState_ColumnResizing {
+  columnResizing: columnResizingState;
+}
+interface columnResizingState {
+  columnSizingStart: Array<[string, number]>;
+  deltaOffset: null | number;
+  deltaPercentage: null | number;
+  isResizingColumn: false | string;
+  startOffset: null | number;
+  startSize: null | number;
+}
+type ColumnResizeMode = 'onChange' | 'onEnd';
+type ColumnResizeDirection = 'ltr' | 'rtl';
+interface TableOptions_ColumnResizing {
+  /**
+   * Determines when committed `columnSizing` values are updated. `onChange`
+   * commits sizes while the resize handle is dragged; `onEnd` commits when the
+   * resize interaction finishes.
+   */
+  columnResizeMode?: ColumnResizeMode;
+  /**
+   * Enables or disables column resizing for the whole table.
+   */
+  enableColumnResizing?: boolean;
+  /**
+   * Sets the resize direction used to calculate drag offsets. Defaults to `ltr`.
+   */
+  columnResizeDirection?: ColumnResizeDirection;
+  /**
+   * Called with an updater when the transient `columnResizing` state changes.
+   * Pair this with `state.columnResizing` when using external state; external
+   * atoms can own the slice without this callback.
+   */
+  onColumnResizingChange?: OnChangeFn<columnResizingState>;
+}
+type ColumnResizingDefaultOptions = Pick<TableOptions_ColumnResizing, 'columnResizeMode' | 'onColumnResizingChange' | 'columnResizeDirection'>;
+interface Table_ColumnResizing {
+  /**
+   * Resets `columnResizing` to `initialState.columnResizing`.
+   *
+   * Pass `true` to ignore initial state and reset to the no-drag default state.
+   */
+  resetHeaderSizeInfo: (defaultState?: boolean) => void;
+  /**
+   * Updates transient resize interaction state with a next state or updater function.
+   *
+   * The lowercase `c` in this API name matches the current generated v9 table
+   * API for the `columnResizing` state slice.
+   */
+  setcolumnResizing: (updater: Updater<columnResizingState>) => void;
+}
+interface ColumnDef_ColumnResizing {
+  /**
+   * Enables or disables column resizing for the column.
+   */
+  enableResizing?: boolean;
+}
+interface Column_ColumnResizing {
+  /**
+   * Checks whether this column can start a resize interaction.
+   */
+  getCanResize: () => boolean;
+  /**
+   * Checks whether this column is the active resize target.
+   */
+  getIsResizing: () => boolean;
+}
+interface Header_ColumnResizing {
+  /**
+   * Creates the `onMouseDown`/`onTouchStart` handler for a resize handle.
+   *
+   * Dragging and release listeners are installed and cleaned up automatically.
+   */
+  getResizeHandler: (context?: Document) => (event: unknown) => void;
+}
+//#endregion
+export { ColumnDef_ColumnResizing, ColumnResizeDirection, ColumnResizeMode, ColumnResizingDefaultOptions, Column_ColumnResizing, Header_ColumnResizing, TableOptions_ColumnResizing, TableState_ColumnResizing, Table_ColumnResizing, columnResizingState };
+//# sourceMappingURL=columnResizingFeature.types.d.ts.map

package/dist/features/column-resizing/columnResizingFeature.utils.cjs

@@ -0,0 +1,246 @@
+const require_utils = require('../../utils.cjs');
+const require_columnSizingFeature_utils = require('../column-sizing/columnSizingFeature.utils.cjs');
+
+//#region src/features/column-resizing/columnResizingFeature.utils.ts
+/**
+* Creates the default transient column resizing state.
+*
+* The feature default represents no active drag interaction. Reset APIs use
+* this value when `defaultState` is `true`.
+*
+* @example
+* ```ts
+* const resizeInfo = getDefaultColumnResizingState()
+* ```
+*/
+function getDefaultColumnResizingState() {
+	return {
+		startOffset: null,
+		startSize: null,
+		deltaOffset: null,
+		deltaPercentage: null,
+		isResizingColumn: false,
+		columnSizingStart: []
+	};
+}
+/**
+* Checks whether this column can start a resize interaction.
+*
+* Both `columnDef.enableResizing` and table `enableColumnResizing` default to
+* `true`.
+*
+* @example
+* ```ts
+* const canResize = column_getCanResize(column)
+* ```
+*/
+function column_getCanResize(column) {
+	return (column.columnDef.enableResizing ?? true) && (column.table.options.enableColumnResizing ?? true);
+}
+/**
+* Checks whether this column is the active column resize target.
+*
+* The value is read from `state.columnResizing.isResizingColumn`.
+*
+* @example
+* ```ts
+* const isResizing = column_getIsResizing(column)
+* ```
+*/
+function column_getIsResizing(column) {
+	var _column$table$atoms$c;
+	return ((_column$table$atoms$c = column.table.atoms.columnResizing) === null || _column$table$atoms$c === void 0 || (_column$table$atoms$c = _column$table$atoms$c.get()) === null || _column$table$atoms$c === void 0 ? void 0 : _column$table$atoms$c.isResizingColumn) === column.id;
+}
+/**
+* Creates the pointer/touch start handler for resizing a header.
+*
+* The handler records starting sizes for all leaf headers, tracks drag deltas,
+* writes transient resize info, and commits column sizes on change or drag end
+* depending on `columnResizeMode`.
+*
+* @example
+* ```ts
+* const onMouseDown = header_getResizeHandler(header)
+* ```
+*/
+function header_getResizeHandler(header, _contextDocument) {
+	const column = header.table.getColumn(header.column.id);
+	const canResize = column_getCanResize(column);
+	return (event) => {
+		var _persist;
+		if (!canResize) return;
+		(_persist = event.persist) === null || _persist === void 0 || _persist.call(event);
+		if (isTouchStartEvent(event)) {
+			if (event.touches.length > 1) return;
+		}
+		const startSize = require_columnSizingFeature_utils.header_getSize(header);
+		const columnSizingStart = header.getLeafHeaders().map((leafHeader) => [leafHeader.column.id, require_columnSizingFeature_utils.column_getSize(leafHeader.column)]);
+		const clientX = isTouchStartEvent(event) ? Math.round(event.touches[0].clientX) : event.clientX;
+		const newColumnSizing = {};
+		const updateOffset = (eventType, clientXPos) => {
+			if (typeof clientXPos !== "number") return;
+			table_setColumnResizing(column.table, (old) => {
+				const deltaDirection = column.table.options.columnResizeDirection === "rtl" ? -1 : 1;
+				const deltaOffset = (clientXPos - (old.startOffset ?? 0)) * deltaDirection;
+				const startSize = old.startSize ?? 0;
+				const deltaPercentage = Math.max(startSize > 0 ? deltaOffset / startSize : 0, -.999999);
+				old.columnSizingStart.forEach(([columnId, headerSize]) => {
+					newColumnSizing[columnId] = Math.round(Math.max(headerSize > 0 ? headerSize + headerSize * deltaPercentage : deltaOffset / old.columnSizingStart.length, 0) * 100) / 100;
+				});
+				return {
+					...old,
+					deltaOffset,
+					deltaPercentage
+				};
+			});
+			if (column.table.options.columnResizeMode === "onChange" || eventType === "end") require_columnSizingFeature_utils.table_setColumnSizing(column.table, (old) => ({
+				...old,
+				...newColumnSizing
+			}));
+		};
+		const onMove = (clientXPos) => updateOffset("move", clientXPos);
+		const onEnd = (clientXPos) => {
+			updateOffset("end", clientXPos);
+			table_setColumnResizing(column.table, (old) => ({
+				...old,
+				isResizingColumn: false,
+				startOffset: null,
+				startSize: null,
+				deltaOffset: null,
+				deltaPercentage: null,
+				columnSizingStart: []
+			}));
+		};
+		const contextDocument = _contextDocument || typeof document !== "undefined" ? document : null;
+		const mouseEvents = {
+			moveHandler: (e) => onMove(e.clientX),
+			upHandler: (e) => {
+				contextDocument === null || contextDocument === void 0 || contextDocument.removeEventListener("mousemove", mouseEvents.moveHandler);
+				contextDocument === null || contextDocument === void 0 || contextDocument.removeEventListener("mouseup", mouseEvents.upHandler);
+				onEnd(e.clientX);
+			}
+		};
+		const touchEvents = {
+			moveHandler: (touchEvent) => {
+				if (touchEvent.cancelable) {
+					touchEvent.preventDefault();
+					touchEvent.stopPropagation();
+				}
+				onMove(touchEvent.touches[0].clientX);
+				return false;
+			},
+			upHandler: (e) => {
+				var _e$touches$;
+				contextDocument === null || contextDocument === void 0 || contextDocument.removeEventListener("touchmove", touchEvents.moveHandler);
+				contextDocument === null || contextDocument === void 0 || contextDocument.removeEventListener("touchend", touchEvents.upHandler);
+				if (e.cancelable) {
+					e.preventDefault();
+					e.stopPropagation();
+				}
+				onEnd((_e$touches$ = e.touches[0]) === null || _e$touches$ === void 0 ? void 0 : _e$touches$.clientX);
+			}
+		};
+		const passiveIfSupported = passiveEventSupported() ? { passive: false } : false;
+		if (isTouchStartEvent(event)) {
+			contextDocument === null || contextDocument === void 0 || contextDocument.addEventListener("touchmove", touchEvents.moveHandler, passiveIfSupported);
+			contextDocument === null || contextDocument === void 0 || contextDocument.addEventListener("touchend", touchEvents.upHandler, passiveIfSupported);
+		} else {
+			contextDocument === null || contextDocument === void 0 || contextDocument.addEventListener("mousemove", mouseEvents.moveHandler, passiveIfSupported);
+			contextDocument === null || contextDocument === void 0 || contextDocument.addEventListener("mouseup", mouseEvents.upHandler, passiveIfSupported);
+		}
+		table_setColumnResizing(column.table, (old) => ({
+			...old,
+			startOffset: clientX,
+			startSize,
+			deltaOffset: 0,
+			deltaPercentage: 0,
+			columnSizingStart,
+			isResizingColumn: column.id
+		}));
+	};
+}
+/**
+* Routes a transient column resizing updater through the table's resize handler.
+*
+* This state tracks the active drag interaction; committed widths live in
+* `columnSizing`.
+*
+* @example
+* ```ts
+* table_setColumnResizing(table, (old) => ({ ...old, deltaOffset: 12 }))
+* ```
+*/
+function table_setColumnResizing(table, updater) {
+	var _table$options$onColu, _table$options;
+	(_table$options$onColu = (_table$options = table.options).onColumnResizingChange) === null || _table$options$onColu === void 0 || _table$options$onColu.call(_table$options, updater);
+}
+/**
+* Resets `columnResizing` to the configured initial state or feature default.
+*
+* With no argument, the reset clones `table.initialState.columnResizing` when
+* it exists. Passing `true` ignores initial state and resets to the no-drag
+* default state.
+*
+* @example
+* ```ts
+* table_resetHeaderSizeInfo(table)
+* table_resetHeaderSizeInfo(table, true)
+* ```
+*/
+function table_resetHeaderSizeInfo(table, defaultState) {
+	table_setColumnResizing(table, defaultState ? getDefaultColumnResizingState() : require_utils.cloneState(table.initialState.columnResizing ?? getDefaultColumnResizingState()));
+}
+let passiveSupported = null;
+/**
+* Detects whether the current environment supports passive event listeners.
+*
+* Column resizing uses this to register pointer and touch listeners with
+* `passive: false` only when the environment understands passive options.
+*
+* @example
+* ```ts
+* const canUsePassiveListeners = passiveEventSupported()
+* ```
+*/
+function passiveEventSupported() {
+	if (typeof passiveSupported === "boolean") return passiveSupported;
+	let supported = false;
+	try {
+		const options = { get passive() {
+			supported = true;
+			return false;
+		} };
+		const noop = () => {};
+		window.addEventListener("test", noop, options);
+		window.removeEventListener("test", noop);
+	} catch (err) {
+		supported = false;
+	}
+	passiveSupported = supported;
+	return passiveSupported;
+}
+/**
+* Narrows an unknown event to a `touchstart` event.
+*
+* Column resizing uses this before reading touch coordinates and installing
+* touch-specific listeners.
+*
+* @example
+* ```ts
+* const isTouch = isTouchStartEvent(event)
+* ```
+*/
+function isTouchStartEvent(e) {
+	return e.type === "touchstart";
+}
+
+//#endregion
+exports.column_getCanResize = column_getCanResize;
+exports.column_getIsResizing = column_getIsResizing;
+exports.getDefaultColumnResizingState = getDefaultColumnResizingState;
+exports.header_getResizeHandler = header_getResizeHandler;
+exports.isTouchStartEvent = isTouchStartEvent;
+exports.passiveEventSupported = passiveEventSupported;
+exports.table_resetHeaderSizeInfo = table_resetHeaderSizeInfo;
+exports.table_setColumnResizing = table_setColumnResizing;
+//# sourceMappingURL=columnResizingFeature.utils.cjs.map

package/dist/features/column-resizing/columnResizingFeature.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnResizingFeature.utils.cjs","names":["header_getSize","column_getSize","cloneState"],"sources":["../../../src/features/column-resizing/columnResizingFeature.utils.ts"],"sourcesContent":["import {\n  column_getSize,\n  header_getSize,\n  table_setColumnSizing,\n} from '../column-sizing/columnSizingFeature.utils'\nimport { cloneState } from '../../utils'\nimport type { CellData, RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Header } from '../../types/Header'\nimport type { Column_Internal } from '../../types/Column'\nimport type { ColumnSizingState } from '../column-sizing/columnSizingFeature.types'\nimport type { columnResizingState } from './columnResizingFeature.types'\n\n/**\n * Creates the default transient column resizing state.\n *\n * The feature default represents no active drag interaction. Reset APIs use\n * this value when `defaultState` is `true`.\n *\n * @example\n * ```ts\n * const resizeInfo = getDefaultColumnResizingState()\n * ```\n */\nexport function getDefaultColumnResizingState(): columnResizingState {\n  return {\n    startOffset: null,\n    startSize: null,\n    deltaOffset: null,\n    deltaPercentage: null,\n    isResizingColumn: false,\n    columnSizingStart: [],\n  }\n}\n\n/**\n * Checks whether this column can start a resize interaction.\n *\n * Both `columnDef.enableResizing` and table `enableColumnResizing` default to\n * `true`.\n *\n * @example\n * ```ts\n * const canResize = column_getCanResize(column)\n * ```\n */\nexport function column_getCanResize<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return (\n    (column.columnDef.enableResizing ?? true) &&\n    (column.table.options.enableColumnResizing ?? true)\n  )\n}\n\n/**\n * Checks whether this column is the active column resize target.\n *\n * The value is read from `state.columnResizing.isResizingColumn`.\n *\n * @example\n * ```ts\n * const isResizing = column_getIsResizing(column)\n * ```\n */\nexport function column_getIsResizing<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return (\n    column.table.atoms.columnResizing?.get()?.isResizingColumn === column.id\n  )\n}\n\n/**\n * Creates the pointer/touch start handler for resizing a header.\n *\n * The handler records starting sizes for all leaf headers, tracks drag deltas,\n * writes transient resize info, and commits column sizes on change or drag end\n * depending on `columnResizeMode`.\n *\n * @example\n * ```ts\n * const onMouseDown = header_getResizeHandler(header)\n * ```\n */\nexport function header_getResizeHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(header: Header<TFeatures, TData, TValue>, _contextDocument?: Document) {\n  const column = header.table.getColumn(header.column.id)!\n  const canResize = column_getCanResize(column)\n\n  return (event: unknown) => {\n    if (!canResize) {\n      return\n    }\n\n    ;(event as any).persist?.()\n\n    if (isTouchStartEvent(event)) {\n      // lets not respond to multiple touches (e.g. 2 or 3 fingers)\n      if (event.touches.length > 1) {\n        return\n      }\n    }\n\n    const startSize = header_getSize(header)\n\n    const columnSizingStart: Array<[string, number]> = header\n      .getLeafHeaders()\n      .map((leafHeader) => [\n        leafHeader.column.id,\n        column_getSize(leafHeader.column),\n      ])\n\n    const clientX = isTouchStartEvent(event)\n      ? Math.round(event.touches[0]!.clientX)\n      : (event as MouseEvent).clientX\n\n    const newColumnSizing: ColumnSizingState = {}\n\n    const updateOffset = (eventType: 'move' | 'end', clientXPos?: number) => {\n      if (typeof clientXPos !== 'number') {\n        return\n      }\n\n      table_setColumnResizing(column.table, (old) => {\n        const deltaDirection =\n          column.table.options.columnResizeDirection === 'rtl' ? -1 : 1\n        const deltaOffset =\n          (clientXPos - (old.startOffset ?? 0)) * deltaDirection\n        const startSize = old.startSize ?? 0\n        const deltaPercentage = Math.max(\n          startSize > 0 ? deltaOffset / startSize : 0,\n          -0.999999,\n        )\n\n        old.columnSizingStart.forEach(([columnId, headerSize]) => {\n          newColumnSizing[columnId] =\n            Math.round(\n              Math.max(\n                headerSize > 0\n                  ? headerSize + headerSize * deltaPercentage\n                  : deltaOffset / old.columnSizingStart.length,\n                0,\n              ) * 100,\n            ) / 100\n        })\n\n        return {\n          ...old,\n          deltaOffset,\n          deltaPercentage,\n        }\n      })\n\n      if (\n        column.table.options.columnResizeMode === 'onChange' ||\n        eventType === 'end'\n      ) {\n        table_setColumnSizing(column.table, (old) => ({\n          ...old,\n          ...newColumnSizing,\n        }))\n      }\n    }\n\n    const onMove = (clientXPos?: number) => updateOffset('move', clientXPos)\n\n    const onEnd = (clientXPos?: number) => {\n      updateOffset('end', clientXPos)\n\n      table_setColumnResizing(column.table, (old) => ({\n        ...old,\n        isResizingColumn: false,\n        startOffset: null,\n        startSize: null,\n        deltaOffset: null,\n        deltaPercentage: null,\n        columnSizingStart: [],\n      }))\n    }\n\n    const contextDocument =\n      _contextDocument || typeof document !== 'undefined' ? document : null\n\n    const mouseEvents = {\n      moveHandler: (e: MouseEvent) => onMove(e.clientX),\n      upHandler: (e: MouseEvent) => {\n        contextDocument?.removeEventListener(\n          'mousemove',\n          mouseEvents.moveHandler,\n        )\n        contextDocument?.removeEventListener('mouseup', mouseEvents.upHandler)\n        onEnd(e.clientX)\n      },\n    }\n\n    const touchEvents = {\n      moveHandler: (touchEvent: TouchEvent) => {\n        if (touchEvent.cancelable) {\n          touchEvent.preventDefault()\n          touchEvent.stopPropagation()\n        }\n        onMove(touchEvent.touches[0]!.clientX)\n        return false\n      },\n      upHandler: (e: TouchEvent) => {\n        contextDocument?.removeEventListener(\n          'touchmove',\n          touchEvents.moveHandler,\n        )\n        contextDocument?.removeEventListener('touchend', touchEvents.upHandler)\n        if (e.cancelable) {\n          e.preventDefault()\n          e.stopPropagation()\n        }\n        onEnd(e.touches[0]?.clientX)\n      },\n    }\n\n    const passiveIfSupported = passiveEventSupported()\n      ? { passive: false }\n      : false\n\n    if (isTouchStartEvent(event)) {\n      contextDocument?.addEventListener(\n        'touchmove',\n        touchEvents.moveHandler,\n        passiveIfSupported,\n      )\n      contextDocument?.addEventListener(\n        'touchend',\n        touchEvents.upHandler,\n        passiveIfSupported,\n      )\n    } else {\n      contextDocument?.addEventListener(\n        'mousemove',\n        mouseEvents.moveHandler,\n        passiveIfSupported,\n      )\n      contextDocument?.addEventListener(\n        'mouseup',\n        mouseEvents.upHandler,\n        passiveIfSupported,\n      )\n    }\n\n    table_setColumnResizing(column.table, (old) => ({\n      ...old,\n      startOffset: clientX,\n      startSize,\n      deltaOffset: 0,\n      deltaPercentage: 0,\n      columnSizingStart,\n      isResizingColumn: column.id,\n    }))\n  }\n}\n\n/**\n * Routes a transient column resizing updater through the table's resize handler.\n *\n * This state tracks the active drag interaction; committed widths live in\n * `columnSizing`.\n *\n * @example\n * ```ts\n * table_setColumnResizing(table, (old) => ({ ...old, deltaOffset: 12 }))\n * ```\n */\nexport function table_setColumnResizing<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<columnResizingState>,\n) {\n  table.options.onColumnResizingChange?.(updater)\n}\n\n/**\n * Resets `columnResizing` to the configured initial state or feature default.\n *\n * With no argument, the reset clones `table.initialState.columnResizing` when\n * it exists. Passing `true` ignores initial state and resets to the no-drag\n * default state.\n *\n * @example\n * ```ts\n * table_resetHeaderSizeInfo(table)\n * table_resetHeaderSizeInfo(table, true)\n * ```\n */\nexport function table_resetHeaderSizeInfo<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setColumnResizing(\n    table,\n    defaultState\n      ? getDefaultColumnResizingState()\n      : cloneState(\n          table.initialState.columnResizing ?? getDefaultColumnResizingState(),\n        ),\n  )\n}\n\nlet passiveSupported: boolean | null = null\n/**\n * Detects whether the current environment supports passive event listeners.\n *\n * Column resizing uses this to register pointer and touch listeners with\n * `passive: false` only when the environment understands passive options.\n *\n * @example\n * ```ts\n * const canUsePassiveListeners = passiveEventSupported()\n * ```\n */\nexport function passiveEventSupported() {\n  if (typeof passiveSupported === 'boolean') return passiveSupported\n\n  let supported = false\n  try {\n    const options = {\n      get passive() {\n        supported = true\n        return false\n      },\n    }\n\n    const noop = () => {}\n\n    window.addEventListener('test', noop, options)\n    window.removeEventListener('test', noop)\n  } catch (err) {\n    supported = false\n  }\n  passiveSupported = supported\n  return passiveSupported\n}\n\n/**\n * Narrows an unknown event to a `touchstart` event.\n *\n * Column resizing uses this before reading touch coordinates and installing\n * touch-specific listeners.\n *\n * @example\n * ```ts\n * const isTouch = isTouchStartEvent(event)\n * ```\n */\nexport function isTouchStartEvent(e: unknown): e is TouchEvent {\n  return (e as TouchEvent).type === 'touchstart'\n}\n"],"mappings":"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"}

package/dist/features/column-resizing/columnResizingFeature.utils.d.cts

@@ -0,0 +1,109 @@
+import { CellData, RowData, Updater } from "../../types/type-utils.cjs";
+import { columnResizingState } from "./columnResizingFeature.types.cjs";
+import { Header } from "../../types/Header.cjs";
+import { Column_Internal } from "../../types/Column.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/features/column-resizing/columnResizingFeature.utils.d.ts
+/**
+ * Creates the default transient column resizing state.
+ *
+ * The feature default represents no active drag interaction. Reset APIs use
+ * this value when `defaultState` is `true`.
+ *
+ * @example
+ * ```ts
+ * const resizeInfo = getDefaultColumnResizingState()
+ * ```
+ */
+declare function getDefaultColumnResizingState(): columnResizingState;
+/**
+ * Checks whether this column can start a resize interaction.
+ *
+ * Both `columnDef.enableResizing` and table `enableColumnResizing` default to
+ * `true`.
+ *
+ * @example
+ * ```ts
+ * const canResize = column_getCanResize(column)
+ * ```
+ */
+declare function column_getCanResize<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): boolean;
+/**
+ * Checks whether this column is the active column resize target.
+ *
+ * The value is read from `state.columnResizing.isResizingColumn`.
+ *
+ * @example
+ * ```ts
+ * const isResizing = column_getIsResizing(column)
+ * ```
+ */
+declare function column_getIsResizing<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): boolean;
+/**
+ * Creates the pointer/touch start handler for resizing a header.
+ *
+ * The handler records starting sizes for all leaf headers, tracks drag deltas,
+ * writes transient resize info, and commits column sizes on change or drag end
+ * depending on `columnResizeMode`.
+ *
+ * @example
+ * ```ts
+ * const onMouseDown = header_getResizeHandler(header)
+ * ```
+ */
+declare function header_getResizeHandler<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(header: Header<TFeatures, TData, TValue>, _contextDocument?: Document): (event: unknown) => void;
+/**
+ * Routes a transient column resizing updater through the table's resize handler.
+ *
+ * This state tracks the active drag interaction; committed widths live in
+ * `columnSizing`.
+ *
+ * @example
+ * ```ts
+ * table_setColumnResizing(table, (old) => ({ ...old, deltaOffset: 12 }))
+ * ```
+ */
+declare function table_setColumnResizing<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<columnResizingState>): void;
+/**
+ * Resets `columnResizing` to the configured initial state or feature default.
+ *
+ * With no argument, the reset clones `table.initialState.columnResizing` when
+ * it exists. Passing `true` ignores initial state and resets to the no-drag
+ * default state.
+ *
+ * @example
+ * ```ts
+ * table_resetHeaderSizeInfo(table)
+ * table_resetHeaderSizeInfo(table, true)
+ * ```
+ */
+declare function table_resetHeaderSizeInfo<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
+/**
+ * Detects whether the current environment supports passive event listeners.
+ *
+ * Column resizing uses this to register pointer and touch listeners with
+ * `passive: false` only when the environment understands passive options.
+ *
+ * @example
+ * ```ts
+ * const canUsePassiveListeners = passiveEventSupported()
+ * ```
+ */
+declare function passiveEventSupported(): boolean;
+/**
+ * Narrows an unknown event to a `touchstart` event.
+ *
+ * Column resizing uses this before reading touch coordinates and installing
+ * touch-specific listeners.
+ *
+ * @example
+ * ```ts
+ * const isTouch = isTouchStartEvent(event)
+ * ```
+ */
+declare function isTouchStartEvent(e: unknown): e is TouchEvent;
+//#endregion
+export { column_getCanResize, column_getIsResizing, getDefaultColumnResizingState, header_getResizeHandler, isTouchStartEvent, passiveEventSupported, table_resetHeaderSizeInfo, table_setColumnResizing };
+//# sourceMappingURL=columnResizingFeature.utils.d.cts.map