@ryuzaki13/react-foundation-lib 1.4.2 → 1.4.4

package/dist/hooks/useFloatingListbox.d.ts

@@ -51,8 +51,8 @@ export declare function useFloatingListbox<T>({ options, selectedIndex, open, on
         setFloating: (node: HTMLElement | null) => void;
     } & import("@floating-ui/react").ExtendedRefs<import("@floating-ui/react").ReferenceType>;
     context: {
-        update: () => void;
         x: number;
+        update: () => void;
         y: number;
         placement: Placement;
         strategy: import("@floating-ui/utils").Strategy;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ryuzaki13/react-foundation-lib",
-	"version": "1.4.2",
+	"version": "1.4.4",
 	"description": "Reusable React and TypeScript foundation utilities, hooks, and primitives.",
 	"license": "MIT",
 	"author": "Ryuzaki13",
@@ -57,10 +57,6 @@
 			"types": "./dist/crypto/index.d.ts",
 			"import": "./dist/crypto/index.js"
 		},
-		"./currency": {
-			"types": "./dist/currency/index.d.ts",
-			"import": "./dist/currency/index.js"
-		},
 		"./date-segments": {
 			"types": "./dist/date-segments/index.d.ts",
 			"import": "./dist/date-segments/index.js"

package/src/array/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/Array" />
 
-# Работа с массивами через `@ryuzaki13/react-foundation-lib/array`
+# Работа с массивами
 
 Модуль `array` содержит небольшие типизированные функции для типовых операций с массивами:
 
@@ -16,11 +16,9 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Функции не зависят от React, браузерного DOM, TanStack или других внешних runtime-библиотек. Их можно использовать в обычном TypeScript/JavaScript-коде, React-компонентах, store, mapper, validator и на границах сохранения или восстановления конфигурации.
 
-README рассчитан на разработчика, который использует опубликованный пакет и не читает его исходный код. Здесь отдельно объясняются базовые понятия JavaScript/TypeScript, точное поведение каждой функции, ограничения и типовые ошибки.
-
 ## Содержание
 
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Минимальные понятия JavaScript и TypeScript](#минимальные-понятия-javascript-и-typescript)
 - [Как выбрать функцию](#как-выбрать-функцию)
 - [Быстрый старт](#быстрый-старт)
@@ -37,20 +35,14 @@ README рассчитан на разработчика, который испо
 - [Краткий справочник API](#краткий-справочник-api)
 - [Вопросы и ответы](#вопросы-и-ответы)
 
-## Установка и импорт
-
-Установите пакет в приложении:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Импортируйте функции только из точечного entrypoint `/array`:
 
 ```ts
 import { arrayGroupBy, arrayToMap, arrayUniqueBy, moveArrayItem } from "@ryuzaki13/react-foundation-lib/array";
 
-import type { ReorderAction } from "@ryuzaki13/react-foundation-lib/array";
+import { type ReorderAction } from "@ryuzaki13/react-foundation-lib/array";
 ```
 
 Корневой импорт пакета не поддерживается:

package/src/binary/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/Binary" />
 
-# Работа с бинарными данными через `@ryuzaki13/react-foundation-lib/binary`
+# Работа с бинарными данными
 
 Модуль `binary` преобразует строковое бинарное содержимое в браузерный `Blob`, определяет предполагаемый MIME-тип документа и предоставляет React hook для типового сценария «base64 → `{ blob, mime }`».
 
@@ -16,12 +16,10 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Модуль является предметно-независимым foundation-слоем. Он не знает бизнес-коды документов, не выполняет HTTP/OData-запросы, не загружает файлы с диска, не создаёт viewer и не проверяет, безопасно ли содержимое.
 
-README рассчитан на разработчика, который использует опубликованный пакет без доступа к исходному коду. Здесь объясняются базовые понятия, все публичные функции, точный приоритет MIME, поддерживаемые форматы, ошибки, React lifecycle, безопасность и управление object URL.
-
 ## Содержание
 
 - [Назначение и границы модуля](#назначение-и-границы-модуля)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Минимальные понятия](#минимальные-понятия)
 - [Как выбрать API](#как-выбрать-api)
 - [Быстрый старт](#быстрый-старт)
@@ -72,13 +70,7 @@ README рассчитан на разработчика, который испо
 
 Не копируйте логику скачивания рядом с `binaryToBlob`. Для готового `Blob` уже существует `downloadFileFromBlob` в `/dom`.
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Импортируйте API только из опубликованного subpath `/binary`:
 

package/src/bounded-copy-stack/README.mdx

@@ -2,16 +2,14 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Data/Bounded Copy Stack" />
 
-# Ограниченный стек копий через `@ryuzaki13/react-foundation-lib/bounded-copy-stack`
+# Ограниченный стек копий
 
 Модуль хранит небольшой список последних скопированных сущностей. Новый элемент помещается в начало, повтор по `fingerprint` обновляет существующую запись, а старые записи удаляются при превышении лимита.
 
-Документ рассчитан на разработчика без доступа к исходникам пакета. Ниже объясняются структура элемента, различие `id` и `fingerprint`, порядок записей, ссылки на payload и все граничные случаи.
-
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Основные понятия](#основные-понятия)
 - [Быстрый старт](#быстрый-старт)
 - [`pushBoundedCopyStackItem`](#pushboundedcopystackitem)
@@ -44,11 +42,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Clipboard helpers находятся в `@ryuzaki13/react-foundation-lib/copy`. Владелец state/storage находится в host-приложении.
 
-## Установка и импорт
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 ```ts
 import {
@@ -57,11 +51,11 @@ import {
 	pushBoundedCopyStackItem
 } from "@ryuzaki13/react-foundation-lib/bounded-copy-stack";
 
-import type {
-	BoundedCopyStackItem,
-	BoundedCopyStackOptions,
-	BoundedCopyStackPushInput,
-	BoundedCopyStackPushResult
+import {
+	type BoundedCopyStackItem,
+	type BoundedCopyStackOptions,
+	type BoundedCopyStackPushInput,
+	type BoundedCopyStackPushResult
 } from "@ryuzaki13/react-foundation-lib/bounded-copy-stack";
 ```
 

package/src/context-menu/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Interaction/Context Menu State" />
 
-# Состояние и anchors контекстного меню через `@ryuzaki13/react-foundation-lib/context-menu`
+# Состояние и anchors контекстного меню
 
 Модуль описывает открытое/закрытое состояние контекстного меню, источник открытия и два вида anchor: DOM element или экранная точка. Также он создаёт virtual anchor для Floating UI.
 
@@ -11,7 +11,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Модель данных](#модель-данных)
 - [Получение точки](#получение-точки)
 - [`createVirtualAnchor`](#createvirtualanchor)
@@ -48,7 +48,7 @@ host React/Floating UI/menu component
 
 Готовый visual primitive находится в `@ryuzaki13/react-foundation-ui/context-menu`.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import {
@@ -61,14 +61,14 @@ import {
 	toggleMenu
 } from "@ryuzaki13/react-foundation-lib/context-menu";
 
-import type {
-	ElementMenuAnchor,
-	MenuAnchor,
-	MenuOpenSource,
-	MenuPoint,
-	MenuState,
-	OpenMenuPayload,
-	PointMenuAnchor
+import {
+	type ElementMenuAnchor,
+	type MenuAnchor,
+	type MenuOpenSource,
+	type MenuPoint,
+	type MenuState,
+	type OpenMenuPayload,
+	type PointMenuAnchor
 } from "@ryuzaki13/react-foundation-lib/context-menu";
 ```
 

package/src/copy/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/Copy" />
 
-# Копирование текста через `@ryuzaki13/react-foundation-lib/copy`
+# Копирование текста
 
 Модуль `copy` содержит React hooks для копирования текста в системный буфер обмена, чтения текста из DOM-элемента и показа короткого состояния «скопировано».
 
@@ -14,12 +14,10 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Модуль ориентирован на браузер. Он скрывает технический выбор между современным Clipboard API и legacy fallback, но не отменяет браузерные разрешения и ограничения безопасности.
 
-README рассчитан на разработчика, который использует опубликованный пакет без доступа к исходному коду. Здесь объясняются базовые понятия React и DOM, точное поведение каждого hook, обработка ошибок, доступность, тестирование и известные ограничения.
-
 ## Содержание
 
 - [Назначение и границы модуля](#назначение-и-границы-модуля)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Минимальные понятия](#минимальные-понятия)
 - [Как выбрать API](#как-выбрать-api)
 - [Быстрый старт](#быстрый-старт)
@@ -72,13 +70,7 @@ README рассчитан на разработчика, который испо
 | Реализовать визуальную кнопку/tooltip | UI-компонент приложения или foundation UI-пакет        |
 | Скопировать изображение или rich HTML | Отдельная реализация Clipboard API для нужного формата |
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Модуль использует React hooks. Приложение должно предоставить совместимые peer-зависимости React:
 

package/src/crypto/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/Crypto" />
 
-# Идентификаторы и строковые hash через `@ryuzaki13/react-foundation-lib/crypto`
+# Идентификаторы и строковые hash
 
 Модуль `crypto` предоставляет небольшие функции для двух разных задач:
 
@@ -13,12 +13,10 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Несмотря на имя entrypoint, строковые hash этого модуля не являются криптографическими. Они не подходят для паролей, подписей, access token, проверки безопасности или сокрытия персональных данных.
 
-README рассчитан на разработчика, который использует опубликованный пакет без доступа к исходному коду. Здесь объясняются базовые понятия, точные форматы результатов, browser runtime, Unicode, коллизии, React/SSR, тестирование и безопасные границы применения.
-
 ## Содержание
 
 - [Назначение и границы модуля](#назначение-и-границы-модуля)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Минимальные понятия](#минимальные-понятия)
 - [Как выбрать API](#как-выбрать-api)
 - [Быстрый старт](#быстрый-старт)
@@ -71,13 +69,7 @@ README рассчитан на разработчика, который испо
 | Детерминированные hash  | `hashString`, `hashString128`, `hashString128Base64Url`, `stringToElementId` | Та же точная строка даёт тот же результат.              |
 | Случайный идентификатор | `uuidv4`                                                                     | Каждый вызов должен создавать новое случайное значение. |
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Импортируйте функции только из опубликованного subpath `/crypto`:
 

package/src/date-segments/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Date/Segments" />
 
-# Сегменты даты и времени через `@ryuzaki13/react-foundation-lib/date-segments`
+# Сегменты даты и времени
 
 Модуль разбирает строковую маску на редактируемые сегменты и литералы, преобразует `Date` в значения полей и строго собирает `Date` обратно. Он предназначен для segment-based date/time inputs.
 
@@ -11,7 +11,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Базовые понятия](#базовые-понятия)
 - [Поддерживаемые tokens](#поддерживаемые-tokens)
 - [`parseDateSegmentMask`](#parsedatesegmentmask)
@@ -40,7 +40,7 @@ new Date(2026, 2, 3, 18, 3)
 
 Модуль не рендерит input, не управляет focus/caret, не форматирует итоговую дату для UI/backend и не парсит ISO/OData строку. Для общего парсинга/форматирования используйте `/formatters`.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import {

package/src/dom/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/DOM" />
 
-# Browser DOM и focus helpers через `@ryuzaki13/react-foundation-lib/dom`
+# Browser DOM и focus helpers
 
 Модуль `dom` содержит небольшие browser helpers и React hooks для типовых инфраструктурных задач:
 
@@ -17,12 +17,10 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Модуль является низкоуровневым browser foundation-слоем. Он не создаёт готовые кнопки, dialog, modal, popover, tooltip или download UI. Визуальный компонент по-прежнему отвечает за семантический HTML, ARIA, стили, анимацию, стек overlay, сообщения об ошибках и пользовательский сценарий.
 
-README рассчитан на разработчика, который использует опубликованный пакет без прямого доступа к исходному коду. Здесь объясняются базовые понятия DOM и React, все публичные функции, точный lifecycle, defaults, cleanup, ограничения доступности, тестирование и частые ошибки.
-
 ## Содержание
 
 - [Назначение и границы модуля](#назначение-и-границы-модуля)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Runtime и browser boundary](#runtime-и-browser-boundary)
 - [Минимальные понятия](#минимальные-понятия)
 - [Как выбрать API](#как-выбрать-api)
@@ -91,13 +89,7 @@ README рассчитан на разработчика, который испо
 
 Если приложению нужен готовый UI primitive, сначала ищите его в `@ryuzaki13/react-foundation-ui`. Модуль `dom` нужен авторам primitives и для специальных browser-сценариев, а не для повторной сборки локальных modal/dialog в каждом feature.
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Entrypoint экспортирует React hooks, поэтому host-приложение должно предоставить совместимые peer-зависимости:
 

package/src/error/README.mdx

@@ -2,11 +2,11 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Errors/Missing Context" />
 
-# Ошибка отсутствующего React context через `@ryuzaki13/react-foundation-lib/error`
+# Ошибка отсутствующего React context
 
 Модуль создаёт единообразное диагностическое сообщение, когда custom hook вызван вне нужного Provider.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { createMissingContextError, createMissingContextErrorMessage } from "@ryuzaki13/react-foundation-lib/error";

package/src/file/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/File" />
 
-# Работа с пользовательскими файлами через `@ryuzaki13/react-foundation-lib/file`
+# Работа с пользовательскими файлами
 
 Модуль `file` содержит browser helpers для четырёх связанных задач:
 
@@ -13,12 +13,10 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Модуль является низкоуровневым foundation-слоем. Он не рисует `<input type="file">`, не отправляет файл на backend, не показывает preview или progress, не проверяет реальное содержимое файла и не заменяет серверную валидацию.
 
-README рассчитан на разработчика, который использует опубликованный пакет без доступа к исходному коду. Поэтому ниже отдельно объясняются базовые понятия JavaScript/TypeScript, точный порядок проверок, структура результатов, все публичные функции и типы, фактические классы ошибок, ограничения безопасности и известные особенности текущей реализации.
-
 ## Содержание
 
 - [Назначение и границы модуля](#назначение-и-границы-модуля)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Runtime и browser boundary](#runtime-и-browser-boundary)
 - [Минимальные понятия](#минимальные-понятия)
 - [Как выбрать API](#как-выбрать-api)
@@ -90,13 +88,7 @@ README рассчитан на разработчика, который испо
 
 Если нужен только обычный upload через `multipart/form-data`, браузерный `File` можно положить в `FormData` напрямую. Предварительное чтение всего файла через `readFile` для этого не обязательно.
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Импортируйте API только из опубликованного subpath `/file`:
 

package/src/fingerprint/README.mdx

@@ -2,14 +2,14 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Browser/Client Fingerprint" />
 
-# Client fingerprint через `@ryuzaki13/react-foundation-lib/fingerprint`
+# Client fingerprint
 
 `getClientFingerprint` лениво загружает FingerprintJS, получает `visitorId` и кеширует Promise на всё время жизни JavaScript-модуля.
 
-## Установка и импорт
+## Импорт
 
 ```bash
-npm install @ryuzaki13/react-foundation-lib @fingerprintjs/fingerprintjs
+npm install @fingerprintjs/fingerprintjs
 ```
 
 ```ts

package/src/form/README.mdx

@@ -2,11 +2,11 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Forms/Form Errors" />
 
-# Чтение первой ошибки формы через `@ryuzaki13/react-foundation-lib/form`
+# Чтение первой ошибки формы
 
 Модуль содержит одну функцию `readFirstFormError`. Она получает неоднородный массив ошибок и возвращает первое найденное текстовое сообщение.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { readFirstFormError } from "@ryuzaki13/react-foundation-lib/form";

package/src/formatters/README.mdx

@@ -8,12 +8,6 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Документация разделена по предметным областям, чтобы разработчику не приходилось читать один огромный файл. Этот README объясняет общие правила, помогает выбрать API и подробно описывает небольшие helpers верхнего уровня.
 
-## Установка
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
-
 Пакет является ESM. Корневого импорта пакета нет. Все formatter functions и их типы импортируются из точечного entrypoint:
 
 ```ts

package/src/formatters/boolean/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/Formatters/Boolean" />
 
-# Boolean и ABAP boolean через `@ryuzaki13/react-foundation-lib/formatters`
+# Boolean и ABAP boolean
 
 Подмодуль `boolean` преобразует значения между JavaScript `boolean` и двухсимвольным ABAP-контрактом:
 
@@ -11,12 +11,10 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Также он предоставляет более широкий parser `parseBoolean` для простых пользовательских или transport-значений.
 
-README рассчитан на разработчика без доступа к исходному коду. Ниже описано точное, местами неочевидное поведение всех трёх публичных функций. Особенно важно не путать строгий `parseAbapBoolean`, расширенный `parseBoolean` и truthy-семантику `toAbapBoolean`.
-
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Минимальные понятия](#минимальные-понятия)
 - [Как выбрать функцию](#как-выбрать-функцию)
 - [`parseAbapBoolean`](#parseabapboolean)
@@ -47,13 +45,7 @@ README рассчитан на разработчика без доступа к
 - не сериализует JSON, URL или OData query;
 - не гарантирует, что широкий `toAbapBoolean(unknown)` подходит конкретному backend-контракту.
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Все boolean helpers импортируются из единственного опубликованного subpath `/formatters`:
 

package/src/formulas/README.mdx

@@ -17,12 +17,10 @@ import { Meta } from "@storybook/addon-docs/blocks";
       контролируемая причина ошибки выполнения
 ```
 
-README рассчитан на разработчика без доступа к исходному коду. Здесь описано точное поведение всего публичного API, включая преобразование значений, реестр, validation, ошибки и связь с formatter pipeline.
-
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Быстрый старт](#быстрый-старт)
 - [Основные понятия](#основные-понятия)
 - [Описание формулы](#описание-формулы)
@@ -71,11 +69,7 @@ Host-приложение владеет прикладными `TableFormulaDef
 
 Сериализуемая конфигурация колонки хранит только стабильный `formulaId` и ordered dependencies. Реальная функция остаётся доверенным кодом приложения.
 
-## Установка и импорт
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Используйте только опубликованный package subpath `/formulas`:
 

package/src/http/README.mdx

@@ -2,14 +2,14 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/HTTP/Headers and Text Response" />
 
-# HTTP headers и текстовые ответы через `@ryuzaki13/react-foundation-lib/http`
+# HTTP headers и текстовые ответы
 
 Модуль создаёт стандартный набор HTTP-заголовков запрета кеширования и обычный `Response` с UTF-8 plain text.
 
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [`createNoStoreHeaders`](#createnostoreheaders)
 - [`createTextHttpResponse`](#createtexthttpresponse)
 - [Runtime и безопасность](#runtime-и-безопасность)
@@ -26,7 +26,7 @@ Headers с no-store + Response(text/plain; charset=UTF-8)
 
 Модуль не выполняет `fetch`, не сериализует JSON, не задаёт CORS, CSP, cookies или authorization и не превращает ошибки transport в response автоматически.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { createNoStoreHeaders, createTextHttpResponse } from "@ryuzaki13/react-foundation-lib/http";

package/src/media/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/Media" />
 
-# Адаптивность и media queries через `@ryuzaki13/react-foundation-lib/media`
+# Адаптивность и media queries
 
 Модуль `media` содержит общий низкоуровневый контракт адаптивности для React-приложений:
 
@@ -14,12 +14,12 @@ import { Meta } from "@storybook/addon-docs/blocks";
 - преобразование количества пикселей относительно размера `em`;
 - расчёт проектной высоты control.
 
-Документ рассчитан на разработчика, который использует опубликованный пакет без доступа к его исходному коду. Поэтому ниже отдельно объясняются базовые понятия CSS и React, точные значения, fallback-порядок, SSR, hydration, подписки, cleanup, ограничения и все публичные exports.
+Ниже отдельно объясняются базовые понятия CSS и React, точные значения, fallback-порядок, SSR, hydration, подписки, cleanup, ограничения и все публичные exports.
 
 ## Содержание
 
 - [Граница ответственности](#граница-ответственности)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Минимальные понятия](#минимальные-понятия)
 - [Как выбрать API](#как-выбрать-api)
 - [Проектные брейкпоинты](#проектные-брейкпоинты)
@@ -82,7 +82,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Если задача решается только стилями, сначала используйте CSS. JavaScript hook нужен, когда media query действительно влияет на вычисления, выбор поведения, параметры сторонней библиотеки или внешний store.
 
-## Установка и импорт
+## Импорт
 
 Установите пакет:
 

package/src/notifications/README.mdx

@@ -22,12 +22,12 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Для ошибок внутри формы лучше показывать сообщение рядом с полем. Уведомление — дополнительный, а не единственный канал обратной связи.
 
-## Установка и импорт
+## Импорт
 
 Модулю нужен peer dependency `zustand`.
 
 ```bash
-npm install @ryuzaki13/react-foundation-lib zustand
+npm install zustand
 ```
 
 ```ts

package/src/number-scale/README.mdx

@@ -13,7 +13,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 3. преобразует значение в позицию `0..100%` и обратно;
 4. работает с дискретными точками `marks`.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import {

package/src/odata-service/README.mdx

@@ -15,14 +15,14 @@ import { Meta } from "@storybook/addon-docs/blocks";
 - поиска пар «код + текст» в справочных коллекциях;
 - хранения общих настроек OData-справочников.
 
-README рассчитан на разработчика без доступа к исходному коду и с минимальным знанием JavaScript/TypeScript. В примерах объясняется не только вызов функции, но и смысл входных данных, результат, ограничения и типичные ошибки.
+В примерах объясняется не только вызов функции, но и смысл входных данных, результат, ограничения и типичные ошибки.
 
 > Ранее helpers справочных коллекций публиковались через отдельный subpath `@ryuzaki13/react-foundation-lib/odata`. Теперь этот код входит в `odata-service`. Старый subpath удалён без compatibility alias.
 
 ## Содержание
 
 - [Что делает и чего не делает модуль](#что-делает-и-чего-не-делает-модуль)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Зависимости и среда выполнения](#зависимости-и-среда-выполнения)
 - [OData V2 простыми словами](#odata-v2-простыми-словами)
 - [Быстрый старт](#быстрый-старт)
@@ -99,13 +99,7 @@ host entity / feature / widget
   бизнес-правила, экран, пользовательский сценарий
 ```
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Для полного entrypoint также разрешите совместимые peer dependencies, если package manager не сделал этого автоматически:
 
@@ -142,7 +136,7 @@ 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";
+import { findCollectionPairs } from "@ryuzaki13/react-foundation-lib/odata-service";
 ```
 
 ### `import type` для TypeScript-типов
@@ -2586,7 +2580,7 @@ beforeEach(() => {
 До:
 
 ```ts
-import { buildSeparatedArrays, findCollectionPairs, ODataDateFormat, useODataCollectionStore } from "@ryuzaki13/react-foundation-lib/odata";
+import { buildSeparatedArrays, findCollectionPairs, ODataDateFormat, useODataCollectionStore } from "@ryuzaki13/react-foundation-lib/odata-service";
 ```
 
 После:

package/src/presets/README.mdx

@@ -2,11 +2,11 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Data/Presets" />
 
-# Общие preset helpers через `@ryuzaki13/react-foundation-lib/presets`
+# Общие preset helpers
 
 Модуль проверяет восстановленные preset ids, сопоставляет их с option objects и ищет одну option по id.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { getPresetOption, normalizePresetIds, resolvePresetOptionsByIds } from "@ryuzaki13/react-foundation-lib/presets";

package/src/pwa/README.mdx

@@ -13,14 +13,6 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 Используйте точный subpath. Внутренний файл `serviceWorker` не является самостоятельным публичным export, даже если отдельные функции используются самим hook.
 
-## Установка
-
-Для `useServiceWorkerUpdate` нужен React. Cache policy не имеет React-зависимости.
-
-```bash
-npm install @ryuzaki13/react-foundation-lib react
-```
-
 ## Часть 1. Обновление Service Worker
 
 ### Задача hook

package/src/query-client/README.mdx

@@ -14,14 +14,14 @@ import { Meta } from "@storybook/addon-docs/blocks";
 - синхронизирует cache data и invalidation между вкладками;
 - предоставляет низкоуровневые helpers для optimistic update и rollback.
 
-README рассчитан на разработчика без доступа к исходному коду и с минимальным знанием JavaScript, TypeScript и TanStack Query. Здесь описаны установка, инициализация, жизненный цикл данных, точное поведение функций, ограничения browser API и полный публичный API.
+Здесь описаны жизненный цикл данных, точное поведение функций, ограничения browser API и полный публичный API.
 
 > Ранее optimistic update был описан отдельным документом. Теперь весь смысл, примеры, ограничения и API находятся только на этой странице.
 
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Обязательные build-time constants](#обязательные-build-time-constants)
 - [Основные понятия TanStack Query](#основные-понятия-tanstack-query)
 - [Как выбрать cache strategy](#как-выбрать-cache-strategy)
@@ -92,15 +92,12 @@ queryOptions/useQuery/useMutation
 
 Broadcast не является четвёртым хранилищем. Он только передаёт изменения между уже работающими вкладками.
 
-## Установка и импорт
+## Импорт
 
-Установите foundation-пакет и совместимые peer dependencies:
+Установите совместимые peer dependencies:
 
 ```bash
-npm install @ryuzaki13/react-foundation-lib
-npm install react @tanstack/react-query \
-  @tanstack/query-persist-client-core \
-  @tanstack/query-broadcast-client-experimental
+npm install react @tanstack/react-query @tanstack/query-persist-client-core @tanstack/query-broadcast-client-experimental
 ```
 
 Публичный импорт:

package/src/range-output/README.mdx

@@ -2,14 +2,14 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Data/Range Output" />
 
-# Подстановка открытых границ через `@ryuzaki13/react-foundation-lib/range-output`
+# Подстановка открытых границ
 
 Модуль хранит в UI открытые границы диапазона как `null`, но позволяет подставить конкретные значения при внешнем выводе или сохранении.
 
 ## Содержание
 
 - [Назначение](#назначение)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Контракты](#контракты)
 - [`readRangeOutputValueFallback`](#readrangeoutputvaluefallback)
 - [`resolveRangeOutputValue`](#resolverangeoutputvalue)
@@ -28,7 +28,7 @@ external output [0, 6]
 
 Исходное UI-значение не изменяется. `null` заменяется только при построении отдельного output tuple.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { readRangeOutputValueFallback, resolveRangeOutputValue } from "@ryuzaki13/react-foundation-lib/range-output";

package/src/session-storage/README.mdx

@@ -2,11 +2,11 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Browser/Session Storage ID" />
 
-# Идентификатор вкладочной сессии через `@ryuzaki13/react-foundation-lib/session-storage`
+# Идентификатор вкладочной сессии
 
 `getSessionStorageId` возвращает стабильный id в пределах одной browser-вкладки. При первом вызове id создаётся и сохраняется в `sessionStorage`, при следующих — читается по тому же ключу.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { getSessionStorageId } from "@ryuzaki13/react-foundation-lib/session-storage";

package/src/string-comparison/README.mdx

@@ -2,11 +2,11 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Data/String Comparison" />
 
-# Сравнение строк через `@ryuzaki13/react-foundation-lib/string-comparison`
+# Сравнение строк
 
 `compareStrings` задаёт единый порядок строк для русскоязычных UI-списков, смешанной кириллицы/латиницы и числовых суффиксов.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { compareStrings } from "@ryuzaki13/react-foundation-lib/string-comparison";

package/src/table/README.mdx

@@ -9,14 +9,12 @@ import { Meta } from "@storybook/addon-docs/blocks";
 - `@ryuzaki13/react-foundation-lib/table` — типы и helpers для TanStack Table v9, колонок, layout, выбора строк и ячеек, а также OData metadata;
 - `@ryuzaki13/react-foundation-lib/tree-table` — построение древовидных строк и преобразование плоских аналитических данных в иерархию.
 
-Документ рассчитан на разработчика без доступа к исходному коду пакета и с минимальным знанием JavaScript, TypeScript, React и TanStack Table. В нём объясняются не только названия функций, но и смысл каждого состояния, правила идентификаторов, результат вызова, ограничения и типичные ошибки.
-
 > Документ один, потому что плоская и древовидная таблицы используют общие понятия строк, колонок, идентификаторов и selection. Публичных import path при этом два: API `tree-table` не реэкспортируется из `table`, а API `table` не реэкспортируется из `tree-table`.
 
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Что нужно знать перед началом](#что-нужно-знать-перед-началом)
 - [Как выбрать нужную часть API](#как-выбрать-нужную-часть-api)
 - [Быстрый старт: плоская таблица](#быстрый-старт-плоская-таблица)
@@ -134,13 +132,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
  table helpers очищают только локальный UI state
 ```
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Для `table` host должен разрешить совместимые peer dependencies React и TanStack Table:
 

package/src/types/README.mdx

@@ -2,13 +2,13 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Contracts/Common Types" />
 
-# Общие технические типы `@ryuzaki13/react-foundation-lib/types`
+# Общие технические типы
 
 Модуль содержит небольшие общие TypeScript-контракты для value state, ABAP boolean, базовых значений, диапазонов и строк таблицы. Единственная runtime-функция — `isBaseType`.
 
 ## Содержание
 
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [`State`](#state)
 - [`AbapBoolean`](#abapboolean)
 - [`Primitive` и `BaseType`](#primitive-и-basetype)
@@ -18,21 +18,21 @@ import { Meta } from "@storybook/addon-docs/blocks";
 - [`RowRecord`](#rowrecord)
 - [Ошибки проектирования](#ошибки-проектирования)
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { isBaseType } from "@ryuzaki13/react-foundation-lib/types";
 
-import type {
-	AbapBoolean,
-	ArrayType,
-	BaseType,
-	InputType,
-	ObjectType,
-	Primitive,
-	RangeType,
-	RowRecord,
-	State
+import {
+	type AbapBoolean,
+	type ArrayType,
+	type BaseType,
+	type InputType,
+	type ObjectType,
+	type Primitive,
+	type RangeType,
+	type RowRecord,
+	type State
 } from "@ryuzaki13/react-foundation-lib/types";
 ```
 

package/src/utils/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/API/Utils" />
 
-# Общие утилиты `@ryuzaki13/react-foundation-lib/utils`
+# Общие утилиты
 
 Модуль `utils` объединяет небольшие технические функции, которые нужны в разных частях React- и TypeScript-приложения:
 
@@ -16,14 +16,14 @@ import { Meta } from "@storybook/addon-docs/blocks";
 - копирование древовидной структуры;
 - единая точка вывода ошибок в `console.error`.
 
-Документ рассчитан на разработчика без доступа к исходному коду пакета и с минимальным знанием JavaScript, TypeScript и React. Поэтому ниже объясняются назначение каждого аргумента, точный результат, побочные эффекты, различия похожих функций и ограничения.
+Ниже объясняются назначение каждого аргумента, точный результат, побочные эффекты, различия похожих функций и ограничения.
 
 > `utils` — это опубликованный entrypoint, а не приглашение складывать сюда любую бизнес-логику. В модуле нет HTTP-запросов, UI-компонентов, доменных правил, нормализации пользовательского ввода и криптографии.
 
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Среда выполнения](#среда-выполнения)
 - [Минимальные понятия](#минимальные-понятия)
 - [Как выбрать функцию](#как-выбрать-функцию)
@@ -98,13 +98,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 | UI primitives                                  | `@ryuzaki13/react-foundation-ui/<module>`                  |
 | Бизнес-преобразование сущности                 | entity/feature/widget host-приложения                      |
 
-## Установка и импорт
-
-Установите пакет:
-
-```bash
-npm install @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 Entrypoint `/utils` также экспортирует React-функции `childrenCount` и `createLazyComponent`. Поэтому host-приложение должно разрешить совместимую peer dependency React:
 

package/src/validators/README.mdx

@@ -2,7 +2,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Validation/Runtime Guards" />
 
-# Runtime guards и validators через `@ryuzaki13/react-foundation-lib/validators`
+# Runtime guards и validators
 
 Модуль содержит небольшие проверки для `unknown`, object-like значений, image extensions, positive integer, URL и Floating UI DOM reference.
 
@@ -10,7 +10,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 ## Содержание
 
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [Как работают type guards](#как-работают-type-guards)
 - [`isSafe`](#issafe)
 - [`isObject`, `isRecord`, `asRecord`](#isobject-isrecord-asrecord)
@@ -22,7 +22,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 - [Security boundary](#security-boundary)
 - [Полный API](#полный-api)
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import {

package/src/virtualizer/README.mdx

@@ -2,15 +2,11 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/React/Virtualizer Pagination" />
 
-# Дозагрузка virtualized списка через `@ryuzaki13/react-foundation-lib/virtualizer`
+# Дозагрузка virtualized списка
 
 `useFetchNextPageEffect` вызывает `fetchNextPage`, когда последняя отрендеренная virtual item достигает конца уже загруженного списка.
 
-## Установка и импорт
-
-```bash
-npm install react @tanstack/react-virtual @ryuzaki13/react-foundation-lib
-```
+## Импорт
 
 ```ts
 import { useFetchNextPageEffect } from "@ryuzaki13/react-foundation-lib/virtualizer";

package/src/xml/README.mdx

@@ -2,14 +2,14 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 <Meta title="Foundation Lib/Data/XML" />
 
-# Простые XML helpers через `@ryuzaki13/react-foundation-lib/xml`
+# Простые XML helpers
 
 Модуль экранирует XML-текст, строит последовательность простых полей и читает текст первого тега через `DOMParser`.
 
 ## Содержание
 
 - [Назначение и границы](#назначение-и-границы)
-- [Установка и импорт](#установка-и-импорт)
+- [Импорт](#импорт)
 - [`escapeXmlValue`](#escapexmlvalue)
 - [`buildXmlFields`](#buildxmlfields)
 - [`getXmlTagText`](#getxmltagtext)
@@ -33,7 +33,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 - не проверяет parser errors;
 - не выполняет network request.
 
-## Установка и импорт
+## Импорт
 
 ```ts
 import { buildXmlFields, escapeXmlValue, getXmlTagText } from "@ryuzaki13/react-foundation-lib/xml";

package/dist/currency/currency.d.ts

@@ -1,8 +0,0 @@
-import { type WrappedODataParameters } from "../odata-service";
-/** Runtime-режим валюты, который задается общим OData-параметром страницы. */
-export type CurrencyMode = "internal" | "rub";
-/** Собирает display-подпись с валютным суффиксом. */
-export declare function resolveCurrencyAwareLabel(label: string, currencyLabels: readonly [string, string] | undefined, currencyMode: CurrencyMode | null | undefined): string;
-/** Определяет режим валюты по общему OData-параметру `p_curr`. */
-export declare function resolveCurrencyModeFromODataParameters(params?: WrappedODataParameters): CurrencyMode | null;
-//# sourceMappingURL=currency.d.ts.map

package/dist/currency/currency.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../src/currency/currency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAI/D,8EAA8E;AAC9E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;AAE9C,qDAAqD;AACrD,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrD,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAC3C,MAAM,CAWR;AAED,kEAAkE;AAClE,wBAAgB,sCAAsC,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,YAAY,GAAG,IAAI,CAU3G"}

package/dist/currency/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./currency";
-//# sourceMappingURL=index.d.ts.map

package/dist/currency/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/currency/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/currency/index.js

@@ -1,16 +0,0 @@
-//#region src/currency/currency.ts
-var e = "p_curr";
-function t(e, t, n) {
-	if (!t || !n) return e;
-	let r = t[n === "internal" ? 0 : 1]?.trim() ?? "", i = r.startsWith(",");
-	return r ? `${e}${i ? "" : " "}${r}` : e;
-}
-function n(t) {
-	if (!t || !Object.prototype.hasOwnProperty.call(t, e)) return null;
-	let n = t[e]?.value;
-	return n === !1 ? "internal" : n === !0 ? "rub" : null;
-}
-//#endregion
-export { t as resolveCurrencyAwareLabel, n as resolveCurrencyModeFromODataParameters };
-
-//# sourceMappingURL=index.js.map

package/dist/currency/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/currency/currency.ts"],"sourcesContent":["import { type WrappedODataParameters } from \"../odata-service\";\n\nconst CURRENCY_PARAMETER_ID = \"p_curr\";\n\n/** Runtime-режим валюты, который задается общим OData-параметром страницы. */\nexport type CurrencyMode = \"internal\" | \"rub\";\n\n/** Собирает display-подпись с валютным суффиксом. */\nexport function resolveCurrencyAwareLabel(\n\tlabel: string,\n\tcurrencyLabels: readonly [string, string] | undefined,\n\tcurrencyMode: CurrencyMode | null | undefined\n): string {\n\tif (!currencyLabels || !currencyMode) {\n\t\treturn label;\n\t}\n\n\tconst currencyLabelIndex = currencyMode === \"internal\" ? 0 : 1;\n\tconst currencyLabel = currencyLabels[currencyLabelIndex]?.trim() ?? \"\";\n\tconst hasComma = currencyLabel.startsWith(\",\");\n\n\t// NOTE: нужно закрепить правило, что запятая ставится в currencyLabel\n\treturn currencyLabel ? `${label}${hasComma ? \"\" : \" \"}${currencyLabel}` : label;\n}\n\n/** Определяет режим валюты по общему OData-параметру `p_curr`. */\nexport function resolveCurrencyModeFromODataParameters(params?: WrappedODataParameters): CurrencyMode | null {\n\tif (!params || !Object.prototype.hasOwnProperty.call(params, CURRENCY_PARAMETER_ID)) {\n\t\treturn null;\n\t}\n\n\tconst value = params[CURRENCY_PARAMETER_ID]?.value;\n\tif (value === false) return \"internal\";\n\tif (value === true) return \"rub\";\n\n\treturn null;\n}\n"],"mappings":";AAEA,IAAM,IAAwB;AAM9B,SAAgB,EACf,GACA,GACA,GACS;CACT,IAAI,CAAC,KAAkB,CAAC,GACvB,OAAO;CAIR,IAAM,IAAgB,EADK,MAAiB,aAAa,IAAI,EACL,EAAE,KAAK,KAAK,IAC9D,IAAW,EAAc,WAAW,GAAG;CAG7C,OAAO,IAAgB,GAAG,IAAQ,IAAW,KAAK,MAAM,MAAkB;AAC3E;AAGA,SAAgB,EAAuC,GAAsD;CAC5G,IAAI,CAAC,KAAU,CAAC,OAAO,UAAU,eAAe,KAAK,GAAQ,CAAqB,GACjF,OAAO;CAGR,IAAM,IAAQ,EAAO,EAAsB,EAAE;CAI7C,OAHI,MAAU,KAAc,aACxB,MAAU,KAAa,QAEpB;AACR"}

package/src/currency/README.mdx

@@ -1,155 +0,0 @@
-import { Meta } from "@storybook/addon-docs/blocks";
-
-<Meta title="Foundation Lib/Data/Currency" />
-
-# Валютные подписи через `@ryuzaki13/react-foundation-lib/currency`
-
-Модуль связывает общий OData-параметр `p_curr` с отображаемой подписью показателя. Он определяет один из двух режимов валюты и добавляет соответствующий суффикс к label.
-
-## Содержание
-
-- [Назначение](#назначение)
-- [Установка и импорт](#установка-и-импорт)
-- [`CurrencyMode`](#currencymode)
-- [`resolveCurrencyModeFromODataParameters`](#resolvecurrencymodefromodataparameters)
-- [`resolveCurrencyAwareLabel`](#resolvecurrencyawarelabel)
-- [Готовый pipeline](#готовый-pipeline)
-- [Ограничения и ошибки](#ограничения-и-ошибки)
-- [API-справочник](#api-справочник)
-
-## Назначение
-
-```text
-wrapped OData params
-{ p_curr: { value: true } }
-              │
-              ▼
-      CurrencyMode "rub"
-              │
-              ▼
-"Выручка" + ["за тн", "руб/тн"]
-              │
-              ▼
-       "Выручка руб/тн"
-```
-
-Модуль не форматирует денежное число, не конвертирует валюту и не строит OData query. Для чисел используйте `/formatters`, для OData params — `/odata-service`.
-
-## Установка и импорт
-
-```ts
-import { resolveCurrencyAwareLabel, resolveCurrencyModeFromODataParameters } from "@ryuzaki13/react-foundation-lib/currency";
-
-import type { CurrencyMode } from "@ryuzaki13/react-foundation-lib/currency";
-```
-
-Модуль ESM, не требует React или browser API. Параметры должны иметь публичную wrapped-форму из `/odata-service`.
-
-## `CurrencyMode`
-
-```ts
-type CurrencyMode = "internal" | "rub";
-```
-
-- `internal` — внутренний режим;
-- `rub` — рублёвый режим.
-
-`null` используется resolver-функцией, когда режим определить нельзя.
-
-## `resolveCurrencyModeFromODataParameters`
-
-```ts
-const mode = resolveCurrencyModeFromODataParameters(params);
-```
-
-Функция читает только собственное поле `p_curr.value`:
-
-| Вход                            | Результат    |
-| ------------------------------- | ------------ |
-| параметров нет                  | `null`       |
-| поля `p_curr` нет               | `null`       |
-| `{ p_curr: { value: false } }`  | `"internal"` |
-| `{ p_curr: { value: true } }`   | `"rub"`      |
-| `{ p_curr: { value: "true" } }` | `null`       |
-| `{ p_curr: { value: 1 } }`      | `null`       |
-
-Строка `"true"` намеренно не приводится к boolean. Нормализуйте внешний payload на OData boundary, а не внутри UI label.
-
-Пример с helper `/odata-service`:
-
-```ts
-import { wrapODataParams } from "@ryuzaki13/react-foundation-lib/odata-service";
-
-const params = wrapODataParams({ p_curr: true });
-const mode = resolveCurrencyModeFromODataParameters(params);
-// "rub".
-```
-
-## `resolveCurrencyAwareLabel`
-
-```ts
-const label = resolveCurrencyAwareLabel("Выручка", ["за тн", "руб/тн"], "rub");
-// "Выручка руб/тн".
-```
-
-Пара `currencyLabels` имеет фиксированный смысл:
-
-```ts
-readonly[(internalLabel, rubLabel)];
-```
-
-| Mode       | Индекс суффикса |
-| ---------- | --------------: |
-| `internal` |               0 |
-| `rub`      |               1 |
-
-Точные правила:
-
-- без `currencyLabels` возвращается исходный `label`;
-- при `null`/`undefined` mode возвращается исходный `label`;
-- суффикс обрезается через `trim()`;
-- пустой суффикс не добавляется;
-- обычно между label и суффиксом добавляется один пробел;
-- если обрезанный суффикс начинается с запятой, дополнительный пробел не добавляется.
-
-```ts
-resolveCurrencyAwareLabel("Выручка", [", за тн", ", руб/тн"], "rub");
-// "Выручка, руб/тн".
-
-resolveCurrencyAwareLabel("Выручка", ["", "   "], "rub");
-// "Выручка".
-```
-
-Исходный `label` не обрезается и не нормализуется.
-
-## Готовый pipeline
-
-```ts
-function buildMetricLabel(
-	baseLabel: string,
-	currencyLabels: readonly [string, string] | undefined,
-	params: WrappedODataParameters | undefined
-) {
-	const mode = resolveCurrencyModeFromODataParameters(params);
-	return resolveCurrencyAwareLabel(baseLabel, currencyLabels, mode);
-}
-```
-
-Resolver чистый: одинаковый вход даёт одинаковую строку и не меняет params/labels.
-
-## Ограничения и ошибки
-
-- Поддерживается только параметр с точным id `p_curr`.
-- Поддерживаются только два режима; код валюты `USD`, `EUR` и exchange rate не обрабатываются.
-- Функция не проверяет грамматику и единицы измерения.
-- Запятая должна входить в сам суффикс, если нужна форма `"Выручка, руб"`.
-- Не передавайте плоский `{ p_curr: true }`: ожидается `{ p_curr: { value: true } }`.
-- Не используйте label helper для финансовых вычислений.
-
-## API-справочник
-
-| Export                                   | Результат               |
-| ---------------------------------------- | ----------------------- |
-| `CurrencyMode`                           | `"internal" \| "rub"`   |
-| `resolveCurrencyModeFromODataParameters` | `CurrencyMode \| null`  |
-| `resolveCurrencyAwareLabel`              | Итоговая display-строка |