@ryuzaki13/react-foundation-ui 1.8.10 → 1.8.12

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

@@ -0,0 +1,110 @@
+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/Range Output`}),`
+`,(0,c.jsxs)(t.h1,{id:`подстановка-открытых-границ-через-ryuzaki13react-foundation-librange-output`,children:[`Подстановка открытых границ через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/range-output`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль хранит в UI открытые границы диапазона как `,(0,c.jsx)(t.code,{children:`null`}),`, но позволяет подставить конкретные значения при внешнем выводе или сохранении.`]}),`
+`,(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:`#%D0%BA%D0%BE%D0%BD%D1%82%D1%80%D0%B0%D0%BA%D1%82%D1%8B`,children:`Контракты`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#readrangeoutputvaluefallback`,children:(0,c.jsx)(t.code,{children:`readRangeOutputValueFallback`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#resolverangeoutputvalue`,children:(0,c.jsx)(t.code,{children:`resolveRangeOutputValue`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F-boundary`,children:`Правильная boundary`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#api-%D0%B8-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`API и ошибки`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение`,children:`Назначение`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`UI range [null, 6]
+fallback { start: 0, end: 12 }
+              │
+              ▼
+external output [0, 6]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Исходное UI-значение не изменяется. `,(0,c.jsx)(t.code,{children:`null`}),` заменяется только при построении отдельного output tuple.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { readRangeOutputValueFallback, resolveRangeOutputValue } from "@ryuzaki13/react-foundation-lib/range-output";
+
+import type { RangeOutputFallbackEndpointParser, RangeOutputValueFallback } from "@ryuzaki13/react-foundation-lib/range-output";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль pure, не требует React/browser APIs.`}),`
+`,(0,c.jsx)(t.h2,{id:`контракты`,children:`Контракты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type RangeOutputValueFallback<TValue extends BaseType> = {
+	start?: TValue | null;
+	end?: TValue | null;
+};
+
+type RangeOutputFallbackEndpointParser<TValue extends BaseType> = (value: unknown) => TValue | null | undefined;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Смысл результата parser:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Результат parser`}),(0,c.jsx)(t.th,{children:`Что происходит`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`конкретное value`}),(0,c.jsx)(t.td,{children:`сохраняется как fallback`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})}),(0,c.jsx)(t.td,{children:`явная пустая fallback-граница`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:`поле отсутствует/невалидно и не входит в result`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`readrangeoutputvaluefallback`,children:(0,c.jsx)(t.code,{children:`readRangeOutputValueFallback`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция читает только форму:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	outputValueFallback: {
+		start: unknown,
+		end: unknown
+	}
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример числового parser:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function parseFiniteNumber(value: unknown): number | undefined {
+	const parsed = typeof value === "number" ? value : Number(value);
+	return Number.isFinite(parsed) ? parsed : undefined;
+}
+
+const fallback = readRangeOutputValueFallback({ outputValueFallback: { start: "1", end: "bad" } }, parseFiniteNumber);
+
+console.log(fallback); // { start: 1 }.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, если:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`верхний `,(0,c.jsx)(t.code,{children:`props`}),` не object-like record;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`outputValueFallback`}),` не object-like record;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`оба parser-result равны `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Parser вызывается отдельно для `,(0,c.jsx)(t.code,{children:`start`}),` и `,(0,c.jsx)(t.code,{children:`end`}),`, в том числе когда raw field отсутствует. Он не должен иметь side effects.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`isRecord`}),` здесь допускает не только plain object, но исключает arrays/null. Runtime schema конкретного значения полностью задаёт parser.`]}),`
+`,(0,c.jsx)(t.h2,{id:`resolverangeoutputvalue`,children:(0,c.jsx)(t.code,{children:`resolveRangeOutputValue`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveRangeOutputValue([null, 6], { start: 0, end: 12 });
+// [0, 6].
+
+resolveRangeOutputValue([3, null], { start: 0, end: 12 });
+// [3, 12].
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила для каждой позиции:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Если UI endpoint не `,(0,c.jsx)(t.code,{children:`null`}),`, он возвращается буквально.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если endpoint равен `,(0,c.jsx)(t.code,{children:`null`}),`, используется соответствующий fallback.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если fallback отсутствует или равен `,(0,c.jsx)(t.code,{children:`null`}),`, output остаётся `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveRangeOutputValue([null, null], { end: 12 });
+// [null, 12].
+
+resolveRangeOutputValue([null, null], undefined);
+// [null, null].
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Всегда создаётся новый tuple. Вложенные ссылочные `,(0,c.jsx)(t.code,{children:`Date`}),` не клонируются.`]}),`
+`,(0,c.jsx)(t.h2,{id:`правильная-boundary`,children:`Правильная boundary`}),`
+`,(0,c.jsx)(t.p,{children:`Helper специально отделяет UI draft и внешний snapshot:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const draftRange: readonly [number | null, number | null] = [null, 6];
+
+function getConfig() {
+	return {
+		range: resolveRangeOutputValue(draftRange, outputFallback)
+	};
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не записывайте output обратно в draft:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`draft [null, 6] ───────────────► UI продолжает показывать открытую границу
+       │
+       └─ save boundary ───────► snapshot [0, 6]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это output substitution, а не общая нормализация диапазона: порядок start/end, min/max и domain validation не проверяются.`}),`
+`,(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:`RangeOutputValueFallback`})}),(0,c.jsx)(t.td,{children:`Optional start/end fallback`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`RangeOutputFallbackEndpointParser`})}),(0,c.jsx)(t.td,{children:`Parser одного endpoint`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readRangeOutputValueFallback`})}),(0,c.jsxs)(t.td,{children:[`Parsed fallback или `,(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:`resolveRangeOutputValue`})}),(0,c.jsx)(t.td,{children:`Новый output tuple`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Типичные ошибки:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`false`}),` или `,(0,c.jsx)(t.code,{children:`""`}),` отсутствующими: используется nullish logic, эти значения сохраняются.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Передавать `,(0,c.jsx)(t.code,{children:`undefined`}),` как UI endpoint при generic `,(0,c.jsx)(t.code,{children:`TValue`}),`, включающем undefined: заменяется только строго `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Мутировать draft результатом output resolver.`}),`
+`,(0,c.jsx)(t.li,{children:`Ожидать, что helper поменяет местами границы или проверит диапазон.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Делать parser через unsafe cast внешнего `,(0,c.jsx)(t.code,{children:`unknown`}),`.`]}),`
+`]})]})}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-BXJneZAJ.js

