@ryuzaki13/react-foundation-ui 1.8.10 → 1.8.12

package/storybook-static/assets/README-DnA-4W65.js

@@ -0,0 +1,226 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,p:`p`,pre:`pre`,strong:`strong`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Infrastructure/Notifications`}),`
+`,(0,c.jsx)(t.h1,{id:`notifications`,children:`Notifications`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/notifications`}),` хранит очередь коротких уведомлений и предоставляет два способа управления ею:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Zustand-store — для React-интерфейса, который отображает уведомления;`}),`
+`,(0,c.jsxs)(t.li,{children:[`объект `,(0,c.jsx)(t.code,{children:`notify`}),` — для императивных вызовов из обработчиков, сервисов и `,(0,c.jsx)(t.code,{children:`try/catch`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.strong,{children:`не рисует интерфейс`}),`. Компонент toast/snackbar создаёт приложение: он подписывается на `,(0,c.jsx)(t.code,{children:`store`}),`, отображает `,(0,c.jsx)(t.code,{children:`items`}),` и вызывает действия уведомления.`]}),`
+`,(0,c.jsx)(t.h2,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsx)(t.p,{children:`Подходит для сообщений вроде:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`«Изменения сохранены»;`}),`
+`,(0,c.jsx)(t.li,{children:`«Не удалось загрузить данные»;`}),`
+`,(0,c.jsx)(t.li,{children:`«Файл формируется…» с последующей заменой на результат;`}),`
+`,(0,c.jsx)(t.li,{children:`предупреждения с одной или несколькими кнопками-действиями.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для ошибок внутри формы лучше показывать сообщение рядом с полем. Уведомление — дополнительный, а не единственный канал обратной связи.`}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модулю нужен peer dependency `,(0,c.jsx)(t.code,{children:`zustand`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-lib zustand
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { bindNotifications, createNotificationsStore, notify, type Notification } from "@ryuzaki13/react-foundation-lib/notifications";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте только публичный subpath `,(0,c.jsx)(t.code,{children:`/notifications`}),`. Импорт внутренних файлов пакета не является публичным контрактом.`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.h3,{id:`1-создайте-один-store-приложения`,children:`1. Создайте один store приложения`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// notificationsStore.ts
+import { bindNotifications, createNotificationsStore } from "@ryuzaki13/react-foundation-lib/notifications";
+
+export const notificationsStore = createNotificationsStore();
+export const unbindNotifications = bindNotifications(notificationsStore);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createNotificationsStore()`}),` возвращает vanilla Zustand-store. Его следует создать вне React-компонента, иначе каждый рендер может создать новую независимую очередь.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`bindNotifications(store)`}),` связывает глобальный фасад `,(0,c.jsx)(t.code,{children:`notify`}),` с этим store. Без привязки вызов `,(0,c.jsx)(t.code,{children:`notify.success(...)`}),` выбросит ошибку.`]}),`
+`,(0,c.jsx)(t.h3,{id:`2-подпишите-ui-на-store`,children:`2. Подпишите UI на store`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useStore } from "zustand";
+
+import { notificationsStore } from "./notificationsStore";
+
+export function NotificationsViewport() {
+	const items = useStore(notificationsStore, (state) => state.items);
+	const dismiss = useStore(notificationsStore, (state) => state.actions.dismiss);
+
+	return (
+		<section aria-label="Уведомления" aria-live="polite">
+			{items.map((item) => (
+				<article key={item.id} role={item.type === "error" ? "alert" : "status"}>
+					{item.title && <strong>{item.title}</strong>}
+					<p>{item.message}</p>
+
+					{item.actions?.map((action) => (
+						<button key={action.label} type="button" onClick={action.onClick}>
+							{action.label}
+						</button>
+					))}
+
+					{item.dismissible !== false && (
+						<button type="button" onClick={() => dismiss(item.id)}>
+							Закрыть
+						</button>
+					)}
+				</article>
+			))}
+		</section>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`3-показывайте-уведомления`,children:`3. Показывайте уведомления`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`notify.success("Данные сохранены");
+notify.info("Началась синхронизация", { title: "Синхронизация" });
+notify.warning("Соединение нестабильно", { ttlMs: 0 });
+notify.error("Не удалось сохранить запись", { ttlMs: 15_000 });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Значение `,(0,c.jsx)(t.code,{children:`ttlMs: 0`}),` или отрицательное число отключает автоматическое закрытие.`]}),`
+`,(0,c.jsx)(t.h2,{id:`модель-уведомления`,children:`Модель уведомления`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type NotificationType = "error" | "warning" | "info" | "success";
+type NotificationTone = "neutral" | NotificationType;
+type NotificationId = string;
+
+type NotificationAction = {
+	label: string;
+	onClick: () => void | Promise<void>;
+	tone?: NotificationTone;
+};
+
+type Notification = {
+	id: NotificationId;
+	type: NotificationType;
+	title?: string;
+	message: string;
+	createdAt: number;
+	ttlMs?: number;
+	dismissible?: boolean;
+	actions?: NotificationAction[];
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createdAt`}),` — Unix-время в миллисекундах. `,(0,c.jsx)(t.code,{children:`dismissible: false`}),` означает, что UI не должен показывать обычную кнопку закрытия. Это только договор с UI: store не запрещает программный `,(0,c.jsx)(t.code,{children:`dismiss(id)`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`actions`}),` содержат функции и потому не сериализуются. Не сохраняйте очередь уведомлений в JSON, localStorage или серверной базе.`]}),`
+`,(0,c.jsx)(t.h2,{id:`api-store`,children:`API store`}),`
+`,(0,c.jsx)(t.h3,{id:`createnotificationsstore`,children:(0,c.jsx)(t.code,{children:`createNotificationsStore()`})}),`
+`,(0,c.jsx)(t.p,{children:`Создаёт независимый store со структурой:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type NotificationsStore = {
+	items: Notification[];
+	actions: {
+		push(input): NotificationId;
+		update(id, patch): boolean;
+		upsert(inputWithId): NotificationId;
+		dismiss(id): void;
+		clear(): void;
+	};
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Очередь ограничена шестью элементами. Новое уведомление помещается в начало. При добавлении с уже существующим `,(0,c.jsx)(t.code,{children:`id`}),` старый элемент удаляется, а новый получает новое `,(0,c.jsx)(t.code,{children:`createdAt`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`pushinput`,children:(0,c.jsx)(t.code,{children:`push(input)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Добавляет уведомление и возвращает его `,(0,c.jsx)(t.code,{children:`id`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const id = notificationsStore.getState().actions.push({
+	type: "warning",
+	title: "Проверка",
+	message: "Некоторые поля не заполнены",
+	ttlMs: 8_000,
+	dismissible: true
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`id`}),` не передан, он генерируется из текущего времени и случайной части. Это идентификатор UI, а не криптографический или бизнес-идентификатор.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`ttlMs`}),` отсутствует, внутренний таймер всё равно запускается на 10 секунд. При этом в объекте уведомления поле остаётся `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`updateid-patch`,children:(0,c.jsx)(t.code,{children:`update(id, patch)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Частично меняет существующий элемент. Возвращает `,(0,c.jsx)(t.code,{children:`true`}),`, если элемент найден, иначе `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const updated = notificationsStore.getState().actions.update(id, {
+	type: "success",
+	message: "Проверка завершена",
+	ttlMs: 2_500
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`id`}),` и `,(0,c.jsx)(t.code,{children:`createdAt`}),` изменить нельзя. Таймер перестраивается только тогда, когда в patch явно присутствует ключ `,(0,c.jsx)(t.code,{children:`ttlMs`}),`. Изменение одного `,(0,c.jsx)(t.code,{children:`message`}),` не продлевает исходный срок жизни.`]}),`
+`,(0,c.jsx)(t.h3,{id:`upsertinput`,children:(0,c.jsx)(t.code,{children:`upsert(input)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обновляет элемент с заданным `,(0,c.jsx)(t.code,{children:`id`}),`, а если его нет — добавляет новый.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`notificationsStore.getState().actions.upsert({
+	id: "import-users",
+	type: "info",
+	message: "Импортировано 40 из 100 строк",
+	dismissible: false
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Важная деталь: при обновлении существующего элемента `,(0,c.jsx)(t.code,{children:`upsert`}),` меняет `,(0,c.jsx)(t.code,{children:`type`}),`, `,(0,c.jsx)(t.code,{children:`title`}),`, `,(0,c.jsx)(t.code,{children:`message`}),`, `,(0,c.jsx)(t.code,{children:`ttlMs`}),` и `,(0,c.jsx)(t.code,{children:`dismissible`}),`, но не заменяет `,(0,c.jsx)(t.code,{children:`actions`}),`. Для явной смены действий используйте `,(0,c.jsx)(t.code,{children:`update(id, { actions })`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`dismissid-и-clear`,children:[(0,c.jsx)(t.code,{children:`dismiss(id)`}),` и `,(0,c.jsx)(t.code,{children:`clear()`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`dismiss(id)`}),` удаляет один элемент и очищает его таймер. `,(0,c.jsx)(t.code,{children:`clear()`}),` удаляет всю очередь и все таймеры.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`императивный-api-notify`,children:[`Императивный API `,(0,c.jsx)(t.code,{children:`notify`})]}),`
+`,(0,c.jsx)(t.h3,{id:`привязка-и-жизненный-цикл`,children:`Привязка и жизненный цикл`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const unbind = bindNotifications(notificationsStore);
+
+// При полном демонтаже приложения:
+unbind();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Одновременно фасад хранит только одну привязку. Повторный `,(0,c.jsx)(t.code,{children:`bindNotifications(otherStore)`}),` переключит вызовы на другой store. Старый cleanup не отвяжет новый store.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Пакет не экспортирует `,(0,c.jsx)(t.code,{children:`NotificationsProvider`}),`, несмотря на текст ошибки при отсутствии привязки. Provider или другой lifecycle-компонент является ответственностью приложения.`]}),`
+`,(0,c.jsx)(t.h3,{id:`основные-методы`,children:`Основные методы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`notify.push(input);
+notify.upsert(inputWithId);
+notify.update(id, patch);
+notify.dismiss(id);
+notify.clear();
+
+notify.success(message, options);
+notify.info(message, options);
+notify.warning(message, options);
+notify.error(message, options);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сокращённые методы автоматически подставляют `,(0,c.jsx)(t.code,{children:`type`}),`, но принимают остальные параметры `,(0,c.jsx)(t.code,{children:`push`}),`, включая `,(0,c.jsx)(t.code,{children:`id`}),`, `,(0,c.jsx)(t.code,{children:`title`}),`, `,(0,c.jsx)(t.code,{children:`ttlMs`}),`, `,(0,c.jsx)(t.code,{children:`dismissible`}),` и `,(0,c.jsx)(t.code,{children:`actions`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`долгая-операция-notifyprogress`,children:[`Долгая операция: `,(0,c.jsx)(t.code,{children:`notify.progress()`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function importFile(file: File) {
+	const progress = notify.progress("Читаем файл…", {
+		id: "users-import",
+		title: "Импорт пользователей"
+	});
+
+	try {
+		progress.update("Отправляем данные…");
+		await upload(file);
+		progress.success("Импорт завершён");
+	} catch (error) {
+		progress.error("Импорт завершился с ошибкой");
+		throw error;
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Начальное уведомление имеет `,(0,c.jsx)(t.code,{children:`type: "info"`}),` и `,(0,c.jsx)(t.code,{children:`dismissible: false`}),`. Возвращаемый объект содержит:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`id`}),` — идентификатор уведомления;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`update(message)`}),` — меняет текст, не перезапуская таймер;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`success(message, ttlMs = 2500)`}),` — делает уведомление успешным и закрываемым;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`error(message, ttlMs = 5000)`}),` — делает уведомление ошибкой и закрываемым;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`dismiss()`}),` — удаляет уведомление.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При переданном стабильном `,(0,c.jsx)(t.code,{children:`id`}),` повторный `,(0,c.jsx)(t.code,{children:`progress`}),` продолжит существующий элемент. Это удобно для операции, которая может стартовать из нескольких мест.`]}),`
+`,(0,c.jsx)(t.h2,{id:`browser-и-ssr`,children:`Browser и SSR`}),`
+`,(0,c.jsxs)(t.p,{children:[`Store использует `,(0,c.jsx)(t.code,{children:`window.setTimeout`}),` и `,(0,c.jsx)(t.code,{children:`window.clearTimeout`}),`. Создать store можно заранее, но методы, которые запускают или очищают таймеры, предназначены для браузера. Не вызывайте `,(0,c.jsx)(t.code,{children:`push`}),`, `,(0,c.jsx)(t.code,{children:`update`}),` с `,(0,c.jsx)(t.code,{children:`ttlMs`}),`, `,(0,c.jsx)(t.code,{children:`dismiss`}),` или `,(0,c.jsx)(t.code,{children:`clear`}),` во время серверного рендера.`]}),`
+`,(0,c.jsx)(t.p,{children:`Практически безопасная схема: создавать и привязывать store в client entrypoint либо в модуле, который импортируется только браузерным приложением.`}),`
+`,(0,c.jsx)(t.h2,{id:`доступность-интерфейса`,children:`Доступность интерфейса`}),`
+`,(0,c.jsx)(t.p,{children:`Store не задаёт ARIA-разметку. В UI рекомендуется:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`использовать `,(0,c.jsx)(t.code,{children:`aria-live="polite"`}),` для обычных сообщений;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`использовать `,(0,c.jsx)(t.code,{children:`role="alert"`}),` только для действительно срочных ошибок;`]}),`
+`,(0,c.jsx)(t.li,{children:`давать кнопке закрытия понятное доступное имя;`}),`
+`,(0,c.jsx)(t.li,{children:`не делать TTL слишком коротким, если уведомление содержит много текста или действия;`}),`
+`,(0,c.jsx)(t.li,{children:`обеспечить управление действиями с клавиатуры.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsxs)(t.h3,{id:`вызов-notify-до-bindnotifications`,children:[`Вызов `,(0,c.jsx)(t.code,{children:`notify`}),` до `,(0,c.jsx)(t.code,{children:`bindNotifications`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Ошибка времени выполнения: store ещё не привязан.
+notify.success("Готово");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сначала создайте store и выполните `,(0,c.jsx)(t.code,{children:`bindNotifications`}),` в точке запуска приложения.`]}),`
+`,(0,c.jsx)(t.h3,{id:`создание-store-внутри-тела-компонента`,children:`Создание store внутри тела компонента`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function App() {
+	// Плохо: при повторном рендере можно потерять очередь и таймеры.
+	const store = createNotificationsStore();
+	return null;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Создайте singleton на уровне модуля или один раз через подходящий lifecycle-контейнер.`}),`
+`,(0,c.jsxs)(t.h3,{id:`ожидание-что-dismissible-false-блокирует-удаление`,children:[`Ожидание, что `,(0,c.jsx)(t.code,{children:`dismissible: false`}),` блокирует удаление`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это только поле модели для UI. `,(0,c.jsx)(t.code,{children:`notify.dismiss(id)`}),` всё равно удалит элемент.`]}),`
+`,(0,c.jsx)(t.h3,{id:`использование-уведомления-вместо-состояния-операции`,children:`Использование уведомления вместо состояния операции`}),`
+`,(0,c.jsx)(t.p,{children:`Очередь ограничена шестью элементами и живёт в памяти страницы. Не используйте её как журнал аудита, источник истины о фоновой задаче или долговременное хранилище ошибок.`}),`
+`,(0,c.jsx)(t.h2,{id:`краткая-карта-api`,children:`Краткая карта API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Экспорт`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createNotificationsStore()`})}),(0,c.jsx)(t.td,{children:`Создать независимый Zustand-store уведомлений`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`bindNotifications(store)`})}),(0,c.jsxs)(t.td,{children:[`Привязать store к глобальному фасаду `,(0,c.jsx)(t.code,{children:`notify`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`notify`})}),(0,c.jsx)(t.td,{children:`Императивно добавлять, обновлять и закрывать уведомления`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Notification`})}),(0,c.jsx)(t.td,{children:`Полная модель сохранённого элемента`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`NotificationPushInput`})}),(0,c.jsx)(t.td,{children:`Параметры добавления элемента`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`NotificationUpdatePatch`})}),(0,c.jsx)(t.td,{children:`Допустимые поля частичного обновления`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`NotificationsStoreApi`})}),(0,c.jsx)(t.td,{children:`Тип vanilla Zustand-store`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`NotificationAction`})}),(0,c.jsx)(t.td,{children:`Кнопка-действие уведомления`})]})]})]})]})}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/README-DoCA4JXf.js

@@ -0,0 +1,273 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,p:`p`,pre:`pre`,strong:`strong`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation API/Query/Generic Resource`}),`
+`,(0,c.jsxs)(t.h1,{id:`generic-resources-через-ryuzaki13react-foundation-apiresource`,children:[`Generic resources через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/resource`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль описывает transport-agnostic ресурс поверх TanStack Query: стабильные query keys, проверку scope, произвольные read/write operations и cache strategies после mutation.`}),`
+`,(0,c.jsx)(t.h2,{id:`для-кого-этот-документ`,children:`Для кого этот документ`}),`
+`,(0,c.jsx)(t.p,{children:`Здесь термины используются так:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`resource`}),` — технически связанная группа данных, например `,(0,c.jsx)(t.code,{children:`orders`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`scope`}),` — контекст, внутри которого данные уникальны, например `,(0,c.jsx)(t.code,{children:`{ companyId }`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`query/read operation`}),` — чтение без изменения server state;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`mutation/write operation`}),` — создание/изменение/удаление;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`descriptor`}),` — объект, объединяющий identity, operations и правила доступности;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.strong,{children:`query key`}),` — сериализуемый identity записи в TanStack Query cache.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не выполняет HTTP/OData сам. Transport находится внутри `,(0,c.jsx)(t.code,{children:`operation.execute`}),` или создаётся adapter-ом `,(0,c.jsx)(t.code,{children:`/server-fn`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`/resource`}),`, когда названия операций произвольны: `,(0,c.jsx)(t.code,{children:`search`}),`, `,(0,c.jsx)(t.code,{children:`detail`}),`, `,(0,c.jsx)(t.code,{children:`archive`}),`, `,(0,c.jsx)(t.code,{children:`recalculate`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для стандартной модели сохранённых записей `,(0,c.jsx)(t.code,{children:`list/latest/history/save/create/delete`}),` удобнее `,(0,c.jsx)(t.a,{href:`../persisted/README.mdx`,children:(0,c.jsx)(t.code,{children:`/persisted`})}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-provider`,children:`Установка и provider`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-api @ryuzaki13/react-foundation-lib @tanstack/react-query react
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`React hooks работают только внутри `,(0,c.jsx)(t.code,{children:`QueryClientProvider`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+
+const queryClient = new QueryClient();
+
+export function App() {
+	return <QueryClientProvider client={queryClient}>{/* routes */}</QueryClientProvider>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Создайте client один раз, а не внутри render.`}),`
+`,(0,c.jsx)(t.h2,{id:`импорт`,children:`Импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	applyResourceCacheStrategy,
+	buildResourceQueryOptions,
+	composeResourceCacheStrategies,
+	createInvalidateResourceScopeCacheStrategy,
+	createResourceDescriptor,
+	createResourceKeys,
+	createResourceMutationOperation,
+	createResourceQueryOperation,
+	createSetResourceQueryDataCacheStrategy,
+	getResourceQueryData,
+	normalizeResourceKeyValue,
+	useResourceMutation,
+	useResourceQuery
+} from "@ryuzaki13/react-foundation-api/resource";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Типы экспортируются из того же subpath.`}),`
+`,(0,c.jsx)(t.h2,{id:`пошаговый-пример`,children:`Пошаговый пример`}),`
+`,(0,c.jsx)(t.h3,{id:`1-описать-scope-и-данные`,children:`1. Описать scope и данные`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type OrdersScope = {
+	companyId: string;
+};
+
+type SearchOrdersArgs = {
+	search: string;
+	limit: number;
+};
+
+type Order = {
+	id: string;
+	title: string;
+};
+
+type SaveOrderInput = {
+	id: string;
+	title: string;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`2-создать-operations`,children:`2. Создать operations`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const searchOperation = createResourceQueryOperation<
+	OrdersScope,
+	SearchOrdersArgs,
+	Order[]
+>({
+	async execute({ scope, args, signal }) {
+		const query = new URLSearchParams({
+			companyId: scope.companyId,
+			search: args.search,
+			limit: String(args.limit)
+		});
+
+		const response = await fetch(\`/api/orders?\${query}\`, { signal });
+		if (!response.ok) throw new Error(\`HTTP \${response.status}\`);
+		return response.json() as Promise<Order[]>;
+	},
+	isEnabled: (scope, args) => Boolean(scope?.companyId && args.limit > 0),
+	staleTime: 60_000,
+	gcTime: 5 * 60_000
+});
+
+const saveOperation = createResourceMutationOperation<
+	OrdersScope,
+	SaveOrderInput,
+	Order,
+	unknown
+>({
+	async execute({ scope, input }) {
+		const response = await fetch(\`/api/companies/\${scope.companyId}/orders/\${input.id}\`, {
+			method: "PUT",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(input)
+		});
+
+		if (!response.ok) throw new Error(\`HTTP \${response.status}\`);
+		return response.json() as Promise<Order>;
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Factories `,(0,c.jsx)(t.code,{children:`createResourceQueryOperation`}),` и `,(0,c.jsx)(t.code,{children:`createResourceMutationOperation`}),` не изменяют объект. Они помогают TypeScript сохранить generic types.`]}),`
+`,(0,c.jsx)(t.h3,{id:`3-создать-descriptor`,children:`3. Создать descriptor`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ordersResource = createResourceDescriptor({
+	namespace: "sales",
+	resource: "orders",
+	normalizeScope: (scope: OrdersScope | null | undefined) => ({
+		companyId: scope?.companyId.trim() ?? ""
+	}),
+	operations: {
+		queries: { search: searchOperation },
+		mutations: { save: saveOperation }
+	},
+	isEnabled: (scope) => Boolean(scope?.companyId),
+	getScopeError: () => "Не выбрана компания"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`namespace + resource`}),` должны быть устойчивыми и уникальными. Не включайте локализованные labels или случайные значения.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeScope`}),` влияет только на query key. В `,(0,c.jsx)(t.code,{children:`execute`}),` приходит исходный literal scope. Например, key получит trimmed `,(0,c.jsx)(t.code,{children:`companyId`}),`, но operation увидит строку ровно в переданном object. Это позволяет нормализовать identity, не переписывая draft/input.`]}),`
+`,(0,c.jsx)(t.h3,{id:`4-использовать-query-hook`,children:`4. Использовать query hook`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function OrdersList({ companyId, search }: Props) {
+	const query = useResourceQuery(
+		ordersResource,
+		"search",
+		{ companyId },
+		{ search, limit: 50 }
+	);
+
+	if (query.isPending) return <p>Загрузка…</p>;
+	if (query.isError) return <p>Ошибка загрузки</p>;
+
+	return query.data.map((order) => <div key={order.id}>{order.title}</div>);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Rules of Hooks применяются полностью: hook нельзя вызывать условно или в callback.`}),`
+`,(0,c.jsx)(t.h3,{id:`5-использовать-mutation-hook`,children:`5. Использовать mutation hook`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const mutation = useResourceMutation(
+	ordersResource,
+	"save",
+	{ companyId },
+	{
+		onSuccess(savedOrder) {
+			showSuccess(\`Сохранён \${savedOrder.title}\`);
+		}
+	}
+);
+
+mutation.mutate({ id: "42", title: "Новый заголовок" });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Mutation key содержит resource/scope/operation, но не input. Input передаётся только в `,(0,c.jsx)(t.code,{children:`mutationFn`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`query-lifecycle`,children:`Query lifecycle`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildResourceQueryOptions(descriptor, name, scope, args)`}),` создаёт TanStack `,(0,c.jsx)(t.code,{children:`queryOptions`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`key из `,(0,c.jsx)(t.code,{children:`descriptor.keys.operation`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`query function с `,(0,c.jsx)(t.code,{children:`{ scope, args, client, signal }`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`enabled`}),` из descriptor и operation;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`staleTime`}),`/`,(0,c.jsx)(t.code,{children:`gcTime`}),` из operation.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const options = buildResourceQueryOptions(
+	ordersResource,
+	"search",
+	{ companyId: "1000" },
+	{ search: "", limit: 50 }
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`enabled`}),` сначала проверяет `,(0,c.jsx)(t.code,{children:`descriptor.isEnabled(scope)`}),`, затем `,(0,c.jsx)(t.code,{children:`operation.isEnabled(scope, args)`}),`. Если одна проверка вернула `,(0,c.jsx)(t.code,{children:`false`}),`, React query не стартует автоматически.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Перед фактическим `,(0,c.jsx)(t.code,{children:`execute`}),` scope обязан быть не `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` и пройти descriptor policy. Иначе выбрасывается `,(0,c.jsx)(t.code,{children:`getScopeError`}),` или стандартная ошибка.`]}),`
+`,(0,c.jsx)(t.h2,{id:`императивная-загрузка`,children:`Императивная загрузка`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const orders = await getResourceQueryData(
+	ordersResource,
+	"search",
+	{ companyId: "1000" },
+	{ search: "", limit: 50 },
+	queryClient
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция использует `,(0,c.jsx)(t.code,{children:`queryClient.fetchQuery`}),`, поэтому переиспользует query cache. Передавайте только валидный scope: imperative `,(0,c.jsx)(t.code,{children:`fetchQuery`}),` нельзя воспринимать как disabled React observer; query function всё равно защищает scope и может бросить ошибку.`]}),`
+`,(0,c.jsx)(t.h2,{id:`query-keys`,children:`Query keys`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const keys = createResourceKeys<OrdersScope, "search" | "save">({
+	namespace: "sales",
+	resource: "orders",
+	normalizeScope: (scope) => ({ companyId: scope?.companyId ?? "" })
+});
+
+keys.all;
+// ["sales", "orders"]
+
+keys.scope({ companyId: "1000" });
+// ["sales", "orders", { companyId: "1000" }]
+
+keys.operation("search", { companyId: "1000" }, { limit: 50 });
+// ["sales", "orders", { companyId: "1000" }, "search", { limit: 50 }]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`args === undefined`}),` не добавляется в key. `,(0,c.jsx)(t.code,{children:`args === null`}),` добавляется как `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`normalizeresourcekeyvalue`,children:(0,c.jsx)(t.code,{children:`normalizeResourceKeyValue`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализация рекурсивна:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` → `,(0,c.jsx)(t.code,{children:`null`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`string → `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`number/boolean остаются без изменения;`}),`
+`,(0,c.jsx)(t.li,{children:`array нормализуется по элементам, порядок сохраняется;`}),`
+`,(0,c.jsx)(t.li,{children:`object keys сортируются, значения нормализуются;`}),`
+`,(0,c.jsxs)(t.li,{children:[`другие значения превращаются через `,(0,c.jsx)(t.code,{children:`String(value)`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeResourceKeyValue({ b: " x ", a: undefined });
+// { a: null, b: "x" }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ограничения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Date`}),`, `,(0,c.jsx)(t.code,{children:`Map`}),`, `,(0,c.jsx)(t.code,{children:`Set`}),` и class instances не имеют специальной сериализации; обычный `,(0,c.jsx)(t.code,{children:`Date`}),` превратится в `,(0,c.jsx)(t.code,{children:`{}`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`cyclic object приведёт к рекурсивной ошибке;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`NaN`}),`/`,(0,c.jsx)(t.code,{children:`Infinity`}),` остаются number, но их cache semantics могут быть неочевидны;`]}),`
+`,(0,c.jsx)(t.li,{children:`function/symbol/bigint превращаются в строки и могут collision-иться.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Нормализуйте специальные значения сами, например Date → ISO string. Query key не должен содержать secrets, DOM nodes или огромные payload.`}),`
+`,(0,c.jsx)(t.h2,{id:`cache-strategies-после-mutation`,children:`Cache strategies после mutation`}),`
+`,(0,c.jsx)(t.h3,{id:`инвалидация-scope`,children:`Инвалидация scope`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const invalidateScope = createInvalidateResourceScopeCacheStrategy();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Стратегия вызывает `,(0,c.jsx)(t.code,{children:`client.invalidateQueries`}),` по `,(0,c.jsx)(t.code,{children:`descriptor.keys.scope(scope)`}),`. Все query этого resource/scope становятся stale и активные observers могут refetch.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`точечный-setquerydata`,children:[`Точечный `,(0,c.jsx)(t.code,{children:`setQueryData`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const updateDetail = createSetResourceQueryDataCacheStrategy<
+	OrdersScope,
+	SaveOrderInput,
+	Order,
+	Order[],
+	typeof ordersResource
+>({
+	getQueryKey: ({ descriptor, scope }) =>
+		descriptor.keys.operation("search", scope, { search: "", limit: 50 }),
+	update: (current = [], { result }) =>
+		current.map((order) => (order.id === result.id ? result : order))
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`update`}),` получает текущее cache data или `,(0,c.jsx)(t.code,{children:`undefined`}),`, а также descriptor/scope/input/result/client. Оно должно возвращать новое значение и не мутировать старое.`]}),`
+`,(0,c.jsx)(t.h3,{id:`композиция`,children:`Композиция`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const strategy = composeResourceCacheStrategies(
+	updateDetail,
+	invalidateScope
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Strategies выполняются последовательно в переданном порядке. Если одна бросила ошибку, следующие и custom `,(0,c.jsx)(t.code,{children:`onSuccess`}),` mutation hook не выполнятся; сама server mutation при этом уже могла успешно завершиться.`]}),`
+`,(0,c.jsx)(t.h3,{id:`override-в-hook`,children:`Override в hook`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`useResourceMutation(descriptor, "save", scope, {
+	cacheStrategy: undefined // Использовать strategy операции.
+});
+
+useResourceMutation(descriptor, "save", scope, {
+	cacheStrategy: null // Полностью отключить strategy операции.
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Переданная strategy заменяет operation strategy, а не дополняет её. Для объединения используйте `,(0,c.jsx)(t.code,{children:`composeResourceCacheStrategies`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`applyResourceCacheStrategy(strategy, context)`}),` — низкоуровневый helper для ручного применения optional strategy.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-и-границы`,children:`Ошибки и границы`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Отсутствующая operation даёт раннюю ошибку с именем resource/operation.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Невалидный scope блокирует hook через `,(0,c.jsx)(t.code,{children:`enabled`}),`, но ручное выполнение бросает ошибку.`]}),`
+`,(0,c.jsx)(t.li,{children:`Error transport-а сохраняется TanStack Query без автоматического преобразования.`}),`
+`,(0,c.jsx)(t.li,{children:`Descriptor лучше создавать на уровне module, чтобы ссылка не менялась на каждом render.`}),`
+`,(0,c.jsx)(t.li,{children:`Args/scope должны быть сериализуемыми и описывать все данные, влияющие на query result.`}),`
+`,(0,c.jsx)(t.li,{children:`Не используйте query cache как authoritative persistent storage.`}),`
+`,(0,c.jsx)(t.li,{children:`Cache strategy выполняется только после успешной mutation.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`полный-api`,children:`Полный API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Группа`}),(0,c.jsx)(t.th,{children:`Exports`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Descriptor/operations`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`createResourceDescriptor`}),`, `,(0,c.jsx)(t.code,{children:`createResourceQueryOperation`}),`, `,(0,c.jsx)(t.code,{children:`createResourceMutationOperation`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Query/mutation`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`buildResourceQueryOptions`}),`, `,(0,c.jsx)(t.code,{children:`useResourceQuery`}),`, `,(0,c.jsx)(t.code,{children:`getResourceQueryData`}),`, `,(0,c.jsx)(t.code,{children:`useResourceMutation`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Keys`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`normalizeResourceKeyValue`}),`, `,(0,c.jsx)(t.code,{children:`createResourceKeys`}),`, `,(0,c.jsx)(t.code,{children:`ResourceKeyValue`}),`, `,(0,c.jsx)(t.code,{children:`ResourceKeys`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Cache`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`applyResourceCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`createInvalidateResourceScopeCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`createSetResourceQueryDataCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`composeResourceCacheStrategies`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Contracts`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ResourceQueryOperationContext`}),`, `,(0,c.jsx)(t.code,{children:`ResourceMutationOperationContext`}),`, `,(0,c.jsx)(t.code,{children:`ResourceQueryOperation`}),`, `,(0,c.jsx)(t.code,{children:`ResourceMutationOperation`}),`, `,(0,c.jsx)(t.code,{children:`ResourceDescriptor`}),`, `,(0,c.jsx)(t.code,{children:`CreateResourceDescriptorOptions`}),`, `,(0,c.jsx)(t.code,{children:`ResourceCacheStrategyContext`}),`, `,(0,c.jsx)(t.code,{children:`ResourceCacheStrategy`}),`, `,(0,c.jsx)(t.code,{children:`UseResourceMutationOptions`}),`, `,(0,c.jsx)(t.code,{children:`ResourceSetQueryDataStrategyOptions`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Type extraction`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ResourceQueryArgs`}),`, `,(0,c.jsx)(t.code,{children:`ResourceQueryResult`}),`, `,(0,c.jsx)(t.code,{children:`ResourceMutationInput`}),`, `,(0,c.jsx)(t.code,{children:`ResourceMutationResult`})]})]})]})]})]})}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/{README-DUxV9GhP.js → README-DvAlDsh9.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-BOu-P2xF.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-Ddv0ZNIG.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Boolean`}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Boolean`}),`
 `,(0,c.jsxs)(t.h1,{id:`boolean-и-abap-boolean-через-ryuzaki13react-foundation-libformatters`,children:[`Boolean и ABAP boolean через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`})]}),`
 `,(0,c.jsxs)(t.p,{children:[`Подмодуль `,(0,c.jsx)(t.code,{children:`boolean`}),` преобразует значения между JavaScript `,(0,c.jsx)(t.code,{children:`boolean`}),` и двухсимвольным ABAP-контрактом:`]}),`
 `,(0,c.jsxs)(t.ul,{children:[`