@cube-dev/ui-kit 0.196.0 → 0.198.0

package/dist/components/data/TableBase/use-column-window.js

@@ -1,9 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { c } from "react/compiler-runtime";
 import { CONTAINER_STYLES } from "@tenphi/tasty";
 import { useLayoutEffect, useState } from "react";
-
 //#region src/components/data/TableBase/use-column-window.ts
 const COLUMN_OVERSCAN = 300;
 const MAX_REFILL_COLUMNS = 1;
@@ -213,7 +212,7 @@ function useColumnWindow(layout, scroller, isEnabled, treeColumnKey) {
 	} else t7 = $[25];
 	return t7;
 }
-
 //#endregion
-export { canWindowColumns, useColumnWindow };
+export { canWindowColumns, getBufferedColumnWindowRange, getColumnWindowRange, getColumnWindowSegments, useColumnWindow };
+
 //# sourceMappingURL=use-column-window.js.map

package/dist/components/data/TableBase/use-column-window.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-column-window.js","names":["CONTAINER_STYLES","useLayoutEffect","useState","useEvent","Styles","CubeResolvedColumn","CubeTableColumnLayout","COLUMN_OVERSCAN","MAX_REFILL_COLUMNS","SAFE_FRAME_STYLES","Set","filter","key","includes","ColumnWindowRange","first","last","sameRange","left","right","ColumnWindowSegment","column","T","span","canWindowColumns","columns","styles","every","width","Number","isFinite","cellProps","Object","keys","has","getColumnWindowRange","layout","offset","viewportWidth","overscanStart","overscanEnd","start","Math","max","pinnedStartWidth","end","pinnedEndWidth","position","length","next","min","index","getBufferedColumnWindowRange","previous","required","totalWidth","extendsStart","extendsEnd","refilled","retainColumn","treeColumnKey","pin","isStructural","isRowHeader","autoHeight","render","cellStyles","getColumnWindowSegments","range","segments","omitted","firstOmittedKey","flushGap","push","useColumnWindow","scroller","isEnabled","$","_c","t0","some","isWindowEnabled","setRange","fitsRow","setFitsRow","t1","clientWidth","abs","scrollLeft","resetRange","t2","table","querySelector","computed","getComputedStyle","rowHeight","getPropertyValue","trim","height","parseFloat","lineHeight","refreshAppearance","t3","t4","update","t5","reset","undefined","width_0","previous_0","next_0","lastOffset","lastVerticalOffset","scrollTop","onScroll","offset_0","verticalOffset","reset_0","observer","ResizeObserver","observe","addEventListener","passive","disconnect","removeEventListener","t6","t7"],"sources":["../../../../src/components/data/TableBase/use-column-window.ts"],"sourcesContent":["import { CONTAINER_STYLES } from '@tenphi/tasty';\nimport { useLayoutEffect, useState } from 'react';\n\nimport { useEvent } from '../../../_internal/hooks/use-event';\n\nimport type { Styles } from '@tenphi/tasty';\nimport type { CubeResolvedColumn, CubeTableColumnLayout } from './types';\n\n// Keep nearby cells ready for a horizontal flick without multiplying the\n// mounted row window by the entire column collection.\nconst COLUMN_OVERSCAN = 300;\nconst MAX_REFILL_COLUMNS = 1;\nconst SAFE_FRAME_STYLES = new Set<string>(\n  CONTAINER_STYLES.filter(\n    (key) => !['font', 'preset', 'whiteSpace'].includes(key),\n  ),\n);\n\nexport interface ColumnWindowRange {\n  first: number;\n  last: number;\n}\n\nfunction sameRange(\n  left: ColumnWindowRange | null,\n  right: ColumnWindowRange | null,\n) {\n  if (left == null || right == null) return left === right;\n  return left.first === right.first && left.last === right.last;\n}\n\nexport type ColumnWindowSegment<T> =\n  | { column: CubeResolvedColumn<T>; key: string }\n  | { column?: undefined; key: string; span: number };\n\n/** Arbitrary body styling and DOM spans need the complete intrinsic layout. */\nexport function canWindowColumns<T>(\n  columns: readonly CubeResolvedColumn<T>[],\n  styles?: Styles,\n) {\n  return (\n    columns.every(\n      (column) =>\n        column.width != null &&\n        column.width > 0 &&\n        Number.isFinite(column.width) &&\n        !column.cellProps,\n    ) && Object.keys(styles ?? {}).every((key) => SAFE_FRAME_STYLES.has(key))\n  );\n}\n\nexport function getColumnWindowRange<T>(\n  layout: CubeTableColumnLayout<T>,\n  offset: number,\n  viewportWidth: number,\n  overscanStart = COLUMN_OVERSCAN,\n  overscanEnd = COLUMN_OVERSCAN,\n): ColumnWindowRange {\n  const start = Math.max(0, offset + layout.pinnedStartWidth - overscanStart);\n  const end = offset + viewportWidth - layout.pinnedEndWidth + overscanEnd;\n  let position = 0;\n  let first = layout.columns.length;\n  let last = -1;\n\n  for (const column of layout.columns) {\n    const next = position + column.width!;\n    if (next > start && position < end) {\n      first = Math.min(first, column.index);\n      last = column.index;\n    }\n    position = next;\n  }\n\n  return { first, last };\n}\n\n/** Refill the moving edge without rebuilding rows at every column boundary. */\nexport function getBufferedColumnWindowRange<T>(\n  layout: CubeTableColumnLayout<T>,\n  previous: ColumnWindowRange | null,\n  offset: number,\n  viewportWidth: number,\n): ColumnWindowRange {\n  const required = getColumnWindowRange(layout, offset, viewportWidth);\n  if (!previous) return required;\n  // Native scroll extents round fractional widths; no ahead buffer is\n  // needed within a pixel of either endpoint.\n  if (offset <= 0 || offset >= layout.totalWidth! - viewportWidth - 1)\n    return required;\n  const extendsStart = required.first < previous.first;\n  const extendsEnd = required.last > previous.last;\n  if (!extendsStart && !extendsEnd) {\n    const first = Math.max(previous.first, required.first - MAX_REFILL_COLUMNS);\n    const last = Math.min(previous.last, required.last + MAX_REFILL_COLUMNS);\n    return first === previous.first && last === previous.last\n      ? previous\n      : { first, last };\n  }\n  // Both edges moving means the viewport/layout changed, not one scroll edge.\n  if (extendsStart && extendsEnd) return required;\n  const refilled = getColumnWindowRange(\n    layout,\n    offset,\n    viewportWidth,\n    extendsStart ? COLUMN_OVERSCAN * 2 : COLUMN_OVERSCAN,\n    extendsEnd ? COLUMN_OVERSCAN * 2 : COLUMN_OVERSCAN,\n  );\n  // A pixel-only refill retains too many narrow cells during diagonal scroll.\n  return {\n    first: Math.max(refilled.first, required.first - MAX_REFILL_COLUMNS),\n    last: Math.min(refilled.last, required.last + MAX_REFILL_COLUMNS),\n  };\n}\n\n/** Preserve height-bearing cells, native controls and row naming offscreen. */\nfunction retainColumn<T>(\n  column: CubeResolvedColumn<T>,\n  treeColumnKey?: string,\n) {\n  return (\n    column.pin != null ||\n    column.isStructural ||\n    column.isRowHeader ||\n    column.key === treeColumnKey ||\n    column.autoHeight ||\n    column.render != null ||\n    column.cellStyles != null\n  );\n}\n\nexport function getColumnWindowSegments<T>(\n  columns: readonly CubeResolvedColumn<T>[],\n  range: ColumnWindowRange | null,\n  treeColumnKey?: string,\n): ColumnWindowSegment<T>[] {\n  const segments: ColumnWindowSegment<T>[] = [];\n  let omitted = 0;\n  let firstOmittedKey = '';\n\n  function flushGap() {\n    if (!omitted) return;\n    segments.push({ key: `column-gap:${firstOmittedKey}`, span: omitted });\n    omitted = 0;\n  }\n\n  for (const column of columns) {\n    if (\n      range == null ||\n      (column.index >= range.first && column.index <= range.last) ||\n      retainColumn(column, treeColumnKey)\n    ) {\n      flushGap();\n      segments.push({ key: `column-cell:${column.key}`, column });\n    } else {\n      if (!omitted) firstOmittedKey = column.key;\n      omitted++;\n      // Native table cells clamp colSpan to 1000.\n      if (omitted === 1000) flushGap();\n    }\n  }\n  flushGap();\n  return segments;\n}\n\nexport function useColumnWindow<T>(\n  layout: CubeTableColumnLayout<T>,\n  scroller: HTMLDivElement | null,\n  isEnabled: boolean,\n  treeColumnKey?: string,\n) {\n  const isWindowEnabled =\n    isEnabled &&\n    layout.columns.some((column) => !retainColumn(column, treeColumnKey));\n  const [range, setRange] = useState<ColumnWindowRange | null>(null);\n  const [fitsRow, setFitsRow] = useState(false);\n  const resetRange = () => {\n    const width = scroller?.clientWidth ?? 0;\n    const next =\n      isWindowEnabled && scroller && width > 0 && layout.totalWidth! > width\n        ? getColumnWindowRange(layout, Math.abs(scroller.scrollLeft), width)\n        : null;\n    setRange((previous) => (sameRange(previous, next) ? previous : next));\n  };\n  const refreshAppearance = useEvent(() => {\n    if (\n      !isWindowEnabled ||\n      !scroller ||\n      scroller.clientWidth <= 0 ||\n      layout.totalWidth! <= scroller.clientWidth\n    ) {\n      return;\n    }\n    const table = scroller?.querySelector('table');\n    if (!table) return;\n    const computed = getComputedStyle(table);\n    const rowHeight = computed.getPropertyValue('--row-height').trim();\n    const height = parseFloat(rowHeight);\n    const lineHeight = parseFloat(computed.lineHeight);\n    // Empty default cells can be shorter than text. Measure the inherited\n    // tokens, since Root can override both typography and the size scale.\n    setFitsRow(\n      rowHeight === `${height}px` &&\n        Number.isFinite(height) &&\n        height >= lineHeight,\n    );\n  });\n\n  useLayoutEffect(() => {\n    if (!isWindowEnabled || !scroller) {\n      return;\n    }\n\n    const update = (reset = false) => {\n      const width = scroller.clientWidth;\n      const offset = Math.abs(scroller.scrollLeft);\n      // Only changed bands add a render. New rows use the ordinary band,\n      // so diagonal scrolling does not multiply the extra refill cells.\n      setRange((previous) => {\n        const next =\n          width > 0 && layout.totalWidth! > width\n            ? getBufferedColumnWindowRange(\n                layout,\n                reset ? null : previous,\n                offset,\n                width,\n              )\n            : null;\n        return sameRange(previous, next) ? previous : next;\n      });\n    };\n    let lastOffset = Math.abs(scroller.scrollLeft);\n    let lastVerticalOffset = scroller.scrollTop;\n    const onScroll = () => {\n      const offset = Math.abs(scroller.scrollLeft);\n      const verticalOffset = scroller.scrollTop;\n      const reset = verticalOffset !== lastVerticalOffset;\n      lastVerticalOffset = verticalOffset;\n      if (offset === lastOffset && !reset) return;\n      lastOffset = offset;\n      update(reset);\n    };\n    refreshAppearance();\n    update(true);\n    const observer = new ResizeObserver(() => {\n      refreshAppearance();\n      update(true);\n    });\n    observer.observe(scroller);\n    scroller.addEventListener('scroll', onScroll, { passive: true });\n    return () => {\n      observer.disconnect();\n      scroller.removeEventListener('scroll', onScroll);\n    };\n  }, [isWindowEnabled, layout, refreshAppearance, scroller]);\n\n  return {\n    resetRange,\n    segments: getColumnWindowSegments(\n      layout.columns,\n      isWindowEnabled && fitsRow ? range : null,\n      treeColumnKey,\n    ),\n    refreshAppearance,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-column-window.js","names":["CONTAINER_STYLES","useLayoutEffect","useState","useEvent","Styles","CubeResolvedColumn","CubeTableColumnLayout","COLUMN_OVERSCAN","MAX_REFILL_COLUMNS","SAFE_FRAME_STYLES","Set","filter","key","includes","ColumnWindowRange","first","last","sameRange","left","right","ColumnWindowSegment","column","T","span","canWindowColumns","columns","styles","every","width","Number","isFinite","cellProps","Object","keys","has","getColumnWindowRange","layout","offset","viewportWidth","overscanStart","overscanEnd","start","Math","max","pinnedStartWidth","end","pinnedEndWidth","position","length","next","min","index","getBufferedColumnWindowRange","previous","required","totalWidth","extendsStart","extendsEnd","refilled","retainColumn","treeColumnKey","pin","isStructural","isRowHeader","autoHeight","render","cellStyles","getColumnWindowSegments","range","segments","omitted","firstOmittedKey","flushGap","push","useColumnWindow","scroller","isEnabled","$","_c","t0","some","isWindowEnabled","setRange","fitsRow","setFitsRow","t1","clientWidth","abs","scrollLeft","resetRange","t2","table","querySelector","computed","getComputedStyle","rowHeight","getPropertyValue","trim","height","parseFloat","lineHeight","refreshAppearance","t3","t4","update","t5","reset","undefined","width_0","previous_0","next_0","lastOffset","lastVerticalOffset","scrollTop","onScroll","offset_0","verticalOffset","reset_0","observer","ResizeObserver","observe","addEventListener","passive","disconnect","removeEventListener","t6","t7","_c"],"sources":["../../../../src/components/data/TableBase/use-column-window.ts"],"sourcesContent":["import { CONTAINER_STYLES } from '@tenphi/tasty';\nimport { useLayoutEffect, useState } from 'react';\n\nimport { useEvent } from '../../../_internal/hooks/use-event';\n\nimport type { Styles } from '@tenphi/tasty';\nimport type { CubeResolvedColumn, CubeTableColumnLayout } from './types';\n\n// Keep nearby cells ready for a horizontal flick without multiplying the\n// mounted row window by the entire column collection.\nconst COLUMN_OVERSCAN = 300;\nconst MAX_REFILL_COLUMNS = 1;\nconst SAFE_FRAME_STYLES = new Set<string>(\n  CONTAINER_STYLES.filter(\n    (key) => !['font', 'preset', 'whiteSpace'].includes(key),\n  ),\n);\n\nexport interface ColumnWindowRange {\n  first: number;\n  last: number;\n}\n\nfunction sameRange(\n  left: ColumnWindowRange | null,\n  right: ColumnWindowRange | null,\n) {\n  if (left == null || right == null) return left === right;\n  return left.first === right.first && left.last === right.last;\n}\n\nexport type ColumnWindowSegment<T> =\n  | { column: CubeResolvedColumn<T>; key: string }\n  | { column?: undefined; key: string; span: number };\n\n/** Arbitrary body styling and DOM spans need the complete intrinsic layout. */\nexport function canWindowColumns<T>(\n  columns: readonly CubeResolvedColumn<T>[],\n  styles?: Styles,\n) {\n  return (\n    columns.every(\n      (column) =>\n        column.width != null &&\n        column.width > 0 &&\n        Number.isFinite(column.width) &&\n        !column.cellProps,\n    ) && Object.keys(styles ?? {}).every((key) => SAFE_FRAME_STYLES.has(key))\n  );\n}\n\nexport function getColumnWindowRange<T>(\n  layout: CubeTableColumnLayout<T>,\n  offset: number,\n  viewportWidth: number,\n  overscanStart = COLUMN_OVERSCAN,\n  overscanEnd = COLUMN_OVERSCAN,\n): ColumnWindowRange {\n  const start = Math.max(0, offset + layout.pinnedStartWidth - overscanStart);\n  const end = offset + viewportWidth - layout.pinnedEndWidth + overscanEnd;\n  let position = 0;\n  let first = layout.columns.length;\n  let last = -1;\n\n  for (const column of layout.columns) {\n    const next = position + column.width!;\n    if (next > start && position < end) {\n      first = Math.min(first, column.index);\n      last = column.index;\n    }\n    position = next;\n  }\n\n  return { first, last };\n}\n\n/** Refill the moving edge without rebuilding rows at every column boundary. */\nexport function getBufferedColumnWindowRange<T>(\n  layout: CubeTableColumnLayout<T>,\n  previous: ColumnWindowRange | null,\n  offset: number,\n  viewportWidth: number,\n): ColumnWindowRange {\n  const required = getColumnWindowRange(layout, offset, viewportWidth);\n  if (!previous) return required;\n  // Native scroll extents round fractional widths; no ahead buffer is\n  // needed within a pixel of either endpoint.\n  if (offset <= 0 || offset >= layout.totalWidth! - viewportWidth - 1)\n    return required;\n  const extendsStart = required.first < previous.first;\n  const extendsEnd = required.last > previous.last;\n  if (!extendsStart && !extendsEnd) {\n    const first = Math.max(previous.first, required.first - MAX_REFILL_COLUMNS);\n    const last = Math.min(previous.last, required.last + MAX_REFILL_COLUMNS);\n    return first === previous.first && last === previous.last\n      ? previous\n      : { first, last };\n  }\n  // Both edges moving means the viewport/layout changed, not one scroll edge.\n  if (extendsStart && extendsEnd) return required;\n  const refilled = getColumnWindowRange(\n    layout,\n    offset,\n    viewportWidth,\n    extendsStart ? COLUMN_OVERSCAN * 2 : COLUMN_OVERSCAN,\n    extendsEnd ? COLUMN_OVERSCAN * 2 : COLUMN_OVERSCAN,\n  );\n  // A pixel-only refill retains too many narrow cells during diagonal scroll.\n  return {\n    first: Math.max(refilled.first, required.first - MAX_REFILL_COLUMNS),\n    last: Math.min(refilled.last, required.last + MAX_REFILL_COLUMNS),\n  };\n}\n\n/** Preserve height-bearing cells, native controls and row naming offscreen. */\nfunction retainColumn<T>(\n  column: CubeResolvedColumn<T>,\n  treeColumnKey?: string,\n) {\n  return (\n    column.pin != null ||\n    column.isStructural ||\n    column.isRowHeader ||\n    column.key === treeColumnKey ||\n    column.autoHeight ||\n    column.render != null ||\n    column.cellStyles != null\n  );\n}\n\nexport function getColumnWindowSegments<T>(\n  columns: readonly CubeResolvedColumn<T>[],\n  range: ColumnWindowRange | null,\n  treeColumnKey?: string,\n): ColumnWindowSegment<T>[] {\n  const segments: ColumnWindowSegment<T>[] = [];\n  let omitted = 0;\n  let firstOmittedKey = '';\n\n  function flushGap() {\n    if (!omitted) return;\n    segments.push({ key: `column-gap:${firstOmittedKey}`, span: omitted });\n    omitted = 0;\n  }\n\n  for (const column of columns) {\n    if (\n      range == null ||\n      (column.index >= range.first && column.index <= range.last) ||\n      retainColumn(column, treeColumnKey)\n    ) {\n      flushGap();\n      segments.push({ key: `column-cell:${column.key}`, column });\n    } else {\n      if (!omitted) firstOmittedKey = column.key;\n      omitted++;\n      // Native table cells clamp colSpan to 1000.\n      if (omitted === 1000) flushGap();\n    }\n  }\n  flushGap();\n  return segments;\n}\n\nexport function useColumnWindow<T>(\n  layout: CubeTableColumnLayout<T>,\n  scroller: HTMLDivElement | null,\n  isEnabled: boolean,\n  treeColumnKey?: string,\n) {\n  const isWindowEnabled =\n    isEnabled &&\n    layout.columns.some((column) => !retainColumn(column, treeColumnKey));\n  const [range, setRange] = useState<ColumnWindowRange | null>(null);\n  const [fitsRow, setFitsRow] = useState(false);\n  const resetRange = () => {\n    const width = scroller?.clientWidth ?? 0;\n    const next =\n      isWindowEnabled && scroller && width > 0 && layout.totalWidth! > width\n        ? getColumnWindowRange(layout, Math.abs(scroller.scrollLeft), width)\n        : null;\n    setRange((previous) => (sameRange(previous, next) ? previous : next));\n  };\n  const refreshAppearance = useEvent(() => {\n    if (\n      !isWindowEnabled ||\n      !scroller ||\n      scroller.clientWidth <= 0 ||\n      layout.totalWidth! <= scroller.clientWidth\n    ) {\n      return;\n    }\n    const table = scroller?.querySelector('table');\n    if (!table) return;\n    const computed = getComputedStyle(table);\n    const rowHeight = computed.getPropertyValue('--row-height').trim();\n    const height = parseFloat(rowHeight);\n    const lineHeight = parseFloat(computed.lineHeight);\n    // Empty default cells can be shorter than text. Measure the inherited\n    // tokens, since Root can override both typography and the size scale.\n    setFitsRow(\n      rowHeight === `${height}px` &&\n        Number.isFinite(height) &&\n        height >= lineHeight,\n    );\n  });\n\n  useLayoutEffect(() => {\n    if (!isWindowEnabled || !scroller) {\n      return;\n    }\n\n    const update = (reset = false) => {\n      const width = scroller.clientWidth;\n      const offset = Math.abs(scroller.scrollLeft);\n      // Only changed bands add a render. New rows use the ordinary band,\n      // so diagonal scrolling does not multiply the extra refill cells.\n      setRange((previous) => {\n        const next =\n          width > 0 && layout.totalWidth! > width\n            ? getBufferedColumnWindowRange(\n                layout,\n                reset ? null : previous,\n                offset,\n                width,\n              )\n            : null;\n        return sameRange(previous, next) ? previous : next;\n      });\n    };\n    let lastOffset = Math.abs(scroller.scrollLeft);\n    let lastVerticalOffset = scroller.scrollTop;\n    const onScroll = () => {\n      const offset = Math.abs(scroller.scrollLeft);\n      const verticalOffset = scroller.scrollTop;\n      const reset = verticalOffset !== lastVerticalOffset;\n      lastVerticalOffset = verticalOffset;\n      if (offset === lastOffset && !reset) return;\n      lastOffset = offset;\n      update(reset);\n    };\n    refreshAppearance();\n    update(true);\n    const observer = new ResizeObserver(() => {\n      refreshAppearance();\n      update(true);\n    });\n    observer.observe(scroller);\n    scroller.addEventListener('scroll', onScroll, { passive: true });\n    return () => {\n      observer.disconnect();\n      scroller.removeEventListener('scroll', onScroll);\n    };\n  }, [isWindowEnabled, layout, refreshAppearance, scroller]);\n\n  return {\n    resetRange,\n    segments: getColumnWindowSegments(\n      layout.columns,\n      isWindowEnabled && fitsRow ? range : null,\n      treeColumnKey,\n    ),\n    refreshAppearance,\n  };\n}\n"],"mappings":"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"}

