@ryuzaki13/react-foundation-lib 1.4.3 → 1.5.0

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/formatters/date/README.mdx

@@ -16,6 +16,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 ```ts
 import {
 	formatDateAsDate,
+	formatInstantDateTime,
 	getCalendarPeriod,
 	normalizeDateRange,
 	parseDate,
@@ -55,6 +56,15 @@ date?.toISOString(); // "2026-03-03T13:03:50.000Z"
 
 Локальные getters такого `Date` зависят от timezone среды. Используйте TZ-вариант, когда значение означает настоящий момент события: timestamp аудита, время серверного события, instant для сортировки между часовыми поясами.
 
+Для одинакового отображения абсолютной метки времени на SSR-сервере и в браузере
+используйте явный часовой пояс IANA:
+
+```ts
+formatInstantDateTime("2026-09-04T10:22:28Z", {
+	timeZone: "Asia/Yekaterinburg"
+}); // "4 сент. 2026 г., 15:22:28"
+```
+
 ### Простое правило выбора
 
 | Значение означает              | Использовать                           |
@@ -697,7 +707,7 @@ Intl-форматы локализованы. Для API используйте
 | Семейство        | Публичный API                                                                                                                                                                                                                                                                                                                                                                     |
 | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Parsing          | `parseDateValue`, `parseDateValueTZ`, `parseDate`, `parseDateTZ`, `parseDateByPattern`, `parseDateByFormat`                                                                                                                                                                                                                                                                       |
-| Universal format | `formatDate`, `formatDateRange`                                                                                                                                                                                                                                                                                                                                                   |
+| Universal format | `formatDate`, `formatDateRange`, `formatInstantDateTime`                                                                                                                                                                                                                                                                                                                          |
 | UI wrappers      | все `formatDateAsDate*`, `formatDateAsMonth*`, `formatDateAsTime*`, `formatDateAsDatetime*`                                                                                                                                                                                                                                                                                       |
 | Machine wrappers | `formatDateAsAbapYear`, `formatDateAsAbapMonth`, `formatDateAsAbapDate`, `formatDateAsAbapDatetime`, `formatDateAsODataDate`, `formatDateAsODataDatetime`, `formatDateAsODataTime`                                                                                                                                                                                                |
 | Presets          | `DATE_FORMAT_DEFAULTS`, `DEFAULT_DATE_PRESET_NAMES`, `DATE_FORMAT_STYLE_PRESET_NAMES`, `getDatePreset`, `getDatePresetNames`, `registerDatePreset`, `resetDatePresets`, `resolveDateFormatName`, `resolveDateFormatPreset`, type guards                                                                                                                                           |

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 не сделал этого автоматически:
 

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
 ```
 
 Публичный импорт: