@daisforge/ui-mcp 0.2.11 → 0.2.12
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 +71 -43
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"generatedAt": "2026-11-
|
|
3
|
-
"libVersion": "1.
|
|
2
|
+
"generatedAt": "2026-11-13T10:08:32.932Z",
|
|
3
|
+
"libVersion": "1.29.0",
|
|
4
4
|
"components": {
|
|
5
5
|
"Accordion": {
|
|
6
6
|
"name": "Accordion",
|
|
@@ -921,20 +921,20 @@
|
|
|
921
921
|
"левая панель с разделами"
|
|
922
922
|
],
|
|
923
923
|
"scope": "internal",
|
|
924
|
-
"docs": "# AiAgentPopup\n\n`AiAgentPopup` — окно AI-помощника, локальная DF-обёртка над\n[Popup](https://plasma.sberdevices.ru/sdds-finai/components/popup/).\nКомпонент даёт готовый контейнер с перетаскиванием, ресайзом и сохранением\nположения; всё наполнение окна (шапка, чат, поле ввода) — на стороне\nпотребителя.\n\n## Ключевые особенности\n\n- окно можно перетаскивать за любое свободное место контейнера;\n область перетаскивания ограничена экраном с учётом `dragBoundary`\n- ресайз с адаптивным углом: иконка сама встаёт в тот угол окна,\n где есть место расти\n- позиция при открытии, по убыванию приоритета: сохранённая в localStorage\n (`useStorage`), затем `defaultPosition`, затем справа от `targetRef`\n с отступом `targetGap`, иначе отступ от левого верхнего угла экрана\n- `targetGap` числом задаёт отступ только по горизонтали (верх окна\n и верх таргета на одном уровне), а объектом `{ x, y }` — смещение\n по обеим осям от правого верхнего угла таргета: `y` больше нуля\n опускает окно, меньше нуля поднимает\n- `useStorage` сохраняет позицию и размер окна: после закрытия и даже\n перезагрузки страницы окно открывается там же и того же размера\n- поле ввода чата с овальным свечением позади даёт компонент\n `AiAgentInput`: свечение включается его пропом `glow` и переключается\n в реальном времени (например, пока AI-агент обдумывает ответ)\n- слева в окне можно показать полосу иконок-разделов (проп `leftPanel`)\n- тема подхватывается автоматически, настраивать её снаружи не нужно\n- существующий `AiAgentPopover` (плавающая кнопка с поповером) остаётся\n как есть, `AiAgentPopup` — отдельный компонент под новый дизайн\n\n## Особенности\n\n- перетаскивание не начинается с интерактивных элементов (кнопки, ссылки,\n поля ввода), с зон с атрибутом `data-no-drag` и с зон под селектором\n `dragIgnoreSelector`; пометьте `data-no-drag` область сообщений чата,\n чтобы в ней работало выделение текста\n- смещения меньше 5px считаются кликом, а не перетаскиванием\n- активный угол ресайза вычисляется по положению окна: экран делится\n на шесть секторов, окно в верхней половине растёт вниз, в нижней вверх,\n в левой части вправо, в правой влево; при ресайзе за верхние и левые\n углы противоположный угол окна стоит на месте\n- окно нельзя растянуть за края экрана, пределы учитывают `dragBoundary`;\n минимальный размер по умолчанию 360x360, максимальный 800x800\n- при первом открытии окно 400x540, другой стартовый размер задаётся\n через `defaultSize`\n- конфигурация ресайза настраивается через `resizable` частично:\n не заданные поля компонент заполняет своими значениями;\n `resizable={false}` выключает ресайз\n- для полного управления позицией снаружи есть `positionState` — пара\n `[position, setPosition]`, как у `useState`; в этом режиме позиция\n в localStorage не сохраняется\n- сохранённая позиция при чтении зажимается в границы текущего экрана,\n при изменении размеров окна браузера окно возвращается в видимую область\n- проп `frame` (унаследован от атомарного `Popup`) ограничивает окно\n рамками переданного контейнера: позиция, перетаскивание и ресайз\n считаются внутри него. В продуктовом коде обычно не нужен, окно живёт\n поверх всей страницы; используется в наших стори для изоляции примеров\n друг от друга\n\n## Поле ввода AiAgentInput\n\nПоле ввода чата с овальным свечением позади — отдельный простой компонент.\nЛогики отправки, очистки и смены кнопок в нём нет, всё это на стороне\nпотребителя.\n\n- свечение включается пропом `glow` и переключается в реальном времени\n с плавным переходом; рисуется линейным градиентом и размытием\n из макета, у тёмных тем свой градиент\n- свечение — овал высотой 79px (по макету), он выступает над верхним\n краем поля на 25px, остальная часть лежит за полем; когда поле растёт\n (Shift+Enter), овал поднимается вместе с верхним краем поля, а при\n ресайзе окна у овала меняется только ширина\n- свечение лежит поверх контента чата, включая сообщения с фоном\n (решение дизайнера); кликам и выделению текста оно не мешает\n- `rightSlot` — произвольная правая часть поля: кнопка отправки, кнопка\n остановки, с тултипами и любой логикой потребителя\n- поле авторастёт до пиксельного предела `maxHeight` (по умолчанию 220),\n дальше внутренний скролл; предел в px, а не в строках, потому что\n при ресайзе окна количество помещающихся строк меняется\n- лимита на число символов у компонента нет; если он нужен (по гайду\n дизайна 324 символа), передайте `maxLength`, он уйдёт в поле как есть\n- внешних отступов у компонента нет: место в лэйауте чата задаёт\n потребитель; стили переопределяются через `className` и `style`\n\n## Левая панель\n\nПроп `leftPanel` добавляет внутри окна слева узкую полосу иконок-разделов.\nКлик по иконке раскрывает раздел фиксированной ширины: он показывается\nвместо полосы (полоса и раздел сменяют друг друга плавно), а вернуться\nк другим иконкам можно только крестиком в шапке раздела.\n\n- разделы задаются массивом `items`: у каждого `key`, `icon` (в полосе),\n `title` и `content` (в раскрытом разделе); иконку шапки раздела можно\n задать отдельно через `titleIcon`\n- шапку раздела (иконка, заголовок, крестик) и её высоту компонент рисует\n сам; отступы, скролл и наполнение раздела под шапкой — на потребителе\n- открытый раздел задаётся `activeKey` (управляемо) или `defaultActiveKey`\n (начальное значение); смена приходит в `onActiveKeyChange` — ключ\n раздела при клике по иконке, `null` при закрытии крестиком\n- пока раздел открыт, минимальная ширина окна при ресайзе больше, чтобы\n чат не схлопнулся; максимальный размер окна 800x800\n- окно пока не расширяется автоматически при открытии раздела (для этого\n нужен управляемый размер окна от атомарного `Popup`, его ещё нет),\n поэтому задавайте `defaultSize` с запасом под ширину раздела\n\n## Внутреннее состояние контента\n\n- перетаскивание, ресайз, смена активного угла и смена темы контент\n не перемонтируют, внутреннее состояние живёт\n- закрытие окна (`opened={false}`) полностью убирает содержимое из DOM,\n это поведение атомарного `Popup`; локальный стейт контента при этом\n теряется\n- поэтому состояние чата (переписку, черновик ввода) держите снаружи\n окна: в сторе или поднятым стейтом, который живёт независимо от\n `opened`\n\nОписание типов — в разделе\n[API](?path=/docs/локальные-компоненты-aiagentpopup-api--docs).",
|
|
925
|
-
"apiDocs": "# AiAgentPopup API\n\n## AiAgentPopupProps\n\n```typescript\ntype AiAgentPopupProps = Omit<\n PopupProps,\n 'children' | 'isOpen' | 'placement' | 'offset' | 'draggable' | 'resizable'\n> & {\n /**\n * Контейнер, в котором живёт окно. По умолчанию document: окно поверх\n * всей страницы, это целевой сценарий использования. Если передать\n * элемент, окно рендерится, перетаскивается и ресайзится в его рамках;\n * в продуктовом коде это обычно не нужно, вариант используется в стори\n * для изоляции примеров друг от друга.\n */\n frame?: AiAgentPopupFrame;\n /**\n * Содержимое окна. Компонент задаёт только контейнер (обводка, тень,\n * скругление, внутренние отступы), всё наполнение на стороне потребителя.\n */\n children?: ReactNode;\n /**\n * Левая панель с иконками-разделами внутри окна. Открытие раздела\n * расширяет окно (в пределах максимума), закрытие возвращает прежнюю\n * ширину. Если не задана, окно только с контентом.\n */\n leftPanel?: AiAgentLeftPanelProps;\n /**\n * Ref на элемент, рядом с которым откроется окно (справа от него).\n * Используется, только если позиция ещё не известна: не передан\n * defaultPosition и нет сохранённой позиции из useStorage.\n */\n targetRef?: RefObject<HTMLElement | null>;\n /**\n * Отступ окна от targetRef в px. Число: только по горизонтали.\n * Объект { x, y }: смещение по обеим осям от правого верхнего угла\n * таргета, y больше нуля опускает окно вниз, меньше нуля поднимает.\n * @default 12\n */\n targetGap?: AiAgentPopupTargetGap;\n /**\n * Начальная позиция окна. Приоритетнее targetRef, но уступает сохранённой\n * позиции из useStorage.\n */\n defaultPosition?: AiAgentPopupPosition;\n /**\n * Внешний стейт позиции [position, setPosition] для полного управления\n * снаружи. Если передан, useStorage позицию не сохраняет.\n */\n positionState?: AiAgentPopupPositionState;\n /**\n * Callback смены позиции при перетаскивании.\n */\n onPositionChange?: (position: AiAgentPopupPosition) => void;\n /**\n * Включить / выключить перетаскивание. Окно тянется за любое место\n * контейнера, кроме интерактивных элементов и зон из dragIgnoreSelector.\n * @default true\n */\n draggable?: boolean;\n /**\n * Ограничение области перетаскивания: отступы от границ вьюпорта.\n * Учитывается и при ресайзе: окно нельзя растянуть за границы области.\n */\n dragBoundary?: AiAgentPopupDragBoundary;\n /**\n * Дополнительный CSS-селектор элементов, с которых перетаскивание не\n * начинается (например, область сообщений чата, чтобы работало выделение\n * текста). То же самое можно сделать атрибутом data-no-drag на элементе.\n */\n dragIgnoreSelector?: string;\n /**\n * Сохранять ли позицию и размер окна в localStorage.\n * - `true`: автосохранение с ключом `ai-agent-popup-state`.\n * - `string`: кастомный ключ.\n * - `false`: отключено.\n * @default false\n */\n useStorage?: boolean | string;\n /**\n * Включить / настроить resizable-режим.\n * - `true`: ресайз за правый нижний угол с дефолтной иконкой.\n * - объект: частичная конфигурация, мержится с дефолтной.\n * @default true\n */\n resizable?: boolean | Partial<AiAgentPopupResizableConfig>;\n /**\n * Начальный размер окна в px. Сохранённый размер из useStorage\n * приоритетнее.\n * @default { width: 400, height: 540 }\n */\n defaultSize?: AiAgentPopupSize;\n /**\n * Callback смены размера по окончании ресайза.\n */\n onSizeChange?: (size: AiAgentPopupSize) => void;\n};\n```\n\n> `AiAgentPopup` наследует базовые пропсы `Popup` из `sdds-finai`, кроме `placement`,\n`offset`, `draggable` и `resizable`: позицией и ресайзом компонент управляет сам\nчерез собственные пропсы.\n\n## AiAgentPopupPosition\n\n```typescript\ntype AiAgentPopupPosition = { x: number; y: number };\n```\n\n> Координаты левого верхнего угла окна относительно экрана, в px.\n\n## AiAgentPopupPositionState\n\n```typescript\ntype AiAgentPopupPositionState = [\n AiAgentPopupPosition,\n Dispatch<SetStateAction<AiAgentPopupPosition>>,\n];\n```\n\n> Пара для полного внешнего управления позицией, как у `useState`. Если передана\nв `positionState`, компонент не хранит позицию сам и не сохраняет её в localStorage.\n\n## AiAgentPopupTargetGap\n\n```typescript\ntype AiAgentPopupTargetGap = number | { x?: number; y?: number };\n```\n\n> Отступ окна от `targetRef`. Число задаёт отступ только по горизонтали, объект с\nполями `x` и `y` — смещение по обеим осям от правого верхнего угла таргета: `y` больше\nнуля опускает окно, меньше нуля поднимает.\n\n## AiAgentPopupSize\n\n```typescript\ntype AiAgentPopupSize = { width: number; height: number };\n```\n\n## AiAgentPopupDragBoundary\n\n```typescript\ntype AiAgentPopupDragBoundary = {\n top?: number;\n right?: number;\n bottom?: number;\n left?: number;\n};\n```\n\n> Отступы от краёв экрана. Учитываются при перетаскивании, при ресайзе и при вычислении\nначальной позиции.\n\n## AiAgentPopupResizableConfig\n\n```typescript\ntype AiAgentPopupResizableConfig = Exclude<\n PopupProps['resizable'],\n boolean | undefined\n>;\n```\n\n> Конфигурация ресайза атомарного `Popup`. В `resizable` можно передать её частично:\nне заданные поля компонент заполняет своими значениями (активный угол по положению\nокна, DF-иконка, минимум 360x360, пределы по краям экрана).\n\n## AiAgentInputProps\n\n```typescript\ntype AiAgentInputProps = Omit<TextAreaProps, 'contentRight'> & {\n /**\n * Включить овальное свечение позади поля. Переключается в реальном\n * времени с плавным переходом: например, включать, пока AI-агент\n * обдумывает ответ, и выключать, когда пользователь печатает.\n * Овал фиксированной высоты держится у верхней границы поля,\n * при авторосте поднимается вместе с ней и лежит поверх контента\n * чата, кликам не мешая.\n * @default false\n */\n glow?: boolean;\n /**\n * Содержимое правой части поля: кнопка отправки, кнопка остановки\n * и любые другие элементы с логикой и тултипами потребителя.\n * Атомарный TextArea ждёт в этом месте один элемент; несколько кнопок\n * оборачивайте в общий контейнер.\n */\n rightSlot?: ReactElement;\n /**\n * Пиксельный предел высоты поля при авторосте (высота текстовой рамки\n * целиком, с её внутренними отступами), дальше внутренний скролл.\n * Предел в px, а не в строках: при ресайзе окна количество\n * помещающихся строк меняется.\n * @default 220\n */\n maxHeight?: number;\n};\n```\n\n> Поле ввода чата с овальным свечением позади. Наследует пропсы `TextArea`, кроме\n`contentRight`: правая часть поля задаётся через `rightSlot`.\n\n## AiAgentLeftPanelProps\n\n```typescript\ntype AiAgentLeftPanelProps = {\n /**\n *
|
|
924
|
+
"docs": "# AiAgentPopup\n\n`AiAgentPopup` — окно AI-помощника, локальная DF-обёртка над\n[Popup](https://plasma.sberdevices.ru/sdds-finai/components/popup/).\nКомпонент даёт готовый контейнер с перетаскиванием, ресайзом и сохранением\nположения; всё наполнение окна (шапка, чат, поле ввода) — на стороне\nпотребителя.\n\n## Ключевые особенности\n\n- окно можно перетаскивать за любое свободное место контейнера;\n область перетаскивания ограничена экраном с учётом `dragBoundary`\n- ресайз с адаптивным углом: иконка сама встаёт в тот угол окна,\n где есть место расти\n- позиция при открытии, по убыванию приоритета: сохранённая в localStorage\n (`useStorage`), затем `defaultPosition`, затем справа от `targetRef`\n с отступом `targetGap`, иначе отступ от левого верхнего угла экрана\n- `targetGap` числом задаёт отступ только по горизонтали (верх окна\n и верх таргета на одном уровне), а объектом `{ x, y }` — смещение\n по обеим осям от правого верхнего угла таргета: `y` больше нуля\n опускает окно, меньше нуля поднимает\n- `useStorage` сохраняет позицию и размер окна: после закрытия и даже\n перезагрузки страницы окно открывается там же и того же размера\n- поле ввода чата с овальным свечением позади даёт компонент\n `AiAgentInput`: свечение включается его пропом `glow` и переключается\n в реальном времени (например, пока AI-агент обдумывает ответ)\n- слева в окне можно показать полосу иконок-разделов (проп `leftPanel`)\n- тема подхватывается автоматически, настраивать её снаружи не нужно\n- существующий `AiAgentPopover` (плавающая кнопка с поповером) остаётся\n как есть, `AiAgentPopup` — отдельный компонент под новый дизайн\n\n## Особенности\n\n- перетаскивание не начинается с интерактивных элементов (кнопки, ссылки,\n поля ввода), с зон с атрибутом `data-no-drag` и с зон под селектором\n `dragIgnoreSelector`; пометьте `data-no-drag` область сообщений чата,\n чтобы в ней работало выделение текста\n- смещения меньше 5px считаются кликом, а не перетаскиванием\n- активный угол ресайза вычисляется по положению окна: экран делится\n на шесть секторов, окно в верхней половине растёт вниз, в нижней вверх,\n в левой части вправо, в правой влево; при ресайзе за верхние и левые\n углы противоположный угол окна стоит на месте\n- окно нельзя растянуть за края экрана, пределы учитывают `dragBoundary`;\n минимальный размер по умолчанию 360x360, максимальный 800x800\n- при первом открытии окно 400x540, другой стартовый размер задаётся\n через `defaultSize`\n- конфигурация ресайза настраивается через `resizable` частично:\n не заданные поля компонент заполняет своими значениями;\n `resizable={false}` выключает ресайз\n- для полного управления позицией снаружи есть `positionState` — пара\n `[position, setPosition]`, как у `useState`; в этом режиме позиция\n в localStorage не сохраняется\n- сохранённая позиция при чтении зажимается в границы текущего экрана,\n при изменении размеров окна браузера окно возвращается в видимую область\n- проп `frame` (унаследован от атомарного `Popup`) ограничивает окно\n рамками переданного контейнера: позиция, перетаскивание и ресайз\n считаются внутри него. В продуктовом коде обычно не нужен, окно живёт\n поверх всей страницы; используется в наших стори для изоляции примеров\n друг от друга\n\n## Поле ввода AiAgentInput\n\nПоле ввода чата с овальным свечением позади — отдельный простой компонент.\nЛогики отправки, очистки и смены кнопок в нём нет, всё это на стороне\nпотребителя.\n\n- свечение включается пропом `glow` и переключается в реальном времени\n с плавным переходом; рисуется линейным градиентом и размытием\n из макета, у тёмных тем свой градиент\n- свечение — овал высотой 79px (по макету), он выступает над верхним\n краем поля на 25px, остальная часть лежит за полем; когда поле растёт\n (Shift+Enter), овал поднимается вместе с верхним краем поля, а при\n ресайзе окна у овала меняется только ширина\n- свечение лежит поверх контента чата, включая сообщения с фоном\n (решение дизайнера); кликам и выделению текста оно не мешает\n- `rightSlot` — произвольная правая часть поля: кнопка отправки, кнопка\n остановки, с тултипами и любой логикой потребителя\n- поле авторастёт до пиксельного предела `maxHeight` (по умолчанию 220),\n дальше внутренний скролл; предел в px, а не в строках, потому что\n при ресайзе окна количество помещающихся строк меняется\n- лимита на число символов у компонента нет; если он нужен (по гайду\n дизайна 324 символа), передайте `maxLength`, он уйдёт в поле как есть\n- внешних отступов у компонента нет: место в лэйауте чата задаёт\n потребитель; стили переопределяются через `className` и `style`\n\n## Левая панель\n\nПроп `leftPanel` добавляет внутри окна слева узкую полосу иконок-разделов.\nКлик по иконке раскрывает раздел фиксированной ширины: он показывается\nвместо полосы (полоса и раздел сменяют друг друга плавно), а вернуться\nк другим иконкам можно только крестиком в шапке раздела.\n\n- разделы задаются массивом `items`: у каждого `key`, `icon` (в полосе),\n `title` и `content` (в раскрытом разделе); иконку шапки раздела можно\n задать отдельно через `titleIcon`\n- пункт без `content` это кнопка-действие: клик вызывает его `onClick`,\n раздел не открывается и `onActiveKeyChange` не вызывается (например,\n «Новый чат» или «Очистить чат»); у раздела `onClick` тоже можно задать,\n он вызывается перед открытием\n- `placement: 'bottom'` прижимает кнопку к нижнему краю полосы, порядок\n внутри нижней группы как в `items`\n- `disabled` выключает кнопку в полосе; уже открытый раздел при этом\n остаётся открытым и закрывается крестиком\n- шапку раздела (иконка, заголовок, крестик) и её высоту компонент рисует\n сам; отступы, скролл и наполнение раздела под шапкой — на потребителе\n- открытый раздел задаётся `activeKey` (управляемо) или `defaultActiveKey`\n (начальное значение); смена приходит в `onActiveKeyChange` — ключ\n раздела при клике по иконке, `null` при закрытии крестиком\n- пока раздел открыт, минимальная ширина окна при ресайзе больше, чтобы\n чат не схлопнулся; максимальный размер окна 800x800\n- окно пока не расширяется автоматически при открытии раздела (для этого\n нужен управляемый размер окна от атомарного `Popup`, его ещё нет),\n поэтому задавайте `defaultSize` с запасом под ширину раздела\n\n## Внутреннее состояние контента\n\n- перетаскивание, ресайз, смена активного угла и смена темы контент\n не перемонтируют, внутреннее состояние живёт\n- закрытие окна (`opened={false}`) полностью убирает содержимое из DOM,\n это поведение атомарного `Popup`; локальный стейт контента при этом\n теряется\n- поэтому состояние чата (переписку, черновик ввода) держите снаружи\n окна: в сторе или поднятым стейтом, который живёт независимо от\n `opened`\n\nОписание типов — в разделе\n[API](?path=/docs/локальные-компоненты-aiagentpopup-api--docs).",
|
|
925
|
+
"apiDocs": "# AiAgentPopup API\n\n## AiAgentPopupProps\n\n```typescript\ntype AiAgentPopupProps = Omit<\n PopupProps,\n 'children' | 'isOpen' | 'placement' | 'offset' | 'draggable' | 'resizable'\n> & {\n /**\n * Контейнер, в котором живёт окно. По умолчанию document: окно поверх\n * всей страницы, это целевой сценарий использования. Если передать\n * элемент, окно рендерится, перетаскивается и ресайзится в его рамках;\n * в продуктовом коде это обычно не нужно, вариант используется в стори\n * для изоляции примеров друг от друга.\n */\n frame?: AiAgentPopupFrame;\n /**\n * Содержимое окна. Компонент задаёт только контейнер (обводка, тень,\n * скругление, внутренние отступы), всё наполнение на стороне потребителя.\n */\n children?: ReactNode;\n /**\n * Левая панель с иконками-разделами внутри окна. Открытие раздела\n * расширяет окно (в пределах максимума), закрытие возвращает прежнюю\n * ширину. Если не задана, окно только с контентом.\n */\n leftPanel?: AiAgentLeftPanelProps;\n /**\n * Ref на элемент, рядом с которым откроется окно (справа от него).\n * Используется, только если позиция ещё не известна: не передан\n * defaultPosition и нет сохранённой позиции из useStorage.\n */\n targetRef?: RefObject<HTMLElement | null>;\n /**\n * Отступ окна от targetRef в px. Число: только по горизонтали.\n * Объект { x, y }: смещение по обеим осям от правого верхнего угла\n * таргета, y больше нуля опускает окно вниз, меньше нуля поднимает.\n * @default 12\n */\n targetGap?: AiAgentPopupTargetGap;\n /**\n * Начальная позиция окна. Приоритетнее targetRef, но уступает сохранённой\n * позиции из useStorage.\n */\n defaultPosition?: AiAgentPopupPosition;\n /**\n * Внешний стейт позиции [position, setPosition] для полного управления\n * снаружи. Если передан, useStorage позицию не сохраняет.\n */\n positionState?: AiAgentPopupPositionState;\n /**\n * Callback смены позиции при перетаскивании.\n */\n onPositionChange?: (position: AiAgentPopupPosition) => void;\n /**\n * Включить / выключить перетаскивание. Окно тянется за любое место\n * контейнера, кроме интерактивных элементов и зон из dragIgnoreSelector.\n * @default true\n */\n draggable?: boolean;\n /**\n * Ограничение области перетаскивания: отступы от границ вьюпорта.\n * Учитывается и при ресайзе: окно нельзя растянуть за границы области.\n */\n dragBoundary?: AiAgentPopupDragBoundary;\n /**\n * Дополнительный CSS-селектор элементов, с которых перетаскивание не\n * начинается (например, область сообщений чата, чтобы работало выделение\n * текста). То же самое можно сделать атрибутом data-no-drag на элементе.\n */\n dragIgnoreSelector?: string;\n /**\n * Сохранять ли позицию и размер окна в localStorage.\n * - `true`: автосохранение с ключом `ai-agent-popup-state`.\n * - `string`: кастомный ключ.\n * - `false`: отключено.\n * @default false\n */\n useStorage?: boolean | string;\n /**\n * Включить / настроить resizable-режим.\n * - `true`: ресайз за правый нижний угол с дефолтной иконкой.\n * - объект: частичная конфигурация, мержится с дефолтной.\n * @default true\n */\n resizable?: boolean | Partial<AiAgentPopupResizableConfig>;\n /**\n * Начальный размер окна в px. Сохранённый размер из useStorage\n * приоритетнее.\n * @default { width: 400, height: 540 }\n */\n defaultSize?: AiAgentPopupSize;\n /**\n * Callback смены размера по окончании ресайза.\n */\n onSizeChange?: (size: AiAgentPopupSize) => void;\n};\n```\n\n> `AiAgentPopup` наследует базовые пропсы `Popup` из `sdds-finai`, кроме `placement`,\n`offset`, `draggable` и `resizable`: позицией и ресайзом компонент управляет сам\nчерез собственные пропсы.\n\n## AiAgentPopupPosition\n\n```typescript\ntype AiAgentPopupPosition = { x: number; y: number };\n```\n\n> Координаты левого верхнего угла окна относительно экрана, в px.\n\n## AiAgentPopupPositionState\n\n```typescript\ntype AiAgentPopupPositionState = [\n AiAgentPopupPosition,\n Dispatch<SetStateAction<AiAgentPopupPosition>>,\n];\n```\n\n> Пара для полного внешнего управления позицией, как у `useState`. Если передана\nв `positionState`, компонент не хранит позицию сам и не сохраняет её в localStorage.\n\n## AiAgentPopupTargetGap\n\n```typescript\ntype AiAgentPopupTargetGap = number | { x?: number; y?: number };\n```\n\n> Отступ окна от `targetRef`. Число задаёт отступ только по горизонтали, объект с\nполями `x` и `y` — смещение по обеим осям от правого верхнего угла таргета: `y` больше\nнуля опускает окно, меньше нуля поднимает.\n\n## AiAgentPopupSize\n\n```typescript\ntype AiAgentPopupSize = { width: number; height: number };\n```\n\n## AiAgentPopupDragBoundary\n\n```typescript\ntype AiAgentPopupDragBoundary = {\n top?: number;\n right?: number;\n bottom?: number;\n left?: number;\n};\n```\n\n> Отступы от краёв экрана. Учитываются при перетаскивании, при ресайзе и при вычислении\nначальной позиции.\n\n## AiAgentPopupResizableConfig\n\n```typescript\ntype AiAgentPopupResizableConfig = Exclude<\n PopupProps['resizable'],\n boolean | undefined\n>;\n```\n\n> Конфигурация ресайза атомарного `Popup`. В `resizable` можно передать её частично:\nне заданные поля компонент заполняет своими значениями (активный угол по положению\nокна, DF-иконка, минимум 360x360, пределы по краям экрана).\n\n## AiAgentInputProps\n\n```typescript\ntype AiAgentInputProps = Omit<TextAreaProps, 'contentRight'> & {\n /**\n * Включить овальное свечение позади поля. Переключается в реальном\n * времени с плавным переходом: например, включать, пока AI-агент\n * обдумывает ответ, и выключать, когда пользователь печатает.\n * Овал фиксированной высоты держится у верхней границы поля,\n * при авторосте поднимается вместе с ней и лежит поверх контента\n * чата, кликам не мешая.\n * @default false\n */\n glow?: boolean;\n /**\n * Содержимое правой части поля: кнопка отправки, кнопка остановки\n * и любые другие элементы с логикой и тултипами потребителя.\n * Атомарный TextArea ждёт в этом месте один элемент; несколько кнопок\n * оборачивайте в общий контейнер.\n */\n rightSlot?: ReactElement;\n /**\n * Пиксельный предел высоты поля при авторосте (высота текстовой рамки\n * целиком, с её внутренними отступами), дальше внутренний скролл.\n * Предел в px, а не в строках: при ресайзе окна количество\n * помещающихся строк меняется.\n * @default 220\n */\n maxHeight?: number;\n};\n```\n\n> Поле ввода чата с овальным свечением позади. Наследует пропсы `TextArea`, кроме\n`contentRight`: правая часть поля задаётся через `rightSlot`.\n\n## AiAgentLeftPanelProps\n\n```typescript\ntype AiAgentLeftPanelProps = {\n /**\n * Пункты панели: разделы с контентом и кнопки-действия с onClick.\n */\n items: AiAgentLeftPanelItem[];\n /**\n * Ключ открытого раздела. null или undefined — открыта полоса иконок,\n * раздел закрыт. Управляемый режим: значение задаёт потребитель.\n */\n activeKey?: string | null;\n /**\n * Начальный открытый раздел в неуправляемом режиме (когда activeKey\n * не передан).\n */\n defaultActiveKey?: string | null;\n /**\n * Смена открытого раздела: ключ раздела при клике по иконке, null\n * при закрытии крестиком. Клик по пункту-действию сюда не приходит.\n */\n onActiveKeyChange?: (key: string | null) => void;\n};\n```\n\n> Левая панель окна: полоса иконок-разделов. Открытый раздел задаётся `activeKey`\n(управляемо) или `defaultActiveKey`; смена приходит в `onActiveKeyChange` (ключ раздела\nили `null` при закрытии).\n\n## AiAgentLeftPanelItem\n\n```typescript\ntype AiAgentLeftPanelItemPlacement = 'top' | 'bottom';\n```\n\n> Пункт левой панели. Раздел: `icon` в полосе, `title` и `content` в раскрытом разделе.\nШапку с иконкой, заголовком и крестиком компонент рисует сам; наполнение раздела\nпод шапкой задаёт потребитель. Кнопка-действие: `icon` и `onClick` без `content`,\nраздел не открывается. У обоих видов есть `placement` (сверху или снизу полосы) и\n`disabled`.\n\n## AiAgentLeftPanelSectionItem\n\n```typescript\ntype AiAgentLeftPanelSectionItem = AiAgentLeftPanelItemBase & {\n /**\n * Иконка слева в шапке открытого раздела, компонент ставит её по центру\n * квадрата 40x40. Если не задана, берётся icon.\n */\n titleIcon?: ReactNode;\n /**\n * Заголовок открытого раздела (в шапке, рядом с иконкой и крестиком).\n */\n title: ReactNode;\n /**\n * Контент открытого раздела под шапкой. Отступы, скролл и наполнение\n * полностью на стороне потребителя.\n */\n content: ReactNode;\n /**\n * Клик по кнопке раздела. Вызывается перед открытием раздела.\n */\n onClick?: (event: MouseEvent<HTMLButtonElement>) => void;\n};\n```\n\n## AiAgentLeftPanelActionItem\n\n```typescript\ntype AiAgentLeftPanelActionItem = AiAgentLeftPanelItemBase & {\n /**\n * Клик по кнопке.\n */\n onClick: (event: MouseEvent<HTMLButtonElement>) => void;\n titleIcon?: never;\n title?: never;\n content?: never;\n};\n```",
|
|
926
926
|
"curatedStories": [
|
|
927
927
|
{
|
|
928
928
|
"exportName": "Simple",
|
|
929
929
|
"displayName": "Simple",
|
|
930
930
|
"type": "full-code",
|
|
931
|
-
"code": "import { useLayoutEffect, useRef, useState } from 'react';\nimport {\n AiAgentInput,\n AiAgentPopup,\n IconButton,\n PopupProvider,\n SSRProvider,\n surfaceAccentMinor,\n surfaceTransparentSecondary,\n textAccentGradient,\n textInfo,\n textPrimary,\n Typography,\n} from '@daisforge/ui';\nimport {\n IconCalendarEventOutline,\n IconCatalogOutline,\n IconClose,\n IconDoneCircleOutline,\n IconHistory,\n IconMessageAddOutline,\n IconSearchAIOutline,\n IconSendOutline,\n} from '@daisforge/ui/icons';\n\
|
|
931
|
+
"code": "import React, { useLayoutEffect, useRef, useState } from 'react';\nimport {\n AiAgentInput,\n AiAgentPopup,\n backgroundPrimary,\n IconButton,\n PopupProvider,\n SSRProvider,\n surfaceAccentMinor,\n surfaceTransparentSecondary,\n textAccentGradient,\n textInfo,\n textPrimary,\n Typography,\n} from '@daisforge/ui';\nimport type { AiAgentLeftPanelItem } from '@daisforge/ui';\nimport { br, s } from '@daisforge/ui/constants';\nimport {\n IconCalendarEventOutline,\n IconCatalogOutline,\n IconClose,\n IconDoneCircleOutline,\n IconHistory,\n IconMessageAddOutline,\n IconSearchAIOutline,\n IconSendOutline,\n IconSettingsOutline,\n IconStar,\n IconTrashOutline,\n} from '@daisforge/ui/icons';\n\ntype ChatMessage = { text: string; system?: boolean };\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'useChat',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'getLeftPanelItems',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'ChatHeader',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'ChatContent',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'Sidebar',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'useSidebarWidth',\n)}\n\nrender() {\n const sidebarRef = useRef<HTMLDivElement>(null);\n const targetRef = useRef<HTMLSpanElement>(null);\n // frame нужен только в стори: изолирует окно в рамках примера, чтобы\n // примеры на странице документации не мешали друг другу. В продуктовом\n // коде frame не передавайте, окно живёт поверх всей страницы\n const frameRef = useRef<HTMLDivElement>(null);\n const sidebarWidth = useSidebarWidth(sidebarRef);\n const [opened, setOpened] = useState(true);\n // Открытый раздел левой панели, null: видна полоса иконок\n const [activeSection, setActiveSection] = useState<string | null>(null);\n const chat = useChat();\n\n // SSRProvider и PopupProvider обычно уже подключены на уровне приложения\n return (\n <SSRProvider>\n <PopupProvider>\n <div\n ref={frameRef}\n style={{\n position: 'relative',\n display: 'flex',\n height: '100vh',\n minHeight: 640,\n overflow: 'hidden',\n backgroundColor: backgroundPrimary,\n }}\n >\n <Sidebar\n sidebarRef={sidebarRef}\n targetRef={targetRef}\n onToggle={() => setOpened(!opened)}\n />\n <AiAgentPopup\n opened={opened}\n targetRef={targetRef}\n frame={frameRef}\n // Пока окно не умеет само расширяться при открытии раздела,\n // стартуем шире размера по умолчанию\n defaultSize={{ width: 680, height: 540 }}\n dragBoundary={{ top: 8, right: 8, bottom: 8, left: sidebarWidth }}\n leftPanel={{\n items: getLeftPanelItems(chat.clear),\n activeKey: activeSection,\n onActiveKeyChange: setActiveSection,\n }}\n >\n <ChatContent\n glow\n messages={chat.messages}\n draft={chat.draft}\n onDraftChange={chat.setDraft}\n onSend={chat.send}\n onClose={() => setOpened(false)}\n />\n </AiAgentPopup>\n </div>\n </PopupProvider>\n </SSRProvider>\n );\n }"
|
|
932
932
|
},
|
|
933
933
|
{
|
|
934
934
|
"exportName": "Playground",
|
|
935
935
|
"displayName": "Playground",
|
|
936
936
|
"type": "full-code",
|
|
937
|
-
"code": "import { useLayoutEffect, useRef, useState } from 'react';\nimport {\n AiAgentInput,\n AiAgentPopup,\n IconButton,\n PopupProvider,\n SSRProvider,\n surfaceAccentMinor,\n surfaceTransparentSecondary,\n textAccentGradient,\n textInfo,\n textPrimary,\n Typography,\n} from '@daisforge/ui';\nimport {\n IconCalendarEventOutline,\n IconCatalogOutline,\n IconClose,\n IconDoneCircleOutline,\n IconHistory,\n IconMessageAddOutline,\n IconSearchAIOutline,\n IconSendOutline,\n} from '@daisforge/ui/icons';\n\
|
|
937
|
+
"code": "import React, { useLayoutEffect, useRef, useState } from 'react';\nimport {\n AiAgentInput,\n AiAgentPopup,\n backgroundPrimary,\n IconButton,\n PopupProvider,\n SSRProvider,\n surfaceAccentMinor,\n surfaceTransparentSecondary,\n textAccentGradient,\n textInfo,\n textPrimary,\n Typography,\n} from '@daisforge/ui';\nimport type { AiAgentLeftPanelItem } from '@daisforge/ui';\nimport { br, s } from '@daisforge/ui/constants';\nimport {\n IconCalendarEventOutline,\n IconCatalogOutline,\n IconClose,\n IconDoneCircleOutline,\n IconHistory,\n IconMessageAddOutline,\n IconSearchAIOutline,\n IconSendOutline,\n IconSettingsOutline,\n IconStar,\n IconTrashOutline,\n} from '@daisforge/ui/icons';\n\ntype ChatMessage = { text: string; system?: boolean };\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'useChat',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'getLeftPanelItems',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'ChatHeader',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'ChatContent',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'Sidebar',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'useSidebarWidth',\n)}\n\n({ glow, dragBoundary, ...popupArgs }) => {\n const sidebarRef = useRef<HTMLDivElement>(null);\n const targetRef = useRef<HTMLSpanElement>(null);\n // frame нужен только в стори, в продуктовом коде его не передавайте\n const frameRef = useRef<HTMLDivElement>(null);\n const sidebarWidth = useSidebarWidth(sidebarRef);\n const [opened, setOpened] = useState(true);\n const [activeSection, setActiveSection] = useState<string | null>(null);\n const chat = useChat();\n\n return (\n <SSRProvider>\n <PopupProvider>\n <div\n ref={frameRef}\n style={{\n position: 'relative',\n display: 'flex',\n height: '100vh',\n minHeight: 640,\n overflow: 'hidden',\n backgroundColor: backgroundPrimary,\n }}\n >\n <Sidebar\n sidebarRef={sidebarRef}\n targetRef={targetRef}\n onToggle={() => setOpened(!opened)}\n />\n <AiAgentPopup\n {...popupArgs}\n opened={opened}\n targetRef={targetRef}\n frame={frameRef}\n // left в dragBoundary отсчитывается от правого края сайдбара\n dragBoundary={{\n ...dragBoundary,\n left: sidebarWidth + (dragBoundary?.left ?? 0),\n }}\n leftPanel={{\n items: getLeftPanelItems(chat.clear),\n activeKey: activeSection,\n onActiveKeyChange: setActiveSection,\n }}\n >\n <ChatContent\n glow={glow}\n messages={chat.messages}\n draft={chat.draft}\n onDraftChange={chat.setDraft}\n onSend={chat.send}\n onClose={() => setOpened(false)}\n />\n </AiAgentPopup>\n </div>\n </PopupProvider>\n </SSRProvider>\n );\n }"
|
|
938
938
|
}
|
|
939
939
|
],
|
|
940
940
|
"hasCuratedMeta": true,
|
|
@@ -947,19 +947,26 @@
|
|
|
947
947
|
"exportName": "Simple",
|
|
948
948
|
"displayName": "Simple",
|
|
949
949
|
"type": "full-code",
|
|
950
|
-
"code": "import { useLayoutEffect, useRef, useState } from 'react';\nimport {\n AiAgentInput,\n AiAgentPopup,\n IconButton,\n PopupProvider,\n SSRProvider,\n surfaceAccentMinor,\n surfaceTransparentSecondary,\n textAccentGradient,\n textInfo,\n textPrimary,\n Typography,\n} from '@daisforge/ui';\nimport {\n IconCalendarEventOutline,\n IconCatalogOutline,\n IconClose,\n IconDoneCircleOutline,\n IconHistory,\n IconMessageAddOutline,\n IconSearchAIOutline,\n IconSendOutline,\n} from '@daisforge/ui/icons';\n\
|
|
950
|
+
"code": "import React, { useLayoutEffect, useRef, useState } from 'react';\nimport {\n AiAgentInput,\n AiAgentPopup,\n backgroundPrimary,\n IconButton,\n PopupProvider,\n SSRProvider,\n surfaceAccentMinor,\n surfaceTransparentSecondary,\n textAccentGradient,\n textInfo,\n textPrimary,\n Typography,\n} from '@daisforge/ui';\nimport type { AiAgentLeftPanelItem } from '@daisforge/ui';\nimport { br, s } from '@daisforge/ui/constants';\nimport {\n IconCalendarEventOutline,\n IconCatalogOutline,\n IconClose,\n IconDoneCircleOutline,\n IconHistory,\n IconMessageAddOutline,\n IconSearchAIOutline,\n IconSendOutline,\n IconSettingsOutline,\n IconStar,\n IconTrashOutline,\n} from '@daisforge/ui/icons';\n\ntype ChatMessage = { text: string; system?: boolean };\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'useChat',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'getLeftPanelItems',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'ChatHeader',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'ChatContent',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'Sidebar',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'useSidebarWidth',\n)}\n\nrender() {\n const sidebarRef = useRef<HTMLDivElement>(null);\n const targetRef = useRef<HTMLSpanElement>(null);\n // frame нужен только в стори: изолирует окно в рамках примера, чтобы\n // примеры на странице документации не мешали друг другу. В продуктовом\n // коде frame не передавайте, окно живёт поверх всей страницы\n const frameRef = useRef<HTMLDivElement>(null);\n const sidebarWidth = useSidebarWidth(sidebarRef);\n const [opened, setOpened] = useState(true);\n // Открытый раздел левой панели, null: видна полоса иконок\n const [activeSection, setActiveSection] = useState<string | null>(null);\n const chat = useChat();\n\n // SSRProvider и PopupProvider обычно уже подключены на уровне приложения\n return (\n <SSRProvider>\n <PopupProvider>\n <div\n ref={frameRef}\n style={{\n position: 'relative',\n display: 'flex',\n height: '100vh',\n minHeight: 640,\n overflow: 'hidden',\n backgroundColor: backgroundPrimary,\n }}\n >\n <Sidebar\n sidebarRef={sidebarRef}\n targetRef={targetRef}\n onToggle={() => setOpened(!opened)}\n />\n <AiAgentPopup\n opened={opened}\n targetRef={targetRef}\n frame={frameRef}\n // Пока окно не умеет само расширяться при открытии раздела,\n // стартуем шире размера по умолчанию\n defaultSize={{ width: 680, height: 540 }}\n dragBoundary={{ top: 8, right: 8, bottom: 8, left: sidebarWidth }}\n leftPanel={{\n items: getLeftPanelItems(chat.clear),\n activeKey: activeSection,\n onActiveKeyChange: setActiveSection,\n }}\n >\n <ChatContent\n glow\n messages={chat.messages}\n draft={chat.draft}\n onDraftChange={chat.setDraft}\n onSend={chat.send}\n onClose={() => setOpened(false)}\n />\n </AiAgentPopup>\n </div>\n </PopupProvider>\n </SSRProvider>\n );\n }"
|
|
951
951
|
},
|
|
952
952
|
{
|
|
953
953
|
"exportName": "Playground",
|
|
954
954
|
"displayName": "Playground",
|
|
955
955
|
"type": "full-code",
|
|
956
|
-
"code": "import { useLayoutEffect, useRef, useState } from 'react';\nimport {\n AiAgentInput,\n AiAgentPopup,\n IconButton,\n PopupProvider,\n SSRProvider,\n surfaceAccentMinor,\n surfaceTransparentSecondary,\n textAccentGradient,\n textInfo,\n textPrimary,\n Typography,\n} from '@daisforge/ui';\nimport {\n IconCalendarEventOutline,\n IconCatalogOutline,\n IconClose,\n IconDoneCircleOutline,\n IconHistory,\n IconMessageAddOutline,\n IconSearchAIOutline,\n IconSendOutline,\n} from '@daisforge/ui/icons';\n\
|
|
956
|
+
"code": "import React, { useLayoutEffect, useRef, useState } from 'react';\nimport {\n AiAgentInput,\n AiAgentPopup,\n backgroundPrimary,\n IconButton,\n PopupProvider,\n SSRProvider,\n surfaceAccentMinor,\n surfaceTransparentSecondary,\n textAccentGradient,\n textInfo,\n textPrimary,\n Typography,\n} from '@daisforge/ui';\nimport type { AiAgentLeftPanelItem } from '@daisforge/ui';\nimport { br, s } from '@daisforge/ui/constants';\nimport {\n IconCalendarEventOutline,\n IconCatalogOutline,\n IconClose,\n IconDoneCircleOutline,\n IconHistory,\n IconMessageAddOutline,\n IconSearchAIOutline,\n IconSendOutline,\n IconSettingsOutline,\n IconStar,\n IconTrashOutline,\n} from '@daisforge/ui/icons';\n\ntype ChatMessage = { text: string; system?: boolean };\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'useChat',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'getLeftPanelItems',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'ChatHeader',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'ChatContent',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'Sidebar',\n)}\n\n${getFuncAsString(\n 'packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx',\n 'useSidebarWidth',\n)}\n\n({ glow, dragBoundary, ...popupArgs }) => {\n const sidebarRef = useRef<HTMLDivElement>(null);\n const targetRef = useRef<HTMLSpanElement>(null);\n // frame нужен только в стори, в продуктовом коде его не передавайте\n const frameRef = useRef<HTMLDivElement>(null);\n const sidebarWidth = useSidebarWidth(sidebarRef);\n const [opened, setOpened] = useState(true);\n const [activeSection, setActiveSection] = useState<string | null>(null);\n const chat = useChat();\n\n return (\n <SSRProvider>\n <PopupProvider>\n <div\n ref={frameRef}\n style={{\n position: 'relative',\n display: 'flex',\n height: '100vh',\n minHeight: 640,\n overflow: 'hidden',\n backgroundColor: backgroundPrimary,\n }}\n >\n <Sidebar\n sidebarRef={sidebarRef}\n targetRef={targetRef}\n onToggle={() => setOpened(!opened)}\n />\n <AiAgentPopup\n {...popupArgs}\n opened={opened}\n targetRef={targetRef}\n frame={frameRef}\n // left в dragBoundary отсчитывается от правого края сайдбара\n dragBoundary={{\n ...dragBoundary,\n left: sidebarWidth + (dragBoundary?.left ?? 0),\n }}\n leftPanel={{\n items: getLeftPanelItems(chat.clear),\n activeKey: activeSection,\n onActiveKeyChange: setActiveSection,\n }}\n >\n <ChatContent\n glow={glow}\n messages={chat.messages}\n draft={chat.draft}\n onDraftChange={chat.setDraft}\n onSend={chat.send}\n onClose={() => setOpened(false)}\n />\n </AiAgentPopup>\n </div>\n </PopupProvider>\n </SSRProvider>\n );\n }"
|
|
957
957
|
},
|
|
958
958
|
{
|
|
959
|
-
"exportName": "
|
|
959
|
+
"exportName": "Usage1",
|
|
960
960
|
"displayName": "Использование в AiAgentPopup.stories.tsx",
|
|
961
961
|
"type": "usage",
|
|
962
|
-
"code": "<AiAgentPopup\n
|
|
962
|
+
"code": "<AiAgentPopup\n {...popupArgs}\n opened={opened}\n targetRef={targetRef}\n frame={frameRef}\n // left в dragBoundary отсчитывается от правого края сайдбара\n dragBoundary={{\n ...dragBoundary,\n left: sidebarWidth + (dragBoundary?.left ?? 0),\n }}\n leftPanel={{\n items: getLeftPanelItems(chat.clear),\n activeKey: activeSection,\n onActiveKeyChange: setActiveSection,\n }}\n >\n <ChatContent\n glow={glow}\n messages={chat.messages}\n draft={chat.draft}\n onDraftChange={chat.setDraft}\n onSend={chat.send}\n onClose={() => setOpened(false)}\n />\n </AiAgentPopup>",
|
|
963
|
+
"sourceFile": "packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx"
|
|
964
|
+
},
|
|
965
|
+
{
|
|
966
|
+
"exportName": "Usage2",
|
|
967
|
+
"displayName": "Использование в AiAgentPopup.stories.tsx",
|
|
968
|
+
"type": "usage",
|
|
969
|
+
"code": "<AiAgentPopup\n opened={opened}\n targetRef={targetRef}\n frame={frameRef}\n // Пока окно не умеет само расширяться при открытии раздела,\n // стартуем шире размера по умолчанию\n defaultSize={{ width: 680, height: 540 }}\n dragBoundary={{ top: 8, right: 8, bottom: 8, left: sidebarWidth }}\n leftPanel={{\n items: getLeftPanelItems(chat.clear),\n activeKey: activeSection,\n onActiveKeyChange: setActiveSection,\n }}\n >\n <ChatContent\n glow\n messages={chat.messages}\n draft={chat.draft}\n onDraftChange={chat.setDraft}\n onSend={chat.send}\n onClose={() => setOpened(false)}\n />\n </AiAgentPopup>",
|
|
963
970
|
"sourceFile": "packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx"
|
|
964
971
|
}
|
|
965
972
|
]
|
|
@@ -21316,7 +21323,7 @@
|
|
|
21316
21323
|
"name": "titleSlot",
|
|
21317
21324
|
"type": "PageTitleAdaptiveSlot",
|
|
21318
21325
|
"required": false,
|
|
21319
|
-
"description": "Кастомный слот правее
|
|
21326
|
+
"description": "Кастомный слот правее заголовка, обычно для Badge.\nСтоит сразу за текстом `title` и выровнен по центру его строки.\nМожно передать ReactNode или callback с размерами для адаптива."
|
|
21320
21327
|
},
|
|
21321
21328
|
{
|
|
21322
21329
|
"name": "titleTypographyProps",
|
|
@@ -21342,32 +21349,32 @@
|
|
|
21342
21349
|
"breadcrumbs",
|
|
21343
21350
|
"page header"
|
|
21344
21351
|
],
|
|
21345
|
-
"docs": "# PageTitle\n\nКомпонент заголовка страницы с опциональными breadcrumbs, кнопкой «назад», подзаголовком и блоком действий.\n\n## Ключевые особенности\n\n- Опциональные breadcrumbs с настраиваемым размером (по умолчанию `size='m'`)\n- Кнопка «назад» слева от заголовка (`showBackButton`, `onBackClick`)\n- Заголовок и подзаголовок с автоматическим тултипом при обрезке текста\n- Кастомный слот правее заголовка (`titleSlot`)
|
|
21346
|
-
"apiDocs": "# PageTitle API\n\n## PageTitleProps\n\n```typescript\ntype PageTitleProps = {\n /**\n * Заголовок страницы (текст)\n */\n title?: string;\n /**\n * Пропсы для TypographyWithAutoTooltip в который обернут title\n */\n titleTypographyProps?: Omit<\n TypographyWithAutoTooltipProps<'H2'>,\n 'children' | 'variant'\n >;\n /**\n * Подзаголовок/описание страницы (текст)\n */\n subtitle?: string;\n /**\n * Пропсы для TypographyWithAutoTooltip в который обернут subtitle\n */\n subtitleTypographyProps?: Omit<\n TypographyWithAutoTooltipProps<'BodyS'>,\n 'children' | 'variant'\n >;\n /**\n * Кастомный слот правее
|
|
21352
|
+
"docs": "# PageTitle\n\nКомпонент заголовка страницы с опциональными breadcrumbs, кнопкой «назад», подзаголовком и блоком действий.\n\n## Ключевые особенности\n\n- Опциональные breadcrumbs с настраиваемым размером (по умолчанию `size='m'`)\n- Кнопка «назад» слева от заголовка (`showBackButton`, `onBackClick`)\n- Заголовок и подзаголовок с автоматическим тултипом при обрезке текста\n- Кастомный слот правее заголовка (`titleSlot`), обычно для Badge. Стоит сразу за текстом заголовка, а не за подзаголовком, и выровнен по центру строки заголовка\n- Правый блок действий (`rightSlot`), прижатый к правому краю\n\n## Особенности\n\n- Компонент всегда использует `TypographyWithAutoTooltip` для `title` и `subtitle`\n- Если `tooltipText` не передан, текстом тултипа используется сам `title` или `subtitle`\n- Слоты `titleSlot` и `rightSlot` принимают `ReactNode` или callback с размерами для адаптива\n- По умолчанию адаптив на viewport `<= 1280px` включен; временно отключить его можно через deprecated-проп `disableMediaAdaptive`\n- Код примеров отображается через `storySourceDoc`, вкладка `Show code` синхронизирована с реализацией\n\n## Использование адаптивных слотов\n\nЕсли слот не должен менять размеры, передавайте обычный `ReactNode`:\n\n```tsx\n<PageTitle\n title=\"Заголовок страницы\"\n titleSlot={<Badge size=\"m\" view=\"default\" text=\"Черновик\" />}\n/>\n```\n\nЕсли в слоте есть кнопки, которые должны уменьшаться на 1280px, передавайте callback и используйте `buttonSize` из аргумента:\n\n```tsx\n<PageTitle\n title=\"Заголовок страницы\"\n rightSlot={({ buttonSize }) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Отмена\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Сохранить\n </Button>\n </Flow>\n )}\n/>\n```\n\nРазмер, который приходит в callback:\n\n```\nbuttonSize\n| viewport <= 1280px | viewport > 1280px |\n| xs | s |\n```\n\n> Подробнее о типах и пропсах — [PageTitle API](?path=/docs/композиции-pagetitle-api--docs)",
|
|
21353
|
+
"apiDocs": "# PageTitle API\n\n## PageTitleProps\n\n```typescript\ntype PageTitleProps = {\n /**\n * Заголовок страницы (текст)\n */\n title?: string;\n /**\n * Пропсы для TypographyWithAutoTooltip в который обернут title\n */\n titleTypographyProps?: Omit<\n TypographyWithAutoTooltipProps<'H2'>,\n 'children' | 'variant'\n >;\n /**\n * Подзаголовок/описание страницы (текст)\n */\n subtitle?: string;\n /**\n * Пропсы для TypographyWithAutoTooltip в который обернут subtitle\n */\n subtitleTypographyProps?: Omit<\n TypographyWithAutoTooltipProps<'BodyS'>,\n 'children' | 'variant'\n >;\n /**\n * Кастомный слот правее заголовка, обычно для Badge.\n * Стоит сразу за текстом `title` и выровнен по центру его строки.\n * Можно передать ReactNode или callback с размерами для адаптива.\n */\n titleSlot?: PageTitleAdaptiveSlot;\n /**\n * Контент справа (прижат к правому краю и к нижней границе).\n * Можно передать ReactNode или callback с размерами для адаптива.\n */\n rightSlot?: PageTitleAdaptiveSlot;\n /**\n * Отключает принудительный адаптив компонента на viewport <= 1280px.\n *\n * @deprecated Используйте только в крайних случаях, когда команда временно не готова адаптировать вёрстку под 1280px.\n *\n * @remarks\n * При `true` компонент использует desktop-размеры для кастомных слотов и кнопки назад даже на viewport <= 1280px.\n * Это временный escape hatch, не основной сценарий использования.\n *\n * @default false\n */\n disableMediaAdaptive?: boolean;\n /**\n * Пропсы для Breadcrumbs компонента\n * По умолчанию size='m'\n */\n breadcrumbs?: BreadcrumbsPropsComp;\n /**\n * Показывать ли кнопку со стрелкой назад слева от title\n */\n showBackButton?: boolean;\n /**\n * Callback при клике на кнопку назад\n */\n onBackClick?: () => void;\n /**\n * Кастомные стили styled-components для основного контейнера\n */\n $css?: string | CSSObject | FlattenSimpleInterpolation;\n /**\n * Дополнительный className для корневого элемента\n */\n className?: string;\n};\n\nexport type PageTitleIconButtonProps = ComponentProps<typeof IconButton> & {\n iconSize?: ComponentProps<typeof IconChevronLeft>['size'];\n};\n```\n\n## PageTitleSlotSizesProps\n\n```typescript\ntype PageTitleSlotSizesProps = {\n /**\n * Размер кнопок в кастомных слотах\n */\n buttonSize: 's' | 'xs';\n};\n```\n\n## PageTitleAdaptiveSlot\n\n```typescript\ntype PageTitleAdaptiveSlot =\n | ReactNode\n | ((props: PageTitleSlotSizesProps) => ReactNode);\n```",
|
|
21347
21354
|
"curatedStories": [
|
|
21348
21355
|
{
|
|
21349
21356
|
"exportName": "Default",
|
|
21350
21357
|
"displayName": "PageTitle",
|
|
21351
21358
|
"type": "full-code",
|
|
21352
|
-
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [\n { title: 'Главная', href: '#' },\n { title: 'Раздел', href: '#' },\n { title: 'Страница' },\n ],\n }}\n showBackButton\n onBackClick={() => alert('onBackClick')}\n title=\"Заголовок страницы\"\n subtitle=\"Описание страницы или подзаголовок\"\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21359
|
+
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Badge, Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [\n { title: 'Главная', href: '#' },\n { title: 'Раздел', href: '#' },\n { title: 'Страница' },\n ],\n }}\n showBackButton\n onBackClick={() => alert('onBackClick')}\n title=\"Заголовок страницы\"\n subtitle=\"Описание страницы или подзаголовок\"\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21353
21360
|
},
|
|
21354
21361
|
{
|
|
21355
21362
|
"exportName": "WithTitleSlot",
|
|
21356
21363
|
"displayName": "PageTitle с кастомным слотом",
|
|
21357
21364
|
"type": "full-code",
|
|
21358
|
-
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [{ title: 'Главная', href: '#' }, { title: 'Раздел' }],\n }}\n showBackButton\n onBackClick={() => alert('onBackClick')}\n title=\"
|
|
21365
|
+
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Badge, Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [{ title: 'Главная', href: '#' }, { title: 'Раздел' }],\n }}\n showBackButton\n onBackClick={() => alert('onBackClick')}\n title=\"Заголовок\"\n subtitle=\"Длинное описание страницы, шире заголовка: слот стоит сразу за заголовком\"\n titleSlot={<Badge size=\"m\" view=\"default\" text=\"Черновик\" />}\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Отмена\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Сохранить\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21359
21366
|
},
|
|
21360
21367
|
{
|
|
21361
21368
|
"exportName": "WithoutBreadcrumbs",
|
|
21362
21369
|
"displayName": "PageTitle без breadcrumbs",
|
|
21363
21370
|
"type": "full-code",
|
|
21364
|
-
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n title=\"Заголовок страницы\"\n subtitle=\"Описание страницы или подзаголовок\"\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21371
|
+
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Badge, Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n title=\"Заголовок страницы\"\n subtitle=\"Описание страницы или подзаголовок\"\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21365
21372
|
},
|
|
21366
21373
|
{
|
|
21367
21374
|
"exportName": "LongTitle",
|
|
21368
21375
|
"displayName": "PageTitle с длинным заголовком",
|
|
21369
21376
|
"type": "full-code",
|
|
21370
|
-
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [\n { title: 'Главная', href: '#' },\n { title: 'Раздел', href: '#' },\n { title: 'Страница' },\n ],\n }}\n title=\"Очень длинный заголовок страницы, который может не поместиться в одну строку и будет обрезан с помощью TypographyWithAutoTooltip\"\n subtitle=\"Описание страницы или подзаголовок\"\n titleTypographyProps={{\n tooltipText:\n 'Очень длинный заголовок страницы, который может не поместиться в одну строку и будет обрезан с помощью TypographyWithAutoTooltip',\n lines: 1,\n bold: true,\n }}\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21377
|
+
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Badge, Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [\n { title: 'Главная', href: '#' },\n { title: 'Раздел', href: '#' },\n { title: 'Страница' },\n ],\n }}\n title=\"Очень длинный заголовок страницы, который может не поместиться в одну строку и будет обрезан с помощью TypographyWithAutoTooltip\"\n subtitle=\"Описание страницы или подзаголовок\"\n titleTypographyProps={{\n tooltipText:\n 'Очень длинный заголовок страницы, который может не поместиться в одну строку и будет обрезан с помощью TypographyWithAutoTooltip',\n lines: 1,\n bold: true,\n }}\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21371
21378
|
}
|
|
21372
21379
|
],
|
|
21373
21380
|
"hasCuratedMeta": true,
|
|
@@ -21380,25 +21387,25 @@
|
|
|
21380
21387
|
"exportName": "Default",
|
|
21381
21388
|
"displayName": "PageTitle",
|
|
21382
21389
|
"type": "full-code",
|
|
21383
|
-
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [\n { title: 'Главная', href: '#' },\n { title: 'Раздел', href: '#' },\n { title: 'Страница' },\n ],\n }}\n showBackButton\n onBackClick={() => alert('onBackClick')}\n title=\"Заголовок страницы\"\n subtitle=\"Описание страницы или подзаголовок\"\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21390
|
+
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Badge, Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [\n { title: 'Главная', href: '#' },\n { title: 'Раздел', href: '#' },\n { title: 'Страница' },\n ],\n }}\n showBackButton\n onBackClick={() => alert('onBackClick')}\n title=\"Заголовок страницы\"\n subtitle=\"Описание страницы или подзаголовок\"\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21384
21391
|
},
|
|
21385
21392
|
{
|
|
21386
21393
|
"exportName": "WithTitleSlot",
|
|
21387
21394
|
"displayName": "PageTitle с кастомным слотом",
|
|
21388
21395
|
"type": "full-code",
|
|
21389
|
-
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [{ title: 'Главная', href: '#' }, { title: 'Раздел' }],\n }}\n showBackButton\n onBackClick={() => alert('onBackClick')}\n title=\"
|
|
21396
|
+
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Badge, Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [{ title: 'Главная', href: '#' }, { title: 'Раздел' }],\n }}\n showBackButton\n onBackClick={() => alert('onBackClick')}\n title=\"Заголовок\"\n subtitle=\"Длинное описание страницы, шире заголовка: слот стоит сразу за заголовком\"\n titleSlot={<Badge size=\"m\" view=\"default\" text=\"Черновик\" />}\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Отмена\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Сохранить\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21390
21397
|
},
|
|
21391
21398
|
{
|
|
21392
21399
|
"exportName": "WithoutBreadcrumbs",
|
|
21393
21400
|
"displayName": "PageTitle без breadcrumbs",
|
|
21394
21401
|
"type": "full-code",
|
|
21395
|
-
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n title=\"Заголовок страницы\"\n subtitle=\"Описание страницы или подзаголовок\"\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21402
|
+
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Badge, Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n title=\"Заголовок страницы\"\n subtitle=\"Описание страницы или подзаголовок\"\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21396
21403
|
},
|
|
21397
21404
|
{
|
|
21398
21405
|
"exportName": "LongTitle",
|
|
21399
21406
|
"displayName": "PageTitle с длинным заголовком",
|
|
21400
21407
|
"type": "full-code",
|
|
21401
|
-
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [\n { title: 'Главная', href: '#' },\n { title: 'Раздел', href: '#' },\n { title: 'Страница' },\n ],\n }}\n title=\"Очень длинный заголовок страницы, который может не поместиться в одну строку и будет обрезан с помощью TypographyWithAutoTooltip\"\n subtitle=\"Описание страницы или подзаголовок\"\n titleTypographyProps={{\n tooltipText:\n 'Очень длинный заголовок страницы, который может не поместиться в одну строку и будет обрезан с помощью TypographyWithAutoTooltip',\n lines: 1,\n bold: true,\n }}\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21408
|
+
"code": "import { PageTitle } from '@daisforge/ui';\nimport { Badge, Button, Flow, IconButton } from '@daisforge/ui';\nimport { IconPlus } from '@daisforge/ui/icons';\nimport type { PageTitleSlotSizesProps } from '@daisforge/ui';\n\n() => (\n <PageTitle\n breadcrumbs={{\n items: [\n { title: 'Главная', href: '#' },\n { title: 'Раздел', href: '#' },\n { title: 'Страница' },\n ],\n }}\n title=\"Очень длинный заголовок страницы, который может не поместиться в одну строку и будет обрезан с помощью TypographyWithAutoTooltip\"\n subtitle=\"Описание страницы или подзаголовок\"\n titleTypographyProps={{\n tooltipText:\n 'Очень длинный заголовок страницы, который может не поместиться в одну строку и будет обрезан с помощью TypographyWithAutoTooltip',\n lines: 1,\n bold: true,\n }}\n rightSlot={({ buttonSize }: PageTitleSlotSizesProps) => (\n <Flow mainAxisGap={8}>\n <Button size={buttonSize} view=\"secondary\">\n Действие 1\n </Button>\n <Button size={buttonSize} view=\"accent\">\n Действие 2\n </Button>\n </Flow>\n )}\n />\n )"
|
|
21402
21409
|
}
|
|
21403
21410
|
]
|
|
21404
21411
|
},
|
|
@@ -23594,7 +23601,7 @@
|
|
|
23594
23601
|
"exportName": "Usage2",
|
|
23595
23602
|
"displayName": "Использование в AiAgentPopup.stories.tsx",
|
|
23596
23603
|
"type": "usage",
|
|
23597
|
-
"code": "<PopupProvider>\n
|
|
23604
|
+
"code": "<PopupProvider>\n <div\n ref={frameRef}\n style={{\n position: 'relative',\n display: 'flex',\n height: '100vh',\n minHeight: 640,\n overflow: 'hidden',\n backgroundColor: backgroundPrimary,\n }}\n >\n <Sidebar\n sidebarRef={sidebarRef}\n targetRef={targetRef}\n onToggle={() => setOpened(!opened)}\n />\n <AiAgentPopup\n {...popupArgs}\n opened={opened}\n targetRef={targetRef}\n frame={frameRef}\n // left в dragBoundary отсчитывается от правого края сайдбара\n dragBoundary={{\n ...dragBoundary,\n left: sidebarWidth + (dragBoundary?.left ?? 0),\n }}\n leftPanel={{\n items: getLeftPanelItems(chat.clear),\n activeKey: activeSection,\n onActiveKeyChange: setActiveSection,\n }}\n >\n <ChatContent\n glow={glow}\n messages={chat.messages}\n draft={chat.draft}\n onDraftChange={chat.setDraft}\n onSend={chat.send}\n onClose={() => setOpened(false)}\n />\n </AiAgentPopup>\n </div>\n </PopupProvider>",
|
|
23598
23605
|
"sourceFile": "packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx"
|
|
23599
23606
|
},
|
|
23600
23607
|
{
|
|
@@ -26470,7 +26477,7 @@
|
|
|
26470
26477
|
"exportName": "Usage2",
|
|
26471
26478
|
"displayName": "Использование в AiAgentPopup.stories.tsx",
|
|
26472
26479
|
"type": "usage",
|
|
26473
|
-
"code": "<SSRProvider>\n
|
|
26480
|
+
"code": "<SSRProvider>\n <PopupProvider>\n <div\n ref={frameRef}\n style={{\n position: 'relative',\n display: 'flex',\n height: '100vh',\n minHeight: 640,\n overflow: 'hidden',\n backgroundColor: backgroundPrimary,\n }}\n >\n <Sidebar\n sidebarRef={sidebarRef}\n targetRef={targetRef}\n onToggle={() => setOpened(!opened)}\n />\n <AiAgentPopup\n {...popupArgs}\n opened={opened}\n targetRef={targetRef}\n frame={frameRef}\n // left в dragBoundary отсчитывается от правого края сайдбара\n dragBoundary={{\n ...dragBoundary,\n left: sidebarWidth + (dragBoundary?.left ?? 0),\n }}\n leftPanel={{\n items: getLeftPanelItems(chat.clear),\n activeKey: activeSection,\n onActiveKeyChange: setActiveSection,\n }}\n >\n <ChatContent\n glow={glow}\n messages={chat.messages}\n draft={chat.draft}\n onDraftChange={chat.setDraft}\n onSend={chat.send}\n onClose={() => setOpened(false)}\n />\n </AiAgentPopup>\n </div>\n </PopupProvider>\n </SSRProvider>",
|
|
26474
26481
|
"sourceFile": "packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx"
|
|
26475
26482
|
}
|
|
26476
26483
|
]
|
|
@@ -42601,7 +42608,7 @@
|
|
|
42601
42608
|
"exportName": "Usage1",
|
|
42602
42609
|
"displayName": "Использование в AiAgentPopup.stories.tsx",
|
|
42603
42610
|
"type": "usage",
|
|
42604
|
-
"code": "<Typography\n // eslint-disable-next-line react/no-array-index-key\n key={index}\n variant=\"BodyS\"\n style={message.system ? systemMessageStyle :
|
|
42611
|
+
"code": "<Typography\n // eslint-disable-next-line react/no-array-index-key\n key={index}\n variant=\"BodyS\"\n style={message.system ? systemMessageStyle : bubbleStyle}\n data-no-drag\n >\n {message.text}\n </Typography>",
|
|
42605
42612
|
"sourceFile": "packages/storybook/src/stories/AiAgentPopup/AiAgentPopup.stories.tsx"
|
|
42606
42613
|
}
|
|
42607
42614
|
]
|
|
@@ -55634,12 +55641,12 @@
|
|
|
55634
55641
|
"feature": "ColumnsControl",
|
|
55635
55642
|
"legacy": false,
|
|
55636
55643
|
"summary": "*tableConfig.columnsControl**",
|
|
55637
|
-
"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- Управление скрытыми колонками извне (`hiddenState`)\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## Управление скрытыми колонками извне (hiddenState)\n\n`hiddenDefault` читается только при первом рендере. Если набор скрытых колонок зависит от состояния страницы, например часть колонок нужна только в режиме редактирования, список хранится у продукта и передаётся парой `hiddenState: [hidden, setHidden]`, как значение и сеттер из `useState`.\n\n- Таблица показывает и прячет колонки по этому значению и не пересоздаётся: прокрутка, выделение, закрепление и порядок колонок сохраняются.\n- Свитчи в Aside, индикатор скрытых столбцов, меню закрепления и сеттеры в `onConfirm` пишут через переданный сеттер, так что продукт всегда видит актуальный список.\n- Когда `hiddenState` передан, `hiddenDefault` не читается. При `hiding: false` скрытие выключено целиком: видны все колонки, значение `hiddenState` не применяется. По умолчанию `hiding` равен `enable`, поэтому без `enable: true` скрытие тоже не работает.\n- Сеттер должен принимать и значение, и функцию от прежнего значения, как сеттер из `useState`. Если состояние лежит в сторе, нужна обёртка, которая это умеет.\n- Если скрыть колонку, по которой отсортированы строки, сортировка снимается.\n- Свои колонки удобно менять функциональным сеттером: тогда колонки, которые скрыл пользователь, остаются скрытыми.\n- Если показ зависит от режима редактирования, меняйте режим и `hiddenState` в одном обработчике, тогда таблица перерисуется один раз.\n-
|
|
55638
|
-
"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 * useState. Таблица показывает и прячет столбцы по значению, а свитчи в\n * правом сайдбаре, индикатор скрытых столбцов, меню закрепления и сеттеры\n * в onConfirm пишут через переданный сеттер. Таблица при этом не\n * пересоздаётся, прокрутка, выделение и настройки столбцов сохраняются.\n *\n * Когда hiddenState передан, hiddenDefault не читается. При hiding: false\n * скрытие выключено целиком: все столбцы видны, значение hiddenState не\n * применяется. По умолчанию hiding равен enable, поэтому без enable: true\n * скрытие тоже не работает.\n *\n * Сеттер должен принимать и значение, и функцию от прежнего значения, как\n * сеттер из useState: таблица меняет список функцией. Если состояние лежит\n * в сторе, нужна обёртка, которая это умеет.\n *\n * Если скрыть столбец, по которому отсортированы строки, сортировка\n * снимается.\n *\n * Столбец с парой key/text обозначается исходным ключом из columnConfig,\n * таблица сама скроет оба столбца пары. Сама таблица тоже пишет в значение\n * только исходный ключ, поэтому скрытие пары снимается одним ключом.\n *\n * Массив держите в useState, а не создавайте заново на каждом рендере.\n * Не копируйте hidden из onConfirm обратно в hiddenState: состояние уже\n * обновлено через сеттер. В режиме confirm изменение hiddenState при\n * открытой панели сбрасывает её неприменённые правки скрытия.\n * Свои столбцы меняйте функциональным сеттером, тогда скрытие, сделанное\n * пользователем в сайдбаре, сохранится. Если показ зависит от режима\n * редактирования, меняйте оба состояния в одном обработчике:\n *\n * @example\n * const [hidden, setHidden] = useState(['comment']);\n * const toggleEdit = () => {\n * setEditOn(!editOn);\n * setHidden((prev) =>\n * editOn\n * ? [...new Set([...prev, 'comment'])]\n * : prev.filter((key) => key !== 'comment'),\n * );\n * };\n */\n hiddenState?: [string[], React.Dispatch<React.SetStateAction<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```",
|
|
55644
|
+
"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- Управление скрытыми колонками извне (`hiddenState`)\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## Управление скрытыми колонками извне (hiddenState)\n\n`hiddenDefault` читается только при первом рендере. Если набор скрытых колонок зависит от состояния страницы, например часть колонок нужна только в режиме редактирования, список хранится у продукта и передаётся парой `hiddenState: [hidden, setHidden]`, как значение и сеттер из `useState`.\n\n- Таблица показывает и прячет колонки по этому значению и не пересоздаётся: прокрутка, выделение, закрепление и порядок колонок сохраняются.\n- Свитчи в Aside, индикатор скрытых столбцов, меню закрепления и сеттеры в `onConfirm` пишут через переданный сеттер, так что продукт всегда видит актуальный список.\n- Когда `hiddenState` передан, `hiddenDefault` не читается. При `hiding: false` скрытие выключено целиком: видны все колонки, значение `hiddenState` не применяется. По умолчанию `hiding` равен `enable`, поэтому без `enable: true` скрытие тоже не работает.\n- Сеттер должен принимать и значение, и функцию от прежнего значения, как сеттер из `useState`. Если состояние лежит в сторе, нужна обёртка, которая это умеет.\n- Если скрыть колонку, по которой отсортированы строки, сортировка снимается.\n- Свои колонки удобно менять функциональным сеттером: тогда колонки, которые скрыл пользователь, остаются скрытыми.\n- Если показ зависит от режима редактирования, меняйте режим и `hiddenState` в одном обработчике, тогда таблица перерисуется один раз.\n- Колонку с парой key/text обозначайте исходным ключом из `columnConfig`: он скрывает обе колонки пары, в том числе в режиме «Ключ», где на экране видна колонка второго ключа. Второй ключ без исходного пару не скрывает. Таблица пишет в список только исходный ключ, а `onConfirm.hidden` отдаёт оба ключа пары; такой список тоже снимается одним исходным ключом.\n- Массив держите в `useState`, а не создавайте заново на каждом рендере.\n- Не копируйте `hidden` из `onConfirm` обратно в `hiddenState`: состояние уже обновлено через сеттер, повторная запись даст лишнюю перерисовку.\n- В режиме `confirm` изменение `hiddenState` при открытой панели сбрасывает её неприменённые правки скрытия, как и закрепление из шапки.\n\nСмена скрытых колонок только отфильтровывает готовые колонки: они не собираются заново, а строки не пересортировываются, если скрытая колонка не участвует в сортировке.\n\nПример — стори «ColumnsControl: управление скрытыми столбцами извне».\n\n## onConfirm\n\nCallback вызывается при нажатии «Применить» в Aside. Получает текущее состояние (`pinned`, `order`, `hidden`, `changed`) и сеттеры для программного управления состоянием.\n\n## Режим применения (applyMode)\n\n- **`confirm`** (по умолчанию) — панель копит изменения локально, внизу кнопки «Отменить» и «Применить». В таблицу и в `onConfirm` изменения уходят только по кнопке «Применить».\n- **`instant`** — кнопок нет. Каждое действие в панели (свитч видимости, пин, перенос, «открепить все», «сбросить порядок», «включить все столбцы») сразу меняет таблицу и вызывает `onConfirm` с тем же контрактом, что и кнопка «Применить». Поле `changed` описывает разницу с предыдущим применённым состоянием. Изменения вне панели (пин в шапке, перенос заголовка, раскрытие скрытых столбцов, запись в `hiddenState`) `onConfirm` не вызывают. Если сеттер продукта отказал или записал не то, что передала панель (например, обрезал список), `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)",
|
|
55645
|
+
"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 * useState. Таблица показывает и прячет столбцы по значению, а свитчи в\n * правом сайдбаре, индикатор скрытых столбцов, меню закрепления и сеттеры\n * в onConfirm пишут через переданный сеттер. Таблица при этом не\n * пересоздаётся, прокрутка, выделение и настройки столбцов сохраняются.\n *\n * Когда hiddenState передан, hiddenDefault не читается. При hiding: false\n * скрытие выключено целиком: все столбцы видны, значение hiddenState не\n * применяется. По умолчанию hiding равен enable, поэтому без enable: true\n * скрытие тоже не работает.\n *\n * Сеттер должен принимать и значение, и функцию от прежнего значения, как\n * сеттер из useState: таблица меняет список функцией. Если состояние лежит\n * в сторе, нужна обёртка, которая это умеет.\n *\n * Если скрыть столбец, по которому отсортированы строки, сортировка\n * снимается.\n *\n * Столбец с парой key/text обозначается исходным ключом из columnConfig,\n * таблица сама скроет оба столбца пары. Сама таблица тоже пишет в значение\n * только исходный ключ, поэтому скрытие пары снимается одним ключом. Второй\n * ключ пары без исходного пару не скрывает, поэтому список из onConfirm.hidden,\n * где у пары оба ключа, тоже снимается одним исходным ключом. В режиме\n * показа только ключа на экране виден столбец второго ключа, но скрывать\n * его всё равно нужно исходным ключом.\n *\n * Массив держите в useState, а не создавайте заново на каждом рендере.\n * Не копируйте hidden из onConfirm обратно в hiddenState: состояние уже\n * обновлено через сеттер. В режиме confirm изменение hiddenState при\n * открытой панели сбрасывает её неприменённые правки скрытия.\n * Свои столбцы меняйте функциональным сеттером, тогда скрытие, сделанное\n * пользователем в сайдбаре, сохранится. Если показ зависит от режима\n * редактирования, меняйте оба состояния в одном обработчике:\n *\n * @example\n * const [hidden, setHidden] = useState(['comment']);\n * const toggleEdit = () => {\n * setEditOn(!editOn);\n * setHidden((prev) =>\n * editOn\n * ? [...new Set([...prev, 'comment'])]\n * : prev.filter((key) => key !== 'comment'),\n * );\n * };\n */\n hiddenState?: [string[], React.Dispatch<React.SetStateAction<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 * onConfirm придёт, только если сеттер записал ровно то, что передала\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```",
|
|
55639
55646
|
"api": [
|
|
55640
55647
|
{
|
|
55641
55648
|
"typeName": "ColumnsControlConfig",
|
|
55642
|
-
"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 * useState. Таблица показывает и прячет столбцы по значению, а свитчи в\n * правом сайдбаре, индикатор скрытых столбцов, меню закрепления и сеттеры\n * в onConfirm пишут через переданный сеттер. Таблица при этом не\n * пересоздаётся, прокрутка, выделение и настройки столбцов сохраняются.\n *\n * Когда hiddenState передан, hiddenDefault не читается. При hiding: false\n * скрытие выключено целиком: все столбцы видны, значение hiddenState не\n * применяется. По умолчанию hiding равен enable, поэтому без enable: true\n * скрытие тоже не работает.\n *\n * Сеттер должен принимать и значение, и функцию от прежнего значения, как\n * сеттер из useState: таблица меняет список функцией. Если состояние лежит\n * в сторе, нужна обёртка, которая это умеет.\n *\n * Если скрыть столбец, по которому отсортированы строки, сортировка\n * снимается.\n *\n * Столбец с парой key/text обозначается исходным ключом из columnConfig,\n * таблица сама скроет оба столбца пары. Сама таблица тоже пишет в значение\n * только исходный ключ, поэтому скрытие пары снимается одним ключом.\n *\n * Массив держите в useState, а не создавайте заново на каждом рендере.\n * Не копируйте hidden из onConfirm обратно в hiddenState: состояние уже\n * обновлено через сеттер. В режиме confirm изменение hiddenState при\n * открытой панели сбрасывает её неприменённые правки скрытия.\n * Свои столбцы меняйте функциональным сеттером, тогда скрытие, сделанное\n * пользователем в сайдбаре, сохранится. Если показ зависит от режима\n * редактирования, меняйте оба состояния в одном обработчике:\n *\n * @example\n * const [hidden, setHidden] = useState(['comment']);\n * const toggleEdit = () => {\n * setEditOn(!editOn);\n * setHidden((prev) =>\n * editOn\n * ? [...new Set([...prev, 'comment'])]\n * : prev.filter((key) => key !== 'comment'),\n * );\n * };\n */\n hiddenState?: [string[], React.Dispatch<React.SetStateAction<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};"
|
|
55649
|
+
"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 * useState. Таблица показывает и прячет столбцы по значению, а свитчи в\n * правом сайдбаре, индикатор скрытых столбцов, меню закрепления и сеттеры\n * в onConfirm пишут через переданный сеттер. Таблица при этом не\n * пересоздаётся, прокрутка, выделение и настройки столбцов сохраняются.\n *\n * Когда hiddenState передан, hiddenDefault не читается. При hiding: false\n * скрытие выключено целиком: все столбцы видны, значение hiddenState не\n * применяется. По умолчанию hiding равен enable, поэтому без enable: true\n * скрытие тоже не работает.\n *\n * Сеттер должен принимать и значение, и функцию от прежнего значения, как\n * сеттер из useState: таблица меняет список функцией. Если состояние лежит\n * в сторе, нужна обёртка, которая это умеет.\n *\n * Если скрыть столбец, по которому отсортированы строки, сортировка\n * снимается.\n *\n * Столбец с парой key/text обозначается исходным ключом из columnConfig,\n * таблица сама скроет оба столбца пары. Сама таблица тоже пишет в значение\n * только исходный ключ, поэтому скрытие пары снимается одним ключом. Второй\n * ключ пары без исходного пару не скрывает, поэтому список из onConfirm.hidden,\n * где у пары оба ключа, тоже снимается одним исходным ключом. В режиме\n * показа только ключа на экране виден столбец второго ключа, но скрывать\n * его всё равно нужно исходным ключом.\n *\n * Массив держите в useState, а не создавайте заново на каждом рендере.\n * Не копируйте hidden из onConfirm обратно в hiddenState: состояние уже\n * обновлено через сеттер. В режиме confirm изменение hiddenState при\n * открытой панели сбрасывает её неприменённые правки скрытия.\n * Свои столбцы меняйте функциональным сеттером, тогда скрытие, сделанное\n * пользователем в сайдбаре, сохранится. Если показ зависит от режима\n * редактирования, меняйте оба состояния в одном обработчике:\n *\n * @example\n * const [hidden, setHidden] = useState(['comment']);\n * const toggleEdit = () => {\n * setEditOn(!editOn);\n * setHidden((prev) =>\n * editOn\n * ? [...new Set([...prev, 'comment'])]\n * : prev.filter((key) => key !== 'comment'),\n * );\n * };\n */\n hiddenState?: [string[], React.Dispatch<React.SetStateAction<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 * onConfirm придёт, только если сеттер записал ровно то, что передала\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};"
|
|
55643
55650
|
},
|
|
55644
55651
|
{
|
|
55645
55652
|
"typeName": "HiddenColumnsIndicatorExpandInfo",
|
|
@@ -55780,8 +55787,8 @@
|
|
|
55780
55787
|
"feature": "ContextMenu",
|
|
55781
55788
|
"legacy": false,
|
|
55782
55789
|
"summary": "*tableConfig.onHeaderContextMenu / onCellContextMenu / onHeaderContextMenuDropdown / onCellContextMenuDropdown**",
|
|
55783
|
-
"docs": "# Context Menu\n\n**tableConfig.onHeaderContextMenu / onCellContextMenu / onHeaderContextMenuDropdown / onCellContextMenuDropdown**\n\nКонтекстное меню для заголовков колонок и ячеек.\n\nЕсли список нужен по левому клику или наведению на конкретный элемент внутри ячейки (кнопка «три точки», кнопка действий), используйте проп `dropdown` на Canvas-элементе: раздел [Dropdown](/docs/локальные-компоненты-tablecanvas-dropdown--docs). Пункты и их асинхронная подгрузка там устроены похоже.\n\n## Основные возможности\n\n- Правый клик по заголовку колонки или ячейке открывает контекстное меню\n- Поддержка многоуровневых dropdown-меню (на основе компонента Dropdown)\n- Кастомизация пунктов меню в зависимости от контекста (колонка/ячейка)\n- Обработка выбора пунктов меню с передачей соответствующего контекста\n\n## Варианты использования\n\n### 1. Простой обработчик клика (без меню)\n\n- `onHeaderContextMenu` — для заголовков колонок\n- `onCellContextMenu` — для ячеек таблицы\n\n### 2. Dropdown-меню (расширенный вариант)\n\n- `onHeaderContextMenuDropdown` — для заголовков\n- `onCellContextMenuDropdown` — для ячеек\n\n## Приоритет вызова\n\nЕсли определены оба варианта (и обработчик, и dropdown):\n\n1. Сначала вызывается `onHeaderContextMenu` / `onCellContextMenu`\n2. Затем происходит обработка dropdown-меню\n\n## Конфигурация Dropdown\n\nДля конфигурации dropdown-меню используются специальные пропсы, исключающие некоторые параметры стандартного Dropdown, которые управляются таблицей (например, позиционирование, триггеры и т.д.).\n\n## Асинхронная подгрузка пунктов\n\nКогда пункты меню неизвестны заранее и подгружаются по правому клику. Запросом и его состоянием (загрузка / данные / ошибка) владеет потребитель — таблица только открывает меню и реактивно перечитывает пункты.\n\n- `onOpen` — вызывается при открытии
|
|
55784
|
-
"apiDocs": "# Context Menu API\n\n## ContextMenuDropdownProps\n\nПропсы Dropdown, доступные для проброса в контекстное меню.\nМожно передать `size`, `listWidth`, `closeOnSelect`, `offset` и другие свойства Dropdown.\n\n```typescript\ntype 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>;\n```\n\n## HeaderContextMenuDropdownProps\n\n```typescript\ntype HeaderContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретного заголовка.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
55790
|
+
"docs": "# Context Menu\n\n**tableConfig.onHeaderContextMenu / onCellContextMenu / onHeaderContextMenuDropdown / onCellContextMenuDropdown**\n\nКонтекстное меню для заголовков колонок и ячеек.\n\nЕсли список нужен по левому клику или наведению на конкретный элемент внутри ячейки (кнопка «три точки», кнопка действий), используйте проп `dropdown` на Canvas-элементе: раздел [Dropdown](/docs/локальные-компоненты-tablecanvas-dropdown--docs). Пункты и их асинхронная подгрузка там устроены похоже.\n\n## Основные возможности\n\n- Правый клик по заголовку колонки или ячейке открывает контекстное меню\n- Поддержка многоуровневых dropdown-меню (на основе компонента Dropdown)\n- Кастомизация пунктов меню в зависимости от контекста (колонка/ячейка)\n- Обработка выбора пунктов меню с передачей соответствующего контекста\n\n## Варианты использования\n\n### 1. Простой обработчик клика (без меню)\n\n- `onHeaderContextMenu` — для заголовков колонок\n- `onCellContextMenu` — для ячеек таблицы\n\n### 2. Dropdown-меню (расширенный вариант)\n\n- `onHeaderContextMenuDropdown` — для заголовков\n- `onCellContextMenuDropdown` — для ячеек\n\n## Приоритет вызова\n\nЕсли определены оба варианта (и обработчик, и dropdown):\n\n1. Сначала вызывается `onHeaderContextMenu` / `onCellContextMenu`\n2. Затем происходит обработка dropdown-меню\n\n## Конфигурация Dropdown\n\nДля конфигурации dropdown-меню используются специальные пропсы, исключающие некоторые параметры стандартного Dropdown, которые управляются таблицей (например, позиционирование, триггеры и т.д.).\n\n## Асинхронная подгрузка пунктов\n\nКогда пункты меню неизвестны заранее и подгружаются по правому клику. Запросом и его состоянием (загрузка / данные / ошибка) владеет потребитель — таблица только открывает меню и реактивно перечитывает пункты.\n\n- `onOpen` — вызывается при каждом открытии меню, в том числе повторном на той же ячейке; здесь потребитель стартует запрос и хранит своё состояние. Если задан, меню открывается даже при пустом результате `getDropdownItems`. В `onOpen` синхронно переводите состояние в загрузку и принимайте только ответ последнего запроса, иначе после действия над строкой меню покажет устаревший список.\n- `getDropdownItems` — читается реактивно при отрисовке, пока меню открыто: во время загрузки верните скелетон-пункты, после — реальные. Меню обновляется само, без переоткрытия, когда меняется объект настроек меню. Побочных действий в `getDropdownItems` не делайте.\n- Индикатор загрузки — скелетон-пункты (через `renderItem`) или произвольный узел в `beforeList`.\n- Ошибка — узел в `beforeList` (например `EmptyState` с кнопкой повтора, вызывающей повторную загрузку).\n\nПример со скелетонами, успешной загрузкой и ошибкой — в стори ниже.\n\nПодробное описание API и типов доступно в разделе [API](/docs/локальные-компоненты-tablecanvas-contextmenu-api--docs).",
|
|
55791
|
+
"apiDocs": "# Context Menu API\n\n## ContextMenuDropdownProps\n\nПропсы Dropdown, доступные для проброса в контекстное меню.\nМожно передать `size`, `listWidth`, `closeOnSelect`, `offset` и другие свойства Dropdown.\n\n```typescript\ntype 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>;\n```\n\n## HeaderContextMenuDropdownProps\n\n```typescript\ntype HeaderContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретного заголовка.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropdownItems пока возвращает пусто.\n *\n * С onOpen getDropdownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>) => void;\n /** Обработчик выбора пункта меню */\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n event?: React.SyntheticEvent,\n ) => void;\n};\n```\n\n## CellContextMenuDropdownProps\n\n```typescript\ntype CellContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретной ячейки.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropdownItems пока возвращает пусто.\n *\n * С onOpen getDropdownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (\n params: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n ) => void;\n /** Обработчик выбора пункта меню */\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n event?: React.SyntheticEvent,\n ) => void;\n};\n```\n\n## DropdownContextMenu\n\n```typescript\ntype DropdownContextMenu = {\n type: 'Dropdown';\n getDropdownItems: (params: { columnLabel: string }) => DropdownProps['items'];\n} & ContextMenuDropdownProps;\n```\n\n## ContextMenuDropdownItem\n\n```typescript\ntype ContextMenuDropdownItem = NonNullable<\n DropdownProps['items']\n>[number];\n```",
|
|
55785
55792
|
"api": [
|
|
55786
55793
|
{
|
|
55787
55794
|
"typeName": "ContextMenuDropdownProps",
|
|
@@ -55789,11 +55796,11 @@
|
|
|
55789
55796
|
},
|
|
55790
55797
|
{
|
|
55791
55798
|
"typeName": "HeaderContextMenuDropdownProps",
|
|
55792
|
-
"source": "type HeaderContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретного заголовка.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
55799
|
+
"source": "type HeaderContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретного заголовка.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropdownItems пока возвращает пусто.\n *\n * С onOpen getDropdownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>) => void;\n /** Обработчик выбора пункта меню */\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n event?: React.SyntheticEvent,\n ) => void;\n};"
|
|
55793
55800
|
},
|
|
55794
55801
|
{
|
|
55795
55802
|
"typeName": "CellContextMenuDropdownProps",
|
|
55796
|
-
"source": "type CellContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретной ячейки.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
55803
|
+
"source": "type CellContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретной ячейки.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropdownItems пока возвращает пусто.\n *\n * С onOpen getDropdownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (\n params: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n ) => void;\n /** Обработчик выбора пункта меню */\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n event?: React.SyntheticEvent,\n ) => void;\n};"
|
|
55797
55804
|
},
|
|
55798
55805
|
{
|
|
55799
55806
|
"typeName": "DropdownContextMenu",
|
|
@@ -56182,7 +56189,7 @@
|
|
|
56182
56189
|
"legacy": false,
|
|
56183
56190
|
"summary": "*tableConfig.\\*.domMetadata**",
|
|
56184
56191
|
"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).",
|
|
56185
|
-
"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 * useState. Таблица показывает и прячет столбцы по значению, а свитчи в\n * правом сайдбаре, индикатор скрытых столбцов, меню закрепления и сеттеры\n * в onConfirm пишут через переданный сеттер. Таблица при этом не\n * пересоздаётся, прокрутка, выделение и настройки столбцов сохраняются.\n *\n * Когда hiddenState передан, hiddenDefault не читается. При hiding: false\n * скрытие выключено целиком: все столбцы видны, значение hiddenState не\n * применяется. По умолчанию hiding равен enable, поэтому без enable: true\n * скрытие тоже не работает.\n *\n * Сеттер должен принимать и значение, и функцию от прежнего значения, как\n * сеттер из useState: таблица меняет список функцией. Если состояние лежит\n * в сторе, нужна обёртка, которая это умеет.\n *\n * Если скрыть столбец, по которому отсортированы строки, сортировка\n * снимается.\n *\n * Столбец с парой key/text обозначается исходным ключом из columnConfig,\n * таблица сама скроет оба столбца пары. Сама таблица тоже пишет в значение\n * только исходный ключ, поэтому скрытие пары снимается одним ключом.\n *\n * Массив держите в useState, а не создавайте заново на каждом рендере.\n * Не копируйте hidden из onConfirm обратно в hiddenState: состояние уже\n * обновлено через сеттер. В режиме confirm изменение hiddenState при\n * открытой панели сбрасывает её неприменённые правки скрытия.\n * Свои столбцы меняйте функциональным сеттером, тогда скрытие, сделанное\n * пользователем в сайдбаре, сохранится. Если показ зависит от режима\n * редактирования, меняйте оба состояния в одном обработчике:\n *\n * @example\n * const [hidden, setHidden] = useState(['comment']);\n * const toggleEdit = () => {\n * setEditOn(!editOn);\n * setHidden((prev) =>\n * editOn\n * ? [...new Set([...prev, 'comment'])]\n * : prev.filter((key) => key !== 'comment'),\n * );\n * };\n */\n hiddenState?: [string[], React.Dispatch<React.SetStateAction<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```",
|
|
56192
|
+
"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 * useState. Таблица показывает и прячет столбцы по значению, а свитчи в\n * правом сайдбаре, индикатор скрытых столбцов, меню закрепления и сеттеры\n * в onConfirm пишут через переданный сеттер. Таблица при этом не\n * пересоздаётся, прокрутка, выделение и настройки столбцов сохраняются.\n *\n * Когда hiddenState передан, hiddenDefault не читается. При hiding: false\n * скрытие выключено целиком: все столбцы видны, значение hiddenState не\n * применяется. По умолчанию hiding равен enable, поэтому без enable: true\n * скрытие тоже не работает.\n *\n * Сеттер должен принимать и значение, и функцию от прежнего значения, как\n * сеттер из useState: таблица меняет список функцией. Если состояние лежит\n * в сторе, нужна обёртка, которая это умеет.\n *\n * Если скрыть столбец, по которому отсортированы строки, сортировка\n * снимается.\n *\n * Столбец с парой key/text обозначается исходным ключом из columnConfig,\n * таблица сама скроет оба столбца пары. Сама таблица тоже пишет в значение\n * только исходный ключ, поэтому скрытие пары снимается одним ключом. Второй\n * ключ пары без исходного пару не скрывает, поэтому список из onConfirm.hidden,\n * где у пары оба ключа, тоже снимается одним исходным ключом. В режиме\n * показа только ключа на экране виден столбец второго ключа, но скрывать\n * его всё равно нужно исходным ключом.\n *\n * Массив держите в useState, а не создавайте заново на каждом рендере.\n * Не копируйте hidden из onConfirm обратно в hiddenState: состояние уже\n * обновлено через сеттер. В режиме confirm изменение hiddenState при\n * открытой панели сбрасывает её неприменённые правки скрытия.\n * Свои столбцы меняйте функциональным сеттером, тогда скрытие, сделанное\n * пользователем в сайдбаре, сохранится. Если показ зависит от режима\n * редактирования, меняйте оба состояния в одном обработчике:\n *\n * @example\n * const [hidden, setHidden] = useState(['comment']);\n * const toggleEdit = () => {\n * setEditOn(!editOn);\n * setHidden((prev) =>\n * editOn\n * ? [...new Set([...prev, 'comment'])]\n * : prev.filter((key) => key !== 'comment'),\n * );\n * };\n */\n hiddenState?: [string[], React.Dispatch<React.SetStateAction<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 * onConfirm придёт, только если сеттер записал ровно то, что передала\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```",
|
|
56186
56193
|
"api": [
|
|
56187
56194
|
{
|
|
56188
56195
|
"typeName": "DomMetadata",
|
|
@@ -56198,7 +56205,7 @@
|
|
|
56198
56205
|
},
|
|
56199
56206
|
{
|
|
56200
56207
|
"typeName": "ColumnsControlConfig",
|
|
56201
|
-
"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 * useState. Таблица показывает и прячет столбцы по значению, а свитчи в\n * правом сайдбаре, индикатор скрытых столбцов, меню закрепления и сеттеры\n * в onConfirm пишут через переданный сеттер. Таблица при этом не\n * пересоздаётся, прокрутка, выделение и настройки столбцов сохраняются.\n *\n * Когда hiddenState передан, hiddenDefault не читается. При hiding: false\n * скрытие выключено целиком: все столбцы видны, значение hiddenState не\n * применяется. По умолчанию hiding равен enable, поэтому без enable: true\n * скрытие тоже не работает.\n *\n * Сеттер должен принимать и значение, и функцию от прежнего значения, как\n * сеттер из useState: таблица меняет список функцией. Если состояние лежит\n * в сторе, нужна обёртка, которая это умеет.\n *\n * Если скрыть столбец, по которому отсортированы строки, сортировка\n * снимается.\n *\n * Столбец с парой key/text обозначается исходным ключом из columnConfig,\n * таблица сама скроет оба столбца пары. Сама таблица тоже пишет в значение\n * только исходный ключ, поэтому скрытие пары снимается одним ключом.\n *\n * Массив держите в useState, а не создавайте заново на каждом рендере.\n * Не копируйте hidden из onConfirm обратно в hiddenState: состояние уже\n * обновлено через сеттер. В режиме confirm изменение hiddenState при\n * открытой панели сбрасывает её неприменённые правки скрытия.\n * Свои столбцы меняйте функциональным сеттером, тогда скрытие, сделанное\n * пользователем в сайдбаре, сохранится. Если показ зависит от режима\n * редактирования, меняйте оба состояния в одном обработчике:\n *\n * @example\n * const [hidden, setHidden] = useState(['comment']);\n * const toggleEdit = () => {\n * setEditOn(!editOn);\n * setHidden((prev) =>\n * editOn\n * ? [...new Set([...prev, 'comment'])]\n * : prev.filter((key) => key !== 'comment'),\n * );\n * };\n */\n hiddenState?: [string[], React.Dispatch<React.SetStateAction<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};"
|
|
56208
|
+
"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 * useState. Таблица показывает и прячет столбцы по значению, а свитчи в\n * правом сайдбаре, индикатор скрытых столбцов, меню закрепления и сеттеры\n * в onConfirm пишут через переданный сеттер. Таблица при этом не\n * пересоздаётся, прокрутка, выделение и настройки столбцов сохраняются.\n *\n * Когда hiddenState передан, hiddenDefault не читается. При hiding: false\n * скрытие выключено целиком: все столбцы видны, значение hiddenState не\n * применяется. По умолчанию hiding равен enable, поэтому без enable: true\n * скрытие тоже не работает.\n *\n * Сеттер должен принимать и значение, и функцию от прежнего значения, как\n * сеттер из useState: таблица меняет список функцией. Если состояние лежит\n * в сторе, нужна обёртка, которая это умеет.\n *\n * Если скрыть столбец, по которому отсортированы строки, сортировка\n * снимается.\n *\n * Столбец с парой key/text обозначается исходным ключом из columnConfig,\n * таблица сама скроет оба столбца пары. Сама таблица тоже пишет в значение\n * только исходный ключ, поэтому скрытие пары снимается одним ключом. Второй\n * ключ пары без исходного пару не скрывает, поэтому список из onConfirm.hidden,\n * где у пары оба ключа, тоже снимается одним исходным ключом. В режиме\n * показа только ключа на экране виден столбец второго ключа, но скрывать\n * его всё равно нужно исходным ключом.\n *\n * Массив держите в useState, а не создавайте заново на каждом рендере.\n * Не копируйте hidden из onConfirm обратно в hiddenState: состояние уже\n * обновлено через сеттер. В режиме confirm изменение hiddenState при\n * открытой панели сбрасывает её неприменённые правки скрытия.\n * Свои столбцы меняйте функциональным сеттером, тогда скрытие, сделанное\n * пользователем в сайдбаре, сохранится. Если показ зависит от режима\n * редактирования, меняйте оба состояния в одном обработчике:\n *\n * @example\n * const [hidden, setHidden] = useState(['comment']);\n * const toggleEdit = () => {\n * setEditOn(!editOn);\n * setHidden((prev) =>\n * editOn\n * ? [...new Set([...prev, 'comment'])]\n * : prev.filter((key) => key !== 'comment'),\n * );\n * };\n */\n hiddenState?: [string[], React.Dispatch<React.SetStateAction<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 * onConfirm придёт, только если сеттер записал ровно то, что передала\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};"
|
|
56202
56209
|
}
|
|
56203
56210
|
],
|
|
56204
56211
|
"stories": [
|
|
@@ -58068,8 +58075,8 @@
|
|
|
58068
58075
|
"feature": "contextMenu",
|
|
58069
58076
|
"legacy": true,
|
|
58070
58077
|
"summary": "Контекстное меню для заголовков и ячеек legacy `Table`.",
|
|
58071
|
-
"docs": "# ContextMenu\n\nКонтекстное меню для заголовков и ячеек legacy `Table`.\n\n## Ключевые особенности\n\n- Обработчик правого клика по заголовку через `onHeaderContextMenu`\n- Dropdown-меню для заголовка через `onHeaderContextMenuDropDown`\n- Dropdown-меню для ячейки через `onCellContextMenuDropDown`\n- Возможность получить контекст строки, колонки и выбранной ячейки\n- Поддержка многоуровневых пунктов меню\n\n## Особенности\n\nЕсли одновременно заданы простой handler и dropdown-конфиг, сначала вызывается handler, затем логика dropdown. Dropdown-конфиг использует не все props базового `Dropdown`: позиционирование и открытие управляются таблицей.\n\n## Асинхронная подгрузка пунктов\n\nКогда пункты меню неизвестны заранее и подгружаются по правому клику. Запросом и его состоянием (загрузка / данные / ошибка) владеет потребитель — таблица только открывает меню и реактивно перечитывает пункты.\n\n- `onOpen` — вызывается при открытии
|
|
58072
|
-
"apiDocs": "# Context Menu API\n\n## ContextMenuDropdownItem\n\n```typescript\ntype ContextMenuDropdownItem = NonNullable<\n DropdownProps['items']\n>[number];\n```\n\n## ContextMenuDropDownProps\n\n```typescript\ntype ContextMenuDropDownProps = Omit<\n DropdownProps,\n | 'children'\n | 'items'\n | 'placement'\n | 'closeOnOverlayClick'\n | 'portal'\n | 'openByRightClick'\n | 'onItemClick'\n | 'hoverIndex'\n | 'size'\n | 'alwaysOpened'\n | 'trigger'\n | 'hasArrow'\n | 'onItemSelect'\n>;\n```\n\n## DropdownContextMenu\n\n```typescript\ntype DropdownContextMenu = {\n type: 'dropdown';\n getDropDownItems: (params: { columnLabel: string }) => DropdownProps['items'];\n} & ContextMenuDropDownProps;\n```\n\n## HeaderContextMenuProps\n\n```typescript\ntype HeaderContextMenuProps = (\n event: React.MouseEvent,\n columnLabel: string | undefined,\n closestTargetElement: HTMLElement | undefined,\n) => void;\n```\n\n## HeaderContextMenuDropDownProps\n\n```typescript\ntype HeaderContextMenuDropDownProps = {\n type: 'dropdown';\n getDropDownItems: (params: {\n columnLabel: string | undefined;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
58078
|
+
"docs": "# ContextMenu\n\nКонтекстное меню для заголовков и ячеек legacy `Table`.\n\n## Ключевые особенности\n\n- Обработчик правого клика по заголовку через `onHeaderContextMenu`\n- Dropdown-меню для заголовка через `onHeaderContextMenuDropDown`\n- Dropdown-меню для ячейки через `onCellContextMenuDropDown`\n- Возможность получить контекст строки, колонки и выбранной ячейки\n- Поддержка многоуровневых пунктов меню\n\n## Особенности\n\nЕсли одновременно заданы простой handler и dropdown-конфиг, сначала вызывается handler, затем логика dropdown. Dropdown-конфиг использует не все props базового `Dropdown`: позиционирование и открытие управляются таблицей.\n\n## Асинхронная подгрузка пунктов\n\nКогда пункты меню неизвестны заранее и подгружаются по правому клику. Запросом и его состоянием (загрузка / данные / ошибка) владеет потребитель — таблица только открывает меню и реактивно перечитывает пункты.\n\n- `onOpen` — вызывается при каждом открытии меню, в том числе повторном на той же ячейке; здесь потребитель стартует запрос и хранит своё состояние. Если задан, меню открывается даже при пустом результате `getDropDownItems`. В `onOpen` синхронно переводите состояние в загрузку и принимайте только ответ последнего запроса, иначе после действия над строкой меню покажет устаревший список.\n- `getDropDownItems` — читается реактивно при отрисовке, пока меню открыто: во время загрузки верните скелетон-пункты, после — реальные. Меню обновляется само, без переоткрытия, когда меняется объект настроек меню. Побочных действий в `getDropDownItems` не делайте.\n- Индикатор загрузки — скелетон-пункты (через `renderItem`) или произвольный узел в `beforeList`.\n- Ошибка — узел в `beforeList` (например `EmptyState` с кнопкой повтора, вызывающей повторную загрузку).\n\nПример со скелетонами, успешной загрузкой и ошибкой — в стори ниже.\n\nОписание типов - в разделе [API](?path=/docs/локальные-компоненты-table-contextmenu-api--docs).",
|
|
58079
|
+
"apiDocs": "# Context Menu API\n\n## ContextMenuDropdownItem\n\n```typescript\ntype ContextMenuDropdownItem = NonNullable<\n DropdownProps['items']\n>[number];\n```\n\n## ContextMenuDropDownProps\n\n```typescript\ntype ContextMenuDropDownProps = Omit<\n DropdownProps,\n | 'children'\n | 'items'\n | 'placement'\n | 'closeOnOverlayClick'\n | 'portal'\n | 'openByRightClick'\n | 'onItemClick'\n | 'hoverIndex'\n | 'size'\n | 'alwaysOpened'\n | 'trigger'\n | 'hasArrow'\n | 'onItemSelect'\n>;\n```\n\n## DropdownContextMenu\n\n```typescript\ntype DropdownContextMenu = {\n type: 'dropdown';\n getDropDownItems: (params: { columnLabel: string }) => DropdownProps['items'];\n} & ContextMenuDropDownProps;\n```\n\n## HeaderContextMenuProps\n\n```typescript\ntype HeaderContextMenuProps = (\n event: React.MouseEvent,\n columnLabel: string | undefined,\n closestTargetElement: HTMLElement | undefined,\n) => void;\n```\n\n## HeaderContextMenuDropDownProps\n\n```typescript\ntype HeaderContextMenuDropDownProps = {\n type: 'dropdown';\n getDropDownItems: (params: {\n columnLabel: string | undefined;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropDownItems пока возвращает пусто.\n *\n * С onOpen getDropDownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: { columnLabel: string | undefined }) => void;\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: { columnLabel: string | undefined },\n event?: React.SyntheticEvent,\n ) => void;\n} & ContextMenuDropDownProps;\n```\n\n## CellContextMenuDropDownProps\n\n```typescript\ntype CellContextMenuDropDownProps<RowType, SummaryRowType> = {\n type: 'dropdown';\n getDropDownItems: (params: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropDownItems пока возвращает пусто.\n *\n * С onOpen getDropDownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n }) => void;\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n selectCell: (enableEditor?: boolean) => void;\n },\n event?: React.SyntheticEvent,\n ) => void;\n} & ContextMenuDropDownProps;\n```",
|
|
58073
58080
|
"api": [
|
|
58074
58081
|
{
|
|
58075
58082
|
"typeName": "ContextMenuDropdownItem",
|
|
@@ -58089,11 +58096,11 @@
|
|
|
58089
58096
|
},
|
|
58090
58097
|
{
|
|
58091
58098
|
"typeName": "HeaderContextMenuDropDownProps",
|
|
58092
|
-
"source": "type HeaderContextMenuDropDownProps = {\n type: 'dropdown';\n getDropDownItems: (params: {\n columnLabel: string | undefined;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
58099
|
+
"source": "type HeaderContextMenuDropDownProps = {\n type: 'dropdown';\n getDropDownItems: (params: {\n columnLabel: string | undefined;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropDownItems пока возвращает пусто.\n *\n * С onOpen getDropDownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: { columnLabel: string | undefined }) => void;\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: { columnLabel: string | undefined },\n event?: React.SyntheticEvent,\n ) => void;\n} & ContextMenuDropDownProps;"
|
|
58093
58100
|
},
|
|
58094
58101
|
{
|
|
58095
58102
|
"typeName": "CellContextMenuDropDownProps",
|
|
58096
|
-
"source": "type CellContextMenuDropDownProps<RowType, SummaryRowType> = {\n type: 'dropdown';\n getDropDownItems: (params: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
58103
|
+
"source": "type CellContextMenuDropDownProps<RowType, SummaryRowType> = {\n type: 'dropdown';\n getDropDownItems: (params: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropDownItems пока возвращает пусто.\n *\n * С onOpen getDropDownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n }) => void;\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n selectCell: (enableEditor?: boolean) => void;\n },\n event?: React.SyntheticEvent,\n ) => void;\n} & ContextMenuDropDownProps;"
|
|
58097
58104
|
}
|
|
58098
58105
|
],
|
|
58099
58106
|
"stories": [
|
|
@@ -59068,7 +59075,7 @@
|
|
|
59068
59075
|
},
|
|
59069
59076
|
"AiAgentLeftPanelProps": {
|
|
59070
59077
|
"name": "AiAgentLeftPanelProps",
|
|
59071
|
-
"definition": "export type AiAgentLeftPanelProps = {\n /**\n *
|
|
59078
|
+
"definition": "export type AiAgentLeftPanelProps = {\n /**\n * Пункты панели: разделы с контентом и кнопки-действия с onClick.\n */\n items: AiAgentLeftPanelItem[];\n /**\n * Ключ открытого раздела. null или undefined — открыта полоса иконок,\n * раздел закрыт. Управляемый режим: значение задаёт потребитель.\n */\n activeKey?: string | null;\n /**\n * Начальный открытый раздел в неуправляемом режиме (когда activeKey\n * не передан).\n */\n defaultActiveKey?: string | null;\n /**\n * Смена открытого раздела: ключ раздела при клике по иконке, null\n * при закрытии крестиком. Клик по пункту-действию сюда не приходит.\n */\n onActiveKeyChange?: (key: string | null) => void;\n};",
|
|
59072
59079
|
"importPath": "@daisforge/ui",
|
|
59073
59080
|
"importStatement": "import { AiAgentLeftPanelProps } from '@daisforge/ui';",
|
|
59074
59081
|
"sourceFile": "packages/ui-kit/src/components/AiAgentPopup/AiAgentPopup.types.ts"
|
|
@@ -59376,14 +59383,14 @@
|
|
|
59376
59383
|
},
|
|
59377
59384
|
"HeaderContextMenuDropdownProps": {
|
|
59378
59385
|
"name": "HeaderContextMenuDropdownProps",
|
|
59379
|
-
"definition": "export type HeaderContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретного заголовка.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
59386
|
+
"definition": "export type HeaderContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType = unknown,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретного заголовка.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropdownItems пока возвращает пусто.\n *\n * С onOpen getDropdownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: TableInfoBase<RowType, SummaryRowType, CustomCtxs>) => void;\n /** Обработчик выбора пункта меню */\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: TableInfoBase<RowType, SummaryRowType, CustomCtxs>,\n event?: React.SyntheticEvent,\n ) => void;\n};",
|
|
59380
59387
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
59381
59388
|
"importStatement": "import { HeaderContextMenuDropdownProps } from '@daisforge/ui/components/TableCanvas';",
|
|
59382
59389
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
59383
59390
|
},
|
|
59384
59391
|
"CellContextMenuDropdownProps": {
|
|
59385
59392
|
"name": "CellContextMenuDropdownProps",
|
|
59386
|
-
"definition": "export type CellContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретной ячейки.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
59393
|
+
"definition": "export type CellContextMenuDropdownProps<\n RowType extends ObjectForExtending,\n SummaryRowType,\n CustomCtxs extends ObjectForExtending = ObjectForExtending,\n> = ContextMenuDropdownProps & {\n /** Тип конфигурации (всегда 'dropdown') */\n type: 'dropdown';\n /**\n * Функция, возвращающая массив пунктов меню для конкретной ячейки.\n * В асинхронном режиме (задан onOpen) перечитывается реактивно, пока меню\n * открыто: верните скелетон-пункты во время загрузки и реальные — после.\n */\n getDropdownItems: (\n params: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n ) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropdownItems пока возвращает пусто.\n *\n * С onOpen getDropdownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (\n params: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n ) => void;\n /** Обработчик выбора пункта меню */\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: TableInfoWithRow<RowType, SummaryRowType, CustomCtxs>,\n event?: React.SyntheticEvent,\n ) => void;\n};",
|
|
59387
59394
|
"importPath": "@daisforge/ui/components/TableCanvas",
|
|
59388
59395
|
"importStatement": "import { CellContextMenuDropdownProps } from '@daisforge/ui/components/TableCanvas';",
|
|
59389
59396
|
"sourceFile": "packages/ui-kit/src/components/TableCanvas/TableGlideInstance/type.ts"
|
|
@@ -59516,7 +59523,7 @@
|
|
|
59516
59523
|
},
|
|
59517
59524
|
"AiAgentLeftPanelItem": {
|
|
59518
59525
|
"name": "AiAgentLeftPanelItem",
|
|
59519
|
-
"definition": "export type AiAgentLeftPanelItem
|
|
59526
|
+
"definition": "export type AiAgentLeftPanelItem =\n | AiAgentLeftPanelSectionItem\n | AiAgentLeftPanelActionItem;",
|
|
59520
59527
|
"importPath": "@daisforge/ui",
|
|
59521
59528
|
"importStatement": "import { AiAgentLeftPanelItem } from '@daisforge/ui';",
|
|
59522
59529
|
"sourceFile": "packages/ui-kit/src/components/AiAgentPopup/AiAgentPopup.types.ts"
|
|
@@ -60956,6 +60963,20 @@
|
|
|
60956
60963
|
"importNotice": "Тип \"CSSValue\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
60957
60964
|
"sourceFile": "packages/ui-kit/src/layouts/PageLayout/PageLayout.types.ts"
|
|
60958
60965
|
},
|
|
60966
|
+
"AiAgentLeftPanelSectionItem": {
|
|
60967
|
+
"name": "AiAgentLeftPanelSectionItem",
|
|
60968
|
+
"definition": "export type AiAgentLeftPanelSectionItem = AiAgentLeftPanelItemBase & {\n /**\n * Иконка слева в шапке открытого раздела, компонент ставит её по центру\n * квадрата 40x40. Если не задана, берётся icon.\n */\n titleIcon?: ReactNode;\n /**\n * Заголовок открытого раздела (в шапке, рядом с иконкой и крестиком).\n */\n title: ReactNode;\n /**\n * Контент открытого раздела под шапкой. Отступы, скролл и наполнение\n * полностью на стороне потребителя.\n */\n content: ReactNode;\n /**\n * Клик по кнопке раздела. Вызывается перед открытием раздела.\n */\n onClick?: (event: MouseEvent<HTMLButtonElement>) => void;\n};",
|
|
60969
|
+
"importPath": "@daisforge/ui",
|
|
60970
|
+
"importStatement": "import { AiAgentLeftPanelSectionItem } from '@daisforge/ui';",
|
|
60971
|
+
"sourceFile": "packages/ui-kit/src/components/AiAgentPopup/AiAgentPopup.types.ts"
|
|
60972
|
+
},
|
|
60973
|
+
"AiAgentLeftPanelActionItem": {
|
|
60974
|
+
"name": "AiAgentLeftPanelActionItem",
|
|
60975
|
+
"definition": "export type AiAgentLeftPanelActionItem = AiAgentLeftPanelItemBase & {\n /**\n * Клик по кнопке.\n */\n onClick: (event: MouseEvent<HTMLButtonElement>) => void;\n titleIcon?: never;\n title?: never;\n content?: never;\n};",
|
|
60976
|
+
"importPath": "@daisforge/ui",
|
|
60977
|
+
"importStatement": "import { AiAgentLeftPanelActionItem } from '@daisforge/ui';",
|
|
60978
|
+
"sourceFile": "packages/ui-kit/src/components/AiAgentPopup/AiAgentPopup.types.ts"
|
|
60979
|
+
},
|
|
60959
60980
|
"StageStatus": {
|
|
60960
60981
|
"name": "StageStatus",
|
|
60961
60982
|
"definition": "export type StageStatus = 'DEFAULT' | 'WAIT' | 'SUCCESSFUL' | 'FAILURE';",
|
|
@@ -61392,14 +61413,14 @@
|
|
|
61392
61413
|
},
|
|
61393
61414
|
"HeaderContextMenuDropDownProps": {
|
|
61394
61415
|
"name": "HeaderContextMenuDropDownProps",
|
|
61395
|
-
"definition": "export type HeaderContextMenuDropDownProps = {\n type: 'dropdown';\n getDropDownItems: (params: {\n columnLabel: string | undefined;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
61416
|
+
"definition": "export type HeaderContextMenuDropDownProps = {\n type: 'dropdown';\n getDropDownItems: (params: {\n columnLabel: string | undefined;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropDownItems пока возвращает пусто.\n *\n * С onOpen getDropDownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: { columnLabel: string | undefined }) => void;\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: { columnLabel: string | undefined },\n event?: React.SyntheticEvent,\n ) => void;\n} & ContextMenuDropDownProps;",
|
|
61396
61417
|
"internal": true,
|
|
61397
61418
|
"importNotice": "Тип \"HeaderContextMenuDropDownProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
61398
61419
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-context-menu/types.ts"
|
|
61399
61420
|
},
|
|
61400
61421
|
"CellContextMenuDropDownProps": {
|
|
61401
61422
|
"name": "CellContextMenuDropDownProps",
|
|
61402
|
-
"definition": "export type CellContextMenuDropDownProps<RowType, SummaryRowType> = {\n type: 'dropdown';\n getDropDownItems: (params: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки.
|
|
61423
|
+
"definition": "export type CellContextMenuDropDownProps<RowType, SummaryRowType> = {\n type: 'dropdown';\n getDropDownItems: (params: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n }) => DropdownProps['items'];\n /**\n * Колбэк открытия меню для асинхронной подгрузки. Вызывается при каждом\n * открытии, в том числе повторном на той же ячейке: потребитель здесь\n * синхронно переводит своё состояние в загрузку, стартует запрос и\n * принимает только ответ последнего запроса. Меню открывается, даже если\n * getDropDownItems пока возвращает пусто.\n *\n * С onOpen getDropDownItems вызывается при отрисовке, пока меню открыто,\n * а не один раз при открытии: побочных действий в нём быть не должно.\n * Пункты обновляются, когда меняется объект настроек меню, поэтому не\n * мемоизируйте его без зависимости от состояния загрузки.\n */\n onOpen?: (params: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n }) => void;\n onItemSelect?: (\n item: ContextMenuDropdownItem,\n context: {\n row: RowType;\n column: CalculatedColumn<RowType, SummaryRowType>;\n selectCell: (enableEditor?: boolean) => void;\n },\n event?: React.SyntheticEvent,\n ) => void;\n} & ContextMenuDropDownProps;",
|
|
61403
61424
|
"internal": true,
|
|
61404
61425
|
"importNotice": "Тип \"CellContextMenuDropDownProps\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
61405
61426
|
"sourceFile": "packages/ui-kit/src/components/Table/feature-context-menu/types.ts"
|
|
@@ -61719,6 +61740,13 @@
|
|
|
61719
61740
|
"importStatement": "import { PopoverCompProps } from '@daisforge/ui';",
|
|
61720
61741
|
"sourceFile": "packages/ui-kit/src/components/Popover/index.ts"
|
|
61721
61742
|
},
|
|
61743
|
+
"AiAgentLeftPanelItemBase": {
|
|
61744
|
+
"name": "AiAgentLeftPanelItemBase",
|
|
61745
|
+
"definition": "type AiAgentLeftPanelItemBase = {\n /**\n * Уникальный ключ пункта. У раздела по нему определяется открытый раздел\n * (activeKey) и приходит смена в onActiveKeyChange.\n */\n key: string;\n /**\n * Иконка в полосе (свёрнутое состояние левой панели).\n */\n icon: ReactNode;\n /**\n * Группа кнопки в полосе. Кнопки bottom прижаты к нижнему краю панели,\n * порядок внутри группы как в items.\n * @default top\n */\n placement?: AiAgentLeftPanelItemPlacement;\n /**\n * Выключить кнопку в полосе. Уже открытый раздел остаётся открытым\n * и закрывается крестиком.\n * @default false\n */\n disabled?: boolean;\n};",
|
|
61746
|
+
"internal": true,
|
|
61747
|
+
"importNotice": "Тип \"AiAgentLeftPanelItemBase\" не экспортируется из публичной точки входа — импортировать его нельзя. Определение приведено для понимания структуры: опишите нужную форму по месту либо возьмите её из типа, который экспортирован.",
|
|
61748
|
+
"sourceFile": "packages/ui-kit/src/components/AiAgentPopup/AiAgentPopup.types.ts"
|
|
61749
|
+
},
|
|
61722
61750
|
"Table.ActiveViewModsType": {
|
|
61723
61751
|
"name": "ActiveViewModsType",
|
|
61724
61752
|
"definition": "export type ActiveViewModsType = Exclude<keyof ViewMods, 'bothTypes'>;",
|