@digital-finance-ui/ui-kit-mcp 0.2.6 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
- "generatedAt": "2026-10-12T12:13:47.490Z",
3
- "libVersion": "1.23.0",
2
+ "generatedAt": "2026-10-19T08:52:42.376Z",
3
+ "libVersion": "1.24.0",
4
4
  "components": {
5
5
  "Accordion": {
6
6
  "name": "Accordion",
@@ -27426,10 +27426,10 @@
27426
27426
  },
27427
27427
  {
27428
27428
  "exportName": "Usage2",
27429
- "displayName": "Использование в TableCanvas.summaryRows.stories.tsx",
27429
+ "displayName": "Использование в TableCanvas.multipleFeatures.stories.tsx",
27430
27430
  "type": "usage",
27431
- "code": "<TableCanvas\n key={tableKey}\n tableConfig={{\n containerStyle: { height: '600px' },\n summaryRows: {\n showDefault,\n showInControl: true,\n onChange: handleSummaryRowsChange,\n domMetadata: {\n dataAttributes: { 'data-testid': TEST_ID.switch },\n },\n },\n sidebarConfig: {\n defaultTabs: [\n {\n id: 'tableSettings',\n domMetadata: {\n dataAttributes: { 'data-testid': TEST_ID.settingsTab },\n },\n },\n ],\n },\n }}\n columnConfig={columnConfig}\n bottomSummaryRows={bottomSummaryRowsData}\n rows={rows}\n />",
27432
- "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.SummaryRows/TableCanvas.summaryRows.stories.tsx"
27431
+ "code": "<TableCanvas\n key={debugBounds ? 'debug-bounds' : 'plain'}\n tableConfig={{\n editing: {\n onRowsChange: setRows,\n rowKeyGetter: (r) => `${r.id}`,\n },\n containerStyle: { height: '80vh' },\n unstickyHeader,\n fullScreenEnabled: true,\n resizableColumn: true,\n loadingOverlay: {\n active: isVisibleLoadingOverlay,\n showSubtitleDelay: 5000,\n subtitle:\n 'Данные обрабатываются, обычно это занимает не более 10 секунд',\n },\n rowSize: {\n default: 'big',\n showInControl: true,\n },\n cellsSelection: { mode: selectionMode },\n highlightActiveType,\n searching: {\n enabled: true,\n debounceDelay: 400,\n },\n keyText: {\n showInControl: true,\n controlBlock: {},\n sidebar: {},\n },\n summaryRows: {\n showDefault: true,\n showInControl: true,\n },\n columnsControl: {\n enable: true,\n hiding: true,\n pinning: true,\n reorderingAside: true,\n reorderingHeader: true,\n disableHiding: ['id'],\n disablePinning: ['developer'],\n columnsLabel: {\n task: 'Задачи',\n },\n pinnedDefault: ['id'],\n },\n rowMarkers: {\n startIndex: 1,\n },\n sidebarConfig: {\n customTabs: [\n {\n id: 'customInfo',\n label: 'Информация',\n icon: <IconInfo size=\"s\" />,\n content: <CustomInfoTab />,\n title: 'Информация',\n showInSidebar: true,\n },\n ],\n },\n controlBlock: {\n show: controlBlock,\n rightSideInner: [\n {\n text: 'Label',\n contentLeft: <IconSb color=\"inherit\" />,\n view: 'linkAccent',\n 'data-test-id': 'Label right 1',\n },\n {\n text: 'Скачать',\n contentLeft: <IconSb color=\"inherit\" />,\n// … (обрезано)",
27432
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.MultipleFeatures/TableCanvas.multipleFeatures.stories.tsx"
27433
27433
  }
27434
27434
  ]
27435
27435
  },
@@ -27476,6 +27476,12 @@
27476
27476
  "required": false,
27477
27477
  "description": "Controls which directions fill is allowed in."
27478
27478
  },
27479
+ {
27480
+ "name": "appearance",
27481
+ "type": "AppearanceConfig | undefined",
27482
+ "required": false,
27483
+ "description": "Внешний вид: «чистый» вариант и зебра. См. {@link AppearanceConfig}."
27484
+ },
27479
27485
  {
27480
27486
  "name": "cellActivationBehavior",
27481
27487
  "type": "CellActivationBehavior | undefined",
@@ -28825,6 +28831,12 @@
28825
28831
  "required": true,
28826
28832
  "description": ""
28827
28833
  },
28834
+ {
28835
+ "name": "appearance",
28836
+ "type": "AppearanceConfig | undefined",
28837
+ "required": false,
28838
+ "description": "Внешний вид: «чистый» вариант и зебра. См. {@link AppearanceConfig}."
28839
+ },
28828
28840
  {
28829
28841
  "name": "cellsSelectionMode",
28830
28842
  "type": "CellsSelectionMode | undefined",
@@ -31203,6 +31215,12 @@
31203
31215
  "required": false,
31204
31216
  "description": "Локальный слой внутри canvas-root; рекомендуется использовать zIndex >= 0.\nЗначение суммируется по цепочке родителей и не является DOM z-index."
31205
31217
  },
31218
+ {
31219
+ "name": "minWidthByContent",
31220
+ "type": "boolean | undefined",
31221
+ "required": false,
31222
+ "description": "Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\nостаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n\nПодробнее: при измерении текст выставляет себе minContentWidth, равный\nширине первого видимого символа с многоточием. Работает только для\nоднострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\nостальных случаях minContentWidth не заполняется. Явный style.minWidth\nважнее. По умолчанию выключено."
31223
+ },
31206
31224
  {
31207
31225
  "name": "bottom",
31208
31226
  "type": "PositionValue | undefined",
@@ -31477,6 +31495,12 @@
31477
31495
  "required": false,
31478
31496
  "description": "Локальный слой внутри canvas-root; рекомендуется использовать zIndex >= 0.\nЗначение суммируется по цепочке родителей и не является DOM z-index."
31479
31497
  },
