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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
- "generatedAt": "2026-10-19T08:52:42.376Z",
3
- "libVersion": "1.24.0",
2
+ "generatedAt": "2026-10-24T15:16:53.478Z",
3
+ "libVersion": "1.25.0",
4
4
  "components": {
5
5
  "Accordion": {
6
6
  "name": "Accordion",
@@ -25718,10 +25718,10 @@
25718
25718
  },
25719
25719
  {
25720
25720
  "exportName": "Usage2",
25721
- "displayName": "Использование в Table.multipleFeatures.stories.tsx",
25721
+ "displayName": "Использование в TableCanvas.isLoading.stories.tsx",
25722
25722
  "type": "usage",
25723
- "code": "<Switch\n style={{ width: 'fit-content' }}\n label=\"Включить колонки Title и Priority\"\n checked={bool}\n onChange={() => setBool((prev) => !prev)}\n />",
25724
- "sourceFile": "packages/storybook/src/stories/Table/Table.multipleFeatures.stories.tsx"
25723
+ "code": "<Switch\n style={{ width: 'fit-content' }}\n label=\"Показать оверлей\"\n checked={isUpdating}\n onChange={() => setIsUpdating((prev) => !prev)}\n />",
25724
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.IsLoading/TableCanvas.isLoading.stories.tsx"
25725
25725
  },
25726
25726
  {
25727
25727
  "exportName": "Vendor1",
@@ -27339,56 +27339,37 @@
27339
27339
  "description": "Основная канвасная таблица: сортировка, фильтры, группировка, редактирование ячеек.",
27340
27340
  "props": [
27341
27341
  {
27342
- "name": "columnConfig",
27343
- "type": "readonly ColumnConfig<RowType, SummaryRowType>[]",
27342
+ "name": "counts",
27343
+ "type": "Partial<Record<TableCanvasLoggerStatus, number>>",
27344
27344
  "required": true,
27345
- "description": "columnConfig - Конфигурация колонок.\n\n(рекомендуется минимальное количество зависимостей для данной сущности - в идеале, чтобы не пересоздавался)"
27345
+ "description": ""
27346
27346
  },
27347
27347
  {
27348
- "name": "rows",
27349
- "type": "RowType[]",
27348
+ "name": "onChange",
27349
+ "type": "(value: TableCanvasLoggerFilterValue) => void",
27350
27350
  "required": true,
27351
- "description": "rows - данные для таблицы. ```RowType extends Record<string | number, any>```"
27352
- },
27353
- {
27354
- "name": "bottomSummaryRows",
27355
- "type": "SummaryRowType[] | undefined",
27356
- "required": false,
27357
- "description": "bottomSummaryRows - данные для итоговой строки в нижней части таблицы. ```SummaryRowType[]```"
27358
- },
27359
- {
27360
- "name": "headerContextValue",
27361
- "type": "HeaderContextValueType | undefined",
27362
- "required": false,
27363
- "description": "headerContextValue: любые стейты, которые нужны в headerCell - кладем в headerContextValue. И получаем доступ с помощью cellInfo.ctxs из args."
27364
- },
27365
- {
27366
- "name": "rowContextValue",
27367
- "type": "RowContextValueType | undefined",
27368
- "required": false,
27369
- "description": "rowContextValue: любые стейты, которые нужны в cell - кладем в rowContextValue. И получаем доступ с помощью cellInfo.ctxs из args."
27351
+ "description": ""
27370
27352
  },
27371
27353
  {
27372
- "name": "tableConfig",
27373
- "type": "{ columnsGrouping?: ColumnsGroupingConfig | undefined; highlightActiveType?: HighlightActiveType | undefined; cellsSelection?: CellsSelectionConfig | undefined; highlightActiveRow?: { state?: [number | undefined, React.Dispatch<React.SetStateAction<number | undefined>>] | undefined; onChange?: ((params: { index: number | undefined; row: RowType | undefined; }) => void) | undefined; } | undefined; …",
27374
- "required": false,
27375
- "description": "tableConfig - Конфигурация фичей таблицы (их активация и отключение)",
27376
- "default": "{}"
27354
+ "name": "value",
27355
+ "type": "TableCanvasLoggerFilterValue | null",
27356
+ "required": true,
27357
+ "description": ""
27377
27358
  },
27378
27359
  {
27379
- "name": "refTable",
27380
- "type": "React.Ref<DataEditorRef> | undefined",
27360
+ "name": "extra",
27361
+ "type": "React.ReactNode",
27381
27362
  "required": false,
27382
- "description": ""
27363
+ "description": "Дополнительные чипсы после стандартных"
27383
27364
  },
27384
27365
  {
27385
- "name": "refTableContainer",
27386
- "type": "React.Ref<HTMLDivElement> | undefined",
27366
+ "name": "showEmpty",
27367
+ "type": "boolean | undefined",
27387
27368
  "required": false,
27388
- "description": ""
27369
+ "description": "Показывать чипсы статусов без сообщений"
27389
27370
  }
27390
27371
  ],
27391
- "propsTypeName": "TableCanvasProps",
27372
+ "propsTypeName": "TableCanvasLoggerFiltersProps",
27392
27373
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/TableCanvas.tsx",
27393
27374
  "type": "standalone",
27394
27375
  "category": "Локальные компоненты",
@@ -27415,7 +27396,7 @@
27415
27396
  "atomicMcpVersion": "0.361.0",
27416
27397
  "importPath": "@sber-digital-finance-ui/ui-kit",
27417
27398
  "importStatement": "import { TableCanvas } from '@sber-digital-finance-ui/ui-kit';",
27418
- "minimalUsage": "<TableCanvas columnConfig={[]} rows={[]} />",
27399
+ "minimalUsage": "<TableCanvas counts={{}} onChange={() => {}} value={{}} />",
27419
27400
  "examples": [
27420
27401
  {
27421
27402
  "exportName": "Usage1",
@@ -27433,6 +27414,762 @@
27433
27414
  }
27434
27415
  ]
27435
27416
  },
27417
+ "TableCanvasLoggerFilters": {
27418
+ "name": "TableCanvasLoggerFilters",
27419
+ "group": "components",
27420
+ "folderName": "TableCanvas",
27421
+ "role": "primary",
27422
+ "description": "",
27423
+ "props": [
27424
+ {
27425
+ "name": "counts",
27426
+ "type": "Partial<Record<TableCanvasLoggerStatus, number>>",
27427
+ "required": true,
27428
+ "description": ""
27429
+ },
27430
+ {
27431
+ "name": "onChange",
27432
+ "type": "(value: TableCanvasLoggerFilterValue) => void",
27433
+ "required": true,
27434
+ "description": ""
27435
+ },
27436
+ {
27437
+ "name": "value",
27438
+ "type": "TableCanvasLoggerFilterValue | null",
27439
+ "required": true,
27440
+ "description": ""
27441
+ },
27442
+ {
27443
+ "name": "extra",
27444
+ "type": "React.ReactNode",
27445
+ "required": false,
27446
+ "description": "Дополнительные чипсы после стандартных"
27447
+ },
27448
+ {
27449
+ "name": "showEmpty",
27450
+ "type": "boolean | undefined",
27451
+ "required": false,
27452
+ "description": "Показывать чипсы статусов без сообщений"
27453
+ }
27454
+ ],
27455
+ "propsTypeName": "TableCanvasLoggerFiltersProps",
27456
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/components/TableCanvasLoggerFilters.tsx",
27457
+ "type": "composition",
27458
+ "relatedExports": [
27459
+ "SplitIconButton",
27460
+ "CellEditorCombobox",
27461
+ "CellEditorNumberFormat",
27462
+ "CellEditorTextArea",
27463
+ "TableFilterSelectListItem",
27464
+ "ContainerStyled",
27465
+ "TextCellEntry",
27466
+ "Canvas",
27467
+ "TextCellEntryType"
27468
+ ],
27469
+ "atomicMcpVersion": "0.361.0",
27470
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
27471
+ "importStatement": "import { TableCanvasLoggerFilters } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
27472
+ "minimalUsage": "<TableCanvasLoggerFilters counts={{}} onChange={() => {}} value={{}} />",
27473
+ "examples": [
27474
+ {
27475
+ "exportName": "Usage",
27476
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
27477
+ "type": "usage",
27478
+ "code": "<TableCanvasLoggerFilters\n counts={logger.counts}\n value={logger.filter}\n onChange={logger.setFilter}\n showEmpty\n />",
27479
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
27480
+ }
27481
+ ]
27482
+ },
27483
+ "TableCanvasLoggerGroup": {
27484
+ "name": "TableCanvasLoggerGroup",
27485
+ "group": "components",
27486
+ "folderName": "TableCanvas",
27487
+ "role": "primary",
27488
+ "description": "",
27489
+ "props": [
27490
+ {
27491
+ "name": "item",
27492
+ "type": "TableCanvasLoggerGroupItem",
27493
+ "required": true,
27494
+ "description": ""
27495
+ },
27496
+ {
27497
+ "name": "onOpenChange",
27498
+ "type": "((open: boolean, item: TableCanvasLoggerGroupItem) => void) | undefined",
27499
+ "required": false,
27500
+ "description": ""
27501
+ }
27502
+ ],
27503
+ "propsTypeName": "TableCanvasLoggerGroupProps",
27504
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/components/TableCanvasLoggerGroup.tsx",
27505
+ "type": "composition",
27506
+ "relatedExports": [
27507
+ "SplitIconButton",
27508
+ "CellEditorCombobox",
27509
+ "CellEditorNumberFormat",
27510
+ "CellEditorTextArea",
27511
+ "TableFilterSelectListItem",
27512
+ "ContainerStyled",
27513
+ "TextCellEntry",
27514
+ "Canvas",
27515
+ "TextCellEntryType"
27516
+ ],
27517
+ "atomicMcpVersion": "0.361.0",
27518
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
27519
+ "importStatement": "import { TableCanvasLoggerGroup } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
27520
+ "minimalUsage": "<TableCanvasLoggerGroup item={{}} />",
27521
+ "examples": [
27522
+ {
27523
+ "exportName": "Usage",
27524
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
27525
+ "type": "usage",
27526
+ "code": "<TableCanvasLoggerGroup item={singleGroup} open>\n <TableCanvasLoggerMessage\n item={{\n id: 'standalone-2',\n status: 'warning',\n title: 'Вложенное сообщение',\n }}\n />\n </TableCanvasLoggerGroup>",
27527
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
27528
+ }
27529
+ ]
27530
+ },
27531
+ "TableCanvasLoggerItems": {
27532
+ "name": "TableCanvasLoggerItems",
27533
+ "group": "components",
27534
+ "folderName": "TableCanvas",
27535
+ "role": "primary",
27536
+ "description": "Сообщения и группы с раскрытием из TableCanvasLoggerProvider",
27537
+ "props": [
27538
+ {
27539
+ "name": "items",
27540
+ "type": "TableCanvasLoggerItem[]",
27541
+ "required": true,
27542
+ "description": ""
27543
+ }
27544
+ ],
27545
+ "propsTypeName": "ComponentProps<typeof TableCanvasLoggerItems>",
27546
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/components/TableCanvasLoggerItems.tsx",
27547
+ "type": "standalone",
27548
+ "relatedExports": [
27549
+ "SplitIconButton",
27550
+ "CellEditorCombobox",
27551
+ "CellEditorNumberFormat",
27552
+ "CellEditorTextArea",
27553
+ "TableFilterSelectListItem",
27554
+ "ContainerStyled",
27555
+ "TextCellEntry",
27556
+ "Canvas",
27557
+ "TextCellEntryType"
27558
+ ],
27559
+ "atomicMcpVersion": "0.361.0",
27560
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
27561
+ "importStatement": "import { TableCanvasLoggerItems } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
27562
+ "minimalUsage": "<TableCanvasLoggerItems items={[]} />",
27563
+ "examples": [
27564
+ {
27565
+ "exportName": "Usage",
27566
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
27567
+ "type": "usage",
27568
+ "code": "<TableCanvasLoggerItems items={logger.visibleItems} />",
27569
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
27570
+ }
27571
+ ]
27572
+ },
27573
+ "TableCanvasLoggerMessage": {
27574
+ "name": "TableCanvasLoggerMessage",
27575
+ "group": "components",
27576
+ "folderName": "TableCanvas",
27577
+ "role": "primary",
27578
+ "description": "",
27579
+ "props": [
27580
+ {
27581
+ "name": "item",
27582
+ "type": "TableCanvasLoggerMessageItem",
27583
+ "required": true,
27584
+ "description": ""
27585
+ },
27586
+ {
27587
+ "name": "defaultOpen",
27588
+ "type": "boolean | undefined",
27589
+ "required": false,
27590
+ "description": ""
27591
+ },
27592
+ {
27593
+ "name": "onOpenChange",
27594
+ "type": "((open: boolean, item: TableCanvasLoggerMessageItem) => void) | undefined",
27595
+ "required": false,
27596
+ "description": ""
27597
+ }
27598
+ ],
27599
+ "propsTypeName": "TableCanvasLoggerMessageProps",
27600
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/components/TableCanvasLoggerMessage.tsx",
27601
+ "type": "composition",
27602
+ "relatedExports": [
27603
+ "SplitIconButton",
27604
+ "CellEditorCombobox",
27605
+ "CellEditorNumberFormat",
27606
+ "CellEditorTextArea",
27607
+ "TableFilterSelectListItem",
27608
+ "ContainerStyled",
27609
+ "TextCellEntry",
27610
+ "Canvas",
27611
+ "TextCellEntryType"
27612
+ ],
27613
+ "atomicMcpVersion": "0.361.0",
27614
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
27615
+ "importStatement": "import { TableCanvasLoggerMessage } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
27616
+ "minimalUsage": "<TableCanvasLoggerMessage item={{}} />",
27617
+ "examples": [
27618
+ {
27619
+ "exportName": "Usage1",
27620
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
27621
+ "type": "usage",
27622
+ "code": "<TableCanvasLoggerMessage item={singleMessage} />",
27623
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
27624
+ },
27625
+ {
27626
+ "exportName": "Usage2",
27627
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
27628
+ "type": "usage",
27629
+ "code": "<TableCanvasLoggerMessage\n item={{\n id: 'standalone-2',\n status: 'warning',\n title: 'Вложенное сообщение',\n }}\n />",
27630
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
27631
+ }
27632
+ ]
27633
+ },
27634
+ "TableCanvasLoggerStatusIcon": {
27635
+ "name": "TableCanvasLoggerStatusIcon",
27636
+ "group": "components",
27637
+ "folderName": "TableCanvas",
27638
+ "role": "primary",
27639
+ "description": "Иконка статуса с подписью для скринридера (`labels[status]`)",
27640
+ "props": [
27641
+ {
27642
+ "name": "status",
27643
+ "type": "TableCanvasLoggerStatus",
27644
+ "required": true,
27645
+ "description": ""
27646
+ }
27647
+ ],
27648
+ "propsTypeName": "TableCanvasLoggerStatusIconProps",
27649
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/components/TableCanvasLoggerStatusIcon.tsx",
27650
+ "type": "standalone",
27651
+ "relatedExports": [
27652
+ "SplitIconButton",
27653
+ "CellEditorCombobox",
27654
+ "CellEditorNumberFormat",
27655
+ "CellEditorTextArea",
27656
+ "TableFilterSelectListItem",
27657
+ "ContainerStyled",
27658
+ "TextCellEntry",
27659
+ "Canvas",
27660
+ "TextCellEntryType"
27661
+ ],
27662
+ "atomicMcpVersion": "0.361.0",
27663
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
27664
+ "importStatement": "import { TableCanvasLoggerStatusIcon } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
27665
+ "minimalUsage": "<TableCanvasLoggerStatusIcon status={{}} />",
27666
+ "examples": []
27667
+ },
27668
+ "TableCanvasLogger": {
27669
+ "name": "TableCanvasLogger",
27670
+ "group": "components",
27671
+ "folderName": "TableCanvas",
27672
+ "role": "primary",
27673
+ "description": "",
27674
+ "props": [
27675
+ {
27676
+ "name": "copyToClipboard",
27677
+ "type": "((value: string) => boolean | void | Promise<boolean | void>) | undefined",
27678
+ "required": false,
27679
+ "description": "Своё копирование. Вернуть `false` или выбросить ошибку, если скопировать не удалось"
27680
+ },
27681
+ {
27682
+ "name": "counts",
27683
+ "type": "Partial<Record<TableCanvasLoggerStatus, number>> | undefined",
27684
+ "required": false,
27685
+ "description": "Внешние счётчики. По умолчанию считаются по `items`: группа учитывается\nнаравне с сообщениями, поэтому группа с тремя сообщениями даёт «Все (4)»"
27686
+ },
27687
+ {
27688
+ "name": "emptyContent",
27689
+ "type": "React.ReactNode",
27690
+ "required": false,
27691
+ "description": "Контент пустого списка"
27692
+ },
27693
+ {
27694
+ "name": "expandedIds",
27695
+ "type": "string[] | undefined",
27696
+ "required": false,
27697
+ "description": "Раскрытые id: сообщений (подробности) и групп"
27698
+ },
27699
+ {
27700
+ "name": "filter",
27701
+ "type": "TableCanvasLoggerFilterValue | undefined",
27702
+ "required": false,
27703
+ "description": "Текущий фильтр. При закрытии панели сбрасывается на «Все», в закрытой панели чипсы не выделены"
27704
+ },
27705
+ {
27706
+ "name": "formatDate",
27707
+ "type": "((date: NonNullable<string | number | Date | undefined>, item: TableCanvasLoggerMessageItem) => string | null) | undefined",
27708
+ "required": false,
27709
+ "description": "Формат даты. Вернуть null, чтобы скрыть дату"
27710
+ },
27711
+ {
27712
+ "name": "headerExtra",
27713
+ "type": "React.ReactNode",
27714
+ "required": false,
27715
+ "description": "Контент справа в шапке"
27716
+ },
27717
+ {
27718
+ "name": "hideFilters",
27719
+ "type": "boolean | undefined",
27720
+ "required": false,
27721
+ "description": "Скрыть фильтры в шапке"
27722
+ },
27723
+ {
27724
+ "name": "hideHeader",
27725
+ "type": "boolean | undefined",
27726
+ "required": false,
27727
+ "description": "Скрыть шапку: остаётся только список"
27728
+ },
27729
+ {
27730
+ "name": "icon",
27731
+ "type": "React.ReactNode",
27732
+ "required": false,
27733
+ "description": "Иконка слева от заголовка"
27734
+ },
27735
+ {
27736
+ "name": "maxHeight",
27737
+ "type": "string | number | undefined",
27738
+ "required": false,
27739
+ "description": "Максимальная высота списка. По умолчанию не ограничена: логгер занимает высоту родителя, а список прокручивается"
27740
+ },
27741
+ {
27742
+ "name": "onCodeClick",
27743
+ "type": "((code: string, item: TableCanvasLoggerMessageItem) => void) | undefined",
27744
+ "required": false,
27745
+ "description": "Вызывается при клике на кнопку с кодом сообщения"
27746
+ },
27747
+ {
27748
+ "name": "onCopy",
27749
+ "type": "((kind: TableCanvasLoggerCopyKind, value: string, item: TableCanvasLoggerMessageItem) => void) | undefined",
27750
+ "required": false,
27751
+ "description": "Вызывается после копирования. Если задан `copyToClipboard`, он заменяет стандартное копирование"
27752
+ },
27753
+ {
27754
+ "name": "renderActions",
27755
+ "type": "((item: TableCanvasLoggerMessageItem, defaultActions: React.ReactNode) => React.ReactNode) | undefined",
27756
+ "required": false,
27757
+ "description": "Замена строки действий. Получает стандартные кнопки вторым аргументом"
27758
+ },
27759
+ {
27760
+ "name": "renderDescription",
27761
+ "type": "((item: TableCanvasLoggerMessageItem) => React.ReactNode) | undefined",
27762
+ "required": false,
27763
+ "description": "Замена блока подробностей"
27764
+ },
27765
+ {
27766
+ "name": "renderGroup",
27767
+ "type": "((ctx: TableCanvasLoggerGroupRenderContext) => React.ReactNode) | undefined",
27768
+ "required": false,
27769
+ "description": "Полная замена группы"
27770
+ },
27771
+ {
27772
+ "name": "renderMessage",
27773
+ "type": "((ctx: TableCanvasLoggerMessageRenderContext) => React.ReactNode) | undefined",
27774
+ "required": false,
27775
+ "description": "Полная замена сообщения"
27776
+ },
27777
+ {
27778
+ "name": "renderMessageExtra",
27779
+ "type": "((item: TableCanvasLoggerMessageItem) => React.ReactNode) | undefined",
27780
+ "required": false,
27781
+ "description": "Дополнительный контент справа от заголовка сообщения"
27782
+ },
27783
+ {
27784
+ "name": "showEmptyFilters",
27785
+ "type": "boolean | undefined",
27786
+ "required": false,
27787
+ "description": "Показывать ли чипс статуса с нулевым счётчиком"
27788
+ },
27789
+ {
27790
+ "name": "statusIcons",
27791
+ "type": "Partial<Record<TableCanvasLoggerStatus, React.ReactNode>> | undefined",
27792
+ "required": false,
27793
+ "description": "Замена иконок статусов"
27794
+ },
27795
+ {
27796
+ "name": "title",
27797
+ "type": "React.ReactNode",
27798
+ "required": false,
27799
+ "description": "Заголовок панели"
27800
+ },
27801
+ {
27802
+ "name": "$css",
27803
+ "type": "TableCanvasLoggerCssProp | undefined",
27804
+ "required": false,
27805
+ "description": ""
27806
+ },
27807
+ {
27808
+ "name": "classes",
27809
+ "type": "TableCanvasLoggerClasses | undefined",
27810
+ "required": false,
27811
+ "description": ""
27812
+ },
27813
+ {
27814
+ "name": "defaultExpandedIds",
27815
+ "type": "string[] | undefined",
27816
+ "required": false,
27817
+ "description": ""
27818
+ },
27819
+ {
27820
+ "name": "defaultFilter",
27821
+ "type": "TableCanvasLoggerFilterValue | undefined",
27822
+ "required": false,
27823
+ "description": ""
27824
+ },
27825
+ {
27826
+ "name": "defaultOpen",
27827
+ "type": "boolean | undefined",
27828
+ "required": false,
27829
+ "description": ""
27830
+ },
27831
+ {
27832
+ "name": "items",
27833
+ "type": "TableCanvasLoggerItem[] | null | undefined",
27834
+ "required": false,
27835
+ "description": ""
27836
+ },
27837
+ {
27838
+ "name": "labels",
27839
+ "type": "Partial<TableCanvasLoggerLabels> | undefined",
27840
+ "required": false,
27841
+ "description": ""
27842
+ },
27843
+ {
27844
+ "name": "onExpandedIdsChange",
27845
+ "type": "((ids: string[]) => void) | undefined",
27846
+ "required": false,
27847
+ "description": ""
27848
+ },
27849
+ {
27850
+ "name": "onFilterChange",
27851
+ "type": "((filter: TableCanvasLoggerFilterValue) => void) | undefined",
27852
+ "required": false,
27853
+ "description": ""
27854
+ },
27855
+ {
27856
+ "name": "onOpenChange",
27857
+ "type": "((open: boolean) => void) | undefined",
27858
+ "required": false,
27859
+ "description": ""
27860
+ }
27861
+ ],
27862
+ "propsTypeName": "TableCanvasLoggerProps",
27863
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.tsx",
27864
+ "type": "composition",
27865
+ "relatedExports": [
27866
+ "SplitIconButton",
27867
+ "CellEditorCombobox",
27868
+ "CellEditorNumberFormat",
27869
+ "CellEditorTextArea",
27870
+ "TableFilterSelectListItem",
27871
+ "ContainerStyled",
27872
+ "TextCellEntry",
27873
+ "Canvas",
27874
+ "TextCellEntryType"
27875
+ ],
27876
+ "atomicMcpVersion": "0.361.0",
27877
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
27878
+ "importStatement": "import { TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
27879
+ "minimalUsage": "<TableCanvasLogger />",
27880
+ "examples": [
27881
+ {
27882
+ "exportName": "Usage1",
27883
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
27884
+ "type": "usage",
27885
+ "code": "<TableCanvasLogger\n items={GROUPED_ITEMS}\n open={open}\n onOpenChange={setOpen}\n filter={filter}\n onFilterChange={setFilter}\n expandedIds={expanded}\n onExpandedIdsChange={setExpanded}\n />",
27886
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
27887
+ },
27888
+ {
27889
+ "exportName": "Usage2",
27890
+ "displayName": "Использование в TableCanvasLogger.inTable.tsx",
27891
+ "type": "usage",
27892
+ "code": "<TableCanvasLogger\n items={items}\n open={open}\n onOpenChange={setOpen}\n />",
27893
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.inTable.tsx"
27894
+ }
27895
+ ]
27896
+ },
27897
+ "TableCanvasLoggerList": {
27898
+ "name": "TableCanvasLoggerList",
27899
+ "group": "components",
27900
+ "folderName": "TableCanvas",
27901
+ "role": "primary",
27902
+ "description": "",
27903
+ "props": [
27904
+ {
27905
+ "name": "copyToClipboard",
27906
+ "type": "((value: string) => boolean | void | Promise<boolean | void>) | undefined",
27907
+ "required": false,
27908
+ "description": "Своё копирование. Вернуть `false` или выбросить ошибку, если скопировать не удалось"
27909
+ },
27910
+ {
27911
+ "name": "emptyContent",
27912
+ "type": "React.ReactNode",
27913
+ "required": false,
27914
+ "description": "Контент пустого списка"
27915
+ },
27916
+ {
27917
+ "name": "expandedIds",
27918
+ "type": "string[] | undefined",
27919
+ "required": false,
27920
+ "description": "Раскрытые id: сообщений (подробности) и групп"
27921
+ },
27922
+ {
27923
+ "name": "filter",
27924
+ "type": "TableCanvasLoggerFilterValue | undefined",
27925
+ "required": false,
27926
+ "description": "Текущий фильтр. Применяется к списку и счётчикам"
27927
+ },
27928
+ {
27929
+ "name": "formatDate",
27930
+ "type": "((date: NonNullable<string | number | Date | undefined>, item: TableCanvasLoggerMessageItem) => string | null) | undefined",
27931
+ "required": false,
27932
+ "description": "Формат даты. Вернуть null, чтобы скрыть дату"
27933
+ },
27934
+ {
27935
+ "name": "maxHeight",
27936
+ "type": "string | number | undefined",
27937
+ "required": false,
27938
+ "description": "Максимальная высота списка. По умолчанию не ограничена: логгер занимает высоту родителя, а список прокручивается"
27939
+ },
27940
+ {
27941
+ "name": "onCodeClick",
27942
+ "type": "((code: string, item: TableCanvasLoggerMessageItem) => void) | undefined",
27943
+ "required": false,
27944
+ "description": "Вызывается при клике на кнопку с кодом сообщения"
27945
+ },
27946
+ {
27947
+ "name": "onCopy",
27948
+ "type": "((kind: TableCanvasLoggerCopyKind, value: string, item: TableCanvasLoggerMessageItem) => void) | undefined",
27949
+ "required": false,
27950
+ "description": "Вызывается после копирования. Если задан `copyToClipboard`, он заменяет стандартное копирование"
27951
+ },
27952
+ {
27953
+ "name": "renderActions",
27954
+ "type": "((item: TableCanvasLoggerMessageItem, defaultActions: React.ReactNode) => React.ReactNode) | undefined",
27955
+ "required": false,
27956
+ "description": "Замена строки действий. Получает стандартные кнопки вторым аргументом"
27957
+ },
27958
+ {
27959
+ "name": "renderDescription",
27960
+ "type": "((item: TableCanvasLoggerMessageItem) => React.ReactNode) | undefined",
27961
+ "required": false,
27962
+ "description": "Замена блока подробностей"
27963
+ },
27964
+ {
27965
+ "name": "renderGroup",
27966
+ "type": "((ctx: TableCanvasLoggerGroupRenderContext) => React.ReactNode) | undefined",
27967
+ "required": false,
27968
+ "description": "Полная замена группы"
27969
+ },
27970
+ {
27971
+ "name": "renderMessage",
27972
+ "type": "((ctx: TableCanvasLoggerMessageRenderContext) => React.ReactNode) | undefined",
27973
+ "required": false,
27974
+ "description": "Полная замена сообщения"
27975
+ },
27976
+ {
27977
+ "name": "renderMessageExtra",
27978
+ "type": "((item: TableCanvasLoggerMessageItem) => React.ReactNode) | undefined",
27979
+ "required": false,
27980
+ "description": "Дополнительный контент справа от заголовка сообщения"
27981
+ },
27982
+ {
27983
+ "name": "statusIcons",
27984
+ "type": "Partial<Record<TableCanvasLoggerStatus, React.ReactNode>> | undefined",
27985
+ "required": false,
27986
+ "description": "Замена иконок статусов"
27987
+ },
27988
+ {
27989
+ "name": "$css",
27990
+ "type": "TableCanvasLoggerCssProp | undefined",
27991
+ "required": false,
27992
+ "description": ""
27993
+ },
27994
+ {
27995
+ "name": "classes",
27996
+ "type": "TableCanvasLoggerClasses | undefined",
27997
+ "required": false,
27998
+ "description": ""
27999
+ },
28000
+ {
28001
+ "name": "defaultExpandedIds",
28002
+ "type": "string[] | undefined",
28003
+ "required": false,
28004
+ "description": ""
28005
+ },
28006
+ {
28007
+ "name": "items",
28008
+ "type": "TableCanvasLoggerItem[] | null | undefined",
28009
+ "required": false,
28010
+ "description": ""
28011
+ },
28012
+ {
28013
+ "name": "labels",
28014
+ "type": "Partial<TableCanvasLoggerLabels> | undefined",
28015
+ "required": false,
28016
+ "description": ""
28017
+ },
28018
+ {
28019
+ "name": "onExpandedIdsChange",
28020
+ "type": "((ids: string[]) => void) | undefined",
28021
+ "required": false,
28022
+ "description": ""
28023
+ }
28024
+ ],
28025
+ "propsTypeName": "TableCanvasLoggerListProps",
28026
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLoggerList.tsx",
28027
+ "type": "composition",
28028
+ "relatedExports": [
28029
+ "SplitIconButton",
28030
+ "CellEditorCombobox",
28031
+ "CellEditorNumberFormat",
28032
+ "CellEditorTextArea",
28033
+ "TableFilterSelectListItem",
28034
+ "ContainerStyled",
28035
+ "TextCellEntry",
28036
+ "Canvas",
28037
+ "TextCellEntryType"
28038
+ ],
28039
+ "atomicMcpVersion": "0.361.0",
28040
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
28041
+ "importStatement": "import { TableCanvasLoggerList } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
28042
+ "minimalUsage": "<TableCanvasLoggerList />",
28043
+ "examples": [
28044
+ {
28045
+ "exportName": "Usage",
28046
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
28047
+ "type": "usage",
28048
+ "code": "<TableCanvasLoggerList\n items={GROUPED_ITEMS}\n defaultExpandedIds={['excel']}\n maxHeight={360}\n />",
28049
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
28050
+ }
28051
+ ]
28052
+ },
28053
+ "TableCanvasLoggerProvider": {
28054
+ "name": "TableCanvasLoggerProvider",
28055
+ "group": "components",
28056
+ "folderName": "TableCanvas",
28057
+ "role": "primary",
28058
+ "description": "",
28059
+ "props": [
28060
+ {
28061
+ "name": "expandedIds",
28062
+ "type": "string[]",
28063
+ "required": true,
28064
+ "description": ""
28065
+ },
28066
+ {
28067
+ "name": "toggleExpanded",
28068
+ "type": "(id: string) => void",
28069
+ "required": true,
28070
+ "description": ""
28071
+ },
28072
+ {
28073
+ "name": "copyToClipboard",
28074
+ "type": "((value: string) => boolean | void | Promise<boolean | void>) | undefined",
28075
+ "required": false,
28076
+ "description": "Своё копирование. Вернуть `false` или выбросить ошибку, если скопировать не удалось"
28077
+ },
28078
+ {
28079
+ "name": "formatDate",
28080
+ "type": "((date: NonNullable<string | number | Date | undefined>, item: TableCanvasLoggerMessageItem) => string | null) | undefined",
28081
+ "required": false,
28082
+ "description": "Формат даты. Вернуть null, чтобы скрыть дату"
28083
+ },
28084
+ {
28085
+ "name": "onCodeClick",
28086
+ "type": "((code: string, item: TableCanvasLoggerMessageItem) => void) | undefined",
28087
+ "required": false,
28088
+ "description": "Вызывается при клике на кнопку с кодом сообщения"
28089
+ },
28090
+ {
28091
+ "name": "onCopy",
28092
+ "type": "((kind: TableCanvasLoggerCopyKind, value: string, item: TableCanvasLoggerMessageItem) => void) | undefined",
28093
+ "required": false,
28094
+ "description": "Вызывается после копирования. Если задан `copyToClipboard`, он заменяет стандартное копирование"
28095
+ },
28096
+ {
28097
+ "name": "renderActions",
28098
+ "type": "((item: TableCanvasLoggerMessageItem, defaultActions: React.ReactNode) => React.ReactNode) | undefined",
28099
+ "required": false,
28100
+ "description": "Замена строки действий. Получает стандартные кнопки вторым аргументом"
28101
+ },
28102
+ {
28103
+ "name": "renderDescription",
28104
+ "type": "((item: TableCanvasLoggerMessageItem) => React.ReactNode) | undefined",
28105
+ "required": false,
28106
+ "description": "Замена блока подробностей"
28107
+ },
28108
+ {
28109
+ "name": "renderGroup",
28110
+ "type": "((ctx: TableCanvasLoggerGroupRenderContext) => React.ReactNode) | undefined",
28111
+ "required": false,
28112
+ "description": "Полная замена группы"
28113
+ },
28114
+ {
28115
+ "name": "renderMessage",
28116
+ "type": "((ctx: TableCanvasLoggerMessageRenderContext) => React.ReactNode) | undefined",
28117
+ "required": false,
28118
+ "description": "Полная замена сообщения"
28119
+ },
28120
+ {
28121
+ "name": "renderMessageExtra",
28122
+ "type": "((item: TableCanvasLoggerMessageItem) => React.ReactNode) | undefined",
28123
+ "required": false,
28124
+ "description": "Дополнительный контент справа от заголовка сообщения"
28125
+ },
28126
+ {
28127
+ "name": "statusIcons",
28128
+ "type": "Partial<Record<TableCanvasLoggerStatus, React.ReactNode>> | undefined",
28129
+ "required": false,
28130
+ "description": "Замена иконок статусов"
28131
+ },
28132
+ {
28133
+ "name": "classes",
28134
+ "type": "TableCanvasLoggerClasses | undefined",
28135
+ "required": false,
28136
+ "description": ""
28137
+ },
28138
+ {
28139
+ "name": "labels",
28140
+ "type": "Partial<TableCanvasLoggerLabels> | undefined",
28141
+ "required": false,
28142
+ "description": ""
28143
+ }
28144
+ ],
28145
+ "propsTypeName": "TableCanvasLoggerProviderProps",
28146
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLoggerProvider.tsx",
28147
+ "type": "standalone",
28148
+ "relatedExports": [
28149
+ "SplitIconButton",
28150
+ "CellEditorCombobox",
28151
+ "CellEditorNumberFormat",
28152
+ "CellEditorTextArea",
28153
+ "TableFilterSelectListItem",
28154
+ "ContainerStyled",
28155
+ "TextCellEntry",
28156
+ "Canvas",
28157
+ "TextCellEntryType"
28158
+ ],
28159
+ "atomicMcpVersion": "0.361.0",
28160
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
28161
+ "importStatement": "import { TableCanvasLoggerProvider } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
28162
+ "minimalUsage": "<TableCanvasLoggerProvider expandedIds={[]} toggleExpanded={() => {}} />",
28163
+ "examples": [
28164
+ {
28165
+ "exportName": "Usage",
28166
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
28167
+ "type": "usage",
28168
+ "code": "<TableCanvasLoggerProvider\n expandedIds={logger.expandedIds}\n toggleExpanded={logger.toggleExpanded}\n >\n <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>\n <TableCanvasLoggerFilters\n counts={logger.counts}\n value={logger.filter}\n onChange={logger.setFilter}\n showEmpty\n />\n <TableCanvasLoggerItems items={logger.visibleItems} />\n </div>\n </TableCanvasLoggerProvider>",
28169
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
28170
+ }
28171
+ ]
28172
+ },
27436
28173
  "TableGlideInstance": {
27437
28174
  "name": "TableGlideInstance",
27438
28175
  "group": "components",
@@ -27506,6 +28243,12 @@
27506
28243
  "required": false,
27507
28244
  "description": "Allows coercion of pasted values."
27508
28245
  },
28246
+ {
28247
+ "name": "collectRowErrors",
28248
+ "type": "boolean | undefined",
28249
+ "required": false,
28250
+ "description": "Собирать сводку ошибок по строкам окна видимости ({@link RowErrorsSummary}\nв `cellInfo.rowErrors`). Для сводки колонки с `isErrorCell` обходятся все,\nа не только видимые, поэтому включается только когда сводка кому-то нужна\n(столбец-индикатор ошибок)."
28251
+ },
27509
28252
  {
27510
28253
  "name": "columnSelect",
27511
28254
  "type": "\"none\" | \"single\" | \"multi\" | undefined",
@@ -27765,6 +28508,12 @@
27765
28508
  "required": false,
27766
28509
  "description": "Determines what can be dragged using HTML drag and drop"
27767
28510
  },
28511
+ {
28512
+ "name": "isErrorRow",
28513
+ "type": "((row: R) => boolean) | undefined",
28514
+ "required": false,
28515
+ "description": "Ошибка всей строки: одна красная рамка по всей ширине данных вместо\nпоячеечных рамок этой строки. Проверяется только для строк в окне\nвидимости, как и `isErrorCell`."
28516
+ },
27768
28517
  {
27769
28518
  "name": "isOutsideClick",
27770
28519
  "type": "((e: MouseEvent | TouchEvent) => boolean) | undefined",
@@ -28850,6 +29599,12 @@
28850
29599
  "required": false,
28851
29600
  "description": "Индексы строк, выбранных через checkbox selection."
28852
29601
  },
29602
+ {
29603
+ "name": "collectRowErrors",
29604
+ "type": "boolean | undefined",
29605
+ "required": false,
29606
+ "description": "Собирать сводку ошибок по строкам окна видимости ({@link RowErrorsSummary}\nв `cellInfo.rowErrors`). Для сводки колонки с `isErrorCell` обходятся все,\nа не только видимые, поэтому включается только когда сводка кому-то нужна\n(столбец-индикатор ошибок)."
29607
+ },
28853
29608
  {
28854
29609
  "name": "containerClassName",
28855
29610
  "type": "string | undefined",
@@ -28956,6 +29711,12 @@
28956
29711
  "required": false,
28957
29712
  "description": "Эффекты при наведении. `hoverEffects.row` — подсветка строки под курсором:\nрисуется через bgCell (getRowThemeOverride), т.е. лежит ПОД селектингом и\nhighlightActiveType — они рисуются поверх (highlightRegions) и визуально\nперекрывают hover. По умолчанию row-подсветка ВКЛЮЧЕНА; выключение —\nявное `{ row: false }`."
28958
29713
  },
29714
+ {
29715
+ "name": "isErrorRow",
29716
+ "type": "((row: R) => boolean) | undefined",
29717
+ "required": false,
29718
+ "description": "Ошибка всей строки: одна красная рамка по всей ширине данных вместо\nпоячеечных рамок этой строки. Проверяется только для строк в окне\nвидимости, как и `isErrorCell`."
29719
+ },
28959
29720
  {
28960
29721
  "name": "onColumnSelectionApplied",
28961
29722
  "type": "(() => void) | undefined",
@@ -38954,6 +39715,13 @@
38954
39715
  "importStatement": "import { TextXS } from '@sber-digital-finance-ui/ui-kit';",
38955
39716
  "minimalUsage": "<TextXS />",
38956
39717
  "examples": [
39718
+ {
39719
+ "exportName": "Usage",
39720
+ "displayName": "Использование в TableCanvasLogger.stories.tsx",
39721
+ "type": "usage",
39722
+ "code": "<TextXS>Источник: {String(item.meta?.source)}</TextXS>",
39723
+ "sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.BottomSheet/Logger/TableCanvasLogger.stories.tsx"
39724
+ },
38957
39725
  {
38958
39726
  "exportName": "Vendor",
38959
39727
  "displayName": "Текст Текст Типографические элементы для описаний к статьям, дополнительной информации и т.д.",
@@ -46112,7 +46880,7 @@
46112
46880
  "name": "popoverProps",
46113
46881
  "type": "Omit<PropsType<{ view: { default: PolymorphicClassName; }; }> & React.HTMLAttributes<HTMLDivElement> & CustomPopoverProps & React.RefAttributes<HTMLDivElement>, \"onToggle\" | \"opened\" | \"target\"> | undefined",
46114
46882
  "required": false,
46115
- "description": "Пропсы для popover"
46883
+ "description": "Пропсы для popover.\n\n`resizable` по умолчанию включён: ширина 360–700px, высота от 430px до 80%\nокна, стартовый размер 360×430. Свой объект накладывается поверх этих\nзначений. Размеры меняйте здесь (`minWidth`, `maxWidth`, `minHeight`,\n`maxHeight`, `defaultSize`), а не стилями: при ресайзе CSS-ограничения\nразводят карточку и уголок ресайза.\n\n`resizable: false` выключает ресайз: ширина по содержимому 360–700px,\nвысота по содержимому до 80% окна, дальше прокрутка."
46116
46884
  },
46117
46885
  {
46118
46886
  "name": "redSquare",
@@ -46675,7 +47443,7 @@
46675
47443
  "name": "popoverProps",
46676
47444
  "type": "Omit<PropsType<{ view: { default: PolymorphicClassName; }; }> & React.HTMLAttributes<HTMLDivElement> & CustomPopoverProps & React.RefAttributes<HTMLDivElement>, \"onToggle\" | \"opened\" | \"target\"> | undefined",
46677
47445
  "required": false,
46678
- "description": "Пропсы для popover"
47446
+ "description": "Пропсы для popover.\n\n`resizable` по умолчанию включён: ширина 360–700px, высота от 430px до 80%\nокна, стартовый размер 360×430. Свой объект накладывается поверх этих\nзначений. Размеры меняйте здесь (`minWidth`, `maxWidth`, `minHeight`,\n`maxHeight`, `defaultSize`), а не стилями: при ресайзе CSS-ограничения\nразводят карточку и уголок ресайза.\n\n`resizable: false` выключает ресайз: ширина по содержимому 360–700px,\nвысота по содержимому до 80% окна, дальше прокрутка."
46679
47447
  },
46680
47448
  {
46681
47449
  "name": "redSquare",
@@ -47850,7 +48618,7 @@
47850
48618
  "name": "popoverProps",
47851
48619
  "type": "Omit<PropsType<{ view: { default: PolymorphicClassName; }; }> & React.HTMLAttributes<HTMLDivElement> & CustomPopoverProps & React.RefAttributes<HTMLDivElement>, \"opened\" | \"target\" | \"onToggle\"> | undefined",
47852
48620
  "required": false,
47853
- "description": "Пропсы для popover",
48621
+ "description": "Пропсы для popover.\n\n`resizable` по умолчанию включён: ширина 360–700px, высота от 430px до 80%\nокна, стартовый размер 360×430. Свой объект накладывается поверх этих\nзначений. Размеры меняйте здесь (`minWidth`, `maxWidth`, `minHeight`,\n`maxHeight`, `defaultSize`), а не стилями: при ресайзе CSS-ограничения\nразводят карточку и уголок ресайза.\n\n`resizable: false` выключает ресайз: ширина по содержимому 360–700px,\nвысота по содержимому до 80% окна, дальше прокрутка.",
47854
48622
  "default": "{}"
47855
48623
  },
47856
48624
  {
@@ -47942,7 +48710,7 @@
47942
48710
  "name": "popoverProps",
47943
48711
  "type": "Omit<PropsType<{ view: { default: PolymorphicClassName; }; }> & React.HTMLAttributes<HTMLDivElement> & CustomPopoverProps & React.RefAttributes<HTMLDivElement>, \"opened\" | \"target\" | \"onToggle\"> | undefined",
47944
48712
  "required": false,
47945
- "description": "Пропсы для popover",
48713
+ "description": "Пропсы для popover.\n\n`resizable` по умолчанию включён: ширина 360–700px, высота от 430px до 80%\nокна, стартовый размер 360×430. Свой объект накладывается поверх этих\nзначений. Размеры меняйте здесь (`minWidth`, `maxWidth`, `minHeight`,\n`maxHeight`, `defaultSize`), а не стилями: при ресайзе CSS-ограничения\nразводят карточку и уголок ресайза.\n\n`resizable: false` выключает ресайз: ширина по содержимому 360–700px,\nвысота по содержимому до 80% окна, дальше прокрутка.",
47946
48714
  "default": "{}"
47947
48715
  },
47948
48716
  {
@@ -48194,8 +48962,8 @@
48194
48962
  "toolbar",
48195
48963
  "filter bar"
48196
48964
  ],
48197
- "docs": "# FilterActions\n\nКомпозиция для создания панели фильтров и действий. Компонент предоставляет базовые строительные блоки (кнопки, поля поиска, Popover и т.д.), оставляя логику адаптивности и размещения за командой-пользователем.\n\n## Ключевые особенности\n\n- Набор строительных блоков: кнопки, поля поиска, Popover для фильтров\n- Compound-компоненты: `FiltersActions.FiltersButtonWithPopover`, `FiltersActions.ListOfFilters` и др.\n- Колбек `onResize` для отслеживания размеров контейнера\n- Хук `useFiltersList` для управления списком активных фильтров\n- Адаптивность опциональна — реализуется на стороне проекта через `useAdaptiveFilters`\n\n## Основная структура\n\n```tsx\n<FiltersActions\n mainBlock={/* Основные фильтры, табы, сегменты */}\n activeButtonsBlock={/* Блок действий справа */}\n listOfFilters={/* Список примененных фильтров */}\n onResize={(dimensions) => {\n /* Отслеживание размеров */\n }}\n/>\n```\n\n## Об адаптивности\n\n**Важно:** Адаптивность фильтров **не является обязательной частью** компонента FiltersActions. Решение о том, какие фильтры показывать, куда перемещать и в каком порядке располагать — полностью на стороне команды-пользователя.\n\n### Пример адаптивности (необязательно)\n\nВ истории ниже показан **пример реализации адаптивности**, который можно взять за основу:\n\n#### 1. Колбек `onResize`\n\nКомпонент FiltersActions предоставляет колбек `onResize`, который возвращает актуальные размеры:\n\n```tsx\n<FiltersActions\n onResize={(dimensions) => {\n // dimensions.containerWidth - полная ширина\n // dimensions.mainBlockWidth - ширина левого блока\n // dimensions.buttonsBlockWidth - ширина правого блока\n // dimensions.availableMainBlockWidth - доступная ширина для фильтров\n }}\n/>\n```\n\n#### 2. Хук `useAdaptiveFilters`\n\nХук принимает массив элементов (`FilterItem[]`), текущую ширину и конфигурацию брейкпоинтов:\n\n```tsx\nconst { visibleItems, overlayItems, modifications, customActions } =\n useAdaptiveFilters({\n items: allFilterItems, // Массив всех фильтров\n width: dimensions.availableMainBlockWidth, // Доступная ширина\n breakpoints: {\n 1920: {\n visible: ['search', 'filter1', 'filter2'], // Видимые ID\n inOverlay: ['filter3'], // ID в Popover\n modifications: {\n // Модификации стилей\n search: { width: '300px' },\n },\n },\n 1400: {\n visible: ['search'],\n inOverlay: ['filter1', 'filter2', 'filter3'],\n },\n },\n });\n```\n\nХук определяет на основании ширины контейнера:\n\n- Какие элементы остаются видимыми (`visibleItems`)\n- Какие перемещаются в Popover (`overlayItems`)\n- Какие модификации применить (`modifications`)\n- Дополнительные действия (`customActions`)\n\n#### 3. Контент Popover\n\n**Контент Popover полностью контролируется использующей стороной:**\n\n```tsx\n<FiltersActions.FiltersButtonWithPopover\n content={\n // ВЫ решаете, что рендерить внутри\n overlayItems.map((item) => (\n <div key={item.id}>{item.element}</div>\n ))\n }\n footer={\n // ВЫ решаете, что показывать в footer\n <Button onClick={resetAll}>Сбросить</Button>\n }\n/>\n```\n\n### Кастомизация кнопки Popover\n\nПо умолчанию кнопка-таргет `FiltersActions.FiltersButtonWithPopover` рендерится с текстом «Ещё фильтры» и иконкой размера `s`. Через проп `buttonProps` можно переопределить поведение кнопки:\n\n```tsx\n// Скрыть текст — останется только иконка\n<FiltersActions.FiltersButtonWithPopover\n buttonProps={{ hideLabel: true }}\n/>\n\n// Поменять текст и размер иконки\n<FiltersActions.FiltersButtonWithPopover\n buttonProps={{ text: 'Фильтры', iconSize: 'xs' }}\n/>\n\n// Заблокировать кнопку\n<FiltersActions.FiltersButtonWithPopover\n buttonProps={{ disabled: true }}\n/>\n```\n\nПринимает любые пропсы `FiltersActionsFiltersButton`. `onClick` декорируется — сначала вызовется внешний, потом внутренний toggle Popover.\n\n### Кастомный таргет Popover — `renderTarget`\n\nКогда `buttonProps` недостаточно и нужно полностью заменить кнопку-таргет собственным элементом (иконкой, кнопкой, любым узлом) — используйте рендер-проп `renderTarget`. Он оставляет за компонентом логику открытия Popover и красную точку-индикатор, а разметку таргета отдаёт вам.\n\n`renderTarget` получает объект `FilterTargetRenderApi`:\n\n- **`onClick`** — обработчик открытия/закрытия Popover. **Обязательно** повесьте его на корневой кликабельный элемент таргета — иначе Popover не откроется.\n- **`isOpen`** — открыт ли Popover сейчас (например, чтобы подсветить активный таргет).\n- **`isRedDotVisible`** — нужно ли показывать красную точку (значение пропа `redSquare`).\n- **`RedDot`** — компонент точки-индикатора. Позиционируется в правый верхний угол ближайшего контейнера с `position: relative`.\n\n```tsx\n<FiltersActions.FiltersButtonWithPopover\n title=\"Фильтры\"\n redSquare={hasActiveFilters}\n renderTarget={({ onClick, isOpen, isRedDotVisible, RedDot }) => (\n <IconButton\n onClick={onClick}\n size=\"s\"\n view={isOpen ? 'accent' : 'secondary'}\n style={{ position: 'relative' }} // Важно — якорь для RedDot\n >\n <IconSettingsFilter size=\"s\" />\n <RedDot visible={isRedDotVisible} />\n </IconButton>\n )}\n content={/* ... */}\n/>\n```\n\nКогда задан `renderTarget`, проп `buttonProps` и дефолтная кнопка «Ещё фильтры» игнорируются. Красную точку рисуете вы — компонент `RedDot` доступен и в API рендер-пропа, и как `FiltersActions.RedDot`, вид индикатора остаётся единым.\n\nЖивой пример — в истории **«FiltersActions с кастомным таргетом Popover»** ниже.\n\n## Размещение фильтров внутри Popover\n\n**Контент Popover (`FiltersActions.FiltersButtonWithPopover`) полностью контролируется использующей стороной.** Компонент предоставляет layout (шапка, контент, футер) — всё остальное (логика, стили, компоненты) реализуется на стороне проекта.\n\nНиже — рекомендации, которые помогут избежать типичных проблем с шириной и позиционированием элементов внутри Popover.\n\n### 1. Реф на Popover — `popoverRef`\n\nСоздайте реф и передайте его в `popoverProps.ref`. Этот реф нужен дочерним компонентам внутри Popover:\n\n```tsx\nconst popoverRef = useRef<HTMLDivElement>(null);\n\n<FiltersActions.FiltersButtonWithPopover\n popoverProps={{ ref: popoverRef }} // Важно\n content={...}\n/>\n```\n\n**Зачем:** Popover рендерится через портал (вне основного DOM-дерева). Без `popoverRef` выпадающие списки Combobox и тултипы будут рендериться в основном дереве — позади Popover или с обрезкой по `overflow`.\n\n### 2. Combobox: `portal` и `zIndex`\n\nКаждому Combobox внутри Popover передайте `portal={popoverRef}` и `zIndex=\"9001\"`:\n\n```tsx\n<Combobox\n portal={popoverRef} // Важно — dropdown рендерится внутри Popover\n zIndex=\"9001\" // Важно — dropdown поверх контента Popover\n ...\n/>\n```\n\n### 3. TooltipList: `frame` и `fullWidth`\n\nЕсли Combobox обёрнут в `FiltersActions.TooltipList`, передайте `frame={popoverRef}` и `fullWidth`:\n\n```tsx\n<FiltersActions.TooltipList\n groupLabel=\"Название фильтра\"\n fullWidth // Важно — растягивает обёртки тултипа на 100% ширины\n frame={popoverRef} // Важно — тултип позиционируется внутри Popover\n items={selectedLabels}\n trigger={selectedValues.length > 0 ? 'hover' : 'none'}\n>\n ...\n</FiltersActions.TooltipList>\n```\n\nПроп `fullWidth` устанавливает `width: 100%` на внутренние обёртки Tooltip (`.popover-target`, `.popover-wrapper`), чтобы дочерний элемент занял всю доступную ширину контента Popover.\n\n### 4. Combobox: обёртка `div` с `width: 100%`\n\nCombobox по умолчанию занимает ширину по содержимому. Оберните его в `div` с `width: 100%`:\n\n```tsx\n<div style={{ width: '100%' }}>\n <Combobox\n portal={popoverRef}\n zIndex=\"9001\"\n ...\n />\n</div>\n```\n\n### 5. Контейнер каждого фильтра\n\nКаждый элемент внутри `content` оберните в `div` с `width: 100%`:\n\n```tsx\ncontent={\n <>\n {overlayItems.map((item) => (\n <div key={item.id} style={{ width: '100%' }}>\n <BodyS style={{ marginBottom: '8px' }}>{item.label}</BodyS>\n {item.element}\n </div>\n ))}\n </>\n}\n```\n\n### Итого: полный пример фильтра в Popover\n\n```tsx\nconst popoverRef = useRef<HTMLDivElement>(null);\n\n<FiltersActions.FiltersButtonWithPopover\n popoverProps={{ ref: popoverRef }}\n title=\"Фильтры\"\n content={\n <div style={{ width: '100%' }}>\n <BodyS style={{ marginBottom: '8px' }}>Блок</BodyS>\n <FiltersActions.TooltipList\n groupLabel=\"Блок\"\n fullWidth\n frame={popoverRef}\n items={selectedBlockLabels}\n trigger={blocks.length > 0 ? 'hover' : 'none'}\n >\n <div style={{ width: '100%' }}>\n <Combobox\n size=\"s\"\n multiple\n value={blocks}\n onChange={setBlocks}\n items={blockOptions}\n portal={popoverRef}\n zIndex=\"9001\"\n />\n </div>\n </FiltersActions.TooltipList>\n </div>\n }\n/>\n```\n\n## Хук `useFiltersList`\n\nБазовый хук для управления списком активных фильтров. Принимает текущие значения фильтров, метаинформацию и опции — возвращает готовый список для отображения в `FiltersActions.ListOfFilters`, а также функцию сброса.\n\n```tsx\nconst { filterList, filterListOpened, clearAll } = useFiltersList({\n filters,\n filtersInfo: {\n search: { label: 'Поиск', clearedValue: '' },\n blocks: { label: 'Блок', clearedValue: [] },\n tribes: { label: 'Трайб', clearedValue: [] },\n allocation: { label: 'Аллокация', clearedValue: '' },\n },\n options: {\n blocks: blocksOptions,\n tribes: tribesOptions,\n allocation: allocationOptions,\n },\n updateFilters: (key, newValue) => updateFilters({ [key]: newValue }),\n order: ['switcher'], // опционально: порядок отображения групп\n});\n```\n\n**Параметры:**\n\n- **`filters`** — объект с текущими значениями фильтров (`Record<FilterKey, unknown>`)\n- **`filtersInfo`** — метаинформация: `label` (отображаемое имя группы) и `clearedValue` (значение при сбросе)\n- **`options`** — массивы `{ label, value }` для каждого фильтра (используются для маппинга value → label)\n- **`updateFilters`** — колбек для обновления конкретного фильтра\n- **`order`** — порядок отображения групп: массив ключей, функция сортировки или `'default'`\n\n**Возвращает:**\n\n- **`filterList`** — массив групп с элементами (для передачи в `ListOfFilters`)\n- **`filterListOpened`** — `true`, если есть хотя бы один активный фильтр\n- **`clearAll`** — функция сброса всех фильтров в `clearedValue`\n\n### Резюме\n\n- **FiltersActions** — набор строительных блоков\n- **`useFiltersList`** — хук для управления списком активных фильтров\n- **Адаптивность** — опциональная, реализуется на стороне проекта\n- **`onResize`** — для получения размеров контейнера\n- **`useAdaptiveFilters`** — пример хука для управления брейкпоинтами\n- **Контент Popover** — ответственность проекта\n- **`buttonProps`** — кастомизация кнопки-таргета Popover\n- **`renderTarget`** — полная замена таргета Popover своим элементом (с сохранением открытия и красной точки)\n\n---\n\nОписание compound-компонентов и информация о ренейминге — в разделе [API](/docs/композиции-filtersactions-api--docs).",
48198
- "apiDocs": "# FiltersActions API\n\nКомпонент `FiltersActions` построен на основе **compound-паттерна**. Корневой компонент предоставляет набор вложенных компонентов для сборки панели фильтров.\n\n## FiltersActionsProps\n\n```typescript\ntype FiltersActionsProps = {\n /**\n * блок фильтров и табов\n * */\n mainBlock?: React.ReactNode;\n\n /**\n * блок активных действий\n * */\n activeButtonsBlock?: React.ReactNode;\n\n /**\n * блок списка примененных фильтров\n * */\n listOfFilters?: React.ReactNode;\n\n /**\n * пропс для ширины для дочерних элементов - слева направо (Например, \"auto 30% 30%\")\n * */\n mainBlockElementsWidth?: string;\n\n /**\n * пропсы для контейнера всего компонента\n * */\n containerProps?: BoxProps;\n\n /**\n * пропсы для контейнера блока фильтров и табов\n * */\n mainBlockProps?: BoxProps;\n /**\n * Колбэк, вызываемый при изменении размеров блоков\n * Получает актуальные размеры контейнера, mainBlock и buttonsBlock\n */\n onResize?: (dimensions: FiltersActionsResizeDimensions) => void;\n};\n```\n\n## FiltersActionsResizeDimensions\n\n```typescript\ninterface FiltersActionsResizeDimensions {\n /** Полная ширина контейнера */\n containerWidth: number;\n /** Ширина левого блока (mainBlock) - вычисляется как containerWidth - buttonsBlockWidth - gap */\n mainBlockWidth: number;\n /** Ширина правого блока (activeButtonsBlock), 0 если блок отсутствует */\n buttonsBlockWidth: number;\n /** Доступная ширина для элементов mainBlock (за вычетом padding и gap) */\n availableMainBlockWidth: number;\n}\n```\n\n## Compound-компоненты\n\n### FiltersActions.FiltersButton\n\nКнопка фильтра. Наследует пропсы `Button` из `@salutejs/sdds-finai`.\n\n```typescript\ntype FiltersActionsFiltersButtonProps = ButtonCompProps & {\n redSquare?: boolean;\n hideLabel?: boolean;\n iconSize?: ComponentProps<typeof Icon>['size'];\n};\n```\n\n### FiltersActions.FiltersButtonWithPopover\n\nКнопка с Popover для содержимого фильтра.\n\n```typescript\ntype FiltersActionsFiltersButtonWithPopoverProps = {\n /** Заголовок Popover */\n title: string;\n /** Подзаголовок (опционально) */\n subtitle?: string;\n /** Основной контент для отображения */\n content?: React.ReactNode;\n /** Внешнее состояние открытия/закрытия [isOpen, setIsOpen] */\n state?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /** Callback при закрытии */\n onClose?: () => void;\n /** Контент footer (опционально) */\n footer?: React.ReactNode;\n /** Красный индикатор на кнопке фильтров */\n redSquare?: boolean;\n /**\n * Включить поиск\n */\n searchable?: boolean;\n /**\n * Значение поиска (контролируемый режим)\n */\n searchValue?: string;\n /**\n * Callback изменения поискового запроса\n */\n onSearchChange?: (value: string) => void;\n /**\n * Пропсы для поля поиска\n */\n searchingProps?: Pick<\n TextFieldProps,\n | 'placeholder'\n | 'onBlur'\n | 'onFocus'\n | 'contentLeft'\n | 'contentRight'\n | 'textBefore'\n | 'textAfter'\n | 'name'\n | 'type'\n | 'minLength'\n | 'maxLength'\n >;\n /**\n * Контент отображаемый когда ничего не найдено\n */\n emptySearchContent?: React.ReactNode;\n /**\n * Пропсы для popover\n */\n popoverProps?: Omit<CompPopoverProps, 'opened' | 'target' | 'onToggle'>;\n /** Пропсы для кнопки-таргета FiltersActionsFiltersButton. onClick декорируется: сначала вызовется внешний, потом внутренний toggle. */\n buttonProps?: Partial<FiltersActionsFiltersButtonProps>;\n /**\n * Рендер-проп для полной замены кнопки-таргета Popover собственным элементом\n * (иконкой, кнопкой, любым узлом) — при сохранении нативной логики открытия\n * Popover и красной точки-индикатора. Когда задан, `buttonProps` и дефолтная\n * кнопка «Ещё фильтры» игнорируются.\n *\n * ВАЖНО: повесьте переданный `onClick` на корневой кликабельный элемент вашего\n * таргета. Для красной точки оберните таргет в контейнер с `position: relative`\n * и отрендерьте `<RedDot visible={isRedDotVisible} />`.\n *\n * @example\n * renderTarget={({ onClick, isRedDotVisible, RedDot }) => (\n * <IconButton onClick={onClick} style={{ position: 'relative' }}>\n * <IconSettingsFilter />\n * <RedDot visible={isRedDotVisible} />\n * </IconButton>\n * )}\n */\n renderTarget?: (api: FilterTargetRenderApi) => React.ReactElement;\n};\n```\n\n#### FilterTargetRenderApi\n\nАргумент рендер-пропа `renderTarget` — «рычаги» для сборки собственного таргета Popover (иконки, кнопки, любого элемента) с сохранением логики открытия и красной точки-индикатора. Подробнее — в разделе Docs, «Кастомный таргет Popover».\n\n```typescript\ntype FilterTargetRenderApi = {\n /**\n * Обработчик открытия/закрытия Popover. Повесьте его на `onClick` корневого\n * кликабельного элемента вашего таргета — иначе Popover не будет открываться.\n */\n onClick: (event?: React.MouseEvent) => void;\n /** Открыт ли Popover сейчас — удобно для смены вида таргета в активном состоянии. */\n isOpen: boolean;\n /**\n * Нужно ли показывать красную точку-индикатор (значение пропа `redSquare`).\n * Передайте в `<RedDot visible={isRedDotVisible} />`.\n */\n isRedDotVisible: boolean;\n /**\n * Компонент красной точки-индикатора. Позиционируется абсолютно в правый\n * верхний угол ближайшего контейнера с `position: relative`.\n */\n RedDot: typeof RedDot;\n};\n```\n\n### FiltersActions.RedDot\n\nКрасная точка-индикатор активных фильтров. Позиционируется абсолютно в правом верхнем углу контейнера с `position: relative`. Приходит в `renderTarget` (поле `RedDot`), но доступна и как `FiltersActions.RedDot` для использования на своём таргете.\n\n```typescript\ntype RedDotProps = {\n /** Показывать ли точку. Обычно прокидывается из `isRedDotVisible` рендер-API. */\n visible?: boolean;\n /**\n * Смещение точки от правого верхнего угла контейнера (top/right).\n * По умолчанию `0` — точка прижата к углу.\n */\n offset?: string | number;\n};\n```\n\n### FiltersActions.DotsIconButton\n\nКнопка-иконка «три точки» с выпадающим меню. Наследует пропсы `IconButton` из `@salutejs/sdds-finai`.\n\n```typescript\ntype FiltersActionsDotsIconButtonProps = ComponentProps<\n typeof IconButton\n> & {\n /** Пропсы выпадающего меню */\n dropdownProps?: ComponentProps<typeof Dropdown>;\n /** Размер иконки */\n iconSize?: ComponentProps<typeof Icon>['size'];\n};\n```\n\n### FiltersActions.ListOfFilters\n\nСписок применённых фильтров (чипы).\n\n```typescript\ntype ListOfFiltersProps = {\n opened: boolean;\n clearAll: () => void;\n items: ItemOrGroup[];\n size?: 'xs';\n paddingTop?: number;\n /**\n * @default maxLengthInGroup=2\n */\n maxLengthInGroup?: number;\n /**\n * Обрезает название группы фильтров в одну строку с троеточием.\n * @default false\n */\n ellipsisLabel?: boolean;\n sizeOnOpen?: number;\n leftSlot?: ReactNode;\n paddingInline?: number;\n maxHeight?: number;\n extraCss?: React.CSSProperties;\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n renderGroupLabel?: (group: Group) => string;\n renderChipLabel?: (group: Group | null, item: Item) => string;\n /**\n * Показывать ли кнопку \"Сбросить все\" в блоке примененных фильтров\n * @default true\n */\n showResetAllFiltersButton?: boolean;\n};\n```\n\n### FiltersActions.TextFieldSearch\n\nПоле поиска. Наследует пропсы `TextField` из `@salutejs/sdds-finai`.\n\n```typescript\ntype TextFieldSearchProps = ComponentProps<typeof TextField> &\n TextFieldSearchBaseProps;\n```\n\n### FiltersActions.Tabs\n\nКонтейнер табов. Наследует пропсы `Tabs` из `@salutejs/sdds-finai`. Размер по умолчанию: `xs`, вид: `filled`.\n\n```typescript\ntype FiltersActionsTabsProps = TabsProps & {\n /** Кастомные стили */\n $css?: CSSObject | TemplateStringsArray;\n};\n```\n\n### FiltersActions.TabItem\n\nЭлемент таба. Наследует пропсы `TabItem` из `@salutejs/sdds-finai`. Размер по умолчанию: `s`, вид: `default`.\n\n```typescript\ntype FiltersActionsTabItemProps = TabItemProps & {\n /** Кастомные стили */\n $css?: CSSObject | TemplateStringsArray;\n};\n```\n\n### FiltersActions.SegmentItem\n\nЭлемент сегмента. Наследует пропсы `SegmentItem` из `@salutejs/sdds-finai`. Размер по умолчанию: `s`, вид: `default`.\n\n```typescript\ntype FiltersActionsSegmentItemProps = SegmentItemProps & {\n /** Кастомные стили */\n $css?: CSSObject | TemplateStringsArray;\n};\n```\n\n### FiltersActions.TooltipList\n\nТултип со списком элементов. Наследует пропсы `Tooltip` из `@salutejs/sdds-finai` (кроме `text` и `children`).\n\n```typescript\ninterface FiltersActionsTooltipProps\n extends Omit<TooltipProps, 'text' | 'children'> {\n groupLabel?: string;\n items: string[];\n children: React.ReactNode;\n}\n```\n\n### FiltersActions.ResetAllFiltersButton\n\nКнопка «Сбросить все фильтры». Наследует пропсы `LinkButton` из `@salutejs/sdds-finai`.\n\n```typescript\ntype ResetAllFiltersButtonProps = LinkButtonCompProps & {\n /** Видимость кнопки */\n isVisible?: boolean;\n /** Кастомные стили */\n $css?: CSSObject | TemplateStringsArray;\n};\n```\n\n### FiltersActions.SwitcherFilter\n\nПереключатель-фильтр. Наследует пропсы `Switch` из `@salutejs/sdds-finai`.\n\n```typescript\ntype SwitcherFilterProps = SwitchProps;\n```\n\n## Ренейминг\n\nВ целях улучшения читаемости и единообразия именования некоторые compound-компоненты были переименованы.\n\n**Обратная совместимость сохранена** — старые имена продолжают работать. Оба варианта ссылаются на один и тот же компонент. Рекомендуем использовать новые имена:\n\n- `FiltersActions.FilterPopover` → `FiltersActions.FiltersButtonWithPopover`\n- `FiltersActions.Tooltip` → `FiltersActions.TooltipList`\n\n```diff\n- <FiltersActions.FilterPopover\n+ <FiltersActions.FiltersButtonWithPopover\n content={...}\n footer={...}\n buttonProps={{ hideLabel: true }}\n />\n\n- <FiltersActions.Tooltip ... />\n+ <FiltersActions.TooltipList ... />\n```",
48965
+ "docs": "# FilterActions\n\nКомпозиция для создания панели фильтров и действий. Компонент предоставляет базовые строительные блоки (кнопки, поля поиска, Popover и т.д.), оставляя логику адаптивности и размещения за командой-пользователем.\n\n## Ключевые особенности\n\n- Набор строительных блоков: кнопки, поля поиска, Popover для фильтров\n- Compound-компоненты: `FiltersActions.FiltersButtonWithPopover`, `FiltersActions.ListOfFilters` и др.\n- Колбек `onResize` для отслеживания размеров контейнера\n- Хук `useFiltersList` для управления списком активных фильтров\n- Адаптивность опциональна — реализуется на стороне проекта через `useAdaptiveFilters`\n\n## Основная структура\n\n```tsx\n<FiltersActions\n mainBlock={/* Основные фильтры, табы, сегменты */}\n activeButtonsBlock={/* Блок действий справа */}\n listOfFilters={/* Список примененных фильтров */}\n onResize={(dimensions) => {\n /* Отслеживание размеров */\n }}\n/>\n```\n\n## Об адаптивности\n\n**Важно:** Адаптивность фильтров **не является обязательной частью** компонента FiltersActions. Решение о том, какие фильтры показывать, куда перемещать и в каком порядке располагать — полностью на стороне команды-пользователя.\n\n### Пример адаптивности (необязательно)\n\nВ истории ниже показан **пример реализации адаптивности**, который можно взять за основу:\n\n#### 1. Колбек `onResize`\n\nКомпонент FiltersActions предоставляет колбек `onResize`, который возвращает актуальные размеры:\n\n```tsx\n<FiltersActions\n onResize={(dimensions) => {\n // dimensions.containerWidth - полная ширина\n // dimensions.mainBlockWidth - ширина левого блока\n // dimensions.buttonsBlockWidth - ширина правого блока\n // dimensions.availableMainBlockWidth - доступная ширина для фильтров\n }}\n/>\n```\n\n#### 2. Хук `useAdaptiveFilters`\n\nХук принимает массив элементов (`FilterItem[]`), текущую ширину и конфигурацию брейкпоинтов:\n\n```tsx\nconst { visibleItems, overlayItems, modifications, customActions } =\n useAdaptiveFilters({\n items: allFilterItems, // Массив всех фильтров\n width: dimensions.availableMainBlockWidth, // Доступная ширина\n breakpoints: {\n 1920: {\n visible: ['search', 'filter1', 'filter2'], // Видимые ID\n inOverlay: ['filter3'], // ID в Popover\n modifications: {\n // Модификации стилей\n search: { width: '300px' },\n },\n },\n 1400: {\n visible: ['search'],\n inOverlay: ['filter1', 'filter2', 'filter3'],\n },\n },\n });\n```\n\nХук определяет на основании ширины контейнера:\n\n- Какие элементы остаются видимыми (`visibleItems`)\n- Какие перемещаются в Popover (`overlayItems`)\n- Какие модификации применить (`modifications`)\n- Дополнительные действия (`customActions`)\n\n#### 3. Контент Popover\n\n**Контент Popover полностью контролируется использующей стороной:**\n\n```tsx\n<FiltersActions.FiltersButtonWithPopover\n content={\n // ВЫ решаете, что рендерить внутри\n overlayItems.map((item) => (\n <div key={item.id}>{item.element}</div>\n ))\n }\n footer={\n // ВЫ решаете, что показывать в footer\n <Button onClick={resetAll}>Сбросить</Button>\n }\n/>\n```\n\n### Кастомизация кнопки Popover\n\nПо умолчанию кнопка-таргет `FiltersActions.FiltersButtonWithPopover` рендерится с текстом «Ещё фильтры» и иконкой размера `s`. Через проп `buttonProps` можно переопределить поведение кнопки:\n\n```tsx\n// Скрыть текст — останется только иконка\n<FiltersActions.FiltersButtonWithPopover\n buttonProps={{ hideLabel: true }}\n/>\n\n// Поменять текст и размер иконки\n<FiltersActions.FiltersButtonWithPopover\n buttonProps={{ text: 'Фильтры', iconSize: 'xs' }}\n/>\n\n// Заблокировать кнопку\n<FiltersActions.FiltersButtonWithPopover\n buttonProps={{ disabled: true }}\n/>\n```\n\nПринимает любые пропсы `FiltersActionsFiltersButton`. `onClick` декорируется — сначала вызовется внешний, потом внутренний toggle Popover.\n\n### Кастомный таргет Popover — `renderTarget`\n\nКогда `buttonProps` недостаточно и нужно полностью заменить кнопку-таргет собственным элементом (иконкой, кнопкой, любым узлом) — используйте рендер-проп `renderTarget`. Он оставляет за компонентом логику открытия Popover и красную точку-индикатор, а разметку таргета отдаёт вам.\n\n`renderTarget` получает объект `FilterTargetRenderApi`:\n\n- **`onClick`** — обработчик открытия/закрытия Popover. **Обязательно** повесьте его на корневой кликабельный элемент таргета — иначе Popover не откроется.\n- **`isOpen`** — открыт ли Popover сейчас (например, чтобы подсветить активный таргет).\n- **`isRedDotVisible`** — нужно ли показывать красную точку (значение пропа `redSquare`).\n- **`RedDot`** — компонент точки-индикатора. Позиционируется в правый верхний угол ближайшего контейнера с `position: relative`.\n\n```tsx\n<FiltersActions.FiltersButtonWithPopover\n title=\"Фильтры\"\n redSquare={hasActiveFilters}\n renderTarget={({ onClick, isOpen, isRedDotVisible, RedDot }) => (\n <IconButton\n onClick={onClick}\n size=\"s\"\n view={isOpen ? 'accent' : 'secondary'}\n style={{ position: 'relative' }} // Важно — якорь для RedDot\n >\n <IconSettingsFilter size=\"s\" />\n <RedDot visible={isRedDotVisible} />\n </IconButton>\n )}\n content={/* ... */}\n/>\n```\n\nКогда задан `renderTarget`, проп `buttonProps` и дефолтная кнопка «Ещё фильтры» игнорируются. Красную точку рисуете вы — компонент `RedDot` доступен и в API рендер-пропа, и как `FiltersActions.RedDot`, вид индикатора остаётся единым.\n\nЖивой пример — в истории **«FiltersActions с кастомным таргетом Popover»** ниже.\n\n### Размер Popover — `popoverProps.resizable`\n\nПо умолчанию размер Popover можно менять, потянув за правый нижний уголок. Значения по умолчанию:\n\n- ширина от 360 до 700px;\n- высота от 430px до 80% высоты окна;\n- стартовый размер 360×430.\n\nСвои размеры передавайте объектом в `popoverProps.resizable`, он накладывается поверх значений по умолчанию:\n\n```tsx\n<FiltersActions.FiltersButtonWithPopover\n title=\"Фильтры\"\n popoverProps={{\n resizable: {\n maxWidth: 1000,\n defaultSize: { width: 480, height: 500 },\n },\n }}\n content={/* ... */}\n/>\n```\n\nОграничивайте размер только через `resizable` (`minWidth`, `maxWidth`, `minHeight`, `maxHeight`, `defaultSize`), а не через стили или `className`. Иначе карточка упрётся в CSS-границу раньше, чем область ресайза, и уголок ресайза останется в стороне от Popover.\n\nС `resizable: false` ресайз выключен, и размер берётся по содержимому: ширина от 360 до 700px, высота до 80% окна, дальше содержимое прокручивается.\n\n## Размещение фильтров внутри Popover\n\n**Контент Popover (`FiltersActions.FiltersButtonWithPopover`) полностью контролируется использующей стороной.** Компонент предоставляет layout (шапка, контент, футер) — всё остальное (логика, стили, компоненты) реализуется на стороне проекта.\n\nНиже — рекомендации, которые помогут избежать типичных проблем с шириной и позиционированием элементов внутри Popover.\n\n### 1. Реф на Popover — `popoverRef`\n\nСоздайте реф и передайте его в `popoverProps.ref`. Этот реф нужен дочерним компонентам внутри Popover:\n\n```tsx\nconst popoverRef = useRef<HTMLDivElement>(null);\n\n<FiltersActions.FiltersButtonWithPopover\n popoverProps={{ ref: popoverRef }} // Важно\n content={...}\n/>\n```\n\n**Зачем:** Popover рендерится через портал (вне основного DOM-дерева). Без `popoverRef` выпадающие списки Combobox и тултипы будут рендериться в основном дереве — позади Popover или с обрезкой по `overflow`.\n\n### 2. Combobox: `portal` и `zIndex`\n\nКаждому Combobox внутри Popover передайте `portal={popoverRef}` и `zIndex=\"9001\"`:\n\n```tsx\n<Combobox\n portal={popoverRef} // Важно — dropdown рендерится внутри Popover\n zIndex=\"9001\" // Важно — dropdown поверх контента Popover\n ...\n/>\n```\n\n### 3. TooltipList: `frame` и `fullWidth`\n\nЕсли Combobox обёрнут в `FiltersActions.TooltipList`, передайте `frame={popoverRef}` и `fullWidth`:\n\n```tsx\n<FiltersActions.TooltipList\n groupLabel=\"Название фильтра\"\n fullWidth // Важно — растягивает обёртки тултипа на 100% ширины\n frame={popoverRef} // Важно — тултип позиционируется внутри Popover\n items={selectedLabels}\n trigger={selectedValues.length > 0 ? 'hover' : 'none'}\n>\n ...\n</FiltersActions.TooltipList>\n```\n\nПроп `fullWidth` устанавливает `width: 100%` на внутренние обёртки Tooltip (`.popover-target`, `.popover-wrapper`), чтобы дочерний элемент занял всю доступную ширину контента Popover.\n\n### 4. Combobox: обёртка `div` с `width: 100%`\n\nCombobox по умолчанию занимает ширину по содержимому. Оберните его в `div` с `width: 100%`:\n\n```tsx\n<div style={{ width: '100%' }}>\n <Combobox\n portal={popoverRef}\n zIndex=\"9001\"\n ...\n />\n</div>\n```\n\n### 5. Контейнер каждого фильтра\n\nКаждый элемент внутри `content` оберните в `div` с `width: 100%`:\n\n```tsx\ncontent={\n <>\n {overlayItems.map((item) => (\n <div key={item.id} style={{ width: '100%' }}>\n <BodyS style={{ marginBottom: '8px' }}>{item.label}</BodyS>\n {item.element}\n </div>\n ))}\n </>\n}\n```\n\n### Итого: полный пример фильтра в Popover\n\n```tsx\nconst popoverRef = useRef<HTMLDivElement>(null);\n\n<FiltersActions.FiltersButtonWithPopover\n popoverProps={{ ref: popoverRef }}\n title=\"Фильтры\"\n content={\n <div style={{ width: '100%' }}>\n <BodyS style={{ marginBottom: '8px' }}>Блок</BodyS>\n <FiltersActions.TooltipList\n groupLabel=\"Блок\"\n fullWidth\n frame={popoverRef}\n items={selectedBlockLabels}\n trigger={blocks.length > 0 ? 'hover' : 'none'}\n >\n <div style={{ width: '100%' }}>\n <Combobox\n size=\"s\"\n multiple\n value={blocks}\n onChange={setBlocks}\n items={blockOptions}\n portal={popoverRef}\n zIndex=\"9001\"\n />\n </div>\n </FiltersActions.TooltipList>\n </div>\n }\n/>\n```\n\n## Хук `useFiltersList`\n\nБазовый хук для управления списком активных фильтров. Принимает текущие значения фильтров, метаинформацию и опции — возвращает готовый список для отображения в `FiltersActions.ListOfFilters`, а также функцию сброса.\n\n```tsx\nconst { filterList, filterListOpened, clearAll } = useFiltersList({\n filters,\n filtersInfo: {\n search: { label: 'Поиск', clearedValue: '' },\n blocks: { label: 'Блок', clearedValue: [] },\n tribes: { label: 'Трайб', clearedValue: [] },\n allocation: { label: 'Аллокация', clearedValue: '' },\n },\n options: {\n blocks: blocksOptions,\n tribes: tribesOptions,\n allocation: allocationOptions,\n },\n updateFilters: (key, newValue) => updateFilters({ [key]: newValue }),\n order: ['switcher'], // опционально: порядок отображения групп\n});\n```\n\n**Параметры:**\n\n- **`filters`** — объект с текущими значениями фильтров (`Record<FilterKey, unknown>`)\n- **`filtersInfo`** — метаинформация: `label` (отображаемое имя группы) и `clearedValue` (значение при сбросе)\n- **`options`** — массивы `{ label, value }` для каждого фильтра (используются для маппинга value → label)\n- **`updateFilters`** — колбек для обновления конкретного фильтра\n- **`order`** — порядок отображения групп: массив ключей, функция сортировки или `'default'`\n\n**Возвращает:**\n\n- **`filterList`** — массив групп с элементами (для передачи в `ListOfFilters`)\n- **`filterListOpened`** — `true`, если есть хотя бы один активный фильтр\n- **`clearAll`** — функция сброса всех фильтров в `clearedValue`\n\n### Резюме\n\n- **FiltersActions** — набор строительных блоков\n- **`useFiltersList`** — хук для управления списком активных фильтров\n- **Адаптивность** — опциональная, реализуется на стороне проекта\n- **`onResize`** — для получения размеров контейнера\n- **`useAdaptiveFilters`** — пример хука для управления брейкпоинтами\n- **Контент Popover** — ответственность проекта\n- **`buttonProps`** — кастомизация кнопки-таргета Popover\n- **`renderTarget`** — полная замена таргета Popover своим элементом (с сохранением открытия и красной точки)\n\n---\n\nОписание compound-компонентов и информация о ренейминге — в разделе [API](/docs/композиции-filtersactions-api--docs).",
48966
+ "apiDocs": "# FiltersActions API\n\nКомпонент `FiltersActions` построен на основе **compound-паттерна**. Корневой компонент предоставляет набор вложенных компонентов для сборки панели фильтров.\n\n## FiltersActionsProps\n\n```typescript\ntype FiltersActionsProps = {\n /**\n * блок фильтров и табов\n * */\n mainBlock?: React.ReactNode;\n\n /**\n * блок активных действий\n * */\n activeButtonsBlock?: React.ReactNode;\n\n /**\n * блок списка примененных фильтров\n * */\n listOfFilters?: React.ReactNode;\n\n /**\n * пропс для ширины для дочерних элементов - слева направо (Например, \"auto 30% 30%\")\n * */\n mainBlockElementsWidth?: string;\n\n /**\n * пропсы для контейнера всего компонента\n * */\n containerProps?: BoxProps;\n\n /**\n * пропсы для контейнера блока фильтров и табов\n * */\n mainBlockProps?: BoxProps;\n /**\n * Колбэк, вызываемый при изменении размеров блоков\n * Получает актуальные размеры контейнера, mainBlock и buttonsBlock\n */\n onResize?: (dimensions: FiltersActionsResizeDimensions) => void;\n};\n```\n\n## FiltersActionsResizeDimensions\n\n```typescript\ninterface FiltersActionsResizeDimensions {\n /** Полная ширина контейнера */\n containerWidth: number;\n /** Ширина левого блока (mainBlock) - вычисляется как containerWidth - buttonsBlockWidth - gap */\n mainBlockWidth: number;\n /** Ширина правого блока (activeButtonsBlock), 0 если блок отсутствует */\n buttonsBlockWidth: number;\n /** Доступная ширина для элементов mainBlock (за вычетом padding и gap) */\n availableMainBlockWidth: number;\n}\n```\n\n## Compound-компоненты\n\n### FiltersActions.FiltersButton\n\nКнопка фильтра. Наследует пропсы `Button` из `@salutejs/sdds-finai`.\n\n```typescript\ntype FiltersActionsFiltersButtonProps = ButtonCompProps & {\n redSquare?: boolean;\n hideLabel?: boolean;\n iconSize?: ComponentProps<typeof Icon>['size'];\n};\n```\n\n### FiltersActions.FiltersButtonWithPopover\n\nКнопка с Popover для содержимого фильтра.\n\n```typescript\ntype FiltersActionsFiltersButtonWithPopoverProps = {\n /** Заголовок Popover */\n title: string;\n /** Подзаголовок (опционально) */\n subtitle?: string;\n /** Основной контент для отображения */\n content?: React.ReactNode;\n /** Внешнее состояние открытия/закрытия [isOpen, setIsOpen] */\n state?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /** Callback при закрытии */\n onClose?: () => void;\n /** Контент footer (опционально) */\n footer?: React.ReactNode;\n /** Красный индикатор на кнопке фильтров */\n redSquare?: boolean;\n /**\n * Включить поиск\n */\n searchable?: boolean;\n /**\n * Значение поиска (контролируемый режим)\n */\n searchValue?: string;\n /**\n * Callback изменения поискового запроса\n */\n onSearchChange?: (value: string) => void;\n /**\n * Пропсы для поля поиска\n */\n searchingProps?: Pick<\n TextFieldProps,\n | 'placeholder'\n | 'onBlur'\n | 'onFocus'\n | 'contentLeft'\n | 'contentRight'\n | 'textBefore'\n | 'textAfter'\n | 'name'\n | 'type'\n | 'minLength'\n | 'maxLength'\n >;\n /**\n * Контент отображаемый когда ничего не найдено\n */\n emptySearchContent?: React.ReactNode;\n /**\n * Пропсы для popover.\n *\n * `resizable` по умолчанию включён: ширина 360–700px, высота от 430px до 80%\n * окна, стартовый размер 360×430. Свой объект накладывается поверх этих\n * значений. Размеры меняйте здесь (`minWidth`, `maxWidth`, `minHeight`,\n * `maxHeight`, `defaultSize`), а не стилями: при ресайзе CSS-ограничения\n * разводят карточку и уголок ресайза.\n *\n * `resizable: false` выключает ресайз: ширина по содержимому 360–700px,\n * высота по содержимому до 80% окна, дальше прокрутка.\n */\n popoverProps?: Omit<CompPopoverProps, 'opened' | 'target' | 'onToggle'>;\n /** Пропсы для кнопки-таргета FiltersActionsFiltersButton. onClick декорируется: сначала вызовется внешний, потом внутренний toggle. */\n buttonProps?: Partial<FiltersActionsFiltersButtonProps>;\n /**\n * Рендер-проп для полной замены кнопки-таргета Popover собственным элементом\n * (иконкой, кнопкой, любым узлом) — при сохранении нативной логики открытия\n * Popover и красной точки-индикатора. Когда задан, `buttonProps` и дефолтная\n * кнопка «Ещё фильтры» игнорируются.\n *\n * ВАЖНО: повесьте переданный `onClick` на корневой кликабельный элемент вашего\n * таргета. Для красной точки оберните таргет в контейнер с `position: relative`\n * и отрендерьте `<RedDot visible={isRedDotVisible} />`.\n *\n * @example\n * renderTarget={({ onClick, isRedDotVisible, RedDot }) => (\n * <IconButton onClick={onClick} style={{ position: 'relative' }}>\n * <IconSettingsFilter />\n * <RedDot visible={isRedDotVisible} />\n * </IconButton>\n * )}\n */\n renderTarget?: (api: FilterTargetRenderApi) => React.ReactElement;\n};\n```\n\n#### FilterTargetRenderApi\n\nАргумент рендер-пропа `renderTarget` — «рычаги» для сборки собственного таргета Popover (иконки, кнопки, любого элемента) с сохранением логики открытия и красной точки-индикатора. Подробнее — в разделе Docs, «Кастомный таргет Popover».\n\n```typescript\ntype FilterTargetRenderApi = {\n /**\n * Обработчик открытия/закрытия Popover. Повесьте его на `onClick` корневого\n * кликабельного элемента вашего таргета — иначе Popover не будет открываться.\n */\n onClick: (event?: React.MouseEvent) => void;\n /** Открыт ли Popover сейчас — удобно для смены вида таргета в активном состоянии. */\n isOpen: boolean;\n /**\n * Нужно ли показывать красную точку-индикатор (значение пропа `redSquare`).\n * Передайте в `<RedDot visible={isRedDotVisible} />`.\n */\n isRedDotVisible: boolean;\n /**\n * Компонент красной точки-индикатора. Позиционируется абсолютно в правый\n * верхний угол ближайшего контейнера с `position: relative`.\n */\n RedDot: typeof RedDot;\n};\n```\n\n### FiltersActions.RedDot\n\nКрасная точка-индикатор активных фильтров. Позиционируется абсолютно в правом верхнем углу контейнера с `position: relative`. Приходит в `renderTarget` (поле `RedDot`), но доступна и как `FiltersActions.RedDot` для использования на своём таргете.\n\n```typescript\ntype RedDotProps = {\n /** Показывать ли точку. Обычно прокидывается из `isRedDotVisible` рендер-API. */\n visible?: boolean;\n /**\n * Смещение точки от правого верхнего угла контейнера (top/right).\n * По умолчанию `0` — точка прижата к углу.\n */\n offset?: string | number;\n};\n```\n\n### FiltersActions.DotsIconButton\n\nКнопка-иконка «три точки» с выпадающим меню. Наследует пропсы `IconButton` из `@salutejs/sdds-finai`.\n\n```typescript\ntype FiltersActionsDotsIconButtonProps = ComponentProps<\n typeof IconButton\n> & {\n /** Пропсы выпадающего меню */\n dropdownProps?: ComponentProps<typeof Dropdown>;\n /** Размер иконки */\n iconSize?: ComponentProps<typeof Icon>['size'];\n};\n```\n\n### FiltersActions.ListOfFilters\n\nСписок применённых фильтров (чипы).\n\n```typescript\ntype ListOfFiltersProps = {\n opened: boolean;\n clearAll: () => void;\n items: ItemOrGroup[];\n size?: 'xs';\n paddingTop?: number;\n /**\n * @default maxLengthInGroup=2\n */\n maxLengthInGroup?: number;\n /**\n * Обрезает название группы фильтров в одну строку с троеточием.\n * @default false\n */\n ellipsisLabel?: boolean;\n sizeOnOpen?: number;\n leftSlot?: ReactNode;\n paddingInline?: number;\n maxHeight?: number;\n extraCss?: React.CSSProperties;\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n renderGroupLabel?: (group: Group) => string;\n renderChipLabel?: (group: Group | null, item: Item) => string;\n /**\n * Показывать ли кнопку \"Сбросить все\" в блоке примененных фильтров\n * @default true\n */\n showResetAllFiltersButton?: boolean;\n};\n```\n\n### FiltersActions.TextFieldSearch\n\nПоле поиска. Наследует пропсы `TextField` из `@salutejs/sdds-finai`.\n\n```typescript\ntype TextFieldSearchProps = ComponentProps<typeof TextField> &\n TextFieldSearchBaseProps;\n```\n\n### FiltersActions.Tabs\n\nКонтейнер табов. Наследует пропсы `Tabs` из `@salutejs/sdds-finai`. Размер по умолчанию: `xs`, вид: `filled`.\n\n```typescript\ntype FiltersActionsTabsProps = TabsProps & {\n /** Кастомные стили */\n $css?: CSSObject | TemplateStringsArray;\n};\n```\n\n### FiltersActions.TabItem\n\nЭлемент таба. Наследует пропсы `TabItem` из `@salutejs/sdds-finai`. Размер по умолчанию: `s`, вид: `default`.\n\n```typescript\ntype FiltersActionsTabItemProps = TabItemProps & {\n /** Кастомные стили */\n $css?: CSSObject | TemplateStringsArray;\n};\n```\n\n### FiltersActions.SegmentItem\n\nЭлемент сегмента. Наследует пропсы `SegmentItem` из `@salutejs/sdds-finai`. Размер по умолчанию: `s`, вид: `default`.\n\n```typescript\ntype FiltersActionsSegmentItemProps = SegmentItemProps & {\n /** Кастомные стили */\n $css?: CSSObject | TemplateStringsArray;\n};\n```\n\n### FiltersActions.TooltipList\n\nТултип со списком элементов. Наследует пропсы `Tooltip` из `@salutejs/sdds-finai` (кроме `text` и `children`).\n\n```typescript\ninterface FiltersActionsTooltipProps\n extends Omit<TooltipProps, 'text' | 'children'> {\n groupLabel?: string;\n items: string[];\n children: React.ReactNode;\n}\n```\n\n### FiltersActions.ResetAllFiltersButton\n\nКнопка «Сбросить все фильтры». Наследует пропсы `LinkButton` из `@salutejs/sdds-finai`.\n\n```typescript\ntype ResetAllFiltersButtonProps = LinkButtonCompProps & {\n /** Видимость кнопки */\n isVisible?: boolean;\n /** Кастомные стили */\n $css?: CSSObject | TemplateStringsArray;\n};\n```\n\n### FiltersActions.SwitcherFilter\n\nПереключатель-фильтр. Наследует пропсы `Switch` из `@salutejs/sdds-finai`.\n\n```typescript\ntype SwitcherFilterProps = SwitchProps;\n```\n\n## Ренейминг\n\nВ целях улучшения читаемости и единообразия именования некоторые compound-компоненты были переименованы.\n\n**Обратная совместимость сохранена** — старые имена продолжают работать. Оба варианта ссылаются на один и тот же компонент. Рекомендуем использовать новые имена:\n\n- `FiltersActions.FilterPopover` → `FiltersActions.FiltersButtonWithPopover`\n- `FiltersActions.Tooltip` → `FiltersActions.TooltipList`\n\n```diff\n- <FiltersActions.FilterPopover\n+ <FiltersActions.FiltersButtonWithPopover\n content={...}\n footer={...}\n buttonProps={{ hideLabel: true }}\n />\n\n- <FiltersActions.Tooltip ... />\n+ <FiltersActions.TooltipList ... />\n```",
48199
48967
  "curatedStories": [
48200
48968
  {
48201
48969
  "exportName": "FilterActionsStory",
@@ -48996,7 +49764,7 @@
48996
49764
  "exportName": "BigDataExample",
48997
49765
  "displayName": "Большой набор данных (строки × колонки)",
48998
49766
  "type": "full-code",
48999
- "code": "() => {\n const [cols, setCols] = useState(1000);\n const [rowInput, setRowInput] = useState('50000');\n const [rowTarget, setRowTarget] = useState(50000);\n const [withMerge, setWithMerge] = useState(true);\n const [heavyCells, setHeavyCells] = useState(true);\n const [withEditing, setWithEditing] = useState(false);\n const [withHeaderButtons, setWithHeaderButtons] = useState(false);\n const filteringStateAndSetter = useState(CLEARED_FILTERS);\n const sortingStateAndSetter = useState<readonly SortColumn[]>([]);\n // Правки пользователя поверх сгенерированных данных (режим редактирования).\n const [editedRows, setEditedRows] = useState<Node[] | null>(null);\n\n const commitsRef = useRef<number[]>([]);\n const onRender = useCallback(\n (_id: string, _phase: string, actualDuration: number) => {\n commitsRef.current.push(actualDuration);\n },\n [],\n );\n\n const { rows: builtRows, leaves } = useMemo(\n () => buildData(rowTarget, withMerge),\n [rowTarget, withMerge],\n );\n\n useEffect(() => {\n setEditedRows(null);\n }, [builtRows]);\n\n const dataRows = editedRows ?? builtRows;\n\n const columns = useMemo(\n () => buildColumns(cols, heavyCells, withEditing, withHeaderButtons),\n [cols, heavyCells, withEditing, withHeaderButtons],\n );\n\n const tableConfig = useMemo(\n () => ({\n containerStyle: { height: '70vh' },\n rowMarkers: { startIndex: 1 },\n resizableColumn: true,\n columnsControl: {\n enable: true,\n pinning: true,\n },\n ...(withMerge\n ? {\n subRows: {\n getSubRows: (row: Node) => row?.subRows,\n rowKeyGetter: (row: Node) => row.id,\n view: 'merged' as const,\n mergedColumns: ['division', 'unit', 'team'],\n },\n }\n : {}),\n ...(withEditing\n ? {\n editing: {\n onRowsChange: (next: Node[]) => setEditedRows(next),\n rowKeyGetter: (r: Node) => r.id,\n },\n }\n : {}),\n ...(withHeaderButtons\n ? {\n sorting: { state: sortingStateAndSetter },\n filtering: {\n state: filteringStateAndSetter,\n clearedValue: CLEARED_FILTERS,\n },\n }\n : {}),\n }),\n [\n withMerge,\n withEditing,\n withHeaderButtons,\n sortingStateAndSetter,\n filteringStateAndSetter,\n ],\n );\n\n return (\n <div>\n <StoryHint>\n Пример на большом наборе данных: настройте число колонок и строк,\n включите нужные режимы и проверяйте выделение, скролл, сайдбар и\n редактирование. HUD справа показывает метрики производительности: FPS\n — кадров в секунду (ниже 40 подсвечивается красным); «коммитов/с» —\n сколько раз в секунду React перерендерил таблицу (при протяжке\n выделения каждый шаг мыши даёт один коммит); «коммит сред/макс» —\n среднее и максимальное время одного такого перерендера в\n миллисекундах, то есть цена реакции таблицы на одно действие.\n </StoryHint>\n\n <div\n style={{\n display: 'flex',\n gap: 24,\n alignItems: 'center',\n flexWrap: 'wrap',\n padding: '8px 4px 12px',\n fontSize: 13,\n }}\n >\n <span style={{ display: 'flex', gap: 8, alignItems: 'center' }}>\n Колонок: <b style={{ minWidth: 42 }}>{cols}</b>\n <div style={{ width: 220 }}>\n <Slider\n value={cols}\n min={1}\n max={1500}\n onChangeCommitted={(value) => setCols(value)}\n />\n </div>\n </span>\n\n <span style={{ display: 'flex', gap: 8, alignItems: 'center' }}>\n Строк:\n <div style={{ width: 130 }}>\n <TextField\n value={rowInput}\n type=\"number\"\n size=\"s\"\n onChange={(e) => setRowInput(e.target.value)}\n />\n </div>\n <Button\n size=\"s\"\n view=\"secondary\"\n onClick={() => setRowTarget(Math.max(1, Number(rowInput) || 1))}\n >\n Построить\n </Button>\n <span style={{ opacity: 0.75 }}>\n (листьев: <b>{fmt(leaves)}</b>)\n </span>\n </span>\n\n <Checkbox\n label=\"объединение (subRows merged)\"\n checked={withMerge}\n onChange={(e) => setWithMerge(e.target.checked)}\n />\n\n <Checkbox\n label=\"тяжёлые ячейки (Canvas.Badge)\"\n checked={heavyCells}\n onChange={(e) => setHeavyCells(e.target.checked)}\n />\n\n <Checkbox\n label=\"редактирование (error-ячейки)\"\n checked={withEditing}\n onChange={(e) => setWithEditing(e.target.checked)}\n />\n\n <Checkbox\n label=\"сортировка и фильтр в шапке\"\n checked={withHeaderButtons}\n onChange={(e) => setWithHeaderButtons(e.target.checked)}\n />\n\n <PerfHudBadge commitsRef={commitsRef} />\n </div>\n\n <Profiler id=\"big-data-table\" onRender={onRender}>\n <TableCanvas\n tableConfig={tableConfig}\n columnConfig={columns}\n rows={dataRows as Node[]}\n />\n </Profiler>\n </div>\n );\n }"
49767
+ "code": "() => {\n const [cols, setCols] = useState(1000);\n const [rowInput, setRowInput] = useState('50000');\n const [rowTarget, setRowTarget] = useState(50000);\n const [withMerge, setWithMerge] = useState(true);\n const [heavyCells, setHeavyCells] = useState(true);\n const [withEditing, setWithEditing] = useState(false);\n const [withMeasureErrors, setWithMeasureErrors] = useState(false);\n const [withRowErrorsColumn, setWithRowErrorsColumn] = useState(false);\n const [withWholeRowErrors, setWithWholeRowErrors] = useState(false);\n const [withHeaderButtons, setWithHeaderButtons] = useState(false);\n const filteringStateAndSetter = useState(CLEARED_FILTERS);\n const sortingStateAndSetter = useState<readonly SortColumn[]>([]);\n // Правки пользователя поверх сгенерированных данных (режим редактирования).\n const [editedRows, setEditedRows] = useState<Node[] | null>(null);\n\n const commitsRef = useRef<number[]>([]);\n const onRender = useCallback(\n (_id: string, _phase: string, actualDuration: number) => {\n commitsRef.current.push(actualDuration);\n },\n [],\n );\n\n const { rows: builtRows, leaves } = useMemo(\n () => buildData(rowTarget, withMerge),\n [rowTarget, withMerge],\n );\n\n useEffect(() => {\n setEditedRows(null);\n }, [builtRows]);\n\n const dataRows = editedRows ?? builtRows;\n\n const columns = useMemo(\n () =>\n buildColumns(\n cols,\n heavyCells,\n withEditing,\n withHeaderButtons,\n withMeasureErrors,\n ),\n [cols, heavyCells, withEditing, withHeaderButtons, withMeasureErrors],\n );\n\n const tableConfig = useMemo(\n () => ({\n containerStyle: { height: '70vh' },\n rowMarkers: { startIndex: 1 },\n // Размер строки переключается в настройках таблицы (шестерёнка справа):\n // от него зависят высота строк, ширина служебных колонок и размер иконки\n // индикатора ошибок.\n rowSize: { showInControl: true, default: 'big' as const },\n resizableColumn: true,\n columnsControl: {\n enable: true,\n pinning: true,\n },\n ...(withMerge\n ? {\n subRows: {\n getSubRows: (row: Node) => row?.subRows,\n rowKeyGetter: (row: Node) => row.id,\n view: 'merged' as const,\n mergedColumns: ['division', 'unit', 'team'],\n },\n }\n : {}),\n ...(withEditing\n ? {\n editing: {\n onRowsChange: (next: Node[]) => setEditedRows(next),\n rowKeyGetter: (r: Node) => r.id,\n defaultEnabled: true,\n ...((withRowErrorsColumn || withWholeRowErrors) && {\n rowErrors: {\n indicatorColumn: withRowErrorsColumn,\n ...(withWholeRowErrors && {\n // Каждая десятая строка помечена целиком.\n isErrorRow: (r: Node) => hashStr(r.id) % 10 === 0,\n tooltip: ({\n isErrorRow,\n errorCellsCount,\n }: {\n isErrorRow: boolean;\n errorCellsCount: number;\n }) =>\n isErrorRow\n ? 'Строка помечена целиком'\n : `Ошибок в строке: ${errorCellsCount}`,\n }),\n },\n }),\n },\n }\n : {}),\n ...(withHeaderButtons\n ? {\n sorting: { state: sortingStateAndSetter },\n filtering: {\n state: filteringStateAndSetter,\n clearedValue: CLEARED_FILTERS,\n },\n }\n : {}),\n }),\n [\n withMerge,\n withEditing,\n withRowErrorsColumn,\n withWholeRowErrors,\n withHeaderButtons,\n sortingStateAndSetter,\n filteringStateAndSetter,\n ],\n );\n\n return (\n <div>\n <StoryHint>\n Пример на большом наборе данных: настройте число колонок и строк,\n включите нужные режимы и проверяйте выделение, скролл, сайдбар и\n редактирование. HUD справа показывает метрики производительности: FPS\n — кадров в секунду (ниже 40 подсвечивается красным); «коммитов/с» —\n сколько раз в секунду React перерендерил таблицу (при протяжке\n выделения каждый шаг мыши даёт один коммит); «коммит сред/макс» —\n среднее и максимальное время одного такого перерендера в\n миллисекундах, то есть цена реакции таблицы на одно действие.\n </StoryHint>\n\n <div\n style={{\n display: 'flex',\n gap: 24,\n alignItems: 'center',\n flexWrap: 'wrap',\n padding: '8px 4px 12px',\n fontSize: 13,\n }}\n >\n <span style={{ display: 'flex', gap: 8, alignItems: 'center' }}>\n Колонок: <b style={{ minWidth: 42 }}>{cols}</b>\n <div style={{ width: 220 }}>\n <Slider\n value={cols}\n min={1}\n max={1500}\n onChangeCommitted={(value) => setCols(value)}\n />\n </div>\n </span>\n\n <span style={{ display: 'flex', gap: 8, alignItems: 'center' }}>\n Строк:\n <div style={{ width: 130 }}>\n <TextField\n value={rowInput}\n type=\"number\"\n size=\"s\"\n onChange={(e) => setRowInput(e.target.value)}\n />\n </div>\n <Button\n size=\"s\"\n view=\"secondary\"\n onClick={() => setRowTarget(Math.max(1, Number(rowInput) || 1))}\n >\n Построить\n </Button>\n <span style={{ opacity: 0.75 }}>\n (листьев: <b>{fmt(leaves)}</b>)\n </span>\n </span>\n\n <Checkbox\n label=\"объединение (subRows merged)\"\n checked={withMerge}\n onChange={(e) => setWithMerge(e.target.checked)}\n />\n\n <Checkbox\n label=\"тяжёлые ячейки (Canvas.Badge)\"\n checked={heavyCells}\n onChange={(e) => setHeavyCells(e.target.checked)}\n />\n\n <Checkbox\n label=\"редактирование (error-ячейки)\"\n checked={withEditing}\n onChange={(e) => setWithEditing(e.target.checked)}\n />\n\n <Checkbox\n label=\"ошибки в M-колонках (с тултипом)\"\n checked={withMeasureErrors}\n disabled={!withEditing}\n onChange={(e) => setWithMeasureErrors(e.target.checked)}\n />\n\n <Checkbox\n label=\"столбец-индикатор (rowErrors)\"\n checked={withRowErrorsColumn}\n disabled={!withEditing}\n onChange={(e) => setWithRowErrorsColumn(e.target.checked)}\n />\n\n <Checkbox\n label=\"ошибка всей строки (каждая 10-я)\"\n checked={withWholeRowErrors}\n disabled={!withEditing}\n onChange={(e) => setWithWholeRowErrors(e.target.checked)}\n />\n\n <Checkbox\n label=\"сортировка и фильтр в шапке\"\n checked={withHeaderButtons}\n onChange={(e) => setWithHeaderButtons(e.target.checked)}\n />\n\n <PerfHudBadge commitsRef={commitsRef} />\n </div>\n\n <Profiler id=\"big-data-table\" onRender={onRender}>\n <TableCanvas\n tableConfig={tableConfig}\n columnConfig={columns}\n rows={dataRows as Node[]}\n />\n </Profiler>\n </div>\n );\n }"
49000
49768
  },
49001
49769
  {
49002
49770
  "exportName": "RowSpanBasic",
@@ -49703,17 +50471,25 @@
49703
50471
  "feature": "Editing",
49704
50472
  "legacy": false,
49705
50473
  "summary": "*tableConfig.editing + columnConfig.editingCell**",
49706
- "docs": "# Editing (TableCanvas)\n\n**tableConfig.editing + columnConfig.editingCell**\n\nРежим редактирования данных в ячейках таблицы. Условие активации — наличие свойства `editing` в `tableConfig`. Также необходимо сконфигурировать колонки через `editingCell`.\n\n## Ключевые особенности\n\n- Управление режимом редактирования через `enabled` / `defaultEnabled`\n- Callback-и при включении, сохранении и отмене (`onEnableEditing`, `onSave`, `onCancel`)\n- Контроль редактируемости строк через `rowEditable`\n- Поддержка дочерних строк через `subRowsKey`\n- Кнопки управления в controlBlock (`showButtons`)\n- `editingCell.component` рендерит React-компонент поверх таблицы; `Canvas.*` элементы используйте только в `renderCell`, `renderHeaderCell` и `renderSummaryCell`\n\n## Жизненный цикл\n\n1. Пользователь нажимает кнопку «Редактирование» → вызывается `onEnableEditing`\n2. При изменении ячейки → вызывается `onRowsChange` с данными об изменённых строках\n3. При нажатии «Сохранить» → вызывается `onSave`\n4. При нажатии «Отменить» → вызывается `onCancel`\n\n## Управление состоянием\n\n- **`defaultEnabled`** — начальное состояние (внутренний стейт)\n- **`enabled: boolean`** — полностью внешнее управление (без переключения в таблице)\n- **`enabled: [boolean, setState]`** — внешний стейт с возможностью переключения в таблице\n\n## Особенности\n\n- `onRowsChange` — обязательный callback, получает обновлённые строки и метаданные (индексы, колонка, before/after)\n- `subRowsKey` — обязателен, если дочерние строки хранятся не под ключом `subRows`. Поддерживает вложенность через точку (например, `'data.children'`)\n- `showButtons` — по умолчанию `true`, управляет видимостью кнопок в controlBlock\n\n## Управление кнопками (buttons)\n\nЧерез `editing.buttons` можно передать пропсы кнопкам `save`, `cancel` и `edit`. `onClick` исключён — обработчики задаются через `onSave` / `onCancel` / `onEnableEditing`.\n\n```tsx\nediting: {\n buttons: {\n save: { disabled: isSaving, isLoading: isSaving },\n cancel: { disabled: isSaving },\n },\n onSave(disableEditorMode) {\n setIsSaving(true);\n api.save(rows).finally(() => {\n setIsSaving(false);\n disableEditorMode();\n });\n },\n}\n```",
49707
- "apiDocs": "# Editing API\n\n## EditingConfig\n\n```typescript\ntype EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n```\n\n## EditingButtonProps\n\n```typescript\ntype EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n```\n\n## Editing\n\n```typescript\ntype EditingCellInfo<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = Omit<EditingCellInfoGlideInstance<R, SR, CustomCtxs>, 'column'> & {\n column: ColumnConfig<R, SR, CustomCtxs>;\n};\n```",
50474
+ "docs": "# Editing (TableCanvas)\n\n**tableConfig.editing + columnConfig.editingCell**\n\nРежим редактирования данных в ячейках таблицы. Условие активации — наличие свойства `editing` в `tableConfig`. Также необходимо сконфигурировать колонки через `editingCell`.\n\n## Ключевые особенности\n\n- Управление режимом редактирования через `enabled` / `defaultEnabled`\n- Callback-и при включении, сохранении и отмене (`onEnableEditing`, `onSave`, `onCancel`)\n- Контроль редактируемости строк через `rowEditable`\n- Поддержка дочерних строк через `subRowsKey`\n- Кнопки управления в controlBlock (`showButtons`)\n- `editingCell.component` рендерит React-компонент поверх таблицы; `Canvas.*` элементы используйте только в `renderCell`, `renderHeaderCell` и `renderSummaryCell`\n\n## Жизненный цикл\n\n1. Пользователь нажимает кнопку «Редактирование» → вызывается `onEnableEditing`\n2. При изменении ячейки → вызывается `onRowsChange` с данными об изменённых строках\n3. При нажатии «Сохранить» → вызывается `onSave`\n4. При нажатии «Отменить» → вызывается `onCancel`\n\n## Управление состоянием\n\n- **`defaultEnabled`** — начальное состояние (внутренний стейт)\n- **`enabled: boolean`** — полностью внешнее управление (без переключения в таблице)\n- **`enabled: [boolean, setState]`** — внешний стейт с возможностью переключения в таблице\n\n## Особенности\n\n- `onRowsChange` — обязательный callback, получает обновлённые строки и метаданные (индексы, колонка, before/after)\n- `subRowsKey` — обязателен, если дочерние строки хранятся не под ключом `subRows`. Поддерживает вложенность через точку (например, `'data.children'`)\n- `showButtons` — по умолчанию `true`, управляет видимостью кнопок в controlBlock\n\n## Управление кнопками (buttons)\n\nЧерез `editing.buttons` можно передать пропсы кнопкам `save`, `cancel` и `edit`. `onClick` исключён — обработчики задаются через `onSave` / `onCancel` / `onEnableEditing`.\n\n```tsx\nediting: {\n buttons: {\n save: { disabled: isSaving, isLoading: isSaving },\n cancel: { disabled: isSaving },\n },\n onSave(disableEditorMode) {\n setIsSaving(true);\n api.save(rows).finally(() => {\n setIsSaving(false);\n disableEditorMode();\n });\n },\n}\n```\n\n## Ошибки ячеек\n\nОшибку ячейки задаёт колонка. Если `error.value` вернула `true`, у ячейки появляется красная рамка. Рамки работают только в режиме редактирования и считаются только для видимой части таблицы, поэтому подходят для больших данных.\n\n```tsx\n{\n key: 'amount',\n name: 'Сумма',\n editingCell: {\n component: 'inputNumber',\n error: {\n value: (row) => row.amount > row.limit,\n },\n },\n}\n```\n\nЧтобы при наведении на такую ячейку показывалась подсказка, добавьте `error.tooltip`. Можно вернуть строку или объект с настройками (`placement`, `maxWidth`, задержки). Функция вызывается только при наведении и только для ячеек с ошибкой.\n\n```tsx\nerror: {\n value: (row) => row.amount > row.limit,\n tooltip: (row) => ({\n text: `Сумма ${row.amount} больше лимита ${row.limit}`,\n placement: 'right',\n }),\n}\n```\n\nПодсказка ошибки показывается вместо `cellTooltip` колонки и не требует `tableConfig.tooltip.enabled`.\n\n## Столбец с индикатором ошибок\n\nЧтобы пользователь видел, в каких строках есть ошибки, включите служебный столбец через `editing.rowErrors`. Он встаёт правее нумерации и чекбоксов, и у каждой строки, где есть хотя бы одна ячейка с ошибкой, показывает красный треугольник. При наведении на него выводится «Ошибок в строке: N».\n\n```tsx\nediting: {\n rowKeyGetter: (row) => row.id,\n onRowsChange: setRows,\n rowErrors: true,\n}\n```\n\nКак ведёт себя столбец:\n\n- появляется при входе в режим редактирования и исчезает при выходе из него;\n- ширина и размер иконки зависят от `rowSize`;\n- у него пустой заголовок, его нельзя растянуть, выделить, переставить или скрыть через управление столбцами;\n- число ошибок считается по всем колонкам строки, а не только по видимым.\n\nЕсли нужны только рамки без столбца, передайте объект с `indicatorColumn: false`. Это удобно, когда столбец включают и выключают по кнопке.\n\n```tsx\nrowErrors: {\n indicatorColumn: false;\n}\n```\n\n## Ошибка всей строки\n\nИногда ошибка относится не к отдельной ячейке, а к строке целиком, например когда документ отклонён. Для этого передайте `rowErrors.isErrorRow`. У таких строк вместо рамок на ячейках рисуется одна рамка по всей ширине данных, а в столбце-индикаторе тоже горит иконка.\n\n```tsx\nrowErrors: {\n isErrorRow: (row) => row.status === 'rejected',\n}\n```\n\nРежимы можно смешивать: одни строки помечаются целиком, другие поячеечно через `error.value`. Подсказки по умолчанию у строки целиком нет, её задают через `rowErrors.tooltip`.\n\n## Свой текст подсказки у индикатора\n\n`rowErrors.tooltip` заменяет текст подсказки у иконки. В функцию приходит объект с полями `row`, `treeLevel`, `errorCellsCount`, `errorColumnKeys` и `isErrorRow`. Вернуть можно строку, объект с настройками или `null`, если подсказка не нужна. По умолчанию подсказка стоит над иконкой и уходит вправо от неё (`placement: 'top-start'`), другое размещение задаётся в объекте.\n\n```tsx\nrowErrors: {\n isErrorRow: (row) => row.status === 'rejected',\n tooltip: ({ isErrorRow, errorCellsCount }) =>\n isErrorRow ? 'Документ отклонён' : `Ошибок в строке: ${errorCellsCount}`,\n}\n```\n\nТипы `RowErrorsConfig` и `RowErrorsInfo` описаны в разделе [API](/docs/локальные-компоненты-tablecanvas-editing-api--docs).",
50475
+ "apiDocs": "# Editing API\n\n## EditingConfig\n\n```typescript\ntype 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```\n\n## EditingButtonProps\n\n```typescript\ntype EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n```\n\n## RowErrorsConfig\n\n```typescript\ntype RowErrorsConfig<RowType extends ObjectForExtending> = {\n /**\n * Показывать столбец-индикатор. При `false` остаются только рамки ошибок,\n * столбец не занимает место.\n * @default true\n */\n indicatorColumn?: boolean;\n /**\n * Ошибка всей строки: вместо поячеечных рамок одна красная рамка по всей\n * ширине данных (как у строки, выделенной по нумерации, но без заливки).\n * Строки, для которых вернулось `false`, подсвечиваются поячеечно.\n */\n isErrorRow?: (row: RowType, treeLevel: number) => boolean;\n /**\n * Тултип при наведении на иконку индикатора. Вернуть `null`, чтобы тултипа\n * не было. По умолчанию: «Ошибок в строке: N» для поячеечных ошибок и без\n * тултипа для ошибки всей строки. Размещение по умолчанию `top-start`\n * (над иконкой, вправо от неё), его можно переопределить через `placement`.\n */\n tooltip?: (info: RowErrorsInfo<RowType>) => CanvasNodeTooltipConfig | null;\n};\n```\n\n## RowErrorsInfo\n\n```typescript\ntype RowErrorsInfo<RowType extends ObjectForExtending> = {\n /** Строка без служебных ключей таблицы. */\n row: RowType;\n /** Уровень вложенности строки (0 для корневых). */\n treeLevel: number;\n /** Сколько ячеек строки с ошибкой (по всем колонкам, не только видимым). */\n errorCellsCount: number;\n /** Ключи колонок с ошибкой в порядке колонок таблицы. */\n errorColumnKeys: readonly string[];\n /** Строка целиком помечена ошибкой (`isErrorRow`). */\n isErrorRow: boolean;\n};\n```\n\n## Editing\n\n```typescript\ntype EditingCellInfo<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = Omit<EditingCellInfoGlideInstance<R, SR, CustomCtxs>, 'column'> & {\n column: ColumnConfig<R, SR, CustomCtxs>;\n};\n```",
49708
50476
  "api": [
49709
50477
  {
49710
50478
  "typeName": "EditingConfig",
49711
- "source": "type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};"
50479
+ "source": "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};"
49712
50480
  },
49713
50481
  {
49714
50482
  "typeName": "EditingButtonProps",
49715
50483
  "source": "type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;"
49716
50484
  },
50485
+ {
50486
+ "typeName": "RowErrorsConfig",
50487
+ "source": "type RowErrorsConfig<RowType extends ObjectForExtending> = {\n /**\n * Показывать столбец-индикатор. При `false` остаются только рамки ошибок,\n * столбец не занимает место.\n * @default true\n */\n indicatorColumn?: boolean;\n /**\n * Ошибка всей строки: вместо поячеечных рамок одна красная рамка по всей\n * ширине данных (как у строки, выделенной по нумерации, но без заливки).\n * Строки, для которых вернулось `false`, подсвечиваются поячеечно.\n */\n isErrorRow?: (row: RowType, treeLevel: number) => boolean;\n /**\n * Тултип при наведении на иконку индикатора. Вернуть `null`, чтобы тултипа\n * не было. По умолчанию: «Ошибок в строке: N» для поячеечных ошибок и без\n * тултипа для ошибки всей строки. Размещение по умолчанию `top-start`\n * (над иконкой, вправо от неё), его можно переопределить через `placement`.\n */\n tooltip?: (info: RowErrorsInfo<RowType>) => CanvasNodeTooltipConfig | null;\n};"
50488
+ },
50489
+ {
50490
+ "typeName": "RowErrorsInfo",
50491
+ "source": "type RowErrorsInfo<RowType extends ObjectForExtending> = {\n /** Строка без служебных ключей таблицы. */\n row: RowType;\n /** Уровень вложенности строки (0 для корневых). */\n treeLevel: number;\n /** Сколько ячеек строки с ошибкой (по всем колонкам, не только видимым). */\n errorCellsCount: number;\n /** Ключи колонок с ошибкой в порядке колонок таблицы. */\n errorColumnKeys: readonly string[];\n /** Строка целиком помечена ошибкой (`isErrorRow`). */\n isErrorRow: boolean;\n};"
50492
+ },
49717
50493
  {
49718
50494
  "typeName": "EditingCellInfo",
49719
50495
  "source": "type EditingCellInfo<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = Omit<EditingCellInfoGlideInstance<R, SR, CustomCtxs>, 'column'> & {\n column: ColumnConfig<R, SR, CustomCtxs>;\n};"
@@ -49737,6 +50513,12 @@
49737
50513
  "displayName": "Блок",
49738
50514
  "type": "full-code",
49739
50515
  "code": "() => {\n const [rows, setRows] = useState(() => createRowsTree());\n const columns = useMemo(\n (): readonly ColumnConfig<TreeRow>[] => [\n {\n key: 'block',\n name: 'Блок',\n editingCell: {\n editable: (r) => r.block === BLOCKS[1],\n error: {\n value: (r) => r.block === BLOCKS[0],\n },\n component: 'select',\n options: {\n type: 'constant',\n options: BLOCKS.map((i) => ({ text: i, value: i })),\n },\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 editingCell: {\n component: 'inputString',\n inputProps: {\n placeholder: 'Введите значение',\n },\n },\n\n isColumnWithArrow: true,\n hideHeaderExpandAllArrow: false,\n },\n },\n {\n key: 'blockActivity',\n name: 'Активность блока',\n editingCell: { component: 'inputString' },\n },\n {\n key: 'tribe',\n name: 'Трайб',\n editingCell: {\n component: 'select',\n options: {\n type: 'stateInRowContext',\n optionsKeyInRowContext: 'tribeOptions',\n },\n selectProps: {\n listMaxHeight: '210px',\n },\n },\n },\n {\n key: 'product',\n name: 'Продукт',\n editingCell: {\n component: 'select',\n options: {\n type: 'stateInRowContext',\n optionsKeyInRowContext: 'productOptions',\n },\n },\n },\n {\n key: 'q1',\n name: 'Q1',\n\n editingCell: {\n component: 'inputNumber',\n inputProps: {\n placeholder: 'Введите значение',\n },\n },\n contentFormat: {\n type: 'number',\n decimalSeparator: ',',\n thousandSeparator: ' ',\n alignContent: 'right',\n minimumFractionDigits: 2,\n maximumFractionDigits: 2,\n },\n subRow: {\n keyOfColumnInSubRow: 'q1',\n editingCell: { component: 'inputNumber' },\n },\n },\n {\n key: 'q2',\n name: 'Q2',\n contentFormat: 'number',\n editingCell: {\n component: ({\n row,\n onRowChange,\n column,\n cellHeight,\n cellWidth,\n initialValue,\n }) => {\n const initialValueAsNumber =\n initialValue && !Number.isNaN(+initialValue)\n ? +initialValue\n : null;\n\n const [v, setV] = useState<string | number>(\n initialValueAsNumber ??\n (row?.[column.key as keyof typeof row] as unknown as number),\n );\n\n const handleChange = (\n _event?: React.ChangeEvent<HTMLInputElement>,\n values?: {\n floatValue: number | undefined;\n formattedValue: string;\n value: string;\n },\n ) => {\n if (values) {\n const resultValue =\n values.floatValue ?? values.formattedValue;\n setV(resultValue);\n onRowChange({\n ...row,\n [column.key]: resultValue,\n });\n }\n };\n return (\n <CellEditorNumberFormat\n cellHeight={cellHeight}\n cellWidth={cellWidth}\n autoFocusType={\n initialValueAsNumber === null\n ? 'autoFocusAndSelect'\n : 'autoFocus'\n }\n value={v}\n onChange={handleChange}\n />\n );\n },\n },\n subRow: {\n keyOfColumnInSubRow: 'q2',\n editingCell: { component: 'inputNumber' },\n },\n },\n {\n key: 'q3',\n name: 'Q3',\n contentFormat: 'number',\n\n editingCell: { component: 'inputNumber' },\n subRow: {\n keyOfColumnInSubRow: 'q3',\n\n editingCell: {\n component: 'inputNumber',\n error: {\n value(_row, _treeLvl) {\n return true;\n },\n },\n },\n },\n },\n {\n key: 'q4',\n name: 'Q4',\n contentFormat: 'number',\n\n editingCell: { component: 'inputNumber' },\n subRow: {\n keyOfColumnInSubRow: 'q4',\n editingCell: { component: 'inputNumber' },\n },\n },\n ],\n [],\n );\n\n const rowContextValue = useMemo(\n () => ({\n tribeOptions: TRIBES.map((i) => ({ text: i, value: i })),\n productOptions: PRODUCTS.map((i) => ({ text: i, value: i })),\n }),\n [],\n );\n const savedRowsRef = useRef<null | typeof rows>(null);\n const [opened, setOpened] = useState(false);\n return (\n <>\n <Button type=\"button\" onClick={() => setOpened((prev) => !prev)}>\n Toggle Modal\n </Button>\n <ModalDF opened={opened} onClose={() => setOpened(false)}>\n <ModalDF.Main>\n <ModalDF.Header\n title=\"Режим редактирования внутри модальных окон\"\n badge={{ text: `tableConfig.editorOverlayPortal: 'inside'` }}\n />\n <ModalDF.Content>\n <TableCanvas\n tableConfig={{\n // КЛЮЧЕВОЕ СВОЙСТВО ДЛЯ КОРРЕКТНОЙ РАБОТЫ РЕЖИМА РЕДАКТИРОВАНИЯ ВНУТРИ МОДАЛЬНЫХ ОКОН\n editorOverlayPortal: 'inside',\n //\n containerStyle: {\n height: '60vh',\n width: '80vw',\n },\n rowSize: {\n showInControl: true,\n default: 'big',\n },\n editing: {\n defaultEnabled: true,\n onEnableEditing(enableEditorMode) {\n savedRowsRef.current = JSON.parse(JSON.stringify(rows));\n enableEditorMode();\n },\n onCancel(disableEditorMode) {\n if (savedRowsRef.current) {\n setRows(savedRowsRef.current);\n }\n disableEditorMode();\n },\n onSave(disableEditorMode) {\n savedRowsRef.current = null;\n disableEditorMode();\n },\n onRowsChange: setRows,\n rowKeyGetter: (r) => `${r.id}`,\n rowEditable: (r) => r.block !== BLOCKS[1],\n },\n subRows: {\n getSubRows: (row) => row?.subRows,\n rowKeyGetter: (row) => row.id,\n },\n resizableColumn: true,\n }}\n columnConfig={columns}\n rows={rows}\n rowContextValue={rowContextValue}\n />\n </ModalDF.Content>\n </ModalDF.Main>\n </ModalDF>\n </>\n );\n }"
50516
+ },
50517
+ {
50518
+ "exportName": "EditingRowErrors",
50519
+ "displayName": "Row Errors (индикатор и ошибка всей строки)",
50520
+ "type": "full-code",
50521
+ "code": "import { ColumnConfig, TableCanvas } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport { useState } from 'react';\n\ntype InvoiceRow = {\n id: string;\n name: string;\n amount: number;\n limit: number;\n status: 'new' | 'approved' | 'rejected';\n};\n\nconst columnConfig: ColumnConfig<InvoiceRow>[] = [\n {\n key: 'name',\n name: 'Назначение',\n editingCell: {\n component: 'inputString',\n error: {\n value: (row) => row.name.trim() === '',\n // Тултип считается только при наведении на ячейку с ошибкой.\n tooltip: () => 'Назначение платежа не заполнено',\n },\n },\n },\n {\n key: 'amount',\n name: 'Сумма',\n contentFormat: 'number',\n editingCell: {\n component: 'inputNumber',\n error: {\n value: (row) => row.amount > row.limit,\n tooltip: (row) => ({\n text: \\"
49740
50522
  }
49741
50523
  ]
49742
50524
  },
@@ -49866,11 +50648,11 @@
49866
50648
  "legacy": false,
49867
50649
  "summary": "*tableConfig.filtering**",
49868
50650
  "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)",
49869
- "apiDocs": "# Filtering API\n\n## FilteringConfig\n\n```typescript\ntype FilteringConfig<T> = {\n state: [T, React.Dispatch<React.SetStateAction<T>>];\n /**\n * @deprecated Использовать filtersInfo\n *\n * clearedValue - состояние фильтров после очистки. Используется для сравнения:\n * Например, был ли фильтр конкретной колонки изменен рассчитывается посредством сравнения текущего значения фильтра и значения фильтра в clearedValue.\n * Если они равны, то фильтр считается не измененным.\n */\n clearedValue?: T;\n /**\n * Информация о фильтрах для каждой колонки.\n * Используется для:\n * 1. Хранения меток (label) фильтров для отображения в UI\n * 2. Хранения значений по умолчанию (clearedValue) для каждого фильтра\n * 3. Определения, был ли фильтр изменен (сравнение текущего значения с clearedValue)\n */\n filtersInfo?: Record<\n keyof T,\n {\n label: string;\n clearedValue: T[keyof T];\n }\n >;\n /**\n * manualFiltering - пропс, активирующий ручную-кастомную (или на стороне бэка) фильтрацию.\n * @remarks\n * Для автоматической фильтрации (когда не используется manualFiltering в tableConfig):\n * - Для всех типов фильтров обязательно должен быть указан `valueInRow`\n * - Для component: 'select' дополнительно должен быть указан `filteringType`\n * - Для component: 'input' с кастомным фильтром (когда filter - функция)\n * функция фильтрации должна быть передана явно\n *\n * Если используется manualFiltering, эти параметры не обязательны,\n * так как вся логика фильтрации реализуется извне.\n */\n manualFiltering?: boolean;\n /**\n * Конфигурация для отображения фильтров в правом сайдбаре.\n *\n * Позволяет:\n * 1. Добавлять глобальные фильтры (не привязанные к конкретной колонке)\n * 2. Управлять порядком отображения фильтров\n * 3. Переопределять рендер и заголовки колоночных фильтров\n *\n * Логика работы:\n * - По умолчанию в сайдбаре отображаются все колоночные фильтры (из columnConfig)\n * - Ключом фильтра считается `key` колонки, если его нет, то пытаемся взять `keyInFilterState` (если указан), иначе это не будет работать\n * - Заголовком фильтра по умолчанию является `name` колонки или ключ фильтра (name || key)\n * - Глобальные фильтры добавляются через `items` с уникальными ключами\n *\n * Особенности:\n * 1. Порядок отображения:\n * - Сначала фильтры из `order` (в указанной последовательности)\n * - Затем остальные колоночные фильтры (в порядке columnConfig)\n * - В конце - глобальные фильтры (в алфавитном порядке ключей)\n *\n * 2. Переопределение колоночных фильтров:\n * - Чтобы изменить заголовок: укажите ключ колонки в `items` с новым `label`\n * - Чтобы заменить рендер: укажите ключ колонки с `customRenderFn`\n * - Оригинальный фильтр из колонки будет проигнорирован\n *\n * 3. Глобальные фильтры:\n * - Ключ не должен совпадать с ключами колонок\n * - Обязательно указать `label` и `customRenderFn`\n * - Отображаются после всех колоночных фильтров, если не переопределены в order\n *\n * @example\n * // Добавление глобального фильтра и изменение порядка\n * sidebarConfig: {\n * order: ['status', 'tasks', 'type'], // Сначала статус, затем глобальный поиск\n * items: {\n * tasks: { // Уникальный ключ\n * label: 'Поиск по всем полям',\n * customRenderFn: () => <TaskComponent />\n * },\n * status: { // Переопределение колоночного фильтра\n * label: 'Статус заявки', // Новый заголовок\n * customRenderFn: () => <CustomStatusFilter /> // Кастомный рендер\n * }\n * type: { // Переопределение только Label колоночного фильтра\n * label: 'Тип', // Новый заголовок\n * }\n * }\n * }\n */\n sidebarConfig?: {\n /**\n * Определяет порядок отображения фильтров.\n * - Указываются ключи фильтров (колоночных или глобальных)\n * - Не указанные в order фильтры отображаются после\n * - Если order пуст, сохраняется порядок: глобальные фильтры + columnConfig фильтры в конце\n */\n order?: string[];\n /**\n * Конфигурация фильтров для сайдбара.\n * Ключом может быть:\n * - Ключ колонки (для переопределения колоночного фильтра)\n * - Уникальный ключ (для добавления глобального фильтра)\n */\n items: Partial<\n Record<\n keyof T,\n {\n /** Заголовок фильтра (обязателен для глобальных фильтров), можно использовать для переопределения для локальных фильтров */\n label: string;\n /**\n * Функция рендера компонента фильтра.\n * Для колоночных фильтров переопределяет оригинальный рендер.\n * Для глобальных фильтров обязательна.\n */\n customRenderFn?: (\n filters: T,\n setFilters: React.Dispatch<React.SetStateAction<T>>,\n ) => React.ReactNode;\n }\n >\n >;\n };\n /**\n * Callback для кастомизации стилей чипсов (фильтров) в списке\n *\n * @param {ItemOrGroup} itemOrGroup - Текущий элемент или группа фильтров\n * @param {Item | undefined} item - Конкретный элемент фильтра (если есть)\n * @returns {CSSObject} Объект стилей, который будет применен к чипсу\n *\n * @description\n * Позволяет динамически задавать стили для каждого чипса в зависимости от его типа и содержимого.\n * Вызывается для каждого отображаемого чипса (как для отдельных элементов, так и для элементов внутри групп).\n *\n * @example\n * // Пример 1: Стилизация чипсов по типу\n * chipStyle: (itemOrGroup, item) => {\n * if (isGroup(itemOrGroup)) {\n * return { backgroundColor: '#f0f0f0' };\n * }\n * return { backgroundColor: '#e0e0e0' };\n * }\n *\n * @example\n * // Пример 2: Стилизация по значению фильтра\n * chipStyle: (itemOrGroup, item) => {\n * if (item?.label === 'Высокий приоритет') {\n * return {\n * backgroundColor: '#ffebee',\n * color: '#d32f2f'\n * };\n * }\n * return {};\n * }\n *\n * @example\n * // Пример 3: Разные стили для элементов в группе и одиночных\n * chipStyle: (itemOrGroup, item) => {\n * if (item) {\n * // Стиль для элемента внутри группы\n * return { maxWidth: 180 };\n * }\n * // Стиль для одиночного чипа\n * return { maxWidth: 150 };\n * }\n */\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n /**\n * Пользовательский форматтер заголовка группы чипсов.\n *\n * Используется в блоке активных фильтров для подмены текста заголовка\n * группы (например, “Статус”, “Тип”, “Автор”). Полезно, когда нужно\n * динамически менять подпись (добавить счётчик, i18n и т.п.).\n *\n * @param {ItemOrGroup} itemOrGroup Объект группы (тип Group). Вызов происходит только для групп,\n * поэтому безопасно кастовать к Group.\n * @returns {string} Текст заголовка группы чипсов.\n *\n * @default Возвращается `group.groupLabel`.\n *\n * @remarks\n * - Функция должна быть чистой и быстрой (без сетевых запросов и побочных эффектов).\n * - Возвращайте ТОЛЬКО строку — чипы отображают текстовое значение.\n * - Для длинных строк применяется усечение (overflow с многоточием) на уровне компонента.\n *\n * @example\n * // Добавить двоеточие и количество выбранных элементов\n * renderGroupLabel: (group) => `${group.groupLabel}: ${group.items.length}`\n *\n * @example\n * // Локализация заголовка группы\n * const i18n = { status: 'Статус', type: 'Тип' };\n * renderGroupLabel: (group) => i18n[group.groupId] ?? group.groupLabel\n */\n renderGroupLabel?: (group: Group) => string;\n\n /**\n * Пользовательский форматтер текста чипса (элемента внутри группы или одиночного фильтра).\n *\n * Позволяет управлять тем, что именно отображается внутри каждого чипса. Особенно полезен\n * при серверной пагинации/ленивой загрузке, когда в состоянии фильтра хранится только value,\n * а label необходимо подставить из локального кэша.\n *\n * @param {Group | null } group Группа, внутри которой рендерится чип (или null).\n * @param {Item} item Сам элемент чипса. В группах передаётся конкретный `Item`,\n * для одиночного чипа может быть `undefined`.\n * @returns {string} Текст, который будет показан в чипсе.\n *\n * @default Используется `item?.label.toString()` (или строковое представление value).\n *\n * @remarks\n * - Функция должна быть чистой и быстрой;\n * - Возвращайте ТОЛЬКО строку.\n *\n * @example\n * // 1) Отображение label из кэша при серверной пагинации\n * const labelsCacheRef = useRef(new Map<string, string>());\n * renderChipLabel: (group, item) => {\n * if (item?.id != null) {\n * const key = String(item.id);\n * const fromCache = labelsCacheRef.current.get(key);\n * if (fromCache) return fromCache; // красивый label, если уже загрузили\n * return String(item.label ?? key); // фоллбэк: временно показываем value/label из item\n * }\n * return ''; // безопасный фоллбэк для одиночных случаев\n * }\n *\n * @example\n * // 2) Нормализация отображения числовых значений\n * renderChipLabel: (_group, item) => {\n * const v = Number(item?.label);\n * return Number.isFinite(v) ? v.toLocaleString('ru-RU') : String(item?.label ?? '');\n * }\n *\n * @example\n * // 3) Префикс по типу группы\n * renderChipLabel: (group, item) => {\n * const prefix = group.groupId === 'status' ? '' : '#';\n * return `${prefix}${item?.label ?? item?.id ?? ''}`;\n * }\n */\n renderChipLabel?: (group: Group | null, item: Item) => string;\n};\n\nexport type DefaultSidebarTabIds = 'columns' | 'tableSettings' | 'filtering';\n\n/**\n * Общие настройки пользовательских вкладок левой и правой панели TableCanvas.\n */\nexport type TableCanvasSidebarConfig = {\n /**\n * Включен ли sidebar. Отвечает только за UI. Не влияет на перерасчёт фичей.\n * @default true\n */\n enabled?: boolean;\n /**\n * Открыт ли sidebar при первом рендере (uncontrolled-режим).\n * Игнорируется, если передан openState.\n * @default false\n */\n defaultOpen?: boolean;\n /**\n * Внешний контроль открытия/закрытия sidebar.\n * Если передан — источник истины, defaultOpen игнорируется.\n */\n openState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * id вкладки, выбранной по умолчанию (актуально при открытом сайдбаре).\n * Если id не найден или у вкладки showInSidebar=false — используется первая доступная.\n */\n defaultActiveTabId?: string;\n /**\n * Внешний контроль активной вкладки (controlled-режим).\n * Если передан — источник истины, defaultActiveTabId игнорируется.\n */\n activeTabState?: [\n string | null,\n React.Dispatch<React.SetStateAction<string | null>>,\n ];\n /**\n * Колбэк смены активной вкладки. Вызывается и в uncontrolled-режиме.\n * При закрытии сайдбара приходит null.\n */\n onActiveTabChange?: (tabId: string | null, tab?: SidebarTab) => void;\n /**\n * Кастомные табы\n */\n customTabs?: Array<\n Omit<SidebarTab, 'id'> & {\n id: Exclude<string, DefaultSidebarTabIds>;\n }\n >;\n /**\n * Порядок отображения кастомных вкладок\n */\n customTabsOrder?: Array<Exclude<string, DefaultSidebarTabIds>>;\n /**\n * Ширина контента без полоски вкладок (44px). Число — px, строка — CSS.\n * Проценты считаются от ширины рабочей области TableCanvas.\n * Изменение пропса сразу меняет ширину открытой панели.\n * По умолчанию: 300px слева, 400px справа.\n */\n width?: string | number;\n};\n\n/** Настройки правой панели; встроенные вкладки доступны только справа. */\nexport type SidebarConfig = TableCanvasSidebarConfig & {\n defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара (если данный таб окажется единственным табом в настройках) */\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки (для табов с id = filtering и columns - недоступен. Настраивается через таб с id='tableSettings') */\n iconTooltipText?: undefined;\n }\n | {\n id: 'tableSettings';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара */\n title?: string;\n\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный слот для вкладки tableSettings (рендерится после общих настроек)\n * Только дл id: 'tableSettings'\n */\n customGeneralSettingsSlot?: React.ReactNode;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки @default 'Настройки' */\n iconTooltipText?: string;\n }\n >;\n};\n\n/** Конфигурация правой панели. SidebarConfig сохранён для совместимости. */\nexport type RightSidebarConfig = SidebarConfig;\n\n/** Пользовательские вкладки слева; встроенных вкладок настроек нет. */\nexport type LeftSidebarConfig = TableCanvasSidebarConfig;\n\n/** Нижний слот под canvas, над пагинацией, между боковыми панелями. */\nexport type BottomSheetConfig = {\n /** @default true */\n enabled?: boolean;\n /** Число — px, строка — CSS; 'auto' — по содержимому. Проценты — от рабочей области. @default 32 */\n height?: string | number;\n /** Минимальная высота, ограниченная доступным пространством. @default 32 */\n minHeight?: string | number;\n /** Максимальная высота в px или CSS, дополнительно ограниченная доступным пространством. */\n maxHeight?: string | number;\n /** Пользователь управляет содержимым и раскрытием; при height: 'auto' панель прокручивается сама. */\n content: React.ReactNode;\n};\n\nexport function activeViewIs<T extends 'cards' | 'rows'>(\n checkType: T,\n viewState: 'cards' | 'rows',\n view: View,\n): view is ViewMods[T] {\n return checkType === viewState;\n}\n\n/** Размер controlBlock: 'm' и 's' — одинаковые стили, 'xs' — уменьшенный */\nexport type ControlBlockSize = 'm' | 's' | 'xs';\n\nexport type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * Размер controlBlock и его элементов (кнопки, иконки, поиск, отступы).\n * 'm' и 's' — стандартные стили, 'xs' — компактный режим.\n * Не влияет на customFeatures и кастомные слоты — они контролируются разработчиком.\n * @default 'm'\n */\n size?: ControlBlockSize;\n /**\n * @deprecated Используйте кастомные кнопки через rightSideInner или customFeatures.\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока.\n * Продолжает работать для обратной совместимости.\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * customFeatures - пропс для добавления кастомных фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\n /**\n * pinningMenu - нативная фича закрепления столбцов (SplitIconButton с\n * дропдауном) в правой зоне иконок. Появляется, когда активировано\n * закрепление колонок (columnsControl.pinning). Продукт может донастроить\n * и дополнить пункты меню (см. PinningMenuConfig).\n */\n pinningMenu?: PinningMenuConfig;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты левые фичи при адаптивной компрессии\n */\n leftSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты правые фичи при адаптивной компрессии\n */\n rightSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Активна ли фича компрессии (сжатие ToolsMenu при адаптиве)\n * @default true\n */\n enableAdaptiveCompress?: boolean;\n /**\n * Панель массовых действий\n */\n massActionPanel?: {\n /**\n * Кнопки панели. Размеры кнопок/дропдаунов панель подбирает сама (по `size` панели и компактности) —\n * передавать `size` кнопкам не нужно. Если `size` на кнопке всё же задан — он используется как есть.\n */\n buttons: MassActionButtonProps[];\n /**\n * Пропсы для Dropdown, в который сжались кнопки\n */\n collapsedDropdownProps?: TableDropdownConfigProps;\n /**\n * Отступ панели снизу от контейнера (px)\n * @default 24\n */\n bottom?: number;\n /**\n * Управление отображением панели массовых действий.\n * - `undefined` (по умолчанию) — стандартное поведение (показывается при selecting + выбранных строках)\n * - `false` — панель не рендерится, разработчик управляет действиями самостоятельно\n * - `true` — панель показывается всегда, даже без активного selecting и выбранных строк\n */\n show?: boolean;\n /**\n * Размерная сетка панели внутри таблицы: `m`/`s` — обычный размер, `xs` — уменьшенный (кнопки `xxs`, «ещё» `xs`, счётчик Body XS).\n * Viewport-логика (1280) в таблице не используется.\n * @default 's'\n */\n size?: MassActionsSize;\n };\n};\n\n/** Пропсы кнопки редактирования. onClick исключён — используйте onSave/onCancel/onEnableEditing. */\nexport type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n\nexport type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n\nexport type SummaryRowsConfig = {\n showDefault: boolean;\n showInControl: boolean;\n /**\n * callback при переключении тогла «Итоговые строки» в настройках таблицы.\n * Вызывается только по действию пользователя (не при монтировании),\n * поэтому подходит для сохранения выбора, например, в localStorage.\n * Сохранённое значение передавайте обратно в `showDefault`.\n */\n onChange?: (checked: boolean) => void;\n} & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\n/**\n * Конфиг тултипа при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\nexport type TableConfigTooltip = {\n /**\n * Включить/выключить колоночные и кастомные тултипы (cellTooltip, headerCellTooltip).\n * Внутренние тултипы (drag-иконка в шапке и другие по nodeId) работают всегда.\n * @default false\n */\n enabled?: boolean;\n /** Глобальная задержка перед показом тултипа (мс). Per-node переопределяет. @default 500 */\n mouseEnterDelay?: number;\n /** Глобальная задержка перед скрытием тултипа (мс). Per-node переопределяет. @default 0 */\n mouseLeaveDelay?: number;\n /**\n * Минимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n minWidth?: number | string;\n /**\n * Максимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n maxWidth?: number | string;\n};\n\nexport type InfinityScrollConfig<RowType extends ObjectForExtending> = {\n /** Триггер достижения скроллом зоны подгрузки данных. */\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n /** Состояние загрузки (скелетоны) новых строк. */\n isLoading: boolean;\n /**\n * Флаг, когда все данные загружены — false.\n * @default true\n */\n hasMore?: boolean;\n /**\n * Для mode='region': за сколько строк до конца триггерить загрузку.\n * @default 5\n */\n rowThreshold?: number;\n};\n\nexport type { TableCanvasEmptyStateConfig, TableCanvasErrorStateConfig };\n\n/**\n * Настройка выделения ячеек/колонок/строк в TableCanvas — единый объект.\n * Это отдельная ось взаимодействия — не зависит от `highlightActiveType`.\n */\nexport type CellsSelectionConfig = {\n /**\n * Режим фактического выделения ячеек (нативный glide selection). По нему\n * работают copy/paste, рамка, fill-handle и затемнение шапки/нумерации.\n * @default \"range-cell\"\n */\n mode?: CellsSelectionMode;\n /**\n * Выделение колонок по клику на шапку. Ctrl/Cmd — добавить/убрать колонку,\n * Shift — диапазон колонок. Клик по иконкам сортировки/фильтрации в шапке\n * выделение НЕ вызывает. Поддерживает copy/paste по выделенным колонкам.\n * @default true\n */\n enableColumnSelection?: boolean;\n /**\n * Выделение строк по клику/драгу на колонке нумерации (`rowMarkers`).\n * Ctrl/Cmd — несмежный выбор отдельных строк, драг — смежный диапазон.\n * Поддерживает copy/paste по выделенным строкам. Требует включённой колонки\n * нумерации (`rowMarkers`). При `false` клик по нумерации ничего не выделяет.\n * @default true\n */\n enableRowSelection?: boolean;\n /**\n * Выделение всей таблицы кликом по «нулевой» ячейке — шапке колонки нумерации\n * (левый верхний угол). Выделяет все строки данных по всем колонкам одним\n * диапазоном; поддерживает copy/paste. Требует включённой колонки нумерации\n * (`rowMarkers`) и активного `mode` (≠ `disabled`).\n * @default true\n */\n enableSelectAll?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — он внутренний.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n};\n\n/** Один объединённый блок: какие строки и колонки слить. */\nexport type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n\n/**\n * Видимость сторон рамки ячейки: true рисовать, false не рисовать, не задано -\n * работает уровень ниже (настройка колонки, строки или общая).\n */\nexport type CellBorderVisibility = {\n top?: boolean;\n right?: boolean;\n bottom?: boolean;\n left?: boolean;\n};\n\n/**\n * Управление рамками (линиями) таблицы: включение и выключение. Уровни, от\n * слабого к сильному: общие настройки (vertical, horizontal), затем колонка\n * (getVerticalBorder) и строка (getHorizontalBorder), затем ячейка\n * (getCellBorder).\n */\nexport type BordersConfig<RowType = ObjectForExtending> = {\n /** Рисовать ли вертикальные линии между колонками. @default true */\n vertical?: boolean;\n /** Рисовать ли горизонтальные линии между строками тела. @default true */\n horizontal?: boolean;\n /**\n * Точечное управление вертикальной линией справа от колонки (разделитель\n * после неё). Вернуть true или false, чтобы переопределить общую настройку\n * vertical, или undefined, чтобы оставить её. Зовётся на каждую видимую\n * колонку при перерисовке, поэтому функция должна быть быстрой.\n */\n getVerticalBorder?: (params: {\n /** Ключ колонки, справа от которой рисуется линия. */\n columnKey: string;\n /** Индекс колонки в порядке отрисовки (закреплённые в начале). */\n columnIndex: number;\n }) => boolean | undefined;\n /**\n * Точечное управление горизонтальной линией сверху строки. Вернуть true или\n * false, чтобы переопределить общую настройку horizontal, или undefined,\n * чтобы оставить её. Для summary-строк не вызывается. Зовётся на каждую\n * видимую строку при перерисовке, поэтому функция должна быть быстрой.\n */\n getHorizontalBorder?: (params: {\n /** Строка под линией (линия рисуется сверху этой строки). */\n row: RowType;\n /** Индекс строки среди отображаемых. При раскрытии subRows индексы сдвигаются. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => boolean | undefined;\n /**\n * Стороны рамки конкретной ячейки, вкл и выкл. Для ячеек без переопределений\n * возвращать undefined. Включает отрисовку линий с разбивкой по ячейкам,\n * поэтому функция должна быть быстрой: без тяжёлых вычислений и с готовыми\n * объектами-константами вместо новых на каждый вызов. Для summary-строк не\n * вызывается.\n */\n getCellBorder?: (params: {\n /** Индекс колонки среди отображаемых (без служебных). */\n col: number;\n /** Ключ колонки. */\n columnKey: string | undefined;\n /** Строка ячейки. */\n row: RowType;\n /** Индекс строки среди отображаемых. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => CellBorderVisibility | undefined;\n};\n\nexport type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * Готовые варианты внешнего вида таблицы.\n *\n * `variant: 'clean'` — без линий сетки и внешних рамок, шапка на белом фоне\n * с серым текстом. Отдельные линии можно вернуть через `borders`.\n *\n * `zebra: true` — строки через одну окрашены серым, работает в любом варианте.\n */\n appearance?: AppearanceConfig;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@sber-digital-finance-ui/ui-kit';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n };\n /**\n * editing - активация редактирования. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={editing: {onRowsChange, rowKeyGetter}}\n *\n * columnConfig=[{editingCell: {...}}]\n */\n editing?: EditingConfig<RowType, RowIdType, SummaryRowType>;\n\n /**\n * cellTransfer — конфигурация копирования, вставки и fill handle.\n * По умолчанию копирование (Ctrl+C) работает в режиме редактирования.\n * Данные копируются в формате TSV (tab-separated values), совместимом с Excel.\n *\n * Пример:\n *\n * tableConfig={{ cellTransfer: { enabled: true, onBeforeCopy: (data) => data } }}\n */\n cellTransfer?: CellTransferConfig;\n\n /**\n * Объединение ячеек тела таблицы.\n *\n * mergeByCellValues — колонки, в которых подряд идущие одинаковые значения\n * сливаются в один блок (по вертикали). Границы блоков таблица считает сама из\n * данных; сортировка и фильтр их пересобирают. Данные не меняются — значение и\n * так повторяется в строках, объединение лишь показывает его одной ячейкой.\n *\n * mergedCellsRegions — список блоков, заданных снаружи (как выделение): каждый\n * блок описан ключами строк (rowKeys) и колонок (colKeys). Нужен rowKeyGetter.\n * Если после сортировки или скрытия колонок строки/колонки блока перестали идти\n * подряд — блок не рисуется. Важнее mergeByCellValues.\n *\n * Примеры: mergeCells={{ mergeByCellValues: ['dept', 'role'] }},\n * mergeCells={{ mergedCellsRegions, rowKeyGetter: (r) => r.id }}.\n */\n mergeCells?: {\n mergeByCellValues?: Array<\n string | { colKey: string; value: (row: RowType) => unknown }\n >;\n /** Список блоков, заданных снаружи (по ключам строк и колонок). */\n mergedCellsRegions?: MergedCellsRegion[];\n /**\n * Нужен для mergedCellsRegions: находит строку по её ключу. Должна быть\n * стабильной функцией; менять её на лету не нужно — в пересборку таблицы она\n * не входит.\n */\n rowKeyGetter?: (row: RowType) => string | number;\n /**\n * Выравнивание по умолчанию для всех блоков. Колоночный mergedCellsAlign и\n * выравнивание конкретного региона важнее.\n */\n mergedCellsAlign?: MergedCellsAlign;\n };\n\n /**\n * Модуль нотификаций: стандартизированный канал событий для внешних\n * потребителей. Таблица UI не рисует — вызывает `onNotification`, потребитель\n * показывает тост/модалку на своей стороне. Сейчас эмитятся ошибки copy/paste\n * (в т.ч. multi-range 2D-разброс, readonly/overflow-abort, пропуск валидацией).\n */\n notifications?: TableNotificationsConfig;\n\n /**\n * subRows - активация иерархии, отображения вложенных строк. Условие активации - наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={subRows: {getSubRows, rowKeyGetter}}\n *\n * columnConfig=[{subRow: {...}}]\n */\n subRows?: SubRows<RowType, RowIdType>;\n /**\n * Столбец с нумерацией строк.\n * Активируется наличием этого свойства. Поддерживает `subRows` любой глубины.\n *\n * @see {@link RowMarkersTableConfig} — полное описание конфигурации и примеры.\n */\n rowMarkers?: RowMarkersTableConfig<RowType>;\n rowsGrouping?: RowsGrouping<RowType, SummaryRowType>;\n\n /**\n * resizableColumn - активация изменения ширины колонки с помощью курсора. Условие активации - resizableColumn: true. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={resizableColumn: true}\n *\n * columnConfig=[{resizable: true}]\n */\n resizableColumn?: boolean;\n /**\n * style - inline-стили. Для стилей самой таблицы (без вложенности).\n *\n * Исключены свойства 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'. Их следует стилизовать через свойства containerStyle.\n */\n style?: Omit<\n CSSProperties,\n 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'\n >;\n /**\n * css - для стилей простых и сложных(например, для стилизации cell, headerCell, ...).\n *\n * Пример:\n *\n * ```css\n * & > .rdg-header-row > .rdgCell {\n * background-color: red;\n * }\n * ```\n *\n */\n css?: string | CSSObject;\n\n summaryRows?: SummaryRowsConfig;\n /**\n * controlBlock - пропс для активации, кастомизации контролблока.\n */\n controlBlock?: ControlBlockConfig;\n /**\n * containerStyle - инлайновые стили контейнера таблицы и контролблока. высоту и ширину для таблицы рекомендуется задавать в этом пропсе.\n * Пример:\n *\n * ```tsx\n tableConfig={{ containerStyle: { height: '70vh' } }}\n * ```\n */\n containerStyle?: CSSProperties | undefined;\n /**\n * containerCss - стили для контейнера таблицы и контролблока.\n * Через этот пропс можно дополнительно кастомизировать контейнер и все его дочерние элементы.\n */\n containerCss?: string | CSSObject | undefined;\n /**\n * containerId - html-атрибут id контейнера таблицы.\n */\n containerId?: string | undefined;\n\n /**\n * unstickyHeader - откреплённая шапка. Header уезжает вместе со скроллом контента.\n * @default false\n */\n unstickyHeader?: boolean;\n\n /**\n * stickyColumns - колонки, которые прилипают к левому краю при горизонтальной прокрутке,\n * как `position: sticky`. Ключи колонок или предикат по колонке.\n *\n * ```tsx\n * tableConfig={{ stickyColumns: ['region', 'total'] }}\n * tableConfig={{ stickyColumns: (column) => column.key.startsWith('total') }}\n * ```\n */\n stickyColumns?: StickyColumnsConfig<ColumnConfig<RowType, SummaryRowType>>;\n\n /**\n * stickyRows - строки, которые прилипают под шапкой при вертикальной прокрутке.\n * Предикат проверяется для каждой отображаемой строки данных (результаты кешируются); строки групп\n * (`rowsGrouping`) и заглушки загрузки в него не попадают и липкими не становятся.\n * Индексы передаются как есть — удобно для больших таблиц, где позиции известны заранее. Они\n * считаются по итоговому отображаемому списку: сортировка, фильтры, группировка и раскрытые узлы\n * дерева (`subRows`) сдвигают нумерацию — тогда индексы нужно пересчитывать или передать предикат.\n *\n * ```tsx\n * tableConfig={{ stickyRows: (row) => row.isSubtotal }}\n * tableConfig={{ stickyRows: [0, 41, 82] }}\n * ```\n */\n stickyRows?: StickyRowsConfig<RowType>;\n\n /** Тултип при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\n tooltip?: TableConfigTooltip;\n\n /**\n * infinityScroll - бесконечная подгрузка данных при скролле.\n *\n * Условие активации - наличие самого пропса infinityScroll.\n *\n * При активации infinityScroll отключается дефолтная сортировка и фильтрация.\n * (Предполагается, что если есть infinityScroll,\n * то в таблице представлен не весь объем данных,\n * по этой причине дефолтная сортировка и фильтрация не подходят и будут отображать некорректные данные)\n *\n */\n infinityScroll?: InfinityScrollConfig<RowType>;\n /**\n * @isLoading - состояние загрузки данных для таблицы.\n */\n isLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n /**\n * loadingOverlay - конфигурация для отображения оверлея загрузки.\n * Показывает индикатор загрузки поверх таблицы с возможностью кастомизации.\n */\n loadingOverlay?: {\n /**\n * Активен ли оверлей загрузки\n * @default true\n */\n active?: boolean;\n /**\n * Кастомный компонент спиннера\n * @default <Spinner view=\"secondary\" size=\"36\" /> (внутренний компонент)\n */\n spinner?: ReactNode;\n /**\n * Основной заголовок оверлея\n * @default \"Загрузка таблицы\"\n */\n title?: string;\n /**\n * Подзаголовок, который появится после задержки, пустая строка - значит он не появится\n * @default \"\"\n */\n subtitle?: string;\n /**\n * Задержка перед показом подзаголовка (мс)\n * @default 10000 (10 секунд)\n */\n showSubtitleDelay?: number;\n };\n /**\n * Empty state внутри content-области canvas-таблицы.\n * Не заменяет control block, header или pagination.\n */\n emptyState?: TableCanvasEmptyStateConfig;\n /**\n * Error state внутри content-области canvas-таблицы.\n * Не заменяет control block, header или pagination.\n */\n errorState?: TableCanvasErrorStateConfig;\n // FIXME:\n // noRowsFallback?: boolean | { custom: ReactNode };\n columnsControl?: ColumnsControlConfig;\n // FIXME:\n // rowDetailPanel?: RowDetailConfig<RowType>;\n // FIXME: Временно комментирую использование, пока не адаптируем TableCanvas\n // rowInstruments?: {\n // getRowDropdownConfig: RowInstrumentsType<RowType>;\n // /**\n // * @default false\n // */\n // defaultOpened?: boolean;\n // /**\n // * @default true\n // */\n // showInControl?: boolean;\n // /**\n // * Внешний стейт видимости\n // */\n // openedState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n // };\n fullScreenEnabled?: FullScreen;\n /**\n * Переносит портал editor overlay внутрь контейнера таблицы вместо document.body.\n * Решает проблему focus trap и сдвига координат при рендере таблицы в модалке с CSS transform.\n * @default undefined (overlay рендерится в document.body — стандартное поведение)\n */\n editorOverlayPortal?: 'inside';\n keyText?: boolean | KeyTextConfig;\n /**\n * pagination - пропс для пагинации.\n *\n * Условие активации - наличие самого пропса pagination.\n *\n * При активации pagination отключается дефолтные поиск, сортировка и фильтрация.\n * (поиск работает на уровне с фильтрацией и сортировкой, сначала поиск, затем фильтрация, затем сортировка)\n *\n */\n pagination?: PaginationProps;\n /**\n * searching - пропс для поиска по таблицу.\n *\n * Условие активации - наличие searching.enabled: true\n *\n */\n /**\n * Конфигурация табов в сайдбаре\n */\n /** @deprecated Используйте rightSidebarConfig. При наличии обоих приоритет у rightSidebarConfig. */\n sidebarConfig?: SidebarConfig;\n /** Конфигурация правой панели. */\n rightSidebarConfig?: RightSidebarConfig;\n /** Конфигурация пользовательских вкладок левой панели (режим строк). */\n leftSidebarConfig?: LeftSidebarConfig;\n /** Нижний слот в режиме строк. Не увеличивает внешний контейнер таблицы. */\n bottomSheetConfig?: BottomSheetConfig;\n searching?: SearchingProps;\n /**\n * onHeaderContextMenu - callback открытия контекстного меню.\n */\n onHeaderContextMenu?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onHeaderContextMenu'];\n onHeaderContextMenuDropdown?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onHeaderContextMenuDropdown'];\n onCellContextMenuDropdown?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onCellContextMenuDropdown'];\n onCellContextMenu?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onCellContextMenu'];\n /**\n * Обработчик клика по ячейке.\n *\n * Получает `cell` readonly [colIndex, rowIndex] от glide, и `info` обогащённый объект\n * с row, column, ctxs, refTable (аналогично onCellContextMenu).\n */\n onCellClicked?: (\n cell: readonly [number, number],\n info: TableInfoWithRow<RowType, SummaryRowType>,\n ) => void;\n} & GlideInstanceOmitted<RowType, SummaryRowType>;\n\ntype GlideInstanceOmitted<\n RowType extends ObjectForExtending,\n SummaryRowType,\n> = Pick<\n Omit<\n TableGlideInstanceProps<RowType, SummaryRowType>,\n | keyof TableGlideCustomProps<RowType, SummaryRowType>\n | 'CellReadOnlyEditor' /* CellReadOnlyEditor - свойство только для GlideInstance */\n >,\n | 'className'\n | 'columnSelect'\n | 'minColumnWidth'\n | 'maxColumnWidth'\n | 'maxColumnAutoWidth'\n | 'onVisibleRegionChanged'\n | 'onCellClicked'\n // | 'CellReadOnlyEditor'\n // | 'onGroupHeaderClicked'\n | 'onHeaderClicked'\n | 'onItemHovered'\n | 'trapFocus'\n | 'onColumnResize'\n>;\nexport type CellReadOnlyEditorProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n> = CellReadOnlyEditorGlideInstanceStaticProps &\n EditingCellInfo<RowType, SummaryRowType>;\n\n// & Pick<\n// DataGridPropsDefault<RowType, SummaryRowType, RowIdType>,\n// | 'summaryRowHeight'\n// | 'onFill'\n// | 'onCopy'\n// | 'onPaste'\n// | 'onCellClick'\n// | 'onCellDoubleClick'\n// | 'onCellContextMenu'\n// | 'onCellKeyDown'\n// | 'onSelectedCellChange'\n// | 'onScroll'\n// | 'onColumnResize'\n// | 'onColumnsReorder'\n// | 'enableVirtualization'\n// | 'rowClass'\n// | 'data-testid'\n// | 'headerRowHeight'\n// >;\n\n/**\n * Конфигурация фичи rowMarkers (столбец с нумерацией строк).\n *\n * Столбец frozen, вставляется первым, исключён из reorder/pin/hide/sort/grouping.\n * Поддерживает плоский и древовидный (`subRows`) режимы любой глубины вложенности.\n *\n * **Дефолтное поведение** (без `getRowMarker`): root-only нумерация —\n * корневые строки получают номер (`startIndex + rootIndex`), дочерние — пустую строку.\n *\n * @example\n * ```tsx\n * // Минимальная конфигурация\n * tableConfig={{ rowMarkers: { startIndex: 1 } }}\n *\n * // Сквозная стабильная нумерация\n * tableConfig={{ rowMarkers: { getRowMarker: ({ flatIndex }) => flatIndex + 1 } }}\n * ```\n */\nexport type RowMarkersTableConfig<\n RowType extends ObjectForExtending = ObjectForExtending,\n> = {\n /**\n * Стартовый индекс нумерации (для дефолтной логики без `getRowMarker`).\n * @default 1\n */\n startIndex?: number;\n\n /**\n * Ширина столбца с нумерацией (в px).\n * Если задан `size` — он приоритетнее.\n+ * Если ни `size`, ни `width` не заданы — ширина подстраивается\n+ * под глобальный `tableConfig.rowSize` (small=20, medium=32, big=48).\n * @default 32\n */\n width?: number;\n /**\n * Размер столбца. Приоритетнее `width`.\n * - `xs` = 20px\n * - `s` = 32px\n * - `m` = 48px\n */\n size?: 'xs' | 's' | 'm';\n /**\n * Кастомная функция нумерации. Полностью переопределяет дефолтную root-only логику.\n * Вызывается при рендере каждой ячейки столбца нумерации.\n *\n * ⚠️ Вызывается не только при полной отрисовке таблицы, но и при ховере/скролле —\n * для **одной** ячейки. Не используйте внешние переменные-счётчики —\n * используйте аргументы (`siblingPath`, `flatIndex` и др.), они всегда актуальны.\n *\n * @example\n * // Сквозная стабильная нумерация (все строки, номера не прыгают при сворачивании)\n * getRowMarker: ({ flatIndex }) => flatIndex + 1\n *\n * @example\n * // Корневые — номер, дочерние — прочерк\n * getRowMarker: ({ isSubRow, flatIndex }) => isSubRow ? '—' : flatIndex + 1\n *\n * @example\n * // Иерархическая нумерация любой глубины: 1, 1.1, 1.1.1, 1.2, 2\n * getRowMarker: ({ siblingPath }) => siblingPath.map(i => i + 1).join('.')\n */\n getRowMarker?: (args: {\n /** Данные текущей строки. */\n row: RowType;\n /** Уровень строки в дереве: `0` — корневая, `1` — дочерняя, `2` — внучка, и т.д. */\n level: number;\n /** `true`, если строка дочерняя (`level > 0`). */\n isSubRow: boolean;\n /**\n * Индекс строки в **видимых** строках.\n * **Нестабильный** — меняется при сворачивании и разворачивании веток.\n */\n rowIndex: number;\n /**\n * Стабильный 0-based индекс строки в **полном** дереве (включая скрытые/свёрнутые).\n * Не меняется при collapse/expand — подходит для сквозной нумерации.\n */\n flatIndex: number;\n /**\n * Порядковый номер среди siblings одного родителя (0-based).\n * Для корневых строк — порядковый номер среди всех корневых.\n * Для дочерних — порядковый номер среди children одного `parentKey`.\n */\n siblingIndex: number;\n /**\n * Путь siblingIndex-ов от корня до текущей строки (каждый элемент 0-based).\n *\n * Примеры:\n * - корневая строка (2-я): `[1]`\n * - дочерняя (3-й ребёнок 2-го корня): `[1, 2]`\n * - внучка (1-й ребёнок 1-го ребёнка 1-го корня): `[0, 0, 0]`\n *\n * Для иерархической нумерации: `siblingPath.map(i => i + 1).join('.')` → `\"1.1.1\"`\n *\n * Для плоской таблицы (без subRows): всегда `[siblingIndex]` (один элемент).\n */\n siblingPath: number[];\n /**\n * Ключ родительской строки (`rowKeyGetter(parent)`).\n * `null` для корневых строк. Работает для **любой** глубины вложенности.\n */\n parentKey: string | number | null;\n /** Текущий видимый `flattened` массив строк. */\n rows: readonly RowType[];\n }) => string | number;\n};\n```\n\n## FilterComponentInPopoverProps\n\nПропсы, доступные в кастомном компоненте фильтра (`component: 'custom'`).\n\n```typescript\ntype FilterComponentInPopoverProps<\n FilterStateType extends ObjectForExtending,\n ColumnConfig,\n> = {\n popoverIsOpen: boolean;\n setPopoverIsOpen: React.Dispatch<React.SetStateAction<boolean>>;\n columnConfig: ColumnConfig;\n tabIndex: number;\n headerContextState: HeaderContextValueTypeInstance<FilterStateType> &\n FiltersVariables &\n HeaderContextValueTypeInstance<ObjectForExtending>;\n /**\n * Источник открытия фильтра: из шапки таблицы или из сайдбара\n * Полезно для условной логики в customRender (например, alwaysOpened для combobox)\n */\n filterSource?: 'header' | 'sidebar';\n};\n```",
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 '@sber-digital-finance-ui/ui-kit';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n };\n /**\n * editing - активация редактирования. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={editing: {onRowsChange, rowKeyGetter}}\n *\n * columnConfig=[{editingCell: {...}}]\n */\n editing?: EditingConfig<RowType, RowIdType, SummaryRowType>;\n\n /**\n * cellTransfer — конфигурация копирования, вставки и fill handle.\n * По умолчанию копирование (Ctrl+C) работает в режиме редактирования.\n * Данные копируются в формате TSV (tab-separated values), совместимом с Excel.\n *\n * Пример:\n *\n * tableConfig={{ cellTransfer: { enabled: true, onBeforeCopy: (data) => data } }}\n */\n cellTransfer?: CellTransferConfig;\n\n /**\n * Объединение ячеек тела таблицы.\n *\n * mergeByCellValues — колонки, в которых подряд идущие одинаковые значения\n * сливаются в один блок (по вертикали). Границы блоков таблица считает сама из\n * данных; сортировка и фильтр их пересобирают. Данные не меняются — значение и\n * так повторяется в строках, объединение лишь показывает его одной ячейкой.\n *\n * mergedCellsRegions — список блоков, заданных снаружи (как выделение): каждый\n * блок описан ключами строк (rowKeys) и колонок (colKeys). Нужен rowKeyGetter.\n * Если после сортировки или скрытия колонок строки/колонки блока перестали идти\n * подряд — блок не рисуется. Важнее mergeByCellValues.\n *\n * Примеры: mergeCells={{ mergeByCellValues: ['dept', 'role'] }},\n * mergeCells={{ mergedCellsRegions, rowKeyGetter: (r) => r.id }}.\n */\n mergeCells?: {\n mergeByCellValues?: Array<\n string | { colKey: string; value: (row: RowType) => unknown }\n >;\n /** Список блоков, заданных снаружи (по ключам строк и колонок). */\n mergedCellsRegions?: MergedCellsRegion[];\n /**\n * Нужен для mergedCellsRegions: находит строку по её ключу. Должна быть\n * стабильной функцией; менять её на лету не нужно — в пересборку таблицы она\n * не входит.\n */\n rowKeyGetter?: (row: RowType) => string | number;\n /**\n * Выравнивание по умолчанию для всех блоков. Колоночный mergedCellsAlign и\n * выравнивание конкретного региона важнее.\n */\n mergedCellsAlign?: MergedCellsAlign;\n };\n\n /**\n * Модуль нотификаций: стандартизированный канал событий для внешних\n * потребителей. Таблица UI не рисует — вызывает `onNotification`, потребитель\n * показывает тост/модалку на своей стороне. Сейчас эмитятся ошибки copy/paste\n * (в т.ч. multi-range 2D-разброс, readonly/overflow-abort, пропуск валидацией).\n */\n notifications?: TableNotificationsConfig;\n\n /**\n * subRows - активация иерархии, отображения вложенных строк. Условие активации - наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={subRows: {getSubRows, rowKeyGetter}}\n *\n * columnConfig=[{subRow: {...}}]\n */\n subRows?: SubRows<RowType, RowIdType>;\n /**\n * Столбец с нумерацией строк.\n * Активируется наличием этого свойства. Поддерживает `subRows` любой глубины.\n *\n * @see {@link RowMarkersTableConfig} — полное описание конфигурации и примеры.\n */\n rowMarkers?: RowMarkersTableConfig<RowType>;\n rowsGrouping?: RowsGrouping<RowType, SummaryRowType>;\n\n /**\n * resizableColumn - активация изменения ширины колонки с помощью курсора. Условие активации - resizableColumn: true. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={resizableColumn: true}\n *\n * columnConfig=[{resizable: true}]\n */\n resizableColumn?: boolean;\n /**\n * style - inline-стили. Для стилей самой таблицы (без вложенности).\n *\n * Исключены свойства 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'. Их следует стилизовать через свойства containerStyle.\n */\n style?: Omit<\n CSSProperties,\n 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'\n >;\n /**\n * css - для стилей простых и сложных(например, для стилизации cell, headerCell, ...).\n *\n * Пример:\n *\n * ```css\n * & > .rdg-header-row > .rdgCell {\n * background-color: red;\n * }\n * ```\n *\n */\n css?: string | CSSObject;\n\n summaryRows?: SummaryRowsConfig;\n /**\n * controlBlock - пропс для активации, кастомизации контролблока.\n */\n controlBlock?: ControlBlockConfig;\n /**\n * containerStyle - инлайновые стили контейнера таблицы и контролблока. высоту и ширину для таблицы рекомендуется задавать в этом пропсе.\n * Пример:\n *\n * ```tsx\n tableConfig={{ containerStyle: { height: '70vh' } }}\n * ```\n */\n containerStyle?: CSSProperties | undefined;\n /**\n * containerCss - стили для контейнера таблицы и контролблока.\n * Через этот пропс можно дополнительно кастомизировать контейнер и все его дочерние элементы.\n */\n containerCss?: string | CSSObject | undefined;\n /**\n * containerId - html-атрибут id контейнера таблицы.\n */\n containerId?: string | undefined;\n\n /**\n * unstickyHeader - откреплённая шапка. Header уезжает вместе со скроллом контента.\n * @default false\n */\n unstickyHeader?: boolean;\n\n /**\n * stickyColumns - колонки, которые прилипают к левому краю при горизонтальной прокрутке,\n * как `position: sticky`. Ключи колонок или предикат по колонке.\n *\n * ```tsx\n * tableConfig={{ stickyColumns: ['region', 'total'] }}\n * tableConfig={{ stickyColumns: (column) => column.key.startsWith('total') }}\n * ```\n */\n stickyColumns?: StickyColumnsConfig<ColumnConfig<RowType, SummaryRowType>>;\n\n /**\n * stickyRows - строки, которые прилипают под шапкой при вертикальной прокрутке.\n * Предикат проверяется для каждой отображаемой строки данных (результаты кешируются); строки групп\n * (`rowsGrouping`) и заглушки загрузки в него не попадают и липкими не становятся.\n * Индексы передаются как есть — удобно для больших таблиц, где позиции известны заранее. Они\n * считаются по итоговому отображаемому списку: сортировка, фильтры, группировка и раскрытые узлы\n * дерева (`subRows`) сдвигают нумерацию — тогда индексы нужно пересчитывать или передать предикат.\n *\n * ```tsx\n * tableConfig={{ stickyRows: (row) => row.isSubtotal }}\n * tableConfig={{ stickyRows: [0, 41, 82] }}\n * ```\n */\n stickyRows?: StickyRowsConfig<RowType>;\n\n /** Тултип при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\n tooltip?: TableConfigTooltip;\n\n /**\n * infinityScroll - бесконечная подгрузка данных при скролле.\n *\n * Условие активации - наличие самого пропса infinityScroll.\n *\n * При активации infinityScroll отключается дефолтная сортировка и фильтрация.\n * (Предполагается, что если есть infinityScroll,\n * то в таблице представлен не весь объем данных,\n * по этой причине дефолтная сортировка и фильтрация не подходят и будут отображать некорректные данные)\n *\n */\n infinityScroll?: InfinityScrollConfig<RowType>;\n /**\n * @isLoading - состояние загрузки данных для таблицы.\n */\n isLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n /**\n * loadingOverlay - конфигурация для отображения оверлея загрузки.\n * 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```",
49870
50652
  "api": [
49871
50653
  {
49872
50654
  "typeName": "FilteringConfig",
49873
- "source": "type FilteringConfig<T> = {\n state: [T, React.Dispatch<React.SetStateAction<T>>];\n /**\n * @deprecated Использовать filtersInfo\n *\n * clearedValue - состояние фильтров после очистки. Используется для сравнения:\n * Например, был ли фильтр конкретной колонки изменен рассчитывается посредством сравнения текущего значения фильтра и значения фильтра в clearedValue.\n * Если они равны, то фильтр считается не измененным.\n */\n clearedValue?: T;\n /**\n * Информация о фильтрах для каждой колонки.\n * Используется для:\n * 1. Хранения меток (label) фильтров для отображения в UI\n * 2. Хранения значений по умолчанию (clearedValue) для каждого фильтра\n * 3. Определения, был ли фильтр изменен (сравнение текущего значения с clearedValue)\n */\n filtersInfo?: Record<\n keyof T,\n {\n label: string;\n clearedValue: T[keyof T];\n }\n >;\n /**\n * manualFiltering - пропс, активирующий ручную-кастомную (или на стороне бэка) фильтрацию.\n * @remarks\n * Для автоматической фильтрации (когда не используется manualFiltering в tableConfig):\n * - Для всех типов фильтров обязательно должен быть указан `valueInRow`\n * - Для component: 'select' дополнительно должен быть указан `filteringType`\n * - Для component: 'input' с кастомным фильтром (когда filter - функция)\n * функция фильтрации должна быть передана явно\n *\n * Если используется manualFiltering, эти параметры не обязательны,\n * так как вся логика фильтрации реализуется извне.\n */\n manualFiltering?: boolean;\n /**\n * Конфигурация для отображения фильтров в правом сайдбаре.\n *\n * Позволяет:\n * 1. Добавлять глобальные фильтры (не привязанные к конкретной колонке)\n * 2. Управлять порядком отображения фильтров\n * 3. Переопределять рендер и заголовки колоночных фильтров\n *\n * Логика работы:\n * - По умолчанию в сайдбаре отображаются все колоночные фильтры (из columnConfig)\n * - Ключом фильтра считается `key` колонки, если его нет, то пытаемся взять `keyInFilterState` (если указан), иначе это не будет работать\n * - Заголовком фильтра по умолчанию является `name` колонки или ключ фильтра (name || key)\n * - Глобальные фильтры добавляются через `items` с уникальными ключами\n *\n * Особенности:\n * 1. Порядок отображения:\n * - Сначала фильтры из `order` (в указанной последовательности)\n * - Затем остальные колоночные фильтры (в порядке columnConfig)\n * - В конце - глобальные фильтры (в алфавитном порядке ключей)\n *\n * 2. Переопределение колоночных фильтров:\n * - Чтобы изменить заголовок: укажите ключ колонки в `items` с новым `label`\n * - Чтобы заменить рендер: укажите ключ колонки с `customRenderFn`\n * - Оригинальный фильтр из колонки будет проигнорирован\n *\n * 3. Глобальные фильтры:\n * - Ключ не должен совпадать с ключами колонок\n * - Обязательно указать `label` и `customRenderFn`\n * - Отображаются после всех колоночных фильтров, если не переопределены в order\n *\n * @example\n * // Добавление глобального фильтра и изменение порядка\n * sidebarConfig: {\n * order: ['status', 'tasks', 'type'], // Сначала статус, затем глобальный поиск\n * items: {\n * tasks: { // Уникальный ключ\n * label: 'Поиск по всем полям',\n * customRenderFn: () => <TaskComponent />\n * },\n * status: { // Переопределение колоночного фильтра\n * label: 'Статус заявки', // Новый заголовок\n * customRenderFn: () => <CustomStatusFilter /> // Кастомный рендер\n * }\n * type: { // Переопределение только Label колоночного фильтра\n * label: 'Тип', // Новый заголовок\n * }\n * }\n * }\n */\n sidebarConfig?: {\n /**\n * Определяет порядок отображения фильтров.\n * - Указываются ключи фильтров (колоночных или глобальных)\n * - Не указанные в order фильтры отображаются после\n * - Если order пуст, сохраняется порядок: глобальные фильтры + columnConfig фильтры в конце\n */\n order?: string[];\n /**\n * Конфигурация фильтров для сайдбара.\n * Ключом может быть:\n * - Ключ колонки (для переопределения колоночного фильтра)\n * - Уникальный ключ (для добавления глобального фильтра)\n */\n items: Partial<\n Record<\n keyof T,\n {\n /** Заголовок фильтра (обязателен для глобальных фильтров), можно использовать для переопределения для локальных фильтров */\n label: string;\n /**\n * Функция рендера компонента фильтра.\n * Для колоночных фильтров переопределяет оригинальный рендер.\n * Для глобальных фильтров обязательна.\n */\n customRenderFn?: (\n filters: T,\n setFilters: React.Dispatch<React.SetStateAction<T>>,\n ) => React.ReactNode;\n }\n >\n >;\n };\n /**\n * Callback для кастомизации стилей чипсов (фильтров) в списке\n *\n * @param {ItemOrGroup} itemOrGroup - Текущий элемент или группа фильтров\n * @param {Item | undefined} item - Конкретный элемент фильтра (если есть)\n * @returns {CSSObject} Объект стилей, который будет применен к чипсу\n *\n * @description\n * Позволяет динамически задавать стили для каждого чипса в зависимости от его типа и содержимого.\n * Вызывается для каждого отображаемого чипса (как для отдельных элементов, так и для элементов внутри групп).\n *\n * @example\n * // Пример 1: Стилизация чипсов по типу\n * chipStyle: (itemOrGroup, item) => {\n * if (isGroup(itemOrGroup)) {\n * return { backgroundColor: '#f0f0f0' };\n * }\n * return { backgroundColor: '#e0e0e0' };\n * }\n *\n * @example\n * // Пример 2: Стилизация по значению фильтра\n * chipStyle: (itemOrGroup, item) => {\n * if (item?.label === 'Высокий приоритет') {\n * return {\n * backgroundColor: '#ffebee',\n * color: '#d32f2f'\n * };\n * }\n * return {};\n * }\n *\n * @example\n * // Пример 3: Разные стили для элементов в группе и одиночных\n * chipStyle: (itemOrGroup, item) => {\n * if (item) {\n * // Стиль для элемента внутри группы\n * return { maxWidth: 180 };\n * }\n * // Стиль для одиночного чипа\n * return { maxWidth: 150 };\n * }\n */\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n /**\n * Пользовательский форматтер заголовка группы чипсов.\n *\n * Используется в блоке активных фильтров для подмены текста заголовка\n * группы (например, “Статус”, “Тип”, “Автор”). Полезно, когда нужно\n * динамически менять подпись (добавить счётчик, i18n и т.п.).\n *\n * @param {ItemOrGroup} itemOrGroup Объект группы (тип Group). Вызов происходит только для групп,\n * поэтому безопасно кастовать к Group.\n * @returns {string} Текст заголовка группы чипсов.\n *\n * @default Возвращается `group.groupLabel`.\n *\n * @remarks\n * - Функция должна быть чистой и быстрой (без сетевых запросов и побочных эффектов).\n * - Возвращайте ТОЛЬКО строку — чипы отображают текстовое значение.\n * - Для длинных строк применяется усечение (overflow с многоточием) на уровне компонента.\n *\n * @example\n * // Добавить двоеточие и количество выбранных элементов\n * renderGroupLabel: (group) => `${group.groupLabel}: ${group.items.length}`\n *\n * @example\n * // Локализация заголовка группы\n * const i18n = { status: 'Статус', type: 'Тип' };\n * renderGroupLabel: (group) => i18n[group.groupId] ?? group.groupLabel\n */\n renderGroupLabel?: (group: Group) => string;\n\n /**\n * Пользовательский форматтер текста чипса (элемента внутри группы или одиночного фильтра).\n *\n * Позволяет управлять тем, что именно отображается внутри каждого чипса. Особенно полезен\n * при серверной пагинации/ленивой загрузке, когда в состоянии фильтра хранится только value,\n * а label необходимо подставить из локального кэша.\n *\n * @param {Group | null } group Группа, внутри которой рендерится чип (или null).\n * @param {Item} item Сам элемент чипса. В группах передаётся конкретный `Item`,\n * для одиночного чипа может быть `undefined`.\n * @returns {string} Текст, который будет показан в чипсе.\n *\n * @default Используется `item?.label.toString()` (или строковое представление value).\n *\n * @remarks\n * - Функция должна быть чистой и быстрой;\n * - Возвращайте ТОЛЬКО строку.\n *\n * @example\n * // 1) Отображение label из кэша при серверной пагинации\n * const labelsCacheRef = useRef(new Map<string, string>());\n * renderChipLabel: (group, item) => {\n * if (item?.id != null) {\n * const key = String(item.id);\n * const fromCache = labelsCacheRef.current.get(key);\n * if (fromCache) return fromCache; // красивый label, если уже загрузили\n * return String(item.label ?? key); // фоллбэк: временно показываем value/label из item\n * }\n * return ''; // безопасный фоллбэк для одиночных случаев\n * }\n *\n * @example\n * // 2) Нормализация отображения числовых значений\n * renderChipLabel: (_group, item) => {\n * const v = Number(item?.label);\n * return Number.isFinite(v) ? v.toLocaleString('ru-RU') : String(item?.label ?? '');\n * }\n *\n * @example\n * // 3) Префикс по типу группы\n * renderChipLabel: (group, item) => {\n * const prefix = group.groupId === 'status' ? '' : '#';\n * return `${prefix}${item?.label ?? item?.id ?? ''}`;\n * }\n */\n renderChipLabel?: (group: Group | null, item: Item) => string;\n};\n\nexport type DefaultSidebarTabIds = 'columns' | 'tableSettings' | 'filtering';\n\n/**\n * Общие настройки пользовательских вкладок левой и правой панели TableCanvas.\n */\nexport type TableCanvasSidebarConfig = {\n /**\n * Включен ли sidebar. Отвечает только за UI. Не влияет на перерасчёт фичей.\n * @default true\n */\n enabled?: boolean;\n /**\n * Открыт ли sidebar при первом рендере (uncontrolled-режим).\n * Игнорируется, если передан openState.\n * @default false\n */\n defaultOpen?: boolean;\n /**\n * Внешний контроль открытия/закрытия sidebar.\n * Если передан — источник истины, defaultOpen игнорируется.\n */\n openState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * id вкладки, выбранной по умолчанию (актуально при открытом сайдбаре).\n * Если id не найден или у вкладки showInSidebar=false — используется первая доступная.\n */\n defaultActiveTabId?: string;\n /**\n * Внешний контроль активной вкладки (controlled-режим).\n * Если передан — источник истины, defaultActiveTabId игнорируется.\n */\n activeTabState?: [\n string | null,\n React.Dispatch<React.SetStateAction<string | null>>,\n ];\n /**\n * Колбэк смены активной вкладки. Вызывается и в uncontrolled-режиме.\n * При закрытии сайдбара приходит null.\n */\n onActiveTabChange?: (tabId: string | null, tab?: SidebarTab) => void;\n /**\n * Кастомные табы\n */\n customTabs?: Array<\n Omit<SidebarTab, 'id'> & {\n id: Exclude<string, DefaultSidebarTabIds>;\n }\n >;\n /**\n * Порядок отображения кастомных вкладок\n */\n customTabsOrder?: Array<Exclude<string, DefaultSidebarTabIds>>;\n /**\n * Ширина контента без полоски вкладок (44px). Число — px, строка — CSS.\n * Проценты считаются от ширины рабочей области TableCanvas.\n * Изменение пропса сразу меняет ширину открытой панели.\n * По умолчанию: 300px слева, 400px справа.\n */\n width?: string | number;\n};\n\n/** Настройки правой панели; встроенные вкладки доступны только справа. */\nexport type SidebarConfig = TableCanvasSidebarConfig & {\n defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара (если данный таб окажется единственным табом в настройках) */\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки (для табов с id = filtering и columns - недоступен. Настраивается через таб с id='tableSettings') */\n iconTooltipText?: undefined;\n }\n | {\n id: 'tableSettings';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара */\n title?: string;\n\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный слот для вкладки tableSettings (рендерится после общих настроек)\n * Только дл id: 'tableSettings'\n */\n customGeneralSettingsSlot?: React.ReactNode;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки @default 'Настройки' */\n iconTooltipText?: string;\n }\n >;\n};\n\n/** Конфигурация правой панели. SidebarConfig сохранён для совместимости. */\nexport type RightSidebarConfig = SidebarConfig;\n\n/** Пользовательские вкладки слева; встроенных вкладок настроек нет. */\nexport type LeftSidebarConfig = TableCanvasSidebarConfig;\n\n/** Нижний слот под canvas, над пагинацией, между боковыми панелями. */\nexport type BottomSheetConfig = {\n /** @default true */\n enabled?: boolean;\n /** Число — px, строка — CSS; 'auto' — по содержимому. Проценты — от рабочей области. @default 32 */\n height?: string | number;\n /** Минимальная высота, ограниченная доступным пространством. @default 32 */\n minHeight?: string | number;\n /** Максимальная высота в px или CSS, дополнительно ограниченная доступным пространством. */\n maxHeight?: string | number;\n /** Пользователь управляет содержимым и раскрытием; при height: 'auto' панель прокручивается сама. */\n content: React.ReactNode;\n};\n\nexport function activeViewIs<T extends 'cards' | 'rows'>(\n checkType: T,\n viewState: 'cards' | 'rows',\n view: View,\n): view is ViewMods[T] {\n return checkType === viewState;\n}\n\n/** Размер controlBlock: 'm' и 's' — одинаковые стили, 'xs' — уменьшенный */\nexport type ControlBlockSize = 'm' | 's' | 'xs';\n\nexport type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * Размер controlBlock и его элементов (кнопки, иконки, поиск, отступы).\n * 'm' и 's' — стандартные стили, 'xs' — компактный режим.\n * Не влияет на customFeatures и кастомные слоты — они контролируются разработчиком.\n * @default 'm'\n */\n size?: ControlBlockSize;\n /**\n * @deprecated Используйте кастомные кнопки через rightSideInner или customFeatures.\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока.\n * Продолжает работать для обратной совместимости.\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * customFeatures - пропс для добавления кастомных фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\n /**\n * pinningMenu - нативная фича закрепления столбцов (SplitIconButton с\n * дропдауном) в правой зоне иконок. Появляется, когда активировано\n * закрепление колонок (columnsControl.pinning). Продукт может донастроить\n * и дополнить пункты меню (см. PinningMenuConfig).\n */\n pinningMenu?: PinningMenuConfig;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты левые фичи при адаптивной компрессии\n */\n leftSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты правые фичи при адаптивной компрессии\n */\n rightSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Активна ли фича компрессии (сжатие ToolsMenu при адаптиве)\n * @default true\n */\n enableAdaptiveCompress?: boolean;\n /**\n * Панель массовых действий\n */\n massActionPanel?: {\n /**\n * Кнопки панели. Размеры кнопок/дропдаунов панель подбирает сама (по `size` панели и компактности) —\n * передавать `size` кнопкам не нужно. Если `size` на кнопке всё же задан — он используется как есть.\n */\n buttons: MassActionButtonProps[];\n /**\n * Пропсы для Dropdown, в который сжались кнопки\n */\n collapsedDropdownProps?: TableDropdownConfigProps;\n /**\n * Отступ панели снизу от контейнера (px)\n * @default 24\n */\n bottom?: number;\n /**\n * Управление отображением панели массовых действий.\n * - `undefined` (по умолчанию) — стандартное поведение (показывается при selecting + выбранных строках)\n * - `false` — панель не рендерится, разработчик управляет действиями самостоятельно\n * - `true` — панель показывается всегда, даже без активного selecting и выбранных строк\n */\n show?: boolean;\n /**\n * Размерная сетка панели внутри таблицы: `m`/`s` — обычный размер, `xs` — уменьшенный (кнопки `xxs`, «ещё» `xs`, счётчик Body XS).\n * Viewport-логика (1280) в таблице не используется.\n * @default 's'\n */\n size?: MassActionsSize;\n };\n};\n\n/** Пропсы кнопки редактирования. onClick исключён — используйте onSave/onCancel/onEnableEditing. */\nexport type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n\nexport type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n\nexport type SummaryRowsConfig = {\n showDefault: boolean;\n showInControl: boolean;\n /**\n * callback при переключении тогла «Итоговые строки» в настройках таблицы.\n * Вызывается только по действию пользователя (не при монтировании),\n * поэтому подходит для сохранения выбора, например, в localStorage.\n * Сохранённое значение передавайте обратно в `showDefault`.\n */\n onChange?: (checked: boolean) => void;\n} & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\n/**\n * Конфиг тултипа при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\nexport type TableConfigTooltip = {\n /**\n * Включить/выключить колоночные и кастомные тултипы (cellTooltip, headerCellTooltip).\n * Внутренние тултипы (drag-иконка в шапке и другие по nodeId) работают всегда.\n * @default false\n */\n enabled?: boolean;\n /** Глобальная задержка перед показом тултипа (мс). Per-node переопределяет. @default 500 */\n mouseEnterDelay?: number;\n /** Глобальная задержка перед скрытием тултипа (мс). Per-node переопределяет. @default 0 */\n mouseLeaveDelay?: number;\n /**\n * Минимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n minWidth?: number | string;\n /**\n * Максимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n maxWidth?: number | string;\n};\n\nexport type InfinityScrollConfig<RowType extends ObjectForExtending> = {\n /** Триггер достижения скроллом зоны подгрузки данных. */\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n /** Состояние загрузки (скелетоны) новых строк. */\n isLoading: boolean;\n /**\n * Флаг, когда все данные загружены — false.\n * @default true\n */\n hasMore?: boolean;\n /**\n * Для mode='region': за сколько строк до конца триггерить загрузку.\n * @default 5\n */\n rowThreshold?: number;\n};\n\nexport type { TableCanvasEmptyStateConfig, TableCanvasErrorStateConfig };\n\n/**\n * Настройка выделения ячеек/колонок/строк в TableCanvas — единый объект.\n * Это отдельная ось взаимодействия — не зависит от `highlightActiveType`.\n */\nexport type CellsSelectionConfig = {\n /**\n * Режим фактического выделения ячеек (нативный glide selection). По нему\n * работают copy/paste, рамка, fill-handle и затемнение шапки/нумерации.\n * @default \"range-cell\"\n */\n mode?: CellsSelectionMode;\n /**\n * Выделение колонок по клику на шапку. Ctrl/Cmd — добавить/убрать колонку,\n * Shift — диапазон колонок. Клик по иконкам сортировки/фильтрации в шапке\n * выделение НЕ вызывает. Поддерживает copy/paste по выделенным колонкам.\n * @default true\n */\n enableColumnSelection?: boolean;\n /**\n * Выделение строк по клику/драгу на колонке нумерации (`rowMarkers`).\n * Ctrl/Cmd — несмежный выбор отдельных строк, драг — смежный диапазон.\n * Поддерживает copy/paste по выделенным строкам. Требует включённой колонки\n * нумерации (`rowMarkers`). При `false` клик по нумерации ничего не выделяет.\n * @default true\n */\n enableRowSelection?: boolean;\n /**\n * Выделение всей таблицы кликом по «нулевой» ячейке — шапке колонки нумерации\n * (левый верхний угол). Выделяет все строки данных по всем колонкам одним\n * диапазоном; поддерживает copy/paste. Требует включённой колонки нумерации\n * (`rowMarkers`) и активного `mode` (≠ `disabled`).\n * @default true\n */\n enableSelectAll?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — он внутренний.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n};\n\n/** Один объединённый блок: какие строки и колонки слить. */\nexport type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n\n/**\n * Видимость сторон рамки ячейки: true рисовать, false не рисовать, не задано -\n * работает уровень ниже (настройка колонки, строки или общая).\n */\nexport type CellBorderVisibility = {\n top?: boolean;\n right?: boolean;\n bottom?: boolean;\n left?: boolean;\n};\n\n/**\n * Управление рамками (линиями) таблицы: включение и выключение. Уровни, от\n * слабого к сильному: общие настройки (vertical, horizontal), затем колонка\n * (getVerticalBorder) и строка (getHorizontalBorder), затем ячейка\n * (getCellBorder).\n */\nexport type BordersConfig<RowType = ObjectForExtending> = {\n /** Рисовать ли вертикальные линии между колонками. @default true */\n vertical?: boolean;\n /** Рисовать ли горизонтальные линии между строками тела. @default true */\n horizontal?: boolean;\n /**\n * Точечное управление вертикальной линией справа от колонки (разделитель\n * после неё). Вернуть true или false, чтобы переопределить общую настройку\n * vertical, или undefined, чтобы оставить её. Зовётся на каждую видимую\n * колонку при перерисовке, поэтому функция должна быть быстрой.\n */\n getVerticalBorder?: (params: {\n /** Ключ колонки, справа от которой рисуется линия. */\n columnKey: string;\n /** Индекс колонки в порядке отрисовки (закреплённые в начале). */\n columnIndex: number;\n }) => boolean | undefined;\n /**\n * Точечное управление горизонтальной линией сверху строки. Вернуть true или\n * false, чтобы переопределить общую настройку horizontal, или undefined,\n * чтобы оставить её. Для summary-строк не вызывается. Зовётся на каждую\n * видимую строку при перерисовке, поэтому функция должна быть быстрой.\n */\n getHorizontalBorder?: (params: {\n /** Строка под линией (линия рисуется сверху этой строки). */\n row: RowType;\n /** Индекс строки среди отображаемых. При раскрытии subRows индексы сдвигаются. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => boolean | undefined;\n /**\n * Стороны рамки конкретной ячейки, вкл и выкл. Для ячеек без переопределений\n * возвращать undefined. Включает отрисовку линий с разбивкой по ячейкам,\n * поэтому функция должна быть быстрой: без тяжёлых вычислений и с готовыми\n * объектами-константами вместо новых на каждый вызов. Для summary-строк не\n * вызывается.\n */\n getCellBorder?: (params: {\n /** Индекс колонки среди отображаемых (без служебных). */\n col: number;\n /** Ключ колонки. */\n columnKey: string | undefined;\n /** Строка ячейки. */\n row: RowType;\n /** Индекс строки среди отображаемых. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => CellBorderVisibility | undefined;\n};\n\nexport type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * Готовые варианты внешнего вида таблицы.\n *\n * `variant: 'clean'` — без линий сетки и внешних рамок, шапка на белом фоне\n * с серым текстом. Отдельные линии можно вернуть через `borders`.\n *\n * `zebra: true` — строки через одну окрашены серым, работает в любом варианте.\n */\n appearance?: AppearanceConfig;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *"
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 *"
49874
50656
  },
49875
50657
  {
49876
50658
  "typeName": "FilterComponentInPopoverProps",
@@ -50147,8 +50929,8 @@
50147
50929
  "feature": "IsLoading",
50148
50930
  "legacy": false,
50149
50931
  "summary": "*tableConfig.isLoading / tableConfig.loadingOverlay**",
50150
- "docs": "# IsLoading (TableCanvas)\n\n**tableConfig.isLoading / tableConfig.loadingOverlay**\n\nСостояние загрузки таблицы. Поддерживает скелетон-строки и полноэкранный оверлей.\n\n## Ключевые особенности\n\n- Скелетон-строки при загрузке данных (`isLoading`)\n- Настраиваемое количество скелетон-строк (`skeletonRowsCount`)\n- Полноэкранный оверлей с кастомным спиннером (`loadingOverlay`)\n- Задержка показа подзаголовка (`showSubtitleDelay`)\n\n## Когда использовать loadingOverlay\n\n- Динамическая загрузка схемы таблицы — колонки загружаются с бэкенда\n- Конфигурируемые таблицы — пользователь сам настраивает колонки\n- Ошибки загрузки структуры — не удалось загрузить метаданные\n\n> Подробнее о типах — [IsLoading API](?path=/docs/локальные-компоненты-tablecanvas-isloading-api--docs)",
50151
- "apiDocs": "# IsLoading API\n\n## tableConfig.isLoading\n\n```ts\nisLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n```\n\n- **`boolean`** — простой флаг загрузки, количество skeleton-строк определяется автоматически\n- **`{ boolean, skeletonRowsCount }`** — загрузка с явным указанием количества skeleton-строк\n\n## tableConfig.loadingOverlay\n\n```ts\nloadingOverlay?: {\n active?: boolean; // default: true\n spinner?: ReactNode; // default: <Spinner view=\"secondary\" size=\"36\" />\n title?: string; // default: 'Загрузка таблицы'\n subtitle?: string; // default: ''\n showSubtitleDelay?: number; // default: 10000 (10 секунд)\n};\n```",
50932
+ "docs": "# IsLoading (TableCanvas)\n\n**tableConfig.isLoading / tableConfig.loadingOverlay**\n\nСостояние загрузки таблицы. Поддерживает скелетон-строки и полноэкранный оверлей.\n\n## Ключевые особенности\n\n- Скелетон-строки при загрузке данных (`isLoading`)\n- Настраиваемое количество скелетон-строк (`skeletonRowsCount`)\n- Полноэкранный оверлей с кастомным спиннером (`loadingOverlay`)\n- Задержка показа подзаголовка (`showSubtitleDelay`)\n- Оверлей поверх таблицы без её размонтирования (`loadingOverlay.mode: 'cover'`)\n\n## Когда использовать loadingOverlay\n\n- Динамическая загрузка схемы таблицы — колонки загружаются с бэкенда\n- Конфигурируемые таблицы — пользователь сам настраивает колонки\n- Ошибки загрузки структуры — не удалось загрузить метаданные\n\n## Когда использовать mode: 'cover'\n\nОбычный `loadingOverlay` показывается вместо таблицы: таблица размонтируется, и после снятия оверлея выделение, страница пагинации и прокрутка начинаются заново.\n\nС `mode: 'cover'` таблица остаётся на месте, а оверлей ложится поверх неё полупрозрачным размытым слоем. Он закрывает control block, боковые панели, нижнюю панель и пагинацию, в fullscreen тоже, и блокирует мышь, клавиатуру и фокус. Когда оверлей снимается, таблица продолжает работу с того же состояния.\n\nПодходит для долгих действий с уже открытой таблицей: удаление или сохранение строк, пересчёт данных.\n\nРежимы можно совмещать: на первой загрузке показывать `'replace'`, а когда таблица загружена, тем же `loadingOverlay` с `mode: 'cover'` закрывать её на время действий.\n\n```tsx\nloadingOverlay: {\n mode: isFirstLoad ? 'replace' : 'cover',\n active: isFirstLoad || isUpdating,\n}\n```\n\n```tsx\n<TableCanvas\n tableConfig={{\n loadingOverlay: {\n mode: 'cover',\n active: isUpdating,\n subtitle: 'Обычно это занимает не более 10 секунд',\n },\n }}\n/>\n```\n\n> Подробнее о типах — [IsLoading API](?path=/docs/локальные-компоненты-tablecanvas-isloading-api--docs)",
50933
+ "apiDocs": "# IsLoading API\n\n## tableConfig.isLoading\n\n```ts\nisLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n```\n\n- **`boolean`** — простой флаг загрузки, количество skeleton-строк определяется автоматически\n- **`{ boolean, skeletonRowsCount }`** — загрузка с явным указанием количества skeleton-строк\n\n## tableConfig.loadingOverlay\n\n```ts\nloadingOverlay?: {\n active?: boolean; // default: true\n mode?: 'replace' | 'cover'; // default: 'replace'\n spinner?: ReactNode; // default: <Spinner view=\"secondary\" size=\"l\" />\n title?: string; // default: 'Загрузка таблицы', для mode: 'cover' — 'Таблица обновляется'\n subtitle?: string; // default: ''\n showSubtitleDelay?: number; // default: 10000 (10 секунд)\n};\n```",
50152
50934
  "api": [],
50153
50935
  "stories": [
50154
50936
  {
@@ -50156,6 +50938,12 @@
50156
50938
  "displayName": "IsLoading",
50157
50939
  "type": "full-code",
50158
50940
  "code": "import { ColumnConfig, TableCanvas } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n const [isVisibleLoadingOverlay, setIsVisibleLoadingOverlay] =\n useState(false);\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 [],\n );\n\n return (\n <>\n <Switch\n style={{ width: 'fit-content' }}\n label={\n isVisibleLoadingOverlay ? 'Скрыть overlay' : 'Показать overlay'\n }\n checked={isVisibleLoadingOverlay}\n onChange={() => setIsVisibleLoadingOverlay((prev) => !prev)}\n />\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 500 },\n isLoading: { boolean: true, skeletonRowsCount: 5 },\n loadingOverlay: {\n active: isVisibleLoadingOverlay,\n showSubtitleDelay: 3000,\n subtitle:\n 'Данные обрабатываются, обычно это занимает не более 10 секунд',\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </>\n );\n }"
50941
+ },
50942
+ {
50943
+ "exportName": "CoverOverlay",
50944
+ "displayName": "Оверлей поверх таблицы (mode: cover)",
50945
+ "type": "full-code",
50946
+ "code": "import { Switch } from '@sber-digital-finance-ui/ui-kit/components/Switch';\nimport { ColumnConfig, TableCanvas } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport React, { useMemo, useRef, useState } from 'react';\n\n() => {\n const [rows, setRows] = useState(createRows);\n const selectingRowStateAndSetter = useState(\n (): ReadonlySet<string | number> => new Set(),\n );\n const [selectedRows, setSelectedRows] = selectingRowStateAndSetter;\n const [isUpdating, setIsUpdating] = useState(false);\n const timerRef = useRef<ReturnType<typeof setTimeout>>();\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n { key: 'id', name: 'ID' },\n { key: 'task', name: 'Title' },\n { key: 'priority', name: 'Priority' },\n { key: 'issueType', name: 'Issue Type' },\n { key: 'developer', name: 'Developer' },\n ],\n [],\n );\n\n // Имитация запроса на удаление: пока он идёт, таблица закрыта оверлеем,\n // но не размонтируется — прокрутка и выделение остаются на месте.\n const deleteSelected = () => {\n setIsUpdating(true);\n clearTimeout(timerRef.current);\n timerRef.current = setTimeout(() => {\n setRows((prev) => prev.filter((row) => !selectedRows.has(row.id)));\n setSelectedRows(new Set());\n setIsUpdating(false);\n }, 3000);\n };\n\n return (\n <>\n <Switch\n style={{ width: 'fit-content' }}\n label=\"Показать оверлей\"\n checked={isUpdating}\n onChange={() => setIsUpdating((prev) => !prev)}\n />\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 500 },\n fullScreenEnabled: true,\n selecting: {\n state: selectingRowStateAndSetter,\n rowKeyGetter: (row) => row.id,\n },\n controlBlock: {\n massActionPanel: {\n buttons: [\n {\n type: 'button',\n text: 'Удалить выбранные',\n view: 'secondary',\n onClick: deleteSelected,\n },\n ],\n },\n },\n loadingOverlay: {\n mode: 'cover',\n active: isUpdating,\n showSubtitleDelay: 1000,\n subtitle: 'Обычно это занимает не более 10 секунд',\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </>\n );\n }"
50159
50947
  }
50160
50948
  ]
50161
50949
  },
@@ -50685,6 +51473,134 @@
50685
51473
  }
50686
51474
  ]
50687
51475
  },
51476
+ {
51477
+ "component": "TableCanvas",
51478
+ "feature": "Logger",
51479
+ "legacy": false,
51480
+ "summary": "Панель системных сообщений таблицы: шапка со счётчиками и фильтрами по статусам, список сообщений с группами, подробностями и копированием идентификатора трассировки.",
51481
+ "docs": "# TableCanvasLogger\n\nПанель системных сообщений таблицы: шапка со счётчиками и фильтрами по статусам, список сообщений с группами, подробностями и копированием идентификатора трассировки.\n\nКомпонент входит в `TableCanvas` и предназначен для нижней панели таблицы: передайте его в `tableConfig.bottomSheetConfig.content` (пример — сторис «В нижней панели таблицы»). Если обёртка растягивается на высоту панели, а ``, шапка остаётся на месте и прокручивается только список.\n\n## Ключевые особенности\n\n- Четыре статуса: `error`, `warning`, `info`, `success`\n- Группы любой вложенности\n- Фильтр по статусу учитывает вложенные сообщения: группа остаётся в списке, если в ней есть подходящее сообщение\n- Кнопки сообщения: «Подробнее», «Скопировать ID», код сообщения (например `F23`) и собственные `actions`\n- Состояние панели, фильтра и раскрытых элементов можно задавать извне или оставить компоненту\n\n## Основная структура\n\n```tsx\n\n<TableCanvas\n rows={rows}\n columnConfig={columns}\n tableConfig={{\n bottomSheetConfig: {\n height: open ? 280 : 40,\n content: (\n <TableCanvasLogger items={items} open={open} onOpenChange={setOpen} />\n ),\n },\n }}\n/>;\n```\n\n## Составные части\n\n- `TableCanvasLoggerList` — список сообщений без шапки, принимает те же `items` и настройки отображения\n- `TableCanvasLoggerMessage` и `TableCanvasLoggerGroup` — можно использовать отдельно: раскрытие управляется пропами `open` и `onOpenChange` или хранится внутри\n- `TableCanvasLoggerFilters` — чипсы «Все» и по одному на статус\n- `useTableCanvasLogger`, `TableCanvasLoggerProvider` и `TableCanvasLoggerItems` — для полностью своей вёрстки\n\n## Особенности\n\n- Счётчики считаются по всем элементам: группа учитывается наравне с сообщениями. Например, одна группа `error` с тремя вложенными сообщениями даёт «Все (4)». Если нужен другой подсчёт или загружена только часть данных, передайте итоговые значения в `counts`\n- Описание сообщения можно скопировать, только если оно передано строкой\n- Закрытие панели сбрасывает фильтр на «Все», в закрытой панели чипсы не выделены. Выбор фильтра в закрытой панели открывает её\n- Начальное состояние задаётся `defaultOpen`, `defaultFilter` и `defaultExpandedIds`\n- Без сообщений показывается «Сообщений нет»: текст меняется через `labels.empty`, разметка целиком — через `emptyContent`\n- Названия статусов для скринридера задаются в `labels.error`, `labels.warning`, `labels.info`, `labels.success`\n- Внутренние отступы панели входят в компонент и рассчитаны на нижнюю панель таблицы. Переопределить их можно через `$css`\n- Логгер занимает высоту родителя, а список прокручивается. Ограничить высоту списка можно через `maxHeight`\n\nОписание типов и пропсов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-bottomsheet-logger-api--docs).\n\n### В нижней панели таблицы\n\n<LazyCanvas of={TableCanvasLoggerStories.InTable} />\n\n### Базовый пример\n\n<LazyCanvas of={TableCanvasLoggerStories.Default} />\n\n### Управляемое состояние\n\n<LazyCanvas of={TableCanvasLoggerStories.ControlledState} />\n\n### Только список (TableCanvasLoggerList)\n\n<LazyCanvas of={TableCanvasLoggerStories.ListOnly} />\n\n### Свои действия сообщений\n\n<LazyCanvas of={TableCanvasLoggerStories.CustomActions} />\n\n### Свои тексты и иконки\n\n<LazyCanvas of={TableCanvasLoggerStories.CustomLabelsAndIcons} />\n\n### Свой рендер сообщения\n\n<LazyCanvas of={TableCanvasLoggerStories.CustomMessageRender} />\n\n### Свой рендер группы\n\n<LazyCanvas of={TableCanvasLoggerStories.CustomGroupRender} />\n\n### Расширение строки действий и описания\n\n<LazyCanvas of={TableCanvasLoggerStories.CustomActionsSlot} />\n\n### Обработка копирования и кода\n\n<LazyCanvas of={TableCanvasLoggerStories.CopyHandlers} />\n\n### Шапка: заголовок, иконка, доп. контент\n\n<LazyCanvas of={TableCanvasLoggerStories.HeaderCustomization} />\n\n### Стилизация: classes и $css\n\n<LazyCanvas of={TableCanvasLoggerStories.CustomStyling} />\n\n### Headless: useTableCanvasLogger + собственная вёрстка\n\n<LazyCanvas of={TableCanvasLoggerStories.Headless} />\n\n### Отдельные части: TableCanvasLoggerMessage и TableCanvasLoggerGroup\n\n<LazyCanvas of={TableCanvasLoggerStories.SingleParts} />",
51482
+ "apiDocs": "# TableCanvasLogger API\n\n## TableCanvasLoggerProps\n\n```typescript\ntype TableCanvasLoggerProps = Omit<\n TableCanvasLoggerListProps,\n 'filter'\n> & {\n open?: boolean;\n defaultOpen?: boolean;\n onOpenChange?: (open: boolean) => void;\n /** Текущий фильтр. При закрытии панели сбрасывается на «Все», в закрытой панели чипсы не выделены */\n filter?: TableCanvasLoggerFilterValue;\n defaultFilter?: TableCanvasLoggerFilterValue;\n onFilterChange?: (filter: TableCanvasLoggerFilterValue) => void;\n /**\n * Внешние счётчики. По умолчанию считаются по `items`: группа учитывается\n * наравне с сообщениями, поэтому группа с тремя сообщениями даёт «Все (4)»\n */\n counts?: TableCanvasLoggerCounts;\n /** Заголовок панели */\n title?: ReactNode;\n /** Иконка слева от заголовка */\n icon?: ReactNode;\n /** Контент справа в шапке */\n headerExtra?: ReactNode;\n /** Скрыть шапку: остаётся только список */\n hideHeader?: boolean;\n /** Скрыть фильтры в шапке */\n hideFilters?: boolean;\n /** Показывать ли чипс статуса с нулевым счётчиком */\n showEmptyFilters?: boolean;\n};\n```\n\n## TableCanvasLoggerListProps\n\n```typescript\ntype TableCanvasLoggerListProps = TableCanvasLoggerRenderProps & {\n items?: TableCanvasLoggerItem[] | null;\n /** Раскрытые id: сообщений (подробности) и групп */\n expandedIds?: string[];\n defaultExpandedIds?: string[];\n onExpandedIdsChange?: (ids: string[]) => void;\n /** Текущий фильтр. Применяется к списку и счётчикам */\n filter?: TableCanvasLoggerFilterValue;\n /** Контент пустого списка */\n emptyContent?: ReactNode;\n /** Максимальная высота списка. По умолчанию не ограничена: логгер занимает высоту родителя, а список прокручивается */\n maxHeight?: number | string;\n className?: string;\n $css?: TableCanvasLoggerCssProp;\n};\n```\n\n## TableCanvasLoggerRenderProps\n\n```typescript\ntype TableCanvasLoggerRenderProps = {\n /** Замена иконок статусов */\n statusIcons?: Partial<Record<TableCanvasLoggerStatus, ReactNode>>;\n /** Полная замена сообщения */\n renderMessage?: (ctx: TableCanvasLoggerMessageRenderContext) => ReactNode;\n /** Полная замена группы */\n renderGroup?: (ctx: TableCanvasLoggerGroupRenderContext) => ReactNode;\n /** Замена блока подробностей */\n renderDescription?: (item: TableCanvasLoggerMessageItem) => ReactNode;\n /** Замена строки действий. Получает стандартные кнопки вторым аргументом */\n renderActions?: (\n item: TableCanvasLoggerMessageItem,\n defaultActions: ReactNode,\n ) => ReactNode;\n /** Дополнительный контент справа от заголовка сообщения */\n renderMessageExtra?: (item: TableCanvasLoggerMessageItem) => ReactNode;\n /** Формат даты. Вернуть null, чтобы скрыть дату */\n formatDate?: (\n date: NonNullable<TableCanvasLoggerMessageItem['date']>,\n item: TableCanvasLoggerMessageItem,\n ) => string | null;\n labels?: Partial<TableCanvasLoggerLabels>;\n classes?: TableCanvasLoggerClasses;\n /** Вызывается после копирования. Если задан `copyToClipboard`, он заменяет стандартное копирование */\n onCopy?: (\n kind: TableCanvasLoggerCopyKind,\n value: string,\n item: TableCanvasLoggerMessageItem,\n ) => void;\n /** Своё копирование. Вернуть `false` или выбросить ошибку, если скопировать не удалось */\n copyToClipboard?: (value: string) => Promise<boolean | void> | boolean | void;\n /** Вызывается при клике на кнопку с кодом сообщения */\n onCodeClick?: (code: string, item: TableCanvasLoggerMessageItem) => void;\n};\n```\n\n## TableCanvasLoggerMessageItem\n\n```typescript\ntype TableCanvasLoggerMessageItem = TableCanvasLoggerItemBase & {\n /** Текст подробностей. Если строка, то доступно копирование */\n description?: ReactNode;\n /** Дата создания: ISO-строка, timestamp или Date */\n date?: string | number | Date;\n /** Идентификатор трассировки. Показывает кнопку копирования */\n traceId?: string | null;\n /** Код сообщения, например F23. Показывается отдельной кнопкой */\n code?: string;\n /** Дополнительные действия, добавляются после встроенных кнопок */\n actions?: TableCanvasLoggerAction[];\n items?: undefined;\n};\n```\n\n## TableCanvasLoggerGroupItem\n\n```typescript\ntype TableCanvasLoggerGroupItem = TableCanvasLoggerItemBase & {\n items: TableCanvasLoggerItem[];\n /** Раскрыть группу при появлении. В управляемом `expandedIds` не применяется */\n defaultOpen?: boolean;\n};\n```\n\n## TableCanvasLoggerLabels\n\n```typescript\ntype TableCanvasLoggerLabels = {\n title: string;\n all: string;\n details: string;\n hide: string;\n copyTraceId: string;\n copied: string;\n copyDescription: string;\n empty: string;\n /** Подсказка кнопки свёрнутой группы */\n expandGroup: string;\n /** Подсказка кнопки раскрытой группы */\n collapseGroup: string;\n /** Подпись группы фильтров для скринридера */\n filters: string;\n} & Record<TableCanvasLoggerStatus, string>;\n```\n\n## TableCanvasLoggerClasses\n\n```typescript\ntype TableCanvasLoggerClasses = {\n root?: string;\n header?: string;\n filters?: string;\n filter?: string;\n list?: string;\n empty?: string;\n group?: string;\n groupHeader?: string;\n groupBody?: string;\n message?: string;\n messageIcon?: string;\n messageTitle?: string;\n messageActions?: string;\n messageDate?: string;\n messageDescription?: string;\n};\n```\n\n## useTableCanvasLogger\n\n```typescript\ntype UseTableCanvasLoggerOptions = {\n items?: TableCanvasLoggerItem[] | null;\n defaultOpen?: boolean;\n open?: boolean;\n onOpenChange?: (open: boolean) => void;\n filter?: TableCanvasLoggerFilterValue;\n defaultFilter?: TableCanvasLoggerFilterValue;\n onFilterChange?: (filter: TableCanvasLoggerFilterValue) => void;\n expandedIds?: string[];\n defaultExpandedIds?: string[];\n onExpandedIdsChange?: (ids: string[]) => void;\n counts?: TableCanvasLoggerCounts;\n};\n```",
51483
+ "api": [
51484
+ {
51485
+ "typeName": "TableCanvasLoggerProps",
51486
+ "source": "type TableCanvasLoggerProps = Omit<\n TableCanvasLoggerListProps,\n 'filter'\n> & {\n open?: boolean;\n defaultOpen?: boolean;\n onOpenChange?: (open: boolean) => void;\n /** Текущий фильтр. При закрытии панели сбрасывается на «Все», в закрытой панели чипсы не выделены */\n filter?: TableCanvasLoggerFilterValue;\n defaultFilter?: TableCanvasLoggerFilterValue;\n onFilterChange?: (filter: TableCanvasLoggerFilterValue) => void;\n /**\n * Внешние счётчики. По умолчанию считаются по `items`: группа учитывается\n * наравне с сообщениями, поэтому группа с тремя сообщениями даёт «Все (4)»\n */\n counts?: TableCanvasLoggerCounts;\n /** Заголовок панели */\n title?: ReactNode;\n /** Иконка слева от заголовка */\n icon?: ReactNode;\n /** Контент справа в шапке */\n headerExtra?: ReactNode;\n /** Скрыть шапку: остаётся только список */\n hideHeader?: boolean;\n /** Скрыть фильтры в шапке */\n hideFilters?: boolean;\n /** Показывать ли чипс статуса с нулевым счётчиком */\n showEmptyFilters?: boolean;\n};"
51487
+ },
51488
+ {
51489
+ "typeName": "TableCanvasLoggerListProps",
51490
+ "source": "type TableCanvasLoggerListProps = TableCanvasLoggerRenderProps & {\n items?: TableCanvasLoggerItem[] | null;\n /** Раскрытые id: сообщений (подробности) и групп */\n expandedIds?: string[];\n defaultExpandedIds?: string[];\n onExpandedIdsChange?: (ids: string[]) => void;\n /** Текущий фильтр. Применяется к списку и счётчикам */\n filter?: TableCanvasLoggerFilterValue;\n /** Контент пустого списка */\n emptyContent?: ReactNode;\n /** Максимальная высота списка. По умолчанию не ограничена: логгер занимает высоту родителя, а список прокручивается */\n maxHeight?: number | string;\n className?: string;\n $css?: TableCanvasLoggerCssProp;\n};"
51491
+ },
51492
+ {
51493
+ "typeName": "TableCanvasLoggerRenderProps",
51494
+ "source": "type TableCanvasLoggerRenderProps = {\n /** Замена иконок статусов */\n statusIcons?: Partial<Record<TableCanvasLoggerStatus, ReactNode>>;\n /** Полная замена сообщения */\n renderMessage?: (ctx: TableCanvasLoggerMessageRenderContext) => ReactNode;\n /** Полная замена группы */\n renderGroup?: (ctx: TableCanvasLoggerGroupRenderContext) => ReactNode;\n /** Замена блока подробностей */\n renderDescription?: (item: TableCanvasLoggerMessageItem) => ReactNode;\n /** Замена строки действий. Получает стандартные кнопки вторым аргументом */\n renderActions?: (\n item: TableCanvasLoggerMessageItem,\n defaultActions: ReactNode,\n ) => ReactNode;\n /** Дополнительный контент справа от заголовка сообщения */\n renderMessageExtra?: (item: TableCanvasLoggerMessageItem) => ReactNode;\n /** Формат даты. Вернуть null, чтобы скрыть дату */\n formatDate?: (\n date: NonNullable<TableCanvasLoggerMessageItem['date']>,\n item: TableCanvasLoggerMessageItem,\n ) => string | null;\n labels?: Partial<TableCanvasLoggerLabels>;\n classes?: TableCanvasLoggerClasses;\n /** Вызывается после копирования. Если задан `copyToClipboard`, он заменяет стандартное копирование */\n onCopy?: (\n kind: TableCanvasLoggerCopyKind,\n value: string,\n item: TableCanvasLoggerMessageItem,\n ) => void;\n /** Своё копирование. Вернуть `false` или выбросить ошибку, если скопировать не удалось */\n copyToClipboard?: (value: string) => Promise<boolean | void> | boolean | void;\n /** Вызывается при клике на кнопку с кодом сообщения */\n onCodeClick?: (code: string, item: TableCanvasLoggerMessageItem) => void;\n};"
51495
+ },
51496
+ {
51497
+ "typeName": "TableCanvasLoggerMessageItem",
51498
+ "source": "type TableCanvasLoggerMessageItem = TableCanvasLoggerItemBase & {\n /** Текст подробностей. Если строка, то доступно копирование */\n description?: ReactNode;\n /** Дата создания: ISO-строка, timestamp или Date */\n date?: string | number | Date;\n /** Идентификатор трассировки. Показывает кнопку копирования */\n traceId?: string | null;\n /** Код сообщения, например F23. Показывается отдельной кнопкой */\n code?: string;\n /** Дополнительные действия, добавляются после встроенных кнопок */\n actions?: TableCanvasLoggerAction[];\n items?: undefined;\n};"
51499
+ },
51500
+ {
51501
+ "typeName": "TableCanvasLoggerGroupItem",
51502
+ "source": "type TableCanvasLoggerGroupItem = TableCanvasLoggerItemBase & {\n items: TableCanvasLoggerItem[];\n /** Раскрыть группу при появлении. В управляемом `expandedIds` не применяется */\n defaultOpen?: boolean;\n};"
51503
+ },
51504
+ {
51505
+ "typeName": "TableCanvasLoggerLabels",
51506
+ "source": "type TableCanvasLoggerLabels = {\n title: string;\n all: string;\n details: string;\n hide: string;\n copyTraceId: string;\n copied: string;\n copyDescription: string;\n empty: string;\n /** Подсказка кнопки свёрнутой группы */\n expandGroup: string;\n /** Подсказка кнопки раскрытой группы */\n collapseGroup: string;\n /** Подпись группы фильтров для скринридера */\n filters: string;\n} & Record<TableCanvasLoggerStatus, string>;"
51507
+ },
51508
+ {
51509
+ "typeName": "TableCanvasLoggerClasses",
51510
+ "source": "type TableCanvasLoggerClasses = {\n root?: string;\n header?: string;\n filters?: string;\n filter?: string;\n list?: string;\n empty?: string;\n group?: string;\n groupHeader?: string;\n groupBody?: string;\n message?: string;\n messageIcon?: string;\n messageTitle?: string;\n messageActions?: string;\n messageDate?: string;\n messageDescription?: string;\n};"
51511
+ },
51512
+ {
51513
+ "typeName": "UseTableCanvasLoggerOptions",
51514
+ "source": "type UseTableCanvasLoggerOptions = {\n items?: TableCanvasLoggerItem[] | null;\n defaultOpen?: boolean;\n open?: boolean;\n onOpenChange?: (open: boolean) => void;\n filter?: TableCanvasLoggerFilterValue;\n defaultFilter?: TableCanvasLoggerFilterValue;\n onFilterChange?: (filter: TableCanvasLoggerFilterValue) => void;\n expandedIds?: string[];\n defaultExpandedIds?: string[];\n onExpandedIdsChange?: (ids: string[]) => void;\n counts?: TableCanvasLoggerCounts;\n};"
51515
+ }
51516
+ ],
51517
+ "stories": [
51518
+ {
51519
+ "exportName": "InTable",
51520
+ "displayName": "В нижней панели таблицы",
51521
+ "type": "full-code",
51522
+ "code": "import { TableCanvas, TableCanvasLogger, type TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport React, { useState } from 'react';\n\n${GROUPED_SRC}\n\nfunction TableCanvasLoggerInTableExample({\n items,\n}: {\n items: TableCanvasLoggerItem[];\n}) {\n const [open, setOpen] = useState(false);\n const rows = Array.from({ length: 40 }, (_, id) => ({\n id,\n report: `Отчёт ${id + 1}`,\n }));\n\n return (\n <TableCanvas\n rows={rows}\n columnConfig={[\n { key: 'id', name: 'ID', width: 100 },\n { key: 'report', name: 'Отчёт', width: 360 },\n ]}\n tableConfig={{\n containerStyle: { height: 520 },\n bottomSheetConfig: {\n height: open ? 280 : 40,\n minHeight: 40,\n content: (\n <TableCanvasLogger\n items={items}\n open={open}\n onOpenChange={setOpen}\n />\n ),\n },\n }}\n />\n );\n};\n\n<TableCanvasLoggerInTableExample items={items} />;"
51523
+ },
51524
+ {
51525
+ "exportName": "Default",
51526
+ "displayName": "Базовый пример",
51527
+ "type": "args-only",
51528
+ "code": "{ items: GROUPED_ITEMS, defaultOpen: true }"
51529
+ },
51530
+ {
51531
+ "exportName": "ControlledState",
51532
+ "displayName": "Управляемое состояние",
51533
+ "type": "full-code",
51534
+ "code": "import { useState } from 'react';\nimport { Button } from '@sber-digital-finance-ui/ui-kit';\nimport { getTableCanvasLoggerGroupIds, TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerFilterValue, TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n const [open, setOpen] = useState(true);\n const [filter, setFilter] = useState<TableCanvasLoggerFilterValue>('all');\n const [expanded, setExpanded] = useState<string[]>([]);\n\n return (\n <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>\n <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>\n <Button\n size=\"xs\"\n view=\"secondary\"\n text={open ? 'Закрыть' : 'Открыть'}\n onClick={() => setOpen(!open)}\n />\n <Button\n size=\"xs\"\n view=\"secondary\"\n text=\"Только ошибки\"\n onClick={() => {\n setFilter('error');\n setOpen(true);\n }}\n />\n <Button\n size=\"xs\"\n view=\"secondary\"\n text=\"Развернуть группы\"\n onClick={() =>\n setExpanded(getTableCanvasLoggerGroupIds(GROUPED_ITEMS))\n }\n />\n <Button\n size=\"xs\"\n view=\"secondary\"\n text=\"Свернуть группы\"\n onClick={() => setExpanded([])}\n />\n </div>\n <TableCanvasLogger\n items={GROUPED_ITEMS}\n open={open}\n onOpenChange={setOpen}\n filter={filter}\n onFilterChange={setFilter}\n expandedIds={expanded}\n onExpandedIdsChange={setExpanded}\n />\n </div>\n );\n }"
51535
+ },
51536
+ {
51537
+ "exportName": "ListOnly",
51538
+ "displayName": "Только список (TableCanvasLoggerList)",
51539
+ "type": "full-code",
51540
+ "code": "import { TableCanvasLoggerList } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => (\n <div style={{ border: '1px solid rgba(0,0,0,0.1)', borderRadius: 12 }}>\n <TableCanvasLoggerList\n items={GROUPED_ITEMS}\n defaultExpandedIds={['excel']}\n maxHeight={360}\n />\n </div>\n )"
51541
+ },
51542
+ {
51543
+ "exportName": "CustomActions",
51544
+ "displayName": "Свои действия сообщений",
51545
+ "type": "full-code",
51546
+ "code": "import { useState } from 'react';\nimport { BodyXS } from '@sber-digital-finance-ui/ui-kit';\nimport { TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport { IconCloudDownloadOutline } from '@sber-digital-finance-ui/ui-kit/icons';\n\n() => {\n const [log, setLog] = useState<string[]>([]);\n const items: TableCanvasLoggerItem[] = [\n {\n id: 'download',\n status: 'error',\n title: 'Не удалось выгрузить отчёт',\n description: 'Превышено время ожидания ответа от сервиса выгрузки',\n date: new Date(2025, 0, 1, 11, 30, 0),\n actions: [\n {\n id: 'retry',\n text: 'Повторить',\n onClick: (item) =>\n setLog((prev) => [...prev, `Повтор: ${item.id}`]),\n },\n {\n id: 'download',\n title: 'Скачать лог',\n icon: <IconCloudDownloadOutline size=\"xs\" />,\n onClick: (item) =>\n setLog((prev) => [...prev, `Скачивание лога: ${item.id}`]),\n },\n { id: 'disabled', text: 'Недоступно', disabled: true },\n ],\n },\n ];\n\n return (\n <>\n <TableCanvasLogger items={items} defaultOpen />\n <BodyXS>\n Вызовы onClick:{' '}\n {log.length\n ? log.join(' → ')\n : 'пока нет, нажмите «Повторить» или иконку скачивания'}\n </BodyXS>\n </>\n );\n }"
51547
+ },
51548
+ {
51549
+ "exportName": "CustomLabelsAndIcons",
51550
+ "displayName": "Свои тексты и иконки",
51551
+ "type": "full-code",
51552
+ "code": "import { TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport { IconSyncError } from '@sber-digital-finance-ui/ui-kit/icons';\nimport { textNegative } from '@sber-digital-finance-ui/ui-kit/tokens';\n\n() => (\n <TableCanvasLogger\n items={PLAIN_ITEMS}\n defaultOpen\n title=\"System messages\"\n labels={{\n all: 'All',\n details: 'Details',\n hide: 'Hide',\n copyTraceId: 'Copy ID',\n copied: 'Copied',\n empty: 'No messages',\n }}\n statusIcons={{ error: <IconSyncError size=\"xs\" color={textNegative} /> }}\n formatDate={(date) => new Date(date).toLocaleString('en-GB')}\n />\n )"
51553
+ },
51554
+ {
51555
+ "exportName": "CustomMessageRender",
51556
+ "displayName": "Свой рендер сообщения",
51557
+ "type": "full-code",
51558
+ "code": "import { TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem, TableCanvasLoggerStatus } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport { textNegative, textPositive, textTertiary, textWarning } from '@sber-digital-finance-ui/ui-kit/tokens';\n\n() => (\n <TableCanvasLogger\n items={PLAIN_ITEMS}\n defaultOpen\n renderMessage={({ item, defaultRender }) => (\n <div\n style={{\n borderLeft: `3px solid ${STATUS_COLORS[item.status]()}`,\n paddingLeft: 12,\n }}\n >\n {defaultRender()}\n </div>\n )}\n />\n )"
51559
+ },
51560
+ {
51561
+ "exportName": "CustomGroupRender",
51562
+ "displayName": "Свой рендер группы",
51563
+ "type": "full-code",
51564
+ "code": "import { Button } from '@sber-digital-finance-ui/ui-kit';\nimport { TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => (\n <TableCanvasLogger\n items={GROUPED_ITEMS}\n defaultOpen\n defaultExpandedIds={['excel']}\n renderGroup={({ item, open, toggle, children }) => (\n <section\n style={{\n border: '1px dashed rgba(0,0,0,0.2)',\n borderRadius: 8,\n padding: 8,\n }}\n >\n <Button\n size=\"xxs\"\n view=\"clear\"\n text={`${open ? '▼' : '▶'} ${item.title} (${item.items.length})`}\n onClick={toggle}\n />\n {open && (\n <div\n style={{\n display: 'flex',\n flexDirection: 'column',\n gap: 12,\n paddingTop: 8,\n }}\n >\n {children}\n </div>\n )}\n </section>\n )}\n />\n )"
51565
+ },
51566
+ {
51567
+ "exportName": "CustomActionsSlot",
51568
+ "displayName": "Расширение строки действий и описания",
51569
+ "type": "full-code",
51570
+ "code": "import { Button, TextXS } from '@sber-digital-finance-ui/ui-kit';\nimport { TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => (\n <TableCanvasLogger\n items={ITEMS_WITH_META}\n defaultOpen\n renderActions={(_item, defaults) => (\n <>\n {defaults}\n <Button size=\"xxs\" view=\"secondary\" text=\"Создать тикет\" />\n </>\n )}\n renderDescription={(item) => (\n <pre style={{ margin: 0, fontFamily: 'monospace', fontSize: 12 }}>\n {String(item.description)}\n </pre>\n )}\n renderMessageExtra={(item) => (\n <TextXS>Источник: {String(item.meta?.source)}</TextXS>\n )}\n />\n )"
51571
+ },
51572
+ {
51573
+ "exportName": "CopyHandlers",
51574
+ "displayName": "Обработка копирования и кода",
51575
+ "type": "full-code",
51576
+ "code": "import { useState } from 'react';\nimport { BodyXS } from '@sber-digital-finance-ui/ui-kit';\nimport { TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n const [events, setEvents] = useState<string[]>([]);\n\n return (\n <>\n <TableCanvasLogger\n items={PLAIN_ITEMS}\n defaultOpen\n copyToClipboard={() => undefined}\n onCopy={(kind, value) =>\n setEvents((prev) => [...prev, `copy:${kind}:${value}`])\n }\n onCodeClick={(code) => setEvents((prev) => [...prev, `code:${code}`])}\n />\n <BodyXS>\n Вызовы колбэков:{' '}\n {events.join(' | ') || 'пока нет, нажмите «Скопировать ID» или код'}\n </BodyXS>\n </>\n );\n }"
51577
+ },
51578
+ {
51579
+ "exportName": "HeaderCustomization",
51580
+ "displayName": "Шапка: заголовок, иконка, доп. контент",
51581
+ "type": "full-code",
51582
+ "code": "import { Button } from '@sber-digital-finance-ui/ui-kit';\nimport { TableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport { IconCloudDownloadOutline } from '@sber-digital-finance-ui/ui-kit/icons';\n\n() => (\n <TableCanvasLogger\n items={PLAIN_ITEMS}\n defaultOpen\n title=\"Журнал загрузки\"\n icon={<IconCloudDownloadOutline size=\"xs\" />}\n headerExtra={\n <Button\n size=\"xxs\"\n view=\"clear\"\n text=\"Очистить\"\n onClick={(e) => e.stopPropagation()}\n />\n }\n showEmptyFilters\n />\n )"
51583
+ },
51584
+ {
51585
+ "exportName": "CustomStyling",
51586
+ "displayName": "Стилизация: classes и $css",
51587
+ "type": "args-only",
51588
+ "code": "{\n items: PLAIN_ITEMS,\n defaultOpen: true,\n $css: {\n padding: 16,\n border: '1px solid rgba(0,0,0,0.12)',\n borderRadius: 12,\n },\n }"
51589
+ },
51590
+ {
51591
+ "exportName": "Headless",
51592
+ "displayName": "Headless: useTableCanvasLogger + собственная вёрстка",
51593
+ "type": "full-code",
51594
+ "code": "import { TableCanvasLoggerFilters, TableCanvasLoggerItems, TableCanvasLoggerProvider, useTableCanvasLogger } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => {\n const logger = useTableCanvasLogger({\n items: PLAIN_ITEMS,\n defaultFilter: 'all',\n });\n\n return (\n <TableCanvasLoggerProvider\n expandedIds={logger.expandedIds}\n toggleExpanded={logger.toggleExpanded}\n >\n <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>\n <TableCanvasLoggerFilters\n counts={logger.counts}\n value={logger.filter}\n onChange={logger.setFilter}\n showEmpty\n />\n <TableCanvasLoggerItems items={logger.visibleItems} />\n </div>\n </TableCanvasLoggerProvider>\n );\n }"
51595
+ },
51596
+ {
51597
+ "exportName": "SingleParts",
51598
+ "displayName": "Отдельные части: TableCanvasLoggerMessage и TableCanvasLoggerGroup",
51599
+ "type": "full-code",
51600
+ "code": "import { TableCanvasLoggerGroup, TableCanvasLoggerMessage } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\nimport type { TableCanvasLoggerGroupItem, TableCanvasLoggerMessageItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';\n\n() => (\n <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>\n {singleMessage && <TableCanvasLoggerMessage item={singleMessage} />}\n {singleGroup && (\n <TableCanvasLoggerGroup item={singleGroup} open>\n <TableCanvasLoggerMessage\n item={{\n id: 'standalone-2',\n status: 'warning',\n title: 'Вложенное сообщение',\n }}\n />\n </TableCanvasLoggerGroup>\n )}\n </div>\n )"
51601
+ }
51602
+ ]
51603
+ },
50688
51604
  {
50689
51605
  "component": "TableCanvas",
50690
51606
  "feature": "Sorting",
@@ -50945,7 +51861,7 @@
50945
51861
  "feature": "Tooltip",
50946
51862
  "legacy": false,
50947
51863
  "summary": "*tableConfig.tooltip + columnConfig.cellTooltip / headerCellTooltip**",
50948
- "docs": "# Tooltip на канвасной таблице\n\n**tableConfig.tooltip + columnConfig.cellTooltip / headerCellTooltip**\n\nОдин общий тултип для элементов, отрисованных на канвасе (ячейки, заголовки, кнопки и т.д.). Тултип показывается при наведении на те канвас-элементы, которые явно участвуют в механике тултипа.\n\n## Принцип работы\n\n- На таблице работает **один тултип**: при наведении на разные элементы отображается один и тот же тултип-оверлей с нужным текстом/пропсами для текущего элемента.\n- Участие элемента в показе тултипа задаётся через проп **`portalHoverEnabled`** на Canvas-примитиве — без этого пропса наведение на элемент не будет передаваться в подсистему тултипа.\n\n## Три источника конфига (по приоритету)\n\n1. **Проп `tooltip` на Canvas-элементе** — задаётся прямо на `Canvas.Container`, `Canvas.Button` и т.д. Строка или объект с `text`. Самый высокий приоритет. **Работает всегда.**\n2. **Поле `cellTooltip` / `headerCellTooltip` в `columnConfig`** — конфиг на уровне колонки. Может быть строкой, объектом или функцией `(context) => config | null`. Для ячеек используется `cellTooltip`, для заголовков — `headerCellTooltip`. **Требует `tooltip.enabled: true` в `tableConfig`.**\n3. **Встроенный маппинг по `nodeId`** — внутренний словарь (например, иконка drag в заголовке → «Перетащить колонку»). **Работает всегда.**\n\n## Как включить тултип на элементе\n\n### Через `tooltip` на Canvas-примитиве\n\nВ `renderCell` / `renderHeaderCell` задать `portalHoverEnabled` и `tooltip` на нужном элементе:\n\n```tsx\nrenderCell: () => (\n <Canvas.Button\n portalHoverEnabled\n tooltip=\"Нажмите для перехода\"\n onClick={() => {}}\n >\n Подробнее\n </Canvas.Button>\n);\n```\n\n### Авто-тултип для обрезанного текста (`autoTooltip` на `Canvas.Text`)\n\nЧастный случай node-тултипа: `Canvas.Text` с пропом `autoTooltip` показывает тултип с полным текстом **только когда текст реально обрезан в многоточие** (однострочный ellipsis или многострочный clamp). `portalHoverEnabled` включается автоматически, `tooltip.enabled: true` в `tableConfig` не требуется — работает всегда, как и остальные node-тултипы.\n\n```tsx\nrenderCell: ({ row }) => (\n <Canvas.Text\n overflow=\"hidden\"\n textOverflow=\"ellipsis\"\n autoTooltip\n style={{ flexGrow: 1 }}\n >\n {row.longText}\n </Canvas.Text>\n);\n```\n\nПоведение настраивается объектом: `placement`, `view`, `mouseEnterDelay` / `mouseLeaveDelay`, трансформация текста через `text`, выключение через `enabled: false`. Подробности и правила — в [доке Canvas.Text](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvastext--docs), тип — `CanvasTextAutoTooltip`.\n\n> Действует только на `Canvas.Text` в canvas-разметке (`renderCell` / `renderHeaderCell`). Обычные текстовые ячейки (примитивные значения без `renderCell`) рисуются встроенным text-рендерером glide — авто-тултип на них пока не распространяется.\n\n### Через `cellTooltip` / `headerCellTooltip` в `columnConfig`\n\nЗадать на уровне колонки — строкой, объектом или функцией. Не забудьте включить `tooltip.enabled: true`:\n\n```tsx\ntableConfig={{\n tooltip: { enabled: true },\n}}\ncolumnConfig={[\n {\n key: 'task',\n name: 'Title',\n headerCellTooltip: 'Название задачи',\n cellTooltip: ({ row }) => `Задача: ${row.task}`,\n },\n]}\n```\n\n## Ширина тултипа\n\nШирину тултипа можно задать глобально для всей таблицы через `tableConfig.tooltip`:\n\n```tsx\ntableConfig={{\n tooltip: { minWidth: 120, maxWidth: 440 },\n}}\n```\n\nЭта ширина применяется ко всем canvas-тултипам, включая авто-тултип `Canvas.Text`.\n\nЧисло трактуется как пиксели. Если нужна другая единица, передайте строку: `maxWidth: '20rem'`, `maxWidth: '50%'`.\n\nПриоритет от высокого к низкому:\n\n- ширина, заданная на самом тултипе (`tooltip` или `autoTooltip` на Canvas-элементе);\n- глобальная `tableConfig.tooltip.minWidth` / `maxWidth`;\n- дефолт компонента `Tooltip`.\n\nТо есть глобальное значение работает как значение по умолчанию, а точечное на элементе его перекрывает:\n\n```tsx\n// у этого тултипа своя ширина, глобальная не применится\n<Canvas.Text\n overflow=\"hidden\"\n textOverflow=\"ellipsis\"\n autoTooltip={{ maxWidth: 300 }}\n>\n {row.longText}\n</Canvas.Text>\n```\n\n## Формат конфига\n\n- **Строка** — используется как текст тултипа с дефолтными пропсами.\n- **Объект** `{ text: string, placement?, view?, mouseEnterDelay?, ... }` — текст и кастомные пропсы для `Tooltip`.\n- **`null`** — тултип для этого элемента не показывается (переход к следующему приоритету или без тултипа).\n\nПодробное описание типов и контракта — в разделе [API](/docs/локальные-компоненты-tablecanvas-tooltip-api--docs).",
51864
+ "docs": "# Tooltip на канвасной таблице\n\n**tableConfig.tooltip + columnConfig.cellTooltip / headerCellTooltip**\n\nОдин общий тултип для элементов, отрисованных на канвасе (ячейки, заголовки, кнопки и т.д.). Тултип показывается при наведении на те канвас-элементы, которые явно участвуют в механике тултипа.\n\n## Принцип работы\n\n- На таблице работает **один тултип**: при наведении на разные элементы отображается один и тот же тултип-оверлей с нужным текстом/пропсами для текущего элемента.\n- Участие элемента в показе тултипа задаётся через проп **`portalHoverEnabled`** на Canvas-примитиве — без этого пропса наведение на элемент не будет передаваться в подсистему тултипа.\n\n## Три источника конфига (по приоритету)\n\n1. **Проп `tooltip` на Canvas-элементе** — задаётся прямо на `Canvas.Container`, `Canvas.Button` и т.д. Строка или объект с `text`. Самый высокий приоритет. **Работает всегда.**\n2. **Поле `cellTooltip` / `headerCellTooltip` в `columnConfig`** — конфиг на уровне колонки. Может быть строкой, объектом или функцией `(context) => config | null`. Для ячеек используется `cellTooltip`, для заголовков — `headerCellTooltip`. **Требует `tooltip.enabled: true` в `tableConfig`.**\n3. **Встроенный маппинг по `nodeId`** — внутренний словарь (например, иконка drag в заголовке → «Перетащить колонку»). **Работает всегда.**\n\n### Тултип ячейки с ошибкой\n\nВ режиме редактирования у колонки может быть `editingCell.error.tooltip(row, treeLevel)`. Он показывается при наведении на любую точку ячейки, которую `editingCell.error.value` пометила как ошибочную. По приоритету он стоит между первым и вторым источником: перекрывает `cellTooltip` колонки, но уступает пропу `tooltip` на Canvas-элементе внутри той же ячейки. **Работает всегда**, `tooltip.enabled` не требуется. Тултип индикатора ошибок строки (`editing.rowErrors.tooltip`) это обычный `tooltip` на Canvas-иконке служебного столбца. Подробности в [доке Editing](?path=/docs/локальные-компоненты-tablecanvas-editing--docs).\n\n## Как включить тултип на элементе\n\n### Через `tooltip` на Canvas-примитиве\n\nВ `renderCell` / `renderHeaderCell` задать `portalHoverEnabled` и `tooltip` на нужном элементе:\n\n```tsx\nrenderCell: () => (\n <Canvas.Button\n portalHoverEnabled\n tooltip=\"Нажмите для перехода\"\n onClick={() => {}}\n >\n Подробнее\n </Canvas.Button>\n);\n```\n\n### Авто-тултип для обрезанного текста (`autoTooltip` на `Canvas.Text`)\n\nЧастный случай node-тултипа: `Canvas.Text` с пропом `autoTooltip` показывает тултип с полным текстом **только когда текст реально обрезан в многоточие** (однострочный ellipsis или многострочный clamp). `portalHoverEnabled` включается автоматически, `tooltip.enabled: true` в `tableConfig` не требуется — работает всегда, как и остальные node-тултипы.\n\n```tsx\nrenderCell: ({ row }) => (\n <Canvas.Text\n overflow=\"hidden\"\n textOverflow=\"ellipsis\"\n autoTooltip\n style={{ flexGrow: 1 }}\n >\n {row.longText}\n </Canvas.Text>\n);\n```\n\nПоведение настраивается объектом: `placement`, `view`, `mouseEnterDelay` / `mouseLeaveDelay`, трансформация текста через `text`, выключение через `enabled: false`. Подробности и правила — в [доке Canvas.Text](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvastext--docs), тип — `CanvasTextAutoTooltip`.\n\n> Действует только на `Canvas.Text` в canvas-разметке (`renderCell` / `renderHeaderCell`). Обычные текстовые ячейки (примитивные значения без `renderCell`) рисуются встроенным text-рендерером glide — авто-тултип на них пока не распространяется.\n\n### Через `cellTooltip` / `headerCellTooltip` в `columnConfig`\n\nЗадать на уровне колонки — строкой, объектом или функцией. Не забудьте включить `tooltip.enabled: true`:\n\n```tsx\ntableConfig={{\n tooltip: { enabled: true },\n}}\ncolumnConfig={[\n {\n key: 'task',\n name: 'Title',\n headerCellTooltip: 'Название задачи',\n cellTooltip: ({ row }) => `Задача: ${row.task}`,\n },\n]}\n```\n\n## Ширина тултипа\n\nШирину тултипа можно задать глобально для всей таблицы через `tableConfig.tooltip`:\n\n```tsx\ntableConfig={{\n tooltip: { minWidth: 120, maxWidth: 440 },\n}}\n```\n\nЭта ширина применяется ко всем canvas-тултипам, включая авто-тултип `Canvas.Text`.\n\nЧисло трактуется как пиксели. Если нужна другая единица, передайте строку: `maxWidth: '20rem'`, `maxWidth: '50%'`.\n\nПриоритет от высокого к низкому:\n\n- ширина, заданная на самом тултипе (`tooltip` или `autoTooltip` на Canvas-элементе);\n- глобальная `tableConfig.tooltip.minWidth` / `maxWidth`;\n- дефолт компонента `Tooltip`.\n\nТо есть глобальное значение работает как значение по умолчанию, а точечное на элементе его перекрывает:\n\n```tsx\n// у этого тултипа своя ширина, глобальная не применится\n<Canvas.Text\n overflow=\"hidden\"\n textOverflow=\"ellipsis\"\n autoTooltip={{ maxWidth: 300 }}\n>\n {row.longText}\n</Canvas.Text>\n```\n\n## Формат конфига\n\n- **Строка** — используется как текст тултипа с дефолтными пропсами.\n- **Объект** `{ text: string, placement?, view?, mouseEnterDelay?, ... }` — текст и кастомные пропсы для `Tooltip`.\n- **`null`** — тултип для этого элемента не показывается (переход к следующему приоритету или без тултипа).\n\nПодробное описание типов и контракта — в разделе [API](/docs/локальные-компоненты-tablecanvas-tooltip-api--docs).",
50949
51865
  "apiDocs": "# Tooltip API\n\n## Источники конфига тултипа\n\nТултип может быть задан на **трёх уровнях** (проверяются по приоритету, первый непустой побеждает):\n\n1. **Встроенный маппинг по `nodeId`** — внутренний словарь `TOOLTIP_TEXTS` (например, `HEADER_TOOLTIP_DRAG_ID` → «Перетащить колонку»). **Работает всегда.** Наивысший приоритет — колоночный конфиг не может перебить внутренние тултипы UI таблицы.\n2. **Проп `tooltip` на Canvas-элементе** — задаётся прямо на `Canvas.Container`, `Canvas.Button` и т.д. внутри `renderCell` / `renderHeaderCell`. Тип: `CanvasNodeTooltipConfig`. **Работает всегда.**\n3. **Поле `cellTooltip` / `headerCellTooltip` в `columnConfig`** — на уровне конфигурации колонки. Может быть строкой, объектом или функцией `(context) => config | null`. **Работает только при `tooltip.enabled: true`.**\n\n**Формат конфига:** строка (только текст) или объект с обязательным полем `text` и опциональными пропсами `Tooltip` (`placement`, `view` и т.д.; без `opened`, `target`, `style`), а также `mouseEnterDelay` / `mouseLeaveDelay` для per-node задержек.\n\nПо умолчанию текст рендерится с `white-space: normal` — переносы строк (`\\n`) в `text` схлопываются в пробел. Чтобы сохранить переносы (например, в многострочных подсказках), добавьте в объектную форму конфига `preserveLineBreaks: true` — тогда к тексту тултипа применится `white-space: pre-line`. Флаг выключен по умолчанию и не меняет поведение существующих строковых тултипов.\n\n## Модуль tableConfig.tooltip\n\nГлобальные настройки тултипа вынесены в `tableConfig.tooltip` (тип `TableConfigTooltip`):\n\n- **tooltip.enabled** — включает колоночные/кастомные тултипы (`cellTooltip`, `headerCellTooltip`). По умолчанию `false`. Внутренние тултипы (проп `tooltip` на Canvas-элементе и маппинг по `nodeId`) работают всегда, независимо от `enabled`.\n- **tooltip.mouseEnterDelay** — глобальная задержка перед показом (мс, по умолчанию `500`). Per-node переопределяет.\n- **tooltip.mouseLeaveDelay** — глобальная задержка перед скрытием (мс, по умолчанию `0`). Per-node переопределяет.\n- **tooltip.minWidth** — глобальная минимальная ширина тултипа (число = px, строка с единицей отдаётся как есть). Действует на все canvas-тултипы, включая авто-тултип `Canvas.Text`. Per-node переопределяет.\n- **tooltip.maxWidth** — глобальная максимальная ширина тултипа (число = px, строка с единицей отдаётся как есть). Действует на все canvas-тултипы, включая авто-тултип `Canvas.Text`. Per-node переопределяет.\n\nПример:\n\n```tsx\ntableConfig={{\n tooltip: {\n enabled: true,\n mouseEnterDelay: 300,\n maxWidth: 440,\n },\n}}\n```\n\n## Колоночные cellTooltip / headerCellTooltip\n\nЗадаются в `columnConfig` на уровне колонки. Значение — строка, объект или функция. Требуют `tooltip.enabled: true` в `tableConfig`:\n\n```tsx\nconst columnConfig = [\n {\n key: 'task',\n name: 'Title',\n // Строка — простой текст\n headerCellTooltip: 'Название задачи',\n // Функция — динамический конфиг\n cellTooltip: ({ row, column }) => {\n return `${column.name}: ${row.task}`;\n },\n },\n];\n```\n\nКонтекст функции `cellTooltip` содержит: `row`, `column`, `ctxs`, `refTable`, `colInd`, `rowInd`, `theme`.\nКонтекст функции `headerCellTooltip` содержит: `column`, `ctxs`, `refTable`, `colInd`, `theme`.\n\n---\n\n## Типы\n\n### CanvasNodeTooltipConfig\n\nПроп `tooltip` на Canvas-элементах и базовый формат конфига. Строка (текст) или объект с `text` и опциональными пропсами Tooltip.\n\n```typescript\ntype CanvasNodeTooltipConfig =\n | string\n | (CanvasNodeTooltipProps & {\n /** Текст тултипа (только string, не ReactNode). */\n text: string;\n /** Задержка перед показом (мс). По умолчанию 0. */\n mouseEnterDelay?: number;\n /** Задержка перед скрытием после ухода мыши (мс). По умолчанию 0. */\n mouseLeaveDelay?: number;\n });\n```\n\n### CanvasNodeTooltipProps\n\nПропсы Tooltip, которые можно задать через объектную форму конфига. Управляемые внутренне поля (`opened`, `target`, `style`, `text`, `mouseEnterDelay`, `mouseLeaveDelay`, `hoverTimeout`, `trigger`) исключены.\n\n```typescript\ntype 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};\n```\n\n### TooltipConfigResult\n\nАлиас: `CanvasNodeTooltipConfig | null`. Используется как возвращаемый тип функциональной формы `cellTooltip` / `headerCellTooltip`.\n\n```typescript\ntype TooltipConfigResult = CanvasNodeTooltipConfig | null;\n```\n\n### TooltipData\n\nВнутренний результат резолвинга: текст, пропсы тултипа и per-node задержки. Возвращается из `resolveTooltipData` и передаётся в `usePortalHover`.\n\n```typescript\ninterface TooltipData {\n tooltipText: string;\n tooltipProps?: CanvasNodeTooltipProps;\n mouseEnterDelay?: number;\n mouseLeaveDelay?: number;\n}\n```\n\n### TableConfigTooltip\n\nГлобальные настройки тултипа в `tableConfig.tooltip`.\n\n```typescript\ntype 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```\n\n### CanvasPortalHoverDetail\n\nОбъект события hover по canvas-элементу. Содержит координаты, размеры, `nodeId`, `source` (`'header'` | `'cell'`), `tooltipFromNode` и `tooltipContext` (column, row, ctxs, refTable).\n\n```typescript\ninterface CanvasPortalHoverDetail<\n TContext extends TooltipContextShape = TooltipContextShape\n> {\n visible: boolean;\n x: number;\n y: number;\n width: number;\n height: number;\n node?: CanvasNode | null;\n nodeId?: string;\n source?: CanvasPortalSource;\n originId?: string;\n /** column, row, ctxs, refTable — тип задаётся generic TContext */\n tooltipContext?: TContext;\n /** Конфиг с ноды (проп tooltip на Canvas-элементе). */\n tooltipFromNode?: CanvasNodeTooltipConfig;\n /**\n * Приоритет события. usePortalHover не заменяет активный тултип с бо́льшим приоритетом.\n * - 1 — canvas-нода (CanvasHoverController)\n * - 0 — колоночный тултип (useItemHoveredHandler)\n * @default 0\n */\n priority?: number;\n}\n```",
50950
51866
  "api": [
50951
51867
  {
@@ -52415,19 +53331,47 @@
52415
53331
  "importStatement": "import { StorySlide } from '@sber-digital-finance-ui/ui-kit';",
52416
53332
  "sourceFile": "packages/ui-kit/src/components/Stories/Stories.types.ts"
52417
53333
  },
52418
- "Table.ColumnConfig": {
53334
+ "ColumnConfig": {
52419
53335
  "name": "ColumnConfig",
52420
53336
  "definition": "export type ColumnConfig<\n Row extends ObjectForExtending,\n SummRow = unknown,\n> = ColumnDefaultOmitted<Row, SummRow> & {\n /**\n * Если в поле name был передан jsx, то нужно заполнить nameAsString для указания label в разделе Настройки столбцов, либо для отображения label в фильтрах в правом сайдбаре (но приоритет для фильтро будет ниже, чем то, что указали в filtering.sidebarConfig.items, там отдельно можно перезаписать label для фильтров сайдабара)\n */\n nameAsString?: string;\n sortingType?: 'stringSort' | 'numberSort' | Comparator<Row>;\n searching?: {\n valueInRow: (row: Row) => string | number;\n };\n filtering?: {\n keyInFilterState: string;\n /**\n * Обязательно передать в случае НЕ ручной фильтрации. Если на уровне tableConfig.manualFiltering = false или не задан. Иначе фильтрация не отработает.\n */\n valueInRow?: (row: Row) => string | number;\n /**\n * ```FilterCb - (filterValue: string, rowValue: string) => boolean```\n */\n } & (\n | {\n component: 'input';\n filter: 'includes' | 'startWith' | 'equal' | FilterCb<'single'>;\n }\n | {\n component: 'select';\n /**\n * Произвольное содержимое над списком опций фильтра.\n *\n * Рендерится и в поповере фильтра в шапке колонки, и в сайдбаре\n * фильтров. Рендерится как компонент, поэтому внутри можно\n * использовать хуки и локальное состояние.\n *\n * @example\n * beforeList: ({ headerContextState }) => (\n * <TableFilterSelectListItem $size={headerContextState.rowSize}>\n * Подсказка над списком\n * </TableFilterSelectListItem>\n * )\n */\n beforeList?: (\n props: FilterComponentInPopoverProps<\n ObjectForExtending,\n ColumnConfig<Row, SummRow>\n >,\n ) => ReactNode;\n /**\n * Произвольное содержимое под списком опций фильтра.\n *\n * Рендерится и в поповере фильтра в шапке колонки, и в сайдбаре\n * фильтров. Рендерится как компонент, поэтому внутри можно\n * использовать хуки и локальное состояние — например, чтобы держать\n * черновик выбора и применять его по кнопке.\n *\n * @example\n * afterList: ({ headerContextState, setPopoverIsOpen }) => (\n * <TableFilterSelectListItem $size={headerContextState.rowSize}>\n * Подсказка под списком\n * </TableFilterSelectListItem>\n * )\n */\n afterList?: (\n props: FilterComponentInPopoverProps<\n ObjectForExtending,\n ColumnConfig<Row, SummRow>\n >,\n ) => ReactNode;\n filter:\n | {\n typeOfValue: 'single';\n /**\n * Обязательно передать в случае НЕ ручной фильтрации. Если на уровне tableConfig.manualFiltering = false или не задан. Иначе фильтрация не отработает.\n */\n filteringType?: FilterCb<'single'>;\n }\n | {\n typeOfValue: 'multiple';\n /**\n * Обязательно передать в случае НЕ ручной фильтрации. Если на уровне tableConfig.manualFiltering = false или не задан. Иначе фильтрация не отработает.\n */\n filteringType?: FilterCb<'multiple'>;\n };\n selectOptions:\n | {\n type: 'constant';\n options: SelectOptions[];\n }\n | {\n type: 'stateInHeaderContext';\n /**\n * тип optionsState, который будет в HeaderContext:\n * ```ts\n * {\n * value: string | number;\n * text: string | number;\n * }[];\n * ```\n */\n optionsKeyInHeaderContext: string;\n };\n /**\n * Максимальна высота выпадающего списка в фильтрах колонок / правом сайдбаре.\n * @default \"360px\"\n */\n listMaxHeight?: string;\n }\n | {\n component: 'custom';\n customRender: (\n props: FilterComponentInPopoverProps<\n ObjectForExtending,\n ColumnConfig<Row, SummRow>\n >,\n ) => ReactNode;\n filter?: (filterValue: unknown, rowValue: unknown) => boolean;\n compareWithClearedValue?: (\n clearedValue: unknown,\n currV: unknown,\n ) => boolean;\n }\n );\n\n contentFormat?: ContentFormat;\n\n editingCell?: Editing<Row>;\n\n subRow?: {\n /**\n * @default false\n */\n isColumnWithArrow?: boolean | ((props: { keyText: KeyText }) => boolean);\n /**\n * @default false\n */\n hideHeaderExpandAllArrow?: boolean;\n /**\n * @default false\n */\n parentKeyAsDefault?: boolean;\n /**\n * @default undefined\n */\n contentFormat?: ContentFormat;\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n renderSubRowCell?: RenderSubRowCell<any>;\n } & (\n | {\n keyOfColumnInSubRow:\n | string\n | number\n | ((lvl: number) => string | number);\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n editingCell: Editing<any>;\n }\n | {\n editingCell?: undefined;\n keyOfColumnInSubRow?:\n | string\n | number\n | ((lvl: number) => string | number);\n }\n );\n rowsGrouping?: ColumnRowsGrouping<Row, SummRow>;\n keyText?: KeyTextColumnConfig<Row, SummRow>;\n};",
52421
53337
  "importPath": "@sber-digital-finance-ui/ui-kit",
52422
53338
  "importStatement": "import { ColumnConfig } from '@sber-digital-finance-ui/ui-kit';",
52423
53339
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
52424
53340
  },
52425
- "TableCanvas.ColumnConfig": {
52426
- "name": "ColumnConfig",
52427
- "definition": "export type ColumnConfig<\n Row extends ObjectForExtending,\n SummRow = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = ColumnDefaultOmitted<Row, SummRow, CustomCtxs> & {\n renderCell?: (cellInfo: CellInfo<Row, SummRow, CustomCtxs>) => CellContent;\n renderCellPreview?: RenderCellPreview<Row, SummRow, CustomCtxs>;\n /**\n * Если в поле name был передан jsx, то нужно заполнить nameAsString для указания label в разделе Настройки столбцов, либо для отображения label в фильтрах в правом сайдбаре (но приоритет для фильтро будет ниже, чем то, что указали в filtering.sidebarConfig.items, там отдельно можно перезаписать label для фильтров сайдабара)\n */\n nameAsString?: string;\n /**\n * Текстовое представление ячейки для копирования в clipboard (Ctrl+C).\n * Если не задан, используется `row[column.key]?.toString()`.\n * Для кастомных canvas-ячеек (бейджи, кнопки) рекомендуется указывать явно.\n */\n copyData?: string | ((row: Row) => string);\n sortingType?: 'stringSort' | 'numberSort' | Comparator<Row>;\n searching?: {\n valueInRow: (row: Row) => string | number;\n };\n filtering?: {\n keyInFilterState: string;\n /**\n * Обязательно передать в случае НЕ ручной фильтрации. Если на уровне tableConfig.manualFiltering = false или не задан. Иначе фильтрация не отработает.\n */\n valueInRow?: (row: Row) => string | number;\n /**\n * ```FilterCb - (filterValue: string, rowValue: string) => boolean```\n */\n } & (\n | {\n component: 'input';\n filter: 'includes' | 'startWith' | 'equal' | FilterCb<'single'>;\n }\n | {\n component: 'select';\n /**\n * Произвольное содержимое над списком опций фильтра.\n *\n * Рендерится и в поповере фильтра в шапке колонки, и в сайдбаре\n * фильтров. Рендерится как компонент, поэтому внутри можно\n * использовать хуки и локальное состояние.\n *\n * @example\n * beforeList: ({ headerContextState }) => (\n * <TableFilterSelectListItem $size={headerContextState.rowSize}>\n * Подсказка над списком\n * </TableFilterSelectListItem>\n * )\n */\n beforeList?: (\n props: FilterComponentInPopoverProps<\n ObjectForExtending,\n ColumnConfig<Row, SummRow>\n >,\n ) => ReactNode;\n /**\n * Произвольное содержимое под списком опций фильтра.\n *\n * Рендерится и в поповере фильтра в шапке колонки, и в сайдбаре\n * фильтров. Рендерится как компонент, поэтому внутри можно\n * использовать хуки и локальное состояние — например, чтобы держать\n * черновик выбора и применять его по кнопке.\n *\n * @example\n * afterList: ({ headerContextState, setPopoverIsOpen }) => (\n * <TableFilterSelectListItem $size={headerContextState.rowSize}>\n * Подсказка под списком\n * </TableFilterSelectListItem>\n * )\n */\n afterList?: (\n props: FilterComponentInPopoverProps<\n ObjectForExtending,\n ColumnConfig<Row, SummRow>\n >,\n ) => ReactNode;\n filter:\n | {\n typeOfValue: 'single';\n /**\n * Обязательно передать в случае НЕ ручной фильтрации. Если на уровне tableConfig.manualFiltering = false или не задан. Иначе фильтрация не отработает.\n */\n filteringType?: FilterCb<'single'>;\n }\n | {\n typeOfValue: 'multiple';\n /**\n * Обязательно передать в случае НЕ ручной фильтрации. Если на уровне tableConfig.manualFiltering = false или не задан. Иначе фильтрация не отработает.\n */\n filteringType?: FilterCb<'multiple'>;\n };\n selectOptions:\n | {\n type: 'constant';\n options: SelectOptions[];\n }\n | {\n type: 'stateInHeaderContext';\n /**\n * тип optionsState, который будет в HeaderContext:\n * ```ts\n * {\n * value: string | number;\n * text: string | number;\n * }[];\n * ```\n */\n optionsKeyInHeaderContext: string;\n };\n /**\n * Максимальна высота выпадающего списка в фильтрах колонок / правом сайдбаре.\n * @default \"360px\"\n */\n listMaxHeight?: string;\n }\n | {\n component: 'custom';\n customRender: (\n props: FilterComponentInPopoverProps<\n ObjectForExtending,\n ColumnConfig<Row, SummRow>\n >,\n ) => ReactNode;\n filter?: (filterValue: unknown, rowValue: unknown) => boolean;\n compareWithClearedValue?: (\n clearedValue: unknown,\n currV: unknown,\n ) => boolean;\n }\n );\n\n contentFormat?: ContentFormat;\n\n editingCell?: Editing<Row, SummRow>;\n\n /**\n * Настройки колонки для дерева subRows (шеврон, свой контент и редактор на\n * вложенных уровнях). Работает только в виде дерева. При\n * `subRows.view: 'merged'` не действует: там листья рисуются как обычные\n * строки, вложенных уровней нет.\n */\n subRow?: {\n /**\n * @default false\n */\n isColumnWithArrow?: boolean | ((props: { keyText: KeyText }) => boolean);\n /**\n * @default false\n */\n hideHeaderExpandAllArrow?: boolean;\n /**\n * @default false\n */\n parentKeyAsDefault?: boolean;\n /**\n * @default undefined\n */\n contentFormat?: ContentFormat;\n\n renderSubRowCell?: RenderSubRowCell<ObjectForExtending>;\n } & (\n | {\n keyOfColumnInSubRow:\n | string\n | number\n | ((lvl: number) => string | number);\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n editingCell: Editing<any, any>;\n }\n | {\n editingCell?: undefined;\n keyOfColumnInSubRow?:\n …",
53341
+ "TableCanvasLoggerGroupItem": {
53342
+ "name": "TableCanvasLoggerGroupItem",
53343
+ "definition": "export type TableCanvasLoggerGroupItem = TableCanvasLoggerItemBase & {\n items: TableCanvasLoggerItem[];\n /** Раскрыть группу при появлении. В управляемом `expandedIds` не применяется */\n defaultOpen?: boolean;\n};",
53344
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53345
+ "importStatement": "import { TableCanvasLoggerGroupItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53346
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
53347
+ },
53348
+ "TableCanvasLoggerItem": {
53349
+ "name": "TableCanvasLoggerItem",
53350
+ "definition": "export type TableCanvasLoggerItem =\n | TableCanvasLoggerMessageItem\n | TableCanvasLoggerGroupItem;",
53351
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53352
+ "importStatement": "import { TableCanvasLoggerItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53353
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
53354
+ },
53355
+ "TableCanvasLoggerMessageItem": {
53356
+ "name": "TableCanvasLoggerMessageItem",
53357
+ "definition": "export type TableCanvasLoggerMessageItem = TableCanvasLoggerItemBase & {\n /** Текст подробностей. Если строка, то доступно копирование */\n description?: ReactNode;\n /** Дата создания: ISO-строка, timestamp или Date */\n date?: string | number | Date;\n /** Идентификатор трассировки. Показывает кнопку копирования */\n traceId?: string | null;\n /** Код сообщения, например F23. Показывается отдельной кнопкой */\n code?: string;\n /** Дополнительные действия, добавляются после встроенных кнопок */\n actions?: TableCanvasLoggerAction[];\n items?: undefined;\n};",
53358
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53359
+ "importStatement": "import { TableCanvasLoggerMessageItem } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53360
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
53361
+ },
53362
+ "TableCanvasLoggerStatus": {
53363
+ "name": "TableCanvasLoggerStatus",
53364
+ "definition": "export type TableCanvasLoggerStatus = 'error' | 'warning' | 'info' | 'success';",
53365
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53366
+ "importStatement": "import { TableCanvasLoggerStatus } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53367
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
53368
+ },
53369
+ "TableCanvasLoggerClasses": {
53370
+ "name": "TableCanvasLoggerClasses",
53371
+ "definition": "export type TableCanvasLoggerClasses = {\n root?: string;\n header?: string;\n filters?: string;\n filter?: string;\n list?: string;\n empty?: string;\n group?: string;\n groupHeader?: string;\n groupBody?: string;\n message?: string;\n messageIcon?: string;\n messageTitle?: string;\n messageActions?: string;\n messageDate?: string;\n messageDescription?: string;\n};",
52428
53372
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52429
- "importStatement": "import { ColumnConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52430
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
53373
+ "importStatement": "import { TableCanvasLoggerClasses } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53374
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
52431
53375
  },
52432
53376
  "TableGlide.ObjectForExtending": {
52433
53377
  "name": "ObjectForExtending",
@@ -52466,7 +53410,7 @@
52466
53410
  },
52467
53411
  "ColumnGlideInstance": {
52468
53412
  "name": "ColumnGlideInstance",
52469
- "definition": "export type ColumnGlideInstance<\n R extends ObjectForExtending,\n SR,\n CustomCtxs extends ObjectForExtending = {},\n> = {\n key: string;\n name: string | CanvasEl;\n nameAsString?: string;\n readonly width?: number;\n isServiceColumn?: boolean;\n isErrorCell?: (row: R) => boolean;\n frozen?: boolean;\n /** Минимальная ширина колонки (px). Ограничивает ресайз и начальную ширину снизу. */\n minWidth?: number;\n /** Максимальная ширина колонки (px). Ограничивает ресайз и начальную ширину сверху. */\n maxWidth?: number;\n /** Максимальная ширина колонки при auto-sizing и grow-распределении (px). Не ограничивает ручной ресайз. */\n maxAutoWidth?: number;\n renderHeaderCell?: (\n cellInfo: HeaderCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CanvasContent;\n renderCell?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellContent;\n contentAlign?: 'left' | 'right' | 'center';\n copyData?: string | ((row: R) => string);\n editable?: boolean | ((row: R) => boolean);\n renderEditCell?: (\n cellInfo: EditingCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => ReactNode;\n /**\n * Кастомный рендер preview-ячейки (при двойном клике на readonly-ячейку).\n * 'none' — отключает превью. 'cellEditorAsPreview' — стандартный текстовый превью.\n * Функция — полностью кастомный рендер.\n */\n renderCellPreview?:\n | 'none'\n | 'cellEditorAsPreview'\n | ((\n cellInfo: PreviewCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => ReactNode);\n renderSummaryCell?: (\n cellInfo: SummaryCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellContent;\n colSpan?:\n | number\n | ((cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>) => number);\n /** Объединение строк: (cellInfo) => [перваяСтрока, последняяСтрока] | null (см. TableGlide RowSpan). */\n rowSpan?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => readonly [number, number] | null;\n /** Выравнивание контента в объединённой ячейке тела; в adaptColumn идёт в glide как `spanAlign`. */\n spanAlign?:\n | SpanCellAlign\n | ((\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => SpanCellAlign | undefined);\n /** Выравнивание в объединённой шапке; в adaptColumn идёт в glide как `spanGroupHeaderAlign`. */\n squashedHeaderAlign?: HeaderAlignment;\n /** Тултип для ячеек этой колонки. Строка, объект или функция (context) => config | null. */\n cellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n row: R;\n column: ColumnGlideInstance<R, SR, CustomCtxs>;\n ctxs: CtxsType<CustomCtxs>;\n refTable?: React.Ref<DataEditorRef>;\n colInd?: number;\n rowInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /** Тултип для шапки колонки. Строка, объект или функция (context) => config | null. */\n headerCellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n column: ColumnGlideInstance<R, SR, CustomCtxs>;\n ctxs: CtxsType<CustomCtxs>;\n refTable?: React.Ref<DataEditorRef>;\n colInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n columnThemeOverride?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellThemeOverrideResult | undefined;\n};",
53413
+ "definition": "export type ColumnGlideInstance<\n R extends ObjectForExtending,\n SR,\n CustomCtxs extends ObjectForExtending = {},\n> = {\n key: string;\n name: string | CanvasEl;\n nameAsString?: string;\n readonly width?: number;\n isServiceColumn?: boolean;\n isErrorCell?: (row: R) => boolean;\n /** Тултип ячейки с ошибкой (вызывается при наведении, если isErrorCell вернул true). */\n errorCellTooltip?: (row: R) => CanvasNodeTooltipConfig | null | undefined;\n frozen?: boolean;\n /**\n * Внутреннее: разрешён ли ресайз колонки. `false` у служебных колонок, Glide\n * тогда не показывает курсор ресайза у их границы. Публично ресайз включается\n * только целиком через tableConfig.resizableColumn.\n */\n resizable?: boolean;\n /** Минимальная ширина колонки (px). Ограничивает ресайз и начальную ширину снизу. */\n minWidth?: number;\n /** Максимальная ширина колонки (px). Ограничивает ресайз и начальную ширину сверху. */\n maxWidth?: number;\n /** Максимальная ширина колонки при auto-sizing и grow-распределении (px). Не ограничивает ручной ресайз. */\n maxAutoWidth?: number;\n renderHeaderCell?: (\n cellInfo: HeaderCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CanvasContent;\n renderCell?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellContent;\n contentAlign?: 'left' | 'right' | 'center';\n copyData?: string | ((row: R) => string);\n editable?: boolean | ((row: R) => boolean);\n renderEditCell?: (\n cellInfo: EditingCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => ReactNode;\n /**\n * Кастомный рендер preview-ячейки (при двойном клике на readonly-ячейку).\n * 'none' — отключает превью. 'cellEditorAsPreview' — стандартный текстовый превью.\n * Функция — полностью кастомный рендер.\n */\n renderCellPreview?:\n | 'none'\n | 'cellEditorAsPreview'\n | ((\n cellInfo: PreviewCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => ReactNode);\n renderSummaryCell?: (\n cellInfo: SummaryCellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellContent;\n colSpan?:\n | number\n | ((cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>) => number);\n /** Объединение строк: (cellInfo) => [перваяСтрока, последняяСтрока] | null (см. TableGlide RowSpan). */\n rowSpan?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => readonly [number, number] | null;\n /** Выравнивание контента в объединённой ячейке тела; в adaptColumn идёт в glide как `spanAlign`. */\n spanAlign?:\n | SpanCellAlign\n | ((\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => SpanCellAlign | undefined);\n /** Выравнивание в объединённой шапке; в adaptColumn идёт в glide как `spanGroupHeaderAlign`. */\n squashedHeaderAlign?: HeaderAlignment;\n /** Тултип для ячеек этой колонки. Строка, объект или функция (context) => config | null. */\n cellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n row: R;\n column: ColumnGlideInstance<R, SR, CustomCtxs>;\n ctxs: CtxsType<CustomCtxs>;\n refTable?: React.Ref<DataEditorRef>;\n colInd?: number;\n rowInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /** Тултип для шапки колонки. Строка, объект или функция (context) => config | null. */\n headerCellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n column: ColumnGlideInstance<R, SR, CustomCtxs>;\n ctxs: CtxsType<CustomCtxs>;\n refTable?: React.Ref<DataEditorRef>;\n colInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n columnThemeOverride?: (\n cellInfo: CellInfoGlideInstance<R, SR, CustomCtxs>,\n ) => CellThemeOverrideResult | undefined;\n};",
52470
53414
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52471
53415
  "importStatement": "import { ColumnGlideInstance } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52472
53416
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
@@ -52737,76 +53681,41 @@
52737
53681
  "importStatement": "import { StoriesObjectFit } from '@sber-digital-finance-ui/ui-kit';",
52738
53682
  "sourceFile": "packages/ui-kit/src/components/Stories/Stories.types.ts"
52739
53683
  },
52740
- "Table.ColumnDefaultOmitted": {
53684
+ "ColumnDefaultOmitted": {
52741
53685
  "name": "ColumnDefaultOmitted",
52742
53686
  "definition": "export type ColumnDefaultOmitted<\n Row extends ObjectForExtending,\n SummRow = unknown,\n> = Omit<ColumnDefault<Row, SummRow>, DefaultOmittedKeys>;",
52743
53687
  "internal": true,
52744
53688
  "importNotice": "Тип \"ColumnDefaultOmitted\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52745
53689
  "sourceFile": "packages/ui-kit/src/components/Table/types/data-grid.type.ts"
52746
53690
  },
52747
- "TableCanvas.ColumnDefaultOmitted": {
52748
- "name": "ColumnDefaultOmitted",
52749
- "definition": "export type ColumnDefaultOmitted<\n Row extends ObjectForExtending,\n SummRow = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = Omit<ColumnGlideInstance<Row, SummRow, CustomCtxs>, DefaultOmittedKeys>;",
52750
- "internal": true,
52751
- "importNotice": "Тип \"ColumnDefaultOmitted\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52752
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/glide-type.ts"
52753
- },
52754
- "Table.Comparator": {
53691
+ "Comparator": {
52755
53692
  "name": "Comparator",
52756
53693
  "definition": "export type Comparator<Row extends ObjectForExtending> = (\n a: Row,\n b: Row,\n) => number;",
52757
53694
  "importPath": "@sber-digital-finance-ui/ui-kit",
52758
53695
  "importStatement": "import { Comparator } from '@sber-digital-finance-ui/ui-kit';",
52759
53696
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
52760
53697
  },
52761
- "TableCanvas.Comparator": {
52762
- "name": "Comparator",
52763
- "definition": "export type Comparator<Row extends ObjectForExtending> = (\n a: Row,\n b: Row,\n) => number;",
52764
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52765
- "importStatement": "import { Comparator } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52766
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
52767
- },
52768
- "Table.FilterCb": {
53698
+ "FilterCb": {
52769
53699
  "name": "FilterCb",
52770
53700
  "definition": "type FilterCb<Mode extends 'multiple' | 'single' | void = 'single'> = (\n filterV: Mode extends 'multiple' ? string[] : string,\n rowValue: string,\n) => boolean;",
52771
53701
  "internal": true,
52772
53702
  "importNotice": "Тип \"FilterCb\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52773
53703
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
52774
53704
  },
52775
- "TableCanvas.FilterCb": {
52776
- "name": "FilterCb",
52777
- "definition": "type FilterCb<Mode extends 'multiple' | 'single' | void = 'single'> = (\n filterV: Mode extends 'multiple' ? string[] : string,\n rowValue: string,\n) => boolean;",
52778
- "internal": true,
52779
- "importNotice": "Тип \"FilterCb\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52780
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
52781
- },
52782
- "Table.FilterComponentInPopoverProps": {
53705
+ "FilterComponentInPopoverProps": {
52783
53706
  "name": "FilterComponentInPopoverProps",
52784
53707
  "definition": "export type 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};",
52785
53708
  "internal": true,
52786
53709
  "importNotice": "Тип \"FilterComponentInPopoverProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52787
53710
  "sourceFile": "packages/ui-kit/src/components/Table/feature-filtering/header-filter-button/types.ts"
52788
53711
  },
52789
- "TableCanvas.FilterComponentInPopoverProps": {
52790
- "name": "FilterComponentInPopoverProps",
52791
- "definition": "export type 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};",
52792
- "internal": true,
52793
- "importNotice": "Тип \"FilterComponentInPopoverProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52794
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-filtering/header-filter-button/types.ts"
52795
- },
52796
- "Table.SelectOptions": {
53712
+ "SelectOptions": {
52797
53713
  "name": "SelectOptions",
52798
53714
  "definition": "export type SelectOptions = {\n value: string | number;\n text: string | number;\n};",
52799
53715
  "importPath": "@sber-digital-finance-ui/ui-kit",
52800
53716
  "importStatement": "import { SelectOptions } from '@sber-digital-finance-ui/ui-kit';",
52801
53717
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
52802
53718
  },
52803
- "TableCanvas.SelectOptions": {
52804
- "name": "SelectOptions",
52805
- "definition": "export type SelectOptions = {\n value: string | number;\n text: string | number;\n};",
52806
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52807
- "importStatement": "import { SelectOptions } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52808
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
52809
- },
52810
53719
  "Table.ContentFormat": {
52811
53720
  "name": "ContentFormat",
52812
53721
  "definition": "export type ContentFormat =\n | 'number' // Стандартное числовое форматирование с локалью ru-RU (разделитель тысяч: пробел, дробная часть: запятая)\n | CustomFormat\n | NumberFormatOptions;",
@@ -52821,124 +53730,54 @@
52821
53730
  "importStatement": "import { ContentFormat } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52822
53731
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
52823
53732
  },
52824
- "Table.Editing": {
53733
+ "Editing": {
52825
53734
  "name": "Editing",
52826
53735
  "definition": "export type Editing<RowType extends ObjectForExtending> = {\n /**\n * Если `error.value(row) === true`, то у ячейки появляется красная рамка\n */\n error?: { value: (row: RowType, treeLevel: number) => boolean };\n editedSuccessfully?: { value: (row: RowType, treeLevel: number) => boolean };\n /**\n * Функция для определения возможности редактирования ячейки на основе данных строки (приоритетнее, чем rowEditable в tableConfig.editing)\n */\n editable?: ((row: RowType) => boolean) | boolean;\n} & (\n | {\n component: 'inputString';\n /**\n * Дополнительные пропсы для компонента TextField в редактировании\n * @example { placeholder: \"Введите текст\"}\n */\n inputProps?: Partial<\n Omit<TextFieldProps, 'value' | 'onChange' | 'onBlur' | 'ref' | 'size'>\n >;\n }\n | {\n component: 'inputNumber';\n /**\n * Дополнительные пропсы для компонента NumberFormat в редактировании\n * @example { placeholder: \"Введите текст\"}\n */\n inputProps?: Partial<\n Omit<\n ComponentProps<typeof NumberFormat>,\n 'value' | 'onChange' | 'onBlur' | 'ref' | 'size'\n >\n >;\n }\n | {\n component: 'select';\n options: {\n type: 'constant';\n options: SelectOptions[];\n };\n /**\n * Дополнительные пропсы для компонента Combobox в редактировании\n * @example { listMaxHeight: \"100px\"}\n */\n selectProps?: Partial<\n Omit<\n ComponentProps<typeof Combobox>,\n 'value' | 'onChange' | 'items' | 'ref' | 'size' | 'portal'\n >\n >;\n }\n | {\n component: 'select';\n\n options: {\n type: 'stateInRowContext';\n /**\n * тип optionsState, который будет в RowContext:\n * ```ts\n * options: {\n * value: string | number;\n * text: string | number;\n * }[];\n * ```\n */\n optionsKeyInRowContext: string;\n };\n }\n | {\n /**\n * Кастомный рендер ячейки редактирования\n */\n component: RenderSubRowEditCell<RowType>;\n }\n);",
52827
53736
  "importPath": "@sber-digital-finance-ui/ui-kit",
52828
53737
  "importStatement": "import { Editing } from '@sber-digital-finance-ui/ui-kit';",
52829
53738
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
52830
53739
  },
52831
- "TableCanvas.Editing": {
52832
- "name": "Editing",
52833
- "definition": "export type Editing<RowType extends ObjectForExtending, SummaryRowType> = {\n /**\n * Если `error.value(row) === true`, то у ячейки появляется красная рамка\n */\n error?: { value: (row: RowType, treeLevel: number) => boolean };\n editedSuccessfully?: { value: (row: RowType, treeLevel: number) => boolean };\n /**\n * Функция для определения возможности редактирования ячейки на основе данных строки (приоритетнее, чем rowEditable в tableConfig.editing)\n */\n editable?: ((row: RowType) => boolean) | boolean;\n} & (\n | {\n component: 'inputString';\n /**\n * Дополнительные пропсы для компонента TextField в редактировании\n * @example { placeholder: \"Введите текст\"}\n */\n inputProps?: Partial<\n Omit<\n CellEditorTextAreaProps,\n 'value' | 'onChange' | 'onBlur' | 'ref' | 'size'\n >\n >;\n }\n | {\n component: 'inputNumber';\n /**\n * Дополнительные пропсы для компонента NumberFormat в редактировании\n * @example { placeholder: \"Введите текст\"}\n */\n inputProps?: Partial<\n Omit<\n CellEditorNumberFormatProps,\n 'value' | 'onChange' | 'onBlur' | 'ref' | 'size'\n >\n >;\n }\n | {\n component: 'select';\n options: {\n type: 'constant';\n options: SelectOptions[];\n };\n /**\n * Дополнительные пропсы для компонента Combobox в редактировании\n * @example { listMaxHeight: \"100px\"}\n */\n selectProps?: Partial<\n Omit<\n CellEditorComboboxProps<ComboboxItemOption>,\n 'value' | 'onChange' | 'items' | 'ref' | 'size' | 'portal'\n >\n >;\n }\n | {\n component: 'select';\n\n options: {\n type: 'stateInRowContext';\n /**\n * тип optionsState, который будет в RowContext:\n * ```ts\n * options: {\n * value: string | number;\n * text: string | number;\n * }[];\n * ```\n */\n optionsKeyInRowContext: string;\n };\n }\n | {\n /**\n * Кастомный рендер ячейки редактирования\n */\n component: RenderRowCustomEditCell<RowType, SummaryRowType>;\n }\n);",
52834
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52835
- "importStatement": "import { Editing } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52836
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
52837
- },
52838
- "Table.KeyText": {
53740
+ "KeyText": {
52839
53741
  "name": "KeyText",
52840
53742
  "definition": "export type KeyText = 'key' | 'text' | 'keyText' | 'textKey';",
52841
53743
  "internal": true,
52842
53744
  "importNotice": "Тип \"KeyText\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52843
53745
  "sourceFile": "packages/ui-kit/src/components/Table/feature-key-text/types.ts"
52844
53746
  },
52845
- "TableCanvas.KeyText": {
52846
- "name": "KeyText",
52847
- "definition": "export type KeyText = 'key' | 'text' | 'keyText' | 'textKey';",
52848
- "internal": true,
52849
- "importNotice": "Тип \"KeyText\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52850
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-key-text/types.ts"
52851
- },
52852
- "Table.RenderSubRowCell": {
53747
+ "RenderSubRowCell": {
52853
53748
  "name": "RenderSubRowCell",
52854
53749
  "definition": "export type RenderSubRowCell<SubRowType extends ObjectForExtending> = (\n renderCellProps: RenderCellProps<SubRowType>,\n lvl: number,\n) => ReactNode;",
52855
53750
  "importPath": "@sber-digital-finance-ui/ui-kit",
52856
53751
  "importStatement": "import { RenderSubRowCell } from '@sber-digital-finance-ui/ui-kit';",
52857
53752
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
52858
53753
  },
52859
- "TableCanvas.RenderSubRowCell": {
52860
- "name": "RenderSubRowCell",
52861
- "definition": "export type RenderSubRowCell<\n SubRowType extends ObjectForExtending,\n SummaryRowType = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = (\n renderCellProps: CellInfo<SubRowType, SummaryRowType, CustomCtxs>,\n lvl: number,\n) => CellContent;",
52862
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52863
- "importStatement": "import { RenderSubRowCell } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52864
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
52865
- },
52866
- "Table.ColumnRowsGrouping": {
53754
+ "ColumnRowsGrouping": {
52867
53755
  "name": "ColumnRowsGrouping",
52868
53756
  "definition": "export type ColumnRowsGrouping<RowType, SummaryRowType = unknown> = {\n /**\n * @default true - при наличии ColumnConfig.rowsGrouping\n */\n groupByColumn?: boolean;\n /**\n * @default ColumnConfig.key\n */\n columnGroupLabel?: string;\n renderGroupCell?: (\n props: RenderGroupCellProps<RowType, SummaryRowType>,\n ) => ReactNode;\n};",
52869
53757
  "internal": true,
52870
53758
  "importNotice": "Тип \"ColumnRowsGrouping\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52871
53759
  "sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
52872
53760
  },
52873
- "TableCanvas.ColumnRowsGrouping": {
52874
- "name": "ColumnRowsGrouping",
52875
- "definition": "export 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};",
52876
- "internal": true,
52877
- "importNotice": "Тип \"ColumnRowsGrouping\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52878
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
52879
- },
52880
- "Table.KeyTextColumnConfig": {
53761
+ "KeyTextColumnConfig": {
52881
53762
  "name": "KeyTextColumnConfig",
52882
53763
  "definition": "export type KeyTextColumnConfig<\n Row extends ObjectForExtending,\n SummRow = unknown,\n> =\n | ((props: { keyText: KeyText }) => ColumnConfig<Row, SummRow>)\n | ColumnConfig<Row, SummRow>;",
52883
53764
  "importPath": "@sber-digital-finance-ui/ui-kit",
52884
53765
  "importStatement": "import { KeyTextColumnConfig } from '@sber-digital-finance-ui/ui-kit';",
52885
53766
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
52886
53767
  },
52887
- "TableCanvas.KeyTextColumnConfig": {
52888
- "name": "KeyTextColumnConfig",
52889
- "definition": "export type KeyTextColumnConfig<\n Row extends ObjectForExtending,\n SummRow = unknown,\n> =\n | ((props: { keyText: KeyText }) => ColumnConfig<Row, SummRow>)\n | ColumnConfig<Row, SummRow>;",
52890
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52891
- "importStatement": "import { KeyTextColumnConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52892
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
52893
- },
52894
- "TableCanvas.CellInfo": {
52895
- "name": "CellInfo",
52896
- "definition": "export type CellInfo<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = Omit<\n CellInfoGlideInstance<R, SR, CustomCtxs>,\n 'column' | 'ctxs' | 'hovered' | 'active'\n> & {\n column: ColumnConfig<R, SR, CustomCtxs>;\n ctxs: CtxsType<CustomCtxs>;\n /**\n * Состояние наведения для текущей ячейки, которую рендерит renderCell.\n * `cellHover` равно true только у ячейки под курсором, `rowHover` — у всех ячеек ее строки.\n */\n hovered: CellHoverState;\n /**\n * Состояние активного выделения для текущей ячейки, которую рендерит renderCell.\n * `cellActive` равно true у активной ячейки или диапазона, `rowActive` — у строк с активной ячейкой или диапазоном.\n */\n active: CellActiveState;\n};",
52897
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52898
- "importStatement": "import { CellInfo } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52899
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
52900
- },
52901
- "TableGlide.CellInfo": {
52902
- "name": "CellInfo",
52903
- "definition": "export type CellInfo<R extends ObjectForExtending, SR = unknown> = {\n row: R;\n column: ColumnGlideLast<R, SR>;\n colInd: number;\n rowInd: number;\n ctxs: ObjectForExtending;\n theme: Theme;\n /** Состояние наведения для ячейки, которую сейчас рендерит renderCell. */\n hovered: CellHoverState;\n /** Состояние активного выделения для ячейки, которую сейчас рендерит renderCell. */\n active: CellActiveState;\n // Есть только у верхней-левой ячейки объединённого блока. align — выравнивание\n // блока (пусто = по центру). По нему ячейка-select расставляет контент и\n // уголок по высоте всего блока.\n __mergedCell?: { align?: SpanCellAlign };\n};",
53768
+ "TableCanvasLoggerItemBase": {
53769
+ "name": "TableCanvasLoggerItemBase",
53770
+ "definition": "type TableCanvasLoggerItemBase = {\n /** Уникален среди всех сообщений и групп: по нему хранится раскрытие и строится key */\n id: string;\n status: TableCanvasLoggerStatus;\n title: ReactNode;\n className?: string;\n /** Произвольные данные для кастомных рендеров и колбэков */\n meta?: Record<string, unknown>;\n};",
52904
53771
  "internal": true,
52905
- "importNotice": "Тип \"CellInfo\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
52906
- "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
52907
- },
52908
- "CellContent": {
52909
- "name": "CellContent",
52910
- "definition": "export type CellContent = CanvasContent | GridCell;",
52911
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52912
- "importStatement": "import { CellContent } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52913
- "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
52914
- },
52915
- "RenderCellPreview": {
52916
- "name": "RenderCellPreview",
52917
- "definition": "export type RenderCellPreview<\n Row extends ObjectForExtending,\n SummRow = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> =\n | 'none'\n | 'cellEditorAsPreview'\n | ((cellInfo: PreviewCellInfo<Row, SummRow, CustomCtxs>) => ReactNode);",
52918
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52919
- "importStatement": "import { RenderCellPreview } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52920
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
52921
- },
52922
- "CellThemeOverrideResult": {
52923
- "name": "CellThemeOverrideResult",
52924
- "definition": "export type CellThemeOverrideResult = Partial<{\n bgCell: string;\n cellHorizontalPadding: number;\n cellVerticalPadding: number;\n}>;",
52925
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52926
- "importStatement": "import { CellThemeOverrideResult } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52927
- "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
52928
- },
52929
- "HeaderAlignment": {
52930
- "name": "HeaderAlignment",
52931
- "definition": "export type HeaderAlignment = {\n /** По горизонтали. @default 'left' */\n horizontal?: 'left' | 'center' | 'right';\n /** По вертикали. @default 'center' */\n vertical?: 'top' | 'center' | 'bottom';\n};",
52932
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52933
- "importStatement": "import { HeaderAlignment } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52934
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/columns-grouping.type.ts"
53772
+ "importNotice": "Тип \"TableCanvasLoggerItemBase\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
53773
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
52935
53774
  },
52936
- "MergedCellsAlign": {
52937
- "name": "MergedCellsAlign",
52938
- "definition": "export type MergedCellsAlign = {\n /** По горизонтали. @default из `contentFormat.alignContent` колонки, иначе 'left' */\n horizontal?: 'left' | 'center' | 'right';\n /** По вертикали. @default 'center' */\n vertical?: 'top' | 'center' | 'bottom';\n};",
53775
+ "TableCanvasLoggerAction": {
53776
+ "name": "TableCanvasLoggerAction",
53777
+ "definition": "export type TableCanvasLoggerAction = {\n id: string;\n text?: string;\n icon?: ReactNode;\n view?: ButtonCompProps['view'];\n disabled?: boolean;\n /** Подсказка и aria-label, если у кнопки нет текста */\n title?: string;\n onClick?: (item: TableCanvasLoggerMessageItem) => void;\n};",
52939
53778
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
52940
- "importStatement": "import { MergedCellsAlign } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52941
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/merged-cells.type.ts"
53779
+ "importStatement": "import { TableCanvasLoggerAction } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53780
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
52942
53781
  },
52943
53782
  "AppearanceVariant": {
52944
53783
  "name": "AppearanceVariant",
@@ -52954,6 +53793,13 @@
52954
53793
  "importStatement": "import { CanvasEl } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52955
53794
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
52956
53795
  },
53796
+ "CanvasNodeTooltipConfig": {
53797
+ "name": "CanvasNodeTooltipConfig",
53798
+ "definition": "export type CanvasNodeTooltipConfig =\n | string\n | (CanvasNodeTooltipProps & {\n /** Текст тултипа (только string, не ReactNode). */\n text: string;\n /** Задержка перед показом (мс). По умолчанию 0. */\n mouseEnterDelay?: number;\n /** Задержка перед скрытием после ухода мыши (мс). По умолчанию 0. */\n mouseLeaveDelay?: number;\n });",
53799
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53800
+ "importStatement": "import { CanvasNodeTooltipConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53801
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/utils/portalHoverEvents.ts"
53802
+ },
52957
53803
  "HeaderCellInfoGlideInstance": {
52958
53804
  "name": "HeaderCellInfoGlideInstance",
52959
53805
  "definition": "export type HeaderCellInfoGlideInstance<\n R extends ObjectForExtending,\n SR,\n CustomCtxs extends ObjectForExtending = {},\n> = Omit<HeaderCellInfoGlide<R, SR>, 'column' | 'ctxs'> & {\n column: ColumnGlideInstance<R, SR, CustomCtxs>;\n ctxs: CtxsType<CustomCtxs>;\n};",
@@ -52975,6 +53821,13 @@
52975
53821
  "importStatement": "import { CellInfoGlideInstance } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
52976
53822
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
52977
53823
  },
53824
+ "CellContent": {
53825
+ "name": "CellContent",
53826
+ "definition": "export type CellContent = CanvasContent | GridCell;",
53827
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53828
+ "importStatement": "import { CellContent } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53829
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
53830
+ },
52978
53831
  "EditingCellInfoGlideInstance": {
52979
53832
  "name": "EditingCellInfoGlideInstance",
52980
53833
  "definition": "export type EditingCellInfoGlideInstance<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = Omit<CellInfoGlideInstance<R, SR, CustomCtxs>, 'hovered' | 'active'> & {\n onRowChange: (newV: R, closeEditor?: boolean) => void;\n /** initialValue - введенное значение, если редактор ячейки откроется не по двойному клику а при попытке ввода любой буквы */\n initialValue: string | undefined;\n portalElementRef: React.RefObject<HTMLElement> | undefined;\n activation: CellActivatedEventArgs | undefined;\n cellWidth: number;\n cellHeight: number;\n /** readOnly=true - будет значить, что активен не режим редактирования, а режим превью */\n readOnly: boolean | undefined;\n // onClose: (commitChanges?: boolean, shouldFocusCell?: boolean) => void;\n};",
@@ -53003,12 +53856,12 @@
53003
53856
  "importNotice": "Тип \"SpanCellAlign\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
53004
53857
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
53005
53858
  },
53006
- "CanvasNodeTooltipConfig": {
53007
- "name": "CanvasNodeTooltipConfig",
53008
- "definition": "export type CanvasNodeTooltipConfig =\n | string\n | (CanvasNodeTooltipProps & {\n /** Текст тултипа (только string, не ReactNode). */\n text: string;\n /** Задержка перед показом (мс). По умолчанию 0. */\n mouseEnterDelay?: number;\n /** Задержка перед скрытием после ухода мыши (мс). По умолчанию 0. */\n mouseLeaveDelay?: number;\n });",
53859
+ "HeaderAlignment": {
53860
+ "name": "HeaderAlignment",
53861
+ "definition": "export type HeaderAlignment = {\n /** По горизонтали. @default 'left' */\n horizontal?: 'left' | 'center' | 'right';\n /** По вертикали. @default 'center' */\n vertical?: 'top' | 'center' | 'bottom';\n};",
53009
53862
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53010
- "importStatement": "import { CanvasNodeTooltipConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53011
- "sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/utils/portalHoverEvents.ts"
53863
+ "importStatement": "import { HeaderAlignment } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53864
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/columns-grouping.type.ts"
53012
53865
  },
53013
53866
  "CtxsType": {
53014
53867
  "name": "CtxsType",
@@ -53024,6 +53877,13 @@
53024
53877
  "importNotice": "Тип \"Theme\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
53025
53878
  "sourceFile": "packages/ui-kit/src/components/TableGlide/theming/types.ts"
53026
53879
  },
53880
+ "CellThemeOverrideResult": {
53881
+ "name": "CellThemeOverrideResult",
53882
+ "definition": "export type CellThemeOverrideResult = Partial<{\n bgCell: string;\n cellHorizontalPadding: number;\n cellVerticalPadding: number;\n}>;",
53883
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53884
+ "importStatement": "import { CellThemeOverrideResult } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53885
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
53886
+ },
53027
53887
  "ContextMenuDropdownProps": {
53028
53888
  "name": "ContextMenuDropdownProps",
53029
53889
  "definition": "export type ContextMenuDropdownProps = Omit<\n DropdownProps,\n | 'children'\n | 'items'\n | 'placement'\n | 'closeOnOverlayClick'\n | 'portal'\n | 'openByRightClick'\n | 'onItemClick'\n | 'hoverIndex'\n | 'alwaysOpened'\n | 'trigger'\n | 'hasArrow'\n | 'onItemSelect'\n>;",
@@ -53096,7 +53956,7 @@
53096
53956
  },
53097
53957
  "ColumnGlideCustoms": {
53098
53958
  "name": "ColumnGlideCustoms",
53099
- "definition": "export type ColumnGlideCustoms<R extends ObjectForExtending, SR = unknown> = {\n id: string;\n /** Служебные колонки (marker / checkbox / row instruments) живут по отдельным правилам подсветки. */\n isServiceColumn?: boolean;\n /** Внутренний helper для cell-level error outline, совпадающий по семантике с Table editing error. */\n isErrorCell?: (row: R) => boolean;\n renderHeaderCell?: (cellInfo: HeaderCellInfo<R, SR>) => CanvasContent;\n /** Текстовое представление ячейки для копирования в clipboard (Ctrl+C). */\n copyData?: string | ((row: R) => string);\n editable?: boolean | ((row: R) => boolean);\n contentAlign?: 'right' | 'left' | 'center';\n renderCell?: ColumnGlideGetCellContent<R, SR>;\n renderEditCell?: (cellInfo: EditingCellInfoGlide<R, SR>) => CellContent;\n renderSummaryCell?: (summaryCellInfo: SummaryCellInfo<R, SR>) => CellContent;\n colSpan?: ColSpan<R, SR>;\n rowSpan?: RowSpan<R, SR>;\n /** Выравнивание контента в объединённых ячейках колонки; функция — если нужно задавать для каждого блока отдельно. */\n spanAlign?: SpanCellAlign | ((cellInfo: CellInfo<R, SR>) => SpanCellAlign | undefined);\n /** Тултип для ячеек этой колонки. Строка, объект или функция (context) => config | null. */\n cellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n row: R;\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n rowInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /** Тултип для шапки этой колонки. Строка, объект или функция (context) => config | null. */\n headerCellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /**\n * Свой цвет ячеек колонки (тема ячейки).\n *\n * Цвет лучше брать из темы (`cellInfo.theme`), например статусные\n * `theme.bgCellPositive / bgCellNegative / bgCellWarning / bgCellInfo`:\n * они свои для каждой темы. Фиксированный hex в тёмной теме останется\n * таким же светлым, как в светлой.\n *\n * Подробнее. Если вернуть `bgCell` hex-цветом (`#RGB`, `#RRGGBB`,\n * `#RRGGBBAA` — прозрачный цвет сначала смешивается с фоном ячейки),\n * таблица сама посчитает его состояния (под курсором, в выбранной строке,\n * в выделении) — цвет ведёт себя как встроенные. Не-hex значение\n * (`rgba()`, `var()` и т. п.) применяется как есть, без состояний: ячейка\n * не отреагирует на курсор и выделение.\n */\n columnThemeOverride?: (\n cellInfo: CellInfo<R, SR>\n ) => CellThemeOverrideResult | undefined;\n /** Управление preview для колонки. true — включить overlay, 'none' — отключить (в т.ч. стандартный). */\n hasPreview?: boolean | 'none';\n /**\n * Минимальная ширина колонки в пикселях. Уже этого значения колонку нельзя\n * сжать ни мышью, ни автоматическим расчётом ширины.\n *\n * Подробнее: у каждой колонки есть ещё минимум по содержимому шапки\n * (отступы ячейки, иконки пина и перетаскивания, буква с многоточием,\n * кнопки фильтра и сортировки), он считается в calculateMinColumnWidth.\n * Итоговый минимум это большее из двух, поэтому значение меньше\n * автоматического не действует.\n */\n minWidth?: number;\n /** Максимальная ширина колонки (px). Ограничивает ресайз и начальную ширину сверху. */\n maxWidth?: number;\n};",
53959
+ "definition": "export type ColumnGlideCustoms<R extends ObjectForExtending, SR = unknown> = {\n id: string;\n /** Служебные колонки (marker / checkbox / row instruments) живут по отдельным правилам подсветки. */\n isServiceColumn?: boolean;\n /** Внутренний helper для cell-level error outline, совпадающий по семантике с Table editing error. */\n isErrorCell?: (row: R) => boolean;\n /**\n * Тултип ячейки с ошибкой. Вызывается только при наведении и только если\n * `isErrorCell(row)` вернул true. Приоритетнее `cellTooltip`.\n */\n errorCellTooltip?: (row: R) => CanvasNodeTooltipConfig | null | undefined;\n renderHeaderCell?: (cellInfo: HeaderCellInfo<R, SR>) => CanvasContent;\n /** Текстовое представление ячейки для копирования в clipboard (Ctrl+C). */\n copyData?: string | ((row: R) => string);\n editable?: boolean | ((row: R) => boolean);\n contentAlign?: 'right' | 'left' | 'center';\n renderCell?: ColumnGlideGetCellContent<R, SR>;\n renderEditCell?: (cellInfo: EditingCellInfoGlide<R, SR>) => CellContent;\n renderSummaryCell?: (summaryCellInfo: SummaryCellInfo<R, SR>) => CellContent;\n colSpan?: ColSpan<R, SR>;\n rowSpan?: RowSpan<R, SR>;\n /** Выравнивание контента в объединённых ячейках колонки; функция — если нужно задавать для каждого блока отдельно. */\n spanAlign?: SpanCellAlign | ((cellInfo: CellInfo<R, SR>) => SpanCellAlign | undefined);\n /** Тултип для ячеек этой колонки. Строка, объект или функция (context) => config | null. */\n cellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n row: R;\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n rowInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /** Тултип для шапки этой колонки. Строка, объект или функция (context) => config | null. */\n headerCellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /**\n * Свой цвет ячеек колонки (тема ячейки).\n *\n * Цвет лучше брать из темы (`cellInfo.theme`), например статусные\n * `theme.bgCellPositive / bgCellNegative / bgCellWarning / bgCellInfo`:\n * они свои для каждой темы. Фиксированный hex в тёмной теме останется\n * таким же светлым, как в светлой.\n *\n * Подробнее. Если вернуть `bgCell` hex-цветом (`#RGB`, `#RRGGBB`,\n * `#RRGGBBAA` — прозрачный цвет сначала смешивается с фоном ячейки),\n * таблица сама посчитает его состояния (под курсором, в выбранной строке,\n * в выделении) — цвет ведёт себя как встроенные. Не-hex значение\n * (`rgba()`, `var()` и т. п.) применяется как есть, без состояний: ячейка\n * не отреагирует на курсор и выделение.\n */\n columnThemeOverride?: (\n cellInfo: CellInfo<R, SR>\n ) => CellThemeOverrideResult | undefined;\n /** Управление preview для колонки. true — включить overlay, 'none' — отключить (в т.ч. стандартный). */\n hasPreview?: boolean | 'none';\n /**\n * Минимальная ширина колонки в пикселях. Уже этого значения колонку нельзя\n * сжать ни мышью, ни автоматическим расчётом ширины.\n *\n * Подробнее: у каждой колонки есть ещё минимум по содержимому шапки\n * (отступы ячейки, иконки пина и перетаскивания, буква с многоточием,\n * кнопки фильтра и сортировки), он считается в calculateMinColumnWidth.\n * Итоговый минимум это большее из двух, поэтому значение меньше\n * автоматического не действует.\n */\n minWidth?: number;\n /** Максимальная ширина колонки (px). Ограничивает ресайз и начальную ширину сверху. */\n maxWidth?: number;\n};",
53100
53960
  "internal": true,
53101
53961
  "importNotice": "Тип \"ColumnGlideCustoms\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
53102
53962
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
@@ -53500,34 +54360,20 @@
53500
54360
  "importStatement": "import { SIZE } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53501
54361
  "sourceFile": "packages/ui-kit/src/components/TableGlide/constants.ts"
53502
54362
  },
53503
- "Table.Prettify": {
54363
+ "Prettify": {
53504
54364
  "name": "Prettify",
53505
54365
  "definition": "export type Prettify<T> = {\n [K in keyof T]: T[K];\n // eslint-disable-next-line @typescript-eslint/ban-types\n} & {};",
53506
54366
  "importPath": "@sber-digital-finance-ui/ui-kit",
53507
54367
  "importStatement": "import { Prettify } from '@sber-digital-finance-ui/ui-kit';",
53508
54368
  "sourceFile": "packages/ui-kit/src/components/Table/types/utils.type.ts"
53509
54369
  },
53510
- "TableCanvas.Prettify": {
53511
- "name": "Prettify",
53512
- "definition": "export type Prettify<T> = {\n [K in keyof T]: T[K];\n // eslint-disable-next-line @typescript-eslint/ban-types\n} & {};",
53513
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53514
- "importStatement": "import { Prettify } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53515
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/utils.type.ts"
53516
- },
53517
- "Table.TableConfig": {
54370
+ "TableConfig": {
53518
54371
  "name": "TableConfig",
53519
54372
  "definition": "export type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Тип выделения активной (кликнутой) сущности `'cell' | 'row'`\n * @default 'cell'\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@sber-digital-finance-ui/ui-kit';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n } & 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 * subRows - активация иерархии, отображения вложенных строк. Условие активации - наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={subRows: {getSubRows, rowKeyGetter}}\n *\n * columnConfig=[{subRow: {...}}]\n */\n subRows?: SubRows<RowType, RowIdType>;\n rowsGrouping?: RowsGrouping<RowType>;\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 * infinityScroll - бесконечная подгрузка данных при скролле.\n *\n * Условие активации - наличие самого пропса infinityScroll.\n *\n * При активации infinityScroll отключается дефолтная сортировка и фильтрация.\n * (Предполагается, что если есть infinityScroll,\n * то в таблице представлен не весь объем данных,\n * по этой причине дефолтная сортировка и фильтрация не подходят и будут отображать некорректные данные)\n *\n */\n infinityScroll?: {\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n isLoading: boolean;\n /**\n * @default true\n */\n hasMore?: boolean;\n /**\n * @default 100 (px)\n */\n scrollThreshold?: number;\n };\n /**\n * @isLoading - состояние загрузки данных для таблицы.\n */\n isLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n /**\n * loadingOverlay - конфигурация для отображения оверлея загрузки.\n * Показывает индикатор загрузки поверх таблицы с возможностью кастомизации.\n */\n loadingOverlay?: {\n /**\n * Активен ли оверлей з…",
53520
54373
  "importPath": "@sber-digital-finance-ui/ui-kit",
53521
54374
  "importStatement": "import { TableConfig } from '@sber-digital-finance-ui/ui-kit';",
53522
54375
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
53523
54376
  },
53524
- "TableCanvas.TableConfig": {
53525
- "name": "TableConfig",
53526
- "definition": "export type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * Готовые варианты внешнего вида таблицы.\n *\n * `variant: 'clean'` — без линий сетки и внешних рамок, шапка на белом фоне\n * с серым текстом. Отдельные линии можно вернуть через `borders`.\n *\n * `zebra: true` — строки через одну окрашены серым, работает в любом варианте.\n */\n appearance?: AppearanceConfig;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@sber-digital-finance-ui/ui-kit';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элемент…",
53527
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53528
- "importStatement": "import { TableConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53529
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
53530
- },
53531
54377
  "SwitchProps": {
53532
54378
  "name": "SwitchProps",
53533
54379
  "definition": "export type SwitchProps = BaseSwitchProps;",
@@ -53556,12 +54402,40 @@
53556
54402
  "importNotice": "Тип \"CustomCellStyleNumberFormatProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
53557
54403
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-edit/types.ts"
53558
54404
  },
53559
- "TableProps": {
53560
- "name": "TableProps",
53561
- "definition": "export type TableProps<\n FilterStateType extends ObjectForExtending,\n RowIdType extends string | number,\n HeaderContextValueType extends ObjectForExtending,\n RowContextValueType extends ObjectForExtending,\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n> = {\n /**\n * columnConfig - Конфигурация колонок.\n *\n * (рекомендуется минимальное количество зависимостей для данной сущности - в идеале, чтобы не пересоздавался)\n */\n columnConfig: readonly ColumnConfig<RowType, SummaryRowType>[];\n /**\n * rows - данные для таблицы. ```RowType extends Record<string | number, any>```\n */\n rows: RowType[];\n /**\n * topSummaryRows - данные для итоговой строки в верхней части таблицы. ```SummaryRowType[]```\n * topSummaryRows?: SummaryRowType[];\n */\n /**\n * bottomSummaryRows - данные для итоговой строки в нижней части таблицы. ```SummaryRowType[]```\n */\n bottomSummaryRows?: SummaryRowType[];\n /**\n * tableConfig - Конфигурация фичей таблицы (их активация и отключение)\n */\n tableConfig?: Prettify<\n TableConfig<RowType, SummaryRowType, RowIdType, FilterStateType>\n >;\n /**\n * headerContextValue: любые стейты, которые нужны в headerCell - кладем в headerContextValue. И получаем доступ с помощью cellInfo.ctxs из args.\n */\n headerContextValue?: HeaderContextValueType;\n /**\n * rowContextValue: любые стейты, которые нужны в cell - кладем в rowContextValue. И получаем доступ с помощью cellInfo.ctxs из args.\n */\n rowContextValue?: RowContextValueType;\n refTable?: Ref<DataEditorRef>;\n refTableContainer?: React.Ref<HTMLDivElement>;\n};",
54405
+ "TableCanvasLoggerCounts": {
54406
+ "name": "TableCanvasLoggerCounts",
54407
+ "definition": "export type TableCanvasLoggerCounts = Partial<\n Record<TableCanvasLoggerStatus, number>\n>;",
53562
54408
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53563
- "importStatement": "import { TableProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53564
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table.type.ts"
54409
+ "importStatement": "import { TableCanvasLoggerCounts } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54410
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
54411
+ },
54412
+ "TableCanvasLoggerFilterValue": {
54413
+ "name": "TableCanvasLoggerFilterValue",
54414
+ "definition": "export type TableCanvasLoggerFilterValue = 'all' | TableCanvasLoggerStatus;",
54415
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54416
+ "importStatement": "import { TableCanvasLoggerFilterValue } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54417
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
54418
+ },
54419
+ "TableCanvasLoggerListProps": {
54420
+ "name": "TableCanvasLoggerListProps",
54421
+ "definition": "export type TableCanvasLoggerListProps = TableCanvasLoggerRenderProps & {\n items?: TableCanvasLoggerItem[] | null;\n /** Раскрытые id: сообщений (подробности) и групп */\n expandedIds?: string[];\n defaultExpandedIds?: string[];\n onExpandedIdsChange?: (ids: string[]) => void;\n /** Текущий фильтр. Применяется к списку и счётчикам */\n filter?: TableCanvasLoggerFilterValue;\n /** Контент пустого списка */\n emptyContent?: ReactNode;\n /** Максимальная высота списка. По умолчанию не ограничена: логгер занимает высоту родителя, а список прокручивается */\n maxHeight?: number | string;\n className?: string;\n $css?: TableCanvasLoggerCssProp;\n};",
54422
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54423
+ "importStatement": "import { TableCanvasLoggerListProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54424
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
54425
+ },
54426
+ "TableCanvasLoggerRenderProps": {
54427
+ "name": "TableCanvasLoggerRenderProps",
54428
+ "definition": "export type TableCanvasLoggerRenderProps = {\n /** Замена иконок статусов */\n statusIcons?: Partial<Record<TableCanvasLoggerStatus, ReactNode>>;\n /** Полная замена сообщения */\n renderMessage?: (ctx: TableCanvasLoggerMessageRenderContext) => ReactNode;\n /** Полная замена группы */\n renderGroup?: (ctx: TableCanvasLoggerGroupRenderContext) => ReactNode;\n /** Замена блока подробностей */\n renderDescription?: (item: TableCanvasLoggerMessageItem) => ReactNode;\n /** Замена строки действий. Получает стандартные кнопки вторым аргументом */\n renderActions?: (\n item: TableCanvasLoggerMessageItem,\n defaultActions: ReactNode,\n ) => ReactNode;\n /** Дополнительный контент справа от заголовка сообщения */\n renderMessageExtra?: (item: TableCanvasLoggerMessageItem) => ReactNode;\n /** Формат даты. Вернуть null, чтобы скрыть дату */\n formatDate?: (\n date: NonNullable<TableCanvasLoggerMessageItem['date']>,\n item: TableCanvasLoggerMessageItem,\n ) => string | null;\n labels?: Partial<TableCanvasLoggerLabels>;\n classes?: TableCanvasLoggerClasses;\n /** Вызывается после копирования. Если задан `copyToClipboard`, он заменяет стандартное копирование */\n onCopy?: (\n kind: TableCanvasLoggerCopyKind,\n value: string,\n item: TableCanvasLoggerMessageItem,\n ) => void;\n /** Своё копирование. Вернуть `false` или выбросить ошибку, если скопировать не удалось */\n copyToClipboard?: (value: string) => Promise<boolean | void> | boolean | void;\n /** Вызывается при клике на кнопку с кодом сообщения */\n onCodeClick?: (code: string, item: TableCanvasLoggerMessageItem) => void;\n};",
54429
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54430
+ "importStatement": "import { TableCanvasLoggerRenderProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54431
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
54432
+ },
54433
+ "TableCanvasLoggerCssProp": {
54434
+ "name": "TableCanvasLoggerCssProp",
54435
+ "definition": "export type TableCanvasLoggerCssProp =\n | string\n | CSSObject\n | FlattenSimpleInterpolation;",
54436
+ "internal": true,
54437
+ "importNotice": "Тип \"TableCanvasLoggerCssProp\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54438
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
53565
54439
  },
53566
54440
  "TableGlideProps": {
53567
54441
  "name": "TableGlideProps",
@@ -53670,7 +54544,7 @@
53670
54544
  },
53671
54545
  "TableGlideCustomProps": {
53672
54546
  "name": "TableGlideCustomProps",
53673
- "definition": "export type TableGlideCustomProps<\n R extends ObjectForExtending,\n SR = unknown\n> = {\n columns: ColumnGlideLast<R, SR>[];\n rows: readonly R[];\n bottomSummaryRows?: readonly SR[];\n rowSize?: SIZE;\n rowHeight?:\n | ((\n row: R,\n currentRowSize: {\n rowSizeName: SIZE;\n rowSizeValue: number;\n },\n rowIndex: number\n ) => number)\n | number\n | undefined\n | null;\n ctxs?: ObjectForExtending;\n renderGroupHeader?: (\n args: RenderGroupHeaderArgs\n ) => 'default' | { defaultWithCustomGroupName: string } | CanvasEl;\n /** Выравнивание текста в объединённой шапке по ключу группы (ColumnGroupConfig.key). */\n groupAlignMap?: Map<string, SpanAlignment>;\n refTable?: Ref<DataEditorRef>;\n onColumnsReorder?: (sourceKey: string, targetKey: string) => void;\n /** Ref на контейнер таблицы — события portal hover диспатчатся на него, чтобы несколько таблиц не перехватывали чужие тултипы */\n portalEventTargetRef?: RefObject<HTMLElement | null>;\n /** Откреплённая шапка — header уезжает вместе со скроллом */\n unstickyHeader?: boolean;\n // отключает resize колонок (по умолчанию true)\n resizableColumn?: boolean;\n /** Внешний ref на wrapper-div (для TableCanvas - refTableContainer) */\n containerRef?: Ref<HTMLDivElement>;\n /** className для wrapper-div */\n containerClassName?: string;\n /** inline-style для wrapper-div */\n containerStyle?: CSSProperties;\n /** Рендер overlay-фич (tooltip, contextMenu, popover) внутри wrapper-div когда DOM готов */\n renderOverlayFeatures?: (ctx: {\n containerElement: HTMLDivElement;\n renderInContainer: (children: ReactNode) => ReactPortal | null;\n }) => ReactNode;\n /** Не рендерить canvas-grid, оставив только overlay-content внутри wrapper. */\n hideGrid?: boolean;\n /** DOM-узел content-state (empty/error), рендерится как прямой child контейнера. */\n contentStateNode?: ReactNode;\n /** Дополнительный контент wrapper-div, не зависящий от готовности canvas-grid. */\n containerSlot?: ReactNode;\n /** Флаг fullscreen - пересканирование DOM при переключении */\n fullScreened?: boolean;\n /** Переносит editor overlay внутрь контейнера (вместо document.body). Для модалок с CSS transform. */\n editorOverlayPortal?: 'inside';\n groupHeaderHeight?: number[];\n /** Управляет canvas-подсветкой активной сущности поверх glide selection. */\n highlightActiveType?: HighlightActiveType;\n /** Режим выделения ячеек (нативный glide selection). По умолчанию 'range-cell'. */\n cellsSelectionMode?: CellsSelectionMode;\n /** Канал для copy/paste (selectionRef потребителя), отдельно от controlled gridSelection. */\n onSelectionEmit?: (selection: GridSelection) => void;\n /**\n * Ключи выделенных КОЛОНОК (объединение: одиночный клик/Shift/select-all +\n * Ctrl-мультивыбор), без сервисных колонок. Канал наверх для контрл-блока\n * (например «Закрепить столбцы»). Обычное выделение ячеек сюда не попадает.\n */\n onColumnSelectionChange?: (selectedColumnKeys: string[]) => void;\n /**\n * Follow-выделение: после реордера (закрепление колонок) заново выделить эти\n * ключи. Пустой массив → снять выделение. null/undefined → не трогать.\n */\n pendingColumnSelectionKeys?: string[] | null;\n /** Вызывается после применения pendingColumnSelectionKeys (сброс pending). */\n onColumnSelectionApplied?: () => void;\n /** Controlled-значение подсвеченной строки (highlightActiveType='row'). */\n highlightActiveRow?: number;\n /**\n * Controlled-сеттер подсвеченной строки. Вторым аргументом отдаёт сам объект\n * строки (`rows[index]`) — чтобы потребитель получал узел без onCellClicked.\n */\n onHighlightActiveRowChange?: (\n row: number | undefined,\n rowData?: R | undefined\n ) => void;\n /**\n * Режим подсветки строки controlled (значением владеют снаружи). Если не\n * задан — таблица крутит подсветку внутренним стейтом, но колбэк всё равно\n * вызывается (подписка без владения).\n */\n highlightActiveRowControlled?: boolean;\n /** Выделение колонок по клику на шапку (независимо от highlightActiveType). По умолчанию true. */\n enableColumnSelection?: boolean;\n /** Выделение строк по клику/драгу на колонке нумерации. По умолчанию true. */\n enableRowSelection?: boolean;\n /** Выделение всей таблицы кликом по шапке колонки нумерации. По умолчанию true. */\n enableSelectAll?: boolean;\n /** Индексы строк, выбранных через checkbox selection. */\n checkboxSelectedRowIndexes?: ReadonlySet<number>;\n /**\n * Индексы строк, у которых ЕСТЬ (виден) чекбокс.\n * @deprecated На цвет не влияет: наличие чекбокса не меняет цвет выбранной\n * строки, ступень добавляет только НАЖАТЫЙ чекбокс\n * (`checkboxSelectedRowIndexes`). Удалить в следующем мажоре.\n */\n checkboxVisibleRowIndexes?: ReadonlySet<number>;\n /**\n * Эффекты при наведении. `hoverEffects.row` — подсветка строки под курсором:\n * рисуется через bgCell (getRowThemeOverride), т.е. лежит ПОД селектингом и\n * highlightActiveType — они рисуются поверх (highlightRegions) и визуально\n * перекрывают hover. По умолчанию row-подсветка ВКЛЮЧЕНА; выключение —\n * явное `{ row: false }`.\n */\n hoverEffects?: HoverEffectsConfig;\n /** Внешний вид: «чистый» вариант и зебра. См. {@link AppearanceConfig}. */\n appearance?: AppearanceConfig;\n /** Включает компенсацию тонких canvas-линий при browser zoom ниже 100% / DPR < 1. */\n enableLowDprHairline?: boolean;\n};",
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?:\n | ((\n row: R,\n currentRowSize: {\n rowSizeName: SIZE;\n rowSizeValue: number;\n },\n rowIndex: number\n ) => number)\n | number\n | undefined\n | null;\n ctxs?: ObjectForExtending;\n renderGroupHeader?: (\n args: RenderGroupHeaderArgs\n ) => 'default' | { defaultWithCustomGroupName: string } | CanvasEl;\n /** Выравнивание текста в объединённой шапке по ключу группы (ColumnGroupConfig.key). */\n groupAlignMap?: Map<string, SpanAlignment>;\n refTable?: Ref<DataEditorRef>;\n onColumnsReorder?: (sourceKey: string, targetKey: string) => void;\n /** Ref на контейнер таблицы — события portal hover диспатчатся на него, чтобы несколько таблиц не перехватывали чужие тултипы */\n portalEventTargetRef?: RefObject<HTMLElement | null>;\n /** Откреплённая шапка — header уезжает вместе со скроллом */\n unstickyHeader?: boolean;\n // отключает resize колонок (по умолчанию true)\n resizableColumn?: boolean;\n /** Внешний ref на wrapper-div (для TableCanvas - refTableContainer) */\n containerRef?: Ref<HTMLDivElement>;\n /** className для wrapper-div */\n containerClassName?: string;\n /** inline-style для wrapper-div */\n containerStyle?: CSSProperties;\n /** Рендер overlay-фич (tooltip, contextMenu, popover) внутри wrapper-div когда DOM готов */\n renderOverlayFeatures?: (ctx: {\n containerElement: HTMLDivElement;\n renderInContainer: (children: ReactNode) => ReactPortal | null;\n }) => ReactNode;\n /** Не рендерить canvas-grid, оставив только overlay-content внутри wrapper. */\n hideGrid?: boolean;\n /** DOM-узел content-state (empty/error), рендерится как прямой child контейнера. */\n contentStateNode?: ReactNode;\n /** Дополнительный контент wrapper-div, не зависящий от готовности canvas-grid. */\n containerSlot?: ReactNode;\n /** Флаг fullscreen - пересканирование DOM при переключении */\n fullScreened?: boolean;\n /** Переносит editor overlay внутрь контейнера (вместо document.body). Для модалок с CSS transform. */\n editorOverlayPortal?: 'inside';\n groupHeaderHeight?: number[];\n /** Управляет canvas-подсветкой активной сущности поверх glide selection. */\n highlightActiveType?: HighlightActiveType;\n /** Режим выделения ячеек (нативный glide selection). По умолчанию 'range-cell'. */\n cellsSelectionMode?: CellsSelectionMode;\n /** Канал для copy/paste (selectionRef потребителя), отдельно от controlled gridSelection. */\n onSelectionEmit?: (selection: GridSelection) => void;\n /**\n * Ключи выделенных КОЛОНОК (объединение: одиночный клик/Shift/select-all +\n * Ctrl-мультивыбор), без сервисных колонок. Канал наверх для контрл-блока\n * (например «Закрепить столбцы»). Обычное выделение ячеек сюда не попадает.\n */\n onColumnSelectionChange?: (selectedColumnKeys: string[]) => void;\n /**\n * Follow-выделение: после реордера (закрепление колонок) заново выделить эти\n * ключи. Пустой массив → снять выделение. null/undefined → не трогать.\n */\n pendingColumnSelectionKeys?: string[] | null;\n /** Вызывается после применения pendingColumnSelectionKeys (сброс pending). */\n onColumnSelectionApplied?: () => void;\n /** Controlled-значение подсвеченной строки (highlightActiveType='row'). */\n highlightActiveRow?: number;\n /**\n * Controlled-сеттер подсвеченной строки. Вторым аргументом отдаёт сам объект\n * строки (`rows[index]`) — чтобы потребитель получал узел без onCellClicked.\n */\n onHighlightActiveRowChange?: (\n row: number | undefined,\n rowData?: R | undefined\n ) => void;\n /**\n * Режим подсветки строки controlled (значением владеют снаружи). Если не\n * задан — таблица крутит подсветку внутренним стейтом, но колбэк всё равно\n * вызывается (подписка без владения).\n */\n highlightActiveRowControlled?: boolean;\n /** Выделение колонок по клику на шапку (независимо от highlightActiveType). По умолчанию true. */\n enableColumnSelection?: boolean;\n /** Выделение строк по клику/драгу на колонке нумерации. По умолчанию true. */\n enableRowSelection?: boolean;\n /** Выделение всей таблицы кликом по шапке колонки нумерации. По умолчанию true. */\n enableSelectAll?: boolean;\n /** Индексы строк, выбранных через checkbox selection. */\n checkboxSelectedRowIndexes?: ReadonlySet<number>;\n /**\n * Индексы строк, у которых ЕСТЬ (виден) чекбокс.\n * @deprecated На цвет не влияет: наличие чекбокса не меняет цвет выбранной\n * строки, ступень добавляет только НАЖАТЫЙ чекбокс\n * (`checkboxSelectedRowIndexes`). Удалить в следующем мажоре.\n */\n checkboxVisibleRowIndexes?: ReadonlySet<number>;\n /**\n * Эффекты при наведении. `hoverEffects.row` — подсветка строки под курсором:\n * рисуется через bgCell (getRowThemeOverride), т.е. лежит ПОД селектингом и\n * highlightActiveType — они рисуются поверх (highlightRegions) и визуально\n * перекрывают hover. По умолчанию row-подсветка ВКЛЮЧЕНА; выключение —\n * явное `{ row: false }`.\n */\n hoverEffects?: HoverEffectsConfig;\n /** Внешний вид: «чистый» вариант и зебра. См. {@link AppearanceConfig}. */\n appearance?: AppearanceConfig;\n /** Включает компенсацию тонких canvas-линий при browser zoom ниже 100% / DPR < 1. */\n enableLowDprHairline?: boolean;\n /**\n * Ошибка всей строки: одна красная рамка по всей ширине данных вместо\n * поячеечных рамок этой строки. Проверяется только для строк в окне\n * видимости, как и `isErrorCell`.\n */\n isErrorRow?: (row: R) => boolean;\n /**\n * Собирать сводку ошибок по строкам окна видимости ({@link RowErrorsSummary}\n * в `cellInfo.rowErrors`). Для сводки колонки с `isErrorCell` обходятся все,\n * а не только видимые, поэтому включается только когда сводка кому-то нужна\n * (столбец-индикатор ошибок).\n */\n collectRowErrors?: boolean;\n};",
53674
54548
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
53675
54549
  "importStatement": "import { TableGlideCustomProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
53676
54550
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
@@ -54116,20 +54990,13 @@
54116
54990
  "importNotice": "Тип \"ColumnDefault\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54117
54991
  "sourceFile": "packages/ui-kit/src/components/Table/types/data-grid.type.ts"
54118
54992
  },
54119
- "Table.DefaultOmittedKeys": {
54993
+ "DefaultOmittedKeys": {
54120
54994
  "name": "DefaultOmittedKeys",
54121
54995
  "definition": "export type DefaultOmittedKeys =\n | 'editable'\n | 'sortable'\n | 'sortDescendingFirst'\n | 'renderGroupCell'\n | 'renderEditCell'\n | 'frozen'\n | 'draggable';",
54122
54996
  "internal": true,
54123
54997
  "importNotice": "Тип \"DefaultOmittedKeys\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54124
54998
  "sourceFile": "packages/ui-kit/src/components/Table/types/data-grid.type.ts"
54125
54999
  },
54126
- "TableCanvas.DefaultOmittedKeys": {
54127
- "name": "DefaultOmittedKeys",
54128
- "definition": "export type DefaultOmittedKeys = Extract<\n keyof ColumnGlideInstance<ObjectForExtending, unknown, ObjectForExtending>,\n | 'editable'\n | 'frozen'\n | 'isServiceColumn'\n | 'isErrorCell'\n | 'renderEditCell'\n | 'renderCellPreview'\n | 'renderCell'\n | 'columnThemeOverride'\n // Объединение ячеек тела задаётся только через tableConfig.mergeCells\n // (mergeByCellValues / mergedCellsRegions). Колоночные colSpan/rowSpan убраны:\n // они позиционные и небезопасны при реордере. Внутри (ColumnConfigInternal)\n // остаются как труба, в которую mergeCells синтезирует объединения.\n | 'colSpan'\n | 'rowSpan'\n // Выравнивание блока публично задаётся через mergedCellsAlign / mergeCells.align.\n | 'spanAlign'\n>;",
54129
- "internal": true,
54130
- "importNotice": "Тип \"DefaultOmittedKeys\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54131
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/glide-type.ts"
54132
- },
54133
55000
  "Table.HeaderContextValueTypeInstance": {
54134
55001
  "name": "HeaderContextValueTypeInstance",
54135
55002
  "definition": "export type HeaderContextValueTypeInstance<\n FilterStateType extends Record<string | number, unknown>,\n> = {\n filters: FilterStateType | undefined;\n setFilters: React.Dispatch<React.SetStateAction<FilterStateType>> | undefined;\n clearedFiltersValue: FilterStateType | undefined;\n sortState: readonly SortColumn[] | undefined;\n setSortState:\n | React.Dispatch<React.SetStateAction<readonly SortColumn[]>>\n | undefined;\n sortIsVisible: boolean;\n setSortIsVisible: React.Dispatch<React.SetStateAction<boolean>>;\n\n rowSize: SIZE;\n setRowSize: React.Dispatch<React.SetStateAction<SIZE>>;\n onRowSizeChange?: (size: SIZE) => void;\n\n isExpandedAllRows: boolean;\n toggleExpandAllButton: () => void;\n activeView: ActiveViewModsType;\n setActiveView: React.Dispatch<React.SetStateAction<ActiveViewModsType>>;\n};",
@@ -54144,48 +55011,27 @@
54144
55011
  "importNotice": "Тип \"HeaderContextValueTypeInstance\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54145
55012
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/contexts.tsx"
54146
55013
  },
54147
- "Table.FiltersVariables": {
55014
+ "FiltersVariables": {
54148
55015
  "name": "FiltersVariables",
54149
55016
  "definition": "export type FiltersVariables = {\n filtersAreVisible: boolean;\n toggleFiltersAreVisible: () => void;\n};",
54150
55017
  "internal": true,
54151
55018
  "importNotice": "Тип \"FiltersVariables\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54152
55019
  "sourceFile": "packages/ui-kit/src/components/Table/feature-filtering/filtering.type.ts"
54153
55020
  },
54154
- "TableCanvas.FiltersVariables": {
54155
- "name": "FiltersVariables",
54156
- "definition": "export type FiltersVariables = {\n filtersAreVisible: boolean;\n toggleFiltersAreVisible: () => void;\n};",
54157
- "internal": true,
54158
- "importNotice": "Тип \"FiltersVariables\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54159
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-filtering/filtering.type.ts"
54160
- },
54161
- "Table.CustomFormat": {
55021
+ "CustomFormat": {
54162
55022
  "name": "CustomFormat",
54163
55023
  "definition": "export type CustomFormat = CommonFormat & {\n customFormat: (value: string) => React.ReactNode;\n};",
54164
55024
  "importPath": "@sber-digital-finance-ui/ui-kit",
54165
55025
  "importStatement": "import { CustomFormat } from '@sber-digital-finance-ui/ui-kit';",
54166
55026
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
54167
55027
  },
54168
- "TableCanvas.CustomFormat": {
54169
- "name": "CustomFormat",
54170
- "definition": "export type CustomFormat = CommonFormat & {\n customFormat: (value: string) => React.ReactNode;\n};",
54171
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54172
- "importStatement": "import { CustomFormat } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54173
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
54174
- },
54175
- "Table.NumberFormatOptions": {
55028
+ "NumberFormatOptions": {
54176
55029
  "name": "NumberFormatOptions",
54177
55030
  "definition": "export type NumberFormatOptions = CommonFormat & {\n type: 'number';\n /** Кастомный разделитель дробной части (по умолчанию ',') */\n decimalSeparator?: string;\n /** Кастомный разделитель тысяч (по умолчанию ' ') */\n thousandSeparator?: string;\n /** Минимальное число знаков после запятой (по умолчанию 0) */\n minimumFractionDigits?: number;\n /** Максимальное число знаков после запятой (по умолчанию 2) */\n maximumFractionDigits?: number;\n /** Включить/отключить группировку разрядов (по умолчанию true) */\n useGrouping?: boolean;\n /** Локаль для Intl.NumberFormat (по умолчанию 'ru-RU') */\n locales?: string | string[];\n alignContent?: 'right' | 'left' | 'center';\n};",
54178
55031
  "importPath": "@sber-digital-finance-ui/ui-kit",
54179
55032
  "importStatement": "import { NumberFormatOptions } from '@sber-digital-finance-ui/ui-kit';",
54180
55033
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
54181
55034
  },
54182
- "TableCanvas.NumberFormatOptions": {
54183
- "name": "NumberFormatOptions",
54184
- "definition": "export type NumberFormatOptions = CommonFormat & {\n type: 'number';\n /** Кастомный разделитель дробной части (по умолчанию ',') */\n decimalSeparator?: string;\n /** Кастомный разделитель тысяч (по умолчанию ' ') */\n thousandSeparator?: string;\n /** Минимальное число знаков после запятой (по умолчанию 0) */\n minimumFractionDigits?: number;\n /** Максимальное число знаков после запятой (по умолчанию 2) */\n maximumFractionDigits?: number;\n /** Включить/отключить группировку разрядов (по умолчанию true) */\n useGrouping?: boolean;\n /** Локаль для Intl.NumberFormat (по умолчанию 'ru-RU') */\n locales?: string | string[];\n alignContent?: 'right' | 'left' | 'center';\n};",
54185
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54186
- "importStatement": "import { NumberFormatOptions } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54187
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
54188
- },
54189
55035
  "RenderSubRowEditCell": {
54190
55036
  "name": "RenderSubRowEditCell",
54191
55037
  "definition": "export type RenderSubRowEditCell<SubRowType extends ObjectForExtending> = (\n renderCellProps: RenderEditCellProps<SubRowType>,\n lvl: number,\n) => ReactNode;",
@@ -54193,75 +55039,19 @@
54193
55039
  "importStatement": "import { RenderSubRowEditCell } from '@sber-digital-finance-ui/ui-kit';",
54194
55040
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
54195
55041
  },
54196
- "Table.RenderGroupCellProps": {
55042
+ "RenderGroupCellProps": {
54197
55043
  "name": "RenderGroupCellProps",
54198
55044
  "definition": "export type RenderGroupCellProps<RowType, SummaryRowType = unknown> = {\n column: CalculatedColumn<RowType, SummaryRowType>;\n tabIndex: number;\n // TODO isExpanded: boolean;\n // TODO toggleGroup: () => void;\n} & GroupRow<RowType>;",
54199
55045
  "internal": true,
54200
55046
  "importNotice": "Тип \"RenderGroupCellProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54201
55047
  "sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
54202
55048
  },
54203
- "TableCanvas.RenderGroupCellProps": {
54204
- "name": "RenderGroupCellProps",
54205
- "definition": "export 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>;",
54206
- "internal": true,
54207
- "importNotice": "Тип \"RenderGroupCellProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54208
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
54209
- },
54210
- "CellHoverState": {
54211
- "name": "CellHoverState",
54212
- "definition": "export type CellHoverState = {\n /** Равно true только для ячейки с данными, над которой сейчас находится курсор. */\n cellHover: boolean;\n /** Равно true для всех ячеек с данными в строке, над которой сейчас находится курсор. */\n rowHover: boolean;\n};",
54213
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54214
- "importStatement": "import { CellHoverState } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54215
- "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
54216
- },
54217
- "CellActiveState": {
54218
- "name": "CellActiveState",
54219
- "definition": "export type CellActiveState = {\n /** Равно true, если текущая ячейка с данными входит в активную область выделения таблицы. */\n cellActive: boolean;\n /** Равно true, если строка текущей ячейки с данными содержит активную ячейку или активный диапазон. */\n rowActive: boolean;\n};",
54220
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54221
- "importStatement": "import { CellActiveState } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54222
- "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
54223
- },
54224
- "PreviewCellInfo": {
54225
- "name": "PreviewCellInfo",
54226
- "definition": "export type PreviewCellInfo<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = Omit<PreviewCellInfoGlideInstance<R, SR, CustomCtxs>, 'column'> & {\n column: ColumnConfig<R, SR, CustomCtxs>;\n};",
54227
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54228
- "importStatement": "import { PreviewCellInfo } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54229
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
54230
- },
54231
- "CellEditorTextAreaProps": {
54232
- "name": "CellEditorTextAreaProps",
54233
- "definition": "export type CellEditorTextAreaProps = Omit<\n ComponentProps<typeof TextCellEntry>,\n 'highlight'\n> & {\n autoFocusType?: 'autoFocus' | 'autoFocusAndSelect' | 'none';\n paddingInline: number;\n containerClassName?: string;\n} & CustomCellStyleProps;",
54234
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54235
- "importStatement": "import { CellEditorTextAreaProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54236
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-edit/types.ts"
54237
- },
54238
- "CellEditorNumberFormatProps": {
54239
- "name": "CellEditorNumberFormatProps",
54240
- "definition": "export type CellEditorNumberFormatProps = Omit<\n NumberFormatCompProps,\n 'view' | 'size'\n> &\n CustomCellStyleNumberFormatProps;",
54241
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54242
- "importStatement": "import { CellEditorNumberFormatProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54243
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-edit/types.ts"
54244
- },
54245
- "CellEditorComboboxProps": {
54246
- "name": "CellEditorComboboxProps",
54247
- "definition": "export type CellEditorComboboxProps<T extends ComboboxItemOption> =\n ComboboxCompProps<T> &\n CustomCellStyleProps & {\n autoFocusType: 'autoFocus' | 'none';\n paddingInline: number;\n };",
54248
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54249
- "importStatement": "import { CellEditorComboboxProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54250
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-edit/types.ts"
54251
- },
54252
- "RenderRowCustomEditCell": {
54253
- "name": "RenderRowCustomEditCell",
54254
- "definition": "export type RenderRowCustomEditCell<\n SubRowType extends ObjectForExtending,\n SummaryRowType = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = (\n renderCellProps: EditingCellInfo<SubRowType, SummaryRowType, CustomCtxs>,\n lvl: number,\n disableLeftOffset: boolean | undefined,\n) => ReactNode;",
55049
+ "CanvasNodeTooltipProps": {
55050
+ "name": "CanvasNodeTooltipProps",
55051
+ "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};",
54255
55052
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54256
- "importStatement": "import { RenderRowCustomEditCell } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54257
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
54258
- },
54259
- "LocalColumnInstance": {
54260
- "name": "LocalColumnInstance",
54261
- "definition": "type LocalColumnInstance = Record<'key' | 'name' | 'width' | string, unknown>;",
54262
- "internal": true,
54263
- "importNotice": "Тип \"LocalColumnInstance\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54264
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
55053
+ "importStatement": "import { CanvasNodeTooltipProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55054
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/utils/portalHoverEvents.ts"
54265
55055
  },
54266
55056
  "HeaderCellInfo": {
54267
55057
  "name": "HeaderCellInfo",
@@ -54270,6 +55060,13 @@
54270
55060
  "importNotice": "Тип \"HeaderCellInfo\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54271
55061
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
54272
55062
  },
55063
+ "CellInfo": {
55064
+ "name": "CellInfo",
55065
+ "definition": "export type CellInfo<R extends ObjectForExtending, SR = unknown> = {\n row: R;\n column: ColumnGlideLast<R, SR>;\n colInd: number;\n rowInd: number;\n ctxs: ObjectForExtending;\n theme: Theme;\n /** Состояние наведения для ячейки, которую сейчас рендерит renderCell. */\n hovered: CellHoverState;\n /** Состояние активного выделения для ячейки, которую сейчас рендерит renderCell. */\n active: CellActiveState;\n // Есть только у верхней-левой ячейки объединённого блока. align — выравнивание\n // блока (пусто = по центру). По нему ячейка-select расставляет контент и\n // уголок по высоте всего блока.\n __mergedCell?: { align?: SpanCellAlign };\n /** Сводка ошибок строки ({@link RowErrorsSummary}). Нет у строк без ошибок. */\n rowErrors?: RowErrorsSummary;\n};",
55066
+ "internal": true,
55067
+ "importNotice": "Тип \"CellInfo\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
55068
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
55069
+ },
54273
55070
  "SummaryCellInfo": {
54274
55071
  "name": "SummaryCellInfo",
54275
55072
  "definition": "export type SummaryCellInfo<R extends ObjectForExtending, SR> = {\n row: SR;\n column: ColumnGlideLast<R, SR>;\n colInd: number;\n rowInd: number;\n ctxs: ObjectForExtending;\n theme: Theme;\n};",
@@ -54277,13 +55074,6 @@
54277
55074
  "importNotice": "Тип \"SummaryCellInfo\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54278
55075
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
54279
55076
  },
54280
- "CanvasNodeTooltipProps": {
54281
- "name": "CanvasNodeTooltipProps",
54282
- "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};",
54283
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54284
- "importStatement": "import { CanvasNodeTooltipProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54285
- "sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/utils/portalHoverEvents.ts"
54286
- },
54287
55077
  "SelectingContextType": {
54288
55078
  "name": "SelectingContextType",
54289
55079
  "definition": "export type SelectingContextType<\n RowType extends ObjectForExtending = ObjectForExtending,\n RowIdType extends RowIdTypeInstance = RowIdTypeInstance,\n> = {\n rows: RowType[];\n selectingRowConfig: SelectingRowConfig<RowType, RowIdType> & {\n selectingRowsIsActive: boolean;\n };\n flattenedRowsArrAndMap: FlattenedRowsArrAndMap<RowType, RowIdType> | null;\n selectedRows: ReadonlySet<string | number> | undefined;\n setSelectedRows:\n | React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>\n | undefined;\n rowKeyGetter: undefined | ((row: RowType) => RowIdType);\n rowsGroupingIsActive: boolean;\n isRowsGroupingLabelVisible: boolean;\n setIsRowsGroupingLabelVisible: React.Dispatch<React.SetStateAction<boolean>>;\n isRowsGroupingCounterVisible: boolean;\n setIsRowsGroupingCounterVisible: React.Dispatch<\n React.SetStateAction<boolean>\n >;\n isSelectingRowLabelVisible: boolean;\n setIsSelectingRowLabelVisible: React.Dispatch<React.SetStateAction<boolean>>;\n isSelectingRowCounterVisible: boolean;\n setIsSelectingRowCounterVisible: React.Dispatch<\n React.SetStateAction<boolean>\n >;\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n};",
@@ -54452,76 +55242,41 @@
54452
55242
  "importStatement": "import { HighlightActiveType } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54453
55243
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
54454
55244
  },
54455
- "Table.RowSize": {
55245
+ "RowSize": {
54456
55246
  "name": "RowSize",
54457
55247
  "definition": "export 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};",
54458
55248
  "importPath": "@sber-digital-finance-ui/ui-kit",
54459
55249
  "importStatement": "import { RowSize } from '@sber-digital-finance-ui/ui-kit';",
54460
55250
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
54461
55251
  },
54462
- "TableCanvas.RowSize": {
54463
- "name": "RowSize",
54464
- "definition": "export 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};",
54465
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54466
- "importStatement": "import { RowSize } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54467
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
54468
- },
54469
- "Table.Maybe": {
55252
+ "Maybe": {
54470
55253
  "name": "Maybe",
54471
55254
  "definition": "export type Maybe<T> = T | undefined | null;",
54472
55255
  "importPath": "@sber-digital-finance-ui/ui-kit",
54473
55256
  "importStatement": "import { Maybe } from '@sber-digital-finance-ui/ui-kit';",
54474
55257
  "sourceFile": "packages/ui-kit/src/components/Table/types/utils.type.ts"
54475
55258
  },
54476
- "TableCanvas.Maybe": {
54477
- "name": "Maybe",
54478
- "definition": "export type Maybe<T> = T | undefined | null;",
54479
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54480
- "importStatement": "import { Maybe } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54481
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/utils.type.ts"
54482
- },
54483
- "Table.RowHeightFunc": {
55259
+ "RowHeightFunc": {
54484
55260
  "name": "RowHeightFunc",
54485
55261
  "definition": "export type RowHeightFunc<RowType> = (\n row: RowType,\n currentRowSize: { rowSizeName: SIZE; rowSizeValue: number },\n) => number;",
54486
55262
  "importPath": "@sber-digital-finance-ui/ui-kit",
54487
55263
  "importStatement": "import { RowHeightFunc } from '@sber-digital-finance-ui/ui-kit';",
54488
55264
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
54489
55265
  },
54490
- "TableCanvas.RowHeightFunc": {
54491
- "name": "RowHeightFunc",
54492
- "definition": "export type RowHeightFunc<RowType> = (\n row: RowType,\n currentRowSize: { rowSizeName: SIZE; rowSizeValue: number },\n rowIndex: number,\n) => number;",
54493
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54494
- "importStatement": "import { RowHeightFunc } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54495
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
54496
- },
54497
- "Table.View": {
55266
+ "View": {
54498
55267
  "name": "View",
54499
55268
  "definition": "export type View = ViewMods['rows' | 'bothTypes' | 'cards'];",
54500
55269
  "importPath": "@sber-digital-finance-ui/ui-kit",
54501
55270
  "importStatement": "import { View } from '@sber-digital-finance-ui/ui-kit';",
54502
55271
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
54503
55272
  },
54504
- "TableCanvas.View": {
54505
- "name": "View",
54506
- "definition": "export type View = ViewMods['rows' | 'bothTypes' | 'cards'];",
54507
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54508
- "importStatement": "import { View } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54509
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
54510
- },
54511
- "Table.FilteringConfig": {
55273
+ "FilteringConfig": {
54512
55274
  "name": "FilteringConfig",
54513
55275
  "definition": "export 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) => {…",
54514
55276
  "importPath": "@sber-digital-finance-ui/ui-kit",
54515
55277
  "importStatement": "import { FilteringConfig } from '@sber-digital-finance-ui/ui-kit';",
54516
55278
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
54517
55279
  },
54518
- "TableCanvas.FilteringConfig": {
54519
- "name": "FilteringConfig",
54520
- "definition": "export 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) => {…",
54521
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54522
- "importStatement": "import { FilteringConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54523
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
54524
- },
54525
55280
  "Table.SelectingRowConfig": {
54526
55281
  "name": "SelectingRowConfig",
54527
55282
  "definition": "export type SelectingRowConfig<\n RowType,\n RowIdType extends string | number = string | number,\n> = {\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * showDefault - состояние, отвечающее за то, видно ли по дефолту чекбоксы.\n */\n showDefault?: boolean;\n /**\n * showState - состояние, отвечающее за то, видны ли чекбоксы.\n */\n showState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * showInControl - состояние, отвечающее за то, добавлять ли выбор строк как фичу, которую можно скрывать и раскрывать в правой части контролблока.\n */\n showInControl?: boolean;\n /**\n * selectingRules - пропс, отвечающий за кастомизацию логики выбора строк.\n */\n selectingRules?: {\n /**\n * изменять ли скрытые строки при клике на чекбокс-ы родительских строк\n * @default true\n */\n // changeableOfRowWithoutCheckbox?: boolean;\n /**\n * изменять ли задизейбленные строки при клике на чекбокс-ы родительских строк\n * @default true\n */\n // changeableDisabledRow?: boolean;\n /**\n * levels - логика активации чекбоксов у строк с определенным уровнем вложенности.\n */\n levels?: number | 'all' | number[] | ((lvl: number) => boolean);\n };\n disableSummaryCheckboxInHeader?: boolean;\n hideSummaryCheckboxInHeader?: boolean;\n /**\n * hideSummaryCheckbox - в островке массовых действий\n */\n hideSummaryCheckbox?: boolean;\n /**\n * summaryCounterMaxCount - максимальное отображаемое число в счётчике выбранных\n * строк (в шапке и в панели массовых действий). Если выбрано больше — счётчик\n * показывает «N+» (например, при значении 99 и 5000 выбранных отобразится «99+»).\n * Не ограничивает само выделение, влияет только на отображение.\n */\n summaryCounterMaxCount?: number;\n /**\n * summaryChecked - пропс, отвечающий за логику состояния checked у итогового чекбокса в левой части контролблока.\n */\n summaryChecked?: {\n checked: boolean | SummaryCheckedFunc<RowType, boolean>;\n indeterminate:\n | boolean\n | SummaryCheckedFunc<RowType, boolean, { checkedAll: boolean }>;\n getCountOfChecked: SummaryCheckedFunc<RowType, number>;\n onChange: SummaryCheckedFunc<\n RowType,\n void,\n {\n checkedAll: boolean;\n clearButtonClicked?: boolean;\n setSelectedRowsIds: React.Dispatch<\n React.SetStateAction<ReadonlySet<string | number>>\n >;\n }\n >;\n };\n\n /**\n * summaryCheckedUncontrolled - пропс отвечающий за колбеки в неконтролируемом режиме\n */\n summaryCheckedUncontrolled?: {\n onChange: (event: ChangeEvent<HTMLInputElement>) => void;\n };\n\n /**\n * rowShowCheckbox - пропс, отвечающий за то, будет ли у конкретной строки отрендерен чекбокс.\n */\n rowShowCheckbox?: RowShowCheckbox<RowType>;\n /**\n * rowCheckboxDisabled - пропс, отвечающий за то, будет ли у конкретной строки чекбокс задизейблен.\n */\n rowCheckboxDisabled?: RowCheckboxDisabled<RowType>;\n\n /**\n * Функция для переопределения checked, indeterminate для каждой строки.\n * Что будет возвращено функцией в объекте, то будет переопределено.\n */\n rowGetStates?: (\n p: RowGetStatesProps<RowType, RowIdType>,\n ) => RowGetStatesReturnType<RowType, RowIdType> | null;\n\n groupedRow?: {\n /**\n * Функция для переопределения checked, indeterminate, showCheckbox, checkboxDisabled для группированных строк.\n * Что будет возвращено функцией в объекте, то будет переопределено.\n */\n getStates: (p: {\n checkedCalculated: boolean;\n indeterminateCalculated: boolean;\n row: GroupRow<RowType>;\n selectedRows: ReadonlySet<string | number>;\n selectedChildCount: number;\n childCount: number;\n }) => {\n checked?: boolean | null;\n indeterminate?: boolean | null;\n showCheckbox?: boolean | null;\n checkboxDisabled?: boolean | null;\n } | null;\n onChange?: (p: {\n row: GroupRow<RowType>;\n\n setSelectedRows: React.Dispatch<\n React.SetStateAction<ReadonlySet<string | number>>\n >;\n checked: boolean;\n indeterminate: boolean;\n checkboxDisabled: boolean;\n showCheckbox: boolean;\n defaultSetter: () => void;\n }) => void;\n };\n};",
@@ -54536,90 +55291,48 @@
54536
55291
  "importNotice": "Тип \"SelectingRowConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54537
55292
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-select-row/types.ts"
54538
55293
  },
54539
- "Table.EditingConfig": {
55294
+ "EditingConfig": {
54540
55295
  "name": "EditingConfig",
54541
55296
  "definition": "export type EditingConfig<RowType, RowIdType, SummaryRowType> = {\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 * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showToggleEnabledButton?: boolean;\n /**\n * Функция, вызывающаяся при включении/выключении фичи\n * @param editingIsActive\n * @returns\n */\n onToggleEnableEditing?: (editingIsActive: boolean) => void;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};",
54542
55297
  "importPath": "@sber-digital-finance-ui/ui-kit",
54543
55298
  "importStatement": "import { EditingConfig } from '@sber-digital-finance-ui/ui-kit';",
54544
55299
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
54545
55300
  },
54546
- "TableCanvas.EditingConfig": {
54547
- "name": "EditingConfig",
54548
- "definition": "export type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};",
54549
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54550
- "importStatement": "import { EditingConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54551
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
54552
- },
54553
- "Table.SubRows": {
55301
+ "SubRows": {
54554
55302
  "name": "SubRows",
54555
55303
  "definition": "export type SubRows<RowType, RowIdType> = {\n getSubRows: (row: RowType) => RowType[] | undefined;\n rowKeyGetter: (row: RowType) => RowIdType;\n expandedIdsState?: [\n Set<string | number>,\n (\n newV:\n | Set<string | number>\n | ((prev: Set<string | number>) => Set<string | number>),\n ) => void,\n ];\n};",
54556
55304
  "internal": true,
54557
55305
  "importNotice": "Тип \"SubRows\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54558
55306
  "sourceFile": "packages/ui-kit/src/components/Table/feature-tree/types.ts"
54559
55307
  },
54560
- "TableCanvas.SubRows": {
54561
- "name": "SubRows",
54562
- "definition": "export type 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};",
54563
- "internal": true,
54564
- "importNotice": "Тип \"SubRows\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54565
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-tree/types.ts"
54566
- },
54567
- "Table.RowsGrouping": {
55308
+ "RowsGrouping": {
54568
55309
  "name": "RowsGrouping",
54569
55310
  "definition": "export type RowsGrouping<RowType extends ObjectForExtending> = {\n /**\n * массив группированных колонок и его setter\n */\n groupByState: [string[], React.Dispatch<React.SetStateAction<string[]>>];\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 * @default 'Группировка'\n */\n groupedColumnProps?: Partial<\n Pick<\n ColumnConfig<RowType>,\n | 'name'\n | 'resizable'\n | 'width'\n | 'minWidth'\n | 'maxWidth'\n | 'renderSummaryCell'\n >\n > & {\n renderCell?: (\n props: RenderCellProps<RowType> & {\n parentGroupKey: string | undefined;\n groupByArr: string[];\n },\n ) => ReactNode;\n rowsGrouping?: Pick<ColumnRowsGrouping<RowType>, 'renderGroupCell'>;\n };\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};",
54570
55311
  "internal": true,
54571
55312
  "importNotice": "Тип \"RowsGrouping\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54572
55313
  "sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
54573
55314
  },
54574
- "TableCanvas.RowsGrouping": {
54575
- "name": "RowsGrouping",
54576
- "definition": "export type 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};",
54577
- "internal": true,
54578
- "importNotice": "Тип \"RowsGrouping\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54579
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
54580
- },
54581
- "Table.SummaryRowsConfig": {
55315
+ "SummaryRowsConfig": {
54582
55316
  "name": "SummaryRowsConfig",
54583
55317
  "definition": "export 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};",
54584
55318
  "importPath": "@sber-digital-finance-ui/ui-kit",
54585
55319
  "importStatement": "import { SummaryRowsConfig } from '@sber-digital-finance-ui/ui-kit';",
54586
55320
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
54587
55321
  },
54588
- "TableCanvas.SummaryRowsConfig": {
54589
- "name": "SummaryRowsConfig",
54590
- "definition": "export 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};",
54591
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54592
- "importStatement": "import { SummaryRowsConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54593
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
54594
- },
54595
- "Table.ControlBlockConfig": {
55322
+ "ControlBlockConfig": {
54596
55323
  "name": "ControlBlockConfig",
54597
55324
  "definition": "export type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кастомные фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\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: MassActionsButtonProps[];\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};",
54598
55325
  "importPath": "@sber-digital-finance-ui/ui-kit",
54599
55326
  "importStatement": "import { ControlBlockConfig } from '@sber-digital-finance-ui/ui-kit';",
54600
55327
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
54601
55328
  },
54602
- "TableCanvas.ControlBlockConfig": {
54603
- "name": "ControlBlockConfig",
54604
- "definition": "export 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};",
54605
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54606
- "importStatement": "import { ControlBlockConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54607
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
54608
- },
54609
- "Table.ColumnsControlConfig": {
55329
+ "ColumnsControlConfig": {
54610
55330
  "name": "ColumnsControlConfig",
54611
55331
  "definition": "export type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};",
54612
55332
  "internal": true,
54613
55333
  "importNotice": "Тип \"ColumnsControlConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54614
55334
  "sourceFile": "packages/ui-kit/src/components/Table/feature-column-control/types.ts"
54615
55335
  },
54616
- "TableCanvas.ColumnsControlConfig": {
54617
- "name": "ColumnsControlConfig",
54618
- "definition": "export type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};",
54619
- "internal": true,
54620
- "importNotice": "Тип \"ColumnsControlConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54621
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-column-control/types.ts"
54622
- },
54623
55336
  "RowDetailConfig": {
54624
55337
  "name": "RowDetailConfig",
54625
55338
  "definition": "export type RowDetailConfig<RowType> = {\n rowKeyGetter: (row: RowType) => string | number;\n isRowWithDetail: (r: RowType) => boolean;\n renderRowDetail: (props: {\n row: RowType;\n tabIndex: number;\n onRowChange: (row: RowType) => void;\n rowIdx: number;\n colIdx: number;\n }) => ReactNode;\n\n detailHeight: number | ((r: RowType) => number);\n expandButtonColumnKey: string;\n icons?: Prettify<IconsPropType>;\n\n // TODO режим редактирования detailPanel - выключен и убран из типов, если будет потребность, нужно доработать\n // renderRowDetailEditing?: (props: {\n // row: RowType;\n // onRowChange: (row: RowType, commitChanges?: boolean) => void;\n // onClose: (commitChanges?: boolean, shouldFocusCell?: boolean) => void;\n // }) => ReactNode;\n // rowDetailIsEditable?: boolean | ((row: RowType) => boolean);\n};",
@@ -54634,76 +55347,41 @@
54634
55347
  "importStatement": "import { RowInstrumentsType } from '@sber-digital-finance-ui/ui-kit';",
54635
55348
  "sourceFile": "packages/ui-kit/src/components/Table/feature-row-instruments/types.ts"
54636
55349
  },
54637
- "Table.FullScreen": {
55350
+ "FullScreen": {
54638
55351
  "name": "FullScreen",
54639
55352
  "definition": "export type FullScreen = boolean | FullScreenObj;",
54640
55353
  "internal": true,
54641
55354
  "importNotice": "Тип \"FullScreen\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54642
55355
  "sourceFile": "packages/ui-kit/src/components/Table/feature-full-screen/types.ts"
54643
55356
  },
54644
- "TableCanvas.FullScreen": {
54645
- "name": "FullScreen",
54646
- "definition": "export type FullScreen = boolean | FullScreenObj;",
54647
- "internal": true,
54648
- "importNotice": "Тип \"FullScreen\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54649
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-full-screen/types.ts"
54650
- },
54651
- "Table.KeyTextConfig": {
55357
+ "KeyTextConfig": {
54652
55358
  "name": "KeyTextConfig",
54653
55359
  "definition": "export type KeyTextConfig = {\n showInControl?: boolean;\n defaultActiveOption?: KeyText;\n controlBlock: {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n };\n sidebar: {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n domMetadata?: DomMetadata;\n };\n};",
54654
55360
  "internal": true,
54655
55361
  "importNotice": "Тип \"KeyTextConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54656
55362
  "sourceFile": "packages/ui-kit/src/components/Table/feature-key-text/types.ts"
54657
55363
  },
54658
- "TableCanvas.KeyTextConfig": {
54659
- "name": "KeyTextConfig",
54660
- "definition": "export type KeyTextConfig = {\n showInControl?: boolean;\n defaultActiveOption?: KeyText;\n controlBlock: {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n };\n sidebar: {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n domMetadata?: DomMetadata;\n };\n};",
54661
- "internal": true,
54662
- "importNotice": "Тип \"KeyTextConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54663
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-key-text/types.ts"
54664
- },
54665
- "Table.PaginationProps": {
55364
+ "PaginationProps": {
54666
55365
  "name": "PaginationProps",
54667
55366
  "definition": "export type PaginationProps = Omit<\n ComponentProps<typeof Pagination>,\n 'onChangePageValue' | 'onChange'\n> & {\n onChangePageValue?: (\n page: number | undefined,\n scrollToTop: () => void,\n ) => void;\n onChange?: (\n newPage: number | undefined,\n perPage: number | undefined,\n scrollToTop: () => void,\n ) => void;\n /**\n * Нужно ли активировать умную адаптацию изменения количества слотов в зависимости от ширины блока пагинации и от size\n * @default false\n */\n responsiveSlots?: boolean;\n /**\n * Callback при ресайзе блока с пагинацией таблицы\n */\n onResize?: (width: number) => void;\n};",
54668
55367
  "internal": true,
54669
55368
  "importNotice": "Тип \"PaginationProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54670
55369
  "sourceFile": "packages/ui-kit/src/components/Table/feature-pagination/types.ts"
54671
55370
  },
54672
- "TableCanvas.PaginationProps": {
54673
- "name": "PaginationProps",
54674
- "definition": "export type PaginationProps = Omit<\n ComponentProps<typeof Pagination>,\n 'onChangePageValue' | 'onChange'\n> & {\n onChangePageValue?: (\n page: number | undefined,\n scrollToTop: () => void,\n ) => void;\n onChange?: (\n newPage: number | undefined,\n perPage: number | undefined,\n scrollToTop: () => void,\n ) => void;\n /**\n * Нужно ли активировать умную адаптацию изменения количества слотов в зависимости от ширины блока пагинации и от size\n * @default false\n */\n responsiveSlots?: boolean;\n /**\n * Callback при ресайзе блока с пагинацией таблицы\n */\n onResize?: (width: number) => void;\n};",
54675
- "internal": true,
54676
- "importNotice": "Тип \"PaginationProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54677
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-pagination/types.ts"
54678
- },
54679
- "Table.SidebarConfig": {
55371
+ "SidebarConfig": {
54680
55372
  "name": "SidebarConfig",
54681
55373
  "definition": "type SidebarConfig = {\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 defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n label?: string;\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n }\n | {\n id: 'tableSettings';\n label?: string;\n title?: string;\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 }\n >;\n};",
54682
55374
  "internal": true,
54683
55375
  "importNotice": "Тип \"SidebarConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54684
55376
  "sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
54685
55377
  },
54686
- "TableCanvas.SidebarConfig": {
54687
- "name": "SidebarConfig",
54688
- "definition": "export 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};",
54689
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
54690
- "importStatement": "import { SidebarConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
54691
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
54692
- },
54693
- "Table.SearchingProps": {
55378
+ "SearchingProps": {
54694
55379
  "name": "SearchingProps",
54695
55380
  "definition": "export type SearchingProps = {\n /**\n * Активация функционала поиска (обязательный параметр)\n */\n enabled: boolean;\n\n /**\n * Если true - поиск НЕ будет работать на фронте (ручное управление)\n * Полезно когда поисковая логика полностью управляется на бэкенде\n */\n manualSearching?: boolean;\n\n /**\n * Начальное значение поискового запроса\n */\n defaultSearchQuery?: string;\n\n /**\n * Видимость UI блока поиска\n */\n showSearchBlock?: boolean;\n\n /**\n * Состояние и сеттер для контролируемого режима\n * [текущее значение, функция установки значения]\n */\n searchQueryState?: [string, React.Dispatch<React.SetStateAction<string>>];\n\n /**\n * Обработчик изменения с debounce\n * Вызывается с задержкой после окончания ввода\n * @param value - текущее значение поискового запроса\n */\n onDebouncedChange?: (value: string) => void;\n\n /**\n * Мгновенный обработчик изменений\n * Вызывается при каждом изменении input\n * @param value - текущее значение поискового запроса\n */\n onChange?: (value: string) => void;\n\n /**\n * Задержка для debounce (в миллисекундах)\n * @default 300\n */\n debounceDelay?: number;\n\n /**\n * Активация debounce механизма\n * @default true\n */\n isDebounceActive?: boolean;\n\n /**\n * Дополнительные классы для контейнера поиска\n */\n searchClasses?: string;\n\n /**\n * Placeholder для поискового input\n * @default \"Поиск\"\n */\n placeholder?: string;\n\n /**\n * DOM метаданные для аналитики и онбординга\n */\n domMetadata?: DomMetadata;\n\n /**\n * Режим запуска поиска\n * - true: поиск запускается автоматически при вводе текста (по умолчанию)\n * - false: поиск запускается только по клику на иконку поиска или нажатию Enter\n */\n searchOnType?: boolean;\n\n /**\n * Конфигурация автокомплита для поиска.\n * При передаче поле поиска заменяется на Autocomplete с подсказками.\n */\n autocomplete?: SearchAutocompleteConfig;\n};",
54696
55381
  "internal": true,
54697
55382
  "importNotice": "Тип \"SearchingProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54698
55383
  "sourceFile": "packages/ui-kit/src/components/Table/feature-searching/types.ts"
54699
55384
  },
54700
- "TableCanvas.SearchingProps": {
54701
- "name": "SearchingProps",
54702
- "definition": "export type SearchingProps = {\n /**\n * Активация функционала поиска (обязательный параметр)\n */\n enabled: boolean;\n\n /**\n * Если true - поиск НЕ будет работать на фронте (ручное управление)\n * Полезно когда поисковая логика полностью управляется на бэкенде\n */\n manualSearching?: boolean;\n\n /**\n * Начальное значение поискового запроса\n */\n defaultSearchQuery?: string;\n\n /**\n * Видимость UI блока поиска\n */\n showSearchBlock?: boolean;\n\n /**\n * Состояние и сеттер для контролируемого режима\n * [текущее значение, функция установки значения]\n */\n searchQueryState?: [string, React.Dispatch<React.SetStateAction<string>>];\n\n /**\n * Обработчик изменения с debounce\n * Вызывается с задержкой после окончания ввода\n * @param value - текущее значение поискового запроса\n */\n onDebouncedChange?: (value: string) => void;\n\n /**\n * Мгновенный обработчик изменений\n * Вызывается при каждом изменении input\n * @param value - текущее значение поискового запроса\n */\n onChange?: (value: string) => void;\n\n /**\n * Задержка для debounce (в миллисекундах)\n * @default 300\n */\n debounceDelay?: number;\n\n /**\n * Активация debounce механизма\n * @default true\n */\n isDebounceActive?: boolean;\n\n /**\n * Дополнительные классы для контейнера поиска\n */\n searchClasses?: string;\n\n /**\n * Placeholder для поискового input\n * @default \"Поиск\"\n */\n placeholder?: string;\n\n /**\n * DOM метаданные для аналитики и онбординга\n */\n domMetadata?: DomMetadata;\n\n /**\n * Режим запуска поиска\n * - true: поиск запускается автоматически при вводе текста (по умолчанию)\n * - false: поиск запускается только по клику на иконку поиска или нажатию Enter\n */\n searchOnType?: boolean;\n\n /**\n * Конфигурация автокомплита для поиска.\n * При передаче поле поиска заменяется на Autocomplete с подсказками.\n */\n autocomplete?: SearchAutocompleteConfig;\n};",
54703
- "internal": true,
54704
- "importNotice": "Тип \"SearchingProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54705
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-searching/types.ts"
54706
- },
54707
55385
  "HeaderContextMenuProps": {
54708
55386
  "name": "HeaderContextMenuProps",
54709
55387
  "definition": "export type HeaderContextMenuProps = (\n event: React.MouseEvent,\n columnLabel: string | undefined,\n closestTargetElement: HTMLElement | undefined,\n) => void;",
@@ -54746,6 +55424,34 @@
54746
55424
  "importNotice": "Тип \"GlideSizes\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
54747
55425
  "sourceFile": "packages/ui-kit/src/components/TableGlide/constants.ts"
54748
55426
  },
55427
+ "TableCanvasLoggerMessageRenderContext": {
55428
+ "name": "TableCanvasLoggerMessageRenderContext",
55429
+ "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};",
55430
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55431
+ "importStatement": "import { TableCanvasLoggerMessageRenderContext } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55432
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
55433
+ },
55434
+ "TableCanvasLoggerGroupRenderContext": {
55435
+ "name": "TableCanvasLoggerGroupRenderContext",
55436
+ "definition": "export type TableCanvasLoggerGroupRenderContext = {\n item: TableCanvasLoggerGroupItem;\n open: boolean;\n toggle: () => void;\n /** Уже отрисованные дочерние элементы */\n children: ReactNode;\n defaultRender: () => ReactNode;\n};",
55437
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55438
+ "importStatement": "import { TableCanvasLoggerGroupRenderContext } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55439
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
55440
+ },
55441
+ "TableCanvasLoggerLabels": {
55442
+ "name": "TableCanvasLoggerLabels",
55443
+ "definition": "export type TableCanvasLoggerLabels = {\n title: string;\n all: string;\n details: string;\n hide: string;\n copyTraceId: string;\n copied: string;\n copyDescription: string;\n empty: string;\n /** Подсказка кнопки свёрнутой группы */\n expandGroup: string;\n /** Подсказка кнопки раскрытой группы */\n collapseGroup: string;\n /** Подпись группы фильтров для скринридера */\n filters: string;\n} & Record<TableCanvasLoggerStatus, string>;",
55444
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55445
+ "importStatement": "import { TableCanvasLoggerLabels } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55446
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
55447
+ },
55448
+ "TableCanvasLoggerCopyKind": {
55449
+ "name": "TableCanvasLoggerCopyKind",
55450
+ "definition": "export type TableCanvasLoggerCopyKind = 'traceId' | 'description';",
55451
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55452
+ "importStatement": "import { TableCanvasLoggerCopyKind } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55453
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
55454
+ },
54749
55455
  "CellReadOnlyEditorGlideInstanceStaticProps": {
54750
55456
  "name": "CellReadOnlyEditorGlideInstanceStaticProps",
54751
55457
  "definition": "export type CellReadOnlyEditorGlideInstanceStaticProps = {\n formatOptions: ContentFormat | undefined;\n disableLeftOffset: boolean | undefined;\n contentAlign: 'right' | 'left' | 'center';\n};",
@@ -55019,53 +55725,46 @@
55019
55725
  "importStatement": "import { ActiveViewModsType } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55020
55726
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55021
55727
  },
55022
- "Table.CommonFormat": {
55728
+ "CommonFormat": {
55023
55729
  "name": "CommonFormat",
55024
55730
  "definition": "export type CommonFormat = {\n alignContent?: 'right' | 'left' | 'center';\n};",
55025
55731
  "importPath": "@sber-digital-finance-ui/ui-kit",
55026
55732
  "importStatement": "import { CommonFormat } from '@sber-digital-finance-ui/ui-kit';",
55027
55733
  "sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
55028
55734
  },
55029
- "TableCanvas.CommonFormat": {
55030
- "name": "CommonFormat",
55031
- "definition": "export type CommonFormat = {\n alignContent?: 'right' | 'left' | 'center';\n};",
55032
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55033
- "importStatement": "import { CommonFormat } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55034
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
55035
- },
55036
- "Table.GroupRow": {
55735
+ "GroupRow": {
55037
55736
  "name": "GroupRow",
55038
55737
  "definition": "export type GroupRow<RowType> = {\n readonly childRows: readonly RowType[];\n readonly childGroups: readonly RowType[] | Readonly<GroupRowsOrRows<RowType>>;\n groupKey: string;\n groupByKey: string;\n groupParents: string;\n};",
55039
55738
  "importPath": "@sber-digital-finance-ui/ui-kit",
55040
55739
  "importStatement": "import { GroupRow } from '@sber-digital-finance-ui/ui-kit';",
55041
55740
  "sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
55042
55741
  },
55043
- "TableCanvas.GroupRow": {
55044
- "name": "GroupRow",
55045
- "definition": "export type GroupRow<RowType> = {\n readonly childRows: readonly RowType[];\n readonly childGroups: readonly RowType[] | Readonly<GroupRowsOrRows<RowType>>;\n groupKey: string;\n groupByKey: string;\n groupParents: string;\n};",
55046
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55047
- "importStatement": "import { GroupRow } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55048
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
55742
+ "DrawHeaderArgs": {
55743
+ "name": "DrawHeaderArgs",
55744
+ "definition": "type DrawHeaderArgs = Parameters<NonNullable<GlideProps['drawHeader']>>[0];",
55745
+ "internal": true,
55746
+ "importNotice": "Тип \"DrawHeaderArgs\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
55747
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
55049
55748
  },
55050
- "SortColumn": {
55051
- "name": "SortColumn",
55052
- "definition": "export interface SortColumn {\n readonly columnKey: string;\n readonly direction: SortDirection;\n}",
55749
+ "CellHoverState": {
55750
+ "name": "CellHoverState",
55751
+ "definition": "export type CellHoverState = {\n /** Равно true только для ячейки с данными, над которой сейчас находится курсор. */\n cellHover: boolean;\n /** Равно true для всех ячеек с данными в строке, над которой сейчас находится курсор. */\n rowHover: boolean;\n};",
55053
55752
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55054
- "importStatement": "import { SortColumn } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55055
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-sorting/types.ts"
55753
+ "importStatement": "import { CellHoverState } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55754
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
55056
55755
  },
55057
- "EditingCellInfo": {
55058
- "name": "EditingCellInfo",
55059
- "definition": "export type EditingCellInfo<\n R extends ObjectForExtending,\n SR = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = Omit<EditingCellInfoGlideInstance<R, SR, CustomCtxs>, 'column'> & {\n column: ColumnConfig<R, SR, CustomCtxs>;\n};",
55756
+ "CellActiveState": {
55757
+ "name": "CellActiveState",
55758
+ "definition": "export type CellActiveState = {\n /** Равно true, если текущая ячейка с данными входит в активную область выделения таблицы. */\n cellActive: boolean;\n /** Равно true, если строка текущей ячейки с данными содержит активную ячейку или активный диапазон. */\n rowActive: boolean;\n};",
55060
55759
  "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55061
- "importStatement": "import { EditingCellInfo } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55062
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
55760
+ "importStatement": "import { CellActiveState } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55761
+ "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
55063
55762
  },
55064
- "DrawHeaderArgs": {
55065
- "name": "DrawHeaderArgs",
55066
- "definition": "type DrawHeaderArgs = Parameters<NonNullable<GlideProps['drawHeader']>>[0];",
55763
+ "RowErrorsSummary": {
55764
+ "name": "RowErrorsSummary",
55765
+ "definition": "export type RowErrorsSummary = {\n /** Сколько ячеек строки с ошибкой (по всем колонкам, не только видимым). */\n errorCellsCount: number;\n /** Ключи колонок с ошибкой в порядке колонок таблицы. */\n errorColumnKeys: readonly string[];\n /** Строка целиком помечена ошибкой (`isErrorRow`). */\n isErrorRow: boolean;\n};",
55067
55766
  "internal": true,
55068
- "importNotice": "Тип \"DrawHeaderArgs\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
55767
+ "importNotice": "Тип \"RowErrorsSummary\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
55069
55768
  "sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
55070
55769
  },
55071
55770
  "RowIdTypeInstance": {
@@ -55082,6 +55781,13 @@
55082
55781
  "importStatement": "import { FlattenedRowsArrAndMap } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55083
55782
  "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-select-row/types.ts"
55084
55783
  },
55784
+ "SortColumn": {
55785
+ "name": "SortColumn",
55786
+ "definition": "export interface SortColumn {\n readonly columnKey: string;\n readonly direction: SortDirection;\n}",
55787
+ "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55788
+ "importStatement": "import { SortColumn } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55789
+ "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-sorting/types.ts"
55790
+ },
55085
55791
  "GlideSizeConfig": {
55086
55792
  "name": "GlideSizeConfig",
55087
55793
  "definition": "export type GlideSizeConfig = GlideSizes[SIZE];",
@@ -55229,118 +55935,6 @@
55229
55935
  "importNotice": "Тип \"DefaultColumnOptions\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
55230
55936
  "sourceFile": "packages/ui-kit/src/components/Table/types/data-grid.type.ts"
55231
55937
  },
55232
- "ColumnsGroupingConfig": {
55233
- "name": "ColumnsGroupingConfig",
55234
- "definition": "export type ColumnsGroupingConfig = {\n /**\n * Объединять пустые ячейки шапки: колонка без группы (конечная, без вложенных\n * подколонок) растягивается вверх на всю высоту шапки, а «мелкая» группа (без более\n * глубоких подгрупп) — вниз. Убирает пустые полосы в многоуровневой шапке.\n * Включает/выключает поведение сразу для всей таблицы.\n * @default true\n */\n squashEmptyCells?: boolean;\n /**\n * Дефолт выравнивания текста в объединённых ячейках шапки. Влияет только на\n * объединённые ячейки, обычные (не объединённые) ячейки не затрагивает. Точечно\n * перекрывается на колонке или группе через их собственный `squashedHeaderAlign`.\n */\n squashedHeaderAlign?: HeaderAlignment;\n};",
55235
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55236
- "importStatement": "import { ColumnsGroupingConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55237
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/columns-grouping.type.ts"
55238
- },
55239
- "CellsSelectionConfig": {
55240
- "name": "CellsSelectionConfig",
55241
- "definition": "export 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};",
55242
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55243
- "importStatement": "import { CellsSelectionConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55244
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55245
- },
55246
- "BordersConfig": {
55247
- "name": "BordersConfig",
55248
- "definition": "export 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};",
55249
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55250
- "importStatement": "import { BordersConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55251
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55252
- },
55253
- "CellTransferConfig": {
55254
- "name": "CellTransferConfig",
55255
- "definition": "export type CellTransferConfig = {\n /**\n * Явное включение/выключение всей фичи.\n * По умолчанию copy работает всегда, а paste и fill handle следуют\n * за `editModeEnabled`. При `false` отключается всё.\n */\n enabled?: boolean;\n /**\n * Переопределение хоткеев.\n * Можно передать один `HotkeyConfig` или массив альтернативных комбинаций.\n * По умолчанию: copy = Ctrl+C / Cmd+C, paste = Ctrl+V / Cmd+V.\n */\n hotkeys?: {\n /** Хоткей(и) для копирования */\n copy?: HotkeyConfig | HotkeyConfig[];\n /** Хоткей(и) для вставки */\n paste?: HotkeyConfig | HotkeyConfig[];\n };\n /** Настройки paste (readonly, overflow, broadcast, validation) */\n paste?: PasteConfig;\n /** Настройки fill handle. `true/false` — быстрое вкл/выкл без деталей */\n fillHandle?: boolean | FillHandleConfig;\n /**\n * Колбэк перед копированием.\n * Можно модифицировать данные (вернуть новый `string[][]`) или отменить\n * операцию (вернуть `false`).\n * Если onBeforeCopy нужен для side-эффектов, то функция должна вернуть data из первого аргумента без изменений.\n */\n onBeforeCopy?: (data: string[][], meta: CopyMeta) => string[][] | false;\n /**\n * Колбэк перед вставкой.\n * Можно модифицировать данные (вернуть новый `string[][]`) или отменить\n * операцию (вернуть `false`).\n * Если onBeforePaste нужен для side-эффектов, то функция должна вернуть data из первого аргумента без изменений.\n */\n onBeforePaste?: (data: string[][], meta: PasteMeta) => string[][] | false;\n /**\n * Колбэк перед fill handle (drag-to-fill).\n * Вызывается перед применением значений. Можно модифицировать данные\n * (вернуть новый `string[][]`) или отменить операцию (вернуть `false`).\n *\n * `meta.sourceCells` содержит полную информацию об исходных ячейках,\n * включая объекты строк (`row`) — позволяет получить source row\n * и использовать данные из соседних колонок.\n * Если onBeforeFill нужен для side-эффектов, то функция должна вернуть data из первого аргумента без изменений.\n */\n onBeforeFill?: (data: string[][], meta: FillMeta) => string[][] | false;\n};",
55256
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55257
- "importStatement": "import { CellTransferConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55258
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-cell-transfer/types.ts"
55259
- },
55260
- "MergedCellsRegion": {
55261
- "name": "MergedCellsRegion",
55262
- "definition": "export type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};",
55263
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55264
- "importStatement": "import { MergedCellsRegion } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55265
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55266
- },
55267
- "TableNotificationsConfig": {
55268
- "name": "TableNotificationsConfig",
55269
- "definition": "export interface TableNotificationsConfig {\n /** Вызывается на каждое событие таблицы (ошибки copy/paste и т.д.). */\n onNotification: (event: TableNotification) => void;\n}",
55270
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55271
- "importStatement": "import { TableNotificationsConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55272
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-notifications/types.ts"
55273
- },
55274
- "RowMarkersTableConfig": {
55275
- "name": "RowMarkersTableConfig",
55276
- "definition": "export 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};",
55277
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55278
- "importStatement": "import { RowMarkersTableConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55279
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55280
- },
55281
- "TableConfigTooltip": {
55282
- "name": "TableConfigTooltip",
55283
- "definition": "export 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};",
55284
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55285
- "importStatement": "import { TableConfigTooltip } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55286
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55287
- },
55288
- "InfinityScrollConfig": {
55289
- "name": "InfinityScrollConfig",
55290
- "definition": "export 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};",
55291
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55292
- "importStatement": "import { InfinityScrollConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55293
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55294
- },
55295
- "TableCanvasEmptyStateConfig": {
55296
- "name": "TableCanvasEmptyStateConfig",
55297
- "definition": "export type TableCanvasEmptyStateConfig = TableCanvasContentStateBase &\n Partial<EmptyStateProps>;",
55298
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55299
- "importStatement": "import { TableCanvasEmptyStateConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55300
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-content-state/types.ts"
55301
- },
55302
- "TableCanvasErrorStateConfig": {
55303
- "name": "TableCanvasErrorStateConfig",
55304
- "definition": "export type TableCanvasErrorStateConfig = TableCanvasContentStateBase &\n Partial<ErrorPageProps>;",
55305
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55306
- "importStatement": "import { TableCanvasErrorStateConfig } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55307
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-content-state/types.ts"
55308
- },
55309
- "RightSidebarConfig": {
55310
- "name": "RightSidebarConfig",
55311
- "definition": "export type RightSidebarConfig = SidebarConfig;",
55312
- "importPath": "@sber-digital-finance-ui/ui-kit",
55313
- "importStatement": "import { RightSidebarConfig } from '@sber-digital-finance-ui/ui-kit';",
55314
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55315
- },
55316
- "LeftSidebarConfig": {
55317
- "name": "LeftSidebarConfig",
55318
- "definition": "export type LeftSidebarConfig = TableCanvasSidebarConfig;",
55319
- "importPath": "@sber-digital-finance-ui/ui-kit",
55320
- "importStatement": "import { LeftSidebarConfig } from '@sber-digital-finance-ui/ui-kit';",
55321
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55322
- },
55323
- "BottomSheetConfig": {
55324
- "name": "BottomSheetConfig",
55325
- "definition": "export 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};",
55326
- "importPath": "@sber-digital-finance-ui/ui-kit",
55327
- "importStatement": "import { BottomSheetConfig } from '@sber-digital-finance-ui/ui-kit';",
55328
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55329
- },
55330
- "TableGlideInstanceProps": {
55331
- "name": "TableGlideInstanceProps",
55332
- "definition": "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>;",
55333
- "importPath": "@sber-digital-finance-ui/ui-kit/components/TableCanvas",
55334
- "importStatement": "import { TableGlideInstanceProps } from '@sber-digital-finance-ui/ui-kit/components/TableCanvas';",
55335
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
55336
- },
55337
- "GlideInstanceOmitted": {
55338
- "name": "GlideInstanceOmitted",
55339
- "definition": "type 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>;",
55340
- "internal": true,
55341
- "importNotice": "Тип \"GlideInstanceOmitted\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
55342
- "sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
55343
- },
55344
55938
  "CellTransferCellInfo": {
55345
55939
  "name": "CellTransferCellInfo",
55346
55940
  "definition": "export type CellTransferCellInfo = {\n /** Объект строки, в которой находится ячейка */\n row: ObjectForExtending;\n /** Конфиг колонки (срез важных полей) */\n column: TransferColumnConfig;\n /** Индекс колонки в массиве columns */\n colIndex: number;\n /** Индекс строки в массиве flattenedRows */\n rowIndex: number;\n /** Уровень вложенности subrow: 0 — parent, 1+ — subrow */\n lvl: number;\n /** Сырое значение из `row[key]` или `row[subKey]` (без форматирования) */\n rawValue: unknown;\n /** Текстовое представление ячейки (то что попадает в TSV) */\n formattedValue: string;\n};",