DataTable Column Auto-fit

1"use client"
2 
3/**
4 * niko-table — created by Semir N. (Semkoo, https://github.com/Semkoo) with AI assistance.
5 *
6 * Before reporting anything: please check the changelog first.
7 *  - In-repo: ./CHANGELOG.md
8 *  - Docs site: https://niko-table.com/changelog
9 *
10 * Found a bug or have a fix? Open an issue or PR on GitHub so other
11 * users (and future LLMs reading this code) benefit:
12 * https://github.com/Semkoo/niko-table-registry
13 */
14 
15import { useDataTable } from "../core/data-table-context"
16import { useColumnAutoFit } from "../lib/use-column-auto-fit"
17 
18/**
19 * Opt-in column auto-fit — mix-and-match, like every other niko-table feature.
20 * Pairs with column resizing (`<DataTableColumnResize />`). DROP THIS anywhere
21 * inside `<DataTableRoot>` and, on load, the resizable columns scale up by an
22 * EQUAL SHARE of the leftover space. Leave it out and this whole feature (and
23 * its code) never ships — the default single-flex-column fill applies instead
24 * (the first non-pinned data column absorbs the surplus; see `meta.flex`).
25 *
26 * Self-contained: it runs the auto-fit logic itself off the table + scroll
27 * container from context, so the body structures carry no auto-fit code. It
28 * renders nothing. Auto-fit re-fits when the container grows and backs off once
29 * the user resizes a column or a saved `columnSizing` is restored, so manual
30 * and persisted widths win. No-ops unless resizing is enabled.
31 *
32 * @example
33 * <DataTableRoot data={data} columns={columns}>
34 *   <DataTableColumnResize />
35 *   <DataTableColumnAutoFit />
36 *   <DataTable>
37 *     <DataTableHeader />
38 *     <DataTableBody />
39 *   </DataTable>
40 * </DataTableRoot>
41 */
42export function DataTableColumnAutoFit() {
43  const { table, scrollContainer } = useDataTable()
44  const enabled = table.options.enableColumnResizing ?? false
45  useColumnAutoFit(table, scrollContainer, enabled)
46  return null
47}
48 
49DataTableColumnAutoFit.displayName = "DataTableColumnAutoFit"