@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.13

package/storybook-static/assets/README-BmYpfZKr.js

@@ -0,0 +1,1844 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,blockquote:`blockquote`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,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/API/OData Service`}),`
+`,(0,c.jsx)(t.h1,{id:`odata-service`,children:`OData Service`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata-service`}),` — единая библиотечная точка входа для работы с техническими контрактами OData V2:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`чтения XML metadata сервиса;`}),`
+`,(0,c.jsx)(t.li,{children:`описания сущностей, колонок, параметров и Function Import;`}),`
+`,(0,c.jsx)(t.li,{children:`преобразования JavaScript-значений в OData literals и обратно;`}),`
+`,(0,c.jsx)(t.li,{children:`построения path для EntitySet и Function Import;`}),`
+`,(0,c.jsxs)(t.li,{children:[`построения `,(0,c.jsx)(t.code,{children:`$filter`}),` и `,(0,c.jsx)(t.code,{children:`$orderby`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`нормализации конфигурации пользовательских фильтров;`}),`
+`,(0,c.jsx)(t.li,{children:`поиска пар «код + текст» в справочных коллекциях;`}),`
+`,(0,c.jsx)(t.li,{children:`хранения общих настроек OData-справочников.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`README рассчитан на разработчика без доступа к исходному коду и с минимальным знанием JavaScript/TypeScript. В примерах объясняется не только вызов функции, но и смысл входных данных, результат, ограничения и типичные ошибки.`}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[`Ранее helpers справочных коллекций публиковались через отдельный subpath `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata`}),`. Теперь этот код входит в `,(0,c.jsx)(t.code,{children:`odata-service`}),`. Старый subpath удалён без compatibility alias.`]}),`
+`]}),`
+`,(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:`#%D1%87%D1%82%D0%BE-%D0%B4%D0%B5%D0%BB%D0%B0%D0%B5%D1%82-%D0%B8-%D1%87%D0%B5%D0%B3%D0%BE-%D0%BD%D0%B5-%D0%B4%D0%B5%D0%BB%D0%B0%D0%B5%D1%82-%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8C`,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:`#%D0%B7%D0%B0%D0%B2%D0%B8%D1%81%D0%B8%D0%BC%D0%BE%D1%81%D1%82%D0%B8-%D0%B8-%D1%81%D1%80%D0%B5%D0%B4%D0%B0-%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F`,children:`Зависимости и среда выполнения`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#odata-v2-%D0%BF%D1%80%D0%BE%D1%81%D1%82%D1%8B%D0%BC%D0%B8-%D1%81%D0%BB%D0%BE%D0%B2%D0%B0%D0%BC%D0%B8`,children:`OData V2 простыми словами`})}),`
+`,(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`,children:`Быстрый старт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D0%B1%D1%89%D0%B8%D0%B9-%D0%BC%D0%B0%D1%80%D1%88%D1%80%D1%83%D1%82-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85`,children:`Общий маршрут данных`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D0%B0%D0%B7%D0%BE%D0%B2%D1%8B%D0%B5-%D1%82%D0%B8%D0%BF%D1%8B`,children:`Базовые типы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D1%82%D0%B5%D0%BD%D0%B8%D0%B5-metadata`,children:`Чтение metadata`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B8%D0%BF%D1%8B-%D1%80%D0%B5%D0%B7%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%82%D0%B0-metadata`,children:`Типы результата metadata`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-odata-%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B9`,children:`Форматирование OData-значений`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%B0%D1%80%D1%81%D0%B8%D0%BD%D0%B3-%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B9`,children:`Парсинг значений`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D1%8F-%D0%BF%D0%BE-%D1%83%D0%BC%D0%BE%D0%BB%D1%87%D0%B0%D0%BD%D0%B8%D1%8E-%D0%B8-formatter-registry`,children:`Значения по умолчанию и formatter registry`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#wrapped-%D0%B8-unwrapped-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B`,children:`Wrapped и unwrapped параметры`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%BE%D0%B2-%D0%B8-path`,children:`Построение параметров и path`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%BE%D1%81%D1%82%D1%8B%D0%B5-odata-%D1%84%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D1%8B`,children:`Простые OData-фильтры`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#compiled-filter-definitions`,children:`Compiled filter definitions`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D1%81%D0%BE%D1%80%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-orderby`,children:[`Сортировка и `,(0,c.jsx)(t.code,{children:`$orderby`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#sql-like-%D1%84%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D1%8B`,children:`SQL-like фильтры`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%B0%D1%80%D1%8B-%D0%BA%D0%BE%D0%B4--%D1%82%D0%B5%D0%BA%D1%81%D1%82`,children:`Пары «код + текст»`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8-odata-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B9`,children:`Настройки OData-коллекций`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BC%D0%B0%D0%BB%D0%B5%D0%BD%D1%8C%D0%BA%D0%B8%D0%B5-helpers`,children:`Маленькие helpers`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8-%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C-%D0%B8-%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F`,children:`Ошибки, безопасность и ограничения`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#ssr-%D0%B1%D1%80%D0%B0%D1%83%D0%B7%D0%B5%D1%80-%D0%B8-react`,children:`SSR, браузер и React`})}),`
+`,(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%BC%D0%B8%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D1%81-odata`,children:[`Миграция с `,(0,c.jsx)(t.code,{children:`/odata`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(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`,children:`Полная карта API`})}),`
+`,(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.jsx)(t.h3,{id:`делает`,children:`Делает`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль выполняет локальные, предсказуемые преобразования:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`XML metadata ──> ServiceMetadata
+JS value     ──> OData literal
+params       ──> operation path
+filter tree  ──> строка $filter
+sort state   ──> строка $orderby
+rows         ──> пары code/text
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Большая часть функций не обращается к сети и не знает адрес backend.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-делает`,children:`Не делает`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не выполняет HTTP-запросы и не управляет транспортом:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`не вызывает `,(0,c.jsx)(t.code,{children:`fetch`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не добавляет SAP SSO credentials;`}),`
+`,(0,c.jsx)(t.li,{children:`не получает и не обновляет X-CSRF token;`}),`
+`,(0,c.jsx)(t.li,{children:`не формирует TanStack Query keys;`}),`
+`,(0,c.jsx)(t.li,{children:`не хранит server response cache;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняет mutations;`}),`
+`,(0,c.jsx)(t.li,{children:`не знает бизнес-правила конкретной таблицы или feature.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для транспорта используйте отдельный пакет:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {} from /* transport API */ "@ryuzaki13/react-foundation-api/odata";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Граница пакетов выглядит так:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`react-foundation-lib/odata-service
+  metadata, types, values, path, filter, sort
+                    │
+                    ▼
+react-foundation-api/odata
+  HTTP, SAP Gateway, SSO, X-CSRF, Query/Mutation
+                    │
+                    ▼
+host entity / feature / widget
+  бизнес-правила, экран, пользовательский сценарий
+`})}),`
+`,(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.jsx)(t.p,{children:`Для полного entrypoint также разрешите совместимые peer dependencies, если package manager не сделал этого автоматически:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install zod zustand immer @tanstack/react-query
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Импортируйте API только из опубликованного subpath:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	buildEntityOperationPath,
+	buildODataFilter,
+	buildODataOrderBy,
+	odataFormatValue,
+	parseServiceMetadata
+} from "@ryuzaki13/react-foundation-lib/odata-service";
+
+import type {
+	EntityMetadata,
+	FilterExpression,
+	ServiceMetadata,
+	WrappedODataParameters
+} from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте корневой или приватный импорт:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неверно: корневой entrypoint не опубликован.
+import { buildODataFilter } from "@ryuzaki13/react-foundation-lib";
+
+// Неверно: внутреннее расположение файлов не является публичным контрактом.
+import { buildODataFilter } from "@ryuzaki13/react-foundation-lib/dist/odata-service/filters";
+
+// Неверно: прежний subpath удалён после объединения модулей.
+import { findCollectionPairs } from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`import-type-для-typescript-типов`,children:[(0,c.jsx)(t.code,{children:`import type`}),` для TypeScript-типов`]}),`
+`,(0,c.jsxs)(t.p,{children:[`TypeScript-типы исчезают из JavaScript после сборки. Для них предпочтителен `,(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 { ServiceMetadata } from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычные функции и constants требуют обычного `,(0,c.jsx)(t.code,{children:`import`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { parseServiceMetadata } from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`зависимости-и-среда-выполнения`,children:`Зависимости и среда выполнения`}),`
+`,(0,c.jsxs)(t.p,{children:[`После объединения один entrypoint содержит и pure helpers, и Zustand store. Поэтому host, который импортирует `,(0,c.jsx)(t.code,{children:`odata-service`}),`, должен уметь разрешить runtime dependencies entrypoint.`]}),`
+`,(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:`zod`})}),(0,c.jsx)(t.td,{children:`Runtime-проверка OData primitive values и аргументов formatter factories.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`react`})}),(0,c.jsx)(t.td,{children:`Runtime для React-oriented Zustand hook API.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`zustand`})}),(0,c.jsx)(t.td,{children:`Глобальный store настроек OData-коллекций.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`immer`})}),(0,c.jsx)(t.td,{children:`Middleware для обновления Zustand store.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@tanstack/react-query`})}),(0,c.jsxs)(t.td,{children:[`Тип и helper `,(0,c.jsx)(t.code,{children:`unwrapODataQueryResult`}),`.`]})]})]})]}),`
+`,(0,c.jsx)(t.p,{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:`Где можно использовать`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Форматирование, filters, sorts, builders`}),(0,c.jsx)(t.td,{children:`Browser и Node.js, если не вызывается browser-only API.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parseServiceMetadata`})}),(0,c.jsxs)(t.td,{children:[`Среда с глобальным `,(0,c.jsx)(t.code,{children:`DOMParser`}),`; обычно browser или DOM-полифил в Node.js.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`useODataCollectionStore`}),`, `,(0,c.jsx)(t.code,{children:`odataCollectionConfig`})]}),(0,c.jsx)(t.td,{children:`React/browser runtime; selector hooks вызываются по правилам React hooks.`})]})]})]}),`
+`,(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.h2,{id:`odata-v2-простыми-словами`,children:`OData V2 простыми словами`}),`
+`,(0,c.jsx)(t.h3,{id:`сервис`,children:`Сервис`}),`
+`,(0,c.jsx)(t.p,{children:`OData service — набор HTTP endpoints, объединённых общей схемой. Например:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/sap/opu/odata/sap/REPORT_SRV
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`ODataServiceConfig`}),` имя сервиса хранится без предположений о полном origin:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const config = {
+	service: "REPORT_SRV",
+	target: "Sales"
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`metadata`,children:`Metadata`}),`
+`,(0,c.jsx)(t.p,{children:`Metadata — XML-документ, описывающий структуру сервиса:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`какие сущности существуют;`}),`
+`,(0,c.jsx)(t.li,{children:`какие поля есть у сущности;`}),`
+`,(0,c.jsx)(t.li,{children:`какой тип у каждого поля;`}),`
+`,(0,c.jsx)(t.li,{children:`какие параметры обязательны;`}),`
+`,(0,c.jsx)(t.li,{children:`какие Function Import доступны;`}),`
+`,(0,c.jsx)(t.li,{children:`какое поле является текстом для code-поля.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычно metadata получает transport-слой, а `,(0,c.jsx)(t.code,{children:`parseServiceMetadata`}),` превращает XML в удобный JavaScript-объект.`]}),`
+`,(0,c.jsx)(t.h3,{id:`entityset-и-entitytype`,children:`EntitySet и EntityType`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`EntityType`}),` описывает форму записи, например поля `,(0,c.jsx)(t.code,{children:`ID`}),`, `,(0,c.jsx)(t.code,{children:`NAME`}),`, `,(0,c.jsx)(t.code,{children:`AMOUNT`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`EntitySet`}),` — адресуемая коллекция записей этого типа, например `,(0,c.jsx)(t.code,{children:`Sales`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В config свойство `,(0,c.jsx)(t.code,{children:`target`}),` обычно содержит имя EntitySet.`]}),`
+`,(0,c.jsx)(t.h3,{id:`function-import`,children:`Function Import`}),`
+`,(0,c.jsx)(t.p,{children:`Function Import — операция OData V2, похожая на именованный backend-метод. Она может принимать query parameters и иметь HTTP method из metadata.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/REPORT_SRV/Recalculate?p_year=2026
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`параметр-и-literal`,children:`Параметр и literal`}),`
+`,(0,c.jsx)(t.p,{children:`JavaScript-строку нельзя бездумно вставлять в OData URL. Backend ожидает OData literal:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`JavaScript:  O'Reilly
+OData:       'O''Reilly'
+
+JavaScript:  true
+OData ABAP:  'X'
+
+JavaScript:  12.5
+Edm.Decimal: 12.5M
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataFormatValue`}),` знает эти правила, а builder применяет их в metadata-порядке.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`filter-и-orderby`,children:[(0,c.jsx)(t.code,{children:`$filter`}),` и `,(0,c.jsx)(t.code,{children:`$orderby`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`$filter`}),` ограничивает записи:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`STATUS eq 'A' and AMOUNT ge 100M
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`$orderby`}),` задаёт сортировку:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`YEAR asc,AMOUNT desc
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль строит только значение query option. Передачу в HTTP request выполняет transport.`}),`
+`,(0,c.jsx)(t.h3,{id:`codetext-pair`,children:`Code/text pair`}),`
+`,(0,c.jsx)(t.p,{children:`SAP-сервисы часто возвращают технический код и читаемый текст разными полями:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  COMPANY: "1000",
+  COMPANY_txt: "Основная организация"
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`findCollectionPairs`}),` находит такие пары, а `,(0,c.jsx)(t.code,{children:`buildSeparatedArrays`}),` создаёт из rows отдельные справочные массивы.`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.p,{children:`Представим, что transport уже получил XML metadata как строку.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	buildEntityOperationPath,
+	buildODataFilter,
+	buildODataOrderBy,
+	createFilterEqual,
+	parseServiceMetadata,
+	wrapODataParams
+} from "@ryuzaki13/react-foundation-lib/odata-service";
+
+type SalesRow = {
+	COMPANY: string;
+	YEAR: number;
+	AMOUNT: number;
+};
+
+const serviceMetadata = parseServiceMetadata(metadataXml);
+const salesMetadata = serviceMetadata.entities.Sales;
+
+if (!salesMetadata) {
+	throw new Error("В metadata отсутствует EntitySet Sales");
+}
+
+const params = wrapODataParams({
+	p_company: "1000",
+	p_year: 2026
+});
+
+const path = buildEntityOperationPath(salesMetadata, { service: "REPORT_SRV", target: "Sales" }, params, "query");
+
+const filter = buildODataFilter(createFilterEqual<SalesRow, string>("COMPANY", "1000"));
+
+const orderBy = buildODataOrderBy<SalesRow>([], [{ key: "AMOUNT", desc: true }]);
+
+console.log(path);
+console.log(filter); // COMPANY eq '1000'
+console.log(orderBy); // AMOUNT desc
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Transport затем использует `,(0,c.jsx)(t.code,{children:`path`}),`, `,(0,c.jsx)(t.code,{children:`filter`}),` и `,(0,c.jsx)(t.code,{children:`orderBy`}),` при создании request. Сам `,(0,c.jsx)(t.code,{children:`odata-service`}),` request не отправляет.`]}),`
+`,(0,c.jsx)(t.h2,{id:`общий-маршрут-данных`,children:`Общий маршрут данных`}),`
+`,(0,c.jsx)(t.p,{children:`Для большинства экранов полезен такой порядок:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Transport загружает metadata XML.`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`parseServiceMetadata`}),` создаёт `,(0,c.jsx)(t.code,{children:`ServiceMetadata`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Consumer выбирает `,(0,c.jsx)(t.code,{children:`entities[target]`}),` или `,(0,c.jsx)(t.code,{children:`functionImports[target]`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Значения формы оборачиваются через `,(0,c.jsx)(t.code,{children:`wrapODataParams`}),` или сразу создаются как `,(0,c.jsx)(t.code,{children:`{ value }`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Builder проверяет параметры по metadata и создаёт path.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Filter helpers создают `,(0,c.jsx)(t.code,{children:`$filter`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Sort helpers создают `,(0,c.jsx)(t.code,{children:`$orderby`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`API-пакет выполняет HTTP request.`}),`
+`,(0,c.jsxs)(t.li,{children:[`UI форматирует ответ через `,(0,c.jsx)(t.code,{children:`formatters`}),`/table pipeline, а не через path builder.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`metadata XML
+    │ parseServiceMetadata
+    ▼
+ServiceMetadata ──────────────┐
+                             │
+form values ─ wrap params ───┼─> path builder ─┐
+                             │                 │
+filter values ─ compile ─────┼─> $filter ──────┼─> API transport
+                             │                 │
+sort state ──────────────────┴─> $orderby ─────┘
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`базовые-типы`,children:`Базовые типы`}),`
+`,(0,c.jsx)(t.h3,{id:`basemetatype`,children:(0,c.jsx)(t.code,{children:`BaseMetaType`})}),`
+`,(0,c.jsx)(t.p,{children:`UI работает с четырьмя укрупнёнными типами:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type BaseMetaType = "string" | "number" | "boolean" | "date";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Constants и helpers:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	BASE_META_TYPES,
+	BASE_META_TYPE_LABELS,
+	isBaseMetaType,
+	resolveBaseTypeLabel
+} from "@ryuzaki13/react-foundation-lib/odata-service";
+
+console.log(BASE_META_TYPES);
+// ["string", "number", "boolean", "date"]
+
+console.log(BASE_META_TYPE_LABELS.number); // "число"
+console.log(isBaseMetaType("date")); // true
+console.log(isBaseMetaType("datetime")); // false
+console.log(resolveBaseTypeLabel("boolean")); // "boolean"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`datetime`}),` — OData type, а `,(0,c.jsx)(t.code,{children:`date`}),` — укрупнённый UI type. Это разные уровни модели.`]}),`
+`,(0,c.jsx)(t.h3,{id:`odatametatype`,children:(0,c.jsx)(t.code,{children:`ODataMetaType`})}),`
+`,(0,c.jsx)(t.p,{children:`Поддерживаемые нормализованные OData-типы:`}),`
+`,(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:`Значения TypeScript`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`String-like`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`"string"`}),`, `,(0,c.jsx)(t.code,{children:`"guid"`}),`, `,(0,c.jsx)(t.code,{children:`"binary"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Numeric`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`"byte"`}),`, `,(0,c.jsx)(t.code,{children:`"int"`}),`, `,(0,c.jsx)(t.code,{children:`"long"`}),`, `,(0,c.jsx)(t.code,{children:`"float"`}),`, `,(0,c.jsx)(t.code,{children:`"decimal"`}),`, `,(0,c.jsx)(t.code,{children:`"double"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Boolean`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"boolean"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Date/time`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`"datetime"`}),`, `,(0,c.jsx)(t.code,{children:`"datetimeOffset"`}),`, `,(0,c.jsx)(t.code,{children:`"time"`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Связанные типы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataBooleanType = "boolean";
+type ODataNumericType = "byte" | "int" | "long" | "float" | "decimal" | "double";
+type ODataIntegerType = "byte" | "int" | "long";
+type ODataDateType = "datetime" | "datetimeOffset" | "time";
+type ODataStringType = "string" | "guid" | "binary";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Type guards не проверяют значение поля. Они проверяют только строку типа:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isODataBooleanType("boolean"); // true
+isODataNumericType("decimal"); // true
+isODataIntegerType("float"); // false
+isODataDateType("datetime"); // true
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`getbasetypefromodatatype`,children:(0,c.jsx)(t.code,{children:`getBaseTypeFromODataType`})}),`
+`,(0,c.jsx)(t.p,{children:`Преобразует подробный OData type в укрупнённый UI type:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getBaseTypeFromODataType("guid"); // "string"
+getBaseTypeFromODataType("decimal"); // "number"
+getBaseTypeFromODataType("boolean"); // "boolean"
+getBaseTypeFromODataType("datetimeOffset"); // "date"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`http-и-operation-types`,children:`HTTP и operation types`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type BaseMethod = "GET" | "POST" | "PUT" | "DELETE";
+
+type ODataOperationMethod = "create" | "update" | "delete" | "read" | "query" | "fi";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ODataOperationMethod`}),` описывает намерение consumer-кода. Это не готовый HTTP method. Например, Function Import отдельно хранит `,(0,c.jsx)(t.code,{children:`httpMethod`}),` из metadata.`]}),`
+`,(0,c.jsx)(t.h2,{id:`чтение-metadata`,children:`Чтение metadata`}),`
+`,(0,c.jsx)(t.h3,{id:`parseservicemetadata`,children:(0,c.jsx)(t.code,{children:`parseServiceMetadata`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function parseServiceMetadata(xmlText: string): ServiceMetadata;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция принимает полный EDMX/XML текст и возвращает:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ServiceMetadata = {
+	entities: Record<string, EntityMetadata>;
+	functionImports: Record<string, FunctionImportMetadata>;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const metadata = parseServiceMetadata(xmlText);
+
+const entity = metadata.entities.Sales;
+const action = metadata.functionImports.Recalculate;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если имя неизвестно, результат обращения по ключу будет `,(0,c.jsx)(t.code,{children:`undefined`}),`. Проверяйте это явно до использования:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const entity = metadata.entities[target];
+
+if (!entity) {
+	throw new Error(\`EntitySet \${target} отсутствует в metadata\`);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`какие-xml-типы-поддерживаются`,children:`Какие XML-типы поддерживаются`}),`
+`,(0,c.jsx)(t.p,{children:`Parser нормализует следующие EDM-типы:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`EDMX`}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`ODataMetaType`})})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.String`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Guid`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`guid`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Boolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Byte`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`byte`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`Edm.Int16`}),`, `,(0,c.jsx)(t.code,{children:`Edm.Int32`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`int`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Int64`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`long`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Single`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`float`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Decimal`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`decimal`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Double`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`double`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.DateTime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetime`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.DateTimeOffset`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetimeOffset`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Time`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`time`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Edm.Binary`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`binary`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Неподдерживаемый scalar EDM type приводит к ошибке. Это намеренное поведение: неизвестный тип нельзя безопасно сериализовать как строку по догадке.`}),`
+`,(0,c.jsx)(t.h3,{id:`nullable-mandatory-и-параметры`,children:`Nullable, mandatory и параметры`}),`
+`,(0,c.jsx)(t.p,{children:`Parser учитывает несколько источников обязательности:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Nullable="false"`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`SAP attribute `,(0,c.jsx)(t.code,{children:`sap:parameter="mandatory"`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`key-поля параметризованной сущности;`}),`
+`,(0,c.jsx)(t.li,{children:`action-for key для Function Import.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для Function Import поддерживаются входные scalar параметры. Параметры с неподдерживаемым mode или не-scalar типом отклоняются.`}),`
+`,(0,c.jsx)(t.h3,{id:`abap-boolean-like-string`,children:`ABAP boolean-like string`}),`
+`,(0,c.jsxs)(t.p,{children:[`Строковое поле `,(0,c.jsx)(t.code,{children:`Edm.String`}),` с `,(0,c.jsx)(t.code,{children:`MaxLength="1"`}),` помечается:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`abapBooleanLike: true;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это не превращает metadata type в `,(0,c.jsx)(t.code,{children:`boolean`}),`. Маркер нужен `,(0,c.jsx)(t.code,{children:`odataParseValueByMetadata`}),`, чтобы значения `,(0,c.jsx)(t.code,{children:`"X"`}),`, `,(0,c.jsx)(t.code,{children:`" "`}),` и `,(0,c.jsx)(t.code,{children:`""`}),` читать как boolean.`]}),`
+`,(0,c.jsx)(t.h3,{id:`колонки-роли-и-codetext`,children:`Колонки, роли и code/text`}),`
+`,(0,c.jsx)(t.p,{children:`Parser определяет:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`label`}),` из SAP metadata с fallback на id;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`sortable`}),` и `,(0,c.jsx)(t.code,{children:`filterable`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`аналитическую роль `,(0,c.jsx)(t.code,{children:`measure`}),` или `,(0,c.jsx)(t.code,{children:`dimension`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`семантику `,(0,c.jsx)(t.code,{children:`none`}),`, `,(0,c.jsx)(t.code,{children:`code`}),` или `,(0,c.jsx)(t.code,{children:`text`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`linkedColumnId`}),` для пары code/text.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Связь code/text ищется по SAP attribute и распространённым suffixes `,(0,c.jsx)(t.code,{children:`_txt`}),`, `,(0,c.jsx)(t.code,{children:`_text`}),`, `,(0,c.jsx)(t.code,{children:`_t`}),`. Дополнительно существуют проектные forced ids:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`FORCED_CODE_TEXT_IDS; // Set с "ZDIV" и "ZCFO1"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Helpers:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveMetadataColumnLabel({ id: "BUKRS", label: "" }); // "BUKRS"
+isForcedCodeTextId("ZDIV"); // true
+isForcedCodeTextFamilyId("zdiv_txt"); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сравнение forced family выполняется без учёта регистра.`}),`
+`,(0,c.jsx)(t.h3,{id:`filterable-columns`,children:`Filterable columns`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const columns = collectFilterableColumns(entity.columns);
+const ids = collectFilterableColumnsIds(entity.columns);
+
+console.log(ids.has("COMPANY"));
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`collectFilterableColumns`}),` возвращает новый массив только с `,(0,c.jsx)(t.code,{children:`filterable: true`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`collectFilterableColumnsIds`}),` возвращает readonly `,(0,c.jsx)(t.code,{children:`Set<string>`}),`, удобный для быстрых проверок.`]}),`
+`,(0,c.jsx)(t.h3,{id:`важные-ограничения-parser`,children:`Важные ограничения parser`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Нужен глобальный `,(0,c.jsx)(t.code,{children:`DOMParser`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Функция не загружает metadata по URL.`}),`
+`,(0,c.jsx)(t.li,{children:`Функция не кеширует результат.`}),`
+`,(0,c.jsx)(t.li,{children:`Функция не проверяет server data rows по metadata.`}),`
+`,(0,c.jsx)(t.li,{children:`Complex types не превращаются в обычные filterable scalar columns.`}),`
+`,(0,c.jsx)(t.li,{children:`Служебные result-wrapper сущности могут быть скрыты из итоговой карты, а их columns перенесены к публичной parameterized entity.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Entity type с именем, заканчивающимся на `,(0,c.jsx)(t.code,{children:`Type`}),`, без result navigation не считается автоматически параметризованным.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`типы-результата-metadata`,children:`Типы результата metadata`}),`
+`,(0,c.jsx)(t.h3,{id:`entityparameterproperty`,children:(0,c.jsx)(t.code,{children:`EntityParameterProperty`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type EntityParameterProperty = {
+	id: string;
+	label: string;
+	type: ODataMetaType;
+	originalType: string;
+	abapBooleanLike?: true;
+	nullable?: true;
+	mandatory?: true;
+	maxLength?: number;
+	precision?: number;
+	scale?: number;
+	parameter?: string;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обратите внимание на optional flags: отсутствие `,(0,c.jsx)(t.code,{children:`mandatory`}),` означает «не отмечен обязательным», а не обязательно явное `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`entitycolumnproperty`,children:(0,c.jsx)(t.code,{children:`EntityColumnProperty`})}),`
+`,(0,c.jsx)(t.p,{children:`Колонка содержит основную информацию параметра и UI/runtime metadata:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type EntityColumnProperty = {
+	id: string;
+	label: string;
+	type: ODataMetaType;
+	originalType: string;
+	abapBooleanLike?: true;
+	maxLength?: number;
+	precision?: number;
+	scale?: number;
+	parameter?: string;
+	linkedColumnId?: string;
+	semanticType: "none" | "code" | "text";
+	sortable: boolean;
+	filterable: boolean;
+	role: "measure" | "dimension";
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`entitymetadata`,children:(0,c.jsx)(t.code,{children:`EntityMetadata`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type EntityMetadata = {
+	title: string;
+	columns: EntityColumnProperty[];
+	parameters?: EntityParameterProperty[];
+	result?: "Set" | "Results";
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`result`}),` задаёт navigation segment для параметризованной сущности.`]}),`
+`,(0,c.jsx)(t.h3,{id:`functionimportmetadata`,children:(0,c.jsx)(t.code,{children:`FunctionImportMetadata`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FunctionImportMetadata = {
+	name: string;
+	title: string;
+	httpMethod?: "GET" | "POST" | "PUT" | "DELETE";
+	parameters?: EntityParameterProperty[];
+	returnType: string;
+	entitySet?: string;
+	actionFor?: string;
+	resultEntity?: string;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`остальные-metadata-типы`,children:`Остальные metadata-типы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ServiceEntities = Record<string, EntityMetadata>;
+type ServiceFunctionImports = Record<string, FunctionImportMetadata>;
+type ODataTargetMetadata = EntityMetadata | FunctionImportMetadata;
+
+type EntityPropertyBase = {
+	id: string;
+	label: string;
+};
+
+type EntityPropertyBaseWithType = EntityPropertyBase & {
+	type: ODataMetaType;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ODataTargetMetadata`}),` удобен для generic UI, который умеет показывать как entity, так и Function Import.`]}),`
+`,(0,c.jsx)(t.h2,{id:`форматирование-odata-значений`,children:`Форматирование OData-значений`}),`
+`,(0,c.jsx)(t.h3,{id:`odataformatvalue`,children:(0,c.jsx)(t.code,{children:`odataFormatValue`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function odataFormatValue(type: ODataMetaType, value: unknown): string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция сначала проверяет значение через Zod schema соответствующего типа, затем создаёт OData literal.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataFormatValue("string", "O'Reilly");
+// 'O''Reilly'
+
+odataFormatValue("boolean", true);
+// 'X'
+
+odataFormatValue("decimal", 12.5);
+// 12.5M
+`})}),`
+`,(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:`Тип`}),(0,c.jsx)(t.th,{children:`Допустимое JavaScript-значение`}),(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:`string`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`'Текст'`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`guid`})}),(0,c.jsxs)(t.td,{children:[`UUID или строка из hex-символов и `,(0,c.jsx)(t.code,{children:`-`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`guid'550e8400-e29b-41d4-a716-446655440000'`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`true`}),` → `,(0,c.jsx)(t.code,{children:`'X'`}),`, `,(0,c.jsx)(t.code,{children:`false`}),` → `,(0,c.jsx)(t.code,{children:`' '`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`byte`})}),(0,c.jsxs)(t.td,{children:[`integer `,(0,c.jsx)(t.code,{children:`0..255`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`255`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`int`})}),(0,c.jsx)(t.td,{children:`integer`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`42`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`long`})}),(0,c.jsx)(t.td,{children:`integer`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`42L`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`float`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`number`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`12.5F`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`decimal`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`number`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`12.5M`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`double`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`number`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`12.5D`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetime`})}),(0,c.jsxs)(t.td,{children:[`valid `,(0,c.jsx)(t.code,{children:`Date`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetime'2026-08-18T10:30:00'`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetimeOffset`})}),(0,c.jsxs)(t.td,{children:[`valid `,(0,c.jsx)(t.code,{children:`Date`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetimeoffset'2026-08-18T05:30:00.000Z'`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`time`})}),(0,c.jsxs)(t.td,{children:[`valid `,(0,c.jsx)(t.code,{children:`Date`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`time'PT10H30M00S'`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`binary`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`binary'BASE64...'`})})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`строки-и-одинарные-кавычки`,children:`Строки и одинарные кавычки`}),`
+`,(0,c.jsx)(t.p,{children:`Одинарная кавычка внутри OData string literal удваивается:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataFormatValue("string", "Иванов 'Тест'");
+// 'Иванов ''Тест'''
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не экранируйте строку вручную перед вызовом. Иначе кавычки будут удвоены повторно.`}),`
+`,(0,c.jsx)(t.h3,{id:`boolean-в-sapabap-форме`,children:`Boolean в SAP/ABAP форме`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`boolean`}),` сериализуется не как `,(0,c.jsx)(t.code,{children:`true`}),`/`,(0,c.jsx)(t.code,{children:`false`}),`, а как ABAP-like char:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataFormatValue("boolean", true); // "'X'"
+odataFormatValue("boolean", false); // "' '"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если конкретный endpoint ждёт `,(0,c.jsx)(t.code,{children:`0`}),`/`,(0,c.jsx)(t.code,{children:`1`}),`, выберите custom formatter из registry или передайте собственный formatter в wrapped parameter.`]}),`
+`,(0,c.jsx)(t.h3,{id:`даты-и-timezone`,children:`Даты и timezone`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ODataDateFormat`}),` предоставляет три formatter-а:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`ODataDateFormat.datetime(date);
+ODataDateFormat.datetimeOffset(date);
+ODataDateFormat.time(date);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Их семантика различается:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`datetime`}),` использует видимые локальные календарные компоненты `,(0,c.jsx)(t.code,{children:`Date`}),` без suffix timezone;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`datetimeOffset`}),` вызывает `,(0,c.jsx)(t.code,{children:`date.toISOString()`}),` и поэтому сериализует UTC-время с `,(0,c.jsx)(t.code,{children:`Z`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`time`}),` использует локальные компоненты времени как ISO duration `,(0,c.jsx)(t.code,{children:`PT...`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не заменяйте один тип другим только потому, что оба принимают `,(0,c.jsx)(t.code,{children:`Date`}),`. Выбирайте тип из metadata endpoint.`]}),`
+`,(0,c.jsx)(t.h3,{id:`runtime-validation`,children:`Runtime validation`}),`
+`,(0,c.jsxs)(t.p,{children:[`Некорректное значение приводит к `,(0,c.jsx)(t.code,{children:`Error`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataFormatValue("int", 1.5);
+// Error: значение не является integer
+
+odataFormatValue("byte", 300);
+// Error: значение больше 255
+
+odataFormatValue("datetime", "2026-08-18");
+// Error: ожидался Date, а не string
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Основные schemas доступны напрямую:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = odataTypeSchemas.decimal.safeParse(12.5);
+
+if (!result.success) {
+	console.error(result.error);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`guid`}),` принимает canonical UUID и более мягкую строку, содержащую только hex-символы и дефисы. Не считайте этот schema полной бизнес-проверкой UUID, если backend требует конкретную версию/форму.`]}),`
+`,(0,c.jsx)(t.h3,{id:`primitive-guards`,children:`Primitive guards`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isStringSafe("A"); // true
+isNumberSafe(10); // true
+isNumberSafe("10"); // false
+isBooleanSafe(false); // true
+isDateSafe(new Date()); // true для valid Date
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Guards ничего не преобразуют. Например, `,(0,c.jsx)(t.code,{children:`isNumberSafe("10")`}),` не парсит строку.`]}),`
+`,(0,c.jsx)(t.h2,{id:`парсинг-значений`,children:`Парсинг значений`}),`
+`,(0,c.jsx)(t.h3,{id:`odataparsevalue`,children:(0,c.jsx)(t.code,{children:`odataParseValue`})}),`
+`,(0,c.jsx)(t.p,{children:`Преобразует raw server/control value в JavaScript-представление по нормализованному OData type.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataParseValue("boolean", "X"); // true
+odataParseValue("boolean", " "); // false
+odataParseValue("int", "1 234"); // 1234
+odataParseValue("datetime", "2026-08-18"); // Date или null по правилам date parser
+odataParseValue("string", 123); // "123"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`boolean-parsing`,children:`Boolean parsing`}),`
+`,(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:`Input`}),(0,c.jsx)(t.th,{children:`Result`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`true`}),`, `,(0,c.jsx)(t.code,{children:`false`})]}),(0,c.jsx)(t.td,{children:`то же boolean`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`1`}),`, `,(0,c.jsx)(t.code,{children:`"1"`}),`, `,(0,c.jsx)(t.code,{children:`"true"`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`true`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`"0"`}),`, `,(0,c.jsx)(t.code,{children:`"false"`})]}),(0,c.jsx)(t.td,{children:(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:`"X"`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`true`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`" "`}),`, `,(0,c.jsx)(t.code,{children:`""`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Регистр учитывается только для ABAP `,(0,c.jsx)(t.code,{children:`"X"`}),`: именно uppercase `,(0,c.jsx)(t.code,{children:`X`}),` распознаётся напрямую. Обычные `,(0,c.jsx)(t.code,{children:`true`}),`/`,(0,c.jsx)(t.code,{children:`false`}),` приводятся к lower case после `,(0,c.jsx)(t.code,{children:`trim`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если значение не распознано, функция возвращает исходное значение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataParseValue("boolean", "maybe"); // "maybe"
+odataParseValue("boolean", 2); // 2
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому результат нельзя без проверки безусловно присвоить переменной `,(0,c.jsx)(t.code,{children:`boolean`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`numbers-и-dates`,children:`Numbers и dates`}),`
+`,(0,c.jsxs)(t.p,{children:[`Numeric types делегируют parsing общему `,(0,c.jsx)(t.code,{children:`parseNumber`}),`, а date/time types — общему `,(0,c.jsx)(t.code,{children:`parseDate`}),` из `,(0,c.jsx)(t.code,{children:`formatters`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это означает:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`строковые числа могут быть преобразованы;`}),`
+`,(0,c.jsx)(t.li,{children:`невалидное число не обязано приводить к exception;`}),`
+`,(0,c.jsxs)(t.li,{children:[`результат даты может быть `,(0,c.jsx)(t.code,{children:`Date`}),`, `,(0,c.jsx)(t.code,{children:`null`}),` или исходным/промежуточным значением согласно date parser contract.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для форматирования данных в UI используйте `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`}),`, а не `,(0,c.jsx)(t.code,{children:`odataParseValue`}),` как display formatter.`]}),`
+`,(0,c.jsx)(t.h3,{id:`string-like-types`,children:`String-like types`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`string`}),`, `,(0,c.jsx)(t.code,{children:`guid`}),` и `,(0,c.jsx)(t.code,{children:`binary`}),` используют `,(0,c.jsx)(t.code,{children:`String(value)`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataParseValue("string", null); // "null"
+odataParseValue("string", undefined); // "undefined"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`null`}),` должен остаться `,(0,c.jsx)(t.code,{children:`null`}),`, отфильтруйте его до вызова.`]}),`
+`,(0,c.jsx)(t.h3,{id:`odataparsevaluebymetadata`,children:(0,c.jsx)(t.code,{children:`odataParseValueByMetadata`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataParseValueByMetadata({ type: "string", abapBooleanLike: true }, "X"); // true
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Дополнительные правила для `,(0,c.jsx)(t.code,{children:`abapBooleanLike`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` → `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`"X"`}),` → `,(0,c.jsx)(t.code,{children:`true`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`" "`}),` и `,(0,c.jsx)(t.code,{children:`""`}),` → `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`другое строковое значение проходит обычный parsing типа;`}),`
+`,(0,c.jsx)(t.li,{children:`non-string значение не считается ABAP char и тоже проходит обычный parsing.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Например, boolean `,(0,c.jsx)(t.code,{children:`true`}),` при descriptor type `,(0,c.jsx)(t.code,{children:`string`}),` в итоге станет строкой `,(0,c.jsx)(t.code,{children:`"true"`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`значения-по-умолчанию-и-formatter-registry`,children:`Значения по умолчанию и formatter registry`}),`
+`,(0,c.jsx)(t.h3,{id:`defaultodatatypevalue`,children:(0,c.jsx)(t.code,{children:`defaultODataTypeValue`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`defaultODataTypeValue("boolean"); // false
+defaultODataTypeValue("decimal"); // 0
+defaultODataTypeValue("datetime"); // новый Date
+defaultODataTypeValue("string"); // ""
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для каждого вызова date/time создаётся новый `,(0,c.jsx)(t.code,{children:`Date`}),` с текущим моментом. Не используйте функцию как стабильную constant.`]}),`
+`,(0,c.jsx)(t.h3,{id:`defaultcontroltypevalue`,children:(0,c.jsx)(t.code,{children:`defaultControlTypeValue`})}),`
+`,(0,c.jsxs)(t.p,{children:[`То же правило на уровне `,(0,c.jsx)(t.code,{children:`BaseMetaType`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`defaultControlTypeValue("boolean"); // false
+defaultControlTypeValue("number"); // 0
+defaultControlTypeValue("date"); // новый Date
+defaultControlTypeValue("string"); // ""
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это технический default, а не утверждение, что пустое поле пользователя должно иметь `,(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`false`}),` или текущую дату. Решение о null/empty принадлежит форме и бизнес-сценарию.`]}),`
+`,(0,c.jsx)(t.h3,{id:`formatter-description`,children:`Formatter description`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataFormatterDescription = {
+	id: string;
+	label: string;
+	description: string;
+	fn: (...args: unknown[]) => string;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Registry нужен UI-редактору mapping, где пользователь выбирает способ сериализации.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const items = getFormattersFor("datetime");
+
+for (const item of items) {
+	console.log(item.id, item.label);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Доступные ids:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Base type`}),(0,c.jsx)(t.th,{children:`Id`}),(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:`date`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`base`})}),(0,c.jsxs)(t.td,{children:[`OData `,(0,c.jsx)(t.code,{children:`datetime`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`date`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetimeOffset`})}),(0,c.jsxs)(t.td,{children:[`OData `,(0,c.jsx)(t.code,{children:`datetimeoffset`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`date`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`time`})}),(0,c.jsxs)(t.td,{children:[`OData `,(0,c.jsx)(t.code,{children:`time`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`date`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stringAbapDate`})}),(0,c.jsxs)(t.td,{children:[`Строка ABAP `,(0,c.jsx)(t.code,{children:`YYYYMMDD`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`base`})}),(0,c.jsxs)(t.td,{children:[`ABAP boolean `,(0,c.jsx)(t.code,{children:`'X'`}),`/`,(0,c.jsx)(t.code,{children:`' '`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`asChar`})}),(0,c.jsxs)(t.td,{children:[`Строка `,(0,c.jsx)(t.code,{children:`'0'`}),`/`,(0,c.jsx)(t.code,{children:`'1'`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`asByte`})}),(0,c.jsxs)(t.td,{children:[`Число `,(0,c.jsx)(t.code,{children:`0`}),`/`,(0,c.jsx)(t.code,{children:`1`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`base`})}),(0,c.jsx)(t.td,{children:`Экранированная OData string`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`number`})}),(0,c.jsx)(t.td,{children:`—`}),(0,c.jsx)(t.td,{children:`Встроенных registry formatter-ов нет`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`API поиска:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getFormattersFor("datetime");
+getFormattersForBaseType("date");
+getFormatter("boolean", "asByte");
+getFormatterForBaseType("boolean", "asChar");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getFormattersFor*`}),` возвращает массив с `,(0,c.jsx)(t.code,{children:`id`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getFormatter*`}),` возвращает внутреннее описание конкретного элемента без добавленного поля `,(0,c.jsx)(t.code,{children:`id`}),` либо `,(0,c.jsx)(t.code,{children:`undefined`}),`, если id отсутствует.`]}),`
+`,(0,c.jsx)(t.h3,{id:`formatter-factories`,children:`Formatter factories`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const joinStrings = createStringFormatter((...values) => {
+	return \`'\${values.join("-")}'\`;
+});
+
+joinStrings("A", "B"); // 'A-B'
+joinStrings("A", 10); // Error validation
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Фабрики:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`createFormatter(schema, fn)`}),` — общий Zod-validated wrapper;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`createBooleanFormatter(fn)`}),` — все аргументы обязаны быть boolean;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`createStringFormatter(fn)`}),` — все аргументы обязаны быть string;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`createNumberFormatter(fn)`}),` — все аргументы обязаны быть number;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`createDateFormatter(fn)`}),` — все аргументы обязаны быть valid `,(0,c.jsx)(t.code,{children:`Date`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Фабрика проверяет весь массив аргументов при каждом вызове. Она не проверяет, что возвращённая строка действительно является корректным OData literal; это ответственность функции `,(0,c.jsx)(t.code,{children:`fn`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`wrapped-и-unwrapped-параметры`,children:`Wrapped и unwrapped параметры`}),`
+`,(0,c.jsxs)(t.h3,{id:`зачем-нужна-обёртка--value-`,children:[`Зачем нужна обёртка `,(0,c.jsx)(t.code,{children:`{ value }`})]}),`
+`,(0,c.jsx)(t.p,{children:`Плоские параметры удобны для формы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const flat = {
+	p_company: "1000",
+	p_year: 2026
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Builder принимает wrapped форму, потому что каждому параметру можно назначить formatter:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const wrapped = {
+	p_company: { value: "1000" },
+	p_year: { value: 2026 },
+	p_date: {
+		value: selectedDate,
+		formatter: ODataDateFormat.datetime
+	}
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Основные типы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataParameterValue = BaseType | BaseType[];
+
+type ODataValue<T extends ODataParameterValue = ODataParameterValue> = {
+	value: T;
+	formatter?: (...args: unknown[]) => string;
+};
+
+type UnwrappedODataParameters = Record<string, ODataParameterValue>;
+type WrappedODataParameters = Record<string, ODataValue>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`InputValue`}),`, `,(0,c.jsx)(t.code,{children:`UnwrappedInputParameters`}),` и `,(0,c.jsx)(t.code,{children:`WrappedInputParameters`}),` — аналогичные generic UI-контракты поверх `,(0,c.jsx)(t.code,{children:`InputType`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`wrapodataparams`,children:(0,c.jsx)(t.code,{children:`wrapODataParams`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const wrapped = wrapODataParams({
+	p_zero: 0,
+	p_enabled: false,
+	p_empty: ""
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  p_zero: { value: 0 },
+  p_enabled: { value: false },
+  p_empty: { value: "" }
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция сохраняет `,(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`false`}),`, пустую строку и `,(0,c.jsx)(t.code,{children:`null`}),` буквально. Она не форматирует и не нормализует значения.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`null`}),` или `,(0,c.jsx)(t.code,{children:`undefined`}),` вместо всего объекта возвращается пустой объект.`]}),`
+`,(0,c.jsx)(t.h3,{id:`unwrapodataparams`,children:(0,c.jsx)(t.code,{children:`unwrapODataParams`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`unwrapODataParams({
+	z: { value: false },
+	a: { value: undefined }
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  a: null,
+  z: false
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`ключи сортируются по имени;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`undefined`}),` внутри параметра превращается в `,(0,c.jsx)(t.code,{children:`null`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`formatter`}),` отбрасывается;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`отсутствующий аргумент даёт `,(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`преобразование shallow: вложенные значения не клонируются.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Generic types `,(0,c.jsx)(t.code,{children:`WrapODataParameters<T>`}),` и `,(0,c.jsx)(t.code,{children:`UnwrapODataParameters<T>`}),` помогают сохранить имена и типы keys на этапе TypeScript.`]}),`
+`,(0,c.jsx)(t.h2,{id:`построение-параметров-и-path`,children:`Построение параметров и path`}),`
+`,(0,c.jsx)(t.h3,{id:`buildparameterentries`,children:(0,c.jsx)(t.code,{children:`buildParameterEntries`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function buildParameterEntries(
+	metadata: { parameters?: EntityParameterProperty[] },
+	params: WrappedODataParameters
+): Array<[string, string]>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция идёт по `,(0,c.jsx)(t.code,{children:`metadata.parameters`}),`, а не по keys объекта `,(0,c.jsx)(t.code,{children:`params`}),`. Поэтому:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`порядок результата совпадает с metadata;`}),`
+`,(0,c.jsxs)(t.li,{children:[`лишние keys в `,(0,c.jsx)(t.code,{children:`params`}),` игнорируются;`]}),`
+`,(0,c.jsx)(t.li,{children:`отсутствующий optional параметр пропускается;`}),`
+`,(0,c.jsxs)(t.li,{children:[`отсутствующий mandatory параметр приводит к `,(0,c.jsx)(t.code,{children:`Error`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const entries = buildParameterEntries(
+	{
+		parameters: [
+			{ id: "p_company", label: "Компания", type: "string", originalType: "Edm.String", mandatory: true },
+			{ id: "p_year", label: "Год", type: "int", originalType: "Edm.Int32" }
+		]
+	},
+	{
+		p_company: { value: "1000" },
+		p_year: { value: 2026 }
+	}
+);
+
+// [["p_company", "'1000'"], ["p_year", "2026"]]
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`mandatory-и-optional`,children:`Mandatory и optional`}),`
+`,(0,c.jsxs)(t.p,{children:[`Только `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` считаются отсутствием:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	value: 0;
+} // присутствует
+{
+	value: false;
+} // присутствует
+{
+	value: "";
+} // присутствует и будет отформатировано как ''
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`массивы`,children:`Массивы`}),`
+`,(0,c.jsx)(t.p,{children:`Обычный OData parameter является scalar. Поэтому массив разрешён только вместе с custom formatter:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const params = {
+	p_ids: {
+		value: ["A", "B"],
+		formatter: (value: unknown) => {
+			const values = value as string[];
+			return \`'\${values.join(",")}'\`;
+		}
+	}
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Без formatter builder выбросит ошибку «Массив значений OData-параметра требует custom formatter».`}),`
+`,(0,c.jsx)(t.h3,{id:`maxlength`,children:(0,c.jsx)(t.code,{children:`maxLength`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если parameter metadata содержит `,(0,c.jsx)(t.code,{children:`maxLength`}),`, builder ожидает literal в одинарных кавычках и проверяет число символов внутри них.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это важно:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`string literal проверяется;`}),`
+`,(0,c.jsxs)(t.li,{children:[`custom formatter тоже обязан вернуть `,(0,c.jsx)(t.code,{children:`'...'`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`numeric literal при наличии `,(0,c.jsx)(t.code,{children:`maxLength`}),` не пройдёт проверку, потому что не заключён в кавычки.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Сообщение любой formatting-ошибки дополняется id параметра.`}),`
+`,(0,c.jsx)(t.h3,{id:`buildentityparameters`,children:(0,c.jsx)(t.code,{children:`buildEntityParameters`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const value = buildEntityParameters(entityMetadata, params);
+// (p_company='1000',p_year=2026)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждый уже отформатированный literal проходит через `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),`. Не применяйте `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),` к value заранее.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если параметров нет, функция возвращает пустую строку.`}),`
+`,(0,c.jsx)(t.h3,{id:`buildfunctionimportparameters`,children:(0,c.jsx)(t.code,{children:`buildFunctionImportParameters`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает стандартный `,(0,c.jsx)(t.code,{children:`URLSearchParams`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const searchParams = buildFunctionImportParameters(functionMetadata, params);
+console.log(searchParams.toString());
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Values сначала форматируются как OData literals, затем передаются в `,(0,c.jsx)(t.code,{children:`URLSearchParams`}),`. Не сравнивайте вручную raw query string, если порядок/encoding можно проверить через `,(0,c.jsx)(t.code,{children:`searchParams.get`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`odataserviceconfig`,children:(0,c.jsx)(t.code,{children:`ODataServiceConfig`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataServiceConfig = {
+	service: string;
+	target: string;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функции не очищают `,(0,c.jsx)(t.code,{children:`/`}),` и не валидируют имена. Передавайте именно ожидаемые segments без query string.`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildentitypath`,children:(0,c.jsx)(t.code,{children:`buildEntityPath`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`buildEntityPath(metadata, config, params);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Формат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/{service}/{target}{parameters}/{result}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`/{result}`}),` добавляется только если metadata содержит `,(0,c.jsx)(t.code,{children:`result: "Set" | "Results"`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildentityoperationpath`,children:(0,c.jsx)(t.code,{children:`buildEntityOperationPath`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`buildEntityOperationPath(metadata, config, params, method);
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Method`}),(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:`create`})}),(0,c.jsxs)(t.td,{children:[`Возвращает только `,(0,c.jsx)(t.code,{children:`/{service}/{target}`}),`; params игнорируются.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`query`}),` для обычной entity`]}),(0,c.jsx)(t.td,{children:`Возвращает base path; params игнорируются.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`query`}),` для parameterized entity`]}),(0,c.jsxs)(t.td,{children:[`Добавляет параметры и `,(0,c.jsx)(t.code,{children:`/Set`}),` либо `,(0,c.jsx)(t.code,{children:`/Results`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`read`}),`, `,(0,c.jsx)(t.code,{children:`update`}),`, `,(0,c.jsx)(t.code,{children:`delete`})]}),(0,c.jsx)(t.td,{children:`Добавляет entity parameters, но не result navigation.`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`В development-сборке `,(0,c.jsx)(t.code,{children:`query`}),` с params для обычной entity пишет `,(0,c.jsx)(t.code,{children:`console.warn`}),`, потому что target не поддерживает parameterized query.`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildfunctionimportpath`,children:(0,c.jsx)(t.code,{children:`buildFunctionImportPath`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const path = buildFunctionImportPath(functionMetadata, config, params);
+// /REPORT_SRV/Recalculate?p_year=2026
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если serializable parameters нет, `,(0,c.jsx)(t.code,{children:`?`}),` не добавляется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`path-не-является-полным-url`,children:`Path не является полным URL`}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат начинается с `,(0,c.jsx)(t.code,{children:`/`}),`, но не содержит:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`origin;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`/sap/opu/odata/sap`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`$filter`}),`, `,(0,c.jsx)(t.code,{children:`$orderby`}),`, `,(0,c.jsx)(t.code,{children:`$select`}),`, `,(0,c.jsx)(t.code,{children:`$expand`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`HTTP method и body;`}),`
+`,(0,c.jsx)(t.li,{children:`authentication headers.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Соединять path с transport base URL должен API-слой.`}),`
+`,(0,c.jsx)(t.h2,{id:`простые-odata-фильтры`,children:`Простые OData-фильтры`}),`
+`,(0,c.jsx)(t.h3,{id:`два-этапа`,children:`Два этапа`}),`
+`,(0,c.jsx)(t.p,{children:`Фильтр строится в два этапа:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Создать типизированное дерево `,(0,c.jsx)(t.code,{children:`FilterExpression`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Сериализовать дерево через `,(0,c.jsx)(t.code,{children:`buildODataFilter`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Row = {
+	STATUS: string;
+	AMOUNT: number;
+};
+
+const expression = createFilterEqual<Row, string>("STATUS", "A");
+const filter = buildODataFilter(expression);
+
+console.log(filter); // STATUS eq 'A'
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не собирайте `,(0,c.jsx)(t.code,{children:`$filter`}),` конкатенацией пользовательских строк. Formatter должен экранировать values.`]}),`
+`,(0,c.jsx)(t.h3,{id:`операции`,children:`Операции`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`FilterOperation.eq; // "eq"
+FilterOperation.ne; // "ne"
+FilterOperation.gt; // "gt"
+FilterOperation.ge; // "ge"
+FilterOperation.lt; // "lt"
+FilterOperation.le; // "le"
+FilterOperation.startswith; // "startswith"
+FilterOperation.endswith; // "endswith"
+FilterOperation.contains; // "contains"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`FILTER_OPERATIONS`}),` — readonly массив всех значений.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isFilterOperation("contains"); // true
+isFilterOperation("in"); // false
+
+resolveOperationLabel("ge"); // "больше или равно"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`структура-выражения`,children:`Структура выражения`}),`
+`,(0,c.jsx)(t.p,{children:`Leaf содержит conditions:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FilterCondition<T> = {
+	key: keyof T;
+	value: BaseType;
+	operation?: FilterOperation;
+	type?: ODataMetaType;
+};
+
+type FilterConditionExpression<T> = {
+	and?: boolean;
+	conditions: FilterCondition<T>[];
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Nested node содержит другие filters:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FilterNestedExpression<T> = {
+	and?: boolean;
+	filters: FilterExpression<T>[];
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Один node не может одновременно содержать `,(0,c.jsx)(t.code,{children:`conditions`}),` и `,(0,c.jsx)(t.code,{children:`filters`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`значение-and`,children:[`Значение `,(0,c.jsx)(t.code,{children:`and`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`По умолчанию `,(0,c.jsx)(t.code,{children:`and`}),` отсутствует или равно `,(0,c.jsx)(t.code,{children:`false`}),`. Это означает OR:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	conditions: [
+		{ key: "STATUS", value: "A" },
+		{ key: "STATUS", value: "B" }
+	];
+}
+// (STATUS eq 'A' or STATUS eq 'B')
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для AND укажите `,(0,c.jsx)(t.code,{children:`and: true`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  and: true,
+  conditions: [
+    { key: "AMOUNT", operation: "ge", value: 100, type: "decimal" },
+    { key: "AMOUNT", operation: "le", value: 500, type: "decimal" }
+  ]
+}
+// (AMOUNT ge 100M and AMOUNT le 500M)
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`вывод-odata-type-из-value`,children:`Вывод OData type из value`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`condition.type`}),` отсутствует, используется простое правило:`]}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`JavaScript value`}),(0,c.jsx)(t.th,{children:`Выведенный OData type`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`number`}),` или `,(0,c.jsx)(t.code,{children:`bigint`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`int`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Date`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetime`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`остальное`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для decimal, long, datetimeOffset и других точных типов всегда задавайте `,(0,c.jsx)(t.code,{children:`type`}),` явно:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  key: "AMOUNT",
+  value: 12.5,
+  operation: "ge",
+  type: "decimal"
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Иначе `,(0,c.jsx)(t.code,{children:`12.5`}),` будет проверено как `,(0,c.jsx)(t.code,{children:`int`}),` и formatting завершится ошибкой.`]}),`
+`,(0,c.jsx)(t.h3,{id:`строковые-операции`,children:`Строковые операции`}),`
+`,(0,c.jsx)(t.p,{children:`Результат соответствует OData V2 syntax:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`buildODataFilter(createFilterContains<Row, string>("STATUS", "A"));
+// substringof('A',STATUS)
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для starts/ends:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`startswith(STATUS, 'A')
+endswith(STATUS, 'A')
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`createfilter`,children:(0,c.jsx)(t.code,{children:`createFilter`})}),`
+`,(0,c.jsx)(t.p,{children:`Общая фабрика:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createFilter<Row, number>("AMOUNT", 100, "gt");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` создают пустой leaf `,(0,c.jsx)(t.code,{children:`{ conditions: [] }`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Массив создаёт несколько conditions с OR по умолчанию:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createFilter<Row, string>("STATUS", ["A", "B"], "eq");
+// после serialization: (STATUS eq 'A' or STATUS eq 'B')
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` элементы массива удаляются. Остальные falsy values сохраняются.`]}),`
+`,(0,c.jsx)(t.h3,{id:`фабрики`,children:`Фабрики`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createFilterEqual("STATUS", "A");
+createFilterContains("NAME", "сталь");
+createFilterBetween("AMOUNT", [100, 500]);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createFilterBetween`}),` создаёт `,(0,c.jsx)(t.code,{children:`ge`}),` + `,(0,c.jsx)(t.code,{children:`le`}),` с AND.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При одной пустой границе создаётся одностороннее условие. Но текущая реализация проверяет частичную границу по truthiness. Поэтому значения `,(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`false`}),` и `,(0,c.jsx)(t.code,{children:`""`}),` как единственная граница будут потеряны:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createFilterBetween("AMOUNT", [0, null]);
+// пустое выражение, а не AMOUNT ge 0
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нулевая открытая граница важна, создайте condition вручную через `,(0,c.jsx)(t.code,{children:`createFilter`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`createfilterequalfalsy`,children:(0,c.jsx)(t.code,{children:`createFilterEqualFalsy`})}),`
+`,(0,c.jsx)(t.p,{children:`Эта фабрика намеренно удаляет любые falsy values:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createFilterEqualFalsy("AMOUNT", 0); // пусто
+createFilterEqualFalsy("ACTIVE", false); // пусто
+createFilterEqualFalsy("TEXT", ""); // пусто
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте её только когда `,(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`false`}),` и `,(0,c.jsx)(t.code,{children:`""`}),` действительно означают «фильтр не задан». В обычном случае нужен `,(0,c.jsx)(t.code,{children:`createFilterEqual`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`mergefilterexpressions`,children:(0,c.jsx)(t.code,{children:`mergeFilterExpressions`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const merged = mergeFilterExpressions(left, right);
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`если left отсутствует — возвращается right;`}),`
+`,(0,c.jsx)(t.li,{children:`если right отсутствует — возвращается left;`}),`
+`,(0,c.jsx)(t.li,{children:`если есть оба — создаётся nested AND;`}),`
+`,(0,c.jsxs)(t.li,{children:[`если отсутствуют оба — результат `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildodatafilter`,children:(0,c.jsx)(t.code,{children:`buildODataFilter`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const filterText = buildODataFilter(expression);
+`})}),`
+`,(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:[`пустой leaf/node → `,(0,c.jsx)(t.code,{children:`""`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`один child выводится без лишней групповой обёртки;`}),`
+`,(0,c.jsx)(t.li,{children:`несколько children заключаются в скобки;`}),`
+`,(0,c.jsxs)(t.li,{children:[`некорректная runtime-форма expression приводит к `,(0,c.jsx)(t.code,{children:`Error`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildodatafilterrecursive`,children:(0,c.jsx)(t.code,{children:`buildODataFilterRecursive`})}),`
+`,(0,c.jsx)(t.p,{children:`Альтернативный serializer использует более агрессивные скобки для вложенных выражений. Логический смысл тот же, но строка может отличаться:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const normal = buildODataFilter(expression);
+const explicit = buildODataFilterRecursive(expression);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если backend/tests завязаны на точную форму строки, выберите один serializer и используйте его последовательно.`}),`
+`,(0,c.jsx)(t.h3,{id:`typescript-не-валидирует-field-id-в-runtime`,children:`TypeScript не валидирует field id в runtime`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`keyof T`}),` помогает только во время компиляции:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createFilterEqual<Row, string>("STATUS", "A");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`После `,(0,c.jsx)(t.code,{children:`as`}),`, JSON parse или plain JavaScript в key может попасть произвольная строка. OData filter builder не имеет runtime allowlist field ids. Если definition приходит извне, сверяйте field id с metadata columns.`]}),`
+`,(0,c.jsx)(t.h2,{id:`compiled-filter-definitions`,children:`Compiled filter definitions`}),`
+`,(0,c.jsx)(t.p,{children:`Этот слой нужен сложным фильтрам, когда UI-конфигурация и текущее значение хранятся отдельно.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`definitions + values
+        │
+        ├─ sanitize
+        ▼
+compileFiltersToExpression
+        │
+        ▼
+FilterExpression
+        │
+        ▼
+buildODataFilter
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для простого программного фильтра этот слой не обязателен. Используйте `,(0,c.jsx)(t.code,{children:`createFilterEqual`}),` напрямую.`]}),`
+`,(0,c.jsx)(t.h3,{id:`значения`,children:`Значения`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataFilterValue = InputType | Record<string, string[]>;
+type ODataFilterValues = Record<string, ODataFilterValue>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Объект `,(0,c.jsx)(t.code,{children:`Record<string, string[]>`}),` представляет выбранные значения разных уровней tree filter:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const values = {
+	productTree: {
+		CATEGORY: ["A"],
+		GROUP: ["A1", "A2"]
+	}
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`виды-definitions`,children:`Виды definitions`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FilterDefinitionKind = "segment" | "tree" | "advanced" | "local" | "registered" | "column";
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Kind`}),(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:`segment`})}),(0,c.jsx)(t.td,{children:`Select/multi-select, обычно загружаемый OData-справочник.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`tree`})}),(0,c.jsx)(t.td,{children:`Значения распределены по нескольким физическим колонкам уровней.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`local`})}),(0,c.jsx)(t.td,{children:`Локальный control с декларативным binding.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`registered`})}),(0,c.jsx)(t.td,{children:`Control предоставлен внешним runtime registry; owner column может отсутствовать.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`advanced`})}),(0,c.jsx)(t.td,{children:`Advanced-search выбирает массив значений owner column.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`column`})}),(0,c.jsx)(t.td,{children:`Обычное scalar/multiple значение колонки.`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Component ids:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FilterSegmentComponentId = "select" | "multi-select";
+type FilterTreeComponentId = "tree-select" | "tree-multi-select";
+type FilterLocalComponentId = "select" | "multi-select" | "checkbox" | "text-input" | "number-input";
+type FilterAdvancedComponentId = "advanced-search-select";
+type FilterRegisteredValueMode = "single" | "multiple";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`isFilterLocalComponentId(value)`}),` проверяет только local component ids.`]}),`
+`,(0,c.jsx)(t.h3,{id:`segment`,children:`Segment`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const segmentDefinition: ODataCompiledFilterDefinition = {
+	id: "company",
+	ownerColumnId: "BUKRS",
+	columnIds: ["BUKRS"],
+	kind: "segment",
+	componentId: "multi-select",
+	controlType: "string",
+	dictionaryCodeKey: "BUKRS"
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`select`}),` ожидается scalar. Для `,(0,c.jsx)(t.code,{children:`multi-select`}),` ожидается массив. Массив компилируется в OR из `,(0,c.jsx)(t.code,{children:`eq`}),` conditions.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`dictionaryCodeKey`}),` задаёт key dependency при загрузке связанного справочника. Если он совпадает с `,(0,c.jsx)(t.code,{children:`ownerColumnId`}),`, sanitizer удаляет избыточное поле.`]}),`
+`,(0,c.jsx)(t.h3,{id:`tree`,children:`Tree`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const treeDefinition: ODataCompiledFilterDefinition = {
+	id: "productTree",
+	ownerColumnId: "CATEGORY",
+	columnIds: ["CATEGORY", "GROUP"],
+	kind: "tree",
+	componentId: "tree-multi-select",
+	controlType: "string",
+	levelOperator: "and"
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Внутри каждого уровня значения объединяются OR. Между уровнями по умолчанию используется AND. Укажите `,(0,c.jsx)(t.code,{children:`levelOperator: "or"`}),`, чтобы уровни объединялись OR.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`ownerColumnId`}),` не входит в нормализованный `,(0,c.jsx)(t.code,{children:`columnIds`}),`, sanitizer заменяет owner на первый column id.`]}),`
+`,(0,c.jsx)(t.h3,{id:`condition-binding`,children:`Condition binding`}),`
+`,(0,c.jsx)(t.p,{children:`Один local/registered control может создавать conditions по другой физической колонке:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataFilterCondition = {
+	columnId?: string;
+	operation: FilterOperation;
+	valueSource: "static" | "input";
+	value?: BaseType;
+};
+
+type ODataFilterConditionGroup = {
+	and?: boolean;
+	conditions: ODataFilterCondition[];
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`valueSource: "static"`}),` берёт `,(0,c.jsx)(t.code,{children:`condition.value`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`valueSource: "input"`}),` берёт текущее значение control.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`columnId`}),` не указан, local definition использует `,(0,c.jsx)(t.code,{children:`ownerColumnId`}),` как fallback. У registered definition искусственного owner нет, поэтому condition должна явно назвать column id.`]}),`
+`,(0,c.jsx)(t.h3,{id:`list-binding`,children:`List binding`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const binding: ODataFilterBinding = {
+	kind: "list",
+	and: false,
+	options: [
+		{
+			key: "open",
+			label: "Открытые",
+			filter: {
+				conditions: [
+					{
+						columnId: "STATUS",
+						operation: "eq",
+						valueSource: "static",
+						value: "O"
+					}
+				]
+			}
+		}
+	]
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Выбранные options объединяются OR, если `,(0,c.jsx)(t.code,{children:`and !== true`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для local list option без explicit filter используется fallback `,(0,c.jsx)(t.code,{children:`ownerColumnId eq option.key`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для registered list такого fallback нет: option без filter не создаёт server filter.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустой string `,(0,c.jsx)(t.code,{children:`option.key`}),` разрешён и может означать отдельный пользовательский выбор. Дубли option keys sanitizer сейчас не удаляет.`]}),`
+`,(0,c.jsx)(t.h3,{id:`boolean-binding`,children:`Boolean binding`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const binding: ODataFilterBinding = {
+	kind: "boolean",
+	trueFilter: {
+		conditions: [{ columnId: "ACTIVE", operation: "eq", valueSource: "static", value: true }]
+	}
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Filter включается только когда control value строго равно `,(0,c.jsx)(t.code,{children:`true`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Local boolean без `,(0,c.jsx)(t.code,{children:`trueFilter`}),` создаёт fallback `,(0,c.jsx)(t.code,{children:`ownerColumnId eq true`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Registered boolean без explicit `,(0,c.jsx)(t.code,{children:`trueFilter`}),` ничего не создаёт.`]}),`
+`,(0,c.jsx)(t.h3,{id:`value-binding`,children:`Value binding`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const binding: ODataFilterBinding = {
+	kind: "value",
+	valueFilter: {
+		conditions: [{ columnId: "AMOUNT", operation: "ge", valueSource: "input" }]
+	}
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Local value без explicit group создаёт fallback equality по owner column.`}),`
+`,(0,c.jsx)(t.p,{children:`Registered value без explicit group ничего не создаёт.`}),`
+`,(0,c.jsx)(t.h3,{id:`registered-filter-без-binding`,children:`Registered filter без binding`}),`
+`,(0,c.jsx)(t.p,{children:`Registered definition может быть parameter-only:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const definition: ODataCompiledFilterDefinition = {
+	id: "period",
+	kind: "registered",
+	componentId: "period-control",
+	controlType: "date",
+	valueMode: "single",
+	columnIds: []
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Значение такого control может использоваться другим уровнем приложения, но `,(0,c.jsx)(t.code,{children:`compileFiltersToExpression`}),` не добавит его в `,(0,c.jsx)(t.code,{children:`$filter`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`sanitizefilterconditiongroup`,children:(0,c.jsx)(t.code,{children:`sanitizeFilterConditionGroup`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализует condition group:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`trim для `,(0,c.jsx)(t.code,{children:`columnId`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`невалидное/пустое static value удаляется;`}),`
+`,(0,c.jsx)(t.li,{children:`input condition может не иметь сохранённого value;`}),`
+`,(0,c.jsxs)(t.li,{children:[`пустая после очистки группа становится `,(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`and: false`}),` сохраняется как явный OR;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`and: true`}),` сохраняется как AND.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`sanitizefilterbinding`,children:(0,c.jsx)(t.code,{children:`sanitizeFilterBinding`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализует binding:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`trim для option key и label;`}),`
+`,(0,c.jsx)(t.li,{children:`пустой key сохраняется;`}),`
+`,(0,c.jsx)(t.li,{children:`пустой label заменяется key;`}),`
+`,(0,c.jsx)(t.li,{children:`options не дедуплицируются;`}),`
+`,(0,c.jsxs)(t.li,{children:[`list без options становится `,(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`вложенные condition groups очищаются.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`sanitizefilterdefinitions`,children:(0,c.jsx)(t.code,{children:`sanitizeFilterDefinitions`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализует массив definitions без изменения входных объектов. Это важно для frozen Zustand/Immer snapshots.`}),`
+`,(0,c.jsx)(t.p,{children:`Основные правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`trim для `,(0,c.jsx)(t.code,{children:`id`}),`, `,(0,c.jsx)(t.code,{children:`ownerColumnId`}),`, `,(0,c.jsx)(t.code,{children:`componentId`}),`, `,(0,c.jsx)(t.code,{children:`columnIds`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`definitions без обязательного id удаляются;`}),`
+`,(0,c.jsx)(t.li,{children:`non-registered definition без owner удаляется;`}),`
+`,(0,c.jsxs)(t.li,{children:[`tree без физических `,(0,c.jsx)(t.code,{children:`columnIds`}),` удаляется;`]}),`
+`,(0,c.jsx)(t.li,{children:`local без валидного binding удаляется;`}),`
+`,(0,c.jsx)(t.li,{children:`column ids дедуплицируются;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`segment.columnIds`}),` пересчитывается как `,(0,c.jsx)(t.code,{children:`[ownerColumnId]`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`local/registered `,(0,c.jsx)(t.code,{children:`columnIds`}),` выводятся из binding conditions;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`legacy kinds `,(0,c.jsx)(t.code,{children:`odata-segment`}),` и `,(0,c.jsx)(t.code,{children:`odata-tree`}),` переводятся в `,(0,c.jsx)(t.code,{children:`segment`}),` и `,(0,c.jsx)(t.code,{children:`tree`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`legacy `,(0,c.jsx)(t.code,{children:`treeSelect`}),` переводится в `,(0,c.jsx)(t.code,{children:`tree-select`}),`; остальное tree legacy значение становится `,(0,c.jsx)(t.code,{children:`tree-multi-select`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это migration sanitizer сохранённых конфигураций, а не разрешение продолжать создавать legacy definitions в новом коде.`}),`
+`,(0,c.jsx)(t.h3,{id:`sanitizefiltervalue`,children:(0,c.jsx)(t.code,{children:`sanitizeFilterValue`})}),`
+`,(0,c.jsx)(t.p,{children:`Scalar правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`string обрезается через `,(0,c.jsx)(t.code,{children:`trim`}),`, но пустая строка сохраняется;`]}),`
+`,(0,c.jsx)(t.li,{children:`finite number сохраняется;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`NaN`}),`, `,(0,c.jsx)(t.code,{children:`Infinity`}),`, `,(0,c.jsx)(t.code,{children:`-Infinity`}),` удаляются;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`boolean сохраняется, включая `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`valid `,(0,c.jsx)(t.code,{children:`Date`}),` сохраняется;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`invalid `,(0,c.jsx)(t.code,{children:`Date`}),` удаляется.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Array правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`элементы очищаются как scalar;`}),`
+`,(0,c.jsx)(t.li,{children:`дубликаты удаляются с учётом типа;`}),`
+`,(0,c.jsx)(t.li,{children:`результат сортируется детерминированно;`}),`
+`,(0,c.jsxs)(t.li,{children:[`пустой массив становится `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Tree object правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`keys колонок проходят trim;`}),`
+`,(0,c.jsx)(t.li,{children:`принимаются только string arrays;`}),`
+`,(0,c.jsx)(t.li,{children:`string values trim/dedupe;`}),`
+`,(0,c.jsx)(t.li,{children:`пустые строки удаляются;`}),`
+`,(0,c.jsx)(t.li,{children:`порядок значений tree array сохраняется, сортировка не выполняется;`}),`
+`,(0,c.jsx)(t.li,{children:`пустые уровни удаляются.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`sanitizefiltervalues`,children:(0,c.jsx)(t.code,{children:`sanitizeFilterValues`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const normalized = sanitizeFilterValues({
+	" company ": [" 1000 ", "1000", "2000"],
+	broken: Number.NaN
+});
+
+// { company: ["1000", "2000"] }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Filter ids проходят trim. Пустые/невалидные значения удаляются.`}),`
+`,(0,c.jsx)(t.h3,{id:`mergefiltervaluepatch`,children:(0,c.jsx)(t.code,{children:`mergeFilterValuePatch`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const next = mergeFilterValuePatch(values, "company", ["1000"]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция сначала нормализует весь snapshot, создаёт новый object и затем:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`устанавливает нормализованное value;`}),`
+`,(0,c.jsxs)(t.li,{children:[`либо удаляет key, если новое value стало `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Входной object не мутируется.`}),`
+`,(0,c.jsx)(t.h3,{id:`potential-и-active-column-ids`,children:`Potential и active column ids`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveODataFilterDefinitionColumnIds(definition);
+resolveODataFilterDefinitionActiveColumnIds(definition, value);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Первая функция возвращает все физические колонки, которые definition потенциально может затронуть.`}),`
+`,(0,c.jsx)(t.p,{children:`Вторая учитывает текущее value. Например, у list binding options могут ссылаться на разные columns; active helper вернёт только columns выбранных options.`}),`
+`,(0,c.jsx)(t.p,{children:`Это полезно при проверке совместимости filter definition с конкретным OData target.`}),`
+`,(0,c.jsx)(t.h3,{id:`compilefilterstoexpression`,children:(0,c.jsx)(t.code,{children:`compileFiltersToExpression`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const expression = compileFiltersToExpression(definitions, values);
+const filter = buildODataFilter(expression);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Компилятор:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`санитизирует definitions;`}),`
+`,(0,c.jsx)(t.li,{children:`санитизирует values;`}),`
+`,(0,c.jsxs)(t.li,{children:[`сопоставляет value по `,(0,c.jsx)(t.code,{children:`definition.id`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`отбрасывает definitions без активного server expression;`}),`
+`,(0,c.jsx)(t.li,{children:`объединяет expressions разных definitions через AND.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Semantics по kind:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Kind`}),(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:`segment/select`})}),(0,c.jsxs)(t.td,{children:[`scalar `,(0,c.jsx)(t.code,{children:`owner eq value`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`segment/multi-select`})}),(0,c.jsx)(t.td,{children:`массив equality через OR`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`tree`})}),(0,c.jsxs)(t.td,{children:[`values каждого уровня через OR, уровни через AND или `,(0,c.jsx)(t.code,{children:`levelOperator`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`local/list`})}),(0,c.jsx)(t.td,{children:`option filters либо fallback owner equality`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`local/boolean`})}),(0,c.jsxs)(t.td,{children:[`только `,(0,c.jsx)(t.code,{children:`true`}),`; explicit group либо owner `,(0,c.jsx)(t.code,{children:`eq true`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`local/value`})}),(0,c.jsx)(t.td,{children:`explicit input group либо owner equality`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`registered`})}),(0,c.jsx)(t.td,{children:`только explicit binding conditions; owner fallback отсутствует`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`column`})}),(0,c.jsx)(t.td,{children:`scalar/array owner equality`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`advanced`})}),(0,c.jsx)(t.td,{children:`только массив owner equality`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если ничего не скомпилировалось, возвращается `,(0,c.jsx)(t.code,{children:`undefined`}),`, а `,(0,c.jsx)(t.code,{children:`buildODataFilter(undefined)`}),` даст пустую строку.`]}),`
+`,(0,c.jsx)(t.h3,{id:`dependencies-для-справочников`,children:`Dependencies для справочников`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dependencies = flattenFilterValuesToODataDependencies(definitions, values);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В dependencies попадают только `,(0,c.jsx)(t.code,{children:`segment`}),` и `,(0,c.jsx)(t.code,{children:`tree`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`segment записывается по `,(0,c.jsx)(t.code,{children:`dictionaryCodeKey`}),` либо `,(0,c.jsx)(t.code,{children:`ownerColumnId`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`tree раскладывает выбранные значения по физическим `,(0,c.jsx)(t.code,{children:`columnIds`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`local/registered/column/advanced пропускаются.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  BUKRS: ["1000"],
+  CATEGORY: ["A"],
+  GROUP: ["A1"]
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`цепочки-odata-сегментов`,children:`Цепочки OData-сегментов`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ODataChainItem = {
+	codeKey: string;
+	count: number;
+};
+
+type ODataChainsMap = Record<string, ODataChainItem[]>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`collapseChainedODataSegmentFilterValues`}),` оставляет в каждой известной цепочке самый глубокий выбранный segment:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const collapsed = collapseChainedODataSegmentFilterValues(
+	{
+		category: ["A"],
+		group: ["A1"],
+		localStatus: "active"
+	},
+	["category", "group"],
+	{
+		product: [
+			{ codeKey: "category", count: 1 },
+			{ codeKey: "group", count: 2 }
+		]
+	}
+);
+
+// { group: ["A1"], localStatus: "active" }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Non-segment values и values без известной chain сохраняются. Функция не компилирует filter и не проверяет, действительно ли глубокое значение согласовано с родителем.`}),`
+`,(0,c.jsxs)(t.h2,{id:`сортировка-и-orderby`,children:[`Сортировка и `,(0,c.jsx)(t.code,{children:`$orderby`})]}),`
+`,(0,c.jsxs)(t.h3,{id:`тип-sort`,children:[`Тип `,(0,c.jsx)(t.code,{children:`Sort`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface Sort<T> {
+	key: T;
+	desc?: true;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Отсутствие `,(0,c.jsx)(t.code,{children:`desc`}),` означает ascending. Явное `,(0,c.jsx)(t.code,{children:`desc: false`}),` типом не предусмотрено.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const sorting = [{ key: "YEAR" }, { key: "AMOUNT", desc: true }] satisfies Sort<"YEAR" | "AMOUNT">[];
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`buildodataorder`,children:(0,c.jsx)(t.code,{children:`buildODataOrder`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`buildODataOrder(sorting);
+// YEAR asc,AMOUNT desc
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пустой массив даёт пустую строку.`}),`
+`,(0,c.jsx)(t.h3,{id:`getsortindex`,children:(0,c.jsx)(t.code,{children:`getSortIndex`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getSortIndex(sorting, "AMOUNT"); // 1
+getSortIndex(sorting, "STATUS"); // -1
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`togglesort`,children:(0,c.jsx)(t.code,{children:`toggleSort`})}),`
+`,(0,c.jsx)(t.p,{children:`Цикл одного поля:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`нет → asc → desc → нет
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`let sorting: Sort<keyof Row>[] = [];
+
+sorting = toggleSort(sorting, "AMOUNT", false); // asc
+sorting = toggleSort(sorting, "AMOUNT", false); // desc
+sorting = toggleSort(sorting, "AMOUNT", false); // remove
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`multi: true`}),` сохраняет остальные fields.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`multi: false`}),` оставляет только выбранный key. Это обычный single-sort UI.`]}),`
+`,(0,c.jsx)(t.p,{children:`Функция возвращает новый массив и не мутирует входной.`}),`
+`,(0,c.jsx)(t.h3,{id:`grouping-fallback`,children:`Grouping fallback`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveEffectiveSorts(grouping, sorting);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правило:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`если пользовательская `,(0,c.jsx)(t.code,{children:`sorting`}),` непустая — используется только она;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`если пользовательской сортировки нет — fields `,(0,c.jsx)(t.code,{children:`grouping`}),` становятся ascending sorts.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Grouping не дописывается к пользовательской sorting.`}),`
+`,(0,c.jsx)(t.h3,{id:`buildodataorderby`,children:(0,c.jsx)(t.code,{children:`buildODataOrderBy`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`buildODataOrderBy<Row>(["YEAR"], []); // "YEAR asc"
+buildODataOrderBy<Row>(["YEAR"], [{ key: "AMOUNT", desc: true }]);
+// "AMOUNT desc"
+
+buildODataOrderBy<Row>([], []); // undefined
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В отличие от `,(0,c.jsx)(t.code,{children:`buildODataOrder`}),`, пустой эффективный список даёт `,(0,c.jsx)(t.code,{children:`undefined`}),`. Это удобно при создании optional query option.`]}),`
+`,(0,c.jsx)(t.h3,{id:`getsortindicator`,children:(0,c.jsx)(t.code,{children:`getSortIndicator`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const indicator = getSortIndicator(grouping, sorting, "YEAR");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результаты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{ active: false }
+
+{
+  active: true,
+  desc: true,
+  order: 2
+}
+
+{
+  active: true,
+  order: 1,
+  lockedByGrouping: true
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`order`}),` начинается с `,(0,c.jsx)(t.code,{children:`1`}),`, чтобы напрямую показывать номер при multi-sort.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`lockedByGrouping`}),` появляется только для grouping fallback, когда пользовательской sorting ещё нет.`]}),`
+`,(0,c.jsx)(t.h2,{id:`sql-like-фильтры`,children:`SQL-like фильтры`}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[`Это не OData `,(0,c.jsx)(t.code,{children:`$filter`}),` и не query option SAP Gateway.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`SQL-like API предназначен только для legacy payload, где backend ожидает текст dynamic WHERE в request body.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const sql = buildSqlFilter([createSqlFilterEqual("STATUS", "A"), createSqlFilterIn("COMPANY", ["1000", "2000"])]);
+
+// STATUS='A' AND COMPANY IN ('1000', '2000')
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`типы`,children:`Типы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SqlFilterScalarValue = string | number | boolean;
+type SqlFilterOperation = "eq" | "in";
+type SqlFilterConjunction = "and" | "or";
+type SqlFilterCondition = SqlFilterEqualCondition | SqlFilterInCondition;
+type SqlFilterExpression = SqlFilterCondition | SqlFilterGroup;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`factory-api`,children:`Factory API`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createSqlFilterEqual("STATUS", "A");
+createSqlFilterIn("COMPANY", ["1000", "2000"]);
+createSqlFilterGroup([createSqlFilterEqual("STATUS", "A"), createSqlFilterEqual("STATUS", "B")], "or");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Group всегда сериализуется в скобках. Выражения top-level всегда объединяются `,(0,c.jsx)(t.code,{children:`AND`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`(STATUS='A' OR STATUS='B') AND COMPANY='1000'
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`field-id-validation`,children:`Field id validation`}),`
+`,(0,c.jsx)(t.p,{children:`Разрешены только простые identifiers:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`^[A-Za-z_][A-Za-z0-9_]*$
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`assertSqlFilterFieldId("STATUS"); // ok
+assertSqlFilterFieldId("STATUS_01"); // ok
+assertSqlFilterFieldId("A; DROP"); // Error
+assertSqlFilterFieldId("TABLE.FIELD"); // Error
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Validation выполняется при сериализации condition с usable value. Не используйте отсутствие ошибки для empty condition как отдельную проверку field id; для этого вызывайте `,(0,c.jsx)(t.code,{children:`assertSqlFilterFieldId`}),` прямо.`]}),`
+`,(0,c.jsx)(t.h3,{id:`values`,children:`Values`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isSqlFilterScalarValue("A"); // true
+isSqlFilterScalarValue(10); // true
+isSqlFilterScalarValue(false); // true
+isSqlFilterScalarValue(null); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Все values, включая numbers и booleans, сериализуются как quoted strings:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`COUNT='10'
+ACTIVE='true'
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Одинарные кавычки внутри value удваиваются.`}),`
+`,(0,c.jsx)(t.p,{children:`Пропускаются:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`пустая/whitespace-only строка;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`NaN`}),` и infinity;`]}),`
+`,(0,c.jsx)(t.li,{children:`objects, arrays и другие неподдерживаемые values.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Date`}),` не пропускается молча, а приводит к ошибке. Caller обязан заранее выбрать формат даты и передать string.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустые groups и conditions не попадают в результат. Если всё пусто, `,(0,c.jsx)(t.code,{children:`buildSqlFilter`}),` возвращает `,(0,c.jsx)(t.code,{children:`""`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-нельзя-применять-для-url`,children:`Почему нельзя применять для URL`}),`
+`,(0,c.jsxs)(t.p,{children:[`SQL-like syntax содержит `,(0,c.jsx)(t.code,{children:`IN`}),`, quoted payload values и field identifiers по собственному контракту backend. Это другой язык выражений. Для OData URL используйте `,(0,c.jsx)(t.code,{children:`createFilter*`}),` + `,(0,c.jsx)(t.code,{children:`buildODataFilter`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`пары-код--текст`,children:`Пары «код + текст»`}),`
+`,(0,c.jsx)(t.h3,{id:`типы-1`,children:`Типы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type CollectionItem = {
+	[key: string]: string;
+};
+
+interface CollectionPair {
+	codeKey: string;
+	textKey: string;
+}
+
+interface DependencyFilter {
+	key: string;
+	values: CollectionItem[];
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`CollectionItem`}),` типизирован как string record. Если transport возвращает `,(0,c.jsx)(t.code,{children:`null`}),`, number или missing key, сначала нормализуйте row. Runtime helper не проверяет соответствие типу TypeScript.`]}),`
+`,(0,c.jsx)(t.h3,{id:`findcollectionpairs`,children:(0,c.jsx)(t.code,{children:`findCollectionPairs`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = findCollectionPairs(
+	{
+		code: "A",
+		code_TEXT: "Альфа",
+		alone: "1"
+	},
+	{ returnUnpaired: true }
+);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  pairs: [{ codeKey: "code", textKey: "code_TEXT" }],
+  pairsMap: { code: "code_TEXT" },
+  unpaired: ["alone"]
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Options:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FindOptions = {
+	textSuffixes?: string[];
+	caseSensitive?: boolean;
+	returnUnpaired?: boolean;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Default suffixes:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`_txt, _text, _t, _Text, _TXT, _T
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поиск suffix по умолчанию нечувствителен к регистру. Custom suffixes экранируются как regexp text, поэтому `,(0,c.jsx)(t.code,{children:`".label"`}),` работает буквально:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`findCollectionPairs({ material: "1", "material.label": "Материал" }, { textSuffixes: [".label"] });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Важная тонкость: после удаления suffix base field ищется через точное `,(0,c.jsx)(t.code,{children:`fields.includes(baseName)`}),`. Поэтому case-insensitive suffix не делает поиск base key полностью case-insensitive:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  CODE: "A",
+  code_txt: "Альфа"
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Такая пара может не найтись из-за различия `,(0,c.jsx)(t.code,{children:`CODE`}),` и `,(0,c.jsx)(t.code,{children:`code`}),`. Лучше нормализовать имена полей или передавать согласованную metadata-пару.`]}),`
+`,(0,c.jsx)(t.p,{children:`Каждое поле используется максимум в одной найденной паре.`}),`
+`,(0,c.jsx)(t.h3,{id:`buildseparatedarrays`,children:(0,c.jsx)(t.code,{children:`buildSeparatedArrays`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция из общей коллекции создаёт отдельный массив для каждой code/text pair:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rows = [
+	{ code: "B", text: "Бета", group: "2", groupText: "Группа 2" },
+	{ code: "A", text: "Альфа", group: "1", groupText: "Группа 1" },
+	{ code: "A", text: "Альфа", group: "1", groupText: "Группа 1" }
+];
+
+const result = buildSeparatedArrays(rows, [
+	{ codeKey: "code", textKey: "text" },
+	{ codeKey: "group", textKey: "groupText" }
+]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  code: [
+    { code: "A", text: "Альфа" },
+    { code: "B", text: "Бета" }
+  ],
+  group: [
+    { group: "1", groupText: "Группа 1" },
+    { group: "2", groupText: "Группа 2" }
+  ]
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Signature:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`buildSeparatedArrays(items, pairs, (excludeEmpty = true), (sortByCode = true));
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`pair считается валидной, только если оба key есть в первом item;`}),`
+`,(0,c.jsx)(t.li,{children:`невалидная pair всё равно получает пустой массив в result;`}),`
+`,(0,c.jsx)(t.li,{children:`output row содержит только code и text fields;`}),`
+`,(0,c.jsxs)(t.li,{children:[`одинаковая комбинация `,(0,c.jsx)(t.code,{children:`code + "|" + text`}),` удаляется;`]}),`
+`,(0,c.jsx)(t.li,{children:`по умолчанию rows с пустой строкой text пропускаются;`}),`
+`,(0,c.jsx)(t.li,{children:`по умолчанию результат сортируется по code;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`sortByCode: false`}),` сортирует по text через общий `,(0,c.jsx)(t.code,{children:`compareStrings`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`пустой `,(0,c.jsx)(t.code,{children:`items`}),` создаёт пустые массивы для всех pairs.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ограничения-buildseparatedarrays`,children:[`Ограничения `,(0,c.jsx)(t.code,{children:`buildSeparatedArrays`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция приводит значения через `,(0,c.jsx)(t.code,{children:`String`}),` до проверки. Поэтому invalid runtime rows могут дать неожиданный текст:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`String(undefined); // "undefined"
+String(null); // "null"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Из-за этого missing/null в последующих rows могут попасть в справочник как строки `,(0,c.jsx)(t.code,{children:`"undefined"`}),` или `,(0,c.jsx)(t.code,{children:`"null"`}),`. `,(0,c.jsx)(t.code,{children:`excludeEmpty`}),` удаляет только реально пустую строку после преобразования.`]}),`
+`,(0,c.jsx)(t.p,{children:`Кроме того, структура валидируется только по первому item. Если первый row не содержит поле, которое есть в остальных rows, pair будет считаться невалидной.`}),`
+`,(0,c.jsx)(t.p,{children:`Правильный путь для ненадёжного backend payload:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`проверить/нормализовать rows;`}),`
+`,(0,c.jsx)(t.li,{children:`убедиться в одинаковой форме элементов;`}),`
+`,(0,c.jsxs)(t.li,{children:[`затем вызвать `,(0,c.jsx)(t.code,{children:`buildSeparatedArrays`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`настройки-odata-коллекций`,children:`Настройки OData-коллекций`}),`
+`,(0,c.jsx)(t.h3,{id:`глобальный-zustand-store`,children:`Глобальный Zustand store`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useODataCollectionStore`}),` — один singleton на загруженный экземпляр модуля.`]}),`
+`,(0,c.jsx)(t.p,{children:`Default state:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  defaultMaxVisibleItems: 200,
+  defaultMinSearchCodeLength: 3,
+  defaultMinSearchTextLength: 1,
+  defaultSearchDebounceDelay: 100
+}
+`})}),`
+`,(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:`Field`}),(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:`defaultMaxVisibleItems`})}),(0,c.jsx)(t.td,{children:`Максимум показываемых элементов справочника по умолчанию.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`defaultMinSearchCodeLength`})}),(0,c.jsx)(t.td,{children:`Минимальная длина поиска по коду.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`defaultMinSearchTextLength`})}),(0,c.jsx)(t.td,{children:`Минимальная длина поиска по тексту.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`defaultSearchDebounceDelay`})}),(0,c.jsx)(t.td,{children:`Задержка поиска в миллисекундах.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`чтение-и-изменение-вне-react`,children:`Чтение и изменение вне React`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const state = useODataCollectionStore.getState();
+
+state.setDefaultMaxVisibleItems(100);
+state.setDefaultMinSearchCodeLength(2);
+state.setDefaultMinSearchTextLength(2);
+state.setDefaultSearchDebounceDelay(250);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Setters не валидируют числа. Отрицательное значение, дробь или `,(0,c.jsx)(t.code,{children:`NaN`}),` будут сохранены. Host config обязан проверить значения до записи.`]}),`
+`,(0,c.jsx)(t.h3,{id:`использование-в-react`,children:`Использование в React`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function CollectionInfo() {
+	const maxVisible = useODataCollectionStore((state) => state.defaultMaxVisibleItems);
+
+	return <span>Показываем не более {maxVisible}</span>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Convenience selectors:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`odataCollectionConfig.useMaxVisibleItems();
+odataCollectionConfig.useMinSearchCodeLength();
+odataCollectionConfig.useMinSearchTextLength();
+odataCollectionConfig.useSearchDebounce();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это React hooks, несмотря на размещение внутри объекта. Вызывайте их только:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`на верхнем уровне React component;`}),`
+`,(0,c.jsx)(t.li,{children:`внутри custom hook;`}),`
+`,(0,c.jsx)(t.li,{children:`не внутри condition, loop, event handler или обычной utility function.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataCollectionConfig`}),` экспортирует только selectors. Для setters используйте `,(0,c.jsx)(t.code,{children:`useODataCollectionStore`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`глобальная-инициализация`,children:`Глобальная инициализация`}),`
+`,(0,c.jsx)(t.p,{children:`Если host меняет defaults, сделайте это один раз в application bootstrap, а не при каждом render:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`export function configureODataCollections() {
+	const state = useODataCollectionStore.getState();
+	state.setDefaultMaxVisibleItems(100);
+	state.setDefaultSearchDebounceDelay(200);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Store не сохраняется автоматически в localStorage/sessionStorage и не синхронизируется между browser tabs.`}),`
+`,(0,c.jsx)(t.h2,{id:`маленькие-helpers`,children:`Маленькие helpers`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizerangevalue`,children:(0,c.jsx)(t.code,{children:`normalizeRangeValue`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Преобразует `,(0,c.jsx)(t.code,{children:`InputType`}),` в двухэлементный range:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeRangeValue([10, 20]); // [10, 20]
+normalizeRangeValue([10]); // [10, null]
+normalizeRangeValue(10); // [10, null]
+normalizeRangeValue(null); // [null, null]
+normalizeRangeValue({}); // [null, null]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если массив длиннее двух элементов, используются только первые два. Nested objects не поддерживаются.`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizebasevalue`,children:(0,c.jsx)(t.code,{children:`normalizeBaseValue`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeBaseValue("A"); // "A"
+normalizeBaseValue(0); // 0
+normalizeBaseValue(false); // false
+normalizeBaseValue(date); // тот же Date reference
+normalizeBaseValue([1, 2]); // null
+normalizeBaseValue({ a: 1 }); // null
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция не клонирует `,(0,c.jsx)(t.code,{children:`Date`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`isbasevalue`,children:(0,c.jsx)(t.code,{children:`isBaseValue`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`true`}),` для:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`string, number, boolean;`}),`
+`,(0,c.jsxs)(t.li,{children:[`любого `,(0,c.jsx)(t.code,{children:`Date`}),` instance.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Она не проверяет finite number и valid date:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isBaseValue(Number.NaN); // true
+isBaseValue(new Date("bad")); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для строгой проверки используйте schemas/guards конкретного OData type.`}),`
+`,(0,c.jsx)(t.h3,{id:`unwrapodataqueryresult`,children:(0,c.jsx)(t.code,{children:`unwrapODataQueryResult`})}),`
+`,(0,c.jsx)(t.p,{children:`Некоторые OData query functions возвращают envelope:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  data: rows,
+  totalCount: 123
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`TanStack Query result тогда имеет `,(0,c.jsx)(t.code,{children:`query.data.data`}),`. Helper выносит fields наружу:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = unwrapODataQueryResult(query);
+
+result.data; // rows или undefined
+result.totalCount; // number или undefined
+result.isLoading; // остальные поля UseQueryResult сохранены
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Тип:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type UnwrappedODataQueryResult<T> = Omit<UseQueryResult<{ data: T; totalCount?: number }>, "data"> & {
+	data: T | undefined;
+	totalCount?: number;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция делает shallow spread query result. Она не меняет cache и не создаёт новый query.`}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-безопасность-и-ограничения`,children:`Ошибки, безопасность и ограничения`}),`
+`,(0,c.jsx)(t.h3,{id:`какие-функции-бросают-ошибки`,children:`Какие функции бросают ошибки`}),`
+`,(0,c.jsx)(t.p,{children:`Основные error boundaries:`}),`
+`,(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:`parseServiceMetadata`})}),(0,c.jsx)(t.td,{children:`Неподдерживаемый EDM type, mode/shape параметра или неразбираемая структура metadata.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataFormatValue`})}),(0,c.jsx)(t.td,{children:`Значение не прошло Zod schema выбранного OData type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`create*Formatter`}),` result`]}),(0,c.jsx)(t.td,{children:`Аргументы вызова не соответствуют schema фабрики.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildParameterEntries`})}),(0,c.jsxs)(t.td,{children:[`Нет mandatory value, массив без formatter, formatting error, нарушение `,(0,c.jsx)(t.code,{children:`maxLength`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`assertSqlFilterFieldId`})}),(0,c.jsx)(t.td,{children:`Field id не соответствует безопасному pattern.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildSqlFilter`})}),(0,c.jsxs)(t.td,{children:[`Попытка сериализовать `,(0,c.jsx)(t.code,{children:`Date`}),` без заранее выбранного формата.`]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Filter/sanitizer helpers чаще удаляют невалидные optional values и возвращают пустое выражение, а не бросают ошибку. Это разные контракты: builder параметров строгий, sanitizer сохранённого UI snapshot терпимый.`}),`
+`,(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:`let path = "";
+
+try {
+	path = buildEntityPath(metadata, config, params);
+} catch {
+	// Ошибка потеряна, request уйдёт по неправильному адресу.
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Лучше показать пользователю/разработчику контекст и не отправлять request:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`try {
+	return buildEntityPath(metadata, config, params);
+} catch (error) {
+	throw new Error(\`Не удалось подготовить OData target \${config.target}\`, {
+		cause: error
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`values-и-field-names-защищаются-по-разному`,children:`Values и field names защищаются по-разному`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`odataFormatValue`}),` экранирует string values и проверяет primitive type.`]}),`
+`,(0,c.jsx)(t.p,{children:`Но имена полей/сервисов не проходят общий runtime allowlist:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`FilterCondition.key`}),` вставляется как field id;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`ODataServiceConfig.service`}),` и `,(0,c.jsx)(t.code,{children:`target`}),` вставляются как path segments;`]}),`
+`,(0,c.jsx)(t.li,{children:`metadata ids считаются доверенными server metadata;`}),`
+`,(0,c.jsx)(t.li,{children:`custom formatter может вернуть любую строку.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Если field/service/target приходит из пользовательского JSON, сверяйте его с заранее известным allowlist или разобранной metadata.`}),`
+`,(0,c.jsx)(t.h3,{id:`custom-formatter--доверенная-функция`,children:`Custom formatter — доверенная функция`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  value,
+  formatter: (raw) => "..."
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Builder не понимает семантику строки custom formatter. Он не может гарантировать корректное escaping и тип literal. Не создавайте formatter из произвольного пользовательского JavaScript и не используйте `,(0,c.jsx)(t.code,{children:`eval`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Formatter должен быть заранее написан и протестирован.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-кодируйте-всё-url-целиком`,children:`Не кодируйте всё URL целиком`}),`
+`,(0,c.jsxs)(t.p,{children:[`Entity parameters кодируются builder-ом на уровне отдельных values. Function Import использует `,(0,c.jsx)(t.code,{children:`URLSearchParams`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если после этого вызвать `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),` на всём path, `,(0,c.jsx)(t.code,{children:`/`}),`, `,(0,c.jsx)(t.code,{children:`?`}),`, `,(0,c.jsx)(t.code,{children:`=`}),` и уже encoded проценты будут испорчены.`]}),`
+`,(0,c.jsx)(t.p,{children:`Transport должен соединять подготовленный path с base URL через свой проверенный URL builder.`}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-не-является-validation-server-rows`,children:`Metadata не является validation server rows`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ServiceMetadata`}),` описывает ожидаемую структуру, но library не проверяет каждую запись ответа. TypeScript type assertion не заменяет runtime validation:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rows = response as SalesRow[]; // не проверяет данные
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если backend payload недоверенный, валидируйте его на transport/domain boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`sql-like-api-не-делает-dynamic-sql-безопасным-целиком`,children:`SQL-like API не делает dynamic SQL безопасным целиком`}),`
+`,(0,c.jsx)(t.p,{children:`Library ограничивает field id и экранирует quotes в values. Но окончательная безопасность зависит от backend:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`backend не должен добавлять raw user fragments;`}),`
+`,(0,c.jsx)(t.li,{children:`backend должен ограничить доступные поля;`}),`
+`,(0,c.jsx)(t.li,{children:`лучше использовать parameterized database query;`}),`
+`,(0,c.jsx)(t.li,{children:`request body не должен давать пользователю произвольный WHERE.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`ssr-браузер-и-react`,children:`SSR, браузер и React`}),`
+`,(0,c.jsxs)(t.h3,{id:`domparser-и-nodejs`,children:[(0,c.jsx)(t.code,{children:`DOMParser`}),` и Node.js`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В обычном browser `,(0,c.jsx)(t.code,{children:`DOMParser`}),` существует глобально. В чистом Node.js это не гарантируется.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`if (typeof DOMParser === "undefined") {
+	throw new Error("Для parseServiceMetadata требуется DOMParser");
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для SSR есть три безопасных варианта:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`парсить metadata только в browser;`}),`
+`,(0,c.jsx)(t.li,{children:`предоставить совместимый DOM implementation в server runtime;`}),`
+`,(0,c.jsxs)(t.li,{children:[`парсить metadata в transport/server layer и передавать сериализуемый `,(0,c.jsx)(t.code,{children:`ServiceMetadata`}),` дальше.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не добавляйте случайный DOM polyfill внутрь feature: настройте его один раз на границе runtime.`}),`
+`,(0,c.jsx)(t.h3,{id:`zustand-store-на-server`,children:`Zustand store на server`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useODataCollectionStore`}),` является singleton module state. В долгоживущем SSR process глобальное изменение может разделяться между requests.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не храните в нём пользовательские или request-specific values. Текущий store предназначен только для общих defaults приложения.`}),`
+`,(0,c.jsx)(t.h3,{id:`rules-of-hooks`,children:`Rules of Hooks`}),`
+`,(0,c.jsx)(t.p,{children:`Следующий код неверен:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function readConfig() {
+	return odataCollectionConfig.useMaxVisibleItems();
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обычная функция может быть вызвана вне React render.`}),`
+`,(0,c.jsx)(t.p,{children:`Для non-React чтения используйте:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const maxVisible = useODataCollectionStore.getState().defaultMaxVisibleItems;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`server-components`,children:`Server Components`}),`
+`,(0,c.jsxs)(t.p,{children:[`Pure helpers можно использовать в server code при доступности их runtime dependencies. Hook selectors нужно вызывать только в client component. Помечайте component согласно framework contract, например `,(0,c.jsx)(t.code,{children:`"use client"`}),`, когда это требуется.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование-consumer-кода`,children:`Тестирование consumer-кода`}),`
+`,(0,c.jsx)(t.h3,{id:`тест-value-formatting`,children:`Тест value formatting`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { describe, expect, it } from "vitest";
+import { odataFormatValue } from "@ryuzaki13/react-foundation-lib/odata-service";
+
+describe("OData parameter values", () => {
+	it("экранирует одинарную кавычку", () => {
+		expect(odataFormatValue("string", "O'Reilly")).toBe("'O''Reilly'");
+	});
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`тест-builder-по-metadata`,children:`Тест builder по metadata`}),`
+`,(0,c.jsx)(t.p,{children:`Создавайте минимальную metadata, которая важна сценарию:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("не позволяет пропустить обязательную компанию", () => {
+	const metadata: EntityMetadata = {
+		title: "Продажи",
+		columns: [],
+		parameters: [
+			{
+				id: "p_company",
+				label: "Компания",
+				type: "string",
+				originalType: "Edm.String",
+				mandatory: true
+			}
+		],
+		result: "Results"
+	};
+
+	expect(() => buildEntityParameters(metadata, {})).toThrow("Отсутствует обязательный параметр: p_company");
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`тест-filters-как-структуры-и-строки`,children:`Тест filters как структуры и строки`}),`
+`,(0,c.jsx)(t.p,{children:`Полезно проверять оба уровня:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const expression = createFilterEqual<Row, string>("STATUS", ["A", "B"]);
+
+expect(expression).toEqual({
+	conditions: [
+		{ key: "STATUS", value: "A", operation: "eq" },
+		{ key: "STATUS", value: "B", operation: "eq" }
+	]
+});
+
+expect(buildODataFilter(expression)).toBe("(STATUS eq 'A' or STATUS eq 'B')");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Structure test показывает ошибку compiler-а, string test — ошибку serializer-а.`}),`
+`,(0,c.jsx)(t.h3,{id:`тест-compiled-definitions`,children:`Тест compiled definitions`}),`
+`,(0,c.jsx)(t.p,{children:`Для каждого custom filter проверяйте минимум:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`empty value;`}),`
+`,(0,c.jsx)(t.li,{children:`одно значение;`}),`
+`,(0,c.jsx)(t.li,{children:`несколько значений;`}),`
+`,(0,c.jsxs)(t.li,{children:[`falsy value `,(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`false`}),`, `,(0,c.jsx)(t.code,{children:`""`}),`, если допустимо;`]}),`
+`,(0,c.jsx)(t.li,{children:`невалидный сохранённый snapshot;`}),`
+`,(0,c.jsx)(t.li,{children:`physical column ids;`}),`
+`,(0,c.jsxs)(t.li,{children:[`итоговую строку `,(0,c.jsx)(t.code,{children:`$filter`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`тест-store`,children:`Тест store`}),`
+`,(0,c.jsx)(t.p,{children:`Singleton state сбрасывайте между tests:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`beforeEach(() => {
+	useODataCollectionStore.setState({
+		defaultMaxVisibleItems: 200,
+		defaultMinSearchCodeLength: 3,
+		defaultMinSearchTextLength: 1,
+		defaultSearchDebounceDelay: 100
+	});
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Иначе один test может влиять на следующий.`}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-fixtures`,children:`Metadata fixtures`}),`
+`,(0,c.jsx)(t.p,{children:`Храните небольшие XML fixtures для отдельных особенностей:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`parameterized entity;`}),`
+`,(0,c.jsx)(t.li,{children:`Function Import;`}),`
+`,(0,c.jsx)(t.li,{children:`code/text link;`}),`
+`,(0,c.jsx)(t.li,{children:`ABAP boolean-like field;`}),`
+`,(0,c.jsx)(t.li,{children:`unsupported type/error case.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Один огромный production EDMX делает test сложным для понимания и обновления.`}),`
+`,(0,c.jsxs)(t.h2,{id:`миграция-с-odata`,children:[`Миграция с `,(0,c.jsx)(t.code,{children:`/odata`})]}),`
+`,(0,c.jsx)(t.p,{children:`После объединения измените все импорты code/text helpers, date formatter и collection store.`}),`
+`,(0,c.jsx)(t.p,{children:`До:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildSeparatedArrays, findCollectionPairs, ODataDateFormat, useODataCollectionStore } from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`После:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	buildSeparatedArrays,
+	findCollectionPairs,
+	ODataDateFormat,
+	useODataCollectionStore
+} from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`что-именно-удалено`,children:`Что именно удалено`}),`
+`,(0,c.jsx)(t.p,{children:`Subpath export:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`@ryuzaki13/react-foundation-lib/odata
+`})}),`
+`,(0,c.jsx)(t.p,{children:`больше не является публичным контрактом. Compatibility re-export не оставлен.`}),`
+`,(0,c.jsx)(t.h3,{id:`порядок-миграции-нескольких-пакетов`,children:`Порядок миграции нескольких пакетов`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`react-foundation-api`}),`, `,(0,c.jsx)(t.code,{children:`react-foundation-ui`}),` и host-приложение используют прежний subpath:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`опубликуйте новую breaking-версию `,(0,c.jsx)(t.code,{children:`react-foundation-lib`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`обновите imports и dependency range в package-потребителе;`}),`
+`,(0,c.jsx)(t.li,{children:`проверьте typecheck/build этого потребителя;`}),`
+`,(0,c.jsx)(t.li,{children:`опубликуйте обновлённый зависимый package;`}),`
+`,(0,c.jsx)(t.li,{children:`только затем обновите host-приложение.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Нельзя отдельно переключить source consumer на новые exports, пока установленная версия library ещё не содержит перенесённые symbols.`}),`
+`,(0,c.jsx)(t.h3,{id:`что-не-нужно-менять`,children:`Что не нужно менять`}),`
+`,(0,c.jsxs)(t.p,{children:[`Imports, которые уже использовали `,(0,c.jsx)(t.code,{children:`/odata-service`}),`, остаются прежними:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildODataFilter } from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не путайте с transport entrypoint:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Это другой пакет; его имя не меняется из-за объединения lib-модулей.
+import {} from /* transport API */ "@ryuzaki13/react-foundation-api/odata";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`полная-карта-api`,children:`Полная карта API`}),`
+`,(0,c.jsx)(t.p,{children:`Раздел перечисляет все публичные symbols единого entrypoint. Если symbol отсутствует в этой карте, не импортируйте его через глубокий путь.`}),`
+`,(0,c.jsx)(t.h3,{id:`base-types-и-labels`,children:`Base types и labels`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`BaseMetaType`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`UI type: string/number/boolean/date.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BASE_META_TYPES`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Readonly список base types.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BASE_META_TYPE_LABELS`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Русские labels base types.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isBaseMetaType`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Runtime type guard base type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveBaseTypeLabel`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Label для base type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataMetaType`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Union всех поддерживаемых OData types.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataBooleanType`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Boolean group.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataNumericType`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Numeric group.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataIntegerType`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Integer subset.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataDateType`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Date/time group.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataStringType`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`String/guid/binary group.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BaseMethod`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`GET/POST/PUT/DELETE.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataOperationMethod`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`create/update/delete/read/query/fi.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isODataBooleanType`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Guard boolean type name.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isODataNumericType`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Guard numeric type name.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isODataIntegerType`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Guard integer type name.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isODataDateType`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Guard date type name.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-contracts-и-parser`,children:`Metadata contracts и parser`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`EntityPropertyBase`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Id + label.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`EntityPropertyBaseWithType`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Base property + OData type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`EntityParameterProperty`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Parameter metadata.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ColumnRole`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`measure/dimension.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`EntityColumnProperty`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Column metadata и code/text semantics.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`EntityMetadata`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Entity columns, parameters и result navigation.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ServiceEntities`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Entity map.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FunctionImportMetadata`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Function Import metadata.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ServiceFunctionImports`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Function Import map.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataTargetMetadata`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Entity или Function Import.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ServiceMetadata`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Полный результат parser.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parseServiceMetadata`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`EDMX XML → ServiceMetadata.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FORCED_CODE_TEXT_IDS`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Forced code/text base ids.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveMetadataColumnLabel`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Непустой label с fallback на id.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isForcedCodeTextId`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Проверка точного forced id.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isForcedCodeTextFamilyId`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Проверка forced base/text family.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`collectFilterableColumns`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Filterable column objects.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`collectFilterableColumnsIds`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Set filterable column ids.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`values-schemas-и-formatter-registry`,children:`Values, schemas и formatter registry`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`odataTypeSchemas`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Zod schemas OData primitive types.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isStringSafe`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Strict string guard.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isNumberSafe`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Number guard.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isBooleanSafe`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Boolean guard.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isDateSafe`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Valid Date guard.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataFormatValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`JavaScript value → OData literal.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataParseValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Raw value → значение по OData type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataParseValueByMetadata`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`Parsing с `,(0,c.jsx)(t.code,{children:`abapBooleanLike`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`defaultODataTypeValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Default по OData type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`defaultControlTypeValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Default по base UI type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getBaseTypeFromODataType`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`OData type → base type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataDateFormat`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`datetime/datetimeOffset/time literals.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFormatterFn`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Formatter function contract.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFormatterDescription`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Formatter registry item.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createFormatter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Generic Zod-validated formatter factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createBooleanFormatter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Boolean arguments factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createStringFormatter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`String arguments factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createNumberFormatter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Number arguments factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createDateFormatter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Date arguments factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getFormattersFor`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Registry items по OData type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getFormattersForBaseType`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Registry items по base type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getFormatter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Один formatter по OData type/id.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getFormatterForBaseType`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Один formatter по base type/id.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`parameters-и-path`,children:`Parameters и path`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`ODataParameterValue`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Scalar или scalar array для formatter.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataValue`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`{ value, formatter? }`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`InputValue`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Wrapped generic input.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UnwrappedODataParameters`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Flat OData parameters.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UnwrappedInputParameters`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Flat input parameters.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`WrappedODataParameters`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Wrapped OData parameters.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`WrappedInputParameters`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Wrapped input parameters.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`WrapODataParameters`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Generic flat → wrapped mapping.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UnwrapODataParameters`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Generic wrapped → flat mapping.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`wrapODataParams`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`Flat object → `,(0,c.jsx)(t.code,{children:`{ value }`}),` object.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unwrapODataParams`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Wrapped → sorted flat snapshot.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataServiceConfig`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`Service + target path segments.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildParameterEntries`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Metadata-ordered formatted entries.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildEntityParameters`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Entity parameter tuple.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildFunctionImportParameters`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Function Import URLSearchParams.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildEntityOperationPath`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Path по operation intent.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildFunctionImportPath`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Function Import path + query.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildEntityPath`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Parameterized entity path.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`простые-odata-filters`,children:`Простые OData filters`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`FilterOperation`})}),(0,c.jsx)(t.td,{children:`const и type`}),(0,c.jsx)(t.td,{children:`Operations и их union type.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FILTER_OPERATIONS`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`Readonly operations list.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isFilterOperation`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Runtime operation guard.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveOperationLabel`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Русский operation label.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterCondition`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`Одно field condition.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BaseFilterExpression`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsxs)(t.td,{children:[`Общий `,(0,c.jsx)(t.code,{children:`and?`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterConditionExpression`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`Leaf conditions.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterNestedExpression`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`Nested filters.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterExpression`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Union leaf/nested node.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildODataFilter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`Expression → `,(0,c.jsx)(t.code,{children:`$filter`}),` value.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildODataFilterRecursive`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Вариант с дополнительными скобками.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createFilter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Общая operation factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createFilterBetween`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`Range `,(0,c.jsx)(t.code,{children:`ge`}),`/`,(0,c.jsx)(t.code,{children:`le`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createFilterEqual`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Equality scalar/array.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createFilterEqualFalsy`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Equality с удалением falsy values.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createFilterContains`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`substringof`}),` scalar/array.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`mergeFilterExpressions`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Два expressions через AND.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`compiled-filter-definitions-1`,children:`Compiled filter definitions`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`ODataFilterValue`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Одно controlled filter value.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFilterValues`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Values по filter id.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFilterCondition`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Static/input condition.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFilterConditionGroup`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Condition group.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFilterOption`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`List option + filter.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataFilterBinding`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`List/boolean/value binding.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterDefinitionKind`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Supported definition kinds.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterRegisteredValueMode`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`single/multiple.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterSegmentComponentId`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Segment component ids.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterTreeComponentId`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Tree component ids.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterLocalComponentId`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Local component ids.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterAdvancedComponentId`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Advanced component id.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FilterComponentId`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Union известных component ids.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataCompiledFilterDefinition`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Discriminated definition union.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isFilterLocalComponentId`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Local component guard.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveODataFilterDefinitionColumnIds`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Potential physical columns.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveODataFilterDefinitionActiveColumnIds`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Active physical columns.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeDictionaryCodeKey`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Trim/remove redundant dictionary key.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sanitizeFilterConditionGroup`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Нормализация condition group.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sanitizeFilterBinding`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Нормализация binding.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sanitizeFilterDefinitions`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Нормализация definitions snapshot.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sanitizeFilterValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Нормализация одного value.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sanitizeFilterValues`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Нормализация values map.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`mergeFilterValuePatch`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Immutable normalized patch.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`collapseChainedODataSegmentFilterValues`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Самый глубокий segment chain.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`compileFiltersToExpression`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Definitions + values → expression.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`flattenFilterValuesToODataDependencies`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Segment/tree dependencies.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataChainItem`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Элемент dependency chain.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ODataChainsMap`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Карта dependency chains.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`sorts`,children:`Sorts`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`Sort`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`Key + optional descending flag.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getSortIndex`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Index key в sorting.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildODataOrder`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Sorting → order string.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toggleSort`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Цикл none/asc/desc.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveEffectiveSorts`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`User sorting или grouping fallback.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildODataOrderBy`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsxs)(t.td,{children:[`Effective `,(0,c.jsx)(t.code,{children:`$orderby`}),` либо undefined.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getSortIndicator`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`UI indicator state/order/lock.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`sql-like-filters`,children:`SQL-like filters`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`SqlFilterScalarValue`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`string/number/boolean.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SqlFilterOperation`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`eq/in.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SqlFilterEqualCondition`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Equality node.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SqlFilterInCondition`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`IN node.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SqlFilterCondition`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Condition union.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SqlFilterConjunction`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`and/or.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SqlFilterGroup`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Nested group.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SqlFilterExpression`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`Condition/group union.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isSqlFilterScalarValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Scalar guard.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`assertSqlFilterFieldId`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Safe field identifier check.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createSqlFilterEqual`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Equality factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createSqlFilterIn`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`IN factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createSqlFilterGroup`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Group factory.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildSqlFilter`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Legacy WHERE string.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`collections-store-и-utilities`,children:`Collections, store и utilities`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Symbol`}),(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:`CollectionItem`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`String record справочника.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`CollectionPair`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`codeKey/textKey.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`DependencyFilter`})}),(0,c.jsx)(t.td,{children:`interface`}),(0,c.jsx)(t.td,{children:`Key + collection values.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`findCollectionPairs`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Поиск code/text pairs.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildSeparatedArrays`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Разделение/dedupe/sort справочника.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useODataCollectionStore`})}),(0,c.jsx)(t.td,{children:`const/hook`}),(0,c.jsx)(t.td,{children:`Zustand state и setters defaults.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odataCollectionConfig`})}),(0,c.jsx)(t.td,{children:`const`}),(0,c.jsx)(t.td,{children:`React selector hooks.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeRangeValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Input → двухэлементный range.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeBaseValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Input → scalar/null.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isBaseValue`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Мягкий base value guard.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UnwrappedODataQueryResult`})}),(0,c.jsx)(t.td,{children:`type`}),(0,c.jsx)(t.td,{children:`TanStack result с распакованным data.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unwrapODataQueryResult`})}),(0,c.jsx)(t.td,{children:`function`}),(0,c.jsx)(t.td,{children:`Shallow unwrap query envelope.`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-вопросы`,children:`Частые вопросы`}),`
+`,(0,c.jsx)(t.h3,{id:`какой-import-использовать-для-odata`,children:`Какой import использовать для OData?`}),`
+`,(0,c.jsx)(t.p,{children:`Для metadata, values, path, filters, sorts, code/text helpers и collection config:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`"@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для HTTP/SAP Gateway/TanStack Query transport:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`"@ryuzaki13/react-foundation-api/odata";
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-нельзя-импортировать-прежний-odata`,children:[`Почему нельзя импортировать прежний `,(0,c.jsx)(t.code,{children:`/odata`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Модули объединены. Два entrypoint создавали искусственное разделение одного технического OData-контракта и заставляли consumer угадывать расположение helper-а.`}),`
+`,(0,c.jsx)(t.h3,{id:`нужно-ли-парсить-metadata-перед-каждым-request`,children:`Нужно ли парсить metadata перед каждым request?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Parser чисто преобразует XML, но может выполнять заметную работу. Получайте и кешируйте metadata на уровне API/query infrastructure, затем переиспользуйте `,(0,c.jsx)(t.code,{children:`ServiceMetadata`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-передать-обычный-object-params`,children:`Можно ли передать обычный object params?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Builder ожидает wrapped values. Используйте `,(0,c.jsx)(t.code,{children:`wrapODataParams(flat)`}),` или создайте `,(0,c.jsx)(t.code,{children:`{ value, formatter? }`}),` вручную.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-массив-параметра-требует-formatter`,children:`Почему массив параметра требует formatter?`}),`
+`,(0,c.jsx)(t.p,{children:`OData parameter metadata описывает scalar. Library не может угадать backend-specific способ сериализации массива: CSV, range, JSON, repeated query parameter или другое соглашение.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-число-125-не-форматируется-в-фильтре-автоматически`,children:[`Почему число `,(0,c.jsx)(t.code,{children:`12.5`}),` не форматируется в фильтре автоматически?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Без `,(0,c.jsx)(t.code,{children:`condition.type`}),` number выводится как `,(0,c.jsx)(t.code,{children:`int`}),`. Укажите точный metadata type, например `,(0,c.jsx)(t.code,{children:`decimal`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-createfilterbetween0-null-пустой`,children:[`Почему `,(0,c.jsx)(t.code,{children:`createFilterBetween([0, null])`}),` пустой?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Текущая фабрика partial range использует truthy-проверку. Для нулевой границы создайте explicit `,(0,c.jsx)(t.code,{children:`createFilter(..., "ge")`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-пустая-строка-иногда-сохраняется`,children:`Почему пустая строка иногда сохраняется?`}),`
+`,(0,c.jsxs)(t.p,{children:[`В compiled filters пустая строка является допустимым scalar и option key. Это нужно для SAP-состояний, где empty char имеет смысл. `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` означают отсутствие, а `,(0,c.jsx)(t.code,{children:`""`}),` может быть реальным условием.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-использовать-sql-like-builder-для-filter`,children:[`Можно ли использовать SQL-like builder для `,(0,c.jsx)(t.code,{children:`$filter`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Это разные syntaxes и разные transport boundaries.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-codetext-pair-не-нашлась`,children:`Почему code/text pair не нашлась?`}),`
+`,(0,c.jsx)(t.p,{children:`Проверьте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`suffix text field;`}),`
+`,(0,c.jsx)(t.li,{children:`точное совпадение регистра base key;`}),`
+`,(0,c.jsx)(t.li,{children:`наличие обоих keys в первом row;`}),`
+`,(0,c.jsxs)(t.li,{children:[`custom `,(0,c.jsx)(t.code,{children:`textSuffixes`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не использовано ли поле другой pair.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`где-форматировать-server-value-для-отображения`,children:`Где форматировать server value для отображения?`}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`}),` или table formatter pipeline. OData literal formatter предназначен для request, а не для UI.`]}),`
+`,(0,c.jsx)(t.h3,{id:`где-выполнять-request`,children:`Где выполнять request?`}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`}),` или через согласованный transport host-приложения. Этот модуль только подготавливает данные.`]}),`
+`,(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-api/odata`}),` — OData transport, queries и mutations.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`}),` — отображение дат, чисел, строк и pipeline.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/table`}),` — TanStack Table metadata adapter.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/range-output`}),` — подстановка открытых границ диапазона перед внешней передачей.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/xml`}),` — общие XML parsing/building helpers.`]}),`
+`]})]})}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};