31498
+ {
31499
+ "name": "minWidthByContent",
31500
+ "type": "boolean | undefined",
31501
+ "required": false,
31502
+ "description": "Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\nостаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n\nПодробнее: при измерении текст выставляет себе minContentWidth, равный\nширине первого видимого символа с многоточием. Работает только для\nоднострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\nостальных случаях minContentWidth не заполняется. Явный style.minWidth\nважнее. По умолчанию выключено."
31503
+ },
31480
31504
  {
31481
31505
  "name": "bottom",
31482
31506
  "type": "PositionValue | undefined",
@@ -48910,11 +48934,11 @@
48910
48934
  "legacy": false,
48911
48935
  "summary": "Текстовый элемент для canvas-ячеек `TableCanvas` с поддержкой ellipsis и многострочного clamp.",
48912
48936
  "docs": "# Canvas.Text\n\nТекстовый элемент для canvas-ячеек `TableCanvas` с поддержкой ellipsis и многострочного clamp.\n\n## Ключевые особенности\n\n- Однострочный ellipsis через `overflow=\"hidden\"` + `textOverflow=\"ellipsis\"`\n- Многострочный clamp через `wordWrap` + `maxLines`\n- Clip без маркера: `textOverflow=\"clip\"`\n- Кастомный маркер обрезки через `ellipsis` (по умолчанию `…`)\n- Авто-тултип с полным текстом при обрезке через `autoTooltip`\n\n## Однострочный ellipsis\n\n```tsx\n<Canvas.Text overflow=\"hidden\" textOverflow=\"ellipsis\" style={{ flexGrow: 1 }}>\n Очень длинный текст\n</Canvas.Text>\n```\n\n## Многострочный clamp\n\n```tsx\n<Canvas.Text\n wordWrap\n maxLines={2}\n overflow=\"hidden\"\n textOverflow=\"ellipsis\"\n lineHeight={1.2}\n style={{ flexGrow: 1 }}\n>\n Длинный текст на несколько строк\n</Canvas.Text>\n```\n\n`maxLines` работает только при `wordWrap` и `overflow=\"hidden\"`. `maxLines={1}` ведёт себя как однострочный ellipsis.\n\n## Высота строки\n\nДля многострочного текста высота строки таблицы должна оставлять место под нужное количество строк с учётом `lineHeight` и padding.\n\n## Авто-тултип при обрезке (`autoTooltip`)\n\nЕсли текст обрезается в многоточие, `Canvas.Text` может сам показывать тултип с полным текстом — без ручного `portalHoverEnabled` и `tooltip`:\n\n```tsx\n<Canvas.Text overflow=\"hidden\" textOverflow=\"ellipsis\" autoTooltip style={{ flexGrow: 1 }}>\n {row.longText}\n</Canvas.Text>\n```\n\nПравила:\n\n- Тултип показывается **только когда текст реально обрезан в многоточие**. Если текст помещается целиком — тултипа нет.\n- Работает и для многострочного clamp (`wordWrap` + `maxLines`): тултип появляется, когда есть скрытые строки ниже `maxLines`.\n- При `textOverflow=\"clip\"` (обрезка без маркера `…`) тултип не показывается.\n- `autoTooltip` сам делает ноду hover-таргетом (неявно включает `portalHoverEnabled`).\n- Явный проп `tooltip` приоритетнее: если заданы оба — показывается `tooltip` (always-on, без условия обрезки).\n- Обрезанность определяется по фактической ширине ноды после layout, поэтому при ресайзе колонки тултип автоматически появляется/исчезает вместе с многоточием.\n\nКастомизация — объектом (тип `CanvasTextAutoTooltip`):\n\n```tsx\n<Canvas.Text\n overflow=\"hidden\"\n textOverflow=\"ellipsis\"\n autoTooltip={{\n placement: 'top',\n mouseEnterDelay: 300,\n // По умолчанию текст тултипа = полный текст ноды.\n // Строка — заменить, функция — трансформировать, null из функции — не показывать.\n text: (fullText) => `Полностью: ${fullText}`,\n }}\n style={{ flexGrow: 1 }}\n>\n {row.longText}\n</Canvas.Text>\n```\n\n`autoTooltip={{ enabled: false }}` (или `autoTooltip={false}`) выключает авто-тултип. Доступные пропсы оформления — те же, что у обычного node-тултипа: `placement`, `view`, `minWidth`, `maxWidth`, `mouseEnterDelay`, `mouseLeaveDelay`.\n\n> Авто-тултип действует только на `Canvas.Text` внутри canvas-разметки (`renderCell` / `renderHeaderCell`, включая хедеры и групп-хедеры). Обычные текстовые ячейки таблицы (примитивные значения без `renderCell`) рисуются встроенным text-рендерером glide и в этой механике не участвуют.\n\nОбщая механика тултипов таблицы описана в разделе [Tooltip](?path=/docs/локальные-компоненты-tablecanvas-tooltip--docs).\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvastext-api--docs).",
48913
- "apiDocs": "# Canvas.Text API\n\n## CanvasTextOptions\n\n```typescript\ninterface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n}\n```\n\n## CanvasTextAutoTooltip\n\nКонфиг авто-тултипа при обрезке текста (проп `autoTooltip`). `boolean` — включить/выключить с дефолтным поведением (полный текст ноды), объект — кастомизация:\n\n```typescript\ntype CanvasTextAutoTooltip =\n | boolean\n | (CanvasNodeTooltipProps & {\n /** @default true — скрыть можно через false */\n enabled?: boolean;\n /**\n * Переопределение/трансформация текста тултипа. По умолчанию — собственный\n * текст ноды. Вернуть `null` — не показывать.\n */\n text?: string | ((fullText: string) => string | null);\n mouseEnterDelay?: number;\n mouseLeaveDelay?: number;\n });\n```",
48937
+ "apiDocs": "# Canvas.Text API\n\n## CanvasTextOptions\n\n```typescript\ninterface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n /**\n * Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\n * остаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n *\n * Подробнее: при измерении текст выставляет себе minContentWidth, равный\n * ширине первого видимого символа с многоточием. Работает только для\n * однострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\n * остальных случаях minContentWidth не заполняется. Явный style.minWidth\n * важнее. По умолчанию выключено.\n */\n minWidthByContent?: boolean;\n}\n```\n\n## CanvasTextAutoTooltip\n\nКонфиг авто-тултипа при обрезке текста (проп `autoTooltip`). `boolean` — включить/выключить с дефолтным поведением (полный текст ноды), объект — кастомизация:\n\n```typescript\ntype CanvasTextAutoTooltip =\n | boolean\n | (CanvasNodeTooltipProps & {\n /** @default true — скрыть можно через false */\n enabled?: boolean;\n /**\n * Переопределение/трансформация текста тултипа. По умолчанию — собственный\n * текст ноды. Вернуть `null` — не показывать.\n */\n text?: string | ((fullText: string) => string | null);\n mouseEnterDelay?: number;\n mouseLeaveDelay?: number;\n });\n```",
48914
48938
  "api": [
48915
48939
  {
48916
48940
  "typeName": "CanvasTextOptions",
48917
- "source": "interface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n}"
48941
+ "source": "interface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n /**\n * Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\n * остаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n *\n * Подробнее: при измерении текст выставляет себе minContentWidth, равный\n * ширине первого видимого символа с многоточием. Работает только для\n * однострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\n * остальных случаях minContentWidth не заполняется. Явный style.minWidth\n * важнее. По умолчанию выключено.\n */\n minWidthByContent?: boolean;\n}"
48918
48942
  },
48919
48943
  {
48920
48944
  "typeName": "CanvasTextAutoTooltip",
@@ -48972,7 +48996,7 @@
48972
48996
  "exportName": "BigDataExample",
48973
48997
  "displayName": "Большой набор данных (строки × колонки)",
48974
48998
  "type": "full-code",
48975
- "code": "() => {\n const [cols, setCols] = useState(1000);\n const [rowInput, setRowInput] = useState('50000');\n const [rowTarget, setRowTarget] = useState(50000);\n const [withMerge, setWithMerge] = useState(true);\n const [heavyCells, setHeavyCells] = useState(true);\n const [withEditing, setWithEditing] = useState(false);\n // Правки пользователя поверх сгенерированных данных (режим редактирования).\n const [editedRows, setEditedRows] = useState<Node[] | null>(null);\n\n const commitsRef = useRef<number[]>([]);\n const onRender = useCallback(\n (_id: string, _phase: string, actualDuration: number) => {\n commitsRef.current.push(actualDuration);\n },\n [],\n );\n\n const { rows: builtRows, leaves } = useMemo(\n () => buildData(rowTarget, withMerge),\n [rowTarget, withMerge],\n );\n\n useEffect(() => {\n setEditedRows(null);\n }, [builtRows]);\n\n const dataRows = editedRows ?? builtRows;\n\n const columns = useMemo(\n () => buildColumns(cols, heavyCells, withEditing),\n [cols, heavyCells, withEditing],\n );\n\n const tableConfig = useMemo(\n () => ({\n containerStyle: { height: '70vh' },\n rowMarkers: { startIndex: 1 },\n resizableColumn: true,\n columnsControl: {\n enable: true,\n pinning: true,\n },\n ...(withMerge\n ? {\n subRows: {\n getSubRows: (row: Node) => row?.subRows,\n rowKeyGetter: (row: Node) => row.id,\n view: 'merged' as const,\n mergedColumns: ['division', 'unit', 'team'],\n },\n }\n : {}),\n ...(withEditing\n ? {\n editing: {\n onRowsChange: (next: Node[]) => setEditedRows(next),\n rowKeyGetter: (r: Node) => r.id,\n },\n }\n : {}),\n }),\n [withMerge, withEditing],\n );\n\n return (\n <div>\n <StoryHint>\n Пример на большом наборе данных: настройте число колонок и строк,\n включите нужные режимы и проверяйте выделение, скролл, сайдбар и\n редактирование. HUD справа показывает метрики производительности: FPS\n — кадров в секунду (ниже 40 подсвечивается красным); «коммитов/с» —\n сколько раз в секунду React перерендерил таблицу (при протяжке\n выделения каждый шаг мыши даёт один коммит); «коммит сред/макс» —\n среднее и максимальное время одного такого перерендера в\n миллисекундах, то есть цена реакции таблицы на одно действие.\n </StoryHint>\n\n <div\n style={{\n display: 'flex',\n gap: 24,\n alignItems: 'center',\n flexWrap: 'wrap',\n padding: '8px 4px 12px',\n fontSize: 13,\n }}\n >\n <span style={{ display: 'flex', gap: 8, alignItems: 'center' }}>\n Колонок: <b style={{ minWidth: 42 }}>{cols}</b>\n <div style={{ width: 220 }}>\n <Slider\n value={cols}\n min={1}\n max={1500}\n onChangeCommitted={(value) => setCols(value)}\n />\n </div>\n </span>\n\n <span style={{ display: 'flex', gap: 8, alignItems: 'center' }}>\n Строк:\n <div style={{ width: 130 }}>\n <TextField\n value={rowInput}\n type=\"number\"\n size=\"s\"\n onChange={(e) => setRowInput(e.target.value)}\n />\n </div>\n <Button\n size=\"s\"\n view=\"secondary\"\n onClick={() => setRowTarget(Math.max(1, Number(rowInput) || 1))}\n >\n Построить\n </Button>\n <span style={{ opacity: 0.75 }}>\n (листьев: <b>{fmt(leaves)}</b>)\n </span>\n </span>\n\n <Checkbox\n label=\"объединение (subRows merged)\"\n checked={withMerge}\n onChange={(e) => setWithMerge(e.target.checked)}\n />\n\n <Checkbox\n label=\"тяжёлые ячейки (Canvas.Badge)\"\n checked={heavyCells}\n onChange={(e) => setHeavyCells(e.target.checked)}\n />\n\n <Checkbox\n label=\"редактирование (error-ячейки)\"\n checked={withEditing}\n onChange={(e) => setWithEditing(e.target.checked)}\n />\n\n <PerfHudBadge commitsRef={commitsRef} />\n </div>\n\n <Profiler id=\"big-data-table\" onRender={onRender}>\n <TableCanvas\n tableConfig={tableConfig}\n columnConfig={columns}\n rows={dataRows as Node[]}\n />\n </Profiler>\n </div>\n );\n }"
48999
+ "code": "() => {\n const [cols, setCols] = useState(1000);\n const [rowInput, setRowInput] = useState('50000');\n const [rowTarget, setRowTarget] = useState(50000);\n const [withMerge, setWithMerge] = useState(true);\n const [heavyCells, setHeavyCells] = useState(true);\n const [withEditing, setWithEditing] = useState(false);\n const [withHeaderButtons, setWithHeaderButtons] = useState(false);\n const filteringStateAndSetter = useState(CLEARED_FILTERS);\n const sortingStateAndSetter = useState<readonly SortColumn[]>([]);\n // Правки пользователя поверх сгенерированных данных (режим редактирования).\n const [editedRows, setEditedRows] = useState<Node[] | null>(null);\n\n const commitsRef = useRef<number[]>([]);\n const onRender = useCallback(\n (_id: string, _phase: string, actualDuration: number) => {\n commitsRef.current.push(actualDuration);\n },\n [],\n );\n\n const { rows: builtRows, leaves } = useMemo(\n () => buildData(rowTarget, withMerge),\n [rowTarget, withMerge],\n );\n\n useEffect(() => {\n setEditedRows(null);\n }, [builtRows]);\n\n const dataRows = editedRows ?? builtRows;\n\n const columns = useMemo(\n () => buildColumns(cols, heavyCells, withEditing, withHeaderButtons),\n [cols, heavyCells, withEditing, withHeaderButtons],\n );\n\n const tableConfig = useMemo(\n () => ({\n containerStyle: { height: '70vh' },\n rowMarkers: { startIndex: 1 },\n resizableColumn: true,\n columnsControl: {\n enable: true,\n pinning: true,\n },\n ...(withMerge\n ? {\n subRows: {\n getSubRows: (row: Node) => row?.subRows,\n rowKeyGetter: (row: Node) => row.id,\n view: 'merged' as const,\n mergedColumns: ['division', 'unit', 'team'],\n },\n }\n : {}),\n ...(withEditing\n ? {\n editing: {\n onRowsChange: (next: Node[]) => setEditedRows(next),\n rowKeyGetter: (r: Node) => r.id,\n },\n }\n : {}),\n ...(withHeaderButtons\n ? {\n sorting: { state: sortingStateAndSetter },\n filtering: {\n state: filteringStateAndSetter,\n clearedValue: CLEARED_FILTERS,\n },\n }\n : {}),\n }),\n [\n withMerge,\n withEditing,\n withHeaderButtons,\n sortingStateAndSetter,\n filteringStateAndSetter,\n ],\n );\n\n return (\n <div>\n <StoryHint>\n Пример на большом наборе данных: настройте число колонок и строк,\n включите нужные режимы и проверяйте выделение, скролл, сайдбар и\n редактирование. HUD справа показывает метрики производительности: FPS\n — кадров в секунду (ниже 40 подсвечивается красным); «коммитов/с» —\n сколько раз в секунду React перерендерил таблицу (при протяжке\n выделения каждый шаг мыши даёт один коммит); «коммит сред/макс» —\n среднее и максимальное время одного такого перерендера в\n миллисекундах, то есть цена реакции таблицы на одно действие.\n </StoryHint>\n\n <div\n style={{\n display: 'flex',\n gap: 24,\n alignItems: 'center',\n flexWrap: 'wrap',\n padding: '8px 4px 12px',\n fontSize: 13,\n }}\n >\n <span style={{ display: 'flex', gap: 8, alignItems: 'center' }}>\n Колонок: <b style={{ minWidth: 42 }}>{cols}</b>\n <div style={{ width: 220 }}>\n <Slider\n value={cols}\n min={1}\n max={1500}\n onChangeCommitted={(value) => setCols(value)}\n />\n </div>\n </span>\n\n <span style={{ display: 'flex', gap: 8, alignItems: 'center' }}>\n Строк:\n <div style={{ width: 130 }}>\n <TextField\n value={rowInput}\n type=\"number\"\n size=\"s\"\n onChange={(e) => setRowInput(e.target.value)}\n />\n </div>\n <Button\n size=\"s\"\n view=\"secondary\"\n onClick={() => setRowTarget(Math.max(1, Number(rowInput) || 1))}\n >\n Построить\n </Button>\n <span style={{ opacity: 0.75 }}>\n (листьев: <b>{fmt(leaves)}</b>)\n </span>\n </span>\n\n <Checkbox\n label=\"объединение (subRows merged)\"\n checked={withMerge}\n onChange={(e) => setWithMerge(e.target.checked)}\n />\n\n <Checkbox\n label=\"тяжёлые ячейки (Canvas.Badge)\"\n checked={heavyCells}\n onChange={(e) => setHeavyCells(e.target.checked)}\n />\n\n <Checkbox\n label=\"редактирование (error-ячейки)\"\n checked={withEditing}\n onChange={(e) => setWithEditing(e.target.checked)}\n />\n\n <Checkbox\n label=\"сортировка и фильтр в шапке\"\n checked={withHeaderButtons}\n onChange={(e) => setWithHeaderButtons(e.target.checked)}\n />\n\n <PerfHudBadge commitsRef={commitsRef} />\n </div>\n\n <Profiler id=\"big-data-table\" onRender={onRender}>\n <TableCanvas\n tableConfig={tableConfig}\n columnConfig={columns}\n rows={dataRows as Node[]}\n />\n </Profiler>\n </div>\n );\n }"
48976
49000
  },
48977
49001
  {
48978
49002
  "exportName": "RowSpanBasic",
@@ -49047,7 +49071,7 @@
49047
49071
  "feature": "ColumnResize",
49048
49072
  "legacy": false,
49049
49073
  "summary": "Ограничения ширины колонок. Задаются на уровне колонки (`columnConfig`) или глобально в `tableConfig`.",
49050
- "docs": "# Column Resize (minWidth / maxWidth / maxAutoWidth)\n\nОграничения ширины колонок. Задаются на уровне колонки (`columnConfig`) или глобально в `tableConfig`.\n\n## Быстрый старт\n\n```tsx\nconst columnConfig: ColumnConfig<Row>[] = [\n {\n key: 'name',\n name: 'Название',\n width: 250,\n minWidth: 150,\n maxWidth: 400,\n },\n {\n key: 'description',\n name: 'Описание',\n maxAutoWidth: 500,\n },\n];\n```\n\n## Поля колонки\n\n### minWidth\n\nМинимальная ширина колонки (px). Колонка не может стать уже этого значения — ни при ресайзе мышкой, ни при автоматическом расчёте ширины.\n\nЕсли не задан — берётся глобальный `minColumnWidth` из `tableConfig`.\n\n### maxWidth\n\nМаксимальная ширина колонки (px). **Жёсткий потолок** — ограничивает всё: и автоматический расчёт ширины, и ручной ресайз мышкой. Колонка никогда не станет шире `maxWidth`.\n\nЕсли не задан — берётся глобальный `maxColumnWidth` из `tableConfig`.\n\n### maxAutoWidth\n\nМаксимальная ширина колонки при **автоматическом расчёте** (px). **Мягкий потолок** — колонка стремится не превышать это значение при автоматическом распределении ширин, но **пользователь может растянуть её шире** вручную.\n\nЕсли не задан — берётся глобальный `maxColumnAutoWidth` из `tableConfig`.\n\n#### Отличие maxAutoWidth от maxWidth\n\n- `maxWidth` — жёсткий потолок. Ограничивает и автоматическую ширину, и ручной ресайз.\n- `maxAutoWidth` — мягкий потолок. Ограничивает только автоматическую ширину. Ручной ресайз не ограничен.\n\nЕсли заданы оба — при автоматическом расчёте берётся **меньшее** из двух значений. При ручном ресайзе действует только `maxWidth`.\n\n## Начальная ширина\n\nЕсли у колонки задан `width`, она рендерится с этой шириной (клампится в диапазон `minWidth`..`maxWidth`).\n\nЕсли `width` не задан — начальная ширина вычисляется автоматически. Колонки без фиксированной ширины заполняют свободное место в контейнере. При этом `maxAutoWidth` ограничивает, насколько широко колонка может автоматически растянуться.\n\n## Глобальные ограничения\n\nВ `tableConfig` можно задать ограничения по умолчанию для всех колонок:\n\n```tsx\n<TableCanvas\n tableConfig={{\n minColumnWidth: 80,\n maxColumnWidth: 600,\n maxColumnAutoWidth: 400,\n }}\n columnConfig={columnConfig}\n rows={rows}\n/>\n```\n\nЕсли у конкретной колонки задано своё значение (`minWidth`, `maxWidth`, `maxAutoWidth`), оно перебивает глобальное.\n\n## Приоритеты\n\n- Колоночные значения (`minWidth`, `maxWidth`, `maxAutoWidth`) приоритетнее глобальных из `tableConfig`\n- Если `minWidth` больше `maxWidth`, приоритет у `minWidth`\n- `maxAutoWidth` не влияет на ручной ресайз — пользователь всегда может растянуть колонку шире\n\nПолная типизация колонок: [columnConfig API](?path=/docs/локальные-компоненты-tablecanvas-api-columnconfig--docs).",
49074
+ "docs": "# Column Resize (minWidth / maxWidth / maxAutoWidth)\n\nОграничения ширины колонок. Задаются на уровне колонки (`columnConfig`) или глобально в `tableConfig`.\n\n## Быстрый старт\n\n```tsx\nconst columnConfig: ColumnConfig<Row>[] = [\n {\n key: 'name',\n name: 'Название',\n width: 250,\n minWidth: 150,\n maxWidth: 400,\n },\n {\n key: 'description',\n name: 'Описание',\n maxAutoWidth: 500,\n },\n];\n```\n\n## Поля колонки\n\n### minWidth\n\nМинимальная ширина колонки (px). Колонка не может стать уже этого значения — ни при ресайзе мышкой, ни при автоматическом расчёте ширины.\n\nУ каждой колонки есть ещё минимум по содержимому шапки, он считается автоматически и ниже него колонку сжать нельзя даже с меньшим `minWidth`. Подробнее в разделе «Минимум по содержимому шапки».\n\n### maxWidth\n\nМаксимальная ширина колонки (px). **Жёсткий потолок** — ограничивает всё: и автоматический расчёт ширины, и ручной ресайз мышкой. Колонка никогда не станет шире `maxWidth`.\n\nЕсли не задан — берётся глобальный `maxColumnWidth` из `tableConfig`.\n\n### maxAutoWidth\n\nМаксимальная ширина колонки при **автоматическом расчёте** (px). **Мягкий потолок** — колонка стремится не превышать это значение при автоматическом распределении ширин, но **пользователь может растянуть её шире** вручную.\n\nЕсли не задан — берётся глобальный `maxColumnAutoWidth` из `tableConfig`.\n\n#### Отличие maxAutoWidth от maxWidth\n\n- `maxWidth` — жёсткий потолок. Ограничивает и автоматическую ширину, и ручной ресайз.\n- `maxAutoWidth` — мягкий потолок. Ограничивает только автоматическую ширину. Ручной ресайз не ограничен.\n\nЕсли заданы оба — при автоматическом расчёте берётся **меньшее** из двух значений. При ручном ресайзе действует только `maxWidth`.\n\n## Начальная ширина\n\nЕсли у колонки задан `width`, она рендерится с этой шириной (клампится в диапазон `minWidth`..`maxWidth`).\n\nЕсли `width` не задан — начальная ширина вычисляется автоматически. Колонки без фиксированной ширины заполняют свободное место в контейнере. При этом `maxAutoWidth` ограничивает, насколько широко колонка может автоматически растянуться.\n\n## Минимум по содержимому шапки\n\nШапка колонки должна оставаться читаемой при любой ширине, поэтому таблица сама считает нижнюю границу ширины колонки. В неё входят:\n\n- отступы ячейки слева и справа по размеру строки (`rowSize`);\n- иконки слева от названия: пин закреплённой колонки, иконка перетаскивания за шапку, кнопка «раскрыть все» у колонки с подстроками;\n- место под одну букву названия с многоточием;\n- кнопки справа от названия: фильтр и сортировка, если они есть у колонки. Кнопки появляются при наведении, но место под них учитывается всегда, иначе при наведении они не поместились бы.\n\nПоэтому колонка с фильтром и сортировкой не сожмётся так же узко, как колонка без них, а на большой строке минимум выше, чем на малой. Свой `minWidth` колонки может только поднять эту границу: значение меньше автоматического минимума не действует. Фиксированный `width` меньше минимума тоже поднимается до него.\n\nЕсли название колонки всё же не помещается, оно сжимается до первой буквы с многоточием, а полное название показывается в тултипе.\n\n## Глобальные ограничения\n\nВ `tableConfig` можно задать ограничения по умолчанию для всех колонок:\n\n```tsx\n<TableCanvas\n tableConfig={{\n minColumnWidth: 80,\n maxColumnWidth: 600,\n maxColumnAutoWidth: 400,\n }}\n columnConfig={columnConfig}\n rows={rows}\n/>\n```\n\nЕсли у конкретной колонки задано своё значение (`minWidth`, `maxWidth`, `maxAutoWidth`), оно перебивает глобальное.\n\nГлобальный `minColumnWidth` на колонки с данными сейчас не действует: у каждой такой колонки минимум всегда считается по содержимому шапки, и он приоритетнее. Параметр влияет только на служебные колонки.\n\n## Приоритеты\n\n- Колоночные значения (`minWidth`, `maxWidth`, `maxAutoWidth`) приоритетнее глобальных из `tableConfig`\n- `minWidth` не может быть ниже автоматического минимума по содержимому шапки\n- Если `minWidth` больше `maxWidth`, приоритет у `minWidth`\n- `maxAutoWidth` не влияет на ручной ресайз — пользователь всегда может растянуть колонку шире\n\nПолная типизация колонок: [columnConfig API](?path=/docs/локальные-компоненты-tablecanvas-api-columnconfig--docs).",
49051
49075
  "apiDocs": "",
49052
49076
  "api": [],
49053
49077
  "stories": [
@@ -49116,12 +49140,12 @@
49116
49140
  "feature": "ColumnsControl",
49117
49141
  "legacy": false,
49118
49142
  "summary": "*tableConfig.columnsControl**",
49119
- "docs": "# ColumnsControl (TableCanvas)\n\n**tableConfig.columnsControl**\n\nНастройка колонок таблицы: скрытие, закрепление, изменение порядка (через Aside-панель и drag в header).\n\n## Ключевые особенности\n\n- Активация через `enable: true` — включает все подфичи по умолчанию\n- Скрытие колонок через свитчи в Aside (`hiding`)\n- Закрепление колонок (`pinning`)\n- Перетаскивание колонок в Aside (`reorderingAside`) и через header (`reorderingHeader`)\n- Дефолтные состояния при первом рендере (`pinnedDefault`, `hiddenDefault`, `orderDefault`)\n- Переопределение названий колонок в Aside (`columnsLabel`)\n- Колбэк при применении настроек (`onConfirm`)\n- Синий индикатор скрытых столбцов в шапке (`hiddenColumnsIndicator`)\n\n## Подфичи\n\nКаждая подфича по умолчанию наследует значение `enable`. Можно отключить отдельно:\n\n- **`hiding`** — скрытие/показ колонок через свитчи. `disableHiding` исключает конкретные колонки\n- **`pinning`** — закрепление колонок слева. `disablePinning` исключает конкретные колонки\n- **`reorderingAside`** — drag-and-drop порядка колонок в Aside-панели\n- **`reorderingHeader`** — drag-and-drop заголовков колонок прямо в таблице. `onReorderingHeader` — callback с новым порядком\n\n## Дефолтные состояния\n\n- **`pinnedDefault`** — массив ключей колонок, закреплённых при первом рендере\n- **`hiddenDefault`** — массив ключей скрытых колонок при первом рендере\n- **`orderDefault`** — массив ключей, определяющий начальный порядок колонок\n\n## onConfirm\n\nCallback вызывается при нажатии «Применить» в Aside. Получает текущее состояние (`pinned`, `order`, `hidden`, `changed`) и сеттеры для программного управления состоянием.\n\n## Индикатор скрытых столбцов (hiddenColumnsIndicator)\n\nКогда между двумя видимыми колонками спрятаны столбцы, на границе в шапке вместо обычного бордера рисуется толстая синяя полосатая линия. Так пользователь видит, что тут есть скрытый промежуток, и может быстро его раскрыть.\n\n- Фича **нативная**: включается сама вместе с `hiding`. Отдельно управляется флагом `hiddenColumnsIndicator` (по умолчанию `true` при активном `hiding`). Отключается `hiddenColumnsIndicator: false`.\n- **Одна полоса на весь промежуток**: сколько бы столбцов ни было скрыто подряд, линия одна. Двойной клик раскрывает сразу весь промежуток.\n- **Наведение** на линию показывает тултип «Дважды нажмите, чтобы развернуть».\n- **Ресайз** соседней колонки за эту же границу работает как обычно (тянем перетаскиванием), меняется только двойной клик: он раскрывает промежуток вместо автосайза. Если полоса высокая, тянуть за ресайз можно по всей её высоте, а не только в листовом ряду.\n- **Края таблицы**: если скрыт первый или последний столбец, линия прижимается к левому или правому краю.\n- **Сгруппированная шапка**: фича относится только к колонкам, сами группы не скрываются, а высота полосы подстраивается под то, что скрыто. Если спрятаны только листья внутри групп, полоса низкая (в листовом ряду). Если среди скрытых есть большая колонка верхнего уровня, полоса тянется вверх на всю высоту шапки. Высоту дополнительно ограничивает общая группа видимых соседей: пока они под одной группой, полоса не поднимается выше её низа.\n\n### onHiddenColumnsIndicatorExpand\n\nКолбэк-уведомление о раскрытии промежутка двойным кликом. Само раскрытие (снятие скрытия) делает обёртка; колбэк нужен, чтобы продукт мог подписаться на это событие. В него приходит объект с полями: `keys` (ключи раскрываемых столбцов), `leftKey` и `rightKey` (видимые соседи слева и справа от линии, `undefined` на краю таблицы).\n\nСрабатывает **только** на двойной клик по линии индикатора. Обычное изменение видимости через панель настройки колонок (Aside) или контекстное меню продукта его не вызывает: для этих сценариев есть общий стейт скрытых колонок и `onConfirm`.\n\nПримеры: стори «ColumnsControl: индикатор скрытых столбцов» и рядом (по бокам, выключен, в группе, в скваш-колонках).\n\n## Меню закрепления в контрл-блоке (pinningMenu)\n\nКогда включено `pinning`, в правой зоне иконок контрл-блока автоматически появляется нативная кнопка-иконка (пин + шеврон) — быстрый доступ к закреплению выбранных колонок, дополняющий Aside-панель. Задаётся через `controlBlock.pinningMenu`.\n\n- Фича **нативная**: появляется сама при активном `pinning`, отдельно включать не нужно. Отключается `controlBlock.pinningMenu.enable: false`.\n- **Размеры** завязаны на размер контрл-блока (`controlBlock.size`) — в компактном (`xs`) ужимается вместе с остальными иконками.\n- Участвует в **компрессии**: при нехватке места уезжает в overflow-меню `…` вложенным подменю.\n\nПункты меню:\n\n- **Стандартные (из коробки):** «Открепить всё» и «Закрепить столбцы».\n- **Свои пункты** — через `pinningMenu.items` (напр. «Закрепить строки», «Закрепить шапку»). Порядок задаётся `order` (у нативных: `Открепить всё` = 100, `Закрепить столбцы` = 200), разделитель после пункта — `dividerAfter`. Совпадение `value` с нативным = переопределение.\n- Состояние и иконку продуктовых пунктов **контролирует продукт** (иконка — `ReactNode` или функция от `rowSize`, может отражать состояние).\n\nЛевая иконка (кнопка-действие):\n\n- Синеет, когда среди **видимых** колонок есть хотя бы одна закреплённая (скрыли видимость закреплённой — снова обычный цвет).\n- Tooltip и действие зависят от выделения: нет выделения — подсказка выбрать колонки; выбраны незакреплённые — «Закрепить»; выбраны только закреплённые — «Открепить».\n- После закрепления выделение **переезжает** за колонками (закреплённые уезжают влево), соседние сливаются без разделителей.\n- Клик по действию закрепления **без выделенных колонок** шлёт событие в `tableConfig.notifications` (`type: 'pin'`, `code: 'no-selection'`) — продукт показывает свою подсказку. Подробнее — в разделе [Notifications](?path=/docs/локальные-компоненты-tablecanvas-notifications--docs).\n\nПример добавления своих пунктов — в стори «ColumnsControl: доп. пункты меню закрепления».\n\n> Подробнее о типах и пропсах — [ColumnsControl API](?path=/docs/локальные-компоненты-tablecanvas-columnscontrol-api--docs)",
49120
- "apiDocs": "# ColumnsControl API\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```\n\n## HiddenColumnsIndicatorExpandInfo\n\nДанные, которые приходят в колбэк `onHiddenColumnsIndicatorExpand` при раскрытии промежутка двойным кликом по индикатору скрытых столбцов.\n\n```typescript\ntype HiddenColumnsIndicatorExpandInfo = {\n /** Ключи скрытых столбцов, которые раскрываются (весь промежуток за линией). */\n keys: string[];\n /** Видимый сосед слева от линии. undefined, если линия у левого края таблицы. */\n leftKey?: string;\n /** Видимый сосед справа от линии. undefined, если линия у правого края таблицы. */\n rightKey?: string;\n};\n```\n\n## PinningMenuConfig\n\nМеню закрепления в контрл-блоке (`controlBlock.pinningMenu`). Появляется, когда включено `columnsControl.pinning`.\n\n```typescript\ntype PinningMenuConfig = {\n /**\n * Явное вкл/выкл фичи.\n * @default columnsControl.pinning\n */\n enable?: boolean;\n /**\n * Продуктовые пункты меню — мёржатся с нативными (override по value,\n * сортировка по order).\n */\n items?: PinningMenuItem[];\n /**\n * DomMetadata левой кнопки-иконки закрепления. Её `dataAttributes`\n * навешиваются на кнопку-иконку (data-атрибуты для e2e-тестов, аналитики и\n * онбординга — поиск элемента в DOM). Пример:\n * `{ dataAttributes: { 'data-testid': 'pinning-icon' } }`.\n */\n iconDomMetadata?: DomMetadata;\n};\n```\n\n## PinningMenuItem\n\nПункт меню закрепления — нативный или добавленный продуктом.\n\n```typescript\ntype PinningMenuItem = {\n /**\n * Уникальный ключ пункта. Совпадение с value нативного пункта = override\n * (продуктовые поля перекрывают нативные).\n */\n value: string;\n label: string;\n /**\n * Иконка слева в пункте. Узел рендерится как есть, либо функция (ctx),\n * чтобы подстроить размер под rowSize (в т.ч. внутри overflow-дропдауна\n * при компрессии). Стейт/иконку продуктовых пунктов контролирует продукт.\n */\n icon?: FeatureIconRender;\n /**\n * Действие пункта. У нативных пунктов задаётся таблицей; продукт может\n * переопределить.\n */\n onClick?: () => void;\n /**\n * Порядок в списке (по возрастанию). Нативные: reset=100, pin-columns=200.\n * Пункты без order идут в конец, сохраняя исходный порядок.\n */\n order?: number;\n /**\n * Нарисовать разделитель после пункта.\n * @default false\n */\n dividerAfter?: boolean;\n disabled?: boolean;\n};\n```",
49143
+ "docs": "# ColumnsControl (TableCanvas)\n\n**tableConfig.columnsControl**\n\nНастройка колонок таблицы: скрытие, закрепление, изменение порядка (через Aside-панель и drag в header).\n\n## Ключевые особенности\n\n- Активация через `enable: true` — включает все подфичи по умолчанию\n- Скрытие колонок через свитчи в Aside (`hiding`)\n- Закрепление колонок (`pinning`)\n- Перетаскивание колонок в Aside (`reorderingAside`) и через header (`reorderingHeader`)\n- Дефолтные состояния при первом рендере (`pinnedDefault`, `hiddenDefault`, `orderDefault`)\n- Переопределение названий колонок в Aside (`columnsLabel`)\n- Колбэк при применении настроек (`onConfirm`)\n- Синий индикатор скрытых столбцов в шапке (`hiddenColumnsIndicator`)\n\n## Подфичи\n\nКаждая подфича по умолчанию наследует значение `enable`. Можно отключить отдельно:\n\n- **`hiding`** — скрытие/показ колонок через свитчи. `disableHiding` исключает конкретные колонки\n- **`pinning`** — закрепление колонок слева. `disablePinning` исключает конкретные колонки\n- **`reorderingAside`** — drag-and-drop порядка колонок в Aside-панели\n- **`reorderingHeader`** — drag-and-drop заголовков колонок прямо в таблице. `onReorderingHeader` — callback с новым порядком\n\n## Дефолтные состояния\n\n- **`pinnedDefault`** — массив ключей колонок, закреплённых при первом рендере\n- **`hiddenDefault`** — массив ключей скрытых колонок при первом рендере\n- **`orderDefault`** — массив ключей, определяющий начальный порядок колонок\n\n## onConfirm\n\nCallback вызывается при нажатии «Применить» в Aside. Получает текущее состояние (`pinned`, `order`, `hidden`, `changed`) и сеттеры для программного управления состоянием.\n\n## Режим применения (applyMode)\n\n- **`confirm`** (по умолчанию) — панель копит изменения локально, внизу кнопки «Отменить» и «Применить». В таблицу и в `onConfirm` изменения уходят только по кнопке «Применить».\n- **`instant`** — кнопок нет. Каждое действие в панели (свитч видимости, пин, перенос, «открепить все», «сбросить порядок», «включить все столбцы») сразу меняет таблицу. `onConfirm` вызывается после каждого такого действия с тем же контрактом, что и по кнопке, поэтому существующие подписчики продолжают работать без изменений. Поле `changed` описывает разницу с предыдущим применённым состоянием. Изменения, сделанные вне панели (пин в шапке, перенос заголовка, раскрытие скрытых столбцов), `onConfirm` не вызывают, как и раньше.\n\nПример — стори «Мгновенное применение».\n\n## Индикатор скрытых столбцов (hiddenColumnsIndicator)\n\nКогда между двумя видимыми колонками спрятаны столбцы, на границе в шапке вместо обычного бордера рисуется толстая синяя полосатая линия. Так пользователь видит, что тут есть скрытый промежуток, и может быстро его раскрыть.\n\n- Фича **нативная**: включается сама вместе с `hiding`. Отдельно управляется флагом `hiddenColumnsIndicator` (по умолчанию `true` при активном `hiding`). Отключается `hiddenColumnsIndicator: false`.\n- **Одна полоса на весь промежуток**: сколько бы столбцов ни было скрыто подряд, линия одна. Двойной клик раскрывает сразу весь промежуток.\n- **Наведение** на линию показывает тултип «Дважды нажмите, чтобы развернуть».\n- **Ресайз** соседней колонки за эту же границу работает как обычно (тянем перетаскиванием), меняется только двойной клик: он раскрывает промежуток вместо автосайза. Если полоса высокая, тянуть за ресайз можно по всей её высоте, а не только в листовом ряду.\n- **Края таблицы**: если скрыт первый или последний столбец, линия прижимается к левому или правому краю.\n- **Сгруппированная шапка**: фича относится только к колонкам, сами группы не скрываются, а высота полосы подстраивается под то, что скрыто. Если спрятаны только листья внутри групп, полоса низкая (в листовом ряду). Если среди скрытых есть большая колонка верхнего уровня, полоса тянется вверх на всю высоту шапки. Высоту дополнительно ограничивает общая группа видимых соседей: пока они под одной группой, полоса не поднимается выше её низа.\n\n### onHiddenColumnsIndicatorExpand\n\nКолбэк-уведомление о раскрытии промежутка двойным кликом. Само раскрытие (снятие скрытия) делает обёртка; колбэк нужен, чтобы продукт мог подписаться на это событие. В него приходит объект с полями: `keys` (ключи раскрываемых столбцов), `leftKey` и `rightKey` (видимые соседи слева и справа от линии, `undefined` на краю таблицы).\n\nСрабатывает **только** на двойной клик по линии индикатора. Обычное изменение видимости через панель настройки колонок (Aside) или контекстное меню продукта его не вызывает: для этих сценариев есть общий стейт скрытых колонок и `onConfirm`.\n\nПримеры: стори «ColumnsControl: индикатор скрытых столбцов» и рядом (по бокам, выключен, в группе, в скваш-колонках).\n\n## Меню закрепления в контрл-блоке (pinningMenu)\n\nКогда включено `pinning`, в правой зоне иконок контрл-блока автоматически появляется нативная кнопка-иконка (пин + шеврон) — быстрый доступ к закреплению выбранных колонок, дополняющий Aside-панель. Задаётся через `controlBlock.pinningMenu`.\n\n- Фича **нативная**: появляется сама при активном `pinning`, отдельно включать не нужно. Отключается `controlBlock.pinningMenu.enable: false`.\n- **Размеры** завязаны на размер контрл-блока (`controlBlock.size`) — в компактном (`xs`) ужимается вместе с остальными иконками.\n- Участвует в **компрессии**: при нехватке места уезжает в overflow-меню `…` вложенным подменю.\n\nПункты меню:\n\n- **Стандартные (из коробки):** «Открепить всё» и «Закрепить столбцы».\n- **Свои пункты** — через `pinningMenu.items` (напр. «Закрепить строки», «Закрепить шапку»). Порядок задаётся `order` (у нативных: `Открепить всё` = 100, `Закрепить столбцы` = 200), разделитель после пункта — `dividerAfter`. Совпадение `value` с нативным = переопределение.\n- Состояние и иконку продуктовых пунктов **контролирует продукт** (иконка — `ReactNode` или функция от `rowSize`, может отражать состояние).\n\nЛевая иконка (кнопка-действие):\n\n- Синеет, когда среди **видимых** колонок есть хотя бы одна закреплённая (скрыли видимость закреплённой — снова обычный цвет).\n- Tooltip и действие зависят от выделения: нет выделения — подсказка выбрать колонки; выбраны незакреплённые — «Закрепить»; выбраны только закреплённые — «Открепить».\n- После закрепления выделение **переезжает** за колонками (закреплённые уезжают влево), соседние сливаются без разделителей.\n- Клик по действию закрепления **без выделенных колонок** шлёт событие в `tableConfig.notifications` (`type: 'pin'`, `code: 'no-selection'`) — продукт показывает свою подсказку. Подробнее — в разделе [Notifications](?path=/docs/локальные-компоненты-tablecanvas-notifications--docs).\n\nПример добавления своих пунктов — в стори «ColumnsControl: доп. пункты меню закрепления».\n\n> Подробнее о типах и пропсах — [ColumnsControl API](?path=/docs/локальные-компоненты-tablecanvas-columnscontrol-api--docs)",
49144
+ "apiDocs": "# ColumnsControl API\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```\n\n## HiddenColumnsIndicatorExpandInfo\n\nДанные, которые приходят в колбэк `onHiddenColumnsIndicatorExpand` при раскрытии промежутка двойным кликом по индикатору скрытых столбцов.\n\n```typescript\ntype HiddenColumnsIndicatorExpandInfo = {\n /** Ключи скрытых столбцов, которые раскрываются (весь промежуток за линией). */\n keys: string[];\n /** Видимый сосед слева от линии. undefined, если линия у левого края таблицы. */\n leftKey?: string;\n /** Видимый сосед справа от линии. undefined, если линия у правого края таблицы. */\n rightKey?: string;\n};\n```\n\n## PinningMenuConfig\n\nМеню закрепления в контрл-блоке (`controlBlock.pinningMenu`). Появляется, когда включено `columnsControl.pinning`.\n\n```typescript\ntype PinningMenuConfig = {\n /**\n * Явное вкл/выкл фичи.\n * @default columnsControl.pinning\n */\n enable?: boolean;\n /**\n * Продуктовые пункты меню — мёржатся с нативными (override по value,\n * сортировка по order).\n */\n items?: PinningMenuItem[];\n /**\n * DomMetadata левой кнопки-иконки закрепления. Её `dataAttributes`\n * навешиваются на кнопку-иконку (data-атрибуты для e2e-тестов, аналитики и\n * онбординга — поиск элемента в DOM). Пример:\n * `{ dataAttributes: { 'data-testid': 'pinning-icon' } }`.\n */\n iconDomMetadata?: DomMetadata;\n};\n```\n\n## PinningMenuItem\n\nПункт меню закрепления — нативный или добавленный продуктом.\n\n```typescript\ntype PinningMenuItem = {\n /**\n * Уникальный ключ пункта. Совпадение с value нативного пункта = override\n * (продуктовые поля перекрывают нативные).\n */\n value: string;\n label: string;\n /**\n * Иконка слева в пункте. Узел рендерится как есть, либо функция (ctx),\n * чтобы подстроить размер под rowSize (в т.ч. внутри overflow-дропдауна\n * при компрессии). Стейт/иконку продуктовых пунктов контролирует продукт.\n */\n icon?: FeatureIconRender;\n /**\n * Действие пункта. У нативных пунктов задаётся таблицей; продукт может\n * переопределить.\n */\n onClick?: () => void;\n /**\n * Порядок в списке (по возрастанию). Нативные: reset=100, pin-columns=200.\n * Пункты без order идут в конец, сохраняя исходный порядок.\n */\n order?: number;\n /**\n * Нарисовать разделитель после пункта.\n * @default false\n */\n dividerAfter?: boolean;\n disabled?: boolean;\n};\n```",
49121
49145
  "api": [
49122
49146
  {
49123
49147
  "typeName": "ColumnsControlConfig",
49124
- "source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
49148
+ "source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
49125
49149
  },
49126
49150
  {
49127
49151
  "typeName": "HiddenColumnsIndicatorExpandInfo",
@@ -49143,6 +49167,12 @@
49143
49167
  "type": "full-code",
49144
49168
  "code": "import { ColumnConfig, TableCanvas } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n {\n key: 'id',\n name: 'ID',\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n renderCell(cellInfo) {\n return (\n <Canvas.Button\n id=\"header-tooltip-drag\"\n portalHoverEnabled\n onClick={() => {}}\n >\n 123\n </Canvas.Button>\n );\n },\n },\n {\n key: 'task',\n name: 'Title',\n },\n {\n key: 'priority',\n name: 'Priority',\n },\n {\n key: 'issueType',\n name: 'Issue Type',\n },\n {\n key: 'developer',\n name: 'Developer',\n },\n {\n key: 'tr1',\n name: 'TR',\n },\n {\n key: 'complete',\n name: '% Complete',\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 700 },\n columnsControl: {\n enable: true,\n hiding: true,\n disableHiding: ['id'],\n pinning: true,\n disablePinning: ['developer'],\n reorderingAside: true,\n reorderingHeader: true,\n columnsLabel: {\n task: 'Задачи',\n },\n orderDefault: ['id', 'issueType', 'task'],\n hiddenDefault: ['tr1'],\n pinnedDefault: ['complete'],\n onConfirm: ({ order, hidden, pinned }, _setters) => {\n // eslint-disable-next-line no-alert\n alert(`\n order: ${order.join(', ')}\n pinned: ${pinned.join(', ')}\n hidden: ${hidden.join(', ')}\n `);\n },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
49145
49169
  },
49170
+ {
49171
+ "exportName": "ColumnsControlInstantApply",
49172
+ "displayName": "ID",
49173
+ "type": "full-code",
49174
+ "code": "import { ColumnConfig, TableCanvas } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n const [confirmLog, setConfirmLog] = useState<string[]>([]);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n { key: 'id', name: 'ID' },\n { key: 'task', name: 'Title' },\n { key: 'priority', name: 'Priority' },\n { key: 'issueType', name: 'Issue Type' },\n { key: 'developer', name: 'Developer' },\n { key: 'tr1', name: 'TR' },\n { key: 'complete', name: '% Complete' },\n ],\n [],\n );\n\n return (\n <Box $css={{ display: 'flex', flexDirection: 'column', gap: '8px' }}>\n <Box\n data-testid=\"confirm-log\"\n $css={{\n height: '96px',\n overflowY: 'auto',\n padding: '8px 12px',\n borderRadius: '8px',\n backgroundColor: surfaceTransparentPrimary,\n fontSize: '12px',\n lineHeight: '18px',\n fontFamily: 'monospace',\n whiteSpace: 'pre',\n }}\n >\n {confirmLog.length\n ? confirmLog.join('\\n')\n : 'Вызовы onConfirm: откройте настройки колонок и измените что-нибудь'}\n </Box>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 600 },\n columnsControl: {\n enable: true,\n applyMode: 'instant',\n disableHiding: ['id'],\n disablePinning: ['developer'],\n hiddenDefault: ['tr1'],\n pinnedDefault: ['complete'],\n onConfirm: ({ order, hidden, pinned, changed }) => {\n setConfirmLog((prev) => [\n [\n `#${prev.length + 1} изменилось: ${Object.keys(\n changed,\n ).join(', ')}`,\n ` order: ${order.join(', ')}`,\n ` pinned: ${pinned.join(', ')}`,\n ` hidden: ${hidden.join(', ')}`,\n ].join('\\n'),\n ...prev,\n ]);\n },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </Box>\n );\n }"
49175
+ },
49146
49176
  {
49147
49177
  "exportName": "ColumnsControlDynamicColumn",
49148
49178
  "displayName": "ColumnsControl: динамическое добавление колонки",
@@ -49229,7 +49259,7 @@
49229
49259
  "exportName": "Playground",
49230
49260
  "displayName": "Группировка (squash)",
49231
49261
  "type": "full-code",
49232
- "code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n TableCanvas,\n} from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n const [squash, setSquash] = useState(true);\n\n const columnConfig = useMemo<ColumnOrColumnGroupConfig<Row>[]>(\n () => [\n // Одиночная колонка без группы: при squash её шапка тянется вверх.\n { key: 'id', name: 'ID', width: 90, resizable: true },\n // Глубокая группа (3 уровня) для реордера.\n {\n key: 'metrics',\n name: 'Показатели',\n children: [\n {\n key: 'sales',\n name: 'Продажи',\n children: [\n { key: 'task', name: 'План', width: 150, resizable: true },\n { key: 'priority', name: 'Факт', width: 130, resizable: true },\n ],\n },\n {\n key: 'grade',\n name: 'Оценка',\n children: [\n { key: 'issueType', name: 'Инд', width: 120, resizable: true },\n { key: 'developer', name: 'Кол', width: 120, resizable: true },\n { key: 'complete', name: 'Итог', width: 120, resizable: true },\n ],\n },\n ],\n },\n // «Мелкая» группа с кастомным canvas-name: при squash тянется вниз\n // (под шапкой нет подгрупп, иначе была бы пустая полоса).\n {\n key: 'pppp',\n name: (\n <Canvas.Container padding={{ left: 8, right: 8 }}>\n <Canvas.Text\n color={tableCanvasTheme.accentColor}\n font={tableCanvasFonts.bodyXSBold}\n >\n кастомный name\n </Canvas.Text>\n </Canvas.Container>\n ),\n children: [{ key: 'tr', name: 'TR', width: 130, resizable: true }],\n },\n ],\n [],\n );\n\n return (\n <div>\n <div\n style={{\n display: 'flex',\n alignItems: 'center',\n gap: 8,\n marginBottom: 12,\n }}\n >\n <Switch\n checked={squash}\n onChange={(e) => setSquash(e.target.checked)}\n label=\"columnsGrouping.squashEmptyCells\"\n />\n </div>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 340 },\n columnsGrouping: { squashEmptyCells: squash },\n columnsControl: { enable: true },\n resizableColumn: true,\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </div>\n );\n }"
49262
+ "code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n TableCanvas,\n} from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n const [squash, setSquash] = useState(true);\n const filteringStateAndSetter = useState(CLEARED_FILTERS);\n const sortingStateAndSetter = useState<readonly SortColumn[]>([]);\n\n const columnConfig = useMemo<ColumnOrColumnGroupConfig<Row>[]>(\n () => [\n // Одиночная колонка без группы: при squash её шапка тянется вверх.\n {\n key: 'id',\n name: 'ID',\n width: 90,\n resizable: true,\n sortingType: 'numberSort',\n filtering: {\n component: 'input',\n keyInFilterState: 'id',\n valueInRow: (r) => String(r.id),\n filter: 'startWith',\n },\n },\n // Глубокая группа (3 уровня) для реордера.\n {\n key: 'metrics',\n name: 'Показатели',\n children: [\n {\n key: 'sales',\n name: 'Продажи',\n children: [\n { key: 'task', name: 'План', width: 150, resizable: true },\n { key: 'priority', name: 'Факт', width: 130, resizable: true },\n ],\n },\n {\n key: 'grade',\n name: 'Оценка',\n children: [\n { key: 'issueType', name: 'Инд', width: 120, resizable: true },\n { key: 'developer', name: 'Кол', width: 120, resizable: true },\n { key: 'complete', name: 'Итог', width: 120, resizable: true },\n ],\n },\n ],\n },\n // «Мелкая» группа с кастомным canvas-name: при squash тянется вниз\n // (под шапкой нет подгрупп, иначе была бы пустая полоса).\n {\n key: 'pppp',\n name: (\n <Canvas.Container padding={{ left: 8, right: 8 }}>\n <Canvas.Text\n color={tableCanvasTheme.accentColor}\n font={tableCanvasFonts.bodyXSBold}\n >\n кастомный name\n </Canvas.Text>\n </Canvas.Container>\n ),\n children: [\n {\n key: 'tr',\n name: 'TR',\n width: 130,\n resizable: true,\n sortingType: 'stringSort',\n filtering: {\n component: 'input',\n keyInFilterState: 'tr',\n valueInRow: (r) => r.tr,\n filter: 'startWith',\n },\n },\n ],\n },\n ],\n [],\n );\n\n return (\n <div>\n <div\n style={{\n display: 'flex',\n alignItems: 'center',\n gap: 8,\n marginBottom: 12,\n }}\n >\n <Switch\n checked={squash}\n onChange={(e) => setSquash(e.target.checked)}\n label=\"columnsGrouping.squashEmptyCells\"\n />\n </div>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 340 },\n columnsGrouping: { squashEmptyCells: squash },\n columnsControl: { enable: true },\n resizableColumn: true,\n sorting: { state: sortingStateAndSetter },\n filtering: {\n state: filteringStateAndSetter,\n clearedValue: CLEARED_FILTERS,\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </div>\n );\n }"
49233
49263
  },
49234
49264
  {
49235
49265
  "exportName": "HeaderAlign",
@@ -49640,7 +49670,7 @@
49640
49670
  "legacy": false,
49641
49671
  "summary": "*tableConfig.\\*.domMetadata**",
49642
49672
  "docs": "# DomMetadata\n\n**tableConfig.\\*.domMetadata**\n\nМетки для автоматизированного тестирования, аналитики и онбординга.\n\n`DomMetadata` позволяет навешивать CSS-классы, data-атрибуты и обработчики кликов на интерактивные элементы таблицы.\nЭто нужно для:\n\n- **Аналитики** — трекинг кликов по кнопкам таблицы\n- **Автотестов** — поиск элементов по `data-testid`\n- **Онбординга** — привязка подсказок к конкретным элементам\n\n## Поддерживаемые элементы (className, dataAttributes)\n\nСледующие элементы поддерживают `className` и `dataAttributes` через `domMetadata`:\n\n**Control Block (панель управления):**\n\n- **Редактирование** — `tableConfig.editing.domMetadata`\n- **Полноэкранный режим** — `tableConfig.fullScreenEnabled.domMetadata`\n- **Размер строки** — `tableConfig.rowSize.domMetadata`\n- **Переключение вида** (строки/карточки) — `tableConfig.view.domMetadata`\n- **Группировка строк** — `tableConfig.rowsGrouping.domMetadata`\n- **Поиск** — `tableConfig.searching.domMetadata`\n- **Итоговые строки** — `tableConfig.summaryRows.domMetadata`\n- **KeyText** (controlBlock) — `tableConfig.keyText.controlBlock.domMetadata`\n- **KeyText** (sidebar) — `tableConfig.keyText.sidebar.domMetadata`\n\n**Selecting (выбор строк):**\n\n- **Чекбокс \"Выбрать все\"** (controlBlock) — `tableConfig.selecting.controlBlock.domMetadata`\n- **Свитч в сайдбаре** — `tableConfig.selecting.sidebar.domMetadata`\n\n**Sidebar (правая панель):**\n\n- **Табы сайдбара** — `tableConfig.sidebarConfig.defaultTabs[].domMetadata`\n- **Подтабы настроек** (Фильтры, Столбцы) — `tableConfig.sidebarConfig.defaultTabs[{id:'filtering'|'columns'}].domMetadata`\n\n**Другие:**\n\n- **Кнопка сворачивания таблицы** — `tableConfig.collapse.domMetadata`\n\n## Элементы с расширенным onClick (className, dataAttributes, onClick + detail)\n\nВ дополнение к `className` и `dataAttributes`, следующие элементы поддерживают `onClick` с контекстом `detail`:\n\n- **Группировать** (чекбоксы, сброс) — `tableConfig.rowsGrouping.domMetadata` — actions: `toggle-group`, `reset-groups`, `custom-item-select`\n- **Кнопка размера строки** — `tableConfig.rowSize.domMetadata` — action: `change-row-size`\n- **Шестеренка настроек** — `tableConfig.sidebarConfig.defaultTabs[{id:'tableSettings'}].domMetadata` — action: `toggle-sidebar-tab`\n- **Крестик закрыть сайдбар** — тот же `domMetadata` таба — action: `close-sidebar`\n- **Закрепить столбец** — `tableConfig.columnsControl.pinDomMetadata` — actions: `pin-column`, `unpin-column`\n- **Свитчер видимости столбца** — `tableConfig.columnsControl.switchDomMetadata` — actions: `show-column`, `hide-column`\n\n## onClick\n\nОбработчик `onClick` вызывается **после** основной логики элемента. Он не мешает работе кнопки и не вызывает `stopPropagation`.\n\n```tsx\nonClick?: (\n e?: React.MouseEvent<HTMLElement>, // MouseEvent (undefined для элементов внутри Dropdown)\n detail?: Record<string, unknown> // контекст: action, columnKey, size и др.\n) => void;\n```\n\n### Примеры detail\n\n```ts\n// Группировка\n{ action: 'toggle-group', columnKey: 'status' }\n{ action: 'reset-groups' }\n\n// Размер строки\n{ action: 'change-row-size', size: 'medium' }\n\n// Сайдбар\n{ action: 'toggle-sidebar-tab', tabId: 'tableSettings' }\n{ action: 'close-sidebar' }\n\n// Столбцы\n{ action: 'pin-column', columnKey: 'name' }\n{ action: 'unpin-column', columnKey: 'name' }\n{ action: 'hide-column', columnKey: 'name' }\n{ action: 'show-column', columnKey: 'name' }\n```\n\nПодробнее о типах — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-dommetadata-api--docs).",
49643
- "apiDocs": "# DomMetadata API\n\n## DomMetadata\n\n```typescript\ntype DomMetadata = {\n /**\n * CSS класс для стилизации и поиска элемента\n *\n * @example 'user-profile-card'\n * @example 'onboarding-step-1'\n */\n className?: string;\n /**\n * Data-атрибуты для тестирования, аналитики и онбординга\n *\n * @example { 'data-testid': 'submit-button', 'data-analytics': 'click-event' }\n */\n dataAttributes?: DataAttributes;\n /**\n * Обработчик клика для аналитики и трекинга\n *\n * Вызывается вместе с основным обработчиком элемента (не заменяет его).\n * Не вызывает stopPropagation — оригинальная логика кнопки сохраняется.\n *\n * @param e - MouseEvent (может быть undefined для элементов внутри Dropdown)\n * @param detail - контекст действия: action, columnKey, size и др.\n *\n * @example onClick: (e, detail) => analytics.track(detail?.action, detail)\n */\n onClick?: (\n e?: React.MouseEvent<HTMLElement>,\n detail?: Record<string, unknown>,\n ) => void;\n};\n```\n\n## DOM_METADATA_ACTIONS\n\n```typescript\nexport const DOM_METADATA_ACTIONS = {\n /** Включение/выключение группировки по столбцу. detail.columnKey — ключ столбца */\n TOGGLE_GROUP: 'toggle-group',\n /** Сброс всех группировок */\n RESET_GROUPS: 'reset-groups',\n /** Выбор пункта в кастомном onItemSelect группировки. detail.columnKey — ключ */\n CUSTOM_ITEM_SELECT: 'custom-item-select',\n /** Переключение размера строки. detail.size — новый размер ('small' | 'medium' | 'big') */\n CHANGE_ROW_SIZE: 'change-row-size',\n /** Клик по табу сайдбара (шестерёнка и др.). detail.tabId — id таба */\n TOGGLE_SIDEBAR_TAB: 'toggle-sidebar-tab',\n /** Закрытие сайдбара (крестик) */\n CLOSE_SIDEBAR: 'close-sidebar',\n /** Закрепление столбца. detail.columnKey — ключ столбца */\n PIN_COLUMN: 'pin-column',\n /** Открепление столбца. detail.columnKey — ключ столбца */\n UNPIN_COLUMN: 'unpin-column',\n /** Скрытие столбца. detail.columnKey — ключ столбца */\n HIDE_COLUMN: 'hide-column',\n /** Показ столбца. detail.columnKey — ключ столбца */\n SHOW_COLUMN: 'show-column',\n} as const;\n```\n\n## DomMetadataAction\n\n```typescript\ntype DomMetadataAction =\n (typeof DOM_METADATA_ACTIONS)[keyof typeof DOM_METADATA_ACTIONS];\n```\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
49673
+ "apiDocs": "# DomMetadata API\n\n## DomMetadata\n\n```typescript\ntype DomMetadata = {\n /**\n * CSS класс для стилизации и поиска элемента\n *\n * @example 'user-profile-card'\n * @example 'onboarding-step-1'\n */\n className?: string;\n /**\n * Data-атрибуты для тестирования, аналитики и онбординга\n *\n * @example { 'data-testid': 'submit-button', 'data-analytics': 'click-event' }\n */\n dataAttributes?: DataAttributes;\n /**\n * Обработчик клика для аналитики и трекинга\n *\n * Вызывается вместе с основным обработчиком элемента (не заменяет его).\n * Не вызывает stopPropagation — оригинальная логика кнопки сохраняется.\n *\n * @param e - MouseEvent (может быть undefined для элементов внутри Dropdown)\n * @param detail - контекст действия: action, columnKey, size и др.\n *\n * @example onClick: (e, detail) => analytics.track(detail?.action, detail)\n */\n onClick?: (\n e?: React.MouseEvent<HTMLElement>,\n detail?: Record<string, unknown>,\n ) => void;\n};\n```\n\n## DOM_METADATA_ACTIONS\n\n```typescript\nexport const DOM_METADATA_ACTIONS = {\n /** Включение/выключение группировки по столбцу. detail.columnKey — ключ столбца */\n TOGGLE_GROUP: 'toggle-group',\n /** Сброс всех группировок */\n RESET_GROUPS: 'reset-groups',\n /** Выбор пункта в кастомном onItemSelect группировки. detail.columnKey — ключ */\n CUSTOM_ITEM_SELECT: 'custom-item-select',\n /** Переключение размера строки. detail.size — новый размер ('small' | 'medium' | 'big') */\n CHANGE_ROW_SIZE: 'change-row-size',\n /** Клик по табу сайдбара (шестерёнка и др.). detail.tabId — id таба */\n TOGGLE_SIDEBAR_TAB: 'toggle-sidebar-tab',\n /** Закрытие сайдбара (крестик) */\n CLOSE_SIDEBAR: 'close-sidebar',\n /** Закрепление столбца. detail.columnKey — ключ столбца */\n PIN_COLUMN: 'pin-column',\n /** Открепление столбца. detail.columnKey — ключ столбца */\n UNPIN_COLUMN: 'unpin-column',\n /** Скрытие столбца. detail.columnKey — ключ столбца */\n HIDE_COLUMN: 'hide-column',\n /** Показ столбца. detail.columnKey — ключ столбца */\n SHOW_COLUMN: 'show-column',\n} as const;\n```\n\n## DomMetadataAction\n\n```typescript\ntype DomMetadataAction =\n (typeof DOM_METADATA_ACTIONS)[keyof typeof DOM_METADATA_ACTIONS];\n```\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
49644
49674
  "api": [
49645
49675
  {
49646
49676
  "typeName": "DomMetadata",
@@ -49656,7 +49686,7 @@
49656
49686
  },
49657
49687
  {
49658
49688
  "typeName": "ColumnsControlConfig",
49659
- "source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
49689
+ "source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
49660
49690
  }
49661
49691
  ],
49662
49692
  "stories": [
@@ -49836,11 +49866,11 @@
49836
49866
  "legacy": false,
49837
49867
  "summary": "*tableConfig.filtering**",
49838
49868
  "docs": "# Filtering\n\n**tableConfig.filtering**\n\nФильтрация данных таблицы с поддержкой автоматического и ручного режимов.\n\n## Ключевые особенности\n\n- Три типа фильтров: `input`, `select`, `custom`\n- Автоматическая фильтрация по умолчанию, ручная через `manualFiltering: true`\n- Отображение активных фильтров в виде chip-элементов\n- Поддержка фильтрации через sidebar с настройкой порядка и глобальных фильтров\n- Кастомизация chip-стилей и лейблов\n\n## Типы фильтров\n\n### Input\n\nТекстовый фильтр с режимами: `'includes'`, `'startWith'`, `'equal'` или кастомная функция.\n\n### Select\n\nФильтр выбором из списка. Поддержка одиночного (`'single'`) и множественного (`'multiple'`) выбора.\n\n### Custom\n\nПолностью кастомный компонент фильтра через `customRender`.\n\n## Конфигурация FilteringConfig\n\n- **`state`** `[T, setState]` — стейт фильтров (обязательный)\n- **`manualFiltering`** `boolean` — ручная фильтрация (данные не фильтруются таблицей)\n- **`filtersInfo`** `Record<keyof T, { label, clearedValue }>` — метки и дефолтные значения фильтров\n- **`sidebarConfig`** `{ order?, items }` — конфигурация sidebar с фильтрами\n- **`chipStyle`** `(itemOrGroup, item) => CSSObject` — кастомные стили для chip-элементов\n- **`renderGroupLabel`** `(group) => string` — кастомный заголовок группы чипсов\n- **`renderChipLabel`** `(group, item) => string` — кастомный текст чипса\n\n## Кастомизация чипсов\n\n### chipStyle\n\nПозволяет динамически задавать стили для каждого чипа фильтра в зависимости от его типа и содержимого.\n\n### renderGroupLabel\n\nФорматтер заголовка группы чипсов. Полезен для i18n или добавления счётчика выбранных элементов.\n\n### renderChipLabel\n\nФорматтер текста внутри чипса. Полезен при серверной пагинации, когда в стейте хранится только `value`, а `label` подставляется из кэша.\n\n## Особенности\n\n- При `manualFiltering: true` таблица не фильтрует данные — ожидается внешняя логика (серверная)\n- `sidebarConfig` позволяет добавлять глобальные фильтры, не привязанные к колонкам\n- `filtersInfo` задаёт лейблы и значения по умолчанию для каждого фильтра\n\n> Подробнее о типах — [Filtering API](?path=/docs/локальные-компоненты-tablecanvas-filtering-api--docs)",
49839
- "apiDocs": "# Filtering API\n\n## FilteringConfig\n\n```typescript\ntype FilteringConfig<T> = {\n state: [T, React.Dispatch<React.SetStateAction<T>>];\n /**\n * @deprecated Использовать filtersInfo\n *\n * clearedValue - состояние фильтров после очистки. Используется для сравнения:\n * Например, был ли фильтр конкретной колонки изменен рассчитывается посредством сравнения текущего значения фильтра и значения фильтра в clearedValue.\n * Если они равны, то фильтр считается не измененным.\n */\n clearedValue?: T;\n /**\n * Информация о фильтрах для каждой колонки.\n * Используется для:\n * 1. Хранения меток (label) фильтров для отображения в UI\n * 2. Хранения значений по умолчанию (clearedValue) для каждого фильтра\n * 3. Определения, был ли фильтр изменен (сравнение текущего значения с clearedValue)\n */\n filtersInfo?: Record<\n keyof T,\n {\n label: string;\n clearedValue: T[keyof T];\n }\n >;\n /**\n * manualFiltering - пропс, активирующий ручную-кастомную (или на стороне бэка) фильтрацию.\n * @remarks\n * Для автоматической фильтрации (когда не используется manualFiltering в tableConfig):\n * - Для всех типов фильтров обязательно должен быть указан `valueInRow`\n * - Для component: 'select' дополнительно должен быть указан `filteringType`\n * - Для component: 'input' с кастомным фильтром (когда filter - функция)\n * функция фильтрации должна быть передана явно\n *\n * Если используется manualFiltering, эти параметры не обязательны,\n * так как вся логика фильтрации реализуется извне.\n */\n manualFiltering?: boolean;\n /**\n * Конфигурация для отображения фильтров в правом сайдбаре.\n *\n * Позволяет:\n * 1. Добавлять глобальные фильтры (не привязанные к конкретной колонке)\n * 2. Управлять порядком отображения фильтров\n * 3. Переопределять рендер и заголовки колоночных фильтров\n *\n * Логика работы:\n * - По умолчанию в сайдбаре отображаются все колоночные фильтры (из columnConfig)\n * - Ключом фильтра считается `key` колонки, если его нет, то пытаемся взять `keyInFilterState` (если указан), иначе это не будет работать\n * - Заголовком фильтра по умолчанию является `name` колонки или ключ фильтра (name || key)\n * - Глобальные фильтры добавляются через `items` с уникальными ключами\n *\n * Особенности:\n * 1. Порядок отображения:\n * - Сначала фильтры из `order` (в указанной последовательности)\n * - Затем остальные колоночные фильтры (в порядке columnConfig)\n * - В конце - глобальные фильтры (в алфавитном порядке ключей)\n *\n * 2. Переопределение колоночных фильтров:\n * - Чтобы изменить заголовок: укажите ключ колонки в `items` с новым `label`\n * - Чтобы заменить рендер: укажите ключ колонки с `customRenderFn`\n * - Оригинальный фильтр из колонки будет проигнорирован\n *\n * 3. Глобальные фильтры:\n * - Ключ не должен совпадать с ключами колонок\n * - Обязательно указать `label` и `customRenderFn`\n * - Отображаются после всех колоночных фильтров, если не переопределены в order\n *\n * @example\n * // Добавление глобального фильтра и изменение порядка\n * sidebarConfig: {\n * order: ['status', 'tasks', 'type'], // Сначала статус, затем глобальный поиск\n * items: {\n * tasks: { // Уникальный ключ\n * label: 'Поиск по всем полям',\n * customRenderFn: () => <TaskComponent />\n * },\n * status: { // Переопределение колоночного фильтра\n * label: 'Статус заявки', // Новый заголовок\n * customRenderFn: () => <CustomStatusFilter /> // Кастомный рендер\n * }\n * type: { // Переопределение только Label колоночного фильтра\n * label: 'Тип', // Новый заголовок\n * }\n * }\n * }\n */\n sidebarConfig?: {\n /**\n * Определяет порядок отображения фильтров.\n * - Указываются ключи фильтров (колоночных или глобальных)\n * - Не указанные в order фильтры отображаются после\n * - Если order пуст, сохраняется порядок: глобальные фильтры + columnConfig фильтры в конце\n */\n order?: string[];\n /**\n * Конфигурация фильтров для сайдбара.\n * Ключом может быть:\n * - Ключ колонки (для переопределения колоночного фильтра)\n * - Уникальный ключ (для добавления глобального фильтра)\n */\n items: Partial<\n Record<\n keyof T,\n {\n /** Заголовок фильтра (обязателен для глобальных фильтров), можно использовать для переопределения для локальных фильтров */\n label: string;\n /**\n * Функция рендера компонента фильтра.\n * Для колоночных фильтров переопределяет оригинальный рендер.\n * Для глобальных фильтров обязательна.\n */\n customRenderFn?: (\n filters: T,\n setFilters: React.Dispatch<React.SetStateAction<T>>,\n ) => React.ReactNode;\n }\n >\n >;\n };\n /**\n * Callback для кастомизации стилей чипсов (фильтров) в списке\n *\n * @param {ItemOrGroup} itemOrGroup - Текущий элемент или группа фильтров\n * @param {Item | undefined} item - Конкретный элемент фильтра (если есть)\n * @returns {CSSObject} Объект стилей, который будет применен к чипсу\n *\n * @description\n * Позволяет динамически задавать стили для каждого чипса в зависимости от его типа и содержимого.\n * Вызывается для каждого отображаемого чипса (как для отдельных элементов, так и для элементов внутри групп).\n *\n * @example\n * // Пример 1: Стилизация чипсов по типу\n * chipStyle: (itemOrGroup, item) => {\n * if (isGroup(itemOrGroup)) {\n * return { backgroundColor: '#f0f0f0' };\n * }\n * return { backgroundColor: '#e0e0e0' };\n * }\n *\n * @example\n * // Пример 2: Стилизация по значению фильтра\n * chipStyle: (itemOrGroup, item) => {\n * if (item?.label === 'Высокий приоритет') {\n * return {\n * backgroundColor: '#ffebee',\n * color: '#d32f2f'\n * };\n * }\n * return {};\n * }\n *\n * @example\n * // Пример 3: Разные стили для элементов в группе и одиночных\n * chipStyle: (itemOrGroup, item) => {\n * if (item) {\n * // Стиль для элемента внутри группы\n * return { maxWidth: 180 };\n * }\n * // Стиль для одиночного чипа\n * return { maxWidth: 150 };\n * }\n */\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n /**\n * Пользовательский форматтер заголовка группы чипсов.\n *\n * Используется в блоке активных фильтров для подмены текста заголовка\n * группы (например, “Статус”, “Тип”, “Автор”). Полезно, когда нужно\n * динамически менять подпись (добавить счётчик, i18n и т.п.).\n *\n * @param {ItemOrGroup} itemOrGroup Объект группы (тип Group). Вызов происходит только для групп,\n * поэтому безопасно кастовать к Group.\n * @returns {string} Текст заголовка группы чипсов.\n *\n * @default Возвращается `group.groupLabel`.\n *\n * @remarks\n * - Функция должна быть чистой и быстрой (без сетевых запросов и побочных эффектов).\n * - Возвращайте ТОЛЬКО строку — чипы отображают текстовое значение.\n * - Для длинных строк применяется усечение (overflow с многоточием) на уровне компонента.\n *\n * @example\n * // Добавить двоеточие и количество выбранных элементов\n * renderGroupLabel: (group) => `${group.groupLabel}: ${group.items.length}`\n *\n * @example\n * // Локализация заголовка группы\n * const i18n = { status: 'Статус', type: 'Тип' };\n * renderGroupLabel: (group) => i18n[group.groupId] ?? group.groupLabel\n */\n renderGroupLabel?: (group: Group) => string;\n\n /**\n * Пользовательский форматтер текста чипса (элемента внутри группы или одиночного фильтра).\n *\n * Позволяет управлять тем, что именно отображается внутри каждого чипса. Особенно полезен\n * при серверной пагинации/ленивой загрузке, когда в состоянии фильтра хранится только value,\n * а label необходимо подставить из локального кэша.\n *\n * @param {Group | null } group Группа, внутри которой рендерится чип (или null).\n * @param {Item} item Сам элемент чипса. В группах передаётся конкретный `Item`,\n * для одиночного чипа может быть `undefined`.\n * @returns {string} Текст, который будет показан в чипсе.\n *\n * @default Используется `item?.label.toString()` (или строковое представление value).\n *\n * @remarks\n * - Функция должна быть чистой и быстрой;\n * - Возвращайте ТОЛЬКО строку.\n *\n * @example\n * // 1) Отображение label из кэша при серверной пагинации\n * const labelsCacheRef = useRef(new Map<string, string>());\n * renderChipLabel: (group, item) => {\n * if (item?.id != null) {\n * const key = String(item.id);\n * const fromCache = labelsCacheRef.current.get(key);\n * if (fromCache) return fromCache; // красивый label, если уже загрузили\n * return String(item.label ?? key); // фоллбэк: временно показываем value/label из item\n * }\n * return ''; // безопасный фоллбэк для одиночных случаев\n * }\n *\n * @example\n * // 2) Нормализация отображения числовых значений\n * renderChipLabel: (_group, item) => {\n * const v = Number(item?.label);\n * return Number.isFinite(v) ? v.toLocaleString('ru-RU') : String(item?.label ?? '');\n * }\n *\n * @example\n * // 3) Префикс по типу группы\n * renderChipLabel: (group, item) => {\n * const prefix = group.groupId === 'status' ? '' : '#';\n * return `${prefix}${item?.label ?? item?.id ?? ''}`;\n * }\n */\n renderChipLabel?: (group: Group | null, item: Item) => string;\n};\n\nexport type DefaultSidebarTabIds = 'columns' | 'tableSettings' | 'filtering';\n\n/**\n * Общие настройки пользовательских вкладок левой и правой панели TableCanvas.\n */\nexport type TableCanvasSidebarConfig = {\n /**\n * Включен ли sidebar. Отвечает только за UI. Не влияет на перерасчёт фичей.\n * @default true\n */\n enabled?: boolean;\n /**\n * Открыт ли sidebar при первом рендере (uncontrolled-режим).\n * Игнорируется, если передан openState.\n * @default false\n */\n defaultOpen?: boolean;\n /**\n * Внешний контроль открытия/закрытия sidebar.\n * Если передан — источник истины, defaultOpen игнорируется.\n */\n openState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * id вкладки, выбранной по умолчанию (актуально при открытом сайдбаре).\n * Если id не найден или у вкладки showInSidebar=false — используется первая доступная.\n */\n defaultActiveTabId?: string;\n /**\n * Внешний контроль активной вкладки (controlled-режим).\n * Если передан — источник истины, defaultActiveTabId игнорируется.\n */\n activeTabState?: [\n string | null,\n React.Dispatch<React.SetStateAction<string | null>>,\n ];\n /**\n * Колбэк смены активной вкладки. Вызывается и в uncontrolled-режиме.\n * При закрытии сайдбара приходит null.\n */\n onActiveTabChange?: (tabId: string | null, tab?: SidebarTab) => void;\n /**\n * Кастомные табы\n */\n customTabs?: Array<\n Omit<SidebarTab, 'id'> & {\n id: Exclude<string, DefaultSidebarTabIds>;\n }\n >;\n /**\n * Порядок отображения кастомных вкладок\n */\n customTabsOrder?: Array<Exclude<string, DefaultSidebarTabIds>>;\n /**\n * Ширина контента без полоски вкладок (44px). Число — px, строка — CSS.\n * Проценты считаются от ширины рабочей области TableCanvas.\n * Изменение пропса сразу меняет ширину открытой панели.\n * По умолчанию: 300px слева, 400px справа.\n */\n width?: string | number;\n};\n\n/** Настройки правой панели; встроенные вкладки доступны только справа. */\nexport type SidebarConfig = TableCanvasSidebarConfig & {\n defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара (если данный таб окажется единственным табом в настройках) */\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки (для табов с id = filtering и columns - недоступен. Настраивается через таб с id='tableSettings') */\n iconTooltipText?: undefined;\n }\n | {\n id: 'tableSettings';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара */\n title?: string;\n\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный слот для вкладки tableSettings (рендерится после общих настроек)\n * Только дл id: 'tableSettings'\n */\n customGeneralSettingsSlot?: React.ReactNode;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки @default 'Настройки' */\n iconTooltipText?: string;\n }\n >;\n};\n\n/** Конфигурация правой панели. SidebarConfig сохранён для совместимости. */\nexport type RightSidebarConfig = SidebarConfig;\n\n/** Пользовательские вкладки слева; встроенных вкладок настроек нет. */\nexport type LeftSidebarConfig = TableCanvasSidebarConfig;\n\n/** Нижний слот под canvas, над пагинацией, между боковыми панелями. */\nexport type BottomSheetConfig = {\n /** @default true */\n enabled?: boolean;\n /** Число — px, строка — CSS; 'auto' — по содержимому. Проценты — от рабочей области. @default 32 */\n height?: string | number;\n /** Минимальная высота, ограниченная доступным пространством. @default 32 */\n minHeight?: string | number;\n /** Максимальная высота в px или CSS, дополнительно ограниченная доступным пространством. */\n maxHeight?: string | number;\n /** Пользователь управляет содержимым и раскрытием; при height: 'auto' панель прокручивается сама. */\n content: React.ReactNode;\n};\n\nexport function activeViewIs<T extends 'cards' | 'rows'>(\n checkType: T,\n viewState: 'cards' | 'rows',\n view: View,\n): view is ViewMods[T] {\n return checkType === viewState;\n}\n\n/** Размер controlBlock: 'm' и 's' — одинаковые стили, 'xs' — уменьшенный */\nexport type ControlBlockSize = 'm' | 's' | 'xs';\n\nexport type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * Размер controlBlock и его элементов (кнопки, иконки, поиск, отступы).\n * 'm' и 's' — стандартные стили, 'xs' — компактный режим.\n * Не влияет на customFeatures и кастомные слоты — они контролируются разработчиком.\n * @default 'm'\n */\n size?: ControlBlockSize;\n /**\n * @deprecated Используйте кастомные кнопки через rightSideInner или customFeatures.\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока.\n * Продолжает работать для обратной совместимости.\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * customFeatures - пропс для добавления кастомных фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\n /**\n * pinningMenu - нативная фича закрепления столбцов (SplitIconButton с\n * дропдауном) в правой зоне иконок. Появляется, когда активировано\n * закрепление колонок (columnsControl.pinning). Продукт может донастроить\n * и дополнить пункты меню (см. PinningMenuConfig).\n */\n pinningMenu?: PinningMenuConfig;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты левые фичи при адаптивной компрессии\n */\n leftSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты правые фичи при адаптивной компрессии\n */\n rightSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Активна ли фича компрессии (сжатие ToolsMenu при адаптиве)\n * @default true\n */\n enableAdaptiveCompress?: boolean;\n /**\n * Панель массовых действий\n */\n massActionPanel?: {\n /**\n * Кнопки панели. Размеры кнопок/дропдаунов панель подбирает сама (по `size` панели и компактности) —\n * передавать `size` кнопкам не нужно. Если `size` на кнопке всё же задан — он используется как есть.\n */\n buttons: MassActionButtonProps[];\n /**\n * Пропсы для Dropdown, в который сжались кнопки\n */\n collapsedDropdownProps?: TableDropdownConfigProps;\n /**\n * Отступ панели снизу от контейнера (px)\n * @default 24\n */\n bottom?: number;\n /**\n * Управление отображением панели массовых действий.\n * - `undefined` (по умолчанию) — стандартное поведение (показывается при selecting + выбранных строках)\n * - `false` — панель не рендерится, разработчик управляет действиями самостоятельно\n * - `true` — панель показывается всегда, даже без активного selecting и выбранных строк\n */\n show?: boolean;\n /**\n * Размерная сетка панели внутри таблицы: `m`/`s` — обычный размер, `xs` — уменьшенный (кнопки `xxs`, «ещё» `xs`, счётчик Body XS).\n * Viewport-логика (1280) в таблице не используется.\n * @default 's'\n */\n size?: MassActionsSize;\n };\n};\n\n/** Пропсы кнопки редактирования. onClick исключён — используйте onSave/onCancel/onEnableEditing. */\nexport type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n\nexport type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n\nexport type SummaryRowsConfig = {\n showDefault: boolean;\n showInControl: boolean;\n /**\n * callback при переключении тогла «Итоговые строки» в настройках таблицы.\n * Вызывается только по действию пользователя (не при монтировании),\n * поэтому подходит для сохранения выбора, например, в localStorage.\n * Сохранённое значение передавайте обратно в `showDefault`.\n */\n onChange?: (checked: boolean) => void;\n} & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\n/**\n * Конфиг тултипа при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\nexport type TableConfigTooltip = {\n /**\n * Включить/выключить колоночные и кастомные тултипы (cellTooltip, headerCellTooltip).\n * Внутренние тултипы (drag-иконка в шапке и другие по nodeId) работают всегда.\n * @default false\n */\n enabled?: boolean;\n /** Глобальная задержка перед показом тултипа (мс). Per-node переопределяет. @default 500 */\n mouseEnterDelay?: number;\n /** Глобальная задержка перед скрытием тултипа (мс). Per-node переопределяет. @default 0 */\n mouseLeaveDelay?: number;\n /**\n * Минимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n minWidth?: number | string;\n /**\n * Максимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n maxWidth?: number | string;\n};\n\nexport type InfinityScrollConfig<RowType extends ObjectForExtending> = {\n /** Триггер достижения скроллом зоны подгрузки данных. */\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n /** Состояние загрузки (скелетоны) новых строк. */\n isLoading: boolean;\n /**\n * Флаг, когда все данные загружены — false.\n * @default true\n */\n hasMore?: boolean;\n /**\n * Для mode='region': за сколько строк до конца триггерить загрузку.\n * @default 5\n */\n rowThreshold?: number;\n};\n\nexport type { TableCanvasEmptyStateConfig, TableCanvasErrorStateConfig };\n\n/**\n * Настройка выделения ячеек/колонок/строк в TableCanvas — единый объект.\n * Это отдельная ось взаимодействия — не зависит от `highlightActiveType`.\n */\nexport type CellsSelectionConfig = {\n /**\n * Режим фактического выделения ячеек (нативный glide selection). По нему\n * работают copy/paste, рамка, fill-handle и затемнение шапки/нумерации.\n * @default \"range-cell\"\n */\n mode?: CellsSelectionMode;\n /**\n * Выделение колонок по клику на шапку. Ctrl/Cmd — добавить/убрать колонку,\n * Shift — диапазон колонок. Клик по иконкам сортировки/фильтрации в шапке\n * выделение НЕ вызывает. Поддерживает copy/paste по выделенным колонкам.\n * @default true\n */\n enableColumnSelection?: boolean;\n /**\n * Выделение строк по клику/драгу на колонке нумерации (`rowMarkers`).\n * Ctrl/Cmd — несмежный выбор отдельных строк, драг — смежный диапазон.\n * Поддерживает copy/paste по выделенным строкам. Требует включённой колонки\n * нумерации (`rowMarkers`). При `false` клик по нумерации ничего не выделяет.\n * @default true\n */\n enableRowSelection?: boolean;\n /**\n * Выделение всей таблицы кликом по «нулевой» ячейке — шапке колонки нумерации\n * (левый верхний угол). Выделяет все строки данных по всем колонкам одним\n * диапазоном; поддерживает copy/paste. Требует включённой колонки нумерации\n * (`rowMarkers`) и активного `mode` (≠ `disabled`).\n * @default true\n */\n enableSelectAll?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — он внутренний.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n};\n\n/** Один объединённый блок: какие строки и колонки слить. */\nexport type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n\n/**\n * Видимость сторон рамки ячейки: true рисовать, false не рисовать, не задано -\n * работает уровень ниже (настройка колонки, строки или общая).\n */\nexport type CellBorderVisibility = {\n top?: boolean;\n right?: boolean;\n bottom?: boolean;\n left?: boolean;\n};\n\n/**\n * Управление рамками (линиями) таблицы: включение и выключение. Уровни, от\n * слабого к сильному: общие настройки (vertical, horizontal), затем колонка\n * (getVerticalBorder) и строка (getHorizontalBorder), затем ячейка\n * (getCellBorder).\n */\nexport type BordersConfig<RowType = ObjectForExtending> = {\n /** Рисовать ли вертикальные линии между колонками. @default true */\n vertical?: boolean;\n /** Рисовать ли горизонтальные линии между строками тела. @default true */\n horizontal?: boolean;\n /**\n * Точечное управление вертикальной линией справа от колонки (разделитель\n * после неё). Вернуть true или false, чтобы переопределить общую настройку\n * vertical, или undefined, чтобы оставить её. Зовётся на каждую видимую\n * колонку при перерисовке, поэтому функция должна быть быстрой.\n */\n getVerticalBorder?: (params: {\n /** Ключ колонки, справа от которой рисуется линия. */\n columnKey: string;\n /** Индекс колонки в порядке отрисовки (закреплённые в начале). */\n columnIndex: number;\n }) => boolean | undefined;\n /**\n * Точечное управление горизонтальной линией сверху строки. Вернуть true или\n * false, чтобы переопределить общую настройку horizontal, или undefined,\n * чтобы оставить её. Для summary-строк не вызывается. Зовётся на каждую\n * видимую строку при перерисовке, поэтому функция должна быть быстрой.\n */\n getHorizontalBorder?: (params: {\n /** Строка под линией (линия рисуется сверху этой строки). */\n row: RowType;\n /** Индекс строки среди отображаемых. При раскрытии subRows индексы сдвигаются. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => boolean | undefined;\n /**\n * Стороны рамки конкретной ячейки, вкл и выкл. Для ячеек без переопределений\n * возвращать undefined. Включает отрисовку линий с разбивкой по ячейкам,\n * поэтому функция должна быть быстрой: без тяжёлых вычислений и с готовыми\n * объектами-константами вместо новых на каждый вызов. Для summary-строк не\n * вызывается.\n */\n getCellBorder?: (params: {\n /** Индекс колонки среди отображаемых (без служебных). */\n col: number;\n /** Ключ колонки. */\n columnKey: string | undefined;\n /** Строка ячейки. */\n row: RowType;\n /** Индекс строки среди отображаемых. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => CellBorderVisibility | undefined;\n};\n\nexport type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@sber-digital-finance-ui/ui-kit';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n };\n /**\n * editing - активация редактирования. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={editing: {onRowsChange, rowKeyGetter}}\n *\n * columnConfig=[{editingCell: {...}}]\n */\n editing?: EditingConfig<RowType, RowIdType, SummaryRowType>;\n\n /**\n * cellTransfer — конфигурация копирования, вставки и fill handle.\n * По умолчанию копирование (Ctrl+C) работает в режиме редактирования.\n * Данные копируются в формате TSV (tab-separated values), совместимом с Excel.\n *\n * Пример:\n *\n * tableConfig={{ cellTransfer: { enabled: true, onBeforeCopy: (data) => data } }}\n */\n cellTransfer?: CellTransferConfig;\n\n /**\n * Объединение ячеек тела таблицы.\n *\n * mergeByCellValues — колонки, в которых подряд идущие одинаковые значения\n * сливаются в один блок (по вертикали). Границы блоков таблица считает сама из\n * данных; сортировка и фильтр их пересобирают. Данные не меняются — значение и\n * так повторяется в строках, объединение лишь показывает его одной ячейкой.\n *\n * mergedCellsRegions — список блоков, заданных снаружи (как выделение): каждый\n * блок описан ключами строк (rowKeys) и колонок (colKeys). Нужен rowKeyGetter.\n * Если после сортировки или скрытия колонок строки/колонки блока перестали идти\n * подряд — блок не рисуется. Важнее mergeByCellValues.\n *\n * Примеры: mergeCells={{ mergeByCellValues: ['dept', 'role'] }},\n * mergeCells={{ mergedCellsRegions, rowKeyGetter: (r) => r.id }}.\n */\n mergeCells?: {\n mergeByCellValues?: Array<\n string | { colKey: string; value: (row: RowType) => unknown }\n >;\n /** Список блоков, заданных снаружи (по ключам строк и колонок). */\n mergedCellsRegions?: MergedCellsRegion[];\n /**\n * Нужен для mergedCellsRegions: находит строку по её ключу. Должна быть\n * стабильной функцией; менять её на лету не нужно — в пересборку таблицы она\n * не входит.\n */\n rowKeyGetter?: (row: RowType) => string | number;\n /**\n * Выравнивание по умолчанию для всех блоков. Колоночный mergedCellsAlign и\n * выравнивание конкретного региона важнее.\n */\n mergedCellsAlign?: MergedCellsAlign;\n };\n\n /**\n * Модуль нотификаций: стандартизированный канал событий для внешних\n * потребителей. Таблица UI не рисует — вызывает `onNotification`, потребитель\n * показывает тост/модалку на своей стороне. Сейчас эмитятся ошибки copy/paste\n * (в т.ч. multi-range 2D-разброс, readonly/overflow-abort, пропуск валидацией).\n */\n notifications?: TableNotificationsConfig;\n\n /**\n * subRows - активация иерархии, отображения вложенных строк. Условие активации - наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={subRows: {getSubRows, rowKeyGetter}}\n *\n * columnConfig=[{subRow: {...}}]\n */\n subRows?: SubRows<RowType, RowIdType>;\n /**\n * Столбец с нумерацией строк.\n * Активируется наличием этого свойства. Поддерживает `subRows` любой глубины.\n *\n * @see {@link RowMarkersTableConfig} — полное описание конфигурации и примеры.\n */\n rowMarkers?: RowMarkersTableConfig<RowType>;\n rowsGrouping?: RowsGrouping<RowType, SummaryRowType>;\n\n /**\n * resizableColumn - активация изменения ширины колонки с помощью курсора. Условие активации - resizableColumn: true. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={resizableColumn: true}\n *\n * columnConfig=[{resizable: true}]\n */\n resizableColumn?: boolean;\n /**\n * style - inline-стили. Для стилей самой таблицы (без вложенности).\n *\n * Исключены свойства 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'. Их следует стилизовать через свойства containerStyle.\n */\n style?: Omit<\n CSSProperties,\n 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'\n >;\n /**\n * css - для стилей простых и сложных(например, для стилизации cell, headerCell, ...).\n *\n * Пример:\n *\n * ```css\n * & > .rdg-header-row > .rdgCell {\n * background-color: red;\n * }\n * ```\n *\n */\n css?: string | CSSObject;\n\n summaryRows?: SummaryRowsConfig;\n /**\n * controlBlock - пропс для активации, кастомизации контролблока.\n */\n controlBlock?: ControlBlockConfig;\n /**\n * containerStyle - инлайновые стили контейнера таблицы и контролблока. высоту и ширину для таблицы рекомендуется задавать в этом пропсе.\n * Пример:\n *\n * ```tsx\n tableConfig={{ containerStyle: { height: '70vh' } }}\n * ```\n */\n containerStyle?: CSSProperties | undefined;\n /**\n * containerCss - стили для контейнера таблицы и контролблока.\n * Через этот пропс можно дополнительно кастомизировать контейнер и все его дочерние элементы.\n */\n containerCss?: string | CSSObject | undefined;\n /**\n * containerId - html-атрибут id контейнера таблицы.\n */\n containerId?: string | undefined;\n\n /**\n * unstickyHeader - откреплённая шапка. Header уезжает вместе со скроллом контента.\n * @default false\n */\n unstickyHeader?: boolean;\n\n /**\n * stickyColumns - колонки, которые прилипают к левому краю при горизонтальной прокрутке,\n * как `position: sticky`. Ключи колонок или предикат по колонке.\n *\n * ```tsx\n * tableConfig={{ stickyColumns: ['region', 'total'] }}\n * tableConfig={{ stickyColumns: (column) => column.key.startsWith('total') }}\n * ```\n */\n stickyColumns?: StickyColumnsConfig<ColumnConfig<RowType, SummaryRowType>>;\n\n /**\n * stickyRows - строки, которые прилипают под шапкой при вертикальной прокрутке.\n * Предикат проверяется для каждой отображаемой строки данных (результаты кешируются); строки групп\n * (`rowsGrouping`) и заглушки загрузки в него не попадают и липкими не становятся.\n * Индексы передаются как есть — удобно для больших таблиц, где позиции известны заранее. Они\n * считаются по итоговому отображаемому списку: сортировка, фильтры, группировка и раскрытые узлы\n * дерева (`subRows`) сдвигают нумерацию — тогда индексы нужно пересчитывать или передать предикат.\n *\n * ```tsx\n * tableConfig={{ stickyRows: (row) => row.isSubtotal }}\n * tableConfig={{ stickyRows: [0, 41, 82] }}\n * ```\n */\n stickyRows?: StickyRowsConfig<RowType>;\n\n /** Тултип при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\n tooltip?: TableConfigTooltip;\n\n /**\n * infinityScroll - бесконечная подгрузка данных при скролле.\n *\n * Условие активации - наличие самого пропса infinityScroll.\n *\n * При активации infinityScroll отключается дефолтная сортировка и фильтрация.\n * (Предполагается, что если есть infinityScroll,\n * то в таблице представлен не весь объем данных,\n * по этой причине дефолтная сортировка и фильтрация не подходят и будут отображать некорректные данные)\n *\n */\n infinityScroll?: InfinityScrollConfig<RowType>;\n /**\n * @isLoading - состояние загрузки данных для таблицы.\n */\n isLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n /**\n * loadingOverlay - конфигурация для отображения оверлея загрузки.\n * Показывает индикатор загрузки поверх таблицы с возможностью кастомизации.\n */\n loadingOverlay?: {\n /**\n * Активен ли оверлей загрузки\n * @default true\n */\n active?: boolean;\n /**\n * Кастомный компонент спиннера\n * @default <Spinner view=\"secondary\" size=\"36\" /> (внутренний компонент)\n */\n spinner?: ReactNode;\n /**\n * Основной заголовок оверлея\n * @default \"Загрузка таблицы\"\n */\n title?: string;\n /**\n * Подзаголовок, который появится после задержки, пустая строка - значит он не появится\n * @default \"\"\n */\n subtitle?: string;\n /**\n * Задержка перед показом подзаголовка (мс)\n * @default 10000 (10 секунд)\n */\n showSubtitleDelay?: number;\n };\n /**\n * Empty state внутри content-области canvas-таблицы.\n * Не заменяет control block, header или pagination.\n */\n emptyState?: TableCanvasEmptyStateConfig;\n /**\n * Error state внутри content-области canvas-таблицы.\n * Не заменяет control block, header или pagination.\n */\n errorState?: TableCanvasErrorStateConfig;\n // FIXME:\n // noRowsFallback?: boolean | { custom: ReactNode };\n columnsControl?: ColumnsControlConfig;\n // FIXME:\n // rowDetailPanel?: RowDetailConfig<RowType>;\n // FIXME: Временно комментирую использование, пока не адаптируем TableCanvas\n // rowInstruments?: {\n // getRowDropdownConfig: RowInstrumentsType<RowType>;\n // /**\n // * @default false\n // */\n // defaultOpened?: boolean;\n // /**\n // * @default true\n // */\n // showInControl?: boolean;\n // /**\n // * Внешний стейт видимости\n // */\n // openedState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n // };\n fullScreenEnabled?: FullScreen;\n /**\n * Переносит портал editor overlay внутрь контейнера таблицы вместо document.body.\n * Решает проблему focus trap и сдвига координат при рендере таблицы в модалке с CSS transform.\n * @default undefined (overlay рендерится в document.body — стандартное поведение)\n */\n editorOverlayPortal?: 'inside';\n keyText?: boolean | KeyTextConfig;\n /**\n * pagination - пропс для пагинации.\n *\n * Условие активации - наличие самого пропса pagination.\n *\n * При активации pagination отключается дефолтные поиск, сортировка и фильтрация.\n * (поиск работает на уровне с фильтрацией и сортировкой, сначала поиск, затем фильтрация, затем сортировка)\n *\n */\n pagination?: PaginationProps;\n /**\n * searching - пропс для поиска по таблицу.\n *\n * Условие активации - наличие searching.enabled: true\n *\n */\n /**\n * Конфигурация табов в сайдбаре\n */\n /** @deprecated Используйте rightSidebarConfig. При наличии обоих приоритет у rightSidebarConfig. */\n sidebarConfig?: SidebarConfig;\n /** Конфигурация правой панели. */\n rightSidebarConfig?: RightSidebarConfig;\n /** Конфигурация пользовательских вкладок левой панели (режим строк). */\n leftSidebarConfig?: LeftSidebarConfig;\n /** Нижний слот в режиме строк. Не увеличивает внешний контейнер таблицы. */\n bottomSheetConfig?: BottomSheetConfig;\n searching?: SearchingProps;\n /**\n * onHeaderContextMenu - callback открытия контекстного меню.\n */\n onHeaderContextMenu?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onHeaderContextMenu'];\n onHeaderContextMenuDropdown?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onHeaderContextMenuDropdown'];\n onCellContextMenuDropdown?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onCellContextMenuDropdown'];\n onCellContextMenu?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onCellContextMenu'];\n /**\n * Обработчик клика по ячейке.\n *\n * Получает `cell` readonly [colIndex, rowIndex] от glide, и `info` обогащённый объект\n * с row, column, ctxs, refTable (аналогично onCellContextMenu).\n */\n onCellClicked?: (\n cell: readonly [number, number],\n info: TableInfoWithRow<RowType, SummaryRowType>,\n ) => void;\n} & GlideInstanceOmitted<RowType, SummaryRowType>;\n\ntype GlideInstanceOmitted<\n RowType extends ObjectForExtending,\n SummaryRowType,\n> = Pick<\n Omit<\n TableGlideInstanceProps<RowType, SummaryRowType>,\n | keyof TableGlideCustomProps<RowType, SummaryRowType>\n | 'CellReadOnlyEditor' /* CellReadOnlyEditor - свойство только для GlideInstance */\n >,\n | 'className'\n | 'columnSelect'\n | 'minColumnWidth'\n | 'maxColumnWidth'\n | 'maxColumnAutoWidth'\n | 'onVisibleRegionChanged'\n | 'onCellClicked'\n // | 'CellReadOnlyEditor'\n // | 'onGroupHeaderClicked'\n | 'onHeaderClicked'\n | 'onItemHovered'\n | 'trapFocus'\n | 'onColumnResize'\n>;\nexport type CellReadOnlyEditorProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n> = CellReadOnlyEditorGlideInstanceStaticProps &\n EditingCellInfo<RowType, SummaryRowType>;\n\n// & Pick<\n// DataGridPropsDefault<RowType, SummaryRowType, RowIdType>,\n// | 'summaryRowHeight'\n// | 'onFill'\n// | 'onCopy'\n// | 'onPaste'\n// | 'onCellClick'\n// | 'onCellDoubleClick'\n// | 'onCellContextMenu'\n// | 'onCellKeyDown'\n// | 'onSelectedCellChange'\n// | 'onScroll'\n// | 'onColumnResize'\n// | 'onColumnsReorder'\n// | 'enableVirtualization'\n// | 'rowClass'\n// | 'data-testid'\n// | 'headerRowHeight'\n// >;\n\n/**\n * Конфигурация фичи rowMarkers (столбец с нумерацией строк).\n *\n * Столбец frozen, вставляется первым, исключён из reorder/pin/hide/sort/grouping.\n * Поддерживает плоский и древовидный (`subRows`) режимы любой глубины вложенности.\n *\n * **Дефолтное поведение** (без `getRowMarker`): root-only нумерация —\n * корневые строки получают номер (`startIndex + rootIndex`), дочерние — пустую строку.\n *\n * @example\n * ```tsx\n * // Минимальная конфигурация\n * tableConfig={{ rowMarkers: { startIndex: 1 } }}\n *\n * // Сквозная стабильная нумерация\n * tableConfig={{ rowMarkers: { getRowMarker: ({ flatIndex }) => flatIndex + 1 } }}\n * ```\n */\nexport type RowMarkersTableConfig<\n RowType extends ObjectForExtending = ObjectForExtending,\n> = {\n /**\n * Стартовый индекс нумерации (для дефолтной логики без `getRowMarker`).\n * @default 1\n */\n startIndex?: number;\n\n /**\n * Ширина столбца с нумерацией (в px).\n * Если задан `size` — он приоритетнее.\n+ * Если ни `size`, ни `width` не заданы — ширина подстраивается\n+ * под глобальный `tableConfig.rowSize` (small=20, medium=32, big=48).\n * @default 32\n */\n width?: number;\n /**\n * Размер столбца. Приоритетнее `width`.\n * - `xs` = 20px\n * - `s` = 32px\n * - `m` = 48px\n */\n size?: 'xs' | 's' | 'm';\n /**\n * Кастомная функция нумерации. Полностью переопределяет дефолтную root-only логику.\n * Вызывается при рендере каждой ячейки столбца нумерации.\n *\n * ⚠️ Вызывается не только при полной отрисовке таблицы, но и при ховере/скролле —\n * для **одной** ячейки. Не используйте внешние переменные-счётчики —\n * используйте аргументы (`siblingPath`, `flatIndex` и др.), они всегда актуальны.\n *\n * @example\n * // Сквозная стабильная нумерация (все строки, номера не прыгают при сворачивании)\n * getRowMarker: ({ flatIndex }) => flatIndex + 1\n *\n * @example\n * // Корневые — номер, дочерние — прочерк\n * getRowMarker: ({ isSubRow, flatIndex }) => isSubRow ? '—' : flatIndex + 1\n *\n * @example\n * // Иерархическая нумерация любой глубины: 1, 1.1, 1.1.1, 1.2, 2\n * getRowMarker: ({ siblingPath }) => siblingPath.map(i => i + 1).join('.')\n */\n getRowMarker?: (args: {\n /** Данные текущей строки. */\n row: RowType;\n /** Уровень строки в дереве: `0` — корневая, `1` — дочерняя, `2` — внучка, и т.д. */\n level: number;\n /** `true`, если строка дочерняя (`level > 0`). */\n isSubRow: boolean;\n /**\n * Индекс строки в **видимых** строках.\n * **Нестабильный** — меняется при сворачивании и разворачивании веток.\n */\n rowIndex: number;\n /**\n * Стабильный 0-based индекс строки в **полном** дереве (включая скрытые/свёрнутые).\n * Не меняется при collapse/expand — подходит для сквозной нумерации.\n */\n flatIndex: number;\n /**\n * Порядковый номер среди siblings одного родителя (0-based).\n * Для корневых строк — порядковый номер среди всех корневых.\n * Для дочерних — порядковый номер среди children одного `parentKey`.\n */\n siblingIndex: number;\n /**\n * Путь siblingIndex-ов от корня до текущей строки (каждый элемент 0-based).\n *\n * Примеры:\n * - корневая строка (2-я): `[1]`\n * - дочерняя (3-й ребёнок 2-го корня): `[1, 2]`\n * - внучка (1-й ребёнок 1-го ребёнка 1-го корня): `[0, 0, 0]`\n *\n * Для иерархической нумерации: `siblingPath.map(i => i + 1).join('.')` → `\"1.1.1\"`\n *\n * Для плоской таблицы (без subRows): всегда `[siblingIndex]` (один элемент).\n */\n siblingPath: number[];\n /**\n * Ключ родительской строки (`rowKeyGetter(parent)`).\n * `null` для корневых строк. Работает для **любой** глубины вложенности.\n */\n parentKey: string | number | null;\n /** Текущий видимый `flattened` массив строк. */\n rows: readonly RowType[];\n }) => string | number;\n};\n```\n\n## FilterComponentInPopoverProps\n\nПропсы, доступные в кастомном компоненте фильтра (`component: 'custom'`).\n\n```typescript\ntype FilterComponentInPopoverProps<\n FilterStateType extends ObjectForExtending,\n ColumnConfig,\n> = {\n popoverIsOpen: boolean;\n setPopoverIsOpen: React.Dispatch<React.SetStateAction<boolean>>;\n columnConfig: ColumnConfig;\n tabIndex: number;\n headerContextState: HeaderContextValueTypeInstance<FilterStateType> &\n FiltersVariables &\n HeaderContextValueTypeInstance<ObjectForExtending>;\n /**\n * Источник открытия фильтра: из шапки таблицы или из сайдбара\n * Полезно для условной логики в customRender (например, alwaysOpened для combobox)\n */\n filterSource?: 'header' | 'sidebar';\n};\n```",
49869
+ "apiDocs": "# Filtering API\n\n## FilteringConfig\n\n```typescript\ntype FilteringConfig<T> = {\n state: [T, React.Dispatch<React.SetStateAction<T>>];\n /**\n * @deprecated Использовать filtersInfo\n *\n * clearedValue - состояние фильтров после очистки. Используется для сравнения:\n * Например, был ли фильтр конкретной колонки изменен рассчитывается посредством сравнения текущего значения фильтра и значения фильтра в clearedValue.\n * Если они равны, то фильтр считается не измененным.\n */\n clearedValue?: T;\n /**\n * Информация о фильтрах для каждой колонки.\n * Используется для:\n * 1. Хранения меток (label) фильтров для отображения в UI\n * 2. Хранения значений по умолчанию (clearedValue) для каждого фильтра\n * 3. Определения, был ли фильтр изменен (сравнение текущего значения с clearedValue)\n */\n filtersInfo?: Record<\n keyof T,\n {\n label: string;\n clearedValue: T[keyof T];\n }\n >;\n /**\n * manualFiltering - пропс, активирующий ручную-кастомную (или на стороне бэка) фильтрацию.\n * @remarks\n * Для автоматической фильтрации (когда не используется manualFiltering в tableConfig):\n * - Для всех типов фильтров обязательно должен быть указан `valueInRow`\n * - Для component: 'select' дополнительно должен быть указан `filteringType`\n * - Для component: 'input' с кастомным фильтром (когда filter - функция)\n * функция фильтрации должна быть передана явно\n *\n * Если используется manualFiltering, эти параметры не обязательны,\n * так как вся логика фильтрации реализуется извне.\n */\n manualFiltering?: boolean;\n /**\n * Конфигурация для отображения фильтров в правом сайдбаре.\n *\n * Позволяет:\n * 1. Добавлять глобальные фильтры (не привязанные к конкретной колонке)\n * 2. Управлять порядком отображения фильтров\n * 3. Переопределять рендер и заголовки колоночных фильтров\n *\n * Логика работы:\n * - По умолчанию в сайдбаре отображаются все колоночные фильтры (из columnConfig)\n * - Ключом фильтра считается `key` колонки, если его нет, то пытаемся взять `keyInFilterState` (если указан), иначе это не будет работать\n * - Заголовком фильтра по умолчанию является `name` колонки или ключ фильтра (name || key)\n * - Глобальные фильтры добавляются через `items` с уникальными ключами\n *\n * Особенности:\n * 1. Порядок отображения:\n * - Сначала фильтры из `order` (в указанной последовательности)\n * - Затем остальные колоночные фильтры (в порядке columnConfig)\n * - В конце - глобальные фильтры (в алфавитном порядке ключей)\n *\n * 2. Переопределение колоночных фильтров:\n * - Чтобы изменить заголовок: укажите ключ колонки в `items` с новым `label`\n * - Чтобы заменить рендер: укажите ключ колонки с `customRenderFn`\n * - Оригинальный фильтр из колонки будет проигнорирован\n *\n * 3. Глобальные фильтры:\n * - Ключ не должен совпадать с ключами колонок\n * - Обязательно указать `label` и `customRenderFn`\n * - Отображаются после всех колоночных фильтров, если не переопределены в order\n *\n * @example\n * // Добавление глобального фильтра и изменение порядка\n * sidebarConfig: {\n * order: ['status', 'tasks', 'type'], // Сначала статус, затем глобальный поиск\n * items: {\n * tasks: { // Уникальный ключ\n * label: 'Поиск по всем полям',\n * customRenderFn: () => <TaskComponent />\n * },\n * status: { // Переопределение колоночного фильтра\n * label: 'Статус заявки', // Новый заголовок\n * customRenderFn: () => <CustomStatusFilter /> // Кастомный рендер\n * }\n * type: { // Переопределение только Label колоночного фильтра\n * label: 'Тип', // Новый заголовок\n * }\n * }\n * }\n */\n sidebarConfig?: {\n /**\n * Определяет порядок отображения фильтров.\n * - Указываются ключи фильтров (колоночных или глобальных)\n * - Не указанные в order фильтры отображаются после\n * - Если order пуст, сохраняется порядок: глобальные фильтры + columnConfig фильтры в конце\n */\n order?: string[];\n /**\n * Конфигурация фильтров для сайдбара.\n * Ключом может быть:\n * - Ключ колонки (для переопределения колоночного фильтра)\n * - Уникальный ключ (для добавления глобального фильтра)\n */\n items: Partial<\n Record<\n keyof T,\n {\n /** Заголовок фильтра (обязателен для глобальных фильтров), можно использовать для переопределения для локальных фильтров */\n label: string;\n /**\n * Функция рендера компонента фильтра.\n * Для колоночных фильтров переопределяет оригинальный рендер.\n * Для глобальных фильтров обязательна.\n */\n customRenderFn?: (\n filters: T,\n setFilters: React.Dispatch<React.SetStateAction<T>>,\n ) => React.ReactNode;\n }\n >\n >;\n };\n /**\n * Callback для кастомизации стилей чипсов (фильтров) в списке\n *\n * @param {ItemOrGroup} itemOrGroup - Текущий элемент или группа фильтров\n * @param {Item | undefined} item - Конкретный элемент фильтра (если есть)\n * @returns {CSSObject} Объект стилей, который будет применен к чипсу\n *\n * @description\n * Позволяет динамически задавать стили для каждого чипса в зависимости от его типа и содержимого.\n * Вызывается для каждого отображаемого чипса (как для отдельных элементов, так и для элементов внутри групп).\n *\n * @example\n * // Пример 1: Стилизация чипсов по типу\n * chipStyle: (itemOrGroup, item) => {\n * if (isGroup(itemOrGroup)) {\n * return { backgroundColor: '#f0f0f0' };\n * }\n * return { backgroundColor: '#e0e0e0' };\n * }\n *\n * @example\n * // Пример 2: Стилизация по значению фильтра\n * chipStyle: (itemOrGroup, item) => {\n * if (item?.label === 'Высокий приоритет') {\n * return {\n * backgroundColor: '#ffebee',\n * color: '#d32f2f'\n * };\n * }\n * return {};\n * }\n *\n * @example\n * // Пример 3: Разные стили для элементов в группе и одиночных\n * chipStyle: (itemOrGroup, item) => {\n * if (item) {\n * // Стиль для элемента внутри группы\n * return { maxWidth: 180 };\n * }\n * // Стиль для одиночного чипа\n * return { maxWidth: 150 };\n * }\n */\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n /**\n * Пользовательский форматтер заголовка группы чипсов.\n *\n * Используется в блоке активных фильтров для подмены текста заголовка\n * группы (например, “Статус”, “Тип”, “Автор”). Полезно, когда нужно\n * динамически менять подпись (добавить счётчик, i18n и т.п.).\n *\n * @param {ItemOrGroup} itemOrGroup Объект группы (тип Group). Вызов происходит только для групп,\n * поэтому безопасно кастовать к Group.\n * @returns {string} Текст заголовка группы чипсов.\n *\n * @default Возвращается `group.groupLabel`.\n *\n * @remarks\n * - Функция должна быть чистой и быстрой (без сетевых запросов и побочных эффектов).\n * - Возвращайте ТОЛЬКО строку — чипы отображают текстовое значение.\n * - Для длинных строк применяется усечение (overflow с многоточием) на уровне компонента.\n *\n * @example\n * // Добавить двоеточие и количество выбранных элементов\n * renderGroupLabel: (group) => `${group.groupLabel}: ${group.items.length}`\n *\n * @example\n * // Локализация заголовка группы\n * const i18n = { status: 'Статус', type: 'Тип' };\n * renderGroupLabel: (group) => i18n[group.groupId] ?? group.groupLabel\n */\n renderGroupLabel?: (group: Group) => string;\n\n /**\n * Пользовательский форматтер текста чипса (элемента внутри группы или одиночного фильтра).\n *\n * Позволяет управлять тем, что именно отображается внутри каждого чипса. Особенно полезен\n * при серверной пагинации/ленивой загрузке, когда в состоянии фильтра хранится только value,\n * а label необходимо подставить из локального кэша.\n *\n * @param {Group | null } group Группа, внутри которой рендерится чип (или null).\n * @param {Item} item Сам элемент чипса. В группах передаётся конкретный `Item`,\n * для одиночного чипа может быть `undefined`.\n * @returns {string} Текст, который будет показан в чипсе.\n *\n * @default Используется `item?.label.toString()` (или строковое представление value).\n *\n * @remarks\n * - Функция должна быть чистой и быстрой;\n * - Возвращайте ТОЛЬКО строку.\n *\n * @example\n * // 1) Отображение label из кэша при серверной пагинации\n * const labelsCacheRef = useRef(new Map<string, string>());\n * renderChipLabel: (group, item) => {\n * if (item?.id != null) {\n * const key = String(item.id);\n * const fromCache = labelsCacheRef.current.get(key);\n * if (fromCache) return fromCache; // красивый label, если уже загрузили\n * return String(item.label ?? key); // фоллбэк: временно показываем value/label из item\n * }\n * return ''; // безопасный фоллбэк для одиночных случаев\n * }\n *\n * @example\n * // 2) Нормализация отображения числовых значений\n * renderChipLabel: (_group, item) => {\n * const v = Number(item?.label);\n * return Number.isFinite(v) ? v.toLocaleString('ru-RU') : String(item?.label ?? '');\n * }\n *\n * @example\n * // 3) Префикс по типу группы\n * renderChipLabel: (group, item) => {\n * const prefix = group.groupId === 'status' ? '' : '#';\n * return `${prefix}${item?.label ?? item?.id ?? ''}`;\n * }\n */\n renderChipLabel?: (group: Group | null, item: Item) => string;\n};\n\nexport type DefaultSidebarTabIds = 'columns' | 'tableSettings' | 'filtering';\n\n/**\n * Общие настройки пользовательских вкладок левой и правой панели TableCanvas.\n */\nexport type TableCanvasSidebarConfig = {\n /**\n * Включен ли sidebar. Отвечает только за UI. Не влияет на перерасчёт фичей.\n * @default true\n */\n enabled?: boolean;\n /**\n * Открыт ли sidebar при первом рендере (uncontrolled-режим).\n * Игнорируется, если передан openState.\n * @default false\n */\n defaultOpen?: boolean;\n /**\n * Внешний контроль открытия/закрытия sidebar.\n * Если передан — источник истины, defaultOpen игнорируется.\n */\n openState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * id вкладки, выбранной по умолчанию (актуально при открытом сайдбаре).\n * Если id не найден или у вкладки showInSidebar=false — используется первая доступная.\n */\n defaultActiveTabId?: string;\n /**\n * Внешний контроль активной вкладки (controlled-режим).\n * Если передан — источник истины, defaultActiveTabId игнорируется.\n */\n activeTabState?: [\n string | null,\n React.Dispatch<React.SetStateAction<string | null>>,\n ];\n /**\n * Колбэк смены активной вкладки. Вызывается и в uncontrolled-режиме.\n * При закрытии сайдбара приходит null.\n */\n onActiveTabChange?: (tabId: string | null, tab?: SidebarTab) => void;\n /**\n * Кастомные табы\n */\n customTabs?: Array<\n Omit<SidebarTab, 'id'> & {\n id: Exclude<string, DefaultSidebarTabIds>;\n }\n >;\n /**\n * Порядок отображения кастомных вкладок\n */\n customTabsOrder?: Array<Exclude<string, DefaultSidebarTabIds>>;\n /**\n * Ширина контента без полоски вкладок (44px). Число — px, строка — CSS.\n * Проценты считаются от ширины рабочей области TableCanvas.\n * Изменение пропса сразу меняет ширину открытой панели.\n * По умолчанию: 300px слева, 400px справа.\n */\n width?: string | number;\n};\n\n/** Настройки правой панели; встроенные вкладки доступны только справа. */\nexport type SidebarConfig = TableCanvasSidebarConfig & {\n defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара (если данный таб окажется единственным табом в настройках) */\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки (для табов с id = filtering и columns - недоступен. Настраивается через таб с id='tableSettings') */\n iconTooltipText?: undefined;\n }\n | {\n id: 'tableSettings';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара */\n title?: string;\n\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный слот для вкладки tableSettings (рендерится после общих настроек)\n * Только дл id: 'tableSettings'\n */\n customGeneralSettingsSlot?: React.ReactNode;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки @default 'Настройки' */\n iconTooltipText?: string;\n }\n >;\n};\n\n/** Конфигурация правой панели. SidebarConfig сохранён для совместимости. */\nexport type RightSidebarConfig = SidebarConfig;\n\n/** Пользовательские вкладки слева; встроенных вкладок настроек нет. */\nexport type LeftSidebarConfig = TableCanvasSidebarConfig;\n\n/** Нижний слот под canvas, над пагинацией, между боковыми панелями. */\nexport type BottomSheetConfig = {\n /** @default true */\n enabled?: boolean;\n /** Число — px, строка — CSS; 'auto' — по содержимому. Проценты — от рабочей области. @default 32 */\n height?: string | number;\n /** Минимальная высота, ограниченная доступным пространством. @default 32 */\n minHeight?: string | number;\n /** Максимальная высота в px или CSS, дополнительно ограниченная доступным пространством. */\n maxHeight?: string | number;\n /** Пользователь управляет содержимым и раскрытием; при height: 'auto' панель прокручивается сама. */\n content: React.ReactNode;\n};\n\nexport function activeViewIs<T extends 'cards' | 'rows'>(\n checkType: T,\n viewState: 'cards' | 'rows',\n view: View,\n): view is ViewMods[T] {\n return checkType === viewState;\n}\n\n/** Размер controlBlock: 'm' и 's' — одинаковые стили, 'xs' — уменьшенный */\nexport type ControlBlockSize = 'm' | 's' | 'xs';\n\nexport type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * Размер controlBlock и его элементов (кнопки, иконки, поиск, отступы).\n * 'm' и 's' — стандартные стили, 'xs' — компактный режим.\n * Не влияет на customFeatures и кастомные слоты — они контролируются разработчиком.\n * @default 'm'\n */\n size?: ControlBlockSize;\n /**\n * @deprecated Используйте кастомные кнопки через rightSideInner или customFeatures.\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока.\n * Продолжает работать для обратной совместимости.\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * customFeatures - пропс для добавления кастомных фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\n /**\n * pinningMenu - нативная фича закрепления столбцов (SplitIconButton с\n * дропдауном) в правой зоне иконок. Появляется, когда активировано\n * закрепление колонок (columnsControl.pinning). Продукт может донастроить\n * и дополнить пункты меню (см. PinningMenuConfig).\n */\n pinningMenu?: PinningMenuConfig;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты левые фичи при адаптивной компрессии\n */\n leftSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты правые фичи при адаптивной компрессии\n */\n rightSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Активна ли фича компрессии (сжатие ToolsMenu при адаптиве)\n * @default true\n */\n enableAdaptiveCompress?: boolean;\n /**\n * Панель массовых действий\n */\n massActionPanel?: {\n /**\n * Кнопки панели. Размеры кнопок/дропдаунов панель подбирает сама (по `size` панели и компактности) —\n * передавать `size` кнопкам не нужно. Если `size` на кнопке всё же задан — он используется как есть.\n */\n buttons: MassActionButtonProps[];\n /**\n * Пропсы для Dropdown, в который сжались кнопки\n */\n collapsedDropdownProps?: TableDropdownConfigProps;\n /**\n * Отступ панели снизу от контейнера (px)\n * @default 24\n */\n bottom?: number;\n /**\n * Управление отображением панели массовых действий.\n * - `undefined` (по умолчанию) — стандартное поведение (показывается при selecting + выбранных строках)\n * - `false` — панель не рендерится, разработчик управляет действиями самостоятельно\n * - `true` — панель показывается всегда, даже без активного selecting и выбранных строк\n */\n show?: boolean;\n /**\n * Размерная сетка панели внутри таблицы: `m`/`s` — обычный размер, `xs` — уменьшенный (кнопки `xxs`, «ещё» `xs`, счётчик Body XS).\n * Viewport-логика (1280) в таблице не используется.\n * @default 's'\n */\n size?: MassActionsSize;\n };\n};\n\n/** Пропсы кнопки редактирования. onClick исключён — используйте onSave/onCancel/onEnableEditing. */\nexport type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n\nexport type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n\nexport type SummaryRowsConfig = {\n showDefault: boolean;\n showInControl: boolean;\n /**\n * callback при переключении тогла «Итоговые строки» в настройках таблицы.\n * Вызывается только по действию пользователя (не при монтировании),\n * поэтому подходит для сохранения выбора, например, в localStorage.\n * Сохранённое значение передавайте обратно в `showDefault`.\n */\n onChange?: (checked: boolean) => void;\n} & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\n/**\n * Конфиг тултипа при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\nexport type TableConfigTooltip = {\n /**\n * Включить/выключить колоночные и кастомные тултипы (cellTooltip, headerCellTooltip).\n * Внутренние тултипы (drag-иконка в шапке и другие по nodeId) работают всегда.\n * @default false\n */\n enabled?: boolean;\n /** Глобальная задержка перед показом тултипа (мс). Per-node переопределяет. @default 500 */\n mouseEnterDelay?: number;\n /** Глобальная задержка перед скрытием тултипа (мс). Per-node переопределяет. @default 0 */\n mouseLeaveDelay?: number;\n /**\n * Минимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n minWidth?: number | string;\n /**\n * Максимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n maxWidth?: number | string;\n};\n\nexport type InfinityScrollConfig<RowType extends ObjectForExtending> = {\n /** Триггер достижения скроллом зоны подгрузки данных. */\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n /** Состояние загрузки (скелетоны) новых строк. */\n isLoading: boolean;\n /**\n * Флаг, когда все данные загружены — false.\n * @default true\n */\n hasMore?: boolean;\n /**\n * Для mode='region': за сколько строк до конца триггерить загрузку.\n * @default 5\n */\n rowThreshold?: number;\n};\n\nexport type { TableCanvasEmptyStateConfig, TableCanvasErrorStateConfig };\n\n/**\n * Настройка выделения ячеек/колонок/строк в TableCanvas — единый объект.\n * Это отдельная ось взаимодействия — не зависит от `highlightActiveType`.\n */\nexport type CellsSelectionConfig = {\n /**\n * Режим фактического выделения ячеек (нативный glide selection). По нему\n * работают copy/paste, рамка, fill-handle и затемнение шапки/нумерации.\n * @default \"range-cell\"\n */\n mode?: CellsSelectionMode;\n /**\n * Выделение колонок по клику на шапку. Ctrl/Cmd — добавить/убрать колонку,\n * Shift — диапазон колонок. Клик по иконкам сортировки/фильтрации в шапке\n * выделение НЕ вызывает. Поддерживает copy/paste по выделенным колонкам.\n * @default true\n */\n enableColumnSelection?: boolean;\n /**\n * Выделение строк по клику/драгу на колонке нумерации (`rowMarkers`).\n * Ctrl/Cmd — несмежный выбор отдельных строк, драг — смежный диапазон.\n * Поддерживает copy/paste по выделенным строкам. Требует включённой колонки\n * нумерации (`rowMarkers`). При `false` клик по нумерации ничего не выделяет.\n * @default true\n */\n enableRowSelection?: boolean;\n /**\n * Выделение всей таблицы кликом по «нулевой» ячейке — шапке колонки нумерации\n * (левый верхний угол). Выделяет все строки данных по всем колонкам одним\n * диапазоном; поддерживает copy/paste. Требует включённой колонки нумерации\n * (`rowMarkers`) и активного `mode` (≠ `disabled`).\n * @default true\n */\n enableSelectAll?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — он внутренний.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n};\n\n/** Один объединённый блок: какие строки и колонки слить. */\nexport type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n\n/**\n * Видимость сторон рамки ячейки: true рисовать, false не рисовать, не задано -\n * работает уровень ниже (настройка колонки, строки или общая).\n */\nexport type CellBorderVisibility = {\n top?: boolean;\n right?: boolean;\n bottom?: boolean;\n left?: boolean;\n};\n\n/**\n * Управление рамками (линиями) таблицы: включение и выключение. Уровни, от\n * слабого к сильному: общие настройки (vertical, horizontal), затем колонка\n * (getVerticalBorder) и строка (getHorizontalBorder), затем ячейка\n * (getCellBorder).\n */\nexport type BordersConfig<RowType = ObjectForExtending> = {\n /** Рисовать ли вертикальные линии между колонками. @default true */\n vertical?: boolean;\n /** Рисовать ли горизонтальные линии между строками тела. @default true */\n horizontal?: boolean;\n /**\n * Точечное управление вертикальной линией справа от колонки (разделитель\n * после неё). Вернуть true или false, чтобы переопределить общую настройку\n * vertical, или undefined, чтобы оставить её. Зовётся на каждую видимую\n * колонку при перерисовке, поэтому функция должна быть быстрой.\n */\n getVerticalBorder?: (params: {\n /** Ключ колонки, справа от которой рисуется линия. */\n columnKey: string;\n /** Индекс колонки в порядке отрисовки (закреплённые в начале). */\n columnIndex: number;\n }) => boolean | undefined;\n /**\n * Точечное управление горизонтальной линией сверху строки. Вернуть true или\n * false, чтобы переопределить общую настройку horizontal, или undefined,\n * чтобы оставить её. Для summary-строк не вызывается. Зовётся на каждую\n * видимую строку при перерисовке, поэтому функция должна быть быстрой.\n */\n getHorizontalBorder?: (params: {\n /** Строка под линией (линия рисуется сверху этой строки). */\n row: RowType;\n /** Индекс строки среди отображаемых. При раскрытии subRows индексы сдвигаются. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => boolean | undefined;\n /**\n * Стороны рамки конкретной ячейки, вкл и выкл. Для ячеек без переопределений\n * возвращать undefined. Включает отрисовку линий с разбивкой по ячейкам,\n * поэтому функция должна быть быстрой: без тяжёлых вычислений и с готовыми\n * объектами-константами вместо новых на каждый вызов. Для summary-строк не\n * вызывается.\n */\n getCellBorder?: (params: {\n /** Индекс колонки среди отображаемых (без служебных). */\n col: number;\n /** Ключ колонки. */\n columnKey: string | undefined;\n /** Строка ячейки. */\n row: RowType;\n /** Индекс строки среди отображаемых. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => CellBorderVisibility | undefined;\n};\n\nexport type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * Готовые варианты внешнего вида таблицы.\n *\n * `variant: 'clean'` — без линий сетки и внешних рамок, шапка на белом фоне\n * с серым текстом. Отдельные линии можно вернуть через `borders`.\n *\n * `zebra: true` — строки через одну окрашены серым, работает в любом варианте.\n */\n appearance?: AppearanceConfig;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@sber-digital-finance-ui/ui-kit';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n };\n /**\n * editing - активация редактирования. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={editing: {onRowsChange, rowKeyGetter}}\n *\n * columnConfig=[{editingCell: {...}}]\n */\n editing?: EditingConfig<RowType, RowIdType, SummaryRowType>;\n\n /**\n * cellTransfer — конфигурация копирования, вставки и fill handle.\n * По умолчанию копирование (Ctrl+C) работает в режиме редактирования.\n * Данные копируются в формате TSV (tab-separated values), совместимом с Excel.\n *\n * Пример:\n *\n * tableConfig={{ cellTransfer: { enabled: true, onBeforeCopy: (data) => data } }}\n */\n cellTransfer?: CellTransferConfig;\n\n /**\n * Объединение ячеек тела таблицы.\n *\n * mergeByCellValues — колонки, в которых подряд идущие одинаковые значения\n * сливаются в один блок (по вертикали). Границы блоков таблица считает сама из\n * данных; сортировка и фильтр их пересобирают. Данные не меняются — значение и\n * так повторяется в строках, объединение лишь показывает его одной ячейкой.\n *\n * mergedCellsRegions — список блоков, заданных снаружи (как выделение): каждый\n * блок описан ключами строк (rowKeys) и колонок (colKeys). Нужен rowKeyGetter.\n * Если после сортировки или скрытия колонок строки/колонки блока перестали идти\n * подряд — блок не рисуется. Важнее mergeByCellValues.\n *\n * Примеры: mergeCells={{ mergeByCellValues: ['dept', 'role'] }},\n * mergeCells={{ mergedCellsRegions, rowKeyGetter: (r) => r.id }}.\n */\n mergeCells?: {\n mergeByCellValues?: Array<\n string | { colKey: string; value: (row: RowType) => unknown }\n >;\n /** Список блоков, заданных снаружи (по ключам строк и колонок). */\n mergedCellsRegions?: MergedCellsRegion[];\n /**\n * Нужен для mergedCellsRegions: находит строку по её ключу. Должна быть\n * стабильной функцией; менять её на лету не нужно — в пересборку таблицы она\n * не входит.\n */\n rowKeyGetter?: (row: RowType) => string | number;\n /**\n * Выравнивание по умолчанию для всех блоков. Колоночный mergedCellsAlign и\n * выравнивание конкретного региона важнее.\n */\n mergedCellsAlign?: MergedCellsAlign;\n };\n\n /**\n * Модуль нотификаций: стандартизированный канал событий для внешних\n * потребителей. Таблица UI не рисует — вызывает `onNotification`, потребитель\n * показывает тост/модалку на своей стороне. Сейчас эмитятся ошибки copy/paste\n * (в т.ч. multi-range 2D-разброс, readonly/overflow-abort, пропуск валидацией).\n */\n notifications?: TableNotificationsConfig;\n\n /**\n * subRows - активация иерархии, отображения вложенных строк. Условие активации - наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={subRows: {getSubRows, rowKeyGetter}}\n *\n * columnConfig=[{subRow: {...}}]\n */\n subRows?: SubRows<RowType, RowIdType>;\n /**\n * Столбец с нумерацией строк.\n * Активируется наличием этого свойства. Поддерживает `subRows` любой глубины.\n *\n * @see {@link RowMarkersTableConfig} — полное описание конфигурации и примеры.\n */\n rowMarkers?: RowMarkersTableConfig<RowType>;\n rowsGrouping?: RowsGrouping<RowType, SummaryRowType>;\n\n /**\n * resizableColumn - активация изменения ширины колонки с помощью курсора. Условие активации - resizableColumn: true. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={resizableColumn: true}\n *\n * columnConfig=[{resizable: true}]\n */\n resizableColumn?: boolean;\n /**\n * style - inline-стили. Для стилей самой таблицы (без вложенности).\n *\n * Исключены свойства 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'. Их следует стилизовать через свойства containerStyle.\n */\n style?: Omit<\n CSSProperties,\n 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'\n >;\n /**\n * css - для стилей простых и сложных(например, для стилизации cell, headerCell, ...).\n *\n * Пример:\n *\n * ```css\n * & > .rdg-header-row > .rdgCell {\n * background-color: red;\n * }\n * ```\n *\n */\n css?: string | CSSObject;\n\n summaryRows?: SummaryRowsConfig;\n /**\n * controlBlock - пропс для активации, кастомизации контролблока.\n */\n controlBlock?: ControlBlockConfig;\n /**\n * containerStyle - инлайновые стили контейнера таблицы и контролблока. высоту и ширину для таблицы рекомендуется задавать в этом пропсе.\n * Пример:\n *\n * ```tsx\n tableConfig={{ containerStyle: { height: '70vh' } }}\n * ```\n */\n containerStyle?: CSSProperties | undefined;\n /**\n * containerCss - стили для контейнера таблицы и контролблока.\n * Через этот пропс можно дополнительно кастомизировать контейнер и все его дочерние элементы.\n */\n containerCss?: string | CSSObject | undefined;\n /**\n * containerId - html-атрибут id контейнера таблицы.\n */\n containerId?: string | undefined;\n\n /**\n * unstickyHeader - откреплённая шапка. Header уезжает вместе со скроллом контента.\n * @default false\n */\n unstickyHeader?: boolean;\n\n /**\n * stickyColumns - колонки, которые прилипают к левому краю при горизонтальной прокрутке,\n * как `position: sticky`. Ключи колонок или предикат по колонке.\n *\n * ```tsx\n * tableConfig={{ stickyColumns: ['region', 'total'] }}\n * tableConfig={{ stickyColumns: (column) => column.key.startsWith('total') }}\n * ```\n */\n stickyColumns?: StickyColumnsConfig<ColumnConfig<RowType, SummaryRowType>>;\n\n /**\n * stickyRows - строки, которые прилипают под шапкой при вертикальной прокрутке.\n * Предикат проверяется для каждой отображаемой строки данных (результаты кешируются); строки групп\n * (`rowsGrouping`) и заглушки загрузки в него не попадают и липкими не становятся.\n * Индексы передаются как есть — удобно для больших таблиц, где позиции известны заранее. Они\n * считаются по итоговому отображаемому списку: сортировка, фильтры, группировка и раскрытые узлы\n * дерева (`subRows`) сдвигают нумерацию — тогда индексы нужно пересчитывать или передать предикат.\n *\n * ```tsx\n * tableConfig={{ stickyRows: (row) => row.isSubtotal }}\n * tableConfig={{ stickyRows: [0, 41, 82] }}\n * ```\n */\n stickyRows?: StickyRowsConfig<RowType>;\n\n /** Тултип при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\n tooltip?: TableConfigTooltip;\n\n /**\n * infinityScroll - бесконечная подгрузка данных при скролле.\n *\n * Условие активации - наличие самого пропса infinityScroll.\n *\n * При активации infinityScroll отключается дефолтная сортировка и фильтрация.\n * (Предполагается, что если есть infinityScroll,\n * то в таблице представлен не весь объем данных,\n * по этой причине дефолтная сортировка и фильтрация не подходят и будут отображать некорректные данные)\n *\n */\n infinityScroll?: InfinityScrollConfig<RowType>;\n /**\n * @isLoading - состояние загрузки данных для таблицы.\n */\n isLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n /**\n * loadingOverlay - конфигурация для отображения оверлея загрузки.\n * Показывает индикатор загрузки поверх таблицы с возможностью кастомизации.\n */\n loadingOverlay?: {\n /**\n * Активен ли оверлей загрузки\n * @default true\n */\n active?: boolean;\n /**\n * Кастомный компонент спиннера\n * @default <Spinner view=\"secondary\" size=\"36\" /> (внутренний компонент)\n */\n spinner?: ReactNode;\n /**\n * Основной заголовок оверлея\n * @default \"Загрузка таблицы\"\n */\n title?: string;\n /**\n * Подзаголовок, который появится после задержки, пустая строка - значит он не появится\n * @default \"\"\n */\n subtitle?: string;\n /**\n * Задержка перед показом подзаголовка (мс)\n * @default 10000 (10 секунд)\n */\n showSubtitleDelay?: number;\n };\n /**\n * Empty state внутри content-области canvas-таблицы.\n * Не заменяет control block, header или pagination.\n */\n emptyState?: TableCanvasEmptyStateConfig;\n /**\n * Error state внутри content-области canvas-таблицы.\n * Не заменяет control block, header или pagination.\n */\n errorState?: TableCanvasErrorStateConfig;\n // FIXME:\n // noRowsFallback?: boolean | { custom: ReactNode };\n columnsControl?: ColumnsControlConfig;\n // FIXME:\n // rowDetailPanel?: RowDetailConfig<RowType>;\n // FIXME: Временно комментирую использование, пока не адаптируем TableCanvas\n // rowInstruments?: {\n // getRowDropdownConfig: RowInstrumentsType<RowType>;\n // /**\n // * @default false\n // */\n // defaultOpened?: boolean;\n // /**\n // * @default true\n // */\n // showInControl?: boolean;\n // /**\n // * Внешний стейт видимости\n // */\n // openedState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n // };\n fullScreenEnabled?: FullScreen;\n /**\n * Переносит портал editor overlay внутрь контейнера таблицы вместо document.body.\n * Решает проблему focus trap и сдвига координат при рендере таблицы в модалке с CSS transform.\n * @default undefined (overlay рендерится в document.body — стандартное поведение)\n */\n editorOverlayPortal?: 'inside';\n keyText?: boolean | KeyTextConfig;\n /**\n * pagination - пропс для пагинации.\n *\n * Условие активации - наличие самого пропса pagination.\n *\n * При активации pagination отключается дефолтные поиск, сортировка и фильтрация.\n * (поиск работает на уровне с фильтрацией и сортировкой, сначала поиск, затем фильтрация, затем сортировка)\n *\n */\n pagination?: PaginationProps;\n /**\n * searching - пропс для поиска по таблицу.\n *\n * Условие активации - наличие searching.enabled: true\n *\n */\n /**\n * Конфигурация табов в сайдбаре\n */\n /** @deprecated Используйте rightSidebarConfig. При наличии обоих приоритет у rightSidebarConfig. */\n sidebarConfig?: SidebarConfig;\n /** Конфигурация правой панели. */\n rightSidebarConfig?: RightSidebarConfig;\n /** Конфигурация пользовательских вкладок левой панели (режим строк). */\n leftSidebarConfig?: LeftSidebarConfig;\n /** Нижний слот в режиме строк. Не увеличивает внешний контейнер таблицы. */\n bottomSheetConfig?: BottomSheetConfig;\n searching?: SearchingProps;\n /**\n * onHeaderContextMenu - callback открытия контекстного меню.\n */\n onHeaderContextMenu?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onHeaderContextMenu'];\n onHeaderContextMenuDropdown?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onHeaderContextMenuDropdown'];\n onCellContextMenuDropdown?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onCellContextMenuDropdown'];\n onCellContextMenu?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onCellContextMenu'];\n /**\n * Обработчик клика по ячейке.\n *\n * Получает `cell` readonly [colIndex, rowIndex] от glide, и `info` обогащённый объект\n * с row, column, ctxs, refTable (аналогично onCellContextMenu).\n */\n onCellClicked?: (\n cell: readonly [number, number],\n info: TableInfoWithRow<RowType, SummaryRowType>,\n ) => void;\n} & GlideInstanceOmitted<RowType, SummaryRowType>;\n\ntype GlideInstanceOmitted<\n RowType extends ObjectForExtending,\n SummaryRowType,\n> = Pick<\n Omit<\n TableGlideInstanceProps<RowType, SummaryRowType>,\n | keyof TableGlideCustomProps<RowType, SummaryRowType>\n | 'CellReadOnlyEditor' /* CellReadOnlyEditor - свойство только для GlideInstance */\n >,\n | 'className'\n | 'columnSelect'\n | 'minColumnWidth'\n | 'maxColumnWidth'\n | 'maxColumnAutoWidth'\n | 'onVisibleRegionChanged'\n | 'onCellClicked'\n // | 'CellReadOnlyEditor'\n // | 'onGroupHeaderClicked'\n | 'onHeaderClicked'\n | 'onItemHovered'\n | 'trapFocus'\n | 'onColumnResize'\n>;\nexport type CellReadOnlyEditorProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n> = CellReadOnlyEditorGlideInstanceStaticProps &\n EditingCellInfo<RowType, SummaryRowType>;\n\n// & Pick<\n// DataGridPropsDefault<RowType, SummaryRowType, RowIdType>,\n// | 'summaryRowHeight'\n// | 'onFill'\n// | 'onCopy'\n// | 'onPaste'\n// | 'onCellClick'\n// | 'onCellDoubleClick'\n// | 'onCellContextMenu'\n// | 'onCellKeyDown'\n// | 'onSelectedCellChange'\n// | 'onScroll'\n// | 'onColumnResize'\n// | 'onColumnsReorder'\n// | 'enableVirtualization'\n// | 'rowClass'\n// | 'data-testid'\n// | 'headerRowHeight'\n// >;\n\n/**\n * Конфигурация фичи rowMarkers (столбец с нумерацией строк).\n *\n * Столбец frozen, вставляется первым, исключён из reorder/pin/hide/sort/grouping.\n * Поддерживает плоский и древовидный (`subRows`) режимы любой глубины вложенности.\n *\n * **Дефолтное поведение** (без `getRowMarker`): root-only нумерация —\n * корневые строки получают номер (`startIndex + rootIndex`), дочерние — пустую строку.\n *\n * @example\n * ```tsx\n * // Минимальная конфигурация\n * tableConfig={{ rowMarkers: { startIndex: 1 } }}\n *\n * // Сквозная стабильная нумерация\n * tableConfig={{ rowMarkers: { getRowMarker: ({ flatIndex }) => flatIndex + 1 } }}\n * ```\n */\nexport type RowMarkersTableConfig<\n RowType extends ObjectForExtending = ObjectForExtending,\n> = {\n /**\n * Стартовый индекс нумерации (для дефолтной логики без `getRowMarker`).\n * @default 1\n */\n startIndex?: number;\n\n /**\n * Ширина столбца с нумерацией (в px).\n * Если задан `size` — он приоритетнее.\n+ * Если ни `size`, ни `width` не заданы — ширина подстраивается\n+ * под глобальный `tableConfig.rowSize` (small=20, medium=32, big=48).\n * @default 32\n */\n width?: number;\n /**\n * Размер столбца. Приоритетнее `width`.\n * - `xs` = 20px\n * - `s` = 32px\n * - `m` = 48px\n */\n size?: 'xs' | 's' | 'm';\n /**\n * Кастомная функция нумерации. Полностью переопределяет дефолтную root-only логику.\n * Вызывается при рендере каждой ячейки столбца нумерации.\n *\n * ⚠️ Вызывается не только при полной отрисовке таблицы, но и при ховере/скролле —\n * для **одной** ячейки. Не используйте внешние переменные-счётчики —\n * используйте аргументы (`siblingPath`, `flatIndex` и др.), они всегда актуальны.\n *\n * @example\n * // Сквозная стабильная нумерация (все строки, номера не прыгают при сворачивании)\n * getRowMarker: ({ flatIndex }) => flatIndex + 1\n *\n * @example\n * // Корневые — номер, дочерние — прочерк\n * getRowMarker: ({ isSubRow, flatIndex }) => isSubRow ? '—' : flatIndex + 1\n *\n * @example\n * // Иерархическая нумерация любой глубины: 1, 1.1, 1.1.1, 1.2, 2\n * getRowMarker: ({ siblingPath }) => siblingPath.map(i => i + 1).join('.')\n */\n getRowMarker?: (args: {\n /** Данные текущей строки. */\n row: RowType;\n /** Уровень строки в дереве: `0` — корневая, `1` — дочерняя, `2` — внучка, и т.д. */\n level: number;\n /** `true`, если строка дочерняя (`level > 0`). */\n isSubRow: boolean;\n /**\n * Индекс строки в **видимых** строках.\n * **Нестабильный** — меняется при сворачивании и разворачивании веток.\n */\n rowIndex: number;\n /**\n * Стабильный 0-based индекс строки в **полном** дереве (включая скрытые/свёрнутые).\n * Не меняется при collapse/expand — подходит для сквозной нумерации.\n */\n flatIndex: number;\n /**\n * Порядковый номер среди siblings одного родителя (0-based).\n * Для корневых строк — порядковый номер среди всех корневых.\n * Для дочерних — порядковый номер среди children одного `parentKey`.\n */\n siblingIndex: number;\n /**\n * Путь siblingIndex-ов от корня до текущей строки (каждый элемент 0-based).\n *\n * Примеры:\n * - корневая строка (2-я): `[1]`\n * - дочерняя (3-й ребёнок 2-го корня): `[1, 2]`\n * - внучка (1-й ребёнок 1-го ребёнка 1-го корня): `[0, 0, 0]`\n *\n * Для иерархической нумерации: `siblingPath.map(i => i + 1).join('.')` → `\"1.1.1\"`\n *\n * Для плоской таблицы (без subRows): всегда `[siblingIndex]` (один элемент).\n */\n siblingPath: number[];\n /**\n * Ключ родительской строки (`rowKeyGetter(parent)`).\n * `null` для корневых строк. Работает для **любой** глубины вложенности.\n */\n parentKey: string | number | null;\n /** Текущий видимый `flattened` массив строк. */\n rows: readonly RowType[];\n }) => string | number;\n};\n```\n\n## FilterComponentInPopoverProps\n\nПропсы, доступные в кастомном компоненте фильтра (`component: 'custom'`).\n\n```typescript\ntype FilterComponentInPopoverProps<\n FilterStateType extends ObjectForExtending,\n ColumnConfig,\n> = {\n popoverIsOpen: boolean;\n setPopoverIsOpen: React.Dispatch<React.SetStateAction<boolean>>;\n columnConfig: ColumnConfig;\n tabIndex: number;\n headerContextState: HeaderContextValueTypeInstance<FilterStateType> &\n FiltersVariables &\n HeaderContextValueTypeInstance<ObjectForExtending>;\n /**\n * Источник открытия фильтра: из шапки таблицы или из сайдбара\n * Полезно для условной логики в customRender (например, alwaysOpened для combobox)\n */\n filterSource?: 'header' | 'sidebar';\n};\n```",
49840
49870
  "api": [
49841
49871
  {
49842
49872
  "typeName": "FilteringConfig",
49843
- "source": "type FilteringConfig<T> = {\n state: [T, React.Dispatch<React.SetStateAction<T>>];\n /**\n * @deprecated Использовать filtersInfo\n *\n * clearedValue - состояние фильтров после очистки. Используется для сравнения:\n * Например, был ли фильтр конкретной колонки изменен рассчитывается посредством сравнения текущего значения фильтра и значения фильтра в clearedValue.\n * Если они равны, то фильтр считается не измененным.\n */\n clearedValue?: T;\n /**\n * Информация о фильтрах для каждой колонки.\n * Используется для:\n * 1. Хранения меток (label) фильтров для отображения в UI\n * 2. Хранения значений по умолчанию (clearedValue) для каждого фильтра\n * 3. Определения, был ли фильтр изменен (сравнение текущего значения с clearedValue)\n */\n filtersInfo?: Record<\n keyof T,\n {\n label: string;\n clearedValue: T[keyof T];\n }\n >;\n /**\n * manualFiltering - пропс, активирующий ручную-кастомную (или на стороне бэка) фильтрацию.\n * @remarks\n * Для автоматической фильтрации (когда не используется manualFiltering в tableConfig):\n * - Для всех типов фильтров обязательно должен быть указан `valueInRow`\n * - Для component: 'select' дополнительно должен быть указан `filteringType`\n * - Для component: 'input' с кастомным фильтром (когда filter - функция)\n * функция фильтрации должна быть передана явно\n *\n * Если используется manualFiltering, эти параметры не обязательны,\n * так как вся логика фильтрации реализуется извне.\n */\n manualFiltering?: boolean;\n /**\n * Конфигурация для отображения фильтров в правом сайдбаре.\n *\n * Позволяет:\n * 1. Добавлять глобальные фильтры (не привязанные к конкретной колонке)\n * 2. Управлять порядком отображения фильтров\n * 3. Переопределять рендер и заголовки колоночных фильтров\n *\n * Логика работы:\n * - По умолчанию в сайдбаре отображаются все колоночные фильтры (из columnConfig)\n * - Ключом фильтра считается `key` колонки, если его нет, то пытаемся взять `keyInFilterState` (если указан), иначе это не будет работать\n * - Заголовком фильтра по умолчанию является `name` колонки или ключ фильтра (name || key)\n * - Глобальные фильтры добавляются через `items` с уникальными ключами\n *\n * Особенности:\n * 1. Порядок отображения:\n * - Сначала фильтры из `order` (в указанной последовательности)\n * - Затем остальные колоночные фильтры (в порядке columnConfig)\n * - В конце - глобальные фильтры (в алфавитном порядке ключей)\n *\n * 2. Переопределение колоночных фильтров:\n * - Чтобы изменить заголовок: укажите ключ колонки в `items` с новым `label`\n * - Чтобы заменить рендер: укажите ключ колонки с `customRenderFn`\n * - Оригинальный фильтр из колонки будет проигнорирован\n *\n * 3. Глобальные фильтры:\n * - Ключ не должен совпадать с ключами колонок\n * - Обязательно указать `label` и `customRenderFn`\n * - Отображаются после всех колоночных фильтров, если не переопределены в order\n *\n * @example\n * // Добавление глобального фильтра и изменение порядка\n * sidebarConfig: {\n * order: ['status', 'tasks', 'type'], // Сначала статус, затем глобальный поиск\n * items: {\n * tasks: { // Уникальный ключ\n * label: 'Поиск по всем полям',\n * customRenderFn: () => <TaskComponent />\n * },\n * status: { // Переопределение колоночного фильтра\n * label: 'Статус заявки', // Новый заголовок\n * customRenderFn: () => <CustomStatusFilter /> // Кастомный рендер\n * }\n * type: { // Переопределение только Label колоночного фильтра\n * label: 'Тип', // Новый заголовок\n * }\n * }\n * }\n */\n sidebarConfig?: {\n /**\n * Определяет порядок отображения фильтров.\n * - Указываются ключи фильтров (колоночных или глобальных)\n * - Не указанные в order фильтры отображаются после\n * - Если order пуст, сохраняется порядок: глобальные фильтры + columnConfig фильтры в конце\n */\n order?: string[];\n /**\n * Конфигурация фильтров для сайдбара.\n * Ключом может быть:\n * - Ключ колонки (для переопределения колоночного фильтра)\n * - Уникальный ключ (для добавления глобального фильтра)\n */\n items: Partial<\n Record<\n keyof T,\n {\n /** Заголовок фильтра (обязателен для глобальных фильтров), можно использовать для переопределения для локальных фильтров */\n label: string;\n /**\n * Функция рендера компонента фильтра.\n * Для колоночных фильтров переопределяет оригинальный рендер.\n * Для глобальных фильтров обязательна.\n */\n customRenderFn?: (\n filters: T,\n setFilters: React.Dispatch<React.SetStateAction<T>>,\n ) => React.ReactNode;\n }\n >\n >;\n };\n /**\n * Callback для кастомизации стилей чипсов (фильтров) в списке\n *\n * @param {ItemOrGroup} itemOrGroup - Текущий элемент или группа фильтров\n * @param {Item | undefined} item - Конкретный элемент фильтра (если есть)\n * @returns {CSSObject} Объект стилей, который будет применен к чипсу\n *\n * @description\n * Позволяет динамически задавать стили для каждого чипса в зависимости от его типа и содержимого.\n * Вызывается для каждого отображаемого чипса (как для отдельных элементов, так и для элементов внутри групп).\n *\n * @example\n * // Пример 1: Стилизация чипсов по типу\n * chipStyle: (itemOrGroup, item) => {\n * if (isGroup(itemOrGroup)) {\n * return { backgroundColor: '#f0f0f0' };\n * }\n * return { backgroundColor: '#e0e0e0' };\n * }\n *\n * @example\n * // Пример 2: Стилизация по значению фильтра\n * chipStyle: (itemOrGroup, item) => {\n * if (item?.label === 'Высокий приоритет') {\n * return {\n * backgroundColor: '#ffebee',\n * color: '#d32f2f'\n * };\n * }\n * return {};\n * }\n *\n * @example\n * // Пример 3: Разные стили для элементов в группе и одиночных\n * chipStyle: (itemOrGroup, item) => {\n * if (item) {\n * // Стиль для элемента внутри группы\n * return { maxWidth: 180 };\n * }\n * // Стиль для одиночного чипа\n * return { maxWidth: 150 };\n * }\n */\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n /**\n * Пользовательский форматтер заголовка группы чипсов.\n *\n * Используется в блоке активных фильтров для подмены текста заголовка\n * группы (например, “Статус”, “Тип”, “Автор”). Полезно, когда нужно\n * динамически менять подпись (добавить счётчик, i18n и т.п.).\n *\n * @param {ItemOrGroup} itemOrGroup Объект группы (тип Group). Вызов происходит только для групп,\n * поэтому безопасно кастовать к Group.\n * @returns {string} Текст заголовка группы чипсов.\n *\n * @default Возвращается `group.groupLabel`.\n *\n * @remarks\n * - Функция должна быть чистой и быстрой (без сетевых запросов и побочных эффектов).\n * - Возвращайте ТОЛЬКО строку — чипы отображают текстовое значение.\n * - Для длинных строк применяется усечение (overflow с многоточием) на уровне компонента.\n *\n * @example\n * // Добавить двоеточие и количество выбранных элементов\n * renderGroupLabel: (group) => `${group.groupLabel}: ${group.items.length}`\n *\n * @example\n * // Локализация заголовка группы\n * const i18n = { status: 'Статус', type: 'Тип' };\n * renderGroupLabel: (group) => i18n[group.groupId] ?? group.groupLabel\n */\n renderGroupLabel?: (group: Group) => string;\n\n /**\n * Пользовательский форматтер текста чипса (элемента внутри группы или одиночного фильтра).\n *\n * Позволяет управлять тем, что именно отображается внутри каждого чипса. Особенно полезен\n * при серверной пагинации/ленивой загрузке, когда в состоянии фильтра хранится только value,\n * а label необходимо подставить из локального кэша.\n *\n * @param {Group | null } group Группа, внутри которой рендерится чип (или null).\n * @param {Item} item Сам элемент чипса. В группах передаётся конкретный `Item`,\n * для одиночного чипа может быть `undefined`.\n * @returns {string} Текст, который будет показан в чипсе.\n *\n * @default Используется `item?.label.toString()` (или строковое представление value).\n *\n * @remarks\n * - Функция должна быть чистой и быстрой;\n * - Возвращайте ТОЛЬКО строку.\n *\n * @example\n * // 1) Отображение label из кэша при серверной пагинации\n * const labelsCacheRef = useRef(new Map<string, string>());\n * renderChipLabel: (group, item) => {\n * if (item?.id != null) {\n * const key = String(item.id);\n * const fromCache = labelsCacheRef.current.get(key);\n * if (fromCache) return fromCache; // красивый label, если уже загрузили\n * return String(item.label ?? key); // фоллбэк: временно показываем value/label из item\n * }\n * return ''; // безопасный фоллбэк для одиночных случаев\n * }\n *\n * @example\n * // 2) Нормализация отображения числовых значений\n * renderChipLabel: (_group, item) => {\n * const v = Number(item?.label);\n * return Number.isFinite(v) ? v.toLocaleString('ru-RU') : String(item?.label ?? '');\n * }\n *\n * @example\n * // 3) Префикс по типу группы\n * renderChipLabel: (group, item) => {\n * const prefix = group.groupId === 'status' ? '' : '#';\n * return `${prefix}${item?.label ?? item?.id ?? ''}`;\n * }\n */\n renderChipLabel?: (group: Group | null, item: Item) => string;\n};\n\nexport type DefaultSidebarTabIds = 'columns' | 'tableSettings' | 'filtering';\n\n/**\n * Общие настройки пользовательских вкладок левой и правой панели TableCanvas.\n */\nexport type TableCanvasSidebarConfig = {\n /**\n * Включен ли sidebar. Отвечает только за UI. Не влияет на перерасчёт фичей.\n * @default true\n */\n enabled?: boolean;\n /**\n * Открыт ли sidebar при первом рендере (uncontrolled-режим).\n * Игнорируется, если передан openState.\n * @default false\n */\n defaultOpen?: boolean;\n /**\n * Внешний контроль открытия/закрытия sidebar.\n * Если передан — источник истины, defaultOpen игнорируется.\n */\n openState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * id вкладки, выбранной по умолчанию (актуально при открытом сайдбаре).\n * Если id не найден или у вкладки showInSidebar=false — используется первая доступная.\n */\n defaultActiveTabId?: string;\n /**\n * Внешний контроль активной вкладки (controlled-режим).\n * Если передан — источник истины, defaultActiveTabId игнорируется.\n */\n activeTabState?: [\n string | null,\n React.Dispatch<React.SetStateAction<string | null>>,\n ];\n /**\n * Колбэк смены активной вкладки. Вызывается и в uncontrolled-режиме.\n * При закрытии сайдбара приходит null.\n */\n onActiveTabChange?: (tabId: string | null, tab?: SidebarTab) => void;\n /**\n * Кастомные табы\n */\n customTabs?: Array<\n Omit<SidebarTab, 'id'> & {\n id: Exclude<string, DefaultSidebarTabIds>;\n }\n >;\n /**\n * Порядок отображения кастомных вкладок\n */\n customTabsOrder?: Array<Exclude<string, DefaultSidebarTabIds>>;\n /**\n * Ширина контента без полоски вкладок (44px). Число — px, строка — CSS.\n * Проценты считаются от ширины рабочей области TableCanvas.\n * Изменение пропса сразу меняет ширину открытой панели.\n * По умолчанию: 300px слева, 400px справа.\n */\n width?: string | number;\n};\n\n/** Настройки правой панели; встроенные вкладки доступны только справа. */\nexport type SidebarConfig = TableCanvasSidebarConfig & {\n defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара (если данный таб окажется единственным табом в настройках) */\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки (для табов с id = filtering и columns - недоступен. Настраивается через таб с id='tableSettings') */\n iconTooltipText?: undefined;\n }\n | {\n id: 'tableSettings';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара */\n title?: string;\n\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный слот для вкладки tableSettings (рендерится после общих настроек)\n * Только дл id: 'tableSettings'\n */\n customGeneralSettingsSlot?: React.ReactNode;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки @default 'Настройки' */\n iconTooltipText?: string;\n }\n >;\n};\n\n/** Конфигурация правой панели. SidebarConfig сохранён для совместимости. */\nexport type RightSidebarConfig = SidebarConfig;\n\n/** Пользовательские вкладки слева; встроенных вкладок настроек нет. */\nexport type LeftSidebarConfig = TableCanvasSidebarConfig;\n\n/** Нижний слот под canvas, над пагинацией, между боковыми панелями. */\nexport type BottomSheetConfig = {\n /** @default true */\n enabled?: boolean;\n /** Число — px, строка — CSS; 'auto' — по содержимому. Проценты — от рабочей области. @default 32 */\n height?: string | number;\n /** Минимальная высота, ограниченная доступным пространством. @default 32 */\n minHeight?: string | number;\n /** Максимальная высота в px или CSS, дополнительно ограниченная доступным пространством. */\n maxHeight?: string | number;\n /** Пользователь управляет содержимым и раскрытием; при height: 'auto' панель прокручивается сама. */\n content: React.ReactNode;\n};\n\nexport function activeViewIs<T extends 'cards' | 'rows'>(\n checkType: T,\n viewState: 'cards' | 'rows',\n view: View,\n): view is ViewMods[T] {\n return checkType === viewState;\n}\n\n/** Размер controlBlock: 'm' и 's' — одинаковые стили, 'xs' — уменьшенный */\nexport type ControlBlockSize = 'm' | 's' | 'xs';\n\nexport type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * Размер controlBlock и его элементов (кнопки, иконки, поиск, отступы).\n * 'm' и 's' — стандартные стили, 'xs' — компактный режим.\n * Не влияет на customFeatures и кастомные слоты — они контролируются разработчиком.\n * @default 'm'\n */\n size?: ControlBlockSize;\n /**\n * @deprecated Используйте кастомные кнопки через rightSideInner или customFeatures.\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока.\n * Продолжает работать для обратной совместимости.\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * customFeatures - пропс для добавления кастомных фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\n /**\n * pinningMenu - нативная фича закрепления столбцов (SplitIconButton с\n * дропдауном) в правой зоне иконок. Появляется, когда активировано\n * закрепление колонок (columnsControl.pinning). Продукт может донастроить\n * и дополнить пункты меню (см. PinningMenuConfig).\n */\n pinningMenu?: PinningMenuConfig;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты левые фичи при адаптивной компрессии\n */\n leftSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты правые фичи при адаптивной компрессии\n */\n rightSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Активна ли фича компрессии (сжатие ToolsMenu при адаптиве)\n * @default true\n */\n enableAdaptiveCompress?: boolean;\n /**\n * Панель массовых действий\n */\n massActionPanel?: {\n /**\n * Кнопки панели. Размеры кнопок/дропдаунов панель подбирает сама (по `size` панели и компактности) —\n * передавать `size` кнопкам не нужно. Если `size` на кнопке всё же задан — он используется как есть.\n */\n buttons: MassActionButtonProps[];\n /**\n * Пропсы для Dropdown, в который сжались кнопки\n */\n collapsedDropdownProps?: TableDropdownConfigProps;\n /**\n * Отступ панели снизу от контейнера (px)\n * @default 24\n */\n bottom?: number;\n /**\n * Управление отображением панели массовых действий.\n * - `undefined` (по умолчанию) — стандартное поведение (показывается при selecting + выбранных строках)\n * - `false` — панель не рендерится, разработчик управляет действиями самостоятельно\n * - `true` — панель показывается всегда, даже без активного selecting и выбранных строк\n */\n show?: boolean;\n /**\n * Размерная сетка панели внутри таблицы: `m`/`s` — обычный размер, `xs` — уменьшенный (кнопки `xxs`, «ещё» `xs`, счётчик Body XS).\n * Viewport-логика (1280) в таблице не используется.\n * @default 's'\n */\n size?: MassActionsSize;\n };\n};\n\n/** Пропсы кнопки редактирования. onClick исключён — используйте onSave/onCancel/onEnableEditing. */\nexport type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n\nexport type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n\nexport type SummaryRowsConfig = {\n showDefault: boolean;\n showInControl: boolean;\n /**\n * callback при переключении тогла «Итоговые строки» в настройках таблицы.\n * Вызывается только по действию пользователя (не при монтировании),\n * поэтому подходит для сохранения выбора, например, в localStorage.\n * Сохранённое значение передавайте обратно в `showDefault`.\n */\n onChange?: (checked: boolean) => void;\n} & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\n/**\n * Конфиг тултипа при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\nexport type TableConfigTooltip = {\n /**\n * Включить/выключить колоночные и кастомные тултипы (cellTooltip, headerCellTooltip).\n * Внутренние тултипы (drag-иконка в шапке и другие по nodeId) работают всегда.\n * @default false\n */\n enabled?: boolean;\n /** Глобальная задержка перед показом тултипа (мс). Per-node переопределяет. @default 500 */\n mouseEnterDelay?: number;\n /** Глобальная задержка перед скрытием тултипа (мс). Per-node переопределяет. @default 0 */\n mouseLeaveDelay?: number;\n /**\n * Минимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n minWidth?: number | string;\n /**\n * Максимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n maxWidth?: number | string;\n};\n\nexport type InfinityScrollConfig<RowType extends ObjectForExtending> = {\n /** Триггер достижения скроллом зоны подгрузки данных. */\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n /** Состояние загрузки (скелетоны) новых строк. */\n isLoading: boolean;\n /**\n * Флаг, когда все данные загружены — false.\n * @default true\n */\n hasMore?: boolean;\n /**\n * Для mode='region': за сколько строк до конца триггерить загрузку.\n * @default 5\n */\n rowThreshold?: number;\n};\n\nexport type { TableCanvasEmptyStateConfig, TableCanvasErrorStateConfig };\n\n/**\n * Настройка выделения ячеек/колонок/строк в TableCanvas — единый объект.\n * Это отдельная ось взаимодействия — не зависит от `highlightActiveType`.\n */\nexport type CellsSelectionConfig = {\n /**\n * Режим фактического выделения ячеек (нативный glide selection). По нему\n * работают copy/paste, рамка, fill-handle и затемнение шапки/нумерации.\n * @default \"range-cell\"\n */\n mode?: CellsSelectionMode;\n /**\n * Выделение колонок по клику на шапку. Ctrl/Cmd — добавить/убрать колонку,\n * Shift — диапазон колонок. Клик по иконкам сортировки/фильтрации в шапке\n * выделение НЕ вызывает. Поддерживает copy/paste по выделенным колонкам.\n * @default true\n */\n enableColumnSelection?: boolean;\n /**\n * Выделение строк по клику/драгу на колонке нумерации (`rowMarkers`).\n * Ctrl/Cmd — несмежный выбор отдельных строк, драг — смежный диапазон.\n * Поддерживает copy/paste по выделенным строкам. Требует включённой колонки\n * нумерации (`rowMarkers`). При `false` клик по нумерации ничего не выделяет.\n * @default true\n */\n enableRowSelection?: boolean;\n /**\n * Выделение всей таблицы кликом по «нулевой» ячейке — шапке колонки нумерации\n * (левый верхний угол). Выделяет все строки данных по всем колонкам одним\n * диапазоном; поддерживает copy/paste. Требует включённой колонки нумерации\n * (`rowMarkers`) и активного `mode` (≠ `disabled`).\n * @default true\n */\n enableSelectAll?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — он внутренний.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n};\n\n/** Один объединённый блок: какие строки и колонки слить. */\nexport type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n\n/**\n * Видимость сторон рамки ячейки: true рисовать, false не рисовать, не задано -\n * работает уровень ниже (настройка колонки, строки или общая).\n */\nexport type CellBorderVisibility = {\n top?: boolean;\n right?: boolean;\n bottom?: boolean;\n left?: boolean;\n};\n\n/**\n * Управление рамками (линиями) таблицы: включение и выключение. Уровни, от\n * слабого к сильному: общие настройки (vertical, horizontal), затем колонка\n * (getVerticalBorder) и строка (getHorizontalBorder), затем ячейка\n * (getCellBorder).\n */\nexport type BordersConfig<RowType = ObjectForExtending> = {\n /** Рисовать ли вертикальные линии между колонками. @default true */\n vertical?: boolean;\n /** Рисовать ли горизонтальные линии между строками тела. @default true */\n horizontal?: boolean;\n /**\n * Точечное управление вертикальной линией справа от колонки (разделитель\n * после неё). Вернуть true или false, чтобы переопределить общую настройку\n * vertical, или undefined, чтобы оставить её. Зовётся на каждую видимую\n * колонку при перерисовке, поэтому функция должна быть быстрой.\n */\n getVerticalBorder?: (params: {\n /** Ключ колонки, справа от которой рисуется линия. */\n columnKey: string;\n /** Индекс колонки в порядке отрисовки (закреплённые в начале). */\n columnIndex: number;\n }) => boolean | undefined;\n /**\n * Точечное управление горизонтальной линией сверху строки. Вернуть true или\n * false, чтобы переопределить общую настройку horizontal, или undefined,\n * чтобы оставить её. Для summary-строк не вызывается. Зовётся на каждую\n * видимую строку при перерисовке, поэтому функция должна быть быстрой.\n */\n getHorizontalBorder?: (params: {\n /** Строка под линией (линия рисуется сверху этой строки). */\n row: RowType;\n /** Индекс строки среди отображаемых. При раскрытии subRows индексы сдвигаются. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => boolean | undefined;\n /**\n * Стороны рамки конкретной ячейки, вкл и выкл. Для ячеек без переопределений\n * возвращать undefined. Включает отрисовку линий с разбивкой по ячейкам,\n * поэтому функция должна быть быстрой: без тяжёлых вычислений и с готовыми\n * объектами-константами вместо новых на каждый вызов. Для summary-строк не\n * вызывается.\n */\n getCellBorder?: (params: {\n /** Индекс колонки среди отображаемых (без служебных). */\n col: number;\n /** Ключ колонки. */\n columnKey: string | undefined;\n /** Строка ячейки. */\n row: RowType;\n /** Индекс строки среди отображаемых. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => CellBorderVisibility | undefined;\n};\n\nexport type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *"
49873
+ "source": "type FilteringConfig<T> = {\n state: [T, React.Dispatch<React.SetStateAction<T>>];\n /**\n * @deprecated Использовать filtersInfo\n *\n * clearedValue - состояние фильтров после очистки. Используется для сравнения:\n * Например, был ли фильтр конкретной колонки изменен рассчитывается посредством сравнения текущего значения фильтра и значения фильтра в clearedValue.\n * Если они равны, то фильтр считается не измененным.\n */\n clearedValue?: T;\n /**\n * Информация о фильтрах для каждой колонки.\n * Используется для:\n * 1. Хранения меток (label) фильтров для отображения в UI\n * 2. Хранения значений по умолчанию (clearedValue) для каждого фильтра\n * 3. Определения, был ли фильтр изменен (сравнение текущего значения с clearedValue)\n */\n filtersInfo?: Record<\n keyof T,\n {\n label: string;\n clearedValue: T[keyof T];\n }\n >;\n /**\n * manualFiltering - пропс, активирующий ручную-кастомную (или на стороне бэка) фильтрацию.\n * @remarks\n * Для автоматической фильтрации (когда не используется manualFiltering в tableConfig):\n * - Для всех типов фильтров обязательно должен быть указан `valueInRow`\n * - Для component: 'select' дополнительно должен быть указан `filteringType`\n * - Для component: 'input' с кастомным фильтром (когда filter - функция)\n * функция фильтрации должна быть передана явно\n *\n * Если используется manualFiltering, эти параметры не обязательны,\n * так как вся логика фильтрации реализуется извне.\n */\n manualFiltering?: boolean;\n /**\n * Конфигурация для отображения фильтров в правом сайдбаре.\n *\n * Позволяет:\n * 1. Добавлять глобальные фильтры (не привязанные к конкретной колонке)\n * 2. Управлять порядком отображения фильтров\n * 3. Переопределять рендер и заголовки колоночных фильтров\n *\n * Логика работы:\n * - По умолчанию в сайдбаре отображаются все колоночные фильтры (из columnConfig)\n * - Ключом фильтра считается `key` колонки, если его нет, то пытаемся взять `keyInFilterState` (если указан), иначе это не будет работать\n * - Заголовком фильтра по умолчанию является `name` колонки или ключ фильтра (name || key)\n * - Глобальные фильтры добавляются через `items` с уникальными ключами\n *\n * Особенности:\n * 1. Порядок отображения:\n * - Сначала фильтры из `order` (в указанной последовательности)\n * - Затем остальные колоночные фильтры (в порядке columnConfig)\n * - В конце - глобальные фильтры (в алфавитном порядке ключей)\n *\n * 2. Переопределение колоночных фильтров:\n * - Чтобы изменить заголовок: укажите ключ колонки в `items` с новым `label`\n * - Чтобы заменить рендер: укажите ключ колонки с `customRenderFn`\n * - Оригинальный фильтр из колонки будет проигнорирован\n *\n * 3. Глобальные фильтры:\n * - Ключ не должен совпадать с ключами колонок\n * - Обязательно указать `label` и `customRenderFn`\n * - Отображаются после всех колоночных фильтров, если не переопределены в order\n *\n * @example\n * // Добавление глобального фильтра и изменение порядка\n * sidebarConfig: {\n * order: ['status', 'tasks', 'type'], // Сначала статус, затем глобальный поиск\n * items: {\n * tasks: { // Уникальный ключ\n * label: 'Поиск по всем полям',\n * customRenderFn: () => <TaskComponent />\n * },\n * status: { // Переопределение колоночного фильтра\n * label: 'Статус заявки', // Новый заголовок\n * customRenderFn: () => <CustomStatusFilter /> // Кастомный рендер\n * }\n * type: { // Переопределение только Label колоночного фильтра\n * label: 'Тип', // Новый заголовок\n * }\n * }\n * }\n */\n sidebarConfig?: {\n /**\n * Определяет порядок отображения фильтров.\n * - Указываются ключи фильтров (колоночных или глобальных)\n * - Не указанные в order фильтры отображаются после\n * - Если order пуст, сохраняется порядок: глобальные фильтры + columnConfig фильтры в конце\n */\n order?: string[];\n /**\n * Конфигурация фильтров для сайдбара.\n * Ключом может быть:\n * - Ключ колонки (для переопределения колоночного фильтра)\n * - Уникальный ключ (для добавления глобального фильтра)\n */\n items: Partial<\n Record<\n keyof T,\n {\n /** Заголовок фильтра (обязателен для глобальных фильтров), можно использовать для переопределения для локальных фильтров */\n label: string;\n /**\n * Функция рендера компонента фильтра.\n * Для колоночных фильтров переопределяет оригинальный рендер.\n * Для глобальных фильтров обязательна.\n */\n customRenderFn?: (\n filters: T,\n setFilters: React.Dispatch<React.SetStateAction<T>>,\n ) => React.ReactNode;\n }\n >\n >;\n };\n /**\n * Callback для кастомизации стилей чипсов (фильтров) в списке\n *\n * @param {ItemOrGroup} itemOrGroup - Текущий элемент или группа фильтров\n * @param {Item | undefined} item - Конкретный элемент фильтра (если есть)\n * @returns {CSSObject} Объект стилей, который будет применен к чипсу\n *\n * @description\n * Позволяет динамически задавать стили для каждого чипса в зависимости от его типа и содержимого.\n * Вызывается для каждого отображаемого чипса (как для отдельных элементов, так и для элементов внутри групп).\n *\n * @example\n * // Пример 1: Стилизация чипсов по типу\n * chipStyle: (itemOrGroup, item) => {\n * if (isGroup(itemOrGroup)) {\n * return { backgroundColor: '#f0f0f0' };\n * }\n * return { backgroundColor: '#e0e0e0' };\n * }\n *\n * @example\n * // Пример 2: Стилизация по значению фильтра\n * chipStyle: (itemOrGroup, item) => {\n * if (item?.label === 'Высокий приоритет') {\n * return {\n * backgroundColor: '#ffebee',\n * color: '#d32f2f'\n * };\n * }\n * return {};\n * }\n *\n * @example\n * // Пример 3: Разные стили для элементов в группе и одиночных\n * chipStyle: (itemOrGroup, item) => {\n * if (item) {\n * // Стиль для элемента внутри группы\n * return { maxWidth: 180 };\n * }\n * // Стиль для одиночного чипа\n * return { maxWidth: 150 };\n * }\n */\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n /**\n * Пользовательский форматтер заголовка группы чипсов.\n *\n * Используется в блоке активных фильтров для подмены текста заголовка\n * группы (например, “Статус”, “Тип”, “Автор”). Полезно, когда нужно\n * динамически менять подпись (добавить счётчик, i18n и т.п.).\n *\n * @param {ItemOrGroup} itemOrGroup Объект группы (тип Group). Вызов происходит только для групп,\n * поэтому безопасно кастовать к Group.\n * @returns {string} Текст заголовка группы чипсов.\n *\n * @default Возвращается `group.groupLabel`.\n *\n * @remarks\n * - Функция должна быть чистой и быстрой (без сетевых запросов и побочных эффектов).\n * - Возвращайте ТОЛЬКО строку — чипы отображают текстовое значение.\n * - Для длинных строк применяется усечение (overflow с многоточием) на уровне компонента.\n *\n * @example\n * // Добавить двоеточие и количество выбранных элементов\n * renderGroupLabel: (group) => `${group.groupLabel}: ${group.items.length}`\n *\n * @example\n * // Локализация заголовка группы\n * const i18n = { status: 'Статус', type: 'Тип' };\n * renderGroupLabel: (group) => i18n[group.groupId] ?? group.groupLabel\n */\n renderGroupLabel?: (group: Group) => string;\n\n /**\n * Пользовательский форматтер текста чипса (элемента внутри группы или одиночного фильтра).\n *\n * Позволяет управлять тем, что именно отображается внутри каждого чипса. Особенно полезен\n * при серверной пагинации/ленивой загрузке, когда в состоянии фильтра хранится только value,\n * а label необходимо подставить из локального кэша.\n *\n * @param {Group | null } group Группа, внутри которой рендерится чип (или null).\n * @param {Item} item Сам элемент чипса. В группах передаётся конкретный `Item`,\n * для одиночного чипа может быть `undefined`.\n * @returns {string} Текст, который будет показан в чипсе.\n *\n * @default Используется `item?.label.toString()` (или строковое представление value).\n *\n * @remarks\n * - Функция должна быть чистой и быстрой;\n * - Возвращайте ТОЛЬКО строку.\n *\n * @example\n * // 1) Отображение label из кэша при серверной пагинации\n * const labelsCacheRef = useRef(new Map<string, string>());\n * renderChipLabel: (group, item) => {\n * if (item?.id != null) {\n * const key = String(item.id);\n * const fromCache = labelsCacheRef.current.get(key);\n * if (fromCache) return fromCache; // красивый label, если уже загрузили\n * return String(item.label ?? key); // фоллбэк: временно показываем value/label из item\n * }\n * return ''; // безопасный фоллбэк для одиночных случаев\n * }\n *\n * @example\n * // 2) Нормализация отображения числовых значений\n * renderChipLabel: (_group, item) => {\n * const v = Number(item?.label);\n * return Number.isFinite(v) ? v.toLocaleString('ru-RU') : String(item?.label ?? '');\n * }\n *\n * @example\n * // 3) Префикс по типу группы\n * renderChipLabel: (group, item) => {\n * const prefix = group.groupId === 'status' ? '' : '#';\n * return `${prefix}${item?.label ?? item?.id ?? ''}`;\n * }\n */\n renderChipLabel?: (group: Group | null, item: Item) => string;\n};\n\nexport type DefaultSidebarTabIds = 'columns' | 'tableSettings' | 'filtering';\n\n/**\n * Общие настройки пользовательских вкладок левой и правой панели TableCanvas.\n */\nexport type TableCanvasSidebarConfig = {\n /**\n * Включен ли sidebar. Отвечает только за UI. Не влияет на перерасчёт фичей.\n * @default true\n */\n enabled?: boolean;\n /**\n * Открыт ли sidebar при первом рендере (uncontrolled-режим).\n * Игнорируется, если передан openState.\n * @default false\n */\n defaultOpen?: boolean;\n /**\n * Внешний контроль открытия/закрытия sidebar.\n * Если передан — источник истины, defaultOpen игнорируется.\n */\n openState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * id вкладки, выбранной по умолчанию (актуально при открытом сайдбаре).\n * Если id не найден или у вкладки showInSidebar=false — используется первая доступная.\n */\n defaultActiveTabId?: string;\n /**\n * Внешний контроль активной вкладки (controlled-режим).\n * Если передан — источник истины, defaultActiveTabId игнорируется.\n */\n activeTabState?: [\n string | null,\n React.Dispatch<React.SetStateAction<string | null>>,\n ];\n /**\n * Колбэк смены активной вкладки. Вызывается и в uncontrolled-режиме.\n * При закрытии сайдбара приходит null.\n */\n onActiveTabChange?: (tabId: string | null, tab?: SidebarTab) => void;\n /**\n * Кастомные табы\n */\n customTabs?: Array<\n Omit<SidebarTab, 'id'> & {\n id: Exclude<string, DefaultSidebarTabIds>;\n }\n >;\n /**\n * Порядок отображения кастомных вкладок\n */\n customTabsOrder?: Array<Exclude<string, DefaultSidebarTabIds>>;\n /**\n * Ширина контента без полоски вкладок (44px). Число — px, строка — CSS.\n * Проценты считаются от ширины рабочей области TableCanvas.\n * Изменение пропса сразу меняет ширину открытой панели.\n * По умолчанию: 300px слева, 400px справа.\n */\n width?: string | number;\n};\n\n/** Настройки правой панели; встроенные вкладки доступны только справа. */\nexport type SidebarConfig = TableCanvasSidebarConfig & {\n defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара (если данный таб окажется единственным табом в настройках) */\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки (для табов с id = filtering и columns - недоступен. Настраивается через таб с id='tableSettings') */\n iconTooltipText?: undefined;\n }\n | {\n id: 'tableSettings';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара */\n title?: string;\n\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный слот для вкладки tableSettings (рендерится после общих настроек)\n * Только дл id: 'tableSettings'\n */\n customGeneralSettingsSlot?: React.ReactNode;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки @default 'Настройки' */\n iconTooltipText?: string;\n }\n >;\n};\n\n/** Конфигурация правой панели. SidebarConfig сохранён для совместимости. */\nexport type RightSidebarConfig = SidebarConfig;\n\n/** Пользовательские вкладки слева; встроенных вкладок настроек нет. */\nexport type LeftSidebarConfig = TableCanvasSidebarConfig;\n\n/** Нижний слот под canvas, над пагинацией, между боковыми панелями. */\nexport type BottomSheetConfig = {\n /** @default true */\n enabled?: boolean;\n /** Число — px, строка — CSS; 'auto' — по содержимому. Проценты — от рабочей области. @default 32 */\n height?: string | number;\n /** Минимальная высота, ограниченная доступным пространством. @default 32 */\n minHeight?: string | number;\n /** Максимальная высота в px или CSS, дополнительно ограниченная доступным пространством. */\n maxHeight?: string | number;\n /** Пользователь управляет содержимым и раскрытием; при height: 'auto' панель прокручивается сама. */\n content: React.ReactNode;\n};\n\nexport function activeViewIs<T extends 'cards' | 'rows'>(\n checkType: T,\n viewState: 'cards' | 'rows',\n view: View,\n): view is ViewMods[T] {\n return checkType === viewState;\n}\n\n/** Размер controlBlock: 'm' и 's' — одинаковые стили, 'xs' — уменьшенный */\nexport type ControlBlockSize = 'm' | 's' | 'xs';\n\nexport type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * Размер controlBlock и его элементов (кнопки, иконки, поиск, отступы).\n * 'm' и 's' — стандартные стили, 'xs' — компактный режим.\n * Не влияет на customFeatures и кастомные слоты — они контролируются разработчиком.\n * @default 'm'\n */\n size?: ControlBlockSize;\n /**\n * @deprecated Используйте кастомные кнопки через rightSideInner или customFeatures.\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока.\n * Продолжает работать для обратной совместимости.\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * customFeatures - пропс для добавления кастомных фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\n /**\n * pinningMenu - нативная фича закрепления столбцов (SplitIconButton с\n * дропдауном) в правой зоне иконок. Появляется, когда активировано\n * закрепление колонок (columnsControl.pinning). Продукт может донастроить\n * и дополнить пункты меню (см. PinningMenuConfig).\n */\n pinningMenu?: PinningMenuConfig;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты левые фичи при адаптивной компрессии\n */\n leftSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты правые фичи при адаптивной компрессии\n */\n rightSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Активна ли фича компрессии (сжатие ToolsMenu при адаптиве)\n * @default true\n */\n enableAdaptiveCompress?: boolean;\n /**\n * Панель массовых действий\n */\n massActionPanel?: {\n /**\n * Кнопки панели. Размеры кнопок/дропдаунов панель подбирает сама (по `size` панели и компактности) —\n * передавать `size` кнопкам не нужно. Если `size` на кнопке всё же задан — он используется как есть.\n */\n buttons: MassActionButtonProps[];\n /**\n * Пропсы для Dropdown, в который сжались кнопки\n */\n collapsedDropdownProps?: TableDropdownConfigProps;\n /**\n * Отступ панели снизу от контейнера (px)\n * @default 24\n */\n bottom?: number;\n /**\n * Управление отображением панели массовых действий.\n * - `undefined` (по умолчанию) — стандартное поведение (показывается при selecting + выбранных строках)\n * - `false` — панель не рендерится, разработчик управляет действиями самостоятельно\n * - `true` — панель показывается всегда, даже без активного selecting и выбранных строк\n */\n show?: boolean;\n /**\n * Размерная сетка панели внутри таблицы: `m`/`s` — обычный размер, `xs` — уменьшенный (кнопки `xxs`, «ещё» `xs`, счётчик Body XS).\n * Viewport-логика (1280) в таблице не используется.\n * @default 's'\n */\n size?: MassActionsSize;\n };\n};\n\n/** Пропсы кнопки редактирования. onClick исключён — используйте onSave/onCancel/onEnableEditing. */\nexport type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n\nexport type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n\nexport type SummaryRowsConfig = {\n showDefault: boolean;\n showInControl: boolean;\n /**\n * callback при переключении тогла «Итоговые строки» в настройках таблицы.\n * Вызывается только по действию пользователя (не при монтировании),\n * поэтому подходит для сохранения выбора, например, в localStorage.\n * Сохранённое значение передавайте обратно в `showDefault`.\n */\n onChange?: (checked: boolean) => void;\n} & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\n/**\n * Конфиг тултипа при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\nexport type TableConfigTooltip = {\n /**\n * Включить/выключить колоночные и кастомные тултипы (cellTooltip, headerCellTooltip).\n * Внутренние тултипы (drag-иконка в шапке и другие по nodeId) работают всегда.\n * @default false\n */\n enabled?: boolean;\n /** Глобальная задержка перед показом тултипа (мс). Per-node переопределяет. @default 500 */\n mouseEnterDelay?: number;\n /** Глобальная задержка перед скрытием тултипа (мс). Per-node переопределяет. @default 0 */\n mouseLeaveDelay?: number;\n /**\n * Минимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n minWidth?: number | string;\n /**\n * Максимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n maxWidth?: number | string;\n};\n\nexport type InfinityScrollConfig<RowType extends ObjectForExtending> = {\n /** Триггер достижения скроллом зоны подгрузки данных. */\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n /** Состояние загрузки (скелетоны) новых строк. */\n isLoading: boolean;\n /**\n * Флаг, когда все данные загружены — false.\n * @default true\n */\n hasMore?: boolean;\n /**\n * Для mode='region': за сколько строк до конца триггерить загрузку.\n * @default 5\n */\n rowThreshold?: number;\n};\n\nexport type { TableCanvasEmptyStateConfig, TableCanvasErrorStateConfig };\n\n/**\n * Настройка выделения ячеек/колонок/строк в TableCanvas — единый объект.\n * Это отдельная ось взаимодействия — не зависит от `highlightActiveType`.\n */\nexport type CellsSelectionConfig = {\n /**\n * Режим фактического выделения ячеек (нативный glide selection). По нему\n * работают copy/paste, рамка, fill-handle и затемнение шапки/нумерации.\n * @default \"range-cell\"\n */\n mode?: CellsSelectionMode;\n /**\n * Выделение колонок по клику на шапку. Ctrl/Cmd — добавить/убрать колонку,\n * Shift — диапазон колонок. Клик по иконкам сортировки/фильтрации в шапке\n * выделение НЕ вызывает. Поддерживает copy/paste по выделенным колонкам.\n * @default true\n */\n enableColumnSelection?: boolean;\n /**\n * Выделение строк по клику/драгу на колонке нумерации (`rowMarkers`).\n * Ctrl/Cmd — несмежный выбор отдельных строк, драг — смежный диапазон.\n * Поддерживает copy/paste по выделенным строкам. Требует включённой колонки\n * нумерации (`rowMarkers`). При `false` клик по нумерации ничего не выделяет.\n * @default true\n */\n enableRowSelection?: boolean;\n /**\n * Выделение всей таблицы кликом по «нулевой» ячейке — шапке колонки нумерации\n * (левый верхний угол). Выделяет все строки данных по всем колонкам одним\n * диапазоном; поддерживает copy/paste. Требует включённой колонки нумерации\n * (`rowMarkers`) и активного `mode` (≠ `disabled`).\n * @default true\n */\n enableSelectAll?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — он внутренний.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n};\n\n/** Один объединённый блок: какие строки и колонки слить. */\nexport type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n\n/**\n * Видимость сторон рамки ячейки: true рисовать, false не рисовать, не задано -\n * работает уровень ниже (настройка колонки, строки или общая).\n */\nexport type CellBorderVisibility = {\n top?: boolean;\n right?: boolean;\n bottom?: boolean;\n left?: boolean;\n};\n\n/**\n * Управление рамками (линиями) таблицы: включение и выключение. Уровни, от\n * слабого к сильному: общие настройки (vertical, horizontal), затем колонка\n * (getVerticalBorder) и строка (getHorizontalBorder), затем ячейка\n * (getCellBorder).\n */\nexport type BordersConfig<RowType = ObjectForExtending> = {\n /** Рисовать ли вертикальные линии между колонками. @default true */\n vertical?: boolean;\n /** Рисовать ли горизонтальные линии между строками тела. @default true */\n horizontal?: boolean;\n /**\n * Точечное управление вертикальной линией справа от колонки (разделитель\n * после неё). Вернуть true или false, чтобы переопределить общую настройку\n * vertical, или undefined, чтобы оставить её. Зовётся на каждую видимую\n * колонку при перерисовке, поэтому функция должна быть быстрой.\n */\n getVerticalBorder?: (params: {\n /** Ключ колонки, справа от которой рисуется линия. */\n columnKey: string;\n /** Индекс колонки в порядке отрисовки (закреплённые в начале). */\n columnIndex: number;\n }) => boolean | undefined;\n /**\n * Точечное управление горизонтальной линией сверху строки. Вернуть true или\n * false, чтобы переопределить общую настройку horizontal, или undefined,\n * чтобы оставить её. Для summary-строк не вызывается. Зовётся на каждую\n * видимую строку при перерисовке, поэтому функция должна быть быстрой.\n */\n getHorizontalBorder?: (params: {\n /** Строка под линией (линия рисуется сверху этой строки). */\n row: RowType;\n /** Индекс строки среди отображаемых. При раскрытии subRows индексы сдвигаются. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => boolean | undefined;\n /**\n * Стороны рамки конкретной ячейки, вкл и выкл. Для ячеек без переопределений\n * возвращать undefined. Включает отрисовку линий с разбивкой по ячейкам,\n * поэтому функция должна быть быстрой: без тяжёлых вычислений и с готовыми\n * объектами-константами вместо новых на каждый вызов. Для summary-строк не\n * вызывается.\n */\n getCellBorder?: (params: {\n /** Индекс колонки среди отображаемых (без служебных). */\n col: number;\n /** Ключ колонки. */\n columnKey: string | undefined;\n /** Строка ячейки. */\n row: RowType;\n /** Индекс строки среди отображаемых. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => CellBorderVisibility | undefined;\n};\n\nexport type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * Готовые варианты внешнего вида таблицы.\n *\n * `variant: 'clean'` — без линий сетки и внешних рамок, шапка на белом фоне\n * с серым текстом. Отдельные линии можно вернуть через `borders`.\n *\n * `zebra: true` — строки через одну окрашены серым, работает в любом варианте.\n */\n appearance?: AppearanceConfig;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *"
49844
49874
  },
49845
49875
  {
49846
49876
  "typeName": "FilterComponentInPopoverProps",
@@ -49952,6 +49982,32 @@
49952
49982
  }
49953
49983
  ]
49954
49984
  },
49985
+ {
49986
+ "component": "TableCanvas",
49987
+ "feature": "Appearance",
49988
+ "legacy": false,
49989
+ "summary": "*tableConfig.appearance**",
49990
+ "docs": "# Appearance (TableCanvas)\n\n**tableConfig.appearance**\n\nГотовые варианты внешнего вида таблицы: «чистый» вид и зебра.\n\n```tsx\n<TableCanvas\n tableConfig={{\n appearance: { variant: 'clean', zebra: true },\n }}\n/>\n```\n\nВсе поля необязательные. Без `appearance` таблица выглядит как обычно:\n`variant` по умолчанию `'default'`, `zebra` по умолчанию `false`.\n\n## Чистый вид — `variant: 'clean'`\n\nТаблица без линий сетки и внешних рамок. Шапка на белом фоне с серым текстом.\nОстальное выглядит как в обычном виде.\n\n## Зебра — `zebra: true`\n\nСтроки через одну окрашены серым. Работает в любом варианте, по умолчанию\nвыключена.\n\n## Как чистый вид работает с другими настройками\n\n- **`borders`** — линии сетки выключены. Если нужно вернуть отдельные линии,\n задайте их в `borders` явно.\n- **Наведение и выделение** работают как обычно. Нумерация и чекбоксы\n подсвечиваются вместе со строкой.\n- **Отмеченные и выбранные строки** красятся своим цветом, в том числе поверх\n зебры.\n- **Итоговые строки** остаются голубыми, как в обычном виде. Зебра на них не\n распространяется.\n\n> Типы — [Appearance API](?path=/docs/локальные-компоненты-tablecanvas-appearance-api--docs)",
49991
+ "apiDocs": "# Appearance API\n\n## tableConfig.appearance\n\n```typescript\ntype AppearanceConfig = {\n /**\n * `'clean'` — «чистый» вид: без линий сетки и внешних рамок, шапка на белом\n * фоне с серым текстом.\n * @default 'default'\n */\n variant?: AppearanceVariant;\n /**\n * Зебра: строки через одну окрашены серым. Работает в любом `variant`.\n * @default false\n */\n zebra?: boolean;\n};\n```\n\n## AppearanceVariant\n\n```typescript\ntype AppearanceVariant = 'default' | 'clean';\n```",
49992
+ "api": [
49993
+ {
49994
+ "typeName": "AppearanceConfig",
49995
+ "source": "type AppearanceConfig = {\n /**\n * `'clean'` — «чистый» вид: без линий сетки и внешних рамок, шапка на белом\n * фоне с серым текстом.\n * @default 'default'\n */\n variant?: AppearanceVariant;\n /**\n * Зебра: строки через одну окрашены серым. Работает в любом `variant`.\n * @default false\n */\n zebra?: boolean;\n};"
49996
+ },
49997
+ {
49998
+ "typeName": "AppearanceVariant",
49999
+ "source": "type AppearanceVariant = 'default' | 'clean';"
50000
+ }
50001
+ ],
50002
+ "stories": [
50003
+ {
50004
+ "exportName": "Appearance",
50005
+ "displayName": "Чистый вид и зебра (прототип)",
50006
+ "type": "full-code",
50007
+ "code": "import { ColumnConfig, TableCanvas } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n// «Чистый» вид и зебра включаются в tableConfig.appearance:\n// appearance: { variant: 'clean', zebra: true }\n\n() => {\n const [rows, setRows] = useState(createRows);\n\n const [variant, setVariant] = useState<AppearanceVariant>('clean');\n const [zebra, setZebra] = useState(true);\n const [highlightActiveType, setHighlightActiveType] =\n useState<HighlightActiveType>('row');\n const [selectionMode, setSelectionMode] =\n useState<CellsSelectionMode>('range-cell');\n\n const [showPagination, setShowPagination] = useState(true);\n const [showControlBlock, setShowControlBlock] = useState(true);\n const [showSummaryRow, setShowSummaryRow] = useState(true);\n const [showColumnsGrouping, setShowColumnsGrouping] = useState(true);\n const [fillWidth, setFillWidth] = useState(true);\n\n // Колонка без width получает grow и растягивается: таблица сначала\n // подбирает ширину по содержимому, затем один раз делит остаток места\n // поровну. Число становится нижней границей ширины. С fillWidth=false\n // ширина фиксированная, справа остаётся пустое место.\n const columnWidth = useCallback(\n (px: number) => (fillWidth ? { minWidth: px } : { width: px }),\n [fillWidth],\n );\n\n const [page, setPage] = useState(1);\n const [perPage, setPerPage] = useState(PER_PAGE);\n\n const renderSummaryCell = useCallback(\n (props: SummaryCellInfoGlideInstance<Row, TSummaryRowData>) =>\n props.row.values.find((el) => el.columnId === props.column.key)\n ?.value ?? '',\n [],\n );\n\n // Листовые колонки одни и те же, группировка лишь оборачивает их в\n // верхний уровень шапки.\n const leafColumns = useMemo<\n Record<LeafColumnKey, ColumnConfig<Row, TSummaryRowData>>\n >(\n () => ({\n id: {\n key: 'id',\n name: 'ID',\n ...columnWidth(90),\n sortingType: 'numberSort',\n resizable: true,\n renderSummaryCell,\n },\n task: {\n key: 'task',\n name: 'Title',\n ...columnWidth(220),\n sortingType: 'stringSort',\n resizable: true,\n editingCell: { component: 'inputString' },\n renderSummaryCell,\n },\n priority: {\n key: 'priority',\n name: 'Priority',\n ...columnWidth(140),\n sortingType: 'stringSort',\n resizable: true,\n filtering: {\n component: 'select',\n selectOptions: {\n type: 'constant',\n options: [\n { value: 'All', text: 'All' },\n { value: 'High', text: 'High' },\n { value: 'Critical', text: 'Critical' },\n { value: 'Medium', text: 'Medium' },\n { value: 'Low', text: 'Low' },\n ],\n },\n keyInFilterState: 'priority',\n valueInRow: (r) => r.priority,\n filter: {\n typeOfValue: 'single',\n filteringType: (fv, rv) => (fv !== 'All' ? rv === fv : true),\n },\n },\n },\n issueType: {\n key: 'issueType',\n name: 'Issue Type',\n ...columnWidth(150),\n sortingType: 'stringSort',\n resizable: true,\n filtering: {\n component: 'select',\n selectOptions: {\n type: 'constant',\n options: [\n { value: 'Bug', text: 'Bug' },\n { value: 'Improvement', text: 'Improvement' },\n { value: 'Epic', text: 'Epic' },\n { value: 'Story', text: 'Story' },\n ],\n },\n keyInFilterState: 'issueType',\n valueInRow: (r) => r.issueType,\n filter: {\n typeOfValue: 'multiple',\n filteringType: (fv, rv) =>\n !fv.length || fv.some((fvCurr) => fvCurr === rv),\n },\n },\n },\n developer: {\n key: 'developer',\n name: 'Developer',\n ...columnWidth(180),\n sortingType: 'stringSort',\n resizable: true,\n editingCell: { component: 'inputString' },\n filtering: {\n component: 'input',\n keyInFilterState: 'developer',\n valueInRow: (r) => r.developer,\n filter: 'startWith',\n },\n },\n complete: {\n key: 'complete',\n name: '% Complete',\n ...columnWidth(140),\n sortingType: 'numberSort',\n resizable: true,\n editingCell: { component: 'inputString' },\n },\n }),\n [renderSummaryCell, columnWidth],\n );\n\n const columnConfig = useMemo<readonly ColumnConfig<Row, TSummaryRowData>[]>(\n () =>\n showColumnsGrouping\n ? [\n leafColumns.id,\n leafColumns.task,\n {\n key: 'params',\n name: 'Параметры',\n children: [leafColumns.priority, leafColumns.issueType],\n },\n {\n key: 'progress',\n name: 'Выполнение',\n children: [leafColumns.developer, leafColumns.complete],\n },\n ]\n : [\n leafColumns.id,\n leafColumns.task,\n leafColumns.priority,\n leafColumns.issueType,\n leafColumns.developer,\n leafColumns.complete,\n ],\n [leafColumns, showColumnsGrouping],\n );\n\n // Фильтр по типу задачи задан сразу: так на стенде с самого начала видна\n // строка активных фильтров под блоком управления.\n const filteringStateAndSetter = useState({\n priority: 'All',\n issueType: ['Bug', 'Story', 'Epic', 'Improvement'],\n developer: '',\n globalFilter: '',\n });\n const sortingStateAndSetter = useState<readonly SortColumn[]>([]);\n const selectingRowStateAndSetter = useState(\n (): ReadonlySet<string | number> => new Set(),\n );\n\n const rowKeyGetter = useCallback((r: Row) => `${r.id}`, []);\n\n const bottomSummaryRows = useMemo<TSummaryRowData[]>(\n () => [\n {\n type: 'bottom',\n values: [\n { columnId: 'id', value: 'Итого' },\n { columnId: 'task', value: `Всего задач: ${rows.length}` },\n ],\n },\n ],\n [rows],\n );\n\n return (\n <div>\n <div\n style={{\n display: 'flex',\n gap: 12,\n flexWrap: 'wrap',\n alignItems: 'flex-end',\n marginBottom: 12,\n }}\n >\n <Select\n label=\"cellsSelection.mode\"\n value={selectionMode}\n onChange={(value) => setSelectionMode(value as CellsSelectionMode)}\n items={SELECTION_MODE_OPTIONS}\n style={{ width: 200 }}\n />\n <Select\n label=\"highlightActiveType\"\n value={highlightActiveType}\n onChange={(value) =>\n setHighlightActiveType(value as HighlightActiveType)\n }\n items={HIGHLIGHT_ACTIVE_TYPE_OPTIONS}\n style={{ width: 180 }}\n />\n </div>\n <div\n style={{\n display: 'flex',\n gap: 16,\n flexWrap: 'wrap',\n marginBottom: 12,\n }}\n >\n <Switch\n label=\"appearance.variant = 'clean'\"\n checked={variant === 'clean'}\n onChange={() =>\n setVariant((prev) => (prev === 'clean' ? 'default' : 'clean'))\n }\n />\n <Switch\n label=\"appearance.zebra\"\n checked={zebra}\n onChange={() => setZebra((prev) => !prev)}\n />\n <Switch\n label=\"Блок управления\"\n checked={showControlBlock}\n onChange={() => setShowControlBlock((prev) => !prev)}\n />\n <Switch\n label=\"Пагинация\"\n checked={showPagination}\n onChange={() => setShowPagination((prev) => !prev)}\n />\n <Switch\n label=\"Итоговая строка\"\n checked={showSummaryRow}\n onChange={() => setShowSummaryRow((prev) => !prev)}\n />\n <Switch\n label=\"Группировка шапки\"\n checked={showColumnsGrouping}\n onChange={() => setShowColumnsGrouping((prev) => !prev)}\n />\n <Switch\n label=\"Колонки на всю ширину\"\n checked={fillWidth}\n onChange={() => setFillWidth((prev) => !prev)}\n />\n </div>\n\n <TableCanvas\n // растягивание колонок срабатывает один раз при первой раскладке,\n // поэтому при переключении таблица пересоздаётся\n key={fillWidth ? 'fill' : 'fixed'}\n tableConfig={{\n appearance: { variant, zebra },\n containerStyle: { height: '80vh' },\n fullScreenEnabled: true,\n resizableColumn: true,\n editing: {\n onRowsChange: setRows,\n rowKeyGetter,\n },\n rowSize: {\n default: 'big',\n showInControl: true,\n },\n cellsSelection: { mode: selectionMode },\n highlightActiveType,\n searching: {\n enabled: true,\n debounceDelay: 400,\n },\n summaryRows: {\n showDefault: showSummaryRow,\n showInControl: true,\n },\n columnsControl: {\n enable: true,\n hiding: true,\n pinning: true,\n reorderingAside: true,\n reorderingHeader: true,\n pinnedDefault: ['id'],\n },\n rowMarkers: {\n startIndex: 1,\n },\n subRows: {\n getSubRows: (row) => row?.subRows,\n rowKeyGetter: (row) => row.id,\n },\n ...(showPagination && {\n pagination: {\n value: page,\n perPage,\n count: rows.length,\n onChangePageValue(value, scrollToTop) {\n setPage(value ?? 1);\n scrollToTop();\n },\n onChange(value, pageSize, scrollToTop) {\n setPage(\n pageSize !== undefined && pageSize !== perPage\n ? 1\n : value ?? 1,\n );\n setPerPage(pageSize ?? perPage);\n scrollToTop();\n },\n },\n }),\n controlBlock: {\n show: showControlBlock,\n rightSideInner: [\n {\n text: 'Скачать',\n contentLeft: <IconSb color=\"inherit\" />,\n 'data-test-id': 'download',\n },\n ],\n massActionPanel: {\n buttons: [\n {\n type: 'button',\n view: 'secondary',\n text: 'Действие',\n contentLeft: <IconSb color=\"inherit\" />,\n 'data-test-id': 'mass-action',\n },\n ],\n },\n },\n filtering: {\n state: filteringStateAndSetter,\n filtersInfo: {\n priority: {\n label: 'Priority',\n clearedValue: 'All',\n },\n issueType: {\n label: 'Issue Type',\n clearedValue: [],\n },\n developer: {\n label: 'Developer',\n clearedValue: '',\n },\n globalFilter: {\n label: 'Global filter',\n clearedValue: '',\n },\n },\n },\n selecting: {\n state: selectingRowStateAndSetter,\n rowKeyGetter,\n showDefault: true,\n },\n sorting: {\n state: sortingStateAndSetter,\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n bottomSummaryRows={bottomSummaryRows}\n />\n </div>\n );\n }"
50008
+ }
50009
+ ]
50010
+ },
49955
50011
  {
49956
50012
  "component": "TableCanvas",
49957
50013
  "feature": "FullScreenMode",
@@ -50783,7 +50839,7 @@
50783
50839
  "feature": "SubRows",
50784
50840
  "legacy": false,
50785
50841
  "summary": "*tableConfig.subRows + columnConfig.subRow**",
50786
- "docs": "# SubRows (TableCanvas)\n\n**tableConfig.subRows + columnConfig.subRow**\n\nИерархичное отображение данных с вложенными строками. Поддерживает произвольную глубину вложенности.\n\nКонфигурация состоит из двух частей:\n\n- **`tableConfig.subRows`** — дерево данных: функция получения дочерних строк, ключ строки, состояние раскрытия\n- **`columnConfig[].subRow`** — отображение на уровне колонки: маппинг ключей, рендер ячеек, стрелка раскрытия\n\n## tableConfig.subRows\n\n- **`getSubRows`** `(row) => RowType[] | undefined` — функция получения дочерних строк\n- **`rowKeyGetter`** `(row) => RowIdType` — уникальный ключ строки\n- **`expandedIdsState`** `[Set, setter]` — внешний стейт развёрнутых строк (опционально, иначе внутренний useState)\n\n## columnConfig.subRow\n\n- **`isColumnWithArrow`** `boolean | ((props) => boolean)` — стрелка раскрытия в этой колонке (default: `false`)\n- **`hideHeaderExpandAllArrow`** `boolean` — скрыть кнопку «развернуть все» в header (default: `false`)\n- **`parentKeyAsDefault`** `boolean` — использовать ключ родителя как fallback (default: `false`)\n- **`keyOfColumnInSubRow`** `string | number | ((lvl) => string | number)` — маппинг ключей колонок для каждого уровня\n- **`contentFormat`** `ContentFormat` — формат содержимого подстрок\n- **`renderSubRowCell`** `RenderSubRowCell` — кастомный рендер ячеек подстрок\n\n> Подробнее о типах — [SubRows API](?path=/docs/локальные-компоненты-tablecanvas-subrows-api--docs)",
50842
+ "docs": "# SubRows (TableCanvas)\n\n**tableConfig.subRows + columnConfig.subRow**\n\nИерархичное отображение данных с вложенными строками. Поддерживает произвольную глубину вложенности.\n\nКонфигурация состоит из двух частей:\n\n- **`tableConfig.subRows`** — дерево данных: функция получения дочерних строк, ключ строки, состояние раскрытия\n- **`columnConfig[].subRow`** — отображение на уровне колонки: маппинг ключей, рендер ячеек, стрелка раскрытия\n\n## tableConfig.subRows\n\n- **`getSubRows`** `(row) => RowType[] | undefined` — функция получения дочерних строк\n- **`rowKeyGetter`** `(row) => RowIdType` — уникальный ключ строки\n- **`expandedIdsState`** `[Set, setter]` — внешний стейт развёрнутых строк (опционально, иначе внутренний useState)\n\n## columnConfig.subRow\n\n- **`isColumnWithArrow`** `boolean | ((props) => boolean)` — стрелка раскрытия в этой колонке (default: `false`)\n- **`hideHeaderExpandAllArrow`** `boolean` — скрыть кнопку «развернуть все» в header (default: `false`)\n- **`parentKeyAsDefault`** `boolean` — использовать ключ родителя как fallback (default: `false`)\n- **`keyOfColumnInSubRow`** `string | number | ((lvl) => string | number)` — маппинг ключей колонок для каждого уровня\n- **`contentFormat`** `ContentFormat` — формат содержимого подстрок\n- **`renderSubRowCell`** `RenderSubRowCell` — кастомный рендер ячеек подстрок\n\n## Ленивая подгрузка детей («Показать ещё»)\n\nКогда детей у группы много и грузить их все сразу нельзя, подгрузка собирается из штатных возможностей без доработок ядра:\n\n- `getSubRows` возвращает загруженных детей плюс одну служебную строку `loadMore` в конце\n- `mergeCells.mergedCellsRegions` объединяет служебную строку на все колонки (регион задан ключом строки, у свёрнутой группы он не рисуется)\n- `renderSubRowCell` для служебной строки возвращает `Canvas.Container` со ссылкой «Показать ещё N» (кликабельный контейнер с `Canvas.Text`) и счётчиком «Показано X из Y»; по клику потребитель догружает порцию и пересобирает `subRows`\n- фон строки задаётся через `themeOverride`\n- в стори включён чистый вид (`appearance: { variant: 'clean' }`), колонки растягиваются на всю ширину\n\nПример — стори «Ленивая подгрузка детей группы».\n\n> Подробнее о типах — [SubRows API](?path=/docs/локальные-компоненты-tablecanvas-subrows-api--docs)",
50787
50843
  "apiDocs": "# SubRows API\n\n## SubRows\n\n```typescript\ntype SubRows<RowType, RowIdType> = {\n /**\n * Возвращает дочерние строки узла (или undefined, если их нет).\n *\n * Функция должна быть стабильной — не менять поведение между рендерами.\n * Если она зависит от чего-то меняющегося, оберните её в useCallback.\n */\n getSubRows: (row: RowType) => RowType[] | undefined;\n /**\n * Возвращает уникальный ключ строки.\n *\n * Функция должна быть стабильной — не менять поведение между рендерами.\n * Если она зависит от чего-то меняющегося, оберните её в useCallback.\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Внешний стейт развёрнутых строк.\n * Если не задан — используется внутренний useState.\n * При view: 'merged' не используется: сворачивания в этом виде нет.\n */\n expandedIdsState?: [\n Set<string | number>,\n (\n newV:\n | Set<string | number>\n | ((prev: Set<string | number>) => Set<string | number>),\n ) => void,\n ];\n /**\n * Как показывать дерево.\n * 'tree' (по умолчанию) — узлы с раскрытием (шевроны) и отступом по уровню.\n * 'merged' — дерево разворачивается в листья, а колонки-предки показаны\n * объединёнными ячейками. Структуру задаёт потребитель через getSubRows;\n * данные (пагинация, сортировка, поиск) остаются на его стороне.\n */\n view?: 'tree' | 'merged';\n /**\n * Только для view: 'merged'. Колонки-предки по порядку уровней:\n * mergedColumns[0] — верхний уровень, дальше глубже. Каждая такая колонка\n * показывает значение своего узла-предка (узел должен нести поле с этим именем)\n * и объединяется по его границам. Верхний уровень задаёт чекбокс и номер блока.\n */\n mergedColumns?: string[];\n};\n```",
50788
50844
  "api": [
50789
50845
  {
@@ -50797,6 +50853,12 @@
50797
50853
  "displayName": "Иерархичный вид",
50798
50854
  "type": "full-code",
50799
50855
  "code": "import { ColumnConfig, TableCanvas } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n // Разная глубина и число детей у строк — «рваная лестница» отступов\n const [rows] = useState(() => createRaggedRowsTree());\n\n const columns = useMemo(\n (): readonly ColumnConfig<TreeRow>[] => [\n {\n key: 'block',\n name: 'Блок / Трайб / Продукт',\n\n subRow: {\n keyOfColumnInSubRow: (lvl) => {\n switch (lvl) {\n case 0:\n return 'block';\n case 1:\n return 'tribe';\n default:\n return 'product';\n }\n },\n\n isColumnWithArrow: true,\n hideHeaderExpandAllArrow: false,\n },\n },\n {\n key: 'blockActivity',\n name: 'Активность блока',\n },\n {\n key: ' ',\n name: 'Локация трайба',\n subRow: {\n renderSubRowCell: (props, lvl) => {\n if (lvl === 1) {\n return (\n <Canvas.Container\n alignItems=\"center\"\n padding={{ left: 8 }}\n style={{ width: '100%' }}\n >\n <Canvas.Badge\n id=\"kek\"\n text={props.row?.tribeZone}\n view=\"accent\"\n size=\"m\"\n />\n </Canvas.Container>\n );\n }\n return '';\n },\n },\n },\n {\n key: 'q1',\n name: 'Q1',\n\n subRow: {\n parentKeyAsDefault: true,\n },\n },\n\n {\n key: 'q2',\n name: 'Q2',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q3',\n name: 'Q3',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q4',\n name: 'Q4',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: '85vh' },\n subRows: {\n getSubRows: (row) => row?.subRows,\n rowKeyGetter: (row) => row.id,\n },\n // Отступ уровня зависит от размера строки: big 16/66/116,\n // medium 6/42/78, small 4/32/60 px\n rowSize: { showInControl: true, default: 'big' },\n fullScreenEnabled: true,\n resizableColumn: true,\n }}\n columnConfig={columns}\n rows={rows}\n />\n );\n }"
50856
+ },
50857
+ {
50858
+ "exportName": "LazyLoadChildren",
50859
+ "displayName": "Ленивая подгрузка детей группы",
50860
+ "type": "full-code",
50861
+ "code": "const STEP = 10; // сколько детей догружаем за клик\nconst COL_KEYS = ['name', 'activity', 'location', 'amount'];\n\n// Дети группы для таблицы: загруженные + служебная строка «Показать ещё», пока есть что грузить.\nconst buildSubRows = (group) => {\n const children = Array.from({ length: group.loaded }, (_, i) => makeChild(group.id, i));\n if (group.loaded < group.total) {\n children.push({ id: \\"
50800
50862
  }
50801
50863
  ]
50802
50864
  },
@@ -51052,12 +51114,12 @@
51052
51114
  "feature": "columnsControl",
51053
51115
  "legacy": true,
51054
51116
  "summary": "Пользовательская настройка колонок legacy `Table`.",
51055
- "docs": "# ColumnsControl\n\nПользовательская настройка колонок legacy `Table`.\n\n## Ключевые особенности\n\n- Включение через `tableConfig.columnsControl.enable`\n- Скрытие, закрепление и переупорядочивание колонок\n- Запрет скрытия или закрепления отдельных колонок\n- Дефолтные состояния `orderDefault`, `hiddenDefault`, `pinnedDefault`\n- Колбэк `onConfirm` для сохранения настроек вне таблицы\n\n## Особенности\n\n`columnsControl` может работать вместе с изменением ширины колонок и с `keyText`. Для группированных колонок проверяйте итоговый порядок leaf-колонок.\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-columnscontrol-api--docs).",
51056
- "apiDocs": "# Columns Control API\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
51117
+ "docs": "# ColumnsControl\n\nПользовательская настройка колонок legacy `Table`.\n\n## Ключевые особенности\n\n- Включение через `tableConfig.columnsControl.enable`\n- Скрытие, закрепление и переупорядочивание колонок\n- Запрет скрытия или закрепления отдельных колонок\n- Дефолтные состояния `orderDefault`, `hiddenDefault`, `pinnedDefault`\n- Колбэк `onConfirm` для сохранения настроек вне таблицы\n- Режим применения `applyMode`: `confirm` (кнопки «Отменить»/«Применить», по умолчанию) или `instant` (без кнопок, каждое действие в панели сразу меняет таблицу и вызывает `onConfirm`)\n\n## Особенности\n\n`columnsControl` может работать вместе с изменением ширины колонок и с `keyText`. Для группированных колонок проверяйте итоговый порядок leaf-колонок.\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-columnscontrol-api--docs).",
51118
+ "apiDocs": "# Columns Control API\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
51057
51119
  "api": [
51058
51120
  {
51059
51121
  "typeName": "ColumnsControlConfig",
51060
- "source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
51122
+ "source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
51061
51123
  }
51062
51124
  ],
51063
51125
  "stories": [
@@ -51067,6 +51129,12 @@
51067
51129
  "type": "full-code",
51068
51130
  "code": "import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n Badge,\n Box,\n Button,\n ColumnConfig,\n ColumnOrColumnGroupConfig,\n RenderCellProps,\n RowHeightFunc,\n SIZES,\n Select,\n Switch,\n Table,\n TextField,\n} from '@sber-digital-finance-ui/ui-kit';\nimport { IconAddOutline, IconBoxOutline, IconSber } from '@sber-digital-finance-ui/ui-kit/icons';\n\n() => {\n const [rows] = useState(createRows);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n {\n key: 'id',\n name: 'ID',\n },\n {\n key: 'task',\n name: 'Title',\n },\n {\n key: 'priority',\n name: 'Priority',\n },\n {\n key: 'issueType',\n name: 'Issue Type',\n },\n {\n key: 'developer',\n name: 'Developer',\n },\n {\n key: 'tr1',\n name: 'TR',\n },\n {\n key: 'complete',\n name: '% Complete',\n },\n ],\n [],\n );\n\n return (\n <Table\n tableConfig={{\n containerStyle: { height: 700 },\n columnsControl: {\n enable: true,\n hiding: true,\n disableHiding: ['id'],\n pinning: true,\n disablePinning: ['developer'],\n reorderingAside: true,\n reorderingHeader: true,\n columnsLabel: {\n task: 'Задачи',\n },\n orderDefault: ['id', 'issueType', 'task'],\n hiddenDefault: ['tr1'],\n pinnedDefault: ['complete'],\n onConfirm: ({ order, hidden, pinned }, _setters) => {\n // eslint-disable-next-line no-alert\n alert(`\n order: ${order.join(', ')}\n pinned: ${pinned.join(', ')}\n hidden: ${hidden.join(', ')}\n `);\n },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
51069
51131
  },
51132
+ {
51133
+ "exportName": "ColumnsControlInstantApply",
51134
+ "displayName": "ID",
51135
+ "type": "full-code",
51136
+ "code": "import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n Badge,\n Box,\n Button,\n ColumnConfig,\n ColumnOrColumnGroupConfig,\n RenderCellProps,\n RowHeightFunc,\n SIZES,\n Select,\n Switch,\n Table,\n TextField,\n} from '@sber-digital-finance-ui/ui-kit';\nimport { IconAddOutline, IconBoxOutline, IconSber } from '@sber-digital-finance-ui/ui-kit/icons';\n\n() => {\n const [rows] = useState(createRows);\n const [confirmLog, setConfirmLog] = useState<string[]>([]);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n { key: 'id', name: 'ID' },\n { key: 'task', name: 'Title' },\n { key: 'priority', name: 'Priority' },\n { key: 'issueType', name: 'Issue Type' },\n { key: 'developer', name: 'Developer' },\n { key: 'tr1', name: 'TR' },\n { key: 'complete', name: '% Complete' },\n ],\n [],\n );\n\n return (\n <Box $css={{ display: 'flex', flexDirection: 'column', gap: '8px' }}>\n <Box\n data-testid=\"confirm-log\"\n $css={{\n height: '96px',\n overflowY: 'auto',\n padding: '8px 12px',\n borderRadius: '8px',\n backgroundColor: surfaceTransparentPrimary,\n fontSize: '12px',\n lineHeight: '18px',\n fontFamily: 'monospace',\n whiteSpace: 'pre',\n }}\n >\n {confirmLog.length\n ? confirmLog.join('\\n')\n : 'Вызовы onConfirm: откройте настройки колонок и измените что-нибудь'}\n </Box>\n <Table\n tableConfig={{\n containerStyle: { height: 600 },\n columnsControl: {\n enable: true,\n applyMode: 'instant',\n disableHiding: ['id'],\n disablePinning: ['developer'],\n hiddenDefault: ['tr1'],\n pinnedDefault: ['complete'],\n onConfirm: ({ order, hidden, pinned, changed }) => {\n setConfirmLog((prev) => [\n [\n `#${prev.length + 1} изменилось: ${Object.keys(\n changed,\n ).join(', ')}`,\n ` order: ${order.join(', ')}`,\n ` pinned: ${pinned.join(', ')}`,\n ` hidden: ${hidden.join(', ')}`,\n ].join('\\n'),\n ...prev,\n ]);\n },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </Box>\n );\n }"
51137
+ },
51070
51138
  {
51071
51139
  "exportName": "ColumnsControlDynamicColumn",
51072
51140
  "displayName": "ColumnsControl: динамическое добавление колонки",
@@ -51341,7 +51409,7 @@
51341
51409
  "legacy": true,
51342
51410
  "summary": "Data-атрибуты для автотестов и аналитики",
51343
51411
  "docs": "# DomMetadata\n\n## Ключевые особенности\n\n- Data-атрибуты для автотестов и аналитики\n- CSS-классы для элементов таблицы и фич\n- Поддержка action metadata для интерактивных элементов\n\n**Метки для автоматизированного тестирования, аналитики и онбординга**\n\n`DomMetadata` позволяет навешивать CSS-классы, data-атрибуты и обработчики кликов на интерактивные элементы таблицы.\nЭто нужно для:\n\n- **Аналитики** — трекинг кликов по кнопкам таблицы\n- **Автотестов** — поиск элементов по `data-testid`\n- **Онбординга** — привязка подсказок к конкретным элементам\n\n## Поддерживаемые элементы (className, dataAttributes)\n\nСледующие элементы поддерживают `className` и `dataAttributes` через `domMetadata`:\n\n**Control Block (панель управления):**\n\n- **Редактирование** — `tableConfig.editing.domMetadata`\n- **Полноэкранный режим** — `tableConfig.fullScreenEnabled.domMetadata`\n- **Размер строки** — `tableConfig.rowSize.domMetadata`\n- **Переключение вида** (строки/карточки) — `tableConfig.view.domMetadata`\n- **Группировка строк** — `tableConfig.rowsGrouping.domMetadata`\n- **Поиск** — `tableConfig.searching.domMetadata`\n- **Итоговые строки** — `tableConfig.summaryRows.domMetadata`\n- **KeyText** (controlBlock) — `tableConfig.keyText.controlBlock.domMetadata`\n- **KeyText** (sidebar) — `tableConfig.keyText.sidebar.domMetadata`\n\n**Selecting (выбор строк):**\n\n- **Чекбокс \"Выбрать все\"** (controlBlock) — `tableConfig.selecting.controlBlock.domMetadata`\n- **Свитч в сайдбаре** — `tableConfig.selecting.sidebar.domMetadata`\n\n**Sidebar (правая панель):**\n\n- **Табы сайдбара** — `tableConfig.sidebarConfig.defaultTabs[].domMetadata`\n- **Подтабы настроек** (Фильтры, Столбцы) — `tableConfig.sidebarConfig.defaultTabs[{id:'filtering'|'columns'}].domMetadata`\n\n**Другие:**\n\n- **Кнопка сворачивания таблицы** — `tableConfig.collapse.domMetadata`\n\n## Элементы с расширенным onClick (className, dataAttributes, onClick + detail)\n\nВ дополнение к `className` и `dataAttributes`, следующие элементы поддерживают `onClick` с контекстом `detail`:\n\n- **Группировать** (чекбоксы, сброс) — `tableConfig.rowsGrouping.domMetadata` — actions: `toggle-group`, `reset-groups`, `custom-item-select`\n- **Кнопка размера строки** — `tableConfig.rowSize.domMetadata` — action: `change-row-size`\n- **Шестеренка настроек** — `tableConfig.sidebarConfig.defaultTabs[{id:'tableSettings'}].domMetadata` — action: `toggle-sidebar-tab`\n- **Крестик закрыть сайдбар** — тот же `domMetadata` таба — action: `close-sidebar`\n- **Закрепить столбец** — `tableConfig.columnsControl.pinDomMetadata` — actions: `pin-column`, `unpin-column`\n- **Свитчер видимости столбца** — `tableConfig.columnsControl.switchDomMetadata` — actions: `show-column`, `hide-column`\n\n## onClick\n\nОбработчик `onClick` вызывается **после** основной логики элемента. Он не мешает работе кнопки и не вызывает `stopPropagation`.\n\n```tsx\nonClick?: (\n e?: React.MouseEvent<HTMLElement>, // MouseEvent (undefined для элементов внутри Dropdown)\n detail?: Record<string, unknown> // контекст: action, columnKey, size и др.\n) => void;\n```\n\n### Примеры detail\n\n```ts\n// Группировка\n{ action: 'toggle-group', columnKey: 'status' }\n{ action: 'reset-groups' }\n\n// Размер строки\n{ action: 'change-row-size', size: 'medium' }\n\n// Сайдбар\n{ action: 'toggle-sidebar-tab', tabId: 'tableSettings' }\n{ action: 'close-sidebar' }\n\n// Столбцы\n{ action: 'pin-column', columnKey: 'name' }\n{ action: 'unpin-column', columnKey: 'name' }\n{ action: 'hide-column', columnKey: 'name' }\n{ action: 'show-column', columnKey: 'name' }\n```\n\nПодробнее о типах — в разделе [API](?path=/docs/локальные-компоненты-table-dommetadata-api--docs).",
51344
- "apiDocs": "# DomMetadata API\n\n## DomMetadata\n\n```typescript\ntype DomMetadata = {\n /**\n * CSS класс для стилизации и поиска элемента\n *\n * @example 'user-profile-card'\n * @example 'onboarding-step-1'\n */\n className?: string;\n /**\n * Data-атрибуты для тестирования, аналитики и онбординга\n *\n * @example { 'data-testid': 'submit-button', 'data-analytics': 'click-event' }\n */\n dataAttributes?: DataAttributes;\n /**\n * Обработчик клика для аналитики и трекинга\n *\n * Вызывается вместе с основным обработчиком элемента (не заменяет его).\n * Не вызывает stopPropagation — оригинальная логика кнопки сохраняется.\n *\n * @param e - MouseEvent (может быть undefined для элементов внутри Dropdown)\n * @param detail - контекст действия: action, columnKey, size и др.\n *\n * @example onClick: (e, detail) => analytics.track(detail?.action, detail)\n */\n onClick?: (\n e?: React.MouseEvent<HTMLElement>,\n detail?: Record<string, unknown>,\n ) => void;\n};\n```\n\n## DOM_METADATA_ACTIONS\n\n```typescript\nexport const DOM_METADATA_ACTIONS = {\n /** Включение/выключение группировки по столбцу. detail.columnKey — ключ столбца */\n TOGGLE_GROUP: 'toggle-group',\n /** Сброс всех группировок */\n RESET_GROUPS: 'reset-groups',\n /** Выбор пункта в кастомном onItemSelect группировки. detail.columnKey — ключ */\n CUSTOM_ITEM_SELECT: 'custom-item-select',\n /** Переключение размера строки. detail.size — новый размер ('small' | 'medium' | 'big') */\n CHANGE_ROW_SIZE: 'change-row-size',\n /** Клик по табу сайдбара (шестерёнка и др.). detail.tabId — id таба */\n TOGGLE_SIDEBAR_TAB: 'toggle-sidebar-tab',\n /** Закрытие сайдбара (крестик) */\n CLOSE_SIDEBAR: 'close-sidebar',\n /** Закрепление столбца. detail.columnKey — ключ столбца */\n PIN_COLUMN: 'pin-column',\n /** Открепление столбца. detail.columnKey — ключ столбца */\n UNPIN_COLUMN: 'unpin-column',\n /** Скрытие столбца. detail.columnKey — ключ столбца */\n HIDE_COLUMN: 'hide-column',\n /** Показ столбца. detail.columnKey — ключ столбца */\n SHOW_COLUMN: 'show-column',\n} as const;\n```\n\n## DomMetadataAction\n\n```typescript\ntype DomMetadataAction =\n (typeof DOM_METADATA_ACTIONS)[keyof typeof DOM_METADATA_ACTIONS];\n```\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
51412
+ "apiDocs": "# DomMetadata API\n\n## DomMetadata\n\n```typescript\ntype DomMetadata = {\n /**\n * CSS класс для стилизации и поиска элемента\n *\n * @example 'user-profile-card'\n * @example 'onboarding-step-1'\n */\n className?: string;\n /**\n * Data-атрибуты для тестирования, аналитики и онбординга\n *\n * @example { 'data-testid': 'submit-button', 'data-analytics': 'click-event' }\n */\n dataAttributes?: DataAttributes;\n /**\n * Обработчик клика для аналитики и трекинга\n *\n * Вызывается вместе с основным обработчиком элемента (не заменяет его).\n * Не вызывает stopPropagation — оригинальная логика кнопки сохраняется.\n *\n * @param e - MouseEvent (может быть undefined для элементов внутри Dropdown)\n * @param detail - контекст действия: action, columnKey, size и др.\n *\n * @example onClick: (e, detail) => analytics.track(detail?.action, detail)\n */\n onClick?: (\n e?: React.MouseEvent<HTMLElement>,\n detail?: Record<string, unknown>,\n ) => void;\n};\n```\n\n## DOM_METADATA_ACTIONS\n\n```typescript\nexport const DOM_METADATA_ACTIONS = {\n /** Включение/выключение группировки по столбцу. detail.columnKey — ключ столбца */\n TOGGLE_GROUP: 'toggle-group',\n /** Сброс всех группировок */\n RESET_GROUPS: 'reset-groups',\n /** Выбор пункта в кастомном onItemSelect группировки. detail.columnKey — ключ */\n CUSTOM_ITEM_SELECT: 'custom-item-select',\n /** Переключение размера строки. detail.size — новый размер ('small' | 'medium' | 'big') */\n CHANGE_ROW_SIZE: 'change-row-size',\n /** Клик по табу сайдбара (шестерёнка и др.). detail.tabId — id таба */\n TOGGLE_SIDEBAR_TAB: 'toggle-sidebar-tab',\n /** Закрытие сайдбара (крестик) */\n CLOSE_SIDEBAR: 'close-sidebar',\n /** Закрепление столбца. detail.columnKey — ключ столбца */\n PIN_COLUMN: 'pin-column',\n /** Открепление столбца. detail.columnKey — ключ столбца */\n UNPIN_COLUMN: 'unpin-column',\n /** Скрытие столбца. detail.columnKey — ключ столбца */\n HIDE_COLUMN: 'hide-column',\n /** Показ столбца. detail.columnKey — ключ столбца */\n SHOW_COLUMN: 'show-column',\n} as const;\n```\n\n## DomMetadataAction\n\n```typescript\ntype DomMetadataAction =\n (typeof DOM_METADATA_ACTIONS)[keyof typeof DOM_METADATA_ACTIONS];\n```\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
51345
51413
  "api": [
51346
51414
  {
51347
51415
  "typeName": "DomMetadata",
@@ -51357,7 +51425,7 @@
51357
51425
  },
51358
51426
  {
51359
51427
  "typeName": "ColumnsControlConfig",
51360
- "source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
51428
+ "source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
51361
51429
  }
51362
51430
  ],
51363
51431
  "stories": [
@@ -52008,7 +52076,7 @@
52008
52076
  "feature": "subRows",
52009
52077
  "legacy": true,
52010
52078
  "summary": "Иерархичные строки legacy `Table`.",
52011
- "docs": "# SubRows\n\nИерархичные строки legacy `Table`.\n\n## Ключевые особенности\n\n- Вложенные строки подключаются через `tableConfig.subRows`\n- `getSubRows` возвращает дочерние строки\n- `rowKeyGetter` задает уникальный ключ строки\n- `columnConfig.subRow` управляет отображением данных дочерних строк\n- Можно показать chevron раскрытия и кастомный render дочерней ячейки\n\n## Особенности\n\nДля вложенных строк важно иметь стабильный `rowKeyGetter`. Если нужно группировать плоский набор данных, используйте `rowsGrouping`, а не `subRows`.\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-subrows-api--docs).",
52079
+ "docs": "# SubRows\n\nИерархичные строки legacy `Table`.\n\n## Ключевые особенности\n\n- Вложенные строки подключаются через `tableConfig.subRows`\n- `getSubRows` возвращает дочерние строки\n- `rowKeyGetter` задает уникальный ключ строки\n- `columnConfig.subRow` управляет отображением данных дочерних строк\n- Можно показать chevron раскрытия и кастомный render дочерней ячейки\n\n## Особенности\n\nДля вложенных строк важно иметь стабильный `rowKeyGetter`. Если нужно группировать плоский набор данных, используйте `rowsGrouping`, а не `subRows`.\n\n## Ленивая подгрузка детей («Показать ещё»)\n\nКогда детей у группы много и грузить их все сразу нельзя, подгрузка собирается из штатных возможностей без доработок ядра: `getSubRows` возвращает загруженных детей плюс служебную строку `loadMore`, `colSpan` первой колонки растягивает её на всю ширину, а `renderSubRowCell` рисует кнопку «Показать ещё N» со счётчиком. По клику потребитель догружает порцию и пересобирает `subRows`. Пример — стори «Ленивая подгрузка детей группы».\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-subrows-api--docs).",
52012
52080
  "apiDocs": "# SubRows API\n\n## SubRows\n\n```typescript\ntype SubRows<RowType, RowIdType> = {\n getSubRows: (row: RowType) => RowType[] | undefined;\n rowKeyGetter: (row: RowType) => RowIdType;\n expandedIdsState?: [\n Set<string | number>,\n (\n newV:\n | Set<string | number>\n | ((prev: Set<string | number>) => Set<string | number>),\n ) => void,\n ];\n};\n```\n\n## RenderSubRowCell\n\n```typescript\ntype RenderSubRowCell<SubRowType extends ObjectForExtending> = (\n renderCellProps: RenderCellProps<SubRowType>,\n lvl: number,\n) => ReactNode;\n```\n\n## RenderSubRowEditCell\n\n```typescript\ntype RenderSubRowEditCell<SubRowType extends ObjectForExtending> = (\n renderCellProps: RenderEditCellProps<SubRowType>,\n lvl: number,\n) => ReactNode;\n```",
52013
52081
  "api": [
52014
52082
  {
@@ -52030,6 +52098,12 @@
52030
52098
  "displayName": "Иерархичный вид",
52031
52099
  "type": "full-code",
52032
52100
  "code": "import React, { useMemo, useState } from 'react';\nimport { Badge, ColumnConfig, Table } from '@sber-digital-finance-ui/ui-kit';\n\n() => {\n const [rows] = useState(() => createRowsTree());\n\n const columns = useMemo(\n (): readonly ColumnConfig<TreeRow>[] => [\n {\n key: 'block',\n name: 'Блок / Трайб / Продукт',\n\n subRow: {\n keyOfColumnInSubRow: (lvl) => {\n switch (lvl) {\n case 0:\n return 'block';\n case 1:\n return 'tribe';\n case 2:\n return 'product';\n default:\n return 'block';\n }\n },\n\n isColumnWithArrow: true,\n hideHeaderExpandAllArrow: false,\n },\n resizable: true,\n },\n {\n key: 'blockActivity',\n name: 'Активность блока',\n },\n {\n key: '',\n minWidth: 170,\n\n name: 'Локация трайба',\n subRow: {\n renderSubRowCell: (props, lvl) => {\n if (lvl === 1) {\n return (\n <Badge view=\"accent\" size=\"m\">\n {props.row?.tribeZone}\n </Badge>\n );\n }\n return null;\n },\n },\n },\n {\n key: 'q1',\n name: 'Q1',\n\n subRow: {\n parentKeyAsDefault: true,\n },\n },\n\n {\n key: 'q2',\n name: 'Q2',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q3',\n name: 'Q3',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q4',\n name: 'Q4',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n ],\n [],\n );\n\n return (\n <Table\n tableConfig={{\n containerStyle: { height: '700px' },\n subRows: {\n getSubRows: (row) => row?.subRows,\n rowKeyGetter: (row) => row.id,\n },\n resizableColumn: true,\n }}\n columnConfig={columns}\n rows={rows}\n />\n );\n }"
52101
+ },
52102
+ {
52103
+ "exportName": "LazyLoadChildren",
52104
+ "displayName": "Ленивая подгрузка детей группы",
52105
+ "type": "full-code",
52106
+ "code": "const STEP = 10; // сколько детей догружаем за клик\nconst COLS = 4; // число колонок — на столько растягиваем служебную строку\n\n// Дети группы для таблицы: загруженные + служебная строка «Показать ещё», пока есть что грузить.\nconst buildSubRows = (group) => {\n const children = Array.from({ length: group.loaded }, (_, i) => makeChild(group.id, i));\n if (group.loaded < group.total) {\n children.push({ id: \\"
52033
52107
  }
52034
52108
  ]
52035
52109
  },
@@ -52383,6 +52457,13 @@
52383
52457
  "importStatement": "import { HoverEffectsConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52384
52458
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
52385
52459
  },
52460
+ "AppearanceConfig": {
52461
+ "name": "AppearanceConfig",
52462
+ "definition": "export type AppearanceConfig = {\n /**\n * `'clean'` — «чистый» вид: без линий сетки и внешних рамок, шапка на белом\n * фоне с серым текстом.\n * @default 'default'\n */\n variant?: AppearanceVariant;\n /**\n * Зебра: строки через одну окрашены серым. Работает в любом `variant`.\n * @default false\n */\n zebra?: boolean;\n};",
52463
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52464
+ "importStatement": "import { AppearanceConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52465
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
52466
+ },
52386
52467
  "ColumnGlideInstance": {
52387
52468
  "name": "ColumnGlideInstance",
52388
52469
  "definition": "export type ColumnGlideInstance<\n R extends ObjectForExtending,\n SR,\n CustomCtxs extends ObjectForExtending = {},\n> = {\n key: string;\n name: string | CanvasEl;\n nameAsString?: string;\n readonly width?: number;\n isServiceColumn?: boolean;\n isErrorCell?: (row: R) => boolean;\n frozen?: boolean;\n /** Минимальная ширина колонки (px). Ограничивает ресайз и начальную ширину снизу. */\n minWidth?: number;\n /** Максимальная ширина колонки (px). Ограничивает ресайз и начальную ширину сверху. */\n maxWidth?: number;\n /** Максимальная ширина колонки при auto-sizing и grow-распределении (px). Не ограничивает ручной ресайз. */\n maxAutoWidth?: number;\n renderHeaderCell?: (\n cellInfo: HeaderCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CanvasContent;\n renderCell?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellContent;\n contentAlign?: 'left' | 'right' | 'center';\n copyData?: string | ((row: R) => string);\n editable?: boolean | ((row: R) => boolean);\n renderEditCell?: (\n cellInfo: EditingCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => ReactNode;\n /**\n * Кастомный рендер preview-ячейки (при двойном клике на readonly-ячейку).\n * 'none' — отключает превью. 'cellEditorAsPreview' — стандартный текстовый превью.\n * Функция — полностью кастомный рендер.\n */\n renderCellPreview?:\n | 'none'\n | 'cellEditorAsPreview'\n | ((\n cellInfo: PreviewCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => ReactNode);\n renderSummaryCell?: (\n cellInfo: SummaryCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellContent;\n colSpan?:\n | number\n | ((cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>) => number);\n /** Объединение строк: (cellInfo) => [перваяСтрока, последняяСтрока] | null (см. TableGlide RowSpan). */\n rowSpan?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => readonly [number, number] | null;\n /** Выравнивание контента в объединённой ячейке тела; в adaptColumn идёт в glide как `spanAlign`. */\n spanAlign?:\n | SpanCellAlign\n | ((\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => SpanCellAlign | undefined);\n /** Выравнивание в объединённой шапке; в adaptColumn идёт в glide как `spanGroupHeaderAlign`. */\n squashedHeaderAlign?: HeaderAlignment;\n /** Тултип для ячеек этой колонки. Строка, объект или функция (context) => config | null. */\n cellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n row: R;\n column: ColumnGlideInstance<R, SR, CustomCtxs>;\n ctxs: CtxsType<CustomCtxs>;\n refTable?: React.Ref<DataEditorRef>;\n colInd?: number;\n rowInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /** Тултип для шапки колонки. Строка, объект или функция (context) => config | null. */\n headerCellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n column: ColumnGlideInstance<R, SR, CustomCtxs>;\n ctxs: CtxsType<CustomCtxs>;\n refTable?: React.Ref<DataEditorRef>;\n colInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n columnThemeOverride?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellThemeOverrideResult | undefined;\n};",
@@ -52859,6 +52940,13 @@
52859
52940
  "importStatement": "import { MergedCellsAlign } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52860
52941
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/merged-cells.type.ts"
52861
52942
  },
52943
+ "AppearanceVariant": {
52944
+ "name": "AppearanceVariant",
52945
+ "definition": "export type AppearanceVariant = 'default' | 'clean';",
52946
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52947
+ "importStatement": "import { AppearanceVariant } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52948
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
52949
+ },
52862
52950
  "CanvasEl": {
52863
52951
  "name": "CanvasEl",
52864
52952
  "definition": "export type CanvasEl = ReactElement;",
@@ -53008,7 +53096,7 @@
53008
53096
  },
53009
53097
  "ColumnGlideCustoms": {
53010
53098
  "name": "ColumnGlideCustoms",
53011
- "definition": "export type ColumnGlideCustoms<R extends ObjectForExtending, SR = unknown> = {\n id: string;\n /** Служебные колонки (marker / checkbox / row instruments) живут по отдельным правилам подсветки. */\n isServiceColumn?: boolean;\n /** Внутренний helper для cell-level error outline, совпадающий по семантике с Table editing error. */\n isErrorCell?: (row: R) => boolean;\n renderHeaderCell?: (cellInfo: HeaderCellInfo<R, SR>) => CanvasContent;\n /** Текстовое представление ячейки для копирования в clipboard (Ctrl+C). */\n copyData?: string | ((row: R) => string);\n editable?: boolean | ((row: R) => boolean);\n contentAlign?: 'right' | 'left' | 'center';\n renderCell?: ColumnGlideGetCellContent<R, SR>;\n renderEditCell?: (cellInfo: EditingCellInfoGlide<R, SR>) => CellContent;\n renderSummaryCell?: (summaryCellInfo: SummaryCellInfo<R, SR>) => CellContent;\n colSpan?: ColSpan<R, SR>;\n rowSpan?: RowSpan<R, SR>;\n /** Выравнивание контента в объединённых ячейках колонки; функция — если нужно задавать для каждого блока отдельно. */\n spanAlign?: SpanCellAlign | ((cellInfo: CellInfo<R, SR>) => SpanCellAlign | undefined);\n /** Тултип для ячеек этой колонки. Строка, объект или функция (context) => config | null. */\n cellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n row: R;\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n rowInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /** Тултип для шапки этой колонки. Строка, объект или функция (context) => config | null. */\n headerCellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /**\n * Свой цвет ячеек колонки (тема ячейки).\n *\n * Цвет лучше брать из темы (`cellInfo.theme`), например статусные\n * `theme.bgCellPositive / bgCellNegative / bgCellWarning / bgCellInfo`:\n * они свои для каждой темы. Фиксированный hex в тёмной теме останется\n * таким же светлым, как в светлой.\n *\n * Подробнее. Если вернуть `bgCell` hex-цветом (`#RGB`, `#RRGGBB`,\n * `#RRGGBBAA` — прозрачный цвет сначала смешивается с фоном ячейки),\n * таблица сама посчитает его состояния (под курсором, в выбранной строке,\n * в выделении) — цвет ведёт себя как встроенные. Не-hex значение\n * (`rgba()`, `var()` и т. п.) применяется как есть, без состояний: ячейка\n * не отреагирует на курсор и выделение.\n */\n columnThemeOverride?: (\n cellInfo: CellInfo<R, SR>\n ) => CellThemeOverrideResult | undefined;\n /** Управление preview для колонки. true — включить overlay, 'none' — отключить (в т.ч. стандартный). */\n hasPreview?: boolean | 'none';\n /** Минимальная ширина колонки (px). Ограничивает ресайз и начальную ширину снизу. */\n minWidth?: number;\n /** Максимальная ширина колонки (px). Ограничивает ресайз и начальную ширину сверху. */\n maxWidth?: number;\n};",
53099
+ "definition": "export type ColumnGlideCustoms<R extends ObjectForExtending, SR = unknown> = {\n id: string;\n /** Служебные колонки (marker / checkbox / row instruments) живут по отдельным правилам подсветки. */\n isServiceColumn?: boolean;\n /** Внутренний helper для cell-level error outline, совпадающий по семантике с Table editing error. */\n isErrorCell?: (row: R) => boolean;\n renderHeaderCell?: (cellInfo: HeaderCellInfo<R, SR>) => CanvasContent;\n /** Текстовое представление ячейки для копирования в clipboard (Ctrl+C). */\n copyData?: string | ((row: R) => string);\n editable?: boolean | ((row: R) => boolean);\n contentAlign?: 'right' | 'left' | 'center';\n renderCell?: ColumnGlideGetCellContent<R, SR>;\n renderEditCell?: (cellInfo: EditingCellInfoGlide<R, SR>) => CellContent;\n renderSummaryCell?: (summaryCellInfo: SummaryCellInfo<R, SR>) => CellContent;\n colSpan?: ColSpan<R, SR>;\n rowSpan?: RowSpan<R, SR>;\n /** Выравнивание контента в объединённых ячейках колонки; функция — если нужно задавать для каждого блока отдельно. */\n spanAlign?: SpanCellAlign | ((cellInfo: CellInfo<R, SR>) => SpanCellAlign | undefined);\n /** Тултип для ячеек этой колонки. Строка, объект или функция (context) => config | null. */\n cellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n row: R;\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n rowInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /** Тултип для шапки этой колонки. Строка, объект или функция (context) => config | null. */\n headerCellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /**\n * Свой цвет ячеек колонки (тема ячейки).\n *\n * Цвет лучше брать из темы (`cellInfo.theme`), например статусные\n * `theme.bgCellPositive / bgCellNegative / bgCellWarning / bgCellInfo`:\n * они свои для каждой темы. Фиксированный hex в тёмной теме останется\n * таким же светлым, как в светлой.\n *\n * Подробнее. Если вернуть `bgCell` hex-цветом (`#RGB`, `#RRGGBB`,\n * `#RRGGBBAA` — прозрачный цвет сначала смешивается с фоном ячейки),\n * таблица сама посчитает его состояния (под курсором, в выбранной строке,\n * в выделении) — цвет ведёт себя как встроенные. Не-hex значение\n * (`rgba()`, `var()` и т. п.) применяется как есть, без состояний: ячейка\n * не отреагирует на курсор и выделение.\n */\n columnThemeOverride?: (\n cellInfo: CellInfo<R, SR>\n ) => CellThemeOverrideResult | undefined;\n /** Управление preview для колонки. true — включить overlay, 'none' — отключить (в т.ч. стандартный). */\n hasPreview?: boolean | 'none';\n /**\n * Минимальная ширина колонки в пикселях. Уже этого значения колонку нельзя\n * сжать ни мышью, ни автоматическим расчётом ширины.\n *\n * Подробнее: у каждой колонки есть ещё минимум по содержимому шапки\n * (отступы ячейки, иконки пина и перетаскивания, буква с многоточием,\n * кнопки фильтра и сортировки), он считается в calculateMinColumnWidth.\n * Итоговый минимум это большее из двух, поэтому значение меньше\n * автоматического не действует.\n */\n minWidth?: number;\n /** Максимальная ширина колонки (px). Ограничивает ресайз и начальную ширину сверху. */\n maxWidth?: number;\n};",
53012
53100
  "internal": true,
53013
53101
  "importNotice": "Тип \"ColumnGlideCustoms\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
53014
53102
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
@@ -53435,7 +53523,7 @@
53435
53523
  },
53436
53524
  "TableCanvas.TableConfig": {
53437
53525
  "name": "TableConfig",
53438
- "definition": "export type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@sber-digital-finance-ui/ui-kit';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n };\n /**\n * editing - активация редактирования. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={editing: {onRowsChange, rowKeyGetter}}\n *\n * columnConf…",
53526
+ "definition": "export type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * Готовые варианты внешнего вида таблицы.\n *\n * `variant: 'clean'` — без линий сетки и внешних рамок, шапка на белом фоне\n * с серым текстом. Отдельные линии можно вернуть через `borders`.\n *\n * `zebra: true` — строки через одну окрашены серым, работает в любом варианте.\n */\n appearance?: AppearanceConfig;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@sber-digital-finance-ui/ui-kit';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элемент…",
53439
53527
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53440
53528
  "importStatement": "import { TableConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53441
53529
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
@@ -53582,7 +53670,7 @@
53582
53670
  },
53583
53671
  "TableGlideCustomProps": {
53584
53672
  "name": "TableGlideCustomProps",
53585
- "definition": "export type TableGlideCustomProps<\n R extends ObjectForExtending,\n SR = unknown\n> = {\n columns: ColumnGlideLast<R, SR>[];\n rows: readonly R[];\n bottomSummaryRows?: readonly SR[];\n rowSize?: SIZE;\n rowHeight?:\n | ((\n row: R,\n currentRowSize: {\n rowSizeName: SIZE;\n rowSizeValue: number;\n },\n rowIndex: number\n ) => number)\n | number\n | undefined\n | null;\n ctxs?: ObjectForExtending;\n renderGroupHeader?: (\n args: RenderGroupHeaderArgs\n ) => 'default' | { defaultWithCustomGroupName: string } | CanvasEl;\n /** Выравнивание текста в объединённой шапке по ключу группы (ColumnGroupConfig.key). */\n groupAlignMap?: Map<string, SpanAlignment>;\n refTable?: Ref<DataEditorRef>;\n onColumnsReorder?: (sourceKey: string, targetKey: string) => void;\n /** Ref на контейнер таблицы — события portal hover диспатчатся на него, чтобы несколько таблиц не перехватывали чужие тултипы */\n portalEventTargetRef?: RefObject<HTMLElement | null>;\n /** Откреплённая шапка — header уезжает вместе со скроллом */\n unstickyHeader?: boolean;\n // отключает resize колонок (по умолчанию true)\n resizableColumn?: boolean;\n /** Внешний ref на wrapper-div (для TableCanvas - refTableContainer) */\n containerRef?: Ref<HTMLDivElement>;\n /** className для wrapper-div */\n containerClassName?: string;\n /** inline-style для wrapper-div */\n containerStyle?: CSSProperties;\n /** Рендер overlay-фич (tooltip, contextMenu, popover) внутри wrapper-div когда DOM готов */\n renderOverlayFeatures?: (ctx: {\n containerElement: HTMLDivElement;\n renderInContainer: (children: ReactNode) => ReactPortal | null;\n }) => ReactNode;\n /** Не рендерить canvas-grid, оставив только overlay-content внутри wrapper. */\n hideGrid?: boolean;\n /** DOM-узел content-state (empty/error), рендерится как прямой child контейнера. */\n contentStateNode?: ReactNode;\n /** Дополнительный контент wrapper-div, не зависящий от готовности canvas-grid. */\n containerSlot?: ReactNode;\n /** Флаг fullscreen - пересканирование DOM при переключении */\n fullScreened?: boolean;\n /** Переносит editor overlay внутрь контейнера (вместо document.body). Для модалок с CSS transform. */\n editorOverlayPortal?: 'inside';\n groupHeaderHeight?: number[];\n /** Управляет canvas-подсветкой активной сущности поверх glide selection. */\n highlightActiveType?: HighlightActiveType;\n /** Режим выделения ячеек (нативный glide selection). По умолчанию 'range-cell'. */\n cellsSelectionMode?: CellsSelectionMode;\n /** Канал для copy/paste (selectionRef потребителя), отдельно от controlled gridSelection. */\n onSelectionEmit?: (selection: GridSelection) => void;\n /**\n * Ключи выделенных КОЛОНОК (объединение: одиночный клик/Shift/select-all +\n * Ctrl-мультивыбор), без сервисных колонок. Канал наверх для контрл-блока\n * (например «Закрепить столбцы»). Обычное выделение ячеек сюда не попадает.\n */\n onColumnSelectionChange?: (selectedColumnKeys: string[]) => void;\n /**\n * Follow-выделение: после реордера (закрепление колонок) заново выделить эти\n * ключи. Пустой массив → снять выделение. null/undefined → не трогать.\n */\n pendingColumnSelectionKeys?: string[] | null;\n /** Вызывается после применения pendingColumnSelectionKeys (сброс pending). */\n onColumnSelectionApplied?: () => void;\n /** Controlled-значение подсвеченной строки (highlightActiveType='row'). */\n highlightActiveRow?: number;\n /**\n * Controlled-сеттер подсвеченной строки. Вторым аргументом отдаёт сам объект\n * строки (`rows[index]`) — чтобы потребитель получал узел без onCellClicked.\n */\n onHighlightActiveRowChange?: (\n row: number | undefined,\n rowData?: R | undefined\n ) => void;\n /**\n * Режим подсветки строки controlled (значением владеют снаружи). Если не\n * задан — таблица крутит подсветку внутренним стейтом, но колбэк всё равно\n * вызывается (подписка без владения).\n */\n highlightActiveRowControlled?: boolean;\n /** Выделение колонок по клику на шапку (независимо от highlightActiveType). По умолчанию true. */\n enableColumnSelection?: boolean;\n /** Выделение строк по клику/драгу на колонке нумерации. По умолчанию true. */\n enableRowSelection?: boolean;\n /** Выделение всей таблицы кликом по шапке колонки нумерации. По умолчанию true. */\n enableSelectAll?: boolean;\n /** Индексы строк, выбранных через checkbox selection. */\n checkboxSelectedRowIndexes?: ReadonlySet<number>;\n /**\n * Индексы строк, у которых ЕСТЬ (виден) чекбокс.\n * @deprecated На цвет не влияет: наличие чекбокса не меняет цвет выбранной\n * строки, ступень добавляет только НАЖАТЫЙ чекбокс\n * (`checkboxSelectedRowIndexes`). Удалить в следующем мажоре.\n */\n checkboxVisibleRowIndexes?: ReadonlySet<number>;\n /**\n * Эффекты при наведении. `hoverEffects.row` — подсветка строки под курсором:\n * рисуется через bgCell (getRowThemeOverride), т.е. лежит ПОД селектингом и\n * highlightActiveType — они рисуются поверх (highlightRegions) и визуально\n * перекрывают hover. По умолчанию row-подсветка ВКЛЮЧЕНА; выключение —\n * явное `{ row: false }`.\n */\n hoverEffects?: HoverEffectsConfig;\n /** Включает компенсацию тонких canvas-линий при browser zoom ниже 100% / DPR < 1. */\n enableLowDprHairline?: boolean;\n};",
53673
+ "definition": "export type TableGlideCustomProps<\n R extends ObjectForExtending,\n SR = unknown\n> = {\n columns: ColumnGlideLast<R, SR>[];\n rows: readonly R[];\n bottomSummaryRows?: readonly SR[];\n rowSize?: SIZE;\n rowHeight?:\n | ((\n row: R,\n currentRowSize: {\n rowSizeName: SIZE;\n rowSizeValue: number;\n },\n rowIndex: number\n ) => number)\n | number\n | undefined\n | null;\n ctxs?: ObjectForExtending;\n renderGroupHeader?: (\n args: RenderGroupHeaderArgs\n ) => 'default' | { defaultWithCustomGroupName: string } | CanvasEl;\n /** Выравнивание текста в объединённой шапке по ключу группы (ColumnGroupConfig.key). */\n groupAlignMap?: Map<string, SpanAlignment>;\n refTable?: Ref<DataEditorRef>;\n onColumnsReorder?: (sourceKey: string, targetKey: string) => void;\n /** Ref на контейнер таблицы — события portal hover диспатчатся на него, чтобы несколько таблиц не перехватывали чужие тултипы */\n portalEventTargetRef?: RefObject<HTMLElement | null>;\n /** Откреплённая шапка — header уезжает вместе со скроллом */\n unstickyHeader?: boolean;\n // отключает resize колонок (по умолчанию true)\n resizableColumn?: boolean;\n /** Внешний ref на wrapper-div (для TableCanvas - refTableContainer) */\n containerRef?: Ref<HTMLDivElement>;\n /** className для wrapper-div */\n containerClassName?: string;\n /** inline-style для wrapper-div */\n containerStyle?: CSSProperties;\n /** Рендер overlay-фич (tooltip, contextMenu, popover) внутри wrapper-div когда DOM готов */\n renderOverlayFeatures?: (ctx: {\n containerElement: HTMLDivElement;\n renderInContainer: (children: ReactNode) => ReactPortal | null;\n }) => ReactNode;\n /** Не рендерить canvas-grid, оставив только overlay-content внутри wrapper. */\n hideGrid?: boolean;\n /** DOM-узел content-state (empty/error), рендерится как прямой child контейнера. */\n contentStateNode?: ReactNode;\n /** Дополнительный контент wrapper-div, не зависящий от готовности canvas-grid. */\n containerSlot?: ReactNode;\n /** Флаг fullscreen - пересканирование DOM при переключении */\n fullScreened?: boolean;\n /** Переносит editor overlay внутрь контейнера (вместо document.body). Для модалок с CSS transform. */\n editorOverlayPortal?: 'inside';\n groupHeaderHeight?: number[];\n /** Управляет canvas-подсветкой активной сущности поверх glide selection. */\n highlightActiveType?: HighlightActiveType;\n /** Режим выделения ячеек (нативный glide selection). По умолчанию 'range-cell'. */\n cellsSelectionMode?: CellsSelectionMode;\n /** Канал для copy/paste (selectionRef потребителя), отдельно от controlled gridSelection. */\n onSelectionEmit?: (selection: GridSelection) => void;\n /**\n * Ключи выделенных КОЛОНОК (объединение: одиночный клик/Shift/select-all +\n * Ctrl-мультивыбор), без сервисных колонок. Канал наверх для контрл-блока\n * (например «Закрепить столбцы»). Обычное выделение ячеек сюда не попадает.\n */\n onColumnSelectionChange?: (selectedColumnKeys: string[]) => void;\n /**\n * Follow-выделение: после реордера (закрепление колонок) заново выделить эти\n * ключи. Пустой массив → снять выделение. null/undefined → не трогать.\n */\n pendingColumnSelectionKeys?: string[] | null;\n /** Вызывается после применения pendingColumnSelectionKeys (сброс pending). */\n onColumnSelectionApplied?: () => void;\n /** Controlled-значение подсвеченной строки (highlightActiveType='row'). */\n highlightActiveRow?: number;\n /**\n * Controlled-сеттер подсвеченной строки. Вторым аргументом отдаёт сам объект\n * строки (`rows[index]`) — чтобы потребитель получал узел без onCellClicked.\n */\n onHighlightActiveRowChange?: (\n row: number | undefined,\n rowData?: R | undefined\n ) => void;\n /**\n * Режим подсветки строки controlled (значением владеют снаружи). Если не\n * задан — таблица крутит подсветку внутренним стейтом, но колбэк всё равно\n * вызывается (подписка без владения).\n */\n highlightActiveRowControlled?: boolean;\n /** Выделение колонок по клику на шапку (независимо от highlightActiveType). По умолчанию true. */\n enableColumnSelection?: boolean;\n /** Выделение строк по клику/драгу на колонке нумерации. По умолчанию true. */\n enableRowSelection?: boolean;\n /** Выделение всей таблицы кликом по шапке колонки нумерации. По умолчанию true. */\n enableSelectAll?: boolean;\n /** Индексы строк, выбранных через checkbox selection. */\n checkboxSelectedRowIndexes?: ReadonlySet<number>;\n /**\n * Индексы строк, у которых ЕСТЬ (виден) чекбокс.\n * @deprecated На цвет не влияет: наличие чекбокса не меняет цвет выбранной\n * строки, ступень добавляет только НАЖАТЫЙ чекбокс\n * (`checkboxSelectedRowIndexes`). Удалить в следующем мажоре.\n */\n checkboxVisibleRowIndexes?: ReadonlySet<number>;\n /**\n * Эффекты при наведении. `hoverEffects.row` — подсветка строки под курсором:\n * рисуется через bgCell (getRowThemeOverride), т.е. лежит ПОД селектингом и\n * highlightActiveType — они рисуются поверх (highlightRegions) и визуально\n * перекрывают hover. По умолчанию row-подсветка ВКЛЮЧЕНА; выключение —\n * явное `{ row: false }`.\n */\n hoverEffects?: HoverEffectsConfig;\n /** Внешний вид: «чистый» вариант и зебра. См. {@link AppearanceConfig}. */\n appearance?: AppearanceConfig;\n /** Включает компенсацию тонких canvas-линий при browser zoom ниже 100% / DPR < 1. */\n enableLowDprHairline?: boolean;\n};",
53586
53674
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53587
53675
  "importStatement": "import { TableGlideCustomProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53588
53676
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
@@ -53666,7 +53754,7 @@
53666
53754
  },
53667
53755
  "CanvasTextOptions": {
53668
53756
  "name": "CanvasTextOptions",
53669
- "definition": "export interface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n}",
53757
+ "definition": "export interface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n /**\n * Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\n * остаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n *\n * Подробнее: при измерении текст выставляет себе minContentWidth, равный\n * ширине первого видимого символа с многоточием. Работает только для\n * однострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\n * остальных случаях minContentWidth не заполняется. Явный style.minWidth\n * важнее. По умолчанию выключено.\n */\n minWidthByContent?: boolean;\n}",
53670
53758
  "internal": true,
53671
53759
  "importNotice": "Тип \"CanvasTextOptions\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
53672
53760
  "sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/primitives/CanvasText.ts"
@@ -54177,7 +54265,7 @@
54177
54265
  },
54178
54266
  "HeaderCellInfo": {
54179
54267
  "name": "HeaderCellInfo",
54180
- "definition": "export type HeaderCellInfo<R extends ObjectForExtending, SR> = {\n column: ColumnGlideLast<R, SR>;\n drawArgs: DrawHeaderArgs;\n ctxs: ObjectForExtending;\n theme: Theme;\n};",
54268
+ "definition": "export type HeaderCellInfo<R extends ObjectForExtending, SR> = {\n column: ColumnGlideLast<R, SR>;\n drawArgs: DrawHeaderArgs;\n /**\n * Колонка выделена в таблице. Шапка такой колонки ведёт себя как при\n * наведении: показывает кнопки и подсвечивает название.\n *\n * Подробнее: считается в TableGlide через isColumnInSelection: клик по\n * шапке, активная колонка текущего диапазона или колонка, покрытая\n * ячейками rangeStack. Поле drawArgs.isSelected от Glide для этого не\n * подходит: выделение колонок хранится отдельно, и selection.columns у\n * Glide намеренно пуст.\n */\n columnIsSelected: boolean;\n ctxs: ObjectForExtending;\n theme: Theme;\n};",
54181
54269
  "internal": true,
54182
54270
  "importNotice": "Тип \"HeaderCellInfo\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54183
54271
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
@@ -54520,14 +54608,14 @@
54520
54608
  },
54521
54609
  "Table.ColumnsControlConfig": {
54522
54610
  "name": "ColumnsControlConfig",
54523
- "definition": "export type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};",
54611
+ "definition": "export type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};",
54524
54612
  "internal": true,
54525
54613
  "importNotice": "Тип \"ColumnsControlConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54526
54614
  "sourceFile": "packages/ui-kit/src/components/Table/feature-column-control/types.ts"
54527
54615
  },
54528
54616
  "TableCanvas.ColumnsControlConfig": {
54529
54617
  "name": "ColumnsControlConfig",
54530
- "definition": "export type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};",
54618
+ "definition": "export type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};",
54531
54619
  "internal": true,
54532
54620
  "importNotice": "Тип \"ColumnsControlConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54533
54621
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-column-control/types.ts"
@@ -54730,7 +54818,7 @@
54730
54818
  },
54731
54819
  "FlexStyle": {
54732
54820
  "name": "FlexStyle",
54733
- "definition": "export interface FlexStyle {\n id?: string;\n flexGrow: number;\n flexShrink: number;\n flexBasis: number;\n alignSelf?: Align | 'auto';\n width?: number;\n height?: number;\n crossAxisSizing?: CrossAxisSizing;\n metadata?: unknown;\n}",
54821
+ "definition": "export interface FlexStyle {\n id?: string;\n flexGrow: number;\n flexShrink: number;\n flexBasis: number;\n alignSelf?: Align | 'auto';\n width?: number;\n height?: number;\n /**\n * Минимальная ширина элемента в раскладке. Когда места в строке не хватает,\n * элемент сжимается только до неё. Например, текст с многоточием так\n * сохраняет хотя бы первую букву.\n *\n * Подробнее: действует только по главной оси при направлении row. Применяется\n * после распределения сжатия между детьми, остальные дети при этом заново не\n * ужимаются, поэтому сумма ширин может превысить контейнер, и лишнее выходит\n * за его границу. Если не задано, ограничения нет.\n */\n minWidth?: number;\n crossAxisSizing?: CrossAxisSizing;\n metadata?: unknown;\n}",
54734
54822
  "internal": true,
54735
54823
  "importNotice": "Тип \"FlexStyle\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54736
54824
  "sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/miniflex/types.ts"
@@ -55078,6 +55166,13 @@
55078
55166
  "importNotice": "Тип \"FeatureItem\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
55079
55167
  "sourceFile": "packages/ui-kit/src/components/Table/widgets/control-block/types.ts"
55080
55168
  },
55169
+ "ColumnsControlApplyMode": {
55170
+ "name": "ColumnsControlApplyMode",
55171
+ "definition": "export type ColumnsControlApplyMode = 'confirm' | 'instant';",
55172
+ "internal": true,
55173
+ "importNotice": "Тип \"ColumnsControlApplyMode\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
55174
+ "sourceFile": "packages/ui-kit/src/components/Table/feature-column-control/types.ts"
55175
+ },
55081
55176
  "IconsPropType": {
55082
55177
  "name": "IconsPropType",
55083
55178
  "definition": "export type IconsPropType = {\n closed?: ReactNode;\n opened?: ReactNode;\n iconButtonProps?: IconButtonProps;\n};",