@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.13

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

@@ -0,0 +1,226 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={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-BbNHvOoR.js

@@ -0,0 +1,101 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,li:`li`,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/Data/Currency`}),`
+`,(0,c.jsxs)(t.h1,{id:`валютные-подписи-через-ryuzaki13react-foundation-libcurrency`,children:[`Валютные подписи через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/currency`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль связывает общий OData-параметр `,(0,c.jsx)(t.code,{children:`p_curr`}),` с отображаемой подписью показателя. Он определяет один из двух режимов валюты и добавляет соответствующий суффикс к label.`]}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5`,children:`Назначение`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#currencymode`,children:(0,c.jsx)(t.code,{children:`CurrencyMode`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#resolvecurrencymodefromodataparameters`,children:(0,c.jsx)(t.code,{children:`resolveCurrencyModeFromODataParameters`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#resolvecurrencyawarelabel`,children:(0,c.jsx)(t.code,{children:`resolveCurrencyAwareLabel`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D1%8B%D0%B9-pipeline`,children:`Готовый pipeline`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F-%D0%B8-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`Ограничения и ошибки`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#api-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA`,children:`API-справочник`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение`,children:`Назначение`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`wrapped OData params
+{ p_curr: { value: true } }
+              │
+              ▼
+      CurrencyMode "rub"
+              │
+              ▼
+"Выручка" + ["за тн", "руб/тн"]
+              │
+              ▼
+       "Выручка руб/тн"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не форматирует денежное число, не конвертирует валюту и не строит OData query. Для чисел используйте `,(0,c.jsx)(t.code,{children:`/formatters`}),`, для OData params — `,(0,c.jsx)(t.code,{children:`/odata-service`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { resolveCurrencyAwareLabel, resolveCurrencyModeFromODataParameters } from "@ryuzaki13/react-foundation-lib/currency";
+
+import type { CurrencyMode } from "@ryuzaki13/react-foundation-lib/currency";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль ESM, не требует React или browser API. Параметры должны иметь публичную wrapped-форму из `,(0,c.jsx)(t.code,{children:`/odata-service`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`currencymode`,children:(0,c.jsx)(t.code,{children:`CurrencyMode`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type CurrencyMode = "internal" | "rub";
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`internal`}),` — внутренний режим;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`rub`}),` — рублёвый режим.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`null`}),` используется resolver-функцией, когда режим определить нельзя.`]}),`
+`,(0,c.jsx)(t.h2,{id:`resolvecurrencymodefromodataparameters`,children:(0,c.jsx)(t.code,{children:`resolveCurrencyModeFromODataParameters`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const mode = resolveCurrencyModeFromODataParameters(params);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция читает только собственное поле `,(0,c.jsx)(t.code,{children:`p_curr.value`}),`:`]}),`
+`,(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.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`поля `,(0,c.jsx)(t.code,{children:`p_curr`}),` нет`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ p_curr: { value: false } }`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"internal"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ p_curr: { value: true } }`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"rub"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ p_curr: { value: "true" } }`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ p_curr: { value: 1 } }`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Строка `,(0,c.jsx)(t.code,{children:`"true"`}),` намеренно не приводится к boolean. Нормализуйте внешний payload на OData boundary, а не внутри UI label.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Пример с helper `,(0,c.jsx)(t.code,{children:`/odata-service`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { wrapODataParams } from "@ryuzaki13/react-foundation-lib/odata-service";
+
+const params = wrapODataParams({ p_curr: true });
+const mode = resolveCurrencyModeFromODataParameters(params);
+// "rub".
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`resolvecurrencyawarelabel`,children:(0,c.jsx)(t.code,{children:`resolveCurrencyAwareLabel`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const label = resolveCurrencyAwareLabel("Выручка", ["за тн", "руб/тн"], "rub");
+// "Выручка руб/тн".
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пара `,(0,c.jsx)(t.code,{children:`currencyLabels`}),` имеет фиксированный смысл:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`readonly[(internalLabel, rubLabel)];
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Mode`}),(0,c.jsx)(t.th,{style:{textAlign:`right`},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:`internal`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`0`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rub`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`1`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Точные правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`без `,(0,c.jsx)(t.code,{children:`currencyLabels`}),` возвращается исходный `,(0,c.jsx)(t.code,{children:`label`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`при `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` mode возвращается исходный `,(0,c.jsx)(t.code,{children:`label`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`суффикс обрезается через `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`пустой суффикс не добавляется;`}),`
+`,(0,c.jsx)(t.li,{children:`обычно между label и суффиксом добавляется один пробел;`}),`
+`,(0,c.jsx)(t.li,{children:`если обрезанный суффикс начинается с запятой, дополнительный пробел не добавляется.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveCurrencyAwareLabel("Выручка", [", за тн", ", руб/тн"], "rub");
+// "Выручка, руб/тн".
+
+resolveCurrencyAwareLabel("Выручка", ["", "   "], "rub");
+// "Выручка".
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Исходный `,(0,c.jsx)(t.code,{children:`label`}),` не обрезается и не нормализуется.`]}),`
+`,(0,c.jsx)(t.h2,{id:`готовый-pipeline`,children:`Готовый pipeline`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function buildMetricLabel(
+	baseLabel: string,
+	currencyLabels: readonly [string, string] | undefined,
+	params: WrappedODataParameters | undefined
+) {
+	const mode = resolveCurrencyModeFromODataParameters(params);
+	return resolveCurrencyAwareLabel(baseLabel, currencyLabels, mode);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Resolver чистый: одинаковый вход даёт одинаковую строку и не меняет params/labels.`}),`
+`,(0,c.jsx)(t.h2,{id:`ограничения-и-ошибки`,children:`Ограничения и ошибки`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Поддерживается только параметр с точным id `,(0,c.jsx)(t.code,{children:`p_curr`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Поддерживаются только два режима; код валюты `,(0,c.jsx)(t.code,{children:`USD`}),`, `,(0,c.jsx)(t.code,{children:`EUR`}),` и exchange rate не обрабатываются.`]}),`
+`,(0,c.jsx)(t.li,{children:`Функция не проверяет грамматику и единицы измерения.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Запятая должна входить в сам суффикс, если нужна форма `,(0,c.jsx)(t.code,{children:`"Выручка, руб"`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Не передавайте плоский `,(0,c.jsx)(t.code,{children:`{ p_curr: true }`}),`: ожидается `,(0,c.jsx)(t.code,{children:`{ p_curr: { value: true } }`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не используйте label helper для финансовых вычислений.`}),`
+`]}),`
+`,(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:`Export`}),(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:`CurrencyMode`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"internal" | "rub"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveCurrencyModeFromODataParameters`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`CurrencyMode | null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveCurrencyAwareLabel`})}),(0,c.jsx)(t.td,{children:`Итоговая display-строка`})]})]})]})]})}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-BbunUo8b.js

@@ -0,0 +1,118 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,li:`li`,p:`p`,pre:`pre`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Contracts/Common Types`}),`
+`,(0,c.jsxs)(t.h1,{id:`общие-технические-типы-ryuzaki13react-foundation-libtypes`,children:[`Общие технические типы `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/types`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль содержит небольшие общие TypeScript-контракты для value state, ABAP boolean, базовых значений, диапазонов и строк таблицы. Единственная runtime-функция — `,(0,c.jsx)(t.code,{children:`isBaseType`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#state`,children:(0,c.jsx)(t.code,{children:`State`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#abapboolean`,children:(0,c.jsx)(t.code,{children:`AbapBoolean`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#primitive-%D0%B8-basetype`,children:[(0,c.jsx)(t.code,{children:`Primitive`}),` и `,(0,c.jsx)(t.code,{children:`BaseType`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#isbasetype`,children:(0,c.jsx)(t.code,{children:`isBaseType`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#arraytype-objecttype-inputtype`,children:[(0,c.jsx)(t.code,{children:`ArrayType`}),`, `,(0,c.jsx)(t.code,{children:`ObjectType`}),`, `,(0,c.jsx)(t.code,{children:`InputType`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#rangetype`,children:(0,c.jsx)(t.code,{children:`RangeType`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#rowrecord`,children:(0,c.jsx)(t.code,{children:`RowRecord`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8-%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F`,children:`Ошибки проектирования`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { isBaseType } from "@ryuzaki13/react-foundation-lib/types";
+
+import type {
+	AbapBoolean,
+	ArrayType,
+	BaseType,
+	InputType,
+	ObjectType,
+	Primitive,
+	RangeType,
+	RowRecord,
+	State
+} from "@ryuzaki13/react-foundation-lib/types";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Типы исчезают после компиляции TypeScript. Не пытайтесь использовать `,(0,c.jsx)(t.code,{children:`State`}),` или `,(0,c.jsx)(t.code,{children:`RowRecord`}),` как runtime validator.`]}),`
+`,(0,c.jsx)(t.h2,{id:`state`,children:(0,c.jsx)(t.code,{children:`State`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type State = "" | "none" | "information" | "success" | "warning" | "error";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это общий display/value state, а не HTTP status и не состояние async request.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const state: State = "warning";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустая строка и `,(0,c.jsx)(t.code,{children:`"none"`}),` являются разными допустимыми значениями. Не сжимайте их автоматически в `,(0,c.jsx)(t.code,{children:`undefined`}),`, если contract этого не требует.`]}),`
+`,(0,c.jsx)(t.h2,{id:`abapboolean`,children:(0,c.jsx)(t.code,{children:`AbapBoolean`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type AbapBoolean = "X" | " ";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`ABAP-style boolean использует `,(0,c.jsx)(t.code,{children:`"X"`}),` для истины и строку из одного пробела для лжи. Это не JavaScript boolean:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`Boolean(" "); // true, потому что непустая строка.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для преобразования используйте boolean formatters, а не `,(0,c.jsx)(t.code,{children:`Boolean(value)`}),`.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`primitive-и-basetype`,children:[(0,c.jsx)(t.code,{children:`Primitive`}),` и `,(0,c.jsx)(t.code,{children:`BaseType`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Primitive = string | number | boolean | null | undefined;
+type BaseType = Date | Primitive;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`BaseType`}),` добавляет `,(0,c.jsx)(t.code,{children:`Date`}),` к primitive values. Тип `,(0,c.jsx)(t.code,{children:`number`}),` статически включает `,(0,c.jsx)(t.code,{children:`NaN`}),`/`,(0,c.jsx)(t.code,{children:`Infinity`}),`, но runtime guard их отклоняет.`]}),`
+`,(0,c.jsx)(t.h2,{id:`isbasetype`,children:(0,c.jsx)(t.code,{children:`isBaseType`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isBaseType("text"); // true.
+isBaseType(10); // true.
+isBaseType(false); // true.
+isBaseType(null); // true.
+isBaseType(undefined); // true.
+isBaseType(new Date()); // true.
+
+isBaseType(Number.NaN); // false.
+isBaseType(Infinity); // false.
+isBaseType(new Date("bad")); // false.
+isBaseType([]); // false.
+isBaseType({}); // false.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура является type guard:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function acceptUnknown(value: unknown) {
+	if (!isBaseType(value)) return;
+
+	// Здесь value имеет тип BaseType.
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Guard проверяет только форму базового значения, а не бизнес-ограничения строки/числа/даты.`}),`
+`,(0,c.jsxs)(t.h2,{id:`arraytype-objecttype-inputtype`,children:[(0,c.jsx)(t.code,{children:`ArrayType`}),`, `,(0,c.jsx)(t.code,{children:`ObjectType`}),`, `,(0,c.jsx)(t.code,{children:`InputType`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ArrayType = BaseType[];
+type ObjectType = Readonly<Record<string, BaseType>> | object;
+type InputType = BaseType | ArrayType | ObjectType;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ArrayType`}),` — изменяемый массив базовых значений.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ObjectType`}),` намеренно широкий: union с `,(0,c.jsx)(t.code,{children:`object`}),` допускает практически любой non-primitive object. Он не означает JSON-compatible record и не является runtime-проверкой.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`InputType`}),` объединяет базовые значения, массивы и objects для generic formatter/input contracts. Не используйте его вместо точного domain DTO.`]}),`
+`,(0,c.jsx)(t.h2,{id:`rangetype`,children:(0,c.jsx)(t.code,{children:`RangeType`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type RangeType = readonly [BaseType | null, BaseType | null];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Tuple всегда имеет две позиции:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const range: RangeType = [new Date(2026, 0, 1), null];
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`индекс `,(0,c.jsx)(t.code,{children:`0`}),` — начало;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`индекс `,(0,c.jsx)(t.code,{children:`1`}),` — конец;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` обычно означает открытую/незаполненную границу;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`readonly`}),` запрещает присваивание через TypeScript, но не вызывает `,(0,c.jsx)(t.code,{children:`Object.freeze`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поскольку `,(0,c.jsx)(t.code,{children:`BaseType`}),` уже включает `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),`, тип исторически широкий. Конкретный UI/domain contract должен задавать более точный `,(0,c.jsx)(t.code,{children:`readonly [T | null, T | null]`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`rowrecord`,children:(0,c.jsx)(t.code,{children:`RowRecord`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type RowRecord = Record<string, unknown>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это строка таблицы с неизвестными полями. Перед использованием значения его нужно сузить:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function readName(row: RowRecord): string | undefined {
+	return typeof row.name === "string" ? row.name : undefined;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если структура известна, объявляйте точный тип:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type EmployeeRow = {
+	id: string;
+	name: string;
+	salary: number;
+};
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-проектирования`,children:`Ошибки проектирования`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Использовать `,(0,c.jsx)(t.code,{children:`InputType`}),` как замену schema внешнего JSON.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`ObjectType`}),` plain object.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Приводить `,(0,c.jsx)(t.code,{children:`AbapBoolean`}),` через `,(0,c.jsx)(t.code,{children:`Boolean()`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`readonly`}),` runtime-заморозкой.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Использовать `,(0,c.jsx)(t.code,{children:`RowRecord`}),` там, где известны поля сущности.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`isBaseType`}),` проверкой диапазона, длины или разрешённых business values.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Нормализовать `,(0,c.jsx)(t.code,{children:`""`}),`, `,(0,c.jsx)(t.code,{children:`false`}),`, `,(0,c.jsx)(t.code,{children:`[]`}),` и `,(0,c.jsx)(t.code,{children:`null`}),` только из-за широкого общего типа.`]}),`
+`]})]})}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};