package/dist/components/data/TableBase/use-container-width.js

@@ -1,7 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useLayoutEffect, useState } from "react";
-
 //#region src/components/data/TableBase/use-container-width.ts
 /**
 * Content-box width of the scroller, measured before paint and kept current
@@ -43,7 +42,7 @@ function useContainerWidth(element) {
 	useLayoutEffect(t0, t1);
 	return width;
 }
-
 //#endregion
 export { useContainerWidth };
+
 //# sourceMappingURL=use-container-width.js.map

package/dist/components/data/TableBase/use-container-width.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-container-width.js","names":["useLayoutEffect","useState","useContainerWidth","element","$","_c","width","setWidth","t0","t1","Element","measure","current","clientWidth","observer","ResizeObserver","observe","disconnect"],"sources":["../../../../src/components/data/TableBase/use-container-width.ts"],"sourcesContent":["import { useLayoutEffect, useState } from 'react';\n\n/**\n * Content-box width of the scroller, measured before paint and kept current\n * with a `ResizeObserver`.\n *\n * Takes the **element**, not a ref: in the virtualized path the scroller is\n * created by Virtuoso and handed over through a callback after mount, so a hook\n * that peeked at `ref.current` once would see `null` and never measure\n * anything — leaving every column unsized.\n *\n * `useLayoutEffect` rather than `useEffect` on purpose: column widths are\n * derived from this value, so measuring after paint would show one frame of\n * min-width columns before they snap to their real size.\n */\nexport function useContainerWidth(element: HTMLElement | null): number | null {\n  const [width, setWidth] = useState<number | null>(null);\n\n  useLayoutEffect(() => {\n    // Virtuoso's `scrollerRef` reports `HTMLElement | Window | null`, and\n    // `ResizeObserver.observe` throws on anything that is not an Element.\n    if (!element || !(element instanceof Element)) return;\n\n    const measure = () => {\n      // `clientWidth` excludes the vertical scrollbar, which is what we want:\n      // the columns must fit the content box, not the border box, or a\n      // scrollbar appearing would push the last column out and bring a\n      // horizontal scrollbar with it.\n      setWidth((current) =>\n        current === element.clientWidth ? current : element.clientWidth,\n      );\n    };\n\n    measure();\n\n    const observer = new ResizeObserver(measure);\n\n    observer.observe(element);\n\n    return () => observer.disconnect();\n  }, [element]);\n\n  return width;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAeA,SAAOE,kBAAAC,SAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CACL,MAAA,CAAAC,OAAAC,YAA0BN,SAAwB,KAAK;CAAC,IAAAO;CAAA,IAAAC;AAAA,KAAAL,EAAA,OAAAD,SAAA;AAExCK,aAAA;AAGd,OAAI,CAACL,WAAD,EAAcA,mBAAmBO,SAAQ;GAE7C,MAAAC,gBAAgB;AAKdJ,cAASK,YACPA,YAAYT,QAAOU,cAAnBD,UAA4CT,QAAOU,YACpD;;AAGHF,YAAS;GAET,MAAAG,WAAiB,IAAIC,eAAeJ,QAAQ;AAE5CG,YAAQE,QAASb,QAAQ;AAAA,gBAEZW,SAAQG,YAAa;;AACjCR,OAAA,CAACN,QAAQ;AAAAC,IAAA,KAAAD;AAAAC,IAAA,KAAAI;AAAAJ,IAAA,KAAAK;QAAA;AAAAD,OAAAJ,EAAA;AAAAK,OAAAL,EAAA;;AAtBZJ,iBAAgBQ,IAsBbC,GAAU;AAAA,QAENH"}
+{"version":3,"file":"use-container-width.js","names":["useLayoutEffect","useState","useContainerWidth","element","$","_c","width","setWidth","t0","t1","Element","measure","current","clientWidth","observer","ResizeObserver","observe","disconnect","_c"],"sources":["../../../../src/components/data/TableBase/use-container-width.ts"],"sourcesContent":["import { useLayoutEffect, useState } from 'react';\n\n/**\n * Content-box width of the scroller, measured before paint and kept current\n * with a `ResizeObserver`.\n *\n * Takes the **element**, not a ref: in the virtualized path the scroller is\n * created by Virtuoso and handed over through a callback after mount, so a hook\n * that peeked at `ref.current` once would see `null` and never measure\n * anything — leaving every column unsized.\n *\n * `useLayoutEffect` rather than `useEffect` on purpose: column widths are\n * derived from this value, so measuring after paint would show one frame of\n * min-width columns before they snap to their real size.\n */\nexport function useContainerWidth(element: HTMLElement | null): number | null {\n  const [width, setWidth] = useState<number | null>(null);\n\n  useLayoutEffect(() => {\n    // Virtuoso's `scrollerRef` reports `HTMLElement | Window | null`, and\n    // `ResizeObserver.observe` throws on anything that is not an Element.\n    if (!element || !(element instanceof Element)) return;\n\n    const measure = () => {\n      // `clientWidth` excludes the vertical scrollbar, which is what we want:\n      // the columns must fit the content box, not the border box, or a\n      // scrollbar appearing would push the last column out and bring a\n      // horizontal scrollbar with it.\n      setWidth((current) =>\n        current === element.clientWidth ? current : element.clientWidth,\n      );\n    };\n\n    measure();\n\n    const observer = new ResizeObserver(measure);\n\n    observer.observe(element);\n\n    return () => observer.disconnect();\n  }, [element]);\n\n  return width;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAeA,SAAOE,kBAAAC,SAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CACL,MAAA,CAAAC,OAAAC,YAA0BN,SAAwB,IAAI;CAAE,IAAAO;CAAA,IAAAC;CAAA,IAAAL,EAAA,OAAAD,SAAA;EAExCK,WAAA;GAGd,IAAI,CAACL,WAAD,EAAcA,mBAAmBO,UAAQ;GAE7C,MAAAC,gBAAgB;IAKdJ,UAASK,YACPA,YAAYT,QAAOU,cAAnBD,UAA4CT,QAAOU,WACrD;GAAC;GAGHF,QAAQ;GAER,MAAAG,WAAiB,IAAIC,eAAeJ,OAAO;GAE3CG,SAAQE,QAASb,OAAO;GAAC,aAEZW,SAAQG,WAAY;EAAC;EACjCR,KAAA,CAACN,OAAO;EAACC,EAAA,KAAAD;EAAAC,EAAA,KAAAI;EAAAJ,EAAA,KAAAK;CAAA,OAAA;EAAAD,KAAAJ,EAAA;EAAAK,KAAAL,EAAA;CAAA;CAtBZJ,gBAAgBQ,IAsBbC,EAAS;CAAC,OAENH;AAAK"}

package/dist/components/data/TableBase/use-row-move-animation.js

@@ -1,10 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useLayoutEffect, useRef } from "react";
-
-//#region src/components/data/TableBase/use-row-move-animation.ts
-/** Matches ag-grid's row animation closely enough to feel familiar. */
-const ROW_MOVE_DURATION = 120;
 /** Matches `DisplayTransition`'s check, which is the kit's existing precedent. */
 function prefersReducedMotion() {
 	return typeof window !== "undefined" && Boolean(window.matchMedia?.("(prefers-reduced-motion: reduce)")?.matches);
@@ -36,7 +32,7 @@ function prefersReducedMotion() {
 function useRowMoveAnimation(t0) {
 	const $ = c(5);
 	const { isEnabled, bodyRef, duration: t1 } = t0;
-	const duration = t1 === void 0 ? ROW_MOVE_DURATION : t1;
+	const duration = t1 === void 0 ? 120 : t1;
 	const previousRef = useRef(null);
 	let t2;
 	if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
@@ -107,7 +103,7 @@ function useRowMoveAnimation(t0) {
 function _temp(row_0) {
 	return row_0.dataset.key;
 }
-
 //#endregion
 export { useRowMoveAnimation };
+
 //# sourceMappingURL=use-row-move-animation.js.map

package/dist/components/data/TableBase/use-row-move-animation.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-row-move-animation.js","names":["useLayoutEffect","useRef","RefObject","ROW_MOVE_DURATION","UseRowMoveAnimationOptions","isEnabled","bodyRef","HTMLTableSectionElement","duration","prefersReducedMotion","window","Boolean","matchMedia","matches","useRowMoveAnimation","t0","$","_c","t1","undefined","previousRef","t2","Symbol","for","previousOrderRef","t3","body","current","rows","Array","from","querySelectorAll","next","Map","row","set","dataset","key","offsetTop","previous","previousOrder","nextOrder","map","_temp","stillHere","Set","before","filter","has","after","key_0","isReorder","length","some","key_1","index","moved","row_1","get","delta","push","row_2","delta_0","style","transition","transform","row_3","clear","row_4","timer","setTimeout","clearTimeout","row_0"],"sources":["../../../../src/components/data/TableBase/use-row-move-animation.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\n\nimport type { RefObject } from 'react';\n\n/** Matches ag-grid's row animation closely enough to feel familiar. */\nexport const ROW_MOVE_DURATION = 120;\n\nexport interface UseRowMoveAnimationOptions {\n  isEnabled: boolean;\n  /** The `<tbody>` the rows live in. */\n  bodyRef: RefObject<HTMLTableSectionElement | null>;\n  /** @default 120 */\n  duration?: number;\n}\n\n/** Matches `DisplayTransition`'s check, which is the kit's existing precedent. */\nfunction prefersReducedMotion() {\n  return (\n    typeof window !== 'undefined' &&\n    Boolean(window.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches)\n  );\n}\n\n/**\n * Slides rows to their new positions when the order changes.\n *\n * FLIP: the previous commit's positions are the First, this commit's are the\n * Last, and each row is Inverted with a `translateY` back to where it was and\n * then Played to zero. The DOM is already correct the whole time — only the\n * paint is behind — so a test or a screen reader sees the new order\n * immediately, and nothing has to be delayed or double-rendered.\n *\n * Sorting a table otherwise teleports every row at once, and the eye has no way\n * to follow a particular one to where it went. The whole value is in tracking\n * one row, which is why this animates positions rather than cross-fading.\n *\n * **Only a reorder**, and only rows that were already on screen. If the rows\n * common to both commits are in the same relative order, nothing animates,\n * however much their positions moved — that is a relayout, not a reorder, and\n * it covers the initial mount (widths resolving, the virtualizer measuring, a\n * scrollbar appearing), a container resize, and a filter that only removes\n * rows.\n *\n * Scrolling is not movement either, and that falls out of measuring `offsetTop`\n * rather than viewport coordinates: it is relative to the scroller's content,\n * so it does not change as the content scrolls past.\n */\nexport function useRowMoveAnimation({\n  isEnabled,\n  bodyRef,\n  duration = ROW_MOVE_DURATION,\n}: UseRowMoveAnimationOptions) {\n  const previousRef = useRef<Map<string, number> | null>(null);\n  const previousOrderRef = useRef<string[]>([]);\n\n  // No dependency array: positions are captured after every enabled commit,\n  // because any of them may be the one a reorder starts from.\n  useLayoutEffect(() => {\n    const body = bodyRef.current;\n\n    if (!body || !isEnabled || prefersReducedMotion()) {\n      // Enabling starts a fresh snapshot; disabled frames need no geometry.\n      previousRef.current = null;\n      previousOrderRef.current = [];\n      return;\n    }\n\n    const rows = Array.from(\n      body.querySelectorAll<HTMLTableRowElement>(\n        // Pinned rows are excluded by the selector rather than filtered later:\n        // they do not take part in the order, so they never move.\n        'tr[data-element=\"Row\"][data-key]:not([data-pinned])',\n      ),\n    );\n\n    // `offsetTop`, not `getBoundingClientRect()`: it is relative to the\n    // scroller, so scrolling does not read as movement. Otherwise every scroll\n    // tick would look like a reorder of the whole page.\n    const next = new Map<string, number>();\n\n    for (const row of rows) next.set(row.dataset.key!, row.offsetTop);\n\n    const previous = previousRef.current;\n    const previousOrder = previousOrderRef.current;\n    const nextOrder = rows.map((row) => row.dataset.key!);\n\n    previousRef.current = next;\n    previousOrderRef.current = nextOrder;\n\n    if (!previous) return;\n\n    // Animate a REORDER, never a relayout.\n    //\n    // Positions shift for all sorts of reasons that are not a row moving: the\n    // column widths resolving after the first measure, the virtualizer taking\n    // its measurements, a scrollbar appearing, a font landing, the container\n    // being resized. Every one of those happens on the second commit of a\n    // normal mount — so keying off \"an offset changed\" animated the table into\n    // existence on load, which is exactly what a load should not do.\n    //\n    // Comparing the order of the rows common to both commits answers the real\n    // question. A relayout leaves it identical; a sort does not.\n    const stillHere = new Set(nextOrder);\n    const before = previousOrder.filter((key) => stillHere.has(key));\n    const after = nextOrder.filter((key) => previous.has(key));\n    const isReorder =\n      before.length !== after.length ||\n      before.some((key, index) => key !== after[index]);\n\n    if (!isReorder) return;\n\n    const moved: { row: HTMLTableRowElement; delta: number }[] = [];\n\n    for (const row of rows) {\n      const from = previous.get(row.dataset.key!);\n\n      // A row that was not here before has nowhere to come from. Skipped rather\n      // than bailing on the whole batch: a virtualized window swaps some of its\n      // rows on every re-sort, and refusing to animate unless ALL of them are\n      // familiar means a virtualized grid — most result grids — never animates\n      // at all.\n      if (from === undefined) continue;\n\n      const delta = from - next.get(row.dataset.key!)!;\n\n      if (delta !== 0) moved.push({ row, delta });\n    }\n\n    if (!moved.length) return;\n\n    // Invert: put every moved row back where it was, with transitions off so\n    // this jump is not itself animated.\n    for (const { row, delta } of moved) {\n      row.style.transition = 'none';\n      row.style.transform = `translateY(${delta}px)`;\n    }\n\n    // Flush the inverted state into layout, so the browser has something to\n    // animate FROM. A forced reflow rather than `requestAnimationFrame`,\n    // deliberately: rAF does not fire in a hidden tab, and a sort that lands\n    // while the tab is in the background would leave every row frozen at its\n    // old position until the next reorder. One reflow, once per animation.\n    void body.offsetHeight;\n\n    // Play.\n    for (const { row } of moved) {\n      row.style.transition = `transform ${duration}ms ease-out`;\n      row.style.transform = '';\n    }\n\n    // Clear on arrival. A `transition` left inline would go on to animate\n    // transforms this hook never set — a dragged row, for one.\n    //\n    // A timer rather than `transitionend`, for the same reason the invert does\n    // not use `requestAnimationFrame`: in a hidden tab the transition never\n    // runs, so the event never fires and every animated row keeps its inline\n    // `transition` for the rest of the session. The duration is known exactly,\n    // so there is nothing to wait to be told.\n    const clear = () => {\n      for (const { row } of moved) {\n        row.style.transition = '';\n        row.style.transform = '';\n      }\n    };\n    const timer = setTimeout(clear, duration);\n\n    return () => {\n      // A reorder landing mid-animation starts over from wherever the rows are,\n      // so nothing may be left behind.\n      clearTimeout(timer);\n      clear();\n    };\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-row-move-animation.js","names":["useLayoutEffect","useRef","RefObject","ROW_MOVE_DURATION","UseRowMoveAnimationOptions","isEnabled","bodyRef","HTMLTableSectionElement","duration","prefersReducedMotion","window","Boolean","matchMedia","matches","useRowMoveAnimation","t0","$","_c","t1","undefined","previousRef","t2","Symbol","for","previousOrderRef","t3","body","current","rows","Array","from","querySelectorAll","next","Map","row","set","dataset","key","offsetTop","previous","previousOrder","nextOrder","map","_temp","stillHere","Set","before","filter","has","after","key_0","isReorder","length","some","key_1","index","moved","row_1","get","delta","push","row_2","delta_0","style","transition","transform","row_3","clear","row_4","timer","setTimeout","clearTimeout","row_0","_c"],"sources":["../../../../src/components/data/TableBase/use-row-move-animation.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\n\nimport type { RefObject } from 'react';\n\n/** Matches ag-grid's row animation closely enough to feel familiar. */\nexport const ROW_MOVE_DURATION = 120;\n\nexport interface UseRowMoveAnimationOptions {\n  isEnabled: boolean;\n  /** The `<tbody>` the rows live in. */\n  bodyRef: RefObject<HTMLTableSectionElement | null>;\n  /** @default 120 */\n  duration?: number;\n}\n\n/** Matches `DisplayTransition`'s check, which is the kit's existing precedent. */\nfunction prefersReducedMotion() {\n  return (\n    typeof window !== 'undefined' &&\n    Boolean(window.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches)\n  );\n}\n\n/**\n * Slides rows to their new positions when the order changes.\n *\n * FLIP: the previous commit's positions are the First, this commit's are the\n * Last, and each row is Inverted with a `translateY` back to where it was and\n * then Played to zero. The DOM is already correct the whole time — only the\n * paint is behind — so a test or a screen reader sees the new order\n * immediately, and nothing has to be delayed or double-rendered.\n *\n * Sorting a table otherwise teleports every row at once, and the eye has no way\n * to follow a particular one to where it went. The whole value is in tracking\n * one row, which is why this animates positions rather than cross-fading.\n *\n * **Only a reorder**, and only rows that were already on screen. If the rows\n * common to both commits are in the same relative order, nothing animates,\n * however much their positions moved — that is a relayout, not a reorder, and\n * it covers the initial mount (widths resolving, the virtualizer measuring, a\n * scrollbar appearing), a container resize, and a filter that only removes\n * rows.\n *\n * Scrolling is not movement either, and that falls out of measuring `offsetTop`\n * rather than viewport coordinates: it is relative to the scroller's content,\n * so it does not change as the content scrolls past.\n */\nexport function useRowMoveAnimation({\n  isEnabled,\n  bodyRef,\n  duration = ROW_MOVE_DURATION,\n}: UseRowMoveAnimationOptions) {\n  const previousRef = useRef<Map<string, number> | null>(null);\n  const previousOrderRef = useRef<string[]>([]);\n\n  // No dependency array: positions are captured after every enabled commit,\n  // because any of them may be the one a reorder starts from.\n  useLayoutEffect(() => {\n    const body = bodyRef.current;\n\n    if (!body || !isEnabled || prefersReducedMotion()) {\n      // Enabling starts a fresh snapshot; disabled frames need no geometry.\n      previousRef.current = null;\n      previousOrderRef.current = [];\n      return;\n    }\n\n    const rows = Array.from(\n      body.querySelectorAll<HTMLTableRowElement>(\n        // Pinned rows are excluded by the selector rather than filtered later:\n        // they do not take part in the order, so they never move.\n        'tr[data-element=\"Row\"][data-key]:not([data-pinned])',\n      ),\n    );\n\n    // `offsetTop`, not `getBoundingClientRect()`: it is relative to the\n    // scroller, so scrolling does not read as movement. Otherwise every scroll\n    // tick would look like a reorder of the whole page.\n    const next = new Map<string, number>();\n\n    for (const row of rows) next.set(row.dataset.key!, row.offsetTop);\n\n    const previous = previousRef.current;\n    const previousOrder = previousOrderRef.current;\n    const nextOrder = rows.map((row) => row.dataset.key!);\n\n    previousRef.current = next;\n    previousOrderRef.current = nextOrder;\n\n    if (!previous) return;\n\n    // Animate a REORDER, never a relayout.\n    //\n    // Positions shift for all sorts of reasons that are not a row moving: the\n    // column widths resolving after the first measure, the virtualizer taking\n    // its measurements, a scrollbar appearing, a font landing, the container\n    // being resized. Every one of those happens on the second commit of a\n    // normal mount — so keying off \"an offset changed\" animated the table into\n    // existence on load, which is exactly what a load should not do.\n    //\n    // Comparing the order of the rows common to both commits answers the real\n    // question. A relayout leaves it identical; a sort does not.\n    const stillHere = new Set(nextOrder);\n    const before = previousOrder.filter((key) => stillHere.has(key));\n    const after = nextOrder.filter((key) => previous.has(key));\n    const isReorder =\n      before.length !== after.length ||\n      before.some((key, index) => key !== after[index]);\n\n    if (!isReorder) return;\n\n    const moved: { row: HTMLTableRowElement; delta: number }[] = [];\n\n    for (const row of rows) {\n      const from = previous.get(row.dataset.key!);\n\n      // A row that was not here before has nowhere to come from. Skipped rather\n      // than bailing on the whole batch: a virtualized window swaps some of its\n      // rows on every re-sort, and refusing to animate unless ALL of them are\n      // familiar means a virtualized grid — most result grids — never animates\n      // at all.\n      if (from === undefined) continue;\n\n      const delta = from - next.get(row.dataset.key!)!;\n\n      if (delta !== 0) moved.push({ row, delta });\n    }\n\n    if (!moved.length) return;\n\n    // Invert: put every moved row back where it was, with transitions off so\n    // this jump is not itself animated.\n    for (const { row, delta } of moved) {\n      row.style.transition = 'none';\n      row.style.transform = `translateY(${delta}px)`;\n    }\n\n    // Flush the inverted state into layout, so the browser has something to\n    // animate FROM. A forced reflow rather than `requestAnimationFrame`,\n    // deliberately: rAF does not fire in a hidden tab, and a sort that lands\n    // while the tab is in the background would leave every row frozen at its\n    // old position until the next reorder. One reflow, once per animation.\n    void body.offsetHeight;\n\n    // Play.\n    for (const { row } of moved) {\n      row.style.transition = `transform ${duration}ms ease-out`;\n      row.style.transform = '';\n    }\n\n    // Clear on arrival. A `transition` left inline would go on to animate\n    // transforms this hook never set — a dragged row, for one.\n    //\n    // A timer rather than `transitionend`, for the same reason the invert does\n    // not use `requestAnimationFrame`: in a hidden tab the transition never\n    // runs, so the event never fires and every animated row keeps its inline\n    // `transition` for the rest of the session. The duration is known exactly,\n    // so there is nothing to wait to be told.\n    const clear = () => {\n      for (const { row } of moved) {\n        row.style.transition = '';\n        row.style.transform = '';\n      }\n    };\n    const timer = setTimeout(clear, duration);\n\n    return () => {\n      // A reorder landing mid-animation starts over from wherever the rows are,\n      // so nothing may be left behind.\n      clearTimeout(timer);\n      clear();\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/components/data/TableBase/use-scrollability.js

@@ -1,7 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useLayoutEffect, useState } from "react";
-
 //#region src/components/data/TableBase/use-scrollability.ts
 const NONE = {
 	x: false,
@@ -57,7 +56,7 @@ function useScrollability(element) {
 	useLayoutEffect(t0, t1);
 	return state;
 }
-
 //#endregion
 export { useScrollability };
+
 //# sourceMappingURL=use-scrollability.js.map

package/dist/components/data/TableBase/use-scrollability.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-scrollability.js","names":["useLayoutEffect","useState","CubeScrollability","x","y","NONE","useScrollability","element","$","_c","state","setState","t0","t1","Element","measure","next","scrollWidth","clientWidth","scrollHeight","clientHeight","current","observer","ResizeObserver","observe","content","firstElementChild","disconnect"],"sources":["../../../../src/components/data/TableBase/use-scrollability.ts"],"sourcesContent":["import { useLayoutEffect, useState } from 'react';\n\nexport interface CubeScrollability {\n  x: boolean;\n  y: boolean;\n}\n\nconst NONE: CubeScrollability = { x: false, y: false };\n\n/**\n * Whether the scroller can actually scroll, per axis.\n *\n * This exists for `overscroll-behavior`. `contain` is what stops a horizontal\n * swipe at the scroll edge from triggering browser back-navigation, but Chrome\n * applies it to any element with `overflow: auto` — including one whose content\n * fits. The wheel event is then swallowed by a scroller with nothing to scroll,\n * and the page behind it will not move. So the containment has to be scoped to\n * the axis that is genuinely scrollable, which means measuring.\n *\n * Both the scroller and its content are observed: the scroller's own box does\n * not change when rows are added, so observing it alone would miss a table that\n * grew past its container.\n */\nexport function useScrollability(\n  element: HTMLElement | null,\n): CubeScrollability {\n  const [state, setState] = useState<CubeScrollability>(NONE);\n\n  useLayoutEffect(() => {\n    // Matches `useContainerWidth`: a scroller handed over by a callback ref can\n    // be null, and `observe` throws on anything that is not an Element.\n    if (!element || !(element instanceof Element)) {\n      setState(NONE);\n\n      return;\n    }\n\n    const measure = () => {\n      // A 1px tolerance: sub-pixel layout regularly leaves `scrollHeight` a\n      // fraction above `clientHeight` on a table that visibly does not scroll,\n      // and trapping the wheel over that fraction is the exact bug this avoids.\n      const next = {\n        x: element.scrollWidth - element.clientWidth > 1,\n        y: element.scrollHeight - element.clientHeight > 1,\n      };\n\n      setState((current) =>\n        current.x === next.x && current.y === next.y ? current : next,\n      );\n    };\n\n    measure();\n\n    const observer = new ResizeObserver(measure);\n\n    observer.observe(element);\n\n    const content = element.firstElementChild;\n\n    if (content) observer.observe(content);\n\n    return () => observer.disconnect();\n  }, [element]);\n\n  return state;\n}\n"],"mappings":";;;;;AAOA,MAAMK,OAA0B;CAAEF,GAAG;CAAOC,GAAG;CAAO;;;;;;;;;;;;;;;AAgBtD,SAAOE,iBAAAC,SAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAGL,MAAA,CAAAC,OAAAC,YAA0BV,SAA4BI,KAAK;CAAC,IAAAO;CAAA,IAAAC;AAAA,KAAAL,EAAA,OAAAD,SAAA;AAE5CK,aAAA;AAGd,OAAI,CAACL,WAAD,EAAcA,mBAAmBO,UAAQ;AAC3CH,aAASN,KAAK;AAAA;;GAKhB,MAAAU,gBAAgB;IAId,MAAAC,OAAa;KAAAb,GACRI,QAAOU,cAAeV,QAAOW,cAAe;KAACd,GAC7CG,QAAOY,eAAgBZ,QAAOa,eAAgB;KAClD;AAEDT,cAASU,YACPA,QAAOlB,MAAOa,KAAIb,KAAMkB,QAAOjB,MAAOY,KAAIZ,IAA1CiB,UAAAL,KACD;;AAGHD,YAAS;GAET,MAAAO,WAAiB,IAAIC,eAAeR,QAAQ;AAE5CO,YAAQE,QAASjB,QAAQ;GAEzB,MAAAkB,UAAgBlB,QAAOmB;AAEvB,OAAID,QAASH,UAAQE,QAASC,QAAQ;AAAC,gBAE1BH,SAAQK,YAAa;;AACjCd,OAAA,CAACN,QAAQ;AAAAC,IAAA,KAAAD;AAAAC,IAAA,KAAAI;AAAAJ,IAAA,KAAAK;QAAA;AAAAD,OAAAJ,EAAA;AAAAK,OAAAL,EAAA;;AAlCZR,iBAAgBY,IAkCbC,GAAU;AAAA,QAENH"}
+{"version":3,"file":"use-scrollability.js","names":["useLayoutEffect","useState","CubeScrollability","x","y","NONE","useScrollability","element","$","_c","state","setState","t0","t1","Element","measure","next","scrollWidth","clientWidth","scrollHeight","clientHeight","current","observer","ResizeObserver","observe","content","firstElementChild","disconnect","_c"],"sources":["../../../../src/components/data/TableBase/use-scrollability.ts"],"sourcesContent":["import { useLayoutEffect, useState } from 'react';\n\nexport interface CubeScrollability {\n  x: boolean;\n  y: boolean;\n}\n\nconst NONE: CubeScrollability = { x: false, y: false };\n\n/**\n * Whether the scroller can actually scroll, per axis.\n *\n * This exists for `overscroll-behavior`. `contain` is what stops a horizontal\n * swipe at the scroll edge from triggering browser back-navigation, but Chrome\n * applies it to any element with `overflow: auto` — including one whose content\n * fits. The wheel event is then swallowed by a scroller with nothing to scroll,\n * and the page behind it will not move. So the containment has to be scoped to\n * the axis that is genuinely scrollable, which means measuring.\n *\n * Both the scroller and its content are observed: the scroller's own box does\n * not change when rows are added, so observing it alone would miss a table that\n * grew past its container.\n */\nexport function useScrollability(\n  element: HTMLElement | null,\n): CubeScrollability {\n  const [state, setState] = useState<CubeScrollability>(NONE);\n\n  useLayoutEffect(() => {\n    // Matches `useContainerWidth`: a scroller handed over by a callback ref can\n    // be null, and `observe` throws on anything that is not an Element.\n    if (!element || !(element instanceof Element)) {\n      setState(NONE);\n\n      return;\n    }\n\n    const measure = () => {\n      // A 1px tolerance: sub-pixel layout regularly leaves `scrollHeight` a\n      // fraction above `clientHeight` on a table that visibly does not scroll,\n      // and trapping the wheel over that fraction is the exact bug this avoids.\n      const next = {\n        x: element.scrollWidth - element.clientWidth > 1,\n        y: element.scrollHeight - element.clientHeight > 1,\n      };\n\n      setState((current) =>\n        current.x === next.x && current.y === next.y ? current : next,\n      );\n    };\n\n    measure();\n\n    const observer = new ResizeObserver(measure);\n\n    observer.observe(element);\n\n    const content = element.firstElementChild;\n\n    if (content) observer.observe(content);\n\n    return () => observer.disconnect();\n  }, [element]);\n\n  return state;\n}\n"],"mappings":";;;;AAOA,MAAMK,OAA0B;CAAEF,GAAG;CAAOC,GAAG;AAAM;;;;;;;;;;;;;;;AAgBrD,SAAOE,iBAAAC,SAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAGL,MAAA,CAAAC,OAAAC,YAA0BV,SAA4BI,IAAI;CAAE,IAAAO;CAAA,IAAAC;CAAA,IAAAL,EAAA,OAAAD,SAAA;EAE5CK,WAAA;GAGd,IAAI,CAACL,WAAD,EAAcA,mBAAmBO,UAAQ;IAC3CH,SAASN,IAAI;IAAC;GAAA;GAKhB,MAAAU,gBAAgB;IAId,MAAAC,OAAa;KAAAb,GACRI,QAAOU,cAAeV,QAAOW,cAAe;KAACd,GAC7CG,QAAOY,eAAgBZ,QAAOa,eAAgB;IACnD;IAEAT,UAASU,YACPA,QAAOlB,MAAOa,KAAIb,KAAMkB,QAAOjB,MAAOY,KAAIZ,IAA1CiB,UAAAL,IACF;GAAC;GAGHD,QAAQ;GAER,MAAAO,WAAiB,IAAIC,eAAeR,OAAO;GAE3CO,SAAQE,QAASjB,OAAO;GAExB,MAAAkB,UAAgBlB,QAAOmB;GAEvB,IAAID,SAASH,SAAQE,QAASC,OAAO;GAAE,aAE1BH,SAAQK,WAAY;EAAC;EACjCd,KAAA,CAACN,OAAO;EAACC,EAAA,KAAAD;EAAAC,EAAA,KAAAI;EAAAJ,EAAA,KAAAK;CAAA,OAAA;EAAAD,KAAAJ,EAAA;EAAAK,KAAAL,EAAA;CAAA;CAlCZR,gBAAgBY,IAkCbC,EAAS;CAAC,OAENH;AAAK"}

package/dist/components/data/TableBase/use-table-columns.js

@@ -1,9 +1,5 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
-
-//#region src/components/data/TableBase/use-table-columns.ts
-/** @default when a column declares neither `width` nor `minWidth`. */
-const DEFAULT_MIN_WIDTH = 150;
 /**
 * Every column's current width, so a resize can change exactly one of them.
 *
@@ -80,7 +76,7 @@ function orderColumns(columns) {
 }
 function toColumnSpec(column, isStructural, columnWidths) {
 	const explicit = columnWidths?.[column.key] ?? column.width;
-	const minWidth = column.minWidth ?? (explicit != null ? explicit : isStructural ? 0 : DEFAULT_MIN_WIDTH);
+	const minWidth = column.minWidth ?? (explicit != null ? explicit : isStructural ? 0 : 150);
 	return {
 		column,
 		isStructural,
@@ -240,7 +236,7 @@ function useTableColumns(t0) {
 	} else t1 = $[5];
 	return t1;
 }
-
 //#endregion
-export { freezeColumnWidths, getColumnText, getColumnValue, useTableColumns };
+export { freezeColumnWidths, getColumnText, getColumnValue, readPath, useTableColumns };
+
 //# sourceMappingURL=use-table-columns.js.map

package/dist/components/data/TableBase/use-table-columns.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-table-columns.js","names":["useMemo","CubeResolvedColumn","CubeTableColumn","CubeTableColumnLayout","DEFAULT_MIN_WIDTH","freezeColumnWidths","layout","T","base","Record","columns","reduce","widths","column","isStructural","width","key","Math","round","readPath","row","path","undefined","includes","current","part","split","ValueColumn","Pick","getColumnValue","rowIndex","getValue","getColumnText","value","format","type","String","Date","toISOString","clamp","min","max","Number","POSITIVE_INFINITY","UseTableColumnsOptions","containerWidth","columnWidths","leadingColumns","trailingColumns","ColumnSpec","fixed","minWidth","maxWidth","flex","orderColumns","visible","filter","isHidden","c","pin","toColumnSpec","explicit","sumFlex","specs","sum","s","distributeFlexWidths","flexSpecs","available","resolved","Map","remaining","pool","length","totalFlex","nextPool","consumed","spec","ideal","clamped","set","push","totalLeft","resolveWidths","isOverflowing","isMeasured","minTotal","fixedTotal","applyPinOffsets","pinnedStartWidth","pinnedEndWidth","pinOffset","i","lastPinnedStart","at","firstPinnedEnd","find","isPinEdge","resolveColumnLayout","leading","trailing","structuralKeys","Set","map","has","out","index","ariaColIndex","get","align","totalWidth","every","useTableColumns","t0","$","_c","t1"],"sources":["../../../../src/components/data/TableBase/use-table-columns.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nimport type {\n  CubeResolvedColumn,\n  CubeTableColumn,\n  CubeTableColumnLayout,\n} from './types';\n\n/** @default when a column declares neither `width` nor `minWidth`. */\nexport const DEFAULT_MIN_WIDTH = 150;\n\n/**\n * Every column's current width, so a resize can change exactly one of them.\n *\n * A column with no explicit width is `flex: 1` and shares the leftover (see the\n * spec builder below). Making only the DRAGGED column fixed leaves every other\n * one in the flex pool, re-splitting a leftover that just changed — so one\n * divider moved all of them, including columns to the LEFT of the handle, which\n * cannot be what dragging a right edge means. Measured before this existed:\n * dragging column B by +8px took 3px off A, C and D each.\n *\n * Freezing first means a drag changes one width. Columns after it are pushed\n * along, which is what being after it means, and the table grows or shrinks\n * rather than the neighbours absorbing the difference.\n *\n * Structural columns are skipped — they are sized by the table, not the user.\n */\nexport function freezeColumnWidths<T>(\n  layout: CubeTableColumnLayout<T> | null,\n  base: Record<string, number>,\n): Record<string, number> {\n  return (layout?.columns ?? []).reduce<Record<string, number>>(\n    (widths, column) => {\n      if (!column.isStructural && column.width != null) {\n        widths[column.key] = Math.round(column.width);\n      }\n\n      return widths;\n    },\n    { ...base },\n  );\n}\n\n/**\n * Reads `key` as a data path. A plain key is a single property lookup; dots\n * walk nested objects (`'owner.name'`). Anything richer belongs in `getValue`.\n */\nexport function readPath(row: any, path: string): unknown {\n  if (row == null) return undefined;\n  if (!path.includes('.')) return row[path];\n\n  let current: any = row;\n\n  for (const part of path.split('.')) {\n    if (current == null) return undefined;\n    current = current[part];\n  }\n\n  return current;\n}\n\n/** Only the value-pipeline members, so both raw and resolved columns fit. */\ntype ValueColumn<T> = Pick<CubeTableColumn<T>, 'key' | 'getValue' | 'format'>;\n\nexport function getColumnValue<T>(\n  column: ValueColumn<T>,\n  row: T,\n  rowIndex: number,\n): unknown {\n  return column.getValue\n    ? column.getValue(row, rowIndex)\n    : readPath(row, column.key);\n}\n\n/**\n * Display text for a cell — what client sort, client search and TSV copy all\n * operate on. Deliberately NOT the rendered output: `render` may return\n * arbitrary React, and stringifying that is how cloud's filter ended up\n * matching `\"[object Object]\"` against the query `\"object\"`.\n *\n * Returns `null` when the column cannot produce text, so callers can skip it\n * rather than coerce a non-primitive.\n */\nexport function getColumnText<T>(\n  column: ValueColumn<T>,\n  row: T,\n  rowIndex: number,\n): string | null {\n  const value = getColumnValue(column, row, rowIndex);\n\n  if (column.format) return column.format(value, row, rowIndex);\n  if (value == null) return '';\n\n  const type = typeof value;\n\n  if (type === 'string') return value as string;\n  if (type === 'number' || type === 'boolean' || type === 'bigint') {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n\n  return null;\n}\n\nfunction clamp(value: number, min: number, max: number | null): number {\n  return Math.min(Math.max(value, min), max ?? Number.POSITIVE_INFINITY);\n}\n\nexport interface UseTableColumnsOptions<T> {\n  columns: CubeTableColumn<T>[];\n  /** Content-box width of the scroller, or `null` before the first measure. */\n  containerWidth: number | null;\n  /** User-resized widths, keyed by column key. Wins over `column.width`. */\n  columnWidths?: Record<string, number>;\n  /** Extra leading columns owned by the table (selection, drag handle). */\n  leadingColumns?: CubeTableColumn<T>[];\n  /** Extra trailing columns owned by the table (row menu). */\n  trailingColumns?: CubeTableColumn<T>[];\n}\n\n/** A column's sizing inputs, before the container is split between columns. */\ninterface ColumnSpec<T> {\n  column: CubeTableColumn<T>;\n  isStructural: boolean;\n  fixed: number | null;\n  minWidth: number;\n  maxWidth: number | null;\n  flex: number | null;\n}\n\n/**\n * The visible columns in visual order. Pinned columns lead and trail\n * regardless of their position in the source array, so `aria-colindex` and DOM\n * order agree and nothing needs CSS `order:` to be reshuffled.\n */\nfunction orderColumns<T>(columns: CubeTableColumn<T>[]): CubeTableColumn<T>[] {\n  const visible = columns.filter((column) => !column.isHidden);\n\n  return [\n    ...visible.filter((c) => c.pin === 'start'),\n    ...visible.filter((c) => !c.pin),\n    ...visible.filter((c) => c.pin === 'end'),\n  ];\n}\n\nfunction toColumnSpec<T>(\n  column: CubeTableColumn<T>,\n  isStructural: boolean,\n  columnWidths: Record<string, number> | undefined,\n): ColumnSpec<T> {\n  const explicit = columnWidths?.[column.key] ?? column.width;\n  const minWidth =\n    column.minWidth ??\n    (explicit != null ? explicit : isStructural ? 0 : DEFAULT_MIN_WIDTH);\n\n  return {\n    column,\n    isStructural,\n    fixed: explicit ?? null,\n    minWidth,\n    maxWidth: column.maxWidth ?? null,\n    flex: explicit != null ? null : column.flex ?? 1,\n  };\n}\n\nfunction sumFlex<T>(specs: ColumnSpec<T>[]): number {\n  return specs.reduce((sum, s) => sum + (s.flex ?? 1), 0);\n}\n\n/**\n * Splits `available` pixels across the flex columns by weight. Each pass\n * assigns proportional widths, freezes whatever hit a bound, and re-splits the\n * leftover among the rest.\n */\nfunction distributeFlexWidths<T>(\n  flexSpecs: ColumnSpec<T>[],\n  available: number,\n  resolved: Map<string, number>,\n): void {\n  let remaining = available;\n  let pool = flexSpecs;\n\n  while (pool.length > 0) {\n    const totalFlex = sumFlex(pool);\n    const nextPool: typeof pool = [];\n    let consumed = 0;\n\n    for (const spec of pool) {\n      const ideal = (remaining * (spec.flex ?? 1)) / (totalFlex || 1);\n      const clamped = clamp(ideal, spec.minWidth, spec.maxWidth);\n\n      if (clamped !== ideal) {\n        resolved.set(spec.column.key, clamped);\n        consumed += clamped;\n      } else {\n        nextPool.push(spec);\n      }\n    }\n\n    if (nextPool.length === pool.length) {\n      // Nothing was clamped this pass — the proportional split stands.\n      const totalLeft = sumFlex(nextPool);\n      for (const spec of nextPool) {\n        resolved.set(\n          spec.column.key,\n          (remaining * (spec.flex ?? 1)) / (totalLeft || 1),\n        );\n      }\n      break;\n    }\n\n    remaining -= consumed;\n    pool = nextPool;\n  }\n}\n\n/**\n * Each column's pixel width, keyed by column key; none before the container is\n * measured. When even the minimums do not fit, every column takes its minimum\n * and the table overflows.\n */\nfunction resolveWidths<T>(\n  specs: ColumnSpec<T>[],\n  containerWidth: number | null,\n): { resolved: Map<string, number>; isOverflowing: boolean } {\n  const resolved = new Map<string, number>();\n  const isMeasured = containerWidth != null && containerWidth > 0;\n\n  if (!isMeasured) return { resolved, isOverflowing: false };\n\n  const minTotal = specs.reduce((sum, s) => sum + (s.fixed ?? s.minWidth), 0);\n\n  if (minTotal > containerWidth) {\n    for (const spec of specs) {\n      resolved.set(spec.column.key, spec.fixed ?? spec.minWidth);\n    }\n\n    return { resolved, isOverflowing: true };\n  }\n\n  const fixedTotal = specs.reduce((sum, s) => sum + (s.fixed ?? 0), 0);\n\n  distributeFlexWidths(\n    specs.filter((s) => s.fixed == null),\n    containerWidth - fixedTotal,\n    resolved,\n  );\n\n  for (const spec of specs) {\n    if (spec.fixed != null) resolved.set(spec.column.key, spec.fixed);\n  }\n\n  return { resolved, isOverflowing: false };\n}\n\n/**\n * Sets each pinned column's sticky offset, which accumulates inwards from its\n * edge, and marks the innermost pinned column on each side. Returns the width\n * pinned to each side.\n */\nfunction applyPinOffsets<T>(columns: CubeResolvedColumn<T>[]): {\n  pinnedStartWidth: number;\n  pinnedEndWidth: number;\n} {\n  let pinnedStartWidth = 0;\n  let pinnedEndWidth = 0;\n\n  for (const column of columns) {\n    if (column.pin !== 'start') continue;\n    column.pinOffset = pinnedStartWidth;\n    pinnedStartWidth += column.width ?? column.minWidth;\n  }\n\n  for (let i = columns.length - 1; i >= 0; i--) {\n    const column = columns[i];\n    if (column.pin !== 'end') continue;\n    column.pinOffset = pinnedEndWidth;\n    pinnedEndWidth += column.width ?? column.minWidth;\n  }\n\n  const lastPinnedStart = columns.filter((c) => c.pin === 'start').at(-1);\n  const firstPinnedEnd = columns.find((c) => c.pin === 'end');\n\n  if (lastPinnedStart) lastPinnedStart.isPinEdge = true;\n  if (firstPinnedEnd) firstPinnedEnd.isPinEdge = true;\n\n  return { pinnedStartWidth, pinnedEndWidth };\n}\n\nfunction resolveColumnLayout<T>({\n  columns,\n  containerWidth,\n  columnWidths,\n  leadingColumns,\n  trailingColumns,\n}: UseTableColumnsOptions<T>): CubeTableColumnLayout<T> {\n  const leading = leadingColumns ?? [];\n  const trailing = trailingColumns ?? [];\n  const structuralKeys = new Set([...leading, ...trailing].map((c) => c.key));\n  const specs = orderColumns([...leading, ...columns, ...trailing]).map(\n    (column) =>\n      toColumnSpec(column, structuralKeys.has(column.key), columnWidths),\n  );\n  const { resolved, isOverflowing } = resolveWidths(specs, containerWidth);\n\n  const out: CubeResolvedColumn<T>[] = specs.map((spec, index) => ({\n    ...spec.column,\n    index,\n    ariaColIndex: index + 1,\n    width: resolved.get(spec.column.key) ?? null,\n    minWidth: spec.minWidth,\n    maxWidth: spec.maxWidth,\n    flex: spec.flex,\n    align: spec.column.align ?? 'start',\n    pinOffset: null,\n    isPinEdge: false,\n    isStructural: spec.isStructural,\n  }));\n\n  const { pinnedStartWidth, pinnedEndWidth } = applyPinOffsets(out);\n\n  const totalWidth = out.every((c) => c.width != null)\n    ? out.reduce((sum, c) => sum + (c.width ?? 0), 0)\n    : null;\n\n  return {\n    columns: out,\n    pinnedStartWidth,\n    pinnedEndWidth,\n    totalWidth,\n    isOverflowing,\n  };\n}\n\n/**\n * Normalizes the public column list into resolved leaves: visual order, ARIA\n * indices, pixel widths, and sticky offsets for pinned columns.\n *\n * Width resolution mirrors ag-grid's `fitGridWidth`: fixed columns take their\n * width, the remainder is split across flex columns by weight, and each result\n * is clamped to `[minWidth, maxWidth]`. Clamping perturbs the sum, so the\n * residual is redistributed across the still-unclamped columns until it\n * settles. When even the minimums do not fit, every column takes its minimum\n * and the table scrolls horizontally.\n */\nexport function useTableColumns<T>({\n  columns,\n  containerWidth,\n  columnWidths,\n  leadingColumns,\n  trailingColumns,\n}: UseTableColumnsOptions<T>): CubeTableColumnLayout<T> {\n  return useMemo(\n    () =>\n      resolveColumnLayout({\n        columns,\n        containerWidth,\n        columnWidths,\n        leadingColumns,\n        trailingColumns,\n      }),\n    [columns, containerWidth, columnWidths, leadingColumns, trailingColumns],\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-table-columns.js","names":["useMemo","CubeResolvedColumn","CubeTableColumn","CubeTableColumnLayout","DEFAULT_MIN_WIDTH","freezeColumnWidths","layout","T","base","Record","columns","reduce","widths","column","isStructural","width","key","Math","round","readPath","row","path","undefined","includes","current","part","split","ValueColumn","Pick","getColumnValue","rowIndex","getValue","getColumnText","value","format","type","String","Date","toISOString","clamp","min","max","Number","POSITIVE_INFINITY","UseTableColumnsOptions","containerWidth","columnWidths","leadingColumns","trailingColumns","ColumnSpec","fixed","minWidth","maxWidth","flex","orderColumns","visible","filter","isHidden","c","pin","toColumnSpec","explicit","sumFlex","specs","sum","s","distributeFlexWidths","flexSpecs","available","resolved","Map","remaining","pool","length","totalFlex","nextPool","consumed","spec","ideal","clamped","set","push","totalLeft","resolveWidths","isOverflowing","isMeasured","minTotal","fixedTotal","applyPinOffsets","pinnedStartWidth","pinnedEndWidth","pinOffset","i","lastPinnedStart","at","firstPinnedEnd","find","isPinEdge","resolveColumnLayout","leading","trailing","structuralKeys","Set","map","has","out","index","ariaColIndex","get","align","totalWidth","every","useTableColumns","t0","$","_c","t1","_c"],"sources":["../../../../src/components/data/TableBase/use-table-columns.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nimport type {\n  CubeResolvedColumn,\n  CubeTableColumn,\n  CubeTableColumnLayout,\n} from './types';\n\n/** @default when a column declares neither `width` nor `minWidth`. */\nexport const DEFAULT_MIN_WIDTH = 150;\n\n/**\n * Every column's current width, so a resize can change exactly one of them.\n *\n * A column with no explicit width is `flex: 1` and shares the leftover (see the\n * spec builder below). Making only the DRAGGED column fixed leaves every other\n * one in the flex pool, re-splitting a leftover that just changed — so one\n * divider moved all of them, including columns to the LEFT of the handle, which\n * cannot be what dragging a right edge means. Measured before this existed:\n * dragging column B by +8px took 3px off A, C and D each.\n *\n * Freezing first means a drag changes one width. Columns after it are pushed\n * along, which is what being after it means, and the table grows or shrinks\n * rather than the neighbours absorbing the difference.\n *\n * Structural columns are skipped — they are sized by the table, not the user.\n */\nexport function freezeColumnWidths<T>(\n  layout: CubeTableColumnLayout<T> | null,\n  base: Record<string, number>,\n): Record<string, number> {\n  return (layout?.columns ?? []).reduce<Record<string, number>>(\n    (widths, column) => {\n      if (!column.isStructural && column.width != null) {\n        widths[column.key] = Math.round(column.width);\n      }\n\n      return widths;\n    },\n    { ...base },\n  );\n}\n\n/**\n * Reads `key` as a data path. A plain key is a single property lookup; dots\n * walk nested objects (`'owner.name'`). Anything richer belongs in `getValue`.\n */\nexport function readPath(row: any, path: string): unknown {\n  if (row == null) return undefined;\n  if (!path.includes('.')) return row[path];\n\n  let current: any = row;\n\n  for (const part of path.split('.')) {\n    if (current == null) return undefined;\n    current = current[part];\n  }\n\n  return current;\n}\n\n/** Only the value-pipeline members, so both raw and resolved columns fit. */\ntype ValueColumn<T> = Pick<CubeTableColumn<T>, 'key' | 'getValue' | 'format'>;\n\nexport function getColumnValue<T>(\n  column: ValueColumn<T>,\n  row: T,\n  rowIndex: number,\n): unknown {\n  return column.getValue\n    ? column.getValue(row, rowIndex)\n    : readPath(row, column.key);\n}\n\n/**\n * Display text for a cell — what client sort, client search and TSV copy all\n * operate on. Deliberately NOT the rendered output: `render` may return\n * arbitrary React, and stringifying that is how cloud's filter ended up\n * matching `\"[object Object]\"` against the query `\"object\"`.\n *\n * Returns `null` when the column cannot produce text, so callers can skip it\n * rather than coerce a non-primitive.\n */\nexport function getColumnText<T>(\n  column: ValueColumn<T>,\n  row: T,\n  rowIndex: number,\n): string | null {\n  const value = getColumnValue(column, row, rowIndex);\n\n  if (column.format) return column.format(value, row, rowIndex);\n  if (value == null) return '';\n\n  const type = typeof value;\n\n  if (type === 'string') return value as string;\n  if (type === 'number' || type === 'boolean' || type === 'bigint') {\n    return String(value);\n  }\n  if (value instanceof Date) return value.toISOString();\n\n  return null;\n}\n\nfunction clamp(value: number, min: number, max: number | null): number {\n  return Math.min(Math.max(value, min), max ?? Number.POSITIVE_INFINITY);\n}\n\nexport interface UseTableColumnsOptions<T> {\n  columns: CubeTableColumn<T>[];\n  /** Content-box width of the scroller, or `null` before the first measure. */\n  containerWidth: number | null;\n  /** User-resized widths, keyed by column key. Wins over `column.width`. */\n  columnWidths?: Record<string, number>;\n  /** Extra leading columns owned by the table (selection, drag handle). */\n  leadingColumns?: CubeTableColumn<T>[];\n  /** Extra trailing columns owned by the table (row menu). */\n  trailingColumns?: CubeTableColumn<T>[];\n}\n\n/** A column's sizing inputs, before the container is split between columns. */\ninterface ColumnSpec<T> {\n  column: CubeTableColumn<T>;\n  isStructural: boolean;\n  fixed: number | null;\n  minWidth: number;\n  maxWidth: number | null;\n  flex: number | null;\n}\n\n/**\n * The visible columns in visual order. Pinned columns lead and trail\n * regardless of their position in the source array, so `aria-colindex` and DOM\n * order agree and nothing needs CSS `order:` to be reshuffled.\n */\nfunction orderColumns<T>(columns: CubeTableColumn<T>[]): CubeTableColumn<T>[] {\n  const visible = columns.filter((column) => !column.isHidden);\n\n  return [\n    ...visible.filter((c) => c.pin === 'start'),\n    ...visible.filter((c) => !c.pin),\n    ...visible.filter((c) => c.pin === 'end'),\n  ];\n}\n\nfunction toColumnSpec<T>(\n  column: CubeTableColumn<T>,\n  isStructural: boolean,\n  columnWidths: Record<string, number> | undefined,\n): ColumnSpec<T> {\n  const explicit = columnWidths?.[column.key] ?? column.width;\n  const minWidth =\n    column.minWidth ??\n    (explicit != null ? explicit : isStructural ? 0 : DEFAULT_MIN_WIDTH);\n\n  return {\n    column,\n    isStructural,\n    fixed: explicit ?? null,\n    minWidth,\n    maxWidth: column.maxWidth ?? null,\n    flex: explicit != null ? null : (column.flex ?? 1),\n  };\n}\n\nfunction sumFlex<T>(specs: ColumnSpec<T>[]): number {\n  return specs.reduce((sum, s) => sum + (s.flex ?? 1), 0);\n}\n\n/**\n * Splits `available` pixels across the flex columns by weight. Each pass\n * assigns proportional widths, freezes whatever hit a bound, and re-splits the\n * leftover among the rest.\n */\nfunction distributeFlexWidths<T>(\n  flexSpecs: ColumnSpec<T>[],\n  available: number,\n  resolved: Map<string, number>,\n): void {\n  let remaining = available;\n  let pool = flexSpecs;\n\n  while (pool.length > 0) {\n    const totalFlex = sumFlex(pool);\n    const nextPool: typeof pool = [];\n    let consumed = 0;\n\n    for (const spec of pool) {\n      const ideal = (remaining * (spec.flex ?? 1)) / (totalFlex || 1);\n      const clamped = clamp(ideal, spec.minWidth, spec.maxWidth);\n\n      if (clamped !== ideal) {\n        resolved.set(spec.column.key, clamped);\n        consumed += clamped;\n      } else {\n        nextPool.push(spec);\n      }\n    }\n\n    if (nextPool.length === pool.length) {\n      // Nothing was clamped this pass — the proportional split stands.\n      const totalLeft = sumFlex(nextPool);\n      for (const spec of nextPool) {\n        resolved.set(\n          spec.column.key,\n          (remaining * (spec.flex ?? 1)) / (totalLeft || 1),\n        );\n      }\n      break;\n    }\n\n    remaining -= consumed;\n    pool = nextPool;\n  }\n}\n\n/**\n * Each column's pixel width, keyed by column key; none before the container is\n * measured. When even the minimums do not fit, every column takes its minimum\n * and the table overflows.\n */\nfunction resolveWidths<T>(\n  specs: ColumnSpec<T>[],\n  containerWidth: number | null,\n): { resolved: Map<string, number>; isOverflowing: boolean } {\n  const resolved = new Map<string, number>();\n  const isMeasured = containerWidth != null && containerWidth > 0;\n\n  if (!isMeasured) return { resolved, isOverflowing: false };\n\n  const minTotal = specs.reduce((sum, s) => sum + (s.fixed ?? s.minWidth), 0);\n\n  if (minTotal > containerWidth) {\n    for (const spec of specs) {\n      resolved.set(spec.column.key, spec.fixed ?? spec.minWidth);\n    }\n\n    return { resolved, isOverflowing: true };\n  }\n\n  const fixedTotal = specs.reduce((sum, s) => sum + (s.fixed ?? 0), 0);\n\n  distributeFlexWidths(\n    specs.filter((s) => s.fixed == null),\n    containerWidth - fixedTotal,\n    resolved,\n  );\n\n  for (const spec of specs) {\n    if (spec.fixed != null) resolved.set(spec.column.key, spec.fixed);\n  }\n\n  return { resolved, isOverflowing: false };\n}\n\n/**\n * Sets each pinned column's sticky offset, which accumulates inwards from its\n * edge, and marks the innermost pinned column on each side. Returns the width\n * pinned to each side.\n */\nfunction applyPinOffsets<T>(columns: CubeResolvedColumn<T>[]): {\n  pinnedStartWidth: number;\n  pinnedEndWidth: number;\n} {\n  let pinnedStartWidth = 0;\n  let pinnedEndWidth = 0;\n\n  for (const column of columns) {\n    if (column.pin !== 'start') continue;\n    column.pinOffset = pinnedStartWidth;\n    pinnedStartWidth += column.width ?? column.minWidth;\n  }\n\n  for (let i = columns.length - 1; i >= 0; i--) {\n    const column = columns[i];\n    if (column.pin !== 'end') continue;\n    column.pinOffset = pinnedEndWidth;\n    pinnedEndWidth += column.width ?? column.minWidth;\n  }\n\n  const lastPinnedStart = columns.filter((c) => c.pin === 'start').at(-1);\n  const firstPinnedEnd = columns.find((c) => c.pin === 'end');\n\n  if (lastPinnedStart) lastPinnedStart.isPinEdge = true;\n  if (firstPinnedEnd) firstPinnedEnd.isPinEdge = true;\n\n  return { pinnedStartWidth, pinnedEndWidth };\n}\n\nfunction resolveColumnLayout<T>({\n  columns,\n  containerWidth,\n  columnWidths,\n  leadingColumns,\n  trailingColumns,\n}: UseTableColumnsOptions<T>): CubeTableColumnLayout<T> {\n  const leading = leadingColumns ?? [];\n  const trailing = trailingColumns ?? [];\n  const structuralKeys = new Set([...leading, ...trailing].map((c) => c.key));\n  const specs = orderColumns([...leading, ...columns, ...trailing]).map(\n    (column) =>\n      toColumnSpec(column, structuralKeys.has(column.key), columnWidths),\n  );\n  const { resolved, isOverflowing } = resolveWidths(specs, containerWidth);\n\n  const out: CubeResolvedColumn<T>[] = specs.map((spec, index) => ({\n    ...spec.column,\n    index,\n    ariaColIndex: index + 1,\n    width: resolved.get(spec.column.key) ?? null,\n    minWidth: spec.minWidth,\n    maxWidth: spec.maxWidth,\n    flex: spec.flex,\n    align: spec.column.align ?? 'start',\n    pinOffset: null,\n    isPinEdge: false,\n    isStructural: spec.isStructural,\n  }));\n\n  const { pinnedStartWidth, pinnedEndWidth } = applyPinOffsets(out);\n\n  const totalWidth = out.every((c) => c.width != null)\n    ? out.reduce((sum, c) => sum + (c.width ?? 0), 0)\n    : null;\n\n  return {\n    columns: out,\n    pinnedStartWidth,\n    pinnedEndWidth,\n    totalWidth,\n    isOverflowing,\n  };\n}\n\n/**\n * Normalizes the public column list into resolved leaves: visual order, ARIA\n * indices, pixel widths, and sticky offsets for pinned columns.\n *\n * Width resolution mirrors ag-grid's `fitGridWidth`: fixed columns take their\n * width, the remainder is split across flex columns by weight, and each result\n * is clamped to `[minWidth, maxWidth]`. Clamping perturbs the sum, so the\n * residual is redistributed across the still-unclamped columns until it\n * settles. When even the minimums do not fit, every column takes its minimum\n * and the table scrolls horizontally.\n */\nexport function useTableColumns<T>({\n  columns,\n  containerWidth,\n  columnWidths,\n  leadingColumns,\n  trailingColumns,\n}: UseTableColumnsOptions<T>): CubeTableColumnLayout<T> {\n  return useMemo(\n    () =>\n      resolveColumnLayout({\n        columns,\n        containerWidth,\n        columnWidths,\n        leadingColumns,\n        trailingColumns,\n      }),\n    [columns, containerWidth, columnWidths, leadingColumns, trailingColumns],\n  );\n}\n"],"mappings":"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"}

package/dist/components/data/TableBase/use-table-search.js

@@ -1,10 +1,9 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useDebouncedValue } from "../../../_internal/hooks/use-debounced-value.js";
 import { getColumnText } from "./use-table-columns.js";
 import { c } from "react/compiler-runtime";
 import { useEffect, useEffectEvent, useRef, useState } from "react";
 import { useControlledState } from "@react-stately/utils";
-
 //#region src/components/data/TableBase/use-table-search.ts
 /**
 * Default matcher: a case-insensitive substring test against each searchable
@@ -128,7 +127,7 @@ function useTableSearch(t0) {
 	} else t11 = $[25];
 	return t11;
 }
-
 //#endregion
 export { matchesTableSearch, useTableSearch };
+
 //# sourceMappingURL=use-table-search.js.map

package/dist/components/data/TableBase/use-table-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-table-search.js","names":["useControlledState","useEffect","useEffectEvent","useMemo","useRef","useState","useDebouncedValue","getColumnText","CubeTableColumn","CubeTableSearchMode","UseTableSearchOptions","columns","T","rows","mode","value","defaultValue","onChange","delay","filter","row","query","UseTableSearchResult","searchValue","setSearchValue","searchedRows","isFiltered","matchesTableSearch","rowIndex","some","column","isSearchable","text","toLowerCase","includes","useTableSearch","t0","$","_c","t1","t2","undefined","committed","setCommitted","v","draft","setDraft","debounced","pushedRef","t3","t4","current","t5","next","commitSearch","t6","t7","t8","trim","t9","bb0","t10","t11","index","length"],"sources":["../../../../src/components/data/TableBase/use-table-search.ts"],"sourcesContent":["import { useControlledState } from '@react-stately/utils';\nimport { useEffect, useEffectEvent, useMemo, useRef, useState } from 'react';\n\nimport { useDebouncedValue } from '../../../_internal/hooks/use-debounced-value';\n\nimport { getColumnText } from './use-table-columns';\n\nimport type { CubeTableColumn } from './types';\n\nexport type CubeTableSearchMode = 'client' | 'server';\n\nexport interface UseTableSearchOptions<T> {\n  columns: CubeTableColumn<T>[];\n  rows: readonly T[];\n  /** @default 'client' */\n  mode?: CubeTableSearchMode;\n  value?: string;\n  defaultValue?: string;\n  onChange?: (value: string) => void;\n  /** Debounces the filter AND the callback, in both modes. @default 500 */\n  delay?: number;\n  /** Replaces the default matcher in client mode. */\n  filter?: (row: T, query: string) => boolean;\n}\n\nexport interface UseTableSearchResult<T> {\n  /** The immediate term — what the input shows. */\n  searchValue: string;\n  setSearchValue: (value: string) => void;\n  /** The debounced term — what the filter and the callback act on. */\n  query: string;\n  /** Filtered in client mode; the original array otherwise. */\n  searchedRows: readonly T[];\n  /** `true` when a non-empty term is narrowing the data. */\n  isFiltered: boolean;\n}\n\n/**\n * Default matcher: a case-insensitive substring test against each searchable\n * column's **display text**.\n *\n * Deliberately not the raw value. Cloud's filter tested\n * `String(row[column.key])`, which meant a column rendering `owner.profile.name`\n * was unsearchable, and an object-valued column stringified to\n * `\"[object Object]\"` — so the query \"object\" matched every row with a nested\n * value. `getColumnText` returns `null` for anything it cannot honestly turn\n * into text, and those columns are skipped rather than coerced.\n */\nexport function matchesTableSearch<T>(\n  columns: CubeTableColumn<T>[],\n  row: T,\n  rowIndex: number,\n  query: string,\n): boolean {\n  return columns.some((column) => {\n    if (column.isSearchable === false) return false;\n\n    const text = getColumnText(column, row, rowIndex);\n\n    return text != null && text.toLowerCase().includes(query);\n  });\n}\n\nexport function useTableSearch<T>({\n  columns,\n  rows,\n  mode = 'client',\n  value,\n  defaultValue,\n  onChange,\n  delay = 500,\n  filter,\n}: UseTableSearchOptions<T>): UseTableSearchResult<T> {\n  const [committed, setCommitted] = useControlledState<string>(\n    value as string,\n    defaultValue ?? '',\n    onChange as (v: string) => void,\n  );\n\n  // What the input shows, updated on every keystroke. The committed value —\n  // the one `onChange` reports and the filter runs on — trails it by `delay`.\n  //\n  // Two separate values rather than one, because `useControlledState` calls\n  // `onChange` the moment it is set: routing keystrokes straight into it fired\n  // a request per character in `searchMode=\"server\"`, which is the thing the\n  // debounce exists to prevent. Debouncing the input itself instead would make\n  // typing lag, so the split is the point.\n  const [draft, setDraft] = useState(committed);\n  const debounced = useDebouncedValue(draft, delay);\n\n  // What we last pushed outward, so the sync below can tell a genuine external\n  // change from the echo of our own debounce.\n  const pushedRef = useRef(committed);\n\n  // A controlled `searchValue` changing from OUTSIDE — a cleared filter, a\n  // restored URL — wins over whatever is half-typed.\n  //\n  // The echo has to be filtered out or this reverts the input mid-word: with a\n  // short delay the debounce commits letter 1 while letter 2 is already typed,\n  // and syncing unconditionally puts letter 1 back. At `searchDelay={0}` that\n  // happens on every keystroke and nothing longer than one character can ever\n  // be typed.\n  useEffect(() => {\n    if (committed === pushedRef.current) return;\n\n    pushedRef.current = committed;\n    setDraft(committed);\n  }, [committed]);\n\n  const commitSearch = useEffectEvent((next: string) => setCommitted(next));\n\n  useEffect(() => {\n    if (debounced === pushedRef.current) return;\n\n    pushedRef.current = debounced;\n    commitSearch(debounced);\n  }, [debounced]);\n\n  const searchValue = draft;\n  const query = debounced.trim().toLowerCase();\n\n  const setSearchValue = setDraft;\n\n  const searchedRows = useMemo(() => {\n    if (mode !== 'client' || !query) return rows;\n\n    return rows.filter((row, index) =>\n      filter\n        ? filter(row, query)\n        : matchesTableSearch(columns, row, index, query),\n    );\n  }, [mode, query, rows, columns, filter]);\n\n  return {\n    searchValue,\n    setSearchValue,\n    query,\n    searchedRows,\n    isFiltered: query.length > 0,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-table-search.js","names":["useControlledState","useEffect","useEffectEvent","useMemo","useRef","useState","useDebouncedValue","getColumnText","CubeTableColumn","CubeTableSearchMode","UseTableSearchOptions","columns","T","rows","mode","value","defaultValue","onChange","delay","filter","row","query","UseTableSearchResult","searchValue","setSearchValue","searchedRows","isFiltered","matchesTableSearch","rowIndex","some","column","isSearchable","text","toLowerCase","includes","useTableSearch","t0","$","_c","t1","t2","undefined","committed","setCommitted","v","draft","setDraft","debounced","pushedRef","t3","t4","current","t5","next","commitSearch","t6","t7","t8","trim","t9","bb0","t10","t11","index","length","_c"],"sources":["../../../../src/components/data/TableBase/use-table-search.ts"],"sourcesContent":["import { useControlledState } from '@react-stately/utils';\nimport { useEffect, useEffectEvent, useMemo, useRef, useState } from 'react';\n\nimport { useDebouncedValue } from '../../../_internal/hooks/use-debounced-value';\n\nimport { getColumnText } from './use-table-columns';\n\nimport type { CubeTableColumn } from './types';\n\nexport type CubeTableSearchMode = 'client' | 'server';\n\nexport interface UseTableSearchOptions<T> {\n  columns: CubeTableColumn<T>[];\n  rows: readonly T[];\n  /** @default 'client' */\n  mode?: CubeTableSearchMode;\n  value?: string;\n  defaultValue?: string;\n  onChange?: (value: string) => void;\n  /** Debounces the filter AND the callback, in both modes. @default 500 */\n  delay?: number;\n  /** Replaces the default matcher in client mode. */\n  filter?: (row: T, query: string) => boolean;\n}\n\nexport interface UseTableSearchResult<T> {\n  /** The immediate term — what the input shows. */\n  searchValue: string;\n  setSearchValue: (value: string) => void;\n  /** The debounced term — what the filter and the callback act on. */\n  query: string;\n  /** Filtered in client mode; the original array otherwise. */\n  searchedRows: readonly T[];\n  /** `true` when a non-empty term is narrowing the data. */\n  isFiltered: boolean;\n}\n\n/**\n * Default matcher: a case-insensitive substring test against each searchable\n * column's **display text**.\n *\n * Deliberately not the raw value. Cloud's filter tested\n * `String(row[column.key])`, which meant a column rendering `owner.profile.name`\n * was unsearchable, and an object-valued column stringified to\n * `\"[object Object]\"` — so the query \"object\" matched every row with a nested\n * value. `getColumnText` returns `null` for anything it cannot honestly turn\n * into text, and those columns are skipped rather than coerced.\n */\nexport function matchesTableSearch<T>(\n  columns: CubeTableColumn<T>[],\n  row: T,\n  rowIndex: number,\n  query: string,\n): boolean {\n  return columns.some((column) => {\n    if (column.isSearchable === false) return false;\n\n    const text = getColumnText(column, row, rowIndex);\n\n    return text != null && text.toLowerCase().includes(query);\n  });\n}\n\nexport function useTableSearch<T>({\n  columns,\n  rows,\n  mode = 'client',\n  value,\n  defaultValue,\n  onChange,\n  delay = 500,\n  filter,\n}: UseTableSearchOptions<T>): UseTableSearchResult<T> {\n  const [committed, setCommitted] = useControlledState<string>(\n    value as string,\n    defaultValue ?? '',\n    onChange as (v: string) => void,\n  );\n\n  // What the input shows, updated on every keystroke. The committed value —\n  // the one `onChange` reports and the filter runs on — trails it by `delay`.\n  //\n  // Two separate values rather than one, because `useControlledState` calls\n  // `onChange` the moment it is set: routing keystrokes straight into it fired\n  // a request per character in `searchMode=\"server\"`, which is the thing the\n  // debounce exists to prevent. Debouncing the input itself instead would make\n  // typing lag, so the split is the point.\n  const [draft, setDraft] = useState(committed);\n  const debounced = useDebouncedValue(draft, delay);\n\n  // What we last pushed outward, so the sync below can tell a genuine external\n  // change from the echo of our own debounce.\n  const pushedRef = useRef(committed);\n\n  // A controlled `searchValue` changing from OUTSIDE — a cleared filter, a\n  // restored URL — wins over whatever is half-typed.\n  //\n  // The echo has to be filtered out or this reverts the input mid-word: with a\n  // short delay the debounce commits letter 1 while letter 2 is already typed,\n  // and syncing unconditionally puts letter 1 back. At `searchDelay={0}` that\n  // happens on every keystroke and nothing longer than one character can ever\n  // be typed.\n  useEffect(() => {\n    if (committed === pushedRef.current) return;\n\n    pushedRef.current = committed;\n    setDraft(committed);\n  }, [committed]);\n\n  const commitSearch = useEffectEvent((next: string) => setCommitted(next));\n\n  useEffect(() => {\n    if (debounced === pushedRef.current) return;\n\n    pushedRef.current = debounced;\n    commitSearch(debounced);\n  }, [debounced]);\n\n  const searchValue = draft;\n  const query = debounced.trim().toLowerCase();\n\n  const setSearchValue = setDraft;\n\n  const searchedRows = useMemo(() => {\n    if (mode !== 'client' || !query) return rows;\n\n    return rows.filter((row, index) =>\n      filter\n        ? filter(row, query)\n        : matchesTableSearch(columns, row, index, query),\n    );\n  }, [mode, query, rows, columns, filter]);\n\n  return {\n    searchValue,\n    setSearchValue,\n    query,\n    searchedRows,\n    isFiltered: query.length > 0,\n  };\n}\n"],"mappings":"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"}

package/dist/components/data/TableBase/use-table-selection.d.ts

@@ -1,4 +1,5 @@
 
 import "./types.js";
+import "./RowCollection.js";
 import { SelectionManager } from "@react-stately/selection";
 import { Key } from "@react-types/shared";

package/dist/components/data/TableBase/use-table-selection.js

@@ -1,10 +1,9 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { RowCollection } from "./RowCollection.js";
 import { useCallback, useMemo, useRef } from "react";
 import { useMultipleSelectionState } from "react-stately";
 import { SelectionManager } from "@react-stately/selection";
-
 //#region src/components/data/TableBase/use-table-selection.ts
 /**
 * Reserved key for the checkbox column. Prefixed so it cannot collide with a
@@ -152,10 +151,12 @@ function useTableSelection(options) {
 		const list = [...keys_0];
 		onSelectionChange(list, list.map((key) => rowByKeyRef.current.get(key)).filter((row_3) => row_3 !== void 0));
 	});
+	const controlledSelection = useMemo(() => toSelection(selectedKeysProp), [selectedKeysProp]);
+	const defaultSelection = useMemo(() => toSelection(defaultSelectedKeys), [defaultSelectedKeys]);
 	const state = useMultipleSelectionState({
 		selectionMode,
-		selectedKeys: useMemo(() => toSelection(selectedKeysProp), [selectedKeysProp]),
-		defaultSelectedKeys: useMemo(() => toSelection(defaultSelectedKeys), [defaultSelectedKeys]),
+		selectedKeys: controlledSelection,
+		defaultSelectedKeys: defaultSelection,
 		disabledKeys: unselectableKeys,
 		disabledBehavior: "selection",
 		onSelectionChange: handleSelectionChange
@@ -261,7 +262,7 @@ function useTableSelection(options) {
 	const toggleRow = useEvent((key_9) => {
 		if (!canSelect(key_9)) return;
 		if (selectionMode === "single") {
-			state.setSelectedKeys(isSelected(key_9) ? /* @__PURE__ */ new Set() : new Set([key_9]));
+			state.setSelectedKeys(isSelected(key_9) ? /* @__PURE__ */ new Set() : /* @__PURE__ */ new Set([key_9]));
 			return;
 		}
 		const applyCascade = (set_0, target, value) => {
@@ -327,7 +328,7 @@ function useTableSelection(options) {
 		selectedKeys: isAll ? "all" : [...derivedSelection.checked]
 	};
 }
-
 //#endregion
 export { ROW_NUMBER_COLUMN_KEY, SELECTION_COLUMN_KEY, SELECTION_COLUMN_WIDTH, useTableSelection };
+
 //# sourceMappingURL=use-table-selection.js.map