@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.13

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

@@ -0,0 +1,296 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,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-CTIBG4zH.js → README-DMiWsyv_.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-DndFRxxW.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,h4:`h4`,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/Array`}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,h4:`h4`,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/Array`}),`
 `,(0,c.jsxs)(t.h1,{id:`работа-с-массивами-через-ryuzaki13react-foundation-libarray`,children:[`Работа с массивами через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/array`})]}),`
 `,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`array`}),` содержит небольшие типизированные функции для типовых операций с массивами:`]}),`
 `,(0,c.jsxs)(t.ul,{children:[`

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

@@ -0,0 +1,82 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,li:`li`,p:`p`,pre:`pre`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Browser/Session Storage ID`}),`
+`,(0,c.jsxs)(t.h1,{id:`идентификатор-вкладочной-сессии-через-ryuzaki13react-foundation-libsession-storage`,children:[`Идентификатор вкладочной сессии через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/session-storage`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getSessionStorageId`}),` возвращает стабильный id в пределах одной browser-вкладки. При первом вызове id создаётся и сохраняется в `,(0,c.jsx)(t.code,{children:`sessionStorage`}),`, при следующих — читается по тому же ключу.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { getSessionStorageId } from "@ryuzaki13/react-foundation-lib/session-storage";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Default generator — `,(0,c.jsx)(t.code,{children:`uuidv4`}),` из `,(0,c.jsx)(t.code,{children:`/crypto`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`базовый-пример`,children:`Базовый пример`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const sessionId = getSessionStorageId("sales-app.error-report.session.v1");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Повторный вызов в той же вкладке:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const first = getSessionStorageId("sales-app.session.v1");
+const second = getSessionStorageId("sales-app.session.v1");
+
+console.log(first === second); // true, если storage доступен.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Другая вкладка имеет отдельный `,(0,c.jsx)(t.code,{children:`sessionStorage`}),` и обычно получит другой id.`]}),`
+`,(0,c.jsx)(t.h2,{id:`алгоритм`,children:`Алгоритм`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`sessionStorage недоступен ──► createId() без сохранения
+          │
+          ▼
+getItem(key)
+  ├─ непустая строка ──────► вернуть её
+  └─ нет значения ─────────► createId() → setItem → вернуть id
+
+ошибка getItem/setItem ─────► fallback createId()
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const id = getSessionStorageId("demo.session", () => "known-id");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Второй аргумент удобен для теста или другого генератора.`}),`
+`,(0,c.jsx)(t.h2,{id:`граница-стабильности`,children:`Граница стабильности`}),`
+`,(0,c.jsx)(t.p,{children:`Идентификатор стабилен только при успешном storage:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`reload той же вкладки обычно сохраняет значение;`}),`
+`,(0,c.jsx)(t.li,{children:`новая вкладка получает своё storage;`}),`
+`,(0,c.jsx)(t.li,{children:`закрытие вкладки удаляет session storage по правилам браузера;`}),`
+`,(0,c.jsx)(t.li,{children:`privacy policy, sandbox iframe или переполнение могут запретить доступ;`}),`
+`,(0,c.jsx)(t.li,{children:`если storage недоступен, каждый вызов может создать новый fallback id.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Функция ловит ошибки чтения/записи и не ломает основной пользовательский сценарий.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`setItem`}),` выбросил ошибку после первого вызова generator, fallback generator может быть вызван повторно. Не используйте `,(0,c.jsx)(t.code,{children:`createId`}),` с внешними необратимыми side effects.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ключ-storage`,children:`Ключ storage`}),`
+`,(0,c.jsx)(t.p,{children:`Ключ полностью задаёт host. Рекомендуемый формат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`<app-id>.<purpose>.v<schema-version>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Примеры:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`sales-app.error-report.session.v1
+warehouse.telemetry.tab-session.v2
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте один ключ для несвязанных подсистем. При изменении семантики меняйте версию.`}),`
+`,(0,c.jsx)(t.h2,{id:`ssr-и-безопасность`,children:`SSR и безопасность`}),`
+`,(0,c.jsxs)(t.p,{children:[`Вне browser `,(0,c.jsx)(t.code,{children:`sessionStorage`}),` отсутствует, поэтому функция просто возвращает новый id generator-а. Она не пытается создать server session.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const id = getSessionStorageId("demo", () => "server-fallback");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Идентификатор:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не является authentication token;`}),`
+`,(0,c.jsx)(t.li,{children:`не подтверждает пользователя;`}),`
+`,(0,c.jsx)(t.li,{children:`не должен давать доступ к данным;`}),`
+`,(0,c.jsx)(t.li,{children:`не является cross-tab device id;`}),`
+`,(0,c.jsx)(t.li,{children:`не должен включать персональные данные.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для долговременного client fingerprint используйте отдельный `,(0,c.jsx)(t.code,{children:`/fingerprint`}),`, понимая его privacy-границы.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`sessionStorage.clear();
+
+const createId = vi.fn(() => "session-1");
+
+expect(getSessionStorageId("test.session", createId)).toBe("session-1");
+expect(getSessionStorageId("test.session", () => "session-2")).toBe("session-1");
+expect(createId).toHaveBeenCalledOnce();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Очищайте `,(0,c.jsx)(t.code,{children:`sessionStorage`}),` между тестами.`]}),`
+`,(0,c.jsx)(t.h2,{id:`api-и-ошибки`,children:`API и ошибки`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function getSessionStorageId(key: string, createId?: () => string): string;
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Пустой сохранённый string считается отсутствующим и заменяется.`}),`
+`,(0,c.jsx)(t.li,{children:`Ключ и результат generator не валидируются.`}),`
+`,(0,c.jsx)(t.li,{children:`Исключение самого fallback generator может быть проброшено.`}),`
+`,(0,c.jsx)(t.li,{children:`Функция ничего не удаляет из storage.`}),`
+`]})]})}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-DzTc6XmY.js → README-DPhDjr43.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-DndFRxxW.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Strings`}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Strings`}),`
 `,(0,c.jsx)(t.h1,{id:`строковые-форматтеры`,children:`Строковые форматтеры`}),`
 `,(0,c.jsx)(t.p,{children:`Модуль содержит небольшие предсказуемые функции для подготовки пользовательского текста: обрезки пробелов, безопасного преобразования в строку, удаления ведущих нулей, сокращения длинного текста и выбора русской формы слова.`}),`
 `,(0,c.jsx)(t.p,{children:`Все функции экспортируются через один публичный entrypoint:`}),`

package/storybook-static/assets/{README-Dki94Nf2.js → README-D_NqWPa9.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-DndFRxxW.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Pipeline`}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Pipeline`}),`
 `,(0,c.jsx)(t.h1,{id:`formatter-pipeline`,children:`Formatter pipeline`}),`
 `,(0,c.jsx)(t.p,{children:`Formatter pipeline — конфигурируемая последовательность преобразований значения ячейки. Она умеет:`}),`
 `,(0,c.jsxs)(t.ul,{children:[`