@ryuzaki13/react-foundation-ui 1.8.10 → 1.8.12

package/storybook-static/assets/README-Ss-3t1nX.js

@@ -0,0 +1,158 @@
+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`,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/Browser/Three Scene`}),`
+`,(0,c.jsx)(t.h1,{id:`three-scene`,children:`Three Scene`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/three-scene`}),` проверяет, можно ли безопасно показывать необязательную Three.js/WebGL-сцену, и помогает отключить её до конца браузерной сессии.`]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не импортирует Three.js, не создаёт renderer и не управляет canvas. Его задача — принять раннее решение: загружать тяжёлую 3D-сцену или показать облегчённую альтернативу.`}),`
+`,(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:`3D-фон страницы;`}),`
+`,(0,c.jsx)(t.li,{children:`визуализация, у которой есть обычная HTML-альтернатива;`}),`
+`,(0,c.jsx)(t.li,{children:`lazy import Three.js только на поддерживаемых устройствах;`}),`
+`,(0,c.jsx)(t.li,{children:`отключение повторных неудачных попыток WebGL в пределах вкладки.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для критически важного бизнес-сценария одной проверки поддержки недостаточно: renderer всё равно может завершиться ошибкой позже, например из-за потери контекста или нехватки памяти.`}),`
+`,(0,c.jsx)(t.h2,{id:`импорт`,children:`Импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	disableThreeSceneForSession,
+	isThreeSceneDisabledForSession,
+	isThreeSceneSupported,
+	threeSceneDefaultDisabledStorageKey,
+	useThreeSceneAvailability,
+	type ThreeSceneAvailability
+} from "@ryuzaki13/react-foundation-lib/three-scene";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для hook нужен React. Остальные функции работают напрямую с браузерными API.`}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт-с-react`,children:`Быстрый старт с React`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { lazy, Suspense } from "react";
+import { useThreeSceneAvailability } from "@ryuzaki13/react-foundation-lib/three-scene";
+
+const Scene = lazy(() => import("./Scene"));
+
+export function HeroVisual() {
+	const availability = useThreeSceneAvailability({
+		webGLVersion: "webgl2",
+		disableWhenReducedMotion: true
+	});
+
+	if (availability.status !== "available") {
+		return <img src="/hero.webp" alt="" />;
+	}
+
+	return (
+		<Suspense fallback={<img src="/hero.webp" alt="" />}>
+			<Scene />
+		</Suspense>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`На первом клиентском рендере hook тоже возвращает `,(0,c.jsx)(t.code,{children:`unavailable/ssr`}),`. Проверка происходит в effect после hydration. Это сохраняет одинаковую начальную HTML-разметку на сервере и клиенте.`]}),`
+`,(0,c.jsx)(t.h2,{id:`модель-состояния`,children:`Модель состояния`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ThreeSceneAvailabilityStatus = "pending" | "available" | "unavailable";
+
+type ThreeSceneUnavailableReason = "ssr" | "sessionDisabled" | "reducedMotion" | "webglUnsupported";
+
+type ThreeSceneAvailability = {
+	readonly status: ThreeSceneAvailabilityStatus;
+	readonly reason?: ThreeSceneUnavailableReason;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Текущий hook фактически возвращает `,(0,c.jsx)(t.code,{children:`available`}),` или `,(0,c.jsx)(t.code,{children:`unavailable`}),`; начальное состояние — `,(0,c.jsx)(t.code,{children:`unavailable`}),` с причиной `,(0,c.jsx)(t.code,{children:`ssr`}),`. Значение `,(0,c.jsx)(t.code,{children:`pending`}),` входит в общий тип, но hook сейчас его не устанавливает.`]}),`
+`,(0,c.jsx)(t.p,{children:`Причины:`}),`
+`,(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:`ssr`})}),(0,c.jsx)(t.td,{children:`Проверка ещё не выполнена в браузере либо код работает без DOM`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sessionDisabled`})}),(0,c.jsxs)(t.td,{children:[`Сцена отключена в `,(0,c.jsx)(t.code,{children:`sessionStorage`}),` текущей вкладки`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`reducedMotion`})}),(0,c.jsx)(t.td,{children:`Пользователь предпочитает уменьшенное движение, а соответствующая опция включена`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`webglUnsupported`})}),(0,c.jsx)(t.td,{children:`Не удалось создать требуемый WebGL-контекст`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`isthreescenesupportedoptions`,children:(0,c.jsx)(t.code,{children:`isThreeSceneSupported(options?)`})}),`
+`,(0,c.jsx)(t.p,{children:`Синхронно проверяет создание WebGL-контекста на временном canvas.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isThreeSceneSupported(); // проверяет только WebGL 2
+isThreeSceneSupported({ webGLVersion: "webgl2" });
+isThreeSceneSupported({ webGLVersion: "webgl" });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Доступны два режима:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`webgl2`}),` — принимает только контекст `,(0,c.jsx)(t.code,{children:`webgl2`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`webgl`}),` — пробует `,(0,c.jsx)(t.code,{children:`webgl2`}),`, затем `,(0,c.jsx)(t.code,{children:`webgl`}),` и `,(0,c.jsx)(t.code,{children:`experimental-webgl`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если контекст создан, функция по возможности вызывает расширение `,(0,c.jsx)(t.code,{children:`WEBGL_lose_context`}),`, чтобы освободить временный ресурс. При отсутствии `,(0,c.jsx)(t.code,{children:`document`}),`, ошибке браузера или невозможности создать контекст возвращается `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Положительный результат означает только базовую поддержку контекста. Он не гарантирует нужные extensions, производительность GPU, объём памяти или успешную загрузку конкретной сцены.`}),`
+`,(0,c.jsx)(t.h2,{id:`отключение-на-время-сессии`,children:`Отключение на время сессии`}),`
+`,(0,c.jsx)(t.h3,{id:`ключ-по-умолчанию`,children:`Ключ по умолчанию`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"threeSceneDefaultDisabledStorageKey;\n// `${__APP_ID__}:three-scene:disabled`\n"})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пакет ожидает, что сборка приложения определит compile-time константу `,(0,c.jsx)(t.code,{children:`__APP_ID__`}),`. Она отделяет данные разных приложений на одном origin.`]}),`
+`,(0,c.jsx)(t.h3,{id:`disablethreesceneforsessionstoragekey`,children:(0,c.jsx)(t.code,{children:`disableThreeSceneForSession(storageKey?)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Записывает строку `,(0,c.jsx)(t.code,{children:`"1"`}),` в `,(0,c.jsx)(t.code,{children:`sessionStorage`}),`. Функция ничего не делает на сервере и молча игнорирует ошибки хранилища.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`try {
+	await startScene();
+} catch (error) {
+	disableThreeSceneForSession();
+	showStaticFallback();
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`sessionStorage`}),` живёт в пределах вкладки. Новая вкладка или новая сессия получает новую попытку.`]}),`
+`,(0,c.jsx)(t.h3,{id:`isthreescenedisabledforsessionstoragekey`,children:(0,c.jsx)(t.code,{children:`isThreeSceneDisabledForSession(storageKey?)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`true`}),`, только если по ключу хранится точная строка `,(0,c.jsx)(t.code,{children:`"1"`}),`. На сервере возвращает `,(0,c.jsx)(t.code,{children:`true`}),`, чтобы сцена не пыталась стартовать без браузера. Если чтение storage бросает исключение, возвращается `,(0,c.jsx)(t.code,{children:`false`}),` — недоступность storage сама по себе не отключает WebGL.`]}),`
+`,(0,c.jsx)(t.h3,{id:`собственный-ключ`,children:`Собственный ключ`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const storageKey = "dashboard:analytics-scene:disabled";
+
+disableThreeSceneForSession(storageKey);
+isThreeSceneDisabledForSession(storageKey);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Одинаковый ключ нужно передавать и в hook.`}),`
+`,(0,c.jsx)(t.h2,{id:`usethreesceneavailabilityoptions`,children:(0,c.jsx)(t.code,{children:`useThreeSceneAvailability(options?)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type UseThreeSceneAvailabilityOptions = {
+	readonly disabledStorageKey?: string;
+	readonly disableWhenReducedMotion?: boolean;
+	readonly webGLVersion?: "webgl" | "webgl2";
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Значения по умолчанию:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`disabledStorageKey`}),` — `,(0,c.jsx)(t.code,{children:`threeSceneDefaultDisabledStorageKey`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`disableWhenReducedMotion`}),` — `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`webGLVersion`}),` — `,(0,c.jsx)(t.code,{children:`webgl2`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`После монтирования проверки выполняются в строгом порядке:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`включённая политика reduced motion;`}),`
+`,(0,c.jsx)(t.li,{children:`флаг отключения в sessionStorage;`}),`
+`,(0,c.jsx)(t.li,{children:`поддержка требуемого WebGL;`}),`
+`,(0,c.jsxs)(t.li,{children:[`состояние `,(0,c.jsx)(t.code,{children:`available`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если WebGL не поддержан, hook автоматически записывает session-флаг. Следующие проверки в этой вкладке сразу получат `,(0,c.jsx)(t.code,{children:`sessionDisabled`}),` и не будут повторно создавать пробный контекст.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Hook повторяет вычисление, если меняются options или результат media query `,(0,c.jsx)(t.code,{children:`prefers-reduced-motion`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`reduced-motion`,children:`Reduced motion`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const availability = useThreeSceneAvailability({
+	disableWhenReducedMotion: true
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При `,(0,c.jsx)(t.code,{children:`true`}),` сцена отключается для пользователя с настройкой `,(0,c.jsx)(t.code,{children:`prefers-reduced-motion: reduce`}),`. Сам session-флаг при этом не записывается: если пользователь изменит системную настройку, hook сможет пересчитать состояние.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если 3D-сцена не содержит значимого движения или имеет собственный облегчённый режим, приложение может оставить опцию `,(0,c.jsx)(t.code,{children:`false`}),` и применить reduced-motion внутри renderer.`]}),`
+`,(0,c.jsx)(t.h2,{id:`восстановление-после-ошибки`,children:`Восстановление после ошибки`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не экспортирует `,(0,c.jsx)(t.code,{children:`enableThreeSceneForSession`}),`. Чтобы дать пользователю кнопку «Попробовать снова», приложение может удалить тот же ключ и перезагрузить/перемонтировать проверку:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`window.sessionStorage.removeItem(threeSceneDefaultDisabledStorageKey);
+window.location.reload();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Удаление storage и reload — решение приложения, потому что повторный запуск тяжёлой сцены должен быть явным пользовательским действием.`}),`
+`,(0,c.jsx)(t.h2,{id:`рекомендуемая-граница-загрузки`,children:`Рекомендуемая граница загрузки`}),`
+`,(0,c.jsx)(t.p,{children:`Не импортируйте тяжёлую сцену до проверки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`// Хорошо: код сцены загружается отдельным chunk только при рендере Scene.
+const Scene = lazy(() => import("./Scene"));
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Статический `,(0,c.jsx)(t.code,{children:`import Scene from "./Scene"`}),` загрузит Three.js даже если компонент затем вернёт fallback.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`После `,(0,c.jsx)(t.code,{children:`available`}),` всё равно ставьте error boundary вокруг сцены. Runtime-ошибка renderer не меняет availability автоматически.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ssr-и-hydration`,children:`SSR и hydration`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`isThreeSceneSupported`}),` на сервере возвращает `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`isThreeSceneDisabledForSession`}),` на сервере возвращает `,(0,c.jsx)(t.code,{children:`true`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`hook начинает с детерминированного `,(0,c.jsx)(t.code,{children:`unavailable/ssr`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`фактическая проверка выполняется только в `,(0,c.jsx)(t.code,{children:`useEffect`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому сервер должен рендерить статический fallback. Не считайте начальную причину `,(0,c.jsx)(t.code,{children:`ssr`}),` окончательным отказом браузера.`]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`считать-webgl-проверку-benchmark`,children:`Считать WebGL-проверку benchmark`}),`
+`,(0,c.jsx)(t.p,{children:`Функция проверяет возможность создания контекста, но не измеряет FPS и не оценивает сложность сцены.`}),`
+`,(0,c.jsx)(t.h3,{id:`запускать-сцену-во-время-ssr`,children:`Запускать сцену во время SSR`}),`
+`,(0,c.jsxs)(t.p,{children:[`Canvas, sessionStorage и WebGL — browser-only API. Загружайте и запускайте renderer после `,(0,c.jsx)(t.code,{children:`availability.status === "available"`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`не-определить-__app_id__`,children:[`Не определить `,(0,c.jsx)(t.code,{children:`__APP_ID__`})]}),`
+`,(0,c.jsx)(t.p,{children:`Значение участвует в ключе storage на этапе выполнения собранного кода. Сборщик потребителя должен заменить эту compile-time константу.`}),`
+`,(0,c.jsx)(t.h3,{id:`ожидать-автоматического-отключения-при-любой-runtime-ошибке`,children:`Ожидать автоматического отключения при любой runtime-ошибке`}),`
+`,(0,c.jsx)(t.p,{children:`Автоматический session-флаг ставится только при неуспешной первоначальной проверке WebGL. Ошибки загрузки ассетов и renderer приложение обрабатывает самостоятельно.`}),`
+`,(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:`isThreeSceneSupported()`})}),(0,c.jsx)(t.td,{children:`Проверить возможность создать WebGL-контекст`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`disableThreeSceneForSession()`})}),(0,c.jsx)(t.td,{children:`Отключить сцену до конца сессии вкладки`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isThreeSceneDisabledForSession()`})}),(0,c.jsx)(t.td,{children:`Прочитать session-флаг`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`threeSceneDefaultDisabledStorageKey`})}),(0,c.jsx)(t.td,{children:`Ключ storage с namespace приложения`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useThreeSceneAvailability()`})}),(0,c.jsx)(t.td,{children:`Объединить WebGL, session и reduced-motion проверки в React`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ThreeSceneAvailability`})}),(0,c.jsx)(t.td,{children:`Тип результата availability`})]})]})]})]})}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-eHCINzP3.js

@@ -0,0 +1,154 @@
+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`,blockquote:`blockquote`,code:`code`,h1:`h1`,h2:`h2`,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/Validation/Runtime Guards`}),`
+`,(0,c.jsxs)(t.h1,{id:`runtime-guards-и-validators-через-ryuzaki13react-foundation-libvalidators`,children:[`Runtime guards и validators через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/validators`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль содержит небольшие проверки для `,(0,c.jsx)(t.code,{children:`unknown`}),`, object-like значений, image extensions, positive integer, URL и Floating UI DOM reference.`]}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[`Название функции не расширяет её контракт. Например, `,(0,c.jsx)(t.code,{children:`isSafe`}),` проверяет только отсутствие `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),`, а `,(0,c.jsx)(t.code,{children:`isRecord`}),` допускает `,(0,c.jsx)(t.code,{children:`Date`}),` и `,(0,c.jsx)(t.code,{children:`Map`}),`. Ниже указано точное поведение каждой проверки.`]}),`
+`]}),`
+`,(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:`#%D0%BA%D0%B0%D0%BA-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%D1%8E%D1%82-type-guards`,children:`Как работают type guards`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#issafe`,children:(0,c.jsx)(t.code,{children:`isSafe`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#isobject-isrecord-asrecord`,children:[(0,c.jsx)(t.code,{children:`isObject`}),`, `,(0,c.jsx)(t.code,{children:`isRecord`}),`, `,(0,c.jsx)(t.code,{children:`asRecord`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#isplainobject`,children:(0,c.jsx)(t.code,{children:`isPlainObject`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#readpositiveinteger`,children:(0,c.jsx)(t.code,{children:`readPositiveInteger`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#image-extensions`,children:`Image extensions`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#isdomreference`,children:(0,c.jsx)(t.code,{children:`isDomReference`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#validateurl`,children:(0,c.jsx)(t.code,{children:`validateUrl`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#security-boundary`,children:`Security boundary`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9-api`,children:`Полный API`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	asRecord,
+	IMAGE_EXTENSIONS,
+	isDomReference,
+	isImageExtension,
+	isObject,
+	isPlainObject,
+	isRecord,
+	isSafe,
+	readPositiveInteger,
+	validateUrl
+} from "@ryuzaki13/react-foundation-lib/validators";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`isDomReference`}),` использует type из `,(0,c.jsx)(t.code,{children:`@floating-ui/react`}),`; host entrypoint должен разрешить совместимую peer dependency. Остальные функции не требуют React.`]}),`
+`,(0,c.jsx)(t.h2,{id:`как-работают-type-guards`,children:`Как работают type guards`}),`
+`,(0,c.jsx)(t.p,{children:`Type guard возвращает boolean и помогает TypeScript сузить значение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function readCode(value: unknown): string | undefined {
+	if (!isRecord(value)) return undefined;
+	return typeof value.code === "string" ? value.code : undefined;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Guard не преобразует значение и не гарантирует поля, которые сам не проверил.`}),`
+`,(0,c.jsx)(t.h2,{id:`issafe`,children:(0,c.jsx)(t.code,{children:`isSafe`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function isSafe<T>(value: T | null | undefined): value is T;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`false`}),` только для `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[0, "", false, null, undefined, "ok"].filter(isSafe);
+// [0, "", false, "ok"].
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`0`}),`, пустая строка и `,(0,c.jsx)(t.code,{children:`false`}),` являются безопасными в смысле этой функции. `,(0,c.jsx)(t.code,{children:`isSafe`}),` не проверяет XSS, SQL, URL, число, object schema или authorization.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`isobject-isrecord-asrecord`,children:[(0,c.jsx)(t.code,{children:`isObject`}),`, `,(0,c.jsx)(t.code,{children:`isRecord`}),`, `,(0,c.jsx)(t.code,{children:`asRecord`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Три функции используют одинаковую базовую проверку: значение truthy, `,(0,c.jsx)(t.code,{children:`typeof === "object"`}),`, не array.`]}),`
+`,(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.jsxs)(t.th,{style:{textAlign:`center`},children:[(0,c.jsx)(t.code,{children:`isObject`}),` / `,(0,c.jsx)(t.code,{children:`isRecord`})]}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`asRecord`})})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{}`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:(0,c.jsx)(t.code,{children:`true`})}),(0,c.jsx)(t.td,{children:`тот же object`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`new Date()`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:(0,c.jsx)(t.code,{children:`true`})}),(0,c.jsx)(t.td,{children:`тот же Date, типизированный как record`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`new Map()`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:(0,c.jsx)(t.code,{children:`true`})}),(0,c.jsx)(t.td,{children:`тот же Map`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`DOM element`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:(0,c.jsx)(t.code,{children:`true`})}),(0,c.jsx)(t.td,{children:`тот же element`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`[]`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:(0,c.jsx)(t.code,{children:`false`})}),(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:`null`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:(0,c.jsx)(t.code,{children:`false`})}),(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:`function`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:(0,c.jsx)(t.code,{children:`false`})}),(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:`isObject`}),` сужает до `,(0,c.jsx)(t.code,{children:`object`}),`, `,(0,c.jsx)(t.code,{children:`isRecord`}),` — до `,(0,c.jsx)(t.code,{children:`Record<string, unknown>`}),`, `,(0,c.jsx)(t.code,{children:`asRecord`}),` возвращает record или `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Они не проверяют plain object и не гарантируют JSON-compatible данные.`}),`
+`,(0,c.jsx)(t.h2,{id:`isplainobject`,children:(0,c.jsx)(t.code,{children:`isPlainObject`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`true`}),`, только если prototype равен `,(0,c.jsx)(t.code,{children:`Object.prototype`}),` или `,(0,c.jsx)(t.code,{children:`null`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isPlainObject({}); // true.
+isPlainObject(Object.create(null)); // true.
+isPlainObject(new Date()); // false.
+isPlainObject(new Map()); // false.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сигнатура принимает `,(0,c.jsx)(t.code,{children:`object`}),`, поэтому сначала сузьте `,(0,c.jsx)(t.code,{children:`unknown`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`if (isObject(value) && isPlainObject(value)) {
+	// Plain record-like object.
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Прямой runtime-вызов `,(0,c.jsx)(t.code,{children:`isPlainObject(null as never)`}),` приведёт к ошибке `,(0,c.jsx)(t.code,{children:`Object.getPrototypeOf`}),`. TypeScript contract запрещает такой аргумент.`]}),`
+`,(0,c.jsx)(t.h2,{id:`readpositiveinteger`,children:(0,c.jsx)(t.code,{children:`readPositiveInteger`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`readPositiveInteger(12); // 12.
+readPositiveInteger("12"); // 12.
+readPositiveInteger(" 12 "); // 12.
+readPositiveInteger(0); // undefined.
+readPositiveInteger(-1); // undefined.
+readPositiveInteger(1.5); // undefined.
+readPositiveInteger("bad"); // undefined.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`String преобразуется стандартным `,(0,c.jsx)(t.code,{children:`Number(value)`}),`, затем проверяются:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`runtime type number;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Number.isInteger`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`значение строго больше `,(0,c.jsx)(t.code,{children:`0`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Следствия стандартного `,(0,c.jsx)(t.code,{children:`Number`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`readPositiveInteger("1e2"); // 100.
+readPositiveInteger("0x10"); // 16.
+readPositiveInteger(""); // undefined, потому что Number("") = 0.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если формат input должен быть только decimal digits, дополнительно проверьте строковую грамматику на своей boundary.`}),`
+`,(0,c.jsx)(t.h2,{id:`image-extensions`,children:`Image extensions`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isImageExtension("PNG"); // true.
+isImageExtension("svg"); // true.
+isImageExtension("pdf"); // false.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Список:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`["png", "jpg", "jpeg", "gif", "webp", "svg"];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверка регистронезависима через `,(0,c.jsx)(t.code,{children:`toLowerCase`}),`, но не делает trim и ожидает расширение без точки:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isImageExtension(".png"); // false.
+isImageExtension(" png "); // false.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`IMAGE_EXTENSIONS`}),` экспортирован как изменяемый array по текущему типу. Рассматривайте его как библиотечную константу и не вызывайте `,(0,c.jsx)(t.code,{children:`push/splice`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Расширение имени не доказывает MIME/type и безопасность содержимого. Для file/image boundary используйте `,(0,c.jsx)(t.code,{children:`/file`}),` и server-side validation.`]}),`
+`,(0,c.jsx)(t.h2,{id:`isdomreference`,children:(0,c.jsx)(t.code,{children:`isDomReference`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`if (isDomReference(floatingReference)) {
+	floatingReference.focus();
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`true`}),`, только если reference является browser `,(0,c.jsx)(t.code,{children:`Element`}),`. Virtual element Floating UI и `,(0,c.jsx)(t.code,{children:`null`}),` возвращают `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция выполняет `,(0,c.jsx)(t.code,{children:`ref instanceof Element`}),`. В server runtime без global `,(0,c.jsx)(t.code,{children:`Element`}),` её вызов может привести к `,(0,c.jsx)(t.code,{children:`ReferenceError`}),`; вызывайте только в browser boundary или после проверки DOM environment.`]}),`
+`,(0,c.jsx)(t.h2,{id:`validateurl`,children:(0,c.jsx)(t.code,{children:`validateUrl`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = validateUrl("https://example.com/path");
+
+if (!result.isValid) {
+	showError(result.error);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Возможные результаты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{ isValid: true, error: "" }
+{ isValid: false, error: "URL не может быть пустым" }
+{ isValid: false, error: "URL слишком длинный" }
+{ isValid: false, error: "URL содержит недопустимые символы" }
+{ isValid: false, error: "Некорректный формат URL" }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Отклоняет пустую строку.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Если строка не начинается с lowercase `,(0,c.jsx)(t.code,{children:`http`}),`, временно добавляет `,(0,c.jsx)(t.code,{children:`https://`}),` для `,(0,c.jsx)(t.code,{children:`new URL`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Проверяет длину исходной строки не больше `,(0,c.jsx)(t.code,{children:`2048`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Применяет консервативное регулярное выражение.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Поддерживаемая грамматика намеренно узкая:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`optional `,(0,c.jsx)(t.code,{children:`http://`}),` или `,(0,c.jsx)(t.code,{children:`https://`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`domain с точкой;`}),`
+`,(0,c.jsx)(t.li,{children:`lowercase TLD длиной 2–6 по regex;`}),`
+`,(0,c.jsx)(t.li,{children:`простой path из ограниченного набора символов.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Query string, hash, port, localhost, IP-адреса, internationalized domains, многие валидные Unicode/path characters и длинные современные TLD могут быть отклонены.`}),`
+`,(0,c.jsx)(t.h2,{id:`security-boundary`,children:`Security boundary`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`validateUrl`}),` — UI-проверка формата, не security policy. Она не:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`проверяет allowlist host/protocol;`}),`
+`,(0,c.jsx)(t.li,{children:`делает DNS resolution;`}),`
+`,(0,c.jsx)(t.li,{children:`защищает backend от SSRF;`}),`
+`,(0,c.jsx)(t.li,{children:`гарантирует отсутствие redirect на опасный host;`}),`
+`,(0,c.jsx)(t.li,{children:`проверяет доступность ресурса;`}),`
+`,(0,c.jsx)(t.li,{children:`санитизирует HTML;`}),`
+`,(0,c.jsx)(t.li,{children:`подтверждает, что URL ведёт на изображение.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для внешней навигации/запроса применяйте отдельную security policy владельца boundary.`}),`
+`,(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:`isSafe`})}),(0,c.jsxs)(t.td,{children:[`Исключает `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isObject`})}),(0,c.jsx)(t.td,{children:`Non-array truthy object`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isRecord`})}),(0,c.jsx)(t.td,{children:`Та же runtime-проверка с record type`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`asRecord`})}),(0,c.jsxs)(t.td,{children:[`Record или `,(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:`isPlainObject`})}),(0,c.jsx)(t.td,{children:`Проверяет prototype`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readPositiveInteger`})}),(0,c.jsxs)(t.td,{children:[`Positive integer number или `,(0,c.jsx)(t.code,{children:`undefined`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`IMAGE_EXTENSIONS`})}),(0,c.jsx)(t.td,{children:`Список поддерживаемых extensions`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isImageExtension`})}),(0,c.jsx)(t.td,{children:`Регистронезависимая проверка extension`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isDomReference`})}),(0,c.jsxs)(t.td,{children:[`Floating reference является `,(0,c.jsx)(t.code,{children:`Element`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`validateUrl`})}),(0,c.jsx)(t.td,{children:`Консервативный UI URL result`})]})]})]})]})}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-qHKxXU95.js

@@ -0,0 +1,98 @@
+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`,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/Data/XML`}),`
+`,(0,c.jsxs)(t.h1,{id:`простые-xml-helpers-через-ryuzaki13react-foundation-libxml`,children:[`Простые XML helpers через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/xml`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль экранирует XML-текст, строит последовательность простых полей и читает текст первого тега через `,(0,c.jsx)(t.code,{children:`DOMParser`}),`.`]}),`
+`,(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-%D0%B8-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B`,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:`#escapexmlvalue`,children:(0,c.jsx)(t.code,{children:`escapeXmlValue`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#buildxmlfields`,children:(0,c.jsx)(t.code,{children:`buildXmlFields`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#getxmltagtext`,children:(0,c.jsx)(t.code,{children:`getXmlTagText`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C-%D0%B8-%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F`,children:`Безопасность и ограничения`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#api`,children:`API`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы`,children:`Назначение и границы`}),`
+`,(0,c.jsx)(t.p,{children:`Подходит для небольших flat XML fragments:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-xml`,children:`<ORDER_ID>42</ORDER_ID><COMMENT>A&amp;B</COMMENT>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не является полноценным XML builder/parser:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не строит document/envelope;`}),`
+`,(0,c.jsx)(t.li,{children:`не управляет namespaces и attributes;`}),`
+`,(0,c.jsx)(t.li,{children:`не валидирует XSD;`}),`
+`,(0,c.jsx)(t.li,{children:`не обрабатывает коллекции/вложенные объекты;`}),`
+`,(0,c.jsx)(t.li,{children:`не проверяет parser errors;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняет network request.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { buildXmlFields, escapeXmlValue, getXmlTagText } from "@ryuzaki13/react-foundation-lib/xml";
+
+import type { XmlPrimitive } from "@ryuzaki13/react-foundation-lib/xml";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Builder-функции не требуют DOM. `,(0,c.jsx)(t.code,{children:`getXmlTagText`}),` требует global `,(0,c.jsx)(t.code,{children:`DOMParser`}),`, доступный в браузере/jsdom, но обычно отсутствующий в чистом Node.js.`]}),`
+`,(0,c.jsx)(t.h2,{id:`escapexmlvalue`,children:(0,c.jsx)(t.code,{children:`escapeXmlValue`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`escapeXmlValue(\`a&b<c>d"e'f\`);
+// "a&amp;b&lt;c&gt;d&quot;e&apos;f"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Тип входа:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type XmlPrimitive = string | number | null | undefined;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила:`}),`
+`,(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:`XML entity`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`&`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`&amp;`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`<`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`&lt;`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`>`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`&gt;`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`&quot;`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`'`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`&apos;`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` превращаются в пустую строку. Number сначала преобразуется через `,(0,c.jsx)(t.code,{children:`String`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Функция предназначена для текстового содержимого. Для attribute value она экранирует основные символы, но сам attribute builder модуль не предоставляет.`}),`
+`,(0,c.jsx)(t.p,{children:`Не передавайте уже экранированную строку повторно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`escapeXmlValue("A&amp;B"); // "A&amp;amp;B".
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`buildxmlfields`,children:(0,c.jsx)(t.code,{children:`buildXmlFields`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const xml = buildXmlFields({
+	ORDER_ID: 42,
+	COMMENT: "A&B",
+	OPTIONAL: null
+});
+
+// <ORDER_ID>42</ORDER_ID><COMMENT>A&amp;B</COMMENT><OPTIONAL></OPTIONAL>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`обходит `,(0,c.jsx)(t.code,{children:`Object.entries`}),` в стандартном порядке ключей;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`строит для каждого поля `,(0,c.jsx)(t.code,{children:`<NAME>escaped value</NAME>`}),`;`]}),`
+`,(0,c.jsx)(t.li,{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.li,{children:`не изменяет исходный объект.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Имя тега вставляется без валидации и escaping. Ключи должны быть доверенными валидными XML names из программного contract:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Нельзя строить key из пользовательского ввода.
+buildXmlFields({ [userProvidedTagName]: value });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для вложенной структуры передайте уже собранный fragment как часть внешнего builder-а; `,(0,c.jsx)(t.code,{children:`buildXmlFields`}),` сам воспринимает строку как текст и экранирует markup.`]}),`
+`,(0,c.jsx)(t.h2,{id:`getxmltagtext`,children:(0,c.jsx)(t.code,{children:`getXmlTagText`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const message = getXmlTagText("<root><EX_MESSAGE>  Ошибка  </EX_MESSAGE></root>", "EX_MESSAGE");
+
+console.log(message); // "Ошибка".
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Парсит всю строку как `,(0,c.jsx)(t.code,{children:`application/xml`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Вызывает `,(0,c.jsx)(t.code,{children:`getElementsByTagName(tagName)`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Берёт только первый найденный element.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Читает объединённый `,(0,c.jsx)(t.code,{children:`textContent`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Обрезает пробелы.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, если элемента/непустого текста нет.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getXmlTagText("<root />", "MESSAGE"); // undefined.
+getXmlTagText("<root><MESSAGE>   </MESSAGE></root>", "MESSAGE"); // undefined.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для namespace-sensitive XML точное поведение `,(0,c.jsx)(t.code,{children:`getElementsByTagName`}),` зависит от переданного имени. Модуль не предоставляет `,(0,c.jsx)(t.code,{children:`getElementsByTagNameNS`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`безопасность-и-ограничения`,children:`Безопасность и ограничения`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Не вставляйте результат XML в HTML DOM через `,(0,c.jsx)(t.code,{children:`innerHTML`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не используйте dynamic tag names из недоверенного ввода.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Parser не проверяется на `,(0,c.jsx)(t.code,{children:`<parsererror>`}),`; malformed XML обычно даёт `,(0,c.jsx)(t.code,{children:`undefined`}),` или parser-specific tree, а не явное исключение этого helper.`]}),`
+`,(0,c.jsx)(t.li,{children:`Читается только первое совпадение.`}),`
+`,(0,c.jsx)(t.li,{children:`Большие documents лучше разбирать специализированным parser/streaming boundary.`}),`
+`,(0,c.jsx)(t.li,{children:`Модуль не предотвращает XML signature wrapping и не предназначен для security validation.`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`XmlPrimitive`}),` number допускает `,(0,c.jsx)(t.code,{children:`NaN`}),`/`,(0,c.jsx)(t.code,{children:`Infinity`}),` на уровне TypeScript; они станут строками `,(0,c.jsx)(t.code,{children:`"NaN"`}),`/`,(0,c.jsx)(t.code,{children:`"Infinity"`}),`.`]}),`
+`]}),`
+`,(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:`escapeXmlValue`})}),(0,c.jsx)(t.td,{children:`Экранированная строка`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildXmlFields`})}),(0,c.jsx)(t.td,{children:`Компактный XML fragment`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getXmlTagText`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string | undefined`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`XmlPrimitive`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string | number | null | undefined`})})]})]})]})]})}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-tm9QH9cF.js

