@ryuzaki13/react-foundation-ui 1.4.2 → 1.4.3

package/storybook-static/assets/odataAndTables-OEVW-gFK.js

@@ -0,0 +1,126 @@
+import{n as e}from"./rolldown-runtime-C0FnF6B9.js";import{n as t}from"./iframe-CrnMVMTc.js";import{i as n,r}from"./react-qN2cStNd.js";import{l as i,m as a}from"./blocks-Dz3dJBcm.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,p:`p`,pre:`pre`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/OData, таблицы и формулы`}),`
+`,(0,c.jsx)(t.h1,{id:`odata-metadata-таблицы-и-формулы`,children:`OData metadata, таблицы и формулы`}),`
+`,(0,c.jsxs)(t.p,{children:[`Здесь находятся чистые OData V2 helpers и runtime contracts для TanStack Table. Они не выполняют запросы. Для SAP Gateway transport, SSO, X-CSRF, metadata fetch и TanStack Query operation используйте `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`}),`.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`odata-service-metadata-и-odata-v2-values`,children:[(0,c.jsx)(t.code,{children:`odata-service`}),`: metadata и OData V2 values`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	buildEntityPath,
+	buildODataFilter,
+	buildODataOrderBy,
+	odataFormatValue,
+	parseServiceMetadata,
+	wrapODataParams
+} from "@ryuzaki13/react-foundation-lib/odata-service";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`основной-поток`,children:`Основной поток`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`metadata XML → parseServiceMetadata → typed metadata/config
+  → wrapODataParams + builder/filter/sort → foundation-api transport
+  → metadata-aware parse/format → entity/feature mapping
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не передавайте в helpers невалидный external JSON как будто он уже соответствует domain model. Metadata parser описывает OData contract, а domain validation/mapping остаётся у host entity/feature.`}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-paths-и-параметры`,children:`Metadata, paths и параметры`}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                        | Результат                                                                                                                                             |
+| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`parseServiceMetadata(xmlText)`}),`                            | Парсит OData V2 XML в `,(0,c.jsx)(t.code,{children:`ServiceMetadata`}),`: entities, properties, FunctionImports, keys, parameters и типы. Некорректный XML/metadata — ошибка boundary. |
+| `,(0,c.jsx)(t.code,{children:`resolveMetadataColumnLabel(column)`}),`                       | Label с fallback на column id.                                                                                                                        |
+| `,(0,c.jsx)(t.code,{children:`collectFilterableColumns`}),`, `,(0,c.jsx)(t.code,{children:`collectFilterableColumnsIds`}),`  | Отбирают filterable metadata fields.                                                                                                                  |
+| `,(0,c.jsx)(t.code,{children:`wrapODataParams(params)`}),`, `,(0,c.jsx)(t.code,{children:`unwrapODataParams(params)`}),`     | Разделяют значения параметров и их OData type; используйте перед builder, а не сериализуйте вручную.                                                  |
+| `,(0,c.jsx)(t.code,{children:`buildParameterEntries`}),`, `,(0,c.jsx)(t.code,{children:`buildEntityParameters`}),`           | Строят key/predicate часть entity из metadata и wrapped params.                                                                                       |
+| `,(0,c.jsx)(t.code,{children:`buildEntityPath`}),`, `,(0,c.jsx)(t.code,{children:`buildEntityOperationPath`}),`              | Возвращают metadata-aware путь entity/operation.                                                                                                      |
+| `,(0,c.jsx)(t.code,{children:`buildFunctionImportParameters`}),`, `,(0,c.jsx)(t.code,{children:`buildFunctionImportPath`}),` | Строят FunctionImport URL/query через `,(0,c.jsx)(t.code,{children:`URLSearchParams`}),`.                                                                                              |`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const metadata = parseServiceMetadata(metadataXml);
+const params = wrapODataParams({ id: "42" });
+const path = buildEntityPath(entityMetadata, { service: "DEMO_SRV", target: "Items" }, params);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Типы `,(0,c.jsx)(t.code,{children:`ServiceMetadata`}),`, `,(0,c.jsx)(t.code,{children:`EntityMetadata`}),`, `,(0,c.jsx)(t.code,{children:`FunctionImportMetadata`}),`, `,(0,c.jsx)(t.code,{children:`EntityColumnProperty`}),`, `,(0,c.jsx)(t.code,{children:`ODataMetaType`}),`, `,(0,c.jsx)(t.code,{children:`WrappedODataParameters`}),` и `,(0,c.jsx)(t.code,{children:`ODataServiceConfig`}),` экспортируются из того же subpath. Параметры entity и FunctionImport — разные OData contracts; не смешивайте их.`]}),`
+`,(0,c.jsx)(t.h3,{id:`значения-и-formatter-registry`,children:`Значения и formatter registry`}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                                                                                  | Назначение                                                                                             |
+| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `,(0,c.jsx)(t.code,{children:`odataFormatValue(type, value)`}),`                                                                                      | Сериализует primitive в OData literal с escaping/suffix/date semantics.                                |
+| `,(0,c.jsx)(t.code,{children:`odataParseValue(type, value)`}),`                                                                                       | Возвращает primitive/date или исходное `,(0,c.jsx)(t.code,{children:`unknown`}),`, если значение не может быть безопасно преобразовано. |
+| `,(0,c.jsx)(t.code,{children:`odataParseValueByMetadata(descriptor, value)`}),`                                                                       | Парсит с учётом metadata descriptor, включая ABAP boolean-like поле.                                   |
+| `,(0,c.jsx)(t.code,{children:`defaultODataTypeValue`}),`, `,(0,c.jsx)(t.code,{children:`defaultControlTypeValue`}),`                                                                   | Default value для OData/base control type.                                                             |
+| `,(0,c.jsx)(t.code,{children:`getBaseTypeFromODataType`}),`, `,(0,c.jsx)(t.code,{children:`isODataBooleanType`}),`, `,(0,c.jsx)(t.code,{children:`isODataNumericType`}),`, `,(0,c.jsx)(t.code,{children:`isODataIntegerType`}),`, `,(0,c.jsx)(t.code,{children:`isODataDateType`}),`      | Type classification.                                                                                   |
+| `,(0,c.jsx)(t.code,{children:`getFormattersFor`}),`, `,(0,c.jsx)(t.code,{children:`getFormattersForBaseType`}),`, `,(0,c.jsx)(t.code,{children:`getFormatter`}),`, `,(0,c.jsx)(t.code,{children:`getFormatterForBaseType`}),`                            | Читают встроенный formatter descriptions по type/id.                                                   |
+| `,(0,c.jsx)(t.code,{children:`createFormatter`}),`, `,(0,c.jsx)(t.code,{children:`createBooleanFormatter`}),`, `,(0,c.jsx)(t.code,{children:`createStringFormatter`}),`, `,(0,c.jsx)(t.code,{children:`createNumberFormatter`}),`, `,(0,c.jsx)(t.code,{children:`createDateFormatter`}),` | Создают typed formatter definitions с Zod input schema.                                                |`]}),`
+`,(0,c.jsx)(t.h3,{id:`фильтры-sorts-и-sql-like-expressions`,children:`Фильтры, sorts и SQL-like expressions`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`FilterExpression<T>`}),` — serializable дерево с `,(0,c.jsx)(t.code,{children:`FilterConditionExpression`}),` и `,(0,c.jsx)(t.code,{children:`FilterNestedExpression`}),`. Постройте его через `,(0,c.jsx)(t.code,{children:`createFilter`}),`, `,(0,c.jsx)(t.code,{children:`createFilterEqual`}),`, `,(0,c.jsx)(t.code,{children:`createFilterEqualFalsy`}),`, `,(0,c.jsx)(t.code,{children:`createFilterContains`}),`, `,(0,c.jsx)(t.code,{children:`createFilterBetween`}),`, объедините через `,(0,c.jsx)(t.code,{children:`mergeFilterExpressions`}),`, затем вызовите `,(0,c.jsx)(t.code,{children:`buildODataFilter`}),` или `,(0,c.jsx)(t.code,{children:`buildODataFilterRecursive`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const expression = createFilterEqual<{ status: string }, string>("status", "active");
+const filter = buildODataFilter(expression);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                                                   | Контракт                                                                                                                     |
+| ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`FilterOperation`}),`, `,(0,c.jsx)(t.code,{children:`FILTER_OPERATIONS`}),`, `,(0,c.jsx)(t.code,{children:`isFilterOperation`}),`, `,(0,c.jsx)(t.code,{children:`resolveOperationLabel`}),`  | Стабильный список и validation operator-ов.                                                                                  |
+| `,(0,c.jsx)(t.code,{children:`Sort<T>`}),`, `,(0,c.jsx)(t.code,{children:`toggleSort`}),`, `,(0,c.jsx)(t.code,{children:`getSortIndex`}),`, `,(0,c.jsx)(t.code,{children:`getSortIndicator`}),`                           | Immutable sort state для UI.                                                                                                 |
+| `,(0,c.jsx)(t.code,{children:`buildODataOrder`}),`, `,(0,c.jsx)(t.code,{children:`resolveEffectiveSorts`}),`, `,(0,c.jsx)(t.code,{children:`buildODataOrderBy`}),`                       | Сериализуют sort/grouping для OData.                                                                                         |
+| `,(0,c.jsx)(t.code,{children:`createSqlFilterEqual`}),`, `,(0,c.jsx)(t.code,{children:`createSqlFilterIn`}),`, `,(0,c.jsx)(t.code,{children:`createSqlFilterGroup`}),`, `,(0,c.jsx)(t.code,{children:`buildSqlFilter`}),` | Отдельный SQL-filter contract: field id предварительно валидируется. Не подставляйте произвольный пользовательский field id. |`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ODataCompiledFilterDefinition`}),`, `,(0,c.jsx)(t.code,{children:`sanitizeFilterDefinitions`}),`, `,(0,c.jsx)(t.code,{children:`sanitizeFilterValues`}),`, `,(0,c.jsx)(t.code,{children:`mergeFilterValuePatch`}),`, `,(0,c.jsx)(t.code,{children:`compileFiltersToExpression`}),`, `,(0,c.jsx)(t.code,{children:`flattenFilterValuesToODataDependencies`}),` предназначены для serializable UI filter configuration. Санитизация создаёт canonical configuration; не записывайте её поверх активного пользовательского draft без явно названной save/restore boundary.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`odata-codetext-collections`,children:[(0,c.jsx)(t.code,{children:`odata`}),`: code/text collections`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildSeparatedArrays, findCollectionPairs, ODataDateFormat } from "@ryuzaki13/react-foundation-lib/odata";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                    | Назначение                                                                |
+| ------------------------------------------------------ | ------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`buildSeparatedArrays(collection, ...)`}),`                | Разделяет OData collection на code/text arrays для select-like consumers. |
+| `,(0,c.jsx)(t.code,{children:`findCollectionPairs(...)`}),`                             | Находит code/text pair по collection/dependency filters.                  |
+| `,(0,c.jsx)(t.code,{children:`ODataDateFormat`}),`                                      | Константы date formats для legacy OData values.                           |
+| `,(0,c.jsx)(t.code,{children:`CollectionItem`}),`, `,(0,c.jsx)(t.code,{children:`CollectionPair`}),`, `,(0,c.jsx)(t.code,{children:`DependencyFilter`}),` | Публичные contracts коллекций.                                            |`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useODataCollectionStore`}),` и `,(0,c.jsx)(t.code,{children:`odataCollectionConfig`}),` описаны на странице Runtime/state: это UI defaults, а не OData transport/cache.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`table-tanstack-table-contracts`,children:[(0,c.jsx)(t.code,{children:`table`}),`: TanStack Table contracts`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildTableColumnLayout, createTableColumnsFromODataMetadata, useTableRowSelection } from "@ryuzaki13/react-foundation-lib/table";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`TableColumnDef<TData>`}),` расширяет TanStack `,(0,c.jsx)(t.code,{children:`ColumnDef`}),`, а `,(0,c.jsx)(t.code,{children:`TableColumnMeta`}),`/`,(0,c.jsx)(t.code,{children:`TableColumnFormattingMeta`}),` описывают common metadata. Не мутируйте исходные `,(0,c.jsx)(t.code,{children:`ColumnDef`}),`: layout/order/sizing helpers возвращают новое состояние.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`| Группа    | Public API                                                                                                                                                                |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Layout    | `,(0,c.jsx)(t.code,{children:`resolveTableColumnOrder`}),`, `,(0,c.jsx)(t.code,{children:`buildTableColumnLayout`}),`, `,(0,c.jsx)(t.code,{children:`TableColumnLayoutItem`}),`, `,(0,c.jsx)(t.code,{children:`BuildTableColumnLayoutArgs`}),`.                                                               |
+| Order     | `,(0,c.jsx)(t.code,{children:`normalizeTableColumnOrder`}),`, `,(0,c.jsx)(t.code,{children:`reorderTableHeaderColumns`}),`, `,(0,c.jsx)(t.code,{children:`resolveReorderedTableHeaderColumns`}),`, `,(0,c.jsx)(t.code,{children:`TableColumnOrderState`}),`.                                                  |
+| Sizing    | `,(0,c.jsx)(t.code,{children:`DEFAULT_TABLE_COLUMN_MIN_WIDTH`}),`, `,(0,c.jsx)(t.code,{children:`normalizeTableColumnWidth`}),`, `,(0,c.jsx)(t.code,{children:`normalizeTableColumnSizing`}),`, `,(0,c.jsx)(t.code,{children:`patchTableColumnWidth`}),`, `,(0,c.jsx)(t.code,{children:`removeTableColumnWidth`}),`, `,(0,c.jsx)(t.code,{children:`TableColumnSizingState`}),`. |
+| Selection | `,(0,c.jsx)(t.code,{children:`TableSelectionMode`}),`, `,(0,c.jsx)(t.code,{children:`toggleTableRowSelection`}),`, `,(0,c.jsx)(t.code,{children:`pruneTableRowSelection`}),`, `,(0,c.jsx)(t.code,{children:`useTableRowSelection`}),`.                                                                        |
+| Metadata  | `,(0,c.jsx)(t.code,{children:`getTableColumnMeta`}),`, `,(0,c.jsx)(t.code,{children:`getTableColumnFormattingMeta`}),`, `,(0,c.jsx)(t.code,{children:`resolveTableLength`}),`, `,(0,c.jsx)(t.code,{children:`isTableInteractiveElement`}),`.                                                                  |`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useTableRowSelection`}),` синхронизирует selection state с TanStack Table. Передавайте устойчивый `,(0,c.jsx)(t.code,{children:`getRowId`}),` на business identity, не array index: изменяемая сортировка/фильтрация иначе свяжет selection с неверной строкой.`]}),`
+`,(0,c.jsx)(t.h3,{id:`metadata-driven-odata-adapter`,children:`Metadata-driven OData adapter`}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                          | Назначение                                                                                |
+| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`createTableColumnsFromODataMetadata(options)`}),`               | Строит `,(0,c.jsx)(t.code,{children:`TableColumnDef`}),` из OData metadata.                                                |
+| `,(0,c.jsx)(t.code,{children:`enrichTableColumnsWithODataFormatting(columns, options)`}),`    | Добавляет typed formatting metadata к существующим columns без изменения OData transport. |
+| `,(0,c.jsx)(t.code,{children:`createTableColumnVisibilityFromODataMetadata(...)`}),`          | Формирует initial column visibility.                                                      |
+| `,(0,c.jsx)(t.code,{children:`resolveTableColumnFormattingContextFromODataColumn(column)`}),` | Создаёт formatter context для одного metadata column.                                     |
+| `,(0,c.jsx)(t.code,{children:`resolveStableColumnId(column)`}),`                              | Определяет устойчивый id table column.                                                    |`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`meta.formatting`}),` — экспериментальный presentation contract, не OData request. Если pipeline требует дополнительные runtime fields, owner Query должен расширить select/dependencies через documented formatter pipeline API до fetch.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`tree-table-построение-дерева`,children:[(0,c.jsx)(t.code,{children:`tree-table`}),`: построение дерева`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildTreeTableRows, transposeFlatRowsToTreeTableRows } from "@ryuzaki13/react-foundation-lib/tree-table";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                                                                         | Контракт                                                                  |
+| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`buildTreeTableRows(rows, hierarchy)`}),`                                                                       | Строит `,(0,c.jsx)(t.code,{children:`TreeTableBuildResult`}),`: tree rows и diagnostics от flat hierarchy. |
+| `,(0,c.jsx)(t.code,{children:`transposeFlatRowsToTreeTableRows(rows, options)`}),`                                                           | Создаёт display tree/синтетические nodes из flat rows.                    |
+| `,(0,c.jsx)(t.code,{children:`TreeTableFlatHierarchy`}),`, `,(0,c.jsx)(t.code,{children:`TreeTableRowNode`}),`, `,(0,c.jsx)(t.code,{children:`TreeTableTransposedRow`}),`, `,(0,c.jsx)(t.code,{children:`TreeTableTransposeFlatRowsOptions`}),` | Публичные contracts и metadata fields.                                    |`]}),`
+`,(0,c.jsx)(t.p,{children:`Функции не меняют исходные rows. Используйте explicit stable row/parent ids; не рассчитывайте на визуальный label как идентичность.`}),`
+`,(0,c.jsxs)(t.h2,{id:`formulas-registry-calculated-columns`,children:[(0,c.jsx)(t.code,{children:`formulas`}),`: registry calculated columns`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	compileTableFormula,
+	configureTableFormulaRegistry,
+	createTableFormulaRegistry,
+	executeTableFormula,
+	validateTableFormulaDependencies
+} from "@ryuzaki13/react-foundation-lib/formulas";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`инициализация`,children:`Инициализация`}),`
+`,(0,c.jsxs)(t.p,{children:[`Host владеет `,(0,c.jsx)(t.code,{children:`TableFormulaDefinition[]`}),` и один раз, до первого compile/validate/execute, создаёт и устанавливает registry:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const registry = createTableFormulaRegistry([
+	{
+		id: "margin",
+		name: "Маржа",
+		description: "Выручка минус себестоимость",
+		fn: (ctx) => ctx.num(0) - ctx.num(1)
+	}
+]);
+configureTableFormulaRegistry(registry);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                  | Результат                                                                                                            |
+| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`createTableFormulaContext({ keys, rowData })`}),`       | Контекст `,(0,c.jsx)(t.code,{children:`key/value/num(index)`}),` для formula function.                                                                |
+| `,(0,c.jsx)(t.code,{children:`createTableFormulaRegistry(definitions)`}),`            | Проверяет non-empty unique ids и создаёт immutable registry.                                                         |
+| `,(0,c.jsx)(t.code,{children:`getTableFormulaList`}),`, `,(0,c.jsx)(t.code,{children:`getTableFormulaById`}),`         | Читают активный registry.                                                                                            |
+| `,(0,c.jsx)(t.code,{children:`compileTableFormula({ formulaId, keys? })`}),`          | Компилирует executor или controlled compile result.                                                                  |
+| `,(0,c.jsx)(t.code,{children:`executeTableFormula({ formulaId, keys?, rowData })`}),` | Одноразово выполняет formula и возвращает `,(0,c.jsx)(t.code,{children:`TableFormulaExecutionResult`}),`, не выбрасывая formula runtime error наружу. |
+| `,(0,c.jsx)(t.code,{children:`validateTableFormulaDependencies(args)`}),`             | Проверяет formula id, dependency availability, out-of-range/unused indices.                                          |`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Formula function возвращает finite number. Ошибочные состояния (`,(0,c.jsx)(t.code,{children:`formula_not_found`}),`, `,(0,c.jsx)(t.code,{children:`runtime_error`}),`, `,(0,c.jsx)(t.code,{children:`invalid_result`}),`) являются данными результата, а не поводом silently подставить ноль. Обработайте их у formatter/table owner и показывайте безопасный fallback.`]})]})}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};

package/storybook-static/assets/{odataFetchFn-BVgXXKgx.js → odataFetchFn-BLWeF0ZQ.js}

@@ -1,4 +1,4 @@
-import{i as e}from"./preload-helper-B45gAKPr.js";import{t}from"./iframe-BJGIOdSH.js";import{E as n,c as r,l as i,m as a}from"./blocks-ixiC6_NZ.js";import{t as o}from"./mdx-react-shim-CmoAsjhK.js";var s,c=e((()=>{s=`# OData API Helpers
+import{n as e}from"./rolldown-runtime-C0FnF6B9.js";import{n as t}from"./iframe-CrnMVMTc.js";import{i as n,r}from"./react-qN2cStNd.js";import{c as i,l as a,m as o}from"./blocks-Dz3dJBcm.js";var s;function c(){return(c=e((()=>{s=`# OData API Helpers
 
 Этот каталог содержит helper-функции для выполнения OData-запросов с опорой на metadata сервиса.
 
@@ -759,5 +759,5 @@ Promise<{
 - \`parseODataResponseByMetadata.ts\` — автопарсинг ответа по metadata
 - \`useODataMetadataQuery.ts\` — загрузка metadata
 - \`wrapParams.ts\` — helper для сборки \`ODataParameters\`
-`}));function l(e){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(i,{title:`Документация/shared/api/odata/fetchFn`}),`
-`,(0,d.jsx)(r,{children:s})]})}function u(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,d.jsx)(t,{...e,children:(0,d.jsx)(l,{...e})}):l(e)}var d;e((()=>{d=t(),o(),a(),c()}))();export{u as default};
+`})))()}function l(e){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(a,{title:`Документация/shared/api/odata/fetchFn`}),`
+`,(0,d.jsx)(i,{children:s})]})}function u(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,d.jsx)(t,{...e,children:(0,d.jsx)(l,{...e})}):l(e)}var d;function f(){return(f=e((()=>{d=t(),r(),o(),c()})))()}f();export{u as default};

package/storybook-static/assets/odataStoryFixtures-BbswaX_5.js

@@ -0,0 +1,25 @@
+import{n as e}from"./rolldown-runtime-C0FnF6B9.js";import{t}from"./react-C21x__mS.js";import{n}from"./iframe-CrnMVMTc.js";import{D as r,E as i,O as a,k as o}from"./odata-BaxgzNGj.js";var s,c;function l(){return(l=e((()=>{s=[{code:`R01`,text:`Северный регион`,branches:[{code:`B0101`,text:`Подразделение Альфа`,teams:[{code:`T0101`,text:`Команда поддержки`,owners:[{code:`P0001`,text:`Ответственный 1`},{code:`P0002`,text:`Ответственный 2`},{code:`P0003`,text:`Ответственный 3`}]},{code:`T0102`,text:`Команда внедрения`,owners:[{code:`P0004`,text:`Ответственный 4`},{code:`P0005`,text:`Ответственный 5`}]}]},{code:`B0102`,text:`Подразделение Бета`,teams:[{code:`T0201`,text:`Команда аналитики`,owners:[{code:`P0006`,text:`Ответственный 6`},{code:`P0007`,text:`Ответственный 7`}]}]}]},{code:`R02`,text:`Южный регион`,branches:[{code:`B0201`,text:`Подразделение Гамма`,teams:[{code:`T0301`,text:`Команда сопровождения`,owners:[{code:`P0008`,text:`Ответственный 8`},{code:`P0009`,text:`Ответственный 9`}]}]}]},{code:`R03`,text:`Восточный регион`,branches:[{code:`B0301`,text:`Подразделение Дельта`,teams:[{code:`T0401`,text:`Команда развития`,owners:[{code:`P0010`,text:`Ответственный 10`},{code:`P0011`,text:`Ответственный 11`}]}]},{code:`B0302`,text:`Подразделение Омега`,teams:[{code:`T0501`,text:`Команда качества`,owners:[{code:`P0012`,text:`Ответственный 12`},{code:`P0013`,text:`Ответственный 13`}]}]}]}],c=s.flatMap(e=>e.branches.flatMap(t=>t.teams.flatMap(n=>n.owners.map(r=>({REGION:e.code,REGION_Text:e.text,BRANCH:t.code,BRANCH_Text:t.text,TEAM:n.code,TEAM_Text:n.text,OWNER:r.code,OWNER_Text:r.text})))))})))()}function u(e,t,n=200){return new Response(e,{status:n,headers:{"Content-Type":t}})}function d(e,t){return new Promise((n,r)=>{let i=()=>{window.clearTimeout(a),r(t?.reason??new DOMException(`Ожидание OData mock отменено`,`AbortError`))},a=window.setTimeout(()=>{t?.removeEventListener(`abort`,i),n()},e);if(t?.aborted){i();return}t?.addEventListener(`abort`,i,{once:!0})})}function f(e,t){for(let n of t.values())if(e.includes(`/${n.service}/`))return n}function p(){let e=window.fetch,t=new Map;return{originalFetch:e,registrations:t,registrationIdsByCanvas:new WeakMap,mockedFetch:async(n,r)=>{let i=typeof n==`string`?n:n instanceof URL?n.toString():n.url,a=new URL(i,window.location.origin).pathname,o=f(a,t);return o?(o.mode===`loading`&&await d(1200,r?.signal??(typeof Request<`u`&&n instanceof Request?n.signal:void 0)),a.endsWith(`/${o.service}/$metadata`)?o.mode===`metadataError`?u(`Ошибка чтения metadata`,`text/plain`,500):u(y,`application/xml`):a.endsWith(`/${o.service}/DemoReferenceItems`)?o.mode===`collectionError`?u(JSON.stringify({error:`Ошибка загрузки справочника`}),`application/json`,500):u(JSON.stringify({d:{results:c}}),`application/json`):e(n,r)):e(n,r)}}}function m(e){let t=e.parameters.odataMockMode??`success`,n=C??p(),r=(e.canvasElement&&n.registrationIdsByCanvas.get(e.canvasElement))??Symbol(`odata-story-fetch-mock`),i=Symbol(`odata-story-fetch-mock-version`);return C=n,e.canvasElement&&n.registrationIdsByCanvas.set(e.canvasElement,r),n.registrations.delete(r),n.registrations.set(r,{mode:t,service:S[t],version:i}),window.fetch=n.mockedFetch,()=>{n.registrations.get(r)?.version===i&&(n.registrations.delete(r),e.canvasElement&&n.registrationIdsByCanvas.delete(e.canvasElement),!(n.registrations.size>0||C!==n)&&(window.fetch===n.mockedFetch&&(window.fetch=n.originalFetch),C=void 0))}}var h,g,_,v,y,b,x,S,C,w,T,E,D,O;function k(){return(k=e((()=>{h=t(),o(),r(),l(),g=n(),_=`DEMO_REFERENCE_SRV`,v=`DemoReferenceItems`,y=`<?xml version="1.0" encoding="utf-8"?>
+<edmx:Edmx xmlns:edmx="http://schemas.microsoft.com/ado/2007/06/edmx">
+	<edmx:DataServices xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" m:DataServiceVersion="2.0">
+		<Schema Namespace="DEMO_REFERENCE_SRV" xmlns="http://schemas.microsoft.com/ado/2008/09/edm" xmlns:sap="http://www.sap.com/Protocols/SAPData">
+			<EntityType Name="DemoReferenceItemsType" sap:semantics="aggregate" sap:label="Демо-справочник" sap:content-version="1">
+				<Key>
+					<PropertyRef Name="ID" />
+				</Key>
+				<Property Name="ID" Type="Edm.String" Nullable="false" sap:sortable="false" sap:filterable="false" />
+				<Property Name="REGION" Type="Edm.String" MaxLength="4" sap:aggregation-role="dimension" sap:display-format="UpperCase" sap:text="REGION_Text" />
+				<Property Name="REGION_Text" Type="Edm.String" MaxLength="40" sap:label="Регион" sap:quickinfo="Краткое описание" sap:creatable="false" sap:updatable="false" />
+				<Property Name="BRANCH" Type="Edm.String" MaxLength="8" sap:aggregation-role="dimension" sap:display-format="UpperCase" sap:text="BRANCH_Text" />
+				<Property Name="BRANCH_Text" Type="Edm.String" MaxLength="40" sap:label="Подразделение" sap:quickinfo="Среднее описание" sap:creatable="false" sap:updatable="false" />
+				<Property Name="TEAM" Type="Edm.String" MaxLength="8" sap:aggregation-role="dimension" sap:display-format="UpperCase" sap:text="TEAM_Text" />
+				<Property Name="TEAM_Text" Type="Edm.String" MaxLength="40" sap:label="Команда" sap:quickinfo="Среднее описание" sap:creatable="false" sap:updatable="false" />
+				<Property Name="OWNER" Type="Edm.String" MaxLength="8" sap:aggregation-role="dimension" sap:display-format="UpperCase" sap:text="OWNER_Text" />
+				<Property Name="OWNER_Text" Type="Edm.String" MaxLength="40" sap:label="Ответственный" sap:quickinfo="Среднее описание" sap:creatable="false" sap:updatable="false" />
+				<Property Name="CNT" Type="Edm.Byte" sap:aggregation-role="measure" sap:filterable="false" />
+			</EntityType>
+			<EntityContainer Name="DEMO_REFERENCE_SRV_Entities" m:IsDefaultEntityContainer="true">
+				<EntitySet Name="DemoReferenceItems" EntityType="DEMO_REFERENCE_SRV.DemoReferenceItemsType" sap:creatable="false" sap:updatable="false" sap:deletable="false" sap:content-version="1" />
+			</EntityContainer>
+		</Schema>
+	</edmx:DataServices>
+</edmx:Edmx>`,b={region:`R01`,regionText:`Северный регион`,branch:`B0101`,branchAlt:`B0102`,team:`T0101`,teamAlt:`T0201`,owner:`P0001`,ownerAlt:`P0006`},x={REGION:{placeholder:`Регион`},BRANCH:{placeholder:`Подразделение`,hideCode:!0},TEAM:{placeholder:`Команда`},OWNER:{placeholder:`Ответственный`}},S={success:_,loading:`DEMO_REFERENCE_LOADING_SRV`,metadataError:`DEMO_REFERENCE_METADATA_ERROR_SRV`,collectionError:`DEMO_REFERENCE_COLLECTION_ERROR_SRV`},w=e=>{let t=(0,h.useMemo)(()=>new a({defaultOptions:{queries:{retry:!1,throwOnError:!1},mutations:{retry:!1,throwOnError:!1}}}),[]),n=e;return(0,h.useEffect)(()=>()=>{t.clear()},[t]),(0,g.jsx)(i,{client:t,children:(0,g.jsx)(n,{})})},T={service:_,target:v},E={success:T,loading:{...T,service:S.loading},metadataError:{...T,service:S.metadataError},collectionError:{...T,service:S.collectionError}},D={codeKey:`REGION`,minSearchTextLength:1,minSearchCodeLength:1,searchDebounceDelay:250,maxVisibleItems:100},O={placeholder:`Регион`},w.__docgenInfo={description:`Создаёт изолированный QueryClient без IndexedDB persistence для каждой OData story.`,methods:[],displayName:`withODataStoryQueryClient`}})))()}export{m as a,x as c,k as i,w as l,T as n,E as o,O as r,b as s,D as t};

package/storybook-static/assets/{persisted-D8qUQbts.js → persisted-BpFojVXw.js}

@@ -1,4 +1,4 @@
-import{i as e}from"./preload-helper-B45gAKPr.js";import{t}from"./iframe-BJGIOdSH.js";import{E as n,c as r,l as i,m as a}from"./blocks-ixiC6_NZ.js";import{t as o}from"./mdx-react-shim-CmoAsjhK.js";var s,c=e((()=>{s=`# persisted
+import{n as e}from"./rolldown-runtime-C0FnF6B9.js";import{n as t}from"./iframe-CrnMVMTc.js";import{i as n,r}from"./react-qN2cStNd.js";import{c as i,l as a,m as o}from"./blocks-Dz3dJBcm.js";var s;function c(){return(c=e((()=>{s=`# persisted
 
 Внутренний infrastructural-модуль для переиспользуемой работы с сохранёнными записями: \`variant\`, \`view-config\`, \`preset\` и похожими сущностями.
 
@@ -596,5 +596,5 @@ Capability-based модель нужна именно для того, чтоб
 - Вынесена ли доменная бизнес-логика за пределы \`persisted\`?
 
 Если на все вопросы есть понятный ответ, ресурс почти наверняка хорошо ложится на этот модуль.
-`}));function l(e){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(i,{title:`Документация/shared/api/persisted`}),`
-`,(0,d.jsx)(r,{children:s})]})}function u(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,d.jsx)(t,{...e,children:(0,d.jsx)(l,{...e})}):l(e)}var d;e((()=>{d=t(),o(),a(),c()}))();export{u as default};
+`})))()}function l(e){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(a,{title:`Документация/shared/api/persisted`}),`
+`,(0,d.jsx)(i,{children:s})]})}function u(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,d.jsx)(t,{...e,children:(0,d.jsx)(l,{...e})}):l(e)}var d;function f(){return(f=e((()=>{d=t(),r(),o(),c()})))()}f();export{u as default};

package/storybook-static/assets/preload-helper-BHmFeTtP.js

@@ -0,0 +1 @@
+import{n as e}from"./rolldown-runtime-C0FnF6B9.js";var t,n,r,i;function a(){return(a=e((()=>{t=`modulepreload`,n=function(e,t){return new URL(e,t).href},r={},i=function(e,i,a){let o=Promise.resolve();if(i&&i.length>0){let e=document.getElementsByTagName(`link`),s=document.querySelector(`meta[property=csp-nonce]`),c=s?.nonce||s?.getAttribute(`nonce`);function l(e){return Promise.all(e.map(e=>Promise.resolve(e).then(e=>({status:`fulfilled`,value:e}),e=>({status:`rejected`,reason:e}))))}function u(e){return import.meta.resolve?import.meta.resolve(e):new URL(e,import.meta.url).href}o=l(i.map(i=>{if(i=n(i,a),i=u(i),i in r)return;r[i]=!0;let o=i.endsWith(`.css`);for(let t=e.length-1;t>=0;t--){let n=e[t];if(n.href===i&&(!o||n.rel===`stylesheet`))return}let s=document.createElement(`link`);if(s.rel=o?`stylesheet`:t,o||(s.as=`script`),s.crossOrigin=``,s.href=i,c&&s.setAttribute(`nonce`,c),document.head.appendChild(s),o)return new Promise((e,t)=>{s.addEventListener(`load`,e),s.addEventListener(`error`,()=>t(Error(`Unable to preload CSS for ${i}`)))})}))}function s(e){let t=new Event(`vite:preloadError`,{cancelable:!0});if(t.payload=e,window.dispatchEvent(t),!t.defaultPrevented)throw e}return o.then(t=>{for(let e of t||[])e.status===`rejected`&&s(e.reason);return e().catch(s)})}})))()}export{a as n,i as t};

package/storybook-static/assets/pureUtilities-3afQk5ld.js

@@ -0,0 +1,69 @@
+import{n as e}from"./rolldown-runtime-C0FnF6B9.js";import{n as t}from"./iframe-CrnMVMTc.js";import{i as n,r}from"./react-qN2cStNd.js";import{l as i,m as a}from"./blocks-Dz3dJBcm.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,p:`p`,pre:`pre`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Чистые utilities и contracts`}),`
+`,(0,c.jsx)(t.h1,{id:`чистые-utilities-и-contracts`,children:`Чистые utilities и contracts`}),`
+`,(0,c.jsx)(t.p,{children:`Эти API не создают global state и обычно не требуют React. Они полезны в entity/feature code, если задача остаётся предметно-независимой. Не переносите в них доменные правила только ради повторного использования.`}),`
+`,(0,c.jsx)(t.h2,{id:`коллекции-порядок-и-ограниченная-история`,children:`Коллекции, порядок и ограниченная история`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { arrayGroupBy, arrayUniqueBy, moveArrayItem } from "@ryuzaki13/react-foundation-lib/array";
+import { pushBoundedCopyStackItem } from "@ryuzaki13/react-foundation-lib/bounded-copy-stack";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                                    | Поведение                                                                                                  |
+| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`arrayGroupBy`}),`, `,(0,c.jsx)(t.code,{children:`arrayGroupByToArray`}),`, `,(0,c.jsx)(t.code,{children:`arrayToMap`}),`                    | Группируют/индексируют по полю объекта. `,(0,c.jsx)(t.code,{children:`arrayToMap`}),` оставляет первое значение ключа.                      |
+| `,(0,c.jsx)(t.code,{children:`arrayUniqueBy`}),`, `,(0,c.jsx)(t.code,{children:`arrayDeduplicate`}),`                                    | Immutable deduplication с сохранением первого встретившегося значения/порядка.                             |
+| `,(0,c.jsx)(t.code,{children:`filterAndDeduplicateIds`}),`, `,(0,c.jsx)(t.code,{children:`appendMissingIds`}),`, `,(0,c.jsx)(t.code,{children:`pickExistingMapValues`}),` | Helpers для stable id lists и ordered Map values.                                                          |
+| `,(0,c.jsx)(t.code,{children:`arraysEqual`}),`                                                          | Строго сравнивает длину, порядок и значения по `,(0,c.jsx)(t.code,{children:`===`}),`.                                                      |
+| `,(0,c.jsx)(t.code,{children:`moveItem`}),`, `,(0,c.jsx)(t.code,{children:`moveArrayItem`}),`, `,(0,c.jsx)(t.code,{children:`moveArrayItemByIndex`}),`                    | Возвращают новую переставленную коллекцию; invalid indices не мутируют input.                              |
+| `,(0,c.jsx)(t.code,{children:`normalizeObjects`}),`, `,(0,c.jsx)(t.code,{children:`normalizeStringArray`}),`, `,(0,c.jsx)(t.code,{children:`addUnique`}),`                | Explicit canonicalization для внешней/сохранённой структуры — не вызывайте её внутри literal draft setter. |`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`pushBoundedCopyStackItem(stack, input, options?)`}),` добавляет/поднимает item по `,(0,c.jsx)(t.code,{children:`fingerprint`}),` и ограничивает размер (default `,(0,c.jsx)(t.code,{children:`DEFAULT_BOUNDED_COPY_STACK_SIZE = 3`}),`). `,(0,c.jsx)(t.code,{children:`getBoundedCopyStackCandidates`}),` фильтрует готовый stack predicate-ом. `,(0,c.jsx)(t.code,{children:`BoundedCopyStackItem`}),`, `,(0,c.jsx)(t.code,{children:`BoundedCopyStackPushInput`}),`, `,(0,c.jsx)(t.code,{children:`BoundedCopyStackOptions`}),` и `,(0,c.jsx)(t.code,{children:`BoundedCopyStackPushResult`}),` описывают его serializable contract.`]}),`
+`,(0,c.jsx)(t.h2,{id:`значения-шкалы-и-календарные-сегменты`,children:`Значения, шкалы и календарные сегменты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { parseDateSegmentMask, indexedSegmentsToDate } from "@ryuzaki13/react-foundation-lib/date-segments";
+import { snapNumberScaleValue } from "@ryuzaki13/react-foundation-lib/number-scale";
+import { resolveRangeOutputValue } from "@ryuzaki13/react-foundation-lib/range-output";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`| Entry point         | Основной API                                                                                                                                                                                                                                                                                                             |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `,(0,c.jsx)(t.code,{children:`date-segments`}),`     | `,(0,c.jsx)(t.code,{children:`parseDateSegmentMask`}),`, `,(0,c.jsx)(t.code,{children:`isEditableDateSegment`}),`, `,(0,c.jsx)(t.code,{children:`dateToIndexedSegmentValues`}),`, `,(0,c.jsx)(t.code,{children:`areAllDateSegmentsEmpty`}),`, `,(0,c.jsx)(t.code,{children:`indexedSegmentsToDate`}),`. `,(0,c.jsx)(t.code,{children:`indexedSegmentsToDate`}),` строго отвергает невозможную дату/время; `,(0,c.jsx)(t.code,{children:`DateMaskSegment`}),` описывает editable/literal segments.                                                               |
+| `,(0,c.jsx)(t.code,{children:`number-scale`}),`      | `,(0,c.jsx)(t.code,{children:`resolveNumberScaleBounds`}),`, `,(0,c.jsx)(t.code,{children:`clampNumberScaleValue`}),`, `,(0,c.jsx)(t.code,{children:`normalizeNumberScaleStep`}),`, `,(0,c.jsx)(t.code,{children:`prepareNumberScaleMarks`}),`, `,(0,c.jsx)(t.code,{children:`snapNumberScaleValueToStep`}),`, `,(0,c.jsx)(t.code,{children:`snapNumberScaleValueToMarks`}),`, `,(0,c.jsx)(t.code,{children:`snapNumberScaleValue`}),`, `,(0,c.jsx)(t.code,{children:`valueToNumberScalePercent`}),`, `,(0,c.jsx)(t.code,{children:`percentToNumberScaleValue`}),`, `,(0,c.jsx)(t.code,{children:`percentToSnappedNumberScaleValue`}),`, `,(0,c.jsx)(t.code,{children:`offsetNumberScaleValue`}),`. |
+| `,(0,c.jsx)(t.code,{children:`currency`}),`          | `,(0,c.jsx)(t.code,{children:`resolveCurrencyModeFromODataParameters`}),` и `,(0,c.jsx)(t.code,{children:`resolveCurrencyAwareLabel`}),`; это label policy по wrapped OData parameters, не currency formatter.                                                                                                                                                                             |
+| `,(0,c.jsx)(t.code,{children:`range-output`}),`      | `,(0,c.jsx)(t.code,{children:`readRangeOutputValueFallback`}),` и `,(0,c.jsx)(t.code,{children:`resolveRangeOutputValue`}),`; подставляет fallback только для `,(0,c.jsx)(t.code,{children:`null`}),` открытой границы и не меняет исходный UI range.                                                                                                                                                                       |
+| `,(0,c.jsx)(t.code,{children:`presets`}),`           | `,(0,c.jsx)(t.code,{children:`normalizePresetIds`}),`, `,(0,c.jsx)(t.code,{children:`resolvePresetOptionsByIds`}),`, `,(0,c.jsx)(t.code,{children:`getPresetOption`}),`, `,(0,c.jsx)(t.code,{children:`PresetOption`}),`; помогает на save/restore boundary для известного набора IDs.                                                                                                                                                                       |
+| `,(0,c.jsx)(t.code,{children:`string-comparison`}),` | `,(0,c.jsx)(t.code,{children:`compareStrings(left, right)`}),` использует fixed Russian numeric/case-insensitive collation с deterministic fallback.                                                                                                                                                                                                      |`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для date/number UI formatting используйте `,(0,c.jsx)(t.code,{children:`formatters`}),`, а не `,(0,c.jsx)(t.code,{children:`number-scale`}),`/`,(0,c.jsx)(t.code,{children:`currency`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`clone-строки-keyboard-и-trees`,children:`Clone, строки, keyboard и trees`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { cn, deepCloneWithoutFunctions, deepCopyWithoutFunctions, stableStringify } from "@ryuzaki13/react-foundation-lib/utils";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                                                                  | Контракт                                                                                                                                                            |
+| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`cn(...args)`}),`                                                                                        | Собирает className из строк и conditional object. `,(0,c.jsx)(t.code,{children:`classNames`}),` — deprecated alias; новый код использует `,(0,c.jsx)(t.code,{children:`cn`}),`.                                                       |
+| `,(0,c.jsx)(t.code,{children:`stableStringify(value)`}),`                                                                             | JSON-like stable serialization с сортировкой object keys — для key/comparison, не как универсальный persistence format.                                             |
+| `,(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions(value, options?)`}),`                                                          | Копирует Date, arrays и plain objects, поддерживает cycles; функции пропускает. Unsupported object бросает `,(0,c.jsx)(t.code,{children:`TypeError`}),`. Предназначен для serializable plain config. |
+| `,(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions(value, options?)`}),`                                                         | Расширенный clone: Date, RegExp, Map, Set, cycles, sparse arrays и optional prototype. Функции пропускает.                                                          |
+| `,(0,c.jsx)(t.code,{children:`createLazyComponent`}),`, `,(0,c.jsx)(t.code,{children:`childrenCount`}),`                                                               | React-adjacent helpers для stable lazy component и correct children count.                                                                                          |
+| `,(0,c.jsx)(t.code,{children:`keyboardActivationKeys`}),`, `,(0,c.jsx)(t.code,{children:`isKeyboardActivationKey`}),`, `,(0,c.jsx)(t.code,{children:`handleKeyboardActivation`}),`                      | Keyboard activation contract для custom control.                                                                                                                    |
+| `,(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`}),`, `,(0,c.jsx)(t.code,{children:`findFirstEnabledIndex`}),`, `,(0,c.jsx)(t.code,{children:`findLastEnabledIndex`}),`, `,(0,c.jsx)(t.code,{children:`findNextEnabledIndex`}),` | Pure navigation для listbox/select с disabled/wrap.                                                                                                                 |
+| `,(0,c.jsx)(t.code,{children:`deepCopyNodes`}),`, `,(0,c.jsx)(t.code,{children:`deepCopyTree`}),`                                                                      | Копирование tree nodes с standard/custom children field.                                                                                                            |
+| `,(0,c.jsx)(t.code,{children:`toBase64`}),`, `,(0,c.jsx)(t.code,{children:`encodeBase64`}),`, `,(0,c.jsx)(t.code,{children:`logError`}),`                                                               | Unicode-safe base64 и centralised error logging.                                                                                                                    |`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Clone не является нормализацией: он создаёт независимую структуру в пределах собственного contract и не должен применять trim, defaults, deduplication или reorder к пользовательскому draft. Для plain serializable config используйте `,(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`}),`, а не `,(0,c.jsx)(t.code,{children:`structuredClone`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`runtime-guards-и-базовые-типы`,children:`Runtime guards и базовые типы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { asRecord, isRecord, isSafe, readPositiveInteger } from "@ryuzaki13/react-foundation-lib/validators";
+import type { BaseType, RangeType, RowRecord, State } from "@ryuzaki13/react-foundation-lib/types";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`| API                                                 | Когда использовать                                                         |
+| --------------------------------------------------- | -------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`isSafe`}),`                                            | Убирает только `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` из union.                                |
+| `,(0,c.jsx)(t.code,{children:`isObject`}),`, `,(0,c.jsx)(t.code,{children:`isRecord`}),`, `,(0,c.jsx)(t.code,{children:`asRecord`}),`, `,(0,c.jsx)(t.code,{children:`isPlainObject`}),` | Narrow unknown external value до object/record; array не считается record. |
+| `,(0,c.jsx)(t.code,{children:`readPositiveInteger`}),`                               | Возвращает positive integer или `,(0,c.jsx)(t.code,{children:`undefined`}),` без unsafe cast.               |
+| `,(0,c.jsx)(t.code,{children:`validateUrl`}),`                                       | Возвращает validation result для строки URL.                               |
+| `,(0,c.jsx)(t.code,{children:`IMAGE_EXTENSIONS`}),`, `,(0,c.jsx)(t.code,{children:`isImageExtension`}),`              | Проверка расширения без учёта регистра; не MIME/security validation.       |
+| `,(0,c.jsx)(t.code,{children:`isDomReference`}),`                                    | Floating UI reference → DOM `,(0,c.jsx)(t.code,{children:`Element`}),` guard.                               |`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`State`}),`, `,(0,c.jsx)(t.code,{children:`AbapBoolean`}),`, `,(0,c.jsx)(t.code,{children:`Primitive`}),`, `,(0,c.jsx)(t.code,{children:`BaseType`}),`, `,(0,c.jsx)(t.code,{children:`ArrayType`}),`, `,(0,c.jsx)(t.code,{children:`ObjectType`}),`, `,(0,c.jsx)(t.code,{children:`InputType`}),`, `,(0,c.jsx)(t.code,{children:`RangeType`}),`, `,(0,c.jsx)(t.code,{children:`RowRecord`}),`, `,(0,c.jsx)(t.code,{children:`isBaseType`}),` — общие low-level contracts. Не используйте `,(0,c.jsx)(t.code,{children:`RowRecord`}),` как модель конкретной доменной сущности.`]}),`
+`,(0,c.jsx)(t.h2,{id:`идентификаторы-http-xml-seo-и-form-errors`,children:`Идентификаторы, HTTP, XML, SEO и form errors`}),`
+`,(0,c.jsxs)(t.p,{children:[`| Entry point       | API                                                                                                                                                                 |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `,(0,c.jsx)(t.code,{children:`crypto`}),`          | `,(0,c.jsx)(t.code,{children:`hashString`}),`, `,(0,c.jsx)(t.code,{children:`hashString128`}),`, `,(0,c.jsx)(t.code,{children:`hashString128Base64Url`}),`, `,(0,c.jsx)(t.code,{children:`stringToElementId`}),`, `,(0,c.jsx)(t.code,{children:`uuidv4`}),`. Hash служит для stable client key, не криптографической защиты.             |
+| `,(0,c.jsx)(t.code,{children:`session-storage`}),` | `,(0,c.jsx)(t.code,{children:`getSessionStorageId(key, createId?)`}),` — scoped browser-tab id; не authentication token.                                                                             |
+| `,(0,c.jsx)(t.code,{children:`http`}),`            | `,(0,c.jsx)(t.code,{children:`createNoStoreHeaders(init?)`}),` создаёт Headers с no-store; `,(0,c.jsx)(t.code,{children:`createTextHttpResponse(options)`}),` создаёт text `,(0,c.jsx)(t.code,{children:`Response`}),`.                                                |
+| `,(0,c.jsx)(t.code,{children:`xml`}),`             | `,(0,c.jsx)(t.code,{children:`escapeXmlValue`}),`, `,(0,c.jsx)(t.code,{children:`buildXmlFields`}),`, `,(0,c.jsx)(t.code,{children:`getXmlTagText`}),` для небольших XML fragments. Не применяйте regex helper как универсальный XML parser для untrusted complex XML. |
+| `,(0,c.jsx)(t.code,{children:`seo`}),`             | `,(0,c.jsx)(t.code,{children:`createSeoHead(options)`}),`, `,(0,c.jsx)(t.code,{children:`createRouteHead(type, path, params)`}),` создают `,(0,c.jsx)(t.code,{children:`meta`}),`, `,(0,c.jsx)(t.code,{children:`links`}),`, JSON-LD `,(0,c.jsx)(t.code,{children:`scripts`}),`; host router/head owner решает, как применить результат. |
+| `,(0,c.jsx)(t.code,{children:`form`}),`            | `,(0,c.jsx)(t.code,{children:`readFirstFormError(errors?)`}),` выбирает первое readable error message из unknown error array.                                                                        |
+| `,(0,c.jsx)(t.code,{children:`error`}),`           | `,(0,c.jsx)(t.code,{children:`createMissingContextErrorMessage`}),`, `,(0,c.jsx)(t.code,{children:`createMissingContextError`}),` формируют единообразную ошибку отсутствующего React Provider.                                       |`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fingerprint`}),` и `,(0,c.jsx)(t.code,{children:`notifications`}),` описаны на странице Runtime/state, потому что имеют browser/global lifecycle.`]})]})}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};