@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.12

package/storybook-static/assets/README-BIq-FXcN.js

@@ -0,0 +1,2124 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,blockquote:`blockquote`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,h4:`h4`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,strong:`strong`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Data/Table and Tree Table`}),`
+`,(0,c.jsx)(t.h1,{id:`table-и-tree-table`,children:`Table и Tree Table`}),`
+`,(0,c.jsx)(t.p,{children:`Эта страница описывает два связанных публичных модуля:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/table`}),` — типы и helpers для TanStack Table v9, колонок, layout, выбора строк и ячеек, а также OData metadata;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/tree-table`}),` — построение древовидных строк и преобразование плоских аналитических данных в иерархию.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Документ рассчитан на разработчика без доступа к исходному коду пакета и с минимальным знанием JavaScript, TypeScript, React и TanStack Table. В нём объясняются не только названия функций, но и смысл каждого состояния, правила идентификаторов, результат вызова, ограничения и типичные ошибки.`}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[`Документ один, потому что плоская и древовидная таблицы используют общие понятия строк, колонок, идентификаторов и selection. Публичных import path при этом два: API `,(0,c.jsx)(t.code,{children:`tree-table`}),` не реэкспортируется из `,(0,c.jsx)(t.code,{children:`table`}),`, а API `,(0,c.jsx)(t.code,{children:`table`}),` не реэкспортируется из `,(0,c.jsx)(t.code,{children:`tree-table`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B`,children:`Назначение и границы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D1%82%D0%BE-%D0%BD%D1%83%D0%B6%D0%BD%D0%BE-%D0%B7%D0%BD%D0%B0%D1%82%D1%8C-%D0%BF%D0%B5%D1%80%D0%B5%D0%B4-%D0%BD%D0%B0%D1%87%D0%B0%D0%BB%D0%BE%D0%BC`,children:`Что нужно знать перед началом`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%B0%D0%BA-%D0%B2%D1%8B%D0%B1%D1%80%D0%B0%D1%82%D1%8C-%D0%BD%D1%83%D0%B6%D0%BD%D1%83%D1%8E-%D1%87%D0%B0%D1%81%D1%82%D1%8C-api`,children:`Как выбрать нужную часть API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82-%D0%BF%D0%BB%D0%BE%D1%81%D0%BA%D0%B0%D1%8F-%D1%82%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0`,children:`Быстрый старт: плоская таблица`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82-%D0%B4%D0%B5%D1%80%D0%B5%D0%B2%D0%BE-%D1%81-parentid`,children:[`Быстрый старт: дерево с `,(0,c.jsx)(t.code,{children:`parentId`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82-%D0%B4%D0%B5%D1%80%D0%B5%D0%B2%D0%BE-%D0%B8%D0%B7-%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D1%85-%D0%BA%D0%BE%D0%BB%D0%BE%D0%BD%D0%BE%D0%BA`,children:`Быстрый старт: дерево из аналитических колонок`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%BE%D0%BB%D0%BE%D0%BD%D0%BA%D0%B8-%D0%B8-%D0%B8%D1%85-metadata`,children:`Колонки и их metadata`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#foundation-features-tanstack-table`,children:`Foundation features TanStack Table`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D1%80%D1%8F%D0%B4%D0%BE%D0%BA-%D0%B8-layout-%D0%BA%D0%BE%D0%BB%D0%BE%D0%BD%D0%BE%D0%BA`,children:`Порядок и layout колонок`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#drag-and-drop-%D0%BF%D0%B5%D1%80%D0%B5%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BA%D0%BE%D0%BB%D0%BE%D0%BD%D0%BE%D0%BA`,children:`Drag-and-drop перестановка колонок`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%88%D0%B8%D1%80%D0%B8%D0%BD%D1%8B-%D0%BA%D0%BE%D0%BB%D0%BE%D0%BD%D0%BE%D0%BA`,children:`Ширины колонок`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B2%D0%B8%D0%B4%D0%B8%D0%BC%D0%BE%D1%81%D1%82%D1%8C-%D0%BA%D0%BE%D0%BB%D0%BE%D0%BD%D0%BE%D0%BA`,children:`Видимость колонок`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B2%D1%8B%D0%B1%D0%BE%D1%80-%D1%81%D1%82%D1%80%D0%BE%D0%BA`,children:`Выбор строк`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#hook-usetablerowselection`,children:[`Hook `,(0,c.jsx)(t.code,{children:`useTableRowSelection`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B2%D1%8B%D0%B1%D0%BE%D1%80-%D1%8F%D1%87%D0%B5%D0%B5%D0%BA`,children:`Выбор ячеек`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D0%B0%D0%BA%D1%82%D0%B8%D0%B2%D0%BD%D1%8B%D0%B5-%D1%8D%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82%D1%8B-%D0%B8-css-%D0%B4%D0%BB%D0%B8%D0%BD%D1%8B`,children:`Интерактивные элементы и CSS-длины`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%BE%D0%BB%D0%BE%D0%BD%D0%BA%D0%B8-%D0%B8%D0%B7-odata-metadata`,children:`Колонки из OData metadata`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D0%BF%D0%BE%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B5%D1%80%D0%B5%D0%B2%D0%B0-%D0%B8%D0%B7-id-%D0%B8-parentid`,children:[`Построение дерева из `,(0,c.jsx)(t.code,{children:`id`}),` и `,(0,c.jsx)(t.code,{children:`parentId`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BF%D0%BE%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D1%85-%D1%81%D1%82%D1%80%D0%BE%D0%BA`,children:`Транспонирование аналитических строк`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9-pipeline-%D0%B4%D0%BB%D1%8F-%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B3%D0%BE-%D0%B4%D0%B5%D1%80%D0%B5%D0%B2%D0%B0`,children:`Полный pipeline для аналитического дерева`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#controlled-state-%D0%B8-%D1%81%D0%BE%D1%85%D1%80%D0%B0%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BA`,children:`Controlled state и сохранение настроек`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#server-side-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D0%B5-%D0%B8-%D0%BF%D0%B0%D0%B3%D0%B8%D0%BD%D0%B0%D1%86%D0%B8%D1%8F`,children:`Server-side данные и пагинация`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#react-browser-%D0%B8-ssr`,children:`React, browser и SSR`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%BE%D0%B8%D0%B7%D0%B2%D0%BE%D0%B4%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D1%8C`,children:`Производительность`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-consumer-%D0%BA%D0%BE%D0%B4%D0%B0`,children:`Тестирование consumer-кода`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D0%B0%D1%8F-%D0%BA%D0%B0%D1%80%D1%82%D0%B0-api-table`,children:[`Полная карта API `,(0,c.jsx)(t.code,{children:`table`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D0%B0%D1%8F-%D0%BA%D0%B0%D1%80%D1%82%D0%B0-api-tree-table`,children:[`Полная карта API `,(0,c.jsx)(t.code,{children:`tree-table`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B8%D0%BF%D0%B8%D1%87%D0%BD%D1%8B%D0%B5-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`Типичные ошибки`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D0%B0%D1%81%D1%82%D1%8B%D0%B5-%D0%B2%D0%BE%D0%BF%D1%80%D0%BE%D1%81%D1%8B`,children:`Частые вопросы`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы`,children:`Назначение и границы`}),`
+`,(0,c.jsxs)(t.h3,{id:`что-делает-table`,children:[`Что делает `,(0,c.jsx)(t.code,{children:`table`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль предоставляет общий технический контракт таблиц:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`данные + стабильные rowId
+              │
+              ▼
+      TanStack Table state
+       /       │        \\
+  columns   selection   sizing/order
+       \\       │        /
+              ▼
+       UI-компонент host
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Основные возможности:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`единый набор TanStack Table v9 features;`}),`
+`,(0,c.jsx)(t.li,{children:`типизированное описание колонок;`}),`
+`,(0,c.jsx)(t.li,{children:`metadata колонки: ширина, выравнивание, display-only merge и форматирование;`}),`
+`,(0,c.jsx)(t.li,{children:`восстановление и изменение порядка колонок;`}),`
+`,(0,c.jsx)(t.li,{children:`нормализация ширин колонок;`}),`
+`,(0,c.jsxs)(t.li,{children:[`выбор строк в режимах `,(0,c.jsx)(t.code,{children:`none`}),`, `,(0,c.jsx)(t.code,{children:`single`}),` и `,(0,c.jsx)(t.code,{children:`multi`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`выбор ячеек по координатам `,(0,c.jsx)(t.code,{children:`rowId + columnId`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`React hook для общей модели выбора строк;`}),`
+`,(0,c.jsx)(t.li,{children:`генерация колонок и стартовой видимости по OData metadata;`}),`
+`,(0,c.jsx)(t.li,{children:`browser helper, который отличает клик по кнопке от клика по строке.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`что-делает-tree-table`,children:[`Что делает `,(0,c.jsx)(t.code,{children:`tree-table`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль решает две разные задачи:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),` связывает уже существующие строки по `,(0,c.jsx)(t.code,{children:`id`}),` и `,(0,c.jsx)(t.code,{children:`parentId`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`}),` создаёт уровни дерева из значений колонок, например `,(0,c.jsx)(t.code,{children:`DIVISION`}),` и `,(0,c.jsx)(t.code,{children:`DEPARTMENT`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Обе функции являются преобразователями данных. Они не рисуют HTML и не хранят React state.`}),`
+`,(0,c.jsx)(t.h3,{id:`чего-эти-модули-не-делают`,children:`Чего эти модули не делают`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`table`}),` и `,(0,c.jsx)(t.code,{children:`tree-table`}),` не являются готовыми визуальными компонентами:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`не создают `,(0,c.jsx)(t.code,{children:`<table>`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не применяют CSS;`}),`
+`,(0,c.jsx)(t.li,{children:`не показывают loading, empty и error state;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняют HTTP- или OData-запросы;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не строят `,(0,c.jsx)(t.code,{children:`$filter`}),`, `,(0,c.jsx)(t.code,{children:`$orderby`}),` и URL;`]}),`
+`,(0,c.jsx)(t.li,{children:`не выполняют server-side sorting, filtering, grouping или paging;`}),`
+`,(0,c.jsx)(t.li,{children:`не агрегируют суммы для синтетических узлов дерева;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не сохраняют настройки в `,(0,c.jsx)(t.code,{children:`localStorage`}),` автоматически;`]}),`
+`,(0,c.jsx)(t.li,{children:`не определяют бизнес-правила выбора строк;`}),`
+`,(0,c.jsx)(t.li,{children:`не делают authorization или validation backend-данных.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Используйте правильного владельца:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Задача`}),(0,c.jsx)(t.th,{children:`Владелец`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Типы, state helpers, column metadata`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/table`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Построение структуры дерева`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/tree-table`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Готовые визуальные Table/TreeTable primitives`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-ui/table`}),` и `,(0,c.jsx)(t.code,{children:`/tree-table`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`OData metadata, literals, filters и paths`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata-service`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`HTTP, SAP SSO, X-CSRF, Query operations`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Бизнес-колонки, permissions и row actions`}),(0,c.jsx)(t.td,{children:`entity/feature/widget host-приложения`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`важная-граница-server-side-таблицы`,children:`Важная граница server-side таблицы`}),`
+`,(0,c.jsx)(t.p,{children:`Если строки приходят с backend, источник истины для sorting, filtering, grouping, totals и pagination обычно находится на сервере. Helpers этого модуля не дают оснований включать локальную сортировку поверх одной загруженной страницы.`}),`
+`,(0,c.jsx)(t.p,{children:`Правильная схема для большой таблицы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`пользователь меняет sort/filter/page
+                 │
+                 ▼
+ host строит query params и стабильный query key
+                 │
+                 ▼
+ @ryuzaki13/react-foundation-api/odata
+                 │
+                 ▼
+ backend возвращает новый snapshot строк
+                 │
+                 ▼
+ table helpers очищают только локальный UI state
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.p,{children:`Установите пакет:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-lib
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`table`}),` host должен разрешить совместимые peer dependencies React и TanStack Table:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install react @tanstack/react-table
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Публичные импорты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildTableColumnLayout, pruneTableRowSelection, toggleTableRowSelection } from "@ryuzaki13/react-foundation-lib/table";
+
+import { buildTreeTableRows, transposeFlatRowsToTreeTableRows } from "@ryuzaki13/react-foundation-lib/tree-table";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Типы предпочтительно импортировать через `,(0,c.jsx)(t.code,{children:`import type`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { TableColumnDef, TableColumnSizingState, TableSelectionMode } from "@ryuzaki13/react-foundation-lib/table";
+
+import type { TreeTableBuildResult, TreeTableFlatHierarchy, TreeTableTransposedRow } from "@ryuzaki13/react-foundation-lib/tree-table";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Неверные импорты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Корневой entrypoint пакета не опубликован.
+import { buildTreeTableRows } from "@ryuzaki13/react-foundation-lib";
+
+// Внутреннее расположение файлов не является публичным контрактом.
+import { toggleTableRowSelection } from "@ryuzaki13/react-foundation-lib/dist/table/selection";
+
+// tree-table — отдельный опубликованный subpath.
+import { buildTreeTableRows } from "@ryuzaki13/react-foundation-lib/table";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пакет распространяется как ESM. Используйте `,(0,c.jsx)(t.code,{children:`import`}),`, а не CommonJS `,(0,c.jsx)(t.code,{children:`require`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`совместимость-tanstack-table`,children:`Совместимость TanStack Table`}),`
+`,(0,c.jsxs)(t.p,{children:[`Публичные типы `,(0,c.jsx)(t.code,{children:`TableColumnDef`}),`, `,(0,c.jsx)(t.code,{children:`FoundationTableInstance`}),` и `,(0,c.jsx)(t.code,{children:`foundationTableFeatures`}),` рассчитаны на TanStack Table v9. Host должен использовать совместимую major-версию `,(0,c.jsx)(t.code,{children:`@tanstack/react-table`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не копируйте пример v8 механически: в v9 единый набор features передаётся через свойство `,(0,c.jsx)(t.code,{children:`features`}),`, а основной React hook называется `,(0,c.jsx)(t.code,{children:`useTable`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`что-нужно-знать-перед-началом`,children:`Что нужно знать перед началом`}),`
+`,(0,c.jsx)(t.h3,{id:`строка`,children:`Строка`}),`
+`,(0,c.jsx)(t.p,{children:`Строка — обычный JavaScript-объект:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Employee = {
+	id: string;
+	name: string;
+	departmentId: string | null;
+	salary: number;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Один объект представляет одну запись таблицы.`}),`
+`,(0,c.jsx)(t.h3,{id:`идентификатор-строки`,children:`Идентификатор строки`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`rowId`}),` — стабильная строка, однозначно указывающая на запись:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const getRowId = (row: Employee) => row.id;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Хорошие идентификаторы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`employee:000123
+order:4500000123:item:000010
+folder:/reports/2026
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Плохой идентификатор для изменяемого списка:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const getRowId = (_row: Employee, index: number) => String(index);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Индекс меняется после sorting, filtering, вставки или удаления строки. Из-за этого selection может визуально перейти на другую запись.`}),`
+`,(0,c.jsx)(t.h3,{id:`колонка`,children:`Колонка`}),`
+`,(0,c.jsx)(t.p,{children:`Колонка описывает, какое поле читать и как его представлять:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { TableColumnDef } from "@ryuzaki13/react-foundation-lib/table";
+
+const columns: TableColumnDef<Employee>[] = [
+	{
+		id: "name",
+		accessorKey: "name",
+		header: "Сотрудник"
+	},
+	{
+		id: "salary",
+		accessorKey: "salary",
+		header: "Оклад",
+		meta: { align: "right" }
+	}
+];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`id`}),` нужен state-механизмам. `,(0,c.jsx)(t.code,{children:`accessorKey`}),` говорит TanStack Table, какое поле объекта читать.`]}),`
+`,(0,c.jsx)(t.h3,{id:`идентификатор-колонки`,children:`Идентификатор колонки`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`columnId`}),` связывает несколько независимых состояний:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`columnId "salary"
+  ├─ порядок колонок
+  ├─ ширина
+  ├─ видимость
+  ├─ pinning
+  ├─ выбор ячейки
+  └─ formatting metadata
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`После сохранения пользовательских настроек нельзя без миграции менять `,(0,c.jsx)(t.code,{children:`columnId`}),`: старый layout перестанет находить колонку.`]}),`
+`,(0,c.jsx)(t.h3,{id:`state`,children:`State`}),`
+`,(0,c.jsx)(t.p,{children:`State — данные о текущем состоянии UI. Например:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rowSelection = {
+	"employee:1": true,
+	"employee:2": true
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Здесь ключ — `,(0,c.jsx)(t.code,{children:`rowId`}),`, а `,(0,c.jsx)(t.code,{children:`true`}),` означает активный выбор.`]}),`
+`,(0,c.jsx)(t.h3,{id:`иммутабельность`,children:`Иммутабельность`}),`
+`,(0,c.jsx)(t.p,{children:`Helpers возвращают новый массив или объект. Не изменяйте React state напрямую:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неверно: изменяет существующий state.
+rowSelection[rowId] = true;
+
+// Верно: helper возвращает следующее состояние.
+const nextSelection = toggleTableRowSelection(rowSelection, rowId, "multi");
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`readonly`,children:(0,c.jsx)(t.code,{children:`readonly`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Тип `,(0,c.jsx)(t.code,{children:`readonly string[]`}),` означает, что функция обещает только читать массив. Обычный `,(0,c.jsx)(t.code,{children:`string[]`}),` можно передать туда без преобразования.`]}),`
+`,(0,c.jsx)(t.h3,{id:`generic-параметр`,children:`Generic-параметр`}),`
+`,(0,c.jsxs)(t.p,{children:[`В записи `,(0,c.jsx)(t.code,{children:`TableColumnDef<Employee>`}),` имя `,(0,c.jsx)(t.code,{children:`Employee`}),` сообщает TypeScript форму одной строки. Это позволяет найти опечатку:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const columns: TableColumnDef<Employee>[] = [
+	{
+		// TypeScript обнаружит, что поля "fullName" нет в Employee.
+		accessorKey: "fullName",
+		header: "Имя"
+	}
+];
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`map`,children:(0,c.jsx)(t.code,{children:`Map`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Map<string, Employee>`}),` — быстрый индекс строк по идентификатору:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rowById = new Map(rows.map((row) => [row.id, row]));
+
+const employee = rowById.get("employee:1");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useTableRowSelection`}),` использует такой индекс, чтобы превратить выбранные `,(0,c.jsx)(t.code,{children:`rowId`}),` обратно в исходные объекты.`]}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбрать-нужную-часть-api`,children:`Как выбрать нужную часть API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Нужно`}),(0,c.jsx)(t.th,{children:`API`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Описать типизированные колонки`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableColumnDef`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Создать TanStack Table v9 вручную`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`foundationTableFeatures`}),` и `,(0,c.jsx)(t.code,{children:`FoundationTable*`}),` types`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Восстановить сохранённый порядок`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveTableColumnOrder`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Переставить top-level заголовок`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`reorderTableHeaderColumns`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нормализовать px-ширины`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTableColumnSizing`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Выбрать одну или несколько строк`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toggleTableRowSelection`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Подключить selection к React`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useTableRowSelection`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Выбрать ячейки`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toggleTableCellSelection`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Не перехватывать клик по кнопке в строке`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isTableInteractiveElement`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Создать колонки из OData metadata`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createTableColumnsFromODataMetadata`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Связать строки по `,(0,c.jsx)(t.code,{children:`id/parentId`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildTreeTableRows`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Получить дерево из колонок уровней`}),(0,c.jsxs)(t.td,{children:[`сначала `,(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`}),`, затем `,(0,c.jsx)(t.code,{children:`buildTreeTableRows`})]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`два-вида-исходных-данных-для-дерева`,children:`Два вида исходных данных для дерева`}),`
+`,(0,c.jsx)(t.p,{children:`Первый вид уже содержит связь родитель–ребёнок:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{ id: "company", parentId: null, title: "Компания" },
+	{ id: "sales", parentId: "company", title: "Продажи" }
+];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для него нужен только `,(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Второй вид содержит факты и повторяющиеся названия уровней:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{ division: "Россия", department: "Продажи", amount: 100 },
+	{ division: "Россия", department: "Продажи", amount: 200 },
+	{ division: "Россия", department: "Логистика", amount: 50 }
+];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Здесь нет `,(0,c.jsx)(t.code,{children:`id`}),` и `,(0,c.jsx)(t.code,{children:`parentId`}),`. Сначала используйте `,(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`}),`, чтобы создать синтетические group-узлы, потом `,(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),`, чтобы вложить их друг в друга.`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт-плоская-таблица`,children:`Быстрый старт: плоская таблица`}),`
+`,(0,c.jsx)(t.h3,{id:`1-опишите-строку`,children:`1. Опишите строку`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Order = {
+	id: string;
+	customer: string;
+	amount: number;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`2-опишите-колонки`,children:`2. Опишите колонки`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { TableColumnDef } from "@ryuzaki13/react-foundation-lib/table";
+
+const orderColumns = [
+	{
+		id: "customer",
+		accessorKey: "customer",
+		header: "Клиент",
+		meta: {
+			width: 24,
+			align: "left"
+		}
+	},
+	{
+		id: "amount",
+		accessorKey: "amount",
+		header: "Сумма",
+		meta: {
+			width: 12,
+			align: "right"
+		}
+	}
+] satisfies TableColumnDef<Order>[];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Число `,(0,c.jsx)(t.code,{children:`24`}),` в `,(0,c.jsx)(t.code,{children:`meta.width`}),` означает `,(0,c.jsx)(t.code,{children:`24em`}),`, а не `,(0,c.jsx)(t.code,{children:`24px`}),`. Runtime px-ширины resize хранятся отдельно в `,(0,c.jsx)(t.code,{children:`TableColumnSizingState`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`3-вычислите-selection`,children:`3. Вычислите selection`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { toggleTableRowSelection } from "@ryuzaki13/react-foundation-lib/table";
+import type { RowSelectionState } from "@tanstack/react-table";
+
+let selection: RowSelectionState = {};
+
+selection = toggleTableRowSelection(selection, "order:1", "multi");
+selection = toggleTableRowSelection(selection, "order:2", "multi");
+
+console.log(selection);
+// {
+//   "order:1": true,
+//   "order:2": true
+// }
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`4-передайте-данные-ui-владельцу`,children:`4. Передайте данные UI-владельцу`}),`
+`,(0,c.jsx)(t.p,{children:`Этот lib-модуль не рендерит таблицу. Host может:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`передать `,(0,c.jsx)(t.code,{children:`rows`}),` и `,(0,c.jsx)(t.code,{children:`orderColumns`}),` компоненту из `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-ui/table`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`создать собственную таблицу через `,(0,c.jsx)(t.code,{children:`useTable`}),` и `,(0,c.jsx)(t.code,{children:`foundationTableFeatures`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`использовать только pure helpers в другой UI-реализации.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h2,{id:`быстрый-старт-дерево-с-parentid`,children:[`Быстрый старт: дерево с `,(0,c.jsx)(t.code,{children:`parentId`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildTreeTableRows } from "@ryuzaki13/react-foundation-lib/tree-table";
+
+type Department = {
+	id: string;
+	parentId: string | null;
+	title: string;
+};
+
+const departments: Department[] = [
+	{ id: "sales", parentId: "company", title: "Продажи" },
+	{ id: "company", parentId: null, title: "Компания" },
+	{ id: "retail", parentId: "sales", title: "Розница" }
+];
+
+const result = buildTreeTableRows(departments, {
+	getRowId: (row) => row.id,
+	getParentRowId: (row) => row.parentId
+});
+
+console.log(result.rows);
+// [
+//   {
+//     id: "company",
+//     parentId: null,
+//     title: "Компания",
+//     children: [
+//       {
+//         id: "sales",
+//         parentId: "company",
+//         title: "Продажи",
+//         children: [
+//           { id: "retail", parentId: "sales", title: "Розница" }
+//         ]
+//       }
+//     ]
+//   }
+// ]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Порядок исходных строк не обязан быть «родитель перед ребёнком». Функция сначала строит индексы, а потом дерево.`}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт-дерево-из-аналитических-колонок`,children:`Быстрый старт: дерево из аналитических колонок`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	buildTreeTableRows,
+	transposeFlatRowsToTreeTableRows,
+	TREE_TABLE_TRANSPOSED_PARENT_ROW_ID_FIELD,
+	TREE_TABLE_TRANSPOSED_ROW_ID_FIELD
+} from "@ryuzaki13/react-foundation-lib/tree-table";
+
+type FactRow = {
+	DIVISION: string;
+	DEPARTMENT: string;
+	AMOUNT: number;
+};
+
+const facts: FactRow[] = [
+	{ DIVISION: "Россия", DEPARTMENT: "Продажи", AMOUNT: 100 },
+	{ DIVISION: "Россия", DEPARTMENT: "Продажи", AMOUNT: 200 },
+	{ DIVISION: "Россия", DEPARTMENT: "Логистика", AMOUNT: 50 }
+];
+
+const flatHierarchy = transposeFlatRowsToTreeTableRows(facts, {
+	hierarchyLevels: [{ columnId: "DIVISION" }, { columnId: "DEPARTMENT" }]
+});
+
+const tree = buildTreeTableRows(flatHierarchy, {
+	getRowId: (row) => row[TREE_TABLE_TRANSPOSED_ROW_ID_FIELD],
+	getParentRowId: (row) => row[TREE_TABLE_TRANSPOSED_PARENT_ROW_ID_FIELD]
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`flatHierarchy`}),` содержит и синтетические group-узлы, и исходные факты-листья. `,(0,c.jsx)(t.code,{children:`tree.rows`}),` содержит те же записи уже с вложенным `,(0,c.jsx)(t.code,{children:`children`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`колонки-и-их-metadata`,children:`Колонки и их metadata`}),`
+`,(0,c.jsx)(t.h3,{id:`tablecolumndeftdata-tvalue`,children:(0,c.jsx)(t.code,{children:`TableColumnDef<TData, TValue>`})}),`
+`,(0,c.jsx)(t.p,{children:`Основной тип описания колонки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableColumnDef<TData, TValue = unknown> = /* TanStack ColumnDef */ {
+	meta?: TableColumnMeta;
+};
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`TData`}),` — тип всей строки;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`TValue`}),` — тип значения конкретной колонки;`]}),`
+`,(0,c.jsx)(t.li,{children:`остальные свойства приходят из TanStack Table v9;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`meta`}),` добавляет foundation-настройки.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Пример с `,(0,c.jsx)(t.code,{children:`accessorFn`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Person = {
+	firstName: string;
+	lastName: string;
+};
+
+const fullNameColumn: TableColumnDef<Person, string> = {
+	id: "fullName",
+	accessorFn: (row) => \`\${row.lastName} \${row.firstName}\`,
+	header: "ФИО"
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`accessorFn`}),` задавайте явный `,(0,c.jsx)(t.code,{children:`id`}),`. Иначе OData adapter не сможет устойчиво сопоставить колонку с metadata.`]}),`
+`,(0,c.jsx)(t.h3,{id:`tablecolumnmeta`,children:(0,c.jsx)(t.code,{children:`TableColumnMeta`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface TableColumnMeta {
+	width?: number | "auto" | \`\${number}%\`;
+	align?: "left" | "center" | "right";
+	mergeDuplicates?: boolean;
+	formatting?: TableColumnFormattingMeta;
+}
+`})}),`
+`,(0,c.jsx)(t.h4,{id:`width`,children:(0,c.jsx)(t.code,{children:`width`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Значение`}),(0,c.jsx)(t.th,{children:`Смысл`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`12`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`12em`}),` в декларативной metadata колонки`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"auto"`})}),(0,c.jsx)(t.td,{children:`автоматическая CSS-ширина`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"25%"`})}),(0,c.jsx)(t.td,{children:`процентная CSS-ширина`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это не то же самое, что `,(0,c.jsx)(t.code,{children:`TableColumnSizingState`}),`: sizing state хранит число пикселей, полученное от resize runtime.`]}),`
+`,(0,c.jsx)(t.h4,{id:`align`,children:(0,c.jsx)(t.code,{children:`align`})}),`
+`,(0,c.jsx)(t.p,{children:`Допустимые значения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`left`}),` — обычно текст и dimensions;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`center`}),` — компактный статус или управляющий элемент;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`right`}),` — обычно числа и measures.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Metadata сама не рисует CSS. Визуальный Table primitive должен прочитать значение и применить его.`}),`
+`,(0,c.jsx)(t.h4,{id:`mergeduplicates`,children:(0,c.jsx)(t.code,{children:`mergeDuplicates`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`true`}),` включает display-only объединение подряд идущих одинаковых raw-значений в UI, который поддерживает этот контракт.`]}),`
+`,(0,c.jsx)(t.p,{children:`Важно:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`данные строк не объединяются;`}),`
+`,(0,c.jsx)(t.li,{children:`строки не удаляются;`}),`
+`,(0,c.jsxs)(t.li,{children:[`сравнивается raw-результат accessor или `,(0,c.jsx)(t.code,{children:`cell.getValue()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`одинаковый отформатированный текст не гарантирует merge;`}),`
+`,(0,c.jsx)(t.li,{children:`несоседние одинаковые значения не образуют одну группу;`}),`
+`,(0,c.jsx)(t.li,{children:`tree UI может ограничивать merge границами глубины или ветки.`}),`
+`]}),`
+`,(0,c.jsx)(t.h4,{id:`formatting`,children:(0,c.jsx)(t.code,{children:`formatting`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`formatting`}),` передаёт декларативный runtime-контекст модулю форматтеров. Поле экспериментальное: не стройте вокруг его внутренней формы собственный стабильный storage contract без версионирования.`]}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const amountColumn: TableColumnDef<{ amount: number }> = {
+	id: "amount",
+	accessorKey: "amount",
+	header: "Сумма",
+	meta: {
+		align: "right",
+		formatting: {
+			role: "measure",
+			type: "decimal",
+			emptyWhenZero: true,
+			overflowTooltip: true
+		}
+	}
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Полный смысл pipeline, formulas, `,(0,c.jsx)(t.code,{children:`emptyWhenZero`}),` и value state описан в справочнике `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`helpers-чтения-metadata`,children:`Helpers чтения metadata`}),`
+`,(0,c.jsx)(t.h4,{id:`gettablecolumnmeta`,children:(0,c.jsx)(t.code,{children:`getTableColumnMeta`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const meta = getTableColumnMeta(column);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`column.meta`}),` или `,(0,c.jsx)(t.code,{children:`undefined`}),`. Helper полезен общему UI-коду: consumer не привязывается к внутреннему пересечению TanStack-типа.`]}),`
+`,(0,c.jsx)(t.h4,{id:`gettablecolumnformattingmeta`,children:(0,c.jsx)(t.code,{children:`getTableColumnFormattingMeta`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const formatting = getTableColumnFormattingMeta(column);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`column.meta?.formatting`}),` или `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Функции ничего не клонируют. Возвращаемый объект — та же ссылка, которая находится в column definition. Не мутируйте её.`}),`
+`,(0,c.jsx)(t.h2,{id:`foundation-features-tanstack-table`,children:`Foundation features TanStack Table`}),`
+`,(0,c.jsx)(t.h3,{id:`зачем-нужен-единый-набор`,children:`Зачем нужен единый набор`}),`
+`,(0,c.jsx)(t.p,{children:`TanStack Table v9 кодирует enabled features в generic-типах. Если UI создаёт table с одним набором features, а тип колонки объявлен с другим, TypeScript может показать несовместимые типы.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`foundationTableFeatures`}),` задаёт единый набор для lib- и UI-пакетов.`]}),`
+`,(0,c.jsx)(t.p,{children:`В набор входят:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`column ordering;`}),`
+`,(0,c.jsx)(t.li,{children:`column pinning;`}),`
+`,(0,c.jsx)(t.li,{children:`column sizing;`}),`
+`,(0,c.jsx)(t.li,{children:`column resizing;`}),`
+`,(0,c.jsx)(t.li,{children:`column visibility;`}),`
+`,(0,c.jsx)(t.li,{children:`row selection;`}),`
+`,(0,c.jsx)(t.li,{children:`row expanding;`}),`
+`,(0,c.jsx)(t.li,{children:`expanded row model.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`минимальная-ручная-интеграция`,children:`Минимальная ручная интеграция`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useMemo } from "react";
+
+import { foundationTableFeatures, type TableColumnDef } from "@ryuzaki13/react-foundation-lib/table";
+import { useTable } from "@tanstack/react-table";
+
+type Row = {
+	id: string;
+	name: string;
+};
+
+function Example({ data }: { data: readonly Row[] }) {
+	const columns = useMemo<TableColumnDef<Row>[]>(
+		() => [
+			{
+				id: "name",
+				accessorKey: "name",
+				header: "Название"
+			}
+		],
+		[]
+	);
+
+	const table = useTable({
+		features: foundationTableFeatures,
+		data: data as Row[],
+		columns,
+		getRowId: (row) => row.id
+	});
+
+	return <div>Строк: {table.getRowModel().rows.length}</div>;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пример показывает создание instance, а не полноценный доступный UI. Для рендера нужны `,(0,c.jsx)(t.code,{children:`<table>`}),`, headers, cells, keyboard behavior, loading/error states и стили.`]}),`
+`,(0,c.jsx)(t.h3,{id:`публичные-типы-instance`,children:`Публичные типы instance`}),`
+`,(0,c.jsx)(t.p,{children:`Используйте foundation-типы там, где helper или компонент принимает объекты TanStack Table:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type {
+	FoundationTableCell,
+	FoundationTableColumn,
+	FoundationTableHeader,
+	FoundationTableInstance,
+	FoundationTableRow,
+	FoundationTableState
+} from "@ryuzaki13/react-foundation-lib/table";
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Тип`}),(0,c.jsx)(t.th,{children:`Что представляет`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableInstance<TData>`})}),(0,c.jsx)(t.td,{children:`весь table instance`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableRow<TData>`})}),(0,c.jsx)(t.td,{children:`вычисленную строку TanStack`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableColumn<TData, TValue>`})}),(0,c.jsx)(t.td,{children:`runtime-колонку`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableCell<TData, TValue>`})}),(0,c.jsx)(t.td,{children:`runtime-ячейку`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableHeader<TData, TValue>`})}),(0,c.jsx)(t.td,{children:`runtime-заголовок`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableState`})}),(0,c.jsx)(t.td,{children:`полное состояние enabled features`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableFeatures`})}),(0,c.jsxs)(t.td,{children:[`тип объекта `,(0,c.jsx)(t.code,{children:`foundationTableFeatures`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Не создавайте эти объекты вручную. Их создаёт TanStack Table.`}),`
+`,(0,c.jsx)(t.h2,{id:`порядок-и-layout-колонок`,children:`Порядок и layout колонок`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetablecolumnorder`,children:(0,c.jsx)(t.code,{children:`normalizeTableColumnOrder`})}),`
+`,(0,c.jsx)(t.p,{children:`Очищает массив идентификаторов:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { normalizeTableColumnOrder } from "@ryuzaki13/react-foundation-lib/table";
+
+normalizeTableColumnOrder(["name", "", "amount", "name"]);
+// ["name", "amount"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`undefined`}),` превращается в `,(0,c.jsx)(t.code,{children:`[]`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`строки, у которых `,(0,c.jsx)(t.code,{children:`trim()`}),` пуст, удаляются;`]}),`
+`,(0,c.jsx)(t.li,{children:`повторения удаляются;`}),`
+`,(0,c.jsx)(t.li,{children:`сохраняется первое вхождение;`}),`
+`,(0,c.jsx)(t.li,{children:`непустая строка возвращается как есть и не обрезается.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Последний пункт важен:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTableColumnOrder([" name "]);
+// [" name "], а не ["name"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper проверяет пустоту, но не исправляет идентификаторы. Используйте канонические `,(0,c.jsx)(t.code,{children:`columnId`}),` ещё при создании колонок.`]}),`
+`,(0,c.jsx)(t.h3,{id:`resolvetablecolumnorder`,children:(0,c.jsx)(t.code,{children:`resolveTableColumnOrder`})}),`
+`,(0,c.jsx)(t.p,{children:`Сопоставляет сохранённый порядок с актуальными колонками:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { resolveTableColumnOrder } from "@ryuzaki13/react-foundation-lib/table";
+
+resolveTableColumnOrder({
+	ids: ["name", "status", "amount", "createdAt"],
+	order: ["amount", "name", "removed", "amount"]
+});
+// ["amount", "name", "status", "createdAt"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Берёт только значения из `,(0,c.jsx)(t.code,{children:`order`}),`, существующие в `,(0,c.jsx)(t.code,{children:`ids`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Удаляет их повторения.`}),`
+`,(0,c.jsx)(t.li,{children:`Сохраняет их относительный порядок.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Добавляет отсутствующие актуальные `,(0,c.jsx)(t.code,{children:`ids`}),` в конец в порядке `,(0,c.jsx)(t.code,{children:`ids`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это основной helper восстановления сохранённого layout после добавления или удаления колонок в новой версии приложения.`}),`
+`,(0,c.jsxs)(t.h3,{id:`отличие-normalize-от-resolve`,children:[`Отличие `,(0,c.jsx)(t.code,{children:`normalize`}),` от `,(0,c.jsx)(t.code,{children:`resolve`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`normalizeTableColumnOrder
+  знает только сам массив order
+  не знает существующие колонки
+
+resolveTableColumnOrder
+  знает актуальные ids
+  удаляет неизвестные и добавляет новые
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для persisted configuration обычно нужен `,(0,c.jsx)(t.code,{children:`resolveTableColumnOrder`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildtablecolumnlayout`,children:(0,c.jsx)(t.code,{children:`buildTableColumnLayout`})}),`
+`,(0,c.jsx)(t.p,{children:`Соединяет уже вычисленный порядок с шириной каждой колонки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildTableColumnLayout } from "@ryuzaki13/react-foundation-lib/table";
+
+const widths = {
+	name: 240,
+	status: 120,
+	amount: 160
+};
+
+const layout = buildTableColumnLayout({
+	ids: ["amount", "name", "status"],
+	getWidth: (id) => widths[id]
+});
+
+// [
+//   { id: "amount", width: 160 },
+//   { id: "name", width: 240 },
+//   { id: "status", width: 120 }
+// ]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Ширина вычисляется по `,(0,c.jsx)(t.code,{children:`id`}),`, а не по визуальному индексу. Поэтому после reorder ширина остаётся у правильной колонки.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`TWidth`}),` generic и может быть не только числом:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const layout = buildTableColumnLayout({
+	ids: ["name", "amount"] as const,
+	getWidth: (id) => (id === "name" ? "2fr" : "10rem")
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция вызывает `,(0,c.jsx)(t.code,{children:`getWidth`}),` один раз для каждого `,(0,c.jsx)(t.code,{children:`id`}),` и не проверяет результат.`]}),`
+`,(0,c.jsx)(t.h2,{id:`drag-and-drop-перестановка-колонок`,children:`Drag-and-drop перестановка колонок`}),`
+`,(0,c.jsx)(t.h3,{id:`термины`,children:`Термины`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`activeId`}),` — колонка, которую пользователь тащит;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`overId`}),` — колонка, над которой находится dragged item;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`headerIds`}),` — только draggable top-level headers;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`lockedIds`}),` — полностью заблокированные колонки;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`pinnedIds`}),` — закреплённые колонки;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`order`}),` — текущий полный порядок.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`reordertableheadercolumns`,children:(0,c.jsx)(t.code,{children:`reorderTableHeaderColumns`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { reorderTableHeaderColumns } from "@ryuzaki13/react-foundation-lib/table";
+
+const nextOrder = reorderTableHeaderColumns({
+	order: ["select", "name", "status", "amount"],
+	headerIds: ["select", "name", "status", "amount"],
+	lockedIds: ["select"],
+	pinnedIds: ["select"],
+	activeId: "amount",
+	overId: "name"
+});
+
+// ["select", "amount", "name", "status"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция возвращает новый массив и не мутирует `,(0,c.jsx)(t.code,{children:`order`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Перестановка блокируется, если:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`activeId`}),` или `,(0,c.jsx)(t.code,{children:`overId`}),` пуст;`]}),`
+`,(0,c.jsx)(t.li,{children:`идентификаторы одинаковы;`}),`
+`,(0,c.jsxs)(t.li,{children:[`хотя бы одного id нет в `,(0,c.jsx)(t.code,{children:`headerIds`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`activeId`}),` или `,(0,c.jsx)(t.code,{children:`overId`}),` входит в `,(0,c.jsx)(t.code,{children:`lockedIds`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`activeId`}),` или `,(0,c.jsx)(t.code,{children:`overId`}),` входит в `,(0,c.jsx)(t.code,{children:`pinnedIds`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Текущее правило pinning строгое: pinned-колонки не переставляются даже внутри pinned-зоны, и обычную колонку нельзя drop-нуть на pinned-колонку.`}),`
+`,(0,c.jsx)(t.h3,{id:`grouped-headers`,children:`Grouped headers`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для grouped columns в `,(0,c.jsx)(t.code,{children:`headerIds`}),` передавайте идентификаторы верхнего уровня:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`CONTACTS              AMOUNT
+├─ PHONE
+└─ EMAIL
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`headerIds`}),` равен `,(0,c.jsx)(t.code,{children:`['CONTACTS', 'AMOUNT']`}),`, группа `,(0,c.jsx)(t.code,{children:`CONTACTS`}),` двигается целиком. `,(0,c.jsx)(t.code,{children:`PHONE`}),` и `,(0,c.jsx)(t.code,{children:`EMAIL`}),` нельзя переставить этим helper отдельно.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`отсутствующий-id-в-order`,children:[`Отсутствующий id в `,(0,c.jsx)(t.code,{children:`order`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`activeId`}),` или `,(0,c.jsx)(t.code,{children:`overId`}),` разрешён через `,(0,c.jsx)(t.code,{children:`headerIds`}),`, но отсутствует в `,(0,c.jsx)(t.code,{children:`order`}),`, helper сначала добавит его в конец и затем выполнит перемещение.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычно перед DnD лучше сначала получить полный порядок через `,(0,c.jsx)(t.code,{children:`resolveTableColumnOrder`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`resolvereorderedtableheadercolumns`,children:(0,c.jsx)(t.code,{children:`resolveReorderedTableHeaderColumns`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`новый `,(0,c.jsx)(t.code,{children:`string[]`}),`, если порядок изменился;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),`, если реального изменения нет.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const change = resolveReorderedTableHeaderColumns({
+	order: ["name", "amount"],
+	headerIds: ["name", "amount"],
+	activeId: "name",
+	overId: "name"
+});
+
+console.log(change); // null
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Этот вариант удобен для event handler:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const nextOrder = resolveReorderedTableHeaderColumns(args);
+
+if (nextOrder) {
+	onColumnOrderChange(nextOrder);
+}
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`ширины-колонок`,children:`Ширины колонок`}),`
+`,(0,c.jsx)(t.h3,{id:`два-разных-представления-ширины`,children:`Два разных представления ширины`}),`
+`,(0,c.jsx)(t.p,{children:`Не смешивайте:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Представление`}),(0,c.jsx)(t.th,{children:`Пример`}),(0,c.jsx)(t.th,{children:`Единица`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableColumnMeta.width`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`12`}),`, `,(0,c.jsx)(t.code,{children:`"auto"`}),`, `,(0,c.jsx)(t.code,{children:`"25%"`})]}),(0,c.jsxs)(t.td,{children:[`число означает `,(0,c.jsx)(t.code,{children:`em`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableColumnSizingState`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ amount: 160 }`})}),(0,c.jsx)(t.td,{children:`число означает px`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Helpers этого раздела работают со вторым представлением — px sizing state.`}),`
+`,(0,c.jsx)(t.h3,{id:`default_table_column_min_width`,children:(0,c.jsx)(t.code,{children:`DEFAULT_TABLE_COLUMN_MIN_WIDTH`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`DEFAULT_TABLE_COLUMN_MIN_WIDTH === 60;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Значение используется по умолчанию как минимальная ширина в пикселях.`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetablecolumnwidth`,children:(0,c.jsx)(t.code,{children:`normalizeTableColumnWidth`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTableColumnWidth(125.8); // 125
+normalizeTableColumnWidth(12); // 60
+normalizeTableColumnWidth(Number.NaN, 80); // 80
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Проверяет `,(0,c.jsx)(t.code,{children:`minWidth`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если minimum не finite или не больше нуля, использует `,(0,c.jsx)(t.code,{children:`60`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Округляет вниз через `,(0,c.jsx)(t.code,{children:`Math.floor`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Невалидную ширину заменяет minimum.`}),`
+`,(0,c.jsx)(t.li,{children:`Возвращает максимум из minimum и ширины.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Примеры minimum:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTableColumnWidth(140.9, 100.9); // 140, minimum станет 100
+normalizeTableColumnWidth(10, -1); // 60
+normalizeTableColumnWidth(10, Number.POSITIVE_INFINITY); // 60
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetablecolumnsizing`,children:(0,c.jsx)(t.code,{children:`normalizeTableColumnSizing`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTableColumnSizing({
+	name: 240.7,
+	amount: 10,
+	broken: Number.NaN,
+	"": 90
+});
+
+// {
+//   name: 240,
+//   amount: 60
+// }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`принимает `,(0,c.jsx)(t.code,{children:`undefined`}),` и возвращает `,(0,c.jsx)(t.code,{children:`{}`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`удаляет пустой `,(0,c.jsx)(t.code,{children:`columnId`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`удаляет не-finite width;`}),`
+`,(0,c.jsx)(t.li,{children:`нормализует каждую оставшуюся ширину;`}),`
+`,(0,c.jsx)(t.li,{children:`возвращает новый объект.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Непустой `,(0,c.jsx)(t.code,{children:`columnId`}),` не обрезается. Ключ `,(0,c.jsx)(t.code,{children:`" name "`}),` останется `,(0,c.jsx)(t.code,{children:`" name "`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`patchtablecolumnwidth`,children:(0,c.jsx)(t.code,{children:`patchTableColumnWidth`})}),`
+`,(0,c.jsx)(t.p,{children:`Добавляет или заменяет одну ширину, попутно нормализуя весь state:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const next = patchTableColumnWidth({ name: 200, broken: Number.NaN }, "amount", 150.8);
+
+// { name: 200, amount: 150 }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`columnId.trim()`}),` пуст, новая запись не добавляется, но существующий state всё равно нормализуется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`removetablecolumnwidth`,children:(0,c.jsx)(t.code,{children:`removeTableColumnWidth`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`removeTableColumnWidth({ name: 200, amount: 150 }, "name");
+// { amount: 150 }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция только копирует все ключи, кроме точного `,(0,c.jsx)(t.code,{children:`columnId`}),`. Она не нормализует оставшиеся значения.`]}),`
+`,(0,c.jsx)(t.h2,{id:`видимость-колонок`,children:`Видимость колонок`}),`
+`,(0,c.jsx)(t.h3,{id:`tablecolumnvisibilitystate`,children:(0,c.jsx)(t.code,{children:`TableColumnVisibilityState`})}),`
+`,(0,c.jsx)(t.p,{children:`Это публичное имя состояния TanStack Table v9:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableColumnVisibilityState = Record<string, boolean>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Ключ — стабильный `,(0,c.jsx)(t.code,{children:`columnId`}),`, значение — видимость:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const visibility: TableColumnVisibilityState = {
+	name: true,
+	technicalCode: false,
+	amount: true
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`false`}),` скрывает колонку, но не удаляет её definition и данные строки. Поэтому колонку можно снова показать без повторного создания `,(0,c.jsx)(t.code,{children:`columns`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не фильтруйте массив column definitions вручную, если UI поддерживает controlled visibility state: удалённая definition перестаёт участвовать и в настройках, и в поиске по `,(0,c.jsx)(t.code,{children:`columnId`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не содержит общего toggle-helper для visibility. Передавайте state TanStack Table или visual primitive. Стартовую карту по OData metadata создаёт `,(0,c.jsx)(t.code,{children:`createTableColumnVisibilityFromODataMetadata`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`выбор-строк`,children:`Выбор строк`}),`
+`,(0,c.jsx)(t.h3,{id:`tableselectionmode`,children:(0,c.jsx)(t.code,{children:`TableSelectionMode`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableSelectionMode = "none" | "single" | "multi";
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Режим`}),(0,c.jsx)(t.th,{children:`Поведение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`none`})}),(0,c.jsx)(t.td,{children:`выбор запрещён, state очищается`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`single`})}),(0,c.jsx)(t.td,{children:`может быть выбрана ровно одна строка`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`multi`})}),(0,c.jsx)(t.td,{children:`строки независимо включаются и выключаются`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`rowselectionstate`,children:(0,c.jsx)(t.code,{children:`RowSelectionState`})}),`
+`,(0,c.jsx)(t.p,{children:`Тип принадлежит TanStack Table:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { RowSelectionState } from "@tanstack/react-table";
+
+const selection: RowSelectionState = {
+	"row:1": true,
+	"row:2": true
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В TanStack Table v9 typed state хранит только активные ключи со значением `,(0,c.jsx)(t.code,{children:`true`}),`. Для снятого выбора ключ нужно удалить, а не записывать `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Pure helpers дополнительно проверяют truthiness и поэтому защитно игнорируют false-ключ, если он всё же пришёл из legacy JSON или нетипизированного JavaScript. Но новый TypeScript-код не должен создавать такой shape.`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetableselectionmode`,children:(0,c.jsx)(t.code,{children:`normalizeTableSelectionMode`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализует недоверенное значение на config-boundary:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTableSelectionMode("multi"); // "multi"
+normalizeTableSelectionMode("unknown"); // "none"
+normalizeTableSelectionMode(null, "single"); // "single"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Fallback по умолчанию — `,(0,c.jsx)(t.code,{children:`none`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Используйте helper при чтении JSON, storage или URL config. Внутренний typed state уже должен содержать корректный union.`}),`
+`,(0,c.jsx)(t.h3,{id:`aretablerowselectionsequal`,children:(0,c.jsx)(t.code,{children:`areTableRowSelectionsEqual`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сравнивает наборы активных `,(0,c.jsx)(t.code,{children:`rowId`}),` без учёта порядка ключей:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`areTableRowSelectionsEqual({ a: true, b: true }, { b: true, a: true }); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция не сравнивает ссылки объектов. Если нетипизированный runtime object содержит false-ключи, они не участвуют в сравнении.`}),`
+`,(0,c.jsx)(t.h3,{id:`prunetablerowselection`,children:(0,c.jsx)(t.code,{children:`pruneTableRowSelection`})}),`
+`,(0,c.jsx)(t.p,{children:`Оставляет только выбор, допустимый для текущего набора данных и режима:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const next = pruneTableRowSelection({ a: true, b: true, removed: true }, ["a", "b"], "single");
+
+// { b: true }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`none`}),` всегда возвращает `,(0,c.jsx)(t.code,{children:`{}`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`отсутствующие в `,(0,c.jsx)(t.code,{children:`availableRowIds`}),` id удаляются;`]}),`
+`,(0,c.jsx)(t.li,{children:`false-ключи из нетипизированного/legacy input удаляются;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`multi`}),` сохраняет все доступные активные id;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`single`}),` сохраняет последний активный id после фильтрации.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`single`}),` «последний» определяется порядком активных ключей `,(0,c.jsx)(t.code,{children:`Object.keys(selection)`}),`, а не порядком `,(0,c.jsx)(t.code,{children:`availableRowIds`}),`. Не используйте object key order как историю пользовательских кликов. Нормальный источник single state — `,(0,c.jsx)(t.code,{children:`toggleTableRowSelection`}),`, который сам оставляет один ключ.`]}),`
+`,(0,c.jsx)(t.h3,{id:`toggletablerowselection`,children:(0,c.jsx)(t.code,{children:`toggleTableRowSelection`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`toggleTableRowSelection({}, "a", "none");
+// {}
+
+toggleTableRowSelection({ a: true }, "b", "single");
+// { b: true }
+
+toggleTableRowSelection({ a: true }, "a", "single");
+// та же логическая выборка { a: true }
+
+toggleTableRowSelection({ a: true }, "b", "multi");
+// { a: true, b: true }
+
+toggleTableRowSelection({ a: true, b: true }, "b", "multi");
+// { a: true }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ключевое различие:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`в `,(0,c.jsx)(t.code,{children:`single`}),` повторная активация выбранной строки `,(0,c.jsx)(t.strong,{children:`не снимает`}),` выбор;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`в `,(0,c.jsx)(t.code,{children:`multi`}),` повторная активация работает как toggle.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper не проверяет, существует ли `,(0,c.jsx)(t.code,{children:`rowId`}),`. Если это важно, сначала проверьте membership или используйте `,(0,c.jsx)(t.code,{children:`pruneTableRowSelection`}),` на границе данных.`]}),`
+`,(0,c.jsx)(t.h3,{id:`selection-и-пагинация`,children:`Selection и пагинация`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`availableRowIds`}),` должен отражать область, внутри которой selection считается допустимым.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если передать только id текущей страницы, selection с других страниц будет удалён. Это правильно для «выбор только среди загруженных строк», но неправильно для cross-page selection.`}),`
+`,(0,c.jsx)(t.p,{children:`Для cross-page сценария нужен отдельный domain contract:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`полный набор известных id;`}),`
+`,(0,c.jsx)(t.li,{children:`selection-модель «все кроме исключений»;`}),`
+`,(0,c.jsx)(t.li,{children:`server-side selection token;`}),`
+`,(0,c.jsx)(t.li,{children:`или бизнес-store владельца feature.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не пытайтесь представить миллион выбранных server rows обычным объектом TanStack Table.`}),`
+`,(0,c.jsxs)(t.h2,{id:`hook-usetablerowselection`,children:[`Hook `,(0,c.jsx)(t.code,{children:`useTableRowSelection`})]}),`
+`,(0,c.jsx)(t.h3,{id:`назначение`,children:`Назначение`}),`
+`,(0,c.jsx)(t.p,{children:`Hook связывает pure selection helpers с React state:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`availableRowIds + rowById + mode
+                │
+                ▼
+       useTableRowSelection
+       /        │          \\
+rowSelection  setter  activateRowSelection
+                │
+                ▼
+       onRowSelectionChange(rows)
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`параметры`,children:`Параметры`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`useTableRowSelection<TData>({
+	availableRowIds,
+	rowById,
+	selectionMode,
+	selectedRowIds,
+	onRowSelectionChange
+});
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Параметр`}),(0,c.jsx)(t.th,{children:`Тип`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`availableRowIds`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readonly string[]`})}),(0,c.jsx)(t.td,{children:`id строк, которые сейчас допустимы`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rowById`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Map<string, TData>`})}),(0,c.jsx)(t.td,{children:`индекс исходных объектов`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`selectionMode`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableSelectionMode`})}),(0,c.jsx)(t.td,{children:`cardinality выбора`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`selectedRowIds`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`readonly string[]`}),` или `,(0,c.jsx)(t.code,{children:`undefined`})]}),(0,c.jsx)(t.td,{children:`внешний controlled snapshot`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`onRowSelectionChange`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`(rows: TData[]) => void`})}),(0,c.jsx)(t.td,{children:`callback с исходными выбранными строками`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Тип объекта параметров намеренно не экспортируется отдельным именем. Используйте сигнатуру функции, а не private deep import.`}),`
+`,(0,c.jsx)(t.h3,{id:`результат`,children:`Результат`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const { rowSelection, setRowSelection, activateRowSelection } = useTableRowSelection({
+	availableRowIds,
+	rowById,
+	selectionMode
+});
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Поле`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rowSelection`})}),(0,c.jsxs)(t.td,{children:[`текущее TanStack `,(0,c.jsx)(t.code,{children:`RowSelectionState`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`setRowSelection`})}),(0,c.jsx)(t.td,{children:`React setter для низкоуровневой интеграции`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`activateRowSelection(rowId, canSelect)`})}),(0,c.jsx)(t.td,{children:`безопасная пользовательская активация строки`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`полный-пример`,children:`Полный пример`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useMemo } from "react";
+
+import {
+	foundationTableFeatures,
+	useTableRowSelection,
+	type TableColumnDef,
+	type TableSelectionMode
+} from "@ryuzaki13/react-foundation-lib/table";
+import { useTable } from "@tanstack/react-table";
+
+type Employee = {
+	id: string;
+	name: string;
+	disabled: boolean;
+};
+
+type Props = {
+	rows: readonly Employee[];
+	columns: TableColumnDef<Employee>[];
+	selectionMode: TableSelectionMode;
+	onSelectionChange: (rows: Employee[]) => void;
+};
+
+function EmployeeTableModel({ rows, columns, selectionMode, onSelectionChange }: Props) {
+	const rowById = useMemo(() => new Map(rows.map((row) => [row.id, row])), [rows]);
+	const availableRowIds = useMemo(() => Array.from(rowById.keys()), [rowById]);
+
+	const { rowSelection, activateRowSelection } = useTableRowSelection({
+		availableRowIds,
+		rowById,
+		selectionMode,
+		onRowSelectionChange: onSelectionChange
+	});
+
+	const table = useTable({
+		features: foundationTableFeatures,
+		data: rows as Employee[],
+		columns,
+		state: { rowSelection },
+		getRowId: (row) => row.id,
+		enableMultiRowSelection: selectionMode === "multi",
+		enableRowSelection: (row) => selectionMode !== "none" && !row.original.disabled
+	});
+
+	return {
+		table,
+		activateRow: (rowId: string) => {
+			const row = rowById.get(rowId);
+			activateRowSelection(rowId, Boolean(row && !row.disabled));
+		}
+	};
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`В реальном компоненте custom hook должен вызываться на верхнем уровне React component или другого custom hook. Не вызывайте его в условии, цикле или обработчике события.`}),`
+`,(0,c.jsx)(t.h3,{id:`canselect`,children:(0,c.jsx)(t.code,{children:`canSelect`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`activateRowSelection(rowId, false)`}),` ничего не меняет. Это позволяет держать business permission вне общего helper:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const canSelect = employee.status !== "archived";
+
+activateRowSelection(employee.id, canSelect);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`controlled-selection`,children:`Controlled selection`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`selectedRowIds`}),` передан, hook синхронизирует внутренний визуальный state с внешним snapshot и применяет:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`availableRowIds`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`текущий `,(0,c.jsx)(t.code,{children:`selectionMode`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`удаление неизвестных id;`}),`
+`,(0,c.jsx)(t.li,{children:`single/multi cardinality.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const [selectedIds, setSelectedIds] = useState<string[]>([]);
+
+const selection = useTableRowSelection({
+	availableRowIds,
+	rowById,
+	selectionMode: "multi",
+	selectedRowIds: selectedIds,
+	onRowSelectionChange: (rows) => {
+		setSelectedIds(rows.map((row) => row.id));
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Внешний owner должен передавать новый snapshot после принятого пользовательского изменения. Не мутируйте `,(0,c.jsx)(t.code,{children:`selectedIds`}),` на месте.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-нужен-стабильный-rowbyid`,children:[`Почему нужен стабильный `,(0,c.jsx)(t.code,{children:`rowById`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Hook преобразует selection id в исходные строки для callback. Если id есть в state, но нет в `,(0,c.jsx)(t.code,{children:`rowById`}),`, такая запись не попадёт в callback.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Создавайте map через `,(0,c.jsx)(t.code,{children:`useMemo`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rowById = useMemo(() => new Map(rows.map((row) => [row.id, row])), [rows]);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не создавайте новую `,(0,c.jsx)(t.code,{children:`Map`}),` и новый `,(0,c.jsx)(t.code,{children:`availableRowIds`}),` без необходимости при каждом render большого компонента.`]}),`
+`,(0,c.jsx)(t.h3,{id:`низкоуровневый-setter`,children:`Низкоуровневый setter`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`setRowSelection`}),` нужен для интеграции с API TanStack Table. Если установить произвольный state, hook позже очистит его при изменении `,(0,c.jsx)(t.code,{children:`availableRowIds`}),`, `,(0,c.jsx)(t.code,{children:`selectedRowIds`}),` или mode.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для обычной активации строки предпочитайте `,(0,c.jsx)(t.code,{children:`activateRowSelection`}),`: он соблюдает `,(0,c.jsx)(t.code,{children:`selectionMode`}),` и `,(0,c.jsx)(t.code,{children:`canSelect`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`выбор-ячеек`,children:`Выбор ячеек`}),`
+`,(0,c.jsx)(t.h3,{id:`координаты`,children:`Координаты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableCellCoordinates = Readonly<{
+	rowId: string;
+	columnId: string;
+}>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ячейка определяется не DOM-элементом и не индексами, а двумя стабильными id:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const cell = {
+	rowId: "order:4500000123",
+	columnId: "amount"
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это позволяет сохранять selection после reorder колонок.`}),`
+`,(0,c.jsx)(t.h3,{id:`tablecellselectionstate`,children:(0,c.jsx)(t.code,{children:`TableCellSelectionState`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableCellSelectionState = readonly TableCellCoordinates[];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Массив сериализуем и не зависит от TanStack runtime objects.`}),`
+`,(0,c.jsx)(t.h3,{id:`tablecellselectionmode`,children:(0,c.jsx)(t.code,{children:`TableCellSelectionMode`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Использует те же значения `,(0,c.jsx)(t.code,{children:`none | single | multi`}),`, но отдельное имя показывает, что настройка относится к ячейкам, а не строкам.`]}),`
+`,(0,c.jsx)(t.h3,{id:`aretablecellselectionsequal`,children:(0,c.jsx)(t.code,{children:`areTableCellSelectionsEqual`})}),`
+`,(0,c.jsx)(t.p,{children:`Сравнивает наборы координат без учёта порядка:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const a = { rowId: "1", columnId: "name" };
+const b = { rowId: "2", columnId: "amount" };
+
+areTableCellSelectionsEqual([a, b], [b, a]); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Повторы не влияют на множество:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`areTableCellSelectionsEqual([a, a], [a]); // true
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Внутренний ключ кодирует `,(0,c.jsx)(t.code,{children:`rowId`}),` и `,(0,c.jsx)(t.code,{children:`columnId`}),` через `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),`, поэтому значения с `,(0,c.jsx)(t.code,{children:`::`}),`, `,(0,c.jsx)(t.code,{children:`/`}),`, пробелами и другими символами не создают простую delimiter-коллизию.`]}),`
+`,(0,c.jsx)(t.h3,{id:`prunetablecellselection`,children:(0,c.jsx)(t.code,{children:`pruneTableCellSelection`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const next = pruneTableCellSelection(
+	[
+		{ rowId: "row-2", columnId: "B" },
+		{ rowId: "row-1", columnId: "B" },
+		{ rowId: "row-1", columnId: "A" },
+		{ rowId: "row-1", columnId: "A" }
+	],
+	["row-1", "row-2"],
+	["A", "B"],
+	"multi"
+);
+
+// [
+//   { rowId: "row-1", columnId: "A" },
+//   { rowId: "row-1", columnId: "B" },
+//   { rowId: "row-2", columnId: "B" }
+// ]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Удаляет координаты неизвестной строки или колонки.`}),`
+`,(0,c.jsx)(t.li,{children:`Удаляет повторы.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Сортирует по порядку `,(0,c.jsx)(t.code,{children:`availableRowIds`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Внутри строки сортирует по `,(0,c.jsx)(t.code,{children:`availableColumnIds`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Для `,(0,c.jsx)(t.code,{children:`single`}),` оставляет последнюю координату из этого детерминированного порядка.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Для `,(0,c.jsx)(t.code,{children:`none`}),` возвращает `,(0,c.jsx)(t.code,{children:`[]`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Input не мутируется.`}),`
+`,(0,c.jsx)(t.p,{children:`В отличие от row selection, здесь single-координата определяется актуальным визуальным порядком строк и колонок.`}),`
+`,(0,c.jsx)(t.h3,{id:`toggletablecellselection`,children:(0,c.jsx)(t.code,{children:`toggleTableCellSelection`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const first = { rowId: "row-1", columnId: "A" };
+const second = { rowId: "row-1", columnId: "B" };
+
+toggleTableCellSelection([first], first, "single");
+// []
+
+toggleTableCellSelection([first], second, "single");
+// [second]
+
+toggleTableCellSelection([first], second, "multi");
+// [first, second]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Важное отличие от выбора строк: повторная активация выбранной ячейки в `,(0,c.jsx)(t.code,{children:`single`}),` `,(0,c.jsx)(t.strong,{children:`снимает`}),` выбор.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`toggleTableCellSelection`}),` не проверяет доступные строки и колонки. Для очистки stale coordinates используйте `,(0,c.jsx)(t.code,{children:`pruneTableCellSelection`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`activation-mode`,children:`Activation mode`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableCellSelectionActivationMode = "direct" | "primary-modifier";
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Режим`}),(0,c.jsx)(t.th,{children:`Когда выбирать ячейку`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`direct`})}),(0,c.jsx)(t.td,{children:`при обычной активации`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`primary-modifier`})}),(0,c.jsx)(t.td,{children:`только с Ctrl в Windows/Linux или Command в macOS`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetablecellselectionactivationmode`,children:(0,c.jsx)(t.code,{children:`normalizeTableCellSelectionActivationMode`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTableCellSelectionActivationMode("primary-modifier");
+// "primary-modifier"
+
+normalizeTableCellSelectionActivationMode("meta");
+// "direct"
+
+normalizeTableCellSelectionActivationMode(null, "primary-modifier");
+// "primary-modifier"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`shouldactivatetablecellselection`,children:(0,c.jsx)(t.code,{children:`shouldActivateTableCellSelection`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция принимает минимальный event-like объект:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableSelectionModifierEvent = Readonly<{
+	ctrlKey: boolean;
+	metaKey: boolean;
+	shiftKey: boolean;
+	altKey: boolean;
+}>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Поэтому можно передать React MouseEvent или KeyboardEvent: у них есть эти поля.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function handleCellClick(event: React.MouseEvent, cell: TableCellCoordinates) {
+	if (!shouldActivateTableCellSelection(event, "primary-modifier")) {
+		return;
+	}
+
+	setSelection((current) => toggleTableCellSelection(current, cell, "multi"));
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`primary-modifier`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Ctrl или Command принимается;`}),`
+`,(0,c.jsx)(t.li,{children:`Ctrl+Shift не принимается;`}),`
+`,(0,c.jsx)(t.li,{children:`Command+Alt не принимается;`}),`
+`,(0,c.jsx)(t.li,{children:`Shift/Alt без primary modifier не принимается.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Так helper не перехватывает комбинации, обычно занятые browser/OS selection flow.`}),`
+`,(0,c.jsx)(t.h2,{id:`интерактивные-элементы-и-css-длины`,children:`Интерактивные элементы и CSS-длины`}),`
+`,(0,c.jsx)(t.h3,{id:`проблема-клика-по-строке`,children:`Проблема клика по строке`}),`
+`,(0,c.jsx)(t.p,{children:`В строке может быть кнопка:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-html`,children:`<tr data-row-id="1">
+	<td>Заказ</td>
+	<td><button type="button">Удалить</button></td>
+</tr>
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Клик по кнопке всплывает до `,(0,c.jsx)(t.code,{children:`<tr>`}),`. Если обработчик строки не проверит target, одновременно с удалением изменится selection.`]}),`
+`,(0,c.jsx)(t.h3,{id:`istableinteractiveelement`,children:(0,c.jsx)(t.code,{children:`isTableInteractiveElement`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function handleRowClick(event: React.MouseEvent<HTMLTableRowElement>) {
+	if (isTableInteractiveElement(event.target)) {
+		return;
+	}
+
+	activateRow();
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Helper ищет target или ближайшего ancestor среди:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`button`}),`, `,(0,c.jsx)(t.code,{children:`a`}),`, `,(0,c.jsx)(t.code,{children:`input`}),`, `,(0,c.jsx)(t.code,{children:`select`}),`, `,(0,c.jsx)(t.code,{children:`textarea`}),`, `,(0,c.jsx)(t.code,{children:`label`}),`, `,(0,c.jsx)(t.code,{children:`summary`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`audio/video с controls;`}),`
+`,(0,c.jsx)(t.li,{children:`editable element;`}),`
+`,(0,c.jsxs)(t.li,{children:[`focusable element с `,(0,c.jsx)(t.code,{children:`tabindex`}),`, кроме `,(0,c.jsx)(t.code,{children:`td`}),`, `,(0,c.jsx)(t.code,{children:`th`}),`, `,(0,c.jsx)(t.code,{children:`tr`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`draggable element;`}),`
+`,(0,c.jsx)(t.li,{children:`распространённых ARIA roles: button, link, checkbox, radio, switch, menu, option, tab, treeitem, slider, textbox, combobox и других.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`SVG icon внутри `,(0,c.jsx)(t.code,{children:`<button>`}),` тоже распознаётся, потому что используется `,(0,c.jsx)(t.code,{children:`closest`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`custom-interactive-selector`,children:`Custom interactive selector`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`if (isTableInteractiveElement(event.target, "[data-row-action='true']")) {
+	return;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`extraSelector`}),` добавляется к стандартному списку. Передавайте валидный CSS selector: невалидная строка может привести к DOM exception внутри `,(0,c.jsx)(t.code,{children:`Element.closest`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ssr-и-тесты`,children:`SSR и тесты`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если глобального `,(0,c.jsx)(t.code,{children:`Element`}),` нет или target не является `,(0,c.jsx)(t.code,{children:`Element`}),`, функция возвращает `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В unit-тесте с обычным Node environment DOM отсутствует. Для проверки реальных elements нужен `,(0,c.jsx)(t.code,{children:`jsdom`}),` или browser test.`]}),`
+`,(0,c.jsx)(t.h3,{id:`resolvetablelength`,children:(0,c.jsx)(t.code,{children:`resolveTableLength`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveTableLength(12); // "12em"
+resolveTableLength("50%"); // "50%"
+resolveTableLength("auto"); // "auto"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Число превращается в `,(0,c.jsx)(t.code,{children:`em`}),`, строка возвращается без изменений.`]}),`
+`,(0,c.jsx)(t.p,{children:`Функция не валидирует CSS:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveTableLength(Number.NaN); // "NaNem"
+resolveTableLength("not-a-css-length"); // та же строка
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Передавайте finite number или проверенное CSS-значение.`}),`
+`,(0,c.jsx)(t.h2,{id:`колонки-из-odata-metadata`,children:`Колонки из OData metadata`}),`
+`,(0,c.jsx)(t.h3,{id:`граница-ответственности`,children:`Граница ответственности`}),`
+`,(0,c.jsxs)(t.p,{children:[`Adapter принимает уже полученные `,(0,c.jsx)(t.code,{children:`EntityColumnProperty[]`}),`. Он не читает XML и не вызывает backend.`]}),`
+`,(0,c.jsx)(t.p,{children:`Metadata flow:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`OData XML metadata
+       │
+       ▼
+odata-service parser
+       │
+       ▼
+EntityColumnProperty[]
+       │
+       ▼
+table OData adapter
+       │
+       ▼
+TableColumnDef[] + visibility state
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`EntityColumnProperty`}),` импортируется из `,(0,c.jsx)(t.code,{children:`odata-service`}),`, а не из `,(0,c.jsx)(t.code,{children:`table`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { EntityColumnProperty } from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`resolvetablecolumnformattingcontextfromodatacolumn`,children:(0,c.jsx)(t.code,{children:`resolveTableColumnFormattingContextFromODataColumn`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`role`}),` и normalized `,(0,c.jsx)(t.code,{children:`type`}),` для formatting pipeline:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const context = resolveTableColumnFormattingContextFromODataColumn(column);
+
+// например:
+// { role: "measure", type: "decimal" }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Числовые типы всегда принудительно считаются `,(0,c.jsx)(t.code,{children:`measure`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`decimal`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`float`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`double`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`int`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`byte`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для остальных типов сохраняется `,(0,c.jsx)(t.code,{children:`column.role`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это влияет на базовое выравнивание и выбор formatter strategy.`}),`
+`,(0,c.jsx)(t.h3,{id:`createtablecolumnsfromodatametadata`,children:(0,c.jsx)(t.code,{children:`createTableColumnsFromODataMetadata`})}),`
+`,(0,c.jsx)(t.p,{children:`Создаёт одну leaf-колонку для каждого metadata property:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createTableColumnsFromODataMetadata } from "@ryuzaki13/react-foundation-lib/table";
+import type { EntityColumnProperty } from "@ryuzaki13/react-foundation-lib/odata-service";
+
+type ResultRow = {
+	AMOUNT: number;
+	NAME: string;
+};
+
+const metadataColumns = [
+	{
+		id: "AMOUNT",
+		type: "decimal",
+		originalType: "Edm.Decimal",
+		label: "Сумма",
+		semanticType: "none",
+		sortable: true,
+		filterable: true,
+		role: "measure"
+	},
+	{
+		id: "NAME",
+		type: "string",
+		originalType: "Edm.String",
+		label: "Наименование",
+		semanticType: "none",
+		sortable: true,
+		filterable: true,
+		role: "dimension"
+	}
+] satisfies EntityColumnProperty[];
+
+const columns = createTableColumnsFromODataMetadata<ResultRow>(metadataColumns);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Полученный shape:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{
+		id: "AMOUNT",
+		accessorKey: "AMOUNT",
+		header: "Сумма",
+		meta: {
+			align: "right",
+			formatting: {
+				id: "AMOUNT",
+				role: "measure",
+				type: "decimal"
+			}
+		}
+	},
+	{
+		id: "NAME",
+		accessorKey: "NAME",
+		header: "Наименование",
+		meta: {
+			align: "left",
+			formatting: {
+				id: "NAME",
+				role: "dimension",
+				type: "string"
+			}
+		}
+	}
+];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Header выбирается так:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`результат `,(0,c.jsx)(t.code,{children:`options.resolveHeader(column)`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`column.label`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`column.id`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`custom-header-и-formatting`,children:`Custom header и formatting`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const columns = createTableColumnsFromODataMetadata<ResultRow>(metadataColumns, {
+	resolveHeader: (column) => (column.id === "AMOUNT" ? "Итого" : (column.label ?? column.id)),
+	resolveFormatting: (column) =>
+		column.id === "AMOUNT"
+			? {
+					emptyWhenZero: true,
+					overflowTooltip: true
+				}
+			: undefined
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`id`}),`, `,(0,c.jsx)(t.code,{children:`role`}),` и `,(0,c.jsx)(t.code,{children:`type`}),` всегда берутся из metadata после merge custom options. Их нельзя подменить через `,(0,c.jsx)(t.code,{children:`resolveFormatting`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Generated columns не содержат custom `,(0,c.jsx)(t.code,{children:`cell`}),`, business permissions, row action или server sort handler. Добавляйте это на уровне host.`]}),`
+`,(0,c.jsx)(t.h3,{id:`базовое-выравнивание`,children:`Базовое выравнивание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`measure`}),` получает `,(0,c.jsx)(t.code,{children:`align: "right"`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`остальные role получают `,(0,c.jsx)(t.code,{children:`align: "left"`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это стартовое значение. Host может создать свои columns вручную или изменить возвращённые immutable copies.`}),`
+`,(0,c.jsx)(t.h3,{id:`createtablecolumnvisibilityfromodatametadata`,children:(0,c.jsx)(t.code,{children:`createTableColumnVisibilityFromODataMetadata`})}),`
+`,(0,c.jsx)(t.p,{children:`Строит стартовую карту:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const visibility = createTableColumnVisibilityFromODataMetadata(metadataColumns);
+
+// {
+//   CUSTOMER: false,
+//   CUSTOMER_Text: true,
+//   AMOUNT: true
+// }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Default правило:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`большинство колонок видимы;`}),`
+`,(0,c.jsxs)(t.li,{children:[`поле с `,(0,c.jsx)(t.code,{children:`semanticType: "code"`}),` скрывается, если `,(0,c.jsx)(t.code,{children:`linkedColumnId`}),` указывает на существующую metadata-колонку с `,(0,c.jsx)(t.code,{children:`semanticType: "text"`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`code без реальной text-пары остаётся видимым.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Колонки не удаляются из `,(0,c.jsx)(t.code,{children:`TableColumnDef[]`}),`. Visibility — отдельный state, поэтому пользовательский UI может снова показать code field.`]}),`
+`,(0,c.jsx)(t.h3,{id:`custom-visibility`,children:`Custom visibility`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const visibility = createTableColumnVisibilityFromODataMetadata(metadataColumns, {
+	resolveVisible: (column) => column.id !== "TECHNICAL_FIELD"
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если callback вернул boolean, default code/text правило больше не применяется для этой колонки.`}),`
+`,(0,c.jsx)(t.h3,{id:`resolvestablecolumnid`,children:(0,c.jsx)(t.code,{children:`resolveStableColumnId`})}),`
+`,(0,c.jsx)(t.p,{children:`Порядок поиска:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`непустой строковый `,(0,c.jsx)(t.code,{children:`column.id`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`непустой строковый `,(0,c.jsx)(t.code,{children:`accessorKey`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveStableColumnId({
+	id: "amount",
+	accessorKey: "AMOUNT",
+	header: "Сумма"
+});
+// "amount"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Явный `,(0,c.jsx)(t.code,{children:`id`}),` имеет приоритет.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`accessorFn`}),` без `,(0,c.jsx)(t.code,{children:`id`}),` результат `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция проверяет `,(0,c.jsx)(t.code,{children:`trim()`}),` только на пустоту, но возвращает оригинальную строку без trimming.`]}),`
+`,(0,c.jsx)(t.h3,{id:`enrichtablecolumnswithodataformatting`,children:(0,c.jsx)(t.code,{children:`enrichTableColumnsWithODataFormatting`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте, когда columns уже созданы вручную, но им не хватает OData role/type:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const manualColumns: TableColumnDef<ResultRow>[] = [
+	{
+		id: "AMOUNT",
+		accessorKey: "AMOUNT",
+		header: "Сумма",
+		meta: {
+			align: "center",
+			formatting: {
+				emptyWhenZero: true
+			}
+		}
+	}
+];
+
+const enriched = enrichTableColumnsWithODataFormatting(manualColumns, metadataColumns);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат для leaf:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const enrichedMeta = {
+	align: "center",
+	formatting: {
+		emptyWhenZero: true,
+		id: "AMOUNT",
+		role: "measure",
+		type: "decimal"
+	}
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Существующие `,(0,c.jsx)(t.code,{children:`align`}),` и formatting options сохраняются.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если и `,(0,c.jsx)(t.code,{children:`role`}),`, и `,(0,c.jsx)(t.code,{children:`type`}),` уже truthy, adapter не перезаписывает formatting:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const existingFormatting = {
+	formatting: {
+		role: "dimension",
+		type: "string"
+	}
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если отсутствует хотя бы одно из двух полей, adapter дозаполняет metadata-контекст и задаёт оба `,(0,c.jsx)(t.code,{children:`role/type`}),` из metadata.`]}),`
+`,(0,c.jsx)(t.h3,{id:`grouped-columns`,children:`Grouped columns`}),`
+`,(0,c.jsx)(t.p,{children:`Adapter рекурсивно обходит только leaf columns:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const columns: TableColumnDef<ResultRow>[] = [
+	{
+		id: "financial",
+		header: "Финансы",
+		columns: [
+			{
+				id: "AMOUNT",
+				accessorKey: "AMOUNT",
+				header: "Сумма"
+			}
+		]
+	}
+];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Group `,(0,c.jsx)(t.code,{children:`financial`}),` не сопоставляется с OData property. Leaf `,(0,c.jsx)(t.code,{children:`AMOUNT`}),` сопоставляется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`custom-metadata-lookup`,children:`Custom metadata lookup`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const enriched = enrichTableColumnsWithODataFormatting(columns, metadataColumns, {
+	resolveMetadataColumn: ({ columnId, metadataColumnsById }) => {
+		const sourceId = columnId === "displayAmount" ? "AMOUNT" : columnId;
+
+		return metadataColumnsById.get(sourceId);
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это полезно для view-column, id которой отличается от backend property.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Callback должен быть pure и не мутировать переданную `,(0,c.jsx)(t.code,{children:`Map`}),` или column definitions.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`построение-дерева-из-id-и-parentid`,children:[`Построение дерева из `,(0,c.jsx)(t.code,{children:`id`}),` и `,(0,c.jsx)(t.code,{children:`parentId`})]}),`
+`,(0,c.jsx)(t.h3,{id:`treetableflathierarchytdata`,children:(0,c.jsx)(t.code,{children:`TreeTableFlatHierarchy<TData>`})}),`
+`,(0,c.jsx)(t.p,{children:`Контракт говорит, как извлечь связь из любой формы строки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface TreeTableFlatHierarchy<TData> {
+	getRowId: (row: TData) => string;
+	getParentRowId: (row: TData) => string | null | undefined;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Можно использовать любые имена backend-полей:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const hierarchy: TreeTableFlatHierarchy<SapRow> = {
+	getRowId: (row) => row.NODE_KEY,
+	getParentRowId: (row) => row.PARENT_KEY || null
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` означают root.`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildtreetablerows`,children:(0,c.jsx)(t.code,{children:`buildTreeTableRows`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = buildTreeTableRows(items, hierarchy);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Один раз проходит по исходным строкам и строит индексы.`}),`
+`,(0,c.jsx)(t.li,{children:`Определяет обычные roots, orphans и self-references.`}),`
+`,(0,c.jsx)(t.li,{children:`Рекурсивно создаёт shallow copies узлов.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Добавляет непустой `,(0,c.jsx)(t.code,{children:`children`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не теряет компоненту, если весь набор замкнут в цикл.`}),`
+`,(0,c.jsx)(t.li,{children:`Возвращает дерево и diagnostics.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Исходный `,(0,c.jsx)(t.code,{children:`items`}),` не мутируется.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`результат-treetablebuildresult`,children:[`Результат `,(0,c.jsx)(t.code,{children:`TreeTableBuildResult`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface TreeTableBuildResult<TData> {
+	rows: TreeTableRowNode<TData>[];
+	rowById: Map<string, TData>;
+	allRowIds: string[];
+	rootRowIds: string[];
+	orphanRowIds: string[];
+	duplicateRowIds: string[];
+	cyclicRowIds: string[];
+}
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Поле`}),(0,c.jsx)(t.th,{children:`Содержимое`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rows`})}),(0,c.jsxs)(t.td,{children:[`корневые shallow-copy узлы с вложенным `,(0,c.jsx)(t.code,{children:`children`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rowById`})}),(0,c.jsx)(t.td,{children:`первые исходные объекты по id`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`allRowIds`})}),(0,c.jsx)(t.td,{children:`все принятые уникальные id в исходном порядке`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rootRowIds`})}),(0,c.jsx)(t.td,{children:`id итоговых roots в порядке построения`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`orphanRowIds`})}),(0,c.jsx)(t.td,{children:`строки с отсутствующим parent`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`duplicateRowIds`})}),(0,c.jsx)(t.td,{children:`повторившиеся id`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`cyclicRowIds`})}),(0,c.jsx)(t.td,{children:`точки, в которых алгоритм обнаружил цикл`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`treetablerownodetdata`,children:(0,c.jsx)(t.code,{children:`TreeTableRowNode<TData>`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TreeTableRowNode<TData> = TData & {
+	children?: TreeTableRowNode<TData>[];
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Узел сохраняет все поля исходной строки и при наличии детей получает `,(0,c.jsx)(t.code,{children:`children`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`shallow-copy`,children:`Shallow copy`}),`
+`,(0,c.jsx)(t.p,{children:`Копируется только верхний уровень:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const original = {
+	id: "root",
+	parentId: null,
+	settings: { color: "red" }
+};
+
+const node = buildTreeTableRows([original], hierarchy).rows[0];
+
+node !== original; // true
+node.settings === original.settings; // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не мутируйте nested objects через tree node, если они принадлежат query cache или props.`}),`
+`,(0,c.jsxs)(t.h3,{id:`зарезервированное-поле-children`,children:[`Зарезервированное поле `,(0,c.jsx)(t.code,{children:`children`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция использует поле `,(0,c.jsx)(t.code,{children:`children`}),`. Если исходный `,(0,c.jsx)(t.code,{children:`TData`}),` уже содержит business-поле с этим именем, возможен конфликт:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`при найденных детях оно будет заменено построенным массивом;`}),`
+`,(0,c.jsx)(t.li,{children:`при отсутствии найденных детей исходное поле останется в shallow copy.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Предпочитайте input type без собственного `,(0,c.jsx)(t.code,{children:`children`}),` или предварительно переименуйте business-поле на boundary.`]}),`
+`,(0,c.jsx)(t.h3,{id:`обычные-roots`,children:`Обычные roots`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const roots = [
+	{ id: "root-1", parentId: null },
+	{ id: "root-2", parentId: undefined }
+];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обе строки считаются корневыми.`}),`
+`,(0,c.jsx)(t.h3,{id:`orphan`,children:`Orphan`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const orphan = { id: "orphan", parentId: "missing" };
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Строка не удаляется. Она поднимается в root:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`result.rootRowIds.includes("orphan"); // true
+result.orphanRowIds.includes("orphan"); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это позволяет UI показать повреждённые данные, а diagnostics — сообщить о проблеме.`}),`
+`,(0,c.jsx)(t.h3,{id:`self-reference`,children:`Self-reference`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const selfReferencedRow = { id: "a", parentId: "a" };
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Строка становится root и попадает в `,(0,c.jsx)(t.code,{children:`cyclicRowIds`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`цикл-из-нескольких-строк`,children:`Цикл из нескольких строк`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{ id: "a", parentId: "b" },
+	{ id: "b", parentId: "a" }
+];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Явного root нет. Функция начинает с первого непосещённого id, строит доступную цепочку и обрывает обратную ссылку:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{
+		id: "a",
+		parentId: "b",
+		children: [{ id: "b", parentId: "a" }]
+	}
+];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`cyclicRowIds`}),` — diagnostics точек обнаружения, а не гарантированный полный список всех участников strongly connected component. В примере он может содержать только `,(0,c.jsx)(t.code,{children:`"a"`}),`. Если бизнесу нужен полный анализ графа, выполняйте отдельную validation до построения UI-дерева.`]}),`
+`,(0,c.jsx)(t.h3,{id:`duplicate-id`,children:`Duplicate id`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{ id: "root", title: "Первый" },
+	{ id: "root", title: "Повтор" }
+];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используется первое вхождение. Следующие игнорируются. `,(0,c.jsx)(t.code,{children:`duplicateRowIds`}),` содержит уникальный проблемный id, а не число повторов.`]}),`
+`,(0,c.jsx)(t.h3,{id:`порядок`,children:`Порядок`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`allRowIds`}),` сохраняет порядок первых уникальных входных строк;`]}),`
+`,(0,c.jsx)(t.li,{children:`children одного parent идут в порядке входных строк;`}),`
+`,(0,c.jsx)(t.li,{children:`root candidates идут в порядке входных строк;`}),`
+`,(0,c.jsx)(t.li,{children:`циклическая компонента без root начинается с первого непосещённого id.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Функция не сортирует по title, id или business order.`}),`
+`,(0,c.jsx)(t.h3,{id:`validation-id`,children:`Validation id`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),` не обрезает и не запрещает пустой id:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getRowId: () => "";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Технически такой ключ попадёт в `,(0,c.jsx)(t.code,{children:`Map`}),`. Это почти всегда ошибка данных. Валидируйте uniqueness и non-empty string на external boundary.`]}),`
+`,(0,c.jsx)(t.h3,{id:`интеграция-с-tanstack-table`,children:`Интеграция с TanStack Table`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const treeData = buildTreeTableRows(rows, hierarchy);
+
+const table = useTable({
+	features: foundationTableFeatures,
+	data: treeData.rows,
+	columns,
+	getRowId: (row) => hierarchy.getRowId(row),
+	getSubRows: (row) => row.children
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для selection можно передать:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`useTableRowSelection({
+	availableRowIds: treeData.allRowIds,
+	rowById: treeData.rowById,
+	selectionMode: "multi",
+	onRowSelectionChange
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Callback получит исходные `,(0,c.jsx)(t.code,{children:`TData`}),` из `,(0,c.jsx)(t.code,{children:`rowById`}),`, а не shallow-copy узлы с `,(0,c.jsx)(t.code,{children:`children`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`транспонирование-аналитических-строк`,children:`Транспонирование аналитических строк`}),`
+`,(0,c.jsx)(t.h3,{id:`когда-нужна-функция`,children:`Когда нужна функция`}),`
+`,(0,c.jsx)(t.p,{children:`Исходные факты часто выглядят так:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{ REGION: "Урал", CITY: "Екатеринбург", AMOUNT: 10 },
+	{ REGION: "Урал", CITY: "Екатеринбург", AMOUNT: 20 },
+	{ REGION: "Урал", CITY: "Пермь", AMOUNT: 30 }
+];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Backend не прислал group rows. `,(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`}),` создаст:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Урал                    synthetic level 0
+├─ Екатеринбург         synthetic level 1
+│  ├─ fact AMOUNT 10    leaf
+│  └─ fact AMOUNT 20    leaf
+└─ Пермь                synthetic level 1
+   └─ fact AMOUNT 30    leaf
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`treetabletransposeflatrowsoptions`,children:(0,c.jsx)(t.code,{children:`TreeTableTransposeFlatRowsOptions`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TreeTableTransposeFlatRowsOptions = {
+	hierarchyLevels: readonly {
+		columnId: string;
+		expandByDefault?: boolean;
+	}[];
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Порядок `,(0,c.jsx)(t.code,{children:`hierarchyLevels`}),` задаёт уровни сверху вниз.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	hierarchyLevels: [{ columnId: "REGION" }, { columnId: "CITY" }];
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`нормализация-levels`,children:`Нормализация levels`}),`
+`,(0,c.jsx)(t.p,{children:`Перед преобразованием:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`columnId`}),` обрезается через `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`пустые id удаляются;`}),`
+`,(0,c.jsx)(t.li,{children:`повторяющиеся id удаляются;`}),`
+`,(0,c.jsx)(t.li,{children:`сохраняется первое вхождение.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	hierarchyLevels: [{ columnId: " REGION " }, { columnId: "" }, { columnId: "REGION" }, { columnId: "CITY" }];
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Превращается в levels `,(0,c.jsx)(t.code,{children:`REGION`}),`, `,(0,c.jsx)(t.code,{children:`CITY`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если после нормализации levels нет, функция возвращает `,(0,c.jsx)(t.code,{children:`[]`}),`, даже если `,(0,c.jsx)(t.code,{children:`rows`}),` непустой.`]}),`
+`,(0,c.jsx)(t.h3,{id:`expandbydefault`,children:(0,c.jsx)(t.code,{children:`expandByDefault`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поле является частью общего публичного описания level, но сама функция `,(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`}),` в текущей реализации его не использует и не записывает в строки.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Раскрытие — состояние UI. Передавайте `,(0,c.jsx)(t.code,{children:`expandByDefault`}),` своему downstream runtime или вычисляйте initial expanded ids отдельно. Не ожидайте, что вызов transpose автоматически раскроет узлы.`]}),`
+`,(0,c.jsx)(t.h3,{id:`служебные-поля`,children:`Служебные поля`}),`
+`,(0,c.jsx)(t.p,{children:`Каждая выходная строка содержит:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Constant`}),(0,c.jsx)(t.th,{children:`Фактическое имя поля`}),(0,c.jsx)(t.th,{children:`Значение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_ROW_ID_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`__treeTableRowId`})}),(0,c.jsx)(t.td,{children:`сгенерированный уникальный id`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_PARENT_ROW_ID_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`__treeTableParentRowId`})}),(0,c.jsxs)(t.td,{children:[`id parent или `,(0,c.jsx)(t.code,{children:`null`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_LABEL_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`__treeTableLabel`})}),(0,c.jsx)(t.td,{children:`label текущего узла`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_LEVEL_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`__treeTableLevel`})}),(0,c.jsx)(t.td,{children:`индекс уровня/глубина leaf`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_SYNTHETIC_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`__treeTableSynthetic`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`true`}),` для group, `,(0,c.jsx)(t.code,{children:`false`}),` для fact leaf`]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Не пишите строковые имена вручную. Используйте constants:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rowId = row[TREE_TABLE_TRANSPOSED_ROW_ID_FIELD];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Так refactor имени поля будет проверяться TypeScript.`}),`
+`,(0,c.jsx)(t.h3,{id:`зарезервированные-имена`,children:`Зарезервированные имена`}),`
+`,(0,c.jsx)(t.p,{children:`Input row не должен использовать business-поля:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`__treeTableRowId
+__treeTableParentRowId
+__treeTableLabel
+__treeTableLevel
+__treeTableSynthetic
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для leaf функция сначала spread-ит исходный объект, затем записывает служебные поля. Совпавшие business-значения будут перезаписаны.`}),`
+`,(0,c.jsx)(t.h3,{id:`synthetic-row`,children:`Synthetic row`}),`
+`,(0,c.jsx)(t.p,{children:`Пример group-узла:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const syntheticRow = {
+	__treeTableRowId: '[["REGION","Урал"]]',
+	__treeTableParentRowId: null,
+	__treeTableLabel: "Урал",
+	__treeTableLevel: 0,
+	__treeTableSynthetic: true,
+	REGION: "Урал"
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Synthetic row содержит:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`служебные поля;`}),`
+`,(0,c.jsx)(t.li,{children:`только значение колонки текущего уровня;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не содержит `,(0,c.jsx)(t.code,{children:`AMOUNT`}),` и остальные business-поля факта;`]}),`
+`,(0,c.jsx)(t.li,{children:`не содержит агрегированную сумму.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`UI должен проверять `,(0,c.jsx)(t.code,{children:`__treeTableSynthetic`}),` прежде чем считать business field обязательным.`]}),`
+`,(0,c.jsx)(t.h3,{id:`leaf-row`,children:`Leaf row`}),`
+`,(0,c.jsx)(t.p,{children:`Пример листа:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const leafRow = {
+	REGION: "Урал",
+	CITY: "Екатеринбург",
+	AMOUNT: 10,
+	__treeTableRowId: "...#row:0",
+	__treeTableParentRowId: "...",
+	__treeTableLabel: "Екатеринбург",
+	__treeTableLevel: 2,
+	__treeTableSynthetic: false
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Leaf сохраняет все enumerable-поля исходной строки. Служебные поля добавляются поверх них.`}),`
+`,(0,c.jsx)(t.h3,{id:`как-создаются-group-id`,children:`Как создаются group id`}),`
+`,(0,c.jsxs)(t.p,{children:[`ID строится из полного пути пар `,(0,c.jsx)(t.code,{children:`columnId + string label`}),` и сериализуется в JSON:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	["REGION", "Урал"],
+	["CITY", "Екатеринбург"]
+];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это даёт важные свойства:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`одинаковый city под разными region создаёт разные nodes;`}),`
+`,(0,c.jsx)(t.li,{children:`одинаковый label в разных level columns не смешивается;`}),`
+`,(0,c.jsx)(t.li,{children:`повторяющийся путь переиспользует один synthetic node;`}),`
+`,(0,c.jsx)(t.li,{children:`id детерминирован для одинакового нормализованного пути.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не парсите формат id ради business-логики. Считайте его opaque string.`}),`
+`,(0,c.jsx)(t.h3,{id:`как-создаются-leaf-id`,children:`Как создаются leaf id`}),`
+`,(0,c.jsx)(t.p,{children:`К group path добавляется индекс исходной строки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`<serialized-path>#row:0
+<serialized-path>#row:1
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Следствие: leaf id стабилен только пока порядок input rows стабилен. После server sorting или insertion индекс может измениться.`}),`
+`,(0,c.jsx)(t.p,{children:`Если selection листьев должен переживать reorder, текущий helper не принимает custom leaf id. Host должен:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`хранить устойчивый business id в исходной строке для восстановления selection;`}),`
+`,(0,c.jsx)(t.li,{children:`либо использовать другой заранее подготовленный hierarchy contract;`}),`
+`,(0,c.jsx)(t.li,{children:`либо отдельно мапить business selection, не считая generated leaf id доменным идентификатором.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`преобразование-значений-level`,children:`Преобразование значений level`}),`
+`,(0,c.jsx)(t.p,{children:`Правила label:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Исходное значение`}),(0,c.jsx)(t.th,{children:`Результат`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})}),(0,c.jsx)(t.td,{children:`level пропускается`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:`level пропускается`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`""`})}),(0,c.jsx)(t.td,{children:`level пропускается`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsxs)(t.td,{children:[`label `,(0,c.jsx)(t.code,{children:`"0"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsxs)(t.td,{children:[`label `,(0,c.jsx)(t.code,{children:`"false"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`123`})}),(0,c.jsxs)(t.td,{children:[`label `,(0,c.jsx)(t.code,{children:`"123"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"  "`})}),(0,c.jsx)(t.td,{children:`непустой whitespace label, level не пропускается`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Значение не trim-ится. Если whitespace считается пустым по бизнес-контракту, нормализуйте backend data до вызова.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Число `,(0,c.jsx)(t.code,{children:`1`}),` и строка `,(0,c.jsx)(t.code,{children:`"1"`}),` становятся одинаковым label и одним group path. Synthetic row сохранит исходное значение первого встретившегося факта в поле level column.`]}),`
+`,(0,c.jsx)(t.h3,{id:`пустой-промежуточный-level`,children:`Пустой промежуточный level`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rowWithEmptyLevel = {
+	REGION: "Урал",
+	CITY: "",
+	STORE: "Магазин 1"
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При levels `,(0,c.jsx)(t.code,{children:`REGION`}),`, `,(0,c.jsx)(t.code,{children:`CITY`}),`, `,(0,c.jsx)(t.code,{children:`STORE`}),` пустой `,(0,c.jsx)(t.code,{children:`CITY`}),` пропускается. `,(0,c.jsx)(t.code,{children:`STORE`}),` становится прямым ребёнком `,(0,c.jsx)(t.code,{children:`REGION`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При этом `,(0,c.jsx)(t.code,{children:`__treeTableLevel`}),` synthetic STORE будет равен исходному индексу level `,(0,c.jsx)(t.code,{children:`2`}),`, а не визуальной глубине `,(0,c.jsx)(t.code,{children:`1`}),`. Leaf получит `,(0,c.jsx)(t.code,{children:`3`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте служебный level как гарантированную DOM depth при пропущенных значениях. Фактическую глубину после `,(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),` вычисляет tree runtime.`]}),`
+`,(0,c.jsx)(t.h3,{id:`строка-без-единого-level`,children:`Строка без единого level`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если у факта все hierarchy values равны `,(0,c.jsx)(t.code,{children:`null`}),`, `,(0,c.jsx)(t.code,{children:`undefined`}),` или `,(0,c.jsx)(t.code,{children:`""`}),`, функция полностью пропускает строку: не создаёт ни group, ни leaf.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если такое поведение неприемлемо, заранее подставьте явный label вроде `,(0,c.jsx)(t.code,{children:`"Без группы"`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`порядок-output`,children:`Порядок output`}),`
+`,(0,c.jsx)(t.p,{children:`Функция обходит input rows по порядку. Для каждой строки она:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Добавляет ещё не созданные synthetic nodes её пути.`}),`
+`,(0,c.jsx)(t.li,{children:`Добавляет leaf.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому flat output отражает порядок первого появления групп и листьев. После `,(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),` children каждой группы сохраняют этот порядок.`]}),`
+`,(0,c.jsx)(t.h3,{id:`никакой-агрегации`,children:`Никакой агрегации`}),`
+`,(0,c.jsx)(t.p,{children:`Функция не вычисляет:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`суммы;`}),`
+`,(0,c.jsx)(t.li,{children:`counts;`}),`
+`,(0,c.jsx)(t.li,{children:`min/max;`}),`
+`,(0,c.jsx)(t.li,{children:`subtotal;`}),`
+`,(0,c.jsx)(t.li,{children:`состояние mixed selection;`}),`
+`,(0,c.jsx)(t.li,{children:`наследование permissions.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Если group row должен показывать total, получите aggregate с backend или вычислите его отдельной domain/presentation функцией с явно заданной политикой.`}),`
+`,(0,c.jsx)(t.h2,{id:`полный-pipeline-для-аналитического-дерева`,children:`Полный pipeline для аналитического дерева`}),`
+`,(0,c.jsx)(t.h3,{id:`1-импорты`,children:`1. Импорты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	buildTreeTableRows,
+	transposeFlatRowsToTreeTableRows,
+	TREE_TABLE_TRANSPOSED_LABEL_FIELD,
+	TREE_TABLE_TRANSPOSED_PARENT_ROW_ID_FIELD,
+	TREE_TABLE_TRANSPOSED_ROW_ID_FIELD,
+	TREE_TABLE_TRANSPOSED_SYNTHETIC_FIELD,
+	type TreeTableTransposedRow
+} from "@ryuzaki13/react-foundation-lib/tree-table";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`2-исходный-тип`,children:`2. Исходный тип`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SalesFact = {
+	REGION: string;
+	CITY: string;
+	AMOUNT: number;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`3-flat-hierarchy`,children:`3. Flat hierarchy`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const transposed = transposeFlatRowsToTreeTableRows(facts, {
+	hierarchyLevels: [{ columnId: "REGION" }, { columnId: "CITY" }]
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`TypeScript выводит:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`TreeTableTransposedRow < SalesFact > [];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Фактически synthetic row не имеет всех business fields `,(0,c.jsx)(t.code,{children:`SalesFact`}),`, хотя intersection type предоставляет их compile-time. Поэтому runtime-код обязан проверять флаг:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function readAmount(row: TreeTableTransposedRow<SalesFact>): number | undefined {
+	if (row[TREE_TABLE_TRANSPOSED_SYNTHETIC_FIELD]) {
+		return undefined;
+	}
+
+	return row.AMOUNT;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`4-nested-hierarchy`,children:`4. Nested hierarchy`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const tree = buildTreeTableRows(transposed, {
+	getRowId: (row) => row[TREE_TABLE_TRANSPOSED_ROW_ID_FIELD],
+	getParentRowId: (row) => row[TREE_TABLE_TRANSPOSED_PARENT_ROW_ID_FIELD]
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`5-tree-label-column`,children:`5. Tree label column`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { TableColumnDef } from "@ryuzaki13/react-foundation-lib/table";
+
+type RuntimeRow = TreeTableTransposedRow<SalesFact>;
+
+const columns: TableColumnDef<RuntimeRow>[] = [
+	{
+		id: "treeLabel",
+		accessorFn: (row) => row[TREE_TABLE_TRANSPOSED_LABEL_FIELD],
+		header: "Структура"
+	},
+	{
+		id: "amount",
+		accessorFn: (row) => (row[TREE_TABLE_TRANSPOSED_SYNTHETIC_FIELD] ? undefined : row.AMOUNT),
+		header: "Сумма",
+		meta: { align: "right" }
+	}
+];
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`6-tanstack-instance`,children:`6. TanStack instance`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const table = useTable({
+	features: foundationTableFeatures,
+	data: tree.rows,
+	columns,
+	getRowId: (row) => row[TREE_TABLE_TRANSPOSED_ROW_ID_FIELD],
+	getSubRows: (row) => row.children
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`диагностика-после-pipeline`,children:`Диагностика после pipeline`}),`
+`,(0,c.jsx)(t.p,{children:`Transposition создаёт собственные уникальные ids, поэтому обычный результат не должен содержать duplicates, orphans или cycles.`}),`
+`,(0,c.jsx)(t.p,{children:`Проверка полезна для раннего обнаружения неожиданного контракта:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`if (tree.duplicateRowIds.length > 0 || tree.orphanRowIds.length > 0 || tree.cyclicRowIds.length > 0) {
+	console.warn("Некорректная иерархия таблицы", {
+		duplicates: tree.duplicateRowIds,
+		orphans: tree.orphanRowIds,
+		cycles: tree.cyclicRowIds
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не логируйте целые backend rows, если они содержат персональные или чувствительные данные.`}),`
+`,(0,c.jsx)(t.h2,{id:`controlled-state-и-сохранение-настроек`,children:`Controlled state и сохранение настроек`}),`
+`,(0,c.jsx)(t.h3,{id:`controlled-и-uncontrolled-простыми-словами`,children:`Controlled и uncontrolled простыми словами`}),`
+`,(0,c.jsx)(t.p,{children:`Uncontrolled state хранится внутри UI-компонента:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`<Table defaultColumnOrder={["name", "amount"]} />
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Controlled state принадлежит host:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`<Table columnOrder={columnOrder} onColumnOrderChange={setColumnOrder} />
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Lib helpers подходят обоим вариантам, но сами ничего не сохраняют.`}),`
+`,(0,c.jsx)(t.h3,{id:`восстановление-сохранённого-order`,children:`Восстановление сохранённого order`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const actualColumnIds = columns.map(resolveStableColumnId).filter((id): id is string => id !== undefined);
+
+const columnOrder = resolveTableColumnOrder({
+	ids: actualColumnIds,
+	order: persistedConfig.columnOrder
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это внешняя restore-boundary: stale id удаляются, новые columns добавляются.`}),`
+`,(0,c.jsx)(t.h3,{id:`восстановление-sizing`,children:`Восстановление sizing`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const columnSizing = normalizeTableColumnSizing(persistedConfig.columnSizing, 80);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`После этого полезно удалить ключи несуществующих колонок на стороне config owner, потому что `,(0,c.jsx)(t.code,{children:`normalizeTableColumnSizing`}),` проверяет форму width, но не знает актуальный список колонок.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сохраняйте-state-по-id`,children:`Сохраняйте state по id`}),`
+`,(0,c.jsx)(t.p,{children:`Хороший persisted shape:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TablePreferences = {
+	version: 1;
+	columnOrder: string[];
+	columnSizing: Record<string, number>;
+	columnVisibility: Record<string, boolean>;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не сохраняйте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`TanStack table instance;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Map`}),` без явной сериализации;`]}),`
+`,(0,c.jsx)(t.li,{children:`functions из column definitions;`}),`
+`,(0,c.jsx)(t.li,{children:`React elements;`}),`
+`,(0,c.jsx)(t.li,{children:`DOM nodes;`}),`
+`,(0,c.jsx)(t.li,{children:`backend secrets;`}),`
+`,(0,c.jsx)(t.li,{children:`индекс строки как устойчивый id.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`версионируйте-config`,children:`Версионируйте config`}),`
+`,(0,c.jsx)(t.p,{children:`Если меняются column ids или семантика width, повышайте версию и выполняйте migration на restore-boundary.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type StoredTablePreferences = { version: 1; order: string[] } | { version: 2; columnOrder: string[] };
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не смешивайте normalization пользовательского draft с migration persisted payload. Draft resize/reorder должен сохранять введённое состояние буквально до явной save-boundary.`}),`
+`,(0,c.jsx)(t.h2,{id:`server-side-данные-и-пагинация`,children:`Server-side данные и пагинация`}),`
+`,(0,c.jsx)(t.h3,{id:`table-state-не-является-backend-query`,children:`Table state не является backend query`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`columnOrder`}),`, `,(0,c.jsx)(t.code,{children:`columnSizing`}),`, `,(0,c.jsx)(t.code,{children:`rowSelection`}),` и expansion — локальный UI state.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Sorting/filter/paging конкретной OData entity принадлежит entity/API owner. Не передавайте `,(0,c.jsx)(t.code,{children:`TableColumnOrderState`}),` как `,(0,c.jsx)(t.code,{children:`$orderby`}),`: визуальный порядок колонок и порядок строк — разные понятия.`]}),`
+`,(0,c.jsx)(t.h3,{id:`новая-страница-данных`,children:`Новая страница данных`}),`
+`,(0,c.jsx)(t.p,{children:`После получения нового snapshot:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const availableRowIds = rows.map((row) => row.id);
+
+const nextSelection = pruneTableRowSelection(selection, availableRowIds, selectionMode);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это очищает selection удалённых или больше не загруженных строк.`}),`
+`,(0,c.jsx)(t.h3,{id:`infinite-loading`,children:`Infinite loading`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если несколько страниц объединены в один массив, `,(0,c.jsx)(t.code,{children:`availableRowIds`}),` должен включать все загруженные уникальные строки.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не выполняйте network request из cell renderer. Request должен запускаться query/loader/virtualizer boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`backend-grouping-и-transposition`,children:`Backend grouping и transposition`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`}),` создаёт client-side presentation groups. Она не заменяет server grouping для большого набора:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`helper видит только загруженные rows;`}),`
+`,(0,c.jsx)(t.li,{children:`total по одной странице не является total всего dataset;`}),`
+`,(0,c.jsx)(t.li,{children:`одинаковая группа на разных страницах может появляться частями;`}),`
+`,(0,c.jsx)(t.li,{children:`generated leaf id зависит от индекса объединённого массива.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для аналитической таблицы предпочитайте backend totals и устойчивый server contract.`}),`
+`,(0,c.jsx)(t.h2,{id:`react-browser-и-ssr`,children:`React, browser и SSR`}),`
+`,(0,c.jsx)(t.h3,{id:`pure-helpers`,children:`Pure helpers`}),`
+`,(0,c.jsx)(t.p,{children:`Большинство функций можно вызывать в browser, Node.js и unit tests:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`layout/order/sizing;`}),`
+`,(0,c.jsx)(t.li,{children:`row/cell selection;`}),`
+`,(0,c.jsx)(t.li,{children:`OData column adapter;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`resolveTableLength`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Они не выполняют I/O и не используют global state.`}),`
+`,(0,c.jsx)(t.h3,{id:`react-hook`,children:`React hook`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useTableRowSelection`}),` требует React 19-compatible runtime и вызывается только:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`на верхнем уровне function component;`}),`
+`,(0,c.jsx)(t.li,{children:`или на верхнем уровне custom hook.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Нельзя:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`if (enabled) {
+	useTableRowSelection({
+		availableRowIds,
+		rowById,
+		selectionMode: "multi"
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Нужно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const selection = useTableRowSelection({
+	availableRowIds,
+	rowById,
+	selectionMode: enabled ? "multi" : "none"
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`browser-helper`,children:`Browser helper`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`isTableInteractiveElement`}),` использует `,(0,c.jsx)(t.code,{children:`Element`}),` и `,(0,c.jsx)(t.code,{children:`closest`}),` только если DOM доступен. При SSR/Node без DOM возвращается `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте это поведение как security check. Это только UI-event helper.`}),`
+`,(0,c.jsx)(t.h3,{id:`hydration-и-стабильные-id`,children:`Hydration и стабильные id`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если host использует SSR, `,(0,c.jsx)(t.code,{children:`getRowId`}),`, column ids и initial state должны быть детерминированы на server и client. Не используйте `,(0,c.jsx)(t.code,{children:`Math.random()`}),` или `,(0,c.jsx)(t.code,{children:`Date.now()`}),` при render.`]}),`
+`,(0,c.jsx)(t.p,{children:`Сам пакет не запускает SSR и не создаёт hydration boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`side-effects`,children:`Side effects`}),`
+`,(0,c.jsx)(t.p,{children:`У модулей нет обязательной глобальной инициализации, singleton или cleanup.`}),`
+`,(0,c.jsx)(t.p,{children:`Side effects появляются только у host:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`React state/effects;`}),`
+`,(0,c.jsx)(t.li,{children:`storage persistence;`}),`
+`,(0,c.jsx)(t.li,{children:`event listeners;`}),`
+`,(0,c.jsx)(t.li,{children:`DnD runtime;`}),`
+`,(0,c.jsx)(t.li,{children:`backend query.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`производительность`,children:`Производительность`}),`
+`,(0,c.jsx)(t.h3,{id:`стабильные-columns`,children:`Стабильные columns`}),`
+`,(0,c.jsx)(t.p,{children:`Не создавайте большой массив columns заново без необходимости:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const columns = useMemo<TableColumnDef<Row>[]>(() => buildColumns(metadata), [metadata]);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При этом не добавляйте `,(0,c.jsx)(t.code,{children:`useMemo`}),` механически к маленькой константе вне component.`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildtreetablerows-1`,children:(0,c.jsx)(t.code,{children:`buildTreeTableRows`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Ожидаемая сложность построения индексов и дерева близка к `,(0,c.jsx)(t.code,{children:`O(n)`}),` для `,(0,c.jsx)(t.code,{children:`n`}),` строк, потому что используются `,(0,c.jsx)(t.code,{children:`Map`}),` и `,(0,c.jsx)(t.code,{children:`Set`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Каждый принятый узел получает shallow copy. Для очень глубокого дерева используется рекурсия, поэтому патологическая цепочка в десятки тысяч уровней может переполнить call stack. Валидируйте разумную глубину внешних данных.`}),`
+`,(0,c.jsx)(t.p,{children:`В React вычисляйте дерево по identity входных данных:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const tree = useMemo(() => buildTreeTableRows(rows, hierarchy), [rows, hierarchy]);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Объект `,(0,c.jsx)(t.code,{children:`hierarchy`}),` тоже должен быть стабильным. Вынесите его за component или мемоизируйте.`]}),`
+`,(0,c.jsx)(t.h3,{id:`transposeflatrowstotreetablerows`,children:(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сложность примерно `,(0,c.jsx)(t.code,{children:`O(rows × levels)`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Максимальный output без учёта дедупликации groups может приближаться к:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`rows × (hierarchyLevels + 1)
+`})}),`
+`,(0,c.jsx)(t.p,{children:`На практике общие synthetic paths переиспользуются.`}),`
+`,(0,c.jsx)(t.p,{children:`Не транспонируйте один и тот же большой snapshot в каждом cell render.`}),`
+`,(0,c.jsx)(t.h3,{id:`selection`,children:`Selection`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`row prune создаёт `,(0,c.jsx)(t.code,{children:`Set`}),` доступных ids;`]}),`
+`,(0,c.jsx)(t.li,{children:`cell prune создаёт maps порядка и сортирует выбранные координаты;`}),`
+`,(0,c.jsx)(t.li,{children:`equality helpers строят списки/sets.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для обычного пользовательского selection этого достаточно. Для выбора сотен тысяч строк нужна другая server/domain модель.`}),`
+`,(0,c.jsx)(t.h3,{id:`odata-columns`,children:`OData columns`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createTableColumnVisibilityFromODataMetadata`}),` и enrichment создают `,(0,c.jsx)(t.code,{children:`Map`}),` metadata по id. Вызывайте их при изменении metadata/columns, а не для каждой ячейки.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование-consumer-кода`,children:`Тестирование consumer-кода`}),`
+`,(0,c.jsx)(t.h3,{id:`pure-selection-test`,children:`Pure selection test`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { describe, expect, it } from "vitest";
+
+import { pruneTableRowSelection, toggleTableRowSelection } from "@ryuzaki13/react-foundation-lib/table";
+
+describe("order selection", () => {
+	it("оставляет одну строку в single mode", () => {
+		const selected = toggleTableRowSelection({ old: true }, "new", "single");
+
+		expect(selected).toEqual({ new: true });
+	});
+
+	it("удаляет отсутствующую строку", () => {
+		expect(pruneTableRowSelection({ deleted: true }, ["actual"], "multi")).toEqual({});
+	});
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`tree-diagnostics-test`,children:`Tree diagnostics test`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("показывает orphan как root", () => {
+	const result = buildTreeTableRows(
+		[
+			{
+				id: "orphan",
+				parentId: "missing",
+				title: "Сирота"
+			}
+		],
+		{
+			getRowId: (row) => row.id,
+			getParentRowId: (row) => row.parentId
+		}
+	);
+
+	expect(result.rootRowIds).toEqual(["orphan"]);
+	expect(result.orphanRowIds).toEqual(["orphan"]);
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`transposition-test`,children:`Transposition test`}),`
+`,(0,c.jsx)(t.p,{children:`Проверяйте не полный generated JSON id, а отношения через constants:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rows = transposeFlatRowsToTreeTableRows([{ REGION: "Урал", CITY: "Пермь", AMOUNT: 10 }], {
+	hierarchyLevels: [{ columnId: "REGION" }, { columnId: "CITY" }]
+});
+
+const region = rows[0];
+const city = rows[1];
+const fact = rows[2];
+
+expect(city[TREE_TABLE_TRANSPOSED_PARENT_ROW_ID_FIELD]).toBe(region[TREE_TABLE_TRANSPOSED_ROW_ID_FIELD]);
+
+expect(fact[TREE_TABLE_TRANSPOSED_SYNTHETIC_FIELD]).toBe(false);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`dom-helper-test`,children:`DOM helper test`}),`
+`,(0,c.jsx)(t.p,{children:`Нужен jsdom:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// @vitest-environment jsdom
+
+it("не активирует строку по клику на кнопку", () => {
+	const button = document.createElement("button");
+
+	expect(isTableInteractiveElement(button)).toBe(true);
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`react-hook-test`,children:`React hook test`}),`
+`,(0,c.jsx)(t.p,{children:`Проверяйте пользовательское поведение, а не implementation details:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`изменение `,(0,c.jsx)(t.code,{children:`selectionMode`}),` очищает/сужает selection;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`исчезнувший `,(0,c.jsx)(t.code,{children:`availableRowId`}),` удаляется;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`canSelect: false`}),` блокирует активацию;`]}),`
+`,(0,c.jsx)(t.li,{children:`callback получает исходные rows;`}),`
+`,(0,c.jsxs)(t.li,{children:[`controlled `,(0,c.jsx)(t.code,{children:`selectedRowIds`}),` синхронизирует визуальный state.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте React testing library и `,(0,c.jsx)(t.code,{children:`act`}),`, если test напрямую вызывает state update.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-ещё-проверять-в-host`,children:`Что ещё проверять в host`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`row/column ids остаются стабильными после sort;`}),`
+`,(0,c.jsx)(t.li,{children:`DnD не двигает locked/pinned headers;`}),`
+`,(0,c.jsx)(t.li,{children:`button в ячейке не меняет row selection;`}),`
+`,(0,c.jsx)(t.li,{children:`keyboard activation доступна;`}),`
+`,(0,c.jsx)(t.li,{children:`tree orphan/cycle diagnostics наблюдаемы;`}),`
+`,(0,c.jsx)(t.li,{children:`synthetic rows не читаются как обычные business facts;`}),`
+`,(0,c.jsx)(t.li,{children:`server paging не выдаётся за полный dataset.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h2,{id:`полная-карта-api-table`,children:[`Полная карта API `,(0,c.jsx)(t.code,{children:`table`})]}),`
+`,(0,c.jsx)(t.p,{children:`Все имена из этого раздела импортируются из:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`"@ryuzaki13/react-foundation-lib/table";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`layout`,children:`Layout`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableColumnLayoutItem<TColumnId, TWidth>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsxs)(t.td,{children:[`элемент `,(0,c.jsx)(t.code,{children:`{ id, width }`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ResolveTableColumnOrderArgs<TColumnId>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`аргументы восстановления порядка`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BuildTableColumnLayoutArgs<TColumnId, TWidth>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsxs)(t.td,{children:[`ids и `,(0,c.jsx)(t.code,{children:`getWidth`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveTableColumnOrder`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`сохранённый order + новые актуальные ids`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildTableColumnLayout`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`строит layout по ids и width resolver`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`column-order`,children:`Column order`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReorderTableHeaderColumnsArgs`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`DnD input contract`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableColumnOrderState`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsxs)(t.td,{children:[`mutable-массив `,(0,c.jsx)(t.code,{children:`string[]`}),` для state`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTableColumnOrder`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`удаляет пустые и повторяющиеся id`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`reorderTableHeaderColumns`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`вычисляет следующий top-level order`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveReorderedTableHeaderColumns`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`возвращает change или `,(0,c.jsx)(t.code,{children:`null`})]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`column-sizing`,children:`Column sizing`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableColumnSizingState`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Record<columnId, widthPx>`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`DEFAULT_TABLE_COLUMN_MIN_WIDTH`})}),(0,c.jsx)(t.td,{children:`constant`}),(0,c.jsxs)(t.td,{children:[`default minimum `,(0,c.jsx)(t.code,{children:`60`}),` px`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTableColumnWidth`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`finite integer width не меньше minimum`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTableColumnSizing`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`очищает весь sizing state`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`patchTableColumnWidth`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`immutable add/update одной ширины`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`removeTableColumnWidth`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`immutable delete одной ширины`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`row-selection`,children:`Row selection`}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                           | Вид        | Назначение                             |
+| ----------------------------- | ---------- | -------------------------------------- | ------ | ------ |
+| `,(0,c.jsx)(t.code,{children:`TableSelectionMode`}),`          | type       | `,(0,c.jsx)(t.code,{children:`none                                  | single | multi`}),` |
+| `,(0,c.jsx)(t.code,{children:`areTableRowSelectionsEqual`}),`  | function   | сравнивает активные row ids            |
+| `,(0,c.jsx)(t.code,{children:`normalizeTableSelectionMode`}),` | function   | normalizes unknown config value        |
+| `,(0,c.jsx)(t.code,{children:`pruneTableRowSelection`}),`      | function   | удаляет недоступный/лишний selection   |
+| `,(0,c.jsx)(t.code,{children:`toggleTableRowSelection`}),`     | function   | вычисляет state после активации        |
+| `,(0,c.jsx)(t.code,{children:`useTableRowSelection`}),`        | React hook | state, controlled sync и rows callback |`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`RowSelectionState`}),` принадлежит `,(0,c.jsx)(t.code,{children:`@tanstack/react-table`}),` и не реэкспортируется этим модулем.`]}),`
+`,(0,c.jsx)(t.h3,{id:`cell-selection`,children:`Cell selection`}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                         | Вид      | Назначение                           |
+| ------------------------------------------- | -------- | ------------------------------------ | ----------------- |
+| `,(0,c.jsx)(t.code,{children:`TableCellSelectionMode`}),`                    | type     | cardinality выбора ячеек             |
+| `,(0,c.jsx)(t.code,{children:`TableCellSelectionActivationMode`}),`          | type     | `,(0,c.jsx)(t.code,{children:`direct                              | primary-modifier`}),` |
+| `,(0,c.jsx)(t.code,{children:`TableCellCoordinates`}),`                      | type     | `,(0,c.jsx)(t.code,{children:`rowId + columnId`}),`                   |
+| `,(0,c.jsx)(t.code,{children:`TableCellSelectionState`}),`                   | type     | readonly-массив координат            |
+| `,(0,c.jsx)(t.code,{children:`TableSelectionModifierEvent`}),`               | type     | минимальный modifier event contract  |
+| `,(0,c.jsx)(t.code,{children:`areTableCellSelectionsEqual`}),`               | function | set-equality координат               |
+| `,(0,c.jsx)(t.code,{children:`pruneTableCellSelection`}),`                   | function | фильтрует, дедуплицирует и сортирует |
+| `,(0,c.jsx)(t.code,{children:`toggleTableCellSelection`}),`                  | function | включает/выключает координату        |
+| `,(0,c.jsx)(t.code,{children:`normalizeTableCellSelectionActivationMode`}),` | function | нормализует activation config        |
+| `,(0,c.jsx)(t.code,{children:`shouldActivateTableCellSelection`}),`          | function | проверяет direct/Ctrl/Command flow   |`]}),`
+`,(0,c.jsx)(t.h3,{id:`column-contracts`,children:`Column contracts`}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                              | Вид       | Назначение                                        |
+| -------------------------------- | --------- | ------------------------------------------------- | ------ | ------ |
+| `,(0,c.jsx)(t.code,{children:`TableColumnAlign`}),`               | type      | `,(0,c.jsx)(t.code,{children:`left                                             | center | right`}),` |
+| `,(0,c.jsx)(t.code,{children:`TableColumnFormattingMeta`}),`      | type      | runtime formatting config с optional id/role/type |
+| `,(0,c.jsx)(t.code,{children:`TableColumnFormattingMetaInput`}),` | type      | custom formatting без auto id/role/type           |
+| `,(0,c.jsx)(t.code,{children:`TableColumnMeta`}),`                | interface | width, align, mergeDuplicates, formatting         |
+| `,(0,c.jsx)(t.code,{children:`TableColumnDef<TData, TValue>`}),`  | type      | foundation TanStack column definition             |
+| `,(0,c.jsx)(t.code,{children:`TableColumnVisibilityState`}),`     | type      | TanStack v9 visibility state                      |`]}),`
+`,(0,c.jsx)(t.h3,{id:`tanstack-foundation-types`,children:`TanStack foundation types`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`foundationTableFeatures`})}),(0,c.jsx)(t.td,{children:`constant`}),(0,c.jsx)(t.td,{children:`единый runtime features object`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableFeatures`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`тип features object`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableInstance<TData>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Table instance`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableRow<TData>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`runtime row`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableColumn<TData, TValue>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`runtime column`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableCell<TData, TValue>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`runtime cell`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableHeader<TData, TValue>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`runtime header`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FoundationTableState`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`полное состояние features`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`odata-adapter`,children:`OData adapter`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`CreateTableColumnsFromODataMetadataOptions`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`header/formatting resolvers`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`EnrichTableColumnsWithODataFormattingOptions`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`custom metadata lookup`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`CreateTableColumnVisibilityFromODataMetadataOptions`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`custom visibility resolver`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveTableColumnFormattingContextFromODataColumn`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`OData property → role/type`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveStableColumnId`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`explicit id или accessorKey`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createTableColumnVisibilityFromODataMetadata`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`стартовый visibility state`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createTableColumnsFromODataMetadata`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`metadata → generated columns`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`enrichTableColumnsWithODataFormatting`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`metadata → existing leaf columns`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`small-runtime-helpers`,children:`Small runtime helpers`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getTableColumnMeta`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`читает `,(0,c.jsx)(t.code,{children:`column.meta`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getTableColumnFormattingMeta`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`читает `,(0,c.jsx)(t.code,{children:`column.meta.formatting`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveTableLength`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`число → `,(0,c.jsx)(t.code,{children:`em`}),`, строка без изменений`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isTableInteractiveElement`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`распознаёт nested interactive target`})]})]})]}),`
+`,(0,c.jsxs)(t.h2,{id:`полная-карта-api-tree-table`,children:[`Полная карта API `,(0,c.jsx)(t.code,{children:`tree-table`})]}),`
+`,(0,c.jsx)(t.p,{children:`Все имена из этого раздела импортируются из:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`"@ryuzaki13/react-foundation-lib/tree-table";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`построение-дерева`,children:`Построение дерева`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TreeTableFlatHierarchy<TData>`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`getters row id и parent id`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TreeTableRowNode<TData>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`строка с optional recursive children`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TreeTableBuildResult<TData>`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`tree, indexes и diagnostics`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildTreeTableRows`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`flat id/parent rows → nested forest`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`транспонирование`,children:`Транспонирование`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вид`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TreeTableTransposedRowMeta`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`пять служебных полей`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TreeTableTransposedRow<TData>`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`business row + service metadata`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TreeTableTransposeFlatRowsLevel`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`один hierarchy column level`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TreeTableTransposeFlatRowsOptions`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`массив levels`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`facts → synthetic groups + leaves`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`constants-служебных-полей`,children:`Constants служебных полей`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Значение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_ROW_ID_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"__treeTableRowId"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_PARENT_ROW_ID_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"__treeTableParentRowId"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_LABEL_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"__treeTableLabel"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_LEVEL_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"__treeTableLevel"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_SYNTHETIC_FIELD`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"__treeTableSynthetic"`})})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`типичные-ошибки`,children:`Типичные ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`импортировать-всё-из-package-root`,children:`Импортировать всё из package root`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неверно.
+import { TableColumnDef } from "@ryuzaki13/react-foundation-lib";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте точный subpath и `,(0,c.jsx)(t.code,{children:`import type`}),` для типа.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ожидать-react-component-от-table`,children:[`Ожидать React component от `,(0,c.jsx)(t.code,{children:`table`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`// Такого компонента в lib entrypoint нет.
+<Table data={rows} />
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Визуальный primitive принадлежит UI-пакету или host.`}),`
+`,(0,c.jsx)(t.h3,{id:`использовать-индекс-как-row-id`,children:`Использовать индекс как row id`}),`
+`,(0,c.jsx)(t.p,{children:`После sort selection укажет на другую запись. Используйте business key.`}),`
+`,(0,c.jsx)(t.h3,{id:`мутировать-state`,children:`Мутировать state`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`selection[rowId] = true;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте helper или React setter с новым объектом.`}),`
+`,(0,c.jsx)(t.h3,{id:`путать-width-в-metadata-и-sizing-state`,children:`Путать width в metadata и sizing state`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const column = {
+	meta: {
+		width: 120
+	}
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Здесь `,(0,c.jsx)(t.code,{children:`120em`}),`, а не `,(0,c.jsx)(t.code,{children:`120px`}),`. Resize px храните в `,(0,c.jsx)(t.code,{children:`TableColumnSizingState`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`считать-normalizetablecolumnorder-полным-restore`,children:[`Считать `,(0,c.jsx)(t.code,{children:`normalizeTableColumnOrder`}),` полным restore`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Она не знает актуальные columns и не удаляет stale id. Для restore используйте `,(0,c.jsx)(t.code,{children:`resolveTableColumnOrder`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`пытаться-переставить-pinned-header`,children:`Пытаться переставить pinned header`}),`
+`,(0,c.jsx)(t.p,{children:`Текущий helper блокирует любое перемещение, если active или over id pinned.`}),`
+`,(0,c.jsx)(t.h3,{id:`ожидать-одинаковый-toggle-у-row-и-cell-single-mode`,children:`Ожидать одинаковый toggle у row и cell single mode`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`single row повторным кликом не снимается;`}),`
+`,(0,c.jsx)(t.li,{children:`single cell повторной активацией снимается.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это разные публичные семантики.`}),`
+`,(0,c.jsxs)(t.h3,{id:`передать-child-id-в-headerids`,children:[`Передать child id в `,(0,c.jsx)(t.code,{children:`headerIds`})]}),`
+`,(0,c.jsx)(t.p,{children:`Helper предназначен для top-level headers. Group child не должен быть самостоятельной DnD целью.`}),`
+`,(0,c.jsxs)(t.h3,{id:`забыть-rowbyid`,children:[`Забыть `,(0,c.jsx)(t.code,{children:`rowById`})]}),`
+`,(0,c.jsx)(t.p,{children:`Без актуальной записи hook не сможет вернуть исходный row в callback.`}),`
+`,(0,c.jsx)(t.h3,{id:`читать-synthetic-row-как-fact`,children:`Читать synthetic row как fact`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const amount = row.AMOUNT;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сначала проверьте `,(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_SYNTHETIC_FIELD`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ожидать-totals-от-transpose`,children:`Ожидать totals от transpose`}),`
+`,(0,c.jsx)(t.p,{children:`Synthetic group rows не агрегируют measures.`}),`
+`,(0,c.jsx)(t.h3,{id:`полагаться-на-generated-leaf-id-после-reorder`,children:`Полагаться на generated leaf id после reorder`}),`
+`,(0,c.jsx)(t.p,{children:`Он содержит индекс input row и может измениться.`}),`
+`,(0,c.jsx)(t.h3,{id:`игнорировать-diagnostics-дерева`,children:`Игнорировать diagnostics дерева`}),`
+`,(0,c.jsx)(t.p,{children:`Orphans, duplicates и cycles не выбрасывают exception. Данные остаются видимыми, а проблема сообщается массивами result.`}),`
+`,(0,c.jsxs)(t.h3,{id:`использовать-children-как-business-field`,children:[`Использовать `,(0,c.jsx)(t.code,{children:`children`}),` как business field`]}),`
+`,(0,c.jsx)(t.p,{children:`Поле зарезервировано nested tree shape и может быть заменено.`}),`
+`,(0,c.jsxs)(t.h3,{id:`считать-expandbydefault-side-effect`,children:[`Считать `,(0,c.jsx)(t.code,{children:`expandByDefault`}),` side effect`]}),`
+`,(0,c.jsx)(t.p,{children:`Transpose его не применяет. Expansion принадлежит UI state.`}),`
+`,(0,c.jsx)(t.h3,{id:`транспонировать-уже-готовое-idparent-дерево`,children:`Транспонировать уже готовое id/parent дерево`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если backend уже прислал отношения, сразу вызывайте `,(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),`. Transpose добавит ненужные synthetic nodes.`]}),`
+`,(0,c.jsx)(t.h3,{id:`выполнять-client-sorting-одной-server-page`,children:`Выполнять client sorting одной server page`}),`
+`,(0,c.jsx)(t.p,{children:`Пользователь увидит порядок только внутри загруженного фрагмента. Отправляйте sort backend owner.`}),`
+`,(0,c.jsx)(t.h2,{id:`частые-вопросы`,children:`Частые вопросы`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-один-readme-описывает-два-импорта`,children:`Почему один README описывает два импорта?`}),`
+`,(0,c.jsx)(t.p,{children:`Потому что concepts и интеграция общие, но package boundaries разные. Это уменьшает дублирование объяснений и не создаёт новый barrel.`}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-импортировать-buildtreetablerows-из-table`,children:[`Можно ли импортировать `,(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),` из `,(0,c.jsx)(t.code,{children:`/table`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Используйте `,(0,c.jsx)(t.code,{children:`/tree-table`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-импортировать-tablecolumndef-из-tree-table`,children:[`Можно ли импортировать `,(0,c.jsx)(t.code,{children:`TableColumnDef`}),` из `,(0,c.jsx)(t.code,{children:`/tree-table`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Используйте `,(0,c.jsx)(t.code,{children:`/table`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`нужно-ли-использовать-tanstack-table`,children:`Нужно ли использовать TanStack Table?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`foundationTableFeatures`}),` и `,(0,c.jsx)(t.code,{children:`FoundationTable*`}),` типов — да. Pure order/sizing/selection/tree helpers можно использовать с другим UI, если их state contract подходит.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-использовать-react-для-tree-table`,children:[`Нужно ли использовать React для `,(0,c.jsx)(t.code,{children:`tree-table`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Обе tree functions pure. React нужен только downstream UI и hook из `,(0,c.jsx)(t.code,{children:`/table`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-buildtreetablerows-возвращает-forest-а-не-один-root`,children:[`Почему `,(0,c.jsx)(t.code,{children:`buildTreeTableRows`}),` возвращает forest, а не один root?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В реальных данных может быть несколько roots, orphan или циклическая компонента. `,(0,c.jsx)(t.code,{children:`rows`}),` поэтому всегда массив.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-orphan-не-удаляется`,children:`Почему orphan не удаляется?`}),`
+`,(0,c.jsx)(t.p,{children:`Потеря строки скрыла бы проблему и данные. Helper поднимает её в root и отдельно сообщает id.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-duplicate-использует-первое-вхождение`,children:`Почему duplicate использует первое вхождение?`}),`
+`,(0,c.jsx)(t.p,{children:`Это детерминированное правило, сохраняющее исходный порядок. Но duplicate всё равно означает нарушение data contract.`}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-изменить-имя-поля-children`,children:[`Можно ли изменить имя поля `,(0,c.jsx)(t.code,{children:`children`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет, параметра для этого нет. Если нужен другой shape, преобразуйте result на host boundary или используйте собственный builder.`}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-передать-readonlymap-в-usetablerowselection`,children:[`Можно ли передать `,(0,c.jsx)(t.code,{children:`ReadonlyMap`}),` в `,(0,c.jsx)(t.code,{children:`useTableRowSelection`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Сигнатура ожидает `,(0,c.jsx)(t.code,{children:`Map<string, TData>`}),`. Создайте обычный `,(0,c.jsx)(t.code,{children:`Map`}),` и не мутируйте его после передачи в текущем render.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-prunetablerowselection-удалил-выбор-другой-страницы`,children:[`Почему `,(0,c.jsx)(t.code,{children:`pruneTableRowSelection`}),` удалил выбор другой страницы?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Потому что id не было в `,(0,c.jsx)(t.code,{children:`availableRowIds`}),`. Определите корректную область availability для своего сценария.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-resolvestablecolumnid-вернул-undefined`,children:[`Почему `,(0,c.jsx)(t.code,{children:`resolveStableColumnId`}),` вернул `,(0,c.jsx)(t.code,{children:`undefined`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`У колонки нет непустого строкового `,(0,c.jsx)(t.code,{children:`id`}),` и строкового `,(0,c.jsx)(t.code,{children:`accessorKey`}),`. Для `,(0,c.jsx)(t.code,{children:`accessorFn`}),` добавьте explicit id.`]}),`
+`,(0,c.jsx)(t.h3,{id:`odata-adapter-выполняет-formatting-значения`,children:`OData adapter выполняет formatting значения?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Он только добавляет formatting metadata. Значение форматирует downstream runtime из модуля `,(0,c.jsx)(t.code,{children:`formatters`}),`/UI.`]}),`
+`,(0,c.jsx)(t.h3,{id:`odata-adapter-выполняет-sorting-и-filtering`,children:`OData adapter выполняет sorting и filtering?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Он создаёт column definitions и visibility. Server operations принадлежат API/feature owner.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-numeric-odata-property-становится-measure`,children:`Почему numeric OData property становится measure?`}),`
+`,(0,c.jsx)(t.p,{children:`Adapter принудительно классифицирует поддерживаемые числовые types как measures, чтобы получить ожидаемые formatting и right alignment.`}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-сохранить-tablecolumndef-в-json`,children:[`Можно ли сохранить `,(0,c.jsx)(t.code,{children:`TableColumnDef[]`}),` в JSON?`]}),`
+`,(0,c.jsx)(t.p,{children:`Обычно нет: columns могут содержать functions и React renderers. Сохраняйте только serializable state по column id.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-пробелы-в-rowcolumn-id`,children:`Можно ли использовать пробелы в row/column id?`}),`
+`,(0,c.jsx)(t.p,{children:`Технически да, но helpers не выполняют общий trimming. Канонические id без случайных пробелов безопаснее для persistence и equality.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-whitespace-level-создаёт-group`,children:`Почему whitespace level создаёт group?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустым считается только `,(0,c.jsx)(t.code,{children:`null`}),`, `,(0,c.jsx)(t.code,{children:`undefined`}),` и точная пустая строка. Нормализуйте business data до transpose, если пробелы должны считаться пустотой.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`tree_table_transposed_level_field-равен-глубине`,children:[(0,c.jsx)(t.code,{children:`TREE_TABLE_TRANSPOSED_LEVEL_FIELD`}),` равен глубине?`]}),`
+`,(0,c.jsx)(t.p,{children:`Только когда все предыдущие levels непустые. При пропущенном промежуточном level он сохраняет исходный индекс level. Для визуального depth используйте tree runtime.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-выбирать-synthetic-groups`,children:`Можно ли выбирать synthetic groups?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Технически да: у них есть row id. Разрешать это или нет — business/UI policy. Проверяйте synthetic flag в `,(0,c.jsx)(t.code,{children:`getRowCanSelect`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-diagnostics-как-полную-graph-validation`,children:`Можно ли использовать diagnostics как полную graph validation?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Они предназначены для устойчивого UI-построения. Для строгой проверки всех участников cycles, duplicate occurrences и схемы данных нужен отдельный validator.`}),`
+`,(0,c.jsx)(t.h3,{id:`есть-ли-глобальная-инициализация-или-cleanup`,children:`Есть ли глобальная инициализация или cleanup?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Pure helpers stateless. React hook живёт в lifecycle component.`}),`
+`,(0,c.jsx)(t.h2,{id:`связанные-модули`,children:`Связанные модули`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/array`}),` — массивы, нормализация и reorder primitives;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`}),` — форматирование значений и table pipeline;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formulas`}),` — client formulas для table rows;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata-service`}),` — OData metadata и query-option builders;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/virtualizer`}),` — дозагрузка infinite data по virtual range;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`}),` — transport и TanStack Query operations;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-ui/table`}),` — визуальная плоская таблица;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-ui/tree-table`}),` — визуальная древовидная таблица.`]}),`
+`]})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};