@@ -0,0 +1,147 @@
+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 API/Transport/HTTP`}),`
+`,(0,c.jsxs)(t.h1,{id:`обычный-http-через-ryuzaki13react-foundation-apihttp`,children:[`Обычный HTTP через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/http`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль выполняет нейтральные HTTP/REST запросы и создаёт функции, совместимые с TanStack Query. Внешний payload остаётся `,(0,c.jsx)(t.code,{children:`unknown`}),`, пока consumer явно не проверит его через `,(0,c.jsx)(t.code,{children:`parse`}),`.`]}),`
+`,(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%BA%D0%BE%D0%B3%D0%B4%D0%B0-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D1%8C`,children:`Когда использовать`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%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:`#httpfetch`,children:(0,c.jsx)(t.code,{children:`httpFetch`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#httpfetchpayload`,children:(0,c.jsx)(t.code,{children:`httpFetchPayload`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#httpjsonqueryfn`,children:(0,c.jsx)(t.code,{children:`httpJsonQueryFn`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#httpjsonmutationfn`,children:(0,c.jsx)(t.code,{children:`httpJsonMutationFn`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#routeerror`,children:(0,c.jsx)(t.code,{children:`RouteError`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8-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:`#%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-text`,children:`обычный REST/HTTP ──► /http
+SAP Gateway/OData ──► /odata
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`http`}),` не добавляет SAP headers, `,(0,c.jsx)(t.code,{children:`credentials: include`}),`, X-CSRF token, SSO recovery, OData V2 headers и не снимает envelope `,(0,c.jsx)(t.code,{children:`{ d: { results } }`}),`. Для SAP/OData используйте `,(0,c.jsx)(t.a,{href:`../odata/README.mdx`,children:(0,c.jsx)(t.code,{children:`/odata`})}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`импорт`,children:`Импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	httpFetch,
+	httpFetchPayload,
+	httpJsonMutationFn,
+	httpJsonQueryFn,
+	RouteError
+} from "@ryuzaki13/react-foundation-api/http";
+
+import type {
+	HttpMutationFnOptions,
+	HttpQueryFnOptions,
+	HttpRequestOptions
+} from "@ryuzaki13/react-foundation-api/http";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Нужны глобальные Web Fetch API: `,(0,c.jsx)(t.code,{children:`fetch`}),`, `,(0,c.jsx)(t.code,{children:`Request`}),`, `,(0,c.jsx)(t.code,{children:`Response`}),`, `,(0,c.jsx)(t.code,{children:`Headers`}),`, `,(0,c.jsx)(t.code,{children:`URL`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`httpfetch`,children:(0,c.jsx)(t.code,{children:`httpFetch`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const response = await httpFetch("/health", {
+	baseUrl: "https://api.example.com",
+	init: {
+		method: "GET",
+		headers: { Accept: "text/plain" }
+	}
+});
+
+console.log(await response.text());
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция возвращает исходный `,(0,c.jsx)(t.code,{children:`Response`}),`, если `,(0,c.jsx)(t.code,{children:`response.ok === true`}),`. Body ещё не прочитан.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для string input URL строится простой конкатенацией:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`baseUrl + input
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Helper не исправляет slash:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Правильно.
+{ baseUrl: "https://api.example.com", input: "/users" }
+
+// Получится https://api.example.comusers — неверно.
+{ baseUrl: "https://api.example.com", input: "users" }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если input является `,(0,c.jsx)(t.code,{children:`Request`}),` или `,(0,c.jsx)(t.code,{children:`URL`}),`, `,(0,c.jsx)(t.code,{children:`baseUrl`}),` игнорируется. Это не proxy/url resolver.`]}),`
+`,(0,c.jsx)(t.h2,{id:`httpfetchpayload`,children:(0,c.jsx)(t.code,{children:`httpFetchPayload`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const payload: unknown = await httpFetchPayload("/api/profile");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила parser-а:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Response`}),(0,c.jsx)(t.th,{children:`Результат`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`status `,(0,c.jsx)(t.code,{children:`204`}),` или `,(0,c.jsx)(t.code,{children:`205`})]}),(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:`Content-Type`}),` содержит `,(0,c.jsx)(t.code,{children:`application/json`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`response.json()`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`любой другой content type`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`response.text()`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат намеренно `,(0,c.jsx)(t.code,{children:`unknown`}),`. Generic type не может проверить данные, пришедшие по сети:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function parseProfile(value: unknown): Profile {
+	if (!isProfile(value)) throw new Error("Некорректный Profile payload");
+	return value;
+}
+
+const profile = parseProfile(await httpFetchPayload("/api/profile"));
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если сервер отдаёт JSON без корректного `,(0,c.jsx)(t.code,{children:`Content-Type`}),`, модуль вернёт JSON как string. Исправьте backend или разберите string на своей boundary.`]}),`
+`,(0,c.jsx)(t.h2,{id:`httpjsonqueryfn`,children:(0,c.jsx)(t.code,{children:`httpJsonQueryFn`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Factory возвращает async-функцию с формой TanStack Query `,(0,c.jsx)(t.code,{children:`queryFn`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const loadProfile = httpJsonQueryFn("/api/profile", {
+	baseUrl: "https://api.example.com",
+	parse: parseProfile,
+	swCache: "ttl=10m;name=profile"
+});
+
+const profile = await loadProfile({ signal });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`С React Query:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const profileQuery = useQuery({
+	queryKey: ["profile", userId],
+	queryFn: httpJsonQueryFn(\`/api/users/\${userId}\`, {
+		parse: parseProfile
+	})
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Factory:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`использует `,(0,c.jsx)(t.code,{children:`init.signal`}),`, если он задан явно;`]}),`
+`,(0,c.jsx)(t.li,{children:`иначе подставляет signal, переданный TanStack Query;`}),`
+`,(0,c.jsxs)(t.li,{children:[`добавляет `,(0,c.jsx)(t.code,{children:`x-sw-cache`}),`, только если `,(0,c.jsx)(t.code,{children:`swCache`}),` truthy;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`вызывает обязательный `,(0,c.jsx)(t.code,{children:`parse(payload)`}),` после успешного запроса.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Header `,(0,c.jsx)(t.code,{children:`x-sw-cache`}),` — только protocol с Service Worker. Без соответствующего SW он не создаёт cache.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`parse`}),` может вернуть преобразованную domain model, но обычно лучше ограничиться runtime validation и вынести бизнес-mapping владельцу entity.`]}),`
+`,(0,c.jsx)(t.h2,{id:`httpjsonmutationfn`,children:(0,c.jsx)(t.code,{children:`httpJsonMutationFn`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type CreateUserInput = { name: string };
+
+const createUser = httpJsonMutationFn<CreateUserInput, User>("/api/users", {
+	method: "POST",
+	mapBody: (input) => ({ displayName: input.name }),
+	parse: parseUser
+});
+
+const user = await createUser({ name: "Анна" });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`С `,(0,c.jsx)(t.code,{children:`useMutation`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const mutation = useMutation({ mutationFn: createUser });
+mutation.mutate({ name: "Анна" });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Поведение:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Вычисляет body через `,(0,c.jsx)(t.code,{children:`mapBody(input)`}),` или использует input.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Сериализует body через `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Использует method `,(0,c.jsx)(t.code,{children:`POST`}),` по умолчанию; поддерживаются `,(0,c.jsx)(t.code,{children:`POST`}),`, `,(0,c.jsx)(t.code,{children:`PUT`}),`, `,(0,c.jsx)(t.code,{children:`PATCH`}),`, `,(0,c.jsx)(t.code,{children:`DELETE`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Добавляет `,(0,c.jsx)(t.code,{children:`Content-Type: application/json`}),`, только если header ещё не задан.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Выполняет запрос и передаёт payload в обязательный `,(0,c.jsx)(t.code,{children:`parse`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Сигнатура mutation function также допускает второй `,(0,c.jsx)(t.code,{children:`AbortSignal`}),` при ручном вызове. Стандартный `,(0,c.jsx)(t.code,{children:`useMutation`}),` TanStack Query не передаёт signal автоматически. Если `,(0,c.jsx)(t.code,{children:`options.init.signal`}),` уже задан, второй signal не заменит его.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`JSON.stringify`}),` может бросить ошибку для `,(0,c.jsx)(t.code,{children:`BigInt`}),`/циклического объекта. `,(0,c.jsx)(t.code,{children:`undefined`}),` body сериализуется в `,(0,c.jsx)(t.code,{children:`undefined`}),`; убедитесь, что это соответствует endpoint.`]}),`
+`,(0,c.jsx)(t.h2,{id:`http-errors`,children:`HTTP errors`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`response.ok === false`}),` обе низкоуровневые функции бросают обычный `,(0,c.jsx)(t.code,{children:`Error`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`HTTP error: <message>
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если error body — непустой text, он становится message. Для JSON error object поля `,(0,c.jsx)(t.code,{children:`message`}),`, `,(0,c.jsx)(t.code,{children:`error`}),` и `,(0,c.jsx)(t.code,{children:`details`}),` не извлекаются; fallback — `,(0,c.jsx)(t.code,{children:`<status> <statusText>`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Network error/CORS/abort от глобального `,(0,c.jsx)(t.code,{children:`fetch`}),` пробрасывается без обёртки.`]}),`
+`,(0,c.jsx)(t.h2,{id:`routeerror`,children:(0,c.jsx)(t.code,{children:`RouteError`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`throw new RouteError(404);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это маленький `,(0,c.jsx)(t.code,{children:`Error`}),` с числовым полем `,(0,c.jsx)(t.code,{children:`status`}),` и пустым message. `,(0,c.jsx)(t.code,{children:`httpFetch`}),` сам его не создаёт. Класс нужен для routing/error-boundary policy приложения, если оно договорилось понимать такой error.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-runtime-и-безопасность`,children:`Ошибки, runtime и безопасность`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`TypeScript generic не валидирует сеть; используйте `,(0,c.jsx)(t.code,{children:`parse`}),`/schema guard.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`baseUrl`}),` и path не нормализуются и не кодируются.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Authorization, cookies, CORS и retry задаёт consumer через `,(0,c.jsx)(t.code,{children:`init`}),` или внешний слой.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Модуль не делает timeout. Для него используйте `,(0,c.jsx)(t.code,{children:`AbortController`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не помещайте token/secret в query string и cache key.`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`x-sw-cache`}),` для персональных данных требует изолированной cache policy.`]}),`
+`,(0,c.jsx)(t.li,{children:`На SSR абсолютный/относительный URL и cookies должны быть настроены server runtime-ом.`}),`
+`]}),`
+`,(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:`httpFetch`})}),(0,c.jsxs)(t.td,{children:[`Успешный `,(0,c.jsx)(t.code,{children:`Response`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`httpFetchPayload`})}),(0,c.jsxs)(t.td,{children:[`JSON/text/`,(0,c.jsx)(t.code,{children:`null`}),` как `,(0,c.jsx)(t.code,{children:`unknown`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`httpJsonQueryFn`})}),(0,c.jsx)(t.td,{children:`Query-compatible async function`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`httpJsonMutationFn`})}),(0,c.jsx)(t.td,{children:`Mutation-compatible async function`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`RouteError`})}),(0,c.jsxs)(t.td,{children:[`Error с `,(0,c.jsx)(t.code,{children:`status`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`HttpRequestOptions`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`baseUrl`}),` и `,(0,c.jsx)(t.code,{children:`init`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`HttpQueryFnOptions`})}),(0,c.jsxs)(t.td,{children:[`Request options + `,(0,c.jsx)(t.code,{children:`swCache`}),` + `,(0,c.jsx)(t.code,{children:`parse`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`HttpMutationFnOptions`})}),(0,c.jsx)(t.td,{children:`Request options + method/body mapper/parse`})]})]})]})]})}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-BYSgTTZt.js

@@ -0,0 +1,296 @@
+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`,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/Data/Excel`}),`
+`,(0,c.jsx)(t.h1,{id:`excel`,children:`Excel`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/excel`}),` формирует и скачивает `,(0,c.jsx)(t.code,{children:`.xlsx`}),`-файлы в браузере. Он поддерживает:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`одну или несколько таблиц-листов;`}),`
+`,(0,c.jsxs)(t.li,{children:[`типизированные ячейки `,(0,c.jsx)(t.code,{children:`String`}),`, `,(0,c.jsx)(t.code,{children:`Number`}),`, `,(0,c.jsx)(t.code,{children:`Date`}),`, `,(0,c.jsx)(t.code,{children:`Boolean`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`Excel number/date formats;`}),`
+`,(0,c.jsx)(t.li,{children:`ширину колонок;`}),`
+`,(0,c.jsx)(t.li,{children:`стили отдельных ячеек;`}),`
+`,(0,c.jsx)(t.li,{children:`auto-filter;`}),`
+`,(0,c.jsx)(t.li,{children:`адаптацию OData/table-описаний к Excel.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль строится поверх `,(0,c.jsx)(t.code,{children:`write-excel-file/browser`}),` и не предназначен для Node.js/SSR-скачивания.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка`,children:`Установка`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-lib write-excel-file
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Версия `,(0,c.jsx)(t.code,{children:`write-excel-file`}),` должна соответствовать peer dependency пакета.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	buildExcelSheetData,
+	downloadExcelFile,
+	downloadExcelWorkbook,
+	type ExcelColumn,
+	type ExcelRow
+} from "@ryuzaki13/react-foundation-lib/excel";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`самый-простой-экспорт`,children:`Самый простой экспорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await downloadExcelFile({
+	fileName: "orders.xlsx",
+	columns: [
+		{ id: "ID", header: "Номер", type: String, width: 18 },
+		{
+			id: "AMOUNT",
+			header: "Сумма",
+			type: Number,
+			format: "#,##0.00",
+			width: 14
+		},
+		{
+			id: "CREATED_AT",
+			header: "Создан",
+			type: Date,
+			format: "dd.mm.yyyy hh:mm",
+			width: 20
+		}
+	],
+	rows: [
+		{
+			ID: "A-100",
+			AMOUNT: 1250.5,
+			CREATED_AT: "2026-08-21T09:30:00+05:00"
+		}
+	],
+	autoFilter: true
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Браузер скачает книгу с единственным листом `,(0,c.jsx)(t.code,{children:`Sheet1`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`базовая-модель`,children:`Базовая модель`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ExcelColumn = {
+	id: string;
+	header: string;
+	width?: number;
+	type?: StringConstructor | NumberConstructor | DateConstructor | BooleanConstructor;
+	format?: string;
+};
+
+type ExcelRow = Record<string, unknown>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`column.id`}),` — ключ, по которому значение читается из строки. Если в row такого ключа нет, ячейка будет пустой.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`header`}),` попадает в первую строку. Заголовок автоматически получает жирный шрифт и тонкую серую нижнюю границу.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`width`}),` передаётся writer как ширина Excel-колонки. Единица соответствует API `,(0,c.jsx)(t.code,{children:`write-excel-file`}),`, а не CSS-пикселям.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`format`}),` — маска Excel, например `,(0,c.jsx)(t.code,{children:`#,##0.00`}),`, `,(0,c.jsx)(t.code,{children:`dd.mm.yyyy`}),`, `,(0,c.jsx)(t.code,{children:`hh:mm:ss`}),`. Это не `,(0,c.jsx)(t.code,{children:`Intl`}),`-формат и не строковый formatter: Excel применяет маску к настоящему числу или дате.`]}),`
+`,(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-ts`,children:`{
+	AMOUNT: "1 250,50 ₽";
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Excel увидит текст и не сможет корректно суммировать, сортировать и применять числовую маску.`}),`
+`,(0,c.jsx)(t.p,{children:`Правильно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`columns: [{ id: "AMOUNT", header: "Сумма", type: Number, format: "#,##0.00" }],
+rows: [{ AMOUNT: 1250.5 }],
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`нормализация-значений`,children:`Нормализация значений`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`buildExcelSheetData`}),` приводит данные согласно `,(0,c.jsx)(t.code,{children:`column.type`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`пустые-значения`,children:`Пустые значения`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`null`}),`, `,(0,c.jsx)(t.code,{children:`undefined`}),` и пустая строка `,(0,c.jsx)(t.code,{children:`""`}),` становятся пустой ячейкой. Строка из пробелов не считается пустой.`]}),`
+`,(0,c.jsx)(t.h3,{id:`number`,children:(0,c.jsx)(t.code,{children:`Number`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Число сохраняется как есть. Другое значение проходит через `,(0,c.jsx)(t.code,{children:`Number(value)`}),` и принимается только при конечном результате.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`"125.5"; // 125.5
+""; // пустая ячейка
+"not a number"; // пустая ячейка
+Infinity; // пустая ячейка
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Учитывайте стандартные правила JavaScript: строки `,(0,c.jsx)(t.code,{children:`"0x10"`}),` и `,(0,c.jsx)(t.code,{children:`"1e2"`}),` преобразуются в `,(0,c.jsx)(t.code,{children:`16`}),` и `,(0,c.jsx)(t.code,{children:`100`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`string`,children:(0,c.jsx)(t.code,{children:`String`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используется `,(0,c.jsx)(t.code,{children:`String(value)`}),`. Объект без собственного осмысленного `,(0,c.jsx)(t.code,{children:`toString`}),` станет строкой `,(0,c.jsx)(t.code,{children:`"[object Object]"`}),`, поэтому сложные данные подготавливайте заранее.`]}),`
+`,(0,c.jsx)(t.h3,{id:`boolean`,children:(0,c.jsx)(t.code,{children:`Boolean`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используется `,(0,c.jsx)(t.code,{children:`Boolean(value)`}),`. Непустая строка `,(0,c.jsx)(t.code,{children:`"false"`}),` является `,(0,c.jsx)(t.code,{children:`true`}),`. Если backend присылает строковые флаги, сначала преобразуйте их в реальный boolean.`]}),`
+`,(0,c.jsx)(t.h3,{id:`date`,children:(0,c.jsx)(t.code,{children:`Date`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Готовый `,(0,c.jsx)(t.code,{children:`Date`}),` используется напрямую. Остальное разбирается общим `,(0,c.jsx)(t.code,{children:`parseDate`}),` из formatters. Нераспознанное значение становится пустым.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для предсказуемого времени используйте ISO/OData-формат с явной временной зоной. Excel хранит дату как значение, а отображение дополнительно зависит от format и настроек программы пользователя.`}),`
+`,(0,c.jsxs)(t.h3,{id:`без-type`,children:[`Без `,(0,c.jsx)(t.code,{children:`type`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Значение передаётся writer почти без преобразования. Этот режим требует, чтобы вызывающий код уже подготовил тип, поддерживаемый `,(0,c.jsx)(t.code,{children:`write-excel-file`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`buildexcelsheetdataargs`,children:(0,c.jsx)(t.code,{children:`buildExcelSheetData(args)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Создаёт `,(0,c.jsx)(t.code,{children:`SheetData`}),` без скачивания файла. Полезно для тестов и собственного вызова writer.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const data = buildExcelSheetData({
+	columns,
+	rows,
+	getCellStyle: ({ row, column, rowIndex, columnIndex }) => {
+		if (column.id === "AMOUNT" && Number(row.AMOUNT) < 0) {
+			return { textColor: "#C50F1F", fontWeight: "bold" };
+		}
+
+		return undefined;
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Первая строка результата — header, затем строки данных. `,(0,c.jsx)(t.code,{children:`rowIndex`}),` и `,(0,c.jsx)(t.code,{children:`columnIndex`}),` в callback начинаются с нуля `,(0,c.jsx)(t.strong,{children:`для данных`}),`, не включая header.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Стиль объединяется после `,(0,c.jsx)(t.code,{children:`value`}),`, `,(0,c.jsx)(t.code,{children:`type`}),` и `,(0,c.jsx)(t.code,{children:`format`}),`. Тип `,(0,c.jsx)(t.code,{children:`ExcelCellStyle`}),` специально исключает эти три поля, поэтому callback предназначен только для визуальных параметров writer.`]}),`
+`,(0,c.jsx)(t.h2,{id:`стили-по-value-state`,children:`Стили по value state`}),`
+`,(0,c.jsx)(t.h3,{id:`resolveexcelcellstylefromstatestate`,children:(0,c.jsx)(t.code,{children:`resolveExcelCellStyleFromState(state)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Преобразует общий `,(0,c.jsx)(t.code,{children:`State`}),` в цвет текста:`]}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`State`}),(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:`information`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`#2563EB`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`success`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`#107C10`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`warning`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`#B7791F`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`error`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`#C50F1F`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`none`}),`, пустой строки и `,(0,c.jsx)(t.code,{children:`undefined`}),` возвращается `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getCellStyle: ({ row }) =>
+  resolveExcelCellStyleFromState(row.STATE as State),
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper задаёт только `,(0,c.jsx)(t.code,{children:`textColor`}),`. При необходимости объедините результат со своим стилем.`]}),`
+`,(0,c.jsx)(t.h2,{id:`auto-filter`,children:`Auto-filter`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`autoFilter: true;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Фильтр охватывает header и все строки данных. Он добавляется через низкоуровневую OpenXML transform-feature, потому что используемый writer не предоставляет отдельной высокоуровневой опции.`}),`
+`,(0,c.jsx)(t.h3,{id:`buildexcelautofilterrefcolumncount-rowcount`,children:(0,c.jsx)(t.code,{children:`buildExcelAutoFilterRef(columnCount, rowCount)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`buildExcelAutoFilterRef(1, 2); // "A1:A2"
+buildExcelAutoFilterRef(28, 10); // "A1:AB10"
+buildExcelAutoFilterRef(0, 10); // undefined
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`rowCount`}),` должен включать строку header. `,(0,c.jsx)(t.code,{children:`downloadExcelFile`}),` и workbook API вычисляют его автоматически.`]}),`
+`,(0,c.jsx)(t.h2,{id:`несколько-листов`,children:`Несколько листов`}),`
+`,(0,c.jsx)(t.h3,{id:`downloadexcelworkbookargs`,children:(0,c.jsx)(t.code,{children:`downloadExcelWorkbook(args)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await downloadExcelWorkbook({
+	fileName: "report.xlsx",
+	sheets: [
+		{
+			name: "Заказы",
+			columns: orderColumns,
+			rows: orders,
+			autoFilter: true
+		},
+		{
+			name: "Справочник статусов",
+			columns: statusColumns,
+			rows: statuses,
+			autoFilter: false
+		}
+	]
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Каждый лист имеет собственные колонки, ширины, строки, стили и filter. Порядок массива — порядок вкладок Excel.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустой массив `,(0,c.jsx)(t.code,{children:`sheets`}),` приводит к ошибке: «Для формирования Excel-книги нужен минимум один лист».`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fileName`}),` передаётся browser writer. Рекомендуется явно добавлять расширение `,(0,c.jsx)(t.code,{children:`.xlsx`}),` и заранее очищать пользовательский ввод от нежелательных символов имени файла.`]}),`
+`,(0,c.jsx)(t.h2,{id:`имена-листов`,children:`Имена листов`}),`
+`,(0,c.jsx)(t.h3,{id:`resolveexcelsheetnamesnames`,children:(0,c.jsx)(t.code,{children:`resolveExcelSheetNames(names)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Excel ограничивает имя листа 31 символом и запрещает управляющие символы, `,(0,c.jsx)(t.code,{children:`[ ] / \\ : * ?`}),`. Helper:`]}),`
+`,(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.jsxs)(t.li,{children:[`использует `,(0,c.jsx)(t.code,{children:`Лист N`}),` для пустого результата;`]}),`
+`,(0,c.jsx)(t.li,{children:`обрезает до 31 символа;`}),`
+`,(0,c.jsxs)(t.li,{children:[`делает имена уникальными без учёта регистра через суффиксы `,(0,c.jsx)(t.code,{children:` (2)`}),`, `,(0,c.jsx)(t.code,{children:` (3)`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveExcelSheetNames(["Продажи/Россия", "продажи россия", ""]);
+
+// ["Продажи Россия", "продажи россия (2)", "Лист 3"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция возвращает новый массив и не меняет входные строки.`}),`
+`,(0,c.jsx)(t.h2,{id:`tableodata-адаптер`,children:`Table/OData-адаптер`}),`
+`,(0,c.jsxs)(t.p,{children:[`Вторая часть модуля помогает экспортировать таблицу, описание колонок которой использует `,(0,c.jsx)(t.code,{children:`ColumnRole`}),`, `,(0,c.jsx)(t.code,{children:`ODataMetaType`}),` и formatter pipeline.`]}),`
+`,(0,c.jsx)(t.h3,{id:`tableexcelcolumndescriptor`,children:(0,c.jsx)(t.code,{children:`TableExcelColumnDescriptor`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableExcelColumnDescriptor = {
+	id: string;
+	header: string;
+	width?: number;
+	role?: ColumnRole;
+	odataType?: ODataMetaType;
+	clientOnly?: boolean;
+	formattersPipeline?: FormattersPipelineConfig;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`resolvetableexcelcolumntypedescriptor`,children:(0,c.jsx)(t.code,{children:`resolveTableExcelColumnType(descriptor)`})}),`
+`,(0,c.jsx)(t.p,{children:`Тип определяется в следующем порядке:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`clientOnly: true`}),` → `,(0,c.jsx)(t.code,{children:`Number`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`OData date/time type → `,(0,c.jsx)(t.code,{children:`Date`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`OData boolean type → `,(0,c.jsx)(t.code,{children:`Boolean`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`OData numeric type → `,(0,c.jsx)(t.code,{children:`Number`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`role: "measure"`}),` → `,(0,c.jsx)(t.code,{children:`Number`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`иначе → `,(0,c.jsx)(t.code,{children:`String`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`clientOnly`}),` здесь предполагает вычисляемую числовую колонку. Если приложение создаёт client-only текст, generic descriptor не сможет вывести его автоматически — сформируйте `,(0,c.jsx)(t.code,{children:`ExcelColumn`}),` вручную.`]}),`
+`,(0,c.jsx)(t.h3,{id:`createtableexcelcolumndescriptor`,children:(0,c.jsx)(t.code,{children:`createTableExcelColumn(descriptor)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Создаёт `,(0,c.jsx)(t.code,{children:`ExcelColumn`}),`, включая тип и format.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const column = createTableExcelColumn({
+	id: "NET_AMOUNT",
+	header: "Сумма",
+	odataType: "decimal",
+	role: "measure",
+	width: 16,
+	formattersPipeline: {
+		steps: [
+			{
+				type: "typedValueFormat",
+				config: { numberPresetName: "currency" }
+			}
+		]
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Точная структура pipeline описана в документации `,(0,c.jsx)(t.code,{children:`/formatters`}),`. Excel использует первый валидированный step `,(0,c.jsx)(t.code,{children:`typedValueFormat`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`числовые-форматы-из-presets`,children:`Числовые форматы из presets`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если pipeline содержит существующий `,(0,c.jsx)(t.code,{children:`numberPresetName`}),`, число получает столько десятичных нулей, сколько указано в preset:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`decimals = 0 → #,##0
+decimals = 2 → #,##0.00
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для OData integer по умолчанию выбирается preset `,(0,c.jsx)(t.code,{children:`integer`}),`, для других чисел — `,(0,c.jsx)(t.code,{children:`decimal`}),`. Неизвестное имя preset игнорируется и заменяется подходящим default.`]}),`
+`,(0,c.jsx)(t.h3,{id:`форматы-дат-из-presets`,children:`Форматы дат из presets`}),`
+`,(0,c.jsx)(t.p,{children:`По умолчанию:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`OData `,(0,c.jsx)(t.code,{children:`time`}),` → time preset;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`datetime`}),`/`,(0,c.jsx)(t.code,{children:`datetimeOffset`}),` → datetime preset;`]}),`
+`,(0,c.jsx)(t.li,{children:`остальные date types → date preset.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Встроенные presets переводятся в Excel-маски, включая варианты `,(0,c.jsx)(t.code,{children:`dd.mm`}),`, `,(0,c.jsx)(t.code,{children:`d mmm`}),`, `,(0,c.jsx)(t.code,{children:`mmm yyyy`}),`, `,(0,c.jsx)(t.code,{children:`hh:mm`}),` и форматы с секундами.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для пользовательского date pattern токены нормализуются для Excel: `,(0,c.jsx)(t.code,{children:`H`}),` заменяется на `,(0,c.jsx)(t.code,{children:`h`}),`, `,(0,c.jsx)(t.code,{children:`M`}),` — на `,(0,c.jsx)(t.code,{children:`m`}),`. Если `,(0,c.jsx)(t.code,{children:`datePresetName`}),` не найден в registry, он исторически трактуется как ручной pattern.`]}),`
+`,(0,c.jsx)(t.p,{children:`Форматы даты в JavaScript formatter и Excel не полностью взаимозаменяемы. Всегда проверяйте пользовательские patterns в реальном Excel/LibreOffice.`}),`
+`,(0,c.jsx)(t.h2,{id:`подготовленная-таблица`,children:`Подготовленная таблица`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ResolvedExcelTable = {
+	columns: ExcelColumn[];
+	rows: ExcelRow[];
+	cellStyles?: ReadonlyArray<Readonly<Record<string, ExcelCellStyle | undefined>>>;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`cellStyles[rowIndex][columnId]`}),` задаёт стиль конкретной ячейки. Индекс соответствует массиву `,(0,c.jsx)(t.code,{children:`rows`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`downloadresolvedexceltableargs`,children:(0,c.jsx)(t.code,{children:`downloadResolvedExcelTable(args)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await downloadResolvedExcelTable({
+	fileName: "table.xlsx",
+	table: {
+		columns,
+		rows,
+		cellStyles: [{ AMOUNT: { textColor: "#107C10" } }, { AMOUNT: { textColor: "#C50F1F" } }]
+	}
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`autoFilter`}),` по умолчанию `,(0,c.jsx)(t.code,{children:`true`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`downloadresolvedexcelworkbookargs`,children:(0,c.jsx)(t.code,{children:`downloadResolvedExcelWorkbook(args)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await downloadResolvedExcelWorkbook({
+	fileName: "analytics.xlsx",
+	sheets: [
+		{ name: "План", table: planTable },
+		{ name: "Факт", table: factTable, autoFilter: false }
+	]
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для каждого resolved sheet auto-filter тоже включён по умолчанию.`}),`
+`,(0,c.jsx)(t.h2,{id:`browser-boundary-и-обработка-ошибок`,children:`Browser boundary и обработка ошибок`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`downloadExcelFile`}),`, `,(0,c.jsx)(t.code,{children:`downloadExcelWorkbook`}),` и resolved download-функции используют browser bundle writer и инициируют сохранение файла. Вызывайте их из пользовательского действия в клиентском коде.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function onExportClick() {
+	setExporting(true);
+
+	try {
+		await downloadExcelFile(args);
+	} catch (error) {
+		showExportError(error);
+	} finally {
+		setExporting(false);
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Promise завершается после `,(0,c.jsx)(t.code,{children:`toFile`}),`. Ошибки writer, нехватка памяти и запрет скачивания браузером не подавляются.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для больших таблиц построение всей книги происходит в памяти главного потока и может временно заблокировать UI. Модуль не реализует streaming, worker и серверную генерацию.`}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`передавать-display-строки-вместо-typed-values`,children:`Передавать display-строки вместо typed values`}),`
+`,(0,c.jsxs)(t.p,{children:[`Excel теряет возможность вычислять и сортировать данные. Передавайте настоящие `,(0,c.jsx)(t.code,{children:`number`}),`, `,(0,c.jsx)(t.code,{children:`boolean`}),` и `,(0,c.jsx)(t.code,{children:`Date`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ожидать-javascript-формат-в-поле-format`,children:[`Ожидать JavaScript-формат в поле `,(0,c.jsx)(t.code,{children:`format`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это маска Excel. `,(0,c.jsx)(t.code,{children:`Intl.DateTimeFormat`}),` options и formatter preset напрямую туда не подходят.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`экспортировать-false-как-boolean`,children:[`Экспортировать `,(0,c.jsx)(t.code,{children:`"false"`}),` как Boolean`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Непустая строка истинна. Нормализуйте transport-значение до `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`использовать-api-на-сервере`,children:`Использовать API на сервере`}),`
+`,(0,c.jsxs)(t.p,{children:[`Импорт идёт из `,(0,c.jsx)(t.code,{children:`write-excel-file/browser`}),`. Для server-side Excel нужен другой owner/адаптер.`]}),`
+`,(0,c.jsx)(t.h3,{id:`передавать-пустой-workbook`,children:`Передавать пустой workbook`}),`
+`,(0,c.jsx)(t.p,{children:`Многолистовая книга требует минимум один sheet. Пустой лист с header допустим, если есть columns.`}),`
+`,(0,c.jsx)(t.h3,{id:`полагаться-на-исходные-имена-листов`,children:`Полагаться на исходные имена листов`}),`
+`,(0,c.jsxs)(t.p,{children:[`Они нормализуются и могут получить суффикс. Если имя нужно показывать пользователю заранее, вызовите `,(0,c.jsx)(t.code,{children:`resolveExcelSheetNames`}),` до download.`]}),`
+`,(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:`buildExcelSheetData`})}),(0,c.jsx)(t.td,{children:`Собрать типизированные ячейки без скачивания`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`downloadExcelFile`})}),(0,c.jsxs)(t.td,{children:[`Скачать книгу с одним листом `,(0,c.jsx)(t.code,{children:`Sheet1`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`downloadExcelWorkbook`})}),(0,c.jsx)(t.td,{children:`Скачать книгу из нескольких независимых листов`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildExcelAutoFilterRef`})}),(0,c.jsx)(t.td,{children:`Построить Excel-диапазон фильтра`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveExcelSheetNames`})}),(0,c.jsx)(t.td,{children:`Нормализовать и дедуплицировать имена листов`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveExcelCellStyleFromState`})}),(0,c.jsx)(t.td,{children:`Получить цвет текста из общего value state`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveTableExcelColumnType`})}),(0,c.jsx)(t.td,{children:`Вывести Excel type из OData/table descriptor`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createTableExcelColumn`})}),(0,c.jsx)(t.td,{children:`Создать колонку с type и format`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`downloadResolvedExcelTable`})}),(0,c.jsx)(t.td,{children:`Скачать заранее подготовленную таблицу`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`downloadResolvedExcelWorkbook`})}),(0,c.jsx)(t.td,{children:`Скачать несколько подготовленных таблиц`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ExcelColumn`}),`, `,(0,c.jsx)(t.code,{children:`ExcelRow`}),`, `,(0,c.jsx)(t.code,{children:`ExcelCellStyle`})]}),(0,c.jsx)(t.td,{children:`Базовые generic-типы`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ResolvedExcelTable`})}),(0,c.jsx)(t.td,{children:`Таблица с optional map стилей`})]})]})]})]})}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-BRNFl9WV.js → README-BmhhWWEk.js}

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