@ryuzaki13/react-foundation-ui 1.5.12 → 1.5.14

package/storybook-static/assets/formatters-C5iLXNhs.js

@@ -1,306 +0,0 @@
-import{n as e}from"./rolldown-runtime-C0FnF6B9.js";import{n as t}from"./iframe-BOYfiRbQ.js";import{i as n,r}from"./react-qN2cStNd.js";import{l as i,m as a}from"./blocks-DFQ7gHL7.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,p:`p`,pre:`pre`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Formatters`}),`
-`,(0,c.jsx)(t.h1,{id:`форматтеры`,children:`Форматтеры`}),`
-`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`}),` — единая публичная точка входа для
-преобразования значений в host-проекте. Она покрывает даты, числа, строки,
-логические значения, ФИО, телефон и числовые идентификаторы. Импортировать
-внутренние файлы пакета и корневой пакет не нужно: все показанные ниже имена
-доступны из опубликованного subpath.`]}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { formatDate, formatNumber, normalizeText, parseBoolean } from "@ryuzaki13/react-foundation-lib/formatters";
-
-import type { DateFormatPreset, NumberFormatPresetConfig } from "@ryuzaki13/react-foundation-lib/formatters";
-`})}),`
-`,(0,c.jsx)(t.h2,{id:`выбор-api`,children:`Выбор API`}),`
-`,(0,c.jsxs)(t.p,{children:[`| Задача                                                       | Используйте                                                    |
-| ------------------------------------------------------------ | -------------------------------------------------------------- |
-| Отобразить или разобрать дату без неявного timezone-сдвига   | `,(0,c.jsx)(t.code,{children:`formatDate`}),`, `,(0,c.jsx)(t.code,{children:`parseDate`}),`, `,(0,c.jsx)(t.code,{children:`parseDateTZ`}),`                       |
-| Получить календарные границы или безопасный диапазон         | `,(0,c.jsx)(t.code,{children:`getCalendarPeriod`}),`, `,(0,c.jsx)(t.code,{children:`normalizeDateRange`}),`, `,(0,c.jsx)(t.code,{children:`requireDateRange`}),`  |
-| Отобразить число или разобрать SAP-подобную строку           | `,(0,c.jsx)(t.code,{children:`formatNumber`}),`, `,(0,c.jsx)(t.code,{children:`toFiniteNumber`}),`, `,(0,c.jsx)(t.code,{children:`parseNumber`}),`                |
-| Привести текст к безопасной строке или нормализовать пробелы | `,(0,c.jsx)(t.code,{children:`toSafeString`}),`, `,(0,c.jsx)(t.code,{children:`normalizeText`}),`, `,(0,c.jsx)(t.code,{children:`normalizeTextSpaces`}),`         |
-| Склонить русское существительное по количеству               | `,(0,c.jsx)(t.code,{children:`selectRussianPluralForm`}),`, `,(0,c.jsx)(t.code,{children:`formatRussianPlural`}),`               |
-| Преобразовать ABAP boolean                                   | `,(0,c.jsx)(t.code,{children:`parseAbapBoolean`}),`, `,(0,c.jsx)(t.code,{children:`toAbapBoolean`}),`                            |
-| Показать ФИО, российский номер или код с ведущими нулями     | `,(0,c.jsx)(t.code,{children:`formatFullName`}),`, `,(0,c.jsx)(t.code,{children:`formatPhone`}),`, `,(0,c.jsx)(t.code,{children:`normalizeLeadingZerosStrict`}),` |`]}),`
-`,(0,c.jsx)(t.h2,{id:`даты`,children:`Даты`}),`
-`,(0,c.jsx)(t.h3,{id:`основной-форматтер`,children:`Основной форматтер`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { formatDate, formatDateAsDateTime, formatDateAsODataDate } from "@ryuzaki13/react-foundation-lib/formatters";
-
-formatDate("2026-03-05T14:30:00", "date");
-// "05.03.2026"
-
-formatDateAsDateTime("/Date(1772713800000+0500)/");
-// строка даты и времени в локальной календарной семантике
-
-formatDateAsODataDate(new Date(2026, 2, 5));
-// "2026-03-05"
-`})}),`
-`,(0,c.jsx)(t.p,{children:`Сигнатура универсального вызова:`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatDate(
-	value: unknown,
-	presetOrName?: string | DateFormatPreset,
-	options?: FormatDateOptions
-): string;
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`value`}),` может быть `,(0,c.jsx)(t.code,{children:`Date`}),`, Unix timestamp, OData ticks вида
-`,(0,c.jsx)(t.code,{children:`/Date(…)/`}),`, OData literal, ABAP-дата/временная метка, ISO-строка,
-ISO-длительность и несколько распространённых человекочитаемых форматов.
-Неподходящее значение не выбрасывает исключение: результатом будет
-`,(0,c.jsx)(t.code,{children:`options.fallback`}),`, либо `,(0,c.jsx)(t.code,{children:`invalidFallback`}),` выбранного пресета, либо пустая
-строка по умолчанию.`]}),`
-`,(0,c.jsxs)(t.p,{children:[`Исключение — неизвестное строковое имя пресета: `,(0,c.jsx)(t.code,{children:`formatDate`}),` выбросит
-`,(0,c.jsx)(t.code,{children:`Error`}),`. Если формат получен из внешней конфигурации, сначала разрешите его
-через `,(0,c.jsx)(t.code,{children:`resolveDateFormatPreset`}),` или проверьте через `,(0,c.jsx)(t.code,{children:`getDatePreset`}),`.`]}),`
-`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`FormatDateOptions`}),`:`]}),`
-`,(0,c.jsxs)(t.p,{children:[`| Поле                                     | Назначение                                                                 |
-| ---------------------------------------- | -------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`fallback?: string`}),`                      | Результат для нераспознанного входа; имеет приоритет над fallback пресета. |
-| `,(0,c.jsx)(t.code,{children:`precision?: "day" \\| "month" \\| "year"`}),` | Скрывает календарные части ниже выбранной точности.                        |`]}),`
-`,(0,c.jsx)(t.h3,{id:`готовые-форматтеры`,children:`Готовые форматтеры`}),`
-`,(0,c.jsxs)(t.p,{children:[`Все функции принимают `,(0,c.jsx)(t.code,{children:`value: unknown`}),` и необязательный `,(0,c.jsx)(t.code,{children:`FormatDateOptions`}),`,
-возвращают строку и используют соответствующий встроенный пресет.`]}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                                                                                                 | Результат / назначение                                                                 |
-| --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsDate`}),`                                                                                  | `,(0,c.jsx)(t.code,{children:`dd.MM.yyyy`}),`.                                                                          |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsDateTime`}),`                                                                              | Дата и время до минут.                                                                 |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsTime`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsTimeSeconds`}),`                                                       | Время до минут или секунд.                                                             |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsDateShort`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsDateMedium`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsDateLong`}),`                           | Числовая, сокращённая и полная русская дата.                                           |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsMonthShort`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsMonthMedium`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsMonthLong`}),`                        | День и месяц без года: числовой, сокращённый или полный вид.                           |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsMonthYearMedium`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsMonthYearLong`}),`                                          | Месяц и год в сокращённом или полном виде.                                             |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsTimeShort`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsTimeMedium`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsTimeLong`}),`                           | Короткое или секундное время без вывода timezone.                                      |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsDatetimeShort`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsDatetimeMedium`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsDatetimeLong`}),`               | Дата и время с разной детализацией.                                                    |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsAbapYear`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsAbapMonth`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsAbapDate`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsAbapDatetime`}),` | Машинные строки `,(0,c.jsx)(t.code,{children:`yyyy`}),`, `,(0,c.jsx)(t.code,{children:`yyyyMM`}),`, `,(0,c.jsx)(t.code,{children:`yyyyMMdd`}),`, `,(0,c.jsx)(t.code,{children:`yyyyMMddHHmmss`}),`.                        |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsODataDate`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsODataDatetime`}),`                                                | Машинные строки `,(0,c.jsx)(t.code,{children:`yyyy-MM-dd`}),`, `,(0,c.jsx)(t.code,{children:`yyyy-MM-ddTHH:mm:ss`}),`.                                   |
-| `,(0,c.jsx)(t.code,{children:`formatDateAsODataTime`}),`                                                                             | Время как OData duration `,(0,c.jsx)(t.code,{children:`PT00H00M00S`}),`; для ISO-длительности форматирует её как время. |
-| `,(0,c.jsx)(t.code,{children:`formatDateRange(startValue, endValue, presetOrName?, options?)`}),`                                    | Две валидные даты через `,(0,c.jsx)(t.code,{children:`-`}),`; если любая невалидна, возвращает fallback.                |`]}),`
-`,(0,c.jsx)(t.h3,{id:`разбор-даты-и-timezone-семантика`,children:`Разбор даты и timezone-семантика`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { parseDate, parseDateTZ, parseDateByPattern, parseDateValue } from "@ryuzaki13/react-foundation-lib/formatters";
-
-parseDate("20260305");
-// Date | null
-
-parseDateTZ("2026-03-05T10:00:00+05:00");
-// Date | null, сохраняет абсолютный instant
-
-parseDateByPattern("05/03/2026", "dd/MM/yyyy");
-// { kind: "date-time", source: "iso-local", date: Date } | null
-
-parseDateValue("PT01H30M");
-// { kind: "duration", source: "iso-duration", durationMs: 5_400_000 } | null
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                                                   | Вход и результат                                                                                                                                                        |
-| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`parseDateValue(value)`}),`                               | `,(0,c.jsx)(t.code,{children:`ParsedDateValue \\| null`}),`. Обычный режим: сохраняет видимые календарные компоненты без применения timezone.                                                             |
-| `,(0,c.jsx)(t.code,{children:`parseDateValueTZ(value)`}),`                             | `,(0,c.jsx)(t.code,{children:`ParsedDateValue \\| null`}),`. Для Unix timestamp и ISO/OData со смещением сохраняет абсолютный момент времени.                                                             |
-| `,(0,c.jsx)(t.code,{children:`parseDate(value)`}),`                                    | `,(0,c.jsx)(t.code,{children:`Date \\| null`}),`; в том числе приводит duration к `,(0,c.jsx)(t.code,{children:`Date`}),` в «плавающей» календарной семантике.                                                                             |
-| `,(0,c.jsx)(t.code,{children:`parseDateTZ(value)`}),`                                  | `,(0,c.jsx)(t.code,{children:`Date \\| null`}),` с timezone-aware трактовкой абсолютного времени.                                                                                                         |
-| `,(0,c.jsx)(t.code,{children:`parseDateByPattern(value, pattern?, { precision? })`}),` | Строго разбирает токены `,(0,c.jsx)(t.code,{children:`dd`}),`, `,(0,c.jsx)(t.code,{children:`MM`}),`, `,(0,c.jsx)(t.code,{children:`yyyy`}),`, `,(0,c.jsx)(t.code,{children:`yy`}),`, `,(0,c.jsx)(t.code,{children:`HH`}),`, `,(0,c.jsx)(t.code,{children:`mm`}),`, `,(0,c.jsx)(t.code,{children:`ss`}),`; невалидные компоненты дают `,(0,c.jsx)(t.code,{children:`null`}),`. Двузначный год `,(0,c.jsx)(t.code,{children:`00–69`}),` — это `,(0,c.jsx)(t.code,{children:`2000–2069`}),`, `,(0,c.jsx)(t.code,{children:`70–99`}),` — `,(0,c.jsx)(t.code,{children:`1970–1999`}),`. |
-| `,(0,c.jsx)(t.code,{children:`parseDateByFormat(value, dateFormat?, options?)`}),`     | Разбирает зарегистрированное имя пресета, style-алиас или ручной шаблон. `,(0,c.jsx)(t.code,{children:`options`}),`: `,(0,c.jsx)(t.code,{children:`defaultFormat`}),`, `,(0,c.jsx)(t.code,{children:`locale`}),`, `,(0,c.jsx)(t.code,{children:`precision`}),`, `,(0,c.jsx)(t.code,{children:`referenceDate`}),`.                            |`]}),`
-`,(0,c.jsxs)(t.p,{children:[`Публичные типы для результатов и контракта: `,(0,c.jsx)(t.code,{children:`DateInputSource`}),`,
-`,(0,c.jsx)(t.code,{children:`ParsedDateValue`}),`, `,(0,c.jsx)(t.code,{children:`DateFormatPattern`}),`, `,(0,c.jsx)(t.code,{children:`DateFormatStyle`}),`,
-`,(0,c.jsx)(t.code,{children:`DateFormatPrecision`}),`, `,(0,c.jsx)(t.code,{children:`DateFormatPreset`}),`, `,(0,c.jsx)(t.code,{children:`DateFormatPresetConfig`}),`,
-`,(0,c.jsx)(t.code,{children:`FormatDateOptions`}),`, `,(0,c.jsx)(t.code,{children:`ParseDateByPatternOptions`}),`, `,(0,c.jsx)(t.code,{children:`ParseDateByFormatOptions`}),`.`]}),`
-`,(0,c.jsxs)(t.p,{children:[`Не заменяйте `,(0,c.jsx)(t.code,{children:`parseDate`}),` на `,(0,c.jsx)(t.code,{children:`new Date("YYYY-MM-DD")`}),`, если значение является
-календарной датой: native parsing может изменить отображаемый день из-за
-timezone.`]}),`
-`,(0,c.jsx)(t.h3,{id:`пресеты-дат`,children:`Пресеты дат`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
-	DEFAULT_DATE_PRESET_NAMES,
-	getDatePreset,
-	registerDatePreset,
-	resolveDateFormatPreset
-} from "@ryuzaki13/react-foundation-lib/formatters";
-
-registerDatePreset({
-	name: "report-date",
-	pattern: "dd.MM.yyyy",
-	invalidFallback: "—"
-});
-
-formatDate("2026-03-05", "report-date"); // "05.03.2026"
-
-const safePreset = resolveDateFormatPreset("dd/MM/yyyy");
-formatDate("05/03/2026", safePreset); // "05/03/2026"
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`DEFAULT_DATE_PRESET_NAMES`}),` содержит: `,(0,c.jsx)(t.code,{children:`date`}),`, `,(0,c.jsx)(t.code,{children:`date-short`}),`, `,(0,c.jsx)(t.code,{children:`date-medium`}),`,
-`,(0,c.jsx)(t.code,{children:`date-long`}),`, `,(0,c.jsx)(t.code,{children:`month-short`}),`, `,(0,c.jsx)(t.code,{children:`month-medium`}),`, `,(0,c.jsx)(t.code,{children:`month-long`}),`,
-`,(0,c.jsx)(t.code,{children:`month-year-medium`}),`, `,(0,c.jsx)(t.code,{children:`month-year-long`}),`, `,(0,c.jsx)(t.code,{children:`datetime`}),`, `,(0,c.jsx)(t.code,{children:`datetime-seconds`}),`,
-`,(0,c.jsx)(t.code,{children:`datetime-short`}),`, `,(0,c.jsx)(t.code,{children:`datetime-medium`}),`, `,(0,c.jsx)(t.code,{children:`datetime-long`}),`, `,(0,c.jsx)(t.code,{children:`time`}),`,
-`,(0,c.jsx)(t.code,{children:`time-seconds`}),`, `,(0,c.jsx)(t.code,{children:`time-short`}),`, `,(0,c.jsx)(t.code,{children:`time-medium`}),`, `,(0,c.jsx)(t.code,{children:`time-long`}),`, `,(0,c.jsx)(t.code,{children:`odata-date`}),`,
-`,(0,c.jsx)(t.code,{children:`odata-datetime`}),`, `,(0,c.jsx)(t.code,{children:`abap-datetime`}),`, `,(0,c.jsx)(t.code,{children:`abap-date`}),`, `,(0,c.jsx)(t.code,{children:`abap-month`}),`, `,(0,c.jsx)(t.code,{children:`abap-year`}),`.`]}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                                                        | Поведение                                                                                                      |
-| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`DATE_FORMAT_DEFAULTS`}),`                                     | Значения по умолчанию: `,(0,c.jsx)(t.code,{children:`ru-RU`}),`, числовая дата и пустой `,(0,c.jsx)(t.code,{children:`invalidFallback`}),`.                                      |
-| `,(0,c.jsx)(t.code,{children:`DATE_FORMAT_STYLE_PRESET_NAMES`}),`                           | Соответствие `,(0,c.jsx)(t.code,{children:`short`}),`, `,(0,c.jsx)(t.code,{children:`medium`}),`, `,(0,c.jsx)(t.code,{children:`long`}),` встроенным date-пресетам.                                               |
-| `,(0,c.jsx)(t.code,{children:`getDatePreset(name)`}),`, `,(0,c.jsx)(t.code,{children:`getDatePresetNames()`}),`              | Возвращают пресет или `,(0,c.jsx)(t.code,{children:`undefined`}),`, список имён.                                                                |
-| `,(0,c.jsx)(t.code,{children:`registerDatePreset(config)`}),`                               | Компилирует и регистрирует/перезаписывает пресет, возвращает готовый `,(0,c.jsx)(t.code,{children:`DateFormatPreset`}),`. Реестр module-scoped. |
-| `,(0,c.jsx)(t.code,{children:`resetDatePresets()`}),`                                       | Сбрасывает реестр к встроенным пресетам; используйте для изолированных тестов, не в обычном runtime.           |
-| `,(0,c.jsx)(t.code,{children:`isDateFormatStyle(value)`}),`, `,(0,c.jsx)(t.code,{children:`isDateFormatPrecision(value)`}),` | Type guard для style и precision.                                                                              |
-| `,(0,c.jsx)(t.code,{children:`resolveDateFormatName(value?, defaultFormat?)`}),`            | Обрезает пробелы и переводит `,(0,c.jsx)(t.code,{children:`short`}),` / `,(0,c.jsx)(t.code,{children:`medium`}),` / `,(0,c.jsx)(t.code,{children:`long`}),` в имя date-пресета.                                   |
-| `,(0,c.jsx)(t.code,{children:`resolveDateFormatPreset(value?, options?)`}),`                | Возвращает имя зарегистрированного пресета или кешируемый объектный пресет для ручного шаблона.                |`]}),`
-`,(0,c.jsxs)(t.p,{children:[`Для ручных шаблонов доступны константы `,(0,c.jsx)(t.code,{children:`DATE_PATTERN_DATE_TOKENS`}),`,
-`,(0,c.jsx)(t.code,{children:`DATE_PATTERN_TIME_TOKENS`}),`, `,(0,c.jsx)(t.code,{children:`DATE_PATTERN_TOKENS`}),` и `,(0,c.jsx)(t.code,{children:`DATE_PATTERN_TOKEN_RE`}),`.
-Поддерживаются только перечисленные токены; остальные фрагменты шаблона —
-литеральный текст.`]}),`
-`,(0,c.jsx)(t.h3,{id:`календарные-значения-и-диапазоны`,children:`Календарные значения и диапазоны`}),`
-`,(0,c.jsxs)(t.p,{children:[`Эти функции работают с локальными компонентами `,(0,c.jsx)(t.code,{children:`Date`}),` и не добавляют UTC- или
-timezone-семантику.`]}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                                                                                                                                                                           | Результат / fallback                                                                                               |
-| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
-| `,(0,c.jsx)(t.code,{children:`createCalendarDate(year, monthIndex, day, hour?, minute?, second?, millisecond?)`}),`                                                                                            | Новый локальный `,(0,c.jsx)(t.code,{children:`Date`}),`; `,(0,c.jsx)(t.code,{children:`monthIndex`}),` соответствует `,(0,c.jsx)(t.code,{children:`Date#getMonth()`}),`.                                              |
-| `,(0,c.jsx)(t.code,{children:`getStartOfDay`}),`, `,(0,c.jsx)(t.code,{children:`getEndOfDay`}),`, `,(0,c.jsx)(t.code,{children:`getStartOfMonth`}),`, `,(0,c.jsx)(t.code,{children:`getStartOfYear`}),`, `,(0,c.jsx)(t.code,{children:`getStartOfWeek(date, weekStartsOn?)`}),`                                                                    | Новая дата с календарной границей; по умолчанию неделя начинается в понедельник.                                   |
-| `,(0,c.jsx)(t.code,{children:`addCalendarDays`}),`, `,(0,c.jsx)(t.code,{children:`addCalendarMonths`}),`, `,(0,c.jsx)(t.code,{children:`addCalendarYears`}),`                                                                                                                    | Новый `,(0,c.jsx)(t.code,{children:`Date`}),`, сдвинутый в календарной семантике.                                                                   |
-| `,(0,c.jsx)(t.code,{children:`isSameCalendarDay(left, right)`}),`                                                                                                                                              | `,(0,c.jsx)(t.code,{children:`false`}),`, если любой аргумент не является `,(0,c.jsx)(t.code,{children:`Date`}),`; иначе сравнивает год, месяц, день.                                |
-| `,(0,c.jsx)(t.code,{children:`getCalendarPeriod(value, { selectionMode?, weekEndDay? })`}),`                                                                                                                   | `,(0,c.jsx)(t.code,{children:`{ start, end } \\| null`}),`; режимы `,(0,c.jsx)(t.code,{children:`day`}),`, `,(0,c.jsx)(t.code,{children:`week`}),`, `,(0,c.jsx)(t.code,{children:`month`}),`, `,(0,c.jsx)(t.code,{children:`year`}),`, конец недели — `,(0,c.jsx)(t.code,{children:`friday`}),`, `,(0,c.jsx)(t.code,{children:`saturday`}),` или `,(0,c.jsx)(t.code,{children:`sunday`}),`. |
-| `,(0,c.jsx)(t.code,{children:`isDateInsideCalendarPeriod`}),`, `,(0,c.jsx)(t.code,{children:`isCalendarPeriodWithinDateBounds`}),`                                                                                                              | Проверяют включительные границы; при отсутствующих/невалидных данных возвращают `,(0,c.jsx)(t.code,{children:`false`}),`.                           |
-| `,(0,c.jsx)(t.code,{children:`resolveDateRangePair(value)`}),`                                                                                                                                                 | Упорядоченная пара дат или `,(0,c.jsx)(t.code,{children:`null`}),`; одиночная дата становится диапазоном из неё самой.                              |
-| `,(0,c.jsx)(t.code,{children:`normalizeDateRange(value, { timeMode? })`}),`                                                                                                                                    | `,(0,c.jsx)(t.code,{children:`DateRange \\| null`}),`; по умолчанию расширяет до границ суток, `,(0,c.jsx)(t.code,{children:`preserve`}),` сохраняет время и создаёт копии.           |
-| `,(0,c.jsx)(t.code,{children:`requireDateRange(value, options?)`}),`                                                                                                                                           | Как `,(0,c.jsx)(t.code,{children:`normalizeDateRange`}),`, но при отсутствии диапазона выбрасывает `,(0,c.jsx)(t.code,{children:`Error`}),`.                                         |
-| `,(0,c.jsx)(t.code,{children:`countCalendarDaysInDateRange(value)`}),`                                                                                                                                         | Количество дней включительно или `,(0,c.jsx)(t.code,{children:`null`}),`.                                                                           |
-| `,(0,c.jsx)(t.code,{children:`isValidDate`}),`, `,(0,c.jsx)(t.code,{children:`isDateRangeTuple`}),`, `,(0,c.jsx)(t.code,{children:`cloneDate`}),`, `,(0,c.jsx)(t.code,{children:`orderDates`}),`                                                                                                                  | Низкоуровневые guards и операции диапазона.                                                                        |
-| `,(0,c.jsx)(t.code,{children:`normalizeDateRangeReferenceDate`}),`, `,(0,c.jsx)(t.code,{children:`resolveTodayRange`}),`, `,(0,c.jsx)(t.code,{children:`resolveYesterdayRange`}),`, `,(0,c.jsx)(t.code,{children:`resolveMonthAgoRange`}),`, `,(0,c.jsx)(t.code,{children:`resolveMonthStartToTodayRange`}),`, `,(0,c.jsx)(t.code,{children:`resolveMonthStartToYesterdayRange`}),` | Относительные диапазоны от `,(0,c.jsx)(t.code,{children:`{ referenceDate }`}),`; на первом дне месяца «по вчера» не создаёт инверсию.               |`]}),`
-`,(0,c.jsxs)(t.p,{children:[`Публичные типы диапазонов: `,(0,c.jsx)(t.code,{children:`CalendarPeriod`}),`, `,(0,c.jsx)(t.code,{children:`CalendarPeriodOptions`}),`,
-`,(0,c.jsx)(t.code,{children:`CalendarPeriodDateBounds`}),`, `,(0,c.jsx)(t.code,{children:`CalendarPeriodSelectionMode`}),`,
-`,(0,c.jsx)(t.code,{children:`CalendarWeekEndDay`}),`, `,(0,c.jsx)(t.code,{children:`DateRange`}),`, `,(0,c.jsx)(t.code,{children:`NullableDateRange`}),`, `,(0,c.jsx)(t.code,{children:`DateRangeInput`}),`,
-`,(0,c.jsx)(t.code,{children:`DateRangeTimeMode`}),`, `,(0,c.jsx)(t.code,{children:`NormalizeDateRangeOptions`}),`, `,(0,c.jsx)(t.code,{children:`DateRangeReferenceContext`}),`.`]}),`
-`,(0,c.jsx)(t.h3,{id:`учебный-календарь`,children:`Учебный календарь`}),`
-`,(0,c.jsxs)(t.p,{children:[`Для образовательной модели доступны `,(0,c.jsx)(t.code,{children:`EducationDateKey`}),` (`,(0,c.jsx)(t.code,{children:`YYYY-MM-DD`}),`),
-`,(0,c.jsx)(t.code,{children:`EducationYearRange`}),` и `,(0,c.jsx)(t.code,{children:`EducationWeekRange`}),`.`]}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                                                                                                        | Поведение                                                                                                           |
-| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`parseEducationDateKey`}),`, `,(0,c.jsx)(t.code,{children:`createEducationDateTime`}),`                                                         | Возвращают `,(0,c.jsx)(t.code,{children:`Date \\| null`}),` при неверном ключе или времени.                                                           |
-| `,(0,c.jsx)(t.code,{children:`formatEducationDateKey`}),`, `,(0,c.jsx)(t.code,{children:`formatEducationTimeKey`}),`                                                         | Создают стабильные локальные ключи `,(0,c.jsx)(t.code,{children:`YYYY-MM-DD`}),` и `,(0,c.jsx)(t.code,{children:`HH:mm`}),`.                                                          |
-| `,(0,c.jsx)(t.code,{children:`getEducationYear`}),`, `,(0,c.jsx)(t.code,{children:`getEducationYearRange`}),`, `,(0,c.jsx)(t.code,{children:`isEducationDateInCurrentYear`}),`                                | Учебный год: 1 сентября — 31 августа.                                                                               |
-| `,(0,c.jsx)(t.code,{children:`getEducationWeekStartDate`}),`, `,(0,c.jsx)(t.code,{children:`getEducationWeekRange`}),`, `,(0,c.jsx)(t.code,{children:`getEducationWeekDays`}),`, `,(0,c.jsx)(t.code,{children:`getCurrentEducationWeekKey`}),` | Учебная неделя: понедельник — суббота; воскресенье относится к следующей.                                           |
-| `,(0,c.jsx)(t.code,{children:`normalizeEducationWeekKey`}),`, `,(0,c.jsx)(t.code,{children:`resolveEducationWeekKey`}),`, `,(0,c.jsx)(t.code,{children:`isCurrentEducationWeek`}),`                           | Невалидный или вне текущего учебного года ключ даёт `,(0,c.jsx)(t.code,{children:`undefined`}),`; `,(0,c.jsx)(t.code,{children:`resolve…`}),` вместо этого возвращает текущую неделю. |`]}),`
-`,(0,c.jsx)(t.h2,{id:`числа`,children:`Числа`}),`
-`,(0,c.jsx)(t.h3,{id:`форматирование-и-пресеты`,children:`Форматирование и пресеты`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
-	formatNumber,
-	formatNumberAsDecimal2,
-	formatNumberAsIntegerOrEmpty,
-	registerNumberPreset
-} from "@ryuzaki13/react-foundation-lib/formatters";
-
-formatNumberAsDecimal2(12345.6); // "12\xA0345,60" в ru-RU
-formatNumberAsIntegerOrEmpty("0"); // ""
-
-registerNumberPreset({
-	name: "quantity-4",
-	decimals: 4,
-	grouping: false
-});
-
-formatNumber(12.5, "quantity-4"); // "12,5000"
-`})}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatNumber(value: unknown, presetOrName: string | NumberFormatPreset): string;
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[`Форматирование использует `,(0,c.jsx)(t.code,{children:`Intl.NumberFormat("ru-RU")`}),`. Пустая строка,
-`,(0,c.jsx)(t.code,{children:`NaN`}),`, `,(0,c.jsx)(t.code,{children:`Infinity`}),` и значения, которые `,(0,c.jsx)(t.code,{children:`Number(value)`}),` не может привести к
-конечному числу, возвращают строку `,(0,c.jsx)(t.code,{children:`"0"`}),`. Неизвестное строковое имя пресета
-выбрасывает `,(0,c.jsx)(t.code,{children:`Error`}),`.`]}),`
-`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`formatNumber`}),` не является SAP-парсером: переданная строка `,(0,c.jsx)(t.code,{children:`"1 234,5"`}),` не
-обязана быть принята `,(0,c.jsx)(t.code,{children:`Number`}),`. Для такого входа сначала используйте
-`,(0,c.jsx)(t.code,{children:`toFiniteNumber`}),` или `,(0,c.jsx)(t.code,{children:`parseNumber`}),`.`]}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                                                                                                                                                                                                                                                             | Поведение                                                                                                         |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`formatNumberAsInteger`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsCurrency`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsPrice`}),`                                                                                                                                                                                        | Встроенные пресеты с нулевой дробной частью. Валютный знак не добавляется.                                        |
-| `,(0,c.jsx)(t.code,{children:`formatNumberAsDecimal`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsDecimal2`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsDecimal3`}),`                                                                                                                                                                                     | Один, два или три знака после запятой.                                                                            |
-| `,(0,c.jsx)(t.code,{children:`formatNumberAsPercent`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsTonnage`}),`                                                                                                                                                                                                                | Встроенные пресеты с двумя и одним знаком соответственно; знак `,(0,c.jsx)(t.code,{children:`%`}),` не добавляется.                                |
-| `,(0,c.jsx)(t.code,{children:`formatNumberAsIntegerOrEmpty`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsCurrencyOrEmpty`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsDecimalOrEmpty`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsDecimal2OrEmpty`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsDecimal3OrEmpty`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsPercentOrEmpty`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsPriceOrEmpty`}),`, `,(0,c.jsx)(t.code,{children:`formatNumberAsTonnageOrEmpty`}),` | Сначала проверяют семантический ноль; для него возвращают `,(0,c.jsx)(t.code,{children:`""`}),`, иначе используют одноимённый форматтер.           |
-| `,(0,c.jsx)(t.code,{children:`truncateNumber(number, decimals)`}),`                                                                                                                                                                                                                              | Усечение дробной части математически, без форматирования и без проверки аргументов.                               |
-| `,(0,c.jsx)(t.code,{children:`clearFormatCache()`}),`                                                                                                                                                                                                                                            | Очищает module-scoped кеш `,(0,c.jsx)(t.code,{children:`Intl.NumberFormat`}),`; обычно нужен только для тестов или смены изолированного окружения. |`]}),`
-`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`DEFAULT_NUMBER_PRESET_NAMES`}),` содержит: `,(0,c.jsx)(t.code,{children:`integer`}),`, `,(0,c.jsx)(t.code,{children:`decimal`}),`, `,(0,c.jsx)(t.code,{children:`decimal-2`}),`,
-`,(0,c.jsx)(t.code,{children:`decimal-3`}),`, `,(0,c.jsx)(t.code,{children:`currency`}),`, `,(0,c.jsx)(t.code,{children:`price`}),`, `,(0,c.jsx)(t.code,{children:`percent`}),`, `,(0,c.jsx)(t.code,{children:`tonnage`}),`,
-`,(0,c.jsx)(t.code,{children:`compact-currency`}),`, `,(0,c.jsx)(t.code,{children:`compact-currency-round`}),`, `,(0,c.jsx)(t.code,{children:`compact-percent`}),`,
-`,(0,c.jsx)(t.code,{children:`compact-percent-round`}),`, `,(0,c.jsx)(t.code,{children:`compact-tonnage`}),`, `,(0,c.jsx)(t.code,{children:`compact-tonnage-round`}),`.
-Компактность задаётся через поле `,(0,c.jsx)(t.code,{children:`compact`}),` самого пресета: при значении от
-1000 по умолчанию используются суффиксы `,(0,c.jsx)(t.code,{children:`тыс`}),`, `,(0,c.jsx)(t.code,{children:`млн`}),`, `,(0,c.jsx)(t.code,{children:`млрд`}),`, `,(0,c.jsx)(t.code,{children:`трлн`}),`.`]}),`
-`,(0,c.jsxs)(t.p,{children:[`| API / тип                                                                                  | Назначение                                                                                                               |
-| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `,(0,c.jsx)(t.code,{children:`NUMBER_FORMAT_DEFAULTS`}),`                                                                   | Базовые значения: один знак, `,(0,c.jsx)(t.code,{children:`,`}),`, группировка ru-RU, размер группы 3.                                                    |
-| `,(0,c.jsx)(t.code,{children:`NumberFormatPreset`}),`, `,(0,c.jsx)(t.code,{children:`NumberFormatPresetConfig`}),`                                           | Контракт пресета и конфигурации регистрации.                                                                             |
-| `,(0,c.jsx)(t.code,{children:`NumberFormatCompactOptions`}),`, `,(0,c.jsx)(t.code,{children:`NumberFormatCompactUnit`}),`, `,(0,c.jsx)(t.code,{children:`NumberFormatCompactRoundingMode`}),` | Настройки compact-представления: минимум, дробная часть, режим `,(0,c.jsx)(t.code,{children:`round`}),` / `,(0,c.jsx)(t.code,{children:`floor`}),` / `,(0,c.jsx)(t.code,{children:`ceil`}),` / `,(0,c.jsx)(t.code,{children:`trunc`}),`, суффиксы и единицы. |
-| `,(0,c.jsx)(t.code,{children:`getNumberPreset(name)`}),`, `,(0,c.jsx)(t.code,{children:`getNumberPresetNames()`}),`                                          | Чтение пресета или `,(0,c.jsx)(t.code,{children:`undefined`}),`, список имён.                                                                             |
-| `,(0,c.jsx)(t.code,{children:`registerNumberPreset(config)`}),`                                                             | Регистрирует или перезаписывает пресет, дополняя отсутствующие поля `,(0,c.jsx)(t.code,{children:`NUMBER_FORMAT_DEFAULTS`}),`.                            |
-| `,(0,c.jsx)(t.code,{children:`resetNumberPresets()`}),`                                                                     | Возвращает только встроенные пресеты; не вызывайте в работающем приложении.                                              |`]}),`
-`,(0,c.jsx)(t.h3,{id:`разбор-и-проверки`,children:`Разбор и проверки`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { isPositiveValue, parseNumber, toFiniteNumber, toPositiveInteger } from "@ryuzaki13/react-foundation-lib/formatters";
-
-toFiniteNumber("1\xA0234,50"); // 1234.5
-parseNumber("не число"); // 0
-toPositiveInteger("12"); // 12
-isPositiveValue("0"); // false
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                        | Fallback                                                                                                                 |
-| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| `,(0,c.jsx)(t.code,{children:`toFiniteNumber(value)`}),`    | `,(0,c.jsx)(t.code,{children:`number \\| undefined`}),`. Поддерживает пробелы, NBSP, узкий NBSP и `,(0,c.jsx)(t.code,{children:`'`}),` как группировку; запятую как десятичный разделитель. |
-| `,(0,c.jsx)(t.code,{children:`parseNumber(value)`}),`       | Как `,(0,c.jsx)(t.code,{children:`toFiniteNumber`}),`, но возвращает `,(0,c.jsx)(t.code,{children:`0`}),` вместо `,(0,c.jsx)(t.code,{children:`undefined`}),`.                                                              |
-| `,(0,c.jsx)(t.code,{children:`toPositiveInteger(value)`}),` | Положительное целое или `,(0,c.jsx)(t.code,{children:`undefined`}),`.                                                                                     |
-| `,(0,c.jsx)(t.code,{children:`isPositiveValue(value)`}),`   | `,(0,c.jsx)(t.code,{children:`true`}),` только для конечного значения строго больше нуля.                                                                 |
-| `,(0,c.jsx)(t.code,{children:`isZeroValue(value)`}),`       | `,(0,c.jsx)(t.code,{children:`true`}),` для значений, семантически равных нулю; используется вариантами `,(0,c.jsx)(t.code,{children:`…OrEmpty`}),`.                                       |`]}),`
-`,(0,c.jsx)(t.h2,{id:`строки`,children:`Строки`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { formatRussianPlural } from "@ryuzaki13/react-foundation-lib/formatters";
-
-const elementForms = {
-	one: "элемент",
-	few: "элемента",
-	many: "элементов"
-};
-
-formatRussianPlural(1, elementForms); // "1 элемент"
-formatRussianPlural(2, elementForms); // "2 элемента"
-formatRussianPlural(7, elementForms); // "7 элементов"
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                                               | Вход, результат и fallback                                                                                                                  |
-| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`selectRussianPluralForm(value, forms)`}),`           | Выбирает полную русскую форму `,(0,c.jsx)(t.code,{children:`one`}),`, `,(0,c.jsx)(t.code,{children:`few`}),`, `,(0,c.jsx)(t.code,{children:`many`}),` или `,(0,c.jsx)(t.code,{children:`other`}),`; для дробного значения без `,(0,c.jsx)(t.code,{children:`other`}),` использует `,(0,c.jsx)(t.code,{children:`few`}),`.                         |
-| `,(0,c.jsx)(t.code,{children:`formatRussianPlural(value, forms)`}),`               | Возвращает исходное количество и выбранную форму через пробел; не округляет и не форматирует число отдельно.                               |
-| `,(0,c.jsx)(t.code,{children:`normalizeText(value)`}),`                            | Обрезанная непустая строка или `,(0,c.jsx)(t.code,{children:`undefined`}),` для нестрокового/пустого значения.                                                               |
-| `,(0,c.jsx)(t.code,{children:`normalizeTextWithFallback(value, fallback = "")`}),` | Нормализованный текст или указанный fallback.                                                                                               |
-| `,(0,c.jsx)(t.code,{children:`normalizeRequiredText(value)`}),`                    | Нормализованный текст или `,(0,c.jsx)(t.code,{children:`""`}),`.                                                                                                             |
-| `,(0,c.jsx)(t.code,{children:`normalizeTextToLower(value)`}),`                     | Нормализованный текст в нижнем регистре или `,(0,c.jsx)(t.code,{children:`""`}),`.                                                                                           |
-| `,(0,c.jsx)(t.code,{children:`normalizeTextSpaces(value)`}),`                      | Убирает пробелы по краям и сворачивает пробельные символы, NBSP и узкие NBSP в один обычный пробел.                                         |
-| `,(0,c.jsx)(t.code,{children:`toSafeString(value)`}),`                             | `,(0,c.jsx)(t.code,{children:`""`}),` для `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),`, иначе `,(0,c.jsx)(t.code,{children:`String(value)`}),`.                                                                                         |
-| `,(0,c.jsx)(t.code,{children:`stripInnerSpaces(value)`}),`                         | Удаляет только обычные, неразрывные и узкие неразрывные пробелы внутри строки.                                                              |
-| `,(0,c.jsx)(t.code,{children:`stripLeadingZeros(value)`}),`                        | Для целых цифровых строк удаляет ведущие нули, оставляя один ноль; поддерживает минус. Нечисловая строка возвращается с обрезанными краями. |
-| `,(0,c.jsx)(t.code,{children:`startsWithIgnoringZeros(value, searchText)`}),`      | Case-insensitive проверка префикса после удаления ведущих нулей у обеих строк.                                                              |
-| `,(0,c.jsx)(t.code,{children:`truncateText(value, maxLength)`}),`                  | Обрезает нормализованный текст и добавляет `,(0,c.jsx)(t.code,{children:`...`}),`; пустой/невалидный текст даёт `,(0,c.jsx)(t.code,{children:`undefined`}),`.                                                 |`]}),`
-`,(0,c.jsx)(t.h2,{id:`логические-значения-abap`,children:`Логические значения ABAP`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { parseAbapBoolean, parseBoolean, toAbapBoolean } from "@ryuzaki13/react-foundation-lib/formatters";
-
-parseAbapBoolean("X"); // true
-parseBoolean("true"); // true
-toAbapBoolean(false); // " "
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                       | Поведение                                                                                                       |
-| ------------------------- | --------------------------------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`parseAbapBoolean(value)`}),` | Возвращает `,(0,c.jsx)(t.code,{children:`true`}),` только для строкового точного `,(0,c.jsx)(t.code,{children:`"X"`}),`; всё остальное — `,(0,c.jsx)(t.code,{children:`false`}),`.                                 |
-| `,(0,c.jsx)(t.code,{children:`parseBoolean(value)`}),`     | Для строк регистронезависимо принимает `,(0,c.jsx)(t.code,{children:`"true"`}),`, `,(0,c.jsx)(t.code,{children:`"x"`}),`, `,(0,c.jsx)(t.code,{children:`"1"`}),`; для остальных значений использует JS truthiness. |
-| `,(0,c.jsx)(t.code,{children:`toAbapBoolean(value)`}),`    | Возвращает ABAP `,(0,c.jsx)(t.code,{children:`"X"`}),` или `,(0,c.jsx)(t.code,{children:`" "`}),`. Строка `,(0,c.jsx)(t.code,{children:`"0"`}),` — ложь; любая другая строка, включая `,(0,c.jsx)(t.code,{children:`""`}),`, — истина.              |`]}),`
-`,(0,c.jsx)(t.h2,{id:`фио-телефон-и-ведущие-нули`,children:`ФИО, телефон и ведущие нули`}),`
-`,(0,c.jsx)(t.h3,{id:`фио-и-телефон`,children:`ФИО и телефон`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { clearPhone, formatFullName, formatPhone, formatShortName } from "@ryuzaki13/react-foundation-lib/formatters";
-
-formatFullName("  иванов   иван иванович "); // "Иванов Иван Иванович"
-formatShortName("иванов иван иванович"); // "Иванов И.И."
-formatPhone("8 (912) 345-67-89"); // "+7 (912) 345-67-89"
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                         | Ограничения и fallback                                                                                                                            |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`formatFullName(fullName)`}),`  | Нормализует пробелы, нижний регистр и регистр первых трёх частей. Это presentation helper, а не валидатор ФИО; дополнительные части игнорируются. |
-| `,(0,c.jsx)(t.code,{children:`formatShortName(fullName)`}),` | Показывает фамилию и одну/две инициалы. Пустая строка даёт `,(0,c.jsx)(t.code,{children:`""`}),`.                                                                                  |
-| `,(0,c.jsx)(t.code,{children:`clearPhone(number)`}),`        | Оставляет цифры, ограничивает ввод первыми 11 цифрами, приводит начальный `,(0,c.jsx)(t.code,{children:`7`}),`/`,(0,c.jsx)(t.code,{children:`8`}),` к `,(0,c.jsx)(t.code,{children:`+7`}),`. Предназначен для российских номеров.                    |
-| `,(0,c.jsx)(t.code,{children:`formatPhone(number)`}),`       | Форматирует только полный нормализованный номер `,(0,c.jsx)(t.code,{children:`+7`}),` и 10 цифр. Если после очистки номер неполный, возвращает исходную строку без изменений.      |`]}),`
-`,(0,c.jsx)(t.h3,{id:`числовые-идентификаторы`,children:`Числовые идентификаторы`}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { normalizeLeadingZeros, normalizeLeadingZerosStrict } from "@ryuzaki13/react-foundation-lib/formatters";
-
-normalizeLeadingZeros("0012", 5); // "00012"
-normalizeLeadingZerosStrict("0012", -1); // "12"
-normalizeLeadingZerosStrict("12,5", 4); // "0012,5"
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[`| API                                          | Поведение                                                                                                                                                                                                                                                                                                     |
-| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`normalizeLeadingZeros(value, fixed?)`}),`       | Приводит конечное числовое значение через `,(0,c.jsx)(t.code,{children:`Number`}),` к строке; при `,(0,c.jsx)(t.code,{children:`fixed > 0`}),` дополняет целую часть нулями. Нечисловое/бесконечное значение возвращает как есть. Поэтому этот вариант может изменить строковое представление и тип результата.                                                                 |
-| `,(0,c.jsx)(t.code,{children:`normalizeLeadingZerosStrict(value, fixed?)`}),` | Сохраняет тип `,(0,c.jsx)(t.code,{children:`T`}),`: при `,(0,c.jsx)(t.code,{children:`fixed`}),` отсутствующем, нулевом или не конечном — no-op; при `,(0,c.jsx)(t.code,{children:`fixed < 0`}),` удаляет нули в целой части строки, при `,(0,c.jsx)(t.code,{children:`fixed > 0`}),` дополняет. Не распознанная числовая строка возвращается без изменений. Для `,(0,c.jsx)(t.code,{children:`number`}),` ведущие нули представить невозможно, поэтому результат остаётся числом. |`]}),`
-`,(0,c.jsxs)(t.p,{children:[`Для пользовательского draft не вызывайте нормализацию во время ввода. Храните
-буквальное значение, а `,(0,c.jsx)(t.code,{children:`normalizeLeadingZerosStrict`}),` применяйте только на
-явной границе сохранения или восстановления, если это действительно часть
-контракта данных.`]})]})}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/foundationLib-BcQgD58A.js

@@ -1,82 +0,0 @@
-import{n as e}from"./rolldown-runtime-C0FnF6B9.js";import{n as t}from"./iframe-BOYfiRbQ.js";import{i as n,r}from"./react-qN2cStNd.js";import{l as i,m as a}from"./blocks-DFQ7gHL7.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,p:`p`,pre:`pre`,strong:`strong`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Обзор`}),`
-`,(0,c.jsx)(t.h1,{id:`ryuzaki13react-foundation-lib`,children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib`})}),`
-`,(0,c.jsx)(t.p,{children:`Технический фундамент для host-приложений: чистые преобразования данных, browser/React hooks, сериализуемые runtime-контракты, OData metadata helpers и инфраструктура состояния. Пакет не знает домен приложения, UI-компоненты и transport конкретного backend.`}),`
-`,(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
-`})}),`
-`,(0,c.jsxs)(t.p,{children:[`Пакет ESM и намеренно `,(0,c.jsx)(t.strong,{children:`не имеет корневого импорта`}),`. Подключайте ровно тот опубликованный subpath, который нужен сценарию:`]}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { formatDateAsDate } from "@ryuzaki13/react-foundation-lib/formatters";
-import { createQueryClient } from "@ryuzaki13/react-foundation-lib/query-client";
-import type { RowRecord } from "@ryuzaki13/react-foundation-lib/types";
-`})}),`
-`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неверно: корневой entrypoint не опубликован.
-import { formatDateAsDate } from "@ryuzaki13/react-foundation-lib";
-`})}),`
-`,(0,c.jsx)(t.h2,{id:`граница-ответственности`,children:`Граница ответственности`}),`
-`,(0,c.jsxs)(t.p,{children:[`| Задача                                                     | Использовать                              | Не использовать вместо этого         |
-| ---------------------------------------------------------- | ----------------------------------------- | ------------------------------------ |
-| Чистые OData V2 metadata, path, filter и value helpers     | `,(0,c.jsx)(t.code,{children:`odata-service`}),`                           | HTTP/OData transport                 |
-| Вызовы SAP Gateway, SSO, X-CSRF и TanStack Query operation | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/odata`}),`   | ручной `,(0,c.jsx)(t.code,{children:`fetch`}),` или этот пакет        |
-| UI primitives и дизайн-система                             | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-ui/<module>`}),` | hooks/utilities из lib как компонент |
-| Доменный mapping и пользовательский сценарий               | host entity/feature                       | foundation-lib                       |`]}),`
-`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`react-foundation-lib`}),` не создаёт бизнес-правила, не хранит backend snapshot и не заменяет API- или UI-пакеты.`]}),`
-`,(0,c.jsx)(t.h2,{id:`среда-выполнения-и-peer-dependencies`,children:`Среда выполнения и peer dependencies`}),`
-`,(0,c.jsx)(t.p,{children:`Большинство pure helpers не требуют React. Entry point с React hook, DOM, browser storage или Service Worker должен вызываться только в браузерном runtime и по правилам React hooks. Совместимые peer dependencies должны быть разрешены host-проектом для используемого entrypoint.`}),`
-`,(0,c.jsxs)(t.p,{children:[`| Возможность                                     | Когда нужна в host                                                           |
-| ----------------------------------------------- | ---------------------------------------------------------------------------- |
-| `,(0,c.jsx)(t.code,{children:`react`}),`                                         | `,(0,c.jsx)(t.code,{children:`hooks`}),`, `,(0,c.jsx)(t.code,{children:`dom`}),`, `,(0,c.jsx)(t.code,{children:`copy`}),`, `,(0,c.jsx)(t.code,{children:`media`}),`, `,(0,c.jsx)(t.code,{children:`pwa`}),`, `,(0,c.jsx)(t.code,{children:`three-scene`}),`, selection/table hooks |
-| `,(0,c.jsx)(t.code,{children:`@tanstack/react-query`}),`, persistence, broadcast | `,(0,c.jsx)(t.code,{children:`query-client`}),`, часть `,(0,c.jsx)(t.code,{children:`error-report`}),`                                         |
-| `,(0,c.jsx)(t.code,{children:`@tanstack/react-table`}),`                         | `,(0,c.jsx)(t.code,{children:`table`}),`                                                                      |
-| `,(0,c.jsx)(t.code,{children:`@tanstack/react-virtual`}),`                       | `,(0,c.jsx)(t.code,{children:`virtualizer`}),`                                                                |
-| `,(0,c.jsx)(t.code,{children:`@tanstack/react-router`}),`                        | search helpers из `,(0,c.jsx)(t.code,{children:`hooks`}),`                                                    |
-| `,(0,c.jsx)(t.code,{children:`@floating-ui/react`}),`                            | `,(0,c.jsx)(t.code,{children:`useFloatingListbox`}),`, DOM reference guards                                   |
-| `,(0,c.jsx)(t.code,{children:`@dnd-kit/core`}),`, `,(0,c.jsx)(t.code,{children:`@dnd-kit/sortable`}),`            | `,(0,c.jsx)(t.code,{children:`useDndSortableSensors`}),`                                                      |
-| `,(0,c.jsx)(t.code,{children:`zustand`}),`, `,(0,c.jsx)(t.code,{children:`immer`}),`                              | `,(0,c.jsx)(t.code,{children:`notifications`}),`, OData store                                                 |
-| `,(0,c.jsx)(t.code,{children:`zod`}),`                                           | `,(0,c.jsx)(t.code,{children:`odata-service`}),` schemas                                                      |
-| `,(0,c.jsx)(t.code,{children:`write-excel-file`}),`                              | `,(0,c.jsx)(t.code,{children:`excel`}),`                                                                      |`]}),`
-`,(0,c.jsx)(t.h2,{id:`выбор-entrypoint`,children:`Выбор entrypoint`}),`
-`,(0,c.jsxs)(t.p,{children:[`| Сценарий                                             | Точный import                                         |
-| ---------------------------------------------------- | ----------------------------------------------------- |
-| Массивы, дедупликация, grouping, reorder             | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/array`}),`               |
-| Base64 и `,(0,c.jsx)(t.code,{children:`Blob`}),`                                      | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/binary`}),`              |
-| Ограниченный стек копий                              | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/bounded-copy-stack`}),`  |
-| Anchor и state контекстного меню                     | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/context-menu`}),`        |
-| Clipboard и feedback hooks                           | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/copy`}),`                |
-| Hash и UUID                                          | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/crypto`}),`              |
-| Валютные labels по OData-параметрам                  | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/currency`}),`            |
-| Сегменты маски даты                                  | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/date-segments`}),`       |
-| Portal, focus, observers, browser download           | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/dom`}),`                 |
-| Ошибка отсутствующего React context                  | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/error`}),`               |
-| Подготовка и диагностика error report                | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/error-report`}),`        |
-| Excel и экспорт таблиц                               | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/excel`}),`               |
-| `,(0,c.jsx)(t.code,{children:`FileReader`}),`, MIME, Content-Disposition, изображения | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/file`}),`                |
-| Client fingerprint                                   | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/fingerprint`}),`         |
-| Form errors и presets                                | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/form`}),`                |
-| Даты, числа, строки, pipeline и value state          | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`}),`          |
-| Реестр и выполнение клиентских формул таблицы        | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formulas`}),`            |
-| Общие React hooks                                    | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/hooks`}),`               |
-| HTTP headers и text `,(0,c.jsx)(t.code,{children:`Response`}),`                       | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/http`}),`                |
-| Breakpoints и media-query hooks                      | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/media`}),`               |
-| Imperative notifications и store                     | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/notifications`}),`       |
-| Математика slider/scale                              | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/number-scale`}),`        |
-| OData code/text collections и store                  | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata`}),`               |
-| OData V2 metadata, builder, filters, formats         | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/odata-service`}),`       |
-| Нормализация сохранённых preset ids                  | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/presets`}),`             |
-| Service Worker update и cache policy                 | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/pwa`}),`                 |
-| Только cache policy                                  | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/pwa/sw-cache-policy`}),` |
-| QueryClient, persistence, broadcast                  | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/query-client`}),`        |
-| Вывод открытых границ диапазона                      | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/range-output`}),`        |
-| SEO/head metadata contracts                          | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/seo`}),`                 |
-| ID в `,(0,c.jsx)(t.code,{children:`sessionStorage`}),`                                | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/session-storage`}),`     |
-| Предсказуемое строковое сравнение                    | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/string-comparison`}),`   |
-| TanStack Table layout, selection и OData adapter     | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/table`}),`               |
-| Проверка доступности Three.js                        | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/three-scene`}),`         |
-| Построение tree-table rows                           | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/tree-table`}),`          |
-| Общие TypeScript contracts                           | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/types`}),`               |
-| Clone, className, keyboard, stable stringify, tree   | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/utils`}),`               |
-| Runtime guards и URL/image validation                | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/validators`}),`          |
-| Infinite-query подгрузка virtualizer                 | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/virtualizer`}),`         |
-| XML parse/build                                      | `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/xml`}),`                 |`]}),`
-`,(0,c.jsx)(t.h2,{id:`как-читать-справочник`,children:`Как читать справочник`}),`
-`,(0,c.jsxs)(t.p,{children:[`Каждая последующая страница построена вокруг `,(0,c.jsx)(t.strong,{children:`published subpath`}),`, а не каталога исходников. В ней указаны точный import, публичные contracts, обязательная инициализация, результат, lifecycle/cleanup и ограничения. Для pure helpers достаточно вызвать функцию; registry, browser и global-store API требуют отдельного раздела «Инициализация и side effects».`]}),`
-`,(0,c.jsxs)(t.p,{children:[`Если API не описан как публичный на соответствующей странице, не импортируйте его глубоким путём из `,(0,c.jsx)(t.code,{children:`src`}),` или `,(0,c.jsx)(t.code,{children:`dist`}),`: это не часть стабильного consumer 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/iframe-Dy-1_8OT.js

@@ -1 +0,0 @@
-import{t as e}from"./iframe-BOYfiRbQ.js";e();