@daisforge/ui-mcp 0.2.6 → 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.
- package/data/component-index.json +1296 -607
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"generatedAt": "2026-10-
|
|
3
|
-
"libVersion": "1.
|
|
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": "Использование в
|
|
25721
|
+
"displayName": "Использование в TableCanvas.isLoading.stories.tsx",
|
|
25722
25722
|
"type": "usage",
|
|
25723
|
-
"code": "<Switch\n style={{ width: 'fit-content' }}\n label=\"
|
|
25724
|
-
"sourceFile": "packages/storybook/src/stories/
|
|
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": "
|
|
27343
|
-
"type": "
|
|
27342
|
+
"name": "counts",
|
|
27343
|
+
"type": "Partial<Record<TableCanvasLoggerStatus, number>>",
|
|
27344
27344
|
"required": true,
|
|
27345
|
-
"description": "
|
|
27345
|
+
"description": ""
|
|
27346
27346
|
},
|
|
27347
27347
|
{
|
|
27348
|
-
"name": "
|
|
27349
|
-
"type": "
|
|
27348
|
+
"name": "onChange",
|
|
27349
|
+
"type": "(value: TableCanvasLoggerFilterValue) => void",
|
|
27350
27350
|
"required": true,
|
|
27351
|
-
"description": "
|
|
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": "
|
|
27373
|
-
"type": "
|
|
27374
|
-
"required":
|
|
27375
|
-
"description": "
|
|
27376
|
-
"default": "{}"
|
|
27354
|
+
"name": "value",
|
|
27355
|
+
"type": "TableCanvasLoggerFilterValue | null",
|
|
27356
|
+
"required": true,
|
|
27357
|
+
"description": ""
|
|
27377
27358
|
},
|
|
27378
27359
|
{
|
|
27379
|
-
"name": "
|
|
27380
|
-
"type": "React.
|
|
27360
|
+
"name": "extra",
|
|
27361
|
+
"type": "React.ReactNode",
|
|
27381
27362
|
"required": false,
|
|
27382
|
-
"description": ""
|
|
27363
|
+
"description": "Дополнительные чипсы после стандартных"
|
|
27383
27364
|
},
|
|
27384
27365
|
{
|
|
27385
|
-
"name": "
|
|
27386
|
-
"type": "
|
|
27366
|
+
"name": "showEmpty",
|
|
27367
|
+
"type": "boolean | undefined",
|
|
27387
27368
|
"required": false,
|
|
27388
|
-
"description": ""
|
|
27369
|
+
"description": "Показывать чипсы статусов без сообщений"
|
|
27389
27370
|
}
|
|
27390
27371
|
],
|
|
27391
|
-
"propsTypeName": "
|
|
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": "@daisforge/ui",
|
|
27417
27398
|
"importStatement": "import { TableCanvas } from '@daisforge/ui';",
|
|
27418
|
-
"minimalUsage": "<TableCanvas
|
|
27399
|
+
"minimalUsage": "<TableCanvas counts={{}} onChange={() => {}} value={{}} />",
|
|
27419
27400
|
"examples": [
|
|
27420
27401
|
{
|
|
27421
27402
|
"exportName": "Usage1",
|
|
@@ -27426,10 +27407,766 @@
|
|
|
27426
27407
|
},
|
|
27427
27408
|
{
|
|
27428
27409
|
"exportName": "Usage2",
|
|
27429
|
-
"displayName": "Использование в TableCanvas.
|
|
27410
|
+
"displayName": "Использование в TableCanvas.multipleFeatures.stories.tsx",
|
|
27411
|
+
"type": "usage",
|
|
27412
|
+
"code": "<TableCanvas\n key={debugBounds ? 'debug-bounds' : 'plain'}\n tableConfig={{\n editing: {\n onRowsChange: setRows,\n rowKeyGetter: (r) => `${r.id}`,\n },\n containerStyle: { height: '80vh' },\n unstickyHeader,\n fullScreenEnabled: true,\n resizableColumn: true,\n loadingOverlay: {\n active: isVisibleLoadingOverlay,\n showSubtitleDelay: 5000,\n subtitle:\n 'Данные обрабатываются, обычно это занимает не более 10 секунд',\n },\n rowSize: {\n default: 'big',\n showInControl: true,\n },\n cellsSelection: { mode: selectionMode },\n highlightActiveType,\n searching: {\n enabled: true,\n debounceDelay: 400,\n },\n keyText: {\n showInControl: true,\n controlBlock: {},\n sidebar: {},\n },\n summaryRows: {\n showDefault: true,\n showInControl: true,\n },\n columnsControl: {\n enable: true,\n hiding: true,\n pinning: true,\n reorderingAside: true,\n reorderingHeader: true,\n disableHiding: ['id'],\n disablePinning: ['developer'],\n columnsLabel: {\n task: 'Задачи',\n },\n pinnedDefault: ['id'],\n },\n rowMarkers: {\n startIndex: 1,\n },\n sidebarConfig: {\n customTabs: [\n {\n id: 'customInfo',\n label: 'Информация',\n icon: <IconInfo size=\"s\" />,\n content: <CustomInfoTab />,\n title: 'Информация',\n showInSidebar: true,\n },\n ],\n },\n controlBlock: {\n show: controlBlock,\n rightSideInner: [\n {\n text: 'Label',\n contentLeft: <IconSb color=\"inherit\" />,\n view: 'linkAccent',\n 'data-test-id': 'Label right 1',\n },\n {\n text: 'Скачать',\n contentLeft: <IconSb color=\"inherit\" />,\n// … (обрезано)",
|
|
27413
|
+
"sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.MultipleFeatures/TableCanvas.multipleFeatures.stories.tsx"
|
|
27414
|
+
}
|
|
27415
|
+
]
|
|
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": "@daisforge/ui/components/TableCanvas",
|
|
27471
|
+
"importStatement": "import { TableCanvasLoggerFilters } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
27519
|
+
"importStatement": "import { TableCanvasLoggerGroup } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
27561
|
+
"importStatement": "import { TableCanvasLoggerItems } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
27615
|
+
"importStatement": "import { TableCanvasLoggerMessage } from '@daisforge/ui/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",
|
|
27430
27628
|
"type": "usage",
|
|
27431
|
-
"code": "<
|
|
27432
|
-
"sourceFile": "packages/storybook/src/stories/TableCanvas/TableCanvas.
|
|
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": "@daisforge/ui/components/TableCanvas",
|
|
27664
|
+
"importStatement": "import { TableCanvasLoggerStatusIcon } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
27878
|
+
"importStatement": "import { TableCanvasLogger } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
28041
|
+
"importStatement": "import { TableCanvasLoggerList } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
28161
|
+
"importStatement": "import { TableCanvasLoggerProvider } from '@daisforge/ui/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"
|
|
27433
28170
|
}
|
|
27434
28171
|
]
|
|
27435
28172
|
},
|
|
@@ -27476,6 +28213,12 @@
|
|
|
27476
28213
|
"required": false,
|
|
27477
28214
|
"description": "Controls which directions fill is allowed in."
|
|
27478
28215
|
},
|
|
28216
|
+
{
|
|
28217
|
+
"name": "appearance",
|
|
28218
|
+
"type": "AppearanceConfig | undefined",
|
|
28219
|
+
"required": false,
|
|
28220
|
+
"description": "Внешний вид: «чистый» вариант и зебра. См. {@link AppearanceConfig}."
|
|
28221
|
+
},
|
|
27479
28222
|
{
|
|
27480
28223
|
"name": "cellActivationBehavior",
|
|
27481
28224
|
"type": "CellActivationBehavior | undefined",
|
|
@@ -27500,6 +28243,12 @@
|
|
|
27500
28243
|
"required": false,
|
|
27501
28244
|
"description": "Allows coercion of pasted values."
|
|
27502
28245
|
},
|
|
28246
|
+
{
|
|
28247
|
+
"name": "collectRowErrors",
|
|
28248
|
+
"type": "boolean | undefined",
|
|
28249
|
+
"required": false,
|
|
28250
|
+
"description": "Собирать сводку ошибок по строкам окна видимости ({@link RowErrorsSummary}\nв `cellInfo.rowErrors`). Для сводки колонки с `isErrorCell` обходятся все,\nа не только видимые, поэтому включается только когда сводка кому-то нужна\n(столбец-индикатор ошибок)."
|
|
28251
|
+
},
|
|
27503
28252
|
{
|
|
27504
28253
|
"name": "columnSelect",
|
|
27505
28254
|
"type": "\"none\" | \"single\" | \"multi\" | undefined",
|
|
@@ -27759,6 +28508,12 @@
|
|
|
27759
28508
|
"required": false,
|
|
27760
28509
|
"description": "Determines what can be dragged using HTML drag and drop"
|
|
27761
28510
|
},
|
|
28511
|
+
{
|
|
28512
|
+
"name": "isErrorRow",
|
|
28513
|
+
"type": "((row: R) => boolean) | undefined",
|
|
28514
|
+
"required": false,
|
|
28515
|
+
"description": "Ошибка всей строки: одна красная рамка по всей ширине данных вместо\nпоячеечных рамок этой строки. Проверяется только для строк в окне\nвидимости, как и `isErrorCell`."
|
|
28516
|
+
},
|
|
27762
28517
|
{
|
|
27763
28518
|
"name": "isOutsideClick",
|
|
27764
28519
|
"type": "((e: MouseEvent | TouchEvent) => boolean) | undefined",
|
|
@@ -28825,6 +29580,12 @@
|
|
|
28825
29580
|
"required": true,
|
|
28826
29581
|
"description": ""
|
|
28827
29582
|
},
|
|
29583
|
+
{
|
|
29584
|
+
"name": "appearance",
|
|
29585
|
+
"type": "AppearanceConfig | undefined",
|
|
29586
|
+
"required": false,
|
|
29587
|
+
"description": "Внешний вид: «чистый» вариант и зебра. См. {@link AppearanceConfig}."
|
|
29588
|
+
},
|
|
28828
29589
|
{
|
|
28829
29590
|
"name": "cellsSelectionMode",
|
|
28830
29591
|
"type": "CellsSelectionMode | undefined",
|
|
@@ -28838,6 +29599,12 @@
|
|
|
28838
29599
|
"required": false,
|
|
28839
29600
|
"description": "Индексы строк, выбранных через checkbox selection."
|
|
28840
29601
|
},
|
|
29602
|
+
{
|
|
29603
|
+
"name": "collectRowErrors",
|
|
29604
|
+
"type": "boolean | undefined",
|
|
29605
|
+
"required": false,
|
|
29606
|
+
"description": "Собирать сводку ошибок по строкам окна видимости ({@link RowErrorsSummary}\nв `cellInfo.rowErrors`). Для сводки колонки с `isErrorCell` обходятся все,\nа не только видимые, поэтому включается только когда сводка кому-то нужна\n(столбец-индикатор ошибок)."
|
|
29607
|
+
},
|
|
28841
29608
|
{
|
|
28842
29609
|
"name": "containerClassName",
|
|
28843
29610
|
"type": "string | undefined",
|
|
@@ -28944,6 +29711,12 @@
|
|
|
28944
29711
|
"required": false,
|
|
28945
29712
|
"description": "Эффекты при наведении. `hoverEffects.row` — подсветка строки под курсором:\nрисуется через bgCell (getRowThemeOverride), т.е. лежит ПОД селектингом и\nhighlightActiveType — они рисуются поверх (highlightRegions) и визуально\nперекрывают hover. По умолчанию row-подсветка ВКЛЮЧЕНА; выключение —\nявное `{ row: false }`."
|
|
28946
29713
|
},
|
|
29714
|
+
{
|
|
29715
|
+
"name": "isErrorRow",
|
|
29716
|
+
"type": "((row: R) => boolean) | undefined",
|
|
29717
|
+
"required": false,
|
|
29718
|
+
"description": "Ошибка всей строки: одна красная рамка по всей ширине данных вместо\nпоячеечных рамок этой строки. Проверяется только для строк в окне\nвидимости, как и `isErrorCell`."
|
|
29719
|
+
},
|
|
28947
29720
|
{
|
|
28948
29721
|
"name": "onColumnSelectionApplied",
|
|
28949
29722
|
"type": "(() => void) | undefined",
|
|
@@ -31203,6 +31976,12 @@
|
|
|
31203
31976
|
"required": false,
|
|
31204
31977
|
"description": "Локальный слой внутри canvas-root; рекомендуется использовать zIndex >= 0.\nЗначение суммируется по цепочке родителей и не является DOM z-index."
|
|
31205
31978
|
},
|
|
31979
|
+
{
|
|
31980
|
+
"name": "minWidthByContent",
|
|
31981
|
+
"type": "boolean | undefined",
|
|
31982
|
+
"required": false,
|
|
31983
|
+
"description": "Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\nостаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n\nПодробнее: при измерении текст выставляет себе minContentWidth, равный\nширине первого видимого символа с многоточием. Работает только для\nоднострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\nостальных случаях minContentWidth не заполняется. Явный style.minWidth\nважнее. По умолчанию выключено."
|
|
31984
|
+
},
|
|
31206
31985
|
{
|
|
31207
31986
|
"name": "bottom",
|
|
31208
31987
|
"type": "PositionValue | undefined",
|
|
@@ -31477,6 +32256,12 @@
|
|
|
31477
32256
|
"required": false,
|
|
31478
32257
|
"description": "Локальный слой внутри canvas-root; рекомендуется использовать zIndex >= 0.\nЗначение суммируется по цепочке родителей и не является DOM z-index."
|
|
31479
32258
|
},
|
|
32259
|
+
{
|
|
32260
|
+
"name": "minWidthByContent",
|
|
32261
|
+
"type": "boolean | undefined",
|
|
32262
|
+
"required": false,
|
|
32263
|
+
"description": "Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\nостаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n\nПодробнее: при измерении текст выставляет себе minContentWidth, равный\nширине первого видимого символа с многоточием. Работает только для\nоднострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\nостальных случаях minContentWidth не заполняется. Явный style.minWidth\nважнее. По умолчанию выключено."
|
|
32264
|
+
},
|
|
31480
32265
|
{
|
|
31481
32266
|
"name": "bottom",
|
|
31482
32267
|
"type": "PositionValue | undefined",
|
|
@@ -38930,6 +39715,13 @@
|
|
|
38930
39715
|
"importStatement": "import { TextXS } from '@daisforge/ui';",
|
|
38931
39716
|
"minimalUsage": "<TextXS />",
|
|
38932
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
|
+
},
|
|
38933
39725
|
{
|
|
38934
39726
|
"exportName": "Vendor",
|
|
38935
39727
|
"displayName": "Текст Текст Типографические элементы для описаний к статьям, дополнительной информации и т.д.",
|
|
@@ -46088,7 +46880,7 @@
|
|
|
46088
46880
|
"name": "popoverProps",
|
|
46089
46881
|
"type": "Omit<PropsType<{ view: { default: PolymorphicClassName; }; }> & React.HTMLAttributes<HTMLDivElement> & CustomPopoverProps & React.RefAttributes<HTMLDivElement>, \"onToggle\" | \"opened\" | \"target\"> | undefined",
|
|
46090
46882
|
"required": false,
|
|
46091
|
-
"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% окна, дальше прокрутка."
|
|
46092
46884
|
},
|
|
46093
46885
|
{
|
|
46094
46886
|
"name": "redSquare",
|
|
@@ -46651,7 +47443,7 @@
|
|
|
46651
47443
|
"name": "popoverProps",
|
|
46652
47444
|
"type": "Omit<PropsType<{ view: { default: PolymorphicClassName; }; }> & React.HTMLAttributes<HTMLDivElement> & CustomPopoverProps & React.RefAttributes<HTMLDivElement>, \"onToggle\" | \"opened\" | \"target\"> | undefined",
|
|
46653
47445
|
"required": false,
|
|
46654
|
-
"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% окна, дальше прокрутка."
|
|
46655
47447
|
},
|
|
46656
47448
|
{
|
|
46657
47449
|
"name": "redSquare",
|
|
@@ -47826,7 +48618,7 @@
|
|
|
47826
48618
|
"name": "popoverProps",
|
|
47827
48619
|
"type": "Omit<PropsType<{ view: { default: PolymorphicClassName; }; }> & React.HTMLAttributes<HTMLDivElement> & CustomPopoverProps & React.RefAttributes<HTMLDivElement>, \"opened\" | \"target\" | \"onToggle\"> | undefined",
|
|
47828
48620
|
"required": false,
|
|
47829
|
-
"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% окна, дальше прокрутка.",
|
|
47830
48622
|
"default": "{}"
|
|
47831
48623
|
},
|
|
47832
48624
|
{
|
|
@@ -47918,7 +48710,7 @@
|
|
|
47918
48710
|
"name": "popoverProps",
|
|
47919
48711
|
"type": "Omit<PropsType<{ view: { default: PolymorphicClassName; }; }> & React.HTMLAttributes<HTMLDivElement> & CustomPopoverProps & React.RefAttributes<HTMLDivElement>, \"opened\" | \"target\" | \"onToggle\"> | undefined",
|
|
47920
48712
|
"required": false,
|
|
47921
|
-
"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% окна, дальше прокрутка.",
|
|
47922
48714
|
"default": "{}"
|
|
47923
48715
|
},
|
|
47924
48716
|
{
|
|
@@ -48170,8 +48962,8 @@
|
|
|
48170
48962
|
"toolbar",
|
|
48171
48963
|
"filter bar"
|
|
48172
48964
|
],
|
|
48173
|
-
"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).",
|
|
48174
|
-
"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```",
|
|
48175
48967
|
"curatedStories": [
|
|
48176
48968
|
{
|
|
48177
48969
|
"exportName": "FilterActionsStory",
|
|
@@ -48910,11 +49702,11 @@
|
|
|
48910
49702
|
"legacy": false,
|
|
48911
49703
|
"summary": "Текстовый элемент для canvas-ячеек `TableCanvas` с поддержкой ellipsis и многострочного clamp.",
|
|
48912
49704
|
"docs": "# Canvas.Text\n\nТекстовый элемент для canvas-ячеек `TableCanvas` с поддержкой ellipsis и многострочного clamp.\n\n## Ключевые особенности\n\n- Однострочный ellipsis через `overflow=\"hidden\"` + `textOverflow=\"ellipsis\"`\n- Многострочный clamp через `wordWrap` + `maxLines`\n- Clip без маркера: `textOverflow=\"clip\"`\n- Кастомный маркер обрезки через `ellipsis` (по умолчанию `…`)\n- Авто-тултип с полным текстом при обрезке через `autoTooltip`\n\n## Однострочный ellipsis\n\n```tsx\n<Canvas.Text overflow=\"hidden\" textOverflow=\"ellipsis\" style={{ flexGrow: 1 }}>\n Очень длинный текст\n</Canvas.Text>\n```\n\n## Многострочный clamp\n\n```tsx\n<Canvas.Text\n wordWrap\n maxLines={2}\n overflow=\"hidden\"\n textOverflow=\"ellipsis\"\n lineHeight={1.2}\n style={{ flexGrow: 1 }}\n>\n Длинный текст на несколько строк\n</Canvas.Text>\n```\n\n`maxLines` работает только при `wordWrap` и `overflow=\"hidden\"`. `maxLines={1}` ведёт себя как однострочный ellipsis.\n\n## Высота строки\n\nДля многострочного текста высота строки таблицы должна оставлять место под нужное количество строк с учётом `lineHeight` и padding.\n\n## Авто-тултип при обрезке (`autoTooltip`)\n\nЕсли текст обрезается в многоточие, `Canvas.Text` может сам показывать тултип с полным текстом — без ручного `portalHoverEnabled` и `tooltip`:\n\n```tsx\n<Canvas.Text overflow=\"hidden\" textOverflow=\"ellipsis\" autoTooltip style={{ flexGrow: 1 }}>\n {row.longText}\n</Canvas.Text>\n```\n\nПравила:\n\n- Тултип показывается **только когда текст реально обрезан в многоточие**. Если текст помещается целиком — тултипа нет.\n- Работает и для многострочного clamp (`wordWrap` + `maxLines`): тултип появляется, когда есть скрытые строки ниже `maxLines`.\n- При `textOverflow=\"clip\"` (обрезка без маркера `…`) тултип не показывается.\n- `autoTooltip` сам делает ноду hover-таргетом (неявно включает `portalHoverEnabled`).\n- Явный проп `tooltip` приоритетнее: если заданы оба — показывается `tooltip` (always-on, без условия обрезки).\n- Обрезанность определяется по фактической ширине ноды после layout, поэтому при ресайзе колонки тултип автоматически появляется/исчезает вместе с многоточием.\n\nКастомизация — объектом (тип `CanvasTextAutoTooltip`):\n\n```tsx\n<Canvas.Text\n overflow=\"hidden\"\n textOverflow=\"ellipsis\"\n autoTooltip={{\n placement: 'top',\n mouseEnterDelay: 300,\n // По умолчанию текст тултипа = полный текст ноды.\n // Строка — заменить, функция — трансформировать, null из функции — не показывать.\n text: (fullText) => `Полностью: ${fullText}`,\n }}\n style={{ flexGrow: 1 }}\n>\n {row.longText}\n</Canvas.Text>\n```\n\n`autoTooltip={{ enabled: false }}` (или `autoTooltip={false}`) выключает авто-тултип. Доступные пропсы оформления — те же, что у обычного node-тултипа: `placement`, `view`, `minWidth`, `maxWidth`, `mouseEnterDelay`, `mouseLeaveDelay`.\n\n> Авто-тултип действует только на `Canvas.Text` внутри canvas-разметки (`renderCell` / `renderHeaderCell`, включая хедеры и групп-хедеры). Обычные текстовые ячейки таблицы (примитивные значения без `renderCell`) рисуются встроенным text-рендерером glide и в этой механике не участвуют.\n\nОбщая механика тултипов таблицы описана в разделе [Tooltip](?path=/docs/локальные-компоненты-tablecanvas-tooltip--docs).\n\nОписание типов — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-canvaselements-canvastext-api--docs).",
|
|
48913
|
-
"apiDocs": "# Canvas.Text API\n\n## CanvasTextOptions\n\n```typescript\ninterface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n}\n```\n\n## CanvasTextAutoTooltip\n\nКонфиг авто-тултипа при обрезке текста (проп `autoTooltip`). `boolean` — включить/выключить с дефолтным поведением (полный текст ноды), объект — кастомизация:\n\n```typescript\ntype CanvasTextAutoTooltip =\n | boolean\n | (CanvasNodeTooltipProps & {\n /** @default true — скрыть можно через false */\n enabled?: boolean;\n /**\n * Переопределение/трансформация текста тултипа. По умолчанию — собственный\n * текст ноды. Вернуть `null` — не показывать.\n */\n text?: string | ((fullText: string) => string | null);\n mouseEnterDelay?: number;\n mouseLeaveDelay?: number;\n });\n```",
|
|
49705
|
+
"apiDocs": "# Canvas.Text API\n\n## CanvasTextOptions\n\n```typescript\ninterface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n /**\n * Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\n * остаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n *\n * Подробнее: при измерении текст выставляет себе minContentWidth, равный\n * ширине первого видимого символа с многоточием. Работает только для\n * однострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\n * остальных случаях minContentWidth не заполняется. Явный style.minWidth\n * важнее. По умолчанию выключено.\n */\n minWidthByContent?: boolean;\n}\n```\n\n## CanvasTextAutoTooltip\n\nКонфиг авто-тултипа при обрезке текста (проп `autoTooltip`). `boolean` — включить/выключить с дефолтным поведением (полный текст ноды), объект — кастомизация:\n\n```typescript\ntype CanvasTextAutoTooltip =\n | boolean\n | (CanvasNodeTooltipProps & {\n /** @default true — скрыть можно через false */\n enabled?: boolean;\n /**\n * Переопределение/трансформация текста тултипа. По умолчанию — собственный\n * текст ноды. Вернуть `null` — не показывать.\n */\n text?: string | ((fullText: string) => string | null);\n mouseEnterDelay?: number;\n mouseLeaveDelay?: number;\n });\n```",
|
|
48914
49706
|
"api": [
|
|
48915
49707
|
{
|
|
48916
49708
|
"typeName": "CanvasTextOptions",
|
|
48917
|
-
"source": "interface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n}"
|
|
49709
|
+
"source": "interface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n /**\n * Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\n * остаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n *\n * Подробнее: при измерении текст выставляет себе minContentWidth, равный\n * ширине первого видимого символа с многоточием. Работает только для\n * однострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\n * остальных случаях minContentWidth не заполняется. Явный style.minWidth\n * важнее. По умолчанию выключено.\n */\n minWidthByContent?: boolean;\n}"
|
|
48918
49710
|
},
|
|
48919
49711
|
{
|
|
48920
49712
|
"typeName": "CanvasTextAutoTooltip",
|
|
@@ -48972,7 +49764,7 @@
|
|
|
48972
49764
|
"exportName": "BigDataExample",
|
|
48973
49765
|
"displayName": "Большой набор данных (строки × колонки)",
|
|
48974
49766
|
"type": "full-code",
|
|
48975
|
-
"code": "() => {\n const [cols, setCols] = useState(1000);\n const [rowInput, setRowInput] = useState('50000');\n const [rowTarget, setRowTarget] = useState(50000);\n const [withMerge, setWithMerge] = useState(true);\n const [heavyCells, setHeavyCells] = useState(true);\n const [withEditing, setWithEditing] = useState(false);\n // Правки пользователя поверх сгенерированных данных (режим редактирования).\n const [editedRows, setEditedRows] = useState<Node[] | null>(null);\n\n const commitsRef = useRef<number[]>([]);\n const onRender = useCallback(\n (_id: string, _phase: string, actualDuration: number) => {\n commitsRef.current.push(actualDuration);\n },\n [],\n );\n\n const { rows: builtRows, leaves } = useMemo(\n () => buildData(rowTarget, withMerge),\n [rowTarget, withMerge],\n );\n\n useEffect(() => {\n setEditedRows(null);\n }, [builtRows]);\n\n const dataRows = editedRows ?? builtRows;\n\n const columns = useMemo(\n ()
|
|
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 }"
|
|
48976
49768
|
},
|
|
48977
49769
|
{
|
|
48978
49770
|
"exportName": "RowSpanBasic",
|
|
@@ -49047,7 +49839,7 @@
|
|
|
49047
49839
|
"feature": "ColumnResize",
|
|
49048
49840
|
"legacy": false,
|
|
49049
49841
|
"summary": "Ограничения ширины колонок. Задаются на уровне колонки (`columnConfig`) или глобально в `tableConfig`.",
|
|
49050
|
-
"docs": "# Column Resize (minWidth / maxWidth / maxAutoWidth)\n\nОграничения ширины колонок. Задаются на уровне колонки (`columnConfig`) или глобально в `tableConfig`.\n\n## Быстрый старт\n\n```tsx\nconst columnConfig: ColumnConfig<Row>[] = [\n {\n key: 'name',\n name: 'Название',\n width: 250,\n minWidth: 150,\n maxWidth: 400,\n },\n {\n key: 'description',\n name: 'Описание',\n maxAutoWidth: 500,\n },\n];\n```\n\n## Поля колонки\n\n### minWidth\n\nМинимальная ширина колонки (px). Колонка не может стать уже этого значения — ни при ресайзе мышкой, ни при автоматическом расчёте ширины.\n\n
|
|
49842
|
+
"docs": "# Column Resize (minWidth / maxWidth / maxAutoWidth)\n\nОграничения ширины колонок. Задаются на уровне колонки (`columnConfig`) или глобально в `tableConfig`.\n\n## Быстрый старт\n\n```tsx\nconst columnConfig: ColumnConfig<Row>[] = [\n {\n key: 'name',\n name: 'Название',\n width: 250,\n minWidth: 150,\n maxWidth: 400,\n },\n {\n key: 'description',\n name: 'Описание',\n maxAutoWidth: 500,\n },\n];\n```\n\n## Поля колонки\n\n### minWidth\n\nМинимальная ширина колонки (px). Колонка не может стать уже этого значения — ни при ресайзе мышкой, ни при автоматическом расчёте ширины.\n\nУ каждой колонки есть ещё минимум по содержимому шапки, он считается автоматически и ниже него колонку сжать нельзя даже с меньшим `minWidth`. Подробнее в разделе «Минимум по содержимому шапки».\n\n### maxWidth\n\nМаксимальная ширина колонки (px). **Жёсткий потолок** — ограничивает всё: и автоматический расчёт ширины, и ручной ресайз мышкой. Колонка никогда не станет шире `maxWidth`.\n\nЕсли не задан — берётся глобальный `maxColumnWidth` из `tableConfig`.\n\n### maxAutoWidth\n\nМаксимальная ширина колонки при **автоматическом расчёте** (px). **Мягкий потолок** — колонка стремится не превышать это значение при автоматическом распределении ширин, но **пользователь может растянуть её шире** вручную.\n\nЕсли не задан — берётся глобальный `maxColumnAutoWidth` из `tableConfig`.\n\n#### Отличие maxAutoWidth от maxWidth\n\n- `maxWidth` — жёсткий потолок. Ограничивает и автоматическую ширину, и ручной ресайз.\n- `maxAutoWidth` — мягкий потолок. Ограничивает только автоматическую ширину. Ручной ресайз не ограничен.\n\nЕсли заданы оба — при автоматическом расчёте берётся **меньшее** из двух значений. При ручном ресайзе действует только `maxWidth`.\n\n## Начальная ширина\n\nЕсли у колонки задан `width`, она рендерится с этой шириной (клампится в диапазон `minWidth`..`maxWidth`).\n\nЕсли `width` не задан — начальная ширина вычисляется автоматически. Колонки без фиксированной ширины заполняют свободное место в контейнере. При этом `maxAutoWidth` ограничивает, насколько широко колонка может автоматически растянуться.\n\n## Минимум по содержимому шапки\n\nШапка колонки должна оставаться читаемой при любой ширине, поэтому таблица сама считает нижнюю границу ширины колонки. В неё входят:\n\n- отступы ячейки слева и справа по размеру строки (`rowSize`);\n- иконки слева от названия: пин закреплённой колонки, иконка перетаскивания за шапку, кнопка «раскрыть все» у колонки с подстроками;\n- место под одну букву названия с многоточием;\n- кнопки справа от названия: фильтр и сортировка, если они есть у колонки. Кнопки появляются при наведении, но место под них учитывается всегда, иначе при наведении они не поместились бы.\n\nПоэтому колонка с фильтром и сортировкой не сожмётся так же узко, как колонка без них, а на большой строке минимум выше, чем на малой. Свой `minWidth` колонки может только поднять эту границу: значение меньше автоматического минимума не действует. Фиксированный `width` меньше минимума тоже поднимается до него.\n\nЕсли название колонки всё же не помещается, оно сжимается до первой буквы с многоточием, а полное название показывается в тултипе.\n\n## Глобальные ограничения\n\nВ `tableConfig` можно задать ограничения по умолчанию для всех колонок:\n\n```tsx\n<TableCanvas\n tableConfig={{\n minColumnWidth: 80,\n maxColumnWidth: 600,\n maxColumnAutoWidth: 400,\n }}\n columnConfig={columnConfig}\n rows={rows}\n/>\n```\n\nЕсли у конкретной колонки задано своё значение (`minWidth`, `maxWidth`, `maxAutoWidth`), оно перебивает глобальное.\n\nГлобальный `minColumnWidth` на колонки с данными сейчас не действует: у каждой такой колонки минимум всегда считается по содержимому шапки, и он приоритетнее. Параметр влияет только на служебные колонки.\n\n## Приоритеты\n\n- Колоночные значения (`minWidth`, `maxWidth`, `maxAutoWidth`) приоритетнее глобальных из `tableConfig`\n- `minWidth` не может быть ниже автоматического минимума по содержимому шапки\n- Если `minWidth` больше `maxWidth`, приоритет у `minWidth`\n- `maxAutoWidth` не влияет на ручной ресайз — пользователь всегда может растянуть колонку шире\n\nПолная типизация колонок: [columnConfig API](?path=/docs/локальные-компоненты-tablecanvas-api-columnconfig--docs).",
|
|
49051
49843
|
"apiDocs": "",
|
|
49052
49844
|
"api": [],
|
|
49053
49845
|
"stories": [
|
|
@@ -49116,12 +49908,12 @@
|
|
|
49116
49908
|
"feature": "ColumnsControl",
|
|
49117
49909
|
"legacy": false,
|
|
49118
49910
|
"summary": "*tableConfig.columnsControl**",
|
|
49119
|
-
"docs": "# ColumnsControl (TableCanvas)\n\n**tableConfig.columnsControl**\n\nНастройка колонок таблицы: скрытие, закрепление, изменение порядка (через Aside-панель и drag в header).\n\n## Ключевые особенности\n\n- Активация через `enable: true` — включает все подфичи по умолчанию\n- Скрытие колонок через свитчи в Aside (`hiding`)\n- Закрепление колонок (`pinning`)\n- Перетаскивание колонок в Aside (`reorderingAside`) и через header (`reorderingHeader`)\n- Дефолтные состояния при первом рендере (`pinnedDefault`, `hiddenDefault`, `orderDefault`)\n- Переопределение названий колонок в Aside (`columnsLabel`)\n- Колбэк при применении настроек (`onConfirm`)\n- Синий индикатор скрытых столбцов в шапке (`hiddenColumnsIndicator`)\n\n## Подфичи\n\nКаждая подфича по умолчанию наследует значение `enable`. Можно отключить отдельно:\n\n- **`hiding`** — скрытие/показ колонок через свитчи. `disableHiding` исключает конкретные колонки\n- **`pinning`** — закрепление колонок слева. `disablePinning` исключает конкретные колонки\n- **`reorderingAside`** — drag-and-drop порядка колонок в Aside-панели\n- **`reorderingHeader`** — drag-and-drop заголовков колонок прямо в таблице. `onReorderingHeader` — callback с новым порядком\n\n## Дефолтные состояния\n\n- **`pinnedDefault`** — массив ключей колонок, закреплённых при первом рендере\n- **`hiddenDefault`** — массив ключей скрытых колонок при первом рендере\n- **`orderDefault`** — массив ключей, определяющий начальный порядок колонок\n\n## onConfirm\n\nCallback вызывается при нажатии «Применить» в Aside. Получает текущее состояние (`pinned`, `order`, `hidden`, `changed`) и сеттеры для программного управления состоянием.\n\n## Индикатор скрытых столбцов (hiddenColumnsIndicator)\n\nКогда между двумя видимыми колонками спрятаны столбцы, на границе в шапке вместо обычного бордера рисуется толстая синяя полосатая линия. Так пользователь видит, что тут есть скрытый промежуток, и может быстро его раскрыть.\n\n- Фича **нативная**: включается сама вместе с `hiding`. Отдельно управляется флагом `hiddenColumnsIndicator` (по умолчанию `true` при активном `hiding`). Отключается `hiddenColumnsIndicator: false`.\n- **Одна полоса на весь промежуток**: сколько бы столбцов ни было скрыто подряд, линия одна. Двойной клик раскрывает сразу весь промежуток.\n- **Наведение** на линию показывает тултип «Дважды нажмите, чтобы развернуть».\n- **Ресайз** соседней колонки за эту же границу работает как обычно (тянем перетаскиванием), меняется только двойной клик: он раскрывает промежуток вместо автосайза. Если полоса высокая, тянуть за ресайз можно по всей её высоте, а не только в листовом ряду.\n- **Края таблицы**: если скрыт первый или последний столбец, линия прижимается к левому или правому краю.\n- **Сгруппированная шапка**: фича относится только к колонкам, сами группы не скрываются, а высота полосы подстраивается под то, что скрыто. Если спрятаны только листья внутри групп, полоса низкая (в листовом ряду). Если среди скрытых есть большая колонка верхнего уровня, полоса тянется вверх на всю высоту шапки. Высоту дополнительно ограничивает общая группа видимых соседей: пока они под одной группой, полоса не поднимается выше её низа.\n\n### onHiddenColumnsIndicatorExpand\n\nКолбэк-уведомление о раскрытии промежутка двойным кликом. Само раскрытие (снятие скрытия) делает обёртка; колбэк нужен, чтобы продукт мог подписаться на это событие. В него приходит объект с полями: `keys` (ключи раскрываемых столбцов), `leftKey` и `rightKey` (видимые соседи слева и справа от линии, `undefined` на краю таблицы).\n\nСрабатывает **только** на двойной клик по линии индикатора. Обычное изменение видимости через панель настройки колонок (Aside) или контекстное меню продукта его не вызывает: для этих сценариев есть общий стейт скрытых колонок и `onConfirm`.\n\nПримеры: стори «ColumnsControl: индикатор скрытых столбцов» и рядом (по бокам, выключен, в группе, в скваш-колонках).\n\n## Меню закрепления в контрл-блоке (pinningMenu)\n\nКогда включено `pinning`, в правой зоне иконок контрл-блока автоматически появляется нативная кнопка-иконка (пин + шеврон) — быстрый доступ к закреплению выбранных колонок, дополняющий Aside-панель. Задаётся через `controlBlock.pinningMenu`.\n\n- Фича **нативная**: появляется сама при активном `pinning`, отдельно включать не нужно. Отключается `controlBlock.pinningMenu.enable: false`.\n- **Размеры** завязаны на размер контрл-блока (`controlBlock.size`) — в компактном (`xs`) ужимается вместе с остальными иконками.\n- Участвует в **компрессии**: при нехватке места уезжает в overflow-меню `…` вложенным подменю.\n\nПункты меню:\n\n- **Стандартные (из коробки):** «Открепить всё» и «Закрепить столбцы».\n- **Свои пункты** — через `pinningMenu.items` (напр. «Закрепить строки», «Закрепить шапку»). Порядок задаётся `order` (у нативных: `Открепить всё` = 100, `Закрепить столбцы` = 200), разделитель после пункта — `dividerAfter`. Совпадение `value` с нативным = переопределение.\n- Состояние и иконку продуктовых пунктов **контролирует продукт** (иконка — `ReactNode` или функция от `rowSize`, может отражать состояние).\n\nЛевая иконка (кнопка-действие):\n\n- Синеет, когда среди **видимых** колонок есть хотя бы одна закреплённая (скрыли видимость закреплённой — снова обычный цвет).\n- Tooltip и действие зависят от выделения: нет выделения — подсказка выбрать колонки; выбраны незакреплённые — «Закрепить»; выбраны только закреплённые — «Открепить».\n- После закрепления выделение **переезжает** за колонками (закреплённые уезжают влево), соседние сливаются без разделителей.\n- Клик по действию закрепления **без выделенных колонок** шлёт событие в `tableConfig.notifications` (`type: 'pin'`, `code: 'no-selection'`) — продукт показывает свою подсказку. Подробнее — в разделе [Notifications](?path=/docs/локальные-компоненты-tablecanvas-notifications--docs).\n\nПример добавления своих пунктов — в стори «ColumnsControl: доп. пункты меню закрепления».\n\n> Подробнее о типах и пропсах — [ColumnsControl API](?path=/docs/локальные-компоненты-tablecanvas-columnscontrol-api--docs)",
|
|
49120
|
-
"apiDocs": "# ColumnsControl API\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```\n\n## HiddenColumnsIndicatorExpandInfo\n\nДанные, которые приходят в колбэк `onHiddenColumnsIndicatorExpand` при раскрытии промежутка двойным кликом по индикатору скрытых столбцов.\n\n```typescript\ntype HiddenColumnsIndicatorExpandInfo = {\n /** Ключи скрытых столбцов, которые раскрываются (весь промежуток за линией). */\n keys: string[];\n /** Видимый сосед слева от линии. undefined, если линия у левого края таблицы. */\n leftKey?: string;\n /** Видимый сосед справа от линии. undefined, если линия у правого края таблицы. */\n rightKey?: string;\n};\n```\n\n## PinningMenuConfig\n\nМеню закрепления в контрл-блоке (`controlBlock.pinningMenu`). Появляется, когда включено `columnsControl.pinning`.\n\n```typescript\ntype PinningMenuConfig = {\n /**\n * Явное вкл/выкл фичи.\n * @default columnsControl.pinning\n */\n enable?: boolean;\n /**\n * Продуктовые пункты меню — мёржатся с нативными (override по value,\n * сортировка по order).\n */\n items?: PinningMenuItem[];\n /**\n * DomMetadata левой кнопки-иконки закрепления. Её `dataAttributes`\n * навешиваются на кнопку-иконку (data-атрибуты для e2e-тестов, аналитики и\n * онбординга — поиск элемента в DOM). Пример:\n * `{ dataAttributes: { 'data-testid': 'pinning-icon' } }`.\n */\n iconDomMetadata?: DomMetadata;\n};\n```\n\n## PinningMenuItem\n\nПункт меню закрепления — нативный или добавленный продуктом.\n\n```typescript\ntype PinningMenuItem = {\n /**\n * Уникальный ключ пункта. Совпадение с value нативного пункта = override\n * (продуктовые поля перекрывают нативные).\n */\n value: string;\n label: string;\n /**\n * Иконка слева в пункте. Узел рендерится как есть, либо функция (ctx),\n * чтобы подстроить размер под rowSize (в т.ч. внутри overflow-дропдауна\n * при компрессии). Стейт/иконку продуктовых пунктов контролирует продукт.\n */\n icon?: FeatureIconRender;\n /**\n * Действие пункта. У нативных пунктов задаётся таблицей; продукт может\n * переопределить.\n */\n onClick?: () => void;\n /**\n * Порядок в списке (по возрастанию). Нативные: reset=100, pin-columns=200.\n * Пункты без order идут в конец, сохраняя исходный порядок.\n */\n order?: number;\n /**\n * Нарисовать разделитель после пункта.\n * @default false\n */\n dividerAfter?: boolean;\n disabled?: boolean;\n};\n```",
|
|
49911
|
+
"docs": "# ColumnsControl (TableCanvas)\n\n**tableConfig.columnsControl**\n\nНастройка колонок таблицы: скрытие, закрепление, изменение порядка (через Aside-панель и drag в header).\n\n## Ключевые особенности\n\n- Активация через `enable: true` — включает все подфичи по умолчанию\n- Скрытие колонок через свитчи в Aside (`hiding`)\n- Закрепление колонок (`pinning`)\n- Перетаскивание колонок в Aside (`reorderingAside`) и через header (`reorderingHeader`)\n- Дефолтные состояния при первом рендере (`pinnedDefault`, `hiddenDefault`, `orderDefault`)\n- Переопределение названий колонок в Aside (`columnsLabel`)\n- Колбэк при применении настроек (`onConfirm`)\n- Синий индикатор скрытых столбцов в шапке (`hiddenColumnsIndicator`)\n\n## Подфичи\n\nКаждая подфича по умолчанию наследует значение `enable`. Можно отключить отдельно:\n\n- **`hiding`** — скрытие/показ колонок через свитчи. `disableHiding` исключает конкретные колонки\n- **`pinning`** — закрепление колонок слева. `disablePinning` исключает конкретные колонки\n- **`reorderingAside`** — drag-and-drop порядка колонок в Aside-панели\n- **`reorderingHeader`** — drag-and-drop заголовков колонок прямо в таблице. `onReorderingHeader` — callback с новым порядком\n\n## Дефолтные состояния\n\n- **`pinnedDefault`** — массив ключей колонок, закреплённых при первом рендере\n- **`hiddenDefault`** — массив ключей скрытых колонок при первом рендере\n- **`orderDefault`** — массив ключей, определяющий начальный порядок колонок\n\n## onConfirm\n\nCallback вызывается при нажатии «Применить» в Aside. Получает текущее состояние (`pinned`, `order`, `hidden`, `changed`) и сеттеры для программного управления состоянием.\n\n## Режим применения (applyMode)\n\n- **`confirm`** (по умолчанию) — панель копит изменения локально, внизу кнопки «Отменить» и «Применить». В таблицу и в `onConfirm` изменения уходят только по кнопке «Применить».\n- **`instant`** — кнопок нет. Каждое действие в панели (свитч видимости, пин, перенос, «открепить все», «сбросить порядок», «включить все столбцы») сразу меняет таблицу. `onConfirm` вызывается после каждого такого действия с тем же контрактом, что и по кнопке, поэтому существующие подписчики продолжают работать без изменений. Поле `changed` описывает разницу с предыдущим применённым состоянием. Изменения, сделанные вне панели (пин в шапке, перенос заголовка, раскрытие скрытых столбцов), `onConfirm` не вызывают, как и раньше.\n\nПример — стори «Мгновенное применение».\n\n## Индикатор скрытых столбцов (hiddenColumnsIndicator)\n\nКогда между двумя видимыми колонками спрятаны столбцы, на границе в шапке вместо обычного бордера рисуется толстая синяя полосатая линия. Так пользователь видит, что тут есть скрытый промежуток, и может быстро его раскрыть.\n\n- Фича **нативная**: включается сама вместе с `hiding`. Отдельно управляется флагом `hiddenColumnsIndicator` (по умолчанию `true` при активном `hiding`). Отключается `hiddenColumnsIndicator: false`.\n- **Одна полоса на весь промежуток**: сколько бы столбцов ни было скрыто подряд, линия одна. Двойной клик раскрывает сразу весь промежуток.\n- **Наведение** на линию показывает тултип «Дважды нажмите, чтобы развернуть».\n- **Ресайз** соседней колонки за эту же границу работает как обычно (тянем перетаскиванием), меняется только двойной клик: он раскрывает промежуток вместо автосайза. Если полоса высокая, тянуть за ресайз можно по всей её высоте, а не только в листовом ряду.\n- **Края таблицы**: если скрыт первый или последний столбец, линия прижимается к левому или правому краю.\n- **Сгруппированная шапка**: фича относится только к колонкам, сами группы не скрываются, а высота полосы подстраивается под то, что скрыто. Если спрятаны только листья внутри групп, полоса низкая (в листовом ряду). Если среди скрытых есть большая колонка верхнего уровня, полоса тянется вверх на всю высоту шапки. Высоту дополнительно ограничивает общая группа видимых соседей: пока они под одной группой, полоса не поднимается выше её низа.\n\n### onHiddenColumnsIndicatorExpand\n\nКолбэк-уведомление о раскрытии промежутка двойным кликом. Само раскрытие (снятие скрытия) делает обёртка; колбэк нужен, чтобы продукт мог подписаться на это событие. В него приходит объект с полями: `keys` (ключи раскрываемых столбцов), `leftKey` и `rightKey` (видимые соседи слева и справа от линии, `undefined` на краю таблицы).\n\nСрабатывает **только** на двойной клик по линии индикатора. Обычное изменение видимости через панель настройки колонок (Aside) или контекстное меню продукта его не вызывает: для этих сценариев есть общий стейт скрытых колонок и `onConfirm`.\n\nПримеры: стори «ColumnsControl: индикатор скрытых столбцов» и рядом (по бокам, выключен, в группе, в скваш-колонках).\n\n## Меню закрепления в контрл-блоке (pinningMenu)\n\nКогда включено `pinning`, в правой зоне иконок контрл-блока автоматически появляется нативная кнопка-иконка (пин + шеврон) — быстрый доступ к закреплению выбранных колонок, дополняющий Aside-панель. Задаётся через `controlBlock.pinningMenu`.\n\n- Фича **нативная**: появляется сама при активном `pinning`, отдельно включать не нужно. Отключается `controlBlock.pinningMenu.enable: false`.\n- **Размеры** завязаны на размер контрл-блока (`controlBlock.size`) — в компактном (`xs`) ужимается вместе с остальными иконками.\n- Участвует в **компрессии**: при нехватке места уезжает в overflow-меню `…` вложенным подменю.\n\nПункты меню:\n\n- **Стандартные (из коробки):** «Открепить всё» и «Закрепить столбцы».\n- **Свои пункты** — через `pinningMenu.items` (напр. «Закрепить строки», «Закрепить шапку»). Порядок задаётся `order` (у нативных: `Открепить всё` = 100, `Закрепить столбцы` = 200), разделитель после пункта — `dividerAfter`. Совпадение `value` с нативным = переопределение.\n- Состояние и иконку продуктовых пунктов **контролирует продукт** (иконка — `ReactNode` или функция от `rowSize`, может отражать состояние).\n\nЛевая иконка (кнопка-действие):\n\n- Синеет, когда среди **видимых** колонок есть хотя бы одна закреплённая (скрыли видимость закреплённой — снова обычный цвет).\n- Tooltip и действие зависят от выделения: нет выделения — подсказка выбрать колонки; выбраны незакреплённые — «Закрепить»; выбраны только закреплённые — «Открепить».\n- После закрепления выделение **переезжает** за колонками (закреплённые уезжают влево), соседние сливаются без разделителей.\n- Клик по действию закрепления **без выделенных колонок** шлёт событие в `tableConfig.notifications` (`type: 'pin'`, `code: 'no-selection'`) — продукт показывает свою подсказку. Подробнее — в разделе [Notifications](?path=/docs/локальные-компоненты-tablecanvas-notifications--docs).\n\nПример добавления своих пунктов — в стори «ColumnsControl: доп. пункты меню закрепления».\n\n> Подробнее о типах и пропсах — [ColumnsControl API](?path=/docs/локальные-компоненты-tablecanvas-columnscontrol-api--docs)",
|
|
49912
|
+
"apiDocs": "# ColumnsControl API\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```\n\n## HiddenColumnsIndicatorExpandInfo\n\nДанные, которые приходят в колбэк `onHiddenColumnsIndicatorExpand` при раскрытии промежутка двойным кликом по индикатору скрытых столбцов.\n\n```typescript\ntype HiddenColumnsIndicatorExpandInfo = {\n /** Ключи скрытых столбцов, которые раскрываются (весь промежуток за линией). */\n keys: string[];\n /** Видимый сосед слева от линии. undefined, если линия у левого края таблицы. */\n leftKey?: string;\n /** Видимый сосед справа от линии. undefined, если линия у правого края таблицы. */\n rightKey?: string;\n};\n```\n\n## PinningMenuConfig\n\nМеню закрепления в контрл-блоке (`controlBlock.pinningMenu`). Появляется, когда включено `columnsControl.pinning`.\n\n```typescript\ntype PinningMenuConfig = {\n /**\n * Явное вкл/выкл фичи.\n * @default columnsControl.pinning\n */\n enable?: boolean;\n /**\n * Продуктовые пункты меню — мёржатся с нативными (override по value,\n * сортировка по order).\n */\n items?: PinningMenuItem[];\n /**\n * DomMetadata левой кнопки-иконки закрепления. Её `dataAttributes`\n * навешиваются на кнопку-иконку (data-атрибуты для e2e-тестов, аналитики и\n * онбординга — поиск элемента в DOM). Пример:\n * `{ dataAttributes: { 'data-testid': 'pinning-icon' } }`.\n */\n iconDomMetadata?: DomMetadata;\n};\n```\n\n## PinningMenuItem\n\nПункт меню закрепления — нативный или добавленный продуктом.\n\n```typescript\ntype PinningMenuItem = {\n /**\n * Уникальный ключ пункта. Совпадение с value нативного пункта = override\n * (продуктовые поля перекрывают нативные).\n */\n value: string;\n label: string;\n /**\n * Иконка слева в пункте. Узел рендерится как есть, либо функция (ctx),\n * чтобы подстроить размер под rowSize (в т.ч. внутри overflow-дропдауна\n * при компрессии). Стейт/иконку продуктовых пунктов контролирует продукт.\n */\n icon?: FeatureIconRender;\n /**\n * Действие пункта. У нативных пунктов задаётся таблицей; продукт может\n * переопределить.\n */\n onClick?: () => void;\n /**\n * Порядок в списке (по возрастанию). Нативные: reset=100, pin-columns=200.\n * Пункты без order идут в конец, сохраняя исходный порядок.\n */\n order?: number;\n /**\n * Нарисовать разделитель после пункта.\n * @default false\n */\n dividerAfter?: boolean;\n disabled?: boolean;\n};\n```",
|
|
49121
49913
|
"api": [
|
|
49122
49914
|
{
|
|
49123
49915
|
"typeName": "ColumnsControlConfig",
|
|
49124
|
-
"source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
|
|
49916
|
+
"source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
|
|
49125
49917
|
},
|
|
49126
49918
|
{
|
|
49127
49919
|
"typeName": "HiddenColumnsIndicatorExpandInfo",
|
|
@@ -49143,6 +49935,12 @@
|
|
|
49143
49935
|
"type": "full-code",
|
|
49144
49936
|
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n {\n key: 'id',\n name: 'ID',\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n renderCell(cellInfo) {\n return (\n <Canvas.Button\n id=\"header-tooltip-drag\"\n portalHoverEnabled\n onClick={() => {}}\n >\n 123\n </Canvas.Button>\n );\n },\n },\n {\n key: 'task',\n name: 'Title',\n },\n {\n key: 'priority',\n name: 'Priority',\n },\n {\n key: 'issueType',\n name: 'Issue Type',\n },\n {\n key: 'developer',\n name: 'Developer',\n },\n {\n key: 'tr1',\n name: 'TR',\n },\n {\n key: 'complete',\n name: '% Complete',\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 700 },\n columnsControl: {\n enable: true,\n hiding: true,\n disableHiding: ['id'],\n pinning: true,\n disablePinning: ['developer'],\n reorderingAside: true,\n reorderingHeader: true,\n columnsLabel: {\n task: 'Задачи',\n },\n orderDefault: ['id', 'issueType', 'task'],\n hiddenDefault: ['tr1'],\n pinnedDefault: ['complete'],\n onConfirm: ({ order, hidden, pinned }, _setters) => {\n // eslint-disable-next-line no-alert\n alert(`\n order: ${order.join(', ')}\n pinned: ${pinned.join(', ')}\n hidden: ${hidden.join(', ')}\n `);\n },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
|
|
49145
49937
|
},
|
|
49938
|
+
{
|
|
49939
|
+
"exportName": "ColumnsControlInstantApply",
|
|
49940
|
+
"displayName": "ID",
|
|
49941
|
+
"type": "full-code",
|
|
49942
|
+
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n const [confirmLog, setConfirmLog] = useState<string[]>([]);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n { key: 'id', name: 'ID' },\n { key: 'task', name: 'Title' },\n { key: 'priority', name: 'Priority' },\n { key: 'issueType', name: 'Issue Type' },\n { key: 'developer', name: 'Developer' },\n { key: 'tr1', name: 'TR' },\n { key: 'complete', name: '% Complete' },\n ],\n [],\n );\n\n return (\n <Box $css={{ display: 'flex', flexDirection: 'column', gap: '8px' }}>\n <Box\n data-testid=\"confirm-log\"\n $css={{\n height: '96px',\n overflowY: 'auto',\n padding: '8px 12px',\n borderRadius: '8px',\n backgroundColor: surfaceTransparentPrimary,\n fontSize: '12px',\n lineHeight: '18px',\n fontFamily: 'monospace',\n whiteSpace: 'pre',\n }}\n >\n {confirmLog.length\n ? confirmLog.join('\\n')\n : 'Вызовы onConfirm: откройте настройки колонок и измените что-нибудь'}\n </Box>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 600 },\n columnsControl: {\n enable: true,\n applyMode: 'instant',\n disableHiding: ['id'],\n disablePinning: ['developer'],\n hiddenDefault: ['tr1'],\n pinnedDefault: ['complete'],\n onConfirm: ({ order, hidden, pinned, changed }) => {\n setConfirmLog((prev) => [\n [\n `#${prev.length + 1} изменилось: ${Object.keys(\n changed,\n ).join(', ')}`,\n ` order: ${order.join(', ')}`,\n ` pinned: ${pinned.join(', ')}`,\n ` hidden: ${hidden.join(', ')}`,\n ].join('\\n'),\n ...prev,\n ]);\n },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </Box>\n );\n }"
|
|
49943
|
+
},
|
|
49146
49944
|
{
|
|
49147
49945
|
"exportName": "ColumnsControlDynamicColumn",
|
|
49148
49946
|
"displayName": "ColumnsControl: динамическое добавление колонки",
|
|
@@ -49229,7 +50027,7 @@
|
|
|
49229
50027
|
"exportName": "Playground",
|
|
49230
50028
|
"displayName": "Группировка (squash)",
|
|
49231
50029
|
"type": "full-code",
|
|
49232
|
-
"code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n const [squash, setSquash] = useState(true);\n\n const columnConfig = useMemo<ColumnOrColumnGroupConfig<Row>[]>(\n () => [\n // Одиночная колонка без группы: при squash её шапка тянется вверх.\n {
|
|
50030
|
+
"code": "import {\n Canvas,\n ColumnOrColumnGroupConfig,\n TableCanvas,\n} from '@daisforge/ui/components/TableCanvas';\n\n() => {\n const [rows] = useState(createRows);\n const [squash, setSquash] = useState(true);\n const filteringStateAndSetter = useState(CLEARED_FILTERS);\n const sortingStateAndSetter = useState<readonly SortColumn[]>([]);\n\n const columnConfig = useMemo<ColumnOrColumnGroupConfig<Row>[]>(\n () => [\n // Одиночная колонка без группы: при squash её шапка тянется вверх.\n {\n key: 'id',\n name: 'ID',\n width: 90,\n resizable: true,\n sortingType: 'numberSort',\n filtering: {\n component: 'input',\n keyInFilterState: 'id',\n valueInRow: (r) => String(r.id),\n filter: 'startWith',\n },\n },\n // Глубокая группа (3 уровня) для реордера.\n {\n key: 'metrics',\n name: 'Показатели',\n children: [\n {\n key: 'sales',\n name: 'Продажи',\n children: [\n { key: 'task', name: 'План', width: 150, resizable: true },\n { key: 'priority', name: 'Факт', width: 130, resizable: true },\n ],\n },\n {\n key: 'grade',\n name: 'Оценка',\n children: [\n { key: 'issueType', name: 'Инд', width: 120, resizable: true },\n { key: 'developer', name: 'Кол', width: 120, resizable: true },\n { key: 'complete', name: 'Итог', width: 120, resizable: true },\n ],\n },\n ],\n },\n // «Мелкая» группа с кастомным canvas-name: при squash тянется вниз\n // (под шапкой нет подгрупп, иначе была бы пустая полоса).\n {\n key: 'pppp',\n name: (\n <Canvas.Container padding={{ left: 8, right: 8 }}>\n <Canvas.Text\n color={tableCanvasTheme.accentColor}\n font={tableCanvasFonts.bodyXSBold}\n >\n кастомный name\n </Canvas.Text>\n </Canvas.Container>\n ),\n children: [\n {\n key: 'tr',\n name: 'TR',\n width: 130,\n resizable: true,\n sortingType: 'stringSort',\n filtering: {\n component: 'input',\n keyInFilterState: 'tr',\n valueInRow: (r) => r.tr,\n filter: 'startWith',\n },\n },\n ],\n },\n ],\n [],\n );\n\n return (\n <div>\n <div\n style={{\n display: 'flex',\n alignItems: 'center',\n gap: 8,\n marginBottom: 12,\n }}\n >\n <Switch\n checked={squash}\n onChange={(e) => setSquash(e.target.checked)}\n label=\"columnsGrouping.squashEmptyCells\"\n />\n </div>\n <TableCanvas\n tableConfig={{\n containerStyle: { height: 340 },\n columnsGrouping: { squashEmptyCells: squash },\n columnsControl: { enable: true },\n resizableColumn: true,\n sorting: { state: sortingStateAndSetter },\n filtering: {\n state: filteringStateAndSetter,\n clearedValue: CLEARED_FILTERS,\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </div>\n );\n }"
|
|
49233
50031
|
},
|
|
49234
50032
|
{
|
|
49235
50033
|
"exportName": "HeaderAlign",
|
|
@@ -49640,7 +50438,7 @@
|
|
|
49640
50438
|
"legacy": false,
|
|
49641
50439
|
"summary": "*tableConfig.\\*.domMetadata**",
|
|
49642
50440
|
"docs": "# DomMetadata\n\n**tableConfig.\\*.domMetadata**\n\nМетки для автоматизированного тестирования, аналитики и онбординга.\n\n`DomMetadata` позволяет навешивать CSS-классы, data-атрибуты и обработчики кликов на интерактивные элементы таблицы.\nЭто нужно для:\n\n- **Аналитики** — трекинг кликов по кнопкам таблицы\n- **Автотестов** — поиск элементов по `data-testid`\n- **Онбординга** — привязка подсказок к конкретным элементам\n\n## Поддерживаемые элементы (className, dataAttributes)\n\nСледующие элементы поддерживают `className` и `dataAttributes` через `domMetadata`:\n\n**Control Block (панель управления):**\n\n- **Редактирование** — `tableConfig.editing.domMetadata`\n- **Полноэкранный режим** — `tableConfig.fullScreenEnabled.domMetadata`\n- **Размер строки** — `tableConfig.rowSize.domMetadata`\n- **Переключение вида** (строки/карточки) — `tableConfig.view.domMetadata`\n- **Группировка строк** — `tableConfig.rowsGrouping.domMetadata`\n- **Поиск** — `tableConfig.searching.domMetadata`\n- **Итоговые строки** — `tableConfig.summaryRows.domMetadata`\n- **KeyText** (controlBlock) — `tableConfig.keyText.controlBlock.domMetadata`\n- **KeyText** (sidebar) — `tableConfig.keyText.sidebar.domMetadata`\n\n**Selecting (выбор строк):**\n\n- **Чекбокс \"Выбрать все\"** (controlBlock) — `tableConfig.selecting.controlBlock.domMetadata`\n- **Свитч в сайдбаре** — `tableConfig.selecting.sidebar.domMetadata`\n\n**Sidebar (правая панель):**\n\n- **Табы сайдбара** — `tableConfig.sidebarConfig.defaultTabs[].domMetadata`\n- **Подтабы настроек** (Фильтры, Столбцы) — `tableConfig.sidebarConfig.defaultTabs[{id:'filtering'|'columns'}].domMetadata`\n\n**Другие:**\n\n- **Кнопка сворачивания таблицы** — `tableConfig.collapse.domMetadata`\n\n## Элементы с расширенным onClick (className, dataAttributes, onClick + detail)\n\nВ дополнение к `className` и `dataAttributes`, следующие элементы поддерживают `onClick` с контекстом `detail`:\n\n- **Группировать** (чекбоксы, сброс) — `tableConfig.rowsGrouping.domMetadata` — actions: `toggle-group`, `reset-groups`, `custom-item-select`\n- **Кнопка размера строки** — `tableConfig.rowSize.domMetadata` — action: `change-row-size`\n- **Шестеренка настроек** — `tableConfig.sidebarConfig.defaultTabs[{id:'tableSettings'}].domMetadata` — action: `toggle-sidebar-tab`\n- **Крестик закрыть сайдбар** — тот же `domMetadata` таба — action: `close-sidebar`\n- **Закрепить столбец** — `tableConfig.columnsControl.pinDomMetadata` — actions: `pin-column`, `unpin-column`\n- **Свитчер видимости столбца** — `tableConfig.columnsControl.switchDomMetadata` — actions: `show-column`, `hide-column`\n\n## onClick\n\nОбработчик `onClick` вызывается **после** основной логики элемента. Он не мешает работе кнопки и не вызывает `stopPropagation`.\n\n```tsx\nonClick?: (\n e?: React.MouseEvent<HTMLElement>, // MouseEvent (undefined для элементов внутри Dropdown)\n detail?: Record<string, unknown> // контекст: action, columnKey, size и др.\n) => void;\n```\n\n### Примеры detail\n\n```ts\n// Группировка\n{ action: 'toggle-group', columnKey: 'status' }\n{ action: 'reset-groups' }\n\n// Размер строки\n{ action: 'change-row-size', size: 'medium' }\n\n// Сайдбар\n{ action: 'toggle-sidebar-tab', tabId: 'tableSettings' }\n{ action: 'close-sidebar' }\n\n// Столбцы\n{ action: 'pin-column', columnKey: 'name' }\n{ action: 'unpin-column', columnKey: 'name' }\n{ action: 'hide-column', columnKey: 'name' }\n{ action: 'show-column', columnKey: 'name' }\n```\n\nПодробнее о типах — в разделе [API](?path=/docs/локальные-компоненты-tablecanvas-dommetadata-api--docs).",
|
|
49643
|
-
"apiDocs": "# DomMetadata API\n\n## DomMetadata\n\n```typescript\ntype DomMetadata = {\n /**\n * CSS класс для стилизации и поиска элемента\n *\n * @example 'user-profile-card'\n * @example 'onboarding-step-1'\n */\n className?: string;\n /**\n * Data-атрибуты для тестирования, аналитики и онбординга\n *\n * @example { 'data-testid': 'submit-button', 'data-analytics': 'click-event' }\n */\n dataAttributes?: DataAttributes;\n /**\n * Обработчик клика для аналитики и трекинга\n *\n * Вызывается вместе с основным обработчиком элемента (не заменяет его).\n * Не вызывает stopPropagation — оригинальная логика кнопки сохраняется.\n *\n * @param e - MouseEvent (может быть undefined для элементов внутри Dropdown)\n * @param detail - контекст действия: action, columnKey, size и др.\n *\n * @example onClick: (e, detail) => analytics.track(detail?.action, detail)\n */\n onClick?: (\n e?: React.MouseEvent<HTMLElement>,\n detail?: Record<string, unknown>,\n ) => void;\n};\n```\n\n## DOM_METADATA_ACTIONS\n\n```typescript\nexport const DOM_METADATA_ACTIONS = {\n /** Включение/выключение группировки по столбцу. detail.columnKey — ключ столбца */\n TOGGLE_GROUP: 'toggle-group',\n /** Сброс всех группировок */\n RESET_GROUPS: 'reset-groups',\n /** Выбор пункта в кастомном onItemSelect группировки. detail.columnKey — ключ */\n CUSTOM_ITEM_SELECT: 'custom-item-select',\n /** Переключение размера строки. detail.size — новый размер ('small' | 'medium' | 'big') */\n CHANGE_ROW_SIZE: 'change-row-size',\n /** Клик по табу сайдбара (шестерёнка и др.). detail.tabId — id таба */\n TOGGLE_SIDEBAR_TAB: 'toggle-sidebar-tab',\n /** Закрытие сайдбара (крестик) */\n CLOSE_SIDEBAR: 'close-sidebar',\n /** Закрепление столбца. detail.columnKey — ключ столбца */\n PIN_COLUMN: 'pin-column',\n /** Открепление столбца. detail.columnKey — ключ столбца */\n UNPIN_COLUMN: 'unpin-column',\n /** Скрытие столбца. detail.columnKey — ключ столбца */\n HIDE_COLUMN: 'hide-column',\n /** Показ столбца. detail.columnKey — ключ столбца */\n SHOW_COLUMN: 'show-column',\n} as const;\n```\n\n## DomMetadataAction\n\n```typescript\ntype DomMetadataAction =\n (typeof DOM_METADATA_ACTIONS)[keyof typeof DOM_METADATA_ACTIONS];\n```\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
|
|
50441
|
+
"apiDocs": "# DomMetadata API\n\n## DomMetadata\n\n```typescript\ntype DomMetadata = {\n /**\n * CSS класс для стилизации и поиска элемента\n *\n * @example 'user-profile-card'\n * @example 'onboarding-step-1'\n */\n className?: string;\n /**\n * Data-атрибуты для тестирования, аналитики и онбординга\n *\n * @example { 'data-testid': 'submit-button', 'data-analytics': 'click-event' }\n */\n dataAttributes?: DataAttributes;\n /**\n * Обработчик клика для аналитики и трекинга\n *\n * Вызывается вместе с основным обработчиком элемента (не заменяет его).\n * Не вызывает stopPropagation — оригинальная логика кнопки сохраняется.\n *\n * @param e - MouseEvent (может быть undefined для элементов внутри Dropdown)\n * @param detail - контекст действия: action, columnKey, size и др.\n *\n * @example onClick: (e, detail) => analytics.track(detail?.action, detail)\n */\n onClick?: (\n e?: React.MouseEvent<HTMLElement>,\n detail?: Record<string, unknown>,\n ) => void;\n};\n```\n\n## DOM_METADATA_ACTIONS\n\n```typescript\nexport const DOM_METADATA_ACTIONS = {\n /** Включение/выключение группировки по столбцу. detail.columnKey — ключ столбца */\n TOGGLE_GROUP: 'toggle-group',\n /** Сброс всех группировок */\n RESET_GROUPS: 'reset-groups',\n /** Выбор пункта в кастомном onItemSelect группировки. detail.columnKey — ключ */\n CUSTOM_ITEM_SELECT: 'custom-item-select',\n /** Переключение размера строки. detail.size — новый размер ('small' | 'medium' | 'big') */\n CHANGE_ROW_SIZE: 'change-row-size',\n /** Клик по табу сайдбара (шестерёнка и др.). detail.tabId — id таба */\n TOGGLE_SIDEBAR_TAB: 'toggle-sidebar-tab',\n /** Закрытие сайдбара (крестик) */\n CLOSE_SIDEBAR: 'close-sidebar',\n /** Закрепление столбца. detail.columnKey — ключ столбца */\n PIN_COLUMN: 'pin-column',\n /** Открепление столбца. detail.columnKey — ключ столбца */\n UNPIN_COLUMN: 'unpin-column',\n /** Скрытие столбца. detail.columnKey — ключ столбца */\n HIDE_COLUMN: 'hide-column',\n /** Показ столбца. detail.columnKey — ключ столбца */\n SHOW_COLUMN: 'show-column',\n} as const;\n```\n\n## DomMetadataAction\n\n```typescript\ntype DomMetadataAction =\n (typeof DOM_METADATA_ACTIONS)[keyof typeof DOM_METADATA_ACTIONS];\n```\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
|
|
49644
50442
|
"api": [
|
|
49645
50443
|
{
|
|
49646
50444
|
"typeName": "DomMetadata",
|
|
@@ -49656,7 +50454,7 @@
|
|
|
49656
50454
|
},
|
|
49657
50455
|
{
|
|
49658
50456
|
"typeName": "ColumnsControlConfig",
|
|
49659
|
-
"source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
|
|
50457
|
+
"source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
|
|
49660
50458
|
}
|
|
49661
50459
|
],
|
|
49662
50460
|
"stories": [
|
|
@@ -49673,17 +50471,25 @@
|
|
|
49673
50471
|
"feature": "Editing",
|
|
49674
50472
|
"legacy": false,
|
|
49675
50473
|
"summary": "*tableConfig.editing + columnConfig.editingCell**",
|
|
49676
|
-
"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```",
|
|
49677
|
-
"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```",
|
|
49678
50476
|
"api": [
|
|
49679
50477
|
{
|
|
49680
50478
|
"typeName": "EditingConfig",
|
|
49681
|
-
"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};"
|
|
49682
50480
|
},
|
|
49683
50481
|
{
|
|
49684
50482
|
"typeName": "EditingButtonProps",
|
|
49685
50483
|
"source": "type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;"
|
|
49686
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
|
+
},
|
|
49687
50493
|
{
|
|
49688
50494
|
"typeName": "EditingCellInfo",
|
|
49689
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};"
|
|
@@ -49707,6 +50513,12 @@
|
|
|
49707
50513
|
"displayName": "Блок",
|
|
49708
50514
|
"type": "full-code",
|
|
49709
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 '@daisforge/ui/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: \\"
|
|
49710
50522
|
}
|
|
49711
50523
|
]
|
|
49712
50524
|
},
|
|
@@ -49836,11 +50648,11 @@
|
|
|
49836
50648
|
"legacy": false,
|
|
49837
50649
|
"summary": "*tableConfig.filtering**",
|
|
49838
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)",
|
|
49839
|
-
"apiDocs": "# Filtering API\n\n## FilteringConfig\n\n```typescript\ntype FilteringConfig<T> = {\n state: [T, React.Dispatch<React.SetStateAction<T>>];\n /**\n * @deprecated Использовать filtersInfo\n *\n * clearedValue - состояние фильтров после очистки. Используется для сравнения:\n * Например, был ли фильтр конкретной колонки изменен рассчитывается посредством сравнения текущего значения фильтра и значения фильтра в clearedValue.\n * Если они равны, то фильтр считается не измененным.\n */\n clearedValue?: T;\n /**\n * Информация о фильтрах для каждой колонки.\n * Используется для:\n * 1. Хранения меток (label) фильтров для отображения в UI\n * 2. Хранения значений по умолчанию (clearedValue) для каждого фильтра\n * 3. Определения, был ли фильтр изменен (сравнение текущего значения с clearedValue)\n */\n filtersInfo?: Record<\n keyof T,\n {\n label: string;\n clearedValue: T[keyof T];\n }\n >;\n /**\n * manualFiltering - пропс, активирующий ручную-кастомную (или на стороне бэка) фильтрацию.\n * @remarks\n * Для автоматической фильтрации (когда не используется manualFiltering в tableConfig):\n * - Для всех типов фильтров обязательно должен быть указан `valueInRow`\n * - Для component: 'select' дополнительно должен быть указан `filteringType`\n * - Для component: 'input' с кастомным фильтром (когда filter - функция)\n * функция фильтрации должна быть передана явно\n *\n * Если используется manualFiltering, эти параметры не обязательны,\n * так как вся логика фильтрации реализуется извне.\n */\n manualFiltering?: boolean;\n /**\n * Конфигурация для отображения фильтров в правом сайдбаре.\n *\n * Позволяет:\n * 1. Добавлять глобальные фильтры (не привязанные к конкретной колонке)\n * 2. Управлять порядком отображения фильтров\n * 3. Переопределять рендер и заголовки колоночных фильтров\n *\n * Логика работы:\n * - По умолчанию в сайдбаре отображаются все колоночные фильтры (из columnConfig)\n * - Ключом фильтра считается `key` колонки, если его нет, то пытаемся взять `keyInFilterState` (если указан), иначе это не будет работать\n * - Заголовком фильтра по умолчанию является `name` колонки или ключ фильтра (name || key)\n * - Глобальные фильтры добавляются через `items` с уникальными ключами\n *\n * Особенности:\n * 1. Порядок отображения:\n * - Сначала фильтры из `order` (в указанной последовательности)\n * - Затем остальные колоночные фильтры (в порядке columnConfig)\n * - В конце - глобальные фильтры (в алфавитном порядке ключей)\n *\n * 2. Переопределение колоночных фильтров:\n * - Чтобы изменить заголовок: укажите ключ колонки в `items` с новым `label`\n * - Чтобы заменить рендер: укажите ключ колонки с `customRenderFn`\n * - Оригинальный фильтр из колонки будет проигнорирован\n *\n * 3. Глобальные фильтры:\n * - Ключ не должен совпадать с ключами колонок\n * - Обязательно указать `label` и `customRenderFn`\n * - Отображаются после всех колоночных фильтров, если не переопределены в order\n *\n * @example\n * // Добавление глобального фильтра и изменение порядка\n * sidebarConfig: {\n * order: ['status', 'tasks', 'type'], // Сначала статус, затем глобальный поиск\n * items: {\n * tasks: { // Уникальный ключ\n * label: 'Поиск по всем полям',\n * customRenderFn: () => <TaskComponent />\n * },\n * status: { // Переопределение колоночного фильтра\n * label: 'Статус заявки', // Новый заголовок\n * customRenderFn: () => <CustomStatusFilter /> // Кастомный рендер\n * }\n * type: { // Переопределение только Label колоночного фильтра\n * label: 'Тип', // Новый заголовок\n * }\n * }\n * }\n */\n sidebarConfig?: {\n /**\n * Определяет порядок отображения фильтров.\n * - Указываются ключи фильтров (колоночных или глобальных)\n * - Не указанные в order фильтры отображаются после\n * - Если order пуст, сохраняется порядок: глобальные фильтры + columnConfig фильтры в конце\n */\n order?: string[];\n /**\n * Конфигурация фильтров для сайдбара.\n * Ключом может быть:\n * - Ключ колонки (для переопределения колоночного фильтра)\n * - Уникальный ключ (для добавления глобального фильтра)\n */\n items: Partial<\n Record<\n keyof T,\n {\n /** Заголовок фильтра (обязателен для глобальных фильтров), можно использовать для переопределения для локальных фильтров */\n label: string;\n /**\n * Функция рендера компонента фильтра.\n * Для колоночных фильтров переопределяет оригинальный рендер.\n * Для глобальных фильтров обязательна.\n */\n customRenderFn?: (\n filters: T,\n setFilters: React.Dispatch<React.SetStateAction<T>>,\n ) => React.ReactNode;\n }\n >\n >;\n };\n /**\n * Callback для кастомизации стилей чипсов (фильтров) в списке\n *\n * @param {ItemOrGroup} itemOrGroup - Текущий элемент или группа фильтров\n * @param {Item | undefined} item - Конкретный элемент фильтра (если есть)\n * @returns {CSSObject} Объект стилей, который будет применен к чипсу\n *\n * @description\n * Позволяет динамически задавать стили для каждого чипса в зависимости от его типа и содержимого.\n * Вызывается для каждого отображаемого чипса (как для отдельных элементов, так и для элементов внутри групп).\n *\n * @example\n * // Пример 1: Стилизация чипсов по типу\n * chipStyle: (itemOrGroup, item) => {\n * if (isGroup(itemOrGroup)) {\n * return { backgroundColor: '#f0f0f0' };\n * }\n * return { backgroundColor: '#e0e0e0' };\n * }\n *\n * @example\n * // Пример 2: Стилизация по значению фильтра\n * chipStyle: (itemOrGroup, item) => {\n * if (item?.label === 'Высокий приоритет') {\n * return {\n * backgroundColor: '#ffebee',\n * color: '#d32f2f'\n * };\n * }\n * return {};\n * }\n *\n * @example\n * // Пример 3: Разные стили для элементов в группе и одиночных\n * chipStyle: (itemOrGroup, item) => {\n * if (item) {\n * // Стиль для элемента внутри группы\n * return { maxWidth: 180 };\n * }\n * // Стиль для одиночного чипа\n * return { maxWidth: 150 };\n * }\n */\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n /**\n * Пользовательский форматтер заголовка группы чипсов.\n *\n * Используется в блоке активных фильтров для подмены текста заголовка\n * группы (например, “Статус”, “Тип”, “Автор”). Полезно, когда нужно\n * динамически менять подпись (добавить счётчик, i18n и т.п.).\n *\n * @param {ItemOrGroup} itemOrGroup Объект группы (тип Group). Вызов происходит только для групп,\n * поэтому безопасно кастовать к Group.\n * @returns {string} Текст заголовка группы чипсов.\n *\n * @default Возвращается `group.groupLabel`.\n *\n * @remarks\n * - Функция должна быть чистой и быстрой (без сетевых запросов и побочных эффектов).\n * - Возвращайте ТОЛЬКО строку — чипы отображают текстовое значение.\n * - Для длинных строк применяется усечение (overflow с многоточием) на уровне компонента.\n *\n * @example\n * // Добавить двоеточие и количество выбранных элементов\n * renderGroupLabel: (group) => `${group.groupLabel}: ${group.items.length}`\n *\n * @example\n * // Локализация заголовка группы\n * const i18n = { status: 'Статус', type: 'Тип' };\n * renderGroupLabel: (group) => i18n[group.groupId] ?? group.groupLabel\n */\n renderGroupLabel?: (group: Group) => string;\n\n /**\n * Пользовательский форматтер текста чипса (элемента внутри группы или одиночного фильтра).\n *\n * Позволяет управлять тем, что именно отображается внутри каждого чипса. Особенно полезен\n * при серверной пагинации/ленивой загрузке, когда в состоянии фильтра хранится только value,\n * а label необходимо подставить из локального кэша.\n *\n * @param {Group | null } group Группа, внутри которой рендерится чип (или null).\n * @param {Item} item Сам элемент чипса. В группах передаётся конкретный `Item`,\n * для одиночного чипа может быть `undefined`.\n * @returns {string} Текст, который будет показан в чипсе.\n *\n * @default Используется `item?.label.toString()` (или строковое представление value).\n *\n * @remarks\n * - Функция должна быть чистой и быстрой;\n * - Возвращайте ТОЛЬКО строку.\n *\n * @example\n * // 1) Отображение label из кэша при серверной пагинации\n * const labelsCacheRef = useRef(new Map<string, string>());\n * renderChipLabel: (group, item) => {\n * if (item?.id != null) {\n * const key = String(item.id);\n * const fromCache = labelsCacheRef.current.get(key);\n * if (fromCache) return fromCache; // красивый label, если уже загрузили\n * return String(item.label ?? key); // фоллбэк: временно показываем value/label из item\n * }\n * return ''; // безопасный фоллбэк для одиночных случаев\n * }\n *\n * @example\n * // 2) Нормализация отображения числовых значений\n * renderChipLabel: (_group, item) => {\n * const v = Number(item?.label);\n * return Number.isFinite(v) ? v.toLocaleString('ru-RU') : String(item?.label ?? '');\n * }\n *\n * @example\n * // 3) Префикс по типу группы\n * renderChipLabel: (group, item) => {\n * const prefix = group.groupId === 'status' ? '' : '#';\n * return `${prefix}${item?.label ?? item?.id ?? ''}`;\n * }\n */\n renderChipLabel?: (group: Group | null, item: Item) => string;\n};\n\nexport type DefaultSidebarTabIds = 'columns' | 'tableSettings' | 'filtering';\n\n/**\n * Общие настройки пользовательских вкладок левой и правой панели TableCanvas.\n */\nexport type TableCanvasSidebarConfig = {\n /**\n * Включен ли sidebar. Отвечает только за UI. Не влияет на перерасчёт фичей.\n * @default true\n */\n enabled?: boolean;\n /**\n * Открыт ли sidebar при первом рендере (uncontrolled-режим).\n * Игнорируется, если передан openState.\n * @default false\n */\n defaultOpen?: boolean;\n /**\n * Внешний контроль открытия/закрытия sidebar.\n * Если передан — источник истины, defaultOpen игнорируется.\n */\n openState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * id вкладки, выбранной по умолчанию (актуально при открытом сайдбаре).\n * Если id не найден или у вкладки showInSidebar=false — используется первая доступная.\n */\n defaultActiveTabId?: string;\n /**\n * Внешний контроль активной вкладки (controlled-режим).\n * Если передан — источник истины, defaultActiveTabId игнорируется.\n */\n activeTabState?: [\n string | null,\n React.Dispatch<React.SetStateAction<string | null>>,\n ];\n /**\n * Колбэк смены активной вкладки. Вызывается и в uncontrolled-режиме.\n * При закрытии сайдбара приходит null.\n */\n onActiveTabChange?: (tabId: string | null, tab?: SidebarTab) => void;\n /**\n * Кастомные табы\n */\n customTabs?: Array<\n Omit<SidebarTab, 'id'> & {\n id: Exclude<string, DefaultSidebarTabIds>;\n }\n >;\n /**\n * Порядок отображения кастомных вкладок\n */\n customTabsOrder?: Array<Exclude<string, DefaultSidebarTabIds>>;\n /**\n * Ширина контента без полоски вкладок (44px). Число — px, строка — CSS.\n * Проценты считаются от ширины рабочей области TableCanvas.\n * Изменение пропса сразу меняет ширину открытой панели.\n * По умолчанию: 300px слева, 400px справа.\n */\n width?: string | number;\n};\n\n/** Настройки правой панели; встроенные вкладки доступны только справа. */\nexport type SidebarConfig = TableCanvasSidebarConfig & {\n defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара (если данный таб окажется единственным табом в настройках) */\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки (для табов с id = filtering и columns - недоступен. Настраивается через таб с id='tableSettings') */\n iconTooltipText?: undefined;\n }\n | {\n id: 'tableSettings';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара */\n title?: string;\n\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный слот для вкладки tableSettings (рендерится после общих настроек)\n * Только дл id: 'tableSettings'\n */\n customGeneralSettingsSlot?: React.ReactNode;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки @default 'Настройки' */\n iconTooltipText?: string;\n }\n >;\n};\n\n/** Конфигурация правой панели. SidebarConfig сохранён для совместимости. */\nexport type RightSidebarConfig = SidebarConfig;\n\n/** Пользовательские вкладки слева; встроенных вкладок настроек нет. */\nexport type LeftSidebarConfig = TableCanvasSidebarConfig;\n\n/** Нижний слот под canvas, над пагинацией, между боковыми панелями. */\nexport type BottomSheetConfig = {\n /** @default true */\n enabled?: boolean;\n /** Число — px, строка — CSS; 'auto' — по содержимому. Проценты — от рабочей области. @default 32 */\n height?: string | number;\n /** Минимальная высота, ограниченная доступным пространством. @default 32 */\n minHeight?: string | number;\n /** Максимальная высота в px или CSS, дополнительно ограниченная доступным пространством. */\n maxHeight?: string | number;\n /** Пользователь управляет содержимым и раскрытием; при height: 'auto' панель прокручивается сама. */\n content: React.ReactNode;\n};\n\nexport function activeViewIs<T extends 'cards' | 'rows'>(\n checkType: T,\n viewState: 'cards' | 'rows',\n view: View,\n): view is ViewMods[T] {\n return checkType === viewState;\n}\n\n/** Размер controlBlock: 'm' и 's' — одинаковые стили, 'xs' — уменьшенный */\nexport type ControlBlockSize = 'm' | 's' | 'xs';\n\nexport type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * Размер controlBlock и его элементов (кнопки, иконки, поиск, отступы).\n * 'm' и 's' — стандартные стили, 'xs' — компактный режим.\n * Не влияет на customFeatures и кастомные слоты — они контролируются разработчиком.\n * @default 'm'\n */\n size?: ControlBlockSize;\n /**\n * @deprecated Используйте кастомные кнопки через rightSideInner или customFeatures.\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока.\n * Продолжает работать для обратной совместимости.\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * customFeatures - пропс для добавления кастомных фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\n /**\n * pinningMenu - нативная фича закрепления столбцов (SplitIconButton с\n * дропдауном) в правой зоне иконок. Появляется, когда активировано\n * закрепление колонок (columnsControl.pinning). Продукт может донастроить\n * и дополнить пункты меню (см. PinningMenuConfig).\n */\n pinningMenu?: PinningMenuConfig;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты левые фичи при адаптивной компрессии\n */\n leftSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты правые фичи при адаптивной компрессии\n */\n rightSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Активна ли фича компрессии (сжатие ToolsMenu при адаптиве)\n * @default true\n */\n enableAdaptiveCompress?: boolean;\n /**\n * Панель массовых действий\n */\n massActionPanel?: {\n /**\n * Кнопки панели. Размеры кнопок/дропдаунов панель подбирает сама (по `size` панели и компактности) —\n * передавать `size` кнопкам не нужно. Если `size` на кнопке всё же задан — он используется как есть.\n */\n buttons: MassActionButtonProps[];\n /**\n * Пропсы для Dropdown, в который сжались кнопки\n */\n collapsedDropdownProps?: TableDropdownConfigProps;\n /**\n * Отступ панели снизу от контейнера (px)\n * @default 24\n */\n bottom?: number;\n /**\n * Управление отображением панели массовых действий.\n * - `undefined` (по умолчанию) — стандартное поведение (показывается при selecting + выбранных строках)\n * - `false` — панель не рендерится, разработчик управляет действиями самостоятельно\n * - `true` — панель показывается всегда, даже без активного selecting и выбранных строк\n */\n show?: boolean;\n /**\n * Размерная сетка панели внутри таблицы: `m`/`s` — обычный размер, `xs` — уменьшенный (кнопки `xxs`, «ещё» `xs`, счётчик Body XS).\n * Viewport-логика (1280) в таблице не используется.\n * @default 's'\n */\n size?: MassActionsSize;\n };\n};\n\n/** Пропсы кнопки редактирования. onClick исключён — используйте onSave/onCancel/onEnableEditing. */\nexport type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n\nexport type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n\nexport type SummaryRowsConfig = {\n showDefault: boolean;\n showInControl: boolean;\n /**\n * callback при переключении тогла «Итоговые строки» в настройках таблицы.\n * Вызывается только по действию пользователя (не при монтировании),\n * поэтому подходит для сохранения выбора, например, в localStorage.\n * Сохранённое значение передавайте обратно в `showDefault`.\n */\n onChange?: (checked: boolean) => void;\n} & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\n/**\n * Конфиг тултипа при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\nexport type TableConfigTooltip = {\n /**\n * Включить/выключить колоночные и кастомные тултипы (cellTooltip, headerCellTooltip).\n * Внутренние тултипы (drag-иконка в шапке и другие по nodeId) работают всегда.\n * @default false\n */\n enabled?: boolean;\n /** Глобальная задержка перед показом тултипа (мс). Per-node переопределяет. @default 500 */\n mouseEnterDelay?: number;\n /** Глобальная задержка перед скрытием тултипа (мс). Per-node переопределяет. @default 0 */\n mouseLeaveDelay?: number;\n /**\n * Минимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n minWidth?: number | string;\n /**\n * Максимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n maxWidth?: number | string;\n};\n\nexport type InfinityScrollConfig<RowType extends ObjectForExtending> = {\n /** Триггер достижения скроллом зоны подгрузки данных. */\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n /** Состояние загрузки (скелетоны) новых строк. */\n isLoading: boolean;\n /**\n * Флаг, когда все данные загружены — false.\n * @default true\n */\n hasMore?: boolean;\n /**\n * Для mode='region': за сколько строк до конца триггерить загрузку.\n * @default 5\n */\n rowThreshold?: number;\n};\n\nexport type { TableCanvasEmptyStateConfig, TableCanvasErrorStateConfig };\n\n/**\n * Настройка выделения ячеек/колонок/строк в TableCanvas — единый объект.\n * Это отдельная ось взаимодействия — не зависит от `highlightActiveType`.\n */\nexport type CellsSelectionConfig = {\n /**\n * Режим фактического выделения ячеек (нативный glide selection). По нему\n * работают copy/paste, рамка, fill-handle и затемнение шапки/нумерации.\n * @default \"range-cell\"\n */\n mode?: CellsSelectionMode;\n /**\n * Выделение колонок по клику на шапку. Ctrl/Cmd — добавить/убрать колонку,\n * Shift — диапазон колонок. Клик по иконкам сортировки/фильтрации в шапке\n * выделение НЕ вызывает. Поддерживает copy/paste по выделенным колонкам.\n * @default true\n */\n enableColumnSelection?: boolean;\n /**\n * Выделение строк по клику/драгу на колонке нумерации (`rowMarkers`).\n * Ctrl/Cmd — несмежный выбор отдельных строк, драг — смежный диапазон.\n * Поддерживает copy/paste по выделенным строкам. Требует включённой колонки\n * нумерации (`rowMarkers`). При `false` клик по нумерации ничего не выделяет.\n * @default true\n */\n enableRowSelection?: boolean;\n /**\n * Выделение всей таблицы кликом по «нулевой» ячейке — шапке колонки нумерации\n * (левый верхний угол). Выделяет все строки данных по всем колонкам одним\n * диапазоном; поддерживает copy/paste. Требует включённой колонки нумерации\n * (`rowMarkers`) и активного `mode` (≠ `disabled`).\n * @default true\n */\n enableSelectAll?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — он внутренний.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n};\n\n/** Один объединённый блок: какие строки и колонки слить. */\nexport type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n\n/**\n * Видимость сторон рамки ячейки: true рисовать, false не рисовать, не задано -\n * работает уровень ниже (настройка колонки, строки или общая).\n */\nexport type CellBorderVisibility = {\n top?: boolean;\n right?: boolean;\n bottom?: boolean;\n left?: boolean;\n};\n\n/**\n * Управление рамками (линиями) таблицы: включение и выключение. Уровни, от\n * слабого к сильному: общие настройки (vertical, horizontal), затем колонка\n * (getVerticalBorder) и строка (getHorizontalBorder), затем ячейка\n * (getCellBorder).\n */\nexport type BordersConfig<RowType = ObjectForExtending> = {\n /** Рисовать ли вертикальные линии между колонками. @default true */\n vertical?: boolean;\n /** Рисовать ли горизонтальные линии между строками тела. @default true */\n horizontal?: boolean;\n /**\n * Точечное управление вертикальной линией справа от колонки (разделитель\n * после неё). Вернуть true или false, чтобы переопределить общую настройку\n * vertical, или undefined, чтобы оставить её. Зовётся на каждую видимую\n * колонку при перерисовке, поэтому функция должна быть быстрой.\n */\n getVerticalBorder?: (params: {\n /** Ключ колонки, справа от которой рисуется линия. */\n columnKey: string;\n /** Индекс колонки в порядке отрисовки (закреплённые в начале). */\n columnIndex: number;\n }) => boolean | undefined;\n /**\n * Точечное управление горизонтальной линией сверху строки. Вернуть true или\n * false, чтобы переопределить общую настройку horizontal, или undefined,\n * чтобы оставить её. Для summary-строк не вызывается. Зовётся на каждую\n * видимую строку при перерисовке, поэтому функция должна быть быстрой.\n */\n getHorizontalBorder?: (params: {\n /** Строка под линией (линия рисуется сверху этой строки). */\n row: RowType;\n /** Индекс строки среди отображаемых. При раскрытии subRows индексы сдвигаются. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => boolean | undefined;\n /**\n * Стороны рамки конкретной ячейки, вкл и выкл. Для ячеек без переопределений\n * возвращать undefined. Включает отрисовку линий с разбивкой по ячейкам,\n * поэтому функция должна быть быстрой: без тяжёлых вычислений и с готовыми\n * объектами-константами вместо новых на каждый вызов. Для summary-строк не\n * вызывается.\n */\n getCellBorder?: (params: {\n /** Индекс колонки среди отображаемых (без служебных). */\n col: number;\n /** Ключ колонки. */\n columnKey: string | undefined;\n /** Строка ячейки. */\n row: RowType;\n /** Индекс строки среди отображаемых. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => CellBorderVisibility | undefined;\n};\n\nexport type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@daisforge/ui';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n };\n /**\n * editing - активация редактирования. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={editing: {onRowsChange, rowKeyGetter}}\n *\n * columnConfig=[{editingCell: {...}}]\n */\n editing?: EditingConfig<RowType, RowIdType, SummaryRowType>;\n\n /**\n * cellTransfer — конфигурация копирования, вставки и fill handle.\n * По умолчанию копирование (Ctrl+C) работает в режиме редактирования.\n * Данные копируются в формате TSV (tab-separated values), совместимом с Excel.\n *\n * Пример:\n *\n * tableConfig={{ cellTransfer: { enabled: true, onBeforeCopy: (data) => data } }}\n */\n cellTransfer?: CellTransferConfig;\n\n /**\n * Объединение ячеек тела таблицы.\n *\n * mergeByCellValues — колонки, в которых подряд идущие одинаковые значения\n * сливаются в один блок (по вертикали). Границы блоков таблица считает сама из\n * данных; сортировка и фильтр их пересобирают. Данные не меняются — значение и\n * так повторяется в строках, объединение лишь показывает его одной ячейкой.\n *\n * mergedCellsRegions — список блоков, заданных снаружи (как выделение): каждый\n * блок описан ключами строк (rowKeys) и колонок (colKeys). Нужен rowKeyGetter.\n * Если после сортировки или скрытия колонок строки/колонки блока перестали идти\n * подряд — блок не рисуется. Важнее mergeByCellValues.\n *\n * Примеры: mergeCells={{ mergeByCellValues: ['dept', 'role'] }},\n * mergeCells={{ mergedCellsRegions, rowKeyGetter: (r) => r.id }}.\n */\n mergeCells?: {\n mergeByCellValues?: Array<\n string | { colKey: string; value: (row: RowType) => unknown }\n >;\n /** Список блоков, заданных снаружи (по ключам строк и колонок). */\n mergedCellsRegions?: MergedCellsRegion[];\n /**\n * Нужен для mergedCellsRegions: находит строку по её ключу. Должна быть\n * стабильной функцией; менять её на лету не нужно — в пересборку таблицы она\n * не входит.\n */\n rowKeyGetter?: (row: RowType) => string | number;\n /**\n * Выравнивание по умолчанию для всех блоков. Колоночный mergedCellsAlign и\n * выравнивание конкретного региона важнее.\n */\n mergedCellsAlign?: MergedCellsAlign;\n };\n\n /**\n * Модуль нотификаций: стандартизированный канал событий для внешних\n * потребителей. Таблица UI не рисует — вызывает `onNotification`, потребитель\n * показывает тост/модалку на своей стороне. Сейчас эмитятся ошибки copy/paste\n * (в т.ч. multi-range 2D-разброс, readonly/overflow-abort, пропуск валидацией).\n */\n notifications?: TableNotificationsConfig;\n\n /**\n * subRows - активация иерархии, отображения вложенных строк. Условие активации - наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={subRows: {getSubRows, rowKeyGetter}}\n *\n * columnConfig=[{subRow: {...}}]\n */\n subRows?: SubRows<RowType, RowIdType>;\n /**\n * Столбец с нумерацией строк.\n * Активируется наличием этого свойства. Поддерживает `subRows` любой глубины.\n *\n * @see {@link RowMarkersTableConfig} — полное описание конфигурации и примеры.\n */\n rowMarkers?: RowMarkersTableConfig<RowType>;\n rowsGrouping?: RowsGrouping<RowType, SummaryRowType>;\n\n /**\n * resizableColumn - активация изменения ширины колонки с помощью курсора. Условие активации - resizableColumn: true. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={resizableColumn: true}\n *\n * columnConfig=[{resizable: true}]\n */\n resizableColumn?: boolean;\n /**\n * style - inline-стили. Для стилей самой таблицы (без вложенности).\n *\n * Исключены свойства 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'. Их следует стилизовать через свойства containerStyle.\n */\n style?: Omit<\n CSSProperties,\n 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'\n >;\n /**\n * css - для стилей простых и сложных(например, для стилизации cell, headerCell, ...).\n *\n * Пример:\n *\n * ```css\n * & > .rdg-header-row > .rdgCell {\n * background-color: red;\n * }\n * ```\n *\n */\n css?: string | CSSObject;\n\n summaryRows?: SummaryRowsConfig;\n /**\n * controlBlock - пропс для активации, кастомизации контролблока.\n */\n controlBlock?: ControlBlockConfig;\n /**\n * containerStyle - инлайновые стили контейнера таблицы и контролблока. высоту и ширину для таблицы рекомендуется задавать в этом пропсе.\n * Пример:\n *\n * ```tsx\n tableConfig={{ containerStyle: { height: '70vh' } }}\n * ```\n */\n containerStyle?: CSSProperties | undefined;\n /**\n * containerCss - стили для контейнера таблицы и контролблока.\n * Через этот пропс можно дополнительно кастомизировать контейнер и все его дочерние элементы.\n */\n containerCss?: string | CSSObject | undefined;\n /**\n * containerId - html-атрибут id контейнера таблицы.\n */\n containerId?: string | undefined;\n\n /**\n * unstickyHeader - откреплённая шапка. Header уезжает вместе со скроллом контента.\n * @default false\n */\n unstickyHeader?: boolean;\n\n /**\n * stickyColumns - колонки, которые прилипают к левому краю при горизонтальной прокрутке,\n * как `position: sticky`. Ключи колонок или предикат по колонке.\n *\n * ```tsx\n * tableConfig={{ stickyColumns: ['region', 'total'] }}\n * tableConfig={{ stickyColumns: (column) => column.key.startsWith('total') }}\n * ```\n */\n stickyColumns?: StickyColumnsConfig<ColumnConfig<RowType, SummaryRowType>>;\n\n /**\n * stickyRows - строки, которые прилипают под шапкой при вертикальной прокрутке.\n * Предикат проверяется для каждой отображаемой строки данных (результаты кешируются); строки групп\n * (`rowsGrouping`) и заглушки загрузки в него не попадают и липкими не становятся.\n * Индексы передаются как есть — удобно для больших таблиц, где позиции известны заранее. Они\n * считаются по итоговому отображаемому списку: сортировка, фильтры, группировка и раскрытые узлы\n * дерева (`subRows`) сдвигают нумерацию — тогда индексы нужно пересчитывать или передать предикат.\n *\n * ```tsx\n * tableConfig={{ stickyRows: (row) => row.isSubtotal }}\n * tableConfig={{ stickyRows: [0, 41, 82] }}\n * ```\n */\n stickyRows?: StickyRowsConfig<RowType>;\n\n /** Тултип при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\n tooltip?: TableConfigTooltip;\n\n /**\n * infinityScroll - бесконечная подгрузка данных при скролле.\n *\n * Условие активации - наличие самого пропса infinityScroll.\n *\n * При активации infinityScroll отключается дефолтная сортировка и фильтрация.\n * (Предполагается, что если есть infinityScroll,\n * то в таблице представлен не весь объем данных,\n * по этой причине дефолтная сортировка и фильтрация не подходят и будут отображать некорректные данные)\n *\n */\n infinityScroll?: InfinityScrollConfig<RowType>;\n /**\n * @isLoading - состояние загрузки данных для таблицы.\n */\n isLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n /**\n * loadingOverlay - конфигурация для отображения оверлея загрузки.\n * Показывает индикатор загрузки поверх таблицы с возможностью кастомизации.\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 '@daisforge/ui';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n };\n /**\n * editing - активация редактирования. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={editing: {onRowsChange, rowKeyGetter}}\n *\n * columnConfig=[{editingCell: {...}}]\n */\n editing?: EditingConfig<RowType, RowIdType, SummaryRowType>;\n\n /**\n * cellTransfer — конфигурация копирования, вставки и fill handle.\n * По умолчанию копирование (Ctrl+C) работает в режиме редактирования.\n * Данные копируются в формате TSV (tab-separated values), совместимом с Excel.\n *\n * Пример:\n *\n * tableConfig={{ cellTransfer: { enabled: true, onBeforeCopy: (data) => data } }}\n */\n cellTransfer?: CellTransferConfig;\n\n /**\n * Объединение ячеек тела таблицы.\n *\n * mergeByCellValues — колонки, в которых подряд идущие одинаковые значения\n * сливаются в один блок (по вертикали). Границы блоков таблица считает сама из\n * данных; сортировка и фильтр их пересобирают. Данные не меняются — значение и\n * так повторяется в строках, объединение лишь показывает его одной ячейкой.\n *\n * mergedCellsRegions — список блоков, заданных снаружи (как выделение): каждый\n * блок описан ключами строк (rowKeys) и колонок (colKeys). Нужен rowKeyGetter.\n * Если после сортировки или скрытия колонок строки/колонки блока перестали идти\n * подряд — блок не рисуется. Важнее mergeByCellValues.\n *\n * Примеры: mergeCells={{ mergeByCellValues: ['dept', 'role'] }},\n * mergeCells={{ mergedCellsRegions, rowKeyGetter: (r) => r.id }}.\n */\n mergeCells?: {\n mergeByCellValues?: Array<\n string | { colKey: string; value: (row: RowType) => unknown }\n >;\n /** Список блоков, заданных снаружи (по ключам строк и колонок). */\n mergedCellsRegions?: MergedCellsRegion[];\n /**\n * Нужен для mergedCellsRegions: находит строку по её ключу. Должна быть\n * стабильной функцией; менять её на лету не нужно — в пересборку таблицы она\n * не входит.\n */\n rowKeyGetter?: (row: RowType) => string | number;\n /**\n * Выравнивание по умолчанию для всех блоков. Колоночный mergedCellsAlign и\n * выравнивание конкретного региона важнее.\n */\n mergedCellsAlign?: MergedCellsAlign;\n };\n\n /**\n * Модуль нотификаций: стандартизированный канал событий для внешних\n * потребителей. Таблица UI не рисует — вызывает `onNotification`, потребитель\n * показывает тост/модалку на своей стороне. Сейчас эмитятся ошибки copy/paste\n * (в т.ч. multi-range 2D-разброс, readonly/overflow-abort, пропуск валидацией).\n */\n notifications?: TableNotificationsConfig;\n\n /**\n * subRows - активация иерархии, отображения вложенных строк. Условие активации - наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={subRows: {getSubRows, rowKeyGetter}}\n *\n * columnConfig=[{subRow: {...}}]\n */\n subRows?: SubRows<RowType, RowIdType>;\n /**\n * Столбец с нумерацией строк.\n * Активируется наличием этого свойства. Поддерживает `subRows` любой глубины.\n *\n * @see {@link RowMarkersTableConfig} — полное описание конфигурации и примеры.\n */\n rowMarkers?: RowMarkersTableConfig<RowType>;\n rowsGrouping?: RowsGrouping<RowType, SummaryRowType>;\n\n /**\n * resizableColumn - активация изменения ширины колонки с помощью курсора. Условие активации - resizableColumn: true. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={resizableColumn: true}\n *\n * columnConfig=[{resizable: true}]\n */\n resizableColumn?: boolean;\n /**\n * style - inline-стили. Для стилей самой таблицы (без вложенности).\n *\n * Исключены свойства 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'. Их следует стилизовать через свойства containerStyle.\n */\n style?: Omit<\n CSSProperties,\n 'width' | 'height' | 'minWidth' | 'minHeight' | 'maxWidth' | 'maxHeight'\n >;\n /**\n * css - для стилей простых и сложных(например, для стилизации cell, headerCell, ...).\n *\n * Пример:\n *\n * ```css\n * & > .rdg-header-row > .rdgCell {\n * background-color: red;\n * }\n * ```\n *\n */\n css?: string | CSSObject;\n\n summaryRows?: SummaryRowsConfig;\n /**\n * controlBlock - пропс для активации, кастомизации контролблока.\n */\n controlBlock?: ControlBlockConfig;\n /**\n * containerStyle - инлайновые стили контейнера таблицы и контролблока. высоту и ширину для таблицы рекомендуется задавать в этом пропсе.\n * Пример:\n *\n * ```tsx\n tableConfig={{ containerStyle: { height: '70vh' } }}\n * ```\n */\n containerStyle?: CSSProperties | undefined;\n /**\n * containerCss - стили для контейнера таблицы и контролблока.\n * Через этот пропс можно дополнительно кастомизировать контейнер и все его дочерние элементы.\n */\n containerCss?: string | CSSObject | undefined;\n /**\n * containerId - html-атрибут id контейнера таблицы.\n */\n containerId?: string | undefined;\n\n /**\n * unstickyHeader - откреплённая шапка. Header уезжает вместе со скроллом контента.\n * @default false\n */\n unstickyHeader?: boolean;\n\n /**\n * stickyColumns - колонки, которые прилипают к левому краю при горизонтальной прокрутке,\n * как `position: sticky`. Ключи колонок или предикат по колонке.\n *\n * ```tsx\n * tableConfig={{ stickyColumns: ['region', 'total'] }}\n * tableConfig={{ stickyColumns: (column) => column.key.startsWith('total') }}\n * ```\n */\n stickyColumns?: StickyColumnsConfig<ColumnConfig<RowType, SummaryRowType>>;\n\n /**\n * stickyRows - строки, которые прилипают под шапкой при вертикальной прокрутке.\n * Предикат проверяется для каждой отображаемой строки данных (результаты кешируются); строки групп\n * (`rowsGrouping`) и заглушки загрузки в него не попадают и липкими не становятся.\n * Индексы передаются как есть — удобно для больших таблиц, где позиции известны заранее. Они\n * считаются по итоговому отображаемому списку: сортировка, фильтры, группировка и раскрытые узлы\n * дерева (`subRows`) сдвигают нумерацию — тогда индексы нужно пересчитывать или передать предикат.\n *\n * ```tsx\n * tableConfig={{ stickyRows: (row) => row.isSubtotal }}\n * tableConfig={{ stickyRows: [0, 41, 82] }}\n * ```\n */\n stickyRows?: StickyRowsConfig<RowType>;\n\n /** Тултип при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\n tooltip?: TableConfigTooltip;\n\n /**\n * infinityScroll - бесконечная подгрузка данных при скролле.\n *\n * Условие активации - наличие самого пропса infinityScroll.\n *\n * При активации infinityScroll отключается дефолтная сортировка и фильтрация.\n * (Предполагается, что если есть infinityScroll,\n * то в таблице представлен не весь объем данных,\n * по этой причине дефолтная сортировка и фильтрация не подходят и будут отображать некорректные данные)\n *\n */\n infinityScroll?: InfinityScrollConfig<RowType>;\n /**\n * @isLoading - состояние загрузки данных для таблицы.\n */\n isLoading?: boolean | { boolean: boolean; skeletonRowsCount: number };\n /**\n * loadingOverlay - конфигурация для отображения оверлея загрузки.\n * mode: 'replace' (по умолчанию) показывает оверлей вместо таблицы,\n * mode: 'cover' — поверх таблицы без её размонтирования.\n */\n loadingOverlay?: LoadingOverlayConfig;\n /**\n * Empty state внутри content-области canvas-таблицы.\n * Не заменяет control block, header или pagination.\n */\n emptyState?: TableCanvasEmptyStateConfig;\n /**\n * Error state внутри content-области canvas-таблицы.\n * Не заменяет control block, header или pagination.\n */\n errorState?: TableCanvasErrorStateConfig;\n // FIXME:\n // noRowsFallback?: boolean | { custom: ReactNode };\n columnsControl?: ColumnsControlConfig;\n // FIXME:\n // rowDetailPanel?: RowDetailConfig<RowType>;\n // FIXME: Временно комментирую использование, пока не адаптируем TableCanvas\n // rowInstruments?: {\n // getRowDropdownConfig: RowInstrumentsType<RowType>;\n // /**\n // * @default false\n // */\n // defaultOpened?: boolean;\n // /**\n // * @default true\n // */\n // showInControl?: boolean;\n // /**\n // * Внешний стейт видимости\n // */\n // openedState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n // };\n fullScreenEnabled?: FullScreen;\n /**\n * Переносит портал editor overlay внутрь контейнера таблицы вместо document.body.\n * Решает проблему focus trap и сдвига координат при рендере таблицы в модалке с CSS transform.\n * @default undefined (overlay рендерится в document.body — стандартное поведение)\n */\n editorOverlayPortal?: 'inside';\n keyText?: boolean | KeyTextConfig;\n /**\n * pagination - пропс для пагинации.\n *\n * Условие активации - наличие самого пропса pagination.\n *\n * При активации pagination отключается дефолтные поиск, сортировка и фильтрация.\n * (поиск работает на уровне с фильтрацией и сортировкой, сначала поиск, затем фильтрация, затем сортировка)\n *\n */\n pagination?: PaginationProps;\n /**\n * searching - пропс для поиска по таблицу.\n *\n * Условие активации - наличие searching.enabled: true\n *\n */\n /**\n * Конфигурация табов в сайдбаре\n */\n /** @deprecated Используйте rightSidebarConfig. При наличии обоих приоритет у rightSidebarConfig. */\n sidebarConfig?: SidebarConfig;\n /** Конфигурация правой панели. */\n rightSidebarConfig?: RightSidebarConfig;\n /** Конфигурация пользовательских вкладок левой панели (режим строк). */\n leftSidebarConfig?: LeftSidebarConfig;\n /** Нижний слот в режиме строк. Не увеличивает внешний контейнер таблицы. */\n bottomSheetConfig?: BottomSheetConfig;\n searching?: SearchingProps;\n /**\n * onHeaderContextMenu - callback открытия контекстного меню.\n */\n onHeaderContextMenu?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onHeaderContextMenu'];\n onHeaderContextMenuDropdown?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onHeaderContextMenuDropdown'];\n onCellContextMenuDropdown?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onCellContextMenuDropdown'];\n onCellContextMenu?: TableGlideInstanceProps<\n RowType,\n SummaryRowType\n >['onCellContextMenu'];\n /**\n * Обработчик клика по ячейке.\n *\n * Получает `cell` readonly [colIndex, rowIndex] от glide, и `info` обогащённый объект\n * с row, column, ctxs, refTable (аналогично onCellContextMenu).\n */\n onCellClicked?: (\n cell: readonly [number, number],\n info: TableInfoWithRow<RowType, SummaryRowType>,\n ) => void;\n} & GlideInstanceOmitted<RowType, SummaryRowType>;\n\ntype GlideInstanceOmitted<\n RowType extends ObjectForExtending,\n SummaryRowType,\n> = Pick<\n Omit<\n TableGlideInstanceProps<RowType, SummaryRowType>,\n | keyof TableGlideCustomProps<RowType, SummaryRowType>\n | 'CellReadOnlyEditor' /* CellReadOnlyEditor - свойство только для GlideInstance */\n >,\n | 'className'\n | 'columnSelect'\n | 'minColumnWidth'\n | 'maxColumnWidth'\n | 'maxColumnAutoWidth'\n | 'onVisibleRegionChanged'\n | 'onCellClicked'\n // | 'CellReadOnlyEditor'\n // | 'onGroupHeaderClicked'\n | 'onHeaderClicked'\n | 'onItemHovered'\n | 'trapFocus'\n | 'onColumnResize'\n>;\nexport type CellReadOnlyEditorProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n> = CellReadOnlyEditorGlideInstanceStaticProps &\n EditingCellInfo<RowType, SummaryRowType>;\n\n// & Pick<\n// DataGridPropsDefault<RowType, SummaryRowType, RowIdType>,\n// | 'summaryRowHeight'\n// | 'onFill'\n// | 'onCopy'\n// | 'onPaste'\n// | 'onCellClick'\n// | 'onCellDoubleClick'\n// | 'onCellContextMenu'\n// | 'onCellKeyDown'\n// | 'onSelectedCellChange'\n// | 'onScroll'\n// | 'onColumnResize'\n// | 'onColumnsReorder'\n// | 'enableVirtualization'\n// | 'rowClass'\n// | 'data-testid'\n// | 'headerRowHeight'\n// >;\n\n/**\n * Конфигурация фичи rowMarkers (столбец с нумерацией строк).\n *\n * Столбец frozen, вставляется первым, исключён из reorder/pin/hide/sort/grouping.\n * Поддерживает плоский и древовидный (`subRows`) режимы любой глубины вложенности.\n *\n * **Дефолтное поведение** (без `getRowMarker`): root-only нумерация —\n * корневые строки получают номер (`startIndex + rootIndex`), дочерние — пустую строку.\n *\n * @example\n * ```tsx\n * // Минимальная конфигурация\n * tableConfig={{ rowMarkers: { startIndex: 1 } }}\n *\n * // Сквозная стабильная нумерация\n * tableConfig={{ rowMarkers: { getRowMarker: ({ flatIndex }) => flatIndex + 1 } }}\n * ```\n */\nexport type RowMarkersTableConfig<\n RowType extends ObjectForExtending = ObjectForExtending,\n> = {\n /**\n * Стартовый индекс нумерации (для дефолтной логики без `getRowMarker`).\n * @default 1\n */\n startIndex?: number;\n\n /**\n * Ширина столбца с нумерацией (в px).\n * Если задан `size` — он приоритетнее.\n+ * Если ни `size`, ни `width` не заданы — ширина подстраивается\n+ * под глобальный `tableConfig.rowSize` (small=20, medium=32, big=48).\n * @default 32\n */\n width?: number;\n /**\n * Размер столбца. Приоритетнее `width`.\n * - `xs` = 20px\n * - `s` = 32px\n * - `m` = 48px\n */\n size?: 'xs' | 's' | 'm';\n /**\n * Кастомная функция нумерации. Полностью переопределяет дефолтную root-only логику.\n * Вызывается при рендере каждой ячейки столбца нумерации.\n *\n * ⚠️ Вызывается не только при полной отрисовке таблицы, но и при ховере/скролле —\n * для **одной** ячейки. Не используйте внешние переменные-счётчики —\n * используйте аргументы (`siblingPath`, `flatIndex` и др.), они всегда актуальны.\n *\n * @example\n * // Сквозная стабильная нумерация (все строки, номера не прыгают при сворачивании)\n * getRowMarker: ({ flatIndex }) => flatIndex + 1\n *\n * @example\n * // Корневые — номер, дочерние — прочерк\n * getRowMarker: ({ isSubRow, flatIndex }) => isSubRow ? '—' : flatIndex + 1\n *\n * @example\n * // Иерархическая нумерация любой глубины: 1, 1.1, 1.1.1, 1.2, 2\n * getRowMarker: ({ siblingPath }) => siblingPath.map(i => i + 1).join('.')\n */\n getRowMarker?: (args: {\n /** Данные текущей строки. */\n row: RowType;\n /** Уровень строки в дереве: `0` — корневая, `1` — дочерняя, `2` — внучка, и т.д. */\n level: number;\n /** `true`, если строка дочерняя (`level > 0`). */\n isSubRow: boolean;\n /**\n * Индекс строки в **видимых** строках.\n * **Нестабильный** — меняется при сворачивании и разворачивании веток.\n */\n rowIndex: number;\n /**\n * Стабильный 0-based индекс строки в **полном** дереве (включая скрытые/свёрнутые).\n * Не меняется при collapse/expand — подходит для сквозной нумерации.\n */\n flatIndex: number;\n /**\n * Порядковый номер среди siblings одного родителя (0-based).\n * Для корневых строк — порядковый номер среди всех корневых.\n * Для дочерних — порядковый номер среди children одного `parentKey`.\n */\n siblingIndex: number;\n /**\n * Путь siblingIndex-ов от корня до текущей строки (каждый элемент 0-based).\n *\n * Примеры:\n * - корневая строка (2-я): `[1]`\n * - дочерняя (3-й ребёнок 2-го корня): `[1, 2]`\n * - внучка (1-й ребёнок 1-го ребёнка 1-го корня): `[0, 0, 0]`\n *\n * Для иерархической нумерации: `siblingPath.map(i => i + 1).join('.')` → `\"1.1.1\"`\n *\n * Для плоской таблицы (без subRows): всегда `[siblingIndex]` (один элемент).\n */\n siblingPath: number[];\n /**\n * Ключ родительской строки (`rowKeyGetter(parent)`).\n * `null` для корневых строк. Работает для **любой** глубины вложенности.\n */\n parentKey: string | number | null;\n /** Текущий видимый `flattened` массив строк. */\n rows: readonly RowType[];\n }) => string | number;\n};\n\nexport type {\n RowErrorsConfig,\n RowErrorsInfo,\n} from '../feature-row-errors/types';\n```\n\n## FilterComponentInPopoverProps\n\nПропсы, доступные в кастомном компоненте фильтра (`component: 'custom'`).\n\n```typescript\ntype FilterComponentInPopoverProps<\n FilterStateType extends ObjectForExtending,\n ColumnConfig,\n> = {\n popoverIsOpen: boolean;\n setPopoverIsOpen: React.Dispatch<React.SetStateAction<boolean>>;\n columnConfig: ColumnConfig;\n tabIndex: number;\n headerContextState: HeaderContextValueTypeInstance<FilterStateType> &\n FiltersVariables &\n HeaderContextValueTypeInstance<ObjectForExtending>;\n /**\n * Источник открытия фильтра: из шапки таблицы или из сайдбара\n * Полезно для условной логики в customRender (например, alwaysOpened для combobox)\n */\n filterSource?: 'header' | 'sidebar';\n};\n```",
|
|
49840
50652
|
"api": [
|
|
49841
50653
|
{
|
|
49842
50654
|
"typeName": "FilteringConfig",
|
|
49843
|
-
"source": "type FilteringConfig<T> = {\n state: [T, React.Dispatch<React.SetStateAction<T>>];\n /**\n * @deprecated Использовать filtersInfo\n *\n * clearedValue - состояние фильтров после очистки. Используется для сравнения:\n * Например, был ли фильтр конкретной колонки изменен рассчитывается посредством сравнения текущего значения фильтра и значения фильтра в clearedValue.\n * Если они равны, то фильтр считается не измененным.\n */\n clearedValue?: T;\n /**\n * Информация о фильтрах для каждой колонки.\n * Используется для:\n * 1. Хранения меток (label) фильтров для отображения в UI\n * 2. Хранения значений по умолчанию (clearedValue) для каждого фильтра\n * 3. Определения, был ли фильтр изменен (сравнение текущего значения с clearedValue)\n */\n filtersInfo?: Record<\n keyof T,\n {\n label: string;\n clearedValue: T[keyof T];\n }\n >;\n /**\n * manualFiltering - пропс, активирующий ручную-кастомную (или на стороне бэка) фильтрацию.\n * @remarks\n * Для автоматической фильтрации (когда не используется manualFiltering в tableConfig):\n * - Для всех типов фильтров обязательно должен быть указан `valueInRow`\n * - Для component: 'select' дополнительно должен быть указан `filteringType`\n * - Для component: 'input' с кастомным фильтром (когда filter - функция)\n * функция фильтрации должна быть передана явно\n *\n * Если используется manualFiltering, эти параметры не обязательны,\n * так как вся логика фильтрации реализуется извне.\n */\n manualFiltering?: boolean;\n /**\n * Конфигурация для отображения фильтров в правом сайдбаре.\n *\n * Позволяет:\n * 1. Добавлять глобальные фильтры (не привязанные к конкретной колонке)\n * 2. Управлять порядком отображения фильтров\n * 3. Переопределять рендер и заголовки колоночных фильтров\n *\n * Логика работы:\n * - По умолчанию в сайдбаре отображаются все колоночные фильтры (из columnConfig)\n * - Ключом фильтра считается `key` колонки, если его нет, то пытаемся взять `keyInFilterState` (если указан), иначе это не будет работать\n * - Заголовком фильтра по умолчанию является `name` колонки или ключ фильтра (name || key)\n * - Глобальные фильтры добавляются через `items` с уникальными ключами\n *\n * Особенности:\n * 1. Порядок отображения:\n * - Сначала фильтры из `order` (в указанной последовательности)\n * - Затем остальные колоночные фильтры (в порядке columnConfig)\n * - В конце - глобальные фильтры (в алфавитном порядке ключей)\n *\n * 2. Переопределение колоночных фильтров:\n * - Чтобы изменить заголовок: укажите ключ колонки в `items` с новым `label`\n * - Чтобы заменить рендер: укажите ключ колонки с `customRenderFn`\n * - Оригинальный фильтр из колонки будет проигнорирован\n *\n * 3. Глобальные фильтры:\n * - Ключ не должен совпадать с ключами колонок\n * - Обязательно указать `label` и `customRenderFn`\n * - Отображаются после всех колоночных фильтров, если не переопределены в order\n *\n * @example\n * // Добавление глобального фильтра и изменение порядка\n * sidebarConfig: {\n * order: ['status', 'tasks', 'type'], // Сначала статус, затем глобальный поиск\n * items: {\n * tasks: { // Уникальный ключ\n * label: 'Поиск по всем полям',\n * customRenderFn: () => <TaskComponent />\n * },\n * status: { // Переопределение колоночного фильтра\n * label: 'Статус заявки', // Новый заголовок\n * customRenderFn: () => <CustomStatusFilter /> // Кастомный рендер\n * }\n * type: { // Переопределение только Label колоночного фильтра\n * label: 'Тип', // Новый заголовок\n * }\n * }\n * }\n */\n sidebarConfig?: {\n /**\n * Определяет порядок отображения фильтров.\n * - Указываются ключи фильтров (колоночных или глобальных)\n * - Не указанные в order фильтры отображаются после\n * - Если order пуст, сохраняется порядок: глобальные фильтры + columnConfig фильтры в конце\n */\n order?: string[];\n /**\n * Конфигурация фильтров для сайдбара.\n * Ключом может быть:\n * - Ключ колонки (для переопределения колоночного фильтра)\n * - Уникальный ключ (для добавления глобального фильтра)\n */\n items: Partial<\n Record<\n keyof T,\n {\n /** Заголовок фильтра (обязателен для глобальных фильтров), можно использовать для переопределения для локальных фильтров */\n label: string;\n /**\n * Функция рендера компонента фильтра.\n * Для колоночных фильтров переопределяет оригинальный рендер.\n * Для глобальных фильтров обязательна.\n */\n customRenderFn?: (\n filters: T,\n setFilters: React.Dispatch<React.SetStateAction<T>>,\n ) => React.ReactNode;\n }\n >\n >;\n };\n /**\n * Callback для кастомизации стилей чипсов (фильтров) в списке\n *\n * @param {ItemOrGroup} itemOrGroup - Текущий элемент или группа фильтров\n * @param {Item | undefined} item - Конкретный элемент фильтра (если есть)\n * @returns {CSSObject} Объект стилей, который будет применен к чипсу\n *\n * @description\n * Позволяет динамически задавать стили для каждого чипса в зависимости от его типа и содержимого.\n * Вызывается для каждого отображаемого чипса (как для отдельных элементов, так и для элементов внутри групп).\n *\n * @example\n * // Пример 1: Стилизация чипсов по типу\n * chipStyle: (itemOrGroup, item) => {\n * if (isGroup(itemOrGroup)) {\n * return { backgroundColor: '#f0f0f0' };\n * }\n * return { backgroundColor: '#e0e0e0' };\n * }\n *\n * @example\n * // Пример 2: Стилизация по значению фильтра\n * chipStyle: (itemOrGroup, item) => {\n * if (item?.label === 'Высокий приоритет') {\n * return {\n * backgroundColor: '#ffebee',\n * color: '#d32f2f'\n * };\n * }\n * return {};\n * }\n *\n * @example\n * // Пример 3: Разные стили для элементов в группе и одиночных\n * chipStyle: (itemOrGroup, item) => {\n * if (item) {\n * // Стиль для элемента внутри группы\n * return { maxWidth: 180 };\n * }\n * // Стиль для одиночного чипа\n * return { maxWidth: 150 };\n * }\n */\n chipStyle?: (itemOrGroup: ItemOrGroup, item: Item | undefined) => CSSObject;\n /**\n * Пользовательский форматтер заголовка группы чипсов.\n *\n * Используется в блоке активных фильтров для подмены текста заголовка\n * группы (например, “Статус”, “Тип”, “Автор”). Полезно, когда нужно\n * динамически менять подпись (добавить счётчик, i18n и т.п.).\n *\n * @param {ItemOrGroup} itemOrGroup Объект группы (тип Group). Вызов происходит только для групп,\n * поэтому безопасно кастовать к Group.\n * @returns {string} Текст заголовка группы чипсов.\n *\n * @default Возвращается `group.groupLabel`.\n *\n * @remarks\n * - Функция должна быть чистой и быстрой (без сетевых запросов и побочных эффектов).\n * - Возвращайте ТОЛЬКО строку — чипы отображают текстовое значение.\n * - Для длинных строк применяется усечение (overflow с многоточием) на уровне компонента.\n *\n * @example\n * // Добавить двоеточие и количество выбранных элементов\n * renderGroupLabel: (group) => `${group.groupLabel}: ${group.items.length}`\n *\n * @example\n * // Локализация заголовка группы\n * const i18n = { status: 'Статус', type: 'Тип' };\n * renderGroupLabel: (group) => i18n[group.groupId] ?? group.groupLabel\n */\n renderGroupLabel?: (group: Group) => string;\n\n /**\n * Пользовательский форматтер текста чипса (элемента внутри группы или одиночного фильтра).\n *\n * Позволяет управлять тем, что именно отображается внутри каждого чипса. Особенно полезен\n * при серверной пагинации/ленивой загрузке, когда в состоянии фильтра хранится только value,\n * а label необходимо подставить из локального кэша.\n *\n * @param {Group | null } group Группа, внутри которой рендерится чип (или null).\n * @param {Item} item Сам элемент чипса. В группах передаётся конкретный `Item`,\n * для одиночного чипа может быть `undefined`.\n * @returns {string} Текст, который будет показан в чипсе.\n *\n * @default Используется `item?.label.toString()` (или строковое представление value).\n *\n * @remarks\n * - Функция должна быть чистой и быстрой;\n * - Возвращайте ТОЛЬКО строку.\n *\n * @example\n * // 1) Отображение label из кэша при серверной пагинации\n * const labelsCacheRef = useRef(new Map<string, string>());\n * renderChipLabel: (group, item) => {\n * if (item?.id != null) {\n * const key = String(item.id);\n * const fromCache = labelsCacheRef.current.get(key);\n * if (fromCache) return fromCache; // красивый label, если уже загрузили\n * return String(item.label ?? key); // фоллбэк: временно показываем value/label из item\n * }\n * return ''; // безопасный фоллбэк для одиночных случаев\n * }\n *\n * @example\n * // 2) Нормализация отображения числовых значений\n * renderChipLabel: (_group, item) => {\n * const v = Number(item?.label);\n * return Number.isFinite(v) ? v.toLocaleString('ru-RU') : String(item?.label ?? '');\n * }\n *\n * @example\n * // 3) Префикс по типу группы\n * renderChipLabel: (group, item) => {\n * const prefix = group.groupId === 'status' ? '' : '#';\n * return `${prefix}${item?.label ?? item?.id ?? ''}`;\n * }\n */\n renderChipLabel?: (group: Group | null, item: Item) => string;\n};\n\nexport type DefaultSidebarTabIds = 'columns' | 'tableSettings' | 'filtering';\n\n/**\n * Общие настройки пользовательских вкладок левой и правой панели TableCanvas.\n */\nexport type TableCanvasSidebarConfig = {\n /**\n * Включен ли sidebar. Отвечает только за UI. Не влияет на перерасчёт фичей.\n * @default true\n */\n enabled?: boolean;\n /**\n * Открыт ли sidebar при первом рендере (uncontrolled-режим).\n * Игнорируется, если передан openState.\n * @default false\n */\n defaultOpen?: boolean;\n /**\n * Внешний контроль открытия/закрытия sidebar.\n * Если передан — источник истины, defaultOpen игнорируется.\n */\n openState?: [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * id вкладки, выбранной по умолчанию (актуально при открытом сайдбаре).\n * Если id не найден или у вкладки showInSidebar=false — используется первая доступная.\n */\n defaultActiveTabId?: string;\n /**\n * Внешний контроль активной вкладки (controlled-режим).\n * Если передан — источник истины, defaultActiveTabId игнорируется.\n */\n activeTabState?: [\n string | null,\n React.Dispatch<React.SetStateAction<string | null>>,\n ];\n /**\n * Колбэк смены активной вкладки. Вызывается и в uncontrolled-режиме.\n * При закрытии сайдбара приходит null.\n */\n onActiveTabChange?: (tabId: string | null, tab?: SidebarTab) => void;\n /**\n * Кастомные табы\n */\n customTabs?: Array<\n Omit<SidebarTab, 'id'> & {\n id: Exclude<string, DefaultSidebarTabIds>;\n }\n >;\n /**\n * Порядок отображения кастомных вкладок\n */\n customTabsOrder?: Array<Exclude<string, DefaultSidebarTabIds>>;\n /**\n * Ширина контента без полоски вкладок (44px). Число — px, строка — CSS.\n * Проценты считаются от ширины рабочей области TableCanvas.\n * Изменение пропса сразу меняет ширину открытой панели.\n * По умолчанию: 300px слева, 400px справа.\n */\n width?: string | number;\n};\n\n/** Настройки правой панели; встроенные вкладки доступны только справа. */\nexport type SidebarConfig = TableCanvasSidebarConfig & {\n defaultTabs?: Array<\n | {\n id: 'filtering' | 'columns';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара (если данный таб окажется единственным табом в настройках) */\n title?: string;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки (для табов с id = filtering и columns - недоступен. Настраивается через таб с id='tableSettings') */\n iconTooltipText?: undefined;\n }\n | {\n id: 'tableSettings';\n /** название таба в рамках горизонтального табов внутри таба настройки */\n label?: string;\n /** название таба в рамках вертикальных табов сайдбара */\n title?: string;\n\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n /**\n * Кастомный слот для вкладки tableSettings (рендерится после общих настроек)\n * Только дл id: 'tableSettings'\n */\n customGeneralSettingsSlot?: React.ReactNode;\n /**\n * Кастомный элемент справа от title в шапке сайдбара\n */\n titleRightSlot?: React.ReactNode;\n /** @default true */\n showInSidebar?: boolean;\n /** тултип иконки шестеренки @default 'Настройки' */\n iconTooltipText?: string;\n }\n >;\n};\n\n/** Конфигурация правой панели. SidebarConfig сохранён для совместимости. */\nexport type RightSidebarConfig = SidebarConfig;\n\n/** Пользовательские вкладки слева; встроенных вкладок настроек нет. */\nexport type LeftSidebarConfig = TableCanvasSidebarConfig;\n\n/** Нижний слот под canvas, над пагинацией, между боковыми панелями. */\nexport type BottomSheetConfig = {\n /** @default true */\n enabled?: boolean;\n /** Число — px, строка — CSS; 'auto' — по содержимому. Проценты — от рабочей области. @default 32 */\n height?: string | number;\n /** Минимальная высота, ограниченная доступным пространством. @default 32 */\n minHeight?: string | number;\n /** Максимальная высота в px или CSS, дополнительно ограниченная доступным пространством. */\n maxHeight?: string | number;\n /** Пользователь управляет содержимым и раскрытием; при height: 'auto' панель прокручивается сама. */\n content: React.ReactNode;\n};\n\nexport function activeViewIs<T extends 'cards' | 'rows'>(\n checkType: T,\n viewState: 'cards' | 'rows',\n view: View,\n): view is ViewMods[T] {\n return checkType === viewState;\n}\n\n/** Размер controlBlock: 'm' и 's' — одинаковые стили, 'xs' — уменьшенный */\nexport type ControlBlockSize = 'm' | 's' | 'xs';\n\nexport type ControlBlockConfig = {\n /**\n * show - наличие controlBlock-а\n * @default true\n */\n show?: boolean;\n /**\n * Размер controlBlock и его элементов (кнопки, иконки, поиск, отступы).\n * 'm' и 's' — стандартные стили, 'xs' — компактный режим.\n * Не влияет на customFeatures и кастомные слоты — они контролируются разработчиком.\n * @default 'm'\n */\n size?: ControlBlockSize;\n /**\n * @deprecated Используйте кастомные кнопки через rightSideInner или customFeatures.\n * leftSideInner - пропс для добавления кнопок в левую часть контролблока.\n * Продолжает работать для обратной совместимости.\n */\n leftSideInner?: ControlBlockButtonProps[];\n /**\n * rightSideInner - пропс для добавления кнопок в правую часть контролблока\n */\n rightSideInner?: ControlBlockButtonProps[];\n /**\n * customFeatures - пропс для добавления кастомных фичей (кнопки-иконки)\n */\n customFeatures?: FeatureItem[];\n /**\n * pinningMenu - нативная фича закрепления столбцов (SplitIconButton с\n * дропдауном) в правой зоне иконок. Появляется, когда активировано\n * закрепление колонок (columnsControl.pinning). Продукт может донастроить\n * и дополнить пункты меню (см. PinningMenuConfig).\n */\n pinningMenu?: PinningMenuConfig;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты левые фичи при адаптивной компрессии\n */\n leftSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Пропсы для компонента dropdown в котором будут скрыты правые фичи при адаптивной компрессии\n */\n rightSideDropdownProps?: TableDropdownConfigProps;\n /**\n * Активна ли фича компрессии (сжатие ToolsMenu при адаптиве)\n * @default true\n */\n enableAdaptiveCompress?: boolean;\n /**\n * Панель массовых действий\n */\n massActionPanel?: {\n /**\n * Кнопки панели. Размеры кнопок/дропдаунов панель подбирает сама (по `size` панели и компактности) —\n * передавать `size` кнопкам не нужно. Если `size` на кнопке всё же задан — он используется как есть.\n */\n buttons: MassActionButtonProps[];\n /**\n * Пропсы для Dropdown, в который сжались кнопки\n */\n collapsedDropdownProps?: TableDropdownConfigProps;\n /**\n * Отступ панели снизу от контейнера (px)\n * @default 24\n */\n bottom?: number;\n /**\n * Управление отображением панели массовых действий.\n * - `undefined` (по умолчанию) — стандартное поведение (показывается при selecting + выбранных строках)\n * - `false` — панель не рендерится, разработчик управляет действиями самостоятельно\n * - `true` — панель показывается всегда, даже без активного selecting и выбранных строк\n */\n show?: boolean;\n /**\n * Размерная сетка панели внутри таблицы: `m`/`s` — обычный размер, `xs` — уменьшенный (кнопки `xxs`, «ещё» `xs`, счётчик Body XS).\n * Viewport-логика (1280) в таблице не используется.\n * @default 's'\n */\n size?: MassActionsSize;\n };\n};\n\n/** Пропсы кнопки редактирования. onClick исключён — используйте onSave/onCancel/onEnableEditing. */\nexport type EditingButtonProps = Omit<\n Partial<ControlBlockButtonProps>,\n | 'onClick'\n | 'size'\n | 'dropdown'\n | 'isTargetAction'\n | 'skipRightDivider'\n | 'tooltipText'\n>;\n\nexport type EditingConfig<\n RowType extends ObjectForExtending,\n RowIdType,\n SummaryRowType,\n> = {\n /**\n * Функция обработки изменений в редактируемой строке\n */\n onRowsChange: Maybe<\n (rows: RowType[], data: RowsChangeData<RowType, SummaryRowType>) => void\n >;\n /**\n * свойство, необходимое для корректного изменения дочерних строк.\n * Данное свойство обязательно, если ваши дочерние строки установлены не под ключом \"subRows\" внутри строки.\n *\n * Как дочерние строки можно указывать свойство, которые вложено в другое свойство.\n * В таком случае \".\" будет знаком для обозначения сл. уровня вложенности.\n *\n * @example \"child\" или \"uvh367.children\"\n */\n subRowsKey?: string;\n /**\n * Глубокое копирование строк перед применением правки в режиме редактирования.\n *\n * Включите, если строки, передаваемые в таблицу, иммутабельны/заморожены\n * (напр. стейт под управлением Redux Toolkit или Immer — они вызывают\n * Object.freeze в dev). При редактировании дочерней строки таблица записывает\n * изменение ВНУТРЬ объекта родителя; на замороженном объекте это падает с\n * `TypeError: Cannot assign to read only property`.\n *\n * Когда флаг включён, таблица сама делает structuredClone редактируемой строки\n * перед записью — ваш иммутабельный стейт не мутируется, и редактирование\n * дочерних строк работает без действий с вашей стороны.\n *\n * ⚠️ Данные строки должны быть сериализуемыми. Где доступен structuredClone —\n * Date/Map/Set и вложенные структуры копируются корректно; на старых средах\n * без structuredClone используется JSON-фоллбэк (теряет Date/Map/Set, undefined\n * и функции). Не включайте без необходимости — глубокое копирование добавляет\n * накладные расходы.\n *\n * @default false\n */\n deepCloneRows?: boolean;\n /**\n * Функция определения уникального id строки\n * @param row\n * @returns\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Функция определения возможности редактирования строки\n * @param row\n * @returns\n */\n rowEditable?: (row: RowType) => boolean;\n /**\n * defaultEnabled - пропс, отвечающий за то, будет ли активен режим редактирования или нет. По умолчанию - не активно.\n * @default false\n */\n defaultEnabled?: boolean;\n /**\n * enabled - необходим для управления режимом редактирования снаружи компонента Таблицы.\n * По умолчанию, управление происходит в компоненте.\n * Приоритетнее, чем defaultEnabled.\n *\n * @type boolean - если НЕ нужно переключение в самой таблице\n * @type [boolean, React.Dispatch<React.SetStateAction<boolean>>] - если нужно переключение в самой таблице\n *\n */\n enabled?: boolean | [boolean, React.Dispatch<React.SetStateAction<boolean>>];\n /**\n * Cостояние скрытия/раскрытия кнопки включения/выключения фичи\n * @default true\n */\n showButtons?: boolean;\n /**\n * Функция, вызывающаяся при включении фичи.\n * @param enableEditorMode - функция включающая режим редактирования\n */\n onEnableEditing?: (enableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при сохранении отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onSave?: (disableEditorMode: () => void) => void;\n /**\n * Функция, вызывающаяся при отмене отредактированного.\n * @param disableEditorMode - функция выключающая режим редактирования\n */\n onCancel?: (disableEditorMode: () => void) => void;\n /** Пропсы кнопок в controlBlock. */\n buttons?: {\n save?: EditingButtonProps;\n cancel?: EditingButtonProps;\n edit?: EditingButtonProps;\n };\n /**\n * Кастомный слот, отображаемый левее кнопок «Отменить» / «Сохранить».\n * Виден только когда режим редактирования активен (editMode = true).\n * Зона ответственности разработчика — размерная сетка controlBlock не влияет на этот слот.\n */\n editModeLeftSlot?: React.ReactNode;\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: {\n enableButton?: DomMetadata;\n saveButton?: DomMetadata;\n cancelButton?: DomMetadata;\n };\n};\n\nexport type SummaryRowsConfig = {\n showDefault: boolean;\n showInControl: boolean;\n /**\n * callback при переключении тогла «Итоговые строки» в настройках таблицы.\n * Вызывается только по действию пользователя (не при монтировании),\n * поэтому подходит для сохранения выбора, например, в localStorage.\n * Сохранённое значение передавайте обратно в `showDefault`.\n */\n onChange?: (checked: boolean) => void;\n} & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n domMetadata?: DomMetadata;\n};\n\n/**\n * Конфиг тултипа при hover по canvas-элементам.\n * Для активации фичи необходимо заполнить данный конфиг,\n * а также добавить нужные изменения в Canvas-элементах или в конфиге колонки.\n */\nexport type TableConfigTooltip = {\n /**\n * Включить/выключить колоночные и кастомные тултипы (cellTooltip, headerCellTooltip).\n * Внутренние тултипы (drag-иконка в шапке и другие по nodeId) работают всегда.\n * @default false\n */\n enabled?: boolean;\n /** Глобальная задержка перед показом тултипа (мс). Per-node переопределяет. @default 500 */\n mouseEnterDelay?: number;\n /** Глобальная задержка перед скрытием тултипа (мс). Per-node переопределяет. @default 0 */\n mouseLeaveDelay?: number;\n /**\n * Минимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n minWidth?: number | string;\n /**\n * Максимальная ширина тултипа. Число трактуется как px, строка с единицей\n * (например '20rem', '50%') отдаётся как есть. Действует на все canvas-тултипы,\n * включая авто-тултип Canvas.Text. Если ширина задана на самом тултипе\n * (per-node), приоритет у неё.\n */\n maxWidth?: number | string;\n};\n\nexport type InfinityScrollConfig<RowType extends ObjectForExtending> = {\n /** Триггер достижения скроллом зоны подгрузки данных. */\n onTrigger: (rows: RowType[]) => Promise<void> | void;\n /** Состояние загрузки (скелетоны) новых строк. */\n isLoading: boolean;\n /**\n * Флаг, когда все данные загружены — false.\n * @default true\n */\n hasMore?: boolean;\n /**\n * Для mode='region': за сколько строк до конца триггерить загрузку.\n * @default 5\n */\n rowThreshold?: number;\n};\n\nexport type { TableCanvasEmptyStateConfig, TableCanvasErrorStateConfig };\n\n/**\n * Настройка выделения ячеек/колонок/строк в TableCanvas — единый объект.\n * Это отдельная ось взаимодействия — не зависит от `highlightActiveType`.\n */\nexport type CellsSelectionConfig = {\n /**\n * Режим фактического выделения ячеек (нативный glide selection). По нему\n * работают copy/paste, рамка, fill-handle и затемнение шапки/нумерации.\n * @default \"range-cell\"\n */\n mode?: CellsSelectionMode;\n /**\n * Выделение колонок по клику на шапку. Ctrl/Cmd — добавить/убрать колонку,\n * Shift — диапазон колонок. Клик по иконкам сортировки/фильтрации в шапке\n * выделение НЕ вызывает. Поддерживает copy/paste по выделенным колонкам.\n * @default true\n */\n enableColumnSelection?: boolean;\n /**\n * Выделение строк по клику/драгу на колонке нумерации (`rowMarkers`).\n * Ctrl/Cmd — несмежный выбор отдельных строк, драг — смежный диапазон.\n * Поддерживает copy/paste по выделенным строкам. Требует включённой колонки\n * нумерации (`rowMarkers`). При `false` клик по нумерации ничего не выделяет.\n * @default true\n */\n enableRowSelection?: boolean;\n /**\n * Выделение всей таблицы кликом по «нулевой» ячейке — шапке колонки нумерации\n * (левый верхний угол). Выделяет все строки данных по всем колонкам одним\n * диапазоном; поддерживает copy/paste. Требует включённой колонки нумерации\n * (`rowMarkers`) и активного `mode` (≠ `disabled`).\n * @default true\n */\n enableSelectAll?: boolean;\n /**\n * Внешний (controlled) контроль НАТИВНОГО выделения (ячейки/диапазон/смежные\n * строки и колонки). `state` — кортеж `[value, setter]` как у `selecting.state`.\n * Сброс: `setter({ current: undefined, rows: empty, columns: empty })`.\n * Несмежный Ctrl-выбор колонок/строк (own-state) сюда не входит — он внутренний.\n */\n state?: [GridSelection, React.Dispatch<React.SetStateAction<GridSelection>>];\n};\n\n/** Один объединённый блок: какие строки и колонки слить. */\nexport type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};\n\n/**\n * Видимость сторон рамки ячейки: true рисовать, false не рисовать, не задано -\n * работает уровень ниже (настройка колонки, строки или общая).\n */\nexport type CellBorderVisibility = {\n top?: boolean;\n right?: boolean;\n bottom?: boolean;\n left?: boolean;\n};\n\n/**\n * Управление рамками (линиями) таблицы: включение и выключение. Уровни, от\n * слабого к сильному: общие настройки (vertical, horizontal), затем колонка\n * (getVerticalBorder) и строка (getHorizontalBorder), затем ячейка\n * (getCellBorder).\n */\nexport type BordersConfig<RowType = ObjectForExtending> = {\n /** Рисовать ли вертикальные линии между колонками. @default true */\n vertical?: boolean;\n /** Рисовать ли горизонтальные линии между строками тела. @default true */\n horizontal?: boolean;\n /**\n * Точечное управление вертикальной линией справа от колонки (разделитель\n * после неё). Вернуть true или false, чтобы переопределить общую настройку\n * vertical, или undefined, чтобы оставить её. Зовётся на каждую видимую\n * колонку при перерисовке, поэтому функция должна быть быстрой.\n */\n getVerticalBorder?: (params: {\n /** Ключ колонки, справа от которой рисуется линия. */\n columnKey: string;\n /** Индекс колонки в порядке отрисовки (закреплённые в начале). */\n columnIndex: number;\n }) => boolean | undefined;\n /**\n * Точечное управление горизонтальной линией сверху строки. Вернуть true или\n * false, чтобы переопределить общую настройку horizontal, или undefined,\n * чтобы оставить её. Для summary-строк не вызывается. Зовётся на каждую\n * видимую строку при перерисовке, поэтому функция должна быть быстрой.\n */\n getHorizontalBorder?: (params: {\n /** Строка под линией (линия рисуется сверху этой строки). */\n row: RowType;\n /** Индекс строки среди отображаемых. При раскрытии subRows индексы сдвигаются. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => boolean | undefined;\n /**\n * Стороны рамки конкретной ячейки, вкл и выкл. Для ячеек без переопределений\n * возвращать undefined. Включает отрисовку линий с разбивкой по ячейкам,\n * поэтому функция должна быть быстрой: без тяжёлых вычислений и с готовыми\n * объектами-константами вместо новых на каждый вызов. Для summary-строк не\n * вызывается.\n */\n getCellBorder?: (params: {\n /** Индекс колонки среди отображаемых (без служебных). */\n col: number;\n /** Ключ колонки. */\n columnKey: string | undefined;\n /** Строка ячейки. */\n row: RowType;\n /** Индекс строки среди отображаемых. */\n rowIndex: number;\n /** Уровень вложенности subRows: 0 корень, 1 и больше дочерние. */\n treeLvl: number;\n }) => CellBorderVisibility | undefined;\n};\n\nexport type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *"
|
|
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 *"
|
|
49844
50656
|
},
|
|
49845
50657
|
{
|
|
49846
50658
|
"typeName": "FilterComponentInPopoverProps",
|
|
@@ -49952,6 +50764,32 @@
|
|
|
49952
50764
|
}
|
|
49953
50765
|
]
|
|
49954
50766
|
},
|
|
50767
|
+
{
|
|
50768
|
+
"component": "TableCanvas",
|
|
50769
|
+
"feature": "Appearance",
|
|
50770
|
+
"legacy": false,
|
|
50771
|
+
"summary": "*tableConfig.appearance**",
|
|
50772
|
+
"docs": "# Appearance (TableCanvas)\n\n**tableConfig.appearance**\n\nГотовые варианты внешнего вида таблицы: «чистый» вид и зебра.\n\n```tsx\n<TableCanvas\n tableConfig={{\n appearance: { variant: 'clean', zebra: true },\n }}\n/>\n```\n\nВсе поля необязательные. Без `appearance` таблица выглядит как обычно:\n`variant` по умолчанию `'default'`, `zebra` по умолчанию `false`.\n\n## Чистый вид — `variant: 'clean'`\n\nТаблица без линий сетки и внешних рамок. Шапка на белом фоне с серым текстом.\nОстальное выглядит как в обычном виде.\n\n## Зебра — `zebra: true`\n\nСтроки через одну окрашены серым. Работает в любом варианте, по умолчанию\nвыключена.\n\n## Как чистый вид работает с другими настройками\n\n- **`borders`** — линии сетки выключены. Если нужно вернуть отдельные линии,\n задайте их в `borders` явно.\n- **Наведение и выделение** работают как обычно. Нумерация и чекбоксы\n подсвечиваются вместе со строкой.\n- **Отмеченные и выбранные строки** красятся своим цветом, в том числе поверх\n зебры.\n- **Итоговые строки** остаются голубыми, как в обычном виде. Зебра на них не\n распространяется.\n\n> Типы — [Appearance API](?path=/docs/локальные-компоненты-tablecanvas-appearance-api--docs)",
|
|
50773
|
+
"apiDocs": "# Appearance API\n\n## tableConfig.appearance\n\n```typescript\ntype AppearanceConfig = {\n /**\n * `'clean'` — «чистый» вид: без линий сетки и внешних рамок, шапка на белом\n * фоне с серым текстом.\n * @default 'default'\n */\n variant?: AppearanceVariant;\n /**\n * Зебра: строки через одну окрашены серым. Работает в любом `variant`.\n * @default false\n */\n zebra?: boolean;\n};\n```\n\n## AppearanceVariant\n\n```typescript\ntype AppearanceVariant = 'default' | 'clean';\n```",
|
|
50774
|
+
"api": [
|
|
50775
|
+
{
|
|
50776
|
+
"typeName": "AppearanceConfig",
|
|
50777
|
+
"source": "type AppearanceConfig = {\n /**\n * `'clean'` — «чистый» вид: без линий сетки и внешних рамок, шапка на белом\n * фоне с серым текстом.\n * @default 'default'\n */\n variant?: AppearanceVariant;\n /**\n * Зебра: строки через одну окрашены серым. Работает в любом `variant`.\n * @default false\n */\n zebra?: boolean;\n};"
|
|
50778
|
+
},
|
|
50779
|
+
{
|
|
50780
|
+
"typeName": "AppearanceVariant",
|
|
50781
|
+
"source": "type AppearanceVariant = 'default' | 'clean';"
|
|
50782
|
+
}
|
|
50783
|
+
],
|
|
50784
|
+
"stories": [
|
|
50785
|
+
{
|
|
50786
|
+
"exportName": "Appearance",
|
|
50787
|
+
"displayName": "Чистый вид и зебра (прототип)",
|
|
50788
|
+
"type": "full-code",
|
|
50789
|
+
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n// «Чистый» вид и зебра включаются в tableConfig.appearance:\n// appearance: { variant: 'clean', zebra: true }\n\n() => {\n const [rows, setRows] = useState(createRows);\n\n const [variant, setVariant] = useState<AppearanceVariant>('clean');\n const [zebra, setZebra] = useState(true);\n const [highlightActiveType, setHighlightActiveType] =\n useState<HighlightActiveType>('row');\n const [selectionMode, setSelectionMode] =\n useState<CellsSelectionMode>('range-cell');\n\n const [showPagination, setShowPagination] = useState(true);\n const [showControlBlock, setShowControlBlock] = useState(true);\n const [showSummaryRow, setShowSummaryRow] = useState(true);\n const [showColumnsGrouping, setShowColumnsGrouping] = useState(true);\n const [fillWidth, setFillWidth] = useState(true);\n\n // Колонка без width получает grow и растягивается: таблица сначала\n // подбирает ширину по содержимому, затем один раз делит остаток места\n // поровну. Число становится нижней границей ширины. С fillWidth=false\n // ширина фиксированная, справа остаётся пустое место.\n const columnWidth = useCallback(\n (px: number) => (fillWidth ? { minWidth: px } : { width: px }),\n [fillWidth],\n );\n\n const [page, setPage] = useState(1);\n const [perPage, setPerPage] = useState(PER_PAGE);\n\n const renderSummaryCell = useCallback(\n (props: SummaryCellInfoGlideInstance<Row, TSummaryRowData>) =>\n props.row.values.find((el) => el.columnId === props.column.key)\n ?.value ?? '',\n [],\n );\n\n // Листовые колонки одни и те же, группировка лишь оборачивает их в\n // верхний уровень шапки.\n const leafColumns = useMemo<\n Record<LeafColumnKey, ColumnConfig<Row, TSummaryRowData>>\n >(\n () => ({\n id: {\n key: 'id',\n name: 'ID',\n ...columnWidth(90),\n sortingType: 'numberSort',\n resizable: true,\n renderSummaryCell,\n },\n task: {\n key: 'task',\n name: 'Title',\n ...columnWidth(220),\n sortingType: 'stringSort',\n resizable: true,\n editingCell: { component: 'inputString' },\n renderSummaryCell,\n },\n priority: {\n key: 'priority',\n name: 'Priority',\n ...columnWidth(140),\n sortingType: 'stringSort',\n resizable: true,\n filtering: {\n component: 'select',\n selectOptions: {\n type: 'constant',\n options: [\n { value: 'All', text: 'All' },\n { value: 'High', text: 'High' },\n { value: 'Critical', text: 'Critical' },\n { value: 'Medium', text: 'Medium' },\n { value: 'Low', text: 'Low' },\n ],\n },\n keyInFilterState: 'priority',\n valueInRow: (r) => r.priority,\n filter: {\n typeOfValue: 'single',\n filteringType: (fv, rv) => (fv !== 'All' ? rv === fv : true),\n },\n },\n },\n issueType: {\n key: 'issueType',\n name: 'Issue Type',\n ...columnWidth(150),\n sortingType: 'stringSort',\n resizable: true,\n filtering: {\n component: 'select',\n selectOptions: {\n type: 'constant',\n options: [\n { value: 'Bug', text: 'Bug' },\n { value: 'Improvement', text: 'Improvement' },\n { value: 'Epic', text: 'Epic' },\n { value: 'Story', text: 'Story' },\n ],\n },\n keyInFilterState: 'issueType',\n valueInRow: (r) => r.issueType,\n filter: {\n typeOfValue: 'multiple',\n filteringType: (fv, rv) =>\n !fv.length || fv.some((fvCurr) => fvCurr === rv),\n },\n },\n },\n developer: {\n key: 'developer',\n name: 'Developer',\n ...columnWidth(180),\n sortingType: 'stringSort',\n resizable: true,\n editingCell: { component: 'inputString' },\n filtering: {\n component: 'input',\n keyInFilterState: 'developer',\n valueInRow: (r) => r.developer,\n filter: 'startWith',\n },\n },\n complete: {\n key: 'complete',\n name: '% Complete',\n ...columnWidth(140),\n sortingType: 'numberSort',\n resizable: true,\n editingCell: { component: 'inputString' },\n },\n }),\n [renderSummaryCell, columnWidth],\n );\n\n const columnConfig = useMemo<readonly ColumnConfig<Row, TSummaryRowData>[]>(\n () =>\n showColumnsGrouping\n ? [\n leafColumns.id,\n leafColumns.task,\n {\n key: 'params',\n name: 'Параметры',\n children: [leafColumns.priority, leafColumns.issueType],\n },\n {\n key: 'progress',\n name: 'Выполнение',\n children: [leafColumns.developer, leafColumns.complete],\n },\n ]\n : [\n leafColumns.id,\n leafColumns.task,\n leafColumns.priority,\n leafColumns.issueType,\n leafColumns.developer,\n leafColumns.complete,\n ],\n [leafColumns, showColumnsGrouping],\n );\n\n // Фильтр по типу задачи задан сразу: так на стенде с самого начала видна\n // строка активных фильтров под блоком управления.\n const filteringStateAndSetter = useState({\n priority: 'All',\n issueType: ['Bug', 'Story', 'Epic', 'Improvement'],\n developer: '',\n globalFilter: '',\n });\n const sortingStateAndSetter = useState<readonly SortColumn[]>([]);\n const selectingRowStateAndSetter = useState(\n (): ReadonlySet<string | number> => new Set(),\n );\n\n const rowKeyGetter = useCallback((r: Row) => `${r.id}`, []);\n\n const bottomSummaryRows = useMemo<TSummaryRowData[]>(\n () => [\n {\n type: 'bottom',\n values: [\n { columnId: 'id', value: 'Итого' },\n { columnId: 'task', value: `Всего задач: ${rows.length}` },\n ],\n },\n ],\n [rows],\n );\n\n return (\n <div>\n <div\n style={{\n display: 'flex',\n gap: 12,\n flexWrap: 'wrap',\n alignItems: 'flex-end',\n marginBottom: 12,\n }}\n >\n <Select\n label=\"cellsSelection.mode\"\n value={selectionMode}\n onChange={(value) => setSelectionMode(value as CellsSelectionMode)}\n items={SELECTION_MODE_OPTIONS}\n style={{ width: 200 }}\n />\n <Select\n label=\"highlightActiveType\"\n value={highlightActiveType}\n onChange={(value) =>\n setHighlightActiveType(value as HighlightActiveType)\n }\n items={HIGHLIGHT_ACTIVE_TYPE_OPTIONS}\n style={{ width: 180 }}\n />\n </div>\n <div\n style={{\n display: 'flex',\n gap: 16,\n flexWrap: 'wrap',\n marginBottom: 12,\n }}\n >\n <Switch\n label=\"appearance.variant = 'clean'\"\n checked={variant === 'clean'}\n onChange={() =>\n setVariant((prev) => (prev === 'clean' ? 'default' : 'clean'))\n }\n />\n <Switch\n label=\"appearance.zebra\"\n checked={zebra}\n onChange={() => setZebra((prev) => !prev)}\n />\n <Switch\n label=\"Блок управления\"\n checked={showControlBlock}\n onChange={() => setShowControlBlock((prev) => !prev)}\n />\n <Switch\n label=\"Пагинация\"\n checked={showPagination}\n onChange={() => setShowPagination((prev) => !prev)}\n />\n <Switch\n label=\"Итоговая строка\"\n checked={showSummaryRow}\n onChange={() => setShowSummaryRow((prev) => !prev)}\n />\n <Switch\n label=\"Группировка шапки\"\n checked={showColumnsGrouping}\n onChange={() => setShowColumnsGrouping((prev) => !prev)}\n />\n <Switch\n label=\"Колонки на всю ширину\"\n checked={fillWidth}\n onChange={() => setFillWidth((prev) => !prev)}\n />\n </div>\n\n <TableCanvas\n // растягивание колонок срабатывает один раз при первой раскладке,\n // поэтому при переключении таблица пересоздаётся\n key={fillWidth ? 'fill' : 'fixed'}\n tableConfig={{\n appearance: { variant, zebra },\n containerStyle: { height: '80vh' },\n fullScreenEnabled: true,\n resizableColumn: true,\n editing: {\n onRowsChange: setRows,\n rowKeyGetter,\n },\n rowSize: {\n default: 'big',\n showInControl: true,\n },\n cellsSelection: { mode: selectionMode },\n highlightActiveType,\n searching: {\n enabled: true,\n debounceDelay: 400,\n },\n summaryRows: {\n showDefault: showSummaryRow,\n showInControl: true,\n },\n columnsControl: {\n enable: true,\n hiding: true,\n pinning: true,\n reorderingAside: true,\n reorderingHeader: true,\n pinnedDefault: ['id'],\n },\n rowMarkers: {\n startIndex: 1,\n },\n subRows: {\n getSubRows: (row) => row?.subRows,\n rowKeyGetter: (row) => row.id,\n },\n ...(showPagination && {\n pagination: {\n value: page,\n perPage,\n count: rows.length,\n onChangePageValue(value, scrollToTop) {\n setPage(value ?? 1);\n scrollToTop();\n },\n onChange(value, pageSize, scrollToTop) {\n setPage(\n pageSize !== undefined && pageSize !== perPage\n ? 1\n : value ?? 1,\n );\n setPerPage(pageSize ?? perPage);\n scrollToTop();\n },\n },\n }),\n controlBlock: {\n show: showControlBlock,\n rightSideInner: [\n {\n text: 'Скачать',\n contentLeft: <IconSb color=\"inherit\" />,\n 'data-test-id': 'download',\n },\n ],\n massActionPanel: {\n buttons: [\n {\n type: 'button',\n view: 'secondary',\n text: 'Действие',\n contentLeft: <IconSb color=\"inherit\" />,\n 'data-test-id': 'mass-action',\n },\n ],\n },\n },\n filtering: {\n state: filteringStateAndSetter,\n filtersInfo: {\n priority: {\n label: 'Priority',\n clearedValue: 'All',\n },\n issueType: {\n label: 'Issue Type',\n clearedValue: [],\n },\n developer: {\n label: 'Developer',\n clearedValue: '',\n },\n globalFilter: {\n label: 'Global filter',\n clearedValue: '',\n },\n },\n },\n selecting: {\n state: selectingRowStateAndSetter,\n rowKeyGetter,\n showDefault: true,\n },\n sorting: {\n state: sortingStateAndSetter,\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n bottomSummaryRows={bottomSummaryRows}\n />\n </div>\n );\n }"
|
|
50790
|
+
}
|
|
50791
|
+
]
|
|
50792
|
+
},
|
|
49955
50793
|
{
|
|
49956
50794
|
"component": "TableCanvas",
|
|
49957
50795
|
"feature": "FullScreenMode",
|
|
@@ -50091,8 +50929,8 @@
|
|
|
50091
50929
|
"feature": "IsLoading",
|
|
50092
50930
|
"legacy": false,
|
|
50093
50931
|
"summary": "*tableConfig.isLoading / tableConfig.loadingOverlay**",
|
|
50094
|
-
"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)",
|
|
50095
|
-
"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=\"
|
|
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```",
|
|
50096
50934
|
"api": [],
|
|
50097
50935
|
"stories": [
|
|
50098
50936
|
{
|
|
@@ -50100,6 +50938,12 @@
|
|
|
50100
50938
|
"displayName": "IsLoading",
|
|
50101
50939
|
"type": "full-code",
|
|
50102
50940
|
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/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 '@daisforge/ui/components/Switch';\nimport { ColumnConfig, TableCanvas } from '@daisforge/ui/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 }"
|
|
50103
50947
|
}
|
|
50104
50948
|
]
|
|
50105
50949
|
},
|
|
@@ -50629,6 +51473,134 @@
|
|
|
50629
51473
|
}
|
|
50630
51474
|
]
|
|
50631
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 '@daisforge/ui/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 '@daisforge/ui';\nimport { getTableCanvasLoggerGroupIds, TableCanvasLogger } from '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerFilterValue, TableCanvasLoggerItem } from '@daisforge/ui/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 '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@daisforge/ui/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 '@daisforge/ui';\nimport { TableCanvasLogger } from '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@daisforge/ui/components/TableCanvas';\nimport { IconCloudDownloadOutline } from '@daisforge/ui/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 '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@daisforge/ui/components/TableCanvas';\nimport { IconSyncError } from '@daisforge/ui/icons';\nimport { textNegative } from '@daisforge/ui/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 '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem, TableCanvasLoggerStatus } from '@daisforge/ui/components/TableCanvas';\nimport { textNegative, textPositive, textTertiary, textWarning } from '@daisforge/ui/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 '@daisforge/ui';\nimport { TableCanvasLogger } from '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@daisforge/ui/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 '@daisforge/ui';\nimport { TableCanvasLogger } from '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@daisforge/ui/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 '@daisforge/ui';\nimport { TableCanvasLogger } from '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@daisforge/ui/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 '@daisforge/ui';\nimport { TableCanvasLogger } from '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@daisforge/ui/components/TableCanvas';\nimport { IconCloudDownloadOutline } from '@daisforge/ui/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 '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerItem } from '@daisforge/ui/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 '@daisforge/ui/components/TableCanvas';\nimport type { TableCanvasLoggerGroupItem, TableCanvasLoggerMessageItem } from '@daisforge/ui/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
|
+
},
|
|
50632
51604
|
{
|
|
50633
51605
|
"component": "TableCanvas",
|
|
50634
51606
|
"feature": "Sorting",
|
|
@@ -50783,7 +51755,7 @@
|
|
|
50783
51755
|
"feature": "SubRows",
|
|
50784
51756
|
"legacy": false,
|
|
50785
51757
|
"summary": "*tableConfig.subRows + columnConfig.subRow**",
|
|
50786
|
-
"docs": "# SubRows (TableCanvas)\n\n**tableConfig.subRows + columnConfig.subRow**\n\nИерархичное отображение данных с вложенными строками. Поддерживает произвольную глубину вложенности.\n\nКонфигурация состоит из двух частей:\n\n- **`tableConfig.subRows`** — дерево данных: функция получения дочерних строк, ключ строки, состояние раскрытия\n- **`columnConfig[].subRow`** — отображение на уровне колонки: маппинг ключей, рендер ячеек, стрелка раскрытия\n\n## tableConfig.subRows\n\n- **`getSubRows`** `(row) => RowType[] | undefined` — функция получения дочерних строк\n- **`rowKeyGetter`** `(row) => RowIdType` — уникальный ключ строки\n- **`expandedIdsState`** `[Set, setter]` — внешний стейт развёрнутых строк (опционально, иначе внутренний useState)\n\n## columnConfig.subRow\n\n- **`isColumnWithArrow`** `boolean | ((props) => boolean)` — стрелка раскрытия в этой колонке (default: `false`)\n- **`hideHeaderExpandAllArrow`** `boolean` — скрыть кнопку «развернуть все» в header (default: `false`)\n- **`parentKeyAsDefault`** `boolean` — использовать ключ родителя как fallback (default: `false`)\n- **`keyOfColumnInSubRow`** `string | number | ((lvl) => string | number)` — маппинг ключей колонок для каждого уровня\n- **`contentFormat`** `ContentFormat` — формат содержимого подстрок\n- **`renderSubRowCell`** `RenderSubRowCell` — кастомный рендер ячеек подстрок\n\n> Подробнее о типах — [SubRows API](?path=/docs/локальные-компоненты-tablecanvas-subrows-api--docs)",
|
|
51758
|
+
"docs": "# SubRows (TableCanvas)\n\n**tableConfig.subRows + columnConfig.subRow**\n\nИерархичное отображение данных с вложенными строками. Поддерживает произвольную глубину вложенности.\n\nКонфигурация состоит из двух частей:\n\n- **`tableConfig.subRows`** — дерево данных: функция получения дочерних строк, ключ строки, состояние раскрытия\n- **`columnConfig[].subRow`** — отображение на уровне колонки: маппинг ключей, рендер ячеек, стрелка раскрытия\n\n## tableConfig.subRows\n\n- **`getSubRows`** `(row) => RowType[] | undefined` — функция получения дочерних строк\n- **`rowKeyGetter`** `(row) => RowIdType` — уникальный ключ строки\n- **`expandedIdsState`** `[Set, setter]` — внешний стейт развёрнутых строк (опционально, иначе внутренний useState)\n\n## columnConfig.subRow\n\n- **`isColumnWithArrow`** `boolean | ((props) => boolean)` — стрелка раскрытия в этой колонке (default: `false`)\n- **`hideHeaderExpandAllArrow`** `boolean` — скрыть кнопку «развернуть все» в header (default: `false`)\n- **`parentKeyAsDefault`** `boolean` — использовать ключ родителя как fallback (default: `false`)\n- **`keyOfColumnInSubRow`** `string | number | ((lvl) => string | number)` — маппинг ключей колонок для каждого уровня\n- **`contentFormat`** `ContentFormat` — формат содержимого подстрок\n- **`renderSubRowCell`** `RenderSubRowCell` — кастомный рендер ячеек подстрок\n\n## Ленивая подгрузка детей («Показать ещё»)\n\nКогда детей у группы много и грузить их все сразу нельзя, подгрузка собирается из штатных возможностей без доработок ядра:\n\n- `getSubRows` возвращает загруженных детей плюс одну служебную строку `loadMore` в конце\n- `mergeCells.mergedCellsRegions` объединяет служебную строку на все колонки (регион задан ключом строки, у свёрнутой группы он не рисуется)\n- `renderSubRowCell` для служебной строки возвращает `Canvas.Container` со ссылкой «Показать ещё N» (кликабельный контейнер с `Canvas.Text`) и счётчиком «Показано X из Y»; по клику потребитель догружает порцию и пересобирает `subRows`\n- фон строки задаётся через `themeOverride`\n- в стори включён чистый вид (`appearance: { variant: 'clean' }`), колонки растягиваются на всю ширину\n\nПример — стори «Ленивая подгрузка детей группы».\n\n> Подробнее о типах — [SubRows API](?path=/docs/локальные-компоненты-tablecanvas-subrows-api--docs)",
|
|
50787
51759
|
"apiDocs": "# SubRows API\n\n## SubRows\n\n```typescript\ntype SubRows<RowType, RowIdType> = {\n /**\n * Возвращает дочерние строки узла (или undefined, если их нет).\n *\n * Функция должна быть стабильной — не менять поведение между рендерами.\n * Если она зависит от чего-то меняющегося, оберните её в useCallback.\n */\n getSubRows: (row: RowType) => RowType[] | undefined;\n /**\n * Возвращает уникальный ключ строки.\n *\n * Функция должна быть стабильной — не менять поведение между рендерами.\n * Если она зависит от чего-то меняющегося, оберните её в useCallback.\n */\n rowKeyGetter: (row: RowType) => RowIdType;\n /**\n * Внешний стейт развёрнутых строк.\n * Если не задан — используется внутренний useState.\n * При view: 'merged' не используется: сворачивания в этом виде нет.\n */\n expandedIdsState?: [\n Set<string | number>,\n (\n newV:\n | Set<string | number>\n | ((prev: Set<string | number>) => Set<string | number>),\n ) => void,\n ];\n /**\n * Как показывать дерево.\n * 'tree' (по умолчанию) — узлы с раскрытием (шевроны) и отступом по уровню.\n * 'merged' — дерево разворачивается в листья, а колонки-предки показаны\n * объединёнными ячейками. Структуру задаёт потребитель через getSubRows;\n * данные (пагинация, сортировка, поиск) остаются на его стороне.\n */\n view?: 'tree' | 'merged';\n /**\n * Только для view: 'merged'. Колонки-предки по порядку уровней:\n * mergedColumns[0] — верхний уровень, дальше глубже. Каждая такая колонка\n * показывает значение своего узла-предка (узел должен нести поле с этим именем)\n * и объединяется по его границам. Верхний уровень задаёт чекбокс и номер блока.\n */\n mergedColumns?: string[];\n};\n```",
|
|
50788
51760
|
"api": [
|
|
50789
51761
|
{
|
|
@@ -50797,6 +51769,12 @@
|
|
|
50797
51769
|
"displayName": "Иерархичный вид",
|
|
50798
51770
|
"type": "full-code",
|
|
50799
51771
|
"code": "import { ColumnConfig, TableCanvas } from '@daisforge/ui/components/TableCanvas';\n\n() => {\n // Разная глубина и число детей у строк — «рваная лестница» отступов\n const [rows] = useState(() => createRaggedRowsTree());\n\n const columns = useMemo(\n (): readonly ColumnConfig<TreeRow>[] => [\n {\n key: 'block',\n name: 'Блок / Трайб / Продукт',\n\n subRow: {\n keyOfColumnInSubRow: (lvl) => {\n switch (lvl) {\n case 0:\n return 'block';\n case 1:\n return 'tribe';\n default:\n return 'product';\n }\n },\n\n isColumnWithArrow: true,\n hideHeaderExpandAllArrow: false,\n },\n },\n {\n key: 'blockActivity',\n name: 'Активность блока',\n },\n {\n key: ' ',\n name: 'Локация трайба',\n subRow: {\n renderSubRowCell: (props, lvl) => {\n if (lvl === 1) {\n return (\n <Canvas.Container\n alignItems=\"center\"\n padding={{ left: 8 }}\n style={{ width: '100%' }}\n >\n <Canvas.Badge\n id=\"kek\"\n text={props.row?.tribeZone}\n view=\"accent\"\n size=\"m\"\n />\n </Canvas.Container>\n );\n }\n return '';\n },\n },\n },\n {\n key: 'q1',\n name: 'Q1',\n\n subRow: {\n parentKeyAsDefault: true,\n },\n },\n\n {\n key: 'q2',\n name: 'Q2',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q3',\n name: 'Q3',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q4',\n name: 'Q4',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n ],\n [],\n );\n\n return (\n <TableCanvas\n tableConfig={{\n containerStyle: { height: '85vh' },\n subRows: {\n getSubRows: (row) => row?.subRows,\n rowKeyGetter: (row) => row.id,\n },\n // Отступ уровня зависит от размера строки: big 16/66/116,\n // medium 6/42/78, small 4/32/60 px\n rowSize: { showInControl: true, default: 'big' },\n fullScreenEnabled: true,\n resizableColumn: true,\n }}\n columnConfig={columns}\n rows={rows}\n />\n );\n }"
|
|
51772
|
+
},
|
|
51773
|
+
{
|
|
51774
|
+
"exportName": "LazyLoadChildren",
|
|
51775
|
+
"displayName": "Ленивая подгрузка детей группы",
|
|
51776
|
+
"type": "full-code",
|
|
51777
|
+
"code": "const STEP = 10; // сколько детей догружаем за клик\nconst COL_KEYS = ['name', 'activity', 'location', 'amount'];\n\n// Дети группы для таблицы: загруженные + служебная строка «Показать ещё», пока есть что грузить.\nconst buildSubRows = (group) => {\n const children = Array.from({ length: group.loaded }, (_, i) => makeChild(group.id, i));\n if (group.loaded < group.total) {\n children.push({ id: \\"
|
|
50800
51778
|
}
|
|
50801
51779
|
]
|
|
50802
51780
|
},
|
|
@@ -50883,7 +51861,7 @@
|
|
|
50883
51861
|
"feature": "Tooltip",
|
|
50884
51862
|
"legacy": false,
|
|
50885
51863
|
"summary": "*tableConfig.tooltip + columnConfig.cellTooltip / headerCellTooltip**",
|
|
50886
|
-
"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).",
|
|
50887
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```",
|
|
50888
51866
|
"api": [
|
|
50889
51867
|
{
|
|
@@ -51052,12 +52030,12 @@
|
|
|
51052
52030
|
"feature": "columnsControl",
|
|
51053
52031
|
"legacy": true,
|
|
51054
52032
|
"summary": "Пользовательская настройка колонок legacy `Table`.",
|
|
51055
|
-
"docs": "# ColumnsControl\n\nПользовательская настройка колонок legacy `Table`.\n\n## Ключевые особенности\n\n- Включение через `tableConfig.columnsControl.enable`\n- Скрытие, закрепление и переупорядочивание колонок\n- Запрет скрытия или закрепления отдельных колонок\n- Дефолтные состояния `orderDefault`, `hiddenDefault`, `pinnedDefault`\n- Колбэк `onConfirm` для сохранения настроек вне таблицы\n\n## Особенности\n\n`columnsControl` может работать вместе с изменением ширины колонок и с `keyText`. Для группированных колонок проверяйте итоговый порядок leaf-колонок.\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-columnscontrol-api--docs).",
|
|
51056
|
-
"apiDocs": "# Columns Control API\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
|
|
52033
|
+
"docs": "# ColumnsControl\n\nПользовательская настройка колонок legacy `Table`.\n\n## Ключевые особенности\n\n- Включение через `tableConfig.columnsControl.enable`\n- Скрытие, закрепление и переупорядочивание колонок\n- Запрет скрытия или закрепления отдельных колонок\n- Дефолтные состояния `orderDefault`, `hiddenDefault`, `pinnedDefault`\n- Колбэк `onConfirm` для сохранения настроек вне таблицы\n- Режим применения `applyMode`: `confirm` (кнопки «Отменить»/«Применить», по умолчанию) или `instant` (без кнопок, каждое действие в панели сразу меняет таблицу и вызывает `onConfirm`)\n\n## Особенности\n\n`columnsControl` может работать вместе с изменением ширины колонок и с `keyText`. Для группированных колонок проверяйте итоговый порядок leaf-колонок.\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-columnscontrol-api--docs).",
|
|
52034
|
+
"apiDocs": "# Columns Control API\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
|
|
51057
52035
|
"api": [
|
|
51058
52036
|
{
|
|
51059
52037
|
"typeName": "ColumnsControlConfig",
|
|
51060
|
-
"source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
|
|
52038
|
+
"source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
|
|
51061
52039
|
}
|
|
51062
52040
|
],
|
|
51063
52041
|
"stories": [
|
|
@@ -51067,6 +52045,12 @@
|
|
|
51067
52045
|
"type": "full-code",
|
|
51068
52046
|
"code": "import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n Badge,\n Box,\n Button,\n ColumnConfig,\n ColumnOrColumnGroupConfig,\n RenderCellProps,\n RowHeightFunc,\n SIZES,\n Select,\n Switch,\n Table,\n TextField,\n} from '@daisforge/ui';\nimport { IconAddOutline, IconBoxOutline, IconSber } from '@daisforge/ui/icons';\n\n() => {\n const [rows] = useState(createRows);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n {\n key: 'id',\n name: 'ID',\n },\n {\n key: 'task',\n name: 'Title',\n },\n {\n key: 'priority',\n name: 'Priority',\n },\n {\n key: 'issueType',\n name: 'Issue Type',\n },\n {\n key: 'developer',\n name: 'Developer',\n },\n {\n key: 'tr1',\n name: 'TR',\n },\n {\n key: 'complete',\n name: '% Complete',\n },\n ],\n [],\n );\n\n return (\n <Table\n tableConfig={{\n containerStyle: { height: 700 },\n columnsControl: {\n enable: true,\n hiding: true,\n disableHiding: ['id'],\n pinning: true,\n disablePinning: ['developer'],\n reorderingAside: true,\n reorderingHeader: true,\n columnsLabel: {\n task: 'Задачи',\n },\n orderDefault: ['id', 'issueType', 'task'],\n hiddenDefault: ['tr1'],\n pinnedDefault: ['complete'],\n onConfirm: ({ order, hidden, pinned }, _setters) => {\n // eslint-disable-next-line no-alert\n alert(`\n order: ${order.join(', ')}\n pinned: ${pinned.join(', ')}\n hidden: ${hidden.join(', ')}\n `);\n },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n );\n }"
|
|
51069
52047
|
},
|
|
52048
|
+
{
|
|
52049
|
+
"exportName": "ColumnsControlInstantApply",
|
|
52050
|
+
"displayName": "ID",
|
|
52051
|
+
"type": "full-code",
|
|
52052
|
+
"code": "import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n Badge,\n Box,\n Button,\n ColumnConfig,\n ColumnOrColumnGroupConfig,\n RenderCellProps,\n RowHeightFunc,\n SIZES,\n Select,\n Switch,\n Table,\n TextField,\n} from '@daisforge/ui';\nimport { IconAddOutline, IconBoxOutline, IconSber } from '@daisforge/ui/icons';\n\n() => {\n const [rows] = useState(createRows);\n const [confirmLog, setConfirmLog] = useState<string[]>([]);\n\n const columnConfig = useMemo<readonly ColumnConfig<Row>[]>(\n () => [\n { key: 'id', name: 'ID' },\n { key: 'task', name: 'Title' },\n { key: 'priority', name: 'Priority' },\n { key: 'issueType', name: 'Issue Type' },\n { key: 'developer', name: 'Developer' },\n { key: 'tr1', name: 'TR' },\n { key: 'complete', name: '% Complete' },\n ],\n [],\n );\n\n return (\n <Box $css={{ display: 'flex', flexDirection: 'column', gap: '8px' }}>\n <Box\n data-testid=\"confirm-log\"\n $css={{\n height: '96px',\n overflowY: 'auto',\n padding: '8px 12px',\n borderRadius: '8px',\n backgroundColor: surfaceTransparentPrimary,\n fontSize: '12px',\n lineHeight: '18px',\n fontFamily: 'monospace',\n whiteSpace: 'pre',\n }}\n >\n {confirmLog.length\n ? confirmLog.join('\\n')\n : 'Вызовы onConfirm: откройте настройки колонок и измените что-нибудь'}\n </Box>\n <Table\n tableConfig={{\n containerStyle: { height: 600 },\n columnsControl: {\n enable: true,\n applyMode: 'instant',\n disableHiding: ['id'],\n disablePinning: ['developer'],\n hiddenDefault: ['tr1'],\n pinnedDefault: ['complete'],\n onConfirm: ({ order, hidden, pinned, changed }) => {\n setConfirmLog((prev) => [\n [\n `#${prev.length + 1} изменилось: ${Object.keys(\n changed,\n ).join(', ')}`,\n ` order: ${order.join(', ')}`,\n ` pinned: ${pinned.join(', ')}`,\n ` hidden: ${hidden.join(', ')}`,\n ].join('\\n'),\n ...prev,\n ]);\n },\n },\n }}\n columnConfig={columnConfig}\n rows={rows}\n />\n </Box>\n );\n }"
|
|
52053
|
+
},
|
|
51070
52054
|
{
|
|
51071
52055
|
"exportName": "ColumnsControlDynamicColumn",
|
|
51072
52056
|
"displayName": "ColumnsControl: динамическое добавление колонки",
|
|
@@ -51341,7 +52325,7 @@
|
|
|
51341
52325
|
"legacy": true,
|
|
51342
52326
|
"summary": "Data-атрибуты для автотестов и аналитики",
|
|
51343
52327
|
"docs": "# DomMetadata\n\n## Ключевые особенности\n\n- Data-атрибуты для автотестов и аналитики\n- CSS-классы для элементов таблицы и фич\n- Поддержка action metadata для интерактивных элементов\n\n**Метки для автоматизированного тестирования, аналитики и онбординга**\n\n`DomMetadata` позволяет навешивать CSS-классы, data-атрибуты и обработчики кликов на интерактивные элементы таблицы.\nЭто нужно для:\n\n- **Аналитики** — трекинг кликов по кнопкам таблицы\n- **Автотестов** — поиск элементов по `data-testid`\n- **Онбординга** — привязка подсказок к конкретным элементам\n\n## Поддерживаемые элементы (className, dataAttributes)\n\nСледующие элементы поддерживают `className` и `dataAttributes` через `domMetadata`:\n\n**Control Block (панель управления):**\n\n- **Редактирование** — `tableConfig.editing.domMetadata`\n- **Полноэкранный режим** — `tableConfig.fullScreenEnabled.domMetadata`\n- **Размер строки** — `tableConfig.rowSize.domMetadata`\n- **Переключение вида** (строки/карточки) — `tableConfig.view.domMetadata`\n- **Группировка строк** — `tableConfig.rowsGrouping.domMetadata`\n- **Поиск** — `tableConfig.searching.domMetadata`\n- **Итоговые строки** — `tableConfig.summaryRows.domMetadata`\n- **KeyText** (controlBlock) — `tableConfig.keyText.controlBlock.domMetadata`\n- **KeyText** (sidebar) — `tableConfig.keyText.sidebar.domMetadata`\n\n**Selecting (выбор строк):**\n\n- **Чекбокс \"Выбрать все\"** (controlBlock) — `tableConfig.selecting.controlBlock.domMetadata`\n- **Свитч в сайдбаре** — `tableConfig.selecting.sidebar.domMetadata`\n\n**Sidebar (правая панель):**\n\n- **Табы сайдбара** — `tableConfig.sidebarConfig.defaultTabs[].domMetadata`\n- **Подтабы настроек** (Фильтры, Столбцы) — `tableConfig.sidebarConfig.defaultTabs[{id:'filtering'|'columns'}].domMetadata`\n\n**Другие:**\n\n- **Кнопка сворачивания таблицы** — `tableConfig.collapse.domMetadata`\n\n## Элементы с расширенным onClick (className, dataAttributes, onClick + detail)\n\nВ дополнение к `className` и `dataAttributes`, следующие элементы поддерживают `onClick` с контекстом `detail`:\n\n- **Группировать** (чекбоксы, сброс) — `tableConfig.rowsGrouping.domMetadata` — actions: `toggle-group`, `reset-groups`, `custom-item-select`\n- **Кнопка размера строки** — `tableConfig.rowSize.domMetadata` — action: `change-row-size`\n- **Шестеренка настроек** — `tableConfig.sidebarConfig.defaultTabs[{id:'tableSettings'}].domMetadata` — action: `toggle-sidebar-tab`\n- **Крестик закрыть сайдбар** — тот же `domMetadata` таба — action: `close-sidebar`\n- **Закрепить столбец** — `tableConfig.columnsControl.pinDomMetadata` — actions: `pin-column`, `unpin-column`\n- **Свитчер видимости столбца** — `tableConfig.columnsControl.switchDomMetadata` — actions: `show-column`, `hide-column`\n\n## onClick\n\nОбработчик `onClick` вызывается **после** основной логики элемента. Он не мешает работе кнопки и не вызывает `stopPropagation`.\n\n```tsx\nonClick?: (\n e?: React.MouseEvent<HTMLElement>, // MouseEvent (undefined для элементов внутри Dropdown)\n detail?: Record<string, unknown> // контекст: action, columnKey, size и др.\n) => void;\n```\n\n### Примеры detail\n\n```ts\n// Группировка\n{ action: 'toggle-group', columnKey: 'status' }\n{ action: 'reset-groups' }\n\n// Размер строки\n{ action: 'change-row-size', size: 'medium' }\n\n// Сайдбар\n{ action: 'toggle-sidebar-tab', tabId: 'tableSettings' }\n{ action: 'close-sidebar' }\n\n// Столбцы\n{ action: 'pin-column', columnKey: 'name' }\n{ action: 'unpin-column', columnKey: 'name' }\n{ action: 'hide-column', columnKey: 'name' }\n{ action: 'show-column', columnKey: 'name' }\n```\n\nПодробнее о типах — в разделе [API](?path=/docs/локальные-компоненты-table-dommetadata-api--docs).",
|
|
51344
|
-
"apiDocs": "# DomMetadata API\n\n## DomMetadata\n\n```typescript\ntype DomMetadata = {\n /**\n * CSS класс для стилизации и поиска элемента\n *\n * @example 'user-profile-card'\n * @example 'onboarding-step-1'\n */\n className?: string;\n /**\n * Data-атрибуты для тестирования, аналитики и онбординга\n *\n * @example { 'data-testid': 'submit-button', 'data-analytics': 'click-event' }\n */\n dataAttributes?: DataAttributes;\n /**\n * Обработчик клика для аналитики и трекинга\n *\n * Вызывается вместе с основным обработчиком элемента (не заменяет его).\n * Не вызывает stopPropagation — оригинальная логика кнопки сохраняется.\n *\n * @param e - MouseEvent (может быть undefined для элементов внутри Dropdown)\n * @param detail - контекст действия: action, columnKey, size и др.\n *\n * @example onClick: (e, detail) => analytics.track(detail?.action, detail)\n */\n onClick?: (\n e?: React.MouseEvent<HTMLElement>,\n detail?: Record<string, unknown>,\n ) => void;\n};\n```\n\n## DOM_METADATA_ACTIONS\n\n```typescript\nexport const DOM_METADATA_ACTIONS = {\n /** Включение/выключение группировки по столбцу. detail.columnKey — ключ столбца */\n TOGGLE_GROUP: 'toggle-group',\n /** Сброс всех группировок */\n RESET_GROUPS: 'reset-groups',\n /** Выбор пункта в кастомном onItemSelect группировки. detail.columnKey — ключ */\n CUSTOM_ITEM_SELECT: 'custom-item-select',\n /** Переключение размера строки. detail.size — новый размер ('small' | 'medium' | 'big') */\n CHANGE_ROW_SIZE: 'change-row-size',\n /** Клик по табу сайдбара (шестерёнка и др.). detail.tabId — id таба */\n TOGGLE_SIDEBAR_TAB: 'toggle-sidebar-tab',\n /** Закрытие сайдбара (крестик) */\n CLOSE_SIDEBAR: 'close-sidebar',\n /** Закрепление столбца. detail.columnKey — ключ столбца */\n PIN_COLUMN: 'pin-column',\n /** Открепление столбца. detail.columnKey — ключ столбца */\n UNPIN_COLUMN: 'unpin-column',\n /** Скрытие столбца. detail.columnKey — ключ столбца */\n HIDE_COLUMN: 'hide-column',\n /** Показ столбца. detail.columnKey — ключ столбца */\n SHOW_COLUMN: 'show-column',\n} as const;\n```\n\n## DomMetadataAction\n\n```typescript\ntype DomMetadataAction =\n (typeof DOM_METADATA_ACTIONS)[keyof typeof DOM_METADATA_ACTIONS];\n```\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
|
|
52328
|
+
"apiDocs": "# DomMetadata API\n\n## DomMetadata\n\n```typescript\ntype DomMetadata = {\n /**\n * CSS класс для стилизации и поиска элемента\n *\n * @example 'user-profile-card'\n * @example 'onboarding-step-1'\n */\n className?: string;\n /**\n * Data-атрибуты для тестирования, аналитики и онбординга\n *\n * @example { 'data-testid': 'submit-button', 'data-analytics': 'click-event' }\n */\n dataAttributes?: DataAttributes;\n /**\n * Обработчик клика для аналитики и трекинга\n *\n * Вызывается вместе с основным обработчиком элемента (не заменяет его).\n * Не вызывает stopPropagation — оригинальная логика кнопки сохраняется.\n *\n * @param e - MouseEvent (может быть undefined для элементов внутри Dropdown)\n * @param detail - контекст действия: action, columnKey, size и др.\n *\n * @example onClick: (e, detail) => analytics.track(detail?.action, detail)\n */\n onClick?: (\n e?: React.MouseEvent<HTMLElement>,\n detail?: Record<string, unknown>,\n ) => void;\n};\n```\n\n## DOM_METADATA_ACTIONS\n\n```typescript\nexport const DOM_METADATA_ACTIONS = {\n /** Включение/выключение группировки по столбцу. detail.columnKey — ключ столбца */\n TOGGLE_GROUP: 'toggle-group',\n /** Сброс всех группировок */\n RESET_GROUPS: 'reset-groups',\n /** Выбор пункта в кастомном onItemSelect группировки. detail.columnKey — ключ */\n CUSTOM_ITEM_SELECT: 'custom-item-select',\n /** Переключение размера строки. detail.size — новый размер ('small' | 'medium' | 'big') */\n CHANGE_ROW_SIZE: 'change-row-size',\n /** Клик по табу сайдбара (шестерёнка и др.). detail.tabId — id таба */\n TOGGLE_SIDEBAR_TAB: 'toggle-sidebar-tab',\n /** Закрытие сайдбара (крестик) */\n CLOSE_SIDEBAR: 'close-sidebar',\n /** Закрепление столбца. detail.columnKey — ключ столбца */\n PIN_COLUMN: 'pin-column',\n /** Открепление столбца. detail.columnKey — ключ столбца */\n UNPIN_COLUMN: 'unpin-column',\n /** Скрытие столбца. detail.columnKey — ключ столбца */\n HIDE_COLUMN: 'hide-column',\n /** Показ столбца. detail.columnKey — ключ столбца */\n SHOW_COLUMN: 'show-column',\n} as const;\n```\n\n## DomMetadataAction\n\n```typescript\ntype DomMetadataAction =\n (typeof DOM_METADATA_ACTIONS)[keyof typeof DOM_METADATA_ACTIONS];\n```\n\n## ColumnsControlConfig\n\n```typescript\ntype ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};\n```",
|
|
51345
52329
|
"api": [
|
|
51346
52330
|
{
|
|
51347
52331
|
"typeName": "DomMetadata",
|
|
@@ -51357,7 +52341,7 @@
|
|
|
51357
52341
|
},
|
|
51358
52342
|
{
|
|
51359
52343
|
"typeName": "ColumnsControlConfig",
|
|
51360
|
-
"source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
|
|
52344
|
+
"source": "type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n /**\n * Как применяются изменения из панели настройки колонок (правый сайдбар).\n * - `confirm` — панель копит изменения локально, внизу кнопки «Отменить» и\n * «Применить»; в таблицу и в `onConfirm` изменения уходят по кнопке.\n * - `instant` — кнопок нет, каждое действие (свитч видимости, пин, перенос,\n * «открепить все» и т.п.) сразу меняет таблицу, а `onConfirm` вызывается\n * после каждого такого действия с тем же контрактом, что и по кнопке.\n * @default 'confirm'\n */\n applyMode?: ColumnsControlApplyMode;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};"
|
|
51361
52345
|
}
|
|
51362
52346
|
],
|
|
51363
52347
|
"stories": [
|
|
@@ -52008,7 +52992,7 @@
|
|
|
52008
52992
|
"feature": "subRows",
|
|
52009
52993
|
"legacy": true,
|
|
52010
52994
|
"summary": "Иерархичные строки legacy `Table`.",
|
|
52011
|
-
"docs": "# SubRows\n\nИерархичные строки legacy `Table`.\n\n## Ключевые особенности\n\n- Вложенные строки подключаются через `tableConfig.subRows`\n- `getSubRows` возвращает дочерние строки\n- `rowKeyGetter` задает уникальный ключ строки\n- `columnConfig.subRow` управляет отображением данных дочерних строк\n- Можно показать chevron раскрытия и кастомный render дочерней ячейки\n\n## Особенности\n\nДля вложенных строк важно иметь стабильный `rowKeyGetter`. Если нужно группировать плоский набор данных, используйте `rowsGrouping`, а не `subRows`.\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-subrows-api--docs).",
|
|
52995
|
+
"docs": "# SubRows\n\nИерархичные строки legacy `Table`.\n\n## Ключевые особенности\n\n- Вложенные строки подключаются через `tableConfig.subRows`\n- `getSubRows` возвращает дочерние строки\n- `rowKeyGetter` задает уникальный ключ строки\n- `columnConfig.subRow` управляет отображением данных дочерних строк\n- Можно показать chevron раскрытия и кастомный render дочерней ячейки\n\n## Особенности\n\nДля вложенных строк важно иметь стабильный `rowKeyGetter`. Если нужно группировать плоский набор данных, используйте `rowsGrouping`, а не `subRows`.\n\n## Ленивая подгрузка детей («Показать ещё»)\n\nКогда детей у группы много и грузить их все сразу нельзя, подгрузка собирается из штатных возможностей без доработок ядра: `getSubRows` возвращает загруженных детей плюс служебную строку `loadMore`, `colSpan` первой колонки растягивает её на всю ширину, а `renderSubRowCell` рисует кнопку «Показать ещё N» со счётчиком. По клику потребитель догружает порцию и пересобирает `subRows`. Пример — стори «Ленивая подгрузка детей группы».\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-subrows-api--docs).",
|
|
52012
52996
|
"apiDocs": "# SubRows API\n\n## SubRows\n\n```typescript\ntype SubRows<RowType, RowIdType> = {\n getSubRows: (row: RowType) => RowType[] | undefined;\n rowKeyGetter: (row: RowType) => RowIdType;\n expandedIdsState?: [\n Set<string | number>,\n (\n newV:\n | Set<string | number>\n | ((prev: Set<string | number>) => Set<string | number>),\n ) => void,\n ];\n};\n```\n\n## RenderSubRowCell\n\n```typescript\ntype RenderSubRowCell<SubRowType extends ObjectForExtending> = (\n renderCellProps: RenderCellProps<SubRowType>,\n lvl: number,\n) => ReactNode;\n```\n\n## RenderSubRowEditCell\n\n```typescript\ntype RenderSubRowEditCell<SubRowType extends ObjectForExtending> = (\n renderCellProps: RenderEditCellProps<SubRowType>,\n lvl: number,\n) => ReactNode;\n```",
|
|
52013
52997
|
"api": [
|
|
52014
52998
|
{
|
|
@@ -52030,6 +53014,12 @@
|
|
|
52030
53014
|
"displayName": "Иерархичный вид",
|
|
52031
53015
|
"type": "full-code",
|
|
52032
53016
|
"code": "import React, { useMemo, useState } from 'react';\nimport { Badge, ColumnConfig, Table } from '@daisforge/ui';\n\n() => {\n const [rows] = useState(() => createRowsTree());\n\n const columns = useMemo(\n (): readonly ColumnConfig<TreeRow>[] => [\n {\n key: 'block',\n name: 'Блок / Трайб / Продукт',\n\n subRow: {\n keyOfColumnInSubRow: (lvl) => {\n switch (lvl) {\n case 0:\n return 'block';\n case 1:\n return 'tribe';\n case 2:\n return 'product';\n default:\n return 'block';\n }\n },\n\n isColumnWithArrow: true,\n hideHeaderExpandAllArrow: false,\n },\n resizable: true,\n },\n {\n key: 'blockActivity',\n name: 'Активность блока',\n },\n {\n key: '',\n minWidth: 170,\n\n name: 'Локация трайба',\n subRow: {\n renderSubRowCell: (props, lvl) => {\n if (lvl === 1) {\n return (\n <Badge view=\"accent\" size=\"m\">\n {props.row?.tribeZone}\n </Badge>\n );\n }\n return null;\n },\n },\n },\n {\n key: 'q1',\n name: 'Q1',\n\n subRow: {\n parentKeyAsDefault: true,\n },\n },\n\n {\n key: 'q2',\n name: 'Q2',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q3',\n name: 'Q3',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n {\n key: 'q4',\n name: 'Q4',\n subRow: {\n keyOfColumnInSubRow: 'q1',\n },\n },\n ],\n [],\n );\n\n return (\n <Table\n tableConfig={{\n containerStyle: { height: '700px' },\n subRows: {\n getSubRows: (row) => row?.subRows,\n rowKeyGetter: (row) => row.id,\n },\n resizableColumn: true,\n }}\n columnConfig={columns}\n rows={rows}\n />\n );\n }"
|
|
53017
|
+
},
|
|
53018
|
+
{
|
|
53019
|
+
"exportName": "LazyLoadChildren",
|
|
53020
|
+
"displayName": "Ленивая подгрузка детей группы",
|
|
53021
|
+
"type": "full-code",
|
|
53022
|
+
"code": "const STEP = 10; // сколько детей догружаем за клик\nconst COLS = 4; // число колонок — на столько растягиваем служебную строку\n\n// Дети группы для таблицы: загруженные + служебная строка «Показать ещё», пока есть что грузить.\nconst buildSubRows = (group) => {\n const children = Array.from({ length: group.loaded }, (_, i) => makeChild(group.id, i));\n if (group.loaded < group.total) {\n children.push({ id: \\"
|
|
52033
53023
|
}
|
|
52034
53024
|
]
|
|
52035
53025
|
},
|
|
@@ -52341,19 +53331,47 @@
|
|
|
52341
53331
|
"importStatement": "import { StorySlide } from '@daisforge/ui';",
|
|
52342
53332
|
"sourceFile": "packages/ui-kit/src/components/Stories/Stories.types.ts"
|
|
52343
53333
|
},
|
|
52344
|
-
"
|
|
53334
|
+
"ColumnConfig": {
|
|
52345
53335
|
"name": "ColumnConfig",
|
|
52346
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};",
|
|
52347
53337
|
"importPath": "@daisforge/ui",
|
|
52348
53338
|
"importStatement": "import { ColumnConfig } from '@daisforge/ui';",
|
|
52349
53339
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
52350
53340
|
},
|
|
52351
|
-
"
|
|
52352
|
-
"name": "
|
|
52353
|
-
"definition": "export type
|
|
53341
|
+
"TableCanvasLoggerGroupItem": {
|
|
53342
|
+
"name": "TableCanvasLoggerGroupItem",
|
|
53343
|
+
"definition": "export type TableCanvasLoggerGroupItem = TableCanvasLoggerItemBase & {\n items: TableCanvasLoggerItem[];\n /** Раскрыть группу при появлении. В управляемом `expandedIds` не применяется */\n defaultOpen?: boolean;\n};",
|
|
53344
|
+
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53345
|
+
"importStatement": "import { TableCanvasLoggerGroupItem } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
53352
|
+
"importStatement": "import { TableCanvasLoggerItem } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
53359
|
+
"importStatement": "import { TableCanvasLoggerMessageItem } from '@daisforge/ui/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';",
|
|
52354
53365
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52355
|
-
"importStatement": "import {
|
|
52356
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/
|
|
53366
|
+
"importStatement": "import { TableCanvasLoggerStatus } from '@daisforge/ui/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};",
|
|
53372
|
+
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53373
|
+
"importStatement": "import { TableCanvasLoggerClasses } from '@daisforge/ui/components/TableCanvas';",
|
|
53374
|
+
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
|
|
52357
53375
|
},
|
|
52358
53376
|
"TableGlide.ObjectForExtending": {
|
|
52359
53377
|
"name": "ObjectForExtending",
|
|
@@ -52383,9 +53401,16 @@
|
|
|
52383
53401
|
"importStatement": "import { HoverEffectsConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
52384
53402
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
52385
53403
|
},
|
|
53404
|
+
"AppearanceConfig": {
|
|
53405
|
+
"name": "AppearanceConfig",
|
|
53406
|
+
"definition": "export type AppearanceConfig = {\n /**\n * `'clean'` — «чистый» вид: без линий сетки и внешних рамок, шапка на белом\n * фоне с серым текстом.\n * @default 'default'\n */\n variant?: AppearanceVariant;\n /**\n * Зебра: строки через одну окрашены серым. Работает в любом `variant`.\n * @default false\n */\n zebra?: boolean;\n};",
|
|
53407
|
+
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53408
|
+
"importStatement": "import { AppearanceConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
53409
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
53410
|
+
},
|
|
52386
53411
|
"ColumnGlideInstance": {
|
|
52387
53412
|
"name": "ColumnGlideInstance",
|
|
52388
|
-
"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};",
|
|
52389
53414
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52390
53415
|
"importStatement": "import { ColumnGlideInstance } from '@daisforge/ui/components/TableCanvas';",
|
|
52391
53416
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
@@ -52656,76 +53681,41 @@
|
|
|
52656
53681
|
"importStatement": "import { StoriesObjectFit } from '@daisforge/ui';",
|
|
52657
53682
|
"sourceFile": "packages/ui-kit/src/components/Stories/Stories.types.ts"
|
|
52658
53683
|
},
|
|
52659
|
-
"
|
|
53684
|
+
"ColumnDefaultOmitted": {
|
|
52660
53685
|
"name": "ColumnDefaultOmitted",
|
|
52661
53686
|
"definition": "export type ColumnDefaultOmitted<\n Row extends ObjectForExtending,\n SummRow = unknown,\n> = Omit<ColumnDefault<Row, SummRow>, DefaultOmittedKeys>;",
|
|
52662
53687
|
"internal": true,
|
|
52663
53688
|
"importNotice": "Тип \"ColumnDefaultOmitted\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52664
53689
|
"sourceFile": "packages/ui-kit/src/components/Table/types/data-grid.type.ts"
|
|
52665
53690
|
},
|
|
52666
|
-
"
|
|
52667
|
-
"name": "ColumnDefaultOmitted",
|
|
52668
|
-
"definition": "export type ColumnDefaultOmitted<\n Row extends ObjectForExtending,\n SummRow = unknown,\n CustomCtxs extends ObjectForExtending = {},\n> = Omit<ColumnGlideInstance<Row, SummRow, CustomCtxs>, DefaultOmittedKeys>;",
|
|
52669
|
-
"internal": true,
|
|
52670
|
-
"importNotice": "Тип \"ColumnDefaultOmitted\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52671
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/glide-type.ts"
|
|
52672
|
-
},
|
|
52673
|
-
"Table.Comparator": {
|
|
53691
|
+
"Comparator": {
|
|
52674
53692
|
"name": "Comparator",
|
|
52675
53693
|
"definition": "export type Comparator<Row extends ObjectForExtending> = (\n a: Row,\n b: Row,\n) => number;",
|
|
52676
53694
|
"importPath": "@daisforge/ui",
|
|
52677
53695
|
"importStatement": "import { Comparator } from '@daisforge/ui';",
|
|
52678
53696
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
52679
53697
|
},
|
|
52680
|
-
"
|
|
52681
|
-
"name": "Comparator",
|
|
52682
|
-
"definition": "export type Comparator<Row extends ObjectForExtending> = (\n a: Row,\n b: Row,\n) => number;",
|
|
52683
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52684
|
-
"importStatement": "import { Comparator } from '@daisforge/ui/components/TableCanvas';",
|
|
52685
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
|
|
52686
|
-
},
|
|
52687
|
-
"Table.FilterCb": {
|
|
53698
|
+
"FilterCb": {
|
|
52688
53699
|
"name": "FilterCb",
|
|
52689
53700
|
"definition": "type FilterCb<Mode extends 'multiple' | 'single' | void = 'single'> = (\n filterV: Mode extends 'multiple' ? string[] : string,\n rowValue: string,\n) => boolean;",
|
|
52690
53701
|
"internal": true,
|
|
52691
53702
|
"importNotice": "Тип \"FilterCb\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52692
53703
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
52693
53704
|
},
|
|
52694
|
-
"
|
|
52695
|
-
"name": "FilterCb",
|
|
52696
|
-
"definition": "type FilterCb<Mode extends 'multiple' | 'single' | void = 'single'> = (\n filterV: Mode extends 'multiple' ? string[] : string,\n rowValue: string,\n) => boolean;",
|
|
52697
|
-
"internal": true,
|
|
52698
|
-
"importNotice": "Тип \"FilterCb\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52699
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
|
|
52700
|
-
},
|
|
52701
|
-
"Table.FilterComponentInPopoverProps": {
|
|
53705
|
+
"FilterComponentInPopoverProps": {
|
|
52702
53706
|
"name": "FilterComponentInPopoverProps",
|
|
52703
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};",
|
|
52704
53708
|
"internal": true,
|
|
52705
53709
|
"importNotice": "Тип \"FilterComponentInPopoverProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52706
53710
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-filtering/header-filter-button/types.ts"
|
|
52707
53711
|
},
|
|
52708
|
-
"
|
|
52709
|
-
"name": "FilterComponentInPopoverProps",
|
|
52710
|
-
"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};",
|
|
52711
|
-
"internal": true,
|
|
52712
|
-
"importNotice": "Тип \"FilterComponentInPopoverProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52713
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-filtering/header-filter-button/types.ts"
|
|
52714
|
-
},
|
|
52715
|
-
"Table.SelectOptions": {
|
|
53712
|
+
"SelectOptions": {
|
|
52716
53713
|
"name": "SelectOptions",
|
|
52717
53714
|
"definition": "export type SelectOptions = {\n value: string | number;\n text: string | number;\n};",
|
|
52718
53715
|
"importPath": "@daisforge/ui",
|
|
52719
53716
|
"importStatement": "import { SelectOptions } from '@daisforge/ui';",
|
|
52720
53717
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
52721
53718
|
},
|
|
52722
|
-
"TableCanvas.SelectOptions": {
|
|
52723
|
-
"name": "SelectOptions",
|
|
52724
|
-
"definition": "export type SelectOptions = {\n value: string | number;\n text: string | number;\n};",
|
|
52725
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52726
|
-
"importStatement": "import { SelectOptions } from '@daisforge/ui/components/TableCanvas';",
|
|
52727
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
|
|
52728
|
-
},
|
|
52729
53719
|
"Table.ContentFormat": {
|
|
52730
53720
|
"name": "ContentFormat",
|
|
52731
53721
|
"definition": "export type ContentFormat =\n | 'number' // Стандартное числовое форматирование с локалью ru-RU (разделитель тысяч: пробел, дробная часть: запятая)\n | CustomFormat\n | NumberFormatOptions;",
|
|
@@ -52740,125 +53730,62 @@
|
|
|
52740
53730
|
"importStatement": "import { ContentFormat } from '@daisforge/ui/components/TableCanvas';",
|
|
52741
53731
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
52742
53732
|
},
|
|
52743
|
-
"
|
|
53733
|
+
"Editing": {
|
|
52744
53734
|
"name": "Editing",
|
|
52745
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);",
|
|
52746
53736
|
"importPath": "@daisforge/ui",
|
|
52747
53737
|
"importStatement": "import { Editing } from '@daisforge/ui';",
|
|
52748
53738
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
52749
53739
|
},
|
|
52750
|
-
"
|
|
52751
|
-
"name": "Editing",
|
|
52752
|
-
"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);",
|
|
52753
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52754
|
-
"importStatement": "import { Editing } from '@daisforge/ui/components/TableCanvas';",
|
|
52755
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
|
|
52756
|
-
},
|
|
52757
|
-
"Table.KeyText": {
|
|
53740
|
+
"KeyText": {
|
|
52758
53741
|
"name": "KeyText",
|
|
52759
53742
|
"definition": "export type KeyText = 'key' | 'text' | 'keyText' | 'textKey';",
|
|
52760
53743
|
"internal": true,
|
|
52761
53744
|
"importNotice": "Тип \"KeyText\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52762
53745
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-key-text/types.ts"
|
|
52763
53746
|
},
|
|
52764
|
-
"
|
|
52765
|
-
"name": "KeyText",
|
|
52766
|
-
"definition": "export type KeyText = 'key' | 'text' | 'keyText' | 'textKey';",
|
|
52767
|
-
"internal": true,
|
|
52768
|
-
"importNotice": "Тип \"KeyText\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52769
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-key-text/types.ts"
|
|
52770
|
-
},
|
|
52771
|
-
"Table.RenderSubRowCell": {
|
|
53747
|
+
"RenderSubRowCell": {
|
|
52772
53748
|
"name": "RenderSubRowCell",
|
|
52773
53749
|
"definition": "export type RenderSubRowCell<SubRowType extends ObjectForExtending> = (\n renderCellProps: RenderCellProps<SubRowType>,\n lvl: number,\n) => ReactNode;",
|
|
52774
53750
|
"importPath": "@daisforge/ui",
|
|
52775
53751
|
"importStatement": "import { RenderSubRowCell } from '@daisforge/ui';",
|
|
52776
53752
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
52777
53753
|
},
|
|
52778
|
-
"
|
|
52779
|
-
"name": "RenderSubRowCell",
|
|
52780
|
-
"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;",
|
|
52781
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52782
|
-
"importStatement": "import { RenderSubRowCell } from '@daisforge/ui/components/TableCanvas';",
|
|
52783
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
|
|
52784
|
-
},
|
|
52785
|
-
"Table.ColumnRowsGrouping": {
|
|
53754
|
+
"ColumnRowsGrouping": {
|
|
52786
53755
|
"name": "ColumnRowsGrouping",
|
|
52787
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};",
|
|
52788
53757
|
"internal": true,
|
|
52789
53758
|
"importNotice": "Тип \"ColumnRowsGrouping\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52790
53759
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
|
|
52791
53760
|
},
|
|
52792
|
-
"
|
|
52793
|
-
"name": "ColumnRowsGrouping",
|
|
52794
|
-
"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};",
|
|
52795
|
-
"internal": true,
|
|
52796
|
-
"importNotice": "Тип \"ColumnRowsGrouping\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52797
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
|
|
52798
|
-
},
|
|
52799
|
-
"Table.KeyTextColumnConfig": {
|
|
53761
|
+
"KeyTextColumnConfig": {
|
|
52800
53762
|
"name": "KeyTextColumnConfig",
|
|
52801
53763
|
"definition": "export type KeyTextColumnConfig<\n Row extends ObjectForExtending,\n SummRow = unknown,\n> =\n | ((props: { keyText: KeyText }) => ColumnConfig<Row, SummRow>)\n | ColumnConfig<Row, SummRow>;",
|
|
52802
53764
|
"importPath": "@daisforge/ui",
|
|
52803
53765
|
"importStatement": "import { KeyTextColumnConfig } from '@daisforge/ui';",
|
|
52804
53766
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
52805
53767
|
},
|
|
52806
|
-
"
|
|
52807
|
-
"name": "
|
|
52808
|
-
"definition": "
|
|
52809
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52810
|
-
"importStatement": "import { KeyTextColumnConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
52811
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
|
|
52812
|
-
},
|
|
52813
|
-
"TableCanvas.CellInfo": {
|
|
52814
|
-
"name": "CellInfo",
|
|
52815
|
-
"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};",
|
|
52816
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52817
|
-
"importStatement": "import { CellInfo } from '@daisforge/ui/components/TableCanvas';",
|
|
52818
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
|
|
52819
|
-
},
|
|
52820
|
-
"TableGlide.CellInfo": {
|
|
52821
|
-
"name": "CellInfo",
|
|
52822
|
-
"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};",
|
|
52823
53771
|
"internal": true,
|
|
52824
|
-
"importNotice": "Тип \"
|
|
52825
|
-
"sourceFile": "packages/ui-kit/src/components/
|
|
52826
|
-
},
|
|
52827
|
-
"CellContent": {
|
|
52828
|
-
"name": "CellContent",
|
|
52829
|
-
"definition": "export type CellContent = CanvasContent | GridCell;",
|
|
52830
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52831
|
-
"importStatement": "import { CellContent } from '@daisforge/ui/components/TableCanvas';",
|
|
52832
|
-
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
53772
|
+
"importNotice": "Тип \"TableCanvasLoggerItemBase\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
53773
|
+
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
|
|
52833
53774
|
},
|
|
52834
|
-
"
|
|
52835
|
-
"name": "
|
|
52836
|
-
"definition": "export type
|
|
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};",
|
|
52837
53778
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52838
|
-
"importStatement": "import {
|
|
52839
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/
|
|
53779
|
+
"importStatement": "import { TableCanvasLoggerAction } from '@daisforge/ui/components/TableCanvas';",
|
|
53780
|
+
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
|
|
52840
53781
|
},
|
|
52841
|
-
"
|
|
52842
|
-
"name": "
|
|
52843
|
-
"definition": "export type
|
|
53782
|
+
"AppearanceVariant": {
|
|
53783
|
+
"name": "AppearanceVariant",
|
|
53784
|
+
"definition": "export type AppearanceVariant = 'default' | 'clean';",
|
|
52844
53785
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52845
|
-
"importStatement": "import {
|
|
53786
|
+
"importStatement": "import { AppearanceVariant } from '@daisforge/ui/components/TableCanvas';",
|
|
52846
53787
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
52847
53788
|
},
|
|
52848
|
-
"HeaderAlignment": {
|
|
52849
|
-
"name": "HeaderAlignment",
|
|
52850
|
-
"definition": "export type HeaderAlignment = {\n /** По горизонтали. @default 'left' */\n horizontal?: 'left' | 'center' | 'right';\n /** По вертикали. @default 'center' */\n vertical?: 'top' | 'center' | 'bottom';\n};",
|
|
52851
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52852
|
-
"importStatement": "import { HeaderAlignment } from '@daisforge/ui/components/TableCanvas';",
|
|
52853
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/columns-grouping.type.ts"
|
|
52854
|
-
},
|
|
52855
|
-
"MergedCellsAlign": {
|
|
52856
|
-
"name": "MergedCellsAlign",
|
|
52857
|
-
"definition": "export type MergedCellsAlign = {\n /** По горизонтали. @default из `contentFormat.alignContent` колонки, иначе 'left' */\n horizontal?: 'left' | 'center' | 'right';\n /** По вертикали. @default 'center' */\n vertical?: 'top' | 'center' | 'bottom';\n};",
|
|
52858
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52859
|
-
"importStatement": "import { MergedCellsAlign } from '@daisforge/ui/components/TableCanvas';",
|
|
52860
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/merged-cells.type.ts"
|
|
52861
|
-
},
|
|
52862
53789
|
"CanvasEl": {
|
|
52863
53790
|
"name": "CanvasEl",
|
|
52864
53791
|
"definition": "export type CanvasEl = ReactElement;",
|
|
@@ -52866,6 +53793,13 @@
|
|
|
52866
53793
|
"importStatement": "import { CanvasEl } from '@daisforge/ui/components/TableCanvas';",
|
|
52867
53794
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
52868
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": "@daisforge/ui/components/TableCanvas",
|
|
53800
|
+
"importStatement": "import { CanvasNodeTooltipConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
53801
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/utils/portalHoverEvents.ts"
|
|
53802
|
+
},
|
|
52869
53803
|
"HeaderCellInfoGlideInstance": {
|
|
52870
53804
|
"name": "HeaderCellInfoGlideInstance",
|
|
52871
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};",
|
|
@@ -52887,6 +53821,13 @@
|
|
|
52887
53821
|
"importStatement": "import { CellInfoGlideInstance } from '@daisforge/ui/components/TableCanvas';",
|
|
52888
53822
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
52889
53823
|
},
|
|
53824
|
+
"CellContent": {
|
|
53825
|
+
"name": "CellContent",
|
|
53826
|
+
"definition": "export type CellContent = CanvasContent | GridCell;",
|
|
53827
|
+
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53828
|
+
"importStatement": "import { CellContent } from '@daisforge/ui/components/TableCanvas';",
|
|
53829
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
53830
|
+
},
|
|
52890
53831
|
"EditingCellInfoGlideInstance": {
|
|
52891
53832
|
"name": "EditingCellInfoGlideInstance",
|
|
52892
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};",
|
|
@@ -52915,12 +53856,12 @@
|
|
|
52915
53856
|
"importNotice": "Тип \"SpanCellAlign\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52916
53857
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
52917
53858
|
},
|
|
52918
|
-
"
|
|
52919
|
-
"name": "
|
|
52920
|
-
"definition": "export type
|
|
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};",
|
|
52921
53862
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
52922
|
-
"importStatement": "import {
|
|
52923
|
-
"sourceFile": "packages/ui-kit/src/components/
|
|
53863
|
+
"importStatement": "import { HeaderAlignment } from '@daisforge/ui/components/TableCanvas';",
|
|
53864
|
+
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/columns-grouping.type.ts"
|
|
52924
53865
|
},
|
|
52925
53866
|
"CtxsType": {
|
|
52926
53867
|
"name": "CtxsType",
|
|
@@ -52936,6 +53877,13 @@
|
|
|
52936
53877
|
"importNotice": "Тип \"Theme\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
52937
53878
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/theming/types.ts"
|
|
52938
53879
|
},
|
|
53880
|
+
"CellThemeOverrideResult": {
|
|
53881
|
+
"name": "CellThemeOverrideResult",
|
|
53882
|
+
"definition": "export type CellThemeOverrideResult = Partial<{\n bgCell: string;\n cellHorizontalPadding: number;\n cellVerticalPadding: number;\n}>;",
|
|
53883
|
+
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53884
|
+
"importStatement": "import { CellThemeOverrideResult } from '@daisforge/ui/components/TableCanvas';",
|
|
53885
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
53886
|
+
},
|
|
52939
53887
|
"ContextMenuDropdownProps": {
|
|
52940
53888
|
"name": "ContextMenuDropdownProps",
|
|
52941
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>;",
|
|
@@ -53008,7 +53956,7 @@
|
|
|
53008
53956
|
},
|
|
53009
53957
|
"ColumnGlideCustoms": {
|
|
53010
53958
|
"name": "ColumnGlideCustoms",
|
|
53011
|
-
"definition": "export type ColumnGlideCustoms<R extends ObjectForExtending, SR = unknown> = {\n id: string;\n /** Служебные колонки (marker / checkbox / row instruments) живут по отдельным правилам подсветки. */\n isServiceColumn?: boolean;\n /** Внутренний helper для cell-level error outline, совпадающий по семантике с Table editing error. */\n isErrorCell?: (row: R) => boolean;\n renderHeaderCell?: (cellInfo: HeaderCellInfo<R, SR>) => CanvasContent;\n /** Текстовое представление ячейки для копирования в clipboard (Ctrl+C). */\n copyData?: string | ((row: R) => string);\n editable?: boolean | ((row: R) => boolean);\n contentAlign?: 'right' | 'left' | 'center';\n renderCell?: ColumnGlideGetCellContent<R, SR>;\n renderEditCell?: (cellInfo: EditingCellInfoGlide<R, SR>) => CellContent;\n renderSummaryCell?: (summaryCellInfo: SummaryCellInfo<R, SR>) => CellContent;\n colSpan?: ColSpan<R, SR>;\n rowSpan?: RowSpan<R, SR>;\n /** Выравнивание контента в объединённых ячейках колонки; функция — если нужно задавать для каждого блока отдельно. */\n spanAlign?: SpanCellAlign | ((cellInfo: CellInfo<R, SR>) => SpanCellAlign | undefined);\n /** Тултип для ячеек этой колонки. Строка, объект или функция (context) => config | null. */\n cellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n row: R;\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n rowInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /** Тултип для шапки этой колонки. Строка, объект или функция (context) => config | null. */\n headerCellTooltip?:\n | CanvasNodeTooltipConfig\n | ((context: {\n column: ColumnGlideLast<R, SR>;\n ctxs: ObjectForExtending;\n refTable?: Ref<DataEditorRef>;\n colInd?: number;\n theme?: Theme;\n }) => CanvasNodeTooltipConfig | null);\n /**\n * Свой цвет ячеек колонки (тема ячейки).\n *\n * Цвет лучше брать из темы (`cellInfo.theme`), например статусные\n * `theme.bgCellPositive / bgCellNegative / bgCellWarning / bgCellInfo`:\n * они свои для каждой темы. Фиксированный hex в тёмной теме останется\n * таким же светлым, как в светлой.\n *\n * Подробнее. Если вернуть `bgCell` hex-цветом (`#RGB`, `#RRGGBB`,\n * `#RRGGBBAA` — прозрачный цвет сначала смешивается с фоном ячейки),\n * таблица сама посчитает его состояния (под курсором, в выбранной строке,\n * в выделении) — цвет ведёт себя как встроенные. Не-hex значение\n * (`rgba()`, `var()` и т. п.) применяется как есть, без состояний: ячейка\n * не отреагирует на курсор и выделение.\n */\n columnThemeOverride?: (\n cellInfo: CellInfo<R, SR>\n ) => CellThemeOverrideResult | undefined;\n /** Управление preview для колонки. true — включить overlay, 'none' — отключить (в т.ч. стандартный). */\n hasPreview?: boolean | 'none';\n
|
|
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};",
|
|
53012
53960
|
"internal": true,
|
|
53013
53961
|
"importNotice": "Тип \"ColumnGlideCustoms\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
53014
53962
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
@@ -53412,34 +54360,20 @@
|
|
|
53412
54360
|
"importStatement": "import { SIZE } from '@daisforge/ui/components/TableCanvas';",
|
|
53413
54361
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/constants.ts"
|
|
53414
54362
|
},
|
|
53415
|
-
"
|
|
54363
|
+
"Prettify": {
|
|
53416
54364
|
"name": "Prettify",
|
|
53417
54365
|
"definition": "export type Prettify<T> = {\n [K in keyof T]: T[K];\n // eslint-disable-next-line @typescript-eslint/ban-types\n} & {};",
|
|
53418
54366
|
"importPath": "@daisforge/ui",
|
|
53419
54367
|
"importStatement": "import { Prettify } from '@daisforge/ui';",
|
|
53420
54368
|
"sourceFile": "packages/ui-kit/src/components/Table/types/utils.type.ts"
|
|
53421
54369
|
},
|
|
53422
|
-
"
|
|
53423
|
-
"name": "Prettify",
|
|
53424
|
-
"definition": "export type Prettify<T> = {\n [K in keyof T]: T[K];\n // eslint-disable-next-line @typescript-eslint/ban-types\n} & {};",
|
|
53425
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53426
|
-
"importStatement": "import { Prettify } from '@daisforge/ui/components/TableCanvas';",
|
|
53427
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/utils.type.ts"
|
|
53428
|
-
},
|
|
53429
|
-
"Table.TableConfig": {
|
|
54370
|
+
"TableConfig": {
|
|
53430
54371
|
"name": "TableConfig",
|
|
53431
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 '@daisforge/ui';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n } & 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 * Активен ли оверлей з…",
|
|
53432
54373
|
"importPath": "@daisforge/ui",
|
|
53433
54374
|
"importStatement": "import { TableConfig } from '@daisforge/ui';",
|
|
53434
54375
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
53435
54376
|
},
|
|
53436
|
-
"TableCanvas.TableConfig": {
|
|
53437
|
-
"name": "TableConfig",
|
|
53438
|
-
"definition": "export type TableConfig<\n RowType extends ObjectForExtending,\n SummaryRowType,\n RowIdType extends string | number,\n FilterStateType extends ObjectForExtending,\n // SubRowType\n> = {\n /**\n * Группировка колонок (многоуровневая шапка через `columnConfig.children`):\n * объединение пустых ячеек шапки (`squashEmptyCells`, по умолчанию включено) и\n * дефолт выравнивания в объединённых ячейках (`squashedHeaderAlign`).\n */\n columnsGrouping?: ColumnsGroupingConfig;\n /**\n * Подсветка активной сущности в canvas-таблице.\n * @deprecated Значения `'cell'`/`'range-cell'` устарели — используйте\n * `cellsSelection.mode`. Актуальны `'row'` (подсветка строки) и `'disabled'`.\n */\n highlightActiveType?: HighlightActiveType;\n /**\n * Единый конфиг выделения ячеек: режим (`mode`), оси\n * (`enableColumnSelection`/`enableRowSelection`/`enableSelectAll`) и controlled\n * (`state`). См. {@link CellsSelectionConfig}.\n */\n cellsSelection?: CellsSelectionConfig;\n /**\n * Подсвеченная строка (`highlightActiveType='row'`).\n * `state` (опционально) — controlled-кортеж `[value, setter]`: задан — значением\n * владеешь снаружи (сброс `setter(undefined)`); не задан — таблица крутит\n * подсветку внутренним стейтом, а `onChange` всё равно срабатывает (подписка\n * без владения значением).\n */\n highlightActiveRow?: {\n state?: [\n number | undefined,\n React.Dispatch<React.SetStateAction<number | undefined>>,\n ];\n /**\n * Колбэк смены подсвеченной строки: отдаёт её флэт-индекс и сам объект\n * строки (`rows[index]`). Позволяет открывать данные подсвеченной строки\n * (например, в SplitView) без `onCellClicked`.\n */\n onChange?: (params: {\n index: number | undefined;\n row: RowType | undefined;\n }) => void;\n };\n /**\n * Эффекты при наведении (hover)\n * `row` — подсветка строки под курсором.\n * Независимая визуальная ось: селектинг (`cellsSelection`) и `highlightActiveType='row'`\n * рисуются ПОВЕРХ hover-подсветки и визуально перекрывают её (hover\n * «остаётся под ними» и снова виден после сброса выделения).\n *\n * По умолчанию row-подсветка ВКЛЮЧЕНА (цвета из темы);\n * `{ row: false }` — выключить явно.\n */\n hoverEffects?: HoverEffectsConfig;\n /**\n * Включает компенсацию тонких canvas-линий при browser zoom ниже 100%, когда devicePixelRatio меньше 1.\n * Влияет только на grid/header/sticky hairline borders.\n * @default false\n */\n enableLowDprHairline?: boolean;\n /**\n * Управление рамками (линиями) таблицы: включение и выключение.\n *\n * Уровни, от слабого к сильному: общие настройки (vertical, horizontal),\n * затем колонка (getVerticalBorder) и строка (getHorizontalBorder), затем\n * ячейка (getCellBorder).\n *\n * `vertical: false` и `horizontal: false` убирают все вертикальные или\n * горизонтальные линии тела. `getCellBorder` включает и выключает стороны\n * рамки конкретной ячейки; при его использовании линии рисуются с разбивкой\n * по ячейкам.\n */\n borders?: BordersConfig<RowType>;\n /**\n * rowSize - размеры строк таблицы\n */\n rowSize?: Prettify<RowSize>;\n /**\n * rowHeight - размер высоты строк таблицы\n */\n rowHeight?: Maybe<number | RowHeightFunc<RowType>>;\n /**\n * headerRowHeight - высота одного ряда шапки (в px). По умолчанию 33.\n *\n * Значение применяется к КАЖДОМУ уровню шапки: как к листовому (нижнему) ряду\n * колонок, так и к каждому уровню объединённых (групповых) заголовков. Поэтому\n * при N уровнях группировки итоговая высота шапки = headerRowHeight * (1 + N).\n * Например, headerRowHeight={50} при 2 уровнях групп даст шапку 50 + 50 + 50 = 150px.\n */\n headerRowHeight?: Maybe<number>;\n /**\n * sorting - активация сортировки. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={sorting: {sortingState}}\n *\n * columnConfig=[{sortingType: 'numberSort'}]\n */\n sorting?: {\n state: [\n readonly SortColumn[],\n React.Dispatch<React.SetStateAction<readonly SortColumn[]>>,\n ];\n /**\n * manualSorting - пропс, активирующий ручную-кастомную (или на стороне бэкенда) сортировку\n */\n manualSorting?: boolean;\n };\n /** @deprecated Свойство view не используется и будет удалено в следующей мажорной версии. */\n view?: View;\n /**\n * filtering - активация фильтрации. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={filtering: {stateAndSetter, ...}}\n *\n * columnConfig=[{filtering: {...}}]\n */\n filtering?: FilteringConfig<FilterStateType>;\n /**\n * Сворачивание / разворачивание таблицы\n */\n collapsing?: TableCollapseConfig;\n /**\n * selecting - активация выбора строк. Условие активации - это наличие данного свойства.\n * Есть поддержка выбора строк с многоуровневой вложенностью.\n *\n * Пример:\n *\n *```jsx\n * import { Table } from '@daisforge/ui';\n *\n * <Table\n * tableConfig={{selecting: {stateAndSetter, rowKeyGetter}}}\n * {...rest}\n * />\n * ```\n */\n selecting?: {\n state: [\n ReadonlySet<RowIdType>,\n React.Dispatch<React.SetStateAction<ReadonlySet<RowIdType>>>,\n ];\n rowKeyGetter: (row: RowType) => RowIdType;\n } & Prettify<SelectingRowConfig<RowType, RowIdType>> & {\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам controlBlock\n */\n controlBlock?: {\n domMetadata?: DomMetadata;\n };\n /**\n * Метки для автоматизированного тестирования и аналитики\n * Добавляет data-атрибуты и CSS-классы к элементам RightSidebar\n */\n sidebar?: {\n domMetadata?: DomMetadata;\n };\n };\n /**\n * editing - активация редактирования. Условие активации - это наличие данного свойства. Нужно также сконфигурировать колонки.\n *\n * Пример:\n *\n * tableConfig={editing: {onRowsChange, rowKeyGetter}}\n *\n * columnConf…",
|
|
53439
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53440
|
-
"importStatement": "import { TableConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
53441
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
53442
|
-
},
|
|
53443
54377
|
"SwitchProps": {
|
|
53444
54378
|
"name": "SwitchProps",
|
|
53445
54379
|
"definition": "export type SwitchProps = BaseSwitchProps;",
|
|
@@ -53468,12 +54402,40 @@
|
|
|
53468
54402
|
"importNotice": "Тип \"CustomCellStyleNumberFormatProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
53469
54403
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-edit/types.ts"
|
|
53470
54404
|
},
|
|
53471
|
-
"
|
|
53472
|
-
"name": "
|
|
53473
|
-
"definition": "export type
|
|
54405
|
+
"TableCanvasLoggerCounts": {
|
|
54406
|
+
"name": "TableCanvasLoggerCounts",
|
|
54407
|
+
"definition": "export type TableCanvasLoggerCounts = Partial<\n Record<TableCanvasLoggerStatus, number>\n>;",
|
|
53474
54408
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53475
|
-
"importStatement": "import {
|
|
53476
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/
|
|
54409
|
+
"importStatement": "import { TableCanvasLoggerCounts } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
54416
|
+
"importStatement": "import { TableCanvasLoggerFilterValue } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
54423
|
+
"importStatement": "import { TableCanvasLoggerListProps } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
54430
|
+
"importStatement": "import { TableCanvasLoggerRenderProps } from '@daisforge/ui/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"
|
|
53477
54439
|
},
|
|
53478
54440
|
"TableGlideProps": {
|
|
53479
54441
|
"name": "TableGlideProps",
|
|
@@ -53582,7 +54544,7 @@
|
|
|
53582
54544
|
},
|
|
53583
54545
|
"TableGlideCustomProps": {
|
|
53584
54546
|
"name": "TableGlideCustomProps",
|
|
53585
|
-
"definition": "export type TableGlideCustomProps<\n R extends ObjectForExtending,\n SR = unknown\n> = {\n columns: ColumnGlideLast<R, SR>[];\n rows: readonly R[];\n bottomSummaryRows?: readonly SR[];\n rowSize?: SIZE;\n rowHeight?:\n | ((\n row: R,\n currentRowSize: {\n rowSizeName: SIZE;\n rowSizeValue: number;\n },\n rowIndex: number\n ) => number)\n | number\n | undefined\n | null;\n ctxs?: ObjectForExtending;\n renderGroupHeader?: (\n args: RenderGroupHeaderArgs\n ) => 'default' | { defaultWithCustomGroupName: string } | CanvasEl;\n /** Выравнивание текста в объединённой шапке по ключу группы (ColumnGroupConfig.key). */\n groupAlignMap?: Map<string, SpanAlignment>;\n refTable?: Ref<DataEditorRef>;\n onColumnsReorder?: (sourceKey: string, targetKey: string) => void;\n /** Ref на контейнер таблицы — события portal hover диспатчатся на него, чтобы несколько таблиц не перехватывали чужие тултипы */\n portalEventTargetRef?: RefObject<HTMLElement | null>;\n /** Откреплённая шапка — header уезжает вместе со скроллом */\n unstickyHeader?: boolean;\n // отключает resize колонок (по умолчанию true)\n resizableColumn?: boolean;\n /** Внешний ref на wrapper-div (для TableCanvas - refTableContainer) */\n containerRef?: Ref<HTMLDivElement>;\n /** className для wrapper-div */\n containerClassName?: string;\n /** inline-style для wrapper-div */\n containerStyle?: CSSProperties;\n /** Рендер overlay-фич (tooltip, contextMenu, popover) внутри wrapper-div когда DOM готов */\n renderOverlayFeatures?: (ctx: {\n containerElement: HTMLDivElement;\n renderInContainer: (children: ReactNode) => ReactPortal | null;\n }) => ReactNode;\n /** Не рендерить canvas-grid, оставив только overlay-content внутри wrapper. */\n hideGrid?: boolean;\n /** DOM-узел content-state (empty/error), рендерится как прямой child контейнера. */\n contentStateNode?: ReactNode;\n /** Дополнительный контент wrapper-div, не зависящий от готовности canvas-grid. */\n containerSlot?: ReactNode;\n /** Флаг fullscreen - пересканирование DOM при переключении */\n fullScreened?: boolean;\n /** Переносит editor overlay внутрь контейнера (вместо document.body). Для модалок с CSS transform. */\n editorOverlayPortal?: 'inside';\n groupHeaderHeight?: number[];\n /** Управляет canvas-подсветкой активной сущности поверх glide selection. */\n highlightActiveType?: HighlightActiveType;\n /** Режим выделения ячеек (нативный glide selection). По умолчанию 'range-cell'. */\n cellsSelectionMode?: CellsSelectionMode;\n /** Канал для copy/paste (selectionRef потребителя), отдельно от controlled gridSelection. */\n onSelectionEmit?: (selection: GridSelection) => void;\n /**\n * Ключи выделенных КОЛОНОК (объединение: одиночный клик/Shift/select-all +\n * Ctrl-мультивыбор), без сервисных колонок. Канал наверх для контрл-блока\n * (например «Закрепить столбцы»). Обычное выделение ячеек сюда не попадает.\n */\n onColumnSelectionChange?: (selectedColumnKeys: string[]) => void;\n /**\n * Follow-выделение: после реордера (закрепление колонок) заново выделить эти\n * ключи. Пустой массив → снять выделение. null/undefined → не трогать.\n */\n pendingColumnSelectionKeys?: string[] | null;\n /** Вызывается после применения pendingColumnSelectionKeys (сброс pending). */\n onColumnSelectionApplied?: () => void;\n /** Controlled-значение подсвеченной строки (highlightActiveType='row'). */\n highlightActiveRow?: number;\n /**\n * Controlled-сеттер подсвеченной строки. Вторым аргументом отдаёт сам объект\n * строки (`rows[index]`) — чтобы потребитель получал узел без onCellClicked.\n */\n onHighlightActiveRowChange?: (\n row: number | undefined,\n rowData?: R | undefined\n ) => void;\n /**\n * Режим подсветки строки controlled (значением владеют снаружи). Если не\n * задан — таблица крутит подсветку внутренним стейтом, но колбэк всё равно\n * вызывается (подписка без владения).\n */\n highlightActiveRowControlled?: boolean;\n /** Выделение колонок по клику на шапку (независимо от highlightActiveType). По умолчанию true. */\n enableColumnSelection?: boolean;\n /** Выделение строк по клику/драгу на колонке нумерации. По умолчанию true. */\n enableRowSelection?: boolean;\n /** Выделение всей таблицы кликом по шапке колонки нумерации. По умолчанию true. */\n enableSelectAll?: boolean;\n /** Индексы строк, выбранных через checkbox selection. */\n checkboxSelectedRowIndexes?: ReadonlySet<number>;\n /**\n * Индексы строк, у которых ЕСТЬ (виден) чекбокс.\n * @deprecated На цвет не влияет: наличие чекбокса не меняет цвет выбранной\n * строки, ступень добавляет только НАЖАТЫЙ чекбокс\n * (`checkboxSelectedRowIndexes`). Удалить в следующем мажоре.\n */\n checkboxVisibleRowIndexes?: ReadonlySet<number>;\n /**\n * Эффекты при наведении. `hoverEffects.row` — подсветка строки под курсором:\n * рисуется через bgCell (getRowThemeOverride), т.е. лежит ПОД селектингом и\n * highlightActiveType — они рисуются поверх (highlightRegions) и визуально\n * перекрывают hover. По умолчанию row-подсветка ВКЛЮЧЕНА; выключение —\n * явное `{ row: false }`.\n */\n hoverEffects?: HoverEffectsConfig;\n /** Включает компенсацию тонких canvas-линий при browser zoom ниже 100% / DPR < 1. */\n enableLowDprHairline?: boolean;\n};",
|
|
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};",
|
|
53586
54548
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
53587
54549
|
"importStatement": "import { TableGlideCustomProps } from '@daisforge/ui/components/TableCanvas';",
|
|
53588
54550
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
@@ -53666,7 +54628,7 @@
|
|
|
53666
54628
|
},
|
|
53667
54629
|
"CanvasTextOptions": {
|
|
53668
54630
|
"name": "CanvasTextOptions",
|
|
53669
|
-
"definition": "export interface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n}",
|
|
54631
|
+
"definition": "export interface CanvasTextOptions {\n font?: string;\n fontSize?: number;\n lineHeightPx?: number;\n color?: string;\n wordWrap?: boolean;\n lineHeight?: number;\n overflow?: CanvasTextOverflowMode;\n textOverflow?: CanvasTextOverflow;\n ellipsis?: string;\n maxLines?: number;\n autoTooltip?: CanvasTextAutoTooltip;\n /**\n * Не давать тексту сжиматься в ноль. Когда места не хватает, от текста\n * остаётся хотя бы первая буква с многоточием, а за границу уходят соседи.\n *\n * Подробнее: при измерении текст выставляет себе minContentWidth, равный\n * ширине первого видимого символа с многоточием. Работает только для\n * однострочного текста с overflow 'hidden' и textOverflow 'ellipsis', в\n * остальных случаях minContentWidth не заполняется. Явный style.minWidth\n * важнее. По умолчанию выключено.\n */\n minWidthByContent?: boolean;\n}",
|
|
53670
54632
|
"internal": true,
|
|
53671
54633
|
"importNotice": "Тип \"CanvasTextOptions\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
53672
54634
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/primitives/CanvasText.ts"
|
|
@@ -54028,20 +54990,13 @@
|
|
|
54028
54990
|
"importNotice": "Тип \"ColumnDefault\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54029
54991
|
"sourceFile": "packages/ui-kit/src/components/Table/types/data-grid.type.ts"
|
|
54030
54992
|
},
|
|
54031
|
-
"
|
|
54993
|
+
"DefaultOmittedKeys": {
|
|
54032
54994
|
"name": "DefaultOmittedKeys",
|
|
54033
54995
|
"definition": "export type DefaultOmittedKeys =\n | 'editable'\n | 'sortable'\n | 'sortDescendingFirst'\n | 'renderGroupCell'\n | 'renderEditCell'\n | 'frozen'\n | 'draggable';",
|
|
54034
54996
|
"internal": true,
|
|
54035
54997
|
"importNotice": "Тип \"DefaultOmittedKeys\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54036
54998
|
"sourceFile": "packages/ui-kit/src/components/Table/types/data-grid.type.ts"
|
|
54037
54999
|
},
|
|
54038
|
-
"TableCanvas.DefaultOmittedKeys": {
|
|
54039
|
-
"name": "DefaultOmittedKeys",
|
|
54040
|
-
"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>;",
|
|
54041
|
-
"internal": true,
|
|
54042
|
-
"importNotice": "Тип \"DefaultOmittedKeys\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54043
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/glide-type.ts"
|
|
54044
|
-
},
|
|
54045
55000
|
"Table.HeaderContextValueTypeInstance": {
|
|
54046
55001
|
"name": "HeaderContextValueTypeInstance",
|
|
54047
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};",
|
|
@@ -54056,48 +55011,27 @@
|
|
|
54056
55011
|
"importNotice": "Тип \"HeaderContextValueTypeInstance\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54057
55012
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/contexts.tsx"
|
|
54058
55013
|
},
|
|
54059
|
-
"
|
|
55014
|
+
"FiltersVariables": {
|
|
54060
55015
|
"name": "FiltersVariables",
|
|
54061
55016
|
"definition": "export type FiltersVariables = {\n filtersAreVisible: boolean;\n toggleFiltersAreVisible: () => void;\n};",
|
|
54062
55017
|
"internal": true,
|
|
54063
55018
|
"importNotice": "Тип \"FiltersVariables\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54064
55019
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-filtering/filtering.type.ts"
|
|
54065
55020
|
},
|
|
54066
|
-
"
|
|
54067
|
-
"name": "FiltersVariables",
|
|
54068
|
-
"definition": "export type FiltersVariables = {\n filtersAreVisible: boolean;\n toggleFiltersAreVisible: () => void;\n};",
|
|
54069
|
-
"internal": true,
|
|
54070
|
-
"importNotice": "Тип \"FiltersVariables\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54071
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-filtering/filtering.type.ts"
|
|
54072
|
-
},
|
|
54073
|
-
"Table.CustomFormat": {
|
|
55021
|
+
"CustomFormat": {
|
|
54074
55022
|
"name": "CustomFormat",
|
|
54075
55023
|
"definition": "export type CustomFormat = CommonFormat & {\n customFormat: (value: string) => React.ReactNode;\n};",
|
|
54076
55024
|
"importPath": "@daisforge/ui",
|
|
54077
55025
|
"importStatement": "import { CustomFormat } from '@daisforge/ui';",
|
|
54078
55026
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
54079
55027
|
},
|
|
54080
|
-
"
|
|
54081
|
-
"name": "CustomFormat",
|
|
54082
|
-
"definition": "export type CustomFormat = CommonFormat & {\n customFormat: (value: string) => React.ReactNode;\n};",
|
|
54083
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54084
|
-
"importStatement": "import { CustomFormat } from '@daisforge/ui/components/TableCanvas';",
|
|
54085
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
54086
|
-
},
|
|
54087
|
-
"Table.NumberFormatOptions": {
|
|
55028
|
+
"NumberFormatOptions": {
|
|
54088
55029
|
"name": "NumberFormatOptions",
|
|
54089
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};",
|
|
54090
55031
|
"importPath": "@daisforge/ui",
|
|
54091
55032
|
"importStatement": "import { NumberFormatOptions } from '@daisforge/ui';",
|
|
54092
55033
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
54093
55034
|
},
|
|
54094
|
-
"TableCanvas.NumberFormatOptions": {
|
|
54095
|
-
"name": "NumberFormatOptions",
|
|
54096
|
-
"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};",
|
|
54097
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54098
|
-
"importStatement": "import { NumberFormatOptions } from '@daisforge/ui/components/TableCanvas';",
|
|
54099
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
54100
|
-
},
|
|
54101
55035
|
"RenderSubRowEditCell": {
|
|
54102
55036
|
"name": "RenderSubRowEditCell",
|
|
54103
55037
|
"definition": "export type RenderSubRowEditCell<SubRowType extends ObjectForExtending> = (\n renderCellProps: RenderEditCellProps<SubRowType>,\n lvl: number,\n) => ReactNode;",
|
|
@@ -54105,83 +55039,34 @@
|
|
|
54105
55039
|
"importStatement": "import { RenderSubRowEditCell } from '@daisforge/ui';",
|
|
54106
55040
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
54107
55041
|
},
|
|
54108
|
-
"
|
|
55042
|
+
"RenderGroupCellProps": {
|
|
54109
55043
|
"name": "RenderGroupCellProps",
|
|
54110
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>;",
|
|
54111
55045
|
"internal": true,
|
|
54112
55046
|
"importNotice": "Тип \"RenderGroupCellProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54113
55047
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
|
|
54114
55048
|
},
|
|
54115
|
-
"
|
|
54116
|
-
"name": "
|
|
54117
|
-
"definition": "export type
|
|
54118
|
-
"internal": true,
|
|
54119
|
-
"importNotice": "Тип \"RenderGroupCellProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54120
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
|
|
54121
|
-
},
|
|
54122
|
-
"CellHoverState": {
|
|
54123
|
-
"name": "CellHoverState",
|
|
54124
|
-
"definition": "export type CellHoverState = {\n /** Равно true только для ячейки с данными, над которой сейчас находится курсор. */\n cellHover: boolean;\n /** Равно true для всех ячеек с данными в строке, над которой сейчас находится курсор. */\n rowHover: boolean;\n};",
|
|
54125
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54126
|
-
"importStatement": "import { CellHoverState } from '@daisforge/ui/components/TableCanvas';",
|
|
54127
|
-
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
54128
|
-
},
|
|
54129
|
-
"CellActiveState": {
|
|
54130
|
-
"name": "CellActiveState",
|
|
54131
|
-
"definition": "export type CellActiveState = {\n /** Равно true, если текущая ячейка с данными входит в активную область выделения таблицы. */\n cellActive: boolean;\n /** Равно true, если строка текущей ячейки с данными содержит активную ячейку или активный диапазон. */\n rowActive: boolean;\n};",
|
|
54132
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54133
|
-
"importStatement": "import { CellActiveState } from '@daisforge/ui/components/TableCanvas';",
|
|
54134
|
-
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
54135
|
-
},
|
|
54136
|
-
"PreviewCellInfo": {
|
|
54137
|
-
"name": "PreviewCellInfo",
|
|
54138
|
-
"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};",
|
|
54139
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54140
|
-
"importStatement": "import { PreviewCellInfo } from '@daisforge/ui/components/TableCanvas';",
|
|
54141
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/column-config.type.ts"
|
|
54142
|
-
},
|
|
54143
|
-
"CellEditorTextAreaProps": {
|
|
54144
|
-
"name": "CellEditorTextAreaProps",
|
|
54145
|
-
"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;",
|
|
54146
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54147
|
-
"importStatement": "import { CellEditorTextAreaProps } from '@daisforge/ui/components/TableCanvas';",
|
|
54148
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-edit/types.ts"
|
|
54149
|
-
},
|
|
54150
|
-
"CellEditorNumberFormatProps": {
|
|
54151
|
-
"name": "CellEditorNumberFormatProps",
|
|
54152
|
-
"definition": "export type CellEditorNumberFormatProps = Omit<\n NumberFormatCompProps,\n 'view' | 'size'\n> &\n CustomCellStyleNumberFormatProps;",
|
|
54153
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54154
|
-
"importStatement": "import { CellEditorNumberFormatProps } from '@daisforge/ui/components/TableCanvas';",
|
|
54155
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-edit/types.ts"
|
|
54156
|
-
},
|
|
54157
|
-
"CellEditorComboboxProps": {
|
|
54158
|
-
"name": "CellEditorComboboxProps",
|
|
54159
|
-
"definition": "export type CellEditorComboboxProps<T extends ComboboxItemOption> =\n ComboboxCompProps<T> &\n CustomCellStyleProps & {\n autoFocusType: 'autoFocus' | 'none';\n paddingInline: number;\n };",
|
|
54160
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54161
|
-
"importStatement": "import { CellEditorComboboxProps } from '@daisforge/ui/components/TableCanvas';",
|
|
54162
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-edit/types.ts"
|
|
54163
|
-
},
|
|
54164
|
-
"RenderRowCustomEditCell": {
|
|
54165
|
-
"name": "RenderRowCustomEditCell",
|
|
54166
|
-
"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};",
|
|
54167
55052
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54168
|
-
"importStatement": "import {
|
|
54169
|
-
"sourceFile": "packages/ui-kit/src/components/
|
|
54170
|
-
},
|
|
54171
|
-
"LocalColumnInstance": {
|
|
54172
|
-
"name": "LocalColumnInstance",
|
|
54173
|
-
"definition": "type LocalColumnInstance = Record<'key' | 'name' | 'width' | string, unknown>;",
|
|
54174
|
-
"internal": true,
|
|
54175
|
-
"importNotice": "Тип \"LocalColumnInstance\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54176
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
|
|
55053
|
+
"importStatement": "import { CanvasNodeTooltipProps } from '@daisforge/ui/components/TableCanvas';",
|
|
55054
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/utils/portalHoverEvents.ts"
|
|
54177
55055
|
},
|
|
54178
55056
|
"HeaderCellInfo": {
|
|
54179
55057
|
"name": "HeaderCellInfo",
|
|
54180
|
-
"definition": "export type HeaderCellInfo<R extends ObjectForExtending, SR> = {\n column: ColumnGlideLast<R, SR>;\n drawArgs: DrawHeaderArgs;\n ctxs: ObjectForExtending;\n theme: Theme;\n};",
|
|
55058
|
+
"definition": "export type HeaderCellInfo<R extends ObjectForExtending, SR> = {\n column: ColumnGlideLast<R, SR>;\n drawArgs: DrawHeaderArgs;\n /**\n * Колонка выделена в таблице. Шапка такой колонки ведёт себя как при\n * наведении: показывает кнопки и подсвечивает название.\n *\n * Подробнее: считается в TableGlide через isColumnInSelection: клик по\n * шапке, активная колонка текущего диапазона или колонка, покрытая\n * ячейками rangeStack. Поле drawArgs.isSelected от Glide для этого не\n * подходит: выделение колонок хранится отдельно, и selection.columns у\n * Glide намеренно пуст.\n */\n columnIsSelected: boolean;\n ctxs: ObjectForExtending;\n theme: Theme;\n};",
|
|
54181
55059
|
"internal": true,
|
|
54182
55060
|
"importNotice": "Тип \"HeaderCellInfo\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54183
55061
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
54184
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
|
+
},
|
|
54185
55070
|
"SummaryCellInfo": {
|
|
54186
55071
|
"name": "SummaryCellInfo",
|
|
54187
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};",
|
|
@@ -54189,13 +55074,6 @@
|
|
|
54189
55074
|
"importNotice": "Тип \"SummaryCellInfo\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54190
55075
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
54191
55076
|
},
|
|
54192
|
-
"CanvasNodeTooltipProps": {
|
|
54193
|
-
"name": "CanvasNodeTooltipProps",
|
|
54194
|
-
"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};",
|
|
54195
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54196
|
-
"importStatement": "import { CanvasNodeTooltipProps } from '@daisforge/ui/components/TableCanvas';",
|
|
54197
|
-
"sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/utils/portalHoverEvents.ts"
|
|
54198
|
-
},
|
|
54199
55077
|
"SelectingContextType": {
|
|
54200
55078
|
"name": "SelectingContextType",
|
|
54201
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};",
|
|
@@ -54364,76 +55242,41 @@
|
|
|
54364
55242
|
"importStatement": "import { HighlightActiveType } from '@daisforge/ui/components/TableCanvas';",
|
|
54365
55243
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
54366
55244
|
},
|
|
54367
|
-
"
|
|
55245
|
+
"RowSize": {
|
|
54368
55246
|
"name": "RowSize",
|
|
54369
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};",
|
|
54370
55248
|
"importPath": "@daisforge/ui",
|
|
54371
55249
|
"importStatement": "import { RowSize } from '@daisforge/ui';",
|
|
54372
55250
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
54373
55251
|
},
|
|
54374
|
-
"
|
|
54375
|
-
"name": "RowSize",
|
|
54376
|
-
"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};",
|
|
54377
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54378
|
-
"importStatement": "import { RowSize } from '@daisforge/ui/components/TableCanvas';",
|
|
54379
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54380
|
-
},
|
|
54381
|
-
"Table.Maybe": {
|
|
55252
|
+
"Maybe": {
|
|
54382
55253
|
"name": "Maybe",
|
|
54383
55254
|
"definition": "export type Maybe<T> = T | undefined | null;",
|
|
54384
55255
|
"importPath": "@daisforge/ui",
|
|
54385
55256
|
"importStatement": "import { Maybe } from '@daisforge/ui';",
|
|
54386
55257
|
"sourceFile": "packages/ui-kit/src/components/Table/types/utils.type.ts"
|
|
54387
55258
|
},
|
|
54388
|
-
"
|
|
54389
|
-
"name": "Maybe",
|
|
54390
|
-
"definition": "export type Maybe<T> = T | undefined | null;",
|
|
54391
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54392
|
-
"importStatement": "import { Maybe } from '@daisforge/ui/components/TableCanvas';",
|
|
54393
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/utils.type.ts"
|
|
54394
|
-
},
|
|
54395
|
-
"Table.RowHeightFunc": {
|
|
55259
|
+
"RowHeightFunc": {
|
|
54396
55260
|
"name": "RowHeightFunc",
|
|
54397
55261
|
"definition": "export type RowHeightFunc<RowType> = (\n row: RowType,\n currentRowSize: { rowSizeName: SIZE; rowSizeValue: number },\n) => number;",
|
|
54398
55262
|
"importPath": "@daisforge/ui",
|
|
54399
55263
|
"importStatement": "import { RowHeightFunc } from '@daisforge/ui';",
|
|
54400
55264
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
54401
55265
|
},
|
|
54402
|
-
"
|
|
54403
|
-
"name": "RowHeightFunc",
|
|
54404
|
-
"definition": "export type RowHeightFunc<RowType> = (\n row: RowType,\n currentRowSize: { rowSizeName: SIZE; rowSizeValue: number },\n rowIndex: number,\n) => number;",
|
|
54405
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54406
|
-
"importStatement": "import { RowHeightFunc } from '@daisforge/ui/components/TableCanvas';",
|
|
54407
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54408
|
-
},
|
|
54409
|
-
"Table.View": {
|
|
55266
|
+
"View": {
|
|
54410
55267
|
"name": "View",
|
|
54411
55268
|
"definition": "export type View = ViewMods['rows' | 'bothTypes' | 'cards'];",
|
|
54412
55269
|
"importPath": "@daisforge/ui",
|
|
54413
55270
|
"importStatement": "import { View } from '@daisforge/ui';",
|
|
54414
55271
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
54415
55272
|
},
|
|
54416
|
-
"
|
|
54417
|
-
"name": "View",
|
|
54418
|
-
"definition": "export type View = ViewMods['rows' | 'bothTypes' | 'cards'];",
|
|
54419
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54420
|
-
"importStatement": "import { View } from '@daisforge/ui/components/TableCanvas';",
|
|
54421
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54422
|
-
},
|
|
54423
|
-
"Table.FilteringConfig": {
|
|
55273
|
+
"FilteringConfig": {
|
|
54424
55274
|
"name": "FilteringConfig",
|
|
54425
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) => {…",
|
|
54426
55276
|
"importPath": "@daisforge/ui",
|
|
54427
55277
|
"importStatement": "import { FilteringConfig } from '@daisforge/ui';",
|
|
54428
55278
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
54429
55279
|
},
|
|
54430
|
-
"TableCanvas.FilteringConfig": {
|
|
54431
|
-
"name": "FilteringConfig",
|
|
54432
|
-
"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) => {…",
|
|
54433
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54434
|
-
"importStatement": "import { FilteringConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
54435
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54436
|
-
},
|
|
54437
55280
|
"Table.SelectingRowConfig": {
|
|
54438
55281
|
"name": "SelectingRowConfig",
|
|
54439
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};",
|
|
@@ -54448,90 +55291,48 @@
|
|
|
54448
55291
|
"importNotice": "Тип \"SelectingRowConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54449
55292
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-select-row/types.ts"
|
|
54450
55293
|
},
|
|
54451
|
-
"
|
|
55294
|
+
"EditingConfig": {
|
|
54452
55295
|
"name": "EditingConfig",
|
|
54453
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};",
|
|
54454
55297
|
"importPath": "@daisforge/ui",
|
|
54455
55298
|
"importStatement": "import { EditingConfig } from '@daisforge/ui';",
|
|
54456
55299
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
54457
55300
|
},
|
|
54458
|
-
"
|
|
54459
|
-
"name": "EditingConfig",
|
|
54460
|
-
"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};",
|
|
54461
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54462
|
-
"importStatement": "import { EditingConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
54463
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54464
|
-
},
|
|
54465
|
-
"Table.SubRows": {
|
|
55301
|
+
"SubRows": {
|
|
54466
55302
|
"name": "SubRows",
|
|
54467
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};",
|
|
54468
55304
|
"internal": true,
|
|
54469
55305
|
"importNotice": "Тип \"SubRows\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54470
55306
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-tree/types.ts"
|
|
54471
55307
|
},
|
|
54472
|
-
"
|
|
54473
|
-
"name": "SubRows",
|
|
54474
|
-
"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};",
|
|
54475
|
-
"internal": true,
|
|
54476
|
-
"importNotice": "Тип \"SubRows\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54477
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-tree/types.ts"
|
|
54478
|
-
},
|
|
54479
|
-
"Table.RowsGrouping": {
|
|
55308
|
+
"RowsGrouping": {
|
|
54480
55309
|
"name": "RowsGrouping",
|
|
54481
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};",
|
|
54482
55311
|
"internal": true,
|
|
54483
55312
|
"importNotice": "Тип \"RowsGrouping\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54484
55313
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
|
|
54485
55314
|
},
|
|
54486
|
-
"
|
|
54487
|
-
"name": "RowsGrouping",
|
|
54488
|
-
"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};",
|
|
54489
|
-
"internal": true,
|
|
54490
|
-
"importNotice": "Тип \"RowsGrouping\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54491
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-rows-grouping/types.ts"
|
|
54492
|
-
},
|
|
54493
|
-
"Table.SummaryRowsConfig": {
|
|
55315
|
+
"SummaryRowsConfig": {
|
|
54494
55316
|
"name": "SummaryRowsConfig",
|
|
54495
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};",
|
|
54496
55318
|
"importPath": "@daisforge/ui",
|
|
54497
55319
|
"importStatement": "import { SummaryRowsConfig } from '@daisforge/ui';",
|
|
54498
55320
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
54499
55321
|
},
|
|
54500
|
-
"
|
|
54501
|
-
"name": "SummaryRowsConfig",
|
|
54502
|
-
"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};",
|
|
54503
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54504
|
-
"importStatement": "import { SummaryRowsConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
54505
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54506
|
-
},
|
|
54507
|
-
"Table.ControlBlockConfig": {
|
|
55322
|
+
"ControlBlockConfig": {
|
|
54508
55323
|
"name": "ControlBlockConfig",
|
|
54509
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};",
|
|
54510
55325
|
"importPath": "@daisforge/ui",
|
|
54511
55326
|
"importStatement": "import { ControlBlockConfig } from '@daisforge/ui';",
|
|
54512
55327
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
54513
55328
|
},
|
|
54514
|
-
"
|
|
54515
|
-
"name": "ControlBlockConfig",
|
|
54516
|
-
"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};",
|
|
54517
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54518
|
-
"importStatement": "import { ControlBlockConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
54519
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54520
|
-
},
|
|
54521
|
-
"Table.ColumnsControlConfig": {
|
|
55329
|
+
"ColumnsControlConfig": {
|
|
54522
55330
|
"name": "ColumnsControlConfig",
|
|
54523
|
-
"definition": "export type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};",
|
|
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};",
|
|
54524
55332
|
"internal": true,
|
|
54525
55333
|
"importNotice": "Тип \"ColumnsControlConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54526
55334
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-column-control/types.ts"
|
|
54527
55335
|
},
|
|
54528
|
-
"TableCanvas.ColumnsControlConfig": {
|
|
54529
|
-
"name": "ColumnsControlConfig",
|
|
54530
|
-
"definition": "export type ColumnsControlConfig = {\n enable: boolean;\n /**\n * @default enable\n */\n hiding?: boolean;\n /**\n * @default enable\n */\n pinning?: boolean;\n /**\n * @default enable\n */\n reorderingAside?: boolean;\n /**\n * reorderingHeader - активация изменения порядка колонок посредством перемещения шапок колонок таблицы\n */\n /**\n * @default enable\n */\n reorderingHeader?: boolean;\n onReorderingHeader?: (params: {\n newOrder: string[];\n sourceKey: string;\n targetKey: string;\n }) => void;\n\n columnsLabel?: Record<\n string,\n ReactNode | ((isHidden: boolean, isPinned: boolean) => ReactNode)\n >;\n\n /**\n * Виртуализация списка колонок в правом сайдбаре: в DOM держатся только\n * видимые строки списка. false — отключить полностью; { minCount } —\n * включать, когда строк в списке не меньше порога.\n * @default { minCount: 30 }\n */\n virtualization?: boolean | { minCount?: number };\n\n orderDefault?: string[];\n\n pinnedDefault?: string[];\n disablePinning?: string[];\n\n hiddenDefault?: string[];\n disableHiding?: string[];\n /**\n * Индикатор скрытых столбцов: синяя полосатая линия в шапке на границе, за\n * которой скрыты столбцы. Двойной клик по линии раскрывает весь промежуток,\n * ресайз на этой границе работает как обычно.\n * @default hiding\n */\n hiddenColumnsIndicator?: boolean;\n /**\n * Уведомление о раскрытии промежутка двойным кликом по индикатору скрытых\n * столбцов. Само раскрытие (снятие скрытия) обёртка делает сама; колбэк нужен,\n * чтобы внешний потребитель мог подписаться на это событие и узнать, какие\n * столбцы раскрылись и между какими видимыми колонками стояла линия.\n */\n onHiddenColumnsIndicatorExpand?: (\n info: HiddenColumnsIndicatorExpandInfo,\n ) => void;\n\n onConfirm?: (\n params: {\n pinned: string[];\n order: string[];\n hidden: string[];\n changed: { pinned?: 'pinned'; order?: 'order'; hidden?: 'hidden' };\n },\n setters: {\n setColumnsOrder: (value: React.SetStateAction<string[]>) => void;\n setPinnedCols: (value: React.SetStateAction<string[]>) => void;\n setHiddenCols: (value: React.SetStateAction<string[]>) => void;\n },\n ) => void;\n /**\n * DomMetadata для кнопок закрепления столбцов\n */\n pinDomMetadata?: DomMetadata;\n /**\n * DomMetadata для свитчеров скрытия/показа столбцов\n */\n switchDomMetadata?: DomMetadata;\n};",
|
|
54531
|
-
"internal": true,
|
|
54532
|
-
"importNotice": "Тип \"ColumnsControlConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54533
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-column-control/types.ts"
|
|
54534
|
-
},
|
|
54535
55336
|
"RowDetailConfig": {
|
|
54536
55337
|
"name": "RowDetailConfig",
|
|
54537
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};",
|
|
@@ -54546,76 +55347,41 @@
|
|
|
54546
55347
|
"importStatement": "import { RowInstrumentsType } from '@daisforge/ui';",
|
|
54547
55348
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-row-instruments/types.ts"
|
|
54548
55349
|
},
|
|
54549
|
-
"
|
|
55350
|
+
"FullScreen": {
|
|
54550
55351
|
"name": "FullScreen",
|
|
54551
55352
|
"definition": "export type FullScreen = boolean | FullScreenObj;",
|
|
54552
55353
|
"internal": true,
|
|
54553
55354
|
"importNotice": "Тип \"FullScreen\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54554
55355
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-full-screen/types.ts"
|
|
54555
55356
|
},
|
|
54556
|
-
"
|
|
54557
|
-
"name": "FullScreen",
|
|
54558
|
-
"definition": "export type FullScreen = boolean | FullScreenObj;",
|
|
54559
|
-
"internal": true,
|
|
54560
|
-
"importNotice": "Тип \"FullScreen\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54561
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-full-screen/types.ts"
|
|
54562
|
-
},
|
|
54563
|
-
"Table.KeyTextConfig": {
|
|
55357
|
+
"KeyTextConfig": {
|
|
54564
55358
|
"name": "KeyTextConfig",
|
|
54565
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};",
|
|
54566
55360
|
"internal": true,
|
|
54567
55361
|
"importNotice": "Тип \"KeyTextConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54568
55362
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-key-text/types.ts"
|
|
54569
55363
|
},
|
|
54570
|
-
"
|
|
54571
|
-
"name": "KeyTextConfig",
|
|
54572
|
-
"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};",
|
|
54573
|
-
"internal": true,
|
|
54574
|
-
"importNotice": "Тип \"KeyTextConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54575
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-key-text/types.ts"
|
|
54576
|
-
},
|
|
54577
|
-
"Table.PaginationProps": {
|
|
55364
|
+
"PaginationProps": {
|
|
54578
55365
|
"name": "PaginationProps",
|
|
54579
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};",
|
|
54580
55367
|
"internal": true,
|
|
54581
55368
|
"importNotice": "Тип \"PaginationProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54582
55369
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-pagination/types.ts"
|
|
54583
55370
|
},
|
|
54584
|
-
"
|
|
54585
|
-
"name": "PaginationProps",
|
|
54586
|
-
"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};",
|
|
54587
|
-
"internal": true,
|
|
54588
|
-
"importNotice": "Тип \"PaginationProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54589
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-pagination/types.ts"
|
|
54590
|
-
},
|
|
54591
|
-
"Table.SidebarConfig": {
|
|
55371
|
+
"SidebarConfig": {
|
|
54592
55372
|
"name": "SidebarConfig",
|
|
54593
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};",
|
|
54594
55374
|
"internal": true,
|
|
54595
55375
|
"importNotice": "Тип \"SidebarConfig\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54596
55376
|
"sourceFile": "packages/ui-kit/src/components/Table/types/table-config.type.ts"
|
|
54597
55377
|
},
|
|
54598
|
-
"
|
|
54599
|
-
"name": "SidebarConfig",
|
|
54600
|
-
"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};",
|
|
54601
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54602
|
-
"importStatement": "import { SidebarConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
54603
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54604
|
-
},
|
|
54605
|
-
"Table.SearchingProps": {
|
|
55378
|
+
"SearchingProps": {
|
|
54606
55379
|
"name": "SearchingProps",
|
|
54607
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};",
|
|
54608
55381
|
"internal": true,
|
|
54609
55382
|
"importNotice": "Тип \"SearchingProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54610
55383
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-searching/types.ts"
|
|
54611
55384
|
},
|
|
54612
|
-
"TableCanvas.SearchingProps": {
|
|
54613
|
-
"name": "SearchingProps",
|
|
54614
|
-
"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};",
|
|
54615
|
-
"internal": true,
|
|
54616
|
-
"importNotice": "Тип \"SearchingProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54617
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-searching/types.ts"
|
|
54618
|
-
},
|
|
54619
55385
|
"HeaderContextMenuProps": {
|
|
54620
55386
|
"name": "HeaderContextMenuProps",
|
|
54621
55387
|
"definition": "export type HeaderContextMenuProps = (\n event: React.MouseEvent,\n columnLabel: string | undefined,\n closestTargetElement: HTMLElement | undefined,\n) => void;",
|
|
@@ -54658,6 +55424,34 @@
|
|
|
54658
55424
|
"importNotice": "Тип \"GlideSizes\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54659
55425
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/constants.ts"
|
|
54660
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": "@daisforge/ui/components/TableCanvas",
|
|
55431
|
+
"importStatement": "import { TableCanvasLoggerMessageRenderContext } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
55438
|
+
"importStatement": "import { TableCanvasLoggerGroupRenderContext } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
55445
|
+
"importStatement": "import { TableCanvasLoggerLabels } from '@daisforge/ui/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": "@daisforge/ui/components/TableCanvas",
|
|
55452
|
+
"importStatement": "import { TableCanvasLoggerCopyKind } from '@daisforge/ui/components/TableCanvas';",
|
|
55453
|
+
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-logger/TableCanvasLogger.types.ts"
|
|
55454
|
+
},
|
|
54661
55455
|
"CellReadOnlyEditorGlideInstanceStaticProps": {
|
|
54662
55456
|
"name": "CellReadOnlyEditorGlideInstanceStaticProps",
|
|
54663
55457
|
"definition": "export type CellReadOnlyEditorGlideInstanceStaticProps = {\n formatOptions: ContentFormat | undefined;\n disableLeftOffset: boolean | undefined;\n contentAlign: 'right' | 'left' | 'center';\n};",
|
|
@@ -54730,7 +55524,7 @@
|
|
|
54730
55524
|
},
|
|
54731
55525
|
"FlexStyle": {
|
|
54732
55526
|
"name": "FlexStyle",
|
|
54733
|
-
"definition": "export interface FlexStyle {\n id?: string;\n flexGrow: number;\n flexShrink: number;\n flexBasis: number;\n alignSelf?: Align | 'auto';\n width?: number;\n height?: number;\n crossAxisSizing?: CrossAxisSizing;\n metadata?: unknown;\n}",
|
|
55527
|
+
"definition": "export interface FlexStyle {\n id?: string;\n flexGrow: number;\n flexShrink: number;\n flexBasis: number;\n alignSelf?: Align | 'auto';\n width?: number;\n height?: number;\n /**\n * Минимальная ширина элемента в раскладке. Когда места в строке не хватает,\n * элемент сжимается только до неё. Например, текст с многоточием так\n * сохраняет хотя бы первую букву.\n *\n * Подробнее: действует только по главной оси при направлении row. Применяется\n * после распределения сжатия между детьми, остальные дети при этом заново не\n * ужимаются, поэтому сумма ширин может превысить контейнер, и лишнее выходит\n * за его границу. Если не задано, ограничения нет.\n */\n minWidth?: number;\n crossAxisSizing?: CrossAxisSizing;\n metadata?: unknown;\n}",
|
|
54734
55528
|
"internal": true,
|
|
54735
55529
|
"importNotice": "Тип \"FlexStyle\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54736
55530
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/lib/canvas/miniflex/types.ts"
|
|
@@ -54931,53 +55725,46 @@
|
|
|
54931
55725
|
"importStatement": "import { ActiveViewModsType } from '@daisforge/ui/components/TableCanvas';",
|
|
54932
55726
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
54933
55727
|
},
|
|
54934
|
-
"
|
|
55728
|
+
"CommonFormat": {
|
|
54935
55729
|
"name": "CommonFormat",
|
|
54936
55730
|
"definition": "export type CommonFormat = {\n alignContent?: 'right' | 'left' | 'center';\n};",
|
|
54937
55731
|
"importPath": "@daisforge/ui",
|
|
54938
55732
|
"importStatement": "import { CommonFormat } from '@daisforge/ui';",
|
|
54939
55733
|
"sourceFile": "packages/ui-kit/src/components/Table/types/column-config.type.ts"
|
|
54940
55734
|
},
|
|
54941
|
-
"
|
|
54942
|
-
"name": "CommonFormat",
|
|
54943
|
-
"definition": "export type CommonFormat = {\n alignContent?: 'right' | 'left' | 'center';\n};",
|
|
54944
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54945
|
-
"importStatement": "import { CommonFormat } from '@daisforge/ui/components/TableCanvas';",
|
|
54946
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
54947
|
-
},
|
|
54948
|
-
"Table.GroupRow": {
|
|
55735
|
+
"GroupRow": {
|
|
54949
55736
|
"name": "GroupRow",
|
|
54950
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};",
|
|
54951
55738
|
"importPath": "@daisforge/ui",
|
|
54952
55739
|
"importStatement": "import { GroupRow } from '@daisforge/ui';",
|
|
54953
55740
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-rows-grouping/types.ts"
|
|
54954
55741
|
},
|
|
54955
|
-
"
|
|
54956
|
-
"name": "
|
|
54957
|
-
"definition": "
|
|
54958
|
-
"
|
|
54959
|
-
"
|
|
54960
|
-
"sourceFile": "packages/ui-kit/src/components/
|
|
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"
|
|
54961
55748
|
},
|
|
54962
|
-
"
|
|
54963
|
-
"name": "
|
|
54964
|
-
"definition": "export
|
|
55749
|
+
"CellHoverState": {
|
|
55750
|
+
"name": "CellHoverState",
|
|
55751
|
+
"definition": "export type CellHoverState = {\n /** Равно true только для ячейки с данными, над которой сейчас находится курсор. */\n cellHover: boolean;\n /** Равно true для всех ячеек с данными в строке, над которой сейчас находится курсор. */\n rowHover: boolean;\n};",
|
|
54965
55752
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54966
|
-
"importStatement": "import {
|
|
54967
|
-
"sourceFile": "packages/ui-kit/src/components/
|
|
55753
|
+
"importStatement": "import { CellHoverState } from '@daisforge/ui/components/TableCanvas';",
|
|
55754
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
54968
55755
|
},
|
|
54969
|
-
"
|
|
54970
|
-
"name": "
|
|
54971
|
-
"definition": "export type
|
|
55756
|
+
"CellActiveState": {
|
|
55757
|
+
"name": "CellActiveState",
|
|
55758
|
+
"definition": "export type CellActiveState = {\n /** Равно true, если текущая ячейка с данными входит в активную область выделения таблицы. */\n cellActive: boolean;\n /** Равно true, если строка текущей ячейки с данными содержит активную ячейку или активный диапазон. */\n rowActive: boolean;\n};",
|
|
54972
55759
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
54973
|
-
"importStatement": "import {
|
|
54974
|
-
"sourceFile": "packages/ui-kit/src/components/
|
|
55760
|
+
"importStatement": "import { CellActiveState } from '@daisforge/ui/components/TableCanvas';",
|
|
55761
|
+
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
54975
55762
|
},
|
|
54976
|
-
"
|
|
54977
|
-
"name": "
|
|
54978
|
-
"definition": "type
|
|
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};",
|
|
54979
55766
|
"internal": true,
|
|
54980
|
-
"importNotice": "Тип \"
|
|
55767
|
+
"importNotice": "Тип \"RowErrorsSummary\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
54981
55768
|
"sourceFile": "packages/ui-kit/src/components/TableGlide/types.ts"
|
|
54982
55769
|
},
|
|
54983
55770
|
"RowIdTypeInstance": {
|
|
@@ -54994,6 +55781,13 @@
|
|
|
54994
55781
|
"importStatement": "import { FlattenedRowsArrAndMap } from '@daisforge/ui/components/TableCanvas';",
|
|
54995
55782
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-select-row/types.ts"
|
|
54996
55783
|
},
|
|
55784
|
+
"SortColumn": {
|
|
55785
|
+
"name": "SortColumn",
|
|
55786
|
+
"definition": "export interface SortColumn {\n readonly columnKey: string;\n readonly direction: SortDirection;\n}",
|
|
55787
|
+
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55788
|
+
"importStatement": "import { SortColumn } from '@daisforge/ui/components/TableCanvas';",
|
|
55789
|
+
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-sorting/types.ts"
|
|
55790
|
+
},
|
|
54997
55791
|
"GlideSizeConfig": {
|
|
54998
55792
|
"name": "GlideSizeConfig",
|
|
54999
55793
|
"definition": "export type GlideSizeConfig = GlideSizes[SIZE];",
|
|
@@ -55078,6 +55872,13 @@
|
|
|
55078
55872
|
"importNotice": "Тип \"FeatureItem\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55079
55873
|
"sourceFile": "packages/ui-kit/src/components/Table/widgets/control-block/types.ts"
|
|
55080
55874
|
},
|
|
55875
|
+
"ColumnsControlApplyMode": {
|
|
55876
|
+
"name": "ColumnsControlApplyMode",
|
|
55877
|
+
"definition": "export type ColumnsControlApplyMode = 'confirm' | 'instant';",
|
|
55878
|
+
"internal": true,
|
|
55879
|
+
"importNotice": "Тип \"ColumnsControlApplyMode\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55880
|
+
"sourceFile": "packages/ui-kit/src/components/Table/feature-column-control/types.ts"
|
|
55881
|
+
},
|
|
55081
55882
|
"IconsPropType": {
|
|
55082
55883
|
"name": "IconsPropType",
|
|
55083
55884
|
"definition": "export type IconsPropType = {\n closed?: ReactNode;\n opened?: ReactNode;\n iconButtonProps?: IconButtonProps;\n};",
|
|
@@ -55134,118 +55935,6 @@
|
|
|
55134
55935
|
"importNotice": "Тип \"DefaultColumnOptions\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55135
55936
|
"sourceFile": "packages/ui-kit/src/components/Table/types/data-grid.type.ts"
|
|
55136
55937
|
},
|
|
55137
|
-
"ColumnsGroupingConfig": {
|
|
55138
|
-
"name": "ColumnsGroupingConfig",
|
|
55139
|
-
"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};",
|
|
55140
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55141
|
-
"importStatement": "import { ColumnsGroupingConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55142
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/columns-grouping.type.ts"
|
|
55143
|
-
},
|
|
55144
|
-
"CellsSelectionConfig": {
|
|
55145
|
-
"name": "CellsSelectionConfig",
|
|
55146
|
-
"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};",
|
|
55147
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55148
|
-
"importStatement": "import { CellsSelectionConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55149
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55150
|
-
},
|
|
55151
|
-
"BordersConfig": {
|
|
55152
|
-
"name": "BordersConfig",
|
|
55153
|
-
"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};",
|
|
55154
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55155
|
-
"importStatement": "import { BordersConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55156
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55157
|
-
},
|
|
55158
|
-
"CellTransferConfig": {
|
|
55159
|
-
"name": "CellTransferConfig",
|
|
55160
|
-
"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};",
|
|
55161
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55162
|
-
"importStatement": "import { CellTransferConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55163
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-cell-transfer/types.ts"
|
|
55164
|
-
},
|
|
55165
|
-
"MergedCellsRegion": {
|
|
55166
|
-
"name": "MergedCellsRegion",
|
|
55167
|
-
"definition": "export type MergedCellsRegion = {\n rowKeys: Array<string | number>;\n colKeys: string[];\n /** Выравнивание контента этого блока. Важнее колоночного и общего. */\n mergedCellsAlign?: MergedCellsAlign;\n};",
|
|
55168
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55169
|
-
"importStatement": "import { MergedCellsRegion } from '@daisforge/ui/components/TableCanvas';",
|
|
55170
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55171
|
-
},
|
|
55172
|
-
"TableNotificationsConfig": {
|
|
55173
|
-
"name": "TableNotificationsConfig",
|
|
55174
|
-
"definition": "export interface TableNotificationsConfig {\n /** Вызывается на каждое событие таблицы (ошибки copy/paste и т.д.). */\n onNotification: (event: TableNotification) => void;\n}",
|
|
55175
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55176
|
-
"importStatement": "import { TableNotificationsConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55177
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-notifications/types.ts"
|
|
55178
|
-
},
|
|
55179
|
-
"RowMarkersTableConfig": {
|
|
55180
|
-
"name": "RowMarkersTableConfig",
|
|
55181
|
-
"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};",
|
|
55182
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55183
|
-
"importStatement": "import { RowMarkersTableConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55184
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55185
|
-
},
|
|
55186
|
-
"TableConfigTooltip": {
|
|
55187
|
-
"name": "TableConfigTooltip",
|
|
55188
|
-
"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};",
|
|
55189
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55190
|
-
"importStatement": "import { TableConfigTooltip } from '@daisforge/ui/components/TableCanvas';",
|
|
55191
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55192
|
-
},
|
|
55193
|
-
"InfinityScrollConfig": {
|
|
55194
|
-
"name": "InfinityScrollConfig",
|
|
55195
|
-
"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};",
|
|
55196
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55197
|
-
"importStatement": "import { InfinityScrollConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55198
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55199
|
-
},
|
|
55200
|
-
"TableCanvasEmptyStateConfig": {
|
|
55201
|
-
"name": "TableCanvasEmptyStateConfig",
|
|
55202
|
-
"definition": "export type TableCanvasEmptyStateConfig = TableCanvasContentStateBase &\n Partial<EmptyStateProps>;",
|
|
55203
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55204
|
-
"importStatement": "import { TableCanvasEmptyStateConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55205
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-content-state/types.ts"
|
|
55206
|
-
},
|
|
55207
|
-
"TableCanvasErrorStateConfig": {
|
|
55208
|
-
"name": "TableCanvasErrorStateConfig",
|
|
55209
|
-
"definition": "export type TableCanvasErrorStateConfig = TableCanvasContentStateBase &\n Partial<ErrorPageProps>;",
|
|
55210
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55211
|
-
"importStatement": "import { TableCanvasErrorStateConfig } from '@daisforge/ui/components/TableCanvas';",
|
|
55212
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/feature-content-state/types.ts"
|
|
55213
|
-
},
|
|
55214
|
-
"RightSidebarConfig": {
|
|
55215
|
-
"name": "RightSidebarConfig",
|
|
55216
|
-
"definition": "export type RightSidebarConfig = SidebarConfig;",
|
|
55217
|
-
"importPath": "@daisforge/ui",
|
|
55218
|
-
"importStatement": "import { RightSidebarConfig } from '@daisforge/ui';",
|
|
55219
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55220
|
-
},
|
|
55221
|
-
"LeftSidebarConfig": {
|
|
55222
|
-
"name": "LeftSidebarConfig",
|
|
55223
|
-
"definition": "export type LeftSidebarConfig = TableCanvasSidebarConfig;",
|
|
55224
|
-
"importPath": "@daisforge/ui",
|
|
55225
|
-
"importStatement": "import { LeftSidebarConfig } from '@daisforge/ui';",
|
|
55226
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55227
|
-
},
|
|
55228
|
-
"BottomSheetConfig": {
|
|
55229
|
-
"name": "BottomSheetConfig",
|
|
55230
|
-
"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};",
|
|
55231
|
-
"importPath": "@daisforge/ui",
|
|
55232
|
-
"importStatement": "import { BottomSheetConfig } from '@daisforge/ui';",
|
|
55233
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55234
|
-
},
|
|
55235
|
-
"TableGlideInstanceProps": {
|
|
55236
|
-
"name": "TableGlideInstanceProps",
|
|
55237
|
-
"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>;",
|
|
55238
|
-
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
55239
|
-
"importStatement": "import { TableGlideInstanceProps } from '@daisforge/ui/components/TableCanvas';",
|
|
55240
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
55241
|
-
},
|
|
55242
|
-
"GlideInstanceOmitted": {
|
|
55243
|
-
"name": "GlideInstanceOmitted",
|
|
55244
|
-
"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>;",
|
|
55245
|
-
"internal": true,
|
|
55246
|
-
"importNotice": "Тип \"GlideInstanceOmitted\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
55247
|
-
"sourceFile": "packages/ui-kit/src/components/TableCanvas/types/table-config.type.ts"
|
|
55248
|
-
},
|
|
55249
55938
|
"CellTransferCellInfo": {
|
|
55250
55939
|
"name": "CellTransferCellInfo",
|
|
55251
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};",
|