@daisforge/ui-mcp 0.2.9 → 0.2.10
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.
- package/data/component-index.json +270 -87
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"generatedAt": "2026-
|
|
3
|
-
"libVersion": "1.
|
|
2
|
+
"generatedAt": "2026-11-02T13:21:10.298Z",
|
|
3
|
+
"libVersion": "1.27.0",
|
|
4
4
|
"components": {
|
|
5
5
|
"Accordion": {
|
|
6
6
|
"name": "Accordion",
|
|
@@ -24856,7 +24856,7 @@
|
|
|
24856
24856
|
"exportName": "Usage1",
|
|
24857
24857
|
"displayName": "Использование в TableCanvas.headerRowHeight.stories.tsx",
|
|
24858
24858
|
"type": "usage",
|
|
24859
|
-
"code": "<Slider\n
|
|
24859
|
+
"code": "<Slider\n value={headerRowHeight}\n onChange={setHeaderRowHeight}\n min={24}\n max={96}\n step={1}\n />",
|
|
24860
24860
|
"sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.HeaderRowHeight/TableCanvas.headerRowHeight.stories.tsx"
|
|
24861
24861
|
},
|
|
24862
24862
|
{
|
|
@@ -28196,10 +28196,10 @@
|
|
|
28196
28196
|
"description": ""
|
|
28197
28197
|
},
|
|
28198
28198
|
{
|
|
28199
|
-
"name": "
|
|
28200
|
-
"type": "
|
|
28199
|
+
"name": "groupHeaderRowHeight",
|
|
28200
|
+
"type": "number | undefined",
|
|
28201
28201
|
"required": false,
|
|
28202
|
-
"description": "
|
|
28202
|
+
"description": "Высота каждого уровня групповых заголовков; по умолчанию `headerHeight`"
|
|
28203
28203
|
},
|
|
28204
28204
|
{
|
|
28205
28205
|
"name": "renderOverlayFeatures",
|
|
@@ -28263,7 +28263,7 @@
|
|
|
28263
28263
|
},
|
|
28264
28264
|
{
|
|
28265
28265
|
"name": "columnSelectionMode",
|
|
28266
|
-
"type": "\"
|
|
28266
|
+
"type": "\"auto\" | \"multi\" | undefined",
|
|
28267
28267
|
"required": false,
|
|
28268
28268
|
"description": "Determines if column selection requires a modifier key to enable multi-selection or not. In auto mode it adapts to\ntouch or mouse environments automatically, in multi-mode it always acts as if the multi key (Ctrl) is pressed."
|
|
28269
28269
|
},
|
|
@@ -28381,6 +28381,12 @@
|
|
|
28381
28381
|
"required": false,
|
|
28382
28382
|
"description": "Enables or disables the overlay shadow when scrolling vertical"
|
|
28383
28383
|
},
|
|
28384
|
+
{
|
|
28385
|
+
"name": "focusOnStateChange",
|
|
28386
|
+
"type": "boolean | undefined",
|
|
28387
|
+
"required": false,
|
|
28388
|
+
"description": "Фокусировать грид при внешней смене controlled gridSelection. По умолчанию true."
|
|
28389
|
+
},
|
|
28384
28390
|
{
|
|
28385
28391
|
"name": "freezeColumns",
|
|
28386
28392
|
"type": "number | undefined",
|
|
@@ -28532,6 +28538,12 @@
|
|
|
28532
28538
|
"required": false,
|
|
28533
28539
|
"description": "If specified, it will be used to render Markdown, instead of the default Markdown renderer used by the Grid.\nYou'll want to use this if you need to process your Markdown for security purposes, or if you want to use a\nrenderer with different Markdown features."
|
|
28534
28540
|
},
|
|
28541
|
+
{
|
|
28542
|
+
"name": "maxAutoRowHeight",
|
|
28543
|
+
"type": "number | undefined",
|
|
28544
|
+
"required": false,
|
|
28545
|
+
"description": "Потолок высоты строки при `rowHeight: 'auto'`, по умолчанию 480"
|
|
28546
|
+
},
|
|
28535
28547
|
{
|
|
28536
28548
|
"name": "maxColumnAutoWidth",
|
|
28537
28549
|
"type": "number | undefined",
|
|
@@ -28778,6 +28790,12 @@
|
|
|
28778
28790
|
"required": false,
|
|
28779
28791
|
"description": "Emitted whenever the visible cells change, usually due to scrolling."
|
|
28780
28792
|
},
|
|
28793
|
+
{
|
|
28794
|
+
"name": "outlineEachRange",
|
|
28795
|
+
"type": "boolean | undefined",
|
|
28796
|
+
"required": false,
|
|
28797
|
+
"description": "Рамка у каждого Ctrl-диапазона ячеек (multi-range-cell), а не только у активного. По умолчанию false."
|
|
28798
|
+
},
|
|
28781
28799
|
{
|
|
28782
28800
|
"name": "overscrollX",
|
|
28783
28801
|
"type": "number | undefined",
|
|
@@ -28882,7 +28900,7 @@
|
|
|
28882
28900
|
},
|
|
28883
28901
|
{
|
|
28884
28902
|
"name": "rowSelectionMode",
|
|
28885
|
-
"type": "\"
|
|
28903
|
+
"type": "\"auto\" | \"multi\" | undefined",
|
|
28886
28904
|
"required": false,
|
|
28887
28905
|
"description": "Determines if row selection requires a modifier key to enable multi-selection or not. In auto mode it adapts to\ntouch or mouse environments automatically, in multi-mode it always acts as if the multi key (Ctrl) is pressed."
|
|
28888
28906
|
},
|
|
@@ -29018,6 +29036,12 @@
|
|
|
29018
29036
|
"required": false,
|
|
29019
29037
|
"description": ""
|
|
29020
29038
|
},
|
|
29039
|
+
{
|
|
29040
|
+
"name": "onCellClicked",
|
|
29041
|
+
"type": "((cell: readonly [number, number], info: TableInfoWithRow<R, SR, CustomCtxs>, event: CellClickedEventArgs) => void) | undefined",
|
|
29042
|
+
"required": false,
|
|
29043
|
+
"description": ""
|
|
29044
|
+
},
|
|
29021
29045
|
{
|
|
29022
29046
|
"name": "onCellContextMenu",
|
|
29023
29047
|
"type": "((cell: Item, event: CellClickedEventArgs, args_2: TableInfoWithRow<R, SR, CustomCtxs>) => void) | undefined",
|
|
@@ -29146,7 +29170,7 @@
|
|
|
29146
29170
|
},
|
|
29147
29171
|
{
|
|
29148
29172
|
"name": "rowHeight",
|
|
29149
|
-
"type": "
|
|
29173
|
+
"type": "RowHeightProp<R>",
|
|
29150
29174
|
"required": false,
|
|
29151
29175
|
"description": ""
|
|
29152
29176
|
},
|
|
@@ -29192,7 +29216,7 @@
|
|
|
29192
29216
|
}
|
|
29193
29217
|
],
|
|
29194
29218
|
"propsTypeName": "TableGlideInstanceProps",
|
|
29195
|
-
"rawType": "export type TableGlideInstanceProps<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = Omit<\n TableGlideProps<R, SR>,\n 'columns' | 'onHeaderContextMenu' | 'onCellContextMenu'\n> & {\n columns: readonly ColumnGlideInstance<R, SR, CustomCtxs>[];\n onHeaderContextMenuDropdown?: HeaderContextMenuDropdownProps<\n R,\n SR,\n CustomCtxs\n >;\n onCellContextMenuDropdown?: CellContextMenuDropdownProps<R, SR>;\n containerProps?: {\n className?: string;\n style?: React.CSSProperties;\n ref?: React.Ref<HTMLDivElement>;\n };\n contentStateOverlay?: TableContentStateOverlay;\n renderOverlayFeatures?: (ctx: {\n containerElement: HTMLDivElement;\n renderInContainer: (children: React.ReactNode) => React.ReactPortal | null;\n }) => React.ReactNode;\n CellReadOnlyEditor: (\n props: CellReadOnlyEditorGlideInstanceProps<R, SR>,\n ) => ReactNode;\n onRowsChange?: (\n rows: R[],\n data: RowsChangeDataGlideInstance<R, SR, CustomCtxs>,\n ) => void;\n onCellClicked?: (\n cell: readonly [number, number],\n info: TableInfoWithRow<R, SR, CustomCtxs>,\n ) => void;\n stickyColumnsConfig?: StickyColumnsConfig<\n ColumnGlideInstance<R, SR, CustomCtxs>\n >;\n stickyRowsConfig?: StickyRowsConfig<R>;\n} & TableGlideInstanceContextMenu<R, SR, CustomCtxs>;",
|
|
29219
|
+
"rawType": "export type TableGlideInstanceProps<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = Omit<\n TableGlideProps<R, SR>,\n 'columns' | 'onHeaderContextMenu' | 'onCellContextMenu' | 'onCellClicked'\n> & {\n columns: readonly ColumnGlideInstance<R, SR, CustomCtxs>[];\n onHeaderContextMenuDropdown?: HeaderContextMenuDropdownProps<\n R,\n SR,\n CustomCtxs\n >;\n onCellContextMenuDropdown?: CellContextMenuDropdownProps<R, SR>;\n /** Высота каждого уровня групповых заголовков; по умолчанию `headerHeight` */\n groupHeaderRowHeight?: number;\n containerProps?: {\n className?: string;\n style?: React.CSSProperties;\n ref?: React.Ref<HTMLDivElement>;\n };\n contentStateOverlay?: TableContentStateOverlay;\n renderOverlayFeatures?: (ctx: {\n containerElement: HTMLDivElement;\n renderInContainer: (children: React.ReactNode) => React.ReactPortal | null;\n }) => React.ReactNode;\n CellReadOnlyEditor: (\n props: CellReadOnlyEditorGlideInstanceProps<R, SR>,\n ) => ReactNode;\n onRowsChange?: (\n rows: R[],\n data: RowsChangeDataGlideInstance<R, SR, CustomCtxs>,\n ) => void;\n onCellClicked?: (\n cell: readonly [number, number],\n info: TableInfoWithRow<R, SR, CustomCtxs>,\n /** Событие клика glide: позиция в ячейке, модификаторы, кнопка */\n event: CellClickedEventArgs,\n ) => void;\n stickyColumnsConfig?: StickyColumnsConfig<\n ColumnGlideInstance<R, SR, CustomCtxs>\n >;\n stickyRowsConfig?: StickyRowsConfig<R>;\n} & TableGlideInstanceContextMenu<R, SR, CustomCtxs>;",
|
|
29196
29220
|
"isGeneric": true,
|
|
29197
29221
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/TableGlideInstance.tsx",
|
|
29198
29222
|
"type": "composition",
|
|
@@ -29668,6 +29692,13 @@
|
|
|
29668
29692
|
"description": "Выделение всей таблицы кликом по шапке колонки нумерации. По умолчанию true.",
|
|
29669
29693
|
"default": "true"
|
|
29670
29694
|
},
|
|
29695
|
+
{
|
|
29696
|
+
"name": "focusOnStateChange",
|
|
29697
|
+
"type": "boolean | undefined",
|
|
29698
|
+
"required": false,
|
|
29699
|
+
"description": "Фокусировать грид при внешней смене controlled gridSelection. По умолчанию true.",
|
|
29700
|
+
"default": "true"
|
|
29701
|
+
},
|
|
29671
29702
|
{
|
|
29672
29703
|
"name": "fullScreened",
|
|
29673
29704
|
"type": "boolean | undefined",
|
|
@@ -29717,6 +29748,12 @@
|
|
|
29717
29748
|
"required": false,
|
|
29718
29749
|
"description": "Ошибка всей строки: одна красная рамка по всей ширине данных вместо\nпоячеечных рамок этой строки. Проверяется только для строк в окне\nвидимости, как и `isErrorCell`."
|
|
29719
29750
|
},
|
|
29751
|
+
{
|
|
29752
|
+
"name": "maxAutoRowHeight",
|
|
29753
|
+
"type": "number | undefined",
|
|
29754
|
+
"required": false,
|
|
29755
|
+
"description": "Потолок высоты строки при `rowHeight: 'auto'`, по умолчанию 480"
|
|
29756
|
+
},
|
|
29720
29757
|
{
|
|
29721
29758
|
"name": "onColumnSelectionApplied",
|
|
29722
29759
|
"type": "(() => void) | undefined",
|
|
@@ -29741,6 +29778,13 @@
|
|
|
29741
29778
|
"required": false,
|
|
29742
29779
|
"description": "Канал для copy/paste (selectionRef потребителя), отдельно от controlled gridSelection."
|
|
29743
29780
|
},
|
|
29781
|
+
{
|
|
29782
|
+
"name": "outlineEachRange",
|
|
29783
|
+
"type": "boolean | undefined",
|
|
29784
|
+
"required": false,
|
|
29785
|
+
"description": "Рамка у каждого Ctrl-диапазона ячеек (multi-range-cell), а не только у активного. По умолчанию false.",
|
|
29786
|
+
"default": "false"
|
|
29787
|
+
},
|
|
29744
29788
|
{
|
|
29745
29789
|
"name": "pendingColumnSelectionKeys",
|
|
29746
29790
|
"type": "string[] | null | undefined",
|
|
@@ -30454,7 +30498,7 @@
|
|
|
30454
30498
|
},
|
|
30455
30499
|
{
|
|
30456
30500
|
"name": "rowHeight",
|
|
30457
|
-
"type": "
|
|
30501
|
+
"type": "RowHeightProp<R>",
|
|
30458
30502
|
"required": false,
|
|
30459
30503
|
"description": ""
|
|
30460
30504
|
},
|
|
@@ -30749,7 +30793,7 @@
|
|
|
30749
30793
|
"exportName": "Usage1",
|
|
30750
30794
|
"displayName": "Использование в CanvasContainer.stories.tsx",
|
|
30751
30795
|
"type": "usage",
|
|
30752
|
-
"code": "<Canvas.Container\n
|
|
30796
|
+
"code": "<Canvas.Container\n direction={direction}\n alignItems={alignItems}\n justifyContent={justifyContent}\n gap={gap}\n padding={{\n top: padding * 0.75,\n right: padding,\n bottom: padding * 0.75,\n left: padding,\n }}\n style={{\n ...(width > 0 ? { width } : {}),\n ...(height > 0 ? { height } : {}),\n }}\n backgroundColor={\n backgroundColor || theme.tokens.surfaceAccentMinor\n }\n >\n <Canvas.Badge text={row.status} view=\"accent\" size=\"s\" />\n <Canvas.Text>{row.title}</Canvas.Text>\n <Canvas.Button view=\"accent\" size=\"xs\">\n Открыть\n </Canvas.Button>\n </Canvas.Container>",
|
|
30753
30797
|
"sourceFile": "packages/storybook/src/stories/TableCanvas/CanvasElements/CanvasContainer/CanvasContainer.stories.tsx"
|
|
30754
30798
|
},
|
|
30755
30799
|
{
|
|
@@ -30944,11 +30988,18 @@
|
|
|
30944
30988
|
"minimalUsage": "<CanvasAvatar />",
|
|
30945
30989
|
"examples": [
|
|
30946
30990
|
{
|
|
30947
|
-
"exportName": "
|
|
30991
|
+
"exportName": "Usage1",
|
|
30948
30992
|
"displayName": "Использование в CanvasAvatar.stories.tsx",
|
|
30949
30993
|
"type": "usage",
|
|
30950
30994
|
"code": "<Canvas.Avatar\n name=\"Анна Иванова\"\n size={row.size}\n {...content}\n tooltip=\"Анна Иванова\"\n />",
|
|
30951
30995
|
"sourceFile": "packages/storybook/src/stories/TableCanvas/CanvasElements/CanvasAvatar/CanvasAvatar.stories.tsx"
|
|
30996
|
+
},
|
|
30997
|
+
{
|
|
30998
|
+
"exportName": "Usage2",
|
|
30999
|
+
"displayName": "Использование в CanvasContainer.stories.tsx",
|
|
31000
|
+
"type": "usage",
|
|
31001
|
+
"code": "<Canvas.Avatar name={row.assignee} size=\"m\" />",
|
|
31002
|
+
"sourceFile": "packages/storybook/src/stories/TableCanvas/CanvasElements/CanvasContainer/CanvasContainer.stories.tsx"
|
|
30952
31003
|
}
|
|
30953
31004
|
]
|
|
30954
31005
|
},
|
|
@@ -31111,12 +31162,6 @@
|
|
|
31111
31162
|
"role": "internal",
|
|
31112
31163
|
"description": "Значок-бейдж (текст+иконки) для отрисовки в canvas-ячейках TableGlide",
|
|
31113
31164
|
"props": [
|
|
31114
|
-
{
|
|
31115
|
-
"name": "text",
|
|
31116
|
-
"type": "string",
|
|
31117
|
-
"required": true,
|
|
31118
|
-
"description": "Badge text content"
|
|
31119
|
-
},
|
|
31120
31165
|
{
|
|
31121
31166
|
"name": "clear",
|
|
31122
31167
|
"type": "boolean | undefined",
|
|
@@ -31159,6 +31204,12 @@
|
|
|
31159
31204
|
"required": false,
|
|
31160
31205
|
"description": "Badge size"
|
|
31161
31206
|
},
|
|
31207
|
+
{
|
|
31208
|
+
"name": "text",
|
|
31209
|
+
"type": "string | undefined",
|
|
31210
|
+
"required": false,
|
|
31211
|
+
"description": "Текст бейджа. Если заданы `children`, используются они"
|
|
31212
|
+
},
|
|
31162
31213
|
{
|
|
31163
31214
|
"name": "transparent",
|
|
31164
31215
|
"type": "boolean | undefined",
|
|
@@ -31246,7 +31297,7 @@
|
|
|
31246
31297
|
"atomicMcpVersion": "0.361.0",
|
|
31247
31298
|
"importPath": "@daisforge/ui/components/TableGlide",
|
|
31248
31299
|
"importStatement": "import { CanvasBadge } from '@daisforge/ui/components/TableGlide';",
|
|
31249
|
-
"minimalUsage": "<CanvasBadge
|
|
31300
|
+
"minimalUsage": "<CanvasBadge />",
|
|
31250
31301
|
"examples": [
|
|
31251
31302
|
{
|
|
31252
31303
|
"exportName": "Usage1",
|
|
@@ -31257,10 +31308,10 @@
|
|
|
31257
31308
|
},
|
|
31258
31309
|
{
|
|
31259
31310
|
"exportName": "Usage2",
|
|
31260
|
-
"displayName": "Использование в
|
|
31311
|
+
"displayName": "Использование в CanvasContainer.stories.tsx",
|
|
31261
31312
|
"type": "usage",
|
|
31262
|
-
"code": "<Canvas.Badge text
|
|
31263
|
-
"sourceFile": "packages/storybook/src/stories/TableCanvas/
|
|
31313
|
+
"code": "<Canvas.Badge key={tag} text={tag} view=\"light\" size=\"s\" />",
|
|
31314
|
+
"sourceFile": "packages/storybook/src/stories/TableCanvas/CanvasElements/CanvasContainer/CanvasContainer.stories.tsx"
|
|
31264
31315
|
}
|
|
31265
31316
|
]
|
|
31266
31317
|
},
|
|
@@ -31400,10 +31451,10 @@
|
|
|
31400
31451
|
},
|
|
31401
31452
|
{
|
|
31402
31453
|
"exportName": "Usage2",
|
|
31403
|
-
"displayName": "Использование в
|
|
31454
|
+
"displayName": "Использование в TableCanvas.rowHeight.stories.tsx",
|
|
31404
31455
|
"type": "usage",
|
|
31405
|
-
"code": "<Canvas.Button
|
|
31406
|
-
"sourceFile": "packages/storybook/src/stories/TableCanvas/
|
|
31456
|
+
"code": "<Canvas.Button\n view=\"accent\"\n size=\"xs\"\n style={{ flexShrink: 0 }}\n // eslint-disable-next-line no-console\n onClick={() => console.debug('open', row.id)}\n >\n Открыть\n </Canvas.Button>",
|
|
31457
|
+
"sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.RowHeight/TableCanvas.rowHeight.stories.tsx"
|
|
31407
31458
|
}
|
|
31408
31459
|
]
|
|
31409
31460
|
},
|
|
@@ -31827,17 +31878,17 @@
|
|
|
31827
31878
|
"examples": [
|
|
31828
31879
|
{
|
|
31829
31880
|
"exportName": "Usage1",
|
|
31830
|
-
"displayName": "Использование в
|
|
31881
|
+
"displayName": "Использование в CanvasIconButton.stories.tsx",
|
|
31831
31882
|
"type": "usage",
|
|
31832
|
-
"code": "<Canvas.IconButton\n
|
|
31833
|
-
"sourceFile": "packages/storybook/src/stories/TableCanvas/
|
|
31883
|
+
"code": "<Canvas.IconButton\n icon={<IconSearch />}\n view=\"clear\"\n buttonSize=\"xs\"\n interaction={{ selection: 'keep', cellClick: 'stop' }}\n onClick={() => pushLog(`кнопка с interaction, строка ${row.id}`)}\n />",
|
|
31884
|
+
"sourceFile": "packages/storybook/src/stories/TableCanvas/CanvasElements/CanvasIconButton/CanvasIconButton.stories.tsx"
|
|
31834
31885
|
},
|
|
31835
31886
|
{
|
|
31836
31887
|
"exportName": "Usage2",
|
|
31837
|
-
"displayName": "Использование в
|
|
31888
|
+
"displayName": "Использование в TableCanvas.columnsGrouping.stories.tsx",
|
|
31838
31889
|
"type": "usage",
|
|
31839
|
-
"code": "<Canvas.IconButton\n
|
|
31840
|
-
"sourceFile": "packages/storybook/src/stories/TableCanvas/
|
|
31890
|
+
"code": "<Canvas.IconButton\n icon={<IconStar />}\n view=\"clear\"\n buttonSize=\"xs\"\n interaction={{ selection: 'keep', cellClick: 'stop' }}\n onClick={() => pushLog('кнопка в заголовке группы «Прогресс»')}\n />",
|
|
31891
|
+
"sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.ColumnsGrouping/TableCanvas.columnsGrouping.stories.tsx"
|
|
31841
31892
|
}
|
|
31842
31893
|
]
|
|
31843
31894
|
},
|
|
@@ -32118,10 +32169,10 @@
|
|
|
32118
32169
|
},
|
|
32119
32170
|
{
|
|
32120
32171
|
"exportName": "Usage2",
|
|
32121
|
-
"displayName": "Использование в
|
|
32172
|
+
"displayName": "Использование в CanvasMark.stories.tsx",
|
|
32122
32173
|
"type": "usage",
|
|
32123
|
-
"code": "<Canvas.Link
|
|
32124
|
-
"sourceFile": "packages/storybook/src/stories/TableCanvas/
|
|
32174
|
+
"code": "<Canvas.Link wordWrap>\n {withMarks(row.note, query, theme.tokens.surfaceWarningMinor56)}\n </Canvas.Link>",
|
|
32175
|
+
"sourceFile": "packages/storybook/src/stories/TableCanvas/CanvasElements/CanvasMark/CanvasMark.stories.tsx"
|
|
32125
32176
|
}
|
|
32126
32177
|
]
|
|
32127
32178
|
},
|
|
@@ -32977,9 +33028,9 @@
|
|
|
32977
33028
|
},
|
|
32978
33029
|
{
|
|
32979
33030
|
"name": "rowHeight",
|
|
32980
|
-
"type": "number |
|
|
33031
|
+
"type": "number | RowHeightCallback | undefined",
|
|
32981
33032
|
"required": false,
|
|
32982
|
-
"description": "Determins the height of each row
|
|
33033
|
+
"description": "Determins the height of each row.\n\nПозиции строк кешируются по функции `rowHeight`: когда высоты меняются, передавай новую функцию,\nиначе glide продолжит считать по старым высотам и прокрутка разойдётся с отрисовкой.\nУ функции можно указать `version`, а у следующей `changes` (`RowHeightChanges`): версию прежней функции\nи строки, у которых высота могла измениться. Тогда glide спросит высоты только у этих строк и перерисует\nэкран только от первой из них. Подсказка действует на один шаг: если glide не видел прежнюю версию,\nон пересчитает всё. С `rowGrouping` и `scaleToRem` функцию оборачивают, и подсказка не используется."
|
|
32983
33034
|
},
|
|
32984
33035
|
{
|
|
32985
33036
|
"name": "rowMarkers",
|
|
@@ -49437,12 +49488,12 @@
|
|
|
49437
49488
|
"feature": "CanvasElements/CanvasBadge",
|
|
49438
49489
|
"legacy": false,
|
|
49439
49490
|
"summary": "Бейдж для отображения статусов и меток в ячейках `TableCanvas`.",
|
|
49440
|
-
"docs": "# Canvas.Badge\n\nБейдж для отображения статусов и меток в ячейках `TableCanvas`.\n\n## Ключевые особенности\n\n- Несколько встроенных `view` и `size`\n- Режимы `transparent`, `clear`, `pilled`\n- Кастомные цвета через `customColor` / `customBackgroundColor`\n- Поддержка `leftIcon` / `rightIcon`\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvasbadge-api--docs).",
|
|
49441
|
-
"apiDocs": "# Canvas.Badge API\n\n## CanvasBadgeOptions\n\n```typescript\ninterface CanvasBadgeOptions {\n view?: BadgeView;\n size?: BadgeSize;\n transparent?: boolean;\n clear?: boolean;\n leftIcon?: ButtonIcon;\n rightIcon?: ButtonIcon;\n pilled?: boolean;\n theme?: Theme;\n /** Кастомный цвет текста (аналог customColor в базовом Badge из sdds-finai).\n * Принимает конкретные значения цвета: hex (#0B7ECB), rgb(), rgba().\n * CSS-переменные (var(--...)) не поддерживаются — Canvas API работает только с конкретными цветами. */\n customColor?: string;\n /** Кастомный цвет фона (аналог customBackgroundColor в базовом Badge из sdds-finai).\n * Принимает конкретные значения цвета: hex (#0B7ECB), rgb(), rgba().\n * CSS-переменные (var(--...)) не поддерживаются — Canvas API работает только с конкретными цветами. */\n customBackgroundColor?: string;\n}\n```\n\n## BadgeView\n\n```typescript\ntype BadgeView =\n | 'default'\n | 'accent'\n | 'positive'\n | 'warning'\n | 'negative'\n | 'dark'\n | 'light';\n```\n\n## BadgeSize\n\n```typescript\ntype BadgeSize = 'xs' | 's' | 'm' | 'l';\n```",
|
|
49491
|
+
"docs": "# Canvas.Badge\n\nБейдж для отображения статусов и меток в ячейках `TableCanvas`.\n\n## Ключевые особенности\n\n- Несколько встроенных `view` и `size`\n- Режимы `transparent`, `clear`, `pilled`\n- Кастомные цвета через `customColor` / `customBackgroundColor`\n- Поддержка `leftIcon` / `rightIcon`\n- Подсветка фрагмента текста [`Canvas.Mark`](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvasmark--docs): текст с разметкой передаётся в `children`, `text` — только строка (если заданы оба — используются `children`)\n\n```tsx\n<Canvas.Badge text=\"Трайб «Диджитал вкладов»\" />\n<Canvas.Badge>\n Трайб «<Canvas.Mark color=\"#ffe27a\">Диджитал</Canvas.Mark> вкладов»\n</Canvas.Badge>\n```\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvasbadge-api--docs).",
|
|
49492
|
+
"apiDocs": "# Canvas.Badge API\n\n## CanvasBadgeOptions\n\n```typescript\ninterface CanvasBadgeOptions {\n view?: BadgeView;\n size?: BadgeSize;\n transparent?: boolean;\n clear?: boolean;\n leftIcon?: ButtonIcon;\n rightIcon?: ButtonIcon;\n pilled?: boolean;\n theme?: Theme;\n /** Кастомный цвет текста (аналог customColor в базовом Badge из sdds-finai).\n * Принимает конкретные значения цвета: hex (#0B7ECB), rgb(), rgba().\n * CSS-переменные (var(--...)) не поддерживаются — Canvas API работает только с конкретными цветами. */\n customColor?: string;\n /** Кастомный цвет фона (аналог customBackgroundColor в базовом Badge из sdds-finai).\n * Принимает конкретные значения цвета: hex (#0B7ECB), rgb(), rgba().\n * CSS-переменные (var(--...)) не поддерживаются — Canvas API работает только с конкретными цветами. */\n customBackgroundColor?: string;\n /** Подсветка фрагментов текста (`Canvas.Mark`) */\n marks?: readonly CanvasTextMark[];\n}\n```\n\n## BadgeView\n\n```typescript\ntype BadgeView =\n | 'default'\n | 'accent'\n | 'positive'\n | 'warning'\n | 'negative'\n | 'dark'\n | 'light';\n```\n\n## BadgeSize\n\n```typescript\ntype BadgeSize = 'xs' | 's' | 'm' | 'l';\n```",
|
|
49442
49493
|
"api": [
|
|
49443
49494
|
{
|
|
49444
49495
|
"typeName": "CanvasBadgeOptions",
|
|
49445
|
-
"source": "interface CanvasBadgeOptions {\n view?: BadgeView;\n size?: BadgeSize;\n transparent?: boolean;\n clear?: boolean;\n leftIcon?: ButtonIcon;\n rightIcon?: ButtonIcon;\n pilled?: boolean;\n theme?: Theme;\n /** Кастомный цвет текста (аналог customColor в базовом Badge из sdds-finai).\n * Принимает конкретные значения цвета: hex (#0B7ECB), rgb(), rgba().\n * CSS-переменные (var(--...)) не поддерживаются — Canvas API работает только с конкретными цветами. */\n customColor?: string;\n /** Кастомный цвет фона (аналог customBackgroundColor в базовом Badge из sdds-finai).\n * Принимает конкретные значения цвета: hex (#0B7ECB), rgb(), rgba().\n * CSS-переменные (var(--...)) не поддерживаются — Canvas API работает только с конкретными цветами. */\n customBackgroundColor?: string;\n}"
|
|
49496
|
+
"source": "interface CanvasBadgeOptions {\n view?: BadgeView;\n size?: BadgeSize;\n transparent?: boolean;\n clear?: boolean;\n leftIcon?: ButtonIcon;\n rightIcon?: ButtonIcon;\n pilled?: boolean;\n theme?: Theme;\n /** Кастомный цвет текста (аналог customColor в базовом Badge из sdds-finai).\n * Принимает конкретные значения цвета: hex (#0B7ECB), rgb(), rgba().\n * CSS-переменные (var(--...)) не поддерживаются — Canvas API работает только с конкретными цветами. */\n customColor?: string;\n /** Кастомный цвет фона (аналог customBackgroundColor в базовом Badge из sdds-finai).\n * Принимает конкретные значения цвета: hex (#0B7ECB), rgb(), rgba().\n * CSS-переменные (var(--...)) не поддерживаются — Canvas API работает только с конкретными цветами. */\n customBackgroundColor?: string;\n /** Подсветка фрагментов текста (`Canvas.Mark`) */\n marks?: readonly CanvasTextMark[];\n}"
|
|
49446
49497
|
},
|
|
49447
49498
|
{
|
|
49448
49499
|
"typeName": "BadgeView",
|
|
@@ -49539,7 +49590,7 @@
|
|
|
49539
49590
|
"feature": "CanvasElements/CanvasContainer",
|
|
49540
49591
|
"legacy": false,
|
|
49541
49592
|
"summary": "Flex-контейнер для компоновки canvas-элементов внутри ячейки `TableCanvas`.",
|
|
49542
|
-
"docs": "# Canvas.Container\n\nFlex-контейнер для компоновки canvas-элементов внутри ячейки `TableCanvas`.\n\n## Ключевые особенности\n\n- Flex-свойства: `direction`, `alignItems`, `justifyContent`, `gap`, `padding`\n- `backgroundColor` для визуального выделения\n- `position=\"relative\"` / `position=\"absolute\"` для абсолютного позиционирования\n- Поддержка `tooltip`, `onClick`, `onMouseEnter` / `onMouseLeave`\n- Вложенность: контейнеры можно комбинировать для сложных layout-ов\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvascontainer-api--docs).",
|
|
49593
|
+
"docs": "# Canvas.Container\n\nFlex-контейнер для компоновки canvas-элементов внутри ячейки `TableCanvas`.\n\n## Ключевые особенности\n\n- Flex-свойства: `direction`, `alignItems`, `justifyContent`, `gap`, `padding`\n- `backgroundColor` для визуального выделения\n- `position=\"relative\"` / `position=\"absolute\"` для абсолютного позиционирования\n- Поддержка `tooltip`, `onClick`, `onMouseEnter` / `onMouseLeave`\n- Вложенность: контейнеры можно комбинировать для сложных layout-ов\n\n## Корневой контейнер и отступы\n\nКорневой контейнер ячейки получает её размеры, поэтому `justifyContent` и `alignItems`\nвыравнивают содержимое внутри ячейки, а `backgroundColor` заливает ячейку целиком.\n`padding` корня — отступ содержимого от границ ячейки. Чтобы подложка была по размеру\nсодержимого (карточка, плашка), задайте её у вложенного контейнера.\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvascontainer-api--docs).",
|
|
49543
49594
|
"apiDocs": "# Canvas.Container API\n\n## ContainerProps\n\n```typescript\ninterface ContainerProps\n extends CanvasInteractionProps,\n CanvasLayerProps,\n Omit<FlexBoxOptions, 'columnGap' | 'rowGap'> {\n children?: ReactNode;\n style?: Partial<CanvasFlexStyle>;\n backgroundColor?: string;\n id?: string;\n gap?: number;\n columnGap?: number;\n rowGap?: number;\n portalHoverEnabled?: boolean;\n position?: 'relative' | 'absolute';\n left?: PositionValue;\n top?: PositionValue;\n right?: PositionValue;\n bottom?: PositionValue;\n /** Конфиг тултипа при hover: строка (текст) или объект с text и опциональными пропсами Tooltip */\n tooltip?: CanvasNodeTooltipConfig;\n onClick?: (event: CanvasEvent<CanvasContainer>) => void;\n onMouseEnter?: (event: CanvasEvent<CanvasContainer>) => void;\n onMouseLeave?: (event: CanvasEvent<CanvasContainer>) => void;\n onMouseDown?: (event: CanvasEvent<CanvasContainer>) => void;\n}\n```",
|
|
49544
49595
|
"api": [
|
|
49545
49596
|
{
|
|
@@ -49550,9 +49601,21 @@
|
|
|
49550
49601
|
"stories": [
|
|
49551
49602
|
{
|
|
49552
49603
|
"exportName": "Default",
|
|
49553
|
-
"displayName": "
|
|
49604
|
+
"displayName": "Песочница",
|
|
49605
|
+
"type": "full-code",
|
|
49606
|
+
"code": "import { Canvas, ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\nconst columnConfig: ColumnConfig<Row>[] = [\n {\n key: 'card',\n name: 'Карточка',\n width: 520,\n renderCell: ({ row, theme }) => (\n // Корневой контейнер занимает всю ячейку: его padding — отступ карточки от границ ячейки\n <Canvas.Container alignItems=\"center\" padding={{ top: 8, right: 12, bottom: 8, left: 12 }}>\n {/* Вложенный контейнер — карточка по размеру содержимого */}\n <Canvas.Container\n direction=\"row\"\n alignItems=\"center\"\n gap={8}\n padding={{ top: 8, right: 12, bottom: 8, left: 12 }}\n backgroundColor={theme.tokens.surfaceAccentMinor}\n >\n <Canvas.Badge text={row.status} view=\"accent\" size=\"s\" />\n <Canvas.Text>{row.title}</Canvas.Text>\n <Canvas.Button view=\"accent\" size=\"xs\">Открыть</Canvas.Button>\n </Canvas.Container>\n </Canvas.Container>\n ),\n },\n];\n\n<TableCanvas\n tableConfig={{ rowHeight: 'auto', containerStyle: { height: '240px' } }}\n columnConfig={columnConfig}\n rows={rows}\n/>"
|
|
49607
|
+
},
|
|
49608
|
+
{
|
|
49609
|
+
"exportName": "TaskCard",
|
|
49610
|
+
"displayName": "Карточка задачи",
|
|
49554
49611
|
"type": "full-code",
|
|
49555
|
-
"code": "(
|
|
49612
|
+
"code": "import { Canvas, ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n// baseFontStyle начинается с веса: '400 normal …'\nconst boldFont = (font: string) => font.replace(/^\\\\d+/, '600');\n\nconst columnConfig: ColumnConfig<TaskRow>[] = [\n {\n key: 'title',\n name: 'Задача',\n width: 380,\n renderCell: ({ row, theme }) => (\n // Строка: аватар + колонка из заголовка и подписи\n <Canvas.Container alignItems=\"center\" gap={12} padding={{ top: 12, right: 12, bottom: 12, left: 12 }}>\n <Canvas.Avatar name={row.assignee} size=\"m\" />\n <Canvas.Container direction=\"column\" gap={4}>\n <Canvas.Text font={boldFont(theme.baseFontStyle)}>{row.title}</Canvas.Text>\n <Canvas.Text color={theme.tokens.textSecondary}>{row.project}</Canvas.Text>\n </Canvas.Container>\n </Canvas.Container>\n ),\n },\n {\n key: 'status',\n name: 'Статус',\n width: 220,\n renderCell: ({ row, theme }) => (\n // Колонка: бейджи в строку, под ними срок\n <Canvas.Container direction=\"column\" justifyContent=\"center\" gap={6} padding={{ left: 12, right: 12 }}>\n <Canvas.Container gap={4}>\n <Canvas.Badge text={STATUS[row.status].label} view={STATUS[row.status].view} size=\"s\" />\n {row.tags.map((tag) => <Canvas.Badge key={tag} text={tag} view=\"light\" size=\"s\" />)}\n </Canvas.Container>\n <Canvas.Text color={theme.tokens.textSecondary}>{row.due}</Canvas.Text>\n </Canvas.Container>\n ),\n },\n {\n key: 'actions',\n name: '',\n width: 220,\n renderCell: ({ row }) => (\n // Кнопки прижаты вправо: justifyContent корневого контейнера\n <Canvas.Container alignItems=\"center\" justifyContent=\"flex-end\" gap={8} padding={{ left: 12, right: 12 }}>\n <Canvas.Button view=\"secondary\" size=\"xs\">Открыть</Canvas.Button>\n {row.status !== 'done' && <Canvas.Button view=\"accent\" size=\"xs\">Взять</Canvas.Button>}\n </Canvas.Container>\n ),\n },\n];\n\n<TableCanvas tableConfig={{ rowHeight: 'auto' }} columnConfig={columnConfig} rows={rows} />"
|
|
49613
|
+
},
|
|
49614
|
+
{
|
|
49615
|
+
"exportName": "Alignment",
|
|
49616
|
+
"displayName": "Выравнивание в ячейке",
|
|
49617
|
+
"type": "full-code",
|
|
49618
|
+
"code": "// Корневой контейнер растягивается на всю ячейку, поэтому justifyContent\n// и alignItems выравнивают содержимое внутри ячейки\nrenderCell: ({ row, theme }) => (\n <Canvas.Container\n justifyContent={row.justifyContent}\n alignItems=\"center\"\n gap={8}\n padding={{ left: 12, right: 12 }}\n backgroundColor={theme.tokens.surfaceTransparentSecondary}\n >\n <Canvas.Badge text=\"Badge\" view=\"accent\" size=\"s\" />\n <Canvas.Text>Text</Canvas.Text>\n <Canvas.Button view=\"accent\" size=\"xs\">Button</Canvas.Button>\n </Canvas.Container>\n)"
|
|
49556
49619
|
}
|
|
49557
49620
|
]
|
|
49558
49621
|
},
|
|
@@ -49583,7 +49646,7 @@
|
|
|
49583
49646
|
"feature": "CanvasElements/CanvasIconButton",
|
|
49584
49647
|
"legacy": false,
|
|
49585
49648
|
"summary": "Кнопка-иконка внутри canvas-ячейки `TableCanvas`.",
|
|
49586
|
-
"docs": "# Canvas.IconButton\n\nКнопка-иконка внутри canvas-ячейки `TableCanvas`.\n\n## Ключевые особенности\n\n- Иконка через `Canvas.icon(<IconName />)`\n- Несколько вариантов `view` и `buttonSize`\n- Поддержка `disabled`\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvasiconbutton-api--docs).",
|
|
49649
|
+
"docs": "# Canvas.IconButton\n\nКнопка-иконка внутри canvas-ячейки `TableCanvas`.\n\n## Ключевые особенности\n\n- Иконка через `Canvas.icon(<IconName />)`\n- Несколько вариантов `view` и `buttonSize`\n- Поддержка `disabled`\n- `interaction` — как клик по кнопке влияет на таблицу:\n `interaction={{ selection: 'keep', cellClick: 'stop' }}` — клик не переносит\n выделение и не вызывает `onCellClicked` (шеврон дерева, действие в строке).\n Так же работает у `Canvas.Button`, `Canvas.EmbedIconButton`, `Canvas.Link` и\n `Canvas.Container`\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvasiconbutton-api--docs).",
|
|
49587
49650
|
"apiDocs": "# Canvas.IconButton API\n\n## CanvasIconButtonOptions\n\n```typescript\ninterface CanvasIconButtonOptions {\n /** @deprecated Use `buttonSize` with ButtonSize type instead */\n size?: number | 'auto';\n /** @deprecated Use `view` instead */\n variant?: 'primary' | 'secondary' | 'danger';\n /** Button view style based on sdds_finai__light theme */\n view?: ButtonView;\n /** Button size */\n buttonSize?: ButtonSize;\n disabled?: boolean;\n onClick?: (event: CanvasEvent) => void;\n}\n```\n\n## ButtonView\n\n```typescript\ntype ButtonView =\n | 'default'\n | 'primary'\n | 'accent'\n | 'secondary'\n | 'clear'\n | 'success'\n | 'warning'\n | 'critical'\n | 'dark'\n | 'black'\n | 'white';\n```\n\n## ButtonSize\n\n```typescript\ntype ButtonSize = 'xs' | 's' | 'm' | 'l';\n```",
|
|
49588
49651
|
"api": [
|
|
49589
49652
|
{
|
|
@@ -49605,6 +49668,12 @@
|
|
|
49605
49668
|
"displayName": "Default",
|
|
49606
49669
|
"type": "full-code",
|
|
49607
49670
|
"code": "import { Canvas, ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\nimport { IconSearch } from '@daisforge/ui/icons';"
|
|
49671
|
+
},
|
|
49672
|
+
{
|
|
49673
|
+
"exportName": "Interaction",
|
|
49674
|
+
"displayName": "Клик без выделения ячейки (interaction)",
|
|
49675
|
+
"type": "full-code",
|
|
49676
|
+
"code": "import { Canvas, ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\nimport { IconSearch } from '@daisforge/ui/icons';\n\n${getFuncAsString(\n 'packages/storybook/src/stories/TableCanvas/CanvasElements/CanvasIconButton/CanvasIconButton.stories.tsx',\n 'InteractionExample',\n)}"
|
|
49608
49677
|
}
|
|
49609
49678
|
]
|
|
49610
49679
|
},
|
|
@@ -49666,6 +49735,40 @@
|
|
|
49666
49735
|
}
|
|
49667
49736
|
]
|
|
49668
49737
|
},
|
|
49738
|
+
{
|
|
49739
|
+
"component": "TableCanvas",
|
|
49740
|
+
"feature": "CanvasElements/CanvasMark",
|
|
49741
|
+
"legacy": false,
|
|
49742
|
+
"summary": "Подсветка фрагмента текста внутри `Canvas.Text`, `Canvas.Link` или `Canvas.Badge`: цветная пластина под частью строки.",
|
|
49743
|
+
"docs": "# Canvas.Mark\n\nПодсветка фрагмента текста внутри `Canvas.Text`, `Canvas.Link` или `Canvas.Badge`: цветная пластина под частью строки.\n\n## Ключевые особенности\n\n- Работает только внутри `Canvas.Text`, `Canvas.Link` и `Canvas.Badge`, отдельно не используется\n- Подсветка идёт по исходному тексту, поэтому корректно ложится на строки переноса (`wordWrap`)\n- Фрагмент, разорванный переносом, получает отдельную пластину на каждой строке\n- Несколько фрагментов в одном тексте — несколько `Canvas.Mark`\n- Если последняя видимая строка обрезана многоточием, пластина обрезается по ширине\n\n## Использование\n\n```tsx\n<Canvas.Text wordWrap>\n до <Canvas.Mark color=\"#ffe27a\">фрагмент</Canvas.Mark> после\n</Canvas.Text>\n```\n\nВыделяйте фрагмент, оборачивая его в `Canvas.Mark`. Остальной текст остаётся обычными строками.\n\nВ ссылке и бейдже — так же:\n\n```tsx\n<Canvas.Link onClick={openReport}>\n <Canvas.Mark color=\"#ffe27a\">Откр</Canvas.Mark>ыть свод\n</Canvas.Link>\n\n<Canvas.Badge>\n Трайб «<Canvas.Mark color=\"#ffe27a\">Диджитал</Canvas.Mark> вкладов»\n</Canvas.Badge>\n```\n\nПример с поиском по тексту ссылок и бейджей — сторис «В ссылках и бейджах».\n\n## Высота строки\n\nПодсветка не меняет размеры текста. Чтобы строка таблицы вмещала перенесённый текст, задайте `tableConfig.rowHeight: 'auto'` — см. [RowHeight](?path=/docs/локальные-компоненты-tablecanvas-rowheight--docs).\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvasmark-api--docs).",
|
|
49744
|
+
"apiDocs": "# Canvas.Mark API\n\n## MarkProps\n\n```typescript\ninterface MarkProps {\n /** Цвет пластины под фрагментом */\n color: string;\n children?: ReactNode;\n}\n```",
|
|
49745
|
+
"api": [
|
|
49746
|
+
{
|
|
49747
|
+
"typeName": "MarkProps",
|
|
49748
|
+
"source": "interface MarkProps {\n /** Цвет пластины под фрагментом */\n color: string;\n children?: ReactNode;\n}"
|
|
49749
|
+
}
|
|
49750
|
+
],
|
|
49751
|
+
"stories": [
|
|
49752
|
+
{
|
|
49753
|
+
"exportName": "Default",
|
|
49754
|
+
"displayName": "Canvas.Mark",
|
|
49755
|
+
"type": "full-code",
|
|
49756
|
+
"code": "import { Canvas, ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\nconst columnConfig: ColumnConfig[] = [\n {\n key: 'text',\n name: 'Текст',\n width: 420,\n renderCell: ({ row, theme }) => (\n <Canvas.Container alignItems=\"center\" padding={{ left: 8, right: 8 }}>\n <Canvas.Text font={theme.baseFontStyle} wordWrap>\n Подсветка <Canvas.Mark color={theme.tokens.surfaceWarningMinor56}>фрагмента</Canvas.Mark> внутри строки\n </Canvas.Text>\n </Canvas.Container>\n ),\n },\n];\n\n<TableCanvas\n tableConfig={{ containerStyle: { height: '320px' }, rowHeight: 'auto' }}\n columnConfig={columnConfig}\n rows={rows}\n/>"
|
|
49757
|
+
},
|
|
49758
|
+
{
|
|
49759
|
+
"exportName": "InLinksAndBadges",
|
|
49760
|
+
"displayName": "В ссылках и бейджах",
|
|
49761
|
+
"type": "full-code",
|
|
49762
|
+
"code": "import { Canvas, ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n// withMarks(text, query, color) оборачивает совпадения в <Canvas.Mark color={color}>\n\nconst columnConfig: ColumnConfig[] = [\n {\n key: 'tribe',\n name: 'Бейдж',\n renderCell: ({ row, theme }) => (\n <Canvas.Container alignItems=\"center\" padding={{ left: 8, right: 8 }}>\n {/* разметка — в children */}\n <Canvas.Badge size=\"s\" view=\"accent\" transparent>\n {withMarks(row.tribe, query, theme.tokens.surfaceWarningMinor56)}\n </Canvas.Badge>\n </Canvas.Container>\n ),\n },\n {\n key: 'report',\n name: 'Ссылка',\n renderCell: ({ row, theme }) => (\n <Canvas.Container alignItems=\"center\" padding={{ left: 8, right: 8 }}>\n <Canvas.Link onClick={openReport}>\n {withMarks(row.report, query, theme.tokens.surfaceWarningMinor56)}\n </Canvas.Link>\n </Canvas.Container>\n ),\n },\n];"
|
|
49763
|
+
},
|
|
49764
|
+
{
|
|
49765
|
+
"exportName": "Huge",
|
|
49766
|
+
"displayName": "1 000 000 строк × 1000 колонок",
|
|
49767
|
+
"type": "full-code",
|
|
49768
|
+
"code": "// Строка — только id, текст ячейки считается при отрисовке\nconst rows = Array.from({ length: 1_000_000 }, (_, index) => ({ id: index + 1 }));\n\nconst columnConfig = [\n { key: 'id', name: '№', width: 100 },\n ...Array.from({ length: 999 }, (_, index) => ({\n key: \\"
|
|
49769
|
+
}
|
|
49770
|
+
]
|
|
49771
|
+
},
|
|
49669
49772
|
{
|
|
49670
49773
|
"component": "TableCanvas",
|
|
49671
49774
|
"feature": "CanvasElements/CanvasSkeleton",
|
|
@@ -49702,11 +49805,11 @@
|
|
|
49702
49805
|
"legacy": false,
|
|
49703
49806
|
"summary": "Текстовый элемент для canvas-ячеек `TableCanvas` с поддержкой ellipsis и многострочного clamp.",
|
|
49704
49807
|
"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).",
|
|
49705
|
-
"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```",
|
|
49808
|
+
"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 marks?: readonly CanvasTextMark[];\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```",
|
|
49706
49809
|
"api": [
|
|
49707
49810
|
{
|
|
49708
49811
|
"typeName": "CanvasTextOptions",
|
|
49709
|
-
"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}"
|
|
49812
|
+
"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 marks?: readonly CanvasTextMark[];\n}"
|
|
49710
49813
|
},
|
|
49711
49814
|
{
|
|
49712
49815
|
"typeName": "CanvasTextAutoTooltip",
|
|
@@ -49739,7 +49842,7 @@
|
|
|
49739
49842
|
"feature": "CellsMerging",
|
|
49740
49843
|
"legacy": false,
|
|
49741
49844
|
"summary": "Объединение ячеек тела таблицы: по строкам (rowSpan), по колонкам (colSpan) и",
|
|
49742
|
-
"docs": "# CellsMerging (TableCanvas)\n\nОбъединение ячеек тела таблицы: по строкам (rowSpan), по колонкам (colSpan) и\nпрямоугольными блоками. Несколько одинаковых ячеек рисуются одной большой, а всё\nвзаимодействие — клики, выделение, навигация, копирование, вставка, протяжка,\nредактирование — обращается с блоком как с одной ячейкой.\n\nЭта страница — обзор: как выбрать способ и с чего начать, плюс живые примеры.\nПодробности (совмещение способов, работа с деревом, выравнивание, сводные\nограничения) — в\n[Справочнике](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-справочник--docs),\nтипы — в\n[API](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-api--docs).\n\n## Как это устроено\n\nГлавная идея простая: объединение — это способ показа, а не способ хранения.\n\n- В данных значение повторяется в каждой строке блока. Если «Отдел А» тянется на\n три строки, то во всех трёх строках в поле отдела записано «Отдел А».\n- Таблица замечает повторы (или получает границы блока явно) и вместо трёх\n одинаковых ячеек рисует одну высокую. Содержимое берётся из верхней-левой\n ячейки блока.\n- Данные при этом не меняются. Уберите объединение — увидите те же строки с теми\n же значениями.\n\nОтсюда следует и поведение, знакомое по Excel: клик в любую точку блока выделяет\nблок целиком, правка блока меняет значение во всех его строках, копирование\nотдаёт значение один раз.\n\n## Три способа включить объединение\n\nМеханика под всеми способами одна. Отличие — кто вычисляет границы блоков:\nпотребитель или таблица. Способы можно совмещать в одной таблице — правила в\nСправочнике, глава «Если включено несколько способов сразу».\n\n### 1. mergeCells.mergedCellsRegions — блоки, заданные снаружи\n\n«Слей вот эти конкретные ячейки». Список блоков по стабильным ключам строк и\nколонок; списком владеет потребитель, как выделением. Таблица переводит ключи в\nтекущие видимые позиции. Если сортировка, перестановка или скрытие колонки\nразорвали блок — он не рисуется (как ограничение сортировки в Excel).\n\n```tsx\ntableConfig={{\n mergeCells: {\n mergedCellsRegions: [\n { rowKeys: ['r1', 'r2'], colKeys: ['dept'] },\n { rowKeys: ['r4', 'r5'], colKeys: ['plan', 'fact'] }, // прямоугольник 2×2\n ],\n rowKeyGetter: (row) => row.id,\n },\n}}\n```\n\nПримеры — стори с префиксом `mergedCellsRegions:` ниже.\n\n### 2. mergeCells.mergeByCellValues — по одинаковым значениям\n\n«В этих колонках сливай подряд идущие одинаковые значения». Границы блоков\nтаблица вычисляет сама из данных; после сортировки или фильтра блоки\nпересобираются.\n\n```tsx\ntableConfig={{\n mergeCells: {\n mergeByCellValues: [\n 'dept', // по значению колонки\n { colKey: 'role', value: (row) => row.roleGroup }, // по своей функции\n ],\n },\n}}\n```\n\nОдинаковые названия в разных ветках иерархии могут ложно слиться — лечится\nсоставным ключом, разбор в Справочнике, глава «Объединение по значению: где\nпроходит граница». Примеры — стори с префиксом `mergeByCellValues:` ниже.\n\n### 3. Merged-виды группировки и subRows — полный автомат\n\nПотребитель включает вид — всю работу с блоками делает таблица: строки\nупорядочиваются по группам, колонки уровней сливаются по границам групп, чекбокс\nи нумерация работают по верхней группе.\n\nЧерез группировку (структуру задают значения группирующих колонок):\n\n```tsx\ntableConfig={{\n rowsGrouping: {\n view: 'merged',\n groupByState: [groupBy, setGroupBy], // например ['dept', 'role']\n rowKeyGetter: (row) => row.id,\n },\n}}\n```\n\nЧерез subRows (структуру задаёт готовое дерево потребителя):\n\n```tsx\ntableConfig={{\n subRows: {\n view: 'merged',\n mergedColumns: ['dept', 'role'], // колонки уровней дерева\n getSubRows: (row) => row.children,\n rowKeyGetter: (row) => row.id,\n },\n}}\n```\n\nПримеры — «subRows: дерево с пагинацией» и «rowsGrouping: группировка\nпользователем» в конце страницы.\n\n## Какой способ выбрать\n\nКартинка у способов похожая, поэтому выбирать стоит не по внешнему виду, а по\nтому, кто владеет данными и что нужно пользователю.\n\n### Дерево приходит с сервера, нужна постраничная загрузка — subRows\n\nЕсли данные уже иерархические (дивизион, управление, команда, сотрудники) и\nприходят от сервера частями, берите `subRows` с `view: 'merged'`. Дерево остаётся\nу вас: вы отдаёте таблице страницу дерева, она разворачивает её в строки и сама\nсливает колонки-предки. Именно поэтому здесь работает пагинация по верхним\nблокам — таблице не нужно видеть все данные сразу.\n\nОбратная сторона: раз данными владеете вы, то поиск, сортировка и фильтрация\nдерева — тоже на вашей стороне. Формат дерева, пагинация и возврат правок —\nв Справочнике, глава «Дерево через subRows».\n\n### Плоские строки, пользователь сам выбирает группировку — rowsGrouping\n\nЕсли строки плоские, а пользователь должен на лету решать, по каким колонкам\nгруппировать, — берите `rowsGrouping` с `view: 'merged'`. Состав группировки живёт\nв `groupByState`, а с настройкой `groupButton` в блоке управления появляется\nкнопка: пользователь сам выбирает колонки, таблица пересобирает блоки. Встроенные\nпоиск, сортировка и фильтры работают — таблица применяет их до сборки групп.\n\nОбратная сторона: пагинации в этом виде нет — таблице нужны все строки сразу.\nНе действует и всё, что привязано к строкам-групп и шевронам дерева\n(`groupedColumnProps`, `renderGroupCell`, `expandAllBtn`) — полный список в\nСправочнике, глава «Что не работает и почему».\n\n### Плоские строки, группировка фиксированная, всё считает сервер — mergeByCellValues\n\nЕсли структура известна заранее и не меняется пользователем, а данные (включая\nстраницы, сортировку и фильтры) готовит сервер, — самый прямой путь это\n`mergeByCellValues`. Вы упорядочиваете строки как нужно, таблица сливает соседние\nодинаковые значения. Никакой лишней механики: ни кнопок, ни дерева.\n\n### Отдельные ручные блоки — mergedCellsRegions\n\nШапки секций внутри таблицы, нестандартные прямоугольники, объединение по кнопке\nили из контекстного меню — всё, что не выводится из значений, делается регионами.\nПотребитель добавляет блок в свой список — таблица его рисует.\n\n## Смежные разделы\n\n- [Справочник](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-справочник--docs) —\n совмещение способов, составные ключи, дерево, выравнивание, сводные ограничения.\n- [CellsMerging API](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-api--docs) —\n типы.\n- Объединение ячеек шапки — раздел ColumnsGrouping (`squashEmptyCells`).\n\n## Полные примеры\n\nТри больших примера ниже собраны как заготовки для продуктов: в каждом —\nобъединение ячеек в связке с поиском, сортировкой, фильтрами, пагинацией,\nредактированием и выделением. Различаются они тем, кто владеет данными, поэтому\nи код обвязки разный. Полный код каждого примера открывается кнопкой «Show code»\nи снабжён комментариями по ключевым местам.\n\n### mergeByCellValues: пример с серверными данными\n\nДанные плоские, всё считает «сервер» (в примере его заменяет функция\n`selectPage`), таблица только рисует полученную страницу.\n\nЧто здесь показано:\n\n- поиск, фильтры, сортировка и пагинация в `manual`-режиме — считает потребитель;\n- составные ключи пути (`divPath` / `unitPath` / `teamPath`) против ложного\n слияния одинаковых имён из разных веток;\n- сортировка внутри команды — блоки не рассыпаются;\n- закрепление колонок вместе с групповой шапкой;\n- редактирование с возвратом правок страницы в полный набор.\n\n<Canvas of={CellsMergingExamples.Showcase} />\n\n### subRows: дерево с пагинацией\n\nДанные — дерево, и оно остаётся у потребителя: таблице отдаётся страница целых\nподдеревьев.\n\nЧто здесь показано:\n\n- пагинация по верхним блокам (дивизионам) со своим списком «показывать по»;\n- `manual`-поиск, сортировка и фильтры, посчитанные по дереву\n (функция `selectTreePage`);\n- сортировка показателей внутри команды и перестановка веток по имени;\n- возврат правок листьев обратно в дерево.\n\n<Canvas of={CellsMergingExamples.SubRowsMerged} />\n\n### rowsGrouping: группировка пользователем\n\nДанные плоские и передаются целиком, остальное делает таблица. Самый короткий\nкод из трёх.\n\nЧто здесь показано:\n\n- встроенные поиск, сортировка и фильтры — применяются до сборки групп;\n- выбор состава группировки пользователем (кнопка `groupButton`);\n- полный стейт фильтров: ключ на каждый фильтр из колонок;\n- без пагинации — чтобы собрать группы, таблице нужны все строки сразу.\n\n<Canvas of={CellsMergingExamples.GroupingMerged} />\n\n## Как перенести пример к себе\n\n1. Замените данные и типы строк на свои. Сохраните стабильный `id` строки — на\n нём держатся выделение и возврат правок, между страницами он меняться не\n должен.\n2. Замените `selectPage` / `selectTreePage` реальным запросом к серверу. Контракт\n тот же: параметры выборки на входе, страница и общее количество на выходе.\n3. Проверьте, что в `filtering.state` есть ключ каждого фильтра из колонок (со\n значением «показать всё»), — селект-фильтр без своего ключа молча отсеет все\n строки.\n4. Для `mergeByCellValues` заведите составные ключи пути, если одинаковые\n названия возможны в разных ветках иерархии.\n5. Уберите фичи, которые вам не нужны, — настройки в примерах независимы друг от\n друга: пагинация, закрепление, чекбоксы, редактирование отключаются по\n отдельности.\n\n# CellsMerging: справочник\n\nПодробности объединения ячеек: совмещение способов, составные ключи, работа с\nдеревом, взаимодействие с остальными фичами таблицы, выравнивание и сводный\nсписок ограничений. Обзор способов и живые примеры — на странице\n[Docs](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging--docs), типы —\nна странице\n[API](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-api--docs).\n\n## Если включено несколько способов сразу\n\nСпособы можно совмещать в одной таблице — правила простые и считаются по колонке:\n\n- Если колонка входит хотя бы в один регион из `mergedCellsRegions`, её\n объединения описывают только регионы. `mergeByCellValues` на этой колонке не\n действует.\n- Колонка merged-вида (группировки или subRows) сливается по границам групп.\n Пользовательский `mergeByCellValues` на той же колонке не действует — иначе два\n механизма спорили бы за одни ячейки.\n- В остальных случаях работает `mergeByCellValues`.\n- Разные колонки живут независимо: регион на одной колонке и слияние по значению\n на другой — обычная рабочая комбинация.\n\nПример: таблица с группировкой по «Отделу» (merged-вид) может дополнительно\nсливать колонку «Статус» через `mergeByCellValues`, а строки-заголовки секций\nрисовать регионами на всю ширину — все три способа уживаются, потому что заняты\nразными колонками.\n\n## Объединение по значению: где проходит граница\n\nУ `mergeByCellValues` есть классическая ловушка. Допустим, регионы «Север» и «Юг»,\nи в каждом есть «Команда 1» и «Команда 2»:\n\n```\nСевер | Команда 1 | Иванов\nСевер | Команда 2 | Петров\nЮг | Команда 2 | Сидоров\nЮг | Команда 1 | Смирнов\n```\n\nЕсли сливать колонку команды по её значению, «Команда 2» из Севера и «Команда 2»\nиз Юга стоят рядом — и сольются в один блок через границу региона. Визуально это\nвыглядит как ошибка: одна команда, а на деле две разные.\n\nРешение — сливать не по тексту в ячейке, а по составному ключу, в котором зашит\nпуть от корня:\n\n```tsx\nmergeCells: {\n mergeByCellValues: [\n 'region',\n // Сравнивается результат функции, а не текст в ячейке.\n { colKey: 'team', value: (row) => `${row.region} / ${row.team}` },\n ],\n}\n```\n\nТеперь у «Команды 2» из Севера ключ «Север / Команда 2», а у южной —\n«Юг / Команда 2». Ключи разные, слияние останавливается на границе региона само,\nбез какой-либо отдельной логики. В ячейке при этом показывается обычное значение\nколонки — функция влияет только на сравнение.\n\nВ полном примере (стори «mergeByCellValues: пример с серверными данными») такие\nключи собраны заранее в полях строки: `divPath`, `unitPath`, `teamPath` — по\nодному на каждый уровень иерархии.\n\nMerged-виды группировки и subRows строят такие ключи сами — там об этой ловушке\nдумать не нужно.\n\n## Дерево через subRows: как передавать данные\n\nРазберём подробнее самый ёмкий сценарий — `subRows` с `view: 'merged'`.\n\n### Какое дерево ждёт таблица\n\nВ `rows` передаются корневые узлы, детей таблица достаёт через `getSubRows`.\nРоли узлов распределены так:\n\n- **Внутренние узлы** (дивизион, управление, команда) — ярлыки уровней. Каждый\n несёт поле с именем своей колонки из `mergedColumns`: узел дивизиона — поле\n `division`, узел управления — поле `unit`, и так далее.\n- **Листья** — строки данных. Именно они становятся строками таблицы со своими\n показателями; внутренние узлы отдельными строками не показываются.\n\n```tsx\nconst tree = [\n {\n id: 'd1',\n division: 'Розничный бизнес', // узел уровня 0\n subRows: [\n {\n id: 'u1',\n unit: 'Управление продаж', // узел уровня 1\n subRows: [\n {\n id: 't1',\n team: 'Команда Север', // узел уровня 2\n subRows: [\n { id: 'e1', employee: 'Иванов', plan: 100, fact: 90 }, // лист\n { id: 'e2', employee: 'Петров', plan: 80, fact: 85 },\n ],\n },\n ],\n },\n ],\n },\n];\n```\n\n```tsx\ntableConfig={{\n subRows: {\n view: 'merged',\n mergedColumns: ['division', 'unit', 'team'], // порядок = уровни дерева\n getSubRows: (row) => row.subRows,\n rowKeyGetter: (row) => row.id,\n },\n}}\n```\n\n`mergedColumns` — это соответствие уровней дерева и колонок: первый элемент\nпоказывает узлы верхнего уровня, второй — следующего, и так далее. Колонка\n`division` возьмёт значение из узла дивизиона и сольётся на все его листья,\n`unit` — на листья своего управления, вложенно.\n\nСворачивания в этом виде нет: таблица показывает всё переданное дерево целиком.\nХотите меньше строк на экране — передайте меньший кусок дерева (следующий\nраздел).\n\n### Пагинация по верхним блокам\n\nДерево у вас, поэтому страницы нарезаете вы — по верхним узлам. Таблице отдаётся\nсрез дерева, а в `pagination.count` — общее число верхних узлов:\n\n```tsx\nconst [page, setPage] = useState(1);\nconst [perPage, setPerPage] = useState(2); // дивизионов на страницу\nconst pageTree = tree.slice((page - 1) * perPage, page * perPage);\n\ntableConfig={{\n pagination: {\n count: tree.length, // всего верхних узлов, не листьев\n perPage,\n perPageList: [1, 2, 3], // варианты «показывать по» — в блоках\n value: page,\n onChange: (nextPage, nextPerPage) => {\n if (typeof nextPerPage === 'number' && nextPerPage !== perPage) {\n setPerPage(nextPerPage);\n setPage(1);\n } else if (typeof nextPage === 'number') {\n setPage(nextPage);\n }\n },\n },\n subRows: { /* как выше */ },\n}}\n// ...\nrows={pageTree}\n```\n\nСтраница «2 дивизиона» может содержать разное число строк-листьев — это нормально:\nединица пагинации здесь блок, а не строка. По той же причине настройте селектор\n«Показывать по»: его стандартные варианты (20/50/100) рассчитаны на строки и для\nблоков не имеют смысла — задайте свой список `perPageList` в блоках, как выше,\nлибо спрячьте селектор (`hasPerPage: false`). Если дерево приходит с сервера\nчастями, вместо `slice` будет запрос следующей страницы — контракт тот же.\n\n### Редактирование: правки возвращаются листьями\n\nРедактируются листья. В `editing.onRowsChange` приходят изменённые строки-листья —\nзаписать их обратно в своё дерево должен потребитель, например по `id`:\n\n```tsx\nediting: {\n rowKeyGetter: (r) => r.id,\n onRowsChange: (updatedLeaves) => {\n const byId = new Map(updatedLeaves.map((r) => [r.id, r]));\n // Обойдите дерево и замените листья с совпавшими id.\n setTree((prev) => writeLeavesBack(prev, byId));\n },\n},\n```\n\nЭто следствие владения данными: таблица не знает, как устроено ваше дерево,\nпоэтому отдаёт плоский результат, а раскладываете его вы.\n\n### Что остаётся на вашей стороне\n\n- **Поиск, сортировка, фильтрация** — встроенные механизмы к структурному дереву\n пока не применяются. Отфильтровали или отсортировали своё дерево — передали\n результат в `rows`, таблица показала.\n- **Выделение** при этом работает из коробки: один чекбокс на верхний блок, клик\n выделяет все его листья (подробнее — в разделе про выделение ниже).\n\nЖивой пример всего вместе — стори «subRows: дерево с пагинацией» на странице\n[Docs](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging--docs).\n\n## Объединение и остальные возможности таблицы\n\nБлоки — не отдельный мир: выделение, сортировка, буфер обмена и редактирование\nпродолжают работать. Здесь собрано, как именно.\n\n### Выделение, нумерация и навигация\n\nВыделение настраивается как обычно — `selecting` со стейтом и `rowKeyGetter`.\nА вот ведёт оно себя по-разному в зависимости от способа объединения:\n\n- **Плоский вид с mergeByCellValues** — чекбокс у каждой строки, номер у каждой\n строки. Объединение колонок на выделение не влияет: в стори\n «mergeByCellValues: пример с серверными данными» можно выделить одного\n сотрудника внутри слитого блока.\n- **Merged-виды группировки и subRows** — один чекбокс и один номер на группу\n верхнего уровня. Клик по чекбоксу выделяет все строки группы разом, повторный —\n снимает. «Выделить всё» в шапке тоже работает. Счётчик выбранного внизу\n считает строки, а не группы: выделили дивизион из 12 сотрудников — внизу\n «выбрано 12».\n\nСпециально настраивать групповое поведение не нужно: таблица включает его сама,\nкогда активен merged-вид.\n\nНавигация тоже понимает блоки: клик в любую точку блока выделяет его целиком,\nрамка фокуса рисуется вокруг всего блока, один шаг стрелкой перепрыгивает блок.\nПопасть «внутрь» блока с клавиатуры нельзя — для таблицы это одна ячейка.\n\n### Сортировка, фильтрация, поиск и пагинация\n\nВозможности зависят от того, кто владеет данными.\n\n**mergeByCellValues (плоский вид).** Встроенные сортировка, фильтр и поиск\nработают как обычно, а блоки пересобираются после каждого изменения порядка —\nобъединение всегда отражает текущий видимый список строк. Если данные приходят с\nсервера постранично, следите, чтобы сортировка на сервере не разрывала группы:\nполовина группы на одной странице и половина на другой будут выглядеть как два\nотдельных блока.\n\n**rowsGrouping (view: 'merged').** Встроенные поиск, сортировка и фильтры\nработают: таблица применяет их к строкам до сборки групп, поэтому группы всегда\nсобираются из уже отфильтрованного списка. Пагинации нет: группировке нужны все\nстроки сразу. Сортировку по группирующим колонкам можно снять настройкой\n`disableGroupColumnsSort` — как в дереве, где сгруппированные колонки не\nсортируются.\n\nЧастая ошибка при встроенных фильтрах (не только в этом виде): в стейте\n`filtering.state` должен быть ключ каждого фильтра, объявленного в колонках.\nSelect-фильтр без своего ключа получит пустое значение вместо «показать всё» и\nможет отсеять все строки — таблица окажется пустой без единой ошибки.\n\n**subRows (view: 'merged').** Дерево у потребителя, поэтому пагинация по верхним\nблокам работает: отдаёте страницу дерева — таблица её показывает. Встроенные\nпоиск, сортировка и фильтрация к структурному дереву пока не применяются — эти\nоперации делаются на стороне потребителя над его данными.\n\n### Копирование, вставка и протяжка\n\n- Копирование отдаёт значение в позиции верхней-левой ячейки блока, остальные\n ячейки блока в буфере пустые — как в Excel.\n- Вставка пишет во весь блок: значение попадает во все его строки.\n- Протяжка (fill) растягивается только до целых блоков — залить пол-блока нельзя;\n пунктирная рамка протяжки сама прилипает к границам блоков.\n\n### Редактирование\n\n- Правка ячейки блока записывает значение во все его строки — данные под блоком\n всегда совпадают с тем, что на экране.\n- При объединении по значению правка пересобирает блоки: изменили «Отдел» у\n блока — он разъедется или сольётся с соседним, потому что объединение выводится\n из данных.\n- У редактируемых Select-ячеек редактор открывается по выравниванию блока: текст\n прижат к низу — редактор откроется у нижнего края, а выпадающий список\n раскроется вверх.\n\n## Выравнивание контента в блоке\n\nПо умолчанию контент блока выравнивается по горизонтали как обычная ячейка\nэтой колонки — из `contentFormat.alignContent` (у числового формата это правый\nкрай), иначе слева. По вертикали — по центру: у обычной ячейки вертикального\nвыравнивания нет, это чисто блочная настройка. Настраивается лестницей «точечное важнее\nобщего»:\n\n- `mergedCellsAlign` конкретного региона (только для `mergedCellsRegions`);\n- `mergedCellsAlign` на колонке — все блоки этой колонки, работает для всех\n способов включения;\n- дефолт фичи: `mergeCells.mergedCellsAlign` или `rowsGrouping.mergedCellsAlign`.\n\n```tsx\ncolumnConfig={[\n { key: 'dept', name: 'Отдел', mergedCellsAlign: { horizontal: 'center', vertical: 'top' } },\n]}\n```\n\nКолоночный `mergedCellsAlign` может быть и функцией `(row) => MergedCellsAlign`\nпо данным строки блока — так разные блоки одной колонки получают разное\nвыравнивание. Это единственный способ управлять выравниванием поблочно в\nmerged-видах группировки и subRows, где границы блоков решает таблица, а не\nпотребитель.\n\n```tsx\ncolumnConfig={[\n { key: 'dept', mergedCellsAlign: (row) =>\n row.critical ? { vertical: 'top' } : { vertical: 'center' } },\n]}\n```\n\n### Свой рендер в блоке\n\nВыравнивание действует на текстовый контент. Кастомный `renderCell` получает весь\nпрямоугольник блока и выравнивает содержимое сам — через свойства своих\nконтейнеров.\n\nУ колонок со своим рендером есть неочевидность: предпросмотр значения (по\nдвойному клику на ячейке без редактирования) у них по умолчанию выключен.\nСо стороны это выглядит как «у блоков не открывается предпросмотр», хотя дело в\nколонке, а не в объединении. Включается настройкой колонки:\n\n```tsx\n{ key: 'dept', renderCell: ..., renderCellPreview: 'cellEditorAsPreview' }\n```\n\n## Что не работает и почему\n\nСводный список ограничений. Если «что-то не рисуется» — сначала сюда.\n\n### Во всех способах\n\n- Все ячейки блока обязаны нести одинаковые данные — это контракт\n `mergeByCellValues` (значения реально повторяются в строках) и регионов.\n Причина проста: блок показывает верхнюю-левую **видимую** ячейку, а какая\n ячейка окажется верхней-левой — зависит от закрепления и порядка колонок.\n Если данные одинаковые, блок выглядит одинаково при любой перестановке.\n- Попасть «внутрь» блока с клавиатуры нельзя — для таблицы это одна ячейка.\n Это поведение, а не ошибка.\n- Выравнивание пока не поддерживает письмо справа налево (RTL).\n- Горизонтальная протяжка через colSpan-блок не растягивается до границ блока\n (в работе).\n- У колонок со своим `renderCell` по умолчанию выключен предпросмотр значения —\n включается `renderCellPreview: 'cellEditorAsPreview'` (см. «Свой рендер в\n блоке» выше).\n\n### mergedCellsRegions\n\n- Разорванный регион исчезает молча: если после сортировки, перестановки или\n скрытия колонок ключи региона перестали идти подряд, блок просто не рисуется.\n Ошибок и предупреждений нет — следите за порядком сами.\n\n### rowsGrouping (view: 'merged')\n\n- Пагинации нет: чтобы собрать группы, таблице нужны все строки сразу.\n- Отдельная колонка «Группировка» не создаётся, поэтому не действует всё, что к\n ней привязано: `groupedColumnProps`, свой контент ячейки группы\n (`renderGroupCell` у колонки) и кнопка «развернуть всё» (`expandAllBtn`) —\n строк-групп и шевронов в этом виде нет.\n\n### subRows (view: 'merged')\n\n- Встроенные поиск, сортировка и фильтрация к структурному дереву не\n применяются — эти операции делает потребитель над своими данными.\n- `column.subRow` целиком не действует: шеврон (`isColumnWithArrow`), свой\n контент и ключи вложенных уровней (`renderSubRowCell`, `keyOfColumnInSubRow`,\n `parentKeyAsDefault`, `contentFormat`), свой редактор уровня. Листья рисуются\n как обычные строки — работают их обычные `renderCell`, `contentFormat` и\n `editingCell`.\n- `expandedIdsState` и сворачивание не действуют: раскрывать нечего, дерево\n показано целиком.\n\nЭто осознанное поведение: один и тот же конфиг `subRows` или `rowsGrouping`\nможно переключать между `view: 'tree'` и `view: 'merged'` — лишние настройки\nдругого вида не мешают. Пометки «работает только в виде дерева» есть и в\nподсказках типов.\n\n> Подробнее о типах — [CellsMerging API](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-api--docs)",
|
|
49845
|
+
"docs": "# CellsMerging (TableCanvas)\n\nОбъединение ячеек тела таблицы: по строкам (rowSpan), по колонкам (colSpan) и\nпрямоугольными блоками. Несколько одинаковых ячеек рисуются одной большой, а всё\nвзаимодействие — клики, выделение, навигация, копирование, вставка, протяжка,\nредактирование — обращается с блоком как с одной ячейкой.\n\nЭта страница — обзор: как выбрать способ и с чего начать, плюс живые примеры.\nПодробности (совмещение способов, работа с деревом, выравнивание, сводные\nограничения) — в\n[Справочнике](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-справочник--docs),\nтипы — в\n[API](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-api--docs).\n\n## Как это устроено\n\nГлавная идея простая: объединение — это способ показа, а не способ хранения.\n\n- В данных значение повторяется в каждой строке блока. Если «Отдел А» тянется на\n три строки, то во всех трёх строках в поле отдела записано «Отдел А».\n- Таблица замечает повторы (или получает границы блока явно) и вместо трёх\n одинаковых ячеек рисует одну высокую. Содержимое берётся из верхней-левой\n ячейки блока.\n- Данные при этом не меняются. Уберите объединение — увидите те же строки с теми\n же значениями.\n\nОтсюда следует и поведение, знакомое по Excel: клик в любую точку блока выделяет\nблок целиком, правка блока меняет значение во всех его строках, копирование\nотдаёт значение один раз.\n\n## Четыре способа включить объединение\n\nМеханика под всеми способами одна. Отличие — кто вычисляет границы блоков:\nпотребитель или таблица. Способы можно совмещать в одной таблице — правила в\nСправочнике, глава «Если включено несколько способов сразу».\n\n### 1. mergeCells.mergedCellsRegions — блоки, заданные снаружи\n\n«Слей вот эти конкретные ячейки». Список блоков по стабильным ключам строк и\nколонок; списком владеет потребитель, как выделением. Таблица переводит ключи в\nтекущие видимые позиции. Если сортировка, перестановка или скрытие колонки\nразорвали блок — он не рисуется (как ограничение сортировки в Excel).\n\n```tsx\ntableConfig={{\n mergeCells: {\n mergedCellsRegions: [\n { rowKeys: ['r1', 'r2'], colKeys: ['dept'] },\n { rowKeys: ['r4', 'r5'], colKeys: ['plan', 'fact'] }, // прямоугольник 2×2\n ],\n rowKeyGetter: (row) => row.id,\n },\n}}\n```\n\nПримеры — стори с префиксом `mergedCellsRegions:` ниже.\n\n### 2. mergeCells.mergeByCellValues — по одинаковым значениям\n\n«В этих колонках сливай подряд идущие одинаковые значения». Границы блоков\nтаблица вычисляет сама из данных; после сортировки или фильтра блоки\nпересобираются.\n\n```tsx\ntableConfig={{\n mergeCells: {\n mergeByCellValues: [\n 'dept', // по значению колонки\n { colKey: 'role', value: (row) => row.roleGroup }, // по своей функции\n ],\n },\n}}\n```\n\nОдинаковые названия в разных ветках иерархии могут ложно слиться — лечится\nсоставным ключом, разбор в Справочнике, глава «Объединение по значению: где\nпроходит граница». Примеры — стори с префиксом `mergeByCellValues:` ниже.\n\n### 3. Merged-виды группировки и subRows — полный автомат\n\nПотребитель включает вид — всю работу с блоками делает таблица: строки\nупорядочиваются по группам, колонки уровней сливаются по границам групп, чекбокс\nи нумерация работают по верхней группе.\n\nЧерез группировку (структуру задают значения группирующих колонок):\n\n```tsx\ntableConfig={{\n rowsGrouping: {\n view: 'merged',\n groupByState: [groupBy, setGroupBy], // например ['dept', 'role']\n rowKeyGetter: (row) => row.id,\n },\n}}\n```\n\nЧерез subRows (структуру задаёт готовое дерево потребителя):\n\n```tsx\ntableConfig={{\n subRows: {\n view: 'merged',\n mergedColumns: ['dept', 'role'], // колонки уровней дерева\n getSubRows: (row) => row.children,\n rowKeyGetter: (row) => row.id,\n },\n}}\n```\n\nПримеры — «subRows: дерево с пагинацией» и «rowsGrouping: группировка\nпользователем» в конце страницы.\n\n### 4. mergeCells.lazyRowSpan — ленивый резолвер блоков\n\n«Для этой ячейки скажу сам, где её блок». Функция получает строку ячейки, ключ\nколонки и индекс строки и возвращает первую и последнюю строку блока\n(включительно) или `null`.\nТаблица вызывает её только для видимых ячеек — способ для больших и ленивых\nданных, где обход всех строк (`mergeByCellValues`) дорог.\n\n```tsx\ntableConfig={{\n mergeCells: {\n // стабильная функция: при смене данных таблица перерисуется сама\n lazyRowSpan: (row, colKey, rowInd) =>\n colKey === 'region' ? blockBounds(rowInd) : null,\n },\n}}\n```\n\n`rowInd` и границы блока — индексы строк **на экране**: после сортировки,\nфильтров и группировки они не совпадают с индексами в `rows`. Поэтому в\n`ctx.rows` приходят отображаемые строки в порядке на экране — блок ищут по\nсоседям:\n\n```tsx\nlazyRowSpan: (row, colKey, rowInd, { rows }) => {\n if (colKey !== 'region') return null;\n let start = rowInd;\n let end = rowInd;\n while (rows[start - 1]?.region === row.region) start -= 1;\n while (rows[end + 1]?.region === row.region) end += 1;\n return end > start ? [start, end] : null;\n},\n```\n\nКолонки из `mergedCellsRegions`, `mergeByCellValues` и merged-видов берут блоки\nоттуда, `lazyRowSpan` для них не вызывается. Примеры — стори «lazyRowSpan: ленивые\nблоки на 100 000 строк» и «lazyRowSpan по соседям: с сортировкой» ниже.\n\n## Какой способ выбрать\n\nКартинка у способов похожая, поэтому выбирать стоит не по внешнему виду, а по\nтому, кто владеет данными и что нужно пользователю.\n\n### Дерево приходит с сервера, нужна постраничная загрузка — subRows\n\nЕсли данные уже иерархические (дивизион, управление, команда, сотрудники) и\nприходят от сервера частями, берите `subRows` с `view: 'merged'`. Дерево остаётся\nу вас: вы отдаёте таблице страницу дерева, она разворачивает её в строки и сама\nсливает колонки-предки. Именно поэтому здесь работает пагинация по верхним\nблокам — таблице не нужно видеть все данные сразу.\n\nОбратная сторона: раз данными владеете вы, то поиск, сортировка и фильтрация\nдерева — тоже на вашей стороне. Формат дерева, пагинация и возврат правок —\nв Справочнике, глава «Дерево через subRows».\n\n### Плоские строки, пользователь сам выбирает группировку — rowsGrouping\n\nЕсли строки плоские, а пользователь должен на лету решать, по каким колонкам\nгруппировать, — берите `rowsGrouping` с `view: 'merged'`. Состав группировки живёт\nв `groupByState`, а с настройкой `groupButton` в блоке управления появляется\nкнопка: пользователь сам выбирает колонки, таблица пересобирает блоки. Встроенные\nпоиск, сортировка и фильтры работают — таблица применяет их до сборки групп.\n\nОбратная сторона: пагинации в этом виде нет — таблице нужны все строки сразу.\nНе действует и всё, что привязано к строкам-групп и шевронам дерева\n(`groupedColumnProps`, `renderGroupCell`, `expandAllBtn`) — полный список в\nСправочнике, глава «Что не работает и почему».\n\n### Плоские строки, группировка фиксированная, всё считает сервер — mergeByCellValues\n\nЕсли структура известна заранее и не меняется пользователем, а данные (включая\nстраницы, сортировку и фильтры) готовит сервер, — самый прямой путь это\n`mergeByCellValues`. Вы упорядочиваете строки как нужно, таблица сливает соседние\nодинаковые значения. Никакой лишней механики: ни кнопок, ни дерева.\n\n### Отдельные ручные блоки — mergedCellsRegions\n\nШапки секций внутри таблицы, нестандартные прямоугольники, объединение по кнопке\nили из контекстного меню — всё, что не выводится из значений, делается регионами.\nПотребитель добавляет блок в свой список — таблица его рисует.\n\n## Смежные разделы\n\n- [Справочник](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-справочник--docs) —\n совмещение способов, составные ключи, дерево, выравнивание, сводные ограничения.\n- [CellsMerging API](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-api--docs) —\n типы.\n- Объединение ячеек шапки — раздел ColumnsGrouping (`squashEmptyCells`).\n\n## Полные примеры\n\nТри больших примера ниже собраны как заготовки для продуктов: в каждом —\nобъединение ячеек в связке с поиском, сортировкой, фильтрами, пагинацией,\nредактированием и выделением. Различаются они тем, кто владеет данными, поэтому\nи код обвязки разный. Полный код каждого примера открывается кнопкой «Show code»\nи снабжён комментариями по ключевым местам.\n\n### mergeByCellValues: пример с серверными данными\n\nДанные плоские, всё считает «сервер» (в примере его заменяет функция\n`selectPage`), таблица только рисует полученную страницу.\n\nЧто здесь показано:\n\n- поиск, фильтры, сортировка и пагинация в `manual`-режиме — считает потребитель;\n- составные ключи пути (`divPath` / `unitPath` / `teamPath`) против ложного\n слияния одинаковых имён из разных веток;\n- сортировка внутри команды — блоки не рассыпаются;\n- закрепление колонок вместе с групповой шапкой;\n- редактирование с возвратом правок страницы в полный набор.\n\n<Canvas of={CellsMergingExamples.Showcase} />\n\n### subRows: дерево с пагинацией\n\nДанные — дерево, и оно остаётся у потребителя: таблице отдаётся страница целых\nподдеревьев.\n\nЧто здесь показано:\n\n- пагинация по верхним блокам (дивизионам) со своим списком «показывать по»;\n- `manual`-поиск, сортировка и фильтры, посчитанные по дереву\n (функция `selectTreePage`);\n- сортировка показателей внутри команды и перестановка веток по имени;\n- возврат правок листьев обратно в дерево.\n\n<Canvas of={CellsMergingExamples.SubRowsMerged} />\n\n### rowsGrouping: группировка пользователем\n\nДанные плоские и передаются целиком, остальное делает таблица. Самый короткий\nкод из трёх.\n\nЧто здесь показано:\n\n- встроенные поиск, сортировка и фильтры — применяются до сборки групп;\n- выбор состава группировки пользователем (кнопка `groupButton`);\n- полный стейт фильтров: ключ на каждый фильтр из колонок;\n- без пагинации — чтобы собрать группы, таблице нужны все строки сразу.\n\n<Canvas of={CellsMergingExamples.GroupingMerged} />\n\n## Как перенести пример к себе\n\n1. Замените данные и типы строк на свои. Сохраните стабильный `id` строки — на\n нём держатся выделение и возврат правок, между страницами он меняться не\n должен.\n2. Замените `selectPage` / `selectTreePage` реальным запросом к серверу. Контракт\n тот же: параметры выборки на входе, страница и общее количество на выходе.\n3. Проверьте, что в `filtering.state` есть ключ каждого фильтра из колонок (со\n значением «показать всё»), — селект-фильтр без своего ключа молча отсеет все\n строки.\n4. Для `mergeByCellValues` заведите составные ключи пути, если одинаковые\n названия возможны в разных ветках иерархии.\n5. Уберите фичи, которые вам не нужны, — настройки в примерах независимы друг от\n друга: пагинация, закрепление, чекбоксы, редактирование отключаются по\n отдельности.\n\n# CellsMerging: справочник\n\nПодробности объединения ячеек: совмещение способов, составные ключи, работа с\nдеревом, взаимодействие с остальными фичами таблицы, выравнивание и сводный\nсписок ограничений. Обзор способов и живые примеры — на странице\n[Docs](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging--docs), типы —\nна странице\n[API](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-api--docs).\n\n## Если включено несколько способов сразу\n\nСпособы можно совмещать в одной таблице — правила простые и считаются по колонке:\n\n- Если колонка входит хотя бы в один регион из `mergedCellsRegions`, её\n объединения описывают только регионы. `mergeByCellValues` на этой колонке не\n действует.\n- Колонка merged-вида (группировки или subRows) сливается по границам групп.\n Пользовательский `mergeByCellValues` на той же колонке не действует — иначе два\n механизма спорили бы за одни ячейки.\n- В остальных случаях работает `mergeByCellValues`.\n- Колонка, которую не описывает ни один из способов выше, берёт блоки из\n `mergeCells.lazyRowSpan`, если он задан.\n- Разные колонки живут независимо: регион на одной колонке и слияние по значению\n на другой — обычная рабочая комбинация.\n\nПример: таблица с группировкой по «Отделу» (merged-вид) может дополнительно\nсливать колонку «Статус» через `mergeByCellValues`, а строки-заголовки секций\nрисовать регионами на всю ширину — все три способа уживаются, потому что заняты\nразными колонками.\n\n## Объединение по значению: где проходит граница\n\nУ `mergeByCellValues` есть классическая ловушка. Допустим, регионы «Север» и «Юг»,\nи в каждом есть «Команда 1» и «Команда 2»:\n\n```\nСевер | Команда 1 | Иванов\nСевер | Команда 2 | Петров\nЮг | Команда 2 | Сидоров\nЮг | Команда 1 | Смирнов\n```\n\nЕсли сливать колонку команды по её значению, «Команда 2» из Севера и «Команда 2»\nиз Юга стоят рядом — и сольются в один блок через границу региона. Визуально это\nвыглядит как ошибка: одна команда, а на деле две разные.\n\nРешение — сливать не по тексту в ячейке, а по составному ключу, в котором зашит\nпуть от корня:\n\n```tsx\nmergeCells: {\n mergeByCellValues: [\n 'region',\n // Сравнивается результат функции, а не текст в ячейке.\n { colKey: 'team', value: (row) => `${row.region} / ${row.team}` },\n ],\n}\n```\n\nТеперь у «Команды 2» из Севера ключ «Север / Команда 2», а у южной —\n«Юг / Команда 2». Ключи разные, слияние останавливается на границе региона само,\nбез какой-либо отдельной логики. В ячейке при этом показывается обычное значение\nколонки — функция влияет только на сравнение.\n\nВ полном примере (стори «mergeByCellValues: пример с серверными данными») такие\nключи собраны заранее в полях строки: `divPath`, `unitPath`, `teamPath` — по\nодному на каждый уровень иерархии.\n\nMerged-виды группировки и subRows строят такие ключи сами — там об этой ловушке\nдумать не нужно.\n\n## Дерево через subRows: как передавать данные\n\nРазберём подробнее самый ёмкий сценарий — `subRows` с `view: 'merged'`.\n\n### Какое дерево ждёт таблица\n\nВ `rows` передаются корневые узлы, детей таблица достаёт через `getSubRows`.\nРоли узлов распределены так:\n\n- **Внутренние узлы** (дивизион, управление, команда) — ярлыки уровней. Каждый\n несёт поле с именем своей колонки из `mergedColumns`: узел дивизиона — поле\n `division`, узел управления — поле `unit`, и так далее.\n- **Листья** — строки данных. Именно они становятся строками таблицы со своими\n показателями; внутренние узлы отдельными строками не показываются.\n\n```tsx\nconst tree = [\n {\n id: 'd1',\n division: 'Розничный бизнес', // узел уровня 0\n subRows: [\n {\n id: 'u1',\n unit: 'Управление продаж', // узел уровня 1\n subRows: [\n {\n id: 't1',\n team: 'Команда Север', // узел уровня 2\n subRows: [\n { id: 'e1', employee: 'Иванов', plan: 100, fact: 90 }, // лист\n { id: 'e2', employee: 'Петров', plan: 80, fact: 85 },\n ],\n },\n ],\n },\n ],\n },\n];\n```\n\n```tsx\ntableConfig={{\n subRows: {\n view: 'merged',\n mergedColumns: ['division', 'unit', 'team'], // порядок = уровни дерева\n getSubRows: (row) => row.subRows,\n rowKeyGetter: (row) => row.id,\n },\n}}\n```\n\n`mergedColumns` — это соответствие уровней дерева и колонок: первый элемент\nпоказывает узлы верхнего уровня, второй — следующего, и так далее. Колонка\n`division` возьмёт значение из узла дивизиона и сольётся на все его листья,\n`unit` — на листья своего управления, вложенно.\n\nСворачивания в этом виде нет: таблица показывает всё переданное дерево целиком.\nХотите меньше строк на экране — передайте меньший кусок дерева (следующий\nраздел).\n\n### Пагинация по верхним блокам\n\nДерево у вас, поэтому страницы нарезаете вы — по верхним узлам. Таблице отдаётся\nсрез дерева, а в `pagination.count` — общее число верхних узлов:\n\n```tsx\nconst [page, setPage] = useState(1);\nconst [perPage, setPerPage] = useState(2); // дивизионов на страницу\nconst pageTree = tree.slice((page - 1) * perPage, page * perPage);\n\ntableConfig={{\n pagination: {\n count: tree.length, // всего верхних узлов, не листьев\n perPage,\n perPageList: [1, 2, 3], // варианты «показывать по» — в блоках\n value: page,\n onChange: (nextPage, nextPerPage) => {\n if (typeof nextPerPage === 'number' && nextPerPage !== perPage) {\n setPerPage(nextPerPage);\n setPage(1);\n } else if (typeof nextPage === 'number') {\n setPage(nextPage);\n }\n },\n },\n subRows: { /* как выше */ },\n}}\n// ...\nrows={pageTree}\n```\n\nСтраница «2 дивизиона» может содержать разное число строк-листьев — это нормально:\nединица пагинации здесь блок, а не строка. По той же причине настройте селектор\n«Показывать по»: его стандартные варианты (20/50/100) рассчитаны на строки и для\nблоков не имеют смысла — задайте свой список `perPageList` в блоках, как выше,\nлибо спрячьте селектор (`hasPerPage: false`). Если дерево приходит с сервера\nчастями, вместо `slice` будет запрос следующей страницы — контракт тот же.\n\n### Редактирование: правки возвращаются листьями\n\nРедактируются листья. В `editing.onRowsChange` приходят изменённые строки-листья —\nзаписать их обратно в своё дерево должен потребитель, например по `id`:\n\n```tsx\nediting: {\n rowKeyGetter: (r) => r.id,\n onRowsChange: (updatedLeaves) => {\n const byId = new Map(updatedLeaves.map((r) => [r.id, r]));\n // Обойдите дерево и замените листья с совпавшими id.\n setTree((prev) => writeLeavesBack(prev, byId));\n },\n},\n```\n\nЭто следствие владения данными: таблица не знает, как устроено ваше дерево,\nпоэтому отдаёт плоский результат, а раскладываете его вы.\n\n### Что остаётся на вашей стороне\n\n- **Поиск, сортировка, фильтрация** — встроенные механизмы к структурному дереву\n пока не применяются. Отфильтровали или отсортировали своё дерево — передали\n результат в `rows`, таблица показала.\n- **Выделение** при этом работает из коробки: один чекбокс на верхний блок, клик\n выделяет все его листья (подробнее — в разделе про выделение ниже).\n\nЖивой пример всего вместе — стори «subRows: дерево с пагинацией» на странице\n[Docs](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging--docs).\n\n## Объединение и остальные возможности таблицы\n\nБлоки — не отдельный мир: выделение, сортировка, буфер обмена и редактирование\nпродолжают работать. Здесь собрано, как именно.\n\n### Выделение, нумерация и навигация\n\nВыделение настраивается как обычно — `selecting` со стейтом и `rowKeyGetter`.\nА вот ведёт оно себя по-разному в зависимости от способа объединения:\n\n- **Плоский вид с mergeByCellValues** — чекбокс у каждой строки, номер у каждой\n строки. Объединение колонок на выделение не влияет: в стори\n «mergeByCellValues: пример с серверными данными» можно выделить одного\n сотрудника внутри слитого блока.\n- **Merged-виды группировки и subRows** — один чекбокс и один номер на группу\n верхнего уровня. Клик по чекбоксу выделяет все строки группы разом, повторный —\n снимает. «Выделить всё» в шапке тоже работает. Счётчик выбранного внизу\n считает строки, а не группы: выделили дивизион из 12 сотрудников — внизу\n «выбрано 12».\n\nСпециально настраивать групповое поведение не нужно: таблица включает его сама,\nкогда активен merged-вид.\n\nНавигация тоже понимает блоки: клик в любую точку блока выделяет его целиком,\nрамка фокуса рисуется вокруг всего блока, один шаг стрелкой перепрыгивает блок.\nПопасть «внутрь» блока с клавиатуры нельзя — для таблицы это одна ячейка.\n\n### Сортировка, фильтрация, поиск и пагинация\n\nВозможности зависят от того, кто владеет данными.\n\n**mergeByCellValues (плоский вид).** Встроенные сортировка, фильтр и поиск\nработают как обычно, а блоки пересобираются после каждого изменения порядка —\nобъединение всегда отражает текущий видимый список строк. Если данные приходят с\nсервера постранично, следите, чтобы сортировка на сервере не разрывала группы:\nполовина группы на одной странице и половина на другой будут выглядеть как два\nотдельных блока.\n\n**rowsGrouping (view: 'merged').** Встроенные поиск, сортировка и фильтры\nработают: таблица применяет их к строкам до сборки групп, поэтому группы всегда\nсобираются из уже отфильтрованного списка. Пагинации нет: группировке нужны все\nстроки сразу. Сортировку по группирующим колонкам можно снять настройкой\n`disableGroupColumnsSort` — как в дереве, где сгруппированные колонки не\nсортируются.\n\nЧастая ошибка при встроенных фильтрах (не только в этом виде): в стейте\n`filtering.state` должен быть ключ каждого фильтра, объявленного в колонках.\nSelect-фильтр без своего ключа получит пустое значение вместо «показать всё» и\nможет отсеять все строки — таблица окажется пустой без единой ошибки.\n\n**subRows (view: 'merged').** Дерево у потребителя, поэтому пагинация по верхним\nблокам работает: отдаёте страницу дерева — таблица её показывает. Встроенные\nпоиск, сортировка и фильтрация к структурному дереву пока не применяются — эти\nоперации делаются на стороне потребителя над его данными.\n\n### Копирование, вставка и протяжка\n\n- Копирование отдаёт значение в позиции верхней-левой ячейки блока, остальные\n ячейки блока в буфере пустые — как в Excel.\n- Вставка пишет во весь блок: значение попадает во все его строки.\n- Протяжка (fill) растягивается только до целых блоков — залить пол-блока нельзя;\n пунктирная рамка протяжки сама прилипает к границам блоков.\n\n### Редактирование\n\n- Правка ячейки блока записывает значение во все его строки — данные под блоком\n всегда совпадают с тем, что на экране.\n- При объединении по значению правка пересобирает блоки: изменили «Отдел» у\n блока — он разъедется или сольётся с соседним, потому что объединение выводится\n из данных.\n- У редактируемых Select-ячеек редактор открывается по выравниванию блока: текст\n прижат к низу — редактор откроется у нижнего края, а выпадающий список\n раскроется вверх.\n\n## Выравнивание контента в блоке\n\nПо умолчанию контент блока выравнивается по горизонтали как обычная ячейка\nэтой колонки — из `contentFormat.alignContent` (у числового формата это правый\nкрай), иначе слева. По вертикали — по центру: у обычной ячейки вертикального\nвыравнивания нет, это чисто блочная настройка. Настраивается лестницей «точечное важнее\nобщего»:\n\n- `mergedCellsAlign` конкретного региона (только для `mergedCellsRegions`);\n- `mergedCellsAlign` на колонке — все блоки этой колонки, работает для всех\n способов включения;\n- дефолт фичи: `mergeCells.mergedCellsAlign` или `rowsGrouping.mergedCellsAlign`.\n\n```tsx\ncolumnConfig={[\n { key: 'dept', name: 'Отдел', mergedCellsAlign: { horizontal: 'center', vertical: 'top' } },\n]}\n```\n\nКолоночный `mergedCellsAlign` может быть и функцией `(row) => MergedCellsAlign`\nпо данным строки блока — так разные блоки одной колонки получают разное\nвыравнивание. Это единственный способ управлять выравниванием поблочно в\nmerged-видах группировки и subRows, где границы блоков решает таблица, а не\nпотребитель.\n\n```tsx\ncolumnConfig={[\n { key: 'dept', mergedCellsAlign: (row) =>\n row.critical ? { vertical: 'top' } : { vertical: 'center' } },\n]}\n```\n\n### Свой рендер в блоке\n\nВыравнивание действует на текстовый контент. Кастомный `renderCell` получает весь\nпрямоугольник блока и выравнивает содержимое сам — через свойства своих\nконтейнеров.\n\nУ колонок со своим рендером есть неочевидность: предпросмотр значения (по\nдвойному клику на ячейке без редактирования) у них по умолчанию выключен.\nСо стороны это выглядит как «у блоков не открывается предпросмотр», хотя дело в\nколонке, а не в объединении. Включается настройкой колонки:\n\n```tsx\n{ key: 'dept', renderCell: ..., renderCellPreview: 'cellEditorAsPreview' }\n```\n\n## Что не работает и почему\n\nСводный список ограничений. Если «что-то не рисуется» — сначала сюда.\n\n### Во всех способах\n\n- Все ячейки блока обязаны нести одинаковые данные — это контракт\n `mergeByCellValues` (значения реально повторяются в строках) и регионов.\n Причина проста: блок показывает верхнюю-левую **видимую** ячейку, а какая\n ячейка окажется верхней-левой — зависит от закрепления и порядка колонок.\n Если данные одинаковые, блок выглядит одинаково при любой перестановке.\n- Попасть «внутрь» блока с клавиатуры нельзя — для таблицы это одна ячейка.\n Это поведение, а не ошибка.\n- Выравнивание пока не поддерживает письмо справа налево (RTL).\n- Горизонтальная протяжка через colSpan-блок не растягивается до границ блока\n (в работе).\n- У колонок со своим `renderCell` по умолчанию выключен предпросмотр значения —\n включается `renderCellPreview: 'cellEditorAsPreview'` (см. «Свой рендер в\n блоке» выше).\n\n### mergedCellsRegions\n\n- Разорванный регион исчезает молча: если после сортировки, перестановки или\n скрытия колонок ключи региона перестали идти подряд, блок просто не рисуется.\n Ошибок и предупреждений нет — следите за порядком сами.\n\n### rowsGrouping (view: 'merged')\n\n- Пагинации нет: чтобы собрать группы, таблице нужны все строки сразу.\n- Отдельная колонка «Группировка» не создаётся, поэтому не действует всё, что к\n ней привязано: `groupedColumnProps`, свой контент ячейки группы\n (`renderGroupCell` у колонки) и кнопка «развернуть всё» (`expandAllBtn`) —\n строк-групп и шевронов в этом виде нет.\n\n### subRows (view: 'merged')\n\n- Встроенные поиск, сортировка и фильтрация к структурному дереву не\n применяются — эти операции делает потребитель над своими данными.\n- `column.subRow` целиком не действует: шеврон (`isColumnWithArrow`), свой\n контент и ключи вложенных уровней (`renderSubRowCell`, `keyOfColumnInSubRow`,\n `parentKeyAsDefault`, `contentFormat`), свой редактор уровня. Листья рисуются\n как обычные строки — работают их обычные `renderCell`, `contentFormat` и\n `editingCell`.\n- `expandedIdsState` и сворачивание не действуют: раскрывать нечего, дерево\n показано целиком.\n\nЭто осознанное поведение: один и тот же конфиг `subRows` или `rowsGrouping`\nможно переключать между `view: 'tree'` и `view: 'merged'` — лишние настройки\nдругого вида не мешают. Пометки «работает только в виде дерева» есть и в\nподсказках типов.\n\n> Подробнее о типах — [CellsMerging API](?path=/docs/локальные-компоненты-tablecanvas-cellsmerging-api--docs)",
|
|
49743
49846
|
"apiDocs": "# CellsMerging API\n\n## tableConfig.mergeCells\n\nТочка входа для объединения ячеек тела. Все поля опциональны:\n\n```ts\nmergeCells?: {\n /** Колонки, объединяемые по подряд идущим одинаковым значениям. */\n mergeByCellValues?: Array<string | { colKey: string; value: (row) => unknown }>;\n /** Управляемый список объединений по ключам строк и колонок. */\n mergedCellsRegions?: MergedCellsRegion[];\n /** Нужен для mergedCellsRegions: сопоставляет rowKeys со строками. */\n rowKeyGetter?: (row) => string | number;\n /** Общий (табличный) дефолт выравнивания контента в блоках. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n```\n\n## MergedCellsRegion\n\nОдин управляемый регион: ключи строк, ключи колонок и точечное выравнивание.\n\n```typescript\ntype MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n```\n\n## MergedCellsAlign\n\nВыравнивание контента в блоке. Задаётся на трёх уровнях: `mergedCellsAlign` региона,\n`columnConfig[].mergedCellsAlign` (колонка), `mergeCells.mergedCellsAlign` или\n`rowsGrouping.mergedCellsAlign` (дефолт). Точечное важнее общего.\n\nКолоночный `mergedCellsAlign` — это `MergedCellsAlign` (одно на все блоки колонки) или\nфункция `(row) => MergedCellsAlign | undefined` по данным верхней строки блока. Функция\nдаёт разное выравнивание разным блокам, включая merged-виды группировки/subRows, где\nграницы блоков решает таблица.\n\n```tsx\ncolumnConfig={[\n { key: 'dept', mergedCellsAlign: (row) =>\n row.critical ? { vertical: 'top' } : { vertical: 'center' } },\n]}\n```\n\n```typescript\ntype MergedCellsAlign = {\n /** По горизонтали. @default из `contentFormat.alignContent` колонки, иначе 'left' */\n horizontal?: 'left' | 'center' | 'right';\n /** По вертикали. @default 'center' */\n vertical?: 'top' | 'center' | 'bottom';\n};\n```\n\n## rowsGrouping (merged-вид)\n\nПоля группировки, относящиеся к merged-виду: `view: 'merged'`,\n`mergedCellsAlign`, `disableGroupColumnsSort`.\n\n```typescript\ntype RowsGrouping<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n ColumnConfig extends LocalColumnInstance = LocalColumnInstance,\n> = {\n /**\n * массив группированных колонок и его setter\n */\n groupByState: [string[], React.Dispatch<React.SetStateAction<string[]>>];\n /**\n * Как показывать группировку.\n * 'tree' (по умолчанию) — дерево с раскрытием (шевроны) и колонкой группировки.\n * 'merged' — плоский вид: строки идут по группам, а группирующие колонки\n * показаны объединёнными ячейками. Раскрытия нет; чекбокс и номер — на всю\n * группу верхнего уровня.\n * @default 'tree'\n */\n view?: 'tree' | 'merged';\n /**\n * Только для view: 'merged'. Выравнивание по умолчанию в объединённых ячейках\n * группирующих колонок. Колоночный mergedCellsAlign важнее.\n */\n mergedCellsAlign?: MergedCellsAlign;\n /**\n * Только для view: 'merged'. Запретить сортировку по группирующим колонкам\n * (как в дереве). По остальным колонкам сортировка остаётся.\n * @default false\n */\n disableGroupColumnsSort?: boolean;\n /**\n * Функция определения уникального id строки\n */\n rowKeyGetter: (row: RowType) => string | number;\n /**\n * Показывать ли кнопку «Группировать» в controlBlock.\n * При `false` кнопка скрыта и не участвует в компрессии,\n * но группировка строк продолжает работать от внешнего `groupByState`.\n * @default true\n */\n showInControl?: boolean;\n /**\n * Настройки колонки «Группировка» (имя, ширина, свои рендеры). Работает только\n * в виде дерева: при view: 'merged' эта колонка не создаётся, а сгруппированные\n * колонки остаются на своих местах.\n * @default 'Группировка'\n */\n groupedColumnProps?: Partial<Pick<ColumnConfig, 'name' | 'width'>> & {\n renderCell?: (\n props: CellInfoGlideInstance<RowType, SummaryRowType> & {\n parentGroupKey: string | undefined;\n groupByArr: string[];\n },\n ) => CanvasContent;\n rowsGrouping?: Pick<\n ColumnRowsGrouping<RowType, ColumnConfig>,\n 'renderGroupCell'\n >;\n };\n /** Кнопка «развернуть всё». Работает только в виде дерева: при view: 'merged' шевронов нет. */\n expandAllBtn?: {\n /**\n * Функция для расчета состояния открытости всех раскрываемых строк. Функция должна быть чистой.\n * @returns boolean\n */\n expandedAll: (p: {\n /**\n * allRowsIds - уникальные идентификаторы всех строк (группировок и обычных)\n */\n allRowsIds: Set<string | number> | null;\n /**\n * shownRows - представленные прямо сейчас строки (группировки и обычные). Или видимые строки - видимые не во viewport-е, а которые должны быть показаны из-за раскрытий)\n */\n shownRows: readonly RowType[];\n expandedRowsIds: Set<string | number>;\n }) => boolean;\n };\n /**\n * `groupButton` - свойство для кастомизации кнопки с выпадающим списком\n */\n groupButton?: {\n getGroupedCount?: (props: {\n /**\n * высчитанное автоматически количество активных группировок.\n */\n currCount: number;\n /**\n * активные группировки.\n */\n groupedCols: string[];\n columns: {\n /**\n * `visible` - видимые в выпадающем списке колонки-группировки.\n */\n visible: string[];\n /**\n * `hidden` - невидимые или не участвующие в группировке колонки\n *\n * (columnConfig.rowsGrouping=undefined ||\n * columnConfig.rowsGrouping.groupByColumn=false).\n */\n hidden: string[];\n };\n }) => number;\n /**\n * `defaultCustomItems` - свойство для добавления ключей группировки, которых нет в таблице.\n *\n * `DropdownItemOption.value` - необходимо заполнять ключом, который существует в данных.\n */\n defaultCustomItems?: DropdownItemOption[];\n /**\n * `onItemSelect` - свойство для полного контроля над изменением группировки при выборе опций.\n *\n * `DropdownItemOption.value` - необходимо заполнять ключом, который существует в данных.\n */\n onItemSelect?: (props: {\n item: DropdownItemOption;\n setGroupedCols: React.Dispatch<React.SetStateAction<string[]>>;\n columns: {\n visible: string[];\n hidden: string[];\n };\n }) => void;\n };\n /**\n * `groupRowReplaceTo` - свойство для изменения данных сгруппированных строк. Может понадобиться в редких случаях.\n *\n * @param groupRow данные сгруппированной строки\n * @returns измененная группировка или строка без группировки — строка, которые заменит groupRow\n */\n groupRowReplaceTo?: (\n groupRow: GroupRow<RowType>,\n ) => GroupRow<RowType> | RowType;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\nexport type RenderGroupCellProps<\n RowType extends ObjectForExtending,\n ColumnConfig extends LocalColumnInstance = LocalColumnInstance,\n> = {\n column: ColumnConfig;\n tabIndex: number;\n theme?: Theme;\n // TODO isExpanded: boolean;\n // TODO toggleGroup: () => void;\n} & GroupRow<RowType>;\n\nexport type ColumnRowsGrouping<\n RowType extends ObjectForExtending,\n ColumnConfig extends LocalColumnInstance,\n> = {\n /**\n * @default true - при наличии ColumnConfig.rowsGrouping\n */\n groupByColumn?: boolean;\n /**\n * @default ColumnConfig.key\n */\n columnGroupLabel?: string;\n /**\n * Свой контент ячейки строки-группы. Работает только в виде дерева: при\n * view: 'merged' строк-групп нет (группы показаны объединёнными ячейками),\n * поэтому этот рендер не вызывается.\n */\n renderGroupCell?: (\n props: RenderGroupCellProps<RowType, ColumnConfig>,\n ) => CanvasContent;\n};\n```\n\n## subRows (merged-вид)\n\nПоля subRows, относящиеся к merged-виду: `view: 'merged'` и `mergedColumns`\n(упорядоченный список колонок-предков, индекс = глубина уровня дерева).\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```",
|
|
49744
49847
|
"api": [
|
|
49745
49848
|
{
|
|
@@ -49814,6 +49917,18 @@
|
|
|
49814
49917
|
"type": "full-code",
|
|
49815
49918
|
"code": "import { useState } from 'react';\nimport { Button } from '@daisforge/ui';\nimport {\n Canvas,\n type ColumnConfig,\n type MergedCellsRegion,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\ntype Row = {\n id: number;\n dept: string;\n role: string;\n person: string;\n plan: number;\n fact: number;\n};\n\n// dept/role повторяются в данных: 3 отдела, в каждом 2 роли по 2 сотрудника.\nconst DEPTS = [\n { dept: 'Отдел A', roles: ['Аналитик', 'Разработчик'] },\n { dept: 'Отдел B', roles: ['Разработчик', 'Тестировщик'] },\n { dept: 'Отдел C', roles: ['Менеджер', 'Аналитик'] },\n];\nconst ROWS: Row[] = [];\nlet id = 1;\nfor (const d of DEPTS) {\n for (const role of d.roles) {\n for (let i = 0; i < 2; i += 1) {\n ROWS.push({\n id,\n dept: d.dept,\n role,\n person: \\"
|
|
49816
49919
|
},
|
|
49920
|
+
{
|
|
49921
|
+
"exportName": "LazyRowSpanBlocks",
|
|
49922
|
+
"displayName": "lazyRowSpan: ленивые блоки на 100 000 строк",
|
|
49923
|
+
"type": "full-code",
|
|
49924
|
+
"code": "() => {\n const rows = useMemo<LazyRow[]>(\n () =>\n Array.from({ length: LAZY_ROWS_COUNT }, (_, index) => ({\n id: index,\n region: `Регион ${Math.floor(index / REGION_BLOCK) + 1}`,\n team: `Команда ${(Math.floor(index / TEAM_BLOCK) % 20) + 1}`,\n person: `Сотрудник ${index + 1}`,\n plan: 100 + ((index * 37) % 900),\n })),\n [],\n );\n const columnConfig = useMemo<readonly ColumnConfig<LazyRow>[]>(\n () => [\n { key: 'region', name: 'Регион (lazyRowSpan ×1000)', width: 220 },\n { key: 'team', name: 'Команда (lazyRowSpan ×50)', width: 220 },\n { key: 'person', name: 'Сотрудник', width: 200 },\n { key: 'plan', name: 'План', width: 120, contentFormat: 'number' },\n ],\n [],\n );\n\n return (\n <div>\n <StoryHint>\n <code>mergeCells.lazyRowSpan(row, colKey, rowInd)</code> возвращает\n первую и последнюю строку блока ячейки или <code>null</code>. Таблица\n вызывает его только для видимых ячеек, поэтому способ подходит для\n больших и ленивых данных, где обход всех строк (\n <code>mergeByCellValues</code>) дорог. Здесь блоки считаются по номеру\n строки: регион — по 1000 строк, команда — по 50. Резолвер должен быть\n стабильной функцией.\n </StoryHint>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: '600px' },\n rowMarkers: { startIndex: 1 },\n mergeCells: {\n lazyRowSpan: getLazyRowSpan,\n // Блоки длинные: подпись наверху блока, а не в его середине.\n mergedCellsAlign: { vertical: 'top' },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </div>\n );\n }"
|
|
49925
|
+
},
|
|
49926
|
+
{
|
|
49927
|
+
"exportName": "LazyRowSpanSorted",
|
|
49928
|
+
"displayName": "lazyRowSpan по соседям: с сортировкой",
|
|
49929
|
+
"type": "full-code",
|
|
49930
|
+
"code": "() => {\n const columnConfig = useMemo<readonly ColumnConfig<SortableRow>[]>(\n () => [\n {\n key: 'region',\n name: 'Регион',\n width: 180,\n sortingType: 'stringSort',\n },\n { key: 'person', name: 'Сотрудник', width: 200 },\n {\n key: 'plan',\n name: 'План',\n width: 120,\n contentFormat: 'number',\n sortingType: 'numberSort',\n },\n ],\n [],\n );\n const sortingState = useState<readonly SortColumn[]>([\n { columnKey: 'region', direction: 'DESC' },\n ]);\n\n return (\n <div>\n <StoryHint>\n Первый аргумент <code>lazyRowSpan</code> — строка ячейки, в{' '}\n <code>ctx.rows</code> — отображаемые строки в порядке на экране. Блок\n считается по соседям с тем же регионом, поэтому остаётся верным после\n сортировки: нажмите на заголовок колонки.\n </StoryHint>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: '420px' },\n sorting: { state: sortingState },\n mergeCells: { lazyRowSpan: getRegionRowSpan },\n }}\n columnConfig={columnConfig}\n rows={SORTABLE_ROWS}\n />\n </div>\n );\n }"
|
|
49931
|
+
},
|
|
49817
49932
|
{
|
|
49818
49933
|
"exportName": "Showcase",
|
|
49819
49934
|
"displayName": "mergeByCellValues: пример с серверными данными",
|
|
@@ -50002,8 +50117,8 @@
|
|
|
50002
50117
|
"feature": "ColumnsGrouping",
|
|
50003
50118
|
"legacy": false,
|
|
50004
50119
|
"summary": "*columnConfig.children**",
|
|
50005
|
-
"docs": "# ColumnsGrouping (TableCanvas)\n\n**columnConfig.children**\n\nГруппировка колонок — вложенная структура шапки таблицы. Позволяет объединять несколько колонок под одним общим заголовком, создавая иерархию в шапке.\n\n## Ключевые особенности\n\n- Поддержка многоуровневой вложенности (2, 3+ уровня)\n- Совместимость с `columnsControl`, `resizableColumn`\n- Кастомизация `name` через `ReactNode`\n\n## Как работает\n\nДля создания группы колонок используется `ColumnGroupConfig` вместо обычного `ColumnConfig`. Группа определяется наличием ключа `children`, в котором перечисляются дочерние колонки или вложенные группы.\n\n```tsx\nconst columnConfig = [\n {\n name: 'Основные данные',\n children: [\n { key: 'name', name: 'Имя' },\n { key: 'age', name: 'Возраст' },\n ],\n },\n {\n name: 'Статистика',\n children: [\n { key: 'score', name: 'Баллы' },\n { key: 'rank', name: 'Ранг' },\n ],\n },\n];\n```\n\n## Особенности\n\n- Группа не имеет собственного `key` — это чисто визуальный элемент шапки\n- `name` группы может быть строкой или `ReactNode` для кастомного рендера\n- При использовании с `columnsControl` скрытие/показ работает на уровне дочерних колонок, не на уровне группы\n- При `resizableColumn` ресайз работает на уровне дочерних колонок\n\n## Слияние ячеек шапки (squashEmptyCells)\n\nВ многоуровневой шапке рядом с группами остаются пустые ячейки: у одиночной колонки без группы — пустая полоса СВЕРХУ, у «мелкой» группы (под которой нет более глубоких подгрупп) — пустая полоса СНИЗУ. `tableConfig.columnsGrouping.squashEmptyCells` схлопывает их: одиночная колонка тянется вверх, мелкая группа — вниз, всё одной ячейкой без пустых полос. **Включено по умолчанию**; выключить — `squashEmptyCells: false`.\n\n```tsx\ntableConfig={{ columnsGrouping: { squashEmptyCells: true } }}\n```\n\nОдин переключатель на всю таблицу — не нужно решать по каждой колонке/группе. Пример с тумблером — стори «Группировка (squash)».\n\n### Выравнивание заголовка в слитой ячейке\n\n`squashedHeaderAlign: { horizontal, vertical }` задаёт положение текста в слитой ячейке:\n\n- дефолт на таблице — `tableConfig.columnsGrouping.squashedHeaderAlign`;\n- точечно на колонке (лист) — `columnConfig[].squashedHeaderAlign`;\n- точечно на группе — `ColumnGroupConfig.squashedHeaderAlign`.\n\nЗначение на колонке или группе перекрывает табличный дефолт.\n\n`horizontal` — `left | center | right`; `vertical` — `top | center | bottom`. Дефолт — `left` / по центру по высоте. Действует только на слитой шапке. Пример — стори «Выравнивание заголовка».\n\n### Кастомный контент в слитой шапке\n\nЕсли `name` колонки или группы — canvas-элемент (`Canvas.Text` / `Canvas.Container`), в слитой шапке он центрируется по всей высоте объединённой ячейки. Пример — группа с кастомным `name` в стори «Группировка (squash)».\n\n### Реордер и группы\n\nСлияние совместимо с реордером колонок за шапку (`columnsControl.reorderingHeader`, включён по умолчанию при `columnsControl.enable`). Drag-иконка показывается на листовых колонках, у групп своей нет — перетаскиваются листья.\n\n## Ограничения / edge-кейсы\n\n- Слияние имеет смысл при наличии групп в шапке (иначе групп-рядов нет и сливать нечего).\n- `squashedHeaderAlign` действует только на слитой шапке (при `squashEmptyCells`).\n\n> Подробнее о типах и пропсах — [ColumnsGrouping API](?path=/docs/локальные-компоненты-tablecanvas-columnsgrouping-api--docs)",
|
|
50006
|
-
"apiDocs": "# ColumnsGrouping API\n\n## ColumnsGroupingConfig\n\nКонфиг группировки на уровне таблицы — `tableConfig.columnsGrouping`.\n\n```typescript\ntype ColumnsGroupingConfig = {\n /**\n * Объединять пустые ячейки шапки: колонка без группы (конечная, без вложенных\n * подколонок) растягивается вверх на всю высоту шапки, а «мелкая» группа (без более\n * глубоких подгрупп) — вниз. Убирает пустые полосы в многоуровневой шапке.\n * Включает/выключает поведение сразу для всей таблицы.\n * @default true\n */\n squashEmptyCells?: boolean;\n /**\n * Дефолт выравнивания текста в объединённых ячейках шапки. Влияет только на\n * объединённые ячейки, обычные (не объединённые) ячейки не затрагивает. Точечно\n * перекрывается на колонке или группе через их собственный `squashedHeaderAlign`.\n */\n squashedHeaderAlign?: HeaderAlignment;\n};\n```\n\n## HeaderAlignment\n\n`squashedHeaderAlign` задаёт выравнивание текста в слитой ячейке шапки. Доступно на трёх уровнях: `tableConfig.columnsGrouping.squashedHeaderAlign` (дефолт для таблицы), на колонке `columnConfig[].squashedHeaderAlign` (лист) и на группе `ColumnGroupConfig.squashedHeaderAlign`.\n\n```typescript\ntype HeaderAlignment = {\n /** По горизонтали. @default 'left' */\n horizontal?: 'left' | 'center' | 'right';\n /** По вертикали. @default 'center' */\n vertical?: 'top' | 'center' | 'bottom';\n};\n```\n\n## ColumnGroupConfig\n\n```typescript\ninterface ColumnGroupConfig<\n R extends ObjectForExtending,\n SR = unknown,\n> {\n /** Уникальный ключ группы. */\n readonly key: string;\n
|
|
50120
|
+
"docs": "# ColumnsGrouping (TableCanvas)\n\n**columnConfig.children**\n\nГруппировка колонок — вложенная структура шапки таблицы. Позволяет объединять несколько колонок под одним общим заголовком, создавая иерархию в шапке.\n\n## Ключевые особенности\n\n- Поддержка многоуровневой вложенности (2, 3+ уровня)\n- Совместимость с `columnsControl`, `resizableColumn`\n- Кастомизация `name` через `ReactNode`\n\n## Как работает\n\nДля создания группы колонок используется `ColumnGroupConfig` вместо обычного `ColumnConfig`. Группа определяется наличием ключа `children`, в котором перечисляются дочерние колонки или вложенные группы.\n\n```tsx\nconst columnConfig = [\n {\n name: 'Основные данные',\n children: [\n { key: 'name', name: 'Имя' },\n { key: 'age', name: 'Возраст' },\n ],\n },\n {\n name: 'Статистика',\n children: [\n { key: 'score', name: 'Баллы' },\n { key: 'rank', name: 'Ранг' },\n ],\n },\n];\n```\n\n## Особенности\n\n- Группа не имеет собственного `key` — это чисто визуальный элемент шапки\n- `name` группы может быть строкой или `ReactNode` для кастомного рендера\n- При использовании с `columnsControl` скрытие/показ работает на уровне дочерних колонок, не на уровне группы\n- При `resizableColumn` ресайз работает на уровне дочерних колонок\n\n## Слияние ячеек шапки (squashEmptyCells)\n\nВ многоуровневой шапке рядом с группами остаются пустые ячейки: у одиночной колонки без группы — пустая полоса СВЕРХУ, у «мелкой» группы (под которой нет более глубоких подгрупп) — пустая полоса СНИЗУ. `tableConfig.columnsGrouping.squashEmptyCells` схлопывает их: одиночная колонка тянется вверх, мелкая группа — вниз, всё одной ячейкой без пустых полос. **Включено по умолчанию**; выключить — `squashEmptyCells: false`.\n\n```tsx\ntableConfig={{ columnsGrouping: { squashEmptyCells: true } }}\n```\n\nОдин переключатель на всю таблицу — не нужно решать по каждой колонке/группе. Пример с тумблером — стори «Группировка (squash)».\n\n### Выравнивание заголовка в слитой ячейке\n\n`squashedHeaderAlign: { horizontal, vertical }` задаёт положение текста в слитой ячейке:\n\n- дефолт на таблице — `tableConfig.columnsGrouping.squashedHeaderAlign`;\n- точечно на колонке (лист) — `columnConfig[].squashedHeaderAlign`;\n- точечно на группе — `ColumnGroupConfig.squashedHeaderAlign`.\n\nЗначение на колонке или группе перекрывает табличный дефолт.\n\n`horizontal` — `left | center | right`; `vertical` — `top | center | bottom`. Дефолт — `left` / по центру по высоте. Действует только на слитой шапке. Пример — стори «Выравнивание заголовка».\n\n### Кастомный контент в слитой шапке\n\nЕсли `name` колонки или группы — canvas-элемент (`Canvas.Text` / `Canvas.Container`), в слитой шапке он центрируется по всей высоте объединённой ячейки. Пример — группа с кастомным `name` в стори «Группировка (squash)».\n\n### Реордер и группы\n\nСлияние совместимо с реордером колонок за шапку (`columnsControl.reorderingHeader`, включён по умолчанию при `columnsControl.enable`). Drag-иконка показывается на листовых колонках, у групп своей нет — перетаскиваются листья.\n\n## Клик по заголовку группы\n\n- `tableConfig.onGroupHeaderClicked(colIndex, { key, children }, event)` и\n `tableConfig.onGroupHeaderContextMenu(colIndex, { key, children }, event)` — клик\n и правый клик по заголовку группы. Второй аргумент — группа уровня, по которому\n кликнули, из `columnConfig`: `key` и `children` (вложенные колонки и подгруппы).\n `event` — событие glide, в `event.group` тот же ключ.\n `colIndex` — индекс колонки в координатах грида: служебные колонки слева\n (нумерация `rowMarkers`, чекбоксы `selecting`) входят в счёт.\n- Клик по группе выделяет её колонки (если включено выделение колонок).\n- Canvas-элементы в кастомном `name` группы получают клик первыми, как в листовой\n шапке: кнопка с `interaction={{ selection: 'keep', cellClick: 'stop' }}`\n обрабатывает клик сама, группа при этом не выделяется и обработчик группы не\n вызывается. Пример — стори «Клик по заголовку группы».\n\n## Ограничения / edge-кейсы\n\n- Слияние имеет смысл при наличии групп в шапке (иначе групп-рядов нет и сливать нечего).\n- `squashedHeaderAlign` действует только на слитой шапке (при `squashEmptyCells`).\n\n> Подробнее о типах и пропсах — [ColumnsGrouping API](?path=/docs/локальные-компоненты-tablecanvas-columnsgrouping-api--docs)",
|
|
50121
|
+
"apiDocs": "# ColumnsGrouping API\n\n## ColumnsGroupingConfig\n\nКонфиг группировки на уровне таблицы — `tableConfig.columnsGrouping`.\n\n```typescript\ntype ColumnsGroupingConfig = {\n /**\n * Объединять пустые ячейки шапки: колонка без группы (конечная, без вложенных\n * подколонок) растягивается вверх на всю высоту шапки, а «мелкая» группа (без более\n * глубоких подгрупп) — вниз. Убирает пустые полосы в многоуровневой шапке.\n * Включает/выключает поведение сразу для всей таблицы.\n * @default true\n */\n squashEmptyCells?: boolean;\n /**\n * Дефолт выравнивания текста в объединённых ячейках шапки. Влияет только на\n * объединённые ячейки, обычные (не объединённые) ячейки не затрагивает. Точечно\n * перекрывается на колонке или группе через их собственный `squashedHeaderAlign`.\n */\n squashedHeaderAlign?: HeaderAlignment;\n};\n```\n\n## HeaderAlignment\n\n`squashedHeaderAlign` задаёт выравнивание текста в слитой ячейке шапки. Доступно на трёх уровнях: `tableConfig.columnsGrouping.squashedHeaderAlign` (дефолт для таблицы), на колонке `columnConfig[].squashedHeaderAlign` (лист) и на группе `ColumnGroupConfig.squashedHeaderAlign`.\n\n```typescript\ntype HeaderAlignment = {\n /** По горизонтали. @default 'left' */\n horizontal?: 'left' | 'center' | 'right';\n /** По вертикали. @default 'center' */\n vertical?: 'top' | 'center' | 'bottom';\n};\n```\n\n## ColumnGroupConfig\n\n```typescript\ninterface ColumnGroupConfig<\n R extends ObjectForExtending,\n SR = unknown,\n> {\n /** Уникальный ключ группы. */\n readonly key: string;\n /**\n * Название группы, отображается в ячейке шапки. Строка или JSX.\n * JSX рисуется на всю ячейку без отступов: горизонтальный отступ задаёт сам\n * потребитель, например `<Canvas.Container padding={{ left: 8, right: 8 }}>`.\n */\n readonly name: string | ReactElement;\n // readonly headerCellClass?: Maybe<string>;\n /** Вложенные колонки и подгруппы этой группы. */\n readonly children: readonly ColumnOrColumnGroupConfig<R, SR>[];\n /** Выравнивание текста в объединённой шапке группы. Действует при squashEmptyCells. */\n readonly squashedHeaderAlign?: HeaderAlignment;\n}\n```\n\n## ColumnOrColumnGroupConfig\n\n```typescript\ntype ColumnOrColumnGroupConfig<\n R extends ObjectForExtending,\n SR = unknown,\n> = ColumnConfig<R, SR> | ColumnGroupConfig<R, SR>;\n```",
|
|
50007
50122
|
"api": [
|
|
50008
50123
|
{
|
|
50009
50124
|
"typeName": "ColumnsGroupingConfig",
|
|
@@ -50015,7 +50130,7 @@
|
|
|
50015
50130
|
},
|
|
50016
50131
|
{
|
|
50017
50132
|
"typeName": "ColumnGroupConfig",
|
|
50018
|
-
"source": "interface ColumnGroupConfig<\n R extends ObjectForExtending,\n SR = unknown,\n> {\n /** Уникальный ключ группы. */\n readonly key: string;\n
|
|
50133
|
+
"source": "interface ColumnGroupConfig<\n R extends ObjectForExtending,\n SR = unknown,\n> {\n /** Уникальный ключ группы. */\n readonly key: string;\n /**\n * Название группы, отображается в ячейке шапки. Строка или JSX.\n * JSX рисуется на всю ячейку без отступов: горизонтальный отступ задаёт сам\n * потребитель, например `<Canvas.Container padding={{ left: 8, right: 8 }}>`.\n */\n readonly name: string | ReactElement;\n // readonly headerCellClass?: Maybe<string>;\n /** Вложенные колонки и подгруппы этой группы. */\n readonly children: readonly ColumnOrColumnGroupConfig<R, SR>[];\n /** Выравнивание текста в объединённой шапке группы. Действует при squashEmptyCells. */\n readonly squashedHeaderAlign?: HeaderAlignment;\n}"
|
|
50019
50134
|
},
|
|
50020
50135
|
{
|
|
50021
50136
|
"typeName": "ColumnOrColumnGroupConfig",
|
|
@@ -50027,13 +50142,19 @@
|
|
|
50027
50142
|
"exportName": "Playground",
|
|
50028
50143
|
"displayName": "Группировка (squash)",
|
|
50029
50144
|
"type": "full-code",
|
|
50030
|
-
"code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n TableCanvas,\n} from '@daisforge/ui/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 }"
|
|
50145
|
+
"code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n type GroupHeaderInfo,\n TableCanvas,\n} from '@daisforge/ui/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 }"
|
|
50031
50146
|
},
|
|
50032
50147
|
{
|
|
50033
50148
|
"exportName": "HeaderAlign",
|
|
50034
50149
|
"displayName": "Выравнивание заголовка",
|
|
50035
50150
|
"type": "full-code",
|
|
50036
|
-
"code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const columnConfig: ColumnOrColumnGroupConfig<Row>[] = [\n // Лист без группы: выравнивание на колонке. Имя короткое, колонка широкая,\n // чтобы было видно позицию текста.\n {\n key: 'id',\n name: 'top-left',\n width: 200,\n squashedHeaderAlign: { horizontal: 'left', vertical: 'top' },\n },\n // Глубокая группа задаёт третий уровень, чтобы соседняя группа стала «мелкой».\n {\n key: 'deep',\n name: 'Глубокая',\n children: [\n {\n key: 'sub',\n name: 'Подгруппа',\n children: [\n { key: 'task', name: 'A', width: 110 },\n { key: 'priority', name: 'B', width: 110 },\n ],\n },\n ],\n },\n // Мелкая группа (сливается вниз): выравнивание на группе. Колонка широкая,\n // чтобы короткое имя было видно прижатым вниз-вправо.\n {\n key: 'shallow',\n name: 'bottom-right',\n squashedHeaderAlign: { horizontal: 'right', vertical: 'bottom' },\n children: [{ key: 'complete', name: 'C', width: 240 }],\n },\n ];\n\n return (\n <TableCanvas\n tableConfig={{ containerStyle: { height: 320 } }}\n columnConfig={columnConfig}\n rows={spanRows}\n />\n );\n }"
|
|
50151
|
+
"code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n type GroupHeaderInfo,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const columnConfig: ColumnOrColumnGroupConfig<Row>[] = [\n // Лист без группы: выравнивание на колонке. Имя короткое, колонка широкая,\n // чтобы было видно позицию текста.\n {\n key: 'id',\n name: 'top-left',\n width: 200,\n squashedHeaderAlign: { horizontal: 'left', vertical: 'top' },\n },\n // Глубокая группа задаёт третий уровень, чтобы соседняя группа стала «мелкой».\n {\n key: 'deep',\n name: 'Глубокая',\n children: [\n {\n key: 'sub',\n name: 'Подгруппа',\n children: [\n { key: 'task', name: 'A', width: 110 },\n { key: 'priority', name: 'B', width: 110 },\n ],\n },\n ],\n },\n // Мелкая группа (сливается вниз): выравнивание на группе. Колонка широкая,\n // чтобы короткое имя было видно прижатым вниз-вправо.\n {\n key: 'shallow',\n name: 'bottom-right',\n squashedHeaderAlign: { horizontal: 'right', vertical: 'bottom' },\n children: [{ key: 'complete', name: 'C', width: 240 }],\n },\n ];\n\n return (\n <TableCanvas\n tableConfig={{ containerStyle: { height: 320 } }}\n columnConfig={columnConfig}\n rows={spanRows}\n />\n );\n }"
|
|
50152
|
+
},
|
|
50153
|
+
{
|
|
50154
|
+
"exportName": "GroupHeaderClick",
|
|
50155
|
+
"displayName": "Клик по заголовку группы",
|
|
50156
|
+
"type": "full-code",
|
|
50157
|
+
"code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n type GroupHeaderInfo,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n const [log, setLog] = useState<string[]>([]);\n const pushLog = (message: string) =>\n setLog((prev) => [message, ...prev].slice(0, 5));\n const describeGroup = ({ key, children }: GroupHeaderInfo<Row>) =>\n `группа «${key}», колонки: ${children\n .map((child) => child.key)\n .join(', ')}`;\n\n const columnConfig = useMemo<ColumnOrColumnGroupConfig<Row>[]>(\n () => [\n { key: 'id', name: 'ID', width: 90 },\n {\n key: 'work',\n name: 'Работа',\n children: [\n { key: 'task', name: 'Задача', width: 200 },\n { key: 'priority', name: 'Приоритет', width: 140 },\n ],\n },\n {\n key: 'progress',\n name: (\n <Canvas.Container\n direction=\"row\"\n alignItems=\"center\"\n gap={4}\n padding={{ left: 8, right: 8 }}\n >\n <Canvas.Text font={tableCanvasFonts.bodyXSBold}>\n Прогресс\n </Canvas.Text>\n <Canvas.IconButton\n icon={<IconStar />}\n view=\"clear\"\n buttonSize=\"xs\"\n interaction={{ selection: 'keep', cellClick: 'stop' }}\n onClick={() => pushLog('кнопка в заголовке группы «Прогресс»')}\n />\n </Canvas.Container>\n ),\n children: [\n { key: 'developer', name: 'Исполнитель', width: 160 },\n { key: 'complete', name: '% Готовности', width: 140 },\n ],\n },\n ],\n [],\n );\n\n return (\n <div>\n <StoryHint>\n Кликни по заголовку группы — придёт <code>onGroupHeaderClicked</code>{' '}\n и выделятся её колонки. Правый клик —{' '}\n <code>onGroupHeaderContextMenu</code>. Кнопка-звёздочка в группе\n «Прогресс» обрабатывает клик сама и группу не выделяет.\n </StoryHint>\n <p style={{ minHeight: 100, fontSize: 13, marginBottom: 8 }}>\n {log.length === 0\n ? 'событий пока нет'\n : log.map((line, index) => (\n // eslint-disable-next-line react/no-array-index-key\n <span key={index} style={{ display: 'block' }}>\n {line}\n </span>\n ))}\n </p>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 400 },\n rowMarkers: { startIndex: 1 },\n onGroupHeaderClicked: (_colIndex, group) =>\n pushLog(`onGroupHeaderClicked: ${describeGroup(group)}`),\n onGroupHeaderContextMenu: (_colIndex, group, event) => {\n event.preventDefault();\n pushLog(`onGroupHeaderContextMenu: ${describeGroup(group)}`);\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </div>\n );\n }"
|
|
50037
50158
|
}
|
|
50038
50159
|
]
|
|
50039
50160
|
},
|
|
@@ -50122,7 +50243,7 @@
|
|
|
50122
50243
|
"feature": "ControlBlock",
|
|
50123
50244
|
"legacy": false,
|
|
50124
50245
|
"summary": "*tableConfig.controlBlock**",
|
|
50125
|
-
"docs": "# ControlBlock (TableCanvas)\n\n**tableConfig.controlBlock**\n\nПанель управления таблицы (верхний блок с кнопками).\n\n## Ключевые особенности\n\n- Поиск по таблице\n- Кнопки действий (`rightSideInner`) и кастомные фичи с иконками (`customFeatures`)\n- Встроенные фичи: ключ-текст, группировка строк, размер строк, полноэкранный режим\n- Режим редактирования с кастомным слотом слева (`editModeLeftSlot`)\n- Заголовок таблицы и сворачивание, внутри панели или над таблицей\n- Три размера панели: `m`, `s`, `xs`. `m` и `s` одинаковы и подходят всем продуктам, `xs` использует команда APE\n- Компрессия по ширине: лишние фичи уезжают в overflow-дропдаун, его ширина, размер и иконки внутри подстраиваются под `rowSize`\n\n## Размеры\n\nРазмер панели задаётся в `tableConfig.controlBlock.size`: `m`, `s` или `xs`. Размер каскадно применяется к кнопкам, поиску, заголовку и кнопке сворачивания. Высота панели: `m` и `s` дают 40px, `xs` дает 32px.\n\n`m` и `s` дают одинаковый размер и предназначены для всех продуктов. `xs` это компактный режим, его использует команда APE. Примеры `xs` смотрите в разделе ControlBlock APE.\n\n## Заголовок и сворачивание\n\nЗаголовок и сворачивание настраиваются в `tableConfig.collapsing` (на уровне всей таблицы, рядом с `controlBlock`, а не внутри него).\n\n- `titleText` показывает заголовок таблицы (для своего узла есть `titleRender`).\n- `enableCollapse` добавляет кнопку сворачивания таблицы.\n- `collapseButtonPlacement` задаёт, где живут заголовок и кнопка: `inside` (по умолчанию) рисует их внутри самой панели, `above` выносит в отдельную полосу над таблицей. Для режима `above` есть `collapseButtonAboveRightSlot` под свой контент справа.\n\n## Фичи и details\n\nКастомные фичи задаются в `tableConfig.controlBlock.customFeatures` (массив). Каждая фича рисуется в панели как иконка, а при компрессии может уехать в overflow-дропдаун.\n\nИконку в самой панели задают на фиче через `Icon` (компонент иконки) или `CustomIconRender` (свой рендер).\n\nПоле `details` (на той же фиче) описывает, как фича выглядит, когда уезжает в дропдаун. Раньше `details` отвечал за правый сайдбар, теперь за дропдаун. Имя оставили, чтобы не ломать существующий код.\n\nТипы `details`:\n\n- `button` — пункт с иконкой и действием\n- `switch` — переключатель\n- `select` — выпадающий список\n- `custom` — свой рендер пункта\n\nТочные типы фич и `details` смотрите в [ControlBlock API](?path=/docs/локальные-компоненты-tablecanvas-controlblock-api--docs), готовые примеры — в stories ниже.\n\n## Поведение при компрессии\n\nКогда таблице не хватает ширины, фичи по одной уезжают в overflow-дропдаун (троеточие). В дропдауне фича показывается по своему `details`; фича без `details` при нехватке места просто скрывается.\n\nОба флага ниже задаются на самой фиче (элемент массива `customFeatures`):\n\n- `canBeCompressedInToolsMenu` управляет уходом фичи в дропдаун. По умолчанию `true`, при нехватке места фича может уехать в overflow-дропдаун. Поставьте `false`, чтобы фича всегда оставалась видимой в панели и никогда не пряталась.\n- `mandatory: true` ставит фичу в начало панели и закрепляет её там. Влияет на порядок и присутствие фичи в панели (наследие старого распределения панель и сайдбар), а уходом в дропдаун управляет именно `canBeCompressedInToolsMenu`.\n\n## Размер иконок в дропдауне\n\nСам дропдаун подстраивается под `rowSize`: на маленьком `rowSize` он уже и компактнее. Поэтому и иконки внутри берутся на ступень меньше, чем в самой панели.\n\n- Наши штатные фичи мы размеряем сами по дизайн-макетам. Иконки-компоненты (`Icon`), а также ключ-текст, группировка и вид отображения мельчают в дропдауне автоматически, ничего делать не нужно.\n- Свои кастомные фичи в правой части размеряете вы. Готовый JSX размер сам не знает, поэтому кастомные рендеры получают контекст `{ rowSize, isInDropdown }` и подбирают размер сами. `isInDropdown` отличает панель (`false`, иконка обычная) от дропдауна (`true`, мельче при маленьком `rowSize`):\n\n```tsx\n// кастомная иконка фичи в панели и в дропдауне (поле CustomIconRender фичи)\nCustomIconRender: ({ rowSize, isInDropdown }) => (\n <IconStar size={isInDropdown && rowSize === 'small' ? 'xs' : 's'} />\n),\n\n// иконка фичи в details, задаём функцией вместо готового узла\ndetails: {\n type: 'button',\n label: 'Экспорт',\n icon: ({ rowSize, isInDropdown }) => (\n <IconExport size={isInDropdown && rowSize === 'small' ? 'xs' : 's'} />\n ),\n onClick: handleExport,\n},\n\n// иконка кнопки rightSideInner, когда она уезжает в дропдаун\n{\n text: 'Сохранить',\n contentLeft: <IconSave />,\n dropdownIconRender: ({ rowSize }) => (\n <IconSave size={rowSize === 'small' ? 'xs' : 's'} />\n ),\n},\n```\n\nЕсли оставить статичный узел (`icon: <IconExport />`, `CustomIconRender: () => <Icon />`), он работает как раньше, просто размер в дропдауне не меняется.\n\nПодробнее смотрите примеры в сториях ниже: там кастомные фичи получают `rowSize` и `isInDropdown` и сами выбирают размер иконки для дропдауна.\n\n## Кнопки с дропдауном\n\nУ кнопок правой части (`rightSideInner`) с `dropdown` шеврон раскрытия рисуется автоматически. Если `contentRight` не задан, кнопка сама показывает справа `IconChevronDown` с анимацией флипа при открытии дропдауна. Размер шеврона берётся из той же размерной сетки, что и иконки кнопок, отдельно его задавать не нужно.\n\nЕсли `contentRight` задан (например счётчик у группировки), используется он, авто-шеврон не добавляется. Анимацию флипа панель навешивает только на свой авто-шеврон, ваш `contentRight` рендерится как есть, контроль за анимация остается на вашей стороне в этом случае.\n\nРазмер иконки кнопки (`contentLeft`) панель задаёт сама под свой размер, отдельно его указывать не нужно. Но если вы явно проставили `size` на иконке своей кнопки, он сохраняется, панель его не перезаписывает.\n\n## Разделители\n\nНа фиче в `customFeatures` можно включить разделитель слева через `dividerLeft: true`. Если по дизайн-макету ваша кастомная фича отделена разделителем, задайте `dividerLeft`. Разделители сохраняются и в overflow-дропдауне, в той же последовательности, что и в панели.\n\n## Устаревшее\n\n- `controlBlock.leftSideInner` (кнопки в левой части панели, блок «Действия»). Используйте `controlBlock.rightSideInner` или `controlBlock.customFeatures`.\n- Link-стили у кнопок панели (`view: 'linkDefault'`, `'linkAccent'` и подобные на `ControlBlockButtonProps`) и `controlButtonDefaultProps`. Кнопки панели теперь рисуются как обычные, link-стиль маппится автоматически.\n- Старый `dropdown` на фиче заменён на `details`, `customDropdownItem` больше не поддерживается.\n- Свойство `view` в `tableConfig` не используется.\n\n## Пример конфигурации\n\n```tsx\nconst tableConfig = {\n // заголовок и сворачивание — на уровне таблицы, рядом с controlBlock\n collapsing: {\n enableCollapse: true,\n titleText: 'Реестр задач',\n collapseButtonPlacement: 'above',\n },\n controlBlock: {\n size: 's',\n customFeatures: [\n {\n value: 'customPin',\n label: pinIsActive ? 'Открепить' : 'Закрепить',\n Icon: pinIsActive ? IconPinOutline : IconPinFill,\n onClick: () => setPinIsActive(!pinIsActive),\n // по умолчанию true; поставьте false, чтобы фича не пряталась в дропдаун\n canBeCompressedInToolsMenu: true,\n details: {\n type: 'switch',\n label: 'Закрепление колонок',\n checked: pinIsActive,\n onChange: () => setPinIsActive(!pinIsActive),\n },\n },\n ],\n },\n};\n```\n\n> Подробнее о типах — [ControlBlock API](?path=/docs/локальные-компоненты-tablecanvas-controlblock-api--docs)\n\n# SplitIconButton (TableCanvas)\n\nПереиспользуемый компонент для кастомных слотов ControlBlock. Это пара кнопок-иконок рядом: основное действие слева и кнопка-шеврон справа, открывающая дропдаун (паттерн split button). Реэкспортируется из TableCanvas, импорт: `import { SplitIconButton } from '@daisforge/ui/components/TableCanvas'`.\n\n## Ключевые особенности\n\n- Две независимые кнопки: основная иконка (`onIconClick`) и кнопка-шеврон, открывающая дропдаун\n- Шеврон и анимация раскрытия идут от компонента, левую иконку и размеры задаёт разработчик\n- Дропдаун под капотом это TableDropdown, поэтому ширина и размер списка подхватывают `rowSize` таблицы автоматически\n- Пункты дропдауна (`items`) полностью на стороне разработчика: галочки, иконки или ничего, библиотека их только прокидывает\n- Если `items` не заданы, шеврон работает как обычная кнопка (`onChevronClick`)\n\n## Где использовать\n\n- `editing.editModeLeftSlot` это кастомный слот слева в режиме редактирования\n- `controlBlock.customFeatures[].CustomIconRender` это кастомная фича в правой части панели\n\n## Особенности\n\n- Работает только внутри контекста TableCanvas, потому что дропдаун использует контекст таблицы (`rowSize`, контейнер). Вне таблицы не используется.\n- Размеры задаёт потребитель: `size` для кнопок, `chevronSize` для иконки шеврона, размер своей иконки слева.\n- При компрессии фича уезжает в overflow-дропдаун. Её свёрнутый вид описывается через `details` самой фичи, а не через сам компонент. Например `details: { type: 'select' }` с галочкой активного пункта в `contentLeft` опций.\n\nОписание типов в разделе [SplitIconButton API](?path=/docs/локальные-компоненты-tablecanvas-controlblock-spliticonbutton-api--docs).",
|
|
50246
|
+
"docs": "# ControlBlock (TableCanvas)\n\n**tableConfig.controlBlock**\n\nПанель управления таблицы (верхний блок с кнопками).\n\n## Ключевые особенности\n\n- Поиск по таблице\n- Кнопки действий (`rightSideInner`) и кастомные фичи с иконками (`customFeatures`)\n- Встроенные фичи: ключ-текст, группировка строк, размер строк, полноэкранный режим\n- Режим редактирования с кастомным слотом слева (`editModeLeftSlot`)\n- Заголовок таблицы и сворачивание, внутри панели или над таблицей\n- Три размера панели: `m`, `s`, `xs`. `m` и `s` одинаковы и подходят всем продуктам, `xs` использует команда APE\n- Компрессия по ширине: лишние фичи уезжают в overflow-дропдаун, его ширина, размер и иконки внутри подстраиваются под `rowSize`\n\n## Размеры\n\nРазмер панели задаётся в `tableConfig.controlBlock.size`: `m`, `s` или `xs`. Размер каскадно применяется к кнопкам, поиску, заголовку и кнопке сворачивания. Высота панели: `m` и `s` дают 40px, `xs` дает 32px.\n\n`m` и `s` дают одинаковый размер и предназначены для всех продуктов. `xs` это компактный режим, его использует команда APE. Примеры `xs` смотрите в разделе ControlBlock APE.\n\n## Заголовок и сворачивание\n\nЗаголовок и сворачивание настраиваются в `tableConfig.collapsing` (на уровне всей таблицы, рядом с `controlBlock`, а не внутри него).\n\n- `titleText` показывает заголовок таблицы (для своего узла есть `titleRender`).\n- `enableCollapse` добавляет кнопку сворачивания таблицы.\n- `collapseButtonPlacement` задаёт, где живут заголовок и кнопка: `inside` (по умолчанию) рисует их внутри самой панели, `above` выносит в отдельную полосу над таблицей. Для режима `above` есть `collapseButtonAboveRightSlot` под свой контент справа.\n\n## Фичи и details\n\nКастомные фичи задаются в `tableConfig.controlBlock.customFeatures` (массив). Каждая фича рисуется в панели как иконка, а при компрессии может уехать в overflow-дропдаун.\n\nИконку в самой панели задают на фиче через `Icon` (компонент иконки) или `CustomIconRender` (свой рендер).\n\nПоле `details` (на той же фиче) описывает, как фича выглядит, когда уезжает в дропдаун. Раньше `details` отвечал за правый сайдбар, теперь за дропдаун. Имя оставили, чтобы не ломать существующий код.\n\nТипы `details`:\n\n- `button` — пункт с иконкой и действием\n- `switch` — переключатель\n- `select` — выпадающий список\n- `custom` — свой рендер пункта\n\nТочные типы фич и `details` смотрите в [ControlBlock API](?path=/docs/локальные-компоненты-tablecanvas-controlblock-api--docs), готовые примеры — в stories ниже.\n\n## Поведение при компрессии\n\nКогда таблице не хватает ширины, фичи по одной уезжают в overflow-дропдаун (троеточие). В дропдауне фича показывается по своему `details`; фича без `details` при нехватке места просто скрывается.\n\nОба флага ниже задаются на самой фиче (элемент массива `customFeatures`):\n\n- `canBeCompressedInToolsMenu` управляет уходом фичи в дропдаун. По умолчанию `true`, при нехватке места фича может уехать в overflow-дропдаун. Поставьте `false`, чтобы фича всегда оставалась видимой в панели и никогда не пряталась.\n- `mandatory: true` ставит фичу в начало панели и закрепляет её там. Влияет на порядок и присутствие фичи в панели (наследие старого распределения панель и сайдбар), а уходом в дропдаун управляет именно `canBeCompressedInToolsMenu`.\n\n## Размер иконок в дропдауне\n\nСам дропдаун подстраивается под `rowSize`: на маленьком `rowSize` он уже и компактнее. Поэтому и иконки внутри берутся на ступень меньше, чем в самой панели.\n\n- Наши штатные фичи мы размеряем сами по дизайн-макетам. Иконки-компоненты (`Icon`), а также ключ-текст, группировка и вид отображения мельчают в дропдауне автоматически, ничего делать не нужно.\n- Свои кастомные фичи в правой части размеряете вы. Готовый JSX размер сам не знает, поэтому кастомные рендеры получают контекст `{ rowSize, isInDropdown }` и подбирают размер сами. `isInDropdown` отличает панель (`false`, иконка обычная) от дропдауна (`true`, мельче при маленьком `rowSize`):\n\n```tsx\n// кастомная иконка фичи в панели и в дропдауне (поле CustomIconRender фичи)\nCustomIconRender: ({ rowSize, isInDropdown }) => (\n <IconStar size={isInDropdown && rowSize === 'small' ? 'xs' : 's'} />\n),\n\n// иконка фичи в details, задаём функцией вместо готового узла\ndetails: {\n type: 'button',\n label: 'Экспорт',\n icon: ({ rowSize, isInDropdown }) => (\n <IconExport size={isInDropdown && rowSize === 'small' ? 'xs' : 's'} />\n ),\n onClick: handleExport,\n},\n\n// иконка кнопки rightSideInner, когда она уезжает в дропдаун\n{\n text: 'Сохранить',\n contentLeft: <IconSave />,\n dropdownIconRender: ({ rowSize }) => (\n <IconSave size={rowSize === 'small' ? 'xs' : 's'} />\n ),\n},\n```\n\nЕсли оставить статичный узел (`icon: <IconExport />`, `CustomIconRender: () => <Icon />`), он работает как раньше, просто размер в дропдауне не меняется.\n\nПодробнее смотрите примеры в сториях ниже: там кастомные фичи получают `rowSize` и `isInDropdown` и сами выбирают размер иконки для дропдауна.\n\n## Размер строк снаружи\n\nКнопка размера строк в панели включается `rowSize.showInControl`. По умолчанию\nразмер хранится внутри таблицы (начальное значение — `rowSize.default`). Если\nпереключатель нужен и вне таблицы, передайте `rowSize.state` — кортеж\n`[size, setSize]`: таблица читает размер оттуда, а кнопка в панели меняет его\nчерез тот же setter.\n\n```tsx\nconst rowSizeState = useState<SIZE>('medium');\n\ntableConfig={{ rowSize: { state: rowSizeState, showInControl: true } }}\n```\n\n## Кнопки с дропдауном\n\nУ кнопок правой части (`rightSideInner`) с `dropdown` шеврон раскрытия рисуется автоматически. Если `contentRight` не задан, кнопка сама показывает справа `IconChevronDown` с анимацией флипа при открытии дропдауна. Размер шеврона берётся из той же размерной сетки, что и иконки кнопок, отдельно его задавать не нужно.\n\nЕсли `contentRight` задан (например счётчик у группировки), используется он, авто-шеврон не добавляется. Анимацию флипа панель навешивает только на свой авто-шеврон, ваш `contentRight` рендерится как есть, контроль за анимация остается на вашей стороне в этом случае.\n\nРазмер иконки кнопки (`contentLeft`) панель задаёт сама под свой размер, отдельно его указывать не нужно. Но если вы явно проставили `size` на иконке своей кнопки, он сохраняется, панель его не перезаписывает.\n\n## Разделители\n\nНа фиче в `customFeatures` можно включить разделитель слева через `dividerLeft: true`. Если по дизайн-макету ваша кастомная фича отделена разделителем, задайте `dividerLeft`. Разделители сохраняются и в overflow-дропдауне, в той же последовательности, что и в панели.\n\n## Устаревшее\n\n- `controlBlock.leftSideInner` (кнопки в левой части панели, блок «Действия»). Используйте `controlBlock.rightSideInner` или `controlBlock.customFeatures`.\n- Link-стили у кнопок панели (`view: 'linkDefault'`, `'linkAccent'` и подобные на `ControlBlockButtonProps`) и `controlButtonDefaultProps`. Кнопки панели теперь рисуются как обычные, link-стиль маппится автоматически.\n- Старый `dropdown` на фиче заменён на `details`, `customDropdownItem` больше не поддерживается.\n- Свойство `view` в `tableConfig` не используется.\n\n## Пример конфигурации\n\n```tsx\nconst tableConfig = {\n // заголовок и сворачивание — на уровне таблицы, рядом с controlBlock\n collapsing: {\n enableCollapse: true,\n titleText: 'Реестр задач',\n collapseButtonPlacement: 'above',\n },\n controlBlock: {\n size: 's',\n customFeatures: [\n {\n value: 'customPin',\n label: pinIsActive ? 'Открепить' : 'Закрепить',\n Icon: pinIsActive ? IconPinOutline : IconPinFill,\n onClick: () => setPinIsActive(!pinIsActive),\n // по умолчанию true; поставьте false, чтобы фича не пряталась в дропдаун\n canBeCompressedInToolsMenu: true,\n details: {\n type: 'switch',\n label: 'Закрепление колонок',\n checked: pinIsActive,\n onChange: () => setPinIsActive(!pinIsActive),\n },\n },\n ],\n },\n};\n```\n\n> Подробнее о типах — [ControlBlock API](?path=/docs/локальные-компоненты-tablecanvas-controlblock-api--docs)\n\n# SplitIconButton (TableCanvas)\n\nПереиспользуемый компонент для кастомных слотов ControlBlock. Это пара кнопок-иконок рядом: основное действие слева и кнопка-шеврон справа, открывающая дропдаун (паттерн split button). Реэкспортируется из TableCanvas, импорт: `import { SplitIconButton } from '@daisforge/ui/components/TableCanvas'`.\n\n## Ключевые особенности\n\n- Две независимые кнопки: основная иконка (`onIconClick`) и кнопка-шеврон, открывающая дропдаун\n- Шеврон и анимация раскрытия идут от компонента, левую иконку и размеры задаёт разработчик\n- Дропдаун под капотом это TableDropdown, поэтому ширина и размер списка подхватывают `rowSize` таблицы автоматически\n- Пункты дропдауна (`items`) полностью на стороне разработчика: галочки, иконки или ничего, библиотека их только прокидывает\n- Если `items` не заданы, шеврон работает как обычная кнопка (`onChevronClick`)\n\n## Где использовать\n\n- `editing.editModeLeftSlot` это кастомный слот слева в режиме редактирования\n- `controlBlock.customFeatures[].CustomIconRender` это кастомная фича в правой части панели\n\n## Особенности\n\n- Работает только внутри контекста TableCanvas, потому что дропдаун использует контекст таблицы (`rowSize`, контейнер). Вне таблицы не используется.\n- Размеры задаёт потребитель: `size` для кнопок, `chevronSize` для иконки шеврона, размер своей иконки слева.\n- При компрессии фича уезжает в overflow-дропдаун. Её свёрнутый вид описывается через `details` самой фичи, а не через сам компонент. Например `details: { type: 'select' }` с галочкой активного пункта в `contentLeft` опций.\n\nОписание типов в разделе [SplitIconButton API](?path=/docs/локальные-компоненты-tablecanvas-controlblock-spliticonbutton-api--docs).",
|
|
50126
50247
|
"apiDocs": "# ControlBlock API\n\n## ControlBlockConfig\n\n```typescript\ntype 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\n## ControlBlockButtonProps\n\n```ts\nexport const controlButtonDefaultProps = {\n size: 's',\n view: 'linkDefault',\n} as const;\n```\n\n```typescript\ntype ButtonProps = ComponentProps<typeof Button>;\n```\n\n## FeatureItem (v2.0)\n\nКастомная фича в `tableConfig.controlBlock.customFeatures`. Иконку в панели задают через `Icon` или `CustomIconRender`, поведение в дропдауне — через `details`. Флаги `mandatory` и `canBeCompressedInToolsMenu` ставятся здесь же, на фиче.\n\n```typescript\ntype FeatureItemWithIcon = FeatureDetailsBase & {\n /**\n * Свойства ниже - сохранение старой реализации фичей, до переезда их в sidebar.\n * Используются для отображения фичи в верхнем controlBlock\n */\n value: string;\n label: string;\n onClick: () => void;\n Icon: FC<IconProps>;\n /**\n * Добавляет разделитель слева от элемента\n * @default false\n */\n dividerLeft?: boolean;\n modal?: ReactNode;\n className?: string;\n} & DataAttributes;\n```\n\n## FeatureDetails\n\nПоле `details` у фичи (`customFeatures[].details`). Описывает, как фича выглядит в overflow-дропдауне (троеточие), куда она уезжает при компрессии. Раньше отвечал за правый сайдбар, имя сохранено для обратной совместимости.\n\n```typescript\ntype FeatureDetailsBase = {\n /**\n * Если true, фича будет всегда отображаться в controlBlock и не может быть перенесена в sidebar\n * @default false\n */\n mandatory?: boolean;\n /**\n * Если true, фича может быть сжата в блок ... внутри ToolsMenu\n * @default false\n */\n canBeCompressedInToolsMenu?: boolean;\n /**\n * Дополнительные детали/настройки для фичи для отображения в RightSidebar таблицы\n */\n details?: FeatureDetails;\n};\n```\n\n## FeatureIconRender\n\nТип иконки в `details.icon` (для `details` типа `button` и `select`). Либо готовый узел, либо функция от контекста рендера. Функция нужна, чтобы подстроить размер иконки в дропдауне.\n\n```typescript\ntype FeatureIconRender =\n | ReactNode\n | ((ctx: DropdownRenderCtx) => ReactNode);\n```\n\n## DropdownRenderCtx\n\nКонтекст, который получают кастомные рендеры иконок (`CustomIconRender`, `details.icon` как функция, `dropdownIconRender` у кнопок). По нему потребитель сам подбирает размер иконки.\n\n```typescript\ntype DropdownRenderCtx = {\n /** Текущая высота строк таблицы (big | medium | small) */\n rowSize: SIZE;\n /** true - иконка рисуется в overflow дропдауне, false - в контрл-блоке */\n isInDropdown: boolean;\n};\n```\n\n# SplitIconButton API\n\n## SplitIconButtonProps\n\n```typescript\ntype SplitIconButtonProps = {\n /** Иконка основной (левой) кнопки-действия */\n icon: ReactNode;\n /** Клик по основной кнопке-иконке */\n onIconClick?: () => void;\n /** Tooltip на левой кнопке-иконке (если задан — оборачиваем в TableTooltip). */\n iconTooltip?: ReactNode;\n /**\n * Полная замена иконки шеврона своим узлом. Обычно не нужна — шеврон наш\n * (IconChevronDown), а размер задаётся через chevronSize. Если задан, имеет\n * приоритет над chevronSize.\n */\n chevronIcon?: ReactNode;\n /** Размер нашей иконки-шеврона. Игнорируется, если задан chevronIcon. */\n chevronSize?: 'xs' | 's' | 'm';\n /** Размер обеих кнопок (EmbedIconButton) */\n size?: ComponentProps<typeof EmbedIconButton>['size'];\n /**\n * Пункты дропдауна. Если заданы — кнопка-шеврон открывает TableDropdown.\n * Если не заданы — шеврон работает как обычная кнопка (onChevronClick).\n */\n items?: TableDropdownProps['items'];\n /** Выбор пункта дропдауна */\n onItemSelect?: TableDropdownProps['onItemSelect'];\n /** Клик по шеврону в режиме без дропдауна (items не заданы) */\n onChevronClick?: () => void;\n /** Колбэк открытия/закрытия дропдауна */\n onToggle?: (isOpen: boolean) => void;\n /** Доп. конфиг TableDropdown (placement, listWidth и т.п.) */\n dropdownProps?: TableDropdownConfigProps;\n /** data-атрибуты на контейнер */\n domMetadata?: DataAttributes;\n /** data-атрибуты на основную кнопку */\n iconDomMetadata?: DataAttributes;\n /** data-атрибуты на кнопку-шеврон */\n chevronDomMetadata?: DataAttributes;\n};\n```",
|
|
50127
50248
|
"api": [
|
|
50128
50249
|
{
|
|
@@ -50191,6 +50312,12 @@
|
|
|
50191
50312
|
"type": "full-code",
|
|
50192
50313
|
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui';\nimport { TableTabs } from '@daisforge/ui';\n\n() => {\n const { rows, columnConfig } = useBaseSetup();\n const starFeature = useStarFeature();\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: '60vh' },\n fullScreenEnabled: true,\n rowSize: { default: 'big', showInControl: true },\n searching: { enabled: true },\n collapsing: {\n titleText: 'Реестр задач',\n },\n controlBlock: {\n show: true,\n size: 'm',\n rightSideInner: [\n {\n text: 'Экспорт',\n contentLeft: <IconSb color=\"inherit\" />,\n dropdownIconRender: (ctx) => (\n <IconSb\n color=\"inherit\"\n size={ctx.rowSize === 'small' ? 'xs' : 's'}\n />\n ),\n dropdown: {\n items: [\n { value: 'csv', label: 'CSV' },\n { value: 'xlsx', label: 'Excel' },\n { value: 'pdf', label: 'PDF' },\n ],\n onItemSelect: (item: any) => alert(`Экспорт: ${item.label}`),\n },\n },\n ],\n customFeatures: [starFeature],\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
|
|
50193
50314
|
},
|
|
50315
|
+
{
|
|
50316
|
+
"exportName": "ControlledRowSize",
|
|
50317
|
+
"displayName": "6. Размер строк снаружи (rowSize.state)",
|
|
50318
|
+
"type": "full-code",
|
|
50319
|
+
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui';\nimport { TableTabs } from '@daisforge/ui';\n\n() => {\n const { rows, columnConfig } = useBaseSetup();\n const rowSizeState = useState<SIZE>('medium');\n const [rowSize, setRowSize] = rowSizeState;\n\n return (\n <div>\n <div style={{ maxWidth: 320, marginBottom: 12 }}>\n <Select\n label=\"Размер строк (вне таблицы)\"\n value={rowSize}\n onChange={(value) => setRowSize(value as SIZE)}\n items={ROW_SIZE_OPTIONS}\n />\n </div>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: '60vh' },\n rowSize: { state: rowSizeState, showInControl: true },\n controlBlock: { show: true, size: 'm' },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </div>\n );\n }"
|
|
50320
|
+
},
|
|
50194
50321
|
{
|
|
50195
50322
|
"exportName": "AsCustomFeatures",
|
|
50196
50323
|
"displayName": "SplitIconButton как кастомные фичи ControlBlock",
|
|
@@ -50648,11 +50775,11 @@
|
|
|
50648
50775
|
"legacy": false,
|
|
50649
50776
|
"summary": "*tableConfig.filtering**",
|
|
50650
50777
|
"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)",
|
|
50651
|
-
"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 * Ошибки на уровне строки: служебный столбец с индикатором (иконка с\n * тултипом) и ошибка всей строки. `true` включает столбец с настройками\n * по умолчанию, объект позволяет их задать. Столбец появляется только\n * в режиме правки и исчезает при выходе из него.\n *\n * @see {@link RowErrorsConfig} — полное описание и пример.\n */\n rowErrors?: RowErrorsOption<RowType>;\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 '@daisforge/ui';\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 * mode: 'replace' (по умолчанию) показывает оверлей вместо таблицы,\n * mode: 'cover' — поверх таблицы без её размонтирования.\n */\n loadingOverlay?: LoadingOverlayConfig;\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\nexport type {\n RowErrorsConfig,\n RowErrorsInfo,\n} from '../feature-row-errors/types';\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```",
|
|
50778
|
+
"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 * Ошибки на уровне строки: служебный столбец с индикатором (иконка с\n * тултипом) и ошибка всей строки. `true` включает столбец с настройками\n * по умолчанию, объект позволяет их задать. Столбец появляется только\n * в режиме правки и исчезает при выходе из него.\n *\n * @see {@link RowErrorsConfig} — полное описание и пример.\n */\n rowErrors?: RowErrorsOption<RowType>;\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 * Рамка у каждого диапазона несмежного Ctrl-выбора ячеек (`multi-range-cell`).\n * По умолчанию рамку рисует только активный (последний) диапазон, остальные\n * показываются заливкой. Ограничение: соседние диапазоны дают общую линию на\n * стыке; диапазон, поглощённый более поздним, не обводится.\n * @default false\n */\n outlineEachRange?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — см. `onChange`.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n /**\n * Итоговое выделение после каждого действия пользователя — в том числе\n * несмежный Ctrl-выбор колонок (`columns`) и строк (`rows`), которого нет в\n * `state`. Срабатывает с `state` и без него.\n *\n * Срабатывает и без действия пользователя, когда слева появляется или исчезает\n * служебная колонка (например, столбец ошибок): выделение остаётся на тех же\n * ячейках, а их индексы сдвигаются. Программная смена `state` снаружи\n * `onChange` не вызывает.\n *\n * Индексы колонок — в координатах грида: служебные колонки слева (нумерация\n * `rowMarkers`, чекбоксы `selecting`) входят в счёт. Колонка, `i`-я по порядку\n * на экране, имеет индекс `i` + число служебных колонок.\n */\n onChange?: (selection: GridSelection) => void;\n /**\n * Фокусировать грид, когда выделение с ячейкой приходит снаружи через `state`\n * (иначе glide рисует якорную ячейку как у несфокусированного грида).\n * Выключите, если выделение меняется программно и фокус должен остаться,\n * где был (например, переход по результатам поиска из поля ввода).\n * @default true\n */\n focusOnStateChange?: boolean;\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 - размер высоты строк таблицы: число, функция или `'auto'`.\n * `'auto'` — высота строки по содержимому: ячейка сообщает высоту своего дерева Canvas, когда\n * таблица её рисует (перенос слов в `Canvas.Text wordWrap` растит строку), но не ниже высоты\n * по `rowSize` и не выше `maxAutoRowHeight`. Рисуются только видимые ячейки: строка,\n * показанная впервые, дорастает на следующем кадре, колонка, до которой ещё не прокрутили,\n * высоту не меняет.\n * Высота кешируется по ячейке (объект строки + колонка) при ширине колонки: чтобы перемерить\n * строку после изменения данных, передайте новый объект строки. Смена `rowSize` или темы,\n * загрузка шрифта — перемеряют все ячейки, новый `renderCell` колонки — ячейки этой колонки;\n * до перемера строка держит прежнюю высоту.\n * Ячейки, объединённые на несколько строк, строку не растят.\n * С панелью детализации строки не растут: `'auto'` там равен высоте по `rowSize`.\n */\n rowHeight?: Maybe<number | 'auto' | RowHeightFunc<RowType>>;\n /**\n * Потолок высоты строки при `rowHeight: 'auto'` (в px), по умолчанию 480: содержимое выше\n * обрезается. Смена значения сразу меняет высоты всех измеренных строк, без перемера ячеек.\n * Больше 65534 не бывает (`Infinity` — 65534), нечисловое значение — 480.\n */\n maxAutoRowHeight?: Maybe<number>;\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 * groupHeaderRowHeight - высота каждого уровня объединённых (групповых) заголовков (в px).\n * По умолчанию равна `headerRowHeight`. Нужна, когда нижний ряд шапки выше уровней групп,\n * например при переносе названий колонок на несколько строк.\n */\n groupHeaderRowHeight?: 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 '@daisforge/ui';\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 * Ленивый резолвер блоков: для ячейки строки `row` в колонке `colKey`\n * возвращает первую и последнюю строку её блока (включительно) или null.\n * Вызывается при отрисовке только для видимых ячеек — для больших и ленивых\n * данных, где обход всех строк (mergeByCellValues) дорог. Ответ кешируется\n * до смены отображаемых строк (новые `rows`, сортировка, фильтр), найденный\n * блок — сразу для всех своих строк. Должна быть стабильной функцией.\n * Колонки из mergedCellsRegions, mergeByCellValues и группировки со слиянием\n * берут блоки оттуда.\n *\n * `rowInd` и границы блока — индексы в отображаемых строках: после сортировки,\n * фильтров и группировки они не совпадают с индексами в `rows`. Отображаемые\n * строки приходят в `ctx.rows` — по ним ищут соседей блока.\n */\n lazyRowSpan?: (\n row: RowType,\n colKey: string,\n rowInd: number,\n ctx: {\n /** Отображаемые строки в порядке на экране; `rows[rowInd] === row` */\n rows: readonly RowType[];\n },\n ) => readonly [number, number] | null;\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 * mode: 'replace' (по умолчанию) показывает оверлей вместо таблицы,\n * mode: 'cover' — поверх таблицы без её размонтирования.\n */\n loadingOverlay?: LoadingOverlayConfig;\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 * `colIndex` — в координатах грида: служебные колонки слева (нумерация, чекбоксы)\n * входят в счёт; колонку надёжнее брать из `info.column`.\n */\n onCellClicked?: (\n cell: readonly [number, number],\n info: TableInfoWithRow<RowType, SummaryRowType>,\n /** Событие клика glide: позиция в ячейке, модификаторы, кнопка */\n event: CellClickedEventArgs,\n ) => void;\n /**\n * Клик по заголовку группы колонок.\n *\n * `info` — группа из columnConfig: `key` и `children` (вложенные колонки и\n * подгруппы). `colIndex` — колонка под курсором в координатах грида: служебные\n * колонки слева (нумерация, чекбоксы) входят в счёт.\n */\n onGroupHeaderClicked?: GroupHeaderHandler<RowType, SummaryRowType>;\n /** Правый клик по заголовку группы колонок. Аргументы — как у onGroupHeaderClicked. */\n onGroupHeaderContextMenu?: GroupHeaderHandler<RowType, SummaryRowType>;\n} & GlideInstanceOmitted<RowType, SummaryRowType>;\n\n/** Группа шапки из columnConfig, по которой кликнули */\nexport type GroupHeaderInfo<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n> = {\n /** Ключ группы (ColumnGroupConfig.key) */\n key: string;\n /** Вложенные колонки и подгруппы группы */\n children: readonly ColumnOrColumnGroupConfig<RowType, SummaryRowType>[];\n};\n\nexport type GroupHeaderHandler<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n> = (\n colIndex: number,\n info: GroupHeaderInfo<RowType, SummaryRowType>,\n /** Событие клика glide: позиция, модификаторы, кнопка; `event.group` — ключ группы */\n event: GroupHeaderClickedEventArgs,\n) => void;\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 и onGroupHeader* объявлены в TableConfig явно — с info и событием\n // | 'CellReadOnlyEditor'\n // Сигнатуры glide: индекс колонки — в координатах грида (сервисные колонки включены)\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\nexport type {\n RowErrorsConfig,\n RowErrorsInfo,\n} from '../feature-row-errors/types';\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```",
|
|
50652
50779
|
"api": [
|
|
50653
50780
|
{
|
|
50654
50781
|
"typeName": "FilteringConfig",
|
|
50655
|
-
"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 * Ошибки на уровне строки: служебный столбец с индикатором (иконка с\n * тултипом) и ошибка всей строки. `true` включает столбец с настройками\n * по умолчанию, объект позволяет их задать. Столбец появляется только\n * в режиме правки и исчезает при выходе из него.\n *\n * @see {@link RowErrorsConfig} — полное описание и пример.\n */\n rowErrors?: RowErrorsOption<RowType>;\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 *"
|
|
50782
|
+
"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 * Ошибки на уровне строки: служебный столбец с индикатором (иконка с\n * тултипом) и ошибка всей строки. `true` включает столбец с настройками\n * по умолчанию, объект позволяет их задать. Столбец появляется только\n * в режиме правки и исчезает при выходе из него.\n *\n * @see {@link RowErrorsConfig} — полное описание и пример.\n */\n rowErrors?: RowErrorsOption<RowType>;\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 * Рамка у каждого диапазона несмежного Ctrl-выбора ячеек (`multi-range-cell`).\n * По умолчанию рамку рисует только активный (последний) диапазон, остальные\n * показываются заливкой. Ограничение: соседние диапазоны дают общую линию на\n * стыке; диапазон, поглощённый более поздним, не обводится.\n * @default false\n */\n outlineEachRange?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — см. `onChange`.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n /**\n * Итоговое выделение после каждого действия пользователя — в том числе\n * несмежный Ctrl-выбор колонок (`columns`) и строк (`rows`), которого нет в\n * `state`. Срабатывает с `state` и без него.\n *\n * Срабатывает и без действия пользователя, когда слева появляется или исчезает\n * служебная колонка (например, столбец ошибок): выделение остаётся на тех же\n * ячейках, а их индексы сдвигаются. Программная смена `state` снаружи\n * `onChange` не вызывает.\n *\n * Индексы колонок — в координатах грида: служебные колонки слева (нумерация\n * `rowMarkers`, чекбоксы `selecting`) входят в счёт. Колонка, `i`-я по порядку\n * на экране, имеет индекс `i` + число служебных колонок.\n */\n onChange?: (selection: GridSelection) => void;\n /**\n * Фокусировать грид, когда выделение с ячейкой приходит снаружи через `state`\n * (иначе glide рисует якорную ячейку как у несфокусированного грида).\n * Выключите, если выделение меняется программно и фокус должен остаться,\n * где был (например, переход по результатам поиска из поля ввода).\n * @default true\n */\n focusOnStateChange?: boolean;\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 - размер высоты строк таблицы: число, функция или `'auto'`.\n * `'auto'` — высота строки по содержимому: ячейка сообщает высоту своего дерева Canvas, когда\n * таблица её рисует (перенос слов в `Canvas.Text wordWrap` растит строку), но не ниже высоты\n * по `rowSize` и не выше `maxAutoRowHeight`. Рисуются только видимые ячейки: строка,\n * показанная впервые, дорастает на следующем кадре, колонка, до которой ещё не прокрутили,\n * высоту не меняет.\n * Высота кешируется по ячейке (объект строки + колонка) при ширине колонки: чтобы перемерить\n * строку после изменения данных, передайте новый объект строки. Смена `rowSize` или темы,\n * загрузка шрифта — перемеряют все ячейки, новый `renderCell` колонки — ячейки этой колонки;\n * до перемера строка держит прежнюю высоту.\n * Ячейки, объединённые на несколько строк, строку не растят.\n * С панелью детализации строки не растут: `'auto'` там равен высоте по `rowSize`.\n */\n rowHeight?: Maybe<number | 'auto' | RowHeightFunc<RowType>>;\n /**\n * Потолок высоты строки при `rowHeight: 'auto'` (в px), по умолчанию 480: содержимое выше\n * обрезается. Смена значения сразу меняет высоты всех измеренных строк, без перемера ячеек.\n * Больше 65534 не бывает (`Infinity` — 65534), нечисловое значение — 480.\n */\n maxAutoRowHeight?: Maybe<number>;\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 * groupHeaderRowHeight - высота каждого уровня объединённых (групповых) заголовков (в px).\n * По умолчанию равна `headerRowHeight`. Нужна, когда нижний ряд шапки выше уровней групп,\n * например при переносе названий колонок на несколько строк.\n */\n groupHeaderRowHeight?: 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 *"
|
|
50656
50783
|
},
|
|
50657
50784
|
{
|
|
50658
50785
|
"typeName": "FilterComponentInPopoverProps",
|
|
@@ -50679,7 +50806,7 @@
|
|
|
50679
50806
|
"feature": "FormatCellContent",
|
|
50680
50807
|
"legacy": false,
|
|
50681
50808
|
"summary": "*columnConfig.contentFormat**",
|
|
50682
|
-
"docs": "# FormatCellContent (TableCanvas)\n\n**columnConfig.contentFormat**\n\nПараметр `contentFormat` позволяет гибко настраивать отображение данных в ячейках таблицы. Поддерживается как на уровне колонки, так и для subRow (дочерних строк).\n\n## Ключевые особенности\n\n- Числовое форматирование с настройкой разделителей, локали, дробной части\n- Кастомное форматирование через `customFormat`\n- Выравнивание содержимого (`alignContent`)
|
|
50809
|
+
"docs": "# FormatCellContent (TableCanvas)\n\n**columnConfig.contentFormat**\n\nПараметр `contentFormat` позволяет гибко настраивать отображение данных в ячейках таблицы. Поддерживается как на уровне колонки, так и для subRow (дочерних строк).\n\n## Ключевые особенности\n\n- Числовое форматирование с настройкой разделителей, локали, дробной части\n- Кастомное форматирование через `customFormat`\n- Выравнивание содержимого (`alignContent`: `'left' | 'center' | 'right'`); только выравнивание, без форматирования — `contentFormat: { alignContent: 'center' }`\n- Приоритет формата: `subRow.contentFormat` → родительский `contentFormat` → `column.contentFormat`\n\n## Особенности\n\n- Если используется `renderCell` или `renderSubRowCell`, кастомное форматирование не применяется\n- При редактировании с `component: inputNumber` параметры сепараторов и min/max дробной части берутся из `contentFormat`\n\n> Подробнее о типах и пропсах — [FormatCellContent API](?path=/docs/локальные-компоненты-tablecanvas-formatcellcontent-api--docs)",
|
|
50683
50810
|
"apiDocs": "# FormatCellContent API\n\n## ContentFormat\n\n```typescript\ntype ContentFormat =\n | 'number' // Стандартное числовое форматирование с локалью ru-RU (разделитель тысяч: пробел, дробная часть: запятая)\n | CustomFormat\n | NumberFormatOptions;\n```",
|
|
50684
50811
|
"api": [
|
|
50685
50812
|
{
|
|
@@ -50693,6 +50820,12 @@
|
|
|
50693
50820
|
"displayName": "Форматирование ячеек",
|
|
50694
50821
|
"type": "full-code",
|
|
50695
50822
|
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(() => createRowsTree());\n\n const columns = useMemo<readonly ColumnConfig<TreeRow>[]>(\n () => [\n {\n key: 'block',\n name: 'Блок / Трайб / Продукт',\n contentFormat: {\n customFormat: (val) => `📝 ${val}`,\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 isColumnWithArrow: true,\n hideHeaderExpandAllArrow: false,\n },\n resizable: true,\n },\n {\n key: 'blockActivity',\n name: 'Активность блока',\n title: '123',\n contentFormat: {\n customFormat: (val) => `${val}!`,\n },\n },\n {\n key: '',\n minWidth: 170,\n name: 'Локация трайба',\n subRow: {\n renderSubRowCell: (props, lvl) => {\n if (lvl === 1) {\n return props.row?.tribeZone;\n }\n return null;\n },\n },\n },\n {\n key: 'q1',\n name: 'Q1',\n contentFormat: 'number',\n subRow: {\n parentKeyAsDefault: true,\n /* Форматирование в подстроках */\n contentFormat: {\n customFormat: (val) => `${val}%`,\n },\n },\n },\n\n {\n key: 'q2',\n name: 'Q2',\n contentFormat: {\n type: 'number',\n minimumFractionDigits: 1,\n maximumFractionDigits: 3,\n decimalSeparator: '.',\n thousandSeparator: '_',\n alignContent: 'center',\n },\n subRow: {\n keyOfColumnInSubRow: 'q1',\n contentFormat: {\n type: 'number',\n minimumFractionDigits: 1,\n maximumFractionDigits: 3,\n decimalSeparator: ',',\n thousandSeparator: '.',\n alignContent: 'right',\n },\n },\n },\n {\n key: 'q3',\n name: 'Q3',\n contentFormat: {\n type: 'number',\n minimumFractionDigits: 2,\n locales: ['en-US', 'fr-FR', 'ru-RU'],\n },\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q4',\n name: 'Q4',\n contentFormat: 'number',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\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 }"
|
|
50823
|
+
},
|
|
50824
|
+
{
|
|
50825
|
+
"exportName": "ContentAlign",
|
|
50826
|
+
"displayName": "Выравнивание колонки (alignContent)",
|
|
50827
|
+
"type": "full-code",
|
|
50828
|
+
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(() => createRows(1, 30));\n\n const columns = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n { key: 'issueType', name: 'Текст', width: 140 },\n {\n key: 'priority',\n name: 'Текст, center',\n width: 120,\n contentFormat: { alignContent: 'center' },\n },\n {\n key: 'complete',\n name: 'Число',\n width: 120,\n contentFormat: 'number',\n },\n {\n key: 'inspiredDay',\n name: 'Число, left',\n width: 120,\n contentFormat: { type: 'number', alignContent: 'left' },\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\n tableConfig={{ containerStyle: { height: '500px' } }}\n columnConfig={columns}\n rows={rows}\n />\n );\n }"
|
|
50696
50829
|
}
|
|
50697
50830
|
]
|
|
50698
50831
|
},
|
|
@@ -50833,7 +50966,7 @@
|
|
|
50833
50966
|
"feature": "HeaderRowHeight",
|
|
50834
50967
|
"legacy": false,
|
|
50835
50968
|
"summary": "*tableConfig.headerRowHeight**",
|
|
50836
|
-
"docs": "# HeaderRowHeight (TableCanvas)\n\n**tableConfig.headerRowHeight**\n\nНастройка высоты ряда шапки таблицы. Одно число задаёт высоту заголовков. По умолчанию `33`.\n\n## Ключевые особенности\n\n- Фиксированная высота ряда шапки (`number`)\n- Значение задаётся один раз в `tableConfig`\n- Применяется ко всем уровням объединённой (групповой) шапки
|
|
50969
|
+
"docs": "# HeaderRowHeight (TableCanvas)\n\n**tableConfig.headerRowHeight**\n\nНастройка высоты ряда шапки таблицы. Одно число задаёт высоту заголовков. По умолчанию `33`.\n\n## Ключевые особенности\n\n- Фиксированная высота ряда шапки (`number`)\n- Значение задаётся один раз в `tableConfig`\n- Применяется ко всем уровням объединённой (групповой) шапки одинаково; свою высоту уровням групп задаёт `groupHeaderRowHeight`\n\n## tableConfig.headerRowHeight\n\n- **`number`** — высота одного ряда шапки в пикселях\n- **по умолчанию** — `33`\n\n## Поведение с объединёнными шапками\n\nБез `groupHeaderRowHeight` значение применяется к **каждому** уровню шапки: и к листовому (нижнему) ряду\nколонок, и к каждому уровню объединённых заголовков. Поэтому при `N` уровнях\nгруппировки итоговая высота шапки считается так:\n\n```\nитоговая высота = headerRowHeight * (1 + число уровней групп)\n```\n\n## tableConfig.groupHeaderRowHeight\n\nВысота **каждого уровня** объединённых (групповых) заголовков. По умолчанию равна\n`headerRowHeight`. Нужна, когда нижний ряд шапки выше уровней групп, например при\nпереносе названий колонок на несколько строк:\n\n```\nитоговая высота = headerRowHeight + groupHeaderRowHeight * число уровней групп\n```\n\n> Подробнее о пропсах — [API tableConfig](?path=/docs/локальные-компоненты-tablecanvas-api-tableconfig--api)",
|
|
50837
50970
|
"apiDocs": "",
|
|
50838
50971
|
"api": [],
|
|
50839
50972
|
"stories": [
|
|
@@ -50842,6 +50975,12 @@
|
|
|
50842
50975
|
"displayName": "Высота шапки (3 уровня)",
|
|
50843
50976
|
"type": "full-code",
|
|
50844
50977
|
"code": "import {\n ColumnOrColumnGroupConfig,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [headerRowHeight, setHeaderRowHeight] = useState<number>(33);\n\n // 2 уровня групп + листовой ряд => всего 3 уровня.\n const levels = 3;\n const total = useMemo(() => headerRowHeight * levels, [headerRowHeight]);\n\n return (\n <div>\n <div\n style={{\n display: 'flex',\n alignItems: 'center',\n gap: 16,\n marginBottom: 16,\n maxWidth: 520,\n }}\n >\n <div style={{ flex: 1 }}>\n <Slider\n value={headerRowHeight}\n onChange={setHeaderRowHeight}\n min={24}\n max={96}\n step={1}\n />\n </div>\n <span style={{ whiteSpace: 'nowrap' }}>\n headerRowHeight: {headerRowHeight}px\n </span>\n <span style={{ whiteSpace: 'nowrap', opacity: 0.7 }}>\n итог: {headerRowHeight} × {levels} = {total}px\n </span>\n </div>\n <TableCanvas\n tableConfig={{ containerStyle: { height: 420 }, headerRowHeight }}\n columnConfig={threeLevelColumns}\n rows={rows}\n />\n </div>\n );\n }"
|
|
50978
|
+
},
|
|
50979
|
+
{
|
|
50980
|
+
"exportName": "GroupHeaderRowHeight",
|
|
50981
|
+
"displayName": "Своя высота групповых заголовков (groupHeaderRowHeight)",
|
|
50982
|
+
"type": "full-code",
|
|
50983
|
+
"code": "import {\n ColumnOrColumnGroupConfig,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [headerRowHeight, setHeaderRowHeight] = useState<number>(56);\n const [groupHeaderRowHeight, setGroupHeaderRowHeight] =\n useState<number>(28);\n\n // 2 уровня групп над листовым рядом.\n const groupLevels = 2;\n const total = headerRowHeight + groupHeaderRowHeight * groupLevels;\n\n return (\n <div>\n <div style={{ maxWidth: 360, marginBottom: 16 }}>\n <div>headerRowHeight (листовой ряд): {headerRowHeight}px</div>\n <Slider\n value={headerRowHeight}\n onChange={setHeaderRowHeight}\n min={24}\n max={96}\n step={1}\n />\n <div style={{ marginTop: 12 }}>\n groupHeaderRowHeight (каждый уровень групп): {groupHeaderRowHeight}\n px\n </div>\n <Slider\n value={groupHeaderRowHeight}\n onChange={setGroupHeaderRowHeight}\n min={20}\n max={96}\n step={1}\n />\n </div>\n <p style={{ opacity: 0.7, marginBottom: 12 }}>\n итог: {headerRowHeight} + {groupHeaderRowHeight} × {groupLevels} ={' '}\n {total}px\n </p>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 420 },\n headerRowHeight,\n groupHeaderRowHeight,\n }}\n columnConfig={threeLevelColumns}\n rows={rows}\n />\n </div>\n );\n }"
|
|
50845
50984
|
}
|
|
50846
50985
|
]
|
|
50847
50986
|
},
|
|
@@ -51082,12 +51221,12 @@
|
|
|
51082
51221
|
"feature": "RowHeight",
|
|
51083
51222
|
"legacy": false,
|
|
51084
51223
|
"summary": "*tableConfig.rowHeight + tableConfig.rowSize**",
|
|
51085
|
-
"docs": "# RowHeight (TableCanvas)\n\n**tableConfig.rowHeight + tableConfig.rowSize**\n\nНастройка высоты строк таблицы. Поддерживает фиксированную высоту, динамическое вычисление и переключение размера через UI.\n\n## Ключевые особенности\n\n- Фиксированная высота строки (`number`)\n- Динамическая высота через функцию (`RowHeightFunc`)\n- Доступ к данным строки и текущему размеру (`currentRowSize`)\n- Переключатель размера строк в controlBlock (`rowSize`)\n\n## tableConfig.rowHeight\n\nОпределяет высоту каждой строки:\n\n- **`number`** — фиксированная высота в пикселях для всех строк\n- **`RowHeightFunc`** — функция, вычисляющая высоту на основе `row`, `currentRowSize` и `rowIndex`\n\n## tableConfig.rowSize\n\nПереключатель размера строк в controlBlock (кнопка с выпадающим списком):\n\n- **`showInControl`** — показывать ли кнопку в controlBlock\n- **`default`** — размер по умолчанию (`'s'`, `'m'`, `'l'`)\n- **`available`** — список доступных размеров\n- **`onRowSizeChange`** — callback при смене размера\n\n## Особенности\n\n- `RowHeightFunc` получает `currentRowSize` — объект с `rowSizeName` и `rowSizeValue`, что позволяет адаптировать высоту к текущему выбранному размеру\n- При использовании `rowHeight` как функции, рекомендуется мемоизировать её для производительности\n\n> Подробнее о типах и пропсах — [RowHeight API](?path=/docs/локальные-компоненты-tablecanvas-rowheight-api--docs)",
|
|
51086
|
-
"apiDocs": "# RowHeight API\n\n## RowSize\n\n```typescript\ntype RowSize = {\n /**\n * Показывать кнопку в блоке управления\n */\n showInControl: boolean;\n /**\n * Значение по умолчанию\n */\n default?: SIZE;\n /**\n * Список доступных значений размера\n */\n available?: SIZE[];\n /**\n * Обработчик изменения rowSize\n * @param size\n * @returns\n */\n onRowSizeChange?: (size: SIZE) => void;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n```\n\n## RowHeightFunc\n\n```typescript\ntype RowHeightFunc<RowType> = (\n row: RowType,\n currentRowSize: { rowSizeName: SIZE; rowSizeValue: number },\n rowIndex: number,\n) => number;\n```",
|
|
51224
|
+
"docs": "# RowHeight (TableCanvas)\n\n**tableConfig.rowHeight + tableConfig.rowSize**\n\nНастройка высоты строк таблицы. Поддерживает фиксированную высоту, динамическое вычисление и переключение размера через UI.\n\n## Ключевые особенности\n\n- Фиксированная высота строки (`number`)\n- Динамическая высота через функцию (`RowHeightFunc`)\n- Высота по содержимому ячеек (`'auto'`): перенос текста растит строку\n- Доступ к данным строки и текущему размеру (`currentRowSize`)\n- Переключатель размера строк в controlBlock (`rowSize`)\n\n## tableConfig.rowHeight\n\nОпределяет высоту каждой строки:\n\n- **`number`** — фиксированная высота в пикселях для всех строк\n- **`RowHeightFunc`** — функция, вычисляющая высоту на основе `row`, `currentRowSize` и `rowIndex`\n- **`'auto'`** — высота по содержимому (см. ниже)\n\n## rowHeight: 'auto'\n\nЯчейка сообщает высоту своего дерева Canvas, когда таблица её рисует (`Canvas.Text wordWrap` переносит слова и растит строку). Отдельного замера нет: рисуются и меряются только видимые ячейки. Вертикальные отступы ячейки (`cellVerticalPadding` темы) ui-kit добавляет к высоте строки, в дереве ячейки их задавать не нужно. Содержимое центрируйте по вертикали (`alignItems=\"center\"`): у выровненного по верху весь запас окажется снизу. Подсветку фрагментов текста с переносом по строкам делает [`Canvas.Mark`](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvasmark--docs) внутри `Canvas.Text`.\n\n- Высота не ниже высоты по `rowSize` и не выше `tableConfig.maxAutoRowHeight` (по умолчанию **480px**, не больше 65534): более длинный текст обрезается. Новое значение сразу применяется ко всем измеренным строкам\n\n```tsx\n<TableCanvas tableConfig={{ rowHeight: 'auto', maxAutoRowHeight: 800 }} columnConfig={columnConfig} rows={rows} />\n```\n\n- Строка, показанная впервые, сразу появляется с высотой по содержимому. Колонка, до которой ещё не прокрутили, высоту строки не меняет — строка дорастёт, когда колонка появится на экране\n- Высота кешируется по ячейке (объект строки + колонка): ресайз и новый `renderCell` перемеряют только ячейки этой колонки, смена `rowSize` или темы и загрузка любого шрифта (в том числе заданного у `Canvas.Text`) — все. До перемера строка держит прежнюю высоту. Чтобы перемерить строку после изменения содержимого, передайте новый объект строки\n- Ячейка, объединённая на несколько строк (`mergeCells`), строку не растит; объединённая на несколько колонок меряется по ширине блока\n- С панелью детализации строки не растут: `'auto'` там равен высоте по `rowSize`\n\n## tableConfig.rowSize\n\nПереключатель размера строк в controlBlock (кнопка с выпадающим списком):\n\n- **`showInControl`** — показывать ли кнопку в controlBlock\n- **`default`** — размер по умолчанию (`'s'`, `'m'`, `'l'`)\n- **`available`** — список доступных размеров\n- **`onRowSizeChange`** — callback при смене размера\n\n## Особенности\n\n- `RowHeightFunc` получает `currentRowSize` — объект с `rowSizeName` и `rowSizeValue`, что позволяет адаптировать высоту к текущему выбранному размеру\n- При использовании `rowHeight` как функции, рекомендуется мемоизировать её для производительности\n\n> Подробнее о типах и пропсах — [RowHeight API](?path=/docs/локальные-компоненты-tablecanvas-rowheight-api--docs)",
|
|
51225
|
+
"apiDocs": "# RowHeight API\n\n## RowSize\n\n```typescript\ntype RowSize = {\n /**\n * Показывать кнопку в блоке управления\n */\n showInControl: boolean;\n /**\n * Контролируемый размер строк: таблица читает размер из state и меняет его через setter\n * (кнопка в блоке управления тоже). Без state размер хранится внутри таблицы, начальное значение - default.\n */\n state?: [SIZE, React.Dispatch<React.SetStateAction<SIZE>>];\n /**\n * Значение по умолчанию\n */\n default?: SIZE;\n /**\n * Список доступных значений размера\n */\n available?: SIZE[];\n /**\n * Обработчик изменения rowSize\n * @param size\n * @returns\n */\n onRowSizeChange?: (size: SIZE) => void;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n```\n\n## RowHeightFunc\n\n```typescript\ntype RowHeightFunc<RowType> = (\n row: RowType,\n currentRowSize: { rowSizeName: SIZE; rowSizeValue: number },\n rowIndex: number,\n) => number;\n```",
|
|
51087
51226
|
"api": [
|
|
51088
51227
|
{
|
|
51089
51228
|
"typeName": "RowSize",
|
|
51090
|
-
"source": "type RowSize = {\n /**\n * Показывать кнопку в блоке управления\n */\n showInControl: boolean;\n /**\n * Значение по умолчанию\n */\n default?: SIZE;\n /**\n * Список доступных значений размера\n */\n available?: SIZE[];\n /**\n * Обработчик изменения rowSize\n * @param size\n * @returns\n */\n onRowSizeChange?: (size: SIZE) => void;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};"
|
|
51229
|
+
"source": "type RowSize = {\n /**\n * Показывать кнопку в блоке управления\n */\n showInControl: boolean;\n /**\n * Контролируемый размер строк: таблица читает размер из state и меняет его через setter\n * (кнопка в блоке управления тоже). Без state размер хранится внутри таблицы, начальное значение - default.\n */\n state?: [SIZE, React.Dispatch<React.SetStateAction<SIZE>>];\n /**\n * Значение по умолчанию\n */\n default?: SIZE;\n /**\n * Список доступных значений размера\n */\n available?: SIZE[];\n /**\n * Обработчик изменения rowSize\n * @param size\n * @returns\n */\n onRowSizeChange?: (size: SIZE) => void;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};"
|
|
51091
51230
|
},
|
|
51092
51231
|
{
|
|
51093
51232
|
"typeName": "RowHeightFunc",
|
|
@@ -51100,6 +51239,30 @@
|
|
|
51100
51239
|
"displayName": "Row height",
|
|
51101
51240
|
"type": "full-code",
|
|
51102
51241
|
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/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 },\n {\n key: 'task',\n name: 'Title',\n },\n {\n key: 'priority',\n name: 'Priority',\n },\n {\n key: 'loremIpsum',\n name: 'Длинный текст',\n width: 500,\n renderCell: ({ row, theme }) => (\n <Canvas.Container padding={8}>\n <Canvas.Container>\n <Canvas.Text\n font={theme.baseFontStyle}\n lineHeight={1.85}\n wordWrap\n >\n {row.loremIpsum}\n </Canvas.Text>\n </Canvas.Container>\n </Canvas.Container>\n ),\n },\n {\n key: 'complete',\n name: '% Complete',\n },\n ],\n [],\n );\n\n const rowHeight: RowHeightFunc<Row> = useCallback((r, currenRowSize) => {\n const symbolWidth = 11.5;\n\n const paddingInline = 16;\n const widthOfLoremCol = 500 - paddingInline * 2;\n const symbolsInOneLine = Math.round(widthOfLoremCol / symbolWidth);\n const heightOfLineInitial = 22; // в css\n const heightOfLine = heightOfLineInitial - 2; // скорректированный\n\n const allSymbols = r.loremIpsum.length;\n\n const countOfLine = Math.ceil(allSymbols / symbolsInOneLine);\n const paddingBlock = Number(\n SIZES[currenRowSize.rowSizeName].cell['padding-block'].slice(0, -2),\n );\n\n const neededHeight = heightOfLine * countOfLine + paddingBlock * 2;\n\n return neededHeight > currenRowSize.rowSizeValue\n ? neededHeight\n : currenRowSize.rowSizeValue;\n }, []);\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 700 },\n rowHeight,\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
|
|
51242
|
+
},
|
|
51243
|
+
{
|
|
51244
|
+
"exportName": "AutoRowHeight",
|
|
51245
|
+
"displayName": "Auto row height (перенос текста)",
|
|
51246
|
+
"type": "full-code",
|
|
51247
|
+
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n { key: 'id', name: 'id' },\n { key: 'task', name: 'Title' },\n {\n key: 'loremIpsum',\n name: 'Длинный текст',\n width: 360,\n renderCell: ({ row, theme }) => (\n <Canvas.Container\n alignItems=\"center\"\n padding={{ left: 8, right: 8 }}\n >\n <Canvas.Text font={theme.baseFontStyle} wordWrap>\n {row.loremIpsum}\n </Canvas.Text>\n </Canvas.Container>\n ),\n },\n {\n key: 'short',\n name: 'Без переноса',\n width: 160,\n renderCell: ({ row }) => row.task,\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 700 },\n rowHeight: 'auto',\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
|
|
51248
|
+
},
|
|
51249
|
+
{
|
|
51250
|
+
"exportName": "FlexLayoutCell",
|
|
51251
|
+
"displayName": "Вёрстка ячейки на flex (кнопки, бейджи, перенос, wrap)",
|
|
51252
|
+
"type": "full-code",
|
|
51253
|
+
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(createTaskRows);\n\n const columnConfig = useMemo<readonly ColumnConfig<TaskRow>[]>(\n () => [\n { key: 'id', name: '#', width: 56 },\n {\n key: 'title',\n name: 'Задача',\n width: 480,\n renderCell: ({ row, theme }) => (\n <Canvas.Container\n direction=\"column\"\n justifyContent=\"center\"\n gap={6}\n padding={{ left: 8, right: 8 }}\n style={{ width: '100%' }}\n >\n <Canvas.Container\n direction=\"row\"\n alignItems=\"center\"\n gap={8}\n style={{ width: '100%' }}\n >\n <Canvas.Text\n font={theme.baseFontStyle}\n wordWrap\n style={{ flexGrow: 1, flexShrink: 1 }}\n >\n {row.title}\n </Canvas.Text>\n <Canvas.Badge\n text={row.status}\n view={STATUS_VIEW[row.status]}\n size=\"s\"\n style={{ flexShrink: 0 }}\n />\n </Canvas.Container>\n <Canvas.Text\n font={theme.baseFontStyle}\n color={theme.textLight}\n wordWrap\n >\n {row.description}\n </Canvas.Text>\n <Canvas.Container\n direction=\"row\"\n alignItems=\"center\"\n gap={8}\n style={{ width: '100%' }}\n >\n <Canvas.Container\n wrap=\"wrap\"\n gap={6}\n style={{ flexGrow: 1, flexShrink: 1 }}\n >\n {row.tags.map((tag) => (\n <Canvas.Badge key={tag} text={tag} view=\"light\" size=\"xs\" />\n ))}\n </Canvas.Container>\n <Canvas.Button\n view=\"accent\"\n size=\"xs\"\n style={{ flexShrink: 0 }}\n // eslint-disable-next-line no-console\n onClick={() => console.debug('open', row.id)}\n >\n Открыть\n </Canvas.Button>\n <Canvas.Button\n view=\"secondary\"\n size=\"xs\"\n style={{ flexShrink: 0 }}\n // eslint-disable-next-line no-console\n onClick={() => console.debug('assign', row.id)}\n >\n Назначить\n </Canvas.Button>\n </Canvas.Container>\n </Canvas.Container>\n ),\n },\n {\n key: 'status',\n name: 'Статус',\n width: 120,\n renderCell: ({ row }) => row.status,\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 700 },\n rowHeight: 'auto',\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
|
|
51254
|
+
},
|
|
51255
|
+
{
|
|
51256
|
+
"exportName": "AutoRowHeightWideTable",
|
|
51257
|
+
"displayName": "Auto row height: широкая таблица (120 показателей)",
|
|
51258
|
+
"type": "full-code",
|
|
51259
|
+
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(createReportRows);\n\n const columnConfig = useMemo<readonly ColumnConfig<ReportRow>[]>(\n () => [\n {\n key: 'direction',\n name: 'Направление',\n width: 220,\n renderCell: wrappedText('direction'),\n },\n {\n key: 'division',\n name: 'Подразделение',\n width: 200,\n renderCell: wrappedText('division'),\n },\n ...Array.from(\n { length: REPORT_METRICS },\n (_, index): ColumnConfig<ReportRow> => ({\n key: `metric${index}`,\n name: `Показатель ${index + 1}`,\n width: 120,\n renderCell: ({ row }) => (\n <Canvas.Container\n alignItems=\"center\"\n justifyContent=\"flex-end\"\n padding={{ left: 8, right: 8 }}\n >\n <Canvas.Text>\n {row.values[index]!.toLocaleString('ru-RU')}\n </Canvas.Text>\n </Canvas.Container>\n ),\n }),\n ),\n // Колонка с переносом в конце таблицы: строки дорастут, когда до неё прокрутят\n {\n key: 'comment',\n name: 'Комментарий',\n width: 240,\n renderCell: wrappedText('comment'),\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 700 },\n rowHeight: 'auto',\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
|
|
51260
|
+
},
|
|
51261
|
+
{
|
|
51262
|
+
"exportName": "AutoRowHeightHuge",
|
|
51263
|
+
"displayName": "Auto row height: 1 000 000 строк × 1000 колонок",
|
|
51264
|
+
"type": "full-code",
|
|
51265
|
+
"code": "// Строка — только id, значения ячеек считаются при отрисовке\nconst rows = Array.from({ length: 1_000_000 }, (_, index) => ({ id: index + 1 }));\n\nconst columnConfig = [\n { key: 'id', name: '№', width: 100 },\n ...Array.from({ length: 999 }, (_, index) => ({\n key: \\"
|
|
51103
51266
|
}
|
|
51104
51267
|
]
|
|
51105
51268
|
},
|
|
@@ -51320,8 +51483,8 @@
|
|
|
51320
51483
|
"feature": "CellsSelection",
|
|
51321
51484
|
"legacy": false,
|
|
51322
51485
|
"summary": "Выделение в таблице задаётся пропом **`tableConfig.cellsSelection.mode`** — это",
|
|
51323
|
-
"docs": "# CellsSelection\n\nВыделение в таблице задаётся пропом **`tableConfig.cellsSelection.mode`** — это\nфактическое нативное выделение ячеек. По нему работают copy/paste, рамка\nвыделения, fill-handle и затемнение шапки/нумерации.\n\n> Это **отдельная ось** от `highlightActiveType` (визуальная подсветка строки) и\n> от `selecting` (выбор строк чекбоксами).\n\n## Значения cellsSelection.mode\n\n- `'range-cell'` — выделение диапазона ячеек (по умолчанию). Тянем мышкой.\n- `'multi-range-cell'` — как `range-cell`, но **Ctrl/Cmd** докидывает несколько\n диапазонов (см. ниже).\n- `'cell'` — выделение одной ячейки.\n- `'disabled'` — выделение ячеек отключено.\n\n## Мультивыбор диапазонов (multi-range-cell)\n\nПри `cellsSelection: { mode: 'multi-range-cell' }` можно выделить несколько прямоугольных\nдиапазонов: тянем мышкой первый, затем **Ctrl/Cmd + клик/драг** докидываем\nостальные. Заливка
|
|
51324
|
-
"apiDocs": "# CellsSelection API\n\n## CellsSelectionMode\n\nРежим фактического (нативного) выделения ячеек — `tableConfig.cellsSelection.mode`.\n\n```typescript\ntype CellsSelectionMode =\n | 'cell'\n | 'range-cell'\n | 'multi-range-cell'\n | 'disabled';\n```\n\n## Controlled-режим\n\n`tableConfig.cellsSelection.state` — внешний (controlled) контроль нативного выделения,\n`state`-кортеж `[GridSelection, setter]`:\n\n```ts\ncellsSelection?: {\n state?: [\n GridSelection,\n React.Dispatch<React.SetStateAction<GridSelection>>\n ];\n};\n```\n\n- Сброс: `setter({ current: undefined, rows: CompactSelection.empty(), columns: CompactSelection.empty() })`.\n- Контролирует нативное выделение (ячейки/диапазон/смежные строки и колонки).\n Несмежный Ctrl-выбор колонок/строк — внутренний.\n- `CompactSelection` (значение) и `GridSelection` (тип) реэкспортируются из\n `@daisforge/ui/components/TableCanvas`.\n\n## CellsSelectionConfig\n\nКонфиг выделения колонок (`tableConfig.cellsSelection`).\n\n```typescript\ntype 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) сюда не входит —
|
|
51486
|
+
"docs": "# CellsSelection\n\nВыделение в таблице задаётся пропом **`tableConfig.cellsSelection.mode`** — это\nфактическое нативное выделение ячеек. По нему работают copy/paste, рамка\nвыделения, fill-handle и затемнение шапки/нумерации.\n\n> Это **отдельная ось** от `highlightActiveType` (визуальная подсветка строки) и\n> от `selecting` (выбор строк чекбоксами).\n\n## Значения cellsSelection.mode\n\n- `'range-cell'` — выделение диапазона ячеек (по умолчанию). Тянем мышкой.\n- `'multi-range-cell'` — как `range-cell`, но **Ctrl/Cmd** докидывает несколько\n диапазонов (см. ниже).\n- `'cell'` — выделение одной ячейки.\n- `'disabled'` — выделение ячеек отключено.\n\n## Мультивыбор диапазонов (multi-range-cell)\n\nПри `cellsSelection: { mode: 'multi-range-cell' }` можно выделить несколько прямоугольных\nдиапазонов: тянем мышкой первый, затем **Ctrl/Cmd + клик/драг** докидываем\nостальные. Заливка — у всех выделенных, рамка — только у последнего диапазона.\nРамку у каждого диапазона включает `cellsSelection.outlineEachRange` (как в Google\nSheets): диапазон, целиком поглощённый более поздним, не обводится, у соседних\nдиапазонов на стыке остаётся общая линия.\n\n**Copy (Ctrl+C)** работает для разрозненного выбора, если все ячейки лежат:\n\n- в пределах **одной колонки** — значения копируются подряд, пустые промежутки\n между ними схлопываются;\n- либо в пределах **одной строки** — аналогично по горизонтали;\n- либо куски складываются в **сплошной прямоугольник** без дыр — тогда он\n копируется как обычный диапазон.\n\nРазброс сразу **по строкам и колонкам** (2D) не переносится — copy/paste для него\nне срабатывают. Об этом таблица сообщает через модуль\n[Notifications](?path=/docs/локальные-компоненты-tablecanvas-notifications--docs)\n(`copy` / `paste`, code `multi-range-scattered`). Сама таблица тост не рисует:\nподключите `notifications.onNotification` и покажите ошибку пользователю — иначе\nотказ копирования выглядит как молчаливая поломка.\n\n**Paste (Ctrl+V)** зеркально: вставка идёт в выбранные ячейки подряд, схлопывая\nпромежутки. Полный интерактивный пример copy/paste — в разделе\n**Copy-Paste-Fill**.\n\n## Оси выделения\n\nВыделение работает по трём независимым осям. Любая из них поддерживает\ncopy/paste (**Ctrl+C / Ctrl+V**) по текущему выделению.\n\n- **Ячейки / диапазон** — мышью по области данных, зависит от `cellsSelection.mode`.\n- **Колонки** — клик по шапке колонки.\n- **Строки** — клик/драг по колонке нумерации (`rowMarkers`).\n\n### Выделение колонок\n\nКлик по шапке выделяет колонку целиком:\n\n- **Клик** — одна колонка.\n- **Shift + клик** — смежный диапазон колонок (рисуется нативно, с fill-handle).\n- **Ctrl/Cmd + клик** — несмежный выбор: добавить/убрать колонку.\n\nКлик по иконкам сортировки/фильтрации в шапке выделение **не** вызывает.\nУправляется флагом `cellsSelection.enableColumnSelection` (по умолчанию `true`).\n\n### Выделение строк\n\nКлик/драг по колонке нумерации выделяет строку(и):\n\n- **Клик / драг** — смежный диапазон строк (рисуется нативно, с fill-handle).\n- **Ctrl/Cmd + клик** — несмежный выбор отдельных строк.\n\nТребует включённой колонки нумерации (`rowMarkers`). Управляется флагом\n`cellsSelection.enableRowSelection` (по умолчанию `true`).\n\n## Включение / выключение осей\n\nВыделение колонок и строк можно выключать независимо через `tableConfig.cellsSelection`:\n\n```ts\n<TableCanvas\n tableConfig={{\n rowMarkers: { startIndex: 1 },\n cellsSelection: {\n enableColumnSelection: false, // клик по шапке не выделяет колонку\n enableRowSelection: false, // клик по нумерации не выделяет строку\n },\n }}\n/>\n```\n\nОба флага по умолчанию `true`. Выделение ячеек/диапазона при этом продолжает\nработать — оно управляется отдельным `cellsSelection.mode`.\n\n## Controlled-режим\n\nВыделением можно управлять снаружи через `state`-кортеж:\n\n```ts\nconst gridSelectionState = useState<GridSelection>(EMPTY_SELECTION);\n\n<TableCanvas\n tableConfig={{\n cellsSelection: { mode: 'range-cell', state: gridSelectionState }, // [value, setter]\n }}\n/>;\n```\n\nСброс: `setter({ current: undefined, rows: CompactSelection.empty(), columns: CompactSelection.empty() })`.\nКонтролируется нативное выделение (ячейки/диапазон/смежные строки и колонки);\nнесмежный Ctrl-выбор колонок/строк — внутренний (own-state), снаружи не задаётся.\n\nИтоговое выделение, включая несмежный Ctrl-выбор, приходит в `cellsSelection.onChange`\n(с `state` и без него). Индексы колонок в нём — в координатах грида: служебные колонки\nслева (нумерация `rowMarkers`, чекбоксы `selecting`) входят в счёт, поэтому колонка,\n`i`-я по порядку на экране, имеет индекс `i` + число служебных колонок.\n\n`CompactSelection` и тип `GridSelection` реэкспортируются из\n`@daisforge/ui/components/TableCanvas`.\n\n> Подробнее о типах — [CellsSelection API](?path=/docs/локальные-компоненты-tablecanvas-cellsselection-api--docs)",
|
|
51487
|
+
"apiDocs": "# CellsSelection API\n\n## CellsSelectionMode\n\nРежим фактического (нативного) выделения ячеек — `tableConfig.cellsSelection.mode`.\n\n```typescript\ntype CellsSelectionMode =\n | 'cell'\n | 'range-cell'\n | 'multi-range-cell'\n | 'disabled';\n```\n\n## Controlled-режим\n\n`tableConfig.cellsSelection.state` — внешний (controlled) контроль нативного выделения,\n`state`-кортеж `[GridSelection, setter]`:\n\n```ts\ncellsSelection?: {\n state?: [\n GridSelection,\n React.Dispatch<React.SetStateAction<GridSelection>>\n ];\n};\n```\n\n- Сброс: `setter({ current: undefined, rows: CompactSelection.empty(), columns: CompactSelection.empty() })`.\n- Контролирует нативное выделение (ячейки/диапазон/смежные строки и колонки).\n Несмежный Ctrl-выбор колонок/строк — внутренний.\n- `CompactSelection` (значение) и `GridSelection` (тип) реэкспортируются из\n `@daisforge/ui/components/TableCanvas`.\n\n## CellsSelectionConfig\n\nКонфиг выделения колонок (`tableConfig.cellsSelection`).\n\n```typescript\ntype 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 * Рамка у каждого диапазона несмежного Ctrl-выбора ячеек (`multi-range-cell`).\n * По умолчанию рамку рисует только активный (последний) диапазон, остальные\n * показываются заливкой. Ограничение: соседние диапазоны дают общую линию на\n * стыке; диапазон, поглощённый более поздним, не обводится.\n * @default false\n */\n outlineEachRange?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — см. `onChange`.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n /**\n * Итоговое выделение после каждого действия пользователя — в том числе\n * несмежный Ctrl-выбор колонок (`columns`) и строк (`rows`), которого нет в\n * `state`. Срабатывает с `state` и без него.\n *\n * Срабатывает и без действия пользователя, когда слева появляется или исчезает\n * служебная колонка (например, столбец ошибок): выделение остаётся на тех же\n * ячейках, а их индексы сдвигаются. Программная смена `state` снаружи\n * `onChange` не вызывает.\n *\n * Индексы колонок — в координатах грида: служебные колонки слева (нумерация\n * `rowMarkers`, чекбоксы `selecting`) входят в счёт. Колонка, `i`-я по порядку\n * на экране, имеет индекс `i` + число служебных колонок.\n */\n onChange?: (selection: GridSelection) => void;\n /**\n * Фокусировать грид, когда выделение с ячейкой приходит снаружи через `state`\n * (иначе glide рисует якорную ячейку как у несфокусированного грида).\n * Выключите, если выделение меняется программно и фокус должен остаться,\n * где был (например, переход по результатам поиска из поля ввода).\n * @default true\n */\n focusOnStateChange?: boolean;\n};\n```",
|
|
51325
51488
|
"api": [
|
|
51326
51489
|
{
|
|
51327
51490
|
"typeName": "CellsSelectionMode",
|
|
@@ -51329,7 +51492,7 @@
|
|
|
51329
51492
|
},
|
|
51330
51493
|
{
|
|
51331
51494
|
"typeName": "CellsSelectionConfig",
|
|
51332
|
-
"source": "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) сюда не входит —
|
|
51495
|
+
"source": "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 * Рамка у каждого диапазона несмежного Ctrl-выбора ячеек (`multi-range-cell`).\n * По умолчанию рамку рисует только активный (последний) диапазон, остальные\n * показываются заливкой. Ограничение: соседние диапазоны дают общую линию на\n * стыке; диапазон, поглощённый более поздним, не обводится.\n * @default false\n */\n outlineEachRange?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — см. `onChange`.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n /**\n * Итоговое выделение после каждого действия пользователя — в том числе\n * несмежный Ctrl-выбор колонок (`columns`) и строк (`rows`), которого нет в\n * `state`. Срабатывает с `state` и без него.\n *\n * Срабатывает и без действия пользователя, когда слева появляется или исчезает\n * служебная колонка (например, столбец ошибок): выделение остаётся на тех же\n * ячейках, а их индексы сдвигаются. Программная смена `state` снаружи\n * `onChange` не вызывает.\n *\n * Индексы колонок — в координатах грида: служебные колонки слева (нумерация\n * `rowMarkers`, чекбоксы `selecting`) входят в счёт. Колонка, `i`-я по порядку\n * на экране, имеет индекс `i` + число служебных колонок.\n */\n onChange?: (selection: GridSelection) => void;\n /**\n * Фокусировать грид, когда выделение с ячейкой приходит снаружи через `state`\n * (иначе glide рисует якорную ячейку как у несфокусированного грида).\n * Выключите, если выделение меняется программно и фокус должен остаться,\n * где был (например, переход по результатам поиска из поля ввода).\n * @default true\n */\n focusOnStateChange?: boolean;\n};"
|
|
51333
51496
|
}
|
|
51334
51497
|
],
|
|
51335
51498
|
"stories": [
|
|
@@ -51349,7 +51512,13 @@
|
|
|
51349
51512
|
"exportName": "MultiRangeSelect",
|
|
51350
51513
|
"displayName": "Мультивыбор диапазонов (multi-range-cell)",
|
|
51351
51514
|
"type": "full-code",
|
|
51352
|
-
"code": "import {\n type ColumnConfig,\n CompactSelection,\n type GridSelection,\n type CellsSelectionMode,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\nconst SELECTION_MODE_OPTIONS: Array<{ label: string; value: CellsSelectionMode }> = [\n { label: 'range-cell', value: 'range-cell' },\n { label: 'multi-range-cell', value: 'multi-range-cell' },\n { label: 'cell', value: 'cell' },\n { label: 'disabled', value: 'disabled' },\n];\n\nconst EMPTY_SELECTION: GridSelection = {\n current: undefined,\n rows: CompactSelection.empty(),\n columns: CompactSelection.empty(),\n};\n\nconst COLUMN_CONFIG: readonly ColumnConfig<Row>[] = [\n { key: 'id', name: 'ID', width: 90 },\n { key: 'task', name: 'Title', width: 260 },\n { key: 'priority', name: 'Priority', width: 180 },\n { key: 'issueType', name: 'Issue Type', width: 180 },\n { key: 'complete', name: '% Complete', width: 160 },\n];\n\n() => {\n const [rows] = useState(createRows);\n const columnConfig = useMemo(() => COLUMN_CONFIG, []);\n // Таблица сама тосты не рисует: ошибки copy/paste приходят в notifications,\n // показ — на стороне потребителя. Здесь показываем последнее событие плашкой.\n const [lastNotification, setLastNotification] = useState<string | null>(\n null,\n );\n\n return (\n <div>\n <StoryHint>\n <b>multi-range-cell</b>: тяни мышкой диапазон, затем <b>Ctrl/Cmd</b> +\n клик/драг — докидывай ещё диапазоны.
|
|
51515
|
+
"code": "import {\n type ColumnConfig,\n CompactSelection,\n type GridSelection,\n type CellsSelectionMode,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\nconst SELECTION_MODE_OPTIONS: Array<{ label: string; value: CellsSelectionMode }> = [\n { label: 'range-cell', value: 'range-cell' },\n { label: 'multi-range-cell', value: 'multi-range-cell' },\n { label: 'cell', value: 'cell' },\n { label: 'disabled', value: 'disabled' },\n];\n\nconst EMPTY_SELECTION: GridSelection = {\n current: undefined,\n rows: CompactSelection.empty(),\n columns: CompactSelection.empty(),\n};\n\nconst COLUMN_CONFIG: readonly ColumnConfig<Row>[] = [\n { key: 'id', name: 'ID', width: 90 },\n { key: 'task', name: 'Title', width: 260 },\n { key: 'priority', name: 'Priority', width: 180 },\n { key: 'issueType', name: 'Issue Type', width: 180 },\n { key: 'complete', name: '% Complete', width: 160 },\n];\n\n() => {\n const [rows] = useState(createRows);\n const columnConfig = useMemo(() => COLUMN_CONFIG, []);\n // Таблица сама тосты не рисует: ошибки copy/paste приходят в notifications,\n // показ — на стороне потребителя. Здесь показываем последнее событие плашкой.\n const [lastNotification, setLastNotification] = useState<string | null>(\n null,\n );\n\n return (\n <div>\n <StoryHint>\n <b>multi-range-cell</b>: тяни мышкой диапазон, затем <b>Ctrl/Cmd</b> +\n клик/драг — докидывай ещё диапазоны. Заливка — у всех выделенных,\n рамка — у последнего (рамку у каждого включает{' '}\n <code>outlineEachRange</code>, см. ниже).\n <br />\n <b>Copy (Ctrl+C):</b> работает, если разрозненный выбор в пределах{' '}\n <b>одной колонки</b> или <b>одной строки</b> — промежутки схлопываются\n (значения копируются подряд), либо если куски складываются в сплошной\n прямоугольник. Разброс сразу по строкам и колонкам не копируется — в{' '}\n <b>notifications</b> уходит ошибка (плашка ниже).\n <br />\n <b>Paste</b> со схлопыванием промежутков — в режиме редактирования,\n см. <b>Copy-Paste-Fill</b>.\n </StoryHint>\n\n {lastNotification && (\n <p\n style={{\n fontSize: 13,\n marginBottom: 8,\n padding: '6px 10px',\n borderRadius: 6,\n background: '#fdecec',\n color: '#a33',\n }}\n >\n notifications: {lastNotification}\n </p>\n )}\n\n <TableCanvas\n tableConfig={{\n containerStyle: { height: '600px' },\n cellsSelection: { mode: 'multi-range-cell' },\n rowMarkers: { startIndex: 1 },\n notifications: {\n onNotification: (event) =>\n setLastNotification(\n `[${event.type}/${event.level}] ${event.message} (${event.code})`,\n ),\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </div>\n );\n }"
|
|
51516
|
+
},
|
|
51517
|
+
{
|
|
51518
|
+
"exportName": "OutlineEachRange",
|
|
51519
|
+
"displayName": "Рамка у каждого Ctrl-диапазона (outlineEachRange)",
|
|
51520
|
+
"type": "full-code",
|
|
51521
|
+
"code": "import {\n type ColumnConfig,\n CompactSelection,\n type GridSelection,\n type CellsSelectionMode,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\nconst SELECTION_MODE_OPTIONS: Array<{ label: string; value: CellsSelectionMode }> = [\n { label: 'range-cell', value: 'range-cell' },\n { label: 'multi-range-cell', value: 'multi-range-cell' },\n { label: 'cell', value: 'cell' },\n { label: 'disabled', value: 'disabled' },\n];\n\nconst EMPTY_SELECTION: GridSelection = {\n current: undefined,\n rows: CompactSelection.empty(),\n columns: CompactSelection.empty(),\n};\n\nconst COLUMN_CONFIG: readonly ColumnConfig<Row>[] = [\n { key: 'id', name: 'ID', width: 90 },\n { key: 'task', name: 'Title', width: 260 },\n { key: 'priority', name: 'Priority', width: 180 },\n { key: 'issueType', name: 'Issue Type', width: 180 },\n { key: 'complete', name: '% Complete', width: 160 },\n];\n\n() => {\n const [rows] = useState(createRows);\n const columnConfig = useMemo(() => COLUMN_CONFIG, []);\n const [outlineEachRange, setOutlineEachRange] = useState(true);\n\n return (\n <div>\n <div style={{ marginBottom: 12 }}>\n <Checkbox\n checked={outlineEachRange}\n onChange={(e) => setOutlineEachRange(e.target.checked)}\n label={<div>cellsSelection.outlineEachRange</div>}\n />\n </div>\n\n <StoryHint>\n Выдели диапазон, затем с <b>Ctrl/Cmd</b> добавь ещё несколько. С\n опцией рамка есть у каждого диапазона (как в Google Sheets), без неё —\n только у последнего, остальные показаны заливкой.\n <br />\n Протяни новый диапазон поверх старого: поглощённый диапазон рамку не\n получает. У соседних диапазонов на стыке видна общая линия.\n </StoryHint>\n\n <TableCanvas\n tableConfig={{\n containerStyle: { height: '600px' },\n cellsSelection: { mode: 'multi-range-cell', outlineEachRange },\n rowMarkers: { startIndex: 1 },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </div>\n );\n }"
|
|
51353
51522
|
},
|
|
51354
51523
|
{
|
|
51355
51524
|
"exportName": "EnableToggles",
|
|
@@ -53373,6 +53542,13 @@
|
|
|
53373
53542
|
"importStatement": "import { TableCanvasLoggerClasses } from '@daisforge/ui/components/TableCanvas';",
|
|
53374
53543
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
|
|
53375
53544
|
},
|
|
53545
|
+
"RowHeightProp": {
|
|
53546
|
+
"name": "RowHeightProp",
|
|
53547
|
+
"definition": "export type RowHeightProp<R> =\n | ((\n row: R,\n currentRowSize: { rowSizeName: SIZE; rowSizeValue: number },\n rowIndex: number\n ) => number)\n | number\n | 'auto'\n | undefined\n | null;",
|
|
53548
|
+
"internal": true,
|
|
53549
|
+
"importNotice": "Тип \"RowHeightProp\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
53550
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
53551
|
+
},
|
|
53376
53552
|
"TableGlide.ObjectForExtending": {
|
|
53377
53553
|
"name": "ObjectForExtending",
|
|
53378
53554
|
"definition": "export type ObjectForExtending = Record<string, any>;",
|
|
@@ -53779,6 +53955,20 @@
|
|
|
53779
53955
|
"importStatement": "import { TableCanvasLoggerAction } from '@daisforge/ui/components/TableCanvas';",
|
|
53780
53956
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
|
|
53781
53957
|
},
|
|
53958
|
+
"TableGlide.SIZE": {
|
|
53959
|
+
"name": "SIZE",
|
|
53960
|
+
"definition": "export type SIZE = keyof GlideSizes;",
|
|
53961
|
+
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53962
|
+
"importStatement": "import { SIZE } from '@daisforge/ui/components/TableCanvas';",
|
|
53963
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/constants.ts"
|
|
53964
|
+
},
|
|
53965
|
+
"Table.SIZE": {
|
|
53966
|
+
"name": "SIZE",
|
|
53967
|
+
"definition": "export type SIZE = keyof typeof SIZES;",
|
|
53968
|
+
"importPath": "@daisforge/ui",
|
|
53969
|
+
"importStatement": "import { SIZE } from '@daisforge/ui';",
|
|
53970
|
+
"sourceFile": "packages/ui-kit/src/components/Table/styles/styles.constants.ts"
|
|
53971
|
+
},
|
|
53782
53972
|
"AppearanceVariant": {
|
|
53783
53973
|
"name": "AppearanceVariant",
|
|
53784
53974
|
"definition": "export type AppearanceVariant = 'default' | 'clean';",
|
|
@@ -54346,20 +54536,6 @@
|
|
|
54346
54536
|
"importNotice": "Тип \"Multiple\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54347
54537
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-filtering/combobox/combobox.tsx"
|
|
54348
54538
|
},
|
|
54349
|
-
"Table.SIZE": {
|
|
54350
|
-
"name": "SIZE",
|
|
54351
|
-
"definition": "export type SIZE = keyof typeof SIZES;",
|
|
54352
|
-
"importPath": "@daisforge/ui",
|
|
54353
|
-
"importStatement": "import { SIZE } from '@daisforge/ui';",
|
|
54354
|
-
"sourceFile": "packages/ui-kit/src/components/Table/styles/styles.constants.ts"
|
|
54355
|
-
},
|
|
54356
|
-
"TableGlide.SIZE": {
|
|
54357
|
-
"name": "SIZE",
|
|
54358
|
-
"definition": "export type SIZE = keyof GlideSizes;",
|
|
54359
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54360
|
-
"importStatement": "import { SIZE } from '@daisforge/ui/components/TableCanvas';",
|
|
54361
|
-
"sourceFile": "packages/ui-kit/src/components/TableGlide/constants.ts"
|
|
54362
|
-
},
|
|
54363
54539
|
"Prettify": {
|
|
54364
54540
|
"name": "Prettify",
|
|
54365
54541
|
"definition": "export type Prettify<T> = {\n [K in keyof T]: T[K];\n // eslint-disable-next-line @typescript-eslint/ban-types\n} & {};",
|
|
@@ -54544,7 +54720,7 @@
|
|
|
54544
54720
|
},
|
|
54545
54721
|
"TableGlideCustomProps": {
|
|
54546
54722
|
"name": "TableGlideCustomProps",
|
|
54547
|
-
"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
|
|
54723
|
+
"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?: RowHeightProp<R>;\n /** Потолок высоты строки при `rowHeight: 'auto'`, по умолчанию 480 */\n maxAutoRowHeight?: number;\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 /** Фокусировать грид при внешней смене controlled gridSelection. По умолчанию true. */\n focusOnStateChange?: boolean;\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 /** Рамка у каждого Ctrl-диапазона ячеек (multi-range-cell), а не только у активного. По умолчанию false. */\n outlineEachRange?: 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 /**\n * Ошибка всей строки: одна красная рамка по всей ширине данных вместо\n * поячеечных рамок этой строки. Проверяется только для строк в окне\n * видимости, как и `isErrorCell`.\n */\n isErrorRow?: (row: R) => boolean;\n /**\n * Собирать сводку ошибок по строкам окна видимости ({@link RowErrorsSummary}\n * в `cellInfo.rowErrors`). Для сводки колонки с `isErrorCell` обходятся все,\n * а не только видимые, поэтому включается только …",
|
|
54548
54724
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54549
54725
|
"importStatement": "import { TableGlideCustomProps } from '@daisforge/ui/components/TableCanvas';",
|
|
54550
54726
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
@@ -54628,7 +54804,7 @@
|
|
|
54628
54804
|
},
|
|
54629
54805
|
"CanvasTextOptions": {
|
|
54630
54806
|
"name": "CanvasTextOptions",
|
|
54631
|
-
"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}",
|
|
54807
|
+
"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 marks?: readonly CanvasTextMark[];\n}",
|
|
54632
54808
|
"internal": true,
|
|
54633
54809
|
"importNotice": "Тип \"CanvasTextOptions\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54634
54810
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/primitives/CanvasText.ts"
|
|
@@ -55046,6 +55222,13 @@
|
|
|
55046
55222
|
"importNotice": "Тип \"RenderGroupCellProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55047
55223
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
|
|
55048
55224
|
},
|
|
55225
|
+
"GlideSizes": {
|
|
55226
|
+
"name": "GlideSizes",
|
|
55227
|
+
"definition": "export type GlideSizes = typeof SIZES;",
|
|
55228
|
+
"internal": true,
|
|
55229
|
+
"importNotice": "Тип \"GlideSizes\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55230
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/constants.ts"
|
|
55231
|
+
},
|
|
55049
55232
|
"CanvasNodeTooltipProps": {
|
|
55050
55233
|
"name": "CanvasNodeTooltipProps",
|
|
55051
55234
|
"definition": "export type CanvasNodeTooltipProps = Pick<\n TooltipProps,\n 'placement' | 'view' | 'minWidth' | 'maxWidth'\n> & {\n /** Сохранять переносы строк (\\n) в тексте тултипа через white-space: pre-line. @default false */\n preserveLineBreaks?: boolean;\n /**\n * Сдвиг тултипа по X (px) относительно центра ноды. Нужен, когда видимая\n * часть ноды смещена внутри неё (например, иконка прижата к краю кнопки).\n * @default 0\n */\n offsetX?: number;\n};",
|
|
@@ -55417,13 +55600,6 @@
|
|
|
55417
55600
|
"importNotice": "Тип \"ComboboxType\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55418
55601
|
"sourceFile": "packages/ui-kit/src/components/Combobox/index.ts"
|
|
55419
55602
|
},
|
|
55420
|
-
"GlideSizes": {
|
|
55421
|
-
"name": "GlideSizes",
|
|
55422
|
-
"definition": "export type GlideSizes = typeof SIZES;",
|
|
55423
|
-
"internal": true,
|
|
55424
|
-
"importNotice": "Тип \"GlideSizes\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55425
|
-
"sourceFile": "packages/ui-kit/src/components/TableGlide/constants.ts"
|
|
55426
|
-
},
|
|
55427
55603
|
"TableCanvasLoggerMessageRenderContext": {
|
|
55428
55604
|
"name": "TableCanvasLoggerMessageRenderContext",
|
|
55429
55605
|
"definition": "export type TableCanvasLoggerMessageRenderContext = {\n item: TableCanvasLoggerMessageItem;\n /** Раскрыты ли подробности */\n open: boolean;\n toggle: () => void;\n /** Копирование значения с учётом `onCopy` и обратной связи в кнопке */\n copy: (kind: TableCanvasLoggerCopyKind, value: string) => Promise<void>;\n /** Стандартный рендер сообщения, удобен для оборачивания */\n defaultRender: () => ReactNode;\n};",
|
|
@@ -55592,6 +55768,13 @@
|
|
|
55592
55768
|
"importNotice": "Тип \"CanvasTextAutoTooltip\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55593
55769
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/primitives/CanvasText.ts"
|
|
55594
55770
|
},
|
|
55771
|
+
"CanvasTextMark": {
|
|
55772
|
+
"name": "CanvasTextMark",
|
|
55773
|
+
"definition": "export interface CanvasTextMark {\n start: number;\n end: number;\n color: string;\n}",
|
|
55774
|
+
"internal": true,
|
|
55775
|
+
"importNotice": "Тип \"CanvasTextMark\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55776
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/primitives/textMarks.ts"
|
|
55777
|
+
},
|
|
55595
55778
|
"LinkAllProps": {
|
|
55596
55779
|
"name": "LinkAllProps",
|
|
55597
55780
|
"definition": "type LinkAllProps = ComponentProps<typeof Link>;",
|