@tanstack/table-core 9.0.0-alpha.47 → 9.0.0-alpha.49

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

@@ -7,42 +7,46 @@ import { Table_Internal } from "../../types/Table.js";
 
 //#region src/features/column-resizing/columnResizingFeature.utils.d.ts
 /**
- * Returns the default column resizing state.
+ * Creates the default transient column resizing state.
  *
- * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+ * The feature default represents no active drag interaction. Reset APIs use
+ * this value when `defaultState` is `true`.
  *
  * @example
  * ```ts
- * const initialValue = getDefaultColumnResizingState()
+ * const resizeInfo = getDefaultColumnResizingState()
  * ```
  */
 declare function getDefaultColumnResizingState(): columnResizingState;
 /**
- * Returns whether a column can use resize.
+ * Checks whether this column can start a resize interaction.
  *
- * This combines column options, table options, and any required accessor or feature state for the capability.
+ * Both `columnDef.enableResizing` and table `enableColumnResizing` default to
+ * `true`.
  *
  * @example
  * ```ts
- * const value = column_getCanResize(column)
+ * 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;
 /**
- * Returns is resizing for a column.
+ * Checks whether this column is the active column resize target.
  *
- * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ * The value is read from `state.columnResizing.isResizingColumn`.
  *
  * @example
  * ```ts
- * const value = column_getIsResizing(column)
+ * 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;
 /**
- * Returns resize handler for a header.
+ * Creates the pointer/touch start handler for resizing a header.
  *
- * This is the static implementation behind the matching header instance API and can account for nested header groups.
+ * 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
@@ -51,20 +55,23 @@ declare function column_getIsResizing<TFeatures extends TableFeatures, TData ext
  */
 declare function header_getResizeHandler<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(header: Header<TFeatures, TData, TValue>, _contextDocument?: Document): (event: unknown) => void;
 /**
- * Updates the table's column resizing state slice.
+ * Routes a transient column resizing updater through the table's resize handler.
  *
- * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ * This state tracks the active drag interaction; committed widths live in
+ * `columnSizing`.
  *
  * @example
  * ```ts
- * table_setColumnResizing(table, (old) => old)
+ * 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 the table's header size info state slice.
+ * Resets `columnResizing` to the configured initial state or feature default.
  *
- * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ * 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
@@ -76,7 +83,8 @@ declare function table_resetHeaderSizeInfo<TFeatures extends TableFeatures, TDat
 /**
  * Detects whether the current environment supports passive event listeners.
  *
- * Column resizing uses this to register pointer and touch listeners with the safest available options.
+ * Column resizing uses this to register pointer and touch listeners with
+ * `passive: false` only when the environment understands passive options.
  *
  * @example
  * ```ts
@@ -85,9 +93,10 @@ declare function table_resetHeaderSizeInfo<TFeatures extends TableFeatures, TDat
  */
 declare function passiveEventSupported(): boolean;
 /**
- * Returns whether an event is a touch-start event.
+ * Narrows an unknown event to a `touchstart` event.
  *
- * Column resizing uses this to normalize mouse and touch resize interactions.
+ * Column resizing uses this before reading touch coordinates and installing
+ * touch-specific listeners.
  *
  * @example
  * ```ts

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

@@ -4,13 +4,14 @@ import { column_getSize, header_getSize, table_setColumnSizing } from "../column
 
 //#region src/features/column-resizing/columnResizingFeature.utils.ts
 /**
-* Returns the default column resizing state.
+* Creates the default transient column resizing state.
 *
-* Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+* The feature default represents no active drag interaction. Reset APIs use
+* this value when `defaultState` is `true`.
 *
 * @example
 * ```ts
-* const initialValue = getDefaultColumnResizingState()
+* const resizeInfo = getDefaultColumnResizingState()
 * ```
 */
 function getDefaultColumnResizingState() {
@@ -24,26 +25,27 @@ function getDefaultColumnResizingState() {
 	};
 }
 /**
-* Returns whether a column can use resize.
+* Checks whether this column can start a resize interaction.
 *
-* This combines column options, table options, and any required accessor or feature state for the capability.
+* Both `columnDef.enableResizing` and table `enableColumnResizing` default to
+* `true`.
 *
 * @example
 * ```ts
-* const value = column_getCanResize(column)
+* const canResize = column_getCanResize(column)
 * ```
 */
 function column_getCanResize(column) {
 	return (column.columnDef.enableResizing ?? true) && (column.table.options.enableColumnResizing ?? true);
 }
 /**
-* Returns is resizing for a column.
+* Checks whether this column is the active column resize target.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* The value is read from `state.columnResizing.isResizingColumn`.
 *
 * @example
 * ```ts
-* const value = column_getIsResizing(column)
+* const isResizing = column_getIsResizing(column)
 * ```
 */
 function column_getIsResizing(column) {
@@ -51,9 +53,11 @@ function column_getIsResizing(column) {
 	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;
 }
 /**
-* Returns resize handler for a header.
+* Creates the pointer/touch start handler for resizing a header.
 *
-* This is the static implementation behind the matching header instance API and can account for nested header groups.
+* 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
@@ -157,13 +161,14 @@ function header_getResizeHandler(header, _contextDocument) {
 	};
 }
 /**
-* Updates the table's column resizing state slice.
+* Routes a transient column resizing updater through the table's resize handler.
 *
-* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+* This state tracks the active drag interaction; committed widths live in
+* `columnSizing`.
 *
 * @example
 * ```ts
-* table_setColumnResizing(table, (old) => old)
+* table_setColumnResizing(table, (old) => ({ ...old, deltaOffset: 12 }))
 * ```
 */
 function table_setColumnResizing(table, updater) {
@@ -171,9 +176,11 @@ function table_setColumnResizing(table, updater) {
 	(_table$options$onColu = (_table$options = table.options).onColumnResizingChange) === null || _table$options$onColu === void 0 || _table$options$onColu.call(_table$options, updater);
 }
 /**
-* Resets the table's header size info state slice.
+* Resets `columnResizing` to the configured initial state or feature default.
 *
-* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+* 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
@@ -184,10 +191,12 @@ function table_setColumnResizing(table, updater) {
 function table_resetHeaderSizeInfo(table, defaultState) {
 	table_setColumnResizing(table, defaultState ? getDefaultColumnResizingState() : 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 the safest available options.
+* Column resizing uses this to register pointer and touch listeners with
+* `passive: false` only when the environment understands passive options.
 *
 * @example
 * ```ts
@@ -195,7 +204,6 @@ function table_resetHeaderSizeInfo(table, defaultState) {
 * ```
 */
 function passiveEventSupported() {
-	let passiveSupported = null;
 	if (typeof passiveSupported === "boolean") return passiveSupported;
 	let supported = false;
 	try {
@@ -213,9 +221,10 @@ function passiveEventSupported() {
 	return passiveSupported;
 }
 /**
-* Returns whether an event is a touch-start event.
+* Narrows an unknown event to a `touchstart` event.
 *
-* Column resizing uses this to normalize mouse and touch resize interactions.
+* Column resizing uses this before reading touch coordinates and installing
+* touch-specific listeners.
 *
 * @example
 * ```ts

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

@@ -1 +1 @@
-{"version":3,"file":"columnResizingFeature.utils.js","names":[],"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 { table_getColumn } from '../../core/columns/coreColumnsFeature.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 * Returns the default column resizing state.\n *\n * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.\n *\n * @example\n * ```ts\n * const initialValue = 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 * Returns whether a column can use resize.\n *\n * This combines column options, table options, and any required accessor or feature state for the capability.\n *\n * @example\n * ```ts\n * const value = 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 * Returns is resizing for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = 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 * Returns resize handler for a header.\n *\n * This is the static implementation behind the matching header instance API and can account for nested header groups.\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 = table_getColumn(header.column.table, 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 * Updates the table's column resizing state slice.\n *\n * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.\n *\n * @example\n * ```ts\n * table_setColumnResizing(table, (old) => old)\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 the table's header size info state slice.\n *\n * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.\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\n/**\n * Detects whether the current environment supports passive event listeners.\n *\n * Column resizing uses this to register pointer and touch listeners with the safest available options.\n *\n * @example\n * ```ts\n * const canUsePassiveListeners = passiveEventSupported()\n * ```\n */\nexport function passiveEventSupported() {\n  let passiveSupported: boolean | null = null\n\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 * Returns whether an event is a touch-start event.\n *\n * Column resizing uses this to normalize mouse and touch resize interactions.\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":";;;;;;;;;;;;;;;AAyBA,SAAgB,gCAAqD;CACnE,OAAO;EACL,aAAa;EACb,WAAW;EACX,aAAa;EACb,iBAAiB;EACjB,kBAAkB;EAClB,mBAAmB,EAAE;EACtB;;;;;;;;;;;;AAaH,SAAgB,oBAId,QAAmD;CACnD,QACG,OAAO,UAAU,kBAAkB,UACnC,OAAO,MAAM,QAAQ,wBAAwB;;;;;;;;;;;;AAclD,SAAgB,qBAId,QAAmD;;CACnD,iCACE,OAAO,MAAM,MAAM,+GAAgB,KAAK,gFAAE,sBAAqB,OAAO;;;;;;;;;;;;AAc1E,SAAgB,wBAId,QAA0C,kBAA6B;CACvE,MAAM,SAAS,gBAAgB,OAAO,OAAO,OAAO,OAAO,OAAO,GAAG;CACrE,MAAM,YAAY,oBAAoB,OAAO;CAE7C,QAAQ,UAAmB;;EACzB,IAAI,CAAC,WACH;EAGD,YAAC,MAAc,gEAAW;EAE3B,IAAI,kBAAkB,MAAM,EAE1B;OAAI,MAAM,QAAQ,SAAS,GACzB;;EAIJ,MAAM,YAAY,eAAe,OAAO;EAExC,MAAM,oBAA6C,OAChD,gBAAgB,CAChB,KAAK,eAAe,CACnB,WAAW,OAAO,IAClB,eAAe,WAAW,OAAO,CAClC,CAAC;EAEJ,MAAM,UAAU,kBAAkB,MAAM,GACpC,KAAK,MAAM,MAAM,QAAQ,GAAI,QAAQ,GACpC,MAAqB;EAE1B,MAAM,kBAAqC,EAAE;EAE7C,MAAM,gBAAgB,WAA2B,eAAwB;GACvE,IAAI,OAAO,eAAe,UACxB;GAGF,wBAAwB,OAAO,QAAQ,QAAQ;IAC7C,MAAM,iBACJ,OAAO,MAAM,QAAQ,0BAA0B,QAAQ,KAAK;IAC9D,MAAM,eACH,cAAc,IAAI,eAAe,MAAM;IAC1C,MAAM,YAAY,IAAI,aAAa;IACnC,MAAM,kBAAkB,KAAK,IAC3B,YAAY,IAAI,cAAc,YAAY,GAC1C,SACD;IAED,IAAI,kBAAkB,SAAS,CAAC,UAAU,gBAAgB;KACxD,gBAAgB,YACd,KAAK,MACH,KAAK,IACH,aAAa,IACT,aAAa,aAAa,kBAC1B,cAAc,IAAI,kBAAkB,QACxC,EACD,GAAG,IACL,GAAG;MACN;IAEF,OAAO;KACL,GAAG;KACH;KACA;KACD;KACD;GAEF,IACE,OAAO,MAAM,QAAQ,qBAAqB,cAC1C,cAAc,OAEd,sBAAsB,OAAO,QAAQ,SAAS;IAC5C,GAAG;IACH,GAAG;IACJ,EAAE;;EAIP,MAAM,UAAU,eAAwB,aAAa,QAAQ,WAAW;EAExE,MAAM,SAAS,eAAwB;GACrC,aAAa,OAAO,WAAW;GAE/B,wBAAwB,OAAO,QAAQ,SAAS;IAC9C,GAAG;IACH,kBAAkB;IAClB,aAAa;IACb,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,mBAAmB,EAAE;IACtB,EAAE;;EAGL,MAAM,kBACJ,oBAAoB,OAAO,aAAa,cAAc,WAAW;EAEnE,MAAM,cAAc;GAClB,cAAc,MAAkB,OAAO,EAAE,QAAQ;GACjD,YAAY,MAAkB;IAC5B,0EAAiB,oBACf,aACA,YAAY,YACb;IACD,0EAAiB,oBAAoB,WAAW,YAAY,UAAU;IACtE,MAAM,EAAE,QAAQ;;GAEnB;EAED,MAAM,cAAc;GAClB,cAAc,eAA2B;IACvC,IAAI,WAAW,YAAY;KACzB,WAAW,gBAAgB;KAC3B,WAAW,iBAAiB;;IAE9B,OAAO,WAAW,QAAQ,GAAI,QAAQ;IACtC,OAAO;;GAET,YAAY,MAAkB;;IAC5B,0EAAiB,oBACf,aACA,YAAY,YACb;IACD,0EAAiB,oBAAoB,YAAY,YAAY,UAAU;IACvE,IAAI,EAAE,YAAY;KAChB,EAAE,gBAAgB;KAClB,EAAE,iBAAiB;;IAErB,qBAAM,EAAE,QAAQ,8DAAI,QAAQ;;GAE/B;EAED,MAAM,qBAAqB,uBAAuB,GAC9C,EAAE,SAAS,OAAO,GAClB;EAEJ,IAAI,kBAAkB,MAAM,EAAE;GAC5B,0EAAiB,iBACf,aACA,YAAY,aACZ,mBACD;GACD,0EAAiB,iBACf,YACA,YAAY,WACZ,mBACD;SACI;GACL,0EAAiB,iBACf,aACA,YAAY,aACZ,mBACD;GACD,0EAAiB,iBACf,WACA,YAAY,WACZ,mBACD;;EAGH,wBAAwB,OAAO,QAAQ,SAAS;GAC9C,GAAG;GACH,aAAa;GACb;GACA,aAAa;GACb,iBAAiB;GACjB;GACA,kBAAkB,OAAO;GAC1B,EAAE;;;;;;;;;;;;;AAcP,SAAgB,wBAId,OACA,SACA;;CACA,iDAAM,SAAQ,mHAAyB,QAAQ;;;;;;;;;;;;;AAcjD,SAAgB,0BAGd,OAAyC,cAAwB;CACjE,wBACE,OACA,eACI,+BAA+B,GAC/B,WACE,MAAM,aAAa,kBAAkB,+BAA+B,CACrE,CACN;;;;;;;;;;;;AAaH,SAAgB,wBAAwB;CACtC,IAAI,mBAAmC;CAEvC,IAAI,OAAO,qBAAqB,WAAW,OAAO;CAElD,IAAI,YAAY;CAChB,IAAI;EACF,MAAM,UAAU,EACd,IAAI,UAAU;GACZ,YAAY;GACZ,OAAO;KAEV;EAED,MAAM,aAAa;EAEnB,OAAO,iBAAiB,QAAQ,MAAM,QAAQ;EAC9C,OAAO,oBAAoB,QAAQ,KAAK;UACjC,KAAK;EACZ,YAAY;;CAEd,mBAAmB;CACnB,OAAO;;;;;;;;;;;;AAaT,SAAgB,kBAAkB,GAA6B;CAC7D,OAAQ,EAAiB,SAAS"}
+{"version":3,"file":"columnResizingFeature.utils.js","names":[],"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 { table_getColumn } from '../../core/columns/coreColumnsFeature.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 = table_getColumn(header.column.table, 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-sizing/columnSizingFeature.types.d.cts

@@ -17,19 +17,19 @@ interface TableOptions_ColumnSizing {
 type ColumnSizingDefaultOptions = Pick<TableOptions_ColumnSizing, 'onColumnSizingChange'>;
 interface Table_ColumnSizing {
   /**
-   * If pinning, returns the total size of the center portion of the table by calculating the sum of the sizes of all unpinned/center leaf-columns.
+   * Sums the current sizes of visible center-region leaf columns.
    */
   getCenterTotalSize: () => number;
   /**
-   * Returns the total size of the left portion of the table by calculating the sum of the sizes of all left leaf-columns.
+   * Sums the current sizes of visible left-pinned leaf columns.
    */
   getLeftTotalSize: () => number;
   /**
-   * Returns the total size of the right portion of the table by calculating the sum of the sizes of all right leaf-columns.
+   * Sums the current sizes of visible right-pinned leaf columns.
    */
   getRightTotalSize: () => number;
   /**
-   * Returns the total size of the table by calculating the sum of the sizes of all leaf-columns.
+   * Sums the current sizes of all visible leaf columns.
    */
   getTotalSize: () => number;
   /**
@@ -38,35 +38,42 @@ interface Table_ColumnSizing {
    */
   resetColumnSizing: (defaultState?: boolean) => void;
   /**
-   * Sets committed column sizing state using a value or updater.
+   * Updates committed column sizing state with a next map or updater function.
    */
   setColumnSizing: (updater: Updater<ColumnSizingState>) => void;
 }
 interface ColumnDef_ColumnSizing {
   /**
-   * The maximum allowed size for the column
+   * Upper bound used when resolving this column's size.
    */
   maxSize?: number;
   /**
-   * The minimum allowed size for the column
+   * Lower bound used when resolving this column's size.
    */
   minSize?: number;
   /**
-   * The desired size for the column
+   * Initial size used before column sizing state overrides it.
    */
   size?: number;
 }
 interface Column_ColumnSizing {
   /**
-   * Returns the offset measurement along the row-axis (usually the x-axis for standard tables) for the header. This is effectively a sum of the offset measurements of all succeeding (right) headers in relation to the current column.
+   * Measures the offset from this column's end edge to the end of its region.
+   *
+   * Pass a pinned region to measure within that region. The value is the sum
+   * of visible leaf column sizes after this column.
    */
   getAfter: (position?: ColumnPinningPosition | 'center') => number;
   /**
-   * Returns the current size of the column.
+   * Resolves the column's current size after state and min/max constraints.
    */
   getSize: () => number;
   /**
-   * Returns the offset measurement along the row-axis (usually the x-axis for standard tables) for the header. This is effectively a sum of the offset measurements of all preceding (left) headers in relation to the current column.
+   * Measures the offset from the start of this column's region to its start
+   * edge.
+   *
+   * Pass a pinned region to measure within that region. The value is the sum
+   * of visible leaf column sizes before this column.
    */
   getStart: (position?: ColumnPinningPosition | 'center') => number;
   /**
@@ -76,7 +83,7 @@ interface Column_ColumnSizing {
 }
 interface Header_ColumnSizing {
   /**
-   * Returns the current size of the header.
+   * Computes this header's rendered size from its leaf columns.
    */
   getSize: () => number;
   /**

package/dist/features/column-sizing/columnSizingFeature.types.d.ts

@@ -17,19 +17,19 @@ interface TableOptions_ColumnSizing {
 type ColumnSizingDefaultOptions = Pick<TableOptions_ColumnSizing, 'onColumnSizingChange'>;
 interface Table_ColumnSizing {
   /**
-   * If pinning, returns the total size of the center portion of the table by calculating the sum of the sizes of all unpinned/center leaf-columns.
+   * Sums the current sizes of visible center-region leaf columns.
    */
   getCenterTotalSize: () => number;
   /**
-   * Returns the total size of the left portion of the table by calculating the sum of the sizes of all left leaf-columns.
+   * Sums the current sizes of visible left-pinned leaf columns.
    */
   getLeftTotalSize: () => number;
   /**
-   * Returns the total size of the right portion of the table by calculating the sum of the sizes of all right leaf-columns.
+   * Sums the current sizes of visible right-pinned leaf columns.
    */
   getRightTotalSize: () => number;
   /**
-   * Returns the total size of the table by calculating the sum of the sizes of all leaf-columns.
+   * Sums the current sizes of all visible leaf columns.
    */
   getTotalSize: () => number;
   /**
@@ -38,35 +38,42 @@ interface Table_ColumnSizing {
    */
   resetColumnSizing: (defaultState?: boolean) => void;
   /**
-   * Sets committed column sizing state using a value or updater.
+   * Updates committed column sizing state with a next map or updater function.
    */
   setColumnSizing: (updater: Updater<ColumnSizingState>) => void;
 }
 interface ColumnDef_ColumnSizing {
   /**
-   * The maximum allowed size for the column
+   * Upper bound used when resolving this column's size.
    */
   maxSize?: number;
   /**
-   * The minimum allowed size for the column
+   * Lower bound used when resolving this column's size.
    */
   minSize?: number;
   /**
-   * The desired size for the column
+   * Initial size used before column sizing state overrides it.
    */
   size?: number;
 }
 interface Column_ColumnSizing {
   /**
-   * Returns the offset measurement along the row-axis (usually the x-axis for standard tables) for the header. This is effectively a sum of the offset measurements of all succeeding (right) headers in relation to the current column.
+   * Measures the offset from this column's end edge to the end of its region.
+   *
+   * Pass a pinned region to measure within that region. The value is the sum
+   * of visible leaf column sizes after this column.
    */
   getAfter: (position?: ColumnPinningPosition | 'center') => number;
   /**
-   * Returns the current size of the column.
+   * Resolves the column's current size after state and min/max constraints.
    */
   getSize: () => number;
   /**
-   * Returns the offset measurement along the row-axis (usually the x-axis for standard tables) for the header. This is effectively a sum of the offset measurements of all preceding (left) headers in relation to the current column.
+   * Measures the offset from the start of this column's region to its start
+   * edge.
+   *
+   * Pass a pinned region to measure within that region. The value is the sum
+   * of visible leaf column sizes before this column.
    */
   getStart: (position?: ColumnPinningPosition | 'center') => number;
   /**
@@ -76,7 +83,7 @@ interface Column_ColumnSizing {
 }
 interface Header_ColumnSizing {
   /**
-   * Returns the current size of the header.
+   * Computes this header's rendered size from its leaf columns.
    */
   getSize: () => number;
   /**