@jielga/tmdatagrid 2.1.3 → 2.2.0

package/skills/appearance/SKILL.md

@@ -18,7 +18,7 @@ description: >
 metadata:
   type: core
   library: '@jielga/tmdatagrid'
-  library_version: '2.1.3'
+  library_version: '2.2.0'
 sources:
   - 'Jielga/react:packages/tmdatagrid/docs/styling.md'
   - 'Jielga/react:packages/tmdatagrid/docs/toolbar.md'
@@ -250,7 +250,9 @@ const labels = {
 `TMDataGridLabels` is the full dictionary type, so a missing key in a new
 translation is a compile error. The resolved dictionary comes back as
 `grid.labels` and from `useTMDataGridContext().labels`, so a component of your
-own uses the same strings as the built-in parts.
+own uses the same strings as the built-in parts. Every key, with its English
+default and where the grid shows it, is in
+[references/labels.md](references/labels.md).
 
 ## Common mistakes
 
@@ -319,7 +321,7 @@ const { canSort } = getColumnCapabilities(column, features);
 if (!canSort) return null;
 ```
 
-Source: `packages/tmdatagrid/docs/toolbar.md` (Why `features` is a second argument).
+Source: `packages/tmdatagrid/docs/toolbar.md` (Reading options reactively).
 
 ### MEDIUM An inline `labels` object
 
@@ -370,7 +372,7 @@ Source: `packages/tmdatagrid/docs/toolbar.md` (The built-in parts).
 | `grid.labels` | Hook return | `TMDataGridLabels` | – | The resolved dictionary. |
 | `TMDATAGRID_LABELS_EN` · `TMDATAGRID_LABELS_SV` | Exports | `TMDataGridLabels` | – | The English base, and a complete Swedish dictionary. |
 | `TMDataGridLabels` · `TMDataGridLabelsOverride` | Exports | types | – | The full dictionary, and a partial one. |
-| `mergeLabels` | Export | `(base, override) => TMDataGridLabels` | – | The merge, for composing dictionaries. |
+| `mergeLabels` | Export | `(override?: TMDataGridLabelsOverride) => TMDataGridLabels` | – | Folds a partial override over the English defaults. Returns `TMDATAGRID_LABELS_EN` itself without an argument. |
 | `meta.noResultsLabel` | Option | `string` | `labels.noResults` | Per-instance override of the filtered-empty message. |
 
 The CSS layer name `tmdatagrid` in `styles.layer.css` is public API and never

package/skills/appearance/references/labels.md

@@ -0,0 +1,126 @@
+# TMDataGrid labels
+
+Reference for the `appearance` skill: every key of `TMDataGridLabels`, its English default, and where the grid shows it; a function label shows its template.
+`TMDataGridLabels` has a fixed set of keys, so a full translation sets every key.
+The `labels` option takes a partial override, `TMDataGridLabelsOverride`, merged over English key by key; `operators` merges per operator.
+
+| Key | Default | Where it shows |
+| --- | --- | --- |
+| `operators.contains` | `contains` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.equals` | `equals` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.notEquals` | `does not equal` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.startsWith` | `starts with` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.endsWith` | `ends with` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.greaterThan` | `is greater than` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.greaterThanOrEqual` | `is greater than or equal to` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.lessThan` | `is less than` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.lessThanOrEqual` | `is less than or equal to` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.between` | `is between` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.before` | `is before` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.after` | `is after` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.onOrBefore` | `is on or before` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.onOrAfter` | `is on or after` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.isAnyOf` | `is any of` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.isNoneOf` | `is none of` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.isEmpty` | `is empty` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `operators.isNotEmpty` | `is not empty` | The operator select of `TMDataGrid.FilterPanel`, the text of a filter pill, and the operator button of a header filter. |
+| `filters` | `Filters` | Tooltip and `aria-label` of `TMDataGrid.FilterButton`, the title and `aria-label` of the filter popup and sidebar, and the `aria-label` of `TMDataGrid.FilterPanel`. |
+| `searchPlaceholder` | `Search` | Placeholder of `TMDataGrid.Search`. Its `placeholder` prop wins. |
+| `searchLabel` | `Search rows` | `aria-label` of the `TMDataGrid.Search` input. |
+| `clearSearch` | `Clear search` | `aria-label` of the clear button in `TMDataGrid.Search`. |
+| `menuButton` | `Menu` | Tooltip and `aria-label` of the `TMDataGrid.Menu` trigger. Its `label` prop wins. |
+| `manageColumns` | `Manage columns` | Column menu: the submenu that lists the columns. |
+| `columnsSearchPlaceholder` | `Search` | Search box of `TMDataGrid.ColumnsPanel`, `TMDataGrid.Menu.Columns` and the export column picker. |
+| `columnsNoMatch` | `` `No columns match “${search}”` `` | The same three lists, when the search matches no column. |
+| `columnsShowHideAll` | `Show/Hide All` | `TMDataGrid.ColumnsPanel` and `TMDataGrid.Menu.ShowHideAll`. |
+| `columnsReset` | `Reset layout` | `TMDataGrid.ColumnsPanel` and `TMDataGrid.Menu.ResetLayout`. |
+| `columnsResetHint` | `Resets column visibility, order, widths, pinning and grouping` | Tooltip of the reset button in `TMDataGrid.ColumnsPanel`. |
+| `rowNumberColumnLabel` | `Row number` | `meta.label` of the generated row-number lane. |
+| `noRows` | `No rows to show` | Body, when the view is empty, no column filter is active (`isFilterActive`) and the quick search is blank. |
+| `filterColumn` | `Column` | Label of the column field in `TMDataGrid.FilterPanel`. |
+| `filterOperator` | `Operator` | Label of the operator field in `TMDataGrid.FilterPanel`. |
+| `filterValue` | `Value` | Label of the value field in `TMDataGrid.FilterPanel`. |
+| `filterValuePlaceholder` | `Filter value` | Placeholder of the filter value input. |
+| `filterFrom` | `From` | The lower bound of a `between` filter: its input, or its slider thumb. |
+| `filterTo` | `To` | The upper bound of a `between` filter: its input, or its slider thumb. |
+| `filterAll` | `All` | The no-filter segment of the tri-state filter. |
+| `booleanTrue` | `Yes` | The `true` choice of a boolean filter value control and of the tri-state filter. |
+| `booleanFalse` | `No` | The `false` choice of a boolean filter value control and of the tri-state filter. |
+| `addFilter` | `Add filter` | Button in `TMDataGrid.FilterPanel`. |
+| `clearAllFilters` | `Clear all` | Button in `TMDataGrid.FilterPanel` and in `TMDataGrid.FilterPills`. |
+| `closeFilters` | `Close filters` | `aria-label` of the close button of the filter popup and sidebar. |
+| `removeFilter` | `Remove filter` | `aria-label` of the remove button on a filter row in `TMDataGrid.FilterPanel`. |
+| `filterOperatorFor` | `` `${column} filter operator` `` | `aria-label` of the operator button of a header filter. |
+| `activeFilters` | `Active filters` | `aria-label` of the `TMDataGrid.FilterPills` group. |
+| `clearFilter` | `` `Clear ${column} filter` `` | `aria-label` of the remove button on a filter pill. |
+| `sortAsc` | `Sort ascending` | Column menu item. |
+| `sortDesc` | `Sort descending` | Column menu item. |
+| `filterMenuItem` | `Filter` | Column menu item. |
+| `groupBy` | `` `Group by ${column}` `` | Column menu item. |
+| `ungroup` | `` `Ungroup ${column}` `` | Column menu item. |
+| `expandAllGroups` | `Expand all groups` | Column menu item. |
+| `collapseAllGroups` | `Collapse all groups` | Column menu item. |
+| `pinLeft` | `Pin to left` | Column menu item. |
+| `pinRight` | `Pin to right` | Column menu item. |
+| `unpin` | `Unpin` | Column menu item. |
+| `moveLeft` | `Move left` | Column menu item. |
+| `moveRight` | `Move right` | Column menu item. |
+| `autosizeColumn` | `Autosize column` | Column menu item. |
+| `hideColumn` | `Hide column` | Column menu item. |
+| `filterOn` | `` `Filter on ${column}` `` | `aria-label` of the header filter button, of a header filter cell, and of the value control in it. |
+| `sortColumn` | `` `Sort ${column}` `` | `aria-label` of the header sort button. |
+| `columnMenu` | `` `${column} column menu` `` | `aria-label` of the column menu trigger. |
+| `rowsPerPage` | `Rows per page:` | `TMDataGrid.Footer`: the text before the page size select. |
+| `pageRange` | `` `${from}–${to} of ${total}` `` | `TMDataGrid.Footer`: the range of rows on the page. |
+| `pageNumber` | `` `Page ${page} of ${pageCount}` ``, or `` `Page ${page}` `` when `pageCount` is `-1` | `TMDataGrid.Footer`: the page number. |
+| `groupedAllRows` | `` `Grouped · all ${total} rows` `` | `TMDataGrid.Footer`: in place of the range and the page number while the rows are grouped. |
+| `pagingSuspendedHint` | `Paging is off while the rows are grouped, and every row is shown. Ungroup to page again.` | `TMDataGrid.Footer`: tooltip of the pager while the rows are grouped. |
+| `previousPage` | `Previous page` | `TMDataGrid.Footer`: `aria-label` of the previous page button. |
+| `nextPage` | `Next page` | `TMDataGrid.Footer`: `aria-label` of the next page button. |
+| `noResults` | `No rows match your filters` | Body, when the view is empty and a column filter is active (`isFilterActive`) or the quick search is not blank. `meta.noResultsLabel` overrides it. |
+| `loading` | `Loading` | `aria-label` of the body loader, of `TMDataGrid.LoadingIndicator`, and of the edit lane spinner while a row saves. |
+| `editCell` | `` `Edit ${column}` `` | `aria-label` of an open cell editor. |
+| `confirmEdit` | `Save` | `aria-label` of the ✓ button beside a cell editor. |
+| `cancelEdit` | `Cancel` | `aria-label` of the ✕ button beside a cell editor. |
+| `editColumnLabel` | `Edit` | `meta.label` of the generated edit lane. |
+| `editRow` | `Edit row` | Edit lane: tooltip and `aria-label` of the pencil button. |
+| `saveRow` | `Save row` | Edit lane: tooltip and `aria-label` of the ✓ button while a row edit is open. |
+| `cancelRowEdit` | `Cancel edit` | Edit lane: tooltip and `aria-label` of the ✕ button while a row edit is open. |
+| `editRowErrors` | `Fix the marked cells` | Edit lane: tooltip of the save button when field errors block the row and the row has no message of its own. |
+| `saveAllEdits` | `"Save 1 row"` when `rows` is 1, else `` `Save ${rows} rows` `` | `TMDataGrid.DraftActions`: the save button. |
+| `discardAllEdits` | `Discard` | `TMDataGrid.DraftActions`: the discard button. |
+| `editRowsStillOpen` | `"1 row still being edited"` when `rows` is 1, else `` `${rows} rows still being edited` `` | `TMDataGrid.DraftActions`: the note shown while rows are still open in an edit. |
+| `confirmNewRow` | `Add row` | Edit lane: tooltip and `aria-label` of the ✓ button on the entry row. |
+| `discardNewRow` | `Discard new row` | Edit lane: tooltip and `aria-label` of the ✕ button on the entry row. |
+| `deleteRow` | `Delete row` | Edit lane: tooltip and `aria-label` of the trash button. |
+| `restoreRow` | `Restore row` | Edit lane: tooltip and `aria-label` of the undo button on a row marked for deletion. |
+| `revertRow` | `Revert changes` | Edit lane: tooltip and `aria-label` of the undo button on a row with a draft. |
+| `rowStateNew` | `New row` | Edit lane: the row-state marker of a confirmed entry row. |
+| `rowStateEdited` | `Edited row` | Edit lane: the row-state marker of a row with a draft. |
+| `rowStateDeleted` | `Marked for deletion` | Edit lane: the row-state marker of a row marked for deletion. |
+| `cellCount` | `"1 cell"` when `count` is 1, else `` `${count} cells` `` | Cell-selection context menu: its heading. |
+| `copy` | `Copy` | Cell-selection context menu item. |
+| `exportCells` | `Export cells` | Cell-selection context menu item. |
+| `includeHeaders` | `Include headers` | Cell-selection context menu: the checkbox. |
+| `exportAll` | `Export all rows` | `TMDataGrid.Menu.Export`. Its `label` prop wins. |
+| `exportSelected` | `"Export 1 selected row"` when `count` is 1, else `` `Export ${count} selected rows` `` | `TMDataGrid.Menu.ExportSelected`. Its `label` prop wins. |
+| `exportPickerTitle` | `` `Export as ${format}` `` | Export column picker: the title. `format` is the file extension in upper case. |
+| `exportPickerHint` | `"Select the columns to export"` when `selected` is `null`, `"Select the columns to export for the selected row"` when it is 1, else `` `Select the columns to export for the ${selected} selected rows` `` | Export column picker: the line under the title. |
+| `exportPickerConfirm` | `Export` | Export column picker: the confirm button. |
+| `exportPickerCancel` | `Cancel` | Export column picker: the cancel button. |
+| `exportPickerSelectAll` | `Select all` | Export column picker: the select-all checkbox over the list. |
+| `exportPickerCount` | `` `${checked} of ${total}` `` | Export column picker: the count beside the select-all checkbox. |
+| `exportPickerHidden` | `Hidden` | Export column picker: the mark on a column the grid hides. |
+| `selectColumnLabel` | `Checkbox selection` | `meta.label` of the generated checkbox lane. |
+| `selectAllRows` | `Select all rows` | `aria-label` of the header checkbox. |
+| `selectRow` | `Select row` | `aria-label` of a row checkbox. |
+| `selectGroup` | `Select group` | `aria-label` of a group row checkbox. |
+| `detailsColumnLabel` | `Details` | `meta.label` of the generated details lane. |
+| `showDetails` | `Show details` | `aria-label` of a collapsed row's details toggle. |
+| `hideDetails` | `Hide details` | `aria-label` of an expanded row's details toggle. |
+| `expandAllDetails` | `Expand all details` | `aria-label` of the details lane's header toggle while some row is collapsed. |
+| `collapseAllDetails` | `Collapse all details` | `aria-label` of the details lane's header toggle while every row is expanded. |
+| `groupColumnLabel` | `Group` | `meta.label` of the generated tree lane, and its header text while nothing is grouped. |
+| `blankGroupValue` | `(Blank)` | Group row text for an empty group key. |
+| `expandGroup` | `` `Expand ${label}` `` | `aria-label` of a collapsed group row's toggle. |
+| `collapseGroup` | `` `Collapse ${label}` `` | `aria-label` of an expanded group row's toggle. |

package/skills/cell-selection/SKILL.md

@@ -14,7 +14,7 @@ description: >
 metadata:
   type: core
   library: '@jielga/tmdatagrid'
-  library_version: '2.1.3'
+  library_version: '2.2.0'
 sources:
   - 'Jielga/react:packages/tmdatagrid/docs/cell-selection.md'
   - 'Jielga/react:packages/tmdatagrid/src/core/cellNavigation.ts'
@@ -215,7 +215,7 @@ Source: `packages/tmdatagrid/docs/cell-selection.md` (Copy and export).
 | --- | --- | --- | --- | --- |
 | `cellSelection` | Option | `TMDataGridCellSelectionMode`: `"none" \| "single" \| "range"` | `"none"`, or `"single"` under `editing` | Turns the cursor, and the rectangle, on. |
 | `onFocusedCellChange` | Callback | `(cell \| null) => void` | – | Follows the cursor. |
-| `exportOptions` | Option | `TMDataGridExportOptions` | `DEFAULT_EXPORT_OPTIONS` | Format, file name and header row of the Export cells item. |
+| `exportOptions` | Option | `TMDataGridExportOptions` | `csvExcelFormat()`, `"export"`, headers on, `"visible"` columns | Format, file name and header row of the Export cells item. |
 | `ui.state.focusedCell` | UI state | `{ rowId, columnId } \| null` | `null` | The cursor. |
 | `ui.state.cellRange` | UI state | `{ anchor, focus } \| null` | `null` | The rectangle's two corners. |
 | `ui.actions.setFocusedCell` · `setCellRange` | UI actions | – | – | Move either from your own code. |

package/skills/columns/SKILL.md

@@ -2,7 +2,7 @@
 name: columns
 description: >
   Define and arrange TMDataGrid columns. Covers createTMDataGridColumnHelper,
-  every column meta field (label, type, options, flex, align, autoSize,
+  every column meta field (label, type, options, flex, align, colSpan, autoSize,
   enableOrdering, and the meta.filter and meta.edit namespaces holding
   operators, defaultOperator, control, enabled, field, editor, validate and
   mapValue), the six column types, fluid minmax sizing versus fixed width with
@@ -16,7 +16,7 @@ description: >
 metadata:
   type: core
   library: '@jielga/tmdatagrid'
-  library_version: '2.1.3'
+  library_version: '2.2.0'
 sources:
   - 'Jielga/react:packages/tmdatagrid/docs/columns.md'
   - 'Jielga/react:packages/tmdatagrid/docs/column-layout.md'
@@ -84,6 +84,7 @@ columnHelper.group({
 | `options` | `TMDataGridOptionsSource` | – | Choices for a `select` / `multiSelect` column: an array, `"faceted"`, or a function. One declaration feeds the filter panel and the editor. |
 | `flex` | `number` | `1` | Share of the remaining width. |
 | `align` | `"left" \| "right" \| "center"` | `"left"` | Applied to both header and cells. |
+| `colSpan` | `number \| ({ row, table }) => number` | `1` | Columns the cell covers on a row, counting itself; the covered cells do not render there. See below. |
 | `autoSize` | `boolean` | `false` | Size to the widest mounted content once, after the first rows render. |
 | `enableOrdering` | `boolean` | `true` | `false` keeps the column where it is. |
 | `filter` | `TMDataGridColumnFilterOptions` | – | How this column filters. See below. |
@@ -117,6 +118,11 @@ annotation. A column written without the helper keeps the untyped row,
 TanStack defines no column option for. `meta.edit` only acts once `editing` is
 set: see the `editing` skill. `meta.filter` belongs to the `filtering` skill.
 
+`colSpan` (args `TMDataGridColSpanArgs`, `{ row, table }`) is display only, never
+covers a generated lane or leaves its pinned block, and is ignored on group rows,
+on rows in row edit mode, and on a row whose open cell editor a span would cover.
+Source: `packages/tmdatagrid/docs/columns.md` (Spanning columns).
+
 ### Column types
 
 `meta.type` is one of `"string"`, `"number"`, `"boolean"`, `"date"`,
@@ -163,10 +169,11 @@ Columns are fluid. Each track is `minmax(minSize, flex fr)`.
 
 | Option | Effect |
 | --- | --- |
-| `minSize` | Minimum width, and the column's contribution to the grid minimum width. Defaults to `80`. |
+| `minSize` | Minimum width, and the column's contribution to the grid minimum width. Also the floor of a resize and of a pinned width. Defaults to `80`, through `defaultColumn.minSize`. |
+| `maxSize` | Ceiling of a resize, an autosize and a pinned width. Does not cap a fluid track. No default. |
 | `meta.flex` | Share of the remaining width. Defaults to `1`. |
 | `minSize === maxSize` | Fixed width. The column is never fluid. |
-| `size` | Applied once the column becomes fixed by resizing or pinning. |
+| `size` | Width of a column pinned at mount, clamped by `minSize` and `maxSize`. Ignored on a fluid column; a resize or an interactive pin stores the rendered width instead. Defaults to `150`. |
 
 ```tsx
 // Fixed 64px action column that never flexes.
@@ -191,21 +198,23 @@ consumer code.
 
 All three write state that persists together, so a grid comes back arranged the
 way it was left. `resetSettings()` from the hook clears visibility, order,
-pinning and widths in one go, and the column chooser offers it as **Reset
-layout**.
+pinning, widths and grouping in one go, and the column chooser offers it as
+**Reset layout**.
 
 **Hiding** is `columnVisibility`, driven by "Hide column" in a column menu and by
-the column chooser: `TMDataGrid.Menu.Columns` in the grid menu, **Manage
-columns** as a submenu of every column menu, and `TMDataGrid.ColumnsPanel` as
-plain controls for a host that is not a menu. See the `appearance` skill.
+the column chooser, which comes in three forms (see the `appearance` skill):
+
+- `TMDataGrid.Menu.Columns` in the grid menu.
+- **Manage columns**, a submenu of every column menu.
+- `TMDataGrid.ColumnsPanel`, plain controls for a host that is not a menu.
 
 **Pinning** is "Pin to left" / "Pin to right" in the column menu. A pinned
 column also becomes fixed-width: sticky offsets are computed from `getSize()`,
 which cannot resolve an `fr` value, so the grid stores the rendered width in
 `columnSizing` at the moment it is pinned and nothing jumps. A column pinned
 from `initialState.columnPinning` has no rendered width to store, so it takes
-its `size` - TanStack's default of `150` where none is set - and `minSize`
-does not apply.
+its `size` - TanStack's default of `150` where none is set - clamped by
+`minSize` and `maxSize`.
 
 **Ordering** is header dragging plus "Move left" / "Move right". A column can
 only move **within its own pinned region** - pinning splits the grid into left,
@@ -253,24 +262,18 @@ const grid = useTMDataGrid({
 ```
 
 `sortFn` on a column takes any registered name or a
-`(rowA, rowB, columnId) => number` function - v9's name for what v8 called
-`sortingFn`, and a rename an agent will reproduce wrongly from memory. Sorting writes
+`(rowA, rowB, columnId) => number` function. `sortFn` is v9's name for v8's
+`sortingFn`. Sorting writes
 TanStack's `sorting` state, an array of `{ id, desc }` in priority order. It is
 a **data** slice, persisted under `dataKey`, while the column layout below is a
 settings slice under `settingsKey`.
 
 ## Column-level feature options
 
-Standard TanStack column options. Each also removes the corresponding interface.
-
-| Option | Effect when `false` |
-| --- | --- |
-| `enableSorting` | No sort indicator, no sort menu items, no click-to-sort. |
-| `enableColumnFilter` | No filter menu item. Excluded from the filter panel's column list, and its header filter cell is empty. |
-| `enableHiding` | No hide menu item. Checkbox disabled in the column manager. |
-| `enablePinning` | No pin menu items. |
-| `enableResizing` | The divider is displayed but cannot be dragged. |
-| `enableGrouping` | No "Group by" menu item. |
+Standard TanStack column options, each removing its interface when `false`:
+`enableSorting`, `enableMultiSort`, `enableColumnFilter`, `enableHiding`,
+`enablePinning`, `enableResizing` and `enableGrouping`. What each one removes is
+in [references/columns-api.md](references/columns-api.md#column-level-feature-options).
 
 `meta.enableOrdering: false` belongs to the same set. A column whose menu has no
 remaining items renders no menu button and takes no right-click, so the
@@ -294,16 +297,17 @@ columns and edit.
 They are structural: fixed width, no column menu, and they cannot be sorted,
 filtered, resized, re-pinned or moved. The checkbox lane anchors the left pinned
 region, so no column can be placed in front of it. `isControlColumn(columnId)`
-identifies them.
+identifies them. To locate a lane in a test, use the constant with
+`data-column-id`; see the `testing` skill.
 
 ## Common mistakes
 
 ### CRITICAL Setting `size` to control width
 
-`size` is only applied once the column becomes fixed by resizing or pinning. On
-a fluid column it is ignored - the track is `minmax(minSize, flex fr)` - so a
-column given `size: 200` renders at whatever the flex share works out to, and
-the number looks like it did nothing.
+`size` applies only to a column pinned at mount. On a fluid column it is
+ignored - the track is `minmax(minSize, flex fr)` - so a column given
+`size: 200` renders at whatever the flex share works out to. A resize or an
+interactive pin stores the rendered width, not `size`.
 
 Wrong:
 
@@ -322,29 +326,28 @@ columnHelper.accessor("email", {
 });
 ```
 
-The corollary is that a pinned column is fixed-width and does use `size`, so a
-column that is pinned needs one.
+A column pinned at mount is fixed-width and does use `size`, so give it one.
 
 Source: `packages/tmdatagrid/docs/column-layout.md` (Sizing).
 
-### HIGH Pinning a column at mount without size
+### HIGH Pinning a column at mount without a width
 
 A column pinned interactively keeps the width it was rendering, which the grid
 writes into `columnSizing`. A column pinned from `initialState.columnPinning`
-has no rendered width, so it takes `size` - TanStack's default of `150` where
-none is set - and `minSize` does not apply.
+has no rendered width, so it takes `size` clamped by `minSize` / `maxSize`:
+TanStack's `150` when none is set, whatever the content needs.
 
 Wrong:
 
 ```tsx
-columnHelper.accessor("name", { header: "Name", minSize: 220 });
+columnHelper.accessor("name", { header: "Name" });
 initialState: { columnPinning: { start: ["name"], end: [] } },
 ```
 
 Correct:
 
 ```tsx
-columnHelper.accessor("name", { header: "Name", minSize: 220, size: 220 });
+columnHelper.accessor("name", { header: "Name", size: 220 });
 initialState: { columnPinning: { start: ["name"], end: [] } },
 ```
 
@@ -399,8 +402,7 @@ Source: `packages/tmdatagrid/src/core/columnUtils.ts`.
 
 `getColumnType(column)` defaults to `"string"`, so a numeric column that omits
 `meta: { type: "number" }` offers only the string operators, and comparisons run
-as text - `"9"` above `"10"`. The column still sorts and filters, which is why
-it is easy to miss.
+as text - `"9"` above `"10"`. The column still sorts and filters.
 
 Source: `packages/tmdatagrid/src/core/filterOperators.ts`.
 
@@ -421,10 +423,9 @@ Source: `packages/tmdatagrid/docs/column-layout.md` (Regions).
 
 ### HIGH Reaching for the v8 name of a v9 option
 
-TanStack v9 renamed the column comparator to `sortFn`. `sortingFn` is not an
-error the compiler catches in every position - it is simply an unknown key on
-the column definition, so the column keeps its automatic comparator and the
-custom ordering never appears.
+TanStack v9 renamed the column comparator to `sortFn`. `sortingFn` is an
+unknown key in v9; TypeScript does not always report it, and the column keeps
+its automatic comparator, so the custom ordering never appears.
 
 Wrong:
 

package/skills/columns/references/columns-api.md

@@ -22,6 +22,20 @@ Reference for the `columns` skill.
 | `validate` | `TMDataGridFieldValidate` | – | Field-level validation. A bare schema means `onChange`. |
 | `mapValue` | `TMDataGridEditValueMap` | – | Maps each value an editor writes, on every keystroke. |
 
+## Column-level feature options
+
+Standard TanStack column options. Each also removes the corresponding interface.
+
+| Option | Effect when `false` |
+| --- | --- |
+| `enableSorting` | No sort indicator, no sort menu items, no click-to-sort. |
+| `enableMultiSort` | Shift+click on this header replaces the sort instead of adding to it. |
+| `enableColumnFilter` | No filter menu item. Excluded from the filter panel's column list, and its header filter cell is empty. |
+| `enableHiding` | No hide menu item. Checkbox disabled in the column manager. |
+| `enablePinning` | No pin menu items. |
+| `enableResizing` | The divider is displayed but cannot be dragged. |
+| `enableGrouping` | No "Group by" menu item. |
+
 ## Exports and options
 
 | Name | Kind | Type | Default | What it does |
@@ -34,7 +48,7 @@ Reference for the `columns` skill.
 | `TMDataGridOptionsArgs` | Type | `{ table, column, row? }` | – | What a `meta.options` function receives. `row` is absent when the filter panel asks. |
 | `resolveColumnOptions` | Export | `({ table, column, row?, fallback? }) => Array<TMDataGridOption>` | – | Normalises all three `meta.options` forms. Empty when the column declares none. |
 | `optionsToComboboxData` | Export | `(options) => ComboboxData` | – | Options as Mantine `Select` / `MultiSelect` data, groups folded in. |
-| `minSize` / `maxSize` / `size` | Column options | `number` | `80` / – / – | Width bounds, and the fixed width once one applies. |
+| `minSize` / `maxSize` / `size` | Column options | `number` | `80` / – / `150` | Floor of the fluid track, a resize and a pinned width; ceiling of a resize and a pinned width; width of a column pinned at mount. |
 | `enableSorting` · `enableColumnFilter` · `enableHiding` · `enablePinning` · `enableResizing` · `enableGrouping` | Column options | `boolean` | `true` | Per-column switches, each removing its interface. |
 | `enableColumnOrdering` | Option | `boolean` | `true` | Header dragging and the move menu items. Grid-defined. |
 | `enableMultiSort` · `maxMultiSortColCount` · `isMultiSortEvent` | Table options | – | Shift held | Multi-column sorting. |