@@ -0,0 +1,103 @@
+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`,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 API/Errors/Error Report Delivery`}),`
+`,(0,c.jsxs)(t.h1,{id:`доставка-error-reports-через-ryuzaki13react-foundation-apierror-report`,children:[`Доставка error reports через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/error-report`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль превращает сохранённый черновик отчёта из `,(0,c.jsx)(t.code,{children:`foundation-lib`}),` в delivery body, вызывает adapter приложения и обновляет статус черновика.`]}),`
+`,(0,c.jsx)(t.h2,{id:`граница-ответственности`,children:`Граница ответственности`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`foundation-lib/error-report        foundation-api/error-report       host backend adapter
+collect + sanitize + draft store ──► lifecycle + delivery body ─────► HTTP/OData/serverFn
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не собирает browser diagnostics, не выбирает endpoint и не отправляет запрос самостоятельно. Transport явно передаёт приложение через `,(0,c.jsx)(t.code,{children:`adapter`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	createErrorReportDeliveryBody,
+	sendErrorReport
+} from "@ryuzaki13/react-foundation-api/error-report";
+
+import type {
+	ErrorReportDeliveryAdapter,
+	ErrorReportDeliveryBody,
+	ErrorReportDeliveryContext,
+	SendErrorReportOptions
+} from "@ryuzaki13/react-foundation-api/error-report";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Нужны `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib`}),` и `,(0,c.jsx)(t.code,{children:`@tanstack/react-query`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`полный-сценарий`,children:`Полный сценарий`}),`
+`,(0,c.jsxs)(t.p,{children:[`Сначала другой слой создаёт и сохраняет draft средствами `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/error-report`}),`. Затем API-слой получает только его `,(0,c.jsx)(t.code,{children:`reportId`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { httpFetchPayload } from "@ryuzaki13/react-foundation-api/http";
+import { sendErrorReport } from "@ryuzaki13/react-foundation-api/error-report";
+import type { ErrorReportDeliveryAdapter } from "@ryuzaki13/react-foundation-api/error-report";
+
+const deliveryAdapter: ErrorReportDeliveryAdapter = async (body) => {
+	await httpFetchPayload("/api/error-reports", {
+		init: {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(body)
+		}
+	});
+};
+
+await sendErrorReport(reportId, {
+	adapter: deliveryAdapter,
+	queryClient
+});
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`createerrorreportdeliverybody`,children:(0,c.jsx)(t.code,{children:`createErrorReportDeliveryBody`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const body = createErrorReportDeliveryBody(draft);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ErrorReportDeliveryBody = {
+	reportId: string;
+	sessionId: string;
+	createdUtc: string;
+	category: ErrorReportCategory;
+	errorClass: string;
+	errorMessage: string;
+	stackTrace?: string;
+	payload: string;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`payload`}),` — JSON string всего payload черновика, а не вложенный object. Это важно для backend contract.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`draft.payload.error.message`}),` пуст, обязательные `,(0,c.jsx)(t.code,{children:`errorMessage`}),` и message внутри сериализованного payload получают значение `,(0,c.jsx)(t.code,{children:`"Неизвестная ошибка"`}),`. Остальной draft не нормализуется.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`JSON.stringify`}),` может выбросить ошибку при циклических или неподдерживаемых данных. Draft должен соответствовать сериализуемому контракту `,(0,c.jsx)(t.code,{children:`foundation-lib`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`senderrorreport`,children:(0,c.jsx)(t.code,{children:`sendErrorReport`})}),`
+`,(0,c.jsx)(t.p,{children:`Lifecycle:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`draft отсутствует ─────────► undefined
+status sent/sending ───────► текущий draft, adapter не вызывается
+остальной draft ───────────► sending
+                               │
+                    adapter success / error
+                       │              │
+                       ▼              ▼
+                     sent           failed + failedReason
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пошагово функция:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Ищет draft по `,(0,c.jsx)(t.code,{children:`reportId`}),` в store из `,(0,c.jsx)(t.code,{children:`foundation-lib`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, если draft не найден.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Не отправляет повторно draft со статусом `,(0,c.jsx)(t.code,{children:`sent`}),` или `,(0,c.jsx)(t.code,{children:`sending`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Устанавливает `,(0,c.jsx)(t.code,{children:`status: "sending"`}),` и очищает `,(0,c.jsx)(t.code,{children:`failedReason`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Создаёт delivery body.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Вызывает `,(0,c.jsx)(t.code,{children:`adapter(body, { draft, queryClient })`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`При успехе устанавливает `,(0,c.jsx)(t.code,{children:`status: "sent"`}),` и `,(0,c.jsx)(t.code,{children:`sentUtc`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`При ошибке устанавливает `,(0,c.jsx)(t.code,{children:`status: "failed"`}),`, сохраняет нормализованное сообщение и повторно бросает исходную ошибку.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Adapter получает исходный snapshot `,(0,c.jsx)(t.code,{children:`draft`}),`, прочитанный до перевода store в `,(0,c.jsx)(t.code,{children:`sending`}),`. Используйте `,(0,c.jsx)(t.code,{children:`body`}),` как delivery payload, а context — для query invalidation или transport, которому нужен `,(0,c.jsx)(t.code,{children:`QueryClient`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`adapter-с-cache-invalidation`,children:`Adapter с cache invalidation`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const adapter: ErrorReportDeliveryAdapter = async (body, { queryClient }) => {
+	await postReport(body);
+	await queryClient.invalidateQueries({ queryKey: ["error-reports"] });
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если invalidation бросит ошибку, вся доставка считается неуспешной и draft станет `,(0,c.jsx)(t.code,{children:`failed`}),`, даже если backend уже принял отчёт. Для non-critical cache update обработайте ошибку внутри adapter-а.`]}),`
+`,(0,c.jsx)(t.h2,{id:`повторная-отправка-и-concurrency`,children:`Повторная отправка и concurrency`}),`
+`,(0,c.jsxs)(t.p,{children:[`После `,(0,c.jsx)(t.code,{children:`failed`}),` функцию можно вызвать повторно. Проверка `,(0,c.jsx)(t.code,{children:`sending`}),` защищает от обычного повторного нажатия, но это не распределённая блокировка: два практически одновременных вызова могут успеть прочитать старый статус до его обновления. Backend желательно сделать идемпотентным по `,(0,c.jsx)(t.code,{children:`reportId`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-и-безопасность`,children:`Ошибки и безопасность`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Ошибка adapter-а не поглощается: вызывающий код обязан её обработать.`}),`
+`,(0,c.jsx)(t.li,{children:`Не добавляйте secrets в draft. Delivery layer не выполняет дополнительную redaction всего payload.`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`queryClient`}),` передаётся adapter-у, но модуль сам не инвалидирует queries.`]}),`
+`,(0,c.jsx)(t.li,{children:`Функция управляет локальным draft store; не вызывайте её в среде без подходящего storage/runtime, если draft store там недоступен.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Статус `,(0,c.jsx)(t.code,{children:`sent`}),` означает успешное завершение adapter-а, а не обязательное подтверждение бизнес-обработки backend-ом.`]}),`
+`]}),`
+`,(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:`createErrorReportDeliveryBody`})}),(0,c.jsx)(t.td,{children:`Строит сериализуемый backend body`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sendErrorReport`})}),(0,c.jsx)(t.td,{children:`Управляет status и вызывает adapter`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ErrorReportDeliveryBody`})}),(0,c.jsx)(t.td,{children:`Поля delivery payload`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ErrorReportDeliveryContext`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`draft`}),` и `,(0,c.jsx)(t.code,{children:`queryClient`}),` для adapter-а`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ErrorReportDeliveryAdapter`})}),(0,c.jsx)(t.td,{children:`Контракт функции доставки`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SendErrorReportOptions`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`adapter`}),` и `,(0,c.jsx)(t.code,{children:`queryClient`})]})]})]})]})]})}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};