@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.12

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

@@ -0,0 +1,64 @@
+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 Lib/Errors/Missing Context`}),`
+`,(0,c.jsxs)(t.h1,{id:`ошибка-отсутствующего-react-context-через-ryuzaki13react-foundation-liberror`,children:[`Ошибка отсутствующего React context через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/error`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль создаёт единообразное диагностическое сообщение, когда custom hook вызван вне нужного Provider.`}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createMissingContextError, createMissingContextErrorMessage } from "@ryuzaki13/react-foundation-lib/error";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не импортирует React и может использоваться в любом TypeScript runtime. Типы объектов options выводятся из аргумента и отдельно не экспортируются.`}),`
+`,(0,c.jsx)(t.h2,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsx)(t.p,{children:`Обычная схема context hook:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const DemoContext = createContext<DemoValue | null>(null);
+
+export function useDemo() {
+	const value = useContext(DemoContext);
+
+	if (value === null) {
+		throw createMissingContextError({
+			hookName: "useDemo",
+			providerName: "DemoProvider",
+			contextName: "DemoContext"
+		});
+	}
+
+	return value;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ошибка должна выбрасываться при нарушении обязательного structural contract. Если отсутствие Provider является допустимым состоянием, возвращайте optional result по собственному явно названному API.`}),`
+`,(0,c.jsx)(t.h2,{id:`createmissingcontexterrormessage`,children:(0,c.jsx)(t.code,{children:`createMissingContextErrorMessage`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const message = createMissingContextErrorMessage({
+	hookName: "useDemo",
+	providerName: "DemoProvider",
+	contextName: "DemoContext"
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат состоит из трёх предложений:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`Где разрешено использовать hook.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Какой context оказался `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Что Provider должен находиться выше вызывающего компонента.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`contextName`}),` optional. Без него сообщение остаётся корректным, но менее конкретным.`]}),`
+`,(0,c.jsx)(t.p,{children:`Поля вставляются буквально: функция не добавляет backticks, не проверяет имена и не локализует их.`}),`
+`,(0,c.jsx)(t.h2,{id:`createmissingcontexterror`,children:(0,c.jsx)(t.code,{children:`createMissingContextError`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает обычный `,(0,c.jsx)(t.code,{children:`Error`}),` с тем же сообщением:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const error = createMissingContextError({
+	hookName: "useDemo",
+	providerName: "DemoProvider"
+});
+
+console.log(error.name); // "Error".
+console.log(error.message); // Подробное русское сообщение.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция сама не делает `,(0,c.jsx)(t.code,{children:`throw`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`throw createMissingContextError(options);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Stack trace создаётся стандартным конструктором `,(0,c.jsx)(t.code,{children:`Error`}),` в месте вызова.`]}),`
+`,(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:`createMissingContextErrorMessage`})}),(0,c.jsx)(t.td,{children:`Возвращает только строку`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createMissingContextError`})}),(0,c.jsxs)(t.td,{children:[`Возвращает экземпляр `,(0,c.jsx)(t.code,{children:`Error`})]})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`типичные-ошибки`,children:`Типичные ошибки`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Возвращать fallback-object после ошибки и скрывать неправильное дерево Provider.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Выбрасывать ошибку прямо в Provider вместо hook, который обнаружил `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Передавать пустые имена: helper не валидирует строки.`}),`
+`,(0,c.jsx)(t.li,{children:`Использовать этот модуль для сетевых/validation ошибок: он предназначен только для missing context contract.`}),`
+`]})]})}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-CAGQnLsv.js

@@ -0,0 +1,90 @@
+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`,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/HTTP/Headers and Text Response`}),`
+`,(0,c.jsxs)(t.h1,{id:`http-headers-и-текстовые-ответы-через-ryuzaki13react-foundation-libhttp`,children:[`HTTP headers и текстовые ответы через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/http`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль создаёт стандартный набор HTTP-заголовков запрета кеширования и обычный `,(0,c.jsx)(t.code,{children:`Response`}),` с UTF-8 plain text.`]}),`
+`,(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:`#createnostoreheaders`,children:(0,c.jsx)(t.code,{children:`createNoStoreHeaders`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#createtexthttpresponse`,children:(0,c.jsx)(t.code,{children:`createTextHttpResponse`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#runtime-%D0%B8-%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C`,children:`Runtime и безопасность`})}),`
+`,(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.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`HeadersInit + text + status
+             │
+             ▼
+Headers с no-store + Response(text/plain; charset=UTF-8)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не выполняет `,(0,c.jsx)(t.code,{children:`fetch`}),`, не сериализует JSON, не задаёт CORS, CSP, cookies или authorization и не превращает ошибки transport в response автоматически.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createNoStoreHeaders, createTextHttpResponse } from "@ryuzaki13/react-foundation-lib/http";
+
+import type { NoStoreHeadersInit, TextHttpResponseOptions } from "@ryuzaki13/react-foundation-lib/http";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Нужны стандартные Web API `,(0,c.jsx)(t.code,{children:`Headers`}),` и `,(0,c.jsx)(t.code,{children:`Response`}),`. Они есть в браузерах, Service Worker и современных server runtimes, но могут отсутствовать в старом Node.js без polyfill.`]}),`
+`,(0,c.jsx)(t.h2,{id:`createnostoreheaders`,children:(0,c.jsx)(t.code,{children:`createNoStoreHeaders`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const headers = createNoStoreHeaders({
+	"X-Request-Id": "request-1"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция создаёт новый `,(0,c.jsx)(t.code,{children:`Headers`}),` и устанавливает:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Cache-Control: no-store, no-cache, must-revalidate, proxy-revalidate
+Pragma: no-cache
+Expires: 0
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поддерживаются все стандартные формы `,(0,c.jsx)(t.code,{children:`HeadersInit`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createNoStoreHeaders();
+createNoStoreHeaders(new Headers({ "X-Test": "1" }));
+createNoStoreHeaders({ "X-Test": "1" });
+createNoStoreHeaders([["X-Test", "1"]]);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Исходный `,(0,c.jsx)(t.code,{children:`Headers`}),` не изменяется: constructor создаёт новую коллекцию.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`init`}),` уже содержит `,(0,c.jsx)(t.code,{children:`Cache-Control`}),`, `,(0,c.jsx)(t.code,{children:`Pragma`}),` или `,(0,c.jsx)(t.code,{children:`Expires`}),`, библиотечное значение перезаписывает его.`]}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`no-store`}),` — инструкция кешам, а не гарантия уничтожения уже сохранённых данных. Не помещайте секреты в response только потому, что добавлены эти headers.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`createtexthttpresponse`,children:(0,c.jsx)(t.code,{children:`createTextHttpResponse`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const response = createTextHttpResponse({
+	status: 400,
+	text: "Некорректный запрос",
+	headers: {
+		"X-Request-Id": "request-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:`Response`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`переданный HTTP status;`}),`
+`,(0,c.jsx)(t.li,{children:`body с исходной строкой;`}),`
+`,(0,c.jsx)(t.li,{children:`no-store headers;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Content-Type: text/plain; charset=UTF-8`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(response.status); // 400.
+console.log(await response.text()); // "Некорректный запрос".
+console.log(response.headers.get("Content-Type"));
+// "text/plain; charset=UTF-8".
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Переданный `,(0,c.jsx)(t.code,{children:`Content-Type`}),` перезаписывается. Для JSON, HTML, XML, file stream или redirect создайте специализированный response соответствующего владельца.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Response`}),` сам проверяет допустимость status. Например, некорректное значение может привести к исключению конструктора; helper его не перехватывает.`]}),`
+`,(0,c.jsx)(t.h2,{id:`runtime-и-безопасность`,children:`Runtime и безопасность`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Функции синхронны; чтение body через `,(0,c.jsx)(t.code,{children:`response.text()`}),` асинхронно по стандарту Web API.`]}),`
+`,(0,c.jsx)(t.li,{children:`Модуль подходит browser, worker и server runtime с Web Fetch API.`}),`
+`,(0,c.jsx)(t.li,{children:`Текст вставляется как plain text, а не HTML.`}),`
+`,(0,c.jsx)(t.li,{children:`CORS-заголовки не добавляются.`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Cache-Control`}),` не заменяет authorization и redaction.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не возвращайте пользователю stack trace, tokens или внутренний transport payload.`}),`
+`,(0,c.jsx)(t.li,{children:`В Service Worker учитывайте общую cache policy: no-store response не должен вручную помещаться в Cache Storage.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`api`,children:`API`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type NoStoreHeadersInit = HeadersInit | undefined;
+
+type TextHttpResponseOptions = {
+	readonly status: number;
+	readonly text: string;
+	readonly headers?: HeadersInit;
+};
+`})}),`
+`,(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:`createNoStoreHeaders`})}),(0,c.jsxs)(t.td,{children:[`Новый `,(0,c.jsx)(t.code,{children:`Headers`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createTextHttpResponse`})}),(0,c.jsxs)(t.td,{children:[`Новый `,(0,c.jsx)(t.code,{children:`Response`})]})]})]})]})]})}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};